@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5682

package/dist/contract/activity.d.ts

@@ -0,0 +1,1478 @@
+import { z } from 'zod';
+/**
+ * The live activity view's snapshot (spec `.ai/specs/2026-11-05-live-activity-view.md`, Data):
+ * what each active task and worker does or waits for, and the open requests between tasks.
+ * `GET /api/v1/workspace/activity` answers it; the `activity` topics will carry the same shape.
+ */
+/** One bucket per second of the heartbeat strip, oldest first. */
+export declare const ACTIVITY_RATE_SECONDS = 30;
+/** A request's text and a human wait's question, as the view shows them. */
+export declare const ACTIVITY_TEXT_MAX = 500;
+/** One line of a run's error. */
+export declare const ACTIVITY_ERROR_MAX = 200;
+/** A tool call's title, as the task thread shows it. */
+export declare const ACTIVITY_TOOL_TITLE_MAX = 160;
+/** The checks a PR wait lists, and the length of one check name. */
+export declare const ACTIVITY_CHECKS_MAX = 100;
+export declare const ACTIVITY_CHECK_NAME_MAX = 100;
+/** How long a stored request outcome stays in `closed`, by its `observedAt`. */
+export declare const ACTIVITY_CLOSED_WINDOW_MS = 30000;
+/** `ToolKind` as values; `activity.test.ts` holds the two lists equal. */
+export declare const ACTIVITY_TOOL_KINDS: readonly ["read", "edit", "delete", "move", "search", "execute", "think", "fetch", "task", "plan", "other"];
+/** The latest tool call of a run: the title the task thread shows, never its input or output. */
+export declare const activityToolSchema: z.ZodObject<{
+    title: z.ZodString;
+    toolKind: z.ZodEnum<{
+        delete: "delete";
+        edit: "edit";
+        execute: "execute";
+        fetch: "fetch";
+        move: "move";
+        other: "other";
+        plan: "plan";
+        read: "read";
+        search: "search";
+        task: "task";
+        think: "think";
+    }>;
+    status: z.ZodEnum<{
+        completed: "completed";
+        declined: "declined";
+        failed: "failed";
+        pending: "pending";
+        running: "running";
+    }>;
+    startedAt: z.ZodISODateTime;
+    endedAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strict>;
+export type ActivityTool = z.infer<typeof activityToolSchema>;
+/** GitHub's check buckets (`gh pr checks --json bucket`). */
+export declare const activityCheckBucketSchema: z.ZodEnum<{
+    cancel: "cancel";
+    fail: "fail";
+    pass: "pass";
+    pending: "pending";
+    skipping: "skipping";
+}>;
+export type ActivityCheckBucket = z.infer<typeof activityCheckBucketSchema>;
+/** A PR wait's check progress. `counts` covers every check, counted before `checks` is cut to
+ *  the first `ACTIVITY_CHECKS_MAX`; `truncated` says it was cut. */
+export declare const activityPrProgressSchema: z.ZodObject<{
+    checks: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        bucket: z.ZodEnum<{
+            cancel: "cancel";
+            fail: "fail";
+            pass: "pass";
+            pending: "pending";
+            skipping: "skipping";
+        }>;
+    }, z.core.$strict>>;
+    counts: z.ZodObject<{
+        pass: z.ZodNumber;
+        fail: z.ZodNumber;
+        pending: z.ZodNumber;
+        skipping: z.ZodNumber;
+        cancel: z.ZodNumber;
+    }, z.core.$strict>;
+    truncated: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strict>;
+export type ActivityPrProgress = z.infer<typeof activityPrProgressSchema>;
+/**
+ * A run's top wait: the kind `computeWaitingOn` reports, with the detail the view needs.
+ * `since` is the earliest registration of the open entries it covers, `deadline` the earliest
+ * deadline. A usage-limit hold has no wait entry, so it has no `since`.
+ */
+export declare const activityWaitSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"human">;
+    since: z.ZodISODateTime;
+    detail: z.ZodObject<{
+        question: z.ZodOptional<z.ZodString>;
+        reason: z.ZodEnum<{
+            budget: "budget";
+            completion: "completion";
+            question: "question";
+            "turn-end": "turn-end";
+        }>;
+        queuedMessages: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"usage-limit">;
+    detail: z.ZodObject<{
+        resumeAt: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"workers">;
+    since: z.ZodISODateTime;
+    deadline: z.ZodOptional<z.ZodISODateTime>;
+    detail: z.ZodObject<{
+        owed: z.ZodNumber;
+        total: z.ZodNumber;
+        settled: z.ZodNumber;
+        replies: z.ZodOptional<z.ZodLiteral<true>>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            any: "any";
+            one: "one";
+        }>>;
+        recipientRunIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"peers">;
+    since: z.ZodISODateTime;
+    deadline: z.ZodISODateTime;
+    detail: z.ZodObject<{
+        peerRunIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"subagents">;
+    since: z.ZodISODateTime;
+    deadline: z.ZodISODateTime;
+    detail: z.ZodObject<{
+        running: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"pr">;
+    since: z.ZodISODateTime;
+    deadline: z.ZodISODateTime;
+    detail: z.ZodObject<{
+        number: z.ZodNumber;
+        target: z.ZodEnum<{
+            checks: "checks";
+            merge: "merge";
+            merge_or_blocked: "merge_or_blocked";
+        }>;
+        checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            bucket: z.ZodEnum<{
+                cancel: "cancel";
+                fail: "fail";
+                pass: "pass";
+                pending: "pending";
+                skipping: "skipping";
+            }>;
+        }, z.core.$strict>>>;
+        counts: z.ZodOptional<z.ZodObject<{
+            pass: z.ZodNumber;
+            fail: z.ZodNumber;
+            pending: z.ZodNumber;
+            skipping: z.ZodNumber;
+            cancel: z.ZodNumber;
+        }, z.core.$strict>>;
+        truncated: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"process">;
+    since: z.ZodISODateTime;
+    deadline: z.ZodISODateTime;
+    detail: z.ZodObject<{
+        pid: z.ZodNumber;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"timer">;
+    since: z.ZodISODateTime;
+    deadline: z.ZodISODateTime;
+    detail: z.ZodObject<{
+        wakeAt: z.ZodISODateTime;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "kind">;
+export type ActivityWait = z.infer<typeof activityWaitSchema>;
+/** A worker row under its root's card, settled workers included. */
+export declare const activityWorkerSchema: z.ZodObject<{
+    runId: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        queued: "queued";
+        review: "review";
+        running: "running";
+        waiting: "waiting";
+    }>;
+    rung: z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        monitoring: "monitoring";
+        "needs-permission": "needs-permission";
+        "needs-review": "needs-review";
+        "needs-you": "needs-you";
+        queued: "queued";
+        running: "running";
+        unseen: "unseen";
+        "usage-limit": "usage-limit";
+        "waiting-for-capacity": "waiting-for-capacity";
+        "waiting-for-ci": "waiting-for-ci";
+        "waiting-for-command": "waiting-for-command";
+        "waiting-for-merge": "waiting-for-merge";
+        "waiting-on-subagents": "waiting-on-subagents";
+        "waiting-on-workers": "waiting-on-workers";
+    }>;
+    runner: z.ZodOptional<z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        cursor: "cursor";
+        omp: "omp";
+        opencode: "opencode";
+        pi: "pi";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    currentStepId: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"human">;
+        since: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            question: z.ZodOptional<z.ZodString>;
+            reason: z.ZodEnum<{
+                budget: "budget";
+                completion: "completion";
+                question: "question";
+                "turn-end": "turn-end";
+            }>;
+            queuedMessages: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"usage-limit">;
+        detail: z.ZodObject<{
+            resumeAt: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"workers">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodOptional<z.ZodISODateTime>;
+        detail: z.ZodObject<{
+            owed: z.ZodNumber;
+            total: z.ZodNumber;
+            settled: z.ZodNumber;
+            replies: z.ZodOptional<z.ZodLiteral<true>>;
+            mode: z.ZodOptional<z.ZodEnum<{
+                all: "all";
+                any: "any";
+                one: "one";
+            }>>;
+            recipientRunIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"peers">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            peerRunIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"subagents">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            running: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"pr">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            number: z.ZodNumber;
+            target: z.ZodEnum<{
+                checks: "checks";
+                merge: "merge";
+                merge_or_blocked: "merge_or_blocked";
+            }>;
+            checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                bucket: z.ZodEnum<{
+                    cancel: "cancel";
+                    fail: "fail";
+                    pass: "pass";
+                    pending: "pending";
+                    skipping: "skipping";
+                }>;
+            }, z.core.$strict>>>;
+            counts: z.ZodOptional<z.ZodObject<{
+                pass: z.ZodNumber;
+                fail: z.ZodNumber;
+                pending: z.ZodNumber;
+                skipping: z.ZodNumber;
+                cancel: z.ZodNumber;
+            }, z.core.$strict>>;
+            truncated: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"process">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            pid: z.ZodNumber;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"timer">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            wakeAt: z.ZodISODateTime;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">>;
+    tool: z.ZodOptional<z.ZodObject<{
+        title: z.ZodString;
+        toolKind: z.ZodEnum<{
+            delete: "delete";
+            edit: "edit";
+            execute: "execute";
+            fetch: "fetch";
+            move: "move";
+            other: "other";
+            plan: "plan";
+            read: "read";
+            search: "search";
+            task: "task";
+            think: "think";
+        }>;
+        status: z.ZodEnum<{
+            completed: "completed";
+            declined: "declined";
+            failed: "failed";
+            pending: "pending";
+            running: "running";
+        }>;
+        startedAt: z.ZodISODateTime;
+        endedAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    rate: z.ZodArray<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    revision: z.ZodNumber;
+    collected: z.ZodBoolean;
+}, z.core.$strict>;
+export type ActivityWorker = z.infer<typeof activityWorkerSchema>;
+/** One card: an active root task (D8) with its workers. */
+export declare const activityRunSchema: z.ZodObject<{
+    runId: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        queued: "queued";
+        review: "review";
+        running: "running";
+        waiting: "waiting";
+    }>;
+    rung: z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        monitoring: "monitoring";
+        "needs-permission": "needs-permission";
+        "needs-review": "needs-review";
+        "needs-you": "needs-you";
+        queued: "queued";
+        running: "running";
+        unseen: "unseen";
+        "usage-limit": "usage-limit";
+        "waiting-for-capacity": "waiting-for-capacity";
+        "waiting-for-ci": "waiting-for-ci";
+        "waiting-for-command": "waiting-for-command";
+        "waiting-for-merge": "waiting-for-merge";
+        "waiting-on-subagents": "waiting-on-subagents";
+        "waiting-on-workers": "waiting-on-workers";
+    }>;
+    runner: z.ZodOptional<z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        cursor: "cursor";
+        omp: "omp";
+        opencode: "opencode";
+        pi: "pi";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    currentStepId: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"human">;
+        since: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            question: z.ZodOptional<z.ZodString>;
+            reason: z.ZodEnum<{
+                budget: "budget";
+                completion: "completion";
+                question: "question";
+                "turn-end": "turn-end";
+            }>;
+            queuedMessages: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"usage-limit">;
+        detail: z.ZodObject<{
+            resumeAt: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"workers">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodOptional<z.ZodISODateTime>;
+        detail: z.ZodObject<{
+            owed: z.ZodNumber;
+            total: z.ZodNumber;
+            settled: z.ZodNumber;
+            replies: z.ZodOptional<z.ZodLiteral<true>>;
+            mode: z.ZodOptional<z.ZodEnum<{
+                all: "all";
+                any: "any";
+                one: "one";
+            }>>;
+            recipientRunIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"peers">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            peerRunIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"subagents">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            running: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"pr">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            number: z.ZodNumber;
+            target: z.ZodEnum<{
+                checks: "checks";
+                merge: "merge";
+                merge_or_blocked: "merge_or_blocked";
+            }>;
+            checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                bucket: z.ZodEnum<{
+                    cancel: "cancel";
+                    fail: "fail";
+                    pass: "pass";
+                    pending: "pending";
+                    skipping: "skipping";
+                }>;
+            }, z.core.$strict>>>;
+            counts: z.ZodOptional<z.ZodObject<{
+                pass: z.ZodNumber;
+                fail: z.ZodNumber;
+                pending: z.ZodNumber;
+                skipping: z.ZodNumber;
+                cancel: z.ZodNumber;
+            }, z.core.$strict>>;
+            truncated: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"process">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            pid: z.ZodNumber;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"timer">;
+        since: z.ZodISODateTime;
+        deadline: z.ZodISODateTime;
+        detail: z.ZodObject<{
+            wakeAt: z.ZodISODateTime;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">>;
+    tool: z.ZodOptional<z.ZodObject<{
+        title: z.ZodString;
+        toolKind: z.ZodEnum<{
+            delete: "delete";
+            edit: "edit";
+            execute: "execute";
+            fetch: "fetch";
+            move: "move";
+            other: "other";
+            plan: "plan";
+            read: "read";
+            search: "search";
+            task: "task";
+            think: "think";
+        }>;
+        status: z.ZodEnum<{
+            completed: "completed";
+            declined: "declined";
+            failed: "failed";
+            pending: "pending";
+            running: "running";
+        }>;
+        startedAt: z.ZodISODateTime;
+        endedAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    rate: z.ZodArray<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    workers: z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            queued: "queued";
+            review: "review";
+            running: "running";
+            waiting: "waiting";
+        }>;
+        rung: z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            monitoring: "monitoring";
+            "needs-permission": "needs-permission";
+            "needs-review": "needs-review";
+            "needs-you": "needs-you";
+            queued: "queued";
+            running: "running";
+            unseen: "unseen";
+            "usage-limit": "usage-limit";
+            "waiting-for-capacity": "waiting-for-capacity";
+            "waiting-for-ci": "waiting-for-ci";
+            "waiting-for-command": "waiting-for-command";
+            "waiting-for-merge": "waiting-for-merge";
+            "waiting-on-subagents": "waiting-on-subagents";
+            "waiting-on-workers": "waiting-on-workers";
+        }>;
+        runner: z.ZodOptional<z.ZodEnum<{
+            claude: "claude";
+            codex: "codex";
+            cursor: "cursor";
+            omp: "omp";
+            opencode: "opencode";
+            pi: "pi";
+        }>>;
+        model: z.ZodOptional<z.ZodString>;
+        currentStepId: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"human">;
+            since: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                question: z.ZodOptional<z.ZodString>;
+                reason: z.ZodEnum<{
+                    budget: "budget";
+                    completion: "completion";
+                    question: "question";
+                    "turn-end": "turn-end";
+                }>;
+                queuedMessages: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"usage-limit">;
+            detail: z.ZodObject<{
+                resumeAt: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"workers">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodOptional<z.ZodISODateTime>;
+            detail: z.ZodObject<{
+                owed: z.ZodNumber;
+                total: z.ZodNumber;
+                settled: z.ZodNumber;
+                replies: z.ZodOptional<z.ZodLiteral<true>>;
+                mode: z.ZodOptional<z.ZodEnum<{
+                    all: "all";
+                    any: "any";
+                    one: "one";
+                }>>;
+                recipientRunIds: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"peers">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                peerRunIds: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"subagents">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                running: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"pr">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                number: z.ZodNumber;
+                target: z.ZodEnum<{
+                    checks: "checks";
+                    merge: "merge";
+                    merge_or_blocked: "merge_or_blocked";
+                }>;
+                checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    bucket: z.ZodEnum<{
+                        cancel: "cancel";
+                        fail: "fail";
+                        pass: "pass";
+                        pending: "pending";
+                        skipping: "skipping";
+                    }>;
+                }, z.core.$strict>>>;
+                counts: z.ZodOptional<z.ZodObject<{
+                    pass: z.ZodNumber;
+                    fail: z.ZodNumber;
+                    pending: z.ZodNumber;
+                    skipping: z.ZodNumber;
+                    cancel: z.ZodNumber;
+                }, z.core.$strict>>;
+                truncated: z.ZodOptional<z.ZodLiteral<true>>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"process">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                pid: z.ZodNumber;
+                note: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"timer">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                wakeAt: z.ZodISODateTime;
+                note: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>], "kind">>;
+        tool: z.ZodOptional<z.ZodObject<{
+            title: z.ZodString;
+            toolKind: z.ZodEnum<{
+                delete: "delete";
+                edit: "edit";
+                execute: "execute";
+                fetch: "fetch";
+                move: "move";
+                other: "other";
+                plan: "plan";
+                read: "read";
+                search: "search";
+                task: "task";
+                think: "think";
+            }>;
+            status: z.ZodEnum<{
+                completed: "completed";
+                declined: "declined";
+                failed: "failed";
+                pending: "pending";
+                running: "running";
+            }>;
+            startedAt: z.ZodISODateTime;
+            endedAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strict>>;
+        rate: z.ZodArray<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+        revision: z.ZodNumber;
+        collected: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ActivityRun = z.infer<typeof activityRunSchema>;
+/** An open request: no outcome in its ledger (D2). A title is absent when its record cannot be read. */
+export declare const activityRequestSchema: z.ZodObject<{
+    requestId: z.ZodUUID;
+    relationship: z.ZodEnum<{
+        family: "family";
+        peer: "peer";
+    }>;
+    senderRunId: z.ZodString;
+    recipientRunId: z.ZodString;
+    text: z.ZodString;
+    senderTitle: z.ZodOptional<z.ZodString>;
+    recipientTitle: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    deadline: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strict>;
+export type ActivityRequest = z.infer<typeof activityRequestSchema>;
+/** An outcome a ledger stores, observed in the last `ACTIVITY_CLOSED_WINDOW_MS`. */
+export declare const activityClosedRequestSchema: z.ZodObject<{
+    requestId: z.ZodUUID;
+    senderRunId: z.ZodString;
+    recipientRunId: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        "completed-without-reply": "completed-without-reply";
+        deleted: "deleted";
+        destroyed: "destroyed";
+        failed: "failed";
+        "human-fallback": "human-fallback";
+        replied: "replied";
+        "replied-late": "replied-late";
+        "sender-closed": "sender-closed";
+        "timed-out": "timed-out";
+    }>;
+    observedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type ActivityClosedRequest = z.infer<typeof activityClosedRequestSchema>;
+export declare const activityProjectSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    name: z.ZodString;
+    loaded: z.ZodBoolean;
+    unavailable: z.ZodOptional<z.ZodObject<{
+        status: z.ZodUnion<readonly [z.ZodLiteral<404>, z.ZodLiteral<409>, z.ZodLiteral<503>]>;
+        error: z.ZodString;
+    }, z.core.$strict>>;
+    inReview: z.ZodNumber;
+    tasks: z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            queued: "queued";
+            review: "review";
+            running: "running";
+            waiting: "waiting";
+        }>;
+        rung: z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            monitoring: "monitoring";
+            "needs-permission": "needs-permission";
+            "needs-review": "needs-review";
+            "needs-you": "needs-you";
+            queued: "queued";
+            running: "running";
+            unseen: "unseen";
+            "usage-limit": "usage-limit";
+            "waiting-for-capacity": "waiting-for-capacity";
+            "waiting-for-ci": "waiting-for-ci";
+            "waiting-for-command": "waiting-for-command";
+            "waiting-for-merge": "waiting-for-merge";
+            "waiting-on-subagents": "waiting-on-subagents";
+            "waiting-on-workers": "waiting-on-workers";
+        }>;
+        runner: z.ZodOptional<z.ZodEnum<{
+            claude: "claude";
+            codex: "codex";
+            cursor: "cursor";
+            omp: "omp";
+            opencode: "opencode";
+            pi: "pi";
+        }>>;
+        model: z.ZodOptional<z.ZodString>;
+        currentStepId: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"human">;
+            since: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                question: z.ZodOptional<z.ZodString>;
+                reason: z.ZodEnum<{
+                    budget: "budget";
+                    completion: "completion";
+                    question: "question";
+                    "turn-end": "turn-end";
+                }>;
+                queuedMessages: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"usage-limit">;
+            detail: z.ZodObject<{
+                resumeAt: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"workers">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodOptional<z.ZodISODateTime>;
+            detail: z.ZodObject<{
+                owed: z.ZodNumber;
+                total: z.ZodNumber;
+                settled: z.ZodNumber;
+                replies: z.ZodOptional<z.ZodLiteral<true>>;
+                mode: z.ZodOptional<z.ZodEnum<{
+                    all: "all";
+                    any: "any";
+                    one: "one";
+                }>>;
+                recipientRunIds: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"peers">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                peerRunIds: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"subagents">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                running: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"pr">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                number: z.ZodNumber;
+                target: z.ZodEnum<{
+                    checks: "checks";
+                    merge: "merge";
+                    merge_or_blocked: "merge_or_blocked";
+                }>;
+                checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    bucket: z.ZodEnum<{
+                        cancel: "cancel";
+                        fail: "fail";
+                        pass: "pass";
+                        pending: "pending";
+                        skipping: "skipping";
+                    }>;
+                }, z.core.$strict>>>;
+                counts: z.ZodOptional<z.ZodObject<{
+                    pass: z.ZodNumber;
+                    fail: z.ZodNumber;
+                    pending: z.ZodNumber;
+                    skipping: z.ZodNumber;
+                    cancel: z.ZodNumber;
+                }, z.core.$strict>>;
+                truncated: z.ZodOptional<z.ZodLiteral<true>>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"process">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                pid: z.ZodNumber;
+                note: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"timer">;
+            since: z.ZodISODateTime;
+            deadline: z.ZodISODateTime;
+            detail: z.ZodObject<{
+                wakeAt: z.ZodISODateTime;
+                note: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>], "kind">>;
+        tool: z.ZodOptional<z.ZodObject<{
+            title: z.ZodString;
+            toolKind: z.ZodEnum<{
+                delete: "delete";
+                edit: "edit";
+                execute: "execute";
+                fetch: "fetch";
+                move: "move";
+                other: "other";
+                plan: "plan";
+                read: "read";
+                search: "search";
+                task: "task";
+                think: "think";
+            }>;
+            status: z.ZodEnum<{
+                completed: "completed";
+                declined: "declined";
+                failed: "failed";
+                pending: "pending";
+                running: "running";
+            }>;
+            startedAt: z.ZodISODateTime;
+            endedAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strict>>;
+        rate: z.ZodArray<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+        workers: z.ZodArray<z.ZodObject<{
+            runId: z.ZodString;
+            title: z.ZodString;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                queued: "queued";
+                review: "review";
+                running: "running";
+                waiting: "waiting";
+            }>;
+            rung: z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                monitoring: "monitoring";
+                "needs-permission": "needs-permission";
+                "needs-review": "needs-review";
+                "needs-you": "needs-you";
+                queued: "queued";
+                running: "running";
+                unseen: "unseen";
+                "usage-limit": "usage-limit";
+                "waiting-for-capacity": "waiting-for-capacity";
+                "waiting-for-ci": "waiting-for-ci";
+                "waiting-for-command": "waiting-for-command";
+                "waiting-for-merge": "waiting-for-merge";
+                "waiting-on-subagents": "waiting-on-subagents";
+                "waiting-on-workers": "waiting-on-workers";
+            }>;
+            runner: z.ZodOptional<z.ZodEnum<{
+                claude: "claude";
+                codex: "codex";
+                cursor: "cursor";
+                omp: "omp";
+                opencode: "opencode";
+                pi: "pi";
+            }>>;
+            model: z.ZodOptional<z.ZodString>;
+            currentStepId: z.ZodOptional<z.ZodString>;
+            startedAt: z.ZodOptional<z.ZodString>;
+            wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"human">;
+                since: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    question: z.ZodOptional<z.ZodString>;
+                    reason: z.ZodEnum<{
+                        budget: "budget";
+                        completion: "completion";
+                        question: "question";
+                        "turn-end": "turn-end";
+                    }>;
+                    queuedMessages: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"usage-limit">;
+                detail: z.ZodObject<{
+                    resumeAt: z.ZodString;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"workers">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodOptional<z.ZodISODateTime>;
+                detail: z.ZodObject<{
+                    owed: z.ZodNumber;
+                    total: z.ZodNumber;
+                    settled: z.ZodNumber;
+                    replies: z.ZodOptional<z.ZodLiteral<true>>;
+                    mode: z.ZodOptional<z.ZodEnum<{
+                        all: "all";
+                        any: "any";
+                        one: "one";
+                    }>>;
+                    recipientRunIds: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"peers">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    peerRunIds: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"subagents">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    running: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"pr">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    number: z.ZodNumber;
+                    target: z.ZodEnum<{
+                        checks: "checks";
+                        merge: "merge";
+                        merge_or_blocked: "merge_or_blocked";
+                    }>;
+                    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        bucket: z.ZodEnum<{
+                            cancel: "cancel";
+                            fail: "fail";
+                            pass: "pass";
+                            pending: "pending";
+                            skipping: "skipping";
+                        }>;
+                    }, z.core.$strict>>>;
+                    counts: z.ZodOptional<z.ZodObject<{
+                        pass: z.ZodNumber;
+                        fail: z.ZodNumber;
+                        pending: z.ZodNumber;
+                        skipping: z.ZodNumber;
+                        cancel: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    truncated: z.ZodOptional<z.ZodLiteral<true>>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"process">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    pid: z.ZodNumber;
+                    note: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"timer">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    wakeAt: z.ZodISODateTime;
+                    note: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>], "kind">>;
+            tool: z.ZodOptional<z.ZodObject<{
+                title: z.ZodString;
+                toolKind: z.ZodEnum<{
+                    delete: "delete";
+                    edit: "edit";
+                    execute: "execute";
+                    fetch: "fetch";
+                    move: "move";
+                    other: "other";
+                    plan: "plan";
+                    read: "read";
+                    search: "search";
+                    task: "task";
+                    think: "think";
+                }>;
+                status: z.ZodEnum<{
+                    completed: "completed";
+                    declined: "declined";
+                    failed: "failed";
+                    pending: "pending";
+                    running: "running";
+                }>;
+                startedAt: z.ZodISODateTime;
+                endedAt: z.ZodOptional<z.ZodISODateTime>;
+            }, z.core.$strict>>;
+            rate: z.ZodArray<z.ZodNumber>;
+            error: z.ZodOptional<z.ZodString>;
+            revision: z.ZodNumber;
+            collected: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    requests: z.ZodArray<z.ZodObject<{
+        requestId: z.ZodUUID;
+        relationship: z.ZodEnum<{
+            family: "family";
+            peer: "peer";
+        }>;
+        senderRunId: z.ZodString;
+        recipientRunId: z.ZodString;
+        text: z.ZodString;
+        senderTitle: z.ZodOptional<z.ZodString>;
+        recipientTitle: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodISODateTime;
+        deadline: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    closed: z.ZodArray<z.ZodObject<{
+        requestId: z.ZodUUID;
+        senderRunId: z.ZodString;
+        recipientRunId: z.ZodString;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            "completed-without-reply": "completed-without-reply";
+            deleted: "deleted";
+            destroyed: "destroyed";
+            failed: "failed";
+            "human-fallback": "human-fallback";
+            replied: "replied";
+            "replied-late": "replied-late";
+            "sender-closed": "sender-closed";
+            "timed-out": "timed-out";
+        }>;
+        observedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ActivityProject = z.infer<typeof activityProjectSchema>;
+export declare const activitySnapshotSchema: z.ZodObject<{
+    generatedAt: z.ZodISODateTime;
+    projects: z.ZodArray<z.ZodObject<{
+        projectId: z.ZodString;
+        name: z.ZodString;
+        loaded: z.ZodBoolean;
+        unavailable: z.ZodOptional<z.ZodObject<{
+            status: z.ZodUnion<readonly [z.ZodLiteral<404>, z.ZodLiteral<409>, z.ZodLiteral<503>]>;
+            error: z.ZodString;
+        }, z.core.$strict>>;
+        inReview: z.ZodNumber;
+        tasks: z.ZodArray<z.ZodObject<{
+            runId: z.ZodString;
+            title: z.ZodString;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                queued: "queued";
+                review: "review";
+                running: "running";
+                waiting: "waiting";
+            }>;
+            rung: z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+                monitoring: "monitoring";
+                "needs-permission": "needs-permission";
+                "needs-review": "needs-review";
+                "needs-you": "needs-you";
+                queued: "queued";
+                running: "running";
+                unseen: "unseen";
+                "usage-limit": "usage-limit";
+                "waiting-for-capacity": "waiting-for-capacity";
+                "waiting-for-ci": "waiting-for-ci";
+                "waiting-for-command": "waiting-for-command";
+                "waiting-for-merge": "waiting-for-merge";
+                "waiting-on-subagents": "waiting-on-subagents";
+                "waiting-on-workers": "waiting-on-workers";
+            }>;
+            runner: z.ZodOptional<z.ZodEnum<{
+                claude: "claude";
+                codex: "codex";
+                cursor: "cursor";
+                omp: "omp";
+                opencode: "opencode";
+                pi: "pi";
+            }>>;
+            model: z.ZodOptional<z.ZodString>;
+            currentStepId: z.ZodOptional<z.ZodString>;
+            startedAt: z.ZodOptional<z.ZodString>;
+            wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"human">;
+                since: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    question: z.ZodOptional<z.ZodString>;
+                    reason: z.ZodEnum<{
+                        budget: "budget";
+                        completion: "completion";
+                        question: "question";
+                        "turn-end": "turn-end";
+                    }>;
+                    queuedMessages: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"usage-limit">;
+                detail: z.ZodObject<{
+                    resumeAt: z.ZodString;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"workers">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodOptional<z.ZodISODateTime>;
+                detail: z.ZodObject<{
+                    owed: z.ZodNumber;
+                    total: z.ZodNumber;
+                    settled: z.ZodNumber;
+                    replies: z.ZodOptional<z.ZodLiteral<true>>;
+                    mode: z.ZodOptional<z.ZodEnum<{
+                        all: "all";
+                        any: "any";
+                        one: "one";
+                    }>>;
+                    recipientRunIds: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"peers">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    peerRunIds: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"subagents">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    running: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"pr">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    number: z.ZodNumber;
+                    target: z.ZodEnum<{
+                        checks: "checks";
+                        merge: "merge";
+                        merge_or_blocked: "merge_or_blocked";
+                    }>;
+                    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        bucket: z.ZodEnum<{
+                            cancel: "cancel";
+                            fail: "fail";
+                            pass: "pass";
+                            pending: "pending";
+                            skipping: "skipping";
+                        }>;
+                    }, z.core.$strict>>>;
+                    counts: z.ZodOptional<z.ZodObject<{
+                        pass: z.ZodNumber;
+                        fail: z.ZodNumber;
+                        pending: z.ZodNumber;
+                        skipping: z.ZodNumber;
+                        cancel: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    truncated: z.ZodOptional<z.ZodLiteral<true>>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"process">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    pid: z.ZodNumber;
+                    note: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"timer">;
+                since: z.ZodISODateTime;
+                deadline: z.ZodISODateTime;
+                detail: z.ZodObject<{
+                    wakeAt: z.ZodISODateTime;
+                    note: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>], "kind">>;
+            tool: z.ZodOptional<z.ZodObject<{
+                title: z.ZodString;
+                toolKind: z.ZodEnum<{
+                    delete: "delete";
+                    edit: "edit";
+                    execute: "execute";
+                    fetch: "fetch";
+                    move: "move";
+                    other: "other";
+                    plan: "plan";
+                    read: "read";
+                    search: "search";
+                    task: "task";
+                    think: "think";
+                }>;
+                status: z.ZodEnum<{
+                    completed: "completed";
+                    declined: "declined";
+                    failed: "failed";
+                    pending: "pending";
+                    running: "running";
+                }>;
+                startedAt: z.ZodISODateTime;
+                endedAt: z.ZodOptional<z.ZodISODateTime>;
+            }, z.core.$strict>>;
+            rate: z.ZodArray<z.ZodNumber>;
+            error: z.ZodOptional<z.ZodString>;
+            workers: z.ZodArray<z.ZodObject<{
+                runId: z.ZodString;
+                title: z.ZodString;
+                status: z.ZodEnum<{
+                    cancelled: "cancelled";
+                    done: "done";
+                    failed: "failed";
+                    queued: "queued";
+                    review: "review";
+                    running: "running";
+                    waiting: "waiting";
+                }>;
+                rung: z.ZodEnum<{
+                    cancelled: "cancelled";
+                    done: "done";
+                    failed: "failed";
+                    monitoring: "monitoring";
+                    "needs-permission": "needs-permission";
+                    "needs-review": "needs-review";
+                    "needs-you": "needs-you";
+                    queued: "queued";
+                    running: "running";
+                    unseen: "unseen";
+                    "usage-limit": "usage-limit";
+                    "waiting-for-capacity": "waiting-for-capacity";
+                    "waiting-for-ci": "waiting-for-ci";
+                    "waiting-for-command": "waiting-for-command";
+                    "waiting-for-merge": "waiting-for-merge";
+                    "waiting-on-subagents": "waiting-on-subagents";
+                    "waiting-on-workers": "waiting-on-workers";
+                }>;
+                runner: z.ZodOptional<z.ZodEnum<{
+                    claude: "claude";
+                    codex: "codex";
+                    cursor: "cursor";
+                    omp: "omp";
+                    opencode: "opencode";
+                    pi: "pi";
+                }>>;
+                model: z.ZodOptional<z.ZodString>;
+                currentStepId: z.ZodOptional<z.ZodString>;
+                startedAt: z.ZodOptional<z.ZodString>;
+                wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"human">;
+                    since: z.ZodISODateTime;
+                    detail: z.ZodObject<{
+                        question: z.ZodOptional<z.ZodString>;
+                        reason: z.ZodEnum<{
+                            budget: "budget";
+                            completion: "completion";
+                            question: "question";
+                            "turn-end": "turn-end";
+                        }>;
+                        queuedMessages: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"usage-limit">;
+                    detail: z.ZodObject<{
+                        resumeAt: z.ZodString;
+                    }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"workers">;
+                    since: z.ZodISODateTime;
+                    deadline: z.ZodOptional<z.ZodISODateTime>;
+                    detail: z.ZodObject<{
+                        owed: z.ZodNumber;
+                        total: z.ZodNumber;
+                        settled: z.ZodNumber;
+                        replies: z.ZodOptional<z.ZodLiteral<true>>;
+                        mode: z.ZodOptional<z.ZodEnum<{
+                            all: "all";
+                            any: "any";
+                            one: "one";
+                        }>>;
+                        recipientRunIds: z.ZodArray<z.ZodString>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"peers">;
+                    since: z.ZodISODateTime;
+                    deadline: z.ZodISODateTime;
+                    detail: z.ZodObject<{
+                        peerRunIds: z.ZodArray<z.ZodString>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"subagents">;
+                    since: z.ZodISODateTime;
+                    deadline: z.ZodISODateTime;
+                    detail: z.ZodObject<{
+                        running: z.ZodNumber;
+                    }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"pr">;
+                    since: z.ZodISODateTime;
+                    deadline: z.ZodISODateTime;
+                    detail: z.ZodObject<{
+                        number: z.ZodNumber;
+                        target: z.ZodEnum<{
+                            checks: "checks";
+                            merge: "merge";
+                            merge_or_blocked: "merge_or_blocked";
+                        }>;
+                        checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            name: z.ZodString;
+                            bucket: z.ZodEnum<{
+                                cancel: "cancel";
+                                fail: "fail";
+                                pass: "pass";
+                                pending: "pending";
+                                skipping: "skipping";
+                            }>;
+                        }, z.core.$strict>>>;
+                        counts: z.ZodOptional<z.ZodObject<{
+                            pass: z.ZodNumber;
+                            fail: z.ZodNumber;
+                            pending: z.ZodNumber;
+                            skipping: z.ZodNumber;
+                            cancel: z.ZodNumber;
+                        }, z.core.$strict>>;
+                        truncated: z.ZodOptional<z.ZodLiteral<true>>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"process">;
+                    since: z.ZodISODateTime;
+                    deadline: z.ZodISODateTime;
+                    detail: z.ZodObject<{
+                        pid: z.ZodNumber;
+                        note: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"timer">;
+                    since: z.ZodISODateTime;
+                    deadline: z.ZodISODateTime;
+                    detail: z.ZodObject<{
+                        wakeAt: z.ZodISODateTime;
+                        note: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>], "kind">>;
+                tool: z.ZodOptional<z.ZodObject<{
+                    title: z.ZodString;
+                    toolKind: z.ZodEnum<{
+                        delete: "delete";
+                        edit: "edit";
+                        execute: "execute";
+                        fetch: "fetch";
+                        move: "move";
+                        other: "other";
+                        plan: "plan";
+                        read: "read";
+                        search: "search";
+                        task: "task";
+                        think: "think";
+                    }>;
+                    status: z.ZodEnum<{
+                        completed: "completed";
+                        declined: "declined";
+                        failed: "failed";
+                        pending: "pending";
+                        running: "running";
+                    }>;
+                    startedAt: z.ZodISODateTime;
+                    endedAt: z.ZodOptional<z.ZodISODateTime>;
+                }, z.core.$strict>>;
+                rate: z.ZodArray<z.ZodNumber>;
+                error: z.ZodOptional<z.ZodString>;
+                revision: z.ZodNumber;
+                collected: z.ZodBoolean;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        requests: z.ZodArray<z.ZodObject<{
+            requestId: z.ZodUUID;
+            relationship: z.ZodEnum<{
+                family: "family";
+                peer: "peer";
+            }>;
+            senderRunId: z.ZodString;
+            recipientRunId: z.ZodString;
+            text: z.ZodString;
+            senderTitle: z.ZodOptional<z.ZodString>;
+            recipientTitle: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodISODateTime;
+            deadline: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strict>>;
+        closed: z.ZodArray<z.ZodObject<{
+            requestId: z.ZodUUID;
+            senderRunId: z.ZodString;
+            recipientRunId: z.ZodString;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                "completed-without-reply": "completed-without-reply";
+                deleted: "deleted";
+                destroyed: "destroyed";
+                failed: "failed";
+                "human-fallback": "human-fallback";
+                replied: "replied";
+                "replied-late": "replied-late";
+                "sender-closed": "sender-closed";
+                "timed-out": "timed-out";
+            }>;
+            observedAt: z.ZodISODateTime;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ActivitySnapshot = z.infer<typeof activitySnapshotSchema>;
+/** `GET /workspace/activity`: one project, or every project without `project`. */
+export declare const activityQuerySchema: z.ZodObject<{
+    project: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"default">, z.ZodString]>>;
+}, z.core.$strip>;
+export type ActivityQuery = z.infer<typeof activityQuerySchema>;