@anuma/sdk 3.6.2 → 3.7.0

package/dist/server/index.d.mts

@@ -2516,6 +2516,33 @@ type StreamingTransportResult = {
  * transport both honor this contract.
  */
 type StreamingTransport = (options: StreamingTransportOptions) => StreamingTransportResult;
+/**
+ * Framework-agnostic tool execution loop.
+ *
+ * Sends a streaming completion request, auto-executes tools that have executors,
+ * feeds results back to the model, and repeats until the model stops emitting
+ * tool calls or hits the iteration limit.
+ *
+ * This is the same loop that powers `useChat` in the React SDK, extracted so
+ * it can be used from Node.js servers, CLI tools, and background workers.
+ *
+ * @example
+ * ```ts
+ * import { runToolLoop } from "@anuma/sdk/server";
+ *
+ * const result = await runToolLoop({
+ *   messages: [{ role: "user", content: [{ type: "text", text: "What's the weather?" }] }],
+ *   model: "fireworks/accounts/fireworks/models/kimi-k2p5",
+ *   token: "my-api-token",
+ *   tools: [{
+ *     type: "function",
+ *     function: { name: "get_weather", parameters: { type: "object", properties: { city: { type: "string" } } } },
+ *     executor: async ({ city }) => fetchWeather(city),
+ *   }],
+ *   onData: (chunk) => process.stdout.write(chunk),
+ * });
+ * ```
+ */
 declare function runToolLoop(options: RunToolLoopOptions): Promise<RunToolLoopResult>;
 
 /**
@@ -8146,6 +8173,15 @@ interface TopicExtractionInput {
  */
 interface TopicExtractOptions extends PortalLlmAuth {
     baseUrl?: string;
+    /**
+     * Optional per-call request path override, forwarded to
+     * {@link callPortalJsonCompletion}. When set, topic extraction POSTs to
+     * `baseUrl + endpointOverride` instead of the default
+     * `/api/v1/chat/completions` — path only, body unchanged. Lets callers route
+     * this internal-utility pass to a dedicated endpoint. Invalid values throw at
+     * call time (see {@link validateEndpointOverride}).
+     */
+    endpointOverride?: string;
     /** Defaults to {@link DEFAULT_EXTRACTION_MODEL} — the sanctioned extraction
      * model. Don't point this at a second model without an eval. */
     model?: string;

package/dist/server/index.d.ts

@@ -2516,6 +2516,33 @@ type StreamingTransportResult = {
  * transport both honor this contract.
  */
 type StreamingTransport = (options: StreamingTransportOptions) => StreamingTransportResult;
+/**
+ * Framework-agnostic tool execution loop.
+ *
+ * Sends a streaming completion request, auto-executes tools that have executors,
+ * feeds results back to the model, and repeats until the model stops emitting
+ * tool calls or hits the iteration limit.
+ *
+ * This is the same loop that powers `useChat` in the React SDK, extracted so
+ * it can be used from Node.js servers, CLI tools, and background workers.
+ *
+ * @example
+ * ```ts
+ * import { runToolLoop } from "@anuma/sdk/server";
+ *
+ * const result = await runToolLoop({
+ *   messages: [{ role: "user", content: [{ type: "text", text: "What's the weather?" }] }],
+ *   model: "fireworks/accounts/fireworks/models/kimi-k2p5",
+ *   token: "my-api-token",
+ *   tools: [{
+ *     type: "function",
+ *     function: { name: "get_weather", parameters: { type: "object", properties: { city: { type: "string" } } } },
+ *     executor: async ({ city }) => fetchWeather(city),
+ *   }],
+ *   onData: (chunk) => process.stdout.write(chunk),
+ * });
+ * ```
+ */
 declare function runToolLoop(options: RunToolLoopOptions): Promise<RunToolLoopResult>;
 
 /**
@@ -8146,6 +8173,15 @@ interface TopicExtractionInput {
  */
 interface TopicExtractOptions extends PortalLlmAuth {
     baseUrl?: string;
+    /**
+     * Optional per-call request path override, forwarded to
+     * {@link callPortalJsonCompletion}. When set, topic extraction POSTs to
+     * `baseUrl + endpointOverride` instead of the default
+     * `/api/v1/chat/completions` — path only, body unchanged. Lets callers route
+     * this internal-utility pass to a dedicated endpoint. Invalid values throw at
+     * call time (see {@link validateEndpointOverride}).
+     */
+    endpointOverride?: string;
     /** Defaults to {@link DEFAULT_EXTRACTION_MODEL} — the sanctioned extraction
      * model. Don't point this at a second model without an eval. */
     model?: string;

package/dist/server/index.mjs

@@ -33,6 +33,7 @@ import {
   createLlmNeighborRefiner,
   createMemoryVaultSearchTool,
   createMessageOp,
+  createSseClient,
   createSupersedingMemoryOp,
   createVaultEmbeddingCache,
   createVaultMemoriesBatchOp,
@@ -124,7 +125,7 @@ import {
   updateVaultMemoryOp,
   upsertMessageOp,
   vaultMemoryToStored
-} from "./chunk-V7SVKIXQ.mjs";
+} from "./chunk-LSKFJNLF.mjs";
 import {
   createStreamingDeAnonymizer,
   resolvePiiRedactor
@@ -134,8 +135,9 @@ import {
   extractJsonCandidate,
   getLogger,
   resolvePortalAuthHeaders,
-  supportsResponseFormat
-} from "./chunk-AHJT66EO.mjs";
+  supportsResponseFormat,
+  validateEndpointOverride
+} from "./chunk-MIXEASUP.mjs";
 import {
   BASE_URL,
   __commonJS,
@@ -5314,7 +5316,7 @@ async function tryConsolidate(trimmed, ctx, options) {
     content: m.content,
     similarity: m.similarity
   }));
-  const { consolidateMemory: doConsolidate } = await import("./consolidate-CN2GQV4D.mjs");
+  const { consolidateMemory: doConsolidate } = await import("./consolidate-PCHO3D3G.mjs");
   const decision = await doConsolidate(trimmed, candidates, consolidateOptions);
   if (decision.action === "create") return null;
   if (decision.action === "supersede" && decision.targetId && decision.content) {
@@ -7057,6 +7059,9 @@ When a memory refers to one of these, reuse the EXACT existing name (same spelli
       ...options.apiKey !== void 0 && { apiKey: options.apiKey },
       ...options.getToken !== void 0 && { getToken: options.getToken },
       ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+      ...options.endpointOverride !== void 0 && {
+        endpointOverride: options.endpointOverride
+      },
       model: options.model ?? DEFAULT_EXTRACTION_MODEL,
       systemPrompt: SYSTEM_PROMPT4,
       userMessage: `${vocabularyNote}Memories:
@@ -9177,133 +9182,6 @@ function createCryptoPricePreProcessor(options = {}) {
   };
 }
 
-// src/client/core/serverSentEvents.gen.ts
-function createSseClient({
-  onRequest,
-  onSseError,
-  onSseEvent,
-  responseTransformer,
-  responseValidator,
-  sseDefaultRetryDelay,
-  sseMaxRetryAttempts,
-  sseMaxRetryDelay,
-  sseSleepFn,
-  url,
-  ...options
-}) {
-  let lastEventId;
-  const sleep3 = sseSleepFn ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
-  const createStream = async function* () {
-    let retryDelay = sseDefaultRetryDelay ?? 3e3;
-    let attempt = 0;
-    const signal = options.signal ?? new AbortController().signal;
-    while (true) {
-      if (signal.aborted) break;
-      attempt++;
-      const headers = options.headers instanceof Headers ? options.headers : new Headers(options.headers);
-      if (lastEventId !== void 0) {
-        headers.set("Last-Event-ID", lastEventId);
-      }
-      try {
-        const requestInit = {
-          redirect: "follow",
-          ...options,
-          body: options.serializedBody,
-          headers,
-          signal
-        };
-        let request = new Request(url, requestInit);
-        if (onRequest) {
-          request = await onRequest(url, requestInit);
-        }
-        const _fetch = options.fetch ?? globalThis.fetch;
-        const response = await _fetch(request);
-        if (!response.ok) throw new Error(`SSE failed: ${response.status} ${response.statusText}`);
-        if (!response.body) throw new Error("No body in SSE response");
-        const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();
-        let buffer = "";
-        const abortHandler = () => {
-          try {
-            reader.cancel();
-          } catch {
-          }
-        };
-        signal.addEventListener("abort", abortHandler);
-        try {
-          while (true) {
-            const { done, value } = await reader.read();
-            if (done) break;
-            buffer += value;
-            buffer = buffer.replace(/\r\n?/g, "\n");
-            const chunks = buffer.split("\n\n");
-            buffer = chunks.pop() ?? "";
-            for (const chunk of chunks) {
-              const lines = chunk.split("\n");
-              const dataLines = [];
-              let eventName;
-              for (const line of lines) {
-                if (line.startsWith("data:")) {
-                  dataLines.push(line.replace(/^data:\s*/, ""));
-                } else if (line.startsWith("event:")) {
-                  eventName = line.replace(/^event:\s*/, "");
-                } else if (line.startsWith("id:")) {
-                  lastEventId = line.replace(/^id:\s*/, "");
-                } else if (line.startsWith("retry:")) {
-                  const parsed = Number.parseInt(line.replace(/^retry:\s*/, ""), 10);
-                  if (!Number.isNaN(parsed)) {
-                    retryDelay = parsed;
-                  }
-                }
-              }
-              let data;
-              let parsedJson = false;
-              if (dataLines.length) {
-                const rawData = dataLines.join("\n");
-                try {
-                  data = JSON.parse(rawData);
-                  parsedJson = true;
-                } catch {
-                  data = rawData;
-                }
-              }
-              if (parsedJson) {
-                if (responseValidator) {
-                  await responseValidator(data);
-                }
-                if (responseTransformer) {
-                  data = await responseTransformer(data);
-                }
-              }
-              onSseEvent?.({
-                data,
-                event: eventName,
-                id: lastEventId,
-                retry: retryDelay
-              });
-              if (dataLines.length) {
-                yield data;
-              }
-            }
-          }
-        } finally {
-          signal.removeEventListener("abort", abortHandler);
-          reader.releaseLock();
-        }
-        break;
-      } catch (error) {
-        onSseError?.(error);
-        if (sseMaxRetryAttempts !== void 0 && attempt >= sseMaxRetryAttempts) {
-          break;
-        }
-        const backoff = Math.min(retryDelay * 2 ** (attempt - 1), sseMaxRetryDelay ?? 3e4);
-        await sleep3(backoff);
-      }
-    }
-  };
-  const stream = createStream();
-  return { stream };
-}
-
 // src/lib/chat/runHooks.ts
 function composeHooks(hooks) {
   const handlers = hooks.filter((h) => h !== void 0 && h !== null);
@@ -11452,22 +11330,6 @@ function linkAbortSignals(a, b) {
     }
   };
 }
-function validateEndpointOverride(override) {
-  const trimmed = override.trim();
-  if (trimmed === "") {
-    return {
-      valid: false,
-      message: 'endpointOverride must be a non-empty, root-relative path (e.g. "/api/v1/utility/responses"); received an empty or whitespace-only string'
-    };
-  }
-  if (trimmed.startsWith("//") || trimmed.includes("://")) {
-    return {
-      valid: false,
-      message: `endpointOverride must be a root-relative path (e.g. "/api/v1/utility/responses"), not a protocol-relative or absolute URL; received "${trimmed}"`
-    };
-  }
-  return { valid: true, endpoint: trimmed.startsWith("/") ? trimmed : `/${trimmed}` };
-}
 async function runToolLoop(options) {
   const {
     model,

package/dist/server/{recall-IWY2MYHR.mjs → recall-XEOLXA6P.mjs}

@@ -1,7 +1,7 @@
 import {
   recall
-} from "./chunk-V7SVKIXQ.mjs";
-import "./chunk-AHJT66EO.mjs";
+} from "./chunk-LSKFJNLF.mjs";
+import "./chunk-MIXEASUP.mjs";
 import "./chunk-3RPGXXPZ.mjs";
 export {
   recall