@anuma/sdk 6.7.2 → 6.8.0

package/dist/{react/chunk-B5UPJRCU.mjs → expo/chunk-CJ32HO6Q.mjs}

@@ -53,6 +53,12 @@ function withInternalFlowMarker(systemPrompt) {
 ${systemPrompt}`;
 }
 
+// src/lib/taskType.ts
+var TASK_TYPE_HEADER = "X-Anuma-Task-Type";
+function taskTypeHeader(taskType) {
+  return taskType ? { [TASK_TYPE_HEADER]: taskType } : {};
+}
+
 // src/lib/memory/portalLlm.ts
 function defaultBaseUrl() {
   return typeof process !== "undefined" && process.env?.ANUMA_PORTAL_BASE_URL || BASE_URL;
@@ -115,9 +121,15 @@ async function callPortalJsonCompletion(req) {
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
   const overBudget = () => req.totalTimeoutMs !== void 0 && Date.now() - startedAt >= req.totalTimeoutMs;
+  let lastFailure;
+  const giveUp = () => {
+    req.onFailure?.(lastFailure ?? { reason: "network", attempts: maxAttempts });
+    return null;
+  };
   for (let attempt = 1; attempt <= maxAttempts; attempt++) {
     if (attempt > 1 && overBudget()) {
       log.warn(`[${req.tag}] over time budget before attempt ${attempt}, giving up`);
+      lastFailure = { reason: "time-budget-exhausted", attempts: attempt - 1 };
       break;
     }
     const attemptReq = req.totalTimeoutMs !== void 0 ? {
@@ -129,9 +141,14 @@ async function callPortalJsonCompletion(req) {
     } : req;
     const outcome = await attemptPortalJson(attemptReq, endpoint);
     if (outcome.kind === "ok") return outcome.value;
+    lastFailure = {
+      reason: outcome.code,
+      ...outcome.httpStatus !== void 0 && { httpStatus: outcome.httpStatus },
+      attempts: attempt
+    };
     if (outcome.kind === "terminal") {
       log.warn(`[${req.tag}] ${outcome.reason}`);
-      return null;
+      return giveUp();
     }
     if (attempt >= maxAttempts) {
       log.warn(`[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, giving up`);
@@ -143,19 +160,21 @@ async function callPortalJsonCompletion(req) {
       log.warn(
         `[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, over time budget, giving up`
       );
+      lastFailure = { reason: "time-budget-exhausted", attempts: attempt };
       break;
     }
     log.warn(`[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, retrying`);
     if (delay > 0) await sleep(delay);
   }
-  return null;
+  return giveUp();
 }
 async function attemptPortalJson(req, endpoint) {
   const baseUrl = req.baseUrl ?? defaultBaseUrl();
   const fetchImpl = req.fetchFn ?? fetch;
   const timeoutMs = req.timeoutMs ?? 6e4;
   const authHeaders = await resolvePortalAuthHeaders(req, req.tag);
-  if (authHeaders === null) return { kind: "terminal", reason: "auth unavailable (no token)" };
+  if (authHeaders === null)
+    return { kind: "terminal", code: "auth-unavailable", reason: "auth unavailable (no token)" };
   const isAnthropic = req.model.startsWith("anthropic/");
   const prefill = isAnthropic ? "{" : "";
   const messages = [
@@ -182,37 +201,67 @@ async function attemptPortalJson(req, endpoint) {
   try {
     response = await fetchImpl(`${baseUrl}${endpoint}`, {
       method: "POST",
-      headers: { ...authHeaders, "Content-Type": "application/json" },
+      // Attached HERE, at the one transport every background memory op shares, so
+      // a new flow gets the provenance by construction rather than by remembering.
+      headers: {
+        ...authHeaders,
+        ...taskTypeHeader(req.taskType),
+        "Content-Type": "application/json"
+      },
       body: JSON.stringify(requestBody),
       signal: controller.signal
     });
   } catch (err) {
     clearTimeout(timer);
-    return { kind: "retryable", reason: `fetch failed: ${err.message}` };
+    return {
+      kind: "retryable",
+      code: "network",
+      reason: `fetch failed: ${err.message}`
+    };
   }
   if (!response.ok) {
     clearTimeout(timer);
     const reason = `portal returned ${response.status}`;
     if (response.status === 401) {
       const tokenAuth = !req.apiKey && !!req.getToken;
-      return tokenAuth ? { kind: "retryable", reason: `${reason} (token may be expired; refreshing)` } : { kind: "terminal", reason };
+      return tokenAuth ? {
+        kind: "retryable",
+        code: "http-retryable",
+        reason: `${reason} (token may be expired; refreshing)`,
+        httpStatus: response.status
+      } : { kind: "terminal", code: "http-terminal", reason, httpStatus: response.status };
     }
-    if (!isRetryableStatus(response.status)) return { kind: "terminal", reason };
+    if (!isRetryableStatus(response.status))
+      return { kind: "terminal", code: "http-terminal", reason, httpStatus: response.status };
     const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
-    return retryAfterMs !== null ? { kind: "retryable", reason, retryAfterMs } : { kind: "retryable", reason };
+    return {
+      kind: "retryable",
+      code: "http-retryable",
+      reason,
+      httpStatus: response.status,
+      ...retryAfterMs !== null && { retryAfterMs }
+    };
   }
   let body;
   try {
     body = await response.json();
   } catch (err) {
     clearTimeout(timer);
-    return { kind: "retryable", reason: `response body parse failed: ${err.message}` };
+    return {
+      kind: "retryable",
+      code: "body-parse-failed",
+      reason: `response body parse failed: ${err.message}`
+    };
   }
   clearTimeout(timer);
   logPortalUsage(body, req.tag);
   const rawContent = extractCompletionContent(body);
   if (!rawContent) {
-    return { kind: "retryable", reason: "portal response had no completion content" };
+    return {
+      kind: "retryable",
+      code: "empty-content",
+      reason: "portal response had no completion content"
+    };
   }
   const looksLikeContinuation = prefill && /^\s*"/.test(rawContent);
   const content = looksLikeContinuation ? prefill + rawContent : rawContent;
@@ -223,11 +272,12 @@ async function attemptPortalJson(req, endpoint) {
   } catch (err) {
     return {
       kind: "retryable",
+      code: "invalid-json",
       reason: `completion was not valid JSON: ${err.message}`
     };
   }
   if (value === null) {
-    return { kind: "retryable", reason: "completion parsed to null" };
+    return { kind: "retryable", code: "null-completion", reason: "completion parsed to null" };
   }
   return { kind: "ok", value };
 }
@@ -305,6 +355,7 @@ export {
   validateEndpointOverride,
   INTERNAL_FLOW_MARKER,
   withInternalFlowMarker,
+  taskTypeHeader,
   supportsResponseFormat,
   resolvePortalAuthHeaders,
   callPortalJsonCompletion,

package/dist/expo/{chunk-VOMDHMKH.mjs → chunk-OUFITMDL.mjs}

@@ -1,6 +1,6 @@
 import {
   getLogger
-} from "./chunk-B5UPJRCU.mjs";
+} from "./chunk-CJ32HO6Q.mjs";
 
 // src/lib/pii/patterns.ts
 function luhnCheck(digits) {

package/dist/expo/{chunk-2YHVYDEL.mjs → chunk-YO5UXOC4.mjs}

@@ -1,7 +1,7 @@
 import {
   callPortalJsonCompletion,
   getLogger
-} from "./chunk-B5UPJRCU.mjs";
+} from "./chunk-CJ32HO6Q.mjs";
 import {
   BASE_URL,
   createClientConfig
@@ -6807,7 +6807,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             subQueries = decomp.subQueries;
           }
         }
-        const { recall: recall2 } = await import("./recall-M3JVFTZL.mjs");
+        const { recall: recall2 } = await import("./recall-IEKVX4JL.mjs");
         let recallDegraded = [];
         const result = await recall2(
           query,
@@ -7074,6 +7074,7 @@ Output strict JSON, no prose: { "expand": [<entity names to expand, verbatim fro
         ...options.apiKey !== void 0 && { apiKey: options.apiKey },
         ...options.getToken !== void 0 && { getToken: options.getToken },
         ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+        taskType: "memory_graph",
         model: options.model ?? DEFAULT_REFINER_MODEL,
         systemPrompt,
         userMessage: `Question: ${query}

package/dist/{react/consolidate-ZCGS7QUA.mjs → expo/consolidate-4BMNVOL4.mjs}

@@ -1,10 +1,10 @@
 import {
   notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-2ARMO2NN.mjs";
+} from "./chunk-OUFITMDL.mjs";
 import {
   callPortalJsonCompletion
-} from "./chunk-B5UPJRCU.mjs";
+} from "./chunk-CJ32HO6Q.mjs";
 import "./chunk-GYKJOWEO.mjs";
 
 // src/lib/memory/consolidate.ts
@@ -77,6 +77,7 @@ ${candidateText}`;
       ...options.apiKey !== void 0 && { apiKey: options.apiKey },
       ...options.getToken !== void 0 && { getToken: options.getToken },
       ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+      taskType: "memory_consolidate",
       model: options.model ?? DEFAULT_CONSOLIDATION_MODEL,
       systemPrompt: SYSTEM_PROMPT,
       userMessage,

package/dist/expo/index.cjs

@@ -4578,6 +4578,18 @@ var init_internalFlowMarker = __esm({
   }
 });
 
+// src/lib/taskType.ts
+function taskTypeHeader(taskType) {
+  return taskType ? { [TASK_TYPE_HEADER]: taskType } : {};
+}
+var TASK_TYPE_HEADER;
+var init_taskType = __esm({
+  "src/lib/taskType.ts"() {
+    "use strict";
+    TASK_TYPE_HEADER = "X-Anuma-Task-Type";
+  }
+});
+
 // src/lib/db/entities/types.ts
 function normalizeEntityName(name) {
   return name.trim().toLowerCase();
@@ -6151,9 +6163,15 @@ async function callPortalJsonCompletion(req) {
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
   const overBudget = () => req.totalTimeoutMs !== void 0 && Date.now() - startedAt >= req.totalTimeoutMs;
+  let lastFailure;
+  const giveUp = () => {
+    req.onFailure?.(lastFailure ?? { reason: "network", attempts: maxAttempts });
+    return null;
+  };
   for (let attempt = 1; attempt <= maxAttempts; attempt++) {
     if (attempt > 1 && overBudget()) {
       log.warn(`[${req.tag}] over time budget before attempt ${attempt}, giving up`);
+      lastFailure = { reason: "time-budget-exhausted", attempts: attempt - 1 };
       break;
     }
     const attemptReq = req.totalTimeoutMs !== void 0 ? {
@@ -6165,9 +6183,14 @@ async function callPortalJsonCompletion(req) {
     } : req;
     const outcome = await attemptPortalJson(attemptReq, endpoint);
     if (outcome.kind === "ok") return outcome.value;
+    lastFailure = {
+      reason: outcome.code,
+      ...outcome.httpStatus !== void 0 && { httpStatus: outcome.httpStatus },
+      attempts: attempt
+    };
     if (outcome.kind === "terminal") {
       log.warn(`[${req.tag}] ${outcome.reason}`);
-      return null;
+      return giveUp();
     }
     if (attempt >= maxAttempts) {
       log.warn(`[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, giving up`);
@@ -6179,19 +6202,21 @@ async function callPortalJsonCompletion(req) {
       log.warn(
         `[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, over time budget, giving up`
       );
+      lastFailure = { reason: "time-budget-exhausted", attempts: attempt };
       break;
     }
     log.warn(`[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, retrying`);
     if (delay > 0) await sleep3(delay);
   }
-  return null;
+  return giveUp();
 }
 async function attemptPortalJson(req, endpoint) {
   const baseUrl = req.baseUrl ?? defaultBaseUrl();
   const fetchImpl = req.fetchFn ?? fetch;
   const timeoutMs = req.timeoutMs ?? 6e4;
   const authHeaders = await resolvePortalAuthHeaders(req, req.tag);
-  if (authHeaders === null) return { kind: "terminal", reason: "auth unavailable (no token)" };
+  if (authHeaders === null)
+    return { kind: "terminal", code: "auth-unavailable", reason: "auth unavailable (no token)" };
   const isAnthropic = req.model.startsWith("anthropic/");
   const prefill = isAnthropic ? "{" : "";
   const messages = [
@@ -6218,37 +6243,67 @@ async function attemptPortalJson(req, endpoint) {
   try {
     response = await fetchImpl(`${baseUrl}${endpoint}`, {
       method: "POST",
-      headers: { ...authHeaders, "Content-Type": "application/json" },
+      // Attached HERE, at the one transport every background memory op shares, so
+      // a new flow gets the provenance by construction rather than by remembering.
+      headers: {
+        ...authHeaders,
+        ...taskTypeHeader(req.taskType),
+        "Content-Type": "application/json"
+      },
       body: JSON.stringify(requestBody),
       signal: controller.signal
     });
   } catch (err) {
     clearTimeout(timer);
-    return { kind: "retryable", reason: `fetch failed: ${err.message}` };
+    return {
+      kind: "retryable",
+      code: "network",
+      reason: `fetch failed: ${err.message}`
+    };
   }
   if (!response.ok) {
     clearTimeout(timer);
     const reason = `portal returned ${response.status}`;
     if (response.status === 401) {
       const tokenAuth = !req.apiKey && !!req.getToken;
-      return tokenAuth ? { kind: "retryable", reason: `${reason} (token may be expired; refreshing)` } : { kind: "terminal", reason };
-    }
-    if (!isRetryableStatus(response.status)) return { kind: "terminal", reason };
+      return tokenAuth ? {
+        kind: "retryable",
+        code: "http-retryable",
+        reason: `${reason} (token may be expired; refreshing)`,
+        httpStatus: response.status
+      } : { kind: "terminal", code: "http-terminal", reason, httpStatus: response.status };
+    }
+    if (!isRetryableStatus(response.status))
+      return { kind: "terminal", code: "http-terminal", reason, httpStatus: response.status };
     const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
-    return retryAfterMs !== null ? { kind: "retryable", reason, retryAfterMs } : { kind: "retryable", reason };
+    return {
+      kind: "retryable",
+      code: "http-retryable",
+      reason,
+      httpStatus: response.status,
+      ...retryAfterMs !== null && { retryAfterMs }
+    };
   }
   let body;
   try {
     body = await response.json();
   } catch (err) {
     clearTimeout(timer);
-    return { kind: "retryable", reason: `response body parse failed: ${err.message}` };
+    return {
+      kind: "retryable",
+      code: "body-parse-failed",
+      reason: `response body parse failed: ${err.message}`
+    };
   }
   clearTimeout(timer);
   logPortalUsage(body, req.tag);
   const rawContent = extractCompletionContent(body);
   if (!rawContent) {
-    return { kind: "retryable", reason: "portal response had no completion content" };
+    return {
+      kind: "retryable",
+      code: "empty-content",
+      reason: "portal response had no completion content"
+    };
   }
   const looksLikeContinuation = prefill && /^\s*"/.test(rawContent);
   const content = looksLikeContinuation ? prefill + rawContent : rawContent;
@@ -6259,11 +6314,12 @@ async function attemptPortalJson(req, endpoint) {
   } catch (err) {
     return {
       kind: "retryable",
+      code: "invalid-json",
       reason: `completion was not valid JSON: ${err.message}`
     };
   }
   if (value === null) {
-    return { kind: "retryable", reason: "completion parsed to null" };
+    return { kind: "retryable", code: "null-completion", reason: "completion parsed to null" };
   }
   return { kind: "ok", value };
 }
@@ -6340,6 +6396,7 @@ var init_portalLlm = __esm({
     init_endpointOverride();
     init_internalFlowMarker();
     init_logger();
+    init_taskType();
     RESPONSE_FORMAT_OK = /* @__PURE__ */ new Set(["openai", "inclusionai", "deepseek"]);
     RESPONSE_SCHEMA_OK = /* @__PURE__ */ new Set(["openai"]);
     RETRYABLE_HTTP = /* @__PURE__ */ new Set([408, 409, 425, 429]);
@@ -7126,6 +7183,7 @@ Output strict JSON, no prose: { "expand": [<entity names to expand, verbatim fro
         ...options.apiKey !== void 0 && { apiKey: options.apiKey },
         ...options.getToken !== void 0 && { getToken: options.getToken },
         ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+        taskType: "memory_graph",
         model: options.model ?? DEFAULT_REFINER_MODEL,
         systemPrompt,
         userMessage: `Question: ${query}
@@ -9209,6 +9267,7 @@ ${candidateText}`;
       ...options.apiKey !== void 0 && { apiKey: options.apiKey },
       ...options.getToken !== void 0 && { getToken: options.getToken },
       ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+      taskType: "memory_consolidate",
       model: options.model ?? DEFAULT_CONSOLIDATION_MODEL,
       systemPrompt: SYSTEM_PROMPT3,
       userMessage,
@@ -14042,6 +14101,7 @@ async function deleteConversationSummaryOp(ctx, conversationId) {
 // src/lib/chat/summarize.ts
 init_internalFlowMarker();
 init_logger();
+init_taskType();
 var DEFAULT_SUMMARY_TOKEN_THRESHOLD = 4e3;
 var DEFAULT_SUMMARY_MIN_WINDOW_MESSAGES = 4;
 var DEFAULT_SUMMARY_MODEL = "cerebras/qwen-3-235b-a22b-instruct-2507";
@@ -14228,7 +14288,12 @@ async function callSummarizationLlm(prompt, model, token, baseUrl) {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        Authorization: `Bearer ${token}`
+        Authorization: `Bearer ${token}`,
+        // Names the task so the portal can own this prompt server-side instead of
+        // trusting the one we build. Summarization is the archetypal Class-B flow:
+        // one fixed purpose, no conversation, and today its instructions are ours
+        // to reword.
+        ...taskTypeHeader("summarize")
       },
       body: JSON.stringify({
         model,
@@ -15861,6 +15926,7 @@ async function classifyInjectionCandidates(candidates, options) {
       ...options.apiKey !== void 0 && { apiKey: options.apiKey },
       ...options.getToken !== void 0 && { getToken: options.getToken },
       ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+      taskType: "memory_injection_check",
       model: options.model ?? DEFAULT_MODEL,
       systemPrompt: SYSTEM_PROMPT,
       userMessage: `Candidate facts:
@@ -16562,10 +16628,15 @@ async function extractFacts(messages, options) {
   }
   const transcript = transcriptLines.join("\n");
   const today = formatLocalDate(options.now ?? Date.now());
+  let failure;
   const parsed = await callPortalJsonCompletion({
+    onFailure: (f) => {
+      failure = f;
+    },
     ...options.apiKey !== void 0 && { apiKey: options.apiKey },
     ...options.getToken !== void 0 && { getToken: options.getToken },
     ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+    taskType: "memory_extract",
     ...options.endpointOverride !== void 0 && {
       endpointOverride: options.endpointOverride
     },
@@ -16585,7 +16656,7 @@ Extract durable user facts.`,
     ...options.backoffMs && { backoffMs: options.backoffMs }
   });
   if (parsed === null) {
-    options.onExhaustedEmpty?.();
+    options.onExhaustedEmpty?.(failure ?? { reason: "empty-content", attempts: 1 });
     return [];
   }
   const fallbackSourceId = [...messages].reverse().find((m) => m.role === "user")?.id;
@@ -16629,14 +16700,16 @@ async function extractAndRetain(messages, retainCtx, options) {
     ...resolvedConsolidatePii !== void 0 && { piiRedaction: resolvedConsolidatePii }
   } : void 0;
   let exhaustedEmpty = false;
+  let exhaustedFailure;
   let droppedAfterRedaction = false;
   const callerOnExhaustedEmpty = options.extract.onExhaustedEmpty;
   const callerOnCandidatesDropped = options.extract.onCandidatesDropped;
   const candidates = await extractFacts(messages, {
     ...options.extract,
-    onExhaustedEmpty: () => {
+    onExhaustedEmpty: (failure) => {
       exhaustedEmpty = true;
-      callerOnExhaustedEmpty?.();
+      exhaustedFailure = failure;
+      callerOnExhaustedEmpty?.(failure);
     },
     onCandidatesDropped: () => {
       droppedAfterRedaction = true;
@@ -16755,12 +16828,19 @@ async function extractAndRetain(messages, retainCtx, options) {
     results,
     failedCount: failedWrites,
     outcome,
-    quarantined: quarantinedInfo
+    quarantined: quarantinedInfo,
+    // Only meaningful alongside `outcome: "empty-after-retry"`. Returned as well
+    // as pushed through the callback so a consumer that only inspects the result
+    // (rather than wiring a hook) can still report WHY.
+    ...exhaustedFailure !== void 0 && { failure: exhaustedFailure }
   };
 }
+var UTTERANCE_ECHO_RE = /^(?:said|says|asked|answered|replied|guessed|typed)\s*:\s*(?:'[^']*'|"[^"]*"|‘[^’]*’|“[^”]*”)[\s.!?]*$/iu;
 function isLowSignalContent(content, ownNames) {
-  const normalized = content.trim().replace(/[.!?]+$/, "").toLowerCase();
+  const trimmed = content.trim();
+  const normalized = trimmed.replace(/[.!?]+$/, "").toLowerCase();
   if (normalized.length < MIN_CONTENT_LENGTH) return true;
+  if (UTTERANCE_ECHO_RE.test(trimmed)) return true;
   if (ownNames.some(
     (n) => normalized === n.trim().replace(/[.!?]+$/, "").toLowerCase()
   )) {
@@ -17125,6 +17205,7 @@ function createLlmDecayClassifier(options) {
           ...options.apiKey !== void 0 && { apiKey: options.apiKey },
           ...options.getToken !== void 0 && { getToken: options.getToken },
           ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+          taskType: "memory_decay",
           model: options.model ?? DEFAULT_MODEL3,
           systemPrompt: SYSTEM_PROMPT5,
           userMessage: `Memory content:
@@ -18282,6 +18363,7 @@ 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 },
+      taskType: "memory_topic",
       ...options.endpointOverride !== void 0 && {
         endpointOverride: options.endpointOverride
       },
@@ -18475,6 +18557,7 @@ ${evidence}`);
       ...options.apiKey !== void 0 && { apiKey: options.apiKey },
       ...options.getToken !== void 0 && { getToken: options.getToken },
       ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+      taskType: "memory_verify_support",
       model: options.model ?? DEFAULT_MODEL5,
       systemPrompt: SYSTEM_PROMPT7,
       userMessage: `Stored facts and their sources: