@masons/agent-network 0.4.6 → 0.4.7

package/dist/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAc9D,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,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAsDD,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;AAqDD,eAAO,MAAM,mBAAmB,EAAE,yBAwWjC,CAAC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAc9D,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,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAsDD,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;AAkED,eAAO,MAAM,mBAAmB,EAAE,yBAkXjC,CAAC"}

package/dist/channel.js

@@ -10,21 +10,32 @@ const dbg = createDebug("agent-network:channel");
 // not per-message metadata. See the message_received handler for details.
 // See: docs/openclaw/research/session-identity-mapping.md §5
 /**
- * Extract a human-readable name from the remote Agent's MSTP address.
+ * Extract a human-readable name from the sender's metadata.
  *
- * `metadata.from` contains the address (e.g. `mstps://preview.masons.ai/alice`)
- * when the remote Agent connects through a Connector. Falls back to
- * "Unknown Agent" for direct MSTP clients without address metadata.
+ * Resolution order (account-level identity first, then address):
+ * 1. `metadata.visitor_name` — display name for Passport browser visitors
+ *    (resolved by Connector from user_info.displayName)
+ * 2. `metadata.from` — MSTP address for agent-to-agent connections
+ *    (e.g. `mstps://preview.masons.ai/alice` → "alice")
+ * 3. Fallback: "Unknown" for direct MSTP clients without metadata
+ *
+ * Design: Channel determines routing, Account determines identity.
+ * See: interop-routing-system-design.md §3 "Channel vs Account".
  */
 function deriveSenderName(event) {
+    // Account-level identity: Passport visitor with resolved display name
+    const visitorName = event.metadata?.visitor_name;
+    if (visitorName && typeof visitorName === "string") {
+        return visitorName;
+    }
+    // MSTP address: extract handle from agent address
     const from = event.metadata?.from;
-    if (!from || typeof from !== "string") {
-        return "Unknown Agent";
+    if (from && typeof from === "string") {
+        const trimmed = from.replace(/\/+$/, "");
+        const parts = trimmed.split("/");
+        return parts[parts.length - 1] || from;
     }
-    // Extract handle from MSTP address: mstps://preview.masons.ai/alice → alice
-    const trimmed = from.replace(/\/+$/, "");
-    const parts = trimmed.split("/");
-    return parts[parts.length - 1] || from;
+    return "Unknown";
 }
 /**
  * Extract the Connector host from a connectorUrl.
@@ -159,13 +170,20 @@ export const agentNetworkChannel = {
                 // senderId for OpenClaw routing: use MSTP address if available,
                 // fall back to sessionId for unknown sessions / direct MSTP clients.
                 const senderId = isRealAddress ? senderAddress : event.sessionId;
-                // Derive sender name from the MSTP address, or "Unknown Agent" for fallback.
+                // Derive sender name.
+                // - MSTP agents: extract handle from address.
+                // - Passport visitors / direct clients: use the contact name stored
+                //   in ConversationManager at session_created time (which read
+                //   visitor_name from session metadata). Per-message metadata does
+                //   NOT carry session-level fields like visitor_name, so we must
+                //   use the stored value. Falls back to deriveSenderName → "Unknown".
                 const senderName = isRealAddress
                     ? deriveSenderName({
                         ...event,
                         metadata: { ...event.metadata, from: senderAddress },
                     })
-                    : deriveSenderName(event);
+                    : (conversationManager.getContactBySessionId(event.sessionId) ??
+                        deriveSenderName(event));
                 try {
                     // Step 1 — Resolve agent route (await defensively — may be sync or async)
                     const route = await runtime.channel.routing.resolveAgentRoute({
@@ -242,8 +260,11 @@ export const agentNetworkChannel = {
                         conversationManager.registerInbound(event.sessionId, contact, remoteAddress);
                     }
                     else {
-                        // No address metadata — register with sessionId as fallback
-                        conversationManager.registerInbound(event.sessionId, event.sessionId, event.sessionId);
+                        // No MSTP address — Passport visitor or direct MSTP client.
+                        // Use visitor_name from session metadata (account-level identity
+                        // resolved by Connector) if available, else sessionId fallback.
+                        const contact = deriveSenderName(event);
+                        conversationManager.registerInbound(event.sessionId, contact, event.sessionId);
                     }
                 }
                 // Outbound sessions are handled by SessionLifecycle internally

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

package/package.json

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