@xopcai/xopc 0.0.82 → 0.0.84

package/dist/src/agent/messaging/command-handler.js

@@ -46,15 +46,12 @@ var CommandHandler = class {
 		this.config = config;
 	}
 	/**
-	* Execute a command using the unified command system
+	* Build the unified command context shared by all execute paths.
+	* When `recorder` is set, every reply text is also captured (for SSE / CLI aggregation).
 	*/
-	async executeCommand(commandName, args, context) {
-		if (!commandRegistry.has(commandName)) return false;
-		log.info({
-			command: commandName,
-			sessionKey: context.sessionKey
-		}, "Executing command via new system");
-		const cmdCtx = createCommandContext({
+	buildCommandContext(context, recorder) {
+		const skipBusOutbound = shouldSkipBusOutboundForChannel(context.channel);
+		return createCommandContext({
 			sessionKey: context.sessionKey,
 			source: context.channel,
 			channelId: context.channel,
@@ -67,7 +64,8 @@ var CommandHandler = class {
 			sessionConfigStore: this.sessionConfigStore,
 			applySessionThinkingLevel: this.applySessionThinkingLevel,
 			replyHandler: async (text, _options) => {
-				if (shouldSkipBusOutboundForChannel(context.channel)) return;
+				recorder?.(text);
+				if (skipBusOutbound) return;
 				await this.bus.publishOutbound({
 					channel: context.channel,
 					chat_id: context.chatId,
@@ -76,7 +74,7 @@ var CommandHandler = class {
 				});
 			},
 			typingHandler: async (typing) => {
-				if (shouldSkipBusOutboundForChannel(context.channel)) return;
+				if (skipBusOutbound) return;
 				await this.bus.publishOutbound({
 					channel: context.channel,
 					chat_id: context.chatId,
@@ -131,6 +129,17 @@ var CommandHandler = class {
 				inboundMetadata: context.inboundMetadata
 			})
 		});
+	}
+	/**
+	* Execute a command using the unified command system
+	*/
+	async executeCommand(commandName, args, context) {
+		if (!commandRegistry.has(commandName)) return false;
+		log.info({
+			command: commandName,
+			sessionKey: context.sessionKey
+		}, "Executing command via new system");
+		const cmdCtx = this.buildCommandContext(context);
 		const result = await commandRegistry.execute(commandName, cmdCtx, args);
 		if (result.content && !shouldSkipBusOutboundForChannel(context.channel)) await this.bus.publishOutbound({
 			channel: context.channel,
@@ -153,92 +162,8 @@ var CommandHandler = class {
 			command: commandName,
 			sessionKey: context.sessionKey
 		}, "Executing command (aggregate reply)");
-		const { aggregatedText } = await this.runRegistryExecuteWithCapture(args, commandName, context);
-		return {
-			handled: true,
-			aggregatedText
-		};
-	}
-	async runRegistryExecuteWithCapture(args, commandName, context) {
 		const segments = [];
-		const wrapped = createCommandContext({
-			sessionKey: context.sessionKey,
-			source: context.channel,
-			channelId: context.channel,
-			chatId: context.chatId,
-			senderId: context.senderId,
-			isGroup: context.isGroup,
-			config: this.config,
-			bus: this.bus,
-			sessionStore: this.sessionStore,
-			sessionConfigStore: this.sessionConfigStore,
-			applySessionThinkingLevel: this.applySessionThinkingLevel,
-			replyHandler: async (text, _options) => {
-				segments.push(text);
-				if (shouldSkipBusOutboundForChannel(context.channel)) return;
-				await this.bus.publishOutbound({
-					channel: context.channel,
-					chat_id: context.chatId,
-					content: text,
-					type: "message"
-				});
-			},
-			typingHandler: async (typing) => {
-				if (shouldSkipBusOutboundForChannel(context.channel)) return;
-				await this.bus.publishOutbound({
-					channel: context.channel,
-					chat_id: context.chatId,
-					type: typing ? "typing_on" : "typing_off"
-				});
-			},
-			supportedFeatures: ["markdown", "typing"],
-			getCurrentModel: this.getCurrentModel,
-			switchModel: async (modelId) => {
-				return this.switchModelForSession(context.sessionKey, modelId);
-			},
-			listModels: async () => {
-				const providers = getAllProviders();
-				const models = [];
-				for (const providerId of providers) if (isProviderConfiguredSync(providerId)) {
-					const providerModels = getModelsByProvider(providerId);
-					for (const m of providerModels) models.push({
-						id: `${m.provider}/${m.id}`,
-						name: m.name || m.id,
-						provider: getProviderDisplayName(providerId)
-					});
-				}
-				return models;
-			},
-			getUsage: async () => {
-				const messages = await this.sessionStore.load(context.sessionKey);
-				let promptTokens = 0;
-				let completionTokens = 0;
-				for (const msg of messages) if ("usage" in msg && msg.usage) {
-					const usage = msg.usage;
-					promptTokens += usage.input || 0;
-					completionTokens += usage.output || 0;
-				}
-				return {
-					promptTokens,
-					completionTokens,
-					totalTokens: promptTokens + completionTokens,
-					messageCount: messages.length
-				};
-			},
-			invalidateAgentSession: this.invalidateAgentSession,
-			abortCurrentTurn: this.abortSessionTurn ? async () => {
-				await this.abortSessionTurn(context.sessionKey);
-			} : void 0,
-			compactSession: this.compactSession,
-			btwQuery: this.btwQuery,
-			getSessionContextReport: this.getSessionContextReport,
-			persistentGoalApis: this.getPersistentGoalApisForCommand({
-				sessionKey: context.sessionKey,
-				channel: context.channel,
-				chatId: context.chatId,
-				inboundMetadata: context.inboundMetadata
-			})
-		});
+		const wrapped = this.buildCommandContext(context, (text) => segments.push(text));
 		const result = await commandRegistry.execute(commandName, wrapped, args);
 		if (result.content) {
 			segments.push(result.content);
@@ -249,7 +174,10 @@ var CommandHandler = class {
 				type: "message"
 			});
 		}
-		return { aggregatedText: segments.filter((s) => s && s.trim()).join("\n\n") };
+		return {
+			handled: true,
+			aggregatedText: segments.filter((s) => s && s.trim()).join("\n\n")
+		};
 	}
 };
 //#endregion

package/dist/src/agent/messaging/command-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-handler.js","names":[],"sources":["../../../../src/agent/messaging/command-handler.ts"],"sourcesContent":["/**\n * Command Handler - Parses and executes commands\n *\n * Handles command execution using the unified command system.\n */\n\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport type { ThinkLevel } from '../transcript/thinking-types.js';\nimport type { CompactionResult } from '../memory/compaction.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { commandRegistry, createCommandContext } from '../../chat-commands/index.js';\nimport { getAllProviders, getModelsByProvider, getProviderDisplayName } from '../../providers/index.js';\nimport type { PersistentGoalApis } from '../goals/persistent-goal-apis.js';\n\nconst log = createLogger('CommandHandler');\n\n/** Gateway console direct stream uses SSE tokens; there is no ChannelPlugin outbound for `webchat`. */\nfunction shouldSkipBusOutboundForChannel(channel: string): boolean {\n  return channel === 'webchat';\n}\n\nexport interface CommandContext {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  senderId: string;\n  isGroup: boolean;\n  /** From inbound message metadata (thread/account, etc.) for `/goal` continuation routing. */\n  inboundMetadata?: Record<string, unknown>;\n}\n\nexport interface CommandHandlerConfig {\n  config: Config;\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  sessionConfigStore?: SessionConfigStore;\n  /** After /think persists, sync pi-agent */\n  applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  getCurrentModel: () => string;\n  switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  /** Drop in-memory agent after session file is cleared (e.g. /new) */\n  invalidateAgentSession?: (sessionKey: string) => void;\n  /** Cancel streaming preview + in-flight LLM work for this session (e.g. /abort) */\n  abortSessionTurn?: (sessionKey: string) => Promise<void>;\n\n  compactSession?: (\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ) => Promise<CompactionResult>;\n\n  btwQuery?: (sessionKey: string, question: string) => Promise<{ text: string; error?: string }>;\n\n  getSessionContextReport?: (\n    sessionKey: string,\n    mode: 'list' | 'detail' | 'json',\n  ) => Promise<string>;\n\n  getPersistentGoalApisForCommand: (routing: {\n    sessionKey: string;\n    channel: string;\n    chatId: string;\n    inboundMetadata?: Record<string, unknown>;\n  }) => PersistentGoalApis;\n}\n\nexport class CommandHandler {\n  private config: Config;\n  private bus: MessageBus;\n  private sessionStore: SessionStore;\n  private sessionConfigStore?: SessionConfigStore;\n  private applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  private getCurrentModel: () => string;\n  private switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  private invalidateAgentSession?: (sessionKey: string) => void;\n  private abortSessionTurn?: (sessionKey: string) => Promise<void>;\n  private compactSession?: CommandHandlerConfig['compactSession'];\n  private btwQuery?: CommandHandlerConfig['btwQuery'];\n  private getSessionContextReport?: CommandHandlerConfig['getSessionContextReport'];\n  private getPersistentGoalApisForCommand: CommandHandlerConfig['getPersistentGoalApisForCommand'];\n\n  constructor(handlerConfig: CommandHandlerConfig) {\n    this.config = handlerConfig.config;\n    this.bus = handlerConfig.bus;\n    this.sessionStore = handlerConfig.sessionStore;\n    this.sessionConfigStore = handlerConfig.sessionConfigStore;\n    this.applySessionThinkingLevel = handlerConfig.applySessionThinkingLevel;\n    this.getCurrentModel = handlerConfig.getCurrentModel;\n    this.switchModelForSession = handlerConfig.switchModelForSession;\n    this.invalidateAgentSession = handlerConfig.invalidateAgentSession;\n    this.abortSessionTurn = handlerConfig.abortSessionTurn;\n    this.compactSession = handlerConfig.compactSession;\n    this.btwQuery = handlerConfig.btwQuery;\n    this.getSessionContextReport = handlerConfig.getSessionContextReport;\n    this.getPersistentGoalApisForCommand = handlerConfig.getPersistentGoalApisForCommand;\n  }\n\n  /** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */\n  updateAgentConfig(config: Config): void {\n    this.config = config;\n  }\n\n  /**\n   * Execute a command using the unified command system\n   */\n  async executeCommand(\n    commandName: string,\n    args: string,\n    context: CommandContext\n  ): Promise<boolean> {\n    // Check if command exists\n    if (!commandRegistry.has(commandName)) {\n      return false;\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command via new system');\n\n    // Create command context\n    const cmdCtx = createCommandContext({\n      sessionKey: context.sessionKey,\n      source: context.channel as 'telegram' | 'webui' | 'cli' | 'api' | 'system' | 'gateway',\n      channelId: context.channel,\n      chatId: context.chatId,\n      senderId: context.senderId,\n      isGroup: context.isGroup,\n      config: this.config,\n      bus: this.bus,\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      applySessionThinkingLevel: this.applySessionThinkingLevel,\n\n      replyHandler: async (text: string, _options?) => {\n        if (shouldSkipBusOutboundForChannel(context.channel)) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: text,\n          type: 'message',\n        });\n      },\n\n      typingHandler: async (typing: boolean) => {\n        if (shouldSkipBusOutboundForChannel(context.channel)) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          type: typing ? 'typing_on' : 'typing_off',\n        });\n      },\n\n      supportedFeatures: ['markdown', 'typing'],\n\n      getCurrentModel: this.getCurrentModel,\n\n      switchModel: async (modelId: string) => {\n        return this.switchModelForSession(context.sessionKey, modelId);\n      },\n\n      listModels: async () => {\n        const providers = getAllProviders();\n        const models: Array<{ id: string; name: string; provider: string }> = [];\n\n        for (const providerId of providers) {\n          if (isProviderConfiguredSync(providerId)) {\n            const providerModels = getModelsByProvider(providerId);\n            for (const m of providerModels) {\n              models.push({\n                id: `${m.provider}/${m.id}`,\n                name: m.name || m.id,\n                provider: getProviderDisplayName(providerId),\n              });\n            }\n          }\n        }\n\n        return models;\n      },\n\n      getUsage: async () => {\n        const messages = await this.sessionStore.load(context.sessionKey);\n        let promptTokens = 0;\n        let completionTokens = 0;\n\n        for (const msg of messages) {\n          if ('usage' in msg && msg.usage) {\n            const usage = msg.usage as any;\n            promptTokens += usage.input || 0;\n            completionTokens += usage.output || 0;\n          }\n        }\n\n        return {\n          promptTokens,\n          completionTokens,\n          totalTokens: promptTokens + completionTokens,\n          messageCount: messages.length,\n        };\n      },\n\n      invalidateAgentSession: this.invalidateAgentSession,\n\n      abortCurrentTurn: this.abortSessionTurn\n        ? async () => {\n            await this.abortSessionTurn!(context.sessionKey);\n          }\n        : undefined,\n\n      compactSession: this.compactSession,\n      btwQuery: this.btwQuery,\n      getSessionContextReport: this.getSessionContextReport,\n      persistentGoalApis: this.getPersistentGoalApisForCommand({\n        sessionKey: context.sessionKey,\n        channel: context.channel,\n        chatId: context.chatId,\n        inboundMetadata: context.inboundMetadata,\n      }),\n    });\n\n    const result = await commandRegistry.execute(commandName, cmdCtx, args);\n\n    if (result.content && !shouldSkipBusOutboundForChannel(context.channel)) {\n      await this.bus.publishOutbound({\n        channel: context.channel,\n        chat_id: context.chatId,\n        content: result.content,\n        type: 'message',\n      });\n    }\n\n    return true;\n  }\n\n  /**\n   * Run command and return all user-visible text (ctx.reply + result.content) for SSE/CLI.\n   * Same bus side effects as {@link executeCommand}.\n   */\n  async executeCommandAndAggregateReply(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<{ handled: boolean; aggregatedText: string }> {\n    if (!commandRegistry.has(commandName)) {\n      return { handled: false, aggregatedText: '' };\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command (aggregate reply)');\n\n    const { aggregatedText } = await this.runRegistryExecuteWithCapture(args, commandName, context);\n\n    return { handled: true, aggregatedText };\n  }\n\n  private async runRegistryExecuteWithCapture(\n    args: string,\n    commandName: string,\n    context: CommandContext,\n  ): Promise<{ aggregatedText: string }> {\n    const segments: string[] = [];\n\n    const wrapped = createCommandContext({\n      sessionKey: context.sessionKey,\n      source: context.channel as 'telegram' | 'webui' | 'cli' | 'api' | 'system' | 'gateway',\n      channelId: context.channel,\n      chatId: context.chatId,\n      senderId: context.senderId,\n      isGroup: context.isGroup,\n      config: this.config,\n      bus: this.bus,\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      applySessionThinkingLevel: this.applySessionThinkingLevel,\n\n      replyHandler: async (text: string, _options?) => {\n        segments.push(text);\n        if (shouldSkipBusOutboundForChannel(context.channel)) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: text,\n          type: 'message',\n        });\n      },\n\n      typingHandler: async (typing: boolean) => {\n        if (shouldSkipBusOutboundForChannel(context.channel)) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          type: typing ? 'typing_on' : 'typing_off',\n        });\n      },\n\n      supportedFeatures: ['markdown', 'typing'],\n\n      getCurrentModel: this.getCurrentModel,\n\n      switchModel: async (modelId: string) => {\n        return this.switchModelForSession(context.sessionKey, modelId);\n      },\n\n      listModels: async () => {\n        const providers = getAllProviders();\n        const models: Array<{ id: string; name: string; provider: string }> = [];\n\n        for (const providerId of providers) {\n          if (isProviderConfiguredSync(providerId)) {\n            const providerModels = getModelsByProvider(providerId);\n            for (const m of providerModels) {\n              models.push({\n                id: `${m.provider}/${m.id}`,\n                name: m.name || m.id,\n                provider: getProviderDisplayName(providerId),\n              });\n            }\n          }\n        }\n\n        return models;\n      },\n\n      getUsage: async () => {\n        const messages = await this.sessionStore.load(context.sessionKey);\n        let promptTokens = 0;\n        let completionTokens = 0;\n\n        for (const msg of messages) {\n          if ('usage' in msg && msg.usage) {\n            const usage = msg.usage as { input?: number; output?: number };\n            promptTokens += usage.input || 0;\n            completionTokens += usage.output || 0;\n          }\n        }\n\n        return {\n          promptTokens,\n          completionTokens,\n          totalTokens: promptTokens + completionTokens,\n          messageCount: messages.length,\n        };\n      },\n\n      invalidateAgentSession: this.invalidateAgentSession,\n\n      abortCurrentTurn: this.abortSessionTurn\n        ? async () => {\n            await this.abortSessionTurn!(context.sessionKey);\n          }\n        : undefined,\n\n      compactSession: this.compactSession,\n      btwQuery: this.btwQuery,\n      getSessionContextReport: this.getSessionContextReport,\n      persistentGoalApis: this.getPersistentGoalApisForCommand({\n        sessionKey: context.sessionKey,\n        channel: context.channel,\n        chatId: context.chatId,\n        inboundMetadata: context.inboundMetadata,\n      }),\n    });\n\n    const result = await commandRegistry.execute(commandName, wrapped, args);\n\n    if (result.content) {\n      segments.push(result.content);\n      if (!shouldSkipBusOutboundForChannel(context.channel)) {\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: result.content,\n          type: 'message',\n        });\n      }\n    }\n\n    const aggregatedText = segments.filter((s) => s && s.trim()).join('\\n\\n');\n    return { aggregatedText };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-handler.js","names":[],"sources":["../../../../src/agent/messaging/command-handler.ts"],"sourcesContent":["/**\n * Command Handler - Parses and executes commands\n *\n * Handles command execution using the unified command system.\n */\n\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport type { ThinkLevel } from '../transcript/thinking-types.js';\nimport type { CompactionResult } from '../memory/compaction.js';\nimport { createLogger } from '../../utils/logger.js';\nimport {\n  commandRegistry,\n  createCommandContext,\n  type CommandContext as UnifiedCommandContext,\n} from '../../chat-commands/index.js';\nimport { getAllProviders, getModelsByProvider, getProviderDisplayName } from '../../providers/index.js';\nimport type { PersistentGoalApis } from '../goals/persistent-goal-apis.js';\n\nconst log = createLogger('CommandHandler');\n\n/** Gateway console direct stream uses SSE tokens; there is no ChannelPlugin outbound for `webchat`. */\nfunction shouldSkipBusOutboundForChannel(channel: string): boolean {\n  return channel === 'webchat';\n}\n\nexport interface CommandContext {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  senderId: string;\n  isGroup: boolean;\n  /** From inbound message metadata (thread/account, etc.) for `/goal` continuation routing. */\n  inboundMetadata?: Record<string, unknown>;\n}\n\nexport interface CommandHandlerConfig {\n  config: Config;\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  sessionConfigStore?: SessionConfigStore;\n  /** After /think persists, sync pi-agent */\n  applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  getCurrentModel: () => string;\n  switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  /** Drop in-memory agent after session file is cleared (e.g. /new) */\n  invalidateAgentSession?: (sessionKey: string) => void;\n  /** Cancel streaming preview + in-flight LLM work for this session (e.g. /abort) */\n  abortSessionTurn?: (sessionKey: string) => Promise<void>;\n\n  compactSession?: (\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ) => Promise<CompactionResult>;\n\n  btwQuery?: (sessionKey: string, question: string) => Promise<{ text: string; error?: string }>;\n\n  getSessionContextReport?: (\n    sessionKey: string,\n    mode: 'list' | 'detail' | 'json',\n  ) => Promise<string>;\n\n  getPersistentGoalApisForCommand: (routing: {\n    sessionKey: string;\n    channel: string;\n    chatId: string;\n    inboundMetadata?: Record<string, unknown>;\n  }) => PersistentGoalApis;\n}\n\nexport class CommandHandler {\n  private config: Config;\n  private bus: MessageBus;\n  private sessionStore: SessionStore;\n  private sessionConfigStore?: SessionConfigStore;\n  private applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  private getCurrentModel: () => string;\n  private switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  private invalidateAgentSession?: (sessionKey: string) => void;\n  private abortSessionTurn?: (sessionKey: string) => Promise<void>;\n  private compactSession?: CommandHandlerConfig['compactSession'];\n  private btwQuery?: CommandHandlerConfig['btwQuery'];\n  private getSessionContextReport?: CommandHandlerConfig['getSessionContextReport'];\n  private getPersistentGoalApisForCommand: CommandHandlerConfig['getPersistentGoalApisForCommand'];\n\n  constructor(handlerConfig: CommandHandlerConfig) {\n    this.config = handlerConfig.config;\n    this.bus = handlerConfig.bus;\n    this.sessionStore = handlerConfig.sessionStore;\n    this.sessionConfigStore = handlerConfig.sessionConfigStore;\n    this.applySessionThinkingLevel = handlerConfig.applySessionThinkingLevel;\n    this.getCurrentModel = handlerConfig.getCurrentModel;\n    this.switchModelForSession = handlerConfig.switchModelForSession;\n    this.invalidateAgentSession = handlerConfig.invalidateAgentSession;\n    this.abortSessionTurn = handlerConfig.abortSessionTurn;\n    this.compactSession = handlerConfig.compactSession;\n    this.btwQuery = handlerConfig.btwQuery;\n    this.getSessionContextReport = handlerConfig.getSessionContextReport;\n    this.getPersistentGoalApisForCommand = handlerConfig.getPersistentGoalApisForCommand;\n  }\n\n  /** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */\n  updateAgentConfig(config: Config): void {\n    this.config = config;\n  }\n\n  /**\n   * Build the unified command context shared by all execute paths.\n   * When `recorder` is set, every reply text is also captured (for SSE / CLI aggregation).\n   */\n  private buildCommandContext(\n    context: CommandContext,\n    recorder?: (text: string) => void,\n  ): UnifiedCommandContext {\n    const skipBusOutbound = shouldSkipBusOutboundForChannel(context.channel);\n\n    return createCommandContext({\n      sessionKey: context.sessionKey,\n      source: context.channel as 'telegram' | 'webui' | 'cli' | 'api' | 'system' | 'gateway',\n      channelId: context.channel,\n      chatId: context.chatId,\n      senderId: context.senderId,\n      isGroup: context.isGroup,\n      config: this.config,\n      bus: this.bus,\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      applySessionThinkingLevel: this.applySessionThinkingLevel,\n\n      replyHandler: async (text: string, _options?) => {\n        recorder?.(text);\n        if (skipBusOutbound) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: text,\n          type: 'message',\n        });\n      },\n\n      typingHandler: async (typing: boolean) => {\n        if (skipBusOutbound) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          type: typing ? 'typing_on' : 'typing_off',\n        });\n      },\n\n      supportedFeatures: ['markdown', 'typing'],\n\n      getCurrentModel: this.getCurrentModel,\n\n      switchModel: async (modelId: string) => {\n        return this.switchModelForSession(context.sessionKey, modelId);\n      },\n\n      listModels: async () => {\n        const providers = getAllProviders();\n        const models: Array<{ id: string; name: string; provider: string }> = [];\n\n        for (const providerId of providers) {\n          if (isProviderConfiguredSync(providerId)) {\n            const providerModels = getModelsByProvider(providerId);\n            for (const m of providerModels) {\n              models.push({\n                id: `${m.provider}/${m.id}`,\n                name: m.name || m.id,\n                provider: getProviderDisplayName(providerId),\n              });\n            }\n          }\n        }\n\n        return models;\n      },\n\n      getUsage: async () => {\n        const messages = await this.sessionStore.load(context.sessionKey);\n        let promptTokens = 0;\n        let completionTokens = 0;\n\n        for (const msg of messages) {\n          if ('usage' in msg && msg.usage) {\n            const usage = msg.usage as { input?: number; output?: number };\n            promptTokens += usage.input || 0;\n            completionTokens += usage.output || 0;\n          }\n        }\n\n        return {\n          promptTokens,\n          completionTokens,\n          totalTokens: promptTokens + completionTokens,\n          messageCount: messages.length,\n        };\n      },\n\n      invalidateAgentSession: this.invalidateAgentSession,\n\n      abortCurrentTurn: this.abortSessionTurn\n        ? async () => {\n            await this.abortSessionTurn!(context.sessionKey);\n          }\n        : undefined,\n\n      compactSession: this.compactSession,\n      btwQuery: this.btwQuery,\n      getSessionContextReport: this.getSessionContextReport,\n      persistentGoalApis: this.getPersistentGoalApisForCommand({\n        sessionKey: context.sessionKey,\n        channel: context.channel,\n        chatId: context.chatId,\n        inboundMetadata: context.inboundMetadata,\n      }),\n    });\n  }\n\n  /**\n   * Execute a command using the unified command system\n   */\n  async executeCommand(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<boolean> {\n    if (!commandRegistry.has(commandName)) {\n      return false;\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command via new system');\n\n    const cmdCtx = this.buildCommandContext(context);\n    const result = await commandRegistry.execute(commandName, cmdCtx, args);\n\n    if (result.content && !shouldSkipBusOutboundForChannel(context.channel)) {\n      await this.bus.publishOutbound({\n        channel: context.channel,\n        chat_id: context.chatId,\n        content: result.content,\n        type: 'message',\n      });\n    }\n\n    return true;\n  }\n\n  /**\n   * Run command and return all user-visible text (ctx.reply + result.content) for SSE/CLI.\n   * Same bus side effects as {@link executeCommand}.\n   */\n  async executeCommandAndAggregateReply(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<{ handled: boolean; aggregatedText: string }> {\n    if (!commandRegistry.has(commandName)) {\n      return { handled: false, aggregatedText: '' };\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command (aggregate reply)');\n\n    const segments: string[] = [];\n    const wrapped = this.buildCommandContext(context, (text) => segments.push(text));\n    const result = await commandRegistry.execute(commandName, wrapped, args);\n\n    if (result.content) {\n      segments.push(result.content);\n      if (!shouldSkipBusOutboundForChannel(context.channel)) {\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: result.content,\n          type: 'message',\n        });\n      }\n    }\n\n    const aggregatedText = segments.filter((s) => s && s.trim()).join('\\n\\n');\n    return { handled: true, aggregatedText };\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/messaging/index.d.ts

@@ -4,3 +4,4 @@
 export { MessageRouter, type MessageRoutingResult } from './message-router.js';
 export { CommandHandler, type CommandContext, type CommandHandlerConfig } from './command-handler.js';
 export { StreamManager, type StreamHandle } from './stream-manager.js';
+export { OutboundCoordinator, type OutboundCoordinatorConfig, type SessionTurnCompletePayload, } from './outbound-coordinator.js';

package/dist/src/agent/messaging/index.js

@@ -1,4 +1,5 @@
 import { MessageRouter } from "./message-router.js";
 import { CommandHandler } from "./command-handler.js";
 import { StreamManager } from "./stream-manager.js";
-export { CommandHandler, MessageRouter, StreamManager };
+import { OutboundCoordinator } from "./outbound-coordinator.js";
+export { CommandHandler, MessageRouter, OutboundCoordinator, StreamManager };

package/dist/src/agent/messaging/message-router.d.ts

@@ -4,7 +4,7 @@
  * Handles message classification, session key resolution, and routing logic.
  */
 import type { InboundMessage } from '../../infra/bus/index.js';
-import type { AgentContext } from '../service.js';
+import type { AgentContext } from '../service.types.js';
 export interface MessageRoutingResult {
     context: AgentContext;
     isCommand: boolean;

package/dist/src/agent/messaging/message-router.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-router.js","names":[],"sources":["../../../../src/agent/messaging/message-router.ts"],"sourcesContent":["/**\n * Message Router - Routes inbound messages to appropriate handlers\n *\n * Handles message classification, session key resolution, and routing logic.\n */\n\nimport type { InboundMessage } from '../../infra/bus/index.js';\nimport { parseSlashCommand } from '../../chat-commands/command-parse.js';\nimport type { AgentContext } from '../service.js';\n\nexport interface MessageRoutingResult {\n  context: AgentContext;\n  isCommand: boolean;\n  command?: string;\n  commandArgs?: string;\n}\n\nexport class MessageRouter {\n  /**\n   * Route an inbound message and determine handling strategy\n   */\n  async routeMessage(msg: InboundMessage): Promise<MessageRoutingResult> {\n    const sessionKey = this.resolveSessionKey(msg);\n\n    const context: AgentContext = {\n      channel: msg.channel,\n      chatId: msg.chat_id,\n      sessionKey,\n      senderId: (msg.metadata?.senderId as string) || msg.sender_id,\n      isGroup: (msg.metadata?.isGroup as boolean) || false,\n    };\n\n    const commandInfo = parseSlashCommand(msg.content);\n\n    return {\n      context,\n      isCommand: commandInfo !== null,\n      command: commandInfo?.command,\n      commandArgs: commandInfo?.args,\n    };\n  }\n\n  /**\n   * Resolve session key from message metadata or derive from channel/chat_id\n   */\n  private resolveSessionKey(msg: InboundMessage): string {\n    // Use sessionKey from metadata if available (for channels with custom session key format like Telegram)\n    if (msg.metadata?.sessionKey) {\n      return msg.metadata.sessionKey as string;\n    }\n\n    // For system messages, parse origin channel from chat_id\n    if (msg.channel === 'system') {\n      if (msg.chat_id.includes(':')) {\n        const [ch, ...rest] = msg.chat_id.split(':');\n        return `${ch}:${rest.join(':')}`;\n      }\n    }\n\n    // Default: combine channel and chat_id\n    return `${msg.channel}:${msg.chat_id}`;\n  }\n}\n"],"mappings":";;AAiBA,IAAa,gBAAb,MAA2B;;;;CAIzB,MAAM,aAAa,KAAoD;EACrE,MAAM,aAAa,KAAK,kBAAkB,IAAI;EAE9C,MAAM,UAAwB;GAC5B,SAAS,IAAI;GACb,QAAQ,IAAI;GACZ;GACA,UAAW,IAAI,UAAU,YAAuB,IAAI;GACpD,SAAU,IAAI,UAAU,WAAuB;GAChD;EAED,MAAM,cAAc,kBAAkB,IAAI,QAAQ;AAElD,SAAO;GACL;GACA,WAAW,gBAAgB;GAC3B,SAAS,aAAa;GACtB,aAAa,aAAa;GAC3B;;;;;CAMH,kBAA0B,KAA6B;AAErD,MAAI,IAAI,UAAU,WAChB,QAAO,IAAI,SAAS;AAItB,MAAI,IAAI,YAAY;OACd,IAAI,QAAQ,SAAS,IAAI,EAAE;IAC7B,MAAM,CAAC,IAAI,GAAG,QAAQ,IAAI,QAAQ,MAAM,IAAI;AAC5C,WAAO,GAAG,GAAG,GAAG,KAAK,KAAK,IAAI;;;AAKlC,SAAO,GAAG,IAAI,QAAQ,GAAG,IAAI"}
+{"version":3,"file":"message-router.js","names":[],"sources":["../../../../src/agent/messaging/message-router.ts"],"sourcesContent":["/**\n * Message Router - Routes inbound messages to appropriate handlers\n *\n * Handles message classification, session key resolution, and routing logic.\n */\n\nimport type { InboundMessage } from '../../infra/bus/index.js';\nimport { parseSlashCommand } from '../../chat-commands/command-parse.js';\nimport type { AgentContext } from '../service.types.js';\n\nexport interface MessageRoutingResult {\n  context: AgentContext;\n  isCommand: boolean;\n  command?: string;\n  commandArgs?: string;\n}\n\nexport class MessageRouter {\n  /**\n   * Route an inbound message and determine handling strategy\n   */\n  async routeMessage(msg: InboundMessage): Promise<MessageRoutingResult> {\n    const sessionKey = this.resolveSessionKey(msg);\n\n    const context: AgentContext = {\n      channel: msg.channel,\n      chatId: msg.chat_id,\n      sessionKey,\n      senderId: (msg.metadata?.senderId as string) || msg.sender_id,\n      isGroup: (msg.metadata?.isGroup as boolean) || false,\n    };\n\n    const commandInfo = parseSlashCommand(msg.content);\n\n    return {\n      context,\n      isCommand: commandInfo !== null,\n      command: commandInfo?.command,\n      commandArgs: commandInfo?.args,\n    };\n  }\n\n  /**\n   * Resolve session key from message metadata or derive from channel/chat_id\n   */\n  private resolveSessionKey(msg: InboundMessage): string {\n    // Use sessionKey from metadata if available (for channels with custom session key format like Telegram)\n    if (msg.metadata?.sessionKey) {\n      return msg.metadata.sessionKey as string;\n    }\n\n    // For system messages, parse origin channel from chat_id\n    if (msg.channel === 'system') {\n      if (msg.chat_id.includes(':')) {\n        const [ch, ...rest] = msg.chat_id.split(':');\n        return `${ch}:${rest.join(':')}`;\n      }\n    }\n\n    // Default: combine channel and chat_id\n    return `${msg.channel}:${msg.chat_id}`;\n  }\n}\n"],"mappings":";;AAiBA,IAAa,gBAAb,MAA2B;;;;CAIzB,MAAM,aAAa,KAAoD;EACrE,MAAM,aAAa,KAAK,kBAAkB,IAAI;EAE9C,MAAM,UAAwB;GAC5B,SAAS,IAAI;GACb,QAAQ,IAAI;GACZ;GACA,UAAW,IAAI,UAAU,YAAuB,IAAI;GACpD,SAAU,IAAI,UAAU,WAAuB;GAChD;EAED,MAAM,cAAc,kBAAkB,IAAI,QAAQ;AAElD,SAAO;GACL;GACA,WAAW,gBAAgB;GAC3B,SAAS,aAAa;GACtB,aAAa,aAAa;GAC3B;;;;;CAMH,kBAA0B,KAA6B;AAErD,MAAI,IAAI,UAAU,WAChB,QAAO,IAAI,SAAS;AAItB,MAAI,IAAI,YAAY;OACd,IAAI,QAAQ,SAAS,IAAI,EAAE;IAC7B,MAAM,CAAC,IAAI,GAAG,QAAQ,IAAI,QAAQ,MAAM,IAAI;AAC5C,WAAO,GAAG,GAAG,GAAG,KAAK,KAAK,IAAI;;;AAKlC,SAAO,GAAG,IAAI,QAAQ,GAAG,IAAI"}

package/dist/src/agent/messaging/outbound-coordinator.d.ts

@@ -0,0 +1,82 @@
+/**
+ * OutboundCoordinator — owns the post-turn outbound pipeline.
+ *
+ * Concentrates the responsibilities that used to be scattered across
+ * `AgentService`:
+ *  - typing-on / typing-off lifecycle for channels that surface "is typing…"
+ *  - final assistant response delivery (silence guard + hook + bus publish)
+ *  - cross-cutting `webchat_turn_complete` hook + `/goal` post-turn
+ *  - thin pass-through for extension `message_sending` / `message_sent` hooks
+ *
+ * The class is intentionally framework-agnostic: it pulls everything it needs
+ * via the constructor config (no direct AgentService reference), so it is
+ * unit-testable and lets the parent `AgentService` shrink to a coordinator.
+ */
+import type { MessageBus, InboundMessage } from '../../infra/bus/index.js';
+import type { Config } from '../../config/schema.js';
+import type { HookHandler } from '../lifecycle/hook-handler.js';
+import type { SessionContext } from '../session/index.js';
+import { type TypingController } from '../lifecycle/typing.js';
+import type { StreamManager } from './stream-manager.js';
+export interface OutboundCoordinatorConfig {
+    bus: MessageBus;
+    hookHandler: HookHandler;
+    streamManager: StreamManager;
+    /** Reads the effective config snapshot (honours runtime overrides). */
+    getConfig: () => Config | undefined;
+    /** Resolves the last visible assistant text for a session (in-memory + agent fallback). */
+    getLastAssistantPlainText: (sessionKey: string) => string;
+    /**
+     * Run the `/goal` post-turn verdict for a completed user turn. Owned by
+     * `PersistentGoalService`; OutboundCoordinator only forwards.
+     */
+    runPersistentGoalPostTurn: (payload: SessionTurnCompletePayload) => Promise<void>;
+}
+export interface SessionTurnCompletePayload {
+    sessionKey: string;
+    channel: string;
+    chatId: string;
+    inboundUserText: string;
+    assistantPlainText: string;
+    aborted: boolean;
+    streamError?: string;
+    skipPersistentGoalPostTurn?: boolean;
+    outboundMetadata?: Record<string, unknown>;
+}
+export declare class OutboundCoordinator {
+    private readonly bus;
+    private readonly hookHandler;
+    private readonly streamManager;
+    private readonly getConfig;
+    private readonly getLastAssistantPlainText;
+    private readonly runPersistentGoalPostTurn;
+    constructor(config: OutboundCoordinatorConfig);
+    /**
+     * Build the typing indicator controller for an inbound message. Returns
+     * `null` for the CLI channel (no typing UI). Caller is responsible for
+     * `start()` and `stop()` (`stop()` should run AFTER the final outbound so
+     * Telegram/Weixin see `typing_off` only once the message is delivered).
+     */
+    createTypingControllerForInbound(msg: InboundMessage): TypingController | null;
+    /**
+     * Publish the assistant's visible text as the final bus message. Honours the
+     * stream-manager "channel already streamed the final text" hint, the heartbeat
+     * silence guard, and the extension `message_sending` hook.
+     */
+    sendFinalResponse(msg: InboundMessage, sessionContext: SessionContext): Promise<void>;
+    /**
+     * Post-turn hook + `/goal` checklist evaluation. Wired into both the bus-driven
+     * inbound finally block and the webchat direct-stream finally. The goal verdict
+     * itself lives in `PersistentGoalService`; we just trigger the extension hook
+     * here and delegate the `/goal` work.
+     */
+    emitSessionTurnComplete(payload: SessionTurnCompletePayload): Promise<void>;
+    /** Extension hook pass-through (Gateway ChannelManager). */
+    invokeOutboundMessageSending(to: string, content: string, channel: string): Promise<{
+        send: boolean;
+        content?: string;
+        reason?: string;
+    }>;
+    /** Extension hook pass-through (Gateway ChannelManager). */
+    invokeOutboundMessageSent(to: string, content: string, success: boolean, error: string | undefined, channel: string): Promise<void>;
+}

package/dist/src/agent/messaging/outbound-coordinator.js

@@ -0,0 +1,123 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { createTypingController } from "../lifecycle/typing.js";
+import { shouldSilence } from "../../heartbeat/tokens.js";
+//#region src/agent/messaging/outbound-coordinator.ts
+init_logger();
+const log = createLogger("OutboundCoordinator");
+var OutboundCoordinator = class {
+	bus;
+	hookHandler;
+	streamManager;
+	getConfig;
+	getLastAssistantPlainText;
+	runPersistentGoalPostTurn;
+	constructor(config) {
+		this.bus = config.bus;
+		this.hookHandler = config.hookHandler;
+		this.streamManager = config.streamManager;
+		this.getConfig = config.getConfig;
+		this.getLastAssistantPlainText = config.getLastAssistantPlainText;
+		this.runPersistentGoalPostTurn = config.runPersistentGoalPostTurn;
+	}
+	/**
+	* Build the typing indicator controller for an inbound message. Returns
+	* `null` for the CLI channel (no typing UI). Caller is responsible for
+	* `start()` and `stop()` (`stop()` should run AFTER the final outbound so
+	* Telegram/Weixin see `typing_off` only once the message is delivered).
+	*/
+	createTypingControllerForInbound(msg) {
+		if (msg.channel === "cli") return null;
+		const meta = msg.metadata;
+		return createTypingController({
+			intervalSeconds: 5,
+			onStart: async () => {
+				await this.bus.publishOutbound({
+					channel: msg.channel,
+					chat_id: msg.chat_id,
+					content: "",
+					type: "typing_on",
+					metadata: {
+						accountId: meta?.accountId,
+						threadId: meta?.threadId,
+						sessionWebhook: meta?.sessionWebhook,
+						conversationId: meta?.conversationId
+					}
+				});
+			},
+			onStop: async () => {
+				await this.bus.publishOutbound({
+					channel: msg.channel,
+					chat_id: msg.chat_id,
+					content: "",
+					type: "typing_off",
+					metadata: {
+						accountId: meta?.accountId,
+						threadId: meta?.threadId,
+						sessionWebhook: meta?.sessionWebhook,
+						conversationId: meta?.conversationId
+					}
+				});
+			}
+		});
+	}
+	/**
+	* Publish the assistant's visible text as the final bus message. Honours the
+	* stream-manager "channel already streamed the final text" hint, the heartbeat
+	* silence guard, and the extension `message_sending` hook.
+	*/
+	async sendFinalResponse(msg, sessionContext) {
+		if (this.streamManager.consumeSkipFinalOutbound()) return;
+		const finalContent = this.getLastAssistantPlainText(sessionContext.sessionKey);
+		if (!finalContent?.trim()) return;
+		if (shouldSilence(finalContent, this.getConfig()?.gateway?.heartbeat?.ackMaxChars ?? 300) || finalContent.trim() === "NO_REPLY") {
+			log.debug({ sessionKey: sessionContext.sessionKey }, "Silent reply — skipping outbound");
+			return;
+		}
+		const hookResult = await this.hookHandler.runMessageSending(sessionContext.chatId, finalContent, sessionContext.channel);
+		if (!hookResult.send) return;
+		await this.bus.publishOutbound({
+			channel: sessionContext.channel,
+			chat_id: sessionContext.chatId,
+			content: hookResult.content || finalContent,
+			type: "message",
+			metadata: {
+				accountId: msg.metadata?.accountId,
+				threadId: msg.metadata?.threadId,
+				transcribedVoice: sessionContext.metadata?.transcribedVoice,
+				sessionWebhook: msg.metadata?.sessionWebhook,
+				conversationId: msg.metadata?.conversationId
+			}
+		});
+	}
+	/**
+	* Post-turn hook + `/goal` checklist evaluation. Wired into both the bus-driven
+	* inbound finally block and the webchat direct-stream finally. The goal verdict
+	* itself lives in `PersistentGoalService`; we just trigger the extension hook
+	* here and delegate the `/goal` work.
+	*/
+	async emitSessionTurnComplete(payload) {
+		await this.hookHandler.triggerWithSessionKey(payload.sessionKey, "webchat_turn_complete", {
+			sessionKey: payload.sessionKey,
+			channel: payload.channel,
+			chatId: payload.chatId,
+			inboundUserText: payload.inboundUserText,
+			assistantPlainText: payload.assistantPlainText,
+			aborted: payload.aborted,
+			...payload.streamError !== void 0 ? { streamError: payload.streamError } : {}
+		});
+		await this.runPersistentGoalPostTurn(payload);
+	}
+	/** Extension hook pass-through (Gateway ChannelManager). */
+	invokeOutboundMessageSending(to, content, channel) {
+		return this.hookHandler.runMessageSending(to, content, channel);
+	}
+	/** Extension hook pass-through (Gateway ChannelManager). */
+	invokeOutboundMessageSent(to, content, success, error, channel) {
+		return this.hookHandler.runMessageSent(to, content, success, error, channel);
+	}
+};
+//#endregion
+export { OutboundCoordinator };
+
+//# sourceMappingURL=outbound-coordinator.js.map

package/dist/src/agent/messaging/outbound-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-coordinator.js","names":[],"sources":["../../../../src/agent/messaging/outbound-coordinator.ts"],"sourcesContent":["/**\n * OutboundCoordinator — owns the post-turn outbound pipeline.\n *\n * Concentrates the responsibilities that used to be scattered across\n * `AgentService`:\n *  - typing-on / typing-off lifecycle for channels that surface \"is typing…\"\n *  - final assistant response delivery (silence guard + hook + bus publish)\n *  - cross-cutting `webchat_turn_complete` hook + `/goal` post-turn\n *  - thin pass-through for extension `message_sending` / `message_sent` hooks\n *\n * The class is intentionally framework-agnostic: it pulls everything it needs\n * via the constructor config (no direct AgentService reference), so it is\n * unit-testable and lets the parent `AgentService` shrink to a coordinator.\n */\n\nimport type { MessageBus, InboundMessage } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport type { HookHandler } from '../lifecycle/hook-handler.js';\nimport type { SessionContext } from '../session/index.js';\nimport { createTypingController, type TypingController } from '../lifecycle/typing.js';\nimport { DEFAULT_ACK_MAX_CHARS, NO_REPLY, shouldSilence } from '../../heartbeat/tokens.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { StreamManager } from './stream-manager.js';\n\nconst log = createLogger('OutboundCoordinator');\n\nexport interface OutboundCoordinatorConfig {\n  bus: MessageBus;\n  hookHandler: HookHandler;\n  streamManager: StreamManager;\n  /** Reads the effective config snapshot (honours runtime overrides). */\n  getConfig: () => Config | undefined;\n  /** Resolves the last visible assistant text for a session (in-memory + agent fallback). */\n  getLastAssistantPlainText: (sessionKey: string) => string;\n  /**\n   * Run the `/goal` post-turn verdict for a completed user turn. Owned by\n   * `PersistentGoalService`; OutboundCoordinator only forwards.\n   */\n  runPersistentGoalPostTurn: (payload: SessionTurnCompletePayload) => Promise<void>;\n}\n\nexport interface SessionTurnCompletePayload {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  inboundUserText: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn?: boolean;\n  outboundMetadata?: Record<string, unknown>;\n}\n\nexport class OutboundCoordinator {\n  private readonly bus: MessageBus;\n  private readonly hookHandler: HookHandler;\n  private readonly streamManager: StreamManager;\n  private readonly getConfig: () => Config | undefined;\n  private readonly getLastAssistantPlainText: (sessionKey: string) => string;\n  private readonly runPersistentGoalPostTurn: OutboundCoordinatorConfig['runPersistentGoalPostTurn'];\n\n  constructor(config: OutboundCoordinatorConfig) {\n    this.bus = config.bus;\n    this.hookHandler = config.hookHandler;\n    this.streamManager = config.streamManager;\n    this.getConfig = config.getConfig;\n    this.getLastAssistantPlainText = config.getLastAssistantPlainText;\n    this.runPersistentGoalPostTurn = config.runPersistentGoalPostTurn;\n  }\n\n  /**\n   * Build the typing indicator controller for an inbound message. Returns\n   * `null` for the CLI channel (no typing UI). Caller is responsible for\n   * `start()` and `stop()` (`stop()` should run AFTER the final outbound so\n   * Telegram/Weixin see `typing_off` only once the message is delivered).\n   */\n  createTypingControllerForInbound(msg: InboundMessage): TypingController | null {\n    if (msg.channel === 'cli') {\n      return null;\n    }\n    const meta = msg.metadata as Record<string, unknown> | undefined;\n    return createTypingController({\n      intervalSeconds: 5,\n      onStart: async () => {\n        await this.bus.publishOutbound({\n          channel: msg.channel,\n          chat_id: msg.chat_id,\n          content: '',\n          type: 'typing_on',\n          metadata: {\n            accountId: meta?.accountId,\n            threadId: meta?.threadId,\n            sessionWebhook: meta?.sessionWebhook,\n            conversationId: meta?.conversationId,\n          },\n        });\n      },\n      onStop: async () => {\n        await this.bus.publishOutbound({\n          channel: msg.channel,\n          chat_id: msg.chat_id,\n          content: '',\n          type: 'typing_off',\n          metadata: {\n            accountId: meta?.accountId,\n            threadId: meta?.threadId,\n            sessionWebhook: meta?.sessionWebhook,\n            conversationId: meta?.conversationId,\n          },\n        });\n      },\n    });\n  }\n\n  /**\n   * Publish the assistant's visible text as the final bus message. Honours the\n   * stream-manager \"channel already streamed the final text\" hint, the heartbeat\n   * silence guard, and the extension `message_sending` hook.\n   */\n  async sendFinalResponse(msg: InboundMessage, sessionContext: SessionContext): Promise<void> {\n    if (this.streamManager.consumeSkipFinalOutbound()) {\n      return;\n    }\n\n    const finalContent = this.getLastAssistantPlainText(sessionContext.sessionKey);\n    if (!finalContent?.trim()) {\n      return;\n    }\n\n    const ackMax = this.getConfig()?.gateway?.heartbeat?.ackMaxChars ?? DEFAULT_ACK_MAX_CHARS;\n    if (shouldSilence(finalContent, ackMax) || finalContent.trim() === NO_REPLY) {\n      log.debug({ sessionKey: sessionContext.sessionKey }, 'Silent reply — skipping outbound');\n      return;\n    }\n\n    const hookResult = await this.hookHandler.runMessageSending(\n      sessionContext.chatId,\n      finalContent,\n      sessionContext.channel,\n    );\n    if (!hookResult.send) {\n      return;\n    }\n\n    await this.bus.publishOutbound({\n      channel: sessionContext.channel,\n      chat_id: sessionContext.chatId,\n      content: hookResult.content || finalContent,\n      type: 'message',\n      metadata: {\n        accountId: msg.metadata?.accountId,\n        threadId: msg.metadata?.threadId,\n        transcribedVoice: sessionContext.metadata?.transcribedVoice,\n        sessionWebhook: msg.metadata?.sessionWebhook,\n        conversationId: msg.metadata?.conversationId,\n      },\n    });\n  }\n\n  /**\n   * Post-turn hook + `/goal` checklist evaluation. Wired into both the bus-driven\n   * inbound finally block and the webchat direct-stream finally. The goal verdict\n   * itself lives in `PersistentGoalService`; we just trigger the extension hook\n   * here and delegate the `/goal` work.\n   */\n  async emitSessionTurnComplete(payload: SessionTurnCompletePayload): Promise<void> {\n    await this.hookHandler.triggerWithSessionKey(payload.sessionKey, 'webchat_turn_complete', {\n      sessionKey: payload.sessionKey,\n      channel: payload.channel,\n      chatId: payload.chatId,\n      inboundUserText: payload.inboundUserText,\n      assistantPlainText: payload.assistantPlainText,\n      aborted: payload.aborted,\n      ...(payload.streamError !== undefined ? { streamError: payload.streamError } : {}),\n    });\n\n    await this.runPersistentGoalPostTurn(payload);\n  }\n\n  /** Extension hook pass-through (Gateway ChannelManager). */\n  invokeOutboundMessageSending(\n    to: string,\n    content: string,\n    channel: string,\n  ): Promise<{ send: boolean; content?: string; reason?: string }> {\n    return this.hookHandler.runMessageSending(to, content, channel);\n  }\n\n  /** Extension hook pass-through (Gateway ChannelManager). */\n  invokeOutboundMessageSent(\n    to: string,\n    content: string,\n    success: boolean,\n    error: string | undefined,\n    channel: string,\n  ): Promise<void> {\n    return this.hookHandler.runMessageSent(to, content, success, error, channel);\n  }\n}\n"],"mappings":";;;;;aAqBqD;AAGrD,MAAM,MAAM,aAAa,sBAAsB;AA6B/C,IAAa,sBAAb,MAAiC;CAC/B;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,QAAmC;AAC7C,OAAK,MAAM,OAAO;AAClB,OAAK,cAAc,OAAO;AAC1B,OAAK,gBAAgB,OAAO;AAC5B,OAAK,YAAY,OAAO;AACxB,OAAK,4BAA4B,OAAO;AACxC,OAAK,4BAA4B,OAAO;;;;;;;;CAS1C,iCAAiC,KAA8C;AAC7E,MAAI,IAAI,YAAY,MAClB,QAAO;EAET,MAAM,OAAO,IAAI;AACjB,SAAO,uBAAuB;GAC5B,iBAAiB;GACjB,SAAS,YAAY;AACnB,UAAM,KAAK,IAAI,gBAAgB;KAC7B,SAAS,IAAI;KACb,SAAS,IAAI;KACb,SAAS;KACT,MAAM;KACN,UAAU;MACR,WAAW,MAAM;MACjB,UAAU,MAAM;MAChB,gBAAgB,MAAM;MACtB,gBAAgB,MAAM;MACvB;KACF,CAAC;;GAEJ,QAAQ,YAAY;AAClB,UAAM,KAAK,IAAI,gBAAgB;KAC7B,SAAS,IAAI;KACb,SAAS,IAAI;KACb,SAAS;KACT,MAAM;KACN,UAAU;MACR,WAAW,MAAM;MACjB,UAAU,MAAM;MAChB,gBAAgB,MAAM;MACtB,gBAAgB,MAAM;MACvB;KACF,CAAC;;GAEL,CAAC;;;;;;;CAQJ,MAAM,kBAAkB,KAAqB,gBAA+C;AAC1F,MAAI,KAAK,cAAc,0BAA0B,CAC/C;EAGF,MAAM,eAAe,KAAK,0BAA0B,eAAe,WAAW;AAC9E,MAAI,CAAC,cAAc,MAAM,CACvB;AAIF,MAAI,cAAc,cADH,KAAK,WAAW,EAAE,SAAS,WAAW,eAAA,IACd,IAAI,aAAa,MAAM,KAAA,YAAe;AAC3E,OAAI,MAAM,EAAE,YAAY,eAAe,YAAY,EAAE,mCAAmC;AACxF;;EAGF,MAAM,aAAa,MAAM,KAAK,YAAY,kBACxC,eAAe,QACf,cACA,eAAe,QAChB;AACD,MAAI,CAAC,WAAW,KACd;AAGF,QAAM,KAAK,IAAI,gBAAgB;GAC7B,SAAS,eAAe;GACxB,SAAS,eAAe;GACxB,SAAS,WAAW,WAAW;GAC/B,MAAM;GACN,UAAU;IACR,WAAW,IAAI,UAAU;IACzB,UAAU,IAAI,UAAU;IACxB,kBAAkB,eAAe,UAAU;IAC3C,gBAAgB,IAAI,UAAU;IAC9B,gBAAgB,IAAI,UAAU;IAC/B;GACF,CAAC;;;;;;;;CASJ,MAAM,wBAAwB,SAAoD;AAChF,QAAM,KAAK,YAAY,sBAAsB,QAAQ,YAAY,yBAAyB;GACxF,YAAY,QAAQ;GACpB,SAAS,QAAQ;GACjB,QAAQ,QAAQ;GAChB,iBAAiB,QAAQ;GACzB,oBAAoB,QAAQ;GAC5B,SAAS,QAAQ;GACjB,GAAI,QAAQ,gBAAgB,KAAA,IAAY,EAAE,aAAa,QAAQ,aAAa,GAAG,EAAE;GAClF,CAAC;AAEF,QAAM,KAAK,0BAA0B,QAAQ;;;CAI/C,6BACE,IACA,SACA,SAC+D;AAC/D,SAAO,KAAK,YAAY,kBAAkB,IAAI,SAAS,QAAQ;;;CAIjE,0BACE,IACA,SACA,SACA,OACA,SACe;AACf,SAAO,KAAK,YAAY,eAAe,IAAI,SAAS,SAAS,OAAO,QAAQ"}

package/dist/src/agent/models/manager.js

@@ -1,6 +1,6 @@
-import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { getAllModels, getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
 import { resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed, maybeRetryTurnAfterTransientLlmFailure } from "../orchestration/llm-turn-retry.js";

package/dist/src/agent/orchestration/agent-event-handler.d.ts

@@ -1,8 +1,16 @@
 /**
- * Agent Event Handler - Handles all Agent lifecycle events
+ * Agent Event Handler — coordinates listeners on pi-agent events.
  *
- * Processes agent events and coordinates related actions like
- * progress updates, error tracking, and lifecycle events.
+ * Previously a single god-handler with ten manager fields and one `switch`. Now a
+ * thin façade around {@link SessionEventBus}: each concern (progress, lifecycle
+ * hooks, tool-chain recording, error tracking, self-verify, etc.) registers its
+ * own listener at construction time, and external code can add new listeners via
+ * {@link AgentEventHandler.registerListener} without modifying this file (OCP).
+ *
+ * Ordering note: a few listeners are order-sensitive (notably the
+ * `tool_execution_end` chain — `SystemReminder` mutates `event.result` in place
+ * and downstream listeners read the mutated value). The `installX` calls below
+ * preserve the exact order from the previous implementation.
  */
 import type { AgentEvent } from '@earendil-works/pi-agent-core';
 import type { SessionContext } from '../session/session-context.js';
@@ -15,7 +23,18 @@ import type { SelfVerifyMiddleware } from '../middleware/index.js';
 import type { SystemReminder } from '../prompt/system-reminder.js';
 import type { ToolUsageAnalyzer } from '../tools/usage-analyzer.js';
 import type { ErrorPatternMatcher } from '../tools/error-pattern-matcher.js';
-import type { ModelManager } from '../models/index.js';
+export type SessionEventListener = (event: AgentEvent, context: SessionContext) => void;
+export type SessionEventTypeFilter = AgentEvent['type'] | 'all';
+/**
+ * Typed pub/sub for agent events. Listeners run in registration order; the bus
+ * itself is synchronous — listeners that need async work must dispatch their own
+ * promises (typically by awaiting and logging on error, like the lifecycle hooks).
+ */
+export declare class SessionEventBus {
+    private readonly listeners;
+    on(type: SessionEventTypeFilter, listener: SessionEventListener): () => void;
+    dispatch(event: AgentEvent, context: SessionContext | null): void;
+}
 export interface AgentEventHandlerConfig {
     progressManager: ProgressFeedbackManager;
     errorTracker: ToolErrorTracker;
@@ -26,39 +45,23 @@ export interface AgentEventHandlerConfig {
     systemReminder: SystemReminder;
     toolUsageAnalyzer: ToolUsageAnalyzer;
     errorPatternMatcher: ErrorPatternMatcher;
-    modelManager: ModelManager;
 }
+/**
+ * Thin façade over {@link SessionEventBus} that pre-registers all built-in
+ * listeners in their required order. `handle(event, ctx)` is the entry point
+ * used by `AgentService.handleSessionEvent`; extensions can hook in via
+ * {@link registerListener} without touching this class.
+ */
 export declare class AgentEventHandler {
-    private progressManager;
-    private errorTracker;
-    private requestLimiter;
-    private lifecycleManager;
-    private toolChainTracker;
-    private selfVerifyMiddleware;
-    private systemReminder;
-    private toolUsageAnalyzer;
-    private errorPatternMatcher;
-    private modelManager;
-    private taskStartTime;
+    private readonly bus;
     constructor(config: AgentEventHandlerConfig);
-    /**
-     * Handle an agent event
-     */
+    /** Dispatch a pi-agent event to all registered listeners. */
     handle(event: AgentEvent, context: SessionContext | null): void;
-    private handleAgentStart;
-    private handleTurnStart;
-    private handleMessageStart;
-    private handleMessageEnd;
-    private handleToolExecutionStart;
-    private handleToolExecutionUpdate;
-    private handleToolExecutionEnd;
-    private handleTurnEnd;
-    private handleAgentEnd;
-    private trackFileEdit;
-    private recordToolResult;
-    private extractError;
     /**
-     * Get task duration in milliseconds
+     * Register an additional listener (e.g. from an extension). Returns an
+     * unsubscribe function. Listeners run after the built-ins in registration
+     * order; if you need to run before a built-in, you must create your own
+     * {@link SessionEventBus} instance.
      */
-    getTaskDuration(): number;
+    registerListener(type: SessionEventTypeFilter, listener: SessionEventListener): () => void;
 }