[{"_1":2,"_3":4},"routes/docs/layout",{"_5":19},"docs-en",{"_5":6},"data",{"_7":8,"_9":10,"_11":12,"_13":14,"_15":16,"_17":18},"path","en/index.mdx","url","/en/docs","alternate_url","/zh/docs","title","Downcity Docs","description","Agent infrastructure docs for AI builders using Downcity.","rawMarkdown","---\ntitle: Downcity Docs\ndescription: Agent infrastructure docs for AI builders using Downcity.\n---\n\n# Downcity Docs\n\nDowncity is agent infrastructure for AI builders. These docs help you run local agents, connect City, connect models and plugins, and turn agent workflows into real product surfaces.\n\nThe shortest product model:\n\n- products own the user experience\n- agents execute work inside explicit runtime boundaries\n- Downcity provides the reusable runtime layer for models, tools, tasks, memory, services, permissions, usage, billing, and control surfaces\n\n## Start Here\n\n1. [Quickstart](/en/docs/quickstart)\n2. [Agent](/en/docs/agent)\n3. [Plugin](/en/docs/plugin)\n4. [City](/en/docs/city)\n5. [Federation & Service](/en/docs/federation)\n6. [Architecture](/en/docs/concepts/architecture)\n7. [Security](/en/docs/security)\n8. [CLI](/en/docs/cli)\n9. [Agent SDK](/en/agent-sdk-docs)\n10. [City SDK](/en/city-sdk-docs)\n11. [Payments](/en/payments)\n12. [Agent Plugins Docs](/en/plugins-docs)\n13. [UI SDK](/en/ui-sdk-docs)\n\n## Documentation Spaces\n\n- [Products](/en/docs): product-level docs: Agent, Plugin, City, Federation, security, and reference.\n- [Agent SDK](/en/agent-sdk-docs): programmable agents, sessions, local/remote agent, model binding, and plugin APIs.\n- [City SDK](/en/city-sdk-docs): `City`, `Federation`, downcity identity, tokens, service/action infrastructure, and deployment.\n- [Payments](/en/payments): accounts, balance, usage, and Stripe payment services.\n- [Agent Plugins Docs](/en/plugins-docs): built-in plugin manuals and plugin examples.\n- [UI SDK](/en/ui-sdk-docs): reusable UI components and Workboard surfaces.\n",{"_20":21,"_22":23},"tree",{"_24":25,"_26":27,"_28":29,"_30":14,"_15":-7,"_31":32,"_33":34},"lang","en","type","root","$ref",{"_40":57,"_49":350},"$id","en:root","name","children",[58,59,60,61,62,63,64,65,66,67,68],"fallback",{"_24":25,"_26":35,"_28":36,"_30":37,"_15":-7,"_31":38},{"_40":57,"_49":-7},"fallback:root","Docs",[39],{"_24":40,"_30":41,"_25":-7,"_42":-7,"_15":-7,"_43":-7,"_31":44,"_28":45,"_26":46,"_47":-7},"folder","Cli","defaultOpen","collapsible",[50],"fallback:cli",{"_40":48,"_49":-7},"icon","cli","meta",{"_28":51,"_24":52,"_30":53,"_15":54,"_47":-7,"_9":55,"_26":56},"fallback:cli/cli.mdx","page","Agent CLI","How to use the CLI to manage Agent projects","/docs/cli/cli","cli/cli.mdx","",{"_28":348,"_24":52,"_30":14,"_15":16,"_47":-7,"_9":10,"_26":349},{"_28":343,"_24":52,"_30":344,"_15":345,"_47":-7,"_9":346,"_26":347},{"_24":40,"_30":308,"_25":-7,"_42":-7,"_15":-7,"_43":-7,"_31":309,"_28":310,"_26":311,"_47":-7},{"_24":40,"_30":267,"_25":-7,"_42":-7,"_15":-7,"_43":-7,"_31":268,"_28":269,"_26":270,"_47":-7},{"_24":40,"_30":238,"_25":-7,"_42":-7,"_15":-7,"_43":-7,"_31":239,"_28":240,"_26":241,"_47":-7},{"_24":40,"_30":179,"_25":-7,"_42":-7,"_15":-7,"_43":-7,"_31":180,"_28":181,"_26":182,"_47":-7},{"_24":40,"_30":162,"_25":-7,"_42":-7,"_15":-7,"_43":-7,"_31":163,"_28":164,"_26":165,"_47":-7},{"_24":40,"_30":132,"_25":-7,"_42":-7,"_15":-7,"_43":-7,"_31":133,"_28":134,"_26":135,"_47":-7},{"_24":40,"_30":105,"_25":-7,"_42":-7,"_15":-7,"_43":-7,"_31":106,"_28":107,"_26":108,"_47":-7},{"_24":40,"_30":81,"_25":-7,"_42":-7,"_15":-7,"_43":-7,"_31":82,"_28":83,"_26":84,"_47":-7},{"_24":40,"_30":69,"_25":-7,"_42":-7,"_15":-7,"_43":-7,"_31":70,"_28":71,"_26":72,"_47":-7},"Community",[75],"en:community",{"_40":73,"_49":74},"community","community/meta.json",{"_28":76,"_24":52,"_30":77,"_15":78,"_47":-7,"_9":79,"_26":80},"en:community/contributing.mdx","Contributing","How to contribute to Downcity","/en/docs/community/contributing","community/contributing.mdx","Reference",[87,88,89],"en:reference",{"_40":85,"_49":86},"reference","reference/meta.json",{"_28":100,"_24":52,"_30":101,"_15":102,"_47":-7,"_9":103,"_26":104},{"_28":95,"_24":52,"_30":96,"_15":97,"_47":-7,"_9":98,"_26":99},{"_28":90,"_24":52,"_30":91,"_15":92,"_47":-7,"_9":93,"_26":94},"en:reference/api.mdx","HTTP API Reference","Public runtime HTTP endpoints with request examples","/en/docs/reference/api","reference/api.mdx","en:reference/dot-downcity.mdx",".downcity Directory","Runtime data layout and what each folder is for","/en/docs/reference/dot-downcity","reference/dot-downcity.mdx","en:reference/cli.mdx","CLI Commands","Where Downcity command-line references live","/en/docs/reference/cli","reference/cli.mdx","CLI",[110,111,112,113],"en:cli",{"_40":48,"_49":109},"cli/meta.json",{"_28":128,"_24":52,"_30":105,"_15":129,"_47":-7,"_9":130,"_26":131},{"_28":124,"_24":52,"_30":101,"_15":125,"_47":-7,"_9":126,"_26":127},{"_28":119,"_24":52,"_30":120,"_15":121,"_47":-7,"_9":122,"_26":123},{"_28":114,"_24":52,"_30":115,"_15":116,"_47":-7,"_9":117,"_26":118},"en:cli/project.mdx","Project Structure","Boundaries between Agent projects, global config, and runtime data","/en/docs/cli/project","cli/project.mdx","en:cli/init.mdx","Project Init","Create an Agent project and its global config with the CLI","/en/docs/cli/init","cli/init.mdx","en:cli/commands.mdx","Common City and Fed commands","/en/docs/cli/commands","cli/commands.mdx","en:cli/overview.mdx","City manages local Agents; Fed manages Federation Servers","/en/docs/cli/overview","cli/overview.mdx","Security & Permissions",[138,139,140,141],"en:security",{"_40":136,"_49":137},"security","security/meta.json",{"_28":157,"_24":52,"_30":158,"_15":159,"_47":-7,"_9":160,"_26":161},{"_28":152,"_24":52,"_30":153,"_15":154,"_47":-7,"_9":155,"_26":156},{"_28":147,"_24":52,"_30":148,"_15":149,"_47":-7,"_9":150,"_26":151},{"_28":142,"_24":52,"_30":143,"_15":144,"_47":-7,"_9":145,"_26":146},"en:security/data-security.mdx","Data Storage and Permissions","Local configuration storage, file permissions, and user guidance","/en/docs/security/data-security","security/data-security.mdx","en:security/permissions.mdx","Chat Access","Understand the admission model for Chat users entering an Agent","/en/docs/security/permissions","security/permissions.mdx","en:security/api-authentication.mdx","API Authentication","Understand the Bearer-token authentication boundary used by Downcity APIs","/en/docs/security/api-authentication","security/api-authentication.mdx","en:security/overview.mdx","Security and Permissions Overview","User-facing security model for isolation, Chat Access, and local configuration permissions","/en/docs/security/overview","security/overview.mdx","Architecture",[168,169],"en:concepts",{"_40":166,"_49":167},"concepts","concepts/meta.json",{"_28":175,"_24":52,"_30":162,"_15":176,"_47":-7,"_9":177,"_26":178},{"_28":170,"_24":52,"_30":171,"_15":172,"_47":-7,"_9":173,"_26":174},"en:concepts/project-logic-overview.mdx","Project Logic Overview","One-page overview of Downcity as reusable agent infrastructure for AI builders","/en/docs/concepts/project-logic-overview","concepts/project-logic-overview.mdx","en:concepts/architecture.mdx","Core architecture layers in Downcity: console, agent, execution context, session, and plugin runtime","/en/docs/concepts/architecture","concepts/architecture.mdx","Federation & Service",[185,186,187,188,189,190,191,192,193],"en:federation",{"_40":183,"_49":184},"federation","federation/meta.json",{"_28":234,"_24":52,"_30":179,"_15":235,"_47":-7,"_9":236,"_26":237},{"_28":229,"_24":52,"_30":230,"_15":231,"_47":-7,"_9":232,"_26":233},{"_28":224,"_24":52,"_30":225,"_15":226,"_47":-7,"_9":227,"_26":228},{"_28":219,"_24":52,"_30":220,"_15":221,"_47":-7,"_9":222,"_26":223},{"_28":214,"_24":52,"_30":215,"_15":216,"_47":-7,"_9":217,"_26":218},{"_28":209,"_24":52,"_30":210,"_15":211,"_47":-7,"_9":212,"_26":213},{"_28":204,"_24":52,"_30":205,"_15":206,"_47":-7,"_9":207,"_26":208},{"_28":199,"_24":52,"_30":200,"_15":201,"_47":-7,"_9":202,"_26":203},{"_28":194,"_24":52,"_30":195,"_15":196,"_47":-7,"_9":197,"_26":198},"en:federation/routing.mdx","Routing","How Federation routes requests and handles failover","/en/docs/federation/routing","federation/routing.mdx","en:federation/action.mdx","Action","How Actions provide discrete operations that Agents can invoke","/en/docs/federation/action","federation/action.mdx","en:federation/service.mdx","Service","How the Service infrastructure provides backend capabilities to Agents","/en/docs/federation/service","federation/service.mdx","en:federation/local-proxy.mdx","Local Proxy","Use a skill to create a local Federation service backed by Codex or Claude Code through CLIProxyAPI","/en/docs/federation/local-proxy","federation/local-proxy.mdx","en:federation/model-provider.mdx","Model Provider","How Federation registers and manages AI model providers","/en/docs/federation/model-provider","federation/model-provider.mdx","en:federation/organizations-bureau.mdx","Integrate Organizations into Bureau","Verify user_token, check Membership, and enforce product resource permissions","/en/docs/federation/organizations-bureau","federation/organizations-bureau.mdx","en:federation/organizations-api.mdx","Organizations Federation API","HTTP and SDK reference for Organizations Service","/en/docs/federation/organizations-api","federation/organizations-api.mdx","en:federation/organizations.mdx","Organizations","Manage Federation-wide or Bureau-scoped Organizations and memberships","/en/docs/federation/organizations","federation/organizations.mdx","en:federation/overview.mdx","What Federation and Service are in Downcity's AI infrastructure","/en/docs/federation/overview","federation/overview.mdx","City",[244,245,246,247],"en:city",{"_40":242,"_49":243},"city","city/meta.json",{"_28":263,"_24":52,"_30":238,"_15":264,"_47":-7,"_9":265,"_26":266},{"_28":258,"_24":52,"_30":259,"_15":260,"_47":-7,"_9":261,"_26":262},{"_28":253,"_24":52,"_30":254,"_15":255,"_47":-7,"_9":256,"_26":257},{"_28":248,"_24":52,"_30":249,"_15":250,"_47":-7,"_9":251,"_26":252},"en:city/usage-billing.mdx","Usage & Billing","How City tracks usage, manages balance, and handles billing","/en/docs/city/usage-billing","city/usage-billing.mdx","en:city/identity.mdx","Identity","How Embassy accesses Federation user and administrator identities","/en/docs/city/identity","city/identity.mdx","en:city/model-pool.mdx","Model Pool","How City manages the model catalog and how Agents bind to models","/en/docs/city/model-pool","city/model-pool.mdx","en:city/overview.mdx","What City is and how it provides shared AI infrastructure to Agents","/en/docs/city/overview","city/overview.mdx","Plugin",[273,274,275,276,277,278],"en:plugin",{"_40":271,"_49":272},"plugin","plugin/meta.json",{"_28":304,"_24":52,"_30":267,"_15":305,"_47":-7,"_9":306,"_26":307},{"_28":299,"_24":52,"_30":300,"_15":301,"_47":-7,"_9":302,"_26":303},{"_28":294,"_24":52,"_30":295,"_15":296,"_47":-7,"_9":297,"_26":298},{"_28":289,"_24":52,"_30":290,"_15":291,"_47":-7,"_9":292,"_26":293},{"_28":284,"_24":52,"_30":285,"_15":286,"_47":-7,"_9":287,"_26":288},{"_28":279,"_24":52,"_30":280,"_15":281,"_47":-7,"_9":282,"_26":283},"en:plugin/custom.mdx","Custom Plugin","Build, publish, and configure an installable Downcity Plugin","/en/docs/plugin/custom","plugin/custom.mdx","en:plugin/shell.mdx","Shell Plugin","How the Shell plugin executes local commands safely","/en/docs/plugin/shell","plugin/shell.mdx","en:plugin/memory.mdx","Memory Plugin","How the Memory plugin persists conversation history and context","/en/docs/plugin/memory","plugin/memory.mdx","en:plugin/task.mdx","Task Plugin","How the Task plugin schedules and runs background jobs","/en/docs/plugin/task","plugin/task.mdx","en:plugin/chat.mdx","Chat Plugin","How the Chat plugin connects agents to messaging channels","/en/docs/plugin/chat","plugin/chat.mdx","en:plugin/overview.mdx","What a Downcity Plugin is and how it extends Agent capabilities","/en/docs/plugin/overview","plugin/overview.mdx","Agent",[314,315,316,317,318],"en:agent",{"_40":312,"_49":313},"agent","agent/meta.json",{"_28":339,"_24":52,"_30":308,"_15":340,"_47":-7,"_9":341,"_26":342},{"_28":334,"_24":52,"_30":335,"_15":336,"_47":-7,"_9":337,"_26":338},{"_28":329,"_24":52,"_30":330,"_15":331,"_47":-7,"_9":332,"_26":333},{"_28":324,"_24":52,"_30":325,"_15":326,"_47":-7,"_9":327,"_26":328},{"_28":319,"_24":52,"_30":320,"_15":321,"_47":-7,"_9":322,"_26":323},"en:agent/lifecycle.mdx","Agent Lifecycle","Construct, ready, execute, and dispose an Agent","/en/docs/agent/lifecycle","agent/lifecycle.mdx","en:agent/runtime-architecture.mdx","Agent Runtime Architecture","Session execution, checkpoints, message persistence, security boundaries, and cross-platform behavior","/en/docs/agent/runtime-architecture","agent/runtime-architecture.mdx","en:agent/sdk-architecture.mdx","Agent SDK Architecture","Responsibilities and composition of Agent, Workspace, AgentWorkspace, Session, Plugin, and Shell","/en/docs/agent/sdk-architecture","agent/sdk-architecture.mdx","en:agent/sdk.mdx","Agent SDK","Embed the Downcity Agent runtime in a Node application","/en/docs/agent/sdk","agent/sdk.mdx","en:agent/overview.mdx","What the Agent SDK is and how it runs agent work","/en/docs/agent/overview","agent/overview.mdx","en:quickstart.mdx","Getting Started","Choose the right Downcity documentation space for the surface you want to use","/en/docs/quickstart","quickstart.mdx","en:index.mdx","index.mdx","meta.json"]