agentleFS

List items

browse

Read-onlyIdempotent

List what you can see, filtered to your grants: nothing you cannot read is listed or counted. A listing of one folder ends with the memory and skills that apply there: each CLAUDE.md/AGENTS.md and .claude/skills/<name>/SKILL.md or .agents/skills/<name>/SKILL.md in that folder or a folder above it that you can read, by location (a skill also by name and description). Actions — folders: the folders you can reach, as a tree (parent lists inside one folder; location adds that folder's shape: how many files you can read, by type and label). versions: a document's versions, newest first, each with its commit, author, message and time (location or node); as the console's version history lists them. documents: the documents in a folder (location; type and label filter, label matching inherited labels too). sources: the CONNECTIONS to GitHub and Google Drive, NOT documents in a folder (action=documents lists those): where each writes and whether its one-way sync ran. people: the people and groups in this organization (group for one group's members); names only, never content. inbox: messages waiting on you, newest first, a page at a time (kinds narrows it, e.g. to question and request; pass nextOffset as offset for the rest). claims: your open claims; with location or node, every open claim on that readable target (overlap peek — suggestion only, never a block or auto-merge). waits: your pending waits. subscriptions: what you follow. rooms: your rooms. decisions: the same viewer-scoped decision history as the web app, including verified choice and work state (view, query; pass nextOffset as offset). truths: the truths about a document or folder (location or node). spans: a document's blocks with their stable span ids, marking any stale because a truth they cite was superseded (location or node; a large one pages at the read cap: pass nextOffset as offset). links: the links around a node, span, truth, message or knowledge item (from as :, or id for a truth; depth). drafts: your private knowledge drafts. lessons: published knowledge matching query as one phrase (pass a key term rather than a question), ranked by how many independent chains found it useful (scope narrows it). comments: the comment threads on a document or folder (location); read alongside the source for reviews, questions and responding to feedback. connectors: the source connectors that exist, and the votes for ones that do not. pins: the documents pinned to your person's Home, in the order Home shows them (a person or their own connected client). github_issues: GitHub issues bound to a folder or document (location or node), or the node bound to one issue (issue: URL or owner/repo#N); beyond file mirrors. projects: the projects you can read: each a folder marked as one, with who routes its work and the repositories its AGENTS.md lists. packages: public registry packages matching query. context: every memory file (CLAUDE.md, AGENTS.md) and skill (.claude/skills//SKILL.md, .agents/skills//SKILL.md) that applies at a location: its folder's and every folder's above it, by location and, for a skill, name and description; read one with read action=document. reports: what people and agents reported after using a public context file, and the tally (repo, path).

Input Schema

Name	Required	Description
`id`	No	links: the truth's id
`from`	No	links: one end, as <type>:<id> — node, span, truth, message or knowledge; a node's id may be its console link, a knowledge item's its search citation
`node`	No	versions: 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. · claims: the document's node id instead of a path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · truths, spans: a node id, instead of location. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · github_issues: folder or document node id, instead of location. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too.
`path`	No	reports: the file's path in it, e.g. skills/grill-me/SKILL.md
`repo`	No	reports: owner/name of the public repository
`seat`	No	the seat token identity_write action=take_seat gave you; pass it on every call while you drive that agent
`type`	No	documents: only documents of this type (meeting-notes, playbook, spec, brand-asset, web-clip, contract, misc); set it with frontmatter on write
`view`	No	decisions: decisions: lifecycle filter, applied before pagination
`depth`	No	links: follow links this many steps out (default 1)
`group`	No	people: a group id or its exact name, to list just that group's members
`issue`	No	github_issues: GitHub issue URL or owner/repo#N (required for bind_issue, of_issue; optional for unbind_issue / github_issues)
`kinds`	No	inbox: inbox: only these kinds, e.g. question and request, the ones waiting on your reply
`label`	No	documents: label to filter by — matches a document's own labels AND any inherited from a folder or directory above it. Organization only; labels never affect what you are allowed to read
`limit`	No	documents: max results this page (clamped to the server cap MAX_PAGE_SIZE) · decisions: decisions: records per page, at most 25
`query`	No	decisions: decisions: search the authorized decision history · lessons: a key term, matched as one phrase inside a title, body or field · packages: words to match in a package's title, summary or body
`scope`	No	lessons: the folder or document it applies to (path or node id). A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too.
`action`	Yes	what to do; each action takes the arguments its line names
`offset`	No	documents: results to skip — pass the previous page's nextOffset to page · inbox: inbox: skip this many (nextOffset from the last page) to see the rest · decisions, spans: spans: the span index to start at, from a previous answer's nextOffset
`parent`	No	folders: list inside this folder, e.g. "handbook" or "handbook/vendor". Omit for the top level. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too.
`location`	No	folders: full path to scope to, e.g. "handbook" or "handbook/vendor". Omit to cover everything you can reach. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · versions: 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. · documents: the folder to list, full path from the workspace root, e.g. "handbook" or "handbook/vendor". A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · claims: the document, whole path from the workspace root. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · truths, spans: a document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · comments: the document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · github_issues: folder or document path to bind. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · context: a folder or document; its folder and every folder above it are asked. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too.
`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
`include_history`	No	decisions: decisions: include superseded records

Output Schema

Name	Required	Description
`bind`	No
`item`	No
`link`	No
`loop`	No
`more`	No
`node`	No
`pins`	No
`room`	No
`text`	No	the answer as prose, for an action that answers in prose
`vote`	No
`wait`	No
`added`	No
`binds`	No
`claim`	No
`items`	No
`links`	No
`mount`	No
`moved`	No
`notes`	No
`rooms`	No
`since`	No
`spans`	No
`tally`	No
`truth`	No
`waits`	No
`action`	Yes	the action that answered
`claims`	No
`debate`	No
`failed`	No
`heldBy`	No
`memory`	No
`pinned`	No
`pulled`	No
`report`	No
`schema`	No
`skills`	No
`status`	No
`thread`	No	resolve_comment: the thread resolved
`truths`	No
`wanted`	No
`comment`	No
`history`	No
`message`	No
`package`	No
`pending`	No
`project`	No
`reports`	No
`unbound`	No
`comments`	No
`decision`	No
`location`	No
`messages`	No
`packages`	No
`position`	No
`projects`	No
`proposal`	No
`replayed`	No
`standing`	No
`versions`	No	the document's versions, newest first
`available`	No
`decisions`	No
`escalated`	No
`truncated`	No	inbox: more are waiting past this page
`withdrawn`	No
`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
`already_resolved`	No	resolve_comment: it was resolved before this call

Schema Changelog

Changes observed during successful MCP inspections.

Changed10 schema fields changedOct 30, 2026

changedInput schema / properties / action / enum

Previous value: -[
-  "folders",
-  "versions",
-  "documents",
-  "sources",
-  "people",
-  "inbox",
-  "claims",
-  "waits",
-  "subscriptions",
-  "rooms",
-  "truths",
-  "spans",
-  "links",
-  "drafts",
-  "lessons",
-  "comments",
-  "connectors",
-  "pins",
-  "github_issues",
-  "projects",
-  "packages",
-  "context",
-  "reports"
-]New value: +[
+  "folders",
+  "versions",
+  "documents",
+  "sources",
+  "people",
+  "inbox",
+  "claims",
+  "waits",
+  "subscriptions",
+  "rooms",
+  "decisions",
+  "truths",
+  "spans",
+  "links",
+  "drafts",
+  "lessons",
+  "comments",
+  "connectors",
+  "pins",
+  "github_issues",
+  "projects",
+  "packages",
+  "context",
+  "reports"
+]

addedInput schema / properties / include_history

Added value: +{
+  "description": "decisions: decisions: include superseded records",
+  "type": "boolean"
+}

changedInput schema / properties / limit / description

Previous value: -"documents: max results this page (clamped to the server cap MAX_PAGE_SIZE)"New value: +"documents: max results this page (clamped to the server cap MAX_PAGE_SIZE) · decisions: decisions: records per page, at most 25"

changedInput schema / properties / offset / description

Previous value: -"documents: results to skip — pass the previous page's nextOffset to page · inbox: inbox: skip this many (nextOffset from the last page) to see the rest · spans: spans: the span index to start at, from a previous answer's nextOffset"New value: +"documents: results to skip — pass the previous page's nextOffset to page · inbox: inbox: skip this many (nextOffset from the last page) to see the rest · decisions, spans: spans: the span index to start at, from a previous answer's nextOffset"

changedInput schema / properties / query / description

Previous value: -"lessons: a key term, matched as one phrase inside a title, body or field · packages: words to match in a package's title, summary or body"New value: +"decisions: decisions: search the authorized decision history · lessons: a key term, matched as one phrase inside a title, body or field · packages: words to match in a package's title, summary or body"

addedInput schema / properties / view

Added value: +{
+  "description": "decisions: decisions: lifecycle filter, applied before pagination",
+  "enum": [
+    "all",
+    "needs",
+    "decided",
+    "completed"
+  ],
+  "type": "string"
+}

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"

Changed7 schema fields changedOct 27, 2026

changedInput schema / properties / action / enum

Previous value: -[
-  "folders",
-  "versions",
-  "documents",
-  "sources",
-  "people",
-  "inbox",
-  "claims",
-  "waits",
-  "subscriptions",
-  "rooms",
-  "truths",
-  "spans",
-  "links",
-  "drafts",
-  "lessons",
-  "comments",
-  "connectors",
-  "pins",
-  "projects",
-  "packages",
-  "context",
-  "reports"
-]New value: +[
+  "folders",
+  "versions",
+  "documents",
+  "sources",
+  "people",
+  "inbox",
+  "claims",
+  "waits",
+  "subscriptions",
+  "rooms",
+  "truths",
+  "spans",
+  "links",
+  "drafts",
+  "lessons",
+  "comments",
+  "connectors",
+  "pins",
+  "github_issues",
+  "projects",
+  "packages",
+  "context",
+  "reports"
+]

addedInput schema / properties / issue

Added value: +{
+  "description": "github_issues: GitHub issue URL or owner/repo#N (required for bind_issue, of_issue; optional for unbind_issue / github_issues)",
+  "type": "string"
+}

changedInput schema / properties / location / description

Previous value: -"folders: full path to scope to, e.g. \"handbook\" or \"handbook/vendor\". Omit to cover everything you can reach. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · versions: 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. · documents: the folder to list, full path from the workspace root, e.g. \"handbook\" or \"handbook/vendor\". A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · truths, spans: a document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · comments: the document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · context: a folder or document; its folder and every folder above it are asked. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."New value: +"folders: full path to scope to, e.g. \"handbook\" or \"handbook/vendor\". Omit to cover everything you can reach. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · versions: 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. · documents: the folder to list, full path from the workspace root, e.g. \"handbook\" or \"handbook/vendor\". A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · claims: the document, whole path from the workspace root. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · truths, spans: a document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · comments: the document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · github_issues: folder or document path to bind. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · context: a folder or document; its folder and every folder above it are asked. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."

changedInput schema / properties / node / description

Previous value: -"versions: 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. · truths, spans: a node id, instead of location. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."New value: +"versions: 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. · claims: the document's node id instead of a path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · truths, spans: a node id, instead of location. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · github_issues: folder or document node id, instead of location. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."

addedOutput schema / properties / bind

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "issue": {
+      "type": "string"
+    },
+    "kind": {
+      "enum": [
+        "folder",
+        "document"
+      ],
+      "type": "string"
+    },
+    "location": {
+      "type": "string"
+    },
+    "node": {
+      "type": "string"
+    },
+    "pointer_body": {
+      "type": "string"
+    },
+    "pointer_url": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "issue",
+    "node",
+    "location",
+    "kind",
+    "pointer_url",
+    "pointer_body"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / binds

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "issue": {
+        "type": "string"
+      },
+      "kind": {
+        "enum": [
+          "folder",
+          "document"
+        ],
+        "type": "string"
+      },
+      "location": {
+        "type": "string"
+      },
+      "node": {
+        "type": "string"
+      },
+      "pointer_body": {
+        "type": "string"
+      },
+      "pointer_url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "issue",
+      "node",
+      "location",
+      "kind",
+      "pointer_url",
+      "pointer_body"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / unbound
```
Added value: +{
+  "type": "boolean"
+}
```

Changed113 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 / claim / properties / span / anyOf

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

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

removedOutput schema / properties / claims / items / properties / span / anyOf

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

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

removedOutput schema / properties / comment / properties / anchor_prefix / anyOf

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

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

removedOutput schema / properties / comment / properties / anchor_suffix / anyOf

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

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

removedOutput schema / properties / comment / properties / author_id / anyOf

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

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

removedOutput schema / properties / comment / properties / commit_hash / anyOf

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

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

removedOutput schema / properties / comment / properties / marker_by / anyOf

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

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

removedOutput schema / properties / comment / properties / marker_link / anyOf

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

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

removedOutput schema / properties / comment / properties / quote / anyOf

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

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

removedOutput schema / properties / comment / properties / span_id / anyOf

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

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

removedOutput schema / properties / comment / properties / span_text / anyOf

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

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

changedOutput schema / properties / comments / anyOf

Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "actor_kind": {
-          "type": "string"
-        },
-        "anchor_prefix": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "the text just before quote, which places it when the quote repeats"
-        },
-        "anchor_suffix": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "the text just after quote"
-        },
-        "author_display": {
-          "type": "string"
-        },
-        "author_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "body": {
-          "type": "string"
-        },
-        "commit_hash": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "the document's commit when this was written; null on a folder's discussion"
-        },
-        "created_at": {
-          "type": "string"
-        },
-        "id": {
-          "type": "string"
-        },
-        "location": {
-          "type": "string"
-        },
-        "marker": {
-          "anyOf": [
-            {
-              "enum": [
-                "taken",
-                "reported"
-              ],
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "a reply's status for the thread's work"
-        },
-        "marker_by": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "taken: the date it is promised by, YYYY-MM-DD"
-        },
-        "marker_link": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "reported: where the work is; null when you cannot read it"
-        },
-        "quote": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "resolved": {
-          "type": "boolean"
-        },
-        "span_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "span_text": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "comments: the span's current text"
-        },
-        "thread_id": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "id",
-        "location",
-        "thread_id",
-        "quote",
-        "anchor_prefix",
-        "anchor_suffix",
-        "author_id",
-        "author_display",
-        "actor_kind",
-        "span_id",
-        "body",
-        "resolved",
-        "created_at"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "at": {
-          "type": "string"
-        },
-        "author": {
-          "type": "string"
-        },
-        "authorKind": {
-          "type": "string"
-        },
-        "body": {
-          "type": "string"
-        },
-        "org": {
-          "type": "string"
-        },
-        "version": {
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "required": [
-        "author",
-        "authorKind",
-        "org",
-        "body",
-        "version",
-        "at"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "actor_kind": {
+          "type": "string"
+        },
+        "anchor_prefix": {
+          "description": "the text just before quote, which places it when the quote repeats",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "anchor_suffix": {
+          "description": "the text just after quote",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "author_display": {
+          "type": "string"
+        },
+        "author_id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "body": {
+          "type": "string"
+        },
+        "commit_hash": {
+          "description": "the document's commit when this was written; null on a folder's discussion",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "location": {
+          "type": "string"
+        },
+        "marker": {
+          "anyOf": [
+            {
+              "enum": [
+                "taken",
+                "reported"
+              ],
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "a reply's status for the thread's work"
+        },
+        "marker_by": {
+          "description": "taken: the date it is promised by, YYYY-MM-DD",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "marker_link": {
+          "description": "reported: where the work is; null when you cannot read it",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "quote": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "resolved": {
+          "type": "boolean"
+        },
+        "span_id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "span_text": {
+          "description": "comments: the span's current text",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "thread_id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "location",
+        "thread_id",
+        "quote",
+        "anchor_prefix",
+        "anchor_suffix",
+        "author_id",
+        "author_display",
+        "actor_kind",
+        "span_id",
+        "body",
+        "resolved",
+        "created_at"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "at": {
+          "type": "string"
+        },
+        "author": {
+          "type": "string"
+        },
+        "authorKind": {
+          "type": "string"
+        },
+        "body": {
+          "type": "string"
+        },
+        "org": {
+          "type": "string"
+        },
+        "version": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "author",
+        "authorKind",
+        "org",
+        "body",
+        "version",
+        "at"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  }
+]

removedOutput schema / properties / heldBy / items / properties / span / anyOf

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

addedOutput schema / properties / heldBy / items / properties / span / type
```
Added value: +[
+  "string",
+  "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 / 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": {
-        "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"
-  },
-  {
-    "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"
-  }
-]New value: +[
+  {
+    "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"
+  },
+  {
+    "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"
+  }
+]

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 / mount / properties / commitSha / anyOf

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

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

removedOutput schema / properties / mount / properties / folder / anyOf

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

addedOutput schema / properties / mount / properties / folder / 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 / project / properties / owner / anyOf

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

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

removedOutput schema / properties / projects / items / properties / owner / anyOf

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

addedOutput schema / properties / projects / items / properties / owner / type
```
Added value: +[
+  "string",
+  "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 / report / properties / onBehalfOf / anyOf

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

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

removedOutput schema / properties / report / properties / org / anyOf

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

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

removedOutput schema / properties / reports / items / properties / onBehalfOf / anyOf

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

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

removedOutput schema / properties / reports / items / properties / org / anyOf

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

addedOutput schema / properties / reports / items / properties / org / 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"
+]
```

Changed9 schema fields changedOct 20, 2026
- 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"
+}
```

Changed8 schema fields 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"
+}

changedInput schema / properties / action / enum

Previous value: -[
-  "folders",
-  "versions",
-  "documents",
-  "sources",
-  "people",
-  "inbox",
-  "claims",
-  "waits",
-  "subscriptions",
-  "rooms",
-  "truths",
-  "spans",
-  "links",
-  "drafts",
-  "lessons",
-  "comments",
-  "connectors",
-  "pins",
-  "packages",
-  "context",
-  "reports"
-]New value: +[
+  "folders",
+  "versions",
+  "documents",
+  "sources",
+  "people",
+  "inbox",
+  "claims",
+  "waits",
+  "subscriptions",
+  "rooms",
+  "truths",
+  "spans",
+  "links",
+  "drafts",
+  "lessons",
+  "comments",
+  "connectors",
+  "pins",
+  "projects",
+  "packages",
+  "context",
+  "reports"
+]

addedOutput schema / properties / comment / properties / marker

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "taken",
+        "reported"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "a reply's status for the thread's work"
+}

addedOutput schema / properties / comment / properties / marker_by

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "taken: the date it is promised by, YYYY-MM-DD"
+}

addedOutput schema / properties / comment / properties / marker_link

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "reported: where the work is; null when you cannot read it"
+}

changedOutput schema / properties / comments / anyOf

Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "actor_kind": {
-          "type": "string"
-        },
-        "anchor_prefix": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "the text just before quote, which places it when the quote repeats"
-        },
-        "anchor_suffix": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "the text just after quote"
-        },
-        "author_display": {
-          "type": "string"
-        },
-        "author_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "body": {
-          "type": "string"
-        },
-        "commit_hash": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "the document's commit when this was written; null on a folder's discussion"
-        },
-        "created_at": {
-          "type": "string"
-        },
-        "id": {
-          "type": "string"
-        },
-        "location": {
-          "type": "string"
-        },
-        "quote": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "resolved": {
-          "type": "boolean"
-        },
-        "span_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "span_text": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "comments: the span's current text"
-        },
-        "thread_id": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "id",
-        "location",
-        "thread_id",
-        "quote",
-        "anchor_prefix",
-        "anchor_suffix",
-        "author_id",
-        "author_display",
-        "actor_kind",
-        "span_id",
-        "body",
-        "resolved",
-        "created_at"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "at": {
-          "type": "string"
-        },
-        "author": {
-          "type": "string"
-        },
-        "authorKind": {
-          "type": "string"
-        },
-        "body": {
-          "type": "string"
-        },
-        "org": {
-          "type": "string"
-        },
-        "version": {
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "required": [
-        "author",
-        "authorKind",
-        "org",
-        "body",
-        "version",
-        "at"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "actor_kind": {
+          "type": "string"
+        },
+        "anchor_prefix": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "the text just before quote, which places it when the quote repeats"
+        },
+        "anchor_suffix": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "the text just after quote"
+        },
+        "author_display": {
+          "type": "string"
+        },
+        "author_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "body": {
+          "type": "string"
+        },
+        "commit_hash": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "the document's commit when this was written; null on a folder's discussion"
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "location": {
+          "type": "string"
+        },
+        "marker": {
+          "anyOf": [
+            {
+              "enum": [
+                "taken",
+                "reported"
+              ],
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "a reply's status for the thread's work"
+        },
+        "marker_by": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "taken: the date it is promised by, YYYY-MM-DD"
+        },
+        "marker_link": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "reported: where the work is; null when you cannot read it"
+        },
+        "quote": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "resolved": {
+          "type": "boolean"
+        },
+        "span_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "span_text": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "comments: the span's current text"
+        },
+        "thread_id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "location",
+        "thread_id",
+        "quote",
+        "anchor_prefix",
+        "anchor_suffix",
+        "author_id",
+        "author_display",
+        "actor_kind",
+        "span_id",
+        "body",
+        "resolved",
+        "created_at"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "at": {
+          "type": "string"
+        },
+        "author": {
+          "type": "string"
+        },
+        "authorKind": {
+          "type": "string"
+        },
+        "body": {
+          "type": "string"
+        },
+        "org": {
+          "type": "string"
+        },
+        "version": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "author",
+        "authorKind",
+        "org",
+        "body",
+        "version",
+        "at"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  }
+]

addedOutput schema / properties / project

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "location": {
+      "type": "string"
+    },
+    "node": {
+      "type": "string"
+    },
+    "owner": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "the folder's owner, which is the project's"
+    },
+    "repos": {
+      "description": "the repositories its AGENTS.md lists under repos:, as host/owner/name",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "routing": {
+      "description": "members choose their work, or the owner's side assigns it",
+      "enum": [
+        "members",
+        "owner"
+      ],
+      "type": "string"
+    },
+    "started_at": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "node",
+    "location",
+    "routing",
+    "owner",
+    "started_at"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / projects

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "location": {
+        "type": "string"
+      },
+      "node": {
+        "type": "string"
+      },
+      "owner": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "the folder's owner, which is the project's"
+      },
+      "repos": {
+        "description": "the repositories its AGENTS.md lists under repos:, as host/owner/name",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "routing": {
+        "description": "members choose their work, or the owner's side assigns it",
+        "enum": [
+          "members",
+          "owner"
+        ],
+        "type": "string"
+      },
+      "started_at": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "node",
+      "location",
+      "routing",
+      "owner",
+      "started_at"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Changed8 schema fields changedOct 15, 2026

changedInput schema / properties / action / enum

Previous value: -[
-  "folders",
-  "documents",
-  "sources",
-  "people",
-  "inbox",
-  "claims",
-  "waits",
-  "subscriptions",
-  "rooms",
-  "truths",
-  "spans",
-  "links",
-  "drafts",
-  "lessons",
-  "comments",
-  "connectors",
-  "pins",
-  "packages",
-  "context",
-  "reports"
-]New value: +[
+  "folders",
+  "versions",
+  "documents",
+  "sources",
+  "people",
+  "inbox",
+  "claims",
+  "waits",
+  "subscriptions",
+  "rooms",
+  "truths",
+  "spans",
+  "links",
+  "drafts",
+  "lessons",
+  "comments",
+  "connectors",
+  "pins",
+  "packages",
+  "context",
+  "reports"
+]

changedInput schema / properties / location / description

Previous value: -"folders: full path to scope to, e.g. \"handbook\" or \"handbook/vendor\". Omit to cover everything you can reach. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · documents: the folder to list, full path from the workspace root, e.g. \"handbook\" or \"handbook/vendor\". A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · truths, spans: a document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · comments: the document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · context: a folder or document; its folder and every folder above it are asked. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."New value: +"folders: full path to scope to, e.g. \"handbook\" or \"handbook/vendor\". Omit to cover everything you can reach. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · versions: 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. · documents: the folder to list, full path from the workspace root, e.g. \"handbook\" or \"handbook/vendor\". A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · truths, spans: a document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · comments: the document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · context: a folder or document; its folder and every folder above it are asked. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."

changedInput schema / properties / node / description

Previous value: -"truths, spans: a node id, instead of location. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."New value: +"versions: 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. · truths, spans: a node id, instead of location. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."

addedOutput schema / properties / mount / properties / files

Added value: +{
+  "description": "how many files the mount holds",
+  "type": "number"
+}

addedOutput schema / properties / mount / properties / folder

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "for a skill that lives in a folder: where its whole folder was mounted; null for a file mounted alone"
+}

addedOutput schema / properties / mount / properties / skipped

Added value: +{
+  "description": "files of the skill's folder not copied, and why",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "path": {
+        "type": "string"
+      },
+      "why": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "path",
+      "why"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / properties / mount / required

Previous value: -[
-  "location",
-  "created",
-  "diverged",
-  "organization",
-  "follow",
-  "commitSha",
-  "changed"
-]New value: +[
+  "location",
+  "created",
+  "diverged",
+  "organization",
+  "follow",
+  "commitSha",
+  "changed",
+  "folder",
+  "files",
+  "skipped"
+]

addedOutput schema / properties / versions

Added value: +{
+  "description": "the document's versions, newest first",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "author": {
+        "description": "who committed it",
+        "type": "string"
+      },
+      "commit": {
+        "description": "the version's commit hash: pass it as commit to read action=version or doc_update action=restore_version",
+        "type": "string"
+      },
+      "message": {
+        "description": "the commit message",
+        "type": "string"
+      },
+      "ts": {
+        "description": "when, ISO 8601",
+        "type": "string"
+      }
+    },
+    "required": [
+      "commit",
+      "author",
+      "message",
+      "ts"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Changed2 schema fields changedOct 14, 2026

addedOutput schema / properties / comment / properties / commit_hash

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "the document's commit when this was written; null on a folder's discussion"
+}

changedOutput schema / properties / comments / anyOf

Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "actor_kind": {
-          "type": "string"
-        },
-        "anchor_prefix": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "the text just before quote, which places it when the quote repeats"
-        },
-        "anchor_suffix": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "the text just after quote"
-        },
-        "author_display": {
-          "type": "string"
-        },
-        "author_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "body": {
-          "type": "string"
-        },
-        "created_at": {
-          "type": "string"
-        },
-        "id": {
-          "type": "string"
-        },
-        "location": {
-          "type": "string"
-        },
-        "quote": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "resolved": {
-          "type": "boolean"
-        },
-        "span_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "span_text": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "comments: the span's current text"
-        },
-        "thread_id": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "id",
-        "location",
-        "thread_id",
-        "quote",
-        "anchor_prefix",
-        "anchor_suffix",
-        "author_id",
-        "author_display",
-        "actor_kind",
-        "span_id",
-        "body",
-        "resolved",
-        "created_at"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "at": {
-          "type": "string"
-        },
-        "author": {
-          "type": "string"
-        },
-        "authorKind": {
-          "type": "string"
-        },
-        "body": {
-          "type": "string"
-        },
-        "org": {
-          "type": "string"
-        },
-        "version": {
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "required": [
-        "author",
-        "authorKind",
-        "org",
-        "body",
-        "version",
-        "at"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "actor_kind": {
+          "type": "string"
+        },
+        "anchor_prefix": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "the text just before quote, which places it when the quote repeats"
+        },
+        "anchor_suffix": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "the text just after quote"
+        },
+        "author_display": {
+          "type": "string"
+        },
+        "author_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "body": {
+          "type": "string"
+        },
+        "commit_hash": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "the document's commit when this was written; null on a folder's discussion"
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "location": {
+          "type": "string"
+        },
+        "quote": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "resolved": {
+          "type": "boolean"
+        },
+        "span_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "span_text": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "comments: the span's current text"
+        },
+        "thread_id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "location",
+        "thread_id",
+        "quote",
+        "anchor_prefix",
+        "anchor_suffix",
+        "author_id",
+        "author_display",
+        "actor_kind",
+        "span_id",
+        "body",
+        "resolved",
+        "created_at"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "at": {
+          "type": "string"
+        },
+        "author": {
+          "type": "string"
+        },
+        "authorKind": {
+          "type": "string"
+        },
+        "body": {
+          "type": "string"
+        },
+        "org": {
+          "type": "string"
+        },
+        "version": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "author",
+        "authorKind",
+        "org",
+        "body",
+        "version",
+        "at"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  }
+]

Changed17 schema fields changedOct 12, 2026

changedInput schema / properties / from / description

Previous value: -"links: one end, as <type>:<id> — node, span, truth or message; a node's id may be its console link"New value: +"links: one end, as <type>:<id> — node, span, truth, message or knowledge; a node's id may be its console link, a knowledge item's its search citation"

addedInput schema / properties / kinds

Added value: +{
+  "description": "inbox: inbox: only these kinds, e.g. question and request, the ones waiting on your reply",
+  "items": {
+    "enum": [
+      "question",
+      "answer",
+      "finding",
+      "request",
+      "handoff",
+      "commitment"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

changedInput schema / properties / location / description

Previous value: -"folders: full path to scope to, e.g. \"handbook\" or \"handbook/vendor\". Omit to cover everything you can reach. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · documents: the folder to list, full path from the workspace root, e.g. \"handbook\" or \"handbook/vendor\". A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · truths, spans: a document or folder path · comments: the document or folder path · context: a folder or document; its folder and every folder above it are asked. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."New value: +"folders: full path to scope to, e.g. \"handbook\" or \"handbook/vendor\". Omit to cover everything you can reach. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · documents: the folder to list, full path from the workspace root, e.g. \"handbook\" or \"handbook/vendor\". A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · truths, spans: a document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · comments: the document or folder path. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too. · context: a folder or document; its folder and every folder above it are asked. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."

changedInput schema / properties / offset / description

Previous value: -"documents: results to skip — pass the previous page's nextOffset to page"New value: +"documents: results to skip — pass the previous page's nextOffset to page · inbox: inbox: skip this many (nextOffset from the last page) to see the rest · spans: spans: the span index to start at, from a previous answer's nextOffset"

addedOutput schema / properties / comment / properties / anchor_prefix

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "the text just before quote, which places it when the quote repeats"
+}

addedOutput schema / properties / comment / properties / anchor_suffix

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "the text just after quote"
+}

addedOutput schema / properties / comment / properties / span_text

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "comments: the span's current text"
+}

changedOutput schema / properties / comment / required

Previous value: -[
-  "id",
-  "location",
-  "thread_id",
-  "quote",
-  "author_id",
-  "author_display",
-  "actor_kind",
-  "span_id",
-  "body",
-  "resolved",
-  "created_at"
-]New value: +[
+  "id",
+  "location",
+  "thread_id",
+  "quote",
+  "anchor_prefix",
+  "anchor_suffix",
+  "author_id",
+  "author_display",
+  "actor_kind",
+  "span_id",
+  "body",
+  "resolved",
+  "created_at"
+]

changedOutput schema / properties / comments / anyOf

Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "actor_kind": {
-          "type": "string"
-        },
-        "author_display": {
-          "type": "string"
-        },
-        "author_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "body": {
-          "type": "string"
-        },
-        "created_at": {
-          "type": "string"
-        },
-        "id": {
-          "type": "string"
-        },
-        "location": {
-          "type": "string"
-        },
-        "quote": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "resolved": {
-          "type": "boolean"
-        },
-        "span_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "thread_id": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "id",
-        "location",
-        "thread_id",
-        "quote",
-        "author_id",
-        "author_display",
-        "actor_kind",
-        "span_id",
-        "body",
-        "resolved",
-        "created_at"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "at": {
-          "type": "string"
-        },
-        "author": {
-          "type": "string"
-        },
-        "authorKind": {
-          "type": "string"
-        },
-        "body": {
-          "type": "string"
-        },
-        "org": {
-          "type": "string"
-        },
-        "version": {
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "required": [
-        "author",
-        "authorKind",
-        "org",
-        "body",
-        "version",
-        "at"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "actor_kind": {
+          "type": "string"
+        },
+        "anchor_prefix": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "the text just before quote, which places it when the quote repeats"
+        },
+        "anchor_suffix": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "the text just after quote"
+        },
+        "author_display": {
+          "type": "string"
+        },
+        "author_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "body": {
+          "type": "string"
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "location": {
+          "type": "string"
+        },
+        "quote": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "resolved": {
+          "type": "boolean"
+        },
+        "span_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "span_text": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "comments: the span's current text"
+        },
+        "thread_id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "location",
+        "thread_id",
+        "quote",
+        "anchor_prefix",
+        "anchor_suffix",
+        "author_id",
+        "author_display",
+        "actor_kind",
+        "span_id",
+        "body",
+        "resolved",
+        "created_at"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "at": {
+          "type": "string"
+        },
+        "author": {
+          "type": "string"
+        },
+        "authorKind": {
+          "type": "string"
+        },
+        "body": {
+          "type": "string"
+        },
+        "org": {
+          "type": "string"
+        },
+        "version": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "author",
+        "authorKind",
+        "org",
+        "body",
+        "version",
+        "at"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  }
+]

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.8/5.0

Behavior5/5

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

The description adds substantial behavioral context beyond annotations: grants filtering means unreadable items are neither listed nor counted, people listings expose names only and never content, claims are an overlap peek and never a block or auto-merge, spans mark stale content when cited truths are superseded, and pagination uses nextOffset. The annotations declare read-only/idempotent/non-destructive safety, and the description complements them without contradiction.

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

Conciseness2/5

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

The description is a single massive paragraph enumerating 24 actions, with repetitive phrases and little structural separation. While the opening sentence is front-loaded, the body is dense and hard to scan, and it duplicates console-link details already present in the schema.

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

Completeness5/5

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

Given 22 parameters, 24 actions, an existing output schema, and read-only annotations, the description is complete enough to call the tool. It covers each action's scope, important permission behavior, and pagination expectations; return values are handled by the output schema.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents all 22 parameters in detail, including action-specific meanings. The description maps arguments to actions, e.g. parent/location for folders and nextOffset as offset for paging, but much of this is duplicative of the schema descriptions rather than adding new meaning.

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 opening sentence states a clear read-only purpose: "List what you can see, filtered to your grants: nothing you cannot read is listed or counted." The action catalog then specifies each resource type, and it explicitly distinguishes some siblings, e.g. sources are connections not documents and read action=document is for reading context. However, it does not clearly differentiate the overall browse/list tool from sibling search/read tools.

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?

Each action line gives implied usage by describing what the action returns and which arguments it takes, e.g. inbox with kinds and nextOffset for paging. But there is no explicit when-to-use guidance versus siblings like search or read, and no when-not-to-use guidance beyond isolated notes such as sources vs documents.

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?