@remnic/core 9.49.0 → 9.49.1

package/dist/{chunk-ICP53SKG.js → chunk-2HIJHXB3.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-AQEJKOKI.js";
 import {
   recordObjectiveStateSnapshot
-} from "./chunk-6HMYUWXR.js";
+} from "./chunk-HTP6XRUI.js";
 
 // src/objective-state-writers.ts
 import crypto from "crypto";
@@ -644,4 +644,4 @@ export {
   recordObjectiveStateSnapshotsFromAgentMessages,
   recordObjectiveStateSnapshotsFromObservedMessages
 };
-//# sourceMappingURL=chunk-ICP53SKG.js.map
+//# sourceMappingURL=chunk-2HIJHXB3.js.map

package/dist/{chunk-BXLOS5AJ.js → chunk-2NLLXCJG.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-765K3SAT.js";
 import {
   encryptCapsuleFile
-} from "./chunk-DQEMWVMT.js";
+} from "./chunk-X7Y7WX73.js";
 import {
   computeTransferOutputRel,
   isTransferPathExcluded
@@ -109,4 +109,4 @@ async function enforceRetention(outDirAbs, retentionDays) {
 export {
   backupMemoryDir
 };
-//# sourceMappingURL=chunk-BXLOS5AJ.js.map
+//# sourceMappingURL=chunk-2NLLXCJG.js.map

package/dist/{chunk-LZGCJSQR.js → chunk-3LD4N2TF.js}

@@ -6,7 +6,7 @@ import {
   headerConnector,
   renderExtractionConversation,
   resolveSourceConnector
-} from "./chunk-GVX3NAUU.js";
+} from "./chunk-ZDAYWJV6.js";
 import {
   ConsolidationResultSchema,
   DaySummaryResultSchema,
@@ -15,7 +15,7 @@ import {
   ProactiveExtractionResultSchema,
   ProactiveQuestionsResultSchema,
   buildProfileConsolidationResultSchema
-} from "./chunk-CMQZNEIF.js";
+} from "./chunk-WFLBP5GC.js";
 import {
   normalizeReasoningTrace
 } from "./chunk-54V4BZWP.js";
@@ -31,16 +31,23 @@ import {
 import {
   attachExtractionProvenance
 } from "./chunk-NK5RGJ65.js";
-import {
-  EXTRACTION_RESPONSE_PLACEHOLDERS,
-  EXTRACTION_RESPONSE_SHAPE,
-  buildExtractionInstructions,
-  eventTimePromptInstruction
-} from "./chunk-J7T4MX7P.js";
 import {
   classifyExtractionThrownError,
   classifyFallbackParseFailure
 } from "./chunk-BLDBT6HZ.js";
+import {
+  containsExtractionPlaceholder,
+  extractionAttributes,
+  extractionCueAnchors,
+  extractionText,
+  isPlainRecord
+} from "./chunk-AMTEYNYK.js";
+import {
+  CUE_ANCHOR_PROMPT_INSTRUCTION,
+  EXTRACTION_RESPONSE_SHAPE,
+  buildExtractionInstructions,
+  eventTimePromptInstruction
+} from "./chunk-EEAMSNSG.js";
 import {
   buildExtensionsFooterForSummary,
   formatDaySummaryMemories,
@@ -64,7 +71,7 @@ import {
 } from "./chunk-QDW3E4RD.js";
 import {
   isMemoryCategory
-} from "./chunk-CGASUJVP.js";
+} from "./chunk-5V6IXHPI.js";
 import {
   FallbackLlmClient,
   fallbackLlmRuntimeContextFromConfig,
@@ -92,6 +99,113 @@ import {
 
 // src/extraction.ts
 import OpenAI from "openai";
+
+// src/orchestration/dependency-revalidation.ts
+function isPlainRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function buildPrompt(superseded, replacement, dependents) {
+  const dependentPrompt = dependents.map(
+    (memory, index) => `[${index + 1}] id: ${memory.id} | category: ${memory.category}
+${memory.content}`
+  ).join("\n\n");
+  const input = `SUPERSEDED MEMORY (id: ${superseded.id}):
+${superseded.content}
+
+REPLACEMENT (id: ${replacement?.id ?? "none"}):
+${replacement?.content ?? "none \u2014 the memory was removed without replacement"}
+
+DEPENDENTS TO REVALIDATE (return exactly one verdict per id):
+${dependentPrompt}`;
+  const instructionText = `You revalidate dependent memory claims after a supporting memory changes.
+For each requested memory, decide whether its claim still holds.
+Return valid JSON only:
+{"verdicts":[{"memoryId":"id","verdict":"still_valid|invalidated|uncertain","reason":"brief reason"}]}
+Never invent memory IDs. Use "uncertain" when the evidence is insufficient.`;
+  return { input, instructionText };
+}
+function normalizeVerdicts(parsed, dependents) {
+  const raw = isPlainRecord2(parsed) && Array.isArray(parsed.verdicts) ? parsed.verdicts : [];
+  const requested = new Set(dependents.map((memory) => memory.id));
+  const seen = /* @__PURE__ */ new Set();
+  const normalized = [];
+  for (const candidate of raw) {
+    if (!isPlainRecord2(candidate)) continue;
+    const memoryId = typeof candidate.memoryId === "string" ? candidate.memoryId.trim() : "";
+    if (!requested.has(memoryId) || seen.has(memoryId)) continue;
+    seen.add(memoryId);
+    const verdict = candidate.verdict === "still_valid" || candidate.verdict === "invalidated" || candidate.verdict === "uncertain" ? candidate.verdict : "uncertain";
+    normalized.push({
+      memoryId,
+      verdict,
+      ...typeof candidate.reason === "string" ? { reason: candidate.reason } : {}
+    });
+  }
+  return dependents.map((memory) => {
+    const verdict = normalized.find((candidate) => candidate.memoryId === memory.id);
+    return verdict ?? { memoryId: memory.id, verdict: "uncertain" };
+  });
+}
+async function revalidateDependentsViaLlm(deps, superseded, replacement, dependents, signal) {
+  const { input, instructionText } = buildPrompt(superseded, replacement, dependents);
+  const maxTokens = Math.max(1024, dependents.length * 256);
+  let rawContent = null;
+  if (deps.shouldUseLocalLlm) {
+    try {
+      const response = await deps.localLlm.chatCompletion(
+        [
+          { role: "system", content: instructionText },
+          { role: "user", content: input }
+        ],
+        {
+          temperature: 0.2,
+          maxTokens,
+          operation: "dependency_revalidation",
+          priority: "background",
+          signal
+        }
+      );
+      rawContent = response?.content ?? null;
+      if (!rawContent && !deps.config.localLlmFallback) {
+        throw new Error("local LLM returned no dependency revalidation output");
+      }
+    } catch (error) {
+      if (!deps.config.localLlmFallback || signal?.aborted) throw error;
+    }
+  }
+  if (rawContent === null && !deps.shouldUseDirectClient) {
+    const response = await deps.fallbackLlm.chatCompletion(
+      [
+        { role: "system", content: instructionText },
+        { role: "user", content: input }
+      ],
+      deps.withGatewayAgent({ temperature: 0.2, maxTokens, signal })
+    );
+    rawContent = response?.content ?? null;
+    if (!rawContent) throw new Error("fallback LLM returned no dependency revalidation output");
+  }
+  if (rawContent === null && deps.shouldUseDirectClient) {
+    const chatClient = deps.client;
+    const response = await chatClient.chat.completions.create(
+      {
+        model: deps.config.model,
+        messages: [
+          { role: "system", content: instructionText },
+          { role: "user", content: input }
+        ],
+        max_tokens: maxTokens
+      },
+      { signal }
+    );
+    rawContent = response.choices?.[0]?.message?.content ?? null;
+    if (!rawContent?.trim()) {
+      throw new Error("direct client returned no dependency revalidation output");
+    }
+  }
+  return { verdicts: normalizeVerdicts(deps.parseJsonObject(rawContent), dependents) };
+}
+
+// src/extraction.ts
 var PROACTIVE_MIN_CONFIDENCE = 0.8;
 var CONSOLIDATION_RESPONSE_SCHEMA = `{
   "items": [
@@ -106,31 +220,6 @@ var CONSOLIDATION_RESPONSE_SCHEMA = `{
   "profileUpdates": ["optional profile update"],
   "entityUpdates": [{"name": "person-jane-doe", "type": "person", "facts": ["Now leads the backend team", "Recently migrated the user service to TypeScript"]}]
 }`;
-function isPlainRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function containsExtractionPlaceholder(value) {
-  if (typeof value === "string") return EXTRACTION_RESPONSE_PLACEHOLDERS[value.trim()] === true;
-  if (Array.isArray(value)) return value.some(containsExtractionPlaceholder);
-  return isPlainRecord(value) && Object.values(value).some(containsExtractionPlaceholder);
-}
-function extractionText(value) {
-  if (typeof value !== "string") return void 0;
-  const text = value.trim();
-  return text.length > 0 && !containsExtractionPlaceholder(text) ? text : void 0;
-}
-function extractionAttributes(value) {
-  if (!isPlainRecord(value)) return void 0;
-  const attributes = {};
-  for (const [key, candidate] of Object.entries(value)) {
-    const normalizedKey = extractionText(key);
-    const normalizedValue = extractionText(candidate);
-    if (normalizedKey !== void 0 && normalizedValue !== void 0) {
-      attributes[normalizedKey] = normalizedValue;
-    }
-  }
-  return Object.keys(attributes).length > 0 ? attributes : void 0;
-}
 function extractionEntityType(value) {
   const type = extractionText(value);
   if (type === "person" || type === "project" || type === "tool" || type === "company" || type === "place" || type === "other") {
@@ -251,9 +340,13 @@ var ExtractionEngine = class {
       if (resolvePipelineProcessingCapabilities(this.config).delinearize) {
         content = delinearize(content, result.entities, ts);
       }
-      return { ...fact, content };
+      return {
+        ...fact,
+        content,
+        cueAnchors: extractionCueAnchors(fact.cueAnchors)
+      };
     });
-    return { ...result, facts };
+    return { ...result, facts, episodeTitle: extractionText(result.episodeTitle) };
   }
   hasExtractionOutputs(result) {
     return result.facts.length > 0 || result.entities.length > 0 || result.questions.length > 0 || result.profileUpdates.length > 0 || (result.relationships?.length ?? 0) > 0;
@@ -282,6 +375,7 @@ var ExtractionEngine = class {
           return text === void 0 ? [] : [text];
         }) : [],
         entityRef: extractionText(f.entityRef),
+        cueAnchors: extractionCueAnchors(f.cueAnchors),
         promptedByQuestion: extractionText(f.promptedByQuestion),
         scope: f.scope === "global" || f.scope === "project" ? f.scope : void 0,
         structuredAttributes: extractionAttributes(f.structuredAttributes),
@@ -324,6 +418,7 @@ var ExtractionEngine = class {
       profileUpdates,
       questions,
       identityReflection: extractionText(parsed?.identityReflection),
+      episodeTitle: extractionText(parsed?.episodeTitle),
       relationships
     };
   }
@@ -1137,6 +1232,7 @@ Rules:
 - Use normalized, hyphenated entity names and keep the entity list short.
 - Keep facts standalone. Skip transient task state and operational noise such as routine scheduler, monitoring, or automation status.
 - Add structuredAttributes only for concrete values.
+${CUE_ANCHOR_PROMPT_INSTRUCTION}
 - Include at most five durable relationships.${this.config.provenance?.enabled ? `
 - Each fact must include a quote copied verbatim from one contiguous conversation span.` : ""}${lifecycleCaps.extractionScopeClassification ? `
 - Set each fact scope to "global" for cross-project knowledge or "project" for codebase-specific knowledge. Tool, command, or CLI-flag instructions tied to one agent are "project" (the same tool name can mean different things across agents); when keeping one, begin the fact with a leading "In <agent>," clause naming that agent.` : ""}${ambientCapture ? AMBIENT_CAPTURE_PROMPT_SECTION_COMPACT : ""}
@@ -2024,6 +2120,24 @@ Respond with valid JSON matching this schema:
       return null;
     }
   }
+  async revalidateDependents(superseded, replacement, dependents, signal) {
+    return revalidateDependentsViaLlm(
+      {
+        shouldUseLocalLlm: this.shouldUseLocalLlm,
+        shouldUseDirectClient: this.shouldUseDirectClient,
+        localLlm: this.localLlm,
+        fallbackLlm: this.fallbackLlm,
+        client: this.client,
+        config: this.config,
+        withGatewayAgent: this.withGatewayAgent.bind(this),
+        parseJsonObject: this.parseJsonObject
+      },
+      superseded,
+      replacement,
+      dependents,
+      signal
+    );
+  }
   /**
    * Suggest links between a new memory and existing memories (Phase 3A).
    * Called during extraction to build the knowledge graph.
@@ -2342,4 +2456,4 @@ export {
   shouldEnableLocalExtractionThinking,
   ExtractionEngine
 };
-//# sourceMappingURL=chunk-LZGCJSQR.js.map
+//# sourceMappingURL=chunk-3LD4N2TF.js.map