@masons/agent-network 0.3.6 → 0.3.7

package/dist/channel.d.ts

@@ -32,22 +32,9 @@ interface ChannelGatewayContext<T = unknown> {
     cfg: Record<string, unknown>;
     accountId: string;
     account: T;
-    runtime: GatewayRuntime;
+    runtime: unknown;
     abortSignal: AbortSignal;
 }
-interface GatewayRuntime {
-    routeMessage(envelope: MessageEnvelope): void;
-}
-interface MessageEnvelope {
-    channelId: string;
-    messageId: string;
-    senderId: string;
-    senderName: string;
-    text: string;
-    timestamp: number;
-    isGroupMessage: boolean;
-    metadata?: Record<string, unknown>;
-}
 interface ChannelGatewayAdapter<T = unknown> {
     startAccount?(ctx: ChannelGatewayContext<T>): Promise<unknown>;
     stopAccount?(ctx: ChannelGatewayContext<T>): Promise<void>;

package/dist/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAa9D,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,cAAc,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,UAAU,cAAc;IACtB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/C;AAED,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,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;AAwDD,eAAO,MAAM,mBAAmB,EAAE,yBA4NjC,CAAC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAa9D,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;AAwDD,eAAO,MAAM,mBAAmB,EAAE,yBAiTjC,CAAC"}

package/dist/channel.js

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
 import createDebug from "debug";
-import { clearConnectorClient, extractNetworkConfig, initConnectorClient, initToolConfig, } from "./config.js";
+import { clearConnectorClient, extractNetworkConfig, initConnectorClient, initToolConfig, requirePluginRuntime, } from "./config.js";
 import { ConnectorClient } from "./connector-client.js";
 import { checkForUpdate } from "./update-check.js";
 const dbg = createDebug("agent-network:channel");
@@ -89,7 +89,7 @@ export const agentNetworkChannel = {
         isConfigured(account) {
             return account.connectorUrl !== "" && account.token !== "";
         },
-        isEnabled(account, cfg) {
+        isEnabled(_account, cfg) {
             const networkCfg = extractNetworkConfig(cfg);
             return networkCfg?.enabled !== false;
         },
@@ -97,7 +97,7 @@ export const agentNetworkChannel = {
     outbound: {
         deliveryMode: "direct",
         async sendText(ctx) {
-            // ctx.recipient = sessionId — Gateway echoes back the senderId from routeMessage
+            // ctx.recipient = sessionId — Gateway echoes back SenderId from finalizeInboundContext
             const state = accounts.get(ctx.accountId);
             if (!state?.sessions.has(ctx.recipient)) {
                 return { ok: false };
@@ -112,12 +112,6 @@ export const agentNetworkChannel = {
     gateway: {
         async startAccount(ctx) {
             dbg("starting account %s", ctx.accountId);
-            // Capability check: routeMessage is required for inbound message delivery.
-            // Older OpenClaw versions may not provide it on the gateway runtime.
-            if (typeof ctx.runtime.routeMessage !== "function") {
-                console.error("[agent-network] OpenClaw version too old — ctx.runtime.routeMessage is not available. " +
-                    "Inbound messages will not be delivered. Please upgrade OpenClaw.");
-            }
             const { connectorUrl, token } = ctx.account;
             const client = new ConnectorClient(connectorUrl, token);
             const state = {
@@ -125,28 +119,102 @@ export const agentNetworkChannel = {
                 sessions: new Map(),
             };
             accounts.set(ctx.accountId, state);
-            // --- Inbound message routing ---
-            client.on("message_received", (event) => {
+            // --- Inbound message routing (4-step channelRuntime dispatch) ---
+            // Replaces the non-existent routeMessage() API. Uses PluginRuntime
+            // captured in register() via config.ts module-level singleton.
+            // Reference: DingTalk plugin (github.com/soimy/openclaw-channel-dingtalk).
+            //
+            // Concurrency model: this handler is async but EventEmitter fires it
+            // synchronously per event. Multiple MESSAGE_RECEIVED on the same session
+            // produce concurrent dispatches — replies may arrive out of order.
+            // Acceptable for unstructured text conversation (Phase 1). If MSTP adds
+            // 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);
-                const senderId = deriveSenderId(event);
-                const envelope = {
-                    channelId: "agent-network",
-                    messageId: `mstp:${event.sessionId}:${randomUUID()}`,
-                    senderId,
-                    senderName: deriveSenderName(event),
-                    text: event.content,
-                    timestamp: Date.now(),
-                    isGroupMessage: false,
-                    metadata: {
-                        ...event.metadata,
-                        contentType: event.contentType,
-                    },
-                };
-                if (typeof ctx.runtime.routeMessage !== "function") {
-                    dbg("routeMessage not available, dropping inbound message sessionId=%s", event.sessionId);
+                // --- Runtime guard ---
+                let runtime;
+                try {
+                    runtime = requirePluginRuntime();
+                }
+                catch {
+                    dbg("plugin runtime not available, dropping message sessionId=%s", event.sessionId);
+                    return;
+                }
+                // channel is required in our PluginRuntime type but may be absent
+                // at runtime on older OpenClaw versions (pre-2026.2.19).
+                if (!runtime.channel) {
+                    dbg("channelRuntime not available, dropping message sessionId=%s", event.sessionId);
                     return;
                 }
-                ctx.runtime.routeMessage(envelope);
+                const senderId = deriveSenderId(event);
+                const senderName = deriveSenderName(event);
+                try {
+                    // Step 1 — Resolve agent route (await defensively — may be sync or async)
+                    const route = await runtime.channel.routing.resolveAgentRoute({
+                        cfg: ctx.cfg,
+                        channel: "agent-network",
+                        accountId: ctx.accountId,
+                        peer: { kind: "direct", id: senderId },
+                    });
+                    // Step 2 — Finalize inbound context (builds MsgContext for LLM pipeline)
+                    const msgCtx = runtime.channel.reply.finalizeInboundContext({
+                        Body: event.content,
+                        RawBody: event.content,
+                        CommandBody: event.content,
+                        From: senderId,
+                        To: senderId,
+                        SessionKey: route.sessionKey,
+                        AccountId: ctx.accountId,
+                        ChatType: "direct",
+                        SenderName: senderName,
+                        SenderId: senderId,
+                        Timestamp: Date.now(),
+                        Provider: "agent-network",
+                        Surface: "agent-network",
+                        MessageSid: `mstp:${event.sessionId}:${randomUUID()}`,
+                        CommandAuthorized: true,
+                        OriginatingChannel: "agent-network",
+                        OriginatingTo: senderId,
+                    });
+                    // Step 3 — Record inbound session
+                    const storePath = runtime.channel.session.resolveStorePath(undefined, { agentId: route.agentId });
+                    const sessionKey = typeof msgCtx.SessionKey === "string"
+                        ? msgCtx.SessionKey
+                        : route.sessionKey;
+                    await runtime.channel.session.recordInboundSession({
+                        storePath,
+                        sessionKey,
+                        ctx: msgCtx,
+                    });
+                    // Step 4 — Dispatch to LLM pipeline + deliver reply via callback
+                    await runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+                        ctx: msgCtx,
+                        cfg: ctx.cfg,
+                        dispatcherOptions: {
+                            deliver: async (payload) => {
+                                const text = payload.text;
+                                if (!text)
+                                    return;
+                                // Session may have ended while LLM was processing.
+                                // Skip the send to avoid a needless Connector round-trip.
+                                if (!state.sessions.has(senderId))
+                                    return;
+                                // Send LLM reply back through the MSTP session.
+                                // senderId === sessionId (deriveSenderId invariant).
+                                const sent = state.client.sendMessage(senderId, text, {
+                                    contentType: "text",
+                                });
+                                dbg("deliver reply sessionId=%s contentLength=%d sent=%s", senderId, text.length, sent);
+                            },
+                            onError: (err) => {
+                                console.error(`[agent-network:${ctx.accountId}] dispatch error:`, err);
+                            },
+                        },
+                    });
+                }
+                catch (err) {
+                    console.error(`[agent-network:${ctx.accountId}] inbound dispatch failed sessionId=${event.sessionId}:`, err);
+                }
             });
             // --- Session lifecycle ---
             client.on("session_created", (event) => {

package/dist/config.d.ts

@@ -49,6 +49,28 @@ export declare function initConnectorClient(client: ConnectorClient): void;
  * operating on a disconnected client.
  */
 export declare function clearConnectorClient(): void;
+/**
+ * Store the OpenClaw PluginRuntime for inbound message dispatch.
+ *
+ * Called by `register(api)` in plugin.ts — captures `api.runtime` which
+ * provides `runtime.channel.*` (routing, reply, session) used by the
+ * 4-step inbound dispatch flow in channel.ts.
+ *
+ * Idempotent: overwrites on re-call. Gateway may hot-reload plugins,
+ * calling `register()` again without a teardown counterpart.
+ */
+export declare function initPluginRuntime(runtime: unknown): void;
+/**
+ * Clear the stored PluginRuntime reference.
+ */
+export declare function clearPluginRuntime(): void;
+/**
+ * Get the stored PluginRuntime. Throws if not initialized.
+ *
+ * Callers cast the result to `PluginRuntime` (defined in channel.ts)
+ * at the usage site. Typed as `unknown` here to avoid circular imports.
+ */
+export declare function requirePluginRuntime(): unknown;
 /**
  * Get platform config. Always returns a valid config — defaults are set
  * at module load time, and overwritten by `initToolConfig()` when

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,oBAAoB,CAClC,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,CAsBjE;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,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA2Bf;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;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvD;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKzD;AAMD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CA2BhE;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;AA2B9B;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,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,CAsBjE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAMD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C;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,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA2Bf;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;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvD;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKzD;AAMD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CA2BhE;AAMD,uDAAuD;AACvD,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC"}

package/dist/config.js

@@ -32,6 +32,9 @@ let storedApiKey = null;
 let storedPendingTarget = null;
 // Runtime state (live connection — set by startAccount, cleared by stopAccount)
 let storedConnectorClient = null;
+// PluginRuntime state (set by register() in plugin.ts, used by channel.ts)
+// Typed as unknown to avoid circular imports — channel.ts casts to PluginRuntime.
+let storedPluginRuntime = null;
 // ---------------------------------------------------------------------------
 // Config navigation — shared between channel.ts and config.ts
 // ---------------------------------------------------------------------------
@@ -106,6 +109,40 @@ export function clearConnectorClient() {
     storedConnectorClient = null;
 }
 // ---------------------------------------------------------------------------
+// PluginRuntime injection (called by register() in plugin.ts)
+// ---------------------------------------------------------------------------
+/**
+ * Store the OpenClaw PluginRuntime for inbound message dispatch.
+ *
+ * Called by `register(api)` in plugin.ts — captures `api.runtime` which
+ * provides `runtime.channel.*` (routing, reply, session) used by the
+ * 4-step inbound dispatch flow in channel.ts.
+ *
+ * Idempotent: overwrites on re-call. Gateway may hot-reload plugins,
+ * calling `register()` again without a teardown counterpart.
+ */
+export function initPluginRuntime(runtime) {
+    storedPluginRuntime = runtime;
+}
+/**
+ * Clear the stored PluginRuntime reference.
+ */
+export function clearPluginRuntime() {
+    storedPluginRuntime = null;
+}
+/**
+ * Get the stored PluginRuntime. Throws if not initialized.
+ *
+ * Callers cast the result to `PluginRuntime` (defined in channel.ts)
+ * at the usage site. Typed as `unknown` here to avoid circular imports.
+ */
+export function requirePluginRuntime() {
+    if (storedPluginRuntime == null) {
+        throw new Error("Plugin runtime not initialized. register() must be called first.");
+    }
+    return storedPluginRuntime;
+}
+// ---------------------------------------------------------------------------
 // Guard functions (used by tools — fail-fast if not initialized)
 // ---------------------------------------------------------------------------
 /**
@@ -312,4 +349,5 @@ export function _resetForTesting() {
     storedApiKey = null;
     storedPendingTarget = null;
     storedConnectorClient = null;
+    storedPluginRuntime = null;
 }

package/dist/plugin.d.ts

@@ -1,4 +1,5 @@
 interface OpenClawPluginApi {
+    runtime: unknown;
     registerChannel(opts: {
         plugin: unknown;
     }): void;

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

@@ -3,7 +3,7 @@
 // NOT imported by index.ts to avoid pulling ws/typebox into Next.js app bundles.
 import { agentNetworkChannel } from "./channel.js";
 import { configureInteractive } from "./cli-setup.js";
-import { detectPendingState } from "./config.js";
+import { detectPendingState, initPluginRuntime } from "./config.js";
 import { registerTools } from "./tools.js";
 import { PLUGIN_VERSION } from "./version.js";
 const plugin = {
@@ -32,6 +32,10 @@ const plugin = {
         },
     },
     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 (setup flow needs these tools to GET credentials).
         registerTools(api);

package/dist/version.d.ts

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

package/package.json

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