@xopcai/xopc 0.0.102 → 0.0.104

package/dist/src/browser/actions/registry.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { checkWebsiteBlocklist } from "../../agent/tools/url-safety.js";
 import { resolveBrowserCommandTimeoutMs } from "../browser-command-timeout.js";
+import { humanizedClick, humanizedFill, humanizedScroll } from "../humanize.js";
 import { assertBrowserUrlAllowed, checkPostRedirectUrl, containsApiKeyPattern } from "../url-policy.js";
 import { truncateSnapshotAtBoundary } from "../snapshot-helpers.js";
-import { humanizedClick, humanizedFill, humanizedScroll } from "../humanize.js";
+import { checkWebsiteBlocklist } from "../../agent/tools/url-safety.js";
 //#region src/browser/actions/registry.ts
 init_logger();
 const log = createLogger("BrowserActionRegistry");

package/dist/src/browser/cdp-local-launcher.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { loadPlaywrightCoreModule } from "./providers/playwright-doctor.js";
 import { pickFreePort } from "./free-port.js";
+import { loadPlaywrightCoreModule } from "./providers/playwright-doctor.js";
 import { existsSync } from "node:fs";
 import { mkdir, rm } from "node:fs/promises";
 import { join } from "node:path";

package/dist/src/browser/index.js

@@ -1,13 +1,13 @@
-import { BrowserManager } from "./manager.js";
 import { resolveBrowserBackendFromConfig } from "./backend-from-config.js";
 import { resolveBrowserCommandTimeoutMs } from "./browser-command-timeout.js";
+import { CdpSupervisor } from "./cdp-supervisor.js";
+import { generateMousePath, generateScrollPlan, generateTypingPlan, humanizedClick, humanizedFill, humanizedPress, humanizedScroll, resolveHumanConfig } from "./humanize.js";
+import { BrowserManager } from "./manager.js";
 import { BrowserNotReadyError, buildBrowserSetupDeepLink, checkBrowserReadiness } from "./readiness.js";
 import { assertBrowserUrlAllowed, checkPostRedirectUrl, containsApiKeyPattern, isAlwaysBlockedUrl } from "./url-policy.js";
-import { CdpSupervisor } from "./cdp-supervisor.js";
 import { snapshotSummaryHeader, truncateSnapshotAtBoundary } from "./snapshot-helpers.js";
 import { checkBotDetection, cleanupOrphanProcesses, startTracing, stopTracing } from "./session-lifecycle.js";
 import { BrowserBackSchema, BrowserCdpSchema, BrowserClickSchema, BrowserCloseSchema, BrowserConsoleSchema, BrowserDialogSchema, BrowserGetImagesSchema, BrowserNavigateSchema, BrowserPressSchema, BrowserScreenshotSchema, BrowserScrollSchema, BrowserSnapshotSchema, BrowserTypeSchema, BrowserVisionSchema } from "./schemas.js";
-import { generateMousePath, generateScrollPlan, generateTypingPlan, humanizedClick, humanizedFill, humanizedPress, humanizedScroll, resolveHumanConfig } from "./humanize.js";
 import { WEBDRIVER_OVERRIDE_SCRIPT, buildLocalStealthArgs, buildStealthArgs, generateFingerprintSeed, makeExecutable, removeQuarantineAttr } from "./stealth.js";
 import { createBrowserActionRegistry } from "./actions/registry.js";
 import { parseBrowserPipeline } from "./pipeline/schema.js";

package/dist/src/browser/providers/browser-ext-install.js

@@ -8,8 +8,8 @@ import { resolvePackageRoot } from "../../infra/update-check.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { readFile, readdir, rm } from "node:fs/promises";
 import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
 //#region src/browser/providers/browser-ext-install.ts
 /**
 * Install bundled Chrome extension artifacts into {resolveBinDir()}/browser-ext/.

package/dist/src/browser/providers/cloakbrowser.js

@@ -2,9 +2,9 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveBinDir } from "../../config/paths.js";
 import { assertCacheDir, expandHome, init_cache_dir_policy } from "../cache-dir-policy.js";
+import { pickFreePort } from "../free-port.js";
 import { loadPlaywrightCoreModule } from "./playwright-doctor.js";
 import { WEBDRIVER_OVERRIDE_SCRIPT, buildStealthArgs, filterCloakBrowserExtraArgs, generateFingerprintSeed, makeExecutable, removeQuarantineAttr } from "../stealth.js";
-import { pickFreePort } from "../free-port.js";
 import { createHash } from "node:crypto";
 import { createReadStream, createWriteStream } from "node:fs";
 import { mkdir, mkdtemp, rm, stat } from "node:fs/promises";

package/dist/src/channels/attachments/attachment-classifiers.d.ts

@@ -1,3 +1,4 @@
+export declare function isSupportedVisionImageMimeType(mimeType: string | undefined): boolean;
 export declare function isImageInboundAttachment(att: {
     type?: string;
     mimeType?: string;

package/dist/src/channels/attachments/attachment-classifiers.js

@@ -1,11 +1,22 @@
 //#region src/channels/attachments/attachment-classifiers.ts
+const VISION_IMAGE_MIME_TYPES = new Set([
+	"image/jpeg",
+	"image/png",
+	"image/gif",
+	"image/webp"
+]);
+function isSupportedVisionImageMimeType(mimeType) {
+	const normalized = mimeType?.split(";")[0]?.trim().toLowerCase();
+	return normalized ? VISION_IMAGE_MIME_TYPES.has(normalized) : false;
+}
 function isImageInboundAttachment(att) {
-	return att.type === "image" || att.type === "photo" || att.mimeType?.startsWith("image/") === true;
+	if (att.mimeType) return isSupportedVisionImageMimeType(att.mimeType);
+	return att.type === "image" || att.type === "photo";
 }
 function isVoiceInboundAttachment(att) {
 	return att.type === "voice" || att.type === "audio" || att.mimeType?.startsWith("audio/") === true;
 }
 //#endregion
-export { isImageInboundAttachment, isVoiceInboundAttachment };
+export { isImageInboundAttachment, isSupportedVisionImageMimeType, isVoiceInboundAttachment };
 
 //# sourceMappingURL=attachment-classifiers.js.map

package/dist/src/channels/attachments/attachment-classifiers.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-classifiers.js","names":[],"sources":["../../../../src/channels/attachments/attachment-classifiers.ts"],"sourcesContent":["export function isImageInboundAttachment(att: {\n  type?: string;\n  mimeType?: string;\n}): boolean {\n  return (\n    att.type === 'image' ||\n    att.type === 'photo' ||\n    att.mimeType?.startsWith('image/') === true\n  );\n}\n\nexport function isVoiceInboundAttachment(att: { type?: string; mimeType?: string }): boolean {\n  return (\n    att.type === 'voice' ||\n    att.type === 'audio' ||\n    att.mimeType?.startsWith('audio/') === true\n  );\n}\n"],"mappings":";AAAA,SAAgB,yBAAyB,KAG7B;AACV,QACE,IAAI,SAAS,WACb,IAAI,SAAS,WACb,IAAI,UAAU,WAAW,SAAS,KAAK;;AAI3C,SAAgB,yBAAyB,KAAoD;AAC3F,QACE,IAAI,SAAS,WACb,IAAI,SAAS,WACb,IAAI,UAAU,WAAW,SAAS,KAAK"}
+{"version":3,"file":"attachment-classifiers.js","names":[],"sources":["../../../../src/channels/attachments/attachment-classifiers.ts"],"sourcesContent":["const VISION_IMAGE_MIME_TYPES = new Set([\n  'image/jpeg',\n  'image/png',\n  'image/gif',\n  'image/webp',\n]);\n\nexport function isSupportedVisionImageMimeType(mimeType: string | undefined): boolean {\n  const normalized = mimeType?.split(';')[0]?.trim().toLowerCase();\n  return normalized ? VISION_IMAGE_MIME_TYPES.has(normalized) : false;\n}\n\nexport function isImageInboundAttachment(att: {\n  type?: string;\n  mimeType?: string;\n}): boolean {\n  if (att.mimeType) {\n    return isSupportedVisionImageMimeType(att.mimeType);\n  }\n\n  return (\n    att.type === 'image' ||\n    att.type === 'photo'\n  );\n}\n\nexport function isVoiceInboundAttachment(att: { type?: string; mimeType?: string }): boolean {\n  return (\n    att.type === 'voice' ||\n    att.type === 'audio' ||\n    att.mimeType?.startsWith('audio/') === true\n  );\n}\n"],"mappings":";AAAA,MAAM,0BAA0B,IAAI,IAAI;CACtC;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,+BAA+B,UAAuC;CACpF,MAAM,aAAa,UAAU,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,aAAa;AAChE,QAAO,aAAa,wBAAwB,IAAI,WAAW,GAAG;;AAGhE,SAAgB,yBAAyB,KAG7B;AACV,KAAI,IAAI,SACN,QAAO,+BAA+B,IAAI,SAAS;AAGrD,QACE,IAAI,SAAS,WACb,IAAI,SAAS;;AAIjB,SAAgB,yBAAyB,KAAoD;AAC3F,QACE,IAAI,SAAS,WACb,IAAI,SAAS,WACb,IAAI,UAAU,WAAW,SAAS,KAAK"}

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);
 	}