@alfe.ai/openclaw-chat 0.9.20 → 0.9.21

package/dist/index.d.cts

@@ -1,2 +1,2 @@
-import { A as AlfeResolvedAccount, D as createAlfeChannelPlugin, M as SessionData, N as SessionSummary, O as AlfeChannelConfig, d as _default, j as ChatMessage, k as AlfePluginConfig } from "./plugin.cjs";
+import { A as AlfePluginConfig, M as ChatMessage, N as SessionData, O as createAlfeChannelPlugin, P as SessionSummary, d as _default, j as AlfeResolvedAccount, k as AlfeChannelConfig } from "./plugin.cjs";
 export { type AlfeChannelConfig, type AlfePluginConfig, type AlfeResolvedAccount, type ChatMessage, type SessionData, type SessionSummary, createAlfeChannelPlugin, _default as default };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { A as AlfeResolvedAccount, D as createAlfeChannelPlugin, M as SessionData, N as SessionSummary, O as AlfeChannelConfig, d as _default, j as ChatMessage, k as AlfePluginConfig } from "./plugin.js";
+import { A as AlfePluginConfig, M as ChatMessage, N as SessionData, O as createAlfeChannelPlugin, P as SessionSummary, d as _default, j as AlfeResolvedAccount, k as AlfeChannelConfig } from "./plugin.js";
 export { type AlfeChannelConfig, type AlfePluginConfig, type AlfeResolvedAccount, type ChatMessage, type SessionData, type SessionSummary, createAlfeChannelPlugin, _default as default };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { _ as plugin_default, w as createAlfeChannelPlugin } from "./plugin2.js";
+import { T as createAlfeChannelPlugin, _ as plugin_default } from "./plugin2.js";
 export { createAlfeChannelPlugin, plugin_default as default };

package/dist/plugin.cjs

@@ -26,3 +26,4 @@ exports.resolveRequestedRunId = require_plugin.resolveRequestedRunId;
 exports.rewriteAssistantText = require_plugin.rewriteAssistantText;
 exports.stripLeakedToolSummary = require_plugin.stripLeakedToolSummary;
 exports.withReplyRunId = require_plugin.withReplyRunId;
+exports.withRunIdSeededChannelRuntime = require_plugin.withRunIdSeededChannelRuntime;

package/dist/plugin.d.cts

@@ -1,3 +1,24 @@
+//#region src/runtime-config.d.ts
+/**
+ * Read the live OpenClaw config through the plugin runtime.
+ *
+ * OpenClaw 2026.9.x replaced `runtime.config.loadConfig()` with
+ * `runtime.config.current()`; 2026.6.11 exposes only `loadConfig()`. On 9.5
+ * `current()` returns the process-wide pinned config object BY REFERENCE (not a
+ * copy, not frozen): treat the result as read-only, mutating it corrupts config
+ * for every plugin in the process. Both verified on the dists (2026-09-21): on 9.5 the
+ * old call throws "runtime.config.loadConfig is not a function" inside the
+ * chat request handler, which took chat down on the first 2026.9.5 host. A
+ * managed fleet is mixed across a runtime upgrade, so support both shapes.
+ *
+ * Kept local rather than in `@alfe.ai/openclaw-plugin-kit`: a kit release fans
+ * out to every plugin package and its manifest pin.
+ */
+interface RuntimeConfigApi {
+  current?: () => unknown;
+  loadConfig?: () => Record<string, unknown>;
+}
+//#endregion
 //#region src/session-store.d.ts
 /**
  * Session Store — persists chat sessions to the local filesystem.
@@ -396,9 +417,7 @@ interface PluginLogger {
   debug(msg: string, ...args: unknown[]): void;
 }
 interface PluginRuntime {
-  config: {
-    loadConfig(): Record<string, unknown>;
-  };
+  config: RuntimeConfigApi;
   events: {
     onAgentEvent(listener: (evt: AgentEventPayload) => void): () => void;
   };
@@ -450,6 +469,22 @@ interface AgentEventPayload {
 interface RunEventGate {
   runId: string | null;
   sessionKey: string | null;
+  /**
+   * Set to `false` when the gate is PRE-ARMED with a service-owned run id, and
+   * flipped to `true` by `withRunIdSeededChannelRuntime` once a dispatch seam
+   * has actually accepted that id. Absent when no seed was attempted.
+   */
+  seedApplied?: boolean;
+  /**
+   * Set to `true` immediately before the turn enters `dispatchInbound`. Only
+   * meaningful alongside `seedApplied`: it separates a seed that is still
+   * PENDING (dispatch has not run yet, so the listener is only seeing other
+   * runs) from one that has FAILED (dispatch is under way and the run is
+   * already emitting under an id no seam ever took). Without it a concurrent
+   * cron/heartbeat event arriving between listener subscription and dispatch
+   * could steal the gate.
+   */
+  dispatchStarted?: boolean;
 }
 /**
  * Decide whether an agent-event belongs to THIS turn's run and should be
@@ -492,6 +527,33 @@ declare function admitAgentEvent(gate: RunEventGate, evt: Pick<AgentEventPayload
 declare function resolveRequestedRunId(idempotencyKey: unknown): string | null;
 /** Preserve OpenClaw-provided reply options while seeding this exact run id. */
 declare function withReplyRunId(params: Record<string, unknown>, runId: string): Record<string, unknown>;
+/**
+ * Seed this turn's run id on EVERY direct-DM dispatch seam across the
+ * supported OpenClaw fleet, returning a shallow per-call clone of
+ * `runtime.channel` (never mutating the process-global runtime).
+ *
+ * `dispatchInboundDirectDmWithRuntime` has no `replyOptions` parameter, so the
+ * run id has to be merged into whichever lower seam that helper drives — and
+ * which one it drives CHANGED between the versions running on the fleet:
+ *
+ * - **2026.6.x** calls `channel.reply.dispatchReplyWithBufferedBlockDispatcher`
+ *   directly with a top-level `replyOptions`
+ *   (`dist/direct-dm-*.js`: `replyOptions: { onModelSelected }`).
+ * - **2026.9.x** builds a turn PLAN (`buildDirectDmTurnPlan`) whose
+ *   `replyOptions` is `{ onModelSelected, ...turnAdoptionLifecycle? }` and
+ *   hands it to `channel.inbound.run` via `adapter.resolveTurn`
+ *   (`dist/channel-inbound-*.mjs`). The reply dispatcher is NEVER called, so
+ *   wrapping it alone is dead code on 9.5. The plan's `replyOptions.runId`
+ *   survives `runChannelTurn` → `dispatchRoutedChannelTurn` →
+ *   `dispatchInboundMessage` and becomes the embedded run's id
+ *   (`embedded-backend-*.mjs`: `const runId = opts.runId ?? randomUUID()`).
+ *
+ * Both seams are wrapped when present, so a mixed fleet keeps working and the
+ * wrapper for the version that is NOT running is simply never invoked.
+ * `onSeedApplied` fires the moment a seam actually takes the id, which is what
+ * lets `RunEventGate` tell "seeded" from "silently not seeded".
+ */
+declare function withRunIdSeededChannelRuntime<T extends Record<string, unknown>>(channel: T, runId: string, onSeedApplied?: () => void): T;
 interface PluginServiceContext {
   config: Record<string, unknown>;
   workspaceDir?: string;
@@ -770,4 +832,4 @@ declare const _default: {
   deactivate(api: PluginApi): Promise<void>;
 };
 //#endregion
-export { AlfeResolvedAccount as A, resolveRequestedRunId as C, createAlfeChannelPlugin as D, withReplyRunId as E, SessionData as M, SessionSummary as N, AlfeChannelConfig as O, resolveAbortTargetKeys as S, stripLeakedToolSummary as T, buildTurnEnvelopeContext as _, MAX_INBOUND_ATTACHMENT_SIZE as a, joinAssistantText as b, __agentTurnQueueForTest as c, _default as d, admitAgentEvent as f, buildToolActivity as g, buildOriginEnvelopeContext as h, CROSS_AGENT_TOOLS_SYSTEM_PROMPT as i, ChatMessage as j, AlfePluginConfig as k, __resetAgentTurnQueueForTest as l, buildAttachmentLocalFilename as m, ActiveRunRef as n, RunEventGate as o, buildA2ACompletePayload as p, AnchorEnv as r, VOICE_REPLY_SYSTEM_PROMPT as s, A2A_REPLY_SYSTEM_PROMPT as t, __setActiveRunForTest as u, computeOpenClawSdkAnchors as v, rewriteAssistantText as w, readAttachmentBodyBounded as x, decideChatServiceStart as y };
+export { AlfePluginConfig as A, resolveRequestedRunId as C, withRunIdSeededChannelRuntime as D, withReplyRunId as E, ChatMessage as M, SessionData as N, createAlfeChannelPlugin as O, SessionSummary as P, resolveAbortTargetKeys as S, stripLeakedToolSummary as T, buildTurnEnvelopeContext as _, MAX_INBOUND_ATTACHMENT_SIZE as a, joinAssistantText as b, __agentTurnQueueForTest as c, _default as d, admitAgentEvent as f, buildToolActivity as g, buildOriginEnvelopeContext as h, CROSS_AGENT_TOOLS_SYSTEM_PROMPT as i, AlfeResolvedAccount as j, AlfeChannelConfig as k, __resetAgentTurnQueueForTest as l, buildAttachmentLocalFilename as m, ActiveRunRef as n, RunEventGate as o, buildA2ACompletePayload as p, AnchorEnv as r, VOICE_REPLY_SYSTEM_PROMPT as s, A2A_REPLY_SYSTEM_PROMPT as t, __setActiveRunForTest as u, computeOpenClawSdkAnchors as v, rewriteAssistantText as w, readAttachmentBodyBounded as x, decideChatServiceStart as y };

package/dist/plugin.d.ts

@@ -1,3 +1,24 @@
+//#region src/runtime-config.d.ts
+/**
+ * Read the live OpenClaw config through the plugin runtime.
+ *
+ * OpenClaw 2026.9.x replaced `runtime.config.loadConfig()` with
+ * `runtime.config.current()`; 2026.6.11 exposes only `loadConfig()`. On 9.5
+ * `current()` returns the process-wide pinned config object BY REFERENCE (not a
+ * copy, not frozen): treat the result as read-only, mutating it corrupts config
+ * for every plugin in the process. Both verified on the dists (2026-09-21): on 9.5 the
+ * old call throws "runtime.config.loadConfig is not a function" inside the
+ * chat request handler, which took chat down on the first 2026.9.5 host. A
+ * managed fleet is mixed across a runtime upgrade, so support both shapes.
+ *
+ * Kept local rather than in `@alfe.ai/openclaw-plugin-kit`: a kit release fans
+ * out to every plugin package and its manifest pin.
+ */
+interface RuntimeConfigApi {
+  current?: () => unknown;
+  loadConfig?: () => Record<string, unknown>;
+}
+//#endregion
 //#region src/session-store.d.ts
 /**
  * Session Store — persists chat sessions to the local filesystem.
@@ -396,9 +417,7 @@ interface PluginLogger {
   debug(msg: string, ...args: unknown[]): void;
 }
 interface PluginRuntime {
-  config: {
-    loadConfig(): Record<string, unknown>;
-  };
+  config: RuntimeConfigApi;
   events: {
     onAgentEvent(listener: (evt: AgentEventPayload) => void): () => void;
   };
@@ -450,6 +469,22 @@ interface AgentEventPayload {
 interface RunEventGate {
   runId: string | null;
   sessionKey: string | null;
+  /**
+   * Set to `false` when the gate is PRE-ARMED with a service-owned run id, and
+   * flipped to `true` by `withRunIdSeededChannelRuntime` once a dispatch seam
+   * has actually accepted that id. Absent when no seed was attempted.
+   */
+  seedApplied?: boolean;
+  /**
+   * Set to `true` immediately before the turn enters `dispatchInbound`. Only
+   * meaningful alongside `seedApplied`: it separates a seed that is still
+   * PENDING (dispatch has not run yet, so the listener is only seeing other
+   * runs) from one that has FAILED (dispatch is under way and the run is
+   * already emitting under an id no seam ever took). Without it a concurrent
+   * cron/heartbeat event arriving between listener subscription and dispatch
+   * could steal the gate.
+   */
+  dispatchStarted?: boolean;
 }
 /**
  * Decide whether an agent-event belongs to THIS turn's run and should be
@@ -492,6 +527,33 @@ declare function admitAgentEvent(gate: RunEventGate, evt: Pick<AgentEventPayload
 declare function resolveRequestedRunId(idempotencyKey: unknown): string | null;
 /** Preserve OpenClaw-provided reply options while seeding this exact run id. */
 declare function withReplyRunId(params: Record<string, unknown>, runId: string): Record<string, unknown>;
+/**
+ * Seed this turn's run id on EVERY direct-DM dispatch seam across the
+ * supported OpenClaw fleet, returning a shallow per-call clone of
+ * `runtime.channel` (never mutating the process-global runtime).
+ *
+ * `dispatchInboundDirectDmWithRuntime` has no `replyOptions` parameter, so the
+ * run id has to be merged into whichever lower seam that helper drives — and
+ * which one it drives CHANGED between the versions running on the fleet:
+ *
+ * - **2026.6.x** calls `channel.reply.dispatchReplyWithBufferedBlockDispatcher`
+ *   directly with a top-level `replyOptions`
+ *   (`dist/direct-dm-*.js`: `replyOptions: { onModelSelected }`).
+ * - **2026.9.x** builds a turn PLAN (`buildDirectDmTurnPlan`) whose
+ *   `replyOptions` is `{ onModelSelected, ...turnAdoptionLifecycle? }` and
+ *   hands it to `channel.inbound.run` via `adapter.resolveTurn`
+ *   (`dist/channel-inbound-*.mjs`). The reply dispatcher is NEVER called, so
+ *   wrapping it alone is dead code on 9.5. The plan's `replyOptions.runId`
+ *   survives `runChannelTurn` → `dispatchRoutedChannelTurn` →
+ *   `dispatchInboundMessage` and becomes the embedded run's id
+ *   (`embedded-backend-*.mjs`: `const runId = opts.runId ?? randomUUID()`).
+ *
+ * Both seams are wrapped when present, so a mixed fleet keeps working and the
+ * wrapper for the version that is NOT running is simply never invoked.
+ * `onSeedApplied` fires the moment a seam actually takes the id, which is what
+ * lets `RunEventGate` tell "seeded" from "silently not seeded".
+ */
+declare function withRunIdSeededChannelRuntime<T extends Record<string, unknown>>(channel: T, runId: string, onSeedApplied?: () => void): T;
 interface PluginServiceContext {
   config: Record<string, unknown>;
   workspaceDir?: string;
@@ -770,4 +832,4 @@ declare const _default: {
   deactivate(api: PluginApi): Promise<void>;
 };
 //#endregion
-export { AlfeResolvedAccount as A, resolveRequestedRunId as C, createAlfeChannelPlugin as D, withReplyRunId as E, SessionData as M, SessionSummary as N, AlfeChannelConfig as O, resolveAbortTargetKeys as S, stripLeakedToolSummary as T, buildTurnEnvelopeContext as _, MAX_INBOUND_ATTACHMENT_SIZE as a, joinAssistantText as b, __agentTurnQueueForTest as c, _default as d, admitAgentEvent as f, buildToolActivity as g, buildOriginEnvelopeContext as h, CROSS_AGENT_TOOLS_SYSTEM_PROMPT as i, ChatMessage as j, AlfePluginConfig as k, __resetAgentTurnQueueForTest as l, buildAttachmentLocalFilename as m, ActiveRunRef as n, RunEventGate as o, buildA2ACompletePayload as p, AnchorEnv as r, VOICE_REPLY_SYSTEM_PROMPT as s, A2A_REPLY_SYSTEM_PROMPT as t, __setActiveRunForTest as u, computeOpenClawSdkAnchors as v, rewriteAssistantText as w, readAttachmentBodyBounded as x, decideChatServiceStart as y };
+export { AlfePluginConfig as A, resolveRequestedRunId as C, withRunIdSeededChannelRuntime as D, withReplyRunId as E, ChatMessage as M, SessionData as N, createAlfeChannelPlugin as O, SessionSummary as P, resolveAbortTargetKeys as S, stripLeakedToolSummary as T, buildTurnEnvelopeContext as _, MAX_INBOUND_ATTACHMENT_SIZE as a, joinAssistantText as b, __agentTurnQueueForTest as c, _default as d, admitAgentEvent as f, buildToolActivity as g, buildOriginEnvelopeContext as h, CROSS_AGENT_TOOLS_SYSTEM_PROMPT as i, AlfeResolvedAccount as j, AlfeChannelConfig as k, __resetAgentTurnQueueForTest as l, buildAttachmentLocalFilename as m, ActiveRunRef as n, RunEventGate as o, buildA2ACompletePayload as p, AnchorEnv as r, VOICE_REPLY_SYSTEM_PROMPT as s, A2A_REPLY_SYSTEM_PROMPT as t, __setActiveRunForTest as u, computeOpenClawSdkAnchors as v, rewriteAssistantText as w, readAttachmentBodyBounded as x, decideChatServiceStart as y };

package/dist/plugin.js

@@ -1,2 +1,2 @@
-import { C as withReplyRunId, S as stripLeakedToolSummary, _ as plugin_default, a as __agentTurnQueueForTest, b as resolveRequestedRunId, c as admitAgentEvent, d as buildOriginEnvelopeContext, f as buildToolActivity, g as joinAssistantText, h as decideChatServiceStart, i as VOICE_REPLY_SYSTEM_PROMPT, l as buildA2ACompletePayload, m as computeOpenClawSdkAnchors, n as CROSS_AGENT_TOOLS_SYSTEM_PROMPT, o as __resetAgentTurnQueueForTest, p as buildTurnEnvelopeContext, r as MAX_INBOUND_ATTACHMENT_SIZE, s as __setActiveRunForTest, t as A2A_REPLY_SYSTEM_PROMPT, u as buildAttachmentLocalFilename, v as readAttachmentBodyBounded, x as rewriteAssistantText, y as resolveAbortTargetKeys } from "./plugin2.js";
-export { A2A_REPLY_SYSTEM_PROMPT, CROSS_AGENT_TOOLS_SYSTEM_PROMPT, MAX_INBOUND_ATTACHMENT_SIZE, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildAttachmentLocalFilename, buildOriginEnvelopeContext, buildToolActivity, buildTurnEnvelopeContext, computeOpenClawSdkAnchors, decideChatServiceStart, plugin_default as default, joinAssistantText, readAttachmentBodyBounded, resolveAbortTargetKeys, resolveRequestedRunId, rewriteAssistantText, stripLeakedToolSummary, withReplyRunId };
+import { C as withReplyRunId, S as stripLeakedToolSummary, _ as plugin_default, a as __agentTurnQueueForTest, b as resolveRequestedRunId, c as admitAgentEvent, d as buildOriginEnvelopeContext, f as buildToolActivity, g as joinAssistantText, h as decideChatServiceStart, i as VOICE_REPLY_SYSTEM_PROMPT, l as buildA2ACompletePayload, m as computeOpenClawSdkAnchors, n as CROSS_AGENT_TOOLS_SYSTEM_PROMPT, o as __resetAgentTurnQueueForTest, p as buildTurnEnvelopeContext, r as MAX_INBOUND_ATTACHMENT_SIZE, s as __setActiveRunForTest, t as A2A_REPLY_SYSTEM_PROMPT, u as buildAttachmentLocalFilename, v as readAttachmentBodyBounded, w as withRunIdSeededChannelRuntime, x as rewriteAssistantText, y as resolveAbortTargetKeys } from "./plugin2.js";
+export { A2A_REPLY_SYSTEM_PROMPT, CROSS_AGENT_TOOLS_SYSTEM_PROMPT, MAX_INBOUND_ATTACHMENT_SIZE, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildAttachmentLocalFilename, buildOriginEnvelopeContext, buildToolActivity, buildTurnEnvelopeContext, computeOpenClawSdkAnchors, decideChatServiceStart, plugin_default as default, joinAssistantText, readAttachmentBodyBounded, resolveAbortTargetKeys, resolveRequestedRunId, rewriteAssistantText, stripLeakedToolSummary, withReplyRunId, withRunIdSeededChannelRuntime };

package/dist/plugin2.cjs

@@ -10,6 +10,13 @@ let _alfe_ai_chat = require("@alfe.ai/chat");
 let _alfe_ai_agent_api_client = require("@alfe.ai/agent-api-client");
 let _alfe_ai_config = require("@alfe.ai/config");
 let _alfe_ai_openclaw_plugin_kit = require("@alfe.ai/openclaw-plugin-kit");
+//#region src/runtime-config.ts
+function readRuntimeConfig(config) {
+	if (typeof config?.current === "function") return config.current() ?? {};
+	if (typeof config?.loadConfig === "function") return config.loadConfig();
+	throw new Error("OpenClaw plugin runtime exposes neither config.current() nor config.loadConfig()");
+}
+//#endregion
 //#region src/outbound-media.ts
 /**
 * Outbound media upload — agent → user.
@@ -2298,8 +2305,10 @@ function getAgentApiClient(apiKeyOverride) {
 */
 function admitAgentEvent(gate, evt) {
 	if (!(evt.stream === "assistant" || evt.stream === "thinking" || evt.stream === "tool")) return false;
-	if (gate.runId === null) {
+	const seedFailed = gate.seedApplied === false && gate.dispatchStarted === true;
+	if (gate.runId === null || seedFailed) {
 		gate.runId = evt.runId;
+		gate.seedApplied = true;
 		if (evt.sessionKey) gate.sessionKey ??= evt.sessionKey;
 	}
 	if (evt.runId !== gate.runId) return false;
@@ -2325,6 +2334,88 @@ function withReplyRunId(params, runId) {
 		}
 	};
 }
+/**
+* True for a spreadable record. Arrays and `null` are excluded so a seam that
+* hands back a list or a nullish plan is passed through untouched instead of
+* being silently turned into an object.
+*/
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Seed this turn's run id on EVERY direct-DM dispatch seam across the
+* supported OpenClaw fleet, returning a shallow per-call clone of
+* `runtime.channel` (never mutating the process-global runtime).
+*
+* `dispatchInboundDirectDmWithRuntime` has no `replyOptions` parameter, so the
+* run id has to be merged into whichever lower seam that helper drives — and
+* which one it drives CHANGED between the versions running on the fleet:
+*
+* - **2026.6.x** calls `channel.reply.dispatchReplyWithBufferedBlockDispatcher`
+*   directly with a top-level `replyOptions`
+*   (`dist/direct-dm-*.js`: `replyOptions: { onModelSelected }`).
+* - **2026.9.x** builds a turn PLAN (`buildDirectDmTurnPlan`) whose
+*   `replyOptions` is `{ onModelSelected, ...turnAdoptionLifecycle? }` and
+*   hands it to `channel.inbound.run` via `adapter.resolveTurn`
+*   (`dist/channel-inbound-*.mjs`). The reply dispatcher is NEVER called, so
+*   wrapping it alone is dead code on 9.5. The plan's `replyOptions.runId`
+*   survives `runChannelTurn` → `dispatchRoutedChannelTurn` →
+*   `dispatchInboundMessage` and becomes the embedded run's id
+*   (`embedded-backend-*.mjs`: `const runId = opts.runId ?? randomUUID()`).
+*
+* Both seams are wrapped when present, so a mixed fleet keeps working and the
+* wrapper for the version that is NOT running is simply never invoked.
+* `onSeedApplied` fires the moment a seam actually takes the id, which is what
+* lets `RunEventGate` tell "seeded" from "silently not seeded".
+*/
+function withRunIdSeededChannelRuntime(channel, runId, onSeedApplied) {
+	const seeded = { ...channel };
+	const seedPlan = (plan) => {
+		if (!isPlainObject(plan)) return plan;
+		onSeedApplied?.();
+		return withReplyRunId(plan, runId);
+	};
+	const reply = isPlainObject(channel.reply) ? channel.reply : void 0;
+	const lowerDispatch = reply?.dispatchReplyWithBufferedBlockDispatcher;
+	if (reply && typeof lowerDispatch === "function") {
+		const call = lowerDispatch;
+		seeded.reply = {
+			...reply,
+			dispatchReplyWithBufferedBlockDispatcher: (params) => call.call(reply, seedPlan(params))
+		};
+	}
+	const inbound = isPlainObject(channel.inbound) ? channel.inbound : void 0;
+	const inboundRun = inbound?.run;
+	const inboundDispatch = inbound?.dispatch;
+	if (inbound && (typeof inboundRun === "function" || typeof inboundDispatch === "function")) {
+		const wrapped = { ...inbound };
+		if (typeof inboundRun === "function") {
+			const call = inboundRun;
+			wrapped.run = (params) => {
+				const adapter = isPlainObject(params.adapter) ? params.adapter : void 0;
+				const resolveTurn = adapter?.resolveTurn;
+				if (!adapter || typeof resolveTurn !== "function") return call.call(inbound, params);
+				const resolve = resolveTurn;
+				return call.call(inbound, {
+					...params,
+					adapter: {
+						...adapter,
+						resolveTurn: (...args) => {
+							const plan = resolve.apply(adapter, args);
+							return plan instanceof Promise ? plan.then(seedPlan) : seedPlan(plan);
+						}
+					}
+				});
+			};
+		}
+		if (typeof inboundDispatch === "function") {
+			const call = inboundDispatch;
+			wrapped.dispatch = (params) => call.call(inbound, seedPlan(params));
+		}
+		seeded.inbound = wrapped;
+	}
+	return seeded;
+}
 function asString(v) {
 	return typeof v === "string" && v.length > 0 ? v : void 0;
 }
@@ -3083,14 +3174,18 @@ async function handleAgentRequest(request, log) {
 		return;
 	}
 	const senderId = userId ?? "anon";
-	const cfg = runtime.config.loadConfig();
+	const cfg = readRuntimeConfig(runtime.config);
 	const sessionId = conversationId ?? legacySessionKey;
 	if (!await getSession(sessionId)) await createSession(sessionId, "", "alfe", tenantId, userId);
 	await addMessage(sessionId, "user", message, userId ?? senderId, displayName ?? senderId, void 0, userAttachmentsToStored(rawAttachments));
 	const requestedRunId = resolveRequestedRunId(idempotencyKey);
 	const runGate = {
 		runId: requestedRunId,
-		sessionKey: null
+		sessionKey: null,
+		...requestedRunId ? {
+			seedApplied: false,
+			dispatchStarted: false
+		} : {}
 	};
 	let lastThinkingLen = 0;
 	let sawStructuredThinking = false;
@@ -3277,13 +3372,10 @@ async function handleAgentRequest(request, log) {
 			routeSessionKey,
 			...requestedRunId ? { runId: requestedRunId } : {}
 		};
-		const dispatchChannel = requestedRunId ? {
-			...runtime.channel,
-			reply: {
-				...runtime.channel.reply,
-				dispatchReplyWithBufferedBlockDispatcher: (params) => runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher(withReplyRunId(params, requestedRunId))
-			}
-		} : runtime.channel;
+		const dispatchChannel = requestedRunId ? withRunIdSeededChannelRuntime(runtime.channel, requestedRunId, () => {
+			runGate.seedApplied = true;
+		}) : runtime.channel;
+		runGate.dispatchStarted = true;
 		const result = await dispatchInbound({
 			cfg,
 			runtime: { channel: dispatchChannel },
@@ -3857,3 +3949,9 @@ Object.defineProperty(exports, "withReplyRunId", {
 		return withReplyRunId;
 	}
 });
+Object.defineProperty(exports, "withRunIdSeededChannelRuntime", {
+	enumerable: true,
+	get: function() {
+		return withRunIdSeededChannelRuntime;
+	}
+});

package/dist/plugin2.d.cts

@@ -1,2 +1,2 @@
-import { C as resolveRequestedRunId, E as withReplyRunId, S as resolveAbortTargetKeys, T as stripLeakedToolSummary, _ as buildTurnEnvelopeContext, a as MAX_INBOUND_ATTACHMENT_SIZE, b as joinAssistantText, c as __agentTurnQueueForTest, d as _default, f as admitAgentEvent, g as buildToolActivity, h as buildOriginEnvelopeContext, i as CROSS_AGENT_TOOLS_SYSTEM_PROMPT, l as __resetAgentTurnQueueForTest, m as buildAttachmentLocalFilename, n as ActiveRunRef, o as RunEventGate, p as buildA2ACompletePayload, r as AnchorEnv, s as VOICE_REPLY_SYSTEM_PROMPT, t as A2A_REPLY_SYSTEM_PROMPT, u as __setActiveRunForTest, v as computeOpenClawSdkAnchors, w as rewriteAssistantText, x as readAttachmentBodyBounded, y as decideChatServiceStart } from "./plugin.cjs";
-export { A2A_REPLY_SYSTEM_PROMPT, ActiveRunRef, AnchorEnv, CROSS_AGENT_TOOLS_SYSTEM_PROMPT, MAX_INBOUND_ATTACHMENT_SIZE, RunEventGate, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildAttachmentLocalFilename, buildOriginEnvelopeContext, buildToolActivity, buildTurnEnvelopeContext, computeOpenClawSdkAnchors, decideChatServiceStart, _default as default, joinAssistantText, readAttachmentBodyBounded, resolveAbortTargetKeys, resolveRequestedRunId, rewriteAssistantText, stripLeakedToolSummary, withReplyRunId };
+import { C as resolveRequestedRunId, D as withRunIdSeededChannelRuntime, E as withReplyRunId, S as resolveAbortTargetKeys, T as stripLeakedToolSummary, _ as buildTurnEnvelopeContext, a as MAX_INBOUND_ATTACHMENT_SIZE, b as joinAssistantText, c as __agentTurnQueueForTest, d as _default, f as admitAgentEvent, g as buildToolActivity, h as buildOriginEnvelopeContext, i as CROSS_AGENT_TOOLS_SYSTEM_PROMPT, l as __resetAgentTurnQueueForTest, m as buildAttachmentLocalFilename, n as ActiveRunRef, o as RunEventGate, p as buildA2ACompletePayload, r as AnchorEnv, s as VOICE_REPLY_SYSTEM_PROMPT, t as A2A_REPLY_SYSTEM_PROMPT, u as __setActiveRunForTest, v as computeOpenClawSdkAnchors, w as rewriteAssistantText, x as readAttachmentBodyBounded, y as decideChatServiceStart } from "./plugin.cjs";
+export { A2A_REPLY_SYSTEM_PROMPT, ActiveRunRef, AnchorEnv, CROSS_AGENT_TOOLS_SYSTEM_PROMPT, MAX_INBOUND_ATTACHMENT_SIZE, RunEventGate, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildAttachmentLocalFilename, buildOriginEnvelopeContext, buildToolActivity, buildTurnEnvelopeContext, computeOpenClawSdkAnchors, decideChatServiceStart, _default as default, joinAssistantText, readAttachmentBodyBounded, resolveAbortTargetKeys, resolveRequestedRunId, rewriteAssistantText, stripLeakedToolSummary, withReplyRunId, withRunIdSeededChannelRuntime };

package/dist/plugin2.d.ts

@@ -1,2 +1,2 @@
-import { C as resolveRequestedRunId, E as withReplyRunId, S as resolveAbortTargetKeys, T as stripLeakedToolSummary, _ as buildTurnEnvelopeContext, a as MAX_INBOUND_ATTACHMENT_SIZE, b as joinAssistantText, c as __agentTurnQueueForTest, d as _default, f as admitAgentEvent, g as buildToolActivity, h as buildOriginEnvelopeContext, i as CROSS_AGENT_TOOLS_SYSTEM_PROMPT, l as __resetAgentTurnQueueForTest, m as buildAttachmentLocalFilename, n as ActiveRunRef, o as RunEventGate, p as buildA2ACompletePayload, r as AnchorEnv, s as VOICE_REPLY_SYSTEM_PROMPT, t as A2A_REPLY_SYSTEM_PROMPT, u as __setActiveRunForTest, v as computeOpenClawSdkAnchors, w as rewriteAssistantText, x as readAttachmentBodyBounded, y as decideChatServiceStart } from "./plugin.js";
-export { A2A_REPLY_SYSTEM_PROMPT, ActiveRunRef, AnchorEnv, CROSS_AGENT_TOOLS_SYSTEM_PROMPT, MAX_INBOUND_ATTACHMENT_SIZE, RunEventGate, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildAttachmentLocalFilename, buildOriginEnvelopeContext, buildToolActivity, buildTurnEnvelopeContext, computeOpenClawSdkAnchors, decideChatServiceStart, _default as default, joinAssistantText, readAttachmentBodyBounded, resolveAbortTargetKeys, resolveRequestedRunId, rewriteAssistantText, stripLeakedToolSummary, withReplyRunId };
+import { C as resolveRequestedRunId, D as withRunIdSeededChannelRuntime, E as withReplyRunId, S as resolveAbortTargetKeys, T as stripLeakedToolSummary, _ as buildTurnEnvelopeContext, a as MAX_INBOUND_ATTACHMENT_SIZE, b as joinAssistantText, c as __agentTurnQueueForTest, d as _default, f as admitAgentEvent, g as buildToolActivity, h as buildOriginEnvelopeContext, i as CROSS_AGENT_TOOLS_SYSTEM_PROMPT, l as __resetAgentTurnQueueForTest, m as buildAttachmentLocalFilename, n as ActiveRunRef, o as RunEventGate, p as buildA2ACompletePayload, r as AnchorEnv, s as VOICE_REPLY_SYSTEM_PROMPT, t as A2A_REPLY_SYSTEM_PROMPT, u as __setActiveRunForTest, v as computeOpenClawSdkAnchors, w as rewriteAssistantText, x as readAttachmentBodyBounded, y as decideChatServiceStart } from "./plugin.js";
+export { A2A_REPLY_SYSTEM_PROMPT, ActiveRunRef, AnchorEnv, CROSS_AGENT_TOOLS_SYSTEM_PROMPT, MAX_INBOUND_ATTACHMENT_SIZE, RunEventGate, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildAttachmentLocalFilename, buildOriginEnvelopeContext, buildToolActivity, buildTurnEnvelopeContext, computeOpenClawSdkAnchors, decideChatServiceStart, _default as default, joinAssistantText, readAttachmentBodyBounded, resolveAbortTargetKeys, resolveRequestedRunId, rewriteAssistantText, stripLeakedToolSummary, withReplyRunId, withRunIdSeededChannelRuntime };

package/dist/plugin2.js

@@ -10,6 +10,13 @@ import { ChatServiceClient, resolveAlfeChat } from "@alfe.ai/chat";
 import { AgentApiClient, installToolErrorCapture } from "@alfe.ai/agent-api-client";
 import { getEndpointFromToken, resolveConfig } from "@alfe.ai/config";
 import { defineTool, getActivationKey, publicToolError, resetActivation } from "@alfe.ai/openclaw-plugin-kit";
+//#region src/runtime-config.ts
+function readRuntimeConfig(config) {
+	if (typeof config?.current === "function") return config.current() ?? {};
+	if (typeof config?.loadConfig === "function") return config.loadConfig();
+	throw new Error("OpenClaw plugin runtime exposes neither config.current() nor config.loadConfig()");
+}
+//#endregion
 //#region src/outbound-media.ts
 /**
 * Outbound media upload — agent → user.
@@ -2298,8 +2305,10 @@ function getAgentApiClient(apiKeyOverride) {
 */
 function admitAgentEvent(gate, evt) {
 	if (!(evt.stream === "assistant" || evt.stream === "thinking" || evt.stream === "tool")) return false;
-	if (gate.runId === null) {
+	const seedFailed = gate.seedApplied === false && gate.dispatchStarted === true;
+	if (gate.runId === null || seedFailed) {
 		gate.runId = evt.runId;
+		gate.seedApplied = true;
 		if (evt.sessionKey) gate.sessionKey ??= evt.sessionKey;
 	}
 	if (evt.runId !== gate.runId) return false;
@@ -2325,6 +2334,88 @@ function withReplyRunId(params, runId) {
 		}
 	};
 }
+/**
+* True for a spreadable record. Arrays and `null` are excluded so a seam that
+* hands back a list or a nullish plan is passed through untouched instead of
+* being silently turned into an object.
+*/
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Seed this turn's run id on EVERY direct-DM dispatch seam across the
+* supported OpenClaw fleet, returning a shallow per-call clone of
+* `runtime.channel` (never mutating the process-global runtime).
+*
+* `dispatchInboundDirectDmWithRuntime` has no `replyOptions` parameter, so the
+* run id has to be merged into whichever lower seam that helper drives — and
+* which one it drives CHANGED between the versions running on the fleet:
+*
+* - **2026.6.x** calls `channel.reply.dispatchReplyWithBufferedBlockDispatcher`
+*   directly with a top-level `replyOptions`
+*   (`dist/direct-dm-*.js`: `replyOptions: { onModelSelected }`).
+* - **2026.9.x** builds a turn PLAN (`buildDirectDmTurnPlan`) whose
+*   `replyOptions` is `{ onModelSelected, ...turnAdoptionLifecycle? }` and
+*   hands it to `channel.inbound.run` via `adapter.resolveTurn`
+*   (`dist/channel-inbound-*.mjs`). The reply dispatcher is NEVER called, so
+*   wrapping it alone is dead code on 9.5. The plan's `replyOptions.runId`
+*   survives `runChannelTurn` → `dispatchRoutedChannelTurn` →
+*   `dispatchInboundMessage` and becomes the embedded run's id
+*   (`embedded-backend-*.mjs`: `const runId = opts.runId ?? randomUUID()`).
+*
+* Both seams are wrapped when present, so a mixed fleet keeps working and the
+* wrapper for the version that is NOT running is simply never invoked.
+* `onSeedApplied` fires the moment a seam actually takes the id, which is what
+* lets `RunEventGate` tell "seeded" from "silently not seeded".
+*/
+function withRunIdSeededChannelRuntime(channel, runId, onSeedApplied) {
+	const seeded = { ...channel };
+	const seedPlan = (plan) => {
+		if (!isPlainObject(plan)) return plan;
+		onSeedApplied?.();
+		return withReplyRunId(plan, runId);
+	};
+	const reply = isPlainObject(channel.reply) ? channel.reply : void 0;
+	const lowerDispatch = reply?.dispatchReplyWithBufferedBlockDispatcher;
+	if (reply && typeof lowerDispatch === "function") {
+		const call = lowerDispatch;
+		seeded.reply = {
+			...reply,
+			dispatchReplyWithBufferedBlockDispatcher: (params) => call.call(reply, seedPlan(params))
+		};
+	}
+	const inbound = isPlainObject(channel.inbound) ? channel.inbound : void 0;
+	const inboundRun = inbound?.run;
+	const inboundDispatch = inbound?.dispatch;
+	if (inbound && (typeof inboundRun === "function" || typeof inboundDispatch === "function")) {
+		const wrapped = { ...inbound };
+		if (typeof inboundRun === "function") {
+			const call = inboundRun;
+			wrapped.run = (params) => {
+				const adapter = isPlainObject(params.adapter) ? params.adapter : void 0;
+				const resolveTurn = adapter?.resolveTurn;
+				if (!adapter || typeof resolveTurn !== "function") return call.call(inbound, params);
+				const resolve = resolveTurn;
+				return call.call(inbound, {
+					...params,
+					adapter: {
+						...adapter,
+						resolveTurn: (...args) => {
+							const plan = resolve.apply(adapter, args);
+							return plan instanceof Promise ? plan.then(seedPlan) : seedPlan(plan);
+						}
+					}
+				});
+			};
+		}
+		if (typeof inboundDispatch === "function") {
+			const call = inboundDispatch;
+			wrapped.dispatch = (params) => call.call(inbound, seedPlan(params));
+		}
+		seeded.inbound = wrapped;
+	}
+	return seeded;
+}
 function asString(v) {
 	return typeof v === "string" && v.length > 0 ? v : void 0;
 }
@@ -3083,14 +3174,18 @@ async function handleAgentRequest(request, log) {
 		return;
 	}
 	const senderId = userId ?? "anon";
-	const cfg = runtime.config.loadConfig();
+	const cfg = readRuntimeConfig(runtime.config);
 	const sessionId = conversationId ?? legacySessionKey;
 	if (!await getSession(sessionId)) await createSession(sessionId, "", "alfe", tenantId, userId);
 	await addMessage(sessionId, "user", message, userId ?? senderId, displayName ?? senderId, void 0, userAttachmentsToStored(rawAttachments));
 	const requestedRunId = resolveRequestedRunId(idempotencyKey);
 	const runGate = {
 		runId: requestedRunId,
-		sessionKey: null
+		sessionKey: null,
+		...requestedRunId ? {
+			seedApplied: false,
+			dispatchStarted: false
+		} : {}
 	};
 	let lastThinkingLen = 0;
 	let sawStructuredThinking = false;
@@ -3277,13 +3372,10 @@ async function handleAgentRequest(request, log) {
 			routeSessionKey,
 			...requestedRunId ? { runId: requestedRunId } : {}
 		};
-		const dispatchChannel = requestedRunId ? {
-			...runtime.channel,
-			reply: {
-				...runtime.channel.reply,
-				dispatchReplyWithBufferedBlockDispatcher: (params) => runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher(withReplyRunId(params, requestedRunId))
-			}
-		} : runtime.channel;
+		const dispatchChannel = requestedRunId ? withRunIdSeededChannelRuntime(runtime.channel, requestedRunId, () => {
+			runGate.seedApplied = true;
+		}) : runtime.channel;
+		runGate.dispatchStarted = true;
 		const result = await dispatchInbound({
 			cfg,
 			runtime: { channel: dispatchChannel },
@@ -3713,4 +3805,4 @@ var plugin_default = {
 	register: plugin.activate.bind(plugin)
 };
 //#endregion
-export { withReplyRunId as C, stripLeakedToolSummary as S, plugin_default as _, __agentTurnQueueForTest as a, resolveRequestedRunId as b, admitAgentEvent as c, buildOriginEnvelopeContext as d, buildToolActivity as f, joinAssistantText as g, decideChatServiceStart as h, VOICE_REPLY_SYSTEM_PROMPT as i, buildA2ACompletePayload as l, computeOpenClawSdkAnchors as m, CROSS_AGENT_TOOLS_SYSTEM_PROMPT as n, __resetAgentTurnQueueForTest as o, buildTurnEnvelopeContext as p, MAX_INBOUND_ATTACHMENT_SIZE as r, __setActiveRunForTest as s, A2A_REPLY_SYSTEM_PROMPT as t, buildAttachmentLocalFilename as u, readAttachmentBodyBounded as v, createAlfeChannelPlugin as w, rewriteAssistantText as x, resolveAbortTargetKeys as y };
+export { withReplyRunId as C, stripLeakedToolSummary as S, createAlfeChannelPlugin as T, plugin_default as _, __agentTurnQueueForTest as a, resolveRequestedRunId as b, admitAgentEvent as c, buildOriginEnvelopeContext as d, buildToolActivity as f, joinAssistantText as g, decideChatServiceStart as h, VOICE_REPLY_SYSTEM_PROMPT as i, buildA2ACompletePayload as l, computeOpenClawSdkAnchors as m, CROSS_AGENT_TOOLS_SYSTEM_PROMPT as n, __resetAgentTurnQueueForTest as o, buildTurnEnvelopeContext as p, MAX_INBOUND_ATTACHMENT_SIZE as r, __setActiveRunForTest as s, A2A_REPLY_SYSTEM_PROMPT as t, buildAttachmentLocalFilename as u, readAttachmentBodyBounded as v, withRunIdSeededChannelRuntime as w, rewriteAssistantText as x, resolveAbortTargetKeys as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-chat",
-  "version": "0.9.20",
+  "version": "0.9.21",
   "description": "OpenClaw chat plugin for Alfe — web widget and mobile app channels",
   "type": "module",
   "main": "./dist/plugin.js",
@@ -27,7 +27,7 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@alfe.ai/agent-api-client": "^0.19.1",
+    "@alfe.ai/agent-api-client": "^0.19.2",
     "@alfe.ai/chat": "^0.0.19",
     "@alfe.ai/config": "^0.4.1",
     "@alfe.ai/openclaw-plugin-kit": "0.2.0"