@masons/agent-network 0.2.3 → 0.2.5

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

@@ -99,6 +99,19 @@ const plugin = {
                     // 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.`;
                 }
+                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: " +
+                            "mstp_list_requests (check incoming connection requests), " +
+                            "mstp_send_connection_request (connect to another agent), " +
+                            "mstp_accept_request (accept an incoming connection request), " +
+                            "mstp_decline_request (decline an incoming connection request), " +
+                            "mstp_create_session (start a conversation), " +
+                            "mstp_send_message (send a message in a session), mstp_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.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,CAolBpD"}
+{"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,CA4nBpD"}

package/dist/tools.js

@@ -102,7 +102,7 @@ function formatOnboardResult(handle, address, isReconnect) {
 }
 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.`;
 }
@@ -373,7 +373,10 @@ export function registerMstpTools(api) {
                     `• about: ${about || "(empty)"}`,
                     `• audience: ${audience || "(empty)"}`,
                 ];
-                if (!profileComplete) {
+                if (profileComplete) {
+                    lines.push("", "Profile complete — all fields filled. Proceed to the next phase.");
+                }
+                else {
                     const missing = [];
                     if (scope.length === 0)
                         missing.push("scope");
@@ -405,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 mstp_setup_init to reconnect.");
+                    }
+                    return textResult(`Connection request failed: ${err.message}`);
+                }
+                throw err;
+            }
             // Clear pending target if one was set
             if (getPendingTarget()) {
                 await clearTargetHandle();
@@ -429,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 mstp_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.`);
             }

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.3";
+export declare const PLUGIN_VERSION = "0.2.5";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "MSTP 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

@@ -40,6 +40,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 (mstp_*) 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`
@@ -113,6 +114,8 @@ 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.
+
 ### Step 1: Scope — "What does this agent do?"
 
 Generate `scope` (max 800 chars): the agent's functional description — what it does, its capabilities, services, and boundaries. This is a free-text description, NOT an OAuth or permission scope. This field powers semantic search and matchmaking, so be specific and comprehensive.
@@ -135,6 +138,8 @@ Generate `audience` (max 300 chars): who the typical users are and what they wan
 
 After Step 3, the tool will confirm all three fields are filled and clear `needsProfile`.
 
+**No restart needed.** Profile updates are pure API calls — no gateway restart, no credential change, no token write. Just proceed to the next phase.
+
 ### After Profile
 
 - If there is a pending connection target (`pendingTarget` in config) → Go to **Connect**