@buoy-gg/ask-buoy 7.0.35 → 7.0.38

package/lib/module/store/askBuoyStore.js

@@ -1,361 +1 @@
-"use strict";
-
-/**
- * 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.
- *
- * Persisted across restarts, on purpose, with the payloads left out — see
- * `transcriptPersistence.ts` for what is written and what that costs. The
- * store itself stays a plain in-memory store; saving is a subscriber, and
- * `hydrate` is the one way anything comes back in.
- */
-import { idFactory } from "@buoy-gg/agent-core";
-
-/** A block in a message, and (for receipts) the tool call that produced it. */
-
-/**
- * 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.
- */
-
-/**
- * Message ids carry this run's token — see agent-core's `runId`. A plain `m1`
- * collided head-on with the `m1` in a restored transcript, and the message
- * list keys on it.
- */
-const nextId = idFactory("m");
-
-/**
- * Params, as one readable line. Capped because a step can carry a whole
- * response body or a store's full state, and this is chrome inside a chat
- * bubble — the full value is a tool read away.
- */
-const MAX_PARAM_CHARS = 400;
-function encodeParams(params) {
-  if (!params || Object.keys(params).length === 0) return undefined;
-  try {
-    const json = JSON.stringify(params);
-    return json.length > MAX_PARAM_CHARS ? `${json.slice(0, MAX_PARAM_CHARS)}…` : json;
-  } catch {
-    return undefined;
-  }
-}
-let state = {
-  messages: [],
-  busy: false,
-  pending: null,
-  notice: null,
-  configured: false,
-  answers: {},
-  awaitingBlockId: null,
-  actionState: {},
-  queued: null,
-  usage: {
-    input: 0,
-    output: 0,
-    requests: 0
-  },
-  meta: {}
-};
-const listeners = new Set();
-let ledgerRef = null;
-
-/**
- * The session outlives the sheet the same way the transcript does. Session and
- * ledger used to be per-mount: closing and reopening the tool kept the visible
- * conversation but silently swapped in an empty ledger and a blank model
- * memory — the undo bar vanished while the agent's changes stayed live in the
- * app. Held here, keyed by a config signature so a real reconfiguration
- * (different endpoint/model/tool set) still rebuilds.
- */
-let heldSession = null;
-function set(next) {
-  state = {
-    ...state,
-    ...next
-  };
-  for (const fn of listeners) {
-    try {
-      fn();
-    } catch {
-      // A throwing subscriber must not take the transcript down mid-answer.
-    }
-  }
-}
-export const askBuoyStore = {
-  getState: () => state,
-  subscribe(fn) {
-    listeners.add(fn);
-    return () => listeners.delete(fn);
-  },
-  setLedger(ledger) {
-    ledgerRef = ledger;
-  },
-  getLedger() {
-    return ledgerRef;
-  },
-  holdSession(session, signature) {
-    heldSession = {
-      session,
-      signature
-    };
-  },
-  getHeldSession() {
-    return heldSession;
-  },
-  setNotice(notice) {
-    set({
-      notice
-    });
-  },
-  setConfigured(configured) {
-    if (configured !== state.configured) set({
-      configured
-    });
-  },
-  setMeta(meta) {
-    const same = Object.keys(meta).every(k => state.meta[k] === meta[k]);
-    if (!same) set({
-      meta: {
-        ...state.meta,
-        ...meta
-      }
-    });
-  },
-  addUser(text) {
-    set({
-      messages: [...state.messages, {
-        id: nextId(),
-        role: "user",
-        text,
-        toolCalls: [],
-        blocks: []
-      }],
-      busy: true
-    });
-  },
-  /** Mark a turn as running without adding a bubble — the retry path. */
-  beginTurn() {
-    set({
-      busy: true
-    });
-  },
-  /** Park a message typed mid-turn instead of silently dropping it. */
-  setQueued(text) {
-    set({
-      queued: text
-    });
-  },
-  /** Drop one message — the failed assistant bubble a retry replaces. */
-  removeMessage(id) {
-    set({
-      messages: state.messages.filter(m => m.id !== id)
-    });
-  },
-  /** The user answered (or skipped) an Ask block. */
-  recordAnswer(answer) {
-    set({
-      answers: {
-        ...state.answers,
-        [answer.blockId]: answer
-      },
-      awaitingBlockId: state.awaitingBlockId === answer.blockId ? null : state.awaitingBlockId
-    });
-  },
-  setActionState(key, value) {
-    const next = {
-      ...state.actionState
-    };
-    if (value === null) delete next[key];else next[key] = value;
-    set({
-      actionState: next
-    });
-  },
-  /** Open a new assistant bubble for the turn that is about to stream. */
-  startAssistant() {
-    const id = nextId();
-    set({
-      messages: [...state.messages, {
-        id,
-        role: "assistant",
-        text: "",
-        toolCalls: [],
-        blocks: [],
-        streaming: true,
-        startedAt: Date.now()
-      }]
-    });
-    return id;
-  },
-  /**
-   * Fold one engine event into the open assistant message.
-   *
-   * Tool calls render as rows inside the bubble rather than as raw payloads:
-   * the label is already domain-flavoured ("Set points to 1500"), which is the
-   * only form a non-developer can actually check.
-   */
-  applyEvent(messageId, ev) {
-    const messages = state.messages.map(m => {
-      if (m.id !== messageId) return m;
-      switch (ev.type) {
-        case "text":
-          return {
-            ...m,
-            text: m.breakBeforeNextText && m.text ? `${m.text.trimEnd()}\n\n${ev.delta}` : m.text + ev.delta,
-            breakBeforeNextText: false
-          };
-        case "reasoning":
-          return {
-            ...m,
-            breakBeforeNextText: true,
-            reasoning: [...(m.reasoning ?? []), {
-              text: ev.text,
-              afterCalls: m.toolCalls.length
-            }]
-          };
-        case "tool-start":
-          return {
-            ...m,
-            toolCalls: [...m.toolCalls, {
-              id: ev.id,
-              toolId: ev.toolId,
-              action: ev.action,
-              label: ev.label,
-              description: ev.description,
-              status: "running",
-              params: encodeParams(ev.params),
-              effect: ev.effect,
-              startedAt: Date.now()
-            }]
-          };
-        case "tool-end":
-          return {
-            ...m,
-            breakBeforeNextText: true,
-            toolCalls: m.toolCalls.map(c => c.id === ev.id ? {
-              ...c,
-              status: !ev.ok && ev.summary === "refused" ? "refused" : ev.ok ? "ok" : "failed",
-              summary: ev.summary,
-              durationMs: ev.durationMs,
-              result: ev.result
-            } : c)
-          };
-        case "block":
-          return {
-            ...m,
-            breakBeforeNextText: true,
-            blocks: [...m.blocks, {
-              block: ev.block,
-              forToolCallId: ev.forToolCallId
-            }]
-          };
-        case "usage":
-          // Also folded into the session total below. Per MESSAGE as well,
-          // because "which answer cost 40k tokens" is the question you ask
-          // when a bill looks wrong, and a session total cannot answer it.
-          return {
-            ...m,
-            usage: {
-              input: (m.usage?.input ?? 0) + ev.input,
-              output: (m.usage?.output ?? 0) + ev.output,
-              requests: (m.usage?.requests ?? 0) + 1
-            }
-          };
-        case "error":
-          return {
-            ...m,
-            error: ev.message
-          };
-        default:
-          return m;
-      }
-    });
-    set({
-      messages,
-      ...(ev.type === "awaiting-user" ? {
-        awaitingBlockId: ev.blockId
-      } : {}),
-      ...(ev.type === "usage" ? {
-        usage: {
-          input: state.usage.input + ev.input,
-          output: state.usage.output + ev.output,
-          requests: state.usage.requests + 1
-        }
-      } : {})
-    });
-  },
-  finishAssistant(messageId) {
-    set({
-      messages: state.messages.map(m => m.id === messageId ? {
-        ...m,
-        streaming: false,
-        endedAt: Date.now()
-      } : m),
-      busy: false
-    });
-  },
-  askApproval(input) {
-    return new Promise(resolve => {
-      set({
-        pending: {
-          ...input,
-          resolve
-        }
-      });
-    });
-  },
-  answerApproval(approved) {
-    const pending = state.pending;
-    set({
-      pending: null
-    });
-    pending?.resolve(approved);
-  },
-  /**
-   * 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) {
-    if (state.messages.length > 0 || state.busy) return false;
-    set({
-      messages: input.messages,
-      answers: input.answers,
-      usage: input.usage
-    });
-    return true;
-  },
-  reset() {
-    // Reject anything still waiting, or the turn hangs forever on a promise
-    // whose only resolver just left the screen.
-    state.pending?.resolve(false);
-    set({
-      messages: [],
-      busy: false,
-      pending: null,
-      notice: null,
-      answers: {},
-      awaitingBlockId: null,
-      actionState: {},
-      queued: null,
-      usage: {
-        input: 0,
-        output: 0,
-        requests: 0
-      }
-      // `meta` survives: it describes the app and the endpoint, not the
-      // conversation, and re-deriving it would need another render pass.
-    });
-  }
-};
-//# sourceMappingURL=askBuoyStore.js.map
+"use strict";import{idFactory}from"@buoy-gg/agent-core";const nextId=idFactory("m"),MAX_PARAM_CHARS=400;function encodeParams(e){if(e&&0!==Object.keys(e).length)try{const t=JSON.stringify(e);return t.length>400?`${t.slice(0,400)}…`:t}catch{return}}const nextQueuedId=idFactory("q");let state={messages:[],busy:!1,stopping:!1,pending:null,trusted:[],notice:null,configured:!1,answers:{},awaitingBlockId:null,actionState:{},queued:[],draft:null,usage:{input:0,output:0,requests:0},meta:{}};const listeners=new Set;let ledgerRef=null,heldSession=null;function set(e){state={...state,...e};for(const e of listeners)try{e()}catch{}}export const askBuoyStore={getState:()=>state,subscribe:e=>(listeners.add(e),()=>listeners.delete(e)),setLedger(e){ledgerRef=e},getLedger:()=>ledgerRef,holdSession(e,t){heldSession={session:e,signature:t}},getHeldSession:()=>heldSession,setNotice(e){set({notice:e})},setConfigured(e){e!==state.configured&&set({configured:e})},setMeta(e){Object.keys(e).every(t=>state.meta[t]===e[t])||set({meta:{...state.meta,...e}})},addUser(e){set({messages:[...state.messages,{id:nextId(),role:"user",text:e,toolCalls:[],blocks:[]}],busy:!0})},beginTurn(){set({busy:!0})},enqueue(e){const t={id:nextQueuedId(),text:e};return set({queued:[...state.queued,t]}),t},removeQueued(e){state.queued.some(t=>t.id===e)&&set({queued:state.queued.filter(t=>t.id!==e)})},shiftQueued(){const[e,...t]=state.queued;if(e)return set({queued:t}),e},takeQueuedToDraft(e){const t=state.queued.find(t=>t.id===e);t&&set({queued:state.queued.filter(t=>t.id!==e),draft:t.text})},requestStop(){state.busy&&!state.stopping&&set({stopping:!0})},clearDraft(){null!==state.draft&&set({draft:null})},removeMessage(e){set({messages:state.messages.filter(t=>t.id!==e)})},recordAnswer(e){set({answers:{...state.answers,[e.blockId]:e},awaitingBlockId:state.awaitingBlockId===e.blockId?null:state.awaitingBlockId})},setActionState(e,t){const s={...state.actionState};null===t?delete s[e]:s[e]=t,set({actionState:s})},startAssistant(){const e=nextId();return set({messages:[...state.messages,{id:e,role:"assistant",text:"",toolCalls:[],blocks:[],streaming:!0,startedAt:Date.now()}]}),e},applyEvent(e,t){if("history-trimmed"===t.type){const s=state.messages.findIndex(t=>t.id===e),a={id:nextId(),role:"assistant",system:!0,text:`Older messages were trimmed from the agent's memory (${t.droppedRounds} exchange${1===t.droppedRounds?"":"s"}).`+(t.droppedPinned?` ${1===t.droppedPinned?"One of them made a change that is":`${t.droppedPinned} of them made changes that are`} still applied — the changes bar still lists ${1===t.droppedPinned?"it":"them"}, but the agent no longer remembers making ${1===t.droppedPinned?"it":"them"}.`:" It may not recall setup from earlier in this chat — the changes bar still lists what is applied."),toolCalls:[],blocks:[],endedAt:Date.now()},n=[...state.messages];return n.splice(s<0?n.length:s,0,a),void set({messages:n})}set({messages:state.messages.map(s=>{if(s.id!==e)return s;switch(t.type){case"retrying":{const e=Math.max(1,Math.round(t.inMs/1e3));return{...s,waiting:"throttled"===t.reason?`Endpoint busy — retrying in ${e}s (${t.attempt} of ${t.maxAttempts})`:"Request too large — trimming older messages and retrying"}}case"text":return{...s,waiting:void 0,text:(s.breakBeforeNextText||t.breakBefore)&&s.text?`${s.text.trimEnd()}\n\n${t.delta}`:s.text+t.delta,breakBeforeNextText:!1};case"reasoning":return{...s,breakBeforeNextText:!0,reasoning:[...s.reasoning??[],{text:t.text,afterCalls:s.toolCalls.length}]};case"tool-start":return{...s,waiting:void 0,toolCalls:[...s.toolCalls,{id:t.id,toolId:t.toolId,action:t.action,label:t.label,description:t.description,status:"running",params:encodeParams(t.params),effect:t.effect,startedAt:Date.now()}]};case"tool-end":return{...s,breakBeforeNextText:!0,toolCalls:s.toolCalls.map(e=>e.id===t.id?{...e,status:t.ok||"refused"!==t.summary?t.ok||"declined"!==t.summary?t.ok||"stopped"!==t.summary?t.ok?"ok":"failed":"stopped":"declined":"refused",summary:t.summary,durationMs:t.durationMs,result:t.result}:e)};case"tool-verified":return{...s,toolCalls:s.toolCalls.map(e=>e.id===t.id?{...e,verification:t.verification}:e)};case"block":return{...s,breakBeforeNextText:!0,blocks:[...s.blocks,{block:t.block,forToolCallId:t.forToolCallId}]};case"usage":return{...s,usage:{input:(s.usage?.input??0)+t.input,output:(s.usage?.output??0)+t.output,requests:(s.usage?.requests??0)+1}};case"error":return{...s,waiting:void 0,error:t.message};default:return s}}),..."awaiting-user"===t.type?{awaitingBlockId:t.blockId}:{},..."usage"===t.type?{usage:{input:state.usage.input+t.input,output:state.usage.output+t.output,requests:state.usage.requests+1}}:{}})},markStopped(e){set({messages:state.messages.map(t=>t.id===e?{...t,stopped:!0}:t)})},finishAssistant(e){set({messages:state.messages.map(t=>t.id===e?{...t,streaming:!1,endedAt:Date.now()}:t),busy:!1,stopping:!1})},askApproval:e=>new Promise(t=>{set({pending:{...e,resolve:t}})}),answerApproval(e){const t=state.pending,s="boolean"==typeof e?e:e.approved,a="boolean"!=typeof e&&!0===e.trust&&s,n=t?`${t.toolId}.${t.action}`:"";set({pending:null,...a&&t&&!state.trusted.some(e=>e.key===n)?{trusted:[...state.trusted,{key:n,label:t.label}]}:{}}),t?.resolve(e)},untrust(e){heldSession?.session.untrust(e),set({trusted:state.trusted.filter(t=>t.key!==e)})},restorePending:e=>!state.pending&&!state.busy&&(set({pending:{...e,restored:!0,resolve:()=>{}}}),!0),addNote(e){set({messages:[...state.messages,{id:nextId(),role:"assistant",text:e,toolCalls:[],blocks:[],endedAt:Date.now()}]})},hydrate:e=>!(state.messages.length>0||state.busy||(set({messages:e.messages.map(e=>({...e,restored:!0})),answers:e.answers,usage:e.usage,queued:e.queued??[]}),0)),reset(){state.pending?.resolve(!1),set({messages:[],busy:!1,stopping:!1,pending:null,trusted:[],notice:null,answers:{},awaitingBlockId:null,actionState:{},queued:[],draft:null,usage:{input:0,output:0,requests:0}})}};export function turnPhaseOf(e){return e.pending?"awaitingApproval":e.busy?e.stopping?"stopping":"running":e.awaitingBlockId?"awaitingAnswer":"idle"}export function queuePauseReason(e){const t=turnPhaseOf(e);if("running"===t||"stopping"===t)return null;if("awaitingApproval"===t)return"Paused — answer the approval above first.";if("awaitingAnswer"===t)return"Paused — answer the question above first.";const s=e.messages[e.messages.length-1];return"assistant"===s?.role&&s.error?"Paused — the last turn failed.":"assistant"===s?.role&&s.stopped?"Paused — you stopped the last turn.":null}

package/lib/module/store/blockPlacement.js

@@ -0,0 +1 @@
+"use strict";import{isAskBlock}from"@buoy-gg/agent-core";function nestsUnderStep({block:o,forToolCallId:e}){if(!e)return!1;const s="source"in o?o.source:void 0;return"live"===s||"mocked"===s}export function placeBlocks(o,e){const s=new Set(e),t=new Map,l=[],r=[];for(const e of o)if(isAskBlock(e.block))r.push(e);else if(nestsUnderStep(e)&&s.has(e.forToolCallId)){const o=t.get(e.forToolCallId)??[];o.push(e.block),t.set(e.forToolCallId,o)}else l.push(e);return{nested:t,afterText:l,ask:r}}

package/lib/module/store/blockPlacement.test.js

@@ -0,0 +1 @@
+"use strict";import{describe,expect,it}from"vitest";import{placeBlocks}from"./blockPlacement";const placed=(e,t)=>({block:e,forToolCallId:t}),grid=(e="ui1")=>placed({id:e,kind:"imageGrid",source:"model",images:[{url:"https://cdn.example.com/25.png",alt:"Pikachu"}]},"call-ui");describe("model-authored blocks",()=>{it("renders in the answer, never nested under a step that has no row",()=>{const{afterText:e,nested:t}=placeBlocks([grid()],["c1"]);expect(e.map(e=>e.block.id)).toEqual(["ui1"]),expect(t.size).toBe(0)}),it("still renders even when a step with that id somehow exists",()=>{const{afterText:e}=placeBlocks([grid()],["call-ui"]);expect(e.map(e=>e.block.id)).toEqual(["ui1"])})}),describe("receipts",()=>{it("folds a read receipt into its own step row",()=>{const e=placed({id:"r1",kind:"keyValue",source:"live",pairs:[]},"c1"),{nested:t,afterText:c}=placeBlocks([e],["c1"]);expect(c).toEqual([]),expect(t.get("c1")?.map(e=>e.id)).toEqual(["r1"])}),it("keeps a write receipt afterText — the user must see it without asking",()=>{const e=placed({id:"w1",kind:"diff",source:"changed",changes:[]},"c1"),{nested:t,afterText:c}=placeBlocks([e],["c1"]);expect(t.size).toBe(0),expect(c.map(e=>e.block.id)).toEqual(["w1"])}),it("falls back to afterText when its step row was never drawn",()=>{const e=placed({id:"r2",kind:"keyValue",source:"live",pairs:[]},"gone"),{afterText:t}=placeBlocks([e],[]);expect(t.map(e=>e.block.id)).toEqual(["r2"])})}),describe("ask blocks",()=>{it("come out in their own bucket, after the answer",()=>{const e=placed({id:"a1",kind:"confirm",source:"model",change:"Wipe storage"},"call-ui"),{ask:t,afterText:c,nested:a}=placeBlocks([e,grid("ui2")],["c1"]);expect(t.map(e=>e.block.id)).toEqual(["a1"]),expect(c.map(e=>e.block.id)).toEqual(["ui2"]),expect(a.size).toBe(0)})}),describe("the answer comes after the prose",()=>{it("puts a model-authored card in the after-text bucket, never before it",()=>{const e=placeBlocks([grid()],["c1"]);expect(e.afterText.map(e=>e.block.id)).toEqual(["ui1"]),expect(e.nested.size).toBe(0)})});

package/lib/module/store/queue.test.js

@@ -0,0 +1 @@
+"use strict";import{beforeEach,describe,expect,it}from"vitest";import{askBuoyStore,queuePauseReason,turnPhaseOf}from"./askBuoyStore";beforeEach(()=>askBuoyStore.reset());const texts=()=>askBuoyStore.getState().queued.map(e=>e.text);describe("queue",()=>{it("keeps every message, in the order typed",()=>{askBuoyStore.enqueue("then set points to 1500"),askBuoyStore.enqueue("and clear the cart after"),expect(texts()).toEqual(["then set points to 1500","and clear the cart after"])}),it("gives identical requests distinct ids",()=>{const e=askBuoyStore.enqueue("again"),t=askBuoyStore.enqueue("again");expect(e.id).not.toBe(t.id),askBuoyStore.removeQueued(e.id),expect(texts()).toEqual(["again"])}),it("delivers from the front, one at a time",()=>{askBuoyStore.enqueue("one"),askBuoyStore.enqueue("two"),expect(askBuoyStore.shiftQueued()?.text).toBe("one"),expect(texts()).toEqual(["two"]),expect(askBuoyStore.shiftQueued()?.text).toBe("two"),expect(askBuoyStore.shiftQueued()).toBeUndefined()}),it("comes back from disk as unsent rows",()=>{const e=askBuoyStore.hydrate({messages:[{id:"m1",role:"user",text:"hi",toolCalls:[],blocks:[]}],answers:{},usage:{input:0,output:0,requests:0},queued:[{id:"q1",text:"still waiting"}]});expect(e).toBe(!0),expect(texts()).toEqual(["still waiting"]),expect(turnPhaseOf(askBuoyStore.getState())).toBe("idle")}),it("is emptied by a new conversation",()=>{askBuoyStore.enqueue("gone"),askBuoyStore.reset(),expect(texts()).toEqual([])})}),describe("turnPhase",()=>{it("is idle with nothing going on",()=>{expect(turnPhaseOf(askBuoyStore.getState())).toBe("idle")}),it("is running during a turn, and stopping once Stop is pressed",()=>{askBuoyStore.addUser("go"),askBuoyStore.startAssistant(),expect(turnPhaseOf(askBuoyStore.getState())).toBe("running"),askBuoyStore.requestStop(),expect(turnPhaseOf(askBuoyStore.getState())).toBe("stopping")}),it("is awaitingApproval while a card is up, even though the turn is busy",()=>{askBuoyStore.addUser("wipe it"),askBuoyStore.startAssistant(),askBuoyStore.askApproval({id:"c1",toolId:"storage",action:"clearAll",label:"Clear all saved app data",reason:"Wipes everything"}),expect(turnPhaseOf(askBuoyStore.getState())).toBe("awaitingApproval")}),it("is awaitingAnswer after a turn ends on an Ask block",()=>{const e=askBuoyStore.startAssistant();askBuoyStore.applyEvent(e,{type:"awaiting-user",blockId:"b1"}),askBuoyStore.finishAssistant(e),expect(turnPhaseOf(askBuoyStore.getState())).toBe("awaitingAnswer")})}),describe("when the queue holds",()=>{it("delivers when idle and the last turn was fine",()=>{askBuoyStore.addUser("hi");const e=askBuoyStore.startAssistant();askBuoyStore.applyEvent(e,{type:"text",delta:"Hello."}),askBuoyStore.finishAssistant(e),expect(queuePauseReason(askBuoyStore.getState())).toBeNull()}),it("holds after an error, and says so",()=>{askBuoyStore.addUser("hi");const e=askBuoyStore.startAssistant();askBuoyStore.applyEvent(e,{type:"error",message:"fetch failed"}),askBuoyStore.finishAssistant(e),expect(queuePauseReason(askBuoyStore.getState())).toMatch(/failed/)}),it("holds while an approval card is up",()=>{askBuoyStore.addUser("wipe"),askBuoyStore.startAssistant(),askBuoyStore.askApproval({id:"c1",toolId:"storage",action:"clearAll",label:"Clear all saved app data",reason:"Wipes everything"}),expect(queuePauseReason(askBuoyStore.getState())).toMatch(/approval/)}),it("holds while a question is unanswered — a queued task is not the answer",()=>{const e=askBuoyStore.startAssistant();askBuoyStore.applyEvent(e,{type:"awaiting-user",blockId:"b1"}),askBuoyStore.finishAssistant(e),expect(queuePauseReason(askBuoyStore.getState())).toMatch(/question/)}),it("says nothing while a turn is still running — the queue is simply waiting",()=>{askBuoyStore.addUser("go"),askBuoyStore.startAssistant(),expect(queuePauseReason(askBuoyStore.getState())).toBeNull()})});

package/lib/module/store/resetConversation.js

@@ -0,0 +1 @@
+"use strict";import{askBuoyStore}from"./askBuoyStore";import{clearTranscript}from"./transcriptPersistence";export function clearConversation(){askBuoyStore.getHeldSession()?.session.reset(),askBuoyStore.reset(),clearTranscript()}export async function resetConversation(e){if(askBuoyStore.getState().busy)return{cleared:!1,reverted:0,failed:[{label:"A turn is running",error:"Stop it first."}]};const r=askBuoyStore.getLedger();if(e.undoFirst&&r){const t=await r.revertAll(e.dispatch);return t.failed.length>0?{cleared:!1,reverted:t.reverted,failed:t.failed}:(clearConversation(),{cleared:!0,reverted:t.reverted,failed:[]})}return clearConversation(),{cleared:!0,reverted:0,failed:[]}}

package/lib/module/store/restorePending.test.js

@@ -0,0 +1 @@
+"use strict";import{beforeEach,describe,expect,it}from"vitest";import{askBuoyStore}from"./askBuoyStore";const card={id:"c1",toolId:"zustand",action:"setState",label:"Update the Poké Mart bag store",reason:"This will change the app's state.",params:{storeName:"bag"}};beforeEach(()=>askBuoyStore.reset()),describe("restorePending",()=>{it("puts the card back on screen",()=>{expect(askBuoyStore.restorePending(card)).toBe(!0),expect(askBuoyStore.getState().pending).toMatchObject({toolId:"zustand",action:"setState",params:{storeName:"bag"}})}),it("marks it restored, so Allow runs the call instead of answering a dead promise",()=>{askBuoyStore.restorePending(card),expect(askBuoyStore.getState().pending?.restored).toBe(!0)}),it("refuses once a turn is under way",()=>{askBuoyStore.beginTurn(),expect(askBuoyStore.restorePending(card)).toBe(!1),expect(askBuoyStore.getState().pending).toBeNull()}),it("refuses when a live card is already asking",()=>{askBuoyStore.askApproval(card),expect(askBuoyStore.restorePending({...card,id:"c2"})).toBe(!1),expect(askBuoyStore.getState().pending?.id).toBe("c1")}),it("answers without throwing, though nothing is waiting on it",()=>{askBuoyStore.restorePending(card),expect(()=>askBuoyStore.answerApproval(!0)).not.toThrow(),expect(askBuoyStore.getState().pending).toBeNull()})});

package/lib/module/store/restoredIds.test.js

@@ -1,46 +1 @@
-"use strict";
-
-/**
- * Ids from a RESTORED transcript must never collide with a fresh run's.
- *
- * The bug this covers, in full: every id counter restarted at 1 with the
- * process, which was harmless until the transcript started outliving a reload.
- * A restored conversation came back holding `rc1`, `ui1` and `m1`; the next
- * turn minted `rc1` again; React saw two children with one key and rendered
- * one of them twice while dropping the other. On screen that was the same
- * store card appearing twice after a reload.
- *
- * Simulating a restart in one process is the whole difficulty — the module
- * caches its counter. `idFactory` is the seam: a second factory stands in for
- * the second run, and the shared RUN_ID is what has to differ between them.
- */
-import { describe, expect, it } from "vitest";
-import { idFactory, RUN_ID } from "@buoy-gg/agent-core";
-describe("ids across a restart", () => {
-  it("never reissues an id a restored transcript already holds", () => {
-    // What a saved transcript carries, from a previous launch.
-    const restored = ["rcOLDRUN-1", "rcOLDRUN-2", "uiOLDRUN-1", "mOLDRUN-1"];
-    const rc = idFactory("rc");
-    const ui = idFactory("ui");
-    const m = idFactory("m");
-    const fresh = [rc(), rc(), ui(), m()];
-    for (const id of fresh) expect(restored).not.toContain(id);
-  });
-  it("still counts up within one run", () => {
-    // The counter is what keeps two blocks in the SAME turn apart.
-    const rc = idFactory("rc");
-    const ids = [rc(), rc(), rc()];
-    expect(new Set(ids).size).toBe(3);
-  });
-  it("keeps two prefixes apart even at the same count", () => {
-    const rc = idFactory("rc");
-    const ui = idFactory("ui");
-    expect(rc()).not.toBe(ui());
-  });
-  it("stamps a run token that is not a fixed string", () => {
-    // A constant here would put every install back where it started.
-    expect(RUN_ID).toMatch(/^[a-z0-9]{4,8}$/);
-    expect(idFactory("rc")()).toBe(`rc${RUN_ID}-1`);
-  });
-});
-//# sourceMappingURL=restoredIds.test.js.map
+"use strict";import{describe,expect,it}from"vitest";import{idFactory,RUN_ID}from"@buoy-gg/agent-core";describe("ids across a restart",()=>{it("never reissues an id a restored transcript already holds",()=>{const t=["rcOLDRUN-1","rcOLDRUN-2","uiOLDRUN-1","mOLDRUN-1"],e=idFactory("rc"),r=idFactory("ui"),o=idFactory("m"),i=[e(),e(),r(),o()];for(const e of i)expect(t).not.toContain(e)}),it("still counts up within one run",()=>{const t=idFactory("rc"),e=[t(),t(),t()];expect(new Set(e).size).toBe(3)}),it("keeps two prefixes apart even at the same count",()=>{const t=idFactory("rc"),e=idFactory("ui");expect(t()).not.toBe(e())}),it("stamps a run token that is not a fixed string",()=>{expect(RUN_ID).toMatch(/^[a-z0-9]{4,8}$/),expect(idFactory("rc")()).toBe(`rc${RUN_ID}-1`)})});

package/lib/module/store/suggestions.js

@@ -0,0 +1 @@
+"use strict";export const SUGGESTIONS=[{text:"Why is this screen empty?"},{text:"What did the last few network calls return?",needs:"network"},{text:"Show me what's saved for this user",needs:"storage"},{text:"Make the next request to this screen fail with a 500",needs:"network",write:!0,devOnly:!0},{text:"Who am I signed in as right now?"},{text:"Did anything crash or log an error recently?",needs:"console"}];export const MAX_SUGGESTIONS=4;export function pickSuggestions(e){const t=e.availableToolIds.length>0;return SUGGESTIONS.filter(s=>(!s.write||!e.readOnly)&&(!s.devOnly||!e.isRelease)&&(!s.needs||t&&e.availableToolIds.includes(s.needs))).slice(0,4).map(e=>e.text)}

package/lib/module/store/suggestions.test.js

@@ -0,0 +1 @@
+"use strict";import{describe,expect,it}from"vitest";import{MAX_SUGGESTIONS,pickSuggestions}from"./suggestions";const all=["network","storage","console","query"];describe("pickSuggestions",()=>{it("offers the simulation only on a dev build that may write",()=>{const e=pickSuggestions({availableToolIds:all,readOnly:!1,isRelease:!1});expect(e).toContain("Make the next request to this screen fail with a 500");const t=pickSuggestions({availableToolIds:all,readOnly:!1,isRelease:!0});expect(t).not.toContain("Make the next request to this screen fail with a 500");const s=pickSuggestions({availableToolIds:all,readOnly:!0,isRelease:!1});expect(s).not.toContain("Make the next request to this screen fail with a 500")}),it("drops chips whose tool is not on this device",()=>{const e=pickSuggestions({availableToolIds:["storage"],readOnly:!1,isRelease:!1});expect(e).not.toContain("What did the last few network calls return?"),expect(e).toContain("Show me what's saved for this user")}),it("shows only tool-free chips until the registry has reported",()=>{const e=pickSuggestions({availableToolIds:[],readOnly:!1,isRelease:!1});expect(e).toEqual(["Why is this screen empty?","Who am I signed in as right now?"])}),it("never exceeds the cap and keeps the order",()=>{const e=pickSuggestions({availableToolIds:all,readOnly:!1,isRelease:!1});expect(e.length).toBeLessThanOrEqual(MAX_SUGGESTIONS),expect(e[0]).toBe("Why is this screen empty?")})});

package/lib/module/store/systemLine.test.js

@@ -0,0 +1 @@
+"use strict";import{beforeEach,describe,expect,it}from"vitest";import{askBuoyStore}from"./askBuoyStore";import{buildPayload,parsePayload}from"./transcriptPersistence";beforeEach(()=>askBuoyStore.reset()),describe("history-trimmed",()=>{it("inserts a system line before the answer it affects",()=>{askBuoyStore.addUser("turn off that override");const t=askBuoyStore.startAssistant();askBuoyStore.applyEvent(t,{type:"history-trimmed",droppedRounds:3}),askBuoyStore.applyEvent(t,{type:"text",delta:"Turning it off."});const e=askBuoyStore.getState().messages.map(t=>t.system?"system":t.role);expect(e).toEqual(["user","system","assistant"]);const s=askBuoyStore.getState().messages[1];expect(s.text).toMatch(/3 exchanges/),expect(s.text).toMatch(/changes bar still lists/)}),it("singular for one round",()=>{const t=askBuoyStore.startAssistant();askBuoyStore.applyEvent(t,{type:"history-trimmed",droppedRounds:1}),expect(askBuoyStore.getState().messages[0].text).toMatch(/1 exchange\)/)})}),describe("restored approval freshness",()=>{it("carries the target digest to disk and back, never the target",()=>{const t=buildPayload({messages:[{id:"m1",role:"user",text:"set it",toolCalls:[],blocks:[]}],history:[],answers:{},usage:{input:0,output:0,requests:0},pending:{id:"c1",toolId:"zustand",action:"setState",label:"Update the bag store",reason:"Replaces part of the store",params:{storeName:"bag",state:{qty:14}},targetDigest:"1a2b3c:512",resolve:()=>{}}}),e=JSON.stringify(t);expect(e).toContain("1a2b3c:512");const s=parsePayload(e);expect(s?.pending?.targetDigest).toBe("1a2b3c:512")})});

package/lib/module/store/ticketPrompt.js

@@ -0,0 +1 @@
+"use strict";export const TICKET_PROMPT="Summarize this conversation as a bug ticket, using one buoy_ui finding block and nothing else. Title it with the problem in one line. Evidence rows, in this order: Steps (what we did), Expected, Observed, Build (dev or release, platform), Evidence (the exact requests, statuses, logs or values you actually saw this conversation), Still applied (overrides or changes from your changes list that are still live, or 'none'). Only facts you observed in this conversation; write 'unknown' where you don't know rather than guessing, and put anything you inferred rather than saw in a final row labelled Inference. Do not run any tool or change anything to produce this.";

package/lib/module/store/traceText.js

@@ -1,75 +1 @@
-"use strict";
-
-/**
- * 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.
- */
-
-export function traceEntries(message) {
-  const thoughts = [...(message.reasoning ?? [])].sort((a, b) => a.afterCalls - b.afterCalls);
-  const out = [];
-  let t = 0;
-  const drainTo = calls => {
-    while (t < thoughts.length && thoughts[t].afterCalls <= calls) {
-      out.push({
-        kind: "thought",
-        text: thoughts[t].text
-      });
-      t += 1;
-    }
-  };
-  message.toolCalls.forEach((call, i) => {
-    drainTo(i);
-    out.push({
-      kind: "step",
-      n: i + 1,
-      call
-    });
-  });
-  // Anything the model thought after its last tool call — usually the reasoning
-  // behind the answer itself, which is the most useful line in the trace.
-  drainTo(message.toolCalls.length);
-  return out;
-}
-
-/** Has this message anything to show? Drives whether the strip renders at all. */
-export function hasTrace(message) {
-  return (message.reasoning?.length ?? 0) > 0 || message.toolCalls.length > 0;
-}
-const statusWord = call => call.status === "ok" ? call.summary || "done" : call.status === "running" ? "running" : `${call.status}${call.summary ? ` — ${call.summary}` : ""}`;
-
-/**
- * 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 function traceToText(message, indent = "  ") {
-  const lines = [];
-  for (const entry of traceEntries(message)) {
-    if (entry.kind === "thought") {
-      lines.push(`${indent}[thinking]`);
-      for (const line of entry.text.trim().split("\n")) {
-        lines.push(`${indent}  ${line}`);
-      }
-    } else {
-      const {
-        n,
-        call
-      } = entry;
-      lines.push(`${indent}[${n}] ${call.toolId}.${call.action} — ${statusWord(call)}`);
-      if (call.params) lines.push(`${indent}    ${call.params}`);
-    }
-  }
-  return lines;
-}
-//# sourceMappingURL=traceText.js.map
+"use strict";export function traceEntries(t){const s=[...t.reasoning??[]].sort((t,s)=>t.afterCalls-s.afterCalls),n=[];let o=0;const r=t=>{for(;o<s.length&&s[o].afterCalls<=t;)n.push({kind:"thought",text:s[o].text}),o+=1};return t.toolCalls.forEach((t,s)=>{r(s),n.push({kind:"step",n:s+1,call:t})}),r(t.toolCalls.length),n}export function hasTrace(t){return(t.reasoning?.length??0)>0||t.toolCalls.length>0}const statusWord=t=>"ok"===t.status?t.summary||"done":"running"===t.status?"running":`${t.status}${t.summary?` — ${t.summary}`:""}`;export function traceToText(t,s="  "){const n=[];for(const o of traceEntries(t))if("thought"===o.kind){n.push(`${s}[thinking]`);for(const t of o.text.trim().split("\n"))n.push(`${s}  ${t}`)}else{const{n:t,call:r}=o;n.push(`${s}[${t}] ${r.toolId}.${r.action} — ${statusWord(r)}`),r.params&&n.push(`${s}    ${r.params}`)}return n}

package/lib/module/store/traceText.test.js

@@ -1,111 +1 @@
-"use strict";
-
-/**
- * The agent's working, as text.
- *
- * This exists so a tester can paste a run somewhere and find the step that
- * broke, which puts two properties on it: reasoning and steps come out in the
- * order they HAPPENED (a multi-step turn is think, act, think, act — not all
- * the thoughts and then all the steps), and a failed step says so with its
- * parameters attached, since "storage.set failed" without the value it wrote
- * is not a bug report.
- */
-import { describe, expect, it } from "vitest";
-import { hasTrace, traceEntries, traceToText } from "./traceText";
-const call = (over = {}) => ({
-  id: "c1",
-  toolId: "zustand",
-  action: "getStoreState",
-  label: "Read the bag",
-  status: "ok",
-  summary: "Done",
-  ...over
-});
-const msg = (over = {}) => ({
-  id: "m1",
-  role: "assistant",
-  text: "Five items.",
-  toolCalls: [],
-  blocks: [],
-  ...over
-});
-describe("the order of a trace", () => {
-  it("interleaves thinking with the steps it led to", () => {
-    const m = msg({
-      toolCalls: [call({
-        id: "c1"
-      }), call({
-        id: "c2",
-        action: "setState"
-      })],
-      reasoning: [{
-        text: "I should read the bag first.",
-        afterCalls: 0
-      }, {
-        text: "Now I can write the new quantity.",
-        afterCalls: 1
-      }]
-    });
-    expect(traceEntries(m).map(e => e.kind === "thought" ? "T" : `S${e.n}`)).toEqual(["T", "S1", "T", "S2"]);
-  });
-  it("keeps a closing thought after the last step", () => {
-    // Usually the reasoning behind the ANSWER, which is the most useful line
-    // in the whole trace.
-    const m = msg({
-      toolCalls: [call()],
-      reasoning: [{
-        text: "That is everything the user asked for.",
-        afterCalls: 1
-      }]
-    });
-    const entries = traceEntries(m);
-    expect(entries[entries.length - 1]).toEqual({
-      kind: "thought",
-      text: "That is everything the user asked for."
-    });
-  });
-  it("handles a turn with steps and no reasoning at all", () => {
-    // The common case: gpt-4.1 and friends report none.
-    const m = msg({
-      toolCalls: [call()]
-    });
-    expect(traceEntries(m)).toHaveLength(1);
-    expect(hasTrace(m)).toBe(true);
-  });
-  it("has nothing to show for a plain answer", () => {
-    expect(hasTrace(msg())).toBe(false);
-  });
-});
-describe("the text it produces", () => {
-  it("names the tool, the action, the outcome and the parameters", () => {
-    const m = msg({
-      toolCalls: [call({
-        params: '{"storeName":"Poké Mart bag"}'
-      })]
-    });
-    expect(traceToText(m)).toEqual(["  [1] zustand.getStoreState — Done", '      {"storeName":"Poké Mart bag"}']);
-  });
-  it("makes a failure and its parameters findable", () => {
-    const m = msg({
-      toolCalls: [call({
-        toolId: "storage",
-        action: "async.setItem",
-        status: "failed",
-        summary: "key not found",
-        params: '{"key":"@pokemart/bag"}'
-      })]
-    });
-    expect(traceToText(m).join("\n")).toContain("failed — key not found");
-    expect(traceToText(m).join("\n")).toContain("@pokemart/bag");
-  });
-  it("indents a multi-line thought so a pasted session still reads as one", () => {
-    const m = msg({
-      reasoning: [{
-        text: "First line.\nSecond line.",
-        afterCalls: 0
-      }]
-    });
-    expect(traceToText(m)).toEqual(["  [thinking]", "    First line.", "    Second line."]);
-  });
-});
-//# sourceMappingURL=traceText.test.js.map
+"use strict";import{describe,expect,it}from"vitest";import{hasTrace,traceEntries,traceToText}from"./traceText";const call=(t={})=>({id:"c1",toolId:"zustand",action:"getStoreState",label:"Read the bag",status:"ok",summary:"Done",...t}),msg=(t={})=>({id:"m1",role:"assistant",text:"Five items.",toolCalls:[],blocks:[],...t});describe("the order of a trace",()=>{it("interleaves thinking with the steps it led to",()=>{const t=msg({toolCalls:[call({id:"c1"}),call({id:"c2",action:"setState"})],reasoning:[{text:"I should read the bag first.",afterCalls:0},{text:"Now I can write the new quantity.",afterCalls:1}]});expect(traceEntries(t).map(t=>"thought"===t.kind?"T":`S${t.n}`)).toEqual(["T","S1","T","S2"])}),it("keeps a closing thought after the last step",()=>{const t=msg({toolCalls:[call()],reasoning:[{text:"That is everything the user asked for.",afterCalls:1}]}),e=traceEntries(t);expect(e[e.length-1]).toEqual({kind:"thought",text:"That is everything the user asked for."})}),it("handles a turn with steps and no reasoning at all",()=>{const t=msg({toolCalls:[call()]});expect(traceEntries(t)).toHaveLength(1),expect(hasTrace(t)).toBe(!0)}),it("has nothing to show for a plain answer",()=>{expect(hasTrace(msg())).toBe(!1)})}),describe("the text it produces",()=>{it("names the tool, the action, the outcome and the parameters",()=>{const t=msg({toolCalls:[call({params:'{"storeName":"Poké Mart bag"}'})]});expect(traceToText(t)).toEqual(["  [1] zustand.getStoreState — Done",'      {"storeName":"Poké Mart bag"}'])}),it("makes a failure and its parameters findable",()=>{const t=msg({toolCalls:[call({toolId:"storage",action:"async.setItem",status:"failed",summary:"key not found",params:'{"key":"@pokemart/bag"}'})]});expect(traceToText(t).join("\n")).toContain("failed — key not found"),expect(traceToText(t).join("\n")).toContain("@pokemart/bag")}),it("indents a multi-line thought so a pasted session still reads as one",()=>{const t=msg({reasoning:[{text:"First line.\nSecond line.",afterCalls:0}]});expect(traceToText(t)).toEqual(["  [thinking]","    First line.","    Second line."])})});