@masons/agent-network 0.6.25 → 0.6.26

package/dist/channel-setup.d.ts

@@ -7,7 +7,7 @@ interface StartChannelSetupOptions {
     startOver?: boolean;
 }
 export interface ChannelSetupResult {
-    status: "pending" | "completed" | "expired" | "failed";
+    status: "pending" | "completed" | "linked" | "expired" | "failed";
     handoffUrl?: string;
     expiresAt?: number;
     message?: string;

package/dist/channel-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-setup.d.ts","sourceRoot":"","sources":["../src/channel-setup.ts"],"names":[],"mappings":"AAkBA,UAAU,wBAAwB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IAEnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAM9B,SAAS,CAAC,EAAE,MAAM,CAAC;IAOnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AA4CD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuBD,wBAAgB,6BAA6B,IAAI,wBAAwB,CAKxE;AAWD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAkB7B;AAOD,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAQjE;AAaD,wBAAgB,wBAAwB,IAAI,kBAAkB,GAAG,IAAI,CAOpE;AAgOD,wBAAgB,4BAA4B,IAAI,IAAI,CAInD;AAED,eAAO,MAAM,oBAAoB,QAAqB,CAAC"}
+{"version":3,"file":"channel-setup.d.ts","sourceRoot":"","sources":["../src/channel-setup.ts"],"names":[],"mappings":"AA+BA,UAAU,wBAAwB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IAEnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAM9B,SAAS,CAAC,EAAE,MAAM,CAAC;IAOnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AA4CD,MAAM,WAAW,kBAAkB;IAKjC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4BD,wBAAgB,6BAA6B,IAAI,wBAAwB,CAKxE;AAWD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAqB7B;AAyDD,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAQjE;AAaD,wBAAgB,wBAAwB,IAAI,kBAAkB,GAAG,IAAI,CAOpE;AAgOD,wBAAgB,4BAA4B,IAAI,IAAI,CAInD;AAED,eAAO,MAAM,oBAAoB,QAAqB,CAAC"}

package/dist/channel-setup.js

@@ -1,13 +1,18 @@
 import createDebug from "debug";
-import { readExistingConnectorUrl } from "./config.js";
+import { hasApiKey, readExistingConnectorUrl, requireApiKey, requirePlatformConfig, } from "./config.js";
 import { resolveConnectorUrlForSetup } from "./connector-url-boundary.js";
 import { beginBridgeHandoff, collectBridgeHandoffOnce, completeBridgeHandoff, DEFAULT_IDP_BASE_URL, HANDOFF_TIMEOUT_MS, SetupFlowError, } from "./handoff.js";
 import { acceptBridgeHandoff } from "./handoff-acceptance.js";
-import { DEFAULT_API_HOST } from "./platform-client.js";
+import { classifyIdentityError, formatCanonicalNode, } from "./identity-format.js";
+import { DEFAULT_API_HOST, getIdentity, } from "./platform-client.js";
 const dbg = createDebug("agent-network:channel-setup");
 const GENERIC_EXPIRY_MESSAGE = "The previous Link URL expired before the browser handoff completed.";
 const GONE_MESSAGE = "That Link session is no longer on the handoff bridge — it expired, or its runtime key was already delivered — so it cannot complete.";
 const SUPERSEDED_MESSAGE = "A newer Link session replaced this one while it was completing, so the runtime key that session delivered was discarded. Nothing changed — this runtime still uses the credential it had before.";
+const DURABLE_BINDING_NOTE = [
+    "This result reflects the current binding — the runtime key this Runtime holds, confirmed with the network just now.",
+    "To re-link or change Node, call masons_link with start_over: true.",
+].join("\n");
 let pendingSetup = null;
 let lastSetupStatus = null;
 let setupSeq = 0;
@@ -33,8 +38,34 @@ export async function startOrGetChannelSetup(options) {
     const live = getActivePendingSetup();
     if (live)
         return pendingResult(live);
+    const durable = await reportDurableBinding(options);
+    if (durable)
+        return durable;
     return await startNewSession(options);
 }
+async function reportDurableBinding(options) {
+    if (!hasApiKey())
+        return null;
+    let node;
+    try {
+        node = await getIdentity(requirePlatformConfig(), requireApiKey());
+    }
+    catch (err) {
+        if (classifyIdentityError(err) === null)
+            throw err;
+        dbg("the stored runtime key could not be verified before minting: %O", err);
+        return null;
+    }
+    if (node === null)
+        return null;
+    const lines = [formatCanonicalNode("Linked", node), DURABLE_BINDING_NOTE];
+    if (options.invitedBy)
+        lines.push(invitationFollowThrough(options.invitedBy));
+    return { status: "linked", message: lines.join("\n") };
+}
+function invitationFollowThrough(invitedBy) {
+    return `This call carried an invitation from @${invitedBy}. The binding above already stands, so nothing was recorded to act on later — propose the connection now with masons_send_connection_request to @${invitedBy}.`;
+}
 export function getChannelSetupStatus() {
     const active = getActivePendingSetup();
     if (active)

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,oBAAoB,CAAC;AAuD5B,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,WAAW;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;AAE3E,UAAU,OAAO;IACf,YAAY,CACV,IAAI,EAAE,cAAc,GAAG,WAAW,EAWlC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC7D,IAAI,CAAC;CACT;AAkED,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AA6XD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,GAAG,WAAW,GACtC,MAAM,CAqBR;AAGD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAoC3E;AAyBD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAmoChD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,oBAAoB,CAAC;AA0D5B,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,WAAW;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;AAE3E,UAAU,OAAO;IACf,YAAY,CACV,IAAI,EAAE,cAAc,GAAG,WAAW,EAWlC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC7D,IAAI,CAAC;CACT;AAkED,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAkYD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,GAAG,WAAW,GACtC,MAAM,CAqBR;AAGD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAyC3E;AA+CD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAqoChD"}

package/dist/tools.js

@@ -142,17 +142,19 @@ function formatRegistration(outcome) {
             return "none";
     }
 }
+function formatChannelStateLines(client) {
+    return [
+        `Gateway channel: ${client ? client.getChannelState() : "not established"}`,
+        `Registration (this connection): ${formatRegistration(client ? client.getRegistration() : { state: "none" })}`,
+    ];
+}
 function formatReadinessSection() {
     const credentialsLine = hasApiKey()
         ? "Credentials: configured"
         : "Credentials: not configured";
-    const client = getConnectorClient();
-    const channel = client ? client.getChannelState() : "not established";
-    const registration = formatRegistration(client ? client.getRegistration() : { state: "none" });
     return [
         credentialsLine,
-        `Gateway channel: ${channel}`,
-        `Registration (this connection): ${registration}`,
+        ...formatChannelStateLines(getConnectorClient()),
     ].join("\n");
 }
 async function resolveIdentitySection() {
@@ -261,10 +263,14 @@ export function formatChannelSetupResult(result) {
             result.message ?? "Agent Network Link completed.",
             "",
             "HTTP tools may work before the Gateway WebSocket is connected.",
-            'If the gateway tool is available, call it with action "restart" and reason "Activate Agent Network after Link". If not, ask the user to run `openclaw gateway restart`.',
+            GATEWAY_RESTART_ACTION,
             "This result stands until the owner asks to start over: to re-link or change Node, call masons_link with start_over: true.",
         ].join("\n");
     }
+    if (result.status === "linked") {
+        const receipt = result.message ?? "This Runtime is linked to an Agent Node.";
+        return [receipt, ...formatRealtimeGap()].join("\n");
+    }
     if (result.status === "expired") {
         return [
             result.message ?? "The previous Link URL expired.",
@@ -278,8 +284,17 @@ export function formatChannelSetupResult(result) {
         LINK_RETRY_GUIDANCE,
     ].join("\n");
 }
+const GATEWAY_RESTART_ACTION = 'If the gateway tool is available, call it with action "restart" and reason "Activate Agent Network after Link". If not, ask the user to run `openclaw gateway restart`.';
+function formatRealtimeGap() {
+    const client = getConnectorClient();
+    if (client?.getChannelState() === "connected" &&
+        client.getRegistration().state === "accepted") {
+        return [];
+    }
+    return ["", ...formatChannelStateLines(client), GATEWAY_RESTART_ACTION];
+}
 const LINK_RETRY_GUIDANCE = [
-    "Call masons_link again in this conversation and I will issue a fresh Link URL — the whole flow finishes here.",
+    "Call masons_link again in this conversation — the whole flow finishes here.",
     "Last resort, only if that keeps failing: the owner can run `openclaw channels login --channel agent-network` in a terminal.",
 ].join("\n");
 export function registerTools(api) {
@@ -310,7 +325,9 @@ export function registerTools(api) {
             "This tool returns a browser handoff URL on the channel where you are",
             "running. The user opens it, signs in, picks an agent, and the encrypted",
             "handoff completes in the background. After completion, restart the",
-            "gateway to activate realtime messaging.",
+            "gateway to activate realtime messaging. When this Runtime already",
+            "holds a verified binding and no Link is pending, it reports that",
+            "standing binding instead of issuing a URL.",
             "",
             "If the user is reaching this agent through the MASONS network as a",
             "visitor (not the agent's owner), this tool refuses with an explanation",
@@ -326,10 +343,10 @@ export function registerTools(api) {
             })),
             start_over: Type.Optional(Type.Boolean({
                 description: "Discard whatever this Runtime is holding — a Link still in " +
-                    "progress, or a Link that already completed — and issue a fresh " +
-                    "Link URL. After a completed Link, pass start_over: true to " +
-                    "re-link or link a different Node; without it a repeat call " +
-                    "re-reports the completed result instead of starting again.",
+                    "progress, a Link that already completed, or a binding already " +
+                    "on disk — and issue a fresh Link URL. Without it a repeat call " +
+                    "re-reports what stands, which after a Gateway restart is the " +
+                    "standing binding rather than the completed result.",
             })),
         }),
         execute: async (_id, params) => {

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PLUGIN_VERSION = "0.6.25";
+export declare const PLUGIN_VERSION = "0.6.26";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1 +1 @@
-export const PLUGIN_VERSION = "0.6.25";
+export const PLUGIN_VERSION = "0.6.26";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.6.25",
+  "version": "0.6.26",
   "description": "MASONS Agent Network — OpenClaw channel plugin for connecting agent runtimes to the Agent Network over MSTP.",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",

package/skills/agent-network/SKILL.md

@@ -94,6 +94,8 @@ The browser handoff page lets the owner sign in, select or create an agent, and
 After completion:
 
 1. Call `masons_link` again to check whether the encrypted handoff completed. This call collects the owner's browser selection itself, so a step they already finished is confirmed here rather than costing a second browser walk. While the Link is still open the same call returns the SAME URL — pass it on, do not describe it as a new one.
+   - Some Hosts restart the Gateway the moment the runtime key is written, so a restart right after the owner says they finished is EXPECTED here — it is the success signal, not a fault.
+   - The restarted process confirms the Link as a **Linked** receipt (the present binding) instead of an **Accepted** one (the acceptance moment). Both mean the Link succeeded: relay it and move on, never re-issue a URL.
 2. If `masons_link` reports the Link completed, restart the Gateway to activate realtime messaging:
    - Prefer the host `gateway` tool with `action`: `"restart"` and `reason`: `"Activate Agent Network after Link"`.
    - If the `gateway` tool is unavailable, tell the user to run `openclaw gateway restart`.
@@ -106,8 +108,8 @@ After completion:
 
 ### Errors
 
-- If `masons_link` reports the Link expired or failed, that session is over: call `masons_link` again in this conversation and it issues a fresh Link URL. Do not offer the terminal on a first failure.
-- If `masons_link` reports the Link completed and the user wants to re-link or change Node, call it with `start_over: true` — a plain call re-reports the completed result.
+- If `masons_link` reports the Link expired or failed, that session is over: call `masons_link` again in this conversation. On a Runtime that still holds a working binding that call reports the standing binding, so add `start_over: true` to get a fresh URL. Do not offer the terminal on a first failure.
+- If `masons_link` reports the Link completed or Linked and the user wants to re-link or change Node, call it with `start_over: true` — a plain call re-reports the current binding.
 - Only after Link has failed here repeatedly, name `openclaw channels login --channel agent-network` as the last resort, and say so.
 - If any other tool returns an error, explain it simply and suggest next steps.
 - If the CLI says a handle is rejected or taken, ask the user to retry and choose a different handle.