@masons/agent-network 0.5.14 → 0.5.16

package/dist/plugin.js

@@ -1,6 +1,3 @@
-// OpenClaw Plugin entry point.
-// 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, consumeIdentityLinkingNudge } from "./channel.js";
 import { login } from "./cli-setup.js";
@@ -13,10 +10,6 @@ import { registerTools } from "./tools.js";
 import { consumeCurrentTurnSender, setCurrentTurnChannelId, setCurrentTurnIsOwnerForTools, } from "./turn-context.js";
 import { getUpdateInfo } from "./update-check.js";
 import { PLUGIN_VERSION } from "./version.js";
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/** Format a timestamp as a human-readable relative time string. */
 function formatTimeAgo(timestamp) {
     const diff = Date.now() - timestamp;
     const minutes = Math.floor(diff / 60_000);
@@ -30,10 +23,6 @@ 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)
@@ -48,21 +37,7 @@ function drainAndFormatNotes(reportInstruction) {
         `${lines.join("\n")}\n` +
         reportInstruction);
 }
-/** 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)
@@ -70,7 +45,6 @@ function buildInteractionContext(channelId, turnSender) {
     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);
@@ -86,7 +60,6 @@ function buildInteractionContext(channelId, turnSender) {
     });
     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."
@@ -97,12 +70,10 @@ function buildInteractionContext(channelId, turnSender) {
             "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]";
@@ -113,35 +84,10 @@ const plugin = {
     version: PLUGIN_VERSION,
     name: "Agent Network",
     description: "Connect your Agent to the agent network for real-time communication",
-    // configSchema MUST be on the plugin export object (not just openclaw.plugin.json).
-    // Gateway validates user config via AJV against this schema BEFORE calling register().
-    // Missing configSchema → register() is never called (silent skip, no error logged).
-    // Imported from openclaw.plugin.json — single source of truth.
     configSchema: pluginManifest.configSchema,
     register(api) {
-        // Capture runtime for inbound message dispatch (Pathway 1: module-level singleton).
-        // api.runtime is the full PluginRuntime (includes .channel for routing/reply/session).
-        // Idempotent — Gateway may hot-reload, calling register() again.
         initPluginRuntime(api.runtime);
-        // Register tools FIRST — they must be available even when the channel
-        // has no credentials yet.
         registerTools(api);
-        // Register the agent-network channel. The 2026.4.x contract reads
-        // `plugin.auth?.login` for `openclaw channels login --channel agent-network`
-        // (CLI dispatch in `dist/channels-cli-Cc40S0aS.js:85`). Reference plugins
-        // (WhatsApp, Feishu in the OpenClaw bundle) use the same shape.
-        //
-        // History: 0.5.0 mounted this hook at `plugin.setup.configureInteractive`
-        // — a path no OpenClaw version reads, so `channels login` never worked.
-        // 0.5.1 corrected the mount point. 0.5.2 surfaces register errors
-        // instead of silently catching them — the previous "cheap guard"
-        // (`catch {}`) hid every kind of register-time failure including the
-        // ones we care about (schema validation, missing modules, IO errors).
-        //
-        // The new contract: log the error visibly AND re-throw, so OpenClaw
-        // surfaces the failure to the user rather than running with an
-        // un-registered channel that mysteriously "doesn't support login".
-        // Per Mingke's review of the 0.5.1 T1 failure (#1264, 2026-04-19).
         try {
             api.registerChannel({
                 plugin: {
@@ -154,41 +100,9 @@ const plugin = {
             console.error("[@masons/agent-network] api.registerChannel failed — channel will be unavailable:", err);
             throw err;
         }
-        // --- Layer B: Per-turn context injection ---
-        // Injects agent network awareness into every LLM turn via before_prompt_build.
-        //
-        // Two injection channels:
-        // - prependSystemContext: stable content (tool list), KV-cacheable by OpenClaw
-        // - prependContext: dynamic content (setup state, pending target), changes across turns
-        //
-        // State detection reads config from disk. To avoid disk I/O every turn, the
-        // result is cached and only re-read when the state could have changed (on first
-        // turn, and when tools modify config — e.g. writeCredentials, clearTargetHandle).
-        //
-        // Replaces the previous one-shot before_agent_start hook. That hook only fired
-        // once per restart; this fires every turn, providing continuous awareness.
-        // History: before_prompt_build was discovered via Mkclaw plugin investigation
-        // (2026-03-18). The original Layer B (2026-03-11) used before_agent_start
-        // because before_prompt_build was not known at the time.
-        /** Cached state from last successful disk read. null = not yet read. */
         let cachedState = null;
-        /** Generation at time of last cache fill. Mismatch → re-read. */
         let cachedGeneration = -1;
-        // Stable system context — interoperation awareness + routing table.
-        // 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)
-        //   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.
-        // 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. " +
+        const TOOL_CONTEXT = "[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). " +
@@ -205,7 +119,6 @@ const plugin = {
             "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. " +
-            // --- 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 — " +
@@ -215,30 +128,14 @@ const plugin = {
             "Should you follow up with another agent via masons_send_message? " +
             "When the interaction is complete, call masons_end_conversation as your FINAL action — " +
             "do not generate any text reply after ending. " +
-            // --- Cross-channel identity linking knowledge removed from static TOOL_CONTEXT ---
-            // Moved to dynamicContext in before_prompt_build (#986 redesign).
-            // Reason: TOOL_CONTEXT is built in register() before startAccount() runs,
-            // so getDmScope() is not available. Linking knowledge is dmScope-conditional.
             "";
         api.on("before_prompt_build", async (_event, ctx) => {
             const hookCtx = ctx;
             const channelId = hookCtx?.channelId;
-            // --- Consume per-turn flags unconditionally (#836, #873) ---
-            // MUST happen BEFORE any early return (config read timeout, etc.)
-            // to prevent stale state from leaking across turns. If not consumed,
-            // the value persists and is read on the NEXT turn, producing incorrect
-            // context or — critically — bypassing the access gate on identity tools.
             const turnIsOwner = consumeCurrentTurnIsOwner();
             const turnSender = consumeCurrentTurnSender();
-            // --- Store turn context for tool access gates (#986) ---
-            // Tools run AFTER before_prompt_build. The consumed flags above are gone
-            // by tool execution time. Store non-consuming copies so tools can check
-            // channelId and isOwner for access control (e.g., identity linking gate).
-            // These persist until the next before_prompt_build overwrites them.
-            // Assumption: OpenClaw processes turns sequentially per agent.
             setCurrentTurnChannelId(channelId ?? null);
             setCurrentTurnIsOwnerForTools(turnIsOwner);
-            // --- Detect setup state (cached, re-read when config changes) ---
             const currentGeneration = getStateCacheGeneration();
             if (!cachedState || cachedGeneration !== currentGeneration) {
                 try {
@@ -250,35 +147,24 @@ const plugin = {
                     cachedGeneration = currentGeneration;
                 }
                 catch {
-                    // Config read failure — proceed without state-specific context.
-                    // Will retry on next turn (cachedState stays null).
-                    // Per-turn flags were already consumed above — no stale state leak.
                     return {};
                 }
             }
             const state = cachedState;
-            // --- Build dynamic context based on setup state ---
             let dynamicContext;
             if (!state.hasCredentials) {
-                // Just installed, no credentials yet — guide to CLI setup.
-                // The previous `masons_setup_init` LLM tool was removed in 0.5.0
-                // (#1253) and replaced by the OAuth device flow in cli-setup.ts.
-                // The LLM cannot run the device flow itself (it requires terminal
-                // I/O via OpenClaw's prompter), so its job here is to surface the
-                // command and wait for the user.
                 dynamicContext =
                     "[Context: Agent Network] You recently installed the agent network plugin " +
                         "but it is not yet authorized. Tell your user to run this in their terminal: " +
                         "`openclaw channels login --channel agent-network`. " +
-                        "The command opens a browser to authorize the device, then prompts in the " +
-                        "terminal to pick or create an agent. After it completes, OpenClaw will " +
+                        "The command prints a MASONS handoff URL; the browser sign-in handles " +
+                        "agent selection or creation. After it completes, OpenClaw will " +
                         "reload and the agent network tools will become available.";
                 if (state.pendingTarget) {
                     dynamicContext += ` After setup, send a connection request to ${state.pendingTarget} — they invited your user to join.`;
                 }
             }
             else if (state.needsProfile) {
-                // Agent created but profile is empty — guide to profile completion
                 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. " +
@@ -290,30 +176,14 @@ const plugin = {
                 }
             }
             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 + interaction context (connected and ready state only) ---
-            // When the agent has credentials, no pending setup, and no pending target,
-            // 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
-            // to complete setup first. Routing context only applies to the "ready" state.
             if (!dynamicContext &&
                 state.hasCredentials &&
                 !state.needsProfile &&
                 !state.pendingTarget) {
                 if (channelId === "agent-network") {
                     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 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). " +
@@ -327,22 +197,15 @@ const plugin = {
                         }
                     }
                     else {
-                        // 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}`;
                         }
-                        // 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) {
@@ -360,13 +223,10 @@ const plugin = {
                     }
                 }
                 else {
-                    // Owner turn (or other channel) — drain pending notes if any.
                     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). " +
@@ -377,8 +237,6 @@ const plugin = {
                             ? `${dynamicContext}\n\n${nudge}`
                             : nudge;
                     }
-                    // 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
@@ -387,10 +245,6 @@ const plugin = {
                     }
                 }
             }
-            // --- dmScope-conditional linking knowledge (#986 redesign) ---
-            // Placed in dynamicContext (not static TOOL_CONTEXT) because getDmScope()
-            // is only available after startAccount() runs (initToolConfig reads cfg).
-            // TOOL_CONTEXT is built in register() before startAccount().
             if (state.hasCredentials && !state.needsProfile && !state.pendingTarget) {
                 const dmScope = getDmScope();
                 if (dmScope !== "main") {
@@ -406,11 +260,6 @@ const plugin = {
                         : linkingKnowledge;
                 }
             }
-            // --- Self-identity preamble (#969) ---
-            // Inject agent self-identity so the LLM knows who it is on the network.
-            // Owner identity is NOT injected here — agent rejected it as untrusted
-            // (0.4.18/0.4.19 case study). Owner recognition is handled via
-            // session.identityLinks at the Gateway config layer instead.
             if (state.hasCredentials) {
                 const envAgent = getAgentIdentity();
                 if (envAgent) {
@@ -423,8 +272,6 @@ const plugin = {
                         : identityLine;
                 }
             }
-            // Post-upgrade verification: if an update is still available after
-            // a gateway restart, the previous upgrade attempt may have failed.
             const updateInfo = getUpdateInfo();
             if (updateInfo?.updateAvailable) {
                 const upgradeHint = ` Plugin update to v${updateInfo.latestVersion} is available.` +
@@ -432,17 +279,6 @@ const plugin = {
                     ` Do NOT search ClawHub or run manual npm/openclaw commands.`;
                 dynamicContext = (dynamicContext ?? "") + upgradeHint;
             }
-            // --- Determine what to inject ---
-            // Use prependSystemContext for stable tool awareness (KV-cacheable).
-            // Use prependContext for dynamic setup state.
-            //
-            // Workaround for OpenClaw issue #59546: prependSystemContext is silently
-            // ignored in the gateway reply path (confirmed in v2026.4.1, still open).
-            // To ensure tool awareness is never lost for gateway-mode users, we
-            // include TOOL_CONTEXT in both prependSystemContext (for KV-cache benefit
-            // on desktop) and prependContext (as fallback for gateway mode).
-            // Cost: ~434 tokens duplicated per turn on desktop OpenClaw.
-            // Remove this duplication once #59546 is fixed upstream.
             const systemContext = state.hasCredentials ? TOOL_CONTEXT : undefined;
             if (systemContext && dynamicContext) {
                 return {

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

@@ -1,50 +1,14 @@
-/**
- * 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 = 1000;
-    /**
-     * 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;

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

@@ -1 +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,SAAsB;IAC5C,yFAAyF;IACzF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,QAAQ;IAE1C;;;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"}
+{"version":3,"file":"sent-message-buffer.d.ts","sourceRoot":"","sources":["../src/sent-message-buffer.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,WAAW;IAE1B,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAoC;IAGnD,MAAM,CAAC,QAAQ,CAAC,eAAe,KAAK;IAEpC,MAAM,CAAC,QAAQ,CAAC,MAAM,SAAsB;IAE5C,MAAM,CAAC,QAAQ,CAAC,kBAAkB,QAAQ;IAM1C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAiC9C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAuBzC,KAAK,IAAI,IAAI;CAGd;AAMD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/sent-message-buffer.js

@@ -1,36 +1,8 @@
-/**
- * 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 = 2 * 60 * 60 * 1000; // 2 hours
-    /** Max content length stored per message. Longer content is truncated at record time. */
+    static TTL_MS = 2 * 60 * 60 * 1000;
     static MAX_CONTENT_LENGTH = 1000;
-    /**
-     * 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();
@@ -39,26 +11,17 @@ export class SentMessageBuffer {
             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);
@@ -67,7 +30,6 @@ export class SentMessageBuffer {
         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);
             }
@@ -77,14 +39,8 @@ export class SentMessageBuffer {
         }
         return fresh;
     }
-    /**
-     * Clear all entries. For testing only.
-     */
     clear() {
         this.entries.clear();
     }
 }
-// ---------------------------------------------------------------------------
-// Singleton
-// ---------------------------------------------------------------------------
 export const sentMessageBuffer = new SentMessageBuffer();

package/dist/tools.d.ts

@@ -1,22 +1,3 @@
-/**
- * LLM tools — setup, connection, profile, and conversation tools.
- *
- * Registers tools with OpenClaw's Plugin API so the LLM can
- * drive setup, profile completion, connection listing, connection
- * requests, request management, and real-time conversations,
- * guided by SKILL.md.
- *
- * Two access patterns:
- * - **HTTP tools** (setup, connection): read config via `requirePlatformConfig()`,
- *   call Platform API via `platform-client.ts`.
- * - **WebSocket tools** (conversation): use `requireConversationManager()` for
- *   identity-based messaging. Session management is fully transparent.
- *
- * Session Abstraction (#741):
- * - `masons_send_message(to, content)` — sends via ConversationManager
- * - `masons_end_conversation(contact)` — ends via ConversationManager
- * (Deprecated shims masons_create_session and masons_end_session have been removed.)
- */
 interface ToolContent {
     content: Array<{
         type: "text";
@@ -34,16 +15,7 @@ interface ToolApi {
         optional?: boolean;
     }): void;
 }
-/** @internal Reset module state for test isolation. */
 export declare function _resetToolsForTesting(): void;
-/**
- * Register agent network tools with the OpenClaw Plugin API.
- *
- * Called from `plugin.ts` during plugin registration. Tools become available
- * to the LLM after the plugin loads. Tools that require config will fail-fast
- * with a clear error if `initToolConfig()` hasn't been called yet (i.e.,
- * `startAccount()` hasn't run).
- */
 export declare function registerTools(api: ToolApi): void;
 export {};
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA6CH,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;AAwCD,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AA4ED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAm2BhD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AA4DA,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;AAmCD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAoFD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAizBhD"}