@masons/agent-network 0.4.3 → 0.4.5

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAwCH,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B;AAED,UAAU,OAAO;IACf,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACzE;AAoCD,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAsFD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAsyBhD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAyCH,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B;AAED,UAAU,OAAO;IACf,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACzE;AAyCD,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAsFD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAwyBhD"}

package/dist/tools.js

@@ -18,6 +18,7 @@
  * - `masons_create_session` — DEPRECATED SHIM (one release cycle)
  * - `masons_end_session` — DEPRECATED SHIM (one release cycle)
  */
+import { tmpdir } from "node:os";
 import { Type } from "@sinclair/typebox";
 import { clearTargetHandle, getOpenClawHome, getPendingTarget, markProfileComplete, markProfileNeeded, requireApiKey, requireConversationManager, requirePlatformConfig, writeCredentials, } from "./config.js";
 import { acceptRequest, declineRequest, getConnectionStatus, initSetup, listConnections, listRequests, onboard, PlatformApiError, pollSetup, reconnect, requestConnection, SetupExpiredError, SetupPendingError, updateProfile, } from "./platform-client.js";
@@ -29,8 +30,13 @@ import { fetchLatestVersion, getPluginVersion, getUpdateInfo, } from "./update-c
 const PROFILE_FIELDS = new Set(["name", "scope", "about", "audience"]);
 /** CLI command to update the plugin via OpenClaw. */
 const UPGRADE_CMD = "openclaw plugins update agent-network";
-/** Fallback: remove + fresh install. `{version}` is replaced at runtime. */
-const FALLBACK_UPGRADE_CMD = "rm -rf {home}/extensions/agent-network && openclaw plugins install @masons/agent-network@{version}";
+/** Fallback: manual update via npm pack + in-place extract. Bypasses OpenClaw's
+ *  broken version detection while preserving credentials and node_modules.
+ *  Placeholders `{version}`, `{home}`, and `{tmpdir}` are replaced at runtime. */
+const FALLBACK_UPGRADE_CMD = "npm pack @masons/agent-network@{version} --pack-destination {tmpdir} && " +
+    "tar xzf {tmpdir}/masons-agent-network-{version}.tgz --strip-components=1 -C {home}/extensions/agent-network/ && " +
+    "cd {home}/extensions/agent-network && npm install --omit=dev && " +
+    "rm -f {tmpdir}/masons-agent-network-{version}.tgz";
 /** CLI command to restart the gateway. */
 const GATEWAY_RESTART_CMD = "openclaw gateway restart";
 /** Simple semver regex — validates x.y.z before inserting into shell commands. */
@@ -673,9 +679,11 @@ export function registerTools(api) {
                 // Fallback path — previous normal-path attempt for this version didn't work.
                 upgradeAttemptedVersion = null; // Reset so next call starts fresh
                 const home = getOpenClawHome();
-                const fallbackCmd = FALLBACK_UPGRADE_CMD.replace("{home}", home).replace("{version}", latestVersion);
+                const fallbackCmd = FALLBACK_UPGRADE_CMD.replaceAll("{tmpdir}", tmpdir())
+                    .replaceAll("{home}", home)
+                    .replaceAll("{version}", latestVersion);
                 return textResult([
-                    `Update to v${latestVersion} — using alternative method (previous attempt may have failed).`,
+                    `Update to v${latestVersion} — manual update (the automatic update command may not have detected the new version).`,
                     "",
                     "Run this command using the exec tool:",
                     fallbackCmd,

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.3";
+export declare const PLUGIN_VERSION = "0.4.5";
 //# 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.3";
+export const PLUGIN_VERSION = "0.4.5";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "MASONS plugin for OpenClaw — connect your agent to the agent network",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",

package/skills/agent-network/SKILL.md

@@ -48,6 +48,7 @@ Check your current state and go to the right section:
 - **Already connected, no pending actions** → You're ready. Use the network tools (masons_*) when the user asks about agent communication, connections, or messages. No action needed until then.
 - **Update available** (tool output mentions an update) → Go to **Upgrade** below
 - **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`
 - **Errors or troubleshooting** → Read `references/troubleshooting.md`
 

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

@@ -1,5 +1,25 @@
 # Troubleshooting
 
+## Installation Failed
+
+If `openclaw plugins install @masons/agent-network` fails (e.g., "Invalid path", "plugin already exists", or any other error), the most common cause is **residual files from a previous install or failed upgrade attempt**.
+
+### Fix: Clean residuals and retry
+
+1. Remove the extension directory. Tell the user to run:
+   ```
+   rm -rf ~/.openclaw/extensions/agent-network/
+   ```
+2. Check `~/.openclaw/openclaw.json` using your file tools. Remove stale references:
+   - `plugins.entries.agent-network` (if present)
+   - `plugins.installs.agent-network` (if present)
+   - `channels.agent-network` (if present)
+3. Retry the install: `openclaw plugins install @masons/agent-network`
+4. After install, restart using the `gateway` tool: `{ action: "restart", reason: "Load agent-network plugin", note: "Plugin installed. Ready for setup." }`
+5. **Fallback**: If the `gateway` tool is not available, tell the user to run `openclaw gateway restart` from their Terminal.
+
+After restart, go through the Setup flow in the main skill.
+
 ## Connection Lost
 
 If you see "disconnected" events, the channel will automatically attempt to reconnect. This is normal during brief network interruptions.