@xmanrui/dsh-im 4.9.1 → 4.11.0

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

@@ -13,12 +13,17 @@ import {
   observeBotWorkspaceRemovals,
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { listAgentPresetCatalog } from '../../../../src/channels/shared/agent-preset.mjs';
+import { listModelCatalog } from '../../../../src/channels/shared/model-setting.mjs';
 import { createDeliveryAdapter } from '../../delivery-adapter.mjs';
 import { createTokenConnectionSupervisor } from '../shared/connection-supervisor.mjs';
 import { pluginPaths } from '../shared/production.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
@@ -63,10 +68,18 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new ResolvedHarness({
     ...connection,
@@ -78,6 +91,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     ...(sessionMaintenanceExecutor ? { sessionMaintenanceExecutor } : {}),
     ...(fileIngressExecutor ? { fileIngressExecutor } : {}),
   });
+  const modelCatalog = () => listModelCatalog(harness);
   const coreController = new ResolvedController({
     credentials: ctx.credentials,
     configStore: observedConfigStore,
@@ -130,6 +144,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     workspaces,
     stateFor,
     agentPresetCatalog,
+    modelCatalog,
   });
   const supervisor = createSupervisor({
     channel: 'slack',

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

@@ -11,6 +11,7 @@ import {
   SET_AGENT_PRESET_ENDPOINT,
   validAgentPresetPayload,
 } from '../shared/agent-preset-rpc.mjs';
+import { SET_MODEL_ENDPOINT, validModelPayload } from '../shared/model-setting-rpc.mjs';
 
 export const SLACK_RPC_CHANNEL = '/slack';
 export const SLACK_ENDPOINTS = Object.freeze({
@@ -19,6 +20,7 @@ export const SLACK_ENDPOINTS = Object.freeze({
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
+  setModel: SET_MODEL_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
   setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
   setAccessPolicy: SET_ACCESS_POLICY_ENDPOINT,
@@ -75,6 +77,9 @@ function payloadFailure(endpoint, payload) {
     return validWorkspacePayload(payload)
       ? null : '请输入工作区绝对路径。';
   }
+  if (endpoint === SLACK_ENDPOINTS.setModel) {
+    return validModelPayload(payload) ? null : '请选择有效模型。';
+  }
   if (endpoint === SLACK_ENDPOINTS.setAgentPreset) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
@@ -166,6 +171,10 @@ export function createSlackRpcHandler(controller) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await controller.updateWorkspace(payload.botId, payload.workspace);
       }
+      else if (endpoint === SLACK_ENDPOINTS.setModel) {
+        if (typeof controller.updateModel !== 'function') throw new Error('Model update is unavailable');
+        value = await controller.updateModel(payload.botId, payload.model);
+      }
       else if (endpoint === SLACK_ENDPOINTS.setContextEnhancement) {
         if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
         value = await controller.updateContextEnhancement(payload.botId, payload.config);

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

@@ -15,11 +15,16 @@ import {
   observeBotWorkspaceRemovals,
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { listAgentPresetCatalog } from '../../../../src/channels/shared/agent-preset.mjs';
+import { listModelCatalog } from '../../../../src/channels/shared/model-setting.mjs';
 import { createDeliveryAdapter } from '../../delivery-adapter.mjs';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
@@ -78,10 +83,18 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new Harness({
     ...connection,
@@ -93,6 +106,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     ...(sessionMaintenanceExecutor ? { sessionMaintenanceExecutor } : {}),
     ...(fileIngressExecutor ? { fileIngressExecutor } : {}),
   });
+  const modelCatalog = () => listModelCatalog(harness);
   const coreController = new Controller({
     qrAuth,
     credentials: ctx.credentials,
@@ -145,6 +159,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     workspaces,
     stateFor,
     agentPresetCatalog,
+    modelCatalog,
   });
   const supervisor = createSupervisor({
     controller,

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

@@ -4,6 +4,7 @@ import { SET_ACCESS_POLICY_ENDPOINT, validAccessPolicyPayload } from '../shared/
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 import { SET_AGENT_PRESET_ENDPOINT, validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
+import { SET_MODEL_ENDPOINT, validModelPayload } from '../shared/model-setting-rpc.mjs';
 import {
   connectionTestTargetUnavailable,
   publicConnectionTestResult,
@@ -19,6 +20,7 @@ export const WECOM_ENDPOINTS = Object.freeze({
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
+  setModel: SET_MODEL_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
   setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
   setAccessPolicy: SET_ACCESS_POLICY_ENDPOINT,
@@ -76,6 +78,9 @@ function payloadFailure(endpoint, payload) {
     return validWorkspacePayload(payload)
       ? null : '请输入工作区绝对路径。';
   }
+  if (endpoint === WECOM_ENDPOINTS.setModel) {
+    return validModelPayload(payload) ? null : '请选择有效模型。';
+  }
   if (endpoint === WECOM_ENDPOINTS.setAgentPreset) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
@@ -184,6 +189,12 @@ export function createWecomRpcHandler(controller, { encodeQr = qrDataUrl } = {})
           await controller.updateWorkspace(payload.botId, payload.workspace),
           cachedEncode,
         );
+      } else if (endpoint === WECOM_ENDPOINTS.setModel) {
+        if (typeof controller.updateModel !== 'function') throw new Error('Model update is unavailable');
+        value = await publicStatus(
+          await controller.updateModel(payload.botId, payload.model),
+          cachedEncode,
+        );
       } else if (endpoint === WECOM_ENDPOINTS.setContextEnhancement) {
         if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
         value = await controller.updateContextEnhancement(

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

@@ -18,11 +18,16 @@ import {
   observeBotWorkspaceRemovals,
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { listAgentPresetCatalog } from '../../../../src/channels/shared/agent-preset.mjs';
+import { listModelCatalog } from '../../../../src/channels/shared/model-setting.mjs';
 import { createDeliveryAdapter } from '../../delivery-adapter.mjs';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
@@ -81,10 +86,18 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new Harness({
     ...connection,
@@ -96,6 +109,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     ...(sessionMaintenanceExecutor ? { sessionMaintenanceExecutor } : {}),
     ...(fileIngressExecutor ? { fileIngressExecutor } : {}),
   });
+  const modelCatalog = () => listModelCatalog(harness);
   const coreController = new Controller({
     api,
     credentials: ctx.credentials,
@@ -148,6 +162,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     workspaces,
     stateFor,
     agentPresetCatalog,
+    modelCatalog,
   });
   const supervisor = createSupervisor({
     controller,

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

@@ -11,6 +11,7 @@ import {
   SET_AGENT_PRESET_ENDPOINT,
   validAgentPresetPayload,
 } from '../shared/agent-preset-rpc.mjs';
+import { SET_MODEL_ENDPOINT, validModelPayload } from '../shared/model-setting-rpc.mjs';
 import {
   connectionTestTargetUnavailable,
   publicConnectionTestResult,
@@ -26,6 +27,7 @@ export const WEIXIN_ENDPOINTS = Object.freeze({
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
+  setModel: SET_MODEL_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
   setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
   setAccessPolicy: SET_ACCESS_POLICY_ENDPOINT,
@@ -83,6 +85,9 @@ function payloadFailure(endpoint, payload) {
     return validWorkspacePayload(payload)
       ? null : '请输入工作区绝对路径。';
   }
+  if (endpoint === WEIXIN_ENDPOINTS.setModel) {
+    return validModelPayload(payload) ? null : '请选择有效模型。';
+  }
   if (endpoint === WEIXIN_ENDPOINTS.setAgentPreset) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
@@ -219,6 +224,12 @@ export function createWeixinRpcHandler(controller, { encodeQr = qrDataUrl } = {}
           await controller.updateWorkspace(payload.botId, payload.workspace),
           cachedEncode,
         );
+      } else if (endpoint === WEIXIN_ENDPOINTS.setModel) {
+        if (typeof controller.updateModel !== 'function') throw new Error('Model update is unavailable');
+        value = await publicStatus(
+          await controller.updateModel(payload.botId, payload.model),
+          cachedEncode,
+        );
       } else if (endpoint === WEIXIN_ENDPOINTS.setContextEnhancement) {
         if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
         value = await controller.updateContextEnhancement(

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

@@ -18,11 +18,16 @@ import {
   observeBotWorkspaceRemovals,
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { listAgentPresetCatalog } from '../../../../src/channels/shared/agent-preset.mjs';
+import { listModelCatalog } from '../../../../src/channels/shared/model-setting.mjs';
 import { createDeliveryAdapter } from '../../delivery-adapter.mjs';
 import { createTokenConnectionSupervisor } from '../shared/connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
@@ -84,10 +89,18 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new Harness({
     ...connection,
@@ -99,6 +112,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     ...(sessionMaintenanceExecutor ? { sessionMaintenanceExecutor } : {}),
     ...(fileIngressExecutor ? { fileIngressExecutor } : {}),
   });
+  const modelCatalog = () => listModelCatalog(harness);
   const coreController = new Controller({
     configStore: observedConfigStore,
     authPath: paths.authPath,
@@ -155,6 +169,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     workspaces,
     stateFor,
     agentPresetCatalog,
+    modelCatalog,
   });
   const supervisor = createSupervisor({
     channel: 'whatsapp',

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

@@ -6,6 +6,7 @@ import { SET_CONTEXT_ENHANCEMENT_ENDPOINT, validContextEnhancementPayload } from
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 import { SET_AGENT_PRESET_ENDPOINT, validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
+import { SET_MODEL_ENDPOINT, validModelPayload } from '../shared/model-setting-rpc.mjs';
 
 export const WHATSAPP_RPC_CHANNEL = '/whatsapp';
 export const WHATSAPP_ENDPOINTS = Object.freeze({
@@ -17,6 +18,7 @@ export const WHATSAPP_ENDPOINTS = Object.freeze({
   deleteBot: 'bot.delete',
   setAccessPolicy: SET_ACCESS_POLICY_ENDPOINT,
   setWorkspace: SET_WORKSPACE_ENDPOINT,
+  setModel: SET_MODEL_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
   setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
 });
@@ -62,6 +64,9 @@ function payloadFailure(endpoint, payload) {
     return validWorkspacePayload(payload)
       ? null : '请输入工作区绝对路径。';
   }
+  if (endpoint === WHATSAPP_ENDPOINTS.setModel) {
+    return validModelPayload(payload) ? null : '请选择有效模型。';
+  }
   if (endpoint === WHATSAPP_ENDPOINTS.setAgentPreset) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
@@ -172,6 +177,12 @@ export function createWhatsappRpcHandler(controller, { encodeQr = qrDataUrl } =
           await controller.updateWorkspace(payload.botId, payload.workspace),
           cachedEncode,
         );
+      } else if (endpoint === WHATSAPP_ENDPOINTS.setModel) {
+        if (typeof controller.updateModel !== 'function') throw new Error('Model update is unavailable');
+        value = await publicStatus(
+          await controller.updateModel(payload.botId, payload.model),
+          cachedEncode,
+        );
       } else if (endpoint === WHATSAPP_ENDPOINTS.setContextEnhancement) {
         if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
         value = await controller.updateContextEnhancement(

package/plugin-src/host/delivery-adapter.mjs

@@ -1,4 +1,8 @@
-import { deliverySuggestionsFromSessions } from './delivery-suggestions.mjs';
+import {
+  deliverySuggestionsFromSessions,
+  privateConversationKeyMatchesTarget,
+  resolvePrivateConversationKey,
+} from './delivery-suggestions.mjs';
 
 const CHANNELS = new Set([
   'weixin',
@@ -22,6 +26,12 @@ function invalidTarget(message) {
   return error;
 }
 
+function sessionSyncUnavailable(message = 'Session sync is unavailable for this target') {
+  const error = new Error(message);
+  error.code = 'session-sync-unavailable';
+  return error;
+}
+
 function isRecord(value) {
   return value !== null && typeof value === 'object' && !Array.isArray(value);
 }
@@ -129,6 +139,49 @@ export function normalizeDeliveryTarget(channel, value, { targetIdRequired = tru
   return normalized;
 }
 
+function targetWithoutSessionSync(target) {
+  return {
+    targetId: target.targetId,
+    ...(target.name === undefined ? {} : { name: target.name }),
+    kind: target.kind,
+    route: target.route,
+  };
+}
+
+function sessionSyncConfigs(workspaces, botId) {
+  if (typeof workspaces.listSessionSyncTargets !== 'function') return [];
+  const targets = workspaces.listSessionSyncTargets();
+  return botId === undefined ? targets : targets.filter((target) => target.botId === botId);
+}
+
+function stateSessions(state) {
+  if (!state || typeof state.snapshot !== 'function') return null;
+  const sessions = state.snapshot()?.sessions;
+  return sessions && typeof sessions === 'object' && !Array.isArray(sessions) ? sessions : null;
+}
+
+function sessionSyncView(channel, target, sessions, configured) {
+  if (configured) {
+    const valid = privateConversationKeyMatchesTarget(
+      channel,
+      configured.conversationKey,
+      target,
+    );
+    if (!valid || !sessions) return { enabled: true, state: 'unavailable' };
+    return {
+      enabled: true,
+      state: typeof sessions[configured.conversationKey] === 'string'
+        && Boolean(sessions[configured.conversationKey])
+        ? 'active'
+        : 'waiting',
+    };
+  }
+  const conversationKey = sessions
+    ? resolvePrivateConversationKey(channel, sessions, target)
+    : null;
+  return { enabled: false, state: conversationKey ? 'off' : 'unavailable' };
+}
+
 /** Bind one channel's existing workspace store and unwrapped controller to DeliveryService. */
 export function createDeliveryAdapter({ channel, workspaces, coreController, stateFor }) {
   if (!supportsDeliveryChannel(channel)) throw new TypeError(`Unsupported delivery channel: ${channel}`);
@@ -144,7 +197,23 @@ export function createDeliveryAdapter({ channel, workspaces, coreController, sta
   return Object.freeze({
     channel,
     ownsBot: (botId) => workspaces.has(botId),
-    listTargets: (botId) => workspaces.listDeliveryTargets(botId),
+    listBots: () => workspaces.listBotIds(),
+    async listTargets(botId) {
+      const targets = workspaces.listDeliveryTargets(botId);
+      const configured = new Map(
+        sessionSyncConfigs(workspaces, botId).map((target) => [target.targetId, target]),
+      );
+      let sessions = null;
+      try {
+        sessions = stateSessions(await stateFor(botId));
+      } catch {
+        // Target CRUD remains usable when its persisted conversation state cannot be read.
+      }
+      return targets.map((target) => ({
+        ...target,
+        sessionSync: sessionSyncView(channel, target, sessions, configured.get(target.targetId)),
+      }));
+    },
     async listSuggestions(botId) {
       const state = await stateFor(botId);
       if (!state || typeof state.snapshot !== 'function') {
@@ -168,12 +237,82 @@ export function createDeliveryAdapter({ channel, workspaces, coreController, sta
     ),
     deleteTarget: (botId, targetId) => workspaces.deleteDeliveryTarget(botId, targetId),
     async sendText(botId, target, text, options = {}) {
-      const normalized = normalizeDeliveryTarget(channel, target);
+      const normalized = normalizeDeliveryTarget(channel, targetWithoutSessionSync(target));
       if (typeof coreController.sendProactiveText !== 'function') {
         throw new TypeError('delivery controller cannot send proactive text');
       }
       await coreController.sendProactiveText(botId, normalized, text, options);
       return { sent: true };
     },
+    async setSessionSync(botId, targetId, enabled) {
+      if (typeof workspaces.setDeliveryTargetSessionSync !== 'function') {
+        throw sessionSyncUnavailable();
+      }
+      const target = workspaces.deliveryTargetFor(botId, targetId);
+      if (!target) {
+        const error = new Error('Unknown target');
+        error.code = 'unknown-target';
+        throw error;
+      }
+      if (!enabled) {
+        await workspaces.setDeliveryTargetSessionSync(botId, targetId, null);
+        let sessions = null;
+        try {
+          sessions = stateSessions(await stateFor(botId));
+        } catch {
+          // The setting is already safely disabled; only its availability is unknown.
+        }
+        return sessionSyncView(channel, target, sessions, null);
+      }
+      const sessions = stateSessions(await stateFor(botId));
+      const conversationKey = resolvePrivateConversationKey(channel, sessions, target);
+      if (!conversationKey) throw sessionSyncUnavailable();
+      await workspaces.setDeliveryTargetSessionSync(botId, targetId, conversationKey);
+      return { enabled: true, state: 'active' };
+    },
+    async listSessionSyncTargets(sessionId) {
+      if (typeof sessionId !== 'string' || !sessionId) {
+        throw new TypeError('sessionId is required');
+      }
+      const matches = [];
+      for (const configured of sessionSyncConfigs(workspaces)) {
+        const target = workspaces.deliveryTargetFor(configured.botId, configured.targetId);
+        if (!target || !privateConversationKeyMatchesTarget(
+          channel,
+          configured.conversationKey,
+          target,
+        )) continue;
+        let sessions;
+        try {
+          sessions = stateSessions(await stateFor(configured.botId));
+        } catch {
+          continue;
+        }
+        if (sessions?.[configured.conversationKey] === sessionId) {
+          matches.push({ botId: configured.botId, targetId: configured.targetId });
+        }
+      }
+      return matches;
+    },
+    async sendSessionSyncText(botId, targetId, sessionId, text, options = {}) {
+      if (typeof text !== 'string' || !text.trim()) throw new TypeError('text is required');
+      const configured = sessionSyncConfigs(workspaces, botId)
+        .find((target) => target.targetId === targetId);
+      const target = workspaces.deliveryTargetFor(botId, targetId);
+      if (!configured || !target || !privateConversationKeyMatchesTarget(
+        channel,
+        configured.conversationKey,
+        target,
+      )) throw sessionSyncUnavailable('Session sync target is no longer enabled');
+      const sessions = stateSessions(await stateFor(botId));
+      if (sessions?.[configured.conversationKey] !== sessionId) {
+        throw sessionSyncUnavailable('Session sync target is no longer bound to this Session');
+      }
+      if (typeof coreController.sendProactiveText !== 'function') {
+        throw new TypeError('delivery controller cannot send proactive text');
+      }
+      await coreController.sendProactiveText(botId, target, text, options);
+      return { sent: true };
+    },
   });
 }

package/plugin-src/host/delivery-rpc.mjs

@@ -9,6 +9,7 @@ export const DELIVERY_ENDPOINTS = Object.freeze({
   createTarget: 'target.create',
   updateTarget: 'target.update',
   deleteTarget: 'target.delete',
+  setSessionSync: 'target.session-sync.set',
   testTarget: 'target.test',
 });
 
@@ -22,6 +23,7 @@ const PUBLIC_ERRORS = new Set([
   'bot-not-connected',
   'target-rejected',
   'delivery-failed',
+  'session-sync-unavailable',
   'cancelled',
 ]);
 
@@ -85,6 +87,11 @@ function validPayload(endpoint, payload) {
       || (exactKeys(payload, ['botId', 'target'])
         && validBotId(payload.botId) && validDraftTarget(payload.target));
   }
+  if (endpoint === DELIVERY_ENDPOINTS.setSessionSync) {
+    return exactKeys(payload, ['botId', 'targetId', 'enabled'])
+      && validBotId(payload.botId) && validTargetId(payload.targetId)
+      && typeof payload.enabled === 'boolean';
+  }
   return exactKeys(payload, ['botId', 'targetId'])
     && validBotId(payload.botId) && validTargetId(payload.targetId);
 }
@@ -131,6 +138,11 @@ export function createDeliveryRpcHandler(service) {
         value = await service.updateTarget(payload.botId, payload.targetId, payload.target);
       } else if (endpoint === DELIVERY_ENDPOINTS.deleteTarget) {
         value = await service.deleteTarget(payload.botId, payload.targetId);
+      } else if (endpoint === DELIVERY_ENDPOINTS.setSessionSync) {
+        if (typeof service.setSessionSync !== 'function') {
+          throw new TypeError('Session sync is unavailable');
+        }
+        value = await service.setSessionSync(payload.botId, payload.targetId, payload.enabled);
       } else {
         value = await service.send(
           payload.botId,