@wjarka/cezarion 0.10.0-pr30.54

package/dist/contract/index.js

@@ -0,0 +1,1895 @@
+// ../contract/src/events.ts
+import { z } from "zod";
+var runEventSchema = z.looseObject({
+  seq: z.number(),
+  ts: z.string(),
+  stepId: z.string().optional(),
+  type: z.string()
+});
+var RUN_HISTORY_PAGE_ITEMS = 100;
+var runIdParamSchema = z.object({
+  id: z.string().min(1).max(128).regex(/^[A-Za-z0-9._-]+$/)
+});
+var runHistoryCursorSchema = z.string().min(1).max(2048);
+var runHistoryQuerySchema = z.object({
+  cursor: runHistoryCursorSchema.optional()
+});
+var runEventsQuerySchema = z.object({
+  cursor: runHistoryCursorSchema.optional(),
+  afterSeq: z.coerce.number().int().nonnegative().optional()
+});
+var runHistoryEventSchema = z.object({
+  seq: z.number(),
+  ts: z.string(),
+  stepId: z.string().optional(),
+  type: z.string()
+}).catchall(z.any());
+var runHistoryPageSchema = z.object({
+  events: z.array(runHistoryEventSchema),
+  itemCount: z.number().int().min(0).max(RUN_HISTORY_PAGE_ITEMS),
+  olderCursor: runHistoryCursorSchema.optional(),
+  newerCursor: runHistoryCursorSchema.optional(),
+  liveCursor: runHistoryCursorSchema,
+  asOfSeq: z.number().int().nonnegative(),
+  hasOlder: z.boolean()
+});
+var runHistoryContextSchema = z.object({
+  contextEvents: z.array(runHistoryEventSchema),
+  asOfSeq: z.number().int().nonnegative()
+});
+var checkoutProgressEventSchema = z.object({
+  checkoutId: z.string().optional(),
+  name: z.string(),
+  phase: z.enum(["cloning", "done", "error"]),
+  line: z.string().optional(),
+  error: z.string().optional()
+});
+
+// ../contract/src/health.ts
+import { z as z2 } from "zod";
+var runnerSchema = z2.enum(["claude", "codex", "opencode", "pi"]);
+var repoInfoSchema = z2.object({
+  root: z2.string(),
+  branch: z2.string(),
+  remote: z2.string().optional()
+});
+var backendCheckSchema = z2.object({
+  name: z2.enum(["claude", "codex", "opencode", "pi", "gh", "git"]),
+  available: z2.boolean(),
+  version: z2.string().optional(),
+  hint: z2.string().optional()
+});
+var forgeInfoSchema = z2.object({
+  kind: z2.literal("github"),
+  /**
+   * Whether the forge is reachable — **absent until the availability probe has warmed**.
+   *
+   * Health must never pay a `gh` shell-out, so it serves whatever the cache holds. Absent means
+   * "not determined yet", which is not the same as `false`, and the cockpit renders the two
+   * differently. Declaring it required is what made an earlier hand-written mirror wrong.
+   */
+  available: z2.boolean().optional(),
+  reason: z2.string().optional()
+});
+var capabilitiesSchema = z2.object({
+  localHandoff: z2.boolean(),
+  followups: z2.boolean(),
+  singleProject: z2.boolean(),
+  /**
+   * `true` means `CEZ_AUTOMATIONS=1` opted this server into GitHub automations (#801). Off — the
+   * default — the whole feature is absent: no `Automations` nav item anywhere it is rendered, the
+   * `/api/v1/…/automations*` family answers `409`, and the workspace scheduler never polls GitHub.
+   *
+   * REQUIRED for the same reason as `tokenMetrics` below: this server always sends it.
+   */
+  automations: z2.boolean(),
+  /**
+   * `false` means `CEZ_HIDE_TOKEN_METRICS=1` asks the browser to omit token counts and monetary
+   * cost (#481). The telemetry itself still rides in run/event payloads — this is presentation
+   * only.
+   *
+   * REQUIRED, because this server always sends it (`capabilities.ts` computes it from the env on
+   * every read) and this contract describes THIS server's wire. The DTO it replaces declared it
+   * optional so a newer cockpit could read an OLDER server, which is version skew a contract
+   * versioned in lockstep with the server cannot model. That tolerance lives where it belongs, in
+   * `web/src/lib/token-metrics.ts`, whose `!== false` read still treats an absent field as
+   * visible.
+   */
+  tokenMetrics: z2.boolean(),
+  /** Current token-count presentation policy. Required on current servers;
+   * older payload tolerance belongs in the browser resolver. */
+  tokenUsageMetrics: z2.boolean(),
+  /** Current backend-reported-cost presentation policy. */
+  costMetrics: z2.boolean()
+});
+var healthResponseSchema = z2.object({
+  version: z2.string(),
+  latestVersion: z2.string().optional(),
+  repoRoot: z2.string(),
+  repo: repoInfoSchema.nullable(),
+  checks: z2.array(backendCheckSchema),
+  defaultRunner: runnerSchema,
+  forge: forgeInfoSchema.nullable(),
+  capabilities: capabilitiesSchema,
+  // Always sent: `workspaceSummary()` returns both unconditionally, and an unreadable workspace
+  // degrades to `projects: []` rather than to an absent key. The hand-written DTO declared them
+  // optional, which was wider than the server has ever been.
+  projects: z2.array(z2.object({ id: z2.string(), name: z2.string() })),
+  bootProject: z2.string()
+});
+
+// ../contract/src/runs.ts
+import { z as z5 } from "zod";
+
+// ../contract/src/github.ts
+import { z as z3 } from "zod";
+var checksGlyphSchema = z3.enum(["passing", "failing", "pending"]).nullable();
+var githubItemSchema = z3.object({
+  kind: z3.enum(["issue", "pr"]),
+  number: z3.number(),
+  title: z3.string(),
+  author: z3.string(),
+  createdAt: z3.string(),
+  labels: z3.array(z3.string()),
+  body: z3.string(),
+  url: z3.string(),
+  comments: z3.number(),
+  /** PRs only. */
+  isDraft: z3.boolean().optional(),
+  additions: z3.number().optional(),
+  deletions: z3.number().optional(),
+  checks: checksGlyphSchema.optional()
+});
+var githubDataSchema = z3.object({
+  available: z3.boolean(),
+  /** Why it is unavailable (`gh` missing, no remote, offline…). Never an error — a hint. */
+  reason: z3.string().optional(),
+  /** owner/name, when known. */
+  repo: z3.string().optional(),
+  syncedAt: z3.string().optional(),
+  issues: z3.array(githubItemSchema),
+  prs: z3.array(githubItemSchema),
+  /** Repo-wide label name → 6-hex color (no `#`); lets chips tint like GitHub. Additive. */
+  labelColors: z3.record(z3.string(), z3.string()).optional()
+});
+var githubChecksDataSchema = z3.discriminatedUnion("available", [
+  z3.object({
+    available: z3.literal(true),
+    checks: z3.record(z3.number(), checksGlyphSchema)
+  }),
+  z3.object({
+    available: z3.literal(false),
+    reason: z3.string()
+  })
+]);
+var referenceStatusSchema = z3.enum([
+  "draft",
+  "review-required",
+  "changes-requested",
+  "checks-pending",
+  "checks-failing",
+  "ready",
+  "merged",
+  "closed",
+  "open",
+  "completed",
+  "not-planned"
+]);
+var recheckAfterMsSchema = z3.number().nullable();
+var REFERENCE_STATUS_MAX = 100;
+var githubRefStatusDataSchema = z3.discriminatedUnion("available", [
+  z3.object({
+    available: z3.literal(true),
+    prs: z3.record(z3.number(), referenceStatusSchema),
+    issues: z3.record(z3.number(), referenceStatusSchema),
+    /**
+     * The pull request numbers that do NOT merge cleanly into their base right now.
+     *
+     * A second list rather than a twelfth status, because a conflict is a different AXIS from the
+     * one `referenceStatusSchema` ranks. That enum answers *whose move is it*, and it answers with
+     * one word; mergeability is an independent fact that can be true alongside any of them — a PR
+     * can be green, approved and conflicting at the same time, and folding the two together would
+     * force the cockpit to pick which of two true things to say. Kept apart, it paints a second
+     * chip next to the first and says both.
+     *
+     * It rides the same GraphQL node the statuses come from (`mergeable`), so unlike
+     * `githubPrMergeStateResponseSchema` — the full per-PR probe, blockers and all — it costs no
+     * extra request for the batch.
+     *
+     * Optional on the wire, and its absence means *nothing is known about mergeability*, never
+     * *no conflicts*: a server from before this field simply omits it. Only OPEN pull requests are
+     * ever named — GitHub reports `UNKNOWN` for merged and closed ones, and `UNKNOWN` (which is
+     * also what it answers while it is still computing) is never listed.
+     */
+    conflicts: z3.array(z3.number()).optional(),
+    recheckAfterMs: recheckAfterMsSchema
+  }),
+  z3.object({
+    available: z3.literal(false),
+    reason: z3.string(),
+    recheckAfterMs: recheckAfterMsSchema
+  })
+]);
+var githubCommentSchema = z3.object({
+  id: z3.number(),
+  /** Author login, `'?'` fallback when gh omits the user. */
+  author: z3.string(),
+  avatarUrl: z3.string().optional(),
+  createdAt: z3.string(),
+  body: z3.string(),
+  kind: z3.enum(["comment", "review"]),
+  /** Reviews only — drives the state chip. */
+  reviewState: z3.enum(["approved", "changes_requested", "commented", "dismissed"]).optional(),
+  url: z3.string()
+});
+var githubTimelineEventKindSchema = z3.enum([
+  "committed",
+  "labeled",
+  "unlabeled",
+  "assigned",
+  "unassigned",
+  "merged",
+  "closed",
+  "reopened",
+  "head_ref_force_pushed",
+  "cross-referenced",
+  "renamed"
+]);
+var githubTimelineEventSchema = z3.object({
+  id: z3.string(),
+  kind: githubTimelineEventKindSchema,
+  /** Login — or the git author name for `committed`, which carries no GitHub actor. */
+  actor: z3.string(),
+  /** Absent for `committed`. */
+  avatarUrl: z3.string().optional(),
+  createdAt: z3.string(),
+  url: z3.string().optional(),
+  /** `committed` — full 40-char SHA. */
+  sha: z3.string().optional(),
+  /** `committed` — first line, capped at 120 chars. */
+  message: z3.string().optional(),
+  /** `committed` — **absent** (lookup failed/skipped) and **`null`** (no CI configured) both
+   *  render no glyph, but stay distinct values. */
+  checks: checksGlyphSchema.optional(),
+  label: z3.object({ name: z3.string(), color: z3.string().optional() }).optional(),
+  /** `assigned`/`unassigned` login, or the new title for `renamed`. */
+  subject: z3.string().optional(),
+  refNumber: z3.number().optional(),
+  refTitle: z3.string().optional(),
+  refIsPr: z3.boolean().optional()
+});
+var githubCommentsDataSchema = z3.object({
+  available: z3.boolean(),
+  reason: z3.string().optional(),
+  /** Chronological, oldest first. */
+  comments: z3.array(githubCommentSchema),
+  /** True when either stream hit its cap, or the timeline fetch stopped short. */
+  truncated: z3.boolean().optional(),
+  /** Timeline events (#525) — additive; absent when the server degraded to the legacy
+   *  comments-only fetch. Capped independently of `comments`. */
+  events: z3.array(githubTimelineEventSchema).optional()
+});
+var githubMergeMethodSchema = z3.enum(["merge", "squash", "rebase"]);
+var githubPrCheckSchema = z3.object({
+  name: z3.string(),
+  state: z3.enum(["passing", "failing", "pending", "unknown"]),
+  required: z3.boolean().nullable(),
+  url: z3.string().optional()
+});
+var githubPrMergeStateSchema = z3.object({
+  number: z3.number(),
+  title: z3.string(),
+  url: z3.string(),
+  state: z3.enum(["open", "closed", "merged"]),
+  isDraft: z3.boolean(),
+  headRef: z3.string(),
+  baseRef: z3.string(),
+  headSha: z3.string(),
+  mergeable: z3.enum(["mergeable", "conflicting", "unknown"]),
+  reviewDecision: z3.enum(["approved", "changes-requested", "review-required", "unknown"]),
+  checks: z3.array(githubPrCheckSchema),
+  methods: z3.array(githubMergeMethodSchema),
+  defaultMethod: githubMergeMethodSchema.nullable(),
+  eligibility: z3.enum(["ready", "blocked", "pending", "unauthorized", "terminal", "unknown"]),
+  blockers: z3.array(z3.object({ code: z3.string(), message: z3.string() })),
+  canMerge: z3.boolean(),
+  canOverride: z3.boolean()
+});
+var githubPrMergeStateResponseSchema = z3.discriminatedUnion("available", [
+  z3.object({ available: z3.literal(true), mergeState: githubPrMergeStateSchema }),
+  z3.object({ available: z3.literal(false), reason: z3.string() })
+]);
+var githubMergeResponseSchema = z3.object({
+  merged: z3.literal(true),
+  number: z3.number(),
+  url: z3.string(),
+  method: githubMergeMethodSchema,
+  mergeCommitSha: z3.string().optional()
+});
+var githubPrChangeSchema = z3.object({
+  path: z3.string(),
+  previousPath: z3.string().optional(),
+  status: z3.enum(["added", "modified", "removed", "renamed", "copied", "changed"]),
+  additions: z3.number(),
+  deletions: z3.number(),
+  patch: z3.string().optional(),
+  patchUnavailableReason: z3.enum(["binary", "too-large", "not-provided"]).optional(),
+  truncated: z3.boolean().optional()
+});
+var githubPrChangesDataSchema = z3.discriminatedUnion("available", [
+  z3.object({
+    available: z3.literal(true),
+    number: z3.number(),
+    headSha: z3.string(),
+    files: z3.array(githubPrChangeSchema),
+    additions: z3.number(),
+    deletions: z3.number(),
+    truncated: z3.boolean(),
+    /** Present when the payload is complete but partial in some other way (a capped patch). */
+    reason: z3.string().optional()
+  }),
+  z3.object({ available: z3.literal(false), reason: z3.string() })
+]);
+
+// ../contract/src/workflows.ts
+import { z as z4 } from "zod";
+var workflowStepDefSchema = z4.object({
+  id: z4.string().min(1),
+  name: z4.string().optional(),
+  // agent step
+  prompt: z4.string().optional(),
+  skill: z4.string().optional(),
+  model: z4.string().optional(),
+  /** Per-step agent backend override (falls back to the task / config default). */
+  runner: runnerSchema.optional(),
+  allowedTools: z4.array(z4.string()).optional(),
+  bashAllowlist: z4.array(z4.string()).optional(),
+  // check step
+  command: z4.string().optional(),
+  onFail: z4.object({
+    retry: z4.string().min(1),
+    max: z4.number().int().positive().default(2)
+  }).optional()
+}).refine((s) => Boolean(s.command) !== Boolean(s.prompt ?? s.skill), {
+  message: "a step is either an agent step (prompt/skill) or a check step (command), not both"
+});
+var workflowDefSchema = z4.object({
+  name: z4.string(),
+  description: z4.string().optional(),
+  steps: z4.array(workflowStepDefSchema),
+  source: z4.enum(["built-in", "file"]),
+  /** Absent on built-ins — which is exactly what makes them undeletable. */
+  path: z4.string().optional()
+});
+var workflowLoadIssueSchema = z4.object({
+  path: z4.string(),
+  message: z4.string()
+});
+var workflowsResponseSchema = z4.object({
+  workflows: z4.array(workflowDefSchema),
+  issues: z4.array(workflowLoadIssueSchema)
+});
+var saveWorkflowInputSchema = z4.object({
+  name: z4.string().trim().min(1).max(80),
+  description: z4.string().max(2e3, "must be at most 2000 characters").optional(),
+  steps: z4.array(workflowStepDefSchema).min(1).max(8).optional(),
+  skills: z4.array(z4.string().trim().min(1)).min(1).max(8).optional(),
+  overwrite: z4.boolean().optional()
+}).refine((b) => Boolean(b.steps) !== Boolean(b.skills), {
+  message: 'provide either "steps" or "skills", not both'
+});
+var saveWorkflowResponseSchema = z4.object({
+  path: z4.string(),
+  name: z4.string()
+});
+var parsedWorkflowSchema = z4.object({
+  name: z4.string(),
+  description: z4.string().optional(),
+  steps: z4.array(workflowStepDefSchema)
+});
+var deleteWorkflowResponseSchema = z4.object({
+  ok: z4.literal(true),
+  path: z4.string()
+});
+var planResponseSchema = z4.object({
+  /** The kebab-case workflow title the planner proposed. Absent on the degraded fallback. */
+  name: z4.string().optional(),
+  steps: z4.array(workflowStepDefSchema),
+  rationale: z4.string(),
+  fallback: z4.boolean()
+});
+
+// ../contract/src/runs.ts
+var runStatusSchema = z5.enum([
+  "queued",
+  "running",
+  "waiting",
+  "review",
+  "done",
+  "failed",
+  "cancelled"
+]);
+var runActivitySchema = z5.enum(["monitoring"]);
+var stepStatusSchema = z5.enum([
+  "pending",
+  "running",
+  "waiting",
+  "review",
+  "done",
+  "failed",
+  "cancelled",
+  "skipped"
+]);
+var usageCounterSchema = z5.number().finite().nonnegative();
+var stepStateSchema = z5.object({
+  id: z5.string(),
+  name: z5.string(),
+  kind: z5.enum(["agent", "check"]),
+  status: stepStatusSchema,
+  iterations: z5.number(),
+  tokensUsed: z5.number(),
+  inputTokens: usageCounterSchema.optional(),
+  outputTokens: usageCounterSchema.optional(),
+  usageInvocationsStarted: usageCounterSchema.optional(),
+  usageInvocationsObserved: usageCounterSchema.optional(),
+  usageTurnsStarted: usageCounterSchema.optional(),
+  usageTurnsRecorded: usageCounterSchema.optional(),
+  usageInvocationEpoch: usageCounterSchema.optional(),
+  startedAt: z5.string().optional(),
+  finishedAt: z5.string().optional(),
+  error: z5.string().optional(),
+  /** Latest agent session id — `claude --resume <id>` and friends. */
+  sessionId: z5.string().optional(),
+  /** Backend that owns `sessionId`; absent on records written before backend affinity. */
+  backend: runnerSchema.optional(),
+  /** Agent account (spec 2026-07-29-agent-profiles) that owns `sessionId` — `default`, or a
+   *  stored profile id. The two are a PAIR: a session id only resolves inside the config dir
+   *  that created it, so resume and Continue read this rather than the project's current
+   *  selection. Absent on records written before accounts existed. */
+  profileId: z5.string().optional(),
+  costUsd: z5.number().optional()
+});
+var diffStatSchema = z5.object({
+  adds: z5.number(),
+  dels: z5.number(),
+  files: z5.number(),
+  /** Additive since #751, and present ONLY when true: the numbers were measured against a
+   *  branch the agent checked out into the task's worktree, as the run found it, because the
+   *  worktree's HEAD had been repointed off the task's own branch (every review/QA run does
+   *  this) and the merge-base anchor would otherwise have reported that branch's entire diff
+   *  as this task's. Absent on every normal run and on every record written before #751 — a
+   *  consumer that ignores it sees exactly the old shape. */
+  repointed: z5.boolean().optional()
+});
+var queuedMessageSchema = z5.object({
+  id: z5.string(),
+  text: z5.string(),
+  /** `/api/v1/runs/:id/images/…` URLs — attachments are persisted, never inlined. */
+  images: z5.array(z5.string()).optional(),
+  createdAt: z5.string()
+});
+var processUsageSchema = z5.object({
+  /** Sum of `%cpu` across the tree — can exceed 100 on multi-core work. */
+  cpuPct: z5.number(),
+  rssBytes: z5.number(),
+  procCount: z5.number()
+});
+var runRecordSchema = z5.object({
+  id: z5.string(),
+  title: z5.string(),
+  /** Display title (#389): auto-derived from the first agent turn, or the user's inline edit
+   *  (`PATCH /runs/:id` sets it together with `title`). Show `titleSummary ?? title`. */
+  titleSummary: z5.string().optional(),
+  /** Refreshed on every turn-end; absent until the first turn ends (and on worktree-less runs). */
+  diffStat: diffStatSchema.optional(),
+  workflow: z5.string(),
+  task: z5.string(),
+  /** Prompt messages stacked onto the run while it waited for a free agent slot (#472). Folded
+   *  into the prompt at dequeue — never delivered as their own turns. Absent on pre-#472 runs. */
+  queuedMessages: z5.array(queuedMessageSchema).optional(),
+  /** URLs of images attached to the initial task prompt (#image-display). */
+  taskImages: z5.array(z5.string()).optional(),
+  model: z5.string().optional(),
+  /** Normalized provider/model identity used for attribution and reproducible replay. */
+  modelIdentity: z5.string().optional(),
+  runner: runnerSchema.optional(),
+  /** The composer's per-task agent account (spec 2026-07-29-agent-profiles), applying to steps
+   *  on `runner`. Absent = the run follows the project's own selection. */
+  agentProfile: z5.string().optional(),
+  /** Echo of the extra system prompt the run used (POST override or config default). */
+  systemPrompt: z5.string().optional(),
+  /** false when the run deliberately disabled follow-up todo generation. Absent means enabled. */
+  generateFollowups: z5.boolean().optional(),
+  /** Autonomous mode (#autonomous): the run never parks at `waiting` or the terminal `review`
+   *  gate. Absent = falsy = not autonomous. */
+  autonomous: z5.boolean().optional(),
+  /**
+   * Provenance for a task a project GitHub automation launched (#694). Absent on every ordinary
+   * run, which is what makes it additive — the cockpit shows the "from automation" link only when
+   * it is there.
+   *
+   * `event` is a plain string rather than `automationEventSchema`: it is the event NAME the
+   * launching definition matched, recorded on the run for the audit trail, and `src/runs/store.ts`
+   * persists it as free text so an older cezar can still read a record written by a newer one.
+   */
+  automation: z5.object({
+    automationId: z5.string(),
+    automationRevision: z5.number(),
+    receiptId: z5.string(),
+    event: z5.string(),
+    githubUrl: z5.string()
+  }).optional(),
+  status: runStatusSchema,
+  /** `monitoring` while `status === 'running'` and the agent is working on downstream work.
+   *  Absent on old runs; cleared on resume/end. */
+  activity: runActivitySchema.optional(),
+  /** Exact ISO-8601 deadline for the next automatic monitoring check. */
+  monitoringWakeAt: z5.string().optional(),
+  /** The current live monitoring epoch exhausted its 40 automatic checks. */
+  monitoringWakeCapReached: z5.boolean().optional(),
+  /** Exact ISO-8601 instant this run resumes itself after a provider usage limit stopped it
+   *  (spec 2026-08-03-auto-resume-after-usage-limit). Present only on a `failed` run with a
+   *  pending automatic resume — its absence is what "no resume is scheduled" looks like. */
+  autoResumeAt: z5.string().optional(),
+  /** Consecutive automatic resumes since the last human turn, against the safety cap. */
+  autoResumeAttempts: z5.number().optional(),
+  createdAt: z5.string(),
+  startedAt: z5.string().optional(),
+  finishedAt: z5.string().optional(),
+  tokensUsed: z5.number(),
+  inputTokens: usageCounterSchema.optional(),
+  outputTokens: usageCounterSchema.optional(),
+  costUsd: z5.number().optional(),
+  pullRequestUrl: z5.string().optional(),
+  /** The PR this task is ABOUT (#407) — auto-discovered from conversation references. Display
+   *  tier only: `pullRequestUrl` (the PR this task CREATED) wins, and the action gates ignore it. */
+  referencedPullRequestUrl: z5.string().optional(),
+  /** The PR/issue number this task is ABOUT (task auto-naming spec) — display tier only. */
+  prNumber: z5.number().optional(),
+  issueNumber: z5.number().optional(),
+  /** Server-side provenance: referenced-issue discovery currently owns `issueNumber`. */
+  referencedIssueNumberSeeded: z5.boolean().optional(),
+  /** 'user' = renamed via PATCH, never auto-overwritten; 'marker' = agent-declared via
+   *  CEZ:TITLE (spec 2026-07-18-task-ref-markers); 'auto' = namer-owned. */
+  titleOrigin: z5.enum(["user", "auto", "marker"]).optional(),
+  /** References the agent declared via CEZ:PR/CEZ:ISSUE markers — authoritative over the namer
+   *  for the matching kind. */
+  markerRefs: z5.object({ pr: z5.number().optional(), issue: z5.number().optional() }).optional(),
+  /** The referenced tier's working set (distinct PR URLs spotted, capped server-side). */
+  referencedPrCandidates: z5.array(z5.string()).optional(),
+  /** The issue this task is ABOUT (spec 2026-07-21-report-ref-discovery). Display-only. */
+  referencedIssueUrl: z5.string().optional(),
+  /** The referenced-issue working set, persisted like `referencedPrCandidates`. Capped. */
+  referencedIssueCandidates: z5.array(z5.string()).optional(),
+  /** Explicit execution policy. `false` means the run intentionally uses the repo root;
+   *  absent on older runs and for the default isolated-worktree mode. */
+  worktree: z5.literal(false).optional(),
+  /** Absent for in-place runs and after an isolated worktree is removed. */
+  worktreePath: z5.string().optional(),
+  branch: z5.string().optional(),
+  /** Stable baseline for session git views: a worktree's fork ref, or an in-place run's starting commit. */
+  baseBranch: z5.string().optional(),
+  /** Set when count-based retention (#483) reclaimed the worktree DIRECTORY (the branch is
+   *  kept): the dir is gone but recoverable. */
+  worktreeReclaimedAt: z5.string().optional(),
+  /** Parallel variants (spec 010): runs sharing a groupId are one group. */
+  groupId: z5.string().optional(),
+  /** Variant letter within the group — 'A' | 'B' | 'C'. */
+  variant: z5.string().optional(),
+  peakRssBytes: z5.number().optional(),
+  peakProcCount: z5.number().optional(),
+  archived: z5.boolean(),
+  archivedAt: z5.string().optional(),
+  /** Read receipt (#unread-done-items): ISO time the cockpit last opened this run's
+   *  thread. A finished (`done`/`failed`) run reads as *unread* until seen since it
+   *  finished — see `isUnread()` in the cockpit's `lib/read-state.ts`. Absent on old
+   *  runs, on any run not yet opened, and on one deliberately put back to unread via
+   *  `POST /runs/:id/unread` (#775) — all three count as unread. */
+  seenAt: z5.string().optional(),
+  currentStepId: z5.string().optional(),
+  error: z5.string().optional(),
+  steps: z5.array(stepStateSchema),
+  /**
+   * The persisted workflow definition, so a `queued` run survives a restart — including the ad-hoc
+   * "(planned)" chains that exist nowhere else.
+   *
+   * The definition schema and NOT `z.record(z.string(), z.unknown())`: this key comes off the wire,
+   * so its values are whatever `JSON.parse` can produce and nothing else. `unknown` was wider than
+   * the server can serialize, and it made the route type unrepresentable here — hono maps `unknown`
+   * to its own `JSONValue`, whose index signature admits `object | symbol | undefined`. The fix was
+   * at the source: `src/runs/store.ts` persists a typed `workflowDefSchema` now, so the route's own
+   * type is this shape and the two-way check in `src/server/contract-parity.runs.test.ts` covers it
+   * like every other key.
+   */
+  workflowDef: workflowDefSchema.optional()
+});
+var apiRunSchema = runRecordSchema.extend({
+  usage: processUsageSchema.optional()
+});
+var runIndexEntrySchema = z5.object({
+  /** The registered project this run belongs to. Joins against `GET /projects`. */
+  projectId: z5.string(),
+  id: z5.string(),
+  title: z5.string(),
+  titleSummary: z5.string().optional(),
+  titleOrigin: z5.enum(["user", "auto", "marker"]).optional(),
+  status: runStatusSchema,
+  activity: runActivitySchema.optional(),
+  createdAt: z5.string(),
+  finishedAt: z5.string().optional(),
+  /** With `status`/`finishedAt`/`archived`, the four inputs `isUnread` reads — what lets the
+   *  palette lead with "finished while you weren't looking" across every project, not just the
+   *  one you happen to be standing in. */
+  seenAt: z5.string().optional(),
+  /** Always present, like `RunRecord.archived`: absent would read as "not archived", and the
+   *  unread rule treats archiving as a stronger "done with this" than reading. */
+  archived: z5.boolean(),
+  /** A run parked by a provider usage limit is `failed` on the record with a resume booked
+   *  (spec 2026-08-03-auto-resume-after-usage-limit). Both `deriveAttention` and `isUnread` read
+   *  it, so without it here a cross-project row would show a red "failed" dot and land in
+   *  Recently finished for work that is simply waiting for its appointment. */
+  autoResumeAt: z5.string().optional(),
+  /** The workflow the run executes — the global Tasks page shows it in a column and groups by
+   *  it. Always present on the record (`RunRecord.workflow`), so required here; the display
+   *  refinement `workflowLabel` applies needs `steps[]`, which this row deliberately omits, so
+   *  a `(planned)` chain reads as itself here rather than as its first agent's name. */
+  workflow: z5.string(),
+  /** The task's branch, when it has one — a column on the global page, and the one field that
+   *  makes a cross-project row identifiable at a glance without opening it. */
+  branch: z5.string().optional(),
+  /** When the agent actually started, as opposed to when the task was created. The global page's
+   *  age column prefers it and falls back to `createdAt`, exactly as the per-project table does. */
+  startedAt: z5.string().optional(),
+  /**
+   * The six fields `taskReference()` (`web/src/lib/tasks-table.ts`) reads to decide a task's PR
+   * or issue chip. Carried verbatim rather than pre-resolved into a `{kind, number, url}` on the
+   * server, because the rule that picks between them is subtle (#407, #526: a run that REVIEWED
+   * a PR must not claim it as its own, an issue-subject run must not adopt an incidental
+   * transcript PR) and it already exists, tested, on the client. Resolving it a second time
+   * server-side would be a second rule, and the two would drift.
+   *
+   * Six scalars is still the slim row this schema exists to keep: `steps[]` and `workflowDef`,
+   * the expensive half, stay off it.
+   */
+  pullRequestUrl: z5.string().optional(),
+  referencedPullRequestUrl: z5.string().optional(),
+  prNumber: z5.number().optional(),
+  issueNumber: z5.number().optional(),
+  referencedIssueUrl: z5.string().optional(),
+  markerRefs: z5.object({ pr: z5.number().optional(), issue: z5.number().optional() }).optional(),
+  /** What the run has cost so far. Absent means nothing was recorded, which is NOT `$0` — the
+   *  cockpit prints an em dash rather than claiming a measurement that never happened. */
+  costUsd: z5.number().optional(),
+  /** The persisted high-water marks a FINISHED run leaves behind. `usage` below stops existing
+   *  the moment the process tree does, so without these a finished row could say nothing at all
+   *  about what it took to run. */
+  peakRssBytes: z5.number().optional(),
+  peakProcCount: z5.number().optional(),
+  /**
+   * The live CPU/RSS sample of this run's process tree, attached on the way out exactly as
+   * `GET /runs` attaches it (`withUsage`) — never persisted.
+   *
+   * It can ride a WORKSPACE-level answer because the sampler is process-wide: one cezar process
+   * runs every project's agents, so `currentUsage(runId)` knows about a run whatever project it
+   * belongs to. That is what lets a cross-project table show live usage without opening one
+   * event stream per project (it could not — the run stream is project-scoped).
+   */
+  usage: processUsageSchema.optional()
+});
+var referenceStatusesByProjectSchema = z5.record(
+  z5.string(),
+  z5.object({
+    prs: z5.record(z5.number(), referenceStatusSchema),
+    issues: z5.record(z5.number(), referenceStatusSchema)
+  })
+);
+var runsIndexResponseSchema = z5.object({
+  /** Newest first, across every registered project. Archived runs are included — `GET /runs`
+   *  carries them for the project you are standing in, and a finder that dropped them elsewhere
+   *  would make a task vanish the moment you left its project. */
+  runs: z5.array(runIndexEntrySchema),
+  /** Additive: absent statuses mean "nothing warm", never "nothing to show". */
+  referenceStatuses: referenceStatusesByProjectSchema,
+  /** The per-project cap that produced this list. */
+  perProjectLimit: z5.number(),
+  /** Ids of the projects that had more runs than the cap allowed. */
+  truncated: z5.array(z5.string())
+});
+var createRunResponseSchema = z5.union([
+  runRecordSchema,
+  z5.object({ runs: z5.array(runRecordSchema) })
+]);
+var cancelResponseSchema = z5.object({ cancelled: z5.boolean() });
+var cancelAutoResumeResponseSchema = z5.object({ cancelled: z5.literal(true) });
+var archiveFinishedResponseSchema = z5.object({ archived: z5.number() });
+var markAllReadResponseSchema = z5.object({ read: z5.number() });
+var deleteRunResponseSchema = z5.object({ deleted: z5.literal(true) });
+var finishResponseSchema = z5.object({ finished: z5.literal(true) });
+var continueResponseSchema = z5.object({ continued: z5.literal(true) });
+var createPrResponseSchema = z5.object({
+  url: z5.string(),
+  dryRun: z5.boolean()
+});
+var messageResponseSchema = z5.union([
+  z5.object({ delivered: z5.literal(true) }),
+  z5.object({ queued: z5.literal(true), message: queuedMessageSchema }),
+  z5.object({ deferred: z5.literal(true) })
+]);
+var editQueuedMessageResponseSchema = z5.object({ message: queuedMessageSchema });
+var removeQueuedMessageResponseSchema = z5.object({ removed: z5.literal(true) });
+var openInCliResponseSchema = z5.object({
+  opened: z5.literal(true),
+  command: z5.string()
+});
+var removeWorktreeResponseSchema = z5.object({ removed: z5.literal(true) });
+var gitCommitResponseSchema = z5.object({
+  committed: z5.literal(true),
+  sha: z5.string()
+});
+var gitPushResponseSchema = z5.object({
+  pushed: z5.literal(true),
+  branch: z5.string(),
+  remote: z5.string(),
+  upstreamSet: z5.boolean()
+});
+var runCommitSchema = z5.object({
+  sha: z5.string(),
+  subject: z5.string(),
+  author: z5.string(),
+  /** Relative time ("3 hours ago") — git's `%cr`. */
+  when: z5.string()
+});
+var runCommitsResponseSchema = z5.object({ commits: z5.array(runCommitSchema) });
+var groupVariantSchema = z5.object({
+  id: z5.string(),
+  /** 'A' | 'B' | 'C' in practice; `'?'` for a record that lost its letter. */
+  variant: z5.string(),
+  title: z5.string(),
+  status: runStatusSchema,
+  archived: z5.boolean(),
+  tokensUsed: z5.number(),
+  inputTokens: usageCounterSchema.optional(),
+  outputTokens: usageCounterSchema.optional(),
+  costUsd: z5.number().optional(),
+  diffStat: z5.string(),
+  /** First lines of the handoff journal's "## Progress log" section, as markdown. */
+  handoffExcerpt: z5.string()
+});
+var groupResponseSchema = z5.object({
+  groupId: z5.string(),
+  runs: z5.array(groupVariantSchema)
+});
+var pickVariantResponseSchema = z5.object({
+  winner: runRecordSchema.optional()
+});
+var imageInputSchema = z5.object({
+  mediaType: z5.string().regex(/^image\//),
+  data: z5.string().min(1).max(7e6)
+});
+var createRunInputBaseSchema = z5.object({
+  workflow: z5.string().min(1).optional(),
+  /** An inline chain (spec 008 — an approved plan runs as an ad-hoc workflow, never written to
+   *  a file). The catalog's own step shape, not a copy of it. */
+  steps: z5.array(workflowStepDefSchema).min(1).max(8).optional(),
+  task: z5.string().min(1).max(1e5, "must be at most 100000 characters"),
+  model: z5.string().optional(),
+  runner: runnerSchema.optional(),
+  /** Agent account for this task (spec 2026-07-29-agent-profiles). Omit to follow the
+   *  project's own selection; an id that no longer exists is a 400, not a silent default. */
+  agentProfile: z5.string().max(64).optional(),
+  /** 1–3. Above 1 the response is `{ runs }` rather than a single record. */
+  variants: z5.number().int().min(1).max(3).optional(),
+  /** false → run in the repo working tree instead of an isolated worktree (read-only skills).
+   *  Omit for the default. Ignored server-side when variants > 1. */
+  worktree: z5.boolean().optional(),
+  /** true → autonomous run: never parks at "waiting"; auto-continues until done. */
+  autonomous: z5.boolean().optional(),
+  /** false → keep the handoff journal but do not expose or request a follow-up todos file.
+   *  Omit for the default (enabled); a server with the capability off pins it to false. */
+  generateFollowups: z5.boolean().optional(),
+  /** Per-run system-prompt override (R2 2.3) — programmatic callers only. Wins over the
+   *  config.json default; whitespace-only degrades to absent. */
+  systemPrompt: z5.string().trim().max(2e4, "must be at most 20000 characters").optional().transform((s) => s ? s : void 0),
+  /** Screenshots pasted into the new-task form; delivered with the first agent step. */
+  images: z5.array(imageInputSchema).max(4).optional(),
+  /** The inbox entry this task came from (#374). Best-effort bookkeeping: an unknown or
+   *  already-started id never fails the run. For ×2/×3 the FIRST variant is recorded. */
+  todoId: z5.string().min(1).max(200, "must be at most 200 characters").optional()
+});
+var createRunInputSchema = createRunInputBaseSchema.refine(
+  (b) => Boolean(b.workflow) !== Boolean(b.steps),
+  { message: 'provide either "workflow" or "steps", not both' }
+);
+var messageInputSchema = z5.object({
+  text: z5.string().max(1e5).default(""),
+  images: z5.array(imageInputSchema).max(4).default([])
+}).refine((m) => m.text.trim().length > 0 || m.images.length > 0, {
+  message: "message needs text or at least one image"
+});
+var patchRunInputSchema = z5.object({
+  title: z5.string().trim().min(1).max(300).optional(),
+  task: z5.string().trim().min(1).max(1e5).optional()
+});
+
+// ../contract/src/repo.ts
+import { z as z6 } from "zod";
+var statusEntrySchema = z6.object({
+  status: z6.string(),
+  path: z6.string()
+});
+var logEntrySchema = z6.object({
+  hash: z6.string(),
+  subject: z6.string(),
+  author: z6.string(),
+  when: z6.string()
+});
+var repoResponseSchema = z6.union([
+  z6.object({
+    info: z6.null(),
+    status: z6.array(z6.never()),
+    log: z6.array(z6.never()),
+    branches: z6.array(z6.never()),
+    baseBranch: z6.null()
+  }),
+  z6.object({
+    info: repoInfoSchema,
+    status: z6.array(statusEntrySchema),
+    log: z6.array(logEntrySchema),
+    branches: z6.array(z6.string()),
+    baseBranch: z6.string().nullable()
+  })
+]);
+var repoBranchResponseSchema = z6.object({
+  branch: z6.string(),
+  created: z6.boolean()
+});
+var diffStatSchema2 = z6.object({
+  adds: z6.number(),
+  dels: z6.number(),
+  files: z6.number()
+});
+var changedFileSchema = z6.object({
+  path: z6.string(),
+  /** Rename/copy source — present only when `status` is renamed/copied. */
+  oldPath: z6.string().optional(),
+  status: z6.enum(["added", "modified", "deleted", "renamed", "copied"]),
+  adds: z6.number(),
+  dels: z6.number(),
+  /** Binary per numstat — there is no text patch to render. */
+  binary: z6.boolean(),
+  /** True when the path is one the raw-bytes route serves as an `<img>` (#365) — present only
+   *  when true, so old clients that never read it stay correct. */
+  image: z6.boolean().optional(),
+  /** This file's unified-diff section; possibly `… (patch truncated)`, possibly empty. */
+  patch: z6.string()
+});
+var changesPayloadSchema = z6.object({
+  files: z6.array(changedFileSchema),
+  stat: diffStatSchema2,
+  /** Additive context for review tasks whose worktree HEAD no longer matches their own branch. */
+  repointedHead: z6.object({ headBranch: z6.string(), taskBranch: z6.string() }).optional()
+});
+var repoCommitPayloadSchema = z6.object({
+  sha: z6.string(),
+  subject: z6.string(),
+  author: z6.string(),
+  /** Relative time ("3 hours ago") — same `%cr` format as the /api/v1/repo log. */
+  when: z6.string(),
+  files: z6.array(changedFileSchema),
+  stat: diffStatSchema2
+});
+var worktreeDirEntrySchema = z6.object({
+  name: z6.string(),
+  type: z6.enum(["dir", "file"]),
+  size: z6.number().optional()
+});
+var worktreeEntrySchema = z6.discriminatedUnion("type", [
+  z6.object({
+    type: z6.literal("dir"),
+    path: z6.string(),
+    entries: z6.array(worktreeDirEntrySchema)
+  }),
+  z6.object({
+    type: z6.literal("file"),
+    path: z6.string(),
+    size: z6.number(),
+    binary: z6.boolean(),
+    tooLarge: z6.boolean(),
+    content: z6.string().optional()
+  })
+]);
+var worktreeRunStatusSchema = z6.enum([
+  "queued",
+  "running",
+  "waiting",
+  "review",
+  "done",
+  "failed",
+  "cancelled"
+]);
+var worktreeInfoSchema = z6.object({
+  runId: z6.string(),
+  title: z6.string(),
+  status: worktreeRunStatusSchema,
+  branch: z6.string().nullable(),
+  sizeBytes: z6.number().nullable(),
+  finishedAt: z6.string().nullable(),
+  reclaimable: z6.boolean()
+});
+var worktreesResponseSchema = z6.object({
+  worktrees: z6.array(worktreeInfoSchema),
+  totalBytes: z6.number().nullable(),
+  keep: z6.number()
+});
+var reclaimWorktreesResponseSchema = z6.object({
+  reclaimed: z6.array(z6.string())
+});
+
+// ../contract/src/projects.ts
+import { z as z7 } from "zod";
+var projectListEntrySchema = z7.object({
+  id: z7.string(),
+  name: z7.string(),
+  /** Absolute, realpath-normalized repo root. */
+  root: z7.string(),
+  addedAt: z7.string(),
+  lastOpenedAt: z7.string(),
+  source: z7.enum(["local", "checkout"]),
+  /** `not-git` is fully usable (degraded single-queue mode); only `missing` blocks. */
+  status: z7.enum(["ok", "missing", "not-git"]),
+  /** Current branch when cheaply available (omitted e.g. on an unborn HEAD). */
+  branch: z7.string().optional(),
+  /** Which forge this project's remote belongs to (#698) — classified server-side from the
+   *  remote URL alone. Gates the project group's GitHub nav item; omitted = no forge remote. */
+  forge: z7.literal("github").optional(),
+  /**
+   * The remote's web root, `https://github.com/owner/repo`. Rebuilt server-side from the parsed
+   * remote rather than passed through, so a remote carrying credentials cannot leak into the
+   * cockpit. Omitted when the project has no forge remote.
+   *
+   * It exists for the cross-project surfaces: a run often knows a PR or issue only by NUMBER, and
+   * the global Tasks page has one row per project, so it cannot use any single repo's base the
+   * way a project-scoped view can. With this, every reference it shows is a link.
+   */
+  repoUrl: z7.string().optional(),
+  /** Per-project cap on concurrently running tasks (spec 2026-07-22). Omitted = inherit the
+   *  workspace `resources.maxParallel`; a number pins this project. */
+  maxParallel: z7.number().optional(),
+  /**
+   * Free-form labels grouping CONNECTED repositories — a `storefront` tag on the API, the web
+   * app and the design system says those three are one piece of work spread over three repos.
+   * The global Tasks page (`/tasks`) filters and groups by them.
+   *
+   * Omitted rather than `[]` when a project has none, exactly like `maxParallel`: the registry
+   * stores nothing for a project nobody has tagged, and an empty array on the wire would make
+   * "never tagged" indistinguishable from "tagged, then emptied" for no gain. Normalized
+   * server-side (trimmed, deduped case-insensitively, sorted), so a consumer may compare them
+   * directly.
+   */
+  tags: z7.array(z7.string()).optional()
+});
+var projectsResponseSchema = z7.object({
+  projects: z7.array(projectListEntrySchema),
+  bootProject: z7.string(),
+  projectsDir: z7.string()
+});
+var registerProjectResponseSchema = z7.object({
+  project: projectListEntrySchema,
+  error: z7.string().optional()
+});
+var removeProjectResponseSchema = z7.object({
+  removed: z7.literal(true),
+  id: z7.string()
+});
+var updateProjectResponseSchema = z7.object({
+  project: projectListEntrySchema
+});
+var PROJECT_TAG_MAX_LENGTH = 32;
+var PROJECT_TAGS_MAX = 20;
+var updateProjectInputSchema = z7.object({
+  maxParallel: z7.number().int().min(1).max(16).nullable().optional(),
+  tags: z7.array(z7.string().trim().min(1).max(PROJECT_TAG_MAX_LENGTH)).max(PROJECT_TAGS_MAX).nullable().optional()
+}).refine(
+  (body) => body.maxParallel !== void 0 || body.tags !== void 0,
+  "specify maxParallel or tags"
+);
+var checkoutProjectInputSchema = z7.object({
+  url: z7.string().trim().min(1).max(512),
+  name: z7.string().trim().max(128).optional(),
+  checkoutId: z7.string().trim().max(128).optional()
+});
+var fsBrowseDirSchema = z7.object({
+  name: z7.string(),
+  path: z7.string(),
+  /** Has a `.git` entry — drives the "git" badge. A non-repo folder is still selectable. */
+  isRepo: z7.boolean()
+});
+var fsBrowseResponseSchema = z7.object({
+  /** The realpath'd directory actually listed — never the spelling asked for, so the breadcrumb
+   *  shows where the picker really is. */
+  path: z7.string(),
+  /** `null` AT the browse root: there is no "up" out of it, and the dialog must render no parent
+   *  row rather than one that 400s. */
+  parent: z7.string().nullable(),
+  dirs: z7.array(fsBrowseDirSchema),
+  /** True when the listing was capped server-side — surfaced honestly instead of showing a
+   *  silently short list. */
+  truncated: z7.boolean()
+});
+var launchKeyResponseSchema = z7.object({
+  key: z7.string()
+});
+
+// ../contract/src/workspace.ts
+import { z as z8 } from "zod";
+var workspaceConfigResponseSchema = z8.object({
+  /** Root exposed by the Add-project directory browser — stored as written (`~` kept). */
+  browseRoot: z8.string(),
+  /** Checkout root for GUI-cloned projects — stored as written (`~` kept). */
+  projectsDir: z8.string(),
+  /** Stored override; `null` means inherit `CEZ_SKILLS_AUTO_UPDATE`, then true. */
+  skillsAutoUpdate: z8.boolean().nullable(),
+  effectiveSkillsAutoUpdate: z8.boolean(),
+  composerDefaults: z8.object({
+    autonomous: z8.boolean().nullable(),
+    worktree: z8.boolean().nullable(),
+    /** `'source-dependent'` when no `CEZ_AUTONOMOUS_DEFAULT` pins it either way. */
+    inheritedAutonomous: z8.union([z8.boolean(), z8.literal("source-dependent")]),
+    inheritedWorktree: z8.boolean()
+  }),
+  resources: z8.object({
+    maxParallel: z8.number(),
+    maxMonitoringSessions: z8.number(),
+    monitoringWakeIntervalMinutes: z8.number().nullable(),
+    /** Resume a run a provider usage limit stopped, once the limit resets. Default `true`. */
+    autoResumeOnUsageLimit: z8.boolean(),
+    memoryLimitMb: z8.number().nullable(),
+    worktreeRetentionDefault: z8.number()
+  }),
+  /**
+   * What a repo that has set none of its own runs (spec 2026-07-29-agent-profiles).
+   *
+   * Both keys are OPTIONAL on the wire, and that is load-bearing rather than lax: absent means
+   * "this machine has no opinion, the built-in default applies", and it has to stay distinguishable
+   * from a value someone chose or the fallback collapses into "always claude". Consulted only where
+   * the repo's own `.ai/cezar/config.json` is silent — a repo that chose is never overruled.
+   */
+  agentDefaults: z8.object({
+    runner: runnerSchema.optional(),
+    models: z8.object({
+      claude: z8.string().optional(),
+      codex: z8.string().optional(),
+      opencode: z8.string().optional(),
+      pi: z8.string().optional()
+    }).optional()
+  })
+});
+var setWorkspaceConfigInputSchema = z8.object({
+  browseRoot: z8.string().trim().min(1).max(4096).optional(),
+  projectsDir: z8.string().trim().min(1).max(4096).optional(),
+  skillsAutoUpdate: z8.boolean().nullable().optional(),
+  composerDefaults: z8.object({
+    autonomous: z8.boolean().nullable().optional(),
+    worktree: z8.boolean().nullable().optional()
+  }).optional(),
+  /** Machine-wide agent defaults. `null` on a key CLEARS it back to "no opinion", which a bare
+   *  absent key cannot say in a partial patch. */
+  agentDefaults: z8.object({
+    runner: runnerSchema.nullable().optional(),
+    models: z8.object({
+      claude: z8.string().trim().min(1).max(200).nullable().optional(),
+      codex: z8.string().trim().min(1).max(200).nullable().optional(),
+      opencode: z8.string().trim().min(1).max(200).nullable().optional(),
+      pi: z8.string().trim().min(1).max(200).nullable().optional()
+    }).optional()
+  }).optional(),
+  resources: z8.object({
+    maxParallel: z8.number().int().min(1).max(16).optional(),
+    maxMonitoringSessions: z8.number().int().min(0).max(16).optional(),
+    monitoringWakeIntervalMinutes: z8.number().int().min(1).max(60).nullable().optional(),
+    autoResumeOnUsageLimit: z8.boolean().optional(),
+    memoryLimitMb: z8.number().int().min(0).max(1048576).nullable().optional(),
+    worktreeRetentionDefault: z8.number().int().min(0).max(1e3).optional()
+  }).optional()
+});
+var appearanceSchema = z8.object({
+  accent: z8.enum(["lime", "violet"]).optional(),
+  density: z8.enum(["comfortable", "compact", "ultra"]).optional(),
+  width: z8.enum(["narrow", "wide"]).optional()
+});
+var taskTableUiStateSchema = z8.looseObject({
+  /** Explicit user choices only. Missing ids keep the registry-owned default. */
+  expandedColumns: z8.record(z8.string(), z8.boolean()).optional()
+});
+var uiStateSchema = z8.looseObject({
+  /** What the last started run used. `null` is a VALUE, not an absence: it records a run that
+   *  chose neither a skill nor a workflow (the plain built-in `quick-task`), which the composer
+   *  can now express since the source picker grew an empty state. Absent still means "no
+   *  run has been recorded here" — a cockpit reading either one selects nothing. */
+  lastTask: z8.object({ source: z8.enum(["workflow", "skill"]), ref: z8.string() }).nullable().optional(),
+  /** Most-recently-run sources, newest first (deduped, capped). Feeds the composer picker's
+   *  recency sort. */
+  recentSources: z8.array(z8.object({ source: z8.enum(["workflow", "skill"]), ref: z8.string() })).optional(),
+  /** The last worktree choice for a single-skill run. Absent → the default (isolated worktree). */
+  lastWorktree: z8.boolean().optional(),
+  /** The last autonomous choice — remembered like `lastWorktree`. Absent → off. */
+  lastAutonomous: z8.boolean().optional(),
+  /** Whether new runs should ask agents to append follow-up work. Absent → on. */
+  lastGenerateFollowups: z8.boolean().optional(),
+  /** Skill selection frequency (#408): name → times chosen, across BOTH composers. */
+  skillUsage: z8.record(z8.string(), z8.number()).optional(),
+  runsView: z8.enum(["list", "table"]).optional(),
+  /** The GitHub tab's last-selected sub-tab (#417). Absent → issues. */
+  githubView: z8.enum(["issues", "prs"]).optional(),
+  /** Settings → Appearance. The theme itself stays in localStorage (`cez-theme`) — it must
+   *  pre-paint, and it is per-browser by design. */
+  appearance: appearanceSchema.optional(),
+  /** Follow-up prompt templates (#413). Absent → the built-in defaults; present (even `[]`) is
+   *  the user's own edited list. `skills` are the skill names the template auto-applies for. */
+  promptTemplates: z8.array(
+    z8.object({
+      id: z8.string(),
+      label: z8.string(),
+      text: z8.string(),
+      skills: z8.array(z8.string()).optional()
+    })
+  ).optional(),
+  /** The open-mercato/skills promo banner (#391), dismissed for good. Legacy — the banner is
+   *  gone, replaced by `WorkspaceUiState.importedSkills`; retained so old files round-trip. */
+  dismissedSkillsBanner: z8.boolean().optional()
+});
+var workspaceLastLocationSchema = z8.strictObject({
+  projectId: z8.string().min(1).max(64),
+  pathname: z8.string().min(1).max(2048).startsWith("/p/"),
+  search: z8.string().max(4096).startsWith("?").optional(),
+  hash: z8.string().max(2048).startsWith("#").optional()
+});
+var workspaceUiStateSchema = z8.looseObject({
+  /** LEGACY — the sidebar's per-project collapse map (step 3.3). Still accepted and still
+   *  round-tripped so an older cockpit sharing this home keeps working, but the current cockpit
+   *  neither reads nor writes it: which groups are shut describes the WINDOW, not the workspace,
+   *  so it lives in that browser's localStorage (`packages/web/src/lib/sidebar-collapse.ts`).
+   *  One shared answer meant a phone collapsing a group collapsed it on the desktop too. */
+  sidebar: z8.looseObject({ collapsed: z8.record(z8.string(), z8.boolean()).optional() }).optional(),
+  /** Dismissed runtime-auth incident IDs, keyed by provider. An ID is only dismissed until the
+   *  provider reports a different incident, so this stays workspace-global with the browser
+   *  rather than one project checkout. */
+  dismissedProviderAuthFailures: z8.object({
+    claude: z8.string().optional(),
+    codex: z8.string().optional(),
+    opencode: z8.string().optional(),
+    pi: z8.string().optional()
+  }).optional(),
+  /** Settings → Appearance, GLOBAL since step 3.5: accent + density describe the person at the
+   *  keyboard, not a repo. */
+  appearance: appearanceSchema.optional(),
+  /** Settings → Notifications, GLOBAL since step 3.5 — one answer for the whole workspace, since
+   *  the delivering browser is one browser whichever project you are looking at. */
+  notifications: z8.looseObject({ enabled: z8.boolean().optional() }).optional(),
+  /** Desktop Tasks-table density, shared across every project in this workspace. */
+  taskTable: taskTableUiStateSchema.optional(),
+  /** LEGACY, exactly like `sidebar` above — the last settled project-scoped page, restored when
+   *  entering at the exact bare root. The shape is unchanged and still accepted, but the current
+   *  cockpit keeps it in localStorage (`packages/web/src/lib/last-location.ts`): stored here, the
+   *  last client to navigate decided where every OTHER client's next launch landed. */
+  lastLocation: workspaceLastLocationSchema.optional(),
+  /** The user's curated selection of default (vendor) skills. Tri-state: ABSENT means "not
+   *  curated", so every default skill shows; a PRESENT array (even `[]`) means only those names
+   *  show from that repo. */
+  importedSkills: z8.array(z8.string()).optional()
+});
+var WORKSPACE_UI_STATE_MAX_KEYS = 200;
+var TASK_TABLE_MAX_COLUMNS = 50;
+var setWorkspaceUiStateInputSchema = z8.looseObject({
+  ...workspaceUiStateSchema.shape,
+  sidebar: z8.looseObject({
+    collapsed: z8.record(z8.string().min(1).max(64), z8.boolean()).refine((map) => Object.keys(map).length <= WORKSPACE_UI_STATE_MAX_KEYS, {
+      message: `sidebar.collapsed must have at most ${WORKSPACE_UI_STATE_MAX_KEYS} entries`
+    }).optional()
+  }).optional(),
+  dismissedProviderAuthFailures: z8.strictObject({
+    claude: z8.string().min(1).max(128).optional(),
+    codex: z8.string().min(1).max(128).optional(),
+    opencode: z8.string().min(1).max(128).optional(),
+    pi: z8.string().min(1).max(128).optional()
+  }).optional(),
+  importedSkills: z8.array(z8.string().min(1).max(200)).max(WORKSPACE_UI_STATE_MAX_KEYS).optional(),
+  taskTable: taskTableUiStateSchema.extend({
+    expandedColumns: z8.record(z8.string().min(1).max(64), z8.boolean()).refine((map) => Object.keys(map).length <= TASK_TABLE_MAX_COLUMNS, {
+      message: `taskTable.expandedColumns must have at most ${TASK_TABLE_MAX_COLUMNS} entries`
+    }).optional()
+  }).optional()
+}).superRefine((data, ctx) => {
+  if (Object.keys(data).length > WORKSPACE_UI_STATE_MAX_KEYS) {
+    ctx.addIssue({
+      code: "custom",
+      message: `ui-state has too many keys (max ${WORKSPACE_UI_STATE_MAX_KEYS})`
+    });
+  }
+});
+var runnerModelsSchema = z8.object({
+  claude: z8.string().optional(),
+  codex: z8.string().optional(),
+  opencode: z8.string().optional(),
+  pi: z8.string().optional()
+});
+var configResponseSchema = z8.object({
+  baseBranch: z8.string().nullable(),
+  defaultRunner: runnerSchema,
+  systemPrompt: z8.string().nullable(),
+  defaultModels: runnerModelsSchema,
+  /** True when native coding-agent settings are authoritative and model picks are read-only. */
+  modelsLocked: z8.boolean(),
+  /** How many tasks run at once (1–16). */
+  maxParallel: z8.number(),
+  /** Per-task memory ceiling in MiB (whole process tree); null = no limit. */
+  memoryLimitMb: z8.number().nullable(),
+  /** Keep the last N finished worktrees on disk (#483); 0 = unlimited. Older ones are reclaimed
+   *  (directory only — branch kept, so work is recoverable). */
+  worktreeRetention: z8.number(),
+  /** Live title updates: null = no config key, the `CEZ_TITLE_UPDATES` env default (ON) decides. */
+  liveTitleUpdates: z8.boolean().nullable(),
+  /** Optional review gate (#489): null = no config key, the `CEZ_REVIEW_GATE` env default (OFF)
+   *  decides. */
+  reviewGate: z8.boolean().nullable()
+});
+var setConfigResponseSchema = configResponseSchema;
+var setConfigInputSchema = z8.object({
+  baseBranch: z8.string().trim().min(1).max(200).nullable().optional(),
+  defaultRunner: runnerSchema.optional(),
+  systemPrompt: z8.string().trim().max(2e4).nullable().optional(),
+  defaultModels: z8.object({
+    claude: z8.string().trim().max(200).nullable().optional(),
+    codex: z8.string().trim().max(200).nullable().optional(),
+    opencode: z8.string().trim().max(200).nullable().optional(),
+    pi: z8.string().trim().max(200).nullable().optional()
+  }).optional(),
+  maxParallel: z8.number().int().min(1).max(16).optional(),
+  /** null or 0 clears the ceiling back to "no limit". */
+  memoryLimitMb: z8.number().int().min(0).max(1048576).nullable().optional(),
+  /** Keep last N finished worktrees (#483); 0 = unlimited, null clears back to the default (10). */
+  worktreeRetention: z8.number().int().min(0).max(1e3).nullable().optional(),
+  /** null clears the key back to the env-default behavior. */
+  liveTitleUpdates: z8.boolean().nullable().optional(),
+  /** null clears the key back to the env-default behavior (OFF). */
+  reviewGate: z8.boolean().nullable().optional()
+});
+var skillsUpdateStatusSchema = z8.enum([
+  "idle",
+  "checking",
+  "available",
+  "updating",
+  "current",
+  "unavailable",
+  "error"
+]);
+var skillsUpdateScopeStateSchema = z8.object({
+  scope: z8.enum(["project", "global"]),
+  status: skillsUpdateStatusSchema,
+  available: z8.boolean(),
+  skills: z8.array(z8.string()),
+  checkedAt: z8.string().nullable(),
+  updatedAt: z8.string().nullable(),
+  reason: z8.string().optional()
+});
+var skillsUpdateStateSchema = z8.object({
+  status: skillsUpdateStatusSchema,
+  available: z8.boolean(),
+  autoUpdateEnabled: z8.boolean(),
+  inherited: z8.boolean(),
+  checkedAt: z8.string().nullable(),
+  updatedAt: z8.string().nullable(),
+  scopes: z8.array(skillsUpdateScopeStateSchema),
+  needsUpgradeNotes: z8.boolean()
+});
+var providerIdSchema = runnerSchema;
+var providerConnectionStateSchema = z8.enum([
+  "connected",
+  "disconnected",
+  "not-installed",
+  "unknown"
+]);
+var providerStatusSchema = z8.object({
+  provider: providerIdSchema,
+  status: providerConnectionStateSchema,
+  enabled: z8.boolean().optional(),
+  hint: z8.string().optional(),
+  authFailureId: z8.string().optional(),
+  /** Which agent account this row describes (spec 2026-07-29-agent-profiles). ABSENT on
+   *  `GET /api/v1/providers/status`, which deliberately keeps answering exactly one row per
+   *  provider — the discovered default — so an older client sees no change at all. Per-account
+   *  rows are carried by `GET /api/v1/workspace/agent-profiles` instead. */
+  profileId: z8.string().optional()
+});
+var providerStatusResponseSchema = z8.object({
+  providers: z8.array(providerStatusSchema)
+});
+var providerConnectResponseSchema = z8.discriminatedUnion("opened", [
+  z8.object({ opened: z8.literal(true), command: z8.string() }),
+  z8.object({ opened: z8.literal(false), connected: z8.literal(true), command: z8.string() })
+]);
+var modelDiscoveryRunnerSchema = z8.enum(["codex", "opencode", "pi"]);
+var MODEL_DISCOVERY_RUNNERS = modelDiscoveryRunnerSchema.options;
+function runnerDiscoversModels(runner) {
+  return MODEL_DISCOVERY_RUNNERS.includes(runner);
+}
+var runnerModelOptionSchema = z8.object({
+  id: z8.string(),
+  label: z8.string(),
+  description: z8.string()
+});
+var runnerModelCatalogResponseSchema = z8.object({
+  runner: runnerSchema,
+  models: z8.array(runnerModelOptionSchema),
+  source: z8.enum(["live", "cache", "unavailable"]),
+  stale: z8.boolean(),
+  reason: z8.string().optional()
+});
+var openTargetSchema = z8.object({
+  id: z8.string(),
+  label: z8.string(),
+  /** A stable icon key (#361) the UI maps to a concrete icon. Optional: an older server omitting
+   *  it just renders the generic fallback icon. */
+  icon: z8.string().optional()
+});
+var openTargetsResponseSchema = z8.object({
+  targets: z8.array(openTargetSchema)
+});
+var openProjectInSchema = z8.object({
+  // A short bound (#429): matched against a downstream allowlist, so an app id is never long.
+  target: z8.string().trim().min(1, "target required").max(200)
+});
+var openProjectInResponseSchema = z8.object({
+  opened: z8.literal(true),
+  path: z8.string()
+});
+
+// ../contract/src/skills.ts
+import { z as z9 } from "zod";
+var skillSchema = z9.object({
+  name: z9.string(),
+  description: z9.string().optional(),
+  /** Advisory hint for untouched composer run-mode choices. */
+  interactive: z9.literal(true).optional(),
+  body: z9.string(),
+  path: z9.string(),
+  source: z9.enum(["ai", "cezar", "agents", "global", "team"]),
+  /** Team skills only: where the definition lives in its skills repo. */
+  team: z9.object({
+    repo: z9.string(),
+    ref: z9.string(),
+    path: z9.string(),
+    /** True for the `SKILL.md` convention — a whole directory (references/…). */
+    dir: z9.boolean(),
+    /**
+     * The exact commit `ref` resolved to when the skill was read (#428).
+     *
+     * The hand-written DTO omitted this field entirely — it was NARROWER than the route,
+     * which has served it since #428.
+     */
+    commit: z9.string().optional()
+  }).optional()
+});
+var importableSkillSchema = z9.object({
+  name: z9.string(),
+  description: z9.string().optional()
+});
+var todoItemSchema = z9.object({
+  id: z9.string(),
+  ts: z9.string().optional(),
+  taskId: z9.string().optional(),
+  summary: z9.string().min(1),
+  action: z9.string().optional(),
+  prUrl: z9.string().optional(),
+  suggestedSkill: z9.string().optional(),
+  suggestedArgs: z9.string().optional(),
+  suggestedPrompt: z9.string().optional(),
+  /** Explicit intent; missing infers from suggestedSkill/suggestedPrompt for old files. */
+  runnable: z9.boolean().optional(),
+  /** Set once a task was started from this entry — it then leaves the inbox and stays as
+   *  the audit trail. A later launch never overwrites the first. */
+  startedTaskId: z9.string().optional()
+});
+var removeTodoResponseSchema = z9.object({
+  removed: z9.literal(true)
+});
+var startTodoResponseSchema = z9.object({
+  run: runRecordSchema
+});
+
+// ../contract/src/agent-config.ts
+import { z as z10 } from "zod";
+var agentConfigFormatSchema = z10.enum(["json", "jsonc", "toml", "markdown"]);
+var agentConfigScopeSchema = z10.enum(["user", "project", "local"]);
+var agentConfigKindSchema = z10.enum(["settings", "memory", "mcp"]);
+var agentConfigTrackedSchema = z10.enum(["tracked", "gitignored", "outside-repo"]);
+var agentConfigFileSchema = z10.object({
+  /** Stable, opaque, URL-safe — the ONLY thing a client may name (traversal-proof). */
+  id: z10.string(),
+  /** Every runner that reads this file: `<repo>/AGENTS.md` is one file, two readers. */
+  runners: z10.array(runnerSchema),
+  kind: agentConfigKindSchema,
+  scope: agentConfigScopeSchema,
+  label: z10.string(),
+  path: z10.string(),
+  format: agentConfigFormatSchema,
+  tracked: agentConfigTrackedSchema,
+  seeded: z10.boolean(),
+  holdsMcp: z10.boolean(),
+  /** VERBATIM from the vendor docs. Never computed, never generic. */
+  precedence: z10.string(),
+  /** Documented mid-run reload behaviour, or absent when the vendor is silent. */
+  hotReload: z10.string().optional(),
+  docsUrl: z10.string(),
+  exists: z10.boolean(),
+  size: z10.number(),
+  /** sha256 of the bytes, or null when absent. */
+  version: z10.string().nullable(),
+  /** False in hosted mode (whole feature) — the client renders read-only up front. */
+  writable: z10.boolean(),
+  readOnlyReason: z10.string().optional()
+});
+var userMcpListingSchema = z10.object({
+  path: z10.string(),
+  servers: z10.array(z10.string()),
+  readable: z10.boolean()
+});
+var agentConfigListingSchema = z10.object({
+  editable: z10.boolean(),
+  files: z10.array(agentConfigFileSchema),
+  /** null in hosted mode (host-state disclosure guard). */
+  userMcp: userMcpListingSchema.nullable()
+});
+var agentConfigFileContentSchema = z10.object({
+  id: z10.string(),
+  path: z10.string(),
+  exists: z10.boolean(),
+  content: z10.string(),
+  /** sha256 of the bytes, or null when the file does not exist yet. */
+  version: z10.string().nullable()
+});
+var setAgentConfigInputSchema = z10.object({
+  content: z10.string().max(2e6),
+  version: z10.string().nullable()
+});
+
+// ../contract/src/agent-profiles.ts
+import { z as z11 } from "zod";
+var DEFAULT_AGENT_ACCOUNT_ID = "default";
+var agentAccountFileSchema = z11.object({
+  id: z11.string(),
+  /** e.g. `settings.json` — the file's own name, since the folder is shown once on the account. */
+  label: z11.string(),
+  /** Absolute, resolved inside this account's config folder. */
+  path: z11.string(),
+  exists: z11.boolean()
+});
+var agentProfileSchema = z11.object({
+  /** `default` for the discovered profile, else the stored slug. */
+  id: z11.string(),
+  provider: providerIdSchema,
+  label: z11.string(),
+  /** As the user wrote it — a literal `~` is preserved, matching `browseRoot`/`projectsDir`. */
+  configDir: z11.string(),
+  /** Expanded absolute path. Same-origin route, like `ProjectListEntry.root`. */
+  path: z11.string(),
+  /** False for a dir the CLI has not created yet — legitimate, and NOT a reason to fall back
+   *  to another account at run time (that would silently bill the wrong subscription). */
+  exists: z11.boolean(),
+  /** Whether the dir carries this agent's own marker files. ADVISORY: an unrecognised dir is
+   *  still accepted, because "add profile → Connect → the CLI creates it" is the real flow. */
+  looksValid: z11.boolean(),
+  /** True for the profile cezar discovers from the environment. Never stored, never deletable. */
+  isDefault: z11.boolean(),
+  /** This account's own authentication state — two Claude logins answer independently.
+   *
+   *  **Absent until the probe has warmed.** Every probe shells out to an agent CLI, and this
+   *  listing refuses to pay that (it would be one spawn per provider plus one per account, on
+   *  every cold load); it serves only what is already cached, exactly as `GET /api/v1/health`
+   *  serves a cached forge answer. Absent means "not determined yet" — NOT `unknown`, which is a
+   *  real probe result — and the cockpit fills it in from `…/:id/status`. */
+  status: providerStatusSchema.optional(),
+  /** This agent's own user-scope config files, resolved inside THIS account's folder — so a
+   *  second login's `settings.json` is the one you open, not the default account's. */
+  files: z11.array(agentAccountFileSchema)
+});
+function agentAccountRouteId(profile) {
+  return profile.isDefault ? `default:${profile.provider}` : profile.id;
+}
+var agentAccountSelectionSchema = z11.object({
+  claude: z11.string().optional(),
+  codex: z11.string().optional(),
+  opencode: z11.string().optional(),
+  pi: z11.string().optional()
+});
+var agentProfilesResponseSchema = z11.object({
+  editable: z11.boolean(),
+  profiles: z11.array(agentProfileSchema),
+  /** Providers that can carry more than one account at all — what "Add account" is offered for.
+   *  OpenCode is absent: its credentials live in a SQLite DB behind a separate `OPENCODE_DB`, so
+   *  a config-dir profile would swap settings while still billing the other account. */
+  profileCapableProviders: z11.array(providerIdSchema),
+  /** Which account each project uses, keyed by the project's realpath'd ROOT.
+   *
+   *  Served here rather than on `GET /api/v1/projects` because it is stored beside the accounts it
+   *  names (`~/.cezar/agent-accounts.json`) — one file, so deleting an account and scrubbing every
+   *  reference to it is one atomic write, and neither can be dropped by a cezar version that never
+   *  heard of accounts. Empty in hosted mode, where the whole family is withheld. */
+  selections: z11.record(z11.string(), agentAccountSelectionSchema),
+  /** The machine-wide fallback account per provider, used by any repo that has chosen none. */
+  defaults: agentAccountSelectionSchema
+});
+var selectAgentProfileInputSchema = z11.object({
+  /**
+   * Registry slug, or the reserved `default` boot alias. Resolved to a root server-side.
+   *
+   * `null` targets the MACHINE-WIDE default instead of one repo — the account a repo that has
+   * chosen nothing uses, so a second login is set up once rather than per checkout. A repo's own
+   * choice always wins over it, which is what keeps this a default and not an override.
+   */
+  projectId: z11.string().min(1).max(64).nullable(),
+  provider: providerIdSchema,
+  profileId: z11.string().max(64).nullable()
+});
+var agentProfileSelectionsResponseSchema = z11.object({
+  selections: z11.record(z11.string(), agentAccountSelectionSchema),
+  /** The machine-wide fallback, for repos with no selection of their own. */
+  defaults: agentAccountSelectionSchema
+});
+var agentAccountStatusResponseSchema = z11.object({ status: providerStatusSchema });
+var agentAccountDetailsResponseSchema = z11.object({
+  available: z11.boolean(),
+  reason: z11.string().optional(),
+  fields: z11.array(z11.object({ label: z11.string(), value: z11.string() }))
+});
+var openAgentAccountFileInputSchema = z11.object({
+  file: z11.string().min(1).max(200),
+  target: z11.string().min(1).max(64).optional()
+});
+var openAgentAccountFileResponseSchema = z11.object({
+  opened: z11.literal(true),
+  path: z11.string()
+});
+var createAgentProfileInputSchema = z11.object({
+  provider: providerIdSchema,
+  label: z11.string().trim().max(200).optional(),
+  /** Stored as written; validated absolute after `~` expansion, server-side. */
+  configDir: z11.string().trim().min(1).max(4096)
+});
+var agentProfileResponseSchema = z11.object({ profile: agentProfileSchema });
+var updateAgentProfileInputSchema = z11.object({
+  label: z11.string().trim().max(200).optional(),
+  configDir: z11.string().trim().min(1).max(4096).optional()
+});
+var removeAgentProfileResponseSchema = z11.object({
+  removed: z11.literal(true),
+  id: z11.string()
+});
+
+// ../contract/src/automations.ts
+import { z as z12 } from "zod";
+var automationEventSchema = z12.enum([
+  "pull_request.opened",
+  "issue.opened",
+  "issue.labeled",
+  "issue.unlabeled"
+]);
+var automationFiltersSchema = z12.object({
+  authors: z12.array(z12.string()).optional(),
+  assignees: z12.array(z12.string()).optional(),
+  allLabels: z12.array(z12.string()).optional(),
+  anyLabels: z12.array(z12.string()).optional(),
+  excludeLabels: z12.array(z12.string()).optional(),
+  /** Required for the two label events — the server rejects a definition without it. */
+  changedLabels: z12.array(z12.string()).optional(),
+  lookbackDays: z12.number(),
+  maxRecords: z12.number()
+});
+var automationTaskSchema = createRunInputBaseSchema.omit({ task: true, images: true, todoId: true, systemPrompt: true }).extend({
+  /** The prompt template. `{{github.number}}`, `{{github.title}}`, `{{github.url}}` and
+   *  `{{github.labels}}` are substituted per match; GitHub content is appended as untrusted
+   *  context, never interpolated into instructions. */
+  prompt: z12.string(),
+  variants: z12.union([z12.literal(1), z12.literal(2), z12.literal(3)]).optional(),
+  systemPrompt: z12.string().optional()
+});
+var automationDefinitionSchema = z12.object({
+  id: z12.string(),
+  /** Bumped on every edit; a PUT must echo the revision it read (optimistic concurrency). */
+  revision: z12.number(),
+  name: z12.string(),
+  description: z12.string().optional(),
+  /** Always present: the storage schema defaults it to `false`, so a definition is created
+   *  PAUSED and enabling it is a separate, baseline-establishing act. */
+  enabled: z12.boolean(),
+  events: z12.array(automationEventSchema),
+  intervalSeconds: z12.number(),
+  filters: automationFiltersSchema,
+  task: automationTaskSchema,
+  createdAt: z12.string(),
+  updatedAt: z12.string()
+});
+var automationCursorSchema = z12.object({
+  timestamp: z12.string(),
+  tieBreaker: z12.string().optional()
+});
+var automationRuntimeStateSchema = z12.object({
+  /** The definition revision this state belongs to; a bumped revision re-baselines. */
+  revision: z12.number().optional(),
+  /** Enabling establishes a CURRENT-TIME baseline: records older than this never launch. */
+  baselineAt: z12.string().optional(),
+  cursor: automationCursorSchema.optional(),
+  frozenHighWatermark: automationCursorSchema.extend({ tieBreaker: z12.string() }).optional(),
+  backlogAfter: automationCursorSchema.extend({ tieBreaker: z12.string() }).optional(),
+  nextCheckAt: z12.string().optional(),
+  lastSuccessAt: z12.string().optional(),
+  /** Per-query GitHub ETags, so an unchanged page costs no rate-limit budget. */
+  etags: z12.record(z12.string(), z12.string()).optional(),
+  backoffUntil: z12.string().optional(),
+  consecutiveFailures: z12.number().optional()
+});
+var automationLogResultSchema = z12.enum([
+  "launched",
+  "no-match",
+  "duplicate",
+  "rate-limited",
+  "error",
+  "baseline",
+  "preview"
+]);
+var automationLogRecordSchema = z12.object({
+  seq: z12.number(),
+  ts: z12.string(),
+  automationId: z12.string(),
+  revision: z12.number(),
+  event: automationEventSchema.optional(),
+  result: automationLogResultSchema,
+  reason: z12.string().optional(),
+  durationMs: z12.number().optional(),
+  receiptId: z12.string().optional(),
+  runId: z12.string().optional(),
+  githubNumber: z12.number().optional(),
+  githubTitle: z12.string().optional(),
+  githubUrl: z12.string().optional(),
+  rateLimit: z12.object({
+    bucket: z12.enum(["core", "search"]),
+    remaining: z12.number().optional(),
+    resetAt: z12.string().optional()
+  }).optional()
+});
+var automationCountsSchema = z12.object({
+  matches: z12.number(),
+  launched: z12.number(),
+  duplicates: z12.number(),
+  errors: z12.number()
+});
+var automationListEntrySchema = automationDefinitionSchema.extend({
+  state: automationRuntimeStateSchema.optional(),
+  latestLog: automationLogRecordSchema.optional(),
+  counts: automationCountsSchema
+});
+var automationsResponseSchema = z12.object({
+  available: z12.boolean(),
+  reason: z12.string().optional(),
+  scheduler: z12.object({
+    state: z12.enum(["scheduled", "idle"]),
+    nextDue: z12.string().optional()
+  }),
+  automations: z12.array(automationListEntrySchema)
+});
+var automationResponseSchema = z12.object({ automation: automationDefinitionSchema });
+var automationDetailResponseSchema = z12.object({
+  automation: automationDefinitionSchema,
+  state: automationRuntimeStateSchema.optional(),
+  latestLog: automationLogRecordSchema.optional()
+});
+var automationCheckSchema = z12.object({
+  id: z12.string(),
+  automationId: z12.string(),
+  mode: z12.enum(["preview", "execute"]),
+  status: z12.enum(["queued", "running", "complete", "error"]),
+  createdAt: z12.string(),
+  completedAt: z12.string().optional(),
+  matches: z12.number().optional(),
+  truncated: z12.boolean().optional(),
+  error: z12.string().optional()
+});
+var automationCheckQueuedResponseSchema = z12.object({ checkId: z12.string() });
+var automationLogResponseSchema = z12.object({
+  records: z12.array(automationLogRecordSchema)
+});
+var automationRetryResponseSchema = z12.object({
+  receiptId: z12.string(),
+  runId: z12.string()
+});
+var createAutomationInputSchema = automationDefinitionSchema.omit({ id: true, revision: true, createdAt: true, updatedAt: true, enabled: true }).extend({ enable: z12.boolean().optional() });
+var updateAutomationInputSchema = createAutomationInputSchema.omit({ enable: true }).extend({
+  enabled: z12.boolean().optional(),
+  expectedRevision: z12.number()
+});
+var automationCheckInputSchema = z12.object({
+  mode: z12.enum(["preview", "execute"])
+});
+export {
+  DEFAULT_AGENT_ACCOUNT_ID,
+  MODEL_DISCOVERY_RUNNERS,
+  PROJECT_TAGS_MAX,
+  PROJECT_TAG_MAX_LENGTH,
+  REFERENCE_STATUS_MAX,
+  RUN_HISTORY_PAGE_ITEMS,
+  agentAccountDetailsResponseSchema,
+  agentAccountFileSchema,
+  agentAccountRouteId,
+  agentAccountSelectionSchema,
+  agentAccountStatusResponseSchema,
+  agentConfigFileContentSchema,
+  agentConfigFileSchema,
+  agentConfigFormatSchema,
+  agentConfigKindSchema,
+  agentConfigListingSchema,
+  agentConfigScopeSchema,
+  agentConfigTrackedSchema,
+  agentProfileResponseSchema,
+  agentProfileSchema,
+  agentProfileSelectionsResponseSchema,
+  agentProfilesResponseSchema,
+  apiRunSchema,
+  archiveFinishedResponseSchema,
+  automationCheckInputSchema,
+  automationCheckQueuedResponseSchema,
+  automationCheckSchema,
+  automationCountsSchema,
+  automationCursorSchema,
+  automationDefinitionSchema,
+  automationDetailResponseSchema,
+  automationEventSchema,
+  automationFiltersSchema,
+  automationListEntrySchema,
+  automationLogRecordSchema,
+  automationLogResponseSchema,
+  automationLogResultSchema,
+  automationResponseSchema,
+  automationRetryResponseSchema,
+  automationRuntimeStateSchema,
+  automationTaskSchema,
+  automationsResponseSchema,
+  backendCheckSchema,
+  cancelAutoResumeResponseSchema,
+  cancelResponseSchema,
+  capabilitiesSchema,
+  changedFileSchema,
+  changesPayloadSchema,
+  checkoutProgressEventSchema,
+  checkoutProjectInputSchema,
+  configResponseSchema,
+  continueResponseSchema,
+  createAgentProfileInputSchema,
+  createAutomationInputSchema,
+  createPrResponseSchema,
+  createRunInputBaseSchema,
+  createRunInputSchema,
+  createRunResponseSchema,
+  deleteRunResponseSchema,
+  deleteWorkflowResponseSchema,
+  diffStatSchema,
+  editQueuedMessageResponseSchema,
+  finishResponseSchema,
+  forgeInfoSchema,
+  fsBrowseDirSchema,
+  fsBrowseResponseSchema,
+  gitCommitResponseSchema,
+  gitPushResponseSchema,
+  githubChecksDataSchema,
+  githubCommentSchema,
+  githubCommentsDataSchema,
+  githubDataSchema,
+  githubItemSchema,
+  githubMergeMethodSchema,
+  githubMergeResponseSchema,
+  githubPrChangeSchema,
+  githubPrChangesDataSchema,
+  githubPrCheckSchema,
+  githubPrMergeStateResponseSchema,
+  githubPrMergeStateSchema,
+  githubRefStatusDataSchema,
+  githubTimelineEventKindSchema,
+  githubTimelineEventSchema,
+  groupResponseSchema,
+  groupVariantSchema,
+  healthResponseSchema,
+  imageInputSchema,
+  importableSkillSchema,
+  launchKeyResponseSchema,
+  logEntrySchema,
+  markAllReadResponseSchema,
+  messageInputSchema,
+  messageResponseSchema,
+  modelDiscoveryRunnerSchema,
+  openAgentAccountFileInputSchema,
+  openAgentAccountFileResponseSchema,
+  openInCliResponseSchema,
+  openProjectInResponseSchema,
+  openProjectInSchema,
+  openTargetSchema,
+  openTargetsResponseSchema,
+  parsedWorkflowSchema,
+  patchRunInputSchema,
+  pickVariantResponseSchema,
+  planResponseSchema,
+  processUsageSchema,
+  projectListEntrySchema,
+  projectsResponseSchema,
+  providerConnectResponseSchema,
+  providerConnectionStateSchema,
+  providerIdSchema,
+  providerStatusResponseSchema,
+  providerStatusSchema,
+  queuedMessageSchema,
+  reclaimWorktreesResponseSchema,
+  referenceStatusSchema,
+  referenceStatusesByProjectSchema,
+  registerProjectResponseSchema,
+  removeAgentProfileResponseSchema,
+  removeProjectResponseSchema,
+  removeQueuedMessageResponseSchema,
+  removeTodoResponseSchema,
+  removeWorktreeResponseSchema,
+  repoBranchResponseSchema,
+  repoCommitPayloadSchema,
+  repoInfoSchema,
+  repoResponseSchema,
+  runActivitySchema,
+  runCommitSchema,
+  runCommitsResponseSchema,
+  runEventSchema,
+  runEventsQuerySchema,
+  runHistoryContextSchema,
+  runHistoryCursorSchema,
+  runHistoryEventSchema,
+  runHistoryPageSchema,
+  runHistoryQuerySchema,
+  runIdParamSchema,
+  runIndexEntrySchema,
+  runRecordSchema,
+  runStatusSchema,
+  runnerDiscoversModels,
+  runnerModelCatalogResponseSchema,
+  runnerModelOptionSchema,
+  runnerModelsSchema,
+  runnerSchema,
+  runsIndexResponseSchema,
+  saveWorkflowInputSchema,
+  saveWorkflowResponseSchema,
+  selectAgentProfileInputSchema,
+  setAgentConfigInputSchema,
+  setConfigInputSchema,
+  setConfigResponseSchema,
+  setWorkspaceConfigInputSchema,
+  setWorkspaceUiStateInputSchema,
+  skillSchema,
+  skillsUpdateScopeStateSchema,
+  skillsUpdateStateSchema,
+  skillsUpdateStatusSchema,
+  startTodoResponseSchema,
+  statusEntrySchema,
+  stepStateSchema,
+  stepStatusSchema,
+  todoItemSchema,
+  uiStateSchema,
+  updateAgentProfileInputSchema,
+  updateAutomationInputSchema,
+  updateProjectInputSchema,
+  updateProjectResponseSchema,
+  userMcpListingSchema,
+  workflowDefSchema,
+  workflowLoadIssueSchema,
+  workflowStepDefSchema,
+  workflowsResponseSchema,
+  workspaceConfigResponseSchema,
+  workspaceLastLocationSchema,
+  workspaceUiStateSchema,
+  worktreeDirEntrySchema,
+  worktreeEntrySchema,
+  worktreeInfoSchema,
+  worktreesResponseSchema
+};