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

package/dist/channels/linear/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/channels/linear/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,kFAAkF;AAClF,eAAO,MAAM,mBAAmB;;;;;;;iBAO9B,CAAC;AA8EH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,YAChC,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,UAAU,EACV,OAAO,EACP,aAAa,CACL,CAAC;AACX;;;GAGG;AACH,eAAO,MAAM,qBAAqB,YAAI,MAAM,CAAU,CAAC;AAyCvD,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAiD/B,CAAC;AAEH,eAAO,MAAM,oBAAoB,qHAEhC,CAAC;AAuEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAtCrB,MAAM;eAAS,MAAM;eAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwD3C,CAAC"}

package/dist/channels/linear/schema.js

@@ -0,0 +1,249 @@
+import { z } from "zod";
+import { nonblankStringSchema } from "../message-schema.js";
+// Shared scalar constraints. Linear identifiers are UUIDs, but only their
+// presence matters here.
+const optionalTextSchema = z.string().nullish();
+/** Receipt metadata only, not a complete Linear webhook payload specification. */
+export const linearReceiptSchema = z.object({
+    deliveryId: nonblankStringSchema,
+    payload: z.looseObject({
+        type: nonblankStringSchema,
+        action: nonblankStringSchema,
+        organizationId: z.string().optional(),
+    }),
+});
+const teamSchema = z.looseObject({
+    id: nonblankStringSchema,
+    key: nonblankStringSchema,
+    name: z.string().optional(),
+});
+const actorSchema = z.looseObject({
+    id: nonblankStringSchema,
+    type: z.string().optional(),
+    name: z.string().optional(),
+});
+// Payload subjects. Loose objects retain unmodeled provider fields.
+const issueSchema = z.looseObject({
+    id: nonblankStringSchema,
+    identifier: nonblankStringSchema,
+    title: z.string(),
+    description: optionalTextSchema,
+    url: z.string().optional(),
+    teamId: z.string().optional(),
+    team: teamSchema.optional(),
+    labelIds: z.array(z.string()).optional(),
+    labels: z
+        .array(z.looseObject({ id: z.string(), name: z.string() }))
+        .optional(),
+    botActor: z.unknown().optional(),
+});
+const commentSchema = z.looseObject({
+    id: nonblankStringSchema,
+    body: z.string(),
+    issueId: nonblankStringSchema,
+    parentId: z.string().nullish(),
+    userId: z.string().nullish(),
+    user: z
+        .looseObject({ id: z.string(), name: z.string().optional() })
+        .nullish(),
+    issue: z
+        .looseObject({
+        id: nonblankStringSchema,
+        identifier: z.string().optional(),
+        title: z.string().optional(),
+        url: z.string().optional(),
+        team: teamSchema.optional(),
+    })
+        .optional(),
+    botActor: z.unknown().optional(),
+});
+const sessionIssueSchema = z.looseObject({
+    id: nonblankStringSchema,
+    identifier: z.string().optional(),
+    title: z.string().optional(),
+    url: z.string().optional(),
+    description: optionalTextSchema,
+    team: teamSchema.optional(),
+});
+/** A Linear agent session: the app was mentioned or delegated an issue. */
+const agentSessionSchema = z.looseObject({
+    id: nonblankStringSchema,
+    status: z.string().optional(),
+    url: z.string().optional(),
+    issueId: z.string().nullish(),
+    issue: sessionIssueSchema.nullish(),
+    // The comment that started the session, when a mention did.
+    commentId: z.string().nullish(),
+    comment: z
+        .looseObject({ id: nonblankStringSchema, body: z.string().optional() })
+        .nullish(),
+    creatorId: z.string().nullish(),
+    creator: z
+        .looseObject({ id: nonblankStringSchema, name: z.string().optional() })
+        .nullish(),
+});
+/**
+ * The activity content types Linear documents; one it adds later reads as
+ * `unknown`. A user's reply is a `prompt`.
+ */
+export const LINEAR_ACTIVITY_TYPES = [
+    "prompt",
+    "thought",
+    "action",
+    "response",
+    "error",
+    "elicitation",
+];
+/**
+ * The signals Linear documents on a user's activity; one it adds later reads
+ * as `unknown`. `stop` asks the agent to stop.
+ */
+export const LINEAR_PROMPT_SIGNALS = ["stop"];
+/** What a user said in a session: a reply, or a signal such as `stop`. */
+const agentActivitySchema = z.looseObject({
+    content: z.looseObject({
+        type: z.enum([...LINEAR_ACTIVITY_TYPES, "unknown"]).catch("unknown"),
+        body: z.string().optional(),
+    }),
+    signal: z
+        .enum([...LINEAR_PROMPT_SIGNALS, "unknown"])
+        .catch("unknown")
+        .nullish(),
+    signalMetadata: z.unknown().optional(),
+    sourceCommentId: z.string().nullish(),
+    userId: z.string().nullish(),
+    user: z
+        .looseObject({ id: nonblankStringSchema, name: z.string().optional() })
+        .nullish(),
+});
+// Common delivery context.
+const envelopeSchema = z.looseObject({
+    organizationId: nonblankStringSchema,
+    webhookId: z.string().optional(),
+    webhookTimestamp: z.number(),
+    createdAt: z.string().optional(),
+    url: z.string().optional(),
+    actor: actorSchema.optional(),
+});
+function dispatchEventSchema(key, payloadSchema) {
+    return z.object({
+        key: z.literal(key),
+        deliveryId: nonblankStringSchema,
+        payload: payloadSchema,
+    });
+}
+/** Each supported event key requires its exact type, action and subject. */
+export const linearDispatchSchema = z.discriminatedUnion("key", [
+    dispatchEventSchema("Issue.create", envelopeSchema.extend({
+        type: z.literal("Issue"),
+        action: z.literal("create"),
+        data: issueSchema,
+    })),
+    dispatchEventSchema("Issue.update", envelopeSchema.extend({
+        type: z.literal("Issue"),
+        action: z.literal("update"),
+        data: issueSchema,
+        // The changed fields' previous values.
+        updatedFrom: z.record(z.string(), z.unknown()).optional(),
+    })),
+    dispatchEventSchema("Comment.create", envelopeSchema.extend({
+        type: z.literal("Comment"),
+        action: z.literal("create"),
+        data: commentSchema,
+    })),
+    dispatchEventSchema("AgentSessionEvent.created", envelopeSchema.extend({
+        type: z.literal("AgentSessionEvent"),
+        action: z.literal("created"),
+        appUserId: z.string().optional(),
+        agentSession: agentSessionSchema,
+        // Linear's ready-made prompt: the issue, the thread and who asked.
+        promptContext: z.string().nullish(),
+        guidance: z.unknown().optional(),
+    })),
+    dispatchEventSchema("AgentSessionEvent.prompted", envelopeSchema.extend({
+        type: z.literal("AgentSessionEvent"),
+        action: z.literal("prompted"),
+        appUserId: z.string().optional(),
+        agentSession: agentSessionSchema,
+        agentActivity: agentActivitySchema,
+    })),
+]);
+export const SUPPORTED_EVENT_KEYS = linearDispatchSchema.options.map((option) => option.shape.key.value);
+/** The issue an event is about, wherever its payload keeps it. */
+function eventIssue(event) {
+    if (event.payload.type === "AgentSessionEvent") {
+        const session = event.payload.agentSession;
+        const id = session.issue?.id ?? session.issueId;
+        // Linear opens sessions on issues; one without could not be answered.
+        if (!id)
+            throw new TypeError("Linear agent session has no issue");
+        return { id, ...(session.issue?.team && { team: session.issue.team }) };
+    }
+    if (event.payload.type === "Comment") {
+        const { data } = event.payload;
+        return {
+            id: data.issueId,
+            ...(data.issue?.team && { team: data.issue.team }),
+        };
+    }
+    const { data } = event.payload;
+    return { id: data.id, ...(data.team && { team: data.team }) };
+}
+/**
+ * Who acted: the webhook's actor, or for a session the user who started it or
+ * replied in it.
+ */
+function eventActor(event) {
+    const payload = event.payload;
+    const person = payload.type !== "AgentSessionEvent"
+        ? payload.actor
+        : payload.action === "prompted"
+            ? (payload.agentActivity.user ??
+                (payload.agentActivity.userId
+                    ? { id: payload.agentActivity.userId }
+                    : undefined))
+            : (payload.agentSession.creator ??
+                (payload.agentSession.creatorId
+                    ? { id: payload.agentSession.creatorId }
+                    : undefined));
+    if (!person)
+        return undefined;
+    const { type, name } = person;
+    return {
+        id: person.id,
+        ...(typeof type === "string" && { type }),
+        ...(typeof name === "string" && { name }),
+    };
+}
+/** Routing metadata every event exposes next to its payload. */
+function routing(event) {
+    const issue = eventIssue(event);
+    const actor = eventActor(event);
+    return {
+        organizationId: event.payload.organizationId,
+        issueId: issue.id,
+        ...(issue.team && {
+            team: { id: issue.team.id, key: issue.team.key },
+        }),
+        ...(actor && { actor }),
+    };
+}
+// Expose common routing metadata while preserving the original payload.
+export const linearEventSchema = linearDispatchSchema.transform((event) => {
+    if (event.key === "AgentSessionEvent.created" ||
+        event.key === "AgentSessionEvent.prompted")
+        return {
+            ...event,
+            type: event.payload.type,
+            action: event.payload.action,
+            ...routing(event),
+            sessionId: event.payload.agentSession.id,
+        };
+    return {
+        ...event,
+        type: event.payload.type,
+        action: event.payload.action,
+        ...routing(event),
+    };
+});
+//# sourceMappingURL=schema.js.map

package/dist/channels/linear/schema.js.map

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

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

@@ -0,0 +1,150 @@
+import type { z } from "zod";
+import type { MultitaskStrategy } from "../../ingress/runs.js";
+import type { linearEventSchema } from "./schema.js";
+import type { ChannelRunResult } from "../run-input.js";
+import type { EventSettled } from "../http/provider.js";
+import type { EventEndpoint } from "../http/endpoint.js";
+/** Handwritten schema subsets; unmodeled provider fields remain unknown. */
+type EventUnion = z.output<typeof linearEventSchema>;
+export type LinearEventKey = EventUnion["key"];
+export type LinearEvent<K extends LinearEventKey = LinearEventKey> = Extract<EventUnion, {
+    key: K;
+}>;
+export type LinearPayloadFor<K extends LinearEventKey> = LinearEvent<K>["payload"];
+/**
+ * The conversation's thread an event belongs to. A handler runs before any
+ * run exists, so this is not a run's runtime.
+ */
+export interface LinearChannelThread {
+    /**
+     * The conversation's thread, the issue's or an agent session's, which the
+     * run the handler starts runs on. Useful for run context that names the
+     * thread, such as a token a backend signs for it.
+     */
+    id: string;
+    channel: {
+        name: string;
+    };
+}
+/**
+ * What an event handler returns: a run's input, as `agent.invoke` takes it —
+ * a string, a message such as `new HumanMessage(...)`, state such as
+ * `{ messages: [...] }`, or `[input, { context, metadata }]`. `null` or `undefined`
+ * starts nothing.
+ */
+export type LinearEventResult = ChannelRunResult | null | undefined | void;
+export type LinearEventCallback<K extends LinearEventKey> = (event: LinearEvent<K>, thread: LinearChannelThread) => LinearEventResult | Promise<LinearEventResult>;
+/** The Linear app `mda deploy` sets up: how it looks, and what it may do. */
+export interface LinearAppOptions {
+    /**
+     * The app's name, shown where people mention it and in its comments: 2–80
+     * characters, without "Linear" or a URL. Defaults to the agent's name.
+     *
+     * Applies only when deploy creates the app. Linear has no API to change an
+     * app, so changing it later does nothing: rename an existing app on its
+     * settings page in Linear. Deploy reminds you when it keeps an existing app.
+     */
+    name?: string;
+    /**
+     * What the app does, shown when a workspace admin installs it: up to 1,000
+     * characters. Like `name`, it applies only when deploy creates the app;
+     * change an existing app's description on its settings page in Linear.
+     */
+    description?: string;
+    /**
+     * The app's icon: a PNG or JPEG image, as a path relative to `channels/`
+     * like the Slack channel's `icon`, such as `assets/icon.png`. At least
+     * 256×256 pixels and at most 1 MB. The deployment serves it at
+     * `/channels/{name}/icon`, and deploy points the new app's icon there.
+     * Like `name`, it applies only when deploy creates the app.
+     */
+    icon?: string;
+    /**
+     * Keys of the teams (as in `ENG-123`) the channel is limited to: events
+     * about other teams' issues start nothing. Defaults to every team the app
+     * can see. The app's token still reaches every team it was granted, so
+     * limit its team access in Linear too.
+     */
+    teams?: string[];
+}
+/**
+ * Options for `channels.linear(...)`: the app's scope and event handlers that
+ * start runs. Each issue is one conversation, and each agent session on it
+ * another.
+ */
+export interface LinearChannelOptions {
+    /** The Linear app `mda deploy` sets up: its name, description, icon and teams. */
+    app?: LinearAppOptions;
+    /**
+     * What an event that starts a run does while its conversation 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.
+     *
+     * @example
+     * ```ts
+     * // A newer comment replaces the work on an older one.
+     * channels.linear({ multitaskStrategy: "interrupt", onEvent })
+     * ```
+     */
+    multitaskStrategy?: MultitaskStrategy;
+    /**
+     * Event handlers that start runs. Return a prompt (string, message, or
+     * state), or nothing to skip. The run's final reply is posted as a comment
+     * on the issue, under the comment that started it.
+     *
+     * @example
+     * ```ts
+     * { "Issue.create": (e) => `Triage ${e.payload.data.identifier}` }
+     * ```
+     *
+     * In agent sessions the reply goes to the session instead.
+     *
+     * A handler may also be an endpoint, a URL or a `Request` carrying headers,
+     * to have a service of yours decide: MDA POSTs it the event and its thread,
+     * and starts the run it answers with. See the README's "Asking your service
+     * what to start".
+     */
+    onEvent?: {
+        [K in LinearEventKey]?: LinearEventCallback<K> | EventEndpoint;
+    };
+    /**
+     * Answer Linear agent sessions, which open when someone mentions the app or
+     * delegates an issue to it. Defaults to `true`. Without a handler, a new
+     * session runs with Linear's prompt for it (`promptContext`), and a reply
+     * in the session continues the conversation. The run's progress and reply
+     * show in the session, and Stop cancels the run. A run that stops on
+     * interrupts answers with a link to its thread in LangSmith Studio, where
+     * they are resumed.
+     *
+     * @experimental Sessions use Linear's Agents API, a Developer Preview, so
+     * they may change as Linear changes it.
+     */
+    sessions?: boolean;
+    /**
+     * Ignore changes made by other apps and integrations (a delivery whose
+     * actor isn't a person, or the creation of an issue or comment with a
+     * `botActor`), so automations don't trigger each other. Defaults to `true`.
+     * The app's own changes are always ignored.
+     */
+    ignoreBots?: boolean;
+    /**
+     * How a delivery of a handled event ended, once: the run it started
+     * completed, stopped on interrupts, was cancelled, replaced, or failed, or
+     * why it started none, such as `declined` when its handler returned
+     * nothing; a Stop is `stopped`. Called after the channel's own activities,
+     * such as the session's elicitation or "Stopped.", in the background;
+     * failures are logged. See `channels.http`'s `onSettled` for its limits.
+     *
+     * @example
+     * ```ts
+     * onSettled: async (event, thread, outcome) => {
+     *   if ("runId" in outcome) await reportRun(thread.id, outcome);
+     * }
+     * ```
+     */
+    onSettled?: EventSettled<LinearEvent, LinearChannelThread>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/channels/linear/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,4EAA4E;AAC5E,KAAK,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACrD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI,OAAO,CAC1E,UAAU,EACV;IAAE,GAAG,EAAE,CAAC,CAAA;CAAE,CACX,CAAC;AACF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,IACnD,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAE5B;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;AAE3E,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,cAAc,IAAI,CAC1D,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,MAAM,EAAE,mBAAmB,KACxB,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEpD,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,EAAE;SACP,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,aAAa;KAC/D,CAAC;IACF;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;CAC5D"}

package/dist/channels/linear/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/channels/linear/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/channels/linear/types.ts"],"names":[],"mappings":""}

package/dist/channels/message-schema.d.ts

@@ -4,6 +4,8 @@ import type { MessageContent } from "@langchain/core/messages";
 import type { JsonValue } from "./types.js";
 /** Accept only finite, acyclic plain JSON, including frozen values. */
 export declare function isJsonValue(value: unknown, ancestors?: Set<object>): value is JsonValue;
+/** A string with something other than whitespace in it. */
+export declare const nonblankStringSchema: z.ZodString;
 export declare const jsonValueSchema: z.ZodCustom<JsonValue, JsonValue>;
 export declare const channelContentMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"content">;

package/dist/channels/message-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-schema.d.ts","sourceRoot":"","sources":["../../src/channels/message-schema.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,uEAAuE;AACvE,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,SAAS,cAAoB,GAC5B,KAAK,IAAI,SAAS,CAiBpB;AAED,eAAO,MAAM,eAAe,mCAG3B,CAAC;AAeF,eAAO,MAAM,2BAA2B;;;kBAE7B,CAAC;AACZ,eAAO,MAAM,0BAA0B;;;kBAE5B,CAAC;AACZ,eAAO,MAAM,oBAAoB;;;;;;4BAG/B,CAAC"}
+{"version":3,"file":"message-schema.d.ts","sourceRoot":"","sources":["../../src/channels/message-schema.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,uEAAuE;AACvE,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,SAAS,cAAoB,GAC5B,KAAK,IAAI,SAAS,CAiBpB;AAED,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,aAEY,CAAC;AAE9C,eAAO,MAAM,eAAe,mCAG3B,CAAC;AAeF,eAAO,MAAM,2BAA2B;;;kBAE7B,CAAC;AACZ,eAAO,MAAM,0BAA0B;;;kBAE5B,CAAC;AACZ,eAAO,MAAM,oBAAoB;;;;;;4BAG/B,CAAC"}

package/dist/channels/message-schema.js

@@ -17,6 +17,10 @@ export function isJsonValue(value, ancestors = new Set()) {
     ancestors.delete(value);
     return valid;
 }
+/** A string with something other than whitespace in it. */
+export const nonblankStringSchema = z
+    .string()
+    .refine((value) => value.trim().length > 0);
 export const jsonValueSchema = z.custom(isJsonValue, "must be finite acyclic JSON");
 const contentSchema = z.custom((value) => typeof value === "string" ||
     (Array.isArray(value) &&

package/dist/channels/message-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-schema.js","sourceRoot":"","sources":["../../src/channels/message-schema.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,uEAAuE;AACvE,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,SAAS,GAAG,IAAI,GAAG,EAAU;IAE7B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC3E,OAAO,IAAI,CAAC;IACd,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpE,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS;QACjD,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI;QAErC,OAAO,KAAK,CAAC;IACf,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CACvE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CACvC,CAAC;IACF,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CACrC,WAAW,EACX,6BAA6B,CAC9B,CAAC;AACF,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ;IACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACnB,KAAK,CAAC,KAAK,CACT,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,KAAK,IAAI;YACd,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC9B,WAAW,CAAC,KAAK,CAAC,CACrB,CAAC,EACN,iDAAiD,CAClD,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;KAC9D,MAAM,EAAE,CAAC;AACZ,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;KAC9D,MAAM,EAAE,CAAC;AACZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC/D,2BAA2B;IAC3B,0BAA0B;CAC3B,CAAC,CAAC"}
+{"version":3,"file":"message-schema.js","sourceRoot":"","sources":["../../src/channels/message-schema.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,uEAAuE;AACvE,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,SAAS,GAAG,IAAI,GAAG,EAAU;IAE7B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC3E,OAAO,IAAI,CAAC;IACd,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpE,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS;QACjD,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI;QAErC,OAAO,KAAK,CAAC;IACf,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CACvE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CACvC,CAAC;IACF,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CACrC,WAAW,EACX,6BAA6B,CAC9B,CAAC;AACF,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ;IACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACnB,KAAK,CAAC,KAAK,CACT,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,KAAK,IAAI;YACd,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC9B,WAAW,CAAC,KAAK,CAAC,CACrB,CAAC,EACN,iDAAiD,CAClD,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;KAC9D,MAAM,EAAE,CAAC;AACZ,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;KAC9D,MAAM,EAAE,CAAC;AACZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC/D,2BAA2B;IAC3B,0BAA0B;CAC3B,CAAC,CAAC"}

package/dist/channels/reserved-connections.d.ts

@@ -1,7 +1,7 @@
 /**
  * Why a channel's reserved agent connection cannot be read as a user
- * connection, or undefined for any other slug. Reading the GitHub App's token
- * as the person running the agent is not supported yet.
+ * connection, or undefined for any other slug. Reading an app's token as the
+ * person running the agent is not supported yet.
  */
 export declare function reservedUserConnectionError(slug: string): string | undefined;
 /**

package/dist/channels/reserved-connections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reserved-connections.d.ts","sourceRoot":"","sources":["../../src/channels/reserved-connections.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ5E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,CAGR"}
+{"version":3,"file":"reserved-connections.d.ts","sourceRoot":"","sources":["../../src/channels/reserved-connections.ts"],"names":[],"mappings":"AAuCA;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS5E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,CAGR"}

package/dist/channels/reserved-connections.js

@@ -1,28 +1,45 @@
 import { GITHUB_TOKEN_SLUG, githubAppConnectionSlug, } from "./github/connections.js";
+import { LINEAR_TOKEN_SLUG, linearAppConnectionSlug, } from "./linear/connections.js";
 // First-party channels' reserved agent connection names, listed here so
 // resolution does not depend on adapter modules being loaded.
 const builtinReservedConnections = new Map([
-    [GITHUB_TOKEN_SLUG, (deploymentId) => githubAppConnectionSlug(deploymentId)],
+    [
+        GITHUB_TOKEN_SLUG,
+        {
+            resolve: githubAppConnectionSlug,
+            token: "the GitHub App's installation token",
+            actsAs: "act on GitHub as the App",
+        },
+    ],
+    [
+        LINEAR_TOKEN_SLUG,
+        {
+            resolve: linearAppConnectionSlug,
+            token: "the Linear app's token",
+            actsAs: "act in Linear as the app",
+        },
+    ],
 ]);
 /**
  * Why a channel's reserved agent connection cannot be read as a user
- * connection, or undefined for any other slug. Reading the GitHub App's token
- * as the person running the agent is not supported yet.
+ * connection, or undefined for any other slug. Reading an app's token as the
+ * person running the agent is not supported yet.
  */
 export function reservedUserConnectionError(slug) {
-    if (!builtinReservedConnections.has(slug))
+    const reserved = builtinReservedConnections.get(slug);
+    if (!reserved)
         return undefined;
     const name = JSON.stringify(slug);
-    return (`${name} is not supported as a user connection yet: it is the GitHub App's ` +
-        `installation token, an agent connection. Use connections.get(${name}, ` +
-        `{ type: "agent" }) to act on GitHub as the App.`);
+    return (`${name} is not supported as a user connection yet: it is ${reserved.token}, ` +
+        `an agent connection. Use connections.get(${name}, { type: "agent" }) to ` +
+        `${reserved.actsAs}.`);
 }
 /**
  * The connection that actually holds a channel's reserved agent connection;
  * other slugs pass through unchanged.
  */
 export function reservedAgentConnectionSlug(slug, deploymentId) {
-    const resolve = builtinReservedConnections.get(slug);
-    return resolve && deploymentId ? resolve(deploymentId) : slug;
+    const reserved = builtinReservedConnections.get(slug);
+    return reserved && deploymentId ? reserved.resolve(deploymentId) : slug;
 }
 //# sourceMappingURL=reserved-connections.js.map

package/dist/channels/reserved-connections.js.map

@@ -1 +1 @@
-{"version":3,"file":"reserved-connections.js","sourceRoot":"","sources":["../../src/channels/reserved-connections.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,wEAAwE;AACxE,8DAA8D;AAC9D,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAGxC;IACA,CAAC,iBAAiB,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAC;CAC7E,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,CACL,GAAG,IAAI,qEAAqE;QAC5E,gEAAgE,IAAI,IAAI;QACxE,iDAAiD,CAClD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,YAAgC;IAEhC,MAAM,OAAO,GAAG,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChE,CAAC"}
+{"version":3,"file":"reserved-connections.js","sourceRoot":"","sources":["../../src/channels/reserved-connections.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,wEAAwE;AACxE,8DAA8D;AAC9D,MAAM,0BAA0B,GAAG,IAAI,GAAG,CASxC;IACA;QACE,iBAAiB;QACjB;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,qCAAqC;YAC5C,MAAM,EAAE,0BAA0B;SACnC;KACF;IACD;QACE,iBAAiB;QACjB;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,wBAAwB;YAC/B,MAAM,EAAE,0BAA0B;SACnC;KACF;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,MAAM,QAAQ,GAAG,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,CACL,GAAG,IAAI,qDAAqD,QAAQ,CAAC,KAAK,IAAI;QAC9E,4CAA4C,IAAI,0BAA0B;QAC1E,GAAG,QAAQ,CAAC,MAAM,GAAG,CACtB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,YAAgC;IAEhC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC"}

package/dist/channels/run-input.d.ts

@@ -16,7 +16,21 @@ export interface ChannelStateInput {
 /** A user message's text, a message, or state to start a run with. */
 export type ChannelRunInput = string | BaseMessage | ChannelStateInput;
 /** Run options a handler may set with its input, as `agent.invoke` takes them. */
-export type ChannelRunOptions = Pick<LangGraphRunnableConfig<Record<string, unknown>>, "context">;
+export type ChannelRunOptions = Pick<LangGraphRunnableConfig<Record<string, unknown>>, "context"> & {
+    /**
+     * Metadata for the run, such as where it came from, to find it by in
+     * LangSmith. Keys are letters, digits, `_`, `.` or `-` and start with a
+     * letter; `mda_` and `langgraph_` keys are reserved. MDA's own keys win.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * A URL the Agent Server POSTs the finished run to (its status, metadata,
+     * values and any error), as LangGraph's `runs.create({ webhook })` does:
+     * from the server, so it reaches you even if the deployment restarts.
+     * http(s), without credentials in it.
+     */
+    webhook?: string;
+};
 /**
  * What a channel handler may return to start a run: the input, or the input
  * with run options, as `agent.invoke(input, options)` takes them.
@@ -29,6 +43,8 @@ export interface NormalizedRunInput {
     /** Other state keys. */
     state: JsonObject;
     context?: JsonObject;
+    metadata?: JsonObject;
+    webhook?: string;
 }
 /**
  * Normalize what a handler returned. `null` and `undefined` start nothing;

package/dist/channels/run-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-input.d.ts","sourceRoot":"","sources":["../../src/channels/run-input.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAEvE,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,uBAAuB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAChD,SAAS,CACV,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,SAAS,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;AAElD,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,wBAAwB;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,kBAAkB,GAAG,SAAS,CAsBhC"}
+{"version":3,"file":"run-input.d.ts","sourceRoot":"","sources":["../../src/channels/run-input.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAEvE,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,uBAAuB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAChD,SAAS,CACV,GAAG;IACF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,SAAS,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;AAElD,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,wBAAwB;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,kBAAkB,GAAG,SAAS,CAsBhC"}

package/dist/channels/run-input.js

@@ -27,16 +27,50 @@ export function normalizeRunInput(value) {
         return normalized;
     if (!isPlainObject(options))
         throw new TypeError("run options must be an object");
-    const { context, ...rest } = options;
+    const { context, metadata, webhook, ...rest } = options;
     if (Object.keys(rest).length)
-        throw new TypeError(`unsupported run option ${Object.keys(rest).join(", ")}; use context`);
-    if (context === undefined)
-        return normalized;
+        throw new TypeError(`unsupported run option ${Object.keys(rest).join(", ")}; use context, metadata or webhook`);
+    return {
+        ...normalized,
+        ...(context !== undefined && { context: runContext(context) }),
+        ...(metadata !== undefined && { metadata: runMetadata(metadata) }),
+        ...(webhook !== undefined && { webhook: runWebhook(webhook) }),
+    };
+}
+function runWebhook(webhook) {
+    let url;
+    try {
+        url = typeof webhook === "string" ? new URL(webhook) : undefined;
+    }
+    catch {
+        url = undefined;
+    }
+    if (!url ||
+        (url.protocol !== "https:" && url.protocol !== "http:") ||
+        url.username ||
+        url.password)
+        throw new TypeError("run webhook must be an http(s) URL, without credentials in it");
+    return url.href;
+}
+function runContext(context) {
     if (!isPlainObject(context) || !isJsonValue(context))
         throw new TypeError("run context must be a JSON object");
     if ("channel" in context)
         throw new TypeError("context.channel is reserved for managed ingress");
-    return { ...normalized, context: context };
+    return context;
+}
+/** The metadata keys a handler may set. */
+const METADATA_KEY = /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/;
+/** Keys MDA and the Agent Server set, and object internals. */
+const RESERVED_METADATA_KEY = /^(mda_|langgraph_)|^(constructor|prototype)$/i;
+function runMetadata(metadata) {
+    if (!isPlainObject(metadata) || !isJsonValue(metadata))
+        throw new TypeError("run metadata must be a JSON object");
+    for (const key of Object.keys(metadata)) {
+        if (!METADATA_KEY.test(key) || RESERVED_METADATA_KEY.test(key))
+            throw new TypeError("run metadata keys are letters, digits, _, . or -, start with a letter, and don't start with mda_ or langgraph_");
+    }
+    return metadata;
 }
 function normalizeInput(input) {
     if (typeof input === "string") {