@buoy-gg/ask-buoy 7.0.35 → 7.0.36

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

@@ -12,7 +12,16 @@ 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;
     /**
@@ -69,6 +78,31 @@ export interface ChatMessage {
     /** 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.
      *
@@ -87,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;
@@ -103,8 +178,13 @@ 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;
@@ -144,8 +224,22 @@ export declare const askBuoyStore: {
     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. */
@@ -161,9 +255,33 @@ 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.
      *
@@ -178,8 +296,27 @@ export declare const askBuoyStore: {
             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

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

@@ -1,7 +1,26 @@
-import type { AgentMessage } from "@buoy-gg/agent-core";
-import type { ChatMessage } from "./askBuoyStore";
+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;
@@ -15,6 +34,23 @@ export interface StoredTranscript {
         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
@@ -31,6 +67,9 @@ export declare function buildPayload(input: {
         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;

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

@@ -1 +1 @@
-{"version":3,"file":"transcriptPersistence.d.ts","sourceRoot":"","sources":["../../../src/store/transcriptPersistence.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,6EAA6E;AAC7E,eAAO,MAAM,cAAc,QAAoD,CAAC;AAkBhF,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;CAC5D;AAsDD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAgBrE;AAED,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;CAC5D,GAAG,gBAAgB,CASnB;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,GAAG,IAAI,CAiBxE;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"}
+{"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/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":""}

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

@@ -1,15 +1,35 @@
 import { type BlockAction, type BlockAnswer } from "@buoy-gg/agent-core";
 import { type AskBuoyState } from "./askBuoyStore";
+import { type ResetOutcome } from "./resetConversation";
 import type { AskBuoyConfig } from "../types";
 export declare function useAskBuoyState(): AskBuoyState;
 export interface AskBuoyController {
     state: AskBuoyState;
     send: (text: string) => void;
     stop: () => void;
+    /** Clear everything, unconditionally. See `undoThenReset` for the guarded path. */
     reset: () => void;
+    /**
+     * Undo what can be undone, then clear — or refuse and say what is still
+     * applied. The sheet's "Undo, then clear" and the desktop's reset both go
+     * through this; see resetConversation.ts for why there is only one path.
+     */
+    undoThenReset: () => Promise<ResetOutcome>;
     approve: (approved: boolean) => void;
-    /** Re-send the last user message after a failed turn. */
+    /**
+     * Run the last user message again after a failed or stopped turn.
+     *
+     * The failed bubble STAYS. It used to be removed first, and it can hold
+     * receipts for writes that really happened — two bag lines landed, the
+     * endpoint dropped on the third — so deleting it deleted the only record of
+     * them while the changes bar went on counting them. A new attempt gets a new
+     * bubble; the old one simply loses its Try-again button.
+     */
     retry: () => void;
+    /** Pull a parked message back into the composer to edit. */
+    editQueued: (id: string) => void;
+    /** Drop a parked message. */
+    removeQueued: (id: string) => void;
     /** Answer an Ask block: locks it and sends the answer as the next message. */
     answer: (answer: BlockAnswer) => void;
     /** Run a block button that dispatches a Buoy action or sends a message. */
@@ -17,6 +37,8 @@ export interface AskBuoyController {
     configured: boolean;
     /** How many Buoy tools the agent can reach on this device. */
     toolCount: number;
+    /** Which ones, for the empty state's chips. */
+    availableToolIds: string[];
 }
 export declare function useAskBuoy(config: AskBuoyConfig | undefined): AskBuoyController;
 //# sourceMappingURL=useAskBuoy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useAskBuoy.d.ts","sourceRoot":"","sources":["../../../src/store/useAskBuoy.ts"],"names":[],"mappings":"AAuBA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAOjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAO9C,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,yDAAyD;IACzD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,8EAA8E;IAC9E,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,2EAA2E;IAC3E,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,iBAAiB,CAuY/E"}
+{"version":3,"file":"useAskBuoy.d.ts","sourceRoot":"","sources":["../../../src/store/useAskBuoy.ts"],"names":[],"mappings":"AAuBA,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAIL,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA6D9C,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,mFAAmF;IACnF,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;;OAIG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,6BAA6B;IAC7B,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,8EAA8E;IAC9E,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,2EAA2E;IAC3E,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,iBAAiB,CAujB/E"}

package/lib/typescript/sync/askBuoySyncAdapter.d.ts

@@ -15,7 +15,7 @@ export declare const askBuoySyncAdapter: {
             toolCalls: {
                 toolId: string;
                 action: string;
-                status: "running" | "failed" | "ok" | "refused";
+                status: "running" | "failed" | "ok" | "refused" | "declined" | "stopped";
             }[];
         }[];
         usage: {
@@ -33,7 +33,7 @@ export declare const askBuoySyncAdapter: {
             permanent: number;
             transients: number;
             items: {
-                kind: "network-override" | "impersonation" | "storage-write" | "state-write" | "transient";
+                kind: "network-override" | "impersonation" | "storage-write" | "query-write" | "state-write" | "transient";
                 label: string;
             }[];
         };
@@ -46,7 +46,7 @@ export declare const askBuoySyncAdapter: {
             at: number;
             toolId: string;
             action: string;
-            kind: "network-override" | "impersonation" | "storage-write" | "state-write" | "transient";
+            kind: "network-override" | "impersonation" | "storage-write" | "query-write" | "state-write" | "transient";
             label: string;
             reversible: boolean;
         }[];
@@ -64,10 +64,30 @@ export declare const askBuoySyncAdapter: {
             ok: boolean;
             error?: undefined;
         }>;
-        /** Clear the transcript and the ledger. Does not undo anything. */
-        reset: () => {
+        /**
+         * Undo what can be undone, then clear the transcript and the ledger.
+         *
+         * The same path as the sheet's "New conversation" (resetConversation.ts).
+         * This action used to clear unconditionally — no question, no undo — so a
+         * desktop click could drop the only undo record for changes still live on
+         * the tester's phone. Now it refuses to clear when a revert fails and says
+         * what is still applied; the dashboard decides whether to clear anyway
+         * by calling `undoAll` first or accepting the kept conversation.
+         */
+        reset: () => Promise<{
             ok: boolean;
-        };
+            error: string;
+            failed: {
+                label: string;
+                error: string;
+            }[];
+            reverted?: undefined;
+        } | {
+            ok: boolean;
+            reverted: number;
+            error?: undefined;
+            failed?: undefined;
+        }>;
     };
 };
 //# sourceMappingURL=askBuoySyncAdapter.d.ts.map

package/lib/typescript/sync/askBuoySyncAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"askBuoySyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/askBuoySyncAdapter.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiDT,MAAM,IAAI;;QAU5B,8DAA8D;;;;;;;;;;QAgB9D,qEAAqE;;;;;;;;;;;;;;QAQrE,mEAAmE;;;;;CAMtE,CAAC"}
+{"version":3,"file":"askBuoySyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/askBuoySyncAdapter.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiDT,MAAM,IAAI;;QAU5B,8DAA8D;;;;;;;;;;QAgB9D,qEAAqE;;;;;;;;;;;;;;QAQrE;;;;;;;;;WASG;;;;;;;;;;;;;;;;CAaN,CAAC"}