@anuma/sdk 1.0.0 → 1.1.0

package/dist/react/consolidate-IJH7LD2T.mjs

@@ -0,0 +1,131 @@
+import {
+  resolvePiiRedactor
+} from "./chunk-TP6CJZ25.mjs";
+import {
+  callPortalJsonCompletion,
+  getLogger
+} from "./chunk-DFVCS3QQ.mjs";
+import "./chunk-GYKJOWEO.mjs";
+
+// src/lib/memory/consolidate.ts
+var DEFAULT_MODEL = "inclusionai/ling-2.6-flash";
+var DEFAULT_CONSOLIDATE_ATTEMPTS = 3;
+var DEFAULT_CONSOLIDATE_TOTAL_TIMEOUT_MS = 2e4;
+var SYSTEM_PROMPT = `You consolidate a new memory against existing memories from the same user.
+
+A "memory" is a self-contained natural-language fact about the user. Multiple memories about the same EXACT FACET (the same dimension of the same subject) should never coexist \u2014 they should be merged into one. Different facets on the same subject (e.g. user's dog's name vs user's dog's age) are SEPARATE memories.
+
+Decide one of three actions:
+
+- "create": the new memory describes a distinct fact not covered by any existing memory. Write it as new.
+- "update": the new memory describes the SAME FACET as exactly one existing memory. Either it adds detail, corrects a value, or rephrases the same fact. Return targetId of that existing memory + the consolidated content (richest version of the two).
+- "noop": the new memory is already fully captured by an existing memory \u2014 same facet, no new information. Skip the write.
+
+RULES (carry these strictly):
+
+1. ONE OBSERVATION PER DISTINCT FACET. If the new memory is about "user's aunt's twins" and an existing memory is also about "user's aunt's twins", they are the same facet \u2192 update, never create.
+2. MATCH BY FACET, NOT TOPIC. Two memories both mentioning "Zara" is not enough to merge \u2014 only merge if they describe the same property (e.g. both about "user's pending Zara boot exchange"). Two memories about Zara on different topics (e.g. "user shops at Zara" + "user returned a sweater to Zara last week") are separate facets.
+3. NO COMPUTATION. Do not sum counts, decrement quantities, or derive new facts from existing ones. If the new memory says "user spent $200 today" and an existing memory says "user spent $150 yesterday", these are TWO SEPARATE EVENTS \u2014 create.
+4. Events with different occurredAt dates are different memories even if the same activity ("user went to gym Monday" vs "user went to gym Friday" \u2014 separate events).
+5. When in doubt between create and update, choose create. Over-merging loses information; under-merging is recoverable.
+
+OUTPUT \u2014 strict JSON, no prose:
+{
+  "action": "create" | "update" | "noop",
+  "targetId": "<existing memory id, required for update/noop, omit for create>",
+  "content": "<consolidated content, required for create/update, omit for noop>"
+}
+
+For "create": content is the new memory verbatim (or a slight refinement).
+For "update": content is the merged richest-version, \u226480 words.
+For "noop": no content (existing memory is already correct).`;
+async function consolidateMemory(newContent, candidates, options) {
+  const fallback = {
+    action: "create",
+    content: newContent
+  };
+  const trimmed = newContent.trim();
+  if (trimmed.length === 0) return fallback;
+  if (candidates.length === 0) return fallback;
+  const redactor = resolvePiiRedactor(options.piiRedaction);
+  const safeTrimmed = redactor ? redactor.redactText(trimmed).text : trimmed;
+  const candidateText = candidates.map((c, i) => {
+    const safeContent = redactor ? redactor.redactText(c.content).text : c.content;
+    return `[${i + 1}] (id: ${c.id}, sim: ${c.similarity.toFixed(2)})
+  ${safeContent}`;
+  }).join("\n");
+  const userMessage = `New memory:
+  ${safeTrimmed}
+
+Existing memories (top ${candidates.length} by cosine):
+${candidateText}`;
+  let parsed;
+  try {
+    parsed = await callPortalJsonCompletion({
+      ...options.apiKey !== void 0 && { apiKey: options.apiKey },
+      ...options.getToken !== void 0 && { getToken: options.getToken },
+      ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+      model: options.model ?? DEFAULT_MODEL,
+      systemPrompt: SYSTEM_PROMPT,
+      userMessage,
+      tag: "memory/consolidate",
+      // Retry TRANSIENT failures only (network/timeout/5xx/429/empty) before
+      // degrading to create — a transient blip would otherwise leave a
+      // permanent below-floor paraphrase that never self-heals (see
+      // DEFAULT_CONSOLIDATE_ATTEMPTS). The happy path still resolves in one
+      // attempt; terminal failures (400/auth) and schema violations never
+      // retry. A total budget keeps a hanging portal from stalling retain.
+      maxAttempts: options.maxAttempts ?? DEFAULT_CONSOLIDATE_ATTEMPTS,
+      totalTimeoutMs: options.totalTimeoutMs ?? DEFAULT_CONSOLIDATE_TOTAL_TIMEOUT_MS,
+      ...options.backoffMs && { backoffMs: options.backoffMs },
+      ...options.fetchFn && { fetchFn: options.fetchFn }
+    });
+  } catch (err) {
+    return degrade("llm_error", fallback, options, err);
+  }
+  if (parsed === null) return degrade("llm_error", fallback, options);
+  const validIds = new Set(candidates.map((c) => c.id));
+  const result = validate(parsed, trimmed, validIds);
+  if (!result) return degrade("invalid_response", fallback, options);
+  if (redactor && result.content !== void 0) {
+    const restored = redactor.restoreForStorage(result.content);
+    if (restored.unresolved) {
+      return degrade("invalid_response", fallback, options);
+    }
+    return { ...result, content: restored.text };
+  }
+  return result;
+}
+function degrade(reason, fallback, options, detail) {
+  if (detail !== void 0) {
+    getLogger().warn(`memory/consolidate: degraded to create (${reason})`, detail);
+  } else {
+    getLogger().warn(`memory/consolidate: degraded to create (${reason})`);
+  }
+  try {
+    options.onFallback?.(reason);
+  } catch {
+  }
+  return { ...fallback, fallbackReason: reason };
+}
+function validate(parsed, newContent, validIds) {
+  if (typeof parsed !== "object" || parsed === null) return null;
+  const obj = parsed;
+  const action = obj.action;
+  if (action !== "create" && action !== "update" && action !== "noop") return null;
+  if (action === "create") {
+    const c2 = typeof obj.content === "string" ? obj.content.trim() : "";
+    return { action: "create", content: c2.length > 0 ? c2 : newContent };
+  }
+  const targetId = typeof obj.targetId === "string" ? obj.targetId : null;
+  if (!targetId || !validIds.has(targetId)) return null;
+  if (action === "noop") {
+    return { action: "noop", targetId };
+  }
+  const c = typeof obj.content === "string" ? obj.content.trim() : "";
+  if (c.length === 0) return null;
+  return { action: "update", targetId, content: c };
+}
+export {
+  consolidateMemory
+};