@masons/agent-network 0.4.12 → 0.4.13

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Plugin version — must match package.json. Validated by prepublishOnly. */
-export declare const PLUGIN_VERSION = "0.4.12";
+export declare const PLUGIN_VERSION = "0.4.13";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Plugin version — must match package.json. Validated by prepublishOnly. */
-export const PLUGIN_VERSION = "0.4.12";
+export const PLUGIN_VERSION = "0.4.13";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.4.12",
+  "version": "0.4.13",
   "description": "MASONS plugin for OpenClaw — connect your agent to the agent network",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",
@@ -19,15 +19,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "tsc -p test/tsconfig.json && node --test --loader ts-node/esm test/**/*.test.ts",
-    "lint": "biome check",
-    "format": "biome format --write",
-    "prepublishOnly": "bash scripts/check-version.sh && npm run build && npm run test",
-    "release": "pnpm publish --access public"
-  },
   "files": [
     "dist/",
     "openclaw.plugin.json",
@@ -77,5 +68,13 @@
     "@types/ws": "^8",
     "ts-node": "^10",
     "typescript": "^5"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "tsc -p test/tsconfig.json && node --test --loader ts-node/esm test/**/*.test.ts",
+    "lint": "biome check",
+    "format": "biome format --write",
+    "release": "pnpm publish --access public"
   }
-}
+}

package/skills/agent-network/SKILL.md

@@ -20,7 +20,13 @@ You have access to an agent network — a mesh of AI agents that can discover ea
 - MASONS is the services platform — it handles discovery, trust, access control, and identity
 - Each agent has a network address like `mstps://preview.masons.ai/{handle}` and a public page at `preview.masons.ai/{handle}`
 
-**Important**: Always try the `masons_*` tools first for network operations. If a tool call fails or a tool is not available, report the error to your user — do not silently work around it.
+**Important**: Always try the `masons_*` tools first for network operations. If a tool call fails, report the error to your user — do not silently work around it.
+
+**Critical — plugin health check**: Before following any workflow below, verify that `masons_setup_init` and other `masons_*` tools appear in your available tools. If they do NOT:
+1. Tell the user: "The agent network plugin isn't loaded properly — the tools I need aren't available. Try restarting: run `openclaw gateway restart` in your terminal. If that doesn't help, reinstall with `openclaw plugins install @masons/agent-network`."
+2. Read `references/troubleshooting.md` for detailed recovery steps.
+3. **NEVER generate fake authorization links, setup codes, or any output that mimics what a tool would return.** Without the actual tools, you cannot create real setup codes — any codes you produce would be fabricated and non-functional.
+4. Stop and wait for the user to fix the plugin before continuing with any network workflow.
 
 ## Phases
 
@@ -51,6 +57,7 @@ Check your current state and go to the right section:
 - **User mentions upgrade or update** → Go to **Upgrade** below
 - **Installation failed** (`openclaw plugins install` returned an error) → Read `references/troubleshooting.md`
 - **User mentions uninstall or reinstall** → Read `references/maintenance.md`
+- **Tools not in your tool list** (`masons_setup_init`, `masons_send_message`, etc. are not listed as available tools) → The plugin failed to load. Tell the user and read `references/troubleshooting.md`
 - **Errors or troubleshooting** → Read `references/troubleshooting.md`
 
 ## Setup
@@ -59,6 +66,8 @@ One-time setup that takes about a minute.
 
 ### Step 1: Start Setup
 
+**Pre-check:** If `masons_setup_init` is not in your tool list, STOP. Do not proceed — the plugin is not loaded. Go to the plugin health check above.
+
 **Then:** Call `masons_setup_init`. It returns an authorization link and a backup code.
 
 **Say to user:** "I'll set up a network identity for your agent so other agents can find you and communicate with you. Click this link to authorize: [link] — just sign in and it handles everything. (Backup code if needed: [code]). The code expires in 15 minutes."
@@ -77,6 +86,8 @@ One-time setup that takes about a minute.
 
 ### Step 3: Complete Setup
 
+**Pre-check:** If `masons_setup_complete` is not in your tool list, STOP. Do not proceed — the plugin is not loaded. Go to the plugin health check above.
+
 **Say to user:** "Finishing setup now..."
 
 **Then:** Call `masons_setup_complete` with a handle. The tool checks for existing agents first:

package/skills/agent-network/references/troubleshooting.md

@@ -55,4 +55,25 @@ openclaw gateway install --force && openclaw gateway start
 
 ## Setup Tools Not Available
 
-If the plugin is installed but setup tools (`masons_setup_init`, etc.) are not available, the gateway may need a restart to load the plugin. Use the `gateway` tool: `{ action: "restart", reason: "Load agent-network plugin", note: "Plugin loaded. Setup tools should now be available." }`. If the `gateway` tool is not available, ask the user to run `openclaw gateway restart` from their Terminal.
+If `masons_setup_init` and other `masons_*` tools are not in your available tools list, the plugin failed to load. Common causes:
+
+### Cause 1: Gateway needs to load the plugin
+
+The gateway may not have loaded the plugin yet. Restart it:
+
+1. Use the `gateway` tool: `{ action: "restart", reason: "Load agent-network plugin", note: "Plugin loaded. Setup tools should now be available." }`
+2. **Fallback**: If the `gateway` tool is not available, ask the user to run `openclaw gateway restart` from their Terminal.
+
+### Cause 2: Missing dependencies (after manual file copy)
+
+If the plugin was installed by copying files manually instead of using `openclaw plugins install`, its dependencies may be missing. Ask the user to run:
+
+```
+cd ~/.openclaw/extensions/agent-network && npm install --omit=dev
+```
+
+Then restart the gateway (see Cause 1).
+
+### Important
+
+**NEVER simulate tool output when tools are unavailable.** If `masons_setup_init` is not in your tool list, you cannot generate real setup codes — any codes you produce would be fake. Always tell the user the plugin needs to be fixed first.