@cortexkit/opencode-magic-context 0.42.0 → 0.42.1

package/dist/{index-c9hamh36.js → index-1q9kay7n.js}

@@ -15771,6 +15771,28 @@ var $ZodEnum = /* @__PURE__ */ $constructor("$ZodEnum", (inst, def) => {
     return payload;
   };
 });
+var $ZodLiteral = /* @__PURE__ */ $constructor("$ZodLiteral", (inst, def) => {
+  $ZodType.init(inst, def);
+  if (def.values.length === 0) {
+    throw new Error("Cannot create literal schema with no valid values");
+  }
+  const values = new Set(def.values);
+  inst._zod.values = values;
+  inst._zod.pattern = new RegExp(`^(${def.values.map((o) => typeof o === "string" ? escapeRegex(o) : o ? escapeRegex(o.toString()) : String(o)).join("|")})$`);
+  inst._zod.parse = (payload, _ctx) => {
+    const input = payload.value;
+    if (values.has(input)) {
+      return payload;
+    }
+    payload.issues.push({
+      code: "invalid_value",
+      values: def.values,
+      input,
+      inst
+    });
+    return payload;
+  };
+});
 var $ZodTransform = /* @__PURE__ */ $constructor("$ZodTransform", (inst, def) => {
   $ZodType.init(inst, def);
   inst._zod.optin = "optional";
@@ -16976,6 +16998,44 @@ var enumProcessor = (schema, _ctx, json, _params) => {
     json.type = "string";
   json.enum = values;
 };
+var literalProcessor = (schema, ctx, json, _params) => {
+  const def = schema._zod.def;
+  const vals = [];
+  for (const val of def.values) {
+    if (val === undefined) {
+      if (ctx.unrepresentable === "throw") {
+        throw new Error("Literal `undefined` cannot be represented in JSON Schema");
+      }
+    } else if (typeof val === "bigint") {
+      if (ctx.unrepresentable === "throw") {
+        throw new Error("BigInt literals cannot be represented in JSON Schema");
+      } else {
+        vals.push(Number(val));
+      }
+    } else {
+      vals.push(val);
+    }
+  }
+  if (vals.length === 0) {} else if (vals.length === 1) {
+    const val = vals[0];
+    json.type = val === null ? "null" : typeof val;
+    if (ctx.target === "draft-04" || ctx.target === "openapi-3.0") {
+      json.enum = [val];
+    } else {
+      json.const = val;
+    }
+  } else {
+    if (vals.every((v) => typeof v === "number"))
+      json.type = "number";
+    if (vals.every((v) => typeof v === "string"))
+      json.type = "string";
+    if (vals.every((v) => typeof v === "boolean"))
+      json.type = "boolean";
+    if (vals.every((v) => v === null))
+      json.type = "null";
+    json.enum = vals;
+  }
+};
 var customProcessor = (_schema, ctx, _json, _params) => {
   if (ctx.unrepresentable === "throw") {
     throw new Error("Custom types cannot be represented in JSON Schema");
@@ -17914,6 +17974,27 @@ function _enum(values, params) {
     ...normalizeParams(params)
   });
 }
+var ZodLiteral = /* @__PURE__ */ $constructor("ZodLiteral", (inst, def) => {
+  $ZodLiteral.init(inst, def);
+  ZodType.init(inst, def);
+  inst._zod.processJSONSchema = (ctx, json, params) => literalProcessor(inst, ctx, json, params);
+  inst.values = new Set(def.values);
+  Object.defineProperty(inst, "value", {
+    get() {
+      if (def.values.length > 1) {
+        throw new Error("This schema contains multiple valid literal values. Use `.values` instead.");
+      }
+      return def.values[0];
+    }
+  });
+});
+function literal(value, params) {
+  return new ZodLiteral({
+    type: "literal",
+    values: Array.isArray(value) ? value : [value],
+    ...normalizeParams(params)
+  });
+}
 var ZodTransform = /* @__PURE__ */ $constructor("ZodTransform", (inst, def) => {
   $ZodTransform.init(inst, def);
   ZodType.init(inst, def);
@@ -18604,6 +18685,8 @@ var BaseEmbeddingConfigSchema = object({
   api_key: string().optional().describe("API key for remote embedding provider (optional)"),
   input_type: string().optional().describe("Default input_type for stored/indexed (passage) embeddings in the request body. Required by some openai-compatible providers (e.g. NVIDIA NIM). Omitted from the request when unset."),
   query_input_type: string().optional().describe("Optional input_type for query (search) embeddings on asymmetric models (e.g. NVIDIA NIM 'query'). When unset, query embeddings use embedding.input_type. Passage/stored content always uses embedding.input_type."),
+  query_instruction: union([string(), literal(false)]).optional().describe("OpenAI-compatible query prefix override. A string is prepended verbatim to search queries; false disables the built-in model-family instruction. Qwen3-Embedding, gte-Qwen instruct, e5 instruct, and Nomic families have built-in recipes. Query-only changes do not re-embed stored content. User-level only; project values are ignored."),
+  document_prefix: string().optional().describe("OpenAI-compatible stored-document prefix override, prepended verbatim. Defaults to the model-family recipe (empty for Qwen3/gte/e5 instruct; 'search_document: ' for Nomic). Changing it changes stored vectors and triggers re-embedding. User-level only; project values are ignored."),
   truncate: string().optional().describe("Optional truncate mode sent in the embedding request body (e.g. NVIDIA NIM accepts 'NONE' | 'START' | 'END'). Omitted from the request when unset."),
   max_input_tokens: number2().int().positive().optional().describe("Optional maximum input tokens for chunk embeddings. Defaults conservatively to 512 when omitted."),
   local_runtime: _enum(["auto", "native", "wasm"]).default("auto").describe("Local provider only: ONNX runtime selection. 'auto' uses native under Node and uses WASM under Bun versions before 1.4.0, where Bun's NAPI teardown race can panic on quit; native is restored automatically on Bun 1.4.0+. Set 'native' only to prefer speed while accepting that pre-1.4.0 Bun crash risk, or 'wasm' to avoid loading the native addon."),
@@ -18655,6 +18738,8 @@ var EmbeddingConfigSchema = BaseEmbeddingConfigSchema.transform((data) => {
       ...apiKey ? { api_key: apiKey } : {},
       ...inputType ? { input_type: inputType } : {},
       ...queryInputType ? { query_input_type: queryInputType } : {},
+      ...data.query_instruction !== undefined ? { query_instruction: data.query_instruction } : {},
+      ...data.document_prefix !== undefined ? { document_prefix: data.document_prefix } : {},
       ...truncate ? { truncate } : {},
       ...data.max_input_tokens ? { max_input_tokens: data.max_input_tokens } : {}
     };
@@ -18680,6 +18765,8 @@ var EmbeddingConfigSchema = BaseEmbeddingConfigSchema.transform((data) => {
       ...apiKey ? { api_key: apiKey } : {},
       ...inputType ? { input_type: inputType } : {},
       ...queryInputType ? { query_input_type: queryInputType } : {},
+      ...data.query_instruction !== undefined ? { query_instruction: data.query_instruction } : {},
+      ...data.document_prefix !== undefined ? { document_prefix: data.document_prefix } : {},
       ...truncate ? { truncate } : {},
       ...data.max_input_tokens ? { max_input_tokens: data.max_input_tokens } : {}
     };
@@ -23846,6 +23933,242 @@ async function runMemoryMigration(deps) {
   }
 }
 
+// src/shared/user-facing-codes.ts
+var USER_FACING_FAILURES = {
+  historian_unavailable: {
+    code: "MC-H01",
+    sentence: "History compression could not finish this turn.",
+    action: "It will retry automatically."
+  },
+  recomp_unavailable: {
+    code: "MC-R01",
+    sentence: "History compression could not be rebuilt.",
+    action: "Run /ctx-recomp again."
+  },
+  dream_provider_timeout: {
+    code: "MC-D01",
+    sentence: "Memory maintenance took too long to respond.",
+    action: "Run /ctx-dream again."
+  },
+  dream_provider_error: {
+    code: "MC-D02",
+    sentence: "Memory maintenance could not reach its model.",
+    action: "Check the model connection, then run /ctx-dream again."
+  },
+  dream_empty_completion: {
+    code: "MC-D03",
+    sentence: "Memory maintenance received no usable response.",
+    action: "Run /ctx-dream again."
+  },
+  dream_no_models: {
+    code: "MC-D04",
+    sentence: "Memory maintenance has no model available.",
+    action: "Check the model settings, then run /ctx-dream again."
+  },
+  dream_child_aborted: {
+    code: "MC-D05",
+    sentence: "Memory maintenance was interrupted.",
+    action: "Run /ctx-dream again."
+  },
+  dream_parse_failed: {
+    code: "MC-D06",
+    sentence: "Memory maintenance could not use the model response.",
+    action: "Run /ctx-dream again."
+  },
+  dream_unknown: {
+    code: "MC-D07",
+    sentence: "Memory maintenance could not finish.",
+    action: "Run /ctx-dream again."
+  },
+  embedding_substitution_rejected: {
+    code: "MC-E01",
+    sentence: "Search indexing could not use the selected model.",
+    action: "Check the embedding model setting, then run /ctx-embed start again."
+  },
+  embedding_http_error: {
+    code: "MC-E02",
+    sentence: "The search indexing provider refused the request.",
+    action: "Check the provider connection and credentials, then run /ctx-embed start again."
+  },
+  embedding_transport_error: {
+    code: "MC-E03",
+    sentence: "Search indexing could not reach its provider.",
+    action: "Check the connection, then run /ctx-embed start again."
+  },
+  embedding_invalid_envelope: {
+    code: "MC-E04",
+    sentence: "Search indexing received an unsupported response.",
+    action: "Check the embedding endpoint, then run /ctx-embed start again."
+  },
+  embedding_empty_result: {
+    code: "MC-E05",
+    sentence: "Search indexing received no usable result.",
+    action: "Run /ctx-embed start again."
+  },
+  embedding_certification_refusal: {
+    code: "MC-E06",
+    sentence: "Search indexing is not ready for this provider.",
+    action: "Finish the provider setup, or set a fallback provider in the embedding settings, then run /ctx-embed start again."
+  },
+  embedding_credential_required: {
+    code: "MC-E07",
+    sentence: "Search indexing needs provider credentials.",
+    action: "Sign in to the provider, then run /ctx-embed start again."
+  },
+  embedding_local_binding_missing: {
+    code: "MC-E08",
+    sentence: "Local search indexing is unavailable on this system.",
+    action: "Run `npx @cortexkit/magic-context doctor`, then retry."
+  },
+  embedding_local_fs_unavailable: {
+    code: "MC-E09",
+    sentence: "Local search indexing cannot save its model files.",
+    action: "Update or reinstall Magic Context, then retry."
+  },
+  embedding_local_download_failure: {
+    code: "MC-E10",
+    sentence: "Local search indexing could not download its model.",
+    action: "Check the network connection, then retry."
+  },
+  embedding_local_runtime_error: {
+    code: "MC-E11",
+    sentence: "Local search indexing could not start.",
+    action: "Run `npx @cortexkit/magic-context doctor`, then retry."
+  },
+  embedding_unavailable: {
+    code: "MC-E12",
+    sentence: "Search indexing could not finish.",
+    action: "Run /ctx-embed start again."
+  },
+  status_unavailable: {
+    code: "MC-S01",
+    sentence: "Magic Context status is temporarily unavailable.",
+    action: "Retry /ctx-status in a moment."
+  },
+  transform_update_failed: {
+    code: "MC-S02",
+    sentence: "The last context update did not finish.",
+    action: "Send another message to retry."
+  },
+  configuration_warning: {
+    code: "MC-S03",
+    sentence: "Some configuration settings could not be applied.",
+    action: "Fix the configuration warning shown in /ctx-status diagnostics, then restart."
+  },
+  status_log_unavailable: {
+    code: "MC-S04",
+    sentence: "Some diagnostic details could not be saved.",
+    action: "Retry /ctx-status in a moment."
+  },
+  memory_writes_paused: {
+    code: "MC-C01",
+    sentence: "Memory writes are paused while the engine syncs.",
+    action: "Retry in a moment."
+  },
+  memory_access_unavailable: {
+    code: "MC-C02",
+    sentence: "Memory access is temporarily unavailable.",
+    action: "Retry in a moment."
+  },
+  note_changes_paused: {
+    code: "MC-C03",
+    sentence: "Note changes are paused while the engine syncs.",
+    action: "Retry in a moment."
+  },
+  note_access_unavailable: {
+    code: "MC-C04",
+    sentence: "Notes are temporarily unavailable.",
+    action: "Retry in a moment."
+  },
+  context_cleanup_paused: {
+    code: "MC-C05",
+    sentence: "Context cleanup is paused while the engine syncs.",
+    action: "Retry in a moment."
+  },
+  partial_history_unavailable: {
+    code: "MC-C06",
+    sentence: "Partial history compression is not available in the current mode.",
+    action: "Run /ctx-recomp without a range."
+  },
+  session_upgrade_unavailable: {
+    code: "MC-C07",
+    sentence: "Session upgrade is not available in the current mode.",
+    action: "Run /ctx-recomp instead."
+  },
+  smart_note_conditions_unavailable: {
+    code: "MC-C08",
+    sentence: "Conditional notes are not available in the current mode.",
+    action: "Save a regular note without a condition."
+  },
+  history_compression_paused: {
+    code: "MC-C09",
+    sentence: "History compression is paused while the engine syncs.",
+    action: "Retry in a moment."
+  },
+  context_service_unavailable: {
+    code: "MC-C10",
+    sentence: "Magic Context is temporarily unavailable.",
+    action: "Retry in a moment."
+  }
+};
+function renderUserFacingFailure(key, style = "markdown") {
+  const failure = USER_FACING_FAILURES[key];
+  const action = style === "plain" ? failure.action.replaceAll("`", "") : failure.action;
+  return `${failure.sentence} ${action} (${failure.code})`;
+}
+function userFacingFailureCode(key) {
+  return USER_FACING_FAILURES[key].code;
+}
+var CAPABILITY_FAILURES = {
+  memory_write: "memory_writes_paused",
+  memory_access: "memory_access_unavailable",
+  note_change: "note_changes_paused",
+  note_access: "note_access_unavailable",
+  context_cleanup: "context_cleanup_paused",
+  partial_history: "partial_history_unavailable",
+  session_upgrade: "session_upgrade_unavailable",
+  smart_note_condition: "smart_note_conditions_unavailable",
+  history_compression: "history_compression_paused",
+  context_service: "context_service_unavailable"
+};
+function renderCapabilityRefusal(capability) {
+  return renderUserFacingFailure(CAPABILITY_FAILURES[capability]);
+}
+function capabilityRefusalCode(capability) {
+  return userFacingFailureCode(CAPABILITY_FAILURES[capability]);
+}
+var DREAM_FAILURE_KEYS = {
+  provider_timeout: "dream_provider_timeout",
+  provider_error: "dream_provider_error",
+  empty_completion: "dream_empty_completion",
+  no_models: "dream_no_models",
+  child_aborted: "dream_child_aborted",
+  parse_failed: "dream_parse_failed",
+  unknown: "dream_unknown"
+};
+var EMBEDDING_FAILURE_KEYS = {
+  substitution_rejected: "embedding_substitution_rejected",
+  http_error: "embedding_http_error",
+  transport_error: "embedding_transport_error",
+  invalid_envelope: "embedding_invalid_envelope",
+  empty_result: "embedding_empty_result",
+  certification_refusal: "embedding_certification_refusal",
+  credential_required: "embedding_credential_required",
+  local_binding_missing: "embedding_local_binding_missing",
+  local_fs_unavailable: "embedding_local_fs_unavailable",
+  local_download_failure: "embedding_local_download_failure",
+  local_runtime_error: "embedding_local_runtime_error"
+};
+function renderDreamFailure(failureClass, style = "markdown") {
+  return renderUserFacingFailure(DREAM_FAILURE_KEYS[failureClass], style);
+}
+function dreamFailureCode(failureClass) {
+  return userFacingFailureCode(DREAM_FAILURE_KEYS[failureClass]);
+}
+function renderEmbeddingFailure(failureClass, style = "markdown") {
+  return renderUserFacingFailure(EMBEDDING_FAILURE_KEYS[failureClass], style);
+}
+
 // src/features/magic-context/compartment-chunk-embedding.ts
 import { createHash as createHash14 } from "node:crypto";
 
@@ -25628,7 +25951,8 @@ function getSynapseBatchRequestKey(args) {
     allow_equivalent: false,
     accept_declared: false,
     ids: args.items.map((item) => item.id),
-    content_sha256: args.items.map((item) => item.contentSha256)
+    content_sha256: args.items.map((item) => item.contentSha256),
+    ...args.purpose === "query" ? { purpose: args.purpose } : {}
   }));
 }
 function hashContent(text) {
@@ -25889,7 +26213,7 @@ class SynapseEmbeddingProvider {
     })();
     return this.initializing;
   }
-  async embed(text, signal) {
+  async embed(text, signal, purpose = "passage") {
     if (!await this.initialize() || signal?.aborted || !this.metadata)
       return null;
     if (estimateTokens(text) > this.metadata.max_tokens)
@@ -25899,6 +26223,7 @@ class SynapseEmbeddingProvider {
       const value = await this.callWithRetry("embed.query", this.requestConstraints({
         id,
         text,
+        purpose,
         deadline_ms: this.options.queryTimeoutMs ?? SYNAPSE_DEFAULT_QUERY_TIMEOUT_MS
       }), this.options.queryTimeoutMs ?? SYNAPSE_DEFAULT_QUERY_TIMEOUT_MS, true, signal);
       const extracted = extractVector(value);
@@ -25918,7 +26243,7 @@ class SynapseEmbeddingProvider {
       return null;
     }
   }
-  async embedBatch(texts, signal) {
+  async embedBatch(texts, signal, purpose = "passage") {
     if (texts.length === 0)
       return [];
     const items = texts.map((text, index) => ({
@@ -25926,10 +26251,10 @@ class SynapseEmbeddingProvider {
       text,
       contentSha256: hashContent(text)
     }));
-    const map = await this.embedItems(items, signal);
+    const map = await this.embedItems(items, signal, purpose);
     return items.map((item) => map.get(item.id) ?? null);
   }
-  async embedItems(items, signal) {
+  async embedItems(items, signal, purpose = "passage") {
     const output = new Map;
     if (items.length === 0 || !await this.initialize() || !this.metadata || signal?.aborted) {
       return output;
@@ -25942,12 +26267,12 @@ class SynapseEmbeddingProvider {
       const page = this.nextPage(eligibleItems, start);
       start += page.length;
       try {
-        const requestKey = this.requestKey(page);
+        const requestKey = this.requestKey(page, purpose);
         let body = {};
         let restarted = false;
         for (;; ) {
           try {
-            body = await this.callWithRetry("embed.batch", this.batchRequest(page, requestKey), this.options.batchTimeoutMs ?? SYNAPSE_DEFAULT_BATCH_TIMEOUT_MS, true, signal);
+            body = await this.callWithRetry("embed.batch", this.batchRequest(page, requestKey, purpose), this.options.batchTimeoutMs ?? SYNAPSE_DEFAULT_BATCH_TIMEOUT_MS, true, signal);
             const first = responseBody(body);
             const jobId = typeof first.job_id === "string" ? first.job_id : null;
             if (jobId)
@@ -26017,24 +26342,26 @@ class SynapseEmbeddingProvider {
       accept_declared: false
     };
   }
-  batchRequest(items, requestKey) {
+  batchRequest(items, requestKey, purpose) {
     return this.requestConstraints({
       items: items.map((item) => ({
         id: item.id,
         text: item.text,
         content_sha256: item.contentSha256
       })),
-      request_key: requestKey
+      request_key: requestKey,
+      purpose
     });
   }
-  requestKey(items) {
+  requestKey(items, purpose) {
     if (!this.metadata)
       throw new SynapseEmbeddingError("transport", "Synapse metadata is unavailable");
     return getSynapseBatchRequestKey({
       model: this.metadata.model,
       fingerprint: this.metadata.fingerprint,
       tableEpoch: this.metadata.table_epoch,
-      items
+      items,
+      purpose
     });
   }
   async pollBatch(jobId, requestKey, signal) {
@@ -26244,6 +26571,7 @@ var existingHashStatements = new WeakMap;
 var existingHashByProjectStatements = new WeakMap;
 var deleteByCompartmentStatements = new WeakMap;
 var insertEmbeddingStatements = new WeakMap;
+var renumberEmbeddingWindowStatements = new WeakMap;
 var searchRowsStatements = new WeakMap;
 var searchRowsByModelStatements = new WeakMap;
 var searchPoolProbeStatements = new WeakMap;
@@ -26294,6 +26622,19 @@ function getInsertEmbeddingStatement(db) {
   }
   return stmt;
 }
+function getRenumberEmbeddingWindowStatement(db) {
+  let stmt = renumberEmbeddingWindowStatements.get(db);
+  if (!stmt) {
+    stmt = db.prepare(`UPDATE compartment_chunk_embeddings
+             SET window_index = ?
+             WHERE compartment_id = ?
+               AND model_id = ?
+               AND project_path = ?
+               AND window_index = ?`);
+    renumberEmbeddingWindowStatements.set(db, stmt);
+  }
+  return stmt;
+}
 function getSearchPoolProbeStatement(db) {
   let stmt = searchPoolProbeStatements.get(db);
   if (!stmt) {
@@ -26455,6 +26796,11 @@ function parseCanonicalLineRange(line) {
     return null;
   return { start, end };
 }
+function assertOrdinalRangeWithinCompartment(rangeStart, rangeEnd, compartmentStart, compartmentEnd) {
+  if (rangeStart < compartmentStart || rangeEnd > compartmentEnd || rangeEnd < rangeStart) {
+    throw new RangeError(`Canonical chunk range ${rangeStart}-${rangeEnd} lies outside compartment ${compartmentStart}-${compartmentEnd}`);
+  }
+}
 function hashChunkText(text) {
   return createHash14("sha256").update(text).digest("hex");
 }
@@ -26543,6 +26889,10 @@ function canonicalizeInMemoryChunkTextForEmbedding(chunkText, startOrdinal, endO
       lines.push(`${formatOrdinalRange(retainedStart, retainedEnd)} ${roleLabel} ${retained.map(({ part }) => part).join(" / ")}`);
       continue;
     }
+    const clipsRequestedRange = startOrdinal != null && lineStart < startOrdinal || endOrdinal != null && lineEnd > endOrdinal;
+    if (clipsRequestedRange) {
+      return "";
+    }
     const parts = rawParts.filter((part) => !part.startsWith("TC:"));
     if (parts.length === 0)
       continue;
@@ -26555,6 +26905,12 @@ function chunkCanonicalText(canonicalText, startOrdinal, endOrdinal, maxInputTok
   const lines = canonicalText.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
   if (lines.length === 0 || endOrdinal < startOrdinal)
     return [];
+  for (const line of lines) {
+    const range = parseCanonicalLineRange(line);
+    if (range) {
+      assertOrdinalRangeWithinCompartment(range.start, range.end, startOrdinal, endOrdinal);
+    }
+  }
   const normalizedMax = normalizeCompartmentChunkMaxInputTokens(maxInputTokens);
   const effectiveMax = Math.max(1, Math.floor(normalizedMax * CHUNK_WINDOW_SAFETY_RATIO));
   const fullText = lines.join(`
@@ -26580,8 +26936,9 @@ function chunkCanonicalText(canonicalText, startOrdinal, endOrdinal, maxInputTok
       return;
     const text = currentLines.join(`
 `);
+    assertOrdinalRangeWithinCompartment(currentStart, currentEnd, startOrdinal, endOrdinal);
     windows.push({
-      windowIndex: windows.length + 1,
+      windowIndex: windows.length,
       startOrdinal: currentStart,
       endOrdinal: currentEnd,
       text,
@@ -26600,8 +26957,9 @@ function chunkCanonicalText(canonicalText, startOrdinal, endOrdinal, maxInputTok
     if (lineTokens > effectiveMax) {
       flush();
       for (const slice of splitOversizedLine(line, effectiveMax)) {
+        assertOrdinalRangeWithinCompartment(lineStart, lineEnd, startOrdinal, endOrdinal);
         windows.push({
-          windowIndex: windows.length + 1,
+          windowIndex: windows.length,
           startOrdinal: lineStart,
           endOrdinal: lineEnd,
           text: slice,
@@ -26751,34 +27109,57 @@ function mapBackfillCandidateRows(rows) {
     title: row.title
   }));
 }
+function renumberOneBasedChunkWindows(db, candidate, projectPath, modelId, windows) {
+  const update = getRenumberEmbeddingWindowStatement(db);
+  db.transaction(() => {
+    for (const window of windows) {
+      const result = update.run(window.windowIndex, candidate.id, modelId, projectPath, window.windowIndex + 1);
+      if (result.changes !== 1) {
+        throw new Error(`Failed to renumber compartment ${candidate.id} window ${window.windowIndex + 1}`);
+      }
+    }
+  })();
+  invalidateDecodedSearchPools(db, ([sessionId, cachedProjectPath, cachedModelId]) => sessionId === candidate.sessionId && cachedProjectPath === projectPath && cachedModelId === modelId);
+}
 function classifyChunkCoverageDefect(db, projectPath, modelId, candidate, maxInputTokens) {
   const mappedText = buildCanonicalChunkTextFromFts(db, candidate.sessionId, candidate.startMessage, candidate.endMessage);
   if (mappedText === null)
-    return "deferred";
+    return { defect: "deferred", windows: [] };
   const canonicalText = mappedText || buildCompartmentSummaryFallbackText(db, candidate.id);
   const windows = chunkCanonicalText(canonicalText, candidate.startMessage, candidate.endMessage, maxInputTokens);
   const existing = getExistingChunkHashes(db, candidate.id, modelId, projectPath);
-  if (windows.some((window) => !existing.has(window.windowIndex)))
-    return "missing";
+  const isMatchingOneBasedSet = windows.length > 0 && existing.size === windows.length && windows.every((window) => existing.get(window.windowIndex + 1) === window.chunkHash);
+  if (isMatchingOneBasedSet)
+    return { defect: "renumber", windows };
+  const expectedWindowIndexes = new Set(windows.map((window) => window.windowIndex));
+  if ([...existing.keys()].some((windowIndex) => !expectedWindowIndexes.has(windowIndex))) {
+    return { defect: "stale", windows };
+  }
+  if (windows.some((window) => !existing.has(window.windowIndex))) {
+    return { defect: "missing", windows };
+  }
   if (existing.size !== windows.length || windows.some((window) => existing.get(window.windowIndex) !== window.chunkHash)) {
-    return "stale";
+    return { defect: "stale", windows };
   }
-  return null;
+  return { defect: null, windows };
 }
-function selectHashIncompleteChunkCandidates(db, projectPath, modelId, candidates, limit, maxInputTokens) {
+function selectHashIncompleteChunkCandidates(db, projectPath, modelId, candidates, limit, maxInputTokens, leaseHeldRenumber = false) {
   const missing = [];
   const stale = [];
   for (const candidate of candidates) {
-    const defect = classifyChunkCoverageDefect(db, projectPath, modelId, candidate, maxInputTokens);
+    const { defect, windows } = classifyChunkCoverageDefect(db, projectPath, modelId, candidate, maxInputTokens);
     if (defect === "missing")
       missing.push(candidate);
     else if (defect === "stale")
       stale.push(candidate);
+    else if (defect === "renumber" && leaseHeldRenumber) {
+      renumberOneBasedChunkWindows(db, candidate, projectPath, modelId, windows);
+    }
   }
   return [...missing, ...stale].slice(0, limit);
 }
 var sessionBackfillCandidateStatements = new WeakMap;
-function loadUnembeddedSessionChunkCandidates(db, projectPath, sessionId, modelId, limit, excludeIds, maxInputTokens = DEFAULT_COMPARTMENT_CHUNK_MAX_INPUT_TOKENS) {
+function loadUnembeddedSessionChunkCandidates(db, projectPath, sessionId, modelId, limit, excludeIds, maxInputTokens = DEFAULT_COMPARTMENT_CHUNK_MAX_INPUT_TOKENS, leaseHeldRenumber = false) {
   const exclusions = excludeIds && excludeIds.length > 0 ? excludeIds : [];
   const exclusionSql = exclusions.length > 0 ? `AND c.id NOT IN (${exclusions.map(() => "?").join(", ")})` : "";
   const stmt = exclusions.length > 0 ? db.prepare(`SELECT c.id AS id,
@@ -26817,7 +27198,7 @@ function loadUnembeddedSessionChunkCandidates(db, projectPath, sessionId, modelI
     return cached;
   })();
   const rows = stmt.all(projectPath, sessionId, ...exclusions);
-  return selectHashIncompleteChunkCandidates(db, projectPath, modelId, mapBackfillCandidateRows(rows), Math.max(1, limit), maxInputTokens);
+  return selectHashIncompleteChunkCandidates(db, projectPath, modelId, mapBackfillCandidateRows(rows), Math.max(1, limit), maxInputTokens, leaseHeldRenumber);
 }
 function countUnembeddedSessionCompartments(db, projectPath, sessionId, modelId, maxInputTokens = DEFAULT_COMPARTMENT_CHUNK_MAX_INPUT_TOKENS) {
   return loadUnembeddedSessionChunkCandidates(db, projectPath, sessionId, modelId, Number.MAX_SAFE_INTEGER, undefined, maxInputTokens).length;
@@ -26840,9 +27221,9 @@ function countSessionCompartmentEmbedCoverage(db, projectPath, sessionId, modelI
   const candidates = mapBackfillCandidateRows(rows);
   let embedded = 0;
   for (const candidate of candidates) {
-    if (classifyChunkCoverageDefect(db, projectPath, modelId, candidate, maxInputTokens) === null) {
+    const { defect } = classifyChunkCoverageDefect(db, projectPath, modelId, candidate, maxInputTokens);
+    if (defect === null || defect === "renumber")
       embedded += 1;
-    }
   }
   return { embedded, total: candidates.length };
 }
@@ -27262,6 +27643,78 @@ function dominantEmbeddingFailure(failures) {
   return dominant?.failure;
 }
 
+// src/features/magic-context/memory/embedding-model-match.ts
+function parseEmbeddingModel(model) {
+  const lastColon = model.lastIndexOf(":");
+  if (lastColon > model.lastIndexOf("/")) {
+    return { base: model.slice(0, lastColon), tag: model.slice(lastColon + 1) };
+  }
+  return { base: model };
+}
+function normalizeEmbeddingModelId(model) {
+  return parseEmbeddingModel(model.trim().toLowerCase()).base;
+}
+function matchNormalizedEmbeddingModels(a, b) {
+  if (a.length === 0 || b.length === 0)
+    return true;
+  if (a === b)
+    return true;
+  const longer = a.length >= b.length ? a : b;
+  const shorter = a.length >= b.length ? b : a;
+  const isBoundary = (ch) => ch === "-" || ch === "/";
+  if (longer.startsWith(shorter) && isBoundary(longer.charAt(shorter.length)))
+    return true;
+  if (longer.endsWith(shorter) && isBoundary(longer.charAt(longer.length - shorter.length - 1)))
+    return true;
+  return false;
+}
+function embeddingModelsMatch(served, requested) {
+  const servedNormalized = served.trim().toLowerCase();
+  const requestedNormalized = requested.trim().toLowerCase();
+  const servedModel = parseEmbeddingModel(servedNormalized);
+  const requestedModel = parseEmbeddingModel(requestedNormalized);
+  if (servedModel.tag !== undefined && requestedModel.tag !== undefined && servedModel.tag !== requestedModel.tag) {
+    return false;
+  }
+  return matchNormalizedEmbeddingModels(servedModel.base, requestedModel.base);
+}
+var QWEN3_QUERY_INSTRUCTION = `Instruct: Given a web search query, retrieve relevant passages that answer the query
+Query: `;
+var INSTRUCT_WEB_SEARCH_QUERY_PREFIX = QWEN3_QUERY_INSTRUCTION;
+var EMBEDDING_MODEL_PREFIX_FAMILIES = [
+  {
+    family: "qwen3-embedding",
+    basenamePattern: /^qwen3-embedding(?:-|$)/,
+    prefixes: { queryPrefix: QWEN3_QUERY_INSTRUCTION, documentPrefix: "" }
+  },
+  {
+    family: "gte-qwen-instruct",
+    basenamePattern: /^gte-qwen.*-instruct(?:-|$)/,
+    prefixes: { queryPrefix: INSTRUCT_WEB_SEARCH_QUERY_PREFIX, documentPrefix: "" }
+  },
+  {
+    family: "e5-instruct",
+    basenamePattern: /^(?:multilingual-)?e5-.*-instruct(?:-|$)/,
+    prefixes: { queryPrefix: INSTRUCT_WEB_SEARCH_QUERY_PREFIX, documentPrefix: "" }
+  },
+  {
+    family: "nomic-embed-text",
+    basenamePattern: /^nomic-embed-text(?:-|$)/,
+    prefixes: { queryPrefix: "search_query: ", documentPrefix: "search_document: " }
+  }
+];
+function modelBasename(model) {
+  const normalized = normalizeEmbeddingModelId(model);
+  return normalized.slice(normalized.lastIndexOf("/") + 1);
+}
+function resolveEmbeddingTextPrefixes(model, queryInstruction, documentPrefix) {
+  const family = EMBEDDING_MODEL_PREFIX_FAMILIES.find(({ basenamePattern }) => basenamePattern.test(modelBasename(model)));
+  return {
+    queryPrefix: queryInstruction === false ? "" : queryInstruction !== undefined ? queryInstruction : family?.prefixes.queryPrefix ?? "",
+    documentPrefix: documentPrefix ?? family?.prefixes.documentPrefix ?? ""
+  };
+}
+
 // src/features/magic-context/memory/embedding-identity.ts
 function normalizeEndpoint(endpoint) {
   return endpoint?.trim().replace(/\/+$/, "") ?? "";
@@ -27280,6 +27733,7 @@ function getEmbeddingProviderIdentity(config) {
     throw new Error("Unknown embedding provider");
   }
   const truncate = config.provider === "openai-compatible" ? config.truncate?.trim() : undefined;
+  const documentPrefix = config.provider === "openai-compatible" ? resolveEmbeddingTextPrefixes(config.model, config.query_instruction, config.document_prefix).documentPrefix : "";
   const localDtype = config.provider === "local" && config.local_dtype && config.local_dtype !== "fp32" ? config.local_dtype : undefined;
   const identityInput = config.provider === "openai-compatible" ? {
     provider: "openai-compatible",
@@ -27287,6 +27741,7 @@ function getEmbeddingProviderIdentity(config) {
     endpoint: normalizeEndpoint(config.endpoint),
     apiKeyPresent: Boolean(config.api_key?.trim()),
     inputType: config.input_type?.trim() || "",
+    ...documentPrefix ? { documentPrefix } : {},
     ...truncate ? { truncate } : {}
   } : {
     provider: "local",
@@ -27968,37 +28423,6 @@ function blockedEmbeddingEndpointReason(endpoint) {
 function normalizeEndpoint2(endpoint) {
   return endpoint?.trim().replace(/\/+$/, "") ?? "";
 }
-function parseEmbeddingModel(model) {
-  const lastColon = model.lastIndexOf(":");
-  if (lastColon > model.lastIndexOf("/")) {
-    return { base: model.slice(0, lastColon), tag: model.slice(lastColon + 1) };
-  }
-  return { base: model };
-}
-function matchNormalizedEmbeddingModels(a, b) {
-  if (a.length === 0 || b.length === 0)
-    return true;
-  if (a === b)
-    return true;
-  const longer = a.length >= b.length ? a : b;
-  const shorter = a.length >= b.length ? b : a;
-  const isBoundary = (ch) => ch === "-" || ch === "/";
-  if (longer.startsWith(shorter) && isBoundary(longer.charAt(shorter.length)))
-    return true;
-  if (longer.endsWith(shorter) && isBoundary(longer.charAt(longer.length - shorter.length - 1)))
-    return true;
-  return false;
-}
-function embeddingModelsMatch(served, requested) {
-  const a = served.trim().toLowerCase();
-  const b = requested.trim().toLowerCase();
-  const servedModel = parseEmbeddingModel(a);
-  const requestedModel = parseEmbeddingModel(b);
-  if (servedModel.tag !== undefined && requestedModel.tag !== undefined && servedModel.tag !== requestedModel.tag) {
-    return false;
-  }
-  return matchNormalizedEmbeddingModels(servedModel.base, requestedModel.base);
-}
 var FAILURE_THRESHOLD = 3;
 var FAILURE_WINDOW_MS = 60000;
 var OPEN_DURATION_MS = 5 * 60000;
@@ -28012,6 +28436,8 @@ class OpenAICompatibleEmbeddingProvider {
   apiKey;
   inputType;
   queryInputType;
+  queryPrefix;
+  documentPrefix;
   truncate;
   initialized = false;
   failureTimes = [];
@@ -28026,6 +28452,9 @@ class OpenAICompatibleEmbeddingProvider {
     this.apiKey = options.apiKey?.trim() ?? "";
     this.inputType = options.inputType?.trim() ?? "";
     this.queryInputType = options.queryInputType?.trim() ?? "";
+    const prefixes = resolveEmbeddingTextPrefixes(this.model, options.queryInstruction, options.documentPrefix);
+    this.queryPrefix = prefixes.queryPrefix;
+    this.documentPrefix = prefixes.documentPrefix;
     this.truncate = options.truncate?.trim() ?? "";
     this.maxInputTokens = typeof options.maxInputTokens === "number" && Number.isFinite(options.maxInputTokens) ? Math.max(1, Math.floor(options.maxInputTokens)) : 512;
     this.modelId = getEmbeddingProviderIdentity({
@@ -28034,6 +28463,7 @@ class OpenAICompatibleEmbeddingProvider {
       model: this.model,
       ...this.apiKey ? { api_key: this.apiKey } : {},
       ...this.inputType ? { input_type: this.inputType } : {},
+      ...options.documentPrefix !== undefined ? { document_prefix: options.documentPrefix } : {},
       ...this.truncate ? { truncate: this.truncate } : {}
     });
   }
@@ -28068,7 +28498,8 @@ class OpenAICompatibleEmbeddingProvider {
     if (texts.length === 0) {
       return [];
     }
-    const requestTexts = texts.map((t) => t.trim().length === 0 ? " " : t);
+    const textPrefix = purpose === "query" ? this.queryPrefix : this.documentPrefix;
+    const requestTexts = texts.map((text) => `${textPrefix}${text.trim().length === 0 ? " " : text}`);
     if (!await this.initialize()) {
       return Array.from({ length: texts.length }, () => null);
     }
@@ -28624,6 +29055,8 @@ function resolveEmbeddingConfig(config) {
       ...apiKey ? { api_key: apiKey } : {},
       ...inputType ? { input_type: inputType } : {},
       ...queryInputType ? { query_input_type: queryInputType } : {},
+      ...config.query_instruction !== undefined ? { query_instruction: config.query_instruction } : {},
+      ...config.document_prefix !== undefined ? { document_prefix: config.document_prefix } : {},
       ...truncate ? { truncate } : {},
       ...config.max_input_tokens ? {
         max_input_tokens: normalizeCompartmentChunkMaxInputTokens(config.max_input_tokens)
@@ -28671,6 +29104,8 @@ function createProvider(config, context) {
       apiKey: config.api_key,
       inputType: config.input_type,
       queryInputType: config.query_input_type,
+      queryInstruction: config.query_instruction,
+      documentPrefix: config.document_prefix,
       truncate: config.truncate,
       maxInputTokens: config.max_input_tokens
     });
@@ -29971,8 +30406,6 @@ async function embedSessionCompartmentChunks(db, projectIdentity, sessionId, opt
   recordSessionProjectIdentity(db, sessionId, projectIdentity);
   const maxInputTokens = getProjectEmbeddingMaxInputTokens(projectIdentity);
   const total = countUnembeddedSessionCompartments(db, projectIdentity, sessionId, snapshot.chunkModelId, maxInputTokens);
-  if (total === 0)
-    return { status: "nothing", embedded: 0, total: 0 };
   const holderId = `session-embed-${randomUUID2()}`;
   const lease = acquireGitSweepLease(db, projectIdentity, holderId, { ignoreCooldown: true });
   if (!lease.acquired)
@@ -30008,7 +30441,7 @@ async function embedSessionCompartmentChunks(db, projectIdentity, sessionId, opt
         aborted = true;
         break;
       }
-      const candidates = loadUnembeddedSessionChunkCandidates(db, projectIdentity, sessionId, snapshot.chunkModelId, batchSize, [...skipIds, ...failedIds], maxInputTokens);
+      const candidates = loadUnembeddedSessionChunkCandidates(db, projectIdentity, sessionId, snapshot.chunkModelId, batchSize, [...skipIds, ...failedIds], maxInputTokens, true);
       if (candidates.length === 0)
         break;
       const {
@@ -30050,6 +30483,8 @@ async function embedSessionCompartmentChunks(db, projectIdentity, sessionId, opt
       log("[magic-context] embed drain: lease release failed (will TTL-expire):", error);
     }
   }
+  if (total === 0)
+    return { status: "nothing", embedded: 0, total: 0 };
   if (aborted)
     return { status: "aborted", embedded, total, failed: failedIds.length };
   if (providerDown || failedIds.length > 0) {
@@ -30243,6 +30678,8 @@ function createProvider2(config) {
       apiKey: config.api_key,
       inputType: config.input_type,
       queryInputType: config.query_input_type,
+      queryInstruction: config.query_instruction,
+      documentPrefix: config.document_prefix,
       truncate: config.truncate,
       maxInputTokens: config.max_input_tokens
     });
@@ -32689,24 +33126,9 @@ function validateHistorianOutput(text, _sessionId, chunk, _priorCompartments, se
   };
 }
 var HISTORIAN_PERSISTENT_FAILURE_THRESHOLD = 3;
-function buildHistorianFailureNotice(failureCount, lastError) {
-  if (failureCount >= HISTORIAN_PERSISTENT_FAILURE_THRESHOLD) {
-    return [
-      "## Magic Context — history comparting needs attention",
-      "",
-      `Magic Context has been unable to compart this session's history ${failureCount} times in a row. This usually means the configured historian model is misconfigured or unreachable (Magic Context already retried every fallback model automatically).`,
-      "",
-      `Last error: ${lastError}`,
-      "",
-      "Check your historian model in magic-context.jsonc, then restart. Your conversation keeps working normally in the meantime — this only affects how older history is summarized."
-    ].join(`
-`);
-  }
-  return [
-    "## Magic Context",
-    "",
-    "Hit a transient issue comparting history this turn — Magic Context will retry automatically on the next turn. Nothing is lost and your conversation continues normally. You'll only be alerted again if this keeps happening."
-  ].join(`
+function buildHistorianFailureNotice(failureCount, _lastError) {
+  const heading = failureCount >= HISTORIAN_PERSISTENT_FAILURE_THRESHOLD ? "## Magic Context — History compression" : "## Magic Context";
+  return [heading, "", renderUserFacingFailure("historian_unavailable")].join(`
 `);
 }
 function buildHistorianRepairPrompt(originalPrompt, previousOutput, validationError, language) {
@@ -39571,10 +39993,10 @@ Found ${existingStaging.compartments.length} staged compartment(s) from ${existi
           }
         }
       }
+      sessionLog(sessionId, `recomp partial code=${userFacingFailureCode("recomp_unavailable")} reason="${reason}"`);
       return [
-        `Persisted ${promoted.compartments.length} compartment${promoted.compartments.length === 1 ? "" : "s"} from ${passCount} successful pass${passCount === 1 ? "" : "es"}.`,
-        `Covered raw history 1-${lastCompartmentEnd} out of ${rawMessageCount} total messages.`,
-        `Remaining messages ${lastCompartmentEnd + 1}-${protectedTailStart - 1} were not rebuilt (${reason}).`
+        `Rebuilt ${promoted.compartments.length} history block${promoted.compartments.length === 1 ? "" : "s"} across ${passCount} successful pass${passCount === 1 ? "" : "es"}.`,
+        renderUserFacingFailure("recomp_unavailable")
       ].join(`
 `);
     }
@@ -39599,11 +40021,10 @@ Recomp stopped because raw history ${offset}-${protectedTailStart - 1} could not
 
 ${partial}`;
         }
+        sessionLog(sessionId, `recomp failed code=${userFacingFailureCode("recomp_unavailable")} reason="${chunkCoverageError}"`);
         return `## Magic Recomp — Failed
 
-Recomp stopped because the raw chunk could not be represented safely: ${chunkCoverageError}
-
-Nothing was written.`;
+${renderUserFacingFailure("recomp_unavailable")}`;
       }
       const references = buildReferenceBlocks({
         sessionId,
@@ -39645,11 +40066,10 @@ Historian pass ${passCount + 1}, attempt ${passAttempt} started for messages ${c
         callbacks: {
           onRepairRetry: async (error) => {
             emitProgress(`Repair retry (pass ${passCount + 1})…`);
+            sessionLog(sessionId, `recomp retry code=${userFacingFailureCode("recomp_unavailable")} reason="${error}"`);
             await sendStatusNotification2(client, sessionId, `## Magic Recomp
 
-Historian pass ${passCount + 1}, attempt ${passAttempt} is continuing with a repair retry for messages ${chunk.startIndex}-${chunk.endIndex}.
-
-The previous output did not validate: ${error}`, notifParams());
+History compression is retrying this pass. ${renderUserFacingFailure("recomp_unavailable")}`, notifParams());
           },
           onModelFallback: (modelId, index, total) => {
             const short = modelId.includes("/") ? modelId.split("/").pop() : modelId;
@@ -39664,9 +40084,7 @@ The previous output did not validate: ${error}`, notifParams());
           if (smallerChunk.messageCount > 0 && smallerChunk.endIndex < chunk.endIndex) {
             await sendStatusNotification2(client, sessionId, `## Magic Recomp
 
-Historian pass ${passCount + 1}, attempt ${passAttempt} is continuing with a smaller chunk ending at ${smallerChunk.endIndex} because messages ${chunk.startIndex}-${chunk.endIndex} could not be validated.
-
-Validator result: ${validatedPass.error}`, notifParams());
+History compression is retrying with a smaller set of messages. ${renderUserFacingFailure("recomp_unavailable")}`, notifParams());
             currentTokenBudget = reducedBudget;
             passAttempt += 1;
             continue;
@@ -39683,7 +40101,8 @@ Validator result: ${validatedPass.error}`, notifParams());
           chunkEndOrdinal: chunk.endIndex,
           compartmentsProduced: 0
         });
-        const partial = await promoteAndFinalize(`historian failed to validate messages ${chunk.startIndex}-${chunk.endIndex}: ${validatedPass.error}`);
+        sessionLog(sessionId, `recomp failed code=${userFacingFailureCode("recomp_unavailable")} reason="${validatedPass.error}" messageRange=${chunk.startIndex}-${chunk.endIndex}`);
+        const partial = await promoteAndFinalize(`history model response did not validate for messages ${chunk.startIndex}-${chunk.endIndex}`);
         if (partial) {
           return `## Magic Recomp — Partial
 
@@ -39691,9 +40110,7 @@ ${partial}`;
         }
         return `## Magic Recomp — Failed
 
-Recomp failed while rebuilding messages ${chunk.startIndex}-${chunk.endIndex}: ${validatedPass.error}
-
-Nothing was written.`;
+${renderUserFacingFailure("recomp_unavailable")}`;
       }
       {
         const passComps = validatedPass.compartments ?? [];
@@ -39744,11 +40161,10 @@ Recomp made no forward progress after messages ${chunk.startIndex}-${chunk.endIn
     const mergedValidationError = validateStoredCompartments(candidateCompartments);
     if (mergedValidationError) {
       clearRecompStaging(db, sessionId);
+      sessionLog(sessionId, `recomp failed code=${userFacingFailureCode("recomp_unavailable")} reason="${mergedValidationError}"`);
       return `## Magic Recomp — Failed
 
-Recomp completed ${passCount} pass${passCount === 1 ? "" : "es"} but produced an invalid final compartment set: ${mergedValidationError}
-
-Nothing was written.`;
+${renderUserFacingFailure("recomp_unavailable")}`;
     }
     saveRecompStagingPass(db, sessionId, passCount, candidateCompartments, candidateFacts);
     const lastCompartmentEnd = candidateCompartments[candidateCompartments.length - 1]?.endMessage ?? 0;
@@ -39800,11 +40216,10 @@ Another process acquired the compartment-state lease before recomp could publish
 `);
   } catch (error) {
     const message = getErrorMessage(error);
+    sessionLog(sessionId, `recomp failed code=${userFacingFailureCode("recomp_unavailable")} reason="${message}"`);
     return `## Magic Recomp — Failed
 
-Recomp failed unexpectedly: ${message}
-
-Staging data preserved for resume on next attempt.`;
+${renderUserFacingFailure("recomp_unavailable")}`;
   } finally {
     updateSessionMeta2(db, sessionId, { compartmentInProgress: false });
     cleanupHistorianStateFile(currentStateFilePath);
@@ -40022,11 +40437,10 @@ Recomp stopped because raw history ${offset}-${snapEnd} could not be turned into
       }
       const chunkCoverageError = validateChunkCoverage(chunk);
       if (chunkCoverageError) {
+        log(`[magic-context] partial recomp failed session=${sessionId} code=${userFacingFailureCode("recomp_unavailable")} reason="${chunkCoverageError}"`);
         return `## Magic Recomp — Failed
 
-Partial recomp stopped because the raw chunk could not be represented safely: ${chunkCoverageError}
-
-Original state preserved (staging kept for retry).`;
+${renderUserFacingFailure("recomp_unavailable")}`;
       }
       const references = buildReferenceBlocks({
         sessionId,
@@ -40066,11 +40480,10 @@ Historian pass ${passCount + 1}, attempt ${passAttempt} started for messages ${c
         language: deps.language,
         callbacks: {
           onRepairRetry: async (error) => {
+            log(`[magic-context] partial recomp retry session=${sessionId} code=${userFacingFailureCode("recomp_unavailable")} reason="${error}"`);
             await sendStatusNotification2(client, sessionId, `## Magic Recomp — Partial
 
-Historian pass ${passCount + 1}, attempt ${passAttempt} is continuing with a repair retry for messages ${chunk.startIndex}-${chunk.endIndex}.
-
-The previous output did not validate: ${error}`, notifParams());
+History compression is retrying this pass. ${renderUserFacingFailure("recomp_unavailable")}`, notifParams());
           }
         }
       });
@@ -40081,19 +40494,16 @@ The previous output did not validate: ${error}`, notifParams());
           if (smallerChunk.messageCount > 0 && smallerChunk.endIndex < chunk.endIndex) {
             await sendStatusNotification2(client, sessionId, `## Magic Recomp — Partial
 
-Historian pass ${passCount + 1}, attempt ${passAttempt} is continuing with a smaller chunk ending at ${smallerChunk.endIndex} because messages ${chunk.startIndex}-${chunk.endIndex} could not be validated.
-
-Validator result: ${validatedPass.error}`, notifParams());
+History compression is retrying with a smaller set of messages. ${renderUserFacingFailure("recomp_unavailable")}`, notifParams());
             currentTokenBudget = reducedBudget;
             passAttempt += 1;
             continue;
           }
         }
+        log(`[magic-context] partial recomp failed session=${sessionId} code=${userFacingFailureCode("recomp_unavailable")} reason="${validatedPass.error}" messageRange=${chunk.startIndex}-${chunk.endIndex}`);
         return `## Magic Recomp — Failed
 
-Partial recomp failed while rebuilding messages ${chunk.startIndex}-${chunk.endIndex}: ${validatedPass.error}
-
-Original state preserved (staging kept for retry).`;
+${renderUserFacingFailure("recomp_unavailable")}`;
       }
       candidateCompartments = [
         ...candidateCompartments,
@@ -40128,11 +40538,10 @@ Partial recomp completed historian passes but the final compartment set failed v
 `);
   } catch (error) {
     const message = getErrorMessage(error);
+    log(`[magic-context] partial recomp failed session=${sessionId} code=${userFacingFailureCode("recomp_unavailable")} reason="${message}"`);
     return `## Magic Recomp — Failed
 
-Partial recomp failed unexpectedly: ${message}
-
-Staging preserved for resume on next attempt.`;
+${renderUserFacingFailure("recomp_unavailable")}`;
   } finally {
     updateSessionMeta2(db, sessionId, { compartmentInProgress: false });
     const leftoverStaging = getRecompStaging(db, sessionId);
@@ -40834,10 +41243,12 @@ async function runManagedRecomp2(ctx, sessionId, options) {
     setRecompTerminal2(ctx.liveSessionState, sessionId, terminalPhase, extractRecompReason(message));
     return message;
   } catch (error) {
-    setRecompTerminal2(ctx.liveSessionState, sessionId, "failed", `Recomp crashed: ${String(error)}`);
+    const failure = renderUserFacingFailure("recomp_unavailable");
+    sessionLog(sessionId, `recomp failed code=${userFacingFailureCode("recomp_unavailable")}`, error);
+    setRecompTerminal2(ctx.liveSessionState, sessionId, "failed", failure);
     return `## Magic Recomp — Failed
 
-Recomp crashed: ${String(error)}`;
+${failure}`;
   }
 }
 async function runManagedUpgrade2(ctx, sessionId) {
@@ -40896,10 +41307,12 @@ ${migrationSummary}` : ""
     ].join(`
 `);
   } catch (error) {
-    setRecompTerminal2(ctx.liveSessionState, sessionId, "failed", `Upgrade crashed: ${String(error)}`);
+    const failure = renderUserFacingFailure("recomp_unavailable");
+    sessionLog(sessionId, `session upgrade failed code=${userFacingFailureCode("recomp_unavailable")}`, error);
+    setRecompTerminal2(ctx.liveSessionState, sessionId, "failed", failure);
     return `## Session Upgrade — Failed
 
-Upgrade crashed: ${String(error)}`;
+${failure}`;
   }
 }
 async function runUpgradeMemoryMigration(ctx, sessionId, migrationDirectory) {
@@ -40930,8 +41343,9 @@ async function runUpgradeMemoryMigration(ctx, sessionId, migrationDirectory) {
     });
     return outcome.summary;
   } catch (error) {
-    return `Memory migration skipped (error): ${String(error)}`;
+    sessionLog(sessionId, `memory migration failed code=${userFacingFailureCode("dream_unknown")}`, error);
+    return renderUserFacingFailure("dream_unknown");
   }
 }
 
-export { withContentLanguageDirective, buildPrimaryLanguageDirective, setJsoncValue, removeJsoncValue, cortexKitUserConfigBasePath, cortexKitProjectConfigBasePath, resolveLegacyConfigSources, resolveLegacyConfigSourcesForHarness, migrateMagicContextConfigLocations, string, unknown, array, object, union, tuple, record, parseCron, nextOccurrence, nextDueAtMs, promptSurfaceConfigIdentity, resolveModelConfigValue, resolvePromptSurface, resolveModelConfigOrDefault, DEFAULT_EXECUTE_THRESHOLD_PERCENTAGE, DEFAULT_HISTORIAN_TIMEOUT_MS, DEFAULT_LOCAL_EMBEDDING_MODEL, PER_HARNESS_MIGRATION_INVENTORY, PER_HARNESS_MODEL_KEYS, ConfigProfilesSchema, MagicContextConfigSchema, isFailClosedBlockingError, shouldBypassFailClosedBlock, resolveAgentNameFromMessages, createFailClosedController, recordHookInitFailure, clearHookInitFailure, getLastHookInitFailure, ProjectIdentityError, resolveProjectIdentityStrict, takeDubiousOwnershipProjectIdentityWarning, resolveProjectIdentity, directoryHasGitMetadata, resolveProjectIdentityForSession, normalizeStoredProjectPath, storedPathBelongsToIdentity, isLinkedGitWorktree, recordSessionProjectIdentity, beginBootQuietPeriod, bootQuietRemainingMs, scheduleAfterBootQuiet, rpcPortDir, rpcPortFilePath, isPidAlive, parseRpcPortFile, observeAuthorityRouting, registerModuleNoteEvaluationBridge, getModuleNoteEvaluationBridge, getContextStoreUuid, ensureContextStoreUuid, getAuthorityManagedMarker, reconcileAuthorityProject, checksumAuthoritySeedRows, prepareAuthority, drainAuthority, applyMirroredNoteCompileFields, drainMirrorPages, pullMemoryMirrorOnce, V2_MEMORY_CATEGORIES, CATEGORY_PRIORITY, resolveWorkspaceShareCategories, resolveWorkspaceIdentitySet, expandWorkspaceIdentitySetWithAliases, resolveStoredPathWorkspaceIdentity, storedPathBelongsToWorkspace, sourceNameForMemory, computeWorkspaceEpochFingerprint, textMentionsRecentCommit, hasMeaningfulUserText, extractTexts, extractToolCallSummaries, getTokenizerNativeMemoryStats, preloadTokenizer, estimateTokens, normalizeText, getCurrentToolSetHash, recordToolDefinition, getMeasuredToolDefinitionTokens, getSchemaFenceRejection, getMigrationOnOpenRefusal, LATEST_SUPPORTED_VERSION, getDatabasePath, getPersistedSchemaVersion, setSqlitePragmaConfig, runSqliteOptimize, openDatabase, openDatabaseAsync, isDatabasePersisted, getDatabasePersistenceError, COMPARTMENT_AGENT_SYSTEM_PROMPT, HISTORIAN_EDITOR_SYSTEM_PROMPT, COMPARTMENT_STRUCTURAL_SYSTEM_PROMPT, Priority, AdmissionClass, SocketClosedError, SocketTimeoutError, StaleRouteHandleError, SubcClient, isConsumerReconnectTransient, connectionFileExists, isRecord, CTX_REDUCE_KEEP, newestCtxReduceTagNumbers, stripWellFormedLeadingTagPrefix, stripPersistedAssistantText, byteSize, stripTagPrefix, prependTag, isThinkingPart, estimateImageTokensFromDataUrl, normalizeTodoStateJson, buildSyntheticTodoPart, computeSyntheticCallId, isSyntheticTodoPart, countRealUserMessages, tailHygieneStructuralSignature, sameTailHygieneStructuralSignature, refreshTailHygieneBaseline, effectiveTailHygiene, assertTailHygieneContentUnchanged, CHANNEL1_SENTINEL, CHANNEL1_FLOOR_TOKENS, toolOutputTokens, decideChannel1, evaluateChannel2, formatChannel1Evaluation, formatChannel2Evaluation, reclaimableToolOutputCount, buildChannel2Reminder, buildChannel1Reminder, estimateEmergencyDropReclaimTokens, planEmergencyDrop, getRecentTagOwnerMessageIds, AGE_RECLAIM_MIN_TOKENS, getOldestActiveUnprotectedToolTags, getActiveToolTagsForAgeReclaim, getTriggerTagTokenUpperBound, getActiveTagTokenTotalsByMessage, tagTokenCountIsNull, backfillTagTokenCounts, insertTag, updateTagStatus, markWhitespaceAssistantTagInert, getInertWhitespaceAssistantTags, updateTagDropMode, updateCavemanDepth, updateTagMessageId, markTagsCompactedByMessageIds, deleteTagsByMessageId, getMaxTagNumberBySession, getTagNumberByMessageId, getAssignableTagNumberByMessageId, deriveTagLoadFloor, getTagsBySession, getActiveTagsBySession, getTailHygieneTags, getDroppedTagsBySession, getTagsByNumbers, getDroppedTagsByNumbers, getMaxDroppedTagNumber, getTagById, getToolTagNumberByOwner, getNullOwnerToolTag, adoptNullOwnerToolTag, getCandidateToolOwners, pickNearestPriorOwner, isRawCompactionSummaryInfo, extractInMemoryMessageViews, buildInMemoryTailRawMessages, estimateTrueRawMessageTokens, invalidateTrueRawTokenCache, isTextPart, isToolPartWithOutput, isFilePart, buildFileSourceContent, createDroppedInputToolExecuteBeforeHook, isEditTool, partHasCompletedResult, extractToolCallObservation, ToolMutationBatch, createToolDropTarget, setRawMessageProvider, cleanUserText, withRawSessionMessageCache, readRawSessionMessages, primeTailRawMessageCache, primeInMemoryTailRawMessageCache, readRawSessionMessageOrdinalPage, getRawSessionStoredMessageCount, readRawSessionMessagePartsById, readRawSessionMessageOrdinalById, readRawSessionMessageById, readSessionChunk, readRawSessionSeedTail, COMPARTMENT_LEASE_RENEWAL_MS, acquireCompartmentLease, renewCompartmentLease, releaseCompartmentLeaseBestEffort, HAS_COMPARTMENT_CONTENT_SQL, getCompartments, getLastCompartmentEndMessage, getLastCompartmentEndMessageId, clearRecompStaging, getMessageIndexSourceIdentity, isMessageIndexSourceCurrent, getLastIndexedOrdinal, getIndexedMessageCorpusSize, getMessageIndexReconciliationStartOrdinal, isMessageIndexReconciledThrough, deleteIndexedMessage, clearIndexedMessages, indexSingleMessage, indexMessagesAfterOrdinal, sweepOrphanedOpenCodeMessageIndexes, recordEmbeddingMeasurement, getMaxM0MutationId, queueMemoryMutation, getMemoryMutationsForRenderByProjects, getMaxMemoryMutationIdForProjects, MAX_EXECUTE_THRESHOLD, escalationBands, MERGED_REASONING_PARTS_PREFIX, readFrozenMergedReasoningParts, getProtectionWindowForSession, isEmergencyRecoveryArmed, isProviderOverflowReconfirmed, isProviderOverflowFailClosedProven, getEmergencyRecoveryArmedAt, loadPersistedUsage, loadProtectedTailMeta, resetProtectedTailNoEligibleHead, getWrapupInProgressState, acquireWrapupInProgress, updateWrapupInProgress, releaseWrapupInProgress, resolveCompactionModeRecord, getCompactionModeRecord, setCompactionModeRecord, getPersistedReasoningWatermark, setPersistedReasoningWatermark, clearPersistedReasoningWatermark, getEmergencyInputSample, setEmergencyDropSample, clearEmergencyDropSample, getLastNudgeUndropped, setLastNudgeUndropped, getChannel1NudgeState, setChannel1NudgeState, markChannel1PostReduceGracePending, captureChannel1PostReduceGraceBaseline, getChannel2NudgeState, getChannel2NudgeClaim, setChannel2NudgeState, casChannel2NudgeState, claimChannel2NudgeState, casChannel2NudgeClaim, getPersistedNoteNudge, getNoteNudgeAnchors, getAutoSearchHintDecisions, appendAutoSearchHintDecision, pruneNoteNudgeAnchors, pruneAutoSearchHintDecisions, removeNoteNudgeAnchorByMessageId, removeAutoSearchHintDecisionByMessageId, getPersistedTodoPermissionDenied, setPersistedTodoPermissionDenied, getPersistedTodoSyntheticAnchor, setPersistedTodoSyntheticAnchor, clearPersistedTodoSyntheticAnchor, setNoteLastReadAt, getHistorianFailureState, clearHistorianFailureState, getOverflowState, loadTransformPassStateSnapshot, recordOverflowDetected, recordDetectedContextLimit, clearEmergencyRecovery, clearDetectedContextLimit, getPersistedCompactionMarkerState, setPersistedCompactionMarkerState, getStrippedPlaceholderIds, applyStrippedPlaceholderDelta, removeStrippedPlaceholderId, NEWEST_REASONING_BEARING_ASSISTANT, THINKING_BINDING_RECOVERY_FROZEN_PREFIX, thinkingBindingRecoveryFrozenId, getThinkingBindingRecoveryTarget, armThinkingBindingRecovery, clearThinkingBindingRecoveryIf, getMergedReasoningStrippedIds, addMergedReasoningStrippedIds, getTrailingBlankDecisions, addTrailingBlankDecisions, demoteTrailingBlankKeepDecisions, getStaleReduceStrippedIds, addStaleReduceStrippedIds, getProcessedImageStrippedIds, addProcessedImageStrippedIds, getPendingCompactionMarkerState, loadPostprocessReplaySnapshot, setPendingCompactionMarkerState, clearPendingCompactionMarkerStateIf, getSessionsWithPendingMarker, setSessionWorkMetrics, getObservedEpochFloor, resolveEpochFloorForPass, getNotes, addNote, getSessionNotes, getPendingSmartNotes, getReadySmartNotes, updateNote, dismissNotes, dismissNote, markNoteReady, markNoteChecked, queuePendingOp, getPendingOps, getPendingOpsCount, clearPendingOps, removePendingOp, PRIMER_CANDIDATE_TTL_MS, PRIMER_CANDIDATE_MAX_AGE_MS, primerOccurrenceKey, primerOccurrenceUtcDay, updatePrimerCandidateEmbedding, getPrimerCandidatesByIds, getPrimerCandidatesForPromotion, countPrimerCandidatesForProject, getActivePrimers, createPrimer, updatePrimerSupport, updatePrimerAnswer, GLOBAL_USER_PROFILE_PROJECT_PATH, getProjectState, bumpProjectMemoryEpoch, bumpProjectUserProfileVersion, saveSourceContent, replaceSourceContent, getSourceContents, createChildSessionWithFence, detectThinkingBindingMismatch, isFable51ThinkingBindingModel, detectOverflow, modelBodyField, toModelEntry, getPromptFailureDetail, promptSyncWithValidatedOutputRetry, normalizeSDKResponse, promptSurfaceHashMaterial, createPromptSurfaceRuntime, createPromptSurfaceGuidanceEpochCache, extractLatestAssistantText, hasLengthCappedOutput, setKeepSubagents, teardownChildSession, getCompartmentEvents, SYNAPSE_DEFAULT_MODEL, toSynapseLaneDescriptor, formatSynapseLaneDescriptor, SynapseEmbeddingProvider, loadCompartmentChunkEmbeddingsForSearch, cosineSimilarity, computeNormalizedHash, getLocalEmbeddingNativeMemoryStats, saveCommitEmbedding, loadProjectCommitEmbeddings, loadUnembeddedCommits, countEmbeddedCommits, upsertCommits, getLatestIndexedCommitTimeMs, enforceProjectCap, GIT_SWEEP_LEASE_RENEWAL_MS, acquireGitSweepLease, renewGitSweepLease, markGitSweepSuccessAndRelease, parkGitSweepNonIndexable, releaseGitSweepLease, saveEmbeddingIfHashMatches, getProjectEmbeddings, peekProjectEmbeddings, invalidateProject, invalidateMemory, describeShadowBackfillWriteRefusal, markProjectLoadUntrusted, contentSha256, sweepStaleEmbeddingIdentitiesForProject, registerProjectEmbedding, registerProjectShadowEmbedding, getShadowEmbeddingMeasurementCohort, getPrimaryEmbeddingMeasurementCohort, embedShadowTextForProject, enqueueShadowEmbeddingItems, registerProjectInObservationMode, getProjectEmbeddingSnapshot, embedTextForProject, embedBatchForProject, embedItemsForProject, embedUnembeddedMemoriesForProject, drainCommitBacklogForProject, embedSessionCompartmentChunks, getEmbeddingCoverageStatus, isEmbeddingEnabled, embedText, ensureMemoryEmbeddings, computeCueContentHash, hasMuralCueColumns, getMuralCueState, memoryNeedsCue, setMuralCue, recordMuralCueRejection, hasMemoryShareableColumn, hasMemoryClassifiedAtColumn, getUnclassifiedMemoryIds, ModuleMemoryAuthorityError, insertMemory, insertMemoryIdempotent, getMemoryByHash, getMemoriesByProject, buildWorkspaceMemorySqlFilter, getMemoriesByProjects, getMaxMemoryIdForProjects, readNewMemoriesForM1Union, getMemoryById, getMemoriesByIds, updateMemorySeenCount, updateMemoryRetrievalCount, setMemoryClassification, supersededMemory, mergeMemoryStats, archiveMemory, getMemoryCountsByStatus, sanitizeFtsQuery, searchMemoriesFTS, searchMemoriesFTSUnion, recordMemoryMapping, recordMemoryVerifications, getUnmappedMemoryIds, clearMemoryVerifications, getMemoryVerifications, resolveGitTopLevel, readGitHead, readGitChangedFilesSince, readGitFileChangeTimesSince, verificationFileExists, normalizeVerificationFiles, recordChildInvocation, USER_MEMORY_CANDIDATE_TTL_MS, insertUserMemoryCandidates, getUserMemoryCandidates, deleteUserMemoryCandidates, pruneExpiredUserMemoryCandidates, insertUserMemory, getActiveUserMemories, updateUserMemoryContent, dismissUserMemory, getMural, BoundedSessionMap, registerLkgPersistence, beginLkgPass, visitMessageContentFields, messageContentFields, signatureForFields, exactReusablePrefix, incrementalLkgContentDigests, lkgContentDigest, captureSlot, getInMemorySlot, getSlot, dropSlot, noteEntry, getLkgSlotHeapStats, onNoteTrigger, peekNoteNudgeText, markNoteNudgeDelivered, clearNoteNudgeTriggerAndCooldown, resetNoteNudgeCooldownOnly, clearNoteNudgeTriggerOnly, getOpenCodeDbPath, removeMcOwnedCompactionMarkers, MARKER_SUMMARY_TEXT, applyDeferredCompactionMarker, removeCompactionMarkerForSession, checkCompactionMarkerConsistency, modelKeyAcceptsImages, resolveMuralWire, extractM0Block, formatDate, injectTemporalMarkers, clearInjectionCache, getVisibleMemoryIds, selectHiddenMessagesAtCompactionSeam, prepareCompartmentInjection, renderCompartmentInjection, mustMaterialize, trimMemoriesToBudgetV2, renderMemoryBlockV2, prepareCachedM0M1Replay, hasCompleteCachedM0M1, injectM0M1, describeBoundaryDiagnostics, RECOVERY_NO_HEAD_LIMIT, resolveOpenCodeProtectedTailBoundary, resolveWrapupProtectedTailBoundary, getRawHistoryEligibility, hasRunnableCompartmentWindow, recordHighPressureNoEligibleHead, runCompartmentAgent, snapRangeToCompartments, getActiveCompartmentRun, markActiveCompartmentRunPublished, registerActiveCompartmentRun, startCompartmentAgent, setRecompStarting2, setRecompTerminal2, runManagedRecomp2, runManagedUpgrade2 };
+export { withContentLanguageDirective, buildPrimaryLanguageDirective, setJsoncValue, removeJsoncValue, cortexKitUserConfigBasePath, cortexKitProjectConfigBasePath, resolveLegacyConfigSources, resolveLegacyConfigSourcesForHarness, migrateMagicContextConfigLocations, string, unknown, array, object, union, tuple, record, parseCron, nextOccurrence, nextDueAtMs, promptSurfaceConfigIdentity, resolveModelConfigValue, resolvePromptSurface, resolveModelConfigOrDefault, DEFAULT_EXECUTE_THRESHOLD_PERCENTAGE, DEFAULT_HISTORIAN_TIMEOUT_MS, DEFAULT_LOCAL_EMBEDDING_MODEL, PER_HARNESS_MIGRATION_INVENTORY, PER_HARNESS_MODEL_KEYS, ConfigProfilesSchema, MagicContextConfigSchema, isFailClosedBlockingError, shouldBypassFailClosedBlock, resolveAgentNameFromMessages, createFailClosedController, recordHookInitFailure, clearHookInitFailure, getLastHookInitFailure, ProjectIdentityError, resolveProjectIdentityStrict, takeDubiousOwnershipProjectIdentityWarning, resolveProjectIdentity, directoryHasGitMetadata, resolveProjectIdentityForSession, normalizeStoredProjectPath, storedPathBelongsToIdentity, isLinkedGitWorktree, recordSessionProjectIdentity, beginBootQuietPeriod, bootQuietRemainingMs, scheduleAfterBootQuiet, rpcPortDir, rpcPortFilePath, isPidAlive, parseRpcPortFile, observeAuthorityRouting, registerModuleNoteEvaluationBridge, getModuleNoteEvaluationBridge, getContextStoreUuid, ensureContextStoreUuid, getAuthorityManagedMarker, reconcileAuthorityProject, checksumAuthoritySeedRows, prepareAuthority, drainAuthority, applyMirroredNoteCompileFields, drainMirrorPages, pullMemoryMirrorOnce, V2_MEMORY_CATEGORIES, CATEGORY_PRIORITY, resolveWorkspaceShareCategories, resolveWorkspaceIdentitySet, expandWorkspaceIdentitySetWithAliases, resolveStoredPathWorkspaceIdentity, storedPathBelongsToWorkspace, sourceNameForMemory, computeWorkspaceEpochFingerprint, textMentionsRecentCommit, hasMeaningfulUserText, extractTexts, extractToolCallSummaries, getTokenizerNativeMemoryStats, preloadTokenizer, estimateTokens, normalizeText, getCurrentToolSetHash, recordToolDefinition, getMeasuredToolDefinitionTokens, getSchemaFenceRejection, getMigrationOnOpenRefusal, LATEST_SUPPORTED_VERSION, getDatabasePath, getPersistedSchemaVersion, setSqlitePragmaConfig, runSqliteOptimize, openDatabase, openDatabaseAsync, isDatabasePersisted, getDatabasePersistenceError, COMPARTMENT_AGENT_SYSTEM_PROMPT, HISTORIAN_EDITOR_SYSTEM_PROMPT, COMPARTMENT_STRUCTURAL_SYSTEM_PROMPT, Priority, AdmissionClass, SocketClosedError, SocketTimeoutError, StaleRouteHandleError, SubcClient, isConsumerReconnectTransient, connectionFileExists, isRecord, CTX_REDUCE_KEEP, newestCtxReduceTagNumbers, stripWellFormedLeadingTagPrefix, stripPersistedAssistantText, byteSize, stripTagPrefix, prependTag, isThinkingPart, estimateImageTokensFromDataUrl, normalizeTodoStateJson, buildSyntheticTodoPart, computeSyntheticCallId, isSyntheticTodoPart, countRealUserMessages, tailHygieneStructuralSignature, sameTailHygieneStructuralSignature, refreshTailHygieneBaseline, effectiveTailHygiene, assertTailHygieneContentUnchanged, CHANNEL1_SENTINEL, CHANNEL1_FLOOR_TOKENS, toolOutputTokens, decideChannel1, evaluateChannel2, formatChannel1Evaluation, formatChannel2Evaluation, reclaimableToolOutputCount, buildChannel2Reminder, buildChannel1Reminder, estimateEmergencyDropReclaimTokens, planEmergencyDrop, getRecentTagOwnerMessageIds, AGE_RECLAIM_MIN_TOKENS, getOldestActiveUnprotectedToolTags, getActiveToolTagsForAgeReclaim, getTriggerTagTokenUpperBound, getActiveTagTokenTotalsByMessage, tagTokenCountIsNull, backfillTagTokenCounts, insertTag, updateTagStatus, markWhitespaceAssistantTagInert, getInertWhitespaceAssistantTags, updateTagDropMode, updateCavemanDepth, updateTagMessageId, markTagsCompactedByMessageIds, deleteTagsByMessageId, getMaxTagNumberBySession, getTagNumberByMessageId, getAssignableTagNumberByMessageId, deriveTagLoadFloor, getTagsBySession, getActiveTagsBySession, getTailHygieneTags, getDroppedTagsBySession, getTagsByNumbers, getDroppedTagsByNumbers, getMaxDroppedTagNumber, getTagById, getToolTagNumberByOwner, getNullOwnerToolTag, adoptNullOwnerToolTag, getCandidateToolOwners, pickNearestPriorOwner, isRawCompactionSummaryInfo, extractInMemoryMessageViews, buildInMemoryTailRawMessages, estimateTrueRawMessageTokens, invalidateTrueRawTokenCache, isTextPart, isToolPartWithOutput, isFilePart, buildFileSourceContent, createDroppedInputToolExecuteBeforeHook, isEditTool, partHasCompletedResult, extractToolCallObservation, ToolMutationBatch, createToolDropTarget, setRawMessageProvider, cleanUserText, withRawSessionMessageCache, readRawSessionMessages, primeTailRawMessageCache, primeInMemoryTailRawMessageCache, readRawSessionMessageOrdinalPage, getRawSessionStoredMessageCount, readRawSessionMessagePartsById, readRawSessionMessageOrdinalById, readRawSessionMessageById, readSessionChunk, readRawSessionSeedTail, COMPARTMENT_LEASE_RENEWAL_MS, acquireCompartmentLease, renewCompartmentLease, releaseCompartmentLeaseBestEffort, HAS_COMPARTMENT_CONTENT_SQL, getCompartments, getLastCompartmentEndMessage, getLastCompartmentEndMessageId, clearRecompStaging, getMessageIndexSourceIdentity, isMessageIndexSourceCurrent, getLastIndexedOrdinal, getIndexedMessageCorpusSize, getMessageIndexReconciliationStartOrdinal, isMessageIndexReconciledThrough, deleteIndexedMessage, clearIndexedMessages, indexSingleMessage, indexMessagesAfterOrdinal, sweepOrphanedOpenCodeMessageIndexes, recordEmbeddingMeasurement, getMaxM0MutationId, queueMemoryMutation, getMemoryMutationsForRenderByProjects, getMaxMemoryMutationIdForProjects, MAX_EXECUTE_THRESHOLD, escalationBands, MERGED_REASONING_PARTS_PREFIX, readFrozenMergedReasoningParts, getProtectionWindowForSession, isEmergencyRecoveryArmed, isProviderOverflowReconfirmed, isProviderOverflowFailClosedProven, getEmergencyRecoveryArmedAt, loadPersistedUsage, loadProtectedTailMeta, resetProtectedTailNoEligibleHead, getWrapupInProgressState, acquireWrapupInProgress, updateWrapupInProgress, releaseWrapupInProgress, resolveCompactionModeRecord, getCompactionModeRecord, setCompactionModeRecord, getPersistedReasoningWatermark, setPersistedReasoningWatermark, clearPersistedReasoningWatermark, getEmergencyInputSample, setEmergencyDropSample, clearEmergencyDropSample, getLastNudgeUndropped, setLastNudgeUndropped, getChannel1NudgeState, setChannel1NudgeState, markChannel1PostReduceGracePending, captureChannel1PostReduceGraceBaseline, getChannel2NudgeState, getChannel2NudgeClaim, setChannel2NudgeState, casChannel2NudgeState, claimChannel2NudgeState, casChannel2NudgeClaim, getPersistedNoteNudge, getNoteNudgeAnchors, getAutoSearchHintDecisions, appendAutoSearchHintDecision, pruneNoteNudgeAnchors, pruneAutoSearchHintDecisions, removeNoteNudgeAnchorByMessageId, removeAutoSearchHintDecisionByMessageId, getPersistedTodoPermissionDenied, setPersistedTodoPermissionDenied, getPersistedTodoSyntheticAnchor, setPersistedTodoSyntheticAnchor, clearPersistedTodoSyntheticAnchor, setNoteLastReadAt, getHistorianFailureState, clearHistorianFailureState, getOverflowState, loadTransformPassStateSnapshot, recordOverflowDetected, recordDetectedContextLimit, clearEmergencyRecovery, clearDetectedContextLimit, getPersistedCompactionMarkerState, setPersistedCompactionMarkerState, getStrippedPlaceholderIds, applyStrippedPlaceholderDelta, removeStrippedPlaceholderId, NEWEST_REASONING_BEARING_ASSISTANT, THINKING_BINDING_RECOVERY_FROZEN_PREFIX, thinkingBindingRecoveryFrozenId, getThinkingBindingRecoveryTarget, armThinkingBindingRecovery, clearThinkingBindingRecoveryIf, getMergedReasoningStrippedIds, addMergedReasoningStrippedIds, getTrailingBlankDecisions, addTrailingBlankDecisions, demoteTrailingBlankKeepDecisions, getStaleReduceStrippedIds, addStaleReduceStrippedIds, getProcessedImageStrippedIds, addProcessedImageStrippedIds, getPendingCompactionMarkerState, loadPostprocessReplaySnapshot, setPendingCompactionMarkerState, clearPendingCompactionMarkerStateIf, getSessionsWithPendingMarker, setSessionWorkMetrics, getObservedEpochFloor, resolveEpochFloorForPass, getNotes, addNote, getSessionNotes, getPendingSmartNotes, getReadySmartNotes, updateNote, dismissNotes, dismissNote, markNoteReady, markNoteChecked, queuePendingOp, getPendingOps, getPendingOpsCount, clearPendingOps, removePendingOp, PRIMER_CANDIDATE_TTL_MS, PRIMER_CANDIDATE_MAX_AGE_MS, primerOccurrenceKey, primerOccurrenceUtcDay, updatePrimerCandidateEmbedding, getPrimerCandidatesByIds, getPrimerCandidatesForPromotion, countPrimerCandidatesForProject, getActivePrimers, createPrimer, updatePrimerSupport, updatePrimerAnswer, GLOBAL_USER_PROFILE_PROJECT_PATH, getProjectState, bumpProjectMemoryEpoch, bumpProjectUserProfileVersion, saveSourceContent, replaceSourceContent, getSourceContents, createChildSessionWithFence, detectThinkingBindingMismatch, isFable51ThinkingBindingModel, detectOverflow, modelBodyField, toModelEntry, getPromptFailureDetail, promptSyncWithValidatedOutputRetry, normalizeSDKResponse, promptSurfaceHashMaterial, createPromptSurfaceRuntime, createPromptSurfaceGuidanceEpochCache, extractLatestAssistantText, hasLengthCappedOutput, setKeepSubagents, teardownChildSession, renderUserFacingFailure, userFacingFailureCode, renderCapabilityRefusal, capabilityRefusalCode, renderDreamFailure, dreamFailureCode, renderEmbeddingFailure, getCompartmentEvents, SYNAPSE_DEFAULT_MODEL, toSynapseLaneDescriptor, formatSynapseLaneDescriptor, SynapseEmbeddingProvider, loadCompartmentChunkEmbeddingsForSearch, cosineSimilarity, computeNormalizedHash, getLocalEmbeddingNativeMemoryStats, saveCommitEmbedding, loadProjectCommitEmbeddings, loadUnembeddedCommits, countEmbeddedCommits, upsertCommits, getLatestIndexedCommitTimeMs, enforceProjectCap, GIT_SWEEP_LEASE_RENEWAL_MS, acquireGitSweepLease, renewGitSweepLease, markGitSweepSuccessAndRelease, parkGitSweepNonIndexable, releaseGitSweepLease, saveEmbeddingIfHashMatches, getProjectEmbeddings, peekProjectEmbeddings, invalidateProject, invalidateMemory, describeShadowBackfillWriteRefusal, markProjectLoadUntrusted, contentSha256, sweepStaleEmbeddingIdentitiesForProject, registerProjectEmbedding, registerProjectShadowEmbedding, getShadowEmbeddingMeasurementCohort, getPrimaryEmbeddingMeasurementCohort, embedShadowTextForProject, enqueueShadowEmbeddingItems, registerProjectInObservationMode, getProjectEmbeddingSnapshot, embedTextForProject, embedBatchForProject, embedItemsForProject, embedUnembeddedMemoriesForProject, drainCommitBacklogForProject, embedSessionCompartmentChunks, getEmbeddingCoverageStatus, isEmbeddingEnabled, embedText, ensureMemoryEmbeddings, computeCueContentHash, hasMuralCueColumns, getMuralCueState, memoryNeedsCue, setMuralCue, recordMuralCueRejection, hasMemoryShareableColumn, hasMemoryClassifiedAtColumn, getUnclassifiedMemoryIds, ModuleMemoryAuthorityError, insertMemory, insertMemoryIdempotent, getMemoryByHash, getMemoriesByProject, buildWorkspaceMemorySqlFilter, getMemoriesByProjects, getMaxMemoryIdForProjects, readNewMemoriesForM1Union, getMemoryById, getMemoriesByIds, updateMemorySeenCount, updateMemoryRetrievalCount, setMemoryClassification, supersededMemory, mergeMemoryStats, archiveMemory, getMemoryCountsByStatus, sanitizeFtsQuery, searchMemoriesFTS, searchMemoriesFTSUnion, recordMemoryMapping, recordMemoryVerifications, getUnmappedMemoryIds, clearMemoryVerifications, getMemoryVerifications, resolveGitTopLevel, readGitHead, readGitChangedFilesSince, readGitFileChangeTimesSince, verificationFileExists, normalizeVerificationFiles, recordChildInvocation, USER_MEMORY_CANDIDATE_TTL_MS, insertUserMemoryCandidates, getUserMemoryCandidates, deleteUserMemoryCandidates, pruneExpiredUserMemoryCandidates, insertUserMemory, getActiveUserMemories, updateUserMemoryContent, dismissUserMemory, getMural, BoundedSessionMap, registerLkgPersistence, beginLkgPass, visitMessageContentFields, messageContentFields, signatureForFields, exactReusablePrefix, incrementalLkgContentDigests, lkgContentDigest, captureSlot, getInMemorySlot, getSlot, dropSlot, noteEntry, getLkgSlotHeapStats, onNoteTrigger, peekNoteNudgeText, markNoteNudgeDelivered, clearNoteNudgeTriggerAndCooldown, resetNoteNudgeCooldownOnly, clearNoteNudgeTriggerOnly, getOpenCodeDbPath, removeMcOwnedCompactionMarkers, MARKER_SUMMARY_TEXT, applyDeferredCompactionMarker, removeCompactionMarkerForSession, checkCompactionMarkerConsistency, modelKeyAcceptsImages, resolveMuralWire, extractM0Block, formatDate, injectTemporalMarkers, clearInjectionCache, getVisibleMemoryIds, selectHiddenMessagesAtCompactionSeam, prepareCompartmentInjection, renderCompartmentInjection, mustMaterialize, trimMemoriesToBudgetV2, renderMemoryBlockV2, prepareCachedM0M1Replay, hasCompleteCachedM0M1, injectM0M1, describeBoundaryDiagnostics, RECOVERY_NO_HEAD_LIMIT, resolveOpenCodeProtectedTailBoundary, resolveWrapupProtectedTailBoundary, getRawHistoryEligibility, hasRunnableCompartmentWindow, recordHighPressureNoEligibleHead, runCompartmentAgent, snapRangeToCompartments, getActiveCompartmentRun, markActiveCompartmentRunPublished, registerActiveCompartmentRun, startCompartmentAgent, setRecompStarting2, setRecompTerminal2, runManagedRecomp2, runManagedUpgrade2 };