@masons/agent-network 0.4.12 → 0.4.14

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

@@ -6,6 +6,7 @@ import { configureInteractive } from "./cli-setup.js";
 import { detectPendingState, getConversationManager, getStateCacheGeneration, initPluginRuntime, } from "./config.js";
 import { ownerNotesQueue } from "./owner-notes.js";
 import { consumeCurrentTurnIsOwner } from "./owner-session-state.js";
+import { sentMessageBuffer } from "./sent-message-buffer.js";
 import { registerTools } from "./tools.js";
 import { consumeCurrentTurnSender } from "./turn-context.js";
 import { getUpdateInfo } from "./update-check.js";
@@ -300,6 +301,24 @@ const plugin = {
                         if (interactionCtx) {
                             dynamicContext += `\n\n${interactionCtx}`;
                         }
+                        // Append sent message context — cross-session bridge (#918).
+                        // When the LLM sent a message from the owner session via
+                        // masons_send_message, inject the content here so the LLM
+                        // knows what it previously said to this contact.
+                        if (turnSender) {
+                            const sentMsgs = sentMessageBuffer.getRecent(turnSender);
+                            if (sentMsgs.length > 0) {
+                                const lines = sentMsgs.map((m) => {
+                                    const preview = m.content.length > 100
+                                        ? `${m.content.slice(0, 100)}...`
+                                        : m.content;
+                                    return `• (${formatTimeAgo(m.timestamp)}): "${preview}"`;
+                                });
+                                dynamicContext +=
+                                    `\n\n[Your recent messages to @${turnSender}]\n` +
+                                        lines.join("\n");
+                            }
+                        }
                     }
                 }
                 else {

package/dist/sent-message-buffer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Sent Message Buffer — per-contact ring buffer of outgoing messages.
+ *
+ * When the LLM calls `masons_send_message`, the outgoing content is recorded
+ * here. On the next agent-network turn from that contact, `before_prompt_build`
+ * reads the buffer and injects the sent messages into `prependContext` so the
+ * LLM knows what it previously said.
+ *
+ * This is the reverse of `OwnerNotesQueue`:
+ * - OwnerNotesQueue: agent-network session → owner session
+ * - SentMessageBuffer: owner session → agent-network session
+ *
+ * Module-level singleton — shared between plugin.ts (read) and tools.ts (write).
+ *
+ * Lifecycle: in-memory only (D3). Lost on Gateway restart.
+ *
+ * @see docs/openclaw/interop-routing-system-design.md §7.1
+ */
+export interface SentMessage {
+    /** The message content that was sent. */
+    content: string;
+    /** When the message was sent (Date.now()). */
+    timestamp: number;
+}
+export declare class SentMessageBuffer {
+    private entries;
+    /** Max messages retained per contact. */
+    static readonly MAX_PER_CONTACT = 5;
+    /** Messages older than this are evicted. */
+    static readonly TTL_MS: number;
+    /** Max content length stored per message. Longer content is truncated at record time. */
+    static readonly MAX_CONTENT_LENGTH = 500;
+    /**
+     * Record an outgoing message to a contact.
+     * Called by `masons_send_message` after successful send.
+     */
+    record(contact: string, content: string): void;
+    /**
+     * Get recent sent messages for a contact. Non-destructive — the same
+     * messages may be relevant across multiple turns with the same contact.
+     * Returns messages in chronological order (oldest first). Returns empty
+     * array if no messages exist or all are stale.
+     */
+    getRecent(contact: string): SentMessage[];
+    /**
+     * Clear all entries. For testing only.
+     */
+    clear(): void;
+}
+export declare const sentMessageBuffer: SentMessageBuffer;
+//# sourceMappingURL=sent-message-buffer.d.ts.map

package/dist/sent-message-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sent-message-buffer.d.ts","sourceRoot":"","sources":["../src/sent-message-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAoC;IAEnD,yCAAyC;IACzC,MAAM,CAAC,QAAQ,CAAC,eAAe,KAAK;IACpC,4CAA4C;IAC5C,MAAM,CAAC,QAAQ,CAAC,MAAM,SAAkB;IACxC,yFAAyF;IACzF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,OAAO;IAEzC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA2B9C;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAoBzC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAMD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/sent-message-buffer.js

@@ -0,0 +1,90 @@
+/**
+ * Sent Message Buffer — per-contact ring buffer of outgoing messages.
+ *
+ * When the LLM calls `masons_send_message`, the outgoing content is recorded
+ * here. On the next agent-network turn from that contact, `before_prompt_build`
+ * reads the buffer and injects the sent messages into `prependContext` so the
+ * LLM knows what it previously said.
+ *
+ * This is the reverse of `OwnerNotesQueue`:
+ * - OwnerNotesQueue: agent-network session → owner session
+ * - SentMessageBuffer: owner session → agent-network session
+ *
+ * Module-level singleton — shared between plugin.ts (read) and tools.ts (write).
+ *
+ * Lifecycle: in-memory only (D3). Lost on Gateway restart.
+ *
+ * @see docs/openclaw/interop-routing-system-design.md §7.1
+ */
+// ---------------------------------------------------------------------------
+// Buffer
+// ---------------------------------------------------------------------------
+export class SentMessageBuffer {
+    entries = new Map();
+    /** Max messages retained per contact. */
+    static MAX_PER_CONTACT = 5;
+    /** Messages older than this are evicted. */
+    static TTL_MS = 30 * 60 * 1000; // 30 minutes
+    /** Max content length stored per message. Longer content is truncated at record time. */
+    static MAX_CONTENT_LENGTH = 500;
+    /**
+     * Record an outgoing message to a contact.
+     * Called by `masons_send_message` after successful send.
+     */
+    record(contact, content) {
+        const now = Date.now();
+        const key = contact.toLowerCase();
+        let list = this.entries.get(key);
+        if (!list) {
+            list = [];
+            this.entries.set(key, list);
+        }
+        // Evict stale entries
+        const cutoff = now - SentMessageBuffer.TTL_MS;
+        const fresh = list.filter((m) => m.timestamp > cutoff);
+        // Cap at MAX_PER_CONTACT (drop oldest)
+        if (fresh.length >= SentMessageBuffer.MAX_PER_CONTACT) {
+            fresh.shift();
+        }
+        // Truncate content to prevent unbounded memory growth
+        const stored = content.length > SentMessageBuffer.MAX_CONTENT_LENGTH
+            ? `${content.slice(0, SentMessageBuffer.MAX_CONTENT_LENGTH)}...`
+            : content;
+        fresh.push({ content: stored, timestamp: now });
+        this.entries.set(key, fresh);
+    }
+    /**
+     * Get recent sent messages for a contact. Non-destructive — the same
+     * messages may be relevant across multiple turns with the same contact.
+     * Returns messages in chronological order (oldest first). Returns empty
+     * array if no messages exist or all are stale.
+     */
+    getRecent(contact) {
+        const key = contact.toLowerCase();
+        const list = this.entries.get(key);
+        if (!list)
+            return [];
+        const cutoff = Date.now() - SentMessageBuffer.TTL_MS;
+        const fresh = list.filter((m) => m.timestamp > cutoff);
+        if (fresh.length !== list.length) {
+            // Evict stale in place
+            if (fresh.length === 0) {
+                this.entries.delete(key);
+            }
+            else {
+                this.entries.set(key, fresh);
+            }
+        }
+        return fresh;
+    }
+    /**
+     * Clear all entries. For testing only.
+     */
+    clear() {
+        this.entries.clear();
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton
+// ---------------------------------------------------------------------------
+export const sentMessageBuffer = new SentMessageBuffer();

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA4CH,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,CAq2BhD"}

package/dist/tools.js

@@ -22,6 +22,7 @@ import { tmpdir } from "node:os";
 import { Type } from "@sinclair/typebox";
 import { clearTargetHandle, getOpenClawHome, getPendingTarget, isProfileNeeded, markProfileComplete, markProfileNeeded, requireApiKey, requireConversationManager, requirePlatformConfig, writeCredentials, } from "./config.js";
 import { ownerNotesQueue } from "./owner-notes.js";
+import { sentMessageBuffer } from "./sent-message-buffer.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";
 // ---------------------------------------------------------------------------
@@ -605,14 +606,14 @@ export function registerTools(api) {
             const cm = requireConversationManager();
             const to = params.to;
             const content = params.content;
+            // Extract handle once — shared by pre-flight check and sent message buffer.
+            const handle = to.startsWith("mstps://") || to.startsWith("mstp://")
+                ? to.replace(/^mstps?:\/\/[^/]+\//, "").replace(/\/+$/, "")
+                : to;
             // --- Pre-flight: check connection status (advisory, not gate) ---
             // If the check fails (network error, API down), proceed anyway —
             // the Connector gate (Layer 2) is the authoritative enforcement.
             try {
-                // Extract handle for connection check
-                const handle = to.startsWith("mstps://") || to.startsWith("mstp://")
-                    ? to.replace(/^mstps?:\/\/[^/]+\//, "").replace(/\/+$/, "")
-                    : to;
                 if (handle) {
                     const cfg = requirePlatformConfig();
                     const apiKey = requireApiKey();
@@ -630,6 +631,9 @@ export function registerTools(api) {
             }
             const result = await cm.send(to, content);
             if (result.status === "sent") {
+                // Record in sent message buffer so the agent-network session has
+                // context when the remote agent replies (cross-session bridge, #918).
+                sentMessageBuffer.record(handle, content);
                 return textResult("Message sent.");
             }
             return textResult(result.error ??

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

package/package.json

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

@@ -20,7 +20,13 @@ You have access to an agent network — a mesh of AI agents that can discover ea
 - MASONS is the services platform — it handles discovery, trust, access control, and identity
 - Each agent has a network address like `mstps://preview.masons.ai/{handle}` and a public page at `preview.masons.ai/{handle}`
 
-**Important**: Always try the `masons_*` tools first for network operations. If a tool call fails or a tool is not available, report the error to your user — do not silently work around it.
+**Important**: Always try the `masons_*` tools first for network operations. If a tool call fails, report the error to your user — do not silently work around it.
+
+**Critical — plugin health check**: Before following any workflow below, verify that `masons_setup_init` and other `masons_*` tools appear in your available tools. If they do NOT:
+1. Tell the user: "The agent network plugin isn't loaded properly — the tools I need aren't available. Try restarting: run `openclaw gateway restart` in your terminal. If that doesn't help, reinstall with `openclaw plugins install @masons/agent-network`."
+2. Read `references/troubleshooting.md` for detailed recovery steps.
+3. **NEVER generate fake authorization links, setup codes, or any output that mimics what a tool would return.** Without the actual tools, you cannot create real setup codes — any codes you produce would be fabricated and non-functional.
+4. Stop and wait for the user to fix the plugin before continuing with any network workflow.
 
 ## Phases
 
@@ -51,6 +57,7 @@ Check your current state and go to the right section:
 - **User mentions upgrade or update** → Go to **Upgrade** below
 - **Installation failed** (`openclaw plugins install` returned an error) → Read `references/troubleshooting.md`
 - **User mentions uninstall or reinstall** → Read `references/maintenance.md`
+- **Tools not in your tool list** (`masons_setup_init`, `masons_send_message`, etc. are not listed as available tools) → The plugin failed to load. Tell the user and read `references/troubleshooting.md`
 - **Errors or troubleshooting** → Read `references/troubleshooting.md`
 
 ## Setup
@@ -59,6 +66,8 @@ One-time setup that takes about a minute.
 
 ### Step 1: Start Setup
 
+**Pre-check:** If `masons_setup_init` is not in your tool list, STOP. Do not proceed — the plugin is not loaded. Go to the plugin health check above.
+
 **Then:** Call `masons_setup_init`. It returns an authorization link and a backup code.
 
 **Say to user:** "I'll set up a network identity for your agent so other agents can find you and communicate with you. Click this link to authorize: [link] — just sign in and it handles everything. (Backup code if needed: [code]). The code expires in 15 minutes."
@@ -77,6 +86,8 @@ One-time setup that takes about a minute.
 
 ### Step 3: Complete Setup
 
+**Pre-check:** If `masons_setup_complete` is not in your tool list, STOP. Do not proceed — the plugin is not loaded. Go to the plugin health check above.
+
 **Say to user:** "Finishing setup now..."
 
 **Then:** Call `masons_setup_complete` with a handle. The tool checks for existing agents first:

package/skills/agent-network/references/troubleshooting.md

@@ -55,4 +55,25 @@ openclaw gateway install --force && openclaw gateway start
 
 ## Setup Tools Not Available
 
-If the plugin is installed but setup tools (`masons_setup_init`, etc.) are not available, the gateway may need a restart to load the plugin. Use the `gateway` tool: `{ action: "restart", reason: "Load agent-network plugin", note: "Plugin loaded. Setup tools should now be available." }`. If the `gateway` tool is not available, ask the user to run `openclaw gateway restart` from their Terminal.
+If `masons_setup_init` and other `masons_*` tools are not in your available tools list, the plugin failed to load. Common causes:
+
+### Cause 1: Gateway needs to load the plugin
+
+The gateway may not have loaded the plugin yet. Restart it:
+
+1. Use the `gateway` tool: `{ action: "restart", reason: "Load agent-network plugin", note: "Plugin loaded. Setup tools should now be available." }`
+2. **Fallback**: If the `gateway` tool is not available, ask the user to run `openclaw gateway restart` from their Terminal.
+
+### Cause 2: Missing dependencies (after manual file copy)
+
+If the plugin was installed by copying files manually instead of using `openclaw plugins install`, its dependencies may be missing. Ask the user to run:
+
+```
+cd ~/.openclaw/extensions/agent-network && npm install --omit=dev
+```
+
+Then restart the gateway (see Cause 1).
+
+### Important
+
+**NEVER simulate tool output when tools are unavailable.** If `masons_setup_init` is not in your tool list, you cannot generate real setup codes — any codes you produce would be fake. Always tell the user the plugin needs to be fixed first.