managed-deepagents 0.5.4-dev.9 → 0.6.0

package/dist/channels/trigger/client.js

@@ -0,0 +1,118 @@
+import { fetchWithTimeout, PROVIDER_HTTP_TIMEOUT_MS, } from "../../runtime/http.js";
+import { normalizeUuid } from "./uuid.js";
+export const LANGSMITH_MDA_TRIGGER_SERVER_URL_ENV = "LANGSMITH_MDA_TRIGGER_SERVER_URL";
+export const TRIGGER_HTTP_TIMEOUT_MS = PROVIDER_HTTP_TIMEOUT_MS;
+/** Fixed-message callback error safe for logs and diagnostics. */
+export class TriggerClientError extends Error {
+    operation;
+    status;
+    constructor(operation, status) {
+        super(`Trigger Server ${operation} request failed${status === undefined ? "" : ` with status ${status}`}`);
+        this.operation = operation;
+        this.status = status;
+        this.name = "TriggerClientError";
+    }
+}
+/** Minimal Trigger Server client authenticated by the hosted server key. */
+export class TriggerClient {
+    #apiBase;
+    #apiKey;
+    #userId;
+    #fetch;
+    #timeoutMs;
+    constructor(options = {}) {
+        const env = options.env ?? process.env;
+        this.#apiBase = triggerServerApiBase(configuredTriggerServerUrl(env));
+        const apiKey = env.LANGSMITH_API_KEY?.trim();
+        if (!apiKey) {
+            throw new Error("LANGSMITH_API_KEY is required for Trigger Server calls");
+        }
+        this.#apiKey = apiKey;
+        this.#userId = normalizeUuid(options.userId);
+        this.#fetch = options.fetch ?? fetch;
+        this.#timeoutMs = options.timeoutMs ?? TRIGGER_HTTP_TIMEOUT_MS;
+    }
+    async postAction(channelId, body) {
+        const response = await this.#post("actions", channelId, body);
+        if (!isRecord(response) || !nonblank(response.id)) {
+            throw new TriggerClientError("actions");
+        }
+        return { id: response.id };
+    }
+    async postRuntimeEvent(channelId, body) {
+        const response = await this.#post("events", channelId, body);
+        if (!isRecord(response) || typeof response.status !== "string") {
+            throw new TriggerClientError("events");
+        }
+        return { status: response.status };
+    }
+    async #post(operation, channelId, body) {
+        let response;
+        try {
+            response = await fetchWithTimeout(`${this.#apiBase}/channels/${encodeURIComponent(channelId)}/${operation}`, {
+                method: "POST",
+                redirect: "error",
+                headers: {
+                    "content-type": "application/json",
+                    "x-api-key": this.#apiKey,
+                    ...(this.#userId ? { "x-user-id": this.#userId } : {}),
+                },
+                body: JSON.stringify(body),
+            }, this.#timeoutMs, this.#fetch);
+        }
+        catch {
+            throw new TriggerClientError(operation);
+        }
+        if (!response.ok) {
+            throw new TriggerClientError(operation, response.status);
+        }
+        try {
+            return await response.json();
+        }
+        catch {
+            throw new TriggerClientError(operation);
+        }
+    }
+}
+export function createTriggerClient(options = {}) {
+    const env = options.env ?? process.env;
+    if (!configuredTriggerServerUrl(env) || !env.LANGSMITH_API_KEY?.trim()) {
+        return undefined;
+    }
+    return new TriggerClient(options);
+}
+function configuredTriggerServerUrl(env) {
+    return env[LANGSMITH_MDA_TRIGGER_SERVER_URL_ENV]?.trim() || undefined;
+}
+function triggerServerApiBase(raw) {
+    if (!raw) {
+        throw new Error(`${LANGSMITH_MDA_TRIGGER_SERVER_URL_ENV} is required`);
+    }
+    if (!/^https:\/\/[^/\\?#]+(?:\/|\/v1\/?)?$/i.test(raw)) {
+        throw new Error("Trigger Server URL must be an HTTPS API base");
+    }
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new Error("Trigger Server URL must be an HTTPS API base");
+    }
+    if (url.protocol !== "https:" ||
+        !url.hostname ||
+        url.username ||
+        url.password ||
+        !["/", "/v1", "/v1/"].includes(url.pathname) ||
+        url.search ||
+        url.hash) {
+        throw new Error("Trigger Server URL must be an HTTPS API base");
+    }
+    return `${url.origin}/v1`;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function nonblank(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+//# sourceMappingURL=client.js.map

package/dist/channels/trigger/client.js.map

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

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

@@ -0,0 +1,36 @@
+import { type ObservedIngressRun, type StartedIngressRun } from "../../ingress/index.js";
+import { type TriggerClientLike } from "./client.js";
+import { type TriggerChannelResume } from "./types.js";
+export { TRIGGER_SERVICE_KEY_HEADER } from "./types.js";
+export declare const ASSISTANT_ID_ENV = "MDA_ASSISTANT_ID";
+type StartAgent = (input: {
+    threadId: string;
+    assistantId: string;
+    messages: Record<string, unknown>[];
+    sourceProvider: string;
+    sourceThreadKey: string;
+}) => Promise<StartedIngressRun>;
+type ObserveAgent = (input: {
+    threadId: string;
+    runId: string;
+}) => Promise<ObservedIngressRun>;
+type ResumeAgent = (input: {
+    threadId: string;
+    assistantId: string;
+    resume: TriggerChannelResume;
+    sourceProvider: string;
+    sourceThreadKey: string;
+}) => Promise<StartedIngressRun>;
+export interface TriggerChannelHttpOptions {
+    sourceProvider: string;
+    assistantId?: string;
+    rawBody?: string | Uint8Array;
+    schedule?: (work: () => Promise<void>) => void;
+    startAgent?: StartAgent;
+    resumeAgent?: ResumeAgent;
+    observeAgent?: ObserveAgent;
+    triggerClient?: TriggerClientLike;
+}
+/** Validate one Trigger message, start its run, and enqueue observation. */
+export declare function handleTriggerChannelEventRequest(request: Request, options: TriggerChannelHttpOptions): Promise<Response>;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/channels/trigger/http.ts"],"names":[],"mappings":"AAMA,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAKL,KAAK,oBAAoB,EAG1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEjC,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAElC,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEjC,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC/C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED,4EAA4E;AAC5E,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,QAAQ,CAAC,CAgGnB"}

package/dist/channels/trigger/http.js

@@ -0,0 +1,186 @@
+import { randomUUID } from "node:crypto";
+import { v5 as uuidv5 } from "uuid";
+import { extractAssistantText } from "../assistant-text.js";
+import { logger } from "../../runtime/log.js";
+import { observeIngressAgent, resumeIngressAgent, scheduleIngressWork, startIngressAgent, } from "../../ingress/index.js";
+import { createTriggerClient, LANGSMITH_MDA_TRIGGER_SERVER_URL_ENV, TriggerClientError, } from "./client.js";
+import { parseTriggerChannelEvent, TRIGGER_SERVICE_KEY_HEADER, } from "./types.js";
+export { TRIGGER_SERVICE_KEY_HEADER } from "./types.js";
+export const ASSISTANT_ID_ENV = "MDA_ASSISTANT_ID";
+/** Validate one Trigger message, start its run, and enqueue observation. */
+export async function handleTriggerChannelEventRequest(request, options) {
+    if (!request.headers.get(TRIGGER_SERVICE_KEY_HEADER)?.trim()) {
+        return Response.json({ error: "unauthorized" }, { status: 401 });
+    }
+    let event;
+    try {
+        const raw = await requestBody(request, options.rawBody);
+        event = parseTriggerChannelEvent(JSON.parse(raw));
+    }
+    catch {
+        logger.warn("invalid channel event");
+        return Response.json({ error: "invalid channel event" }, { status: 400 });
+    }
+    logger.info(`Trigger channel incoming event (type=${event.type}, event_id=${logger.logIdentifier(event.event_id)}, delivery_id=${logger.logIdentifier(event.delivery_id)}, channel_id=${logger.logIdentifier(event.channel_id)})`);
+    let client = options.triggerClient;
+    if (!client) {
+        try {
+            client = createTriggerClient({
+                userId: request.headers.get("x-user-id") ?? undefined,
+            });
+            if (!client) {
+                logger.error(`channel transport is not configured (${LANGSMITH_MDA_TRIGGER_SERVER_URL_ENV} and LANGSMITH_API_KEY are required)`);
+            }
+        }
+        catch (error) {
+            logger.error(`channel transport is not configured (${logger.safeErrorLabel(error)})`);
+            client = undefined;
+        }
+    }
+    if (!client) {
+        return Response.json({ error: "channel transport is not configured" }, { status: 500 });
+    }
+    const assistantId = resolveAssistantId(options.assistantId);
+    if (!assistantId) {
+        logger.error(`${ASSISTANT_ID_ENV} is not configured`);
+        return Response.json({ error: "channel runtime is not configured" }, { status: 500 });
+    }
+    let started;
+    try {
+        const common = {
+            threadId: triggerThreadId(event.source_thread_key),
+            assistantId,
+            sourceProvider: options.sourceProvider,
+            sourceThreadKey: event.source_thread_key,
+        };
+        started =
+            event.type === "message"
+                ? await (options.startAgent ?? startIngressAgent)({
+                    ...common,
+                    messages: event.input.messages,
+                })
+                : await (options.resumeAgent ?? resumeIngressAgent)({
+                    ...common,
+                    resume: event.interaction.resume,
+                });
+    }
+    catch (error) {
+        logger.error(`channel run could not be started (${logger.safeErrorLabel(error)})`);
+        return Response.json({ error: "channel run could not be started" }, { status: 500 });
+    }
+    scheduleIngressWork(() => observeAcceptedRun({
+        event,
+        started,
+        client,
+        observeAgent: options.observeAgent,
+    }), {
+        label: "Trigger channel run observation",
+        schedule: options.schedule,
+    });
+    return Response.json({ status: "accepted", delivery_id: event.delivery_id }, { status: 202 });
+}
+async function observeAcceptedRun(input) {
+    const { event, started, client } = input;
+    const lifecycle = (type, interrupts) => {
+        logger.info(`Trigger channel outgoing event (type=${type}, delivery_id=${logger.logIdentifier(event.delivery_id)}, channel_id=${logger.logIdentifier(event.channel_id)}, run_id=${logger.logIdentifier(started.runId)})`);
+        return bestEffort(client.postRuntimeEvent(event.channel_id, runtimeEvent(type, event, started, interrupts)));
+    };
+    await lifecycle("run.started");
+    let observed;
+    try {
+        observed = await (input.observeAgent ?? observeIngressAgent)({
+            threadId: started.threadId,
+            runId: started.runId,
+        });
+    }
+    catch {
+        await lifecycle("run.failed");
+        return;
+    }
+    if (isInterruptedRun(observed)) {
+        await lifecycle("run.interrupted", interruptEntries(observed.values).filter((entry) => isRecord(entry) &&
+            typeof entry.id === "string" &&
+            entry.id.trim().length > 0 &&
+            "value" in entry));
+        return;
+    }
+    if (observed.status !== "success") {
+        await lifecycle("run.failed");
+        return;
+    }
+    const text = extractAssistantText(isRecord(observed.values) ? observed.values : {});
+    if (text) {
+        logger.info(`Trigger channel outgoing action (type=post, delivery_id=${logger.logIdentifier(event.delivery_id)}, channel_id=${logger.logIdentifier(event.channel_id)}, run_id=${logger.logIdentifier(started.runId)})`);
+        const action = await bestEffort(client.postAction(event.channel_id, {
+            type: "post",
+            action_id: randomUUID(),
+            address: event.address,
+            source_thread_key: event.source_thread_key,
+            message: { text },
+        }));
+        if (action === undefined) {
+            await lifecycle("run.failed");
+            return;
+        }
+    }
+    await lifecycle("run.completed");
+}
+function runtimeEvent(type, event, started, interrupts) {
+    return {
+        id: randomUUID(),
+        type,
+        delivery_id: event.delivery_id,
+        source_thread_key: event.source_thread_key,
+        address: event.address,
+        run_thread_id: started.threadId,
+        run_id: started.runId,
+        ...(interrupts?.length ? { interrupts } : {}),
+    };
+}
+function triggerThreadId(sourceThreadKey) {
+    return uuidv5(sourceThreadKey, uuidv5.URL);
+}
+function resolveAssistantId(override) {
+    return override?.trim() || process.env[ASSISTANT_ID_ENV]?.trim() || undefined;
+}
+async function requestBody(request, rawBody) {
+    if (typeof rawBody === "string")
+        return rawBody;
+    const bytes = rawBody ?? new Uint8Array(await request.arrayBuffer());
+    return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+}
+async function bestEffort(promise) {
+    try {
+        return await promise;
+    }
+    catch (error) {
+        if (error instanceof TriggerClientError) {
+            logger.warn(`Trigger Server ${error.operation} callback failed${error.status === undefined ? "" : ` (HTTP ${error.status})`}`);
+        }
+        else {
+            logger.warn("Trigger Server callback failed");
+        }
+        return undefined;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isInterruptedRun(observed) {
+    // Agent Server can report status "success" after join while values still
+    // carry `__interrupt__`. Trust either signal.
+    return observed.status === "interrupted" || hasInterrupt(observed.values);
+}
+function hasInterrupt(values) {
+    return interruptEntries(values).length > 0;
+}
+/** `__interrupt__` arrives as a flat list, or keyed by task id. */
+function interruptEntries(values) {
+    if (!isRecord(values))
+        return [];
+    const raw = values.__interrupt__;
+    if (Array.isArray(raw))
+        return raw;
+    return isRecord(raw) ? Object.values(raw).flat() : [];
+}
+//# sourceMappingURL=http.js.map

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

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

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

@@ -0,0 +1,108 @@
+import { z } from "zod";
+export declare const TRIGGER_SERVICE_KEY_HEADER = "x-service-key";
+/** Provider-owned address fields are opaque to MDA. */
+declare const opaqueObject: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+declare const messageEventSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1">;
+    event_id: z.ZodString;
+    delivery_id: z.ZodString;
+    created_at: z.ZodString;
+    channel_id: z.ZodString;
+    source_thread_key: z.ZodString;
+    address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    type: z.ZodLiteral<"message">;
+    input: z.ZodObject<{
+        messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const interruptResumeEventSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1">;
+    event_id: z.ZodString;
+    delivery_id: z.ZodString;
+    created_at: z.ZodString;
+    channel_id: z.ZodString;
+    source_thread_key: z.ZodString;
+    address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    type: z.ZodLiteral<"interrupt_resume">;
+    interaction: z.ZodObject<{
+        type: z.ZodLiteral<"interrupt_resume">;
+        resume: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const eventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    version: z.ZodLiteral<"1">;
+    event_id: z.ZodString;
+    delivery_id: z.ZodString;
+    created_at: z.ZodString;
+    channel_id: z.ZodString;
+    source_thread_key: z.ZodString;
+    address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    type: z.ZodLiteral<"message">;
+    input: z.ZodObject<{
+        messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    version: z.ZodLiteral<"1">;
+    event_id: z.ZodString;
+    delivery_id: z.ZodString;
+    created_at: z.ZodString;
+    channel_id: z.ZodString;
+    source_thread_key: z.ZodString;
+    address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    type: z.ZodLiteral<"interrupt_resume">;
+    interaction: z.ZodObject<{
+        type: z.ZodLiteral<"interrupt_resume">;
+        resume: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+export type TriggerChannelAddress = z.infer<typeof opaqueObject>;
+export type TriggerChannelMessageInput = z.infer<typeof messageEventSchema.shape.input>;
+export type TriggerChannelMessageEvent = z.infer<typeof messageEventSchema>;
+export type TriggerChannelInterruptResumeEvent = z.infer<typeof interruptResumeEventSchema>;
+/** Keyed LangGraph resume: `{ [interruptId]: value }`. Values are opaque (`interrupt()` results or HITL `{ decisions }`). */
+export type TriggerChannelResume = TriggerChannelInterruptResumeEvent["interaction"]["resume"];
+export type TriggerChannelEvent = z.infer<typeof eventSchema>;
+export interface TriggerChannelActionRequest {
+    type: "post";
+    action_id: string;
+    address: TriggerChannelAddress;
+    source_thread_key: string;
+    message: {
+        text: string;
+    };
+}
+export interface TriggerChannelActionResponse {
+    id: string;
+}
+export type TriggerChannelRuntimeEventType = "run.started" | "run.completed" | "run.interrupted" | "run.failed";
+/**
+ * One pending LangGraph interrupt, forwarded verbatim on `run.interrupted`.
+ *
+ * `id` is the resume key the Trigger Server sends back in
+ * `interaction.resume`; `value` is opaque to MDA.
+ */
+export interface TriggerChannelInterrupt {
+    id: string;
+    value: unknown;
+}
+export interface TriggerChannelRuntimeEventRequest {
+    id: string;
+    type: TriggerChannelRuntimeEventType;
+    delivery_id: string;
+    source_thread_key: string;
+    address: TriggerChannelAddress;
+    run_thread_id: string;
+    run_id: string;
+    /**
+     * Present on `run.interrupted`. The Trigger Server cannot read the
+     * deployment's threads, so pending interrupts travel on the event itself.
+     */
+    interrupts?: TriggerChannelInterrupt[];
+}
+export interface TriggerChannelRuntimeEventResponse {
+    status: string;
+}
+/** Validate the envelope while retaining all original opaque object identities. */
+export declare function parseTriggerChannelEvent(value: unknown): TriggerChannelEvent;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/channels/trigger/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,0BAA0B,kBAAkB,CAAC;AAK1D,uDAAuD;AACvD,QAAA,MAAM,YAAY,wCAAoC,CAAC;AAevD,QAAA,MAAM,kBAAkB;;;;;;;;;;;;iBAKtB,CAAC;AACH,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;iBAM9B,CAAC;AACH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;2BAGf,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACjE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CACtC,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC5E,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,0BAA0B,CAClC,CAAC;AACF,6HAA6H;AAC7H,MAAM,MAAM,oBAAoB,GAC9B,kCAAkC,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAE9D,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,8BAA8B,GACtC,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,YAAY,CAAC;AAEjB;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iCAAiC;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,8BAA8B,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAG5E"}

package/dist/channels/trigger/types.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { normalizeUuid } from "./uuid.js";
+export const TRIGGER_SERVICE_KEY_HEADER = "x-service-key";
+const nonblankString = z.string().refine((value) => value.trim().length > 0, {
+    message: "must be nonblank",
+});
+/** Provider-owned address fields are opaque to MDA. */
+const opaqueObject = z.record(z.string(), z.unknown());
+const channelId = z
+    .string()
+    .refine((value) => normalizeUuid(value) !== undefined, {
+    message: "Invalid UUID",
+});
+const channelEventBase = z.object({
+    version: z.literal("1"),
+    event_id: nonblankString,
+    delivery_id: nonblankString,
+    created_at: nonblankString,
+    channel_id: channelId,
+    source_thread_key: nonblankString,
+    address: opaqueObject,
+});
+const messageEventSchema = channelEventBase.extend({
+    type: z.literal("message"),
+    input: z.object({
+        messages: z.array(opaqueObject),
+    }),
+});
+const interruptResumeEventSchema = channelEventBase.extend({
+    type: z.literal("interrupt_resume"),
+    interaction: z.object({
+        type: z.literal("interrupt_resume"),
+        resume: opaqueObject,
+    }),
+});
+const eventSchema = z.discriminatedUnion("type", [
+    messageEventSchema,
+    interruptResumeEventSchema,
+]);
+/** Validate the envelope while retaining all original opaque object identities. */
+export function parseTriggerChannelEvent(value) {
+    eventSchema.parse(value);
+    return value;
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/channels/trigger/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,0BAA0B,GAAG,eAAe,CAAC;AAE1D,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE;IAC3E,OAAO,EAAE,kBAAkB;CAC5B,CAAC,CAAC;AACH,uDAAuD;AACvD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACvD,MAAM,SAAS,GAAG,CAAC;KAChB,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE;IACrD,OAAO,EAAE,cAAc;CACxB,CAAC,CAAC;AACL,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IACvB,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,cAAc;IAC3B,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE,SAAS;IACrB,iBAAiB,EAAE,cAAc;IACjC,OAAO,EAAE,YAAY;CACtB,CAAC,CAAC;AACH,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;KAChC,CAAC;CACH,CAAC,CAAC;AACH,MAAM,0BAA0B,GAAG,gBAAgB,CAAC,MAAM,CAAC;IACzD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACnC,MAAM,EAAE,YAAY;KACrB,CAAC;CACH,CAAC,CAAC;AACH,MAAM,WAAW,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC/C,kBAAkB;IAClB,0BAA0B;CAC3B,CAAC,CAAC;AA+DH,mFAAmF;AACnF,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,KAA4B,CAAC;AACtC,CAAC"}

package/dist/channels/trigger/uuid.d.ts

@@ -0,0 +1,3 @@
+/** Match Python's `uuid.UUID(string)` spellings and return canonical text. */
+export declare function normalizeUuid(value: unknown): string | undefined;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/channels/trigger/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../../src/channels/trigger/uuid.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAmBhE"}

package/dist/channels/trigger/uuid.js

@@ -0,0 +1,22 @@
+/** Match Python's `uuid.UUID(string)` spellings and return canonical text. */
+export function normalizeUuid(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const compact = value
+        .replaceAll("urn:", "")
+        .replaceAll("uuid:", "")
+        .replace(/^[{}]+/, "")
+        .replace(/[{}]+$/, "")
+        .replaceAll("-", "");
+    if (!/^[0-9a-fA-F]{32}$/.test(compact))
+        return undefined;
+    const hex = compact.toLowerCase();
+    return [
+        hex.slice(0, 8),
+        hex.slice(8, 12),
+        hex.slice(12, 16),
+        hex.slice(16, 20),
+        hex.slice(20),
+    ].join("-");
+}
+//# sourceMappingURL=uuid.js.map

package/dist/channels/trigger/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../src/channels/trigger/uuid.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhD,MAAM,OAAO,GAAG,KAAK;SAClB,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;SACtB,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzD,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAClC,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAChB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;KACd,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -39,7 +39,8 @@ export type { ScheduleConfig, ScheduleDefinition, ScheduleDeliveryTarget, Schedu
 export type { ClaimMapping, CredentialScope, HttpIngress, IdentityAuth, IdentityConfig, IdentityDefinition, IdentityOptions, LangSmithApiKeyIngress, RuntimeIdentity, ValidatedTokenIngress, ValidatedTokenProvider, } from "./identity/index.js";
 export type { MemoryConfig, MemoryDefinition, MemoryOptions, MemoryScope, MemoryScopeInput, MemorySliceInput, MemorySliceKind, ResolvedMemorySlice, } from "./memory/index.js";
 export type { HttpMcpServerConfig, McpServersConfig, McpServersDefinition, McpToolSelectionConfig, RemoteMcpServerBaseConfig, RemoteMcpServerConfig, SseMcpServerConfig, } from "./connectors/mcp/index.js";
-export type { ChannelManifest, RequiredSlackChannelConfig, SlackChannel, SlackChannelConfig, SlackChannelFilters, SlackChannelTrigger, SlackConversationPolicy, SlackMentionBehavior, } from "./channels/slack/index.js";
-export type { SandboxDefinition, SandboxOptions, SandboxScope, } from "./sandbox.js";
+export type { ChannelManifest } from "./channels/manifest.js";
+export type { RequiredTriggerSlackChannelConfig, SlackChannel, SlackChannelConfig, } from "./channels/slack/index.js";
+export type { SandboxDefinition, SandboxOptions } from "./sandbox.js";
 export type { ManagedDeepAgentRuntime, ManagedRuntimeExtras, } from "./runtime/managed-tools.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,EAAE,OAAO,YAAY,CAAC;CAC1B;AAED,+DAA+D;AAC/D,eAAO,MAAM,UAAU,EAAE,UAExB,CAAC;AAEF,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,EAAE,OAAO,YAAY,CAAC;CAC1B;AAED,+DAA+D;AAC/D,eAAO,MAAM,UAAU,EAAE,UAExB,CAAC;AAEF,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,iCAAiC,EACjC,YAAY,EACZ,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEtE,YAAY,EACV,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC"}

package/dist/ingress/index.d.ts

@@ -6,6 +6,7 @@
  * trusted loopback invoke with source-provider stamps, and source-thread
  * existence probes.
  */
+import type { TriggerChannelResume } from "../channels/trigger/types.js";
 import { type ChannelBinding } from "../channels/binding.js";
 /** Inputs for the source-thread involvement probe (after identity remap). */
 export interface SourceThreadExistsInput {
@@ -26,6 +27,15 @@ export interface InvokeIngressAgentResult {
     runId?: string;
     threadId: string;
 }
+export interface StartedIngressRun {
+    threadId: string;
+    runId: string;
+}
+export type IngressRunStatus = "error" | "success" | "timeout" | "interrupted";
+export interface ObservedIngressRun {
+    values: unknown;
+    status: IngressRunStatus;
+}
 /**
  * Schedule background work after the provider ACK. Defaults to fire-and-forget
  * with error logging; tests pass an inline runner.
@@ -47,6 +57,27 @@ export declare function ingressSourceThreadExists(input: SourceThreadExistsInput
  * Only this path may set `x-mda-source-provider` / `x-mda-source-thread-id`.
  */
 export declare function invokeIngressAgent(input: InvokeIngressAgentInput): Promise<InvokeIngressAgentResult>;
+/** Create a Trigger-addressed thread and enqueue its run. */
+export declare function startIngressAgent(input: {
+    threadId: string;
+    assistantId: string;
+    messages: Record<string, unknown>[];
+    sourceProvider: string;
+    sourceThreadKey: string;
+}): Promise<StartedIngressRun>;
+/** Resume a Trigger-addressed thread with a keyed interrupt response. */
+export declare function resumeIngressAgent(input: {
+    threadId: string;
+    assistantId: string;
+    resume: TriggerChannelResume;
+    sourceProvider: string;
+    sourceThreadKey: string;
+}): Promise<StartedIngressRun>;
+/** Join an accepted Trigger run and read its terminal status. */
+export declare function observeIngressAgent(input: {
+    threadId: string;
+    runId: string;
+}): Promise<ObservedIngressRun>;
 /** Deterministic LangGraph thread id from a provider source-thread key. */
 export declare function stableThreadId(sourceThreadKey: string): string;
 //# sourceMappingURL=index.d.ts.map