@buoy-gg/agent-core 7.0.78 → 7.0.80

package/lib/module/session.js

@@ -1 +1 @@
-"use strict";import{selectFeed as G}from"./feeds";import{CATALOG as J}from"./catalog/catalog.g";import{buildContextDigest as Q,buildLiveContext as W}from"./context/buildContextPack";import{runAgentTurn as X}from"./engine/runAgentTurn";import{buildLiveBlock as Y,buildSystemPrompt as Z,listableProcedures as _}from"./engine/systemPrompt";import{EffectLedger as g}from"./effects/ledger";import{EvidenceStore as ee}from"./engine/evidence";import{TokenCalibration as te}from"./engine/tokenCalibration";import{compressConsumed as oe,trimHistory as re,trimHistoryReport as I}from"./engine/historyBudget";import{createAnthropicProvider as se}from"./providers/anthropic";import{createOpenAIProvider as le}from"./providers/openai";import{createFallbackProvider as ae}from"./providers/fallback";import{resolveRequireApproval as ne}from"./policy/policy";import{registerSelfEndpoint as M}from"./policy/redact";export{oe as compressConsumed,re as trimHistory,I as trimHistoryReport};export function resumableHistory(e){let o=e.length;while(o>0){const s=e[o-1];if(s.role==="assistant"&&!s.toolCalls?.length)break;o-=1}return e.slice(0,o).map(s=>s.role==="assistant"&&s.thinking?{...s,thinking:void 0}:s)}export function createAskBuoySession(e){const o=G(e.provider?.protocol??e.protocol,e.feedOptions);e={...e,feedOptions:o.options};let s=0;const L=e.catalog??J;const n=new g;const O=e.policy??{};let a=[];const N=new Set;const w=new ee;const c=new te;let p;let x=false;let u=false;const v=new Set;let y=false;let f=0;let k=0;let b={};let S={};M(e.endpoint);const B=(t,r)=>t==="openai"?le(r):se(r);let R=null;if(!e.provider&&e.fallback){const t=e.fallback;M(t.endpoint);const r={...e,endpoint:t.endpoint,model:t.model,feedOptions:G(t.protocol).options};R=ae({provider:B(e.protocol,e),model:e.model},{provider:B(t.protocol,r),model:t.model},h=>e.onModelSwitch?.(h==="second"?"fallback":"primary"))}const z=e.provider??R??B(e.protocol,e);let d=e.availableActions;let i=Object.keys(d);const l={...O};function $(){for(const t of Object.keys(l))delete l[t];Object.assign(l,O);if(u){l.requireApproval=[];l.requireApprovalFor=[]}if(y)l.readOnly=true}function D(){return l}function P(){if(e.system!==void 0){p=e.system;return}p=Z({catalog:L,context:{...e.context,digest:{...b,...e.context?.digest}},isRelease:e.isRelease,readOnly:l.readOnly??false,readOnlySource:O.readOnly?"app":y?"device":void 0,requireApproval:ne(l),approvalsBypassed:u,appName:e.appName,platform:e.platform,availableToolIds:i})}async function j(){if(x)return;x=true;b={};try{b=await Q({dispatch:e.dispatch,readSnapshot:e.readSnapshot,availableToolIds:i,availableActions:d})}catch{}S={};for(const t of b.zustandStores??[]){const r=t;if(r?.persistsTo&&r.name)S[r.persistsTo]=r.name}P()}return{ledger:n,evidence:w,calibration:c,trustedActions:()=>[...v],untrust:t=>{v.delete(t)},get messages(){return a},prime:j,setAvailableActions(t){d=t;i=Object.keys(t)},setApprovalBypass(t){if(u===t)return;u=t;$();if(p)P()},setReadOnly(t){if(y===t)return;y=t;$();if(p)P()},restore(t){if(a.length>0)return;const r=I(resumableHistory(t),c.charsPerToken,n.liveCallIds());a=r.messages;f=r.droppedRounds},async*send(t,r){const h=k;await j();let T;try{T=await W({dispatch:e.dispatch,readSnapshot:e.readSnapshot,availableToolIds:i,availableActions:d})}catch{T=void 0}if(h!==k){yield{type:"done",stopReason:"superseded"};return}const E=Y(T,n.list().map(m=>({label:`${m.toolId}.${m.action}${m.effect.label?` \u2014 ${m.effect.label}`:""}`,undone:m.undoneAt!==void 0})));const K={role:"user",text:t,...o.name==="claude"?{turnId:`turn-${++s}`}:{},...o.options.liveBlock&&o.options.liveBlock!=="system-tail"?{liveBlock:{placement:o.options.liveBlock,text:E}}:{}};const C=a[a.length-1];const U=C?.role==="user"&&(C.systemNotice||C.liveBlock?.placement==="system-msg")?[{role:"assistant",text:"[Buoy: The prior turn stopped before an answer.]"}]:[];const q=I([...a,...U,K],c.charsPerToken,n.liveCallIds());const V=q.messages;const F=q.droppedRounds+f;f=0;if(F>0)yield{type:"history-trimmed",droppedRounds:F,droppedPinned:q.droppedPinned};const H=X({provider:z,catalog:L,messages:V,system:p,systemVolatile:o.options.liveBlock&&o.options.liveBlock!=="system-tail"?void 0:E,feedOptions:o.options,model:e.model,maxTokens:o.options.maxTokens??e.maxTokens??4096,dispatch:e.dispatch,readSnapshot:e.readSnapshot,storeKeyOwners:S,ledger:n,policy:D(),isRelease:e.isRelease,availableToolIds:i,availableActions:d,requestApproval:e.requestApproval,seenUrls:N,evidence:w,calibration:c,trusted:v,procedures:_(e.context?.procedures,i),signal:r});let A=await H.next();while(!A.done){yield A.value;A=await H.next()}if(h===k)a=A.value},reset(){k+=1;R?.reset();a=[];f=0;n.clear();N.clear();w.clear();v.clear();x=false}}}
+"use strict";import{selectFeed as G}from"./feeds";import{CATALOG as J}from"./catalog/catalog.g";import{buildContextDigest as Q,buildLiveContext as W}from"./context/buildContextPack";import{runAgentTurn as X}from"./engine/runAgentTurn";import{buildLiveBlock as Y,buildSystemPrompt as Z,listableProcedures as _}from"./engine/systemPrompt";import{EffectLedger as g}from"./effects/ledger";import{EvidenceStore as ee}from"./engine/evidence";import{TokenCalibration as te}from"./engine/tokenCalibration";import{compressConsumed as oe,trimHistory as re,trimHistoryReport as I}from"./engine/historyBudget";import{createAnthropicProvider as se}from"./providers/anthropic";import{createOpenAIProvider as le}from"./providers/openai";import{createFallbackProvider as ae}from"./providers/fallback";import{resolveRequireApproval as ne}from"./policy/policy";import{registerSelfEndpoint as M}from"./policy/redact";export{oe as compressConsumed,re as trimHistory,I as trimHistoryReport};export function resumableHistory(e){let o=e.length;while(o>0){const s=e[o-1];if(s.role==="assistant"&&!s.toolCalls?.length)break;o-=1}return e.slice(0,o).map(s=>s.role==="assistant"&&s.thinking?{...s,thinking:void 0}:s)}export function createAskBuoySession(e){const o=G(e.provider?.protocol??e.protocol,e.feedOptions);e={...e,feedOptions:o.options};let s=0;const L=e.catalog??J;const n=new g;const O=e.policy??{};let a=[];const N=new Set;const w=new ee;const c=new te;let p;let x=false;let u=false;const v=new Set;let y=false;let f=0;let k=0;let b={};let S={};M(e.endpoint);const B=(t,r)=>t==="openai"?le(r):se(r);let R=null;if(!e.provider&&e.fallback){const t=e.fallback;M(t.endpoint);const r={...e,endpoint:t.endpoint,model:t.model,feedOptions:G(t.protocol).options};R=ae({provider:B(e.protocol,e),model:e.model},{provider:B(t.protocol,r),model:t.model},h=>e.onModelSwitch?.(h==="second"?"fallback":"primary"))}const z=e.provider??R??B(e.protocol,e);let d=e.availableActions;let i=Object.keys(d);const l={...O};function $(){for(const t of Object.keys(l))delete l[t];Object.assign(l,O);if(u){l.requireApproval=[];l.requireApprovalFor=[]}if(y)l.readOnly=true}function D(){return l}function P(){if(e.system!==void 0){p=e.system;return}p=Z({catalog:L,context:{...e.context,digest:{...b,...e.context?.digest}},isRelease:e.isRelease,readOnly:l.readOnly??false,readOnlySource:O.readOnly?"app":y?"device":void 0,requireApproval:ne(l),approvalsBypassed:u,appName:e.appName,platform:e.platform,availableToolIds:i})}async function j(){if(x)return;x=true;b={};try{b=await Q({dispatch:e.dispatch,readSnapshot:e.readSnapshot,availableToolIds:i,availableActions:d})}catch{}S={};for(const t of b.zustandStores??[]){const r=t;if(r?.persistsTo&&r.name)S[r.persistsTo]=r.name}P()}return{ledger:n,evidence:w,calibration:c,trustedActions:()=>[...v],untrust:t=>{v.delete(t)},get messages(){return a},prime:j,setAvailableActions(t){d=t;i=Object.keys(t)},setApprovalBypass(t){if(u===t)return;u=t;$();if(p)P()},setReadOnly(t){if(y===t)return;y=t;$();if(p)P()},restore(t){if(a.length>0)return;const r=I(resumableHistory(t),c.charsPerToken,n.liveCallIds());a=r.messages;f=r.droppedRounds},async*send(t,r){const h=k;await j();let T;try{T=await W({dispatch:e.dispatch,readSnapshot:e.readSnapshot,availableToolIds:i,availableActions:d})}catch{T=void 0}if(h!==k){yield{type:"done",stopReason:"superseded"};return}const E=Y(T,n.list().map(m=>({label:`${m.toolId}.${m.action}${m.effect.label?` \u2014 ${m.effect.label}`:""}`,undone:m.undoneAt!==void 0})));const K={role:"user",text:t,...o.name==="claude"?{turnId:`turn-${++s}`}:{},...o.options.liveBlock&&o.options.liveBlock!=="system-tail"?{liveBlock:{placement:o.options.liveBlock,text:E}}:{}};const C=a[a.length-1];const U=C?.role==="user"&&(C.systemNotice||C.liveBlock?.placement==="system-msg")?[{role:"assistant",text:"[Buoy: The prior turn stopped before an answer.]"}]:[];const q=I([...a,...U,K],c.charsPerToken,n.liveCallIds());const V=q.messages;const F=q.droppedRounds+f;f=0;if(F>0)yield{type:"history-trimmed",droppedRounds:F,droppedPinned:q.droppedPinned};const H=X({provider:z,catalog:L,messages:V,system:p,systemVolatile:o.options.liveBlock&&o.options.liveBlock!=="system-tail"?void 0:E,feedOptions:o.options,model:e.model,maxTokens:o.options.maxTokens??e.maxTokens??4096,dispatch:e.dispatch,readSnapshot:e.readSnapshot,storeKeyOwners:S,ledger:n,policy:D(),isRelease:e.isRelease,inApp:e.inApp,availableToolIds:i,availableActions:d,requestApproval:e.requestApproval,seenUrls:N,evidence:w,calibration:c,trusted:v,procedures:_(e.context?.procedures,i),signal:r});let A=await H.next();while(!A.done){yield A.value;A=await H.next()}if(h===k)a=A.value},reset(){k+=1;R?.reset();a=[];f=0;n.clear();N.clear();w.clear();v.clear();x=false}}}

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
  *
- * 31 Buoy tools, 280 actions.
+ * 35 Buoy tools, 309 actions.
  */
 import type { ToolDescriptor } from "../types";
 export declare const CATALOG: ToolDescriptor[];
-export declare const CATALOG_TOOL_COUNT = 31;
-export declare const CATALOG_ACTION_COUNT = 280;
+export declare const CATALOG_TOOL_COUNT = 35;
+export declare const CATALOG_ACTION_COUNT = 309;
 //# 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.
  *
- * 31 Buoy tools, 280 actions.
+ * 35 Buoy tools, 309 actions.
  */
-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" | "three";
+export type CatalogToolId = "env" | "console" | "sentry" | "jotai" | "route-events" | "debug-borders" | "zustand" | "redux" | "impersonate" | "query" | "events" | "network" | "sockets" | "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" | "memory-leaks" | "ota-update-inspector" | "three" | "bug-links";
 export interface CatalogActionMap {
     "env": "getSnapshot";
     "console": "getSnapshot" | "clearEntries";
@@ -21,6 +21,7 @@ export interface CatalogActionMap {
     "query": "listQueries" | "getQueryData" | "refetch" | "invalidate" | "reset" | "remove" | "setQueryData" | "triggerError" | "restoreError" | "triggerLoading" | "restoreLoading" | "clearQueryCache" | "clearMutationCache" | "setOnline";
     "events": "exportEvents" | "setEnabledSources" | "clearEvents";
     "network": "getSnapshot" | "getCaptureStatus" | "getEventBody" | "setPinned" | "setSaved" | "removeSavedRecord" | "clearSavedRequests" | "clearPinnedRequests" | "clearEvents" | "listOverrideRules" | "getOverrideRuleBody" | "debugOverrides" | "upsertOverrideRule" | "setOverrideRuleEnabled" | "setOverridesEnabled" | "deleteOverrideRule" | "clearOverrideRules" | "getNetworkConditions" | "setNetworkConditions";
+    "sockets": "query" | "getFrame" | "act";
     "js-top": "sample" | "getOriginDetail" | "setEnabled" | "pause" | "resume" | "clear";
     "app": "ping" | "reloadApp";
     "time-machine": "list" | "capture" | "captureBaseline" | "wipeAll" | "restore" | "preview" | "inspect" | "delete" | "rename" | "duplicate" | "setExclusions" | "setScope" | "setRestoreRoute";
@@ -39,7 +40,10 @@ export interface CatalogActionMap {
     "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";
+    "memory-leaks": "startCheck" | "startWatch" | "finishWatch" | "stopCheck" | "getReport" | "clearReports";
+    "ota-update-inspector": "getState" | "check" | "fetch" | "reload" | "setHeaders" | "setURL" | "setExpected";
     "three": "getScene" | "getStats" | "action";
+    "bug-links": "getState" | "report" | "capture" | "load" | "loadAgain" | "undo" | "end" | "leaveSandbox" | "listLinks" | "retry" | "addNote" | "deleteLink" | "setServer";
 }
 export type CatalogAction<T extends CatalogToolId> = CatalogActionMap[T];
 /** Action names per tool — the runtime mirror of {@link CatalogActionMap}. */

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

@@ -212,8 +212,14 @@ export declare class EffectLedger {
      */
     noteExternalRevert(toolId: string, action: string, params: Record<string, unknown>): boolean;
     private emit;
-    /** Undo one entry. Returns an error string, or undefined on success. */
-    revertOne(entry: LedgerEntry, dispatch: DispatchFn): Promise<string | undefined>;
+    /**
+     * Undo one entry. Returns an error string, or undefined on success.
+     * `refetch: false` is for revertAll, which refetches once after every
+     * override is gone instead of once per override.
+     */
+    revertOne(entry: LedgerEntry, dispatch: DispatchFn, { refetch }?: {
+        refetch?: boolean | undefined;
+    }): Promise<string | undefined>;
     /** Undo everything still outstanding, newest first. */
     revertAll(dispatch: DispatchFn): Promise<RevertOutcome>;
 }

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

@@ -229,6 +229,11 @@ export interface RunTurnInput {
     ledger: EffectLedger;
     policy: AskBuoyPolicy;
     isRelease: boolean;
+    /**
+     * The engine runs inside the app it drives (Ask Buoy's sheet), so a relaunch
+     * reloads the engine too. See `realmWillDie`.
+     */
+    inApp?: boolean;
     /** Live tool ids from `listToolActions()`, so absent tools are never offered. */
     availableToolIds?: string[];
     availableActions?: Record<string, string[]>;

package/lib/typescript/session.d.ts

@@ -24,6 +24,8 @@ export interface AskBuoySessionConfig extends ProviderConfig {
     context?: ContextPack;
     /** `__DEV__ === false` for this bundle. */
     isRelease: boolean;
+    /** The session runs inside the app it drives. See RunTurnInput.inApp. */
+    inApp?: boolean;
     appName?: string;
     platform?: string;
     /** Override the built-in catalog. Tests and the desktop port use this. */