managed-deepagents 0.9.6-dev.3 → 0.9.6-dev.30

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

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/studio.d.ts

@@ -0,0 +1,24 @@
+import type { HttpDelivery, HttpFinish } from "./types.js";
+/**
+ * The thread in the deployment's Studio, or the deployment's page when the
+ * deployment's name or the thread's assistant is unknown. The LangSmith UI is
+ * the one `mda deploy` recorded for the deployment's environment
+ * (`MDA_LANGSMITH_URL`); without it there is nothing to link to.
+ */
+export declare function studioUrl(run: HttpDelivery | undefined, env?: NodeJS.ProcessEnv): string | undefined;
+/**
+ * `waiting` when a finished delivery's message found the thread waiting on a
+ * decision. A run that stopped on interrupts posts its own `interrupted`
+ * notice as it ends (the paused notice), so a `run` delivery has none here.
+ * Undefined when nothing waits, or the delivery was a cancel or lost.
+ */
+export declare function pendingDecision(finish: HttpFinish): "waiting" | undefined;
+/**
+ * What a channel tells the conversation when its thread waits on a decision,
+ * with a link to the thread in Studio, where the decision is made: the run
+ * the delivery started stopped on interrupts (`interrupted`), or the message
+ * found the thread waiting (`waiting`). `again` says how to continue once it
+ * is made, such as "comment again".
+ */
+export declare function interruptedNotice(outcome: "interrupted" | "waiting", delivery: HttpDelivery, again: string): string;
+//# sourceMappingURL=studio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../../src/channels/http/studio.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAS3D;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,YAAY,GAAG,SAAS,EAC7B,GAAG,oBAAc,GAChB,MAAM,GAAG,SAAS,CAsBpB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,GACZ,MAAM,CAMR"}

package/dist/channels/http/studio.js

@@ -0,0 +1,95 @@
+/** Links from channel notices into the deployment's LangSmith Studio. */
+import { v5 as uuidv5 } from "uuid";
+import { DEPLOYMENT_ID_ENV } from "../../connections.js";
+import { managedDeploymentName } from "../../runtime/sandbox-manager.js";
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const DEPLOYMENT_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+const GRAPH_ID_PATTERN = /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$/;
+/** The namespace the Agent Server derives a graph's default assistant from. */
+const GRAPH_NAMESPACE = "6ba7b821-9dad-11d1-80b4-00c04fd430c8";
+/**
+ * The thread in the deployment's Studio, or the deployment's page when the
+ * deployment's name or the thread's assistant is unknown. The LangSmith UI is
+ * the one `mda deploy` recorded for the deployment's environment
+ * (`MDA_LANGSMITH_URL`); without it there is nothing to link to.
+ */
+export function studioUrl(run, env = process.env) {
+    const threadId = run?.threadId;
+    const thread = threadId && UUID_PATTERN.test(threadId) ? threadId : undefined;
+    const workspace = env.LANGSMITH_TENANT_ID?.trim() ?? "";
+    const deployment = env[DEPLOYMENT_ID_ENV]?.trim() ?? "";
+    if (!UUID_PATTERN.test(workspace) || !UUID_PATTERN.test(deployment))
+        return undefined;
+    const origin = parseHttpUrl(env.MDA_LANGSMITH_URL)?.origin;
+    if (!origin)
+        return undefined;
+    const name = managedDeploymentName(env);
+    const assistantId = assistantUuid(run?.assistantId);
+    if (!name || !DEPLOYMENT_NAME_PATTERN.test(name) || !thread || !assistantId)
+        return `${origin}/o/${workspace}/host/deployments/${deployment}`;
+    const query = new URLSearchParams({
+        organizationId: workspace,
+        render: "interact",
+        hostProjectId: deployment,
+        assistantId,
+        mode: "chat",
+        threadId: thread,
+    });
+    return `${origin}/o/${workspace}/a/${encodeURIComponent(name)}/studio/thread?${query}`;
+}
+/**
+ * `waiting` when a finished delivery's message found the thread waiting on a
+ * decision. A run that stopped on interrupts posts its own `interrupted`
+ * notice as it ends (the paused notice), so a `run` delivery has none here.
+ * Undefined when nothing waits, or the delivery was a cancel or lost.
+ */
+export function pendingDecision(finish) {
+    if (!finish.interrupts.length)
+        return undefined;
+    return finish.type === "skipped" && finish.reason === "waiting"
+        ? "waiting"
+        : undefined;
+}
+/**
+ * What a channel tells the conversation when its thread waits on a decision,
+ * with a link to the thread in Studio, where the decision is made: the run
+ * the delivery started stopped on interrupts (`interrupted`), or the message
+ * found the thread waiting (`waiting`). `again` says how to continue once it
+ * is made, such as "comment again".
+ */
+export function interruptedNotice(outcome, delivery, again) {
+    const url = studioUrl(delivery);
+    const studio = url ? `[LangSmith Studio](${url})` : "LangSmith Studio";
+    return outcome === "interrupted"
+        ? `I need a decision before I continue. Review the pending step in ${studio}.`
+        : `I'm waiting for a decision on an earlier step in this conversation, so I haven't read this yet. Review the pending step in ${studio}, then ${again}.`;
+}
+/**
+ * Studio opens an assistant by its ID. Channels start runs by graph ID, whose
+ * default assistant the Agent Server derives from it.
+ */
+function assistantUuid(assistant) {
+    if (!assistant)
+        return undefined;
+    if (UUID_PATTERN.test(assistant))
+        return assistant;
+    return GRAPH_ID_PATTERN.test(assistant)
+        ? uuidv5(assistant, GRAPH_NAMESPACE)
+        : undefined;
+}
+function parseHttpUrl(value) {
+    if (!value?.trim())
+        return undefined;
+    try {
+        const url = new URL(value.trim());
+        return (url.protocol === "https:" || url.protocol === "http:") &&
+            !url.username &&
+            !url.password
+            ? url
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=studio.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * The thread for one provider conversation, such as an issue or a chat: the
+ * same channel and key always give the same UUID, so each message continues
+ * the conversation. The Python runtime derives the same IDs.
+ */
+export declare function channelThreadId(channelName: string, key: string): string;
+//# sourceMappingURL=threads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/channels/http/threads.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKxE"}

package/dist/channels/http/threads.js

@@ -0,0 +1,10 @@
+import { v5 as uuidv5 } from "uuid";
+/**
+ * The thread for one provider conversation, such as an issue or a chat: the
+ * same channel and key always give the same UUID, so each message continues
+ * the conversation. The Python runtime derives the same IDs.
+ */
+export function channelThreadId(channelName, key) {
+    return uuidv5(`mda-thread:v1:${JSON.stringify([channelName, key])}`, uuidv5.URL);
+}
+//# sourceMappingURL=threads.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../../src/channels/http/threads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,GAAW;IAC9D,OAAO,MAAM,CACX,iBAAiB,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,EACrD,MAAM,CAAC,GAAG,CACX,CAAC;AACJ,CAAC"}

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

@@ -1,21 +1,70 @@
+import type { Interrupt } from "@langchain/langgraph-sdk";
+import type { MultitaskStrategy } from "../../ingress/runs.js";
 import type { MessageContent } from "@langchain/core/messages";
-import type { ChannelMessage, JsonValue } from "../types.js";
+import type { ChannelMessage, ChannelReply, JsonValue } from "../types.js";
+import type { ChannelRunResult } from "../run-input.js";
+import type { ChannelActor } from "../actor.js";
 export interface HttpChannelInboundMessage {
     userId: string;
+    /** See {@link channelThreadId} for one thread per provider conversation. */
     threadId: string;
     /** Provider destination, independent of the LangGraph thread UUID. */
     target: JsonValue;
-    content: MessageContent;
+    /**
+     * What a new run starts with. Without it, the adapter's `input` supplies it
+     * once MDA knows the thread takes a new turn.
+     */
+    content?: MessageContent;
+    /**
+     * The provider's ID for this delivery. A thread runs each delivery once, so
+     * a redelivered event starts nothing.
+     *
+     * @experimental This may change in a minor release.
+     */
+    deliveryKey?: string;
+    /**
+     * Answer the provider before the adapter's `input` decides what the run
+     * starts with, and start it in the background: for input that may take
+     * longer than the provider waits, such as an event endpoint's. A failure
+     * then can't fail the delivery, so the provider doesn't redeliver it.
+     *
+     * @experimental This may change in a minor release.
+     */
+    background?: boolean;
+}
+/**
+ * The thread a `cancel` result stops, and who to tell.
+ *
+ * @experimental This may change in a minor release.
+ */
+export interface HttpChannelCancelMessage {
+    userId: string;
+    threadId: string;
+    /** Where to report the stop. */
+    target: JsonValue;
 }
 export type HttpChannelParseResult = {
     type: "message";
     message: HttpChannelInboundMessage;
     /** Optional provider data exposed as runtime.channel.rawEvent. */
     rawEvent?: JsonValue;
+    /** The verified sender, which `resolveUser` maps to one of your users. */
+    actor?: ChannelActor;
     response?: Response;
 } | {
     type: "ignore";
     response?: Response;
+} | {
+    /**
+     * Stop the work on the message's thread: MDA cancels its queued and
+     * running runs, keeping their progress, then calls `onFinish`.
+     *
+     * @experimental This may change in a minor release.
+     */
+    type: "cancel";
+    message: HttpChannelCancelMessage;
+    rawEvent?: JsonValue;
+    response?: Response;
 };
 /** MDA adds the verified reply target to the validated message. */
 export type HttpChannelPostInput = ChannelMessage & {
@@ -29,11 +78,126 @@ export interface HttpPostedMessage {
 }
 export interface HttpChannelAdapter {
     provider: string;
+    providerConfig?: Record<string, JsonValue>;
+    /**
+     * What a message that starts a turn does while its thread already runs:
+     * `enqueue` (the default) waits for the run and starts after it,
+     * `interrupt` cancels the run, keeping its progress, and starts at once,
+     * `rollback` cancels it and discards its progress, and `reject` starts
+     * nothing. Messages to a thread that waits on an interrupt start nothing
+     * either way.
+     *
+     * @experimental This may change in a minor release.
+     */
+    multitaskStrategy?: MultitaskStrategy;
+    /**
+     * Whether the channel posts the run's final answer with `post`: `auto`
+     * (the default) or `none`, to leave replying to the agent; see
+     * {@link ChannelReply}.
+     *
+     * @experimental This may change in a minor release.
+     */
+    reply?: ChannelReply;
     verify(context: HttpChannelRequest): boolean | Promise<boolean>;
     /** Decode the verified request body in the provider's format. */
     parse(context: HttpChannelRequest): HttpChannelParseResult | Promise<HttpChannelParseResult>;
     post?(input: HttpChannelPostInput): Promise<HttpPostedMessage>;
+    /**
+     * The run a message started failed: tell the sender instead of the default
+     * apology `post` sends. Called before `onFinish`.
+     */
     onError?(error: unknown, target: JsonValue): Promise<void>;
+    /**
+     * What a message without `content` starts a run with, asked only once the
+     * thread takes a new turn, never while it waits on an interrupt. `null` or
+     * `undefined` starts nothing.
+     *
+     * @experimental This may change in a minor release.
+     */
+    input?(message: HttpChannelInboundMessage, rawEvent: JsonValue | undefined): ChannelRunResult | null | undefined | Promise<ChannelRunResult | null | undefined>;
+    /**
+     * A verified message reached its thread, before MDA starts or queues
+     * anything for it. For providers that expect a prompt acknowledgement.
+     * Each message that gets it later gets `onFinish`. Runs in the
+     * background; failures are logged.
+     *
+     * @experimental This may change in a minor release.
+     */
+    onReceived?(target: JsonValue, delivery: HttpDelivery): Promise<void>;
+    /**
+     * A message is done, once, with how: the run it started ended (`run`), it
+     * started none and why (`skipped`), or MDA couldn't start the run or lost
+     * track of it (`failed`); see {@link HttpFinish}. `interrupts` are what the
+     * thread waits on now, non-empty while a decision is pending, made in
+     * Studio. Called after `onReceived` and `onError`, in the background;
+     * failures are logged.
+     *
+     * It runs in the process that took the delivery, so a restart loses it,
+     * and a run Studio resumes has no delivery. Keep a reconciliation, or set
+     * the run's `webhook`, for anything that must not miss a run.
+     *
+     * @experimental This may change in a minor release.
+     */
+    onFinish?(target: JsonValue, delivery: HttpFinishedDelivery): Promise<void>;
+}
+/** A delivery's thread, for notices and links into LangSmith Studio. */
+export interface HttpDelivery {
+    threadId: string;
+    /** The assistant that runs on the thread, when known. */
+    assistantId?: string;
+    /** The provider event `parse` returned, if any. */
+    rawEvent?: JsonValue;
+}
+/** A delivery that is done; see {@link HttpChannelAdapter.onFinish}. */
+export type HttpFinishedDelivery = HttpDelivery & HttpFinish;
+/**
+ * How a delivery finished, to switch on by `type`. Each comes with
+ * `interrupts`, the thread's pending interrupts: what it waits on now.
+ *
+ * - `run`: the run it started ended; `run.status` says how.
+ * - `skipped`: it started no run; `reason` says why.
+ * - `failed`: MDA couldn't start its run after the provider got its answer,
+ *   so nothing redelivers it (`start`); couldn't start it and answered the
+ *   provider with an error, so it may redeliver it as a new delivery, which
+ *   reports its own outcome (`retry`); or lost track of the run it started
+ *   (`observe`), which may still answer. Only `start` is a final failure.
+ */
+export type HttpFinish = {
+    type: "run";
+    run: HttpFinishedRun;
+    interrupts: Interrupt[];
+} | {
+    type: "skipped";
+    reason: HttpSkipReason;
+    interrupts: Interrupt[];
+} | {
+    type: "failed";
+    reason: "start" | "retry" | "observe";
+    interrupts: Interrupt[];
+};
+/**
+ * Why a delivery started no run:
+ *
+ * - `cancel`: it was a cancel, and MDA cancelled the thread's runs.
+ * - `waiting`: its thread waits on a decision; `interrupts` say on what.
+ * - `ignored`: its input started nothing, such as a handler that declined.
+ * - `duplicate`: a redelivery of a delivery the thread already took; that
+ *   delivery's own `onFinish` reports its run.
+ * - `rejected`: its thread was busy, and the channel's `multitaskStrategy`
+ *   is `reject`.
+ * - `dropped`: a cancel dropped it while it waited for its busy thread or
+ *   for its input.
+ */
+export type HttpSkipReason = "cancel" | "waiting" | "ignored" | "duplicate" | "rejected" | "dropped";
+/**
+ * How a LangGraph run ended: `interrupted` when it was cancelled, by a cancel
+ * or a newer message, or replaced by a newer message's `rollback`.
+ */
+export type HttpRunStatus = "success" | "error" | "timeout" | "interrupted";
+/** A run a delivery started, and how it ended. */
+export interface HttpFinishedRun {
+    id: string;
+    status: HttpRunStatus;
 }
 export interface HttpChannelRequest {
     request: Request;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/channels/http/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,yBAAyB,CAAC;IACnC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE5C,mEAAmE;AACnE,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,MAAM,EAAE,SAAS,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,iEAAiE;IACjE,KAAK,CACH,OAAO,EAAE,kBAAkB,GAC1B,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5D,IAAI,CAAC,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/D,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/channels/http/types.ts"],"names":[],"mappings":"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"}

package/dist/channels/linear/app-setup.d.ts

@@ -0,0 +1,29 @@
+import type { LinearAppOptions } from "./types.js";
+/** What `mda deploy` needs to set up the Linear app. */
+export type LinearAppSetup = {
+    /** The handled event keys, such as `Issue.create`. */
+    events: string[];
+    /** Whether the app answers agent sessions. */
+    sessions: boolean;
+    /** The webhook resource types the app subscribes to. */
+    webhookResourceTypes: string[];
+    /** The OAuth scopes the install asks for. */
+    scopes: string[];
+    /** The most the install may be granted. */
+    allowedScopes: string[];
+    /** How the app looks; deploy names it after the agent when unset. */
+    app?: {
+        name?: string;
+        description?: string;
+        icon?: string;
+    };
+};
+/**
+ * The app the channel's handlers and options need. The CLI reads it from the
+ * channel's manifest instead of working it out; the Python runtime mirrors
+ * these rules in `linear_app_setup.py`.
+ */
+export declare function linearAppSetup(handlers: object, app: LinearAppOptions | undefined, options: {
+    sessions: boolean;
+}): LinearAppSetup;
+//# sourceMappingURL=app-setup.d.ts.map

package/dist/channels/linear/app-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-setup.d.ts","sourceRoot":"","sources":["../../../src/channels/linear/app-setup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAqCnE,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG;IAC3B,sDAAsD;IACtD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qEAAqE;IACrE,GAAG,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,gBAAgB,GAAG,SAAS,EACjC,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC7B,cAAc,CAkChB"}