agentleFS

Read one item

read

Read-onlyIdempotent

Read one item by its location or id. A path or id you cannot read answers not-found, exactly as one that does not exist. action=document returns the document's text: the body comes first, frontmatter on its first line, and everything after the LAST ──── end of document ──── line describes it (location, type, node id, the commit to pass as expected_commit, its [[wikilinks]] both ways where you can read both ends, the memory and skills that apply in its folder, a console link to cite). The document ends two line breaks before that line, and those two are not part of it. A large document comes in parts, each ending ──── end of part: NOT the whole document ──── with the next offset. When somebody has it open in the editor, the body is their unsaved text and the answer says revision: live. Actions — document: a document (location or node; offset and maxBytes page a large one); an image answers as one: an SVG's source, a raster image's type and size. version: what a document said at one of its earlier versions (location or node, commit from browse action=versions); not the document now. message: one message (message_id). thread: a message thread with its loop risk (thread_id, or message_id for the thread it is in). truth: a truth with its debate (id). decision: one decision with the same current source binding, choice and work state as the web app (id). span_history: how a span was rewritten, and by how many editors (span). lesson: a knowledge item and its standing (id). lesson_notes: the usage notes left on a knowledge item (id). package: a public registry package and its public comments (slug, optional version); the registry spans every organization. room: a room and its members (room_id). wait: a wait's state (wait_id); with timeout_s (at most 25) it blocks until the wait resolves or the time runs out, answering pending. A wait resolves once: fired, timed_out, or counterparty_gone; a reply wait's resolution says replied (with replyId) or declined (with declinedBy) and points at the message rather than quoting it. changes: what changed on your subscriptions since you last acknowledged (coordination_write action=ack_changes).

Input Schema

Name	Required	Description
`id`	No	truth, decision: the truth's id · lesson, lesson_notes: an item id, or the citation search returns for it (knowledge:<id>@v<version>)
`node`	No	document, version: the document's id, as returned beside its location — survives a rename or a move, so a citation written into a stored document keeps pointing at the right thing. Give this OR location, never both. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too.
`seat`	No	the seat token identity_write action=take_seat gave you; pass it on every call while you drive that agent
`slug`	No	package: org/publication for a public package; a local publication name when proposing
`span`	No	span_history: a span id, from browse action=spans
`action`	Yes	what to do; each action takes the arguments its line names
`commit`	No	version: the version's commit hash, as browse action=versions lists it (any lowercase prefix of at least 7 hex characters that names one)
`offset`	No	document: byte offset to start at (page large files)
`room_id`	No	room: the room's id, from create_room or browse action=rooms
`version`	No	package: a published version; default the latest
`wait_id`	No	wait: the wait's id, from wait_for or browse action=waits
`location`	No	document, version: full path from the workspace root, e.g. "handbook/vendor/acme.md". Give this OR node. A path is what a person reads; a node is what survives somebody reorganizing.
`maxBytes`	No	document: max bytes to return (clamped to MAX_READ_BYTES)
`acting_as`	No	an agent identity below you (its id, from identity_write action=spawn) to make this one call as, with that agent's narrower access; for a helper whose session signs in as its person
`thread_id`	No	thread: the thread's id
`timeout_s`	No	wait: block up to this many seconds (0–25) for it to resolve; omit to answer at once
`message_id`	No	message, thread: the message's id, from browse action=inbox, brief_me or send

Output Schema

Name	Required	Description
`item`	No
`link`	No
`loop`	No
`room`	No
`text`	No	the answer as prose, for an action that answers in prose
`wait`	No
`added`	No
`image`	No	present when the location is an image: an SVG's text is its source, a raster image's bytes are never sent as text
`items`	No
`links`	No
`moved`	No
`notes`	No
`rooms`	No
`since`	No
`spans`	No
`truth`	No
`waits`	No
`action`	Yes	the action that answered
`debate`	No
`failed`	No
`pulled`	No
`schema`	No
`truths`	No
`history`	No
`message`	No
`package`	No
`pending`	No
`comments`	No
`decision`	No
`messages`	No
`packages`	No
`position`	No
`proposal`	No
`replayed`	No
`standing`	No
`decisions`	No
`escalated`	No
`truncated`	No	inbox: more are waiting past this page
`nextOffset`	No	spans: the offset of the next page, or null when this one ends the document
`organization`	No
`subscription`	No
`retiringUntil`	No
`subscriptions`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedOct 30, 2026

changedInput schema / properties / action / enum

Previous value: -[
-  "document",
-  "version",
-  "message",
-  "thread",
-  "truth",
-  "span_history",
-  "lesson",
-  "lesson_notes",
-  "package",
-  "room",
-  "wait",
-  "changes"
-]New value: +[
+  "document",
+  "version",
+  "message",
+  "thread",
+  "truth",
+  "decision",
+  "span_history",
+  "lesson",
+  "lesson_notes",
+  "package",
+  "room",
+  "wait",
+  "changes"
+]

changedInput schema / properties / id / description

Previous value: -"truth: the truth's id · lesson, lesson_notes: an item id, or the citation search returns for it (knowledge:<id>@v<version>)"New value: +"truth, decision: the truth's id · lesson, lesson_notes: an item id, or the citation search returns for it (knowledge:<id>@v<version>)"

addedOutput schema / properties / decision

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "assertedByName": {
+      "type": "string"
+    },
+    "ballot": {
+      "additionalProperties": false,
+      "properties": {
+        "ballotHash": {
+          "type": "string"
+        },
+        "context": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "options": {
+          "items": {
+            "additionalProperties": {},
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "summary": {
+                "type": "string"
+              },
+              "tradeoffs": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "summary",
+              "tradeoffs"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "preference": {
+          "type": "string"
+        },
+        "resolution": {
+          "enum": [
+            "proposal",
+            "verified-choice",
+            "unresolved-choice"
+          ],
+          "type": "string"
+        },
+        "selectedOptionId": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "title",
+        "context",
+        "resolution",
+        "options"
+      ],
+      "type": "object"
+    },
+    "contextSource": {
+      "const": "current-document",
+      "type": "string"
+    },
+    "execution": {
+      "additionalProperties": {},
+      "properties": {
+        "evidence": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "state": {
+          "enum": [
+            "not_started",
+            "working",
+            "waiting",
+            "blocked",
+            "completed",
+            "cancelled"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "state",
+        "evidence"
+      ],
+      "type": "object"
+    },
+    "lifecycle": {
+      "enum": [
+        "needs",
+        "decided",
+        "completed",
+        "replaced"
+      ],
+      "type": "string"
+    },
+    "location": {
+      "type": "string"
+    },
+    "origin": {
+      "additionalProperties": false,
+      "properties": {
+        "organization": {
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "name"
+          ],
+          "type": "object"
+        },
+        "recordedWith": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "version": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "organization"
+      ],
+      "type": "object"
+    },
+    "sourceCommit": {
+      "type": "string"
+    },
+    "sourceIsLive": {
+      "type": "boolean"
+    },
+    "sourceUrl": {
+      "type": "string"
+    },
+    "story": {
+      "additionalProperties": {},
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "title": {
+      "type": "string"
+    },
+    "truth": {
+      "additionalProperties": false,
+      "properties": {
+        "anchor": {
+          "additionalProperties": false,
+          "properties": {
+            "drifted": {
+              "type": "boolean"
+            },
+            "nodeId": {
+              "type": "string"
+            },
+            "spanId": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "nodeId",
+            "spanId",
+            "drifted"
+          ],
+          "type": "object"
+        },
+        "assertedBy": {
+          "type": "string"
+        },
+        "confidence": {
+          "enum": [
+            "stated",
+            "verified"
+          ],
+          "type": "string"
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "debate": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "cap": {
+                  "type": "number"
+                },
+                "contestStatement": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "contestedBy": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "decideBy": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "decidedHow": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "deciderId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "decision": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "note": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "rounds": {
+                  "type": "number"
+                },
+                "threadId": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "threadId",
+                "contestedBy",
+                "contestStatement",
+                "rounds",
+                "cap",
+                "deciderId",
+                "decideBy",
+                "decision",
+                "decidedHow",
+                "note"
+              ],
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "evidence": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "id": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string"
+        },
+        "ownerId": {
+          "type": "string"
+        },
+        "statement": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "supersededBy": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "supersedes": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "updatedAt": {
+          "type": "string"
+        },
+        "verification": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "at": {
+                  "type": "string"
+                },
+                "by": {
+                  "type": "string"
+                },
+                "method": {
+                  "type": "string"
+                },
+                "rerunnable": {
+                  "type": "boolean"
+                },
+                "result": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "method",
+                "rerunnable",
+                "result",
+                "by",
+                "at"
+              ],
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "kind",
+        "status",
+        "statement",
+        "evidence",
+        "ownerId",
+        "assertedBy",
+        "anchor",
+        "confidence",
+        "verification",
+        "supersedes",
+        "supersededBy",
+        "debate",
+        "createdAt",
+        "updatedAt"
+      ],
+      "type": "object"
+    }
+  },
+  "required": [
+    "truth",
+    "location",
+    "assertedByName",
+    "sourceUrl",
+    "lifecycle",
+    "origin"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / decisions

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "assertedByName": {
+        "type": "string"
+      },
+      "ballot": {
+        "additionalProperties": false,
+        "properties": {
+          "ballotHash": {
+            "type": "string"
+          },
+          "context": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "options": {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "summary": {
+                  "type": "string"
+                },
+                "tradeoffs": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "summary",
+                "tradeoffs"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "preference": {
+            "type": "string"
+          },
+          "resolution": {
+            "enum": [
+              "proposal",
+              "verified-choice",
+              "unresolved-choice"
+            ],
+            "type": "string"
+          },
+          "selectedOptionId": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "title",
+          "context",
+          "resolution",
+          "options"
+        ],
+        "type": "object"
+      },
+      "contextSource": {
+        "const": "current-document",
+        "type": "string"
+      },
+      "execution": {
+        "additionalProperties": {},
+        "properties": {
+          "evidence": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "state": {
+            "enum": [
+              "not_started",
+              "working",
+              "waiting",
+              "blocked",
+              "completed",
+              "cancelled"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "state",
+          "evidence"
+        ],
+        "type": "object"
+      },
+      "lifecycle": {
+        "enum": [
+          "needs",
+          "decided",
+          "completed",
+          "replaced"
+        ],
+        "type": "string"
+      },
+      "location": {
+        "type": "string"
+      },
+      "origin": {
+        "additionalProperties": false,
+        "properties": {
+          "organization": {
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "name"
+            ],
+            "type": "object"
+          },
+          "recordedWith": {
+            "additionalProperties": false,
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "version": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "organization"
+        ],
+        "type": "object"
+      },
+      "sourceCommit": {
+        "type": "string"
+      },
+      "sourceIsLive": {
+        "type": "boolean"
+      },
+      "sourceUrl": {
+        "type": "string"
+      },
+      "story": {
+        "additionalProperties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "summary": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      },
+      "truth": {
+        "additionalProperties": false,
+        "properties": {
+          "anchor": {
+            "additionalProperties": false,
+            "properties": {
+              "drifted": {
+                "type": "boolean"
+              },
+              "nodeId": {
+                "type": "string"
+              },
+              "spanId": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "nodeId",
+              "spanId",
+              "drifted"
+            ],
+            "type": "object"
+          },
+          "assertedBy": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "stated",
+              "verified"
+            ],
+            "type": "string"
+          },
+          "createdAt": {
+            "type": "string"
+          },
+          "debate": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "cap": {
+                    "type": "number"
+                  },
+                  "contestStatement": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "contestedBy": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "decideBy": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "decidedHow": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "deciderId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "decision": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "note": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "rounds": {
+                    "type": "number"
+                  },
+                  "threadId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "threadId",
+                  "contestedBy",
+                  "contestStatement",
+                  "rounds",
+                  "cap",
+                  "deciderId",
+                  "decideBy",
+                  "decision",
+                  "decidedHow",
+                  "note"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "evidence": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "id": {
+            "type": "string"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "ownerId": {
+            "type": "string"
+          },
+          "statement": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "supersededBy": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "supersedes": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "updatedAt": {
+            "type": "string"
+          },
+          "verification": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "at": {
+                    "type": "string"
+                  },
+                  "by": {
+                    "type": "string"
+                  },
+                  "method": {
+                    "type": "string"
+                  },
+                  "rerunnable": {
+                    "type": "boolean"
+                  },
+                  "result": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "method",
+                  "rerunnable",
+                  "result",
+                  "by",
+                  "at"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "kind",
+          "status",
+          "statement",
+          "evidence",
+          "ownerId",
+          "assertedBy",
+          "anchor",
+          "confidence",
+          "verification",
+          "supersedes",
+          "supersededBy",
+          "debate",
+          "createdAt",
+          "updatedAt"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "truth",
+      "location",
+      "assertedByName",
+      "sourceUrl",
+      "lifecycle",
+      "origin"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / organization

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "id",
+    "name"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / schema

Added value: +{
+  "const": "agentlefs-decision-history/v1",
+  "type": "string"
+}

Changed2 schema fields changedOct 30, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Changed76 schema fields changedOct 24, 2026

addedInput schema / properties / seat

Added value: +{
+  "description": "the seat token identity_write action=take_seat gave you; pass it on every call while you drive that agent",
+  "maxLength": 64,
+  "type": "string"
+}

removedOutput schema / properties / comments / items / properties / version / anyOf

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / comments / items / properties / version / type
```
Added value: +[
+  "number",
+  "null"
+]
```
removedOutput schema / properties / history / properties / versions / items / properties / editorId / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / history / properties / versions / items / properties / editorId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / history / properties / versions / items / properties / upstream / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "authors": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "ref": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "provider",
-      "ref",
-      "authors"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "authors": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "provider": {
+        "type": "string"
+      },
+      "ref": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "provider",
+      "ref",
+      "authors"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / image / properties / link / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / image / properties / link / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / item / properties / publishedFrom / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / item / properties / publishedFrom / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / item / properties / scopeNodeId / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / item / properties / scopeNodeId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / item / properties / supersededBy / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / item / properties / supersededBy / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / item / properties / supersedes / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / item / properties / supersedes / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / items / anyOf

Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "authorId": {
-          "type": "string"
-        },
-        "body": {
-          "type": "string"
-        },
-        "createdAt": {
-          "type": "string"
-        },
-        "decayHalfLifeDays": {
-          "type": "number"
-        },
-        "draft": {
-          "type": "boolean"
-        },
-        "fields": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "id": {
-          "type": "string"
-        },
-        "kind": {
-          "type": "string"
-        },
-        "ownerId": {
-          "type": "string"
-        },
-        "publishedFrom": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "scopeNodeId": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "standing": {
-          "additionalProperties": false,
-          "properties": {
-            "chains": {
-              "type": "number"
-            },
-            "decay": {
-              "type": "number"
-            },
-            "meanByChain": {
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "ratings": {
-              "type": "number"
-            },
-            "score": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "chains",
-            "ratings",
-            "meanByChain",
-            "decay",
-            "score"
-          ],
-          "type": "object"
-        },
-        "supersededBy": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "supersedes": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "title": {
-          "type": "string"
-        },
-        "updatedAt": {
-          "type": "string"
-        },
-        "validation": {
-          "type": "string"
-        },
-        "version": {
-          "type": "number"
-        }
-      },
-      "required": [
-        "id",
-        "kind",
-        "title",
-        "body",
-        "fields",
-        "scopeNodeId",
-        "version",
-        "supersedes",
-        "supersededBy",
-        "validation",
-        "decayHalfLifeDays",
-        "ownerId",
-        "authorId",
-        "draft",
-        "publishedFrom",
-        "createdAt",
-        "updatedAt"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "at": {
-          "type": "string"
-        },
-        "by": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "kind": {
-          "type": "string"
-        },
-        "objectId": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "seq": {
-          "type": "number"
-        },
-        "subscriptionId": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "seq",
-        "at",
-        "kind",
-        "objectId",
-        "by",
-        "subscriptionId"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "authorId": {
+          "type": "string"
+        },
+        "body": {
+          "type": "string"
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "decayHalfLifeDays": {
+          "type": "number"
+        },
+        "draft": {
+          "type": "boolean"
+        },
+        "fields": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "id": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string"
+        },
+        "ownerId": {
+          "type": "string"
+        },
+        "publishedFrom": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "scopeNodeId": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "standing": {
+          "additionalProperties": false,
+          "properties": {
+            "chains": {
+              "type": "number"
+            },
+            "decay": {
+              "type": "number"
+            },
+            "meanByChain": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "ratings": {
+              "type": "number"
+            },
+            "score": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "chains",
+            "ratings",
+            "meanByChain",
+            "decay",
+            "score"
+          ],
+          "type": "object"
+        },
+        "supersededBy": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "supersedes": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "title": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string"
+        },
+        "validation": {
+          "type": "string"
+        },
+        "version": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "id",
+        "kind",
+        "title",
+        "body",
+        "fields",
+        "scopeNodeId",
+        "version",
+        "supersedes",
+        "supersededBy",
+        "validation",
+        "decayHalfLifeDays",
+        "ownerId",
+        "authorId",
+        "draft",
+        "publishedFrom",
+        "createdAt",
+        "updatedAt"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "at": {
+          "type": "string"
+        },
+        "by": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "kind": {
+          "type": "string"
+        },
+        "objectId": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "seq": {
+          "type": "number"
+        },
+        "subscriptionId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "seq",
+        "at",
+        "kind",
+        "objectId",
+        "by",
+        "subscriptionId"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  }
+]

changedOutput schema / properties / message / properties / about / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "nodeId": {
-        "type": "string"
-      },
-      "span": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "nodeId",
-      "span"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "nodeId": {
+        "type": "string"
+      },
+      "span": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "nodeId",
+      "span"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / message / properties / closeNote / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / message / properties / closeNote / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / message / properties / recipients / items / properties / note / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / message / properties / recipients / items / properties / note / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / message / properties / replyTo / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / message / properties / replyTo / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / message / properties / roomId / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / message / properties / roomId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / message / properties / senderId / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / message / properties / senderId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / messages / items / properties / about / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "nodeId": {
-        "type": "string"
-      },
-      "span": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "nodeId",
-      "span"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "nodeId": {
+        "type": "string"
+      },
+      "span": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "nodeId",
+      "span"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / messages / items / properties / closeNote / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / messages / items / properties / closeNote / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / messages / items / properties / recipients / items / properties / note / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / messages / items / properties / recipients / items / properties / note / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / messages / items / properties / replyTo / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / messages / items / properties / replyTo / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / messages / items / properties / roomId / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / messages / items / properties / roomId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / messages / items / properties / senderId / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / messages / items / properties / senderId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / nextOffset / anyOf

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / nextOffset / type
```
Added value: +[
+  "number",
+  "null"
+]
```

removedOutput schema / properties / notes / items / properties / note / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / notes / items / properties / note / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / package / properties / standing / properties / meanByChain / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / package / properties / standing / properties / meanByChain / type
```
Added value: +[
+  "number",
+  "null"
+]
```
removedOutput schema / properties / packages / items / properties / standing / properties / meanByChain / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / packages / items / properties / standing / properties / meanByChain / type
```
Added value: +[
+  "number",
+  "null"
+]
```

removedOutput schema / properties / pulled / properties / location / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / pulled / properties / location / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / retiringUntil / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / retiringUntil / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / standing / properties / meanByChain / anyOf

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / standing / properties / meanByChain / type
```
Added value: +[
+  "number",
+  "null"
+]
```

removedOutput schema / properties / subscription / properties / span / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / subscription / properties / span / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / subscriptions / items / properties / span / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / subscriptions / items / properties / span / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / truth / properties / anchor / properties / spanId / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / truth / properties / anchor / properties / spanId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / truth / properties / debate / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cap": {
-        "type": "number"
-      },
-      "contestStatement": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "contestedBy": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "decideBy": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "decidedHow": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "deciderId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "decision": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "note": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "rounds": {
-        "type": "number"
-      },
-      "threadId": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "threadId",
-      "contestedBy",
-      "contestStatement",
-      "rounds",
-      "cap",
-      "deciderId",
-      "decideBy",
-      "decision",
-      "decidedHow",
-      "note"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cap": {
+        "type": "number"
+      },
+      "contestStatement": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "contestedBy": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "decideBy": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "decidedHow": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "deciderId": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "decision": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "note": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "rounds": {
+        "type": "number"
+      },
+      "threadId": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "threadId",
+      "contestedBy",
+      "contestStatement",
+      "rounds",
+      "cap",
+      "deciderId",
+      "decideBy",
+      "decision",
+      "decidedHow",
+      "note"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / truth / properties / supersededBy / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / truth / properties / supersededBy / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / truth / properties / supersedes / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / truth / properties / supersedes / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / truths / items / properties / anchor / properties / spanId / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / truths / items / properties / anchor / properties / spanId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / truths / items / properties / debate / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cap": {
-        "type": "number"
-      },
-      "contestStatement": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "contestedBy": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "decideBy": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "decidedHow": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "deciderId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "decision": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "note": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "rounds": {
-        "type": "number"
-      },
-      "threadId": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "threadId",
-      "contestedBy",
-      "contestStatement",
-      "rounds",
-      "cap",
-      "deciderId",
-      "decideBy",
-      "decision",
-      "decidedHow",
-      "note"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cap": {
+        "type": "number"
+      },
+      "contestStatement": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "contestedBy": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "decideBy": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "decidedHow": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "deciderId": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "decision": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "note": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "rounds": {
+        "type": "number"
+      },
+      "threadId": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "threadId",
+      "contestedBy",
+      "contestStatement",
+      "rounds",
+      "cap",
+      "deciderId",
+      "decideBy",
+      "decision",
+      "decidedHow",
+      "note"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / truths / items / properties / supersededBy / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / truths / items / properties / supersededBy / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / truths / items / properties / supersedes / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / truths / items / properties / supersedes / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / wait / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "condition": {
-        "additionalProperties": {},
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "continuation": {
-        "type": "string"
-      },
-      "counterparty": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "createdAt": {
-        "type": "string"
-      },
-      "deadline": {
-        "type": "string"
-      },
-      "id": {
-        "type": "string"
-      },
-      "identityId": {
-        "type": "string"
-      },
-      "resolution": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "resolvedAt": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "id",
-      "identityId",
-      "condition",
-      "counterparty",
-      "deadline",
-      "continuation",
-      "status",
-      "resolution",
-      "createdAt",
-      "resolvedAt"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "deadline": {
-        "type": "string"
-      },
-      "id": {
-        "type": "string"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "id",
-      "status",
-      "deadline"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "condition": {
+        "additionalProperties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "continuation": {
+        "type": "string"
+      },
+      "counterparty": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "createdAt": {
+        "type": "string"
+      },
+      "deadline": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "identityId": {
+        "type": "string"
+      },
+      "resolution": {
+        "anyOf": [
+          {
+            "additionalProperties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "resolvedAt": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "identityId",
+      "condition",
+      "counterparty",
+      "deadline",
+      "continuation",
+      "status",
+      "resolution",
+      "createdAt",
+      "resolvedAt"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "deadline": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "status",
+      "deadline"
+    ],
+    "type": "object"
+  }
+]

removedOutput schema / properties / waits / items / properties / counterparty / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / waits / items / properties / counterparty / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / waits / items / properties / resolvedAt / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / waits / items / properties / resolvedAt / type
```
Added value: +[
+  "string",
+  "null"
+]
```

Changed10 schema fields changedOct 20, 2026
- changedInput schema / properties / slug / description
```
Previous value: -"package: the package's name in the registry"New value: +"package: org/publication for a public package; a local publication name when proposing"
```
- addedOutput schema / properties / package / properties / name
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / package / properties / organization
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / package / properties / reference
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / packages / items / properties / name
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / packages / items / properties / organization
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / packages / items / properties / reference
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / proposal / properties / name
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / proposal / properties / organization
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / proposal / properties / reference
```
Added value: +{
+  "type": "string"
+}
```

Changed1 schema field changedOct 16, 2026

addedInput schema / properties / acting_as

Added value: +{
+  "description": "an agent identity below you (its id, from identity_write action=spawn) to make this one call as, with that agent's narrower access; for a helper whose session signs in as its person",
+  "type": "string"
+}

Changed5 schema fields changedOct 15, 2026

changedInput schema / properties / action / enum

Previous value: -[
-  "document",
-  "message",
-  "thread",
-  "truth",
-  "span_history",
-  "lesson",
-  "lesson_notes",
-  "package",
-  "room",
-  "wait",
-  "changes"
-]New value: +[
+  "document",
+  "version",
+  "message",
+  "thread",
+  "truth",
+  "span_history",
+  "lesson",
+  "lesson_notes",
+  "package",
+  "room",
+  "wait",
+  "changes"
+]

addedInput schema / properties / commit

Added value: +{
+  "description": "version: the version's commit hash, as browse action=versions lists it (any lowercase prefix of at least 7 hex characters that names one)",
+  "pattern": "^[0-9a-f]{7,64}$",
+  "type": "string"
+}

changedInput schema / properties / location / description

Previous value: -"document: full path from the workspace root, e.g. \"handbook/vendor/acme.md\". Give this OR node. A path is what a person reads; a node is what survives somebody reorganizing."New value: +"document, version: full path from the workspace root, e.g. \"handbook/vendor/acme.md\". Give this OR node. A path is what a person reads; a node is what survives somebody reorganizing."

changedInput schema / properties / node / description

Previous value: -"document: the document's id, as returned beside its location — survives a rename or a move, so a citation written into a stored document keeps pointing at the right thing. Give this OR location, never both. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."New value: +"document, version: the document's id, as returned beside its location — survives a rename or a move, so a citation written into a stored document keeps pointing at the right thing. Give this OR location, never both. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."

addedOutput schema / properties / image

Added value: +{
+  "additionalProperties": false,
+  "description": "present when the location is an image: an SVG's text is its source, a raster image's bytes are never sent as text",
+  "properties": {
+    "bytes": {
+      "description": "its stored size in bytes",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "link": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "where the console shows it; null when this deployment names no console"
+    },
+    "type": {
+      "description": "its type, by extension: image/svg+xml, image/png, image/jpeg, image/gif or image/webp",
+      "type": "string"
+    }
+  },
+  "required": [
+    "type",
+    "bytes",
+    "link"
+  ],
+  "type": "object"
+}

Changed8 schema fields changedOct 12, 2026

addedOutput schema / properties / nextOffset

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "spans: the offset of the next page, or null when this one ends the document"
+}

addedOutput schema / properties / proposal / properties / approver

Added value: +{
+  "description": "the identity id of the person whose link decides it",
+  "type": "string"
+}

addedOutput schema / properties / proposal / properties / createdAt
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / proposal / properties / proposedBy

Added value: +{
+  "description": "your identity id",
+  "type": "string"
+}

addedOutput schema / properties / proposal / properties / summary
```
Added value: +{
+  "type": "string"
+}
```

changedOutput schema / properties / proposal / required

Previous value: -[
-  "id",
-  "slug",
-  "kind",
-  "title",
-  "status",
-  "expiresAt"
-]New value: +[
+  "id",
+  "slug",
+  "kind",
+  "title",
+  "summary",
+  "status",
+  "proposedBy",
+  "approver",
+  "expiresAt",
+  "createdAt"
+]

addedOutput schema / properties / spans / items / properties / truncated

Added value: +{
+  "description": "this block alone is past the read cap; read action=document has the rest",
+  "type": "boolean"
+}

addedOutput schema / properties / truncated

Added value: +{
+  "description": "inbox: more are waiting past this page",
+  "type": "boolean"
+}

Changed5 schema fields changedOct 8, 2026

addedOutput schema / properties / added

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "created": {
+      "type": "boolean"
+    },
+    "diverged": {
+      "type": "boolean"
+    },
+    "follow": {
+      "enum": [
+        "latest",
+        "pinned"
+      ],
+      "type": "string"
+    },
+    "location": {
+      "type": "string"
+    },
+    "version": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "location",
+    "version",
+    "follow",
+    "diverged",
+    "created"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / package / properties / files

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "content": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "path",
+          "content"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "a folder package's documents by path; null for one document or knowledge item"
+}

changedOutput schema / properties / package / required

Previous value: -[
-  "slug",
-  "kind",
-  "title",
-  "summary",
-  "publisher",
-  "version",
-  "body",
-  "fields",
-  "approvedBy",
-  "publishedAt",
-  "standing"
-]New value: +[
+  "slug",
+  "kind",
+  "title",
+  "summary",
+  "publisher",
+  "version",
+  "body",
+  "fields",
+  "approvedBy",
+  "publishedAt",
+  "standing",
+  "files"
+]

addedOutput schema / properties / packages / items / properties / files

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "content": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "path",
+          "content"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "a folder package's documents by path; null for one document or knowledge item"
+}

changedOutput schema / properties / packages / items / required

Previous value: -[
-  "slug",
-  "kind",
-  "title",
-  "summary",
-  "publisher",
-  "version",
-  "body",
-  "fields",
-  "approvedBy",
-  "publishedAt",
-  "standing"
-]New value: +[
+  "slug",
+  "kind",
+  "title",
+  "summary",
+  "publisher",
+  "version",
+  "body",
+  "fields",
+  "approvedBy",
+  "publishedAt",
+  "standing",
+  "files"
+]

AddedOct 6, 2026

TDQS

A3.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well past the readOnly/idempotent annotations: it discloses the not-found behavior for unreadable paths, that a document opened in the editor returns unsaved live text with 'revision: live', how the footer after the end-of-document marker encodes expected_commit and wikilinks, that large documents arrive in parts with a next offset, and the one-shot resolution semantics and 25s cap of wait. These are exactly the non-obvious traits an agent needs and none are in the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded correctly — what it does comes first, then the document format, then the action roster. However, the document-format passage and the semicolon-chained action list are dense and hard to scan; the length is partly justified by 13 actions and 17 params, but the same content could be structured with clearer breaks.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values needn't be explained, yet the description still documents the unusual document wire format and paging, which the output schema alone would not convey. Some actions remain terse (lesson: 'a knowledge item and its standing'), so it is not fully complete for a 13-action multiplexer, but it is strong overall.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real meaning: it maps each action to the arguments its line names, explains offset/maxBytes as paging for a large document, tells the agent where expected_commit comes from (the document footer), and clarifies location vs node exclusivity and node's rename-survival. Only some action-specific params (span, room_id, slug) get thin treatment beyond schema text.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence states a specific verb and resource (read one item by location or id) and the action list names the distinct item types it can return. It distinguishes itself from sibling browse implicitly by consuming browse's outputs (commit from browse action=versions, wait_id from browse action=waits), but never explicitly says when to use read over search or browse, so it falls short of full sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage context is implied throughout — version is explicitly 'not the document now', and several params point at browse/send as the source of ids. But there is no explicit when-to-use/when-not guidance against siblings like browse or search, and no prerequisites (e.g. auth/seat requirements beyond the seat param description) are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All agentleFS tools Inspect

Try in Browser

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?