@tokenfactory/acc-runner 0.38.3 → 0.40.0

package/dist/chat-lane.js

@@ -0,0 +1,328 @@
+/**
+ * CC-1B (TURN-LANE): the runner-side chat claim lane + turn lifecycle.
+ *
+ * The chat lane is a SECOND lane beside the batch task/review lanes
+ * (docs/acc/WORKSPACE_COMMAND_CHAT_CONTRACTS.md §1). A *turn* is one operator
+ * prompt → one streamed agent reply. Turns are queued server-side; a companion
+ * runner CLAIMS a queued turn under a time-boxed lease (acc.claim_chat_turn,
+ * advisory-lock per conversation — migration 0254), STREAMS the reply as deltas,
+ * and COMPLETES it — or REQUEUES it when it loses the lease/capacity, so another
+ * companion finishes the turn without burning an operator turn.
+ *
+ * This module owns:
+ *   1. The turn LIFECYCLE state machine (queued → claimed → streaming →
+ *      awaiting_confirmation → done | capacity_paused | failed | cancelled),
+ *      with a transition validator.
+ *   2. The failure → disposition mapping: infra failures REQUEUE (never burn a
+ *      turn); `claude_exit_1`-class failures open the chat circuit breaker AND
+ *      requeue; a genuine agent error COMPLETES the turn as `error`.
+ *   3. `driveChatTurn` — the per-turn driver, an engine-agnostic loop over a
+ *      `ConformantAgentEngine.streamTurn` that emits exactly ONE terminal
+ *      transport call (complete OR requeue) so an abort mid-stream produces a
+ *      clean requeue with no duplicate side effects.
+ *   4. `computeChatClaimBudget` — the chat-lane max-share knob so chat turns can
+ *      never starve the code/review lanes of concurrency slots.
+ *
+ * Every side effect is behind the injectable `ChatLaneTransport` + the engine +
+ * an optional abort signal, so the whole lifecycle is exercised deterministically
+ * (tests/unit/chat-lane*.test.ts) with no `claude` binary and no network.
+ */
+import { classifyClaudeExit } from "./failure-classifier.js";
+import { isChatCircuitTripClass } from "./runtime/chat-circuit-breaker.js";
+/* ------------------------------------------------------------------ *
+ * 1. Wire shapes (runner-side mirror of the frozen chat-lane contract)
+ *
+ * The tier/capacity/capability types are pinned in engines/types.ts; the turn
+ * message payloads below mirror src/lib/workspace-command-chat.ts (the acc-runner
+ * package does not import from the web-app tree). Additive fields do not bump
+ * CHAT_LANE_PROTOCOL_VERSION — a peer on an older minor ignores unknown fields.
+ * ------------------------------------------------------------------ */
+/** Chat-lane protocol version (mirrors the web-app constant of the same name). */
+export const CHAT_LANE_PROTOCOL_VERSION = 1;
+/** Terminal lifecycle states — no further transition is valid from these. */
+export const TERMINAL_CHAT_LIFECYCLE = [
+    "done",
+    "capacity_paused",
+    "failed",
+    "cancelled",
+    "requeued",
+];
+const CHAT_LIFECYCLE_TRANSITIONS = {
+    queued: ["claimed", "cancelled"],
+    claimed: ["streaming", "requeued", "failed", "cancelled", "capacity_paused"],
+    streaming: [
+        "awaiting_confirmation",
+        "done",
+        "failed",
+        "cancelled",
+        "requeued",
+        "capacity_paused",
+    ],
+    awaiting_confirmation: ["done", "cancelled"],
+    done: [],
+    capacity_paused: [],
+    failed: [],
+    cancelled: [],
+    requeued: [],
+};
+/** True when `to` is a legal next lifecycle state from `from`. */
+export function isValidChatTransition(from, to) {
+    return CHAT_LIFECYCLE_TRANSITIONS[from]?.includes(to) ?? false;
+}
+/** True when the lifecycle state is terminal (the turn is settled). */
+export function isTerminalChatLifecycle(state) {
+    return TERMINAL_CHAT_LIFECYCLE.includes(state);
+}
+/**
+ * Map a shared-taxonomy `ClassifiedExit` onto a chat-lane disposition. The split
+ * mirrors the batch lane's machine-vs-task rule but reroutes the terminal action
+ * to the chat lane's requeue/circuit model:
+ *
+ *   capacity_exhausted | subscription_exhausted → requeue (capacity_lost)     [infra]
+ *   claude_unavailable (transient)              → requeue (engine_unavailable) [infra]
+ *   auth_expired                                → quarantine_requeue (credential_lost)
+ *   env_broken                                  → quarantine_requeue (engine_unavailable)
+ *   usage_limit (hard wall)                     → quarantine_requeue (capacity_lost)
+ *   task_error                                  → error (turn completes 'error')
+ */
+export function classifyChatDisposition(classified) {
+    const cls = classified.class;
+    const detail = classified.detail;
+    if (cls === "task_error") {
+        return { action: "error", detail };
+    }
+    if (isChatCircuitTripClass(cls)) {
+        const reason = cls === "auth_expired"
+            ? "credential_lost"
+            : cls === "usage_limit"
+                ? "capacity_lost"
+                : "engine_unavailable";
+        return { action: "quarantine_requeue", reason, cause: cls, detail };
+    }
+    // Everything else (capacity_exhausted, subscription_exhausted, transient
+    // claude_unavailable) is recoverable infra → requeue, no circuit trip.
+    const reason = cls === "claude_unavailable" ? "engine_unavailable" : "capacity_lost";
+    return { action: "requeue", reason, quarantine: false, detail };
+}
+/** Coerce an arbitrary thrown value into a `ClassifiedExit` via the shared mapper. */
+function classifyThrown(err, engine) {
+    const anyErr = err;
+    const exitCode = typeof anyErr?.exitCode === "number" ? anyErr.exitCode : 1;
+    const stderr = anyErr?.stderr ?? anyErr?.message ?? String(err ?? "");
+    const stdout = anyErr?.stdout ?? "";
+    // Prefer the engine's own classifier (delegates to failure-classifier) so a
+    // future engine can override, falling back to the shared mapper directly.
+    try {
+        return engine.classifyFailure(exitCode, stderr, stdout);
+    }
+    catch {
+        return classifyClaudeExit(exitCode, stderr, stdout);
+    }
+}
+/** True when the abort was requested (signal seam + AbortError name). */
+function wasAborted(signal, err) {
+    if (signal?.aborted)
+        return true;
+    const name = err?.name;
+    return name === "AbortError";
+}
+/**
+ * Drive one claimed turn to a terminal state. Emits EXACTLY ONE terminal
+ * transport call (complete OR requeue), guarded by `settled`, so a mid-stream
+ * abort/failure can never both requeue AND complete the same turn — the
+ * "kill mid-stream ⇒ clean requeue, no dup side effects" invariant.
+ */
+export async function driveChatTurn(turn, deps) {
+    const emit = (lifecycle, detail) => deps.onEvent?.({ turnId: turn.id, conversationId: turn.conversation_id, lifecycle, detail });
+    let seq = 0;
+    let sawText = false;
+    let fullText = "";
+    const base = {
+        turnId: turn.id,
+        conversationId: turn.conversation_id,
+        totalSeq: 0,
+        quarantined: false,
+    };
+    const requeue = async (reason, detail, opts = {}) => {
+        if (opts.quarantine) {
+            await deps.onCircuitTrip?.({ cause: opts.quarantine.cause, detail });
+        }
+        await deps.transport.requeue(turn, { reason, requeue_count: turn.requeue_count + 1 });
+        const lifecycle = reason === "capacity_lost" && !opts.quarantine ? "capacity_paused" : "requeued";
+        emit(lifecycle, detail);
+        return { ...base, totalSeq: seq, lifecycle, requeueReason: reason, quarantined: !!opts.quarantine, detail };
+    };
+    const complete = async (outcome, lifecycle, detail) => {
+        await deps.transport.complete(turn, {
+            outcome,
+            total_seq: seq,
+            ...(detail && outcome === "error" ? { error: detail } : {}),
+            ...(lifecycle === "awaiting_confirmation" ? { awaiting_confirmation: true } : {}),
+        });
+        emit(lifecycle, detail);
+        return { ...base, totalSeq: seq, lifecycle, outcome, detail };
+    };
+    // claimed → streaming
+    await deps.transport.markStreaming?.(turn);
+    emit("streaming");
+    try {
+        const iter = deps.engine.streamTurn({
+            prompt: turn.prompt,
+            conversationId: turn.conversation_id,
+            turnId: turn.id,
+            ...(deps.cwd !== undefined ? { cwd: deps.cwd } : {}),
+            ...(deps.delegationToken !== undefined ? { delegationToken: deps.delegationToken } : {}),
+            ...(deps.signal ? { signal: deps.signal } : {}),
+        });
+        for await (const chunk of iter) {
+            if (deps.signal?.aborted) {
+                // Abort observed mid-stream: stop streaming and requeue cleanly. We do
+                // NOT emit further deltas or a complete — the turn survives untouched.
+                return await requeue(deps.abortReason ?? "operator_cancelled", "aborted mid-stream");
+            }
+            await deps.transport.stream(turn, { seq: chunk.seq, delta: chunk.delta, done: chunk.done });
+            seq = chunk.seq + 1;
+            if (chunk.delta) {
+                sawText = true;
+                fullText += chunk.delta;
+            }
+        }
+    }
+    catch (err) {
+        if (wasAborted(deps.signal, err)) {
+            return await requeue(deps.abortReason ?? "operator_cancelled", "aborted mid-stream");
+        }
+        const disposition = classifyChatDisposition(classifyThrown(err, deps.engine));
+        if (disposition.action === "error") {
+            return await complete("error", "failed", disposition.detail);
+        }
+        if (disposition.action === "quarantine_requeue") {
+            return await requeue(disposition.reason, disposition.detail, {
+                quarantine: { cause: disposition.cause },
+            });
+        }
+        return await requeue(disposition.reason, disposition.detail);
+    }
+    // Stream ended cleanly. A late abort (signalled after the last chunk) still
+    // requeues rather than completing.
+    if (deps.signal?.aborted) {
+        return await requeue(deps.abortReason ?? "operator_cancelled", "aborted after stream end");
+    }
+    // A clean stream with zero visible text may be a SILENT engine failure. Probe
+    // it (batch-lane parity): an unhealthy probe means the empty turn was really a
+    // machine fault, not a genuine empty reply.
+    if (!sawText && deps.silentFailureProbe) {
+        const probe = await deps.silentFailureProbe();
+        if (probe) {
+            const disposition = classifyChatDisposition(probe);
+            if (disposition.action === "error") {
+                return await complete("error", "failed", disposition.detail);
+            }
+            if (disposition.action === "quarantine_requeue") {
+                return await requeue(disposition.reason, disposition.detail, {
+                    quarantine: { cause: disposition.cause },
+                });
+            }
+            return await requeue(disposition.reason, disposition.detail);
+        }
+    }
+    if (deps.requiresConfirmation?.(fullText, turn)) {
+        return await complete("ok", "awaiting_confirmation");
+    }
+    return await complete("ok", "done");
+}
+/* ------------------------------------------------------------------ *
+ * 6. Max-share — the chat-lane concurrency knob
+ * ------------------------------------------------------------------ */
+/** Env var carrying the chat-lane max-share fraction (0..1). */
+export const CHAT_MAX_SHARE_ENV = "ACC_RUNNER_CHAT_MAX_SHARE";
+/** Default chat-lane max share of runner concurrency. */
+export const DEFAULT_CHAT_MAX_SHARE = 0.5;
+/**
+ * Resolve the chat-lane max-share fraction from a raw env value. Blank/absent ⇒
+ * default; a value ≤0 disables chat claiming; a value ≥1 is clamped so at least
+ * one slot always remains for the code/review lanes (chat can never take the
+ * whole runner). Non-numeric ⇒ default (a typo must not starve either lane).
+ */
+export function resolveChatMaxShare(raw) {
+    const trimmed = (raw ?? "").trim();
+    if (!trimmed)
+        return DEFAULT_CHAT_MAX_SHARE;
+    const n = Number.parseFloat(trimmed);
+    if (!Number.isFinite(n))
+        return DEFAULT_CHAT_MAX_SHARE;
+    if (n <= 0)
+        return 0;
+    if (n >= 1)
+        return 1;
+    return n;
+}
+/**
+ * Compute how many NEW chat turns the runner may claim right now, given its
+ * concurrency ceiling and current mixed load. The max-share invariant guarantees
+ * the code/review lanes never starve:
+ *
+ *   chatCeiling = clamp(floor(concurrency * maxShare), 0, concurrency - 1)
+ *
+ * i.e. chat may occupy at most `chatCeiling` slots, and that ceiling is capped at
+ * `concurrency - 1` so at least one slot is ALWAYS reservable for a code/review
+ * task even at maxShare = 1. The live budget then subtracts the chat turns
+ * already in flight and is further bounded by the runner's actual free capacity
+ * (concurrency − everything running). Returns 0 while the chat circuit is open or
+ * chat is disabled (maxShare ≤ 0).
+ */
+export function computeChatClaimBudget(opts) {
+    const concurrency = Math.max(1, Math.floor(opts.concurrencyLimit));
+    if (opts.circuitOpen)
+        return 0;
+    const share = opts.maxShare <= 0 ? 0 : opts.maxShare >= 1 ? 1 : opts.maxShare;
+    if (share <= 0)
+        return 0;
+    // Reserve ≥1 slot for code/review: chat ceiling never reaches full concurrency.
+    const chatCeiling = Math.min(Math.max(0, Math.floor(concurrency * share)), concurrency - 1);
+    const active = Math.max(0, Math.floor(opts.activeChatTurns));
+    const codeActive = Math.max(0, Math.floor(opts.activeCodeTasks));
+    const shareHeadroom = chatCeiling - active;
+    const freeSlots = concurrency - active - codeActive;
+    return Math.max(0, Math.min(shareHeadroom, freeSlots));
+}
+/* ------------------------------------------------------------------ *
+ * 7. Chat-lane runner config (env resolution)
+ * ------------------------------------------------------------------ */
+/** Env var that opts the runner into the chat lane (a companion). */
+export const CHAT_LANE_ENABLED_ENV = "ACC_RUNNER_CHAT_LANE";
+/** Env var carrying the requested per-turn lease (ms). */
+export const CHAT_LEASE_MS_ENV = "ACC_RUNNER_CHAT_LEASE_MS";
+/** Default per-turn lease; mirrors acc.claim_chat_turn's default (60s). */
+export const DEFAULT_CHAT_LEASE_MS = 60_000;
+/** True when the value is a recognised truthy flag ("1"/"true"/"yes"/"on"). */
+function isTruthyFlag(raw) {
+    const v = (raw ?? "").trim().toLowerCase();
+    return v === "1" || v === "true" || v === "yes" || v === "on";
+}
+/**
+ * Resolve the requested per-turn lease. Blank/absent/non-numeric ⇒ default;
+ * numeric values clamp to the RPC's own accepted window (1s..10m) so the runner
+ * never asks for a lease the server would silently clamp anyway.
+ */
+export function resolveChatLeaseMs(raw) {
+    const n = Number.parseInt((raw ?? "").trim(), 10);
+    if (!Number.isFinite(n))
+        return DEFAULT_CHAT_LEASE_MS;
+    return Math.min(600_000, Math.max(1_000, n));
+}
+/**
+ * Resolve the chat-lane knobs from the environment in ONE place so the companion
+ * loop and any caps/telemetry read the same values. A share of 0 (or the flag
+ * absent) means the runner does not claim chat turns even when enabled — the
+ * code/review lanes keep the whole runner.
+ */
+export function resolveChatLaneConfig(env = process.env) {
+    const maxShare = resolveChatMaxShare(env[CHAT_MAX_SHARE_ENV]);
+    return {
+        enabled: isTruthyFlag(env[CHAT_LANE_ENABLED_ENV]) && maxShare > 0,
+        maxShare,
+        leaseMs: resolveChatLeaseMs(env[CHAT_LEASE_MS_ENV]),
+    };
+}
+//# sourceMappingURL=chat-lane.js.map

package/dist/chat-lane.js.map

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

package/dist/chat-transport.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CC-1B (TURN-LANE): the production `ChatLaneTransport` adapter.
+ *
+ * Wires the abstract lane seam (chat-lane.ts) onto real infrastructure per the
+ * frozen contract (WORKSPACE_COMMAND_CHAT_CONTRACTS §1/§3):
+ *
+ *   - CLAIM  → the `acc.claim_chat_turn` RPC (advisory-lock per conversation,
+ *              migration 0254). Returns the claimed acc.chat_turns row mapped to
+ *              a `ClaimedChatTurn`, or null when the queue is empty.
+ *   - STREAM / COMPLETE / REQUEUE → a `broadcast` on the conversation's
+ *              `chat:<conversation_id>` Realtime topic (§3), carrying the frozen
+ *              envelope header + the lifecycle payload. The topic's server-side
+ *              consumer persists deltas into acc.chat_turn_deltas and advances
+ *              acc.chat_turns (service-role writer) — the runner never writes
+ *              those tables directly (RLS: service-role only).
+ *
+ * A per-conversation channel is subscribed lazily and reused across a turn's
+ * many stream frames; `close()` tears them all down on shutdown. The driver only
+ * sees the `ChatLaneTransport` interface, so nothing here changes turn logic.
+ */
+import type { RunnerSupabaseClient } from "./supabase.js";
+import { type ChatLaneTransport, type ClaimedChatTurn } from "./chat-lane.js";
+/** Shape of one acc.chat_turns row as returned by acc.claim_chat_turn. */
+interface ChatTurnRow {
+    id: string;
+    conversation_id: string;
+    org_id: string;
+    turn_ordinal: number | null;
+    prompt: string | null;
+    tier: string | null;
+    engine_id: string | null;
+    runner_id: string | null;
+    requeue_count: number | null;
+    lease_expires_at: string | null;
+}
+/** Map a raw claimed row onto the driver's `ClaimedChatTurn` (defensive defaults). */
+export declare function mapClaimedTurn(row: ChatTurnRow): ClaimedChatTurn;
+export interface SupabaseChatTransportOptions {
+    now?: () => number;
+    onLog?: (line: string) => void;
+}
+/**
+ * Build the production chat-lane transport bound to a runner's Supabase client.
+ * Claim uses the DB RPC; the lifecycle messages broadcast on the per-conversation
+ * chat topic.
+ */
+export declare function createSupabaseChatTransport(client: RunnerSupabaseClient, opts?: SupabaseChatTransportOptions): ChatLaneTransport & {
+    close: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=chat-transport.d.ts.map

package/dist/chat-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-transport.d.ts","sourceRoot":"","sources":["../src/chat-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAEL,KAAK,iBAAiB,EAItB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAgBxB,0EAA0E;AAC1E,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,eAAe,CAahE;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,GAAE,4BAAiC,GACtC,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAgGpD"}

package/dist/chat-transport.js

@@ -0,0 +1,105 @@
+import { CHAT_LANE_PROTOCOL_VERSION, } from "./chat-lane.js";
+/** Map a raw claimed row onto the driver's `ClaimedChatTurn` (defensive defaults). */
+export function mapClaimedTurn(row) {
+    return {
+        id: row.id,
+        conversation_id: row.conversation_id,
+        org_id: row.org_id,
+        turn_ordinal: row.turn_ordinal,
+        prompt: row.prompt ?? "",
+        tier: (row.tier ?? "full"),
+        engine_id: row.engine_id ?? "",
+        runner_id: row.runner_id ?? "",
+        requeue_count: row.requeue_count ?? 0,
+        lease_expires_at: row.lease_expires_at,
+    };
+}
+/**
+ * Build the production chat-lane transport bound to a runner's Supabase client.
+ * Claim uses the DB RPC; the lifecycle messages broadcast on the per-conversation
+ * chat topic.
+ */
+export function createSupabaseChatTransport(client, opts = {}) {
+    const now = opts.now ?? Date.now;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const channels = new Map(); // any-allowed: supabase RealtimeChannel type is not re-exported by the schema-scoped client
+    async function channelFor(conversationId) {
+        const topic = `chat:${conversationId}`;
+        const existing = channels.get(conversationId);
+        if (existing)
+            return existing;
+        const ch = client.channel(topic);
+        channels.set(conversationId, ch);
+        await new Promise((resolve) => {
+            ch.subscribe((status) => {
+                if (status === "SUBSCRIBED")
+                    resolve();
+            });
+            // Never hang the turn on a slow subscribe — proceed after a short grace.
+            setTimeout(resolve, 2_000).unref?.();
+        });
+        return ch;
+    }
+    function header(kind, conversationId, turnId, runnerId) {
+        return {
+            protocol_version: CHAT_LANE_PROTOCOL_VERSION,
+            kind,
+            conversation_id: conversationId,
+            turn_id: turnId,
+            runner_id: runnerId,
+            ts: new Date(now()).toISOString(),
+        };
+    }
+    async function broadcast(turn, event, kind, payload) {
+        try {
+            const ch = await channelFor(turn.conversation_id);
+            await ch.send({
+                type: "broadcast",
+                event,
+                payload: { ...header(kind, turn.conversation_id, turn.id, turn.runner_id), payload },
+            });
+        }
+        catch (err) {
+            opts.onLog?.(`[acc-runner] chat broadcast(${event}, ${turn.id}) failed: ${err.message}`);
+        }
+    }
+    return {
+        async claim(args) {
+            const { data, error } = await client.rpc("claim_chat_turn", {
+                p_conversation_id: args.conversationId,
+                p_runner_id: args.runnerId,
+                p_engine_id: args.engineId,
+                p_tier: args.tier,
+                p_lease_ms: args.leaseMs,
+            });
+            if (error) {
+                opts.onLog?.(`[acc-runner] claim_chat_turn(${args.conversationId}) failed: ${error.message}`);
+                return null;
+            }
+            // The RPC returns the single claimed row (SETOF one) or null when empty.
+            const row = (Array.isArray(data) ? data[0] : data);
+            return row && row.id ? mapClaimedTurn(row) : null;
+        },
+        async stream(turn, payload) {
+            await broadcast(turn, "turn_stream", "chat.turn.stream", payload);
+        },
+        async complete(turn, payload) {
+            await broadcast(turn, "turn_complete", "chat.turn.complete", payload);
+        },
+        async requeue(turn, payload) {
+            await broadcast(turn, "turn_requeued", "chat.turn.requeue", payload);
+        },
+        async close() {
+            for (const ch of channels.values()) {
+                try {
+                    await client.removeChannel(ch);
+                }
+                catch {
+                    /* best-effort teardown */
+                }
+            }
+            channels.clear();
+        },
+    };
+}
+//# sourceMappingURL=chat-transport.js.map

package/dist/chat-transport.js.map

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

package/dist/cli.js

@@ -12,6 +12,7 @@ import { logoutCommand } from "./logout.js";
 import { watchCommand } from "./watch.js";
 import { doctorCommand } from "./doctor.js";
 import { clearQuarantine, getQuarantine } from "./runtime/quarantine.js";
+import { clearChatCircuit, getChatCircuit } from "./runtime/chat-circuit-breaker.js";
 import { runCommitGuardHook } from "./commit-guard.js";
 import { PROTOCOL_VERSION } from "./types.js";
 import { PACKAGE_VERSION } from "./pkg-version.js";
@@ -116,6 +117,50 @@ quarantineCmd
         process.exitCode = 1;
     }
 });
+// CC-1B (TURN-LANE): chat-circuit management. The runner opens the chat circuit
+// automatically when a `claude_exit_1`-class fault surfaces while serving a chat
+// turn — benching ONLY the chat lane (code/review keep running). An operator
+// resolves the credential/host issue then clears the circuit to resume chat.
+const chatCircuitCmd = program
+    .command("chat-circuit")
+    .description("Inspect or clear the chat-capability circuit breaker (chat lane only).");
+chatCircuitCmd
+    .command("status")
+    .description("Show chat circuit state.")
+    .action(async () => {
+    try {
+        const c = await getChatCircuit();
+        if (!c) {
+            console.log("Chat circuit is closed (chat lane serving).");
+            return;
+        }
+        console.log(chalk.red.bold(`CHAT CIRCUIT OPEN (${c.cause})`));
+        console.log(`  Detail:        ${c.detail}`);
+        console.log(`  Turn:          ${c.turnId}`);
+        console.log(`  Conversation:  ${c.conversationId}`);
+        console.log(`  Since:         ${c.trippedAt}`);
+        console.log(chalk.gray(`\nResolve the underlying ${c.cause} issue, then run \`acc-runner chat-circuit clear\`. ` +
+            `Code/review lanes are unaffected.`));
+        process.exitCode = 1;
+    }
+    catch (err) {
+        console.error(chalk.red(`✗ ${err.message}`));
+        process.exitCode = 1;
+    }
+});
+chatCircuitCmd
+    .command("clear")
+    .description("Close the chat circuit and allow the runner to resume claiming chat turns.")
+    .action(async () => {
+    try {
+        await clearChatCircuit();
+        console.log(chalk.green("✓ Chat circuit closed. Runner will resume claiming chat turns."));
+    }
+    catch (err) {
+        console.error(chalk.red(`✗ ${err.message}`));
+        process.exitCode = 1;
+    }
+});
 // RR-4: the git pre-commit hook the runner installs into a
 // task worktree (see commit-guard.ts) re-invokes this hidden subcommand. It
 // scans the STAGED text files and exits non-zero (with an actionable message on

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -141,6 +141,44 @@ export interface RunnerConcurrency {
     concurrency: number;
     reservedReviewSlots: number;
 }
+/**
+ * RUNCFG-1: where the runner's EFFECTIVE concurrency ceiling came from.
+ *   - server: an operator set acc.runners.desired_concurrency (highest priority)
+ *   - env:    ACC_RUNNER_CONCURRENCY was set in the process env
+ *   - default: neither — the compiled DEFAULT_CONCURRENCY_LIMIT
+ * Advertised in caps.concurrency_source and printed by `acc-runner doctor` so a
+ * "runner advertised 5 while operator set 50" misconfig is visible at a glance.
+ */
+export type ConcurrencySource = "server" | "env" | "default";
+/**
+ * RUNCFG-1: is ACC_RUNNER_CONCURRENCY explicitly set? Distinguishes the `env`
+ * source (operator exported a value) from `default` (compiled fallback) when no
+ * server override is present.
+ */
+export declare function concurrencyEnvExplicit(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * RUNCFG-1: resolve the runner's EFFECTIVE concurrency from all three layers,
+ * precedence server-set > env > default. This is the single source of truth the
+ * watch loop applies to its live ceiling and doctor reports; it never reads the
+ * environment itself (callers pass the already-resolved env/default base) so it
+ * stays a pure function and is exhaustively unit-testable.
+ */
+export declare function resolveEffectiveConcurrency(input: {
+    /** acc.runners.desired_concurrency (null when no operator override). */
+    serverConcurrency: number | null | undefined;
+    /** acc.runners.desired_reserved_review_slots (null when no override). */
+    serverReserve: number | null | undefined;
+    /** The env-or-default concurrency (resolveConcurrencyLimit output). */
+    envConcurrency: number;
+    /** The env-or-default reserved-review-slot count. */
+    envReserve: number;
+    /** Whether ACC_RUNNER_CONCURRENCY was explicitly set (env vs default). */
+    envExplicit: boolean;
+}): {
+    concurrency: number;
+    reservedReviewSlots: number;
+    source: ConcurrencySource;
+};
 /**
  * CONC-1: resolve the runner's effective concurrency ONCE from the environment.
  * Both the register caps payload and the watch loop consume the SAME result so