@buoy-gg/ask-buoy 7.0.34 → 7.0.36

package/lib/typescript/store/askBuoyStore.d.ts

@@ -1,16 +1,3 @@
-/**
- * Conversation state for the sheet.
- *
- * A module-level store rather than component state for two reasons: the sheet
- * is unmounted whenever the tool is closed or minimised (and a conversation
- * that vanished because someone tapped away would be maddening), and the sync
- * adapter needs to read the same transcript to show it on the desktop.
- *
- * Deliberately NOT persisted. A transcript can contain anything the agent read
- * — storage values, response bodies, a customer's record — and writing that to
- * disk under a Buoy key would put it in the Storage tool and, from there, on
- * the unauthenticated broker wire. It lives for the session and no longer.
- */
 import type { Block, BlockAnswer, AskBuoySession, EffectLedger, TurnEvent } from "@buoy-gg/agent-core";
 /** A block in a message, and (for receipts) the tool call that produced it. */
 export interface PlacedBlock {
@@ -25,9 +12,50 @@ export interface ChatToolCall {
     label: string;
     /** The catalog's fuller sentence, shown when the row is expanded. */
     description?: string;
-    status: "running" | "ok" | "failed" | "refused";
+    /**
+     * `refused` — the policy said no. `declined` — the USER said no on the
+     * approval card. Both are rows for calls that never ran, and both matter:
+     * a turn that changed course because permission was withheld is unreadable
+     * without them. `stopped` — the user pressed Stop before this call started;
+     * the engine checks the abort signal before every call in a batch, and a
+     * call it skipped is shown rather than silently omitted, because the user
+     * needs to know which of the proposed changes did NOT land.
+     */
+    status: "running" | "ok" | "failed" | "refused" | "declined" | "stopped";
     /** Trailing status word once finished — "12 items", "Not found", "Done". */
     summary?: string;
+    /**
+     * What the model asked this step to do, serialised and capped. Shown only in
+     * the thinking view — it is the difference between "a storage write ran" and
+     * "it wrote `null` to `@pokemart/bag`".
+     */
+    params?: string;
+    /** read / write / destructive, from the catalog. */
+    effect?: "read" | "write" | "destructive";
+    /** Epoch ms the dispatch started, and how long it took. */
+    startedAt?: number;
+    durationMs?: number;
+    /**
+     * The redacted result the model was given, capped.
+     *
+     * IN MEMORY ONLY. `transcriptPersistence` strips it before writing, which is
+     * what keeps the promise that tool results never reach the disk; it leaves
+     * on the clipboard because that is a deliberate human act, the same as Share.
+     */
+    result?: string;
+}
+/**
+ * A stretch of the model's own reasoning, and where it fell.
+ *
+ * `afterCalls` is how many tool calls this message had already made when the
+ * thought arrived, so the thinking view can lay reasoning and steps out in the
+ * order they actually happened. One assistant bubble spans every turn of a
+ * multi-step run, so "think, act, think, act" is the normal shape and showing
+ * all the thoughts in a lump at the top would misreport it.
+ */
+export interface ChatReasoning {
+    text: string;
+    afterCalls: number;
 }
 export interface ChatMessage {
     id: string;
@@ -36,9 +64,45 @@ export interface ChatMessage {
     toolCalls: ChatToolCall[];
     /** Rich blocks — receipts from tool results and model-authored blocks. */
     blocks: PlacedBlock[];
+    /** The model's reasoning, when the provider reports any. See ChatReasoning. */
+    reasoning?: ChatReasoning[];
+    /** Epoch ms the turn opened and closed — the answer's wall time. */
+    startedAt?: number;
+    endedAt?: number;
+    /** Tokens this ONE answer cost, across however many provider requests it took. */
+    usage?: {
+        input: number;
+        output: number;
+        requests: number;
+    };
     /** Set while the assistant is still streaming this message. */
     streaming?: boolean;
     error?: string;
+    /**
+     * The user pressed Stop.
+     *
+     * Kept apart from `error` because it is not one: the abort surfaces as a
+     * cancelled fetch, and reported as an error it told the user "couldn't reach
+     * your AI endpoint, check the connection" about a thing they had just chosen
+     * to do — with a Swift exception underneath it.
+     */
+    stopped?: boolean;
+    /**
+     * This bubble came back from disk.
+     *
+     * The MODEL does not remember it the way the screen does: a restored history
+     * is rewound to the last complete round, so an Ask block — which ends its
+     * turn with a `buoy_ui` call — is always rewound out of the model's memory
+     * while its buttons stay tappable on screen. Answering one has to carry the
+     * question with it. See `answer` in useAskBuoy.
+     */
+    restored?: boolean;
+    /**
+     * A line from Buoy itself, not the model — "older messages were trimmed".
+     * Rendered as a dim centred note, never as an answer, and never given a
+     * footer or a copy pill.
+     */
+    system?: boolean;
     /**
      * True once a tool call has run and no narration has arrived since.
      *
@@ -57,11 +121,52 @@ export interface PendingApproval {
     label: string;
     description?: string;
     reason: string;
+    /** The call itself. Never rendered; kept so a restored card can run it. */
+    params?: Record<string, unknown>;
+    /**
+     * This card came back from disk after a reload.
+     *
+     * The turn that asked the question died with the JS context, so there is no
+     * promise left to resolve and no model waiting on the answer. Allow has to
+     * dispatch the call itself — see `approve` in useAskBuoy.
+     */
+    restored?: boolean;
+    /**
+     * Fingerprint of what the call would overwrite, as of when it was asked.
+     * A restored Allow re-reads and compares before writing: same label, same
+     * params, different app state is exactly the case a restart produces. A
+     * hash, so nothing of the value itself is persisted.
+     */
+    targetDigest?: string;
     resolve: (approved: boolean) => void;
 }
+/**
+ * A message typed while a turn was running.
+ *
+ * A list with ids, not a string: the single slot it replaced OVERWROTE — type
+ * two things mid-turn and the first vanished, which is precisely the loss the
+ * queue exists to prevent. Ids so two identical requests stay distinguishable
+ * and the list can be edited by row.
+ */
+export interface QueuedMessage {
+    id: string;
+    text: string;
+}
+/**
+ * The one word every component reads to know what the chat is doing.
+ *
+ * Presentation state (minimised, settings open) is NOT in here on purpose —
+ * it sits on top. This exists because the header, the composer, the queue
+ * flush and the modal each used to derive their own answer from five
+ * overlapping booleans, and disagreed: the queue fired after an error because
+ * "not busy" looked like "idle" to it.
+ */
+export type TurnPhase = "idle" | "running" | "awaitingApproval" | "awaitingAnswer" | "stopping";
 export interface AskBuoyState {
     messages: ChatMessage[];
     busy: boolean;
+    /** Stop was pressed and the turn has not yet wound down. See TurnPhase. */
+    stopping: boolean;
     pending: PendingApproval | null;
     /** Set when the tool is unconfigured or the endpoint keeps failing. */
     notice: string | null;
@@ -73,14 +178,34 @@ export interface AskBuoyState {
     awaitingBlockId: string | null;
     /** Run state of block action buttons, keyed `${blockId}:${label}`. */
     actionState: Record<string, "running" | "done" | "failed">;
-    /** A message typed while a turn was running; sent when the turn finishes. */
-    queued: string | null;
+    /** Messages typed while a turn was running, in the order they were typed. */
+    queued: QueuedMessage[];
+    /**
+     * Text handed back to the composer — a queued message the user tapped to
+     * edit. The composer takes it and calls `clearDraft`.
+     */
+    draft: string | null;
     /** Session token totals, accumulated from provider usage reports. */
     usage: {
         input: number;
         output: number;
         requests: number;
     };
+    /**
+     * Which model, app and build this conversation happened against.
+     *
+     * Carried so an exported run identifies itself. A pasted trace with no model
+     * name is unusable a day later — "it did the wrong thing" and "gpt-4.1 did
+     * the wrong thing" are different bug reports.
+     */
+    meta: SessionMeta;
+}
+export interface SessionMeta {
+    model?: string;
+    protocol?: string;
+    appName?: string;
+    platform?: string;
+    build?: "development" | "release";
 }
 type Listener = () => void;
 export declare const askBuoyStore: {
@@ -95,11 +220,26 @@ export declare const askBuoyStore: {
     } | null;
     setNotice(notice: string | null): void;
     setConfigured(configured: boolean): void;
+    setMeta(meta: SessionMeta): void;
     addUser(text: string): void;
     /** Mark a turn as running without adding a bubble — the retry path. */
     beginTurn(): void;
-    /** Park a message typed mid-turn instead of silently dropping it. */
-    setQueued(text: string | null): void;
+    /** Park a message typed mid-turn, behind whatever is already parked. */
+    enqueue(text: string): QueuedMessage;
+    /** Drop one parked message — the ✕ on its row. */
+    removeQueued(id: string): void;
+    /** Take the FIRST parked message off the queue — the flush path. */
+    shiftQueued(): QueuedMessage | undefined;
+    /** Hand one parked message back to the composer to edit. See `draft`. */
+    takeQueuedToDraft(id: string): void;
+    /**
+     * The user pressed Stop. The turn is still winding down — the abort is only
+     * read between calls — so the phase is `stopping`, not `idle`, until
+     * `finishAssistant` lands.
+     */
+    requestStop(): void;
+    /** The composer has taken the draft into its input. */
+    clearDraft(): void;
     /** Drop one message — the failed assistant bubble a retry replaces. */
     removeMessage(id: string): void;
     /** The user answered (or skipped) an Ask block. */
@@ -115,10 +255,68 @@ export declare const askBuoyStore: {
      * only form a non-developer can actually check.
      */
     applyEvent(messageId: string, ev: TurnEvent): void;
+    /** The user pressed Stop on this turn. See `ChatMessage.stopped`. */
+    markStopped(messageId: string): void;
     finishAssistant(messageId: string): void;
     askApproval(input: Omit<PendingApproval, "resolve">): Promise<boolean>;
     answerApproval(approved: boolean): void;
+    /**
+     * Put an unanswered approval back after a restart.
+     *
+     * A question the app asked and then forgot is worse than not asking: the
+     * user tapped nothing, so as far as they are concerned the change is still
+     * waiting for them. `resolve` is a no-op because nothing is waiting on this
+     * one any more; `restored` is what tells the sheet to run the call rather
+     * than answer a dead promise.
+     *
+     * Refused once a turn is under way, for the same reason `hydrate` is: a slow
+     * disk read must not shove an old question in front of a live conversation.
+     */
+    restorePending(input: Omit<PendingApproval, "resolve" | "restored">): boolean;
+    /**
+     * A line in the transcript from Buoy itself rather than from the model.
+     *
+     * It wears the assistant's bubble because that is the only shape the list
+     * renders, but nothing is sent to the model and nothing lands in its
+     * history — it exists so an approval answered after a restart leaves a
+     * trace, instead of the card silently vanishing a second time.
+     */
+    addNote(text: string): void;
+    /**
+     * Put a saved conversation back, once, at open.
+     *
+     * Refuses if anything has been said already: a slow disk read landing after
+     * the user has started typing must not shove an old chat in front of them.
+     */
+    hydrate(input: {
+        messages: ChatMessage[];
+        answers: Record<string, BlockAnswer>;
+        usage: {
+            input: number;
+            output: number;
+            requests: number;
+        };
+        /**
+         * Messages that were still parked when the app died. Restored VISIBLY and
+         * never auto-sent: the turn they were waiting on is gone, and a request
+         * firing by itself on relaunch is the one thing a restart must not do.
+         */
+        queued?: QueuedMessage[];
+    }): boolean;
     reset(): void;
 };
+/** See TurnPhase. Pure, so every component and the flush effect agree. */
+export declare function turnPhaseOf(s: AskBuoyState): TurnPhase;
+/**
+ * Why parked messages are NOT being sent right now, in the user's words — or
+ * null when the queue may deliver.
+ *
+ * A queued message is a next TASK, not an answer. It used to go the moment
+ * `busy` dropped: after an error it fired into the same dead connection, and
+ * with a choice block open it was sent as the reply to the question. So the
+ * queue holds on error, Stop, an approval and an unanswered Ask block, and
+ * says which.
+ */
+export declare function queuePauseReason(s: AskBuoyState): string | null;
 export {};
 //# sourceMappingURL=askBuoyStore.d.ts.map

package/lib/typescript/store/askBuoyStore.d.ts.map

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

package/lib/typescript/store/blockPlacement.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Where each block of a turn is drawn: inside a step row, after the prose as
+ * the answer itself, or last of all as the thing being asked.
+ *
+ * Pure and separate from MessageList because the rule is subtle and the cost
+ * of getting it wrong is silent — a block that lands in no bucket renders
+ * nowhere at all, and nothing in the UI says so. That is exactly what
+ * happened: "show me the shop as pictures" built its imageGrid, the engine
+ * accepted it, and the sheet dropped it on the floor twice while the model
+ * narrated the artwork in prose.
+ */
+import { type Block } from "@buoy-gg/agent-core";
+import type { PlacedBlock } from "./askBuoyStore";
+export interface BlockPlacement {
+    /** Receipts folded into the step row that produced them, by tool-call id. */
+    nested: Map<string, Block[]>;
+    /**
+     * Cards drawn AFTER the prose — the answer itself, once the text has said
+     * what it is. Named for the position on purpose: this bucket used to render
+     * between the activity list and the text, which put a 28-item grid above
+     * the five paragraphs explaining it. The order is a promise the prompt
+     * makes to the model ("say what it means, then show it"), so it must not be
+     * a detail of how MessageList happens to be laid out.
+     */
+    afterText: PlacedBlock[];
+    /** Choice / confirm / input — drawn last of all, after the answer. */
+    ask: PlacedBlock[];
+}
+export declare function placeBlocks(blocks: PlacedBlock[], stepIds: Iterable<string>): BlockPlacement;
+//# sourceMappingURL=blockPlacement.d.ts.map

package/lib/typescript/store/blockPlacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockPlacement.d.ts","sourceRoot":"","sources":["../../../src/store/blockPlacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAc,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7B;;;;;;;OAOG;IACH,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,sEAAsE;IACtE,GAAG,EAAE,WAAW,EAAE,CAAC;CACpB;AAiBD,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,cAAc,CAwB5F"}

package/lib/typescript/store/blockPlacement.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=blockPlacement.test.d.ts.map

package/lib/typescript/store/blockPlacement.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockPlacement.test.d.ts","sourceRoot":"","sources":["../../../src/store/blockPlacement.test.ts"],"names":[],"mappings":""}

package/lib/typescript/store/queue.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue.test.d.ts.map

package/lib/typescript/store/queue.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.test.d.ts","sourceRoot":"","sources":["../../../src/store/queue.test.ts"],"names":[],"mappings":""}

package/lib/typescript/store/resetConversation.d.ts

@@ -0,0 +1,38 @@
+/**
+ * "New conversation" — the ONE way a conversation is cleared.
+ *
+ * Clearing drops the effect ledger, which is the only undo surface, while the
+ * agent's changes stay live in the app. So the path that clears has to be the
+ * path that knows whether undo succeeded — and there used to be two paths
+ * that did not: the sheet's "Undo, then clear" awaited `revertAll` and reset
+ * without reading the outcome (two of five reverts fail, the conversation
+ * clears anyway, two changes stay applied with no record), and the desktop's
+ * `reset` action skipped the question entirely.
+ *
+ * Both now come through here. A failed revert does NOT clear: the caller gets
+ * the list of what is still applied and clearing becomes a second, explicit
+ * choice.
+ */
+import type { DispatchFn, RevertOutcome } from "@buoy-gg/agent-core";
+export interface ResetOutcome {
+    /** The conversation, session and saved copy are gone. */
+    cleared: boolean;
+    /** How many changes were put back first. */
+    reverted: number;
+    /** Changes that could not be put back and are still live in the app. */
+    failed: RevertOutcome["failed"];
+}
+/** Clear everything, unconditionally. The caller has already decided. */
+export declare function clearConversation(): void;
+/**
+ * Undo what can be undone, then clear — unless something would not go back.
+ *
+ * Refuses while a turn is running: the ledger is being written to, and a
+ * revert racing a dispatch is how "changed since Ask Buoy wrote it" happens
+ * to our own write.
+ */
+export declare function resetConversation(input: {
+    dispatch: DispatchFn;
+    undoFirst: boolean;
+}): Promise<ResetOutcome>;
+//# sourceMappingURL=resetConversation.d.ts.map

package/lib/typescript/store/resetConversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resetConversation.d.ts","sourceRoot":"","sources":["../../../src/store/resetConversation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKrE,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CACjC;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,YAAY,CAAC,CAexB"}

package/lib/typescript/store/restorePending.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=restorePending.test.d.ts.map

package/lib/typescript/store/restorePending.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restorePending.test.d.ts","sourceRoot":"","sources":["../../../src/store/restorePending.test.ts"],"names":[],"mappings":""}

package/lib/typescript/store/restoredIds.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=restoredIds.test.d.ts.map

package/lib/typescript/store/restoredIds.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoredIds.test.d.ts","sourceRoot":"","sources":["../../../src/store/restoredIds.test.ts"],"names":[],"mappings":""}

package/lib/typescript/store/suggestions.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The empty state's "try asking" chips, filtered to what will actually work.
+ *
+ * The list was static, so a release build offered "Make the next request fail
+ * with a 500" directly above a line saying simulations need a dev build — and
+ * the agent then refused the very thing the screen had just suggested. First
+ * impression: broken. Each chip now says what it needs; the empty state keeps
+ * the ones this device, build and policy can honour.
+ *
+ * Deterministic on purpose: no model call, no navigation, no guessed route
+ * names or account ids. When the tool registry has not reported yet (it fills
+ * in a frame or two after open) only the chips that need nothing are shown —
+ * a short list that grows beats a long one that shrinks.
+ */
+export interface Suggestion {
+    text: string;
+    /** A Buoy tool that must be registered on this device. */
+    needs?: string;
+    /** The chip asks for a change — hidden in read-only mode. */
+    write?: boolean;
+    /** The chip drives a dev-only simulation — hidden in a release build. */
+    devOnly?: boolean;
+}
+export declare const SUGGESTIONS: Suggestion[];
+/** At most this many chips — the rest of the screen is the point. */
+export declare const MAX_SUGGESTIONS = 4;
+export declare function pickSuggestions(input: {
+    availableToolIds: string[];
+    readOnly: boolean;
+    isRelease: boolean;
+}): string[];
+//# sourceMappingURL=suggestions.d.ts.map

package/lib/typescript/store/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../../../src/store/suggestions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,WAAW,EAAE,UAAU,EAOnC,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,EAAE,CAUX"}

package/lib/typescript/store/suggestions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=suggestions.test.d.ts.map

package/lib/typescript/store/suggestions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.test.d.ts","sourceRoot":"","sources":["../../../src/store/suggestions.test.ts"],"names":[],"mappings":""}

package/lib/typescript/store/systemLine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=systemLine.test.d.ts.map

package/lib/typescript/store/systemLine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemLine.test.d.ts","sourceRoot":"","sources":["../../../src/store/systemLine.test.ts"],"names":[],"mappings":""}

package/lib/typescript/store/ticketPrompt.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The "Summarize for a ticket" request, sent as an ordinary user message.
+ *
+ * One button, one canned sentence, because the machinery already exists: the
+ * prompt teaches the `finding` block and the renderer draws it. What was
+ * missing was a way to ASK for one without knowing the word, and a Copy that
+ * includes it (see blockText.ts). Facts and inference are separated in the
+ * ask, nothing is re-run to produce it, and nothing is submitted anywhere.
+ */
+export declare const TICKET_PROMPT: string;
+//# sourceMappingURL=ticketPrompt.d.ts.map

package/lib/typescript/store/ticketPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticketPrompt.d.ts","sourceRoot":"","sources":["../../../src/store/ticketPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,QAMiG,CAAC"}

package/lib/typescript/store/traceText.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The agent's work for one answer, laid out in the order it happened.
+ *
+ * `traceEntries` is the ordering, shared by the collapsible strip in the chat
+ * and by the JSON export — the two must agree, because the point of the export
+ * is reading elsewhere the run you were just looking at. `traceToText` is the
+ * plain-text rendering, kept for a quick paste into Slack; the debugging
+ * artefact is `sessionExport.ts`.
+ *
+ * Reasoning and steps INTERLEAVE. One assistant bubble spans every turn of a
+ * multi-step run, so the real shape is "think, act, think, act"; lumping the
+ * thoughts at the top would misreport when the model knew what.
+ */
+import type { ChatMessage, ChatToolCall } from "./askBuoyStore";
+export type TraceEntry = {
+    kind: "thought";
+    text: string;
+} | {
+    kind: "step";
+    n: number;
+    call: ChatToolCall;
+};
+export declare function traceEntries(message: ChatMessage): TraceEntry[];
+/** Has this message anything to show? Drives whether the strip renders at all. */
+export declare function hasTrace(message: ChatMessage): boolean;
+/**
+ * The trace as plain text, for the clipboard.
+ *
+ * Indented under the answer it belongs to so a pasted session still reads as a
+ * conversation rather than a log dump.
+ */
+export declare function traceToText(message: ChatMessage, indent?: string): string[];
+//# sourceMappingURL=traceText.d.ts.map

package/lib/typescript/store/traceText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceText.d.ts","sourceRoot":"","sources":["../../../src/store/traceText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,WAAW,EAAiB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/E,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAEpD,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,EAAE,CAoB/D;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAEtD;AASD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAO,GAAG,MAAM,EAAE,CAezE"}

package/lib/typescript/store/traceText.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=traceText.test.d.ts.map

package/lib/typescript/store/traceText.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceText.test.d.ts","sourceRoot":"","sources":["../../../src/store/traceText.test.ts"],"names":[],"mappings":""}

package/lib/typescript/store/transcriptPersistence.d.ts

@@ -0,0 +1,79 @@
+import type { AgentMessage, LedgerEntry } from "@buoy-gg/agent-core";
+import type { ChatMessage, PendingApproval, QueuedMessage } from "./askBuoyStore";
+/** `@react_buoy` prefix, so the Storage tool treats it as one of its own. */
+export declare const TRANSCRIPT_KEY: string;
+/**
+ * An approval the user never answered.
+ *
+ * Saved with the conversation because an unanswered question is exactly the
+ * state a reload must not quietly resolve for them: nothing was tapped, so the
+ * change is still pending as far as they know. `params` is the real call —
+ * after a restart there is no turn left to resume, so Allow re-dispatches it.
+ */
+export interface StoredApproval {
+    id: string;
+    toolId: string;
+    action: string;
+    label: string;
+    description?: string;
+    reason: string;
+    params: Record<string, unknown>;
+    /** A hash of the target at ask time, never the target. See PendingApproval. */
+    targetDigest?: string;
+}
+export interface StoredTranscript {
+    v: number;
+    savedAt: number;
+    /** What the user sees. */
+    messages: ChatMessage[];
+    /** What the model remembers. */
+    history: AgentMessage[];
+    answers: Record<string, unknown>;
+    usage: {
+        input: number;
+        output: number;
+        requests: number;
+    };
+    /** The card that was still on screen, if any. See StoredApproval. */
+    pending?: StoredApproval | null;
+    /**
+     * The effect ledger — what the agent changed, and how to put it back.
+     *
+     * Saved because it is the ONLY undo surface and it used to die with the JS
+     * context: the transcript came back after a reload with its "saved" lines
+     * and receipt cards intact, while the changes bar vanished and the changes
+     * stayed applied. Entries are plain data; the values inside them are the
+     * PRIOR state a revert needs (a storage key's old value, a rule id).
+     */
+    ledger?: LedgerEntry[];
+    /**
+     * Messages still parked when the app died. Come back as unsent rows the
+     * user can send, edit or drop — never auto-sent on relaunch.
+     */
+    queued?: QueuedMessage[];
+}
+/**
+ * Trim to the caps. Messages and history are trimmed together and from the
+ * same end, so what the user sees and what the model remembers stay the same
+ * conversation rather than drifting apart across restarts.
+ */
+export declare function fitToCaps(payload: StoredTranscript): StoredTranscript;
+export declare function buildPayload(input: {
+    messages: ChatMessage[];
+    history: AgentMessage[];
+    answers: Record<string, unknown>;
+    usage: {
+        input: number;
+        output: number;
+        requests: number;
+    };
+    pending?: PendingApproval | null;
+    ledger?: LedgerEntry[];
+    queued?: QueuedMessage[];
+}): StoredTranscript;
+/** Anything unparseable, or from an older shape, is treated as "no transcript". */
+export declare function parsePayload(raw: string | null): StoredTranscript | null;
+export declare function readTranscript(): Promise<StoredTranscript | null>;
+export declare function writeTranscript(payload: StoredTranscript): Promise<void>;
+export declare function clearTranscript(): Promise<void>;
+//# sourceMappingURL=transcriptPersistence.d.ts.map

package/lib/typescript/store/transcriptPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriptPersistence.d.ts","sourceRoot":"","sources":["../../../src/store/transcriptPersistence.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGlF,6EAA6E;AAC7E,eAAO,MAAM,cAAc,QAAoD,CAAC;AAyBhF;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,gCAAgC;IAChC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,qEAAqE;IACrE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAsDD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAgBrE;AA0ED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B,GAAG,gBAAgB,CAcnB;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,GAAG,IAAI,CAiCxE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAMvE;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9E;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAMrD"}

package/lib/typescript/store/transcriptPersistence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transcriptPersistence.test.d.ts.map

package/lib/typescript/store/transcriptPersistence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriptPersistence.test.d.ts","sourceRoot":"","sources":["../../../src/store/transcriptPersistence.test.ts"],"names":[],"mappings":""}

package/lib/typescript/store/turnRendering.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=turnRendering.test.d.ts.map

package/lib/typescript/store/turnRendering.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnRendering.test.d.ts","sourceRoot":"","sources":["../../../src/store/turnRendering.test.ts"],"names":[],"mappings":""}