@remnic/core 1.1.2 → 1.1.3

package/dist/access-service.d.ts

@@ -1,35 +1,40 @@
 import './storage.js';
+export { o as ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, p as EngramAccessBriefingRequest, q as EngramAccessBriefingResponse, r as EngramAccessCapsuleListResponse, s as EngramAccessDaySummaryRequest, t as EngramAccessEntityListResponse, u as EngramAccessEntityResponse, v as EngramAccessEntitySummary, w as EngramAccessHealthResponse, d as EngramAccessInputError, x as EngramAccessLcmSearchRequest, y as EngramAccessLcmSearchResponse, z as EngramAccessLcmStatusResponse, A as EngramAccessMaintenanceResponse, B as EngramAccessMemoryBrowseRequest, D as EngramAccessMemoryBrowseResponse, F as EngramAccessMemoryRecord, G as EngramAccessMemoryResponse, H as EngramAccessMemoryStoreRequest, J as EngramAccessMemorySummary, K as EngramAccessObserveRequest, L as EngramAccessObserveResponse, M as EngramAccessQualityResponse, N as EngramAccessRecallExplainRequest, O as EngramAccessRecallExplainResponse, Q as EngramAccessRecallRequest, R as EngramAccessRecallResponse, S as EngramAccessReviewDispositionRequest, T as EngramAccessReviewDispositionResponse, U as EngramAccessReviewQueueResponse, E as EngramAccessService, V as EngramAccessSetCodingContextRequest, W as EngramAccessSuggestionSubmitRequest, X as EngramAccessTimelineResponse, Y as EngramAccessTrustZoneBrowseRequest, Z as EngramAccessTrustZoneBrowseResponse, _ as EngramAccessTrustZoneDemoSeedRequest, $ as EngramAccessTrustZoneDemoSeedResponse, a0 as EngramAccessTrustZonePromoteRequest, a1 as EngramAccessTrustZonePromoteResponse, a2 as EngramAccessTrustZoneRecordSummary, a3 as EngramAccessTrustZoneStatusResponse, a4 as EngramAccessWriteEnvelope, a5 as EngramAccessWriteResponse, a6 as shapeMemorySummary } from './access-service-_AEUMVyX.js';
 import './recall-xray.js';
 import './recall-explain-renderer.js';
 import './types.js';
 import './recall-audit-anomaly.js';
 import './explicit-capture.js';
 import './cross-namespace-budget.js';
-import './memory-projection-store-DeSXPh1j.js';
-export { g as ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, h as EngramAccessBriefingRequest, i as EngramAccessBriefingResponse, j as EngramAccessDaySummaryRequest, k as EngramAccessEntityListResponse, l as EngramAccessEntityResponse, m as EngramAccessEntitySummary, n as EngramAccessHealthResponse, a as EngramAccessInputError, o as EngramAccessLcmSearchRequest, p as EngramAccessLcmSearchResponse, q as EngramAccessLcmStatusResponse, r as EngramAccessMaintenanceResponse, s as EngramAccessMemoryBrowseRequest, t as EngramAccessMemoryBrowseResponse, u as EngramAccessMemoryRecord, v as EngramAccessMemoryResponse, w as EngramAccessMemoryStoreRequest, x as EngramAccessMemorySummary, y as EngramAccessObserveRequest, z as EngramAccessObserveResponse, A as EngramAccessQualityResponse, B as EngramAccessRecallExplainRequest, C as EngramAccessRecallExplainResponse, D as EngramAccessRecallRequest, F as EngramAccessRecallResponse, G as EngramAccessReviewDispositionRequest, H as EngramAccessReviewDispositionResponse, I as EngramAccessReviewQueueResponse, E as EngramAccessService, J as EngramAccessSetCodingContextRequest, K as EngramAccessSuggestionSubmitRequest, L as EngramAccessTimelineResponse, M as EngramAccessTrustZoneBrowseRequest, N as EngramAccessTrustZoneBrowseResponse, O as EngramAccessTrustZoneDemoSeedRequest, Q as EngramAccessTrustZoneDemoSeedResponse, R as EngramAccessTrustZonePromoteRequest, S as EngramAccessTrustZonePromoteResponse, T as EngramAccessTrustZoneRecordSummary, U as EngramAccessTrustZoneStatusResponse, V as EngramAccessWriteEnvelope, W as EngramAccessWriteResponse } from './access-service-Br8ZydTK.js';
+import './memory-projection-store-D3vBHS4J.js';
+import './orchestrator-ChkesB8U.js';
+import './live-connectors-runner.js';
 import './recall-state.js';
-import './orchestrator-CmJ-NTdJ.js';
+import './graph-snapshot.js';
 import './trust-zones.js';
 import './local-llm.js';
 import './fallback-llm.js';
 import './memory-worth-outcomes.js';
+import './capsule-cli.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
 import 'better-sqlite3';
+import 'zod';
 import './recall-audit.js';
 import './buffer.js';
-import './port-BADbLZU5.js';
+import './port-hqGnoStS.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
 import './model-registry.js';
+import './framework-CyHYDcri.js';
 import './relevance.js';
 import './negative.js';
 import './session-observer-state.js';
 import './embedding-fallback.js';
-import './semantic-consolidation-CxJU6MJk.js';
+import './semantic-consolidation-ByBXb-sf.js';
 import './codex-materialize-CQlLTzke.js';
 import './logger.js';
-import 'zod';
 import './policy-runtime.js';
 import './profiling.js';
+import './graph.js';

package/dist/access-service.js

@@ -1,35 +1,49 @@
 import {
   ENGRAM_ACCESS_WRITE_SCHEMA_VERSION,
   EngramAccessInputError,
-  EngramAccessService
-} from "./chunk-STGWEHYR.js";
-import "./chunk-ZAIM4TUE.js";
+  EngramAccessService,
+  shapeMemorySummary
+} from "./chunk-DR7MCMPS.js";
+import "./chunk-3KIS4VGT.js";
+import "./chunk-BT7NVCML.js";
+import "./chunk-H7XKCNR6.js";
+import "./chunk-LW2NMHDW.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-3OGMS3PE.js";
+import "./chunk-NN3TS5BM.js";
 import "./chunk-EQINRHYR.js";
+import "./chunk-USFPPRAF.js";
+import "./chunk-LZRYQK6L.js";
 import "./chunk-EIR5VLIH.js";
-import "./chunk-EEQLFRUM.js";
-import "./chunk-QDW3E4RD.js";
+import "./chunk-IXEJRKCZ.js";
+import "./chunk-PCUKNJAZ.js";
 import "./chunk-3FPTCC3Z.js";
 import "./chunk-2LGMW3DJ.js";
+import "./chunk-EEQLFRUM.js";
+import "./chunk-OR64ZGRZ.js";
+import "./chunk-QDW3E4RD.js";
 import "./chunk-GDFS42HT.js";
-import "./chunk-RBBWYEFJ.js";
+import "./chunk-RK2Y4XOM.js";
+import "./chunk-2LSZVONP.js";
+import "./chunk-WIICJPET.js";
+import "./chunk-G2WADRQ3.js";
+import "./chunk-74EMIVE4.js";
 import "./chunk-DT5TVLJE.js";
 import "./chunk-N5AKDXAI.js";
 import "./chunk-TBBDFYXW.js";
-import "./chunk-L7IXWRYE.js";
-import "./chunk-F5VP6YCB.js";
-import "./chunk-LTCGGW2D.js";
+import "./chunk-SS253RXF.js";
+import "./chunk-DCE6SQLA.js";
+import "./chunk-YNJHCGDT.js";
 import "./chunk-4KAN3GZ3.js";
-import "./chunk-6PFRXT4K.js";
-import "./chunk-TP4FZJIZ.js";
+import "./chunk-43EKP2UK.js";
+import "./chunk-PFV5C235.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-BOUYNNYD.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-M62O4P4T.js";
 import "./chunk-4DJQYKMN.js";
-import "./chunk-X6GF3FX2.js";
+import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
 import "./chunk-MARWOCVP.js";
 import "./chunk-2ODBA7MQ.js";
@@ -39,9 +53,19 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-XKECPATV.js";
+import "./chunk-IYY4MCPG.js";
+import "./chunk-457A4P3L.js";
+import "./chunk-OA3L7BFR.js";
+import "./chunk-KNKUID7G.js";
+import "./chunk-BJMBJZ2Y.js";
+import "./chunk-UKJAGEXH.js";
+import "./chunk-FP2373TW.js";
+import "./chunk-A6XUJE5D.js";
+import "./chunk-PZ5AY32C.js";
 export {
   ENGRAM_ACCESS_WRITE_SCHEMA_VERSION,
   EngramAccessInputError,
-  EngramAccessService
+  EngramAccessService,
+  shapeMemorySummary
 };
 //# sourceMappingURL=access-service.js.map

package/dist/active-memory-bridge.js

@@ -4,6 +4,7 @@ import {
 } from "./chunk-G4SK7DSQ.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-N5AKDXAI.js";
+import "./chunk-PZ5AY32C.js";
 export {
   getMemoryForActiveMemory,
   recallForActiveMemory

package/dist/active-recall.js

@@ -2,6 +2,7 @@ import {
   collapseWhitespace,
   truncateCodePointSafe
 } from "./chunk-6MKAMLQL.js";
+import "./chunk-PZ5AY32C.js";
 
 // src/active-recall.ts
 import { appendFile, mkdir } from "fs/promises";

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 { 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  promptOverride: 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    promptOverride: config.promptOverride,\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 sections = [\n    params.config.promptOverride?.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        return {\n          ...cloneRecallResult(cached.value),\n          latencyMs: Math.max(0, now() - currentTime),\n          cacheHit: true,\n        };\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 ?? \"gpt-5.2\",\n            timeoutMs: config.timeoutMs,\n            thinking: config.thinking,\n            fallbackPolicy: config.modelFallbackPolicy,\n          })\n        : {\n            text: recallContext,\n            modelUsed: config.modelOverride ?? \"gpt-5.2\",\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 ?? \"gpt-5.2\",\n        transcriptPath: null,\n      };\n      if (config.persistTranscripts) {\n        result.transcriptPath = await appendActiveRecallTranscript(\n          config.transcriptDir,\n          input,\n          config,\n          result,\n          queryBundle,\n        );\n      }\n\n      if (cacheEnabled) {\n        const completedAt = now();\n        cache.set(cacheKey, {\n          expiresAt: completedAt + config.cacheTtlMs,\n          value: cloneRecallResult(result),\n        });\n        enforceCacheLimit(cache);\n      }\n      return result;\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/active-recall.ts"],"sourcesContent":["import { appendFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\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  promptOverride: 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    promptOverride: config.promptOverride,\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 sections = [\n    params.config.promptOverride?.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        return {\n          ...cloneRecallResult(cached.value),\n          latencyMs: Math.max(0, now() - currentTime),\n          cacheHit: true,\n        };\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 ?? \"gpt-5.2\",\n            timeoutMs: config.timeoutMs,\n            thinking: config.thinking,\n            fallbackPolicy: config.modelFallbackPolicy,\n          })\n        : {\n            text: recallContext,\n            modelUsed: config.modelOverride ?? \"gpt-5.2\",\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 ?? \"gpt-5.2\",\n        transcriptPath: null,\n      };\n      if (config.persistTranscripts) {\n        result.transcriptPath = await appendActiveRecallTranscript(\n          config.transcriptDir,\n          input,\n          config,\n          result,\n          queryBundle,\n        );\n      }\n\n      if (cacheEnabled) {\n        const completedAt = now();\n        cache.set(cacheKey, {\n          expiresAt: completedAt + config.cacheTtlMs,\n          value: cloneRecallResult(result),\n        });\n        enforceCacheLimit(cache);\n      }\n      return result;\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/behavior-learner.js

@@ -5,6 +5,7 @@ import {
   clamp01,
   clampLifecycleThreshold
 } from "./chunk-TBBDFYXW.js";
+import "./chunk-PZ5AY32C.js";
 
 // src/behavior-learner.ts
 var TUNABLE_BEHAVIOR_PARAMETERS = [

package/dist/behavior-learner.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/behavior-learner.ts"],"sourcesContent":["import { clamp01, clampLifecycleThreshold } from \"./lifecycle.js\";\nimport { clampInstructionHeavyTokenCap } from \"./recall-query-policy.js\";\nimport type { BehaviorLoopAdjustment, BehaviorLoopPolicyState, BehaviorSignalEvent, PluginConfig } from \"./types.js\";\n\nexport const TUNABLE_BEHAVIOR_PARAMETERS = [\n  \"recencyWeight\",\n  \"lifecyclePromoteHeatThreshold\",\n  \"lifecycleStaleDecayThreshold\",\n  \"cronRecallInstructionHeavyTokenCap\",\n] as const;\n\nexport type TunableBehaviorParameter = (typeof TUNABLE_BEHAVIOR_PARAMETERS)[number];\n\nexport interface BehaviorLearnerInput {\n  signals: BehaviorSignalEvent[];\n  now?: Date;\n  learningWindowDays: number;\n  minSignalCount: number;\n  maxDeltaPerCycle: number;\n  protectedParams: string[];\n  currentPolicy: Pick<\n    PluginConfig,\n    \"recencyWeight\" | \"lifecyclePromoteHeatThreshold\" | \"lifecycleStaleDecayThreshold\" | \"cronRecallInstructionHeavyTokenCap\"\n  >;\n}\n\nfunction clampToRange(parameter: TunableBehaviorParameter, value: number): number {\n  switch (parameter) {\n    case \"recencyWeight\":\n      return clamp01(value);\n    case \"lifecyclePromoteHeatThreshold\":\n    case \"lifecycleStaleDecayThreshold\":\n      return clampLifecycleThreshold(value);\n    case \"cronRecallInstructionHeavyTokenCap\":\n      return clampInstructionHeavyTokenCap(value);\n  }\n}\n\nfunction currentValueFor(\n  parameter: TunableBehaviorParameter,\n  currentPolicy: BehaviorLearnerInput[\"currentPolicy\"],\n): number {\n  return currentPolicy[parameter];\n}\n\nfunction maxDeltaFor(parameter: TunableBehaviorParameter, maxDeltaPerCycle: number): number {\n  if (!Number.isFinite(maxDeltaPerCycle) || maxDeltaPerCycle <= 0) return 0;\n  if (parameter === \"cronRecallInstructionHeavyTokenCap\") {\n    return Math.max(1, Math.round(maxDeltaPerCycle * 40));\n  }\n  return maxDeltaPerCycle;\n}\n\nfunction confidenceFromSignals(signalCount: number, pressureMagnitude: number): number {\n  if (signalCount <= 0) return 0;\n  return clamp01(pressureMagnitude * Math.min(1, signalCount / 20));\n}\n\nfunction aggregateSignalPressure(signals: BehaviorSignalEvent[]): number {\n  if (signals.length === 0) return 0;\n  let net = 0;\n  for (const signal of signals) {\n    const weight = clamp01(signal.confidence);\n    if (signal.direction === \"positive\") net += weight;\n    if (signal.direction === \"negative\") net -= weight;\n  }\n  return Math.max(-1, Math.min(1, net / signals.length));\n}\n\nfunction selectRecentSignals(input: BehaviorLearnerInput): BehaviorSignalEvent[] {\n  if (input.learningWindowDays <= 0) return [...input.signals];\n  const nowMs = (input.now ?? new Date()).getTime();\n  const minTs = nowMs - input.learningWindowDays * 86_400_000;\n  return input.signals.filter((signal) => {\n    const ts = Date.parse(signal.timestamp);\n    if (!Number.isFinite(ts)) return false;\n    return ts >= minTs;\n  });\n}\n\nfunction parameterDirection(parameter: TunableBehaviorParameter, pressure: number): number {\n  switch (parameter) {\n    case \"recencyWeight\":\n      return pressure;\n    case \"lifecyclePromoteHeatThreshold\":\n      return pressure * -0.5;\n    case \"lifecycleStaleDecayThreshold\":\n      return pressure * 0.5;\n    case \"cronRecallInstructionHeavyTokenCap\":\n      return pressure * 0.75;\n  }\n}\n\nexport function learnBehaviorPolicyAdjustments(input: BehaviorLearnerInput): BehaviorLoopPolicyState {\n  const nowIso = (input.now ?? new Date()).toISOString();\n  const windowedSignals = selectRecentSignals(input);\n  if (windowedSignals.length < input.minSignalCount) {\n    return {\n      version: 1,\n      windowDays: input.learningWindowDays,\n      minSignalCount: input.minSignalCount,\n      maxDeltaPerCycle: input.maxDeltaPerCycle,\n      protectedParams: [...input.protectedParams],\n      adjustments: [],\n      updatedAt: nowIso,\n    };\n  }\n\n  const pressure = aggregateSignalPressure(windowedSignals);\n  const adjustments: BehaviorLoopAdjustment[] = [];\n  for (const parameter of TUNABLE_BEHAVIOR_PARAMETERS) {\n    if (input.protectedParams.includes(parameter)) continue;\n    const currentValue = currentValueFor(parameter, input.currentPolicy);\n    const direction = parameterDirection(parameter, pressure);\n    const deltaBound = maxDeltaFor(parameter, input.maxDeltaPerCycle);\n    const proposedDelta = Math.max(-deltaBound, Math.min(deltaBound, direction * deltaBound));\n    if (Math.abs(proposedDelta) <= 0) continue;\n\n    const nextValue = clampToRange(parameter, currentValue + proposedDelta);\n    const roundedDelta = nextValue - currentValue;\n    if (Math.abs(roundedDelta) <= Number.EPSILON) continue;\n\n    adjustments.push({\n      parameter,\n      previousValue: currentValue,\n      nextValue,\n      delta: roundedDelta,\n      evidenceCount: windowedSignals.length,\n      confidence: confidenceFromSignals(windowedSignals.length, Math.abs(pressure)),\n      reason: `signal_pressure=${pressure.toFixed(3)} evidence=${windowedSignals.length}`,\n      appliedAt: nowIso,\n    });\n  }\n\n  return {\n    version: 1,\n    windowDays: input.learningWindowDays,\n    minSignalCount: input.minSignalCount,\n    maxDeltaPerCycle: input.maxDeltaPerCycle,\n    protectedParams: [...input.protectedParams],\n    adjustments,\n    updatedAt: nowIso,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/behavior-learner.ts"],"sourcesContent":["import { clamp01, clampLifecycleThreshold } from \"./lifecycle.js\";\nimport { clampInstructionHeavyTokenCap } from \"./recall-query-policy.js\";\nimport type { BehaviorLoopAdjustment, BehaviorLoopPolicyState, BehaviorSignalEvent, PluginConfig } from \"./types.js\";\n\nexport const TUNABLE_BEHAVIOR_PARAMETERS = [\n  \"recencyWeight\",\n  \"lifecyclePromoteHeatThreshold\",\n  \"lifecycleStaleDecayThreshold\",\n  \"cronRecallInstructionHeavyTokenCap\",\n] as const;\n\nexport type TunableBehaviorParameter = (typeof TUNABLE_BEHAVIOR_PARAMETERS)[number];\n\nexport interface BehaviorLearnerInput {\n  signals: BehaviorSignalEvent[];\n  now?: Date;\n  learningWindowDays: number;\n  minSignalCount: number;\n  maxDeltaPerCycle: number;\n  protectedParams: string[];\n  currentPolicy: Pick<\n    PluginConfig,\n    \"recencyWeight\" | \"lifecyclePromoteHeatThreshold\" | \"lifecycleStaleDecayThreshold\" | \"cronRecallInstructionHeavyTokenCap\"\n  >;\n}\n\nfunction clampToRange(parameter: TunableBehaviorParameter, value: number): number {\n  switch (parameter) {\n    case \"recencyWeight\":\n      return clamp01(value);\n    case \"lifecyclePromoteHeatThreshold\":\n    case \"lifecycleStaleDecayThreshold\":\n      return clampLifecycleThreshold(value);\n    case \"cronRecallInstructionHeavyTokenCap\":\n      return clampInstructionHeavyTokenCap(value);\n  }\n}\n\nfunction currentValueFor(\n  parameter: TunableBehaviorParameter,\n  currentPolicy: BehaviorLearnerInput[\"currentPolicy\"],\n): number {\n  return currentPolicy[parameter];\n}\n\nfunction maxDeltaFor(parameter: TunableBehaviorParameter, maxDeltaPerCycle: number): number {\n  if (!Number.isFinite(maxDeltaPerCycle) || maxDeltaPerCycle <= 0) return 0;\n  if (parameter === \"cronRecallInstructionHeavyTokenCap\") {\n    return Math.max(1, Math.round(maxDeltaPerCycle * 40));\n  }\n  return maxDeltaPerCycle;\n}\n\nfunction confidenceFromSignals(signalCount: number, pressureMagnitude: number): number {\n  if (signalCount <= 0) return 0;\n  return clamp01(pressureMagnitude * Math.min(1, signalCount / 20));\n}\n\nfunction aggregateSignalPressure(signals: BehaviorSignalEvent[]): number {\n  if (signals.length === 0) return 0;\n  let net = 0;\n  for (const signal of signals) {\n    const weight = clamp01(signal.confidence);\n    if (signal.direction === \"positive\") net += weight;\n    if (signal.direction === \"negative\") net -= weight;\n  }\n  return Math.max(-1, Math.min(1, net / signals.length));\n}\n\nfunction selectRecentSignals(input: BehaviorLearnerInput): BehaviorSignalEvent[] {\n  if (input.learningWindowDays <= 0) return [...input.signals];\n  const nowMs = (input.now ?? new Date()).getTime();\n  const minTs = nowMs - input.learningWindowDays * 86_400_000;\n  return input.signals.filter((signal) => {\n    const ts = Date.parse(signal.timestamp);\n    if (!Number.isFinite(ts)) return false;\n    return ts >= minTs;\n  });\n}\n\nfunction parameterDirection(parameter: TunableBehaviorParameter, pressure: number): number {\n  switch (parameter) {\n    case \"recencyWeight\":\n      return pressure;\n    case \"lifecyclePromoteHeatThreshold\":\n      return pressure * -0.5;\n    case \"lifecycleStaleDecayThreshold\":\n      return pressure * 0.5;\n    case \"cronRecallInstructionHeavyTokenCap\":\n      return pressure * 0.75;\n  }\n}\n\nexport function learnBehaviorPolicyAdjustments(input: BehaviorLearnerInput): BehaviorLoopPolicyState {\n  const nowIso = (input.now ?? new Date()).toISOString();\n  const windowedSignals = selectRecentSignals(input);\n  if (windowedSignals.length < input.minSignalCount) {\n    return {\n      version: 1,\n      windowDays: input.learningWindowDays,\n      minSignalCount: input.minSignalCount,\n      maxDeltaPerCycle: input.maxDeltaPerCycle,\n      protectedParams: [...input.protectedParams],\n      adjustments: [],\n      updatedAt: nowIso,\n    };\n  }\n\n  const pressure = aggregateSignalPressure(windowedSignals);\n  const adjustments: BehaviorLoopAdjustment[] = [];\n  for (const parameter of TUNABLE_BEHAVIOR_PARAMETERS) {\n    if (input.protectedParams.includes(parameter)) continue;\n    const currentValue = currentValueFor(parameter, input.currentPolicy);\n    const direction = parameterDirection(parameter, pressure);\n    const deltaBound = maxDeltaFor(parameter, input.maxDeltaPerCycle);\n    const proposedDelta = Math.max(-deltaBound, Math.min(deltaBound, direction * deltaBound));\n    if (Math.abs(proposedDelta) <= 0) continue;\n\n    const nextValue = clampToRange(parameter, currentValue + proposedDelta);\n    const roundedDelta = nextValue - currentValue;\n    if (Math.abs(roundedDelta) <= Number.EPSILON) continue;\n\n    adjustments.push({\n      parameter,\n      previousValue: currentValue,\n      nextValue,\n      delta: roundedDelta,\n      evidenceCount: windowedSignals.length,\n      confidence: confidenceFromSignals(windowedSignals.length, Math.abs(pressure)),\n      reason: `signal_pressure=${pressure.toFixed(3)} evidence=${windowedSignals.length}`,\n      appliedAt: nowIso,\n    });\n  }\n\n  return {\n    version: 1,\n    windowDays: input.learningWindowDays,\n    minSignalCount: input.minSignalCount,\n    maxDeltaPerCycle: input.maxDeltaPerCycle,\n    protectedParams: [...input.protectedParams],\n    adjustments,\n    updatedAt: nowIso,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/behavior-signals.js

@@ -3,6 +3,7 @@ import {
   buildBehaviorSignalsForMemory,
   dedupeBehaviorSignalsByMemoryAndHash
 } from "./chunk-JWPLJLDU.js";
+import "./chunk-PZ5AY32C.js";
 export {
   buildBehaviorSignalHash,
   buildBehaviorSignalsForMemory,

package/dist/bootstrap.d.ts

@@ -1,25 +1,27 @@
 import { PluginConfig } from './types.js';
-import { O as Orchestrator } from './orchestrator-CmJ-NTdJ.js';
+import { O as Orchestrator } from './orchestrator-ChkesB8U.js';
 import './buffer.js';
 import './storage.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-DeSXPh1j.js';
+import './memory-projection-store-D3vBHS4J.js';
 import 'better-sqlite3';
-import './port-BADbLZU5.js';
+import './port-hqGnoStS.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
 import './model-registry.js';
 import './local-llm.js';
 import './fallback-llm.js';
+import './live-connectors-runner.js';
+import './framework-CyHYDcri.js';
 import './relevance.js';
 import './negative.js';
 import './recall-state.js';
 import './recall-xray.js';
 import './session-observer-state.js';
 import './embedding-fallback.js';
-import './semantic-consolidation-CxJU6MJk.js';
+import './semantic-consolidation-ByBXb-sf.js';
 import './codex-materialize-CQlLTzke.js';
 import './logger.js';
 import 'zod';

package/dist/bootstrap.js

@@ -3,6 +3,7 @@ import {
 } from "./chunk-N53K2EXC.js";
 import "./chunk-XYIK4LF6.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-PZ5AY32C.js";
 export {
   BootstrapEngine
 };

package/dist/boxes.js

@@ -5,6 +5,7 @@ import {
   topicOverlapScore
 } from "./chunk-URB2WSKZ.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-PZ5AY32C.js";
 export {
   BOX_DIR,
   BoxBuilder,

package/dist/briefing.d.ts

@@ -2,7 +2,7 @@ import { StorageManager } from './storage.js';
 import { BriefingSections, BriefingFollowup, BriefingFocus, CalendarSource, CalendarEvent, MemoryFile, BriefingActiveThread, BriefingResult, EntityFile, BriefingRecentEntity } from './types.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-DeSXPh1j.js';
+import './memory-projection-store-D3vBHS4J.js';
 import 'better-sqlite3';
 
 /**
@@ -75,10 +75,14 @@ declare function parseBriefingFocus(token: string | undefined): BriefingFocus |
  * Purely deterministic — no LLM, case-insensitive substring match across
  * the most useful surfaces.
  *
- * For `entityRef` matching we also check the slugged form of the typed focus
- * (e.g. `person:Jane Doe` → `"person-jane-doe"`) because entityRefs are stored
- * in normalised slug form and a raw substring match on `"Jane Doe"` would never
- * hit `"person-jane-doe"`.
+ * For typed focus (`person:`, `project:`, `entity:`) we attribute via the
+ * canonical-id path below to avoid the substring leak fixed in #682 PR 2/3
+ * R-10 (`Alice-Test` substring-hitting `person-alice-test-a1`).
+ *
+ * For untyped (`topic`) focus there is no type to canonicalize against, so
+ * we keep `entityRef` in the raw haystack — otherwise memories that link to
+ * an entity only via `frontmatter.entityRef` (no body / tag mention) would
+ * silently drop out of an untyped focus filter (codex P2 review on #695).
  */
 declare function focusMatchesMemory(memory: MemoryFile, focus: BriefingFocus): boolean;
 declare function focusMatchesEntity(entity: EntityFile, focus: BriefingFocus): boolean;

package/dist/briefing.js

@@ -16,22 +16,25 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-L7IXWRYE.js";
-import "./chunk-F5VP6YCB.js";
-import "./chunk-LTCGGW2D.js";
+} from "./chunk-SS253RXF.js";
+import "./chunk-DCE6SQLA.js";
+import "./chunk-YNJHCGDT.js";
 import "./chunk-4KAN3GZ3.js";
-import "./chunk-6PFRXT4K.js";
-import "./chunk-TP4FZJIZ.js";
+import "./chunk-43EKP2UK.js";
+import "./chunk-PFV5C235.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-BOUYNNYD.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-M62O4P4T.js";
 import "./chunk-4DJQYKMN.js";
-import "./chunk-X6GF3FX2.js";
+import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
 import "./chunk-MARWOCVP.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-A6XUJE5D.js";
+import "./chunk-PZ5AY32C.js";
 export {
   BRIEFING_FOLLOWUP_DEFAULT_MODEL,
   BRIEFING_FORMAT_ALLOWED,

package/dist/buffer-surprise-report.js

@@ -1,6 +1,7 @@
 import {
   reportBufferSurpriseDistribution
 } from "./chunk-ASAITVLA.js";
+import "./chunk-PZ5AY32C.js";
 export {
   reportBufferSurpriseDistribution
 };

package/dist/buffer-surprise.js

@@ -4,6 +4,7 @@ import {
 } from "./chunk-5JRF2PZA.js";
 import "./chunk-KVE7R4CG.js";
 import "./chunk-4WMCPJWX.js";
+import "./chunk-PZ5AY32C.js";
 export {
   DEFAULT_SURPRISE_K,
   computeSurprise

package/dist/buffer.d.ts

@@ -2,7 +2,7 @@ import { StorageManager } from './storage.js';
 import { PluginConfig, BufferTurn } from './types.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-DeSXPh1j.js';
+import './memory-projection-store-D3vBHS4J.js';
 import 'better-sqlite3';
 
 type TriggerDecision = "extract_now" | "extract_batch" | "keep_buffering";

package/dist/buffer.js

@@ -3,6 +3,7 @@ import {
 } from "./chunk-JBMSGZEQ.js";
 import "./chunk-XYIK4LF6.js";
 import "./chunk-2ODBA7MQ.js";
+import "./chunk-PZ5AY32C.js";
 export {
   SmartBuffer
 };

package/dist/calibration.d.ts

@@ -42,6 +42,13 @@ interface CorrectionMemory {
     entityRefs: string[];
     tags: string[];
 }
+/**
+ * Exported for entity-contamination R-11 regression coverage (#682
+ * PR 2/3 — codex review).  Tests can drive the real correction-reading
+ * path instead of duplicating the regex inline, so calibration parser
+ * regressions surface via the contamination suite.
+ */
+declare function readCalibrationCorrections(memoryDir: string): Promise<CorrectionMemory[]>;
 declare function synthesizeCalibrationRules(corrections: CorrectionMemory[], llm: FallbackLlmClient, existingRules: CalibrationRule[], agentId?: string): Promise<CalibrationRule[]>;
 /**
  * Build a recall section from calibration rules relevant to the current query.
@@ -78,4 +85,4 @@ declare function runCalibrationIfEnabled(options: {
  */
 declare function getCalibrationRulesForRecall(memoryDir: string): Promise<CalibrationRule[]>;
 
-export { type CalibrationIndex, type CalibrationRule, buildCalibrationRecallSection, getCalibrationRulesForRecall, readCalibrationIndex, runCalibrationConsolidation, runCalibrationIfEnabled, synthesizeCalibrationRules };
+export { type CalibrationIndex, type CalibrationRule, type CorrectionMemory, buildCalibrationRecallSection, getCalibrationRulesForRecall, readCalibrationCorrections, readCalibrationIndex, runCalibrationConsolidation, runCalibrationIfEnabled, synthesizeCalibrationRules };

package/dist/calibration.js

@@ -1,7 +1,7 @@
 import {
   FallbackLlmClient
-} from "./chunk-AYXIPSZO.js";
-import "./chunk-Y7R2XJ5Q.js";
+} from "./chunk-CRU27Q4J.js";
+import "./chunk-Q7FJ5ZHM.js";
 import "./chunk-ODWDQNRE.js";
 import "./chunk-Y27UJK6V.js";
 import "./chunk-UZB5KHKX.js";
@@ -12,6 +12,7 @@ import {
 import {
   listJsonFiles
 } from "./chunk-LPSF4OQH.js";
+import "./chunk-PZ5AY32C.js";
 
 // src/calibration.ts
 import { createHash } from "crypto";
@@ -41,7 +42,13 @@ async function writeCalibrationIndex(memoryDir, index) {
   index.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   await writeFile(calibrationIndexPath(memoryDir), JSON.stringify(index, null, 2), "utf8");
 }
+async function readCalibrationCorrections(memoryDir) {
+  return readCorrectionsImpl(memoryDir);
+}
 async function readCorrections(memoryDir) {
+  return readCorrectionsImpl(memoryDir);
+}
+async function readCorrectionsImpl(memoryDir) {
   const correctionsDir = path.join(memoryDir, "corrections");
   const files = await listJsonFiles(correctionsDir).catch(() => {
     return [];
@@ -232,6 +239,7 @@ async function getCalibrationRulesForRecall(memoryDir) {
 export {
   buildCalibrationRecallSection,
   getCalibrationRulesForRecall,
+  readCalibrationCorrections,
   readCalibrationIndex,
   runCalibrationConsolidation,
   runCalibrationIfEnabled,