@remnic/core 10.0.32 → 10.0.34

package/dist/chunk-BTTPKDIL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/abort-error.ts"],"sourcesContent":["/**\n * Shared abort-error helpers.\n *\n * Consolidates the `throwIfAborted` / `abortError` / `isAbortError`\n * patterns that were independently implemented across\n * `direct-answer-wiring.ts`, `harmonic-retrieval.ts`, and `qmd.ts`\n * (plus a private pair in `orchestrator.ts`).  A single helper\n * means future changes to the abort-error convention are applied\n * consistently across the codebase.\n *\n * The convention (matching Web / Node): throw a standard `Error`\n * with `name === \"AbortError\"`.  Callers dispatch on name rather\n * than a specific class so error propagation across async\n * boundaries continues to classify correctly.\n */\n\n/**\n * Build an Error whose `name` is `\"AbortError\"`.  Uses\n * `Object.defineProperty` so the name is non-enumerable and\n * mirrors the shape of `DOMException(\"AbortError\")` where that\n * is available.\n */\nexport function abortError(message: string): Error {\n  const err = new Error(message);\n  Object.defineProperty(err, \"name\", { value: \"AbortError\" });\n  return err;\n}\n\n/** Return true iff `err` is an Error whose `name` is `\"AbortError\"`. */\nexport function isAbortError(err: unknown): boolean {\n  return err instanceof Error && err.name === \"AbortError\";\n}\n\n/**\n * Throw an AbortError when the given signal has fired.  No-op\n * when the signal is absent or not yet aborted.  The default\n * message matches the prior in-module implementations.\n */\nexport function throwIfAborted(\n  signal?: AbortSignal,\n  message = \"operation aborted\",\n): void {\n  if (signal?.aborted) {\n    throw abortError(message);\n  }\n}\n\nexport function raceAbort<T>(\n  promise: Promise<T>,\n  signal?: AbortSignal,\n  message = \"operation aborted\",\n): Promise<T> {\n  if (!signal) return promise;\n  if (signal.aborted) return Promise.reject(abortError(message));\n  let onAbort: (() => void) | undefined;\n  const aborted = new Promise<never>((_resolve, reject) => {\n    onAbort = () => reject(abortError(message));\n    signal.addEventListener(\"abort\", onAbort, { once: true });\n  });\n  return Promise.race([promise, aborted]).finally(() => {\n    if (onAbort) signal.removeEventListener(\"abort\", onAbort);\n  });\n}\n"],"mappings":";AAsBO,SAAS,WAAW,SAAwB;AACjD,QAAM,MAAM,IAAI,MAAM,OAAO;AAC7B,SAAO,eAAe,KAAK,QAAQ,EAAE,OAAO,aAAa,CAAC;AAC1D,SAAO;AACT;AAGO,SAAS,aAAa,KAAuB;AAClD,SAAO,eAAe,SAAS,IAAI,SAAS;AAC9C;AAOO,SAAS,eACd,QACA,UAAU,qBACJ;AACN,MAAI,QAAQ,SAAS;AACnB,UAAM,WAAW,OAAO;AAAA,EAC1B;AACF;AAEO,SAAS,UACd,SACA,QACA,UAAU,qBACE;AACZ,MAAI,CAAC,OAAQ,QAAO;AACpB,MAAI,OAAO,QAAS,QAAO,QAAQ,OAAO,WAAW,OAAO,CAAC;AAC7D,MAAI;AACJ,QAAM,UAAU,IAAI,QAAe,CAAC,UAAU,WAAW;AACvD,cAAU,MAAM,OAAO,WAAW,OAAO,CAAC;AAC1C,WAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;AAAA,EAC1D,CAAC;AACD,SAAO,QAAQ,KAAK,CAAC,SAAS,OAAO,CAAC,EAAE,QAAQ,MAAM;AACpD,QAAI,QAAS,QAAO,oBAAoB,SAAS,OAAO;AAAA,EAC1D,CAAC;AACH;","names":[]}

package/dist/chunk-HJ444KNS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/local-llm-rate-limit.ts"],"sourcesContent":["/**\n * Process-wide rate-limit handling for the local LLM client (COS-447).\n *\n * A LiteLLM proxy in front of the local models answers `429 No deployments\n * available` (and `503`/`408`) when every deployment is busy or in cooldown.\n * Before this module the client returned on the first 429 and the caller\n * loop immediately issued the next request, so one daemon could hammer the\n * proxy with thousands of calls per hour while it was saturated.\n *\n * This module provides three pieces that the client composes:\n *\n * - classification of rate-limit responses and of the retry hint\n *   (`Retry-After` header as delta-seconds or HTTP-date, falling back to\n *   LiteLLM's `Try again in N seconds` body text);\n * - exponential backoff with full jitter;\n * - process-wide state shared by every `LocalLlmClient` instance: a\n *   concurrency semaphore for in-flight HTTP attempts and a per-endpoint\n *   \"do not call before\" deadline, so one client's 429 slows every client\n *   pointed at the same endpoint.\n *\n * State lives on `globalThis` so duplicated module copies in bundled output\n * still share one limiter.\n */\n\nexport const RATE_LIMIT_STATUSES: ReadonlySet<number> = new Set([408, 429, 503]);\n\nconst RATE_LIMIT_BODY_PATTERN = /no deployments available|cooldown_list|all deployments.*cooldown/i;\nconst TRY_AGAIN_PATTERN = /try again in (\\d+(?:\\.\\d+)?) ?(seconds?|secs?|s|milliseconds?|ms|minutes?|mins?)\\b/i;\n\n/** Upper bound on any server-provided wait we will record (sanity clamp). */\nexport const MAX_RECORDED_BACKOFF_MS = 10 * 60_000;\n\nexport const DEFAULT_RATE_LIMIT_RETRY_COUNT = 3;\nexport const DEFAULT_RATE_LIMIT_BACKOFF_BASE_MS = 1_000;\nexport const DEFAULT_RATE_LIMIT_BACKOFF_MAX_MS = 60_000;\nexport const DEFAULT_MAX_CONCURRENCY = 4;\n\nexport interface LocalLlmRateLimitSettings {\n  retryCount: number;\n  backoffBaseMs: number;\n  backoffMaxMs: number;\n  /** 0 disables the process-wide concurrency cap. */\n  maxConcurrency: number;\n}\n\nfunction nonNegativeInt(value: number | undefined, fallback: number): number {\n  if (value === undefined || !Number.isFinite(value) || value < 0) return fallback;\n  return Math.floor(value);\n}\n\nexport function resolveRateLimitSettings(config: {\n  localLlmRateLimitRetryCount?: number;\n  localLlmRateLimitBackoffBaseMs?: number;\n  localLlmRateLimitBackoffMaxMs?: number;\n  localLlmMaxConcurrency?: number;\n}): LocalLlmRateLimitSettings {\n  const backoffBaseMs = Math.max(\n    1,\n    nonNegativeInt(config.localLlmRateLimitBackoffBaseMs, DEFAULT_RATE_LIMIT_BACKOFF_BASE_MS)\n  );\n  const backoffMaxMs = Math.max(\n    backoffBaseMs,\n    nonNegativeInt(config.localLlmRateLimitBackoffMaxMs, DEFAULT_RATE_LIMIT_BACKOFF_MAX_MS)\n  );\n  return {\n    retryCount: nonNegativeInt(config.localLlmRateLimitRetryCount, DEFAULT_RATE_LIMIT_RETRY_COUNT),\n    backoffBaseMs,\n    backoffMaxMs,\n    maxConcurrency: nonNegativeInt(config.localLlmMaxConcurrency, DEFAULT_MAX_CONCURRENCY),\n  };\n}\n\n/**\n * True for responses that mean \"the endpoint is saturated, slow down\":\n * 408/429/503, or a 5xx whose body carries LiteLLM's cooldown wording.\n * 400s are never rate limits (context-window errors mention fallbacks).\n */\nexport function isRateLimitedResponse(status: number, bodyText: string): boolean {\n  if (RATE_LIMIT_STATUSES.has(status)) return true;\n  return status >= 500 && RATE_LIMIT_BODY_PATTERN.test(bodyText);\n}\n\n/**\n * Parse an HTTP `Retry-After` value (RFC 9110: delta-seconds or HTTP-date).\n * Returns milliseconds to wait, or null when absent/invalid.\n */\nexport function parseRetryAfterMs(value: string | null | undefined, nowMs: number = Date.now()): number | null {\n  if (value === null || value === undefined) return null;\n  const trimmed = value.trim();\n  if (!trimmed) return null;\n  if (/^\\d+(\\.\\d+)?$/.test(trimmed)) {\n    return Math.min(MAX_RECORDED_BACKOFF_MS, Math.round(Number(trimmed) * 1000));\n  }\n  const dateMs = Date.parse(trimmed);\n  if (Number.isNaN(dateMs)) return null;\n  return Math.min(MAX_RECORDED_BACKOFF_MS, Math.max(0, dateMs - nowMs));\n}\n\n/** Parse LiteLLM's `Try again in N seconds` hint from an error body. */\nexport function parseTryAgainHintMs(bodyText: string): number | null {\n  const match = bodyText.match(TRY_AGAIN_PATTERN);\n  if (!match) return null;\n  const amount = Number(match[1]);\n  if (!Number.isFinite(amount)) return null;\n  const unit = match[2].toLowerCase();\n  let ms: number;\n  if (unit.startsWith(\"ms\") || unit.startsWith(\"milli\")) ms = amount;\n  else if (unit.startsWith(\"min\")) ms = amount * 60_000;\n  else ms = amount * 1000;\n  return Math.min(MAX_RECORDED_BACKOFF_MS, Math.round(ms));\n}\n\n/** Server-provided wait: `Retry-After` header first, then the body hint. */\nexport function serverRetryHintMs(\n  retryAfterHeader: string | null | undefined,\n  bodyText: string,\n  nowMs: number = Date.now()\n): number | null {\n  return parseRetryAfterMs(retryAfterHeader, nowMs) ?? parseTryAgainHintMs(bodyText);\n}\n\n/**\n * Exponential backoff with full jitter: uniform in [0, min(max, base * 2^(n-1))].\n * `attempt` is 1-based (the number of consecutive rate-limit responses).\n */\nexport function computeFullJitterBackoffMs(\n  attempt: number,\n  baseMs: number,\n  maxMs: number,\n  random: () => number = Math.random\n): number {\n  const exponent = Math.max(0, Math.min(30, attempt - 1));\n  const ceiling = Math.min(maxMs, baseMs * 2 ** exponent);\n  return Math.floor(random() * ceiling);\n}\n\n/**\n * Delay before the next attempt after a rate-limit response. A server hint\n * is a floor (never call earlier than asked); jitter is added on top of the\n * exponential term so synchronized callers spread out.\n */\nexport function computeRateLimitDelayMs(\n  attempt: number,\n  settings: Pick<LocalLlmRateLimitSettings, \"backoffBaseMs\" | \"backoffMaxMs\">,\n  serverHintMs: number | null,\n  random: () => number = Math.random\n): number {\n  const jittered = computeFullJitterBackoffMs(attempt, settings.backoffBaseMs, settings.backoffMaxMs, random);\n  return serverHintMs === null ? jittered : Math.max(serverHintMs, jittered);\n}\n\ntype Waiter = { highPriority: boolean; grant: () => void };\n\n/** FIFO semaphore; finite caps above one reserve a permit for recall-critical work. */\nexport class LocalLlmConcurrencyLimiter {\n  private active = 0;\n  private activeBackground = 0;\n  private max: number;\n  private readonly waiters: Waiter[] = [];\n\n  constructor(max: number) {\n    this.max = max;\n  }\n\n  setMax(max: number): void {\n    this.max = max;\n    this.pump();\n  }\n\n  get inFlight(): number {\n    return this.active;\n  }\n\n  get queued(): number {\n    return this.waiters.length;\n  }\n\n  /**\n   * Wait for a slot. Resolves to a release function, or null when the\n   * signal aborts first. `max <= 0` means unlimited.\n   */\n  acquire(\n    options: { highPriority?: boolean; signal?: AbortSignal; timeoutMs?: number } = {}\n  ): Promise<(() => void) | null> {\n    const { signal, timeoutMs } = options;\n    const highPriority = options.highPriority === true;\n    if (signal?.aborted) return Promise.resolve(null);\n    if (\n      this.canAcquire(highPriority) &&\n      (this.waiters.length === 0 || (highPriority && !this.waiters[0].highPriority))\n    ) {\n      this.active += 1;\n      if (!highPriority) this.activeBackground += 1;\n      return Promise.resolve(this.releaser(highPriority));\n    }\n    if (timeoutMs !== undefined && timeoutMs <= 0) return Promise.resolve(null);\n    return new Promise((resolve) => {\n      let timer: NodeJS.Timeout | undefined;\n      const waiter: Waiter = {\n        highPriority,\n        grant: () => {\n          signal?.removeEventListener(\"abort\", onAbort);\n          if (timer) clearTimeout(timer);\n          resolve(this.releaser(highPriority));\n        },\n      };\n      const onAbort = (): void => {\n        const index = this.waiters.indexOf(waiter);\n        if (index >= 0) this.waiters.splice(index, 1);\n        signal?.removeEventListener(\"abort\", onAbort);\n        if (timer) clearTimeout(timer);\n        resolve(null);\n      };\n      if (waiter.highPriority) {\n        const firstLow = this.waiters.findIndex((w) => !w.highPriority);\n        if (firstLow < 0) this.waiters.push(waiter);\n        else this.waiters.splice(firstLow, 0, waiter);\n      } else {\n        this.waiters.push(waiter);\n      }\n      signal?.addEventListener(\"abort\", onAbort, { once: true });\n      if (timeoutMs !== undefined) timer = setTimeout(onAbort, timeoutMs);\n    });\n  }\n\n  private canAcquire(highPriority: boolean): boolean {\n    return this.max <= 0 || (\n      this.active < this.max &&\n      (highPriority || this.max === 1 || this.activeBackground < this.max - 1)\n    );\n  }\n\n  private releaser(highPriority: boolean): () => void {\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      this.active -= 1;\n      if (!highPriority) this.activeBackground -= 1;\n      this.pump();\n    };\n  }\n\n  private pump(): void {\n    while (this.waiters.length > 0 && this.canAcquire(this.waiters[0].highPriority)) {\n      const next = this.waiters.shift();\n      if (!next) break;\n      this.active += 1;\n      if (!next.highPriority) this.activeBackground += 1;\n      next.grant();\n    }\n  }\n}\n\ninterface EndpointBackoffState {\n  untilMs: number;\n  consecutiveRateLimits: number;\n}\n\ninterface RateLimitGlobalState {\n  limiter: LocalLlmConcurrencyLimiter;\n  endpoints: Map<string, EndpointBackoffState>;\n}\n\ndeclare global {\n  // Shared across duplicated module copies in bundled output.\n  var __remnicLocalLlmRateLimitState: RateLimitGlobalState | undefined;\n}\n\nfunction globalState(): RateLimitGlobalState {\n  globalThis.__remnicLocalLlmRateLimitState ??= {\n    limiter: new LocalLlmConcurrencyLimiter(DEFAULT_MAX_CONCURRENCY),\n    endpoints: new Map(),\n  };\n  return globalThis.__remnicLocalLlmRateLimitState;\n}\n\n/** Process-wide limiter, resized to the caller's configured cap. */\nexport function getLocalLlmConcurrencyLimiter(maxConcurrency: number): LocalLlmConcurrencyLimiter {\n  const { limiter } = globalState();\n  limiter.setMax(maxConcurrency);\n  return limiter;\n}\n\n/** Milliseconds until `endpoint` may be called again (0 when clear). */\nexport function endpointBackoffRemainingMs(endpoint: string, nowMs: number = Date.now()): number {\n  const entry = globalState().endpoints.get(endpoint);\n  return entry ? Math.max(0, entry.untilMs - nowMs) : 0;\n}\n\n/**\n * Record a rate-limit response for `endpoint`. Returns the consecutive\n * rate-limit count (1-based) to feed the backoff exponent.\n */\nexport function noteEndpointRateLimited(endpoint: string): number {\n  const { endpoints } = globalState();\n  const entry = endpoints.get(endpoint) ?? { untilMs: 0, consecutiveRateLimits: 0 };\n  entry.consecutiveRateLimits += 1;\n  endpoints.set(endpoint, entry);\n  return entry.consecutiveRateLimits;\n}\n\n/** Push the endpoint's \"do not call before\" deadline out to at least `nowMs + delayMs`. */\nexport function extendEndpointBackoff(endpoint: string, delayMs: number, nowMs: number = Date.now()): void {\n  const { endpoints } = globalState();\n  const entry = endpoints.get(endpoint) ?? { untilMs: 0, consecutiveRateLimits: 0 };\n  const bounded = Math.min(MAX_RECORDED_BACKOFF_MS, Math.max(0, delayMs));\n  entry.untilMs = Math.max(entry.untilMs, nowMs + bounded);\n  endpoints.set(endpoint, entry);\n}\n\n/**\n * Reset the backoff exponent after a non-rate-limited response. An already\n * recorded deadline is left to expire so concurrent callers that saw the\n * 429 still wait it out.\n */\nexport function noteEndpointRecovered(endpoint: string): void {\n  const entry = globalState().endpoints.get(endpoint);\n  if (entry) entry.consecutiveRateLimits = 0;\n}\n\n/** Test seam: drop all process-wide state. */\nexport function resetLocalLlmRateLimitStateForTests(): void {\n  const state = globalState();\n  state.endpoints.clear();\n  state.limiter = new LocalLlmConcurrencyLimiter(DEFAULT_MAX_CONCURRENCY);\n}\n\nexport type RateLimitAttemptGate =\n  | { kind: \"go\"; release: () => void }\n  | { kind: \"aborted\" }\n  | { kind: \"skip\"; reason: \"backoff\" | \"queue\"; remainingMs: number };\n\nexport type RateLimitDecision =\n  | { kind: \"not-rate-limited\" }\n  | { kind: \"retry\"; delayMs: number; hintMs: number | null; consecutive: number; retry: number }\n  | { kind: \"give-up\"; delayMs: number; retries: number };\n\n/**\n * Per-request driver for the rate-limit policy. The client calls\n * `beforeAttempt` ahead of every HTTP attempt (waits out the shared endpoint\n * deadline, then takes a concurrency slot) and `onResponse` after every\n * non-ok response.\n */\nexport class LocalLlmRateLimitSession {\n  private retries = 0;\n  private readonly limiter: LocalLlmConcurrencyLimiter;\n  readonly settings: LocalLlmRateLimitSettings;\n\n  /**\n   * @param waitBudgetMs the caller's per-attempt time budget. Waiting for the\n   * endpoint backoff or a concurrency slot never exceeds it, and a backoff\n   * longer than it skips the request instead (fail open to the caller).\n   */\n  constructor(\n    private readonly endpoint: string,\n    settings: LocalLlmRateLimitSettings,\n    private readonly highPriority: boolean,\n    private readonly waitBudgetMs: number = settings.backoffMaxMs\n  ) {\n    this.settings = settings;\n    this.limiter = getLocalLlmConcurrencyLimiter(settings.maxConcurrency);\n  }\n\n  get retryCount(): number {\n    return this.retries;\n  }\n\n  async beforeAttempt(signal?: AbortSignal): Promise<RateLimitAttemptGate> {\n    const deadlineMs = Date.now() + Math.max(0, this.waitBudgetMs);\n    // Recheck the shared deadline after every async wait: another attempt may\n    // have recorded or extended a cooldown while this one slept or queued.\n    for (;;) {\n      const remainingMs = endpointBackoffRemainingMs(this.endpoint);\n      if (remainingMs > 0) {\n        if (remainingMs > Math.min(this.settings.backoffMaxMs, deadlineMs - Date.now())) {\n          return { kind: \"skip\", reason: \"backoff\", remainingMs };\n        }\n        if (!(await waitWithSignal(remainingMs, signal))) return { kind: \"aborted\" };\n        continue;\n      }\n      const release = await this.limiter.acquire({\n        highPriority: this.highPriority,\n        signal,\n        timeoutMs: deadlineMs - Date.now(),\n      });\n      if (!release) return signal?.aborted ? { kind: \"aborted\" } : { kind: \"skip\", reason: \"queue\", remainingMs: 0 };\n      if (endpointBackoffRemainingMs(this.endpoint) > 0) {\n        release();\n        continue;\n      }\n      return { kind: \"go\", release };\n    }\n  }\n\n  onSuccess(): void {\n    noteEndpointRecovered(this.endpoint);\n  }\n\n  onResponse(status: number, retryAfterHeader: string | null | undefined, bodyText: string): RateLimitDecision {\n    if (!isRateLimitedResponse(status, bodyText)) {\n      noteEndpointRecovered(this.endpoint);\n      return { kind: \"not-rate-limited\" };\n    }\n    const consecutive = noteEndpointRateLimited(this.endpoint);\n    const hintMs = serverRetryHintMs(retryAfterHeader, bodyText);\n    const delayMs = computeRateLimitDelayMs(consecutive, this.settings, hintMs);\n    extendEndpointBackoff(this.endpoint, delayMs);\n    if (this.retries >= this.settings.retryCount || delayMs > Math.min(this.settings.backoffMaxMs, this.waitBudgetMs)) {\n      return { kind: \"give-up\", delayMs, retries: this.retries };\n    }\n    this.retries += 1;\n    return { kind: \"retry\", delayMs, hintMs, consecutive, retry: this.retries };\n  }\n}\n\nfunction waitWithSignal(ms: number, signal?: AbortSignal): Promise<boolean> {\n  return new Promise((resolve) => {\n    if (signal?.aborted) {\n      resolve(false);\n      return;\n    }\n    const onAbort = (): void => {\n      clearTimeout(timer);\n      resolve(false);\n    };\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve(true);\n    }, ms);\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-LGR54NYT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/orchestration/extraction-run-helpers.ts","../src/orchestration/extraction-run.ts","../src/orchestration/extraction-origin-context.ts"],"sourcesContent":["import type { BufferTurn, ExtractionFailureClass, ExtractionResult, MetaState } from \"../types.js\";\nimport type { StorageManager } from \"../index.js\";\nimport { log } from \"../logger.js\";\n\nexport function combineExtractionAbortSignals(\n  primary: AbortSignal | undefined,\n  deadlineController: AbortController | undefined,\n): AbortSignal | undefined {\n  if (!deadlineController) return primary;\n  return primary ? AbortSignal.any([primary, deadlineController.signal]) : deadlineController.signal;\n}\n\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport function deriveTopicsFromExtraction(result: ExtractionResult): string[] {\n  if (!isRecord(result)) return [];\n  const topics = new Set<string>();\n  const facts = Array.isArray(result.facts) ? result.facts : [];\n  for (const rawFact of facts) {\n    if (!isRecord(rawFact)) continue;\n    const tags = Array.isArray(rawFact.tags) ? rawFact.tags : [];\n    for (const tag of tags) {\n      if (typeof tag === \"string\" && tag.length >= 2) topics.add(tag.toLowerCase());\n    }\n    if (typeof rawFact.entityRef === \"string\" && rawFact.entityRef.length >= 2) {\n      topics.add(rawFact.entityRef.toLowerCase());\n    }\n    if (typeof rawFact.category === \"string\" && rawFact.category.length > 0) {\n      topics.add(rawFact.category);\n    }\n  }\n  const entities = Array.isArray(result.entities) ? result.entities : [];\n  for (const rawEntity of entities) {\n    if (!isRecord(rawEntity)) continue;\n    if (typeof rawEntity.name === \"string\" && rawEntity.name.length >= 2) {\n      topics.add(rawEntity.name.toLowerCase());\n    }\n  }\n  return [...topics].slice(0, 16);\n}\n\n/** Bounded cap on persisted per-fingerprint retry-state entries (per namespace meta). */\nexport const EXTRACTION_RETRY_STATE_MAX_ENTRIES = 500;\n\nexport interface ExtractionRetryStateEntry {\n  attempts: number;\n  nextEligibleAtMs: number;\n  firstFailedAtMs: number;\n  lastFailureClass: ExtractionFailureClass;\n}\n\nexport interface ExtractionResilienceStatus {\n  breaker: {\n    state: \"closed\" | \"open\" | \"half_open\";\n    openUntilMs: number;\n    consecutiveFailures: number;\n    lastReason: string;\n  };\n  backoffFingerprintCount: number;\n}\n\n/**\n * Pure backoff scheduler. Returns the absolute ms timestamp at which a\n * fingerprint that has failed `attempts` times becomes eligible again:\n * exponential via the configured schedule, clamped to `maxBackoffMs`, with\n * ±`jitterRatio` multiplicative jitter. `rng` is injectable for deterministic\n * tests. Never returns a timestamp before `now`.\n */\nexport function computeExtractionRetryNextEligibleMs(\n  attempts: number,\n  scheduleMs: readonly number[],\n  maxBackoffMs: number,\n  jitterRatio: number,\n  now: number,\n  rng: () => number = Math.random,\n): number {\n  if (!Number.isFinite(attempts) || !Number.isInteger(attempts) || attempts < 1) {\n    throw new RangeError(\"attempts must be a finite integer >= 1\");\n  }\n  if (!Number.isFinite(maxBackoffMs) || maxBackoffMs < 0) {\n    throw new RangeError(\"maxBackoffMs must be a finite number >= 0\");\n  }\n  if (!Number.isFinite(jitterRatio) || jitterRatio < 0 || jitterRatio > 1) {\n    throw new RangeError(\"jitterRatio must be a finite number in [0, 1]\");\n  }\n  const safeNow = Number.isFinite(now) ? now : 0;\n  const cap = maxBackoffMs;\n  if (!Array.isArray(scheduleMs) || scheduleMs.length === 0) {\n    return safeNow + cap;\n  }\n  const idx = Math.min(attempts - 1, scheduleMs.length - 1);\n  const step = scheduleMs[idx];\n  const base = Math.min(typeof step === \"number\" && Number.isFinite(step) && step > 0 ? step : cap, cap);\n  const randomValue = rng();\n  if (!Number.isFinite(randomValue) || randomValue < 0 || randomValue > 1) {\n    throw new RangeError(\"rng() must return a finite number in [0, 1]\");\n  }\n  const jitter = 1 + (randomValue * 2 - 1) * jitterRatio;\n  return safeNow + Math.max(0, Math.round(base * jitter));\n}\n\n/**\n * Cap the persisted retry-state array to the newest `maxEntries` by\n * firstFailedAt. Guards invalid caps so they cannot turn `slice(-maxEntries)`\n * into an unbounded copy (AGENTS.md rule 17).\n */\nexport function capExtractionRetryStateEntries<T extends { firstFailedAt: string }>(\n  entries: readonly T[],\n  maxEntries: number,\n): T[] {\n  if (!Number.isFinite(maxEntries) || !Number.isInteger(maxEntries) || maxEntries <= 0) return [];\n  const sorted = [...entries].sort((a, b) => a.firstFailedAt.localeCompare(b.firstFailedAt));\n  return sorted.slice(-maxEntries);\n}\n\n/**\n * Derive a single `sourceConnector` from a batch of turns.\n * Returns the connector ONLY when ALL turns carry the same connector.\n * Mixed tagged/untagged batches return undefined — extraction facts are\n * persisted at batch level, so attributing them to the single tagged\n * connector would falsely label facts from untagged turns.\n * Conflicting connectors (different values) also return undefined.\n */\nexport function deriveSourceConnector(turns: readonly BufferTurn[]): string | undefined {\n  if (turns.length === 0) return undefined;\n  const connectors = new Set<string>();\n  let untaggedCount = 0;\n  for (const turn of turns) {\n    if (typeof turn.sourceConnector === \"string\" && turn.sourceConnector.length > 0) {\n      connectors.add(turn.sourceConnector);\n    } else {\n      untaggedCount += 1;\n    }\n  }\n  // All turns must agree on the same connector — no untagged turns mixed in.\n  if (untaggedCount > 0) return undefined;\n  return connectors.size === 1 ? [...connectors][0] : undefined;\n}\n\nexport async function runExtractionPostPersistBestEffort(\n  runDeadlineAware: (\n    operation: () => Promise<unknown>,\n    phase: string,\n    clearTimerOnError?: boolean,\n    options?: { ignoreAbort?: boolean; ignoreDeadline?: boolean },\n  ) => Promise<unknown>,\n  stage: string,\n  operation: () => Promise<unknown>,\n  options?: { ignoreAbort?: boolean; ignoreDeadline?: boolean; propagateErrors?: boolean },\n): Promise<void> {\n  try {\n    await runDeadlineAware(operation, stage, false, {\n      ignoreAbort: options?.ignoreAbort,\n      ignoreDeadline: options?.ignoreDeadline,\n    });\n  } catch (error) {\n    if (options?.propagateErrors) throw error;\n    log.warn(`runExtraction: ${stage} failed after persistence (non-fatal)`, error);\n  }\n}\n\n/**\n * Applies deferred-judge retention only to live, non-shadow extraction runs.\n * Replay/import paths must not synthesize live-buffer entries after persistence.\n */\nexport interface ExtractionDeferRetentionOptions {\n  clearBufferAfterExtraction: boolean;\n  extractionJudgeShadow: boolean;\n  getDeferredCount: () => number;\n  normalizedTurns: BufferTurn[];\n  bufferKey: string;\n  retainDeferredTurns: (bufferKey: string, turns: BufferTurn[], max: number) => Promise<void>;\n}\n\nexport async function runExtractionDeferRetention(\n  runPostPersistBestEffort: (\n    stage: string,\n    operation: () => Promise<unknown>,\n    options?: { ignoreAbort?: boolean },\n  ) => Promise<void>,\n  options: ExtractionDeferRetentionOptions,\n): Promise<void> {\n  await runPostPersistBestEffort(\"during_defer_retention\", async () => {\n    if (options.clearBufferAfterExtraction && !options.extractionJudgeShadow) {\n      const deferredCount = options.getDeferredCount();\n      if (deferredCount > 0 && options.normalizedTurns.length > 0) {\n        await options.retainDeferredTurns(options.bufferKey, options.normalizedTurns, 10);\n      } else {\n        await options.retainDeferredTurns(options.bufferKey, [], 0);\n      }\n    }\n  });\n}\n\nexport interface ExtractionPostPersistOptions {\n  result: ExtractionResult;\n  storage: StorageManager;\n  meta?: MetaState;\n  extractionFingerprint?: string;\n  shouldPersistProcessedFingerprint: boolean;\n  recordProcessedExtractionFingerprint: (\n    storage: StorageManager,\n    fingerprint: string,\n    meta: MetaState,\n  ) => Promise<void>;\n  runDeadlineAware: (\n    operation: () => Promise<unknown>,\n    phase: string,\n    clearTimerOnError?: boolean,\n    options?: { ignoreAbort?: boolean; ignoreDeadline?: boolean },\n  ) => Promise<unknown>;\n  isDeadlineError: (error: unknown) => boolean;\n  createDeadlineError: (stage: string) => Error;\n  deadlineMs?: number;\n  clearBufferAfterExtraction: boolean;\n  runPostPersistBestEffort: (\n    stage: string,\n    operation: () => Promise<unknown>,\n    options?: { ignoreAbort?: boolean; ignoreDeadline?: boolean; propagateErrors?: boolean },\n  ) => Promise<void>;\n  extractionJudgeShadow: boolean;\n  getDeferredCount: () => number;\n  normalizedTurns: BufferTurn[];\n  bufferKey: string;\n  retainDeferredTurns: (bufferKey: string, turns: BufferTurn[], max: number) => Promise<void>;\n  clearBuffer: (options?: { ignoreAbort?: boolean }) => Promise<void>;\n  failOnExtractionFailure: boolean;\n}\n\nexport interface ExtractionPostPersistResult {\n  meta?: MetaState;\n  metadataFailed: boolean;\n}\n\nexport async function runExtractionPostPersist(\n  options: ExtractionPostPersistOptions,\n): Promise<ExtractionPostPersistResult> {\n  let metadataFailed = false;\n  let deadlineError: Error | undefined;\n  const recordFailure = (stage: string, error: unknown): void => {\n    metadataFailed = true;\n    if (options.isDeadlineError(error) && deadlineError === undefined) {\n      deadlineError = error as Error;\n    }\n    log.warn(`runExtraction: ${stage} failed after durable persistence; continuing with buffer clear`, error);\n  };\n  let meta = options.meta;\n  try {\n    meta ??= (await options.runDeadlineAware(\n      () => options.storage.loadMeta(),\n      \"during_post_persist_load_meta\",\n      false,\n    )) as MetaState;\n  } catch (error) {\n    recordFailure(\"metadata load\", error);\n  }\n  if (meta && options.extractionFingerprint && options.shouldPersistProcessedFingerprint) {\n    try {\n      await options.runDeadlineAware(\n        () => options.recordProcessedExtractionFingerprint(options.storage, options.extractionFingerprint!, meta!),\n        \"during_post_persist_fingerprint\",\n        false,\n      );\n    } catch (error) {\n      recordFailure(\"processed fingerprint\", error);\n    }\n  }\n  if (meta) {\n    meta.extractionCount += 1;\n    meta.lastExtractionAt = new Date().toISOString();\n    meta.totalMemories += Array.isArray(options.result.facts) ? options.result.facts.length : 0;\n    meta.totalEntities += Array.isArray(options.result.entities) ? options.result.entities.length : 0;\n    try {\n      await options.runDeadlineAware(\n        () => options.storage.saveMeta(meta!),\n        \"during_post_persist_meta_save\",\n        false,\n      );\n    } catch (error) {\n      recordFailure(\"metadata save\", error);\n    }\n  }\n  const runBestEffort = options.runPostPersistBestEffort;\n  await runExtractionDeferRetention(runBestEffort, {\n    clearBufferAfterExtraction: options.clearBufferAfterExtraction,\n    extractionJudgeShadow: options.extractionJudgeShadow,\n    getDeferredCount: options.getDeferredCount,\n    normalizedTurns: options.normalizedTurns,\n    bufferKey: options.bufferKey,\n    retainDeferredTurns: options.retainDeferredTurns,\n  });\n  await runBestEffort(\n    \"during_buffer_clear\",\n    () => options.clearBuffer({ ignoreAbort: true }),\n    {\n      ignoreAbort: true,\n      ignoreDeadline: options.failOnExtractionFailure,\n      propagateErrors: options.failOnExtractionFailure,\n    },\n  );\n  if (options.failOnExtractionFailure && typeof options.deadlineMs === \"number\" && Date.now() >= options.deadlineMs) {\n    throw options.createDeadlineError(\"during_buffer_clear\");\n  }\n  if (deadlineError) throw deadlineError;\n  return { meta, metadataFailed };\n}\n\n/**\n * Record a processed fingerprint when applicable and advance the extraction\n * liveness watermark only for a provider-backed empty success. Fingerprinted\n * imports treat the metadata save as load-bearing dedupe state; normal live\n * runs treat the stamp as diagnostic and fail open. Deadline errors always\n * propagate.\n */\nexport async function commitEmptySuccessExtraction(args: {\n  storage: StorageManager;\n  meta: MetaState | null;\n  extractionFingerprint: string | null;\n  shouldPersistProcessedFingerprint: boolean;\n  hasExtractionFailure: boolean;\n  extractionSkippedReason: ExtractionResult[\"extractionSkippedReason\"];\n  recordProcessedExtractionFingerprint: (storage: StorageManager, fingerprint: string, meta: MetaState) => Promise<unknown>;\n  runDeadlineAware: <T>(operation: () => Promise<T>, phase: string, clearTimerOnError?: boolean) => Promise<T>;\n  isDeadlineError: (error: unknown) => boolean;\n}): Promise<void> {\n  const {\n    storage,\n    meta: existingMeta,\n    extractionFingerprint,\n    shouldPersistProcessedFingerprint,\n    hasExtractionFailure,\n    extractionSkippedReason,\n    recordProcessedExtractionFingerprint,\n    runDeadlineAware,\n    isDeadlineError,\n  } = args;\n  const shouldRecordFingerprint =\n    extractionFingerprint !== null &&\n    shouldPersistProcessedFingerprint &&\n    !hasExtractionFailure;\n  const shouldStampLiveness =\n    !hasExtractionFailure && extractionSkippedReason === undefined;\n  if (!shouldRecordFingerprint && !shouldStampLiveness) return;\n\n  const metadataFailureIsFatal = shouldRecordFingerprint;\n  try {\n    const meta =\n      existingMeta ??\n      await runDeadlineAware(\n        () => storage.loadMeta(),\n        \"during_empty_success_liveness_load\",\n        false,\n      );\n    if (shouldRecordFingerprint) {\n      await recordProcessedExtractionFingerprint(storage, extractionFingerprint, meta);\n    }\n    if (shouldStampLiveness) {\n      meta.extractionCount += 1;\n      meta.lastExtractionAt = new Date().toISOString();\n    }\n    await runDeadlineAware(\n      () => storage.saveMeta(meta),\n      \"during_empty_success_liveness_save\",\n      false,\n    );\n  } catch (err) {\n    if (isDeadlineError(err)) throw err;\n    if (metadataFailureIsFatal) throw err;\n    log.warn(\"runExtraction: failed to stamp empty-success liveness watermark (non-fatal)\", err);\n  }\n}\n","/**\n * Buffer → extract → persist coordinator (issue #1526, seam 15).\n * Owns runExtraction, shouldQueueExtraction, buildExtractionFingerprint,\n * normalizeExtractionFingerprintTurns and recordProcessedExtractionFingerprint.\n * The orchestrator delegates here and retains cross-subsystem routing,\n * persistence and post-write side effects via injected dependencies.\n * Extracted from orchestrator.ts without behavior changes.\n */\n\nimport { createHash } from \"node:crypto\";\nimport type { StorageManager } from \"../index.js\";\nimport { NamespaceStorageRouter } from \"../namespaces/storage.js\";\nimport type { ExtractionEngine } from \"../extraction.js\";\nimport type { SmartBuffer } from \"../buffer.js\";\nimport type { ThreadingManager } from \"../threading.js\";\nimport type { BoxBuilder } from \"../boxes.js\";\nimport { resolvePrincipal, defaultNamespaceForPrincipal } from \"../namespaces/principal.js\";\nimport { resolveScopeProfilePlan, type ResolvedScopeProfilePlan } from \"../namespaces/scope-profiles.js\";\nimport { resolveCodingNamespaceOverlay } from \"../coding/coding-namespace.js\";\nimport type { CodingContext } from \"../types.js\";\nimport { deriveExtractionOriginContext, type ExtractionSourceContext } from \"./extraction-origin-context.js\";\nimport {\n  resolvePresentationCapabilities,\n  resolveMemoryLifecycleCapabilities,\n  type GraphConstructionCapabilitySet,\n  type MemoryLifecycleCapabilitySet,\n} from \"../capabilities.js\";\nimport { parseFlexibleIsoTimestamp } from \"../utils/iso-timestamp.js\";\nimport { tagPersistedMemories } from \"../location/tagging.js\";\nimport { log } from \"../logger.js\";\nimport { emitExtractionLlmFailureError, recordExtractionLlmFailure, recordExtractionLlmSuccess } from \"../extraction-llm-health.js\";\nimport type { PluginConfig, BufferTurn, ExtractionResult, MetaState, ExtractionFailureClass } from \"../types.js\";\nimport type { TierMigrationCycleSummary } from \"../recall-state.js\";\n\nexport interface ExtractionRunResult {\n  status: \"completed\" | \"skipped\";\n  reason?: string;\n  persistedCount: number;\n  durableOutputCount: number;\n  postPersistMetadataFailed?: boolean;\n}\n\nexport class ExtractionDeadlineError extends Error {\n  readonly stage: string;\n\n  constructor(stage: string) {\n    super(`replay extraction deadline exceeded (${stage})`);\n    this.name = \"ExtractionDeadlineError\";\n    this.stage = stage;\n  }\n}\n\n/** Dependencies injected by the orchestrator. All stable references or\n *  live accessors — lazy getters for anything tests reassign\n *  post-construction (buffer, extraction, storageRouter, threading). */\nexport interface ExtractionRunCoordinatorDeps {\n  config: PluginConfig;\n  getBuffer: () => SmartBuffer;\n  getExtraction: () => Pick<ExtractionEngine, \"extract\">;\n  getStorageRouter: () => Pick<NamespaceStorageRouter, \"storageFor\">;\n  getThreading: () => Pick<ThreadingManager, \"processTurn\" | \"updateThreadTitle\">;\n\n  persistExtraction: (\n    result: ExtractionResult,\n    storage: StorageManager,\n    threadIdForExtraction?: string | null,\n    sourceContext?: ExtractionSourceContext,\n    baseNamespace?: string,\n    scopeProfileWritePlan?: ResolvedScopeProfilePlan | null,\n    sourceText?: string,\n    graphCaps?: GraphConstructionCapabilitySet,\n    lifecycleCaps?: MemoryLifecycleCapabilitySet\n  ) => Promise<{ persistedIds: string[]; memoryPathById: Map<string, string> }>;\n\n  maybeCapturePassiveCorrections: (\n    turns: readonly BufferTurn[],\n    opts: {\n      sessionKey: string;\n      principal?: string;\n      namespace: string;\n      bufferKey: string;\n      isLiveSession: boolean;\n      abortSignal?: AbortSignal;\n    }\n  ) => Promise<void>;\n\n  resolveSelfNamespace: (sessionKey?: string) => string;\n  getCodingContextForSession: (sessionKey: string) => CodingContext | null;\n  applyCodingNamespaceOverlay: (sessionKey: string, namespace: string) => string;\n  boxBuilderFor: (storage: StorageManager) => Pick<BoxBuilder, \"onExtraction\">;\n  appendPersistedThreadEpisodes: (threadId: string, ids: string[]) => Promise<void>;\n  maybeScheduleConsolidation: (nonZero: boolean) => void;\n  requestQmdMaintenance: () => void;\n  runTierMigrationCycle: (\n    storage: StorageManager,\n    trigger: \"extraction\" | \"maintenance\" | \"manual\",\n    options?: {\n      dryRun?: boolean;\n      limitOverride?: number;\n      force?: boolean;\n    }\n  ) => Promise<TierMigrationCycleSummary>;\n  getLastPersistExtractionDeferredCount: () => number;\n  recordProcessedExtractionFingerprint: (\n    storage: StorageManager,\n    fingerprint: string,\n    preloadedMeta?: Awaited<ReturnType<StorageManager[\"loadMeta\"]>>\n  ) => Promise<void>;\n}\n\n// Recall/extraction abort helpers live in orchestrator-helpers.ts since\n// #1526 seam 25; this file previously carried duplicate copies\n// (AGENTS.md rule 8 — no duplicated helpers).\nimport { raceRecallAbort, throwIfRecallAborted } from \"./orchestrator-helpers.js\";\nimport {\n  capExtractionRetryStateEntries,\n  combineExtractionAbortSignals,\n  commitEmptySuccessExtraction,\n  computeExtractionRetryNextEligibleMs,\n  deriveSourceConnector,\n  deriveTopicsFromExtraction,\n  runExtractionPostPersist,\n  runExtractionPostPersistBestEffort,\n  EXTRACTION_RETRY_STATE_MAX_ENTRIES,\n} from \"./extraction-run-helpers.js\";\nimport type { ExtractionResilienceStatus, ExtractionRetryStateEntry } from \"./extraction-run-helpers.js\";\n\nexport {\n  capExtractionRetryStateEntries,\n  computeExtractionRetryNextEligibleMs,\n  deriveSourceConnector,\n  deriveTopicsFromExtraction,\n};\nexport type { ExtractionResilienceStatus };\n\n/**\n * Coordinates the extraction run pipeline. Holds the dedupe fingerprint\n * cache (`recentExtractionFingerprints`) and delegates all side effects\n * to injected orchestrator methods.\n */\nexport class ExtractionRunCoordinator {\n  private readonly recentExtractionFingerprints = new Map<string, number>();\n  // Per-fingerprint extraction retry/backoff state (extraction hot-loop\n  // hardening). Outer key = namespace, inner key = fingerprint. Hydrated lazily\n  // from namespace-scoped meta so the hot path is a Map lookup; persisted back\n  // to meta on change (restart-safe, cross-process coherent via the shared\n  // meta.json). The breaker below is intentionally per-process in-memory\n  // (mirrors local-llm.cooldownUntilMs); a restart clears it but the persisted\n  // backoff still throttles, so a restart can't resurrect the hot loop.\n  private readonly extractionRetryState = new Map<string, Map<string, ExtractionRetryStateEntry>>();\n  private readonly hydratedRetryNamespaces = new Set<string>();\n  private providerBreaker: {\n    consecutiveFailures: number;\n    openUntilMs: number;\n    state: \"closed\" | \"open\" | \"half_open\";\n    lastReason: string;\n  } = { consecutiveFailures: 0, openUntilMs: 0, state: \"closed\", lastReason: \"\" };\n\n  constructor(private readonly deps: ExtractionRunCoordinatorDeps) {}\n\n  private get config(): PluginConfig {\n    return this.deps.config;\n  }\n\n  // -------------------------------------------------------------------------\n  // Source-valid-at helpers (moved from orchestrator.ts module scope)\n  // -------------------------------------------------------------------------\n\n  private latestSourceValidAtFromTurns(turns: readonly BufferTurn[]): string | undefined {\n    let latestMs: number | null = null;\n    for (const turn of turns) {\n      if (turn.extractionContextOnly === true) continue;\n      if (typeof turn.sourceValidAt !== \"string\") continue;\n      const parsed = parseFlexibleIsoTimestamp(turn.sourceValidAt.trim());\n      if (parsed === null) continue;\n      if (latestMs === null || parsed > latestMs) {\n        latestMs = parsed;\n      }\n    }\n    return latestMs === null ? undefined : new Date(latestMs).toISOString();\n  }\n\n  // -------------------------------------------------------------------------\n  // Extraction dedupe fingerprint helpers\n  // -------------------------------------------------------------------------\n\n  normalizeExtractionFingerprintTurns(turns: BufferTurn[]): string[] {\n    if (!Array.isArray(turns) || turns.length === 0) return [];\n    return turns\n      .filter((turn) => turn.role === \"user\" || turn.role === \"assistant\")\n      .map((turn) => {\n        if (typeof turn.turnFingerprint === \"string\" && turn.turnFingerprint.length > 0) {\n          return `fp:${turn.turnFingerprint}`;\n        }\n        return `${turn.role}:${(turn.content ?? \"\").replace(/\\s+/g, \" \").trim().slice(0, this.config.extractionMaxTurnChars)}`;\n      })\n      .filter((value) => value.length > 0);\n  }\n\n  buildExtractionFingerprint(turns: BufferTurn[], bufferKey: string): string | null {\n    const normalized = this.normalizeExtractionFingerprintTurns(turns).join(\"\\n\");\n    if (!normalized) return null;\n    return createHash(\"sha256\").update(`${bufferKey}\\n${normalized}`).digest(\"hex\");\n  }\n\n  shouldQueueExtraction(turns: BufferTurn[], options: { commit?: boolean; bufferKey?: string } = {}): boolean {\n    const lifecycleCaps = resolveMemoryLifecycleCapabilities(this.config);\n    if (!lifecycleCaps.extractionDedupe) return true;\n    if (!Array.isArray(turns) || turns.length === 0) return false;\n\n    const bufferKey = options.bufferKey ?? turns[0]?.sessionKey ?? \"default\";\n    const fingerprint = this.buildExtractionFingerprint(turns, bufferKey);\n    if (!fingerprint) return false;\n    const now = Date.now();\n    const seenAt = this.recentExtractionFingerprints.get(fingerprint);\n    if (seenAt && now - seenAt < this.config.extractionDedupeWindowMs) {\n      log.debug(\"extraction dedupe: skipped duplicate buffered turn set\");\n      return false;\n    }\n\n    if (options.commit !== false) {\n      this.recentExtractionFingerprints.set(fingerprint, now);\n    }\n    // Keep this cache bounded to avoid unbounded growth.\n    if (options.commit !== false && this.recentExtractionFingerprints.size > 200) {\n      const entries = Array.from(this.recentExtractionFingerprints.entries()).sort((a, b) => a[1] - b[1]);\n      for (const [key] of entries.slice(0, entries.length - 200)) {\n        this.recentExtractionFingerprints.delete(key);\n      }\n    }\n\n    return true;\n  }\n\n  // -------------------------------------------------------------------------\n  // Processed-fingerprint recording\n  // -------------------------------------------------------------------------\n\n  async recordProcessedExtractionFingerprint(\n    storage: StorageManager,\n    fingerprint: string,\n    preloadedMeta?: Awaited<ReturnType<StorageManager[\"loadMeta\"]>>\n  ): Promise<void> {\n    const meta = preloadedMeta ?? (await storage.loadMeta());\n    const observedAt = new Date().toISOString();\n    const seen = new Map(\n      (meta.processedExtractionFingerprints ?? []).map((entry) => [entry.fingerprint, entry.observedAt])\n    );\n    seen.set(fingerprint, observedAt);\n    meta.processedExtractionFingerprints = Array.from(seen.entries())\n      .map(([value, at]) => ({ fingerprint: value, observedAt: at }))\n      .sort((left, right) => left.observedAt.localeCompare(right.observedAt))\n      .slice(-500);\n    if (!preloadedMeta) {\n      await storage.saveMeta(meta);\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Extraction retry/backoff + circuit breaker (extraction hot-loop hardening)\n  // -------------------------------------------------------------------------\n\n  /** Lazily hydrate the in-memory retry-state mirror for a namespace from meta.\n   *  One-time per namespace per coordinator; the hot path is then a Map lookup.\n   *  Cross-process coherence: a fresh coordinator hydrates from the shared\n   *  meta.json, so a failure persisted by another process is honored here. */\n  private hydrateRetryStateFromMeta(namespace: string, meta: MetaState): void {\n    if (this.hydratedRetryNamespaces.has(namespace)) return;\n    this.hydratedRetryNamespaces.add(namespace);\n    const nsMap = this.extractionRetryState.get(namespace) ?? new Map<string, ExtractionRetryStateEntry>();\n    for (const entry of meta.extractionRetryState ?? []) {\n      const nextEligibleAtMs = Date.parse(entry.nextEligibleAt);\n      const firstFailedAtMs = Date.parse(entry.firstFailedAt);\n      nsMap.set(entry.fingerprint, {\n        attempts: entry.attempts,\n        nextEligibleAtMs: Number.isFinite(nextEligibleAtMs) ? nextEligibleAtMs : 0,\n        firstFailedAtMs: Number.isFinite(firstFailedAtMs) ? firstFailedAtMs : Date.now(),\n        lastFailureClass: entry.lastFailureClass,\n      });\n    }\n    this.extractionRetryState.set(namespace, nsMap);\n  }\n\n  private logBreakerTransition(state: \"closed\" | \"open\" | \"half_open\"): void {\n    // Once per state change (not per attempt) — AGENTS.md observability rule.\n    log.warn(\"extraction: provider circuit breaker transition\", {\n      state,\n      consecutiveFailures: this.providerBreaker.consecutiveFailures,\n      lastReason: this.providerBreaker.lastReason,\n      openUntilMs: this.providerBreaker.openUntilMs,\n    });\n  }\n\n  /** True while the breaker suppresses non-forced attempts. Flips an expired\n   *  `open` breaker to `half_open`, which allows exactly one probe (the next\n   *  non-forced attempt) because the extraction queue is a serial drain. */\n  private isProviderBreakerOpen(now: number): boolean {\n    if (now < this.providerBreaker.openUntilMs) return true;\n    if (this.providerBreaker.state === \"open\") {\n      this.providerBreaker.state = \"half_open\";\n      this.logBreakerTransition(\"half_open\");\n    }\n    return false;\n  }\n\n  private onProviderFailure(cls: ExtractionFailureClass, now: number): void {\n    this.providerBreaker.consecutiveFailures += 1;\n    const trip =\n      cls === \"auth_config\" ||\n      // A failed half-open probe re-opens immediately (standard breaker\n      // semantics). Without this, an auth_config-opened breaker (which trips\n      // below the threshold) would get stuck half_open after a transient\n      // probe failure and stop suppressing (cursor review).\n      this.providerBreaker.state === \"half_open\" ||\n      this.providerBreaker.consecutiveFailures >= this.config.extractionBreakerFailureThreshold;\n    if (!trip) return;\n    const cooldown =\n      cls === \"auth_config\"\n        ? this.config.extractionBreakerAuthCooldownMs\n        : this.config.extractionBreakerCooldownMs;\n    this.providerBreaker.openUntilMs = now + Math.max(0, cooldown);\n    this.providerBreaker.lastReason = cls;\n    if (this.providerBreaker.state !== \"open\") {\n      this.providerBreaker.state = \"open\";\n      this.logBreakerTransition(\"open\");\n    }\n  }\n\n  private resetProviderBreakerOnSuccess(): void {\n    const wasDisturbed =\n      this.providerBreaker.state !== \"closed\" ||\n      this.providerBreaker.consecutiveFailures > 0 ||\n      this.providerBreaker.openUntilMs > 0;\n    if (!wasDisturbed) return;\n    const wasOpen = this.providerBreaker.state !== \"closed\";\n    this.providerBreaker.consecutiveFailures = 0;\n    this.providerBreaker.openUntilMs = 0;\n    this.providerBreaker.lastReason = \"\";\n    this.providerBreaker.state = \"closed\";\n    if (wasOpen) this.logBreakerTransition(\"closed\");\n  }\n\n  /** Rebuild `meta.extractionRetryState` from the in-memory namespace mirror,\n   *  bounded to the newest entries, and prune the mirror to match. */\n  private persistRetryStateToMeta(namespace: string, meta: MetaState): void {\n    const nsMap = this.extractionRetryState.get(namespace);\n    const entries = nsMap\n      ? Array.from(nsMap.entries()).map(([fingerprint, st]) => ({\n          fingerprint,\n          attempts: st.attempts,\n          nextEligibleAt: new Date(st.nextEligibleAtMs).toISOString(),\n          firstFailedAt: new Date(st.firstFailedAtMs).toISOString(),\n          lastFailureClass: st.lastFailureClass,\n        }))\n      : [];\n    const capped = capExtractionRetryStateEntries(entries, EXTRACTION_RETRY_STATE_MAX_ENTRIES);\n    meta.extractionRetryState = capped;\n    if (nsMap && capped.length < nsMap.size) {\n      const kept = new Set(capped.map((e) => e.fingerprint));\n      for (const key of Array.from(nsMap.keys())) {\n        if (!kept.has(key)) nsMap.delete(key);\n      }\n    }\n  }\n  /** Record an extraction failure into per-fingerprint backoff state + breaker,\n   *  persisting to namespace meta. Fail-open: never throws upward. */\n  private async recordExtractionFailure(\n    storage: StorageManager,\n    namespace: string,\n    fingerprint: string,\n    cls: ExtractionFailureClass,\n    meta: MetaState,\n    now: number,\n  ): Promise<void> {\n    try {\n      this.hydrateRetryStateFromMeta(namespace, meta);\n      const nsMap = this.extractionRetryState.get(namespace) ?? new Map<string, ExtractionRetryStateEntry>();\n      const prev = nsMap.get(fingerprint);\n      const attempts = (prev?.attempts ?? 0) + 1;\n      const firstFailedAtMs = prev?.firstFailedAtMs ?? now;\n      let nextEligibleAtMs: number;\n      if (cls === \"parse_empty\" && attempts > this.config.extractionParseEmptyMaxAttempts) {\n        // parse_empty exhausted its attempt budget → long-park (still never\n        // marked processed). A dead gateway also yields unparseable output.\n        nextEligibleAtMs = now + Math.max(0, this.config.extractionRetryMaxBackoffMs);\n      } else {\n        nextEligibleAtMs = computeExtractionRetryNextEligibleMs(\n          attempts,\n          this.config.extractionRetryScheduleMs,\n          this.config.extractionRetryMaxBackoffMs,\n          this.config.extractionRetryJitterRatio,\n          now,\n        );\n      }\n      nsMap.set(fingerprint, { attempts, nextEligibleAtMs, firstFailedAtMs, lastFailureClass: cls });\n      this.extractionRetryState.set(namespace, nsMap);\n      this.onProviderFailure(cls, now);\n      this.persistRetryStateToMeta(namespace, meta);\n      await storage.saveMeta(meta);\n    } catch (err) {\n      // Fail-open: recording failure state must never crash observe/recall.\n      log.warn(\"runExtraction: failed to record extraction retry state (non-fatal)\", err);\n    }\n  }\n\n  /** Delete a fingerprint's retry entry from the mirror + meta. Returns whether\n   *  meta changed (so the caller can decide to persist). Does not touch the\n   *  breaker — callers pair this with `resetProviderBreakerOnSuccess`. */\n  private clearExtractionRetryEntry(namespace: string, fingerprint: string, meta: MetaState): boolean {\n    const nsMap = this.extractionRetryState.get(namespace);\n    if (!nsMap?.has(fingerprint)) return false;\n    nsMap.delete(fingerprint);\n    this.persistRetryStateToMeta(namespace, meta);\n    return true;\n  }\n\n  /** Live in-process resilience snapshot (breaker + backoff population). */\n  getExtractionResilienceStatus(): ExtractionResilienceStatus {\n    let backoffFingerprintCount = 0;\n    for (const nsMap of this.extractionRetryState.values()) {\n      backoffFingerprintCount += nsMap.size;\n    }\n    return {\n      breaker: {\n        state: this.providerBreaker.state,\n        openUntilMs: this.providerBreaker.openUntilMs,\n        consecutiveFailures: this.providerBreaker.consecutiveFailures,\n        lastReason: this.providerBreaker.lastReason,\n      },\n      backoffFingerprintCount,\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // Main extraction pipeline\n  // -------------------------------------------------------------------------\n\n  async runExtraction(\n    turns: BufferTurn[],\n    options: {\n      clearBufferAfterExtraction?: boolean;\n      clearMatchingTurns?: boolean;\n      skipCharThreshold?: boolean;\n      skipUserTurnThreshold?: boolean;\n      deadlineMs?: number;\n      bufferKey?: string;\n      abortSignal?: AbortSignal;\n      failOnExtractionFailure?: boolean;\n      /**\n       * Called immediately after durable extraction persistence returns, before\n       * any metadata, retention, or helper work. Lifecycle callers use this\n       * as the write-rate-limit commit boundary.\n       */\n      onDurableCommit?: () => void;\n      /**\n       * Explicit namespace override for the write path (#460).  When set, this\n       * is the namespace where extraction writes go instead of the one derived\n       * from `defaultNamespaceForPrincipal(resolvePrincipal(sessionKey))`.\n       * The resolved `principal` is still threaded into memory metadata for\n       * provenance; only the storage target is overridden.\n       */\n      writeNamespaceOverride?: string;\n      /**\n       * Pin the provenance principal instead of deriving it from\n       * `resolvePrincipal(sessionKey)`. When set, this is the identity an\n       * access surface already authenticated; used so observed-turn provenance\n       * is correct even though `turn.sessionKey` is the original key.\n       */\n      principalOverride?: string;\n      /**\n       * Access scope resolution may already have selected a profile while the\n       * session context remains intentionally unbound. Reuse that plan for\n       * persistence instead of deriving it from shared session state.\n       */\n      scopeProfileWritePlan?: ResolvedScopeProfilePlan | null;\n      /**\n       * Force the extractor call, bypassing the retry-backoff / circuit-breaker\n       * gate (extraction hot-loop hardening). Set by explicit flush paths.\n       */\n      forceExtractionAttempt?: boolean;\n    } = {}\n  ): Promise<ExtractionRunResult> {\n    log.debug(`running extraction on ${turns.length} turns`);\n    const clearBufferAfterExtraction = options.clearBufferAfterExtraction ?? true;\n    const clearMatchingTurns = options.clearMatchingTurns === true;\n    const skipCharThreshold = options.skipCharThreshold ?? false;\n    const skipUserTurnThreshold = options.skipUserTurnThreshold ?? false;\n    const deadlineMs =\n      typeof options.deadlineMs === \"number\" && Number.isFinite(options.deadlineMs) ? options.deadlineMs : undefined;\n    const bufferKey = options.bufferKey ?? turns[0]?.sessionKey ?? \"default\";\n    const throwIfDeadlineExceeded = (stage: string): void => {\n      if (typeof deadlineMs === \"number\" && Date.now() >= deadlineMs) {\n        throw new ExtractionDeadlineError(stage);\n      }\n    };\n    const throwIfAborted = (stage: string): void => {\n      throwIfRecallAborted(options.abortSignal, `extraction aborted (${stage})`);\n    };\n    const runPassiveCapture = async (\n      captureTurns: readonly BufferTurn[],\n      captureOptions: {\n        sessionKey: string;\n        principal?: string;\n        namespace: string;\n        bufferKey: string;\n        isLiveSession: boolean;\n        abortSignal?: AbortSignal;\n      },\n    ): Promise<void> => {\n      const deadlineController =\n        typeof deadlineMs === \"number\" && Number.isFinite(deadlineMs) ? new AbortController() : undefined;\n      const captureSignal = combineExtractionAbortSignals(captureOptions.abortSignal ?? options.abortSignal,\n        deadlineController);\n      let deadlineTimer: NodeJS.Timeout | undefined;\n      if (deadlineController && typeof deadlineMs === \"number\") {\n        const scheduleDeadlineAbort = (): void => {\n          const remainingMs = deadlineMs - Date.now();\n          if (remainingMs <= 0) {\n            deadlineController.abort();\n            return;\n          }\n          deadlineTimer = setTimeout(\n            () => {\n              if (Date.now() >= deadlineMs) {\n                deadlineController.abort();\n              } else {\n                scheduleDeadlineAbort();\n              }\n            },\n            Math.min(remainingMs, 2_147_483_647),\n          );\n        };\n        scheduleDeadlineAbort();\n      }\n      try {\n        await raceRecallAbort(\n          this.deps.maybeCapturePassiveCorrections(captureTurns, {\n            ...captureOptions,\n            ...(captureSignal ? { abortSignal: captureSignal } : {}),\n          }),\n          captureSignal,\n          \"extraction aborted (during_passive_capture)\",\n        );\n      } catch (error) {\n        if (typeof deadlineMs === \"number\" && Date.now() >= deadlineMs) {\n          throw new ExtractionDeadlineError(\"during_passive_capture\");\n        }\n        throw error;\n      } finally {\n        if (deadlineTimer) clearTimeout(deadlineTimer);\n      }\n    };\n    const clearBuffer = async (options?: { ignoreAbort?: boolean }) => {\n      if (options?.ignoreAbort !== true) {\n        throwIfDeadlineExceeded(\"before_clear_buffer\");\n        throwIfAborted(\"before_clear_buffer\");\n      }\n      if (clearBufferAfterExtraction) {\n        await this.deps\n          .getBuffer()\n          .clearAfterExtraction(bufferKey, turns, clearMatchingTurns ? { allowNonPrefix: true } : undefined);\n      }\n    };\n\n    // Skip extraction for cron job sessions - these are system operations, not user conversations\n    const sessionKey = turns[0]?.sessionKey ?? \"\";\n    if (sessionKey.includes(\":cron:\")) {\n      log.debug(`skipping extraction for cron session: ${sessionKey}`);\n      await clearBuffer();\n      return {\n        status: \"skipped\",\n        reason: \"cron_session\",\n        persistedCount: 0,\n        durableOutputCount: 0,\n      };\n    }\n\n    const normalizedTurns = turns\n      .filter((t) => (t.role === \"user\" || t.role === \"assistant\") && typeof t.content === \"string\")\n      .map((t) => ({\n        ...t,\n        content: t.content.trim().slice(0, this.config.extractionMaxTurnChars),\n      }))\n      .filter((t) => t.content.length > 0);\n    const targetTurns = normalizedTurns.filter((turn) => turn.extractionContextOnly !== true);\n    if (targetTurns.length === 0) {\n      log.debug(\"skipping extraction: no non-context turns after normalization\");\n      // Context-only turns may still contain corrections (review: \"context-only\n      // turns skip capture\"). Scan normalizedTurns before clearing the buffer.\n      if (normalizedTurns.length > 0) {\n        throwIfDeadlineExceeded(\"before_context_only_capture\");\n        const capturePrincipal =\n          typeof options.principalOverride === \"string\" && options.principalOverride.length > 0\n            ? options.principalOverride\n            : resolvePrincipal(sessionKey, this.config);\n        const captureNamespace =\n          typeof options.writeNamespaceOverride === \"string\" && options.writeNamespaceOverride.length > 0\n            ? options.writeNamespaceOverride\n            : this.deps.resolveSelfNamespace(sessionKey);\n        await runPassiveCapture(normalizedTurns as BufferTurn[], {\n          sessionKey,\n          principal: capturePrincipal,\n          namespace: captureNamespace,\n          bufferKey,\n          isLiveSession: clearBufferAfterExtraction,\n        });\n        throwIfDeadlineExceeded(\"before_context_only_clear\");\n      }\n      await clearBuffer();\n      return { status: \"skipped\", reason: \"empty_normalized_turns\", persistedCount: 0, durableOutputCount: 0 };\n    }\n    const sourceValidAt = this.latestSourceValidAtFromTurns(targetTurns);\n    throwIfDeadlineExceeded(\"before_extract\");\n    throwIfAborted(\"before_extract\");\n\n    const userTurns = targetTurns.filter((t) => t.role === \"user\");\n    const totalChars = targetTurns.reduce((sum, t) => sum + t.content.length, 0);\n    const belowCharThreshold = totalChars < this.config.extractionMinChars;\n    const belowUserTurnThreshold = !skipUserTurnThreshold && userTurns.length < this.config.extractionMinUserTurns;\n    if ((!skipCharThreshold && belowCharThreshold) || belowUserTurnThreshold) {\n      log.debug(`skipping extraction: below threshold (totalChars=${totalChars}, userTurns=${userTurns.length})`);\n      // Passive correction capture runs even when extraction is skipped for\n      // being below the char/user-turn threshold (review: \"skipped extraction\n      // skips capture\"). A short correction like \"stop using Vim\" is under\n      // extractionMinChars but is exactly the high-value case this feature\n      // exists for. The write namespace resolves through the SAME scope-profile\n      // plan as the full extraction path so corrections target the active\n      // profile's write layer, not just resolveSelfNamespace (review:\n      // \"below-threshold wrong namespace\"). The ACL in passiveCorrectionService\n      // authorizes the actual plan/apply.\n      {\n        const capturePrincipal =\n          typeof options.principalOverride === \"string\" && options.principalOverride.length > 0\n            ? options.principalOverride\n            : resolvePrincipal(sessionKey, this.config);\n        const captureWO =\n          typeof options.writeNamespaceOverride === \"string\" && options.writeNamespaceOverride.length > 0\n            ? options.writeNamespaceOverride\n            : undefined;\n        const captureCodingCtx = sessionKey ? this.deps.getCodingContextForSession(sessionKey) : null;\n        const captureCodingOv = resolveCodingNamespaceOverlay(\n          captureCodingCtx,\n          this.config.codingMode,\n          this.config.defaultNamespace\n        );\n        const captureScopePlan = resolveScopeProfilePlan({\n          config: this.config,\n          principal: capturePrincipal,\n          codingContext: captureCodingCtx,\n          codingOverlay: captureCodingOv,\n        });\n        const captureNamespace =\n          captureWO ?? captureScopePlan?.writeNamespace ?? this.deps.resolveSelfNamespace(sessionKey);\n        await runPassiveCapture(normalizedTurns as BufferTurn[], {\n          sessionKey,\n          principal: capturePrincipal,\n          namespace: captureNamespace,\n          bufferKey,\n          isLiveSession: clearBufferAfterExtraction,\n        });\n      }\n      await clearBuffer();\n      return {\n        status: \"skipped\",\n        reason: \"below_threshold\",\n        persistedCount: 0,\n        durableOutputCount: 0,\n      };\n    }\n\n    // Provenance principal honours the access-surface override (#1495 thread 1,\n    // mirroring the recall path's `principalOverride`, issue #570 PR 4). Access\n    // surfaces that authenticated the caller at the transport layer pass their\n    // resolved principal so provenance uses the SAME identity the surface\n    // authorized, instead of `resolvePrincipal(sessionKey)` — which on a\n    // namespace-prefixed key would collapse to `default`. The ORIGINAL,\n    // un-prefixed session key still drives threading.\n    const principal =\n      typeof options.principalOverride === \"string\" && options.principalOverride.length > 0\n        ? options.principalOverride\n        : resolvePrincipal(sessionKey, this.config);\n    // Write path — explicit callers still win. Otherwise, an active hosted\n    // scope profile owns the extraction write target so hook-captured turns land\n    // in the same layer that profile recall searches. Without a profile, preserve\n    // the existing coding-agent overlay behavior (issue #569).\n    const explicitWriteNamespace =\n      typeof options.writeNamespaceOverride === \"string\" && options.writeNamespaceOverride.length > 0\n        ? options.writeNamespaceOverride\n        : undefined;\n    const codingContextForWrite = sessionKey ? this.deps.getCodingContextForSession(sessionKey) : null;\n    const codingOverlayForWrite = resolveCodingNamespaceOverlay(\n      codingContextForWrite,\n      this.config.codingMode,\n      this.config.defaultNamespace\n    );\n    const scopeProfileGatePlan =\n      options.scopeProfileWritePlan !== undefined\n        ? options.scopeProfileWritePlan\n        : resolveScopeProfilePlan({\n            config: this.config,\n            principal,\n            codingContext: codingContextForWrite,\n            codingOverlay: codingOverlayForWrite,\n          });\n    const scopeProfileWritePlan =\n      explicitWriteNamespace && options.scopeProfileWritePlan === undefined\n        ? null\n        : scopeProfileGatePlan;\n    if (scopeProfileWritePlan) {\n      const selectedLayer = scopeProfileWritePlan.layers.find((layer) => layer.id === scopeProfileWritePlan.writeLayer);\n      const writeNamespaceReadable = scopeProfileWritePlan.readNamespaces.includes(\n        scopeProfileWritePlan.writeNamespace\n      );\n      if (!selectedLayer?.writable || !writeNamespaceReadable) {\n        log.warn(\n          `runExtraction: skipping scope profile ${scopeProfileWritePlan.profileId} because write layer ${scopeProfileWritePlan.writeLayer} is not writable inside the profile read stack`\n        );\n        await clearBuffer();\n        return {\n          status: \"skipped\",\n          reason: \"scope_profile_no_writable_layer\",\n          persistedCount: 0,\n          durableOutputCount: 0,\n        };\n      }\n    }\n    const selfNamespace =\n      explicitWriteNamespace ??\n      scopeProfileWritePlan?.writeNamespace ??\n      this.deps.applyCodingNamespaceOverlay(sessionKey, defaultNamespaceForPrincipal(principal, this.config));\n    const extractionDeadlineController =\n      typeof deadlineMs === \"number\" && Number.isFinite(deadlineMs)\n        ? new AbortController()\n        : undefined;\n    const extractionAbortSignal = extractionDeadlineController\n      ? options.abortSignal\n        ? AbortSignal.any([options.abortSignal, extractionDeadlineController.signal])\n        : extractionDeadlineController.signal\n      : options.abortSignal;\n    let extractionDeadlineTimer: NodeJS.Timeout | undefined;\n    const clearExtractionDeadlineTimer = (): void => {\n      if (extractionDeadlineTimer) {\n        clearTimeout(extractionDeadlineTimer);\n        extractionDeadlineTimer = undefined;\n      }\n    };\n    const runDeadlineAware = async <T>(\n      operation: () => Promise<T>,\n      phase: string,\n      clearTimerOnError = true,\n      options: { ignoreAbort?: boolean; ignoreDeadline?: boolean } = {},\n    ): Promise<T> => {\n      const operationSignal = options.ignoreAbort ? undefined : extractionAbortSignal;\n      try {\n        if (!options.ignoreDeadline && typeof deadlineMs === \"number\" && Date.now() >= deadlineMs) {\n          throwIfDeadlineExceeded(phase);\n        }\n        if (operationSignal?.aborted) {\n          throwIfAborted(phase);\n        }\n        return await raceRecallAbort(\n          operation(),\n          operationSignal,\n          `extraction aborted (${phase})`,\n        );\n      } catch (error) {\n        if (clearTimerOnError) clearExtractionDeadlineTimer();\n        if (!options.ignoreDeadline && typeof deadlineMs === \"number\" && Date.now() >= deadlineMs) {\n          throw new ExtractionDeadlineError(phase);\n        }\n        throw error;\n      }\n    };\n    if (extractionDeadlineController && typeof deadlineMs === \"number\") {\n      const deadline = deadlineMs;\n      const maxTimerDelayMs = 2_147_483_647;\n      const scheduleDeadlineAbort = (): void => {\n        const remainingMs = deadline - Date.now();\n        if (remainingMs <= 0) {\n          extractionDeadlineController.abort();\n          return;\n        }\n        extractionDeadlineTimer = setTimeout(() => {\n          if (Date.now() >= deadline) {\n            extractionDeadlineController.abort();\n          } else {\n            scheduleDeadlineAbort();\n          }\n        }, Math.min(remainingMs, maxTimerDelayMs));\n      };\n      scheduleDeadlineAbort();\n    }\n    const storage = await runDeadlineAware(\n      () => this.deps.getStorageRouter().storageFor(selfNamespace),\n      \"during_storage\",\n    );\n    const shouldPersistProcessedFingerprint = targetTurns.some((turn) => turn.persistProcessedFingerprint === true);\n    const extractionFingerprint = this.buildExtractionFingerprint(targetTurns, bufferKey);\n    let meta = extractionFingerprint && shouldPersistProcessedFingerprint\n      ? await runDeadlineAware(() => storage.loadMeta(), \"during_load_meta\")\n      : null;\n    if (\n      extractionFingerprint &&\n      shouldPersistProcessedFingerprint &&\n      (meta?.processedExtractionFingerprints ?? []).some((entry) => entry.fingerprint === extractionFingerprint)\n    ) {\n      await runDeadlineAware(() => clearBuffer(), \"during_clear_buffer\");\n      clearExtractionDeadlineTimer();\n      return {\n        status: \"skipped\",\n        reason: \"processed_fingerprint\",\n        persistedCount: 0,\n        durableOutputCount: 0,\n      };\n    }\n\n    // Extraction retry/backoff + circuit-breaker gate (extraction hot-loop\n    // hardening). Suppresses re-attempts of a recently-failed fingerprint and\n    // short-circuits every fingerprint while the provider breaker is open, so a\n    // failing LLM endpoint is not hammered once per observe. Forced flushes and\n    // fail-closed callers bypass the gate (rule 18) but still record failures.\n    // On a suppressed attempt the buffer is deliberately NOT cleared, so no\n    // extractable turn is dropped — it is retried after cooldown/nextEligibleAt.\n    const forcedExtractionAttempt =\n      options.failOnExtractionFailure === true || options.forceExtractionAttempt === true;\n    // Resolve the gate through the shared lifecycle capability plan (issue\n    // #1523) rather than reading the raw config flag at each call site.\n    const extractionRetryEnabled = resolveMemoryLifecycleCapabilities(this.config).extractionRetry;\n    if (extractionFingerprint && !forcedExtractionAttempt && extractionRetryEnabled) {\n      try {\n        meta ??= await runDeadlineAware(() => storage.loadMeta(), \"during_retry_gate\");\n        this.hydrateRetryStateFromMeta(selfNamespace, meta);\n        const nowMs = Date.now();\n        let suppressReason: \"provider_circuit_open\" | \"extraction_backoff\" | null = null;\n        if (this.isProviderBreakerOpen(nowMs)) {\n          suppressReason = \"provider_circuit_open\";\n        } else {\n          const st = this.extractionRetryState.get(selfNamespace)?.get(extractionFingerprint);\n          if (st && nowMs < st.nextEligibleAtMs) suppressReason = \"extraction_backoff\";\n        }\n        if (suppressReason) {\n          // Passive correction capture is local and must not be delayed by a\n          // provider cooldown. It remains fail-open.\n          try {\n            await runDeadlineAware(\n              () => runPassiveCapture(normalizedTurns as BufferTurn[], {\n                sessionKey,\n                principal,\n                namespace: selfNamespace,\n                bufferKey,\n                isLiveSession: clearBufferAfterExtraction,\n              }),\n              \"during_passive_capture\",\n            );\n          } catch (captureErr) {\n            if (captureErr instanceof ExtractionDeadlineError) throw captureErr;\n            log.warn(\"runExtraction: passive correction capture failed on suppressed attempt (non-fatal)\", captureErr);\n          }\n          clearExtractionDeadlineTimer();\n          return { status: \"skipped\", reason: suppressReason, persistedCount: 0, durableOutputCount: 0 };\n        }\n      } catch (err) {\n        if (err instanceof ExtractionDeadlineError) throw err;\n        // Fail-open: a gate error must never block extraction.\n        log.warn(\"runExtraction: extraction retry gate check failed; proceeding (fail-open)\", err);\n      }\n    }\n\n    // Pass existing entity names so the LLM can reuse them instead of inventing variants.\n    const existingEntities = await runDeadlineAware(\n      () => storage.listEntityNames(),\n      \"during_list_entity_names\",\n    );\n    let result: ExtractionResult;\n    try {\n      result = await raceRecallAbort(\n        this.deps.getExtraction().extract(normalizedTurns, existingEntities, extractionAbortSignal),\n        extractionAbortSignal,\n        \"extraction aborted (during_extract)\",\n      );\n    } catch (error) {\n      clearExtractionDeadlineTimer();\n      if (typeof deadlineMs === \"number\" && Date.now() >= deadlineMs) {\n        throw new ExtractionDeadlineError(\"during_extract\");\n      }\n      throw error;\n    }\n    try {\n      throwIfDeadlineExceeded(\"before_persist\");\n      throwIfAborted(\"before_persist\");\n\n    // Defensive: validate extraction result before processing. Explicit\n    // fail-closed callers, such as flush-plan import, must not observe\n    // malformed extractor output as a successful skip.\n    if (!result) {\n      log.warn(\"runExtraction: extraction returned null/undefined\");\n      if (options.failOnExtractionFailure) {\n        throw new Error(\"extraction failed: invalid_extraction_result\");\n      }\n      await clearBuffer();\n      return {\n        status: \"skipped\",\n        reason: \"invalid_extraction_result\",\n        persistedCount: 0,\n        durableOutputCount: 0,\n      };\n    }\n    const invalidExtractionResultFields = [\n      [\"facts\", result.facts],\n      [\"entities\", result.entities],\n      [\"questions\", result.questions],\n      [\"profileUpdates\", result.profileUpdates],\n    ]\n      .filter(([, value]) => !Array.isArray(value))\n      .map(([field]) => field);\n    if (invalidExtractionResultFields.length > 0) {\n      log.warn(\"runExtraction: extraction returned invalid collection fields\", {\n        invalidFields: invalidExtractionResultFields,\n        resultKeys: typeof result === \"object\" && result !== null ? Object.keys(result) : [],\n      });\n      if (options.failOnExtractionFailure) {\n        throw new Error(\"extraction failed: invalid_extraction_result\");\n      }\n      await clearBuffer();\n      return {\n        status: \"skipped\",\n        reason: \"invalid_extraction_result\",\n        persistedCount: 0,\n        durableOutputCount: 0,\n      };\n    }\n    const extractionFailure =\n      typeof result.extractionFailure === \"string\" && result.extractionFailure.trim().length > 0\n        ? result.extractionFailure\n        : undefined;\n    // Issue #3140: surface extraction-LLM outages on /health and as an\n    // ERROR-level deduplicated event instead of debug-only lines. Records on\n    // every completed attempt so a later success clears the failure.\n    if (extractionFailure) {\n      recordExtractionLlmFailure(extractionFailure);\n      emitExtractionLlmFailureError(extractionFailure, result.extractionFailureClass);\n    } else if (result.extractionSkippedReason !== undefined) {\n      // Prefiltered batch: no LLM was contacted, so we cannot confirm or deny\n      // reachability. Do not clear the outage state.\n    } else {\n      recordExtractionLlmSuccess();\n    }\n    let recordedRetryFailure = false;\n    // Record failure into backoff/breaker state, or heal on success. Runs for\n    // every result path (empty and durable), before the fail-closed throw, so a\n    // forced flush still records its failure (rule 18). Gated by\n    // extractionRetryEnabled so a disabled feature restores prior behavior.\n    if (extractionFingerprint && extractionRetryEnabled) {\n      if (extractionFailure) {\n        try {\n          meta ??= await runDeadlineAware(() => storage.loadMeta(), \"during_retry_bookkeeping_load\", false);\n          await runDeadlineAware(\n            () =>\n              this.recordExtractionFailure(\n                storage,\n                selfNamespace,\n                extractionFingerprint,\n                result.extractionFailureClass ?? \"provider_retryable\",\n                meta!,\n                Date.now(),\n              ),\n            \"during_retry_bookkeeping_save\",\n            false,\n          );\n          // The buffer is retained below so the backoff gate can re-attempt\n          // these turns after nextEligibleAt — clearing would orphan the\n          // retry state.\n          recordedRetryFailure = true;\n        } catch (err) {\n          if (err instanceof ExtractionDeadlineError) throw err;\n          // Fail-open (codex review): retry bookkeeping is best-effort — a\n          // corrupt or locked meta store must not reject the extraction task.\n          // With no backoff recorded there is nothing to retain for, so the\n          // pre-#1908 clear-buffer behavior applies below.\n          log.warn(\"runExtraction: failed to load meta for retry bookkeeping (non-fatal)\", err);\n        }\n      } else if (result.extractionSkippedReason === undefined) {\n        // Provider responded without failure → breaker heals; clear any\n        // parked backoff for this fingerprint so it proceeds normally.\n        this.resetProviderBreakerOnSuccess();\n        try {\n          meta ??= await runDeadlineAware(() => storage.loadMeta(), \"during_retry_bookkeeping_load\", false);\n          // Hydrate the in-memory mirror from persisted meta before clearing.\n          // A forced flush (forceExtractionAttempt) bypasses the retry gate and\n          // never hydrated, so without this a stale persisted backoff entry\n          // would survive a successful forced flush and keep blocking normal\n          // extraction until the timer expired (cursor/codex review).\n          this.hydrateRetryStateFromMeta(selfNamespace, meta);\n          if (this.clearExtractionRetryEntry(selfNamespace, extractionFingerprint, meta)) {\n            await runDeadlineAware(() => storage.saveMeta(meta!), \"during_retry_bookkeeping_save\", false);\n          }\n        } catch (err) {\n          if (err instanceof ExtractionDeadlineError) throw err;\n          log.warn(\"runExtraction: failed to persist cleared retry state (non-fatal)\", err);\n        }\n      }\n    }\n    if (options.failOnExtractionFailure && extractionFailure) {\n      throw new Error(`extraction failed: ${extractionFailure}`);\n    }\n    if (\n      result.facts.length === 0 &&\n      result.entities.length === 0 &&\n      result.questions.length === 0 &&\n      result.profileUpdates.length === 0\n    ) {\n      log.debug(\"runExtraction: extraction produced no durable outputs; skipping persistence\");\n      if (extractionFailure) {\n        log.warn(\n          \"runExtraction: extraction reported failure with no durable outputs; not marking fingerprint processed\",\n          { extractionFailure }\n        );\n      }\n      const emptySuccessCommit = {\n        storage,\n        meta,\n        extractionFingerprint,\n        shouldPersistProcessedFingerprint,\n        hasExtractionFailure: Boolean(extractionFailure),\n        extractionSkippedReason: result.extractionSkippedReason,\n        recordProcessedExtractionFingerprint: this.deps.recordProcessedExtractionFingerprint,\n        runDeadlineAware,\n        isDeadlineError: (error: unknown) => error instanceof ExtractionDeadlineError,\n      };\n      if (shouldPersistProcessedFingerprint) {\n        await commitEmptySuccessExtraction(emptySuccessCommit);\n      }\n      await runPassiveCapture(normalizedTurns as BufferTurn[], {\n        sessionKey,\n        principal,\n        namespace: selfNamespace,\n        bufferKey,\n        isLiveSession: clearBufferAfterExtraction,\n      });\n      if (recordedRetryFailure) {\n        log.debug(\"runExtraction: retaining buffer for backoff retry after failure\");\n      } else {\n        await clearBuffer();\n      }\n      if (!shouldPersistProcessedFingerprint) {\n        await commitEmptySuccessExtraction(emptySuccessCommit);\n      }\n      return { status: \"skipped\", reason: \"empty_extraction_result\", persistedCount: 0, durableOutputCount: 0 };\n    }\n\n    let threadIdForExtraction: string | null = null;\n    if (resolvePresentationCapabilities(this.config).threading && turns.length > 0) {\n      const lastTurn = turns[turns.length - 1];\n      try {\n        threadIdForExtraction = await runDeadlineAware(\n          () => this.deps.getThreading().processTurn(lastTurn, []),\n          \"during_threading\",\n        );\n      } catch (err) {\n        if (err instanceof ExtractionDeadlineError) throw err;\n        // Fail-open: threading errors must not block memory persistence.\n        log.warn(\"[threading] processTurn failed before persistence (non-fatal)\", err);\n      }\n    }\n    const originContext = deriveExtractionOriginContext(targetTurns, result.sourceConnector);\n    throwIfDeadlineExceeded(\"before_persist\");\n    throwIfAborted(\"before_persist\");\n\n    const { persistedIds } = await this.deps.persistExtraction(\n      result,\n      storage,\n      threadIdForExtraction,\n      { sessionKey, principal, validAt: sourceValidAt, ...originContext },\n      // Pass the KNOWN base namespace (NHIdx) so the catalog write touch records the\n      // real namespace rather than a guess decoded from the storage dir.\n      selfNamespace,\n      scopeProfileWritePlan,\n      // Verbatim source turns for the faithfulness gate (#1576) so it can\n      // locate a quote per fact when #1575 spans are absent.\n      normalizedTurns\n        .map((t) => t.content)\n        .join(\"\\n\\n\")\n    );\n    const durableOutputCount =\n      result.facts.length + result.entities.length + result.questions.length + result.profileUpdates.length;\n    try {\n      options.onDurableCommit?.();\n    } catch (error) {\n      log.warn(\"runExtraction: durable-commit callback failed\", error);\n    }\n    const runPostPersistBestEffort = runExtractionPostPersistBestEffort.bind(null, runDeadlineAware);\n    await tagPersistedMemories(storage, persistedIds, this.config);\n    const postPersist = await runExtractionPostPersist({\n      result,\n      storage,\n      meta: meta ?? undefined,\n      extractionFingerprint: extractionFingerprint ?? undefined,\n      shouldPersistProcessedFingerprint,\n      recordProcessedExtractionFingerprint: this.deps.recordProcessedExtractionFingerprint,\n      runDeadlineAware,\n      isDeadlineError: (error) => error instanceof ExtractionDeadlineError,\n      createDeadlineError: (stage) => new ExtractionDeadlineError(stage),\n      deadlineMs,\n      clearBufferAfterExtraction,\n      runPostPersistBestEffort,\n      extractionJudgeShadow: this.config.extractionJudgeShadow,\n      getDeferredCount: () => this.deps.getLastPersistExtractionDeferredCount(),\n      normalizedTurns: normalizedTurns as BufferTurn[],\n      bufferKey,\n      retainDeferredTurns: (key, retainedTurns, max) =>\n        this.deps.getBuffer().retainDeferredTurns(key, retainedTurns, max, turns),\n      clearBuffer,\n      failOnExtractionFailure: options.failOnExtractionFailure === true,\n    });\n    meta = postPersist.meta ?? null;\n    const postPersistMetadataFailed = postPersist.metadataFailed;\n\n    // Passive correction capture (issue #1581) — detect corrections expressed\n    // passively in the extracted turns and route to the Correction Contract.\n    // Runs AFTER persistence + buffer clear so a capture failure never blocks\n    // the extraction return. `clearBufferAfterExtraction` gates live-session\n    // auto-apply (replay/import → queue-only).\n    await runPostPersistBestEffort(\"during_post_persist_passive_capture\", () =>\n      runPassiveCapture(normalizedTurns as BufferTurn[], {\n        sessionKey,\n        principal,\n        namespace: selfNamespace,\n        bufferKey,\n        isLiveSession: clearBufferAfterExtraction,\n        abortSignal: extractionAbortSignal,\n      }),\n    );\n\n    // Build memory box from this extraction (v8.0 Phase 2A)\n    // Topics are derived from the current extraction's facts and entities only —\n    // not from readAllMemories() — so box topics accurately reflect the current\n    // session window and the call is free of expensive full-corpus I/O.\n    if (resolvePresentationCapabilities(this.config).memoryBoxes && persistedIds.length > 0) {\n      const extractionTopics = deriveTopicsFromExtraction(result);\n      // Derive episodic metadata from buffer turns (REMem-inspired)\n      const firstUserTurn = turns.find((t) => t.role === \"user\");\n      const boxGoal = firstUserTurn?.content?.slice(0, 100)?.trim() || undefined;\n      await runPostPersistBestEffort(\"during_memory_box\", () =>\n        this.deps.boxBuilderFor(storage).onExtraction({\n          topics: extractionTopics,\n          memoryIds: persistedIds,\n          timestamp: new Date().toISOString(),\n          goal: boxGoal,\n        }),\n      );\n    }\n\n    // Batch-append persisted IDs so non-fact memories (entities/questions) are\n    // always attached to the thread. The helper excludes pending_review ids (#1635).\n    if (resolvePresentationCapabilities(this.config).threading && threadIdForExtraction && persistedIds.length > 0) {\n      await runPostPersistBestEffort(\"during_thread_episode_append\", () =>\n        this.deps.appendPersistedThreadEpisodes(threadIdForExtraction, persistedIds),\n      );\n    }\n\n    // Thread title update for the already-established thread context.\n    if (resolvePresentationCapabilities(this.config).threading && threadIdForExtraction) {\n      const conversationContent = turns.map((t) => t.content).join(\" \");\n      await runPostPersistBestEffort(\"during_thread_title_update\", () =>\n        this.deps.getThreading().updateThreadTitle(threadIdForExtraction, conversationContent),\n      );\n    }\n\n    // Check if consolidation is needed (debounced + non-zero gated).\n    const nonZeroExtraction = durableOutputCount > 0;\n    try {\n      // The increment of nonZeroExtractionsSinceConsolidation moved into\n      // the scheduler with the rest of the cadence state (issue #1526 PR1).\n      this.deps.maybeScheduleConsolidation(nonZeroExtraction);\n    } catch (err) {\n      log.warn(\"runExtraction: consolidation scheduling failed after persistence (non-fatal)\", err);\n    }\n\n    try {\n      this.deps.requestQmdMaintenance();\n    } catch (err) {\n      log.warn(\"runExtraction: QMD maintenance scheduling failed after persistence (non-fatal)\", err);\n    }\n\n    await runPostPersistBestEffort(\"during_tier_migration\", () =>\n      this.deps.runTierMigrationCycle(storage, \"extraction\"),\n    );\n\n    return {\n      status: \"completed\",\n      persistedCount: persistedIds.length,\n      durableOutputCount,\n      postPersistMetadataFailed,\n    };\n    } finally {\n      clearExtractionDeadlineTimer();\n    }\n  }\n}\n","/**\n * Derive issue #1955 origin metadata at the extraction boundary.\n */\n\nimport { classifyOrigin, type OriginClass } from \"../security/origin-authority.js\";\nimport type { BufferTurn } from \"../types.js\";\n\nexport interface ExtractionSourceContext {\n  sessionKey?: string;\n  principal?: string;\n  validAt?: string;\n  sourceConnector?: string;\n  turnRole?: \"user\" | \"assistant\" | \"tool\" | string;\n  importAdapter?: string;\n  originConflict?: boolean;\n}\n\n/** Derive one origin context from the turns that supplied an extraction. */\nexport function deriveExtractionOriginContext(\n  targetTurns: readonly BufferTurn[],\n  fallbackConnector?: string,\n): Pick<ExtractionSourceContext, \"turnRole\" | \"importAdapter\" | \"sourceConnector\" | \"originConflict\"> {\n  const originRoles = new Set(targetTurns.map((turn) => turn.originRole ?? turn.role));\n  const turnRole = originRoles.size === 1 ? [...originRoles][0] : undefined;\n  const originConnectors = new Set(\n    targetTurns\n      .map((turn) => turn.sourceConnector)\n      .filter((connector): connector is string => typeof connector === \"string\" && connector.length > 0),\n  );\n  // Mirror the pre-#1955 provenance rule: a batch only carries a connector\n  // when EVERY turn is tagged with the same one — a mixed tagged+untagged\n  // batch must stay connector-less (connector-provenance-lifecycle tests).\n  const connector =\n    targetTurns.length > 0 &&\n    targetTurns.every(\n      (turn) => typeof turn.sourceConnector === \"string\" && turn.sourceConnector.length > 0,\n    ) &&\n    originConnectors.size === 1\n      ? [...originConnectors][0]\n      : undefined;\n  const originAdapters = new Set(\n    targetTurns\n      .map((turn) => turn.importProvenance?.sourceLabel)\n      .filter((adapter): adapter is string => typeof adapter === \"string\" && adapter.length > 0),\n  );\n  // Conflict when identities disagree OR are only partially present: a batch\n  // where some turns carry an import label (or connector) and others do not\n  // must classify as unknown, never fall back to the uniform turn role\n  // (#1955 review: mixed import labels previously became `user`).\n  const everyTurnHasConnector =\n    targetTurns.length > 0 &&\n    targetTurns.every((turn) => typeof turn.sourceConnector === \"string\" && turn.sourceConnector.length > 0);\n  const everyTurnHasAdapter =\n    targetTurns.length > 0 &&\n    targetTurns.every(\n      (turn) => typeof turn.importProvenance?.sourceLabel === \"string\" && turn.importProvenance.sourceLabel.length > 0,\n    );\n  const originConflict =\n    originConnectors.size > 1 ||\n    originAdapters.size > 1 ||\n    (originConnectors.size > 0 && originAdapters.size > 0) ||\n    (originConnectors.size > 0 && !everyTurnHasConnector) ||\n    (originAdapters.size > 0 && !everyTurnHasAdapter);\n  const importAdapter =\n    targetTurns.length > 0 &&\n    targetTurns.every(\n      (turn) =>\n        typeof turn.importProvenance?.sourceLabel === \"string\" &&\n        turn.importProvenance.sourceLabel.length > 0,\n    ) &&\n    originAdapters.size === 1\n      ? [...originAdapters][0]\n      : undefined;\n  return {\n    ...(turnRole ? { turnRole } : {}),\n    ...(importAdapter ? { importAdapter } : {}),\n    ...(originConflict ? { originConflict: true } : {}),\n    sourceConnector: fallbackConnector ?? connector,\n  };\n}\n\n/** Classify the persisted origin without reading config flags. */\nexport function classifyExtractionOrigin(sourceContext?: ExtractionSourceContext): OriginClass {\n  if (sourceContext?.originConflict === true) return \"unknown\";\n  return classifyOrigin({\n    turnRole: sourceContext?.turnRole,\n    connectorId: sourceContext?.sourceConnector,\n    importAdapter: sourceContext?.importAdapter,\n  });\n}\n"],"mappings":"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","names":["connector","options"]}

package/dist/chunk-LNEWDF2A.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/access-observe-helpers.ts"],"sourcesContent":["type PendingObservePreparation = {\n  cancelled: boolean;\n  scopeHint?: string;\n  principal?: string;\n  namespace?: string;\n  scopeResolved: boolean;\n  resolvedScopeFences: Array<{ principal?: string; namespace?: string }>;\n  released: Promise<void>;\n  release: () => void;\n};\n\nfunction resolvedScopesMatch(\n  left: { principal?: string; namespace?: string },\n  right: { principal?: string; namespace?: string },\n): boolean {\n  return left.principal === right.principal && left.namespace === right.namespace;\n}\n\nfunction preparationMatchesScope(\n  reservation: PendingObservePreparation,\n  principal: string | undefined,\n  namespace: string | undefined,\n  scopeHint: string | undefined,\n): boolean {\n  if (reservation.scopeResolved) {\n    return resolvedScopesMatch(reservation, { principal, namespace });\n  }\n  return reservation.scopeHint === undefined || scopeHint === undefined || reservation.scopeHint === scopeHint;\n}\n\nexport type PendingObservePreparationHandle = {\n  isCancelled(): boolean;\n  setScope(principal?: string, namespace?: string): void;\n  release(): void;\n};\n\nexport function pendingObserveScopeHint(options: {\n  namespace?: string;\n  projectTag?: string;\n  cwd?: string;\n}): string | undefined {\n  const namespace = options.namespace?.trim();\n  if (namespace) return `namespace:${namespace}`;\n  const projectTag = options.projectTag?.trim();\n  if (projectTag) return `projectTag:${projectTag}`;\n  const cwd = options.cwd?.trim();\n  return cwd ? `cwd:${cwd}` : undefined;\n}\n\ntype PendingObserveExtraction = {\n  promise: Promise<void>;\n  controllers: Set<AbortController>;\n};\n\nexport class PendingObserveExtractionTracker {\n  private readonly entries = new Map<string, PendingObserveExtraction>();\n  private readonly preparations = new Map<string, Set<PendingObservePreparation>>();\n\n  reserve(sessionKey: string, scopeHint?: string): PendingObservePreparationHandle {\n    let released = false;\n    let resolveReleased: () => void = () => {};\n    const reservation: PendingObservePreparation = {\n      cancelled: false,\n      scopeResolved: false,\n      resolvedScopeFences: [],\n      scopeHint,\n      released: new Promise<void>((resolve) => {\n        resolveReleased = resolve;\n      }),\n      release: () => {\n        if (released) return;\n        released = true;\n        const entries = this.preparations.get(sessionKey);\n        entries?.delete(reservation);\n        if (entries?.size === 0) this.preparations.delete(sessionKey);\n        resolveReleased();\n      },\n    };\n    const entries = this.preparations.get(sessionKey) ?? new Set<PendingObservePreparation>();\n    entries.add(reservation);\n    this.preparations.set(sessionKey, entries);\n    return {\n      isCancelled: () => reservation.cancelled,\n      setScope: (principal, namespace) => {\n        reservation.principal = principal;\n        reservation.namespace = namespace;\n        reservation.scopeResolved = true;\n        if (reservation.resolvedScopeFences.some((fence) => resolvedScopesMatch(reservation, fence))) {\n          reservation.cancelled = true;\n        }\n      },\n      release: reservation.release,\n    };\n  }\n\n  private async waitForPreparations(\n    sessionKey: string,\n    principal: string | undefined,\n    namespace: string | undefined,\n    scopeHint: string | undefined,\n  ): Promise<void> {\n    while (true) {\n      const reservations = [...(this.preparations.get(sessionKey) ?? [])];\n      for (const reservation of reservations) {\n        if (\n          !reservation.cancelled &&\n          !reservation.scopeResolved &&\n          !preparationMatchesScope(reservation, principal, namespace, scopeHint) &&\n          !reservation.resolvedScopeFences.some((fence) =>\n            resolvedScopesMatch(fence, { principal, namespace }),\n          )\n        ) {\n          reservation.resolvedScopeFences.push({ principal, namespace });\n        }\n      }\n      const pending = reservations.filter(\n        (reservation) =>\n          !reservation.cancelled && preparationMatchesScope(reservation, principal, namespace, scopeHint),\n      );\n      if (pending.length === 0) return;\n      await Promise.all(pending.map((reservation) => reservation.released));\n    }\n  }\n\n\n  key(sessionKey: string, principal: string | undefined, namespace: string | undefined): string {\n    return `${sessionKey}\\u0000${principal ?? \"\"}\\u0000${namespace ?? \"\"}`;\n  }\n\n  track(key: string, extraction: Promise<void>, controller: AbortController): void {\n    const previous = this.entries.get(key);\n    const promise = previous\n      ? Promise.allSettled([previous.promise, extraction]).then((results) => {\n          const rejected = results.find((result): result is PromiseRejectedResult => result.status === \"rejected\");\n          if (rejected) throw rejected.reason;\n        })\n      : extraction;\n    const entry = {\n      promise,\n      controllers: new Set(previous ? [...previous.controllers, controller] : [controller]),\n    };\n    this.entries.set(key, entry);\n    void promise\n      .then(() => {\n        if (this.entries.get(key) === entry) this.entries.delete(key);\n      })\n      .catch(() => {\n        // Keep a failed barrier visible to the next lifecycle flush.\n      });\n  }\n\n  cancelPreparations(sessionKey: string, scopeHint?: string): void {\n    for (const reservation of this.preparations.get(sessionKey) ?? []) {\n      if (\n        scopeHint !== undefined &&\n        reservation.scopeHint !== undefined &&\n        reservation.scopeHint !== scopeHint\n      ) {\n        continue;\n      }\n      reservation.cancelled = true;\n    }\n  }\n\n  cancel(\n    sessionKey: string,\n    principal?: string,\n    namespace?: string,\n    scopeHint?: string,\n  ): void {\n    for (const reservation of this.preparations.get(sessionKey) ?? []) {\n      if (!preparationMatchesScope(reservation, principal, namespace, scopeHint)) continue;\n      reservation.cancelled = true;\n    }\n\n    for (const [key, entry] of this.entries) {\n      const [entrySessionKey, entryPrincipal, entryNamespace] = key.split(\"\\u0000\");\n      if (\n        entrySessionKey !== sessionKey ||\n        (principal !== undefined && entryPrincipal !== (principal ?? \"\")) ||\n        (namespace !== undefined && entryNamespace !== (namespace ?? \"\"))\n      )\n        continue;\n      for (const controller of entry.controllers) controller.abort();\n    }\n  }\n\n  async wait(\n    sessionKey: string,\n    principal: string | undefined,\n    namespace: string | undefined,\n    abortSignal?: AbortSignal,\n    registerCancellation?: (cancel: () => void) => void,\n    scopeHint?: string,\n  ): Promise<void> {\n    const key = this.key(sessionKey, principal, namespace);\n    const abortTracked = (): void => {\n      this.cancel(sessionKey, principal, namespace, scopeHint);\n    };\n    registerCancellation?.(abortTracked);\n    abortSignal?.addEventListener(\"abort\", abortTracked, { once: true });\n    try {\n      await this.waitForPreparations(sessionKey, principal, namespace, scopeHint);\n      while (true) {\n        const entry = this.entries.get(key);\n        if (!entry) return;\n        try {\n          await entry.promise;\n        } catch (error) {\n          if (this.entries.get(key) !== entry) continue;\n          this.entries.delete(key);\n          throw error;\n        }\n        if (this.entries.get(key) !== entry) continue;\n        this.entries.delete(key);\n        return;\n      }\n    } finally {\n      abortSignal?.removeEventListener(\"abort\", abortTracked);\n    }\n  }\n}\n"],"mappings":"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","names":["entries"]}