wicked-crew 0.8.1 → 0.8.2

package/dist/api/ask-paths.d.ts

@@ -0,0 +1,90 @@
+/**
+ * The daemon's record of each chat's ASK PATH (DES-ASK-TEAM-CHAT-001 §5.1): who was eligible when
+ * the chat opened, the seat the operator chose (if any), and — once the first message launched it —
+ * the run the conversation IS and the answer steps it has added. In memory, like the chat scope
+ * index it sits beside: a chat is a session of this daemon; the run and its transcript are durable.
+ *
+ * Crew owns ELIGIBILITY and the launch COMMAND; the engine owns the PICK (`path.started.cli`,
+ * `selection`) and every fact after it. `pa` here is what this daemon has seen of the engine's
+ * pick (the relay fills it from `path.started`; a chosen seat is known at once).
+ */
+export interface AskPath {
+    chatId: string;
+    /** Seats admitted to the chat at open (signed in, not benched, allowed for the scope). */
+    eligible: string[];
+    /** The operator's choice, one of `eligible`; `undefined` ⇒ the engine picks at random. */
+    primary?: string;
+    /** The run the conversation is, once the first message launched it. */
+    runId?: string;
+    /** A message of this chat is in flight on this daemon — launching the run or continuing it
+     *  (status read → proposal → approval) — so a second one meanwhile is `turn_in_flight`. */
+    busy?: boolean;
+    /** Bumped on open; a launch that resolves after the chat was closed and reopened must not
+     *  attach its run to the newcomer. */
+    generation: number;
+    /** The answer steps added so far (`answer-1`, `answer-2`, …). */
+    steps: string[];
+    /** The engine's pick as this daemon has seen it. */
+    pa: string | null;
+    selection: 'chosen' | 'random';
+    reviewer: string | null;
+    helpers: string[];
+}
+export declare class AskPathIndex {
+    private readonly paths;
+    /** Per chat id, across closes — a close-and-reopen must read as a NEW generation. */
+    private readonly generations;
+    /** Record an opened chat's eligibility and the operator's choice. */
+    open(chatId: string, eligible: readonly string[], primary?: string): AskPath;
+    get(chatId: string): AskPath | undefined;
+    /** The chat a run was launched from, if it is an ask path of this daemon. */
+    chatOf(runId: string): string | undefined;
+    private nextGeneration;
+    /** Reserve the chat for one message (a launch or a continuation): the lease (the chat's
+     *  generation) to hand back to {@link release}; `null` when a message is in flight. */
+    reserve(chatId: string): number | null;
+    /** Give a lease back — only the generation that holds it (codex on #808 r2, 1: a request of a
+     *  closed-and-reopened chat must not free the newcomer's reservation). */
+    release(chatId: string, lease: number): void;
+    /** The first message launched the run; `stepId` is its answer step. False when the chat was
+     *  closed (or closed and reopened) while the launch was in flight: the caller cancels the run. */
+    started(chatId: string, generation: number, runId: string, stepId: string): boolean;
+    /** A later message added an answer step. Returns the new step id. */
+    /** A message of this chat is in flight right now (launching or continuing). */
+    busy(chatId: string): boolean;
+    /** The continuation the engine accepted landed on the chat: records the step — only on the
+     *  generation that holds the lease (codex on #808 r3, 2: a continuation of a closed-and-reopened
+     *  chat must not write into the newcomer's record). */
+    continued(chatId: string, lease: number, stepId: string): boolean;
+    /** The id the NEXT answer step takes (`answer-N`); nothing is recorded until {@link continued}. */
+    nextStep(chatId: string): string;
+    /** A re-seat: the named seats are eligible (a sign-in fixed). */
+    admit(chatId: string, seats: readonly string[]): string[];
+    /** What the relay learned from the run's `path.started` / `member.joined` / `help.answered`. */
+    observe(runId: string, fact: {
+        pa?: string;
+        selection?: 'chosen' | 'random';
+        reviewer?: string | null;
+        helper?: string;
+    }): void;
+    /** Every chat this daemon holds a path record for (`GET /chats`). */
+    list(): AskPath[];
+    close(chatId: string): AskPath | undefined;
+    /** The wire view (`ChatDetailResponse.path`). */
+    view(chatId: string): {
+        runId: string;
+        pa: string | null;
+        selection: 'chosen' | 'random';
+        reviewer: string | null;
+        helpers: string[];
+        stepId: string;
+    } | undefined;
+}
+/** The one answer step shape an ask adds per message (DES-ASK-TEAM-CHAT-001 §3, §4.4). */
+export declare const ASK_TURN_BUDGET_SECS = 600;
+export declare function answerStep(stepId: string, text: string): {
+    catalog: string;
+    id: string;
+    [k: string]: unknown;
+};
+//# sourceMappingURL=ask-paths.d.ts.map

package/dist/api/ask-paths.d.ts.map

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

package/dist/api/ask-paths.js

@@ -0,0 +1,145 @@
+export class AskPathIndex {
+    paths = new Map();
+    /** Per chat id, across closes — a close-and-reopen must read as a NEW generation. */
+    generations = new Map();
+    /** Record an opened chat's eligibility and the operator's choice. */
+    open(chatId, eligible, primary) {
+        const path = {
+            chatId,
+            eligible: [...eligible],
+            ...(primary !== undefined ? { primary } : {}),
+            steps: [],
+            generation: this.nextGeneration(chatId),
+            // One eligible seat is a certain voice (the engine's random pick over a roster of one):
+            // the turn index and the transcript can name it before `path.started` lands.
+            pa: primary ?? (eligible.length === 1 ? eligible[0] : null),
+            selection: primary !== undefined ? 'chosen' : 'random',
+            reviewer: null,
+            helpers: [],
+        };
+        this.paths.set(chatId, path);
+        return path;
+    }
+    get(chatId) {
+        return this.paths.get(chatId);
+    }
+    /** The chat a run was launched from, if it is an ask path of this daemon. */
+    chatOf(runId) {
+        for (const p of this.paths.values())
+            if (p.runId === runId)
+                return p.chatId;
+        return undefined;
+    }
+    nextGeneration(chatId) {
+        const g = (this.generations.get(chatId) ?? 0) + 1;
+        this.generations.set(chatId, g);
+        return g;
+    }
+    /** Reserve the chat for one message (a launch or a continuation): the lease (the chat's
+     *  generation) to hand back to {@link release}; `null` when a message is in flight. */
+    reserve(chatId) {
+        const p = this.paths.get(chatId);
+        if (p === undefined || p.busy === true)
+            return null;
+        p.busy = true;
+        return p.generation;
+    }
+    /** Give a lease back — only the generation that holds it (codex on #808 r2, 1: a request of a
+     *  closed-and-reopened chat must not free the newcomer's reservation). */
+    release(chatId, lease) {
+        const p = this.paths.get(chatId);
+        if (p !== undefined && p.generation === lease)
+            p.busy = false;
+    }
+    /** The first message launched the run; `stepId` is its answer step. False when the chat was
+     *  closed (or closed and reopened) while the launch was in flight: the caller cancels the run. */
+    started(chatId, generation, runId, stepId) {
+        const p = this.paths.get(chatId);
+        if (p === undefined || p.generation !== generation)
+            return false;
+        p.busy = false;
+        p.runId = runId;
+        p.steps.push(stepId);
+        return true;
+    }
+    /** A later message added an answer step. Returns the new step id. */
+    /** A message of this chat is in flight right now (launching or continuing). */
+    busy(chatId) {
+        return this.paths.get(chatId)?.busy === true;
+    }
+    /** The continuation the engine accepted landed on the chat: records the step — only on the
+     *  generation that holds the lease (codex on #808 r3, 2: a continuation of a closed-and-reopened
+     *  chat must not write into the newcomer's record). */
+    continued(chatId, lease, stepId) {
+        const p = this.paths.get(chatId);
+        if (p === undefined || p.generation !== lease)
+            return false;
+        p.steps.push(stepId);
+        return true;
+    }
+    /** The id the NEXT answer step takes (`answer-N`); nothing is recorded until {@link continued}. */
+    nextStep(chatId) {
+        const p = this.paths.get(chatId);
+        return `answer-${(p?.steps.length ?? 0) + 1}`;
+    }
+    /** A re-seat: the named seats are eligible (a sign-in fixed). */
+    admit(chatId, seats) {
+        const p = this.paths.get(chatId);
+        if (p === undefined)
+            return [];
+        for (const s of seats)
+            if (!p.eligible.includes(s))
+                p.eligible.push(s);
+        return [...p.eligible];
+    }
+    /** What the relay learned from the run's `path.started` / `member.joined` / `help.answered`. */
+    observe(runId, fact) {
+        const chatId = this.chatOf(runId);
+        const p = chatId !== undefined ? this.paths.get(chatId) : undefined;
+        if (p === undefined)
+            return;
+        if (fact.pa !== undefined)
+            p.pa = fact.pa;
+        if (fact.selection !== undefined)
+            p.selection = fact.selection;
+        if (fact.reviewer !== undefined)
+            p.reviewer = fact.reviewer;
+        if (fact.helper !== undefined && !p.helpers.includes(fact.helper))
+            p.helpers.push(fact.helper);
+    }
+    /** Every chat this daemon holds a path record for (`GET /chats`). */
+    list() {
+        return [...this.paths.values()];
+    }
+    close(chatId) {
+        const p = this.paths.get(chatId);
+        this.paths.delete(chatId);
+        return p;
+    }
+    /** The wire view (`ChatDetailResponse.path`). */
+    view(chatId) {
+        const p = this.paths.get(chatId);
+        if (p?.runId === undefined)
+            return undefined;
+        return {
+            runId: p.runId,
+            pa: p.pa,
+            selection: p.selection,
+            reviewer: p.reviewer,
+            helpers: [...p.helpers],
+            stepId: p.steps[p.steps.length - 1] ?? 'answer-1',
+        };
+    }
+}
+/** The one answer step shape an ask adds per message (DES-ASK-TEAM-CHAT-001 §3, §4.4). */
+export const ASK_TURN_BUDGET_SECS = 600;
+export function answerStep(stepId, text) {
+    return {
+        catalog: 'understand',
+        id: stepId,
+        gate: { human_confirm: { unconditional: true } },
+        budget_secs: ASK_TURN_BUDGET_SECS,
+        instructions: text,
+    };
+}
+//# sourceMappingURL=ask-paths.js.map

package/dist/api/ask-paths.js.map

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

package/dist/api/ask-relay.d.ts

@@ -0,0 +1,150 @@
+/**
+ * DES-ASK-TEAM-CHAT-001 §5.2 (ASK-C2) — the ask relay, crew's READ side of an ask path.
+ *
+ * After ASK-C1 an ask is a team run: the PA answers in an `understand` step `answer-N`, and the
+ * engine publishes the run's unit frames (`unitDispatched`, `unitOutputDelta`, `unitOutputCaptured`,
+ * `unitDone`, …) and team rows (`wicked.team.*`) — none of them a chat frame. This relay is the ONE
+ * producer of chat frames for a path: it folds the answer unit's `unitOutputDelta` into
+ * `chatDelta{chat, cliKey:<PA>}` (live typing only) and folds one `chatReply{chat, cliKey:<PA>, text,
+ * ok, run_id, ord}` per answer unit whose text is the output the team row
+ * `step.completed{step_id:"answer-N"}.output_ref` names — read through the engine's `work_output` at
+ * the FOLD (`unitDone{ord}`), not at the row (the row is published by the worker before the actor
+ * folds; the record exists once the fold ran — §5.2 "when the text is readable, verified").
+ *
+ * The join is by ATTEMPT (codex on #810 r1, 2): `output_ref` is `unit:<run>:<ord>:<attempt>`, and the
+ * attempt the fold settles is the latest the engine dispatched for that ord (`unitDispatched`,
+ * `unitOutputDelta`, `unitOutputCaptured` all carry it) — a failed attempt's row never decides a
+ * successful retry. A fold whose row has not arrived (the bus poll is 2 s) waits for it; past
+ * `rowGraceMs` the reply is read from the record anyway, with `ok` from the engine's own
+ * `unitOutputCaptured.stepStatus` — the un-teamed run of §8 F7 publishes no team row at all, and its
+ * answer still arrives (r1, 5). A RUN-terminal frame with no fold (`sessionFailed{ord}`,
+ * `runCancelled`) ends the turn with `ok:false` (r1, 6); `stepFailed` / `unitDenied` are NOT
+ * terminal — the engine fails over (a re-pick re-dispatches the ord, §8 F2) or opens an escalation
+ * gate whose Approve re-dispatches it, and a failed run says so with `sessionFailed` (r2, 1).
+ *
+ * The PA: the team rows (`path.started`, `path.repicked`) are authoritative; the unit's assigned seat
+ * is the fallback while none has arrived, and the unit record is re-read on every new attempt (a
+ * re-pick re-dispatches the same ord on another seat — r1, 1). Control lines (`HELP:`, `PLAN+`,
+ * `PLAN <id>:`, `ADVICE <id>:`, `STEP <id>:`, `SCOPE`, `RISK`) are stripped from the displayed text
+ * (§4.7); a delta stream that disagrees with the record is overwritten by it (the transcript's
+ * `seat` record is written from the reply).
+ *
+ * Every frame goes through the server's event fold (`fold`), so the turn index stamps `turn_id`, the
+ * transcript persists the reply, the decision recorder and the citation verifier see what they saw
+ * for a pool chat, and /ws fans it out — unchanged consumers (§5.2, codex #4). Every await is
+ * followed by a re-check that the run still belongs to the chat (End forgets it — r1, 4). Crew
+ * publishes no bus row (T2 §7 assertion 4). The relay is in-memory: a daemon restart forgets which
+ * run is which chat (the ask-path index is in-memory too), so a path that outlives the daemon is
+ * read from the run view, not relayed.
+ */
+import type { AskPathIndex } from './ask-paths.js';
+import type { ChatTurnIndex } from './chat-turns.js';
+import type { BusEvent } from '../core/bus.js';
+import type { CoreEvent } from '../core/types.js';
+/** A unit as the relay needs it (the run view's `WorkUnit`, narrowed). */
+export interface RelayUnit {
+    id: string;
+    ord: number;
+    status: string;
+    assigned_cli: string | null;
+    /** The engine's persisted attempt counter for the unit (0-based), when the run view carries it:
+     *  the durable half of the attempt boundary (codex on #810 r4, 2). */
+    last_attempt?: number;
+}
+export interface AskRelayDeps {
+    paths: AskPathIndex;
+    turns: ChatTurnIndex;
+    /** `Core::work_output(unit_id)` — the stored output of an approved unit, `null` when none. */
+    workOutput: (unitId: string) => Promise<string | null>;
+    /** The run's units (the run view) — resolved per (run, ord, attempt) and cached. */
+    units: (runId: string) => Promise<RelayUnit[]>;
+    /** Where frames go: the server's event fold (stamp → transcript → recorder → /ws). Not a bus
+     *  publish — crew puts no row on the bus (tests/team-no-publish.test.ts). */
+    fold: (frame: CoreEvent) => void;
+    /** The voice of a turn was learned (a random pick, a re-pick): the decision recorder's audience
+     *  follows the turn index's (r1, 7). */
+    recorderReconcile?: (chat: string, turnId: string, seats: readonly string[]) => void;
+    /** How long a fold waits for its `step.completed` row before the reply is read from the record
+     *  anyway (the un-teamed run publishes none). Default 5 s. */
+    rowGraceMs?: number;
+    log?: (msg: string) => void;
+}
+/** The displayed text: every control line removed, surrounding blank lines trimmed. */
+export declare function stripControlLines(text: string): string;
+/** `unit:<run>:<ord>:<attempt>` → `{ord, attempt}`, or `null` for any other shape. */
+export declare function refOf(ref: string): {
+    ord: number;
+    attempt: number;
+} | null;
+/** `unit:<run>:<ord>:<attempt>` → the ord, or `null` for any other shape. */
+export declare function ordOfOutputRef(ref: string): number | null;
+/** The step id an answer unit's id carries (`<run>:answer-N` → `answer-N`), or `null`. */
+export declare function answerStepOf(runId: string, unitId: string): string | null;
+export declare class AskRelay {
+    private readonly deps;
+    /** run → ord → attempt → the `step.completed` row. */
+    private readonly rows;
+    /** run → ord → the latest attempt the engine dispatched / streamed / captured. */
+    private readonly attempts;
+    /** run → ord → the engine's own status of the latest captured attempt (`unitOutputCaptured`). */
+    private readonly captured;
+    /** run → ord → the unit (id + seat), resolved lazily from the run view; re-read per attempt. */
+    private readonly units;
+    /** `${run}:${ord}` → a fold waiting for its row (bounded by `rowGraceMs`). */
+    private readonly waiting;
+    /** `${run}:${ord}` whose reply went out (or is going out) — exactly one per answer unit. */
+    private readonly replied;
+    /** `${run}:${ord}` → the partial last line of the delta stream (a control line may split). */
+    private readonly tails;
+    /** Runs a terminal frame has ended: no later fold, row, grace or read continuation may speak
+     *  for them (codex on #810 r10, 2). */
+    private readonly ended;
+    /** `${run}:${ord}` whose reply was actually FOLDED (a reservation in `replied` may still be in
+     *  flight — a terminal must speak for it, r11, 1). */
+    private readonly spoken;
+    private readonly rowGraceMs;
+    constructor(deps: AskRelayDeps);
+    private log;
+    /** A `teamEvent` frame's bus row (the team /ws relay hands every row here). */
+    onTeamRow(row: BusEvent | undefined): void;
+    /** A CoreEvent of the engine's stream — only the unit / terminal frames are read. */
+    onCoreEvent(event: CoreEvent): Promise<void>;
+    /** A fold with no row of its attempt yet: wait for the row (the bus poll is 2 s) — bounded by
+     *  `rowGraceMs`, after which the reply is read from the record anyway. */
+    private awaitRow;
+    /** Forget a run (its chat closed). */
+    forget(runId: string): void;
+    private nested;
+    private nestedOne;
+    private noteAttempt;
+    /** The attempt the fold settles for (run, ord): the latest the engine's frames, the team rows or
+     *  the unit's persisted counter named — one monotonic boundary (r3, 1); attempts are 0-based
+     *  (r4, 1), so `undefined` = nothing has named one yet. */
+    private attemptOf;
+    /** Whether a frame labelled `attempt` belongs to an attempt the boundary has moved past. */
+    private superseded;
+    private rowFor;
+    private stopWaiting;
+    private learnPa;
+    /** The PA: the unit's seat for the CURRENT attempt (the cache is dropped per attempt, so a read
+     *  unit is this attempt's — a re-pick shows here before its bus row does; r4, 3); the team rows
+     *  (`path.started` / `path.repicked`) when the unit names no seat yet. */
+    private paOf;
+    /** `undefined`: a FRESH read failed — the durable record could not be certified (the caller
+     *  must not answer from the cache; r6, 1). `null`: no such unit. */
+    private unit;
+    /** The complete lines of the stream so far, control lines removed; the partial tail is held. */
+    private deltaText;
+    /** ONE reply per answer unit: the key is reserved before the first await (r1, 8). */
+    private reply;
+    /** The seats a failure must be said for: the PA when the path knows it, else every seat the
+     *  chat's live turns still wait on (the reserved audience of a random pick), else `pa`. */
+    private voicesFor;
+    /** The run view, retried a few times — a terminal fact must not be lost to one failed read. */
+    private unitsRetrying;
+    /** A terminal frame with no fold: the answer unit(s) still pending end the turn with `ok:false`.
+     *  The run view is read with a bounded retry; if it still cannot be read, the turn is ended
+     *  without the unit's facts rather than left pending (r8, 2). */
+    private terminal;
+}
+//# sourceMappingURL=ask-relay.d.ts.map

package/dist/api/ask-relay.d.ts.map

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