Tool Details: dlfs_append

Basic Information

Tool Name:dlfs_append
Asset Name:Append to DLFS File
Description:Append content to a file in a DLFS drive, creating the file if it does not exist. Parent directories must already exist — use dlfs:mkdir first if needed. Supply exactly one of 'content' (UTF-8 text), 'value' (JSON-serialised), 'bytes' (base64 inline), or 'contentRef' (resolvable content, streamed).
Adapter:dlfs
Asset Hash:0x3b06a25afdb039adec10497517c0153a10b7ef256bd311d7c3122a117383487f
Input
PropertyTypeDescription
contentstringUTF-8 text to append
bytesstringBase64-encoded bytes to append
assetstringLegacy alias for contentRef
drive*stringDrive name
valueanyJSON-serialisable value to append as UTF-8 JSON
contentRefstringResolvable content reference to stream, including an asset, file:// root path, or DLFS path
path*stringFile path within the drive
Output
PropertyTypeDescription
appendedintegerBytes appended
createdbooleanTrue if file was newly created

MCP Tool Usage Examples

This tool can be called via the MCP (Model Context Protocol) endpoint. Here are examples of how to use it:

JSON-RPC Call Example:

POST to https://venue-4.covia.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dlfs_append",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://venue-4.covia.ai/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "dlfs_append",
      "arguments": {
        "input": "your input here"
      }
    }
  }'
Python Example:
import requests
import json

url = "https://venue-4.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "dlfs_append",
        "arguments": {
            "input": "your input here"
        }
    }
}

response = requests.post(url, json=payload)
result = response.json()
print(result)
JavaScript/Node.js Example:
const fetch = require('node-fetch');

const url = 'https://venue-4.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'dlfs_append',
        arguments: {
            input: 'your input here'
        }
    }
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));

Asset Metadata

{
  "name": "Append to DLFS File",
  "description": "Append content to a file in a DLFS drive, creating the file if it does not exist. Parent directories must already exist — use dlfs:mkdir first if needed. Supply exactly one of 'content' (UTF-8 text), 'value' (JSON-serialised), 'bytes' (base64 inline), or 'contentRef' (resolvable content, streamed).",
  "creator": "Covia",
  "operation": {
    "adapter": "dlfs:append",
    "toolName": "dlfs_append",
    "input": {
      "type": "object",
      "properties": {
        "drive": { "type": "string", "description": "Drive name" },
        "path": { "type": "string", "description": "File path within the drive" },
        "content": { "type": "string", "description": "UTF-8 text to append" },
        "value": { "description": "JSON-serialisable value to append as UTF-8 JSON" },
        "bytes": { "type": "string", "description": "Base64-encoded bytes to append" },
        "contentRef": { "type": "string", "description": "Resolvable content reference to stream, including an asset, file:// root path, or DLFS path" },
        "asset": { "type": "string", "deprecated": true, "description": "Legacy alias for contentRef" }
      },
      "required": ["drive", "path"]
    },
    "output": {
      "type": "object",
      "properties": {
        "appended": { "type": "integer", "description": "Bytes appended" },
        "created": { "type": "boolean", "description": "True if file was newly created" }
      }
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index