@skein-js/storage-memory 0.2.0 → 0.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 > In-memory `SkeinStore` + run queue + event bus for development and tests.
 
-Part of **[skein-js](https://github.com/mainawycliffe/skein)** — a TypeScript [Agent Protocol](https://github.com/langchain-ai/agent-protocol) server for [LangGraph.js](https://github.com/langchain-ai/langgraphjs), and a drop-in replacement for the LangGraph CLI.
+Part of **[skein-js](../../README.md)** — a TypeScript [Agent Protocol](https://github.com/langchain-ai/agent-protocol) server for [LangGraph.js](https://github.com/langchain-ai/langgraphjs), and a drop-in replacement for the LangGraph CLI.
 
 **Status:** 🚧 Pre-alpha — implemented; passes the shared `SkeinStore` conformance suite.
 
@@ -86,7 +86,7 @@ only Agent Protocol _resources_, never graph state.
 ## Learn more
 
 - [Storage](../../docs/storage.md) · [Runs & Redis](../../docs/runs-and-redis.md)
-- [skein-js overview](../../docs/index.md) · [Reuse-first architecture](../../docs/reuse.md)
+- [skein-js overview](../../docs/index.md) · [Reuse-first architecture](../../docs/reuse.md) · [Root README](../../README.md)
 
 ## License
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { SkeinStore, AssistantRepo, ThreadRepo, RunRepo, StoreRepo, Assistant, Thread, Run, RunKwargs, Item, RunEventBus, RunFrame, RunQueue, QueuedRun, RunProcessor, RunConsumerOptions, RunConsumer } from '@skein-js/core';
+import { SkeinStore, AssistantRepo, ThreadRepo, RunRepo, StoreRepo, SkeinStoreSnapshot, RunEventBus, RunFrame, RunQueue, QueuedRun, RunProcessor, RunConsumerOptions, RunConsumer } from '@skein-js/core';
 
 /** In-process SkeinStore for development and tests. */
 declare class MemorySkeinStore implements SkeinStore {
@@ -14,15 +14,21 @@ declare class MemorySkeinStore implements SkeinStore {
     snapshot(): MemoryStoreSnapshot;
     /** Replace all rows with a {@link snapshot}. Used by `skein dev` to restore persisted dev state. */
     hydrate(snapshot: MemoryStoreSnapshot): void;
+    /**
+     * Bulk-load rows from a snapshot, preserving ids + timestamps and *without* clearing what's
+     * already here: existing ids are left untouched (insert-if-absent). Unlike {@link hydrate} (a
+     * full replace for cross-restart persistence), this is the additive, lossless sink used by
+     * migration tooling — see `@skein-js/express`'s LangGraph importer. `loadSnapshotIntoStore`
+     * feature-detects this method, so the memory and Postgres drivers import identically.
+     */
+    restore(snapshot: SkeinStoreSnapshot): Promise<void>;
 }
-/** A JSON-serializable copy of a {@link MemorySkeinStore}'s rows. */
-interface MemoryStoreSnapshot {
-    assistants: [string, Assistant][];
-    threads: [string, Thread][];
-    runs: [string, Run][];
-    runKwargs: [string, RunKwargs][];
-    items: [string, Item][];
-}
+/**
+ * A JSON-serializable copy of a {@link MemorySkeinStore}'s rows. An alias of the driver-agnostic
+ * {@link SkeinStoreSnapshot} (identical shape); the name predates the shared type and is kept so
+ * the dev-persistence snapshot format reads the same.
+ */
+type MemoryStoreSnapshot = SkeinStoreSnapshot;
 
 /**
  * In-memory FIFO of background runs, drained by a single-process consumer — all `skein dev` needs.

package/dist/index.js

@@ -208,6 +208,23 @@ var MemorySkeinStore = class {
     fill(this.#runKwargs, snapshot.runKwargs);
     fill(this.#items, snapshot.items);
   }
+  /**
+   * Bulk-load rows from a snapshot, preserving ids + timestamps and *without* clearing what's
+   * already here: existing ids are left untouched (insert-if-absent). Unlike {@link hydrate} (a
+   * full replace for cross-restart persistence), this is the additive, lossless sink used by
+   * migration tooling — see `@skein-js/express`'s LangGraph importer. `loadSnapshotIntoStore`
+   * feature-detects this method, so the memory and Postgres drivers import identically.
+   */
+  async restore(snapshot) {
+    const add = (map, rows) => {
+      for (const [id, row] of rows) if (!map.has(id)) map.set(id, clone(row));
+    };
+    add(this.#assistants, snapshot.assistants);
+    add(this.#threads, snapshot.threads);
+    add(this.#runs, snapshot.runs);
+    add(this.#runKwargs, snapshot.runKwargs);
+    add(this.#items, snapshot.items);
+  }
 };
 
 // src/memory-queue.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skein-js/storage-memory",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "In-memory SkeinStore + queue driver for development and tests.",
   "license": "Apache-2.0",
   "author": "Maina Wycliffe <wmmaina7@gmail.com>",
@@ -40,10 +40,10 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@skein-js/core": "0.2.0"
+    "@skein-js/core": "0.3.0"
   },
   "devDependencies": {
-    "@skein-js/test-support": "0.2.0"
+    "@skein-js/test-support": "0.3.0"
   },
   "publishConfig": {
     "access": "public"