@eir-labs/coltrane 0.5.1 → 0.7.2

package/institutions/quartet.json

@@ -0,0 +1,344 @@
+{
+  "institution": {
+    "slug": "quartet",
+    "name": "The Quartet",
+    "kind": "institution",
+    "laws": [
+      "Authority attaches to the chair, never to the incumbent. A named agent may act only within the capability grants of a chair it has been seated in; removing the agent from the chair removes the authority with it.",
+      "A capability grant names its objects exhaustively. A grant that names a standard, tool, or type the genome does not contain is a dead name and is refused at authoring time rather than resolved at dispatch.",
+      "Every chair states its mission and its obligations before an incumbent is seated. An office whose mission is inferred from its occupant's behaviour is not an office.",
+      "Lineage is cited or it is not claimed. An agent's name may be anchored in a forebear only where the record carries the forebear's identity and the primary or scholarly source the attributed disposition is documented in.",
+      "The institution exposes nothing to another institution except by contract."
+    ],
+    "sovereign": false
+  },
+  "organizations": [
+    {
+      "slug": "quartet-ensemble",
+      "name": "The Quartet Ensemble",
+      "charter": "The single operating organization of the Quartet institution. Its charter is to carry work through the institution's standards under the chair contracts defined here: to read a body of material to its declared boundary before deciding anything, to fix a direction and state what it excludes, to settle a structure before building, and to report at the end which of its own claims were checked and which were only reasoned about. The Ensemble ships no capability it has not been granted and claims no observation it did not make.",
+      "parent_org": null
+    }
+  ],
+  "agent_records": [
+    {
+      "slug": "john",
+      "name": "John",
+      "kind": "steve",
+      "is_institution": false,
+      "skill_slugs": [],
+      "status": "active",
+      "named_from_forebear": "coltrane-john",
+      "auth_user_id": null
+    },
+    {
+      "slug": "bill",
+      "name": "Bill",
+      "kind": "steve",
+      "is_institution": false,
+      "skill_slugs": [],
+      "status": "active",
+      "named_from_forebear": "evans-bill",
+      "auth_user_id": null
+    },
+    {
+      "slug": "miles",
+      "name": "Miles",
+      "kind": "steve",
+      "is_institution": false,
+      "skill_slugs": [],
+      "status": "active",
+      "named_from_forebear": "davis-miles",
+      "auth_user_id": null
+    }
+  ],
+  "org_members": [
+    {
+      "org_slug": "quartet-ensemble",
+      "agent_slug": "john"
+    },
+    {
+      "org_slug": "quartet-ensemble",
+      "agent_slug": "bill"
+    },
+    {
+      "org_slug": "quartet-ensemble",
+      "agent_slug": "miles"
+    }
+  ],
+  "chairs": [
+    {
+      "id": "quartet.chair.field-reader",
+      "institution_slug": "quartet",
+      "role": "field-reader",
+      "function": "SENSE",
+      "mission": "Read the material a piece of work sits in, to a boundary declared before the reading begins, and report what is present and what is absent with equal completeness. This chair takes no decision and produces no artefact; its product is a reading another chair can be held to.",
+      "required_skills": [],
+      "caps": [
+        {
+          "edge_type": "produced-by",
+          "scope": {
+            "institution": "quartet"
+          },
+          "expires": null
+        },
+        {
+          "grant": "dispatch",
+          "standards": [
+            "software-change-v1",
+            "product-design-v1"
+          ],
+          "expires": null
+        }
+      ],
+      "obligations": [
+        "State the boundary of the read in the output; an unstated boundary makes an incomplete read indistinguishable from a complete one.",
+        "Record the source locator for every retrieved fact.",
+        "Emit no scope, ranking, or recommendation \u2014 those belong to the direction-setter.",
+        "Hold only a read-only tool grant, and only for the duration of the seating."
+      ]
+    },
+    {
+      "id": "quartet.chair.direction-setter",
+      "institution_slug": "quartet",
+      "role": "direction-setter",
+      "function": "JUDGE",
+      "mission": "Fix what a piece of work is and state what it is not, from a reading and not from an intuition; and afterwards report whether what was built is what was fixed. This chair holds both convergences, so the same criteria bind the decision and the verdict.",
+      "required_skills": [],
+      "caps": [
+        {
+          "edge_type": "produced-by",
+          "scope": {
+            "institution": "quartet"
+          },
+          "expires": null
+        },
+        {
+          "grant": "dispatch",
+          "standards": [
+            "software-change-v1",
+            "product-design-v1"
+          ],
+          "expires": null
+        }
+      ],
+      "obligations": [
+        "State the criteria before applying them.",
+        "Record every alternative set aside, with its reason.",
+        "Do not re-decide the scope at verification time to make a failing result pass.",
+        "Separate what was checked from what was reasoned about, and return insufficient evidence where the evidence does not reach the question.",
+        "Do not perform the work this chair directs."
+      ]
+    },
+    {
+      "id": "quartet.chair.structure-builder",
+      "institution_slug": "quartet",
+      "role": "structure-builder",
+      "function": "CREATE",
+      "mission": "Settle the ordered structure a piece of work will be built through \u2014 checks before the changes they check \u2014 and then make the thing that structure implies, from the upstream record alone.",
+      "required_skills": [],
+      "preferred_skills": [
+        "structure-conformance"
+      ],
+      "supplies": {
+        "house-style": "Prose in the register of a standards document: complete sentences, no abbreviations, no first person, and no vocabulary internal to this institution. An identifier names what a thing is, not what it is for. A check is written before the change it checks and is named for the observation it makes. Where a convention is not stated here, it is not a convention."
+      },
+      "caps": [
+        {
+          "edge_type": "produced-by",
+          "scope": {
+            "institution": "quartet"
+          },
+          "expires": null
+        },
+        {
+          "grant": "dispatch",
+          "standards": [
+            "software-change-v1",
+            "product-design-v1"
+          ],
+          "expires": null
+        }
+      ],
+      "obligations": [
+        "Settle the structure before producing the artefact.",
+        "Order the check before the change it checks.",
+        "Do not widen the scope the direction-setter fixed.",
+        "Record every departure from the settled structure, with its reason, rather than revising the structure after the fact.",
+        "Hold no tool grant: the artefact is emitted as reviewable content and is never applied."
+      ]
+    },
+    {
+      "id": "quartet.chair.responsible-officer",
+      "institution_slug": "quartet",
+      "role": "responsible-officer",
+      "human": true,
+      "function": "JUDGE",
+      "mission": "Hold the office that commits the ensemble's work. This chair is held by a person, never a model agent: the incumbent reviews the sealed record a standard's approve chair presents and accepts or refuses it under their own name. A run that reaches this office unapproved waits; nothing ships on an absent yes. The office follows the duty-holder construct of safety-case regulation: accountability for an outcome attaches to a single, identifiable person.",
+      "required_skills": [],
+      "caps": [
+        {
+          "edge_type": "produced-by",
+          "scope": {
+            "institution": "quartet"
+          },
+          "expires": null
+        },
+        {
+          "grant": "dispatch",
+          "standards": [
+            "software-change-v1",
+            "product-design-v1"
+          ],
+          "expires": null
+        }
+      ],
+      "obligations": [
+        "Review the sealed outputs an approval presents before accepting them; an approval that does not cite what it reviewed is void.",
+        "Refuse rather than delegate the refusal: this office cannot be held by a model agent, and its verdict cannot be produced by one.",
+        "This chair ships UNASSIGNED. Seating it is the adopting organization's first governance act: the reader seats themselves."
+      ]
+    }
+  ],
+  "assignments": [
+    {
+      "id": "quartet.seat.field-reader",
+      "chair_id": "quartet.chair.field-reader",
+      "agent_slug": "john",
+      "org_slug": "quartet-ensemble",
+      "contract_caps": [],
+      "technique_evidence": [
+        {
+          "source": "tests/default_genome_quartet.test.ts",
+          "claim": "The agent loads from the genome with no domain pin and with a read-only, call-capped tool grant, which is the least authority a reading office needs; both properties are asserted deterministically on every run of the suite."
+        },
+        {
+          "source": "standards/software-change-v1.json, standards/product-design-v1.json",
+          "claim": "Both shipped standards compose with this agent seated in their reading chair, and every type named in those chair contracts resolves to a registered core or domain type at compose time."
+        }
+      ],
+      "witnessed_by": null
+    },
+    {
+      "id": "quartet.seat.direction-setter",
+      "chair_id": "quartet.chair.direction-setter",
+      "agent_slug": "miles",
+      "org_slug": "quartet-ensemble",
+      "contract_caps": [],
+      "technique_evidence": [
+        {
+          "source": "standards/software-change-v1.json, chairs frame-change and verify-change",
+          "claim": "One incumbent holds both the chair that fixes the criteria and the chair that applies them, and the phase graph binding the two is validated acyclic and free of forward references at compose time."
+        },
+        {
+          "source": "tests/default_genome_quartet.test.ts",
+          "claim": "The agent's disposition pair is distinct from those of the other two seats and it holds no mutating or executing tool grant; both are asserted deterministically in the suite."
+        }
+      ],
+      "witnessed_by": null
+    },
+    {
+      "id": "quartet.seat.structure-builder",
+      "chair_id": "quartet.chair.structure-builder",
+      "agent_slug": "bill",
+      "org_slug": "quartet-ensemble",
+      "contract_caps": [],
+      "technique_evidence": [
+        {
+          "source": "tests/skills_agent_carried.test.ts",
+          "claim": "The agent carries the structure-conformance technique on its own record; this chair fills its institution-bound hydration slot and leaves its gig-bound slot to the dispatch payload, asserted deterministically in the suite."
+        },
+        {
+          "source": "standards/software-change-v1.json, chairs plan-change and write-change",
+          "claim": "One incumbent holds both the chair that settles the structure and the chair that makes the artefact, so the departure from a plan is reported by the seat accountable for the plan; the ordering is fixed by the standard's phase graph."
+        }
+      ],
+      "witnessed_by": null
+    }
+  ],
+  "forebears": [
+    {
+      "slug": "coltrane-john",
+      "institution_slug": "quartet",
+      "name": "John Coltrane",
+      "domain": "modern jazz (tenor and soprano saxophone)",
+      "kind": "musician",
+      "what_taken": "Born 23 September 1926 in Hamlet, North Carolina; died 17 July 1967 in Huntington, New York. What the field-reader chair takes is the documented practice ethic: a single unresolved problem worked continuously until the material itself is exhausted. The evidence is the cycle-of-thirds substitutions applied systematically across the 1959 Atlantic sessions released as Giant Steps, and the sustained, systematic daily study Lewis Porter documents in John Coltrane: His Life and Music (University of Michigan Press, 1998), including Coltrane's work through Nicolas Slonimsky's Thesaurus of Scales and Melodic Patterns (1947). Nothing of the man's biography beyond this working disposition is claimed or carried."
+    },
+    {
+      "slug": "evans-bill",
+      "institution_slug": "quartet",
+      "name": "Bill Evans",
+      "domain": "modern jazz (piano)",
+      "kind": "musician",
+      "what_taken": "Born 16 August 1929 in Plainfield, New Jersey; died 15 September 1980 in New York City. What the structure-builder chair takes is the documented practice of harmonic construction: rootless left-hand voicings built interval by interval, and the layered self-scrutiny of Conversations with Myself (Verve, 1963), on which Evans overdubbed three simultaneous piano parts and answered his own lines. Evans stated the underlying discipline himself in Improvisation in Jazz, his liner note to Miles Davis's Kind of Blue (Columbia, 1959), where he compared the improviser's position to that of the Japanese brush painter working on a surface that permits no erasure \u2014 structure settled before the stroke. Nothing of the man's biography beyond this working disposition is claimed or carried."
+    },
+    {
+      "slug": "davis-miles",
+      "institution_slug": "quartet",
+      "name": "Miles Davis",
+      "domain": "modern jazz (trumpet, bandleading)",
+      "kind": "musician",
+      "what_taken": "Born 26 May 1926 in Alton, Illinois; died 28 September 1991 in Santa Monica, California. What the direction-setter chair takes is the documented practice of setting direction by subtraction. Bill Evans's liner note to Kind of Blue (Columbia, 1959) records that Davis conceived the settings only hours before the recording dates and arrived with sketches indicating to the group what was to be played \u2014 the direction fixed, the execution left to the players. The same disposition at longer range produced the serial abandonment of settled idioms across Birth of the Cool (Capitol, sessions 1949-1950), Kind of Blue (1959) and Bitches Brew (Columbia, 1970), documented in Ian Carr, Miles Davis: The Definitive Biography (revised edition, 1998). Nothing of the man's biography beyond this working disposition is claimed or carried."
+    }
+  ],
+  "lineage_edges": [
+    {
+      "institution_slug": "quartet",
+      "edge_type": "descends-from",
+      "from_node": "agent:john",
+      "to_node": "forebear:coltrane-john",
+      "kind": "attribution",
+      "source": {
+        "figure": "John Coltrane",
+        "lifespan": "23 September 1926 - 17 July 1967",
+        "recordings": [
+          "Giant Steps (Atlantic SD 1311, recorded 1959, released 1960)",
+          "A Love Supreme (Impulse! A-77, recorded 9 December 1964, released 1965)"
+        ],
+        "scholarship": "Lewis Porter, John Coltrane: His Life and Music (Ann Arbor: University of Michigan Press, 1998)",
+        "attributed_disposition": "exhaustive, continuous work on one unresolved problem",
+        "note": "A public historical figure. The attribution names a documented working disposition; it is not an endorsement, a likeness, or a claim on the person."
+      }
+    },
+    {
+      "institution_slug": "quartet",
+      "edge_type": "descends-from",
+      "from_node": "agent:bill",
+      "to_node": "forebear:evans-bill",
+      "kind": "attribution",
+      "source": {
+        "figure": "Bill Evans",
+        "lifespan": "16 August 1929 - 15 September 1980",
+        "recordings": [
+          "Conversations with Myself (Verve V6-8526, 1963)",
+          "Sunday at the Village Vanguard (Riverside RLP 376, recorded 25 June 1961)"
+        ],
+        "primary_text": "Bill Evans, 'Improvisation in Jazz', liner note to Miles Davis, Kind of Blue (Columbia CL 1355, 1959)",
+        "scholarship": "Peter Pettinger, Bill Evans: How My Heart Sings (New Haven: Yale University Press, 1998)",
+        "attributed_disposition": "structure settled before the stroke; construction interval by interval",
+        "note": "A public historical figure. The attribution names a documented working disposition; it is not an endorsement, a likeness, or a claim on the person."
+      }
+    },
+    {
+      "institution_slug": "quartet",
+      "edge_type": "descends-from",
+      "from_node": "agent:miles",
+      "to_node": "forebear:davis-miles",
+      "kind": "attribution",
+      "source": {
+        "figure": "Miles Davis",
+        "lifespan": "26 May 1926 - 28 September 1991",
+        "recordings": [
+          "Birth of the Cool (Capitol T 762; sessions 1949-1950)",
+          "Kind of Blue (Columbia CL 1355, 1959)",
+          "Bitches Brew (Columbia GP 26, 1970)"
+        ],
+        "primary_text": "Bill Evans, 'Improvisation in Jazz', liner note to Kind of Blue (Columbia CL 1355, 1959) \u2014 records that Davis arrived at the sessions with sketches conceived only hours before",
+        "scholarship": "Ian Carr, Miles Davis: The Definitive Biography (revised edition, 1998); Miles Davis with Quincy Troupe, Miles: The Autobiography (New York: Simon & Schuster, 1989)",
+        "attributed_disposition": "direction fixed by subtraction; execution left to the players",
+        "note": "A public historical figure. The attribution names a documented working disposition; it is not an endorsement, a likeness, or a claim on the person."
+      }
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eir-labs/coltrane",
-  "version": "0.5.1",
+  "version": "0.7.2",
   "description": "A methodology engine \u2014 a typed substrate for defining agents, composing multi-phase standards, dispatching gigs, and sealing every output to a content-addressed ledger. Ships as an MCP server.",
   "type": "module",
   "license": "Apache-2.0",
@@ -36,15 +36,33 @@
       "import": "./dist/src/index.js",
       "default": "./dist/src/index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./hosted_tools": {
+      "types": "./dist/src/hosted_tools.d.ts",
+      "import": "./dist/src/hosted_tools.js",
+      "default": "./dist/src/hosted_tools.js"
+    },
+    "./genome_store": {
+      "types": "./dist/src/genome_store.d.ts",
+      "import": "./dist/src/genome_store.js",
+      "default": "./dist/src/genome_store.js"
+    },
+    "./tool_surface": {
+      "types": "./dist/src/tool_surface.d.ts",
+      "import": "./dist/src/tool_surface.js",
+      "default": "./dist/src/tool_surface.js"
+    }
   },
   "files": [
     "dist/src",
     "agents",
     "standards",
+    "charts",
+    "venues",
     "skills",
     "domain_types",
     "core_types",
+    "institutions",
     "README.md",
     "LICENSE"
   ],
@@ -81,4 +99,4 @@
     "typescript": "^5.6.0",
     "vitest": "^3.0.0"
   }
-}
+}

package/skills/vercel-api/fixtures/error.json

@@ -0,0 +1,10 @@
+{
+  "id": "error-terminal-carries-logs",
+  "description": "A build that reaches ERROR fails, and carries the build log tail for the human to read.",
+  "input": { "polls": ["QUEUED", "BUILDING", "ERROR"], "max_polls": 24, "logs_tail": ["Type error: TS2322 in app/page.tsx"] },
+  "assertions": [
+    { "path": "terminal_state", "op": "equals", "value": "ERROR" },
+    { "path": "pass", "op": "equals", "value": false },
+    { "path": "deadline_exceeded", "op": "equals", "value": false }
+  ]
+}

package/skills/vercel-api/fixtures/ready.json

@@ -0,0 +1,10 @@
+{
+  "id": "ready-within-budget",
+  "description": "A build that reaches READY within the poll budget passes with no deadline and no logs tail.",
+  "input": { "polls": ["QUEUED", "INITIALIZING", "BUILDING", "READY"], "max_polls": 24 },
+  "assertions": [
+    { "path": "terminal_state", "op": "equals", "value": "READY" },
+    { "path": "pass", "op": "equals", "value": true },
+    { "path": "deadline_exceeded", "op": "equals", "value": false }
+  ]
+}

package/skills/vercel-api/fixtures/unsettled.json

@@ -0,0 +1,10 @@
+{
+  "id": "budget-spent-never-settled",
+  "description": "A build still BUILDING when the poll budget is spent is UNSETTLED with deadline_exceeded — the honest never-settled path, not a guessed READY.",
+  "input": { "polls": ["QUEUED", "BUILDING", "BUILDING"], "max_polls": 3 },
+  "assertions": [
+    { "path": "terminal_state", "op": "equals", "value": "UNSETTLED" },
+    { "path": "deadline_exceeded", "op": "equals", "value": true },
+    { "path": "pass", "op": "equals", "value": false }
+  ]
+}

package/skills/vercel-api/meta.json

@@ -0,0 +1,10 @@
+{
+  "slug": "vercel-api",
+  "version": 1,
+  "skill_type": "action",
+  "input_type": "branch-state",
+  "output_type": "deploy-verdict",
+  "determinism_ratio": 1.0,
+  "permission": { "tier": 0 },
+  "description": "The deterministic half of the deploy act: resolve a bounded sequence of Vercel readyState observations into one terminal deploy state (READY | ERROR | CANCELED | UNSETTLED), with the honest deadline_exceeded path when the poll budget is spent before a terminal state. Pure — the network I/O (POST /v13/deployments, GET /v6/deployments) is the agent's WebFetch grant; this code only resolves what those calls observed. The credentials are institution-bound hydration slots, never in the code."
+}

package/skills/vercel-api/skill.mjs

@@ -0,0 +1,63 @@
+// vercel-api — the deterministic half of the deploy act. Pure: input in, output out, no
+// I/O, no LLM, no network. determinism_ratio 1.0 (the code resolves the entire output).
+//
+// The engine has no subprocess or async-wait primitive, so the wait on a Vercel build is a
+// BOUNDED synchronous poll inside the deploy chair's own turn: the agent makes one
+// WebFetch GET /v6/deployments per iteration and collects the observed `readyState` values.
+// This function takes that sequence plus the poll budget and resolves the ONE terminal
+// deploy state — the logic that must be deterministic, not model-improvised:
+//
+//   input:  { polls: string[] (readyState per GET, in order),
+//             max_polls: number (the agent's turn ceiling),
+//             logs_tail?: string[] (tail of the build log, attached on failure) }
+//   output: { terminal_state, build_status, deadline_exceeded, pass, polls_used,
+//             logs_tail?, source }
+//
+// The terminal readyStates are READY, ERROR and CANCELED. pass is true only on READY. When
+// the budget is spent with no terminal observation the state is UNSETTLED and
+// deadline_exceeded is true — the honest never-settled path, made visible rather than a
+// guess that the build would have settled a few polls later. logs_tail rides along only on a
+// non-READY terminal (or the UNSETTLED give-up), so a passing verdict carries no noise.
+const TERMINAL = new Set(["READY", "ERROR", "CANCELED"]);
+
+export default function run(input) {
+  const polls = Array.isArray(input && input.polls) ? input.polls.map((s) => String(s)) : [];
+  const rawBudget = Number(input && input.max_polls);
+  const budget = Number.isFinite(rawBudget) && rawBudget > 0 ? Math.floor(rawBudget) : polls.length;
+  const logsTail = Array.isArray(input && input.logs_tail) ? input.logs_tail.map((s) => String(s)) : [];
+
+  // Walk the observations up to the budget, stopping at the first terminal readyState.
+  const window = polls.slice(0, budget);
+  let terminalIndex = -1;
+  for (let i = 0; i < window.length; i++) {
+    if (TERMINAL.has(window[i])) { terminalIndex = i; break; }
+  }
+
+  if (terminalIndex !== -1) {
+    const terminal_state = window[terminalIndex];
+    const pass = terminal_state === "READY";
+    const out = {
+      terminal_state,
+      build_status: terminal_state,
+      deadline_exceeded: false,
+      pass,
+      polls_used: terminalIndex + 1,
+      source: "skill://vercel-api@1",
+    };
+    // A failing terminal carries the build log tail; a passing one carries no noise.
+    if (!pass) out.logs_tail = logsTail;
+    return out;
+  }
+
+  // Budget spent with no terminal observation: the honest never-settled path.
+  const last = window.length > 0 ? window[window.length - 1] : "INITIALIZING";
+  return {
+    terminal_state: "UNSETTLED",
+    build_status: last,
+    deadline_exceeded: true,
+    pass: false,
+    polls_used: window.length,
+    logs_tail: logsTail,
+    source: "skill://vercel-api@1",
+  };
+}

package/standards/preview-deploy-v1.json

@@ -0,0 +1,89 @@
+{
+  "slug": "preview-deploy-v1",
+  "domain": "preview-deploy",
+  "status": "active",
+  "description": "The phone conducts, Vercel builds, the officer seals. Sense the branch HEAD → deploy it to a Vercel preview and wait on the build with a bounded in-turn poll → verify the terminal state. Three seams: the seat that senses the branch does not deploy, the seat that deploys reads the build it made, and the verdict is the honest terminal state — READY passes, a non-READY terminal fails with its logs, a spent poll budget is UNSETTLED. The branch commit is sensed independently rather than read out of the change-set, because a change-set carries diffs, never an applied commit. The deploy seat holds exactly one narrow WebFetch grant, the Vercel REST origin, and its credentials are institution-bound slots filled at seat time — never in the genome.",
+  "agent_slugs": [
+    "deploy-scout",
+    "deploy-agent"
+  ],
+  "phases": [
+    {
+      "name": "sense-branch",
+      "chairs": [
+        {
+          "role": "sense-branch",
+          "agent_slug": "deploy-scout",
+          "depends_on": [],
+          "input_contract": [
+            "change-set"
+          ],
+          "output_contract": [
+            "branch-state"
+          ],
+          "required_skills": []
+        }
+      ],
+      "intent": "Read the branch HEAD the verified change lives on and report the commit and branch the preview will build. The incoming change-set is provenance only — the commit is sensed directly, because a change-set carries diffs and rationale, not an applied commit. No deploy is made here."
+    },
+    {
+      "name": "deploy-branch",
+      "chairs": [
+        {
+          "role": "deploy-branch",
+          "agent_slug": "deploy-agent",
+          "depends_on": [
+            "sense-branch"
+          ],
+          "input_contract": [
+            "branch-state"
+          ],
+          "output_contract": [
+            "preview-deployment"
+          ],
+          "required_skills": [
+            "vercel-api"
+          ],
+          "supplies": {
+            "vercel_token": "env:VERCEL_TOKEN",
+            "vercel_team_id": "env:VERCEL_TEAM_ID"
+          }
+        }
+      ],
+      "intent": "Call POST /v13/deployments for a preview target against the sensed commit, then wait on the build with a bounded synchronous poll — one WebFetch GET /v6/deployments per iteration, capped by the turn budget, no subprocess — until a terminal readyState is observed or the budget is spent. Seal a preview-deployment either way, carrying the url, commit, branch, project id, deployment id, the last observed build_status and the protection mode. The Vercel token and team id enter here from the chair's supplies; the venue fills them from environment secrets."
+    },
+    {
+      "name": "verify-build",
+      "chairs": [
+        {
+          "role": "verify-build",
+          "agent_slug": "deploy-agent",
+          "depends_on": [
+            "deploy-branch"
+          ],
+          "input_contract": [
+            "preview-deployment"
+          ],
+          "output_contract": [
+            "deploy-verdict"
+          ],
+          "required_skills": [
+            "vercel-api"
+          ],
+          "supplies": {
+            "vercel_token": "env:VERCEL_TOKEN",
+            "vercel_team_id": "env:VERCEL_TEAM_ID"
+          }
+        }
+      ],
+      "intent": "Read the sealed preview-deployment and say whether the build settled. pass is true only on READY; a non-READY terminal (ERROR, CANCELED) fails and carries the build log tail; and when the poll budget was spent with no terminal readyState, the verdict is terminal_state UNSETTLED with deadline_exceeded true and pass false — the honest never-settled path, visible in the ledger rather than a guessed READY."
+    }
+  ],
+  "input_types": [
+    "change-set"
+  ],
+  "output_types": [
+    "preview-deployment",
+    "deploy-verdict"
+  ]
+}