@buoy-gg/agent-core 7.0.33

package/lib/commonjs/session.js

@@ -0,0 +1,173 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createAskBuoySession = createAskBuoySession;
+var _catalog = require("./catalog/catalog.g");
+var _buildContextPack = require("./context/buildContextPack");
+var _runAgentTurn = require("./engine/runAgentTurn");
+var _systemPrompt = require("./engine/systemPrompt");
+var _ledger = require("./effects/ledger");
+var _anthropic = require("./providers/anthropic");
+var _openai = require("./providers/openai");
+var _policy = require("./policy/policy");
+var _redact = require("./policy/redact");
+/**
+ * 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.
+ */
+
+/**
+ * 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;
+}
+function createAskBuoySession(config) {
+  const catalog = config.catalog ?? _catalog.CATALOG;
+  const ledger = new _ledger.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.
+  (0, _redact.registerSelfEndpoint)(config.endpoint);
+  const provider = config.protocol === "openai" ? (0, _openai.createOpenAIProvider)(config) : (0, _anthropic.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 (0, _buildContextPack.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 = (0, _systemPrompt.buildSystemPrompt)({
+      catalog,
+      context: {
+        ...config.context,
+        digest: {
+          ...digest,
+          ...config.context?.digest
+        }
+      },
+      isRelease: config.isRelease,
+      readOnly: policy.readOnly ?? false,
+      requireApproval: (0, _policy.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 = (0, _runAgentTurn.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/commonjs/session.js.map

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

package/lib/commonjs/types.js

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

package/lib/commonjs/types.js.map

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