@xopcai/xopc 0.0.103 → 0.0.104

package/dist/src/channels/catalog/channel-catalog-service.d.ts

@@ -0,0 +1,11 @@
+import type { Config } from '../../config/schema.js';
+import type { ExtensionMetadataSnapshot } from '../../extensions/extension-metadata-snapshot.js';
+import type { ChannelCatalog } from './channel-catalog-types.js';
+type BuildChannelCatalogOptions = {
+    locale?: string;
+};
+export declare function buildChannelCatalogFromSnapshot(snapshot: ExtensionMetadataSnapshot, options?: BuildChannelCatalogOptions): ChannelCatalog;
+export declare function buildChannelCatalogForConfig(config: Config, options?: BuildChannelCatalogOptions): ChannelCatalog;
+export declare function isChannelConfigured(config: Config, channelId: string): boolean;
+export declare function getConfiguredChannelIds(config: Config): string[];
+export {};

package/dist/src/channels/catalog/channel-catalog-service.js

@@ -0,0 +1,168 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { buildExtensionMetadataSnapshot, init_extension_metadata_snapshot, resolveExtensionLoaderOptionsFromConfig } from "../../extensions/extension-metadata-snapshot.js";
+//#region src/channels/catalog/channel-catalog-service.ts
+function normalizeChannelId(raw) {
+	return raw.trim().toLowerCase();
+}
+function normalizeLocale(raw) {
+	return raw?.trim().toLowerCase().replace("_", "-") || void 0;
+}
+function localeCandidates(raw) {
+	const locale = normalizeLocale(raw);
+	if (!locale) return [];
+	const base = locale.split("-")[0];
+	return base && base !== locale ? [locale, base] : [locale];
+}
+function normalizeConfigPath(channelId, raw) {
+	const expected = `channels.${channelId}`;
+	if (!raw) return expected;
+	const trimmed = raw.trim();
+	if (!trimmed.startsWith("channels.")) return expected;
+	return trimmed;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasNonEmptyString(value) {
+	return typeof value === "string" && value.trim().length > 0;
+}
+function hasConfiguredTelegramCredential(raw) {
+	if (!isRecord(raw)) return false;
+	const accounts = raw.accounts;
+	if (!isRecord(accounts)) return false;
+	return Object.values(accounts).some((account) => {
+		if (!isRecord(account) || account.enabled === false) return false;
+		return hasNonEmptyString(account.botToken) || hasNonEmptyString(account.tokenFile);
+	});
+}
+function hasConfiguredWeixinAccount(raw) {
+	if (!isRecord(raw)) return false;
+	if (raw.enabled === true) return true;
+	const accounts = raw.accounts;
+	if (!isRecord(accounts)) return false;
+	return Object.values(accounts).some((account) => isRecord(account) && account.enabled !== false);
+}
+function withoutUndefined(value) {
+	return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== void 0));
+}
+function mergeObjectMap(base, override) {
+	if (!base && !override) return void 0;
+	if (!base) return override ? withoutUndefined(override) : void 0;
+	if (!override) return base;
+	const out = { ...base };
+	for (const [key, value] of Object.entries(override)) {
+		if (value === void 0) continue;
+		out[key] = isRecord(out[key]) && isRecord(value) ? {
+			...out[key],
+			...withoutUndefined(value)
+		} : value;
+	}
+	return out;
+}
+function mergeRecordDeep(base, override) {
+	const out = { ...base };
+	for (const [key, value] of Object.entries(override)) {
+		if (value === void 0) continue;
+		out[key] = isRecord(out[key]) && isRecord(value) ? mergeRecordDeep(out[key], value) : value;
+	}
+	return out;
+}
+function mergeJsonSchema(base, override) {
+	if (!base && !override) return void 0;
+	if (!base) return override ? withoutUndefined(override) : void 0;
+	if (!override) return base;
+	return mergeRecordDeep(base, override);
+}
+function mergeChannelUi(base, override) {
+	if (!base && !override) return void 0;
+	return {
+		...base ?? {},
+		...override ?? {},
+		card: mergeObjectMap(base?.card, override?.card),
+		modal: mergeObjectMap(base?.modal, override?.modal)
+	};
+}
+function localizeContribution(contribution, locale) {
+	const i18n = contribution.i18n;
+	if (!i18n) return contribution;
+	const override = localeCandidates(locale).map((key) => i18n[key]).find(Boolean);
+	if (!override) return contribution;
+	return {
+		...contribution,
+		label: override.label ?? contribution.label,
+		description: override.description ?? contribution.description,
+		configSchema: mergeJsonSchema(contribution.configSchema, override.configSchema),
+		uiHints: mergeObjectMap(contribution.uiHints, override.uiHints),
+		actions: mergeObjectMap(contribution.actions, override.actions),
+		ui: mergeChannelUi(contribution.ui, override.ui)
+	};
+}
+function toCatalogEntry(params) {
+	const contribution = localizeContribution(params.contribution, params.locale);
+	const id = normalizeChannelId(params.channelId);
+	return {
+		id,
+		extensionId: params.extension.id,
+		source: params.extension.source,
+		path: params.extension.path,
+		label: contribution.label,
+		description: contribution.description,
+		docsPath: contribution.docsPath,
+		order: contribution.order ?? 999,
+		configPath: normalizeConfigPath(id, contribution.configPath),
+		capabilities: contribution.capabilities ?? {},
+		configSchema: contribution.configSchema ?? DEFAULT_CONFIG_SCHEMA,
+		uiHints: contribution.uiHints ?? {},
+		actions: contribution.actions ?? {},
+		ui: contribution.ui
+	};
+}
+function buildChannelCatalogFromSnapshot(snapshot, options = {}) {
+	const byId = /* @__PURE__ */ new Map();
+	for (const extension of snapshot.manifestRegistry.getAllEntries()) {
+		const contributions = extension.manifest.channelContributions ?? {};
+		for (const [channelId, contribution] of Object.entries(contributions)) {
+			const entry = toCatalogEntry({
+				extension,
+				channelId,
+				contribution,
+				locale: options.locale
+			});
+			byId.set(entry.id, entry);
+		}
+	}
+	return {
+		entries: Array.from(byId.values()).toSorted((a, b) => {
+			if (a.order !== b.order) return a.order - b.order;
+			return a.id.localeCompare(b.id);
+		}),
+		byId
+	};
+}
+function buildChannelCatalogForConfig(config, options = {}) {
+	return buildChannelCatalogFromSnapshot(buildExtensionMetadataSnapshot(resolveExtensionLoaderOptionsFromConfig(config), config), options);
+}
+function isChannelConfigured(config, channelId) {
+	const id = normalizeChannelId(channelId);
+	const raw = config.channels?.[id];
+	if (!raw) return false;
+	if (id === "telegram") return hasConfiguredTelegramCredential(raw);
+	if (id === "weixin") return hasConfiguredWeixinAccount(raw);
+	return isRecord(raw) ? raw.enabled === true || Object.keys(raw).length > 0 : true;
+}
+function getConfiguredChannelIds(config) {
+	return Object.keys(config.channels ?? {}).map(normalizeChannelId).filter((id) => id && isChannelConfigured(config, id));
+}
+var DEFAULT_CONFIG_SCHEMA;
+var init_channel_catalog_service = __esmMin((() => {
+	init_extension_metadata_snapshot();
+	DEFAULT_CONFIG_SCHEMA = {
+		type: "object",
+		additionalProperties: true
+	};
+}));
+//#endregion
+init_channel_catalog_service();
+export { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, getConfiguredChannelIds, init_channel_catalog_service, isChannelConfigured };
+
+//# sourceMappingURL=channel-catalog-service.js.map

package/dist/src/channels/catalog/channel-catalog-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-catalog-service.js","names":[],"sources":["../../../../src/channels/catalog/channel-catalog-service.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport {\n  buildExtensionMetadataSnapshot,\n  resolveExtensionLoaderOptionsFromConfig,\n} from '../../extensions/extension-metadata-snapshot.js';\nimport type { ExtensionMetadataSnapshot } from '../../extensions/extension-metadata-snapshot.js';\nimport type { ManifestRegistryEntry } from '../../extensions/manifest-registry.js';\nimport type { ChannelContributionDeclaration } from '../../extensions/types/manifest.js';\n\nimport type { ChannelCatalog, ChannelCatalogEntry } from './channel-catalog-types.js';\n\ntype BuildChannelCatalogOptions = {\n  locale?: string;\n};\n\nconst DEFAULT_CONFIG_SCHEMA: Record<string, unknown> = {\n  type: 'object',\n  additionalProperties: true,\n};\n\nfunction normalizeChannelId(raw: string): string {\n  return raw.trim().toLowerCase();\n}\n\nfunction normalizeLocale(raw: string | undefined): string | undefined {\n  const value = raw?.trim().toLowerCase().replace('_', '-');\n  return value || undefined;\n}\n\nfunction localeCandidates(raw: string | undefined): string[] {\n  const locale = normalizeLocale(raw);\n  if (!locale) return [];\n  const base = locale.split('-')[0];\n  return base && base !== locale ? [locale, base] : [locale];\n}\n\nfunction normalizeConfigPath(channelId: string, raw: string | undefined): `channels.${string}` {\n  const expected = `channels.${channelId}` as const;\n  if (!raw) return expected;\n  const trimmed = raw.trim();\n  if (!trimmed.startsWith('channels.')) return expected;\n  return trimmed as `channels.${string}`;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction hasNonEmptyString(value: unknown): boolean {\n  return typeof value === 'string' && value.trim().length > 0;\n}\n\nfunction hasConfiguredTelegramCredential(raw: unknown): boolean {\n  if (!isRecord(raw)) return false;\n  const accounts = raw.accounts;\n  if (!isRecord(accounts)) return false;\n  return Object.values(accounts).some((account) => {\n    if (!isRecord(account) || account.enabled === false) return false;\n    return hasNonEmptyString(account.botToken) || hasNonEmptyString(account.tokenFile);\n  });\n}\n\nfunction hasConfiguredWeixinAccount(raw: unknown): boolean {\n  if (!isRecord(raw)) return false;\n  if (raw.enabled === true) return true;\n  const accounts = raw.accounts;\n  if (!isRecord(accounts)) return false;\n  return Object.values(accounts).some((account) => isRecord(account) && account.enabled !== false);\n}\n\nfunction withoutUndefined(value: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));\n}\n\nfunction mergeObjectMap<T extends Record<string, unknown>>(base: T | undefined, override: T | undefined): T | undefined {\n  if (!base && !override) return undefined;\n  if (!base) return override ? withoutUndefined(override) as T : undefined;\n  if (!override) return base;\n  const out: Record<string, unknown> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (value === undefined) continue;\n    out[key] = isRecord(out[key]) && isRecord(value)\n      ? { ...out[key], ...withoutUndefined(value) }\n      : value;\n  }\n  return out as T;\n}\n\nfunction mergeRecordDeep(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (value === undefined) continue;\n    out[key] = isRecord(out[key]) && isRecord(value)\n      ? mergeRecordDeep(out[key], value)\n      : value;\n  }\n  return out;\n}\n\nfunction mergeJsonSchema(base: Record<string, unknown> | undefined, override: Record<string, unknown> | undefined) {\n  if (!base && !override) return undefined;\n  if (!base) return override ? withoutUndefined(override) : undefined;\n  if (!override) return base;\n  return mergeRecordDeep(base, override);\n}\n\nfunction mergeChannelUi(\n  base: ChannelContributionDeclaration['ui'],\n  override: ChannelContributionDeclaration['ui'],\n): ChannelContributionDeclaration['ui'] {\n  if (!base && !override) return undefined;\n  return {\n    ...(base ?? {}),\n    ...(override ?? {}),\n    card: mergeObjectMap(base?.card, override?.card),\n    modal: mergeObjectMap(base?.modal, override?.modal),\n  };\n}\n\nfunction localizeContribution(\n  contribution: ChannelContributionDeclaration,\n  locale: string | undefined,\n): ChannelContributionDeclaration {\n  const i18n = contribution.i18n;\n  if (!i18n) return contribution;\n  const override = localeCandidates(locale).map((key) => i18n[key]).find(Boolean);\n  if (!override) return contribution;\n  return {\n    ...contribution,\n    label: override.label ?? contribution.label,\n    description: override.description ?? contribution.description,\n    configSchema: mergeJsonSchema(contribution.configSchema, override.configSchema),\n    uiHints: mergeObjectMap(contribution.uiHints, override.uiHints),\n    actions: mergeObjectMap(contribution.actions, override.actions),\n    ui: mergeChannelUi(contribution.ui, override.ui),\n  };\n}\n\nfunction toCatalogEntry(params: {\n  extension: ManifestRegistryEntry;\n  channelId: string;\n  contribution: ChannelContributionDeclaration;\n  locale?: string;\n}): ChannelCatalogEntry {\n  const contribution = localizeContribution(params.contribution, params.locale);\n  const id = normalizeChannelId(params.channelId);\n  return {\n    id,\n    extensionId: params.extension.id,\n    source: params.extension.source,\n    path: params.extension.path,\n    label: contribution.label,\n    description: contribution.description,\n    docsPath: contribution.docsPath,\n    order: contribution.order ?? 999,\n    configPath: normalizeConfigPath(id, contribution.configPath),\n    capabilities: contribution.capabilities ?? {},\n    configSchema: contribution.configSchema ?? DEFAULT_CONFIG_SCHEMA,\n    uiHints: contribution.uiHints ?? {},\n    actions: contribution.actions ?? {},\n    ui: contribution.ui,\n  };\n}\n\nexport function buildChannelCatalogFromSnapshot(\n  snapshot: ExtensionMetadataSnapshot,\n  options: BuildChannelCatalogOptions = {},\n): ChannelCatalog {\n  const byId = new Map<string, ChannelCatalogEntry>();\n  for (const extension of snapshot.manifestRegistry.getAllEntries()) {\n    const contributions = extension.manifest.channelContributions ?? {};\n    for (const [channelId, contribution] of Object.entries(contributions)) {\n      const entry = toCatalogEntry({ extension, channelId, contribution, locale: options.locale });\n      byId.set(entry.id, entry);\n    }\n  }\n  const entries = Array.from(byId.values()).toSorted((a, b) => {\n    if (a.order !== b.order) return a.order - b.order;\n    return a.id.localeCompare(b.id);\n  });\n  return { entries, byId };\n}\n\nexport function buildChannelCatalogForConfig(config: Config, options: BuildChannelCatalogOptions = {}): ChannelCatalog {\n  const snapshot = buildExtensionMetadataSnapshot(resolveExtensionLoaderOptionsFromConfig(config), config);\n  return buildChannelCatalogFromSnapshot(snapshot, options);\n}\n\nexport function isChannelConfigured(config: Config, channelId: string): boolean {\n  const id = normalizeChannelId(channelId);\n  const raw = (config.channels as Record<string, unknown> | undefined)?.[id];\n  if (!raw) return false;\n  if (id === 'telegram') return hasConfiguredTelegramCredential(raw);\n  if (id === 'weixin') return hasConfiguredWeixinAccount(raw);\n  return isRecord(raw) ? raw.enabled === true || Object.keys(raw).length > 0 : true;\n}\n\nexport function getConfiguredChannelIds(config: Config): string[] {\n  return Object.keys(config.channels ?? {})\n    .map(normalizeChannelId)\n    .filter((id) => id && isChannelConfigured(config, id));\n}\n"],"mappings":"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"}

package/dist/src/channels/catalog/channel-catalog-types.d.ts

@@ -0,0 +1,22 @@
+import type { ChannelActionDescriptor, ChannelConfigUiHint, ChannelContributionCapabilities, ChannelContributionUiDeclaration } from '../../extensions/types/manifest.js';
+export type ChannelCatalogSource = 'workspace' | 'global' | 'bundled' | 'config';
+export interface ChannelCatalogEntry {
+    id: string;
+    extensionId: string;
+    source: ChannelCatalogSource;
+    path: string;
+    label: string;
+    description?: string;
+    docsPath?: string;
+    order: number;
+    configPath: `channels.${string}`;
+    capabilities: ChannelContributionCapabilities;
+    configSchema: Record<string, unknown>;
+    uiHints: Record<string, ChannelConfigUiHint>;
+    actions: Record<string, ChannelActionDescriptor>;
+    ui?: ChannelContributionUiDeclaration;
+}
+export interface ChannelCatalog {
+    entries: ChannelCatalogEntry[];
+    byId: Map<string, ChannelCatalogEntry>;
+}

package/dist/src/channels/catalog/channel-catalog-types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/channels/dock.d.ts

@@ -1,9 +1,4 @@
-/**
- * Lightweight channel surface for gateway/UI/shared code without importing
- * GrammY or full plugin implementations (channel dock pattern).
- */
 import type { ChannelCapabilities } from './plugin-types.js';
-import { type ChatChannelId } from './registry.js';
 export interface ChannelDock {
     id: string;
     label: string;
@@ -16,5 +11,3 @@ export interface ChannelDock {
         debounceMs?: number;
     };
 }
-export declare function getChannelDock(channelId: string): ChannelDock | undefined;
-export declare function getDockForBuiltinChannel(id: ChatChannelId): ChannelDock;

package/dist/src/channels/dock.js

@@ -1,21 +1 @@
-import { getChatChannelMeta, isChatChannelId } from "./registry.js";
-//#region src/channels/dock.ts
-function getChannelDock(channelId) {
-	if (!isChatChannelId(channelId)) return;
-	const meta = getChatChannelMeta(channelId);
-	return {
-		id: meta.id,
-		label: meta.label,
-		description: meta.description,
-		capabilities: meta.capabilities,
-		...meta.dock?.outbound && { outbound: meta.dock.outbound },
-		...meta.dock?.queue && { queue: meta.dock.queue }
-	};
-}
-function getDockForBuiltinChannel(id) {
-	return getChannelDock(id);
-}
-//#endregion
-export { getChannelDock, getDockForBuiltinChannel };
-
-//# sourceMappingURL=dock.js.map
+export {};

package/dist/src/channels/index.d.ts

@@ -4,13 +4,11 @@
  * Exports shared channel infrastructure (plugins, pipeline, registry).
  */
 export * from './channel-domain.js';
-export { CHAT_CHANNEL_ORDER, getChatChannelMeta, isChatChannelId, listChatChannelMeta, type ChatChannelId, type ChatChannelMeta, } from './registry.js';
-export { getChannelDock, getDockForBuiltinChannel, type ChannelDock } from './dock.js';
+export { type ChannelDock } from './dock.js';
 export type { ChannelPlugin, ChannelPluginDefaults, ChannelPluginInitOptions, ChannelPluginSessionModelHooks, ChannelPluginReloadMeta, ChannelPluginStartOptions, ChannelOutboundContext, ChannelOutboundPayloadContext, OutboundDeliveryResult, ChannelStreamHandle, ChannelStatusAdapter, ChannelSecurityAdapter, ChannelConfigAdapter, ChannelStreamingAdapter, ChannelCapabilities, ChannelMeta, ChannelAccountSnapshot, StreamMode, ChannelOutboundMediaType, } from './plugin-types.js';
 export { compileAllowlist, resolveAllowlistMatch, resolveAllowlistMatchSimple, evaluateAccess, resolveDmPolicy, resolveGroupPolicy, hasBotMention, removeBotMention, } from './security.js';
 export { MessagePipeline, createPipeline, createEnvelopeTimestampHandler, createFilterSelfHandler, createFilterEmptyHandler, createFilterCommandsHandler, standardPreflightHandlers, standardProcessHandlers, type PipelineMessageContext, type PipelineMediaRef, type PreflightHandler, type ProcessHandler, type DeliveryHandler, type AgentResponse, } from './pipeline.js';
 export { ChannelManager, createChannelManager, type OutboundChannelHooks } from './manager.js';
 export { collectSetupWizardChannels } from './setup-wizard-discovery.js';
 export { listChannelPlugins, getChannelPlugin, getChannelRegistryVersion, syncChannelPluginsFromManager, } from './plugins/registry.js';
-export { bundledChannelPlugins } from './plugins/bundled.js';
 export * from './format.js';

package/dist/src/channels/index.js

@@ -1,18 +1,14 @@
 import { parseFrontmatterBlock } from "../markdown/frontmatter.js";
 import { getChannelPlugin, getChannelRegistryVersion, listChannelPlugins, syncChannelPluginsFromManager } from "./plugins/registry.js";
 import { compileAllowlist, evaluateAccess, hasBotMention, removeBotMention, resolveAllowlistMatch, resolveAllowlistMatchSimple, resolveDmPolicy, resolveGroupPolicy } from "./security.js";
-import { CHAT_CHANNEL_ORDER, getChatChannelMeta, isChatChannelId, listChatChannelMeta } from "./registry.js";
 import { findFenceSpanAt, isSafeFenceBreak, parseFenceSpans } from "../markdown/fences.js";
 import { chunkText } from "../markdown/chunk.js";
 import { chunkMarkdownIR, markdownToIR, markdownToIRWithMeta } from "../markdown/ir.js";
 import { renderMarkdownWithMarkers } from "../markdown/render.js";
 import { convertMarkdownTables } from "../markdown/tables.js";
 import { buildCodeSpanIndex, createInlineCodeState } from "../markdown/code-spans.js";
-import { bundledChannelPlugins } from "../generated/bundled-channel-plugins.js";
-import "./plugins/bundled.js";
-import { getChannelDock, getDockForBuiltinChannel } from "./dock.js";
 import "./format.js";
 import { MessagePipeline, createEnvelopeTimestampHandler, createFilterCommandsHandler, createFilterEmptyHandler, createFilterSelfHandler, createPipeline, standardPreflightHandlers, standardProcessHandlers } from "./pipeline.js";
 import { ChannelManager, createChannelManager } from "./manager.js";
 import { collectSetupWizardChannels } from "./setup-wizard-discovery.js";
-export { CHAT_CHANNEL_ORDER, ChannelManager, MessagePipeline, buildCodeSpanIndex, bundledChannelPlugins, chunkMarkdownIR, chunkText, collectSetupWizardChannels, compileAllowlist, convertMarkdownTables, createChannelManager, createEnvelopeTimestampHandler, createFilterCommandsHandler, createFilterEmptyHandler, createFilterSelfHandler, createInlineCodeState, createPipeline, evaluateAccess, findFenceSpanAt, getChannelDock, getChannelPlugin, getChannelRegistryVersion, getChatChannelMeta, getDockForBuiltinChannel, hasBotMention, isChatChannelId, isSafeFenceBreak, listChannelPlugins, listChatChannelMeta, markdownToIR, markdownToIRWithMeta, parseFenceSpans, parseFrontmatterBlock, removeBotMention, renderMarkdownWithMarkers, resolveAllowlistMatch, resolveAllowlistMatchSimple, resolveDmPolicy, resolveGroupPolicy, standardPreflightHandlers, standardProcessHandlers, syncChannelPluginsFromManager };
+export { ChannelManager, MessagePipeline, buildCodeSpanIndex, chunkMarkdownIR, chunkText, collectSetupWizardChannels, compileAllowlist, convertMarkdownTables, createChannelManager, createEnvelopeTimestampHandler, createFilterCommandsHandler, createFilterEmptyHandler, createFilterSelfHandler, createInlineCodeState, createPipeline, evaluateAccess, findFenceSpanAt, getChannelPlugin, getChannelRegistryVersion, hasBotMention, isSafeFenceBreak, listChannelPlugins, markdownToIR, markdownToIRWithMeta, parseFenceSpans, parseFrontmatterBlock, removeBotMention, renderMarkdownWithMarkers, resolveAllowlistMatch, resolveAllowlistMatchSimple, resolveDmPolicy, resolveGroupPolicy, standardPreflightHandlers, standardProcessHandlers, syncChannelPluginsFromManager };

package/dist/src/channels/lifecycle-supervisor.d.ts

@@ -55,6 +55,7 @@ export declare class ChannelLifecycleSupervisor {
     /** Channel ids that would run and declare `meta.deferConnectUntilAfterListen` (for logging / metrics). */
     listDeferConnectChannelIds(cfg: Config): string[];
     initialize(): Promise<void>;
+    initializeChannel(channelId: string): Promise<boolean>;
     /** Phase 1: start every enabled channel except those in `deferConnectPluginIds`. */
     start(options?: {
         deferConnectPluginIds?: ReadonlySet<string>;

package/dist/src/channels/lifecycle-supervisor.js

@@ -58,6 +58,17 @@ var ChannelLifecycleSupervisor = class {
 		this.initialized = true;
 		log.info("All channel plugins initialized");
 	}
+	async initializeChannel(channelId) {
+		const plugin = this.opts.registry.get(channelId);
+		if (!plugin) {
+			log.warn({ channel: channelId }, "Unknown channel");
+			return false;
+		}
+		if (this.initializedPluginIds.has(channelId)) return true;
+		const cfg = this.opts.getConfig();
+		await this.initializePlugin(plugin, asChannelConfig(cfg.channels?.[channelId]) ?? {});
+		return this.initializedPluginIds.has(channelId);
+	}
 	/** Phase 1: start every enabled channel except those in `deferConnectPluginIds`. */
 	async start(options) {
 		if (!this.initialized) throw new Error("Channels not initialized");

package/dist/src/channels/lifecycle-supervisor.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-supervisor.js","names":[],"sources":["../../../src/channels/lifecycle-supervisor.ts"],"sourcesContent":["/**\n * ChannelLifecycleSupervisor — owns the start/stop/restart state machine for\n * every channel plugin.\n *\n * Concerns:\n *   - `initialize()` — call each plugin's `init(...)` once and remember success\n *   - Two-phase `start()` + `startDeferredConnects()` for channels whose\n *     `meta.deferConnectUntilAfterListen` is true (HTTP listener has to be up\n *     before they dial out)\n *   - Per-channel manual stop / start (UI-driven; suppresses auto-restart)\n *   - Exponential restart backoff via {@link CHANNEL_RESTART_POLICY}\n *   - Soft restart (called from heartbeat) — stop + startPlugin, manual-stop guarded\n *\n * Heartbeat probes themselves live in {@link ChannelHeartbeatScheduler}; this\n * supervisor schedules them via `onPluginStarted` / `onPluginStopped` callbacks\n * passed in by the caller.\n *\n * Extracted from `ChannelManager` so the manager can be a thin composition root.\n */\n\nimport type { Config } from '../config/schema.js';\nimport type { MessageBus } from '../infra/bus/index.js';\n\nimport type {\n  ChannelPlugin,\n  ChannelPluginInitOptions,\n  ChannelPluginSessionModelHooks,\n  ChannelPluginStartOptions,\n} from './plugin-types.js';\nimport type { ChannelPluginRegistry } from './plugin-registry.js';\nimport { CHANNEL_RESTART_POLICY, computeBackoff } from './restart-policy.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('ChannelLifecycleSupervisor');\n\nfunction asChannelConfig(raw: unknown): Record<string, unknown> | undefined {\n  if (raw && typeof raw === 'object' && !Array.isArray(raw)) {\n    return raw as Record<string, unknown>;\n  }\n  return undefined;\n}\n\nexport interface ChannelLifecycleSupervisorOptions {\n  bus: MessageBus;\n  registry: ChannelPluginRegistry;\n  /** Effective config snapshot (per-channel `channels.<id>.*`). */\n  getConfig: () => Config;\n  /** Hooks for sub-classes / external observers: heartbeat scheduling, etc. */\n  onPluginStarted?: (plugin: ChannelPlugin) => void;\n  onPluginStopped?: (pluginId: string) => void;\n  /** Optional session-model hooks forwarded into `plugin.init()`. */\n  getSessionModelHooks?: () => ChannelPluginSessionModelHooks | undefined;\n}\n\nexport class ChannelLifecycleSupervisor {\n  private readonly opts: ChannelLifecycleSupervisorOptions;\n  /** Plugin ids whose `init()` completed (used by start/stop loops). */\n  private readonly initializedPluginIds = new Set<string>();\n  private readonly restartAttempts = new Map<string, number>();\n  /** When set, failed-start auto-restart is suppressed for that channel id. */\n  private readonly manuallyStopped = new Set<string>();\n  /** Plugins that skipped `start()` until `startDeferredConnects()`. */\n  private readonly deferredConnectPending = new Set<string>();\n  private initialized = false;\n  private running = false;\n\n  constructor(opts: ChannelLifecycleSupervisorOptions) {\n    this.opts = opts;\n  }\n\n  isInitialized(pluginId: string): boolean {\n    return this.initializedPluginIds.has(pluginId);\n  }\n\n  snapshot(): {\n    initialized: boolean;\n    running: boolean;\n    initializedPluginIds: string[];\n    manuallyStopped: string[];\n    restartAttempts: Record<string, number>;\n  } {\n    return {\n      initialized: this.initialized,\n      running: this.running,\n      initializedPluginIds: [...this.initializedPluginIds],\n      manuallyStopped: [...this.manuallyStopped],\n      restartAttempts: Object.fromEntries(this.restartAttempts),\n    };\n  }\n\n  /** Channel ids that would run and declare `meta.deferConnectUntilAfterListen` (for logging / metrics). */\n  listDeferConnectChannelIds(cfg: Config): string[] {\n    const out: string[] = [];\n    for (const [id, plugin] of this.opts.registry.entries()) {\n      const channelConfig = asChannelConfig(cfg.channels?.[id]);\n      if (!this.shouldRunChannelPlugin(plugin, channelConfig)) continue;\n      if (plugin.meta.deferConnectUntilAfterListen === true) {\n        out.push(id);\n      }\n    }\n    return out;\n  }\n\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      log.warn(\n        { pluginCount: this.opts.registry.ids().length },\n        'initialize() called again; channels already initialized — skipping',\n      );\n      return;\n    }\n\n    const cfg = this.opts.getConfig();\n    const initPromises: Promise<void>[] = [];\n\n    for (const [id, plugin] of this.opts.registry.entries()) {\n      const channelConfig = asChannelConfig(cfg.channels?.[id]);\n      // Always init so `onConfigUpdated` runs on hot reload (e.g. Weixin turned off after QR-login\n      // started monitors while the plugin was previously skipped here and had no bus/`initialized` id).\n      initPromises.push(this.initializePlugin(plugin, channelConfig ?? {}));\n    }\n\n    await Promise.allSettled(initPromises);\n    this.initialized = true;\n    log.info('All channel plugins initialized');\n  }\n\n  /** Phase 1: start every enabled channel except those in `deferConnectPluginIds`. */\n  async start(options?: { deferConnectPluginIds?: ReadonlySet<string> }): Promise<void> {\n    if (!this.initialized) {\n      throw new Error('Channels not initialized');\n    }\n    if (this.running) {\n      log.warn(\n        { pluginCount: this.opts.registry.ids().length },\n        'start() called while channels already running — skipping',\n      );\n      return;\n    }\n\n    const deferIds = options?.deferConnectPluginIds ?? new Set<string>();\n    this.deferredConnectPending.clear();\n\n    const cfg = this.opts.getConfig();\n    const startPromises: Promise<void>[] = [];\n\n    for (const [id, plugin] of this.opts.registry.entries()) {\n      const channelConfig = asChannelConfig(cfg.channels?.[id]);\n      if (!this.shouldRunChannelPlugin(plugin, channelConfig)) continue;\n\n      if (deferIds.has(id)) {\n        this.deferredConnectPending.add(id);\n        log.info({ channel: id }, 'Channel connect deferred until HTTP listen');\n        continue;\n      }\n\n      startPromises.push(\n        this.startPlugin(plugin, {}).catch((err) => {\n          log.error({ channel: id, err }, 'Failed to start channel plugin');\n        }),\n      );\n    }\n\n    await Promise.allSettled(startPromises);\n    this.running = true;\n    log.info(\n      { deferred: [...this.deferredConnectPending] },\n      this.deferredConnectPending.size > 0\n        ? 'Channel plugins started (deferred connects pending)'\n        : 'All channel plugins started',\n    );\n  }\n\n  /** Phase 2: `start()` for channels deferred at Phase 1. No-op if none pending. */\n  async startDeferredConnects(): Promise<void> {\n    if (this.deferredConnectPending.size === 0) return;\n    if (!this.running) {\n      log.warn('startDeferredConnects called before channel phase-1 start; skipping');\n      return;\n    }\n    const ids = [...this.deferredConnectPending];\n    this.deferredConnectPending.clear();\n    const cfg = this.opts.getConfig();\n    const startPromises: Promise<void>[] = [];\n    for (const id of ids) {\n      const plugin = this.opts.registry.get(id);\n      if (!plugin) continue;\n      const channelConfig = asChannelConfig(cfg.channels?.[id]);\n      if (!this.shouldRunChannelPlugin(plugin, channelConfig)) continue;\n      startPromises.push(\n        this.startPlugin(plugin, {}).catch((err) => {\n          log.error({ channel: id, err }, 'Failed to start deferred channel plugin');\n        }),\n      );\n    }\n    await Promise.allSettled(startPromises);\n    log.info({ channels: ids }, 'Deferred channel connects completed');\n  }\n\n  async stop(): Promise<void> {\n    if (!this.running) return;\n\n    this.deferredConnectPending.clear();\n\n    const stopPromises: Promise<void>[] = [];\n    for (const id of this.initializedPluginIds) {\n      const plugin = this.opts.registry.get(id);\n      if (!plugin) continue;\n      stopPromises.push(\n        this.stopPlugin(plugin).catch((err) => {\n          log.error({ channel: id, err }, 'Failed to stop channel plugin');\n        }),\n      );\n    }\n\n    await Promise.allSettled(stopPromises);\n    this.running = false;\n    log.info('All channel plugins stopped');\n  }\n\n  /** Stop one channel and suppress automatic restart until `startChannel` is called. */\n  async stopChannel(channelId: string): Promise<void> {\n    this.manuallyStopped.add(channelId);\n    const plugin = this.opts.registry.get(channelId);\n    if (!plugin || !this.initializedPluginIds.has(channelId)) {\n      return;\n    }\n    await this.stopPlugin(plugin).catch((err) => {\n      log.error({ channel: channelId, err }, 'Failed to stop channel plugin');\n    });\n  }\n\n  /** Clear manual-stop and start one channel (requires prior `initialize()`). */\n  async startChannel(channelId: string): Promise<void> {\n    this.manuallyStopped.delete(channelId);\n    const plugin = this.opts.registry.get(channelId);\n    if (!plugin) {\n      log.warn({ channel: channelId }, 'Unknown channel');\n      return;\n    }\n    if (!this.initialized) {\n      log.warn({ channel: channelId }, 'Channels not initialized');\n      return;\n    }\n    const cfg = this.opts.getConfig();\n    const channelConfig = asChannelConfig(cfg.channels?.[channelId]);\n    if (!this.shouldRunChannelPlugin(plugin, channelConfig)) {\n      log.debug({ channel: channelId }, 'Channel disabled in config, skipping start');\n      return;\n    }\n    if (!this.initializedPluginIds.has(channelId)) {\n      log.warn({ channel: channelId }, 'Channel was never initialized; call initialize() first');\n      return;\n    }\n    await this.startPlugin(plugin, {});\n  }\n\n  /** Called by heartbeat: stop + start without clearing manualStop. No-op if user stopped it. */\n  async softRestart(channelId: string): Promise<void> {\n    if (this.manuallyStopped.has(channelId)) return;\n    const plugin = this.opts.registry.get(channelId);\n    if (!plugin || !this.initializedPluginIds.has(channelId)) return;\n    try {\n      await this.stopPlugin(plugin);\n      await this.startPlugin(plugin, {});\n    } catch (err) {\n      log.error({ channel: channelId, err }, 'Channel soft restart after heartbeat failed');\n    }\n  }\n\n  /** Forward a config snapshot to every initialised plugin's `onConfigUpdated` hook. */\n  async forwardConfigUpdate(cfg: Config): Promise<void> {\n    for (const id of this.initializedPluginIds) {\n      const plugin = this.opts.registry.get(id);\n      if (plugin?.onConfigUpdated) {\n        await Promise.resolve(plugin.onConfigUpdated(cfg));\n      }\n    }\n  }\n\n  // ── Internals ───────────────────────────────────────────────────────────\n\n  /**\n   * Builtin channels require `channels.<id>.enabled`. Extension-managed channels\n   * run unless explicitly disabled.\n   */\n  private shouldRunChannelPlugin(\n    plugin: ChannelPlugin,\n    channelConfig: Record<string, unknown> | undefined,\n  ): boolean {\n    if (plugin.extensionManagedConfig) {\n      return channelConfig?.enabled !== false;\n    }\n    return !!channelConfig?.enabled;\n  }\n\n  private async initializePlugin(\n    plugin: ChannelPlugin,\n    channelConfig: Record<string, unknown>,\n  ): Promise<void> {\n    try {\n      const options: ChannelPluginInitOptions = {\n        bus: this.opts.bus,\n        config: this.opts.getConfig(),\n        channelConfig,\n        sessionModel: this.opts.getSessionModelHooks?.(),\n      };\n      await plugin.init(options);\n      this.initializedPluginIds.add(plugin.id);\n      log.debug({ channel: plugin.id }, 'Channel plugin initialized');\n    } catch (err) {\n      log.error({ channel: plugin.id, err }, 'Failed to initialize channel plugin');\n    }\n  }\n\n  private async startPlugin(\n    plugin: ChannelPlugin,\n    opts: { preserveRestartAttempts?: boolean },\n  ): Promise<void> {\n    const options: ChannelPluginStartOptions = {};\n    try {\n      await plugin.start(options);\n      if (!opts.preserveRestartAttempts) {\n        this.restartAttempts.delete(plugin.id);\n      }\n      this.opts.onPluginStarted?.(plugin);\n      log.debug({ channel: plugin.id }, 'Channel plugin started');\n    } catch (err) {\n      const attempt = (this.restartAttempts.get(plugin.id) ?? 0) + 1;\n      this.restartAttempts.set(plugin.id, attempt);\n      if (attempt <= CHANNEL_RESTART_POLICY.maxAttempts) {\n        const delayMs = computeBackoff(CHANNEL_RESTART_POLICY, attempt);\n        log.warn(\n          { channel: plugin.id, attempt, delayMs, err },\n          'Channel failed to start, scheduling restart',\n        );\n        setTimeout(() => {\n          if (this.manuallyStopped.has(plugin.id)) {\n            log.debug({ channel: plugin.id }, 'Skipping scheduled restart (manual stop)');\n            return;\n          }\n          void this.startPlugin(plugin, { preserveRestartAttempts: true }).catch((e) => {\n            log.error({ channel: plugin.id, err: e }, 'Channel restart attempt failed');\n          });\n        }, delayMs);\n      } else {\n        log.error({ channel: plugin.id, err }, 'Channel exceeded max restart attempts');\n      }\n    }\n  }\n\n  private async stopPlugin(plugin: ChannelPlugin): Promise<void> {\n    this.opts.onPluginStopped?.(plugin.id);\n    await plugin.stop();\n    log.info({ channel: plugin.id }, 'Channel plugin stopped');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"lifecycle-supervisor.js","names":[],"sources":["../../../src/channels/lifecycle-supervisor.ts"],"sourcesContent":["/**\n * ChannelLifecycleSupervisor — owns the start/stop/restart state machine for\n * every channel plugin.\n *\n * Concerns:\n *   - `initialize()` — call each plugin's `init(...)` once and remember success\n *   - Two-phase `start()` + `startDeferredConnects()` for channels whose\n *     `meta.deferConnectUntilAfterListen` is true (HTTP listener has to be up\n *     before they dial out)\n *   - Per-channel manual stop / start (UI-driven; suppresses auto-restart)\n *   - Exponential restart backoff via {@link CHANNEL_RESTART_POLICY}\n *   - Soft restart (called from heartbeat) — stop + startPlugin, manual-stop guarded\n *\n * Heartbeat probes themselves live in {@link ChannelHeartbeatScheduler}; this\n * supervisor schedules them via `onPluginStarted` / `onPluginStopped` callbacks\n * passed in by the caller.\n *\n * Extracted from `ChannelManager` so the manager can be a thin composition root.\n */\n\nimport type { Config } from '../config/schema.js';\nimport type { MessageBus } from '../infra/bus/index.js';\n\nimport type {\n  ChannelPlugin,\n  ChannelPluginInitOptions,\n  ChannelPluginSessionModelHooks,\n  ChannelPluginStartOptions,\n} from './plugin-types.js';\nimport type { ChannelPluginRegistry } from './plugin-registry.js';\nimport { CHANNEL_RESTART_POLICY, computeBackoff } from './restart-policy.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('ChannelLifecycleSupervisor');\n\nfunction asChannelConfig(raw: unknown): Record<string, unknown> | undefined {\n  if (raw && typeof raw === 'object' && !Array.isArray(raw)) {\n    return raw as Record<string, unknown>;\n  }\n  return undefined;\n}\n\nexport interface ChannelLifecycleSupervisorOptions {\n  bus: MessageBus;\n  registry: ChannelPluginRegistry;\n  /** Effective config snapshot (per-channel `channels.<id>.*`). */\n  getConfig: () => Config;\n  /** Hooks for sub-classes / external observers: heartbeat scheduling, etc. */\n  onPluginStarted?: (plugin: ChannelPlugin) => void;\n  onPluginStopped?: (pluginId: string) => void;\n  /** Optional session-model hooks forwarded into `plugin.init()`. */\n  getSessionModelHooks?: () => ChannelPluginSessionModelHooks | undefined;\n}\n\nexport class ChannelLifecycleSupervisor {\n  private readonly opts: ChannelLifecycleSupervisorOptions;\n  /** Plugin ids whose `init()` completed (used by start/stop loops). */\n  private readonly initializedPluginIds = new Set<string>();\n  private readonly restartAttempts = new Map<string, number>();\n  /** When set, failed-start auto-restart is suppressed for that channel id. */\n  private readonly manuallyStopped = new Set<string>();\n  /** Plugins that skipped `start()` until `startDeferredConnects()`. */\n  private readonly deferredConnectPending = new Set<string>();\n  private initialized = false;\n  private running = false;\n\n  constructor(opts: ChannelLifecycleSupervisorOptions) {\n    this.opts = opts;\n  }\n\n  isInitialized(pluginId: string): boolean {\n    return this.initializedPluginIds.has(pluginId);\n  }\n\n  snapshot(): {\n    initialized: boolean;\n    running: boolean;\n    initializedPluginIds: string[];\n    manuallyStopped: string[];\n    restartAttempts: Record<string, number>;\n  } {\n    return {\n      initialized: this.initialized,\n      running: this.running,\n      initializedPluginIds: [...this.initializedPluginIds],\n      manuallyStopped: [...this.manuallyStopped],\n      restartAttempts: Object.fromEntries(this.restartAttempts),\n    };\n  }\n\n  /** Channel ids that would run and declare `meta.deferConnectUntilAfterListen` (for logging / metrics). */\n  listDeferConnectChannelIds(cfg: Config): string[] {\n    const out: string[] = [];\n    for (const [id, plugin] of this.opts.registry.entries()) {\n      const channelConfig = asChannelConfig(cfg.channels?.[id]);\n      if (!this.shouldRunChannelPlugin(plugin, channelConfig)) continue;\n      if (plugin.meta.deferConnectUntilAfterListen === true) {\n        out.push(id);\n      }\n    }\n    return out;\n  }\n\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      log.warn(\n        { pluginCount: this.opts.registry.ids().length },\n        'initialize() called again; channels already initialized — skipping',\n      );\n      return;\n    }\n\n    const cfg = this.opts.getConfig();\n    const initPromises: Promise<void>[] = [];\n\n    for (const [id, plugin] of this.opts.registry.entries()) {\n      const channelConfig = asChannelConfig(cfg.channels?.[id]);\n      // Always init so `onConfigUpdated` runs on hot reload (e.g. Weixin turned off after QR-login\n      // started monitors while the plugin was previously skipped here and had no bus/`initialized` id).\n      initPromises.push(this.initializePlugin(plugin, channelConfig ?? {}));\n    }\n\n    await Promise.allSettled(initPromises);\n    this.initialized = true;\n    log.info('All channel plugins initialized');\n  }\n\n  async initializeChannel(channelId: string): Promise<boolean> {\n    const plugin = this.opts.registry.get(channelId);\n    if (!plugin) {\n      log.warn({ channel: channelId }, 'Unknown channel');\n      return false;\n    }\n    if (this.initializedPluginIds.has(channelId)) {\n      return true;\n    }\n    const cfg = this.opts.getConfig();\n    await this.initializePlugin(plugin, asChannelConfig(cfg.channels?.[channelId]) ?? {});\n    return this.initializedPluginIds.has(channelId);\n  }\n\n  /** Phase 1: start every enabled channel except those in `deferConnectPluginIds`. */\n  async start(options?: { deferConnectPluginIds?: ReadonlySet<string> }): Promise<void> {\n    if (!this.initialized) {\n      throw new Error('Channels not initialized');\n    }\n    if (this.running) {\n      log.warn(\n        { pluginCount: this.opts.registry.ids().length },\n        'start() called while channels already running — skipping',\n      );\n      return;\n    }\n\n    const deferIds = options?.deferConnectPluginIds ?? new Set<string>();\n    this.deferredConnectPending.clear();\n\n    const cfg = this.opts.getConfig();\n    const startPromises: Promise<void>[] = [];\n\n    for (const [id, plugin] of this.opts.registry.entries()) {\n      const channelConfig = asChannelConfig(cfg.channels?.[id]);\n      if (!this.shouldRunChannelPlugin(plugin, channelConfig)) continue;\n\n      if (deferIds.has(id)) {\n        this.deferredConnectPending.add(id);\n        log.info({ channel: id }, 'Channel connect deferred until HTTP listen');\n        continue;\n      }\n\n      startPromises.push(\n        this.startPlugin(plugin, {}).catch((err) => {\n          log.error({ channel: id, err }, 'Failed to start channel plugin');\n        }),\n      );\n    }\n\n    await Promise.allSettled(startPromises);\n    this.running = true;\n    log.info(\n      { deferred: [...this.deferredConnectPending] },\n      this.deferredConnectPending.size > 0\n        ? 'Channel plugins started (deferred connects pending)'\n        : 'All channel plugins started',\n    );\n  }\n\n  /** Phase 2: `start()` for channels deferred at Phase 1. No-op if none pending. */\n  async startDeferredConnects(): Promise<void> {\n    if (this.deferredConnectPending.size === 0) return;\n    if (!this.running) {\n      log.warn('startDeferredConnects called before channel phase-1 start; skipping');\n      return;\n    }\n    const ids = [...this.deferredConnectPending];\n    this.deferredConnectPending.clear();\n    const cfg = this.opts.getConfig();\n    const startPromises: Promise<void>[] = [];\n    for (const id of ids) {\n      const plugin = this.opts.registry.get(id);\n      if (!plugin) continue;\n      const channelConfig = asChannelConfig(cfg.channels?.[id]);\n      if (!this.shouldRunChannelPlugin(plugin, channelConfig)) continue;\n      startPromises.push(\n        this.startPlugin(plugin, {}).catch((err) => {\n          log.error({ channel: id, err }, 'Failed to start deferred channel plugin');\n        }),\n      );\n    }\n    await Promise.allSettled(startPromises);\n    log.info({ channels: ids }, 'Deferred channel connects completed');\n  }\n\n  async stop(): Promise<void> {\n    if (!this.running) return;\n\n    this.deferredConnectPending.clear();\n\n    const stopPromises: Promise<void>[] = [];\n    for (const id of this.initializedPluginIds) {\n      const plugin = this.opts.registry.get(id);\n      if (!plugin) continue;\n      stopPromises.push(\n        this.stopPlugin(plugin).catch((err) => {\n          log.error({ channel: id, err }, 'Failed to stop channel plugin');\n        }),\n      );\n    }\n\n    await Promise.allSettled(stopPromises);\n    this.running = false;\n    log.info('All channel plugins stopped');\n  }\n\n  /** Stop one channel and suppress automatic restart until `startChannel` is called. */\n  async stopChannel(channelId: string): Promise<void> {\n    this.manuallyStopped.add(channelId);\n    const plugin = this.opts.registry.get(channelId);\n    if (!plugin || !this.initializedPluginIds.has(channelId)) {\n      return;\n    }\n    await this.stopPlugin(plugin).catch((err) => {\n      log.error({ channel: channelId, err }, 'Failed to stop channel plugin');\n    });\n  }\n\n  /** Clear manual-stop and start one channel (requires prior `initialize()`). */\n  async startChannel(channelId: string): Promise<void> {\n    this.manuallyStopped.delete(channelId);\n    const plugin = this.opts.registry.get(channelId);\n    if (!plugin) {\n      log.warn({ channel: channelId }, 'Unknown channel');\n      return;\n    }\n    if (!this.initialized) {\n      log.warn({ channel: channelId }, 'Channels not initialized');\n      return;\n    }\n    const cfg = this.opts.getConfig();\n    const channelConfig = asChannelConfig(cfg.channels?.[channelId]);\n    if (!this.shouldRunChannelPlugin(plugin, channelConfig)) {\n      log.debug({ channel: channelId }, 'Channel disabled in config, skipping start');\n      return;\n    }\n    if (!this.initializedPluginIds.has(channelId)) {\n      log.warn({ channel: channelId }, 'Channel was never initialized; call initialize() first');\n      return;\n    }\n    await this.startPlugin(plugin, {});\n  }\n\n  /** Called by heartbeat: stop + start without clearing manualStop. No-op if user stopped it. */\n  async softRestart(channelId: string): Promise<void> {\n    if (this.manuallyStopped.has(channelId)) return;\n    const plugin = this.opts.registry.get(channelId);\n    if (!plugin || !this.initializedPluginIds.has(channelId)) return;\n    try {\n      await this.stopPlugin(plugin);\n      await this.startPlugin(plugin, {});\n    } catch (err) {\n      log.error({ channel: channelId, err }, 'Channel soft restart after heartbeat failed');\n    }\n  }\n\n  /** Forward a config snapshot to every initialised plugin's `onConfigUpdated` hook. */\n  async forwardConfigUpdate(cfg: Config): Promise<void> {\n    for (const id of this.initializedPluginIds) {\n      const plugin = this.opts.registry.get(id);\n      if (plugin?.onConfigUpdated) {\n        await Promise.resolve(plugin.onConfigUpdated(cfg));\n      }\n    }\n  }\n\n  // ── Internals ───────────────────────────────────────────────────────────\n\n  /**\n   * Builtin channels require `channels.<id>.enabled`. Extension-managed channels\n   * run unless explicitly disabled.\n   */\n  private shouldRunChannelPlugin(\n    plugin: ChannelPlugin,\n    channelConfig: Record<string, unknown> | undefined,\n  ): boolean {\n    if (plugin.extensionManagedConfig) {\n      return channelConfig?.enabled !== false;\n    }\n    return !!channelConfig?.enabled;\n  }\n\n  private async initializePlugin(\n    plugin: ChannelPlugin,\n    channelConfig: Record<string, unknown>,\n  ): Promise<void> {\n    try {\n      const options: ChannelPluginInitOptions = {\n        bus: this.opts.bus,\n        config: this.opts.getConfig(),\n        channelConfig,\n        sessionModel: this.opts.getSessionModelHooks?.(),\n      };\n      await plugin.init(options);\n      this.initializedPluginIds.add(plugin.id);\n      log.debug({ channel: plugin.id }, 'Channel plugin initialized');\n    } catch (err) {\n      log.error({ channel: plugin.id, err }, 'Failed to initialize channel plugin');\n    }\n  }\n\n  private async startPlugin(\n    plugin: ChannelPlugin,\n    opts: { preserveRestartAttempts?: boolean },\n  ): Promise<void> {\n    const options: ChannelPluginStartOptions = {};\n    try {\n      await plugin.start(options);\n      if (!opts.preserveRestartAttempts) {\n        this.restartAttempts.delete(plugin.id);\n      }\n      this.opts.onPluginStarted?.(plugin);\n      log.debug({ channel: plugin.id }, 'Channel plugin started');\n    } catch (err) {\n      const attempt = (this.restartAttempts.get(plugin.id) ?? 0) + 1;\n      this.restartAttempts.set(plugin.id, attempt);\n      if (attempt <= CHANNEL_RESTART_POLICY.maxAttempts) {\n        const delayMs = computeBackoff(CHANNEL_RESTART_POLICY, attempt);\n        log.warn(\n          { channel: plugin.id, attempt, delayMs, err },\n          'Channel failed to start, scheduling restart',\n        );\n        setTimeout(() => {\n          if (this.manuallyStopped.has(plugin.id)) {\n            log.debug({ channel: plugin.id }, 'Skipping scheduled restart (manual stop)');\n            return;\n          }\n          void this.startPlugin(plugin, { preserveRestartAttempts: true }).catch((e) => {\n            log.error({ channel: plugin.id, err: e }, 'Channel restart attempt failed');\n          });\n        }, delayMs);\n      } else {\n        log.error({ channel: plugin.id, err }, 'Channel exceeded max restart attempts');\n      }\n    }\n  }\n\n  private async stopPlugin(plugin: ChannelPlugin): Promise<void> {\n    this.opts.onPluginStopped?.(plugin.id);\n    await plugin.stop();\n    log.info({ channel: plugin.id }, 'Channel plugin stopped');\n  }\n}\n"],"mappings":"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"}

package/dist/src/channels/manager.d.ts

@@ -41,6 +41,7 @@ export declare class ChannelManager {
     /** Channel IDs whose runtime reports connected (e.g. Telegram polling active). */
     getRunningChannels(): string[];
     initialize(): Promise<void>;
+    initializeChannel(channelId: string): Promise<boolean>;
     start(options?: {
         deferConnectPluginIds?: ReadonlySet<string>;
     }): Promise<void>;

package/dist/src/channels/manager.js

@@ -68,6 +68,9 @@ var ChannelManager = class {
 	initialize() {
 		return this.lifecycle.initialize();
 	}
+	initializeChannel(channelId) {
+		return this.lifecycle.initializeChannel(channelId);
+	}
 	start(options) {
 		return this.lifecycle.start(options);
 	}

package/dist/src/channels/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","names":[],"sources":["../../../src/channels/manager.ts"],"sourcesContent":["/**\n * Channel Manager — thin composition root for the channel subsystem.\n *\n * Wires together the four coordinators that own what used to be the eight\n * concerns of this 707-line class:\n *\n *   - {@link ChannelPluginRegistry}        — plugins Map, register/get\n *   - {@link ChannelLifecycleSupervisor}   — init/start/stop/restart-backoff\n *   - {@link ChannelHeartbeatScheduler}    — per-account heartbeat probes\n *   - {@link ChannelOutboundSender}        — TTS rewrite + persist + delivery\n *\n * The public surface (`registerPlugin`, `initialize`, `start`, `send`, etc.) is\n * preserved so callers (`GatewayService`, CLI commands, channel plugins) are\n * unchanged.\n */\n\nimport type { Config } from '../config/schema.js';\nimport type { MessageBus } from '../infra/bus/index.js';\n\nimport type { InboundMessage, OutboundMessage } from './transport-types.js';\nimport type {\n  ChannelPlugin,\n  ChannelPluginSessionModelHooks,\n  ChannelStreamHandle,\n} from './plugin-types.js';\nimport { ChannelHealthMonitor, type ChannelHealthState } from './health-monitor.js';\nimport { ChannelPluginRegistry } from './plugin-registry.js';\nimport { ChannelHeartbeatScheduler } from './heartbeat-scheduler.js';\nimport {\n  ChannelOutboundSender,\n  type OutboundChannelHooks,\n} from './outbound-sender.js';\nimport { ChannelLifecycleSupervisor } from './lifecycle-supervisor.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('ChannelManager');\n\nexport type { OutboundChannelHooks } from './outbound-sender.js';\n\nexport class ChannelManager {\n  private config: Config;\n  private readonly registry = new ChannelPluginRegistry();\n  private readonly healthMonitor = new ChannelHealthMonitor();\n  private readonly lifecycle: ChannelLifecycleSupervisor;\n  private readonly heartbeat: ChannelHeartbeatScheduler;\n  private readonly outbound: ChannelOutboundSender;\n  private sessionModelHooks?: ChannelPluginSessionModelHooks;\n\n  constructor(config: Config, bus: MessageBus) {\n    this.config = config;\n\n    this.heartbeat = new ChannelHeartbeatScheduler({\n      getConfig: () => this.config,\n      healthMonitor: this.healthMonitor,\n      requestSoftRestart: (channelId) => {\n        void this.lifecycle.softRestart(channelId);\n      },\n    });\n\n    this.lifecycle = new ChannelLifecycleSupervisor({\n      bus,\n      registry: this.registry,\n      getConfig: () => this.config,\n      getSessionModelHooks: () => this.sessionModelHooks,\n      onPluginStarted: (plugin) => this.heartbeat.schedule(plugin),\n      onPluginStopped: (pluginId) => this.heartbeat.clear(pluginId),\n    });\n\n    this.outbound = new ChannelOutboundSender({\n      registry: this.registry,\n      getConfig: () => this.config,\n    });\n  }\n\n  // ── Wiring hooks (called by GatewayService / cli) ─────────────────────\n\n  setOutboundHooks(hooks: OutboundChannelHooks): void {\n    this.outbound.setHooks(hooks);\n  }\n\n  /** Call before `initialize()` so plugins can persist per-session model overrides. */\n  setSessionModelHooks(hooks: ChannelPluginSessionModelHooks | undefined): void {\n    this.sessionModelHooks = hooks;\n  }\n\n  enableOutboundPersistence(agentDir: string): void {\n    this.outbound.enablePersistence(agentDir);\n  }\n\n  // ── Plugin registry pass-throughs ──────────────────────────────────────\n\n  registerPlugin(plugin: ChannelPlugin): void {\n    this.registry.register(plugin);\n  }\n\n  getPlugin(id: string): ChannelPlugin | undefined {\n    return this.registry.get(id);\n  }\n\n  getAllPlugins(): ChannelPlugin[] {\n    return this.registry.all();\n  }\n\n  /** Backward-compat alias for `getAllPlugins`. */\n  getAllChannels(): ChannelPlugin[] {\n    return this.registry.all();\n  }\n\n  /** Channel IDs whose runtime reports connected (e.g. Telegram polling active). */\n  getRunningChannels(): string[] {\n    return this.registry.runningChannelIds(this.config, (id) => this.lifecycle.isInitialized(id));\n  }\n\n  // ── Lifecycle pass-throughs ────────────────────────────────────────────\n\n  initialize(): Promise<void> {\n    return this.lifecycle.initialize();\n  }\n\n  start(options?: { deferConnectPluginIds?: ReadonlySet<string> }): Promise<void> {\n    return this.lifecycle.start(options);\n  }\n\n  startDeferredConnects(): Promise<void> {\n    return this.lifecycle.startDeferredConnects();\n  }\n\n  async stop(): Promise<void> {\n    await this.lifecycle.stop();\n    this.heartbeat.clearAll();\n  }\n\n  stopChannel(channelId: string): Promise<void> {\n    return this.lifecycle.stopChannel(channelId);\n  }\n\n  startChannel(channelId: string): Promise<void> {\n    return this.lifecycle.startChannel(channelId);\n  }\n\n  listDeferConnectChannelIds(cfg: Config): string[] {\n    return this.lifecycle.listDeferConnectChannelIds(cfg);\n  }\n\n  // ── Outbound pass-throughs ─────────────────────────────────────────────\n\n  send(msg: OutboundMessage, options?: { skipPersist?: boolean }): Promise<void> {\n    return this.outbound.send(msg, options);\n  }\n\n  replayPendingOutboundMessages(): Promise<void> {\n    return this.outbound.replayPending();\n  }\n\n  // ── Streaming + status query (delegated to plugin directly) ────────────\n\n  startStream(\n    channel: string,\n    chatId: string,\n    accountId?: string,\n    opts?: { threadId?: string; replyToMessageId?: string },\n  ): ChannelStreamHandle | null {\n    const plugin = this.registry.get(channel);\n    if (!plugin) {\n      log.error({ channel }, 'Unknown channel');\n      return null;\n    }\n    return (\n      plugin.streaming?.startStream?.({\n        chatId,\n        accountId,\n        threadId: opts?.threadId,\n        replyToMessageId: opts?.replyToMessageId,\n      }) ?? null\n    );\n  }\n\n  async getChannelStatus(channel: string): Promise<Record<string, unknown>> {\n    const plugin = this.registry.get(channel);\n    if (!plugin) return { error: 'Unknown channel' };\n    if (!plugin.status?.buildChannelSummary) return { status: 'unknown' };\n\n    try {\n      const accountId = plugin.config.listAccountIds(this.config)[0] ?? 'default';\n      const account = plugin.config.resolveAccount(this.config, accountId);\n      return await plugin.status.buildChannelSummary({\n        account,\n        cfg: this.config,\n        defaultAccountId: accountId,\n        snapshot: plugin.status.defaultRuntime ?? { accountId, channelId: channel, enabled: true, configured: true },\n      });\n    } catch (err) {\n      return { error: String(err) };\n    }\n  }\n\n  // ── Inbound action dispatch (Feishu card actions) ──────────────────────\n\n  /**\n   * Optional channel hook before `AgentService` consumes an inbound message\n   * (e.g. Feishu card-action triggers).\n   */\n  async dispatchInboundMessageAction(msg: InboundMessage): Promise<void> {\n    const plugin = this.registry.get(msg.channel);\n    const handle = plugin?.actions?.handleAction;\n    if (!handle) return;\n\n    const meta = msg.metadata as Record<string, unknown> | undefined;\n    if (msg.channel !== 'feishu' || meta?.feishuEventType !== 'card.action.trigger') {\n      return;\n    }\n\n    const cardAction = meta.cardAction as Record<string, unknown> | undefined;\n    const actionTag =\n      cardAction && typeof cardAction.tag === 'string' && cardAction.tag.trim()\n        ? cardAction.tag.trim()\n        : 'feishu.card_action';\n    const cardCtx = meta.cardContext as Record<string, unknown> | undefined;\n    const openMsg =\n      cardCtx && typeof cardCtx.open_message_id === 'string' ? cardCtx.open_message_id.trim() : '';\n    const fallbackMsgId = typeof meta.messageId === 'string' ? meta.messageId.trim() : '';\n    const messageId = openMsg || fallbackMsgId;\n    const accountId =\n      typeof meta.accountId === 'string' && meta.accountId.trim() ? meta.accountId.trim() : 'default';\n\n    try {\n      await handle({\n        action: actionTag,\n        data: JSON.stringify({\n          cardAction: meta.cardAction,\n          cardContext: meta.cardContext,\n          cardActionText: meta.cardActionText,\n        }),\n        messageId,\n        senderId: msg.sender_id,\n        chatId: msg.chat_id,\n        accountId,\n        metadata: {\n          feishuEventType: meta.feishuEventType,\n          raw: meta.raw,\n          sessionKey: meta.sessionKey,\n          userContent: msg.content,\n        },\n      });\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.error({ err, channel: msg.channel, accountId, em }, 'dispatchInboundMessageAction failed');\n    }\n  }\n\n  // ── Config + introspection ─────────────────────────────────────────────\n\n  async updateConfig(config: Config): Promise<void> {\n    this.config = config;\n    await this.lifecycle.forwardConfigUpdate(config);\n    log.info('Channel config updated');\n  }\n\n  /** Replace in-memory config without running plugin `onConfigUpdated` hooks. */\n  setRuntimeConfig(config: Config): void {\n    this.config = config;\n  }\n\n  getRuntimeSnapshot(): {\n    initialized: boolean;\n    running: boolean;\n    pluginIds: string[];\n    initializedPluginIds: string[];\n    manuallyStopped: string[];\n    restartAttempts: Record<string, number>;\n    channelHealth: Record<string, ChannelHealthState>;\n  } {\n    const lifecycleSnap = this.lifecycle.snapshot();\n    return {\n      ...lifecycleSnap,\n      pluginIds: this.registry.ids(),\n      channelHealth: this.healthMonitor.toJSON(),\n    };\n  }\n\n  getHealthMonitor(): ChannelHealthMonitor {\n    return this.healthMonitor;\n  }\n}\n\nexport function createChannelManager(config: Config, bus: MessageBus): ChannelManager {\n  return new ChannelManager(config, bus);\n}\n"],"mappings":"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"}
+{"version":3,"file":"manager.js","names":[],"sources":["../../../src/channels/manager.ts"],"sourcesContent":["/**\n * Channel Manager — thin composition root for the channel subsystem.\n *\n * Wires together the four coordinators that own what used to be the eight\n * concerns of this 707-line class:\n *\n *   - {@link ChannelPluginRegistry}        — plugins Map, register/get\n *   - {@link ChannelLifecycleSupervisor}   — init/start/stop/restart-backoff\n *   - {@link ChannelHeartbeatScheduler}    — per-account heartbeat probes\n *   - {@link ChannelOutboundSender}        — TTS rewrite + persist + delivery\n *\n * The public surface (`registerPlugin`, `initialize`, `start`, `send`, etc.) is\n * preserved so callers (`GatewayService`, CLI commands, channel plugins) are\n * unchanged.\n */\n\nimport type { Config } from '../config/schema.js';\nimport type { MessageBus } from '../infra/bus/index.js';\n\nimport type { InboundMessage, OutboundMessage } from './transport-types.js';\nimport type {\n  ChannelPlugin,\n  ChannelPluginSessionModelHooks,\n  ChannelStreamHandle,\n} from './plugin-types.js';\nimport { ChannelHealthMonitor, type ChannelHealthState } from './health-monitor.js';\nimport { ChannelPluginRegistry } from './plugin-registry.js';\nimport { ChannelHeartbeatScheduler } from './heartbeat-scheduler.js';\nimport {\n  ChannelOutboundSender,\n  type OutboundChannelHooks,\n} from './outbound-sender.js';\nimport { ChannelLifecycleSupervisor } from './lifecycle-supervisor.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('ChannelManager');\n\nexport type { OutboundChannelHooks } from './outbound-sender.js';\n\nexport class ChannelManager {\n  private config: Config;\n  private readonly registry = new ChannelPluginRegistry();\n  private readonly healthMonitor = new ChannelHealthMonitor();\n  private readonly lifecycle: ChannelLifecycleSupervisor;\n  private readonly heartbeat: ChannelHeartbeatScheduler;\n  private readonly outbound: ChannelOutboundSender;\n  private sessionModelHooks?: ChannelPluginSessionModelHooks;\n\n  constructor(config: Config, bus: MessageBus) {\n    this.config = config;\n\n    this.heartbeat = new ChannelHeartbeatScheduler({\n      getConfig: () => this.config,\n      healthMonitor: this.healthMonitor,\n      requestSoftRestart: (channelId) => {\n        void this.lifecycle.softRestart(channelId);\n      },\n    });\n\n    this.lifecycle = new ChannelLifecycleSupervisor({\n      bus,\n      registry: this.registry,\n      getConfig: () => this.config,\n      getSessionModelHooks: () => this.sessionModelHooks,\n      onPluginStarted: (plugin) => this.heartbeat.schedule(plugin),\n      onPluginStopped: (pluginId) => this.heartbeat.clear(pluginId),\n    });\n\n    this.outbound = new ChannelOutboundSender({\n      registry: this.registry,\n      getConfig: () => this.config,\n    });\n  }\n\n  // ── Wiring hooks (called by GatewayService / cli) ─────────────────────\n\n  setOutboundHooks(hooks: OutboundChannelHooks): void {\n    this.outbound.setHooks(hooks);\n  }\n\n  /** Call before `initialize()` so plugins can persist per-session model overrides. */\n  setSessionModelHooks(hooks: ChannelPluginSessionModelHooks | undefined): void {\n    this.sessionModelHooks = hooks;\n  }\n\n  enableOutboundPersistence(agentDir: string): void {\n    this.outbound.enablePersistence(agentDir);\n  }\n\n  // ── Plugin registry pass-throughs ──────────────────────────────────────\n\n  registerPlugin(plugin: ChannelPlugin): void {\n    this.registry.register(plugin);\n  }\n\n  getPlugin(id: string): ChannelPlugin | undefined {\n    return this.registry.get(id);\n  }\n\n  getAllPlugins(): ChannelPlugin[] {\n    return this.registry.all();\n  }\n\n  /** Backward-compat alias for `getAllPlugins`. */\n  getAllChannels(): ChannelPlugin[] {\n    return this.registry.all();\n  }\n\n  /** Channel IDs whose runtime reports connected (e.g. Telegram polling active). */\n  getRunningChannels(): string[] {\n    return this.registry.runningChannelIds(this.config, (id) => this.lifecycle.isInitialized(id));\n  }\n\n  // ── Lifecycle pass-throughs ────────────────────────────────────────────\n\n  initialize(): Promise<void> {\n    return this.lifecycle.initialize();\n  }\n\n  initializeChannel(channelId: string): Promise<boolean> {\n    return this.lifecycle.initializeChannel(channelId);\n  }\n\n  start(options?: { deferConnectPluginIds?: ReadonlySet<string> }): Promise<void> {\n    return this.lifecycle.start(options);\n  }\n\n  startDeferredConnects(): Promise<void> {\n    return this.lifecycle.startDeferredConnects();\n  }\n\n  async stop(): Promise<void> {\n    await this.lifecycle.stop();\n    this.heartbeat.clearAll();\n  }\n\n  stopChannel(channelId: string): Promise<void> {\n    return this.lifecycle.stopChannel(channelId);\n  }\n\n  startChannel(channelId: string): Promise<void> {\n    return this.lifecycle.startChannel(channelId);\n  }\n\n  listDeferConnectChannelIds(cfg: Config): string[] {\n    return this.lifecycle.listDeferConnectChannelIds(cfg);\n  }\n\n  // ── Outbound pass-throughs ─────────────────────────────────────────────\n\n  send(msg: OutboundMessage, options?: { skipPersist?: boolean }): Promise<void> {\n    return this.outbound.send(msg, options);\n  }\n\n  replayPendingOutboundMessages(): Promise<void> {\n    return this.outbound.replayPending();\n  }\n\n  // ── Streaming + status query (delegated to plugin directly) ────────────\n\n  startStream(\n    channel: string,\n    chatId: string,\n    accountId?: string,\n    opts?: { threadId?: string; replyToMessageId?: string },\n  ): ChannelStreamHandle | null {\n    const plugin = this.registry.get(channel);\n    if (!plugin) {\n      log.error({ channel }, 'Unknown channel');\n      return null;\n    }\n    return (\n      plugin.streaming?.startStream?.({\n        chatId,\n        accountId,\n        threadId: opts?.threadId,\n        replyToMessageId: opts?.replyToMessageId,\n      }) ?? null\n    );\n  }\n\n  async getChannelStatus(channel: string): Promise<Record<string, unknown>> {\n    const plugin = this.registry.get(channel);\n    if (!plugin) return { error: 'Unknown channel' };\n    if (!plugin.status?.buildChannelSummary) return { status: 'unknown' };\n\n    try {\n      const accountId = plugin.config.listAccountIds(this.config)[0] ?? 'default';\n      const account = plugin.config.resolveAccount(this.config, accountId);\n      return await plugin.status.buildChannelSummary({\n        account,\n        cfg: this.config,\n        defaultAccountId: accountId,\n        snapshot: plugin.status.defaultRuntime ?? { accountId, channelId: channel, enabled: true, configured: true },\n      });\n    } catch (err) {\n      return { error: String(err) };\n    }\n  }\n\n  // ── Inbound action dispatch (Feishu card actions) ──────────────────────\n\n  /**\n   * Optional channel hook before `AgentService` consumes an inbound message\n   * (e.g. Feishu card-action triggers).\n   */\n  async dispatchInboundMessageAction(msg: InboundMessage): Promise<void> {\n    const plugin = this.registry.get(msg.channel);\n    const handle = plugin?.actions?.handleAction;\n    if (!handle) return;\n\n    const meta = msg.metadata as Record<string, unknown> | undefined;\n    if (msg.channel !== 'feishu' || meta?.feishuEventType !== 'card.action.trigger') {\n      return;\n    }\n\n    const cardAction = meta.cardAction as Record<string, unknown> | undefined;\n    const actionTag =\n      cardAction && typeof cardAction.tag === 'string' && cardAction.tag.trim()\n        ? cardAction.tag.trim()\n        : 'feishu.card_action';\n    const cardCtx = meta.cardContext as Record<string, unknown> | undefined;\n    const openMsg =\n      cardCtx && typeof cardCtx.open_message_id === 'string' ? cardCtx.open_message_id.trim() : '';\n    const fallbackMsgId = typeof meta.messageId === 'string' ? meta.messageId.trim() : '';\n    const messageId = openMsg || fallbackMsgId;\n    const accountId =\n      typeof meta.accountId === 'string' && meta.accountId.trim() ? meta.accountId.trim() : 'default';\n\n    try {\n      await handle({\n        action: actionTag,\n        data: JSON.stringify({\n          cardAction: meta.cardAction,\n          cardContext: meta.cardContext,\n          cardActionText: meta.cardActionText,\n        }),\n        messageId,\n        senderId: msg.sender_id,\n        chatId: msg.chat_id,\n        accountId,\n        metadata: {\n          feishuEventType: meta.feishuEventType,\n          raw: meta.raw,\n          sessionKey: meta.sessionKey,\n          userContent: msg.content,\n        },\n      });\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.error({ err, channel: msg.channel, accountId, em }, 'dispatchInboundMessageAction failed');\n    }\n  }\n\n  // ── Config + introspection ─────────────────────────────────────────────\n\n  async updateConfig(config: Config): Promise<void> {\n    this.config = config;\n    await this.lifecycle.forwardConfigUpdate(config);\n    log.info('Channel config updated');\n  }\n\n  /** Replace in-memory config without running plugin `onConfigUpdated` hooks. */\n  setRuntimeConfig(config: Config): void {\n    this.config = config;\n  }\n\n  getRuntimeSnapshot(): {\n    initialized: boolean;\n    running: boolean;\n    pluginIds: string[];\n    initializedPluginIds: string[];\n    manuallyStopped: string[];\n    restartAttempts: Record<string, number>;\n    channelHealth: Record<string, ChannelHealthState>;\n  } {\n    const lifecycleSnap = this.lifecycle.snapshot();\n    return {\n      ...lifecycleSnap,\n      pluginIds: this.registry.ids(),\n      channelHealth: this.healthMonitor.toJSON(),\n    };\n  }\n\n  getHealthMonitor(): ChannelHealthMonitor {\n    return this.healthMonitor;\n  }\n}\n\nexport function createChannelManager(config: Config, bus: MessageBus): ChannelManager {\n  return new ChannelManager(config, bus);\n}\n"],"mappings":"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"}

package/dist/src/channels/pairing/pairing-channel.d.ts

@@ -1,3 +1,2 @@
-/** Channels that use ~/.xopc/credentials pairing + allowFrom files (aligned with Feishu layout). */
-export type StandardPairingChannel = 'telegram' | 'feishu';
-export type PairingCliChannel = StandardPairingChannel | 'weixin';
+export type StandardPairingChannel = string;
+export type PairingCliChannel = string;

package/dist/src/channels/pairing/pairing-messages.js

@@ -9,7 +9,7 @@ function buildPairingInstructionText(params) {
 		code,
 		"",
 		"Ask the owner to approve in Settings → Channels → Pairing, or run:",
-		`xopc channels pairing approve --channel ${channel}${!accountId || accountId.trim().toLowerCase() === "default" ? "" : ` --account ${accountId.trim()}`} ${code}`
+		`xopc channels pairing approve ${channel}${!accountId || accountId.trim().toLowerCase() === "default" ? "" : ` --account ${accountId.trim()}`} ${code}`
 	].join("\n");
 }
 //#endregion

package/dist/src/channels/pairing/pairing-messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"pairing-messages.js","names":[],"sources":["../../../../src/channels/pairing/pairing-messages.ts"],"sourcesContent":["import type { PairingCliChannel } from './pairing-channel.js';\n\nexport function buildPairingInstructionText(params: {\n  channel: PairingCliChannel;\n  accountId: string;\n  code: string;\n  senderIdLine: string;\n}): string {\n  const { channel, accountId, code, senderIdLine } = params;\n  const acc =\n    !accountId || accountId.trim().toLowerCase() === 'default' ? '' : ` --account ${accountId.trim()}`;\n  const approve = `xopc channels pairing approve --channel ${channel}${acc} ${code}`;\n  return [\n    'XOPC: this bot is in pairing mode.',\n    '',\n    senderIdLine,\n    'Pairing code:',\n    code,\n    '',\n    'Ask the owner to approve in Settings → Channels → Pairing, or run:',\n    approve,\n  ].join('\\n');\n}\n"],"mappings":";AAEA,SAAgB,4BAA4B,QAKjC;CACT,MAAM,EAAE,SAAS,WAAW,MAAM,iBAAiB;AAInD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,2CATyD,UADzD,CAAC,aAAa,UAAU,MAAM,CAAC,aAAa,KAAK,YAAY,KAAK,cAAc,UAAU,MAAM,GACzB,GAAG;EAU3E,CAAC,KAAK,KAAK"}
+{"version":3,"file":"pairing-messages.js","names":[],"sources":["../../../../src/channels/pairing/pairing-messages.ts"],"sourcesContent":["import type { PairingCliChannel } from './pairing-channel.js';\n\nexport function buildPairingInstructionText(params: {\n  channel: PairingCliChannel;\n  accountId: string;\n  code: string;\n  senderIdLine: string;\n}): string {\n  const { channel, accountId, code, senderIdLine } = params;\n  const acc =\n    !accountId || accountId.trim().toLowerCase() === 'default' ? '' : ` --account ${accountId.trim()}`;\n  const approve = `xopc channels pairing approve ${channel}${acc} ${code}`;\n  return [\n    'XOPC: this bot is in pairing mode.',\n    '',\n    senderIdLine,\n    'Pairing code:',\n    code,\n    '',\n    'Ask the owner to approve in Settings → Channels → Pairing, or run:',\n    approve,\n  ].join('\\n');\n}\n"],"mappings":";AAEA,SAAgB,4BAA4B,QAKjC;CACT,MAAM,EAAE,SAAS,WAAW,MAAM,iBAAiB;AAInD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,iCAT+C,UAD/C,CAAC,aAAa,UAAU,MAAM,CAAC,aAAa,KAAK,YAAY,KAAK,cAAc,UAAU,MAAM,GACnC,GAAG;EAUjE,CAAC,KAAK,KAAK"}

package/dist/src/channels/pairing/pairing-service.d.ts

@@ -18,7 +18,7 @@ export type ChannelPairingSummaryEntry = {
     stale: number;
     atCapacity: boolean;
 };
-export type ChannelPairingSummary = Record<PairingCliChannel, ChannelPairingSummaryEntry>;
+export type ChannelPairingSummary = Record<string, ChannelPairingSummaryEntry>;
 export type PairingPendingIssue = {
     channel: PairingCliChannel;
     accountId: string;

package/dist/src/channels/pairing/pairing-service.js

@@ -1,9 +1,9 @@
+import { resolveDmPolicy } from "../security.js";
 import { resolveStandardAllowFromPath, resolveStandardPairingPath, resolveWeixinAllowFromPath, resolveWeixinPairingPath } from "./paths.js";
 import { readAllowFromIdsSync, removeAllowFromIdSync } from "./allow-from-file.js";
 import "./pairing-constants.js";
 import { PAIRING_PENDING_TTL_MS, approvePairingBySenderIdSync, approvePairingCodeSync, dismissPairingBySenderIdSync, listPendingPairingRequestsSync } from "./pairing-store.js";
 import { broadcastPairingEvent } from "./pairing-events.js";
-import { resolveDmPolicy } from "../security.js";
 //#region src/channels/pairing/pairing-service.ts
 function normalizeAccountId(accountId) {
 	return (accountId ?? "default").trim().toLowerCase() || "default";
@@ -115,30 +115,15 @@ function resolvePairingAccountIds(config, channel) {
 	return ["default"];
 }
 function listChannelPairingSummary(config) {
-	const channels = [
-		"telegram",
-		"feishu",
-		"weixin"
-	];
-	const summary = {
-		telegram: {
-			pending: 0,
-			stale: 0,
-			atCapacity: false
-		},
-		feishu: {
-			pending: 0,
-			stale: 0,
-			atCapacity: false
-		},
-		weixin: {
+	const channels = Object.keys(config?.channels ?? {});
+	const summary = {};
+	for (const channel of channels) {
+		if (!resolveChannelEnabled(config, channel)) continue;
+		summary[channel] = {
 			pending: 0,
 			stale: 0,
 			atCapacity: false
-		}
-	};
-	for (const channel of channels) {
-		if (!resolveChannelEnabled(config, channel)) continue;
+		};
 		const accountIds = resolvePairingAccountIds(config, channel);
 		for (const accountId of accountIds) {
 			if (!resolveAccountEnabled(config, channel, accountId)) continue;
@@ -154,11 +139,7 @@ function listChannelPairingSummary(config) {
 }
 function collectPairingPendingIssues(config) {
 	const issues = [];
-	for (const channel of [
-		"telegram",
-		"feishu",
-		"weixin"
-	]) {
+	for (const channel of Object.keys(config?.channels ?? {})) {
 		if (!resolveChannelEnabled(config, channel)) continue;
 		const accountIds = resolvePairingAccountIds(config, channel);
 		for (const accountId of accountIds) {