Skip to main content
A file reference is one object with a kind, a fileName, and exactly one of: text (inline), url (fetched over http or https, never to private addresses, at most 64 MiB, three redirects), or uploadId (reserve with mirrors_uploads_reserve, PUT the bytes to the returned URL, then pass the id; large files never pass through the model). Kinds: traces (the recordings; see mirrors://formats/traces), agent (the agent’s source or an archive, read for tool identity), tools (tool code in Python, TypeScript or Go, bound as provided tools when it loads), schema (a DDL file the world model is reconciled against), openapi (a spec whose operations become tool candidates), toolDefs (provider tool definitions, JSON), docs (PDF, DOCX or text turned into context sources). A build needs at least one identity source: traces, tools, an OpenAPI spec, tool definitions or a schema. Re-running an intake under the same mirror name adds a new version of each input and builds again. Code and archives pass a malware scan at intake; a finding refuses the file with its name. This page is also the MCP resource an IDE agent reads; generated by pnpm docs:generate.