@masons/agent-network 0.4.25 → 0.4.26

package/dist/channel.d.ts

@@ -1,6 +1,14 @@
 import type { AgentNetworkAccount } from "./config-schema.js";
 /** Get the stored owner Passport address (first is_owner visit). */
 export declare function getOwnerPassportAddress(): string | null;
+/**
+ * Consume the identity linking nudge flag. Destructive read — returns true
+ * at most once per detection cycle. Called by before_prompt_build on
+ * non-Passport owner turns to deliver the nudge where the action is relevant.
+ */
+export declare function consumeIdentityLinkingNudge(): boolean;
+/** Test-only: set the nudge flag without going through the detection path. */
+export declare function _setNudgePendingForTesting(value: boolean): void;
 interface ChannelMeta {
     name: string;
     description: string;

package/dist/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AA2B9D,oEAAoE;AACpE,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAUD,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,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,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;AAuDD,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;AAsQD,eAAO,MAAM,mBAAmB,EAAE,yBAwNjC,CAAC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAkC9D,oEAAoE;AACpE,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAIrD;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/D;AAUD,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,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,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;AAuDD,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;AA8PD,eAAO,MAAM,mBAAmB,EAAE,yBAyNjC,CAAC"}

package/dist/channel.js

@@ -5,7 +5,6 @@ import { ConnectorClient } from "./connector-client.js";
 import { ConversationManager } from "./conversation-manager.js";
 import { clearEnvironmentContext } from "./environment-context.js";
 import { extractHandleFromAddress } from "./handle-utils.js";
-import { ownerNotesQueue } from "./owner-notes.js";
 import { clearOwnerState, isOwnerAddress, markOwnerAddress, setCurrentTurnIsOwner, } from "./owner-session-state.js";
 import { setCurrentTurnSender } from "./turn-context.js";
 import { checkForUpdate } from "./update-check.js";
@@ -14,6 +13,13 @@ const dbg = createDebug("agent-network:channel");
 // Reset on startAccount(). isIdentityLinksConfigured() provides the
 // cross-restart idempotency (checks config file).
 let notificationAttempted = false;
+// Identity linking nudge — set when the owner first visits via Passport and
+// cross-channel linking is available. Delivered on the owner's next
+// non-Passport turn (Telegram/Feishu) where the linking action is relevant.
+// Separate from ownerNotesQueue to avoid the Passport drain deadlock (#1158):
+// the queue drains on ALL owner turns (including Passport), but this nudge
+// only fires on non-Passport owner turns.
+let identityLinkingNudgePending = false;
 // Owner's Passport address: recorded on first is_owner MESSAGE_RECEIVED.
 // Used by masons_link_identity tool to auto-include the Passport entry.
 let storedOwnerPassportAddress = null;
@@ -21,6 +27,21 @@ let storedOwnerPassportAddress = null;
 export function getOwnerPassportAddress() {
     return storedOwnerPassportAddress;
 }
+/**
+ * Consume the identity linking nudge flag. Destructive read — returns true
+ * at most once per detection cycle. Called by before_prompt_build on
+ * non-Passport owner turns to deliver the nudge where the action is relevant.
+ */
+export function consumeIdentityLinkingNudge() {
+    if (!identityLinkingNudgePending)
+        return false;
+    identityLinkingNudgePending = false;
+    return true;
+}
+/** Test-only: set the nudge flag without going through the detection path. */
+export function _setNudgePendingForTesting(value) {
+    identityLinkingNudgePending = value;
+}
 // --- Sender identity ---
 /**
  * Extract a human-readable name from the sender's metadata.
@@ -98,24 +119,17 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
             storedOwnerPassportAddress = fromAddress;
             dbg("recorded owner Passport address: %s", fromAddress);
         }
-        // --- dmScope-aware notification (2026-03-26, #986 redesign) ---
-        // Notify the owner about cross-channel identity linking availability.
-        // Notification is:
-        // - Skipped in "main" mode (linking has no effect — Gateway skips resolveLinkedPeerId)
-        // - Skipped if identityLinks already configured (already linked)
-        // - Sent once per startAccount lifecycle (in-memory idempotency)
-        // Content is channel-agnostic and language-neutral (semantic event, not identity claim).
+        // --- dmScope-aware identity linking nudge (#986 redesign, #1158 fix) ---
+        // Detect that identity linking is available but not configured.
+        // Sets a flag (NOT enqueued into ownerNotesQueue) for delivery on the
+        // owner's next non-Passport turn, where the linking action is relevant.
+        // Separated from the queue to avoid the Passport drain deadlock (#1158).
         if (getDmScope() !== "main" &&
             !isIdentityLinksConfigured() &&
             !notificationAttempted) {
             notificationAttempted = true;
-            ownerNotesQueue.enqueue({
-                content: "Owner visited via Passport (verified). " +
-                    "Cross-channel identity linking is available but not configured. " +
-                    "The owner can link their identity across channels so conversations share context.",
-                timestamp: Date.now(),
-            });
-            dbg("queued identity linking notification (dmScope=%s)", getDmScope());
+            identityLinkingNudgePending = true;
+            dbg("identity linking nudge pending (dmScope=%s)", getDmScope());
         }
     }
     setCurrentTurnIsOwner(isOwnerAddress(fromAddress));
@@ -294,6 +308,7 @@ export const agentNetworkChannel = {
             dbg("starting account %s", ctx.accountId);
             // Reset per-session state
             notificationAttempted = false;
+            identityLinkingNudgePending = false;
             storedOwnerPassportAddress = null;
             // Defensive: clear stale singletons from a previous cycle.
             // The abort handler intentionally leaves them alive for in-flight tool

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

@@ -2,7 +2,7 @@
 // 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 pluginManifest from "../openclaw.plugin.json" with { type: "json" };
-import { agentNetworkChannel } from "./channel.js";
+import { agentNetworkChannel, consumeIdentityLinkingNudge } from "./channel.js";
 import { configureInteractive } from "./cli-setup.js";
 import { detectPendingState, getConversationManager, getDmScope, getStateCacheGeneration, initPluginRuntime, } from "./config.js";
 import { getAgentIdentity } from "./environment-context.js";
@@ -30,6 +30,24 @@ function formatTimeAgo(timestamp) {
     const days = Math.floor(hours / 24);
     return `${days}d ago`;
 }
+/**
+ * Drain ownerNotesQueue and format into an "[Agent Network — Updates]" block.
+ * Returns null if the queue was empty.
+ */
+function drainAndFormatNotes(reportInstruction) {
+    const notes = ownerNotesQueue.drain();
+    if (notes.length === 0)
+        return null;
+    const lines = notes.map((n) => {
+        const fromStr = n.from ? `@${n.from}` : "agent";
+        const timeStr = formatTimeAgo(n.timestamp);
+        return `• ${fromStr} (${timeStr}): "${n.content}"`;
+    });
+    return ("[Agent Network — Updates]\n" +
+        "The following happened on the agent network since your last turn:\n" +
+        `${lines.join("\n")}\n` +
+        reportInstruction);
+}
 /** Max active interactions to inject into context to avoid noise. */
 const MAX_INTERACTIONS = 5;
 /**
@@ -268,12 +286,10 @@ const plugin = {
                         // Owner visiting via Passport — no routing warning needed.
                         // The LLM's text reply goes to the owner (the visitor IS the owner).
                         //
-                        // DO NOT drain ownerNotesQueue here (#986). Notes are meant for
-                        // non-Passport channels (Telegram/Feishu) where the owner can act
-                        // on them — e.g., identity linking notifications require the owner
-                        // to provide their Telegram ID, which only makes sense on Telegram.
-                        // Draining here would consume notifications on the same turn that
-                        // generated them, leaving nothing for the target channel.
+                        // Drain ownerNotesQueue (#1158). General notes from network turns
+                        // should reach the owner wherever they are — including Passport.
+                        // The identity linking nudge is handled separately (boolean flag
+                        // in channel.ts) and delivered only on non-Passport owner turns.
                         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). " +
@@ -281,6 +297,10 @@ const plugin = {
                                 "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.";
+                        const notesBlock = drainAndFormatNotes("Report these to your owner now — they are right here.");
+                        if (notesBlock) {
+                            dynamicContext += `\n\n${notesBlock}`;
+                        }
                     }
                     else {
                         // Turn triggered by a remote agent/stranger — routing warning +
@@ -317,18 +337,21 @@ const plugin = {
                 }
                 else {
                     // Owner turn (or other channel) — drain pending notes if any.
-                    const notes = ownerNotesQueue.drain();
-                    if (notes.length > 0) {
-                        const lines = notes.map((n) => {
-                            const fromStr = n.from ? `@${n.from}` : "agent";
-                            const timeStr = formatTimeAgo(n.timestamp);
-                            return `• ${fromStr} (${timeStr}): "${n.content}"`;
-                        });
-                        dynamicContext =
-                            "[Agent Network — Updates]\n" +
-                                "The following happened on the agent network since your last turn:\n" +
-                                `${lines.join("\n")}\n` +
-                                "Report these to your owner.";
+                    const notesBlock = drainAndFormatNotes("Report these to your owner.");
+                    if (notesBlock) {
+                        dynamicContext = notesBlock;
+                    }
+                    // Identity linking nudge — delivered here (non-Passport owner turn)
+                    // where the linking action is relevant (#1158).
+                    if (consumeIdentityLinkingNudge()) {
+                        const nudge = "[Agent Network — Identity Linking Available]\n" +
+                            "Your owner visited via Passport (verified). " +
+                            "Cross-channel identity linking is available but not configured. " +
+                            "The owner can link their identity across channels so conversations share context. " +
+                            "Suggest using masons_link_identity.";
+                        dynamicContext = dynamicContext
+                            ? `${dynamicContext}\n\n${nudge}`
+                            : nudge;
                     }
                     // Append interaction space on owner turns too (#873).
                     // Gives the agent awareness of active network interactions.

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

package/package.json

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