@theokit/sdk 5.0.0-next.4 → 5.0.1

package/dist/index.js

@@ -1,27 +1,27 @@
 export { StreamObjectError } from './chunk-5WKQDIGO.js';
 export { GOAL_CONTINUATION_MARKER } from './chunk-PY2RQOA7.js';
 export { JudgeCredentialError } from './chunk-UFPUHJWS.js';
-import { migrateSqliteToLance, appendDiaryEntry } from './chunk-DX4RUWOK.js';
+import { migrateSqliteToLance, appendDiaryEntry } from './chunk-WS5ULCL4.js';
 export { GenerateObjectError } from './chunk-44I6UYVH.js';
 import './chunk-47TF32NQ.js';
 import { Workflow, agentStep } from './chunk-HFEJE7AC.js';
 export { Workflow, agentStep, fn } from './chunk-HFEJE7AC.js';
 import './chunk-GBCVPKHE.js';
 import './chunk-HY66GLM6.js';
-export { Cron } from './chunk-A3FOEBYS.js';
-import { MEMORY_EMBEDDING_ADAPTERS, resolveSessionDir, DEFAULT_AGENTIC_MODEL_ID, Agent } from './chunk-WKUBCBWS.js';
-export { Agent, AgentBuilder, Tool, ToolError, UsageAccumulator, computeCost, getPricingEntry } from './chunk-WKUBCBWS.js';
+export { Cron } from './chunk-YEL3SP6X.js';
+import { MEMORY_EMBEDDING_ADAPTERS, resolveSessionDir, DEFAULT_AGENTIC_MODEL_ID, Agent } from './chunk-SVWMQCXF.js';
+export { Agent, AgentBuilder, Tool, ToolError, UsageAccumulator, computeCost, getPricingEntry } from './chunk-SVWMQCXF.js';
 import { configure, submit, list, get, cancel, subscribe } from './chunk-K2VMFZQ5.js';
 export { emitRunEvent } from './chunk-K2VMFZQ5.js';
 import './chunk-AWINL3ZC.js';
 import './chunk-K2BQQ445.js';
-import './chunk-CYKKYNOT.js';
-import './chunk-XJZEBGXD.js';
+import './chunk-7SZAV6QG.js';
+import './chunk-D7WAROJR.js';
 import './chunk-2SFBB54R.js';
 import './chunk-55GB6JYQ.js';
 import './chunk-H73MEMQB.js';
 import './chunk-OR6XIWLB.js';
-import { resolveMemoryRoot, readFactsFromMarkdown } from './chunk-J2SH3PNH.js';
+import { resolveMemoryRoot, readFactsFromMarkdown } from './chunk-SADXXGWU.js';
 import { FsSessionStore } from './chunk-AAEZSPTC.js';
 import { discoverProviderPlugins, shouldUseFixtureMode, isFixtureApiKey, httpRequest, mapOllamaTransportError, readErrorResponseBody, mapOllamaHttpError } from './chunk-K3NH62DG.js';
 import './chunk-UBR5PWD7.js';
@@ -55,8 +55,8 @@ import { withCwdMutex } from './chunk-Q5EWJPRY.js';
 export { withCwdMutex } from './chunk-Q5EWJPRY.js';
 export { TASK_RESERVED_PREFIXES, isValidTaskId } from './chunk-EIQFAOFD.js';
 import { replaceFileAtomic } from './chunk-3JHIFQ4I.js';
-import './chunk-4S5TWFIZ.js';
-import './chunk-67ADYSTW.js';
+import './chunk-7RHC7HMS.js';
+import './chunk-GUKPXDGJ.js';
 import './chunk-JNAA4G4H.js';
 import { estimateTokens, CHARS_PER_TOKEN } from './chunk-6M2OIS4Y.js';
 export { estimateTokens } from './chunk-6M2OIS4Y.js';
@@ -1297,7 +1297,7 @@ var Memory = {
       openArgs.embedding = await resolveEmbedding(opts.embedding, peer.MEMORY_EMBEDDING_ADAPTERS);
       return await peer.IndexManager.open(openArgs);
     }
-    const { IndexManager } = await import('./index-manager-E56WW5RO.js');
+    const { IndexManager } = await import('./index-manager-W7FDMGEG.js');
     openArgs.embedding = await resolveEmbedding(opts.embedding, MEMORY_EMBEDDING_ADAPTERS);
     return await IndexManager.open(openArgs);
   },
@@ -1750,7 +1750,7 @@ function isBuiltAgent(m) {
   return typeof m.send === "function";
 }
 async function materialize(def, index) {
-  const { Agent: Agent2 } = await import('./agent-L5Z6H53C.js');
+  const { Agent: Agent2 } = await import('./agent-UGYIYC3R.js');
   return Agent2.create({
     // `AgentDefinition.model` admits the sentinel `'inherit'`, which is not a model id. Inheriting
     // here means "declare nothing and let the default apply" — forwarding the literal would create

package/dist/internal/memory/storage/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkVNDJS6I3_cjs = require('../../../chunk-VNDJS6I3.cjs');
+var chunkVPK6PHIE_cjs = require('../../../chunk-VPK6PHIE.cjs');
 var chunkTMKTSYDS_cjs = require('../../../chunk-TMKTSYDS.cjs');
-var chunkRXZSVNDG_cjs = require('../../../chunk-RXZSVNDG.cjs');
+var chunkNQTNSHSB_cjs = require('../../../chunk-NQTNSHSB.cjs');
 require('../../../chunk-KRD3GQAA.cjs');
 require('../../../chunk-MUUQ2WFJ.cjs');
 require('../../../chunk-LOHMT36V.cjs');
@@ -19,23 +19,23 @@ require('../../../chunk-6LHQPOMI.cjs');
 
 Object.defineProperty(exports, "appendDiaryEntry", {
   enumerable: true,
-  get: function () { return chunkVNDJS6I3_cjs.appendDiaryEntry; }
+  get: function () { return chunkVPK6PHIE_cjs.appendDiaryEntry; }
 });
 Object.defineProperty(exports, "diaryPath", {
   enumerable: true,
-  get: function () { return chunkVNDJS6I3_cjs.diaryPath; }
+  get: function () { return chunkVPK6PHIE_cjs.diaryPath; }
 });
 Object.defineProperty(exports, "entryHash", {
   enumerable: true,
-  get: function () { return chunkVNDJS6I3_cjs.entryHash; }
+  get: function () { return chunkVPK6PHIE_cjs.entryHash; }
 });
 Object.defineProperty(exports, "readAllSqliteFacts", {
   enumerable: true,
-  get: function () { return chunkVNDJS6I3_cjs.readAllSqliteFacts; }
+  get: function () { return chunkVPK6PHIE_cjs.readAllSqliteFacts; }
 });
 Object.defineProperty(exports, "renderDiaryEntry", {
   enumerable: true,
-  get: function () { return chunkVNDJS6I3_cjs.renderDiaryEntry; }
+  get: function () { return chunkVPK6PHIE_cjs.renderDiaryEntry; }
 });
 Object.defineProperty(exports, "persistActiveMemoryTranscript", {
   enumerable: true,
@@ -43,95 +43,99 @@ Object.defineProperty(exports, "persistActiveMemoryTranscript", {
 });
 Object.defineProperty(exports, "MEMORY_INDEX_MAX_BYTES", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.MEMORY_INDEX_MAX_BYTES; }
+  get: function () { return chunkNQTNSHSB_cjs.MEMORY_INDEX_MAX_BYTES; }
 });
 Object.defineProperty(exports, "MEMORY_INDEX_MAX_LINES", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.MEMORY_INDEX_MAX_LINES; }
+  get: function () { return chunkNQTNSHSB_cjs.MEMORY_INDEX_MAX_LINES; }
 });
 Object.defineProperty(exports, "appendFact", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.appendFact; }
+  get: function () { return chunkNQTNSHSB_cjs.appendFact; }
 });
 Object.defineProperty(exports, "appendFactToMarkdown", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.appendFactToMarkdown; }
+  get: function () { return chunkNQTNSHSB_cjs.appendFactToMarkdown; }
 });
 Object.defineProperty(exports, "asMemoryRoot", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.asMemoryRoot; }
+  get: function () { return chunkNQTNSHSB_cjs.asMemoryRoot; }
 });
 Object.defineProperty(exports, "claudeProjectMemoryDir", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.claudeProjectMemoryDir; }
+  get: function () { return chunkNQTNSHSB_cjs.claudeProjectMemoryDir; }
 });
 Object.defineProperty(exports, "collectMarkdownFiles", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.collectMarkdownFiles; }
+  get: function () { return chunkNQTNSHSB_cjs.collectMarkdownFiles; }
 });
 Object.defineProperty(exports, "defaultIndexPath", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.defaultIndexPath; }
+  get: function () { return chunkNQTNSHSB_cjs.defaultIndexPath; }
 });
 Object.defineProperty(exports, "discoverSessionFiles", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.discoverSessionFiles; }
+  get: function () { return chunkNQTNSHSB_cjs.discoverSessionFiles; }
 });
 Object.defineProperty(exports, "discoverWikiFiles", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.discoverWikiFiles; }
+  get: function () { return chunkNQTNSHSB_cjs.discoverWikiFiles; }
 });
 Object.defineProperty(exports, "indexBudgetWarning", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.indexBudgetWarning; }
+  get: function () { return chunkNQTNSHSB_cjs.indexBudgetWarning; }
 });
 Object.defineProperty(exports, "lanceStoragePath", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.lanceStoragePath; }
+  get: function () { return chunkNQTNSHSB_cjs.lanceStoragePath; }
+});
+Object.defineProperty(exports, "memoryIndexRoot", {
+  enumerable: true,
+  get: function () { return chunkNQTNSHSB_cjs.memoryIndexRoot; }
 });
 Object.defineProperty(exports, "memoryMdPath", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.memoryMdPath; }
+  get: function () { return chunkNQTNSHSB_cjs.memoryMdPath; }
 });
 Object.defineProperty(exports, "memoryReadRoots", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.memoryReadRoots; }
+  get: function () { return chunkNQTNSHSB_cjs.memoryReadRoots; }
 });
 Object.defineProperty(exports, "notesDir", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.notesDir; }
+  get: function () { return chunkNQTNSHSB_cjs.notesDir; }
 });
 Object.defineProperty(exports, "projectMemoryDir", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.projectMemoryDir; }
+  get: function () { return chunkNQTNSHSB_cjs.projectMemoryDir; }
 });
 Object.defineProperty(exports, "readFacts", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.readFacts; }
+  get: function () { return chunkNQTNSHSB_cjs.readFacts; }
 });
 Object.defineProperty(exports, "readFactsFromMarkdown", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.readFactsFromMarkdown; }
+  get: function () { return chunkNQTNSHSB_cjs.readFactsFromMarkdown; }
 });
 Object.defineProperty(exports, "resolveMemoryRoot", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.resolveMemoryRoot; }
+  get: function () { return chunkNQTNSHSB_cjs.resolveMemoryRoot; }
 });
 Object.defineProperty(exports, "sessionSummaryPath", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.sessionSummaryPath; }
+  get: function () { return chunkNQTNSHSB_cjs.sessionSummaryPath; }
 });
 Object.defineProperty(exports, "sessionsDir", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.sessionsDir; }
+  get: function () { return chunkNQTNSHSB_cjs.sessionsDir; }
 });
 Object.defineProperty(exports, "wikiDir", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.wikiDir; }
+  get: function () { return chunkNQTNSHSB_cjs.wikiDir; }
 });
 Object.defineProperty(exports, "writeSessionSummary", {
   enumerable: true,
-  get: function () { return chunkRXZSVNDG_cjs.writeSessionSummary; }
+  get: function () { return chunkNQTNSHSB_cjs.writeSessionSummary; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/internal/memory/storage/index.d.cts

@@ -21,7 +21,7 @@ export { collectMarkdownFiles, type DiscoveredFile } from "../index-manager-help
 export { lanceStoragePath } from "../lance-index.js";
 export { readAllSqliteFacts, type SqliteFactRow } from "../migrate-sqlite-to-lance.js";
 export { appendFact, appendFactToMarkdown, memoryMdPath, notesDir, readFacts, readFactsFromMarkdown, } from "./markdown-store.js";
-export { asMemoryRoot, claudeProjectMemoryDir, indexBudgetWarning, MEMORY_INDEX_MAX_BYTES, MEMORY_INDEX_MAX_LINES, type MemoryLocationConfig, type MemoryRoot, memoryReadRoots, projectMemoryDir, resolveMemoryRoot, } from "./memory-root.js";
+export { asMemoryRoot, claudeProjectMemoryDir, indexBudgetWarning, MEMORY_INDEX_MAX_BYTES, MEMORY_INDEX_MAX_LINES, type MemoryLocationConfig, type MemoryRoot, memoryIndexRoot, memoryReadRoots, projectMemoryDir, resolveMemoryRoot, } from "./memory-root.js";
 export { discoverSessionFiles, type SessionFile } from "./session-loader.js";
 export { type SessionSummaryInput, sessionSummaryPath, sessionsDir, writeSessionSummary, } from "./session-summary-writer.js";
 export { type ActiveMemoryTranscript, persistActiveMemoryTranscript } from "./transcript-store.js";

package/dist/internal/memory/storage/index.d.ts

@@ -21,7 +21,7 @@ export { collectMarkdownFiles, type DiscoveredFile } from "../index-manager-help
 export { lanceStoragePath } from "../lance-index.js";
 export { readAllSqliteFacts, type SqliteFactRow } from "../migrate-sqlite-to-lance.js";
 export { appendFact, appendFactToMarkdown, memoryMdPath, notesDir, readFacts, readFactsFromMarkdown, } from "./markdown-store.js";
-export { asMemoryRoot, claudeProjectMemoryDir, indexBudgetWarning, MEMORY_INDEX_MAX_BYTES, MEMORY_INDEX_MAX_LINES, type MemoryLocationConfig, type MemoryRoot, memoryReadRoots, projectMemoryDir, resolveMemoryRoot, } from "./memory-root.js";
+export { asMemoryRoot, claudeProjectMemoryDir, indexBudgetWarning, MEMORY_INDEX_MAX_BYTES, MEMORY_INDEX_MAX_LINES, type MemoryLocationConfig, type MemoryRoot, memoryIndexRoot, memoryReadRoots, projectMemoryDir, resolveMemoryRoot, } from "./memory-root.js";
 export { discoverSessionFiles, type SessionFile } from "./session-loader.js";
 export { type SessionSummaryInput, sessionSummaryPath, sessionsDir, writeSessionSummary, } from "./session-summary-writer.js";
 export { type ActiveMemoryTranscript, persistActiveMemoryTranscript } from "./transcript-store.js";

package/dist/internal/memory/storage/index.js

@@ -1,6 +1,6 @@
-export { appendDiaryEntry, diaryPath, entryHash, readAllSqliteFacts, renderDiaryEntry } from '../../../chunk-DX4RUWOK.js';
+export { appendDiaryEntry, diaryPath, entryHash, readAllSqliteFacts, renderDiaryEntry } from '../../../chunk-WS5ULCL4.js';
 export { persistActiveMemoryTranscript } from '../../../chunk-OR6XIWLB.js';
-export { MEMORY_INDEX_MAX_BYTES, MEMORY_INDEX_MAX_LINES, appendFact, appendFactToMarkdown, asMemoryRoot, claudeProjectMemoryDir, collectMarkdownFiles, defaultIndexPath, discoverSessionFiles, discoverWikiFiles, indexBudgetWarning, lanceStoragePath, memoryMdPath, memoryReadRoots, notesDir, projectMemoryDir, readFacts, readFactsFromMarkdown, resolveMemoryRoot, sessionSummaryPath, sessionsDir, wikiDir, writeSessionSummary } from '../../../chunk-J2SH3PNH.js';
+export { MEMORY_INDEX_MAX_BYTES, MEMORY_INDEX_MAX_LINES, appendFact, appendFactToMarkdown, asMemoryRoot, claudeProjectMemoryDir, collectMarkdownFiles, defaultIndexPath, discoverSessionFiles, discoverWikiFiles, indexBudgetWarning, lanceStoragePath, memoryIndexRoot, memoryMdPath, memoryReadRoots, notesDir, projectMemoryDir, readFacts, readFactsFromMarkdown, resolveMemoryRoot, sessionSummaryPath, sessionsDir, wikiDir, writeSessionSummary } from '../../../chunk-SADXXGWU.js';
 import '../../../chunk-KVNWIAO4.js';
 import '../../../chunk-FD2UT76F.js';
 import '../../../chunk-2XRAWOZZ.js';

package/dist/internal/memory/storage/memory-root.d.cts

@@ -92,6 +92,23 @@ export declare const MEMORY_INDEX_MAX_BYTES: number;
  * function is testable without a filesystem or a captured stderr.
  */
 export declare function indexBudgetWarning(index: string, root: string): string | undefined;
+/**
+ * Where the search index belongs for this configuration (theokit-sdk#554).
+ *
+ * Not always the same root the FACTS use, and the divergence is narrow on purpose.
+ *
+ * The index is not a pointer — `chunks.text` holds the fact text, because FTS5/BM25 needs it to
+ * search. A copy of the index is therefore a copy of the memory. Leaving it in `<cwd>` while the
+ * facts move writes one operator's personal store into every repository the agent runs in,
+ * untracked and readable with `strings`.
+ *
+ * So the index follows the store — EXCEPT into the Claude Code CLI's own directory, which is the
+ * case `docs/memory-decisions.md` § 1 reasons about and settles: that CLI has no index format, so
+ * a binary there is an artefact the partner does not understand inside a directory it manages. The
+ * decision keeps exactly the scope its own argument covers, and no more; every other directory is
+ * a plain directory this SDK is free to own.
+ */
+export declare function memoryIndexRoot(cwd: string, store: MemoryRoot): MemoryRoot;
 /**
  * Every directory a read must cover, deduplicated and in precedence order.
  *

package/dist/internal/memory/storage/memory-root.d.ts

@@ -92,6 +92,23 @@ export declare const MEMORY_INDEX_MAX_BYTES: number;
  * function is testable without a filesystem or a captured stderr.
  */
 export declare function indexBudgetWarning(index: string, root: string): string | undefined;
+/**
+ * Where the search index belongs for this configuration (theokit-sdk#554).
+ *
+ * Not always the same root the FACTS use, and the divergence is narrow on purpose.
+ *
+ * The index is not a pointer — `chunks.text` holds the fact text, because FTS5/BM25 needs it to
+ * search. A copy of the index is therefore a copy of the memory. Leaving it in `<cwd>` while the
+ * facts move writes one operator's personal store into every repository the agent runs in,
+ * untracked and readable with `strings`.
+ *
+ * So the index follows the store — EXCEPT into the Claude Code CLI's own directory, which is the
+ * case `docs/memory-decisions.md` § 1 reasons about and settles: that CLI has no index format, so
+ * a binary there is an artefact the partner does not understand inside a directory it manages. The
+ * decision keeps exactly the scope its own argument covers, and no more; every other directory is
+ * a plain directory this SDK is free to own.
+ */
+export declare function memoryIndexRoot(cwd: string, store: MemoryRoot): MemoryRoot;
 /**
  * Every directory a read must cover, deduplicated and in precedence order.
  *

package/dist/internal/persistence/index.cjs

@@ -7,7 +7,7 @@ var chunkDQZU7JK6_cjs = require('../../chunk-DQZU7JK6.cjs');
 var chunkBJUJT5ED_cjs = require('../../chunk-BJUJT5ED.cjs');
 var chunkZF2LDKQQ_cjs = require('../../chunk-ZF2LDKQQ.cjs');
 var chunkJLRLCBJ4_cjs = require('../../chunk-JLRLCBJ4.cjs');
-var chunkGGZ5GPE3_cjs = require('../../chunk-GGZ5GPE3.cjs');
+var chunkDLRP7BI6_cjs = require('../../chunk-DLRP7BI6.cjs');
 require('../../chunk-J7J7J2GN.cjs');
 require('../../chunk-6LHQPOMI.cjs');
 var promises = require('fs/promises');
@@ -111,15 +111,15 @@ Object.defineProperty(exports, "replaceFileAtomic", {
 });
 Object.defineProperty(exports, "displayTheokitHome", {
   enumerable: true,
-  get: function () { return chunkGGZ5GPE3_cjs.displayTheokitHome; }
+  get: function () { return chunkDLRP7BI6_cjs.displayTheokitHome; }
 });
 Object.defineProperty(exports, "getProfilesRoot", {
   enumerable: true,
-  get: function () { return chunkGGZ5GPE3_cjs.getProfilesRoot; }
+  get: function () { return chunkDLRP7BI6_cjs.getProfilesRoot; }
 });
 Object.defineProperty(exports, "getTheokitHome", {
   enumerable: true,
-  get: function () { return chunkGGZ5GPE3_cjs.getTheokitHome; }
+  get: function () { return chunkDLRP7BI6_cjs.getTheokitHome; }
 });
 exports.casUpdate = casUpdate;
 exports.createExclusive = createExclusive;

package/dist/internal/persistence/index.js

@@ -5,7 +5,7 @@ export { applyWalWithFallback, isCorruptionError, openSqliteResilient } from '..
 export { JsonlParseError, appendJsonl, loadJsonl, readJsonlIds, withFileLock } from '../../chunk-TA3K7SBK.js';
 export { withCwdMutex } from '../../chunk-Q5EWJPRY.js';
 export { atomicWriteJson, atomicWriteText, replaceFileAtomic } from '../../chunk-3JHIFQ4I.js';
-export { displayTheokitHome, getProfilesRoot, getTheokitHome } from '../../chunk-67ADYSTW.js';
+export { displayTheokitHome, getProfilesRoot, getTheokitHome } from '../../chunk-GUKPXDGJ.js';
 import '../../chunk-ALUN2B4W.js';
 import '../../chunk-CZJ6Q7CW.js';
 import { open } from 'fs/promises';

package/dist/internal/runtime/compat/foreign-config-sources.d.ts

@@ -104,13 +104,36 @@ export declare function undefinedVariablesIn(command: string, supplied: Readonly
  * executable, and it does not run. The only remaining way to learn why is a CHANGELOG entry for a
  * version the reader may not know they crossed.
  *
- * ## Why `diag` rather than `diagFailure`
+ * ## Why `diagFailure` rather than `diag` (#563)
  *
- * `diagFailure` falls back to stderr, and this is not a failure: ignoring an undeclared foreign
- * directory is precisely what #524 asked for. Every repository that has Claude Code set up and does
- * NOT want it imported would pay a stderr line at every agent start — on a TUI host's render
- * surface — for behaving as instructed. That is the corruption `diagnostics.ts` exists to prevent.
+ * This used `diag`, on the reasoning that ignoring an undeclared directory is not a failure and
+ * that a repository which does NOT want the import should not pay a stderr line for behaving as
+ * instructed. The reasoning was sound and rested on a premise nobody checked: that a host would
+ * have installed a sink.
  *
- * So it goes on the interceptable channel, for the reader holding the question it answers.
+ * Measured against the published `5.0.0`. `diag` returns without doing anything when no sink is
+ * installed. The SDK installs none — `currentSink()` reads a `globalThis` slot only
+ * `setDiagnosticsSink` fills. Neither observable host installs one either: `theocode` renamed the
+ * key, and `theokit` exports `installDiagnosticSink` and never calls it. Two hosts out of two, and
+ * the SDK itself. So the message the CHANGELOG promised — "says so once, on the diagnostics
+ * channel" — reached nobody, while the consumer lost hooks, skills, subagents and plugins.
+ *
+ * A mitigation announced in release notes for a silent loss of capability is not a diagnostic. It
+ * is the error path of the breaking change itself, and `diagFailure` exists for exactly the message
+ * that must not be swallowed.
+ *
+ * The cost the old reasoning named is real and is now paid: a repository that wants the directory
+ * ignored sees a line. What makes that acceptable — ONCE per directory per process, not per turn
+ * (`reported` below); and before #524 that repository was having `.claude/` imported anyway, so the
+ * line it now sees confirms the fix it wanted. The asymmetry is one line of text against silently
+ * losing four subsystems.
+ *
+ * A host that installs a sink still owns its render surface: `diagFailure` prefers the sink and
+ * only falls back to stderr when there is none.
+ *
+ * NOT solved here: there is no way to say "I know, and I want none". `compatSources: []` would be
+ * the natural spelling, but `resolveCompatSources` collapses it into the same `[]` an absent option
+ * produces, so this function cannot tell them apart. If the noise turns out to matter, threading
+ * that distinction through is the shape of the fix.
  */
 export declare function reportUndeclaredSources(cwd: string, declared: readonly CompatSourceDeclaration[]): void;

package/dist/subagents-loader-7ES7PJNM.js

@@ -0,0 +1,7 @@
+export { loadSubagents } from './chunk-7RHC7HMS.js';
+import './chunk-GUKPXDGJ.js';
+import './chunk-JNAA4G4H.js';
+import './chunk-ALUN2B4W.js';
+import './chunk-CZJ6Q7CW.js';
+//# sourceMappingURL=subagents-loader-7ES7PJNM.js.map
+//# sourceMappingURL=subagents-loader-7ES7PJNM.js.map

package/dist/{subagents-loader-Y6JFYXAY.js.map → subagents-loader-7ES7PJNM.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"subagents-loader-Y6JFYXAY.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"subagents-loader-7ES7PJNM.js"}

package/dist/subagents-loader-OMOH6ERO.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var chunk5AXMNUCY_cjs = require('./chunk-5AXMNUCY.cjs');
+require('./chunk-DLRP7BI6.cjs');
+require('./chunk-HW7SEELD.cjs');
+require('./chunk-J7J7J2GN.cjs');
+require('./chunk-6LHQPOMI.cjs');
+
+
+
+Object.defineProperty(exports, "loadSubagents", {
+  enumerable: true,
+  get: function () { return chunk5AXMNUCY_cjs.loadSubagents; }
+});
+//# sourceMappingURL=subagents-loader-OMOH6ERO.cjs.map
+//# sourceMappingURL=subagents-loader-OMOH6ERO.cjs.map

package/dist/{subagents-loader-TPZLTXYZ.cjs.map → subagents-loader-OMOH6ERO.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"subagents-loader-TPZLTXYZ.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"subagents-loader-OMOH6ERO.cjs"}

package/dist/subagents-loader.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkSYVWE64W_cjs = require('./chunk-SYVWE64W.cjs');
-require('./chunk-GGZ5GPE3.cjs');
+var chunk5AXMNUCY_cjs = require('./chunk-5AXMNUCY.cjs');
+require('./chunk-DLRP7BI6.cjs');
 require('./chunk-HW7SEELD.cjs');
 var chunkJ7J7J2GN_cjs = require('./chunk-J7J7J2GN.cjs');
 require('./chunk-6LHQPOMI.cjs');
@@ -23,7 +23,7 @@ function resolveSources(options) {
 }
 async function discoverSubagents(cwd, options) {
   const sources = resolveSources(options);
-  return chunkSYVWE64W_cjs.loadSubagents(cwd, sources.includes("project"), void 0);
+  return chunk5AXMNUCY_cjs.loadSubagents(cwd, sources.includes("project"), void 0);
 }
 async function loadSubagentDefinition(name, cwd, options) {
   return (await discoverSubagents(cwd, options))[name];

package/dist/subagents-loader.js

@@ -1,5 +1,5 @@
-import { loadSubagents } from './chunk-4S5TWFIZ.js';
-import './chunk-67ADYSTW.js';
+import { loadSubagents } from './chunk-7RHC7HMS.js';
+import './chunk-GUKPXDGJ.js';
 import './chunk-JNAA4G4H.js';
 import { ConfigurationError } from './chunk-ALUN2B4W.js';
 import './chunk-CZJ6Q7CW.js';

package/docs/harness-capability-map.md

@@ -4,7 +4,7 @@ Every public symbol the TheoKit workspace publishes, and the exact specifier to
 
 A symbol listed under two specifiers is reachable from both, but that does NOT make the two interchangeable: a class emitted separately into a subpath entry is a distinct nominal type from the one in the root bundle, so passing one where the other is expected fails on a private field. When a symbol appears twice, import it and everything it is passed to from the SAME specifier.
 
-1191 export(s) across 46 entry point(s).
+1193 export(s) across 46 entry point(s).
 
 ## `@theokit/acp`
 
@@ -623,6 +623,7 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `MemoryFileEntry` | interface | Lightweight reference to a markdown file in the memory corpus.  |
 | `MemoryGetToolOptions` | interface | Options for {@link createMemoryGetTool } .  |
 | `MemoryIndex` | interface | The four operations both backends implement, and the type every consumer should hold.  |
+| `memoryIndexRoot` | function | Where the search index belongs for this configuration (theokit-sdk#554).  |
 | `MemoryLocationConfig` | type | Only `directory` is read; the full config is accepted so callers pass what they already hold. |
 | `memoryMdPath` | function | Path to `MEMORY.md`, the index that points at the per-memory files — and, in stores written before #389, the flat `## Facts` list itself.  |
 | `MemoryReadResult` | interface | Result of `reader.readFile`.  |
@@ -1051,6 +1052,7 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `lanceStoragePath` | function | `<memory root>/lance`.  |
 | `MEMORY_INDEX_MAX_BYTES` | const | The byte limit the Claude Code CLI applies when it loads a `MEMORY.md`, whichever it reaches first.  |
 | `MEMORY_INDEX_MAX_LINES` | const | The line limit the Claude Code CLI applies when it loads a `MEMORY.md`.  |
+| `memoryIndexRoot` | function | Where the search index belongs for this configuration (theokit-sdk#554).  |
 | `MemoryLocationConfig` | type | Only `directory` is read; the full config is accepted so callers pass what they already hold. |
 | `memoryMdPath` | function | Path to `MEMORY.md`, the index that points at the per-memory files — and, in stores written before #389, the flat `## Facts` list itself.  |
 | `memoryReadRoots` | function | Every directory a read must cover, deduplicated and in precedence order.  |

package/docs/memory-decisions.md

@@ -18,7 +18,7 @@ decision the next refactor deletes.
 .theokit/memory/.index/memory.sqlite   on the first send, when memory is enabled
 ```
 
-**Why it looks wrong.** With `memory.directory` pointed at the CLI's store, memory *facts* are
+**Why it looks wrong.** With `memory.directory` pointed at the CLI's store, memory _facts_ are
 written to `<claudeHome>/projects/<encoded-cwd>/memory/` — where the CLI reads them. So a project
 that never adopted this SDK ends up with a `.theokit/` directory anyway, which reads like the
 "write where the CLI reads" promise leaking.
@@ -36,10 +36,31 @@ Claude Code shape to be written in:
 The facts — the thing a user recorded and would lose — go where the CLI reads. The index is derived
 data that can be rebuilt from them.
 
+**Scope, narrowed 2026-09-04 (theokit-sdk#554).** This argument reaches the CLI's directory and no
+other. For any other `memory.directory`, the index now follows the store —
+`<directory>/.index/memory.sqlite` — and the reason the old behaviour was wrong is worth keeping:
+
+> The index is **not** a pointer. `chunks.text` holds the fact TEXT, because FTS5/BM25 needs it to
+> search, and `files.path` holds the store's absolute path. So a copy of the index is a copy of the
+> memory, readable with `strings`.
+
+Leaving it in `<cwd>` while the facts moved therefore wrote one operator's personal store into
+**every repository the agent ran in**, untracked and un-ignored. "Derived data" was true of its
+_derivability_ and false of its _contents_, and the sentence above was doing the work of both.
+
+The CLI case survives unchanged, on its own argument: that partner has no index format, so a binary
+there is an artefact it does not understand inside a directory it manages. `memoryIndexRoot`
+(`internal/memory/storage/memory-root.ts`) is the single place that decides, using the same
+path-only test `indexBudgetWarning` relies on.
+
+**How to check the narrowed scope still holds:** `tests/memory/index-follows-a-relocated-store.test.ts`
+pins both halves — a plain directory takes its own index, the CLI's does not — and
+`tests/memory/root.test.ts` carries the end-to-end pair through `IndexManager.open`.
+
 **How to check it still holds:** `tests/claude-code-e2e-compat.test.ts`, the pair
 `test_reading_a_cli_project_creates_nothing_in_it` /
 `test_running_an_agent_creates_theokit_and_only_sdk_state_in_it`. The second exists so the first is
-not vacuous — it asserts the directory contains *only* `agents` and `memory`.
+not vacuous — it asserts the directory contains _only_ `agents` and `memory`.
 
 ---
 
@@ -53,7 +74,7 @@ three retention buckets (atomic / consolidatable / lifecycle-managed). This SDK
 
 **Why it has not been widened.** The nine exist to drive differentiated retention, and **this SDK has
 no retention at all** — no TTL, no pruning, no decay (searched `ttl|prune|expire|retention` across
-both packages; the only hits are the recall result cache, which expires *results*, not entries).
+both packages; the only hits are the recall result cache, which expires _results_, not entries).
 Nine names over a regime where nothing expires are nine names for one behaviour. Retention has to
 exist before a vocabulary that differentiates it is worth anything.
 
@@ -76,7 +97,7 @@ emitted. That is evidence about what it WRITES, not proof about what it ACCEPTS
 means there is no precedent, and the burden belongs to whoever adds one unilaterally.
 
 **`failure_heuristic` is the one the retention argument does not cover, and the interop argument
-does.** It changes *what is written* (a trigger→resolution pair) rather than how an entry expires, so
+does.** It changes _what is written_ (a trigger→resolution pair) rather than how an entry expires, so
 "no retention to differentiate" says nothing about it — and nothing has adopted it (`grep
 failure_heuristic packages/sdk/src` → zero). It is not declined on retention grounds; it is held by
 the same shared-format question as the other four, and unblocking it means establishing what the CLI
@@ -112,7 +133,7 @@ text: the same text keeps the same file and increments corroboration, different
 `topic-2`. Found by the golden `multiple appends each get a file`, not by review — the failure was
 silent data loss, and nothing about the reasoning would have surfaced it.
 
-So the section heading stays true for what it describes, re-recording the *same* fact, and the case
+So the section heading stays true for what it describes, re-recording the _same_ fact, and the case
 it never covered is now covered.
 
 That change closed #446, where a passphrase the model had just refused to store was written into the
@@ -161,11 +182,11 @@ So no dense vector participates in scoring under a default configuration. One do
 consumer names an embedding provider.
 
 **Known divergence,** on the opt-in path: the external contract forbids dense vectors in agent-memory
-recall below a measured threshold (>1000 entries *and* demonstrated lexical degradation). Neither has
+recall below a measured threshold (>1000 entries _and_ demonstrated lexical degradation). Neither has
 been measured here.
 
 **The bigger gap WAS the default path, and it was not this divergence.** A contract arbitrating
-*between* retrieval methods does not cover the absence of one — and until `721a311f` there was no
+_between_ retrieval methods does not cover the absence of one — and until `721a311f` there was no
 method on this path at all. That is fixed; the history is kept because the failure mode is worth
 recognising again, and because it explains why the ranking signal has to depend on the question. A
 first version cut by recency alone, and a live run showed the answering fact dropped for being old
@@ -197,7 +218,7 @@ where this agent's memory lives. Everything under the root follows it: `MEMORY.m
 files, `notes/`, `sessions/`, `wiki/`, `transcripts/`, `dream-diary.md` and `.index/memory.sqlite`.
 
 **What it replaced.** The location used to be a side effect of `local.sessionDir`, the option that
-names the *transcript* home, on the reasoning that a consumer who set it had already opted into CLI
+names the _transcript_ home, on the reasoning that a consumer who set it had already opted into CLI
 interop. One option answered two questions — and of the fourteen places that computed a memory
 path, exactly one heard the second answer. `appendFact` relocated; the indexer, the `memory_get`
 path guard, `MEMORY.md`, `sessions/` and the index database did not. A relocated fact was written,
@@ -230,15 +251,15 @@ that were broken.
 
 Each row says what would close it, not only that it is open — the two invite very different work.
 
-| gap | where | what would close it |
-|---|---|---|
-| ~~The default recall path has no selection at all~~ — **closed** in `721a311f` | `local-agent-send.ts:257-272` | Closed: lexical relevance + recency, capped. Measured end to end against the real model — a 67-entry store went from ~66K to **13,606 tokens on the wire**, and the answering fact is recalled whether it is the oldest or the newest entry. |
-| The CLI's store is read whether or not the consumer opted in | `storage/memory-root.ts` — `claudeProjectMemoryDir(cwd)` is an unconditional entry in `memoryReadRoots` | A decision, not a fix: it is deliberate (*write one, read all*, so a consumer's existing memories are never orphaned) and it means a consumer who never opted into CLI interop still receives what the CLI accumulated in that project. Cheap while the cap holds; revisit if the cap is ever removed. |
-| No retention of any kind — no TTL, prune, or decay | searched `ttl\|prune\|expire\|retention` across both packages: zero | A per-kind TTL plus a prune step in the sweep. Needs the kind vocabulary to mean something first (§ 2), which is why this orders before widening it. |
-| Quarantine marks but does not constrain | `memory-file.ts:96`, `memory-provider.ts:48` | Implemented: three states, and `[unconfirmed]` on entries the store counted once. **Measured against the real model and it does not close the hole** — a planted memory alone is acted on 5/5, and beside a corroborated contradiction it is still asserted ~62% of runs (n=32). Marking influences the model; it does not constrain it. The guarantee is not available at this layer: blocking an uncorroborated entry would break the promise that a fact written once is recallable next session. |
-| A planted memory can make the agent ACT | measured: `RELEASE_OVERRIDE.txt` created in 2 of 6 runs | Register the permission layer — `PermissionPlugin.create(new PermissionEngine(…))` — which blocks it every time. This is the half that IS closable at the tool boundary; the informational half above is not. Any deployment where the memory directory is writable by anything other than this agent needs it. |
-| `description` is written as a copy of the body | `markdown-store.ts:205-211` — the *reader* (`:174-177`) already handles a distinct description correctly | Stop writing one when nobody declared it. The role is a one-line recall aid; deriving it mechanically would be inferring the situation, which § 2's rule already forbids for `kind`. Absent is a valid state and the reader already falls back to the body. |
-| The topic-name deriver filters English function words only | `memory-file.ts:73` | A store in another language keeps that language's function words in the slug and the index title — `de`, `do`, `para` survive, so the name is longer and noisier. **Never lossy:** collisions are caught by `resolveName` comparing text, not by the stopword list. Real stores here are bilingual, so this is a partial parity, not a complete one. Closes with a per-language list, or by not needing one. |
-| The dream sweep never filters by kind before dedup | `dreaming/phases.ts:34` — `lightPhase` never reads `kind` | Partition by kind before `lightPhase`. Nothing is deleted today, but a consolidated note can blend two distinct entries, and the note is what search returns. |
-| The dream sweep does not update the index | `dreaming/run.ts:53-96` writes `notes/` and never syncs | An `IndexManager.sync` after `writeConsolidatedNotes`. |
-| Recall fires every turn, cached on query hash, not on store manifest | `internal/local-agent/local-agent-memory.ts:87`; `sdk-memory/internal/active-memory/active-memory-cache.ts:66` | A second skip condition beside the existing one — hash of the store manifest, so an unchanged store skips even when the question changes. The query cache is not wrong; it answers a different question. |
+| gap                                                                            | where                                                                                                          | what would close it                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ~~The default recall path has no selection at all~~ — **closed** in `721a311f` | `local-agent-send.ts:257-272`                                                                                  | Closed: lexical relevance + recency, capped. Measured end to end against the real model — a 67-entry store went from ~66K to **13,606 tokens on the wire**, and the answering fact is recalled whether it is the oldest or the newest entry.                                                                                                                                                                                                                                                         |
+| The CLI's store is read whether or not the consumer opted in                   | `storage/memory-root.ts` — `claudeProjectMemoryDir(cwd)` is an unconditional entry in `memoryReadRoots`        | A decision, not a fix: it is deliberate (_write one, read all_, so a consumer's existing memories are never orphaned) and it means a consumer who never opted into CLI interop still receives what the CLI accumulated in that project. Cheap while the cap holds; revisit if the cap is ever removed.                                                                                                                                                                                               |
+| No retention of any kind — no TTL, prune, or decay                             | searched `ttl\|prune\|expire\|retention` across both packages: zero                                            | A per-kind TTL plus a prune step in the sweep. Needs the kind vocabulary to mean something first (§ 2), which is why this orders before widening it.                                                                                                                                                                                                                                                                                                                                                 |
+| Quarantine marks but does not constrain                                        | `memory-file.ts:96`, `memory-provider.ts:48`                                                                   | Implemented: three states, and `[unconfirmed]` on entries the store counted once. **Measured against the real model and it does not close the hole** — a planted memory alone is acted on 5/5, and beside a corroborated contradiction it is still asserted ~62% of runs (n=32). Marking influences the model; it does not constrain it. The guarantee is not available at this layer: blocking an uncorroborated entry would break the promise that a fact written once is recallable next session. |
+| A planted memory can make the agent ACT                                        | measured: `RELEASE_OVERRIDE.txt` created in 2 of 6 runs                                                        | Register the permission layer — `PermissionPlugin.create(new PermissionEngine(…))` — which blocks it every time. This is the half that IS closable at the tool boundary; the informational half above is not. Any deployment where the memory directory is writable by anything other than this agent needs it.                                                                                                                                                                                      |
+| `description` is written as a copy of the body                                 | `markdown-store.ts:205-211` — the _reader_ (`:174-177`) already handles a distinct description correctly       | Stop writing one when nobody declared it. The role is a one-line recall aid; deriving it mechanically would be inferring the situation, which § 2's rule already forbids for `kind`. Absent is a valid state and the reader already falls back to the body.                                                                                                                                                                                                                                          |
+| The topic-name deriver filters English function words only                     | `memory-file.ts:73`                                                                                            | A store in another language keeps that language's function words in the slug and the index title — `de`, `do`, `para` survive, so the name is longer and noisier. **Never lossy:** collisions are caught by `resolveName` comparing text, not by the stopword list. Real stores here are bilingual, so this is a partial parity, not a complete one. Closes with a per-language list, or by not needing one.                                                                                         |
+| The dream sweep never filters by kind before dedup                             | `dreaming/phases.ts:34` — `lightPhase` never reads `kind`                                                      | Partition by kind before `lightPhase`. Nothing is deleted today, but a consolidated note can blend two distinct entries, and the note is what search returns.                                                                                                                                                                                                                                                                                                                                        |
+| The dream sweep does not update the index                                      | `dreaming/run.ts:53-96` writes `notes/` and never syncs                                                        | An `IndexManager.sync` after `writeConsolidatedNotes`.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| Recall fires every turn, cached on query hash, not on store manifest           | `internal/local-agent/local-agent-memory.ts:87`; `sdk-memory/internal/active-memory/active-memory-cache.ts:66` | A second skip condition beside the existing one — hash of the store manifest, so an unchanged store skips even when the question changes. The query cache is not wrong; it answers a different question.                                                                                                                                                                                                                                                                                             |