@buoy-gg/agent-core 7.0.35 → 7.0.36

package/lib/typescript/session.d.ts

@@ -1,7 +1,8 @@
 import { type TurnEvent } from "./engine/runAgentTurn";
 import { type ContextPack } from "./engine/systemPrompt";
 import { EffectLedger } from "./effects/ledger";
-import type { AgentMessage, ProviderConfig } from "./providers/types";
+import { compressConsumed, trimHistory, trimHistoryReport } from "./engine/historyBudget";
+import type { AgentMessage, Provider, ProviderConfig } from "./providers/types";
 import { type AskBuoyPolicy } from "./policy/policy";
 import type { DispatchFn, SnapshotFn, ToolDescriptor } from "./types";
 export interface AskBuoySessionConfig extends ProviderConfig {
@@ -26,6 +27,12 @@ export interface AskBuoySessionConfig extends ProviderConfig {
     /** Override the built-in catalog. Tests and the desktop port use this. */
     catalog?: ToolDescriptor[];
     requestApproval?: RunApproval;
+    /**
+     * A ready-made provider, injected by tests and benches — a scripted one,
+     * or a real adapter wrapped for capture. Otherwise the session builds one
+     * from `protocol` and the ProviderConfig fields.
+     */
+    provider?: Provider;
 }
 type RunApproval = (input: {
     id: string;
@@ -34,6 +41,10 @@ type RunApproval = (input: {
     label: string;
     description: string;
     reason: string;
+    /** The call itself — see `RunInput.requestApproval` for why it travels. */
+    params: Record<string, unknown>;
+    /** Fingerprint of the target at ask time — see `readTargetDigest`. */
+    targetDigest?: string;
 }) => Promise<boolean>;
 export interface AskBuoySession {
     readonly ledger: EffectLedger;
@@ -56,6 +67,33 @@ export interface AskBuoySession {
      * separate store and kept rendering. Update in place instead.
      */
     setAvailableActions(actions: Record<string, string[]>): void;
+    /**
+     * Turn this device's approval cards off, or back on.
+     *
+     * A DEVICE preference ("stop asking me"), not app policy — which is why it
+     * is a setter rather than a field on the config. The session is held across
+     * close and reopen so the conversation and the undo ledger survive, so a
+     * value captured when it was built could not be changed afterwards without
+     * throwing both away.
+     *
+     * It suppresses approval GATES only. `deny`, `allow`, `readOnly` and the
+     * release-build refusals are the app saying no, not the app asking a
+     * question, and a "stop asking" toggle must never widen what the agent can
+     * reach.
+     */
+    setApprovalBypass(enabled: boolean): void;
+    /**
+     * The device's "look, don't touch" toggle.
+     *
+     * Effective policy is app read-only OR device read-only: this can only
+     * NARROW what the agent may do, never widen it — turning the device toggle
+     * off cannot switch off an app that configured `policy.readOnly`. Takes
+     * effect on the next call, including the remaining calls of a turn already
+     * running: the engine reads the policy object per call, and this mutates
+     * that object in place rather than handing the engine a new one at the next
+     * turn.
+     */
+    setReadOnly(enabled: boolean): void;
     send(text: string, signal?: AbortSignal): AsyncGenerator<TurnEvent, void, void>;
     reset(): void;
 }
@@ -75,7 +113,7 @@ export interface AskBuoySession {
  * always resumes with a fresh user message instead, so their signatures are
  * dead weight at best and a stale-signature 400 at worst.
  */
+export { compressConsumed, trimHistory, trimHistoryReport };
 export declare function resumableHistory(history: AgentMessage[]): AgentMessage[];
 export declare function createAskBuoySession(config: AskBuoySessionConfig): AskBuoySession;
-export {};
 //# sourceMappingURL=session.d.ts.map

package/lib/typescript/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAWA,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAY,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEtE,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IACjC,QAAQ,EAAE,UAAU,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;IAClC;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACvC,gEAAgE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;;;;;OAQG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAChF,KAAK,IAAI,IAAI,CAAC;CACf;AAsCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAUxE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CA4HjF"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/agent-core",
-  "version": "7.0.35",
+  "version": "7.0.36",
   "description": "Headless agent core for Ask Buoy - the tool catalog, BYO-model providers, turn loop and effect ledger that let an LLM drive Buoy devtools",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -43,7 +43,7 @@
   "bugs": {
     "url": "https://github.com/LovesWorking/react-native-buoy/issues"
   },
-  "homepage": "https://github.com/LovesWorking/react-native-buoy/tree/main/packages/agent-core#readme",
+  "homepage": "https://buoy.gg/buoy/latest/docs/tools/ask-buoy",
   "publishConfig": {
     "access": "public",
     "tag": "latest"