@theokit/sdk 5.14.0 → 5.15.0

package/dist/{inject-session-J26SHHIO.js → inject-session-4ROYLZHY.js}

@@ -1,4 +1,4 @@
-import { enqueueSessionWrite } from './chunk-3ONIVO2I.js';
+import { enqueueSessionWrite } from './chunk-23SS4ID4.js';
 import { invalidateSessionCache } from './chunk-2XC6KDJM.js';
 import './chunk-AGO5S5WD.js';
 import { SessionTranscript } from './chunk-XESYJ4JC.js';
@@ -23,5 +23,5 @@ async function injectSessionTurn(opts) {
 }
 
 export { injectSessionTurn };
-//# sourceMappingURL=inject-session-J26SHHIO.js.map
-//# sourceMappingURL=inject-session-J26SHHIO.js.map
+//# sourceMappingURL=inject-session-4ROYLZHY.js.map
+//# sourceMappingURL=inject-session-4ROYLZHY.js.map

package/dist/{inject-session-J26SHHIO.js.map → inject-session-4ROYLZHY.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-J26SHHIO.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-4ROYLZHY.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-3ICZIJ2N.cjs → inject-session-AWKDCGHV.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkLXG6VL6R_cjs = require('./chunk-LXG6VL6R.cjs');
+var chunkU7PRI3XM_cjs = require('./chunk-U7PRI3XM.cjs');
 var chunkYJNYDJ2T_cjs = require('./chunk-YJNYDJ2T.cjs');
 require('./chunk-MSW7LB2V.cjs');
 var chunk3WKWBYPO_cjs = require('./chunk-3WKWBYPO.cjs');
@@ -10,7 +10,7 @@ require('./chunk-RNXXYF22.cjs');
 
 // src/internal/session/inject-session.ts
 async function injectSessionTurn(opts) {
-  await chunkLXG6VL6R_cjs.enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {
+  await chunkU7PRI3XM_cjs.enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {
     const prior = await opts.store.readRecords(opts.loc.agentId);
     const transcript = chunk3WKWBYPO_cjs.SessionTranscript.fromRecords(prior, {
       cwd: opts.loc.cwd,
@@ -25,5 +25,5 @@ async function injectSessionTurn(opts) {
 }
 
 exports.injectSessionTurn = injectSessionTurn;
-//# sourceMappingURL=inject-session-3ICZIJ2N.cjs.map
-//# sourceMappingURL=inject-session-3ICZIJ2N.cjs.map
+//# sourceMappingURL=inject-session-AWKDCGHV.cjs.map
+//# sourceMappingURL=inject-session-AWKDCGHV.cjs.map

package/dist/{inject-session-3ICZIJ2N.cjs.map → inject-session-AWKDCGHV.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-3ICZIJ2N.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-AWKDCGHV.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/agent-loop/doom-loop-tracker.d.ts

@@ -17,6 +17,9 @@ export interface DoomLoopVerdict {
 export interface DoomLoopConfig {
     softThreshold: number;
     hardThreshold: number;
+    /** Consecutive same-tool calls with CHANGING arguments but an unchanged result (argument churn).
+     *  Soft nudge at `churnThreshold - 2`, hard stop at `churnThreshold`. */
+    churnThreshold: number;
 }
 /** Public config on a send: `false` disables the guard; an object tunes the thresholds; absent = on. */
 export type DoomLoopOption = false | Partial<DoomLoopConfig>;

package/dist/internal/agent-loop/types.d.ts

@@ -3,6 +3,12 @@ import type { SDKMessage } from "../../types/messages.js";
 import type { RunStatus } from "../../types/run.js";
 /** SE7 — what a custom tool handler may return: a string or structured content blocks. */
 export type ToolHandlerResult = string | import("../../types/content-blocks.js").ToolResultContentBlock[];
+export interface SteerQueue {
+    /** Take every pending message. */
+    drain(): string[];
+    /** Like `drain`, but atomically refuses further pushes when nothing was pending. */
+    drainOrClose(): string[];
+}
 export interface AgentLoopOutput {
     events: SDKMessage[];
     finalStatus: RunStatus;

package/dist/internal/error-mappers/anthropic.d.ts

@@ -10,6 +10,9 @@
  *                                       mentions context length, else
  *                                       `"invalid_request"`; or
  *                                       `"content_filtered"` for policy.)
+ *   404     → `ConfigurationError`    (`code: "model_unavailable"` when the
+ *                                       body is a `not_found_error` naming a
+ *                                       model; other 404s stay `unknown`.)
  *   408     → `NetworkError`          (`code: "timeout"`)
  *   5xx     → `NetworkError`          (`code: "server_error"` — covers 529
  *                                       overloaded_error common at peak

package/dist/internal/error-mappers/openai-compatible.d.ts

@@ -8,9 +8,8 @@
  * Body inspection: looks at `body.error.code` / `body.error.type` to detect
  * `context_too_long`, `content_filtered`, `model_unavailable` semantics, and at
  * `body.error.message` for a 404 that says no endpoint serves the model
- * (OpenRouter's numeric-code body for a retired model id). A 400 and that 404
- * end their message with the provider's text, redacted and capped at 512
- * characters; every other status keeps the bare message.
+ * (OpenRouter's numeric-code body for a retired model id). Every message
+ * ends with the provider's text, redacted and capped at 512 characters.
  * Falls back to status-based mapping when body doesn't expose `.error`
  * (e.g., HTML server error page, DeepInfra's `{message: "..."}` shape).
  *

package/dist/internal/local-agent/local-agent-dispatch.d.ts

@@ -6,7 +6,7 @@
  */
 import type { AgentDefinition, AgentOptions, ModelSelection } from "../../types/agent.js";
 import type { Run, SDKUserMessage, SendOptions } from "../../types/run.js";
-import type { MemoryToolSpec } from "../agent-loop/types.js";
+import type { MemoryToolSpec, SteerQueue } from "../agent-loop/types.js";
 import type { PersonalityPreset } from "../personality/types.js";
 import type { PluginManager } from "../plugins/manager.js";
 import type { HooksExecutor } from "../runtime/hooks/hooks-executor.js";
@@ -34,6 +34,7 @@ export declare function buildRealRunOptions(args: {
     memoryTools: ReadonlyArray<MemoryToolSpec> | undefined;
     personalityToolWhitelist?: ReadonlyArray<string>;
     personalityName?: string;
+    steerQueue?: SteerQueue;
 }): Parameters<typeof createRealLocalRun>[0];
 export declare function createFixtureRunHelper(args: {
     inputs: DispatchInputs;
@@ -54,4 +55,5 @@ export declare function dispatchLocalRun(args: {
     }>;
     memoryTools: ReadonlyArray<MemoryToolSpec> | undefined;
     activePreset: PersonalityPreset | undefined;
+    steerQueue?: SteerQueue;
 }): Promise<Run>;

package/dist/internal/local-agent/send-queue.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Queue-mode state for `LocalAgent.send` (`SendOptions.queueMode`): the steer queue of the turn in
+ * flight and the pending collect batch.
+ *
+ * @internal
+ */
+import type { SteerQueue } from "../agent-loop/types.js";
+/** Steer queue of one turn. Refuses pushes once closed so a late message is never silently lost. */
+export declare class TurnSteerQueue implements SteerQueue {
+    private pending;
+    private closed;
+    /** @returns false when the turn can no longer pick the message up. */
+    push(text: string): boolean;
+    drain(): string[];
+    drainOrClose(): string[];
+    /** Stop accepting and hand back what no loop iteration picked up. */
+    closeAndTake(): string[];
+}
+/** The turn currently holding the send lock. */
+export interface ActiveTurn {
+    readonly steer: TurnSteerQueue;
+    readonly run: Promise<Run>;
+}
+/** Messages waiting to become one followup turn. */
+export interface CollectBatch {
+    readonly messages: Array<string | SDKUserMessage>;
+    readonly run: Promise<Run>;
+}
+/** Join a collected batch into the single message the batched turn sends. */
+export declare function joinCollected(messages: ReadonlyArray<string | SDKUserMessage>): string | SDKUserMessage;
+export declare function hasImages(message: string | SDKUserMessage): boolean;

package/dist/internal/mcp/client.d.ts

@@ -8,6 +8,8 @@ export interface McpToolCallResult {
 }
 export interface McpClient {
     readonly name: string;
+    /** `true` when the server's config sets `sequential`: the loop runs its calls one at a time. */
+    readonly sequential?: boolean;
     initialize(): Promise<void>;
     listTools(): Promise<McpTool[]>;
     callTool(name: string, args: Record<string, unknown>): Promise<McpToolCallResult>;

package/dist/internal/mcp/oauth-bearer.d.ts

@@ -0,0 +1,2 @@
+/** `Bearer <token>` for the server, obtained through the declared OAuth flow. */
+export declare function resolveBearer(serverName: string, auth: McpAuthConfig): Promise<string>;

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

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkCGH4BCIY_cjs = require('../../../chunk-CGH4BCIY.cjs');
+var chunkXE3CAY6Z_cjs = require('../../../chunk-XE3CAY6Z.cjs');
 var chunkGHX4P3V2_cjs = require('../../../chunk-GHX4P3V2.cjs');
-require('../../../chunk-NP362THY.cjs');
+require('../../../chunk-3F53FLQ7.cjs');
 require('../../../chunk-QOGNZMHD.cjs');
 require('../../../chunk-MUUQ2WFJ.cjs');
 require('../../../chunk-3KIUY67P.cjs');
@@ -17,7 +17,7 @@ require('../../../chunk-RNXXYF22.cjs');
 
 Object.defineProperty(exports, "createOpenAiCompatibleRuntime", {
   enumerable: true,
-  get: function () { return chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime; }
+  get: function () { return chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime; }
 });
 Object.defineProperty(exports, "LruEmbeddingCache", {
   enumerable: true,

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

@@ -1,6 +1,6 @@
-export { createOpenAiCompatibleRuntime } from '../../../chunk-H7G65PNI.js';
+export { createOpenAiCompatibleRuntime } from '../../../chunk-VCQ37TC5.js';
 export { LruEmbeddingCache, globalEmbeddingCache } from '../../../chunk-H73MEMQB.js';
-import '../../../chunk-ZJAYFSVI.js';
+import '../../../chunk-7ACS6P5Z.js';
 import '../../../chunk-24MGQDK3.js';
 import '../../../chunk-FD2UT76F.js';
 import '../../../chunk-PKRPV3R7.js';

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

@@ -1,9 +1,24 @@
 import type { EmbeddingRuntime } from "../embedding-adapter.js";
 import type { MemoryFact } from "../types.js";
+/**
+ * Dreaming/REM phase logic.
+ *
+ * Three phases:
+ *   - **light** — drop near-duplicate facts (cosine similarity > 0.95).
+ *   - **REM**  — cluster thematically related facts (cosine ≥ 0.75).
+ *   - **deep** — pick a representative bullet per cluster (longest text
+ *                wins) and emit consolidated markdown notes.
+ */
+export interface DedupResult {
+    kept: MemoryFact[];
+    duplicatesRemoved: number;
+}
+/** A group of semantically similar facts, with the text chosen to represent them. */
 export interface Cluster {
     representativeText: string;
     members: ReadonlyArray<MemoryFact>;
 }
+/** What clustering produced: the clusters and how many facts the per-sweep cap left out. */
 export interface ClusterResult {
     clusters: Cluster[];
     /** How many input facts past the per-sweep cap were not clustered; 0 when none were. */

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

@@ -1,3 +1,31 @@
+import type { EmbeddingRuntime } from "../embedding-adapter.js";
+import { type MemoryRoot } from "../storage/memory-root.js";
+/**
+ * Dreaming sweep orchestrator (ADR D7 of memory-system-peer-project-parity).
+ *
+ * Phases:
+ *   1. **light** — drop near-duplicate facts via cosine similarity.
+ *   2. **REM**  — cluster thematically related facts.
+ *   3. **deep** — write a `notes/dreamed-<ts>.md` per sweep with consolidated
+ *                  clusters; append a diary entry.
+ *
+ * All file writes go through `replaceFileAtomic` (EC-3) and the entire sweep
+ * holds the per-cwd mutex so a `Remember:` append can't race it.
+ */
+export interface DreamingOptions {
+    cwd: string;
+    /**
+     * The memory root to sweep. Defaults to the project store — right for a caller with no
+     * `memory.directory`, and wrong for one that has it, which is why it is passable (#463).
+     */
+    memoryRoot?: MemoryRoot;
+    embedding: EmbeddingRuntime;
+    dedupThreshold?: number;
+    clusterThreshold?: number;
+    /** Test hook — fixed timestamp for the run. */
+    now?: () => number;
+}
+/** Outcome of one dreaming sweep: counts before and after, and the note written. */
 export interface DreamingResult {
     status: "ok" | "skipped" | "error";
     factsBefore: number;
@@ -12,4 +40,5 @@ export interface DreamingResult {
      */
     factsLeftOut?: number;
 }
+/** Run one dreaming sweep (dedupe, cluster, write a consolidated note), serialised per `cwd`. */
 export declare function runDreamingSweep(options: DreamingOptions): Promise<DreamingResult>;

package/dist/internal/memory/sdk-memory-peer-loader.d.ts

@@ -34,6 +34,8 @@ export interface SdkMemoryModule {
     /** Mirrors @theokit/sdk-memory's runDreamingSweep entrypoint. */
     runDreamingSweep(opts: {
         cwd: string;
+        /** The resolved memory root: facts, notes and diary live here (B-442). Absent means `<cwd>/.theokit/memory`. */
+        memoryRoot?: string;
         embedding: any;
         dedupThreshold?: number;
         clusterThreshold?: number;

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

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk6CXRYPG7_cjs = require('../../../chunk-6CXRYPG7.cjs');
+var chunkCHKV2L2Y_cjs = require('../../../chunk-CHKV2L2Y.cjs');
 var chunkRS7YQR4X_cjs = require('../../../chunk-RS7YQR4X.cjs');
-var chunkSDZ4XDWS_cjs = require('../../../chunk-SDZ4XDWS.cjs');
+var chunkVWYFGE27_cjs = require('../../../chunk-VWYFGE27.cjs');
 require('../../../chunk-KRD3GQAA.cjs');
 require('../../../chunk-MUUQ2WFJ.cjs');
 require('../../../chunk-SWALPLFQ.cjs');
@@ -10,8 +10,8 @@ require('../../../chunk-3KIUY67P.cjs');
 require('../../../chunk-SA6K24NB.cjs');
 require('../../../chunk-3WKWBYPO.cjs');
 require('../../../chunk-AT2PESXB.cjs');
-require('../../../chunk-G7XBVM3T.cjs');
-require('../../../chunk-ZF2LDKQQ.cjs');
+require('../../../chunk-MHUOVS5I.cjs');
+require('../../../chunk-U3DW3WDE.cjs');
 require('../../../chunk-ZOFRNNZD.cjs');
 require('../../../chunk-CEGU5AVD.cjs');
 require('../../../chunk-RNXXYF22.cjs');
@@ -20,23 +20,39 @@ require('../../../chunk-RNXXYF22.cjs');
 
 Object.defineProperty(exports, "appendDiaryEntry", {
   enumerable: true,
-  get: function () { return chunk6CXRYPG7_cjs.appendDiaryEntry; }
+  get: function () { return chunkCHKV2L2Y_cjs.appendDiaryEntry; }
+});
+Object.defineProperty(exports, "deepPhase", {
+  enumerable: true,
+  get: function () { return chunkCHKV2L2Y_cjs.deepPhase; }
 });
 Object.defineProperty(exports, "diaryPath", {
   enumerable: true,
-  get: function () { return chunk6CXRYPG7_cjs.diaryPath; }
+  get: function () { return chunkCHKV2L2Y_cjs.diaryPath; }
 });
 Object.defineProperty(exports, "entryHash", {
   enumerable: true,
-  get: function () { return chunk6CXRYPG7_cjs.entryHash; }
+  get: function () { return chunkCHKV2L2Y_cjs.entryHash; }
+});
+Object.defineProperty(exports, "lightPhase", {
+  enumerable: true,
+  get: function () { return chunkCHKV2L2Y_cjs.lightPhase; }
 });
 Object.defineProperty(exports, "readAllSqliteFacts", {
   enumerable: true,
-  get: function () { return chunk6CXRYPG7_cjs.readAllSqliteFacts; }
+  get: function () { return chunkCHKV2L2Y_cjs.readAllSqliteFacts; }
+});
+Object.defineProperty(exports, "remPhase", {
+  enumerable: true,
+  get: function () { return chunkCHKV2L2Y_cjs.remPhase; }
 });
 Object.defineProperty(exports, "renderDiaryEntry", {
   enumerable: true,
-  get: function () { return chunk6CXRYPG7_cjs.renderDiaryEntry; }
+  get: function () { return chunkCHKV2L2Y_cjs.renderDiaryEntry; }
+});
+Object.defineProperty(exports, "runDreamingSweep", {
+  enumerable: true,
+  get: function () { return chunkCHKV2L2Y_cjs.runDreamingSweep; }
 });
 Object.defineProperty(exports, "persistActiveMemoryTranscript", {
   enumerable: true,
@@ -44,107 +60,107 @@ Object.defineProperty(exports, "persistActiveMemoryTranscript", {
 });
 Object.defineProperty(exports, "MEMORY_INDEX_MAX_BYTES", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.MEMORY_INDEX_MAX_BYTES; }
+  get: function () { return chunkVWYFGE27_cjs.MEMORY_INDEX_MAX_BYTES; }
 });
 Object.defineProperty(exports, "MEMORY_INDEX_MAX_LINES", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.MEMORY_INDEX_MAX_LINES; }
+  get: function () { return chunkVWYFGE27_cjs.MEMORY_INDEX_MAX_LINES; }
 });
 Object.defineProperty(exports, "appendFact", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.appendFact; }
+  get: function () { return chunkVWYFGE27_cjs.appendFact; }
 });
 Object.defineProperty(exports, "appendFactToMarkdown", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.appendFactToMarkdown; }
+  get: function () { return chunkVWYFGE27_cjs.appendFactToMarkdown; }
 });
 Object.defineProperty(exports, "asMemoryRoot", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.asMemoryRoot; }
+  get: function () { return chunkVWYFGE27_cjs.asMemoryRoot; }
 });
 Object.defineProperty(exports, "ceilingReachedError", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.ceilingReachedError; }
+  get: function () { return chunkVWYFGE27_cjs.ceilingReachedError; }
 });
 Object.defineProperty(exports, "claudeProjectMemoryDir", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.claudeProjectMemoryDir; }
+  get: function () { return chunkVWYFGE27_cjs.claudeProjectMemoryDir; }
 });
 Object.defineProperty(exports, "collectMarkdownFiles", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.collectMarkdownFiles; }
+  get: function () { return chunkVWYFGE27_cjs.collectMarkdownFiles; }
 });
 Object.defineProperty(exports, "defaultIndexPath", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.defaultIndexPath; }
+  get: function () { return chunkVWYFGE27_cjs.defaultIndexPath; }
 });
 Object.defineProperty(exports, "discoverSessionFiles", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.discoverSessionFiles; }
+  get: function () { return chunkVWYFGE27_cjs.discoverSessionFiles; }
 });
 Object.defineProperty(exports, "discoverWikiFiles", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.discoverWikiFiles; }
+  get: function () { return chunkVWYFGE27_cjs.discoverWikiFiles; }
 });
 Object.defineProperty(exports, "indexBudgetWarning", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.indexBudgetWarning; }
+  get: function () { return chunkVWYFGE27_cjs.indexBudgetWarning; }
 });
 Object.defineProperty(exports, "lanceStoragePath", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.lanceStoragePath; }
+  get: function () { return chunkVWYFGE27_cjs.lanceStoragePath; }
 });
 Object.defineProperty(exports, "memoryIndexRoot", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.memoryIndexRoot; }
+  get: function () { return chunkVWYFGE27_cjs.memoryIndexRoot; }
 });
 Object.defineProperty(exports, "memoryMdPath", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.memoryMdPath; }
+  get: function () { return chunkVWYFGE27_cjs.memoryMdPath; }
 });
 Object.defineProperty(exports, "memoryReadRoots", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.memoryReadRoots; }
+  get: function () { return chunkVWYFGE27_cjs.memoryReadRoots; }
 });
 Object.defineProperty(exports, "notesDir", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.notesDir; }
+  get: function () { return chunkVWYFGE27_cjs.notesDir; }
 });
 Object.defineProperty(exports, "projectMemoryDir", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.projectMemoryDir; }
+  get: function () { return chunkVWYFGE27_cjs.projectMemoryDir; }
 });
 Object.defineProperty(exports, "readFacts", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.readFacts; }
+  get: function () { return chunkVWYFGE27_cjs.readFacts; }
 });
 Object.defineProperty(exports, "readFactsFromMarkdown", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.readFactsFromMarkdown; }
+  get: function () { return chunkVWYFGE27_cjs.readFactsFromMarkdown; }
 });
 Object.defineProperty(exports, "resolveMaxFacts", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.resolveMaxFacts; }
+  get: function () { return chunkVWYFGE27_cjs.resolveMaxFacts; }
 });
 Object.defineProperty(exports, "resolveMemoryRoot", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.resolveMemoryRoot; }
+  get: function () { return chunkVWYFGE27_cjs.resolveMemoryRoot; }
 });
 Object.defineProperty(exports, "sessionSummaryPath", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.sessionSummaryPath; }
+  get: function () { return chunkVWYFGE27_cjs.sessionSummaryPath; }
 });
 Object.defineProperty(exports, "sessionsDir", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.sessionsDir; }
+  get: function () { return chunkVWYFGE27_cjs.sessionsDir; }
 });
 Object.defineProperty(exports, "wikiDir", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.wikiDir; }
+  get: function () { return chunkVWYFGE27_cjs.wikiDir; }
 });
 Object.defineProperty(exports, "writeSessionSummary", {
   enumerable: true,
-  get: function () { return chunkSDZ4XDWS_cjs.writeSessionSummary; }
+  get: function () { return chunkVWYFGE27_cjs.writeSessionSummary; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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

@@ -16,6 +16,8 @@
  * `package.json` `exports`, so the names below must survive into the published declarations.
  */
 export { appendDiaryEntry, type DiaryEntry, diaryPath, entryHash, renderDiaryEntry, } from "../dreaming/diary.js";
+export { type Cluster, type ClusterResult, type DedupResult, deepPhase, lightPhase, remPhase, } from "../dreaming/phases.js";
+export { type DreamingOptions, type DreamingResult, runDreamingSweep, } from "../dreaming/run.js";
 export { defaultIndexPath } from "../index-db.js";
 export { collectMarkdownFiles, type DiscoveredFile } from "../index-manager-helpers.js";
 export { lanceStoragePath } from "../lance-index.js";

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

@@ -16,6 +16,8 @@
  * `package.json` `exports`, so the names below must survive into the published declarations.
  */
 export { appendDiaryEntry, type DiaryEntry, diaryPath, entryHash, renderDiaryEntry, } from "../dreaming/diary.js";
+export { type Cluster, type ClusterResult, type DedupResult, deepPhase, lightPhase, remPhase, } from "../dreaming/phases.js";
+export { type DreamingOptions, type DreamingResult, runDreamingSweep, } from "../dreaming/run.js";
 export { defaultIndexPath } from "../index-db.js";
 export { collectMarkdownFiles, type DiscoveredFile } from "../index-manager-helpers.js";
 export { lanceStoragePath } from "../lance-index.js";

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

@@ -1,6 +1,6 @@
-export { appendDiaryEntry, diaryPath, entryHash, readAllSqliteFacts, renderDiaryEntry } from '../../../chunk-MSEL5E5P.js';
+export { appendDiaryEntry, deepPhase, diaryPath, entryHash, lightPhase, readAllSqliteFacts, remPhase, renderDiaryEntry, runDreamingSweep } from '../../../chunk-INVEGVGO.js';
 export { persistActiveMemoryTranscript } from '../../../chunk-QK2ERTO3.js';
-export { MEMORY_INDEX_MAX_BYTES, MEMORY_INDEX_MAX_LINES, appendFact, appendFactToMarkdown, asMemoryRoot, ceilingReachedError, claudeProjectMemoryDir, collectMarkdownFiles, defaultIndexPath, discoverSessionFiles, discoverWikiFiles, indexBudgetWarning, lanceStoragePath, memoryIndexRoot, memoryMdPath, memoryReadRoots, notesDir, projectMemoryDir, readFacts, readFactsFromMarkdown, resolveMaxFacts, resolveMemoryRoot, sessionSummaryPath, sessionsDir, wikiDir, writeSessionSummary } from '../../../chunk-DF77RBF4.js';
+export { MEMORY_INDEX_MAX_BYTES, MEMORY_INDEX_MAX_LINES, appendFact, appendFactToMarkdown, asMemoryRoot, ceilingReachedError, claudeProjectMemoryDir, collectMarkdownFiles, defaultIndexPath, discoverSessionFiles, discoverWikiFiles, indexBudgetWarning, lanceStoragePath, memoryIndexRoot, memoryMdPath, memoryReadRoots, notesDir, projectMemoryDir, readFacts, readFactsFromMarkdown, resolveMaxFacts, resolveMemoryRoot, sessionSummaryPath, sessionsDir, wikiDir, writeSessionSummary } from '../../../chunk-LCCT5ZXJ.js';
 import '../../../chunk-KVNWIAO4.js';
 import '../../../chunk-FD2UT76F.js';
 import '../../../chunk-4QCJAJAG.js';
@@ -8,8 +8,8 @@ import '../../../chunk-PKRPV3R7.js';
 import '../../../chunk-UKMBRMGT.js';
 import '../../../chunk-XESYJ4JC.js';
 import '../../../chunk-MLJDW2YK.js';
-import '../../../chunk-354F3OF5.js';
-import '../../../chunk-Q5EWJPRY.js';
+import '../../../chunk-FGGVSHDW.js';
+import '../../../chunk-PPU2D4FZ.js';
 import '../../../chunk-M4U24U6G.js';
 import '../../../chunk-TNFOU6SB.js';
 import '../../../chunk-3OY6H3I7.js';

package/dist/internal/persistence/cwd-mutex.d.cts

@@ -26,10 +26,12 @@
  * `@theokit/sdk` rather than reimplementing it, precisely so the Map is the same one: a per-package
  * copy would give each package its own queue and let their writes race.
  *
- * The Map is module-scoped, so nothing survives a process restart or a fresh module instance, and
- * its entries are never removed — pass keys from a bounded set rather than from arbitrary input.
+ * The Map is module-scoped, so nothing survives a process restart or a fresh module instance.
+ * An entry is dropped as soon as its key has no call pending.
  * Signature and semantics will not change before sdk-core v3.0.
  *
  * @public
  */
 export declare function withCwdMutex<T>(key: string, fn: () => Promise<T>): Promise<T>;
+/** Number of keys with a call pending. Test-only observation of the queue map. */
+export declare function pendingCwdMutexKeyCount(): number;

package/dist/internal/persistence/cwd-mutex.d.ts

@@ -26,10 +26,12 @@
  * `@theokit/sdk` rather than reimplementing it, precisely so the Map is the same one: a per-package
  * copy would give each package its own queue and let their writes race.
  *
- * The Map is module-scoped, so nothing survives a process restart or a fresh module instance, and
- * its entries are never removed — pass keys from a bounded set rather than from arbitrary input.
+ * The Map is module-scoped, so nothing survives a process restart or a fresh module instance.
+ * An entry is dropped as soon as its key has no call pending.
  * Signature and semantics will not change before sdk-core v3.0.
  *
  * @public
  */
 export declare function withCwdMutex<T>(key: string, fn: () => Promise<T>): Promise<T>;
+/** Number of keys with a call pending. Test-only observation of the queue map. */
+export declare function pendingCwdMutexKeyCount(): number;

package/dist/internal/persistence/index.cjs

@@ -5,8 +5,8 @@ var chunk3HA7N2BB_cjs = require('../../chunk-3HA7N2BB.cjs');
 var chunkA4RAL2ER_cjs = require('../../chunk-A4RAL2ER.cjs');
 var chunkAT2PESXB_cjs = require('../../chunk-AT2PESXB.cjs');
 var chunkPOBZXULR_cjs = require('../../chunk-POBZXULR.cjs');
-var chunkG7XBVM3T_cjs = require('../../chunk-G7XBVM3T.cjs');
-var chunkZF2LDKQQ_cjs = require('../../chunk-ZF2LDKQQ.cjs');
+var chunkMHUOVS5I_cjs = require('../../chunk-MHUOVS5I.cjs');
+var chunkU3DW3WDE_cjs = require('../../chunk-U3DW3WDE.cjs');
 var chunkZOFRNNZD_cjs = require('../../chunk-ZOFRNNZD.cjs');
 var chunkYQ3XC6C2_cjs = require('../../chunk-YQ3XC6C2.cjs');
 require('../../chunk-CEGU5AVD.cjs');
@@ -92,11 +92,11 @@ Object.defineProperty(exports, "readJsonlIds", {
 });
 Object.defineProperty(exports, "withFileLock", {
   enumerable: true,
-  get: function () { return chunkG7XBVM3T_cjs.withFileLock; }
+  get: function () { return chunkMHUOVS5I_cjs.withFileLock; }
 });
 Object.defineProperty(exports, "withCwdMutex", {
   enumerable: true,
-  get: function () { return chunkZF2LDKQQ_cjs.withCwdMutex; }
+  get: function () { return chunkU3DW3WDE_cjs.withCwdMutex; }
 });
 Object.defineProperty(exports, "atomicWriteJson", {
   enumerable: true,

package/dist/internal/persistence/index.js

@@ -3,8 +3,8 @@ export { migrateSchema, readVersionedJson, writeVersionedJson } from '../../chun
 export { containsCjk, sanitizeFts5Query } from '../../chunk-WE22OXQA.js';
 export { applyWalWithFallback, isCorruptionError, openSqliteResilient } from '../../chunk-MLJDW2YK.js';
 export { JsonlParseError, appendJsonl, loadJsonl, readJsonlIds } from '../../chunk-KU5O7WPK.js';
-export { withFileLock } from '../../chunk-354F3OF5.js';
-export { withCwdMutex } from '../../chunk-Q5EWJPRY.js';
+export { withFileLock } from '../../chunk-FGGVSHDW.js';
+export { withCwdMutex } from '../../chunk-PPU2D4FZ.js';
 export { atomicWriteJson, atomicWriteText, replaceFileAtomic } from '../../chunk-M4U24U6G.js';
 export { displayTheokitHome, getProfilesRoot, getTheokitHome } from '../../chunk-YMVTUV5K.js';
 import '../../chunk-TNFOU6SB.js';

package/dist/internal/persistence/sqlite-session-store.d.cts

@@ -0,0 +1,25 @@
+import type { SessionRecord, SessionStore } from "../../types/session-store.js";
+/** Options for {@link SqliteSessionStore}. */
+export interface SqliteSessionStoreOptions {
+    /** Absolute path of the SQLite file. Parent directories are created. */
+    filePath: string;
+}
+/**
+ * A {@link SessionStore} that keeps the native session records in one SQLite file instead of
+ * per-agent JSONL transcripts. Pass it as `local.sessionStore`.
+ *
+ * Uses `better-sqlite3` when installed, else the built-in `node:sqlite` (Node 22.5+).
+ * Appends are one transaction, so a batch lands whole or not at all; order is the
+ * autoincrement `seq`. Corruption is NOT silently rebuilt: opening a corrupt file throws.
+ *
+ * @public
+ */
+export declare class SqliteSessionStore implements SessionStore {
+    private readonly filePath;
+    private dbPromise;
+    constructor(options: SqliteSessionStoreOptions);
+    private db;
+    readRecords(agentId: string): Promise<SessionRecord[]>;
+    appendRecords(agentId: string, records: readonly SessionRecord[]): Promise<void>;
+    dispose(): Promise<void>;
+}