@ponraaj/dimple-sdk 0.0.0-alpha.10 → 0.0.0-alpha.12

package/README.md

@@ -81,10 +81,11 @@ the docs site: [Configuration reference](https://dimple.ponraaj.me/reference/con
 
 ## MCP server
 
-`dimple mcp` (from the CLI package) exposes dimple to any MCP client over
-the 2026-07-28 protocol — API discovery plus sandboxed code execution with
-the whole API as a `dimple` namespace. Guide:
-[MCP server & code mode](https://dimple.ponraaj.me/guides/mcp/).
+`dimple mcp` (from the CLI package) exposes dimple to any MCP client
+(modern 2026-07-28 clients; 2025-era clients served too) as one transparent
+tool per capability — memory, graph, maintenance, and docs (search + deep
+links). Guide:
+[MCP server](https://dimple.ponraaj.me/guides/mcp/).
 
 ## Agent integration patterns
 

package/dist/dimple.d.ts

@@ -55,6 +55,12 @@ export interface IndexOptions {
     readonly namespace?: string;
     /** Embed + topic-route every unit (default true). */
     readonly embed?: boolean;
+    /** Write the units and hand every one that needs a vector to the durable
+     * `memory.embed.batch` job instead of embedding inline: units are stored
+     * (and lexically searchable) when `index` returns, vectors + topic routing
+     * land whenever a worker drains the queue. Ignored when `embed` is
+     * `false`. */
+    readonly deferEmbed?: boolean;
     /** Cap for the whole-file memory content (default 64 KiB). */
     readonly maxFileBytes?: number;
     /** Cap for each extracted chunk's content (default 8 KiB). */
@@ -83,6 +89,10 @@ export interface IndexResult {
     readonly skipped: number;
     /** Files skipped because the extension is not indexable. */
     readonly unsupported: number;
+    /** `memory.embed.batch` jobs enqueued by the deferred path (`deferEmbed`) —
+     * units stored without a vector, counted after the enqueue. Absent in the
+     * synchronous path, where every unit is embedded before returning. */
+    readonly pendingEmbeddings?: number;
     readonly commit: string | null;
     /** Files that could not be walked/read/parsed/extracted/written. */
     readonly failed: readonly {
@@ -128,6 +138,9 @@ export interface Dimple {
      * All-or-nothing: a duplicate logical key rejects the whole batch. */
     readonly writeMany: (units: readonly WriteMemoryInput[], options?: WriteOptions) => Promise<readonly MemoryUnit[]>;
     readonly get: (id: string) => Promise<MemoryUnit>;
+    /** Hybrid retrieval over the store. Results are ranked rows; graph
+     * context (`supersededBy` / `conflicts` / `supportedBy`) is not attached
+     * yet — the fused path does not run the store's post-pass. */
     readonly query: (text: string, options?: QueryOptions) => Promise<AugmentedMemory[]>;
     readonly forget: (id: string) => Promise<void>;
     /** Parse + extract a directory/files with tree-sitter and store the