@deepstrike/sdk 0.2.20 → 0.2.21

package/dist/index.d.ts

@@ -60,6 +60,7 @@ export type { RegisteredTool } from "./tools/index.js";
 export { scanSkillDir, readSkillFile } from "./skills/loader.js";
 export type { SkillMetadata } from "./skills/loader.js";
 export { WorkingMemory } from "./memory/working.js";
+export { InMemoryDreamStore } from "./memory/in-memory-store.js";
 export type { DreamStore, DreamResult, SessionData, SessionMessage, MemoryEntry, CurationResult, CurationStats, MemoryWriteRequest, MemoryQuery, MemoryRetrieval, MemoryMetadata, MemoryKind, } from "./memory/protocols.js";
 export type { KnowledgeSource } from "./knowledge/source.js";
 export { ScheduledPrompt } from "./signals/scheduled.js";

package/dist/index.js

@@ -42,6 +42,7 @@ export { tool, streamingTool, executeTools, readFile, validateToolArguments } fr
 export { scanSkillDir, readSkillFile } from "./skills/loader.js";
 // ── Memory ─────────────────────────────────────────────────────────────────
 export { WorkingMemory } from "./memory/working.js";
+export { InMemoryDreamStore } from "./memory/in-memory-store.js";
 export { ScheduledPrompt } from "./signals/scheduled.js";
 export { SignalGateway } from "./signals/gateway.js";
 // ── Safety & Governance ────────────────────────────────────────────────────

package/dist/memory/in-memory-store.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `InMemoryDreamStore` — a lightweight `DreamStore` implementation backed by per-agent `Map`s.
+ *
+ * Originally lived as `MockDreamStore` in the SDK's test helpers; promoted here so benchmarks,
+ * examples, and downstream consumers can use it without copying the boilerplate.
+ *
+ * Use cases:
+ *   - Benchmark A/B variants where memory is on/off (preload via constructor).
+ *   - Unit tests that exercise `Agent.dream()` or the `memory_query` path without disk I/O.
+ *   - Local development / CI where a persistent memory store isn't needed.
+ *
+ * The `search()` impl is intentionally trivial — it returns the first `topK` memories for the
+ * agent regardless of `query`. The kernel ranks by score before deciding what to surface, so the
+ * order memories were inserted is what callers see. For semantic search, plug in a real store.
+ */
+import type { CurationResult, DreamStore, MemoryEntry, SessionData } from "./protocols.js";
+export declare class InMemoryDreamStore implements DreamStore {
+    private readonly initialMemories;
+    private sessions;
+    private memories;
+    /** Sessions persisted via `saveSession`; exposed for test assertions. */
+    readonly savedSessions: SessionData[];
+    /**
+     * @param initialMemories Optional seed memories applied to every agent that asks for memories
+     *                        for the first time. Useful for benchmark scenarios that preload a fact.
+     */
+    constructor(initialMemories?: MemoryEntry[]);
+    /** Pre-populate sessions for a specific agent (test/benchmark setup). */
+    addSession(agentId: string, session: SessionData): void;
+    /** Pre-populate memories for a specific agent (test/benchmark setup). */
+    addMemories(agentId: string, entries: MemoryEntry[]): void;
+    loadSessions(agentId: string): Promise<SessionData[]>;
+    loadMemories(agentId: string): Promise<MemoryEntry[]>;
+    commit(agentId: string, result: CurationResult, existing: MemoryEntry[]): Promise<void>;
+    search(agentId: string, _query: string, topK?: number): Promise<MemoryEntry[]>;
+    saveSession(data: SessionData): Promise<void>;
+}

package/dist/memory/in-memory-store.js

@@ -0,0 +1,50 @@
+export class InMemoryDreamStore {
+    initialMemories;
+    sessions = new Map();
+    memories = new Map();
+    /** Sessions persisted via `saveSession`; exposed for test assertions. */
+    savedSessions = [];
+    /**
+     * @param initialMemories Optional seed memories applied to every agent that asks for memories
+     *                        for the first time. Useful for benchmark scenarios that preload a fact.
+     */
+    constructor(initialMemories = []) {
+        this.initialMemories = initialMemories;
+    }
+    /** Pre-populate sessions for a specific agent (test/benchmark setup). */
+    addSession(agentId, session) {
+        const list = this.sessions.get(agentId) ?? [];
+        list.push(session);
+        this.sessions.set(agentId, list);
+    }
+    /** Pre-populate memories for a specific agent (test/benchmark setup). */
+    addMemories(agentId, entries) {
+        this.memories.set(agentId, [...(this.memories.get(agentId) ?? []), ...entries]);
+    }
+    async loadSessions(agentId) {
+        return this.sessions.get(agentId) ?? [];
+    }
+    async loadMemories(agentId) {
+        if (this.memories.has(agentId))
+            return this.memories.get(agentId);
+        if (this.initialMemories.length > 0) {
+            this.memories.set(agentId, [...this.initialMemories]);
+            return this.memories.get(agentId);
+        }
+        return [];
+    }
+    async commit(agentId, result, existing) {
+        const kept = existing.filter((_, i) => !result.toRemoveIndices.includes(i));
+        this.memories.set(agentId, [...kept, ...result.toAdd]);
+    }
+    async search(agentId, _query, topK = 5) {
+        const all = await this.loadMemories(agentId);
+        return all.slice(0, topK);
+    }
+    async saveSession(data) {
+        this.savedSessions.push(data);
+        const list = this.sessions.get(data.agentId) ?? [];
+        list.push(data);
+        this.sessions.set(data.agentId, list);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstrike/sdk",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "description": "DeepStrike Node.js SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.99.0",
-    "@deepstrike/core": "0.2.20",
+    "@deepstrike/core": "0.2.21",
     "@google/generative-ai": "^0.24.1",
     "openai": "^5.23.2"
   },