@open-mercato/cezar 0.9.1 → 0.9.2

package/dist/release/stable.js

@@ -6,13 +6,12 @@
  *  thing that ever moves the `latest` dist-tag (spec
  *  `.ai/specs/2026-07-18-npm-preview-publish.md`, #482).
  *
- *  Two decisions live here so they stay unit-testable, side-effect-free, and
- *  name-agnostic (names come from the checked-out manifests, never constants):
- *  the next stable version for a given bump, and how both manifests are stamped.
- *  Crucially, the alias keeps a **caret** range on its scoped dependency — the
- *  opposite of the snapshot stamper's exact pin — so a stable `cezar-cli` picks
- *  up compatible patch releases of the implementation package.
+ *  Two decisions live here so they stay unit-testable and side-effect-free: the next stable
+ *  version for a given bump, and the pin style the release set is stamped with. Crucially,
+ *  stable releases use a **caret** range — the opposite of the snapshot stamper's exact pin —
+ *  so a stable `cezar-cli` picks up compatible patch releases of the implementation package.
  */
+import { stampManifestSet } from './manifests.js';
 export const RELEASE_BUMPS = ['patch', 'minor', 'major', 'existing'];
 export function isReleaseBump(value) {
     return RELEASE_BUMPS.includes(value);
@@ -42,27 +41,15 @@ export function computeStableVersion(bump, base) {
             return null;
     }
 }
-/** Stamp both manifests to a stable version.
+/** Stamp the release set to a stable version.
  *
- *  Mirror of `stampManifests` in `snapshot.ts`, but the alias's dependency on
- *  the scoped package is a **caret** range (`^0.1.6`), not an exact pin — a
- *  stable `cezar-cli` should follow compatible releases of the implementation
- *  package, whereas a snapshot must pin the one exact build it was cut from.
- *
- *  Like the snapshot stamper, the alias inherits `repository`/`homepage`/`bugs`
- *  from the root manifest: `--provenance` publishes are rejected (E422) unless
- *  the manifest's `repository.url` matches the building repo, and the alias file
- *  carries none of its own. The git URL already matches and survives any
- *  npm-name rename. */
-export function stampStableManifests(rootPkg, aliasPkg, version) {
-    const inherited = {};
-    for (const field of ['repository', 'homepage', 'bugs']) {
-        if (rootPkg[field] !== undefined)
-            inherited[field] = rootPkg[field];
-    }
-    return {
-        root: { ...rootPkg, version },
-        alias: { ...aliasPkg, ...inherited, version, dependencies: { [rootPkg.name]: `^${version}` } },
-    };
+ *  Mirror of `stampSnapshotManifests`, differing in exactly one decision: intra-release
+ *  dependencies get a **caret** range (`^0.1.6`), not an exact pin. A stable `cezar-cli` should
+ *  follow compatible releases of the implementation package, and a stable service should follow
+ *  compatible releases of the api-client; a snapshot must pin the one exact build it was cut
+ *  from. Everything else — which manifests exist, which sections carry the pin, what the alias
+ *  inherits — lives in `manifests.ts` so the two channels cannot drift apart. */
+export function stampStableManifests(manifests, version) {
+    return stampManifestSet(manifests, version, (v) => `^${v}`);
 }
 //# sourceMappingURL=stable.js.map

package/dist/release/stable.js.map

@@ -1 +1 @@
-{"version":3,"file":"stable.js","sourceRoot":"","sources":["../../src/release/stable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAE7F,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAQ,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;2DAM2D;AAC3D,MAAM,UAAU,oBAAoB,CAAC,IAAiB,EAAE,IAAY;IAClE,MAAM,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;QACtC,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC;QAC5B;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAUD;;;;;;;;;;;uBAWuB;AACvB,MAAM,UAAU,oBAAoB,CAClC,OAAqB,EACrB,QAAsB,EACtB,OAAe;IAEf,MAAM,SAAS,GAA0B,EAAE,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,CAAU,EAAE,CAAC;QAChE,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,SAAS;YAAE,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;QAC7B,KAAK,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,EAAE,EAAE;KAC/F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"stable.js","sourceRoot":"","sources":["../../src/release/stable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,gBAAgB,EAA+C,MAAM,gBAAgB,CAAC;AAO/F,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAE7F,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAQ,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;2DAM2D;AAC3D,MAAM,UAAU,oBAAoB,CAAC,IAAiB,EAAE,IAAY;IAClE,MAAM,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;QACtC,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC;QAC5B;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAID;;;;;;;iFAOiF;AACjF,MAAM,UAAU,oBAAoB,CAClC,SAA6B,EAC7B,OAAe;IAEf,OAAO,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/runs/auto-name.d.ts

@@ -1,4 +1,4 @@
-import { type TaskRefs } from './task-refs.js';
+import { type TaskRefs } from './task-refs.ts';
 /**
  * The one-shot LLM namer (spec 2026-07-17-task-auto-naming): turns a task's
  * INTENT — skill + arguments + prompt + PR/issue context, never the agent's

package/dist/runs/retention.d.ts

@@ -1,4 +1,4 @@
-import type { RunRecord } from './store.js';
+import type { RunRecord } from './store.ts';
 /** A run is reclaimable when it is finished, still has a materialized worktree
  *  directory, and has not already been reclaimed. */
 export declare function isReclaimable(run: RunRecord): boolean;

package/dist/runs/store.d.ts

@@ -13,46 +13,40 @@ export type StepStatus = 'pending' | 'running' | 'waiting' | 'review' | 'done' |
 declare const stepStateSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
-    kind: z.ZodEnum<["agent", "check"]>;
-    status: z.ZodEnum<["pending", "running", "waiting", "review", "done", "failed", "cancelled", "skipped"]>;
+    kind: z.ZodEnum<{
+        agent: "agent";
+        check: "check";
+    }>;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        pending: "pending";
+        review: "review";
+        running: "running";
+        skipped: "skipped";
+        waiting: "waiting";
+    }>;
     iterations: z.ZodNumber;
     tokensUsed: z.ZodNumber;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    usageInvocationsStarted: z.ZodOptional<z.ZodNumber>;
+    usageInvocationsObserved: z.ZodOptional<z.ZodNumber>;
+    usageTurnsStarted: z.ZodOptional<z.ZodNumber>;
+    usageTurnsRecorded: z.ZodOptional<z.ZodNumber>;
+    usageInvocationEpoch: z.ZodOptional<z.ZodNumber>;
     startedAt: z.ZodOptional<z.ZodString>;
     finishedAt: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
-    /** Latest backend-owned session id, used for same-backend Continue. */
     sessionId: z.ZodOptional<z.ZodString>;
-    /** Backend that owns `sessionId`. Optional so pre-affinity runs.json files still parse. */
-    backend: z.ZodOptional<z.ZodEnum<["claude", "codex", "opencode"]>>;
-    /** Dollar cost reported by the claude CLI for this step's turns. */
+    backend: z.ZodOptional<z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        opencode: "opencode";
+    }>>;
     costUsd: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    name: string;
-    kind: "agent" | "check";
-    status: "cancelled" | "done" | "failed" | "pending" | "review" | "running" | "skipped" | "waiting";
-    iterations: number;
-    tokensUsed: number;
-    startedAt?: string | undefined;
-    finishedAt?: string | undefined;
-    error?: string | undefined;
-    sessionId?: string | undefined;
-    backend?: "claude" | "codex" | "opencode" | undefined;
-    costUsd?: number | undefined;
-}, {
-    id: string;
-    name: string;
-    kind: "agent" | "check";
-    status: "cancelled" | "done" | "failed" | "pending" | "review" | "running" | "skipped" | "waiting";
-    iterations: number;
-    tokensUsed: number;
-    startedAt?: string | undefined;
-    finishedAt?: string | undefined;
-    error?: string | undefined;
-    sessionId?: string | undefined;
-    backend?: "claude" | "codex" | "opencode" | undefined;
-    costUsd?: number | undefined;
-}>;
+}, z.core.$strip>;
 /** One prompt message stacked onto a run while it waits for a free agent slot
  *  (#472). Folded into `{{task}}` at dequeue by `hydrateQueuedInput`; never
  *  delivered as its own turn — a follow-up turn would reach only the first step
@@ -60,365 +54,163 @@ declare const stepStateSchema: z.ZodObject<{
 declare const queuedMessageSchema: z.ZodObject<{
     id: z.ZodString;
     text: z.ZodString;
-    /** `/api/runs/:id/images/…` URLs — the base64 never enters `runs.json`. */
-    images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    images: z.ZodOptional<z.ZodArray<z.ZodString>>;
     createdAt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    text: string;
-    images?: string[] | undefined;
-    createdAt: string;
-}, {
-    id: string;
-    text: string;
-    images?: string[] | undefined;
-    createdAt: string;
-}>;
+}, z.core.$strip>;
 declare const runRecordSchema: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
-    /** Display title (#389): the auto-derived summary of the first agent turn,
-     *  or the user's inline edit (`PATCH /api/runs/:id` sets it together with
-     *  `title` so edits always win). The UI shows `titleSummary ?? title`. */
     titleSummary: z.ZodOptional<z.ZodString>;
-    /** `git diff --shortstat` of the worktree vs its base, refreshed on every
-     *  turn-end (#389) — what the quick list / table shows without a git call. */
     diffStat: z.ZodOptional<z.ZodObject<{
         adds: z.ZodNumber;
         dels: z.ZodNumber;
         files: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        adds: number;
-        dels: number;
-        files: number;
-    }, {
-        adds: number;
-        dels: number;
-        files: number;
-    }>>;
+        repointed: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
     workflow: z.ZodString;
     task: z.ZodString;
-    /** Prompt messages stacked onto this run while it was queued (#472). Optional:
-     *  `undefined` on every pre-#472 record reads as an empty stack. Like `task`,
-     *  `text` is the user's own prompt and is replayed into `{{task}}`, so it is
-     *  deliberately NOT in `redactPatch`'s field list — scrubbing it would corrupt
-     *  the run the same way scrubbing `task` would. */
     queuedMessages: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         text: z.ZodString;
-        /** `/api/runs/:id/images/…` URLs — the base64 never enters `runs.json`. */
-        images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        images: z.ZodOptional<z.ZodArray<z.ZodString>>;
         createdAt: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        text: string;
-        images?: string[] | undefined;
-        createdAt: string;
-    }, {
-        id: string;
-        text: string;
-        images?: string[] | undefined;
-        createdAt: string;
-    }>, "many">>;
-    /** URLs of images attached to the initial task prompt, for the thread's first bubble
-     *  (#image-display) — persisted like agent screenshots, served from `/images/`. */
-    taskImages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.core.$strip>>>;
+    taskImages: z.ZodOptional<z.ZodArray<z.ZodString>>;
     model: z.ZodOptional<z.ZodString>;
-    /** Canonical provider/model identity (#405) — the normalised `provider/model`
-     *  (e.g. `anthropic/claude-opus-4-8`) the run actually used, resolved from the
-     *  free-text `model` against the chosen runner. Additive and optional: pre-#405
-     *  records carry only `model`, and it stays the human/hand-edit surface; this
-     *  is the parseable identity cost attribution and reproducible replay key off. */
     modelIdentity: z.ZodOptional<z.ZodString>;
-    /** Agent backend this run used — drives "open in CLI" resume command. */
-    runner: z.ZodOptional<z.ZodEnum<["claude", "codex", "opencode"]>>;
-    /** Echo of the extra system prompt this run actually used (R2): the
-     *  `POST /api/runs` override, or the `config.json` default it fell back to.
-     *  Deliberately NOT the full composed prompt — skill bodies and the handoff
-     *  contract are derivable from the persisted workflow and would bloat the
-     *  index. Resolved at execute time (a queued run picks up config edits). */
+    runner: z.ZodOptional<z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        opencode: "opencode";
+    }>>;
     systemPrompt: z.ZodOptional<z.ZodString>;
-    /** Per-task follow-up inbox contract (spec 007, #444). Missing on old runs
-     *  means enabled — the historical behavior. */
     generateFollowups: z.ZodOptional<z.ZodBoolean>;
-    /** Autonomous mode (#489): the run was started with the "autonomous" checkbox,
-     *  so it never parks at `waiting` (auto-nudge) and — once persisted here —
-     *  never parks at the terminal `review` gate either (`settleSuccess` + the
-     *  group-pick winner-park read it). Additive-safe: absent = falsy = not
-     *  autonomous. Set at creation from `WorkflowInput.autonomous`. */
     autonomous: z.ZodOptional<z.ZodBoolean>;
-    status: z.ZodEnum<["queued", "running", "waiting", "review", "done", "failed", "cancelled"]>;
-    /** Sub-state of `running` (spec 2026-07-18-subagent-monitoring-status, #490):
-     *  `monitoring` while the agent is still working on its own downstream work.
-     *  Optional/absent on old runs; cleared when the run resumes or ends. */
-    activity: z.ZodOptional<z.ZodEnum<["monitoring"]>>;
+    automation: z.ZodOptional<z.ZodObject<{
+        automationId: z.ZodString;
+        automationRevision: z.ZodNumber;
+        receiptId: z.ZodString;
+        event: z.ZodString;
+        githubUrl: z.ZodString;
+    }, z.core.$strip>>;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        queued: "queued";
+        review: "review";
+        running: "running";
+        waiting: "waiting";
+    }>;
+    activity: z.ZodOptional<z.ZodEnum<{
+        monitoring: "monitoring";
+    }>>;
+    monitoringWakeAt: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    monitoringWakeCapReached: z.ZodOptional<z.ZodBoolean>;
     createdAt: z.ZodString;
     startedAt: z.ZodOptional<z.ZodString>;
     finishedAt: z.ZodOptional<z.ZodString>;
     tokensUsed: z.ZodNumber;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
     costUsd: z.ZodOptional<z.ZodNumber>;
-    /** First GitHub PR URL spotted in the transcript (the janitor trick). */
     pullRequestUrl: z.ZodOptional<z.ZodString>;
-    /** The PR this task is ABOUT (#407, spec 2026-07-16-pr-autodiscovery):
-     *  auto-discovered from conversation references for tasks that work on an
-     *  existing PR (review/continue/merge). Display-only tier — `pullRequestUrl`
-     *  (the PR this task CREATED) always wins, and action gates ignore this. */
     referencedPullRequestUrl: z.ZodOptional<z.ZodString>;
-    /** The PR/issue number this task is ABOUT (spec 2026-07-17-task-auto-naming):
-     *  regex-extracted from the task prompt, upgradable by the namer's
-     *  cross-checked output. Display tier — never gates actions. */
     prNumber: z.ZodOptional<z.ZodNumber>;
     issueNumber: z.ZodOptional<z.ZodNumber>;
-    /** Provenance for an `issueNumber` seeded by referenced-issue discovery.
-     *  Persisted so ambiguity can revoke only the janitor's own value, including
-     *  after a restart. Any prompt, namer, or marker write clears this flag. */
     referencedIssueNumberSeeded: z.ZodOptional<z.ZodBoolean>;
-    /** Who owns the display title: `user` (PATCH rename — never auto-overwritten),
-     *  `marker` (agent-declared via `CEZ:TITLE`, spec 2026-07-18-task-ref-markers —
-     *  beats the namer, silences live refresh) or `auto` (namer-owned — a later
-     *  namer result may replace it). Missing on old runs = legacy behavior (auto
-     *  fills only an unset titleSummary). Precedence: user > marker > auto. */
-    titleOrigin: z.ZodOptional<z.ZodEnum<["user", "auto", "marker"]>>;
-    /** References the agent itself declared via `CEZ:PR=` / `CEZ:ISSUE=` markers
-     *  (spec 2026-07-18-task-ref-markers). Presence of a kind makes it
-     *  authoritative: the namer may no longer write that kind, and a declared PR
-     *  owns the referenced tier's resolution. */
+    titleOrigin: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        marker: "marker";
+        user: "user";
+    }>>;
     markerRefs: z.ZodOptional<z.ZodObject<{
         pr: z.ZodOptional<z.ZodNumber>;
         issue: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        pr?: number | undefined;
-        issue?: number | undefined;
-    }, {
-        pr?: number | undefined;
-        issue?: number | undefined;
-    }>>;
-    /** Distinct PR URLs spotted so far — the referenced tier's working set,
-     *  persisted so a resumed run keeps disambiguating against the full history
-     *  instead of re-adopting the next URL as "the only one". Capped. */
-    referencedPrCandidates: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    /** The issue this task is ABOUT (spec 2026-07-21-report-ref-discovery):
-     *  auto-discovered from `github.com/…/issues/N` links in the conversation,
-     *  mirroring the referenced-PR tier. Display-only; never gates actions. */
+    }, z.core.$strip>>;
+    referencedPrCandidates: z.ZodOptional<z.ZodArray<z.ZodString>>;
     referencedIssueUrl: z.ZodOptional<z.ZodString>;
-    /** Distinct issue URLs spotted so far — the referenced-issue working set,
-     *  persisted like `referencedPrCandidates`. Capped. */
-    referencedIssueCandidates: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    /** Task worktree (spec 006) — absent when the run executed in the repo root. */
+    referencedIssueCandidates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    worktree: z.ZodOptional<z.ZodLiteral<false>>;
     worktreePath: z.ZodOptional<z.ZodString>;
-    /** The task's own branch (`cez/<id8>`), created off `baseBranch`. */
     branch: z.ZodOptional<z.ZodString>;
-    /** Branch (or commit, when HEAD was detached) the worktree was forked from. */
     baseBranch: z.ZodOptional<z.ZodString>;
-    /** Set when count-based retention (#483) reclaimed this run's worktree
-     *  *directory* (the `cez/<id8>` branch is kept). Presence means "materialized
-     *  dir gone, recoverable via `git worktree add`"; it excludes the run from the
-     *  retention budget until the dir is re-materialized (resume clears it). */
     worktreeReclaimedAt: z.ZodOptional<z.ZodString>;
-    /** Parallel variants (spec 010): tasks sharing a groupId are one group. */
     groupId: z.ZodOptional<z.ZodString>;
-    /** Variant letter within the group — 'A' | 'B' | 'C' (kept as a string). */
     variant: z.ZodOptional<z.ZodString>;
-    /** Peak resident memory (bytes) / process count observed across the run's
-     *  agent process trees (#348) — written when a session's telemetry ends.
-     *  Optional: old runs.json files and `ps`-less platforms have neither. */
     peakRssBytes: z.ZodOptional<z.ZodNumber>;
     peakProcCount: z.ZodOptional<z.ZodNumber>;
     archived: z.ZodDefault<z.ZodBoolean>;
     archivedAt: z.ZodOptional<z.ZodString>;
+    seenAt: z.ZodOptional<z.ZodString>;
     currentStepId: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
     steps: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
-        kind: z.ZodEnum<["agent", "check"]>;
-        status: z.ZodEnum<["pending", "running", "waiting", "review", "done", "failed", "cancelled", "skipped"]>;
+        kind: z.ZodEnum<{
+            agent: "agent";
+            check: "check";
+        }>;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            pending: "pending";
+            review: "review";
+            running: "running";
+            skipped: "skipped";
+            waiting: "waiting";
+        }>;
         iterations: z.ZodNumber;
         tokensUsed: z.ZodNumber;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        usageInvocationsStarted: z.ZodOptional<z.ZodNumber>;
+        usageInvocationsObserved: z.ZodOptional<z.ZodNumber>;
+        usageTurnsStarted: z.ZodOptional<z.ZodNumber>;
+        usageTurnsRecorded: z.ZodOptional<z.ZodNumber>;
+        usageInvocationEpoch: z.ZodOptional<z.ZodNumber>;
         startedAt: z.ZodOptional<z.ZodString>;
         finishedAt: z.ZodOptional<z.ZodString>;
         error: z.ZodOptional<z.ZodString>;
-        /** Latest backend-owned session id, used for same-backend Continue. */
         sessionId: z.ZodOptional<z.ZodString>;
-        /** Backend that owns `sessionId`. Optional so pre-affinity runs.json files still parse. */
-        backend: z.ZodOptional<z.ZodEnum<["claude", "codex", "opencode"]>>;
-        /** Dollar cost reported by the claude CLI for this step's turns. */
+        backend: z.ZodOptional<z.ZodEnum<{
+            claude: "claude";
+            codex: "codex";
+            opencode: "opencode";
+        }>>;
         costUsd: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        name: string;
-        kind: "agent" | "check";
-        status: "cancelled" | "done" | "failed" | "pending" | "review" | "running" | "skipped" | "waiting";
-        iterations: number;
-        tokensUsed: number;
-        startedAt?: string | undefined;
-        finishedAt?: string | undefined;
-        error?: string | undefined;
-        sessionId?: string | undefined;
-        backend?: "claude" | "codex" | "opencode" | undefined;
-        costUsd?: number | undefined;
-    }, {
-        id: string;
-        name: string;
-        kind: "agent" | "check";
-        status: "cancelled" | "done" | "failed" | "pending" | "review" | "running" | "skipped" | "waiting";
-        iterations: number;
-        tokensUsed: number;
-        startedAt?: string | undefined;
-        finishedAt?: string | undefined;
-        error?: string | undefined;
-        sessionId?: string | undefined;
-        backend?: "claude" | "codex" | "opencode" | undefined;
-        costUsd?: number | undefined;
-    }>, "many">;
-    /** Full workflow definition, persisted so a `queued` run can be re-enqueued
-     *  after a restart (#367) — including ad-hoc "(planned)" chains that exist
-     *  nowhere else. Kept loose here to avoid an upward import; the run manager
-     *  validates the shape before reviving it. */
-    workflowDef: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    title: string;
-    titleSummary?: string | undefined;
-    diffStat?: {
-        adds: number;
-        dels: number;
-        files: number;
-    } | undefined;
-    workflow: string;
-    task: string;
-    queuedMessages?: {
-        id: string;
-        text: string;
-        images?: string[] | undefined;
-        createdAt: string;
-    }[] | undefined;
-    taskImages?: string[] | undefined;
-    model?: string | undefined;
-    modelIdentity?: string | undefined;
-    runner?: "claude" | "codex" | "opencode" | undefined;
-    systemPrompt?: string | undefined;
-    generateFollowups?: boolean | undefined;
-    autonomous?: boolean | undefined;
-    status: "cancelled" | "done" | "failed" | "queued" | "review" | "running" | "waiting";
-    activity?: "monitoring" | undefined;
-    createdAt: string;
-    startedAt?: string | undefined;
-    finishedAt?: string | undefined;
-    tokensUsed: number;
-    costUsd?: number | undefined;
-    pullRequestUrl?: string | undefined;
-    referencedPullRequestUrl?: string | undefined;
-    prNumber?: number | undefined;
-    issueNumber?: number | undefined;
-    referencedIssueNumberSeeded?: boolean | undefined;
-    titleOrigin?: "auto" | "marker" | "user" | undefined;
-    markerRefs?: {
-        pr?: number | undefined;
-        issue?: number | undefined;
-    } | undefined;
-    referencedPrCandidates?: string[] | undefined;
-    referencedIssueUrl?: string | undefined;
-    referencedIssueCandidates?: string[] | undefined;
-    worktreePath?: string | undefined;
-    branch?: string | undefined;
-    baseBranch?: string | undefined;
-    worktreeReclaimedAt?: string | undefined;
-    groupId?: string | undefined;
-    variant?: string | undefined;
-    peakRssBytes?: number | undefined;
-    peakProcCount?: number | undefined;
-    archived: boolean;
-    archivedAt?: string | undefined;
-    currentStepId?: string | undefined;
-    error?: string | undefined;
-    steps: {
-        id: string;
-        name: string;
-        kind: "agent" | "check";
-        status: "cancelled" | "done" | "failed" | "pending" | "review" | "running" | "skipped" | "waiting";
-        iterations: number;
-        tokensUsed: number;
-        startedAt?: string | undefined;
-        finishedAt?: string | undefined;
-        error?: string | undefined;
-        sessionId?: string | undefined;
-        backend?: "claude" | "codex" | "opencode" | undefined;
-        costUsd?: number | undefined;
-    }[];
-    workflowDef?: Record<string, unknown> | undefined;
-}, {
-    id: string;
-    title: string;
-    titleSummary?: string | undefined;
-    diffStat?: {
-        adds: number;
-        dels: number;
-        files: number;
-    } | undefined;
-    workflow: string;
-    task: string;
-    queuedMessages?: {
-        id: string;
-        text: string;
-        images?: string[] | undefined;
-        createdAt: string;
-    }[] | undefined;
-    taskImages?: string[] | undefined;
-    model?: string | undefined;
-    modelIdentity?: string | undefined;
-    runner?: "claude" | "codex" | "opencode" | undefined;
-    systemPrompt?: string | undefined;
-    generateFollowups?: boolean | undefined;
-    autonomous?: boolean | undefined;
-    status: "cancelled" | "done" | "failed" | "queued" | "review" | "running" | "waiting";
-    activity?: "monitoring" | undefined;
-    createdAt: string;
-    startedAt?: string | undefined;
-    finishedAt?: string | undefined;
-    tokensUsed: number;
-    costUsd?: number | undefined;
-    pullRequestUrl?: string | undefined;
-    referencedPullRequestUrl?: string | undefined;
-    prNumber?: number | undefined;
-    issueNumber?: number | undefined;
-    referencedIssueNumberSeeded?: boolean | undefined;
-    titleOrigin?: "auto" | "marker" | "user" | undefined;
-    markerRefs?: {
-        pr?: number | undefined;
-        issue?: number | undefined;
-    } | undefined;
-    referencedPrCandidates?: string[] | undefined;
-    referencedIssueUrl?: string | undefined;
-    referencedIssueCandidates?: string[] | undefined;
-    worktreePath?: string | undefined;
-    branch?: string | undefined;
-    baseBranch?: string | undefined;
-    worktreeReclaimedAt?: string | undefined;
-    groupId?: string | undefined;
-    variant?: string | undefined;
-    peakRssBytes?: number | undefined;
-    peakProcCount?: number | undefined;
-    archived?: boolean | undefined;
-    archivedAt?: string | undefined;
-    currentStepId?: string | undefined;
-    error?: string | undefined;
-    steps: {
-        id: string;
-        name: string;
-        kind: "agent" | "check";
-        status: "cancelled" | "done" | "failed" | "pending" | "review" | "running" | "skipped" | "waiting";
-        iterations: number;
-        tokensUsed: number;
-        startedAt?: string | undefined;
-        finishedAt?: string | undefined;
-        error?: string | undefined;
-        sessionId?: string | undefined;
-        backend?: "claude" | "codex" | "opencode" | undefined;
-        costUsd?: number | undefined;
-    }[];
-    workflowDef?: Record<string, unknown> | undefined;
-}>;
+    }, z.core.$strip>>;
+    workflowDef: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+            skill: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            runner: z.ZodOptional<z.ZodEnum<{
+                claude: "claude";
+                codex: "codex";
+                opencode: "opencode";
+            }>>;
+            allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            command: z.ZodOptional<z.ZodString>;
+            onFail: z.ZodOptional<z.ZodObject<{
+                retry: z.ZodString;
+                max: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        source: z.ZodEnum<{
+            "built-in": "built-in";
+            file: "file";
+        }>;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export type StepState = z.infer<typeof stepStateSchema>;
 export type QueuedMessage = z.infer<typeof queuedMessageSchema>;
 export type RunRecord = z.infer<typeof runRecordSchema>;
@@ -460,6 +252,7 @@ export declare class RunStore extends EventEmitter {
         runner?: 'claude' | 'codex' | 'opencode';
         generateFollowups?: boolean;
         autonomous?: boolean;
+        worktree?: false;
         groupId?: string;
         variant?: string;
         steps: Array<Pick<StepState, 'id' | 'name' | 'kind'>>;
@@ -494,6 +287,19 @@ export declare class RunStore extends EventEmitter {
     setArchived(id: string, archived: boolean): RunRecord | undefined;
     /** Bulk-archive every finished run; returns how many were archived. */
     archiveFinished(): number;
+    /** Mark one run as read (#unread-done-items): stamp the read receipt now. Mirrors
+     *  `setArchived` — sets the field then persists + broadcasts via `touch`, so the
+     *  updated record rides the existing `run` SSE with no new event. Idempotent by
+     *  design: opening an already-read thread just re-stamps a later `seenAt`. */
+    setRead(id: string): RunRecord | undefined;
+    /** Bulk mark-read: stamp every currently-unread finished run; returns the count.
+     *  "Unread" here is the same rule the cockpit paints (`isUnread` in read-state.ts),
+     *  clause for clause: a `done` or `failed` run that finished and has not been seen
+     *  since. Cancelled runs are never unread — you stopped them yourself — and archived
+     *  ones never are either, since archiving is a stronger "done with this" than reading;
+     *  both are skipped, as are runs already read. Keeping the two rules identical is what
+     *  makes the returned count the number the cockpit's unread badge was showing. */
+    markAllRead(): number;
     appendEvent(runId: string, event: {
         type: string;
         stepId?: string;