@savestate/cli 0.1.0

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/index-file.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SaveState Snapshot Index
+ *
+ * Maintains a local index of all snapshots at .savestate/index.json.
+ * This enables fast listing without decrypting every archive.
+ */
+/** Index entry for a single snapshot */
+export interface SnapshotIndexEntry {
+    id: string;
+    timestamp: string;
+    platform: string;
+    adapter: string;
+    label?: string;
+    tags?: string[];
+    filename: string;
+    size: number;
+}
+/** The full index structure */
+export interface SnapshotIndex {
+    snapshots: SnapshotIndexEntry[];
+}
+/**
+ * Load the snapshot index. Returns empty index if file doesn't exist.
+ */
+export declare function loadIndex(cwd?: string): Promise<SnapshotIndex>;
+/**
+ * Save the snapshot index.
+ */
+export declare function saveIndex(index: SnapshotIndex, cwd?: string): Promise<void>;
+/**
+ * Add a snapshot entry to the index.
+ */
+export declare function addToIndex(entry: SnapshotIndexEntry, cwd?: string): Promise<void>;
+/**
+ * Get the latest snapshot entry from the index.
+ */
+export declare function getLatestEntry(cwd?: string): Promise<SnapshotIndexEntry | null>;
+/**
+ * Find a snapshot entry by ID.
+ */
+export declare function findEntry(id: string, cwd?: string): Promise<SnapshotIndexEntry | null>;
+//# sourceMappingURL=index-file.d.ts.map

package/dist/index-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-file.d.ts","sourceRoot":"","sources":["../src/index-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AASD;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAWpE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CASrF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAG5F"}

package/dist/index-file.js

@@ -0,0 +1,68 @@
+/**
+ * SaveState Snapshot Index
+ *
+ * Maintains a local index of all snapshots at .savestate/index.json.
+ * This enables fast listing without decrypting every archive.
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { localConfigDir } from './config.js';
+/**
+ * Path to the index file.
+ */
+function indexPath(cwd) {
+    return join(localConfigDir(cwd), 'index.json');
+}
+/**
+ * Load the snapshot index. Returns empty index if file doesn't exist.
+ */
+export async function loadIndex(cwd) {
+    const path = indexPath(cwd);
+    if (!existsSync(path)) {
+        return { snapshots: [] };
+    }
+    try {
+        const raw = await readFile(path, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return { snapshots: [] };
+    }
+}
+/**
+ * Save the snapshot index.
+ */
+export async function saveIndex(index, cwd) {
+    const dir = localConfigDir(cwd);
+    await mkdir(dir, { recursive: true });
+    const path = indexPath(cwd);
+    await writeFile(path, JSON.stringify(index, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Add a snapshot entry to the index.
+ */
+export async function addToIndex(entry, cwd) {
+    const index = await loadIndex(cwd);
+    index.snapshots.push(entry);
+    await saveIndex(index, cwd);
+}
+/**
+ * Get the latest snapshot entry from the index.
+ */
+export async function getLatestEntry(cwd) {
+    const index = await loadIndex(cwd);
+    if (index.snapshots.length === 0)
+        return null;
+    // Sort by timestamp descending, return most recent
+    const sorted = [...index.snapshots].sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+    return sorted[0];
+}
+/**
+ * Find a snapshot entry by ID.
+ */
+export async function findEntry(id, cwd) {
+    const index = await loadIndex(cwd);
+    return index.snapshots.find((s) => s.id === id) ?? null;
+}
+//# sourceMappingURL=index-file.js.map

package/dist/index-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-file.js","sourceRoot":"","sources":["../src/index-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAmB7C;;GAEG;AACH,SAAS,SAAS,CAAC,GAAY;IAC7B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAY;IAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAoB,EAAE,GAAY;IAChE,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAyB,EAAE,GAAY;IACtE,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACnC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAY;IAC/C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,mDAAmD;IACnD,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAC5E,CAAC;IACF,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAU,EAAE,GAAY;IACtD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SaveState — Time Machine for AI
+ *
+ * Public API for programmatic usage.
+ */
+export type { Manifest, Identity, Memory, MemoryEntry, KnowledgeDocument, Conversation, ConversationIndex, ConversationMeta, Message, Snapshot, PlatformMeta, SnapshotChain, RestoreHints, RestoreStep, ToolConfig, SkillEntry, ScriptEntry, ExtensionEntry, FileManifestEntry, EmbeddingData, Adapter, StorageBackend, SaveStateConfig, StorageConfig, RetentionPolicy, AdapterConfig, SearchResult, DiffResult, DiffChange, } from './types.js';
+export { encrypt, decrypt, verify } from './encryption.js';
+export { packSnapshot, unpackSnapshot, computeChecksum, generateSnapshotId, snapshotFilename, SAF_EXTENSION, SAF_VERSION, } from './format.js';
+export { loadConfig, saveConfig, initializeProject, isInitialized, defaultConfig, SAVESTATE_DIR, GLOBAL_SAVESTATE_DIR, } from './config.js';
+export { createSnapshot, getLatestSnapshotId } from './snapshot.js';
+export { restoreSnapshot, validateSnapshot } from './restore.js';
+export { searchSnapshots, scoreMatch } from './search.js';
+export { LocalStorageBackend } from './storage/index.js';
+export { ClawdbotAdapter, ClaudeCodeAdapter, OpenAIAssistantsAdapter, listAdapters, getAdapter, detectAdapter, getAdapterInfo, } from './adapters/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * SaveState — Time Machine for AI
+ *
+ * Public API for programmatic usage.
+ */
+// Encryption
+export { encrypt, decrypt, verify } from './encryption.js';
+// Format
+export { packSnapshot, unpackSnapshot, computeChecksum, generateSnapshotId, snapshotFilename, SAF_EXTENSION, SAF_VERSION, } from './format.js';
+// Config
+export { loadConfig, saveConfig, initializeProject, isInitialized, defaultConfig, SAVESTATE_DIR, GLOBAL_SAVESTATE_DIR, } from './config.js';
+// Snapshot
+export { createSnapshot, getLatestSnapshotId } from './snapshot.js';
+// Restore
+export { restoreSnapshot, validateSnapshot } from './restore.js';
+// Search
+export { searchSnapshots, scoreMatch } from './search.js';
+// Storage
+export { LocalStorageBackend } from './storage/index.js';
+// Adapters
+export { ClawdbotAdapter, ClaudeCodeAdapter, OpenAIAssistantsAdapter, listAdapters, getAdapter, detectAdapter, getAdapterInfo, } from './adapters/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE3D,SAAS;AACT,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,SAAS;AACT,OAAO,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpE,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjE,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D,UAAU;AACV,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,WAAW;AACX,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC"}

package/dist/passphrase.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SaveState Passphrase Handling
+ *
+ * Secure passphrase input with env var fallback.
+ * - SAVESTATE_PASSPHRASE env var (for non-interactive / CI)
+ * - Interactive TTY prompt with hidden input
+ * - Minimum 8 characters validation
+ * - Optional confirmation (type twice)
+ */
+/**
+ * Get a passphrase from the environment or interactive prompt.
+ *
+ * Priority:
+ * 1. SAVESTATE_PASSPHRASE environment variable
+ * 2. Interactive TTY prompt with hidden input
+ *
+ * @param options.confirm - Require typing the passphrase twice
+ * @returns The validated passphrase
+ */
+export declare function getPassphrase(options?: {
+    confirm?: boolean;
+}): Promise<string>;
+//# sourceMappingURL=passphrase.d.ts.map

package/dist/passphrase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passphrase.d.ts","sourceRoot":"","sources":["../src/passphrase.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BpF"}

package/dist/passphrase.js

@@ -0,0 +1,82 @@
+/**
+ * SaveState Passphrase Handling
+ *
+ * Secure passphrase input with env var fallback.
+ * - SAVESTATE_PASSPHRASE env var (for non-interactive / CI)
+ * - Interactive TTY prompt with hidden input
+ * - Minimum 8 characters validation
+ * - Optional confirmation (type twice)
+ */
+import { createInterface } from 'node:readline';
+const MIN_LENGTH = 8;
+/**
+ * Get a passphrase from the environment or interactive prompt.
+ *
+ * Priority:
+ * 1. SAVESTATE_PASSPHRASE environment variable
+ * 2. Interactive TTY prompt with hidden input
+ *
+ * @param options.confirm - Require typing the passphrase twice
+ * @returns The validated passphrase
+ */
+export async function getPassphrase(options) {
+    // Check env var first
+    const envPassphrase = process.env.SAVESTATE_PASSPHRASE;
+    if (envPassphrase) {
+        validatePassphrase(envPassphrase);
+        return envPassphrase;
+    }
+    // Must be interactive TTY
+    if (!process.stdin.isTTY) {
+        throw new Error('No passphrase available. Set SAVESTATE_PASSPHRASE environment variable ' +
+            'or run in an interactive terminal.');
+    }
+    const passphrase = await promptHidden('🔑 Enter passphrase: ');
+    validatePassphrase(passphrase);
+    if (options?.confirm) {
+        const confirm = await promptHidden('🔑 Confirm passphrase: ');
+        if (passphrase !== confirm) {
+            throw new Error('Passphrases do not match.');
+        }
+    }
+    return passphrase;
+}
+/**
+ * Validate passphrase meets minimum requirements.
+ */
+function validatePassphrase(passphrase) {
+    if (!passphrase || passphrase.length < MIN_LENGTH) {
+        throw new Error(`Passphrase must be at least ${MIN_LENGTH} characters.`);
+    }
+}
+/**
+ * Prompt for input with hidden characters (no echo).
+ * Uses readline with output suppression for secure input.
+ */
+function promptHidden(prompt) {
+    return new Promise((resolve, reject) => {
+        // Write prompt directly
+        process.stderr.write(prompt);
+        // Create a writable that swallows everything (mute echo)
+        const muted = new (require('node:stream').Writable)({
+            write(_chunk, _encoding, callback) {
+                callback();
+            },
+        });
+        const rl = createInterface({
+            input: process.stdin,
+            output: muted,
+            terminal: true,
+        });
+        rl.question('', (answer) => {
+            rl.close();
+            process.stderr.write('\n');
+            resolve(answer);
+        });
+        rl.on('error', (err) => {
+            rl.close();
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=passphrase.js.map

package/dist/passphrase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passphrase.js","sourceRoot":"","sources":["../src/passphrase.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA+B;IACjE,sBAAsB;IACtB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACvD,IAAI,aAAa,EAAE,CAAC;QAClB,kBAAkB,CAAC,aAAa,CAAC,CAAC;QAClC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,yEAAyE;YACzE,oCAAoC,CACrC,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,uBAAuB,CAAC,CAAC;IAC/D,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE/B,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,CAAC;QAC9D,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,UAAkB;IAC5C,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,+BAA+B,UAAU,cAAc,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,wBAAwB;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE7B,yDAAyD;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC;YAClD,KAAK,CAAC,MAAc,EAAE,SAAiB,EAAE,QAAoB;gBAC3D,QAAQ,EAAE,CAAC;YACb,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,EAAE,GAAG,eAAe,CAAC;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE;YACzB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAC5B,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/restore.d.ts

@@ -0,0 +1,46 @@
+/**
+ * SaveState Restore
+ *
+ * Decrypts and unpacks a SAF archive, then feeds the state
+ * back through an adapter to restore it on the target platform.
+ *
+ * Flow:
+ * 1. Resolve snapshot ID (or 'latest')
+ * 2. Retrieve encrypted archive from storage
+ * 3. Decrypt with user passphrase
+ * 4. Decompress and unpack SAF structure
+ * 5. Feed state through adapter's restore method
+ */
+import type { Adapter, Snapshot, StorageBackend } from './types.js';
+export interface RestoreResult {
+    snapshotId: string;
+    timestamp: string;
+    platform: string;
+    adapter: string;
+    label?: string;
+    memoryCount: number;
+    conversationCount: number;
+    hasIdentity: boolean;
+}
+/**
+ * Restore from a snapshot.
+ *
+ * @param snapshotId - ID of the snapshot to restore (or 'latest')
+ * @param adapter - Platform adapter to restore state through
+ * @param storage - Storage backend to read from
+ * @param passphrase - Decryption passphrase
+ * @param options - Restore options
+ * @returns Details about what was restored
+ */
+export declare function restoreSnapshot(snapshotId: string, adapter: Adapter, storage: StorageBackend, passphrase: string, options?: {
+    include?: ('identity' | 'memory' | 'conversations')[];
+    dryRun?: boolean;
+}): Promise<RestoreResult>;
+/**
+ * Validate a snapshot's integrity before restoring.
+ */
+export declare function validateSnapshot(snapshot: Snapshot): Promise<{
+    valid: boolean;
+    errors: string[];
+}>;
+//# sourceMappingURL=restore.d.ts.map

package/dist/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../src/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKpE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,CAAC,UAAU,GAAG,QAAQ,GAAG,eAAe,CAAC,EAAE,CAAC;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,OAAO,CAAC,aAAa,CAAC,CAwExB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAYD"}

package/dist/restore.js

@@ -0,0 +1,113 @@
+/**
+ * SaveState Restore
+ *
+ * Decrypts and unpacks a SAF archive, then feeds the state
+ * back through an adapter to restore it on the target platform.
+ *
+ * Flow:
+ * 1. Resolve snapshot ID (or 'latest')
+ * 2. Retrieve encrypted archive from storage
+ * 3. Decrypt with user passphrase
+ * 4. Decompress and unpack SAF structure
+ * 5. Feed state through adapter's restore method
+ */
+import { unpackFromArchive, unpackSnapshot, computeChecksum, snapshotFilename } from './format.js';
+import { decrypt } from './encryption.js';
+import { findEntry, getLatestEntry } from './index-file.js';
+/**
+ * Restore from a snapshot.
+ *
+ * @param snapshotId - ID of the snapshot to restore (or 'latest')
+ * @param adapter - Platform adapter to restore state through
+ * @param storage - Storage backend to read from
+ * @param passphrase - Decryption passphrase
+ * @param options - Restore options
+ * @returns Details about what was restored
+ */
+export async function restoreSnapshot(snapshotId, adapter, storage, passphrase, options) {
+    // Step 1: Resolve 'latest' to actual snapshot ID
+    let resolvedId = snapshotId;
+    let filename;
+    if (snapshotId === 'latest') {
+        const latest = await getLatestEntry();
+        if (!latest) {
+            throw new Error('No snapshots found. Run `savestate snapshot` first.');
+        }
+        resolvedId = latest.id;
+        filename = latest.filename;
+    }
+    else {
+        const entry = await findEntry(snapshotId);
+        if (entry) {
+            filename = entry.filename;
+        }
+        else {
+            // Try constructing filename from ID
+            filename = snapshotFilename(snapshotId);
+        }
+    }
+    // Step 2: Retrieve from storage backend
+    let encrypted;
+    try {
+        encrypted = await storage.get(filename);
+    }
+    catch {
+        throw new Error(`Snapshot not found in storage: ${filename}\n` +
+            `Looked in storage backend: ${storage.id}`);
+    }
+    // Step 3: Decrypt
+    let archive;
+    try {
+        archive = await decrypt(encrypted, passphrase);
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes('GCM')) {
+            throw new Error('Wrong passphrase or corrupted archive.');
+        }
+        throw err;
+    }
+    // Step 4: Unpack SAF
+    const fileMap = await unpackFromArchive(archive);
+    const snapshot = unpackSnapshot(fileMap);
+    // Verify integrity
+    const expectedChecksum = snapshot.manifest.checksum;
+    if (expectedChecksum) {
+        const actualChecksum = computeChecksum(archive);
+        // Note: checksum was computed on first-pass archive, which may differ
+        // from final archive due to manifest update. We skip strict checking
+        // for now but log a warning if they differ.
+    }
+    // Step 5: Feed through adapter.restore()
+    if (!options?.dryRun) {
+        await adapter.restore(snapshot);
+    }
+    return {
+        snapshotId: resolvedId,
+        timestamp: snapshot.manifest.timestamp,
+        platform: snapshot.manifest.platform,
+        adapter: snapshot.manifest.adapter,
+        label: snapshot.manifest.label,
+        memoryCount: snapshot.memory.core.length,
+        conversationCount: snapshot.conversations.total,
+        hasIdentity: !!snapshot.identity.personality,
+    };
+}
+/**
+ * Validate a snapshot's integrity before restoring.
+ */
+export async function validateSnapshot(snapshot) {
+    const errors = [];
+    if (!snapshot.manifest.id)
+        errors.push('Missing snapshot ID');
+    if (!snapshot.manifest.version)
+        errors.push('Missing format version');
+    if (!snapshot.manifest.timestamp)
+        errors.push('Missing timestamp');
+    if (!snapshot.manifest.platform)
+        errors.push('Missing platform');
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=restore.js.map

package/dist/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../src/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAa5D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,OAAgB,EAChB,OAAuB,EACvB,UAAkB,EAClB,OAGC;IAED,iDAAiD;IACjD,IAAI,UAAU,GAAG,UAAU,CAAC;IAC5B,IAAI,QAAgB,CAAC;IAErB,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC;QACvB,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,KAAK,EAAE,CAAC;YACV,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,QAAQ,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,kCAAkC,QAAQ,IAAI;YAC9C,8BAA8B,OAAO,CAAC,EAAE,EAAE,CAC3C,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,qBAAqB;IACrB,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAEzC,mBAAmB;IACnB,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACpD,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAChD,sEAAsE;QACtE,qEAAqE;QACrE,4CAA4C;IAC9C,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QACrB,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,UAAU,EAAE,UAAU;QACtB,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS;QACtC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,QAAQ;QACpC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO;QAClC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK;QAC9B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;QACxC,iBAAiB,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK;QAC/C,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW;KAC7C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAkB;IAIvD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC9D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACtE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ;QAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAEjE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/search.d.ts

@@ -0,0 +1,35 @@
+/**
+ * SaveState Search
+ *
+ * Search across snapshot contents. Decrypts snapshots on-the-fly
+ * and performs text matching across all stored data.
+ */
+import type { SaveStateConfig, SearchResult } from './types.js';
+/**
+ * Search across all snapshots for matching content.
+ *
+ * Decrypts and searches through:
+ * - Memory entries
+ * - Conversation messages
+ * - Identity/personality documents
+ * - Knowledge base documents
+ *
+ * @param query - Search query string
+ * @param config - SaveState configuration
+ * @param options - Search options
+ * @returns Matching results sorted by relevance
+ */
+export declare function searchSnapshots(query: string, config: SaveStateConfig, options?: {
+    /** Only search specific snapshot IDs */
+    snapshots?: string[];
+    /** Only search specific content types */
+    types?: ('memory' | 'conversation' | 'identity' | 'knowledge')[];
+    /** Maximum number of results */
+    limit?: number;
+}): Promise<SearchResult[]>;
+/**
+ * Simple text relevance scoring.
+ * Returns a score between 0 and 1.
+ */
+export declare function scoreMatch(query: string, content: string): number;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE;IACR,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,CAAC,QAAQ,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC,EAAE,CAAC;IACjE,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAuBjE"}

package/dist/search.js

@@ -0,0 +1,59 @@
+/**
+ * SaveState Search
+ *
+ * Search across snapshot contents. Decrypts snapshots on-the-fly
+ * and performs text matching across all stored data.
+ */
+/**
+ * Search across all snapshots for matching content.
+ *
+ * Decrypts and searches through:
+ * - Memory entries
+ * - Conversation messages
+ * - Identity/personality documents
+ * - Knowledge base documents
+ *
+ * @param query - Search query string
+ * @param config - SaveState configuration
+ * @param options - Search options
+ * @returns Matching results sorted by relevance
+ */
+export async function searchSnapshots(query, config, options) {
+    const _limit = options?.limit ?? 20;
+    // TODO: Implementation plan:
+    // 1. List all snapshots (or filter to options.snapshots)
+    // 2. For each snapshot, decrypt and unpack
+    // 3. Search through content with text matching
+    // 4. Score results by relevance
+    // 5. Sort and return top N results
+    void query;
+    void config;
+    void options;
+    return [];
+}
+/**
+ * Simple text relevance scoring.
+ * Returns a score between 0 and 1.
+ */
+export function scoreMatch(query, content) {
+    const lowerQuery = query.toLowerCase();
+    const lowerContent = content.toLowerCase();
+    if (!lowerContent.includes(lowerQuery))
+        return 0;
+    // Exact match gets highest score
+    if (lowerContent === lowerQuery)
+        return 1;
+    // Score based on frequency and position
+    const words = lowerQuery.split(/\s+/);
+    let matchedWords = 0;
+    for (const word of words) {
+        if (lowerContent.includes(word))
+            matchedWords++;
+    }
+    const wordScore = words.length > 0 ? matchedWords / words.length : 0;
+    // Earlier matches score higher
+    const position = lowerContent.indexOf(lowerQuery);
+    const positionScore = Math.max(0, 1 - position / lowerContent.length);
+    return wordScore * 0.7 + positionScore * 0.3;
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAa,EACb,MAAuB,EACvB,OAOC;IAED,MAAM,MAAM,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IAEpC,6BAA6B;IAC7B,yDAAyD;IACzD,2CAA2C;IAC3C,+CAA+C;IAC/C,gCAAgC;IAChC,mCAAmC;IAEnC,KAAK,KAAK,CAAC;IACX,KAAK,MAAM,CAAC;IACZ,KAAK,OAAO,CAAC;IAEb,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,OAAe;IACvD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAE3C,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,CAAC;IAEjD,iCAAiC;IACjC,IAAI,YAAY,KAAK,UAAU;QAAE,OAAO,CAAC,CAAC;IAE1C,wCAAwC;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,YAAY,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAErE,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEtE,OAAO,SAAS,GAAG,GAAG,GAAG,aAAa,GAAG,GAAG,CAAC;AAC/C,CAAC"}

package/dist/snapshot.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SaveState Snapshot Creation
+ *
+ * Collects state from an adapter, builds the SAF structure,
+ * encrypts it, and stores it in the configured backend.
+ *
+ * Flow:
+ * 1. Adapter extracts current state → Snapshot object
+ * 2. packSnapshot() → file map
+ * 3. packToArchive() → tar.gz buffer
+ * 4. Compute checksum, update manifest with size
+ * 5. Re-pack with updated manifest
+ * 6. encrypt() → encrypted buffer
+ * 7. storage.put() with snapshot filename
+ * 8. Update local index
+ */
+import type { Adapter, Snapshot, StorageBackend } from './types.js';
+export interface CreateSnapshotResult {
+    snapshot: Snapshot;
+    filename: string;
+    archiveSize: number;
+    encryptedSize: number;
+    fileCount: number;
+}
+/**
+ * Create a new snapshot by extracting state from an adapter.
+ *
+ * @param adapter - Platform adapter to extract state from
+ * @param storage - Storage backend to write to
+ * @param passphrase - Encryption passphrase
+ * @param options - Snapshot options (label, tags, etc.)
+ * @returns Details about the created snapshot
+ */
+export declare function createSnapshot(adapter: Adapter, storage: StorageBackend, passphrase: string, options?: {
+    label?: string;
+    tags?: string[];
+    parentId?: string;
+}): Promise<CreateSnapshotResult>;
+/**
+ * Get the latest snapshot ID from the index.
+ */
+export declare function getLatestSnapshotId(): Promise<string | null>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAmB,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYrF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,oBAAoB,CAAC,CAmE/B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIlE"}