@graphorin/memory 0.6.1 → 0.7.0

package/dist/context-engine/privacy-filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"privacy-filter.js","names":["kept: TRecord[]","dropped: Array<{ readonly record: TRecord; readonly reason: PrivacyDecisionReason }>","counters: Record<PrivacyDecisionReason, number>"],"sources":["../../src/context-engine/privacy-filter.ts"],"sourcesContent":["/**\n * D2 sensitivity-tier filter. Tags every memory record with a\n * decision (`'pass'` / `'drop'`) before the assembled prompt is\n * compiled. The filter is *tier-based* - it trusts the\n * `record.sensitivity` tag the consolidator / writer set; the\n * outbound prompt-redaction middleware (D3, ADR-045) is the\n * universal backstop for content the filter cannot see (raw user\n * input, tool results, MCP responses, skill bodies, agent\n * instructions, tool-call args).\n *\n * @packageDocumentation\n */\n\nimport type { LocalProviderTrust, Sensitivity } from '@graphorin/core';\n\n/**\n * Filter input: the record-level sensitivity tag + the per-tier\n * trust class of the active provider.\n *\n * @stable\n */\nexport interface PrivacyFilterContext {\n  /**\n   * Sensitivity tiers the active provider is allowed to receive.\n   * When omitted, the per-tier defaults below apply.\n   */\n  readonly providerAcceptsSensitivity?: ReadonlyArray<Sensitivity>;\n  /**\n   * Trust class of the active provider as classified by\n   * `@graphorin/provider/trust/classify-local-provider.ts`. Defaults\n   * to `'public-tls'` (the conservative cloud default).\n   */\n  readonly providerTrust?: LocalProviderTrust;\n  /**\n   * Per-user opt-in for cloud upload of `'internal'`-tier content.\n   * Default `false` - `'internal'` content does not leave the\n   * loopback boundary unless the user explicitly opts in.\n   */\n  readonly cloudUploadConsent?: boolean;\n  /**\n   * Override the default sensitivity applied to records that are\n   * missing a tag. Default `'internal'` per DEC-126.\n   */\n  readonly defaultSensitivity?: Sensitivity;\n}\n\n/**\n * Output of {@link decide} for a single record.\n *\n * @stable\n */\nexport type PrivacyDecision = 'pass' | 'drop';\n\n/**\n * Reason the decision was made. Surfaced to the metadata block so\n * operators can audit per-tier drops.\n *\n * @stable\n */\nexport type PrivacyDecisionReason =\n  | 'provider-rejects-secret'\n  | 'provider-rejects-internal'\n  | 'no-cloud-upload-consent'\n  | 'allowed';\n\n/**\n * Resolve the effective `acceptsSensitivity` set for a provider.\n * The function is pure: callers can supply a custom matrix to\n * override the defaults (used by tests + custom adapters).\n *\n * Defaults (DEC-149, ADR-013 ext):\n *\n * - `'loopback'`  → `['public', 'internal', 'secret']`.\n * - `'private'`   → `['public', 'internal']`.\n * - `'public-tls'` / `'public-mtls'` → `['public']`.\n * - `'public-cleartext'` → `['public']`.\n *\n * Per-provider overrides always win over the defaults - pass\n * `providerAcceptsSensitivity` explicitly to override.\n *\n * @stable\n */\nexport function effectiveAcceptsSensitivity(\n  context: PrivacyFilterContext,\n): ReadonlyArray<Sensitivity> {\n  if (context.providerAcceptsSensitivity !== undefined) {\n    return context.providerAcceptsSensitivity;\n  }\n  switch (context.providerTrust ?? 'public-tls') {\n    case 'loopback':\n      return ['public', 'internal', 'secret'];\n    case 'private':\n      return ['public', 'internal'];\n    case 'public-tls':\n    case 'public-cleartext':\n      return ['public'];\n    default:\n      return ['public'];\n  }\n}\n\n/**\n * Decide whether a single record is safe to send to the active\n * provider. The decision logic mirrors the DoD spec:\n *\n * - `'public'` always passes.\n * - `'secret'` passes only when the provider explicitly accepts\n *   `'secret'` AND the trust class is `'loopback'`.\n * - `'internal'` passes when the provider accepts `'internal'`\n *   AND `cloudUploadConsent === true` (or the trust class is\n *   `'loopback'` / `'private'`).\n *\n * @stable\n */\nexport function decide(\n  recordSensitivity: Sensitivity | undefined,\n  context: PrivacyFilterContext,\n): { readonly decision: PrivacyDecision; readonly reason: PrivacyDecisionReason } {\n  const sensitivity = recordSensitivity ?? context.defaultSensitivity ?? 'internal';\n  const accepts = effectiveAcceptsSensitivity(context);\n  const trust = context.providerTrust ?? 'public-tls';\n  if (sensitivity === 'public') {\n    return { decision: 'pass', reason: 'allowed' };\n  }\n  if (sensitivity === 'secret') {\n    if (accepts.includes('secret') && trust === 'loopback') {\n      return { decision: 'pass', reason: 'allowed' };\n    }\n    return { decision: 'drop', reason: 'provider-rejects-secret' };\n  }\n  // 'internal'\n  if (!accepts.includes('internal')) {\n    return { decision: 'drop', reason: 'provider-rejects-internal' };\n  }\n  if (trust === 'loopback' || trust === 'private') {\n    return { decision: 'pass', reason: 'allowed' };\n  }\n  if (context.cloudUploadConsent === true) {\n    return { decision: 'pass', reason: 'allowed' };\n  }\n  return { decision: 'drop', reason: 'no-cloud-upload-consent' };\n}\n\n/**\n * Bookkeeping returned by {@link partition}. Carries both the\n * surviving + dropped records and a per-reason counter for the\n * audit trail.\n *\n * @stable\n */\nexport interface PartitionResult<TRecord> {\n  readonly kept: ReadonlyArray<TRecord>;\n  readonly dropped: ReadonlyArray<{\n    readonly record: TRecord;\n    readonly reason: PrivacyDecisionReason;\n  }>;\n  readonly counters: Readonly<Record<PrivacyDecisionReason, number>>;\n}\n\n/**\n * Partition a record list against the supplied filter context.\n *\n * @stable\n */\nexport function partition<TRecord extends { readonly sensitivity?: Sensitivity }>(\n  records: ReadonlyArray<TRecord>,\n  context: PrivacyFilterContext,\n): PartitionResult<TRecord> {\n  const kept: TRecord[] = [];\n  const dropped: Array<{ readonly record: TRecord; readonly reason: PrivacyDecisionReason }> = [];\n  const counters: Record<PrivacyDecisionReason, number> = {\n    allowed: 0,\n    'no-cloud-upload-consent': 0,\n    'provider-rejects-internal': 0,\n    'provider-rejects-secret': 0,\n  };\n  for (const record of records) {\n    const outcome = decide(record.sensitivity, context);\n    counters[outcome.reason] += 1;\n    if (outcome.decision === 'pass') {\n      kept.push(record);\n    } else {\n      dropped.push({ record, reason: outcome.reason });\n    }\n  }\n  return Object.freeze({\n    kept: Object.freeze(kept),\n    dropped: Object.freeze(dropped),\n    counters: Object.freeze(counters),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkFA,SAAgB,4BACd,SAC4B;AAC5B,KAAI,QAAQ,+BAA+B,OACzC,QAAO,QAAQ;AAEjB,SAAQ,QAAQ,iBAAiB,cAAjC;EACE,KAAK,WACH,QAAO;GAAC;GAAU;GAAY;GAAS;EACzC,KAAK,UACH,QAAO,CAAC,UAAU,WAAW;EAC/B,KAAK;EACL,KAAK,mBACH,QAAO,CAAC,SAAS;EACnB,QACE,QAAO,CAAC,SAAS;;;;;;;;;;;;;;;;AAiBvB,SAAgB,OACd,mBACA,SACgF;CAChF,MAAM,cAAc,qBAAqB,QAAQ,sBAAsB;CACvE,MAAM,UAAU,4BAA4B,QAAQ;CACpD,MAAM,QAAQ,QAAQ,iBAAiB;AACvC,KAAI,gBAAgB,SAClB,QAAO;EAAE,UAAU;EAAQ,QAAQ;EAAW;AAEhD,KAAI,gBAAgB,UAAU;AAC5B,MAAI,QAAQ,SAAS,SAAS,IAAI,UAAU,WAC1C,QAAO;GAAE,UAAU;GAAQ,QAAQ;GAAW;AAEhD,SAAO;GAAE,UAAU;GAAQ,QAAQ;GAA2B;;AAGhE,KAAI,CAAC,QAAQ,SAAS,WAAW,CAC/B,QAAO;EAAE,UAAU;EAAQ,QAAQ;EAA6B;AAElE,KAAI,UAAU,cAAc,UAAU,UACpC,QAAO;EAAE,UAAU;EAAQ,QAAQ;EAAW;AAEhD,KAAI,QAAQ,uBAAuB,KACjC,QAAO;EAAE,UAAU;EAAQ,QAAQ;EAAW;AAEhD,QAAO;EAAE,UAAU;EAAQ,QAAQ;EAA2B;;;;;;;AAwBhE,SAAgB,UACd,SACA,SAC0B;CAC1B,MAAMA,OAAkB,EAAE;CAC1B,MAAMC,UAAuF,EAAE;CAC/F,MAAMC,WAAkD;EACtD,SAAS;EACT,2BAA2B;EAC3B,6BAA6B;EAC7B,2BAA2B;EAC5B;AACD,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,UAAU,OAAO,OAAO,aAAa,QAAQ;AACnD,WAAS,QAAQ,WAAW;AAC5B,MAAI,QAAQ,aAAa,OACvB,MAAK,KAAK,OAAO;MAEjB,SAAQ,KAAK;GAAE;GAAQ,QAAQ,QAAQ;GAAQ,CAAC;;AAGpD,QAAO,OAAO,OAAO;EACnB,MAAM,OAAO,OAAO,KAAK;EACzB,SAAS,OAAO,OAAO,QAAQ;EAC/B,UAAU,OAAO,OAAO,SAAS;EAClC,CAAC"}
+{"version":3,"file":"privacy-filter.js","names":["kept: TRecord[]","dropped: Array<{ readonly record: TRecord; readonly reason: PrivacyDecisionReason }>","counters: Record<PrivacyDecisionReason, number>"],"sources":["../../src/context-engine/privacy-filter.ts"],"sourcesContent":["/**\n * D2 sensitivity-tier filter. Tags every memory record with a\n * decision (`'pass'` / `'drop'`) before the assembled prompt is\n * compiled. The filter is *tier-based* - it trusts the\n * `record.sensitivity` tag the consolidator / writer set; the\n * outbound prompt-redaction middleware (D3, ADR-045) is the\n * universal backstop for content the filter cannot see (raw user\n * input, tool results, MCP responses, skill bodies, agent\n * instructions, tool-call args).\n *\n * @packageDocumentation\n */\n\nimport type { LocalProviderTrust, Sensitivity } from '@graphorin/core';\n\n/**\n * Filter input: the record-level sensitivity tag + the per-tier\n * trust class of the active provider.\n *\n * @stable\n */\nexport interface PrivacyFilterContext {\n  /**\n   * Sensitivity tiers the active provider is allowed to receive.\n   * When omitted, the per-tier defaults below apply.\n   */\n  readonly providerAcceptsSensitivity?: ReadonlyArray<Sensitivity>;\n  /**\n   * Trust class of the active provider as classified by\n   * `@graphorin/provider/trust/classify-local-provider.ts`. Defaults\n   * to `'public-tls'` (the conservative cloud default).\n   */\n  readonly providerTrust?: LocalProviderTrust;\n  /**\n   * Per-user opt-in for cloud upload of `'internal'`-tier content.\n   * Default `false` - `'internal'` content does not leave the\n   * loopback boundary unless the user explicitly opts in.\n   */\n  readonly cloudUploadConsent?: boolean;\n  /**\n   * Override the default sensitivity applied to records that are\n   * missing a tag. Default `'internal'` per DEC-126.\n   */\n  readonly defaultSensitivity?: Sensitivity;\n}\n\n/**\n * Output of {@link decide} for a single record.\n *\n * @stable\n */\nexport type PrivacyDecision = 'pass' | 'drop';\n\n/**\n * Reason the decision was made. Surfaced to the metadata block so\n * operators can audit per-tier drops.\n *\n * @stable\n */\nexport type PrivacyDecisionReason =\n  | 'provider-rejects-secret'\n  | 'provider-rejects-internal'\n  | 'no-cloud-upload-consent'\n  | 'allowed';\n\n/**\n * Resolve the effective `acceptsSensitivity` set for a provider.\n * The function is pure: callers can supply a custom matrix to\n * override the defaults (used by tests + custom adapters).\n *\n * Defaults (DEC-149, ADR-013 ext):\n *\n * - `'loopback'`  → `['public', 'internal', 'secret']`.\n * - `'private'`   → `['public', 'internal']`.\n * - `'public-tls'` / `'public-cleartext'` → `['public']`.\n *\n * Per-provider overrides always win over the defaults - pass\n * `providerAcceptsSensitivity` explicitly to override.\n *\n * @stable\n */\nexport function effectiveAcceptsSensitivity(\n  context: PrivacyFilterContext,\n): ReadonlyArray<Sensitivity> {\n  if (context.providerAcceptsSensitivity !== undefined) {\n    return context.providerAcceptsSensitivity;\n  }\n  switch (context.providerTrust ?? 'public-tls') {\n    case 'loopback':\n      return ['public', 'internal', 'secret'];\n    case 'private':\n      return ['public', 'internal'];\n    case 'public-tls':\n    case 'public-cleartext':\n      return ['public'];\n    default:\n      return ['public'];\n  }\n}\n\n/**\n * Decide whether a single record is safe to send to the active\n * provider. The decision logic mirrors the DoD spec:\n *\n * - `'public'` always passes.\n * - `'secret'` passes only when the provider explicitly accepts\n *   `'secret'` AND the trust class is `'loopback'`.\n * - `'internal'` passes when the provider accepts `'internal'`\n *   AND `cloudUploadConsent === true` (or the trust class is\n *   `'loopback'` / `'private'`).\n *\n * @stable\n */\nexport function decide(\n  recordSensitivity: Sensitivity | undefined,\n  context: PrivacyFilterContext,\n): { readonly decision: PrivacyDecision; readonly reason: PrivacyDecisionReason } {\n  const sensitivity = recordSensitivity ?? context.defaultSensitivity ?? 'internal';\n  const accepts = effectiveAcceptsSensitivity(context);\n  const trust = context.providerTrust ?? 'public-tls';\n  if (sensitivity === 'public') {\n    return { decision: 'pass', reason: 'allowed' };\n  }\n  if (sensitivity === 'secret') {\n    if (accepts.includes('secret') && trust === 'loopback') {\n      return { decision: 'pass', reason: 'allowed' };\n    }\n    return { decision: 'drop', reason: 'provider-rejects-secret' };\n  }\n  // 'internal'\n  if (!accepts.includes('internal')) {\n    return { decision: 'drop', reason: 'provider-rejects-internal' };\n  }\n  if (trust === 'loopback' || trust === 'private') {\n    return { decision: 'pass', reason: 'allowed' };\n  }\n  if (context.cloudUploadConsent === true) {\n    return { decision: 'pass', reason: 'allowed' };\n  }\n  return { decision: 'drop', reason: 'no-cloud-upload-consent' };\n}\n\n/**\n * Bookkeeping returned by {@link partition}. Carries both the\n * surviving + dropped records and a per-reason counter for the\n * audit trail.\n *\n * @stable\n */\nexport interface PartitionResult<TRecord> {\n  readonly kept: ReadonlyArray<TRecord>;\n  readonly dropped: ReadonlyArray<{\n    readonly record: TRecord;\n    readonly reason: PrivacyDecisionReason;\n  }>;\n  readonly counters: Readonly<Record<PrivacyDecisionReason, number>>;\n}\n\n/**\n * Partition a record list against the supplied filter context.\n *\n * @stable\n */\nexport function partition<TRecord extends { readonly sensitivity?: Sensitivity }>(\n  records: ReadonlyArray<TRecord>,\n  context: PrivacyFilterContext,\n): PartitionResult<TRecord> {\n  const kept: TRecord[] = [];\n  const dropped: Array<{ readonly record: TRecord; readonly reason: PrivacyDecisionReason }> = [];\n  const counters: Record<PrivacyDecisionReason, number> = {\n    allowed: 0,\n    'no-cloud-upload-consent': 0,\n    'provider-rejects-internal': 0,\n    'provider-rejects-secret': 0,\n  };\n  for (const record of records) {\n    const outcome = decide(record.sensitivity, context);\n    counters[outcome.reason] += 1;\n    if (outcome.decision === 'pass') {\n      kept.push(record);\n    } else {\n      dropped.push({ record, reason: outcome.reason });\n    }\n  }\n  return Object.freeze({\n    kept: Object.freeze(kept),\n    dropped: Object.freeze(dropped),\n    counters: Object.freeze(counters),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiFA,SAAgB,4BACd,SAC4B;AAC5B,KAAI,QAAQ,+BAA+B,OACzC,QAAO,QAAQ;AAEjB,SAAQ,QAAQ,iBAAiB,cAAjC;EACE,KAAK,WACH,QAAO;GAAC;GAAU;GAAY;GAAS;EACzC,KAAK,UACH,QAAO,CAAC,UAAU,WAAW;EAC/B,KAAK;EACL,KAAK,mBACH,QAAO,CAAC,SAAS;EACnB,QACE,QAAO,CAAC,SAAS;;;;;;;;;;;;;;;;AAiBvB,SAAgB,OACd,mBACA,SACgF;CAChF,MAAM,cAAc,qBAAqB,QAAQ,sBAAsB;CACvE,MAAM,UAAU,4BAA4B,QAAQ;CACpD,MAAM,QAAQ,QAAQ,iBAAiB;AACvC,KAAI,gBAAgB,SAClB,QAAO;EAAE,UAAU;EAAQ,QAAQ;EAAW;AAEhD,KAAI,gBAAgB,UAAU;AAC5B,MAAI,QAAQ,SAAS,SAAS,IAAI,UAAU,WAC1C,QAAO;GAAE,UAAU;GAAQ,QAAQ;GAAW;AAEhD,SAAO;GAAE,UAAU;GAAQ,QAAQ;GAA2B;;AAGhE,KAAI,CAAC,QAAQ,SAAS,WAAW,CAC/B,QAAO;EAAE,UAAU;EAAQ,QAAQ;EAA6B;AAElE,KAAI,UAAU,cAAc,UAAU,UACpC,QAAO;EAAE,UAAU;EAAQ,QAAQ;EAAW;AAEhD,KAAI,QAAQ,uBAAuB,KACjC,QAAO;EAAE,UAAU;EAAQ,QAAQ;EAAW;AAEhD,QAAO;EAAE,UAAU;EAAQ,QAAQ;EAA2B;;;;;;;AAwBhE,SAAgB,UACd,SACA,SAC0B;CAC1B,MAAMA,OAAkB,EAAE;CAC1B,MAAMC,UAAuF,EAAE;CAC/F,MAAMC,WAAkD;EACtD,SAAS;EACT,2BAA2B;EAC3B,6BAA6B;EAC7B,2BAA2B;EAC5B;AACD,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,UAAU,OAAO,OAAO,aAAa,QAAQ;AACnD,WAAS,QAAQ,WAAW;AAC5B,MAAI,QAAQ,aAAa,OACvB,MAAK,KAAK,OAAO;MAEjB,SAAQ,KAAK;GAAE;GAAQ,QAAQ,QAAQ;GAAQ,CAAC;;AAGpD,QAAO,OAAO,OAAO;EACnB,MAAM,OAAO,OAAO,KAAK;EACzB,SAAS,OAAO,OAAO,QAAQ;EAC/B,UAAU,OAAO,OAAO,SAAS;EAClC,CAAC"}

package/dist/errors/index.d.ts

@@ -133,7 +133,7 @@ declare class EmbedderMigrationStateError extends GraphorinMemoryError {
   constructor(message: string);
 }
 /**
- * Raised by {@link SemanticMemory.validate} (P1-4 / MRET-3) when a caller
+ * Raised by `SemanticMemory.validate` (P1-4 / MRET-3) when a caller
  * tries to promote a fact whose quarantine was triggered by the offline
  * injection heuristics. Such a fact is a memory-poisoning candidate: the
  * agent's own `fact_validate` tool must never be able to admit it into
@@ -151,7 +151,7 @@ declare class QuarantinePromotionRefusedError extends GraphorinMemoryError {
   constructor(factId: string, markers: ReadonlyArray<string>);
 }
 /**
- * Raised when {@link ProceduralMemory.induce} (P2-2) is called but no
+ * Raised when `ProceduralMemory.induce` (P2-2) is called but no
  * workflow inducer was configured. Induction abstracts concrete values into
  * variables, which needs a provider - so the capability is opt-in and the
  * default (offline) procedural tier never silently no-ops a requested

package/dist/errors/index.js

@@ -160,7 +160,7 @@ var EmbedderMigrationStateError = class extends GraphorinMemoryError {
 	}
 };
 /**
-* Raised by {@link SemanticMemory.validate} (P1-4 / MRET-3) when a caller
+* Raised by `SemanticMemory.validate` (P1-4 / MRET-3) when a caller
 * tries to promote a fact whose quarantine was triggered by the offline
 * injection heuristics. Such a fact is a memory-poisoning candidate: the
 * agent's own `fact_validate` tool must never be able to admit it into
@@ -182,7 +182,7 @@ var QuarantinePromotionRefusedError = class extends GraphorinMemoryError {
 	}
 };
 /**
-* Raised when {@link ProceduralMemory.induce} (P2-2) is called but no
+* Raised when `ProceduralMemory.induce` (P2-2) is called but no
 * workflow inducer was configured. Induction abstracts concrete values into
 * variables, which needs a provider - so the capability is opt-in and the
 * default (offline) procedural tier never silently no-ops a requested

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/errors/index.ts"],"sourcesContent":["/**\n * Typed error classes raised by `@graphorin/memory`. Every memory\n * subsystem throws one of these instead of plain `Error` so consumers\n * can pattern-match on `kind` and `name` without parsing the message.\n *\n * @packageDocumentation\n */\n\n/**\n * Base class for every error raised by `@graphorin/memory`. Carries a\n * stable lowercase `kind` discriminator and an optional `hint`\n * surfaced to operators (CLI command / docs link to fix the issue).\n *\n * @stable\n */\nexport abstract class GraphorinMemoryError extends Error {\n  /** Stable lowercase discriminator. */\n  abstract readonly kind: string;\n  /** Optional actionable hint surfaced to operators. */\n  readonly hint?: string;\n\n  constructor(message: string, options?: { cause?: unknown; hint?: string }) {\n    super(message, options !== undefined && 'cause' in options ? { cause: options.cause } : {});\n    if (options?.hint !== undefined) {\n      this.hint = options.hint;\n    }\n  }\n}\n\n/**\n * Raised when a memory write would reference an embedder that is not\n * registered in the storage layer's `embedding_meta` registry.\n *\n * @stable\n */\nexport class EmbedderRegistrationError extends GraphorinMemoryError {\n  override readonly name = 'EmbedderRegistrationError';\n  readonly kind = 'embedder-registration' as const;\n  readonly embedderId: string;\n\n  constructor(embedderId: string, options?: { cause?: unknown }) {\n    super(\n      `[graphorin/memory] embedder '${embedderId}' is not registered. ` +\n        'createMemory({ embedder, ... }) registers the configured embedder; ' +\n        'manual writes must reference an already-registered embedder_id.',\n      {\n        ...(options?.cause !== undefined ? { cause: options.cause } : {}),\n        hint: 'Pass `embedder` to createMemory(...) so the registration runs at startup.',\n      },\n    );\n    this.embedderId = embedderId;\n  }\n}\n\n/**\n * Raised when a memory tool is invoked outside the per-tool ACL or the\n * memory-modification guard tier rejects the call.\n *\n * @stable\n */\nexport class MemoryToolDeniedError extends GraphorinMemoryError {\n  override readonly name = 'MemoryToolDeniedError';\n  readonly kind = 'memory-tool-denied' as const;\n  readonly toolName: string;\n  readonly reason: string;\n\n  constructor(toolName: string, reason: string) {\n    super(`[graphorin/memory] memory tool '${toolName}' was denied: ${reason}`, {\n      hint: 'Check the tool authorisation matrix and the memory-modification guard tier policy.',\n    });\n    this.toolName = toolName;\n    this.reason = reason;\n  }\n}\n\n/**\n * Raised by `WorkingMemory` when a write would exceed the declared\n * `charLimit` and the overflow policy is `'reject'`.\n *\n * @stable\n */\nexport class WorkingBlockOverflowError extends GraphorinMemoryError {\n  override readonly name = 'WorkingBlockOverflowError';\n  readonly kind = 'working-block-overflow' as const;\n  readonly label: string;\n  readonly attempted: number;\n  readonly charLimit: number;\n\n  constructor(label: string, attempted: number, charLimit: number) {\n    super(\n      `[graphorin/memory] working block '${label}' overflow: attempted ${attempted} chars, limit is ${charLimit}.`,\n      {\n        hint: \"Switch the block's overflow policy to 'truncate' or shorten the input.\",\n      },\n    );\n    this.label = label;\n    this.attempted = attempted;\n    this.charLimit = charLimit;\n  }\n}\n\n/**\n * Raised by `WorkingMemory.replace(...)` when the supplied unique\n * substring is not present (or appears more than once) in the block\n * value.\n *\n * @stable\n */\nexport class WorkingBlockReplaceMismatchError extends GraphorinMemoryError {\n  override readonly name = 'WorkingBlockReplaceMismatchError';\n  readonly kind = 'working-block-replace-mismatch' as const;\n  readonly label: string;\n  readonly occurrences: number;\n\n  constructor(label: string, occurrences: number) {\n    super(\n      `[graphorin/memory] block_replace on '${label}' expected exactly one occurrence of the unique substring, found ${occurrences}.`,\n      {\n        hint: 'Pass a longer unique substring or use block_rethink to replace the entire value.',\n      },\n    );\n    this.label = label;\n    this.occurrences = occurrences;\n  }\n}\n\n/**\n * Thrown when any mutation targets a block defined with\n * `readOnly: true` (MRET-14). Previously this guard threw\n * `WorkingBlockReplaceMismatchError(label, 0)` - semantically \"your\n * unique substring matched 0 times\", which misled callers that retry\n * replace operations on mismatch.\n *\n * @stable\n */\nexport class WorkingBlockReadOnlyError extends GraphorinMemoryError {\n  override readonly name = 'WorkingBlockReadOnlyError';\n  readonly kind = 'working-block-read-only' as const;\n  readonly label: string;\n\n  constructor(label: string) {\n    super(`[graphorin/memory] block '${label}' is read-only - mutations are not allowed.`, {\n      hint: 'Define the block without readOnly, or write through an operator path that redefines it.',\n    });\n    this.label = label;\n  }\n}\n\n/**\n * Raised by the embedder migration runner when the operator attempts a\n * silent embedder swap under the `lock-on-first` policy.\n *\n * @stable\n */\nexport class EmbedderMigrationLockedError extends GraphorinMemoryError {\n  override readonly name = 'EmbedderMigrationLockedError';\n  readonly kind = 'embedder-migration-locked' as const;\n  readonly source: string;\n  readonly target: string;\n\n  constructor(source: string, target: string) {\n    super(\n      `[graphorin/memory] cannot swap embedder from '${source}' to '${target}' under the 'lock-on-first' policy. ` +\n        'Run `graphorin memory migrate` (Phase 15) or pass `policy: \"auto-migrate\"` / \"multi-active\".',\n      {\n        hint: 'Plan an explicit migration before swapping the active embedder.',\n      },\n    );\n    this.source = source;\n    this.target = target;\n  }\n}\n\n/**\n * Raised by `migrateEmbedder(...)` when the runner is interrupted via\n * `AbortSignal`. The surrounding `for-await` loop receives this error so\n * the operator can re-run the migration. MST-12: there is no persisted\n * cursor today, so a re-run restarts from the beginning.\n *\n * @stable\n */\nexport class EmbedderMigrationAbortedError extends GraphorinMemoryError {\n  override readonly name = 'EmbedderMigrationAbortedError';\n  readonly kind = 'embedder-migration-aborted' as const;\n  readonly migrationId: string;\n\n  constructor(migrationId: string) {\n    super(\n      `[graphorin/memory] embedder migration '${migrationId}' aborted before completion. ` +\n        'Re-run `migrateEmbedder(...)` to restart (there is no persisted cursor yet, so it begins again).',\n      {\n        hint: 'Re-invoke migrateEmbedder(...) to restart the migration.',\n      },\n    );\n    this.migrationId = migrationId;\n  }\n}\n\n/**\n * Raised by the migration runner when the migration references embedders\n * that are no longer registered (e.g. the operator removed the underlying\n * tables manually).\n *\n * @stable\n */\nexport class EmbedderMigrationStateError extends GraphorinMemoryError {\n  override readonly name = 'EmbedderMigrationStateError';\n  readonly kind = 'embedder-migration-state' as const;\n\n  constructor(message: string) {\n    super(`[graphorin/memory] ${message}`, {\n      hint: 'Re-register the source/target embedders (or re-run with the current ones) before retrying.',\n    });\n  }\n}\n\n/**\n * Raised by {@link SemanticMemory.validate} (P1-4 / MRET-3) when a caller\n * tries to promote a fact whose quarantine was triggered by the offline\n * injection heuristics. Such a fact is a memory-poisoning candidate: the\n * agent's own `fact_validate` tool must never be able to admit it into\n * action-driving recall, so promotion is refused unless an operator\n * passes the explicit `force` flag through the programmatic API.\n *\n * @stable\n */\nexport class QuarantinePromotionRefusedError extends GraphorinMemoryError {\n  override readonly name = 'QuarantinePromotionRefusedError';\n  readonly kind = 'quarantine-promotion-refused' as const;\n  readonly factId: string;\n  /** Injection-rule labels that tripped on the fact's text. */\n  readonly markers: ReadonlyArray<string>;\n\n  constructor(factId: string, markers: ReadonlyArray<string>) {\n    super(\n      `[graphorin/memory] refusing to promote fact '${factId}' out of quarantine: ` +\n        `its text trips the injection heuristics (${markers.join(', ')}). ` +\n        'Promotion of an injection-flagged memory is an operator action - ' +\n        'pass `{ force: true }` to validate(...) from a trusted (non-agent) caller after review.',\n      {\n        hint: 'Review the quarantined fact, then promote it with validate(scope, id, reason, { force: true }) from an operator context.',\n      },\n    );\n    this.factId = factId;\n    this.markers = Object.freeze([...markers]);\n  }\n}\n\n/**\n * Raised when {@link ProceduralMemory.induce} (P2-2) is called but no\n * workflow inducer was configured. Induction abstracts concrete values into\n * variables, which needs a provider - so the capability is opt-in and the\n * default (offline) procedural tier never silently no-ops a requested\n * induction.\n *\n * @stable\n */\nexport class ProcedureInductionNotConfiguredError extends GraphorinMemoryError {\n  override readonly name = 'ProcedureInductionNotConfiguredError';\n  readonly kind = 'procedure-induction-not-configured' as const;\n\n  constructor(options?: { cause?: unknown }) {\n    super(\n      '[graphorin/memory] procedure induction requires a provider. ' +\n        'ProceduralMemory.induce(...) needs an inducer to abstract values into ' +\n        'variables; enable it with createMemory({ procedureInduction: { provider } }).',\n      {\n        ...(options?.cause !== undefined ? { cause: options.cause } : {}),\n        hint: 'Pass `procedureInduction: { provider }` to createMemory(...).',\n      },\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/errors/index.ts"],"sourcesContent":["/**\n * Typed error classes raised by `@graphorin/memory`. Every memory\n * subsystem throws one of these instead of plain `Error` so consumers\n * can pattern-match on `kind` and `name` without parsing the message.\n *\n * @packageDocumentation\n */\n\n/**\n * Base class for every error raised by `@graphorin/memory`. Carries a\n * stable lowercase `kind` discriminator and an optional `hint`\n * surfaced to operators (CLI command / docs link to fix the issue).\n *\n * @stable\n */\nexport abstract class GraphorinMemoryError extends Error {\n  /** Stable lowercase discriminator. */\n  abstract readonly kind: string;\n  /** Optional actionable hint surfaced to operators. */\n  readonly hint?: string;\n\n  constructor(message: string, options?: { cause?: unknown; hint?: string }) {\n    super(message, options !== undefined && 'cause' in options ? { cause: options.cause } : {});\n    if (options?.hint !== undefined) {\n      this.hint = options.hint;\n    }\n  }\n}\n\n/**\n * Raised when a memory write would reference an embedder that is not\n * registered in the storage layer's `embedding_meta` registry.\n *\n * @stable\n */\nexport class EmbedderRegistrationError extends GraphorinMemoryError {\n  override readonly name = 'EmbedderRegistrationError';\n  readonly kind = 'embedder-registration' as const;\n  readonly embedderId: string;\n\n  constructor(embedderId: string, options?: { cause?: unknown }) {\n    super(\n      `[graphorin/memory] embedder '${embedderId}' is not registered. ` +\n        'createMemory({ embedder, ... }) registers the configured embedder; ' +\n        'manual writes must reference an already-registered embedder_id.',\n      {\n        ...(options?.cause !== undefined ? { cause: options.cause } : {}),\n        hint: 'Pass `embedder` to createMemory(...) so the registration runs at startup.',\n      },\n    );\n    this.embedderId = embedderId;\n  }\n}\n\n/**\n * Raised when a memory tool is invoked outside the per-tool ACL or the\n * memory-modification guard tier rejects the call.\n *\n * @stable\n */\nexport class MemoryToolDeniedError extends GraphorinMemoryError {\n  override readonly name = 'MemoryToolDeniedError';\n  readonly kind = 'memory-tool-denied' as const;\n  readonly toolName: string;\n  readonly reason: string;\n\n  constructor(toolName: string, reason: string) {\n    super(`[graphorin/memory] memory tool '${toolName}' was denied: ${reason}`, {\n      hint: 'Check the tool authorisation matrix and the memory-modification guard tier policy.',\n    });\n    this.toolName = toolName;\n    this.reason = reason;\n  }\n}\n\n/**\n * Raised by `WorkingMemory` when a write would exceed the declared\n * `charLimit` and the overflow policy is `'reject'`.\n *\n * @stable\n */\nexport class WorkingBlockOverflowError extends GraphorinMemoryError {\n  override readonly name = 'WorkingBlockOverflowError';\n  readonly kind = 'working-block-overflow' as const;\n  readonly label: string;\n  readonly attempted: number;\n  readonly charLimit: number;\n\n  constructor(label: string, attempted: number, charLimit: number) {\n    super(\n      `[graphorin/memory] working block '${label}' overflow: attempted ${attempted} chars, limit is ${charLimit}.`,\n      {\n        hint: \"Switch the block's overflow policy to 'truncate' or shorten the input.\",\n      },\n    );\n    this.label = label;\n    this.attempted = attempted;\n    this.charLimit = charLimit;\n  }\n}\n\n/**\n * Raised by `WorkingMemory.replace(...)` when the supplied unique\n * substring is not present (or appears more than once) in the block\n * value.\n *\n * @stable\n */\nexport class WorkingBlockReplaceMismatchError extends GraphorinMemoryError {\n  override readonly name = 'WorkingBlockReplaceMismatchError';\n  readonly kind = 'working-block-replace-mismatch' as const;\n  readonly label: string;\n  readonly occurrences: number;\n\n  constructor(label: string, occurrences: number) {\n    super(\n      `[graphorin/memory] block_replace on '${label}' expected exactly one occurrence of the unique substring, found ${occurrences}.`,\n      {\n        hint: 'Pass a longer unique substring or use block_rethink to replace the entire value.',\n      },\n    );\n    this.label = label;\n    this.occurrences = occurrences;\n  }\n}\n\n/**\n * Thrown when any mutation targets a block defined with\n * `readOnly: true` (MRET-14). Previously this guard threw\n * `WorkingBlockReplaceMismatchError(label, 0)` - semantically \"your\n * unique substring matched 0 times\", which misled callers that retry\n * replace operations on mismatch.\n *\n * @stable\n */\nexport class WorkingBlockReadOnlyError extends GraphorinMemoryError {\n  override readonly name = 'WorkingBlockReadOnlyError';\n  readonly kind = 'working-block-read-only' as const;\n  readonly label: string;\n\n  constructor(label: string) {\n    super(`[graphorin/memory] block '${label}' is read-only - mutations are not allowed.`, {\n      hint: 'Define the block without readOnly, or write through an operator path that redefines it.',\n    });\n    this.label = label;\n  }\n}\n\n/**\n * Raised by the embedder migration runner when the operator attempts a\n * silent embedder swap under the `lock-on-first` policy.\n *\n * @stable\n */\nexport class EmbedderMigrationLockedError extends GraphorinMemoryError {\n  override readonly name = 'EmbedderMigrationLockedError';\n  readonly kind = 'embedder-migration-locked' as const;\n  readonly source: string;\n  readonly target: string;\n\n  constructor(source: string, target: string) {\n    super(\n      `[graphorin/memory] cannot swap embedder from '${source}' to '${target}' under the 'lock-on-first' policy. ` +\n        'Run `graphorin memory migrate` (Phase 15) or pass `policy: \"auto-migrate\"` / \"multi-active\".',\n      {\n        hint: 'Plan an explicit migration before swapping the active embedder.',\n      },\n    );\n    this.source = source;\n    this.target = target;\n  }\n}\n\n/**\n * Raised by `migrateEmbedder(...)` when the runner is interrupted via\n * `AbortSignal`. The surrounding `for-await` loop receives this error so\n * the operator can re-run the migration. MST-12: there is no persisted\n * cursor today, so a re-run restarts from the beginning.\n *\n * @stable\n */\nexport class EmbedderMigrationAbortedError extends GraphorinMemoryError {\n  override readonly name = 'EmbedderMigrationAbortedError';\n  readonly kind = 'embedder-migration-aborted' as const;\n  readonly migrationId: string;\n\n  constructor(migrationId: string) {\n    super(\n      `[graphorin/memory] embedder migration '${migrationId}' aborted before completion. ` +\n        'Re-run `migrateEmbedder(...)` to restart (there is no persisted cursor yet, so it begins again).',\n      {\n        hint: 'Re-invoke migrateEmbedder(...) to restart the migration.',\n      },\n    );\n    this.migrationId = migrationId;\n  }\n}\n\n/**\n * Raised by the migration runner when the migration references embedders\n * that are no longer registered (e.g. the operator removed the underlying\n * tables manually).\n *\n * @stable\n */\nexport class EmbedderMigrationStateError extends GraphorinMemoryError {\n  override readonly name = 'EmbedderMigrationStateError';\n  readonly kind = 'embedder-migration-state' as const;\n\n  constructor(message: string) {\n    super(`[graphorin/memory] ${message}`, {\n      hint: 'Re-register the source/target embedders (or re-run with the current ones) before retrying.',\n    });\n  }\n}\n\n/**\n * Raised by `SemanticMemory.validate` (P1-4 / MRET-3) when a caller\n * tries to promote a fact whose quarantine was triggered by the offline\n * injection heuristics. Such a fact is a memory-poisoning candidate: the\n * agent's own `fact_validate` tool must never be able to admit it into\n * action-driving recall, so promotion is refused unless an operator\n * passes the explicit `force` flag through the programmatic API.\n *\n * @stable\n */\nexport class QuarantinePromotionRefusedError extends GraphorinMemoryError {\n  override readonly name = 'QuarantinePromotionRefusedError';\n  readonly kind = 'quarantine-promotion-refused' as const;\n  readonly factId: string;\n  /** Injection-rule labels that tripped on the fact's text. */\n  readonly markers: ReadonlyArray<string>;\n\n  constructor(factId: string, markers: ReadonlyArray<string>) {\n    super(\n      `[graphorin/memory] refusing to promote fact '${factId}' out of quarantine: ` +\n        `its text trips the injection heuristics (${markers.join(', ')}). ` +\n        'Promotion of an injection-flagged memory is an operator action - ' +\n        'pass `{ force: true }` to validate(...) from a trusted (non-agent) caller after review.',\n      {\n        hint: 'Review the quarantined fact, then promote it with validate(scope, id, reason, { force: true }) from an operator context.',\n      },\n    );\n    this.factId = factId;\n    this.markers = Object.freeze([...markers]);\n  }\n}\n\n/**\n * Raised when `ProceduralMemory.induce` (P2-2) is called but no\n * workflow inducer was configured. Induction abstracts concrete values into\n * variables, which needs a provider - so the capability is opt-in and the\n * default (offline) procedural tier never silently no-ops a requested\n * induction.\n *\n * @stable\n */\nexport class ProcedureInductionNotConfiguredError extends GraphorinMemoryError {\n  override readonly name = 'ProcedureInductionNotConfiguredError';\n  readonly kind = 'procedure-induction-not-configured' as const;\n\n  constructor(options?: { cause?: unknown }) {\n    super(\n      '[graphorin/memory] procedure induction requires a provider. ' +\n        'ProceduralMemory.induce(...) needs an inducer to abstract values into ' +\n        'variables; enable it with createMemory({ procedureInduction: { provider } }).',\n      {\n        ...(options?.cause !== undefined ? { cause: options.cause } : {}),\n        hint: 'Pass `procedureInduction: { provider }` to createMemory(...).',\n      },\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/facade.d.ts

@@ -1,25 +1,20 @@
 import { EmbeddingMetaRegistryLike, MemoryStoreAdapter } from "./internal/storage-adapter.js";
-import { ConflictPipeline, ConflictPipelineOptions } from "./conflict/types.js";
+import { ConflictPipelineOptions } from "./conflict/types.js";
 import "./conflict/index.js";
 import { ContextualRetrievalMode } from "./internal/contextualize.js";
-import { EpisodicMemory } from "./tiers/episodic-memory.js";
 import { SalienceWeights } from "./consolidator/decay.js";
 import { EntityResolutionConfig } from "./graph/entity-resolver.js";
 import { ReRanker } from "./search/types.js";
-import { SemanticMemory } from "./tiers/semantic-memory.js";
-import { BlockDefinition, WorkingMemory } from "./tiers/working-memory.js";
+import { SemanticSearchDefaults } from "./tiers/semantic-memory.js";
+import { BlockDefinition } from "./tiers/working-memory.js";
 import { ConsolidatorCeilings, ConsolidatorPhase, ConsolidatorTier, ConsolidatorTriggerSpec, OnBudgetExceed, PhaseListener } from "./consolidator/types.js";
-import { Consolidator } from "./consolidator/runtime.js";
 import "./consolidator/index.js";
-import { ContextEngine, ContextEngineConfig } from "./context-engine/engine.js";
-import { CompileOptions, CompileScope, MemoryContextBlocks } from "./context-engine/index.js";
-import { InsightMemory } from "./tiers/insight-memory.js";
-import { ProceduralMemory } from "./tiers/procedural-memory.js";
-import { SessionMemory } from "./tiers/session-memory.js";
-import { SharedMemory } from "./tiers/shared-memory.js";
+import { Memory } from "./memory-interface.js";
+import { ContextEngineConfig } from "./context-engine/engine.js";
+import "./context-engine/index.js";
 import { ScopeResolver } from "./tools/types.js";
 import "./tools/index.js";
-import { EmbedderProvider, MemoryMetadata, Provider, SessionScope, Tool, Tracer } from "@graphorin/core";
+import { EmbedderProvider, Provider, SessionScope, Tracer } from "@graphorin/core";
 
 //#region src/facade.d.ts
 
@@ -45,6 +40,23 @@ interface CreateMemoryOptions {
   readonly tracer?: Tracer;
   /** Override the reranker used by `SemanticMemory.search`. */
   readonly reranker?: ReRanker;
+  /**
+   * Construction-time retrieval defaults (W-086) merged under every
+   * `SemanticMemory.search(...)` call, per-call options winning
+   * key-by-key. This is how the advanced retrieval stack (multi-query
+   * fan-out, HyDE, graph expansion, entity matching, weighted fusion,
+   * decay ranking) reaches the model-facing surfaces - `fact_search`,
+   * auto-recall and `deep_recall` all funnel through `search()` and
+   * inherit these without custom tools. Deliberately excludes the
+   * trust-sensitive predicates (`includeQuarantined`,
+   * `includeSuperseded`, `trustWeighting`, `owner`) so configuration
+   * cannot silently weaken trust gates. The fan-out switches only take
+   * effect when their backing dependency is configured (`queryTransform`
+   * for `multiQuery`/`hyde`, `graph` for `expandHops`/`entityMatch`) -
+   * and they add provider latency and cost to EVERY recall, including
+   * auto-recall, so opt in deliberately.
+   */
+  readonly searchDefaults?: SemanticSearchDefaults;
   /**
    * Contextual-retrieval mode for the write path (P1-3). `'late-chunk'`
    * (default) prepends a deterministic, offline situating context
@@ -111,13 +123,21 @@ interface CreateMemoryOptions {
     readonly maxIterations?: number;
     /** Output-token ceiling per grade call. Default 256. */
     readonly maxTokens?: number;
+    /**
+     * Default difficulty-gate threshold in `[0, 1]` (W-088). The gate's
+     * signal lexicon is **English-only**: on non-English deployments the
+     * auto-gate never fires, so either lower this threshold or rely on
+     * `forceHard` (`deep_recall` already forces the loop). Omitted ⇒ the
+     * built-in `0.5`; per-call `difficultyThreshold` overrides it.
+     */
+    readonly difficultyThreshold?: number;
   };
   /**
    * Opt-in workflow induction (P2-2). When set, `ProceduralMemory.induce(...)`
    * distils a reusable, value-abstracted procedure from a successful agent
    * trajectory and stores it **quarantined** + `provenance: 'induction'`.
    * Omitted (the default) ⇒ `induce(...)` throws
-   * {@link ProcedureInductionNotConfiguredError} and the procedural tier
+   * `ProcedureInductionNotConfiguredError` and the procedural tier
    * stays pure offline CRUD - no provider call.
    */
   readonly procedureInduction?: {
@@ -195,6 +215,13 @@ interface CreateMemoryOptions {
     /** Weights for the multi-signal salience score (X-1). */
     readonly salienceWeights?: SalienceWeights;
     readonly maxStandardBatchSize?: number;
+    /**
+     * Input transcript budget for one standard-phase slice, in
+     * characters (W-081). Over-budget batches are half-split before the
+     * provider call; a lone over-budget message is tail-truncated.
+     * Per-tier default (60k chars ~ 15k tokens; 120k on `full`).
+     */
+    readonly maxTranscriptChars?: number;
     readonly maxDeepConflictsPerRun?: number;
     readonly dlqMaxRetries?: number;
     readonly dlqBaseBackoffMs?: number;
@@ -211,6 +238,8 @@ interface CreateMemoryOptions {
     readonly importanceThreshold?: number;
     /** Upper bound on salient questions reflection asks per pass (P1-1). */
     readonly reflectionMaxQuestions?: number;
+    /** Override the quarantined-insight queue cap (W-082). Default 100. */
+    readonly reflectionMaxQuarantinedInsights?: number;
     /**
      * Contextual retrieval for standard-phase fact writes (P1-3).
      * `'llm'` opts into one budgeted cheap-model call per write to author
@@ -255,44 +284,6 @@ interface CreateMemoryOptions {
    */
   readonly contextEngine?: ContextEngineConfig;
 }
-/**
- * The facade returned by {@link createMemory}.
- *
- * @stable
- */
-interface Memory {
-  readonly working: WorkingMemory;
-  readonly session: SessionMemory;
-  readonly episodic: EpisodicMemory;
-  readonly semantic: SemanticMemory;
-  readonly procedural: ProceduralMemory;
-  readonly shared: SharedMemory;
-  /**
-   * Read surface over reflection insights (P1-1). A no-op (returns
-   * empty) when the storage adapter does not expose the optional
-   * insight surface.
-   */
-  readonly insights: InsightMemory;
-  readonly tools: ReadonlyArray<Tool>;
-  readonly consolidator: Consolidator;
-  /** The configured conflict pipeline. Surfaced for tests + CLI tooling. */
-  readonly conflictPipeline: ConflictPipeline;
-  /** The configured context engine (Phase 10d). */
-  readonly contextEngine: ContextEngine;
-  /** The active embedder, when configured. `null` otherwise. */
-  readonly embedder: EmbedderProvider | null;
-  /** The canonical id of the active embedder, when configured. */
-  embedderId(): string | null;
-  /**
-   * Compile a system-prompt block bundle. The bundle carries the
-   * static fragments per memory tier; the agent runtime consumes
-   * the {@link ContextEngine} surface (`memory.contextEngine`)
-   * directly for the full six-layer assembly.
-   */
-  compile(scope: CompileScope, options?: CompileOptions): Promise<MemoryContextBlocks>;
-  /** Counter snapshot consumed by Phase 10d's metadata layer. */
-  metadata(scope: SessionScope): Promise<MemoryMetadata>;
-}
 /**
  * Wire every memory subsystem in one call. Returns the typed
  * `Memory` facade ready to be passed into `createAgent({...})`.
@@ -303,5 +294,5 @@ declare function createMemory(options: CreateMemoryOptions): Memory;
 /** @internal - test seam for the one-time disabled-config warning. */
 declare function _resetConsolidatorConfigWarningForTesting(): void;
 //#endregion
-export { CreateMemoryOptions, Memory, _resetConsolidatorConfigWarningForTesting, createMemory };
+export { CreateMemoryOptions, type Memory, _resetConsolidatorConfigWarningForTesting, createMemory };
 //# sourceMappingURL=facade.d.ts.map

package/dist/facade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facade.d.ts","names":[],"sources":["../src/facade.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAuEA;;;;;AAQ2B,UARV,mBAAA,CAQU;EAMP;EAEE,SAAA,KAAA,EAdJ,kBAcI;EAyBC;EAiBJ,SAAA,UAAA,EAtDI,yBAsDJ;EAIK;EAgBD,SAAA,QAAA,CAAA,EAxED,gBAwEC;EAgBA;EAiCG,SAAA,aAAA,CAAA,EAvHC,aAuHD,CAvHe,eAuHf,CAAA;EAYY;;;;;EAGN,SAAA,MAAA,CAAA,EAhIZ,MAgIY;EAAR;EACA,SAAA,QAAA,CAAA,EA/HF,QA+HE;EAOK;;;;;;;;;;EAwEiB,SAAA,mBAAA,CAAA,EAAA,KAAA,GAAA,YAAA;EAQ7B;;;;;;;;;;;EAgBY,SAAA,cAAA,CAAA,EAAA;IAEH;IAEL,SAAA,QAAA,EAjNE,QAiNF;IASJ;IAAwB,SAAA,WAAA,CAAA,EAAA,MAAA;IAAyB;IAAR,SAAA,SAAA,CAAA,EAAA,MAAA;EAExC,CAAA;EAAuB;;;AASzC;AAwXA;;;;;;;mBA5kBmB;;;;wBAIK;;;;;;;;;;;;;;;;uBAgBD;;;;;;;;;;;;;;;;uBAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAiCG;;;;;;;;;;;;wBAYF,cAAc;oBAClB;sBACE,cAAc;wBACZ,QAAQ;wBACR;;;;;;;;;;6BAOK;;4BAED;;;4BAGA;;;;;;;+BAOG;;;;;;;;;;;;;;;;;;;;;;;;mCAwBI;;;;;;;;;;;;4BAYP;wBACJ;;;;;;+BAMO;;;;;;;;8BAQD;;;;;;;;;2BASH;;;;;;;UAQV,MAAA;oBACG;oBACA;qBACC;qBACA;uBACE;mBACJ;;;;;;qBAME;kBACH,cAAc;yBACP;;6BAEI;;0BAEH;;qBAEL;;;;;;;;;iBASJ,wBAAwB,iBAAiB,QAAQ;;kBAEhD,eAAe,QAAQ;;;;;;;;iBASzB,YAAA,UAAsB,sBAAsB;;iBAwX5C,yCAAA,CAAA"}
+{"version":3,"file":"facade.d.ts","names":[],"sources":["../src/facade.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAiFoB,UAdH,mBAAA,CAcG;EAEE;EAiBM,SAAA,KAAA,EA/BV,kBA+BU;EAyBL;EAiBJ,SAAA,UAAA,EAvEI,yBAuEJ;EAIK;EAgBD,SAAA,QAAA,CAAA,EAzFD,gBAyFC;EAwBA;EAiCG,SAAA,aAAA,CAAA,EAhJC,aAgJD,CAhJe,eAgJf,CAAA;EAYY;;;;;EAGN,SAAA,MAAA,CAAA,EAzJZ,MAyJY;EAAR;EACA,SAAA,QAAA,CAAA,EAxJF,QAwJE;EAOK;;;;;;;;;;;AAiG7B;AAmYA;;;;4BAlnB4B;;;;;;;;;;;;;;;;;;;;;;;;;uBAyBL;;;;;;;;;;;;;;;;;mBAiBJ;;;;wBAIK;;;;;;;;;;;;;;;;uBAgBD;;;;;;;;;;;;;;;;;;;;;;;;uBAwBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAiCG;;;;;;;;;;;;wBAYF,cAAc;oBAClB;sBACE,cAAc;wBACZ,QAAQ;wBACR;;;;;;;;;;6BAOK;;4BAED;;;4BAGA;;;;;;;+BAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAiCI;;;;;;;;;;;;4BAYP;wBACJ;;;;;;+BAMO;;;;;;;;8BAQD;;;;;;;;;2BASH;;;;;;;;iBAgBX,YAAA,UAAsB,sBAAsB;;iBAmY5C,yCAAA,CAAA"}

package/dist/facade.js

@@ -1,11 +1,9 @@
 import { createConflictPipeline } from "./conflict/pipeline.js";
-import "./conflict/index.js";
 import { createProviderWorkflowInducer } from "./consolidator/phases/induce.js";
 import { WorkingMemory } from "./tiers/working-memory.js";
 import { createConsolidator } from "./consolidator/runtime.js";
 import { createConsolidatorPlaceholder } from "./consolidator/index.js";
 import { enLocalePack } from "./context-engine/locale-packs/en.js";
-import "./context-engine/locale-packs/index.js";
 import { resolveLocalePack } from "./context-engine/locale-packs/resolver.js";
 import { gatherMemoryMetadata, renderMetadataBlock } from "./context-engine/metadata.js";
 import { partition } from "./context-engine/privacy-filter.js";
@@ -87,7 +85,9 @@ function createMemory(options) {
 		...entityResolver !== null ? { entityResolver } : {},
 		...grader !== null ? { grader } : {},
 		...options.iterativeRetrieval?.maxIterations !== void 0 ? { iterativeMaxIterations: options.iterativeRetrieval.maxIterations } : {},
-		...options.consolidator?.salienceWeights !== void 0 ? { trustWeights: options.consolidator.salienceWeights } : {}
+		...options.iterativeRetrieval?.difficultyThreshold !== void 0 ? { iterativeDifficultyThreshold: options.iterativeRetrieval.difficultyThreshold } : {},
+		...options.consolidator?.salienceWeights !== void 0 ? { trustWeights: options.consolidator.salienceWeights } : {},
+		...options.searchDefaults !== void 0 ? { searchDefaults: options.searchDefaults } : {}
 	});
 	let consolidatorForSpend = null;
 	const inducer = options.procedureInduction !== void 0 ? createProviderWorkflowInducer(options.procedureInduction.provider, {
@@ -232,6 +232,7 @@ function buildConsolidator(opts, store, semantic, episodic, working, tracer) {
 		...opts.decayCapacity !== void 0 ? { decayCapacity: opts.decayCapacity } : {},
 		...opts.salienceWeights !== void 0 ? { salienceWeights: opts.salienceWeights } : {},
 		...opts.maxStandardBatchSize !== void 0 ? { maxStandardBatchSize: opts.maxStandardBatchSize } : {},
+		...opts.maxTranscriptChars !== void 0 ? { maxTranscriptChars: opts.maxTranscriptChars } : {},
 		...opts.maxDeepConflictsPerRun !== void 0 ? { maxDeepConflictsPerRun: opts.maxDeepConflictsPerRun } : {},
 		...opts.dlqMaxRetries !== void 0 ? { dlqMaxRetries: opts.dlqMaxRetries } : {},
 		...opts.dlqBaseBackoffMs !== void 0 ? { dlqBaseBackoffMs: opts.dlqBaseBackoffMs } : {},
@@ -242,6 +243,7 @@ function buildConsolidator(opts, store, semantic, episodic, working, tracer) {
 		...opts.reflection !== void 0 ? { reflection: opts.reflection } : {},
 		...opts.importanceThreshold !== void 0 ? { importanceThreshold: opts.importanceThreshold } : {},
 		...opts.reflectionMaxQuestions !== void 0 ? { reflectionMaxQuestions: opts.reflectionMaxQuestions } : {},
+		...opts.reflectionMaxQuarantinedInsights !== void 0 ? { reflectionMaxQuarantinedInsights: opts.reflectionMaxQuarantinedInsights } : {},
 		...opts.contextualRetrieval !== void 0 ? { contextualRetrieval: opts.contextualRetrieval } : {},
 		...opts.learnedContext !== void 0 ? { learnedContext: opts.learnedContext } : {},
 		...opts.learnedContextMaxChars !== void 0 ? { learnedContextMaxChars: opts.learnedContextMaxChars } : {},

package/dist/facade.js.map

@@ -1 +1 @@
-{"version":3,"file":"facade.js","names":["reranker: ReRanker","resolveScope: ScopeResolver","activeEmbedderId: string | null","consolidatorForSpend: Consolidator | null","consolidator: Consolidator","contextEngine: ContextEngine","out: { -readonly [K in keyof MemoryContextBlocks]: MemoryContextBlocks[K] }","blocksKept: ReadonlyArray<(typeof blocks)[number]>","rulesKept: ReadonlyArray<(typeof rules)[number]>","filterContext: Parameters<typeof partitionBySensitivity>[1]","partitionBySensitivity"],"sources":["../src/facade.ts"],"sourcesContent":["/**\n * `createMemory()` - the facade that wires every tier sub-module (the\n * seven-tier system) + the eleven (+1 gated) memory tools + the search\n * reranker + the context engine\n * stubs + the consolidator placeholder.\n *\n * @packageDocumentation\n */\n\nimport type {\n  EmbedderProvider,\n  MemoryMetadata,\n  Provider,\n  SessionScope,\n  Tool,\n  Tracer,\n} from '@graphorin/core';\nimport { NOOP_TRACER } from '@graphorin/core';\nimport {\n  type ConflictPipeline,\n  type ConflictPipelineOptions,\n  createConflictPipeline,\n} from './conflict/index.js';\nimport {\n  type Consolidator,\n  type ConsolidatorCeilings,\n  type ConsolidatorPhase,\n  type ConsolidatorTier,\n  type ConsolidatorTriggerSpec,\n  createConsolidator,\n  createConsolidatorPlaceholder,\n  createProviderWorkflowInducer,\n  type OnBudgetExceed,\n  type PhaseListener,\n  type SalienceWeights,\n} from './consolidator/index.js';\nimport { createContextEngine } from './context-engine/engine.js';\nimport type {\n  CompileOptions,\n  CompileScope,\n  ContextEngine,\n  ContextEngineConfig,\n  MemoryContextBlocks,\n} from './context-engine/index.js';\nimport { enLocalePack } from './context-engine/locale-packs/index.js';\nimport { resolveLocalePack } from './context-engine/locale-packs/resolver.js';\nimport { gatherMemoryMetadata, renderMetadataBlock } from './context-engine/metadata.js';\nimport { partition as partitionBySensitivity } from './context-engine/privacy-filter.js';\nimport { composeLayer1 } from './context-engine/templates/composer.js';\nimport { type EntityResolutionConfig, EntityResolver } from './graph/entity-resolver.js';\nimport type { ContextualRetrievalMode } from './internal/contextualize.js';\nimport { bindEmbedder } from './internal/embedder-binding.js';\nimport type { EmbeddingMetaRegistryLike, MemoryStoreAdapter } from './internal/storage-adapter.js';\nimport { createProviderRetrievalGrader } from './search/iterative.js';\nimport { createProviderQueryTransformer } from './search/query-transform.js';\nimport { RRFReranker } from './search/rrf.js';\nimport type { ReRanker } from './search/types.js';\nimport { EpisodicMemory } from './tiers/episodic-memory.js';\nimport { InsightMemory } from './tiers/insight-memory.js';\nimport { ProceduralMemory } from './tiers/procedural-memory.js';\nimport { SemanticMemory } from './tiers/semantic-memory.js';\nimport { SessionMemory } from './tiers/session-memory.js';\nimport { SharedMemory } from './tiers/shared-memory.js';\nimport { type BlockDefinition, WorkingMemory } from './tiers/working-memory.js';\nimport { buildMemoryTools, type ScopeResolver } from './tools/index.js';\n\n/**\n * Options accepted by {@link createMemory}.\n *\n * @stable\n */\nexport interface CreateMemoryOptions {\n  /** Storage adapter (default: `@graphorin/store-sqlite`'s `MemoryStore`). */\n  readonly store: MemoryStoreAdapter;\n  /** Embedder registry. The default sqlite store exposes one as `sqlite.embeddings`. */\n  readonly embeddings: EmbeddingMetaRegistryLike;\n  /** Embedder provider (default: none - vector search is disabled). */\n  readonly embedder?: EmbedderProvider;\n  /** Pre-declared working blocks (idempotent - re-defining is a no-op). */\n  readonly workingBlocks?: ReadonlyArray<BlockDefinition>;\n  /**\n   * Tracer used for every `memory.*` span. Defaults to the no-op\n   * tracer from `@graphorin/core` so unit tests do not need to wire\n   * the observability stack.\n   */\n  readonly tracer?: Tracer;\n  /** Override the reranker used by `SemanticMemory.search`. */\n  readonly reranker?: ReRanker;\n  /**\n   * Contextual-retrieval mode for the write path (P1-3). `'late-chunk'`\n   * (default) prepends a deterministic, offline situating context\n   * (entities / timeframe / topics, derived from the fact's own\n   * structured fields) to the text that is embedded + FTS-indexed, so a\n   * terse fact stays findable; the canonical `text` is preserved. `'off'`\n   * indexes the bare text. The `'llm'` enrichment is **not** available on\n   * the hot path - it is a consolidator-only opt-in configured via\n   * `consolidator: { contextualRetrieval: 'llm' }`.\n   */\n  readonly contextualRetrieval?: 'off' | 'late-chunk';\n  /**\n   * Query transformation for retrieval (P2-3, opt-in). When supplied,\n   * `SemanticMemory.search(..., { multiQuery })` fans the query into\n   * reworded variants (multi-query / RAG-Fusion) and `{ hyde }` adds a\n   * hypothetical-answer embedding - both via one cheap LLM call on the\n   * given provider, fused through the existing RRF reranker. Omitted (the\n   * default) ⇒ search stays **offline + single-shot** and the\n   * `multiQuery` / `hyde` search options become silent no-ops. Reserve it\n   * for retrieval-heavy recall, not every search (it adds provider\n   * latency).\n   */\n  readonly queryTransform?: {\n    /** Cheap provider used to rewrite the query / write the HyDE passage. */\n    readonly provider: Provider;\n    /** Hard ceiling on reworded variants requested per call. Default 5. */\n    readonly maxVariants?: number;\n    /** Output-token ceiling per transform call. Default 256. */\n    readonly maxTokens?: number;\n  };\n  /**\n   * Relation-graph entity resolution (P2-1). When `entityResolution` is\n   * `true` **and** the storage adapter exposes a `graph` surface (the\n   * default `@graphorin/store-sqlite` does), `remember(...)` resolves a\n   * fact's subject / object to canonical entities and links them, so\n   * `search(..., { expandHops: 1 })` can traverse relationships. Omitted\n   * (the default) ⇒ facts still carry s/p/o but form no entity links and\n   * the write path stays offline + unchanged. Dedup is lexical +\n   * embedding (offline, via the configured embedder); LLM adjudication of\n   * ambiguous merges is a further opt-in that needs `provider`.\n   */\n  readonly graph?: EntityResolutionConfig & {\n    /** Enable entity resolution + linking on write. Default `false`. */\n    readonly entityResolution?: boolean;\n    /** Provider for opt-in LLM adjudication of ambiguous merges. */\n    readonly provider?: Provider;\n  };\n  /**\n   * Agentic / iterative retrieval (P2-4, opt-in). When supplied,\n   * `SemanticMemory.searchIterative(...)` and the gated `deep_recall`\n   * tool can grade a retrieved set on the given provider and, for queries\n   * judged hard, reformulate + retrieve again (widening to one-hop graph\n   * expansion) up to `maxIterations`, abstaining instead of confabulating\n   * when memory is insufficient. Omitted (the default) ⇒ `searchIterative`\n   * stays a single difficulty-gated pass with **no provider call**, and\n   * `deep_recall` is **not** registered (the tool surface stays at the\n   * canonical eleven). Reserve it for hard multi-hop / temporal recall -\n   * it adds provider latency per pass.\n   */\n  readonly iterativeRetrieval?: {\n    /** Cheap provider used to grade retrieved memories + reformulate. */\n    readonly provider: Provider;\n    /** Default total-pass cap (clamped to `[1, 5]`). Default 3. */\n    readonly maxIterations?: number;\n    /** Output-token ceiling per grade call. Default 256. */\n    readonly maxTokens?: number;\n  };\n  /**\n   * Opt-in workflow induction (P2-2). When set, `ProceduralMemory.induce(...)`\n   * distils a reusable, value-abstracted procedure from a successful agent\n   * trajectory and stores it **quarantined** + `provenance: 'induction'`.\n   * Omitted (the default) ⇒ `induce(...)` throws\n   * {@link ProcedureInductionNotConfiguredError} and the procedural tier\n   * stays pure offline CRUD - no provider call.\n   */\n  readonly procedureInduction?: {\n    /** Provider used to abstract trajectory values into a procedure. */\n    readonly provider: Provider;\n    /** Output-token ceiling per induction call. Default 512. */\n    readonly maxTokens?: number;\n  };\n  /**\n   * Promotion-by-demonstrated-success for quarantined induced\n   * procedures (MCON-2 part 4). Fully offline - orthogonal to\n   * `procedureInduction` (no provider needed). When configured,\n   * `procedural.recordOutcome(scope, id, true)` increments the rule's\n   * persistent success counter and promotes it into `activate()` once\n   * `afterSuccesses` verified reuses accumulate; the injection gate\n   * still refuses flagged texts. Omitted ⇒ outcomes are counted but\n   * nothing auto-promotes.\n   */\n  readonly procedurePromotion?: {\n    /** Successful demonstrated reuses required before promotion (≥ 1). */\n    readonly afterSuccesses: number;\n  };\n  /**\n   * Register the gated `runbook_search` tool (D3) so the model can look\n   * up validated procedures by task description (content recall over\n   * procedural memory, returning whole runbooks). Fully offline - the\n   * default `@graphorin/store-sqlite` adapter serves it from the rules\n   * FTS index (migration 028); adapters without the index degrade to an\n   * in-memory lexical scan. Default `false` - the tool surface stays at\n   * the canonical eleven.\n   */\n  readonly runbookSearch?: boolean;\n  /**\n   * Resolver that produces the live {@link SessionScope} for each\n   * memory-tool invocation. Defaults to a closure that throws - the\n   * agent runtime overrides it in Phase 12.\n   */\n  readonly resolveScope?: ScopeResolver;\n  /**\n   * Consolidator configuration. When omitted, empty, or\n   * `enabled: false`, the facade installs the Phase 10a no-op\n   * placeholder so consumers can still type their interactions without\n   * paying the runtime cost. ANY other setting - including offline\n   * knobs like `decayCapacity` or `contextualRetrieval` - implicitly\n   * enables the production runtime (MST-4); `enabled: false` together\n   * with other settings warns once and keeps the placeholder.\n   */\n  readonly consolidator?: {\n    readonly enabled?: boolean;\n    readonly triggers?: ReadonlyArray<ConsolidatorTriggerSpec>;\n    readonly tier?: ConsolidatorTier;\n    readonly phases?: ReadonlyArray<ConsolidatorPhase>;\n    readonly ceilings?: Partial<ConsolidatorCeilings>;\n    readonly onExceed?: OnBudgetExceed;\n    /**\n     * USD pricer for phase LLM usage (memory-consolidation-02) - wire\n     * to `@graphorin/pricing` so `maxCostPerDay` can actually trip.\n     */\n    readonly priceUsage?: (usage: { promptTokens: number; completionTokens: number }) => number;\n    /** Provider routed to the standard phase when set (MCON-7); falls back to `provider`. */\n    readonly cheapProvider?: Provider | null;\n    /** Provider routed to the deep + reflection passes when set (MCON-7). */\n    readonly deepProvider?: Provider | null;\n    readonly cheapModel?: string | null;\n    readonly deepModel?: string | null;\n    readonly noiseFilters?: ReadonlyArray<'default' | 'minimal' | 'none'>;\n    readonly lockWaitMs?: number;\n    readonly decayTauDays?: number;\n    readonly decayArchiveThreshold?: number;\n    /** Capacity-bounded eviction target for the light phase (X-1). Default unbounded. */\n    readonly decayCapacity?: number | null;\n    /** Weights for the multi-signal salience score (X-1). */\n    readonly salienceWeights?: SalienceWeights;\n    readonly maxStandardBatchSize?: number;\n    readonly maxDeepConflictsPerRun?: number;\n    readonly dlqMaxRetries?: number;\n    readonly dlqBaseBackoffMs?: number;\n    readonly dlqMaxBackoffMs?: number;\n    /** Auto-form quarantined episodes from processed slices (P1-2). Per-tier default. */\n    readonly formEpisodes?: boolean;\n    /** Score episode importance via the consolidator LLM (P1-2). Per-tier default. */\n    readonly importanceScoring?: boolean;\n    /** Opt in to auto-promotion of injection-clean extraction facts (MCON-2). Default off. */\n    readonly autoPromoteExtraction?: boolean;\n    /** Run the deep-phase reflection pass synthesizing cited insights (P1-1). Per-tier default. */\n    readonly reflection?: boolean;\n    /** Accumulated-importance threshold at which reflection fires (P1-1). */\n    readonly importanceThreshold?: number;\n    /** Upper bound on salient questions reflection asks per pass (P1-1). */\n    readonly reflectionMaxQuestions?: number;\n    /**\n     * Contextual retrieval for standard-phase fact writes (P1-3).\n     * `'llm'` opts into one budgeted cheap-model call per write to author\n     * a situating prefix (consolidator-only); `'late-chunk'` (default)\n     * and `'off'` defer to the write-path mode. Per-tier default.\n     */\n    readonly contextualRetrieval?: ContextualRetrievalMode;\n    /**\n     * Maintain the learned-context digest block (D3): after each deep\n     * phase, one budgeted LLM call rewrites the reserved\n     * `learned_context` working block (previous digest + recent\n     * episodes / active insights / procedures), so the assembled system\n     * prompt carries a compact standing summary. Default `false` at\n     * every tier (Wave-D trial).\n     */\n    readonly learnedContext?: boolean;\n    /** Character bound for the learned-context digest (D3). Default `1200`. */\n    readonly learnedContextMaxChars?: number;\n    readonly defaultScope?: SessionScope;\n    readonly provider?: Provider | null;\n    /** Override the wall clock - used by tests. */\n    readonly now?: () => number;\n    /** Stable id seed - used by tests. */\n    readonly randomId?: () => string;\n    /** Subscribe to phase-finished events. */\n    readonly onPhaseFinished?: PhaseListener;\n  };\n  /**\n   * Conflict pipeline configuration (Phase 10b). Default: enabled,\n   * English locale pack, thresholds `0.95 / 0.85 / 0.4`. Pass\n   * `{ mode: 'off' }` to bypass the pipeline entirely (logs a one-shot\n   * WARN per process per the spec).\n   */\n  readonly conflictPipeline?: ConflictPipelineOptions;\n  /**\n   * Context engine configuration (Phase 10d). The engine assembles\n   * the layered six-layer system prompt; `memory.compile(scope)`\n   * delegates to it for the working blocks + rules + metadata\n   * fragments. When omitted, a default engine is created (English\n   * locale; `'full'` base mode; no auto-recall; conservative\n   * `'public-tls'` provider trust).\n   */\n  readonly contextEngine?: ContextEngineConfig;\n}\n\n/**\n * The facade returned by {@link createMemory}.\n *\n * @stable\n */\nexport interface Memory {\n  readonly working: WorkingMemory;\n  readonly session: SessionMemory;\n  readonly episodic: EpisodicMemory;\n  readonly semantic: SemanticMemory;\n  readonly procedural: ProceduralMemory;\n  readonly shared: SharedMemory;\n  /**\n   * Read surface over reflection insights (P1-1). A no-op (returns\n   * empty) when the storage adapter does not expose the optional\n   * insight surface.\n   */\n  readonly insights: InsightMemory;\n  readonly tools: ReadonlyArray<Tool>;\n  readonly consolidator: Consolidator;\n  /** The configured conflict pipeline. Surfaced for tests + CLI tooling. */\n  readonly conflictPipeline: ConflictPipeline;\n  /** The configured context engine (Phase 10d). */\n  readonly contextEngine: ContextEngine;\n  /** The active embedder, when configured. `null` otherwise. */\n  readonly embedder: EmbedderProvider | null;\n  /** The canonical id of the active embedder, when configured. */\n  embedderId(): string | null;\n  /**\n   * Compile a system-prompt block bundle. The bundle carries the\n   * static fragments per memory tier; the agent runtime consumes\n   * the {@link ContextEngine} surface (`memory.contextEngine`)\n   * directly for the full six-layer assembly.\n   */\n  compile(scope: CompileScope, options?: CompileOptions): Promise<MemoryContextBlocks>;\n  /** Counter snapshot consumed by Phase 10d's metadata layer. */\n  metadata(scope: SessionScope): Promise<MemoryMetadata>;\n}\n\n/**\n * Wire every memory subsystem in one call. Returns the typed\n * `Memory` facade ready to be passed into `createAgent({...})`.\n *\n * @stable\n */\nexport function createMemory(options: CreateMemoryOptions): Memory {\n  const tracer = options.tracer ?? NOOP_TRACER;\n  const reranker: ReRanker = options.reranker ?? new RRFReranker();\n  const resolveScope: ScopeResolver =\n    options.resolveScope ??\n    (() => {\n      throw new TypeError(\n        '[graphorin/memory] memory tool invoked without a scope resolver. ' +\n          'Pass `resolveScope` to createMemory({...}) - the agent runtime supplies one in Phase 12.',\n      );\n    });\n\n  let activeEmbedderId: string | null = null;\n  if (options.embedder !== undefined) {\n    activeEmbedderId = bindEmbedder(options.embedder, options.embeddings);\n  }\n  const embedder = options.embedder ?? null;\n  const embedderIdProvider = (): string | null => activeEmbedderId;\n\n  const working = new WorkingMemory({ store: options.store, tracer });\n  for (const block of options.workingBlocks ?? []) {\n    working.define(block);\n  }\n  const session = new SessionMemory({ store: options.store, tracer });\n  const episodic = new EpisodicMemory({\n    store: options.store,\n    tracer,\n    embedder,\n    embedderIdProvider,\n  });\n  const conflictPipeline = createConflictPipeline(options.conflictPipeline ?? {});\n  // P2-3: build the (opt-in) query transformer from the supplied provider.\n  // Absent ⇒ `null` ⇒ search stays offline + single-shot.\n  const queryTransformer =\n    options.queryTransform !== undefined\n      ? createProviderQueryTransformer(options.queryTransform.provider, {\n          ...(options.queryTransform.maxVariants !== undefined\n            ? { maxVariants: options.queryTransform.maxVariants }\n            : {}),\n          ...(options.queryTransform.maxTokens !== undefined\n            ? { maxTokens: options.queryTransform.maxTokens }\n            : {}),\n        })\n      : null;\n  // P2-1: build the (opt-in) entity resolver. Requires `graph.entityResolution`\n  // *and* a graph-capable adapter; absent ⇒ `null` ⇒ writes carry s/p/o but\n  // form no entity links and the write path stays offline + unchanged.\n  const graphStore = options.store.graph;\n  const entityResolver =\n    options.graph?.entityResolution === true && graphStore !== undefined\n      ? new EntityResolver({\n          store: graphStore,\n          embedder,\n          embedderId: embedderIdProvider,\n          ...(options.graph.provider !== undefined ? { provider: options.graph.provider } : {}),\n          config: {\n            ...(options.graph.mergeThreshold !== undefined\n              ? { mergeThreshold: options.graph.mergeThreshold }\n              : {}),\n            ...(options.graph.adjudicateThreshold !== undefined\n              ? { adjudicateThreshold: options.graph.adjudicateThreshold }\n              : {}),\n            ...(options.graph.llmAdjudication !== undefined\n              ? { llmAdjudication: options.graph.llmAdjudication }\n              : {}),\n          },\n        })\n      : null;\n  // P2-4: build the (opt-in) retrieval grader. Absent ⇒ `null` ⇒\n  // `searchIterative` runs a single difficulty-gated pass (no provider\n  // call) and the `deep_recall` tool is not registered.\n  const grader =\n    options.iterativeRetrieval !== undefined\n      ? createProviderRetrievalGrader(options.iterativeRetrieval.provider, {\n          ...(options.iterativeRetrieval.maxTokens !== undefined\n            ? { maxTokens: options.iterativeRetrieval.maxTokens }\n            : {}),\n        })\n      : null;\n  const semantic = new SemanticMemory({\n    store: options.store,\n    tracer,\n    embedder,\n    embedderIdProvider,\n    reranker,\n    conflictPipeline,\n    ...(options.contextualRetrieval !== undefined\n      ? { contextualRetrieval: options.contextualRetrieval }\n      : {}),\n    ...(queryTransformer !== null ? { queryTransformer } : {}),\n    ...(entityResolver !== null ? { entityResolver } : {}),\n    ...(grader !== null ? { grader } : {}),\n    ...(options.iterativeRetrieval?.maxIterations !== undefined\n      ? { iterativeMaxIterations: options.iterativeRetrieval.maxIterations }\n      : {}),\n    // C5: the same weights drive eviction salience and rank-time trust.\n    ...(options.consolidator?.salienceWeights !== undefined\n      ? { trustWeights: options.consolidator.salienceWeights }\n      : {}),\n  });\n  // P2-2: build the (opt-in) workflow inducer. Absent ⇒ `null` ⇒\n  // `ProceduralMemory.induce(...)` throws and the tier stays offline CRUD.\n  // MCON-15: induction spend is recorded into the consolidator budget -\n  // the consolidator is constructed AFTER the inducer, so the callback\n  // routes through a slot filled below (placeholder ⇒ no-op).\n  let consolidatorForSpend: Consolidator | null = null;\n  const inducer =\n    options.procedureInduction !== undefined\n      ? createProviderWorkflowInducer(options.procedureInduction.provider, {\n          ...(options.procedureInduction.maxTokens !== undefined\n            ? { maxTokens: options.procedureInduction.maxTokens }\n            : {}),\n          onUsage: (usage) => {\n            consolidatorForSpend?.recordExternalSpend(usage.promptTokens + usage.completionTokens);\n          },\n        })\n      : null;\n  const procedural = new ProceduralMemory({\n    store: options.store,\n    tracer,\n    ...(inducer !== null ? { inducer } : {}),\n    // MCON-2 part 4: opt-in promotion-by-demonstrated-success.\n    ...(options.procedurePromotion?.afterSuccesses !== undefined\n      ? { promoteAfterSuccesses: options.procedurePromotion.afterSuccesses }\n      : {}),\n  });\n  const shared = new SharedMemory({ store: options.store, tracer });\n  const insights = new InsightMemory({ store: options.store, tracer });\n\n  const tools = buildMemoryTools(\n    {\n      working,\n      session,\n      episodic,\n      semantic,\n      procedural,\n      shared,\n      resolveScope,\n    },\n    // P2-4: the gated `deep_recall` tool is registered only when a grader\n    // is configured - the offline default stays at exactly eleven tools.\n    // D3: `runbook_search` is a second gated appendix, opt-in via\n    // `runbookSearch: true`.\n    {\n      includeDeepRecall: grader !== null,\n      includeRunbookSearch: options.runbookSearch === true,\n    },\n  );\n\n  const consolidatorOpts = options.consolidator;\n  const consolidator: Consolidator = buildConsolidator(\n    consolidatorOpts,\n    options.store,\n    semantic,\n    episodic,\n    working,\n    tracer,\n  );\n  consolidatorForSpend = consolidator;\n  const contextEngineConfig = options.contextEngine ?? {};\n  const contextEngine: ContextEngine = createContextEngine(contextEngineConfig);\n  const resolved = contextEngine.config();\n  const localePack =\n    contextEngineConfig.locale === undefined\n      ? enLocalePack\n      : typeof contextEngineConfig.locale === 'string'\n        ? contextEngineConfig.locale === enLocalePack.id\n          ? enLocalePack\n          : resolveLocalePack({ id: contextEngineConfig.locale })\n        : resolveLocalePack(contextEngineConfig.locale);\n\n  // The facade's `compile(...)` is the static-fragment surface\n  // consumed by callers that do not know the active provider yet\n  // (the agent runtime calls `memory.contextEngine.assemble(...)`\n  // with full provider context when `autoAssembleContext` is\n  // enabled). The privacy filter only fires\n  // when the caller explicitly passes `providerAcceptsSensitivity`\n  // OR the operator opted into the engine's `privacy` block.\n  const privacyOptedIn =\n    contextEngineConfig.privacy !== undefined &&\n    (contextEngineConfig.privacy.providerAcceptsSensitivity !== undefined ||\n      contextEngineConfig.privacy.cloudUploadConsent !== undefined ||\n      contextEngineConfig.privacy.providerTrust !== undefined);\n\n  async function compile(\n    scope: CompileScope,\n    compileOptions: CompileOptions = {},\n  ): Promise<MemoryContextBlocks> {\n    const out: { -readonly [K in keyof MemoryContextBlocks]: MemoryContextBlocks[K] } = {};\n    const blocks = await options.store.working.list(scope);\n    // Quarantined (e.g. P2-2-induced) procedures are provisional and must not\n    // reach the system prompt - `activate()` already excludes them, and\n    // compile() (public `@stable`) must agree or a compile()-based prompt\n    // builder ingests unvalidated induction procedures (MST-3).\n    const rules = (await options.store.procedural.list(scope)).filter(\n      (rule) => rule.status !== 'quarantined',\n    );\n    const shouldFilter = privacyOptedIn || compileOptions.providerAcceptsSensitivity !== undefined;\n    let blocksKept: ReadonlyArray<(typeof blocks)[number]> = blocks;\n    let rulesKept: ReadonlyArray<(typeof rules)[number]> = rules;\n    if (shouldFilter) {\n      const filterContext: Parameters<typeof partitionBySensitivity>[1] = {\n        providerTrust: resolved.providerTrust,\n        cloudUploadConsent: resolved.cloudUploadConsent,\n        defaultSensitivity: resolved.defaultSensitivity,\n      };\n      if (compileOptions.providerAcceptsSensitivity !== undefined) {\n        (\n          filterContext as {\n            providerAcceptsSensitivity?: ReadonlyArray<'public' | 'internal' | 'secret'>;\n          }\n        ).providerAcceptsSensitivity = compileOptions.providerAcceptsSensitivity;\n      }\n      blocksKept = partitionBySensitivity(blocks, filterContext).kept;\n      rulesKept = partitionBySensitivity(rules, filterContext).kept;\n    }\n    const blocksXml = renderWorkingBlocksXml(blocksKept);\n    if (blocksXml.length > 0) {\n      out.workingBlocks = blocksXml;\n    }\n    if (rulesKept.length > 0) {\n      const lines = ['<memory_rules>'];\n      for (const rule of rulesKept) {\n        lines.push(`  <rule priority=\"${rule.priority}\">${escapeXml(rule.text)}</rule>`);\n      }\n      lines.push('</memory_rules>');\n      out.rules = lines.join('\\n');\n    }\n    if (compileOptions.includeMetadata !== false) {\n      const meta = await metadata(scope);\n      out.metadata = renderMetadataBlock(meta);\n    }\n    out.base = composeLayer1(localePack, resolved.memoryBaseMode);\n    return Object.freeze(out);\n  }\n\n  async function metadata(scope: SessionScope): Promise<MemoryMetadata> {\n    return gatherMemoryMetadata(scope, {\n      store: options.store,\n      consolidator,\n      embedderId: embedderIdProvider,\n      localeId: resolved.localeId,\n    });\n  }\n\n  return Object.freeze({\n    working,\n    session,\n    episodic,\n    semantic,\n    procedural,\n    shared,\n    insights,\n    tools,\n    consolidator,\n    conflictPipeline,\n    contextEngine,\n    embedder,\n    embedderId: embedderIdProvider,\n    compile,\n    metadata,\n  });\n}\n\nfunction renderWorkingBlocksXml(\n  blocks: ReadonlyArray<{\n    readonly label: string;\n    readonly value: string;\n    readonly description?: string;\n  }>,\n): string {\n  if (blocks.length === 0) return '';\n  const lines = ['<memory_blocks>'];\n  for (const block of blocks) {\n    const description =\n      block.description !== undefined ? ` description=\"${escapeXml(block.description)}\"` : '';\n    lines.push(`  <block label=\"${escapeXml(block.label)}\"${description}>`);\n    lines.push(`    ${escapeXml(block.value)}`);\n    lines.push('  </block>');\n  }\n  lines.push('</memory_blocks>');\n  return lines.join('\\n');\n}\n\nfunction escapeXml(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;');\n}\n\nfunction buildConsolidator(\n  opts: CreateMemoryOptions['consolidator'],\n  store: CreateMemoryOptions['store'],\n  semantic: SemanticMemory,\n  episodic: EpisodicMemory,\n  working: WorkingMemory,\n  tracer: Tracer,\n): Consolidator {\n  if (opts === undefined) {\n    return createConsolidatorPlaceholder();\n  }\n  const enabled = shouldEnableConsolidator(opts);\n  if (!enabled) {\n    return createConsolidatorPlaceholder({\n      ...(opts.triggers !== undefined ? { triggers: opts.triggers } : {}),\n      ...(opts.tier !== undefined ? { tier: opts.tier } : {}),\n    });\n  }\n  const consolidator = createConsolidator({\n    store,\n    semantic,\n    episodic,\n    working,\n    tracer,\n    ...(opts.provider !== undefined ? { provider: opts.provider } : {}),\n    ...(opts.now !== undefined ? { now: opts.now } : {}),\n    ...(opts.randomId !== undefined ? { randomId: opts.randomId } : {}),\n    ...(opts.triggers !== undefined ? { triggers: opts.triggers } : {}),\n    ...(opts.tier !== undefined ? { tier: opts.tier } : {}),\n    ...(opts.phases !== undefined ? { phases: opts.phases } : {}),\n    ...(opts.ceilings !== undefined ? { ceilings: opts.ceilings } : {}),\n    ...(opts.onExceed !== undefined ? { onExceed: opts.onExceed } : {}),\n    ...(opts.priceUsage !== undefined ? { priceUsage: opts.priceUsage } : {}),\n    ...(opts.cheapProvider !== undefined ? { cheapProvider: opts.cheapProvider } : {}),\n    ...(opts.deepProvider !== undefined ? { deepProvider: opts.deepProvider } : {}),\n    ...(opts.cheapModel !== undefined ? { cheapModel: opts.cheapModel } : {}),\n    ...(opts.deepModel !== undefined ? { deepModel: opts.deepModel } : {}),\n    ...(opts.noiseFilters !== undefined ? { noiseFilters: opts.noiseFilters } : {}),\n    ...(opts.lockWaitMs !== undefined ? { lockWaitMs: opts.lockWaitMs } : {}),\n    ...(opts.decayTauDays !== undefined ? { decayTauDays: opts.decayTauDays } : {}),\n    ...(opts.decayArchiveThreshold !== undefined\n      ? { decayArchiveThreshold: opts.decayArchiveThreshold }\n      : {}),\n    ...(opts.decayCapacity !== undefined ? { decayCapacity: opts.decayCapacity } : {}),\n    ...(opts.salienceWeights !== undefined ? { salienceWeights: opts.salienceWeights } : {}),\n    ...(opts.maxStandardBatchSize !== undefined\n      ? { maxStandardBatchSize: opts.maxStandardBatchSize }\n      : {}),\n    ...(opts.maxDeepConflictsPerRun !== undefined\n      ? { maxDeepConflictsPerRun: opts.maxDeepConflictsPerRun }\n      : {}),\n    ...(opts.dlqMaxRetries !== undefined ? { dlqMaxRetries: opts.dlqMaxRetries } : {}),\n    ...(opts.dlqBaseBackoffMs !== undefined ? { dlqBaseBackoffMs: opts.dlqBaseBackoffMs } : {}),\n    ...(opts.dlqMaxBackoffMs !== undefined ? { dlqMaxBackoffMs: opts.dlqMaxBackoffMs } : {}),\n    ...(opts.formEpisodes !== undefined ? { formEpisodes: opts.formEpisodes } : {}),\n    ...(opts.importanceScoring !== undefined ? { importanceScoring: opts.importanceScoring } : {}),\n    ...(opts.autoPromoteExtraction !== undefined\n      ? { autoPromoteExtraction: opts.autoPromoteExtraction }\n      : {}),\n    ...(opts.reflection !== undefined ? { reflection: opts.reflection } : {}),\n    ...(opts.importanceThreshold !== undefined\n      ? { importanceThreshold: opts.importanceThreshold }\n      : {}),\n    ...(opts.reflectionMaxQuestions !== undefined\n      ? { reflectionMaxQuestions: opts.reflectionMaxQuestions }\n      : {}),\n    ...(opts.contextualRetrieval !== undefined\n      ? { contextualRetrieval: opts.contextualRetrieval }\n      : {}),\n    ...(opts.learnedContext !== undefined ? { learnedContext: opts.learnedContext } : {}),\n    ...(opts.learnedContextMaxChars !== undefined\n      ? { learnedContextMaxChars: opts.learnedContextMaxChars }\n      : {}),\n    ...(opts.defaultScope !== undefined ? { defaultScope: opts.defaultScope } : {}),\n  });\n  if (opts.onPhaseFinished !== undefined) {\n    consolidator.onPhaseFinished(opts.onPhaseFinished);\n  }\n  return consolidator;\n}\n\nlet consolidatorConfigIgnoredWarned = false;\n\n/** @internal - test seam for the one-time disabled-config warning. */\nexport function _resetConsolidatorConfigWarningForTesting(): void {\n  consolidatorConfigIgnoredWarned = false;\n}\n\nfunction shouldEnableConsolidator(opts: NonNullable<CreateMemoryOptions['consolidator']>): boolean {\n  // MST-4: ANY non-empty consolidator config implicitly enables - the old\n  // allow-list silently ignored offline knobs (`decayCapacity`,\n  // `formEpisodes`, `reflection`, `contextualRetrieval`, …): the caller\n  // got a no-op placeholder while believing the feature was on.\n  const keys = Object.keys(opts).filter(\n    (k) => k !== 'enabled' && (opts as Record<string, unknown>)[k] !== undefined,\n  );\n  if (opts.enabled === false) {\n    if (keys.length > 0 && !consolidatorConfigIgnoredWarned) {\n      consolidatorConfigIgnoredWarned = true;\n      process.stderr.write(\n        `[graphorin/memory] consolidator config (${keys.join(', ')}) was supplied together with enabled: false - the settings are ignored until the consolidator is enabled.\\n`,\n      );\n    }\n    return false;\n  }\n  if (opts.enabled === true) return true;\n  return keys.length > 0;\n}\n"],"mappings":"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"}
+{"version":3,"file":"facade.js","names":["reranker: ReRanker","resolveScope: ScopeResolver","activeEmbedderId: string | null","consolidatorForSpend: Consolidator | null","consolidator: Consolidator","contextEngine: ContextEngine","out: { -readonly [K in keyof MemoryContextBlocks]: MemoryContextBlocks[K] }","blocksKept: ReadonlyArray<(typeof blocks)[number]>","rulesKept: ReadonlyArray<(typeof rules)[number]>","filterContext: Parameters<typeof partitionBySensitivity>[1]","partitionBySensitivity"],"sources":["../src/facade.ts"],"sourcesContent":["/**\n * `createMemory()` - the facade that wires every tier sub-module (the\n * seven-tier system) + the eleven (+1 gated) memory tools + the search\n * reranker + the context engine\n * stubs + the consolidator placeholder.\n *\n * @packageDocumentation\n */\n\nimport type {\n  EmbedderProvider,\n  MemoryMetadata,\n  Provider,\n  SessionScope,\n  Tracer,\n} from '@graphorin/core';\nimport { NOOP_TRACER } from '@graphorin/core';\nimport { type ConflictPipelineOptions, createConflictPipeline } from './conflict/index.js';\nimport {\n  type Consolidator,\n  type ConsolidatorCeilings,\n  type ConsolidatorPhase,\n  type ConsolidatorTier,\n  type ConsolidatorTriggerSpec,\n  createConsolidator,\n  createConsolidatorPlaceholder,\n  createProviderWorkflowInducer,\n  type OnBudgetExceed,\n  type PhaseListener,\n  type SalienceWeights,\n} from './consolidator/index.js';\nimport { createContextEngine } from './context-engine/engine.js';\nimport type {\n  CompileOptions,\n  CompileScope,\n  ContextEngine,\n  ContextEngineConfig,\n  MemoryContextBlocks,\n} from './context-engine/index.js';\nimport { enLocalePack } from './context-engine/locale-packs/index.js';\nimport { resolveLocalePack } from './context-engine/locale-packs/resolver.js';\nimport { gatherMemoryMetadata, renderMetadataBlock } from './context-engine/metadata.js';\nimport { partition as partitionBySensitivity } from './context-engine/privacy-filter.js';\nimport { composeLayer1 } from './context-engine/templates/composer.js';\nimport { type EntityResolutionConfig, EntityResolver } from './graph/entity-resolver.js';\nimport type { ContextualRetrievalMode } from './internal/contextualize.js';\nimport { bindEmbedder } from './internal/embedder-binding.js';\nimport type { EmbeddingMetaRegistryLike, MemoryStoreAdapter } from './internal/storage-adapter.js';\nimport type { Memory } from './memory-interface.js';\nimport { createProviderRetrievalGrader } from './search/iterative.js';\nimport { createProviderQueryTransformer } from './search/query-transform.js';\nimport { RRFReranker } from './search/rrf.js';\nimport type { ReRanker } from './search/types.js';\nimport { EpisodicMemory } from './tiers/episodic-memory.js';\nimport { InsightMemory } from './tiers/insight-memory.js';\nimport { ProceduralMemory } from './tiers/procedural-memory.js';\nimport { SemanticMemory, type SemanticSearchDefaults } from './tiers/semantic-memory.js';\nimport { SessionMemory } from './tiers/session-memory.js';\nimport { SharedMemory } from './tiers/shared-memory.js';\nimport { type BlockDefinition, WorkingMemory } from './tiers/working-memory.js';\nimport { buildMemoryTools, type ScopeResolver } from './tools/index.js';\n\n/**\n * Options accepted by {@link createMemory}.\n *\n * @stable\n */\nexport interface CreateMemoryOptions {\n  /** Storage adapter (default: `@graphorin/store-sqlite`'s `MemoryStore`). */\n  readonly store: MemoryStoreAdapter;\n  /** Embedder registry. The default sqlite store exposes one as `sqlite.embeddings`. */\n  readonly embeddings: EmbeddingMetaRegistryLike;\n  /** Embedder provider (default: none - vector search is disabled). */\n  readonly embedder?: EmbedderProvider;\n  /** Pre-declared working blocks (idempotent - re-defining is a no-op). */\n  readonly workingBlocks?: ReadonlyArray<BlockDefinition>;\n  /**\n   * Tracer used for every `memory.*` span. Defaults to the no-op\n   * tracer from `@graphorin/core` so unit tests do not need to wire\n   * the observability stack.\n   */\n  readonly tracer?: Tracer;\n  /** Override the reranker used by `SemanticMemory.search`. */\n  readonly reranker?: ReRanker;\n  /**\n   * Construction-time retrieval defaults (W-086) merged under every\n   * `SemanticMemory.search(...)` call, per-call options winning\n   * key-by-key. This is how the advanced retrieval stack (multi-query\n   * fan-out, HyDE, graph expansion, entity matching, weighted fusion,\n   * decay ranking) reaches the model-facing surfaces - `fact_search`,\n   * auto-recall and `deep_recall` all funnel through `search()` and\n   * inherit these without custom tools. Deliberately excludes the\n   * trust-sensitive predicates (`includeQuarantined`,\n   * `includeSuperseded`, `trustWeighting`, `owner`) so configuration\n   * cannot silently weaken trust gates. The fan-out switches only take\n   * effect when their backing dependency is configured (`queryTransform`\n   * for `multiQuery`/`hyde`, `graph` for `expandHops`/`entityMatch`) -\n   * and they add provider latency and cost to EVERY recall, including\n   * auto-recall, so opt in deliberately.\n   */\n  readonly searchDefaults?: SemanticSearchDefaults;\n  /**\n   * Contextual-retrieval mode for the write path (P1-3). `'late-chunk'`\n   * (default) prepends a deterministic, offline situating context\n   * (entities / timeframe / topics, derived from the fact's own\n   * structured fields) to the text that is embedded + FTS-indexed, so a\n   * terse fact stays findable; the canonical `text` is preserved. `'off'`\n   * indexes the bare text. The `'llm'` enrichment is **not** available on\n   * the hot path - it is a consolidator-only opt-in configured via\n   * `consolidator: { contextualRetrieval: 'llm' }`.\n   */\n  readonly contextualRetrieval?: 'off' | 'late-chunk';\n  /**\n   * Query transformation for retrieval (P2-3, opt-in). When supplied,\n   * `SemanticMemory.search(..., { multiQuery })` fans the query into\n   * reworded variants (multi-query / RAG-Fusion) and `{ hyde }` adds a\n   * hypothetical-answer embedding - both via one cheap LLM call on the\n   * given provider, fused through the existing RRF reranker. Omitted (the\n   * default) ⇒ search stays **offline + single-shot** and the\n   * `multiQuery` / `hyde` search options become silent no-ops. Reserve it\n   * for retrieval-heavy recall, not every search (it adds provider\n   * latency).\n   */\n  readonly queryTransform?: {\n    /** Cheap provider used to rewrite the query / write the HyDE passage. */\n    readonly provider: Provider;\n    /** Hard ceiling on reworded variants requested per call. Default 5. */\n    readonly maxVariants?: number;\n    /** Output-token ceiling per transform call. Default 256. */\n    readonly maxTokens?: number;\n  };\n  /**\n   * Relation-graph entity resolution (P2-1). When `entityResolution` is\n   * `true` **and** the storage adapter exposes a `graph` surface (the\n   * default `@graphorin/store-sqlite` does), `remember(...)` resolves a\n   * fact's subject / object to canonical entities and links them, so\n   * `search(..., { expandHops: 1 })` can traverse relationships. Omitted\n   * (the default) ⇒ facts still carry s/p/o but form no entity links and\n   * the write path stays offline + unchanged. Dedup is lexical +\n   * embedding (offline, via the configured embedder); LLM adjudication of\n   * ambiguous merges is a further opt-in that needs `provider`.\n   */\n  readonly graph?: EntityResolutionConfig & {\n    /** Enable entity resolution + linking on write. Default `false`. */\n    readonly entityResolution?: boolean;\n    /** Provider for opt-in LLM adjudication of ambiguous merges. */\n    readonly provider?: Provider;\n  };\n  /**\n   * Agentic / iterative retrieval (P2-4, opt-in). When supplied,\n   * `SemanticMemory.searchIterative(...)` and the gated `deep_recall`\n   * tool can grade a retrieved set on the given provider and, for queries\n   * judged hard, reformulate + retrieve again (widening to one-hop graph\n   * expansion) up to `maxIterations`, abstaining instead of confabulating\n   * when memory is insufficient. Omitted (the default) ⇒ `searchIterative`\n   * stays a single difficulty-gated pass with **no provider call**, and\n   * `deep_recall` is **not** registered (the tool surface stays at the\n   * canonical eleven). Reserve it for hard multi-hop / temporal recall -\n   * it adds provider latency per pass.\n   */\n  readonly iterativeRetrieval?: {\n    /** Cheap provider used to grade retrieved memories + reformulate. */\n    readonly provider: Provider;\n    /** Default total-pass cap (clamped to `[1, 5]`). Default 3. */\n    readonly maxIterations?: number;\n    /** Output-token ceiling per grade call. Default 256. */\n    readonly maxTokens?: number;\n    /**\n     * Default difficulty-gate threshold in `[0, 1]` (W-088). The gate's\n     * signal lexicon is **English-only**: on non-English deployments the\n     * auto-gate never fires, so either lower this threshold or rely on\n     * `forceHard` (`deep_recall` already forces the loop). Omitted ⇒ the\n     * built-in `0.5`; per-call `difficultyThreshold` overrides it.\n     */\n    readonly difficultyThreshold?: number;\n  };\n  /**\n   * Opt-in workflow induction (P2-2). When set, `ProceduralMemory.induce(...)`\n   * distils a reusable, value-abstracted procedure from a successful agent\n   * trajectory and stores it **quarantined** + `provenance: 'induction'`.\n   * Omitted (the default) ⇒ `induce(...)` throws\n   * `ProcedureInductionNotConfiguredError` and the procedural tier\n   * stays pure offline CRUD - no provider call.\n   */\n  readonly procedureInduction?: {\n    /** Provider used to abstract trajectory values into a procedure. */\n    readonly provider: Provider;\n    /** Output-token ceiling per induction call. Default 512. */\n    readonly maxTokens?: number;\n  };\n  /**\n   * Promotion-by-demonstrated-success for quarantined induced\n   * procedures (MCON-2 part 4). Fully offline - orthogonal to\n   * `procedureInduction` (no provider needed). When configured,\n   * `procedural.recordOutcome(scope, id, true)` increments the rule's\n   * persistent success counter and promotes it into `activate()` once\n   * `afterSuccesses` verified reuses accumulate; the injection gate\n   * still refuses flagged texts. Omitted ⇒ outcomes are counted but\n   * nothing auto-promotes.\n   */\n  readonly procedurePromotion?: {\n    /** Successful demonstrated reuses required before promotion (≥ 1). */\n    readonly afterSuccesses: number;\n  };\n  /**\n   * Register the gated `runbook_search` tool (D3) so the model can look\n   * up validated procedures by task description (content recall over\n   * procedural memory, returning whole runbooks). Fully offline - the\n   * default `@graphorin/store-sqlite` adapter serves it from the rules\n   * FTS index (migration 028); adapters without the index degrade to an\n   * in-memory lexical scan. Default `false` - the tool surface stays at\n   * the canonical eleven.\n   */\n  readonly runbookSearch?: boolean;\n  /**\n   * Resolver that produces the live {@link SessionScope} for each\n   * memory-tool invocation. Defaults to a closure that throws - the\n   * agent runtime overrides it in Phase 12.\n   */\n  readonly resolveScope?: ScopeResolver;\n  /**\n   * Consolidator configuration. When omitted, empty, or\n   * `enabled: false`, the facade installs the Phase 10a no-op\n   * placeholder so consumers can still type their interactions without\n   * paying the runtime cost. ANY other setting - including offline\n   * knobs like `decayCapacity` or `contextualRetrieval` - implicitly\n   * enables the production runtime (MST-4); `enabled: false` together\n   * with other settings warns once and keeps the placeholder.\n   */\n  readonly consolidator?: {\n    readonly enabled?: boolean;\n    readonly triggers?: ReadonlyArray<ConsolidatorTriggerSpec>;\n    readonly tier?: ConsolidatorTier;\n    readonly phases?: ReadonlyArray<ConsolidatorPhase>;\n    readonly ceilings?: Partial<ConsolidatorCeilings>;\n    readonly onExceed?: OnBudgetExceed;\n    /**\n     * USD pricer for phase LLM usage (memory-consolidation-02) - wire\n     * to `@graphorin/pricing` so `maxCostPerDay` can actually trip.\n     */\n    readonly priceUsage?: (usage: { promptTokens: number; completionTokens: number }) => number;\n    /** Provider routed to the standard phase when set (MCON-7); falls back to `provider`. */\n    readonly cheapProvider?: Provider | null;\n    /** Provider routed to the deep + reflection passes when set (MCON-7). */\n    readonly deepProvider?: Provider | null;\n    readonly cheapModel?: string | null;\n    readonly deepModel?: string | null;\n    readonly noiseFilters?: ReadonlyArray<'default' | 'minimal' | 'none'>;\n    readonly lockWaitMs?: number;\n    readonly decayTauDays?: number;\n    readonly decayArchiveThreshold?: number;\n    /** Capacity-bounded eviction target for the light phase (X-1). Default unbounded. */\n    readonly decayCapacity?: number | null;\n    /** Weights for the multi-signal salience score (X-1). */\n    readonly salienceWeights?: SalienceWeights;\n    readonly maxStandardBatchSize?: number;\n    /**\n     * Input transcript budget for one standard-phase slice, in\n     * characters (W-081). Over-budget batches are half-split before the\n     * provider call; a lone over-budget message is tail-truncated.\n     * Per-tier default (60k chars ~ 15k tokens; 120k on `full`).\n     */\n    readonly maxTranscriptChars?: number;\n    readonly maxDeepConflictsPerRun?: number;\n    readonly dlqMaxRetries?: number;\n    readonly dlqBaseBackoffMs?: number;\n    readonly dlqMaxBackoffMs?: number;\n    /** Auto-form quarantined episodes from processed slices (P1-2). Per-tier default. */\n    readonly formEpisodes?: boolean;\n    /** Score episode importance via the consolidator LLM (P1-2). Per-tier default. */\n    readonly importanceScoring?: boolean;\n    /** Opt in to auto-promotion of injection-clean extraction facts (MCON-2). Default off. */\n    readonly autoPromoteExtraction?: boolean;\n    /** Run the deep-phase reflection pass synthesizing cited insights (P1-1). Per-tier default. */\n    readonly reflection?: boolean;\n    /** Accumulated-importance threshold at which reflection fires (P1-1). */\n    readonly importanceThreshold?: number;\n    /** Upper bound on salient questions reflection asks per pass (P1-1). */\n    readonly reflectionMaxQuestions?: number;\n    /** Override the quarantined-insight queue cap (W-082). Default 100. */\n    readonly reflectionMaxQuarantinedInsights?: number;\n    /**\n     * Contextual retrieval for standard-phase fact writes (P1-3).\n     * `'llm'` opts into one budgeted cheap-model call per write to author\n     * a situating prefix (consolidator-only); `'late-chunk'` (default)\n     * and `'off'` defer to the write-path mode. Per-tier default.\n     */\n    readonly contextualRetrieval?: ContextualRetrievalMode;\n    /**\n     * Maintain the learned-context digest block (D3): after each deep\n     * phase, one budgeted LLM call rewrites the reserved\n     * `learned_context` working block (previous digest + recent\n     * episodes / active insights / procedures), so the assembled system\n     * prompt carries a compact standing summary. Default `false` at\n     * every tier (Wave-D trial).\n     */\n    readonly learnedContext?: boolean;\n    /** Character bound for the learned-context digest (D3). Default `1200`. */\n    readonly learnedContextMaxChars?: number;\n    readonly defaultScope?: SessionScope;\n    readonly provider?: Provider | null;\n    /** Override the wall clock - used by tests. */\n    readonly now?: () => number;\n    /** Stable id seed - used by tests. */\n    readonly randomId?: () => string;\n    /** Subscribe to phase-finished events. */\n    readonly onPhaseFinished?: PhaseListener;\n  };\n  /**\n   * Conflict pipeline configuration (Phase 10b). Default: enabled,\n   * English locale pack, thresholds `0.95 / 0.85 / 0.4`. Pass\n   * `{ mode: 'off' }` to bypass the pipeline entirely (logs a one-shot\n   * WARN per process per the spec).\n   */\n  readonly conflictPipeline?: ConflictPipelineOptions;\n  /**\n   * Context engine configuration (Phase 10d). The engine assembles\n   * the layered six-layer system prompt; `memory.compile(scope)`\n   * delegates to it for the working blocks + rules + metadata\n   * fragments. When omitted, a default engine is created (English\n   * locale; `'full'` base mode; no auto-recall; conservative\n   * `'public-tls'` provider trust).\n   */\n  readonly contextEngine?: ContextEngineConfig;\n}\n\n// The `Memory` interface is co-located with `ContextEngine` in\n// memory-interface.ts (issue #22 - the pair is mutually recursive and\n// keeping it here put a type-only cycle into the module graph).\n// Re-exported so `import type { Memory } from './facade.js'` and the\n// public barrel keep working unchanged.\nexport type { Memory } from './memory-interface.js';\n\n/**\n * Wire every memory subsystem in one call. Returns the typed\n * `Memory` facade ready to be passed into `createAgent({...})`.\n *\n * @stable\n */\nexport function createMemory(options: CreateMemoryOptions): Memory {\n  const tracer = options.tracer ?? NOOP_TRACER;\n  const reranker: ReRanker = options.reranker ?? new RRFReranker();\n  const resolveScope: ScopeResolver =\n    options.resolveScope ??\n    (() => {\n      throw new TypeError(\n        '[graphorin/memory] memory tool invoked without a scope resolver. ' +\n          'Pass `resolveScope` to createMemory({...}) - the agent runtime supplies one in Phase 12.',\n      );\n    });\n\n  let activeEmbedderId: string | null = null;\n  if (options.embedder !== undefined) {\n    activeEmbedderId = bindEmbedder(options.embedder, options.embeddings);\n  }\n  const embedder = options.embedder ?? null;\n  const embedderIdProvider = (): string | null => activeEmbedderId;\n\n  const working = new WorkingMemory({ store: options.store, tracer });\n  for (const block of options.workingBlocks ?? []) {\n    working.define(block);\n  }\n  const session = new SessionMemory({ store: options.store, tracer });\n  const episodic = new EpisodicMemory({\n    store: options.store,\n    tracer,\n    embedder,\n    embedderIdProvider,\n  });\n  const conflictPipeline = createConflictPipeline(options.conflictPipeline ?? {});\n  // P2-3: build the (opt-in) query transformer from the supplied provider.\n  // Absent ⇒ `null` ⇒ search stays offline + single-shot.\n  const queryTransformer =\n    options.queryTransform !== undefined\n      ? createProviderQueryTransformer(options.queryTransform.provider, {\n          ...(options.queryTransform.maxVariants !== undefined\n            ? { maxVariants: options.queryTransform.maxVariants }\n            : {}),\n          ...(options.queryTransform.maxTokens !== undefined\n            ? { maxTokens: options.queryTransform.maxTokens }\n            : {}),\n        })\n      : null;\n  // P2-1: build the (opt-in) entity resolver. Requires `graph.entityResolution`\n  // *and* a graph-capable adapter; absent ⇒ `null` ⇒ writes carry s/p/o but\n  // form no entity links and the write path stays offline + unchanged.\n  const graphStore = options.store.graph;\n  const entityResolver =\n    options.graph?.entityResolution === true && graphStore !== undefined\n      ? new EntityResolver({\n          store: graphStore,\n          embedder,\n          embedderId: embedderIdProvider,\n          ...(options.graph.provider !== undefined ? { provider: options.graph.provider } : {}),\n          config: {\n            ...(options.graph.mergeThreshold !== undefined\n              ? { mergeThreshold: options.graph.mergeThreshold }\n              : {}),\n            ...(options.graph.adjudicateThreshold !== undefined\n              ? { adjudicateThreshold: options.graph.adjudicateThreshold }\n              : {}),\n            ...(options.graph.llmAdjudication !== undefined\n              ? { llmAdjudication: options.graph.llmAdjudication }\n              : {}),\n          },\n        })\n      : null;\n  // P2-4: build the (opt-in) retrieval grader. Absent ⇒ `null` ⇒\n  // `searchIterative` runs a single difficulty-gated pass (no provider\n  // call) and the `deep_recall` tool is not registered.\n  const grader =\n    options.iterativeRetrieval !== undefined\n      ? createProviderRetrievalGrader(options.iterativeRetrieval.provider, {\n          ...(options.iterativeRetrieval.maxTokens !== undefined\n            ? { maxTokens: options.iterativeRetrieval.maxTokens }\n            : {}),\n        })\n      : null;\n  const semantic = new SemanticMemory({\n    store: options.store,\n    tracer,\n    embedder,\n    embedderIdProvider,\n    reranker,\n    conflictPipeline,\n    ...(options.contextualRetrieval !== undefined\n      ? { contextualRetrieval: options.contextualRetrieval }\n      : {}),\n    ...(queryTransformer !== null ? { queryTransformer } : {}),\n    ...(entityResolver !== null ? { entityResolver } : {}),\n    ...(grader !== null ? { grader } : {}),\n    ...(options.iterativeRetrieval?.maxIterations !== undefined\n      ? { iterativeMaxIterations: options.iterativeRetrieval.maxIterations }\n      : {}),\n    ...(options.iterativeRetrieval?.difficultyThreshold !== undefined\n      ? { iterativeDifficultyThreshold: options.iterativeRetrieval.difficultyThreshold }\n      : {}),\n    // C5: the same weights drive eviction salience and rank-time trust.\n    ...(options.consolidator?.salienceWeights !== undefined\n      ? { trustWeights: options.consolidator.salienceWeights }\n      : {}),\n    // W-086: construction-time retrieval defaults for every search().\n    ...(options.searchDefaults !== undefined ? { searchDefaults: options.searchDefaults } : {}),\n  });\n  // P2-2: build the (opt-in) workflow inducer. Absent ⇒ `null` ⇒\n  // `ProceduralMemory.induce(...)` throws and the tier stays offline CRUD.\n  // MCON-15: induction spend is recorded into the consolidator budget -\n  // the consolidator is constructed AFTER the inducer, so the callback\n  // routes through a slot filled below (placeholder ⇒ no-op).\n  let consolidatorForSpend: Consolidator | null = null;\n  const inducer =\n    options.procedureInduction !== undefined\n      ? createProviderWorkflowInducer(options.procedureInduction.provider, {\n          ...(options.procedureInduction.maxTokens !== undefined\n            ? { maxTokens: options.procedureInduction.maxTokens }\n            : {}),\n          onUsage: (usage) => {\n            consolidatorForSpend?.recordExternalSpend(usage.promptTokens + usage.completionTokens);\n          },\n        })\n      : null;\n  const procedural = new ProceduralMemory({\n    store: options.store,\n    tracer,\n    ...(inducer !== null ? { inducer } : {}),\n    // MCON-2 part 4: opt-in promotion-by-demonstrated-success.\n    ...(options.procedurePromotion?.afterSuccesses !== undefined\n      ? { promoteAfterSuccesses: options.procedurePromotion.afterSuccesses }\n      : {}),\n  });\n  const shared = new SharedMemory({ store: options.store, tracer });\n  const insights = new InsightMemory({ store: options.store, tracer });\n\n  const tools = buildMemoryTools(\n    {\n      working,\n      session,\n      episodic,\n      semantic,\n      procedural,\n      shared,\n      resolveScope,\n    },\n    // P2-4: the gated `deep_recall` tool is registered only when a grader\n    // is configured - the offline default stays at exactly eleven tools.\n    // D3: `runbook_search` is a second gated appendix, opt-in via\n    // `runbookSearch: true`.\n    {\n      includeDeepRecall: grader !== null,\n      includeRunbookSearch: options.runbookSearch === true,\n    },\n  );\n\n  const consolidatorOpts = options.consolidator;\n  const consolidator: Consolidator = buildConsolidator(\n    consolidatorOpts,\n    options.store,\n    semantic,\n    episodic,\n    working,\n    tracer,\n  );\n  consolidatorForSpend = consolidator;\n  const contextEngineConfig = options.contextEngine ?? {};\n  const contextEngine: ContextEngine = createContextEngine(contextEngineConfig);\n  const resolved = contextEngine.config();\n  const localePack =\n    contextEngineConfig.locale === undefined\n      ? enLocalePack\n      : typeof contextEngineConfig.locale === 'string'\n        ? contextEngineConfig.locale === enLocalePack.id\n          ? enLocalePack\n          : resolveLocalePack({ id: contextEngineConfig.locale })\n        : resolveLocalePack(contextEngineConfig.locale);\n\n  // The facade's `compile(...)` is the static-fragment surface\n  // consumed by callers that do not know the active provider yet\n  // (the agent runtime calls `memory.contextEngine.assemble(...)`\n  // with full provider context when `autoAssembleContext` is\n  // enabled). The privacy filter only fires\n  // when the caller explicitly passes `providerAcceptsSensitivity`\n  // OR the operator opted into the engine's `privacy` block.\n  const privacyOptedIn =\n    contextEngineConfig.privacy !== undefined &&\n    (contextEngineConfig.privacy.providerAcceptsSensitivity !== undefined ||\n      contextEngineConfig.privacy.cloudUploadConsent !== undefined ||\n      contextEngineConfig.privacy.providerTrust !== undefined);\n\n  async function compile(\n    scope: CompileScope,\n    compileOptions: CompileOptions = {},\n  ): Promise<MemoryContextBlocks> {\n    const out: { -readonly [K in keyof MemoryContextBlocks]: MemoryContextBlocks[K] } = {};\n    const blocks = await options.store.working.list(scope);\n    // Quarantined (e.g. P2-2-induced) procedures are provisional and must not\n    // reach the system prompt - `activate()` already excludes them, and\n    // compile() (public `@stable`) must agree or a compile()-based prompt\n    // builder ingests unvalidated induction procedures (MST-3).\n    const rules = (await options.store.procedural.list(scope)).filter(\n      (rule) => rule.status !== 'quarantined',\n    );\n    const shouldFilter = privacyOptedIn || compileOptions.providerAcceptsSensitivity !== undefined;\n    let blocksKept: ReadonlyArray<(typeof blocks)[number]> = blocks;\n    let rulesKept: ReadonlyArray<(typeof rules)[number]> = rules;\n    if (shouldFilter) {\n      const filterContext: Parameters<typeof partitionBySensitivity>[1] = {\n        providerTrust: resolved.providerTrust,\n        cloudUploadConsent: resolved.cloudUploadConsent,\n        defaultSensitivity: resolved.defaultSensitivity,\n      };\n      if (compileOptions.providerAcceptsSensitivity !== undefined) {\n        (\n          filterContext as {\n            providerAcceptsSensitivity?: ReadonlyArray<'public' | 'internal' | 'secret'>;\n          }\n        ).providerAcceptsSensitivity = compileOptions.providerAcceptsSensitivity;\n      }\n      blocksKept = partitionBySensitivity(blocks, filterContext).kept;\n      rulesKept = partitionBySensitivity(rules, filterContext).kept;\n    }\n    const blocksXml = renderWorkingBlocksXml(blocksKept);\n    if (blocksXml.length > 0) {\n      out.workingBlocks = blocksXml;\n    }\n    if (rulesKept.length > 0) {\n      const lines = ['<memory_rules>'];\n      for (const rule of rulesKept) {\n        lines.push(`  <rule priority=\"${rule.priority}\">${escapeXml(rule.text)}</rule>`);\n      }\n      lines.push('</memory_rules>');\n      out.rules = lines.join('\\n');\n    }\n    if (compileOptions.includeMetadata !== false) {\n      const meta = await metadata(scope);\n      out.metadata = renderMetadataBlock(meta);\n    }\n    out.base = composeLayer1(localePack, resolved.memoryBaseMode);\n    return Object.freeze(out);\n  }\n\n  async function metadata(scope: SessionScope): Promise<MemoryMetadata> {\n    return gatherMemoryMetadata(scope, {\n      store: options.store,\n      consolidator,\n      embedderId: embedderIdProvider,\n      localeId: resolved.localeId,\n    });\n  }\n\n  return Object.freeze({\n    working,\n    session,\n    episodic,\n    semantic,\n    procedural,\n    shared,\n    insights,\n    tools,\n    consolidator,\n    conflictPipeline,\n    contextEngine,\n    embedder,\n    embedderId: embedderIdProvider,\n    compile,\n    metadata,\n  });\n}\n\nfunction renderWorkingBlocksXml(\n  blocks: ReadonlyArray<{\n    readonly label: string;\n    readonly value: string;\n    readonly description?: string;\n  }>,\n): string {\n  if (blocks.length === 0) return '';\n  const lines = ['<memory_blocks>'];\n  for (const block of blocks) {\n    const description =\n      block.description !== undefined ? ` description=\"${escapeXml(block.description)}\"` : '';\n    lines.push(`  <block label=\"${escapeXml(block.label)}\"${description}>`);\n    lines.push(`    ${escapeXml(block.value)}`);\n    lines.push('  </block>');\n  }\n  lines.push('</memory_blocks>');\n  return lines.join('\\n');\n}\n\nfunction escapeXml(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;');\n}\n\nfunction buildConsolidator(\n  opts: CreateMemoryOptions['consolidator'],\n  store: CreateMemoryOptions['store'],\n  semantic: SemanticMemory,\n  episodic: EpisodicMemory,\n  working: WorkingMemory,\n  tracer: Tracer,\n): Consolidator {\n  if (opts === undefined) {\n    return createConsolidatorPlaceholder();\n  }\n  const enabled = shouldEnableConsolidator(opts);\n  if (!enabled) {\n    return createConsolidatorPlaceholder({\n      ...(opts.triggers !== undefined ? { triggers: opts.triggers } : {}),\n      ...(opts.tier !== undefined ? { tier: opts.tier } : {}),\n    });\n  }\n  const consolidator = createConsolidator({\n    store,\n    semantic,\n    episodic,\n    working,\n    tracer,\n    ...(opts.provider !== undefined ? { provider: opts.provider } : {}),\n    ...(opts.now !== undefined ? { now: opts.now } : {}),\n    ...(opts.randomId !== undefined ? { randomId: opts.randomId } : {}),\n    ...(opts.triggers !== undefined ? { triggers: opts.triggers } : {}),\n    ...(opts.tier !== undefined ? { tier: opts.tier } : {}),\n    ...(opts.phases !== undefined ? { phases: opts.phases } : {}),\n    ...(opts.ceilings !== undefined ? { ceilings: opts.ceilings } : {}),\n    ...(opts.onExceed !== undefined ? { onExceed: opts.onExceed } : {}),\n    ...(opts.priceUsage !== undefined ? { priceUsage: opts.priceUsage } : {}),\n    ...(opts.cheapProvider !== undefined ? { cheapProvider: opts.cheapProvider } : {}),\n    ...(opts.deepProvider !== undefined ? { deepProvider: opts.deepProvider } : {}),\n    ...(opts.cheapModel !== undefined ? { cheapModel: opts.cheapModel } : {}),\n    ...(opts.deepModel !== undefined ? { deepModel: opts.deepModel } : {}),\n    ...(opts.noiseFilters !== undefined ? { noiseFilters: opts.noiseFilters } : {}),\n    ...(opts.lockWaitMs !== undefined ? { lockWaitMs: opts.lockWaitMs } : {}),\n    ...(opts.decayTauDays !== undefined ? { decayTauDays: opts.decayTauDays } : {}),\n    ...(opts.decayArchiveThreshold !== undefined\n      ? { decayArchiveThreshold: opts.decayArchiveThreshold }\n      : {}),\n    ...(opts.decayCapacity !== undefined ? { decayCapacity: opts.decayCapacity } : {}),\n    ...(opts.salienceWeights !== undefined ? { salienceWeights: opts.salienceWeights } : {}),\n    ...(opts.maxStandardBatchSize !== undefined\n      ? { maxStandardBatchSize: opts.maxStandardBatchSize }\n      : {}),\n    ...(opts.maxTranscriptChars !== undefined\n      ? { maxTranscriptChars: opts.maxTranscriptChars }\n      : {}),\n    ...(opts.maxDeepConflictsPerRun !== undefined\n      ? { maxDeepConflictsPerRun: opts.maxDeepConflictsPerRun }\n      : {}),\n    ...(opts.dlqMaxRetries !== undefined ? { dlqMaxRetries: opts.dlqMaxRetries } : {}),\n    ...(opts.dlqBaseBackoffMs !== undefined ? { dlqBaseBackoffMs: opts.dlqBaseBackoffMs } : {}),\n    ...(opts.dlqMaxBackoffMs !== undefined ? { dlqMaxBackoffMs: opts.dlqMaxBackoffMs } : {}),\n    ...(opts.formEpisodes !== undefined ? { formEpisodes: opts.formEpisodes } : {}),\n    ...(opts.importanceScoring !== undefined ? { importanceScoring: opts.importanceScoring } : {}),\n    ...(opts.autoPromoteExtraction !== undefined\n      ? { autoPromoteExtraction: opts.autoPromoteExtraction }\n      : {}),\n    ...(opts.reflection !== undefined ? { reflection: opts.reflection } : {}),\n    ...(opts.importanceThreshold !== undefined\n      ? { importanceThreshold: opts.importanceThreshold }\n      : {}),\n    ...(opts.reflectionMaxQuestions !== undefined\n      ? { reflectionMaxQuestions: opts.reflectionMaxQuestions }\n      : {}),\n    ...(opts.reflectionMaxQuarantinedInsights !== undefined\n      ? { reflectionMaxQuarantinedInsights: opts.reflectionMaxQuarantinedInsights }\n      : {}),\n    ...(opts.contextualRetrieval !== undefined\n      ? { contextualRetrieval: opts.contextualRetrieval }\n      : {}),\n    ...(opts.learnedContext !== undefined ? { learnedContext: opts.learnedContext } : {}),\n    ...(opts.learnedContextMaxChars !== undefined\n      ? { learnedContextMaxChars: opts.learnedContextMaxChars }\n      : {}),\n    ...(opts.defaultScope !== undefined ? { defaultScope: opts.defaultScope } : {}),\n  });\n  if (opts.onPhaseFinished !== undefined) {\n    consolidator.onPhaseFinished(opts.onPhaseFinished);\n  }\n  return consolidator;\n}\n\nlet consolidatorConfigIgnoredWarned = false;\n\n/** @internal - test seam for the one-time disabled-config warning. */\nexport function _resetConsolidatorConfigWarningForTesting(): void {\n  consolidatorConfigIgnoredWarned = false;\n}\n\nfunction shouldEnableConsolidator(opts: NonNullable<CreateMemoryOptions['consolidator']>): boolean {\n  // MST-4: ANY non-empty consolidator config implicitly enables - the old\n  // allow-list silently ignored offline knobs (`decayCapacity`,\n  // `formEpisodes`, `reflection`, `contextualRetrieval`, …): the caller\n  // got a no-op placeholder while believing the feature was on.\n  const keys = Object.keys(opts).filter(\n    (k) => k !== 'enabled' && (opts as Record<string, unknown>)[k] !== undefined,\n  );\n  if (opts.enabled === false) {\n    if (keys.length > 0 && !consolidatorConfigIgnoredWarned) {\n      consolidatorConfigIgnoredWarned = true;\n      process.stderr.write(\n        `[graphorin/memory] consolidator config (${keys.join(', ')}) was supplied together with enabled: false - the settings are ignored until the consolidator is enabled.\\n`,\n      );\n    }\n    return false;\n  }\n  if (opts.enabled === true) return true;\n  return keys.length > 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmVA,SAAgB,aAAa,SAAsC;CACjE,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAMA,WAAqB,QAAQ,YAAY,IAAI,aAAa;CAChE,MAAMC,eACJ,QAAQ,uBACD;AACL,QAAM,IAAI,UACR,4JAED;;CAGL,IAAIC,mBAAkC;AACtC,KAAI,QAAQ,aAAa,OACvB,oBAAmB,aAAa,QAAQ,UAAU,QAAQ,WAAW;CAEvE,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,2BAA0C;CAEhD,MAAM,UAAU,IAAI,cAAc;EAAE,OAAO,QAAQ;EAAO;EAAQ,CAAC;AACnE,MAAK,MAAM,SAAS,QAAQ,iBAAiB,EAAE,CAC7C,SAAQ,OAAO,MAAM;CAEvB,MAAM,UAAU,IAAI,cAAc;EAAE,OAAO,QAAQ;EAAO;EAAQ,CAAC;CACnE,MAAM,WAAW,IAAI,eAAe;EAClC,OAAO,QAAQ;EACf;EACA;EACA;EACD,CAAC;CACF,MAAM,mBAAmB,uBAAuB,QAAQ,oBAAoB,EAAE,CAAC;CAG/E,MAAM,mBACJ,QAAQ,mBAAmB,SACvB,+BAA+B,QAAQ,eAAe,UAAU;EAC9D,GAAI,QAAQ,eAAe,gBAAgB,SACvC,EAAE,aAAa,QAAQ,eAAe,aAAa,GACnD,EAAE;EACN,GAAI,QAAQ,eAAe,cAAc,SACrC,EAAE,WAAW,QAAQ,eAAe,WAAW,GAC/C,EAAE;EACP,CAAC,GACF;CAIN,MAAM,aAAa,QAAQ,MAAM;CACjC,MAAM,iBACJ,QAAQ,OAAO,qBAAqB,QAAQ,eAAe,SACvD,IAAI,eAAe;EACjB,OAAO;EACP;EACA,YAAY;EACZ,GAAI,QAAQ,MAAM,aAAa,SAAY,EAAE,UAAU,QAAQ,MAAM,UAAU,GAAG,EAAE;EACpF,QAAQ;GACN,GAAI,QAAQ,MAAM,mBAAmB,SACjC,EAAE,gBAAgB,QAAQ,MAAM,gBAAgB,GAChD,EAAE;GACN,GAAI,QAAQ,MAAM,wBAAwB,SACtC,EAAE,qBAAqB,QAAQ,MAAM,qBAAqB,GAC1D,EAAE;GACN,GAAI,QAAQ,MAAM,oBAAoB,SAClC,EAAE,iBAAiB,QAAQ,MAAM,iBAAiB,GAClD,EAAE;GACP;EACF,CAAC,GACF;CAIN,MAAM,SACJ,QAAQ,uBAAuB,SAC3B,8BAA8B,QAAQ,mBAAmB,UAAU,EACjE,GAAI,QAAQ,mBAAmB,cAAc,SACzC,EAAE,WAAW,QAAQ,mBAAmB,WAAW,GACnD,EAAE,EACP,CAAC,GACF;CACN,MAAM,WAAW,IAAI,eAAe;EAClC,OAAO,QAAQ;EACf;EACA;EACA;EACA;EACA;EACA,GAAI,QAAQ,wBAAwB,SAChC,EAAE,qBAAqB,QAAQ,qBAAqB,GACpD,EAAE;EACN,GAAI,qBAAqB,OAAO,EAAE,kBAAkB,GAAG,EAAE;EACzD,GAAI,mBAAmB,OAAO,EAAE,gBAAgB,GAAG,EAAE;EACrD,GAAI,WAAW,OAAO,EAAE,QAAQ,GAAG,EAAE;EACrC,GAAI,QAAQ,oBAAoB,kBAAkB,SAC9C,EAAE,wBAAwB,QAAQ,mBAAmB,eAAe,GACpE,EAAE;EACN,GAAI,QAAQ,oBAAoB,wBAAwB,SACpD,EAAE,8BAA8B,QAAQ,mBAAmB,qBAAqB,GAChF,EAAE;EAEN,GAAI,QAAQ,cAAc,oBAAoB,SAC1C,EAAE,cAAc,QAAQ,aAAa,iBAAiB,GACtD,EAAE;EAEN,GAAI,QAAQ,mBAAmB,SAAY,EAAE,gBAAgB,QAAQ,gBAAgB,GAAG,EAAE;EAC3F,CAAC;CAMF,IAAIC,uBAA4C;CAChD,MAAM,UACJ,QAAQ,uBAAuB,SAC3B,8BAA8B,QAAQ,mBAAmB,UAAU;EACjE,GAAI,QAAQ,mBAAmB,cAAc,SACzC,EAAE,WAAW,QAAQ,mBAAmB,WAAW,GACnD,EAAE;EACN,UAAU,UAAU;AAClB,yBAAsB,oBAAoB,MAAM,eAAe,MAAM,iBAAiB;;EAEzF,CAAC,GACF;CACN,MAAM,aAAa,IAAI,iBAAiB;EACtC,OAAO,QAAQ;EACf;EACA,GAAI,YAAY,OAAO,EAAE,SAAS,GAAG,EAAE;EAEvC,GAAI,QAAQ,oBAAoB,mBAAmB,SAC/C,EAAE,uBAAuB,QAAQ,mBAAmB,gBAAgB,GACpE,EAAE;EACP,CAAC;CACF,MAAM,SAAS,IAAI,aAAa;EAAE,OAAO,QAAQ;EAAO;EAAQ,CAAC;CACjE,MAAM,WAAW,IAAI,cAAc;EAAE,OAAO,QAAQ;EAAO;EAAQ,CAAC;CAEpE,MAAM,QAAQ,iBACZ;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACD,EAKD;EACE,mBAAmB,WAAW;EAC9B,sBAAsB,QAAQ,kBAAkB;EACjD,CACF;CAED,MAAM,mBAAmB,QAAQ;CACjC,MAAMC,eAA6B,kBACjC,kBACA,QAAQ,OACR,UACA,UACA,SACA,OACD;AACD,wBAAuB;CACvB,MAAM,sBAAsB,QAAQ,iBAAiB,EAAE;CACvD,MAAMC,gBAA+B,oBAAoB,oBAAoB;CAC7E,MAAM,WAAW,cAAc,QAAQ;CACvC,MAAM,aACJ,oBAAoB,WAAW,SAC3B,eACA,OAAO,oBAAoB,WAAW,WACpC,oBAAoB,WAAW,aAAa,KAC1C,eACA,kBAAkB,EAAE,IAAI,oBAAoB,QAAQ,CAAC,GACvD,kBAAkB,oBAAoB,OAAO;CASrD,MAAM,iBACJ,oBAAoB,YAAY,WAC/B,oBAAoB,QAAQ,+BAA+B,UAC1D,oBAAoB,QAAQ,uBAAuB,UACnD,oBAAoB,QAAQ,kBAAkB;CAElD,eAAe,QACb,OACA,iBAAiC,EAAE,EACL;EAC9B,MAAMC,MAA8E,EAAE;EACtF,MAAM,SAAS,MAAM,QAAQ,MAAM,QAAQ,KAAK,MAAM;EAKtD,MAAM,SAAS,MAAM,QAAQ,MAAM,WAAW,KAAK,MAAM,EAAE,QACxD,SAAS,KAAK,WAAW,cAC3B;EACD,MAAM,eAAe,kBAAkB,eAAe,+BAA+B;EACrF,IAAIC,aAAqD;EACzD,IAAIC,YAAmD;AACvD,MAAI,cAAc;GAChB,MAAMC,gBAA8D;IAClE,eAAe,SAAS;IACxB,oBAAoB,SAAS;IAC7B,oBAAoB,SAAS;IAC9B;AACD,OAAI,eAAe,+BAA+B,OAChD,CACE,cAGA,6BAA6B,eAAe;AAEhD,gBAAaC,UAAuB,QAAQ,cAAc,CAAC;AAC3D,eAAYA,UAAuB,OAAO,cAAc,CAAC;;EAE3D,MAAM,YAAY,uBAAuB,WAAW;AACpD,MAAI,UAAU,SAAS,EACrB,KAAI,gBAAgB;AAEtB,MAAI,UAAU,SAAS,GAAG;GACxB,MAAM,QAAQ,CAAC,iBAAiB;AAChC,QAAK,MAAM,QAAQ,UACjB,OAAM,KAAK,qBAAqB,KAAK,SAAS,IAAI,UAAU,KAAK,KAAK,CAAC,SAAS;AAElF,SAAM,KAAK,kBAAkB;AAC7B,OAAI,QAAQ,MAAM,KAAK,KAAK;;AAE9B,MAAI,eAAe,oBAAoB,MAErC,KAAI,WAAW,oBADF,MAAM,SAAS,MAAM,CACM;AAE1C,MAAI,OAAO,cAAc,YAAY,SAAS,eAAe;AAC7D,SAAO,OAAO,OAAO,IAAI;;CAG3B,eAAe,SAAS,OAA8C;AACpE,SAAO,qBAAqB,OAAO;GACjC,OAAO,QAAQ;GACf;GACA,YAAY;GACZ,UAAU,SAAS;GACpB,CAAC;;AAGJ,QAAO,OAAO,OAAO;EACnB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,YAAY;EACZ;EACA;EACD,CAAC;;AAGJ,SAAS,uBACP,QAKQ;AACR,KAAI,OAAO,WAAW,EAAG,QAAO;CAChC,MAAM,QAAQ,CAAC,kBAAkB;AACjC,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,cACJ,MAAM,gBAAgB,SAAY,iBAAiB,UAAU,MAAM,YAAY,CAAC,KAAK;AACvF,QAAM,KAAK,mBAAmB,UAAU,MAAM,MAAM,CAAC,GAAG,YAAY,GAAG;AACvE,QAAM,KAAK,OAAO,UAAU,MAAM,MAAM,GAAG;AAC3C,QAAM,KAAK,aAAa;;AAE1B,OAAM,KAAK,mBAAmB;AAC9B,QAAO,MAAM,KAAK,KAAK;;AAGzB,SAAS,UAAU,OAAuB;AACxC,QAAO,MACJ,QAAQ,MAAM,QAAQ,CACtB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,SAAS;;AAG5B,SAAS,kBACP,MACA,OACA,UACA,UACA,SACA,QACc;AACd,KAAI,SAAS,OACX,QAAO,+BAA+B;AAGxC,KAAI,CADY,yBAAyB,KAAK,CAE5C,QAAO,8BAA8B;EACnC,GAAI,KAAK,aAAa,SAAY,EAAE,UAAU,KAAK,UAAU,GAAG,EAAE;EAClE,GAAI,KAAK,SAAS,SAAY,EAAE,MAAM,KAAK,MAAM,GAAG,EAAE;EACvD,CAAC;CAEJ,MAAM,eAAe,mBAAmB;EACtC;EACA;EACA;EACA;EACA;EACA,GAAI,KAAK,aAAa,SAAY,EAAE,UAAU,KAAK,UAAU,GAAG,EAAE;EAClE,GAAI,KAAK,QAAQ,SAAY,EAAE,KAAK,KAAK,KAAK,GAAG,EAAE;EACnD,GAAI,KAAK,aAAa,SAAY,EAAE,UAAU,KAAK,UAAU,GAAG,EAAE;EAClE,GAAI,KAAK,aAAa,SAAY,EAAE,UAAU,KAAK,UAAU,GAAG,EAAE;EAClE,GAAI,KAAK,SAAS,SAAY,EAAE,MAAM,KAAK,MAAM,GAAG,EAAE;EACtD,GAAI,KAAK,WAAW,SAAY,EAAE,QAAQ,KAAK,QAAQ,GAAG,EAAE;EAC5D,GAAI,KAAK,aAAa,SAAY,EAAE,UAAU,KAAK,UAAU,GAAG,EAAE;EAClE,GAAI,KAAK,aAAa,SAAY,EAAE,UAAU,KAAK,UAAU,GAAG,EAAE;EAClE,GAAI,KAAK,eAAe,SAAY,EAAE,YAAY,KAAK,YAAY,GAAG,EAAE;EACxE,GAAI,KAAK,kBAAkB,SAAY,EAAE,eAAe,KAAK,eAAe,GAAG,EAAE;EACjF,GAAI,KAAK,iBAAiB,SAAY,EAAE,cAAc,KAAK,cAAc,GAAG,EAAE;EAC9E,GAAI,KAAK,eAAe,SAAY,EAAE,YAAY,KAAK,YAAY,GAAG,EAAE;EACxE,GAAI,KAAK,cAAc,SAAY,EAAE,WAAW,KAAK,WAAW,GAAG,EAAE;EACrE,GAAI,KAAK,iBAAiB,SAAY,EAAE,cAAc,KAAK,cAAc,GAAG,EAAE;EAC9E,GAAI,KAAK,eAAe,SAAY,EAAE,YAAY,KAAK,YAAY,GAAG,EAAE;EACxE,GAAI,KAAK,iBAAiB,SAAY,EAAE,cAAc,KAAK,cAAc,GAAG,EAAE;EAC9E,GAAI,KAAK,0BAA0B,SAC/B,EAAE,uBAAuB,KAAK,uBAAuB,GACrD,EAAE;EACN,GAAI,KAAK,kBAAkB,SAAY,EAAE,eAAe,KAAK,eAAe,GAAG,EAAE;EACjF,GAAI,KAAK,oBAAoB,SAAY,EAAE,iBAAiB,KAAK,iBAAiB,GAAG,EAAE;EACvF,GAAI,KAAK,yBAAyB,SAC9B,EAAE,sBAAsB,KAAK,sBAAsB,GACnD,EAAE;EACN,GAAI,KAAK,uBAAuB,SAC5B,EAAE,oBAAoB,KAAK,oBAAoB,GAC/C,EAAE;EACN,GAAI,KAAK,2BAA2B,SAChC,EAAE,wBAAwB,KAAK,wBAAwB,GACvD,EAAE;EACN,GAAI,KAAK,kBAAkB,SAAY,EAAE,eAAe,KAAK,eAAe,GAAG,EAAE;EACjF,GAAI,KAAK,qBAAqB,SAAY,EAAE,kBAAkB,KAAK,kBAAkB,GAAG,EAAE;EAC1F,GAAI,KAAK,oBAAoB,SAAY,EAAE,iBAAiB,KAAK,iBAAiB,GAAG,EAAE;EACvF,GAAI,KAAK,iBAAiB,SAAY,EAAE,cAAc,KAAK,cAAc,GAAG,EAAE;EAC9E,GAAI,KAAK,sBAAsB,SAAY,EAAE,mBAAmB,KAAK,mBAAmB,GAAG,EAAE;EAC7F,GAAI,KAAK,0BAA0B,SAC/B,EAAE,uBAAuB,KAAK,uBAAuB,GACrD,EAAE;EACN,GAAI,KAAK,eAAe,SAAY,EAAE,YAAY,KAAK,YAAY,GAAG,EAAE;EACxE,GAAI,KAAK,wBAAwB,SAC7B,EAAE,qBAAqB,KAAK,qBAAqB,GACjD,EAAE;EACN,GAAI,KAAK,2BAA2B,SAChC,EAAE,wBAAwB,KAAK,wBAAwB,GACvD,EAAE;EACN,GAAI,KAAK,qCAAqC,SAC1C,EAAE,kCAAkC,KAAK,kCAAkC,GAC3E,EAAE;EACN,GAAI,KAAK,wBAAwB,SAC7B,EAAE,qBAAqB,KAAK,qBAAqB,GACjD,EAAE;EACN,GAAI,KAAK,mBAAmB,SAAY,EAAE,gBAAgB,KAAK,gBAAgB,GAAG,EAAE;EACpF,GAAI,KAAK,2BAA2B,SAChC,EAAE,wBAAwB,KAAK,wBAAwB,GACvD,EAAE;EACN,GAAI,KAAK,iBAAiB,SAAY,EAAE,cAAc,KAAK,cAAc,GAAG,EAAE;EAC/E,CAAC;AACF,KAAI,KAAK,oBAAoB,OAC3B,cAAa,gBAAgB,KAAK,gBAAgB;AAEpD,QAAO;;AAGT,IAAI,kCAAkC;;AAGtC,SAAgB,4CAAkD;AAChE,mCAAkC;;AAGpC,SAAS,yBAAyB,MAAiE;CAKjG,MAAM,OAAO,OAAO,KAAK,KAAK,CAAC,QAC5B,MAAM,MAAM,aAAc,KAAiC,OAAO,OACpE;AACD,KAAI,KAAK,YAAY,OAAO;AAC1B,MAAI,KAAK,SAAS,KAAK,CAAC,iCAAiC;AACvD,qCAAkC;AAClC,WAAQ,OAAO,MACb,2CAA2C,KAAK,KAAK,KAAK,CAAC,6GAC5D;;AAEH,SAAO;;AAET,KAAI,KAAK,YAAY,KAAM,QAAO;AAClC,QAAO,KAAK,SAAS"}

package/dist/graph/entity-resolver.js

@@ -168,7 +168,7 @@ var EntityResolver = class {
 		const embedder = this.#embedder;
 		if (embedder === null || this.#embedderId() === null) return null;
 		try {
-			const [vector] = await embedder.embed([name]);
+			const [vector] = await embedder.embed([name], { ...signal !== void 0 ? { signal } : {} });
 			return vector ?? null;
 		} catch {
 			return null;