@theokit/sdk 4.62.0 → 4.63.1

package/dist/{inject-session-ZCQUB3IT.js → inject-session-DAR7OUCW.js}

@@ -1,10 +1,10 @@
-import { enqueueSessionWrite } from './chunk-YEXA3PGR.js';
+import { enqueueSessionWrite } from './chunk-4FFBAUFS.js';
 import { invalidateSessionCache } from './chunk-WTMU7J4U.js';
-import './chunk-G24KZRSA.js';
-import { SessionTranscript } from './chunk-FKMUFNQE.js';
-import './chunk-VF7EWVDG.js';
-import './chunk-T7XEKOVW.js';
-import './chunk-T7O6K6PX.js';
+import './chunk-N2U4AZGB.js';
+import { SessionTranscript } from './chunk-UMP6OJIM.js';
+import './chunk-2GUYQR5P.js';
+import './chunk-D4CUGAKZ.js';
+import './chunk-XEQ3TM66.js';
 
 // src/internal/session/inject-session.ts
 async function injectSessionTurn(opts) {
@@ -23,5 +23,5 @@ async function injectSessionTurn(opts) {
 }
 
 export { injectSessionTurn };
-//# sourceMappingURL=inject-session-ZCQUB3IT.js.map
-//# sourceMappingURL=inject-session-ZCQUB3IT.js.map
+//# sourceMappingURL=inject-session-DAR7OUCW.js.map
+//# sourceMappingURL=inject-session-DAR7OUCW.js.map

package/dist/{inject-session-ZCQUB3IT.js.map → inject-session-DAR7OUCW.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/internal/session/inject-session.ts"],"names":[],"mappings":";;;;;;;;;AAWA,eAAsB,kBAAkB,IAAA,EAMtB;AAChB,EAAA,MAAM,oBAAoB,IAAA,CAAK,GAAA,CAAI,KAAK,IAAA,CAAK,GAAA,CAAI,SAAS,YAAY;AACpE,IAAA,MAAM,QAAQ,MAAM,IAAA,CAAK,MAAM,WAAA,CAAY,IAAA,CAAK,IAAI,OAAO,CAAA;AAC3D,IAAA,MAAM,UAAA,GAAa,iBAAA,CAAkB,WAAA,CAAY,KAAA,EAAO;AAAA,MACtD,GAAA,EAAK,KAAK,GAAA,CAAI,GAAA;AAAA,MACd,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,KAAA,EAAO,IAAA,CAAK,GAAA,CAAI,KAAA,IAAS;AAAA,KAC1B,CAAA;AACD,IAAA,UAAA,CAAW,cAAA,CAAe,KAAK,QAAQ,CAAA;AACvC,IAAA,UAAA,CAAW,mBAAA,CAAoB,EAAE,IAAA,EAAM,IAAA,CAAK,eAAe,CAAA;AAC3D,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,aAAA,CAAc,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,UAAA,CAAW,OAAA,EAAQ,CAAE,KAAA,CAAM,KAAA,CAAM,MAAM,CAAC,CAAA;AACzF,IAAA,sBAAA,CAAuB,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,IAAA,CAAK,IAAI,OAAO,CAAA;AAAA,EACvD,CAAC,CAAA;AACH","file":"inject-session-ZCQUB3IT.js","sourcesContent":["/**\n * M51 (agent-builder) — inject a SYNTHETIC user+assistant pair into a session's persisted transcript\n * WITHOUT running an LLM turn. This is the Codex review-exit mechanism (`exit_success.xml` appended to\n * the parent thread history so follow-ups like \"fix finding 2\" work): the pair chains onto the DAG\n * leaf (M50 pattern) and the in-memory cache is invalidated so the NEXT send re-hydrates with it.\n */\nimport type { SessionStore } from \"../../types/session-store.js\";\nimport { SessionTranscript } from \"../persistence/session-transcript.js\";\nimport { enqueueSessionWrite, invalidateSessionCache } from \"./agent-session.js\";\nimport type { CompactLocation } from \"./compact-session.js\";\n\nexport async function injectSessionTurn(opts: {\n  store: SessionStore;\n  loc: CompactLocation;\n  sessionId: string;\n  userText: string;\n  assistantText: string;\n}): Promise<void> {\n  await enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {\n    const prior = await opts.store.readRecords(opts.loc.agentId);\n    const transcript = SessionTranscript.fromRecords(prior, {\n      cwd: opts.loc.cwd,\n      sessionId: opts.sessionId,\n      model: opts.loc.model ?? \"unknown\",\n    });\n    transcript.appendUserTurn(opts.userText);\n    transcript.appendAssistantTurn({ text: opts.assistantText });\n    await opts.store.appendRecords(opts.loc.agentId, transcript.records().slice(prior.length));\n    invalidateSessionCache(opts.loc.cwd, opts.loc.agentId);\n  });\n}\n"]}
+{"version":3,"sources":["../src/internal/session/inject-session.ts"],"names":[],"mappings":";;;;;;;;;AAWA,eAAsB,kBAAkB,IAAA,EAMtB;AAChB,EAAA,MAAM,oBAAoB,IAAA,CAAK,GAAA,CAAI,KAAK,IAAA,CAAK,GAAA,CAAI,SAAS,YAAY;AACpE,IAAA,MAAM,QAAQ,MAAM,IAAA,CAAK,MAAM,WAAA,CAAY,IAAA,CAAK,IAAI,OAAO,CAAA;AAC3D,IAAA,MAAM,UAAA,GAAa,iBAAA,CAAkB,WAAA,CAAY,KAAA,EAAO;AAAA,MACtD,GAAA,EAAK,KAAK,GAAA,CAAI,GAAA;AAAA,MACd,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,KAAA,EAAO,IAAA,CAAK,GAAA,CAAI,KAAA,IAAS;AAAA,KAC1B,CAAA;AACD,IAAA,UAAA,CAAW,cAAA,CAAe,KAAK,QAAQ,CAAA;AACvC,IAAA,UAAA,CAAW,mBAAA,CAAoB,EAAE,IAAA,EAAM,IAAA,CAAK,eAAe,CAAA;AAC3D,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,aAAA,CAAc,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,UAAA,CAAW,OAAA,EAAQ,CAAE,KAAA,CAAM,KAAA,CAAM,MAAM,CAAC,CAAA;AACzF,IAAA,sBAAA,CAAuB,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,IAAA,CAAK,IAAI,OAAO,CAAA;AAAA,EACvD,CAAC,CAAA;AACH","file":"inject-session-DAR7OUCW.js","sourcesContent":["/**\n * M51 (agent-builder) — inject a SYNTHETIC user+assistant pair into a session's persisted transcript\n * WITHOUT running an LLM turn. This is the Codex review-exit mechanism (`exit_success.xml` appended to\n * the parent thread history so follow-ups like \"fix finding 2\" work): the pair chains onto the DAG\n * leaf (M50 pattern) and the in-memory cache is invalidated so the NEXT send re-hydrates with it.\n */\nimport type { SessionStore } from \"../../types/session-store.js\";\nimport { SessionTranscript } from \"../persistence/session-transcript.js\";\nimport { enqueueSessionWrite, invalidateSessionCache } from \"./agent-session.js\";\nimport type { CompactLocation } from \"./compact-session.js\";\n\nexport async function injectSessionTurn(opts: {\n  store: SessionStore;\n  loc: CompactLocation;\n  sessionId: string;\n  userText: string;\n  assistantText: string;\n}): Promise<void> {\n  await enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {\n    const prior = await opts.store.readRecords(opts.loc.agentId);\n    const transcript = SessionTranscript.fromRecords(prior, {\n      cwd: opts.loc.cwd,\n      sessionId: opts.sessionId,\n      model: opts.loc.model ?? \"unknown\",\n    });\n    transcript.appendUserTurn(opts.userText);\n    transcript.appendAssistantTurn({ text: opts.assistantText });\n    await opts.store.appendRecords(opts.loc.agentId, transcript.records().slice(prior.length));\n    invalidateSessionCache(opts.loc.cwd, opts.loc.agentId);\n  });\n}\n"]}

package/dist/{inject-session-PPSO2IDD.cjs → inject-session-WQKMC3GR.cjs}

@@ -1,18 +1,18 @@
 'use strict';
 
-var chunk2DG7KW4L_cjs = require('./chunk-2DG7KW4L.cjs');
+var chunkRMWTPV3M_cjs = require('./chunk-RMWTPV3M.cjs');
 var chunk4OTIXDMU_cjs = require('./chunk-4OTIXDMU.cjs');
-require('./chunk-Z4BCLVTI.cjs');
-var chunkBUIK7GUA_cjs = require('./chunk-BUIK7GUA.cjs');
-require('./chunk-I6TGFUCO.cjs');
-require('./chunk-JTB5Q42C.cjs');
-require('./chunk-NUKRL3I6.cjs');
+require('./chunk-O7LZFG6O.cjs');
+var chunk5HEG4CQH_cjs = require('./chunk-5HEG4CQH.cjs');
+require('./chunk-UALX2J2Q.cjs');
+require('./chunk-XL7Q7HB2.cjs');
+require('./chunk-EG4QM7ZJ.cjs');
 
 // src/internal/session/inject-session.ts
 async function injectSessionTurn(opts) {
-  await chunk2DG7KW4L_cjs.enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {
+  await chunkRMWTPV3M_cjs.enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {
     const prior = await opts.store.readRecords(opts.loc.agentId);
-    const transcript = chunkBUIK7GUA_cjs.SessionTranscript.fromRecords(prior, {
+    const transcript = chunk5HEG4CQH_cjs.SessionTranscript.fromRecords(prior, {
       cwd: opts.loc.cwd,
       sessionId: opts.sessionId,
       model: opts.loc.model ?? "unknown"
@@ -25,5 +25,5 @@ async function injectSessionTurn(opts) {
 }
 
 exports.injectSessionTurn = injectSessionTurn;
-//# sourceMappingURL=inject-session-PPSO2IDD.cjs.map
-//# sourceMappingURL=inject-session-PPSO2IDD.cjs.map
+//# sourceMappingURL=inject-session-WQKMC3GR.cjs.map
+//# sourceMappingURL=inject-session-WQKMC3GR.cjs.map

package/dist/{inject-session-PPSO2IDD.cjs.map → inject-session-WQKMC3GR.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/internal/session/inject-session.ts"],"names":["enqueueSessionWrite","SessionTranscript","invalidateSessionCache"],"mappings":";;;;;;;;;;;AAWA,eAAsB,kBAAkB,IAAA,EAMtB;AAChB,EAAA,MAAMA,sCAAoB,IAAA,CAAK,GAAA,CAAI,KAAK,IAAA,CAAK,GAAA,CAAI,SAAS,YAAY;AACpE,IAAA,MAAM,QAAQ,MAAM,IAAA,CAAK,MAAM,WAAA,CAAY,IAAA,CAAK,IAAI,OAAO,CAAA;AAC3D,IAAA,MAAM,UAAA,GAAaC,mCAAA,CAAkB,WAAA,CAAY,KAAA,EAAO;AAAA,MACtD,GAAA,EAAK,KAAK,GAAA,CAAI,GAAA;AAAA,MACd,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,KAAA,EAAO,IAAA,CAAK,GAAA,CAAI,KAAA,IAAS;AAAA,KAC1B,CAAA;AACD,IAAA,UAAA,CAAW,cAAA,CAAe,KAAK,QAAQ,CAAA;AACvC,IAAA,UAAA,CAAW,mBAAA,CAAoB,EAAE,IAAA,EAAM,IAAA,CAAK,eAAe,CAAA;AAC3D,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,aAAA,CAAc,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,UAAA,CAAW,OAAA,EAAQ,CAAE,KAAA,CAAM,KAAA,CAAM,MAAM,CAAC,CAAA;AACzF,IAAAC,wCAAA,CAAuB,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,IAAA,CAAK,IAAI,OAAO,CAAA;AAAA,EACvD,CAAC,CAAA;AACH","file":"inject-session-PPSO2IDD.cjs","sourcesContent":["/**\n * M51 (agent-builder) — inject a SYNTHETIC user+assistant pair into a session's persisted transcript\n * WITHOUT running an LLM turn. This is the Codex review-exit mechanism (`exit_success.xml` appended to\n * the parent thread history so follow-ups like \"fix finding 2\" work): the pair chains onto the DAG\n * leaf (M50 pattern) and the in-memory cache is invalidated so the NEXT send re-hydrates with it.\n */\nimport type { SessionStore } from \"../../types/session-store.js\";\nimport { SessionTranscript } from \"../persistence/session-transcript.js\";\nimport { enqueueSessionWrite, invalidateSessionCache } from \"./agent-session.js\";\nimport type { CompactLocation } from \"./compact-session.js\";\n\nexport async function injectSessionTurn(opts: {\n  store: SessionStore;\n  loc: CompactLocation;\n  sessionId: string;\n  userText: string;\n  assistantText: string;\n}): Promise<void> {\n  await enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {\n    const prior = await opts.store.readRecords(opts.loc.agentId);\n    const transcript = SessionTranscript.fromRecords(prior, {\n      cwd: opts.loc.cwd,\n      sessionId: opts.sessionId,\n      model: opts.loc.model ?? \"unknown\",\n    });\n    transcript.appendUserTurn(opts.userText);\n    transcript.appendAssistantTurn({ text: opts.assistantText });\n    await opts.store.appendRecords(opts.loc.agentId, transcript.records().slice(prior.length));\n    invalidateSessionCache(opts.loc.cwd, opts.loc.agentId);\n  });\n}\n"]}
+{"version":3,"sources":["../src/internal/session/inject-session.ts"],"names":["enqueueSessionWrite","SessionTranscript","invalidateSessionCache"],"mappings":";;;;;;;;;;;AAWA,eAAsB,kBAAkB,IAAA,EAMtB;AAChB,EAAA,MAAMA,sCAAoB,IAAA,CAAK,GAAA,CAAI,KAAK,IAAA,CAAK,GAAA,CAAI,SAAS,YAAY;AACpE,IAAA,MAAM,QAAQ,MAAM,IAAA,CAAK,MAAM,WAAA,CAAY,IAAA,CAAK,IAAI,OAAO,CAAA;AAC3D,IAAA,MAAM,UAAA,GAAaC,mCAAA,CAAkB,WAAA,CAAY,KAAA,EAAO;AAAA,MACtD,GAAA,EAAK,KAAK,GAAA,CAAI,GAAA;AAAA,MACd,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,KAAA,EAAO,IAAA,CAAK,GAAA,CAAI,KAAA,IAAS;AAAA,KAC1B,CAAA;AACD,IAAA,UAAA,CAAW,cAAA,CAAe,KAAK,QAAQ,CAAA;AACvC,IAAA,UAAA,CAAW,mBAAA,CAAoB,EAAE,IAAA,EAAM,IAAA,CAAK,eAAe,CAAA;AAC3D,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,aAAA,CAAc,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,UAAA,CAAW,OAAA,EAAQ,CAAE,KAAA,CAAM,KAAA,CAAM,MAAM,CAAC,CAAA;AACzF,IAAAC,wCAAA,CAAuB,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,IAAA,CAAK,IAAI,OAAO,CAAA;AAAA,EACvD,CAAC,CAAA;AACH","file":"inject-session-WQKMC3GR.cjs","sourcesContent":["/**\n * M51 (agent-builder) — inject a SYNTHETIC user+assistant pair into a session's persisted transcript\n * WITHOUT running an LLM turn. This is the Codex review-exit mechanism (`exit_success.xml` appended to\n * the parent thread history so follow-ups like \"fix finding 2\" work): the pair chains onto the DAG\n * leaf (M50 pattern) and the in-memory cache is invalidated so the NEXT send re-hydrates with it.\n */\nimport type { SessionStore } from \"../../types/session-store.js\";\nimport { SessionTranscript } from \"../persistence/session-transcript.js\";\nimport { enqueueSessionWrite, invalidateSessionCache } from \"./agent-session.js\";\nimport type { CompactLocation } from \"./compact-session.js\";\n\nexport async function injectSessionTurn(opts: {\n  store: SessionStore;\n  loc: CompactLocation;\n  sessionId: string;\n  userText: string;\n  assistantText: string;\n}): Promise<void> {\n  await enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {\n    const prior = await opts.store.readRecords(opts.loc.agentId);\n    const transcript = SessionTranscript.fromRecords(prior, {\n      cwd: opts.loc.cwd,\n      sessionId: opts.sessionId,\n      model: opts.loc.model ?? \"unknown\",\n    });\n    transcript.appendUserTurn(opts.userText);\n    transcript.appendAssistantTurn({ text: opts.assistantText });\n    await opts.store.appendRecords(opts.loc.agentId, transcript.records().slice(prior.length));\n    invalidateSessionCache(opts.loc.cwd, opts.loc.agentId);\n  });\n}\n"]}

package/dist/internal/memory/active-memory.d.ts

@@ -3,6 +3,7 @@ import { type TelemetryHandle } from "../telemetry/tracer.js";
 import type { ActiveMemoryCache } from "./active-memory-cache.js";
 import type { ActiveMemoryQueryMode, ActiveMemoryResult, ActiveMemoryStatus } from "./active-memory-types.js";
 import type { MemoryIndex } from "./memory-index.js";
+import { type MemoryRoot } from "./storage/memory-root.js";
 export type { ActiveMemoryQueryMode, ActiveMemoryResult, ActiveMemoryStatus };
 export interface RunActiveMemoryArgs {
     userText: string;
@@ -18,7 +19,13 @@ export interface RunActiveMemoryArgs {
     cache?: ActiveMemoryCache;
     /** Workspace root for transcript persistence. */
     cwd?: string;
-    /** When true, write transcript JSON under .theokit/memory/transcripts/active-memory/. */
+    /**
+     * The memory root the caller already resolved. Falls back to the project store, which is right
+     * for a caller that has no `memory.directory` and wrong for one that does — so an agent passes
+     * its own (#463).
+     */
+    memoryRoot?: MemoryRoot;
+    /** When true, write transcript JSON under `<memory root>/transcripts/active-memory/`. */
     persistTranscripts?: boolean;
     /** Stable key the breaker + cache key by (default `default`). */
     agentKey?: string;

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

@@ -1,22 +1,22 @@
 'use strict';
 
-var chunkEI2Q7SJ5_cjs = require('../../../chunk-EI2Q7SJ5.cjs');
+var chunkKQ7TS7WW_cjs = require('../../../chunk-KQ7TS7WW.cjs');
 var chunkGHX4P3V2_cjs = require('../../../chunk-GHX4P3V2.cjs');
-require('../../../chunk-DQKERTND.cjs');
+require('../../../chunk-UGT7GK7I.cjs');
 require('../../../chunk-MUUQ2WFJ.cjs');
-require('../../../chunk-R3UPQFKK.cjs');
+require('../../../chunk-V2BOS4WF.cjs');
 require('../../../chunk-VKJ7V7EB.cjs');
-require('../../../chunk-ILCGLTSA.cjs');
-require('../../../chunk-CQGYNZ3K.cjs');
-require('../../../chunk-K3FW2XZD.cjs');
-require('../../../chunk-JTB5Q42C.cjs');
-require('../../../chunk-NUKRL3I6.cjs');
+require('../../../chunk-ZSWPZ23K.cjs');
+require('../../../chunk-XWTLIGO3.cjs');
+require('../../../chunk-4ZHTIJNE.cjs');
+require('../../../chunk-XL7Q7HB2.cjs');
+require('../../../chunk-EG4QM7ZJ.cjs');
 
 
 
 Object.defineProperty(exports, "createOpenAiCompatibleRuntime", {
   enumerable: true,
-  get: function () { return chunkEI2Q7SJ5_cjs.createOpenAiCompatibleRuntime; }
+  get: function () { return chunkKQ7TS7WW_cjs.createOpenAiCompatibleRuntime; }
 });
 Object.defineProperty(exports, "LruEmbeddingCache", {
   enumerable: true,

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

@@ -1,13 +1,13 @@
-export { createOpenAiCompatibleRuntime } from '../../../chunk-XN7NOENA.js';
+export { createOpenAiCompatibleRuntime } from '../../../chunk-UBDMVMBZ.js';
 export { LruEmbeddingCache, globalEmbeddingCache } from '../../../chunk-H73MEMQB.js';
-import '../../../chunk-5JLFFPCH.js';
+import '../../../chunk-7YGCPMGB.js';
 import '../../../chunk-FD2UT76F.js';
-import '../../../chunk-QARJGQSA.js';
+import '../../../chunk-HS7AVXTF.js';
 import '../../../chunk-RIAM53CP.js';
-import '../../../chunk-UC3HT2S4.js';
-import '../../../chunk-OC4NTGMN.js';
-import '../../../chunk-IDCKSLYH.js';
-import '../../../chunk-T7XEKOVW.js';
-import '../../../chunk-T7O6K6PX.js';
+import '../../../chunk-C72AZW7J.js';
+import '../../../chunk-4QZSA2HJ.js';
+import '../../../chunk-ZZMZWBR6.js';
+import '../../../chunk-D4CUGAKZ.js';
+import '../../../chunk-XEQ3TM66.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/internal/memory/dreaming/diary.d.ts

@@ -1,4 +1,41 @@
-export declare function diaryPath(cwd: string): string;
+import type { MemoryRoot } from "../storage/memory-root.js";
+/**
+ * Dream-diary append (ADR D7).
+ *
+ * Diary lives at `.theokit/memory/dream-diary.md` and grows with one entry
+ * per sweep. Each entry is content-hashed so the same input produces the
+ * same entry — idempotency contract.
+ *
+ * Writes go through `replaceFileAtomic` (EC-3 of edge-case review) so a
+ * crash mid-write can never leave a half-written diary.
+ *
+ * Shared with `@theokit/sdk-memory`; see the memory-store barrel.
+ */
+export interface DiaryEntry {
+    timestampMs: number;
+    factsBefore: number;
+    factsAfter: number;
+    duplicatesRemoved: number;
+    clustersCreated: number;
+    notesWritten: number;
+}
+/** `<memory root>/dream-diary.md`. Takes the RESOLVED ROOT — see `storage/memory-root.ts` (#463). */
+export declare function diaryPath(root: MemoryRoot): string;
+/**
+ * One diary entry as the markdown that gets appended: a timestamp heading, the short entry hash,
+ * and the counts the sweep produced. The hash is what makes a re-run recognisable as the same
+ * sweep rather than a new one.
+ */
 export declare function renderDiaryEntry(entry: DiaryEntry): string;
-export declare function appendDiaryEntry(cwd: string, entry: DiaryEntry): Promise<void>;
+/**
+ * Append one sweep's entry to `<memory root>/dream-diary.md`, creating the file with its header
+ * when this is the first sweep. The diary is a human-readable record of what dreaming changed —
+ * consolidations are otherwise invisible, because they alter the notes rather than announce
+ * themselves.
+ */
+export declare function appendDiaryEntry(root: MemoryRoot, entry: DiaryEntry): Promise<void>;
+/**
+ * A stable hash of one entry's counts, so two sweeps that did the same work read as the same work.
+ * Rendered truncated in the entry; the full value is what callers compare.
+ */
 export declare function entryHash(entry: DiaryEntry): string;

package/dist/internal/memory/index-db.d.ts

@@ -1,3 +1,32 @@
+import type { MemoryRoot } from "./storage/memory-root.js";
+/**
+ * Memory index DB handle + opener.
+ *
+ * M0-5 (plan m0-foundation-expose-primitives): the driver-load + WAL +
+ * corruption-recovery (EC-7) plumbing is now the shared `openSqliteResilient`
+ * primitive in `internal/persistence`; this module only declares the memory
+ * schema application (PRAGMA + SCHEMA) via its `onOpen` callback.
+ *
+ * Shared with `@theokit/sdk-memory`; see the memory-store barrel.
+ */
+export interface MemoryDb {
+    exec(sql: string): void;
+    prepare(sql: string): {
+        run(...args: unknown[]): {
+            changes: number;
+            lastInsertRowid: number | bigint;
+        };
+        get(...args: unknown[]): Record<string, unknown> | undefined;
+        all(...args: unknown[]): Array<Record<string, unknown>>;
+    };
+    /** SQLite `pragma()` access (used by `applyWalWithFallback`). */
+    pragma(statement: string, options?: {
+        simple?: boolean;
+    }): unknown;
+    close(): void;
+    /** Load a SQLite loadable extension at the given path (used by sqlite-vec). */
+    loadExtension(path: string): void;
+}
 export interface OpenDbOptions {
     filePath: string;
     /**
@@ -7,4 +36,18 @@ export interface OpenDbOptions {
     recoverCorrupt?: boolean;
 }
 export declare function openMemoryDb(opts: OpenDbOptions): Promise<MemoryDb>;
-export declare function defaultIndexPath(cwd: string): string;
+/**
+ * `<index root>/.index/memory.sqlite`. Pure path computation.
+ *
+ * Takes a resolved root rather than a `cwd`: this function used to spell the default layout out
+ * again as a string literal — an answer to "where does memory live?" that no search for the shared
+ * helper would have found (#463).
+ *
+ * **The root it is given is the PROJECT store, even when the facts move.** `memory.directory` may
+ * point at the directory the Claude Code CLI manages, and that CLI has no index format — putting a
+ * binary artefact it does not understand inside a directory it owns is a different decision from
+ * putting the facts there, and it was made deliberately. The facts are what a user would lose; the
+ * index is derived and rebuildable from them. See `docs/memory-decisions.md` § 1 before relocating
+ * this, and `IndexManager.openSqliteInternal` for the caller that keeps the two apart.
+ */
+export declare function defaultIndexPath(root: MemoryRoot): string;

package/dist/internal/memory/index-manager-contract.d.ts

@@ -1,4 +1,5 @@
 import type { EmbeddingRuntime } from "./embedding-adapter.js";
+import type { MemoryRoot } from "./storage/memory-root.js";
 export interface IndexStatus {
     backend: "fts-only" | "hybrid";
     filesIndexed: number;
@@ -18,6 +19,15 @@ export interface SearchOptions {
 export type MemoryBackend = "sqlite-vec" | "lance";
 export interface OpenIndexOptions {
     cwd: string;
+    /**
+     * The memory root to index and to place the database under. Defaults to `<cwd>/.theokit/memory`.
+     *
+     * Optional HERE and required everywhere below, deliberately. This is a public entry point whose
+     * caller may legitimately have only a workspace; inside an agent the root is resolved once from
+     * `memory.directory` and passed in, which is what keeps the index and the writer looking at the
+     * same directory (#463).
+     */
+    memoryRoot?: MemoryRoot;
     filePath?: string;
     /** When provided, vector index is enabled in hybrid mode. */
     embedding?: EmbeddingRuntime;

package/dist/internal/memory/index-manager-helpers.d.ts

@@ -1 +1,20 @@
-export {};
+import type { MemoryRoot } from "./storage/memory-root.js";
+/**
+ * One markdown file the corpus walk found, with the source bucket the indexer tags it with.
+ * Shared through the semver-exempt `internal/memory-store` sub-path, so it carries no
+ * visibility tag — see that barrel for why naming the tag here would delete this symbol.
+ */
+export interface DiscoveredFile {
+    absolutePath: string;
+    relPath: string;
+    source: "memory" | "wiki" | "sessions";
+}
+/**
+ * Every markdown file the memory corpus holds: the index, the per-memory files, `notes/`,
+ * `wiki/` and `sessions/`, each tagged with the bucket `memory_search`'s `corpus` filters on.
+ *
+ * Shared through the semver-exempt `internal/memory-store` sub-path so `@theokit/sdk-memory` walks
+ * the same corpus. Its own copy did not: it never picked up the per-memory files at the root, so
+ * installing that package made every converged memory unsearchable and reported nothing.
+ */
+export declare function collectMarkdownFiles(root: MemoryRoot): Promise<DiscoveredFile[]>;

package/dist/internal/memory/index-manager.d.ts

@@ -1,7 +1,7 @@
 import { type MemoryIndex } from "./memory-index.js";
 import type { IndexStatus, MemorySearchHit, OpenIndexOptions, SearchOptions } from "./index-manager-contract.js";
 export declare class IndexManager implements MemoryIndex {
-    private readonly cwd;
+    private readonly memoryRoot;
     private readonly db;
     private readonly embedding;
     private lastSyncMs;

package/dist/internal/memory/lance-index.d.ts

@@ -1,4 +1,5 @@
 import type { EmbeddingRuntime } from "./embedding-adapter.js";
+import { type MemoryRoot } from "./storage/memory-root.js";
 export interface LanceFactRecord {
     id: string;
     text: string;
@@ -11,8 +12,10 @@ export interface LanceFactRecord {
 }
 export interface OpenLanceOptions {
     cwd: string;
+    /** The resolved memory root. Defaults to `<cwd>/.theokit/memory` (#463). */
+    memoryRoot?: MemoryRoot;
     embedding: EmbeddingRuntime;
-    /** Override storage location. Default: `<cwd>/.theokit/memory/lance/`. */
+    /** Override storage location. Default: `<memory root>/lance/`. */
     storagePath?: string;
 }
 export interface LanceSearchOptions {
@@ -30,3 +33,14 @@ export interface LanceSearchHit {
     userId: string;
     score: number;
 }
+/**
+ * `<memory root>/lance`.
+ *
+ * Takes the RESOLVED ROOT. This used to spell the default layout out again as a string literal,
+ * beside a second copy of the same literal in `open()` — two more answers to "where does memory
+ * live?" that no `memoryDir` search would have surfaced (#463).
+ *
+ * Shared with `@theokit/sdk-memory` through the memory-store barrel, so it carries no
+ * visibility tag — naming that tag in this block would delete the function below it (#463).
+ */
+export declare function lanceStoragePath(root: MemoryRoot): string;

package/dist/internal/memory/migrate-sqlite-to-lance.d.ts

@@ -1,3 +1,23 @@
+import { type MemoryRoot } from "./storage/memory-root.js";
+/**
+ * Migrate Memory.index from SQLite to LanceDB (ADR D44).
+ *
+ * EC-3 MUST FIX: validation uses NFC unicode normalization on both sides.
+ *
+ * Shared with `@theokit/sdk-memory` through the memory-store barrel (#463).
+ */
+export interface MigrateOptions {
+    cwd: string;
+    /**
+     * Absolute path (or `~/`-prefixed) of the memory root to migrate, when the agent that wrote it
+     * set `memory.directory`. Defaults to `<cwd>/.theokit/memory` (#463).
+     */
+    directory?: string;
+    dryRun?: boolean;
+    batchSize?: number;
+    /** Inject for tests; defaults to console.log. */
+    logger?: (msg: string) => void;
+}
 export interface MigrateResult {
     countSqlite: number;
     countLance: number;
@@ -13,3 +33,26 @@ export interface MigrateResult {
     /** Was the migration committed (false for dry-run). */
     committed: boolean;
 }
+/**
+ * One row of the SQLite memory index, as the Lance migration reads it: the chunk plus the tenant
+ * columns the target table needs. Shared with `@theokit/sdk-memory`, which migrates the same table.
+ */
+export interface SqliteFactRow {
+    id: string;
+    path: string;
+    source: "memory" | "sessions" | "wiki";
+    start_line: number;
+    end_line: number;
+    text: string;
+    namespace?: string | null;
+    scope?: string | null;
+    user_id?: string | null;
+}
+/**
+ * Read all facts from the SQLite memory index. Returns empty array if the
+ * SQLite db file does not exist (workspace never used Memory).
+ *
+ * Shared with `@theokit/sdk-memory` through the memory-store barrel, so it carries no visibility
+ * tag — naming that tag in this block would delete the function below it (#463).
+ */
+export declare function readAllSqliteFacts(root: MemoryRoot): Promise<SqliteFactRow[]>;

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

@@ -1,54 +1,137 @@
 'use strict';
 
-var chunk2UCFUSPW_cjs = require('../../../chunk-2UCFUSPW.cjs');
+var chunkHOXVQ5FR_cjs = require('../../../chunk-HOXVQ5FR.cjs');
+var chunkGKEFRLU7_cjs = require('../../../chunk-GKEFRLU7.cjs');
+var chunk6RKUO7AW_cjs = require('../../../chunk-6RKUO7AW.cjs');
 require('../../../chunk-KRD3GQAA.cjs');
 require('../../../chunk-MUUQ2WFJ.cjs');
-require('../../../chunk-R3UPQFKK.cjs');
+require('../../../chunk-V2BOS4WF.cjs');
 require('../../../chunk-VKJ7V7EB.cjs');
-require('../../../chunk-BUIK7GUA.cjs');
+require('../../../chunk-5HEG4CQH.cjs');
+require('../../../chunk-5VB22SYX.cjs');
 require('../../../chunk-ZF2LDKQQ.cjs');
-require('../../../chunk-I6TGFUCO.cjs');
-require('../../../chunk-K3FW2XZD.cjs');
-require('../../../chunk-JTB5Q42C.cjs');
-require('../../../chunk-NUKRL3I6.cjs');
+require('../../../chunk-UALX2J2Q.cjs');
+require('../../../chunk-4ZHTIJNE.cjs');
+require('../../../chunk-XL7Q7HB2.cjs');
+require('../../../chunk-EG4QM7ZJ.cjs');
 
 
 
+Object.defineProperty(exports, "appendDiaryEntry", {
+  enumerable: true,
+  get: function () { return chunkHOXVQ5FR_cjs.appendDiaryEntry; }
+});
+Object.defineProperty(exports, "diaryPath", {
+  enumerable: true,
+  get: function () { return chunkHOXVQ5FR_cjs.diaryPath; }
+});
+Object.defineProperty(exports, "entryHash", {
+  enumerable: true,
+  get: function () { return chunkHOXVQ5FR_cjs.entryHash; }
+});
+Object.defineProperty(exports, "readAllSqliteFacts", {
+  enumerable: true,
+  get: function () { return chunkHOXVQ5FR_cjs.readAllSqliteFacts; }
+});
+Object.defineProperty(exports, "renderDiaryEntry", {
+  enumerable: true,
+  get: function () { return chunkHOXVQ5FR_cjs.renderDiaryEntry; }
+});
+Object.defineProperty(exports, "persistActiveMemoryTranscript", {
+  enumerable: true,
+  get: function () { return chunkGKEFRLU7_cjs.persistActiveMemoryTranscript; }
+});
+Object.defineProperty(exports, "MEMORY_INDEX_MAX_BYTES", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.MEMORY_INDEX_MAX_BYTES; }
+});
+Object.defineProperty(exports, "MEMORY_INDEX_MAX_LINES", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.MEMORY_INDEX_MAX_LINES; }
+});
 Object.defineProperty(exports, "appendFact", {
   enumerable: true,
-  get: function () { return chunk2UCFUSPW_cjs.appendFact; }
+  get: function () { return chunk6RKUO7AW_cjs.appendFact; }
 });
 Object.defineProperty(exports, "appendFactToMarkdown", {
   enumerable: true,
-  get: function () { return chunk2UCFUSPW_cjs.appendFactToMarkdown; }
+  get: function () { return chunk6RKUO7AW_cjs.appendFactToMarkdown; }
+});
+Object.defineProperty(exports, "asMemoryRoot", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.asMemoryRoot; }
 });
 Object.defineProperty(exports, "claudeProjectMemoryDir", {
   enumerable: true,
-  get: function () { return chunk2UCFUSPW_cjs.claudeProjectMemoryDir; }
+  get: function () { return chunk6RKUO7AW_cjs.claudeProjectMemoryDir; }
+});
+Object.defineProperty(exports, "collectMarkdownFiles", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.collectMarkdownFiles; }
 });
-Object.defineProperty(exports, "memoryDir", {
+Object.defineProperty(exports, "defaultIndexPath", {
   enumerable: true,
-  get: function () { return chunk2UCFUSPW_cjs.memoryDir; }
+  get: function () { return chunk6RKUO7AW_cjs.defaultIndexPath; }
+});
+Object.defineProperty(exports, "discoverSessionFiles", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.discoverSessionFiles; }
+});
+Object.defineProperty(exports, "discoverWikiFiles", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.discoverWikiFiles; }
+});
+Object.defineProperty(exports, "indexBudgetWarning", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.indexBudgetWarning; }
+});
+Object.defineProperty(exports, "lanceStoragePath", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.lanceStoragePath; }
 });
 Object.defineProperty(exports, "memoryMdPath", {
   enumerable: true,
-  get: function () { return chunk2UCFUSPW_cjs.memoryMdPath; }
+  get: function () { return chunk6RKUO7AW_cjs.memoryMdPath; }
 });
-Object.defineProperty(exports, "memoryWriteDir", {
+Object.defineProperty(exports, "memoryReadRoots", {
   enumerable: true,
-  get: function () { return chunk2UCFUSPW_cjs.memoryWriteDir; }
+  get: function () { return chunk6RKUO7AW_cjs.memoryReadRoots; }
 });
 Object.defineProperty(exports, "notesDir", {
   enumerable: true,
-  get: function () { return chunk2UCFUSPW_cjs.notesDir; }
+  get: function () { return chunk6RKUO7AW_cjs.notesDir; }
+});
+Object.defineProperty(exports, "projectMemoryDir", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.projectMemoryDir; }
 });
 Object.defineProperty(exports, "readFacts", {
   enumerable: true,
-  get: function () { return chunk2UCFUSPW_cjs.readFacts; }
+  get: function () { return chunk6RKUO7AW_cjs.readFacts; }
 });
 Object.defineProperty(exports, "readFactsFromMarkdown", {
   enumerable: true,
-  get: function () { return chunk2UCFUSPW_cjs.readFactsFromMarkdown; }
+  get: function () { return chunk6RKUO7AW_cjs.readFactsFromMarkdown; }
+});
+Object.defineProperty(exports, "resolveMemoryRoot", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.resolveMemoryRoot; }
+});
+Object.defineProperty(exports, "sessionSummaryPath", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.sessionSummaryPath; }
+});
+Object.defineProperty(exports, "sessionsDir", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.sessionsDir; }
+});
+Object.defineProperty(exports, "wikiDir", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.wikiDir; }
+});
+Object.defineProperty(exports, "writeSessionSummary", {
+  enumerable: true,
+  get: function () { return chunk6RKUO7AW_cjs.writeSessionSummary; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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

@@ -15,4 +15,14 @@
  * Semver-exempt: NOT part of the stable `@theokit/sdk` API. The sub-path IS declared in
  * `package.json` `exports`, so the names below must survive into the published declarations.
  */
-export { appendFact, appendFactToMarkdown, claudeProjectMemoryDir, memoryDir, memoryMdPath, memoryWriteDir, notesDir, readFacts, readFactsFromMarkdown, } from "./markdown-store.js";
+export { appendDiaryEntry, type DiaryEntry, diaryPath, entryHash, renderDiaryEntry, } from "../dreaming/diary.js";
+export { defaultIndexPath } from "../index-db.js";
+export { collectMarkdownFiles, type DiscoveredFile } from "../index-manager-helpers.js";
+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 { 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";
+export { discoverWikiFiles, type WikiFile, wikiDir } from "./wiki-loader.js";

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

@@ -15,4 +15,14 @@
  * Semver-exempt: NOT part of the stable `@theokit/sdk` API. The sub-path IS declared in
  * `package.json` `exports`, so the names below must survive into the published declarations.
  */
-export { appendFact, appendFactToMarkdown, claudeProjectMemoryDir, memoryDir, memoryMdPath, memoryWriteDir, notesDir, readFacts, readFactsFromMarkdown, } from "./markdown-store.js";
+export { appendDiaryEntry, type DiaryEntry, diaryPath, entryHash, renderDiaryEntry, } from "../dreaming/diary.js";
+export { defaultIndexPath } from "../index-db.js";
+export { collectMarkdownFiles, type DiscoveredFile } from "../index-manager-helpers.js";
+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 { 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";
+export { discoverWikiFiles, type WikiFile, wikiDir } from "./wiki-loader.js";

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

@@ -1,13 +1,16 @@
-export { appendFact, appendFactToMarkdown, claudeProjectMemoryDir, memoryDir, memoryMdPath, memoryWriteDir, notesDir, readFacts, readFactsFromMarkdown } from '../../../chunk-WCLDJSMY.js';
+export { appendDiaryEntry, diaryPath, entryHash, readAllSqliteFacts, renderDiaryEntry } from '../../../chunk-DKD3MH6A.js';
+export { persistActiveMemoryTranscript } from '../../../chunk-XO4SOZN6.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-GEEXBYFL.js';
 import '../../../chunk-KVNWIAO4.js';
 import '../../../chunk-FD2UT76F.js';
-import '../../../chunk-QARJGQSA.js';
+import '../../../chunk-HS7AVXTF.js';
 import '../../../chunk-RIAM53CP.js';
-import '../../../chunk-FKMUFNQE.js';
+import '../../../chunk-UMP6OJIM.js';
+import '../../../chunk-LWGSI6M3.js';
 import '../../../chunk-Q5EWJPRY.js';
-import '../../../chunk-VF7EWVDG.js';
-import '../../../chunk-IDCKSLYH.js';
-import '../../../chunk-T7XEKOVW.js';
-import '../../../chunk-T7O6K6PX.js';
+import '../../../chunk-2GUYQR5P.js';
+import '../../../chunk-ZZMZWBR6.js';
+import '../../../chunk-D4CUGAKZ.js';
+import '../../../chunk-XEQ3TM66.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map