@teaflask/assistant 0.0.0 → 0.3.0

package/dist/core/question-drafts.js

@@ -0,0 +1,203 @@
+// The question-set draft store: where a member's in-progress
+// answers to a builtin.ask_questions pause live while they page through
+// the panel. OUTSIDE every component on purpose — the suspension pager
+// remounts the presented surface by decision identity, the transcript
+// remounts on every reconnect nonce, and the playground remounts its
+// whole transcript on send/retry — so a draft held in component state
+// dies at exactly the moments a member is most likely to be mid-answer.
+// Keyed by interrupt id (one pause = one question set) and question id
+// beneath it, so two sets can never bleed into each other and the pager
+// key's isolation guarantee survives without the key eating the draft.
+//
+// LIFETIME (ruled here, not inferred): created lazily on the first
+// mutation; kept across navigation, remount, reconnect and a failed
+// submit; cleared by the owner only on present-and-settled evidence (the
+// member's own successful submit or cancel, or a published card for the
+// same interrupt that reads answered/stale) — never on mere absence,
+// because a reconnect publishes an empty entry list before the replay
+// refills it; cleared wholesale on a thread switch. IN-MEMORY ONLY: a
+// page reload loses unsent drafts. That is a decision, not a gap — a
+// pause can be voided from another tab by a new message, and persisted
+// drafts would resurrect stale text against a superseded set.
+//
+// ACTIVE CHOICE is explicit: an option OR the custom row, never a hidden
+// "typed text wins" rule. Selecting an option keeps the custom text (the
+// member may come back to it); typing in the custom row makes it active.
+//
+// Deliberately import-free and React-free: every draft law (explicit
+// active choice, cursor in the draft, release only on explicit clear)
+// reads the same on every surface because there is one store — exported
+// on @teaflask/assistant/transcript for the playground.
+/** The per-answer transport bound the server enforces (QuestionAnswer.text
+ *  maxLength on the serving contract — pinned equal by the monorepo's
+ *  contract-parity test). The panel says so beside the row instead of
+ *  clipping: no silent truncation. Measured here in UTF-16 units
+ *  (String.length) while the server counts code points — an astral
+ *  character costs two here and one there, so this side is the stricter
+ *  or equal one and a text that passes the panel never fails the door. */
+export const MAX_ANSWER_TEXT_CHARS = 1900;
+const EMPTY_ANSWER = { active: null, customText: "" };
+const EMPTY_SET = { cursor: 0, answers: new Map() };
+export class QuestionDraftStore {
+    drafts = new Map();
+    listeners = new Set();
+    // Arrow fields on purpose: get/subscribe travel unbound into
+    // useSyncExternalStore.
+    get = (interruptId) => {
+        return this.drafts.get(interruptId) ?? EMPTY_SET;
+    };
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    };
+    /** True when the member has entered anything for this set — what the
+     *  panel's Cancel consults before asking "Discard answers?". */
+    hasContent(interruptId) {
+        const draft = this.drafts.get(interruptId);
+        if (draft === undefined) {
+            return false;
+        }
+        for (const answer of draft.answers.values()) {
+            if (answer.active !== null || answer.customText !== "") {
+                return true;
+            }
+        }
+        return false;
+    }
+    selectOption(interruptId, questionId, text) {
+        this.updateAnswer(interruptId, questionId, (answer) => ({
+            ...answer,
+            active: { kind: "option", text },
+        }));
+    }
+    selectCustom(interruptId, questionId) {
+        this.updateAnswer(interruptId, questionId, (answer) => ({
+            ...answer,
+            active: { kind: "custom" },
+        }));
+    }
+    /** Typing makes the custom row the active choice — the one implicit
+     *  switch, and it is the member's own keystroke. The text is written
+     *  as the door will accept it: pasted control characters are
+     *  normalized here (see normalizeCustomText), so the panel's posture —
+     *  every per-answer rule the door enforces is kept in view before the
+     *  POST — holds for the control rule as it does for the length bound. */
+    setCustomText(interruptId, questionId, text) {
+        this.updateAnswer(interruptId, questionId, (answer) => ({
+            ...answer,
+            active: { kind: "custom" },
+            customText: normalizeCustomText(text),
+        }));
+    }
+    setCursor(interruptId, cursor) {
+        const current = this.get(interruptId);
+        if (current.cursor === cursor) {
+            return;
+        }
+        this.drafts.set(interruptId, { ...current, cursor });
+        this.notify();
+    }
+    clear(interruptId) {
+        if (this.drafts.delete(interruptId)) {
+            this.notify();
+        }
+    }
+    clearAll() {
+        if (this.drafts.size === 0) {
+            return;
+        }
+        this.drafts.clear();
+        this.notify();
+    }
+    updateAnswer(interruptId, questionId, change) {
+        const current = this.get(interruptId);
+        const before = current.answers.get(questionId) ?? EMPTY_ANSWER;
+        const after = change(before);
+        if (before.customText === after.customText &&
+            sameChoice(before.active, after.active)) {
+            return;
+        }
+        const answers = new Map(current.answers);
+        answers.set(questionId, after);
+        this.drafts.set(interruptId, { cursor: current.cursor, answers });
+        this.notify();
+    }
+    notify() {
+        for (const listener of [...this.listeners]) {
+            listener();
+        }
+    }
+}
+function sameChoice(a, b) {
+    if (a === null || b === null) {
+        return a === b;
+    }
+    if (a.kind !== b.kind) {
+        return false;
+    }
+    return a.kind === "option" && b.kind === "option" ? a.text === b.text : true;
+}
+/** The text one question's draft answers with, or null while it has no
+ *  usable answer: an active option is its text; the custom row counts
+ *  only with non-blank text (submitted verbatim — trimming is for the
+ *  emptiness test alone, never the payload). */
+function answerTextOf(draft) {
+    const active = draft?.active ?? null;
+    if (active === null || draft === undefined) {
+        return null;
+    }
+    if (active.kind === "option") {
+        return active.text;
+    }
+    return draft.customText.trim() === "" ? null : draft.customText;
+}
+/** The complete answer set in question order, or null while any
+ *  question is unanswered — the panel's Submit gate and its POST body. */
+export function answersOf(questions, draft) {
+    const answers = [];
+    for (const question of questions) {
+        const text = answerTextOf(draft.answers.get(question.id));
+        if (text === null) {
+            return null;
+        }
+        answers.push({ id: question.id, text });
+    }
+    return answers;
+}
+/** The door refuses C0 control characters other than tab, newline and
+ *  carriage return (a transport rule that bounds the escaped worst case).
+ *  A textarea only normalizes CRLF, and real pastes carry the rest: Word
+ *  and Google Docs emit a vertical tab (U+000B) for a soft line break,
+ *  some PDF viewers a form feed (U+000C) for a page break. Those two ARE
+ *  line breaks to the member, so they become newlines — the break
+ *  survives unchanged in meaning; the others (NUL, BEL, BS, ESC, …) carry
+ *  no text and are dropped. Never a truncation: every printable character
+ *  stays exactly where it was. */
+function normalizeCustomText(text) {
+    return text
+        .replace(/[\u000b\u000c]/g, "\n")
+        .replace(/[\u0000-\u0008\u000e-\u001f]/g, "");
+}
+/** The index of the first question still without a usable answer, or -1
+ *  when the set is complete — what the footer names when Submit is gated,
+ *  and where a continue from the last question jumps to. */
+export function firstUnansweredIndexOf(questions, draft) {
+    return questions.findIndex((question) => answerTextOf(draft.answers.get(question.id)) === null);
+}
+/** The ids whose custom text exceeds the transport bound — the panel
+ *  says so beside the row instead of clipping (no silent truncation). */
+export function overLimitOf(questions, draft, maxChars) {
+    const over = [];
+    for (const question of questions) {
+        const answer = draft.answers.get(question.id);
+        if (answer !== undefined &&
+            answer.active?.kind === "custom" &&
+            answer.customText.length > maxChars) {
+            over.push(question.id);
+        }
+    }
+    return over;
+}
+//# sourceMappingURL=question-drafts.js.map

package/dist/core/question-drafts.js.map

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

package/dist/core/question-receipt.d.ts

@@ -0,0 +1,34 @@
+import type { AnsweredQuestions } from "./elicitation-cards.js";
+import { type QuestionModel } from "./elicitation-pickers.js";
+/** A settled question set as the transcript states it: the questions
+ *  and the member's answers (verbatim, line breaks kept). A cancelled set
+ *  is NOT a receipt — nothing was answered, and the dismissed fact is
+ *  the panel footer's to state (the meta-receipt rule), never a
+ *  transcript row's. */
+export interface SettledQuestionsReceipt {
+    questions: readonly QuestionModel[];
+    answers: readonly {
+        id: string;
+        text: string;
+    }[];
+}
+/** The receipt for a card this tab saw settle: the member's own answers
+ *  when the store stamped them, else the plain answered fact per
+ *  question (a set another client answered — the text never reached this
+ *  tab; the row's tool result is the durable record). Null for a
+ *  cancelled set: no receipt renders for a dismissal. */
+export declare function settledQuestionsReceiptOfCard(questions: readonly QuestionModel[], answered: AnsweredQuestions | null): SettledQuestionsReceipt | null;
+/**
+ * Recover a settled question set from a durable ask_user tool row:
+ * the stored arguments must narrow to a question set AND the
+ * result must be the tool's ANSWERED return — `{answers: [{id, text}]}` —
+ * for the row to collapse into a receipt. A cancelled return
+ * (`{cancelled: true}`) is a settled decision with no answers: the row
+ * keeps its own state and no prose renders for it (the meta-receipt rule:
+ * the dismissed fact is the panel footer's, in shelf-less hosts). A failure
+ * envelope, the chat fallback, or an unrelated tool's questions-shaped
+ * arguments never become one. Tool identity is checked first; the
+ * projection routes, it never guesses.
+ */
+export declare function settledQuestionsReceiptOf(toolName: string, argsText: string, resultText: string | undefined): SettledQuestionsReceipt | null;
+//# sourceMappingURL=question-receipt.d.ts.map

package/dist/core/question-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-receipt.d.ts","sourceRoot":"","sources":["../../src/core/question-receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAElC;;;;wBAIwB;AACxB,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IACpC,OAAO,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClD;AAED;;;;yDAIyD;AACzD,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,SAAS,aAAa,EAAE,EACnC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GACjC,uBAAuB,GAAG,IAAI,CAKhC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,uBAAuB,GAAG,IAAI,CAoChC"}

package/dist/core/question-receipt.js

@@ -0,0 +1,73 @@
+import { askQuestionsActionOf, } from "./elicitation-pickers.js";
+/** The receipt for a card this tab saw settle: the member's own answers
+ *  when the store stamped them, else the plain answered fact per
+ *  question (a set another client answered — the text never reached this
+ *  tab; the row's tool result is the durable record). Null for a
+ *  cancelled set: no receipt renders for a dismissal. */
+export function settledQuestionsReceiptOfCard(questions, answered) {
+    if (answered !== null && answered.kind === "cancelled") {
+        return null;
+    }
+    return { questions, answers: answered === null ? [] : answered.answers };
+}
+/**
+ * Recover a settled question set from a durable ask_user tool row:
+ * the stored arguments must narrow to a question set AND the
+ * result must be the tool's ANSWERED return — `{answers: [{id, text}]}` —
+ * for the row to collapse into a receipt. A cancelled return
+ * (`{cancelled: true}`) is a settled decision with no answers: the row
+ * keeps its own state and no prose renders for it (the meta-receipt rule:
+ * the dismissed fact is the panel footer's, in shelf-less hosts). A failure
+ * envelope, the chat fallback, or an unrelated tool's questions-shaped
+ * arguments never become one. Tool identity is checked first; the
+ * projection routes, it never guesses.
+ */
+export function settledQuestionsReceiptOf(toolName, argsText, resultText) {
+    if (toolName !== "ask_user" ||
+        resultText === undefined ||
+        resultText === "") {
+        return null;
+    }
+    const args = _recordOf(argsText);
+    const set = args === null ? null : askQuestionsActionOf(args);
+    if (set === null) {
+        return null;
+    }
+    const result = _recordOf(resultText);
+    if (result === null) {
+        return null;
+    }
+    if (!Object.prototype.hasOwnProperty.call(result, "answers")) {
+        return null;
+    }
+    const raw = result.answers;
+    if (!Array.isArray(raw)) {
+        return null;
+    }
+    const answers = [];
+    for (const candidate of raw) {
+        if (typeof candidate !== "object" || candidate === null) {
+            return null;
+        }
+        const record = candidate;
+        if (typeof record.id !== "string" || typeof record.text !== "string") {
+            return null;
+        }
+        answers.push({ id: record.id, text: record.text });
+    }
+    return { questions: set.questions, answers };
+}
+function _recordOf(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        return null;
+    }
+    return parsed;
+}
+//# sourceMappingURL=question-receipt.js.map

package/dist/core/question-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-receipt.js","sourceRoot":"","sources":["../../src/core/question-receipt.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,GAErB,MAAM,0BAA0B,CAAC;AAYlC;;;;yDAIyD;AACzD,MAAM,UAAU,6BAA6B,CAC3C,SAAmC,EACnC,QAAkC;IAElC,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAgB,EAChB,QAAgB,EAChB,UAA8B;IAE9B,IACE,QAAQ,KAAK,UAAU;QACvB,UAAU,KAAK,SAAS;QACxB,UAAU,KAAK,EAAE,EACjB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAmC,EAAE,CAAC;IACnD,KAAK,MAAM,SAAS,IAAI,GAAG,EAAE,CAAC;QAC5B,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,SAAoC,CAAC;QACpD,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC"}

package/dist/core/reasoning-copy.d.ts

@@ -0,0 +1,3 @@
+export declare const REASONING_STREAMING_LABEL = "Thinking\u2026";
+export declare const REASONING_SETTLED_LABEL = "Thought about it";
+//# sourceMappingURL=reasoning-copy.d.ts.map

package/dist/core/reasoning-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-copy.d.ts","sourceRoot":"","sources":["../../src/core/reasoning-copy.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,yBAAyB,mBAAc,CAAC;AACrD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC"}

package/dist/core/reasoning-copy.js

@@ -0,0 +1,10 @@
+// The reasoning step's two state labels, in core so both consumers read
+// ONE spelling: components/reasoning-row.tsx renders them on the row,
+// and core/run-folds.ts's liveFoldHeadlineOf names a collapsed live
+// fold's latest step with them. Components import core, never the
+// reverse — hoisting the strings here is what lets the pure headline
+// derivation say exactly what the row says without a core→component
+// import.
+export const REASONING_STREAMING_LABEL = "Thinking…";
+export const REASONING_SETTLED_LABEL = "Thought about it";
+//# sourceMappingURL=reasoning-copy.js.map

package/dist/core/reasoning-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-copy.js","sourceRoot":"","sources":["../../src/core/reasoning-copy.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sEAAsE;AACtE,oEAAoE;AACpE,kEAAkE;AAClE,qEAAqE;AACrE,oEAAoE;AACpE,UAAU;AAEV,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC;AACrD,MAAM,CAAC,MAAM,uBAAuB,GAAG,kBAAkB,CAAC"}

package/dist/core/receipt-anchors.d.ts

@@ -0,0 +1,36 @@
+import type { AgentSubscriber } from "@ag-ui/client";
+export interface AnchoredReceipts {
+    before: string[];
+    after: string[];
+}
+/**
+ * Narrow a receipt-carrying CUSTOM event's wire value (any by contract).
+ * Malformed payloads return null and are ignored — the contract's
+ * "clients MUST ignore events and fields they do not recognize".
+ */
+export declare function receiptOf(value: unknown): string | null;
+/**
+ * Idempotent anchor merge: every connection replays the stream from its
+ * boundary (and StrictMode aborts and reruns the first connection), so the
+ * same receipt can be anchored more than once per mount. Merging by content
+ * keeps replays from stuttering the rows.
+ */
+export declare function withReceiptAnchored(previous: ReadonlyMap<string, AnchoredReceipts>, messageId: string, position: keyof AnchoredReceipts, receipts: string[]): ReadonlyMap<string, AnchoredReceipts>;
+/**
+ * A defensive copy for seeding transcript state from the resume store:
+ * entries that do not hold well-formed receipts are dropped rather than
+ * rendered (or crashed on). The store is in-memory today, so every entry
+ * it holds passed the payload narrower — this seam is where any future
+ * persisted form of the store must degrade gracefully instead of wedging
+ * the resume path: a dropped receipt reappears on the next full replay.
+ */
+export declare function wellFormedReceiptAnchorsOf(stored: ReadonlyMap<string, AnchoredReceipts>): ReadonlyMap<string, AnchoredReceipts>;
+/**
+ * Anchors each of one marker's receipts: the marker and its run's
+ * terminal are written in one commit, so the terminal is always the very
+ * next event — the live RUN_ERROR for turn_failed, demoted to a quiet
+ * RUN_FINISHED on replay — and the receipt flushes to a row after that
+ * run's last message on either one.
+ */
+export declare function receiptMarkerRecorder(eventName: string, onReceiptAnchored: (runId: string, messageId: string, position: keyof AnchoredReceipts, receipts: string[]) => void): AgentSubscriber;
+//# sourceMappingURL=receipt-anchors.d.ts.map

package/dist/core/receipt-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-anchors.d.ts","sourceRoot":"","sources":["../../src/core/receipt-anchors.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAkBrD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASvD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC/C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,gBAAgB,EAChC,QAAQ,EAAE,MAAM,EAAE,GACjB,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAgBvC;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC5C,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAavC;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,CACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,gBAAgB,EAChC,QAAQ,EAAE,MAAM,EAAE,KACf,IAAI,GACR,eAAe,CAwDjB"}

package/dist/core/receipt-anchors.js

@@ -0,0 +1,137 @@
+// The string-receipt anchor family ({ receipt: string }, pinned per-marker by
+// tests/contract-parity): the marker and its run's terminal are written in
+// one commit, the receipt never becomes a message, and the row renders after
+// the run's last message. The package's one consumer is turn_failed (the
+// turn_voided row was deleted with the meta-receipts); the dashboard binds
+// turn_failed and turn_stopped through ./transcript, so ReceiptPayload pins
+// all three.
+import { WIRE_SENTENCE_MAX_CHARS } from "./wire-sentence-cap.js";
+/**
+ * Narrow a receipt-carrying CUSTOM event's wire value (any by contract).
+ * Malformed payloads return null and are ignored — the contract's
+ * "clients MUST ignore events and fields they do not recognize".
+ */
+export function receiptOf(value) {
+    if (typeof value !== "object" || value === null) {
+        return null;
+    }
+    const payload = value;
+    if (typeof payload.receipt !== "string" || payload.receipt === "") {
+        return null;
+    }
+    return payload.receipt.slice(0, WIRE_SENTENCE_MAX_CHARS);
+}
+/**
+ * Idempotent anchor merge: every connection replays the stream from its
+ * boundary (and StrictMode aborts and reruns the first connection), so the
+ * same receipt can be anchored more than once per mount. Merging by content
+ * keeps replays from stuttering the rows.
+ */
+export function withReceiptAnchored(previous, messageId, position, receipts) {
+    const anchored = previous.get(messageId) ?? { before: [], after: [] };
+    // Unique within the batch too: a flush can carry the same receipt
+    // twice when two connections' deliveries pooled before it.
+    const fresh = [...new Set(receipts)].filter((receipt) => !anchored[position].includes(receipt));
+    if (fresh.length === 0) {
+        return previous;
+    }
+    const next = new Map(previous);
+    next.set(messageId, {
+        ...anchored,
+        [position]: [...anchored[position], ...fresh],
+    });
+    return next;
+}
+/**
+ * A defensive copy for seeding transcript state from the resume store:
+ * entries that do not hold well-formed receipts are dropped rather than
+ * rendered (or crashed on). The store is in-memory today, so every entry
+ * it holds passed the payload narrower — this seam is where any future
+ * persisted form of the store must degrade gracefully instead of wedging
+ * the resume path: a dropped receipt reappears on the next full replay.
+ */
+export function wellFormedReceiptAnchorsOf(stored) {
+    const seeded = new Map();
+    // The narrowing deliberately distrusts the map's own types: this seam
+    // is what turns a stale shape into missing rows instead of a crash.
+    const entries = stored;
+    for (const [messageId, anchored] of entries) {
+        const before = _wellFormedReceiptsAt(anchored, "before");
+        const after = _wellFormedReceiptsAt(anchored, "after");
+        if (before.length > 0 || after.length > 0) {
+            seeded.set(messageId, { before, after });
+        }
+    }
+    return seeded;
+}
+/**
+ * Anchors each of one marker's receipts: the marker and its run's
+ * terminal are written in one commit, so the terminal is always the very
+ * next event — the live RUN_ERROR for turn_failed, demoted to a quiet
+ * RUN_FINISHED on replay — and the receipt flushes to a row after that
+ * run's last message on either one.
+ */
+export function receiptMarkerRecorder(eventName, onReceiptAnchored) {
+    let pendingReceipts = [];
+    let currentRunId = null;
+    let newestMessageId = null;
+    // One flush for both terminals: a failed run's live ending is
+    // RUN_ERROR, and replay demotes it to a quiet RUN_FINISHED — the
+    // turn_failed receipt must flush on either, or a live failure would
+    // anchor nothing until the next reload.
+    const flush = () => {
+        if (pendingReceipts.length === 0 ||
+            newestMessageId === null ||
+            currentRunId === null) {
+            return;
+        }
+        onReceiptAnchored(currentRunId, newestMessageId, "after", pendingReceipts);
+        pendingReceipts = [];
+    };
+    return {
+        // One agent can be connected more than once (StrictMode detaches
+        // the first run terminal-free and starts over): receipts a dead
+        // connection collected but never flushed must not ride into the
+        // replacement's flush, or the replay's own copy doubles them.
+        onRunInitialized() {
+            pendingReceipts = [];
+            currentRunId = null;
+            newestMessageId = null;
+        },
+        onRunStartedEvent({ event }) {
+            // The server-named run id: the receipt's identity rides the run
+            // it marked, so re-deliveries anchor once no matter where each
+            // connection's message list has drifted to at flush time.
+            currentRunId = event.runId;
+        },
+        onCustomEvent({ event }) {
+            if (event.name !== eventName) {
+                return;
+            }
+            const receipt = receiptOf(event.value);
+            if (receipt !== null) {
+                pendingReceipts.push(receipt);
+            }
+        },
+        onMessagesChanged({ messages }) {
+            newestMessageId = messages.at(-1)?.id ?? null;
+        },
+        onRunFinishedEvent() {
+            flush();
+        },
+        onRunErrorEvent() {
+            flush();
+        },
+    };
+}
+function _wellFormedReceiptsAt(anchored, position) {
+    if (typeof anchored !== "object" || anchored === null) {
+        return [];
+    }
+    const receipts = anchored[position];
+    if (!Array.isArray(receipts)) {
+        return [];
+    }
+    return receipts.filter((receipt) => typeof receipt === "string" && receipt !== "");
+}
+//# sourceMappingURL=receipt-anchors.js.map

package/dist/core/receipt-anchors.js.map

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

package/dist/core/run-folds.d.ts

@@ -0,0 +1,103 @@
+import { type SegmentDuration } from "./segment-timing.js";
+import { type AssistantTextRow, type MarkerBoundaries, type ReasoningRow, type ToolCallRow, type TranscriptBlock, type TranscriptRow } from "./transcript-rows.js";
+export type RunFoldMember = ReasoningRow | ToolCallRow | AssistantTextRow;
+/** The fold's steps in transcript order: tool calls verbatim, narration
+ *  verbatim at its own position, and each CONTIGUOUS run of reasoning rows
+ *  merged into one thinking block at the run's position — adjacent deltas
+ *  read as one thought; thinking after a tool call stays below it. */
+export type RunFoldStep = {
+    kind: "reasoning";
+    view: ReasoningRow;
+} | {
+    kind: "tool-call";
+    row: ToolCallRow;
+} | {
+    kind: "narration";
+    view: AssistantTextRow;
+};
+export interface RunFoldRow {
+    kind: "run-fold";
+    /** Derived from the first WORK member (reasoning or tool call, never
+     *  narration), so stable across the running→settled flip AND episode
+     *  unification: a settled episode's key equals the key of the live cluster
+     *  it starts with, so a surviving fold's <details> never remounts
+     *  mid-conversation (TVC-014 element identity; TVC-084 key continuity). */
+    key: string;
+    /** The raw member rows — liveness and pending-decision derivations
+     *  read these, and each work member still carries its own timing. */
+    members: readonly RunFoldMember[];
+    steps: readonly RunFoldStep[];
+    /** This fold's own span, reduced over its members' timing evidence —
+     *  unknown when no member carries any (an old history), never zero. */
+    duration: SegmentDuration;
+}
+/** Reasoning is structurally excluded from the folded list: it only ever
+ *  renders inside a run fold. */
+export type FoldedTranscriptRow = Exclude<TranscriptRow, ReasoningRow> | RunFoldRow;
+export interface RunFoldsOptions {
+    /** True while the newest turn is non-terminal (queued, working,
+     *  awaiting_input, parked — isTerminalTurnStatus's complement): the
+     *  trailing turn then keeps the per-cluster live folding so nothing
+     *  moves mid-turn and no intermediate paragraph is prematurely read as
+     *  the final answer. Settled turns always unify into episodes. */
+    openTailTurn?: boolean;
+    /** The tail turn's start index, pre-computed by the caller: foldedBlocksOf
+     *  derives it ONCE over the whole flat list and hands each segment its
+     *  clamped offset, so a mid-open-turn boundary never prematurely
+     *  episode-folds the open turn. Outranks openTailTurn; clamped to the list. */
+    tailStart?: number;
+}
+/** Fold the projected rows. Rows before the tail turn (and the whole list
+ *  once the newest turn settles) fold as completed episodes; the open tail
+ *  turn — from the last user or subagent-delivery row on — keeps the live
+ *  per-cluster folding. */
+export declare function runFoldsOf(rows: readonly TranscriptRow[], options?: RunFoldsOptions): FoldedTranscriptRow[];
+/** A row either turn-boundary scan may read: the projection's raw rows or
+ *  the fold pass's display rows. The union keeps the boundary kinds below as
+ *  checked literals — a renamed row kind fails the build here. */
+type TurnBoundaryRow = TranscriptRow | FoldedTranscriptRow;
+/** A block whose rows the declared-start scan counts: the projection's
+ *  TranscriptBlock and the fold pass's own FoldedBlock both qualify. */
+interface CountableBlock {
+    messageId: string;
+    rows: readonly TurnBoundaryRow[];
+}
+/**
+ * Where the current turn starts, as a flat index into `rows`: the LAST
+ * boundary of either kind — the newest row the tail scan recognizes or the
+ * newest declared turn-start block — whichever is later. `null` blocks
+ * means only the row scan applies. The fold pass and the row list's
+ * placement hold both read this spelling, so the two windows never disagree.
+ */
+export declare function currentTurnStartOf(rows: readonly TurnBoundaryRow[], blocks: readonly CountableBlock[] | null, turnStartIds?: ReadonlySet<string>): number;
+/** The settled fold headline. The duration is the member-relevant cost —
+ *  never a step count (TVC-011) — and the register is honest about its
+ *  evidence: a measured sub-second span reads "<1s", never "Worked for 0s";
+ *  an unknown span degrades to the neutral "Worked", never an invented
+ *  duration (docs/replay-metadata-contract.md, "Unknown vs sub-second"). */
+export declare function settledFoldHeadlineOf(duration: SegmentDuration): string;
+/**
+ * A COLLAPSED live fold's headline: the latest step's own label, so the
+ * member tracks the work without expanding (the expanded fold keeps the
+ * generic "Working…"). Each label is the one the step's own row wears: a
+ * tool call reads toolRowHeadlineOf on its OWN state, a reasoning step the
+ * ReasoningRow labels; narration is skipped (prose is not a work step); no
+ * usable step → "Working…". Returned RAW: the renderer (FoldHeadline)
+ * truncates for display and carries this text as its wrapper's title.
+ */
+export declare function liveFoldHeadlineOf(steps: readonly RunFoldStep[]): string;
+export interface FoldedBlock {
+    messageId: string;
+    rows: FoldedTranscriptRow[];
+}
+export declare function foldedBlocksOf(blocks: readonly TranscriptBlock[], options?: Omit<RunFoldsOptions, "tailStart"> & {
+    markerBoundaries?: MarkerBoundaries;
+    /** Message ids that BEGIN a turn without a user message — the
+     *  machine-initiated delivery turns. A host that draws its own delivery
+     *  marker (agent mode rides the delivery anchors in EMPTY, so no row is
+     *  projected) must hand the turn starts in here, or the open tail window
+     *  falls back to the previous member turn's user row. */
+    turnStartIds?: ReadonlySet<string>;
+}): FoldedBlock[];
+export {};
+//# sourceMappingURL=run-folds.d.ts.map