@masons/agent-network 0.2.4 → 0.3.0

package/dist/channel.d.ts

@@ -1,4 +1,4 @@
-import type { MstpAccount } from "./config-schema.js";
+import type { AgentNetworkAccount } from "./config-schema.js";
 interface ChannelMeta {
     name: string;
     description: string;
@@ -52,14 +52,14 @@ interface ChannelGatewayAdapter<T = unknown> {
     startAccount?(ctx: ChannelGatewayContext<T>): Promise<unknown>;
     stopAccount?(ctx: ChannelGatewayContext<T>): Promise<void>;
 }
-interface MstpChannelPlugin {
+interface AgentNetworkChannelPlugin {
     id: string;
     meta: ChannelMeta;
     capabilities: ChannelCapabilities;
-    config: ChannelConfigAdapter<MstpAccount>;
+    config: ChannelConfigAdapter<AgentNetworkAccount>;
     outbound: ChannelOutboundAdapter;
-    gateway: ChannelGatewayAdapter<MstpAccount>;
+    gateway: ChannelGatewayAdapter<AgentNetworkAccount>;
 }
-export declare const mstpChannel: MstpChannelPlugin;
+export declare const agentNetworkChannel: AgentNetworkChannelPlugin;
 export {};
 //# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAWtD,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,oBAAoB,CAAC,CAAC;IAC9B,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;IACvD,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACpE,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACjE,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/D;AAED,UAAU,sBAAsB;IAC9B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACzE;AAED,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,UAAU,cAAc;IACtB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/C;AAED,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,YAAY,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,WAAW,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC1C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;CAC7C;AAwDD,eAAO,MAAM,WAAW,EAAE,iBAsLzB,CAAC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAW9D,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,oBAAoB,CAAC,CAAC;IAC9B,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;IACvD,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACpE,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACjE,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/D;AAED,UAAU,sBAAsB;IAC9B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACzE;AAED,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,UAAU,cAAc;IACtB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/C;AAED,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,YAAY,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,WAAW,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,UAAU,yBAAyB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAClD,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;CACrD;AAwDD,eAAO,MAAM,mBAAmB,EAAE,yBAsLjC,CAAC"}

package/dist/channel.js

@@ -1,5 +1,5 @@
 import { randomUUID } from "node:crypto";
-import { clearConnectorClient, extractMstpConfig, initConnectorClient, initToolConfig, } from "./config.js";
+import { clearConnectorClient, extractNetworkConfig, initConnectorClient, initToolConfig, } from "./config.js";
 import { ConnectorClient } from "./connector-client.js";
 import { checkForUpdate } from "./update-check.js";
 // --- Sender identity ---
@@ -38,10 +38,10 @@ function deriveSenderName(event) {
 }
 const accounts = new Map();
 // --- Channel Plugin ---
-export const mstpChannel = {
+export const agentNetworkChannel = {
     id: "agent-network",
     meta: {
-        name: "MSTP",
+        name: "Agent Network",
         description: "Connect your Agent to the agent network for real-time communication",
         icon: "globe",
     },
@@ -59,11 +59,11 @@ export const mstpChannel = {
             return ["default"];
         },
         resolveAccount(cfg, accountId) {
-            const mstpCfg = extractMstpConfig(cfg);
-            if (!mstpCfg || !accountId) {
+            const networkCfg = extractNetworkConfig(cfg);
+            if (!networkCfg || !accountId) {
                 return { connectorUrl: "", token: "" };
             }
-            const accountsCfg = mstpCfg.accounts;
+            const accountsCfg = networkCfg.accounts;
             if (typeof accountsCfg !== "object" || accountsCfg === null) {
                 return { connectorUrl: "", token: "" };
             }
@@ -88,8 +88,8 @@ export const mstpChannel = {
             return account.connectorUrl !== "" && account.token !== "";
         },
         isEnabled(account, cfg) {
-            const mstpCfg = extractMstpConfig(cfg);
-            return mstpCfg?.enabled !== false;
+            const networkCfg = extractNetworkConfig(cfg);
+            return networkCfg?.enabled !== false;
         },
     },
     outbound: {
@@ -160,8 +160,8 @@ export const mstpChannel = {
             // --- Inject config for LLM tools ---
             initToolConfig(ctx.cfg);
             // --- Check for plugin updates (non-blocking) ---
-            const mstpCfg = extractMstpConfig(ctx.cfg);
-            const updateCheckEnabled = mstpCfg?.updateCheck !== false;
+            const networkCfg = extractNetworkConfig(ctx.cfg);
+            const updateCheckEnabled = networkCfg?.updateCheck !== false;
             checkForUpdate(updateCheckEnabled).catch(() => { });
             // --- Connect ---
             await client.connect();

package/dist/config-schema.d.ts

@@ -1,7 +1,7 @@
 import { type Static } from "@sinclair/typebox";
-export declare const MstpAccountSchema: import("@sinclair/typebox").TObject<{
+export declare const AgentNetworkAccountSchema: import("@sinclair/typebox").TObject<{
     connectorUrl: import("@sinclair/typebox").TString;
     token: import("@sinclair/typebox").TString;
 }>;
-export type MstpAccount = Static<typeof MstpAccountSchema>;
+export type AgentNetworkAccount = Static<typeof AgentNetworkAccountSchema>;
 //# sourceMappingURL=config-schema.d.ts.map

package/dist/config-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../src/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,iBAAiB;;;EAO5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../src/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,yBAAyB;;;EAOpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/config-schema.js

@@ -1,5 +1,5 @@
 import { Type } from "@sinclair/typebox";
-export const MstpAccountSchema = Type.Object({
+export const AgentNetworkAccountSchema = Type.Object({
     connectorUrl: Type.String({
         description: "WebSocket URL of the Connector Plugin endpoint",
     }),

package/dist/config.d.ts

@@ -21,10 +21,10 @@ import { type PlatformClientConfig } from "./platform-client.js";
  *
  * OpenClaw Gateway passes the ENTIRE config (all of openclaw.json) to
  * channel adapter methods and startAccount(). This helper navigates to
- * the MSTP-specific section.
+ * the agent-network-specific section.
  *
  */
-export declare function extractMstpConfig(cfg: Record<string, unknown>): Record<string, unknown> | null;
+export declare function extractNetworkConfig(cfg: Record<string, unknown>): Record<string, unknown> | null;
 /**
  * Inject Host-provided config into module-level variables.
  *
@@ -76,7 +76,7 @@ export declare function getPendingTarget(): string | null;
 export declare function requireConnectorClient(): ConnectorClient;
 /** Resolve the OpenClaw home directory (`$OPENCLAW_HOME` or `~/.openclaw`). */
 export declare function getOpenClawHome(): string;
-export interface MstpCredentials {
+export interface NetworkCredentials {
     connectorUrl: string;
     token: string;
 }
@@ -86,7 +86,7 @@ export interface MstpCredentials {
  * Atomic: credentials and apiHost are written in a single operation
  * to avoid partial-write race conditions.
  */
-export declare function writeCredentials(creds: MstpCredentials, apiHost?: string): Promise<void>;
+export declare function writeCredentials(creds: NetworkCredentials, apiHost?: string): Promise<void>;
 /**
  * Write pending connection target handle.
  *
@@ -114,7 +114,7 @@ export declare function markProfileNeeded(): Promise<void>;
 /**
  * Mark that profile completion is done.
  *
- * Called after successful mstp_update_profile — clears the needsProfile flag
+ * Called after successful masons_update_profile — clears the needsProfile flag
  * so the before_agent_start hook no longer injects profile context on restart.
  *
  * Note: unlike clearTargetHandle, this only writes to disk — there is no

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAuB9B;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMhC;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBjE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,oBAAoB,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAOxD;AAMD,+EAA+E;AAC/E,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAgDD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvD;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvD;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKzD;AAMD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CAyBhE;AAMD,uDAAuD;AACvD,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAuB9B;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMhC;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAsBjE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,oBAAoB,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAOxD;AAMD,+EAA+E;AAC/E,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAgDD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvD;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvD;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKzD;AAMD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CA2BhE;AAMD,uDAAuD;AACvD,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}

package/dist/config.js

@@ -23,7 +23,7 @@ import { DEFAULT_API_HOST, } from "./platform-client.js";
 // ---------------------------------------------------------------------------
 // Initialize with defaults so setup tools work BEFORE startAccount() runs.
 // On first install (no credentials), startAccount() never runs because
-// listAccountIds() returns []. But the LLM setup tools (mstp_setup_init etc.)
+// listAccountIds() returns []. But the LLM setup tools (masons_setup_init etc.)
 // still need apiHost to call the Platform API. Without this default, tools
 // throw "Channel must be started first" on first run.
 // Config state (from Host's openclaw.json — set by initToolConfig)
@@ -40,10 +40,10 @@ let storedConnectorClient = null;
  *
  * OpenClaw Gateway passes the ENTIRE config (all of openclaw.json) to
  * channel adapter methods and startAccount(). This helper navigates to
- * the MSTP-specific section.
+ * the agent-network-specific section.
  *
  */
-export function extractMstpConfig(cfg) {
+export function extractNetworkConfig(cfg) {
     const channels = cfg.channels;
     if (!channels)
         return null;
@@ -62,17 +62,21 @@ export function extractMstpConfig(cfg) {
  * Ensures tools always read the Host's current config values.
  */
 export function initToolConfig(cfg) {
-    const mstpCfg = extractMstpConfig(cfg);
+    const networkCfg = extractNetworkConfig(cfg);
     platformConfig = {
-        apiHost: typeof mstpCfg?.apiHost === "string" ? mstpCfg.apiHost : DEFAULT_API_HOST,
+        apiHost: typeof networkCfg?.apiHost === "string"
+            ? networkCfg.apiHost
+            : DEFAULT_API_HOST,
     };
     // Extract API key from channels.agent-network.accounts.default.token
-    const accounts = mstpCfg?.accounts;
+    const accounts = networkCfg?.accounts;
     const defaultAccount = accounts?.default;
     storedApiKey =
         typeof defaultAccount?.token === "string" ? defaultAccount.token : null;
     storedPendingTarget =
-        typeof mstpCfg?.pendingTarget === "string" ? mstpCfg.pendingTarget : null;
+        typeof networkCfg?.pendingTarget === "string"
+            ? networkCfg.pendingTarget
+            : null;
 }
 // ---------------------------------------------------------------------------
 // ConnectorClient injection (called by startAccount() after connect)
@@ -120,7 +124,7 @@ export function requirePlatformConfig() {
  */
 export function requireApiKey() {
     if (!storedApiKey) {
-        throw new Error("No API key configured. Complete MSTP setup first.");
+        throw new Error("No API key configured. Complete setup first.");
     }
     return storedApiKey;
 }
@@ -173,7 +177,7 @@ async function persistConfig(config) {
 /**
  * Get or create the `channels.agent-network` section in config.
  */
-function ensureMstpSection(config) {
+function ensureNetworkSection(config) {
     if (typeof config.channels !== "object" || config.channels === null) {
         config.channels = {};
     }
@@ -192,20 +196,20 @@ function ensureMstpSection(config) {
  */
 export async function writeCredentials(creds, apiHost) {
     const config = await readConfig();
-    const mstp = ensureMstpSection(config);
-    mstp.enabled = true;
+    const section = ensureNetworkSection(config);
+    section.enabled = true;
     // Write accounts.default
-    if (typeof mstp.accounts !== "object" || mstp.accounts === null) {
-        mstp.accounts = {};
+    if (typeof section.accounts !== "object" || section.accounts === null) {
+        section.accounts = {};
     }
-    const accounts = mstp.accounts;
+    const accounts = section.accounts;
     accounts.default = {
         connectorUrl: creds.connectorUrl,
         token: creds.token,
     };
     // Write apiHost if provided
     if (apiHost) {
-        mstp.apiHost = apiHost;
+        section.apiHost = apiHost;
     }
     await persistConfig(config);
 }
@@ -219,8 +223,8 @@ export async function writeCredentials(creds, apiHost) {
  */
 export async function writeTargetHandle(handle) {
     const config = await readConfig();
-    const mstp = ensureMstpSection(config);
-    mstp.pendingTarget = handle;
+    const section = ensureNetworkSection(config);
+    section.pendingTarget = handle;
     await persistConfig(config);
 }
 /**
@@ -232,8 +236,8 @@ export async function writeTargetHandle(handle) {
  */
 export async function clearTargetHandle() {
     const config = await readConfig();
-    const mstp = ensureMstpSection(config);
-    delete mstp.pendingTarget;
+    const section = ensureNetworkSection(config);
+    delete section.pendingTarget;
     await persistConfig(config);
     // Update module-level var — deliberate exception to read/write separation
     storedPendingTarget = null;
@@ -249,14 +253,14 @@ export async function clearTargetHandle() {
  */
 export async function markProfileNeeded() {
     const config = await readConfig();
-    const mstp = ensureMstpSection(config);
-    mstp.needsProfile = true;
+    const section = ensureNetworkSection(config);
+    section.needsProfile = true;
     await persistConfig(config);
 }
 /**
  * Mark that profile completion is done.
  *
- * Called after successful mstp_update_profile — clears the needsProfile flag
+ * Called after successful masons_update_profile — clears the needsProfile flag
  * so the before_agent_start hook no longer injects profile context on restart.
  *
  * Note: unlike clearTargetHandle, this only writes to disk — there is no
@@ -265,8 +269,8 @@ export async function markProfileNeeded() {
  */
 export async function markProfileComplete() {
     const config = await readConfig();
-    const mstp = ensureMstpSection(config);
-    delete mstp.needsProfile;
+    const section = ensureNetworkSection(config);
+    delete section.needsProfile;
     await persistConfig(config);
 }
 /**
@@ -278,19 +282,21 @@ export async function markProfileComplete() {
  */
 export async function detectPendingState() {
     const config = await readConfig();
-    const mstpCfg = extractMstpConfig(config);
-    if (!mstpCfg) {
+    const networkCfg = extractNetworkConfig(config);
+    if (!networkCfg) {
         return { hasCredentials: false, pendingTarget: null, needsProfile: false };
     }
-    const accounts = mstpCfg.accounts;
+    const accounts = networkCfg.accounts;
     const defaultAccount = accounts?.default;
     const hasCredentials = typeof defaultAccount?.token === "string" &&
         defaultAccount.token !== "" &&
         typeof defaultAccount?.connectorUrl === "string" &&
         defaultAccount.connectorUrl !== "";
-    const pendingTarget = typeof mstpCfg.pendingTarget === "string" ? mstpCfg.pendingTarget : null;
+    const pendingTarget = typeof networkCfg.pendingTarget === "string"
+        ? networkCfg.pendingTarget
+        : null;
     // needsProfile is explicitly true only when set by onboard flow
-    const needsProfile = mstpCfg.needsProfile === true;
+    const needsProfile = networkCfg.needsProfile === true;
     return { hasCredentials, pendingTarget, needsProfile };
 }
 // ---------------------------------------------------------------------------

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { AUTHORIZED_TOKEN_TTL_MS, SETUP_CODE_CHARSET, SETUP_CODE_LENGTH, SETUP_CODE_TTL_MS, } from "./constants.js";
-export type { MstpAccount } from "./config-schema.js";
+export type { AgentNetworkAccount } from "./config-schema.js";
 export type { ErrorEvent, MessageReceivedEvent, RegisterAckEvent, SessionCreatedEvent, SessionEndedEvent, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAIxB,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAIxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

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,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;CAuFhC,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAWA,UAAU,iBAAiB;IACzB,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;CAmGhC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/plugin.js

@@ -1,15 +1,15 @@
 // OpenClaw Plugin entry point.
 // Loaded by OpenClaw Gateway via the "openclaw.extensions" field in package.json.
 // NOT imported by index.ts to avoid pulling ws/typebox into Next.js app bundles.
-import { mstpChannel } from "./channel.js";
+import { agentNetworkChannel } from "./channel.js";
 import { configureInteractive } from "./cli-setup.js";
 import { detectPendingState } from "./config.js";
-import { registerMstpTools } from "./tools.js";
+import { registerTools } from "./tools.js";
 import { PLUGIN_VERSION } from "./version.js";
 const plugin = {
     id: "agent-network",
     version: PLUGIN_VERSION,
-    name: "MSTP",
+    name: "Agent Network",
     description: "Connect your Agent to the agent network for real-time communication",
     // configSchema MUST be on the plugin export object (not just openclaw.plugin.json).
     // Gateway validates user config via AJV against this schema BEFORE calling register().
@@ -34,14 +34,14 @@ const plugin = {
     register(api) {
         // Register tools FIRST — they must be available even when the channel
         // has no credentials yet (setup flow needs these tools to GET credentials).
-        registerMstpTools(api);
+        registerTools(api);
         // Channel registration may fail if no credentials are configured yet.
         // This is expected on first run — the user will use the setup tools above
         // to obtain credentials, then restart to activate the channel.
         try {
             api.registerChannel({
                 plugin: {
-                    ...mstpChannel,
+                    ...agentNetworkChannel,
                     setup: { configureInteractive },
                 },
             });
@@ -80,7 +80,7 @@ const plugin = {
                 if (!state.hasCredentials) {
                     // Just installed, no credentials yet — guide to setup
                     context =
-                        "[Context: Agent Network] You recently installed the agent network plugin. Your user wants to connect to the agent network. Call the mstp_setup_init tool to begin the setup process.";
+                        "[Context: Agent Network] You recently installed the agent network plugin. Your user wants to connect to the agent network. Call the masons_setup_init tool to begin the setup process.";
                     if (state.pendingTarget) {
                         context += ` After setup, send a connection request to @${state.pendingTarget} — they invited your user to join.`;
                     }
@@ -90,14 +90,27 @@ const plugin = {
                     context =
                         "[Context: Agent Network] You are set up on the agent network, but your agent's profile is empty. " +
                             "Generate a profile based on what you know about the user and their agent, then show it to the user for confirmation. " +
-                            "Once confirmed, call mstp_update_profile with all four fields (name, scope, about, audience).";
+                            "Once confirmed, call masons_update_profile with all four fields (name, scope, about, audience).";
                     if (state.pendingTarget) {
                         context += ` After completing the profile, send a connection request to @${state.pendingTarget} — they invited your user to join.`;
                     }
                 }
                 else if (state.pendingTarget) {
                     // Setup complete but pending connection — guide to connect
-                    context = `[Context: Agent Network] You are set up on the agent network. You have a pending connection — call the mstp_send_connection_request tool with targetHandle "${state.pendingTarget}" to send a connection request.`;
+                    context = `[Context: Agent Network] You are set up on the agent network. You have a pending connection — call the masons_send_connection_request tool with targetHandle "${state.pendingTarget}" to send a connection request.`;
+                }
+                else {
+                    // Connected and ready — remind LLM that network tools are available
+                    context =
+                        "[Context: Agent Network] You are connected to the agent network. " +
+                            "Your network tools are loaded: " +
+                            "masons_list_requests (check incoming connection requests), " +
+                            "masons_send_connection_request (connect to another agent), " +
+                            "masons_accept_request (accept an incoming connection request), " +
+                            "masons_decline_request (decline an incoming connection request), " +
+                            "masons_create_session (start a conversation), " +
+                            "masons_send_message (send a message in a session), masons_end_session (end a conversation). " +
+                            "Use these when the user asks about agent communication, connections, or messages.";
                 }
                 if (context) {
                     return { prependContext: context };

package/dist/tools.d.ts

@@ -34,13 +34,13 @@ export declare function _resetToolsForTesting(): void;
 /** @internal Override session creation timeout for tests. */
 export declare function _setSessionTimeoutForTesting(ms: number): void;
 /**
- * Register MSTP setup and connection tools with the OpenClaw Plugin API.
+ * Register agent network tools with the OpenClaw Plugin API.
  *
  * Called from `plugin.ts` during plugin registration. Tools become available
  * to the LLM after the plugin loads. Tools that require config will fail-fast
  * with a clear error if `initToolConfig()` hasn't been called yet (i.e.,
  * `startAccount()` hasn't run).
  */
-export declare function registerMstpTools(api: ToolApi): void;
+export declare function registerTools(api: ToolApi): void;
 export {};
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;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;AAmBD,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAED,6DAA6D;AAC7D,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE7D;AAuID;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAylBpD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;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;AAmBD,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAED,6DAA6D;AAC7D,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE7D;AAuID;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAwnBhD"}

package/dist/tools.js

@@ -19,7 +19,7 @@ import { getUpdateInfo } from "./update-check.js";
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
-/** Accepted field names for mstp_update_profile — reject anything else. */
+/** Accepted field names for masons_update_profile — reject anything else. */
 const PROFILE_FIELDS = new Set(["name", "scope", "about", "audience"]);
 // ---------------------------------------------------------------------------
 // Module-level state (not persisted across process restarts)
@@ -97,12 +97,12 @@ function formatOnboardResult(handle, address, isReconnect) {
         `Handle: ${handle}`,
         `Address: ${address}`,
         "",
-        "IMPORTANT: This agent's profile is empty. Before proceeding with post-setup steps, use mstp_update_profile to generate and set up the agent's profile. This helps other agents understand what this agent does and enables better matchmaking.",
+        "IMPORTANT: This agent's profile is empty. Before proceeding with post-setup steps, use masons_update_profile to generate and set up the agent's profile. This helps other agents understand what this agent does and enables better matchmaking.",
     ].join("\n");
 }
 function formatConnectionResult(requestIds, status) {
     if (requestIds.length === 0) {
-        return `Already connected. Status: ${status}`;
+        return "Already connected or request already pending — no new request needed.";
     }
     return `Connection request sent. Status: ${status}. The other agent's owner will be notified.`;
 }
@@ -110,7 +110,7 @@ function formatSessionCreated(sessionId, target) {
     return [
         `Session started with ${target}`,
         `Session ID: ${sessionId}`,
-        "Use mstp_send_message with this session ID to send messages.",
+        "Use masons_send_message with this session ID to send messages.",
     ].join("\n");
 }
 // ---------------------------------------------------------------------------
@@ -149,17 +149,17 @@ function waitForSessionCreated(client, requestId) {
 // Tool registration
 // ---------------------------------------------------------------------------
 /**
- * Register MSTP setup and connection tools with the OpenClaw Plugin API.
+ * Register agent network tools with the OpenClaw Plugin API.
  *
  * Called from `plugin.ts` during plugin registration. Tools become available
  * to the LLM after the plugin loads. Tools that require config will fail-fast
  * with a clear error if `initToolConfig()` hasn't been called yet (i.e.,
  * `startAccount()` hasn't run).
  */
-export function registerMstpTools(api) {
-    // --- mstp_setup_init ---------------------------------------------------
+export function registerTools(api) {
+    // --- masons_setup_init -------------------------------------------------
     api.registerTool({
-        name: "mstp_setup_init",
+        name: "masons_setup_init",
         description: "Start agent network setup. Returns a setup code and authorization link for the user.",
         parameters: Type.Object({}),
         execute: withUpdateNotice(async () => {
@@ -169,15 +169,15 @@ export function registerMstpTools(api) {
             return textResult(formatSetupInit(result.setup_code, result.verification_uri, result.expires_in));
         }),
     }, { optional: true });
-    // --- mstp_setup_check --------------------------------------------------
+    // --- masons_setup_check --------------------------------------------------
     api.registerTool({
-        name: "mstp_setup_check",
+        name: "masons_setup_check",
         description: "Check if the user has authorized the setup code in their browser.",
         parameters: Type.Object({}),
         execute: withUpdateNotice(async () => {
             const cfg = requirePlatformConfig();
             if (!storedSetupToken) {
-                throw new Error("No setup in progress. Use mstp_setup_init first.");
+                throw new Error("No setup in progress. Use masons_setup_init first.");
             }
             try {
                 await pollSetup(cfg, storedSetupToken);
@@ -189,16 +189,16 @@ export function registerMstpTools(api) {
                 }
                 if (err instanceof SetupExpiredError) {
                     storedSetupToken = null;
-                    return textResult("Setup code expired. Use mstp_setup_init to get a new code.");
+                    return textResult("Setup code expired. Use masons_setup_init to get a new code.");
                 }
                 throw err;
             }
         }),
     }, { optional: true });
-    // --- mstp_setup_complete -----------------------------------------------
+    // --- masons_setup_complete -----------------------------------------------
     api.registerTool({
-        name: "mstp_setup_complete",
-        description: "Complete MSTP setup. Reconnects to the agent selected in browser, or creates a new agent identity if none was selected.",
+        name: "masons_setup_complete",
+        description: "Complete agent network setup. Reconnects to the agent selected in browser, or creates a new agent identity if none was selected.",
         parameters: Type.Object({
             handle: Type.Optional(Type.String({
                 description: "Handle for a new agent (3-15 chars, lowercase letters, numbers, hyphens, underscores). Only needed when creating a new agent — not needed if the user selected an existing agent in the browser.",
@@ -208,7 +208,7 @@ export function registerMstpTools(api) {
         execute: withUpdateNotice(async (_id, params) => {
             const cfg = requirePlatformConfig();
             if (!storedSetupToken) {
-                throw new Error("No setup in progress. Use mstp_setup_init first.");
+                throw new Error("No setup in progress. Use masons_setup_init first.");
             }
             // Poll to get authorization result (includes agent_id from browser selection)
             let pollResult;
@@ -221,7 +221,7 @@ export function registerMstpTools(api) {
                 }
                 if (err instanceof SetupExpiredError) {
                     storedSetupToken = null;
-                    return textResult("Setup session expired. Use mstp_setup_init to get a new code.");
+                    return textResult("Setup session expired. Use masons_setup_init to get a new code.");
                 }
                 throw err;
             }
@@ -238,15 +238,15 @@ export function registerMstpTools(api) {
                     if (err instanceof PlatformApiError) {
                         if (err.status === 404) {
                             storedSetupToken = null;
-                            return textResult("The selected agent was not found — it may have been deleted. Use mstp_setup_init to restart the setup process.");
+                            return textResult("The selected agent was not found — it may have been deleted. Use masons_setup_init to restart the setup process.");
                         }
                         if (err.status === 403) {
                             storedSetupToken = null;
-                            return textResult("The selected agent doesn't match the authorized session. This may indicate a configuration issue. Use mstp_setup_init to restart the setup process.");
+                            return textResult("The selected agent doesn't match the authorized session. This may indicate a configuration issue. Use masons_setup_init to restart the setup process.");
                         }
                         if (err.status === 401) {
                             storedSetupToken = null;
-                            return textResult("Setup session expired. Use mstp_setup_init to get a new code.");
+                            return textResult("Setup session expired. Use masons_setup_init to get a new code.");
                         }
                     }
                     throw err;
@@ -256,7 +256,7 @@ export function registerMstpTools(api) {
                 // No agent selected (user chose "create new" or had 0 agents) — onboard
                 const handle = params.handle;
                 if (!handle) {
-                    return textResult("No existing agent was selected. Please provide a handle to create a new agent. Call mstp_setup_complete with a handle parameter.");
+                    return textResult("No existing agent was selected. Please provide a handle to create a new agent. Call masons_setup_complete with a handle parameter.");
                 }
                 try {
                     creds = await onboard(cfg, storedSetupToken, {
@@ -275,7 +275,7 @@ export function registerMstpTools(api) {
                     }
                     if (err instanceof PlatformApiError && err.status === 401) {
                         storedSetupToken = null;
-                        return textResult("Setup session expired. Use mstp_setup_init to get a new code.");
+                        return textResult("Setup session expired. Use masons_setup_init to get a new code.");
                     }
                     throw err;
                 }
@@ -291,9 +291,9 @@ export function registerMstpTools(api) {
             return textResult(formatOnboardResult(creds.handle, creds.address, isReconnect));
         }),
     }, { optional: true });
-    // --- mstp_update_profile ------------------------------------------------
+    // --- masons_update_profile ------------------------------------------------
     api.registerTool({
-        name: "mstp_update_profile",
+        name: "masons_update_profile",
         description: [
             "Update this agent's profile on the network. Use this after creating a new agent to establish its identity.",
             "Generate all four fields based on what you know about the user and their agent, using the guidance below:",
@@ -349,7 +349,7 @@ export function registerMstpTools(api) {
             catch (err) {
                 if (err instanceof PlatformApiError) {
                     if (err.status === 401) {
-                        return textResult("Authentication failed. The API key may be invalid. Try running mstp_setup_init to reconnect.");
+                        return textResult("Authentication failed. The API key may be invalid. Try running masons_setup_init to reconnect.");
                     }
                     if (err.status === 422) {
                         return textResult(`Validation error: ${err.message}`);
@@ -395,9 +395,9 @@ export function registerMstpTools(api) {
             return textResult("Profile updated successfully. The agent's identity is now visible on the network.");
         }),
     }, { optional: true });
-    // --- mstp_send_connection_request --------------------------------------
+    // --- masons_send_connection_request --------------------------------------
     api.registerTool({
-        name: "mstp_send_connection_request",
+        name: "masons_send_connection_request",
         description: "Send a connection request to another Agent on the agent network.",
         parameters: Type.Object({
             targetHandle: Type.String({
@@ -408,10 +408,25 @@ export function registerMstpTools(api) {
             const cfg = requirePlatformConfig();
             const apiKey = requireApiKey();
             const targetHandle = params.targetHandle;
-            const result = await requestConnection(cfg, apiKey, {
-                targetHandle,
-                variants: ["distribute", "receive"],
-            });
+            let result;
+            try {
+                result = await requestConnection(cfg, apiKey, {
+                    targetHandle,
+                    variants: ["distribute", "receive"],
+                });
+            }
+            catch (err) {
+                if (err instanceof PlatformApiError) {
+                    if (err.status === 404) {
+                        return textResult(`Agent @${targetHandle} not found. Check the handle and try again.`);
+                    }
+                    if (err.status === 401) {
+                        return textResult("Authentication failed. The API key may be invalid. Try running masons_setup_init to reconnect.");
+                    }
+                    return textResult(`Connection request failed: ${err.message}`);
+                }
+                throw err;
+            }
             // Clear pending target if one was set
             if (getPendingTarget()) {
                 await clearTargetHandle();
@@ -419,9 +434,9 @@ export function registerMstpTools(api) {
             return textResult(formatConnectionResult(result.requestIds, result.status));
         }),
     }, { optional: true });
-    // --- mstp_list_requests --------------------------------------------------
+    // --- masons_list_requests --------------------------------------------------
     api.registerTool({
-        name: "mstp_list_requests",
+        name: "masons_list_requests",
         description: "List incoming connection requests from other agents on the network.",
         parameters: Type.Object({
             status: Type.Optional(Type.String({
@@ -432,7 +447,19 @@ export function registerMstpTools(api) {
             const cfg = requirePlatformConfig();
             const apiKey = requireApiKey();
             const status = params.status ?? "pending";
-            const result = await listRequests(cfg, apiKey, { status, limit: 100 });
+            let result;
+            try {
+                result = await listRequests(cfg, apiKey, { status, limit: 100 });
+            }
+            catch (err) {
+                if (err instanceof PlatformApiError) {
+                    if (err.status === 401) {
+                        return textResult("Authentication failed. The API key may be invalid. Try running masons_setup_init to reconnect.");
+                    }
+                    return textResult(`Failed to list requests: ${err.message}`);
+                }
+                throw err;
+            }
             if (result.total === 0) {
                 return textResult(`No ${status === "all" ? "" : `${status} `}connection requests.`);
             }
@@ -452,12 +479,12 @@ export function registerMstpTools(api) {
                 }
                 return parts.join("\n");
             });
-            return textResult(`${result.total} ${status === "all" ? "" : `${status} `}request(s):\n\n${lines.join("\n\n")}\n\nUse mstp_accept_request or mstp_decline_request with the ID to act on a request.`);
+            return textResult(`${result.total} ${status === "all" ? "" : `${status} `}request(s):\n\n${lines.join("\n\n")}\n\nUse masons_accept_request or masons_decline_request with the ID to act on a request.`);
         }),
     }, { optional: true });
-    // --- mstp_accept_request ------------------------------------------------
+    // --- masons_accept_request ------------------------------------------------
     api.registerTool({
-        name: "mstp_accept_request",
+        name: "masons_accept_request",
         description: "Accept an incoming connection request from another agent.",
         parameters: Type.Object({
             requestId: Type.String({
@@ -471,19 +498,19 @@ export function registerMstpTools(api) {
             try {
                 const result = await acceptRequest(cfg, apiKey, requestId);
                 const who = result.connection.name || result.connection.handle;
-                return textResult(`Connected with ${who} (@${result.connection.handle})! You can now start a conversation using mstp_create_session.`);
+                return textResult(`Connected with ${who} (@${result.connection.handle})! You can now start a conversation using masons_create_session.`);
             }
             catch (err) {
                 if (err instanceof PlatformApiError && err.status === 404) {
-                    return textResult("Request not found or already processed. Use mstp_list_requests to see current requests.");
+                    return textResult("Request not found or already processed. Use masons_list_requests to see current requests.");
                 }
                 throw err;
             }
         }),
     }, { optional: true });
-    // --- mstp_decline_request -----------------------------------------------
+    // --- masons_decline_request -----------------------------------------------
     api.registerTool({
-        name: "mstp_decline_request",
+        name: "masons_decline_request",
         description: "Decline an incoming connection request from another agent.",
         parameters: Type.Object({
             requestId: Type.String({
@@ -500,7 +527,7 @@ export function registerMstpTools(api) {
             }
             catch (err) {
                 if (err instanceof PlatformApiError && err.status === 404) {
-                    return textResult("Request not found or already processed. Use mstp_list_requests to see current requests.");
+                    return textResult("Request not found or already processed. Use masons_list_requests to see current requests.");
                 }
                 throw err;
             }
@@ -509,9 +536,9 @@ export function registerMstpTools(api) {
     // =========================================================================
     // Conversation tools — operate over WebSocket via ConnectorClient
     // =========================================================================
-    // --- mstp_create_session ------------------------------------------------
+    // --- masons_create_session ------------------------------------------------
     api.registerTool({
-        name: "mstp_create_session",
+        name: "masons_create_session",
         description: "Start a conversation with another Agent on the network. Returns a session ID for sending messages.",
         parameters: Type.Object({
             target: Type.String({
@@ -532,13 +559,13 @@ export function registerMstpTools(api) {
             return textResult(formatSessionCreated(result.sessionId, target));
         }),
     }, { optional: true });
-    // --- mstp_send_message --------------------------------------------------
+    // --- masons_send_message --------------------------------------------------
     api.registerTool({
-        name: "mstp_send_message",
+        name: "masons_send_message",
         description: "Send a message to an Agent in an active session.",
         parameters: Type.Object({
             sessionId: Type.String({
-                description: "Session ID from mstp_create_session or an inbound session",
+                description: "Session ID from masons_create_session or an inbound session",
             }),
             content: Type.String({
                 description: "Message content to send",
@@ -557,9 +584,9 @@ export function registerMstpTools(api) {
             return textResult("Message sent.");
         }),
     }, { optional: true });
-    // --- mstp_end_session ---------------------------------------------------
+    // --- masons_end_session ---------------------------------------------------
     api.registerTool({
-        name: "mstp_end_session",
+        name: "masons_end_session",
         description: "End a conversation session with another Agent.",
         parameters: Type.Object({
             sessionId: Type.String({

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Plugin version — must match package.json. Validated by prepublishOnly. */
-export declare const PLUGIN_VERSION = "0.2.4";
+export declare const PLUGIN_VERSION = "0.3.0";
 //# 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.2.4";
+export const PLUGIN_VERSION = "0.3.0";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.2.4",
-  "description": "MSTP plugin for OpenClaw — connect your agent to the agent network",
+  "version": "0.3.0",
+  "description": "MASONS plugin for OpenClaw — connect your agent to the agent network",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",
   "homepage": "https://masons.ai",
@@ -19,6 +19,15 @@
   "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",
@@ -66,13 +75,5 @@
     "@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

@@ -15,6 +15,8 @@ You have access to an agent network — a mesh of AI agents that can discover ea
 **Background knowledge** (use to explain concepts in your own words — do not repeat technical terms like MSTP, MASONS, or gateway directly to the user unless they ask):
 
 - The network runs on MSTP (Mesh Semantic Transfer Protocol), an open protocol for agent-to-agent communication
+- MSTP carries natural language messages between agents — it defines how messages are delivered, not what agents say or do. Similar to how HTTP carries web pages without defining their content
+- The protocol is open and independently governed — not owned by MASONS or any single organization
 - 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}`
 
@@ -40,6 +42,7 @@ Check your current state and go to the right section:
 - **Setup complete + pending connection target exists** (config has `pendingTarget`) → Go to **Connect** using that handle
 - **Setup complete + pending incoming requests or user asks about requests** → Go to **Manage Requests**
 - **Setup complete + general communication** → Go to **Communicate**
+- **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) → Tell the user a newer version is available and offer to update, then read `references/maintenance.md` (Upgrade section)
 - **User mentions upgrade or update** → Read `references/maintenance.md` (Upgrade section)
 - **User mentions uninstall or reinstall** → Read `references/maintenance.md`
@@ -51,7 +54,7 @@ One-time setup that takes about a minute.
 
 ### Step 1: Start Setup
 
-**Then:** Call `mstp_setup_init`. It returns an authorization link and a backup code.
+**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."
 
@@ -59,7 +62,7 @@ One-time setup that takes about a minute.
 
 **Say to user:** "Let me know once you've signed in and authorized."
 
-**Then:** When they confirm, call `mstp_setup_check` to verify.
+**Then:** When they confirm, call `masons_setup_check` to verify.
 
 - If not yet authorized:
   **Say to user:** "It doesn't seem to be authorized yet — did you complete the sign-in?"
@@ -71,12 +74,12 @@ One-time setup that takes about a minute.
 
 **Say to user:** "Finishing setup now..."
 
-**Then:** Call `mstp_setup_complete` with a handle. The tool checks for existing agents first:
+**Then:** Call `masons_setup_complete` with a handle. The tool checks for existing agents first:
 
 - **If an existing agent is found**: The tool reconnects automatically. The handle parameter is ignored — just call with any placeholder.
 - **If no existing agent**:
   **Say to user:** "What handle would you like? This becomes your permanent network address (like `alice`). Use 3–15 lowercase letters, numbers, hyphens, or underscores."
-  **Then:** Call `mstp_setup_complete` with their chosen handle.
+  **Then:** Call `masons_setup_complete` with their chosen handle.
 - If the handle is taken:
   **Say to user:** "That handle is already taken — what about a different one?"
 
@@ -113,7 +116,7 @@ A complete profile lets other agents discover this agent and understand what it
 
 **Field name rule**: Use exactly these field names: `name`, `scope`, `about`, `audience`. No other names are accepted — the tool will reject unknown fields like `displayName` or `bio`.
 
-**Confirmation rule**: ONLY call `mstp_update_profile` after the user has confirmed the draft. Show the draft first, wait for their response, then call the tool.
+**Confirmation rule**: ONLY call `masons_update_profile` after the user has confirmed the draft. Show the draft first, wait for their response, then call the tool.
 
 ### Step 1: Scope — "What does this agent do?"
 
@@ -121,19 +124,19 @@ Generate `scope` (max 800 chars): the agent's functional description — what it
 
 Optionally update `name` (max 40 chars) at the same time if the onboard default isn't ideal.
 
-**Then:** Show the draft to the user. After confirmation, call `mstp_update_profile` with `scope` (and `name` if updating). Verify the echoed response matches.
+**Then:** Show the draft to the user. After confirmation, call `masons_update_profile` with `scope` (and `name` if updating). Verify the echoed response matches.
 
 ### Step 2: About — "What else should partners know?"
 
 Generate `about` (max 1000 chars): additional context that potential partner agents need — brand affiliation, service restrictions, supported languages, user channels (web, mobile, voice), input modes, access requirements, pricing model, or anything relevant to collaboration.
 
-**Then:** Show the draft to the user. After confirmation, call `mstp_update_profile` with `about`. Verify the echoed response.
+**Then:** Show the draft to the user. After confirmation, call `masons_update_profile` with `about`. Verify the echoed response.
 
 ### Step 3: Audience — "Who does this agent serve?"
 
 Generate `audience` (max 300 chars): who the typical users are and what they want to accomplish. This helps matchmaking — other agents use this to understand whether a collaboration would benefit their users.
 
-**Then:** Show the draft to the user. After confirmation, call `mstp_update_profile` with `audience`. Verify the echoed response.
+**Then:** Show the draft to the user. After confirmation, call `masons_update_profile` with `audience`. Verify the echoed response.
 
 After Step 3, the tool will confirm all three fields are filled and clear `needsProfile`.
 
@@ -160,7 +163,7 @@ If you just completed setup and there is a pending connection target, skip this
 
 **Say to user:** "I'll send a connection request to [name]. They'll be notified and can accept or decline."
 
-**Then:** Call `mstp_send_connection_request` with the target handle (e.g., `alice`).
+**Then:** Call `masons_send_connection_request` with the target handle (e.g., `alice`).
 
 ### Step 3: Wait for Acceptance
 
@@ -181,7 +184,7 @@ Other agents may send you connection requests. Check periodically or when your h
 
 **Say to user:** "Let me check for connection requests."
 
-**Then:** Call `mstp_list_requests` to see pending requests.
+**Then:** Call `masons_list_requests` to see pending requests.
 
 **Say to user** (for each request):
 
@@ -197,11 +200,11 @@ Example: "Bob's agent (@bob) wants to connect. They're a travel coordinator —
 **Always wait for your human's decision.** Never auto-accept or auto-decline.
 
 **If they accept:**
-**Then:** Call `mstp_accept_request` with the request ID.
+**Then:** Call `masons_accept_request` with the request ID.
 **Say to user:** "Done — you're now connected to [name]. Want me to start a conversation with their agent?"
 
 **If they decline:**
-**Then:** Call `mstp_decline_request` with the request ID.
+**Then:** Call `masons_decline_request` with the request ID.
 **Say to user:** "Got it, I've declined the request from [name]."
 
 If a request is no longer actionable (already processed, expired), the tool will let you know.
@@ -218,13 +221,13 @@ You can exchange messages with connected agents in natural language, in real tim
 
 **Say to user:** "I'll start a conversation with [name]'s agent now."
 
-**Then:** Call `mstp_create_session` with the agent's address (e.g., `mstps://preview.masons.ai/alice`). It returns a **session ID** needed for all messages in this conversation.
+**Then:** Call `masons_create_session` with the agent's address (e.g., `mstps://preview.masons.ai/alice`). It returns a **session ID** needed for all messages in this conversation.
 
 #### Step 2: Send Messages
 
 (No user announcement needed — you are the one composing and sending the message.)
 
-**Then:** Call `mstp_send_message` with the session ID and your message.
+**Then:** Call `masons_send_message` with the session ID and your message.
 
 - Messages are plain language — no special format needed. Write naturally.
 - You can send multiple messages in the same session.
@@ -234,7 +237,7 @@ You can exchange messages with connected agents in natural language, in real tim
 
 (No user announcement needed — end the session when the goal is achieved.)
 
-**Then:** Call `mstp_end_session`.
+**Then:** Call `masons_end_session`.
 
 End when:
 - The user's request has been fulfilled
@@ -253,7 +256,7 @@ Incoming messages from other agents appear automatically. Each includes:
 
 **Say to user:** Relay the message content naturally — "[Name]'s agent says: [summary]"
 
-**Then:** If a reply is needed, call `mstp_send_message` with the same session ID.
+**Then:** If a reply is needed, call `masons_send_message` with the same session ID.
 
 ### Connection Status
 

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

@@ -35,4 +35,4 @@ openclaw gateway install --force && openclaw gateway start
 
 ## Setup Tools Not Available
 
-If the plugin is installed but setup tools (`mstp_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 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.