{
  "id": "layer:13-orchestration",
  "_kind": "Layer",
  "_file": "stack-layers/layers/layer-13-orchestration.yaml",
  "_cluster": "stack-layers",
  "attributes": {
    "displayName": "Orchestration",
    "position": 13,
    "path": "control",
    "scope": "Control-plane primitives and policies that coordinate agent work, multi-agent workflows, durable runs, and task execution lifecycles.",
    "summary": "The orchestration layer owns the control plane for agent work. It models how\ntasks are dispatched, sequenced, fanned out, handed off, retried,\nreconciled, budgeted, paused, resumed, validated, and completed. It covers\nagent selection, queueing, workspace lifecycle, run journals, state replay,\nhuman-review gates, auto-merge gates, cost controls, health checks,\nfailover, and multi-agent coordination.\n\nUser-facing commands and buttons that invoke orchestration remain\ninteraction primitives on `layer:10-interaction`; the control-plane action\nthey trigger is an `OrchestrationPrimitive` on this layer.\n",
    "responsibilities": [
      "Dispatch, schedule, route, and coordinate single-agent and multi-agent work.",
      "Manage run/session/task lifecycle, state replay, reconciliation, and durable resume.",
      "Enforce retry, budget, approval, validation, and failover policies during execution.",
      "Coordinate workspace creation, cleanup, snapshotting, and handoff.",
      "Emit progress, audit, and telemetry events for governance and observability."
    ],
    "examples": [
      "Sequential, concurrent, handoff, group-chat, supervisor, router, and fan-out/fan-in patterns.",
      "Babysitter run iteration, task effects, breakpoints, completion proof, and journal replay.",
      "LangGraph/agent-framework workflow graphs, human review gates, and durable checkpoints.",
      "Agent dispatch, retry with backoff, budget stop, workspace snapshot, result validation."
    ],
    "fitNotes": "If the primitive manages agent work rather than merely exposing a UI action,\nmodel it here. Interaction surfaces can trigger orchestration but do not own\norchestration semantics.\n"
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "orch-primitive:agent-dispatch",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:multi-agent-dispatch",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:task-create",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:task-assign",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:task-complete",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:workspace-create",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:workspace-cleanup",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:poll-tick",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:reconciliation",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:retry-with-backoff",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:concurrency-control",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:workflow-policy-load",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:progress-stream",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:approval-gate",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:budget-stop",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:session-handoff",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:pr-creation",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:branch-management",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:cost-tracking",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:audit-trail",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:agent-health-check",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:dependency-resolution",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:priority-queue",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:rollback",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:notification",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:issue-tracker-sync",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:agent-selection",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:context-injection",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:result-validation",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:human-review-gate",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:auto-merge",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:cost-budget-allocation",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:agent-failover",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:workspace-snapshot",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:telemetry-collection",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:babysitter-run-create",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:babysitter-run-iterate",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:babysitter-effect-request",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:babysitter-effect-resolution",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:babysitter-breakpoint-gate",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:babysitter-completion-proof",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "orch-primitive:babysitter-harness-dispatch",
      "to": "layer:13-orchestration",
      "kind": "realizes",
      "attributes": {}
    }
  ]
}