@remnic/core 9.69.38 → 9.69.40

package/dist/causal-consolidation.js

@@ -4,26 +4,26 @@ import {
 } from "./chunk-27MKMTBY.js";
 import {
   buildExtensionsBlockForConsolidation
-} from "./chunk-VMNCZ627.js";
+} from "./chunk-YTZN2UZO.js";
 import "./chunk-5JMAGU26.js";
 import "./chunk-B7RWBZXW.js";
 import {
   runPostConsolidationMaterialize
-} from "./chunk-R4VAUNNC.js";
+} from "./chunk-J4WGTN2N.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-V6EGNVUT.js";
-import "./chunk-7S53BPTU.js";
-import "./chunk-UHVXE24Y.js";
+import "./chunk-MVG3KXON.js";
 import "./chunk-46WM6JX2.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-BJEJUOGM.js";
-import "./chunk-OKO57IXB.js";
-import "./chunk-YQNNHLCG.js";
-import "./chunk-6KTXE6A3.js";
-import "./chunk-BD7JTBYP.js";
-import "./chunk-OB3XMWX5.js";
+import "./chunk-TZ44E732.js";
+import "./chunk-JOP7W24J.js";
 import "./chunk-CYEPCZN5.js";
-import "./chunk-TNSCIPBQ.js";
+import "./chunk-G6NQ3L4T.js";
+import "./chunk-WPGR3RW4.js";
+import "./chunk-6KTXE6A3.js";
+import "./chunk-D7MAYFQP.js";
+import "./chunk-KVO2BTA4.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
@@ -32,13 +32,13 @@ import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-PCEYGOSL.js";
-import "./chunk-IYKZJVL5.js";
+import "./chunk-MDIEES23.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-3N3PBBEH.js";
+import "./chunk-3XPN7AVY.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-SHEHQBCG.js";
 import "./chunk-3ONXXHQO.js";
@@ -52,8 +52,8 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-3CBI2ZSA.js";
-import "./chunk-JXN77SGO.js";
+import "./chunk-KG2OOAFF.js";
+import "./chunk-U2VDCFXW.js";
 import "./chunk-ZLQ37WJX.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-GDYU6VF4.js";
@@ -61,13 +61,14 @@ import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
 import {
-  FallbackLlmClient,
-  fallbackLlmRuntimeContextFromConfig
-} from "./chunk-LQNRVPTV.js";
+  FallbackLlmClient
+} from "./chunk-THTF2W7M.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
-import "./chunk-CWTCMZGE.js";
+import {
+  fallbackLlmRuntimeContextFromConfig
+} from "./chunk-KTOXQMW3.js";
 import "./chunk-E2AWJ7KQ.js";
 import "./chunk-236PXYG7.js";
 import "./chunk-ZCUTSMR2.js";

package/dist/causal-consolidation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/causal-consolidation.ts"],"sourcesContent":["/**\n * causal-consolidation.ts — CMC Phase 2: LLM-Assisted Causal Consolidation\n *\n * Uses an LLM to analyze causal trajectory patterns across sessions.\n * The LLM receives the causal chain graph as context — connected trajectories\n * from different sessions — and identifies recurring behavioral patterns,\n * preference signals, and actionable rules.\n *\n * This is the core CMC innovation: the LLM gets cross-session causal context\n * that no other memory system provides. It can see that a user investigated\n * a bug in session 1, attempted a fix in session 2, and succeeded in session 3 —\n * and synthesize a rule or preference from that chain.\n */\n\nimport { createHash } from \"node:crypto\";\nimport { resolveCausalTrajectoryStoreDir, type CausalTrajectoryRecord } from \"./causal-trajectory.js\";\nimport { readChainIndex, resolveChainsDir, type CausalChainIndex, type CausalEdge } from \"./causal-chain.js\";\nimport { listJsonFiles, readJsonFile } from \"./json-store.js\";\nimport { isRecord } from \"./store-contract.js\";\nimport { FallbackLlmClient, fallbackLlmRuntimeContextFromConfig } from \"./fallback-llm.js\";\nimport type { AgentPersonaModelConfig, GatewayConfig, MemoryFile, PluginConfig } from \"./types.js\";\nimport path from \"node:path\";\nimport { log } from \"./logger.js\";\nimport { runPostConsolidationMaterialize } from \"./connectors/codex-materialize-runner.js\";\nimport type { MaterializeResult, RolloutSummaryInput } from \"./connectors/codex-materialize.js\";\nimport { buildExtensionsBlockForConsolidation } from \"./semantic-consolidation.js\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface CausalPatternCandidate {\n  id: string;\n  sourceType: \"causal-pattern\";\n  subject: string;\n  category: \"principle\" | \"rule\" | \"preference\";\n  content: string;\n  score: number;\n  rationale: string;\n  outcome: null;\n  provenance: string[];\n  agent: string | null;\n  workflow: string | null;\n}\n\nexport interface ConsolidationConfig {\n  minRecurrence: number;\n  minSessions: number;\n  successThreshold: number;\n}\n\nexport interface LlmConsolidationResult {\n  rules: Array<{\n    content: string;\n    category: \"rule\" | \"principle\" | \"preference\";\n    confidence: number;\n    evidence: string[];\n  }>;\n  preferences: Array<{\n    statement: string;\n    confidence: number;\n    evidence: string[];\n  }>;\n}\n\nconst CAUSAL_RULE_CATEGORIES = new Set([\"rule\", \"principle\", \"preference\"]);\n\ninterface ConsolidationLlmClient {\n  isAvailable(options?: { agentId?: string; modelChain?: AgentPersonaModelConfig }): boolean;\n  chatCompletion(\n    messages: Array<{ role: \"system\" | \"user\" | \"assistant\"; content: string }>,\n    options?: { temperature?: number; maxTokens?: number; agentId?: string; modelChain?: AgentPersonaModelConfig },\n  ): Promise<{ content: string } | null>;\n}\n\n// ─── Trajectory Reading ──────────────────────────────────────────────────────\n\nasync function readAllTrajectories(\n  memoryDir: string,\n  causalTrajectoryStoreDir?: string,\n): Promise<CausalTrajectoryRecord[]> {\n  const root = resolveCausalTrajectoryStoreDir(memoryDir, causalTrajectoryStoreDir);\n  const trajectoriesDir = path.join(root, \"trajectories\");\n\n  const files = await listJsonFiles(trajectoriesDir).catch(() => [] as string[]);\n  const results: CausalTrajectoryRecord[] = [];\n\n  for (const filePath of files) {\n    try {\n      const raw = await readJsonFile(filePath);\n      if (isRecord(raw) && typeof raw.trajectoryId === \"string\") {\n        results.push(raw as unknown as CausalTrajectoryRecord);\n      }\n    } catch {\n      // skip invalid\n    }\n  }\n\n  return results;\n}\n\n// ─── Context Formatting ──────────────────────────────────────────────────────\n\n/**\n * Format trajectories and their causal connections as a readable context\n * for the LLM. Groups by session and shows chain connections.\n */\nfunction formatCausalContext(\n  trajectories: CausalTrajectoryRecord[],\n  chainIndex: CausalChainIndex,\n  maxChars: number = 8000,\n): string {\n  // Group trajectories by session\n  const bySession = new Map<string, CausalTrajectoryRecord[]>();\n  for (const t of trajectories) {\n    const list = bySession.get(t.sessionKey) ?? [];\n    list.push(t);\n    bySession.set(t.sessionKey, list);\n  }\n\n  const lines: string[] = [];\n  lines.push(`## Causal Trajectories (${trajectories.length} across ${bySession.size} sessions)`);\n  lines.push(\"\");\n\n  // Format each session's trajectories\n  for (const [sessionKey, sessionTrajs] of bySession) {\n    lines.push(`### Session: ${sessionKey}`);\n    for (const t of sessionTrajs.slice(0, 5)) {\n      const outcome = t.outcomeKind === \"success\" ? \"+\" : t.outcomeKind === \"failure\" ? \"-\" : \"~\";\n      lines.push(`[${outcome}] Goal: ${t.goal}`);\n      lines.push(`    Action: ${t.actionSummary}`);\n      lines.push(`    Outcome: ${t.outcomeSummary}`);\n      if (t.followUpSummary) lines.push(`    Follow-up: ${t.followUpSummary}`);\n      if (t.entityRefs?.length) lines.push(`    Entities: ${t.entityRefs.join(\", \")}`);\n    }\n    lines.push(\"\");\n  }\n\n  // Format causal chain connections\n  const edgeCount = Object.keys(chainIndex.edges).length;\n  if (edgeCount > 0) {\n    lines.push(`## Cross-Session Causal Chains (${edgeCount} connections)`);\n    lines.push(\"\");\n\n    const trajectoryMap = new Map(trajectories.map((t) => [t.trajectoryId, t]));\n    const shown = new Set<string>();\n\n    for (const [edgeId, edge] of Object.entries(chainIndex.edges)) {\n      if (shown.size >= 10) break; // limit output size\n      const from = trajectoryMap.get(edge.fromTrajectoryId);\n      const to = trajectoryMap.get(edge.toTrajectoryId);\n      if (!from || !to) continue;\n\n      lines.push(`${edge.edgeType}: \"${from.goal}\" (${from.sessionKey}) → \"${to.goal}\" (${to.sessionKey})`);\n      shown.add(edgeId);\n    }\n    lines.push(\"\");\n  }\n\n  const result = lines.join(\"\\n\");\n  return result.length > maxChars ? result.slice(0, maxChars) + \"\\n[truncated]\" : result;\n}\n\n// ─── LLM Consolidation ──────────────────────────────────────────────────────\n\nconst CONSOLIDATION_PROMPT = `You are analyzing a user's causal trajectory history across multiple sessions. Trajectories record what the user tried to do (goal), what they did (action), and what happened (outcome).\n\nYour job is to identify:\n1. BEHAVIORAL RULES: Recurring patterns where the same approach consistently succeeds or fails. These should be actionable guidance for future sessions.\n2. PREFERENCES: What the user cares about, prefers, or consistently chooses — even if never explicitly stated. Infer preferences from what they repeatedly do, retry until successful, or always include in their workflow.\n\nIMPORTANT:\n- Look for CROSS-SESSION patterns — things that repeat across different sessions are more significant than within-session patterns.\n- A user who retries the same goal across sessions has a strong implicit preference for that outcome.\n- Consistent action choices reveal preferences even when the user never says \"I prefer X.\"\n- Frame preferences as \"The user would prefer responses that...\" when applicable.\n\nOutput valid JSON only:\n{\n  \"rules\": [\n    {\"content\": \"actionable rule text\", \"category\": \"rule|principle\", \"confidence\": 0.0-1.0, \"evidence\": [\"trajectory IDs\"]}\n  ],\n  \"preferences\": [\n    {\"statement\": \"The user would prefer...\", \"confidence\": 0.0-1.0, \"evidence\": [\"trajectory IDs\"]}\n  ]\n}\n\nIf no clear patterns exist, return {\"rules\": [], \"preferences\": []}.`;\n\nasync function consolidateWithLlm(\n  context: string,\n  llm: ConsolidationLlmClient,\n  options: { agentId?: string; modelChain?: AgentPersonaModelConfig } = {},\n): Promise<LlmConsolidationResult> {\n  const response = await llm.chatCompletion(\n    [\n      { role: \"system\", content: CONSOLIDATION_PROMPT },\n      { role: \"user\", content: context },\n    ],\n    { temperature: 0.2, maxTokens: 2000, agentId: options.agentId, modelChain: options.modelChain },\n  );\n\n  if (!response?.content) {\n    return { rules: [], preferences: [] };\n  }\n\n  try {\n    // Extract JSON from response (may have markdown code fences)\n    let jsonStr = response.content.trim();\n    const fenceMatch = jsonStr.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```/);\n    if (fenceMatch) jsonStr = fenceMatch[1];\n\n    const parsed = JSON.parse(jsonStr);\n    const rawRules: unknown[] = Array.isArray(parsed.rules) ? parsed.rules : [];\n    const rawPreferences: unknown[] = Array.isArray(parsed.preferences) ? parsed.preferences : [];\n    return {\n      rules: rawRules\n        .map(parseLlmRule)\n        .filter((rule): rule is LlmConsolidationResult[\"rules\"][number] => !!rule),\n      preferences: rawPreferences\n        .map(parseLlmPreference)\n        .filter((pref): pref is LlmConsolidationResult[\"preferences\"][number] => !!pref),\n    };\n  } catch {\n    log.warn(\"[cmc] failed to parse LLM consolidation response\");\n    return { rules: [], preferences: [] };\n  }\n}\n\n// ─── Candidate Generation ────────────────────────────────────────────────────\n\nfunction stablePatternId(content: string): string {\n  const digest = createHash(\"sha256\")\n    .update(`causal-pattern\\0${content}`)\n    .digest(\"hex\")\n    .slice(0, 16);\n  return `causal-pattern:${digest}`;\n}\n\nfunction parseConfidence(value: unknown): number | undefined {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return undefined;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction parseEvidence(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.filter((item): item is string => typeof item === \"string\" && item.trim().length > 0);\n}\n\nfunction parseLlmRule(raw: unknown): LlmConsolidationResult[\"rules\"][number] | undefined {\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n  const r = raw as Record<string, unknown>;\n  const content = typeof r.content === \"string\" ? r.content.trim() : \"\";\n  const category = typeof r.category === \"string\" ? r.category : \"\";\n  const confidence = parseConfidence(r.confidence);\n  if (content.length <= 5 || !CAUSAL_RULE_CATEGORIES.has(category) || confidence === undefined) {\n    return undefined;\n  }\n  return {\n    content,\n    category: category as \"rule\" | \"principle\" | \"preference\",\n    confidence,\n    evidence: parseEvidence(r.evidence),\n  };\n}\n\nfunction parseLlmPreference(raw: unknown): LlmConsolidationResult[\"preferences\"][number] | undefined {\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n  const p = raw as Record<string, unknown>;\n  const statement = typeof p.statement === \"string\" ? p.statement.trim() : \"\";\n  const confidence = parseConfidence(p.confidence);\n  if (statement.length <= 5 || confidence === undefined) return undefined;\n  return {\n    statement,\n    confidence,\n    evidence: parseEvidence(p.evidence),\n  };\n}\n\nfunction llmResultToCandidates(result: LlmConsolidationResult): CausalPatternCandidate[] {\n  const candidates: CausalPatternCandidate[] = [];\n\n  for (const rule of result.rules) {\n    const category =\n      rule.category === \"principle\" || rule.category === \"preference\"\n        ? rule.category\n        : \"rule\";\n    candidates.push({\n      id: stablePatternId(rule.content),\n      sourceType: \"causal-pattern\",\n      subject: rule.content.slice(0, 80),\n      category,\n      content: rule.content,\n      score: Math.min(1, rule.confidence ?? 0.7),\n      rationale: \"LLM-identified causal pattern from cross-session trajectory analysis\",\n      outcome: null,\n      provenance: (rule.evidence ?? []).slice(0, 5),\n      agent: null,\n      workflow: null,\n    });\n  }\n\n  for (const preference of result.preferences) {\n    candidates.push({\n      id: stablePatternId(preference.statement),\n      sourceType: \"causal-pattern\",\n      subject: preference.statement.slice(0, 80),\n      category: \"preference\",\n      content: preference.statement,\n      score: Math.min(1, preference.confidence ?? 0.7),\n      rationale: \"LLM-identified preference from cross-session trajectory analysis\",\n      outcome: null,\n      provenance: (preference.evidence ?? []).slice(0, 5),\n      agent: null,\n      workflow: null,\n    });\n  }\n\n  return candidates;\n}\n\nfunction normalizePositiveInteger(value: number, fallback: number): number {\n  return Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;\n}\n\nfunction normalizeSuccessThreshold(value: number): number {\n  if (!Number.isFinite(value) || value <= 0) return 0;\n  return Math.min(1, value);\n}\n\nfunction trajectorySuccessScore(trajectory: CausalTrajectoryRecord): number {\n  if (trajectory.outcomeKind === \"success\") return 1;\n  if (trajectory.outcomeKind === \"partial\") return 0.5;\n  return 0;\n}\n\nfunction averageSuccessScore(trajectories: CausalTrajectoryRecord[]): number {\n  if (trajectories.length === 0) return 0;\n  const total = trajectories.reduce((sum, trajectory) => sum + trajectorySuccessScore(trajectory), 0);\n  return total / trajectories.length;\n}\n\nfunction passesConsolidationGates(\n  trajectories: CausalTrajectoryRecord[],\n  config: ConsolidationConfig,\n): boolean {\n  const minRecurrence = normalizePositiveInteger(config.minRecurrence, 1);\n  if (trajectories.length < minRecurrence) return false;\n\n  const minSessions = normalizePositiveInteger(config.minSessions, 1);\n  const sessionCount = new Set(trajectories.map((trajectory) => trajectory.sessionKey)).size;\n  if (sessionCount < minSessions) return false;\n\n  const successThreshold = normalizeSuccessThreshold(config.successThreshold);\n  if (successThreshold > 0 && averageSuccessScore(trajectories) < successThreshold) {\n    return false;\n  }\n\n  return true;\n}\n\n// ─── Public API ──────────────────────────────────────────────────────────────\n\n/**\n * Run LLM-assisted consolidation: read trajectories, format causal context,\n * ask LLM to identify patterns and preferences.\n */\nexport async function deriveCausalPromotionCandidates(options: {\n  memoryDir: string;\n  causalTrajectoryStoreDir?: string;\n  config: ConsolidationConfig;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  pluginConfig?: PluginConfig;\n  llmClient?: ConsolidationLlmClient;\n}): Promise<CausalPatternCandidate[]> {\n  try {\n    const trajectories = await readAllTrajectories(options.memoryDir, options.causalTrajectoryStoreDir);\n    if (!passesConsolidationGates(trajectories, options.config)) return [];\n\n    const chainsDir = resolveChainsDir(options.memoryDir, options.causalTrajectoryStoreDir);\n    const chainIndex = await readChainIndex(chainsDir);\n\n    // Format the causal context for the LLM\n    let context = formatCausalContext(trajectories, chainIndex);\n\n    // Append memory extensions block if available (#382)\n    if (options.pluginConfig) {\n      const extBlock = await buildExtensionsBlockForConsolidation(options.pluginConfig);\n      if (extBlock.length > 0) {\n        context += \"\\n\\n\" + extBlock;\n      }\n    }\n\n    // If no LLM available, fall back to empty (no deterministic fallback)\n    const llm = options.llmClient ?? new FallbackLlmClient(\n      options.gatewayConfig,\n      options.pluginConfig\n        ? fallbackLlmRuntimeContextFromConfig(options.pluginConfig, {\n            workspaceDir: options.workspaceDir ?? options.pluginConfig.workspaceDir,\n          })\n        : { workspaceDir: options.workspaceDir },\n    );\n    const llmOptions = { agentId: options.gatewayAgentId, modelChain: options.modelChain };\n    if (!llm.isAvailable(llmOptions)) {\n      log.debug(\"[cmc] no LLM available for consolidation — skipping\");\n      return [];\n    }\n\n    // Call LLM for pattern analysis\n    const result = await consolidateWithLlm(context, llm, llmOptions);\n    const candidates = llmResultToCandidates(result);\n\n    log.debug(`[cmc] LLM consolidation produced ${candidates.length} rule(s) and ${result.preferences.length} preference(s)`);\n    return candidates;\n  } catch (error) {\n    log.warn(`[cmc] consolidation failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);\n    return [];\n  }\n}\n\n/**\n * Get LLM-synthesized preferences from causal trajectory analysis.\n * Returns formatted preference statements for recall injection.\n */\nexport async function synthesizeCausalPreferencesViaLlm(options: {\n  memoryDir: string;\n  causalTrajectoryStoreDir?: string;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  minTrajectories?: number;\n}): Promise<string | null> {\n  try {\n    const trajectories = await readAllTrajectories(options.memoryDir, options.causalTrajectoryStoreDir);\n    if (trajectories.length < (options.minTrajectories ?? 2)) return null;\n\n    const chainsDir = resolveChainsDir(options.memoryDir, options.causalTrajectoryStoreDir);\n    const chainIndex = await readChainIndex(chainsDir);\n    const context = formatCausalContext(trajectories, chainIndex);\n\n    const llm = new FallbackLlmClient(options.gatewayConfig, {\n      workspaceDir: options.workspaceDir,\n    });\n    const llmOptions = { agentId: options.gatewayAgentId, modelChain: options.modelChain };\n    if (!llm.isAvailable(llmOptions)) return null;\n\n    const result = await consolidateWithLlm(context, llm, llmOptions);\n    if (result.preferences.length === 0 && result.rules.length === 0) return null;\n\n    const lines: string[] = [\"## Behavioral Insights (from Causal Chain Analysis)\", \"\"];\n\n    for (const pref of result.preferences) {\n      lines.push(`- ${pref.statement}`);\n    }\n\n    for (const rule of result.rules) {\n      lines.push(`- ${rule.content}`);\n    }\n\n    lines.push(\"\");\n    return lines.join(\"\\n\");\n  } catch (error) {\n    log.warn(`[cmc] preference synthesis failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);\n    return null;\n  }\n}\n\n/**\n * Optional post-consolidation hook — materializes Codex-native memory artifacts\n * after a causal consolidation run. Guarded by `codexMaterializeMemories` and\n * `codexMaterializeOnConsolidation`. Returns `null` when disabled or when the\n * sentinel is missing (honors user hand-edits).\n *\n * Split from the orchestrator-owned flow so #378 avoids touching\n * orchestrator.ts while Wave 1 edits are in flight.\n */\nexport async function materializeAfterCausalConsolidation(options: {\n  config: PluginConfig;\n  namespace?: string;\n  memories?: MemoryFile[];\n  memoryDir?: string;\n  codexHome?: string;\n  rolloutSummaries?: RolloutSummaryInput[];\n  now?: Date;\n}): Promise<MaterializeResult | null> {\n  // Delegates to the shared post-consolidation helper — see\n  // runPostConsolidationMaterialize in codex-materialize-runner.ts.\n  return runPostConsolidationMaterialize(\"[cmc]\", options);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/causal-consolidation.ts"],"sourcesContent":["/**\n * causal-consolidation.ts — CMC Phase 2: LLM-Assisted Causal Consolidation\n *\n * Uses an LLM to analyze causal trajectory patterns across sessions.\n * The LLM receives the causal chain graph as context — connected trajectories\n * from different sessions — and identifies recurring behavioral patterns,\n * preference signals, and actionable rules.\n *\n * This is the core CMC innovation: the LLM gets cross-session causal context\n * that no other memory system provides. It can see that a user investigated\n * a bug in session 1, attempted a fix in session 2, and succeeded in session 3 —\n * and synthesize a rule or preference from that chain.\n */\n\nimport { createHash } from \"node:crypto\";\nimport { resolveCausalTrajectoryStoreDir, type CausalTrajectoryRecord } from \"./causal-trajectory.js\";\nimport { readChainIndex, resolveChainsDir, type CausalChainIndex, type CausalEdge } from \"./causal-chain.js\";\nimport { listJsonFiles, readJsonFile } from \"./json-store.js\";\nimport { isRecord } from \"./store-contract.js\";\nimport { FallbackLlmClient, fallbackLlmRuntimeContextFromConfig } from \"./fallback-llm.js\";\nimport type { AgentPersonaModelConfig, GatewayConfig, MemoryFile, PluginConfig } from \"./types.js\";\nimport path from \"node:path\";\nimport { log } from \"./logger.js\";\nimport { runPostConsolidationMaterialize } from \"./connectors/codex-materialize-runner.js\";\nimport type { MaterializeResult, RolloutSummaryInput } from \"./connectors/codex-materialize.js\";\nimport { buildExtensionsBlockForConsolidation } from \"./semantic-consolidation.js\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface CausalPatternCandidate {\n  id: string;\n  sourceType: \"causal-pattern\";\n  subject: string;\n  category: \"principle\" | \"rule\" | \"preference\";\n  content: string;\n  score: number;\n  rationale: string;\n  outcome: null;\n  provenance: string[];\n  agent: string | null;\n  workflow: string | null;\n}\n\nexport interface ConsolidationConfig {\n  minRecurrence: number;\n  minSessions: number;\n  successThreshold: number;\n}\n\nexport interface LlmConsolidationResult {\n  rules: Array<{\n    content: string;\n    category: \"rule\" | \"principle\" | \"preference\";\n    confidence: number;\n    evidence: string[];\n  }>;\n  preferences: Array<{\n    statement: string;\n    confidence: number;\n    evidence: string[];\n  }>;\n}\n\nconst CAUSAL_RULE_CATEGORIES = new Set([\"rule\", \"principle\", \"preference\"]);\n\ninterface ConsolidationLlmClient {\n  isAvailable(options?: { agentId?: string; modelChain?: AgentPersonaModelConfig }): boolean;\n  chatCompletion(\n    messages: Array<{ role: \"system\" | \"user\" | \"assistant\"; content: string }>,\n    options?: { temperature?: number; maxTokens?: number; agentId?: string; modelChain?: AgentPersonaModelConfig },\n  ): Promise<{ content: string } | null>;\n}\n\n// ─── Trajectory Reading ──────────────────────────────────────────────────────\n\nasync function readAllTrajectories(\n  memoryDir: string,\n  causalTrajectoryStoreDir?: string,\n): Promise<CausalTrajectoryRecord[]> {\n  const root = resolveCausalTrajectoryStoreDir(memoryDir, causalTrajectoryStoreDir);\n  const trajectoriesDir = path.join(root, \"trajectories\");\n\n  const files = await listJsonFiles(trajectoriesDir).catch(() => [] as string[]);\n  const results: CausalTrajectoryRecord[] = [];\n\n  for (const filePath of files) {\n    try {\n      const raw = await readJsonFile(filePath);\n      if (isRecord(raw) && typeof raw.trajectoryId === \"string\") {\n        results.push(raw as unknown as CausalTrajectoryRecord);\n      }\n    } catch {\n      // skip invalid\n    }\n  }\n\n  return results;\n}\n\n// ─── Context Formatting ──────────────────────────────────────────────────────\n\n/**\n * Format trajectories and their causal connections as a readable context\n * for the LLM. Groups by session and shows chain connections.\n */\nfunction formatCausalContext(\n  trajectories: CausalTrajectoryRecord[],\n  chainIndex: CausalChainIndex,\n  maxChars: number = 8000,\n): string {\n  // Group trajectories by session\n  const bySession = new Map<string, CausalTrajectoryRecord[]>();\n  for (const t of trajectories) {\n    const list = bySession.get(t.sessionKey) ?? [];\n    list.push(t);\n    bySession.set(t.sessionKey, list);\n  }\n\n  const lines: string[] = [];\n  lines.push(`## Causal Trajectories (${trajectories.length} across ${bySession.size} sessions)`);\n  lines.push(\"\");\n\n  // Format each session's trajectories\n  for (const [sessionKey, sessionTrajs] of bySession) {\n    lines.push(`### Session: ${sessionKey}`);\n    for (const t of sessionTrajs.slice(0, 5)) {\n      const outcome = t.outcomeKind === \"success\" ? \"+\" : t.outcomeKind === \"failure\" ? \"-\" : \"~\";\n      lines.push(`[${outcome}] Goal: ${t.goal}`);\n      lines.push(`    Action: ${t.actionSummary}`);\n      lines.push(`    Outcome: ${t.outcomeSummary}`);\n      if (t.followUpSummary) lines.push(`    Follow-up: ${t.followUpSummary}`);\n      if (t.entityRefs?.length) lines.push(`    Entities: ${t.entityRefs.join(\", \")}`);\n    }\n    lines.push(\"\");\n  }\n\n  // Format causal chain connections\n  const edgeCount = Object.keys(chainIndex.edges).length;\n  if (edgeCount > 0) {\n    lines.push(`## Cross-Session Causal Chains (${edgeCount} connections)`);\n    lines.push(\"\");\n\n    const trajectoryMap = new Map(trajectories.map((t) => [t.trajectoryId, t]));\n    const shown = new Set<string>();\n\n    for (const [edgeId, edge] of Object.entries(chainIndex.edges)) {\n      if (shown.size >= 10) break; // limit output size\n      const from = trajectoryMap.get(edge.fromTrajectoryId);\n      const to = trajectoryMap.get(edge.toTrajectoryId);\n      if (!from || !to) continue;\n\n      lines.push(`${edge.edgeType}: \"${from.goal}\" (${from.sessionKey}) → \"${to.goal}\" (${to.sessionKey})`);\n      shown.add(edgeId);\n    }\n    lines.push(\"\");\n  }\n\n  const result = lines.join(\"\\n\");\n  return result.length > maxChars ? result.slice(0, maxChars) + \"\\n[truncated]\" : result;\n}\n\n// ─── LLM Consolidation ──────────────────────────────────────────────────────\n\nconst CONSOLIDATION_PROMPT = `You are analyzing a user's causal trajectory history across multiple sessions. Trajectories record what the user tried to do (goal), what they did (action), and what happened (outcome).\n\nYour job is to identify:\n1. BEHAVIORAL RULES: Recurring patterns where the same approach consistently succeeds or fails. These should be actionable guidance for future sessions.\n2. PREFERENCES: What the user cares about, prefers, or consistently chooses — even if never explicitly stated. Infer preferences from what they repeatedly do, retry until successful, or always include in their workflow.\n\nIMPORTANT:\n- Look for CROSS-SESSION patterns — things that repeat across different sessions are more significant than within-session patterns.\n- A user who retries the same goal across sessions has a strong implicit preference for that outcome.\n- Consistent action choices reveal preferences even when the user never says \"I prefer X.\"\n- Frame preferences as \"The user would prefer responses that...\" when applicable.\n\nOutput valid JSON only:\n{\n  \"rules\": [\n    {\"content\": \"actionable rule text\", \"category\": \"rule|principle\", \"confidence\": 0.0-1.0, \"evidence\": [\"trajectory IDs\"]}\n  ],\n  \"preferences\": [\n    {\"statement\": \"The user would prefer...\", \"confidence\": 0.0-1.0, \"evidence\": [\"trajectory IDs\"]}\n  ]\n}\n\nIf no clear patterns exist, return {\"rules\": [], \"preferences\": []}.`;\n\nasync function consolidateWithLlm(\n  context: string,\n  llm: ConsolidationLlmClient,\n  options: { agentId?: string; modelChain?: AgentPersonaModelConfig } = {},\n): Promise<LlmConsolidationResult> {\n  const response = await llm.chatCompletion(\n    [\n      { role: \"system\", content: CONSOLIDATION_PROMPT },\n      { role: \"user\", content: context },\n    ],\n    { temperature: 0.2, maxTokens: 2000, agentId: options.agentId, modelChain: options.modelChain },\n  );\n\n  if (!response?.content) {\n    return { rules: [], preferences: [] };\n  }\n\n  try {\n    // Extract JSON from response (may have markdown code fences)\n    let jsonStr = response.content.trim();\n    const fenceMatch = jsonStr.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```/);\n    if (fenceMatch) jsonStr = fenceMatch[1];\n\n    const parsed = JSON.parse(jsonStr);\n    const rawRules: unknown[] = Array.isArray(parsed.rules) ? parsed.rules : [];\n    const rawPreferences: unknown[] = Array.isArray(parsed.preferences) ? parsed.preferences : [];\n    return {\n      rules: rawRules\n        .map(parseLlmRule)\n        .filter((rule): rule is LlmConsolidationResult[\"rules\"][number] => !!rule),\n      preferences: rawPreferences\n        .map(parseLlmPreference)\n        .filter((pref): pref is LlmConsolidationResult[\"preferences\"][number] => !!pref),\n    };\n  } catch {\n    log.warn(\"[cmc] failed to parse LLM consolidation response\");\n    return { rules: [], preferences: [] };\n  }\n}\n\n// ─── Candidate Generation ────────────────────────────────────────────────────\n\nfunction stablePatternId(content: string): string {\n  const digest = createHash(\"sha256\")\n    .update(`causal-pattern\\0${content}`)\n    .digest(\"hex\")\n    .slice(0, 16);\n  return `causal-pattern:${digest}`;\n}\n\nfunction parseConfidence(value: unknown): number | undefined {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return undefined;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction parseEvidence(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.filter((item): item is string => typeof item === \"string\" && item.trim().length > 0);\n}\n\nfunction parseLlmRule(raw: unknown): LlmConsolidationResult[\"rules\"][number] | undefined {\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n  const r = raw as Record<string, unknown>;\n  const content = typeof r.content === \"string\" ? r.content.trim() : \"\";\n  const category = typeof r.category === \"string\" ? r.category : \"\";\n  const confidence = parseConfidence(r.confidence);\n  if (content.length <= 5 || !CAUSAL_RULE_CATEGORIES.has(category) || confidence === undefined) {\n    return undefined;\n  }\n  return {\n    content,\n    category: category as \"rule\" | \"principle\" | \"preference\",\n    confidence,\n    evidence: parseEvidence(r.evidence),\n  };\n}\n\nfunction parseLlmPreference(raw: unknown): LlmConsolidationResult[\"preferences\"][number] | undefined {\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n  const p = raw as Record<string, unknown>;\n  const statement = typeof p.statement === \"string\" ? p.statement.trim() : \"\";\n  const confidence = parseConfidence(p.confidence);\n  if (statement.length <= 5 || confidence === undefined) return undefined;\n  return {\n    statement,\n    confidence,\n    evidence: parseEvidence(p.evidence),\n  };\n}\n\nfunction llmResultToCandidates(result: LlmConsolidationResult): CausalPatternCandidate[] {\n  const candidates: CausalPatternCandidate[] = [];\n\n  for (const rule of result.rules) {\n    const category =\n      rule.category === \"principle\" || rule.category === \"preference\"\n        ? rule.category\n        : \"rule\";\n    candidates.push({\n      id: stablePatternId(rule.content),\n      sourceType: \"causal-pattern\",\n      subject: rule.content.slice(0, 80),\n      category,\n      content: rule.content,\n      score: Math.min(1, rule.confidence ?? 0.7),\n      rationale: \"LLM-identified causal pattern from cross-session trajectory analysis\",\n      outcome: null,\n      provenance: (rule.evidence ?? []).slice(0, 5),\n      agent: null,\n      workflow: null,\n    });\n  }\n\n  for (const preference of result.preferences) {\n    candidates.push({\n      id: stablePatternId(preference.statement),\n      sourceType: \"causal-pattern\",\n      subject: preference.statement.slice(0, 80),\n      category: \"preference\",\n      content: preference.statement,\n      score: Math.min(1, preference.confidence ?? 0.7),\n      rationale: \"LLM-identified preference from cross-session trajectory analysis\",\n      outcome: null,\n      provenance: (preference.evidence ?? []).slice(0, 5),\n      agent: null,\n      workflow: null,\n    });\n  }\n\n  return candidates;\n}\n\nfunction normalizePositiveInteger(value: number, fallback: number): number {\n  return Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;\n}\n\nfunction normalizeSuccessThreshold(value: number): number {\n  if (!Number.isFinite(value) || value <= 0) return 0;\n  return Math.min(1, value);\n}\n\nfunction trajectorySuccessScore(trajectory: CausalTrajectoryRecord): number {\n  if (trajectory.outcomeKind === \"success\") return 1;\n  if (trajectory.outcomeKind === \"partial\") return 0.5;\n  return 0;\n}\n\nfunction averageSuccessScore(trajectories: CausalTrajectoryRecord[]): number {\n  if (trajectories.length === 0) return 0;\n  const total = trajectories.reduce((sum, trajectory) => sum + trajectorySuccessScore(trajectory), 0);\n  return total / trajectories.length;\n}\n\nfunction passesConsolidationGates(\n  trajectories: CausalTrajectoryRecord[],\n  config: ConsolidationConfig,\n): boolean {\n  const minRecurrence = normalizePositiveInteger(config.minRecurrence, 1);\n  if (trajectories.length < minRecurrence) return false;\n\n  const minSessions = normalizePositiveInteger(config.minSessions, 1);\n  const sessionCount = new Set(trajectories.map((trajectory) => trajectory.sessionKey)).size;\n  if (sessionCount < minSessions) return false;\n\n  const successThreshold = normalizeSuccessThreshold(config.successThreshold);\n  if (successThreshold > 0 && averageSuccessScore(trajectories) < successThreshold) {\n    return false;\n  }\n\n  return true;\n}\n\n// ─── Public API ──────────────────────────────────────────────────────────────\n\n/**\n * Run LLM-assisted consolidation: read trajectories, format causal context,\n * ask LLM to identify patterns and preferences.\n */\nexport async function deriveCausalPromotionCandidates(options: {\n  memoryDir: string;\n  causalTrajectoryStoreDir?: string;\n  config: ConsolidationConfig;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  pluginConfig?: PluginConfig;\n  llmClient?: ConsolidationLlmClient;\n}): Promise<CausalPatternCandidate[]> {\n  try {\n    const trajectories = await readAllTrajectories(options.memoryDir, options.causalTrajectoryStoreDir);\n    if (!passesConsolidationGates(trajectories, options.config)) return [];\n\n    const chainsDir = resolveChainsDir(options.memoryDir, options.causalTrajectoryStoreDir);\n    const chainIndex = await readChainIndex(chainsDir);\n\n    // Format the causal context for the LLM\n    let context = formatCausalContext(trajectories, chainIndex);\n\n    // Append memory extensions block if available (#382)\n    if (options.pluginConfig) {\n      const extBlock = await buildExtensionsBlockForConsolidation(options.pluginConfig);\n      if (extBlock.length > 0) {\n        context += \"\\n\\n\" + extBlock;\n      }\n    }\n\n    // If no LLM available, fall back to empty (no deterministic fallback)\n    const llm = options.llmClient ?? new FallbackLlmClient(\n      options.gatewayConfig,\n      options.pluginConfig\n        ? fallbackLlmRuntimeContextFromConfig(options.pluginConfig, {\n            workspaceDir: options.workspaceDir ?? options.pluginConfig.workspaceDir,\n          })\n        : { workspaceDir: options.workspaceDir },\n    );\n    const llmOptions = { agentId: options.gatewayAgentId, modelChain: options.modelChain };\n    if (!llm.isAvailable(llmOptions)) {\n      log.debug(\"[cmc] no LLM available for consolidation — skipping\");\n      return [];\n    }\n\n    // Call LLM for pattern analysis\n    const result = await consolidateWithLlm(context, llm, llmOptions);\n    const candidates = llmResultToCandidates(result);\n\n    log.debug(`[cmc] LLM consolidation produced ${candidates.length} rule(s) and ${result.preferences.length} preference(s)`);\n    return candidates;\n  } catch (error) {\n    log.warn(`[cmc] consolidation failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);\n    return [];\n  }\n}\n\n/**\n * Get LLM-synthesized preferences from causal trajectory analysis.\n * Returns formatted preference statements for recall injection.\n */\nexport async function synthesizeCausalPreferencesViaLlm(options: {\n  memoryDir: string;\n  causalTrajectoryStoreDir?: string;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  minTrajectories?: number;\n}): Promise<string | null> {\n  try {\n    const trajectories = await readAllTrajectories(options.memoryDir, options.causalTrajectoryStoreDir);\n    if (trajectories.length < (options.minTrajectories ?? 2)) return null;\n\n    const chainsDir = resolveChainsDir(options.memoryDir, options.causalTrajectoryStoreDir);\n    const chainIndex = await readChainIndex(chainsDir);\n    const context = formatCausalContext(trajectories, chainIndex);\n\n    const llm = new FallbackLlmClient(options.gatewayConfig, {\n      workspaceDir: options.workspaceDir,\n    });\n    const llmOptions = { agentId: options.gatewayAgentId, modelChain: options.modelChain };\n    if (!llm.isAvailable(llmOptions)) return null;\n\n    const result = await consolidateWithLlm(context, llm, llmOptions);\n    if (result.preferences.length === 0 && result.rules.length === 0) return null;\n\n    const lines: string[] = [\"## Behavioral Insights (from Causal Chain Analysis)\", \"\"];\n\n    for (const pref of result.preferences) {\n      lines.push(`- ${pref.statement}`);\n    }\n\n    for (const rule of result.rules) {\n      lines.push(`- ${rule.content}`);\n    }\n\n    lines.push(\"\");\n    return lines.join(\"\\n\");\n  } catch (error) {\n    log.warn(`[cmc] preference synthesis failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);\n    return null;\n  }\n}\n\n/**\n * Optional post-consolidation hook — materializes Codex-native memory artifacts\n * after a causal consolidation run. Guarded by `codexMaterializeMemories` and\n * `codexMaterializeOnConsolidation`. Returns `null` when disabled or when the\n * sentinel is missing (honors user hand-edits).\n *\n * Split from the orchestrator-owned flow so #378 avoids touching\n * orchestrator.ts while Wave 1 edits are in flight.\n */\nexport async function materializeAfterCausalConsolidation(options: {\n  config: PluginConfig;\n  namespace?: string;\n  memories?: MemoryFile[];\n  memoryDir?: string;\n  codexHome?: string;\n  rolloutSummaries?: RolloutSummaryInput[];\n  now?: Date;\n}): Promise<MaterializeResult | null> {\n  // Delegates to the shared post-consolidation helper — see\n  // runPostConsolidationMaterialize in codex-materialize-runner.ts.\n  return runPostConsolidationMaterialize(\"[cmc]\", options);\n}\n"],"mappings":"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","names":[]}

package/dist/causal-trajectory-graph.d.ts

@@ -1,7 +1,7 @@
 import { a as GraphEdge } from './graph-DRkl22KE.js';
 import { CausalTrajectoryRecord } from './causal-trajectory.js';
 import './capabilities.js';
-import './types-Cyr32ABj.js';
+import './types-nJV23pa3.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';

package/dist/{chunk-B36GUU6T.js → chunk-23HFXQ5J.js}

@@ -19,7 +19,9 @@ import {
 // src/access-offline-manifest.ts
 import * as nodePath from "path";
 function planServerIdentityCacheWrite(input) {
-  const entries = input.streamCompleted ? [...input.persisted.values()].filter((entry) => input.yieldedPaths.has(entry.path)) : [...input.persisted.values()];
+  const entries = input.streamCompleted ? [...input.persisted.values()].filter(
+    (entry) => input.yieldedPaths.has(entry.path) || input.retainedPaths?.has(entry.path)
+  ) : [...input.persisted.values()];
   return { shouldWrite: input.cacheDirty || entries.length !== input.persisted.size, entries };
 }
 function serverIdentityCachePath(storageDir) {
@@ -87,7 +89,8 @@ async function mergeServerIdentityCacheEntries(fs, cachePath, entries, citationT
           ...entry.memory ? {} : {
             ...typeof entry.normalizerVersion === "number" ? { normalizerVersion: entry.normalizerVersion } : {},
             ...typeof entry.identityResolutionVersion === "number" ? { identityResolutionVersion: entry.identityResolutionVersion } : {}
-          }
+          },
+          ...entry.statIdentity !== void 0 && entry.excluded !== void 0 ? { statIdentity: entry.statIdentity, excluded: entry.excluded } : {}
         });
       }
     }
@@ -95,6 +98,25 @@ async function mergeServerIdentityCacheEntries(fs, cachePath, entries, citationT
   }
   return [...merged.values()];
 }
+function retainExcludedClassifications(input) {
+  const retained = /* @__PURE__ */ new Set();
+  let changed = false;
+  for (const [pathName, classification] of input.classifications) {
+    if (input.yieldedPaths.has(pathName)) continue;
+    retained.add(pathName);
+    const entry = input.persisted.get(pathName) ?? { path: pathName, sha256: "" };
+    if (entry.statIdentity === classification.statIdentity && entry.excluded === classification.excluded) {
+      continue;
+    }
+    input.persisted.set(pathName, {
+      ...entry,
+      statIdentity: classification.statIdentity,
+      excluded: classification.excluded
+    });
+    changed = true;
+  }
+  return { retained, changed };
+}
 async function createOfflineSyncManifestStream(orchestrator, namespace, userExcludeRegexps, options, parseMemory) {
   const storage = await offlineSyncStorageForSnapshot(orchestrator, namespace);
   const citationTemplate = orchestrator.config.inlineSourceAttributionFormat;
@@ -118,10 +140,12 @@ async function createOfflineSyncManifestStream(orchestrator, namespace, userExcl
       let streamCompleted = false;
       const persistedEntries = new Map(identityCache);
       const yieldedPaths = /* @__PURE__ */ new Set();
+      const retainedPaths = /* @__PURE__ */ new Set();
       const flush = async () => {
         const { shouldWrite, entries } = planServerIdentityCacheWrite({
           persisted: persistedEntries,
           yieldedPaths,
+          retainedPaths,
           streamCompleted,
           cacheDirty
         });
@@ -207,6 +231,13 @@ async function createOfflineSyncManifestStream(orchestrator, namespace, userExcl
         }
         streamCompleted = true;
       } finally {
+        const retained = retainExcludedClassifications({
+          persisted: persistedEntries,
+          classifications: classificationUpdates,
+          yieldedPaths
+        });
+        for (const pathName of retained.retained) retainedPaths.add(pathName);
+        if (retained.changed) cacheDirty = true;
         await flush();
       }
     })()
@@ -215,6 +246,8 @@ async function createOfflineSyncManifestStream(orchestrator, namespace, userExcl
 
 export {
   planServerIdentityCacheWrite,
+  mergeServerIdentityCacheEntries,
+  retainExcludedClassifications,
   createOfflineSyncManifestStream
 };
-//# sourceMappingURL=chunk-B36GUU6T.js.map
+//# sourceMappingURL=chunk-23HFXQ5J.js.map

package/dist/chunk-23HFXQ5J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/access-offline-manifest.ts"],"sourcesContent":["import * as nodePath from \"node:path\";\nimport { offlineSyncStorageForSnapshot } from \"./offline-sync-impression-drain.js\";\nimport { iterateOfflineSyncSnapshotFileRecords } from \"./offline-sync.js\";\nimport type { Orchestrator } from \"./orchestrator.js\";\nimport {\n  CONTENT_HASH_NORMALIZER_VERSION,\n  IDENTITY_RESOLUTION_VERSION,\n  RECONCILE_MANIFEST_FORMAT,\n  RECONCILE_MANIFEST_SCHEMA_VERSION,\n  type ReconcileManifest,\n  type ReconcileManifestFile,\n  type ReconcileMemoryIdentity,\n  type ReconcileMemoryParser,\n  buildReconcileManifestFile,\n  citationTemplateFingerprint,\n  isCachedIdentityReusable,\n  isReconcileMemoryIdentity,\n} from \"./reconcile/manifest.js\";\nimport { createPersistedSupportPassportPrivateFileExclusion } from \"./support-passport/card-projection.js\";\n\nexport interface OfflineSyncManifestRequest {\n  includeTranscripts?: boolean;\n  signal?: AbortSignal;\n}\n\nexport interface OfflineSyncManifestStreamResponse extends Omit<ReconcileManifest, \"files\"> {\n  namespace: string;\n  files: AsyncIterable<ReconcileManifestFile>;\n}\n\nexport interface ServerIdentityCacheEntry {\n  path: string;\n  sha256: string;\n  memory?: ReconcileMemoryIdentity;\n  /** Stamped on sha-only entries so an upgrade re-parses them. */\n  normalizerVersion?: number;\n  identityResolutionVersion?: number;\n  /** Stat identity the exclusion classification was computed against. */\n  statIdentity?: string;\n  /** Persisted support-passport private-memory classification for statIdentity. */\n  excluded?: boolean;\n}\n\n/**\n * Decide what the manifest stream should persist, and whether a write is\n * needed at all.\n *\n * A write is required whenever the persisted set changed — an identity was\n * rebuilt, or an entry was dropped because its file lost its identity — and\n * also when a completed walk leaves entries for paths it never saw, which are\n * files that have since been deleted. Skipping the write in that last case\n * would strand those entries on disk forever.\n *\n * Pruning is gated on the walk completing: an aborted or partially consumed\n * stream has simply not observed the remaining paths, so it may only add.\n */\nexport function planServerIdentityCacheWrite(input: {\n  persisted: ReadonlyMap<string, ServerIdentityCacheEntry>;\n  yieldedPaths: ReadonlySet<string>;\n  /** Paths the walk saw but never yielded (removed by the exclusion\n   * callback). Not deleted — pruning them would drop their persisted\n   * classification and force a re-classify on every later cycle. */\n  retainedPaths?: ReadonlySet<string>;\n  streamCompleted: boolean;\n  cacheDirty: boolean;\n}): { shouldWrite: boolean; entries: ServerIdentityCacheEntry[] } {\n  const entries = input.streamCompleted\n    ? [...input.persisted.values()].filter(\n        (entry) => input.yieldedPaths.has(entry.path) || input.retainedPaths?.has(entry.path)\n      )\n    : [...input.persisted.values()];\n  return { shouldWrite: input.cacheDirty || entries.length !== input.persisted.size, entries };\n}\n\n/**\n * The cache lives under `.remnic/` rather than `state/`: snapshot enumeration\n * excludes internal `.remnic/` paths structurally (`isInternalRemnicStatePath`),\n * whereas `state/` is only filtered by an allowlist of known node-local\n * artifacts. Under `state/` this node-local cache would be advertised as a peer\n * file, so convergence would transfer the cache itself — and the stream rewrites\n * it during finalization, so the advertised digest could go stale mid-transfer.\n */\nfunction serverIdentityCachePath(storageDir: string): string {\n  return nodePath.join(storageDir, \".remnic\", \"state\", \"converge-identity-cache.json\");\n}\n\nasync function loadServerIdentityCache(\n  storageDir: string,\n  citationTemplate?: string\n): Promise<Map<string, ServerIdentityCacheEntry>> {\n  const cache = new Map<string, ServerIdentityCacheEntry>();\n  try {\n    const raw = JSON.parse(\n      await import(\"node:fs/promises\").then((fs) => fs.readFile(serverIdentityCachePath(storageDir), \"utf8\"))\n    ) as {\n      citationTemplate?: string;\n      files?: unknown[];\n    };\n    // Identities are derived after stripping inline attribution for a specific\n    // citation template; entries written under a different one would produce\n    // wrong contentHash values for unchanged files.\n    if (raw.citationTemplate !== citationTemplateFingerprint(citationTemplate)) return cache;\n    for (const candidate of raw.files ?? []) {\n      const entry = candidate as Partial<ServerIdentityCacheEntry> | null;\n      if (typeof entry?.path !== \"string\" || typeof entry.sha256 !== \"string\") continue;\n      if (entry.memory !== undefined && !isReconcileMemoryIdentity(entry.memory)) continue;\n      if (entry.statIdentity !== undefined && typeof entry.statIdentity !== \"string\") continue;\n      if (entry.excluded !== undefined && typeof entry.excluded !== \"boolean\") continue;\n      if (entry.normalizerVersion !== undefined && typeof entry.normalizerVersion !== \"number\") continue;\n      if (entry.identityResolutionVersion !== undefined && typeof entry.identityResolutionVersion !== \"number\") {\n        continue;\n      }\n      cache.set(entry.path, {\n        path: entry.path,\n        sha256: entry.sha256,\n        ...(entry.memory ? { memory: entry.memory } : {}),\n        ...(entry.memory\n          ? {}\n          : {\n              ...(typeof entry.normalizerVersion === \"number\" ? { normalizerVersion: entry.normalizerVersion } : {}),\n              ...(typeof entry.identityResolutionVersion === \"number\"\n                ? { identityResolutionVersion: entry.identityResolutionVersion }\n                : {}),\n            }),\n        ...(entry.statIdentity !== undefined && entry.excluded !== undefined\n          ? { statIdentity: entry.statIdentity, excluded: entry.excluded }\n          : {}),\n      });\n    }\n  } catch {\n    // missing or corrupt cache: cold build\n  }\n  return cache;\n}\n\nconst serverIdentityCacheWriteLocks = new Map<string, Promise<void>>();\n\n/** Serialize cache replacements per path: overlapping manifest streams for one\n * namespace would otherwise each publish a whole-file snapshot, and the slower\n * stream built from older filesystem state would overwrite the newer one. */\nasync function withServerIdentityCacheWriteLock(cachePath: string, write: () => Promise<void>): Promise<void> {\n  const previous = serverIdentityCacheWriteLocks.get(cachePath) ?? Promise.resolve();\n  const next = previous.then(write, write);\n  serverIdentityCacheWriteLocks.set(cachePath, next);\n  try {\n    await next;\n  } finally {\n    if (serverIdentityCacheWriteLocks.get(cachePath) === next) {\n      serverIdentityCacheWriteLocks.delete(cachePath);\n    }\n  }\n}\n\n/** Union of the entries being written and the current on-disk set; on conflict\n * the write wins (it reflects the newer run). Callers hold the write lock. */\nexport async function mergeServerIdentityCacheEntries(\n  fs: typeof import(\"node:fs/promises\"),\n  cachePath: string,\n  entries: readonly ServerIdentityCacheEntry[],\n  citationTemplate: string | undefined,\n  dropped: ReadonlySet<string> = new Set()\n): Promise<ServerIdentityCacheEntry[]> {\n  const merged = new Map(entries.map((entry) => [entry.path, entry]));\n  try {\n    const raw = JSON.parse(await fs.readFile(cachePath, \"utf8\")) as {\n      citationTemplate?: string;\n      files?: unknown[];\n    };\n    if (raw.citationTemplate === citationTemplateFingerprint(citationTemplate)) {\n      for (const candidate of raw.files ?? []) {\n        const entry = candidate as Partial<ServerIdentityCacheEntry> | null;\n        if (typeof entry?.path !== \"string\" || typeof entry.sha256 !== \"string\") continue;\n        if (entry.memory !== undefined && !isReconcileMemoryIdentity(entry.memory)) continue;\n        if (dropped.has(entry.path) || merged.has(entry.path)) continue;\n        merged.set(entry.path, {\n          path: entry.path,\n          sha256: entry.sha256,\n          ...(entry.memory ? { memory: entry.memory } : {}),\n          ...(entry.memory\n            ? {}\n            : {\n                ...(typeof entry.normalizerVersion === \"number\" ? { normalizerVersion: entry.normalizerVersion } : {}),\n                ...(typeof entry.identityResolutionVersion === \"number\"\n                  ? { identityResolutionVersion: entry.identityResolutionVersion }\n                  : {}),\n              }),\n          ...(entry.statIdentity !== undefined && entry.excluded !== undefined\n            ? { statIdentity: entry.statIdentity, excluded: entry.excluded }\n            : {}),\n        });\n      }\n    }\n  } catch {\n    // missing or unreadable current cache: the write set stands alone\n  }\n  return [...merged.values()];\n}\n\n/** Record classifications for files the walk excluded (the exclusion callback\n * returned true, so they were never yielded): they were seen this walk, so\n * their entries must persist and must not be pruned as deleted. Mirrors the\n * per-yield classification application for never-yielded paths. */\nexport function retainExcludedClassifications(input: {\n  persisted: Map<string, ServerIdentityCacheEntry>;\n  classifications: ReadonlyMap<string, { statIdentity: string; excluded: boolean }>;\n  yieldedPaths: ReadonlySet<string>;\n}): { retained: Set<string>; changed: boolean } {\n  const retained = new Set<string>();\n  let changed = false;\n  for (const [pathName, classification] of input.classifications) {\n    if (input.yieldedPaths.has(pathName)) continue;\n    retained.add(pathName);\n    const entry = input.persisted.get(pathName) ?? { path: pathName, sha256: \"\" };\n    if (entry.statIdentity === classification.statIdentity && entry.excluded === classification.excluded) {\n      continue;\n    }\n    input.persisted.set(pathName, {\n      ...entry,\n      statIdentity: classification.statIdentity,\n      excluded: classification.excluded,\n    });\n    changed = true;\n  }\n  return { retained, changed };\n}\n\nexport async function createOfflineSyncManifestStream(\n  orchestrator: Orchestrator,\n  namespace: string,\n  userExcludeRegexps: RegExp[],\n  options: OfflineSyncManifestRequest,\n  parseMemory: ReconcileMemoryParser\n): Promise<OfflineSyncManifestStreamResponse> {\n  const storage = await offlineSyncStorageForSnapshot(orchestrator, namespace);\n  const citationTemplate = orchestrator.config.inlineSourceAttributionFormat;\n  const identityCache = await loadServerIdentityCache(storage.dir, citationTemplate);\n  // The exclusion callback runs before every yield; without the persisted\n  // classification it would read and parse every candidate file, defeating the\n  // warm-cache skip entirely.\n  const classificationUpdates = new Map<string, { statIdentity: string; excluded: boolean }>();\n  const snapshotFiles = iterateOfflineSyncSnapshotFileRecords({\n    root: storage.dir,\n    includeContent: false,\n    includeTranscripts: options.includeTranscripts !== false,\n    readFileDigest: async ({ filePath }) => storage.digestOfflineSyncFile(filePath),\n    signal: options.signal,\n    userExcludeRegexps,\n    excludeFile: createPersistedSupportPassportPrivateFileExclusion(storage, identityCache, classificationUpdates),\n  });\n  return {\n    namespace,\n    format: RECONCILE_MANIFEST_FORMAT,\n    schemaVersion: RECONCILE_MANIFEST_SCHEMA_VERSION,\n    files: (async function* () {\n      // Any change to the persisted set, not just a rebuilt identity: a file\n      // that lost its identity, or a completed walk that must prune vanished\n      // paths, also has to reach disk or the removal is lost forever.\n      let cacheDirty = false;\n      let streamCompleted = false;\n      // Seeded with every previously cached entry so a partially consumed\n      // stream (client disconnect, abort) can only add to the cache. Writing\n      // just this run's rebuilds would drop every cache hit, so one edit to a\n      // large corpus would shrink the cache to that single entry and force a\n      // near-cold rebuild on the next request.\n      const persistedEntries = new Map(identityCache);\n      const yieldedPaths = new Set<string>();\n      const retainedPaths = new Set<string>();\n      const flush = async (): Promise<void> => {\n        const { shouldWrite, entries } = planServerIdentityCacheWrite({\n          persisted: persistedEntries,\n          yieldedPaths,\n          retainedPaths,\n          streamCompleted,\n          cacheDirty,\n        });\n        if (!shouldWrite) return;\n        try {\n          const fs = await import(\"node:fs/promises\");\n          const cachePath = serverIdentityCachePath(storage.dir);\n          await withServerIdentityCacheWriteLock(cachePath, async () => {\n            // Merge with whatever is on disk NOW: a concurrent stream for the\n            // same namespace may have published newer entries after this\n            // request loaded its snapshot, and a blind whole-file replace\n            // would discard them.\n            const written = new Set(entries.map((entry) => entry.path));\n            const dropped = streamCompleted\n              ? new Set([...identityCache.keys()].filter((pathName) => !written.has(pathName)))\n              : new Set<string>();\n            const merged = await mergeServerIdentityCacheEntries(\n              fs,\n              cachePath,\n              entries,\n              citationTemplate,\n              dropped\n            );\n            await fs.mkdir(nodePath.dirname(cachePath), { recursive: true });\n            const tmp = `${cachePath}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;\n            await fs.writeFile(\n              tmp,\n              JSON.stringify({ citationTemplate: citationTemplateFingerprint(citationTemplate), files: merged })\n            );\n            await fs.rename(tmp, cachePath);\n          });\n        } catch {\n          // cache persistence is best-effort\n        }\n      };\n      try {\n        const applyClassification = (path: string, sha256: string): void => {\n          const classification = classificationUpdates.get(path);\n          if (classification === undefined) return;\n          const entry = persistedEntries.get(path) ?? { path, sha256 };\n          if (entry.statIdentity === classification.statIdentity && entry.excluded === classification.excluded) {\n            return;\n          }\n          persistedEntries.set(path, {\n            ...entry,\n            ...(entry.memory ? { memory: entry.memory } : {}),\n            statIdentity: classification.statIdentity,\n            excluded: classification.excluded,\n          });\n          cacheDirty = true;\n        };\n        for await (const file of snapshotFiles) {\n          yieldedPaths.add(file.path);\n          const cached = identityCache.get(file.path);\n          if (\n            cached !== undefined &&\n            cached.sha256.toLowerCase() === file.sha256.toLowerCase() &&\n            isCachedIdentityReusable(cached)\n          ) {\n            applyClassification(file.path, file.sha256);\n            yield {\n              ...file,\n              ...(cached.memory\n                ? { memory: cached.memory }\n                : {\n                    normalizerVersion: cached.normalizerVersion,\n                    identityResolutionVersion: cached.identityResolutionVersion,\n                  }),\n            };\n            continue;\n          }\n          const built = await buildReconcileManifestFile(\n            file,\n            async ({ path }) => storage.readOfflineSyncFile(nodePath.join(storage.dir, path)),\n            parseMemory,\n            citationTemplate\n          );\n          // Negative results persist too: a memory-shaped file that parses\n          // without an identity would otherwise be re-read on every warm run.\n          const previous = persistedEntries.get(built.path);\n          if (previous?.sha256 !== built.sha256 || (built.memory !== undefined && previous?.memory !== built.memory)) {\n            cacheDirty = true;\n          }\n          if (built.memory === undefined && built.normalizerVersion === undefined) {\n            // Read failed: do not persist a negative identity for this SHA.\n            yield built;\n            continue;\n          }\n          persistedEntries.set(built.path, {\n            path: built.path,\n            sha256: built.sha256,\n            ...(built.memory !== undefined\n              ? { memory: built.memory }\n              : {\n                  normalizerVersion: built.normalizerVersion,\n                  identityResolutionVersion: built.identityResolutionVersion,\n                }),\n          });\n          applyClassification(built.path, built.sha256);\n          yield built;\n        }\n        streamCompleted = true;\n      } finally {\n        // Files the exclusion callback removed from the snapshot were seen\n        // this walk but never yielded: persist their classifications so the\n        // next cycle skips the read+parse, and keep them out of the\n        // deleted-path prune.\n        const retained = retainExcludedClassifications({\n          persisted: persistedEntries,\n          classifications: classificationUpdates,\n          yieldedPaths,\n        });\n        for (const pathName of retained.retained) retainedPaths.add(pathName);\n        if (retained.changed) cacheDirty = true;\n        await flush();\n      }\n    })(),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-YFTNZMGR.js → chunk-27NO2KVB.js}

@@ -1,8 +1,12 @@
 import {
   isLoopbackHost
 } from "./chunk-C5C7IJ4Q.js";
+import {
+  expandTildePath
+} from "./chunk-6KH5NLQS.js";
 
 // src/background-generation-config.ts
+import { readFileSync } from "fs";
 function stripTrailingSlashes(value) {
   let end = value.length;
   while (end > 0 && value.charCodeAt(end - 1) === 47) {
@@ -44,14 +48,13 @@ function parseBackgroundGenerationObject(raw, keyName) {
   if (typeof tokenRaw !== "string" || tokenRaw.length === 0) {
     throw new Error(`${keyName} must include a token`);
   }
-  const timeoutRaw = record.timeoutSeconds;
+  const timeoutRaw = record.timeoutSeconds ?? record.timeout_seconds;
   let timeoutSeconds = 120;
   if (timeoutRaw !== void 0) {
-    const parsed = typeof timeoutRaw === "number" ? timeoutRaw : Number(timeoutRaw);
-    if (!Number.isFinite(parsed) || parsed <= 0) {
+    if (typeof timeoutRaw !== "number" || !Number.isFinite(timeoutRaw) || timeoutRaw <= 0) {
       throw new Error(`${keyName} timeoutSeconds must be a finite number > 0`);
     }
-    timeoutSeconds = parsed;
+    timeoutSeconds = timeoutRaw;
   }
   return {
     endpoint: parseBackgroundEndpoint(endpointRaw, `${keyName}.endpoint`),
@@ -59,13 +62,33 @@ function parseBackgroundGenerationObject(raw, keyName) {
     timeoutSeconds
   };
 }
-function parseBackgroundGeneration(cfg) {
+function parseBackgroundGeneration(cfg, expandEnv) {
+  const pathRaw = cfg.llmBridgeClientConfigPath;
+  let fromFile;
+  if (pathRaw !== void 0 && pathRaw !== null && pathRaw !== "") {
+    if (typeof pathRaw !== "string") {
+      throw new Error("llmBridgeClientConfigPath must be a string");
+    }
+    const expanded = expandTildePath(expandEnv(pathRaw.trim()));
+    let parsed;
+    try {
+      parsed = JSON.parse(readFileSync(expanded, "utf8"));
+    } catch {
+      throw new Error(`llmBridgeClientConfigPath could not be read: ${expanded}`);
+    }
+    fromFile = parseBackgroundGenerationObject(parsed, "llmBridgeClientConfigPath");
+  }
   const explicitRaw = cfg.backgroundGeneration;
-  if (explicitRaw === void 0 || explicitRaw === null) return void 0;
-  return parseBackgroundGenerationObject(explicitRaw, "backgroundGeneration");
+  const fromExplicit = explicitRaw === void 0 || explicitRaw === null ? void 0 : parseBackgroundGenerationObject(explicitRaw, "backgroundGeneration");
+  if (!fromFile && !fromExplicit) return void 0;
+  return {
+    endpoint: fromExplicit?.endpoint ?? fromFile.endpoint,
+    token: fromExplicit?.token ?? fromFile.token,
+    timeoutSeconds: fromExplicit?.timeoutSeconds ?? fromFile.timeoutSeconds
+  };
 }
 
 export {
   parseBackgroundGeneration
 };
-//# sourceMappingURL=chunk-YFTNZMGR.js.map
+//# sourceMappingURL=chunk-27NO2KVB.js.map

package/dist/chunk-27NO2KVB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/background-generation-config.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\n\nimport { isLoopbackHost } from \"./runtime/http-transport.js\";\nimport { expandTildePath } from \"./utils/path.js\";\n\nexport interface BackgroundGenerationConfig {\n  /** Full chat-completions URL. Never used as the global OpenAI base URL. */\n  endpoint: string;\n  /** Loopback bearer from the generated client file. */\n  token: string;\n  timeoutSeconds: number;\n}\n\nfunction stripTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 47) {\n    end -= 1;\n  }\n  return end === value.length ? value : value.slice(0, end);\n}\n\nfunction parseBackgroundEndpoint(value: string, keyName: string): string {\n  const trimmed = stripTrailingSlashes(value.trim());\n  let parsed: URL;\n  try {\n    parsed = new URL(trimmed);\n  } catch {\n    throw new Error(`${keyName} must be an absolute HTTP or HTTPS URL`);\n  }\n  if (parsed.protocol !== \"https:\" && parsed.protocol !== \"http:\") {\n    throw new Error(`${keyName} must use HTTP or HTTPS`);\n  }\n  if (parsed.protocol === \"http:\" && !isLoopbackHost(parsed.hostname)) {\n    throw new Error(`${keyName} must use HTTPS unless the host is loopback`);\n  }\n  if (parsed.username || parsed.password || parsed.search || parsed.hash) {\n    throw new Error(\n      `${keyName} must not include credentials, query parameters, or fragments`,\n    );\n  }\n  return trimmed;\n}\n\nfunction parseBackgroundGenerationObject(\n  raw: unknown,\n  keyName: string,\n): BackgroundGenerationConfig {\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n    throw new Error(`${keyName} must be an object`);\n  }\n  const record = raw as Record<string, unknown>;\n  const endpointRaw = record.endpoint;\n  if (typeof endpointRaw !== \"string\" || endpointRaw.trim().length === 0) {\n    throw new Error(`${keyName} must include an endpoint URL`);\n  }\n  const tokenRaw = record.token;\n  if (typeof tokenRaw !== \"string\" || tokenRaw.length === 0) {\n    throw new Error(`${keyName} must include a token`);\n  }\n  const timeoutRaw = record.timeoutSeconds ?? record.timeout_seconds;\n  let timeoutSeconds = 120;\n  if (timeoutRaw !== undefined) {\n    if (typeof timeoutRaw !== \"number\" || !Number.isFinite(timeoutRaw) || timeoutRaw <= 0) {\n      throw new Error(`${keyName} timeoutSeconds must be a finite number > 0`);\n    }\n    timeoutSeconds = timeoutRaw;\n  }\n  return {\n    endpoint: parseBackgroundEndpoint(endpointRaw, `${keyName}.endpoint`),\n    token: tokenRaw,\n    timeoutSeconds,\n  };\n}\n\nexport function parseBackgroundGeneration(\n  cfg: Record<string, unknown>,\n  expandEnv: (value: string) => string,\n): BackgroundGenerationConfig | undefined {\n  const pathRaw = cfg.llmBridgeClientConfigPath;\n  let fromFile: BackgroundGenerationConfig | undefined;\n  if (pathRaw !== undefined && pathRaw !== null && pathRaw !== \"\") {\n    if (typeof pathRaw !== \"string\") {\n      throw new Error(\"llmBridgeClientConfigPath must be a string\");\n    }\n    const expanded = expandTildePath(expandEnv(pathRaw.trim()));\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(readFileSync(expanded, \"utf8\"));\n    } catch {\n      throw new Error(`llmBridgeClientConfigPath could not be read: ${expanded}`);\n    }\n    fromFile = parseBackgroundGenerationObject(parsed, \"llmBridgeClientConfigPath\");\n  }\n  const explicitRaw = cfg.backgroundGeneration;\n  const fromExplicit =\n    explicitRaw === undefined || explicitRaw === null\n      ? undefined\n      : parseBackgroundGenerationObject(explicitRaw, \"backgroundGeneration\");\n  if (!fromFile && !fromExplicit) return undefined;\n  return {\n    endpoint: fromExplicit?.endpoint ?? fromFile!.endpoint,\n    token: fromExplicit?.token ?? fromFile!.token,\n    timeoutSeconds: fromExplicit?.timeoutSeconds ?? fromFile!.timeoutSeconds,\n  };\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,oBAAoB;AAa7B,SAAS,qBAAqB,OAAuB;AACnD,MAAI,MAAM,MAAM;AAChB,SAAO,MAAM,KAAK,MAAM,WAAW,MAAM,CAAC,MAAM,IAAI;AAClD,WAAO;AAAA,EACT;AACA,SAAO,QAAQ,MAAM,SAAS,QAAQ,MAAM,MAAM,GAAG,GAAG;AAC1D;AAEA,SAAS,wBAAwB,OAAe,SAAyB;AACvE,QAAM,UAAU,qBAAqB,MAAM,KAAK,CAAC;AACjD,MAAI;AACJ,MAAI;AACF,aAAS,IAAI,IAAI,OAAO;AAAA,EAC1B,QAAQ;AACN,UAAM,IAAI,MAAM,GAAG,OAAO,wCAAwC;AAAA,EACpE;AACA,MAAI,OAAO,aAAa,YAAY,OAAO,aAAa,SAAS;AAC/D,UAAM,IAAI,MAAM,GAAG,OAAO,yBAAyB;AAAA,EACrD;AACA,MAAI,OAAO,aAAa,WAAW,CAAC,eAAe,OAAO,QAAQ,GAAG;AACnE,UAAM,IAAI,MAAM,GAAG,OAAO,6CAA6C;AAAA,EACzE;AACA,MAAI,OAAO,YAAY,OAAO,YAAY,OAAO,UAAU,OAAO,MAAM;AACtE,UAAM,IAAI;AAAA,MACR,GAAG,OAAO;AAAA,IACZ;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,gCACP,KACA,SAC4B;AAC5B,MAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACzD,UAAM,IAAI,MAAM,GAAG,OAAO,oBAAoB;AAAA,EAChD;AACA,QAAM,SAAS;AACf,QAAM,cAAc,OAAO;AAC3B,MAAI,OAAO,gBAAgB,YAAY,YAAY,KAAK,EAAE,WAAW,GAAG;AACtE,UAAM,IAAI,MAAM,GAAG,OAAO,+BAA+B;AAAA,EAC3D;AACA,QAAM,WAAW,OAAO;AACxB,MAAI,OAAO,aAAa,YAAY,SAAS,WAAW,GAAG;AACzD,UAAM,IAAI,MAAM,GAAG,OAAO,uBAAuB;AAAA,EACnD;AACA,QAAM,aAAa,OAAO,kBAAkB,OAAO;AACnD,MAAI,iBAAiB;AACrB,MAAI,eAAe,QAAW;AAC5B,QAAI,OAAO,eAAe,YAAY,CAAC,OAAO,SAAS,UAAU,KAAK,cAAc,GAAG;AACrF,YAAM,IAAI,MAAM,GAAG,OAAO,6CAA6C;AAAA,IACzE;AACA,qBAAiB;AAAA,EACnB;AACA,SAAO;AAAA,IACL,UAAU,wBAAwB,aAAa,GAAG,OAAO,WAAW;AAAA,IACpE,OAAO;AAAA,IACP;AAAA,EACF;AACF;AAEO,SAAS,0BACd,KACA,WACwC;AACxC,QAAM,UAAU,IAAI;AACpB,MAAI;AACJ,MAAI,YAAY,UAAa,YAAY,QAAQ,YAAY,IAAI;AAC/D,QAAI,OAAO,YAAY,UAAU;AAC/B,YAAM,IAAI,MAAM,4CAA4C;AAAA,IAC9D;AACA,UAAM,WAAW,gBAAgB,UAAU,QAAQ,KAAK,CAAC,CAAC;AAC1D,QAAI;AACJ,QAAI;AACF,eAAS,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AAAA,IACpD,QAAQ;AACN,YAAM,IAAI,MAAM,gDAAgD,QAAQ,EAAE;AAAA,IAC5E;AACA,eAAW,gCAAgC,QAAQ,2BAA2B;AAAA,EAChF;AACA,QAAM,cAAc,IAAI;AACxB,QAAM,eACJ,gBAAgB,UAAa,gBAAgB,OACzC,SACA,gCAAgC,aAAa,sBAAsB;AACzE,MAAI,CAAC,YAAY,CAAC,aAAc,QAAO;AACvC,SAAO;AAAA,IACL,UAAU,cAAc,YAAY,SAAU;AAAA,IAC9C,OAAO,cAAc,SAAS,SAAU;AAAA,IACxC,gBAAgB,cAAc,kBAAkB,SAAU;AAAA,EAC5D;AACF;","names":[]}

package/dist/{chunk-T32B72QX.js → chunk-2SKMZUOW.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-7S53BPTU.js";
+} from "./chunk-MVG3KXON.js";
 import {
   bumpMemoryCorpusVersionForDir
 } from "./chunk-XCB6QDL6.js";
@@ -765,4 +765,4 @@ export {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
 };
-//# sourceMappingURL=chunk-T32B72QX.js.map
+//# sourceMappingURL=chunk-2SKMZUOW.js.map

package/dist/{chunk-VHOSM5G4.js → chunk-2SNCQHJZ.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-7S53BPTU.js";
+} from "./chunk-MVG3KXON.js";
 import {
   MutationSerializer
 } from "./chunk-FFAZ2XFU.js";
@@ -412,4 +412,4 @@ export {
   resolveNamespaceStorageRoot,
   NamespaceStorageRouter
 };
-//# sourceMappingURL=chunk-VHOSM5G4.js.map
+//# sourceMappingURL=chunk-2SNCQHJZ.js.map

package/dist/{chunk-VV4ZVUE6.js → chunk-3QEVOQF5.js}

@@ -1,6 +1,6 @@
 import {
   isNamespaceKind
-} from "./chunk-PPQEP4OH.js";
+} from "./chunk-W23JARAQ.js";
 import {
   EngramAccessInputError
 } from "./chunk-2Z24E5W2.js";
@@ -40,4 +40,4 @@ export {
   positiveIntQueryParam,
   optionalNamespaceKindQueryParam
 };
-//# sourceMappingURL=chunk-VV4ZVUE6.js.map
+//# sourceMappingURL=chunk-3QEVOQF5.js.map

package/dist/{chunk-3N3PBBEH.js → chunk-3XPN7AVY.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-AAD2ZS6P.js";
 import {
   gatewayTaskChainOptions
-} from "./chunk-LQNRVPTV.js";
+} from "./chunk-THTF2W7M.js";
 import {
   extractJsonCandidates
 } from "./chunk-RGMVMVMF.js";
@@ -685,4 +685,4 @@ export {
   serializeFaithfulnessFields,
   parseFaithfulnessField
 };
-//# sourceMappingURL=chunk-3N3PBBEH.js.map
+//# sourceMappingURL=chunk-3XPN7AVY.js.map

package/dist/{chunk-XN6XT6GR.js → chunk-46Z3VGWF.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-6ET2VII7.js";
 import {
   StorageManager
-} from "./chunk-7S53BPTU.js";
+} from "./chunk-MVG3KXON.js";
 import {
   parseContinuityImprovementLoops
 } from "./chunk-LDXUBPMO.js";
@@ -1283,4 +1283,4 @@ export {
   defaultTierMigrationCycleBudget,
   CompoundingEngine
 };
-//# sourceMappingURL=chunk-XN6XT6GR.js.map
+//# sourceMappingURL=chunk-46Z3VGWF.js.map

package/dist/{chunk-2PTNJTBE.js → chunk-4CMXI55L.js}

@@ -1,6 +1,6 @@
 import {
   rebuildMemoryProjection
-} from "./chunk-NWMUSKED.js";
+} from "./chunk-BGRTZOJB.js";
 
 // src/convergence-refresh.ts
 async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, getStorage, searchEnabled) {
@@ -32,4 +32,4 @@ async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, get
 export {
   refreshConvergedNamespaces
 };
-//# sourceMappingURL=chunk-2PTNJTBE.js.map
+//# sourceMappingURL=chunk-4CMXI55L.js.map

package/dist/{chunk-2MT4ADLQ.js → chunk-5LYSEZOF.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-62OKGIJA.js";
 import {
   parseActivityConfig
-} from "./chunk-5HYUUFMQ.js";
+} from "./chunk-XCPNH2MG.js";
 import {
   parseLocationConfig
 } from "./chunk-I3H5LFOI.js";
@@ -27,7 +27,7 @@ import {
 } from "./chunk-6ZMAMSHS.js";
 import {
   parseLocalLlmConfig
-} from "./chunk-6H2G7RFT.js";
+} from "./chunk-VNQRRUNS.js";
 import {
   parseGraphPathScoringConfig
 } from "./chunk-6ZN34ISG.js";
@@ -69,6 +69,9 @@ import {
 import {
   parseBoundedJsonlStateConfig
 } from "./chunk-KFZY2OFH.js";
+import {
+  parseBackgroundGeneration
+} from "./chunk-27NO2KVB.js";
 import {
   parseActiveContextFields
 } from "./chunk-B32WYRXX.js";
@@ -80,7 +83,7 @@ import {
 } from "./chunk-FEHIOYML.js";
 import {
   parseRecallStateViews
-} from "./chunk-255PC37A.js";
+} from "./chunk-NETQXOPY.js";
 import {
   parseReplicaPeersConfig
 } from "./chunk-WNIUPHWV.js";
@@ -2702,9 +2705,14 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
   } else if (apiKey !== void 0) {
     baseUrl = normalizeOpenaiBaseUrl(readEnvVar("OPENAI_BASE_URL"), "env");
   }
+  const backgroundGeneration = parseBackgroundGeneration(cfg, resolveEnvVars);
   const sharedCrossSignalSemanticEnabled = cfg.sharedCrossSignalSemanticEnabled === true || cfg.crossSignalsSemanticEnabled === true;
   const sharedCrossSignalSemanticTimeoutMs = typeof cfg.sharedCrossSignalSemanticTimeoutMs === "number" ? Math.max(1, Math.floor(cfg.sharedCrossSignalSemanticTimeoutMs)) : typeof cfg.crossSignalsSemanticTimeoutMs === "number" ? Math.max(1, Math.floor(cfg.crossSignalsSemanticTimeoutMs)) : 4e3;
-  const recallPipelineConfig = buildRecallPipelineConfig(cfg);
+  const sharedContextEnabled = coerceBool(cfg.sharedContextEnabled, "sharedContextEnabled") ?? false;
+  const recallPipelineConfig = buildRecallPipelineConfig({
+    ...cfg,
+    sharedContextEnabled
+  });
   const maintenanceNamespaceFanoutEnabled = resolveBooleanConfig(
     readFlatOrNestedConfig(
       cfg,
@@ -2770,6 +2778,7 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
   return {
     openaiApiKey: apiKey,
     openaiBaseUrl: baseUrl,
+    backgroundGeneration,
     model,
     reasoningEffort,
     triggerMode,
@@ -3796,10 +3805,9 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
     autoPromoteMinConfidenceTier: cfg.autoPromoteMinConfidenceTier === "explicit" ? "explicit" : cfg.autoPromoteMinConfidenceTier === "implied" ? "implied" : "explicit",
     routingRulesEnabled: cfg.routingRulesEnabled === true,
     routingRulesStateFile: typeof cfg.routingRulesStateFile === "string" && cfg.routingRulesStateFile.trim().length > 0 ? cfg.routingRulesStateFile.trim() : "state/routing-rules.json",
-    // v4.0 shared-context (default off)
-    sharedContextEnabled: cfg.sharedContextEnabled === true,
-    // CLI values arrive as strings (`--config sharedContextAllowBindingAuthority=true`),
-    // so a strict `=== true` silently keeps the feature off. Default stays false.
+    // Reuse the hoisted coerce above (default pipeline already saw it).
+    sharedContextEnabled,
+    // Same coercion contract for the binding-authority sibling (#2918 parity).
     sharedContextAllowBindingAuthority: coerceBool(cfg.sharedContextAllowBindingAuthority, "sharedContextAllowBindingAuthority") ?? false,
     sharedContextDir: typeof cfg.sharedContextDir === "string" && cfg.sharedContextDir.length > 0 ? cfg.sharedContextDir : void 0,
     sharedContextMaxInjectChars: typeof cfg.sharedContextMaxInjectChars === "number" ? cfg.sharedContextMaxInjectChars : 4e3,
@@ -4533,6 +4541,7 @@ function buildDefaultRecallPipeline(cfg) {
   return [
     {
       id: "shared-context",
+      // Already coerced in parseConfig; do not coerce again.
       enabled: cfg.sharedContextEnabled === true,
       maxChars: typeof cfg.sharedContextMaxInjectChars === "number" ? Math.max(0, Math.floor(cfg.sharedContextMaxInjectChars)) : 4e3
     },
@@ -4783,4 +4792,4 @@ export {
   VALID_MEMORY_CATEGORIES,
   parseConfig
 };
-//# sourceMappingURL=chunk-2MT4ADLQ.js.map
+//# sourceMappingURL=chunk-5LYSEZOF.js.map