@synap-core/cli 1.12.2 → 1.13.0

package/dist/commands/worker-accounts.test.js

@@ -0,0 +1,224 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { AccountPool, loadAccountsFile, probeAccount, reserveIds, selectAccount, standingOf, } from "./worker-accounts.js";
+const T = Date.parse("2026-10-24T06:00:00Z");
+const H = 3_600_000;
+const meter = (m) => ({ rejected: false, checkedAt: T, ...m });
+const room = (m) => ({ kind: "room", meter: meter(m) });
+const file = (over = {}) => ({
+    version: 1,
+    reserve: 0,
+    accounts: [
+        { id: "dev", label: "Dev", token: "tok-dev", design: true },
+        { id: "a", label: "A", token: "tok-a" },
+        { id: "b", label: "B", token: "tok-b" },
+        { id: "c", label: "C", token: "tok-c" },
+    ],
+    ...over,
+});
+describe("selectAccount", () => {
+    it("picks the account whose 5-hour window resets soonest (use it or lose it)", () => {
+        const s = new Map([
+            ["dev", room({ fiveHour: 10, fiveHourReset: T + 4 * H, week: 10 })],
+            ["a", room({ fiveHour: 10, fiveHourReset: T + 3 * H, week: 10 })],
+            ["b", room({ fiveHour: 50, fiveHourReset: T + 1 * H, week: 10 })],
+            ["c", room({ fiveHour: 10, fiveHourReset: T + 2 * H, week: 10 })],
+        ]);
+        expect(selectAccount(file(), s, { design: false }).account?.id).toBe("b");
+    });
+    it("ties on the reset go to file order", () => {
+        const s = new Map([
+            ["a", room({ fiveHourReset: T + H })],
+            ["b", room({ fiveHourReset: T + H })],
+        ]);
+        expect(selectAccount(file(), s, { design: false }).account?.id).toBe("a");
+    });
+    it("leaves out the reserve: the non-design accounts with the most WEEKLY room left", () => {
+        // b resets soonest, but b and c have the most weekly room: they stay for the person.
+        const s = new Map([
+            ["dev", room({ fiveHourReset: T + 5 * H, week: 90 })],
+            ["a", room({ fiveHourReset: T + 3 * H, week: 80 })],
+            ["b", room({ fiveHourReset: T + 1 * H, week: 5 })],
+            ["c", room({ fiveHourReset: T + 2 * H, week: 20 })],
+        ]);
+        expect([...reserveIds(file().accounts, s, 2)].sort()).toEqual(["b", "c"]);
+        expect(selectAccount(file({ reserve: 2 }), s, { design: false }).account?.id).toBe("a");
+    });
+    it("the design account is never counted in the reserve", () => {
+        const s = new Map([
+            ["dev", room({ week: 0 })],
+            ["a", room({ week: 50 })],
+            ["b", room({ week: 60 })],
+        ]);
+        expect([...reserveIds(file().accounts, s, 1)]).toEqual(["a"]);
+    });
+    it("an UNMEASURED account is never picked — a failed probe is not room", () => {
+        const s = new Map([
+            ["a", { kind: "unmeasured", reason: "probe failed: TypeError" }],
+            ["b", { kind: "refused", reason: "HTTP 401" }],
+            ["c", { kind: "full", until: T + H }],
+        ]);
+        const sel = selectAccount(file(), s, { design: false });
+        expect(sel.account).toBeUndefined();
+        expect(sel.reason).toMatch(/a: unmeasured/);
+    });
+    it("an unmeasured account is never READ as full either: it is not reserved in place of a measured one", () => {
+        const s = new Map([
+            ["a", { kind: "unmeasured", reason: "x" }],
+            ["b", room({ week: 10 })],
+            ["c", room({ week: 30 })],
+        ]);
+        // b has the most weekly room among the MEASURED (90% left); a is not ranked at all.
+        expect([...reserveIds(file().accounts, s, 1)]).toEqual(["b"]);
+        expect(selectAccount(file({ reserve: 1 }), s, { design: false }).account?.id).toBe("c");
+    });
+    it("a design run takes ONLY the design account, and waits when it has no room", () => {
+        const s = new Map([
+            ["dev", { kind: "full", until: T + H }],
+            ["a", room({ fiveHourReset: T + H })],
+        ]);
+        const sel = selectAccount(file(), s, { design: true });
+        expect(sel.account).toBeUndefined();
+        expect(sel.reason).toMatch(/no design account with room/);
+        s.set("dev", room({ fiveHourReset: T + 9 * H }));
+        expect(selectAccount(file(), s, { design: true }).account?.id).toBe("dev");
+    });
+    it("another run spends the design account only when no other account has room", () => {
+        // dev resets soonest, yet a takes the run: dev's quota stays for the designs.
+        const s = new Map([
+            ["dev", room({ fiveHourReset: T + 1 * H })],
+            ["a", room({ fiveHourReset: T + 4 * H })],
+            ["b", { kind: "full", until: T + H }],
+            ["c", { kind: "full", until: T + H }],
+        ]);
+        expect(selectAccount(file(), s, { design: false }).account?.id).toBe("a");
+        s.set("a", { kind: "full", until: T + H });
+        expect(selectAccount(file(), s, { design: false }).account?.id).toBe("dev");
+    });
+    it("a design run with no design account flagged is refused in words", () => {
+        const f = file({ accounts: [{ id: "a", label: "A", token: "t" }] });
+        expect(selectAccount(f, new Map([["a", room({})]]), { design: true }).reason).toMatch(/flagged design/);
+    });
+});
+describe("standingOf", () => {
+    it("over the threshold is full until the binding window resets", () => {
+        const s = standingOf({ kind: "measured", meter: meter({ fiveHour: 96, fiveHourReset: T + H, week: 10 }) }, undefined, T);
+        expect(s).toMatchObject({ kind: "full", until: T + H });
+    });
+    it("a full window whose reset passed is unmeasured until measured again — not room", () => {
+        const s = standingOf({ kind: "measured", meter: meter({ fiveHour: 100, fiveHourReset: T - 1 }) }, undefined, T);
+        expect(s.kind).toBe("unmeasured");
+    });
+    it("a run's limit mark wins over an older probe", () => {
+        const s = standingOf({ kind: "measured", meter: meter({ fiveHour: 1 }) }, T + H, T);
+        expect(s).toMatchObject({ kind: "full", until: T + H });
+    });
+});
+const headers = (h) => Object.fromEntries(Object.entries(h).map(([k, v]) => [`anthropic-ratelimit-unified-${k}`, v]));
+const respond = (status, h = {}, body = {}) => new Response(JSON.stringify(body), { status, headers: { "content-type": "application/json", ...headers(h) } });
+describe("probeAccount (ported from ClaudeSwitch probeOnce)", () => {
+    it("200 → measured, utilization as percent, resets in ms", async () => {
+        let sent;
+        const r = await probeAccount("sk-ant-oat-x", {
+            now: () => T,
+            fetchImpl: (async (_u, init) => {
+                sent = init;
+                return respond(200, { status: "allowed", "5h-utilization": "0.25", "5h-reset": "1792725000", "7d-utilization": "0.5", "7d-reset": "1793000000" });
+            }),
+        });
+        expect(r).toEqual({
+            kind: "measured",
+            meter: expect.objectContaining({ fiveHour: 25, fiveHourReset: 1792725000_000, week: 50, weekReset: 1793000000_000, rejected: false }),
+        });
+        const h = sent?.headers;
+        expect(h.Authorization).toBe("Bearer sk-ant-oat-x");
+        expect(h["anthropic-beta"]).toBe("oauth-2025-04-20");
+        expect(JSON.parse(String(sent?.body)).max_tokens).toBe(1);
+    });
+    it("429 rejected → measured full; 429 without rejected → a burst, unmeasured", async () => {
+        const full = await probeAccount("t", { fetchImpl: (async () => respond(429, { status: "rejected", reset: "1792725000" })) });
+        expect(full).toMatchObject({ kind: "measured", meter: { rejected: true } });
+        const burst = await probeAccount("t", { fetchImpl: (async () => respond(429, {})) });
+        expect(burst).toEqual({ kind: "unmeasured", reason: "briefly rate limited" });
+    });
+    it("401/403 → refused", async () => {
+        const r = await probeAccount("t", { fetchImpl: (async () => respond(401, {}, { error: { message: "invalid token" } })) });
+        expect(r).toEqual({ kind: "refused", reason: "invalid token" });
+    });
+    it("a missing model tries the next one", async () => {
+        const models = [];
+        const r = await probeAccount("t", {
+            models: ["gone-model", "live-model"],
+            fetchImpl: (async (_u, init) => {
+                const m = JSON.parse(String(init?.body)).model;
+                models.push(m);
+                return m === "gone-model" ? respond(404, {}, { error: { type: "not_found_error", message: "model: gone" } }) : respond(200, { "5h-utilization": "0" });
+            }),
+        });
+        expect(models).toEqual(["gone-model", "live-model"]);
+        expect(r.kind).toBe("measured");
+    });
+    it("a network failure is UNMEASURED, never room and never full", async () => {
+        const r = await probeAccount("t", { fetchImpl: (async () => { throw new TypeError("fetch failed"); }) });
+        expect(r.kind).toBe("unmeasured");
+        expect(standingOf(r, undefined, T).kind).toBe("unmeasured");
+    });
+});
+describe("AccountPool", () => {
+    it("reuses a fresh measurement, and a limit mark keeps the account out without probing it", async () => {
+        let t = T;
+        const probed = [];
+        const probe = async (token) => {
+            probed.push(token);
+            return { kind: "measured", meter: meter({ fiveHour: 10, fiveHourReset: T + H, checkedAt: t }) };
+        };
+        const pool = new AccountPool(file({ accounts: file().accounts.slice(1, 3) }), probe, () => t);
+        await pool.measure();
+        await pool.measure();
+        expect(probed).toEqual(["tok-a", "tok-b"]);
+        pool.markFull("a", T + H);
+        t += 4 * 60_000;
+        await pool.measure();
+        expect(probed).toEqual(["tok-a", "tok-b", "tok-b"]);
+        expect(pool.select({ design: false }).account?.id).toBe("b");
+    });
+});
+describe("loadAccountsFile", () => {
+    const dir = () => fs.mkdtempSync(path.join(os.tmpdir(), "worker-accounts-"));
+    it("no default file → null (the environment's login, as before)", () => {
+        expect(loadAccountsFile(undefined)).toBeNull();
+    });
+    it("a named file that is missing throws", () => {
+        expect(() => loadAccountsFile(path.join(dir(), "nope.json"))).toThrow(/does not exist/);
+    });
+    it("a broken file throws — never 'no accounts' — and never quotes a token", () => {
+        const f = path.join(dir(), "accounts.json");
+        fs.writeFileSync(f, '{"version":1,"accounts":[{"id":"a","token":"sk-ant-oat-SECRET"}');
+        expect(() => loadAccountsFile(f)).toThrow(/not valid JSON/);
+        fs.writeFileSync(f, JSON.stringify({ version: 1, accounts: [{ id: "a b", token: "sk-ant-oat-SECRET" }] }));
+        let msg = "";
+        try {
+            loadAccountsFile(f);
+        }
+        catch (err) {
+            msg = err.message;
+        }
+        expect(msg).toMatch(/id must match/);
+        expect(msg).not.toContain("SECRET");
+    });
+    it("reads the documented shape", () => {
+        const f = path.join(dir(), "accounts.json");
+        fs.writeFileSync(f, JSON.stringify({ version: 1, reserve: 2, accounts: [{ id: "dev", label: "Dev", token: " t1 ", design: true }, { id: "a", token: "t2" }] }));
+        expect(loadAccountsFile(f)).toEqual({
+            version: 1,
+            reserve: 2,
+            accounts: [
+                { id: "dev", label: "Dev", token: "t1", design: true },
+                { id: "a", label: "a", token: "t2" },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=worker-accounts.test.js.map

package/dist/commands/worker-accounts.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-accounts.test.js","sourceRoot":"","sources":["../../src/commands/worker-accounts.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/worker.d.ts

@@ -21,10 +21,28 @@
  * variables are removed from the launched environment so a stray key can never
  * silently switch billing away from the subscription.
  *
+ * Several Claude accounts (`--accounts <file>`, default
+ * ~/.config/synap-worker/accounts.json when it exists): before each launch the
+ * accounts are measured and one is picked (worker-accounts.ts); its token goes
+ * into the run's environment only. A run cut off by a usage limit marks that
+ * account full and is RESUMED (same Claude conversation) on the next account.
+ *
+ * A DESIGN run (the session declares an outcome of kind "design") launches as
+ * `claude --bg` — the only mode that has the Artifact tool — on the account
+ * flagged `design`, and is watched through `claude agents --json` and its
+ * transcript.
+ *
+ * Two PROTOCOLS (`sessionProtocol`): a CODE session is worked in a git
+ * worktree on a `devbox/<id>` branch and ends in a draft PR; a WORK-FOLDER
+ * session (a playbook run over pod data — a video edit, an interview) is
+ * worked in `<work root>/<sessionId>/` with no git, files its outputs back to
+ * the pod, and asks the person through the session's human-owned slots.
+ *
  * State (which sessions were launched, their Claude session ids and outcome)
  * lives in ~/.synap/worker/<agent>/state.json; each run's stream-json goes to
- * ~/.synap/worker/<agent>/runs/<sessionId>.jsonl.
+ * ~/.synap/worker/<agent>/runs/<sessionId>.jsonl. Neither ever holds a token.
  */
+import { type McpCallClient } from "../lib/mcp-call.js";
 export interface WorkerOptions {
     agent: string;
     interval?: string;
@@ -33,16 +51,20 @@ export interface WorkerOptions {
     maxParallel?: string;
     claudeBin?: string;
     claudeConfigDir?: string;
-    mcpServer?: string;
     allowedTools?: string;
     skipPermissions?: boolean;
     dryRun?: boolean;
+    /** The Claude accounts file (default ~/.config/synap-worker/accounts.json, used when it exists). */
+    accounts?: string;
+    /** Where work-folder runs get their folder, one per session (default ~/synap-work). */
+    workRoot?: string;
 }
 export interface HandedItem {
     id: string;
     goal: string | null;
 }
-export type RunStatus = "running" | "done" | "failed";
+/** `limited`: cut off by a usage limit, waiting to be resumed on another account. */
+export type RunStatus = "running" | "done" | "failed" | "limited";
 export interface RunRecord {
     sessionId: string;
     status: RunStatus;
@@ -54,6 +76,24 @@ export interface RunRecord {
     result?: string;
     /** How many times a room follow-up resumed this Claude conversation. */
     resumes?: number;
+    /** How many times a run that failed before Claude started was relaunched. */
+    launchRetries?: number;
+    /** The accounts-file id the latest launch ran on — an id, never a token. */
+    accountId?: string;
+    /** `print` = `claude -p` (default); `bg` = `claude --bg`, a design run. */
+    mode?: "print" | "bg";
+    /** The short id `claude --bg` printed (what `claude agents|stop` take). */
+    bgId?: string;
+    /** When the latest launch (first or resumed) started. */
+    launchedAt?: string;
+    /** How many times a run cut off by a usage limit was resumed on another account. */
+    limitResumes?: number;
+    /** A background run first seen blocked (needs input) at this time. */
+    blockedSince?: string;
+    /** Which protocol the run was launched with (absent: a run from before protocols = code). */
+    protocol?: WorkerProtocol;
+    /** A work-folder run's folder: its cwd, which every resume reuses (Claude finds a conversation by its cwd). */
+    workDir?: string;
 }
 interface WorkerState {
     runs: Record<string, RunRecord>;
@@ -81,14 +121,38 @@ export declare class AgentPausedError extends Error {
  * block throws `AgentBoundForDispatchError`.
  */
 export declare function parseHandedToYou(orientText: string): HandedItem[];
-/** Sessions handed to the agent that this worker has not launched yet. */
-export declare function pickNew(items: HandedItem[], state: WorkerState, slots: number): HandedItem[];
 /**
- * The MCP server name the local Claude Code uses for THIS pod: the entry in
- * ~/.claude.json whose URL is `<podUrl>/mcp` (user or project scope).
+ * A run that failed BEFORE Claude started (no Claude session: an expired login,
+ * exhausted credits) is relaunched after 30 min, then 1 h, 2 h and 4 h, enough
+ * to outlast a credit reset. A run Claude did start is resumed only by a room
+ * follow-up, never relaunched from scratch.
+ */
+export declare const LAUNCH_RETRY_BASE_MS: number;
+export declare const MAX_LAUNCH_RETRIES = 4;
+/** Sessions to launch now: never launched, or due a relaunch (see above). */
+export declare function pickNew(items: HandedItem[], state: WorkerState, slots: number, now?: number): HandedItem[];
+/**
+ * The pod MCP server every run gets, under this name, carrying the WORKER
+ * AGENT's own key. Runs never inherit the server in ~/.claude.json: whatever
+ * key that file holds (a `synap login --reconnect` on the box rewrites it with
+ * another agent's) would decide who the run posts as, and the worker would
+ * then read its own posts as follow-ups (2026-10-20).
  */
-export declare function findMcpServerName(claudeJson: unknown, podUrl: string): string | null;
+export declare const RUN_MCP_SERVER = "synap-worker";
+export declare function runMcpConfig(podUrl: string, apiKey: string, 
+/** The run's Claude session id: names the conversation to the pod, one id across resumes. */
+claudeSessionId?: string): {
+    mcpServers: Record<string, unknown>;
+};
+/** Writes the run config owner-only (it holds the key) and returns its path. */
+export declare function writeRunMcpConfig(dir: string, config: {
+    mcpServers: Record<string, unknown>;
+}, name?: string): string;
 export declare const DEFAULT_ALLOWED_TOOLS: string[];
+/** The tools a design run adds: the claude.ai Artifact tool (and the search that loads deferred tools). */
+export declare const DESIGN_EXTRA_TOOLS: string[];
+/** The tools a work-folder run adds: skills (the HyperFrames workflow is one). */
+export declare const WORK_FOLDER_EXTRA_TOOLS: string[];
 /** The protocol the launched Claude Code follows for one handed session. */
 export declare function buildWorkerPrompt(p: {
     sessionId: string;
@@ -96,9 +160,119 @@ export declare function buildWorkerPrompt(p: {
     agentName: string;
     cwd: string;
     mcpServer: string;
+    /** A design run: the deliverable is a claude.ai Design artifact. */
+    design?: boolean;
+}): string;
+/** How long a work-folder run waits for an answer to its ask before it ends `blocked`. */
+export declare const ASK_WAIT_MINUTES = 30;
+/**
+ * The protocol for a WORK-FOLDER session (`sessionProtocol`): no git; files in
+ * the session's folder; outputs filed to the pod; questions asked through a
+ * human-owned slot with an ask (what Content Studio, Relay and the Needs-you
+ * list show), never a room `QUESTION:` line.
+ */
+export declare function buildWorkFolderPrompt(p: {
+    sessionId: string;
+    goal: string | null;
+    agentName: string;
+    workDir: string;
+    mcpServer: string;
 }): string;
-/** The launched environment: the subscription, never a stray API key. */
-export declare function workerEnv(base: NodeJS.ProcessEnv, claudeConfigDir?: string): NodeJS.ProcessEnv;
+/**
+ * The launched environment: the subscription, never a stray API key. With an
+ * account picked, its token REPLACES any token the worker inherited.
+ */
+export declare function workerEnv(base: NodeJS.ProcessEnv, claudeConfigDir?: string, oauthToken?: string): NodeJS.ProcessEnv;
+export interface LimitHit {
+    error: string;
+    /** When the limit lifts (ms), when Claude Code said. */
+    resetsAt?: number;
+}
+/** What one run's events say about how it ended. */
+export interface RunEnd {
+    claudeSessionId?: string;
+    /** The `result` text (stream) or the last main assistant text (transcript). */
+    text?: string;
+    /** Set when the run's LAST main-thread turn was refused by a usage limit. */
+    limit?: LimitHit;
+    isError?: boolean;
+}
+/**
+ * Fold one event (a stream-json line of `claude -p`, or a transcript line of
+ * a background session — the two spell the fields differently) into the run's
+ * ending. A later healthy assistant message clears an earlier limit: only a
+ * run whose last turn hit the limit "ended on a limit".
+ */
+export declare function foldRunEvent(end: RunEnd, ev: Record<string, unknown>, rejectedResetsAt?: {
+    at?: number;
+}): RunEnd;
+/** A run that printed its WORKER-RESULT verdict finished its protocol: never a limit. */
+export declare function endedOnLimit(end: RunEnd): LimitHit | undefined;
+/** How long an account stays out after a limit with no reset time given. */
+export declare function limitUntil(hit: LimitHit, now: number): number;
+/** At most this many usage-limit resumes per session. */
+export declare const MAX_LIMIT_RESUMES = 6;
+/** The prompt that resumes a run a usage limit cut off, on another account. */
+export declare const LIMIT_RESUME_PROMPT = "Continue where you stopped. Your previous turn was cut off by a Claude usage limit and this session moved to another account. Same protocol; end with one line: WORKER-RESULT: done | blocked | failed \u2014 <one sentence>.";
+/**
+ * The structured signal for a DESIGN run: the session declares an outcome of
+ * kind "design" (`synap_get_session` → `outcomes.outcomes[].kind`, the
+ * playbook's `expectedOutputs: [{kind: "design", label: "Design"}]`). The goal
+ * text is never read for it. A session whose outcomes could not be read
+ * THROWS: an unreadable session is not "not a design run".
+ */
+export declare const DESIGN_OUTCOME_KIND = "design";
+export declare function isDesignSession(getSessionText: string): boolean;
+/**
+ * `code`: a git worktree, a `devbox/<id>` branch, a draft PR, room `QUESTION:`s.
+ * `work-folder`: a folder per session, no git, outputs filed to the pod, asks
+ * through the session's human-owned slots.
+ */
+export type WorkerProtocol = "code" | "work-folder";
+/** The run params that name a repository — the ones the pod's dispatch path mounts (`repoInputs`, external-agent-executor.ts). */
+export declare const REPO_PARAM_KEYS: readonly ["repo", "repos", "branch"];
+/** Deliverable kinds that only code work yields: the dispatch path's code outputs (`ExternalAgentOutputKey`) and `code`. */
+export declare const CODE_OUTPUT_KINDS: readonly ["pull_request", "branch", "code"];
+/**
+ * Which protocol a handed session gets, from the `synap_get_session` read.
+ *
+ * A session that runs NO playbook is an ad-hoc hand-off ("start this on my
+ * devbox"): the code protocol, exactly as before protocols existed. A PLAYBOOK
+ * RUN (`session.playbookId`) is a process over pod data — Produce Content's
+ * video edit, a CRM list, an interview — and gets the work-folder protocol,
+ * unless it carries code context: a repo or branch in its run params
+ * (`session.metadata.params`, read the same way the dispatch path reads them)
+ * or a code deliverable declared on the session or on any of its stages
+ * (`expectedOutputs`, `stages[].expectedOutputs`), so a code playbook stays
+ * code from its first stage on. The goal text is never read. An unreadable
+ * session THROWS: it is not "a code session".
+ */
+export declare function sessionProtocol(getSessionText: string): WorkerProtocol;
+/** A work-folder run's folder: `<root>/<sessionId>`. */
+export declare function workFolderFor(root: string, sessionId: string): string;
+/** The short id `claude --bg` prints ("backgrounded · fd009109"). */
+export declare function parseBgId(output: string): string | undefined;
+export interface BgEntry {
+    id: string;
+    sessionId?: string;
+    /** Background sessions: working | blocked | done | failed (Claude Code 2.1.296+). */
+    state?: string;
+    status?: string;
+}
+/** `claude agents --json --all` → entries. Anything but a JSON list THROWS (a failed read is not "gone"). */
+export declare function parseAgentsList(text: string): BgEntry[];
+export type BgPhase = "running" | "finished" | "blocked" | "gone";
+export declare function bgPhase(entry: BgEntry | undefined): BgPhase;
+/** The transcript of a Claude session: `<config>/projects/<any>/<sessionId>.jsonl`. */
+export declare function findTranscript(claudeConfigDir: string | undefined, sessionId: string): string | undefined;
+/** How a background run's transcript ends, reading only entries written since `sinceMs`. */
+export declare function readTranscriptEnd(text: string, sinceMs: number): RunEnd & {
+    seen: number;
+};
+/** A background run blocked (it needs input nobody will give) this long is ended. */
+export declare const BG_BLOCKED_MAX_MS: number;
+/** A background run not yet listed, or listed with nothing new, is waited for this long after launch. */
+export declare const BG_SETTLE_MS: number;
 /** The final `WORKER-RESULT:` line of a run's result text, if present. */
 export declare function workerVerdict(resultText: string | undefined): string | undefined;
 export interface RoomMessage {
@@ -118,5 +292,40 @@ export declare const MAX_RESUMES = 20;
 export declare function followUpsSince(messages: RoomMessage[], since: string, selfAgentId: string): RoomMessage[];
 /** The prompt that resumes a finished run with the room's new messages. */
 export declare function buildFollowUpPrompt(messages: RoomMessage[]): string;
+export interface ExecResult {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+}
+/** Runs a short-lived command (`claude --bg`, `claude agents`, `claude stop`). */
+export type ExecFn = (bin: string, args: string[], o: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}) => Promise<ExecResult>;
+export interface WorkerDeps {
+    mcp: McpCallClient;
+    podUrl: string;
+    apiKey: string;
+    /** The worker agent's own user id: its posts never resume it. */
+    selfAgentId: string;
+    exec?: ExecFn;
+    /** The account probe's fetch (tests stub it). */
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+    say?: (line: string) => void;
+}
+export interface Worker {
+    tick(): Promise<{
+        handed: number;
+        launched: number;
+    }>;
+    /** Re-read the background runs' state (design runs). */
+    watch(): Promise<void>;
+    waitForChildren(): Promise<void>;
+    backgroundRunning(): number;
+    stop(): void;
+    readonly state: WorkerState;
+}
+export declare function createWorker(opts: WorkerOptions, deps: WorkerDeps): Worker;
 export declare function workerCommand(opts: WorkerOptions): Promise<void>;
 export {};