managed-deepagents 0.9.6-dev.15 → 0.9.6-dev.16

package/dist/channels/run-input.js

@@ -1,155 +0,0 @@
-/**
- * What a channel handler starts a run with, in the shapes `agent.invoke`
- * takes, normalized to the JSON the Agent Server accepts.
- */
-import { HumanMessage, coerceMessageLikeToMessage, isBaseMessage, } from "@langchain/core/messages";
-import { isJsonValue } from "./message-schema.js";
-import { isPlainObject } from "../values.js";
-/**
- * A handler's run input as `startIngressRun` takes it, with MDA's own
- * `metadata` over the handler's, so a handler can't replace it. Empty state
- * and metadata are left out.
- */
-export function runStartOptions(input, metadata = {}) {
-    const merged = { ...input.metadata, ...metadata };
-    return {
-        messages: input.messages,
-        ...(Object.keys(input.state).length && { state: input.state }),
-        ...(Object.keys(merged).length && { metadata: merged }),
-        ...(input.webhook !== undefined && { webhook: input.webhook }),
-    };
-}
-const MESSAGE_ROLES = new Set([
-    "human",
-    "ai",
-    "system",
-    "tool",
-]);
-/**
- * Normalize what a handler returned. `null` and `undefined` start nothing;
- * anything else that is not valid input throws a `TypeError`. A run option
- * that is `null` or `undefined` is not set.
- */
-export function normalizeRunInput(value) {
-    if (value === null || value === undefined)
-        return undefined;
-    const [input, options] = Array.isArray(value)
-        ? value
-        : [value, undefined];
-    if (Array.isArray(value) && value.length !== 2 && value.length !== 1)
-        throw new TypeError("run input must be [input, options]");
-    const normalized = normalizeInput(input);
-    if (options === undefined)
-        return normalized;
-    if (!isPlainObject(options))
-        throw new TypeError("run options must be an object");
-    const { context, metadata, webhook, ...rest } = options;
-    if (Object.keys(rest).length)
-        throw new TypeError(`unsupported run option ${Object.keys(rest).join(", ")}; use context, metadata or webhook`);
-    return {
-        ...normalized,
-        ...(context != null && { context: runContext(context) }),
-        ...(metadata != null && { metadata: runMetadata(metadata) }),
-        ...(webhook != null && { webhook: runWebhook(webhook) }),
-    };
-}
-const WEBHOOK_PREFIX = /^https?:\/\//i;
-// eslint-disable-next-line no-control-regex
-const UNSAFE_URL_CHARACTER = /[\s\u0000-\u001f\u007f]/;
-/**
- * The webhook as given, once it is `http://` or `https://`, a host and an
- * optional port, without credentials, whitespace or control characters. The
- * Python runtime checks it the same way, so both pass the Agent Server the
- * same string.
- */
-function runWebhook(webhook) {
-    let url;
-    try {
-        url =
-            typeof webhook === "string" &&
-                WEBHOOK_PREFIX.test(webhook) &&
-                !UNSAFE_URL_CHARACTER.test(webhook)
-                ? new URL(webhook)
-                : undefined;
-    }
-    catch {
-        url = undefined;
-    }
-    if (!url || !url.hostname || url.username || url.password)
-        throw new TypeError("run webhook must be an http(s) URL, without credentials in it");
-    return webhook;
-}
-function runContext(context) {
-    if (!isPlainObject(context) || !isJsonValue(context))
-        throw new TypeError("run context must be a JSON object");
-    for (const key of ["channel", "mda_channel"])
-        if (key in context)
-            throw new TypeError(`context.${key} is reserved for managed ingress`);
-    return context;
-}
-/** The metadata keys a handler may set. */
-const METADATA_KEY = /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/;
-/**
- * Keys MDA, the Agent Server and LangSmith set, which a handler's would
- * override or confuse (LangSmith groups a thread's runs by `thread_id`,
- * `session_id` or `conversation_id`), and object internals.
- */
-const RESERVED_METADATA_KEY = /^(mda_|langgraph_|ls_)|^(assistant_id|graph_id|run_id|run_attempt|thread_id|session_id|conversation_id|user_id|owner|checkpoint_id|checkpoint_ns|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 aren't reserved (${key})`);
-    }
-    return metadata;
-}
-function normalizeInput(input) {
-    if (typeof input === "string") {
-        if (!input.trim())
-            throw new TypeError("run input must not be blank");
-        return { messages: [messageJson(new HumanMessage(input))], state: {} };
-    }
-    if (isBaseMessage(input))
-        return { messages: [messageJson(input)], state: {} };
-    if (!isPlainObject(input))
-        throw new TypeError("run input must be a string, a message, or an object of state");
-    const { messages, ...state } = input;
-    if (messages !== undefined && !Array.isArray(messages))
-        throw new TypeError("run input messages must be an array");
-    if (!isJsonValue(state))
-        throw new TypeError("run input state must be JSON");
-    const normalized = (messages ?? []).map(messageLike);
-    if (!normalized.length && !Object.keys(state).length)
-        throw new TypeError("run input must not be empty");
-    return { messages: normalized, state: state };
-}
-function messageLike(message) {
-    if (typeof message === "string" && !message.trim())
-        throw new TypeError("a message must not be blank");
-    try {
-        return messageJson(coerceMessageLikeToMessage(message));
-    }
-    catch (error) {
-        if (error instanceof TypeError)
-            throw error;
-        throw new TypeError("a message must be a string, a message, or JSON");
-    }
-}
-/**
- * A message as the JSON the Agent Server turns back into a message: its
- * `toDict()` fields with a `role`. `toDict()` puts content built from
- * `contentBlocks` under `content_blocks`, which the server does not read, so
- * the message's `content` is sent instead.
- */
-function messageJson(message) {
-    const role = message.getType();
-    if (!MESSAGE_ROLES.has(role))
-        throw new TypeError(`unsupported message type ${role}`);
-    const { content_blocks: _blocks, ...fields } = message.toDict().data;
-    const json = { ...fields, role, content: message.content };
-    if (!isJsonValue(json))
-        throw new TypeError("a message must be JSON");
-    return json;
-}
-//# sourceMappingURL=run-input.js.map

package/dist/channels/run-input.js.map

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

package/dist/channels/slack/connections.d.ts

@@ -1,6 +0,0 @@
-/**
- * Reserved agent connection for the Slack channel's app: reading it returns
- * the app's bot token, to call Slack's Web API as the app.
- */
-export declare const SLACK_BOT_TOKEN_SLUG = "mda/slack-bot-token";
-//# sourceMappingURL=connections.d.ts.map

package/dist/channels/slack/connections.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/connections.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,wBAAwB,CAAC"}

package/dist/channels/slack/connections.js

@@ -1,6 +0,0 @@
-/**
- * Reserved agent connection for the Slack channel's app: reading it returns
- * the app's bot token, to call Slack's Web API as the app.
- */
-export const SLACK_BOT_TOKEN_SLUG = "mda/slack-bot-token";
-//# sourceMappingURL=connections.js.map

package/dist/channels/slack/connections.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"connections.js","sourceRoot":"","sources":["../../../src/channels/slack/connections.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC"}

package/dist/channels/slack/events.d.ts

@@ -1,272 +0,0 @@
-/**
- * The Slack messages a channel's `onEvent` handlers see: which kind of
- * message each is, and the message as a handler reads it.
- */
-import type { MultitaskStrategy } from "../../ingress/runs.js";
-import type { JsonValue } from "../types.js";
-import type { ChannelRunResult } from "../run-input.js";
-import type { TriggerChannelMessageEvent, TriggerChannelUserPromptResponseEvent } from "../trigger/types.js";
-import type { EndpointRequest, EventEndpoint } from "../http/endpoint.js";
-import { type EventFinished, type EventThread } from "../http/provider.js";
-import type { ChannelActor, SlackActor } from "../actor.js";
-export declare const SLACK_MESSAGE_KEYS: readonly ["mention", "directMessage", "message"];
-export declare const SLACK_EVENT_KEYS: readonly ["mention", "directMessage", "message", "interaction"];
-/**
- * Which kind of Slack message reached the agent:
- * - `"mention"`: a channel message that @-mentions your agent.
- * - `"directMessage"`: a direct message to your agent.
- * - `"message"`: any other channel message, which only `triggerMode`
- *   `"thread"` or `"all"` delivers.
- */
-export type SlackMessageKey = (typeof SLACK_MESSAGE_KEYS)[number];
-/**
- * What reached the agent from Slack: a kind of message
- * ({@link SlackMessageKey}), or `"interaction"`, a click on a button in a
- * message your agent posted with its own blocks, or a submitted modal it
- * opened, that answers no decision the thread waits on.
- */
-export type SlackEventKey = (typeof SLACK_EVENT_KEYS)[number];
-/** A file attached to a Slack message, as Slack describes it. */
-export interface SlackFile {
-    id: string;
-    name?: string;
-    mimetype?: string;
-    /** Size in bytes. */
-    size?: number;
-}
-/**
- * A Slack message that reached the agent. The run it starts can read its
- * files under `/workspace/attachments`, as without a handler.
- */
-export interface SlackMessageEvent<K extends SlackMessageKey = SlackMessageKey> {
-    key: K;
-    /** Trigger Server's ID for this delivery. */
-    deliveryId: string;
-    /** The message's text as Slack sent it, with mentions as `<@U123>`. */
-    text: string;
-    /** The Slack user who sent it; absent for some bot messages. */
-    userId?: string;
-    /** The Slack conversation: a channel's or a direct message's ID. */
-    channelId: string;
-    /** The message's timestamp, its ID in Slack. */
-    messageTs: string;
-    /** The timestamp of its thread's first message; `messageTs` when it starts one. */
-    threadTs: string;
-    files: SlackFile[];
-    /** The Slack event as Slack sent it, from the Events API. */
-    payload: {
-        readonly [key: string]: JsonValue;
-    };
-    /**
-     * The Slack user who sent the message, as Trigger Server verified it from
-     * Slack's signed request, in the shape every channel's `actor` has. Its
-     * `teamId` is their own workspace, which in a Slack Connect channel isn't
-     * your app's. Absent when Trigger Server names no one, such as an older
-     * Trigger Server or a message from a bot. It is personal data: MDA neither
-     * logs it nor adds it to the run's metadata.
-     */
-    actor?: SlackActor;
-}
-/**
- * A click on a button in a message your agent posted with its own blocks, or
- * a submitted modal it opened, as Trigger Server forwards it: one that
- * answers no decision the thread waits on. A click on a decision's buttons
- * resumes the run instead.
- */
-export interface SlackInteractionEvent {
-    key: "interaction";
-    /** Trigger Server's ID for this delivery. */
-    deliveryId: string;
-    /** The button's `action_id`, or the modal's `callback_id`. */
-    actionId: string;
-    /** The button's `value`, or the modal's `state.values`. */
-    value?: JsonValue;
-    /** The Slack user who clicked, as Slack's payload says. */
-    userId?: string;
-    /** The Slack conversation the message is in. */
-    channelId: string;
-    /** The timestamp of the message holding the button; absent for a modal. */
-    messageTs?: string;
-    /** The timestamp of its thread's first message. */
-    threadTs: string;
-    /**
-     * Slack's interaction payload, such as a `block_actions` one, with its
-     * `response_url` and `actions`, without its verification `token`.
-     */
-    payload: {
-        readonly [key: string]: JsonValue;
-    };
-    /**
-     * The Slack user who clicked, as Trigger Server verified it; see
-     * {@link SlackMessageEvent.actor}.
-     */
-    actor?: SlackActor;
-}
-type SlackEventUnion = {
-    [K in SlackMessageKey]: SlackMessageEvent<K>;
-}[SlackMessageKey] | SlackInteractionEvent;
-/** What reached the agent from Slack, typed by its key. */
-export type SlackEvent<K extends SlackEventKey = SlackEventKey> = Extract<SlackEventUnion, {
-    key: K;
-}>;
-/**
- * The conversation's thread a message belongs to. A handler runs before any
- * run exists, so this is not a run's runtime.
- */
-export interface SlackChannelThread extends EventThread {
-    /**
-     * The thread the run the handler starts runs on, one per Slack thread.
-     * Useful for run context that names the thread, such as a token a backend
-     * signs for it.
-     */
-    id: string;
-    /** The key the thread is derived from, which names the Slack thread. */
-    sourceThreadKey: string;
-}
-/** The Slack thread of a Trigger message's thread, for a channel named `name`. */
-export declare function slackThread(thread: {
-    id: string;
-    sourceThreadKey: string;
-}, name: string): SlackChannelThread;
-/**
- * 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, webhook }]`.
- * `null` or `undefined` starts nothing.
- */
-export type SlackEventResult = ChannelRunResult | null | undefined | void;
-export type SlackEventCallback<K extends SlackEventKey = SlackEventKey> = (event: SlackEvent<K>, thread: SlackChannelThread) => SlackEventResult | Promise<SlackEventResult>;
-/** The `channels.slack(...)` options that decide what each message starts. */
-export interface SlackEventOptions {
-    /**
-     * Handlers that decide what each kind of message starts. Return a prompt
-     * (string, message, or state), optionally with run options as
-     * `[input, { context, metadata, webhook }]`, or nothing to start no run:
-     * then the agent doesn't react or reply. A message kind without a handler
-     * starts a run with the message, as without `onEvent`. The run's reply is
-     * posted in the message's thread.
-     *
-     * `interaction` decides what a click on a button your agent posted with
-     * its own blocks starts, such as the next prompt, or `null` after
-     * recording it. Without one, such a click starts a run with no new
-     * message, which reads the click from `runtime.channel.event`. A click
-     * that answers a decision the thread waits on resumes the run, and never
-     * reaches it.
-     *
-     * @example
-     * ```ts
-     * onEvent: {
-     *   mention: (event) => [event.text, { metadata: { slack_channel: event.channelId } }],
-     *   message: () => null,
-     *   interaction: (event) =>
-     *     event.actionId === "quick_reply" ? String(event.value) : null,
-     * }
-     * ```
-     *
-     * A handler may also be an endpoint, a URL or a `Request` carrying
-     * headers, to have a service of yours decide: MDA answers Trigger Server,
-     * then POSTs the endpoint the message and its thread, and starts the run it
-     * answers with. See the README's "Asking your service what to start".
-     */
-    onEvent?: {
-        [K in SlackEventKey]?: SlackEventCallback<K> | EventEndpoint;
-    };
-    /**
-     * What a message that starts a run 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.
-     */
-    multitaskStrategy?: MultitaskStrategy;
-    /**
-     * Called once when a message or an `interaction` is done, with the event,
-     * its thread, and how it finished:
-     *
-     * - `run`: it started a run, which ended with `run.status`
-     *   (`success`, `error`, `timeout` or `interrupted`). `interrupts` lists
-     *   the decisions the thread waits on.
-     * - `skipped`: no run started. The handler returned nothing or failed
-     *   (`ignored`), or the thread was busy under `multitaskStrategy:
-     *   "reject"` (`rejected`).
-     * - `failed`: MDA couldn't start the run, or lost track of it.
-     *
-     * It runs in the background after the reply; errors are logged. Interrupt
-     * resumes don't call it, and neither does a message Trigger Server will
-     * send again because its run couldn't start. It runs in the deployment's process, so a restart
-     * loses it: use the run's `webhook` for anything you can't miss.
-     *
-     * @example
-     * ```ts
-     * onFinish: async (event, thread, finished) => {
-     *   if (finished.type !== "run") return;
-     *   if (finished.run.status === "success") {
-     *     // e.g. record the answer in your service, or update memory
-     *   } else {
-     *     // e.g. alert someone that the run failed
-     *   }
-     * }
-     * ```
-     */
-    onFinish?: EventFinished<SlackEvent, SlackChannelThread>;
-}
-/**
- * A Slack event's fields its endpoints are sent beside its key, delivery ID
- * and payload, those its kind has: the one list of them, so
- * `SlackEndpointRequest` is typed by it.
- */
-export declare const SLACK_ENDPOINT_EVENT_FIELDS: readonly ["text", "userId", "channelId", "messageTs", "threadTs", "files", "actor", "actionId", "value"];
-/** What a Slack channel POSTs an endpoint, for one event key or any. */
-export type SlackEndpointRequest<K extends SlackEventKey = SlackEventKey> = EndpointRequest<SlackEvent<K>, (typeof SLACK_ENDPOINT_EVENT_FIELDS)[number]>;
-/**
- * Which kind of message a delivery is. Slack sends a mention as
- * `app_mention` under `triggerMode` `"mention"`, and as a `message` that
- * names the app's bot user under `"thread"` and `"all"`, so only a channel
- * `message` asks who the bot is.
- */
-export declare function slackEventKey(rawEvent: Record<string, unknown>): Promise<SlackMessageKey>;
-/**
- * Whether a delivery is surely a plain channel message, neither a mention
- * nor a direct message. One that names a user while the bot user is unknown
- * may be a mention, so it isn't.
- */
-export declare function isPlainSlackMessage(rawEvent: Record<string, unknown>): Promise<boolean>;
-/** Forget the bot user's ID; for tests. */
-export declare function resetSlackBotUser(): void;
-/**
- * What a delivery carries: a message, of the kind Slack's event says, or an
- * interaction; `undefined` when it has nothing to read one from.
- */
-export declare function readSlackEvent(event: TriggerChannelMessageEvent | TriggerChannelUserPromptResponseEvent, actor?: ChannelActor): Promise<SlackEvent | undefined>;
-/**
- * The `SlackEvent` a handler got for each delivery, so `onFinish` gets that
- * same event rather than reading the delivery again, which could read it as
- * another kind. A delivery that never finishes, such as one Trigger Server
- * sends again, is dropped once there are many.
- */
-export declare class DecidedSlackEvents {
-    #private;
-    remember(deliveryId: string, event: SlackEvent): void;
-    /**
-     * What a finished delivery carried: as its handler got it, or read from the
-     * delivery, with its verified actor, when no handler did.
-     */
-    finished(rawEvent: JsonValue | undefined): Promise<SlackEvent | undefined>;
-}
-/**
- * The Trigger delivery a finished message or interaction carries; see
- * `TriggerFinishedEvent`.
- */
-export declare function finishedDelivery(rawEvent: JsonValue | undefined): TriggerChannelMessageEvent | TriggerChannelUserPromptResponseEvent | undefined;
-/**
- * The message a delivery carries, as a handler reads it, or `undefined` when
- * the delivery has no Slack event to read it from.
- */
-export declare function slackEvent<K extends SlackMessageKey>(key: K, event: TriggerChannelMessageEvent, actor?: ChannelActor): SlackMessageEvent<K> | undefined;
-/**
- * The interaction a forwarded click or modal submission carries, as a
- * handler reads it, or `undefined` without the conversation it happened in.
- */
-export declare function slackInteractionEvent(event: TriggerChannelUserPromptResponseEvent, actor?: ChannelActor): SlackInteractionEvent | undefined;
-export type { SlackActor } from "../actor.js";
-//# sourceMappingURL=events.d.ts.map

package/dist/channels/slack/events.d.ts.map

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