@theokit/sdk 4.58.0 → 4.60.0

package/dist/internal/memory/storage/chunk-markdown.d.cts

@@ -0,0 +1,2 @@
+import type { MemoryChunk } from "../types.js";
+export declare function chunkMarkdown(text: string, options?: ChunkMarkdownOptions): MemoryChunk[];

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

@@ -0,0 +1,54 @@
+'use strict';
+
+var chunkNY25NBZB_cjs = require('../../../chunk-NY25NBZB.cjs');
+require('../../../chunk-KRD3GQAA.cjs');
+require('../../../chunk-MUUQ2WFJ.cjs');
+require('../../../chunk-R3UPQFKK.cjs');
+require('../../../chunk-VKJ7V7EB.cjs');
+require('../../../chunk-BUIK7GUA.cjs');
+require('../../../chunk-ZF2LDKQQ.cjs');
+require('../../../chunk-I6TGFUCO.cjs');
+require('../../../chunk-K3FW2XZD.cjs');
+require('../../../chunk-JTB5Q42C.cjs');
+require('../../../chunk-NUKRL3I6.cjs');
+
+
+
+Object.defineProperty(exports, "appendFact", {
+  enumerable: true,
+  get: function () { return chunkNY25NBZB_cjs.appendFact; }
+});
+Object.defineProperty(exports, "appendFactToMarkdown", {
+  enumerable: true,
+  get: function () { return chunkNY25NBZB_cjs.appendFactToMarkdown; }
+});
+Object.defineProperty(exports, "claudeProjectMemoryDir", {
+  enumerable: true,
+  get: function () { return chunkNY25NBZB_cjs.claudeProjectMemoryDir; }
+});
+Object.defineProperty(exports, "memoryDir", {
+  enumerable: true,
+  get: function () { return chunkNY25NBZB_cjs.memoryDir; }
+});
+Object.defineProperty(exports, "memoryMdPath", {
+  enumerable: true,
+  get: function () { return chunkNY25NBZB_cjs.memoryMdPath; }
+});
+Object.defineProperty(exports, "memoryWriteDir", {
+  enumerable: true,
+  get: function () { return chunkNY25NBZB_cjs.memoryWriteDir; }
+});
+Object.defineProperty(exports, "notesDir", {
+  enumerable: true,
+  get: function () { return chunkNY25NBZB_cjs.notesDir; }
+});
+Object.defineProperty(exports, "readFacts", {
+  enumerable: true,
+  get: function () { return chunkNY25NBZB_cjs.readFacts; }
+});
+Object.defineProperty(exports, "readFactsFromMarkdown", {
+  enumerable: true,
+  get: function () { return chunkNY25NBZB_cjs.readFactsFromMarkdown; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

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

@@ -0,0 +1,18 @@
+/**
+ * #430 — the ONE markdown memory store, shared with `@theokit/sdk-memory`.
+ *
+ * The satellite carried a full copy, and `Memory.runDreamingSweep` REPLACES this one with the
+ * peer's whenever the peer is installed — so the copy that ran was not the copy most people read.
+ * The copy stayed on the pre-#389 layout (bullets under `MEMORY.md ## Facts`) while this one moved
+ * to a file per memory, which meant installing `@theokit/sdk-memory` made every memory the SDK had
+ * written unreadable. It reported `factsBefore: 0`, indistinguishable from an empty store.
+ *
+ * This is the same defect theokit#160 fixed for the embedding runtime, in the same package pair,
+ * with the same remedy: one implementation, imported by both. A second copy is a second place for
+ * the layout to drift, and the drift is silent by construction — nothing fails, facts just stop
+ * being found.
+ *
+ * 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";

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

@@ -0,0 +1,18 @@
+/**
+ * #430 — the ONE markdown memory store, shared with `@theokit/sdk-memory`.
+ *
+ * The satellite carried a full copy, and `Memory.runDreamingSweep` REPLACES this one with the
+ * peer's whenever the peer is installed — so the copy that ran was not the copy most people read.
+ * The copy stayed on the pre-#389 layout (bullets under `MEMORY.md ## Facts`) while this one moved
+ * to a file per memory, which meant installing `@theokit/sdk-memory` made every memory the SDK had
+ * written unreadable. It reported `factsBefore: 0`, indistinguishable from an empty store.
+ *
+ * This is the same defect theokit#160 fixed for the embedding runtime, in the same package pair,
+ * with the same remedy: one implementation, imported by both. A second copy is a second place for
+ * the layout to drift, and the drift is silent by construction — nothing fails, facts just stop
+ * being found.
+ *
+ * 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";

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

@@ -0,0 +1,13 @@
+export { appendFact, appendFactToMarkdown, claudeProjectMemoryDir, memoryDir, memoryMdPath, memoryWriteDir, notesDir, readFacts, readFactsFromMarkdown } from '../../../chunk-JVERBPRD.js';
+import '../../../chunk-KVNWIAO4.js';
+import '../../../chunk-FD2UT76F.js';
+import '../../../chunk-QARJGQSA.js';
+import '../../../chunk-RIAM53CP.js';
+import '../../../chunk-FKMUFNQE.js';
+import '../../../chunk-Q5EWJPRY.js';
+import '../../../chunk-VF7EWVDG.js';
+import '../../../chunk-IDCKSLYH.js';
+import '../../../chunk-T7XEKOVW.js';
+import '../../../chunk-T7O6K6PX.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/internal/memory/storage/markdown-store.d.cts

@@ -0,0 +1,77 @@
+import { type MemoryConfig, type MemoryFact } from "../types.js";
+/**
+ * The memory root for a workspace: `<cwd>/.theokit/memory`. Every other path here derives from it,
+ * and `memory_get` refuses to read outside it. Pure path computation — nothing is created on disk.
+ */
+export declare function memoryDir(cwd: string): string;
+/**
+ * Where a NEW fact should be written.
+ *
+ * `.theokit/memory` by default, exactly as before. When the agent was given a `local.sessionDir`,
+ * it becomes `<sessionDir>/projects/<encoded-cwd>/memory` — the same place the transcript for that
+ * project goes, so a session and the memories recorded during it land beside each other.
+ *
+ * `local.sessionDir` is the switch because it is already the option this project documents for CLI
+ * interop: point it at `~/.claude` and the CLI can `--continue` a session this agent wrote. Someone
+ * who set it has said they share state with that CLI, and memory following is what the sentence
+ * already implied. It needs no new option, and nothing moves for anyone who never set it.
+ *
+ * Safe because of the rule this pairs with — WRITE ONE, READ ALL. {@link readFactsFromMarkdown}
+ * covers every location, so a consumer whose new facts move keeps every fact they already had. The
+ * change relocates where the next one lands; it orphans nothing.
+ */
+export declare function memoryWriteDir(cwd: string, sessionDir: string | undefined): string;
+/**
+ * Where the Claude Code CLI keeps THIS project's memories.
+ *
+ * `<claudeHome>/projects/<encoded-cwd>/memory` — the same `encodeProjectDir` scheme the transcripts
+ * already use, which is why no new encoding is invented here. `CLAUDE_CONFIG_DIR` names the home
+ * when set (the CLI's own variable); `~/.claude` otherwise.
+ *
+ * Read, never written. Writing here by default would relocate every existing consumer's memories,
+ * and an additive change must not move what is already on disk — so this is the direction that
+ * costs nothing: a memory the CLI wrote becomes visible, and a memory the SDK wrote stays where the
+ * SDK put it.
+ */
+export declare function claudeProjectMemoryDir(cwd: string): string;
+/**
+ * Path to `MEMORY.md`, the index that points at the per-memory files — and, in stores written before
+ * #389, the flat `## Facts` list itself. Pure path computation; the file may not exist.
+ */
+export declare function memoryMdPath(cwd: string): string;
+/**
+ * Path to `<memory root>/notes`, where per-topic notes and the consolidated notes a dreaming sweep
+ * writes live. Pure path computation — the directory may not exist.
+ */
+export declare function notesDir(cwd: string): string;
+/**
+ * Every memory in the store: the per-memory files, plus any legacy `## Facts` bullets still in
+ * `MEMORY.md`. Returns `[]` when the directory does not exist.
+ *
+ * Reading both is not transitional politeness. Those bullets are already on disk in consumers'
+ * repositories, and the store's own header invites editing them by hand — a converged writer that
+ * stopped reading them would delete what someone recorded, which is worse than the format it fixes.
+ */
+export declare function readFactsFromMarkdown(cwd: string, sessionDir?: string): Promise<MemoryFact[]>;
+/**
+ * Write a fact as its own memory file and point the `MEMORY.md` index at it. Atomic + serialized.
+ *
+ * `modified` is stamped HERE and never read from `fact`: a timestamp a caller can set is a
+ * timestamp that can lie about when something was learned, and weighing recency is the point.
+ */
+export declare function appendFactToMarkdown(cwd: string, fact: MemoryFact, targetDir?: string): Promise<void>;
+/**
+ * Every memory in the store, honouring the `enabled` gate on {@link MemoryConfig}: when memory is
+ * disabled the call resolves to `[]` without touching disk. Configuration-aware entry point;
+ * {@link readFactsFromMarkdown} is the same read without the gate.
+ */
+export declare function readFacts(cwd: string, config: MemoryConfig, memoryHome?: string): Promise<MemoryFact[]>;
+/**
+ * Record a fact, honouring the `enabled` gate on {@link MemoryConfig}: when memory is disabled the
+ * call resolves without touching disk. Configuration-aware entry point;
+ * {@link appendFactToMarkdown} is the same write without the gate.
+ *
+ * `memoryHome` is the agent's `local.sessionDir` when it has one — see {@link memoryWriteDir} for
+ * which store that sends the fact to.
+ */
+export declare function appendFact(cwd: string, config: MemoryConfig, fact: MemoryFact, memoryHome?: string): Promise<void>;

package/dist/internal/memory/storage/markdown-store.d.ts

@@ -1,5 +1,26 @@
 import { type MemoryConfig, type MemoryFact } from "../types.js";
+/**
+ * The memory root for a workspace: `<cwd>/.theokit/memory`. Every other path here derives from it,
+ * and `memory_get` refuses to read outside it. Pure path computation — nothing is created on disk.
+ */
 export declare function memoryDir(cwd: string): string;
+/**
+ * Where a NEW fact should be written.
+ *
+ * `.theokit/memory` by default, exactly as before. When the agent was given a `local.sessionDir`,
+ * it becomes `<sessionDir>/projects/<encoded-cwd>/memory` — the same place the transcript for that
+ * project goes, so a session and the memories recorded during it land beside each other.
+ *
+ * `local.sessionDir` is the switch because it is already the option this project documents for CLI
+ * interop: point it at `~/.claude` and the CLI can `--continue` a session this agent wrote. Someone
+ * who set it has said they share state with that CLI, and memory following is what the sentence
+ * already implied. It needs no new option, and nothing moves for anyone who never set it.
+ *
+ * Safe because of the rule this pairs with — WRITE ONE, READ ALL. {@link readFactsFromMarkdown}
+ * covers every location, so a consumer whose new facts move keeps every fact they already had. The
+ * change relocates where the next one lands; it orphans nothing.
+ */
+export declare function memoryWriteDir(cwd: string, sessionDir: string | undefined): string;
 /**
  * Where the Claude Code CLI keeps THIS project's memories.
  *
@@ -13,7 +34,15 @@ export declare function memoryDir(cwd: string): string;
  * SDK put it.
  */
 export declare function claudeProjectMemoryDir(cwd: string): string;
+/**
+ * Path to `MEMORY.md`, the index that points at the per-memory files — and, in stores written before
+ * #389, the flat `## Facts` list itself. Pure path computation; the file may not exist.
+ */
 export declare function memoryMdPath(cwd: string): string;
+/**
+ * Path to `<memory root>/notes`, where per-topic notes and the consolidated notes a dreaming sweep
+ * writes live. Pure path computation — the directory may not exist.
+ */
 export declare function notesDir(cwd: string): string;
 /**
  * Every memory in the store: the per-memory files, plus any legacy `## Facts` bullets still in
@@ -23,14 +52,26 @@ export declare function notesDir(cwd: string): string;
  * repositories, and the store's own header invites editing them by hand — a converged writer that
  * stopped reading them would delete what someone recorded, which is worse than the format it fixes.
  */
-export declare function readFactsFromMarkdown(cwd: string): Promise<MemoryFact[]>;
+export declare function readFactsFromMarkdown(cwd: string, sessionDir?: string): Promise<MemoryFact[]>;
 /**
  * Write a fact as its own memory file and point the `MEMORY.md` index at it. Atomic + serialized.
  *
  * `modified` is stamped HERE and never read from `fact`: a timestamp a caller can set is a
  * timestamp that can lie about when something was learned, and weighing recency is the point.
  */
-export declare function appendFactToMarkdown(cwd: string, fact: MemoryFact): Promise<void>;
-/** Configuration-aware accessors honoring the existing MemoryConfig contract. */
-export declare function readFacts(cwd: string, config: MemoryConfig): Promise<MemoryFact[]>;
-export declare function appendFact(cwd: string, config: MemoryConfig, fact: MemoryFact): Promise<void>;
+export declare function appendFactToMarkdown(cwd: string, fact: MemoryFact, targetDir?: string): Promise<void>;
+/**
+ * Every memory in the store, honouring the `enabled` gate on {@link MemoryConfig}: when memory is
+ * disabled the call resolves to `[]` without touching disk. Configuration-aware entry point;
+ * {@link readFactsFromMarkdown} is the same read without the gate.
+ */
+export declare function readFacts(cwd: string, config: MemoryConfig, memoryHome?: string): Promise<MemoryFact[]>;
+/**
+ * Record a fact, honouring the `enabled` gate on {@link MemoryConfig}: when memory is disabled the
+ * call resolves without touching disk. Configuration-aware entry point;
+ * {@link appendFactToMarkdown} is the same write without the gate.
+ *
+ * `memoryHome` is the agent's `local.sessionDir` when it has one — see {@link memoryWriteDir} for
+ * which store that sends the fact to.
+ */
+export declare function appendFact(cwd: string, config: MemoryConfig, fact: MemoryFact, memoryHome?: string): Promise<void>;

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

@@ -0,0 +1,54 @@
+/**
+ * One memory as a file, in the shape the Claude Code CLI reads.
+ *
+ * `@theokit/sdk` already writes native Claude Code `.jsonl` sessions — the README's differentiator
+ * is "point `local.sessionDir` at `~/.claude` and the Claude Code CLI can `--continue` a session
+ * your agent wrote". Memory had no such convergence: a fact was a bullet under `## Facts` with its
+ * kind in an HTML comment (#389), which that CLI reads as prose. Pointing a memory directory at
+ * `~/.claude/projects/<project>/memory/` produced nothing it could open.
+ *
+ * The contract here was measured against a real store rather than inferred from documentation. Of
+ * nine files, all nine carry `name`, `description` and `metadata.type`; six also carry
+ * `node_type`, `originSessionId` and `modified`, which the runtime stamps on write. So the minimum
+ * a reader must accept is the first three — refusing the rest would refuse memories the CLI itself
+ * accepts.
+ *
+ * `originSessionId` is deliberately not written. It identifies the session that learned the fact,
+ * and the append path has no session in scope; inventing one would be worse than omitting a field
+ * the format already treats as optional.
+ *
+ * @internal
+ */
+import { type MemoryKind } from "../types.js";
+/** The fields one memory file carries. */
+export interface MemoryFileFields {
+    /** Slug, and the file's basename. */
+    readonly name: string;
+    /** One-line summary — what the index shows and what recall ranks. */
+    readonly description: string;
+    /** `metadata.type`, absent when the file does not declare one this contract admits. */
+    readonly kind?: MemoryKind;
+    /** `metadata.modified`, an ISO 8601 instant stamped by whoever wrote the file. */
+    readonly modified?: string;
+    /** The markdown after the frontmatter. */
+    readonly body: string;
+}
+/**
+ * A readable, filesystem-safe slug for `text`.
+ *
+ * Readability is the goal — a directory of `h-3f2a…` files is a directory nobody browses — but it
+ * is not the floor. The text comes from whatever a caller learned, so anything that fails the safe
+ * grammar falls back to {@link safeFilenameForId}, which is total and always yields a valid
+ * component.
+ */
+export declare function slugForFact(text: string): string;
+/** Render one memory file. `description` is quoted so a colon in the text cannot break the block. */
+export declare function renderMemoryFile(fields: MemoryFileFields): string;
+/**
+ * Read one memory file, or `undefined` when the content is not one.
+ *
+ * `undefined` rather than a throw, and rather than a best-effort object: the directory holds
+ * hand-written notes and a `MEMORY.md` index alongside the memories, and turning any of those into
+ * a fact would put text into recall that nobody recorded as one.
+ */
+export declare function parseMemoryFile(raw: string): MemoryFileFields | undefined;

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

@@ -0,0 +1,8 @@
+import type { MemoryReadResult } from "../types.js";
+export interface ReadFileOptions {
+    cwd: string;
+    relPath: string;
+    from?: number;
+    lines?: number;
+}
+export declare function readMemoryFileBounded(opts: ReadFileOptions): Promise<MemoryReadResult>;

package/dist/internal/memory/storage/session-loader.d.cts

@@ -0,0 +1 @@
+export declare function discoverSessionFiles(cwd: string): Promise<SessionFile[]>;

package/dist/internal/memory/storage/session-summary-writer.d.cts

@@ -0,0 +1,2 @@
+export declare function sessionsDir(cwd: string): string;
+export declare function sessionSummaryPath(cwd: string, runId: string): string;

package/dist/internal/memory/storage/transcript-store.d.cts

@@ -0,0 +1 @@
+export declare function persistActiveMemoryTranscript(cwd: string, transcript: ActiveMemoryTranscript): Promise<void>;

package/dist/internal/memory/storage/wiki-loader.d.cts

@@ -0,0 +1,2 @@
+export declare function wikiDir(cwd: string): string;
+export declare function discoverWikiFiles(cwd: string): Promise<WikiFile[]>;

package/dist/internal/persistence/session-dir.d.cts

@@ -1 +1,16 @@
+/** The subset of `LocalOptions` this resolver reads. */
+interface SessionDirOptions {
+    sessionDir?: string;
+    baseDir?: string;
+}
+/**
+ * The session directory the caller ASKED for, or `undefined` when they asked for nothing.
+ *
+ * {@link resolveSessionDir} always answers with a path, falling back to the default home — which is
+ * the right answer for "where do transcripts go" and the wrong one for "did this consumer opt into
+ * sharing state with the Claude Code CLI". Memory writes need the second question, and the two
+ * accepted names for the option live here, so asking it anywhere else would put a copy of that
+ * knowledge somewhere it can drift.
+ */
+export declare function explicitSessionDir(local: SessionDirOptions | undefined): string | undefined;
 export {};

package/dist/internal/persistence/session-dir.d.ts

@@ -1 +1,16 @@
+/** The subset of `LocalOptions` this resolver reads. */
+interface SessionDirOptions {
+    sessionDir?: string;
+    baseDir?: string;
+}
+/**
+ * The session directory the caller ASKED for, or `undefined` when they asked for nothing.
+ *
+ * {@link resolveSessionDir} always answers with a path, falling back to the default home — which is
+ * the right answer for "where do transcripts go" and the wrong one for "did this consumer opt into
+ * sharing state with the Claude Code CLI". Memory writes need the second question, and the two
+ * accepted names for the option live here, so asking it anywhere else would put a copy of that
+ * knowledge somewhere it can drift.
+ */
+export declare function explicitSessionDir(local: SessionDirOptions | undefined): string | undefined;
 export {};

package/dist/internal/runtime/memory/memory-store.d.ts

@@ -1,4 +1,4 @@
 import { type MemoryConfig, type MemoryFact, redactSecrets } from "../../memory/types.js";
 export { redactSecrets };
-export declare function readMemoryFacts(cwd: string, config: MemoryConfig): Promise<MemoryFact[]>;
-export declare function appendMemoryFact(cwd: string, config: MemoryConfig, fact: MemoryFact): Promise<void>;
+export declare function readMemoryFacts(cwd: string, config: MemoryConfig, memoryHome?: string): Promise<MemoryFact[]>;
+export declare function appendMemoryFact(cwd: string, config: MemoryConfig, fact: MemoryFact, memoryHome?: string): Promise<void>;

package/dist/workflow.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkGNT35C5U_cjs = require('./chunk-GNT35C5U.cjs');
+var chunk6SBW4QR2_cjs = require('./chunk-6SBW4QR2.cjs');
 var chunkXWL6O3SW_cjs = require('./chunk-XWL6O3SW.cjs');
 require('./chunk-VTYY7XL5.cjs');
 require('./chunk-WJVHMTKB.cjs');
@@ -15,35 +15,35 @@ require('./chunk-NUKRL3I6.cjs');
 
 Object.defineProperty(exports, "Workflow", {
   enumerable: true,
-  get: function () { return chunkGNT35C5U_cjs.Workflow; }
+  get: function () { return chunk6SBW4QR2_cjs.Workflow; }
 });
 Object.defineProperty(exports, "WorkflowBuilder", {
   enumerable: true,
-  get: function () { return chunkGNT35C5U_cjs.WorkflowBuilder; }
+  get: function () { return chunk6SBW4QR2_cjs.WorkflowBuilder; }
 });
 Object.defineProperty(exports, "WorkflowToolError", {
   enumerable: true,
-  get: function () { return chunkGNT35C5U_cjs.WorkflowToolError; }
+  get: function () { return chunk6SBW4QR2_cjs.WorkflowToolError; }
 });
 Object.defineProperty(exports, "agentStep", {
   enumerable: true,
-  get: function () { return chunkGNT35C5U_cjs.agentStep; }
+  get: function () { return chunk6SBW4QR2_cjs.agentStep; }
 });
 Object.defineProperty(exports, "cloneWorkflow", {
   enumerable: true,
-  get: function () { return chunkGNT35C5U_cjs.cloneWorkflow; }
+  get: function () { return chunk6SBW4QR2_cjs.cloneWorkflow; }
 });
 Object.defineProperty(exports, "fn", {
   enumerable: true,
-  get: function () { return chunkGNT35C5U_cjs.fn; }
+  get: function () { return chunk6SBW4QR2_cjs.fn; }
 });
 Object.defineProperty(exports, "workflowAsTool", {
   enumerable: true,
-  get: function () { return chunkGNT35C5U_cjs.workflowAsTool; }
+  get: function () { return chunk6SBW4QR2_cjs.workflowAsTool; }
 });
 Object.defineProperty(exports, "workflowStep", {
   enumerable: true,
-  get: function () { return chunkGNT35C5U_cjs.workflowStep; }
+  get: function () { return chunk6SBW4QR2_cjs.workflowStep; }
 });
 Object.defineProperty(exports, "WorkflowAlreadyRunningError", {
   enumerable: true,

package/dist/workflow.js

@@ -1,4 +1,4 @@
-export { Workflow, WorkflowBuilder, WorkflowToolError, agentStep, cloneWorkflow, fn, workflowAsTool, workflowStep } from './chunk-XV4IZNV4.js';
+export { Workflow, WorkflowBuilder, WorkflowToolError, agentStep, cloneWorkflow, fn, workflowAsTool, workflowStep } from './chunk-FUL2I7G5.js';
 export { WorkflowAlreadyRunningError, WorkflowCompensateNotImplementedError, WorkflowDuplicateStepIdError, WorkflowInputError, WorkflowMaxIterationsExceededError, WorkflowNestedError, WorkflowNotSerializableError, WorkflowOutputError, WorkflowParallelError, WorkflowResumeStepNotFoundError, WorkflowSnapshotNotFoundError, WorkflowStateError, __resetSnapshotStoresForTests } from './chunk-AQLGBKNT.js';
 import './chunk-HY66GLM6.js';
 import './chunk-4VPXM6UU.js';

package/docs/error-codes.md

@@ -88,7 +88,7 @@ Branch on `code`, never on the message: messages carry context (an id, a path, a
 | `invalid_input` | domain | MemoryAdapterError | `packages/memory-honcho/src/adapter.ts:98` +9 |
 | `invalid_max_iterations` | domain | ConfigurationError | `packages/sdk/src/internal/local-agent/real-local-run.ts:215` |
 | `invalid_memory_backend` | domain | ConfigurationError | `packages/sdk/src/internal/memory/index-manager-dispatch.ts:24` +1 |
-| `invalid_memory_kind` | domain | ConfigurationError | `packages/sdk/src/internal/memory/storage/markdown-store.ts:150` |
+| `invalid_memory_kind` | domain | ConfigurationError | `packages/sdk/src/internal/memory/storage/markdown-store.ts:196` |
 | `invalid_model_selection` | domain | ConfigurationError | `packages/sdk/src/internal/runtime/model-selection.ts:21` |
 | `invalid_request` | transport | — | `packages/sdk/src/internal/error-mappers/vertex.ts:52` +1 |
 | `invalid_retry_config` | domain | ConfigurationError | `packages/sdk/src/internal/runtime/retry/with-retry.ts:67` |

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.
 
-1126 export(s) across 45 entry point(s).
+1135 export(s) across 46 entry point(s).
 
 ## `@theokit/acp`
 
@@ -1003,6 +1003,20 @@ A symbol listed under two specifiers is reachable from both, but that does NOT m
 | `LruEmbeddingCache` | class | Bounded in-memory LRU cache for embeddings, keyed by `sha256(text)` (or any stable key the caller chooses).  |
 | `OpenAiCompatibleConfig` | interface | What one provider adapter tells {@link createOpenAiCompatibleRuntime } about its wire: where to POST, which environment variables carry the key and the base URL, which model to use by default, and ... |
 
+## `@theokit/sdk/internal/memory-store`
+
+| Symbol | Kind | Summary |
+|---|---|---|
+| `appendFact` | function | Record a fact, honouring the `enabled` gate on {@link MemoryConfig } : when memory is disabled the call resolves without touching disk.  |
+| `appendFactToMarkdown` | function | Write a fact as its own memory file and point the `MEMORY.md` index at it.  |
+| `claudeProjectMemoryDir` | function | Where the Claude Code CLI keeps THIS project's memories.  |
+| `memoryDir` | function | The memory root for a workspace: `<cwd>/.theokit/memory`.  |
+| `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.  |
+| `memoryWriteDir` | function | Where a NEW fact should be written.  |
+| `notesDir` | function | Path to `<memory root>/notes`, where per-topic notes and the consolidated notes a dreaming sweep writes live.  |
+| `readFacts` | function | Every memory in the store, honouring the `enabled` gate on {@link MemoryConfig } : when memory is disabled the call resolves to `[]` without touching disk.  |
+| `readFactsFromMarkdown` | function | Every memory in the store: the per-memory files, plus any legacy `## Facts` bullets still in `MEMORY.md`.  |
+
 ## `@theokit/sdk/internal/persistence`
 
 | Symbol | Kind | Summary |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "4.58.0",
+  "version": "4.60.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheokit/theokit-sdk#readme",
@@ -288,6 +288,16 @@
         "default": "./dist/internal/memory/adapters/index.cjs"
       }
     },
+    "./internal/memory-store": {
+      "import": {
+        "types": "./dist/internal/memory/storage/index.d.ts",
+        "default": "./dist/internal/memory/storage/index.js"
+      },
+      "require": {
+        "types": "./dist/internal/memory/storage/index.d.cts",
+        "default": "./dist/internal/memory/storage/index.cjs"
+      }
+    },
     "./a2a": {
       "import": {
         "types": "./dist/a2a/index.d.ts",