@remnic/core 1.1.30 → 9.3.515

package/dist/adapters/index.js

@@ -1,20 +1,20 @@
 import "../chunk-SEDEKFYQ.js";
 import {
   AdapterRegistry
-} from "../chunk-6FC5EGNV.js";
+} from "../chunk-JBPKEARU.js";
 import {
   ReplitAdapter
-} from "../chunk-3Y4P7RXM.js";
+} from "../chunk-TMSXWOBZ.js";
 import {
   ClaudeCodeAdapter
-} from "../chunk-6LVVDPJ4.js";
+} from "../chunk-J64TK33U.js";
 import {
   CodexAdapter
-} from "../chunk-7MNMYOFP.js";
+} from "../chunk-RSUYKGGZ.js";
 import {
   HermesAdapter
-} from "../chunk-FKFMOY3N.js";
-import "../chunk-FAJ7FZYM.js";
+} from "../chunk-42NQ7AVG.js";
+import "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {
   AdapterRegistry,

package/dist/adapters/registry.js

@@ -1,11 +1,11 @@
 import {
   AdapterRegistry
-} from "../chunk-6FC5EGNV.js";
-import "../chunk-3Y4P7RXM.js";
-import "../chunk-6LVVDPJ4.js";
-import "../chunk-7MNMYOFP.js";
-import "../chunk-FKFMOY3N.js";
-import "../chunk-FAJ7FZYM.js";
+} from "../chunk-JBPKEARU.js";
+import "../chunk-TMSXWOBZ.js";
+import "../chunk-J64TK33U.js";
+import "../chunk-RSUYKGGZ.js";
+import "../chunk-42NQ7AVG.js";
+import "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {
   AdapterRegistry

package/dist/adapters/replit.d.ts

@@ -16,8 +16,10 @@ import { EngramAdapter, AdapterContext, ResolvedIdentity } from './types.js';
  *   Header Name: X-Engram-Client-Id
  *   Header Value: replit
  *
- * Optionally also set X-Engram-Namespace and X-Engram-Principal for
- * project/user scoping.
+ * Optionally also set X-Engram-Namespace for project scoping. Principal
+ * overrides are intentionally handled only by the HTTP server's
+ * trustPrincipalHeader gate. Adapters must not independently trust
+ * X-Engram-Principal.
  */
 declare class ReplitAdapter implements EngramAdapter {
     readonly id = "replit";

package/dist/adapters/replit.js

@@ -1,7 +1,7 @@
 import {
   ReplitAdapter
-} from "../chunk-3Y4P7RXM.js";
-import "../chunk-FAJ7FZYM.js";
+} from "../chunk-TMSXWOBZ.js";
+import "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {
   ReplitAdapter

package/dist/adapters/types.d.ts

@@ -15,6 +15,10 @@ interface AdapterContext {
     };
     /** Explicit session key from request args */
     sessionKey?: string;
+    /** Explicit namespace from already-validated request args */
+    namespace?: string;
+    /** Explicit principal from already-validated request args */
+    principal?: string;
 }
 interface ResolvedIdentity {
     /** Engram namespace (scopes memory access) */

package/dist/adapters/types.js

@@ -1,6 +1,6 @@
 import {
   headerValue
-} from "../chunk-FAJ7FZYM.js";
+} from "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {
   headerValue

package/dist/behavior-learner.d.ts

@@ -1,4 +1,5 @@
 import { BehaviorSignalEvent, PluginConfig, BehaviorLoopPolicyState } from './types.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 
 declare const TUNABLE_BEHAVIOR_PARAMETERS: readonly ["recencyWeight", "lifecyclePromoteHeatThreshold", "lifecycleStaleDecayThreshold", "cronRecallInstructionHeavyTokenCap"];

package/dist/behavior-signals.d.ts

@@ -1,4 +1,5 @@
 import { MemoryCategory, BehaviorSignalEvent } from './types.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 
 declare function buildBehaviorSignalHash(category: MemoryCategory, content: string): string;

package/dist/behavior-signals.js

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

package/dist/bootstrap.d.ts

@@ -1,5 +1,6 @@
 import { PluginConfig } from './types.js';
-import { O as Orchestrator } from './orchestrator-DuWl9Hwx.js';
+import { O as Orchestrator } from './orchestrator-Co9nxRLF.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 import './buffer.js';
 import './storage.js';
@@ -16,6 +17,7 @@ import './summarizer.js';
 import './model-registry.js';
 import './local-llm.js';
 import './fallback-llm.js';
+import './resolve-provider-secret.js';
 import './live-connectors-runner.js';
 import './framework-CyHYDcri.js';
 import './relevance.js';
@@ -26,7 +28,7 @@ import './memory-provenance.js';
 import './user-model.js';
 import './session-observer-state.js';
 import './embedding-fallback.js';
-import './semantic-VwGI14Ok.js';
+import './semantic-SLAa_prH.js';
 import './replay/types.js';
 import './lcm/engine.js';
 import './lcm/archive.js';
@@ -38,7 +40,7 @@ import './connectors/codex-materialize.js';
 import './logger.js';
 import './conversation-index/backend.js';
 import './conversation-index/chunker.js';
-import './faiss-adapter-CzPghc4C.js';
+import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
 import './shared-context/manager.js';
 import 'zod';

package/dist/bootstrap.js

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

package/dist/boxes.d.ts

@@ -69,6 +69,7 @@ declare class BoxBuilder {
     private get openBoxStatePath();
     private get tracesPath();
     private loadOpenBox;
+    private writeOpenBoxState;
     private saveOpenBox;
     private loadTraceIndex;
     private saveTraceIndex;

package/dist/boxes.js

@@ -3,7 +3,7 @@ import {
   BoxBuilder,
   parseBoxFrontmatter,
   topicOverlapScore
-} from "./chunk-NZL6GGQE.js";
+} from "./chunk-HQ6NIBL6.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/briefing.d.ts

@@ -4,6 +4,7 @@ import './page-versioning.js';
 import './consolidation-operator.js';
 import './memory-projection-store.js';
 import './maintenance/memory-governance.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 import './runtime/better-sqlite.js';
 import 'better-sqlite3';

package/dist/briefing.js

@@ -16,25 +16,25 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-SIC6U3GZ.js";
-import "./chunk-VBJ7V5SK.js";
+} from "./chunk-YHV3KRKS.js";
+import "./chunk-UIPDNLXA.js";
 import "./chunk-5UZXUTVO.js";
-import "./chunk-NN2DKE4T.js";
-import "./chunk-Q7P4WJDP.js";
+import "./chunk-4H5ZJHEN.js";
+import "./chunk-M5T4Q2ZU.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-3KW65B36.js";
+import "./chunk-KILOTVIF.js";
 import "./chunk-3HPAPHUK.js";
-import "./chunk-PFV5C235.js";
+import "./chunk-CPPS65WS.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-FAAFWE4G.js";
+import "./chunk-ALEPI75L.js";
 import "./chunk-4DJQYKMN.js";
-import "./chunk-XIG5PDM7.js";
+import "./chunk-JUC24CTX.js";
 import "./chunk-2ODBA7MQ.js";
-import "./chunk-MXFBBHJU.js";
+import "./chunk-KJMYHC7K.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-PZ5AY32C.js";

package/dist/buffer-surprise-report.d.ts

@@ -1,4 +1,5 @@
 import { BufferSurpriseEvent } from './types.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 
 /**

package/dist/buffer.d.ts

@@ -4,6 +4,7 @@ import './page-versioning.js';
 import './consolidation-operator.js';
 import './memory-projection-store.js';
 import './maintenance/memory-governance.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 import './runtime/better-sqlite.js';
 import 'better-sqlite3';

package/dist/buffer.js

@@ -1,7 +1,7 @@
 import {
   SmartBuffer
-} from "./chunk-5RGLBDQF.js";
-import "./chunk-XYIK4LF6.js";
+} from "./chunk-EVZFIAPG.js";
+import "./chunk-H3FZVNRN.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/bulk-import/index.d.ts

@@ -0,0 +1,28 @@
+import { e as BulkImportSourceAdapter } from '../types-BliCnURB.js';
+export { d as BulkImportError, B as BulkImportOptions, b as BulkImportResult, a as BulkImportSource, f as ImportSourceRole, I as ImportTurn, g as ImportTurnValidationIssue, i as isImportRole, p as parseIsoTimestamp, v as validateImportTurn } from '../types-BliCnURB.js';
+export { a as ProcessBatchContext, P as ProcessBatchFn, b as ProcessBatchResult, f as formatBatchTranscript, r as resolveBulkImportContext, c as runBulkImportPipeline, v as validateBatchSize } from '../pipeline-D18UAKlN.js';
+import '../index-DJ9QWMw-.js';
+
+/**
+ * Register a source adapter. Rejects duplicate names and empty names.
+ */
+declare function registerBulkImportSource(adapter: BulkImportSourceAdapter): void;
+/**
+ * Retrieve a registered adapter by name.
+ *
+ * Names are trimmed on write (see `registerBulkImportSource`), so we
+ * also trim on read to avoid the asymmetric-lookup footgun where a
+ * whitespace-padded lookup would never find a registered adapter.
+ * Non-string or empty-after-trim inputs return undefined.
+ */
+declare function getBulkImportSource(name: string): BulkImportSourceAdapter | undefined;
+/**
+ * List all registered adapter names.
+ */
+declare function listBulkImportSources(): string[];
+/**
+ * Clear all registered adapters (for testing).
+ */
+declare function clearBulkImportSources(): void;
+
+export { BulkImportSourceAdapter, clearBulkImportSources, getBulkImportSource, listBulkImportSources, registerBulkImportSource };

package/dist/bulk-import/index.js

@@ -0,0 +1,31 @@
+import {
+  clearBulkImportSources,
+  formatBatchTranscript,
+  getBulkImportSource,
+  listBulkImportSources,
+  registerBulkImportSource,
+  resolveBulkImportContext,
+  runBulkImportPipeline,
+  validateBatchSize
+} from "../chunk-H2NCNXMS.js";
+import {
+  isImportRole,
+  parseIsoTimestamp,
+  validateImportTurn
+} from "../chunk-PU44GBL4.js";
+import "../chunk-P7FMDTKL.js";
+import "../chunk-PZ5AY32C.js";
+export {
+  clearBulkImportSources,
+  formatBatchTranscript,
+  getBulkImportSource,
+  isImportRole,
+  listBulkImportSources,
+  parseIsoTimestamp,
+  registerBulkImportSource,
+  resolveBulkImportContext,
+  runBulkImportPipeline,
+  validateBatchSize,
+  validateImportTurn
+};
+//# sourceMappingURL=index.js.map

package/dist/calibration.d.ts

@@ -1,5 +1,7 @@
 import { FallbackLlmClient } from './fallback-llm.js';
 import { GatewayConfig } from './types.js';
+import './resolve-provider-secret.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 
 /**

package/dist/calibration.js

@@ -1,13 +1,13 @@
 import {
   FallbackLlmClient
-} from "./chunk-DINWEURR.js";
-import "./chunk-FLTNHQK6.js";
+} from "./chunk-CSKLPDN6.js";
+import "./chunk-B5XMS73R.js";
 import "./chunk-7SI52C65.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-UZB5KHKX.js";
 import "./chunk-RK6F44Y6.js";
-import "./chunk-QRNI5JBH.js";
-import "./chunk-XIG5PDM7.js";
+import "./chunk-EYIEWJNI.js";
+import "./chunk-JUC24CTX.js";
 import {
   log
 } from "./chunk-2ODBA7MQ.js";
@@ -44,6 +44,25 @@ async function writeCalibrationIndex(memoryDir, index) {
   index.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   await writeFile(calibrationIndexPath(memoryDir), JSON.stringify(index, null, 2), "utf8");
 }
+var CALIBRATION_RULE_TYPES = /* @__PURE__ */ new Set([
+  "model_tendency",
+  "user_expectation",
+  "scope_boundary",
+  "verification_required"
+]);
+function parseConfidence(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
+  return Math.max(0, Math.min(1, value));
+}
+function parseEvidenceIds(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter((item) => typeof item === "string" && item.trim().length > 0);
+}
+function nonEmptyString(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
 async function readCalibrationCorrections(memoryDir) {
   return readCorrectionsImpl(memoryDir);
 }
@@ -146,19 +165,33 @@ ${correctionText}${existingRulesText}` }
     const parsed = JSON.parse(jsonStr);
     if (!Array.isArray(parsed.rules)) return [];
     const now = (/* @__PURE__ */ new Date()).toISOString();
-    return parsed.rules.filter((r) => r.condition && r.calibration && r.modelTendency).map((r) => ({
-      id: `cal-${createHash("sha256").update(r.condition + r.calibration).digest("hex").slice(0, 12)}`,
-      ruleType: r.ruleType ?? "model_tendency",
-      condition: String(r.condition),
-      modelTendency: String(r.modelTendency),
-      userExpectation: String(r.userExpectation ?? ""),
-      calibration: String(r.calibration),
-      confidence: typeof r.confidence === "number" ? r.confidence : 0.7,
-      evidenceCount: Array.isArray(r.evidenceIds) ? r.evidenceIds.length : 1,
-      evidenceCorrectionIds: Array.isArray(r.evidenceIds) ? r.evidenceIds : [],
-      createdAt: now,
-      lastReinforcedAt: now
-    }));
+    const rawRules = Array.isArray(parsed.rules) ? parsed.rules : [];
+    return rawRules.map((r) => {
+      if (!r || typeof r !== "object" || Array.isArray(r)) return void 0;
+      const raw = r;
+      const ruleType = nonEmptyString(raw.ruleType);
+      const condition = nonEmptyString(raw.condition);
+      const modelTendency = nonEmptyString(raw.modelTendency);
+      const calibration = nonEmptyString(raw.calibration);
+      const confidence = parseConfidence(raw.confidence);
+      if (!ruleType || !CALIBRATION_RULE_TYPES.has(ruleType) || !condition || !modelTendency || !calibration || confidence === void 0) {
+        return void 0;
+      }
+      const evidenceCorrectionIds = parseEvidenceIds(raw.evidenceIds);
+      return {
+        id: `cal-${createHash("sha256").update(condition + calibration).digest("hex").slice(0, 12)}`,
+        ruleType,
+        condition,
+        modelTendency,
+        userExpectation: nonEmptyString(raw.userExpectation) ?? "",
+        calibration,
+        confidence,
+        evidenceCount: evidenceCorrectionIds.length,
+        evidenceCorrectionIds,
+        createdAt: now,
+        lastReinforcedAt: now
+      };
+    }).filter((rule) => !!rule);
   } catch {
     log.warn("[calibration] failed to parse LLM response");
     return [];

package/dist/calibration.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/calibration.ts"],"sourcesContent":["/**\n * calibration.ts — Prediction-Error-Driven Model-User Calibration\n *\n * Analyzes patterns in user corrections to identify systematic miscalibration\n * between the model's predictions and the user's actual expectations.\n * During consolidation, replays chains of similar corrections through an LLM\n * to synthesize CalibrationRules that adjust model behavior for this specific user.\n *\n * Inspired by:\n * - Cerebellar motor calibration (prediction errors drive lasting adjustments)\n * - Temporal difference learning (dopamine signals prediction error)\n * - Tesla FSD shadow mode (divergence between prediction and reality = training signal)\n */\n\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { FallbackLlmClient } from \"./fallback-llm.js\";\nimport type { GatewayConfig, MemoryFile } from \"./types.js\";\nimport { listJsonFiles, readJsonFile } from \"./json-store.js\";\nimport { isRecord } from \"./store-contract.js\";\nimport { log } from \"./logger.js\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface CalibrationRule {\n  id: string;\n  ruleType: \"model_tendency\" | \"user_expectation\" | \"scope_boundary\" | \"verification_required\";\n  condition: string;\n  modelTendency: string;\n  userExpectation: string;\n  calibration: string;\n  confidence: number;\n  evidenceCount: number;\n  evidenceCorrectionIds: string[];\n  createdAt: string;\n  lastReinforcedAt: string;\n}\n\nexport interface CalibrationIndex {\n  rules: CalibrationRule[];\n  updatedAt: string;\n  totalCorrectionsAnalyzed: number;\n}\n\n// ─── Storage ─────────────────────────────────────────────────────────────────\n\nfunction calibrationDir(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", \"calibration\");\n}\n\nfunction calibrationIndexPath(memoryDir: string): string {\n  return path.join(calibrationDir(memoryDir), \"calibration-index.json\");\n}\n\nexport async function readCalibrationIndex(memoryDir: string): Promise<CalibrationIndex> {\n  try {\n    const raw = JSON.parse(await readFile(calibrationIndexPath(memoryDir), \"utf8\"));\n    return {\n      rules: Array.isArray(raw.rules) ? raw.rules : [],\n      updatedAt: typeof raw.updatedAt === \"string\" ? raw.updatedAt : new Date().toISOString(),\n      totalCorrectionsAnalyzed: typeof raw.totalCorrectionsAnalyzed === \"number\" ? raw.totalCorrectionsAnalyzed : 0,\n    };\n  } catch {\n    return { rules: [], updatedAt: new Date().toISOString(), totalCorrectionsAnalyzed: 0 };\n  }\n}\n\nasync function writeCalibrationIndex(memoryDir: string, index: CalibrationIndex): Promise<void> {\n  const dir = calibrationDir(memoryDir);\n  await mkdir(dir, { recursive: true });\n  index.updatedAt = new Date().toISOString();\n  await writeFile(calibrationIndexPath(memoryDir), JSON.stringify(index, null, 2), \"utf8\");\n}\n\n// ─── Correction Reading ──────────────────────────────────────────────────────\n\nexport interface CorrectionMemory {\n  id: string;\n  content: string;\n  created: string;\n  confidence: number;\n  entityRefs: string[];\n  tags: string[];\n}\n\n/**\n * Exported for entity-contamination R-11 regression coverage (#682\n * PR 2/3 — codex review).  Tests can drive the real correction-reading\n * path instead of duplicating the regex inline, so calibration parser\n * regressions surface via the contamination suite.\n */\nexport async function readCalibrationCorrections(memoryDir: string): Promise<CorrectionMemory[]> {\n  return readCorrectionsImpl(memoryDir);\n}\n\nasync function readCorrections(memoryDir: string): Promise<CorrectionMemory[]> {\n  return readCorrectionsImpl(memoryDir);\n}\n\nasync function readCorrectionsImpl(memoryDir: string): Promise<CorrectionMemory[]> {\n  const correctionsDir = path.join(memoryDir, \"corrections\");\n  const files = await listJsonFiles(correctionsDir).catch(() => {\n    // Corrections might be in facts/ directories too\n    return [] as string[];\n  });\n\n  // Also scan facts directories for correction-category files\n  const factsDir = path.join(memoryDir, \"facts\");\n  try {\n    const { readdir } = await import(\"node:fs/promises\");\n    const dayDirs = (await readdir(factsDir)).filter((d: string) => /^\\d{4}-\\d{2}-\\d{2}$/.test(d));\n    for (const day of dayDirs) {\n      const dayPath = path.join(factsDir, day);\n      const dayFiles = (await readdir(dayPath))\n        .filter((f: string) => f.startsWith(\"correction-\") && f.endsWith(\".md\"))\n        .map((f: string) => path.join(dayPath, f));\n      files.push(...dayFiles);\n    }\n  } catch {\n    // facts dir might not exist\n  }\n\n  // Also check the dedicated corrections directory\n  try {\n    const { readdir } = await import(\"node:fs/promises\");\n    const corrFiles = (await readdir(correctionsDir))\n      .filter((f: string) => f.endsWith(\".md\"))\n      .map((f: string) => path.join(correctionsDir, f));\n    files.push(...corrFiles);\n  } catch {\n    // corrections dir might not exist\n  }\n\n  const corrections: CorrectionMemory[] = [];\n  const seen = new Set<string>();\n\n  for (const filePath of files) {\n    try {\n      const raw = await readFile(filePath, \"utf8\");\n\n      // Parse frontmatter\n      const fmMatch = raw.match(/^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/);\n      if (!fmMatch) continue;\n\n      const content = fmMatch[2].trim();\n      if (!content || content.length < 10) continue;\n\n      // Extract id from frontmatter\n      const idMatch = fmMatch[1].match(/^id:\\s*(.+)$/m);\n      const id = idMatch?.[1]?.trim() ?? path.basename(filePath, \".md\");\n\n      if (seen.has(id)) continue;\n      seen.add(id);\n\n      const confMatch = fmMatch[1].match(/^confidence:\\s*(.+)$/m);\n      const confidence = confMatch ? parseFloat(confMatch[1]) : 0.9;\n\n      const entityMatch = fmMatch[1].match(/^entityRef:\\s*(.+)$/m);\n      const entityRefs = entityMatch ? [entityMatch[1].trim()] : [];\n\n      corrections.push({ id, content, created: \"\", confidence, entityRefs, tags: [] });\n    } catch {\n      // skip unparseable files\n    }\n  }\n\n  return corrections;\n}\n\n// ─── LLM-Assisted Clustering and Replay ──────────────────────────────────────\n\nconst CLUSTER_PROMPT = `You are analyzing user corrections to an AI assistant. Each correction represents a moment where the assistant's prediction of what the user wanted was WRONG.\n\nYour job: Group these corrections into clusters where the SAME TYPE of misunderstanding is happening. Then for each cluster, synthesize a CalibrationRule.\n\nA CalibrationRule describes:\n- condition: When does this type of mistake happen?\n- modelTendency: What does the model tend to assume or do wrong?\n- userExpectation: What does the user actually want instead?\n- calibration: How should the model adjust its behavior?\n- ruleType: One of \"model_tendency\", \"user_expectation\", \"scope_boundary\", \"verification_required\"\n\nFocus on PATTERNS, not individual corrections. A cluster needs at least 2 corrections to be worth a rule.\n\nOutput valid JSON only:\n{\n  \"rules\": [\n    {\n      \"ruleType\": \"model_tendency\",\n      \"condition\": \"When discussing project scope or task boundaries\",\n      \"modelTendency\": \"The model tends to assume broader scope than the user intends\",\n      \"userExpectation\": \"The user prefers narrow, specific task definitions and wants to be asked before scope expansion\",\n      \"calibration\": \"When uncertain about scope, ask for clarification rather than assuming. Default to the narrower interpretation.\",\n      \"confidence\": 0.85,\n      \"evidenceIds\": [\"correction-id-1\", \"correction-id-2\"]\n    }\n  ]\n}`;\n\nexport async function synthesizeCalibrationRules(\n  corrections: CorrectionMemory[],\n  llm: FallbackLlmClient,\n  existingRules: CalibrationRule[],\n  agentId?: string,\n): Promise<CalibrationRule[]> {\n  if (corrections.length < 2) return [];\n\n  // Format corrections for the LLM\n  const correctionText = corrections\n    .slice(0, 50) // limit to avoid huge prompts\n    .map((c, i) => `[${c.id}] ${c.content}`)\n    .join(\"\\n\\n\");\n\n  const existingRulesText = existingRules.length > 0\n    ? `\\n\\nExisting calibration rules (avoid duplicating these):\\n${existingRules.map((r) => `- ${r.condition}: ${r.calibration}`).join(\"\\n\")}`\n    : \"\";\n\n  const response = await llm.chatCompletion(\n    [\n      { role: \"system\", content: CLUSTER_PROMPT },\n      { role: \"user\", content: `Here are ${corrections.length} corrections from this user:\\n\\n${correctionText}${existingRulesText}` },\n    ],\n    { temperature: 0.3, maxTokens: 3000, agentId },\n  );\n\n  if (!response?.content) return [];\n\n  try {\n    let jsonStr = response.content.trim();\n    const fenceMatch = jsonStr.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```/);\n    if (fenceMatch) jsonStr = fenceMatch[1];\n\n    const parsed = JSON.parse(jsonStr);\n    if (!Array.isArray(parsed.rules)) return [];\n\n    const now = new Date().toISOString();\n    return parsed.rules\n      .filter((r: any) => r.condition && r.calibration && r.modelTendency)\n      .map((r: any) => ({\n        id: `cal-${createHash(\"sha256\").update(r.condition + r.calibration).digest(\"hex\").slice(0, 12)}`,\n        ruleType: r.ruleType ?? \"model_tendency\",\n        condition: String(r.condition),\n        modelTendency: String(r.modelTendency),\n        userExpectation: String(r.userExpectation ?? \"\"),\n        calibration: String(r.calibration),\n        confidence: typeof r.confidence === \"number\" ? r.confidence : 0.7,\n        evidenceCount: Array.isArray(r.evidenceIds) ? r.evidenceIds.length : 1,\n        evidenceCorrectionIds: Array.isArray(r.evidenceIds) ? r.evidenceIds : [],\n        createdAt: now,\n        lastReinforcedAt: now,\n      }));\n  } catch {\n    log.warn(\"[calibration] failed to parse LLM response\");\n    return [];\n  }\n}\n\n// ─── Recall Section ──────────────────────────────────────────────────────────\n\n/**\n * Build a recall section from calibration rules relevant to the current query.\n * Uses the LLM to select which rules apply to the current context.\n */\nexport function buildCalibrationRecallSection(\n  rules: CalibrationRule[],\n  query: string,\n  maxChars: number = 1200,\n): string | null {\n  if (rules.length === 0) return null;\n\n  // Simple relevance: include all rules (they're already filtered to this user)\n  // In production, could use embedding similarity to filter\n  const lines: string[] = [\n    \"## Model Calibration (learned from past corrections)\",\n    \"\",\n    \"Adjustments for this specific user, learned from patterns in their corrections:\",\n    \"\",\n  ];\n\n  let totalChars = lines.join(\"\\n\").length;\n\n  for (const rule of rules) {\n    const line = `- **${rule.condition}**: ${rule.modelTendency} → Instead: ${rule.calibration}`;\n    if (totalChars + line.length + 1 > maxChars) break;\n    lines.push(line);\n    totalChars += line.length + 1;\n  }\n\n  if (lines.length <= 4) return null;\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n// ─── Public API ──────────────────────────────────────────────────────────────\n\n/**\n * Run the full calibration pipeline:\n * 1. Read all corrections\n * 2. Send to LLM for clustering and rule synthesis\n * 3. Merge with existing rules\n * 4. Write updated index\n */\nexport async function runCalibrationConsolidation(options: {\n  memoryDir: string;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  workspaceDir?: string;\n}): Promise<CalibrationRule[]> {\n  try {\n    const llm = new FallbackLlmClient(options.gatewayConfig, {\n      workspaceDir: options.workspaceDir,\n    });\n    if (!llm.isAvailable(options.gatewayAgentId)) {\n      log.debug(\"[calibration] no LLM available — skipping consolidation\");\n      return [];\n    }\n\n    const corrections = await readCorrections(options.memoryDir);\n    if (corrections.length < 3) {\n      log.debug(`[calibration] only ${corrections.length} corrections — need at least 3`);\n      return [];\n    }\n\n    const existingIndex = await readCalibrationIndex(options.memoryDir);\n\n    const newRules = await synthesizeCalibrationRules(corrections, llm, existingIndex.rules, options.gatewayAgentId);\n    if (newRules.length === 0) {\n      log.debug(\"[calibration] no new calibration rules synthesized\");\n      return existingIndex.rules;\n    }\n\n    // Merge: keep existing rules, add new ones (deduplicate by id)\n    const ruleMap = new Map(existingIndex.rules.map((r) => [r.id, r]));\n    for (const rule of newRules) {\n      if (ruleMap.has(rule.id)) {\n        // Reinforce existing rule\n        const existing = ruleMap.get(rule.id)!;\n        existing.lastReinforcedAt = new Date().toISOString();\n        existing.evidenceCount += rule.evidenceCount;\n        existing.confidence = Math.min(1, existing.confidence + 0.05);\n      } else {\n        ruleMap.set(rule.id, rule);\n      }\n    }\n\n    const allRules = [...ruleMap.values()];\n    await writeCalibrationIndex(options.memoryDir, {\n      rules: allRules,\n      updatedAt: new Date().toISOString(),\n      totalCorrectionsAnalyzed: corrections.length,\n    });\n\n    log.debug(`[calibration] synthesized ${newRules.length} new rule(s), ${allRules.length} total`);\n    return allRules;\n  } catch (error) {\n    log.warn(`[calibration] consolidation failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);\n    return [];\n  }\n}\n\n/**\n * Standalone entry point for calibration consolidation that can be called\n * independently of weekly compounding. The compounding engine's\n * `synthesizeWeekly()` is one trigger, but orchestrators or periodic\n * maintenance jobs should call this directly so calibration is not gated\n * on weekly compounding being enabled.\n */\nexport async function runCalibrationIfEnabled(options: {\n  memoryDir: string;\n  calibrationEnabled: boolean;\n  gatewayConfig?: GatewayConfig;\n  workspaceDir?: string;\n}): Promise<CalibrationRule[]> {\n  if (!options.calibrationEnabled) {\n    return [];\n  }\n  return runCalibrationConsolidation({\n    memoryDir: options.memoryDir,\n    gatewayConfig: options.gatewayConfig,\n    workspaceDir: options.workspaceDir,\n  });\n}\n\n/**\n * Get calibration rules for recall injection.\n * Reads the pre-computed calibration index.\n */\nexport async function getCalibrationRulesForRecall(\n  memoryDir: string,\n): Promise<CalibrationRule[]> {\n  const index = await readCalibrationIndex(memoryDir);\n  return index.rules;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/calibration.ts"],"sourcesContent":["/**\n * calibration.ts — Prediction-Error-Driven Model-User Calibration\n *\n * Analyzes patterns in user corrections to identify systematic miscalibration\n * between the model's predictions and the user's actual expectations.\n * During consolidation, replays chains of similar corrections through an LLM\n * to synthesize CalibrationRules that adjust model behavior for this specific user.\n *\n * Inspired by:\n * - Cerebellar motor calibration (prediction errors drive lasting adjustments)\n * - Temporal difference learning (dopamine signals prediction error)\n * - Tesla FSD shadow mode (divergence between prediction and reality = training signal)\n */\n\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { FallbackLlmClient } from \"./fallback-llm.js\";\nimport type { GatewayConfig, MemoryFile } from \"./types.js\";\nimport { listJsonFiles, readJsonFile } from \"./json-store.js\";\nimport { isRecord } from \"./store-contract.js\";\nimport { log } from \"./logger.js\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface CalibrationRule {\n  id: string;\n  ruleType: \"model_tendency\" | \"user_expectation\" | \"scope_boundary\" | \"verification_required\";\n  condition: string;\n  modelTendency: string;\n  userExpectation: string;\n  calibration: string;\n  confidence: number;\n  evidenceCount: number;\n  evidenceCorrectionIds: string[];\n  createdAt: string;\n  lastReinforcedAt: string;\n}\n\nexport interface CalibrationIndex {\n  rules: CalibrationRule[];\n  updatedAt: string;\n  totalCorrectionsAnalyzed: number;\n}\n\n// ─── Storage ─────────────────────────────────────────────────────────────────\n\nfunction calibrationDir(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", \"calibration\");\n}\n\nfunction calibrationIndexPath(memoryDir: string): string {\n  return path.join(calibrationDir(memoryDir), \"calibration-index.json\");\n}\n\nexport async function readCalibrationIndex(memoryDir: string): Promise<CalibrationIndex> {\n  try {\n    const raw = JSON.parse(await readFile(calibrationIndexPath(memoryDir), \"utf8\"));\n    return {\n      rules: Array.isArray(raw.rules) ? raw.rules : [],\n      updatedAt: typeof raw.updatedAt === \"string\" ? raw.updatedAt : new Date().toISOString(),\n      totalCorrectionsAnalyzed: typeof raw.totalCorrectionsAnalyzed === \"number\" ? raw.totalCorrectionsAnalyzed : 0,\n    };\n  } catch {\n    return { rules: [], updatedAt: new Date().toISOString(), totalCorrectionsAnalyzed: 0 };\n  }\n}\n\nasync function writeCalibrationIndex(memoryDir: string, index: CalibrationIndex): Promise<void> {\n  const dir = calibrationDir(memoryDir);\n  await mkdir(dir, { recursive: true });\n  index.updatedAt = new Date().toISOString();\n  await writeFile(calibrationIndexPath(memoryDir), JSON.stringify(index, null, 2), \"utf8\");\n}\n\n// ─── Correction Reading ──────────────────────────────────────────────────────\n\nexport interface CorrectionMemory {\n  id: string;\n  content: string;\n  created: string;\n  confidence: number;\n  entityRefs: string[];\n  tags: string[];\n}\n\nconst CALIBRATION_RULE_TYPES = new Set([\n  \"model_tendency\",\n  \"user_expectation\",\n  \"scope_boundary\",\n  \"verification_required\",\n]);\n\nfunction parseConfidence(value: unknown): number | undefined {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return undefined;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction parseEvidenceIds(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.filter((item): item is string => typeof item === \"string\" && item.trim().length > 0);\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\n/**\n * Exported for entity-contamination R-11 regression coverage (#682\n * PR 2/3 — codex review).  Tests can drive the real correction-reading\n * path instead of duplicating the regex inline, so calibration parser\n * regressions surface via the contamination suite.\n */\nexport async function readCalibrationCorrections(memoryDir: string): Promise<CorrectionMemory[]> {\n  return readCorrectionsImpl(memoryDir);\n}\n\nasync function readCorrections(memoryDir: string): Promise<CorrectionMemory[]> {\n  return readCorrectionsImpl(memoryDir);\n}\n\nasync function readCorrectionsImpl(memoryDir: string): Promise<CorrectionMemory[]> {\n  const correctionsDir = path.join(memoryDir, \"corrections\");\n  const files = await listJsonFiles(correctionsDir).catch(() => {\n    // Corrections might be in facts/ directories too\n    return [] as string[];\n  });\n\n  // Also scan facts directories for correction-category files\n  const factsDir = path.join(memoryDir, \"facts\");\n  try {\n    const { readdir } = await import(\"node:fs/promises\");\n    const dayDirs = (await readdir(factsDir)).filter((d: string) => /^\\d{4}-\\d{2}-\\d{2}$/.test(d));\n    for (const day of dayDirs) {\n      const dayPath = path.join(factsDir, day);\n      const dayFiles = (await readdir(dayPath))\n        .filter((f: string) => f.startsWith(\"correction-\") && f.endsWith(\".md\"))\n        .map((f: string) => path.join(dayPath, f));\n      files.push(...dayFiles);\n    }\n  } catch {\n    // facts dir might not exist\n  }\n\n  // Also check the dedicated corrections directory\n  try {\n    const { readdir } = await import(\"node:fs/promises\");\n    const corrFiles = (await readdir(correctionsDir))\n      .filter((f: string) => f.endsWith(\".md\"))\n      .map((f: string) => path.join(correctionsDir, f));\n    files.push(...corrFiles);\n  } catch {\n    // corrections dir might not exist\n  }\n\n  const corrections: CorrectionMemory[] = [];\n  const seen = new Set<string>();\n\n  for (const filePath of files) {\n    try {\n      const raw = await readFile(filePath, \"utf8\");\n\n      // Parse frontmatter\n      const fmMatch = raw.match(/^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/);\n      if (!fmMatch) continue;\n\n      const content = fmMatch[2].trim();\n      if (!content || content.length < 10) continue;\n\n      // Extract id from frontmatter\n      const idMatch = fmMatch[1].match(/^id:\\s*(.+)$/m);\n      const id = idMatch?.[1]?.trim() ?? path.basename(filePath, \".md\");\n\n      if (seen.has(id)) continue;\n      seen.add(id);\n\n      const confMatch = fmMatch[1].match(/^confidence:\\s*(.+)$/m);\n      const confidence = confMatch ? parseFloat(confMatch[1]) : 0.9;\n\n      const entityMatch = fmMatch[1].match(/^entityRef:\\s*(.+)$/m);\n      const entityRefs = entityMatch ? [entityMatch[1].trim()] : [];\n\n      corrections.push({ id, content, created: \"\", confidence, entityRefs, tags: [] });\n    } catch {\n      // skip unparseable files\n    }\n  }\n\n  return corrections;\n}\n\n// ─── LLM-Assisted Clustering and Replay ──────────────────────────────────────\n\nconst CLUSTER_PROMPT = `You are analyzing user corrections to an AI assistant. Each correction represents a moment where the assistant's prediction of what the user wanted was WRONG.\n\nYour job: Group these corrections into clusters where the SAME TYPE of misunderstanding is happening. Then for each cluster, synthesize a CalibrationRule.\n\nA CalibrationRule describes:\n- condition: When does this type of mistake happen?\n- modelTendency: What does the model tend to assume or do wrong?\n- userExpectation: What does the user actually want instead?\n- calibration: How should the model adjust its behavior?\n- ruleType: One of \"model_tendency\", \"user_expectation\", \"scope_boundary\", \"verification_required\"\n\nFocus on PATTERNS, not individual corrections. A cluster needs at least 2 corrections to be worth a rule.\n\nOutput valid JSON only:\n{\n  \"rules\": [\n    {\n      \"ruleType\": \"model_tendency\",\n      \"condition\": \"When discussing project scope or task boundaries\",\n      \"modelTendency\": \"The model tends to assume broader scope than the user intends\",\n      \"userExpectation\": \"The user prefers narrow, specific task definitions and wants to be asked before scope expansion\",\n      \"calibration\": \"When uncertain about scope, ask for clarification rather than assuming. Default to the narrower interpretation.\",\n      \"confidence\": 0.85,\n      \"evidenceIds\": [\"correction-id-1\", \"correction-id-2\"]\n    }\n  ]\n}`;\n\nexport async function synthesizeCalibrationRules(\n  corrections: CorrectionMemory[],\n  llm: FallbackLlmClient,\n  existingRules: CalibrationRule[],\n  agentId?: string,\n): Promise<CalibrationRule[]> {\n  if (corrections.length < 2) return [];\n\n  // Format corrections for the LLM\n  const correctionText = corrections\n    .slice(0, 50) // limit to avoid huge prompts\n    .map((c, i) => `[${c.id}] ${c.content}`)\n    .join(\"\\n\\n\");\n\n  const existingRulesText = existingRules.length > 0\n    ? `\\n\\nExisting calibration rules (avoid duplicating these):\\n${existingRules.map((r) => `- ${r.condition}: ${r.calibration}`).join(\"\\n\")}`\n    : \"\";\n\n  const response = await llm.chatCompletion(\n    [\n      { role: \"system\", content: CLUSTER_PROMPT },\n      { role: \"user\", content: `Here are ${corrections.length} corrections from this user:\\n\\n${correctionText}${existingRulesText}` },\n    ],\n    { temperature: 0.3, maxTokens: 3000, agentId },\n  );\n\n  if (!response?.content) return [];\n\n  try {\n    let jsonStr = response.content.trim();\n    const fenceMatch = jsonStr.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```/);\n    if (fenceMatch) jsonStr = fenceMatch[1];\n\n    const parsed = JSON.parse(jsonStr);\n    if (!Array.isArray(parsed.rules)) return [];\n\n    const now = new Date().toISOString();\n    const rawRules: unknown[] = Array.isArray(parsed.rules) ? parsed.rules : [];\n    return rawRules\n      .map((r: unknown): CalibrationRule | undefined => {\n        if (!r || typeof r !== \"object\" || Array.isArray(r)) return undefined;\n        const raw = r as Record<string, unknown>;\n        const ruleType = nonEmptyString(raw.ruleType);\n        const condition = nonEmptyString(raw.condition);\n        const modelTendency = nonEmptyString(raw.modelTendency);\n        const calibration = nonEmptyString(raw.calibration);\n        const confidence = parseConfidence(raw.confidence);\n        if (\n          !ruleType ||\n          !CALIBRATION_RULE_TYPES.has(ruleType) ||\n          !condition ||\n          !modelTendency ||\n          !calibration ||\n          confidence === undefined\n        ) {\n          return undefined;\n        }\n        const evidenceCorrectionIds = parseEvidenceIds(raw.evidenceIds);\n        return {\n          id: `cal-${createHash(\"sha256\").update(condition + calibration).digest(\"hex\").slice(0, 12)}`,\n          ruleType: ruleType as CalibrationRule[\"ruleType\"],\n          condition,\n          modelTendency,\n          userExpectation: nonEmptyString(raw.userExpectation) ?? \"\",\n          calibration,\n          confidence,\n          evidenceCount: evidenceCorrectionIds.length,\n          evidenceCorrectionIds,\n        createdAt: now,\n        lastReinforcedAt: now,\n        };\n      })\n      .filter((rule): rule is CalibrationRule => !!rule);\n  } catch {\n    log.warn(\"[calibration] failed to parse LLM response\");\n    return [];\n  }\n}\n\n// ─── Recall Section ──────────────────────────────────────────────────────────\n\n/**\n * Build a recall section from calibration rules relevant to the current query.\n * Uses the LLM to select which rules apply to the current context.\n */\nexport function buildCalibrationRecallSection(\n  rules: CalibrationRule[],\n  query: string,\n  maxChars: number = 1200,\n): string | null {\n  if (rules.length === 0) return null;\n\n  // Simple relevance: include all rules (they're already filtered to this user)\n  // In production, could use embedding similarity to filter\n  const lines: string[] = [\n    \"## Model Calibration (learned from past corrections)\",\n    \"\",\n    \"Adjustments for this specific user, learned from patterns in their corrections:\",\n    \"\",\n  ];\n\n  let totalChars = lines.join(\"\\n\").length;\n\n  for (const rule of rules) {\n    const line = `- **${rule.condition}**: ${rule.modelTendency} → Instead: ${rule.calibration}`;\n    if (totalChars + line.length + 1 > maxChars) break;\n    lines.push(line);\n    totalChars += line.length + 1;\n  }\n\n  if (lines.length <= 4) return null;\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n// ─── Public API ──────────────────────────────────────────────────────────────\n\n/**\n * Run the full calibration pipeline:\n * 1. Read all corrections\n * 2. Send to LLM for clustering and rule synthesis\n * 3. Merge with existing rules\n * 4. Write updated index\n */\nexport async function runCalibrationConsolidation(options: {\n  memoryDir: string;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  workspaceDir?: string;\n}): Promise<CalibrationRule[]> {\n  try {\n    const llm = new FallbackLlmClient(options.gatewayConfig, {\n      workspaceDir: options.workspaceDir,\n    });\n    if (!llm.isAvailable(options.gatewayAgentId)) {\n      log.debug(\"[calibration] no LLM available — skipping consolidation\");\n      return [];\n    }\n\n    const corrections = await readCorrections(options.memoryDir);\n    if (corrections.length < 3) {\n      log.debug(`[calibration] only ${corrections.length} corrections — need at least 3`);\n      return [];\n    }\n\n    const existingIndex = await readCalibrationIndex(options.memoryDir);\n\n    const newRules = await synthesizeCalibrationRules(corrections, llm, existingIndex.rules, options.gatewayAgentId);\n    if (newRules.length === 0) {\n      log.debug(\"[calibration] no new calibration rules synthesized\");\n      return existingIndex.rules;\n    }\n\n    // Merge: keep existing rules, add new ones (deduplicate by id)\n    const ruleMap = new Map(existingIndex.rules.map((r) => [r.id, r]));\n    for (const rule of newRules) {\n      if (ruleMap.has(rule.id)) {\n        // Reinforce existing rule\n        const existing = ruleMap.get(rule.id)!;\n        existing.lastReinforcedAt = new Date().toISOString();\n        existing.evidenceCount += rule.evidenceCount;\n        existing.confidence = Math.min(1, existing.confidence + 0.05);\n      } else {\n        ruleMap.set(rule.id, rule);\n      }\n    }\n\n    const allRules = [...ruleMap.values()];\n    await writeCalibrationIndex(options.memoryDir, {\n      rules: allRules,\n      updatedAt: new Date().toISOString(),\n      totalCorrectionsAnalyzed: corrections.length,\n    });\n\n    log.debug(`[calibration] synthesized ${newRules.length} new rule(s), ${allRules.length} total`);\n    return allRules;\n  } catch (error) {\n    log.warn(`[calibration] consolidation failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);\n    return [];\n  }\n}\n\n/**\n * Standalone entry point for calibration consolidation that can be called\n * independently of weekly compounding. The compounding engine's\n * `synthesizeWeekly()` is one trigger, but orchestrators or periodic\n * maintenance jobs should call this directly so calibration is not gated\n * on weekly compounding being enabled.\n */\nexport async function runCalibrationIfEnabled(options: {\n  memoryDir: string;\n  calibrationEnabled: boolean;\n  gatewayConfig?: GatewayConfig;\n  workspaceDir?: string;\n}): Promise<CalibrationRule[]> {\n  if (!options.calibrationEnabled) {\n    return [];\n  }\n  return runCalibrationConsolidation({\n    memoryDir: options.memoryDir,\n    gatewayConfig: options.gatewayConfig,\n    workspaceDir: options.workspaceDir,\n  });\n}\n\n/**\n * Get calibration rules for recall injection.\n * Reads the pre-computed calibration index.\n */\nexport async function getCalibrationRulesForRecall(\n  memoryDir: string,\n): Promise<CalibrationRule[]> {\n  const index = await readCalibrationIndex(memoryDir);\n  return index.rules;\n}\n"],"mappings":"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","names":[]}

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

@@ -3,7 +3,7 @@ import {
   decryptCapsuleFileInMemory,
   encryptCapsuleFile,
   isEncryptedCapsuleFile
-} from "./chunk-KNKUID7G.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-5CYAGVC5.js.map
+//# sourceMappingURL=capsule-crypto-7FJQINUR.js.map

package/dist/{capsule-merge-4MGKE7C5.js → capsule-merge-T2JRE46P.js}

@@ -1,6 +1,6 @@
 import {
   createVersion
-} from "./chunk-FAAFWE4G.js";
+} from "./chunk-ALEPI75L.js";
 import {
   parseExportBundle
 } from "./chunk-WEHSQBFR.js";
@@ -10,7 +10,7 @@ import {
   fromPosixRelPath,
   isPathInsideRoot,
   sha256String
-} from "./chunk-AGZQD76C.js";
+} from "./chunk-GCGJW34D.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/transfer/capsule-merge.ts
@@ -186,4 +186,4 @@ async function readLocalFile(absPath) {
 export {
   mergeCapsule
 };
-//# sourceMappingURL=capsule-merge-4MGKE7C5.js.map
+//# sourceMappingURL=capsule-merge-T2JRE46P.js.map

package/dist/causal-behavior.d.ts

@@ -3,6 +3,7 @@ import { ConsolidatedPreference } from './compounding/preference-consolidator.js
 import './causal-trajectory.js';
 import './objective-state.js';
 import './types.js';
+import './types-BliCnURB.js';
 import './index-DJ9QWMw-.js';
 import './lcm/engine.js';
 import './lcm/archive.js';

package/dist/causal-behavior.js

@@ -1,11 +1,11 @@
 import {
   readChainIndex,
   resolveChainsDir
-} from "./chunk-VLXA6PI2.js";
-import "./chunk-NZL6GGQE.js";
+} from "./chunk-YQMZ7IH2.js";
+import "./chunk-HQ6NIBL6.js";
 import {
   resolveCausalTrajectoryStoreDir
-} from "./chunk-MY6TPVXW.js";
+} from "./chunk-LMPHTYJC.js";
 import {
   normalizeRecallTokens
 } from "./chunk-DT5TVLJE.js";
@@ -14,7 +14,7 @@ import {
 } from "./chunk-2ODBA7MQ.js";
 import {
   isRecord
-} from "./chunk-DGXUHMOV.js";
+} from "./chunk-A2IYSXDQ.js";
 import {
   listJsonFiles,
   readJsonFile

package/dist/causal-chain.js

@@ -6,12 +6,12 @@ import {
   stitchCausalChain,
   validateCausalEdge,
   writeChainIndex
-} from "./chunk-VLXA6PI2.js";
-import "./chunk-NZL6GGQE.js";
-import "./chunk-MY6TPVXW.js";
+} from "./chunk-YQMZ7IH2.js";
+import "./chunk-HQ6NIBL6.js";
+import "./chunk-LMPHTYJC.js";
 import "./chunk-DT5TVLJE.js";
 import "./chunk-2ODBA7MQ.js";
-import "./chunk-DGXUHMOV.js";
+import "./chunk-A2IYSXDQ.js";
 import "./chunk-LPSF4OQH.js";
 import "./chunk-PZ5AY32C.js";
 export {