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 'asset' (CAS reference, streamed).
Adapter:dlfs
Asset Hash:0x4a45268b8f8be251e06a20171d50e236dc296d6fb9fecaa5ec57374468897ccc
Input
PropertyTypeDescription
drive*stringDrive name
contentstringUTF-8 text to append
bytesstringBase64-encoded bytes to append
assetstringAsset reference to stream as appended content
path*stringFile path within the drive
valueanyJSON-serialisable value to append as UTF-8 JSON
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-3.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-3.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-3.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-3.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 'asset' (CAS reference, 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" },
        "asset": { "type": "string", "description": "Asset reference to stream as appended content" }
      },
      "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