@savestate/cli 0.4.2 → 0.6.0

package/README.md

@@ -60,12 +60,40 @@ savestate restore latest
 
 | Platform | Extract | Restore | Status |
 |----------|---------|---------|--------|
-| **Clawdbot / Moltbot** | ✅ | ✅ | Available now |
-| **OpenAI Assistants API** | ✅ | ✅ | Coming soon |
-| **Custom file-based agents** | ✅ | ✅ | Coming soon |
-| **ChatGPT** | ✅ | ⚠️ Partial | Planned |
-| **Claude** | ✅ | ⚠️ Partial | Planned |
-| **Gemini** | ✅ | ⚠️ Limited | Planned |
+| **OpenClaw / Clawdbot / Moltbot** | ✅ | ✅ | **Full support** |
+| **OpenAI Assistants API** | ✅ | ✅ | Available |
+| **Claude Code** | ✅ | ✅ | Available |
+| **ChatGPT** | ✅ | ⚠️ Partial | Available |
+| **Claude (consumer)** | ✅ | ⚠️ Partial | Available |
+| **Gemini** | ✅ | ⚠️ Limited | Available |
+
+### OpenClaw Full Backup (v0.3.0+)
+
+The OpenClaw adapter captures your **complete agent state**:
+
+| Component | What's Captured |
+|-----------|-----------------|
+| **Identity** | SOUL.md, USER.md, AGENTS.md, TOOLS.md, IDENTITY.md |
+| **Memory** | MEMORY.md, memory/*.md, memory SQLite databases |
+| **Skills** | All SKILL.md files + scripts |
+| **Scripts** | personal-scripts/, cron-wrappers/ |
+| **Extensions** | Extension configs |
+| **Conversations** | All session JSONL files (1000+ sessions) |
+| **Gateway Config** | openclaw.json (agent defs, models, routing) |
+| **Cron Jobs** | Scheduled tasks and behaviors |
+| **Channel State** | Telegram offsets, message continuity |
+| **Device Identity** | Device pairing, node relationships |
+
+```bash
+# Full backup including semantic memory DBs
+savestate snapshot
+
+# Include credentials (channel auth tokens)
+savestate snapshot --include-credentials
+
+# Backup specific agent only
+savestate snapshot --agent-id main
+```
 
 Community adapters welcome! See [Contributing](#contributing).
 

package/dist/adapters/clawdbot.d.ts

@@ -1,93 +1,104 @@
 /**
- * Clawdbot Adapter
+ * Clawdbot / OpenClaw Adapter
  *
- * First-party adapter for Clawdbot / Moltbot workspaces.
- * Reads SOUL.md, MEMORY.md, memory/, USER.md, TOOLS.md,
- * skills/, personal-scripts/, extensions/, conversation logs,
- * cron wrappers, and config files.
+ * First-party adapter for Clawdbot / Moltbot / OpenClaw workspaces.
  *
- * This is the dogfood adapter — SaveState eats its own cooking.
+ * Captures:
+ *   Workspace: SOUL.md, MEMORY.md, memory/, USER.md, TOOLS.md, AGENTS.md
+ *   Skills: SKILL.md + scripts per skill
+ *   Personal scripts: personal-scripts/, cron-wrappers/
+ *   Extensions: extension configs
+ *   Conversations: session JSONL files
+ *
+ * NEW in v0.3.0 - Full OpenClaw runtime state:
+ *   Gateway config: openclaw.json (agent defs, model config, routing)
+ *   Cron jobs: cron/jobs.json (scheduled behaviors)
+ *   Credentials: channel auth, OAuth tokens
+ *   Device identity: device pairing
+ *   Paired nodes: mobile node pairing
+ *   Memory databases: SQLite semantic memory
+ *   Channel state: telegram offsets, whatsapp session, etc.
+ *
+ * This is the dogfood adapter - SaveState eats its own cooking.
  */
 import type { Adapter, PlatformMeta, Snapshot } from '../types.js';
+export interface OpenClawState {
+    /** Gateway configuration (openclaw.json) */
+    gatewayConfig?: string;
+    /** Cron jobs configuration */
+    cronJobs?: string;
+    /** Device identity */
+    deviceIdentity?: Record<string, string>;
+    /** Paired nodes */
+    pairedNodes?: Record<string, string>;
+    /** Channel credentials (redacted by default) */
+    credentials?: Record<string, string>;
+    /** Channel state (telegram offsets, etc.) */
+    channelState?: Record<string, string>;
+    /** Memory database paths (for binary backup) */
+    memoryDatabases?: MemoryDatabaseEntry[];
+}
+export interface MemoryDatabaseEntry {
+    /** Agent ID this database belongs to */
+    agentId: string;
+    /** Relative path within archive */
+    archivePath: string;
+    /** Original file path */
+    sourcePath: string;
+    /** Size in bytes */
+    size: number;
+    /** SHA-256 checksum */
+    checksum: string;
+}
+export interface ClawdbotAdapterOptions {
+    /** Include credentials in backup (default: false for security) */
+    includeCredentials?: boolean;
+    /** Include memory SQLite databases (default: true, but large!) */
+    includeMemoryDatabases?: boolean;
+    /** Redact API keys from gateway config (default: true) */
+    redactSecrets?: boolean;
+    /** Specific agent ID to backup (default: all agents) */
+    agentId?: string;
+}
 export declare class ClawdbotAdapter implements Adapter {
     readonly id = "clawdbot";
-    readonly name = "Clawdbot";
-    readonly platform = "clawdbot";
-    readonly version = "0.2.0";
+    readonly name = "OpenClaw";
+    readonly platform = "openclaw";
+    readonly version = "0.3.0";
     private readonly workspaceDir;
+    private readonly options;
     private warnings;
-    constructor(workspaceDir?: string);
+    constructor(workspaceDir?: string, options?: ClawdbotAdapterOptions);
     detect(): Promise<boolean>;
     extract(): Promise<Snapshot>;
     restore(snapshot: Snapshot): Promise<void>;
     identify(): Promise<PlatformMeta>;
-    /**
-     * Check if a file should be skipped (binary or too large).
-     */
+    private findOpenClawConfigDir;
+    private readOpenClawState;
+    private readDirectoryFiles;
+    private indexMemoryDatabases;
+    private redactSensitiveData;
+    private redactObject;
+    private restoreOpenClawState;
     private isBinary;
     private checkFileSize;
     private safeReadFile;
     private readIdentity;
     private readMemory;
     private readConversations;
-    /**
-     * Read skills/ directory — capture SKILL.md and scripts/ for each skill.
-     */
     private readSkills;
-    /**
-     * Read personal-scripts/ and personal-scripts/cron-wrappers/
-     */
     private readScripts;
-    /**
-     * Read extensions/ directory configs (skip node_modules and binary files).
-     */
     private readExtensions;
-    /**
-     * Read config files from workspace root.
-     */
     private readConfigFiles;
-    /**
-     * Build knowledge documents index from skills and scripts.
-     */
     private buildKnowledgeIndex;
-    private readJsonSafe;
-    /**
-     * Walk a directory recursively and return file paths matching optional extensions.
-     */
     private walkDir;
-    /**
-     * Parse concatenated personality back into individual files and write them.
-     * Files are joined with `--- FILENAME ---` markers.
-     */
     private restoreIdentity;
-    /**
-     * Parse the concatenated personality string into individual files.
-     * Format: `--- FILENAME ---\ncontent\n\n--- NEXTFILE ---\ncontent`
-     */
     private parsePersonality;
-    /**
-     * Restore memory entries back to their source files.
-     */
     private restoreMemory;
-    /**
-     * Restore skills back to skills/ directory.
-     */
     private restoreSkills;
-    /**
-     * Restore personal scripts.
-     */
     private restoreScripts;
-    /**
-     * Restore extension configs.
-     */
     private restoreExtensions;
-    /**
-     * Restore config files to workspace root.
-     */
     private restoreConfigFiles;
-    /**
-     * Create a .bak backup of an existing file before overwriting.
-     */
     private backupFile;
 }
 //# sourceMappingURL=clawdbot.d.ts.map

package/dist/adapters/clawdbot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clawdbot.d.ts","sourceRoot":"","sources":["../../src/adapters/clawdbot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,QAAQ,EAOT,MAAM,aAAa,CAAC;AAqCrB,qBAAa,eAAgB,YAAW,OAAO;IAC7C,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,QAAQ,cAAc;IAC/B,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,YAAY,CAAC,EAAE,MAAM;IAI3B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAW1B,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;IAwF5B,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B1C,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAoBvC;;OAEG;IACH,OAAO,CAAC,QAAQ;YAMF,aAAa;YAab,YAAY;YAcZ,YAAY;YAcZ,UAAU;YA8CV,iBAAiB;IAoD/B;;OAEG;YACW,UAAU;IAoExB;;OAEG;YACW,WAAW;IAsBzB;;OAEG;YACW,cAAc;IA2C5B;;OAEG;YACW,eAAe;IAyB7B;;OAEG;YACW,mBAAmB;YAmCnB,YAAY;IAS1B;;OAEG;YACW,OAAO;IA2BrB;;;OAGG;YACW,eAAe;IAe7B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;YACW,aAAa;IAe3B;;OAEG;YACW,aAAa;IAc3B;;OAEG;YACW,cAAc;IAS5B;;OAEG;YACW,iBAAiB;IAa/B;;OAEG;YACW,kBAAkB;IAUhC;;OAEG;YACW,UAAU;CAUzB"}
+{"version":3,"file":"clawdbot.d.ts","sourceRoot":"","sources":["../../src/adapters/clawdbot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,QAAQ,EAOT,MAAM,aAAa,CAAC;AAKrB,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gDAAgD;IAChD,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA8CD,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kEAAkE;IAClE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAgB,YAAW,OAAO;IAC7C,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,QAAQ,cAAc;IAC/B,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAU7D,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAe1B,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;IAuH5B,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC1C,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IA8BvC,OAAO,CAAC,qBAAqB;YAYf,iBAAiB;YAqFjB,kBAAkB;YAwBlB,oBAAoB;IAmClC,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,YAAY;YAyBN,oBAAoB;IAiFlC,OAAO,CAAC,QAAQ;YAMF,aAAa;YAab,YAAY;YAcZ,YAAY;YAcZ,UAAU;YA8CV,iBAAiB;YA8DjB,UAAU;YAmEV,WAAW;YAsBX,cAAc;YA0Cd,eAAe;YAwBf,mBAAmB;YAmCnB,OAAO;YA2BP,eAAe;IAW7B,OAAO,CAAC,gBAAgB;YAoBV,aAAa;YASb,aAAa;YAcb,cAAc;YASd,iBAAiB;YAajB,kBAAkB;YAUlB,UAAU;CAUzB"}