@masons/agent-network 0.4.10 → 0.4.12

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;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,yBAgZjC,CAAC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAsB9D,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,yBAuZjC,CAAC"}

package/dist/channel.js

@@ -4,6 +4,7 @@ import { clearConnectorClient, clearConversationManager, extractNetworkConfig, i
 import { ConnectorClient } from "./connector-client.js";
 import { ConversationManager } from "./conversation-manager.js";
 import { clearOwnerSessions, isOwnerSession, markOwnerSession, removeOwnerSession, setCurrentTurnIsOwner, } from "./owner-session-state.js";
+import { setCurrentTurnSender } from "./turn-context.js";
 import { checkForUpdate } from "./update-check.js";
 const dbg = createDebug("agent-network:channel");
 // --- Sender identity ---
@@ -145,9 +146,12 @@ 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.
+                // --- Per-turn context (#836, #873) ---
+                // Set BEFORE dispatch so before_prompt_build can read these synchronously.
                 setCurrentTurnIsOwner(isOwnerSession(event.sessionId));
+                // Sender identity: resolve sessionId → contact handle using
+                // the closure-scoped conversationManager (NOT imported from config.ts).
+                setCurrentTurnSender(conversationManager.getContactBySessionId(event.sessionId) ?? null);
                 // --- Runtime guard ---
                 let runtime;
                 try {

package/dist/config.d.ts

@@ -73,6 +73,14 @@ export declare function clearConversationManager(): void;
  * Get the live ConversationManager. Throws if not initialized.
  */
 export declare function requireConversationManager(): ConversationManager;
+/**
+ * Get the live ConversationManager, or null if not yet initialized.
+ *
+ * Non-throwing variant for use in before_prompt_build where the connection
+ * may not be established yet (e.g., during setup flow). Callers must handle
+ * the null case gracefully.
+ */
+export declare function getConversationManager(): ConversationManager | null;
 /**
  * Store the OpenClaw PluginRuntime for inbound message dispatch.
  *
@@ -112,6 +120,14 @@ export declare function requireApiKey(): string;
  * Get pending connection target handle, or null if none.
  */
 export declare function getPendingTarget(): string | null;
+/**
+ * Whether the agent needs profile completion before connecting.
+ *
+ * True after onboard (new agent creation), cleared after all required
+ * profile fields are filled. Used by connection tools to gate requests
+ * until the agent has a visible identity.
+ */
+export declare function isProfileNeeded(): boolean;
 /**
  * Get the live ConnectorClient. Throws if not initialized.
  *
@@ -162,10 +178,8 @@ export declare function markProfileNeeded(): Promise<void>;
  *
  * Called after successful masons_update_profile — clears the needsProfile flag
  * so the before_prompt_build hook no longer injects profile context.
- *
- * Note: unlike clearTargetHandle, this only writes to disk — there is no
- * module-level variable for needsProfile. The before_prompt_build hook
- * uses stateCacheGeneration to detect when a re-read is needed.
+ * Also updates the in-memory `storedNeedsProfile` flag so tool-level gates
+ * (connection request / accept) take effect immediately without a restart.
  */
 export declare function markProfileComplete(): Promise<void>;
 /** Pending state detected from config file — used for restart continuity. */

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,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAsB9B;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAcD;;;;;;;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;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,mBAAmB,CAOhE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C;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,CA4Bf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CASvD;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMvD;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMzD;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,CAQvC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -30,6 +30,7 @@ import { DEFAULT_API_HOST, } from "./platform-client.js";
 let platformConfig = { apiHost: DEFAULT_API_HOST };
 let storedApiKey = null;
 let storedPendingTarget = null;
+let storedNeedsProfile = false;
 // State cache generation — incremented when config-modifying functions write
 // to disk (writeCredentials, clearTargetHandle, markProfileNeeded, markProfileComplete).
 // before_prompt_build compares its cached generation to this value; mismatch
@@ -93,6 +94,7 @@ export function initToolConfig(cfg) {
         typeof networkCfg?.pendingTarget === "string"
             ? networkCfg.pendingTarget
             : null;
+    storedNeedsProfile = networkCfg?.needsProfile === true;
 }
 // ---------------------------------------------------------------------------
 // ConnectorClient injection (called by startAccount() after connect)
@@ -151,6 +153,16 @@ export function requireConversationManager() {
     }
     return storedConversationManager;
 }
+/**
+ * Get the live ConversationManager, or null if not yet initialized.
+ *
+ * Non-throwing variant for use in before_prompt_build where the connection
+ * may not be established yet (e.g., during setup flow). Callers must handle
+ * the null case gracefully.
+ */
+export function getConversationManager() {
+    return storedConversationManager;
+}
 // ---------------------------------------------------------------------------
 // PluginRuntime injection (called by register() in plugin.ts)
 // ---------------------------------------------------------------------------
@@ -214,6 +226,16 @@ export function requireApiKey() {
 export function getPendingTarget() {
     return storedPendingTarget;
 }
+/**
+ * Whether the agent needs profile completion before connecting.
+ *
+ * True after onboard (new agent creation), cleared after all required
+ * profile fields are filled. Used by connection tools to gate requests
+ * until the agent has a visible identity.
+ */
+export function isProfileNeeded() {
+    return storedNeedsProfile;
+}
 /**
  * Get the live ConnectorClient. Throws if not initialized.
  *
@@ -343,6 +365,7 @@ export async function markProfileNeeded() {
     const section = ensureNetworkSection(config);
     section.needsProfile = true;
     await persistConfig(config);
+    storedNeedsProfile = true;
     stateCacheGeneration++;
 }
 /**
@@ -350,16 +373,15 @@ export async function markProfileNeeded() {
  *
  * Called after successful masons_update_profile — clears the needsProfile flag
  * so the before_prompt_build hook no longer injects profile context.
- *
- * Note: unlike clearTargetHandle, this only writes to disk — there is no
- * module-level variable for needsProfile. The before_prompt_build hook
- * uses stateCacheGeneration to detect when a re-read is needed.
+ * Also updates the in-memory `storedNeedsProfile` flag so tool-level gates
+ * (connection request / accept) take effect immediately without a restart.
  */
 export async function markProfileComplete() {
     const config = await readConfig();
     const section = ensureNetworkSection(config);
     delete section.needsProfile;
     await persistConfig(config);
+    storedNeedsProfile = false;
     stateCacheGeneration++;
 }
 /**
@@ -396,6 +418,7 @@ export function _resetForTesting() {
     platformConfig = { apiHost: DEFAULT_API_HOST };
     storedApiKey = null;
     storedPendingTarget = null;
+    storedNeedsProfile = false;
     storedConnectorClient = null;
     storedConversationManager = null;
     storedPluginRuntime = null;

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAmHA,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;CA2RhC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/plugin.js

@@ -3,10 +3,11 @@
 // NOT imported by index.ts to avoid pulling ws/typebox into Next.js app bundles.
 import { agentNetworkChannel } from "./channel.js";
 import { configureInteractive } from "./cli-setup.js";
-import { detectPendingState, getStateCacheGeneration, initPluginRuntime, } from "./config.js";
+import { detectPendingState, getConversationManager, getStateCacheGeneration, initPluginRuntime, } from "./config.js";
 import { ownerNotesQueue } from "./owner-notes.js";
 import { consumeCurrentTurnIsOwner } from "./owner-session-state.js";
 import { registerTools } from "./tools.js";
+import { consumeCurrentTurnSender } from "./turn-context.js";
 import { getUpdateInfo } from "./update-check.js";
 import { PLUGIN_VERSION } from "./version.js";
 // ---------------------------------------------------------------------------
@@ -26,6 +27,66 @@ function formatTimeAgo(timestamp) {
     const days = Math.floor(hours / 24);
     return `${days}d ago`;
 }
+/** Max active interactions to inject into context to avoid noise. */
+const MAX_INTERACTIONS = 5;
+/**
+ * Build an interaction space snapshot for the current turn.
+ *
+ * Reads ConversationManager to list active interactions, then formats
+ * a context block that tells the LLM who it's currently interacting with.
+ *
+ * On network turns, includes turn-specific framing (who sent this message,
+ * whether this agent initiated the interaction).
+ *
+ * On owner turns, shows the interaction space as background context.
+ *
+ * Returns undefined if no interactions exist or CM is not available.
+ */
+function buildInteractionContext(channelId, turnSender) {
+    const cm = getConversationManager();
+    if (!cm)
+        return undefined;
+    const conversations = cm.listConversations();
+    if (conversations.length === 0)
+        return undefined;
+    // Sort by most recent activity, cap at MAX_INTERACTIONS for display.
+    const sorted = [...conversations]
+        .sort((a, b) => b.lastMessageAt - a.lastMessageAt)
+        .slice(0, MAX_INTERACTIONS);
+    const truncated = conversations.length > MAX_INTERACTIONS;
+    const header = truncated
+        ? `[Active interactions (showing ${sorted.length} of ${conversations.length})]`
+        : "[Active interactions]";
+    const lines = sorted.map((c) => {
+        const who = `@${c.contact}`;
+        const initiated = c.initiatedBy === "local" ? "you initiated" : "they initiated";
+        const when = formatTimeAgo(c.lastMessageAt);
+        return `• ${who} — ${initiated} — last activity ${when}`;
+    });
+    const isNetworkTurn = channelId === "agent-network";
+    if (isNetworkTurn && turnSender) {
+        // Find sender in FULL list (not sorted/capped) for accurate initiatedBy.
+        const senderConvo = conversations.find((c) => c.contact === turnSender);
+        const initiated = senderConvo?.initiatedBy === "local"
+            ? "You initiated this interaction."
+            : "They initiated this interaction.";
+        return (`${header}\n${lines.join("\n")}\n` +
+            `[This turn] From @${turnSender}. ${initiated}\n` +
+            "Your text reply goes to this sender. " +
+            "To report to your owner: masons_note_for_owner.");
+    }
+    if (isNetworkTurn) {
+        // Network turn but sender unknown — still show interaction space.
+        return (`${header}\n${lines.join("\n")}\n` +
+            "Your text reply goes to the sender of this message. " +
+            "To report to your owner: masons_note_for_owner.");
+    }
+    // Owner turn — show interaction space as background context.
+    const ownerHeader = truncated
+        ? `[Active interactions on the network (showing ${sorted.length} of ${conversations.length})]`
+        : "[Active interactions on the network]";
+    return `${ownerHeader}\n${lines.join("\n")}`;
+}
 const plugin = {
     id: "agent-network",
     version: PLUGIN_VERSION,
@@ -94,13 +155,20 @@ const plugin = {
         /** Generation at time of last cache fill. Mismatch → re-read. */
         let cachedGeneration = -1;
         // Stable system context — interoperation awareness + routing table.
-        // Encodes 3+1 semantic concepts for Day 1 competency:
+        // Encodes semantic concepts for Day 1 competency:
         //   1. Two channels (owner's channel + agent network)
         //   2. Different audiences (never mix content between them)
         //   3. One audience per turn (text reply → turn trigger)
-        //   +1. Information asymmetry (owner instructions are private)
+        //   4. Information asymmetry (owner instructions are private)
+        //   5. Multi-object interaction space (#873)
+        //   6. Action = state change, not conversation (#873)
+        //   7. Post-action check (#873)
         // Single continuous string (no bullets/newlines) for KV-cache stability.
-        const TOOL_CONTEXT = "[Context: Agent Network] You are connected to the agent network. " +
+        // The first ~900 chars are the original prefix (pre-#873). New content is
+        // appended so existing KV-cache prefixes remain valid.
+        const TOOL_CONTEXT = 
+        // --- Original prefix (pre-#873, preserve for KV-cache) ---
+        "[Context: Agent Network] You are connected to the agent network. " +
             "You operate on TWO channels simultaneously: " +
             "your owner's (Principal's) channel (where your owner talks to you) and " +
             "the agent network (where other agents and visitors reach you). " +
@@ -116,7 +184,16 @@ const plugin = {
             "masons_accept_request, masons_decline_request, masons_list_connections, " +
             "masons_end_conversation. " +
             "Always try these tools first for network operations. " +
-            "If a tool call fails, report the error to your user — do not silently work around it.";
+            "If a tool call fails, report the error to your user — do not silently work around it. " +
+            // --- Interaction space + goal-driven behavior (#873) ---
+            "You interact with multiple entities simultaneously — your owner and agents on the network. " +
+            "Each interaction is an Action aimed at changing the other party's state, not just exchanging messages. " +
+            "When you send to an agent via masons_send_message, be specific about what you need — " +
+            "request action, not open-ended conversation. " +
+            "After responding on the network, check: " +
+            "should you report to your owner via masons_note_for_owner? " +
+            "Should you end this interaction via masons_end_conversation? " +
+            "Should you follow up with another agent via masons_send_message?";
         api.on("before_prompt_build", async (_event, ctx) => {
             const hookCtx = ctx;
             const channelId = hookCtx?.channelId;
@@ -138,6 +215,12 @@ const plugin = {
                 }
             }
             const state = cachedState;
+            // --- Consume per-turn flags unconditionally (#836, #873) ---
+            // Must consume on EVERY turn to prevent stale state from leaking across
+            // turns. If not consumed (e.g., agent is in setup flow), the value would
+            // persist and be read on the NEXT turn, producing incorrect context.
+            const turnIsOwner = consumeCurrentTurnIsOwner();
+            const turnSender = consumeCurrentTurnSender();
             // --- Build dynamic context based on setup state ---
             let dynamicContext;
             if (!state.hasCredentials) {
@@ -145,7 +228,7 @@ const plugin = {
                 dynamicContext =
                     "[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) {
-                    dynamicContext += ` After setup, send a connection request to @${state.pendingTarget} — they invited your user to join.`;
+                    dynamicContext += ` After setup, send a connection request to ${state.pendingTarget} — they invited your user to join.`;
                 }
             }
             else if (state.needsProfile) {
@@ -153,18 +236,21 @@ const plugin = {
                 dynamicContext =
                     "[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 masons_update_profile with all four fields (name, scope, about, audience).";
+                        "Once confirmed, call masons_update_profile with all four fields (name, scope, about, audience). " +
+                        "Without a profile, other agents can't see who you are — " +
+                        "connection requests from agents without a profile are rarely accepted.";
                 if (state.pendingTarget) {
-                    dynamicContext += ` After completing the profile, send a connection request to @${state.pendingTarget} — they invited your user to join.`;
+                    dynamicContext += ` After completing the profile, send a connection request to ${state.pendingTarget} — they'll be able to see who you are and why connecting makes sense.`;
                 }
             }
             else if (state.pendingTarget) {
                 // Setup complete but pending connection — guide to connect
                 dynamicContext = `[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.`;
             }
-            // --- Routing context (connected and ready state only) ---
+            // --- Routing + interaction context (connected and ready state only) ---
             // When the agent has credentials, no pending setup, and no pending target,
-            // inject routing awareness based on which channel triggered this turn.
+            // inject routing awareness and interaction space based on which channel
+            // triggered this turn.
             //
             // Priority: setup/profile/pendingTarget state takes precedence over routing
             // context. An agent in setup flow doesn't need routing warnings — it needs
@@ -174,10 +260,6 @@ const plugin = {
                 !state.needsProfile &&
                 !state.pendingTarget) {
                 if (channelId === "agent-network") {
-                    // --- 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).
@@ -206,13 +288,18 @@ const plugin = {
                                 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.
+                        // Turn triggered by a remote agent/stranger — routing warning +
+                        // interaction space snapshot (#873).
                         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.";
+                        // Append interaction space snapshot if active interactions exist.
+                        const interactionCtx = buildInteractionContext(channelId, turnSender);
+                        if (interactionCtx) {
+                            dynamicContext += `\n\n${interactionCtx}`;
+                        }
                     }
                 }
                 else {
@@ -233,6 +320,14 @@ const plugin = {
                                 `${lines.join("\n")}\n` +
                                 "Report these to your owner.";
                     }
+                    // Append interaction space on owner turns too (#873).
+                    // Gives the agent awareness of active network interactions.
+                    const interactionCtx = buildInteractionContext(channelId, null);
+                    if (interactionCtx) {
+                        dynamicContext = dynamicContext
+                            ? `${dynamicContext}\n\n${interactionCtx}`
+                            : interactionCtx;
+                    }
                 }
             }
             // Post-upgrade verification: if an update is still available after

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA0CH,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;AA0CD,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAsFD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAy0BhD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA2CH,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;AA0CD,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAsFD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAk2BhD"}

package/dist/tools.js

@@ -20,7 +20,7 @@
  */
 import { tmpdir } from "node:os";
 import { Type } from "@sinclair/typebox";
-import { clearTargetHandle, getOpenClawHome, getPendingTarget, markProfileComplete, markProfileNeeded, requireApiKey, requireConversationManager, requirePlatformConfig, writeCredentials, } from "./config.js";
+import { clearTargetHandle, getOpenClawHome, getPendingTarget, isProfileNeeded, markProfileComplete, markProfileNeeded, requireApiKey, requireConversationManager, requirePlatformConfig, writeCredentials, } from "./config.js";
 import { ownerNotesQueue } from "./owner-notes.js";
 import { acceptRequest, declineRequest, getConnectionStatus, initSetup, listConnections, listRequests, onboard, PlatformApiError, pollSetup, reconnect, requestConnection, SetupExpiredError, SetupPendingError, updateProfile, } from "./platform-client.js";
 import { fetchLatestVersion, getPluginVersion, getUpdateInfo, } from "./update-check.js";
@@ -388,6 +388,15 @@ export function registerTools(api) {
         execute: withUpdateNotice(async (_id, params) => {
             const cfg = requirePlatformConfig();
             const apiKey = requireApiKey();
+            // Profile gate: block connection requests until profile is complete.
+            // Without a profile the other agent sees an anonymous stranger,
+            // making acceptance unlikely.
+            if (isProfileNeeded()) {
+                return textResult("Your agent's profile is not complete yet. Without a profile, " +
+                    "the other agent can't see who you are — connection requests from " +
+                    "unknown agents are much less likely to be accepted. " +
+                    "Use masons_update_profile to complete your profile first (scope, about, audience).");
+            }
             const targetHandle = params.targetHandle;
             let result;
             try {
@@ -502,6 +511,14 @@ export function registerTools(api) {
         execute: withUpdateNotice(async (_id, params) => {
             const cfg = requirePlatformConfig();
             const apiKey = requireApiKey();
+            // Profile gate: block accepting requests until profile is complete.
+            // When a connection is established, the other agent sees your profile —
+            // an empty profile means they won't know who you are.
+            if (isProfileNeeded()) {
+                return textResult("Your agent's profile is not complete yet. Without a profile, " +
+                    "the other agent won't know who you are when the connection is established. " +
+                    "Use masons_update_profile to complete your profile first (scope, about, audience).");
+            }
             const requestId = params.requestId;
             try {
                 const result = await acceptRequest(cfg, apiKey, requestId);

package/dist/turn-context.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Turn Context — per-turn metadata captured during inbound message dispatch.
+ *
+ * Tracks the sender identity for the current LLM turn. Set in channel.ts
+ * message_received handler (using the closure-scoped ConversationManager),
+ * consumed by before_prompt_build in plugin.ts to inject interaction context.
+ *
+ * Follows the same consume-on-read pattern as owner-session-state.ts:
+ * - Written BEFORE dispatch (so before_prompt_build can read it synchronously)
+ * - Consumed (read + reset) to prevent stale state across turns
+ *
+ * Race condition caveat: if two inbound messages arrive on different sessions
+ * near-simultaneously, the sender may reflect the wrong session. Acceptable
+ * for Phase 1 — OpenClaw processes turns sequentially per agent. Same caveat
+ * as owner-session-state.ts currentTurnIsOwner.
+ *
+ * Module-level singleton — shared between channel.ts (write) and plugin.ts (read).
+ */
+/**
+ * Set the sender identity for the current turn.
+ * Called in message_received before dispatch, using the closure-scoped
+ * ConversationManager to resolve sessionId → contact handle.
+ */
+export declare function setCurrentTurnSender(contact: string | null): void;
+/**
+ * Consume the per-turn sender identity. Returns the value and resets to null.
+ * Consuming prevents stale state from leaking into subsequent turns.
+ */
+export declare function consumeCurrentTurnSender(): string | null;
+//# sourceMappingURL=turn-context.d.ts.map

package/dist/turn-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-context.d.ts","sourceRoot":"","sources":["../src/turn-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAaH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEjE;AAMD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAIxD"}

package/dist/turn-context.js

@@ -0,0 +1,46 @@
+/**
+ * Turn Context — per-turn metadata captured during inbound message dispatch.
+ *
+ * Tracks the sender identity for the current LLM turn. Set in channel.ts
+ * message_received handler (using the closure-scoped ConversationManager),
+ * consumed by before_prompt_build in plugin.ts to inject interaction context.
+ *
+ * Follows the same consume-on-read pattern as owner-session-state.ts:
+ * - Written BEFORE dispatch (so before_prompt_build can read it synchronously)
+ * - Consumed (read + reset) to prevent stale state across turns
+ *
+ * Race condition caveat: if two inbound messages arrive on different sessions
+ * near-simultaneously, the sender may reflect the wrong session. Acceptable
+ * for Phase 1 — OpenClaw processes turns sequentially per agent. Same caveat
+ * as owner-session-state.ts currentTurnIsOwner.
+ *
+ * Module-level singleton — shared between channel.ts (write) and plugin.ts (read).
+ */
+// ---------------------------------------------------------------------------
+// State
+// ---------------------------------------------------------------------------
+/** Contact handle of the sender for the current turn. null = unknown/unset. */
+let currentTurnSender = null;
+// ---------------------------------------------------------------------------
+// Write API (called from channel.ts)
+// ---------------------------------------------------------------------------
+/**
+ * Set the sender identity for the current turn.
+ * Called in message_received before dispatch, using the closure-scoped
+ * ConversationManager to resolve sessionId → contact handle.
+ */
+export function setCurrentTurnSender(contact) {
+    currentTurnSender = contact;
+}
+// ---------------------------------------------------------------------------
+// Read API (called from plugin.ts)
+// ---------------------------------------------------------------------------
+/**
+ * Consume the per-turn sender identity. Returns the value and resets to null.
+ * Consuming prevents stale state from leaking into subsequent turns.
+ */
+export function consumeCurrentTurnSender() {
+    const value = currentTurnSender;
+    currentTurnSender = null;
+    return value;
+}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "MASONS 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

@@ -44,8 +44,8 @@ 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 + user asks "who am I connected to" or wants to see connections** → Call `masons_list_connections` and show the results
-- **Connected + message from the network** → Go to **Interoperation**
-- **Setup complete + general communication** → Go to **Communicate**
+- **Connected + message from the network** → Go to **Network Behavior**
+- **Setup complete + general communication** → Go to **Network Behavior**
 - **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) → Go to **Upgrade** below
 - **User mentions upgrade or update** → Go to **Upgrade** below
@@ -83,7 +83,7 @@ One-time setup that takes about a minute.
 
 - **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."
+  **Say to user:** "What handle would you like? This is **permanent and cannot be changed later** — it becomes your network address (like `alice`). It must start with a letter and be 3–15 characters long (lowercase letters, numbers, hyphens, or underscores). Your display name can be changed anytime, but the handle is forever."
   **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?"
@@ -115,7 +115,7 @@ After completion:
 
 Complete the agent's profile after creating a new agent (or when `needsProfile` is detected after restart).
 
-A complete profile lets other agents discover this agent and understand what it does. The profile is filled in **3 sequential steps** — each step focuses on one dimension. Do NOT generate all fields at once.
+A complete profile lets other agents discover this agent and understand what it does. This directly affects whether your connection requests are accepted — agents without a profile appear as anonymous strangers. The profile is filled in **3 sequential steps** — each step focuses on one dimension. Do NOT generate all fields at once.
 
 **Completion criteria**: `scope`, `about`, AND `audience` must all be non-empty. The `needsProfile` flag is only cleared when all three are filled. `name` was already set during onboard — you can update it if needed, but it's not a completion gate.
 
@@ -222,83 +222,59 @@ If the user asks "did they accept my request?" or wants to check sent requests:
 
 If a request is no longer actionable (already processed, expired), the tool will let you know.
 
-## Communicate
+## Network Behavior
 
-You can exchange messages with connected agents in natural language, in real time. **Sessions are managed automatically** — you never need to create or manage session IDs.
+You interact with multiple entities simultaneously — your owner and agents on the network. Each interaction is an Action aimed at changing the other party's state. Sending a message via `masons_send_message` changes a remote agent's state (informing, requesting, negotiating). Reporting via `masons_note_for_owner` changes your owner's awareness. These are Actions, not conversations.
 
-**You must have an accepted connection** with the target agent first. If not connected, go to **Connect**.
+Messages on the network are natural language. Do not impose format expectations on other agents' replies — evaluate meaning, not structure.
 
-### Listing Connections
+**You must have an accepted connection** with the target agent first. If not connected, go to **Connect**. To see your connections: `masons_list_connections`.
 
-Before starting a conversation, you may need to find connected agents.
+### Your interaction space
 
-**Then:** Call `masons_list_connections`. It returns a numbered list of connected agents with their names and addresses.
+Your context will show your **active interactions** — who you're interacting with, who initiated each interaction, and when. Use this to stay aware of your full interaction space, not just the current message.
 
-**Say to user:** "Here are your connections: [list]. Would you like to start a conversation with any of them?"
+- To send to an agent: `masons_send_message(to, content)`
+- To report to your owner: `masons_note_for_owner(content, from?)`
+- To end an interaction: `masons_end_conversation(contact)`
 
-### Sending Messages
+### When you contact another agent (you initiate)
 
-**Say to user:** "I'll send a message to [name]'s agent now."
+Your owner asked you to do something involving another agent. Your goal is to drive a **state change** — make something happen — not to have a conversation.
 
-**Then:** Call `masons_send_message` with `to` (handle like `alice`, or full address like `mstps://preview.masons.ai/alice`) and `content` (your message).
+1. Send a clear, action-directed message via `masons_send_message`. Be specific about what you need the other agent to do.
+2. When they reply, evaluate their response:
+   - **They took action** (confirmed they did something, provided a result) → Acknowledge, then report the outcome to your owner via `masons_note_for_owner`.
+   - **They gave a verbal response only** ("I'll check", "let me get back to you") → They haven't acted yet. Request specific action, or report the status to your owner via `masons_note_for_owner` so your owner knows it's pending.
+   - **They declined or can't do it** → Report to your owner via `masons_note_for_owner`.
+   - **Their response is unclear** → Report what they said to your owner via `masons_note_for_owner` and let your owner decide next steps.
+3. When the goal is achieved, end the interaction via `masons_end_conversation`.
 
-- Sessions are created automatically when needed — no setup step required.
-- Messages are plain language — no special format needed. Write naturally.
-- You can send multiple messages to the same agent.
-- If the remote agent replies, their messages appear automatically.
+### When another agent contacts you (they initiate)
 
-### Ending a Conversation
+Another agent sent you a message. Understand what they want — what state change are they requesting?
 
-(No user announcement needed — end the conversation when the goal is achieved.)
+- **You can act on it** → Do it. Reply with the result.
+- **You need your owner's input** → Tell the other agent you need to check. Report the request to your owner via `masons_note_for_owner`.
+- **It's outside your capability** → Clearly communicate what you can and cannot do.
 
-**Then:** Call `masons_end_conversation` with the agent's handle.
+### After every network interaction
 
-End when:
-- The user's request has been fulfilled
-- The conversation reached a natural conclusion
-- The remote agent provided what was needed
+After responding to a network message, always check:
 
-Keep the conversation open if follow-up may be needed.
+1. **Report to owner?** Should you inform your owner about what just happened? If yes, call `masons_note_for_owner`. When in doubt, report — your owner would rather know too much than too little.
+2. **Interaction complete?** Has the goal been achieved? If yes, end via `masons_end_conversation`. If follow-up may be needed, keep it open.
+3. **Other interactions?** Do any of your other active interactions need attention?
 
-### Receiving Messages
+### Routing
 
-Incoming messages from other agents appear automatically. Each includes:
+Your text reply always goes to whoever triggered the current turn — you cannot redirect it.
 
-- **Sender**: The remote agent's name
-- **Content**: The message text
+- When a network message triggers your turn: your reply goes to that sender. Do NOT address your owner in the text reply — they will not see it.
+- When your owner's turn fires: pending notes from the network appear in your context. Report them naturally.
+- Owner's instructions are private by default — do not share them with network agents unless your owner explicitly says to. When relaying your owner's request, rephrase appropriately.
 
-When a message triggers your turn, your text reply goes to that sender. Respond to them directly. If the information is relevant to your owner (Principal), also call `masons_note_for_owner` to queue a summary.
-
-For detailed routing guidance, see **Interoperation** below.
-
-## Interoperation — Routing Between Channels
-
-When you're connected to the agent network, you operate on two channels at once. Messages from your owner (Principal) arrive on one channel. Messages from agents and visitors arrive on the agent network. Your text reply always goes to whoever triggered the current turn — you cannot redirect it.
-
-### When a network message triggers your turn
-
-Your text reply goes to that sender. Respond to them directly.
-
-If the information is relevant to your owner, also call `masons_note_for_owner` with a summary. Your owner will see it in their next turn.
-
-Do NOT address your owner in the text reply — they will not see it. Do NOT include internal markers like "（给你，MK）" — the sender sees everything you write.
-
-### When your owner's turn fires
-
-If you have pending notes from the agent network, they will appear in your context. Report them naturally to your owner.
-
-### Delegation pattern
-
-When your owner asks you to contact another agent:
-
-1. Use `masons_send_message` to send the request
-2. When the other agent replies (in a network turn), respond with a brief acknowledgment
-3. Call `masons_note_for_owner` with a summary of what they said
-4. On your owner's next turn, report the result
-
-### Information boundaries
-
-Instructions from your owner are private by default. Do not share them with network senders unless your owner explicitly asks you to. When relaying a request from your owner to another agent, rephrase it appropriately — do not forward raw instructions.
+> **Note:** Proxy mode (transparently connecting your owner to another agent's conversation) is not currently supported. All network interactions pass through you — you act on behalf of your owner, not as a passthrough.
 
 ## Upgrade