@buoy-gg/agent-core 7.0.43 → 7.0.45

package/lib/typescript/catalog/catalog.g.d.ts

@@ -2,10 +2,10 @@
  * GENERATED by scripts/gen-agent-catalog.mjs — do not edit.
  * Source: packages/agent-core/src/catalog/catalog.source.json
  *
- * 27 Buoy tools, 229 actions.
+ * 30 Buoy tools, 271 actions.
  */
 import type { ToolDescriptor } from "../types";
 export declare const CATALOG: ToolDescriptor[];
-export declare const CATALOG_TOOL_COUNT = 27;
-export declare const CATALOG_ACTION_COUNT = 229;
+export declare const CATALOG_TOOL_COUNT = 30;
+export declare const CATALOG_ACTION_COUNT = 271;
 //# sourceMappingURL=catalog.g.d.ts.map

package/lib/typescript/catalog/catalog.types.g.d.ts

@@ -5,9 +5,9 @@
  * The catalog's tool ids and action names as types, so a wrong name fails
  * at compile time. `catalog.g.ts` carries the data.
  *
- * 27 Buoy tools, 229 actions.
+ * 30 Buoy tools, 271 actions.
  */
-export type CatalogToolId = "env" | "console" | "sentry" | "jotai" | "route-events" | "debug-borders" | "zustand" | "redux" | "impersonate" | "query" | "events" | "network" | "js-top" | "app" | "time-machine" | "clock" | "storage" | "highlight-updates" | "scenarios" | "perf-monitor" | "assets" | "tv-remote" | "focus-inspector" | "images" | "ask-buoy" | "push-notifications" | "image-overlay";
+export type CatalogToolId = "env" | "console" | "sentry" | "jotai" | "route-events" | "debug-borders" | "zustand" | "redux" | "impersonate" | "query" | "events" | "network" | "js-top" | "app" | "time-machine" | "clock" | "lifecycle" | "location" | "permissions" | "storage" | "highlight-updates" | "scenarios" | "perf-monitor" | "assets" | "tv-remote" | "focus-inspector" | "images" | "ask-buoy" | "push-notifications" | "image-overlay";
 export interface CatalogActionMap {
     "env": "getSnapshot";
     "console": "getSnapshot" | "clearEntries";
@@ -25,7 +25,10 @@ export interface CatalogActionMap {
     "app": "ping" | "reloadApp";
     "time-machine": "list" | "capture" | "captureBaseline" | "wipeAll" | "restore" | "preview" | "inspect" | "delete" | "rename" | "duplicate" | "setExclusions" | "setScope" | "setRestoreRoute";
     "clock": "getState" | "setTime" | "shift" | "freeze" | "resume" | "setRate" | "reset" | "updateSettings" | "jumpToTokenExpiry" | "failNextRequest" | "stopTokenCheck";
-    "storage": "getRequiredKeys" | "async.getAllKeys" | "async.multiGet" | "async.getItem" | "async.setItem" | "async.removeItem" | "async.multiRemove" | "async.multiSet" | "async.clear" | "clearAppStorage" | "getEventDetail" | "clearEvents" | "timeTravel.undo" | "timeTravel.jump" | "mmkv.snapshot" | "mmkv.get" | "mmkv.set" | "mmkv.remove" | "secure.keys" | "secure.snapshot" | "secure.get" | "secure.set" | "secure.delete";
+    "lifecycle": "getState" | "background" | "interrupt" | "returnToApp" | "memoryWarning" | "openUrl" | "pressBack" | "setColorScheme" | "setPower" | "resetPower" | "relaunch" | "runRecipe" | "clearReport" | "reset";
+    "location": "getState" | "setLocation" | "startRoute" | "pauseRoute" | "resumeRoute" | "stopRoute" | "seekRoute" | "setSpeed" | "enterRegion" | "exitRegion" | "setConditions" | "setSignal" | "setServices" | "tune" | "useRealLocation" | "reset" | "updateSettings" | "clearLog";
+    "permissions": "getState" | "setOverride" | "clearOverride" | "resetAll" | "requestReal" | "updateSettings" | "simulateReturnFromSettings" | "clearLog";
+    "storage": "getSnapshot" | "getRequiredKeys" | "async.getAllKeys" | "async.multiGet" | "async.getItem" | "async.setItem" | "async.removeItem" | "async.multiRemove" | "async.multiSet" | "async.clear" | "clearAppStorage" | "getEventDetail" | "clearEvents" | "timeTravel.undo" | "timeTravel.jump" | "mmkv.snapshot" | "mmkv.get" | "mmkv.set" | "mmkv.remove" | "secure.keys" | "secure.snapshot" | "secure.get" | "secure.set" | "secure.delete";
     "highlight-updates": "describeScreen" | "tapElement" | "waitFor" | "beginMeasurement" | "endMeasurement" | "locateComponent" | "getRenderDetail" | "setEnabled" | "toggle" | "setSilentTracking" | "toggleFreeze" | "setSpotlight" | "clearRenderCounts" | "startTouchCapture" | "stopTouchCapture" | "clearTouchCapture" | "readTouchCapture";
     "scenarios": "listScenarios" | "getScenario" | "save" | "acceptDraft" | "discardDraft" | "preview" | "run" | "deactivate" | "delete" | "setFolder" | "listFolders" | "getActive" | "export";
     "perf-monitor": "setEnabled" | "startRecording" | "stopRecording" | "savePending" | "discardPending" | "mark" | "startAutomation" | "cancelAutomation" | "acknowledgeAutomation" | "refreshIndex" | "getAutomationConfig" | "setAutomationConfig" | "loadReport" | "deleteReport" | "deleteBatch" | "clearAll";
@@ -33,7 +36,7 @@ export interface CatalogActionMap {
     "tv-remote": "arm" | "getEventsSince" | "setMenuCapture" | "disarm" | "clear";
     "focus-inspector": "rescan" | "focusElement" | "setTracking" | "clearHistory";
     "images": "list" | "getDetail" | "getCaptureStatus" | "retry" | "flash" | "proveSavings" | "setOverride" | "clearOverride" | "setNetworkMode" | "setBlankImages" | "hardReload" | "evictDisk" | "massAction" | "clearRecords" | "clearExpoCaches";
-    "ask-buoy": "listChanges" | "undoAll" | "retrieve" | "openProcedure";
+    "ask-buoy": "listChanges" | "undoChange" | "undoAll" | "retrieve" | "openProcedure";
     "push-notifications": "getSnapshot" | "getCapabilities" | "getEvent" | "getPermissions" | "listPresented" | "refreshToken" | "setCaptureSession" | "clearCapturedEvents" | "scheduleLocal";
     "image-overlay": "getSnapshot" | "listTargets" | "selectTarget" | "loadImage" | "setSettings" | "fitToScreen" | "resetSettings" | "remove";
 }

package/lib/typescript/effects/ledger.d.ts

@@ -20,6 +20,7 @@
  * before the earlier one, or the earlier value is the one that survives.
  */
 import type { DispatchFn } from "../types";
+import { type StoreLeaf } from "./storeDiff";
 export type AppliedEffect = {
     kind: "network-override";
     ruleId: string;
@@ -69,6 +70,18 @@ export type AppliedEffect = {
      */
     wroteDigest?: string;
     label: string;
+} | {
+    /**
+     * A store edit (zustand.setState), reversible because the engine reads
+     * the store before and after the write. Holds only the leaves that
+     * changed, so undo puts back exactly those and leaves every other field
+     * — including ones the app synced in meanwhile — alone. See storeDiff.ts.
+     */
+    kind: "store-write";
+    toolId: string;
+    storeName: string;
+    leaves: StoreLeaf[];
+    label: string;
 } | {
     /**
      * A change whose exact inverse is one known call: arming a rule is

package/lib/typescript/effects/storeDiff.d.ts

@@ -0,0 +1,23 @@
+/** One value a write changed. `path` is object keys from the store root. */
+export interface StoreLeaf {
+    path: string[];
+    before: unknown;
+    /** Fingerprint of what the write left, for the "changed since?" check. */
+    wroteDigest: string | undefined;
+}
+/**
+ * The leaves that differ between two snapshots of a store, or `undefined`
+ * when the write cannot be undone exactly. That is the case when it added or
+ * removed an object key: a merge cannot take a key away again, so restoring
+ * the old values would still leave the new key behind. Arrays count as one
+ * leaf, because the store adapter writes arrays whole.
+ */
+export declare function diffLeaves(before: unknown, after: unknown): StoreLeaf[] | undefined;
+/** The value at `path`, and whether it was there at all. */
+export declare function readLeaf(root: unknown, path: string[]): {
+    found: boolean;
+    value?: unknown;
+};
+/** A nested merge patch that sets each leaf's `before` value and nothing else. */
+export declare function restorePatch(leaves: StoreLeaf[]): Record<string, unknown>;
+//# sourceMappingURL=storeDiff.d.ts.map

package/lib/typescript/engine/compactScreen.d.ts

@@ -0,0 +1,18 @@
+/**
+ * What the model reads from `highlight-updates.describeScreen`.
+ *
+ * The raw result on the BK order-item screen was 31k characters for 156
+ * elements: over the 24k result cap, so it arrived cut and the model spent its
+ * rounds paging through it with `retrieve` (add-whoppers hit the 16-round cap
+ * twice in the Luna benchmark, once tapping a stale nativeTag it dug up). Most
+ * of it was waste: screens still mounted UNDER the open one (the header
+ * appeared 16 times), a frame and tap point on every row that no action takes,
+ * and a Text row repeating the label of the button it sits in.
+ *
+ * This keeps every element the model could act on and every visible string,
+ * one line each, NEWEST FIRST. Native tags grow as views mount, so the screen
+ * opened last sorts to the top and the stack beneath it follows. The full
+ * result is still what the card renders; only the model's copy is compacted.
+ */
+export declare function compactScreen(result: unknown): unknown;
+//# sourceMappingURL=compactScreen.d.ts.map

package/lib/typescript/engine/planOnlyStop.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The "announce a plan, then stop" ending.
+ *
+ * GPT-6 Luna (and others) sometimes end a turn with "I'll add the Whopper and
+ * place the order." and no tool call. The loop treats a round with no calls as
+ * the end of the turn, so the user is left with a promise and nothing done.
+ * When the last words announce work that has not started, the engine gives
+ * the model ONE more round with a plain note saying so (runAgentTurn). The same
+ * goes for a message that ends on a colon, introducing options it never sent.
+ * It never forces a call: the model may still answer that it is done or waiting.
+ */
+/** What the engine tells the model when it stopped on an announcement. */
+export declare const PLAN_ONLY_NUDGE = "[Buoy, not the user: your last message said what you would do next but called no tool, so nothing ran and the turn would end there. If the task is not finished, make the next call now. If you are done, say so. If the user has to pick or answer, send the buoy_ui block (choice, confirm or input) now \u2014 text alone gives them nothing to tap.]";
+/** What the engine tells the model when a turn ended with no words at all. */
+export declare const SILENT_NUDGE = "[Buoy, not the user: you ended the turn without a word to the user. Tell them in a sentence or two what you found or did \u2014 a card alone does not say it.]";
+/**
+ * True when the closing words promise an action that no call carried out.
+ * Looks at the last two sentences only: "I'll explain below" early in a
+ * finished answer is not a stop on a promise.
+ */
+export declare function announcesUnstartedWork(text: string): boolean;
+//# sourceMappingURL=planOnlyStop.d.ts.map

package/lib/typescript/engine/runAgentTurn.d.ts

@@ -179,7 +179,7 @@ export type StopReason =
 "answered"
 /** An Ask block (the model's or the gate's) ended the turn; the answer comes as the next user message. */
  | "awaiting-user"
-/** The model→tools→model cap (policy.maxSteps, default 12). */
+/** The model→tools→model cap (policy.maxSteps, default 24). */
  | "step-cap"
 /** The wall-clock cap, approval time excluded. */
  | "time-cap"

package/lib/typescript/providers/types.d.ts

@@ -253,4 +253,12 @@ export interface Provider {
      */
     send(req: ProviderRequest): AsyncGenerator<StreamEvent, void, void>;
 }
+/**
+ * Marks a tool call whose arguments would not parse. The OpenAI provider used
+ * to end the whole turn on one: GPT-6 Luna once streamed 18,000 characters of
+ * whitespace as a `query` call's arguments and the user got an error instead
+ * of an answer. The call now reaches the engine with this key as its only
+ * input, and the engine answers it as a failed call the model can redo.
+ */
+export declare const UNPARSEABLE_ARGS = "__buoyUnparseableArgs";
 //# sourceMappingURL=types.d.ts.map