@anuma/sdk 3.6.3 → 3.7.0

package/dist/expo/{chunk-FKACNV6X.mjs → chunk-AAB7OG7Q.mjs}

@@ -1,7 +1,7 @@
 import {
   callPortalJsonCompletion,
   getLogger
-} from "./chunk-DFVCS3QQ.mjs";
+} from "./chunk-BOY27A2C.mjs";
 import {
   BASE_URL,
   createClientConfig
@@ -5363,7 +5363,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             legacy.map((r) => ({ id: r.uniqueId, content: r.content, score: r.similarity }))
           );
         }
-        const { recall: recall2 } = await import("./recall-VZHV7ILE.mjs");
+        const { recall: recall2 } = await import("./recall-YVU7OSSJ.mjs");
         const result = await recall2(
           query,
           { vaultCtx, embeddingOptions, vaultCache: cache },

package/dist/expo/{chunk-DFVCS3QQ.mjs → chunk-BOY27A2C.mjs}

@@ -27,6 +27,24 @@ function getLogger() {
   return currentLogger;
 }
 
+// src/lib/chat/endpointOverride.ts
+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}` };
+}
+
 // src/lib/memory/portalLlm.ts
 function defaultBaseUrl() {
   return typeof process !== "undefined" && process.env?.ANUMA_PORTAL_BASE_URL || BASE_URL;
@@ -78,6 +96,14 @@ async function resolvePortalAuthHeaders(auth, tag) {
 }
 async function callPortalJsonCompletion(req) {
   const log = getLogger();
+  let endpoint = "/api/v1/chat/completions";
+  if (req.endpointOverride !== void 0) {
+    const overrideValidation = validateEndpointOverride(req.endpointOverride);
+    if (!overrideValidation.valid) {
+      throw new Error(overrideValidation.message);
+    }
+    endpoint = overrideValidation.endpoint;
+  }
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
   const overBudget = () => req.totalTimeoutMs !== void 0 && Date.now() - startedAt >= req.totalTimeoutMs;
@@ -93,7 +119,7 @@ async function callPortalJsonCompletion(req) {
         Math.min(req.timeoutMs ?? 6e4, req.totalTimeoutMs - (Date.now() - startedAt))
       )
     } : req;
-    const outcome = await attemptPortalJson(attemptReq);
+    const outcome = await attemptPortalJson(attemptReq, endpoint);
     if (outcome.kind === "ok") return outcome.value;
     if (outcome.kind === "terminal") {
       log.warn(`[${req.tag}] ${outcome.reason}`);
@@ -116,7 +142,7 @@ async function callPortalJsonCompletion(req) {
   }
   return null;
 }
-async function attemptPortalJson(req) {
+async function attemptPortalJson(req, endpoint) {
   const baseUrl = req.baseUrl ?? defaultBaseUrl();
   const fetchImpl = req.fetchFn ?? fetch;
   const timeoutMs = req.timeoutMs ?? 6e4;
@@ -141,7 +167,7 @@ async function attemptPortalJson(req) {
   if (!supportsJsonObjectFormat) delete requestBody.response_format;
   let response;
   try {
-    response = await fetchImpl(`${baseUrl}/api/v1/chat/completions`, {
+    response = await fetchImpl(`${baseUrl}${endpoint}`, {
       method: "POST",
       headers: { ...authHeaders, "Content-Type": "application/json" },
       body: JSON.stringify(requestBody),
@@ -239,6 +265,7 @@ export {
   noopLogger,
   setLogger,
   getLogger,
+  validateEndpointOverride,
   supportsResponseFormat,
   resolvePortalAuthHeaders,
   callPortalJsonCompletion,

package/dist/expo/{consolidate-3QQPUWD6.mjs → consolidate-J5PHQKKY.mjs}

@@ -4,7 +4,7 @@ import {
 import {
   callPortalJsonCompletion,
   getLogger
-} from "./chunk-DFVCS3QQ.mjs";
+} from "./chunk-BOY27A2C.mjs";
 import "./chunk-GYKJOWEO.mjs";
 
 // src/lib/memory/consolidate.ts

package/dist/expo/index.cjs

@@ -3976,6 +3976,29 @@ var init_redactor = __esm({
   }
 });
 
+// src/lib/chat/endpointOverride.ts
+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}` };
+}
+var init_endpointOverride = __esm({
+  "src/lib/chat/endpointOverride.ts"() {
+    "use strict";
+  }
+});
+
 // src/lib/db/entities/types.ts
 function normalizeEntityName(name) {
   return name.trim().toLowerCase();
@@ -5026,6 +5049,14 @@ async function resolvePortalAuthHeaders(auth, tag) {
 }
 async function callPortalJsonCompletion(req) {
   const log = getLogger();
+  let endpoint = "/api/v1/chat/completions";
+  if (req.endpointOverride !== void 0) {
+    const overrideValidation = validateEndpointOverride(req.endpointOverride);
+    if (!overrideValidation.valid) {
+      throw new Error(overrideValidation.message);
+    }
+    endpoint = overrideValidation.endpoint;
+  }
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
   const overBudget = () => req.totalTimeoutMs !== void 0 && Date.now() - startedAt >= req.totalTimeoutMs;
@@ -5041,7 +5072,7 @@ async function callPortalJsonCompletion(req) {
         Math.min(req.timeoutMs ?? 6e4, req.totalTimeoutMs - (Date.now() - startedAt))
       )
     } : req;
-    const outcome = await attemptPortalJson(attemptReq);
+    const outcome = await attemptPortalJson(attemptReq, endpoint);
     if (outcome.kind === "ok") return outcome.value;
     if (outcome.kind === "terminal") {
       log.warn(`[${req.tag}] ${outcome.reason}`);
@@ -5064,7 +5095,7 @@ async function callPortalJsonCompletion(req) {
   }
   return null;
 }
-async function attemptPortalJson(req) {
+async function attemptPortalJson(req, endpoint) {
   const baseUrl = req.baseUrl ?? defaultBaseUrl();
   const fetchImpl = req.fetchFn ?? fetch;
   const timeoutMs = req.timeoutMs ?? 6e4;
@@ -5089,7 +5120,7 @@ async function attemptPortalJson(req) {
   if (!supportsJsonObjectFormat) delete requestBody.response_format;
   let response;
   try {
-    response = await fetchImpl(`${baseUrl}/api/v1/chat/completions`, {
+    response = await fetchImpl(`${baseUrl}${endpoint}`, {
       method: "POST",
       headers: { ...authHeaders, "Content-Type": "application/json" },
       body: JSON.stringify(requestBody),
@@ -5186,6 +5217,7 @@ var init_portalLlm = __esm({
   "src/lib/memory/portalLlm.ts"() {
     "use strict";
     init_clientConfig();
+    init_endpointOverride();
     init_logger();
     RESPONSE_FORMAT_OK = /* @__PURE__ */ new Set(["openai", "inclusionai", "deepseek"]);
     RESPONSE_SCHEMA_OK = /* @__PURE__ */ new Set(["openai"]);
@@ -8027,6 +8059,7 @@ init_serverSentEvents_gen();
 init_clientConfig();
 init_embeddings();
 init_redactor();
+init_endpointOverride();
 
 // src/lib/chat/runHooks.ts
 function composeHooks(hooks) {
@@ -10206,22 +10239,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,
@@ -15991,6 +16008,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_PROMPT6,
       userMessage: `${vocabularyNote}Memories:

package/dist/expo/index.d.mts

@@ -7456,6 +7456,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/expo/index.d.ts

@@ -7456,6 +7456,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/expo/index.mjs

@@ -108,7 +108,7 @@ import {
   upsertMessageOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-FKACNV6X.mjs";
+} from "./chunk-AAB7OG7Q.mjs";
 import {
   PII_PATTERNS,
   PiiRedactor,
@@ -124,8 +124,9 @@ import {
   noopLogger,
   resolvePortalAuthHeaders,
   setLogger,
-  supportsResponseFormat
-} from "./chunk-DFVCS3QQ.mjs";
+  supportsResponseFormat,
+  validateEndpointOverride
+} from "./chunk-BOY27A2C.mjs";
 import {
   BASE_URL,
   MCP_R2_DOMAIN,
@@ -2473,22 +2474,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,
@@ -6430,7 +6415,7 @@ async function tryConsolidate(trimmed, ctx, options) {
     content: m.content,
     similarity: m.similarity
   }));
-  const { consolidateMemory: doConsolidate } = await import("./consolidate-3QQPUWD6.mjs");
+  const { consolidateMemory: doConsolidate } = await import("./consolidate-J5PHQKKY.mjs");
   const decision = await doConsolidate(trimmed, candidates, consolidateOptions);
   if (decision.action === "create") return null;
   if (decision.action === "supersede" && decision.targetId && decision.content) {
@@ -8173,6 +8158,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:

package/dist/{react/recall-JOLS3V4B.mjs → expo/recall-YVU7OSSJ.mjs}

@@ -1,7 +1,7 @@
 import {
   recall
-} from "./chunk-ZGMHRWOR.mjs";
-import "./chunk-DFVCS3QQ.mjs";
+} from "./chunk-AAB7OG7Q.mjs";
+import "./chunk-BOY27A2C.mjs";
 import "./chunk-GYKJOWEO.mjs";
 export {
   recall

package/dist/react/{chunk-ZGMHRWOR.mjs → chunk-3VPEZDYL.mjs}

@@ -1,7 +1,7 @@
 import {
   callPortalJsonCompletion,
   getLogger
-} from "./chunk-DFVCS3QQ.mjs";
+} from "./chunk-BOY27A2C.mjs";
 import {
   BASE_URL,
   createClientConfig
@@ -5641,7 +5641,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             legacy.map((r) => ({ id: r.uniqueId, content: r.content, score: r.similarity }))
           );
         }
-        const { recall: recall2 } = await import("./recall-JOLS3V4B.mjs");
+        const { recall: recall2 } = await import("./recall-Z7BWJ67X.mjs");
         const result = await recall2(
           query,
           { vaultCtx, embeddingOptions, vaultCache: cache },

package/dist/react/{chunk-DFVCS3QQ.mjs → chunk-BOY27A2C.mjs}

@@ -27,6 +27,24 @@ function getLogger() {
   return currentLogger;
 }
 
+// src/lib/chat/endpointOverride.ts
+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}` };
+}
+
 // src/lib/memory/portalLlm.ts
 function defaultBaseUrl() {
   return typeof process !== "undefined" && process.env?.ANUMA_PORTAL_BASE_URL || BASE_URL;
@@ -78,6 +96,14 @@ async function resolvePortalAuthHeaders(auth, tag) {
 }
 async function callPortalJsonCompletion(req) {
   const log = getLogger();
+  let endpoint = "/api/v1/chat/completions";
+  if (req.endpointOverride !== void 0) {
+    const overrideValidation = validateEndpointOverride(req.endpointOverride);
+    if (!overrideValidation.valid) {
+      throw new Error(overrideValidation.message);
+    }
+    endpoint = overrideValidation.endpoint;
+  }
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
   const overBudget = () => req.totalTimeoutMs !== void 0 && Date.now() - startedAt >= req.totalTimeoutMs;
@@ -93,7 +119,7 @@ async function callPortalJsonCompletion(req) {
         Math.min(req.timeoutMs ?? 6e4, req.totalTimeoutMs - (Date.now() - startedAt))
       )
     } : req;
-    const outcome = await attemptPortalJson(attemptReq);
+    const outcome = await attemptPortalJson(attemptReq, endpoint);
     if (outcome.kind === "ok") return outcome.value;
     if (outcome.kind === "terminal") {
       log.warn(`[${req.tag}] ${outcome.reason}`);
@@ -116,7 +142,7 @@ async function callPortalJsonCompletion(req) {
   }
   return null;
 }
-async function attemptPortalJson(req) {
+async function attemptPortalJson(req, endpoint) {
   const baseUrl = req.baseUrl ?? defaultBaseUrl();
   const fetchImpl = req.fetchFn ?? fetch;
   const timeoutMs = req.timeoutMs ?? 6e4;
@@ -141,7 +167,7 @@ async function attemptPortalJson(req) {
   if (!supportsJsonObjectFormat) delete requestBody.response_format;
   let response;
   try {
-    response = await fetchImpl(`${baseUrl}/api/v1/chat/completions`, {
+    response = await fetchImpl(`${baseUrl}${endpoint}`, {
       method: "POST",
       headers: { ...authHeaders, "Content-Type": "application/json" },
       body: JSON.stringify(requestBody),
@@ -239,6 +265,7 @@ export {
   noopLogger,
   setLogger,
   getLogger,
+  validateEndpointOverride,
   supportsResponseFormat,
   resolvePortalAuthHeaders,
   callPortalJsonCompletion,

package/dist/react/{consolidate-3MXZV3G7.mjs → consolidate-PWJCAPZA.mjs}

@@ -4,7 +4,7 @@ import {
 import {
   callPortalJsonCompletion,
   getLogger
-} from "./chunk-DFVCS3QQ.mjs";
+} from "./chunk-BOY27A2C.mjs";
 import "./chunk-GYKJOWEO.mjs";
 
 // src/lib/memory/consolidate.ts

package/dist/react/index.cjs

@@ -4175,6 +4175,29 @@ var init_redactor = __esm({
   }
 });
 
+// src/lib/chat/endpointOverride.ts
+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}` };
+}
+var init_endpointOverride = __esm({
+  "src/lib/chat/endpointOverride.ts"() {
+    "use strict";
+  }
+});
+
 // src/lib/db/entities/types.ts
 function normalizeEntityName(name) {
   return name.trim().toLowerCase();
@@ -5304,6 +5327,14 @@ async function resolvePortalAuthHeaders(auth, tag) {
 }
 async function callPortalJsonCompletion(req) {
   const log = getLogger();
+  let endpoint = "/api/v1/chat/completions";
+  if (req.endpointOverride !== void 0) {
+    const overrideValidation = validateEndpointOverride(req.endpointOverride);
+    if (!overrideValidation.valid) {
+      throw new Error(overrideValidation.message);
+    }
+    endpoint = overrideValidation.endpoint;
+  }
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
   const overBudget = () => req.totalTimeoutMs !== void 0 && Date.now() - startedAt >= req.totalTimeoutMs;
@@ -5319,7 +5350,7 @@ async function callPortalJsonCompletion(req) {
         Math.min(req.timeoutMs ?? 6e4, req.totalTimeoutMs - (Date.now() - startedAt))
       )
     } : req;
-    const outcome = await attemptPortalJson(attemptReq);
+    const outcome = await attemptPortalJson(attemptReq, endpoint);
     if (outcome.kind === "ok") return outcome.value;
     if (outcome.kind === "terminal") {
       log.warn(`[${req.tag}] ${outcome.reason}`);
@@ -5342,7 +5373,7 @@ async function callPortalJsonCompletion(req) {
   }
   return null;
 }
-async function attemptPortalJson(req) {
+async function attemptPortalJson(req, endpoint) {
   const baseUrl = req.baseUrl ?? defaultBaseUrl();
   const fetchImpl = req.fetchFn ?? fetch;
   const timeoutMs = req.timeoutMs ?? 6e4;
@@ -5367,7 +5398,7 @@ async function attemptPortalJson(req) {
   if (!supportsJsonObjectFormat) delete requestBody.response_format;
   let response;
   try {
-    response = await fetchImpl(`${baseUrl}/api/v1/chat/completions`, {
+    response = await fetchImpl(`${baseUrl}${endpoint}`, {
       method: "POST",
       headers: { ...authHeaders, "Content-Type": "application/json" },
       body: JSON.stringify(requestBody),
@@ -5464,6 +5495,7 @@ var init_portalLlm = __esm({
   "src/lib/memory/portalLlm.ts"() {
     "use strict";
     init_clientConfig();
+    init_endpointOverride();
     init_logger();
     RESPONSE_FORMAT_OK = /* @__PURE__ */ new Set(["openai", "inclusionai", "deepseek"]);
     RESPONSE_SCHEMA_OK = /* @__PURE__ */ new Set(["openai"]);
@@ -8378,6 +8410,7 @@ init_serverSentEvents_gen();
 init_clientConfig();
 init_embeddings();
 init_redactor();
+init_endpointOverride();
 
 // src/lib/chat/runHooks.ts
 function composeHooks(hooks) {
@@ -10557,22 +10590,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,
@@ -17281,6 +17298,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_PROMPT6,
       userMessage: `${vocabularyNote}Memories:

package/dist/react/index.d.mts

@@ -8607,6 +8607,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/react/index.d.ts

@@ -8607,6 +8607,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/react/index.mjs

@@ -149,7 +149,7 @@ import {
   updateVaultMemoryOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-ZGMHRWOR.mjs";
+} from "./chunk-3VPEZDYL.mjs";
 import {
   PiiRedactor,
   createStreamingDeAnonymizer,
@@ -164,8 +164,9 @@ import {
   noopLogger,
   resolvePortalAuthHeaders,
   setLogger,
-  supportsResponseFormat
-} from "./chunk-DFVCS3QQ.mjs";
+  supportsResponseFormat,
+  validateEndpointOverride
+} from "./chunk-BOY27A2C.mjs";
 import {
   BASE_URL,
   MCP_R2_DOMAIN,
@@ -2346,22 +2347,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,
@@ -7243,7 +7228,7 @@ async function tryConsolidate(trimmed, ctx, options) {
     content: m.content,
     similarity: m.similarity
   }));
-  const { consolidateMemory: doConsolidate } = await import("./consolidate-3MXZV3G7.mjs");
+  const { consolidateMemory: doConsolidate } = await import("./consolidate-PWJCAPZA.mjs");
   const decision = await doConsolidate(trimmed, candidates, consolidateOptions);
   if (decision.action === "create") return null;
   if (decision.action === "supersede" && decision.targetId && decision.content) {
@@ -8986,6 +8971,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:

package/dist/{expo/recall-VZHV7ILE.mjs → react/recall-Z7BWJ67X.mjs}

@@ -1,7 +1,7 @@
 import {
   recall
-} from "./chunk-FKACNV6X.mjs";
-import "./chunk-DFVCS3QQ.mjs";
+} from "./chunk-3VPEZDYL.mjs";
+import "./chunk-BOY27A2C.mjs";
 import "./chunk-GYKJOWEO.mjs";
 export {
   recall

package/dist/server/{chunk-66UWDXS3.mjs → chunk-LSKFJNLF.mjs}

@@ -1,7 +1,7 @@
 import {
   callPortalJsonCompletion,
   getLogger
-} from "./chunk-AHJT66EO.mjs";
+} from "./chunk-MIXEASUP.mjs";
 import {
   BASE_URL,
   __commonJS,
@@ -19554,7 +19554,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             legacy.map((r) => ({ id: r.uniqueId, content: r.content, score: r.similarity }))
           );
         }
-        const { recall: recall2 } = await import("./recall-UTVH2XPK.mjs");
+        const { recall: recall2 } = await import("./recall-XEOLXA6P.mjs");
         const result = await recall2(
           query,
           { vaultCtx, embeddingOptions, vaultCache: cache },

package/dist/server/{chunk-AHJT66EO.mjs → chunk-MIXEASUP.mjs}

@@ -14,6 +14,24 @@ function getLogger() {
   return currentLogger;
 }
 
+// src/lib/chat/endpointOverride.ts
+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}` };
+}
+
 // src/lib/memory/portalLlm.ts
 function defaultBaseUrl() {
   return typeof process !== "undefined" && process.env?.ANUMA_PORTAL_BASE_URL || BASE_URL;
@@ -65,6 +83,14 @@ async function resolvePortalAuthHeaders(auth, tag) {
 }
 async function callPortalJsonCompletion(req) {
   const log = getLogger();
+  let endpoint = "/api/v1/chat/completions";
+  if (req.endpointOverride !== void 0) {
+    const overrideValidation = validateEndpointOverride(req.endpointOverride);
+    if (!overrideValidation.valid) {
+      throw new Error(overrideValidation.message);
+    }
+    endpoint = overrideValidation.endpoint;
+  }
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
   const overBudget = () => req.totalTimeoutMs !== void 0 && Date.now() - startedAt >= req.totalTimeoutMs;
@@ -80,7 +106,7 @@ async function callPortalJsonCompletion(req) {
         Math.min(req.timeoutMs ?? 6e4, req.totalTimeoutMs - (Date.now() - startedAt))
       )
     } : req;
-    const outcome = await attemptPortalJson(attemptReq);
+    const outcome = await attemptPortalJson(attemptReq, endpoint);
     if (outcome.kind === "ok") return outcome.value;
     if (outcome.kind === "terminal") {
       log.warn(`[${req.tag}] ${outcome.reason}`);
@@ -103,7 +129,7 @@ async function callPortalJsonCompletion(req) {
   }
   return null;
 }
-async function attemptPortalJson(req) {
+async function attemptPortalJson(req, endpoint) {
   const baseUrl = req.baseUrl ?? defaultBaseUrl();
   const fetchImpl = req.fetchFn ?? fetch;
   const timeoutMs = req.timeoutMs ?? 6e4;
@@ -128,7 +154,7 @@ async function attemptPortalJson(req) {
   if (!supportsJsonObjectFormat) delete requestBody.response_format;
   let response;
   try {
-    response = await fetchImpl(`${baseUrl}/api/v1/chat/completions`, {
+    response = await fetchImpl(`${baseUrl}${endpoint}`, {
       method: "POST",
       headers: { ...authHeaders, "Content-Type": "application/json" },
       body: JSON.stringify(requestBody),
@@ -223,6 +249,7 @@ function extractCompletionContent(body) {
 
 export {
   getLogger,
+  validateEndpointOverride,
   supportsResponseFormat,
   resolvePortalAuthHeaders,
   callPortalJsonCompletion,

package/dist/server/{consolidate-CN2GQV4D.mjs → consolidate-PCHO3D3G.mjs}

@@ -4,7 +4,7 @@ import {
 import {
   callPortalJsonCompletion,
   getLogger
-} from "./chunk-AHJT66EO.mjs";
+} from "./chunk-MIXEASUP.mjs";
 import "./chunk-3RPGXXPZ.mjs";
 
 // src/lib/memory/consolidate.ts

package/dist/server/index.cjs

@@ -19549,6 +19549,29 @@ var init_bm25 = __esm({
   }
 });
 
+// src/lib/chat/endpointOverride.ts
+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}` };
+}
+var init_endpointOverride = __esm({
+  "src/lib/chat/endpointOverride.ts"() {
+    "use strict";
+  }
+});
+
 // src/lib/memory/portalLlm.ts
 function defaultBaseUrl() {
   return typeof process !== "undefined" && process.env?.ANUMA_PORTAL_BASE_URL || BASE_URL;
@@ -19597,6 +19620,14 @@ async function resolvePortalAuthHeaders(auth, tag) {
 }
 async function callPortalJsonCompletion(req) {
   const log = getLogger();
+  let endpoint = "/api/v1/chat/completions";
+  if (req.endpointOverride !== void 0) {
+    const overrideValidation = validateEndpointOverride(req.endpointOverride);
+    if (!overrideValidation.valid) {
+      throw new Error(overrideValidation.message);
+    }
+    endpoint = overrideValidation.endpoint;
+  }
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
   const overBudget = () => req.totalTimeoutMs !== void 0 && Date.now() - startedAt >= req.totalTimeoutMs;
@@ -19612,7 +19643,7 @@ async function callPortalJsonCompletion(req) {
         Math.min(req.timeoutMs ?? 6e4, req.totalTimeoutMs - (Date.now() - startedAt))
       )
     } : req;
-    const outcome = await attemptPortalJson(attemptReq);
+    const outcome = await attemptPortalJson(attemptReq, endpoint);
     if (outcome.kind === "ok") return outcome.value;
     if (outcome.kind === "terminal") {
       log.warn(`[${req.tag}] ${outcome.reason}`);
@@ -19635,7 +19666,7 @@ async function callPortalJsonCompletion(req) {
   }
   return null;
 }
-async function attemptPortalJson(req) {
+async function attemptPortalJson(req, endpoint) {
   const baseUrl = req.baseUrl ?? defaultBaseUrl();
   const fetchImpl = req.fetchFn ?? fetch;
   const timeoutMs = req.timeoutMs ?? 6e4;
@@ -19660,7 +19691,7 @@ async function attemptPortalJson(req) {
   if (!supportsJsonObjectFormat) delete requestBody.response_format;
   let response;
   try {
-    response = await fetchImpl(`${baseUrl}/api/v1/chat/completions`, {
+    response = await fetchImpl(`${baseUrl}${endpoint}`, {
       method: "POST",
       headers: { ...authHeaders, "Content-Type": "application/json" },
       body: JSON.stringify(requestBody),
@@ -19757,6 +19788,7 @@ var init_portalLlm = __esm({
   "src/lib/memory/portalLlm.ts"() {
     "use strict";
     init_clientConfig();
+    init_endpointOverride();
     init_logger();
     RESPONSE_FORMAT_OK = /* @__PURE__ */ new Set(["openai", "inclusionai", "deepseek"]);
     RESPONSE_SCHEMA_OK = /* @__PURE__ */ new Set(["openai"]);
@@ -29132,6 +29164,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_PROMPT6,
       userMessage: `${vocabularyNote}Memories:
@@ -31283,6 +31318,7 @@ init_serverSentEvents_gen();
 init_clientConfig();
 init_embeddings();
 init_redactor();
+init_endpointOverride();
 
 // src/lib/chat/runHooks.ts
 function composeHooks(hooks) {
@@ -33433,22 +33469,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/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

@@ -125,7 +125,7 @@ import {
   updateVaultMemoryOp,
   upsertMessageOp,
   vaultMemoryToStored
-} from "./chunk-66UWDXS3.mjs";
+} from "./chunk-LSKFJNLF.mjs";
 import {
   createStreamingDeAnonymizer,
   resolvePiiRedactor
@@ -135,8 +135,9 @@ import {
   extractJsonCandidate,
   getLogger,
   resolvePortalAuthHeaders,
-  supportsResponseFormat
-} from "./chunk-AHJT66EO.mjs";
+  supportsResponseFormat,
+  validateEndpointOverride
+} from "./chunk-MIXEASUP.mjs";
 import {
   BASE_URL,
   __commonJS,
@@ -5315,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) {
@@ -7058,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:
@@ -11326,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-UTVH2XPK.mjs → recall-XEOLXA6P.mjs}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "3.6.3",
+  "version": "3.7.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",