managed-deepagents 0.9.6-dev.2 → 0.9.6-dev.21

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

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

package/dist/channels/github/schema.js

@@ -0,0 +1,221 @@
+import { z } from "zod";
+import { eventMentions } from "./mentions.js";
+import { nonblankStringSchema } from "../message-schema.js";
+// Shared scalar constraints. Dispatch IDs are positive safe integers.
+const nullableTextSchema = z.string().nullable();
+export const githubIdentifierSchema = z.number().int().positive();
+/** Receipt metadata only, not a complete GitHub event payload specification. */
+export const githubReceiptSchema = z.object({
+    event: nonblankStringSchema,
+    deliveryId: nonblankStringSchema,
+    payload: z.looseObject({
+        action: z.string().optional(),
+        repository: z.looseObject({ id: z.number().int().optional() }).optional(),
+        issue: z.looseObject({ number: z.number().int().optional() }).optional(),
+        pull_request: z
+            .looseObject({ number: z.number().int().optional() })
+            .optional(),
+    }),
+});
+// Payload subjects. Loose objects retain unmodeled provider fields.
+const issueSchema = z.looseObject({
+    number: githubIdentifierSchema,
+    title: nonblankStringSchema,
+    body: nullableTextSchema,
+    pull_request: z.record(z.string(), z.unknown()).optional(),
+});
+const pullRequestSchema = issueSchema.extend({
+    draft: z.boolean().optional(),
+    merged: z.boolean().optional(),
+});
+const commentSchema = z.looseObject({
+    id: githubIdentifierSchema,
+    body: z.string(),
+});
+const labelSchema = z.looseObject({ name: nonblankStringSchema });
+const reviewSchema = z.looseObject({
+    id: githubIdentifierSchema,
+    body: nullableTextSchema,
+    state: nonblankStringSchema,
+});
+const workflowRunSchema = z.looseObject({
+    id: githubIdentifierSchema,
+    conclusion: nullableTextSchema,
+    pull_requests: z.array(z.record(z.string(), z.unknown())),
+});
+const checkRunSchema = z.looseObject({
+    id: githubIdentifierSchema,
+    name: nonblankStringSchema,
+    head_sha: nonblankStringSchema,
+    conclusion: nullableTextSchema,
+    pull_requests: z.array(z.record(z.string(), z.unknown())),
+});
+const checkSuiteSchema = z.looseObject({
+    id: githubIdentifierSchema,
+    head_sha: nonblankStringSchema,
+    conclusion: nullableTextSchema,
+    pull_requests: z.array(z.record(z.string(), z.unknown())),
+});
+// Common dispatch context and reusable payload families.
+const senderSchema = z.looseObject({
+    id: githubIdentifierSchema,
+    login: nonblankStringSchema,
+    type: z.enum(["User", "Bot", "Organization"]),
+});
+const repositorySchema = z.looseObject({
+    id: githubIdentifierSchema,
+    owner: z.looseObject({ login: nonblankStringSchema }),
+    name: nonblankStringSchema,
+    full_name: nonblankStringSchema,
+    private: z.boolean(),
+});
+const dispatchPayloadSchema = z.looseObject({
+    repository: repositorySchema,
+    sender: senderSchema,
+    installation: z.looseObject({ id: githubIdentifierSchema }),
+});
+const issuePayloadSchema = dispatchPayloadSchema.extend({ issue: issueSchema });
+const pullRequestPayloadSchema = dispatchPayloadSchema.extend({
+    pull_request: pullRequestSchema,
+});
+function dispatchEventSchema(key, payloadSchema) {
+    return z.object({
+        key: z.literal(key),
+        deliveryId: nonblankStringSchema,
+        payload: payloadSchema,
+    });
+}
+/** Each supported event key requires its exact payload action and subject. */
+export const githubDispatchSchema = z.discriminatedUnion("key", [
+    dispatchEventSchema("issues.opened", issuePayloadSchema.extend({ action: z.literal("opened") })),
+    dispatchEventSchema("issues.edited", issuePayloadSchema.extend({ action: z.literal("edited") })),
+    dispatchEventSchema("issues.reopened", issuePayloadSchema.extend({ action: z.literal("reopened") })),
+    dispatchEventSchema("issues.labeled", issuePayloadSchema.extend({
+        action: z.literal("labeled"),
+        label: labelSchema,
+    })),
+    dispatchEventSchema("issue_comment.created", issuePayloadSchema.extend({
+        action: z.literal("created"),
+        comment: commentSchema,
+    })),
+    dispatchEventSchema("issue_comment.edited", issuePayloadSchema.extend({
+        action: z.literal("edited"),
+        comment: commentSchema,
+    })),
+    dispatchEventSchema("pull_request.opened", pullRequestPayloadSchema.extend({ action: z.literal("opened") })),
+    dispatchEventSchema("pull_request.edited", pullRequestPayloadSchema.extend({ action: z.literal("edited") })),
+    dispatchEventSchema("pull_request.reopened", pullRequestPayloadSchema.extend({ action: z.literal("reopened") })),
+    dispatchEventSchema("pull_request.ready_for_review", pullRequestPayloadSchema.extend({ action: z.literal("ready_for_review") })),
+    dispatchEventSchema("pull_request.converted_to_draft", pullRequestPayloadSchema.extend({
+        action: z.literal("converted_to_draft"),
+    })),
+    dispatchEventSchema("pull_request.synchronize", pullRequestPayloadSchema.extend({ action: z.literal("synchronize") })),
+    dispatchEventSchema("pull_request.labeled", pullRequestPayloadSchema.extend({
+        action: z.literal("labeled"),
+        label: labelSchema,
+    })),
+    dispatchEventSchema("pull_request.closed", pullRequestPayloadSchema.extend({ action: z.literal("closed") })),
+    dispatchEventSchema("pull_request_review.submitted", pullRequestPayloadSchema.extend({
+        action: z.literal("submitted"),
+        review: reviewSchema,
+    })),
+    dispatchEventSchema("pull_request_review.edited", pullRequestPayloadSchema.extend({
+        action: z.literal("edited"),
+        review: reviewSchema,
+    })),
+    dispatchEventSchema("pull_request_review.dismissed", pullRequestPayloadSchema.extend({
+        action: z.literal("dismissed"),
+        review: reviewSchema,
+    })),
+    dispatchEventSchema("pull_request_review_comment.created", pullRequestPayloadSchema.extend({
+        action: z.literal("created"),
+        comment: commentSchema,
+    })),
+    dispatchEventSchema("pull_request_review_comment.edited", pullRequestPayloadSchema.extend({
+        action: z.literal("edited"),
+        comment: commentSchema,
+    })),
+    // Events without an action are keyed by their name alone.
+    dispatchEventSchema("push", dispatchPayloadSchema.extend({
+        action: z.never().optional(),
+        ref: nonblankStringSchema,
+        before: nonblankStringSchema,
+        after: nonblankStringSchema,
+    })),
+    dispatchEventSchema("status", dispatchPayloadSchema.extend({
+        action: z.never().optional(),
+        id: githubIdentifierSchema,
+        sha: nonblankStringSchema,
+        state: nonblankStringSchema,
+        context: nonblankStringSchema,
+    })),
+    dispatchEventSchema("check_run.completed", dispatchPayloadSchema.extend({
+        action: z.literal("completed"),
+        check_run: checkRunSchema,
+    })),
+    dispatchEventSchema("check_suite.completed", dispatchPayloadSchema.extend({
+        action: z.literal("completed"),
+        check_suite: checkSuiteSchema,
+    })),
+    dispatchEventSchema("workflow_run.completed", dispatchPayloadSchema.extend({
+        action: z.literal("completed"),
+        workflow_run: workflowRunSchema,
+    })),
+]);
+/**
+ * The fields of a GitHub event its endpoints are sent beside its key, delivery
+ * ID and payload: what a handler gets that the payload doesn't say as plainly.
+ * The one list of them; `GitHubEndpointRequest` is typed by it.
+ */
+export const ENDPOINT_EVENT_FIELDS = [
+    "action",
+    "repository",
+    "sender",
+    "actor",
+    "mentions",
+];
+export const SUPPORTED_EVENT_KEYS = githubDispatchSchema.options.map((option) => option.shape.key.value);
+/** A webhook's `sender`, as a channel's actor; its login is its name. */
+function senderActor(sender) {
+    return {
+        provider: "github",
+        id: String(sender.id),
+        name: sender.login,
+        type: sender.type,
+    };
+}
+// Expose common routing metadata while preserving the original payload.
+export const githubEventSchema = githubDispatchSchema.transform((event) => ({
+    ...event,
+    name: event.key.split(".")[0],
+    // `push` and `status` have no action, and an absent field keeps the
+    // event JSON.
+    ...(event.payload.action !== undefined && {
+        action: event.payload.action,
+    }),
+    installationId: event.payload.installation.id,
+    repository: {
+        id: event.payload.repository.id,
+        owner: event.payload.repository.owner.login,
+        name: event.payload.repository.name,
+        fullName: event.payload.repository.full_name,
+        private: event.payload.repository.private,
+    },
+    sender: {
+        id: event.payload.sender.id,
+        login: event.payload.sender.login,
+        type: event.payload.sender.type,
+    },
+    /** The `sender`, in the shape every channel's `actor` has. */
+    actor: senderActor(event.payload.sender),
+    /**
+     * The handles the text this event wrote mentions, such as `@octocat` or a
+     * text tag like `@openswe`: lowercased, each once, in order. The text is a
+     * new or edited comment's or review's body, or an opened or edited issue's
+     * or pull request's title and body; an edit lists only the handles it
+     * added. As on GitHub, code, quotes and HTML comments mention no one. Empty
+     * for events that write no text, such as a push or a label.
+     */
+    mentions: eventMentions(event),
+}));
+//# sourceMappingURL=schema.js.map

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

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

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

@@ -0,0 +1,170 @@
+import type { z } from "zod";
+import type { MultitaskStrategy } from "../../ingress/runs.js";
+import type { ENDPOINT_EVENT_FIELDS, githubEventSchema } from "./schema.js";
+import type { ChannelRunResult } from "../run-input.js";
+import type { GitHubActor } from "../actor.js";
+import type { ResolveUser } from "../resolve-user.js";
+import type { EventFinished, EventReceived } from "../http/provider.js";
+import type { EndpointRequest, EventEndpoint } from "../http/endpoint.js";
+/** Handwritten schema subsets; unmodeled provider fields remain unknown. */
+type EventUnion = z.output<typeof githubEventSchema>;
+export type SupportedEventKey = EventUnion["key"];
+export type GitHubEvent<K extends SupportedEventKey = SupportedEventKey> = Extract<EventUnion, {
+    key: K;
+}>;
+export type PayloadFor<K extends SupportedEventKey> = GitHubEvent<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 GitHubChannelThread {
+    /**
+     * The thread's ID: the one a run the handler starts runs on, or, when
+     * `interrupted`, the one that waits. Useful for run context that names the
+     * thread, such as a token a backend signs for it.
+     */
+    id: string;
+    channel: {
+        name: string;
+    };
+    /**
+     * Set when the thread waits on an interrupt. No run starts: what the
+     * handler returns only decides whether the App tells the issue or pull
+     * request that a decision is pending, so skip side effects such as
+     * reactions.
+     */
+    interrupted?: true;
+}
+/**
+ * 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 GitHubEventResult = ChannelRunResult | null | undefined | void;
+export type GitHubEventCallback<K extends SupportedEventKey> = (event: GitHubEvent<K>, thread: GitHubChannelThread) => GitHubEventResult | Promise<GitHubEventResult>;
+/**
+ * What the agent may do with the GitHub App `mda deploy` sets up. Deploy
+ * applies changes to these on every run, except to the App's own
+ * permissions (see `permissions`).
+ */
+export interface GitHubAppOptions {
+    /**
+     * Permissions the agent's GitHub token needs beyond those the handled
+     * events need, e.g. `{ contents: "read" }`. A new App asks for both.
+     *
+     * Handled events set their own level: read to receive an event, write to
+     * also reply where it happened. These can raise that level but not lower
+     * it.
+     *
+     * Deploy renews the agent's token with changed permissions, but it cannot
+     * change the App itself: GitHub reads an App's permissions from its
+     * manifest only when the App is created, and has no API to change them
+     * later. The App's owner grants added permissions, and removes dropped or
+     * lowered ones, in the App's settings on GitHub. Deploy names both and
+     * links there; until a dropped permission is removed, the App keeps it
+     * even though the agent's token no longer has it.
+     */
+    permissions?: Record<string, "read" | "write">;
+    /**
+     * Repositories (`owner/name`, one owner) the channel is limited to: events
+     * from other repositories start nothing, and deploy reports listed ones the
+     * App is not installed on. Defaults to every repository the App is
+     * installed on. The agent's token still reaches every repository of the
+     * installation, so install the App only on the ones the agent may change.
+     */
+    repositories?: string[];
+}
+/** Options for `channels.github(...)`: App scope and event handlers that start runs. */
+export interface GitHubChannelOptions {
+    /** App `mda deploy` creates; permissions and repository allowlist. */
+    app?: GitHubAppOptions;
+    /**
+     * 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. Events on a conversation that waits on an interrupt start
+     * nothing either way.
+     *
+     * @example
+     * ```ts
+     * // A newer comment replaces the work on an older one.
+     * channels.github({ multitaskStrategy: "interrupt", onEvent })
+     * ```
+     */
+    multitaskStrategy?: MultitaskStrategy;
+    /**
+     * Map the GitHub sender to one of your users, with a function or an endpoint MDA
+     * asks; overrides the identity's.
+     */
+    resolveUser?: ResolveUser<GitHubActor> | EventEndpoint;
+    /**
+     * Event handlers that start runs. Return a prompt (string, message, or
+     * state), or nothing to skip. While a thread waits on an interrupt, events
+     * start nothing: the handler still runs, with `thread.interrupted` set, to
+     * decide whether the issue or pull request is told to continue it in
+     * LangSmith Studio.
+     *
+     * 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".
+     *
+     * @example
+     * ```ts
+     * {
+     *   "issues.opened": (e) => `Help with #${e.payload.issue.number}`,
+     *   "issue_comment.created": new Request(`${BACKEND}/github/runs`, {
+     *     headers: { "x-api-key": process.env.BACKEND_KEY! },
+     *   }),
+     * }
+     * ```
+     */
+    onEvent?: {
+        [K in SupportedEventKey]?: GitHubEventCallback<K> | EventEndpoint;
+    };
+    /**
+     * A delivery of a handled event is done, once, with how, to switch on by
+     * `type`: the run it started and how that run ended, as LangGraph names it
+     * (`run`), why it started none (`skipped`, such as a handler that returned
+     * nothing), or that MDA lost it (`failed`); and the decisions the thread
+     * waits on. Called after the App's own notices, such
+     * as the comment that a decision is pending, in the background; failures
+     * are logged. See `channels.http`'s `onFinish` for its limits.
+     *
+     * @example
+     * ```ts
+     * onFinish: async (event, thread, finished) => {
+     *   if (finished.type === "run" && finished.run.status === "success")
+     *     await reportRun(thread.id, finished.run.id);
+     * }
+     * ```
+     */
+    onFinish?: EventFinished<GitHubEvent, GitHubChannelThread>;
+    /**
+     * A delivery of a handled event reached its thread, once, with the event
+     * and its thread, before MDA reads the thread or asks the handler: the
+     * moment to acknowledge it, such as with a 👀 reaction. It fires even when
+     * the thread then waits on an interrupt, or the handler declines, so apply
+     * your own filters, such as a mention check. In the background, before
+     * `onFinish`; failures are logged and don't stop the run.
+     *
+     * @example
+     * ```ts
+     * onReceived: async (event) => {
+     *   if (event.name === "issue_comment") await reactEyes(event);
+     * }
+     * ```
+     */
+    onReceived?: EventReceived<GitHubEvent, GitHubChannelThread>;
+}
+/**
+ * What a GitHub channel POSTs an endpoint, for one event key or any: the
+ * event's key, delivery ID and payload, and, as a handler gets them, its
+ * `action`, `repository`, `sender` and the handles it `mentions`. Those are
+ * optional, so a receiver takes requests from older deployments.
+ */
+export type GitHubEndpointRequest<K extends SupportedEventKey = SupportedEventKey> = EndpointRequest<GitHubEvent<K>, (typeof ENDPOINT_EVENT_FIELDS)[number]>;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/channels/github/types.js

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

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

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

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

@@ -0,0 +1,137 @@
+import { z } from "zod";
+import type { ChannelRunResult } from "../run-input.js";
+/**
+ * The deployment's env var holding the secret it shares with your services:
+ * every endpoint request is signed with it, as Standard Webhooks does.
+ * Several, separated by whitespace or commas, each sign the request, for
+ * rotation.
+ */
+export declare const SERVICE_SECRET_ENV = "MDA_SERVICE_SECRET";
+/**
+ * Where an `onEvent` key's events go when a service of yours decides what
+ * they start: its URL, or a `Request` that also carries headers, such as a
+ * credential the service checks. See {@link endpointHandler}.
+ *
+ * @experimental This may change in a minor release.
+ */
+export type EventEndpoint = string | URL | Request;
+/** The key a Standard Webhooks secret stands for; a malformed one throws. */
+export declare function signingKey(secret: string): Buffer;
+/**
+ * The Standard Webhooks headers that sign one request with `keys`: none
+ * without a key. Each key signs `<id>.<timestamp>.<body>`.
+ */
+export declare function signatureHeaders(keys: readonly Buffer[], id: string, timestamp: number, body: string): Record<string, string>;
+/** A channel's event, by the fields every endpoint is sent. */
+type ChannelEvent = {
+    key: string;
+    deliveryId: string;
+    payload: unknown;
+};
+/** The fields of an event every endpoint is sent. */
+declare const EVENT_FIELDS: readonly ["key", "deliveryId", "payload"];
+/** A field any of a union of events has, such as a field of one kind only. */
+export type EventField<E> = E extends unknown ? keyof E : never;
+/**
+ * The event a channel sends its endpoint: the event key, the provider's
+ * delivery ID and its payload, and the channel's own fields `X`, such as
+ * GitHub's `repository` and `mentions`. A channel's own fields are optional,
+ * so a receiver takes requests from a deployment that sends fewer. For a
+ * union of events, each is typed by the key, with the fields of `X` it has.
+ *
+ * @experimental This may change in a minor release.
+ */
+export type EndpointEvent<E extends ChannelEvent = ChannelEvent, X extends PropertyKey = never> = E extends unknown ? Pick<E, (typeof EVENT_FIELDS)[number]> & Partial<Pick<E, Extract<X, keyof E>>> : never;
+/**
+ * The conversation's thread an endpoint request is about.
+ *
+ * @experimental This may change in a minor release.
+ */
+export interface EndpointThread {
+    /** The thread the run starts on, or that waits on an interrupt. */
+    id: string;
+    channel: {
+        name: string;
+    };
+    /** Set when the thread waits on an interrupt: no run starts, whatever the answer. */
+    interrupted?: true;
+}
+/**
+ * What a channel POSTs its endpoint: the event, and the thread it belongs to.
+ *
+ * @experimental This may change in a minor release.
+ */
+export interface EndpointRequest<E extends ChannelEvent = ChannelEvent, X extends PropertyKey = never> {
+    event: EndpointEvent<E, X>;
+    thread: EndpointThread;
+}
+declare const answerSchema: z.ZodObject<{
+    input: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodCustom<import("../types.js").JsonValue, import("../types.js").JsonValue>>]>;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<import("../types.js").JsonValue, import("../types.js").JsonValue>>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<import("../types.js").JsonValue, import("../types.js").JsonValue>>>;
+    webhook: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * What an endpoint answers: the run's input, as a handler returns it (text,
+ * or state such as `{ messages }`), with the run options a handler may set,
+ * all JSON. An endpoint answers `null` (or HTTP 204) instead to start nothing.
+ * The channel checks an answer against the same schema.
+ *
+ * @experimental This may change in a minor release.
+ */
+export type EndpointAnswer = z.infer<typeof answerSchema>;
+/** The handler an endpoint stands for; see {@link endpointHandler}. */
+export type EndpointCallback<E extends ChannelEvent = ChannelEvent> = (event: E, thread: EndpointThread) => Promise<ChannelRunResult | null>;
+/** Whether a handler is one an endpoint stands for. */
+export declare function isEndpointCallback(handler: unknown): boolean;
+/** Whether an `onEvent` value is an endpoint rather than a handler function. */
+export declare function isEventEndpoint(value: unknown): value is EventEndpoint;
+/**
+ * The handler an endpoint stands for. When the event's thread takes a turn,
+ * MDA POSTs `{ event: { key, deliveryId, payload }, thread: { id, channel,
+ * interrupted? } }` as JSON to the endpoint's URL, with the event's `fields`,
+ * the channel's own, beside the payload, and a `Request`'s headers,
+ * signed when the deployment has `MDA_SERVICE_SECRET`, and starts the
+ * run the service answers with: `{ input, context?, metadata?, webhook? }`.
+ * `null` or HTTP 204 starts nothing. A network error before the answer, HTTP
+ * 429 or a 5xx is tried again, up to three attempts. Any other answer, one cut
+ * off, a redirect, or no answer within 60 seconds fails the handler, as a
+ * handler that throws does.
+ * The URL is https, or http to a loopback host for local development, without
+ * credentials in it.
+ *
+ * The webhook ID is `msg_<deliveryId>` for the call that starts the run, and
+ * `msg_<deliveryId>_interrupted` for the one that asks whether to tell the
+ * conversation its thread waits on a decision.
+ */
+export declare function endpointHandler<E extends ChannelEvent = ChannelEvent, X extends EventField<E> & string = never>(endpoint: EventEndpoint, label: string, fields?: readonly X[]): EndpointCallback<E>;
+/** How long a service of yours may take, and how often MDA asks it. */
+export interface EndpointLimits {
+    /**
+     * How long the service may take to answer: each attempt, or, with `total`,
+     * all of them and the pauses between.
+     */
+    timeoutMs: number;
+    total?: boolean;
+    /**
+     * The pauses before trying again after a network error, HTTP 429 or a 5xx,
+     * each attempt with the same webhook ID, so a receiver that dedupes on it
+     * acts once.
+     */
+    retryDelaysMs: readonly number[];
+}
+/**
+ * Ask a service of yours: POST `body` as JSON, signed as webhook `id`, and
+ * return the JSON answer, or `null` for HTTP 204.
+ */
+export type AskEndpoint = (id: string, body: string, limits: EndpointLimits) => Promise<unknown>;
+/**
+ * The client of a service of yours that `endpoint` names, with a `Request`'s
+ * headers, signed when the deployment has `MDA_SERVICE_SECRET`. A bad URL or
+ * secret throws here, when the endpoint is declared. Any answer but JSON or
+ * HTTP 204, one cut off, a redirect, or a timeout throws; errors call the
+ * service `name`, such as `event endpoint`.
+ */
+export declare function endpointClient(endpoint: EventEndpoint, label: string, name: string): AskEndpoint;
+export {};
+//# sourceMappingURL=endpoint.d.ts.map

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

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