@storacha/clawracha 0.0.7 → 0.0.8

package/README.md

@@ -23,21 +23,31 @@ openclaw plugins install @storacha/clawracha
 
 Setup is done via slash commands in your chat session with the agent (not CLI commands).
 
-### New workspace (first device)
+### Step 1: Initialize the agent
 
 ```
-/storacha-init <upload-delegation-b64>
+/storacha-init
 ```
 
-Creates a fresh workspace with a new UCN Name. You'll need an upload delegation from a Storacha space owner.
+Generates an agent identity and displays the Agent DID. You'll need this DID to create delegations.
 
-### Join an existing workspace (additional devices)
+### Step 2: Choose your path
+
+**New workspace (first device):**
+
+```
+/storacha-setup <upload-delegation-b64>
+```
+
+Have the space owner create an upload delegation for your Agent DID, then import it. Creates a fresh UCN Name and starts syncing.
+
+**Join an existing workspace (additional devices):**
 
 ```
 /storacha-join <upload-delegation-b64> <name-delegation-b64>
 ```
 
-Joins an existing workspace from another device. Both delegations are required — get them by running `/storacha-grant` on the existing device. The join command pulls all remote files before the watcher starts, so your local workspace is fully synced from the start.
+Get both delegations by running `/storacha-grant` on the existing device. The join command pulls all remote files before the watcher starts, so your local workspace is fully synced from the start.
 
 ### Grant access to another device
 

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,qBAAqB,CAAC;AAwC7B;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,GAAG,EAAE,iBAAiB,QA6apD"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,qBAAqB,CAAC;AAwC7B;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,GAAG,EAAE,iBAAiB,QAyepD"}

package/dist/plugin.js

@@ -62,7 +62,7 @@ export default function plugin(api) {
             }
             const deviceConfig = await loadDeviceConfig(workspace);
             if (!deviceConfig || !deviceConfig.setupComplete) {
-                ctx.logger.info("Setup not complete. Run /storacha-init or /storacha-join first.");
+                ctx.logger.info("Setup not complete. Run /storacha-init first, then /storacha-setup or /storacha-join.");
                 return;
             }
             const storachaClient = await createStorachaClient(deviceConfig);
@@ -114,7 +114,7 @@ export default function plugin(api) {
                     content: [
                         {
                             type: "text",
-                            text: "Sync not initialized. Run /storacha-init or /storacha-join first.",
+                            text: "Sync not initialized. Run /storacha-init first, then /storacha-setup or /storacha-join.",
                         },
                     ],
                     details: null,
@@ -140,7 +140,7 @@ export default function plugin(api) {
                     content: [
                         {
                             type: "text",
-                            text: "Sync not initialized. Run /storacha-init or /storacha-join first.",
+                            text: "Sync not initialized. Run /storacha-init first, then /storacha-setup or /storacha-join.",
                         },
                     ],
                     details: null,
@@ -162,19 +162,72 @@ export default function plugin(api) {
     // --- Slash Commands ---
     api.registerCommand({
         name: "storacha-init",
-        description: "Initialize a NEW Storacha workspace (first device). Usage: /storacha-init <upload-delegation-b64>",
+        description: "Generate an agent identity for Storacha sync",
+        handler: async (_ctx) => {
+            const workspace = workspaceDir;
+            if (!workspace)
+                return { text: "No workspace configured." };
+            // Check if already initialized
+            const existing = await loadDeviceConfig(workspace);
+            if (existing?.agentKey) {
+                const { Agent } = await import("@storacha/ucn/pail");
+                const agent = Agent.parse(existing.agentKey);
+                return {
+                    text: [
+                        "Agent already initialized.",
+                        `Agent DID: \`${agent.did()}\``,
+                        "",
+                        existing.setupComplete
+                            ? "Setup is complete. Use `/storacha-status` to check sync state."
+                            : "**Next step — choose one:**",
+                        ...(!existing.setupComplete
+                            ? [
+                                "- **New workspace:** Have the space owner create an upload delegation for this DID, then run `/storacha-setup <upload-b64>`",
+                                "- **Join existing:** Have the other device run `/storacha-grant <this-DID>`, then run `/storacha-join <upload-b64> <name-b64>`",
+                            ]
+                            : []),
+                    ].join("\n"),
+                };
+            }
+            const { Agent } = await import("@storacha/ucn/pail");
+            const agent = await Agent.generate();
+            const agentKey = Agent.format(agent);
+            const config = { agentKey };
+            await saveDeviceConfig(workspace, config);
+            return {
+                text: [
+                    "\u{1f525} Agent initialized!",
+                    `Agent DID: \`${agent.did()}\``,
+                    "",
+                    "**Next step \u2014 choose one:**",
+                    "- **New workspace:** Have the space owner create an upload delegation for this DID, then run `/storacha-setup <upload-b64>`",
+                    "- **Join existing workspace:** Have the other device run `/storacha-grant <this-DID>`, then run `/storacha-join <upload-b64> <name-b64>`",
+                ].join("\n"),
+            };
+        },
+    });
+    api.registerCommand({
+        name: "storacha-setup",
+        description: "Set up a NEW Storacha workspace (first device). Usage: /storacha-setup <upload-delegation-b64>",
         acceptsArgs: true,
         handler: async (_ctx) => {
             const workspace = workspaceDir;
             if (!workspace)
                 return { text: "No workspace configured." };
+            const config = await loadDeviceConfig(workspace);
+            if (!config?.agentKey) {
+                return { text: "Run `/storacha-init` first to generate an agent identity." };
+            }
+            if (config.setupComplete) {
+                return { text: "Setup already complete. Use `/storacha-status` to check sync state." };
+            }
             const b64 = _ctx.args?.trim();
             if (!b64) {
                 return {
                     text: [
-                        "Usage: `/storacha-init <upload-delegation-b64>`",
+                        "Usage: `/storacha-setup <upload-delegation-b64>`",
                         "",
-                        "This creates a **new** workspace. If you're syncing from an existing device, use `/storacha-join` instead.",
+                        "This creates a **new** workspace. If you're joining an existing workspace, use `/storacha-join` instead.",
                     ].join("\n"),
                 };
             }
@@ -184,20 +237,16 @@ export default function plugin(api) {
             if (!delegation) {
                 return { text: `Invalid delegation: ${error}` };
             }
-            const { Agent } = await import("@storacha/ucn/pail");
-            const agent = await Agent.generate();
-            const agentKey = Agent.format(agent);
             const spaceDID = delegation.capabilities[0]?.with;
-            const config = {
-                agentKey,
-                uploadDelegation: b64,
-                spaceDID: spaceDID ?? undefined,
-                setupComplete: true,
-            };
+            config.uploadDelegation = b64;
+            config.spaceDID = spaceDID ?? undefined;
+            config.setupComplete = true;
             await saveDeviceConfig(workspace, config);
+            const { Agent } = await import("@storacha/ucn/pail");
+            const agent = Agent.parse(config.agentKey);
             return {
                 text: [
-                    "\u{1f525} Storacha workspace initialized!",
+                    "\u{1f525} Storacha workspace ready!",
                     `Agent DID: \`${agent.did()}\``,
                     `Space: \`${spaceDID ?? "unknown"}\``,
                     "",
@@ -211,7 +260,7 @@ export default function plugin(api) {
     });
     api.registerCommand({
         name: "storacha-join",
-        description: "Join an existing Storacha workspace from another device. Usage: /storacha-join <upload-delegation-b64> <name-delegation-b64>",
+        description: "Join an existing Storacha workspace from another device. Run /storacha-init first. Usage: /storacha-join <upload-delegation-b64> <name-delegation-b64>",
         acceptsArgs: true,
         handler: async (_ctx) => {
             const workspace = workspaceDir;
@@ -224,7 +273,7 @@ export default function plugin(api) {
                         "Usage: `/storacha-join <upload-delegation-b64> <name-delegation-b64>`",
                         "",
                         "Get both delegations by running `/storacha-grant` on the existing device.",
-                        "If you're setting up a **new** workspace, use `/storacha-init` instead.",
+                        "If you're setting up a **new** workspace, use `/storacha-setup` instead.",
                     ].join("\n"),
                 };
             }
@@ -253,17 +302,20 @@ export default function plugin(api) {
             if (!nameDelegation) {
                 return { text: `Invalid name delegation: ${nameErr}` };
             }
+            const config = await loadDeviceConfig(workspace);
+            if (!config?.agentKey) {
+                return { text: "Run `/storacha-init` first to generate an agent identity." };
+            }
+            if (config.setupComplete) {
+                return { text: "Setup already complete. Use `/storacha-status` to check sync state." };
+            }
             const { Agent } = await import("@storacha/ucn/pail");
-            const agent = await Agent.generate();
-            const agentKey = Agent.format(agent);
+            const agent = Agent.parse(config.agentKey);
             const spaceDID = uploadDelegation.capabilities[0]?.with;
-            const config = {
-                agentKey,
-                uploadDelegation: uploadB64,
-                nameDelegation: nameB64,
-                spaceDID: spaceDID ?? undefined,
-                setupComplete: true,
-            };
+            config.uploadDelegation = uploadB64;
+            config.nameDelegation = nameB64;
+            config.spaceDID = spaceDID ?? undefined;
+            config.setupComplete = true;
             await saveDeviceConfig(workspace, config);
             // Pull remote state immediately before watcher starts
             let pullCount = 0;
@@ -314,7 +366,7 @@ export default function plugin(api) {
             const config = await loadDeviceConfig(workspace);
             if (!config) {
                 return {
-                    text: "Not initialized. Run `/storacha-init` or `/storacha-join` first.",
+                    text: "Not initialized. Run `/storacha-init` first.",
                 };
             }
             const results = [];
@@ -403,7 +455,7 @@ export default function plugin(api) {
             const config = await loadDeviceConfig(workspace);
             if (!config)
                 return {
-                    text: "Not initialized. Run /storacha-init or /storacha-join first.",
+                    text: "Not initialized. Run `/storacha-init` first.",
                 };
             const lines = [
                 "\u{1f525} Storacha Sync Status",

package/package.json

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