managed-deepagents 0.10.0-dev.16 → 0.10.0-dev.18

package/dist/channels/http/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/channels/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgC,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EACL,aAAa,GAGd,MAAM,0BAA0B,CAAC;AAYlC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAI/C,MAAM,oBAAoB,GAAyB,IAAI,GAAG,CAAC;IACzD,SAAS;IACT,WAAW;IACX,UAAU;IACV,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;IACtE,IACE,OAAO,CAAC,iBAAiB,KAAK,SAAS;QACvC,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC;QAEpD,MAAM,IAAI,SAAS,CACjB,0EAA0E,CAC3E,CAAC;IACJ,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAiB,CAAC;IAElD,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAyB,EAAE,EAAE,CACpD,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,CAChC,CAAC;IACF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,GAA4B,EAAE,CAAC,CAAC;YACzD,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CACvC,IAAI,CACF,aAAa,CAAC;gBACZ,GAAG,OAAO;gBACV,MAAM;gBACN,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;aAClD,CAAC,CACH;SACJ,CAAC,CAAC,CAAC;IACN,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,IAAY,EAAmB,EAAE,CAAC,CAAC;QAChE,IAAI;QACJ,QAAQ;QACR,UAAU,EAAE,aAAa,IAAI,SAAS;QACtC,SAAS,EAAE,IAAI,KAAK,SAAS;QAC7B,mBAAmB,EAAE,EAAE;QACvB,WAAW,EAAE,EAAE;QACf,cAAc,EAAE,aAAa,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;KAC5D,CAAC,CAAC,CAAC;IACJ,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,KAAa;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,IAAI,CAAC,MAAc,EAAE,GAAoB,EAAE,KAAc;IAChE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/channels/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgC,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EACL,aAAa,GAGd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAkB9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAI/C,MAAM,UAAU,GAAyB,IAAI,GAAG,CAC9C,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CACpC,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;IAC7E,IACE,OAAO,CAAC,iBAAiB,KAAK,SAAS;QACvC,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC;QAE1C,MAAM,IAAI,SAAS,CACjB,0EAA0E,CAC3E,CAAC;IACJ,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAiB,CAAC;IAElD,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAyB,EAAE,EAAE,CACpD,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,CAChC,CAAC;IACF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,GAA4B,EAAE,CAAC,CAAC;YACzD,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CACvC,IAAI,CACF,aAAa,CAAC;gBACZ,GAAG,OAAO;gBACV,MAAM;gBACN,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;aAClD,CAAC,CACH;SACJ,CAAC,CAAC,CAAC;IACN,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,IAAY,EAAmB,EAAE,CAAC,CAAC;QAChE,IAAI;QACJ,QAAQ;QACR,UAAU,EAAE,aAAa,IAAI,SAAS;QACtC,SAAS,EAAE,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM;QACzD,mBAAmB,EAAE,EAAE;QACvB,WAAW,EAAE,EAAE;QACf,cAAc,EAAE,aAAa,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;KAC5D,CAAC,CAAC,CAAC;IACJ,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,IAAI,CAAC,MAAc,EAAE,GAAoB,EAAE,KAAc;IAChE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/channels/http/ingress.d.ts

@@ -1,8 +1,10 @@
+import type { Interrupt } from "@langchain/langgraph-sdk";
 import type { MultitaskStrategy } from "../../ingress/runs.js";
 import { type MessageContent } from "@langchain/core/messages";
-import type { ChannelBinding } from "../binding.js";
+import { type ChannelBinding } from "../binding.js";
 import { type StartedIngressRun } from "../../ingress/runs.js";
-import type { NormalizedRunInput } from "../run-input.js";
+import { type NormalizedRunInput } from "../run-input.js";
+import type { HttpRunStatus } from "./types.js";
 interface HttpIngressSource {
     userId: string;
     sourceThreadKey: string;
@@ -31,6 +33,8 @@ export type HttpIngressStart = StartedIngressRun | {
     skipped: "paused";
     /** The paused thread's assistant, for links into LangSmith Studio. */
     assistantId?: string;
+    /** What the thread waits on. */
+    interrupts: Interrupt[];
 } | {
     skipped: "duplicate" | "busy" | "rejected" | "ignored";
 };
@@ -38,9 +42,40 @@ export type HttpIngressStart = StartedIngressRun | {
 export declare function waitForHttpIngressThread(input: HttpIngressSource & {
     threadId: string;
 }): Promise<void>;
-export declare function startHttpIngressAgent(input: StartHttpIngressInput): Promise<HttpIngressStart>;
-export declare function observeHttpIngressAgent(input: HttpIngressSource & StartedIngressRun): Promise<StartedIngressRun & {
-    replyContent: MessageContent | null;
+/** What the thread waits on now, and its assistant, for links into LangSmith Studio. */
+export declare function httpIngressThreadWaitsOn(input: {
+    userId: string;
+    sourceThreadKey: string;
+    sourceProvider: string;
+    threadId: string;
+}): Promise<{
+    interrupts: Interrupt[];
+    assistantId?: string;
 }>;
+/**
+ * Cancel the thread's queued and running runs, keeping their progress.
+ * Returns the IDs of the runs it cancelled.
+ */
+export declare function cancelHttpIngressRuns(input: {
+    userId: string;
+    sourceThreadKey: string;
+    sourceProvider: string;
+    threadId: string;
+}): Promise<string[]>;
+export declare function startHttpIngressAgent(input: StartHttpIngressInput): Promise<HttpIngressStart>;
+/** How a run a channel started ended, in LangGraph's terms. */
+export interface HttpIngressOutcome {
+    /** The run's status; one a newer message's `rollback` deleted reads as `interrupted`. */
+    status: HttpRunStatus;
+    /** The thread's pending interrupts once it ended: what it now waits on. */
+    interrupts: Interrupt[];
+    /** The thread's assistant, for links into LangSmith Studio. */
+    assistantId?: string;
+}
+/**
+ * How the run ended, or `undefined` when it hasn't, as observing it stopped
+ * while it was still `pending` or `running`: it may still answer.
+ */
+export declare function observeHttpIngressAgent(input: HttpIngressSource & StartedIngressRun): Promise<HttpIngressOutcome | undefined>;
 export {};
 //# sourceMappingURL=ingress.d.ts.map

package/dist/channels/http/ingress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ingress.d.ts","sourceRoot":"","sources":["../../../src/channels/http/ingress.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,OAAO,EAQL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAS1D,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CAC7C;AAED,UAAU,qBAAsB,SAAQ,iBAAiB;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,4FAA4F;AAC5F,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB;IACE,OAAO,EAAE,QAAQ,CAAC;IAClB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACD;IAAE,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/D,qEAAqE;AACrE,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,iBAAiB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAsE3B;AA8CD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,GAC3C,OAAO,CAAC,iBAAiB,GAAG;IAAE,YAAY,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CAAC,CA8CtE"}
+{"version":3,"file":"ingress.d.ts","sourceRoot":"","sources":["../../../src/channels/http/ingress.ts"],"names":[],"mappings":"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"}

package/dist/channels/http/ingress.js

@@ -1,13 +1,13 @@
 /** HTTP content and reply handling around the shared ingress run lifecycle. */
 import { INTERRUPT } from "@langchain/langgraph";
 import { HumanMessage, } from "@langchain/core/messages";
-import { extractAssistantContent } from "../assistant-text.js";
 import { logger } from "../../runtime/log.js";
 import { buildIngressRunContext } from "../../ingress/index.js";
 import { ChannelError } from "../errors.js";
-import { validateMessage } from "../runtime.js";
+import { bindingWithMessages } from "../binding.js";
 import { createIngressLoopbackClient, hasLoopbackCredential, } from "../../ingress/loopback.js";
-import { DELIVERY_KEY_METADATA, ingressThreadState, lookupStatus, startIngressRun, waitForIdleThread, observeIngressRun, recordThreadDelivery, } from "../../ingress/runs.js";
+import { DELIVERY_KEY_METADATA, cancelIngressRuns, ingressThreadState, lookupStatus, rejectedAsBusy, startIngressRun, waitForIdleThread, observeIngressRun, recordThreadDelivery, } from "../../ingress/runs.js";
+import { runStartOptions } from "../run-input.js";
 /** Wait until the thread's queued and running runs have finished. */
 export async function waitForHttpIngressThread(input) {
     const client = createIngressLoopbackClient({
@@ -17,6 +17,23 @@ export async function waitForHttpIngressThread(input) {
     });
     await waitForIdleThread(client, input.threadId);
 }
+/** What the thread waits on now, and its assistant, for links into LangSmith Studio. */
+export async function httpIngressThreadWaitsOn(input) {
+    const client = createIngressLoopbackClient(input);
+    const { interrupts, assistantId } = await ingressThreadState(client, input.threadId);
+    return { interrupts, ...(assistantId !== undefined && { assistantId }) };
+}
+/**
+ * Cancel the thread's queued and running runs, keeping their progress.
+ * Returns the IDs of the runs it cancelled.
+ */
+export async function cancelHttpIngressRuns(input) {
+    if (!hasLoopbackCredential()) {
+        throw new ChannelError("channel_run_failed", "managed loopback authentication is not configured");
+    }
+    const client = createIngressLoopbackClient(input);
+    return cancelIngressRuns(client, input.threadId);
+}
 export async function startHttpIngressAgent(input) {
     if (!hasLoopbackCredential()) {
         throw new ChannelError("channel_run_failed", "managed loopback authentication is not configured");
@@ -26,15 +43,13 @@ export async function startHttpIngressAgent(input) {
         sourceThreadKey: input.sourceThreadKey,
         sourceProvider: input.sourceProvider ?? input.binding.provider,
     });
-    const { state, assistantId } = await ingressThreadState(client, input.threadId, input.deliveryKey);
-    const metadata = input.deliveryKey !== undefined && {
-        metadata: { [DELIVERY_KEY_METADATA]: input.deliveryKey },
-    };
+    const { state, assistantId, interrupts } = await ingressThreadState(client, input.threadId, input.deliveryKey);
     // A new turn would abandon the decision the thread waits on.
     if (state === "paused")
         return {
             skipped: "paused",
             ...(assistantId !== undefined && { assistantId }),
+            interrupts,
         };
     const strategy = input.multitaskStrategy ?? "enqueue";
     // `interrupt` and `rollback` start now and cancel the active run.
@@ -53,29 +68,23 @@ export async function startHttpIngressAgent(input) {
         started = await startIngressRun(client, {
             threadId: input.threadId,
             assistantId: input.assistantId,
-            ...metadata,
             multitaskStrategy: strategy,
-            messages: prepared.messages,
-            ...(Object.keys(prepared.state).length && { state: prepared.state }),
+            ...runStartOptions(prepared, input.deliveryKey === undefined
+                ? {}
+                : { [DELIVERY_KEY_METADATA]: input.deliveryKey }),
+            threadOrigin: { binding: input.binding, senderId: input.userId },
             ...buildIngressRunContext({
                 // The binding already holds a message's content; prepared input
                 // replaces it.
                 binding: input.input !== undefined
                     ? input.binding
-                    : {
-                        ...input.binding,
-                        event: {
-                            type: "message",
-                            messages: prepared.messages,
-                        },
-                    },
+                    : bindingWithMessages(input.binding, prepared.messages),
                 context: prepared.context ?? input.context,
             }),
         });
     }
     catch (error) {
-        // A run started meanwhile: `reject` leaves the thread to it.
-        if (strategy === "reject" && lookupStatus(error) === 409)
+        if (rejectedAsBusy(strategy, error))
             return { skipped: "rejected" };
         throw error;
     }
@@ -119,46 +128,60 @@ function contentRunInput(content) {
         state: {},
     };
 }
+const ENDED_STATUSES = new Set([
+    "success",
+    "error",
+    "timeout",
+    "interrupted",
+]);
+function isRunStatus(status) {
+    return ENDED_STATUSES.has(status);
+}
+/**
+ * How the run ended, or `undefined` when it hasn't, as observing it stopped
+ * while it was still `pending` or `running`: it may still answer.
+ */
 export async function observeHttpIngressAgent(input) {
     const client = createIngressLoopbackClient({
         userId: input.userId,
         sourceThreadKey: input.sourceThreadKey,
         sourceProvider: input.sourceProvider ?? input.binding.provider,
     });
+    // What the thread waits on now, read only when the run may have stopped on it.
+    const waitingOn = async (status) => {
+        const { interrupts, assistantId } = await ingressThreadState(client, input.threadId);
+        return {
+            status,
+            interrupts,
+            ...(assistantId !== undefined && { assistantId }),
+        };
+    };
     let observed;
     try {
         observed = await observeIngressRun(client, input);
     }
     catch (error) {
-        // `rollback` deletes the run a newer message replaced; it has no reply.
+        // `rollback` cancels, then deletes, the run a newer message replaced.
         if (lookupStatus(error) !== 404)
             throw error;
         logger.info(`channel run was replaced ${JSON.stringify({ threadId: input.threadId })}`);
-        return { replyContent: null, threadId: input.threadId, runId: input.runId };
+        // It was cancelled; what the thread waits on now is the newer run's.
+        return waitingOn("interrupted");
     }
     const { values, status } = observed;
-    if (status === "interrupted") {
-        return { replyContent: null, threadId: input.threadId, runId: input.runId };
-    }
-    if (status !== "success") {
-        throw new ChannelError("channel_run_failed", "channel run did not complete successfully");
+    if (!isRunStatus(status)) {
+        logger.warn(`channel run had not ended when observed ${JSON.stringify({ threadId: input.threadId, status })}`);
+        return undefined;
     }
+    const ended = status;
     const state = values && typeof values === "object" && !Array.isArray(values)
         ? values
         : {};
-    const interrupts = state[INTERRUPT];
-    const interrupted = interrupts &&
-        typeof interrupts === "object" &&
-        Object.keys(interrupts).length > 0;
-    const content = interrupted ? null : extractAssistantContent(state);
-    if (content === null)
-        return { replyContent: null, threadId: input.threadId, runId: input.runId };
-    const reply = { type: "content", content };
-    validateMessage(reply);
-    return {
-        replyContent: reply.content,
-        threadId: input.threadId,
-        runId: input.runId,
-    };
+    const raised = state[INTERRUPT];
+    // A run that stops on `interrupt()` can still end `success`.
+    if (ended === "interrupted" ||
+        (raised && typeof raised === "object" && Object.keys(raised).length > 0))
+        return waitingOn(ended);
+    return { status: ended, interrupts: [] };
 }
 //# sourceMappingURL=ingress.js.map

package/dist/channels/http/ingress.js.map

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

package/dist/channels/http/provider.d.ts

@@ -0,0 +1,119 @@
+import type { JsonObject } from "../manifest.js";
+import type { JsonValue } from "../types.js";
+import type { ChannelRunResult } from "../run-input.js";
+import type { HttpChannel } from "./index.js";
+import type { HttpChannelAdapter, HttpFinish, HttpFinishedDelivery } from "./types.js";
+import { type EndpointEvent, type EndpointThread, type EventEndpoint, type EventField } from "./endpoint.js";
+/** The channel's name in the project, or its provider before it has one. */
+export declare function channelName(channel: HttpChannel): string;
+/**
+ * Check a channel's `onEvent` keys. The types limit them, but a JavaScript
+ * caller or a cast gets no error, and a key nothing dispatches never runs.
+ */
+export declare function checkEventKeys(provider: string, handlers: object, supported: ReadonlySet<string>): void;
+/** A channel's event handler, as the channel calls it with the event's thread. */
+export type EventCallback<E, T> = (event: E, thread: T) => EventHandlerResult | Promise<EventHandlerResult>;
+/**
+ * A channel's `onEvent` with each endpoint, a URL or `Request`, replaced by
+ * the handler it stands for, so the channel calls handlers alone. A bad
+ * endpoint, or a value that is neither a handler nor an endpoint, throws when
+ * the channel is declared. The endpoint's handler is
+ * typed as the channel's own: `E` and `T` carry what it sends, and `fields`
+ * are the channel's own fields of `E` it sends beside key, delivery ID and
+ * payload, listed in one place per channel.
+ */
+export declare function resolveEndpoints<E extends EndpointEvent, T extends EndpointThread, X extends EventField<E> & string = never>(provider: string, onEvent: Readonly<Record<string, EventCallback<E, T> | EventEndpoint | undefined>> | undefined, fields?: readonly X[]): Partial<Record<string, EventCallback<E, T>>>;
+/**
+ * A provider channel's `onFinish`: a delivery of one of its events is done,
+ * with the event, its thread, and how it finished, to switch on by `type`:
+ * the run it started, why it started none, or that MDA lost it; see
+ * {@link HttpFinish}.
+ */
+export type EventFinished<E, T = EventThread> = (event: E, thread: T, finished: HttpFinish) => void | Promise<void>;
+/** The thread a provider channel's hooks hear about. */
+export interface EventThread {
+    id: string;
+    channel: {
+        name: string;
+    };
+}
+/** The thread of a delivery to the channel named `name`. */
+export declare function eventThread(delivery: {
+    threadId: string;
+}, name: string): EventThread;
+/**
+ * The HTTP channel's `onFinish` for a provider channel: the channel's own
+ * notice first, such as a link to a pending decision, then the user's hook,
+ * for the deliveries whose event the channel parsed. A failing notice is
+ * logged and doesn't keep the user's hook from running.
+ */
+export declare function finishEvents<E, T = EventThread>(notice: NonNullable<HttpChannelAdapter["onFinish"]>, onFinish: EventFinished<E, T> | undefined, parse: (rawEvent: JsonValue | undefined) => E | undefined | Promise<E | undefined>, thread: (delivery: HttpFinishedDelivery) => T): HttpChannelAdapter["onFinish"];
+/**
+ * A provider channel's `onReceived`: a delivery of one of its events reached
+ * its thread, before MDA reads the thread; see `channels.http`'s `onReceived`.
+ */
+export type EventReceived<E, T = EventThread> = (event: E, thread: T) => void | Promise<void>;
+/**
+ * The HTTP channel's `onReceived` for a provider channel's user hook, for the
+ * deliveries whose event the channel parsed.
+ */
+export declare function receiveEvents<E>(onReceived: EventReceived<E> | undefined, parse: (rawEvent: JsonValue | undefined) => E | undefined, name: () => string): HttpChannelAdapter["onReceived"];
+/** The events deploy subscribes the provider's webhook to: the handled ones. */
+export declare function handledEventKeys(handlers: object): string[];
+/**
+ * The connection `mda deploy` stores for the provider's app, or one of the
+ * values stored beside it, such as `webhook-secret`, when `suffix` is given.
+ */
+export declare function appConnectionSlug(provider: string, deploymentId: string, suffix?: string): string;
+/**
+ * A frozen copy of a parsed event, kept as the delivery's raw event so a
+ * handler that changes its argument can't change what MDA keeps.
+ */
+export declare function eventSnapshot(event: unknown, provider: string): JsonValue;
+/** App options for deploy, without unset fields. */
+export declare function definedFields(fields: Record<string, JsonValue | undefined>): JsonObject;
+/**
+ * Whether `signature`, a hex HMAC-SHA256 the caller checked the format of,
+ * signs `rawBody` with `secret`. Compared in constant time.
+ */
+export declare function verifyHmacSha256(secret: string, rawBody: Uint8Array, signature: string): boolean;
+/**
+ * A value read at most every `ttlMs(value)` milliseconds. Concurrent callers
+ * share the read in flight; a failed read is not kept, so the next call reads
+ * again.
+ */
+export declare class CachedRead<T> {
+    #private;
+    private readonly read;
+    private readonly ttlMs;
+    constructor(read: () => Promise<T>, ttlMs: (value: T) => number);
+    get(): Promise<T>;
+    /** Read again on the next call. */
+    reset(): void;
+}
+/**
+ * A value `mda deploy` stored for the deployment, such as a webhook secret:
+ * the `env` override when set, otherwise the agent secret Agent Auth keeps at
+ * `slug(deploymentId)`. Only a missing connection reads as `undefined`, and is
+ * logged as `label`; credential store failures propagate.
+ */
+export declare function readDeploymentSecret(env: string, slug: (deploymentId: string) => string, label: string): Promise<string | undefined>;
+/** Forget values read from Agent Auth; for tests. */
+export declare function resetDeploymentSecrets(): void;
+/** What an event's handler did: returned run input, skipped, or threw. */
+export type EventHandlerOutcome = {
+    type: "input";
+    input: ChannelRunResult;
+} | {
+    type: "skipped";
+} | {
+    type: "failed";
+};
+/** What an event handler returns: run input, or nothing to skip. */
+export type EventHandlerResult = ChannelRunResult | null | undefined | void;
+/** Run an event's handler. A throw is logged, not raised. */
+export declare function runEventHandler(provider: string, event: {
+    key: string;
+    deliveryId: string;
+}, call: () => EventHandlerResult | Promise<EventHandlerResult>): Promise<EventHandlerOutcome>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/channels/http/provider.d.ts.map

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

package/dist/channels/http/provider.js

@@ -0,0 +1,227 @@
+/**
+ * What webhook channels built on `httpChannel`, such as GitHub and Linear,
+ * share: their name, the events they subscribe to, the secrets they read from
+ * Agent Auth, signature checks, running an event's handler, and the hooks
+ * that hand their typed events to the user.
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { isJsonValue } from "../message-schema.js";
+import { immutableCopy } from "../runtime.js";
+import { logger } from "../../runtime/log.js";
+import { endpointHandler, isEventEndpoint, } from "./endpoint.js";
+import { ConnectionNotFoundError, DEPLOYMENT_ID_ENV, connections, } from "../../connections.js";
+/** The channel's name in the project, or its provider before it has one. */
+export function channelName(channel) {
+    return channel.name ?? channel.kind;
+}
+/**
+ * Check a channel's `onEvent` keys. The types limit them, but a JavaScript
+ * caller or a cast gets no error, and a key nothing dispatches never runs.
+ */
+export function checkEventKeys(provider, handlers, supported) {
+    const unknown = Object.keys(handlers).filter((key) => !supported.has(key));
+    if (unknown.length)
+        throw new TypeError(`unsupported ${provider} event key ${unknown.sort().join(", ")}`);
+}
+/**
+ * A channel's `onEvent` with each endpoint, a URL or `Request`, replaced by
+ * the handler it stands for, so the channel calls handlers alone. A bad
+ * endpoint, or a value that is neither a handler nor an endpoint, throws when
+ * the channel is declared. The endpoint's handler is
+ * typed as the channel's own: `E` and `T` carry what it sends, and `fields`
+ * are the channel's own fields of `E` it sends beside key, delivery ID and
+ * payload, listed in one place per channel.
+ */
+export function resolveEndpoints(provider, onEvent, fields = []) {
+    return Object.fromEntries(Object.entries(onEvent ?? {}).map(([key, value]) => {
+        const label = `${provider} onEvent["${key}"]`;
+        if (isEventEndpoint(value))
+            return [key, endpointHandler(value, label, fields)];
+        if (value !== undefined && typeof value !== "function")
+            throw new TypeError(`${label} must be a function, a URL or a Request`);
+        return [key, value];
+    }));
+}
+/** The thread of a delivery to the channel named `name`. */
+export function eventThread(delivery, name) {
+    return { id: delivery.threadId, channel: { name } };
+}
+/**
+ * The HTTP channel's `onFinish` for a provider channel: the channel's own
+ * notice first, such as a link to a pending decision, then the user's hook,
+ * for the deliveries whose event the channel parsed. A failing notice is
+ * logged and doesn't keep the user's hook from running.
+ */
+export function finishEvents(notice, onFinish, parse, thread) {
+    return async (target, delivery) => {
+        try {
+            await notice(target, delivery);
+        }
+        catch (error) {
+            logger.error(`channel finish notice failed (${logger.safeErrorLabel(error)})`);
+        }
+        const event = onFinish && (await parse(delivery.rawEvent));
+        if (event === undefined)
+            return;
+        await onFinish?.(event, thread(delivery), finishOf(delivery));
+    };
+}
+/** How a delivery finished, without the delivery's own fields. */
+function finishOf(delivery) {
+    const { interrupts } = delivery;
+    switch (delivery.type) {
+        case "run":
+            return { type: "run", run: delivery.run, interrupts };
+        case "skipped":
+            return { type: "skipped", reason: delivery.reason, interrupts };
+        default:
+            return { type: "failed", reason: delivery.reason, interrupts };
+    }
+}
+/**
+ * The HTTP channel's `onReceived` for a provider channel's user hook, for the
+ * deliveries whose event the channel parsed.
+ */
+export function receiveEvents(onReceived, parse, name) {
+    if (!onReceived)
+        return undefined;
+    return async (_target, delivery) => {
+        const event = parse(delivery.rawEvent);
+        if (event === undefined)
+            return;
+        await onReceived(event, {
+            id: delivery.threadId,
+            channel: { name: name() },
+        });
+    };
+}
+/** The events deploy subscribes the provider's webhook to: the handled ones. */
+export function handledEventKeys(handlers) {
+    return Object.entries(handlers)
+        .filter(([, handler]) => handler !== undefined)
+        .map(([key]) => key)
+        .sort();
+}
+/**
+ * The connection `mda deploy` stores for the provider's app, or one of the
+ * values stored beside it, such as `webhook-secret`, when `suffix` is given.
+ */
+export function appConnectionSlug(provider, deploymentId, suffix) {
+    const slug = `mda/${provider}-app/${deploymentId}`;
+    return suffix ? `${slug}/${suffix}` : slug;
+}
+/**
+ * A frozen copy of a parsed event, kept as the delivery's raw event so a
+ * handler that changes its argument can't change what MDA keeps.
+ */
+export function eventSnapshot(event, provider) {
+    if (!isJsonValue(event))
+        throw new TypeError(`invalid ${provider} event`);
+    return immutableCopy(event);
+}
+/** App options for deploy, without unset fields. */
+export function definedFields(fields) {
+    const defined = {};
+    for (const [key, value] of Object.entries(fields))
+        if (value !== undefined)
+            defined[key] = value;
+    return defined;
+}
+/**
+ * Whether `signature`, a hex HMAC-SHA256 the caller checked the format of,
+ * signs `rawBody` with `secret`. Compared in constant time.
+ */
+export function verifyHmacSha256(secret, rawBody, signature) {
+    const expected = createHmac("sha256", secret).update(rawBody).digest();
+    const given = Buffer.from(signature, "hex");
+    return given.length === expected.length && timingSafeEqual(expected, given);
+}
+/**
+ * A value read at most every `ttlMs(value)` milliseconds. Concurrent callers
+ * share the read in flight; a failed read is not kept, so the next call reads
+ * again.
+ */
+export class CachedRead {
+    read;
+    ttlMs;
+    #entry;
+    constructor(read, ttlMs) {
+        this.read = read;
+        this.ttlMs = ttlMs;
+    }
+    get() {
+        if (this.#entry && this.#entry.expiresAt > Date.now())
+            return this.#entry.value;
+        const entry = {
+            value: this.read().then((value) => {
+                entry.expiresAt = Date.now() + this.ttlMs(value);
+                return value;
+            }, (error) => {
+                if (this.#entry === entry)
+                    this.#entry = undefined;
+                throw error;
+            }),
+            expiresAt: Number.POSITIVE_INFINITY,
+        };
+        this.#entry = entry;
+        return entry.value;
+    }
+    /** Read again on the next call. */
+    reset() {
+        this.#entry = undefined;
+    }
+}
+/** How long a value read from Agent Auth is reused before it is read again. */
+const SECRET_TTL_MS = 5 * 60_000;
+/** How long a missing value is remembered, so unsigned traffic can't hammer Agent Auth. */
+const MISSING_SECRET_TTL_MS = 60_000;
+const deploymentSecrets = new Map();
+/**
+ * A value `mda deploy` stored for the deployment, such as a webhook secret:
+ * the `env` override when set, otherwise the agent secret Agent Auth keeps at
+ * `slug(deploymentId)`. Only a missing connection reads as `undefined`, and is
+ * logged as `label`; credential store failures propagate.
+ */
+export function readDeploymentSecret(env, slug, label) {
+    const override = process.env[env]?.trim();
+    if (override)
+        return Promise.resolve(override);
+    const deploymentId = process.env[DEPLOYMENT_ID_ENV]?.trim();
+    if (!deploymentId)
+        return Promise.resolve(undefined);
+    const key = slug(deploymentId);
+    let cached = deploymentSecrets.get(key);
+    if (!cached) {
+        cached = new CachedRead(() => connections.resolveDeploymentSecret(key).catch((error) => {
+            if (!(error instanceof ConnectionNotFoundError))
+                throw error;
+            logger.error(`${label} is not stored in Agent Auth`);
+            return undefined;
+        }), (value) => (value === undefined ? MISSING_SECRET_TTL_MS : SECRET_TTL_MS));
+        deploymentSecrets.set(key, cached);
+    }
+    return cached.get();
+}
+/** Forget values read from Agent Auth; for tests. */
+export function resetDeploymentSecrets() {
+    deploymentSecrets.clear();
+}
+/** Run an event's handler. A throw is logged, not raised. */
+export async function runEventHandler(provider, event, call) {
+    const receipt = JSON.stringify({
+        event: logger.logIdentifier(event.key),
+        deliveryId: logger.logIdentifier(event.deliveryId),
+    });
+    try {
+        const input = await call();
+        if (input === undefined || input === null)
+            return { type: "skipped" };
+        logger.info(`${provider} handler returned run input ${receipt}`);
+        return { type: "input", input };
+    }
+    catch (error) {
+        logger.error(`${provider.toLowerCase()} callback failed ${receipt} (${logger.safeErrorLabel(error)})`);
+        return { type: "failed" };
+    }
+}
+//# sourceMappingURL=provider.js.map