@masons/agent-network 0.4.7 → 0.4.9

package/dist/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAc9D,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,oBAAoB,CAAC,CAAC;IAC9B,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;IACvD,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACpE,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACjE,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/D;AAED,UAAU,sBAAsB;IAC9B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACzE;AAED,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAsDD,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,YAAY,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,WAAW,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,UAAU,yBAAyB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAClD,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;CACrD;AAkED,eAAO,MAAM,mBAAmB,EAAE,yBAkXjC,CAAC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAqB9D,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,oBAAoB,CAAC,CAAC;IAC9B,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;IACvD,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACpE,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACjE,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/D;AAED,UAAU,sBAAsB;IAC9B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACzE;AAED,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAsDD,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,YAAY,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,WAAW,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,UAAU,yBAAyB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAClD,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;CACrD;AAkED,eAAO,MAAM,mBAAmB,EAAE,yBAsYjC,CAAC"}

package/dist/channel.js

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

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

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

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

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

package/dist/owner-session-state.js

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

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

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

package/dist/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;AAyCD,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAsFD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAm1BhD"}
+{"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"}

package/dist/tools.js

@@ -31,8 +31,9 @@ import { fetchLatestVersion, getPluginVersion, getUpdateInfo, } from "./update-c
 const PROFILE_FIELDS = new Set(["name", "scope", "about", "audience"]);
 /** CLI command to update the plugin via OpenClaw. */
 const UPGRADE_CMD = "openclaw plugins update agent-network";
-/** Fallback: manual update via npm pack + in-place extract. Bypasses OpenClaw's
- *  broken version detection while preserving credentials and node_modules.
+/** Fallback: manual update via npm pack + in-place extract. Used when
+ *  `openclaw plugins update` fails (integrity conflict, npm cache issue, etc.)
+ *  while preserving credentials and node_modules.
  *  Placeholders `{version}`, `{home}`, and `{tmpdir}` are replaced at runtime. */
 const FALLBACK_UPGRADE_CMD = "npm pack @masons/agent-network@{version} --pack-destination {tmpdir} && " +
     "tar xzf {tmpdir}/masons-agent-network-{version}.tgz --strip-components=1 -C {home}/extensions/agent-network/ && " +
@@ -660,7 +661,7 @@ export function registerTools(api) {
     // --- masons_upgrade -------------------------------------------------------
     api.registerTool({
         name: "masons_upgrade",
-        description: "Check for and install plugin updates. This is the ONLY correct way to upgrade — do not use ClawHub or manual npm commands.",
+        description: "Check for and install plugin updates via `openclaw plugins update`. Do not use ClawHub (it distributes skills, not plugins).",
         parameters: Type.Object({}),
         // NOT wrapped with withUpdateNotice — this tool IS the upgrade path.
         // Wrapping would create a circular reference in the update notice text.
@@ -675,23 +676,12 @@ export function registerTools(api) {
             }
             const currentVersion = getPluginVersion();
             // 1. Determine latest version.
-            //    Normal path: use cached getUpdateInfo() (populated at startup).
-            //    Fallback path (upgradeAttemptedVersion set): bypass cache, fetch directly.
-            let latestVersion = null;
-            if (upgradeAttemptedVersion !== null) {
-                // Previous attempt didn't succeed — fetch directly to bypass stale cache.
-                latestVersion = await fetchLatestVersion();
-            }
-            else {
-                const info = getUpdateInfo();
-                if (info) {
-                    latestVersion = info.latestVersion;
-                }
-                else {
-                    // No cached info (startup check didn't run or failed) — fetch directly.
-                    latestVersion = await fetchLatestVersion();
-                }
-            }
+            //    Always fetch directly from npm — this is an explicit upgrade
+            //    command, not a passive check. The 24h startup cache
+            //    (checkForUpdate / getUpdateInfo) is for the withUpdateNotice
+            //    passive hint only. An explicit "upgrade" must see the real
+            //    latest version, even if it was published minutes ago.
+            const latestVersion = await fetchLatestVersion();
             // 2. Network error — can't determine latest version.
             if (!latestVersion) {
                 return textResult("Could not check for updates (network issue). Try again later.");

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

package/package.json

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