managed-deepagents 0.10.0-dev.9 → 0.10.1-dev.1

package/dist/browser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The managed `browser.ts` declaration primitive.
+ *
+ * The CLI discovers a root `browser` export in `browser.ts`; MDA then gives the
+ * agent a LangSmith browser and Stagehand's tools, as `browser_run`,
+ * `browser_snapshot` and `browser_screenshot`.
+ *
+ * @example
+ * ```ts
+ * // browser.ts
+ * import { defineBrowser } from "managed-deepagents";
+ *
+ * export const browser = defineBrowser({ scope: "user" });
+ * ```
+ */
+export type BrowserScope = "thread" | "user";
+/** Developer-provided options for the managed browser. */
+export interface BrowserOptions {
+    /**
+     * `"thread"` gives each thread its own browser; `"user"` shares one per
+     * signed-in user across their threads, logins included, with a window per
+     * thread. Runs with no person behind them, such as scheduled runs, get their
+     * thread's browser. Defaults to `"thread"`.
+     */
+    scope?: BrowserScope;
+    /** Stop a browser after this long idle (60 to 86,400). Defaults to 600. */
+    idleTtlSeconds?: number;
+}
+/** The object exported from `browser.ts`. */
+export interface BrowserDefinition {
+    readonly kind: "browser";
+    readonly scope: BrowserScope;
+    readonly idleTtlSeconds: number;
+}
+/** Give the agent a LangSmith browser. */
+export declare function defineBrowser(options?: BrowserOptions): BrowserDefinition;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7C,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,iBAAiB,CAiB7E"}

package/dist/browser.js

@@ -0,0 +1,31 @@
+/**
+ * The managed `browser.ts` declaration primitive.
+ *
+ * The CLI discovers a root `browser` export in `browser.ts`; MDA then gives the
+ * agent a LangSmith browser and Stagehand's tools, as `browser_run`,
+ * `browser_snapshot` and `browser_screenshot`.
+ *
+ * @example
+ * ```ts
+ * // browser.ts
+ * import { defineBrowser } from "managed-deepagents";
+ *
+ * export const browser = defineBrowser({ scope: "user" });
+ * ```
+ */
+const MIN_IDLE_TTL_S = 60;
+const MAX_IDLE_TTL_S = 86_400;
+/** Give the agent a LangSmith browser. */
+export function defineBrowser(options = {}) {
+    const { scope = "thread", idleTtlSeconds = 600 } = options;
+    if (scope !== "thread" && scope !== "user") {
+        throw new TypeError(`browser scope must be "thread" or "user", not ${JSON.stringify(scope)}`);
+    }
+    if (!Number.isInteger(idleTtlSeconds) ||
+        idleTtlSeconds < MIN_IDLE_TTL_S ||
+        idleTtlSeconds > MAX_IDLE_TTL_S) {
+        throw new TypeError(`idleTtlSeconds must be an integer between ${MIN_IDLE_TTL_S} and ${MAX_IDLE_TTL_S}`);
+    }
+    return Object.freeze({ kind: "browser", scope, idleTtlSeconds });
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,cAAc,GAAG,MAAM,CAAC;AAwB9B,0CAA0C;AAC1C,MAAM,UAAU,aAAa,CAAC,OAAO,GAAmB,EAAE;IACxD,MAAM,EAAE,KAAK,GAAG,QAAQ,EAAE,cAAc,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;IAC3D,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC3C,MAAM,IAAI,SAAS,CACjB,iDAAiD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;IACD,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC;QACjC,cAAc,GAAG,cAAc;QAC/B,cAAc,GAAG,cAAc,EAC/B,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,6CAA6C,cAAc,QAAQ,cAAc,EAAE,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/channels/actor.d.ts

@@ -0,0 +1,57 @@
+import type { ResolvePrincipalIdentity } from "../agent-auth.js";
+/**
+ * Who caused a channel event: the signed sender of a GitHub or Linear webhook,
+ * or the Slack user Trigger Server names on a delivery, which MDA checks
+ * against the delivery's signed principal. It is personal data: MDA neither
+ * logs it nor adds it to a run's metadata.
+ */
+interface ActorBase<P extends string> {
+    provider: P;
+    /** The provider's ID for them. */
+    id: string;
+}
+/** An actor whose provider may name them. */
+interface NamedActorBase<P extends string> extends ActorBase<P> {
+    /** Their name or handle, when the provider sends one. */
+    name?: string;
+    /** Their email, when the provider sends one. */
+    email?: string;
+}
+/**
+ * A Slack user, as Trigger Server read them from Slack's signed request.
+ * Trigger Server's delivery names no name or email. MDA checks `id` against
+ * the delivery's signed principal, but not a Slack Connect guest's `teamId`.
+ */
+export interface SlackActor extends ActorBase<"slack"> {
+    /**
+     * Their own Slack workspace (team). In a Slack Connect channel, someone
+     * from another organization keeps theirs rather than your app's.
+     */
+    teamId: string;
+}
+/** A GitHub account, as the signed webhook's `sender` names it; `name` is its login. */
+export interface GitHubActor extends NamedActorBase<"github"> {
+    type: "User" | "Bot" | "Organization";
+}
+/** A Linear user or app, as the signed webhook names it. */
+export interface LinearActor extends NamedActorBase<"linear"> {
+    /** Linear's kind of actor, such as `user`, when it sends one. */
+    type?: string;
+}
+/**
+ * Who caused an event, on any channel; switch on `provider`.
+ *
+ * @experimental This may change in a minor release.
+ */
+export type ChannelActor = SlackActor | GitHubActor | LinearActor;
+/**
+ * The Agent Auth identity a webhook channel's sender runs as when no
+ * `resolveUser` maps them: a GitHub user by their numeric ID, a Linear user by
+ * theirs. Both IDs are unique across their provider, so the provider's host is
+ * the issuer. Bots, apps and organizations have none and run as the channel.
+ * A Slack sender has none here: Trigger Server already resolved
+ * `(slack, install team, user)` for the delivery.
+ */
+export declare function actorIdentity(actor: ChannelActor): ResolvePrincipalIdentity | undefined;
+export {};
+//# sourceMappingURL=actor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../../src/channels/actor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;;;GAKG;AACH,UAAU,SAAS,CAAC,CAAC,SAAS,MAAM;IAClC,QAAQ,EAAE,CAAC,CAAC;IACZ,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,6CAA6C;AAC7C,UAAU,cAAc,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAC7D,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAW,SAAQ,SAAS,CAAC,OAAO,CAAC;IACpD;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wFAAwF;AACxF,MAAM,WAAW,WAAY,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAC3D,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,cAAc,CAAC;CACvC;AAED,4DAA4D;AAC5D,MAAM,WAAW,WAAY,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAC3D,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAElE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,GAClB,wBAAwB,GAAG,SAAS,CActC"}

package/dist/channels/actor.js

@@ -0,0 +1,24 @@
+/**
+ * The Agent Auth identity a webhook channel's sender runs as when no
+ * `resolveUser` maps them: a GitHub user by their numeric ID, a Linear user by
+ * theirs. Both IDs are unique across their provider, so the provider's host is
+ * the issuer. Bots, apps and organizations have none and run as the channel.
+ * A Slack sender has none here: Trigger Server already resolved
+ * `(slack, install team, user)` for the delivery.
+ */
+export function actorIdentity(actor) {
+    switch (actor.provider) {
+        case "github":
+            return actor.type === "User"
+                ? { provider: "github", issuer: "github.com", subject: actor.id }
+                : undefined;
+        case "linear":
+            // A session's creator or prompting user comes without a type.
+            return actor.type === undefined || actor.type.toLowerCase() === "user"
+                ? { provider: "linear", issuer: "linear.app", subject: actor.id }
+                : undefined;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=actor.js.map

package/dist/channels/actor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.js","sourceRoot":"","sources":["../../src/channels/actor.ts"],"names":[],"mappings":"AAqDA;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAmB;IAEnB,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM;gBAC1B,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE;gBACjE,CAAC,CAAC,SAAS,CAAC;QAChB,KAAK,QAAQ;YACX,8DAA8D;YAC9D,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM;gBACpE,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE;gBACjE,CAAC,CAAC,SAAS,CAAC;QAChB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/channels/assistant-text.d.ts

@@ -8,4 +8,33 @@ export declare function extractAssistantText(input: {
 export declare function extractAssistantContent(input: {
     messages?: unknown;
 }): MessageContent | null;
+/** A reply that means "nothing to tell the channel". */
+export declare const QUIET_REPLY = "[quiet]";
+/** Where a run's messages start in a thread's messages. */
+export interface ReplyBoundary {
+    /**
+     * The thread's last message before the run. Without it the run starts at
+     * the last user message.
+     */
+    afterId?: string;
+}
+/**
+ * What a run says to the channel: each of its answers, oldest first, without
+ * `[quiet]` ones. A run with a known start never repeats an earlier run's
+ * answer.
+ */
+export declare function extractReplyText(input: {
+    messages?: unknown;
+}, boundary?: ReplyBoundary): string;
+/** {@link extractReplyText} as content; several answers are joined as text. */
+export declare function extractReplyContent(input: {
+    messages?: unknown;
+}, boundary?: ReplyBoundary): MessageContent | null;
+/** `additional_kwargs` key deepagents marks a task notification with. */
+export declare const NOTIFICATION_KEY = "deepagents_notification";
+/**
+ * `additional_kwargs` key MDA marks its own notifications with, such as a browser
+ * handoff ending, the same way.
+ */
+export declare const MDA_NOTIFICATION_KEY = "mda_notification";
 //# sourceMappingURL=assistant-text.d.ts.map

package/dist/channels/assistant-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-text.d.ts","sourceRoot":"","sources":["../../src/channels/assistant-text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAM1E;AAsBD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,cAAc,GAAG,IAAI,CAaxB"}
+{"version":3,"file":"assistant-text.d.ts","sourceRoot":"","sources":["../../src/channels/assistant-text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAM1E;AA2BD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,cAAc,GAAG,IAAI,CAiBxB;AAED,wDAAwD;AACxD,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAC7B,QAAQ,GAAE,aAAkB,GAC3B,MAAM,CAQR;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAC7B,QAAQ,GAAE,aAAkB,GAC3B,cAAc,GAAG,IAAI,CAOvB;AAsCD,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAC1D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,qBAAqB,CAAC"}

package/dist/channels/assistant-text.js

@@ -2,7 +2,7 @@
  * Extract the latest usable assistant output from a run or agent state.
  */
 import { coerceMessageLikeToMessage, } from "@langchain/core/messages";
-import { BaseMessage } from "langchain";
+import { AIMessage, BaseMessage } from "langchain";
 export function extractAssistantText(input) {
     for (const message of assistantMessages(input)) {
         const text = message.text.trim();
@@ -30,6 +30,10 @@ function asBaseMessage(message) {
         return undefined;
     }
 }
+/** Content block types that make a reply on their own, without text. */
+const MEDIA_BLOCKS = new Set(["image", "image_url", "file", "audio", "video"]);
+/** Content block types a channel can show; others, such as reasoning, stay in the thread. */
+const SHOWN_BLOCKS = new Set([...MEDIA_BLOCKS, "text"]);
 export function extractAssistantContent(input) {
     for (const message of assistantMessages(input)) {
         const content = message.content;
@@ -38,10 +42,83 @@ export function extractAssistantContent(input) {
                 return content;
             continue;
         }
-        if (content.length === 0)
-            continue;
-        return content.map((block) => typeof block === "string" ? { type: "text", text: block } : block);
+        const shown = content.flatMap((block) => typeof block === "string"
+            ? [{ type: "text", text: block }]
+            : SHOWN_BLOCKS.has(block.type)
+                ? [block]
+                : []);
+        if (shown.length > 0)
+            return shown;
     }
     return null;
 }
+/** A reply that means "nothing to tell the channel". */
+export const QUIET_REPLY = "[quiet]";
+/**
+ * What a run says to the channel: each of its answers, oldest first, without
+ * `[quiet]` ones. A run with a known start never repeats an earlier run's
+ * answer.
+ */
+export function extractReplyText(input, boundary = {}) {
+    const answers = runAnswers(input, boundary.afterId);
+    if (boundary.afterId === undefined && answers.length <= 1)
+        return extractAssistantText(input);
+    return answers
+        .map((answer) => answer.text.trim())
+        .filter((text) => text && text !== QUIET_REPLY)
+        .join("\n\n");
+}
+/** {@link extractReplyText} as content; several answers are joined as text. */
+export function extractReplyContent(input, boundary = {}) {
+    const answers = runAnswers(input, boundary.afterId);
+    if (answers.length > 1)
+        return extractReplyText(input, boundary) || null;
+    if (boundary.afterId === undefined)
+        return extractAssistantContent(input);
+    const [answer] = answers;
+    if (!answer || answer.text.trim() === QUIET_REPLY)
+        return null;
+    return extractAssistantContent({ messages: [answer] });
+}
+/** The run's answers: assistant messages with text or media and no tool calls. */
+function runAnswers(input, afterId) {
+    const messages = (Array.isArray(input.messages) ? input.messages : [])
+        .map(asBaseMessage)
+        .filter((message) => message !== undefined);
+    return messages
+        .slice(runStart(messages, afterId))
+        .filter((message) => AIMessage.isInstance(message) &&
+        !message.tool_calls?.length &&
+        (message.text.trim() || hasMedia(message)));
+}
+/** Index of the run's first message; past the end when it can't be found. */
+function runStart(messages, afterId) {
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (afterId !== undefined && message.id === afterId)
+            return index + 1;
+        if (afterId === undefined &&
+            message.type === "human" &&
+            !isTaskNotification(message))
+            return index;
+    }
+    return messages.length;
+}
+/** `additional_kwargs` key deepagents marks a task notification with. */
+export const NOTIFICATION_KEY = "deepagents_notification";
+/**
+ * `additional_kwargs` key MDA marks its own notifications with, such as a browser
+ * handoff ending, the same way.
+ */
+export const MDA_NOTIFICATION_KEY = "mda_notification";
+/** A user-role message deepagents or MDA sent with news, not the user's. */
+function isTaskNotification(message) {
+    const extra = message.additional_kwargs ?? {};
+    return (Object.hasOwn(extra, NOTIFICATION_KEY) ||
+        Object.hasOwn(extra, MDA_NOTIFICATION_KEY));
+}
+function hasMedia(message) {
+    return (Array.isArray(message.content) &&
+        message.content.some((block) => typeof block === "object" && MEDIA_BLOCKS.has(block.type)));
+}
 //# sourceMappingURL=assistant-text.js.map

package/dist/channels/assistant-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-text.js","sourceRoot":"","sources":["../../src/channels/assistant-text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,0BAA0B,GAG3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,UAAU,oBAAoB,CAAC,KAA6B;IAChE,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,iFAAiF;AACjF,QAAQ,CAAC,CAAC,iBAAiB,CAAC,KAE3B;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,OAAO,EAAE,IAAI,KAAK,IAAI;YAAE,MAAM,OAAO,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAgB;IACrC,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,0BAA0B,CAAC,OAA0B,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAEvC;IACC,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,IAAI,OAAO,CAAC,IAAI,EAAE;gBAAE,OAAO,OAAO,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3B,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAClE,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"assistant-text.js","sourceRoot":"","sources":["../../src/channels/assistant-text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,0BAA0B,GAG3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,UAAU,oBAAoB,CAAC,KAA6B;IAChE,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,iFAAiF;AACjF,QAAQ,CAAC,CAAC,iBAAiB,CAAC,KAE3B;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,OAAO,EAAE,IAAI,KAAK,IAAI;YAAE,MAAM,OAAO,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAgB;IACrC,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,0BAA0B,CAAC,OAA0B,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC/E,6FAA6F;AAC7F,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;AAExD,MAAM,UAAU,uBAAuB,CAAC,KAEvC;IACC,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,IAAI,OAAO,CAAC,IAAI,EAAE;gBAAE,OAAO,OAAO,CAAC;YACnC,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACtC,OAAO,KAAK,KAAK,QAAQ;YACvB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACjC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC5B,CAAC,CAAC,CAAC,KAAK,CAAC;gBACT,CAAC,CAAC,EAAE,CACT,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAWrC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA6B,EAC7B,QAAQ,GAAkB,EAAE;IAE5B,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;QACvD,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACnC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI,KAAK,WAAW,CAAC;SAC9C,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CACjC,KAA6B,EAC7B,QAAQ,GAAkB,EAAE;IAE5B,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC;IACzE,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;IACzB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO,uBAAuB,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,kFAAkF;AAClF,SAAS,UAAU,CACjB,KAA6B,EAC7B,OAA2B;IAE3B,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,GAAG,CAAC,aAAa,CAAC;SAClB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;IAC9C,OAAO,QAAQ;SACZ,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;SAClC,MAAM,CACL,CAAC,OAAO,EAAE,EAAE,CACV,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC;QAC7B,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM;QAC3B,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAC7C,CAAC;AACN,CAAC;AAED,6EAA6E;AAC7E,SAAS,QAAQ,CACf,QAAuB,EACvB,OAA2B;IAE3B,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO;YAAE,OAAO,KAAK,GAAG,CAAC,CAAC;QACtE,IACE,OAAO,KAAK,SAAS;YACrB,OAAO,CAAC,IAAI,KAAK,OAAO;YACxB,CAAC,kBAAkB,CAAC,OAAO,CAAC;YAE5B,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC;AACzB,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAC1D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD,4EAA4E;AAC5E,SAAS,kBAAkB,CAAC,OAAoB;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAC9C,OAAO,CACL,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,OAAoB;IACpC,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QAC9B,OAAO,CAAC,OAAO,CAAC,IAAI,CAClB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CACrE,CACF,CAAC;AACJ,CAAC"}

package/dist/channels/binding.d.ts

@@ -1,21 +1,40 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 import type { ChannelMessagingAdapter } from "./runtime.js";
-import type { ChannelInfo, RuntimeChannel } from "./types.js";
+import type { ChannelEvent, ChannelInfo, JsonValue, RuntimeChannel } from "./types.js";
 import { type ChannelContext } from "../run-context.js";
+import { type OriginBinding, type StoredOrigin } from "../runtime/thread-record.js";
+import type { RunThread } from "../runtime/managed-thread.js";
 export declare const SLACK_BOT_TOKEN_ENV = "SLACK_BOT_TOKEN";
 /** The serializable channel data sent by managed ingress. */
 export type ChannelBinding = ChannelContext;
+/**
+ * The binding whose message event holds a run's own input, in place of the
+ * delivery's messages, such as a handler's.
+ */
+export declare function bindingWithMessages(binding: ChannelBinding, messages: readonly Readonly<Record<string, JsonValue>>[]): ChannelBinding;
 export declare const currentChannelBinding: AsyncLocalStorage<{
     binding?: ChannelBinding;
     channelRun: boolean;
     /** Cron routing split out of a managed run's context, and what remains. */
     routing?: Record<string, unknown>;
     context?: unknown;
+    /** The run's thread, built once when the run starts. */
+    thread?: RunThread;
 }>;
 /** Validate delivery context against the authenticated source and declared channel. */
 export declare function resolveChannelBinding(context: unknown, configurable: Record<string, unknown> | undefined): ChannelBinding | undefined;
+/**
+ * The binding a thread record's origin names, when this deployment declares
+ * its channel. The record is trusted as it is: the auth handler lets only
+ * managed ingress write one.
+ */
+export declare function resolveOriginBinding(origin: StoredOrigin): OriginBinding | undefined;
 export declare function resolveChannelInfo(context: unknown, configurable: Record<string, unknown> | undefined): ChannelInfo | undefined;
 export declare function resolveRuntimeChannel(context: unknown, configurable: Record<string, unknown> | undefined, transportFactory?: (provider: string) => ChannelMessagingAdapter | undefined): RuntimeChannel | undefined;
+/** A runtime channel that posts to a binding's target. */
+export declare function runtimeChannelFor(binding: OriginBinding & {
+    rawEvent?: JsonValue;
+}, event: ChannelEvent | null, transportFactory?: (provider: string) => ChannelMessagingAdapter | undefined): RuntimeChannel;
 /** Trusted ingress source for telemetry; direct HTTP callers have no channel stamp. */
 export declare function resolveChannelProvider(configurable: Record<string, unknown> | undefined): string | 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":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAO5D,OAAO,KAAK,EAAE,WAAW,EAAa,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE9E,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC;AAE5C,eAAO,MAAM,qBAAqB;cACtB,cAAc;gBACZ,OAAO;IACnB,2EAA2E;cACjE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cACvB,OAAO;EACf,CAAC;AAiBL,uFAAuF;AACvF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAChD,cAAc,GAAG,SAAS,CAwB5B;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAChD,WAAW,GAAG,SAAS,CAGzB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACjD,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,uBAAuB,GAAG,SAAS,GAC3E,cAAc,GAAG,SAAS,CAa5B;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAChD,MAAM,GAAG,SAAS,CAYpB"}
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/channels/binding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,cAAc,CAAC;AAQtB,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,GACvD,cAAc,CAWhB;AAED,eAAO,MAAM,qBAAqB;cACtB,cAAc;gBACZ,OAAO;IACnB,2EAA2E;cACjE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cACvB,OAAO;IACjB,wDAAwD;aAC/C,SAAS;EAChB,CAAC;AAiBL,uFAAuF;AACvF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAChD,cAAc,GAAG,SAAS,CAe5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,GACnB,aAAa,GAAG,SAAS,CAG3B;AAYD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAChD,WAAW,GAAG,SAAS,CAGzB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACjD,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,uBAAuB,GAAG,SAAS,GAC3E,cAAc,GAAG,SAAS,CAI5B;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,EACjD,KAAK,EAAE,YAAY,GAAG,IAAI,EAC1B,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,uBAAuB,GAAG,SAAS,GAC3E,cAAc,CAgBhB;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAChD,MAAM,GAAG,SAAS,CAYpB"}

package/dist/channels/binding.js

@@ -5,9 +5,24 @@ import { channelInfo, createRuntimeChannel } from "./runtime.js";
 import { isJsonValue } from "./message-schema.js";
 import { channelProviderForName, messagingTransportForName, } from "./messaging-registry.js";
 import { createTriggerClient } from "./trigger/client.js";
+import { startTriggerConversation } from "./trigger/conversation.js";
 import { createTriggerTransport } from "./trigger/transport.js";
 import { channelContextSchema } from "../run-context.js";
+import { bindingFromOrigin, } from "../runtime/thread-record.js";
 export const SLACK_BOT_TOKEN_ENV = "SLACK_BOT_TOKEN";
+/**
+ * The binding whose message event holds a run's own input, in place of the
+ * delivery's messages, such as a handler's.
+ */
+export function bindingWithMessages(binding, messages) {
+    return {
+        ...binding,
+        event: {
+            type: "message",
+            messages: messages,
+        },
+    };
+}
 export const currentChannelBinding = new AsyncLocalStorage();
 function record(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -30,16 +45,27 @@ export function resolveChannelBinding(context, configurable) {
     const user = configurable?.langgraph_auth_user;
     if (!record(user) ||
         user.mda_source_provider !== binding.provider ||
-        user.mda_source_thread_id !== binding.sourceThreadKey ||
-        channelProviderForName(binding.name) !== binding.provider)
+        user.mda_source_thread_id !== binding.sourceThreadKey)
         return undefined;
-    if (binding.transport === "trigger_server") {
-        const target = triggerTargetSchema.safeParse(binding.target);
-        if (!target.success ||
-            target.data.source_thread_key !== binding.sourceThreadKey)
-            return undefined;
-    }
-    return binding;
+    return isDeclaredBinding(binding) ? binding : undefined;
+}
+/**
+ * The binding a thread record's origin names, when this deployment declares
+ * its channel. The record is trusted as it is: the auth handler lets only
+ * managed ingress write one.
+ */
+export function resolveOriginBinding(origin) {
+    const binding = bindingFromOrigin(origin);
+    return binding && isDeclaredBinding(binding) ? binding : undefined;
+}
+/** Whether a declared channel of the binding's provider can reach its target. */
+function isDeclaredBinding(binding) {
+    if (channelProviderForName(binding.name) !== binding.provider)
+        return false;
+    if (binding.transport !== "trigger_server")
+        return true;
+    const target = triggerTargetSchema.safeParse(binding.target);
+    return (target.success && target.data.source_thread_key === binding.sourceThreadKey);
 }
 export function resolveChannelInfo(context, configurable) {
     const binding = resolveChannelBinding(context, configurable);
@@ -49,18 +75,25 @@ export function resolveRuntimeChannel(context, configurable, transportFactory) {
     const binding = resolveChannelBinding(context, configurable);
     if (!binding)
         return undefined;
+    return runtimeChannelFor(binding, binding.event, transportFactory);
+}
+/** A runtime channel that posts to a binding's target. */
+export function runtimeChannelFor(binding, event, transportFactory) {
     let transport;
+    let startThread;
     if (binding.transport === "trigger_server") {
         const client = createTriggerClient();
-        if (client)
+        if (client) {
             transport = createTriggerTransport(client);
+            startThread = (message, run) => startTriggerConversation(client, binding, message, run);
+        }
     }
     else {
         transport =
             messagingTransportForName(binding.name) ??
                 transportFactory?.(binding.provider);
     }
-    return createRuntimeChannel({ ...binding, transport });
+    return createRuntimeChannel({ ...binding, event, transport, startThread });
 }
 /** Trusted ingress source for telemetry; direct HTTP callers have no channel stamp. */
 export function resolveChannelProvider(configurable) {

package/dist/channels/binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/channels/binding.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/channels/binding.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKlD,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAQhE,OAAO,EAAE,oBAAoB,EAAuB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EACL,iBAAiB,GAGlB,MAAM,6BAA6B,CAAC;AAGrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAIrD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAuB,EACvB,QAAwD;IAExD,OAAO;QACL,GAAG,OAAO;QACV,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,QAGG;SACd;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,iBAAiB,EAQtD,CAAC;AAEL,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC7E,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAC/B,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,EAC9C,uBAAuB,CACxB,CAAC;AACF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,UAAU,EAAE,cAAc;IAC1B,OAAO,EAAE,gBAAgB;IACzB,iBAAiB,EAAE,cAAc;CAClC,CAAC,CAAC;AAEH,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CACnC,OAAgB,EAChB,YAAiD;IAEjD,MAAM,GAAG,GACP,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QACnD,qBAAqB,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC;IAC5C,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,YAAY,EAAE,mBAAmB,CAAC;IAC/C,IACE,CAAC,MAAM,CAAC,IAAI,CAAC;QACb,IAAI,CAAC,mBAAmB,KAAK,OAAO,CAAC,QAAQ;QAC7C,IAAI,CAAC,oBAAoB,KAAK,OAAO,CAAC,eAAe;QAErD,OAAO,SAAS,CAAC;IACnB,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAoB;IAEpB,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED,iFAAiF;AACjF,SAAS,iBAAiB,CAAC,OAAsB;IAC/C,IAAI,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,OAAO,CAAC,SAAS,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAC;IACxD,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,OAAO,CACL,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,iBAAiB,KAAK,OAAO,CAAC,eAAe,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAgB,EAChB,YAAiD;IAEjD,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC7D,OAAO,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAgB,EAChB,YAAiD,EACjD,gBAA4E;IAE5E,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC7D,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;AACrE,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAC/B,OAAiD,EACjD,KAA0B,EAC1B,gBAA4E;IAE5E,IAAI,SAA8C,CAAC;IACnD,IAAI,WAAuD,CAAC;IAC5D,IAAI,OAAO,CAAC,SAAS,KAAK,gBAAgB,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,SAAS,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;YAC3C,WAAW,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAC7B,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,SAAS;YACP,yBAAyB,CAAC,OAAO,CAAC,IAAI,CAAC;gBACvC,gBAAgB,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,oBAAoB,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,sBAAsB,CACpC,YAAiD;IAEjD,MAAM,IAAI,GAAG,YAAY,EAAE,mBAAmB,CAAC;IAC/C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAI,IAA0C;SACzD,mBAAmB,CAAC;IACvB,OAAO,QAAQ,KAAK,SAAS;QAC3B,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,OAAO,QAAQ,KAAK,QAAQ;YAC5B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,SAAS,CAAC;AAClB,CAAC"}

package/dist/channels/delivery.d.ts

@@ -0,0 +1,51 @@
+import type { CompiledStateGraph } from "@langchain/langgraph";
+import type { RunThread } from "../runtime/managed-thread.js";
+type Graph = Pick<CompiledStateGraph<unknown, unknown>, "getState" | "getStateHistory">;
+/** What a new Trigger thread posted when a scheduled run pauses says. */
+export declare const PAUSED_NOTICE = "This scheduled run is waiting for a decision.";
+/** What a scheduled run that fails posts where Trigger cannot show the failure. */
+export declare const FAILED_NOTICE = "This scheduled run failed.";
+/** What a new Trigger thread posted when a scheduled run fails says; Trigger replies in it. */
+export declare const FAILED_THREAD_NOTICE = "This scheduled run failed. Details in this thread \u2B07\uFE0F";
+/** The run a delivery step belongs to. */
+export interface DeliveredRun {
+    /** The Agent Server run, for idempotent posts, notices and their links. */
+    runId?: string;
+    assistantId?: string;
+    /** The run's configurable, with the principal the server stamped. */
+    configurable?: Record<string, unknown>;
+    /** The run's metadata, which marks a managed cron fire. */
+    metadata?: unknown;
+    /** Cron routing split out of the run's context. */
+    routing?: Record<string, unknown>;
+    /** The run's own thread; an async subagent's differs from `run.thread`'s. */
+    runThreadId?: string;
+    /** An async subagent's run: report its pause, never post its answer. */
+    subagent?: boolean;
+}
+/**
+ * Deliver a finished top-level run's result to its thread's origin, or to a
+ * scheduled run's `deliverTo`. A thread with neither gets nothing. The Agent
+ * Server runs every TypeScript graph run on a thread with a checkpointer, a
+ * cron fire without a `thread_id` included, so its state can always be read.
+ *
+ * Failures follow what each channel did before: a Trigger post and any
+ * scheduled delivery fail the run; a direct channel's post is logged and the
+ * run still succeeds.
+ */
+export declare function deliverRunResult(graph: Graph, run: RunThread, delivered?: DeliveredRun): Promise<void>;
+/**
+ * Report a scheduled run that threw where its result would have gone. A
+ * Trigger thread gets `run.failed`, so Trigger shows the failure there; a
+ * new-thread schedule opens its thread with a notice, as does `deliverTo`.
+ * Only trusted cron fires report here: Trigger ingress reports the runs it
+ * started. Only a known-safe message leaves the run, and reporting never
+ * replaces its error.
+ */
+export declare function deliverRunFailure(run: RunThread, delivered: DeliveredRun, error: unknown): Promise<void>;
+/** The Trigger post id of a failed run's notice, stable across retries. */
+export declare function failedActionId(runId: string): string;
+/** The Trigger post id for a run's answer, stable across retries. */
+export declare function replyActionId(runId: string): string;
+export {};
+//# sourceMappingURL=delivery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/channels/delivery.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,kBAAkB,EAAiB,MAAM,sBAAsB,CAAC;AAI9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AA6C9D,KAAK,KAAK,GAAG,IAAI,CACf,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,EACpC,UAAU,GAAG,iBAAiB,CAC/B,CAAC;AAGF,yEAAyE;AACzE,eAAO,MAAM,aAAa,kDAAkD,CAAC;AAC7E,mFAAmF;AACnF,eAAO,MAAM,aAAa,+BAA+B,CAAC;AAC1D,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB,mEACuB,CAAC;AAEzD,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAOD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,SAAS,EACd,SAAS,GAAE,YAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAsCf;AAuLD,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD"}