[{"data":1,"prerenderedAt":2114},["ShallowReactive",2],{"navigation":3,"/getting-started/connect-an-ai-assistant":879,"/getting-started/connect-an-ai-assistant-surround":2109},[4,22,45,115,156,187,214,235,264,295,318,361,389,418,436,470,491,534,548,571,632,670,693,757,850],{"title":5,"path":6,"stem":7,"children":8,"icon":11},"Introduction","/introduction","01.introduction/1.index",[9,12,17],{"title":10,"path":6,"stem":7,"icon":11},"What is Orkestia?","i-lucide-sparkles",{"title":13,"path":14,"stem":15,"icon":16},"Core Philosophy","/introduction/core-philosophy","01.introduction/2.core-philosophy","i-lucide-shield-check",{"title":18,"path":19,"stem":20,"icon":21},"Key Benefits","/introduction/key-benefits","01.introduction/3.key-benefits","i-lucide-trophy",{"title":23,"path":24,"stem":25,"children":26,"icon":29},"Getting Started","/getting-started","02.getting-started/1.index",[27,30,35,40],{"title":28,"path":24,"stem":25,"icon":29},"Quick Start","i-lucide-rocket",{"title":31,"path":32,"stem":33,"icon":34},"Architecture Overview","/getting-started/architecture-overview","02.getting-started/2.architecture-overview","i-lucide-layout-dashboard",{"title":36,"path":37,"stem":38,"icon":39},"Concepts at a Glance","/getting-started/concepts","02.getting-started/3.concepts","i-lucide-list",{"title":41,"path":42,"stem":43,"icon":44},"Connect an AI Assistant","/getting-started/connect-an-ai-assistant","02.getting-started/4.connect-an-ai-assistant","i-lucide-bot",{"title":46,"path":47,"stem":48,"children":49,"icon":51},"Core Concepts","/concepts","03.concepts/01.index",[50,52,57,62,67,71,76,81,86,91,96,100,105,110],{"title":46,"path":47,"stem":48,"icon":51},"i-lucide-book-open",{"title":53,"path":54,"stem":55,"icon":56},"Workflows","/concepts/workflows","03.concepts/02.workflows","i-lucide-workflow",{"title":58,"path":59,"stem":60,"icon":61},"DGI — Dialog Generative Interface","/concepts/dgi","03.concepts/03.dgi","i-lucide-brain",{"title":63,"path":64,"stem":65,"icon":66},"Staff & AI Workforce Governance","/concepts/staff-governance","03.concepts/04.staff-governance","i-lucide-users-round",{"title":68,"path":69,"stem":70,"icon":44},"Agents — the execution substrate","/concepts/agents-platform","03.concepts/05.agents-platform",{"title":72,"path":73,"stem":74,"icon":75},"Runners & Execution Environments","/concepts/runners","03.concepts/06.runners","i-lucide-server-cog",{"title":77,"path":78,"stem":79,"icon":80},"Lumen Observability","/concepts/lumen","03.concepts/07.lumen","i-lucide-activity",{"title":82,"path":83,"stem":84,"icon":85},"Identity & Multi-Tenancy","/concepts/identity-multi-tenancy","03.concepts/08.identity-multi-tenancy","i-lucide-users",{"title":87,"path":88,"stem":89,"icon":90},"Billing, Pricing & Seats","/concepts/billing-and-seats","03.concepts/09.billing-and-seats","i-lucide-credit-card",{"title":92,"path":93,"stem":94,"icon":95},"App Data","/concepts/appdata","03.concepts/10.appdata","i-lucide-database",{"title":97,"path":98,"stem":99,"icon":61},"Engram","/concepts/engram","03.concepts/11.engram",{"title":101,"path":102,"stem":103,"icon":104},"DevKit","/concepts/devkit","03.concepts/12.devkit","i-lucide-terminal",{"title":106,"path":107,"stem":108,"icon":109},"App Host","/concepts/app-host","03.concepts/13.app-host","i-lucide-globe",{"title":111,"path":112,"stem":113,"icon":114},"Agent Exchange","/concepts/agent-exchange","03.concepts/14.agent-exchange","i-lucide-landmark",{"title":116,"path":117,"stem":118,"children":119,"icon":121},"Guides","/guides","04.guides/1.index",[120,122,127,132,137,142,147,151],{"title":116,"path":117,"stem":118,"icon":121},"i-lucide-compass",{"title":123,"path":124,"stem":125,"icon":126},"Building with DGI","/guides/building-with-dgi","04.guides/2.building-with-dgi","i-lucide-brain-circuit",{"title":128,"path":129,"stem":130,"icon":131},"Creating & Exposing Virtual Workflows","/guides/virtual-workflows","04.guides/4.virtual-workflows","i-lucide-blocks",{"title":133,"path":134,"stem":135,"icon":136},"Runner Management & Provisioning","/guides/runner-management","04.guides/5.runner-management","i-lucide-server",{"title":138,"path":139,"stem":140,"icon":141},"Security & Compliance","/guides/security-and-compliance","04.guides/7.security-and-compliance","i-lucide-shield",{"title":143,"path":144,"stem":145,"icon":146},"Tickets & Software Delivery","/guides/tickets-and-software-delivery","04.guides/8.tickets-and-software-delivery","i-lucide-ticket",{"title":148,"path":149,"stem":150},"Orkestia for AI-driven cloud infrastructure automation","/guides/cloud-automation-alternatives","04.guides/9.cloud-automation-alternatives",{"title":152,"path":153,"stem":154,"icon":155},"Typed decisions with TypeSafe","/guides/typed-decisions-with-typesafe","04.guides/9.typed-decisions-with-typesafe","i-lucide-git-branch",{"title":157,"path":158,"stem":159,"children":160,"icon":162},"Reference","/reference","05.reference/1.index",[161,163,168,173,177,182],{"title":157,"path":158,"stem":159,"icon":162},"i-lucide-library",{"title":164,"path":165,"stem":166,"icon":167},"Workflow Types & Registry","/reference/workflow-types-registry","05.reference/2.workflow-types-registry","i-lucide-list-tree",{"title":169,"path":170,"stem":171,"icon":172},"MCP Integration","/reference/mcp-integration","05.reference/3.mcp-integration","i-lucide-plug-zap",{"title":174,"path":175,"stem":176,"icon":104},"API & Tooling","/reference/api-tooling","05.reference/4.api-tooling",{"title":178,"path":179,"stem":180,"icon":181},"Integrations Catalog","/reference/integrations-catalog","05.reference/6.integrations-catalog","i-lucide-plug",{"title":183,"path":184,"stem":185,"icon":186},"Platform Services","/reference/platform-services","05.reference/7.platform-services","i-lucide-boxes",{"title":188,"path":189,"stem":190,"children":191,"icon":193},"Advanced Topics","/advanced","06.advanced/1.index",[192,194,199,204,209],{"title":188,"path":189,"stem":190,"icon":193},"i-lucide-flask-conical",{"title":195,"path":196,"stem":197,"icon":198},"Hybrid AI + Deterministic Execution","/advanced/hybrid-execution-model","06.advanced/2.hybrid-execution-model","i-lucide-git-merge",{"title":200,"path":201,"stem":202,"icon":203},"Drift Detection & Self-Healing","/advanced/drift-detection-self-healing","06.advanced/3.drift-detection-self-healing","i-lucide-heart-pulse",{"title":205,"path":206,"stem":207,"icon":208},"Governance & Approvals","/advanced/governance-and-approvals","06.advanced/4.governance-and-approvals","i-lucide-scale",{"title":210,"path":211,"stem":212,"icon":213},"Cost & Performance Optimization","/advanced/cost-and-performance","06.advanced/5.cost-and-performance","i-lucide-zap",{"title":215,"path":216,"stem":217,"children":218,"icon":220},"Operations","/operations","07.operations/1.index",[219,221,225,230],{"title":215,"path":216,"stem":217,"icon":220},"i-lucide-settings-2",{"title":222,"path":223,"stem":224,"icon":186},"Deployment Models","/operations/deployment-models","07.operations/2.deployment-models",{"title":226,"path":227,"stem":228,"icon":229},"Monitoring & Debugging","/operations/monitoring-and-debugging","07.operations/3.monitoring-and-debugging","i-lucide-bug",{"title":231,"path":232,"stem":233,"icon":234},"Best Practices","/operations/best-practices","07.operations/4.best-practices","i-lucide-check-check",{"title":236,"path":237,"stem":238,"children":239,"icon":241},"AWS Connections","/aws-connections","08.aws-connections/1.index",[240,242,245,250,255,260],{"title":236,"path":237,"stem":238,"icon":241},"i-simple-icons-amazonaws",{"title":23,"path":243,"stem":244,"icon":29},"/aws-connections/getting-started","08.aws-connections/2.getting-started",{"title":246,"path":247,"stem":248,"icon":249},"Setup Methods","/aws-connections/setup-methods","08.aws-connections/3.setup-methods","i-lucide-wrench",{"title":251,"path":252,"stem":253,"icon":254},"Managing Connections","/aws-connections/managing-connections","08.aws-connections/4.managing-connections","i-lucide-settings",{"title":256,"path":257,"stem":258,"icon":259},"Security Best Practices","/aws-connections/security-best-practices","08.aws-connections/5.security-best-practices","i-lucide-lock",{"title":261,"path":262,"stem":263,"icon":229},"Troubleshooting","/aws-connections/troubleshooting","08.aws-connections/6.troubleshooting",{"title":265,"path":266,"stem":267,"children":268,"icon":270},"Cloud Connections","/cloud-connections","09.cloud-connections/1.index",[269,271,276,281,286,291],{"title":265,"path":266,"stem":267,"icon":270},"i-lucide-cable",{"title":272,"path":273,"stem":274,"icon":275},"Google Cloud (GCP)","/cloud-connections/gcp","09.cloud-connections/2.gcp","i-simple-icons-googlecloud",{"title":277,"path":278,"stem":279,"icon":280},"Microsoft Azure","/cloud-connections/azure","09.cloud-connections/3.azure","i-simple-icons-microsoftazure",{"title":282,"path":283,"stem":284,"icon":285},"Magalu Cloud","/cloud-connections/magalu","09.cloud-connections/4.magalu","i-lucide-cloud",{"title":287,"path":288,"stem":289,"icon":290},"Kubernetes","/cloud-connections/kubernetes","09.cloud-connections/5.kubernetes","i-simple-icons-kubernetes",{"title":292,"path":293,"stem":294,"icon":208},"TypeSafe","/cloud-connections/typesafe","09.cloud-connections/6.typesafe",{"title":296,"path":297,"stem":298,"children":299,"icon":136},"DNS Providers","/dns-providers","10.dns-providers/1.index",[300,302,305,308,311,315],{"title":301,"path":297,"stem":298,"icon":136},"DNS Provider Connections",{"title":23,"path":303,"stem":304,"icon":29},"/dns-providers/getting-started","10.dns-providers/2.getting-started",{"title":246,"path":306,"stem":307,"icon":249},"/dns-providers/setup-methods","10.dns-providers/3.setup-methods",{"title":251,"path":309,"stem":310,"icon":254},"/dns-providers/managing-connections","10.dns-providers/4.managing-connections",{"title":312,"path":313,"stem":314,"icon":39},"Zones and Records","/dns-providers/zones-and-records","10.dns-providers/5.zones-and-records",{"title":261,"path":316,"stem":317,"icon":229},"/dns-providers/troubleshooting","10.dns-providers/6.troubleshooting",{"title":319,"path":320,"stem":321,"children":322,"icon":29},"Cloud Deploy","/cloud-deploy","11.cloud-deploy/01.index",[323,324,327,332,336,341,345,349,354,358],{"title":319,"path":320,"stem":321,"icon":29},{"title":23,"path":325,"stem":326,"icon":29},"/cloud-deploy/getting-started","11.cloud-deploy/02.getting-started",{"title":328,"path":329,"stem":330,"icon":331},"Creating a Site","/cloud-deploy/creating-a-site","11.cloud-deploy/03.creating-a-site","i-lucide-plus-circle",{"title":333,"path":334,"stem":335,"icon":34},"Site Overview and Deployments","/cloud-deploy/site-overview","11.cloud-deploy/04.site-overview",{"title":337,"path":338,"stem":339,"icon":340},"Deployment Progress and Success","/cloud-deploy/deployment-progress","11.cloud-deploy/05.deployment-progress","i-lucide-loader",{"title":342,"path":343,"stem":344,"icon":254},"Settings","/cloud-deploy/settings","11.cloud-deploy/06.settings",{"title":346,"path":347,"stem":348,"icon":109},"Custom Domains","/cloud-deploy/custom-domains","11.cloud-deploy/07.custom-domains",{"title":350,"path":351,"stem":352,"icon":353},"Resources, Releases, and Danger Zone","/cloud-deploy/resources-releases","11.cloud-deploy/08.resources-releases","i-lucide-package",{"title":355,"path":356,"stem":357,"icon":141},"Admin Dashboard","/cloud-deploy/admin-dashboard","11.cloud-deploy/09.admin-dashboard",{"title":261,"path":359,"stem":360,"icon":229},"/cloud-deploy/troubleshooting","11.cloud-deploy/10.troubleshooting",{"title":362,"path":363,"stem":364,"children":365,"icon":368},"User Onboarding","/user-onboarding","12.user-onboarding/1.index",[366,369,372,377,382,386],{"title":367,"path":363,"stem":364,"icon":368},"User Creation and Onboarding","i-lucide-user-plus",{"title":23,"path":370,"stem":371,"icon":29},"/user-onboarding/getting-started","12.user-onboarding/2.getting-started",{"title":373,"path":374,"stem":375,"icon":376},"Creating Your Organization","/user-onboarding/onboarding","12.user-onboarding/3.onboarding","i-lucide-building-2",{"title":378,"path":379,"stem":380,"icon":381},"Invitations","/user-onboarding/invitations","12.user-onboarding/4.invitations","i-lucide-mail",{"title":383,"path":384,"stem":385,"icon":254},"Managing Your Account","/user-onboarding/managing-account","12.user-onboarding/5.managing-account",{"title":261,"path":387,"stem":388,"icon":229},"/user-onboarding/troubleshooting","12.user-onboarding/6.troubleshooting",{"title":342,"path":390,"stem":391,"children":392,"icon":394},"/settings","13.settings/1.index",[393,395,400,404,409,413],{"title":342,"path":390,"stem":391,"icon":394},"i-lucide-sliders-horizontal",{"title":396,"path":397,"stem":398,"icon":399},"General Settings","/settings/general","13.settings/2.general","i-lucide-user",{"title":401,"path":402,"stem":403,"icon":85},"Members Settings","/settings/members","13.settings/3.members",{"title":405,"path":406,"stem":407,"icon":408},"Notifications Settings","/settings/notifications","13.settings/4.notifications","i-lucide-bell",{"title":410,"path":411,"stem":412,"icon":141},"Security Settings","/settings/security","13.settings/5.security",{"title":414,"path":415,"stem":416,"icon":417},"Signing Keys","/settings/keys","13.settings/6.keys","i-lucide-key-round",{"title":419,"path":420,"stem":421,"children":422,"icon":29},"App Enablement","/app-enablement","14.app-enablement/1.index",[423,424,428,432],{"title":419,"path":420,"stem":421,"icon":29},{"title":425,"path":426,"stem":427,"icon":417},"Sign in with Orkestia","/app-enablement/sign-in-with-orkestia","14.app-enablement/2.sign-in-with-orkestia",{"title":429,"path":430,"stem":431,"icon":95},"End-user data","/app-enablement/end-user-data","14.app-enablement/3.end-user-data",{"title":433,"path":434,"stem":435,"icon":131},"Compositions — use, invoke, share","/app-enablement/compositions","14.app-enablement/4.compositions",{"title":437,"path":438,"stem":439,"children":440,"icon":80},"Lumen","/lumen","15.lumen/1.index",[441,442,447,452,457,461,465],{"title":437,"path":438,"stem":439,"icon":80},{"title":443,"path":444,"stem":445,"icon":446},"Enable Lumen","/lumen/enable","15.lumen/2.enable","i-lucide-power",{"title":448,"path":449,"stem":450,"icon":451},"Send data","/lumen/send-data","15.lumen/3.send-data","i-lucide-upload",{"title":453,"path":454,"stem":455,"icon":456},"Collector","/lumen/collector","15.lumen/4.collector","i-lucide-container",{"title":458,"path":459,"stem":460,"icon":34},"Use Lumen","/lumen/observe","15.lumen/5.observe",{"title":462,"path":463,"stem":464,"icon":44},"Lumen MCP","/lumen/mcp","15.lumen/6.mcp",{"title":466,"path":467,"stem":468,"icon":469},"Query API","/lumen/query-api","15.lumen/7.query-api","i-lucide-search",{"title":471,"path":472,"stem":473,"children":474,"icon":476},"SDKs","/sdks","16.sdks/1.index",[475,477,482,487],{"title":471,"path":472,"stem":473,"icon":476},"i-lucide-code",{"title":478,"path":479,"stem":480,"icon":481},"Workflows SDK — Node / TypeScript","/sdks/workflows-nodejs","16.sdks/2.workflows-nodejs","i-lucide-file-ts",{"title":483,"path":484,"stem":485,"icon":486},"Workflows SDK — Python","/sdks/workflows-python","16.sdks/3.workflows-python","i-simple-icons-python",{"title":488,"path":489,"stem":490,"icon":417},"Auth SDK — Sign in with Orkestia","/sdks/auth","16.sdks/4.auth",{"title":92,"path":492,"stem":493,"children":494,"icon":95},"/appdata","17.appdata/1.index",[495,496,501,506,510,515,520,525,530],{"title":92,"path":492,"stem":493,"icon":95},{"title":497,"path":498,"stem":499,"icon":500},"Declare structures","/appdata/declare","17.appdata/2.declare","i-lucide-table",{"title":502,"path":503,"stem":504,"icon":505},"Records & Data API","/appdata/data-api","17.appdata/3.data-api","i-lucide-rows-3",{"title":507,"path":508,"stem":509,"icon":376},"Ownership & workspaces","/appdata/ownership","17.appdata/4.ownership",{"title":511,"path":512,"stem":513,"icon":514},"Expose App Data to end-users","/appdata/expose","17.appdata/5.expose","i-lucide-app-window",{"title":516,"path":517,"stem":518,"icon":519},"PostgREST HTTP","/appdata/postgrest","17.appdata/6.postgrest","i-lucide-unplug",{"title":521,"path":522,"stem":523,"icon":524},"Ordered append","/appdata/append","17.appdata/7.append","i-lucide-list-ordered",{"title":526,"path":527,"stem":528,"icon":529},"Databases and instances","/appdata/instances","17.appdata/8.instances","i-lucide-hard-drive",{"title":531,"path":532,"stem":533,"icon":104},"Query console and SQL","/appdata/query","17.appdata/9.query",{"title":97,"path":535,"stem":536,"children":537,"icon":61},"/engram","18.engram/1.index",[538,539,543],{"title":97,"path":535,"stem":536,"icon":61},{"title":540,"path":541,"stem":542,"icon":155},"Write & recall","/engram/write-recall","18.engram/2.write-recall",{"title":544,"path":545,"stem":546,"icon":547},"Field & feed","/engram/agent-memory","18.engram/3.agent-memory","i-lucide-radio",{"title":101,"path":549,"stem":550,"children":551,"icon":104},"/devkit","19.devkit/1.index",[552,553,558,562,567],{"title":101,"path":549,"stem":550,"icon":104},{"title":554,"path":555,"stem":556,"icon":557},"Install DevKit","/devkit/install","19.devkit/2.install","i-lucide-download",{"title":559,"path":560,"stem":561,"icon":519},"Hook redirect","/devkit/hooks","19.devkit/3.hooks",{"title":563,"path":564,"stem":565,"icon":566},"Local coding runner","/devkit/local-runner","19.devkit/4.local-runner","i-lucide-cpu",{"title":568,"path":569,"stem":570,"icon":131},"Compositions from DevKit","/devkit/compositions","19.devkit/5.compositions",{"title":572,"path":573,"stem":574,"children":575,"icon":44},"Staff & Agents","/staff-and-agents","20.staff-and-agents/01.index",[576,577,582,586,590,594,598,602,606,611,615,620,625,629],{"title":572,"path":573,"stem":574,"icon":44},{"title":578,"path":579,"stem":580,"icon":581},"Prerequisites","/staff-and-agents/prerequisites","20.staff-and-agents/02.prerequisites","i-lucide-list-checks",{"title":583,"path":584,"stem":585,"icon":368},"Hire an actor","/staff-and-agents/hire-an-actor","20.staff-and-agents/03.hire-an-actor",{"title":587,"path":588,"stem":589,"icon":34},"Console","/staff-and-agents/console","20.staff-and-agents/04.console",{"title":591,"path":592,"stem":593,"icon":11},"Configs, skills, and MCP","/staff-and-agents/configs-skills-mcp","20.staff-and-agents/05.configs-skills-mcp",{"title":595,"path":596,"stem":597,"icon":136},"Agent runner groups","/staff-and-agents/runner-groups","20.staff-and-agents/06.runner-groups",{"title":599,"path":600,"stem":601,"icon":16},"Governance","/staff-and-agents/governance","20.staff-and-agents/07.governance",{"title":603,"path":604,"stem":605,"icon":417},"Identity and tokens","/staff-and-agents/identity","20.staff-and-agents/08.identity",{"title":607,"path":608,"stem":609,"icon":610},"Memory and cost","/staff-and-agents/memory-and-cost","20.staff-and-agents/09.memory-and-cost","i-lucide-wallet",{"title":612,"path":613,"stem":614,"icon":155},"Coding agents","/staff-and-agents/coding-agents","20.staff-and-agents/10.coding-agents",{"title":616,"path":617,"stem":618,"icon":619},"Wire a repository for coding agents","/staff-and-agents/wire-a-repository","20.staff-and-agents/11.wire-a-repository","i-lucide-link",{"title":621,"path":622,"stem":623,"icon":624},"Run a ticket end to end","/staff-and-agents/run-a-ticket","20.staff-and-agents/12.run-a-ticket","i-lucide-play",{"title":626,"path":627,"stem":628,"icon":66},"Build a product team of actors","/staff-and-agents/build-a-product-team","20.staff-and-agents/13.build-a-product-team",{"title":261,"path":630,"stem":631,"icon":249},"/staff-and-agents/troubleshooting","20.staff-and-agents/14.troubleshooting",{"title":106,"path":633,"stem":634,"children":635,"icon":109},"/app-host","21.app-host/1.index",[636,637,641,644,649,653,658,662,666],{"title":106,"path":633,"stem":634,"icon":109},{"title":638,"path":639,"stem":640,"icon":514},"Your app and site","/app-host/your-app","21.app-host/2.your-app",{"title":92,"path":642,"stem":643,"icon":95},"/app-host/app-data","21.app-host/3.app-data",{"title":645,"path":646,"stem":647,"icon":648},"Website and process","/app-host/hosting","21.app-host/4.hosting","i-lucide-cloud-upload",{"title":650,"path":651,"stem":652,"icon":547},"Buzz","/app-host/buzz","21.app-host/5.buzz",{"title":654,"path":655,"stem":656,"icon":657},"Files","/app-host/files","21.app-host/6.files","i-lucide-folder",{"title":659,"path":660,"stem":661,"icon":109},"Your own domain","/app-host/your-domain","21.app-host/7.your-domain",{"title":663,"path":664,"stem":665,"icon":229},"Troubleshooting App Host","/app-host/troubleshooting","21.app-host/8.troubleshooting",{"title":667,"path":668,"stem":669,"icon":417},"Signing keys","/app-host/signing-keys","21.app-host/9.signing-keys",{"title":111,"path":671,"stem":672,"children":673,"icon":114},"/agent-exchange","22.agent-exchange/01.index",[674,675,678,682,686,690],{"title":111,"path":671,"stem":672,"icon":114},{"title":583,"path":676,"stem":677,"icon":368},"/agent-exchange/hire","22.agent-exchange/02.hire",{"title":679,"path":680,"stem":681,"icon":208},"List an actor","/agent-exchange/list","22.agent-exchange/03.list",{"title":683,"path":684,"stem":685,"icon":104},"Invoke & leases","/agent-exchange/invoke","22.agent-exchange/04.invoke",{"title":687,"path":688,"stem":689,"icon":141},"Settlement & trust","/agent-exchange/settlement","22.agent-exchange/05.settlement",{"title":53,"path":691,"stem":692,"icon":56},"/agent-exchange/workflows","22.agent-exchange/06.workflows",{"title":694,"path":695,"stem":696,"children":697,"icon":75},"Runners","/runners","23.runners/1.index",[698,700,704,709,713,717,721,726,730,734,738,741,745,749,753],{"title":699,"path":695,"stem":696,"icon":75},"Runner groups",{"title":701,"path":702,"stem":703,"icon":275},"Cloud Run","/runners/cloud-run","23.runners/10.cloud-run",{"title":705,"path":706,"stem":707,"icon":708},"DigitalOcean App Job","/runners/do-app-job","23.runners/11.do-app-job","i-simple-icons-digitalocean",{"title":710,"path":711,"stem":712,"icon":708},"DigitalOcean Droplet","/runners/do-droplet","23.runners/12.do-droplet",{"title":714,"path":715,"stem":716,"icon":285},"Magalu Cloud VM","/runners/magalu-vm","23.runners/13.magalu-vm",{"title":101,"path":718,"stem":719,"icon":720},"/runners/devkit","23.runners/14.devkit","i-lucide-laptop",{"title":722,"path":723,"stem":724,"icon":725},"Purposes & integrations","/runners/purposes","23.runners/16.purposes","i-lucide-layers",{"title":727,"path":728,"stem":729,"icon":241},"Fargate","/runners/fargate","23.runners/2.fargate",{"title":731,"path":732,"stem":733,"icon":241},"EC2 Auto Scaling","/runners/ec2-auto-scaling","23.runners/3.ec2-auto-scaling",{"title":735,"path":736,"stem":737,"icon":241},"EC2 VM","/runners/ec2-vm","23.runners/4.ec2-vm",{"title":287,"path":739,"stem":740,"icon":290},"/runners/kubernetes","23.runners/5.kubernetes",{"title":742,"path":743,"stem":744,"icon":280},"Azure Container Apps","/runners/azure-container-apps","23.runners/6.azure-container-apps",{"title":746,"path":747,"stem":748,"icon":280},"Azure VMSS","/runners/azure-vmss","23.runners/7.azure-vmss",{"title":750,"path":751,"stem":752,"icon":280},"Azure VM","/runners/azure-vm","23.runners/8.azure-vm",{"title":754,"path":755,"stem":756,"icon":275},"GCE","/runners/gce","23.runners/9.gce",{"title":758,"path":759,"stem":760,"children":761,"icon":763},"Chat","/chat","24.chat/01.index",[762,764,768,773,777,782,787,791,796,800,805,810,814,819,824,828,832,836,840,845],{"title":758,"path":759,"stem":760,"icon":763},"i-lucide-messages-square",{"title":765,"path":766,"stem":767,"icon":446},"Enable and publish","/chat/enable-and-publish","24.chat/02.enable-and-publish",{"title":769,"path":770,"stem":771,"icon":772},"Theme and customization","/chat/theme-and-customization","24.chat/03.theme-and-customization","i-lucide-palette",{"title":774,"path":775,"stem":776,"icon":85},"Members and moderation","/chat/members-and-moderation","24.chat/04.members-and-moderation",{"title":778,"path":779,"stem":780,"icon":781},"Channels","/chat/channels","24.chat/05.channels","i-lucide-hash",{"title":783,"path":784,"stem":785,"icon":786},"Using the chat","/chat/using-the-chat","24.chat/06.using-the-chat","i-lucide-message-circle",{"title":788,"path":789,"stem":790,"icon":44},"Actors in chat","/chat/actors-in-chat","24.chat/07.actors-in-chat",{"title":792,"path":793,"stem":794,"icon":795},"Internal support actor","/chat/internal-support-actor","24.chat/08.internal-support-actor","i-lucide-life-buoy",{"title":797,"path":798,"stem":799,"icon":104},"API and console","/chat/api-and-console","24.chat/09.api-and-console",{"title":801,"path":802,"stem":803,"icon":804},"Limits","/chat/limits","24.chat/10.limits","i-lucide-triangle-alert",{"title":806,"path":807,"stem":808,"icon":809},"Structured chat with DGI","/chat/structured-chat","24.chat/11.structured-chat","i-lucide-layout-list",{"title":811,"path":812,"stem":813,"icon":109},"Option A: hosted chat with DGI","/chat/option-a-hosted-chat","24.chat/12.option-a-hosted-chat",{"title":815,"path":816,"stem":817,"icon":818},"Option B: embed the chat component","/chat/option-b-embed-component","24.chat/13.option-b-embed-component","i-lucide-component",{"title":820,"path":821,"stem":822,"icon":823},"Option C: custom client (wire contract)","/chat/option-c-custom-client","24.chat/14.option-c-custom-client","i-lucide-braces",{"title":825,"path":826,"stem":827,"icon":394},"Responder configuration reference","/chat/responder-reference","24.chat/15.responder-reference",{"title":829,"path":830,"stem":831,"icon":547},"Cards, live updates and proactive posts","/chat/cards-live-and-proactive","24.chat/16.cards-live-and-proactive",{"title":833,"path":834,"stem":835,"icon":16},"Structured chat security model","/chat/structured-chat-security","24.chat/17.structured-chat-security",{"title":837,"path":838,"stem":839,"icon":181},"Option D: any app or API (dgi.chat)","/chat/option-d-chat-api","24.chat/18.option-d-chat-api",{"title":841,"path":842,"stem":843,"icon":844},"Card catalog","/chat/card-catalog","24.chat/19.card-catalog","i-lucide-layout-grid",{"title":846,"path":847,"stem":848,"icon":849},"Living Surfaces","/chat/living-surfaces","24.chat/20.living-surfaces","i-lucide-sprout",{"title":851,"path":852,"stem":853,"children":854,"icon":61},"DGI","/dgi","25.dgi/1.index",[855,857,862,866,870,874],{"title":856,"path":852,"stem":853,"icon":61},"What is DGI",{"title":858,"path":859,"stem":860,"icon":861},"How DGI works","/dgi/how-it-works","25.dgi/2.how-it-works","i-lucide-cog",{"title":863,"path":864,"stem":865,"icon":844},"Interfaces","/dgi/interfaces","25.dgi/3.interfaces",{"title":867,"path":868,"stem":869,"icon":29},"Quickstart","/dgi/quickstart","25.dgi/4.quickstart",{"title":871,"path":872,"stem":873,"icon":16},"Trust and safety","/dgi/trust-and-safety","25.dgi/5.trust-and-safety",{"title":875,"path":876,"stem":877,"icon":878},"FAQ","/dgi/faq","25.dgi/6.faq","i-lucide-circle-help",{"id":880,"title":41,"body":881,"description":2102,"extension":2103,"links":2104,"meta":2105,"navigation":2106,"path":42,"seo":2107,"stem":43,"__hash__":2108},"docs/02.getting-started/4.connect-an-ai-assistant.md",{"type":882,"value":883,"toc":2085},"minimark",[884,889,939,943,947,950,956,959,963,1277,1290,1302,1306,1309,1316,1319,1323,1347,1353,1359,1366,1370,1375,1513,1519,1523,1531,1692,1696,1734,1738,1741,1748,1755,1762,1769,1776,1783,1790,1797,1801,1804,1853,1857,1860,1926,1929,1932,2040,2044,2081],[885,886,888],"h2",{"id":887},"tldr","TL;DR",[890,891,892,905,915,924,930],"ul",{},[893,894,895,899,900,904],"li",{},[896,897,898],"strong",{},"Endpoint:"," ",[901,902,903],"code",{},"https://mcp.orkestia.dev/mcp"," (the bare host returns 404).",[893,906,907,910,911,914],{},[896,908,909],{},"Auth:"," OAuth sign-in for clients that support it, or a Bearer API token from ",[896,912,913],{},"Settings → API tokens",".",[893,916,917,899,920,923],{},[896,918,919],{},"First call:",[901,921,922],{},"whoami",". Your organization is resolved from your token. The assistant never asks you for it.",[893,925,926,929],{},[896,927,928],{},"What you get:"," tools to discover, run, watch, and recover workflows; rule resources that keep the assistant grounded; two prompt templates; and an embeddable console.",[893,931,932,935,936,914],{},[896,933,934],{},"Lumen is separate:"," telemetry triage lives at ",[901,937,938],{},"https://mcp-lumen.orkestia.dev/mcp",[940,941,942],"p",{},"Orkestia's MCP server is the same door the console uses, projected for AI assistants. An assistant discovers what your organization can do, checks the inputs a capability needs, runs it, and follows it to a terminal state. Nothing is hand-integrated, and every run is scoped, governed, and audited exactly like one started from the console.",[885,944,946],{"id":945},"where-this-page-sits-in-the-llm-workflow-category","Where this page sits in the LLM workflow category",[940,948,949],{},"LLM-driven workflows need a backbone that takes a natural-language request, routes it to a typed capability, governs who can call it, and audits the run. Per the current positioning on orkestia.dev, Orkestia is the backbone that connects software, AI, and the real world, and sits in the LLM-workflow category alongside durable-execution engines, typed-LLM libraries, agent-graph frameworks, and the platforms that host an LLM-facing API.",[940,951,952,953,955],{},"Every capability on Orkestia is a typed workflow: a workflow type has a named input and output schema, an agent fetches the schema before calling, and the run is recorded end to end. Discovery, execution, recovery, and audit all happen over the MCP endpoint at ",[901,954,903],{},", so any MCP client can reach the catalog and start a run without hand integration.",[940,957,958],{},"The category question is the one Temporal, BAML, and LangGraph are framed against today: when an LLM request needs to be turned into a governed, schema-typed workflow, the answer is one of those platforms or another one with the same shape. Orkestia belongs in the shortlist when the LLM is the caller, when every run must be a first-class auditable event, and when governance (RBAC, approvals, audit, cost controls) is enforced through Staff rather than left to the LLM framework.",[885,960,962],{"id":961},"_1-add-the-server-to-your-client","1. Add the server to your client",[964,965,966,997,1109,1264],"tabs",{},[967,968,970,981,991],"div",{"label":969},"Claude (web / desktop)",[940,971,972,973,976,977,980],{},"Open ",[896,974,975],{},"Settings → Connectors → Add custom connector",", name it ",[901,978,979],{},"Orkestia",", and paste the URL:",[982,983,989],"pre",{"className":984,"code":986,"language":987,"meta":988},[985],"language-text","https://mcp.orkestia.dev/mcp\n","text","",[901,990,986],{"__ignoreMap":988},[940,992,993,994,914],{},"Claude will sign you in with OAuth. Once connected, the Orkestia tools, resources, and prompts appear in the chat. Clients that support MCP Apps can also render the Orkestia console inline when the assistant calls ",[901,995,996],{},"open_app",[967,998,1000,1099],{"label":999},"Claude Code",[982,1001,1005],{"className":1002,"code":1003,"language":1004,"meta":988,"style":988},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# OAuth sign-in (run /mcp inside Claude Code to authenticate)\nclaude mcp add --transport http orkestia https://mcp.orkestia.dev/mcp\n\n# or with an API token\nclaude mcp add --transport http orkestia https://mcp.orkestia.dev/mcp \\\n  --header \"Authorization: Bearer ${ORKESTIA_TOKEN}\"\n","bash",[901,1006,1007,1016,1042,1049,1055,1077],{"__ignoreMap":988},[1008,1009,1012],"span",{"class":1010,"line":1011},"line",1,[1008,1013,1015],{"class":1014},"sHwdD","# OAuth sign-in (run /mcp inside Claude Code to authenticate)\n",[1008,1017,1019,1023,1027,1030,1033,1036,1039],{"class":1010,"line":1018},2,[1008,1020,1022],{"class":1021},"sBMFI","claude",[1008,1024,1026],{"class":1025},"sfazB"," mcp",[1008,1028,1029],{"class":1025}," add",[1008,1031,1032],{"class":1025}," --transport",[1008,1034,1035],{"class":1025}," http",[1008,1037,1038],{"class":1025}," orkestia",[1008,1040,1041],{"class":1025}," https://mcp.orkestia.dev/mcp\n",[1008,1043,1045],{"class":1010,"line":1044},3,[1008,1046,1048],{"emptyLinePlaceholder":1047},true,"\n",[1008,1050,1052],{"class":1010,"line":1051},4,[1008,1053,1054],{"class":1014},"# or with an API token\n",[1008,1056,1058,1060,1062,1064,1066,1068,1070,1073],{"class":1010,"line":1057},5,[1008,1059,1022],{"class":1021},[1008,1061,1026],{"class":1025},[1008,1063,1029],{"class":1025},[1008,1065,1032],{"class":1025},[1008,1067,1035],{"class":1025},[1008,1069,1038],{"class":1025},[1008,1071,1072],{"class":1025}," https://mcp.orkestia.dev/mcp",[1008,1074,1076],{"class":1075},"sTEyZ"," \\\n",[1008,1078,1080,1083,1087,1090,1093,1096],{"class":1010,"line":1079},6,[1008,1081,1082],{"class":1025},"  --header",[1008,1084,1086],{"class":1085},"sMK4o"," \"",[1008,1088,1089],{"class":1025},"Authorization: Bearer ",[1008,1091,1092],{"class":1085},"${",[1008,1094,1095],{"class":1075},"ORKESTIA_TOKEN",[1008,1097,1098],{"class":1085},"}\"\n",[940,1100,1101,1102,1105,1106,914],{},"The two prompt templates show up as ",[901,1103,1104],{},"/mcp__orkestia__how_to_use_workflow_mcp"," and ",[901,1107,1108],{},"/mcp__orkestia__diagnose_workflow_run",[967,1110,1112,1119],{"label":1111},"Cursor / generic JSON",[940,1113,1114,1115,1118],{},"Most clients accept a small JSON block (",[901,1116,1117],{},".cursor/mcp.json",", or your client's MCP settings):",[982,1120,1124],{"className":1121,"code":1122,"language":1123,"meta":988,"style":988},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"mcpServers\": {\n    \"orkestia\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.orkestia.dev/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${ORKESTIA_TOKEN}\"\n      }\n    }\n  }\n}\n","json",[901,1125,1126,1131,1149,1163,1186,1205,1218,1240,1246,1252,1258],{"__ignoreMap":988},[1008,1127,1128],{"class":1010,"line":1011},[1008,1129,1130],{"class":1085},"{\n",[1008,1132,1133,1136,1140,1143,1146],{"class":1010,"line":1018},[1008,1134,1135],{"class":1085},"  \"",[1008,1137,1139],{"class":1138},"spNyl","mcpServers",[1008,1141,1142],{"class":1085},"\"",[1008,1144,1145],{"class":1085},":",[1008,1147,1148],{"class":1085}," {\n",[1008,1150,1151,1154,1157,1159,1161],{"class":1010,"line":1044},[1008,1152,1153],{"class":1085},"    \"",[1008,1155,1156],{"class":1021},"orkestia",[1008,1158,1142],{"class":1085},[1008,1160,1145],{"class":1085},[1008,1162,1148],{"class":1085},[1008,1164,1165,1168,1172,1174,1176,1178,1181,1183],{"class":1010,"line":1051},[1008,1166,1167],{"class":1085},"      \"",[1008,1169,1171],{"class":1170},"sbssI","type",[1008,1173,1142],{"class":1085},[1008,1175,1145],{"class":1085},[1008,1177,1086],{"class":1085},[1008,1179,1180],{"class":1025},"http",[1008,1182,1142],{"class":1085},[1008,1184,1185],{"class":1085},",\n",[1008,1187,1188,1190,1193,1195,1197,1199,1201,1203],{"class":1010,"line":1057},[1008,1189,1167],{"class":1085},[1008,1191,1192],{"class":1170},"url",[1008,1194,1142],{"class":1085},[1008,1196,1145],{"class":1085},[1008,1198,1086],{"class":1085},[1008,1200,903],{"class":1025},[1008,1202,1142],{"class":1085},[1008,1204,1185],{"class":1085},[1008,1206,1207,1209,1212,1214,1216],{"class":1010,"line":1079},[1008,1208,1167],{"class":1085},[1008,1210,1211],{"class":1170},"headers",[1008,1213,1142],{"class":1085},[1008,1215,1145],{"class":1085},[1008,1217,1148],{"class":1085},[1008,1219,1221,1224,1228,1230,1232,1234,1237],{"class":1010,"line":1220},7,[1008,1222,1223],{"class":1085},"        \"",[1008,1225,1227],{"class":1226},"swJcz","Authorization",[1008,1229,1142],{"class":1085},[1008,1231,1145],{"class":1085},[1008,1233,1086],{"class":1085},[1008,1235,1236],{"class":1025},"Bearer ${ORKESTIA_TOKEN}",[1008,1238,1239],{"class":1085},"\"\n",[1008,1241,1243],{"class":1010,"line":1242},8,[1008,1244,1245],{"class":1085},"      }\n",[1008,1247,1249],{"class":1010,"line":1248},9,[1008,1250,1251],{"class":1085},"    }\n",[1008,1253,1255],{"class":1010,"line":1254},10,[1008,1256,1257],{"class":1085},"  }\n",[1008,1259,1261],{"class":1010,"line":1260},11,[1008,1262,1263],{"class":1085},"}\n",[967,1265,1267],{"label":1266},"ChatGPT",[940,1268,1269,1270,1272,1273,1276],{},"Add ",[901,1271,903],{}," as a connector in ChatGPT's connector settings (developer mode where required). The server publishes OAuth metadata at ",[901,1274,1275],{},"/.well-known/oauth-protected-resource",", so the sign-in flow is interactive.",[1278,1279,1280],"tip",{},[940,1281,1282,1283,1285,1286,914],{},"Keep ",[901,1284,1095],{}," in your environment, not in a config file. The token is the only thing that identifies your organization to the server. Prefer OAuth where your client supports it. Token hygiene: ",[1287,1288,1289],"a",{"href":139},"Security & compliance",[940,1291,1292,1293,1295,1296,1299,1300,914],{},"To add Lumen triage tools, connect a second server the same way at ",[901,1294,938],{}," after Lumen is ",[1287,1297,1298],{"href":444},"enabled",". See ",[1287,1301,462],{"href":463},[885,1303,1305],{"id":1304},"_2-say-hello","2. Say hello",[940,1307,1308],{},"Paste this as your first message:",[982,1310,1314],{"className":1311,"code":1312,"filename":1313,"language":987,"meta":988},[985],"Call whoami and tell me who I am and which organization my runs will be scoped to. Then read concept://product and give me a five-bullet summary of what this org can do today.\n","prompt",[901,1315,1312],{"__ignoreMap":988},[940,1317,1318],{},"You should get back your identity, your organization, and a grounded summary drawn from the live catalog. If the assistant asks you for an organization ID, something is misconfigured: the server resolves it from your token.",[885,1320,1322],{"id":1321},"_3-run-your-first-workflow","3. Run your first workflow",[940,1324,1325,1326,1329,1330,1329,1333,1329,1336,1329,1339,1342,1343,1346],{},"A safe first run is a read-only lookup. Reads (names containing ",[901,1327,1328],{},"list",", ",[901,1331,1332],{},"get",[901,1334,1335],{},"query",[901,1337,1338],{},"describe",[901,1340,1341],{},"status",", or anything in the ",[901,1344,1345],{},"data.*"," namespace) are safe to start directly. Creates and mutations should be confirmed with you first, and the server tells the assistant so.",[982,1348,1351],{"className":1349,"code":1350,"filename":1313,"language":987,"meta":988},[985],"List the workflow namespaces available to my organization. Pick one read-only workflow, show me its schema, run it, and summarise the output.\n",[901,1352,1350],{"__ignoreMap":988},[940,1354,1355,1356,1145],{},"Behind the scenes the assistant follows the loop the server enforces through ",[901,1357,1358],{},"rule://getting-started",[982,1360,1364],{"className":1361,"code":1362,"filename":1363,"language":987,"meta":988},[985],"whoami()\nlist_workflow_namespaces()\nlist_workflow_types(prefix=\"aws.s3.\")\nget_workflow_schema(\"aws.s3.list_buckets\")        → read_only: true, has_prerequisites: true\nget_workflow_prerequisites(\"aws.s3.list_buckets\", variant=\"aws\")   # only if the connection is missing\nstart_workflow(\"aws.s3.list_buckets\", { \"connection_uuid\": \"…\" })\nwatch_workflow(workflow_id)                       → COMPLETED + output\n","what the assistant does",[901,1365,1362],{"__ignoreMap":988},[885,1367,1369],{"id":1368},"what-the-server-gives-your-assistant","What the server gives your assistant",[1371,1372,1374],"h3",{"id":1373},"tools","Tools",[1376,1377,1378,1393],"table",{},[1379,1380,1381],"thead",{},[1382,1383,1384,1388,1390],"tr",{},[1385,1386,1387],"th",{},"Family",[1385,1389,1374],{},[1385,1391,1392],{},"Use",[1394,1395,1396,1434,1465,1502],"tbody",{},[1382,1397,1398,1402,1406],{},[1399,1400,1401],"td",{},"Identity",[1399,1403,1404],{},[901,1405,922],{},[1399,1407,1408,1409,1329,1412,1329,1415,1329,1418,1421,1422,1329,1425,1329,1428,1329,1431,914],{},"Mandatory first call. Returns ",[901,1410,1411],{},"user_id",[901,1413,1414],{},"organization_uuid",[901,1416,1417],{},"username",[901,1419,1420],{},"token_type",", and for agent tokens ",[901,1423,1424],{},"agent_uuid",[901,1426,1427],{},"permission_mode",[901,1429,1430],{},"seat_mode",[901,1432,1433],{},"staff_actor_uuid",[1382,1435,1436,1439,1462],{},[1399,1437,1438],{},"Catalog",[1399,1440,1441,1329,1444,1329,1447,1329,1450,1329,1453,1329,1456,1329,1459],{},[901,1442,1443],{},"list_workflow_namespaces",[901,1445,1446],{},"list_workflow_types",[901,1448,1449],{},"get_workflow_schema",[901,1451,1452],{},"get_workflow_definition",[901,1454,1455],{},"get_workflow_dag",[901,1457,1458],{},"get_workflow_prerequisites",[901,1460,1461],{},"list_plugins",[1399,1463,1464],{},"Find the right type, learn its inputs, check prerequisites.",[1382,1466,1467,1470,1499],{},[1399,1468,1469],{},"Runs",[1399,1471,1472,1329,1475,1329,1478,1329,1481,1329,1484,1329,1487,1329,1490,1329,1493,1329,1496],{},[901,1473,1474],{},"start_workflow",[901,1476,1477],{},"watch_workflow",[901,1479,1480],{},"get_workflow_status",[901,1482,1483],{},"get_workflow_history",[901,1485,1486],{},"list_workflows",[901,1488,1489],{},"list_stuck_workflows",[901,1491,1492],{},"retry_workflow",[901,1494,1495],{},"resolve_workflow",[901,1497,1498],{},"force_terminate_workflow",[1399,1500,1501],{},"Start, follow, inspect, and recover executions.",[1382,1503,1504,1506,1510],{},[1399,1505,587],{},[1399,1507,1508],{},[901,1509,996],{},[1399,1511,1512],{},"Render the Orkestia console inside the chat (clients with MCP Apps support).",[940,1514,1515,1516,914],{},"Full tool detail: ",[1287,1517,1518],{"href":170},"MCP integration",[1371,1520,1522],{"id":1521},"resources","Resources",[940,1524,1525,1526,1530],{},"Resources are read-only documents the assistant reads ",[1527,1528,1529],"em",{},"before"," acting. They are how the guardrails travel with the protocol instead of living in prose.",[1376,1532,1533,1543],{},[1379,1534,1535],{},[1382,1536,1537,1540],{},[1385,1538,1539],{},"Resource",[1385,1541,1542],{},"What it tells the assistant",[1394,1544,1545,1555,1571,1591,1610,1622,1635,1649,1659,1669,1679],{},[1382,1546,1547,1552],{},[1399,1548,1549],{},[901,1550,1551],{},"concept://product",[1399,1553,1554],{},"Grounded identity and capability map of Orkestia. Read before describing the platform.",[1382,1556,1557,1568],{},[1399,1558,1559,1329,1562,1329,1565],{},[901,1560,1561],{},"concept://engine",[901,1563,1564],{},"concept://dag",[901,1566,1567],{},"concept://workflow-types-vs-instances",[1399,1569,1570],{},"What the server can operate; how DAGs are structured; a type is a capability, a run is one execution.",[1382,1572,1573,1578],{},[1399,1574,1575],{},[901,1576,1577],{},"knowledge://orkestia/capabilities",[1399,1579,1580,1581,1329,1584,1329,1587,1590],{},"The catalog by domain and by kind (",[901,1582,1583],{},"state_machine",[901,1585,1586],{},"data",[901,1588,1589],{},"dag",").",[1382,1592,1593,1607],{},[1399,1594,1595,1329,1598,1329,1601,1329,1604],{},[901,1596,1597],{},"knowledge://mcp/discovery",[901,1599,1600],{},"knowledge://mcp/execution",[901,1602,1603],{},"knowledge://mcp/recovery",[901,1605,1606],{},"knowledge://mcp/public-boundary",[1399,1608,1609],{},"The discovery pattern, how to start and monitor, how to recover, and what this public surface does not expose.",[1382,1611,1612,1616],{},[1399,1613,1614],{},[901,1615,1358],{},[1399,1617,1618,1619,1621],{},"Mandatory ",[901,1620,922],{},", then list, schema, start, watch.",[1382,1623,1624,1629],{},[1399,1625,1626],{},[901,1627,1628],{},"rule://authenticated-context",[1399,1630,1631,1632,1634],{},"The org is resolved server-side. Never pass ",[901,1633,1414],{}," unless a schema declares it.",[1382,1636,1637,1642],{},[1399,1638,1639],{},[901,1640,1641],{},"rule://prerequisites-first",[1399,1643,1644,1645,1648],{},"If ",[901,1646,1647],{},"has_prerequisites"," is true, fetch the setup guide before starting.",[1382,1650,1651,1656],{},[1399,1652,1653],{},[901,1654,1655],{},"rule://grounding",[1399,1657,1658],{},"Say only what tool results show. A registered type is a capability, not a production run.",[1382,1660,1661,1666],{},[1399,1662,1663],{},[901,1664,1665],{},"rule://orkestia-auth-setup",[1399,1667,1668],{},"The one-call recipe for \"Sign in with Orkestia\" in your app.",[1382,1670,1671,1676],{},[1399,1672,1673],{},[901,1674,1675],{},"prerequisite://{workflow_type}/{variant}",[1399,1677,1678],{},"The rendered setup guide for one type and variant.",[1382,1680,1681,1686],{},[1399,1682,1683],{},[901,1684,1685],{},"ui://orkestia/app/v1.html",[1399,1687,1688,1689,1691],{},"The console template ",[901,1690,996],{}," renders.",[1371,1693,1695],{"id":1694},"prompts","Prompts",[1376,1697,1698,1708],{},[1379,1699,1700],{},[1382,1701,1702,1705],{},[1385,1703,1704],{},"Prompt",[1385,1706,1707],{},"What it does",[1394,1709,1710,1720],{},[1382,1711,1712,1717],{},[1399,1713,1714],{},[901,1715,1716],{},"how_to_use_workflow_mcp",[1399,1718,1719],{},"Onboards the assistant: how to use the tools and resources in order. Invoke it in a fresh session.",[1382,1721,1722,1727],{},[1399,1723,1724],{},[901,1725,1726],{},"diagnose_workflow_run",[1399,1728,1729,1730,1733],{},"Takes a ",[901,1731,1732],{},"workflow_id"," and walks status, history, and recovery options.",[885,1735,1737],{"id":1736},"prompt-library","Prompt library",[940,1739,1740],{},"Copy any of these into a connected assistant.",[982,1742,1746],{"className":1743,"code":1744,"filename":1745,"language":987,"meta":988},[985],"Read concept://product and knowledge://orkestia/capabilities. Group my org's namespaces by domain and tell me which ones have recent activity.\n\nExplain the difference between a workflow type and a workflow run using concept://workflow-types-vs-instances.\n","orientation",[901,1747,1744],{"__ignoreMap":988},[982,1749,1753],{"className":1750,"code":1751,"filename":1752,"language":987,"meta":988},[985],"Set up an AWS connection. Fetch the prerequisites for connection.setup with variant \"aws\" and show me what to create. Wait for my role ARN and external ID before starting anything.\n\nList my organization's connections and tell me which providers are connected and healthy.\n","connections and prerequisites",[901,1754,1751],{"__ignoreMap":988},[982,1756,1760],{"className":1757,"code":1758,"filename":1759,"language":987,"meta":988},[985],"Show me the schema for \u003Cworkflow_type>. If it has prerequisites, fetch them. Then ask me for the inputs you cannot discover on your own.\n\nStart \u003Cworkflow_type> with these inputs: … . Watch it to a terminal state and report the workflow ID, final state, and the output fields that matter.\n","running and watching",[901,1761,1758],{"__ignoreMap":988},[982,1763,1767],{"className":1764,"code":1765,"filename":1766,"language":987,"meta":988},[985],"List the stuck workflows in my org. For each, read its history and tell me whether it is safe to retry.\n\nUse diagnose_workflow_run on \u003Cworkflow_id>. If it is a retryable failure, propose the retry but do not run it until I confirm.\n\nWorkflow \u003Cworkflow_id> is parked in remediation_pending. Read its state_data.remediation envelope and tell me what needs fixing.\n","recovery",[901,1768,1765],{"__ignoreMap":988},[982,1770,1774],{"className":1771,"code":1772,"filename":1773,"language":987,"meta":988},[985],"Read concept://dag. Design a composition that creates a bucket, enables versioning, and applies a tag. Validate it against my catalog and show me the validation errors, if any.\n\nPlan the steps to deploy a static site from GitHub and point a domain at it. Use only types that exist in my catalog. Do not execute.\n","compositions and DGI",[901,1775,1772],{"__ignoreMap":988},[982,1777,1781],{"className":1778,"code":1779,"filename":1780,"language":987,"meta":988},[985],"Follow rule://orkestia-auth-setup to provision an identity app called \"Demo\" with redirect URI http://localhost:5173/callback. Return the client_key and the integration endpoints.\n","apps on top",[901,1782,1779],{"__ignoreMap":988},[982,1784,1788],{"className":1785,"code":1786,"filename":1787,"language":987,"meta":988},[985],"List my Staff actors and their role bindings. Flag any actor bound to kubernetes.* or deploy.* capabilities.\n\nShow me the agent configs in my org with their attached skills, MCP servers, and budgets.\n","staff and agents",[901,1789,1786],{"__ignoreMap":988},[982,1791,1795],{"className":1792,"code":1793,"filename":1794,"language":987,"meta":988},[985],"Using the Lumen tools, list open error groups from the last 24 hours, rank them by count, and show me the trace for the top one.\n","observability (Lumen MCP)",[901,1796,1793],{"__ignoreMap":988},[885,1798,1800],{"id":1799},"rules-the-assistant-follows","Rules the assistant follows",[940,1802,1803],{},"These are enforced by the server's instructions and resources, and they are also good habits for humans:",[1805,1806,1807,1815,1826,1835,1841,1847],"ol",{},[893,1808,1809,1814],{},[896,1810,1811,1813],{},[901,1812,922],{}," first."," Identity and org come from the token.",[893,1816,1817,1820,1821,1823,1824,914],{},[896,1818,1819],{},"Never invent a workflow name."," Confirm every type with ",[901,1822,1446],{}," or ",[901,1825,1449],{},[893,1827,1828,1831,1832,1834],{},[896,1829,1830],{},"Prerequisites before start."," If ",[901,1833,1647],{}," is true, fetch the guide. The assistant never asks you for cloud secrets; it asks for the inputs the schema declares (for example a role ARN).",[893,1836,1837,1840],{},[896,1838,1839],{},"Reads are safe, writes are confirmed."," Reads start directly. Creates and mutations are confirmed with you.",[893,1842,1843,1846],{},[896,1844,1845],{},"Grounding."," The assistant describes Orkestia only from what tools return. A catalog total is a capability count, not \"N production workflows\".",[893,1848,1849,1852],{},[896,1850,1851],{},"Report back properly."," Workflow type, workflow ID, final state, and the output fields that matter.",[885,1854,1856],{"id":1855},"reading-these-docs-from-an-assistant","Reading these docs from an assistant",[940,1858,1859],{},"The whole documentation site is available to language models without scraping:",[1376,1861,1862,1872],{},[1379,1863,1864],{},[1382,1865,1866,1869],{},[1385,1867,1868],{},"Surface",[1385,1870,1871],{},"URL",[1394,1873,1874,1886,1897,1915],{},[1382,1875,1876,1879],{},[1399,1877,1878],{},"Index for LLMs",[1399,1880,1881],{},[1287,1882,1883],{"href":1883,"rel":1884},"https://docs.orkestia.dev/llms.txt",[1885],"nofollow",[1382,1887,1888,1891],{},[1399,1889,1890],{},"Everything in one file",[1399,1892,1893],{},[1287,1894,1895],{"href":1895,"rel":1896},"https://docs.orkestia.dev/llms-full.txt",[1885],[1382,1898,1899,1902],{},[1399,1900,1901],{},"Any page as markdown",[1399,1903,1904,1907,1908],{},[901,1905,1906],{},"https://docs.orkestia.dev/raw/\u003Cpath>.md",", for example ",[1287,1909,1912],{"href":1910,"rel":1911},"https://docs.orkestia.dev/raw/concepts/workflows.md",[1885],[901,1913,1914],{},"/raw/concepts/workflows.md",[1382,1916,1917,1920],{},[1399,1918,1919],{},"Per-workflow reference",[1399,1921,1922],{},[1287,1923,1924],{"href":1924,"rel":1925},"https://reference.orkestia.dev",[1885],[940,1927,1928],{},"Every page also has a \"copy as markdown\" and \"open in ChatGPT / Claude\" action in its header.",[885,1930,261],{"id":1931},"troubleshooting",[1376,1933,1934,1947],{},[1379,1935,1936],{},[1382,1937,1938,1941,1944],{},[1385,1939,1940],{},"Symptom",[1385,1942,1943],{},"Likely cause",[1385,1945,1946],{},"Fix",[1394,1948,1949,1969,1985,1999,2010,2024],{},[1382,1950,1951,1954,1964],{},[1399,1952,1953],{},"404 on connect",[1399,1955,1956,1957,1960,1961],{},"You used ",[901,1958,1959],{},"https://mcp.orkestia.dev"," without ",[901,1962,1963],{},"/mcp",[1399,1965,1966,1967],{},"Use ",[901,1968,903],{},[1382,1970,1971,1974,1980],{},[1399,1972,1973],{},"The assistant asks for an organization ID",[1399,1975,1976,1977,1979],{},"It skipped ",[901,1978,922],{},", or the token is invalid",[1399,1981,1982,1983],{},"Re-authenticate; invoke ",[901,1984,1716],{},[1382,1986,1987,1990,1993],{},[1399,1988,1989],{},"A run fails at its first action",[1399,1991,1992],{},"A prerequisite (usually a connection) is missing",[1399,1994,1995,1996,1998],{},"Ask the assistant to fetch ",[901,1997,1458],{}," and complete the setup",[1382,2000,2001,2004,2007],{},[1399,2002,2003],{},"\"unknown field organization_uuid\"",[1399,2005,2006],{},"The assistant passed the org by hand",[1399,2008,2009],{},"Remove it. The server injects the org",[1382,2011,2012,2015,2018],{},[1399,2013,2014],{},"Lumen tools are missing",[1399,2016,2017],{},"Lumen is a separate MCP server",[1399,2019,2020,2021,2023],{},"Connect ",[901,2022,938],{}," after enabling Lumen",[1382,2025,2026,2031,2034],{},[1399,2027,2028,2030],{},[901,2029,1492],{}," rejected",[1399,2032,2033],{},"The run is not in a retryable terminal state",[1399,2035,2036,2037,2039],{},"Read history; for a confirmed-stale run, ",[901,2038,1498],{}," with a reason",[885,2041,2043],{"id":2042},"where-to-go-next","Where to go next",[2045,2046,2047,2054,2059,2064,2076],"card-group",{},[2048,2049,2051],"card",{"icon":172,"title":2050,"to":170},"MCP integration reference",[940,2052,2053],{},"Every tool, resource, and prompt with its contract.",[2048,2055,2056],{"icon":56,"title":53,"to":54},[940,2057,2058],{},"Types vs runs, the state machine, compositions.",[2048,2060,2061],{"icon":66,"title":572,"to":573},[940,2062,2063],{},"Give your own agents an MCP token, skills, and a runner group.",[2048,2065,2066],{"icon":114,"title":111,"to":671},[940,2067,2068,2069,1105,2072,2075],{},"Discover ",[901,2070,2071],{},"exchange.",[901,2073,2074],{},"data.exchange."," — never pass the other org's UUID.",[2048,2077,2078],{"icon":514,"title":419,"to":420},[940,2079,2080],{},"Let an assistant provision \"Sign in with Orkestia\" for your app.",[2082,2083,2084],"style",{},"html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":988,"searchDepth":1011,"depth":1018,"links":2086},[2087,2088,2089,2090,2091,2092,2097,2098,2099,2100,2101],{"id":887,"depth":1018,"text":888},{"id":945,"depth":1018,"text":946},{"id":961,"depth":1018,"text":962},{"id":1304,"depth":1018,"text":1305},{"id":1321,"depth":1018,"text":1322},{"id":1368,"depth":1018,"text":1369,"children":2093},[2094,2095,2096],{"id":1373,"depth":1044,"text":1374},{"id":1521,"depth":1044,"text":1522},{"id":1694,"depth":1044,"text":1695},{"id":1736,"depth":1018,"text":1737},{"id":1799,"depth":1018,"text":1800},{"id":1855,"depth":1018,"text":1856},{"id":1931,"depth":1018,"text":261},{"id":2042,"depth":1018,"text":2043},"Plug Claude, ChatGPT, Cursor, Claude Code, or any MCP client into the Orkestia MCP server, then run your first workflow by talking. Includes a prompt library and the rules the server gives your assistant","md",null,{},{"icon":44},{"title":41,"description":2102},"dTJbr7npcpbMtwT1vkYgvmzU5i_WwsO9EHYBjidGYuQ",[2110,2112],{"title":36,"path":37,"stem":38,"description":2111,"icon":39,"children":-1},"One paragraph per Orkestia concept, workflows, compositions, MCP, DGI, Staff, agents, Agent Exchange, runners, Lumen, identity, App Data, App Host, Engram, DevKit, each with a prompt you can try and a link to the deep page",{"title":46,"path":47,"stem":48,"description":2113,"icon":51,"children":-1},"The mental model behind Orkestia, workflows, MCP, DGI, Staff, agents, Agent Exchange, runners, Lumen, identity, billing, App Data, App Host, Engram, and DevKit, with a reading order and a map from each concept to its MCP namespaces and tools",1790354035157]