addedInput schema / properties / licensed_only
Added value: +{
+ "description": "scope \"public\" only: just the files whose licence lets their text be served (default false: every match, unlicensed ones described with a link)",
+ "type": "boolean"
+}
addedInput schema / properties / limit / description
Added value: +"how many hits (at most 20 with scope \"public\")"
addedInput schema / properties / max_bytes
Added value: +{
+ "description": "scope \"public\" with within only: the largest part to return, in bytes (default and ceiling 50,000); a part never splits a character, so one smaller than the character at offset holds that character",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+}
addedInput schema / properties / offset
Added value: +{
+ "description": "scope \"public\" with within only: where in the file to start, in bytes as read_org_doc takes it (a part gives nextOffset)",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+}
changedInput schema / properties / query / description
Previous value: -"what you want to know"New value: +"what you want to know (not needed to open a public file with scope \"public\" and within)"
changedInput schema / properties / within / description
Previous value: -"a document path or node id. A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."New value: +"a document path or node id; with scope \"public\", one public file as owner/repo/path, its agentlefs://public/ URI, a hit's citation or its GitHub link at a commit (either also says whether the repository has moved on since), or its link (not one from another console served under a path prefix). A console link (`/d/<Name-Slug>-<32 hex>`, whole or just its id) is accepted too."
removedInput schema / required
Removed value: -[
- "query"
-]
addedOutput schema / properties / file
Added value: +{
+ "additionalProperties": false,
+ "properties": {
+ "body": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "bodyTruncated": {
+ "description": "the body is one part of the file, not all of it: offset and nextOffset say which",
+ "type": "boolean"
+ },
+ "bytes": {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "the size of the served text in bytes, which parts are counted in; for a withheld file, the size GitHub reported"
+ },
+ "capabilities": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "changedAt": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "when the repository's agent context last changed: one history lookup per repository (its skills folder, or its first file), so a sibling file moves it too. Freshness, not a per-file clock"
+ },
+ "citation": {
+ "description": "github:owner/repo@<commit>:path, the form to write down: within reopens it and says whether the repository has moved on",
+ "type": "string"
+ },
+ "citedCommit": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "the repository commit a citation, or a GitHub link at a commit, named, when the file was opened by one"
+ },
+ "citedCommitCollected": {
+ "anyOf": [
+ {
+ "type": "boolean"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "whether that is the repository commit this copy was collected at; false means the repository has moved on since, not that this file did. No field here proves this one file changed: changedAt is per repository, and bytes counts GitHub's size on a search hit but the stored text's on an opened file, so the two do not compare"
+ },
+ "citedLink": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "the file on GitHub at the cited commit, outside this server: the corpus holds one commit per file, so body is those bytes only when citedCommitCollected is true"
+ },
+ "collectedAt": {
+ "type": "string"
+ },
+ "commit": {
+ "type": "string"
+ },
+ "description": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "kind": {
+ "enum": [
+ "skill",
+ "agents_md",
+ "claude_md",
+ "cursor_rule",
+ "copilot_instructions",
+ "llms_txt"
+ ],
+ "type": "string"
+ },
+ "knownPublisher": {
+ "description": "the publisher is an organization we recognise (model labs, agent and editor makers): provenance, not an endorsement",
+ "type": "boolean"
+ },
+ "licence": {
+ "type": "string"
+ },
+ "link": {
+ "description": "where a person reads it: this server's console catalog page, or GitHub when it has no console. within reopens this server's links; another console's may not",
+ "type": "string"
+ },
+ "maxBytes": {
+ "description": "the part size this read asked for; pass it again with nextOffset to keep parts this size",
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ },
+ "nextOffset": {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "offset": {
+ "type": "number"
+ },
+ "origin": {
+ "const": "public",
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "redistributable": {
+ "description": "whether the licence lets agentleFS serve the text: false means body is null, withheld says why, and sourceLink is where to read it",
+ "type": "boolean"
+ },
+ "repo": {
+ "type": "string"
+ },
+ "sourceLink": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "the file on GitHub at the commit collected, readable whatever its licence; null when no commit is known. within reopens it and says whether the repository has moved on"
+ },
+ "stars": {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "uri": {
+ "description": "agentlefs://public/… for an agent: read it as a resource, or pass it as within",
+ "type": "string"
+ },
+ "withheld": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "required": [
+ "origin",
+ "name",
+ "repo",
+ "path",
+ "kind",
+ "description",
+ "licence",
+ "redistributable",
+ "capabilities",
+ "stars",
+ "bytes",
+ "knownPublisher",
+ "changedAt",
+ "citation",
+ "link",
+ "sourceLink",
+ "uri",
+ "commit",
+ "collectedAt",
+ "body",
+ "offset",
+ "nextOffset",
+ "maxBytes",
+ "bodyTruncated",
+ "withheld",
+ "citedCommit",
+ "citedLink",
+ "citedCommitCollected"
+ ],
+ "type": "object"
+}
addedOutput schema / properties / hits / items / properties / matched
Added value: +{
+ "description": "Why this hit matched, strongest evidence first: its file name, title or an alias (titles), a label on it (labels), a literal phrase in its body (text), or a semantically near chunk (meaning). `labels` is evidence you can read but not yet ask for: `how` takes the other three. Document hits carry it; hits from within one document, one thread, or knowledge do not, because there the single strategy is already named in `mode` and `score` is the rank key.",
+ "items": {
+ "enum": [
+ "titles",
+ "labels",
+ "text",
+ "meaning"
+ ],
+ "type": "string"
+ },
+ "type": "array"
+}
addedOutput schema / properties / licensedOnly
Added value: +{
+ "type": "boolean"
+}
addedOutput schema / properties / public
Added value: +{
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "bytes": {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "the file's size in bytes as GitHub reported it, so a read can be budgeted before it is made"
+ },
+ "capabilities": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "changedAt": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "when the repository's agent context last changed: one history lookup per repository (its skills folder, or its first file), so a sibling file moves it too. Freshness, not a per-file clock"
+ },
+ "citation": {
+ "description": "github:owner/repo@<commit>:path, the form to write down: within reopens it and says whether the repository has moved on",
+ "type": "string"
+ },
+ "description": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "kind": {
+ "enum": [
+ "skill",
+ "agents_md",
+ "claude_md",
+ "cursor_rule",
+ "copilot_instructions",
+ "llms_txt"
+ ],
+ "type": "string"
+ },
+ "knownPublisher": {
+ "description": "the publisher is an organization we recognise (model labs, agent and editor makers): provenance, not an endorsement",
+ "type": "boolean"
+ },
+ "licence": {
+ "type": "string"
+ },
+ "link": {
+ "description": "where a person reads it: this server's console catalog page, or GitHub when it has no console. within reopens this server's links; another console's may not",
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "origin": {
+ "const": "public",
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "redistributable": {
+ "description": "whether the licence lets agentleFS serve the text: false means body is null, withheld says why, and sourceLink is where to read it",
+ "type": "boolean"
+ },
+ "repo": {
+ "type": "string"
+ },
+ "sourceLink": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "the file on GitHub at the commit collected, readable whatever its licence; null when no commit is known. within reopens it and says whether the repository has moved on"
+ },
+ "stars": {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "uri": {
+ "description": "agentlefs://public/… for an agent: read it as a resource, or pass it as within",
+ "type": "string"
+ }
+ },
+ "required": [
+ "origin",
+ "name",
+ "repo",
+ "path",
+ "kind",
+ "description",
+ "licence",
+ "redistributable",
+ "capabilities",
+ "stars",
+ "bytes",
+ "knownPublisher",
+ "changedAt",
+ "citation",
+ "link",
+ "sourceLink",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}