@remnic/core 9.69.43 → 9.69.45

package/dist/who-knows-cli.d.ts

@@ -1,5 +1,5 @@
-import { W as WhoKnowsResult } from './access-service-DxTTTg9O.js';
-import './types-Sps-lg5I.js';
+import { W as WhoKnowsResult } from './access-service-CDteK_Gt.js';
+import './types-nmhnJpxx.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -16,13 +16,13 @@ import './active-context-config.js';
 import './local-llm-config.js';
 import './semantic-merge-config.js';
 import './types-continuity.js';
-import './orchestrator-VXWKdatm.js';
+import './orchestrator-BCvQavIS.js';
 import './recall-state.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
 import './included-memories.js';
 import './briefing.js';
-import './storage-C9nsZX5Q.js';
+import './storage-ClkHCQSE.js';
 import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './active-context-transform.js';
@@ -38,7 +38,7 @@ import './write-envelope.js';
 import './structured-attributes.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
-import './local-llm-3-jtw52a.js';
+import './local-llm-DdrhmecM.js';
 import './model-registry.js';
 import './fallback-llm.js';
 import './fallback-llm-codex-subscription.js';
@@ -47,8 +47,8 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-DgeeH0a1.js';
-import './catalog-Ya3DDn_T.js';
+import './maintenance-B813YFWJ.js';
+import './catalog-Dl2hYqpS.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -58,7 +58,7 @@ import './utility-runtime.js';
 import './tier-routing.js';
 import './lifecycle.js';
 import './orchestration/compression-guideline-coordinator.js';
-import './semantic-consolidation-g6x-ShY8.js';
+import './semantic-consolidation-B09JI9WM.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './embedding-fallback.js';
@@ -80,17 +80,17 @@ import './conversation-index/chunker.js';
 import './conversation-index/backend.js';
 import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
-import './dependency-propagation-delivery-CggS9BFT.js';
+import './dependency-propagation-delivery-BXaUoVUf.js';
 import './namespaces/storage.js';
 import './threading.js';
-import './scope-profiles-C564-hrv.js';
+import './scope-profiles-crazXegZ.js';
 import './graph-DRkl22KE.js';
 import './graph-write-lock.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './recall-context-composition.js';
-import './generic-recall-paths-CoXPSnCw.js';
+import './generic-recall-paths-BkVVEoeO.js';
 import './live-connectors-runner.js';
 import './framework-CNDn2164.js';
 import './relevance.js';
@@ -98,7 +98,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-BalR6EXU.js';
 import './replay/types.js';
-import './service-CaCOk0rd.js';
+import './service-Echc5Xso.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';
@@ -121,7 +121,7 @@ import './types-B1VHaf2w.js';
 import './transfer/capsule-import.js';
 import './transfer/types.js';
 import './recall-navigation.js';
-import './access-namespace-preflight-CE-RrXKu.js';
+import './access-namespace-preflight-DDnsN22V.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './recall-explain-renderer.js';
@@ -129,7 +129,7 @@ import './access-citation.js';
 import './access-health-types.js';
 import './corpus-watermark.js';
 import './replica-divergence.js';
-import './tagging-BA4RFdH3.js';
+import './tagging-ksktJ60G.js';
 import './explicit-capture.js';
 import './access-wearables-meetings-surface.js';
 import './deep-recall.js';

package/dist/who-knows-cli.js

@@ -4,9 +4,9 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-XOCGC3FJ.js";
-import "./chunk-D7UUB33A.js";
-import "./chunk-GMU7MAHS.js";
+} from "./chunk-OFBJD3V5.js";
+import "./chunk-NGAFYIHQ.js";
+import "./chunk-IAT5WFEU.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-D5F7TKMH.js";
@@ -32,7 +32,7 @@ import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-ZYSOT6HD.js";
+import "./chunk-J3IWHCMF.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-SHEHQBCG.js";
 import "./chunk-3ONXXHQO.js";
@@ -52,11 +52,11 @@ import "./chunk-ZLQ37WJX.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
-import "./chunk-TRTLWUDD.js";
+import "./chunk-ZTHGFTMW.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
-import "./chunk-UHSOPTNB.js";
+import "./chunk-EP6BA7VV.js";
 import "./chunk-E2AWJ7KQ.js";
 import "./chunk-RW4QNB4J.js";
 import "./chunk-ZIKENA2C.js";
@@ -74,7 +74,7 @@ import "./chunk-VYCOJKSX.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
-import "./chunk-JL4TQYM5.js";
+import "./chunk-L272A5QW.js";
 import "./chunk-SGHGCFVV.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-AL3UYZ5N.js";

package/dist/who-knows.d.ts

@@ -1,6 +1,6 @@
-export { bA as WHO_KNOWS_AUTHORSHIP_BONUS, bB as WHO_KNOWS_DEFAULT_LIMIT, bC as WHO_KNOWS_MAX_EVIDENCE, bD as WHO_KNOWS_MAX_LIMIT, bE as WHO_KNOWS_MCP_TOOLS, bF as WhoKnowsEntity, bG as WhoKnowsEvidence, bH as WhoKnowsHit, bI as WhoKnowsHttpOutcome, W as WhoKnowsResult, bJ as WhoKnowsStorage, bT as computeWhoKnows, bZ as handleWhoKnowsHttpQuery, c2 as loadWhoKnowsEntities, c9 as tokenizeTopic, ca as validateWhoKnowsInput } from './access-service-DxTTTg9O.js';
-import './types-Sps-lg5I.js';
-import './orchestrator-VXWKdatm.js';
+export { bA as WHO_KNOWS_AUTHORSHIP_BONUS, bB as WHO_KNOWS_DEFAULT_LIMIT, bC as WHO_KNOWS_MAX_EVIDENCE, bD as WHO_KNOWS_MAX_LIMIT, bE as WHO_KNOWS_MCP_TOOLS, bF as WhoKnowsEntity, bG as WhoKnowsEvidence, bH as WhoKnowsHit, bI as WhoKnowsHttpOutcome, W as WhoKnowsResult, bJ as WhoKnowsStorage, bT as computeWhoKnows, bZ as handleWhoKnowsHttpQuery, c2 as loadWhoKnowsEntities, c9 as tokenizeTopic, ca as validateWhoKnowsInput } from './access-service-CDteK_Gt.js';
+import './types-nmhnJpxx.js';
+import './orchestrator-BCvQavIS.js';
 import './recall-state.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
@@ -22,7 +22,7 @@ import './semantic-merge-config.js';
 import './types-continuity.js';
 import './included-memories.js';
 import './briefing.js';
-import './storage-C9nsZX5Q.js';
+import './storage-ClkHCQSE.js';
 import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './active-context-transform.js';
@@ -38,7 +38,7 @@ import './write-envelope.js';
 import './structured-attributes.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
-import './local-llm-3-jtw52a.js';
+import './local-llm-DdrhmecM.js';
 import './model-registry.js';
 import './fallback-llm.js';
 import './fallback-llm-codex-subscription.js';
@@ -47,8 +47,8 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-DgeeH0a1.js';
-import './catalog-Ya3DDn_T.js';
+import './maintenance-B813YFWJ.js';
+import './catalog-Dl2hYqpS.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -58,7 +58,7 @@ import './utility-runtime.js';
 import './tier-routing.js';
 import './lifecycle.js';
 import './orchestration/compression-guideline-coordinator.js';
-import './semantic-consolidation-g6x-ShY8.js';
+import './semantic-consolidation-B09JI9WM.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './embedding-fallback.js';
@@ -80,17 +80,17 @@ import './conversation-index/chunker.js';
 import './conversation-index/backend.js';
 import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
-import './dependency-propagation-delivery-CggS9BFT.js';
+import './dependency-propagation-delivery-BXaUoVUf.js';
 import './namespaces/storage.js';
 import './threading.js';
-import './scope-profiles-C564-hrv.js';
+import './scope-profiles-crazXegZ.js';
 import './graph-DRkl22KE.js';
 import './graph-write-lock.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './recall-context-composition.js';
-import './generic-recall-paths-CoXPSnCw.js';
+import './generic-recall-paths-BkVVEoeO.js';
 import './live-connectors-runner.js';
 import './framework-CNDn2164.js';
 import './relevance.js';
@@ -98,7 +98,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-BalR6EXU.js';
 import './replay/types.js';
-import './service-CaCOk0rd.js';
+import './service-Echc5Xso.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';
@@ -121,7 +121,7 @@ import './types-B1VHaf2w.js';
 import './transfer/capsule-import.js';
 import './transfer/types.js';
 import './recall-navigation.js';
-import './access-namespace-preflight-CE-RrXKu.js';
+import './access-namespace-preflight-DDnsN22V.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './recall-explain-renderer.js';
@@ -129,7 +129,7 @@ import './access-citation.js';
 import './access-health-types.js';
 import './corpus-watermark.js';
 import './replica-divergence.js';
-import './tagging-BA4RFdH3.js';
+import './tagging-ksktJ60G.js';
 import './explicit-capture.js';
 import './access-wearables-meetings-surface.js';
 import './deep-recall.js';

package/dist/who-knows.js

@@ -9,8 +9,8 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-D7UUB33A.js";
-import "./chunk-GMU7MAHS.js";
+} from "./chunk-NGAFYIHQ.js";
+import "./chunk-IAT5WFEU.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-D5F7TKMH.js";
@@ -36,7 +36,7 @@ import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-ZYSOT6HD.js";
+import "./chunk-J3IWHCMF.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-SHEHQBCG.js";
 import "./chunk-3ONXXHQO.js";
@@ -56,11 +56,11 @@ import "./chunk-ZLQ37WJX.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
-import "./chunk-TRTLWUDD.js";
+import "./chunk-ZTHGFTMW.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
-import "./chunk-UHSOPTNB.js";
+import "./chunk-EP6BA7VV.js";
 import "./chunk-E2AWJ7KQ.js";
 import "./chunk-RW4QNB4J.js";
 import "./chunk-ZIKENA2C.js";
@@ -78,7 +78,7 @@ import "./chunk-VYCOJKSX.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
-import "./chunk-JL4TQYM5.js";
+import "./chunk-L272A5QW.js";
 import "./chunk-SGHGCFVV.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-AL3UYZ5N.js";

package/dist/write-envelope.d.ts

@@ -1,4 +1,4 @@
-import { u as MemoryCategory, N as MemorySubject } from './types-Sps-lg5I.js';
+import { u as MemoryCategory, N as MemorySubject } from './types-nmhnJpxx.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.69.43",
+  "version": "9.69.45",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3307,7 +3307,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.69.43"
+    "@remnic/coding-graph": "^9.69.45"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/access-category-alias.test.ts

@@ -503,6 +503,63 @@ test("#2889 suggestion_submit reports the coercion and queues the canonical cate
     assert.equal("categoryCoercion" in canonical, false, "a no-alias submit reports no coercion");
   });
 });
+
+// ---------------------------------------------------------------------------
+// #2962 — direct service calls canonicalize accepted aliases at the split
+// boundary instead of echoing them in an "unsupported category" 400
+// ---------------------------------------------------------------------------
+
+test("#2962 a direct service call canonicalizes an accepted alias instead of echoing it in a 400", async () => {
+  // In-process consumers call the exported service API without a wire parse,
+  // so an accepted alias arrives on `category` itself (PR #2866 review). The
+  // split boundary must canonicalize it — same contract the wire schema
+  // enforces for HTTP/MCP/CLI — and mint the retained spelling so the
+  // response still reports the coercion note.
+  await withPersistService(async ({ service, writes }) => {
+    const aliased = await service.memoryStore({
+      content: "direct in-process aliased write",
+      category: "project",
+      confidence: 0.9,
+      tags: [],
+    });
+    assert.equal(aliased.status, "stored");
+    assert.deepEqual(
+      aliased.categoryCoercion,
+      { from: "project", to: "fact" },
+      "the retained raw spelling is still reported",
+    );
+    assert.equal(writes.length, 1);
+    assert.equal(writes[0]?.category, "fact", "the persisted memory stays canonical");
+
+    const suggested = await service.suggestionSubmit({
+      content: "direct in-process aliased suggestion",
+      category: "project_update",
+      confidence: 0.9,
+      tags: [],
+    });
+    assert.equal(suggested.status, "queued_for_review");
+    assert.deepEqual(suggested.categoryCoercion, { from: "project_update", to: "fact" });
+    assert.equal(writes.length, 2);
+
+    // A genuine near-miss changes nothing: it still rejects at the write
+    // candidate with the attempted category echoed in the 400 detail.
+    await assert.rejects(
+      service.memoryStore({
+        content: "a genuine near-miss must still reject",
+        category: "projection",
+        confidence: 0.9,
+        tags: [],
+      }),
+      (error: unknown) => {
+        assert.ok(error instanceof EngramAccessInputError);
+        assert.match(error.message, /unsupported category: projection/);
+        return true;
+      },
+    );
+    assert.equal(writes.length, 2, "the near-miss persists nothing");
+  });
+});
+
 // ---------------------------------------------------------------------------
 // Quarantine — the parked payload keeps the raw spelling for replay
 // ---------------------------------------------------------------------------

package/src/access-observe-write-category.ts

@@ -7,20 +7,39 @@
  * and a replay must rebuild the note from THIS request's spelling.
  */
 import {
+  canonicalCategoryForAlias,
   categoryAliasCoercion,
   reapplyCategoryCoercion,
   type CategoryAliasCoercion,
+  type MemoryCategoryAlias,
 } from "./access-schema.js";
 
 export { reapplyCategoryCoercion };
 export { applyBriefingLocationContext } from "./location/tagging.js";
 
-export function splitCanonicalWriteRequest<T extends { rawCategory?: string }>(
+export function splitCanonicalWriteRequest<T extends { rawCategory?: string; category?: string }>(
   request: T,
 ): {
   canonical: Omit<T, "rawCategory">;
   categoryCoercion: CategoryAliasCoercion | undefined;
 } {
   const { rawCategory, ...canonical } = request;
+  // #2962: a direct service caller bypasses the wire schema, so an accepted
+  // alias can still sit on `category`. Canonicalize it at the same boundary
+  // the schema's transform covers for HTTP/MCP/CLI, minting the retained
+  // spelling from the request itself. A schema-minted `rawCategory` always
+  // wins (it names the spelling the transform actually canonicalized);
+  // near-misses pass through untouched and reject at the write candidate
+  // with the attempted category echoed.
+  if (rawCategory === undefined && typeof canonical.category === "string") {
+    const mapped = canonicalCategoryForAlias(canonical.category);
+    if (mapped !== undefined) {
+      const from = canonical.category as MemoryCategoryAlias;
+      return {
+        canonical: { ...canonical, category: mapped } as Omit<T, "rawCategory">,
+        categoryCoercion: { from, to: mapped },
+      };
+    }
+  }
   return { canonical, categoryCoercion: categoryAliasCoercion(rawCategory) };
 }

package/src/access-schema.ts

@@ -307,6 +307,16 @@ export function isMemoryCategoryAlias(value: string): value is MemoryCategoryAli
   return Object.prototype.hasOwnProperty.call(MEMORY_CATEGORY_ALIAS_TO_CANONICAL, value);
 }
 
+/**
+ * Canonical category for an accepted alias spelling; undefined for anything
+ * else (canonical spellings and near-misses map to nothing). Service-boundary
+ * consumers that receive `category` without a prior wire parse use this to
+ * match the transport contract (#2962).
+ */
+export function canonicalCategoryForAlias(value: string): "fact" | undefined {
+  return isMemoryCategoryAlias(value) ? MEMORY_CATEGORY_ALIAS_TO_CANONICAL[value] : undefined;
+}
+
 /** Coercion diagnostic for a write whose input category was a compat alias. */
 export interface CategoryAliasCoercion {
   from: MemoryCategoryAlias;

package/src/background-generation.test.ts

@@ -130,3 +130,80 @@ test("HourlySummarizer uses backgroundGeneration and not openaiBaseUrl", async (
     rmSync(memoryDir, { recursive: true, force: true });
   }
 });
+
+test("HourlySummarizer routes extended summaries through backgroundGeneration", async () => {
+  const memoryDir = mkdtempSync(path.join(tmpdir(), "remnic-bg-extended-"));
+  const previousFetch = globalThis.fetch;
+  const previousXdg = process.env.XDG_CONFIG_HOME;
+  process.env.XDG_CONFIG_HOME = memoryDir;
+  const calls: string[] = [];
+  try {
+    const config = parseConfig({
+      memoryDir,
+      openaiApiKey: "keep-me",
+      openaiBaseUrl: "http://127.0.0.1:9999/v1",
+      hourlySummariesExtendedEnabled: true,
+      backgroundGeneration: {
+        endpoint: "http://127.0.0.1:8765/v1/chat/completions",
+        token: "bridge-token-fixture",
+        timeoutSeconds: 12,
+      },
+    });
+    let sentBody: string | undefined;
+    globalThis.fetch = (async (url, init) => {
+      calls.push(String(url));
+      if (String(url) !== "http://127.0.0.1:8765/v1/chat/completions") {
+        return new Response("not the bridge", { status: 404 });
+      }
+      sentBody = String(init?.body);
+      return new Response(
+        JSON.stringify({
+          choices: [
+            {
+              message: {
+                content:
+                  '{"topics":["bridge-topic"],"decisions":["ship it"],"actionItems":["land the PR"],"rejected":[]}',
+              },
+            },
+          ],
+        }),
+        { status: 200, headers: { "content-type": "application/json" } },
+      );
+    }) as typeof fetch;
+
+    const summarizer = new HourlySummarizer(config);
+    const summary = await summarizer.generateSummary(
+      "session-bridge",
+      new Date("2026-08-23T10:00:00.000Z"),
+      [
+        {
+          timestamp: "2026-08-23T10:01:00.000Z",
+          role: "user",
+          content: "ship the bridge",
+          sessionKey: "session-bridge",
+          turnId: "t1",
+        },
+      ],
+    );
+
+    assert.deepEqual(summary?.bullets, ["bridge-topic"]);
+    const extended = (summary as { _extended?: { topics: string[]; decisions: string[]; actionItems: string[]; rejected: string[] } })._extended;
+    assert.deepEqual(extended?.topics, ["bridge-topic"]);
+    assert.deepEqual(extended?.decisions, ["ship it"]);
+    assert.deepEqual(extended?.actionItems, ["land the PR"]);
+    assert.deepEqual(extended?.rejected, []);
+    assert.deepEqual(calls, ["http://127.0.0.1:8765/v1/chat/completions"]);
+    assert.equal(config.openaiBaseUrl, "http://127.0.0.1:9999/v1");
+    const sent = JSON.parse(String(sentBody)) as {
+      messages: Array<{ role: string; content: string }>;
+    };
+    const system = sent.messages.find((message) => message.role === "system")?.content ?? "";
+    assert.match(system, /"topics"/);
+    assert.match(system, /"decisions"/);
+  } finally {
+    globalThis.fetch = previousFetch;
+    if (previousXdg === undefined) delete process.env.XDG_CONFIG_HOME;
+    else process.env.XDG_CONFIG_HOME = previousXdg;
+    rmSync(memoryDir, { recursive: true, force: true });
+  }
+});

package/src/extraction-span-wire.test.ts

@@ -1,6 +1,6 @@
 import assert from "node:assert/strict";
 import { test } from "node:test";
-import { applySpanMode } from "./extraction-span-wire.js";
+import { applySpanMode, extractionProviderJsonSchema } from "./extraction-span-wire.js";
 
 const TEXT = "Alice moved to Seattle";
 
@@ -18,3 +18,19 @@ test("applySpanMode: enabled slices half-open [start, end)", () => {
     end: 11,
   });
 });
+
+function factProperties(spanMode: "off" | "shadow" | "on") {
+  const schema = extractionProviderJsonSchema(spanMode);
+  const properties = schema.properties as
+    | Record<string, { items?: { properties?: Record<string, unknown> } }>
+    | undefined;
+  return properties?.facts?.items?.properties ?? {};
+}
+
+test("provider schema omits span in off mode and keeps it in on/shadow (issue #2952)", () => {
+  assert.equal("span" in factProperties("off"), false);
+  assert.equal("span" in factProperties("on"), true);
+  assert.equal("span" in factProperties("shadow"), true);
+  assert.deepEqual(extractionProviderJsonSchema("on"), extractionProviderJsonSchema("shadow"));
+  assert.notEqual(extractionProviderJsonSchema("off"), extractionProviderJsonSchema("on"));
+});

package/src/extraction-span-wire.ts

@@ -1,11 +1,14 @@
 /**
- * Extraction seam for span mode (issue #2333 leftover slice).
+ * Extraction seam for span mode (issue #2333 leftover slice + #2952).
  *
- * Default off. Callers pass `enabled`. This module does not touch
- * extraction.ts; Phase A still gates production wiring.
+ * Default off. Callers pass `enabled` to `applySpanMode`. The provider JSON
+ * schema is mode-aware so off-mode structured output cannot advertise `span`.
  */
 
+import { zodToJsonSchema } from "zod-to-json-schema";
+import type { ExtractionSpanConfig } from "./extraction-span-config.js";
 import { parseSpanOffsets, type ParsedSpan } from "./extraction-span.js";
+import { ExtractionProviderOutputSchema } from "./schemas.js";
 
 export function applySpanMode(opts: {
   enabled?: boolean | 0 | 1;
@@ -15,3 +18,43 @@ export function applySpanMode(opts: {
 }): ParsedSpan {
   return parseSpanOffsets(opts.text, { start: opts.start, end: opts.end }, opts.enabled);
 }
+
+const JSON_SCHEMA_OPTS = { $refStrategy: "none" as const, effectStrategy: "input" as const };
+
+const EXTRACTION_PROVIDER_JSON_SCHEMA_WITH_SPAN = zodToJsonSchema(
+  ExtractionProviderOutputSchema,
+  JSON_SCHEMA_OPTS,
+) as Record<string, unknown>;
+
+type FactItems = {
+  properties?: Record<string, unknown>;
+  required?: string[];
+};
+
+function omitFactSpan(schema: Record<string, unknown>): Record<string, unknown> {
+  const clone = structuredClone(schema) as {
+    properties?: { facts?: { items?: FactItems } };
+  };
+  const items = clone.properties?.facts?.items;
+  if (!items?.properties || !("span" in items.properties)) {
+    throw new Error("extraction provider schema is missing facts.items.properties.span");
+  }
+  delete items.properties.span;
+  if (Array.isArray(items.required)) {
+    items.required = items.required.filter((key) => key !== "span");
+  }
+  return clone as Record<string, unknown>;
+}
+
+const EXTRACTION_PROVIDER_JSON_SCHEMA_WITHOUT_SPAN = omitFactSpan(
+  EXTRACTION_PROVIDER_JSON_SCHEMA_WITH_SPAN,
+);
+
+/** Provider JSON schema: `span` is present in on/shadow, absent in off. */
+export function extractionProviderJsonSchema(
+  spanMode: ExtractionSpanConfig["spanMode"] = "off",
+): Record<string, unknown> {
+  return spanMode === "off"
+    ? EXTRACTION_PROVIDER_JSON_SCHEMA_WITHOUT_SPAN
+    : EXTRACTION_PROVIDER_JSON_SCHEMA_WITH_SPAN;
+}

package/src/extraction.ts

@@ -7,7 +7,6 @@ import { shouldRunProactivePass } from "./proactive-contention.js";
 import { FallbackLlmClient, fallbackLlmRuntimeContextFromConfig, gatewayTaskChainOptions } from "./fallback-llm.js";
 import { revalidateDependentsViaLlm, type RevalidationFastChatCompletion } from "./orchestration/dependency-revalidation.js";
 import {
-  ExtractionProviderOutputSchema,
   ExtractionResultSchema,
   ConsolidationResultSchema,
   IdentityConsolidationResultSchema,
@@ -53,9 +52,9 @@ import {
   eventTimePromptInstruction,
   spanModePromptSection,
 } from "./extraction-prompt.js";
-import { zodToJsonSchema } from "zod-to-json-schema";
 import { containsExtractionPlaceholder, extractionAttributes, extractionCueAnchors, extractionText, isPlainRecord } from "./extraction-normalization.js";
 import { applyExtractionSpanMaterialization, bindLocalExtractionPrompt, buildSpanMaterializeTurns, stripUntrustedFactSpans, truncateLocalExtractionConversation, type SpanMaterializeTurn } from "./extraction-span-materialize.js";
+import { extractionProviderJsonSchema } from "./extraction-span-wire.js";
 import { resolveLocalLlmCapabilities, resolveMemoryLifecycleCapabilities, resolvePipelineProcessingCapabilities, resolveRecallAuxiliaryCapabilities } from "./capabilities.js";
 type ExtractionQuestion = ExtractionResult["questions"][number];
 type ExtractedFactResult = ExtractionResult["facts"][number];
@@ -64,14 +63,6 @@ type ExtractedRelationshipResult = NonNullable<ExtractionResult["relationships"]
 
 const PROACTIVE_MIN_CONFIDENCE = 0.8;
 
-const EXTRACTION_PROVIDER_JSON_SCHEMA = zodToJsonSchema(
-  ExtractionProviderOutputSchema,
-  {
-    $refStrategy: "none",
-    effectStrategy: "input",
-  },
-) as Record<string, unknown>;
-
 function extractionEntityType(value: unknown): ExtractedEntityResult["type"] | undefined {
   const type = extractionText(value);
   if (
@@ -1353,7 +1344,7 @@ export class ExtractionEngine {
           timeoutMs: this.config.taskLlmTimeoutMs ?? this.config.localLlmTimeoutMs,
           jsonSchema: {
             name: "extraction_result",
-            schema: EXTRACTION_PROVIDER_JSON_SCHEMA,
+            schema: extractionProviderJsonSchema(this.config.extraction?.spanMode ?? "off"),
             strict: false,
           },
           signal,

package/src/local-llm-config.test.ts

@@ -0,0 +1,21 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { parseLocalLlmConfig } from "./local-llm-config.js";
+
+test("#2964: parseLocalLlmConfig round-trips a free-form localLlmHeaders key", () => {
+  const parsed = parseLocalLlmConfig(
+    {
+      localLlmHeaders: {
+        "X-Remnic-Canary": "alpha-9",
+        Authorization: "Bearer x",
+        drop: 1,
+      },
+    },
+    undefined,
+    (value) => value,
+  );
+  assert.deepEqual(parsed.localLlmHeaders, {
+    "X-Remnic-Canary": "alpha-9",
+    Authorization: "Bearer x",
+  });
+});