@buoy-gg/ask-buoy 7.0.35 → 7.0.38

package/lib/module/sync/askBuoySyncAdapter.test.js

@@ -1,140 +1 @@
-"use strict";
-
-/**
- * What Ask Buoy is allowed to put on the broker wire, and what it refuses to
- * accept from it.
- *
- * Both directions matter. The broker has no authentication, accepts any client
- * that calls itself "Dashboard", and forwards to every connected dashboard — it
- * already broadcasts license keys that way. So: no tool results go out, and no
- * remote client can make the agent say anything.
- */
-import { beforeEach, describe, expect, it } from "vitest";
-import { EffectLedger } from "@buoy-gg/agent-core";
-import { askBuoySyncAdapter } from "./askBuoySyncAdapter";
-import { redactForWire } from "./wire";
-import { askBuoyStore } from "../store/askBuoyStore";
-beforeEach(() => {
-  askBuoyStore.reset();
-  askBuoyStore.setLedger(null);
-});
-describe("the wire surface", () => {
-  it("exposes no action that can make the agent talk", () => {
-    // A `send` here would let anyone on the LAN drive a mutating agent on a
-    // tester's phone. The conversation starts on-device, by a person.
-    const actions = Object.keys(askBuoySyncAdapter.actions);
-    expect(actions).not.toContain("send");
-    expect(actions).not.toContain("ask");
-    expect(actions).not.toContain("prompt");
-    expect(actions.sort()).toEqual(["listChanges", "reset", "undoAll"]);
-  });
-  it("puts the shape of the conversation on the wire, never tool payloads", () => {
-    askBuoyStore.addUser("what is in storage");
-    const id = askBuoyStore.startAssistant();
-    askBuoyStore.applyEvent(id, {
-      type: "tool-start",
-      id: "c1",
-      toolId: "storage",
-      action: "async.getItem",
-      label: "Read session",
-      description: "Read one AsyncStorage key",
-      params: {
-        key: "session"
-      },
-      effect: "read"
-    });
-    askBuoyStore.applyEvent(id, {
-      type: "tool-end",
-      id: "c1",
-      ok: true,
-      durationMs: 12,
-      summary: "eyJhbGciOiJIUzI1NiJ9.super.secret"
-    });
-    const snap = askBuoySyncAdapter.getSnapshot();
-    const call = snap.messages[1].toolCalls[0];
-    expect(call).toEqual({
-      toolId: "storage",
-      action: "async.getItem",
-      status: "ok"
-    });
-    // The result summary is not on the wire at all — there is no field for it.
-    expect(JSON.stringify(snap)).not.toContain("super.secret");
-  });
-  it("redacts credentials that made it into the assistant's prose", () => {
-    askBuoyStore.addUser("show me the auth header");
-    const id = askBuoyStore.startAssistant();
-    askBuoyStore.applyEvent(id, {
-      type: "text",
-      delta: "It sends Authorization: Bearer abcdef0123456789ghijkl to the API."
-    });
-    const snap = askBuoySyncAdapter.getSnapshot();
-    expect(JSON.stringify(snap)).not.toContain("abcdef0123456789ghijkl");
-  });
-  it("reports reversible and permanent changes separately", () => {
-    const ledger = new EffectLedger();
-    askBuoyStore.setLedger(ledger);
-    ledger.record("storage", "async.setItem", {
-      kind: "storage-write",
-      toolId: "storage",
-      action: "async.setItem",
-      key: "points",
-      before: "240",
-      label: "Set points to 1500"
-    });
-    ledger.record("perf-monitor", "clearAll", {
-      kind: "transient",
-      label: "Cleared samples"
-    });
-    // A store write with no captured prior state: recorded, visible, and
-    // NOT something Undo can deliver — it must count as permanent.
-    ledger.record("zustand", "setState", {
-      kind: "state-write",
-      toolId: "zustand",
-      action: "setState",
-      label: "Update the cart store"
-    });
-    const snap = askBuoySyncAdapter.getSnapshot();
-    expect(snap.changes.reversible).toBe(1);
-    // The transient is an ACTION, not a change — it must not inflate
-    // "permanent" (that read "Changed this app · N permanent" after a
-    // read-only tour). It is still reported, in its own count.
-    expect(snap.changes.permanent).toBe(1);
-    expect(snap.changes.transients).toBe(1);
-  });
-});
-describe("redactForWire", () => {
-  it("removes bearer tokens, JWTs, api keys and license keys", () => {
-    const cases = ["Authorization: Bearer abcdefghijklmnop123456", "token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9abcdefgh", "key sk-abcdefghijklmnop1234", "license BUOY-ABCD-1234-EFGH", 'the header is "x-api-key": "supersecretvalue"'];
-    for (const input of cases) {
-      expect(redactForWire(input)).toContain("removed]");
-    }
-  });
-  it("leaves ordinary prose alone", () => {
-    const text = "The /menu call returned 200 with 12 items and the burger was in stock.";
-    expect(redactForWire(text)).toBe(text);
-  });
-});
-describe("undo from the desktop", () => {
-  it("is allowed, because putting things back is the safe direction", async () => {
-    const ledger = new EffectLedger();
-    askBuoyStore.setLedger(ledger);
-    const store = new Map([["points", "1500"]]);
-    ledger.record("storage", "async.setItem", {
-      kind: "storage-write",
-      toolId: "storage",
-      action: "async.setItem",
-      key: "points",
-      before: "240",
-      label: "Set points to 1500"
-    });
-
-    // The adapter dispatches through the real seam; stub it at the ledger.
-    await ledger.revertAll(async (_t, action, params) => {
-      const p = params;
-      if (action === "async.setItem") store.set(p.key, p.value);
-      return undefined;
-    });
-    expect(store.get("points")).toBe("240");
-  });
-});
-//# sourceMappingURL=askBuoySyncAdapter.test.js.map
+"use strict";import{beforeEach,describe,expect,it}from"vitest";import{EffectLedger}from"@buoy-gg/agent-core";import{askBuoySyncAdapter}from"./askBuoySyncAdapter";import{redactForWire}from"./wire";import{askBuoyStore}from"../store/askBuoyStore";beforeEach(()=>{askBuoyStore.reset(),askBuoyStore.setLedger(null)}),describe("the wire surface",()=>{it("exposes no action that can make the agent talk",()=>{const e=Object.keys(askBuoySyncAdapter.actions);expect(e).not.toContain("send"),expect(e).not.toContain("ask"),expect(e).not.toContain("prompt"),expect(e.sort()).toEqual(["listChanges","reset","undoAll"])}),it("puts the shape of the conversation on the wire, never tool payloads",()=>{askBuoyStore.addUser("what is in storage");const e=askBuoyStore.startAssistant();askBuoyStore.applyEvent(e,{type:"tool-start",id:"c1",toolId:"storage",action:"async.getItem",label:"Read session",description:"Read one AsyncStorage key",params:{key:"session"},effect:"read"}),askBuoyStore.applyEvent(e,{type:"tool-end",id:"c1",ok:!0,durationMs:12,summary:"eyJhbGciOiJIUzI1NiJ9.super.secret"});const t=askBuoySyncAdapter.getSnapshot(),o=t.messages[1].toolCalls[0];expect(o).toEqual({toolId:"storage",action:"async.getItem",status:"ok"}),expect(JSON.stringify(t)).not.toContain("super.secret")}),it("redacts credentials that made it into the assistant's prose",()=>{askBuoyStore.addUser("show me the auth header");const e=askBuoyStore.startAssistant();askBuoyStore.applyEvent(e,{type:"text",delta:"It sends Authorization: Bearer abcdef0123456789ghijkl to the API."});const t=askBuoySyncAdapter.getSnapshot();expect(JSON.stringify(t)).not.toContain("abcdef0123456789ghijkl")}),it("reports reversible and permanent changes separately",()=>{const e=new EffectLedger;askBuoyStore.setLedger(e),e.record("storage","async.setItem",{kind:"storage-write",toolId:"storage",action:"async.setItem",key:"points",before:"240",label:"Set points to 1500"}),e.record("perf-monitor","clearAll",{kind:"transient",label:"Cleared samples"}),e.record("zustand","setState",{kind:"state-write",toolId:"zustand",action:"setState",label:"Update the cart store"});const t=askBuoySyncAdapter.getSnapshot();expect(t.changes.reversible).toBe(1),expect(t.changes.permanent).toBe(1),expect(t.changes.transients).toBe(1)})}),describe("redactForWire",()=>{it("removes bearer tokens, JWTs, api keys and license keys",()=>{const e=["Authorization: Bearer abcdefghijklmnop123456","token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9abcdefgh","key sk-abcdefghijklmnop1234","license BUOY-ABCD-1234-EFGH",'the header is "x-api-key": "supersecretvalue"'];for(const t of e)expect(redactForWire(t)).toContain("removed]")}),it("leaves ordinary prose alone",()=>{const e="The /menu call returned 200 with 12 items and the burger was in stock.";expect(redactForWire(e)).toBe(e)})}),describe("undo from the desktop",()=>{it("is allowed, because putting things back is the safe direction",async()=>{const e=new EffectLedger;askBuoyStore.setLedger(e);const t=new Map([["points","1500"]]);e.record("storage","async.setItem",{kind:"storage-write",toolId:"storage",action:"async.setItem",key:"points",before:"240",label:"Set points to 1500"}),await e.revertAll(async(e,o,s)=>{const a=s;"async.setItem"===o&&t.set(a.key,a.value)}),expect(t.get("points")).toBe("240")})});

package/lib/module/sync/wire.js

@@ -1,47 +1 @@
-"use strict";
-
-/**
- * What the sync adapter is allowed to put on the broker wire.
- *
- * The broker has no authentication, `cors.origin: "*"`, binds every interface,
- * and forwards to every connected dashboard — it already broadcasts each
- * device's license key to every socket. A chat transcript is not a safe thing
- * to add to that channel unfiltered: the agent reads storage values, network
- * response bodies and user records, and any of it can end up quoted in an
- * answer.
- *
- * So text crossing the wire is scrubbed for the shapes that are unambiguously
- * credentials. This is a reduction in blast radius, not a guarantee — the real
- * guarantee is that tool RESULTS never cross at all (see askBuoySyncAdapter).
- */
-export { dispatchToolAction } from "@buoy-gg/shared-ui";
-const PATTERNS = [{
-  re: /\bBearer\s+[A-Za-z0-9._~+/-]{12,}=*/gi,
-  label: "[bearer token removed]"
-}, {
-  re: /\beyJ[A-Za-z0-9._-]{20,}/g,
-  label: "[jwt removed]"
-}, {
-  re: /\bsk-[A-Za-z0-9_-]{16,}/g,
-  label: "[api key removed]"
-}, {
-  re: /\bBUOY-[A-Z0-9-]{8,}/g,
-  label: "[license key removed]"
-},
-// Common "key: value" credential shapes in a quoted payload.
-{
-  re: /("|')?(authorization|x-api-key|api[_-]?key|password|secret|access_token|refresh_token)\1?\s*[:=]\s*("|')?[^\s"',}]{6,}/gi,
-  label: "[credential removed]"
-}];
-export function redactForWire(text) {
-  if (!text) return text;
-  let out = text;
-  for (const {
-    re,
-    label
-  } of PATTERNS) {
-    out = out.replace(re, label);
-  }
-  return out;
-}
-//# sourceMappingURL=wire.js.map
+"use strict";export{dispatchToolAction}from"@buoy-gg/shared-ui";const PATTERNS=[{re:/\bBearer\s+[A-Za-z0-9._~+/-]{12,}=*/gi,label:"[bearer token removed]"},{re:/\beyJ[A-Za-z0-9._-]{20,}/g,label:"[jwt removed]"},{re:/\bsk-[A-Za-z0-9_-]{16,}/g,label:"[api key removed]"},{re:/\bBUOY-[A-Z0-9-]{8,}/g,label:"[license key removed]"},{re:/("|')?(authorization|x-api-key|api[_-]?key|password|secret|access_token|refresh_token)\1?\s*[:=]\s*("|')?[^\s"',}]{6,}/gi,label:"[credential removed]"}];export function redactForWire(e){if(!e)return e;let r=e;for(const{re:e,label:o}of PATTERNS)r=r.replace(e,o);return r}

package/lib/module/types.js

@@ -1,4 +1 @@
-"use strict";
-
-export {};
-//# sourceMappingURL=types.js.map
+"use strict";export{};

package/lib/typescript/blocks/DataBlocks.d.ts

@@ -34,6 +34,17 @@ export declare function listRowBehaviour(item: Pick<ListBlock["items"][number],
 export declare function List({ block }: {
     block: ListBlock;
 }): import("react").JSX.Element;
+/**
+ * What a write changed. Folded by default (see `Card`), and drilled into
+ * rather than dumped.
+ *
+ * A changed field is rendered by the same tree diff viewer the Zustand and
+ * Storage tools use, with unchanged branches hidden — so editing one line of a
+ * bag shows `qty  4 => 14` and not both copies of a fifty-key array serialised
+ * to JSON, which is what the reader was given before and could not read. Only
+ * a scalar keeps the plain −/+ pair: a tree of one root node says less than
+ * the two values side by side.
+ */
 export declare function Diff({ block }: {
     block: DiffBlock;
 }): import("react").JSX.Element;

package/lib/typescript/blocks/ExtraBlocks.d.ts

@@ -1,4 +1,10 @@
-import type { BannerBlock, CardBlock, CardCarouselBlock, CheckpointBlock, ClaimBlock, CompareBlock, DateTimeBlock, DetailsBlock, FileBlock, FormBlock, MultiSelectBlock, PlanBlock, ProposalBlock, ScreenshotBlock, SelectBlock, SliderBlock, SparklineBlock, SuggestionsBlock, TabsBlock, TaskBlock, TimelineBlock, UploadBlock } from "@buoy-gg/agent-core";
+/**
+ * Second-wave blocks from the survey (plan §11). Prototype-quality on purpose:
+ * each one exists so it can be judged on the review page, and the ones that
+ * survive get the same care as the first wave.
+ */
+import { type ReactNode } from "react";
+import type { BannerBlock, Block, CardBlock, CardCarouselBlock, CheckpointBlock, ClaimBlock, CompareBlock, DateTimeBlock, DetailsBlock, FileBlock, FormBlock, MultiSelectBlock, PlanBlock, ProposalBlock, ScreenshotBlock, SelectBlock, SliderBlock, SparklineBlock, SuggestionsBlock, TabsBlock, TaskBlock, TimelineBlock, UploadBlock } from "@buoy-gg/agent-core";
 export declare function Suggestions({ block }: {
     block: SuggestionsBlock;
 }): import("react").JSX.Element;
@@ -37,8 +43,18 @@ export declare function Details({ block }: {
  * Keyed by INDEX, not label: two tabs may legitimately share a label, and a
  * duplicate key would collapse them into one.
  */
-export declare function Tabs({ block }: {
+export declare function Tabs({ block, renderNested, }: {
     block: TabsBlock;
+    /**
+     * Renders the block inside the active tab.
+     *
+     * Passed in rather than imported: this is the only place a block renders
+     * another block, and importing BlockRenderer here closed a require cycle
+     * (BlockRenderer -> ExtraBlocks -> BlockRenderer) that Metro warned about on
+     * every launch — the kind that leaves one of the two modules holding
+     * uninitialised values depending on which is reached first.
+     */
+    renderNested?: (block: Block) => ReactNode;
 }): import("react").JSX.Element;
 export declare function Timeline({ block }: {
     block: TimelineBlock;

package/lib/typescript/blocks/blockText.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Blocks as plain text — for Copy, and for the ticket draft's own Copy.
+ *
+ * `transcriptToText` used to serialise prose and tool rows only, so a
+ * conversation whose whole point was the finding card at the end pasted into
+ * Jira WITHOUT the finding. Covers the kinds that carry facts a person would
+ * paste; everything else becomes one line naming what was on screen, so the
+ * paste says a card existed rather than silently skipping it.
+ */
+import type { Block } from "@buoy-gg/agent-core";
+export declare function blockToText(block: Block): string | null;
+/** Several blocks, blank-line separated, skipping the ones with nothing to say. */
+export declare function blocksToText(blocks: Block[]): string[];
+//# sourceMappingURL=blockText.d.ts.map

package/lib/typescript/blocks/blockText.test.d.ts

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

package/lib/typescript/blocks/primitives.d.ts

@@ -10,12 +10,27 @@ export declare function toneColor(tone?: Tone): string;
 export declare function ProvenanceBadge({ source }: {
     source?: Provenance;
 }): import("react").JSX.Element | null;
-export declare function Card({ title, source, children, testID, tone, }: {
+/**
+ * The block card. Optionally folds its body away behind a one-line summary.
+ *
+ * A card is `collapsible` when its body is reference material rather than the
+ * answer — raw JSON, a field-by-field diff, anything a person reads only when
+ * they have a reason to. It stays folded until asked, because the chat is what
+ * the reader came for and a screen of `promoCode: null` buries it. What must
+ * NEVER fold is the part that carries meaning without being read: the title
+ * and the provenance badge stay on the face of the card in both states, so
+ * "CHANGED BY ASK BUOY" can't be hidden by the same tap that hides the detail.
+ */
+export declare function Card({ title, source, children, testID, tone, collapsible, summary, }: {
     title?: string;
     source?: Provenance;
     children: ReactNode;
     testID?: string;
     tone?: "warning" | "danger" | "info";
+    /** Fold `children` away behind `summary`, closed until tapped. */
+    collapsible?: boolean;
+    /** The one line that stands in for the folded body. Says what is inside it. */
+    summary?: string;
 }): import("react").JSX.Element;
 export interface Paged<T> {
     visible: T[];

package/lib/typescript/components/ApprovalCard.d.ts

@@ -1,7 +1,15 @@
+import type { ApprovalAnswer } from "@buoy-gg/agent-core";
 import type { PendingApproval } from "../store/askBuoyStore";
 export interface ApprovalCardProps {
     pending: PendingApproval;
-    onAnswer: (approved: boolean) => void;
+    /**
+     * The answer in full. A note typed before "Not now" goes to the model
+     * verbatim — "just the second line", not another round of "what would you
+     * prefer?". "Allow for this chat" is `trust`: no card for this action again
+     * this conversation (the settings sheet lists it and can forget it). Never
+     * offered on a restored card: there is no live turn to trust.
+     */
+    onAnswer: (answer: ApprovalAnswer) => void;
 }
 export declare function ApprovalCard({ pending, onAnswer }: ApprovalCardProps): import("react").JSX.Element;
 //# sourceMappingURL=ApprovalCard.d.ts.map

package/lib/typescript/components/AskBuoyHeader.d.ts

@@ -5,6 +5,30 @@ export interface AskBuoyHeaderProps {
     failed?: boolean;
     /** Title of the tool call in flight, if any. */
     activeLabel: string | null;
+    /**
+     * When the running turn began (the streaming message's `startedAt`), so the
+     * subtitle can carry an elapsed clock — "Reading storage · 1m 04s".
+     *
+     * A turn can run three minutes, and "Thinking…" at four seconds looked
+     * identical to "Thinking…" at two minutes forty; then "This is taking too
+     * long" arrived from nowhere. The clock is computed from the timestamp on
+     * every tick rather than counted, so minimise/resume shows the true number,
+     * and it lives in the HEADER only — the transcript does not re-render once
+     * a second for it.
+     */
+    startedAt?: number | null;
+    /** Stop was pressed and the engine is winding down between calls. */
+    stopping?: boolean;
+    /** The device's Read only toggle is on — said in the subtitle so a shared phone can't hide it. */
+    readOnly?: boolean;
+    /**
+     * An approval card is on screen.
+     *
+     * The turn is technically still open, so `busy` is true and the subtitle
+     * read "Thinking…" — while nothing was thinking and the sheet was in fact
+     * waiting on the person looking at it.
+     */
+    awaitingApproval?: boolean;
     toolCount: number;
     hasMessages: boolean;
     onBack?: () => void;
@@ -19,6 +43,12 @@ export interface AskBuoyHeaderProps {
     getTranscript?: () => string;
     /** Open the settings view. Omitted where there is nowhere to go (demos). */
     onOpenSettings?: () => void;
+    /**
+     * Ask the agent for a ticket draft — a `finding` card summarising the
+     * session. Lives in the header because the moment you want it is after the
+     * conversation, not mid-answer; disabled while a turn runs.
+     */
+    onTicket?: () => void;
 }
-export declare function AskBuoyHeader({ configured, busy, failed, activeLabel, toolCount, hasMessages, onBack, onReset, getTranscript, onOpenSettings, }: AskBuoyHeaderProps): import("react").JSX.Element;
+export declare function AskBuoyHeader({ configured, busy, failed, activeLabel, awaitingApproval, startedAt, stopping, readOnly, toolCount, hasMessages, onBack, onReset, getTranscript, onOpenSettings, onTicket, }: AskBuoyHeaderProps): import("react").JSX.Element;
 //# sourceMappingURL=AskBuoyHeader.d.ts.map

package/lib/typescript/components/Composer.d.ts

@@ -2,8 +2,23 @@ export interface ComposerProps {
     onSend: (text: string) => void;
     onStop: () => void;
     busy: boolean;
+    /**
+     * Text handed back from a stopped turn's queue — see `AskBuoyState.draft`.
+     * Restored into the input instead of being sent, so Stop can cancel
+     * everything without losing the words the user had already typed.
+     */
+    draft?: string | null;
+    onDraftTaken?: () => void;
     disabled?: boolean;
     placeholder?: string;
+    /**
+     * Ask for focus. Each new non-null value focuses the input once — the
+     * redirect after Stop ("tell it what to do differently") is only an
+     * invitation if the keyboard is up. Ignored while `canFocus` is false: a
+     * hidden sheet must never summon the keyboard over the app.
+     */
+    focusKey?: string | null;
+    canFocus?: boolean;
 }
-export declare function Composer({ onSend, onStop, busy, disabled, placeholder, }: ComposerProps): import("react").JSX.Element;
+export declare function Composer({ onSend, onStop, busy, draft, onDraftTaken, disabled, placeholder, focusKey, canFocus, }: ComposerProps): import("react").JSX.Element;
 //# sourceMappingURL=Composer.d.ts.map

package/lib/typescript/components/EmptyState.d.ts

@@ -1,6 +1,10 @@
 export interface EmptyStateProps {
     configured: boolean;
     onPick: (text: string) => void;
+    /** Tools registered on this device right now — chips needing others are left out. */
+    availableToolIds?: string[];
+    /** Effective read-only (app or device) — chips that ask for a change are left out. */
+    readOnly?: boolean;
 }
-export declare function EmptyState({ configured, onPick }: EmptyStateProps): import("react").JSX.Element;
+export declare function EmptyState({ configured, onPick, availableToolIds, readOnly }: EmptyStateProps): import("react").JSX.Element;
 //# sourceMappingURL=EmptyState.d.ts.map

package/lib/typescript/components/KeyboardPad.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Keeps the composer above the iOS keyboard.
+ *
+ * Why not `KeyboardAvoidingView`: it takes its frame from `onLayout`, which
+ * is RELATIVE TO ITS PARENT, and compares that to the keyboard's SCREEN
+ * position. That only agrees when the view starts at the window's origin.
+ * Ask Buoy is a JsModal — an absolutely positioned sheet anchored to the
+ * bottom of the app tree — so the view's local bottom (a few hundred points
+ * into the sheet) sits well above the keyboard's screen Y, the overlap comes
+ * out as zero, and nothing moves. The keyboard drew over the composer with
+ * a "working" `KeyboardAvoidingView` around it.
+ *
+ * This measures the SAME thing in the SAME coordinate space: the wrapper's
+ * bottom edge in window coordinates via `measureInWindow`, against the
+ * keyboard's `endCoordinates.screenY`. The difference is the overlap, and it
+ * becomes bottom padding animated over the keyboard's own duration so the
+ * composer rides the keyboard instead of jumping after it.
+ *
+ * The wrapper is `flex: 1` inside a fixed-height sheet body, so its OUTER
+ * bounds never change when its padding does — re-measuring on a later
+ * frame-change event (a predictive-text bar appearing, an emoji keyboard)
+ * gives the same bottom edge.
+ *
+ * iOS only. Android's window resizes under the keyboard
+ * (`softwareKeyboardLayoutMode: "resize"`, both the Expo and the RN CLI
+ * template default) and a bottom-anchored sheet rides up for free; padding
+ * there would lift it twice. Web has no keyboard events and no keyboard.
+ */
+import { type ReactNode } from "react";
+export declare function KeyboardPad({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=KeyboardPad.d.ts.map

package/lib/typescript/components/Markdown.d.ts

@@ -1,13 +1,3 @@
-/**
- * Just enough Markdown for a chat answer.
- *
- * Models write `**bold**`, bullet lists and `code` whether or not the prompt
- * asks for prose, and the asterisks rendered raw made every answer look like
- * a broken template. This handles the subset a chat actually receives —
- * paragraphs, `-`/`*`/`1.` lists, `#` headings (rendered bold, not huge),
- * bold, italics and inline code — with no dependency and no HTML. Anything it
- * does not understand falls through as plain text, never as a blank.
- */
 import { type TextStyle } from "react-native";
 /**
  * `**bold**`, `*italic*` / `_italic_`, `` `code` `` → styled spans. Links and

package/lib/typescript/components/MessageList.d.ts

@@ -1,4 +1,4 @@
-import type { ChatMessage } from "../store/askBuoyStore";
+import { type ChatMessage } from "../store/askBuoyStore";
 /**
  * The whole conversation as plain text — the only thing Copy ever produces,
  * and the only way a session leaves the DEVICE (what it saves to disk for a
@@ -20,6 +20,11 @@ export interface MessageListProps {
     ListFooterComponent?: React.ReactElement | null;
     /** Re-run the last user message. Offered only on the newest failed turn. */
     onRetry?: () => void;
+    /**
+     * The turn is parked on the user — a pending approval or an unanswered Ask
+     * block. Stops the streaming message claiming to be working on it.
+     */
+    waitingOnUser?: boolean;
 }
-export declare function MessageList({ messages, ListHeaderComponent, ListEmptyComponent, ListFooterComponent, onRetry, }: MessageListProps): import("react").JSX.Element;
+export declare function MessageList({ messages, ListHeaderComponent, ListEmptyComponent, ListFooterComponent, onRetry, waitingOnUser, }: MessageListProps): import("react").JSX.Element;
 //# sourceMappingURL=MessageList.d.ts.map

package/lib/typescript/components/QueuedMessages.d.ts

@@ -0,0 +1,10 @@
+import type { QueuedMessage } from "../store/askBuoyStore";
+export interface QueuedMessagesProps {
+    items: QueuedMessage[];
+    /** Why nothing is being sent — or null while the queue will deliver. */
+    paused: string | null;
+    onEdit: (id: string) => void;
+    onRemove: (id: string) => void;
+}
+export declare function QueuedMessages({ items, paused, onEdit, onRemove }: QueuedMessagesProps): import("react").JSX.Element | null;
+//# sourceMappingURL=QueuedMessages.d.ts.map

package/lib/typescript/components/markdownParse.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The Markdown parser, kept apart from the renderer so it can be unit-tested
+ * without React Native.
+ *
+ * Just enough for a chat answer: paragraphs, `-`/`*`/`1.` lists, `#` headings,
+ * pipe tables, and fenced code. Anything it does not understand falls through
+ * as plain text, never as a blank.
+ */
+export type MdBlock = {
+    kind: "p";
+    text: string;
+} | {
+    kind: "h";
+    text: string;
+} | {
+    kind: "li";
+    text: string;
+    marker: string;
+    depth: number;
+} | {
+    kind: "table";
+    header: string[];
+    rows: string[][];
+}
+/**
+ * A fenced block. `closed` is false while the stream is still inside it;
+ * it renders as code either way — a half-arrived JSON blob shown as code is
+ * readable, the same blob shown as a run-on paragraph with its fence
+ * markers is not.
+ */
+ | {
+    kind: "code";
+    lang: string;
+    text: string;
+    closed: boolean;
+};
+export declare function parseBlocks(source: string): MdBlock[];
+/** The preview a table is cut to. Past this it says so and offers the rest. */
+export declare const TABLE_PREVIEW_ROWS = 12;
+export declare const TABLE_PREVIEW_COLS = 4;
+/**
+ * What a table preview leaves out, in the user's words — or null when nothing.
+ *
+ * The renderer used to slice to 4 columns and 12 rows and say nothing, so a
+ * 30-line bag read as a 12-line bag and the bug report that followed was
+ * "the bag only has 12 items". Evidence that is cut must say it is cut.
+ */
+export declare function tableTruncation(header: string[], rows: string[][]): string | null;
+//# sourceMappingURL=markdownParse.d.ts.map

package/lib/typescript/components/markdownParse.test.d.ts

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

package/lib/typescript/preset.d.ts

@@ -20,8 +20,9 @@ export declare const askBuoyToolPreset: {
     description: string;
     slot: "both";
     color: string;
-    icon: ({ size, color }: {
+    icon: ({ size, slot }: {
         size: number;
+        slot?: string;
         color?: string;
     }) => import("react").JSX.Element;
     component: typeof AskBuoyModal;
@@ -53,8 +54,9 @@ export declare function createAskBuoyTool(config: AskBuoyToolConfig): {
     id: string;
     slot: "both";
     color: string;
-    icon: ({ size, color }: {
+    icon: ({ size, slot }: {
         size: number;
+        slot?: string;
         color?: string;
     }) => import("react").JSX.Element;
 };

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

@@ -0,0 +1,29 @@
+import type { ChatToolCall } from "./askBuoyStore";
+export type ActivityItem = {
+    kind: "call";
+    call: ChatToolCall;
+} | {
+    kind: "reads";
+    id: string;
+    calls: ChatToolCall[];
+    label: string;
+    count: number;
+};
+export declare function groupCalls(calls: ChatToolCall[]): ActivityItem[];
+/**
+ * "48s · 6 actions · 1 declined" — the line under a finished answer.
+ *
+ * "Actions" is tool calls, not provider rounds: rounds are an implementation
+ * detail nobody outside the engine can count. Failed, refused, declined and
+ * stopped are listed separately because they are different outcomes — a
+ * failed exploratory read the agent recovered from is not a failed task. No
+ * duration is invented when the message has no start time (a restored note).
+ */
+export declare function turnFooter(message: {
+    startedAt?: number;
+    endedAt?: number;
+    toolCalls: ChatToolCall[];
+}): string | null;
+/** "4s", "1m 04s", "1h 02m". Compact, for a subtitle or a footer. */
+export declare function formatElapsed(ms: number): string;
+//# sourceMappingURL=activityGroups.d.ts.map

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

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

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

@@ -10,6 +10,28 @@ export interface AskBuoySettings {
      * the clipboard: the reading happens outside the app.
      */
     showThinking: boolean;
+    /**
+     * Run everything the agent asks for without the "Allow this change?" card.
+     *
+     * Off by default, and persisted like every other preference here — a person
+     * moving fast on their own dev device should not have to re-say it after
+     * every reload, and the sheet's own settings row is where they find out it
+     * is still on. It waives the approval GATES only: an app's `deny`, `allow`,
+     * `readOnly` and the release-build refusals are the app saying no rather
+     * than asking, and this must never widen what the agent can reach.
+     */
+    bypassApprovals: boolean;
+    /**
+     * Look, don't touch: refuse every write on this device until turned off.
+     *
+     * For a support person on a shared phone who wants to inspect a customer's
+     * state with zero risk. `policy.readOnly` is the app's to set at build
+     * time; this is the person holding the phone setting it. Effective policy
+     * is app OR device, so this can only narrow what the agent may do — turning
+     * it off never switches off an app's own read-only. Persisted like the
+     * others, which on a shared device means: check the subtitle.
+     */
+    readOnly: boolean;
 }
 export declare const DEFAULT_SETTINGS: AskBuoySettings;
 export declare const askBuoySettings: {