[{"data":1,"prerenderedAt":2248},["ShallowReactive",2],{"navigation":3,"/staff-and-agents/run-a-ticket":879,"/staff-and-agents/run-a-ticket-surround":2243},[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":621,"body":881,"description":2236,"extension":2237,"links":2238,"meta":2239,"navigation":2240,"path":622,"seo":2241,"stem":623,"__hash__":2242},"docs/20.staff-and-agents/12.run-a-ticket.md",{"type":882,"value":883,"toc":2226},"minimark",[884,891,904,909,920,923,927,976,980,983,1023,1026,1245,1248,1252,1255,1325,1331,1338,1520,1551,1555,1558,1669,1672,1799,1802,1806,1809,1842,1849,2019,2030,2034,2040,2175,2196,2200,2222],[885,886,887,890],"p",{},[888,889,612],"a",{"href":613}," explains what the pieces are. This page is the operator's path through one ticket: what to write, which calls launch it, what \"normal\" looks like while it runs, and what to do when it stalls.",[892,893,894],"note",{},[885,895,896,897,903],{},"Every call on this page is an Orkestia workflow. Start it from the MCP server, the Staff console, or the API — the names and inputs are the same. Per-workflow contracts live in the ",[888,898,902],{"href":899,"rel":900},"https://reference.orkestia.dev/ticket/",[901],"nofollow","reference catalog",".",[905,906,908],"h2",{"id":907},"the-loop-you-are-launching","The loop you are launching",[910,911,916],"pre",{"className":912,"code":914,"language":915},[913],"language-text","ticket ──▶ git work ──▶ delivery ──▶ coding session (hosted runner)\n                                          │ commit, run required commands\n                                          ▼\n                          trusted broker publishes the exact head\n                                          ▼\n                    reviewer actor opens the pull request (labels, provenance)\n                                          ▼\n                  approval gate: CI green ▸ AI code review ▸ receipt\n                                          ▼\n                    merge lane squashes, deletes the work branch\n                                          ▼\n                  release operator advances post-merge, resolves the ticket\n","text",[917,918,914],"code",{"__ignoreMap":919},"",[885,921,922],{},"Every arrow is driven by the software-delivery controller, a Staff actor that runs every 30 seconds and claims one actionable delivery at a time. You never push, open, review or merge anything yourself. The coding session never holds a git credential; the broker publishes only the exact object the session acknowledged.",[905,924,926],{"id":925},"before-you-start","Before you start",[928,929,930,955,961],"ul",{},[931,932,933,934,938,939,941,942,944,945,948,949,952,953,903],"li",{},"The repository is ",[935,936,937],"strong",{},"ready for hosted delivery",": platform registration, GitHub binding, delivery policy, execution profile, and manifest files on the prepared branch. See ",[888,940,616],{"href":617},". For local-only work, ",[888,943,612],{"href":613}," is enough. The execution profile's dependency kind must be one the runner implements; a ",[917,946,947],{},"python-uv"," profile needs a committed ",[917,950,951],{},"uv.lock",". See also ",[888,954,699],{"href":596},[931,956,957,958,903],{},"The controller actor's schedule is enabled. Check it in Staff → Staff tree, or with ",[917,959,960],{},"staff.get-actor",[931,962,963,964,967,968,971,972,975],{},"You know the repository's ",[917,965,966],{},"repository_uuid",", the policy's ",[917,969,970],{},"policy_uuid",", and the target branch the policy allows (usually ",[917,973,974],{},"refs/heads/master",").",[905,977,979],{"id":978},"_1-write-the-ticket-as-a-specification","1. Write the ticket as a specification",[885,981,982],{},"The coding agent treats the ticket body as the contract and implements nothing outside it. Tickets that merge on the first attempt share one shape:",[928,984,985,991,997,1007,1013],{},[931,986,987,990],{},[935,988,989],{},"the exact files"," to change, by path;",[931,992,993,996],{},[935,994,995],{},"numbered rules",", each verifiable inside the workspace;",[931,998,999,1002,1003,1006],{},[935,1000,1001],{},"schema rules spelled out"," when the change touches a workflow — an undeclared output field fails every call of that workflow, so \"declare it in ",[917,1004,1005],{},"OUTPUT_SCHEMA","\" is part of the change;",[931,1008,1009,1012],{},[935,1010,1011],{},"the tests"," to add, by file and by case;",[931,1014,1015,1016,1019,1020,903],{},"a ",[935,1017,1018],{},"done-when"," line and ",[935,1021,1022],{},"\"no other files\"",[885,1024,1025],{},"Keep the diff inside the policy's approval thresholds (changed files, additions, deletions); the gate will not approve a change that exceeds them.",[910,1027,1031],{"className":1028,"code":1029,"language":1030,"meta":919,"style":919},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","ticket.open\n{\n  \"kind\": \"task\",\n  \"title\": \"github.pulls.get_exact_pr: expose head_repository and is_fork\",\n  \"body\": \"\u003Cthe specification>\",\n  \"labels\": [\"pipeline:coding\"],\n  \"source_type\": \"human\", \"owner_type\": \"human\", \"owner_uuid\": \"\u003Cyour principal>\",\n  \"priority\": \"routine\", \"severity\": \"low\"\n}\n","json",[917,1032,1033,1042,1049,1077,1098,1119,1144,1201,1239],{"__ignoreMap":919},[1034,1035,1038],"span",{"class":1036,"line":1037},"line",1,[1034,1039,1041],{"class":1040},"sTEyZ","ticket.open\n",[1034,1043,1045],{"class":1036,"line":1044},2,[1034,1046,1048],{"class":1047},"sMK4o","{\n",[1034,1050,1052,1055,1059,1062,1065,1068,1072,1074],{"class":1036,"line":1051},3,[1034,1053,1054],{"class":1047},"  \"",[1034,1056,1058],{"class":1057},"spNyl","kind",[1034,1060,1061],{"class":1047},"\"",[1034,1063,1064],{"class":1047},":",[1034,1066,1067],{"class":1047}," \"",[1034,1069,1071],{"class":1070},"sfazB","task",[1034,1073,1061],{"class":1047},[1034,1075,1076],{"class":1047},",\n",[1034,1078,1080,1082,1085,1087,1089,1091,1094,1096],{"class":1036,"line":1079},4,[1034,1081,1054],{"class":1047},[1034,1083,1084],{"class":1057},"title",[1034,1086,1061],{"class":1047},[1034,1088,1064],{"class":1047},[1034,1090,1067],{"class":1047},[1034,1092,1093],{"class":1070},"github.pulls.get_exact_pr: expose head_repository and is_fork",[1034,1095,1061],{"class":1047},[1034,1097,1076],{"class":1047},[1034,1099,1101,1103,1106,1108,1110,1112,1115,1117],{"class":1036,"line":1100},5,[1034,1102,1054],{"class":1047},[1034,1104,1105],{"class":1057},"body",[1034,1107,1061],{"class":1047},[1034,1109,1064],{"class":1047},[1034,1111,1067],{"class":1047},[1034,1113,1114],{"class":1070},"\u003Cthe specification>",[1034,1116,1061],{"class":1047},[1034,1118,1076],{"class":1047},[1034,1120,1122,1124,1127,1129,1131,1134,1136,1139,1141],{"class":1036,"line":1121},6,[1034,1123,1054],{"class":1047},[1034,1125,1126],{"class":1057},"labels",[1034,1128,1061],{"class":1047},[1034,1130,1064],{"class":1047},[1034,1132,1133],{"class":1047}," [",[1034,1135,1061],{"class":1047},[1034,1137,1138],{"class":1070},"pipeline:coding",[1034,1140,1061],{"class":1047},[1034,1142,1143],{"class":1047},"],\n",[1034,1145,1147,1149,1152,1154,1156,1158,1161,1163,1166,1168,1171,1173,1175,1177,1179,1181,1183,1185,1188,1190,1192,1194,1197,1199],{"class":1036,"line":1146},7,[1034,1148,1054],{"class":1047},[1034,1150,1151],{"class":1057},"source_type",[1034,1153,1061],{"class":1047},[1034,1155,1064],{"class":1047},[1034,1157,1067],{"class":1047},[1034,1159,1160],{"class":1070},"human",[1034,1162,1061],{"class":1047},[1034,1164,1165],{"class":1047},",",[1034,1167,1067],{"class":1047},[1034,1169,1170],{"class":1057},"owner_type",[1034,1172,1061],{"class":1047},[1034,1174,1064],{"class":1047},[1034,1176,1067],{"class":1047},[1034,1178,1160],{"class":1070},[1034,1180,1061],{"class":1047},[1034,1182,1165],{"class":1047},[1034,1184,1067],{"class":1047},[1034,1186,1187],{"class":1057},"owner_uuid",[1034,1189,1061],{"class":1047},[1034,1191,1064],{"class":1047},[1034,1193,1067],{"class":1047},[1034,1195,1196],{"class":1070},"\u003Cyour principal>",[1034,1198,1061],{"class":1047},[1034,1200,1076],{"class":1047},[1034,1202,1204,1206,1209,1211,1213,1215,1218,1220,1222,1224,1227,1229,1231,1233,1236],{"class":1036,"line":1203},8,[1034,1205,1054],{"class":1047},[1034,1207,1208],{"class":1057},"priority",[1034,1210,1061],{"class":1047},[1034,1212,1064],{"class":1047},[1034,1214,1067],{"class":1047},[1034,1216,1217],{"class":1070},"routine",[1034,1219,1061],{"class":1047},[1034,1221,1165],{"class":1047},[1034,1223,1067],{"class":1047},[1034,1225,1226],{"class":1057},"severity",[1034,1228,1061],{"class":1047},[1034,1230,1064],{"class":1047},[1034,1232,1067],{"class":1047},[1034,1234,1235],{"class":1070},"low",[1034,1237,1238],{"class":1047},"\"\n",[1034,1240,1242],{"class":1036,"line":1241},9,[1034,1243,1244],{"class":1047},"}\n",[885,1246,1247],{},"The label marks intent; it does not launch anything. Step 2 does.",[905,1249,1251],{"id":1250},"_2-bind-the-work-and-open-the-delivery","2. Bind the work and open the delivery",[885,1253,1254],{},"Delivery policies are serial per target branch: one active piece of work per branch. If a previous delivery on the same branch has merged, close its work first so the lane is free:",[910,1256,1258],{"className":1028,"code":1257,"language":1030,"meta":919,"style":919},"ticket.git-work.complete\n{ \"work_uuid\": \"\u003Cprevious work>\", \"outcome\": \"merged\", \"merge_oid\": \"\u003Cits squash oid>\" }\n",[917,1259,1260,1265],{"__ignoreMap":919},[1034,1261,1262],{"class":1036,"line":1037},[1034,1263,1264],{"class":1040},"ticket.git-work.complete\n",[1034,1266,1267,1270,1272,1275,1277,1279,1281,1284,1286,1288,1290,1293,1295,1297,1299,1302,1304,1306,1308,1311,1313,1315,1317,1320,1322],{"class":1036,"line":1044},[1034,1268,1269],{"class":1047},"{",[1034,1271,1067],{"class":1047},[1034,1273,1274],{"class":1057},"work_uuid",[1034,1276,1061],{"class":1047},[1034,1278,1064],{"class":1047},[1034,1280,1067],{"class":1047},[1034,1282,1283],{"class":1070},"\u003Cprevious work>",[1034,1285,1061],{"class":1047},[1034,1287,1165],{"class":1047},[1034,1289,1067],{"class":1047},[1034,1291,1292],{"class":1057},"outcome",[1034,1294,1061],{"class":1047},[1034,1296,1064],{"class":1047},[1034,1298,1067],{"class":1047},[1034,1300,1301],{"class":1070},"merged",[1034,1303,1061],{"class":1047},[1034,1305,1165],{"class":1047},[1034,1307,1067],{"class":1047},[1034,1309,1310],{"class":1057},"merge_oid",[1034,1312,1061],{"class":1047},[1034,1314,1064],{"class":1047},[1034,1316,1067],{"class":1047},[1034,1318,1319],{"class":1070},"\u003Cits squash oid>",[1034,1321,1061],{"class":1047},[1034,1323,1324],{"class":1047}," }\n",[885,1326,1327,1330],{},[917,1328,1329],{},"ticket.git-work.concurrency"," reports the lane without claiming anything.",[885,1332,1333,1334,1337],{},"Then bind the ticket to the repository and open the delivery. Pass the current head of the target branch as ",[917,1335,1336],{},"base_oid","; the derived default can be stale.",[910,1339,1341],{"className":1028,"code":1340,"language":1030,"meta":919,"style":919},"ticket.git-work.begin\n{\n  \"ticket_uuid\": \"\u003Cticket>\",\n  \"repository_uuid\": \"\u003Crepository>\",\n  \"runner_group_uuid\": \"\u003Chosted coding runner group>\",\n  \"target_ref\": \"refs/heads/master\",\n  \"base_oid\": \"\u003Ccurrent head of master>\"\n}\n\nticket.software-delivery.begin\n{ \"work_uuid\": \"\u003Cwork from above>\", \"idempotency_key\": \"delivery-\u003Cwork8>-r1\", \"policy_uuid\": \"\u003Cpolicy>\" }\n",[917,1342,1343,1348,1352,1372,1391,1411,1430,1447,1451,1457,1463],{"__ignoreMap":919},[1034,1344,1345],{"class":1036,"line":1037},[1034,1346,1347],{"class":1040},"ticket.git-work.begin\n",[1034,1349,1350],{"class":1036,"line":1044},[1034,1351,1048],{"class":1047},[1034,1353,1354,1356,1359,1361,1363,1365,1368,1370],{"class":1036,"line":1051},[1034,1355,1054],{"class":1047},[1034,1357,1358],{"class":1057},"ticket_uuid",[1034,1360,1061],{"class":1047},[1034,1362,1064],{"class":1047},[1034,1364,1067],{"class":1047},[1034,1366,1367],{"class":1070},"\u003Cticket>",[1034,1369,1061],{"class":1047},[1034,1371,1076],{"class":1047},[1034,1373,1374,1376,1378,1380,1382,1384,1387,1389],{"class":1036,"line":1079},[1034,1375,1054],{"class":1047},[1034,1377,966],{"class":1057},[1034,1379,1061],{"class":1047},[1034,1381,1064],{"class":1047},[1034,1383,1067],{"class":1047},[1034,1385,1386],{"class":1070},"\u003Crepository>",[1034,1388,1061],{"class":1047},[1034,1390,1076],{"class":1047},[1034,1392,1393,1395,1398,1400,1402,1404,1407,1409],{"class":1036,"line":1100},[1034,1394,1054],{"class":1047},[1034,1396,1397],{"class":1057},"runner_group_uuid",[1034,1399,1061],{"class":1047},[1034,1401,1064],{"class":1047},[1034,1403,1067],{"class":1047},[1034,1405,1406],{"class":1070},"\u003Chosted coding runner group>",[1034,1408,1061],{"class":1047},[1034,1410,1076],{"class":1047},[1034,1412,1413,1415,1418,1420,1422,1424,1426,1428],{"class":1036,"line":1121},[1034,1414,1054],{"class":1047},[1034,1416,1417],{"class":1057},"target_ref",[1034,1419,1061],{"class":1047},[1034,1421,1064],{"class":1047},[1034,1423,1067],{"class":1047},[1034,1425,974],{"class":1070},[1034,1427,1061],{"class":1047},[1034,1429,1076],{"class":1047},[1034,1431,1432,1434,1436,1438,1440,1442,1445],{"class":1036,"line":1146},[1034,1433,1054],{"class":1047},[1034,1435,1336],{"class":1057},[1034,1437,1061],{"class":1047},[1034,1439,1064],{"class":1047},[1034,1441,1067],{"class":1047},[1034,1443,1444],{"class":1070},"\u003Ccurrent head of master>",[1034,1446,1238],{"class":1047},[1034,1448,1449],{"class":1036,"line":1203},[1034,1450,1244],{"class":1047},[1034,1452,1453],{"class":1036,"line":1241},[1034,1454,1456],{"emptyLinePlaceholder":1455},true,"\n",[1034,1458,1460],{"class":1036,"line":1459},10,[1034,1461,1462],{"class":1040},"ticket.software-delivery.begin\n",[1034,1464,1466,1468,1470,1472,1474,1476,1478,1481,1483,1485,1487,1490,1492,1494,1496,1499,1501,1503,1505,1507,1509,1511,1513,1516,1518],{"class":1036,"line":1465},11,[1034,1467,1269],{"class":1047},[1034,1469,1067],{"class":1047},[1034,1471,1274],{"class":1057},[1034,1473,1061],{"class":1047},[1034,1475,1064],{"class":1047},[1034,1477,1067],{"class":1047},[1034,1479,1480],{"class":1070},"\u003Cwork from above>",[1034,1482,1061],{"class":1047},[1034,1484,1165],{"class":1047},[1034,1486,1067],{"class":1047},[1034,1488,1489],{"class":1057},"idempotency_key",[1034,1491,1061],{"class":1047},[1034,1493,1064],{"class":1047},[1034,1495,1067],{"class":1047},[1034,1497,1498],{"class":1070},"delivery-\u003Cwork8>-r1",[1034,1500,1061],{"class":1047},[1034,1502,1165],{"class":1047},[1034,1504,1067],{"class":1047},[1034,1506,970],{"class":1057},[1034,1508,1061],{"class":1047},[1034,1510,1064],{"class":1047},[1034,1512,1067],{"class":1047},[1034,1514,1515],{"class":1070},"\u003Cpolicy>",[1034,1517,1061],{"class":1047},[1034,1519,1324],{"class":1047},[885,1521,1522,1523,1526,1527,1530,1531,1534,1535,1538,1539,1542,1543,1546,1547,1550],{},"You get a work item in ",[917,1524,1525],{},"active"," with a ",[917,1528,1529],{},"codex/\u003Cslug>-\u003Cid>"," branch ref and a delivery in ",[917,1532,1533],{},"coding",". Within 30 seconds ",[917,1536,1537],{},"ticket.software-delivery.controller-list"," shows the delivery on ",[917,1540,1541],{},"start_coding_session",", first with the claim ",[917,1544,1545],{},"available",", then ",[917,1548,1549],{},"leased",". The runner group named here is advisory; the coding actor's own config decides where the session runs.",[905,1552,1554],{"id":1553},"_3-watch-it","3. Watch it",[885,1556,1557],{},"All reads, no side effects:",[1559,1560,1561,1574],"table",{},[1562,1563,1564],"thead",{},[1565,1566,1567,1571],"tr",{},[1568,1569,1570],"th",{},"Question",[1568,1572,1573],{},"Call",[1575,1576,1577,1587,1602,1613,1626,1646,1657],"tbody",{},[1565,1578,1579,1583],{},[1580,1581,1582],"td",{},"Which step is the controller on, how many attempts",[1580,1584,1585],{},[917,1586,1537],{},[1565,1588,1589,1592],{},[1580,1590,1591],{},"Is the coding session alive, on which runner",[1580,1593,1594,1597,1598,1601],{},[917,1595,1596],{},"ticket.git-work.get"," → ",[917,1599,1600],{},"workspace_leases"," (heartbeat, session id)",[1565,1603,1604,1607],{},[1580,1605,1606],{},"What is the agent doing right now",[1580,1608,1609,1612],{},[917,1610,1611],{},"data.agents.session-trace"," with the session id",[1565,1614,1615,1618],{},[1580,1616,1617],{},"Did the runner capture the commit",[1580,1619,1620,1623,1624],{},[917,1621,1622],{},"ticket.coding-artifact.list"," → an artifact in ",[917,1625,1545],{},[1565,1627,1628,1631],{},[1580,1629,1630],{},"Is publication moving",[1580,1632,1633,1636,1637,1597,1640,1597,1643],{},[917,1634,1635],{},"ticket.git-delivery.list"," → attempt ",[917,1638,1639],{},"claimed",[917,1641,1642],{},"pushed",[917,1644,1645],{},"verified",[1565,1647,1648,1651],{},[1580,1649,1650],{},"The full ledger",[1580,1652,1653,1656],{},[917,1654,1655],{},"ticket.software-delivery.get"," with transitions and evidence",[1565,1658,1659,1662],{},[1580,1660,1661],{},"The provider side",[1580,1663,1664,1665,1668],{},"the pull request, its checks, and the review carrying the ",[917,1666,1667],{},"orkestia-verdict"," marker",[885,1670,1671],{},"What a healthy run looks like on a hosted runner, measured from the delivery's creation:",[1559,1673,1674,1687],{},[1562,1675,1676],{},[1565,1677,1678,1681,1684],{},[1568,1679,1680],{},"Stage",[1568,1682,1683],{},"Elapsed",[1568,1685,1686],{},"Signal",[1575,1688,1689,1703,1717,1728,1744,1757,1768,1785],{},[1565,1690,1691,1694,1697],{},[1580,1692,1693],{},"Runner claims the session",[1580,1695,1696],{},"about 1 min",[1580,1698,1699,1700],{},"lease ",[917,1701,1702],{},"running",[1565,1704,1705,1708,1711],{},[1580,1706,1707],{},"Commit",[1580,1709,1710],{},"about 20 min",[1580,1712,1713,1716],{},[917,1714,1715],{},"git.commit"," in the session trace",[1565,1718,1719,1722,1725],{},[1580,1720,1721],{},"Publication requested",[1580,1723,1724],{},"about 30 min",[1580,1726,1727],{},"an attempt appears",[1565,1729,1730,1735,1738],{},[1580,1731,1732,1733],{},"Branch on the provider, attempt ",[917,1734,1645],{},[1580,1736,1737],{},"about 35 min",[1580,1739,1740,1741],{},"delivery ",[917,1742,1743],{},"published",[1565,1745,1746,1749,1752],{},[1580,1747,1748],{},"Pull request opened with labels and provenance",[1580,1750,1751],{},"about 70 min",[1580,1753,1740,1754],{},[917,1755,1756],{},"checks_pending",[1565,1758,1759,1762,1765],{},[1580,1760,1761],{},"AI review posted",[1580,1763,1764],{},"about 80 min",[1580,1766,1767],{},"review with the verdict marker",[1565,1769,1770,1775,1778],{},[1580,1771,1772],{},[917,1773,1774],{},"merge_authorized",[1580,1776,1777],{},"about 95 min",[1580,1779,1780,1781,1784],{},"gate receipt recorded as ",[917,1782,1783],{},"approval"," evidence",[1565,1786,1787,1793,1796],{},[1580,1788,1789,1790],{},"Merged, delivery ",[917,1791,1792],{},"completed",[1580,1794,1795],{},"about 105 min",[1580,1797,1798],{},"squash oid on the merge transition",[885,1800,1801],{},"A coding turn takes roughly a minute of model time. Reviewer actions run on your agent runner group and take four to eight minutes each. After a session releases its claim, the controller re-dispatches that step about five minutes later.",[905,1803,1805],{"id":1804},"_4-close-the-loop","4. Close the loop",[885,1807,1808],{},"After the merge the fabric resolves the ticket and deletes the work branch. Verify:",[928,1810,1811,1824,1839],{},[931,1812,1813,1814,1817,1818,1820,1821,1823],{},"ticket ",[917,1815,1816],{},"resolved","; delivery ",[917,1819,1792],{},"; git work ",[917,1822,1301],{},";",[931,1825,1826,1827,1830,1831,1834,1835,1838],{},"the pull request merged with its ",[917,1828,1829],{},"model:*",", ",[917,1832,1833],{},"tool:*"," and ",[917,1836,1837],{},"category:*"," labels;",[931,1840,1841],{},"the work branch gone; the repository's own release pipeline picked up the merge.",[885,1843,1844,1845,1848],{},"If the ticket is still open, move it yourself. The lifecycle refuses ",[917,1846,1847],{},"open → resolved","; start it first:",[910,1850,1852],{"className":1028,"code":1851,"language":1030,"meta":919,"style":919},"ticket.transition { \"ticket_uuid\": \"\u003Cticket>\", \"intent\": \"start\", \"actor_type\": \"human\", \"actor_uuid\": \"\u003Cyou>\" }\nticket.transition { \"ticket_uuid\": \"\u003Cticket>\", \"intent\": \"resolve\", \"resolution\": \"Merged as PR #\u003Cn> (\u003Coid>)\", \"actor_type\": \"human\", \"actor_uuid\": \"\u003Cyou>\" }\n",[917,1853,1854,1930],{"__ignoreMap":919},[1034,1855,1856,1859,1861,1863,1865,1867,1869,1871,1873,1875,1877,1879,1882,1884,1886,1888,1891,1893,1895,1897,1900,1902,1904,1906,1908,1910,1912,1914,1917,1919,1921,1923,1926,1928],{"class":1036,"line":1037},[1034,1857,1858],{"class":1040},"ticket.transition ",[1034,1860,1269],{"class":1047},[1034,1862,1067],{"class":1047},[1034,1864,1358],{"class":1057},[1034,1866,1061],{"class":1047},[1034,1868,1064],{"class":1047},[1034,1870,1067],{"class":1047},[1034,1872,1367],{"class":1070},[1034,1874,1061],{"class":1047},[1034,1876,1165],{"class":1047},[1034,1878,1067],{"class":1047},[1034,1880,1881],{"class":1057},"intent",[1034,1883,1061],{"class":1047},[1034,1885,1064],{"class":1047},[1034,1887,1067],{"class":1047},[1034,1889,1890],{"class":1070},"start",[1034,1892,1061],{"class":1047},[1034,1894,1165],{"class":1047},[1034,1896,1067],{"class":1047},[1034,1898,1899],{"class":1057},"actor_type",[1034,1901,1061],{"class":1047},[1034,1903,1064],{"class":1047},[1034,1905,1067],{"class":1047},[1034,1907,1160],{"class":1070},[1034,1909,1061],{"class":1047},[1034,1911,1165],{"class":1047},[1034,1913,1067],{"class":1047},[1034,1915,1916],{"class":1057},"actor_uuid",[1034,1918,1061],{"class":1047},[1034,1920,1064],{"class":1047},[1034,1922,1067],{"class":1047},[1034,1924,1925],{"class":1070},"\u003Cyou>",[1034,1927,1061],{"class":1047},[1034,1929,1324],{"class":1047},[1034,1931,1932,1934,1936,1938,1940,1942,1944,1946,1948,1950,1952,1954,1956,1958,1960,1962,1965,1967,1969,1971,1974,1976,1978,1980,1983,1985,1987,1989,1991,1993,1995,1997,1999,2001,2003,2005,2007,2009,2011,2013,2015,2017],{"class":1036,"line":1044},[1034,1933,1858],{"class":1040},[1034,1935,1269],{"class":1047},[1034,1937,1067],{"class":1047},[1034,1939,1358],{"class":1057},[1034,1941,1061],{"class":1047},[1034,1943,1064],{"class":1047},[1034,1945,1067],{"class":1047},[1034,1947,1367],{"class":1070},[1034,1949,1061],{"class":1047},[1034,1951,1165],{"class":1047},[1034,1953,1067],{"class":1047},[1034,1955,1881],{"class":1057},[1034,1957,1061],{"class":1047},[1034,1959,1064],{"class":1047},[1034,1961,1067],{"class":1047},[1034,1963,1964],{"class":1070},"resolve",[1034,1966,1061],{"class":1047},[1034,1968,1165],{"class":1047},[1034,1970,1067],{"class":1047},[1034,1972,1973],{"class":1057},"resolution",[1034,1975,1061],{"class":1047},[1034,1977,1064],{"class":1047},[1034,1979,1067],{"class":1047},[1034,1981,1982],{"class":1070},"Merged as PR #\u003Cn> (\u003Coid>)",[1034,1984,1061],{"class":1047},[1034,1986,1165],{"class":1047},[1034,1988,1067],{"class":1047},[1034,1990,1899],{"class":1057},[1034,1992,1061],{"class":1047},[1034,1994,1064],{"class":1047},[1034,1996,1067],{"class":1047},[1034,1998,1160],{"class":1070},[1034,2000,1061],{"class":1047},[1034,2002,1165],{"class":1047},[1034,2004,1067],{"class":1047},[1034,2006,1916],{"class":1057},[1034,2008,1061],{"class":1047},[1034,2010,1064],{"class":1047},[1034,2012,1067],{"class":1047},[1034,2014,1925],{"class":1070},[1034,2016,1061],{"class":1047},[1034,2018,1324],{"class":1047},[885,2020,2021,2022,2025,2026,1834,2028,903],{},"A pass is autonomous when the delivery's transitions show no ",[917,2023,2024],{},"actor_type: human"," entry between ",[917,2027,1533],{},[917,2029,1301],{},[905,2031,2033],{"id":2032},"when-it-stalls","When it stalls",[885,2035,2036,2037,2039],{},"Read the ledger before naming a cause: ",[917,2038,1655],{}," with evidence tells you what actually happened; the agent's narration does not.",[1559,2041,2042,2055],{},[1562,2043,2044],{},[1565,2045,2046,2049,2052],{},[1568,2047,2048],{},"Symptom",[1568,2050,2051],{},"What it usually is",[1568,2053,2054],{},"What to do",[1575,2056,2057,2081,2097,2123,2137,2150,2164],{},[1565,2058,2059,2068,2071],{},[1580,2060,2061,2064,2065],{},[917,2062,2063],{},"controller-list"," is empty right after ",[917,2066,2067],{},"software-delivery.begin",[1580,2069,2070],{},"controller schedule disabled",[1580,2072,2073,2076,2077,2080],{},[917,2074,2075],{},"staff.manage-actor-schedule"," with ",[917,2078,2079],{},"enable"," on the controller actor",[1565,2082,2083,2088,2091],{},[1580,2084,2085,2087],{},[917,2086,1541],{}," attempts climb, no lease ever runs",[1580,2089,2090],{},"no warm runner, or the execution profile's requirements do not match a warm runner",[1580,2092,2093,2096],{},[917,2094,2095],{},"data.runner.pool-status"," on the group; adopt a universal profile",[1565,2098,2099,2109,2115],{},[1580,2100,2101,2102,1830,2105,2108],{},"Delivery sits in ",[917,2103,2104],{},"publish_requested",[917,2106,2107],{},"git-delivery.list"," is empty",[1580,2110,2111,2112],{},"the session transitioned outside ",[917,2113,2114],{},"publish-request",[1580,2116,2117,1546,2120,2122],{},[917,2118,2119],{},"ticket.software-delivery.recovery-inspect",[917,2121,2114],{}," for the acknowledged head, then resume or abandon",[1565,2124,2125,2131,2134],{},[1580,2126,2127,2128,2130],{},"Attempt ",[917,2129,1639],{},", branch already at the right oid on the provider",[1580,2132,2133],{},"push recorded on the provider, not yet in the ledger",[1580,2135,2136],{},"wait for the lease to expire; the broker re-claims and verifies by reading the ref back",[1565,2138,2139,2144,2147],{},[1580,2140,2141,2143],{},[917,2142,1756],{}," for a long time while CI is green",[1580,2145,2146],{},"a reviewer session judged CI from a stale snapshot",[1580,2148,2149],{},"the next dispatch runs the gate; the gate waits for CI itself",[1565,2151,2152,2158,2161],{},[1580,2153,2154,2155],{},"Reviewer reports a tool call failed with ",[917,2156,2157],{},"Unknown workflow type: virtual.…",[1580,2159,2160],{},"a composition was re-versioned after the session launched",[1580,2162,2163],{},"nothing; the next dispatch carries the new version",[1565,2165,2166,2169,2172],{},[1580,2167,2168],{},"Session dies mid-step with a connection reset",[1580,2170,2171],{},"transient control-plane connectivity",[1580,2173,2174],{},"the controller re-dispatches within about 90 seconds and resumes the retained worktree",[885,2176,2177,2178,2180,2181,2184,2185,2188,2189,2076,2192,2195],{},"To stop a delivery: ",[917,2179,2119],{}," returns a snapshot digest and says whether ",[917,2182,2183],{},"recovery-abandon"," is allowed (only while no controller claim is live; release it with ",[917,2186,2187],{},"ticket.software-delivery.controller-claim-release"," first). Abandon with the cleanup acknowledgement, then ",[917,2190,2191],{},"ticket.git-work.complete",[917,2193,2194],{},"outcome: abandoned",". Nothing merged can be undone from here; revert in the repository.",[905,2197,2199],{"id":2198},"where-to-go-next","Where to go next",[928,2201,2202,2207,2212,2217],{},[931,2203,2204,2206],{},[888,2205,143],{"href":144}," — the lifecycle model and the evidence chain",[931,2208,2209,2211],{},[888,2210,612],{"href":613}," — wiring a repository and the provider-blind rules",[931,2213,2214,2216],{},[888,2215,699],{"href":596}," — agent-eligible capacity for sessions",[931,2218,2219,2221],{},[888,2220,261],{"href":630}," — sessions, seats, tokens and approvals",[2223,2224,2225],"style",{},"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 pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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);}",{"title":919,"searchDepth":1037,"depth":1044,"links":2227},[2228,2229,2230,2231,2232,2233,2234,2235],{"id":907,"depth":1044,"text":908},{"id":925,"depth":1044,"text":926},{"id":978,"depth":1044,"text":979},{"id":1250,"depth":1044,"text":1251},{"id":1553,"depth":1044,"text":1554},{"id":1804,"depth":1044,"text":1805},{"id":2032,"depth":1044,"text":2033},{"id":2198,"depth":1044,"text":2199},"How to use the coding agent — write a ticket it can implement, launch the delivery, watch it code, publish, review and merge on its own, and close the loop when it lands","md",null,{},{"icon":624},{"title":621,"description":2236},"A3OJm5s44GEe8H9cqTOHgXlw87_ZEBXYPPnoiu8HDTM",[2244,2246],{"title":616,"path":617,"stem":618,"description":2245,"icon":619,"children":-1},"Prepare a GitHub repository for Staff coding agents — platform registration, manifest files, and preflight before hosted ticket-to-PR delivery",{"title":626,"path":627,"stem":628,"description":2247,"icon":66,"children":-1},"A pattern for running one product with Staff actors. A manager, a product manager, an engineer, a reviewer, QA and a release manager work from tickets, humans approve merges and releases, and a support actor answers people in the product's chat",1790354057725]