@xmanrui/dsh-im 0.10.0 → 0.12.0

package/plugin-src/host/channels/shared/rpc.mjs

@@ -1,4 +1,5 @@
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
+import { publicConnectionTestResult } from '../../../../src/channels/shared/connection-test.mjs';
 import {
   publicWorkspaceError,
   SET_WORKSPACE_ENDPOINT,
@@ -44,7 +45,8 @@ function payloadFailure(endpoint, payload) {
       ? null : 'bot.bind-credentials requires a Bot Token.';
   }
   if (endpoint === TOKEN_BOT_ENDPOINTS.reconnectBot) {
-    return exactKeys(payload, ['botId']) && validId(payload.botId)
+    return exactKeys(payload, ['botId', 'sendTest']) && validId(payload.botId)
+      && (payload.sendTest === undefined || typeof payload.sendTest === 'boolean')
       ? null : 'bot.reconnect requires a botId.';
   }
   if (endpoint === TOKEN_BOT_ENDPOINTS.deleteBot) {
@@ -105,6 +107,28 @@ export function createTokenBotRpcHandler(controller, { channel }) {
         value = await controller.bindCredentials(payload);
       } else if (endpoint === TOKEN_BOT_ENDPOINTS.reconnectBot) {
         value = await controller.reconnectBot(payload.botId);
+        if (signal?.aborted) {
+          return { ok: false, error: { code: 'cancelled', message: 'The request was cancelled.' } };
+        }
+        if (payload.sendTest === true) {
+          let testError = null;
+          try {
+            if (value?.bots?.find((bot) => bot?.botId === payload.botId)?.connected !== true) {
+              const unavailable = new Error('Bot is not connected');
+              unavailable.code = 'test-target-unavailable';
+              throw unavailable;
+            }
+            if (typeof controller.sendConnectionTest !== 'function') {
+              const unavailable = new Error('Connection test is unavailable');
+              unavailable.code = 'test-target-unavailable';
+              throw unavailable;
+            }
+            await controller.sendConnectionTest(payload.botId);
+          } catch (error) {
+            testError = error;
+          }
+          value = { ...value, testMessage: publicConnectionTestResult(testError) };
+        }
       } else if (endpoint === TOKEN_BOT_ENDPOINTS.setWorkspace) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await controller.updateWorkspace(payload.botId, payload.workspace);

package/plugin-src/host/channels/slack/production.mjs

@@ -15,6 +15,7 @@ import {
 import { createTokenConnectionSupervisor } from '../shared/connection-supervisor.mjs';
 import { harnessOrigin, pluginPaths } from '../shared/production.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
+import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
 
 export async function createProductionController(ctx, config = {}, internals = {}) {
   if (!ctx?.credentials) throw new TypeError('dsh-im slack requires ctx.credentials');
@@ -51,13 +52,19 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const { controlExecutor, sessionMaintenanceExecutor } = createHarnessSessionExecutors(ctx, {
+    controlExecutor: internals.controlExecutor,
+    sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
+  });
   const harness = new ResolvedHarness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
-    agentPreset: config.agentPreset ?? 'standard',
+    ...(config.agentPreset == null ? {} : { agentPreset: config.agentPreset }),
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
     ...(commandExecutor ? { commandExecutor } : {}),
+    ...(controlExecutor ? { controlExecutor } : {}),
+    ...(sessionMaintenanceExecutor ? { sessionMaintenanceExecutor } : {}),
   });
   const coreController = new ResolvedController({
     credentials: ctx.credentials,

package/plugin-src/host/channels/slack/rpc.mjs

@@ -1,4 +1,5 @@
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
+import { publicConnectionTestResult } from '../../../../src/channels/shared/connection-test.mjs';
 import {
   publicWorkspaceError,
   SET_WORKSPACE_ENDPOINT,
@@ -53,7 +54,8 @@ function payloadFailure(endpoint, payload) {
       ? null : 'bot.bind-credentials requires xoxb Bot Token and xapp App Token.';
   }
   if (endpoint === SLACK_ENDPOINTS.reconnectBot) {
-    return exactKeys(payload, ['botId']) && validId(payload.botId)
+    return exactKeys(payload, ['botId', 'sendTest']) && validId(payload.botId)
+      && (payload.sendTest === undefined || typeof payload.sendTest === 'boolean')
       ? null : 'bot.reconnect requires a botId.';
   }
   if (endpoint === SLACK_ENDPOINTS.deleteBot) {
@@ -114,7 +116,31 @@ export function createSlackRpcHandler(controller) {
       let value;
       if (endpoint === SLACK_ENDPOINTS.status) value = await controller.status();
       else if (endpoint === SLACK_ENDPOINTS.bindCredentials) value = await controller.bindCredentials(payload);
-      else if (endpoint === SLACK_ENDPOINTS.reconnectBot) value = await controller.reconnectBot(payload.botId);
+      else if (endpoint === SLACK_ENDPOINTS.reconnectBot) {
+        value = await controller.reconnectBot(payload.botId);
+        if (signal?.aborted) {
+          return { ok: false, error: { code: 'cancelled', message: 'The request was cancelled.' } };
+        }
+        if (payload.sendTest === true) {
+          let testError = null;
+          try {
+            if (value?.bots?.find((bot) => bot?.botId === payload.botId)?.connected !== true) {
+              const unavailable = new Error('Bot is not connected');
+              unavailable.code = 'test-target-unavailable';
+              throw unavailable;
+            }
+            if (typeof controller.sendConnectionTest !== 'function') {
+              const unavailable = new Error('Connection test is unavailable');
+              unavailable.code = 'test-target-unavailable';
+              throw unavailable;
+            }
+            await controller.sendConnectionTest(payload.botId);
+          } catch (error) {
+            testError = error;
+          }
+          value = { ...value, testMessage: publicConnectionTestResult(testError) };
+        }
+      }
       else if (endpoint === SLACK_ENDPOINTS.setWorkspace) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await controller.updateWorkspace(payload.botId, payload.workspace);

package/plugin-src/host/channels/wecom/production.mjs

@@ -16,6 +16,7 @@ import {
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
+import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
 
 function harnessOrigin(webServer, configured) {
   if (configured !== undefined) return new URL(configured);
@@ -75,13 +76,19 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const { controlExecutor, sessionMaintenanceExecutor } = createHarnessSessionExecutors(ctx, {
+    controlExecutor: internals.controlExecutor,
+    sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
+  });
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
-    agentPreset: config.agentPreset ?? 'standard',
+    ...(config.agentPreset == null ? {} : { agentPreset: config.agentPreset }),
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
     ...(commandExecutor ? { commandExecutor } : {}),
+    ...(controlExecutor ? { controlExecutor } : {}),
+    ...(sessionMaintenanceExecutor ? { sessionMaintenanceExecutor } : {}),
   });
   const coreController = new Controller({
     qrAuth,

package/plugin-src/host/channels/wecom/rpc.mjs

@@ -1,6 +1,10 @@
 import QRCode from 'qrcode';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
+import {
+  connectionTestTargetUnavailable,
+  publicConnectionTestResult,
+} from '../../../../src/channels/shared/connection-test.mjs';
 
 export const WECOM_RPC_CHANNEL = '/wecom';
 export const WECOM_ENDPOINTS = Object.freeze({
@@ -53,7 +57,10 @@ function payloadFailure(endpoint, payload) {
       ? null : 'bot.bind-credentials requires Bot ID and Secret.';
   }
   if (endpoint === WECOM_ENDPOINTS.reconnectBot) {
-    return exactKeys(payload, ['botId']) && validId(payload.botId) ? null : 'bot.reconnect requires a botId.';
+    return exactKeys(payload, ['botId', 'sendTest'])
+      && validId(payload.botId)
+      && (payload.sendTest === undefined || payload.sendTest === true)
+      ? null : 'bot.reconnect requires a botId and optional sendTest=true.';
   }
   if (endpoint === WECOM_ENDPOINTS.deleteBot) {
     return exactKeys(payload, ['botId', 'confirm']) && validId(payload.botId) && payload.confirm === true
@@ -130,7 +137,29 @@ export function createWecomRpcHandler(controller, { encodeQr = qrDataUrl } = {})
       } else if (endpoint === WECOM_ENDPOINTS.bindCredentials) {
         value = await publicStatus(await controller.bindCredentials(payload), cachedEncode);
       } else if (endpoint === WECOM_ENDPOINTS.reconnectBot) {
-        value = await publicStatus(await controller.reconnectBot(payload.botId), cachedEncode);
+        const snapshot = await controller.reconnectBot(payload.botId);
+        if (signal?.aborted) {
+          return { ok: false, error: { code: 'cancelled', message: 'The request was cancelled.' } };
+        }
+        let testMessage;
+        if (payload.sendTest === true) {
+          const connected = snapshot?.bots?.some(
+            (bot) => bot?.botId === payload.botId && bot?.connected === true,
+          );
+          if (!connected || typeof controller.sendConnectionTest !== 'function') {
+            testMessage = publicConnectionTestResult(
+              connectionTestTargetUnavailable('企业微信机器人'),
+            );
+          } else {
+            try {
+              await controller.sendConnectionTest(payload.botId);
+              testMessage = publicConnectionTestResult();
+            } catch (error) {
+              testMessage = publicConnectionTestResult(error);
+            }
+          }
+        }
+        value = await publicStatus({ ...snapshot, ...(testMessage ? { testMessage } : {}) }, cachedEncode);
       } else if (endpoint === WECOM_ENDPOINTS.setWorkspace) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await publicStatus(

package/plugin-src/host/channels/weixin/production.mjs

@@ -16,6 +16,7 @@ import {
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
+import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
 
 function harnessOrigin(webServer, configured) {
   if (configured !== undefined) return new URL(configured);
@@ -75,13 +76,19 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const { controlExecutor, sessionMaintenanceExecutor } = createHarnessSessionExecutors(ctx, {
+    controlExecutor: internals.controlExecutor,
+    sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
+  });
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
-    agentPreset: config.agentPreset ?? 'standard',
+    ...(config.agentPreset == null ? {} : { agentPreset: config.agentPreset }),
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
     ...(commandExecutor ? { commandExecutor } : {}),
+    ...(controlExecutor ? { controlExecutor } : {}),
+    ...(sessionMaintenanceExecutor ? { sessionMaintenanceExecutor } : {}),
   });
   const coreController = new Controller({
     api,

package/plugin-src/host/channels/weixin/rpc.mjs

@@ -5,6 +5,10 @@ import {
   SET_WORKSPACE_ENDPOINT,
   validWorkspacePayload,
 } from '../shared/workspace-rpc.mjs';
+import {
+  connectionTestTargetUnavailable,
+  publicConnectionTestResult,
+} from '../../../../src/channels/shared/connection-test.mjs';
 
 export const WEIXIN_RPC_CHANNEL = '/weixin';
 export const WEIXIN_ENDPOINTS = Object.freeze({
@@ -55,9 +59,11 @@ function payloadFailure(endpoint, payload) {
       : 'provision.verify requires an attemptId and a 4-to-8-digit code.';
   }
   if (endpoint === WEIXIN_ENDPOINTS.reconnectBot) {
-    return exactKeys(payload, ['botId']) && validId(payload.botId)
+    return exactKeys(payload, ['botId', 'sendTest'])
+      && validId(payload.botId)
+      && (payload.sendTest === undefined || payload.sendTest === true)
       ? null
-      : 'bot.reconnect requires a botId.';
+      : 'bot.reconnect requires a botId and optional sendTest=true.';
   }
   if (endpoint === WEIXIN_ENDPOINTS.deleteBot) {
     return exactKeys(payload, ['botId', 'confirm']) && validId(payload.botId) && payload.confirm === true
@@ -165,7 +171,27 @@ export function createWeixinRpcHandler(controller, { encodeQr = qrDataUrl } = {}
         value = await controller.cancelProvisioning(payload.attemptId);
         if (!value) return badRequest('The provisioning attempt no longer exists.');
       } else if (endpoint === WEIXIN_ENDPOINTS.reconnectBot) {
-        value = await publicStatus(await controller.reconnectBot(payload.botId), cachedEncode);
+        const snapshot = await controller.reconnectBot(payload.botId);
+        if (signal?.aborted) return cancelled();
+        let testMessage;
+        if (payload.sendTest === true) {
+          const connected = snapshot?.bots?.some(
+            (bot) => bot?.botId === payload.botId && bot?.connected === true,
+          );
+          if (!connected || typeof controller.sendConnectionTest !== 'function') {
+            testMessage = publicConnectionTestResult(
+              connectionTestTargetUnavailable('微信机器人'),
+            );
+          } else {
+            try {
+              await controller.sendConnectionTest(payload.botId);
+              testMessage = publicConnectionTestResult();
+            } catch (error) {
+              testMessage = publicConnectionTestResult(error);
+            }
+          }
+        }
+        value = await publicStatus({ ...snapshot, ...(testMessage ? { testMessage } : {}) }, cachedEncode);
       } else if (endpoint === WEIXIN_ENDPOINTS.setWorkspace) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await publicStatus(

package/plugin-src/host/channels/whatsapp/production.mjs

@@ -16,6 +16,7 @@ import {
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createTokenConnectionSupervisor } from '../shared/connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
+import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
 
 const AUTH_DIRECTORY_PATTERN = /^[a-f0-9-]{36}$/;
 
@@ -78,13 +79,19 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const { controlExecutor, sessionMaintenanceExecutor } = createHarnessSessionExecutors(ctx, {
+    controlExecutor: internals.controlExecutor,
+    sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
+  });
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
-    agentPreset: config.agentPreset ?? 'standard',
+    ...(config.agentPreset == null ? {} : { agentPreset: config.agentPreset }),
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
     ...(commandExecutor ? { commandExecutor } : {}),
+    ...(controlExecutor ? { controlExecutor } : {}),
+    ...(sessionMaintenanceExecutor ? { sessionMaintenanceExecutor } : {}),
   });
   const coreController = new Controller({
     configStore: observedConfigStore,

package/plugin-src/host/channels/whatsapp/rpc.mjs

@@ -1,5 +1,6 @@
 import QRCode from 'qrcode';
 
+import { publicConnectionTestResult } from '../../../../src/channels/shared/connection-test.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 
@@ -39,8 +40,9 @@ function payloadFailure(endpoint, payload) {
       ? null : `${endpoint} requires an attemptId.`;
   }
   if (endpoint === WHATSAPP_ENDPOINTS.reconnectBot) {
-    return exactKeys(payload, ['botId']) && validId(payload.botId)
-      ? null : 'bot.reconnect requires a botId.';
+    return exactKeys(payload, ['botId', 'sendTest']) && validId(payload.botId)
+      && (payload.sendTest === undefined || typeof payload.sendTest === 'boolean')
+      ? null : 'bot.reconnect requires a botId and optional sendTest flag.';
   }
   if (endpoint === WHATSAPP_ENDPOINTS.deleteBot) {
     return exactKeys(payload, ['botId', 'confirm']) && validId(payload.botId)
@@ -119,7 +121,33 @@ export function createWhatsappRpcHandler(controller, { encodeQr = qrDataUrl } =
       } else if (endpoint === WHATSAPP_ENDPOINTS.cancelProvisioning) {
         value = sanitizePublic(await controller.cancelProvisioning(payload.attemptId));
       } else if (endpoint === WHATSAPP_ENDPOINTS.reconnectBot) {
-        value = await publicStatus(await controller.reconnectBot(payload.botId), cachedEncode);
+        const checked = await controller.reconnectBot(payload.botId);
+        if (signal?.aborted) {
+          return { ok: false, error: { code: 'cancelled', message: 'The request was cancelled.' } };
+        }
+        value = await publicStatus(checked, cachedEncode);
+        if (payload.sendTest === true) {
+          let testError = null;
+          const connected = checked?.bots?.some(
+            (bot) => bot?.botId === payload.botId && bot.connected === true,
+          ) === true;
+          if (!connected) {
+            testError = new Error('WhatsApp bot is not connected');
+            testError.code = 'test-target-unavailable';
+          } else {
+            try {
+              if (typeof controller.sendConnectionTest !== 'function') {
+                const unavailable = new Error('Connection test is unavailable');
+                unavailable.code = 'test-target-unavailable';
+                throw unavailable;
+              }
+              await controller.sendConnectionTest(payload.botId);
+            } catch (error) {
+              testError = error;
+            }
+          }
+          value = { ...value, testMessage: publicConnectionTestResult(testError) };
+        }
       } else if (endpoint === WHATSAPP_ENDPOINTS.setWorkspace) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await publicStatus(

package/plugin-src/host/harness-session-coordinator.mjs

@@ -0,0 +1,134 @@
+import { randomUUID } from 'node:crypto';
+
+function agentsFromContext(ctx) {
+  if (typeof ctx?.get !== 'function') return undefined;
+  let agents;
+  try {
+    agents = ctx.get('agents');
+  } catch {
+    return undefined;
+  }
+  if (agents === undefined || agents === null) return undefined;
+  if (typeof agents.get !== 'function') {
+    throw new TypeError('dsh-im requires a callable AgentRegistry when ctx.get("agents") is present');
+  }
+  return agents;
+}
+
+function currentOwnedTurn(agent, expectedTurn, promptRpcId) {
+  if (agent?.status !== 'running') return false;
+  const events = agent?.session?.events;
+  if (!Array.isArray(events)) return false;
+
+  let openTurn = null;
+  let owned = false;
+  for (const event of events) {
+    if (event?.type === 'turn/start') {
+      openTurn = event.data?.turn ?? null;
+      owned = false;
+      continue;
+    }
+    if (event?.type === 'turn/end' && event.data?.turn === openTurn) {
+      openTurn = null;
+      owned = false;
+      continue;
+    }
+    if (openTurn === expectedTurn
+      && event?.type === 'user/message'
+      && event.data?.source?.rpcId === promptRpcId) {
+      owned = true;
+    }
+  }
+  return openTurn === expectedTurn && owned;
+}
+
+function deepFreeze(value) {
+  if (!value || typeof value !== 'object' || Object.isFrozen(value)) return value;
+  for (const child of Object.values(value)) deepFreeze(child);
+  return Object.freeze(value);
+}
+
+function steeringMessage(text) {
+  return deepFreeze({
+    id: randomUUID(),
+    role: 'user',
+    content: [{ type: 'text', text }],
+    source: { kind: 'user' },
+  });
+}
+
+function agentBusyError(cause) {
+  const error = new Error('Session is busy with an active turn or maintenance task', { cause });
+  error.code = 'agent-busy';
+  return error;
+}
+
+function createControlExecutor(agents) {
+  return ({ sessionId, expectedTurn, promptRpcId, action, text }) => {
+    const agent = agents.get(sessionId);
+    // An unattached Session cannot be coordinated in-process. Let the client
+    // retain its legacy HTTP path for deployments where attachment is lazy.
+    if (!agent) return undefined;
+    if (!currentOwnedTurn(agent, expectedTurn, promptRpcId)) return false;
+
+    if (action === 'stop') {
+      agent.cancel({ kind: 'user' }, { keepInbox: true });
+      return true;
+    }
+    if (action === 'steer') {
+      if (typeof text !== 'string' || !text.trim()) return false;
+      // inject() never wakes an idle driver. Because validation and injection
+      // share one JS tick, this context can only target this live turn's next step.
+      agent.inject(steeringMessage(text));
+      return true;
+    }
+    throw new TypeError(`Unsupported Harness control action: ${String(action)}`);
+  };
+}
+
+function createSessionMaintenanceExecutor(agents) {
+  return ({ sessionId, operation }) => {
+    if (typeof operation !== 'function') throw new TypeError('maintenance operation is required');
+    const agent = agents.get(sessionId);
+    if (!agent) return operation();
+    try {
+      // runMaintenance claims the true-idle phase synchronously. A prompt or a
+      // second maintenance operation therefore cannot interleave with the RPC.
+      return agent.runMaintenance((signal) => {
+        if (agents.get(sessionId) !== agent) {
+          const error = new Error('Session agent changed before maintenance started');
+          error.code = 'agent-unavailable';
+          throw error;
+        }
+        return operation(signal);
+      });
+    } catch (error) {
+      throw agentBusyError(error);
+    }
+  };
+}
+
+/**
+ * Build optional same-process Session executors without adding a hard Cordis
+ * service injection. Fixtures and deployments without AgentRegistry preserve
+ * the existing HTTP behavior.
+ */
+export function createHarnessSessionExecutors(ctx, provided = {}) {
+  const { controlExecutor, sessionMaintenanceExecutor } = provided;
+  if (controlExecutor !== undefined && typeof controlExecutor !== 'function') {
+    throw new TypeError('controlExecutor must be a function');
+  }
+  if (sessionMaintenanceExecutor !== undefined
+    && typeof sessionMaintenanceExecutor !== 'function') {
+    throw new TypeError('sessionMaintenanceExecutor must be a function');
+  }
+
+  const agents = controlExecutor && sessionMaintenanceExecutor
+    ? undefined
+    : agentsFromContext(ctx);
+  return {
+    controlExecutor: controlExecutor ?? (agents ? createControlExecutor(agents) : undefined),
+    sessionMaintenanceExecutor: sessionMaintenanceExecutor
+      ?? (agents ? createSessionMaintenanceExecutor(agents) : undefined),
+  };
+}

package/src/channels/dingtalk/dingtalk-bridge.mjs

@@ -10,6 +10,14 @@ import {
 } from '../shared/harness-question.mjs';
 import { HarnessApprovalQueue } from '../shared/harness-approval.mjs';
 import { runCompactCommand } from '../shared/compact-command.mjs';
+import {
+  isControlCommand,
+  runControlCommand,
+} from '../shared/control-command.mjs';
+import {
+  isModelCommand,
+  runModelCommand,
+} from '../shared/model-command.mjs';
 import { runWorkspaceCommand } from '../shared/workspace-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
 import {
@@ -17,6 +25,7 @@ import {
   imagePromptUserMessage,
   promptContentForMessage,
 } from '../shared/image-prompt.mjs';
+import { rememberConnectionTestTarget } from '../shared/connection-test.mjs';
 
 const CARD_INITIAL_TEXT = '已连接 DeepSeek Harness，正在思考…';
 const CARD_ERROR_TEXT = '消息处理失败，请稍后重试。';
@@ -32,6 +41,10 @@ const HELP_TEXT = [
   '/workspacelist  列出工作区绝对路径',
   '/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题',
   '/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话',
+  '/models  列出所有可用模型',
+  '/model [模型ID]  查看或切换当前会话模型',
+  '/stop  停止当前任务',
+  '/steer 补充指令  纠偏当前任务',
   '/status  检查连接状态',
   '/help  显示本帮助',
 ].join('\n');
@@ -245,6 +258,7 @@ export class DingtalkHarnessBridge {
   #pendingInteractions = new Map();
   #interactionKeys = new Map();
   #interactionTasks = new Set();
+  #commandTasks = new Set();
   #acceptedMessageIds = new Set();
   #approvals;
 
@@ -309,7 +323,41 @@ export class DingtalkHarnessBridge {
     } catch {
       // An unsafe reply route must never be able to submit an approval.
     }
+    if (sessionWebhook && String(message.conversationType) !== '2') {
+      rememberConnectionTestTarget(this.#state, { sessionWebhook });
+    }
     const pending = this.#pendingInteractions.get(key);
+    const promptMessage = dingtalkInboundMessage(message, {
+      api: this.#api,
+      clientId: this.#clientId,
+      clientSecret: this.#clientSecret,
+    });
+    const commandText = nonEmptyString(promptMessage.content) ?? '';
+    const commandRunner = isControlCommand(commandText)
+      ? runControlCommand
+      : (isModelCommand(commandText) ? runModelCommand : null);
+    const addressed = String(message.conversationType) !== '2' || message?.isInAtList === true;
+    if (commandRunner && sessionWebhook && addressed) {
+      let task;
+      task = this.#processFastCommand(
+        message,
+        messageId,
+        key,
+        sessionWebhook,
+        promptMessage,
+        commandRunner,
+      ).catch((error) => {
+        if (error?.code === 'turn-stopped' || this.#signal?.aborted) return;
+        this.#status.lastError = '钉钉命令处理失败。';
+        this.#logger.error?.('[dsh-dingtalk] failed to process a command', safeErrorDiagnostic(error));
+        return this.#send(sessionWebhook, CARD_ERROR_TEXT).catch(() => undefined);
+      }).finally(() => {
+        this.#acceptedMessageIds.delete(messageId);
+        this.#commandTasks.delete(task);
+      });
+      this.#commandTasks.add(task);
+      return task;
+    }
     const approvalReply = this.#approvals.claimReply({
       key,
       actor: sender,
@@ -408,9 +456,41 @@ export class DingtalkHarnessBridge {
         pending.queue ? [pending.queue] : []
       )),
       ...this.#interactionTasks,
+      ...this.#commandTasks,
     ]);
   }
 
+  async #processFastCommand(message, messageId, key, sessionWebhook, prompt, runner) {
+    this.#signal?.throwIfAborted();
+    if (this.#state.hasSeen(messageId)) return;
+    await this.#state.markSeen(messageId);
+    increment(this.#status, 'messagesReceived');
+    this.#status.lastMessageAt = new Date().toISOString();
+    const result = await runner(
+      nonEmptyString(prompt.content) ?? '',
+      this.#harness,
+      this.#state,
+      key,
+      {
+        signal: this.#signal,
+        hasImages: hasInboundImages(prompt),
+        pendingInteraction: this.#pendingInteractions.has(key)
+          || this.#approvals.hasPending(key),
+        control: { owner: this, key },
+      },
+    );
+    if (result?.stopped) {
+      await Promise.allSettled([
+        this.#cancelPendingInteraction(key),
+        this.#approvals.closeRoute(key),
+      ]);
+    }
+    for (const reply of result?.messages ?? [result?.message]) {
+      if (reply) await this.#send(sessionWebhook, reply);
+    }
+    this.#status.lastError = null;
+  }
+
   async #process(message, messageId, sender, key, { alreadyRecorded = false } = {}) {
     this.#signal?.throwIfAborted();
     if (!alreadyRecorded) {
@@ -515,6 +595,7 @@ export class DingtalkHarnessBridge {
         askOptions: {
           timeoutMs: this.#replyTimeoutMs,
           signal: this.#signal,
+          control: { owner: this, key },
           onUpdate: cardStarted
             ? (update) => cardStream.push(progressText(update))
             : undefined,
@@ -533,6 +614,10 @@ export class DingtalkHarnessBridge {
       this.#status.lastReplyAt = new Date().toISOString();
       this.#status.lastError = null;
     } catch (error) {
+      if (error?.code === 'turn-stopped') {
+        if (cardStarted) await cardStream.finish('已停止。').catch(() => undefined);
+        return;
+      }
       if (this.#signal?.aborted) return;
       this.#status.lastError = '钉钉消息处理失败。';
       this.#logger.error?.(