write_document
Write a markdown document for the person, as a type from list_document_types and following its context.
writesnot idempotentMCP toolAgent
Pass id and the version last read to rewrite one of the caller's documents. The write fails with failed_precondition when someone wrote the document since.
Calling it#
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/WriteDocument \
-H 'Content-Type: application/json' \
-d '{
"name": "<name>",
"type": "<type>",
"body": "<body>"
}'komrad rpc write-document \
--name '<string>' \
--type '<string>' \
--body '<string>'{
"name": "write_document",
"arguments": {
"name": "<name>",
"type": "<type>",
"body": "<body>"
}
}Offered by the komrad MCP server to writer, orchestrator agents.
Request#
WriteDocumentRequest#
| Field | Type | Description |
|---|---|---|
id | uuid | The document to rewrite, by id. Unset creates a document. |
name | string* at most 200 characters must not contain control characters | The document's title. |
type | string* at most 100 characters | The name of the document's type, one |
| one of* | The source of the document's text. | |
body | string not empty at most 1048576 bytes | The document's text, in markdown. |
path | string not empty | A markdown file on the machine komrad runs on. A relative path starts at the writing agent's checkout. |
version | int32 more than 0 | The document's |
agent_id | uuid | The agent to write the document for, by id. An agent may name only itself. |
Response#
WriteDocumentResponse#
Types#
Document#
Document is markdown an agent writes for the person to read.
| Field | Type | Description |
|---|---|---|
id | uuid* | The document's id. |
agent_id | uuid* | The id of the agent that owns the document. |
name | string | The document's title. No two of one agent's documents share one. |
type | string | The name of the document's type. |
body | string | The document's text, in markdown. Empty in a listing. |
created_at | timestamp | When the document was created. |
updated_at | timestamp | When the document was last written. |
version | int32 | How many times the document has been written. |
task_id | uuid | The id of the task the agent was on when the document was created. Unset for an orchestrator's documents. |