@remnic/core 10.0.48 → 10.0.50

package/dist/active-recall.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/active-recall.ts"],"sourcesContent":["import { appendFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { DEFAULT_REASONING_MODEL } from \"./config.js\";\nimport { collapseWhitespace, truncateCodePointSafe } from \"./whitespace.js\";\nimport type {\n  ActiveRecallChatType,\n  ActiveRecallModelFallbackPolicy,\n  ActiveRecallPromptStyle,\n  ActiveRecallQueryMode,\n  ActiveRecallThinking,\n} from \"./types.js\";\n\nexport interface ActiveRecallTurn {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface ActiveRecallInput {\n  sessionKey: string;\n  agentId: string;\n  chatType: ActiveRecallChatType;\n  recentTurns: ActiveRecallTurn[];\n  currentMessage: string;\n}\n\nexport interface ActiveRecallConfig {\n  enabled: boolean;\n  agents: string[] | null;\n  allowedChatTypes: ActiveRecallChatType[];\n  queryMode: ActiveRecallQueryMode;\n  promptStyle: ActiveRecallPromptStyle;\n  customInstruction: string | null;\n  promptReplacement: string | null;\n  promptAppend: string | null;\n  maxSummaryChars: number;\n  recentUserTurns: number;\n  recentAssistantTurns: number;\n  recentUserChars: number;\n  recentAssistantChars: number;\n  thinking: ActiveRecallThinking;\n  timeoutMs: number;\n  cacheTtlMs: number;\n  persistTranscripts: boolean;\n  transcriptDir: string;\n  entityGraphDepth: number;\n  includeCausalTrajectories: boolean;\n  includeDaySummary: boolean;\n  attachRecallExplain: boolean;\n  modelOverride: string | null;\n  modelFallbackPolicy: ActiveRecallModelFallbackPolicy;\n}\n\nexport interface ActiveRecallResult {\n  summary: string | null;\n  citations: Array<{ memoryId: string; relevance: number }>;\n  latencyMs: number;\n  cacheHit: boolean;\n  modelUsed: string;\n  transcriptPath: string | null;\n}\n\nexport interface ActiveRecallDependencies {\n  recall(query: string, sessionKey: string): Promise<string | null>;\n  getLastRecallSnapshot?(sessionKey: string): { memoryIds?: string[] } | null;\n  walkEntityGraph?(params: {\n    sessionKey: string;\n    query: string;\n    depth: number;\n  }): Promise<string[]>;\n  loadCausalTrajectories?(params: {\n    sessionKey: string;\n    query: string;\n  }): Promise<string[]>;\n  loadDaySummary?(sessionKey: string): Promise<string | null>;\n  explainLastRecall?(sessionKey: string): Promise<string | null>;\n  generateSummary?(params: {\n    prompt: string;\n    sessionKey: string;\n    agentId: string;\n    model: string;\n    timeoutMs: number;\n    thinking: ActiveRecallThinking;\n    fallbackPolicy: ActiveRecallModelFallbackPolicy;\n  }): Promise<{ text: string | null; modelUsed?: string; cacheHit?: boolean }>;\n  now?: () => number;\n}\n\ninterface CachedRecallResult {\n  expiresAt: number;\n  value: ActiveRecallResult;\n}\n\ninterface ActiveRecallTurnWithIndex {\n  index: number;\n  role: ActiveRecallTurn[\"role\"];\n  content: string;\n}\n\nconst ACTIVE_RECALL_CACHE_MAX_ENTRIES = 256;\n\nconst NONE_SET = new Set([\n  \"\",\n  \"none\",\n  \"no_reply\",\n  \"nothing useful\",\n  \"no relevant memory\",\n  \"timeout\",\n  \"[]\",\n  \"{}\",\n  \"null\",\n  \"n/a\",\n]);\n\nconst STYLE_INSTRUCTIONS: Record<ActiveRecallPromptStyle, string> = {\n  balanced: \"Summarize the most relevant memory context in a compact, neutral way.\",\n  strict: \"Only include memory that is directly supported by the retrieved context.\",\n  contextual: \"Prefer concise context that helps the next reply stay grounded in recent work.\",\n  \"recall-heavy\": \"Bias toward richer recall coverage when multiple retrieved items reinforce each other.\",\n  \"precision-heavy\": \"Bias toward precision. Omit anything uncertain or weakly supported.\",\n  \"preference-only\": \"Only surface user preference or operating-style memory when present.\",\n};\n\nfunction cloneRecallResult(value: ActiveRecallResult): ActiveRecallResult {\n  return {\n    ...value,\n    citations: [...value.citations],\n  };\n}\n\nfunction buildCacheKey(input: ActiveRecallInput, config: ActiveRecallConfig, queryBundle: string): string {\n  return JSON.stringify({\n    sessionKey: input.sessionKey,\n    agentId: input.agentId,\n    queryMode: config.queryMode,\n    promptStyle: config.promptStyle,\n    customInstruction: config.customInstruction,\n    promptReplacement: config.promptReplacement,\n    promptAppend: config.promptAppend,\n    maxSummaryChars: config.maxSummaryChars,\n    entityGraphDepth: config.entityGraphDepth,\n    includeCausalTrajectories: config.includeCausalTrajectories,\n    includeDaySummary: config.includeDaySummary,\n    attachRecallExplain: config.attachRecallExplain,\n    modelOverride: config.modelOverride,\n    modelFallbackPolicy: config.modelFallbackPolicy,\n    thinking: config.thinking,\n    queryBundle,\n  });\n}\n\nfunction pruneExpiredCache(\n  cache: Map<string, CachedRecallResult>,\n  currentTime: number,\n): void {\n  for (const [key, entry] of cache.entries()) {\n    if (entry.expiresAt <= currentTime) {\n      cache.delete(key);\n    }\n  }\n}\n\nfunction enforceCacheLimit(cache: Map<string, CachedRecallResult>): void {\n  while (cache.size > ACTIVE_RECALL_CACHE_MAX_ENTRIES) {\n    const oldestKey = cache.keys().next().value;\n    if (typeof oldestKey !== \"string\") {\n      break;\n    }\n    cache.delete(oldestKey);\n  }\n}\n\nfunction cropTurns(\n  turns: ActiveRecallTurn[],\n  role: \"user\" | \"assistant\",\n  maxTurns: number,\n  maxChars: number,\n): ActiveRecallTurnWithIndex[] {\n  if (maxTurns <= 0) {\n    return [];\n  }\n\n  const selected: ActiveRecallTurnWithIndex[] = [];\n  for (let index = turns.length - 1; index >= 0 && selected.length < maxTurns; index -= 1) {\n    const turn = turns[index];\n    if (turn?.role === role) {\n      selected.push({\n        index,\n        role: turn.role,\n        content: collapseWhitespace(truncateCodePointSafe(turn.content, maxChars)),\n      });\n    }\n  }\n\n  return selected.reverse();\n}\n\nfunction mergeChronologicalTurns(\n  userTurns: ActiveRecallTurnWithIndex[],\n  assistantTurns: ActiveRecallTurnWithIndex[],\n): ActiveRecallTurnWithIndex[] {\n  return [...userTurns, ...assistantTurns]\n    .sort((left, right) => left.index - right.index)\n    .filter((value) => value.content.length > 0);\n}\n\nexport function buildActiveRecallQueryBundle(\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n): string {\n  if (config.queryMode === \"message\") {\n    return collapseWhitespace(input.currentMessage);\n  }\n\n  const userTurns = cropTurns(\n    input.recentTurns,\n    \"user\",\n    config.recentUserTurns,\n    config.recentUserChars,\n  );\n  const assistantTurns = cropTurns(\n    input.recentTurns,\n    \"assistant\",\n    config.recentAssistantTurns,\n    config.recentAssistantChars,\n  );\n  const mergedTurns = mergeChronologicalTurns(userTurns, assistantTurns);\n\n  const parts = [\n    ...mergedTurns.map((turn) => `${turn.role}: ${turn.content}`),\n  ];\n\n  if (config.queryMode === \"full\") {\n    return [...parts, `current: ${collapseWhitespace(input.currentMessage)}`]\n      .filter((value) => value.trim().length > 0)\n      .join(\"\\n\");\n  }\n\n  return [`current: ${collapseWhitespace(input.currentMessage)}`, ...parts]\n    .filter((value) => value.trim().length > 0)\n    .join(\"\\n\");\n}\n\nexport function normalizeActiveRecallSummary(value: string | null, maxChars: number): string | null {\n  if (value == null) return null;\n  const compact = collapseWhitespace(value);\n  if (NONE_SET.has(compact.toLowerCase())) return null;\n  return truncateCodePointSafe(compact, maxChars);\n}\n\nfunction sanitizeTranscriptPathSegment(value: string): string {\n  const normalized = collapseWhitespace(value);\n  return encodeURIComponent(normalized.length > 0 ? normalized : \"unknown\").replaceAll(\n    \".\",\n    \"%2E\",\n  );\n}\n\nexport function buildActiveRecallPrompt(params: {\n  config: ActiveRecallConfig;\n  queryBundle: string;\n  recallContext: string | null;\n  graphContext: string[];\n  causalContext: string[];\n  daySummary: string | null;\n  recallExplain: string | null;\n}): string {\n  const promptReplacement = params.config.promptReplacement?.trim();\n  if (promptReplacement) {\n    return promptReplacement;\n  }\n\n  const sections = [\n    params.config.customInstruction?.trim() || STYLE_INSTRUCTIONS[params.config.promptStyle],\n    `Query bundle:\\n${params.queryBundle}`,\n    params.recallContext ? `Retrieved memory:\\n${params.recallContext}` : null,\n    params.graphContext.length > 0 ? `Entity graph:\\n${params.graphContext.join(\"\\n\")}` : null,\n    params.causalContext.length > 0 ? `Causal trajectories:\\n${params.causalContext.join(\"\\n\")}` : null,\n    params.daySummary ? `Day summary:\\n${params.daySummary}` : null,\n    params.recallExplain ? `Recall explain:\\n${params.recallExplain}` : null,\n    params.config.promptAppend?.trim() || null,\n    \"Return either NONE or a compact summary grounded only in the supplied context.\",\n  ];\n  return sections.filter((value): value is string => !!value && value.trim().length > 0).join(\"\\n\\n\");\n}\n\nasync function appendActiveRecallTranscript(\n  transcriptRoot: string,\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n  result: ActiveRecallResult,\n  queryBundle: string,\n): Promise<string> {\n  const date = new Date().toISOString().slice(0, 10);\n  const filePath = path.join(\n    transcriptRoot,\n    \"agents\",\n    sanitizeTranscriptPathSegment(input.agentId),\n    date,\n    `${sanitizeTranscriptPathSegment(input.sessionKey)}.jsonl`,\n  );\n  await mkdir(path.dirname(filePath), { recursive: true });\n  await appendFile(\n    filePath,\n    `${JSON.stringify({\n      ts: new Date().toISOString(),\n      sessionKey: input.sessionKey,\n      agentId: input.agentId,\n      queryMode: config.queryMode,\n      promptStyle: config.promptStyle,\n      queryBundle,\n      summary: result.summary,\n      citations: result.citations,\n      latencyMs: result.latencyMs,\n      cacheHit: result.cacheHit,\n      modelUsed: result.modelUsed,\n    })}\\n`,\n    \"utf8\",\n  );\n  return filePath;\n}\n\nexport function createActiveRecallEngine(\n  deps: ActiveRecallDependencies,\n  config: ActiveRecallConfig,\n) {\n  const cache = new Map<string, CachedRecallResult>();\n  const now = deps.now ?? (() => Date.now());\n\n  return {\n    async run(input: ActiveRecallInput): Promise<ActiveRecallResult> {\n      if (!config.enabled) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"disabled\",\n          transcriptPath: null,\n        };\n      }\n      if (config.agents && !config.agents.includes(input.agentId)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n      if (!config.allowedChatTypes.includes(input.chatType)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n\n      const queryBundle = buildActiveRecallQueryBundle(input, config);\n      const cacheKey = buildCacheKey(input, config, queryBundle);\n      const currentTime = now();\n      const cacheEnabled = config.cacheTtlMs > 0;\n      if (cacheEnabled) {\n        pruneExpiredCache(cache, currentTime);\n      }\n      const cached = cache.get(cacheKey);\n      if (cacheEnabled && cached) {\n        const result: ActiveRecallResult = {\n          ...cloneRecallResult(cached.value),\n          latencyMs: Math.max(0, now() - currentTime),\n          cacheHit: true,\n        };\n        result.transcriptPath = null;\n        if (config.persistTranscripts) {\n          try {\n            result.transcriptPath = await appendActiveRecallTranscript(\n              config.transcriptDir,\n              input,\n              config,\n              result,\n              queryBundle,\n            );\n          } catch {\n            result.transcriptPath = null;\n          }\n        }\n        return result;\n      }\n\n      const start = currentTime;\n      const recallContext = await deps.recall(queryBundle, input.sessionKey);\n      const graphContext =\n        config.entityGraphDepth > 0 && deps.walkEntityGraph\n          ? await deps.walkEntityGraph({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n              depth: config.entityGraphDepth,\n            })\n          : [];\n      const causalContext =\n        config.includeCausalTrajectories && deps.loadCausalTrajectories\n          ? await deps.loadCausalTrajectories({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n            })\n          : [];\n      const daySummary =\n        config.includeDaySummary && deps.loadDaySummary\n          ? await deps.loadDaySummary(input.sessionKey)\n          : null;\n      const recallExplain =\n        config.attachRecallExplain && deps.explainLastRecall\n          ? await deps.explainLastRecall(input.sessionKey)\n          : null;\n      const prompt = buildActiveRecallPrompt({\n        config,\n        queryBundle,\n        recallContext,\n        graphContext,\n        causalContext,\n        daySummary,\n        recallExplain,\n      });\n\n      const generated = deps.generateSummary\n        ? await deps.generateSummary({\n            prompt,\n            sessionKey: input.sessionKey,\n            agentId: input.agentId,\n            model: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            timeoutMs: config.timeoutMs,\n            thinking: config.thinking,\n            fallbackPolicy: config.modelFallbackPolicy,\n          })\n        : {\n            text: recallContext,\n            modelUsed: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            cacheHit: false,\n          };\n      const summary = normalizeActiveRecallSummary(\n        generated.text,\n        config.maxSummaryChars,\n      );\n      const snapshot = deps.getLastRecallSnapshot?.(input.sessionKey);\n      const citations = (snapshot?.memoryIds ?? []).map((memoryId, index) => ({\n        memoryId,\n        relevance: Number((1 / (index + 1)).toFixed(3)),\n      }));\n      const result: ActiveRecallResult = {\n        summary,\n        citations,\n        latencyMs: Math.max(0, now() - start),\n        cacheHit: generated.cacheHit === true,\n        modelUsed: generated.modelUsed ?? config.modelOverride ?? DEFAULT_REASONING_MODEL,\n        transcriptPath: null,\n      };\n      if (config.persistTranscripts) {\n        try {\n          result.transcriptPath = await appendActiveRecallTranscript(\n            config.transcriptDir,\n            input,\n            config,\n            result,\n            queryBundle,\n          );\n        } catch {\n          result.transcriptPath = null;\n        }\n      }\n\n      if (cacheEnabled) {\n        const completedAt = now();\n        const cachedValue = cloneRecallResult(result);\n        cachedValue.transcriptPath = null;\n        cache.set(cacheKey, {\n          expiresAt: completedAt + config.cacheTtlMs,\n          value: cachedValue,\n        });\n        enforceCacheLimit(cache);\n      }\n      return result;\n    },\n  };\n}\n"],"mappings":"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","names":["result"]}
+{"version":3,"sources":["../src/active-recall.ts"],"sourcesContent":["import { appendFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { DEFAULT_REASONING_MODEL } from \"./config.js\";\nimport { collapseWhitespace, truncateCodePointSafe } from \"./whitespace.js\";\nimport type {\n  ActiveRecallChatType,\n  ActiveRecallModelFallbackPolicy,\n  ActiveRecallPromptStyle,\n  ActiveRecallQueryMode,\n  ActiveRecallThinking,\n} from \"./types.js\";\n\nexport interface ActiveRecallTurn {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface ActiveRecallInput {\n  sessionKey: string;\n  agentId: string;\n  chatType: ActiveRecallChatType;\n  recentTurns: ActiveRecallTurn[];\n  currentMessage: string;\n}\n\nexport interface ActiveRecallConfig {\n  enabled: boolean;\n  agents: string[] | null;\n  allowedChatTypes: ActiveRecallChatType[];\n  queryMode: ActiveRecallQueryMode;\n  promptStyle: ActiveRecallPromptStyle;\n  customInstruction: string | null;\n  promptReplacement: string | null;\n  promptAppend: string | null;\n  maxSummaryChars: number;\n  recentUserTurns: number;\n  recentAssistantTurns: number;\n  recentUserChars: number;\n  recentAssistantChars: number;\n  thinking: ActiveRecallThinking;\n  timeoutMs: number;\n  cacheTtlMs: number;\n  persistTranscripts: boolean;\n  transcriptDir: string;\n  entityGraphDepth: number;\n  includeCausalTrajectories: boolean;\n  includeDaySummary: boolean;\n  attachRecallExplain: boolean;\n  modelOverride: string | null;\n  modelFallbackPolicy: ActiveRecallModelFallbackPolicy;\n}\n\nexport interface ActiveRecallResult {\n  summary: string | null;\n  citations: Array<{ memoryId: string; relevance: number }>;\n  latencyMs: number;\n  cacheHit: boolean;\n  modelUsed: string;\n  transcriptPath: string | null;\n}\n\nexport interface ActiveRecallDependencies {\n  recall(query: string, sessionKey: string): Promise<string | null>;\n  getLastRecallSnapshot?(sessionKey: string): { memoryIds?: string[] } | null;\n  walkEntityGraph?(params: {\n    sessionKey: string;\n    query: string;\n    depth: number;\n  }): Promise<string[]>;\n  loadCausalTrajectories?(params: {\n    sessionKey: string;\n    query: string;\n  }): Promise<string[]>;\n  loadDaySummary?(sessionKey: string): Promise<string | null>;\n  explainLastRecall?(sessionKey: string): Promise<string | null>;\n  generateSummary?(params: {\n    prompt: string;\n    sessionKey: string;\n    agentId: string;\n    model: string;\n    timeoutMs: number;\n    thinking: ActiveRecallThinking;\n    fallbackPolicy: ActiveRecallModelFallbackPolicy;\n  }): Promise<{ text: string | null; modelUsed?: string; cacheHit?: boolean }>;\n  now?: () => number;\n}\n\ninterface CachedRecallResult {\n  expiresAt: number;\n  value: ActiveRecallResult;\n}\n\ninterface ActiveRecallTurnWithIndex {\n  index: number;\n  role: ActiveRecallTurn[\"role\"];\n  content: string;\n}\n\nconst ACTIVE_RECALL_CACHE_MAX_ENTRIES = 256;\n\nconst NONE_SET = new Set([\n  \"\",\n  \"none\",\n  \"no_reply\",\n  \"nothing useful\",\n  \"no relevant memory\",\n  \"timeout\",\n  \"[]\",\n  \"{}\",\n  \"null\",\n  \"n/a\",\n]);\n\nconst STYLE_INSTRUCTIONS: Record<ActiveRecallPromptStyle, string> = {\n  balanced: \"Summarize the most relevant memory context in a compact, neutral way.\",\n  strict: \"Only include memory that is directly supported by the retrieved context.\",\n  contextual: \"Prefer concise context that helps the next reply stay grounded in recent work.\",\n  \"recall-heavy\": \"Bias toward richer recall coverage when multiple retrieved items reinforce each other.\",\n  \"precision-heavy\": \"Bias toward precision. Omit anything uncertain or weakly supported.\",\n  \"preference-only\": \"Only surface user preference or operating-style memory when present.\",\n};\n\nfunction cloneRecallResult(value: ActiveRecallResult): ActiveRecallResult {\n  return {\n    ...value,\n    citations: [...value.citations],\n  };\n}\n\nfunction buildCacheKey(input: ActiveRecallInput, config: ActiveRecallConfig, queryBundle: string): string {\n  return JSON.stringify({\n    sessionKey: input.sessionKey,\n    agentId: input.agentId,\n    queryMode: config.queryMode,\n    promptStyle: config.promptStyle,\n    customInstruction: config.customInstruction,\n    promptReplacement: config.promptReplacement,\n    promptAppend: config.promptAppend,\n    maxSummaryChars: config.maxSummaryChars,\n    entityGraphDepth: config.entityGraphDepth,\n    includeCausalTrajectories: config.includeCausalTrajectories,\n    includeDaySummary: config.includeDaySummary,\n    attachRecallExplain: config.attachRecallExplain,\n    modelOverride: config.modelOverride,\n    modelFallbackPolicy: config.modelFallbackPolicy,\n    thinking: config.thinking,\n    queryBundle,\n  });\n}\n\nfunction pruneExpiredCache(\n  cache: Map<string, CachedRecallResult>,\n  currentTime: number,\n): void {\n  for (const [key, entry] of cache.entries()) {\n    if (entry.expiresAt <= currentTime) {\n      cache.delete(key);\n    }\n  }\n}\n\nfunction enforceCacheLimit(cache: Map<string, CachedRecallResult>): void {\n  while (cache.size > ACTIVE_RECALL_CACHE_MAX_ENTRIES) {\n    const oldestKey = cache.keys().next().value;\n    if (typeof oldestKey !== \"string\") {\n      break;\n    }\n    cache.delete(oldestKey);\n  }\n}\n\nfunction cropTurns(\n  turns: ActiveRecallTurn[],\n  role: \"user\" | \"assistant\",\n  maxTurns: number,\n  maxChars: number,\n): ActiveRecallTurnWithIndex[] {\n  if (maxTurns <= 0) {\n    return [];\n  }\n\n  const selected: ActiveRecallTurnWithIndex[] = [];\n  for (let index = turns.length - 1; index >= 0 && selected.length < maxTurns; index -= 1) {\n    const turn = turns[index];\n    if (turn?.role === role) {\n      selected.push({\n        index,\n        role: turn.role,\n        content: collapseWhitespace(truncateCodePointSafe(turn.content, maxChars)),\n      });\n    }\n  }\n\n  return selected.reverse();\n}\n\nfunction mergeChronologicalTurns(\n  userTurns: ActiveRecallTurnWithIndex[],\n  assistantTurns: ActiveRecallTurnWithIndex[],\n): ActiveRecallTurnWithIndex[] {\n  return [...userTurns, ...assistantTurns]\n    .sort((left, right) => left.index - right.index)\n    .filter((value) => value.content.length > 0);\n}\n\nexport function buildActiveRecallQueryBundle(\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n): string {\n  if (config.queryMode === \"message\") {\n    return collapseWhitespace(input.currentMessage);\n  }\n\n  const userTurns = cropTurns(\n    input.recentTurns,\n    \"user\",\n    config.recentUserTurns,\n    config.recentUserChars,\n  );\n  const assistantTurns = cropTurns(\n    input.recentTurns,\n    \"assistant\",\n    config.recentAssistantTurns,\n    config.recentAssistantChars,\n  );\n  const mergedTurns = mergeChronologicalTurns(userTurns, assistantTurns);\n\n  const parts = [\n    ...mergedTurns.map((turn) => `${turn.role}: ${turn.content}`),\n  ];\n\n  if (config.queryMode === \"full\") {\n    return [...parts, `current: ${collapseWhitespace(input.currentMessage)}`]\n      .filter((value) => value.trim().length > 0)\n      .join(\"\\n\");\n  }\n\n  return [`current: ${collapseWhitespace(input.currentMessage)}`, ...parts]\n    .filter((value) => value.trim().length > 0)\n    .join(\"\\n\");\n}\n\nexport function normalizeActiveRecallSummary(value: string | null, maxChars: number): string | null {\n  if (value == null) return null;\n  const compact = collapseWhitespace(value);\n  if (NONE_SET.has(compact.toLowerCase())) return null;\n  return truncateCodePointSafe(compact, maxChars);\n}\n\nfunction sanitizeTranscriptPathSegment(value: string): string {\n  const normalized = collapseWhitespace(value);\n  return encodeURIComponent(normalized.length > 0 ? normalized : \"unknown\").replaceAll(\n    \".\",\n    \"%2E\",\n  );\n}\n\nexport function buildActiveRecallPrompt(params: {\n  config: ActiveRecallConfig;\n  queryBundle: string;\n  recallContext: string | null;\n  graphContext: string[];\n  causalContext: string[];\n  daySummary: string | null;\n  recallExplain: string | null;\n}): string {\n  const promptReplacement = params.config.promptReplacement?.trim();\n  if (promptReplacement) {\n    return promptReplacement;\n  }\n\n  const sections = [\n    params.config.customInstruction?.trim() || STYLE_INSTRUCTIONS[params.config.promptStyle],\n    `Query bundle:\\n${params.queryBundle}`,\n    params.recallContext ? `Retrieved memory:\\n${params.recallContext}` : null,\n    params.graphContext.length > 0 ? `Entity graph:\\n${params.graphContext.join(\"\\n\")}` : null,\n    params.causalContext.length > 0 ? `Causal trajectories:\\n${params.causalContext.join(\"\\n\")}` : null,\n    params.daySummary ? `Day summary:\\n${params.daySummary}` : null,\n    params.recallExplain ? `Recall explain:\\n${params.recallExplain}` : null,\n    params.config.promptAppend?.trim() || null,\n    \"Return either NONE or a compact summary grounded only in the supplied context.\",\n  ];\n  return sections.filter((value): value is string => !!value && value.trim().length > 0).join(\"\\n\\n\");\n}\n\nasync function appendActiveRecallTranscript(\n  transcriptRoot: string,\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n  result: ActiveRecallResult,\n  queryBundle: string,\n): Promise<string> {\n  const date = new Date().toISOString().slice(0, 10);\n  const filePath = path.join(\n    transcriptRoot,\n    \"agents\",\n    sanitizeTranscriptPathSegment(input.agentId),\n    date,\n    `${sanitizeTranscriptPathSegment(input.sessionKey)}.jsonl`,\n  );\n  await mkdir(path.dirname(filePath), { recursive: true });\n  await appendFile(\n    filePath,\n    `${JSON.stringify({\n      ts: new Date().toISOString(),\n      sessionKey: input.sessionKey,\n      agentId: input.agentId,\n      queryMode: config.queryMode,\n      promptStyle: config.promptStyle,\n      queryBundle,\n      summary: result.summary,\n      citations: result.citations,\n      latencyMs: result.latencyMs,\n      cacheHit: result.cacheHit,\n      modelUsed: result.modelUsed,\n    })}\\n`,\n    \"utf8\",\n  );\n  return filePath;\n}\n\nexport function createActiveRecallEngine(\n  deps: ActiveRecallDependencies,\n  config: ActiveRecallConfig,\n) {\n  const cache = new Map<string, CachedRecallResult>();\n  const now = deps.now ?? (() => Date.now());\n\n  return {\n    async run(input: ActiveRecallInput): Promise<ActiveRecallResult> {\n      if (!config.enabled) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"disabled\",\n          transcriptPath: null,\n        };\n      }\n      if (config.agents && !config.agents.includes(input.agentId)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n      if (!config.allowedChatTypes.includes(input.chatType)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n\n      const queryBundle = buildActiveRecallQueryBundle(input, config);\n      const cacheKey = buildCacheKey(input, config, queryBundle);\n      const currentTime = now();\n      const cacheEnabled = config.cacheTtlMs > 0;\n      if (cacheEnabled) {\n        pruneExpiredCache(cache, currentTime);\n      }\n      const cached = cache.get(cacheKey);\n      if (cacheEnabled && cached) {\n        const result: ActiveRecallResult = {\n          ...cloneRecallResult(cached.value),\n          latencyMs: Math.max(0, now() - currentTime),\n          cacheHit: true,\n        };\n        result.transcriptPath = null;\n        if (config.persistTranscripts) {\n          try {\n            result.transcriptPath = await appendActiveRecallTranscript(\n              config.transcriptDir,\n              input,\n              config,\n              result,\n              queryBundle,\n            );\n          } catch {\n            result.transcriptPath = null;\n          }\n        }\n        return result;\n      }\n\n      const start = currentTime;\n      const recallContext = await deps.recall(queryBundle, input.sessionKey);\n      const graphContext =\n        config.entityGraphDepth > 0 && deps.walkEntityGraph\n          ? await deps.walkEntityGraph({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n              depth: config.entityGraphDepth,\n            })\n          : [];\n      const causalContext =\n        config.includeCausalTrajectories && deps.loadCausalTrajectories\n          ? await deps.loadCausalTrajectories({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n            })\n          : [];\n      const daySummary =\n        config.includeDaySummary && deps.loadDaySummary\n          ? await deps.loadDaySummary(input.sessionKey)\n          : null;\n      const recallExplain =\n        config.attachRecallExplain && deps.explainLastRecall\n          ? await deps.explainLastRecall(input.sessionKey)\n          : null;\n      const prompt = buildActiveRecallPrompt({\n        config,\n        queryBundle,\n        recallContext,\n        graphContext,\n        causalContext,\n        daySummary,\n        recallExplain,\n      });\n\n      const generated = deps.generateSummary\n        ? await deps.generateSummary({\n            prompt,\n            sessionKey: input.sessionKey,\n            agentId: input.agentId,\n            model: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            timeoutMs: config.timeoutMs,\n            thinking: config.thinking,\n            fallbackPolicy: config.modelFallbackPolicy,\n          })\n        : {\n            text: recallContext,\n            modelUsed: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            cacheHit: false,\n          };\n      const summary = normalizeActiveRecallSummary(\n        generated.text,\n        config.maxSummaryChars,\n      );\n      const snapshot = deps.getLastRecallSnapshot?.(input.sessionKey);\n      const citations = (snapshot?.memoryIds ?? []).map((memoryId, index) => ({\n        memoryId,\n        relevance: Number((1 / (index + 1)).toFixed(3)),\n      }));\n      const result: ActiveRecallResult = {\n        summary,\n        citations,\n        latencyMs: Math.max(0, now() - start),\n        cacheHit: generated.cacheHit === true,\n        modelUsed: generated.modelUsed ?? config.modelOverride ?? DEFAULT_REASONING_MODEL,\n        transcriptPath: null,\n      };\n      if (config.persistTranscripts) {\n        try {\n          result.transcriptPath = await appendActiveRecallTranscript(\n            config.transcriptDir,\n            input,\n            config,\n            result,\n            queryBundle,\n          );\n        } catch {\n          result.transcriptPath = null;\n        }\n      }\n\n      if (cacheEnabled) {\n        const completedAt = now();\n        const cachedValue = cloneRecallResult(result);\n        cachedValue.transcriptPath = null;\n        cache.set(cacheKey, {\n          expiresAt: completedAt + config.cacheTtlMs,\n          value: cachedValue,\n        });\n        enforceCacheLimit(cache);\n      }\n      return result;\n    },\n  };\n}\n"],"mappings":"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","names":["result"]}

package/dist/adapters/index.js

@@ -3,7 +3,10 @@ import {
   AdapterRegistry,
   GrokAdapter,
   OpenCodeAdapter
-} from "../chunk-XTN54NML.js";
+} from "../chunk-G3T6YMBO.js";
+import {
+  ReplitAdapter
+} from "../chunk-SI36RWC3.js";
 import {
   ClaudeCodeAdapter
 } from "../chunk-3JKYQBLC.js";
@@ -13,9 +16,6 @@ import {
 import {
   HermesAdapter
 } from "../chunk-HCAGBFE7.js";
-import {
-  ReplitAdapter
-} from "../chunk-SI36RWC3.js";
 import "../chunk-NJAIR57U.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/adapters/registry.js

@@ -1,10 +1,10 @@
 import {
   AdapterRegistry
-} from "../chunk-XTN54NML.js";
+} from "../chunk-G3T6YMBO.js";
+import "../chunk-SI36RWC3.js";
 import "../chunk-3JKYQBLC.js";
 import "../chunk-7RKSJVOQ.js";
 import "../chunk-HCAGBFE7.js";
-import "../chunk-SI36RWC3.js";
 import "../chunk-NJAIR57U.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/{auto-sync-BNCBMU6H.js → auto-sync-UQQ6YJSB.js}

@@ -1,7 +1,7 @@
 import {
   dateInTimezone,
   defaultTimezone
-} from "./chunk-2AV2U2SZ.js";
+} from "./chunk-YDIOMDBW.js";
 import "./chunk-TJ5YGCPV.js";
 import "./chunk-UOBPK2OS.js";
 import "./chunk-CIO7GCWE.js";
@@ -21,7 +21,7 @@ import "./chunk-YIJECSIX.js";
 import "./chunk-E2AWJ7KQ.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-YFXRLRKP.js";
+import "./chunk-S4OZKPBS.js";
 import "./chunk-353C5UNV.js";
 import "./chunk-TWRPWJJT.js";
 import "./chunk-BT7NVCML.js";
@@ -98,4 +98,4 @@ function startWearablesAutoSync(settings, deps) {
 export {
   startWearablesAutoSync
 };
-//# sourceMappingURL=auto-sync-BNCBMU6H.js.map
+//# sourceMappingURL=auto-sync-UQQ6YJSB.js.map

package/dist/briefing-deadline.d.ts

@@ -0,0 +1,7 @@
+export declare const BRIEFING_DEADLINE_MS = 30000;
+export declare class BriefingTimeoutError extends Error {
+    readonly deadlineMs: number;
+    constructor(deadlineMs: number);
+}
+export declare function withBriefingDeadline<T>(run: (signal: AbortSignal) => Promise<T>, abortSignal?: AbortSignal): Promise<T>;
+//# sourceMappingURL=briefing-deadline.d.ts.map

package/dist/briefing-deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing-deadline.d.ts","sourceRoot":"","sources":["../src/briefing-deadline.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,qBAAa,oBAAqB,SAAQ,KAAK;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAIxC;AAED,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACxC,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,CAAC,CAAC,CAkBZ"}

package/dist/briefing-deadline.js

@@ -0,0 +1,13 @@
+import {
+  BRIEFING_DEADLINE_MS,
+  BriefingTimeoutError,
+  withBriefingDeadline
+} from "./chunk-X2KO4FK5.js";
+import "./chunk-R2MBW2S4.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  BRIEFING_DEADLINE_MS,
+  BriefingTimeoutError,
+  withBriefingDeadline
+};
+//# sourceMappingURL=briefing-deadline.js.map

package/dist/briefing-window.d.ts

@@ -1,10 +1,9 @@
-import type { MemoryFile } from "./types.js";
+import type { EntityFile, MemoryFile } from "./types.js";
 import type { CorpusReadOptions } from "./corpus-read-cancellation.js";
 import type { ParsedBriefingWindow } from "./briefing.js";
+import type { WindowedMemoryReadOptions } from "./storage/windowed-memory-read.js";
 type BriefingMemoryReader = {
-    readMemoriesWindow?: (options: {
-        updatedAfter?: Date;
-    }) => Promise<{
+    readMemoriesWindow?: (options: WindowedMemoryReadOptions) => Promise<{
         memories: MemoryFile[];
     }>;
     readAllMemories: ((options?: CorpusReadOptions) => Promise<MemoryFile[]>) & {
@@ -29,8 +28,17 @@ export declare const BRIEFING_FULL_READ_FALLBACK_MS = 30000;
 export interface SafeReadMemoriesOptions {
     /** Test seam overriding {@link BRIEFING_FULL_READ_FALLBACK_MS}. */
     fallbackDeadlineMs?: number;
+    /**
+     * Caller cancellation. The signal reaches the storage read so it stops at
+     * its next boundary, and a cancelled read is rethrown rather than degraded
+     * into an empty corpus (issue #3139).
+     */
+    signal?: AbortSignal;
 }
 /** Read only the memories needed by a briefing, with compatibility fallback. */
 export declare function safeReadMemories(storage: BriefingMemoryReader, window: ParsedBriefingWindow, options?: SafeReadMemoriesOptions): Promise<MemoryFile[]>;
+export declare function safeReadEntities(storage: {
+    readAllEntityFiles(options?: CorpusReadOptions): Promise<EntityFile[]>;
+}, signal: AbortSignal): Promise<EntityFile[]>;
 export {};
 //# sourceMappingURL=briefing-window.d.ts.map

package/dist/briefing-window.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"briefing-window.d.ts","sourceRoot":"","sources":["../src/briefing-window.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,KAAK,oBAAoB,GAAG;IAC1B,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,YAAY,CAAC,EAAE,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/F,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG;QAC1E,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;IACF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA0FD,gFAAgF;AAChF,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,UAAU,EAAE,CAAC,CAqCvB"}
+{"version":3,"file":"briefing-window.d.ts","sourceRoot":"","sources":["../src/briefing-window.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAEnF,KAAK,oBAAoB,GAAG;IAC1B,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC;IACjG,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG;QAC1E,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;IACF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA0FD,gFAAgF;AAChF,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,UAAU,EAAE,CAAC,CA2CvB;AAwDD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE;IAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;CAAE,EACnF,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvB"}

package/dist/briefing-window.js

@@ -1,12 +1,14 @@
 import {
   BRIEFING_FULL_READ_FALLBACK_MS,
+  safeReadEntities,
   safeReadMemories
-} from "./chunk-FRXS6SC7.js";
+} from "./chunk-EKUI7I2X.js";
 import "./chunk-R2MBW2S4.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 export {
   BRIEFING_FULL_READ_FALLBACK_MS,
+  safeReadEntities,
   safeReadMemories
 };
 //# sourceMappingURL=briefing-window.js.map

package/dist/briefing.d.ts

@@ -131,6 +131,8 @@ export interface BuildBriefingOptions {
     followupGenerator?: BriefingFollowupGenerator;
     /** Injected "now" — makes tests deterministic. */
     now?: Date;
+    /** Caller cancellation must not consume correction notifications. */
+    abortSignal?: AbortSignal;
 }
 /**
  * Build the daily context briefing.

package/dist/briefing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"briefing.d.ts","sourceRoot":"","sources":["../src/briefing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"briefing.d.ts","sourceRoot":"","sources":["../src/briefing.ts"],"names":[],"mappings":"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"}

package/dist/briefing.js

@@ -18,23 +18,24 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-UXAF4RQM.js";
+} from "./chunk-HKOMHP6D.js";
+import "./chunk-X2KO4FK5.js";
 import "./chunk-GZFKCLRC.js";
-import "./chunk-FRXS6SC7.js";
-import "./chunk-L46MG2GE.js";
+import "./chunk-EKUI7I2X.js";
+import "./chunk-GQIYL7OD.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-DM5QZ3YU.js";
-import "./chunk-VY6BD5KB.js";
+import "./chunk-ZMO2S5RT.js";
 import "./chunk-G6OFEGUR.js";
-import "./chunk-PJBYVJKO.js";
-import "./chunk-2V664H6O.js";
+import "./chunk-LXXIV7Y2.js";
+import "./chunk-JS44PBCM.js";
+import "./chunk-5CWH2LKL.js";
 import "./chunk-XKDQTDXN.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-XRFLR3XF.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-EXYT52NR.js";
-import "./chunk-5CWH2LKL.js";
 import "./chunk-WNEVEMJ3.js";
+import "./chunk-EXYT52NR.js";
 import "./chunk-Y5NLBXPV.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
@@ -43,35 +44,37 @@ import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-PPUNC7UX.js";
 import "./chunk-X3724WL4.js";
-import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-LDXUBPMO.js";
+import "./chunk-MRPOZBJC.js";
 import "./chunk-DM2T26WE.js";
+import "./chunk-LDXUBPMO.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-WXPBDEMW.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-MPJDQC4G.js";
+import "./chunk-WJCXUE2J.js";
 import "./chunk-ZIKENA2C.js";
-import "./chunk-3ONXXHQO.js";
-import "./chunk-YXZG5TVN.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-P4GUQSK3.js";
+import "./chunk-3ONXXHQO.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-3WU7XOFN.js";
-import "./chunk-G7D6GZ5J.js";
-import "./chunk-2NLCDNGA.js";
+import "./chunk-P4GUQSK3.js";
+import "./chunk-564YP3DW.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-LWRIGKFM.js";
+import "./chunk-A5L5KGDI.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
-import "./chunk-I3IPXGFQ.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-7VLBZKNB.js";
+import "./chunk-UUZ7KZAO.js";
+import "./chunk-AJJPXUE6.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-VILPVT4S.js";
 import "./chunk-AF2XMJKD.js";
 import "./chunk-OR42ZI54.js";
 import "./chunk-IUM3VSHI.js";
-import "./chunk-VILPVT4S.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
@@ -81,7 +84,6 @@ import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
 import "./chunk-YIJECSIX.js";
 import "./chunk-E2AWJ7KQ.js";
-import "./chunk-UUZ7KZAO.js";
 import "./chunk-HADD45AR.js";
 import "./chunk-RNFMFC37.js";
 import "./chunk-YCVB7X56.js";

package/dist/buffer.js

@@ -1,27 +1,27 @@
 import {
   SmartBuffer
-} from "./chunk-CMNL3QSL.js";
+} from "./chunk-IN6U2BS5.js";
 import "./chunk-KASJJGRG.js";
 import "./chunk-4OFXLQJD.js";
 import "./chunk-H3FZVNRN.js";
-import "./chunk-6CC2YCKG.js";
-import "./chunk-2NX7JTST.js";
+import "./chunk-43TUWQNR.js";
+import "./chunk-MPWOAIIH.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";
 import "./chunk-KZMRMKC7.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-ZJP66Q4I.js";
-import "./chunk-I3IPXGFQ.js";
+import "./chunk-AJJPXUE6.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-VILPVT4S.js";
 import "./chunk-AF2XMJKD.js";
 import "./chunk-OR42ZI54.js";
 import "./chunk-IUM3VSHI.js";
-import "./chunk-VILPVT4S.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
-import "./chunk-YFXRLRKP.js";
+import "./chunk-S4OZKPBS.js";
 import "./chunk-353C5UNV.js";
 import "./chunk-TWRPWJJT.js";
 import "./chunk-BT7NVCML.js";

package/dist/calibration.js

@@ -4,11 +4,11 @@ import {
 import "./chunk-QW27DOHG.js";
 import {
   LocalLlmClient
-} from "./chunk-JNLYHJG7.js";
+} from "./chunk-74AY3S7U.js";
 import "./chunk-T6OZW2WR.js";
-import "./chunk-5YQXWVCP.js";
 import "./chunk-QEDLJDHP.js";
 import "./chunk-U4LUIE6Y.js";
+import "./chunk-5YQXWVCP.js";
 import "./chunk-TOTT6S2V.js";
 import {
   FallbackLlmClient

package/dist/{capsule-crypto-GWVG7LGC.js → capsule-crypto-7FJQINUR.js}

@@ -3,7 +3,7 @@ import {
   decryptCapsuleFileInMemory,
   encryptCapsuleFile,
   isEncryptedCapsuleFile
-} from "./chunk-UVYI6VIX.js";
+} from "./chunk-X7Y7WX73.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
@@ -15,4 +15,4 @@ export {
   encryptCapsuleFile,
   isEncryptedCapsuleFile
 };
-//# sourceMappingURL=capsule-crypto-GWVG7LGC.js.map
+//# sourceMappingURL=capsule-crypto-7FJQINUR.js.map

package/dist/{capsule-merge-RNQUP2VL.js → capsule-merge-D4BTIJGK.js}

@@ -1,6 +1,6 @@
 import {
   createVersion
-} from "./chunk-2NLCDNGA.js";
+} from "./chunk-564YP3DW.js";
 import {
   bumpMemoryCorpusVersionForDir
 } from "./chunk-M5GVCJSJ.js";
@@ -13,7 +13,7 @@ import {
   repairContentAfterJournalMove,
   requestEntityCanonicalIdReconcile,
   withRawEntityPageMutation
-} from "./chunk-LWRIGKFM.js";
+} from "./chunk-A5L5KGDI.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
@@ -280,4 +280,4 @@ async function readLocalFile(absPath) {
 export {
   mergeCapsule
 };
-//# sourceMappingURL=capsule-merge-RNQUP2VL.js.map
+//# sourceMappingURL=capsule-merge-D4BTIJGK.js.map

package/dist/capture-write-lock-scope.d.ts

@@ -0,0 +1,7 @@
+import type { CaptureWriteLockBackoffLimits, CaptureWriteLockLimitSource } from "./capture-write-lock-backoff.js";
+import type { StorageManager } from "./storage.js";
+type CaptureLockOwner = Pick<StorageManager, "dir">;
+export declare function withCaptureWriteLockBackoff<T>(storage: CaptureLockOwner, limits: CaptureWriteLockBackoffLimits, run: () => Promise<T>): Promise<T>;
+export declare function scopedCaptureWriteLockLimits(storage: CaptureLockOwner): CaptureWriteLockLimitSource | undefined;
+export {};
+//# sourceMappingURL=capture-write-lock-scope.d.ts.map

package/dist/capture-write-lock-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-write-lock-scope.d.ts","sourceRoot":"","sources":["../src/capture-write-lock-scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAClH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,KAAK,gBAAgB,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;AAIpD,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,6BAA6B,EACrC,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAYZ;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,gBAAgB,GAAG,2BAA2B,GAAG,SAAS,CAG/G"}

package/dist/capture-write-lock-scope.js

@@ -0,0 +1,10 @@
+import {
+  scopedCaptureWriteLockLimits,
+  withCaptureWriteLockBackoff
+} from "./chunk-7VLBZKNB.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  scopedCaptureWriteLockLimits,
+  withCaptureWriteLockBackoff
+};
+//# sourceMappingURL=capture-write-lock-scope.js.map

package/dist/causal-behavior.js

@@ -1,11 +1,11 @@
 import {
   readChainIndex,
   resolveChainsDir
-} from "./chunk-Q6UZREJK.js";
+} from "./chunk-RKRX4C4H.js";
 import "./chunk-B7RWBZXW.js";
 import {
   resolveCausalTrajectoryStoreDir
-} from "./chunk-VECRSYQG.js";
+} from "./chunk-NRGQ5HJO.js";
 import {
   normalizeRecallTokens
 } from "./chunk-YCVB7X56.js";

package/dist/causal-chain.js

@@ -6,9 +6,9 @@ import {
   stitchCausalChain,
   validateCausalEdge,
   writeChainIndex
-} from "./chunk-Q6UZREJK.js";
+} from "./chunk-RKRX4C4H.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-VECRSYQG.js";
+import "./chunk-NRGQ5HJO.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-A2IYSXDQ.js";
 import "./chunk-2Z5DIDQD.js";

package/dist/causal-consolidation.js

@@ -1,15 +1,15 @@
 import {
   readChainIndex,
   resolveChainsDir
-} from "./chunk-Q6UZREJK.js";
+} from "./chunk-RKRX4C4H.js";
 import {
   buildExtensionsBlockForConsolidation
-} from "./chunk-6HVLHIAB.js";
+} from "./chunk-P7OVFGMU.js";
 import "./chunk-5JMAGU26.js";
 import "./chunk-B7RWBZXW.js";
 import {
   runPostConsolidationMaterialize
-} from "./chunk-PPDNG7WC.js";
+} from "./chunk-NSP5PIQH.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-AL3TCNSJ.js";
 import "./chunk-TOTT6S2V.js";
@@ -18,21 +18,21 @@ import "./chunk-ZCUTSMR2.js";
 import "./chunk-QDW3E4RD.js";
 import {
   resolveCausalTrajectoryStoreDir
-} from "./chunk-VECRSYQG.js";
-import "./chunk-L46MG2GE.js";
+} from "./chunk-NRGQ5HJO.js";
+import "./chunk-GQIYL7OD.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-DM5QZ3YU.js";
-import "./chunk-VY6BD5KB.js";
+import "./chunk-ZMO2S5RT.js";
 import "./chunk-G6OFEGUR.js";
-import "./chunk-PJBYVJKO.js";
-import "./chunk-2V664H6O.js";
+import "./chunk-LXXIV7Y2.js";
+import "./chunk-JS44PBCM.js";
+import "./chunk-5CWH2LKL.js";
 import "./chunk-XKDQTDXN.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-XRFLR3XF.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-EXYT52NR.js";
-import "./chunk-5CWH2LKL.js";
 import "./chunk-WNEVEMJ3.js";
+import "./chunk-EXYT52NR.js";
 import "./chunk-Y5NLBXPV.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
@@ -41,35 +41,37 @@ import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-PPUNC7UX.js";
 import "./chunk-X3724WL4.js";
-import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-LDXUBPMO.js";
+import "./chunk-MRPOZBJC.js";
 import "./chunk-DM2T26WE.js";
+import "./chunk-LDXUBPMO.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-WXPBDEMW.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-MPJDQC4G.js";
+import "./chunk-WJCXUE2J.js";
 import "./chunk-ZIKENA2C.js";
-import "./chunk-3ONXXHQO.js";
-import "./chunk-YXZG5TVN.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-P4GUQSK3.js";
+import "./chunk-3ONXXHQO.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-3WU7XOFN.js";
-import "./chunk-G7D6GZ5J.js";
-import "./chunk-2NLCDNGA.js";
+import "./chunk-P4GUQSK3.js";
+import "./chunk-564YP3DW.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-LWRIGKFM.js";
+import "./chunk-A5L5KGDI.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
-import "./chunk-I3IPXGFQ.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-7VLBZKNB.js";
+import "./chunk-UUZ7KZAO.js";
+import "./chunk-AJJPXUE6.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-VILPVT4S.js";
 import "./chunk-AF2XMJKD.js";
 import "./chunk-OR42ZI54.js";
 import "./chunk-IUM3VSHI.js";
-import "./chunk-VILPVT4S.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
@@ -83,7 +85,6 @@ import {
   fallbackLlmRuntimeContextFromConfig
 } from "./chunk-YIJECSIX.js";
 import "./chunk-E2AWJ7KQ.js";
-import "./chunk-UUZ7KZAO.js";
 import "./chunk-HADD45AR.js";
 import "./chunk-RNFMFC37.js";
 import "./chunk-YCVB7X56.js";