@a5c-ai/channels-adapter 5.1.1-staging.5ee7f5f98b91

package/dist/backends/jira.js

@@ -0,0 +1,256 @@
+// Jira backend (SPEC §4.2 / §5.2, DESIGN §5.2).
+//
+// Poll: POST {baseUrl}/rest/api/3/search with JQL
+//   project = "<P>" AND created >= "<cursor>" ORDER BY created ASC
+// (uses `updated` for the issue_updated event), plus any config.jql extra clause.
+// The `created >=` clause is omitted when the cursor is null (first poll).
+//
+// The catch: Jira JQL datetime comparisons are minute-granularity, so two issues
+// created in the same minute as the cursor both re-match `created >= "<cursor>"`
+// on the next poll. The cursor alone cannot guarantee at-most-once, so we combine
+// it with a seen-set keyed by `jira:<key>:<created>` (issue key + full timestamp).
+// Re-matched same-minute issues are recognized as already-seen and dropped.
+//
+// All network access goes through the injected `http` (fetch-like) so tests run
+// offline. Auth is HTTP Basic: base64(email:token).
+import { defineBackend } from '../backend.js';
+import { deriveNew } from '../dedup.js';
+/** Resolve the Jira site base URL. */
+function baseUrlFor(source) {
+    return String(source?.auth?.baseUrl || source?.config?.baseUrl || '').replace(/\/+$/, '');
+}
+/** Authenticated request headers for the Jira Cloud REST API (Basic auth). */
+function jiraHeaders(source) {
+    const email = source?.auth?.email ?? '';
+    const token = source?.auth?.token ?? '';
+    const basic = Buffer.from(`${email}:${token}`, 'utf8').toString('base64');
+    return {
+        authorization: `Basic ${basic}`,
+        accept: 'application/json',
+        'content-type': 'application/json'
+    };
+}
+/** Which timestamp field this event kind orders/filters on. */
+function timeField(events) {
+    return Array.isArray(events) && events.includes('issue_updated') ? 'updated' : 'created';
+}
+/** The event kind label for meta. */
+function kindFor(events) {
+    return Array.isArray(events) && events.includes('issue_updated')
+        ? 'issue_updated'
+        : 'issue_created';
+}
+/** A Jira project key must be a safe identifier so it can't inject into the JQL. */
+const PROJECT_RE = /^[A-Za-z0-9_]+$/;
+/**
+ * Format a stored cursor (a full-precision Jira/ISO timestamp) into the
+ * JQL-accepted quoted `"yyyy-MM-dd HH:mm"` literal (minute granularity). Jira
+ * rejects sub-minute precision in datetime comparisons, so we down-convert for
+ * the QUERY only; the full-precision timestamp is kept in the cursor + seen-set
+ * key so same-minute dedup still works (SPEC §5.2, finding §10).
+ * Returns null if the cursor can't be parsed (the clause is then omitted).
+ */
+function jqlDateLiteral(cursor) {
+    if (!cursor)
+        return null;
+    const d = new Date(cursor);
+    if (Number.isNaN(d.getTime()))
+        return null;
+    const p = (n) => String(n).padStart(2, '0');
+    // Use UTC so the literal is stable regardless of the host timezone.
+    return (`${d.getUTCFullYear()}-${p(d.getUTCMonth() + 1)}-${p(d.getUTCDate())} ` +
+        `${p(d.getUTCHours())}:${p(d.getUTCMinutes())}`);
+}
+/**
+ * Build the JQL string for this poll. The project is validated against
+ * [A-Za-z0-9_]+ (defensive: validateConfig already enforces this) and any
+ * config.jql extra clause is wrapped + quote-escaped so neither can inject into
+ * the query.
+ */
+function buildJql(source, cursor, field) {
+    const project = source.config.project;
+    if (!PROJECT_RE.test(String(project))) {
+        // Defensive: should be unreachable (validateConfig rejects this at load).
+        throw new Error(`jira: unsafe project key ${JSON.stringify(project)}`);
+    }
+    const clauses = [`project = "${project}"`];
+    const dateLiteral = jqlDateLiteral(cursor);
+    if (dateLiteral)
+        clauses.push(`${field} >= "${dateLiteral}"`);
+    if (source.config.jql) {
+        // config.jql is OPERATOR-supplied input from the trusted YAML config (NOT
+        // external/attacker-controlled channel data), so it is trusted JQL-operator
+        // input. The quote/backslash/semicolon strip below is therefore
+        // DEFENSE-IN-DEPTH only — a belt-and-suspenders guard so an accidental stray
+        // quote in a hand-written clause can't terminate the surrounding string and
+        // smuggle a trailing clause — not a sanitizer for untrusted input. The
+        // fragment is wrapped in parentheses so it composes as a single AND term.
+        const jql = String(source.config.jql).replace(/["\\;]/g, '');
+        if (jql.trim().length)
+            clauses.push(`(${jql})`);
+    }
+    return `${clauses.join(' AND ')} ORDER BY ${field} ASC`;
+}
+/** Wrap plain reply text in a minimal Atlassian Document Format (ADF) body. */
+function adfBody(text) {
+    return {
+        body: {
+            type: 'doc',
+            version: 1,
+            content: [
+                {
+                    type: 'paragraph',
+                    content: [{ type: 'text', text: String(text ?? '') }]
+                }
+            ]
+        }
+    };
+}
+/** Pick the lexicographically-max timestamp (ISO-ish strings sort chronologically). */
+function maxTimestamp(values, start) {
+    let max = start ?? null;
+    for (const v of values) {
+        if (v && (max == null || v > max))
+            max = v;
+    }
+    return max;
+}
+/** Build the channel content for an issue (summary + key context). */
+function contentForIssue(issue) {
+    const summary = issue?.fields?.summary ?? '';
+    return `${summary}\n\n(${issue?.key ?? ''})`;
+}
+/** The Jira event kinds this backend understands. */
+const JIRA_EVENT_KINDS = new Set(['issue_created', 'issue_updated']);
+/** Page size for the paginated /search loop. */
+const PAGE_SIZE = 50;
+/**
+ * Run the Jira /search query across ALL pages by looping `startAt` until
+ * `startAt + len >= total`, accumulating every issue before the caller computes
+ * the cursor (so the cursor never advances past unfetched issues — finding §4).
+ * On ANY non-2xx page returns `{ ok:false, issues:[] }` so a failed poll advances
+ * nothing (finding §5). A `maxPages` guard bounds a pathological loop.
+ */
+async function searchAll(url, jql, source, http, maxPages = 200) {
+    const all = [];
+    let startAt = 0;
+    let pages = 0;
+    // total defaults to +Inf until the first page tells us the real count.
+    let total = Infinity;
+    while (startAt < total && pages < maxPages) {
+        const res = (await http(url, {
+            method: 'POST',
+            headers: jiraHeaders(source),
+            body: JSON.stringify({ jql, startAt, maxResults: PAGE_SIZE })
+        }));
+        if (!res || !res.ok)
+            return { ok: false, issues: [] };
+        const data = (await res.json().catch(() => null));
+        const issues = Array.isArray(data?.issues) ? data.issues : [];
+        all.push(...issues);
+        total = typeof data?.total === 'number' ? data.total : all.length;
+        pages += 1;
+        // Advance by what we actually received; stop if a page came back empty.
+        if (issues.length === 0)
+            break;
+        startAt += issues.length;
+    }
+    return { ok: true, issues: all };
+}
+export default defineBackend({
+    type: 'jira',
+    /**
+     * Validate a Jira source at config-load time so misconfiguration is a clear
+     * validation error rather than a crash at poll time (SPEC §4.2, AC-3). Requires
+     * config.project (safe identifier), a non-empty events list, and
+     * auth.baseUrl/email/token. Also rejects a project value that could inject into
+     * the JQL string (SPEC §9 security).
+     */
+    validateConfig(source) {
+        const s = source;
+        const errors = [];
+        const id = s?.id ?? '(unknown)';
+        const cfg = s?.config || {};
+        const auth = s?.auth || {};
+        const project = cfg.project;
+        if (typeof project !== 'string' || project.length === 0) {
+            errors.push(`Source "${id}": jira config.project is required.`);
+        }
+        else if (!PROJECT_RE.test(project)) {
+            errors.push(`Source "${id}": jira config.project must match [A-Za-z0-9_]+ ` +
+                `(got ${JSON.stringify(project)}).`);
+        }
+        const events = cfg.events;
+        if (!Array.isArray(events) || events.length === 0) {
+            errors.push(`Source "${id}": jira config.events must be a non-empty array.`);
+        }
+        else {
+            const bad = events.filter((e) => !JIRA_EVENT_KINDS.has(e));
+            if (bad.length) {
+                errors.push(`Source "${id}": jira config.events has unknown kind(s) ${JSON.stringify(bad)} ` +
+                    `(valid: ${[...JIRA_EVENT_KINDS].join(', ')}).`);
+            }
+        }
+        if (!auth.baseUrl)
+            errors.push(`Source "${id}": jira auth.baseUrl is required.`);
+        if (!auth.email)
+            errors.push(`Source "${id}": jira auth.email is required.`);
+        if (!auth.token)
+            errors.push(`Source "${id}": jira auth.token is required.`);
+        return errors;
+    },
+    async poll(ctx) {
+        const { source: srcRaw, state, http } = ctx;
+        const source = srcRaw;
+        const cursor = state?.cursor ?? null;
+        const seen = state?.seen ?? [];
+        const events = source?.config?.events;
+        const field = timeField(events);
+        const kind = kindFor(events);
+        const jql = buildJql(source, cursor, field);
+        const url = `${baseUrlFor(source)}/rest/api/3/search`;
+        // Fetch ALL pages (loop startAt until startAt+len >= total) so issues beyond
+        // the first page aren't lost and the cursor never advances past them.
+        const { ok, issues } = await searchAll(url, jql, source, http);
+        // On a failed poll, advance NOTHING: keep the prior cursor + seen, emit nothing.
+        if (!ok)
+            return { events: [], state: { cursor, seen } };
+        // Seen-set keyed by <key>:<created> (full timestamp) defeats minute-granularity
+        // JQL re-matches: a same-minute issue re-returned next poll is already seen.
+        const fieldOf = (issue) => issue?.fields?.[field];
+        const idOf = (issue) => `jira:${issue.key}:${fieldOf(issue)}`;
+        const { fresh, seen: nextSeen } = deriveNew(issues, { idOf, seen });
+        const channelEvents = fresh.map((issue) => ({
+            id: idOf(issue),
+            content: contentForIssue(issue),
+            meta: {
+                project: issue?.fields?.project?.key ?? source.config.project,
+                issue_key: issue.key,
+                kind
+            },
+            payload: issue,
+            routing: { key: issue.key }
+        }));
+        // Cursor = max created/updated observed across the returned issues.
+        const nextCursor = maxTimestamp(issues.map(fieldOf), cursor);
+        return { events: channelEvents, state: { cursor: nextCursor, seen: nextSeen } };
+    },
+    /**
+     * Post a comment back to the originating Jira issue (ADF body).
+     */
+    async reply({ routing, text, source, http }) {
+        const key = routing?.key;
+        const url = `${baseUrlFor(source)}/rest/api/3/issue/${key}/comment`;
+        const res = (await http(url, {
+            method: 'POST',
+            headers: jiraHeaders(source),
+            body: JSON.stringify(adfBody(text))
+        }));
+        if (res && res.ok) {
+            const created = (await res.json().catch(() => null));
+            return { ok: true, ref: created ? String(created.id ?? '') : undefined };
+        }
+        return { ok: false };
+    }
+});
+//# sourceMappingURL=jira.js.map

package/dist/backends/jira.js.map

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

package/dist/backends/webhook.d.ts

@@ -0,0 +1,25 @@
+import type { PollContext, PollResult, ReplyArgs, ReplyResult } from '../types.js';
+declare const _default: {
+    type: string;
+    /**
+     * Validate a webhook source at config-load time (SPEC §4 contract). Requires a
+     * recognized `config.backend`, and at least one configured queue source
+     * (`config.payloads` or `config.dir`). Surfaces clear, per-source messages.
+     */
+    validateConfig(source: Record<string, unknown>): string[];
+    /**
+     * Read the configured queue of captured webhook payloads, normalize each via the
+     * triggers-adapter `normalizeEvent(backend, eventName, payload)`, and emit a
+     * channel event per genuinely-new payload (dedup by stable id). The cursor is
+     * unused (the queue source owns ordering); `seen` carries the dedup set.
+     */
+    poll(ctx: PollContext): Promise<PollResult>;
+    /**
+     * A webhook is a one-way inbound notification with no generic callback channel,
+     * so a reply cannot be routed back. Surface a CLEAR error rather than silently
+     * succeeding or no-op'ing (fallbacks are evil): a caller wanting to reply should
+     * route through the concrete `github`/`jira` backend the payload originated from.
+     */
+    reply({ routing }: ReplyArgs): Promise<ReplyResult>;
+};
+export default _default;

package/dist/backends/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/backends/webhook.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAgB,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;;;IAqH/F;;;;OAIG;2BACoB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE;IA2BzD;;;;;OAKG;cACa,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAyCjD;;;;;OAKG;uBACsB,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;;AAxF3D,wBAgGG"}

package/dist/backends/webhook.js

@@ -0,0 +1,206 @@
+// Webhook backend (OPTIONAL, additive — SPEC §4 backend contract, DESIGN §5).
+//
+// An ADDITIVE built-in backend alongside `github` and `jira`. It does NOT replace
+// or alter them. It turns INBOUND WEBHOOK PAYLOADS (GitHub / GitLab / Bitbucket /
+// generic) into channel events by delegating the parsing to the genuine
+// `@a5c-ai/triggers-adapter` `normalizeEvent(backend, eventName, payload)` — the
+// same normalizer the triggers-adapter uses for CI/action triggers — so the
+// channels framework reuses that battle-tested webhook-shape knowledge instead of
+// re-deriving it.
+//
+// Channels is POLL-BASED, so this backend reads a QUEUE of already-captured
+// webhook payloads from a configured source and normalizes each on every poll:
+//   - `config.payloads`: an inline array of captured webhook entries (the
+//     injection seam — used by tests and by a caller that buffers receipts itself).
+//   - `config.dir`: a directory of captured `*.json` payload files (read through
+//     the injected `readDir`/`readFile` so the suite stays offline; defaults to the
+//     real node:fs/promises when unset).
+// Each queue entry is `{ eventName, payload, id? }` (or a bare payload object, in
+// which case `eventName` falls back to `config.eventName`).
+//
+// LIVE HTTP webhook RECEIPT is intentionally OUT OF SCOPE here (it needs a bound
+// HTTP listener / tunnel, mirroring how the spawner documents live agent launch as
+// out of offline-test scope, DESIGN §7.7). This backend only normalizes payloads
+// that some out-of-band receiver has already captured and queued.
+//
+// REPLY: a webhook is a one-way notification; there is no generic callback channel
+// to post back to. `reply()` therefore surfaces a CLEAR, actionable error rather
+// than silently dropping the reply (fallbacks are evil). A caller that wants to
+// reply should route through the concrete backend (`github`/`jira`) the payload
+// originated from, not through `webhook`.
+import { normalizeEvent } from '@a5c-ai/triggers-adapter';
+import { defineBackend } from '../backend.js';
+import { deriveNew } from '../dedup.js';
+/** The webhook backends `normalizeEvent` understands (mirrors TriggerBackend). */
+const WEBHOOK_BACKENDS = new Set([
+    'github',
+    'gitlab',
+    'bitbucket',
+    'generic-webhook'
+]);
+/** Resolve the configured trigger backend, defaulting to the generic shape. */
+function backendFor(source) {
+    const raw = source?.config?.backend;
+    return WEBHOOK_BACKENDS.has(raw) ? raw : 'generic-webhook';
+}
+/** Coerce one queue item into a normalized `{ eventName, payload, id? }` envelope. */
+function asEntry(item, fallbackEventName) {
+    if (item && typeof item === 'object' && 'payload' in item) {
+        const e = item;
+        return { eventName: e.eventName ?? fallbackEventName, payload: e.payload, id: e.id };
+    }
+    // A bare payload object — the eventName comes from config.eventName.
+    return { eventName: fallbackEventName, payload: item };
+}
+/** Load the inline `config.payloads` queue (the injection seam). */
+function inlineQueue(source) {
+    const payloads = source?.config?.payloads;
+    return Array.isArray(payloads) ? payloads : [];
+}
+/** Load + parse the `config.dir` queue of captured `*.json` payload files (sorted
+ *  by filename so emit order is stable). A file that fails to parse is skipped with
+ *  a log line rather than failing the whole poll. */
+async function dirQueue(source, ctx, fs) {
+    const dir = source?.config?.dir;
+    if (typeof dir !== 'string' || dir === '')
+        return [];
+    let names;
+    try {
+        names = (await fs.readdir(dir)).filter((n) => n.toLowerCase().endsWith('.json')).sort();
+    }
+    catch (err) {
+        ctx.log(`webhook: failed to read dir "${dir}": ${err?.message || err}`);
+        return [];
+    }
+    const out = [];
+    for (const name of names) {
+        const full = `${dir.replace(/[/\\]+$/, '')}/${name}`;
+        try {
+            out.push(JSON.parse(await fs.readFile(full, 'utf8')));
+        }
+        catch (err) {
+            ctx.log(`webhook: skipping unparseable payload "${full}": ${err?.message || err}`);
+        }
+    }
+    return out;
+}
+/**
+ * The stable dedup id for a normalized webhook event. Prefer an explicit entry
+ * `id` (the receiver's delivery id, e.g. GitHub `X-GitHub-Delivery`), else derive
+ * a deterministic id from the normalized shape (backend + event + sha/url/repo).
+ */
+function dedupId(entryId, n) {
+    if (entryId != null && entryId !== '')
+        return `webhook:${n.backend}:${entryId}`;
+    const discriminator = n.sha || n.url || `${n.repository ?? ''}#${n.ref ?? ''}`;
+    return `webhook:${n.backend}:${n.eventName}:${n.action ?? ''}:${discriminator}`;
+}
+/** Build the channel content from the normalized trigger event (title + body, or
+ *  the normalizer's collected `text` when neither is present). */
+function contentFor(n) {
+    const parts = [n.title, n.body].filter((p) => typeof p === 'string' && p !== '');
+    if (parts.length > 0)
+        return parts.join('\n\n');
+    return n.text ?? '';
+}
+/** meta keys MUST be `[A-Za-z0-9_]+`; values are stringified, empties dropped. */
+function metaFor(n) {
+    const meta = {
+        backend: n.backend,
+        event: n.eventName
+    };
+    const optional = {
+        action: n.action,
+        repo: n.repository,
+        author: n.actor,
+        ref: n.ref,
+        sha: n.sha,
+        source_branch: n.sourceBranch,
+        target_branch: n.targetBranch,
+        url: n.url
+    };
+    for (const [k, v] of Object.entries(optional)) {
+        if (v != null && v !== '')
+            meta[k] = String(v);
+    }
+    return meta;
+}
+export default defineBackend({
+    type: 'webhook',
+    /**
+     * Validate a webhook source at config-load time (SPEC §4 contract). Requires a
+     * recognized `config.backend`, and at least one configured queue source
+     * (`config.payloads` or `config.dir`). Surfaces clear, per-source messages.
+     */
+    validateConfig(source) {
+        const s = source;
+        const errors = [];
+        const id = s?.id ?? '(unknown)';
+        const cfg = s?.config || {};
+        if (!WEBHOOK_BACKENDS.has(cfg.backend)) {
+            errors.push(`Source "${id}": webhook config.backend must be one of ${[...WEBHOOK_BACKENDS].join(', ')}.`);
+        }
+        const hasInline = Array.isArray(cfg.payloads);
+        const hasDir = typeof cfg.dir === 'string' && cfg.dir !== '';
+        if (!hasInline && !hasDir) {
+            errors.push(`Source "${id}": webhook needs a queue source — set config.payloads (array) or config.dir (path).`);
+        }
+        if (cfg.eventName != null && typeof cfg.eventName !== 'string') {
+            errors.push(`Source "${id}": webhook config.eventName must be a string when set.`);
+        }
+        return errors;
+    },
+    /**
+     * Read the configured queue of captured webhook payloads, normalize each via the
+     * triggers-adapter `normalizeEvent(backend, eventName, payload)`, and emit a
+     * channel event per genuinely-new payload (dedup by stable id). The cursor is
+     * unused (the queue source owns ordering); `seen` carries the dedup set.
+     */
+    async poll(ctx) {
+        const source = ctx.source;
+        const state = ctx.state || { cursor: null, seen: [] };
+        const seen = state.seen ?? [];
+        const backend = backendFor(source);
+        const fallbackEventName = String(source?.config?.eventName ?? backend);
+        // The fs seam defaults to node:fs/promises; tests inject `config.fs`.
+        const fs = source?.config?.fs || (await import('node:fs/promises'));
+        const raw = [...inlineQueue(source), ...(await dirQueue(source, ctx, fs))];
+        // Normalize each queued payload into a (entry, normalized) pair.
+        const normalized = raw.map((item) => {
+            const entry = asEntry(item, fallbackEventName);
+            const n = normalizeEvent(backend, String(entry.eventName ?? backend), entry.payload);
+            return { id: dedupId(entry.id, n), n };
+        });
+        const { fresh, seen: nextSeen } = deriveNew(normalized, { idOf: (x) => x.id, seen });
+        const events = fresh.map(({ id, n }) => ({
+            id,
+            content: contentFor(n),
+            meta: metaFor(n),
+            // The raw upstream payload, so declarative dot-path filters can match.
+            payload: (n.raw && typeof n.raw === 'object' ? n.raw : { raw: n.raw }),
+            // Origin coordinates for a reply: the normalized identity. There is no live
+            // callback channel, so reply() is unsupported (see below) — this is recorded
+            // for diagnostics / downstream routing only.
+            routing: {
+                backend: n.backend,
+                eventName: n.eventName,
+                repository: n.repository,
+                url: n.url
+            }
+        }));
+        return { events, state: { cursor: state.cursor ?? null, seen: nextSeen } };
+    },
+    /**
+     * A webhook is a one-way inbound notification with no generic callback channel,
+     * so a reply cannot be routed back. Surface a CLEAR error rather than silently
+     * succeeding or no-op'ing (fallbacks are evil): a caller wanting to reply should
+     * route through the concrete `github`/`jira` backend the payload originated from.
+     */
+    async reply({ routing }) {
+        const r = routing;
+        throw new Error(`webhook backend does not support reply: a webhook is a one-way inbound ` +
+            `notification with no callback channel (origin backend="${r?.backend ?? 'unknown'}", ` +
+            `event="${r?.eventName ?? 'unknown'}"). Reply through the concrete backend instead.`);
+    }
+});
+//# sourceMappingURL=webhook.js.map

package/dist/backends/webhook.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// mcp-channels CLI entry (stdio MCP server bootstrap).
+//
+// Usage: mcp-channels <path/to/channels.yml>
+//        node dist/cli.js examples/channels.yml
+//
+// Thin wrapper: resolve the config path from argv, build the runtime, and start
+// it. All real logic lives in runtime.js (and the modules it composes). This
+// file is intentionally trivial and is excluded from coverage.
+import { createRuntime } from './runtime.js';
+const configPath = process.argv[2];
+if (!configPath) {
+    process.stderr.write('Usage: mcp-channels <config.yml>\n' +
+        '  e.g. mcp-channels examples/channels.yml\n');
+    process.exit(1);
+}
+// Wrap the bootstrap so a misconfig (e.g. aggregated validation errors from
+// createRuntime, or a bad custom-backend import) prints a clean message to stderr
+// and exits non-zero, rather than surfacing as an unhandled promise rejection.
+try {
+    const runtime = await createRuntime(configPath);
+    await runtime.start();
+}
+catch (err) {
+    process.stderr.write(`${err?.message || String(err)}\n`);
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,uDAAuD;AACvD,EAAE;AACF,6CAA6C;AAC7C,gDAAgD;AAChD,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,+DAA+D;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,CAAC,UAAU,EAAE,CAAC;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oCAAoC;QAClC,6CAA6C,CAChD,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,4EAA4E;AAC5E,kFAAkF;AAClF,+EAA+E;AAC/E,IAAI,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAI,GAAa,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+import type { ChannelsConfig } from './types.js';
+/**
+ * Load and validate a channels config.
+ */
+export declare function loadConfig(input: string, opts?: {
+    env?: Record<string, string>;
+}): {
+    config: ChannelsConfig;
+    errors: string[];
+};

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAiC,MAAM,YAAY,CAAC;AA6KhF;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC1C;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAoK9C"}