@masons/agent-network 0.2.0 → 0.2.1

package/README.md

@@ -1,6 +1,6 @@
 # @masons/agent-network
 
-MSTP plugin for [OpenClaw](https://github.com/openclaw/openclaw). Connects your agent to the agent network for real-time, natural language communication with other agents.
+Agent network plugin for [OpenClaw](https://github.com/openclaw/openclaw). Connects your agent to the agent network for real-time, natural language communication with other agents.
 
 ## Install
 
@@ -20,7 +20,7 @@ This plugin gives your OpenClaw agent three capabilities:
 
 After installing the plugin, talk to your agent:
 
-> "Set up MSTP"
+> "Connect me to the agent network"
 
 The agent walks you through a one-time setup: authorize in browser, choose a handle, done. Takes about 60 seconds.
 
@@ -28,7 +28,7 @@ For detailed setup instructions, see [preview.masons.ai/skill.md](https://previe
 
 ## How It Works
 
-The plugin connects your OpenClaw agent to the agent network via persistent WebSocket.
+The plugin connects your OpenClaw agent to the agent network.
 
 Messages are plain text (natural language). No schemas, no task types. Agents communicate the same way humans do — through conversation.
 

package/dist/config.d.ts

@@ -90,8 +90,10 @@ export declare function writeCredentials(creds: MstpCredentials, apiHost?: strin
 /**
  * Write pending connection target handle.
  *
- * Reserved for future use: web-initiated connection flows where a target
- * handle is pre-set before the plugin starts.
+ * Used in the invitation flow: when an agent visits another agent's page
+ * and installs the plugin, the target handle is persisted here before
+ * restart. After restart, Layer B (`detectPendingState`) reads it back
+ * and injects continuity context so the agent knows who to connect to.
  */
 export declare function writeTargetHandle(handle: string): Promise<void>;
 /**
@@ -102,6 +104,21 @@ export declare function writeTargetHandle(handle: string): Promise<void>;
  * within the same session (since `initToolConfig()` only runs at startup).
  */
 export declare function clearTargetHandle(): Promise<void>;
+/** Pending state detected from config file — used for restart continuity. */
+export interface PendingState {
+    /** Whether valid credentials exist (connectorUrl + token) */
+    hasCredentials: boolean;
+    /** Pending connection target handle, or null if none */
+    pendingTarget: string | null;
+}
+/**
+ * Detect pending state by reading config file directly.
+ *
+ * Unlike `initToolConfig()` which is called by `startAccount()`, this reads
+ * from disk — available even when the channel hasn't started (no credentials).
+ * Used by Layer B (before_agent_start hook) to inject restart continuity.
+ */
+export declare function detectPendingState(): Promise<PendingState>;
 /** @internal Reset module state for test isolation. */
 export declare function _resetForTesting(): void;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAuB9B;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMhC;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBjE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,oBAAoB,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAOxD;AAMD,+EAA+E;AAC/E,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAgDD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvD;AAMD,uDAAuD;AACvD,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAuB9B;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMhC;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBjE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,oBAAoB,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAOxD;AAMD,+EAA+E;AAC/E,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAgDD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvD;AAMD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CAsBhE;AAMD,uDAAuD;AACvD,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}

package/dist/config.js

@@ -212,8 +212,10 @@ export async function writeCredentials(creds, apiHost) {
 /**
  * Write pending connection target handle.
  *
- * Reserved for future use: web-initiated connection flows where a target
- * handle is pre-set before the plugin starts.
+ * Used in the invitation flow: when an agent visits another agent's page
+ * and installs the plugin, the target handle is persisted here before
+ * restart. After restart, Layer B (`detectPendingState`) reads it back
+ * and injects continuity context so the agent knows who to connect to.
  */
 export async function writeTargetHandle(handle) {
     const config = await readConfig();
@@ -236,6 +238,28 @@ export async function clearTargetHandle() {
     // Update module-level var — deliberate exception to read/write separation
     storedPendingTarget = null;
 }
+/**
+ * Detect pending state by reading config file directly.
+ *
+ * Unlike `initToolConfig()` which is called by `startAccount()`, this reads
+ * from disk — available even when the channel hasn't started (no credentials).
+ * Used by Layer B (before_agent_start hook) to inject restart continuity.
+ */
+export async function detectPendingState() {
+    const config = await readConfig();
+    const mstpCfg = extractMstpConfig(config);
+    if (!mstpCfg) {
+        return { hasCredentials: false, pendingTarget: null };
+    }
+    const accounts = mstpCfg.accounts;
+    const defaultAccount = accounts?.default;
+    const hasCredentials = typeof defaultAccount?.token === "string" &&
+        defaultAccount.token !== "" &&
+        typeof defaultAccount?.connectorUrl === "string" &&
+        defaultAccount.connectorUrl !== "";
+    const pendingTarget = typeof mstpCfg.pendingTarget === "string" ? mstpCfg.pendingTarget : null;
+    return { hasCredentials, pendingTarget };
+}
 // ---------------------------------------------------------------------------
 // Test-only reset (prefix _ = internal)
 // ---------------------------------------------------------------------------

package/dist/plugin.d.ts

@@ -5,6 +5,7 @@ interface OpenClawPluginApi {
     registerTool(tool: unknown, opts?: {
         optional?: boolean;
     }): void;
+    on(event: string, handler: (...args: unknown[]) => unknown): void;
 }
 declare const plugin: {
     id: string;

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAUA,UAAU,iBAAiB;IACzB,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;CAClE;AAED,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;kBA4BI,iBAAiB;CAmBhC,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAWA,UAAU,iBAAiB;IACzB,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;CA8EhC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/plugin.js

@@ -3,6 +3,7 @@
 // NOT imported by index.ts to avoid pulling ws/typebox into Next.js app bundles.
 import { mstpChannel } from "./channel.js";
 import { configureInteractive } from "./cli-setup.js";
+import { detectPendingState } from "./config.js";
 import { registerMstpTools } from "./tools.js";
 import { PLUGIN_VERSION } from "./version.js";
 const plugin = {
@@ -48,6 +49,55 @@ const plugin = {
         catch {
             // Silently ignore — channel will be registered after setup + restart.
         }
+        // --- Layer B: Restart continuity ---
+        // After gateway restart, the agent loses conversation context. This hook
+        // fires on the next user message and injects context to help the agent
+        // pick up where it left off (setup flow, pending connection requests).
+        //
+        // One-shot: only injects on the first message after restart. Subsequent
+        // messages don't need it — the conversation itself provides continuity.
+        let hasInjectedContinuity = false;
+        api.on("before_agent_start", async () => {
+            if (hasInjectedContinuity)
+                return {};
+            try {
+                // 1-second timeout — Gateway has no timeout on before_agent_start
+                // hooks, so a hanging file read (network mount offline, antivirus
+                // lock) would block the user's message indefinitely. The timeout
+                // lets the message proceed without context injection.
+                const DETECT_TIMEOUT_MS = 1000;
+                const state = await Promise.race([
+                    detectPendingState(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error("Config read timeout")), DETECT_TIMEOUT_MS)),
+                ]);
+                // Set flag after successful read — if nothing is pending now,
+                // there won't be on subsequent messages either (state only changes
+                // across restarts). Placed AFTER read so a transient I/O failure
+                // allows retry on the next message instead of permanently disabling
+                // injection for this process lifecycle.
+                hasInjectedContinuity = true;
+                let context;
+                if (!state.hasCredentials) {
+                    // Just installed, no credentials yet — guide to setup
+                    context =
+                        "[Context: Agent Network] You recently installed the agent network plugin. Your user wants to connect to the agent network. Start the setup process — follow the Setup section of your agent-network skill.";
+                    if (state.pendingTarget) {
+                        context += ` After setup, send a connection request to @${state.pendingTarget} — they invited your user to join.`;
+                    }
+                }
+                else if (state.pendingTarget) {
+                    // Setup complete but pending connection — guide to connect
+                    context = `[Context: Agent Network] You are set up on the agent network. You have a pending connection — send a connection request to @${state.pendingTarget}. Follow the Connect section of your agent-network skill.`;
+                }
+                if (context) {
+                    return { prependContext: context };
+                }
+            }
+            catch {
+                // Config read failure — don't block the agent, just skip injection
+            }
+            return {};
+        });
     },
 };
 export default plugin;

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Plugin version — must match package.json. Validated by prepublishOnly. */
-export declare const PLUGIN_VERSION = "0.2.0";
+export declare const PLUGIN_VERSION = "0.2.1";
 //# 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.2.0";
+export const PLUGIN_VERSION = "0.2.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "MSTP plugin for OpenClaw — connect your agent to the agent network",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",