@buoy-gg/agent-core 7.0.33

package/lib/module/providers/sse.js

@@ -0,0 +1,99 @@
+"use strict";
+
+/**
+ * SSE reading, with the React Native reality baked in.
+ *
+ * RN's built-in `fetch` does not implement `response.body`. Under Expo you get
+ * a real `ReadableStream` because `expo/fetch` is the global — but
+ * `EXPO_PUBLIC_USE_RN_FETCH=1` reverts that, and the bare-RN, NativeScript and
+ * TV-CLI lanes never had it. So `readSse` degrades to reading the whole body
+ * and replaying it as events rather than failing: a non-streaming answer is a
+ * slower chat, while a hard failure is no chat at all.
+ */
+
+function* parseChunk(buffer) {
+  let rest = buffer;
+  let idx;
+  // Frames are separated by a blank line. \r\n\r\n is legal too.
+  while ((idx = rest.search(/\r?\n\r?\n/)) !== -1) {
+    const raw = rest.slice(0, idx);
+    rest = rest.slice(idx + (rest[idx] === "\r" ? 4 : 2));
+    let event;
+    const dataLines = [];
+    for (const line of raw.split(/\r?\n/)) {
+      if (line.startsWith(":")) continue; // comment / keepalive
+      if (line.startsWith("event:")) event = line.slice(6).trim();else if (line.startsWith("data:")) dataLines.push(line.slice(5).replace(/^ /, ""));
+    }
+    if (dataLines.length) yield {
+      event,
+      data: dataLines.join("\n")
+    };
+  }
+  return rest;
+}
+export async function* readSse(response) {
+  const body = response.body;
+  if (!body || typeof body.getReader !== "function") {
+    // No streaming on this platform — read it all, then replay.
+    const text = await response.text();
+    let rest = "";
+    const gen = parseChunk(text + "\n\n");
+    let next = gen.next();
+    while (!next.done) {
+      yield next.value;
+      next = gen.next();
+    }
+    rest = next.value;
+    if (rest.trim()) {
+      const tail = parseChunk(rest + "\n\n");
+      let t = tail.next();
+      while (!t.done) {
+        yield t.value;
+        t = tail.next();
+      }
+    }
+    return;
+  }
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    for (;;) {
+      const {
+        done,
+        value
+      } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, {
+        stream: true
+      });
+      const gen = parseChunk(buffer);
+      let next = gen.next();
+      while (!next.done) {
+        yield next.value;
+        next = gen.next();
+      }
+      buffer = next.value;
+    }
+  } finally {
+    // Cancelling on abort keeps the socket from lingering after the user
+    // closes the sheet mid-answer.
+    try {
+      reader.releaseLock();
+    } catch {
+      /* already released */
+    }
+  }
+}
+
+/** Body text for a failed response, trimmed to something a user can read. */
+export async function errorBody(response) {
+  let detail = "";
+  try {
+    detail = (await response.text()).slice(0, 600);
+  } catch {
+    /* body already consumed or unreadable */
+  }
+  return `HTTP ${response.status}${detail ? ` — ${detail}` : ""}`;
+}
+//# sourceMappingURL=sse.js.map

package/lib/module/providers/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["parseChunk","buffer","rest","idx","search","raw","slice","event","dataLines","line","split","startsWith","trim","push","replace","length","data","join","readSse","response","body","getReader","text","gen","next","done","value","tail","t","reader","decoder","TextDecoder","read","decode","stream","releaseLock","errorBody","detail","status"],"sourceRoot":"../../../src","sources":["providers/sse.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/providers/types.js

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

package/lib/module/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["providers/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/session.js

@@ -0,0 +1,168 @@
+"use strict";
+
+/**
+ * A conversation, with everything wired up.
+ *
+ * This is the one-call surface the UI packages use. It owns the pieces that
+ * have to agree with each other across a whole session — the provider, the
+ * catalog filtered to what this device can actually do, the system prompt
+ * (built once, after grounding), the effect ledger, and the message history —
+ * so a chat UI is a message list plus a text box rather than an orchestrator.
+ */
+import { CATALOG } from "./catalog/catalog.g";
+import { buildContextDigest } from "./context/buildContextPack";
+import { runAgentTurn } from "./engine/runAgentTurn";
+import { buildSystemPrompt } from "./engine/systemPrompt";
+import { EffectLedger } from "./effects/ledger";
+import { createAnthropicProvider } from "./providers/anthropic";
+import { createOpenAIProvider } from "./providers/openai";
+import { resolveRequireApproval } from "./policy/policy";
+import { registerSelfEndpoint } from "./policy/redact";
+/**
+ * A long QA session must not die on the provider's context limit with an
+ * opaque error — the transcript grows without bound (tool results are the
+ * heavy part), so the OLDEST rounds are dropped once the history passes a
+ * budget. Rounds are dropped whole — a round starts at a user message — so
+ * the assistant/tool-result pairing every provider requires stays intact and
+ * the history still begins with a user message.
+ */
+const MAX_HISTORY_CHARS = 150_000;
+const MIN_KEEP_MESSAGES = 4;
+function messageSize(m) {
+  try {
+    return JSON.stringify(m).length;
+  } catch {
+    return 0;
+  }
+}
+function trimHistory(messages) {
+  let total = 0;
+  for (const m of messages) total += messageSize(m);
+  if (total <= MAX_HISTORY_CHARS) return messages;
+  const out = [...messages];
+  while (out.length > MIN_KEEP_MESSAGES && total > MAX_HISTORY_CHARS) {
+    total -= messageSize(out[0]);
+    out.shift();
+    while (out.length > MIN_KEEP_MESSAGES && out[0].role !== "user") {
+      total -= messageSize(out[0]);
+      out.shift();
+    }
+  }
+  return out;
+}
+export function createAskBuoySession(config) {
+  const catalog = config.catalog ?? CATALOG;
+  const ledger = new EffectLedger();
+  const policy = config.policy ?? {};
+  let messages = [];
+  let system;
+  let primed = false;
+  /**
+   * `storage key -> the live store that owns it`, derived from the grounding.
+   *
+   * Kept because the prompt alone is advice, and a cheap model skips advice the
+   * same way it skips an optional parameter. With this the ENGINE can tell,
+   * at dispatch time, that a storage write landed on a store's saved copy and
+   * therefore changed nothing the user can see.
+   */
+  let storeKeyOwners = {};
+
+  // So the agent's own requests to the model endpoint never come back to it
+  // out of the network tool — that would feed it its own auth headers.
+  registerSelfEndpoint(config.endpoint);
+  const provider = config.protocol === "openai" ? createOpenAIProvider(config) : createAnthropicProvider(config);
+
+  // Mutable: the device's tool list fills in over the first frames and can
+  // change while the sheet is open. See setAvailableActions.
+  let availableActions = config.availableActions;
+  let availableToolIds = Object.keys(availableActions);
+  async function prime() {
+    if (primed) return;
+    primed = true;
+    let digest = {};
+    try {
+      digest = await buildContextDigest({
+        dispatch: config.dispatch,
+        readSnapshot: config.readSnapshot,
+        availableToolIds,
+        availableActions
+      });
+    } catch {
+      // Grounding is an optimisation. A chat with no digest still works; a
+      // chat that refuses to open because a probe timed out does not.
+    }
+    storeKeyOwners = {};
+    for (const raw of digest.zustandStores ?? []) {
+      const store = raw;
+      if (store?.persistsTo && store.name) storeKeyOwners[store.persistsTo] = store.name;
+    }
+    system = buildSystemPrompt({
+      catalog,
+      context: {
+        ...config.context,
+        digest: {
+          ...digest,
+          ...config.context?.digest
+        }
+      },
+      isRelease: config.isRelease,
+      readOnly: policy.readOnly ?? false,
+      requireApproval: resolveRequireApproval(policy),
+      appName: config.appName,
+      platform: config.platform
+    });
+  }
+  return {
+    ledger,
+    get messages() {
+      return messages;
+    },
+    prime,
+    setAvailableActions(actions) {
+      availableActions = actions;
+      availableToolIds = Object.keys(actions);
+    },
+    async *send(text, signal) {
+      await prime();
+      messages.push({
+        role: "user",
+        text
+      });
+      messages = trimHistory(messages);
+      const gen = runAgentTurn({
+        provider,
+        catalog,
+        messages,
+        system: system,
+        model: config.model,
+        maxTokens: config.maxTokens ?? 4096,
+        dispatch: config.dispatch,
+        readSnapshot: config.readSnapshot,
+        storeKeyOwners,
+        ledger,
+        policy,
+        isRelease: config.isRelease,
+        availableToolIds,
+        availableActions,
+        requestApproval: config.requestApproval,
+        signal
+      });
+      let next = await gen.next();
+      while (!next.done) {
+        yield next.value;
+        next = await gen.next();
+      }
+      // The generator's return value is the full history including tool turns.
+      messages = next.value;
+    },
+    reset() {
+      messages = [];
+      ledger.clear();
+      // The grounding digest is a snapshot of the app AT OPEN — stores and
+      // routes registered since are invisible to it. A new conversation is
+      // the natural moment to re-read the world.
+      primed = false;
+    }
+  };
+}
+//# sourceMappingURL=session.js.map

package/lib/module/session.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CATALOG","buildContextDigest","runAgentTurn","buildSystemPrompt","EffectLedger","createAnthropicProvider","createOpenAIProvider","resolveRequireApproval","registerSelfEndpoint","MAX_HISTORY_CHARS","MIN_KEEP_MESSAGES","messageSize","m","JSON","stringify","length","trimHistory","messages","total","out","shift","role","createAskBuoySession","config","catalog","ledger","policy","system","primed","storeKeyOwners","endpoint","provider","protocol","availableActions","availableToolIds","Object","keys","prime","digest","dispatch","readSnapshot","raw","zustandStores","store","persistsTo","name","context","isRelease","readOnly","requireApproval","appName","platform","setAvailableActions","actions","send","text","signal","push","gen","model","maxTokens","requestApproval","next","done","value","reset","clear"],"sourceRoot":"../../src","sources":["session.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,32 @@
+/**
+ * Receipts — blocks the engine builds from tool results, deterministically.
+ *
+ * The model never authors these, so they cannot hallucinate, and a weak model
+ * cannot fail to produce them. They render the SAME redacted result the model
+ * gets, so what the user sees and what the model reasons about are one thing.
+ *
+ * Every projector is small and honest about caps: it truncates and records
+ * `total` so the renderer can say "+38 more" truthfully.
+ */
+import { type Block } from "./types";
+/** Shallow diff of two plain objects: top-level keys that differ. */
+export declare function shallowDiff(before: unknown, after: unknown): {
+    path: string;
+    before?: unknown;
+    after?: unknown;
+}[];
+export interface ReceiptInput {
+    toolId: string;
+    action: string;
+    params: Record<string, unknown>;
+    result: unknown;
+    /** From captureBefore, when the engine read the prior value. */
+    before?: unknown;
+    effect: "read" | "write" | "destructive";
+}
+/**
+ * The receipt for one successful call, or nothing. Adding a projector is the
+ * whole job of making a tool's result visible — no UI change needed.
+ */
+export declare function projectReceipt(input: ReceiptInput): Block | undefined;
+//# sourceMappingURL=receipts.d.ts.map

package/lib/typescript/blocks/receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../../../src/blocks/receipts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAQ,KAAK,KAAK,EAAwC,MAAM,SAAS,CAAC;AAqCjF,qEAAqE;AACrE,wBAAgB,WAAW,CACzB,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,OAAO,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,CAYvD;AAiCD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,GAAG,SAAS,CA8frE"}