managed-deepagents 0.4.0-dev.72 → 0.4.0-dev.73

package/dist/channels/binding.d.ts

@@ -5,16 +5,15 @@
  * The runtime seam rebuilds `runtime.channel` only when the trusted auth user
  * source provider matches — clients cannot invent a channel surface.
  */
-import { wasFinalPosted } from "./runtime.js";
 import type { ChannelTransport } from "./runtime.js";
-import type { ChannelAddress, ChannelEvent, ChannelProvider, RuntimeChannel } from "./types.js";
+import type { ChannelAddress, ChannelEvent, RuntimeChannel } from "./types.js";
 /** Env var holding the Slack bot token for Phase 1 single-workspace installs. */
 export declare const SLACK_BOT_TOKEN_ENV = "SLACK_BOT_TOKEN";
 /** Configurable key stamped by the managed channel runner (never client-trusted alone). */
 export declare const CHANNEL_BINDING_KEY = "mda_channel_binding";
 export interface ChannelBinding {
     name: string;
-    provider: ChannelProvider;
+    provider: string;
     event: ChannelEvent;
     address: ChannelAddress;
     autoReply: boolean;
@@ -29,6 +28,5 @@ export declare function wasDeliveryFinalPosted(deliveryId: string): boolean;
  * Returns `undefined` unless the auth user source provider matches the binding
  * and a transport can be constructed.
  */
-export declare function resolveRuntimeChannel(configurable: Record<string, unknown> | undefined, transportFactory?: (provider: ChannelProvider) => ChannelTransport | undefined): RuntimeChannel | undefined;
-export { wasFinalPosted };
+export declare function resolveRuntimeChannel(configurable: Record<string, unknown> | undefined, transportFactory?: (provider: string) => ChannelTransport | undefined): RuntimeChannel | undefined;
 //# sourceMappingURL=binding.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/channels/binding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAwB,cAAc,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,2FAA2F;AAC3F,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAKzD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACjD,gBAAgB,GAAE,CAChB,QAAQ,EAAE,eAAe,KACtB,gBAAgB,GAAG,SAA4B,GACnD,cAAc,GAAG,SAAS,CA+B5B;AAWD,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/channels/binding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/E,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,2FAA2F;AAC3F,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAKzD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACjD,gBAAgB,GAAE,CAChB,QAAQ,EAAE,MAAM,KACb,gBAAgB,GAAG,SAA4B,GACnD,cAAc,GAAG,SAAS,CA+B5B"}

package/dist/channels/binding.js

@@ -5,8 +5,8 @@
  * The runtime seam rebuilds `runtime.channel` only when the trusted auth user
  * source provider matches — clients cannot invent a channel surface.
  */
-import { createRuntimeChannel, wasFinalPosted } from "./runtime.js";
-import { createSlackWebApiTransport } from "./slack/transport.js";
+import { createRuntimeChannel } from "./runtime.js";
+import { getChannelAdapter } from "./registry.js";
 /** Env var holding the Slack bot token for Phase 1 single-workspace installs. */
 export const SLACK_BOT_TOKEN_ENV = "SLACK_BOT_TOKEN";
 /** Configurable key stamped by the managed channel runner (never client-trusted alone). */
@@ -56,12 +56,6 @@ export function resolveRuntimeChannel(configurable, transportFactory = defaultTr
     });
 }
 function defaultTransport(provider) {
-    if (provider !== "slack")
-        return undefined;
-    const token = process.env[SLACK_BOT_TOKEN_ENV];
-    if (!token)
-        return undefined;
-    return createSlackWebApiTransport({ botToken: token });
+    return getChannelAdapter(provider)?.createTransport(process.env);
 }
-export { wasFinalPosted };
 //# sourceMappingURL=binding.js.map

package/dist/channels/binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/channels/binding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAElE,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,sFAAsF;AACtF,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAmB,CAAC;AAWzD,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,qBAAqB,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,qBAAqB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAiD,EACjD,gBAAgB,GAEoB,gBAAgB;IAEpD,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,IAAI,GAAG,YAAY,CAAC,mBAEb,CAAC;IACd,MAAM,cAAc,GAAG,IAAI,EAAE,mBAAmB,CAAC;IACjD,MAAM,OAAO,GAAG,YAAY,CAAC,mBAAmB,CAEnC,CAAC;IACd,IACE,CAAC,OAAO;QACR,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAChC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QACpC,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;QACtC,cAAc,KAAK,OAAO,CAAC,QAAQ,EACnC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,OAAO,oBAAoB,CAAC;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS;QACT,aAAa,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC;KACjD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CACvB,QAAyB;IAEzB,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,0BAA0B,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/channels/binding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,sFAAsF;AACtF,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAmB,CAAC;AAWzD,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,qBAAqB,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,qBAAqB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAiD,EACjD,gBAAgB,GAEoB,gBAAgB;IAEpD,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,IAAI,GAAG,YAAY,CAAC,mBAEb,CAAC;IACd,MAAM,cAAc,GAAG,IAAI,EAAE,mBAAmB,CAAC;IACjD,MAAM,OAAO,GAAG,YAAY,CAAC,mBAAmB,CAEnC,CAAC;IACd,IACE,CAAC,OAAO;QACR,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAChC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QACpC,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;QACtC,cAAc,KAAK,OAAO,CAAC,QAAQ,EACnC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,OAAO,oBAAoB,CAAC;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS;QACT,aAAa,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC;KACjD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,OAAO,iBAAiB,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACnE,CAAC"}

package/dist/channels/collect.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Collect validated channel declarations from discovered `channels/` modules.
+ *
+ * Mirrors {@link collectConnectors}: each module must export a named branded
+ * {@link ChannelDefinition}. Adapters are registered during collect.
+ */
+import { type ChannelDefinition } from "./plugin.js";
+export interface ChannelModuleEntry {
+    /** Project-relative source path for error messages (`channels/github.ts`). */
+    source: string;
+    /** Imported module namespace / exports object. */
+    module: {
+        channel?: unknown;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Map file-stem channel names to their live declarations.
+ *
+ * @param entries - Discovered channel modules with project-relative sources.
+ */
+export declare function collectChannels(entries: readonly ChannelModuleEntry[]): Record<string, ChannelDefinition>;
+//# sourceMappingURL=collect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/channels/collect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG1E,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACvD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CA4BnC"}

package/dist/channels/collect.js

@@ -0,0 +1,46 @@
+/**
+ * Collect validated channel declarations from discovered `channels/` modules.
+ *
+ * Mirrors {@link collectConnectors}: each module must export a named branded
+ * {@link ChannelDefinition}. Adapters are registered during collect.
+ */
+import { isChannelDefinition } from "./plugin.js";
+import { registerChannelAdapter } from "./registry-store.js";
+/**
+ * Map file-stem channel names to their live declarations.
+ *
+ * @param entries - Discovered channel modules with project-relative sources.
+ */
+export function collectChannels(entries) {
+    const out = {};
+    for (const entry of entries) {
+        const channel = entry.module.channel;
+        if (channel === undefined || channel === null) {
+            throw new Error(`${entry.source} defines no \`channel\` export. A file under channels/ ` +
+                "must export exactly one branded channel as `channel` " +
+                "(e.g. `export const channel = defineGitHubChannel(...)` or a " +
+                "third-party `defineXChannel` that returns defineChannel(...)).");
+        }
+        if (!isChannelDefinition(channel)) {
+            throw new Error(`${entry.source} export \`channel\` is not a branded ChannelDefinition. ` +
+                "The define* helper must return an object with CHANNEL_BRAND, " +
+                "provider, adapter, toManifest, and config " +
+                "(use defineChannel(...) from managed-deepagents/channels).");
+        }
+        const name = channelStemName(entry.source);
+        if (out[name] !== undefined) {
+            throw new Error(`duplicate channel name '${name}' from channels/`);
+        }
+        registerChannelAdapter(channel.adapter);
+        out[name] = channel;
+    }
+    return out;
+}
+function channelStemName(source) {
+    const base = source.replace(/^.*\//, "").replace(/\.(ts|js|py)$/, "");
+    if (!base || base === "channel") {
+        throw new Error(`invalid channel path "${source}": use channels/<name>.ts (not channel.ts)`);
+    }
+    return base;
+}
+//# sourceMappingURL=collect.js.map

package/dist/channels/collect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../../src/channels/collect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAA0B,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAS7D;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAsC;IAEtC,MAAM,GAAG,GAAsC,EAAE,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;QACrC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,CAAC,MAAM,yDAAyD;gBACtE,uDAAuD;gBACvD,+DAA+D;gBAC/D,gEAAgE,CACnE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,CAAC,MAAM,0DAA0D;gBACvE,+DAA+D;gBAC/D,4CAA4C;gBAC5C,4DAA4D,CAC/D,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,kBAAkB,CAAC,CAAC;QACrE,CAAC;QACD,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,yBAAyB,MAAM,4CAA4C,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/channels/github/adapter-core.d.ts

@@ -0,0 +1,6 @@
+/**
+ * GitHub adapter object without imports from `define.ts` (avoids load cycles).
+ */
+import type { ChannelProviderAdapter } from "../registry-types.js";
+export declare const githubChannelAdapter: ChannelProviderAdapter;
+//# sourceMappingURL=adapter-core.d.ts.map

package/dist/channels/github/adapter-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-core.d.ts","sourceRoot":"","sources":["../../../src/channels/github/adapter-core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AASnE,eAAO,MAAM,oBAAoB,EAAE,sBAyBlC,CAAC"}

package/dist/channels/github/adapter-core.js

@@ -0,0 +1,27 @@
+/**
+ * GitHub adapter object without imports from `define.ts` (avoids load cycles).
+ */
+import { handleGitHubEventsRequest } from "./http.js";
+import { createGitHubAppTransport, GITHUB_APP_ID_ENV, GITHUB_APP_PRIVATE_KEY_ENV, GITHUB_INSTALLATION_ID_ENV, } from "./transport.js";
+export const githubChannelAdapter = {
+    provider: "github",
+    async handleEventsRequest(request, ctx) {
+        const definition = ctx.definition;
+        const { githubConfigFromManifest } = await import("./adapter.js");
+        return handleGitHubEventsRequest(request, {
+            name: ctx.name,
+            config: definition?.config ?? githubConfigFromManifest(ctx.manifest),
+            definition: ctx.definition,
+            rawBody: ctx.rawBody,
+        });
+    },
+    createTransport(env) {
+        const appId = env[GITHUB_APP_ID_ENV] ?? "";
+        const privateKey = env[GITHUB_APP_PRIVATE_KEY_ENV] ?? "";
+        const installationId = env[GITHUB_INSTALLATION_ID_ENV] ?? "";
+        if (!appId || !privateKey || !installationId)
+            return undefined;
+        return createGitHubAppTransport({ appId, privateKey, installationId });
+    },
+};
+//# sourceMappingURL=adapter-core.js.map

package/dist/channels/github/adapter-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-core.js","sourceRoot":"","sources":["../../../src/channels/github/adapter-core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,QAAQ,EAAE,QAAQ;IAElB,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG;QACpC,MAAM,UAAU,GAAG,GAAG,CAAC,UAEV,CAAC;QACd,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAClE,OAAO,yBAAyB,CAAC,OAAO,EAAE;YACxC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,UAAU,EAAE,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC;YACpE,UAAU,EAAE,GAAG,CAAC,UAEE;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,GAAG;QACjB,MAAM,KAAK,GAAG,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,GAAG,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC;QACzD,MAAM,cAAc,GAAG,GAAG,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC;QAC7D,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc;YAAE,OAAO,SAAS,CAAC;QAC/D,OAAO,wBAAwB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;IACzE,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * GitHub channel provider adapter — registry entry for webhooks + transport.
+ */
+import type { ChannelManifest } from "../manifest.js";
+import type { RequiredGitHubChannelConfig } from "./define.js";
+import { GITHUB_CHANNEL_REQUIRED_ENV } from "./define.js";
+export { GITHUB_CHANNEL_REQUIRED_ENV };
+export { githubChannelAdapter } from "./adapter-core.js";
+/**
+ * Rebuild a config shell from the JSON manifest when the live module is absent.
+ *
+ * Manifest handlers have no `prompt` — callers that only have the manifest
+ * cannot produce agent task text. Prefer passing the live definition.
+ */
+export declare function githubConfigFromManifest(manifest: ChannelManifest): RequiredGitHubChannelConfig;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/channels/github/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAEV,2BAA2B,EAE5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,2BAA2B,EAAE,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,eAAe,GACxB,2BAA2B,CA6C7B"}

package/dist/channels/github/adapter.js

@@ -0,0 +1,52 @@
+/**
+ * GitHub channel provider adapter — registry entry for webhooks + transport.
+ */
+import { GITHUB_CHANNEL_REQUIRED_ENV } from "./define.js";
+export { GITHUB_CHANNEL_REQUIRED_ENV };
+export { githubChannelAdapter } from "./adapter-core.js";
+/**
+ * Rebuild a config shell from the JSON manifest when the live module is absent.
+ *
+ * Manifest handlers have no `prompt` — callers that only have the manifest
+ * cannot produce agent task text. Prefer passing the live definition.
+ */
+export function githubConfigFromManifest(manifest) {
+    const cfg = manifest.providerConfig;
+    const rawHandlers = cfg.handlers;
+    if (Array.isArray(rawHandlers) && rawHandlers.length > 0) {
+        const handlers = rawHandlers.map((entry, index) => {
+            const h = entry;
+            const on = h.on;
+            const autoReply = typeof h.autoReply === "boolean"
+                ? h.autoReply
+                : typeof h.auto_reply === "boolean"
+                    ? h.auto_reply
+                    : true;
+            const repositories = Array.isArray(h.repositories)
+                ? h.repositories
+                : undefined;
+            return {
+                on,
+                repositories,
+                autoReply,
+                prompt: () => {
+                    throw new Error(`GitHub channel "${manifest.name}" handlers[${index}] has no live ` +
+                        "`prompt` callback; ensure the channel module is loaded via _mda_channels.");
+                },
+            };
+        });
+        return { handlers };
+    }
+    // Legacy manifests with flat triggers only — stub so mount does not crash.
+    const triggers = cfg.triggers ?? [];
+    return {
+        handlers: triggers.map((on) => ({
+            on,
+            autoReply: manifest.autoReply,
+            prompt: () => {
+                throw new Error(`GitHub channel "${manifest.name}" requires a live handlers[].prompt callback`);
+            },
+        })),
+    };
+}
+//# sourceMappingURL=adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/channels/github/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,2BAA2B,EAAE,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAyB;IAEzB,MAAM,GAAG,GAAG,QAAQ,CAAC,cAA4B,CAAC;IAClD,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAmC,WAAW,CAAC,GAAG,CAC9D,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACf,MAAM,CAAC,GAAG,KAAgC,CAAC;YAC3C,MAAM,EAAE,GAAG,CAAC,CAAC,EAA0B,CAAC;YACxC,MAAM,SAAS,GACb,OAAO,CAAC,CAAC,SAAS,KAAK,SAAS;gBAC9B,CAAC,CAAC,CAAC,CAAC,SAAS;gBACb,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,KAAK,SAAS;oBACjC,CAAC,CAAC,CAAC,CAAC,UAAU;oBACd,CAAC,CAAC,IAAI,CAAC;YACb,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;gBAChD,CAAC,CAAE,CAAC,CAAC,YAAyB;gBAC9B,CAAC,CAAC,SAAS,CAAC;YACd,OAAO;gBACL,EAAE;gBACF,YAAY;gBACZ,SAAS;gBACT,MAAM,EAAE,GAAG,EAAE;oBACX,MAAM,IAAI,KAAK,CACb,mBAAmB,QAAQ,CAAC,IAAI,cAAc,KAAK,gBAAgB;wBACjE,2EAA2E,CAC9E,CAAC;gBACJ,CAAC;aACF,CAAC;QACJ,CAAC,CACF,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;IACD,2EAA2E;IAC3E,MAAM,QAAQ,GAAI,GAAG,CAAC,QAA4C,IAAI,EAAE,CAAC;IACzE,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9B,EAAE;YACF,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,MAAM,EAAE,GAAG,EAAE;gBACX,MAAM,IAAI,KAAK,CACb,mBAAmB,QAAQ,CAAC,IAAI,8CAA8C,CAC/E,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,198 @@
+/**
+ * `defineGitHubChannel` — declarative GitHub App webhook channel authoring.
+ *
+ * Authors declare **handlers** (event filter + optional repo scope + `prompt`).
+ * `instructions.md` remains the agent system prompt; each handler's `prompt`
+ * builds the human message for that webhook turn.
+ *
+ * MDA does **not** ship copies of GitHub webhook payload types. Prefer
+ * [`@octokit/webhooks-types`](https://www.npmjs.com/package/@octokit/webhooks-types)
+ * in the agent project and narrow {@link GitHubWebhookPromptEvent.payload}:
+ *
+ * @example
+ * ```ts
+ * import type { PullRequestOpenedEvent } from "@octokit/webhooks-types";
+ *
+ * prompt(event) {
+ *   const pr = event.payload as PullRequestOpenedEvent;
+ *   return `Review ${pr.pull_request.title}`;
+ * }
+ * ```
+ */
+import { type ChannelDefinition, type ChannelManifestBody } from "../plugin.js";
+/**
+ * GitHub webhook filter for a handler's {@link GitHubChannelHandler.on}.
+ *
+ * - `"pull_request"` — any action for that `X-GitHub-Event`
+ * - `"pull_request.opened"` — event + `payload.action`
+ * - `"*"` — every webhook delivery
+ *
+ * Any non-empty string is accepted; MDA does not maintain an event allowlist.
+ */
+export type GitHubChannelTrigger = string;
+/**
+ * Envelope passed to {@link GitHubChannelHandler.prompt}.
+ *
+ * Common routing fields are lifted for filters / auto-reply. The raw webhook
+ * JSON stays on {@link GitHubWebhookPromptEvent.payload} as `unknown` so callers
+ * can narrow with Octokit (or other) types without MDA duplicating schemas.
+ */
+export interface GitHubWebhookPromptEvent {
+    /**
+     * `X-GitHub-Event` header value (e.g. `"pull_request"`, `"issues"`, `"push"`).
+     */
+    eventName: string;
+    /**
+     * `payload.action` when present (e.g. `"opened"`). Omitted for events without
+     * an action field.
+     */
+    action?: string;
+    /**
+     * Convenience id: `eventName` or `eventName.action` when `action` is set.
+     *
+     * @example `"pull_request.opened"`
+     */
+    trigger: string;
+    /** `X-GitHub-Delivery` header. */
+    deliveryId: string;
+    /** Repository full name (`owner/repo`) when the payload includes `repository`. */
+    repository?: string;
+    /** GitHub App installation id when present on the payload or env fallback. */
+    installationId?: string;
+    /**
+     * Issue or pull request number when the payload includes one (used for
+     * source-thread keys and auto-reply comments).
+     */
+    issueOrPullNumber?: number;
+    /**
+     * Verified webhook JSON body. Treat as `unknown` and narrow with
+     * `@octokit/webhooks-types` (or equivalent) in the agent project.
+     */
+    payload: unknown;
+}
+/**
+ * One subscription inside {@link defineGitHubChannel}.
+ *
+ * Handlers are matched in order: first handler whose `on` matches the webhook
+ * and whose `repositories` allowlist (if set) includes the repo wins.
+ */
+export interface GitHubChannelHandler {
+    /**
+     * Which deliveries this handler accepts.
+     *
+     * @see GitHubChannelTrigger
+     */
+    on: GitHubChannelTrigger;
+    /**
+     * Restrict this handler to these repositories (`owner/repo`).
+     * Omit or leave empty to accept any repository (including payloads with no
+     * `repository` field when the allowlist is omitted).
+     */
+    repositories?: readonly string[];
+    /**
+     * When `true` and the payload identifies an issue/PR (`owner/repo#N`), post
+     * the agent’s final reply as an issue comment on that conversation. When
+     * `false`, or when no issue/PR number can be resolved, the agent still runs
+     * but no comment is posted.
+     *
+     * @default true
+     */
+    autoReply?: boolean;
+    /**
+     * Build the human message for the agent turn from the webhook envelope.
+     *
+     * Narrow `event.payload` with `@octokit/webhooks-types` in your project —
+     * MDA does not vendor those schemas.
+     */
+    prompt: (event: GitHubWebhookPromptEvent) => string;
+}
+/**
+ * Serializable handler metadata embedded in the compile/deploy manifest.
+ * Live `prompt` callbacks are not included — they come from the imported module.
+ */
+export interface GitHubChannelHandlerManifest {
+    /** Event filter (`event`, `event.action`, or `"*"`). */
+    on: GitHubChannelTrigger;
+    /** Optional repo allowlist (`owner/repo`). */
+    repositories?: readonly string[];
+    /** Whether this handler attempts a PR/issue comment after the agent run. */
+    autoReply: boolean;
+}
+/**
+ * Authoring input for {@link defineGitHubChannel}.
+ *
+ * Routing and per-event task text only — agent persona/tools stay on
+ * `instructions.md` and the agent definition.
+ */
+export interface GitHubChannelConfig {
+    /**
+     * Ordered handler list. First match wins for each webhook delivery.
+     */
+    handlers: readonly GitHubChannelHandler[];
+}
+/**
+ * Normalized GitHub channel config after {@link defineGitHubChannel} validation.
+ *
+ * Retains live `prompt` callbacks for runtime. Used when the channel module is
+ * imported by the managed HTTP app.
+ */
+export interface RequiredGitHubChannelConfig {
+    /** Normalized handlers with defaults applied (`autoReply` → `true`). */
+    handlers: readonly RequiredGitHubChannelHandler[];
+}
+/**
+ * Normalized handler with defaults applied.
+ */
+export interface RequiredGitHubChannelHandler {
+    on: GitHubChannelTrigger;
+    repositories?: readonly string[];
+    autoReply: boolean;
+    prompt: (event: GitHubWebhookPromptEvent) => string;
+}
+/**
+ * Validated channel declaration returned by {@link defineGitHubChannel}.
+ *
+ * Files under `channels/*.ts` export a named `channel` of this shape for CLI
+ * discovery. The live object (including `prompt` callbacks) is imported at
+ * runtime via `_mda_channels`; the JSON manifest carries only serializable
+ * metadata for deploy secrets and mount.
+ */
+export type GitHubChannelDefinition = ChannelDefinition<RequiredGitHubChannelConfig>;
+/** Env vars for Phase 1 single-install GitHub App webhooks. */
+export declare const GITHUB_CHANNEL_REQUIRED_ENV: readonly ["GITHUB_WEBHOOK_SECRET", "GITHUB_APP_ID", "GITHUB_APP_PRIVATE_KEY", "GITHUB_INSTALLATION_ID"];
+/**
+ * Declare a managed GitHub channel. Files under `channels/*.ts` export a named
+ * `channel` created with this helper.
+ *
+ * @param config - Handlers that map webhook events to agent turns.
+ */
+export declare function defineGitHubChannel(config: GitHubChannelConfig): GitHubChannelDefinition;
+/**
+ * GitHub App permissions implied by handlers.
+ *
+ * Auto-reply comments need `issues:write`. Contents/metadata reads are declared
+ * broadly so arbitrary webhook handlers can inspect payloads; tighten App
+ * permissions in GitHub settings to match what you actually use.
+ */
+export declare function requiredGitHubPermissions(config: RequiredGitHubChannelConfig): string[];
+/**
+ * Build author-supplied deploy fields for a GitHub channel.
+ *
+ * `name` and `provider` are stamped by {@link defineChannel} / `toManifest(name)`.
+ */
+export declare function toGitHubChannelManifest(definition: GitHubChannelDefinition | RequiredGitHubChannelConfig): ChannelManifestBody;
+/**
+ * Whether a handler `on` filter matches a delivery.
+ *
+ * @param on - `"*"`, `"pull_request"`, or `"pull_request.opened"`
+ * @param eventName - `X-GitHub-Event`
+ * @param action - `payload.action` when present
+ */
+export declare function githubTriggerMatches(on: string, eventName: string, action?: string): boolean;
+/**
+ * Find the first handler that matches event/action + repository.
+ *
+ * @returns The handler, or `undefined` when no handler matches (event ignored).
+ */
+export declare function matchGitHubHandler(config: RequiredGitHubChannelConfig, eventName: string, repository: string | undefined, action?: string): RequiredGitHubChannelHandler | undefined;
+//# sourceMappingURL=define.d.ts.map

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

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

package/dist/channels/github/define.js

@@ -0,0 +1,166 @@
+/**
+ * `defineGitHubChannel` — declarative GitHub App webhook channel authoring.
+ *
+ * Authors declare **handlers** (event filter + optional repo scope + `prompt`).
+ * `instructions.md` remains the agent system prompt; each handler's `prompt`
+ * builds the human message for that webhook turn.
+ *
+ * MDA does **not** ship copies of GitHub webhook payload types. Prefer
+ * [`@octokit/webhooks-types`](https://www.npmjs.com/package/@octokit/webhooks-types)
+ * in the agent project and narrow {@link GitHubWebhookPromptEvent.payload}:
+ *
+ * @example
+ * ```ts
+ * import type { PullRequestOpenedEvent } from "@octokit/webhooks-types";
+ *
+ * prompt(event) {
+ *   const pr = event.payload as PullRequestOpenedEvent;
+ *   return `Review ${pr.pull_request.title}`;
+ * }
+ * ```
+ */
+import { defineChannel, } from "../plugin.js";
+import { githubChannelAdapter } from "./adapter-core.js";
+/** Env vars for Phase 1 single-install GitHub App webhooks. */
+export const GITHUB_CHANNEL_REQUIRED_ENV = [
+    "GITHUB_WEBHOOK_SECRET",
+    "GITHUB_APP_ID",
+    "GITHUB_APP_PRIVATE_KEY",
+    "GITHUB_INSTALLATION_ID",
+];
+/**
+ * Declare a managed GitHub channel. Files under `channels/*.ts` export a named
+ * `channel` created with this helper.
+ *
+ * @param config - Handlers that map webhook events to agent turns.
+ */
+export function defineGitHubChannel(config) {
+    const normalized = validateAndNormalize(config);
+    return defineChannel({
+        provider: "github",
+        adapter: githubChannelAdapter,
+        config: normalized,
+        toManifest: () => toGitHubChannelManifest(normalized),
+    });
+}
+/**
+ * GitHub App permissions implied by handlers.
+ *
+ * Auto-reply comments need `issues:write`. Contents/metadata reads are declared
+ * broadly so arbitrary webhook handlers can inspect payloads; tighten App
+ * permissions in GitHub settings to match what you actually use.
+ */
+export function requiredGitHubPermissions(config) {
+    const perms = new Set(["metadata:read"]);
+    for (const handler of config.handlers) {
+        if (handler.autoReply) {
+            perms.add("issues:write");
+            perms.add("pull_requests:read");
+        }
+    }
+    return [...perms].sort();
+}
+/**
+ * Build author-supplied deploy fields for a GitHub channel.
+ *
+ * `name` and `provider` are stamped by {@link defineChannel} / `toManifest(name)`.
+ */
+export function toGitHubChannelManifest(definition) {
+    const config = "config" in definition && definition.config
+        ? definition.config
+        : definition;
+    const handlers = config.handlers.map((handler) => ({
+        on: handler.on,
+        repositories: handler.repositories,
+        autoReply: handler.autoReply,
+    }));
+    const triggers = [...new Set(handlers.map((h) => h.on))];
+    const anyAutoReply = handlers.some((h) => h.autoReply);
+    return {
+        autoReply: anyAutoReply,
+        requiredPermissions: requiredGitHubPermissions(config),
+        requiredEnv: [...GITHUB_CHANNEL_REQUIRED_ENV],
+        providerConfig: {
+            triggers,
+            handlers: handlers,
+        },
+    };
+}
+/**
+ * Whether a handler `on` filter matches a delivery.
+ *
+ * @param on - `"*"`, `"pull_request"`, or `"pull_request.opened"`
+ * @param eventName - `X-GitHub-Event`
+ * @param action - `payload.action` when present
+ */
+export function githubTriggerMatches(on, eventName, action) {
+    if (!on || !eventName)
+        return false;
+    if (on === "*")
+        return true;
+    if (on === eventName)
+        return true;
+    if (action !== undefined && on === `${eventName}.${action}`)
+        return true;
+    return false;
+}
+/**
+ * Find the first handler that matches event/action + repository.
+ *
+ * @returns The handler, or `undefined` when no handler matches (event ignored).
+ */
+export function matchGitHubHandler(config, eventName, repository, action) {
+    for (const handler of config.handlers) {
+        if (!githubTriggerMatches(handler.on, eventName, action))
+            continue;
+        const repos = handler.repositories;
+        if (repos && repos.length > 0) {
+            if (!repository || !repos.includes(repository))
+                continue;
+        }
+        return handler;
+    }
+    return undefined;
+}
+function validateAndNormalize(config) {
+    if (config === null || typeof config !== "object") {
+        throw new Error("defineGitHubChannel(...) requires a configuration object.");
+    }
+    if (!Array.isArray(config.handlers) || config.handlers.length === 0) {
+        throw new Error("defineGitHubChannel(...) requires a non-empty `handlers` array.");
+    }
+    const handlers = [];
+    for (let i = 0; i < config.handlers.length; i++) {
+        const raw = config.handlers[i];
+        if (raw === null || typeof raw !== "object") {
+            throw new Error(`defineGitHubChannel(...) handlers[${i}] must be an object.`);
+        }
+        if (typeof raw.on !== "string" || raw.on.trim().length === 0) {
+            throw new Error(`defineGitHubChannel(...) handlers[${i}].on must be a non-empty string ` +
+                '(e.g. "pull_request", "pull_request.opened", or "*").');
+        }
+        if (typeof raw.prompt !== "function") {
+            throw new Error(`defineGitHubChannel(...) handlers[${i}] requires a \`prompt\` function.`);
+        }
+        const autoReply = raw.autoReply ?? true;
+        if (typeof autoReply !== "boolean") {
+            throw new Error(`defineGitHubChannel(...) handlers[${i}].autoReply must be a boolean.`);
+        }
+        let repositories;
+        if (raw.repositories !== undefined) {
+            if (!Array.isArray(raw.repositories) ||
+                raw.repositories.some((v) => typeof v !== "string")) {
+                throw new Error(`defineGitHubChannel(...) handlers[${i}].repositories must be an array of strings.`);
+            }
+            repositories = [...raw.repositories];
+        }
+        handlers.push({
+            on: raw.on.trim(),
+            repositories,
+            autoReply,
+            prompt: raw.prompt,
+        });
+    }
+    return { handlers };
+}
+//# sourceMappingURL=define.js.map