managed-deepagents 0.4.0-dev.72 → 0.4.0

package/dist/channels/github/source-thread.js

@@ -0,0 +1,54 @@
+/**
+ * Stable GitHub source-thread keys for trusted channel ingress.
+ *
+ * Prefer issue/PR scoped keys when a number is known:
+ *   `github:<installationId>:<owner>/<repo>#<number>`
+ * Otherwise fall back to delivery-scoped keys:
+ *   `github:<installationId>:<owner>/<repo>:delivery:<deliveryId>`
+ *   `github:<installationId>:delivery:<deliveryId>`
+ */
+export function encodeGitHubSourceThreadKey(input) {
+    const install = input.installationId || "unknown";
+    if (input.owner &&
+        input.repo &&
+        typeof input.number === "number" &&
+        Number.isFinite(input.number)) {
+        return `github:${install}:${input.owner}/${input.repo}#${input.number}`;
+    }
+    if (input.owner && input.repo && input.deliveryId) {
+        return `github:${install}:${input.owner}/${input.repo}:delivery:${input.deliveryId}`;
+    }
+    if (input.deliveryId) {
+        return `github:${install}:delivery:${input.deliveryId}`;
+    }
+    return `github:${install}:delivery:unknown`;
+}
+export function decodeGitHubSourceThreadKey(key) {
+    const issue = /^github:([^:]+):([^/]+)\/([^#]+)#(\d+)$/.exec(key);
+    if (issue) {
+        return {
+            installationId: issue[1],
+            owner: issue[2],
+            repo: issue[3],
+            number: Number(issue[4]),
+        };
+    }
+    const repoDelivery = /^github:([^:]+):([^/]+)\/([^:]+):delivery:(.+)$/.exec(key);
+    if (repoDelivery) {
+        return {
+            installationId: repoDelivery[1],
+            owner: repoDelivery[2],
+            repo: repoDelivery[3],
+            deliveryId: repoDelivery[4],
+        };
+    }
+    const delivery = /^github:([^:]+):delivery:(.+)$/.exec(key);
+    if (delivery) {
+        return {
+            installationId: delivery[1],
+            deliveryId: delivery[2],
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=source-thread.js.map

package/dist/channels/github/source-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-thread.js","sourceRoot":"","sources":["../../../src/channels/github/source-thread.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,UAAU,2BAA2B,CAAC,KAM3C;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,IAAI,SAAS,CAAC;IAClD,IACE,KAAK,CAAC,KAAK;QACX,KAAK,CAAC,IAAI;QACV,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAC7B,CAAC;QACD,OAAO,UAAU,OAAO,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;IAC1E,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QAClD,OAAO,UAAU,OAAO,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,UAAU,EAAE,CAAC;IACvF,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO,UAAU,OAAO,aAAa,KAAK,CAAC,UAAU,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,UAAU,OAAO,mBAAmB,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,GAAW;IAOrD,MAAM,KAAK,GAAG,yCAAyC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClE,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,cAAc,EAAE,KAAK,CAAC,CAAC,CAAE;YACzB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAE;YAChB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE;YACf,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACzB,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,iDAAiD,CAAC,IAAI,CACzE,GAAG,CACJ,CAAC;IACF,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL,cAAc,EAAE,YAAY,CAAC,CAAC,CAAE;YAChC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAE;YACvB,IAAI,EAAE,YAAY,CAAC,CAAC,CAAE;YACtB,UAAU,EAAE,YAAY,CAAC,CAAC,CAAE;SAC7B,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,gCAAgC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5D,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAE;YAC5B,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAE;SACzB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/channels/github/transport.d.ts

@@ -0,0 +1,19 @@
+/**
+ * GitHub App installation transport — PR/issue comments via the REST API.
+ */
+import type { ChannelTransport } from "../runtime.js";
+export declare const GITHUB_APP_ID_ENV = "GITHUB_APP_ID";
+export declare const GITHUB_APP_PRIVATE_KEY_ENV = "GITHUB_APP_PRIVATE_KEY";
+export declare const GITHUB_INSTALLATION_ID_ENV = "GITHUB_INSTALLATION_ID";
+export interface GitHubAppTransportOptions {
+    appId: string;
+    privateKey: string;
+    installationId: string;
+    /** Override fetch (tests). */
+    fetch?: typeof fetch;
+}
+/**
+ * Build a {@link ChannelTransport} that posts/edits issue comments as the App.
+ */
+export declare function createGitHubAppTransport(options: GitHubAppTransportOptions): ChannelTransport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/channels/github/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/channels/github/transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AACjD,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AACnE,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AAEnE,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,gBAAgB,CA+DlB"}

package/dist/channels/github/transport.js

@@ -0,0 +1,92 @@
+/**
+ * GitHub App installation transport — PR/issue comments via the REST API.
+ */
+import { createPrivateKey } from "node:crypto";
+import { SignJWT } from "jose";
+export const GITHUB_APP_ID_ENV = "GITHUB_APP_ID";
+export const GITHUB_APP_PRIVATE_KEY_ENV = "GITHUB_APP_PRIVATE_KEY";
+export const GITHUB_INSTALLATION_ID_ENV = "GITHUB_INSTALLATION_ID";
+/**
+ * Build a {@link ChannelTransport} that posts/edits issue comments as the App.
+ */
+export function createGitHubAppTransport(options) {
+    const fetchImpl = options.fetch ?? fetch;
+    let installationToken;
+    async function getInstallationToken() {
+        const now = Date.now();
+        if (installationToken && installationToken.expiresAt > now + 60_000) {
+            return installationToken.token;
+        }
+        const jwt = await appJwt(options.appId, options.privateKey);
+        const res = await fetchImpl(`https://api.github.com/app/installations/${options.installationId}/access_tokens`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${jwt}`,
+                Accept: "application/vnd.github+json",
+                "X-GitHub-Api-Version": "2022-11-28",
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`GitHub installation token failed: ${res.status} ${await res.text()}`);
+        }
+        const body = (await res.json());
+        installationToken = {
+            token: body.token,
+            expiresAt: Date.parse(body.expires_at),
+        };
+        return body.token;
+    }
+    return {
+        async post(input) {
+            const target = parseConversationId(input.conversationId);
+            const token = await getInstallationToken();
+            const res = await fetchImpl(`https://api.github.com/repos/${target.owner}/${target.repo}/issues/${target.number}/comments`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    Accept: "application/vnd.github+json",
+                    "Content-Type": "application/json",
+                    "X-GitHub-Api-Version": "2022-11-28",
+                },
+                body: JSON.stringify({ body: input.text }),
+            });
+            if (!res.ok) {
+                throw new Error(`GitHub create comment failed: ${res.status} ${await res.text()}`);
+            }
+            const body = (await res.json());
+            return {
+                id: `github-comment:${body.id}`,
+                providerMessageId: String(body.id),
+            };
+        },
+    };
+}
+function parseConversationId(conversationId) {
+    const match = /^([^/]+)\/([^#]+)#(\d+)$/.exec(conversationId);
+    if (!match) {
+        throw new Error(`GitHub transport cannot parse conversationId "${conversationId}"`);
+    }
+    return {
+        owner: match[1],
+        repo: match[2],
+        number: Number(match[3]),
+    };
+}
+/**
+ * Sign an App JWT. Uses Node `createPrivateKey` so both PKCS#1
+ * (`BEGIN RSA PRIVATE KEY`, GitHub's download format) and PKCS#8 PEMs work.
+ */
+async function appJwt(appId, privateKeyPem) {
+    const key = createPrivateKey(normalizePem(privateKeyPem));
+    const now = Math.floor(Date.now() / 1000);
+    return new SignJWT({})
+        .setProtectedHeader({ alg: "RS256" })
+        .setIssuedAt(now - 60)
+        .setExpirationTime(now + 9 * 60)
+        .setIssuer(appId)
+        .sign(key);
+}
+function normalizePem(key) {
+    return key.includes("\\n") ? key.replace(/\\n/g, "\n") : key;
+}
+//# sourceMappingURL=transport.js.map

package/dist/channels/github/transport.js.map

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

package/dist/channels/index.d.ts

@@ -4,16 +4,23 @@
  * Import provider integrations from their own entrypoints, e.g.
  * `managed-deepagents/channels/slack`.
  */
-export type { ChannelAddress, ChannelAttachmentRef, ChannelCapabilities, ChannelDestination, ChannelErrorCode, ChannelEvent, ChannelInboundMessage, ChannelMessage, ChannelMessageUpdate, ChannelNativePayload, ChannelProvider, JsonValue, PostedChannelMessage, RuntimeChannel, } from "./types.js";
+export type { ChannelAddress, ChannelAttachmentRef, ChannelCapabilities, ChannelDestination, ChannelErrorCode, ChannelEvent, ChannelInboundMessage, ChannelMessage, ChannelMessageUpdate, ChannelNativePayload, JsonValue, PostedChannelMessage, RuntimeChannel, } from "./types.js";
 export { normalizeChannelDestination } from "./types.js";
 export { CHANNEL_ERROR_CODES, ChannelError } from "./errors.js";
-export { createRuntimeChannel, wasFinalPosted } from "./runtime.js";
+export type { ChannelManifest, JsonObject } from "./manifest.js";
+export { CHANNEL_BRAND, defineChannel, isChannelDefinition, manifestsFromChannelDefinitions, } from "./plugin.js";
+export type { ChannelDefinition, ChannelManifestBody, DefineChannelOptions, } from "./plugin.js";
+export { getChannelAdapter, registerChannelAdapter, trustedChannelSourceProviders, } from "./registry.js";
+export type { ChannelHttpContext, ChannelProviderAdapter } from "./registry.js";
+export { collectChannels } from "./collect.js";
+export type { ChannelModuleEntry } from "./collect.js";
+export { createRuntimeChannel } from "./runtime.js";
 export type { ChannelTransport, CreateRuntimeChannelOptions, } from "./runtime.js";
 export { CHANNEL_BINDING_KEY, SLACK_BOT_TOKEN_ENV, clearFinalPosted, markFinalPosted, resolveRuntimeChannel, wasDeliveryFinalPosted, } from "./binding.js";
 export type { ChannelBinding } from "./binding.js";
 export { InMemoryChannelStore } from "./store.js";
 export type { DeliveryRecord, DeliveryStatus } from "./store.js";
 export { extractAssistantText } from "./assistant-text.js";
-export { addressFromDeliverTo, createScheduleDeliveryMiddleware, deliverScheduleResult, isTrustedScheduleDeliveryRun, readScheduleDeliverTo, setScheduleMetadataForTests, } from "./schedule-delivery.js";
+export { addressFromDeliverTo, createScheduleDeliveryMiddleware, deliverScheduleResult, isTrustedScheduleDeliveryRun, readScheduleDeliverTo, } from "./schedule-delivery.js";
 export type { DeliverScheduleResultInput, NormalizedScheduleDeliverTo, } from "./schedule-delivery.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EACV,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,EACT,oBAAoB,EACpB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EACL,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACV,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC"}

package/dist/channels/index.js

@@ -6,9 +6,12 @@
  */
 export { normalizeChannelDestination } from "./types.js";
 export { CHANNEL_ERROR_CODES, ChannelError } from "./errors.js";
-export { createRuntimeChannel, wasFinalPosted } from "./runtime.js";
+export { CHANNEL_BRAND, defineChannel, isChannelDefinition, manifestsFromChannelDefinitions, } from "./plugin.js";
+export { getChannelAdapter, registerChannelAdapter, trustedChannelSourceProviders, } from "./registry.js";
+export { collectChannels } from "./collect.js";
+export { createRuntimeChannel } from "./runtime.js";
 export { CHANNEL_BINDING_KEY, SLACK_BOT_TOKEN_ENV, clearFinalPosted, markFinalPosted, resolveRuntimeChannel, wasDeliveryFinalPosted, } from "./binding.js";
 export { InMemoryChannelStore } from "./store.js";
 export { extractAssistantText } from "./assistant-text.js";
-export { addressFromDeliverTo, createScheduleDeliveryMiddleware, deliverScheduleResult, isTrustedScheduleDeliveryRun, readScheduleDeliverTo, setScheduleMetadataForTests, } from "./schedule-delivery.js";
+export { addressFromDeliverTo, createScheduleDeliveryMiddleware, deliverScheduleResult, isTrustedScheduleDeliveryRun, readScheduleDeliverTo, } from "./schedule-delivery.js";
 //# sourceMappingURL=index.js.map

package/dist/channels/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMpE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhE,OAAO,EACL,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAMpD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/channels/manifest.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Provider-neutral channel manifest — compile/deploy/runtime contract.
+ *
+ * Provider-specific fields live in {@link ChannelManifest.providerConfig}.
+ * Adapters validate and interpret that blob; core only dispatches by `provider`.
+ */
+import type { JsonValue } from "./types.js";
+/** JSON object opaque to core; validated by the provider define helper. */
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+/**
+ * Compile/deploy envelope for a `channels/` declaration.
+ *
+ * Emitted by the CLI and embedded into the managed HTTP module.
+ */
+export interface ChannelManifest {
+    /** File-derived channel route name (`channels/{name}` → `/channels/{name}/events`). */
+    name: string;
+    /** Adapter key used by the runtime registry. */
+    provider: string;
+    /** Whether the managed runner should auto-reply after invoke. */
+    autoReply: boolean;
+    /**
+     * Provider-declared permissions (Slack OAuth scopes, GitHub App permissions, …).
+     * Informational for docs/deploy UX; not enforced by MDA core.
+     */
+    requiredPermissions: readonly string[];
+    /** Env vars deploy must ensure when this channel is present. */
+    requiredEnv: readonly string[];
+    /** Opaque-to-core provider config (Slack triggers/filters, GitHub filters, …). */
+    providerConfig: JsonObject;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/channels/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/channels/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,2EAA2E;AAC3E,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,gEAAgE;IAChE,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,kFAAkF;IAClF,cAAc,EAAE,UAAU,CAAC;CAC5B"}

package/dist/channels/manifest.js

@@ -0,0 +1,8 @@
+/**
+ * Provider-neutral channel manifest — compile/deploy/runtime contract.
+ *
+ * Provider-specific fields live in {@link ChannelManifest.providerConfig}.
+ * Adapters validate and interpret that blob; core only dispatches by `provider`.
+ */
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/channels/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/channels/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/channels/plugin.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Channel plugin contract — the return value of any `define*` helper.
+ *
+ * Third-party packages export helpers like `defineStripeChannel` that return a
+ * branded {@link ChannelDefinition}. Helper names are irrelevant; the brand,
+ * adapter, and `toManifest` are what the CLI and runtime use.
+ */
+import type { ChannelManifest } from "./manifest.js";
+import type { ChannelProviderAdapter } from "./registry-types.js";
+/**
+ * Realm-global brand marking a value as a managed channel definition.
+ * `Symbol.for` keeps identity stable across duplicate package copies.
+ */
+export declare const CHANNEL_BRAND: unique symbol;
+/**
+ * Author-supplied manifest fields. {@link defineChannel} stamps `name` (route)
+ * and `provider` from the definition so helpers do not repeat them.
+ */
+export type ChannelManifestBody = Omit<ChannelManifest, "name" | "provider">;
+/**
+ * Plugin object returned by `defineSlackChannel`, `defineGitHubChannel`, or any
+ * third-party `define*Channel` helper.
+ */
+export interface ChannelDefinition<TConfig = unknown> {
+    readonly [CHANNEL_BRAND]: true;
+    readonly kind: "channel";
+    /** Adapter registry key and trusted source-provider stamp. */
+    readonly provider: string;
+    /** Provider Events/reply implementation (usually from the same package). */
+    readonly adapter: ChannelProviderAdapter;
+    /**
+     * Deploy/runtime metadata. Must be pure JSON (no functions).
+     * Live callbacks stay on {@link ChannelDefinition.config}.
+     * `name` and `provider` are stamped by {@link defineChannel}.
+     */
+    toManifest(name: string): ChannelManifest;
+    /** Provider-specific live config consumed by the adapter. */
+    readonly config: TConfig;
+}
+/** Inputs for {@link defineChannel}. */
+export interface DefineChannelOptions<TConfig> {
+    provider: string;
+    adapter: ChannelProviderAdapter;
+    config: TConfig;
+    /** Return deploy fields only — `name` / `provider` are stamped automatically. */
+    toManifest: (name: string) => ChannelManifestBody;
+}
+/**
+ * Build a branded channel definition. First-party and third-party helpers should
+ * wrap this (or return an equivalent branded object).
+ */
+export declare function defineChannel<TConfig>(options: DefineChannelOptions<TConfig>): ChannelDefinition<TConfig>;
+/** Type guard for branded channel definitions. */
+export declare function isChannelDefinition(value: unknown): value is ChannelDefinition;
+/**
+ * Build the deploy/runtime manifest map from live channel definitions.
+ *
+ * Also registers each definition's adapter so Events routes can dispatch.
+ */
+export declare function manifestsFromChannelDefinitions(definitions: Record<string, unknown>): Record<string, ChannelManifest>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/channels/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/channels/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,MAAkC,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAE7E;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,OAAO;IAClD,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wCAAwC;AACxC,MAAM,WAAW,oBAAoB,CAAC,OAAO;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,sBAAsB,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,iFAAiF;IACjF,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,mBAAmB,CAAC;CACnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EACnC,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,GACrC,iBAAiB,CAAC,OAAO,CAAC,CA4C5B;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,iBAAiB,CAI5B;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAcjC"}

package/dist/channels/plugin.js

@@ -0,0 +1,80 @@
+/**
+ * Channel plugin contract — the return value of any `define*` helper.
+ *
+ * Third-party packages export helpers like `defineStripeChannel` that return a
+ * branded {@link ChannelDefinition}. Helper names are irrelevant; the brand,
+ * adapter, and `toManifest` are what the CLI and runtime use.
+ */
+import { registerChannelAdapter } from "./registry-store.js";
+/**
+ * Realm-global brand marking a value as a managed channel definition.
+ * `Symbol.for` keeps identity stable across duplicate package copies.
+ */
+export const CHANNEL_BRAND = Symbol.for("mda.channel");
+/**
+ * Build a branded channel definition. First-party and third-party helpers should
+ * wrap this (or return an equivalent branded object).
+ */
+export function defineChannel(options) {
+    if (!options || typeof options !== "object") {
+        throw new Error("defineChannel(...) requires an options object.");
+    }
+    if (typeof options.provider !== "string" || !options.provider.trim()) {
+        throw new Error("defineChannel(...) requires a non-empty `provider` string.");
+    }
+    if (options.adapter === null ||
+        typeof options.adapter !== "object" ||
+        typeof options.adapter.handleEventsRequest !== "function") {
+        throw new Error("defineChannel(...) requires an `adapter` with handleEventsRequest.");
+    }
+    if (typeof options.toManifest !== "function") {
+        throw new Error("defineChannel(...) requires a `toManifest` function.");
+    }
+    const provider = options.provider.trim();
+    if (options.adapter.provider !== provider) {
+        throw new Error(`defineChannel(...) adapter.provider ("${options.adapter.provider}") ` +
+            `must match provider ("${provider}").`);
+    }
+    const authorToManifest = options.toManifest;
+    return {
+        [CHANNEL_BRAND]: true,
+        kind: "channel",
+        provider,
+        adapter: options.adapter,
+        config: options.config,
+        toManifest(name) {
+            const body = authorToManifest(name);
+            return {
+                ...body,
+                name,
+                provider,
+            };
+        },
+    };
+}
+/** Type guard for branded channel definitions. */
+export function isChannelDefinition(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const record = value;
+    return record[CHANNEL_BRAND] === true && record.kind === "channel";
+}
+/**
+ * Build the deploy/runtime manifest map from live channel definitions.
+ *
+ * Also registers each definition's adapter so Events routes can dispatch.
+ */
+export function manifestsFromChannelDefinitions(definitions) {
+    const out = {};
+    for (const [name, value] of Object.entries(definitions)) {
+        if (!isChannelDefinition(value)) {
+            throw new Error(`channel "${name}" is not a branded ChannelDefinition. ` +
+                "Export `channel = defineXChannel(...)` (or defineChannel) so the " +
+                "return value includes CHANNEL_BRAND, adapter, and toManifest.");
+        }
+        registerChannelAdapter(value.adapter);
+        out[name] = value.toManifest(name);
+    }
+    return out;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/channels/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/channels/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7D;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAsCtE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAsC;IAEtC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,IACE,OAAO,CAAC,OAAO,KAAK,IAAI;QACxB,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QACnC,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,KAAK,UAAU,EACzD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,yCAAyC,OAAO,CAAC,OAAO,CAAC,QAAQ,KAAK;YACpE,yBAAyB,QAAQ,KAAK,CACzC,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAC5C,OAAO;QACL,CAAC,aAAa,CAAC,EAAE,IAAI;QACrB,IAAI,EAAE,SAAS;QACf,QAAQ;QACR,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,CAAC,IAAY;YACrB,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO;gBACL,GAAG,IAAI;gBACP,IAAI;gBACJ,QAAQ;aACT,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,mBAAmB,CACjC,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAyC,CAAC;IACzD,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,WAAoC;IAEpC,MAAM,GAAG,GAAoC,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,YAAY,IAAI,wCAAwC;gBACtD,mEAAmE;gBACnE,+DAA+D,CAClE,CAAC;QACJ,CAAC;QACD,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/channels/registry-store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Adapter registry storage — kept separate from builtin registration so auth
+ * and collect can import without pulling Slack/GitHub adapter modules.
+ */
+import type { ChannelProviderAdapter } from "./registry-types.js";
+/** Register (or replace) a channel provider adapter. */
+export declare function registerChannelAdapter(adapter: ChannelProviderAdapter): void;
+/** Look up a registered adapter, or `undefined` if none. */
+export declare function getChannelAdapter(provider: string): ChannelProviderAdapter | undefined;
+/** Providers that may stamp trusted `x-mda-source-provider` on loopback invoke. */
+export declare function trustedChannelSourceProviders(): ReadonlySet<string>;
+//# sourceMappingURL=registry-store.d.ts.map

package/dist/channels/registry-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-store.d.ts","sourceRoot":"","sources":["../../src/channels/registry-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAIlE,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAE5E;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GACf,sBAAsB,GAAG,SAAS,CAEpC;AAED,mFAAmF;AACnF,wBAAgB,6BAA6B,IAAI,WAAW,CAAC,MAAM,CAAC,CAEnE"}

package/dist/channels/registry-store.js

@@ -0,0 +1,18 @@
+/**
+ * Adapter registry storage — kept separate from builtin registration so auth
+ * and collect can import without pulling Slack/GitHub adapter modules.
+ */
+const adapters = new Map();
+/** Register (or replace) a channel provider adapter. */
+export function registerChannelAdapter(adapter) {
+    adapters.set(adapter.provider, adapter);
+}
+/** Look up a registered adapter, or `undefined` if none. */
+export function getChannelAdapter(provider) {
+    return adapters.get(provider);
+}
+/** Providers that may stamp trusted `x-mda-source-provider` on loopback invoke. */
+export function trustedChannelSourceProviders() {
+    return new Set(adapters.keys());
+}
+//# sourceMappingURL=registry-store.js.map

package/dist/channels/registry-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-store.js","sourceRoot":"","sources":["../../src/channels/registry-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkC,CAAC;AAE3D,wDAAwD;AACxD,MAAM,UAAU,sBAAsB,CAAC,OAA+B;IACpE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,iBAAiB,CAC/B,QAAgB;IAEhB,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,6BAA6B;IAC3C,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC"}

package/dist/channels/registry-types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Adapter types — no side-effect imports.
+ */
+import type { ChannelManifest } from "./manifest.js";
+import type { ChannelTransport } from "./runtime.js";
+/** Context passed to an adapter's Events HTTP handler. */
+export interface ChannelHttpContext {
+    /** File-derived channel name (route segment). */
+    name: string;
+    /** Compiled channel manifest. */
+    manifest: ChannelManifest;
+    /**
+     * Live channel declaration imported from `channels/{name}` (includes
+     * GitHub `prompt` callbacks). Absent when only the JSON manifest is available.
+     */
+    definition?: unknown;
+    /**
+     * Pre-read raw body when the HTTP framework may have consumed `request`
+     * (Hono mount passes `await c.req.text()`).
+     */
+    rawBody?: string | Uint8Array;
+}
+/** Runtime plugin surface for a channel provider. */
+export interface ChannelProviderAdapter {
+    /** Provider key; must match {@link ChannelManifest.provider}. */
+    readonly provider: string;
+    /** Handle `POST /channels/{name}/events` (verify + normalize + ACK + work). */
+    handleEventsRequest(request: Request, ctx: ChannelHttpContext): Promise<Response>;
+    /** Build outbound transport for `resolveRuntimeChannel`. */
+    createTransport(env: NodeJS.ProcessEnv): ChannelTransport | undefined;
+}
+//# sourceMappingURL=registry-types.d.ts.map

package/dist/channels/registry-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-types.d.ts","sourceRoot":"","sources":["../../src/channels/registry-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CAC/B;AAED,qDAAqD;AACrD,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,mBAAmB,CACjB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrB,4DAA4D;IAC5D,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,gBAAgB,GAAG,SAAS,CAAC;CACvE"}

package/dist/channels/registry-types.js

@@ -0,0 +1,5 @@
+/**
+ * Adapter types — no side-effect imports.
+ */
+export {};
+//# sourceMappingURL=registry-types.js.map

package/dist/channels/registry-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-types.js","sourceRoot":"","sources":["../../src/channels/registry-types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/channels/registry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Channel provider adapter registry.
+ *
+ * Core mounts `/channels/{name}/events` and builds transports by looking up the
+ * adapter for `manifest.provider`. First-party adapters register lazily on first
+ * lookup so `define*` modules can import adapter-core without a load cycle.
+ */
+import { registerChannelAdapter, trustedChannelSourceProviders } from "./registry-store.js";
+import type { ChannelHttpContext, ChannelProviderAdapter } from "./registry-types.js";
+export type { ChannelHttpContext, ChannelProviderAdapter };
+export { registerChannelAdapter, trustedChannelSourceProviders };
+/** Look up a registered adapter, or `undefined` if none. */
+export declare function getChannelAdapter(provider: string): ChannelProviderAdapter | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/channels/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/channels/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAEL,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,CAAC;AAWjE,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GACf,sBAAsB,GAAG,SAAS,CAGpC"}

package/dist/channels/registry.js

@@ -0,0 +1,25 @@
+/**
+ * Channel provider adapter registry.
+ *
+ * Core mounts `/channels/{name}/events` and builds transports by looking up the
+ * adapter for `manifest.provider`. First-party adapters register lazily on first
+ * lookup so `define*` modules can import adapter-core without a load cycle.
+ */
+import { githubChannelAdapter } from "./github/adapter-core.js";
+import { getChannelAdapter as getStoredAdapter, registerChannelAdapter, trustedChannelSourceProviders, } from "./registry-store.js";
+import { slackChannelAdapter } from "./slack/adapter-core.js";
+export { registerChannelAdapter, trustedChannelSourceProviders };
+let builtinsRegistered = false;
+function ensureBuiltinAdapters() {
+    if (builtinsRegistered)
+        return;
+    builtinsRegistered = true;
+    registerChannelAdapter(slackChannelAdapter);
+    registerChannelAdapter(githubChannelAdapter);
+}
+/** Look up a registered adapter, or `undefined` if none. */
+export function getChannelAdapter(provider) {
+    ensureBuiltinAdapters();
+    return getStoredAdapter(provider);
+}
+//# sourceMappingURL=registry.js.map

package/dist/channels/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/channels/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,iBAAiB,IAAI,gBAAgB,EACrC,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,CAAC;AAEjE,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAE/B,SAAS,qBAAqB;IAC5B,IAAI,kBAAkB;QAAE,OAAO;IAC/B,kBAAkB,GAAG,IAAI,CAAC;IAC1B,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAC5C,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;AAC/C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,iBAAiB,CAC/B,QAAgB;IAEhB,qBAAqB,EAAE,CAAC;IACxB,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/dist/channels/runtime.d.ts

@@ -1,7 +1,7 @@
 /**
  * Construct the optional `runtime.channel` surface for channel-originated runs.
  */
-import type { ChannelAddress, ChannelCapabilities, ChannelEvent, ChannelMessage, ChannelMessageUpdate, ChannelProvider, PostedChannelMessage, RuntimeChannel } from "./types.js";
+import type { ChannelAddress, ChannelCapabilities, ChannelEvent, ChannelMessage, ChannelMessageUpdate, PostedChannelMessage, RuntimeChannel } from "./types.js";
 export interface ChannelTransport {
     post(input: {
         text: string;
@@ -17,7 +17,7 @@ export interface ChannelTransport {
 }
 export interface CreateRuntimeChannelOptions {
     name: string;
-    provider: ChannelProvider;
+    provider: string;
     event: ChannelEvent;
     address: ChannelAddress;
     capabilities?: Partial<ChannelCapabilities>;
@@ -35,6 +35,4 @@ export interface CreateRuntimeChannelOptions {
  * Phase 1 only permits `current_thread` destinations.
  */
 export declare function createRuntimeChannel(options: CreateRuntimeChannelOptions): RuntimeChannel;
-/** True when an explicit `post(..., { final: true })` already delivered the reply. */
-export declare function wasFinalPosted(channel: RuntimeChannel): boolean;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/channels/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/channels/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,KAAK,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;KACnC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClC,MAAM,CAAC,CAAC,KAAK,EAAE;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;KACzC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5C,SAAS,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,cAAc,CA4DhB;AAiBD,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAI/D"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/channels/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,KAAK,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;KACnC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClC,MAAM,CAAC,CAAC,KAAK,EAAE;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;KACzC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5C,SAAS,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,cAAc,CA4DhB"}