@masons/agent-network 0.4.6 → 0.4.8

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;AAqB9D,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,yBAsYjC,CAAC"}

package/dist/channel.js

@@ -3,6 +3,7 @@ import createDebug from "debug";
 import { clearConnectorClient, clearConversationManager, extractNetworkConfig, initConnectorClient, initConversationManager, initToolConfig, requirePluginRuntime, } from "./config.js";
 import { ConnectorClient } from "./connector-client.js";
 import { ConversationManager } from "./conversation-manager.js";
+import { clearOwnerSessions, isOwnerSession, markOwnerSession, removeOwnerSession, setCurrentTurnIsOwner, } from "./owner-session-state.js";
 import { checkForUpdate } from "./update-check.js";
 const dbg = createDebug("agent-network:channel");
 // --- Sender identity ---
@@ -10,21 +11,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.
@@ -133,6 +145,9 @@ export const agentNetworkChannel = {
             // structured multi-step interactions, add a per-session dispatch queue.
             client.on("message_received", async (event) => {
                 dbg("routing inbound message sessionId=%s contentLength=%d", event.sessionId, event.content.length);
+                // --- Owner turn detection (#836) ---
+                // Set BEFORE dispatch so before_prompt_build can read it.
+                setCurrentTurnIsOwner(isOwnerSession(event.sessionId));
                 // --- Runtime guard ---
                 let runtime;
                 try {
@@ -159,13 +174,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({
@@ -235,6 +257,13 @@ export const agentNetworkChannel = {
             client.on("session_created", (event) => {
                 dbg("session created sessionId=%s direction=%s", event.sessionId, event.direction);
                 if (event.direction === "inbound") {
+                    // --- Owner identity binding (#836) ---
+                    // Connector sets `is_owner: true` when visitor_user_id === agent.userId.
+                    // Track this session so message_received can set the per-turn flag.
+                    if (event.metadata?.is_owner === true) {
+                        markOwnerSession(event.sessionId);
+                        dbg("owner session detected sessionId=%s", event.sessionId);
+                    }
                     const from = event.metadata?.from;
                     const remoteAddress = typeof from === "string" && from.length > 0 ? from : null;
                     if (remoteAddress) {
@@ -242,8 +271,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
@@ -260,6 +292,14 @@ export const agentNetworkChannel = {
             // --- Session ended + disconnect ---
             // SessionLifecycle handles session state transitions (session_ended, disconnected)
             // via its own event subscriptions. No CM calls needed here.
+            // Owner session cleanup (#836): remove from ownerSessionIds on session_ended.
+            client.on("session_ended", (event) => {
+                removeOwnerSession(event.sessionId);
+            });
+            // On disconnect, all sessions are invalid — clear owner state.
+            client.on("disconnected", () => {
+                clearOwnerSessions();
+            });
             // --- Error handling ---
             // Must register before connect() — unhandled "error" events crash the process.
             client.on("error", (err) => {

package/dist/owner-session-state.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Owner Session State — tracks which MSTP sessions belong to the agent's owner.
+ *
+ * When the Connector detects that a Passport visitor is the agent's owner
+ * (deterministic userId comparison, #836), it sets `is_owner: true` in the
+ * SESSION_CREATED metadata. This module maintains the Plugin-side state:
+ *
+ * - `ownerSessionIds`: Set of session IDs where the visitor is the owner.
+ *   Populated on session_created, cleaned up on session_ended / disconnected.
+ *
+ * - `currentTurnIsOwner`: Per-turn flag set in the message_received handler
+ *   and read in before_prompt_build. Reset after each read to avoid stale state.
+ *   Race condition note (from design review): if two messages arrive on
+ *   different sessions concurrently, the flag may reflect the wrong session.
+ *   Fail-safe: owner gets the routing warning (same as today's behavior).
+ *   Acceptable for Phase 1 — OpenClaw processes turns sequentially per agent.
+ *
+ * Module-level singleton — shared between channel.ts (write) and plugin.ts (read).
+ * Same pattern as owner-notes.ts.
+ */
+/** Mark a session as belonging to the owner. */
+export declare function markOwnerSession(sessionId: string): void;
+/** Remove a session from owner tracking (session ended or disconnected). */
+export declare function removeOwnerSession(sessionId: string): void;
+/** Clear all owner sessions (connection lost — all sessions are invalid). */
+export declare function clearOwnerSessions(): void;
+/** Check if a session belongs to the owner. */
+export declare function isOwnerSession(sessionId: string): boolean;
+/**
+ * Set the per-turn owner flag. Called in message_received before dispatch.
+ * The flag is consumed (read + reset) by before_prompt_build.
+ */
+export declare function setCurrentTurnIsOwner(value: boolean): void;
+/**
+ * Consume the per-turn owner flag. Returns the value and resets to false.
+ * Consuming prevents stale state from leaking into subsequent turns.
+ */
+export declare function consumeCurrentTurnIsOwner(): boolean;
+//# sourceMappingURL=owner-session-state.d.ts.map

package/dist/owner-session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-session-state.d.ts","sourceRoot":"","sources":["../src/owner-session-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAgBH,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE1D;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAInD"}

package/dist/owner-session-state.js

@@ -0,0 +1,66 @@
+/**
+ * Owner Session State — tracks which MSTP sessions belong to the agent's owner.
+ *
+ * When the Connector detects that a Passport visitor is the agent's owner
+ * (deterministic userId comparison, #836), it sets `is_owner: true` in the
+ * SESSION_CREATED metadata. This module maintains the Plugin-side state:
+ *
+ * - `ownerSessionIds`: Set of session IDs where the visitor is the owner.
+ *   Populated on session_created, cleaned up on session_ended / disconnected.
+ *
+ * - `currentTurnIsOwner`: Per-turn flag set in the message_received handler
+ *   and read in before_prompt_build. Reset after each read to avoid stale state.
+ *   Race condition note (from design review): if two messages arrive on
+ *   different sessions concurrently, the flag may reflect the wrong session.
+ *   Fail-safe: owner gets the routing warning (same as today's behavior).
+ *   Acceptable for Phase 1 — OpenClaw processes turns sequentially per agent.
+ *
+ * Module-level singleton — shared between channel.ts (write) and plugin.ts (read).
+ * Same pattern as owner-notes.ts.
+ */
+// ---------------------------------------------------------------------------
+// State
+// ---------------------------------------------------------------------------
+/** Session IDs where the visitor has been identified as the agent's owner. */
+const ownerSessionIds = new Set();
+/** Whether the current LLM turn was triggered by an owner session. */
+let currentTurnIsOwner = false;
+// ---------------------------------------------------------------------------
+// Write API (called from channel.ts)
+// ---------------------------------------------------------------------------
+/** Mark a session as belonging to the owner. */
+export function markOwnerSession(sessionId) {
+    ownerSessionIds.add(sessionId);
+}
+/** Remove a session from owner tracking (session ended or disconnected). */
+export function removeOwnerSession(sessionId) {
+    ownerSessionIds.delete(sessionId);
+}
+/** Clear all owner sessions (connection lost — all sessions are invalid). */
+export function clearOwnerSessions() {
+    ownerSessionIds.clear();
+    currentTurnIsOwner = false;
+}
+/** Check if a session belongs to the owner. */
+export function isOwnerSession(sessionId) {
+    return ownerSessionIds.has(sessionId);
+}
+/**
+ * Set the per-turn owner flag. Called in message_received before dispatch.
+ * The flag is consumed (read + reset) by before_prompt_build.
+ */
+export function setCurrentTurnIsOwner(value) {
+    currentTurnIsOwner = value;
+}
+// ---------------------------------------------------------------------------
+// Read API (called from plugin.ts)
+// ---------------------------------------------------------------------------
+/**
+ * Consume the per-turn owner flag. Returns the value and resets to false.
+ * Consuming prevents stale state from leaking into subsequent turns.
+ */
+export function consumeCurrentTurnIsOwner() {
+    const value = currentTurnIsOwner;
+    currentTurnIsOwner = false;
+    return value;
+}

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

@@ -5,6 +5,7 @@ import { agentNetworkChannel } from "./channel.js";
 import { configureInteractive } from "./cli-setup.js";
 import { detectPendingState, getStateCacheGeneration, initPluginRuntime, } from "./config.js";
 import { ownerNotesQueue } from "./owner-notes.js";
+import { consumeCurrentTurnIsOwner } from "./owner-session-state.js";
 import { registerTools } from "./tools.js";
 import { getUpdateInfo } from "./update-check.js";
 import { PLUGIN_VERSION } from "./version.js";
@@ -173,13 +174,46 @@ const plugin = {
                 !state.needsProfile &&
                 !state.pendingTarget) {
                 if (channelId === "agent-network") {
-                    // Turn triggered by a remote agent — warn about routing.
-                    // The LLM's text reply will go to that agent via deliver callback.
-                    dynamicContext =
-                        "[Agent Network — Routing] This turn was triggered by a message " +
-                            "on the agent network. Your text reply will be sent to that sender — " +
-                            "your owner (Principal) will NOT see it. To report something to your owner, " +
-                            "call masons_note_for_owner.";
+                    // --- Owner identity binding (#836) ---
+                    // Consume the per-turn owner flag set by channel.ts message_received.
+                    // Must consume on every agent-network turn to prevent stale state.
+                    const turnIsOwner = consumeCurrentTurnIsOwner();
+                    if (turnIsOwner) {
+                        // Owner visiting via Passport — no routing warning needed.
+                        // The LLM's text reply goes to the owner (the visitor IS the owner).
+                        // Drain pending notes: owner is here, deliver them directly.
+                        const notes = ownerNotesQueue.drain();
+                        const notesBlock = notes.length > 0
+                            ? "\n\nPending updates from the agent network:\n" +
+                                notes
+                                    .map((n) => {
+                                    const fromStr = n.from ? `@${n.from}` : "agent";
+                                    const timeStr = formatTimeAgo(n.timestamp);
+                                    const preview = n.content.length > 100
+                                        ? `${n.content.slice(0, 100)}...`
+                                        : n.content;
+                                    return `• ${fromStr} (${timeStr}): "${preview}"`;
+                                })
+                                    .join("\n")
+                            : "";
+                        dynamicContext =
+                            "[Agent Network — Owner via Passport] Your owner (Principal) is talking to you " +
+                                "via Passport (your public web chat page where visitors can reach you). " +
+                                "This IS your owner — respond naturally, no need to ask who they are. " +
+                                "Your text reply goes directly to your owner. " +
+                                "You can share information freely — no information boundary applies. " +
+                                "Do NOT use masons_note_for_owner — your owner is right here." +
+                                notesBlock;
+                    }
+                    else {
+                        // Turn triggered by a remote agent/stranger — warn about routing.
+                        // The LLM's text reply will go to that sender via deliver callback.
+                        dynamicContext =
+                            "[Agent Network — Routing] This turn was triggered by a message " +
+                                "on the agent network. Your text reply will be sent to that sender — " +
+                                "your owner (Principal) will NOT see it. To report something to your owner, " +
+                                "call masons_note_for_owner.";
+                    }
                 }
                 else {
                     // Owner turn (or other channel) — drain pending notes if any.

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.8";
 //# 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.8";

package/package.json

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