@mono-agent/agent-app 0.3.0 → 0.4.1

package/dist/broadcast-recorder.js

@@ -0,0 +1,82 @@
+import { LIVE_EVENT_SCHEMA } from "@mono-agent/agent-contracts";
+import { redactJsonValue } from "@mono-agent/observability";
+/**
+ * Wrap a {@link RunRecorder} so every run start/event/finish is ALSO published to
+ * a {@link RunEventSink} (the in-process live bus), giving operator surfaces
+ * sub-run visibility the on-disk recorder can't (it flushes only at start/finish).
+ *
+ * Broadcast is best-effort and additive, exactly like the Phoenix exporter path:
+ * the inner recorder is the source of truth for the returned summary, and a
+ * publish failure never changes the run outcome (publish is wrapped and the bus's
+ * own `publish` is contracted never to throw). `seq` is left 0 here — the bus
+ * stamps a process-wide monotonic value on publish.
+ */
+export function createBroadcastRunRecorder(inner, sink, ctx) {
+    let eventIndex = 0;
+    const publish = (frame) => {
+        try {
+            sink.publish(frame);
+        }
+        catch {
+            // Broadcast is best-effort; a sink failure must never break the run.
+        }
+    };
+    const finished = async (summary) => {
+        const redactedSummary = redactJsonValue(summary);
+        publish({
+            t: "run_finished",
+            schema: LIVE_EVENT_SCHEMA,
+            sourceId: ctx.sourceId,
+            runId: ctx.runId,
+            status: redactedSummary.status,
+            summary: redactedSummary,
+            seq: 0,
+        });
+        return summary;
+    };
+    const recorder = {
+        onEvent(event) {
+            inner.onEvent(event);
+            const redactedEvent = redactJsonValue(event);
+            publish({
+                t: "event",
+                schema: LIVE_EVENT_SCHEMA,
+                sourceId: ctx.sourceId,
+                runId: ctx.runId,
+                eventIndex: eventIndex++,
+                event: redactedEvent,
+                seq: 0,
+            });
+        },
+        async finish(result) {
+            return await finished(await inner.finish(result));
+        },
+        async fail(error) {
+            return await finished(await inner.fail(error));
+        },
+    };
+    // `start` is optional on RunRecorder — only expose (and emit run_started) when
+    // the inner recorder has one, so callers that probe `recorder.start?.()` behave
+    // identically to the unwrapped recorder.
+    if (inner.start !== undefined) {
+        const innerStart = inner.start.bind(inner);
+        recorder.start = async () => {
+            const summary = await innerStart();
+            publish({
+                t: "run_started",
+                schema: LIVE_EVENT_SCHEMA,
+                sourceId: ctx.sourceId,
+                ...(ctx.sourceLabel === undefined ? {} : { sourceLabel: ctx.sourceLabel }),
+                runId: ctx.runId,
+                conversationId: ctx.conversationId,
+                ...(ctx.source === undefined ? {} : { source: ctx.source }),
+                ...(ctx.sourceDetail === undefined ? {} : { sourceDetail: ctx.sourceDetail }),
+                startedAt: summary.startedAt ?? new Date().toISOString(),
+                seq: 0,
+            });
+            return summary;
+        };
+    }
+    return recorder;
+}
+//# sourceMappingURL=broadcast-recorder.js.map

package/dist/broadcast-recorder.js.map

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

package/dist/channel-config-view.d.ts

@@ -0,0 +1,28 @@
+import type { ConfigViewSection } from "@mono-agent/config";
+import type { JsonEnvFieldSpec } from "@mono-agent/agent-contracts";
+import type { MonoAgentAppConfigInput } from "./app-config.js";
+import type { ChannelDriver } from "./channels.js";
+/**
+ * The driver facts a channel config view needs: enough to resolve the section
+ * status through the channel's own loader without starting anything.
+ */
+type ChannelViewDriver = Pick<ChannelDriver, "id" | "label" | "loadConfig" | "isConfigError" | "disabledReason">;
+/**
+ * Compose one channel's source-annotated config section from the adapter's
+ * exported field registry — the channel counterpart of the core
+ * `buildMonoAgentConfigView`. Field sources resolve with the loader's own
+ * layering semantics (a set env var wins, then a JSON value the layer function
+ * would encode, else the default), so the view can never disagree with what the
+ * adapter actually reads. Secret fields are never printed — only set/unset.
+ */
+export declare function buildChannelConfigView(driver: ChannelViewDriver, fields: readonly JsonEnvFieldSpec[], input: MonoAgentAppConfigInput, options?: {
+    readonly jsonKey?: string;
+}): Promise<ConfigViewSection>;
+/**
+ * Collect every driver's config view section. Advisory surface: a channel
+ * whose view fails to compose is skipped — its validate section reports the
+ * load problem loudly instead.
+ */
+export declare function collectChannelConfigViews(drivers: readonly ChannelDriver[], input: MonoAgentAppConfigInput): Promise<readonly ConfigViewSection[]>;
+export {};
+//# sourceMappingURL=channel-config-view.d.ts.map

package/dist/channel-config-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-config-view.d.ts","sourceRoot":"","sources":["../src/channel-config-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD;;;GAGG;AACH,KAAK,iBAAiB,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,OAAO,GAAG,YAAY,GAAG,eAAe,GAAG,gBAAgB,CAAC,CAAC;AAEjH;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,KAAK,EAAE,uBAAuB,EAC9B,OAAO,GAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1C,OAAO,CAAC,iBAAiB,CAAC,CAwB5B;AAqBD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAavC"}

package/dist/channel-config-view.js

@@ -0,0 +1,79 @@
+import { encodeJsonEnvValue, normalizeOptionalString, readJsonSection, readSettingsJson } from "@mono-agent/agent-contracts";
+const PLACEHOLDER = "—";
+/**
+ * Compose one channel's source-annotated config section from the adapter's
+ * exported field registry — the channel counterpart of the core
+ * `buildMonoAgentConfigView`. Field sources resolve with the loader's own
+ * layering semantics (a set env var wins, then a JSON value the layer function
+ * would encode, else the default), so the view can never disagree with what the
+ * adapter actually reads. Secret fields are never printed — only set/unset.
+ */
+export async function buildChannelConfigView(driver, fields, input, options = {}) {
+    const { json } = await readSettingsJson(input.configPath);
+    const section = readJsonSection(json, options.jsonKey ?? driver.id);
+    // An explicitly disabled channel reports `disabled`; an enabled channel —
+    // even one still waiting for credentials (typed config error) — is `active`.
+    let status = "active";
+    try {
+        const config = await driver.loadConfig(input);
+        if (driver.disabledReason?.(config) !== undefined) {
+            status = "disabled";
+        }
+    }
+    catch (error) {
+        if (!driver.isConfigError(error)) {
+            throw error;
+        }
+    }
+    return {
+        id: driver.id,
+        label: driver.label,
+        status,
+        fields: fields.map((field) => toChannelViewField(field, section, input.env)),
+    };
+}
+function toChannelViewField(field, section, env) {
+    const envValue = normalizeOptionalString(env[field.env]);
+    const jsonValue = encodeJsonEnvValue(field.fromJson(section), field.kind ?? "string");
+    const resolved = envValue ?? jsonValue;
+    const source = envValue !== undefined ? "env" : jsonValue !== undefined ? "json" : "default";
+    return {
+        id: field.id,
+        label: labelForFieldId(field.id),
+        value: field.secret === true ? (resolved === undefined ? "unset" : "set") : resolved ?? PLACEHOLDER,
+        source,
+        ...(field.secret === true ? { redacted: true } : {}),
+        envKey: field.env,
+    };
+}
+/**
+ * Collect every driver's config view section. Advisory surface: a channel
+ * whose view fails to compose is skipped — its validate section reports the
+ * load problem loudly instead.
+ */
+export async function collectChannelConfigViews(drivers, input) {
+    const sections = [];
+    for (const driver of drivers) {
+        if (driver.configView === undefined) {
+            continue;
+        }
+        try {
+            sections.push(await driver.configView(input));
+        }
+        catch {
+            // Skip: the channel's own validate section owns error reporting.
+        }
+    }
+    return sections;
+}
+/** `a2a.provider.bearerToken` → "Provider bearer token". */
+function labelForFieldId(id) {
+    const words = id
+        .split(".")
+        .slice(1)
+        .join(" ")
+        .replace(/([a-z0-9])([A-Z])/gu, "$1 $2")
+        .toLowerCase();
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
+//# sourceMappingURL=channel-config-view.js.map

package/dist/channel-config-view.js.map

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

package/dist/channel-gate.d.ts

@@ -0,0 +1,22 @@
+import type { MonoAgentAppConfigInput } from "./app-config.js";
+/** What marks a channel as "the operator expressed intent" for the lazy-load gate. */
+export interface ChannelGateSpec {
+    /** Top-level key of the channel's section in mono-agent.config.json. */
+    readonly jsonKey: string;
+    /** Env prefix: any set `MONO_AGENT_<X>_*` var marks the channel configured. */
+    readonly envPrefix: string;
+    /** Folder (relative to cwd) whose existence marks the channel configured (cron/, webhook/). */
+    readonly dir?: string;
+}
+/**
+ * True when the operator expressed ANY intent for the channel: its JSON section
+ * exists (even with `enabled: false` — the real loader must still parse it so a
+ * malformed disabled section keeps erroring exactly as before), any env var
+ * with the channel's prefix is set, or its jobs/endpoints folder exists.
+ *
+ * False is the lazy-load fast path: the adapter module is never imported and
+ * the driver answers with the loader's own empty-input output (drift-guarded
+ * by tests) — so a webhook-only agent never loads the chat SDKs.
+ */
+export declare function isChannelConfigured(input: MonoAgentAppConfigInput, spec: ChannelGateSpec): Promise<boolean>;
+//# sourceMappingURL=channel-gate.d.ts.map

package/dist/channel-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-gate.d.ts","sourceRoot":"","sources":["../src/channel-gate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+FAA+F;IAC/F,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,uBAAuB,EAC9B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,OAAO,CAAC,CAmBlB"}

package/dist/channel-gate.js

@@ -0,0 +1,35 @@
+import { access } from "node:fs/promises";
+import { resolve } from "node:path";
+import { readSettingsJson } from "@mono-agent/agent-contracts";
+/**
+ * True when the operator expressed ANY intent for the channel: its JSON section
+ * exists (even with `enabled: false` — the real loader must still parse it so a
+ * malformed disabled section keeps erroring exactly as before), any env var
+ * with the channel's prefix is set, or its jobs/endpoints folder exists.
+ *
+ * False is the lazy-load fast path: the adapter module is never imported and
+ * the driver answers with the loader's own empty-input output (drift-guarded
+ * by tests) — so a webhook-only agent never loads the chat SDKs.
+ */
+export async function isChannelConfigured(input, spec) {
+    for (const [key, value] of Object.entries(input.env)) {
+        if (value !== undefined && key.startsWith(spec.envPrefix)) {
+            return true;
+        }
+    }
+    const { json } = await readSettingsJson(input.configPath);
+    if (json[spec.jsonKey] !== undefined) {
+        return true;
+    }
+    if (spec.dir !== undefined) {
+        try {
+            await access(resolve(input.cwd, spec.dir));
+            return true;
+        }
+        catch {
+            // folder absent → no intent from this signal
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=channel-gate.js.map

package/dist/channel-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-gate.js","sourceRoot":"","sources":["../src/channel-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAc/D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAA8B,EAC9B,IAAqB;IAErB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAK,IAAgC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/channel-plugins.d.ts

@@ -0,0 +1,39 @@
+import type { SettingsJsonValue } from "@mono-agent/agent-contracts";
+import type { MonoAgentAppConfigInput } from "./app-config.js";
+import type { ChannelGateSpec } from "./channel-gate.js";
+import type { ChannelDriver } from "./channels.js";
+export type ChannelPluginConfigErrorCode = "invalid_plugin_config" | "plugin_import_failed" | "malformed_plugin_export";
+export interface ChannelPluginConfigErrorDetails {
+    readonly code?: ChannelPluginConfigErrorCode;
+    readonly packageName?: string;
+    readonly pluginId?: string;
+    readonly reason?: string;
+}
+export declare class ChannelPluginConfigError extends Error {
+    readonly code: ChannelPluginConfigErrorCode;
+    readonly details: ChannelPluginConfigErrorDetails;
+    constructor(code: ChannelPluginConfigErrorCode, message: string, details?: ChannelPluginConfigErrorDetails);
+}
+export interface ChannelPluginEntry {
+    readonly packageName: string;
+    readonly id?: string;
+    readonly label?: string;
+    readonly config?: RawPluginConfig;
+}
+type RawPluginConfig = Readonly<Record<string, SettingsJsonValue>>;
+export interface ResolveConfiguredChannelPluginsOptions {
+    readonly reservedIds?: Iterable<string>;
+}
+interface ExternalPackageChannelDriverOptions {
+    readonly packageName: string;
+    readonly id: string;
+    readonly label: string;
+    readonly gate: ChannelGateSpec;
+    readonly unconfiguredConfig: unknown;
+    readonly unconfiguredDisabledReason: string;
+    readonly factoryOptions?: Record<string, unknown>;
+}
+export declare function resolveConfiguredChannelPlugins(input: MonoAgentAppConfigInput, options?: ResolveConfiguredChannelPluginsOptions): Promise<readonly ChannelDriver[]>;
+export declare function createExternalPackageChannelDriver(options: ExternalPackageChannelDriverOptions): ChannelDriver;
+export {};
+//# sourceMappingURL=channel-plugins.d.ts.map

package/dist/channel-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-plugins.d.ts","sourceRoot":"","sources":["../src/channel-plugins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA0C,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE7G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,4BAA4B,GACpC,uBAAuB,GACvB,sBAAsB,GACtB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,4BAA4B,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,+BAA+B,CAAC;gBAGhD,IAAI,EAAE,4BAA4B,EAClC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,+BAAoC;CAOhD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,KAAK,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAanE,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACzC;AAWD,UAAU,mCAAmC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnD;AAED,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,uBAAuB,EAC9B,OAAO,GAAE,sCAA2C,GACnD,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAQnC;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,mCAAmC,GAC3C,aAAa,CAuDf"}

package/dist/channel-plugins.js

@@ -0,0 +1,346 @@
+import { readSettingsJson } from "@mono-agent/agent-contracts";
+import { isChannelConfigured } from "./channel-gate.js";
+export class ChannelPluginConfigError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "ChannelPluginConfigError";
+        this.code = code;
+        this.details = { ...details, code };
+    }
+}
+export async function resolveConfiguredChannelPlugins(input, options = {}) {
+    const entries = await readConfiguredChannelPluginEntries(input.configPath);
+    const checkedEntries = rejectChannelPluginIdCollisions(entries, options.reservedIds ?? []);
+    const drivers = [];
+    for (const entry of checkedEntries) {
+        drivers.push(await resolveChannelPlugin(entry));
+    }
+    return drivers;
+}
+export function createExternalPackageChannelDriver(options) {
+    let driver;
+    let loading;
+    const loadDriver = async () => {
+        loading ??= loadChannelPluginDriver({
+            packageName: options.packageName,
+            id: options.id,
+            label: options.label,
+            ...(options.factoryOptions === undefined ? {} : { factoryOptions: options.factoryOptions }),
+        });
+        try {
+            driver = await loading;
+            return driver;
+        }
+        catch (error) {
+            loading = undefined;
+            throw error;
+        }
+    };
+    return {
+        id: options.id,
+        label: options.label,
+        async configView(input) {
+            if (!(await isChannelConfigured(input, options.gate))) {
+                return { id: options.id, label: options.label, status: "disabled", fields: [] };
+            }
+            const resolved = await loadDriver();
+            return await fallbackConfigView(resolved, input);
+        },
+        async loadConfig(input) {
+            if (!(await isChannelConfigured(input, options.gate))) {
+                return options.unconfiguredConfig;
+            }
+            return await (await loadDriver()).loadConfig(input);
+        },
+        isConfigError(error) {
+            return error instanceof ChannelPluginConfigError || driver?.isConfigError(error) === true;
+        },
+        disabledReason(config) {
+            if (config === options.unconfiguredConfig) {
+                return options.unconfiguredDisabledReason;
+            }
+            return driver?.disabledReason?.(config);
+        },
+        waitingReason(config) {
+            return driver?.waitingReason?.(config);
+        },
+        configIssues(config) {
+            return driver?.configIssues?.(config) ?? [];
+        },
+        async start(input) {
+            return await (await loadDriver()).start(input);
+        },
+    };
+}
+async function readConfiguredChannelPluginEntries(configPath) {
+    let json;
+    try {
+        json = (await readSettingsJson(configPath)).json;
+    }
+    catch {
+        return [];
+    }
+    const channels = json.channels;
+    if (channels === undefined) {
+        return [];
+    }
+    if (!isSettingsRecord(channels)) {
+        return [
+            {
+                id: "channel-plugin",
+                label: "Channel plugin",
+                code: "invalid_plugin_config",
+                message: "channels must be an object when channel plugins are configured.",
+            },
+        ];
+    }
+    const plugins = channels.plugins;
+    if (plugins === undefined) {
+        return [];
+    }
+    if (!Array.isArray(plugins)) {
+        return [
+            {
+                id: "channel-plugin",
+                label: "Channel plugin",
+                code: "invalid_plugin_config",
+                message: "channels.plugins must be an array.",
+            },
+        ];
+    }
+    return plugins.map((entry, index) => parseChannelPluginEntry(entry, index));
+}
+function parseChannelPluginEntry(entry, index) {
+    const fallbackId = `channel-plugin-${index + 1}`;
+    if (!isSettingsRecord(entry)) {
+        return {
+            id: fallbackId,
+            label: "Channel plugin",
+            code: "invalid_plugin_config",
+            message: `channels.plugins[${index}] must be an object.`,
+        };
+    }
+    const explicitId = readOptionalNonEmptyString(entry.id);
+    const explicitLabel = readOptionalNonEmptyString(entry.label);
+    const packageName = readOptionalNonEmptyString(entry.package);
+    const id = explicitId ?? (packageName === undefined ? fallbackId : channelIdFromPackageName(packageName));
+    const label = explicitLabel ?? labelFromChannelId(id);
+    if (packageName === undefined) {
+        return {
+            id,
+            label,
+            code: "invalid_plugin_config",
+            message: `channels.plugins[${index}].package must be a non-empty package name.`,
+        };
+    }
+    let config;
+    if (entry.config !== undefined) {
+        if (!isSettingsRecord(entry.config)) {
+            return {
+                id,
+                label,
+                packageName,
+                pluginId: id,
+                code: "invalid_plugin_config",
+                message: `channels.plugins[${index}].config must be an object.`,
+            };
+        }
+        config = entry.config;
+    }
+    return {
+        packageName,
+        ...(explicitId === undefined ? {} : { id: explicitId }),
+        ...(explicitLabel === undefined ? {} : { label: explicitLabel }),
+        ...(config === undefined ? {} : { config }),
+    };
+}
+function rejectChannelPluginIdCollisions(entries, reservedIds) {
+    const reserved = new Set(reservedIds);
+    const seen = new Set(reserved);
+    return entries.map((entry, index) => {
+        const id = pluginEntryId(entry);
+        if (!seen.has(id)) {
+            seen.add(id);
+            return entry;
+        }
+        const collisionTarget = reserved.has(id) ? "a built-in channel" : "an earlier channel plugin";
+        const sectionId = uniqueInvalidPluginId(index, seen);
+        const label = `${pluginEntryLabel(entry)} plugin`;
+        const packageName = pluginEntryPackageName(entry);
+        return {
+            id: sectionId,
+            label,
+            ...(packageName === undefined ? {} : { packageName }),
+            pluginId: id,
+            code: "invalid_plugin_config",
+            message: `channels.plugins[${index}] resolves to channel id "${id}", which collides with ${collisionTarget}. Choose a unique plugin id.`,
+        };
+    });
+}
+function uniqueInvalidPluginId(index, seen) {
+    const base = `channel-plugin-${index + 1}`;
+    let candidate = base;
+    let suffix = 2;
+    while (seen.has(candidate)) {
+        candidate = `${base}-${suffix}`;
+        suffix += 1;
+    }
+    seen.add(candidate);
+    return candidate;
+}
+function pluginEntryId(entry) {
+    if ("message" in entry) {
+        return entry.pluginId ?? entry.id;
+    }
+    return entry.id ?? channelIdFromPackageName(entry.packageName);
+}
+function pluginEntryLabel(entry) {
+    if ("message" in entry) {
+        return entry.label;
+    }
+    return entry.label ?? labelFromChannelId(pluginEntryId(entry));
+}
+function pluginEntryPackageName(entry) {
+    return "packageName" in entry ? entry.packageName : undefined;
+}
+async function resolveChannelPlugin(entry) {
+    if ("message" in entry) {
+        return createUnavailablePluginDriver(entry.id, entry.label, entry.message, {
+            ...(entry.packageName === undefined ? {} : { packageName: entry.packageName }),
+            pluginId: entry.pluginId ?? entry.id,
+            code: entry.code,
+        });
+    }
+    try {
+        return await loadChannelPluginDriver(entry);
+    }
+    catch (error) {
+        const id = entry.id ?? channelIdFromPackageName(entry.packageName);
+        const label = entry.label ?? labelFromChannelId(id);
+        const message = error instanceof ChannelPluginConfigError
+            ? error.message
+            : `Cannot load channel plugin ${entry.packageName}: ${reasonOf(error)}. Install the package or remove it from channels.plugins.`;
+        const code = error instanceof ChannelPluginConfigError ? error.code : "plugin_import_failed";
+        return createUnavailablePluginDriver(id, label, message, {
+            packageName: entry.packageName,
+            pluginId: id,
+            code,
+        });
+    }
+}
+async function loadChannelPluginDriver(input) {
+    let mod;
+    try {
+        mod = await import(input.packageName);
+    }
+    catch (error) {
+        throw new ChannelPluginConfigError("plugin_import_failed", `Cannot load channel plugin ${input.packageName}: ${reasonOf(error)}. Install the package or remove it from channels.plugins.`, { packageName: input.packageName, ...(input.id === undefined ? {} : { pluginId: input.id }), reason: reasonOf(error) });
+    }
+    const factory = channelDriverFactory(mod);
+    if (factory === undefined) {
+        throw malformedPluginExport(input.packageName, input.id);
+    }
+    let driver;
+    try {
+        driver = await factory({
+            ...(input.factoryOptions ?? {}),
+            ...(input.id === undefined ? {} : { id: input.id }),
+            ...(input.label === undefined ? {} : { label: input.label }),
+            ...(input.config === undefined ? {} : { config: input.config }),
+        });
+    }
+    catch (error) {
+        throw new ChannelPluginConfigError("malformed_plugin_export", `Channel plugin ${input.packageName} failed while creating its driver: ${reasonOf(error)}`, { packageName: input.packageName, ...(input.id === undefined ? {} : { pluginId: input.id }), reason: reasonOf(error) });
+    }
+    if (!isChannelDriver(driver)) {
+        throw malformedPluginExport(input.packageName, input.id);
+    }
+    return driver;
+}
+function channelDriverFactory(mod) {
+    if (!isUnknownRecord(mod)) {
+        return undefined;
+    }
+    const factory = mod.createChannelDriver ?? mod.default;
+    return typeof factory === "function" ? factory : undefined;
+}
+function createUnavailablePluginDriver(id, label, message, options = {}) {
+    const code = options.code ?? (options.packageName === undefined ? "invalid_plugin_config" : "plugin_import_failed");
+    const error = new ChannelPluginConfigError(code, message, {
+        ...(options.packageName === undefined ? {} : { packageName: options.packageName }),
+        pluginId: options.pluginId ?? id,
+    });
+    return {
+        id,
+        label,
+        async configView() {
+            return { id, label, status: "active", fields: [] };
+        },
+        async loadConfig() {
+            throw error;
+        },
+        isConfigError(candidate) {
+            return candidate instanceof ChannelPluginConfigError;
+        },
+        async start() {
+            throw error;
+        },
+    };
+}
+async function fallbackConfigView(driver, input) {
+    if (driver.configView !== undefined) {
+        return await driver.configView(input);
+    }
+    let status = "active";
+    try {
+        const config = await driver.loadConfig(input);
+        if (driver.disabledReason?.(config) !== undefined) {
+            status = "disabled";
+        }
+    }
+    catch (error) {
+        if (!driver.isConfigError(error)) {
+            throw error;
+        }
+    }
+    return { id: driver.id, label: driver.label, status, fields: [] };
+}
+function malformedPluginExport(packageName, pluginId) {
+    return new ChannelPluginConfigError("malformed_plugin_export", `Channel plugin ${packageName} must export createChannelDriver(options) returning a ChannelDriver.`, { packageName, ...(pluginId === undefined ? {} : { pluginId }) });
+}
+function isChannelDriver(value) {
+    return (isUnknownRecord(value) &&
+        typeof value.id === "string" &&
+        value.id.trim().length > 0 &&
+        typeof value.label === "string" &&
+        value.label.trim().length > 0 &&
+        typeof value.loadConfig === "function" &&
+        typeof value.isConfigError === "function" &&
+        typeof value.start === "function");
+}
+function isSettingsRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isUnknownRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readOptionalNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+function channelIdFromPackageName(packageName) {
+    const segment = packageName.split("/").pop() ?? packageName;
+    return segment.endsWith("-adapter") ? segment.slice(0, -"-adapter".length) : segment;
+}
+function labelFromChannelId(id) {
+    return id
+        .split(/[-_]+/u)
+        .filter((part) => part.length > 0)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(" ") || "Channel plugin";
+}
+function reasonOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=channel-plugins.js.map