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

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

@@ -1,10 +1,14 @@
-import type { ChannelBinding } from "../binding.js";
+import type { JsonValue } from "../types.js";
+import { type ChannelBinding } from "../binding.js";
 import { type ReactionChoice } from "../reactions.js";
 import { type ObservedIngressRun, type PendingInterrupt } from "./ingress.js";
-import type { StartedIngressRun } from "../../ingress/runs.js";
+import { type MultitaskStrategy, type StartedIngressRun } from "../../ingress/runs.js";
+import { type NormalizedRunInput } from "../run-input.js";
+import type { HttpChannelAdapter } from "../http/types.js";
 import { type TriggerClientLike } from "./client.js";
 import { type IdentityContextVerifyOptions } from "./identity-context.js";
-import { type TriggerChannelMessageEvent, type TriggerChannelResume } from "./types.js";
+import { type TriggerChannelMessageEvent, type TriggerChannelUserPromptResponseEvent, type TriggerChannelResume, type TriggerChannelRuntimeStatus } from "./types.js";
+import type { ChannelActor } from "../actor.js";
 export { TRIGGER_SERVICE_KEY_HEADER } from "./types.js";
 export declare const ASSISTANT_ID_ENV = "MDA_ASSISTANT_ID";
 type StartAgent = (input: {
@@ -16,6 +20,11 @@ type StartAgent = (input: {
     sourceProvider: string;
     sourceThreadKey: string;
     userId: string;
+    /** Other state keys to start with. */
+    state?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    webhook?: string;
+    multitaskStrategy?: MultitaskStrategy;
 }) => Promise<StartedIngressRun>;
 type ObserveAgent = (input: {
     threadId: string;
@@ -40,6 +49,53 @@ type ThreadInterrupts = (input: {
     sourceThreadKey: string;
     userId: string;
 }) => Promise<PendingInterrupt[]>;
+type NewerRun = (input: {
+    threadId: string;
+    runId: string;
+    sourceProvider: string;
+    sourceThreadKey: string;
+    userId: string;
+}) => Promise<boolean>;
+type ThreadExists = (input: {
+    threadId: string;
+    sourceProvider: string;
+    sourceThreadKey: string;
+    userId: string;
+}) => Promise<boolean>;
+/** The thread a message event belongs to, before any run exists. */
+export interface TriggerChannelThread {
+    id: string;
+    sourceThreadKey: string;
+}
+/**
+ * What a message event starts: the run input a provider's handler returned
+ * (`input`), no run (`skipped`), or nothing because the handler failed
+ * (`failed`).
+ */
+export type TriggerMessageDecision = {
+    type: "input";
+    input: NormalizedRunInput;
+} | {
+    type: "skipped";
+} | {
+    type: "failed";
+};
+/**
+ * What a provider decides a message starts: at once, or `background` for a
+ * decision that may take longer than Trigger Server waits, such as an event
+ * endpoint's. Trigger Server then gets its answer first, and a failure is
+ * only logged.
+ */
+export type TriggerMessageRoute = TriggerMessageDecision | {
+    type: "background";
+    decide: () => Promise<TriggerMessageDecision>;
+};
+type CancelThreadRuns = (input: {
+    threadId: string;
+    sourceProvider: string;
+    sourceThreadKey: string;
+    userId: string;
+}) => Promise<number>;
 export interface TriggerChannelHttpOptions {
     sourceProvider: string;
     channelName: string;
@@ -49,15 +105,70 @@ export interface TriggerChannelHttpOptions {
     startAgent?: StartAgent;
     resumeAgent?: ResumeAgent;
     threadInterrupts?: ThreadInterrupts;
+    threadExists?: ThreadExists;
+    /** Whether a newer run replaced a run on its thread; for tests. */
+    newerRun?: NewerRun;
     observeAgent?: ObserveAgent;
+    cancelRuns?: CancelThreadRuns;
     triggerClient?: TriggerClientLike;
     /** How to react to the message that starts a run. Defaults to `eyes`. */
     reactions?: ReactionChoice;
+    /**
+     * The status a run's `run.started` shows in place of Trigger Server's
+     * working phrases, and how.
+     */
+    startedStatus?: TriggerChannelRuntimeStatus;
     /** Provider hook for a message event's run input; defaults to `input.messages`. */
     messageInput?: (event: TriggerChannelMessageEvent) => Record<string, unknown>[];
+    /**
+     * Decide what a message event starts, before its run; `undefined` starts
+     * it with `messageInput`'s messages. Interrupt resumes never ask.
+     */
+    decideMessage?: (event: TriggerChannelMessageEvent, thread: TriggerChannelThread, 
+    /** Who sent it, when Trigger Server names them. */
+    actor?: ChannelActor) => Promise<TriggerMessageRoute | undefined>;
+    /**
+     * Decide what a prompt response that answers no interrupt starts, as
+     * `decideMessage` does a message; `undefined` starts a run with no new
+     * messages, which reads the response from `runtime.channel.event`.
+     */
+    decideInteraction?: (event: TriggerChannelUserPromptResponseEvent, thread: TriggerChannelThread, 
+    /** Who responded, when Trigger Server names them. */
+    actor?: ChannelActor) => Promise<TriggerMessageRoute | undefined>;
+    /**
+     * Whether a message may only continue a thread the agent already ran on:
+     * then, on a thread no run ever started on, it starts nothing, and
+     * `decideMessage` isn't asked.
+     */
+    onlyContinuesThread?: (event: TriggerChannelMessageEvent) => Promise<boolean>;
+    /**
+     * What a run a message or prompt response starts does to a run already
+     * active on its thread; `enqueue` when unset.
+     */
+    multitaskStrategy?: MultitaskStrategy;
+    /**
+     * A message, or a prompt response that answers no interrupt, is done, as
+     * `channels.http`'s `onFinish` hears it: the run it started ended (`run`), it started none (`skipped`: `ignored` or
+     * `rejected`), its run couldn't start after Trigger Server had its answer
+     * (`failed: start`), or MDA lost track of the run (`failed: observe`). The
+     * delivery's `rawEvent` is the {@link TriggerFinishedEvent}. Called once,
+     * after the reply and lifecycle callbacks, in the background; failures are
+     * logged. A message whose run couldn't start before Trigger Server's answer
+     * gets an error instead, and Trigger Server may deliver it again.
+     */
+    onFinish?: HttpChannelAdapter["onFinish"];
     /** Override identity-context JWKS verify (unit tests). */
     identityContext?: IdentityContextVerifyOptions;
 }
 /** Validate one Trigger message, start its run, and enqueue observation. */
 export declare function handleTriggerChannelEventRequest(request: Request, options: TriggerChannelHttpOptions): Promise<Response>;
+/**
+ * What a finished message's `rawEvent` holds: the Trigger delivery, without
+ * its identity token.
+ */
+export type TriggerFinishedEvent = {
+    delivery: JsonValue;
+    /** Who sent it, as Trigger Server named them. */
+    actor?: ChannelActor;
+};
 //# sourceMappingURL=http.d.ts.map

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

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