@skein-js/core 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/index.d.ts +19 -1
  2. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -123,6 +123,24 @@ interface SkeinStore {
123
123
  runs: RunRepo;
124
124
  store: StoreRepo;
125
125
  }
126
+ /**
127
+ * A driver-agnostic, JSON-serializable snapshot of every resource row — the unit of bulk
128
+ * transfer for persistence and migration tooling (e.g. `skein dev`'s cross-restart snapshot, and
129
+ * importing an existing LangGraph in-memory dev state). Each entry is an `[id, row]` tuple: the id
130
+ * is the entity's own id, except `items` (keyed by `JSON.stringify([namespace, key])`) and
131
+ * `runKwargs` (keyed by `run_id`, since {@link RunKwargs} has no id of its own).
132
+ *
133
+ * A driver MAY expose `restore(snapshot)` to bulk-load one of these verbatim — ids and timestamps
134
+ * preserved — which is what makes an import lossless. It is intentionally not part of
135
+ * {@link SkeinStore}: only migration tooling needs it, and consumers feature-detect it.
136
+ */
137
+ interface SkeinStoreSnapshot {
138
+ assistants: [string, Assistant][];
139
+ threads: [string, Thread][];
140
+ runs: [string, Run][];
141
+ runKwargs: [string, RunKwargs][];
142
+ items: [string, Item][];
143
+ }
126
144
 
127
145
  /**
128
146
  * A normalized stream frame produced during a run. Adapters map these onto SSE
@@ -281,4 +299,4 @@ interface AuthEngine {
281
299
  matchesFilters(metadata: Record<string, unknown> | undefined, filters?: AuthFilters): boolean;
282
300
  }
283
301
 
284
- export { type AssistantCreate, type AssistantRepo, type AuthAction, type AuthContext, type AuthEngine, type AuthFilterValue, type AuthFilters, type AuthResource, type AuthUser, type MultitaskStrategy, type QueuedRun, type RunConsumer, type RunConsumerOptions, type RunCreate, type RunEventBus, type RunFrame, type RunKwargs, type RunProcessor, type RunQueue, type RunRepo, type RunStatus, SkeinHttpError, type SkeinHttpErrorOptions, type SkeinStore, type StoreRepo, type StoreSearchQuery, TERMINAL_RUN_STATUSES, type ThreadCreate, type ThreadRepo, type ThreadUpdate, isSkeinHttpError, isTerminalRunStatus, serializeWireJson };
302
+ export { type AssistantCreate, type AssistantRepo, type AuthAction, type AuthContext, type AuthEngine, type AuthFilterValue, type AuthFilters, type AuthResource, type AuthUser, type MultitaskStrategy, type QueuedRun, type RunConsumer, type RunConsumerOptions, type RunCreate, type RunEventBus, type RunFrame, type RunKwargs, type RunProcessor, type RunQueue, type RunRepo, type RunStatus, SkeinHttpError, type SkeinHttpErrorOptions, type SkeinStore, type SkeinStoreSnapshot, type StoreRepo, type StoreSearchQuery, TERMINAL_RUN_STATUSES, type ThreadCreate, type ThreadRepo, type ThreadUpdate, isSkeinHttpError, isTerminalRunStatus, serializeWireJson };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@skein-js/core",
3
- "version": "0.2.1",
3
+ "version": "0.3.0",
4
4
  "description": "Framework-agnostic Agent Protocol engine for LangGraph.js — the heart of skein-js.",
5
5
  "license": "Apache-2.0",
6
6
  "author": "Maina Wycliffe <wmmaina7@gmail.com>",