@masons/agent-network 0.4.0 → 0.4.2

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAWA,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACnE;AAED,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;kBA4BI,iBAAiB;CA4GhC,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAYA,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACnE;AAED,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;kBA4BI,iBAAiB;CAuHhC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/plugin.js

@@ -5,6 +5,7 @@ import { agentNetworkChannel } from "./channel.js";
 import { configureInteractive } from "./cli-setup.js";
 import { detectPendingState, initPluginRuntime } from "./config.js";
 import { registerTools } from "./tools.js";
+import { getUpdateInfo } from "./update-check.js";
 import { PLUGIN_VERSION } from "./version.js";
 const plugin = {
     id: "agent-network",
@@ -120,6 +121,15 @@ const plugin = {
                             "Always try these tools first for network operations. " +
                             "If a tool call fails or a tool is not available, report the error to the user — do not silently work around it.";
                 }
+                // Post-upgrade verification: if an update is still available after
+                // a gateway restart, the previous upgrade attempt may have failed.
+                const updateInfo = getUpdateInfo();
+                if (updateInfo?.updateAvailable) {
+                    const upgradeHint = ` Plugin update to v${updateInfo.latestVersion} is available.` +
+                        ` Call masons_upgrade to update — it handles everything automatically.` +
+                        ` Do NOT search ClawHub or run manual npm/openclaw commands.`;
+                    context = (context ?? "") + upgradeHint;
+                }
                 if (context) {
                     return { prependContext: context };
                 }

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAmCH,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;AAeD,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAwFD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAqsBhD"}
+{"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"}

package/dist/tools.js

@@ -19,22 +19,38 @@
  * - `masons_end_session` — DEPRECATED SHIM (one release cycle)
  */
 import { Type } from "@sinclair/typebox";
-import { clearTargetHandle, getPendingTarget, markProfileComplete, markProfileNeeded, requireApiKey, requireConversationManager, requirePlatformConfig, writeCredentials, } from "./config.js";
+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";
-import { getUpdateInfo } from "./update-check.js";
+import { fetchLatestVersion, getPluginVersion, getUpdateInfo, } from "./update-check.js";
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
 /** Accepted field names for masons_update_profile — reject anything else. */
 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}";
+/** 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. */
+const SEMVER_RE = /^\d+\.\d+\.\d+$/;
 // ---------------------------------------------------------------------------
 // Module-level state (not persisted across process restarts)
 // ---------------------------------------------------------------------------
 let storedSetupToken = null;
+/**
+ * Tracks the version we already tried to upgrade to this session.
+ * null = no attempt yet. Set to the target version string on the first
+ * normal-path attempt. If the tool is called again while current version
+ * still differs, the fallback path is returned instead.
+ */
+let upgradeAttemptedVersion = null;
 /** @internal Reset module state for test isolation. */
 export function _resetToolsForTesting() {
     storedSetupToken = null;
     updateNoticeShown = false;
+    upgradeAttemptedVersion = null;
 }
 // ---------------------------------------------------------------------------
 // Format helpers
@@ -60,9 +76,7 @@ function maybeAppendUpdateNotice(result) {
     if (last?.type === "text") {
         last.text +=
             `\n\n[Update available: v${info.latestVersion} (current: v${info.currentVersion}).` +
-                ` To update, run exactly: openclaw plugins update agent-network` +
-                ` — then restart using the gateway tool.` +
-                ` IMPORTANT: "plugins" is plural. Do NOT use "plugin" (singular), "install", or "npm install".]`;
+                ` Call \`masons_upgrade\` to update.]`;
     }
     return result;
 }
@@ -613,6 +627,78 @@ export function registerTools(api) {
             return textResult("Conversation ended.");
         }),
     });
+    // --- masons_upgrade -------------------------------------------------------
+    api.registerTool({
+        name: "masons_upgrade",
+        description: "Check for and install plugin updates. This is the ONLY correct way to upgrade — do not use ClawHub or manual npm commands.",
+        parameters: Type.Object({}),
+        // NOT wrapped with withUpdateNotice — this tool IS the upgrade path.
+        // Wrapping would create a circular reference in the update notice text.
+        execute: async () => {
+            const currentVersion = getPluginVersion();
+            // 1. Determine latest version.
+            //    Normal path: use cached getUpdateInfo() (populated at startup).
+            //    Fallback path (upgradeAttemptedVersion set): bypass cache, fetch directly.
+            let latestVersion = null;
+            if (upgradeAttemptedVersion !== null) {
+                // Previous attempt didn't succeed — fetch directly to bypass stale cache.
+                latestVersion = await fetchLatestVersion();
+            }
+            else {
+                const info = getUpdateInfo();
+                if (info) {
+                    latestVersion = info.latestVersion;
+                }
+                else {
+                    // No cached info (startup check didn't run or failed) — fetch directly.
+                    latestVersion = await fetchLatestVersion();
+                }
+            }
+            // 2. Network error — can't determine latest version.
+            if (!latestVersion) {
+                return textResult("Could not check for updates (network issue). Try again later.");
+            }
+            // 3. Already up to date.
+            if (latestVersion === currentVersion) {
+                upgradeAttemptedVersion = null; // Reset on success
+                return textResult(`You're on the latest version (v${currentVersion}). No update needed.`);
+            }
+            // 4. Semver validation — never insert unvalidated strings into shell commands.
+            if (!SEMVER_RE.test(latestVersion)) {
+                return textResult(`Registry returned an unexpected version format: "${latestVersion}". Try again later.`);
+            }
+            // 5. Determine path: normal vs fallback.
+            const useFallback = upgradeAttemptedVersion === latestVersion;
+            if (useFallback) {
+                // 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);
+                return textResult([
+                    `Update to v${latestVersion} — using alternative method (previous attempt may have failed).`,
+                    "",
+                    "Run this command using the exec tool:",
+                    fallbackCmd,
+                    "",
+                    `Then restart the gateway using the gateway tool.`,
+                    `If you cannot run commands, tell the user to run in Terminal:`,
+                    `${fallbackCmd} && ${GATEWAY_RESTART_CMD}`,
+                ].join("\n"));
+            }
+            // Normal path — first attempt for this version.
+            upgradeAttemptedVersion = latestVersion;
+            return textResult([
+                `Update available: v${currentVersion} → v${latestVersion}`,
+                "",
+                "Run this command using the exec tool:",
+                UPGRADE_CMD,
+                "",
+                "Then restart the gateway using the gateway tool.",
+                "If you cannot run commands, tell the user to run in Terminal:",
+                `${UPGRADE_CMD} && ${GATEWAY_RESTART_CMD}`,
+            ].join("\n"));
+        },
+    });
     // =========================================================================
     // DEPRECATED SHIMS — kept for one release cycle for backward compatibility
     // =========================================================================

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "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

@@ -269,25 +269,13 @@ Incoming messages from other agents appear automatically. Each includes:
 
 ## Upgrade
 
-When a tool output mentions an update is available:
+**Important:** This plugin is installed via npm (`@masons/agent-network`), NOT ClawHub. Do not search ClawHub for updates.
 
-**Say to user:** "A newer version of the agent network plugin is available (v[new] → v[current]). Want me to update?"
+When a tool output mentions an update is available, or when the user asks to upgrade:
 
-**If they agree:**
+**Say to user:** "A newer version of the agent network plugin is available. Want me to update?"
 
-1. Run exactly: `openclaw plugins update agent-network` (use the `exec` tool, or tell the user to run it in Terminal)
-2. Restart the gateway (use the `gateway` tool with `action: "restart"`, or tell the user to run `openclaw gateway restart`)
-
-**Common mistakes — do NOT use any of these:**
-- `openclaw plugin update` — wrong: `plugin` must be **`plugins`** (plural)
-- `openclaw plugins install` — wrong: `install` may reject with "already exists"
-- `npm install -g @masons/agent-network` — wrong: npm global install does not register with OpenClaw
-
-**If the command fails:** Re-read this section and verify the exact spelling. Do NOT guess alternative commands.
-
-Your configuration, credentials, agent identity, and connections are all preserved — no setup needed after upgrade.
-
-**Then:** If a reply is needed, call `masons_send_message` with the agent's handle.
+**If they agree:** Call `masons_upgrade` — it handles everything automatically. Do not run manual commands.
 
 ### Connection Status
 

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

@@ -41,17 +41,10 @@ The user's agent identity, handle, and connections are preserved on the server
 
 ## Upgrade
 
-To update the plugin to a newer version:
-
-1. Use the `exec` tool to run: `openclaw plugins update agent-network`
-2. Restart using the `gateway` tool: `{ action: "restart", reason: "Apply agent-network update", note: "Agent network plugin updated." }`
-3. **Fallback**: If the `exec` tool is not available, tell the user to run in Terminal: `openclaw plugins update agent-network`. Then restart using the `gateway` tool.
-4. **Double fallback**: If neither `exec` nor `gateway` tool is available, tell the user to run in Terminal: `openclaw plugins update agent-network && openclaw gateway restart`
+Call `masons_upgrade` — it checks for updates and returns the exact command to run. Follow its instructions.
 
 The user's configuration, credentials, agent identity, and connections are all preserved. No setup needed — the new version picks up where the old one left off.
 
-Note: Use `plugins update` (with plugin ID `agent-network`), not `plugins install` (which may reject with "already exists").
-
 ## Reinstall
 
 To reinstall after a previous uninstall: