managed-deepagents 0.10.0-dev.1 → 0.10.0-dev.11

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

@@ -38,9 +38,40 @@ export type HttpIngressStart = StartedIngressRun | {
 export declare function waitForHttpIngressThread(input: HttpIngressSource & {
     threadId: string;
 }): Promise<void>;
+/**
+ * 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>;
-export declare function observeHttpIngressAgent(input: HttpIngressSource & StartedIngressRun): Promise<StartedIngressRun & {
-    replyContent: MessageContent | null;
-}>;
+/** How a channel run ended; the run posts its own answer. */
+export type HttpIngressOutcome = 
+/** It finished. */
+{
+    type: "answered";
+}
+/** It stopped on interrupts, so the thread waits on a decision. */
+ | {
+    type: "paused";
+    assistantId?: string;
+}
+/** It was cancelled, with nothing left to answer. */
+ | {
+    type: "cancelled";
+}
+/** A newer message's `rollback` deleted it. */
+ | {
+    type: "replaced";
+}
+/** It failed. */
+ | {
+    type: "failed";
+};
+export declare function observeHttpIngressAgent(input: HttpIngressSource & StartedIngressRun): Promise<HttpIngressOutcome>;
 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":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,OAAO,EASL,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;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASpB;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CA2E3B;AA8CD,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB;AAC5B,mBAAmB;AACjB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE;AACtB,mEAAmE;GACjE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;AAC1C,qDAAqD;GACnD;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE;AACvB,+CAA+C;GAC7C;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE;AACtB,iBAAiB;GACf;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,GAC3C,OAAO,CAAC,kBAAkB,CAAC,CA6C7B"}

package/dist/channels/http/ingress.js

@@ -1,13 +1,11 @@
 /** 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 { 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, startIngressRun, waitForIdleThread, observeIngressRun, recordThreadDelivery, } from "../../ingress/runs.js";
 /** Wait until the thread's queued and running runs have finished. */
 export async function waitForHttpIngressThread(input) {
     const client = createIngressLoopbackClient({
@@ -17,6 +15,17 @@ export async function waitForHttpIngressThread(input) {
     });
     await waitForIdleThread(client, input.threadId);
 }
+/**
+ * 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");
@@ -27,9 +36,6 @@ export async function startHttpIngressAgent(input) {
         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 },
-    };
     // A new turn would abandon the decision the thread waits on.
     if (state === "paused")
         return {
@@ -48,12 +54,20 @@ export async function startHttpIngressAgent(input) {
         : await input.prepare?.();
     if (!prepared)
         return { skipped: "ignored" };
+    // The handler's metadata goes under MDA's own.
+    const metadata = {
+        ...prepared.metadata,
+        ...(input.deliveryKey !== undefined && {
+            [DELIVERY_KEY_METADATA]: input.deliveryKey,
+        }),
+    };
     let started;
     try {
         started = await startIngressRun(client, {
             threadId: input.threadId,
             assistantId: input.assistantId,
-            ...metadata,
+            ...(Object.keys(metadata).length && { metadata }),
+            ...(prepared.webhook !== undefined && { webhook: prepared.webhook }),
             multitaskStrategy: strategy,
             messages: prepared.messages,
             ...(Object.keys(prepared.state).length && { state: prepared.state }),
@@ -134,15 +148,23 @@ export async function observeHttpIngressAgent(input) {
         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 };
+        return { type: "replaced" };
     }
     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");
-    }
+    // A cancelled run ends `interrupted` too; only pending interrupts pause.
+    const paused = async () => {
+        const { state, assistantId } = await ingressThreadState(client, input.threadId);
+        if (state === "paused")
+            return {
+                type: "paused",
+                ...(assistantId !== undefined && { assistantId }),
+            };
+        return { type: status === "interrupted" ? "cancelled" : "answered" };
+    };
+    if (status === "interrupted")
+        return await paused();
+    if (status !== "success")
+        return { type: "failed" };
     const state = values && typeof values === "object" && !Array.isArray(values)
         ? values
         : {};
@@ -150,15 +172,9 @@ export async function observeHttpIngressAgent(input) {
     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,
-    };
+    // A run that stops on `interrupt()` can still end `success`.
+    if (interrupted)
+        return await paused();
+    return { type: "answered" };
 }
 //# 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":"AAAA,+EAA+E;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EACL,YAAY,GAGb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GAErB,MAAM,uBAAuB,CAAC;AA6C/B,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA+C;IAE/C,MAAM,MAAM,GAAG,2BAA2B,CAAC;QACzC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ;KAC/D,CAAC,CAAC;IACH,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAK3C;IACC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,YAAY,CACpB,oBAAoB,EACpB,mDAAmD,CACpD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAA4B;IAE5B,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,YAAY,CACpB,oBAAoB,EACpB,mDAAmD,CACpD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,2BAA2B,CAAC;QACzC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ;KAC/D,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,kBAAkB,CACrD,MAAM,EACN,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,WAAW,CAClB,CAAC;IACF,6DAA6D;IAC7D,IAAI,KAAK,KAAK,QAAQ;QACpB,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;SAClD,CAAC;IACJ,MAAM,QAAQ,GAAG,KAAK,CAAC,iBAAiB,IAAI,SAAS,CAAC;IACtD,kEAAkE;IAClE,MAAM,gBAAgB,GAAG,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,UAAU,CAAC;IAC7E,IAAI,KAAK,KAAK,MAAM,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAC9E,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,gBAAgB,CAAC;QAC9D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,MAAM,QAAQ,GACZ,KAAK,CAAC,KAAK,KAAK,SAAS;QACvB,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;QAC9B,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;IAC9B,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC7C,+CAA+C;IAC/C,MAAM,QAAQ,GAAG;QACf,GAAG,QAAQ,CAAC,QAAQ;QACpB,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI;YACrC,CAAC,qBAAqB,CAAC,EAAE,KAAK,CAAC,WAAW;SAC3C,CAAC;KACH,CAAC;IACF,IAAI,OAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,IAAI,EAAE,QAAQ,EAAE,CAAC;YACjD,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;YACpE,iBAAiB,EAAE,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpE,GAAG,sBAAsB,CAAC;gBACxB,gEAAgE;gBAChE,eAAe;gBACf,OAAO,EACL,KAAK,CAAC,KAAK,KAAK,SAAS;oBACvB,CAAC,CAAC,KAAK,CAAC,OAAO;oBACf,CAAC,CAAC;wBACE,GAAG,KAAK,CAAC,OAAO;wBAChB,KAAK,EAAE;4BACL,IAAI,EAAE,SAAS;4BACf,QAAQ,EAAE,QAAQ,CAAC,QAAuB;yBAC3C;qBACF;gBACP,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO;aAC3C,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,6DAA6D;QAC7D,IAAI,QAAQ,KAAK,QAAQ,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,GAAG;YACtD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,sBAAsB,CACnC,MAAsD,EACtD,KAA4B;IAE5B,IAAI,KAAK,CAAC,iBAAiB,KAAK,UAAU,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAC3E,OAAO;IACT,IAAI,CAAC;QACH,MAAM,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACxE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,MAAM,CAAC,IAAI,CACT,mDAAmD,IAAI,CAAC,SAAS,CAAC;YAChE,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC;SAC5B,CAAC,EAAE,CACL,CAAC;IACJ,CAAC;AACH,CAAC;AAED,wCAAwC;AACxC,SAAS,eAAe,CAAC,OAAuB;IAC9C,MAAM,OAAO,GACX,OAAO,OAAO,KAAK,QAAQ;QACzB,CAAC,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC;QAC3B,CAAC,CAAC,IAAI,YAAY,CAAC;YACf,aAAa,EAAE,OAAkC;SAClD,CAAC,CAAC;IACT,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,OAAO,CAAC,OAAoB;gBACrC,iBAAiB,EAAE,OAAO,CAAC,iBAA8B;aAC1D;SACF;QACD,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAeD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAA4C;IAE5C,MAAM,MAAM,GAAG,2BAA2B,CAAC;QACzC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ;KAC/D,CAAC,CAAC;IACH,IAAI,QAAuD,CAAC;IAC5D,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,wEAAwE;QACxE,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,GAAG;YAAE,MAAM,KAAK,CAAC;QAC7C,MAAM,CAAC,IAAI,CACT,4BAA4B,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,CAC3E,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IACpC,yEAAyE;IACzE,MAAM,MAAM,GAAG,KAAK,IAAiC,EAAE;QACrD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,kBAAkB,CACrD,MAAM,EACN,KAAK,CAAC,QAAQ,CACf,CAAC;QACF,IAAI,KAAK,KAAK,QAAQ;YACpB,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;aAClD,CAAC;QACJ,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IACvE,CAAC,CAAC;IACF,IAAI,MAAM,KAAK,aAAa;QAAE,OAAO,MAAM,MAAM,EAAE,CAAC;IACpD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACpD,MAAM,KAAK,GACT,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5D,CAAC,CAAE,MAAkC;QACrC,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,WAAW,GACf,UAAU;QACV,OAAO,UAAU,KAAK,QAAQ;QAC9B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACrC,6DAA6D;IAC7D,IAAI,WAAW;QAAE,OAAO,MAAM,MAAM,EAAE,CAAC;IACvC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,99 @@
+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, HttpDeliveryOutcome } from "./types.js";
+import { type EventEndpoint } 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 `onEvent` with each endpoint, a URL or `Request`, replaced by
+ * the handler it stands for, so the channel calls handlers alone. A bad
+ * endpoint throws when the channel is declared.
+ */
+export declare function resolveEndpoints<T extends object>(provider: string, onEvent: T | undefined): {
+    [K in keyof T]: Exclude<T[K], EventEndpoint>;
+};
+/**
+ * A provider channel's `onSettled`: how a delivery of one of its events
+ * ended, with the event and its thread; see `channels.http`'s `onSettled`.
+ */
+export type EventSettled<E, T = EventThread> = (event: E, thread: T, outcome: HttpDeliveryOutcome) => void | Promise<void>;
+/** The thread a provider channel's hooks hear about. */
+export interface EventThread {
+    id: string;
+    channel: {
+        name: string;
+    };
+}
+/**
+ * The HTTP channel's `onSettled` 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 settleEvents<E>(notice: NonNullable<HttpChannelAdapter["onSettled"]>, onSettled: EventSettled<E> | undefined, parse: (rawEvent: JsonValue | undefined) => E | undefined, name: () => string): HttpChannelAdapter["onSettled"];
+/** 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,188 @@
+/**
+ * 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 throws when the channel is declared.
+ */
+export function resolveEndpoints(provider, onEvent) {
+    return Object.fromEntries(Object.entries(onEvent ?? {}).map(([key, value]) => [
+        key,
+        isEventEndpoint(value)
+            ? endpointHandler(value, `${provider} onEvent["${key}"]`)
+            : value,
+    ]));
+}
+/**
+ * The HTTP channel's `onSettled` 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 settleEvents(notice, onSettled, parse, name) {
+    return async (target, delivery) => {
+        try {
+            await notice(target, delivery);
+        }
+        catch (error) {
+            logger.error(`channel ${delivery.outcome.type} notice failed (${logger.safeErrorLabel(error)})`);
+        }
+        const event = onSettled && parse(delivery.rawEvent);
+        if (event === undefined)
+            return;
+        await onSettled?.(event, { id: delivery.threadId, channel: { name: name() } }, delivery.outcome);
+    };
+}
+/** 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

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

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

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

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import type { JsonValue } from "../types.js";
+/**
+ * Where the thread's latest channel delivery came from, kept in its state.
+ * Private (the leading `_`), so it's never part of a run's input or output.
+ */
+export declare const CHANNEL_REPLY_STATE_KEY = "_mda_channel_reply";
+/**
+ * Remember a channel delivery's target in the thread's state, and post the
+ * answer to it when the agent finishes. A run that stops on `interrupt()` or
+ * is cancelled doesn't finish, so it posts nothing; the run that resumes it
+ * carries no delivery, so it answers the remembered target.
+ */
+export declare function createChannelReplyMiddleware(): import("langchain").AgentMiddleware<z.ZodObject<{
+    _mda_channel_reply: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        target: z.ZodCustom<JsonValue, JsonValue>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined, unknown, readonly (import("@langchain/core/tools").ServerTool | import("@langchain/core/tools").ClientTool)[], readonly []>;
+//# sourceMappingURL=reply.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../../src/channels/http/reply.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAqD5D;;;;;GAKG;AACH,wBAAgB,4BAA4B;;;;;0JAyC3C"}

package/dist/channels/http/reply.js

@@ -0,0 +1,116 @@
+/**
+ * An HTTP channel run posts its own answer.
+ *
+ * The run does it, not the process that received the delivery, so a restart
+ * of that process doesn't lose the answer, and a run LangSmith Studio resumes
+ * after a decision answers the conversation the paused run came from.
+ */
+import { getConfig } from "@langchain/langgraph";
+import { createMiddleware } from "langchain";
+import { z } from "zod";
+import { extractAssistantContent } from "../assistant-text.js";
+import { resolveChannelBinding } from "../binding.js";
+import { isJsonValue } from "../message-schema.js";
+import { messagingTransportForName } from "../messaging-registry.js";
+import { isTrustedScheduleDeliveryRun } from "../schedule-delivery.js";
+import { CHANNEL_THREAD_METADATA, configurableFromRuntime, resolveAmbientConfigurable, } from "../../runtime/identity-runtime.js";
+import { logger } from "../../runtime/log.js";
+/**
+ * Where the thread's latest channel delivery came from, kept in its state.
+ * Private (the leading `_`), so it's never part of a run's input or output.
+ */
+export const CHANNEL_REPLY_STATE_KEY = "_mda_channel_reply";
+const replyTargetSchema = z.object({
+    name: z.string().min(1),
+    target: z.custom((value) => isJsonValue(value)),
+});
+/**
+ * The run's verified HTTP channel delivery: one the channel's ingress started
+ * for that conversation (the binding matches the run's authenticated source),
+ * never one a caller put in the run's context.
+ */
+function deliveredTarget(runtime) {
+    const configurable = configurableFromRuntime(runtime) ??
+        resolveAmbientConfigurable();
+    const binding = resolveChannelBinding(undefined, configurable);
+    // Only HTTP channels deliver directly; others answer on their own.
+    if (!binding || binding.transport !== "direct")
+        return undefined;
+    return { name: binding.name, target: binding.target };
+}
+/**
+ * Whether the run is on a channel's thread. Only managed ingress marks one;
+ * the runtime's auth strips the marker from every other thread and run, so a
+ * caller can't point its own thread's stored target at someone else's
+ * conversation. Channel threads take runs only from their channel and resumes
+ * from LangSmith Studio.
+ */
+function onChannelThread() {
+    try {
+        const metadata = getConfig().metadata;
+        return metadata?.[CHANNEL_THREAD_METADATA] === "true";
+    }
+    catch {
+        // Outside a runnable context.
+        return false;
+    }
+}
+function storedTarget(state) {
+    if (!onChannelThread())
+        return undefined;
+    const value = state && typeof state === "object" && !Array.isArray(state)
+        ? state[CHANNEL_REPLY_STATE_KEY]
+        : undefined;
+    const parsed = replyTargetSchema.safeParse(value);
+    return parsed.success ? parsed.data : undefined;
+}
+/**
+ * Remember a channel delivery's target in the thread's state, and post the
+ * answer to it when the agent finishes. A run that stops on `interrupt()` or
+ * is cancelled doesn't finish, so it posts nothing; the run that resumes it
+ * carries no delivery, so it answers the remembered target.
+ */
+export function createChannelReplyMiddleware() {
+    return createMiddleware({
+        name: "mda-channel-reply",
+        stateSchema: z.object({
+            [CHANNEL_REPLY_STATE_KEY]: replyTargetSchema.optional(),
+        }),
+        beforeAgent(_state, runtime) {
+            const delivered = deliveredTarget(runtime);
+            return delivered ? { [CHANNEL_REPLY_STATE_KEY]: delivered } : undefined;
+        },
+        async afterAgent(state, runtime) {
+            const configurable = configurableFromRuntime(runtime) ??
+                resolveAmbientConfigurable();
+            // Scheduled runs post through schedule delivery.
+            if (isTrustedScheduleDeliveryRun(configurable))
+                return undefined;
+            const reply = deliveredTarget(runtime) ?? storedTarget(state);
+            if (!reply)
+                return undefined;
+            const content = extractAssistantContent({
+                messages: state.messages,
+            });
+            if (content === null)
+                return undefined;
+            const transport = messagingTransportForName(reply.name);
+            if (!transport) {
+                logger.warn(`channel reply skipped: no channel ${JSON.stringify(logger.logIdentifier(reply.name))}`);
+                return undefined;
+            }
+            try {
+                await transport.post({
+                    message: { type: "content", content },
+                    target: reply.target,
+                });
+            }
+            catch (error) {
+                // The answer stays in the thread; the run itself succeeded.
+                logger.error(`channel reply failed (${logger.safeErrorLabel(error)})`);
+            }
+            return undefined;
+        },
+    });
+}
+//# sourceMappingURL=reply.js.map