@storacha/clawracha 0.1.1 → 0.1.2

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,qBAAqB,CAAC;AAiH7B,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,GAAG,EAAE,iBAAiB,QAkgBpD"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,qBAAqB,CAAC;AAiH7B,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,GAAG,EAAE,iBAAiB,QAgjBpD"}

package/dist/plugin.js

@@ -112,6 +112,7 @@ export default function plugin(api) {
         },
         async stop(ctx) {
             for (const [workspace, sync] of activeSyncers) {
+                sync.engine.stop();
                 await sync.watcher.stop();
                 ctx.logger.info(`[${sync.agentId}] Stopped syncing: ${workspace}`);
             }
@@ -472,5 +473,45 @@ export default function plugin(api) {
                 process.exit(1);
             }
         });
+        // --- inspect ---
+        clawracha
+            .command("inspect")
+            .description("Inspect internal sync state for debugging")
+            .requiredOption("--agent <id>", "Agent ID")
+            .action(async (opts) => {
+            try {
+                const { agentId, workspace } = requireAgent(opts.agent);
+                const deviceConfig = await loadDeviceConfig(workspace);
+                if (!deviceConfig?.agentKey || !deviceConfig.setupComplete) {
+                    console.log(`Not set up. Run \`openclaw clawracha init --agent ${agentId}\` first.`);
+                    return;
+                }
+                // Spin up a temporary engine to inspect state
+                const storachaClient = await createStorachaClient(deviceConfig);
+                const engine = new SyncEngine(storachaClient, workspace);
+                await engine.init(deviceConfig);
+                const state = await engine.inspect();
+                console.log(`🔥 Storacha Inspect [${agentId}]`);
+                console.log(`Workspace: ${workspace}`);
+                console.log(`Running: ${state.running}`);
+                console.log(`Root CID: ${state.root ?? "(none)"}`);
+                console.log(`Revisions: ${state.revisions.length}`);
+                for (const r of state.revisions) {
+                    console.log(`  event: ${r.event}`);
+                }
+                console.log(`\nPail entries (${state.pailKeys.length}):`);
+                for (const key of state.pailKeys) {
+                    console.log(`  ${key}`);
+                }
+                console.log(`\nPending ops (${state.pendingOps.length}):`);
+                for (const op of state.pendingOps) {
+                    console.log(`  ${op.type} ${op.key}${op.value ? ` → ${op.value}` : ""}`);
+                }
+            }
+            catch (err) {
+                console.error(`Error: ${err.message}`);
+                process.exit(1);
+            }
+        });
     }, { commands: ["clawracha"] });
 }

package/dist/sync.d.ts

@@ -46,11 +46,31 @@ export declare class SyncEngine {
      * Apply remote changes to local filesystem
      */
     private applyRemoteChanges;
+    /**
+     * Mark the engine as stopped.
+     */
+    stop(): void;
     /**
      * Pull all remote state and write to local filesystem.
      * Used by /storacha-join to overwrite local with remote before watcher starts.
      */
     pullRemote(): Promise<number>;
+    /**
+     * Inspect internal state for debugging.
+     */
+    inspect(): Promise<{
+        root: string | null;
+        revisions: {
+            event: string;
+        }[];
+        pailKeys: string[];
+        pendingOps: {
+            type: string;
+            key: string;
+            value?: string;
+        }[];
+        running: boolean;
+    }>;
     status(): Promise<SyncState>;
     exportNameArchive(): Promise<string>;
     private storeBlocks;

package/dist/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EAEV,YAAY,EACb,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAMrD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/C;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD3B;;OAEG;YACW,iBAAiB;IAc/B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAc5C;;OAEG;YACW,kBAAkB;IAWhC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IA0B7B,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAW5B,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;YAM5B,WAAW;CAK1B"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EAEV,YAAY,EACb,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAMrD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC/C;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD3B;;OAEG;YACW,iBAAiB;IAc/B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAc5C;;OAEG;YACW,kBAAkB;IAWhC;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IA0BnC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC;QACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC5D,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IAiBI,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAW5B,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;YAM5B,WAAW;CAK1B"}

package/dist/sync.js

@@ -68,6 +68,7 @@ export class SyncEngine {
                 throw err;
             }
         }
+        this.running = true;
     }
     /**
      * Process a batch of file changes
@@ -163,6 +164,12 @@ export class SyncEngine {
             current: this.current ?? undefined,
         });
     }
+    /**
+     * Mark the engine as stopped.
+     */
+    stop() {
+        this.running = false;
+    }
     /**
      * Pull all remote state and write to local filesystem.
      * Used by /storacha-join to overwrite local with remote before watcher starts.
@@ -192,6 +199,25 @@ export class SyncEngine {
         this.lastSync = Date.now();
         return entries.size;
     }
+    /**
+     * Inspect internal state for debugging.
+     */
+    async inspect() {
+        const entries = await this.getPailEntries();
+        return {
+            root: this.current?.root?.toString() ?? null,
+            revisions: this.current?.revision?.map((r) => ({
+                event: r.event.cid.toString(),
+            })) ?? [],
+            pailKeys: [...entries.keys()],
+            pendingOps: this.pendingOps.map((op) => ({
+                type: op.type,
+                key: op.key,
+                value: op.value?.toString(),
+            })),
+            running: this.running,
+        };
+    }
     async status() {
         const entries = await this.getPailEntries();
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storacha/clawracha",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "OpenClaw plugin for Storacha workspace sync via UCN Pail",
   "type": "module",
   "files": [