Tool Details: covia_append

Basic Information

Tool Name:covia_append
Asset Name:Append to Lattice Vector
Description:Append an element to a vector at a writable path (w/, o/, n/, t/). Creates the vector if it doesn't exist. Example: w/audit/trail (build an immutable event log). Errors if the target is not a vector — use covia_write to replace non-vector values.
Adapter:covia
Asset Hash:0x91fddf97095c23c2fb6bcff3007ff400244e6f0dd591489b8d3b113927ce566e
Input
PropertyTypeDescription
path*stringWritable path to a vector (creates one if missing). Must start with w/, o/, n/, or t/. Deep paths create intermediate maps.
value*anyThe element to append. You should normally use structured values rather than serialised strings.
Output
PropertyTypeDescription
newSizeintegerThe element count of the vector after the append.
indexintegerThe position the appended element landed at (newSize - 1).
existedbooleanWhether the collection was already present before this append: false = a new single-element vector was created, true = an existing vector was extended.
pathCreatedbooleanPresent and true only if the append had to build a missing parent path (intermediate hierarchy). Omitted otherwise.

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-test.covia.ai/mcp

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

url = "https://venue-test.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "covia_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-test.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'covia_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 Lattice Vector",
	"description": "Append an element to a vector at a writable path (w/, o/, n/, t/). Creates the vector if it doesn't exist. Example: w/audit/trail (build an immutable event log). Errors if the target is not a vector — use covia_write to replace non-vector values.",
	"dateCreated": "2026-03-25T00:00:00Z",
	"operation": {
		"adapter": "covia:append",
		"toolName": "covia_append",
		"input": {
			"type": "object",
			"properties": {
				"path": {
					"type": "string",
					"description": "Writable path to a vector (creates one if missing). Must start with w/, o/, n/, or t/. Deep paths create intermediate maps."
				},
				"value": {
					"description": "The element to append. You should normally use structured values rather than serialised strings."
				}
			},
			"required": ["path", "value"]
		},
		"output": {
			"type": "object",
			"properties": {
				"existed": { "type": "boolean", "description": "Whether the collection was already present before this append: false = a new single-element vector was created, true = an existing vector was extended." },
				"index": { "type": "integer", "description": "The position the appended element landed at (newSize - 1)." },
				"newSize": { "type": "integer", "description": "The element count of the vector after the append." },
				"pathCreated": { "type": "boolean", "description": "Present and true only if the append had to build a missing parent path (intermediate hierarchy). Omitted otherwise." }
			}
		}
	}
}

Navigation

Back to adapter details

Back to all adapters

Back to index