@zhin.js/service-activity-feedback 1.0.0

package/lib/policy.js

@@ -0,0 +1,24 @@
+import { resolveActivityFeedbackPhaseConfig, } from '@zhin.js/agent';
+import { mergeActivityFeedbackLayers, } from './config.js';
+export { loadActivityFeedbackServiceConfig, resolveActivityFeedbackForTarget } from './config.js';
+export class ActivityFeedbackPolicy {
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    resolvePhase(platform, endpointId, phase, sceneType) {
+        if (this.service.enabled === false) {
+            return { kind: 'disabled' };
+        }
+        const policy = mergeActivityFeedbackLayers(this.service.defaults, this.service.platforms?.[platform], this.service.endpoints?.[`${platform}:${endpointId}`]);
+        if (policy?.enabled === false) {
+            return { kind: 'disabled' };
+        }
+        const config = resolveActivityFeedbackPhaseConfig(platform, policy, phase, sceneType);
+        if (config.type === 'none') {
+            return { kind: 'none' };
+        }
+        return { kind: 'active', config };
+    }
+}
+//# sourceMappingURL=policy.js.map

package/lib/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,GAInC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,2BAA2B,GAE5B,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iCAAiC,EAAE,gCAAgC,EAAE,MAAM,aAAa,CAAC;AAOlG,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,OAAsC;QAAtC,YAAO,GAAP,OAAO,CAA+B;IAAG,CAAC;IAEvE,YAAY,CACV,QAAgB,EAChB,UAAkB,EAClB,KAA4B,EAC5B,SAA4B;QAE5B,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YACnC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC9B,CAAC;QAED,MAAM,MAAM,GAAG,2BAA2B,CACxC,IAAI,CAAC,OAAO,CAAC,QAAQ,EACrB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,EAClC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC,CACtD,CAAC;QAEF,IAAI,MAAM,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC9B,CAAC;QAED,MAAM,MAAM,GAAG,kCAAkC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACtF,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACpC,CAAC;CACF"}

package/lib/register-binder.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Activity Feedback — AI 生命周期事件绑定（服务插件）
+ */
+import type { Plugin } from 'zhin.js';
+import { type ActivityFeedbackServiceConfig } from './config.js';
+export declare function mountActivityFeedbackBinder(plugin: Plugin, serviceConfig: ActivityFeedbackServiceConfig): void;
+//# sourceMappingURL=register-binder.d.ts.map

package/lib/register-binder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-binder.d.ts","sourceRoot":"","sources":["../src/register-binder.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,SAAS,CAAC;AAc/C,OAAO,EACL,KAAK,6BAA6B,EAEnC,MAAM,aAAa,CAAC;AA6MrB,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,6BAA6B,GAC3C,IAAI,CA4DN"}

package/lib/register-binder.js

@@ -0,0 +1,215 @@
+import { subscribeAIEvents, enableActivityFeedbackForBot, isGenericActivityFeedbackManager, resolveActivityFeedbackPhaseConfig, } from '@zhin.js/agent';
+import { resolveActivityFeedbackForTarget, } from './config.js';
+const SYNTHETIC_SENDER_IDS = new Set(['system', 'cron', 'assistant']);
+function resolveSceneType(payload) {
+    const scope = payload.scope;
+    if (scope === 'group' || scope === 'channel' || scope === 'private')
+        return scope;
+    const sceneId = payload.sceneId ?? '';
+    if (sceneId.startsWith('group:'))
+        return 'group';
+    if (sceneId.startsWith('channel:'))
+        return 'channel';
+    return 'private';
+}
+function resolveTargets(payload, sceneType) {
+    const { sceneId, userId, sessionId } = payload;
+    const parts = sessionId.split(':').filter((p) => p.length > 0);
+    let resolvedUserId = userId;
+    let groupId;
+    if (sceneType === 'group' || sceneType === 'channel') {
+        groupId = sceneId?.replace(/^(group|channel):/, '') || sceneId;
+        if (!groupId && parts.length >= 3)
+            groupId = parts[1];
+        if (!resolvedUserId && parts.length >= 3)
+            resolvedUserId = parts[parts.length - 1];
+    }
+    else {
+        if (sceneId?.startsWith('private:'))
+            resolvedUserId = sceneId.slice('private:'.length);
+        else if ((!resolvedUserId || SYNTHETIC_SENDER_IDS.has(resolvedUserId))
+            && sceneId
+            && !SYNTHETIC_SENDER_IDS.has(sceneId)) {
+            resolvedUserId = sceneId;
+        }
+        else if (!resolvedUserId && parts.length >= 2) {
+            resolvedUserId = parts.length >= 3 ? parts[parts.length - 1] : parts[1];
+        }
+    }
+    return { userId: resolvedUserId, groupId };
+}
+function buildIndicatorOptions(payload, sceneType) {
+    const targets = resolveTargets(payload, sceneType);
+    return {
+        platform: payload.platform,
+        endpointId: payload.endpointId,
+        sessionId: payload.sessionId,
+        messageId: payload.messageId,
+        sceneType,
+        userId: targets.userId,
+        groupId: targets.groupId,
+    };
+}
+function syncPolicyToPlatformManager(endpoint, policy) {
+    const manager = endpoint.$activityFeedback;
+    if (!manager || isGenericActivityFeedbackManager(manager))
+        return;
+    const withUpdate = manager;
+    withUpdate.updateConfig?.(policy ?? {});
+}
+async function resolveGenericManager(root, endpoint, platform, adapter) {
+    if (endpoint.$activityFeedback && isGenericActivityFeedbackManager(endpoint.$activityFeedback)) {
+        return endpoint.$activityFeedback;
+    }
+    return enableActivityFeedbackForBot(endpoint, platform, adapter);
+}
+function resolvePolicy(serviceConfig, platform, endpointId) {
+    return resolveActivityFeedbackForTarget(serviceConfig, platform, endpointId);
+}
+async function startPhase(root, logger, serviceConfig, payload, phase, reason) {
+    const { platform, endpointId } = payload;
+    if (!platform || !endpointId)
+        return;
+    try {
+        const adapter = root.injectAdapter(platform);
+        const endpoint = adapter?.endpoints?.get(endpointId);
+        if (!endpoint)
+            return;
+        const activityConfig = resolvePolicy(serviceConfig, platform, endpointId);
+        if (activityConfig?.enabled === false)
+            return;
+        const sceneType = resolveSceneType(payload);
+        const phaseConfig = resolveActivityFeedbackPhaseConfig(platform, activityConfig, phase, sceneType);
+        if (phaseConfig.type === 'none')
+            return;
+        const options = buildIndicatorOptions(payload, sceneType);
+        syncPolicyToPlatformManager(endpoint, activityConfig);
+        if (phase === 'active'
+            && endpoint.$activityFeedback
+            && !isGenericActivityFeedbackManager(endpoint.$activityFeedback)) {
+            const platformManager = endpoint.$activityFeedback;
+            const targets = resolveTargets(payload, sceneType);
+            await platformManager.start({
+                messageId: payload.messageId,
+                sessionId: payload.sessionId,
+                userId: targets.userId,
+                groupId: targets.groupId,
+                sceneType: sceneType === 'channel' ? 'group' : sceneType,
+                phase,
+            });
+            return;
+        }
+        const manager = await resolveGenericManager(root, endpoint, platform, adapter);
+        const existing = manager.getActiveIndicator(phase, options);
+        if (existing)
+            return;
+        logger.debug(`[ActivityFeedback] start ${phase} (${reason}) session=${payload.sessionId}`);
+        await manager.start(phase, options, phaseConfig);
+    }
+    catch (error) {
+        logger.error(`[ActivityFeedback] start ${phase} failed (${reason}):`, error);
+    }
+}
+async function stopPhase(root, logger, payload, phase, reason) {
+    const { platform, endpointId } = payload;
+    if (!platform || !endpointId)
+        return;
+    try {
+        const adapter = root.injectAdapter(platform);
+        const endpoint = adapter?.endpoints?.get(endpointId);
+        if (!endpoint?.$activityFeedback)
+            return;
+        const sceneType = resolveSceneType(payload);
+        const options = buildIndicatorOptions(payload, sceneType);
+        if (phase === 'active' && !isGenericActivityFeedbackManager(endpoint.$activityFeedback)) {
+            const targets = resolveTargets(payload, sceneType);
+            await endpoint.$activityFeedback.stop({
+                sessionId: payload.sessionId,
+                userId: targets.userId,
+                groupId: targets.groupId,
+                phase,
+            });
+            return;
+        }
+        if (!isGenericActivityFeedbackManager(endpoint.$activityFeedback))
+            return;
+        logger.debug(`[ActivityFeedback] stop ${phase} (${reason}) session=${payload.sessionId}`);
+        await endpoint.$activityFeedback.stop(phase, options);
+    }
+    catch (error) {
+        logger.error(`[ActivityFeedback] stop ${phase} failed (${reason}):`, error);
+    }
+}
+async function updateThinkingPhase(root, logger, payload, text) {
+    const { platform, endpointId } = payload;
+    if (!platform || !endpointId || !text)
+        return;
+    try {
+        const adapter = root.injectAdapter(platform);
+        const endpoint = adapter?.endpoints?.get(endpointId);
+        if (!endpoint?.$activityFeedback || !isGenericActivityFeedbackManager(endpoint.$activityFeedback))
+            return;
+        const sceneType = resolveSceneType(payload);
+        const options = buildIndicatorOptions(payload, sceneType);
+        const indicator = endpoint.$activityFeedback.getActiveIndicator('thinking', options);
+        if (indicator?.update) {
+            await indicator.update(text);
+        }
+    }
+    catch (error) {
+        logger.error('[ActivityFeedback] thinking update failed:', error);
+    }
+}
+export function mountActivityFeedbackBinder(plugin, serviceConfig) {
+    const { root, logger } = plugin;
+    const dispose = subscribeAIEvents(root, {
+        onQueuedStart: async (payload) => {
+            await startPhase(root, logger, serviceConfig, payload, 'queued', 'activity.queued.start');
+        },
+        onQueuedClear: async (payload) => {
+            await stopPhase(root, logger, payload, 'queued', 'activity.queued.clear');
+        },
+        onProcessingStart: async (payload) => {
+            await stopPhase(root, logger, payload, 'queued', 'processing.start');
+            await startPhase(root, logger, serviceConfig, payload, 'active', 'processing.start');
+        },
+        onTypingStart: async () => {
+            // active 由 processing.start 统一拉起
+        },
+        onProcessingFinish: async (payload) => {
+            if (payload.keepTyping)
+                return;
+            await stopPhase(root, logger, payload, 'thinking', 'processing.finish');
+            await stopPhase(root, logger, payload, 'active', 'processing.finish');
+        },
+        onProcessingError: async (payload) => {
+            await stopPhase(root, logger, payload, 'thinking', 'processing.error');
+            await stopPhase(root, logger, payload, 'active', 'processing.error');
+        },
+        onTypingStop: async (payload) => {
+            await stopPhase(root, logger, payload, 'active', 'typing.stop');
+        },
+        onThinking: async (payload) => {
+            if (!payload.thinking)
+                return;
+            await stopPhase(root, logger, payload, 'active', 'thinking');
+            await startPhase(root, logger, serviceConfig, payload, 'thinking', 'thinking');
+            await updateThinkingPhase(root, logger, payload, payload.thinking);
+        },
+        onSubagentStart: async (payload) => {
+            await stopPhase(root, logger, payload, 'active', 'subagent.start');
+            await startPhase(root, logger, serviceConfig, payload, 'thinking', 'subagent.start');
+            const label = payload.label ? `🔍 子任务执行中: ${payload.label}...` : '🔍 子 agent 处理中...';
+            await updateThinkingPhase(root, logger, payload, label);
+        },
+        onSubagentFinish: async (payload) => {
+            await stopPhase(root, logger, payload, 'thinking', 'subagent.finish');
+            await startPhase(root, logger, serviceConfig, payload, 'active', 'subagent.finish');
+        },
+    });
+    plugin.onDispose(() => {
+        logger.debug('[ActivityFeedback] Disposing binder');
+        dispose();
+    });
+}
+//# sourceMappingURL=register-binder.js.map

package/lib/register-binder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-binder.js","sourceRoot":"","sources":["../src/register-binder.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@zhin.js/service-activity-feedback",
+  "version": "1.0.0",
+  "description": "Activity Feedback 服务插件：订阅 AI 生命周期事件，按 endpoint activityFeedback 配置驱动适配器能力",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "plugin.yml",
+    "README.md"
+  ],
+  "keywords": [
+    "zhin",
+    "zhin.js",
+    "plugin",
+    "service",
+    "activity-feedback",
+    "typing-indicator"
+  ],
+  "author": "Zhin.js Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "directory": "plugins/services/activity-feedback"
+  },
+  "dependencies": {
+    "@zhin.js/agent": "1.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "typescript": "^6.0.3",
+    "zhin.js": "4.1.0"
+  },
+  "peerDependencies": {
+    "@zhin.js/agent": "1.0.1",
+    "zhin.js": "4.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "vitest run --config ../../../vitest.config.ts plugins/services/activity-feedback/tests"
+  }
+}

package/plugin.yml

@@ -0,0 +1,2 @@
+name: service-activity-feedback
+description: Activity Feedback 服务 — 订阅 AI 事件，按 endpoint 配置驱动 queued/active/thinking 三阶段反馈

package/src/ai-event-binder.ts

@@ -0,0 +1,98 @@
+import type { Plugin } from 'zhin.js';
+import { subscribeAIEvents } from '@zhin.js/agent';
+import type { ActivityFeedbackServiceConfig } from './config.js';
+import {
+  ActivityFeedbackExecutor,
+  createRootEndpointAccess,
+  type ActivityFeedbackEndpointAccess,
+} from './executor.js';
+import { ActivityFeedbackOrchestrator } from './orchestrator.js';
+import { ActivityFeedbackPolicy } from './policy.js';
+import { loadActivityFeedbackServiceConfig } from './config.js';
+
+export function bindActivityFeedbackToAIEvents(
+  root: Plugin['root'],
+  orchestrator: ActivityFeedbackOrchestrator,
+): () => void {
+  return subscribeAIEvents(root, {
+    onQueuedStart: (payload) => orchestrator.startPhase(payload, 'queued', 'activity.queued.start'),
+    onQueuedClear: (payload) => orchestrator.stopPhase(payload, 'queued', 'activity.queued.clear'),
+
+    onProcessingStart: async (payload) => {
+      await orchestrator.stopPhase(payload, 'queued', 'processing.start');
+      await orchestrator.startPhase(payload, 'active', 'processing.start');
+    },
+
+    onTypingStart: async () => {},
+
+    onProcessingFinish: async (payload) => {
+      if (payload.keepTyping) return;
+      await orchestrator.stopPhase(payload, 'thinking', 'processing.finish');
+      await orchestrator.stopPhase(payload, 'active', 'processing.finish');
+    },
+
+    onProcessingError: async (payload) => {
+      await orchestrator.stopPhase(payload, 'thinking', 'processing.error');
+      await orchestrator.stopPhase(payload, 'active', 'processing.error');
+    },
+
+    onTypingStop: (payload) => orchestrator.stopPhase(payload, 'active', 'typing.stop'),
+
+    onThinking: async (payload) => {
+      if (!payload.thinking) return;
+      await orchestrator.stopPhase(payload, 'active', 'thinking');
+      await orchestrator.startPhase(payload, 'thinking', 'thinking');
+      await orchestrator.updateThinkingText(payload, payload.thinking);
+    },
+
+    onSubagentStart: async (payload) => {
+      await orchestrator.stopPhase(payload, 'active', 'subagent.start');
+      await orchestrator.startPhase(payload, 'thinking', 'subagent.start');
+      const label = payload.label
+        ? `🔍 子任务执行中: ${payload.label}...`
+        : '🔍 子 agent 处理中...';
+      await orchestrator.updateThinkingText(payload, label);
+    },
+
+    onSubagentFinish: async (payload) => {
+      await orchestrator.stopPhase(payload, 'thinking', 'subagent.finish');
+      await orchestrator.startPhase(payload, 'active', 'subagent.finish');
+    },
+  });
+}
+
+export function mountActivityFeedbackService(
+  plugin: Plugin,
+  orchestrator: ActivityFeedbackOrchestrator,
+): void {
+  const dispose = bindActivityFeedbackToAIEvents(plugin.root, orchestrator);
+  plugin.onDispose(() => {
+    plugin.logger.debug('[ActivityFeedback] Disposing binder');
+    dispose();
+  });
+}
+
+export interface CreateActivityFeedbackOrchestratorOptions {
+  serviceConfig: ActivityFeedbackServiceConfig;
+  access: ActivityFeedbackEndpointAccess;
+  logger: Plugin['logger'];
+}
+
+export function createActivityFeedbackOrchestrator(
+  options: CreateActivityFeedbackOrchestratorOptions,
+): ActivityFeedbackOrchestrator {
+  const policy = new ActivityFeedbackPolicy(loadActivityFeedbackServiceConfig(options.serviceConfig));
+  const executor = new ActivityFeedbackExecutor(options.access);
+  return new ActivityFeedbackOrchestrator(policy, executor, options.logger);
+}
+
+export function createActivityFeedbackOrchestratorFromPlugin(
+  plugin: Plugin,
+  serviceConfig: ActivityFeedbackServiceConfig,
+): ActivityFeedbackOrchestrator {
+  return createActivityFeedbackOrchestrator({
+    serviceConfig,
+    access: createRootEndpointAccess(plugin.root),
+    logger: plugin.logger,
+  });
+}

package/src/config.ts

@@ -0,0 +1,75 @@
+import type { ActivityFeedbackConfig } from '@zhin.js/agent';
+
+/** 顶层 `activityFeedback` 配置（zhin.config.yml，与 endpoints 解耦） */
+export interface ActivityFeedbackServiceConfig {
+  enabled?: boolean;
+  defaults?: ActivityFeedbackConfig;
+  platforms?: Record<string, ActivityFeedbackConfig>;
+  endpoints?: Record<string, ActivityFeedbackConfig>;
+}
+
+function mergePhaseScene(
+  base: ActivityFeedbackConfig['phases'],
+  override: ActivityFeedbackConfig['phases'],
+): ActivityFeedbackConfig['phases'] {
+  if (!base && !override) return undefined;
+  const phases = new Set([
+    ...Object.keys(base ?? {}),
+    ...Object.keys(override ?? {}),
+  ]) as Set<keyof NonNullable<ActivityFeedbackConfig['phases']>>;
+
+  const merged: NonNullable<ActivityFeedbackConfig['phases']> = {};
+  for (const phase of phases) {
+    merged[phase] = {
+      ...base?.[phase],
+      ...override?.[phase],
+      private: { ...base?.[phase]?.private, ...override?.[phase]?.private },
+      group: { ...base?.[phase]?.group, ...override?.[phase]?.group },
+      channel: { ...base?.[phase]?.channel, ...override?.[phase]?.channel },
+    };
+  }
+  return merged;
+}
+
+export function mergeActivityFeedbackLayers(
+  ...layers: (ActivityFeedbackConfig | undefined)[]
+): ActivityFeedbackConfig | undefined {
+  let result: ActivityFeedbackConfig | undefined;
+  for (const layer of layers) {
+    if (!layer) continue;
+    if (!result) {
+      result = { ...layer, phases: layer.phases ? { ...layer.phases } : undefined };
+      continue;
+    }
+    if (layer.enabled !== undefined) result.enabled = layer.enabled;
+    if (layer.phases) {
+      result.phases = mergePhaseScene(result.phases, layer.phases);
+    }
+  }
+  return result;
+}
+
+export function loadActivityFeedbackServiceConfig(
+  raw: ActivityFeedbackServiceConfig | undefined,
+): ActivityFeedbackServiceConfig {
+  return {
+    enabled: true,
+    ...raw,
+  };
+}
+
+/** @deprecated 使用 ActivityFeedbackPolicy */
+export function resolveActivityFeedbackForTarget(
+  service: ActivityFeedbackServiceConfig,
+  platform: string,
+  endpointId: string,
+): ActivityFeedbackConfig | undefined {
+  if (service.enabled === false) {
+    return { enabled: false };
+  }
+  return mergeActivityFeedbackLayers(
+    service.defaults,
+    service.platforms?.[platform],
+    service.endpoints?.[`${platform}:${endpointId}`],
+  );
+}

package/src/executor.ts

@@ -0,0 +1,166 @@
+import type { Adapter } from 'zhin.js';
+import {
+  enableActivityFeedbackForBot,
+  isGenericActivityFeedbackManager,
+  type ActivityFeedbackManager,
+  type ActivityFeedbackPhase,
+  type EndpointWithActivityFeedback,
+  type PlatformActivityFeedbackManager,
+  type ResolvedActivityFeedbackPhaseConfig,
+} from '@zhin.js/agent';
+import type { ActivityFeedbackEventContext } from '@zhin.js/agent';
+
+/** IM 侧 endpoint 访问 seam（便于测试注入 fake） */
+export interface ActivityFeedbackEndpointAccess {
+  resolve(
+    platform: string,
+    endpointId: string,
+  ): { endpoint: EndpointWithActivityFeedback; adapter: Adapter } | undefined;
+}
+
+export function createRootEndpointAccess(root: {
+  injectAdapter(platform: string): Adapter | undefined;
+}): ActivityFeedbackEndpointAccess {
+  return {
+    resolve(platform, endpointId) {
+      const adapter = root.injectAdapter(platform);
+      const endpoint = adapter?.endpoints?.get(endpointId) as EndpointWithActivityFeedback | undefined;
+      if (!endpoint || !adapter) return undefined;
+      return { endpoint, adapter };
+    },
+  };
+}
+
+interface PhaseDriver {
+  start(
+    ctx: ActivityFeedbackEventContext,
+    phase: ActivityFeedbackPhase,
+    phaseConfig: ResolvedActivityFeedbackPhaseConfig,
+  ): Promise<void>;
+  stop(ctx: ActivityFeedbackEventContext, phase: ActivityFeedbackPhase): Promise<void>;
+  updateThinkingText(ctx: ActivityFeedbackEventContext, text: string): Promise<void>;
+}
+
+class PlatformPhaseDriver implements PhaseDriver {
+  constructor(private readonly manager: PlatformActivityFeedbackManager) {}
+
+  async start(
+    ctx: ActivityFeedbackEventContext,
+    phase: ActivityFeedbackPhase,
+    phaseConfig: ResolvedActivityFeedbackPhaseConfig,
+  ): Promise<void> {
+    const sceneType = ctx.sceneType === 'channel' ? 'group' : ctx.sceneType;
+    await this.manager.start({
+      messageId: ctx.messageId,
+      sessionId: ctx.sessionId,
+      userId: ctx.userId,
+      groupId: ctx.groupId,
+      sceneType,
+      phase,
+      phaseConfig,
+    });
+  }
+
+  async stop(ctx: ActivityFeedbackEventContext, phase: ActivityFeedbackPhase): Promise<void> {
+    await this.manager.stop({
+      sessionId: ctx.sessionId,
+      userId: ctx.userId,
+      groupId: ctx.groupId,
+      phase,
+    });
+  }
+
+  async updateThinkingText(ctx: ActivityFeedbackEventContext, text: string): Promise<void> {
+    const indicator = this.manager.getActiveIndicator?.('thinking', ctx.options);
+    if (indicator?.update) {
+      await indicator.update(text);
+    }
+  }
+}
+
+class GenericPhaseDriver implements PhaseDriver {
+  private manager?: ActivityFeedbackManager;
+
+  constructor(
+    private readonly endpoint: EndpointWithActivityFeedback,
+    private readonly platform: string,
+    private readonly adapter: Adapter,
+  ) {}
+
+  private async ensureManager(): Promise<ActivityFeedbackManager> {
+    if (this.manager) return this.manager;
+    const existing = this.endpoint.$activityFeedback;
+    if (existing && isGenericActivityFeedbackManager(existing)) {
+      this.manager = existing;
+      return existing;
+    }
+    this.manager = enableActivityFeedbackForBot(this.endpoint, this.platform, this.adapter);
+    return this.manager;
+  }
+
+  async start(
+    ctx: ActivityFeedbackEventContext,
+    phase: ActivityFeedbackPhase,
+    phaseConfig: ResolvedActivityFeedbackPhaseConfig,
+  ): Promise<void> {
+    const manager = await this.ensureManager();
+    if (manager.getActiveIndicator(phase, ctx.options)) return;
+    await manager.start(phase, ctx.options, phaseConfig);
+  }
+
+  async stop(ctx: ActivityFeedbackEventContext, phase: ActivityFeedbackPhase): Promise<void> {
+    const manager = this.endpoint.$activityFeedback;
+    if (!manager || !isGenericActivityFeedbackManager(manager)) return;
+    await manager.stop(phase, ctx.options);
+  }
+
+  async updateThinkingText(ctx: ActivityFeedbackEventContext, text: string): Promise<void> {
+    const manager = this.endpoint.$activityFeedback;
+    if (!manager || !isGenericActivityFeedbackManager(manager)) return;
+    const indicator = manager.getActiveIndicator('thinking', ctx.options);
+    if (indicator?.update) {
+      await indicator.update(text);
+    }
+  }
+}
+
+function createPhaseDriver(
+  endpoint: EndpointWithActivityFeedback,
+  platform: string,
+  adapter: Adapter,
+): PhaseDriver {
+  const manager = endpoint.$activityFeedback;
+  if (manager && !isGenericActivityFeedbackManager(manager)) {
+    return new PlatformPhaseDriver(manager);
+  }
+  return new GenericPhaseDriver(endpoint, platform, adapter);
+}
+
+export class ActivityFeedbackExecutor {
+  constructor(private readonly access: ActivityFeedbackEndpointAccess) {}
+
+  async start(
+    ctx: ActivityFeedbackEventContext,
+    phase: ActivityFeedbackPhase,
+    phaseConfig: ResolvedActivityFeedbackPhaseConfig,
+  ): Promise<void> {
+    const resolved = this.access.resolve(ctx.platform, ctx.endpointId);
+    if (!resolved) return;
+    const driver = createPhaseDriver(resolved.endpoint, ctx.platform, resolved.adapter);
+    await driver.start(ctx, phase, phaseConfig);
+  }
+
+  async stop(ctx: ActivityFeedbackEventContext, phase: ActivityFeedbackPhase): Promise<void> {
+    const resolved = this.access.resolve(ctx.platform, ctx.endpointId);
+    if (!resolved?.endpoint.$activityFeedback) return;
+    const driver = createPhaseDriver(resolved.endpoint, ctx.platform, resolved.adapter);
+    await driver.stop(ctx, phase);
+  }
+
+  async updateThinkingText(ctx: ActivityFeedbackEventContext, text: string): Promise<void> {
+    const resolved = this.access.resolve(ctx.platform, ctx.endpointId);
+    if (!resolved) return;
+    const driver = createPhaseDriver(resolved.endpoint, ctx.platform, resolved.adapter);
+    await driver.updateThinkingText(ctx, text);
+  }
+}