managed-deepagents 0.10.0-dev.9 → 0.10.0

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

@@ -3,6 +3,8 @@ import type { Interrupt } from "langchain";
 import type { ChannelBinding } from "../binding.js";
 import type { NormalizedChannelEvent } from "../../run-context.js";
 import { z } from "zod";
+import type { triggerTargetSchema } from "../../runtime/thread-record.js";
+import type { ChannelActor } from "../actor.js";
 export declare const TRIGGER_SERVICE_KEY_HEADER = "x-service-key";
 /** Preserve provider-owned fields without imposing a provider schema. */
 declare const opaqueObject: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -16,6 +18,7 @@ declare const messageEventSchema: z.ZodObject<{
     address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     raw_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     identity_context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    actor: z.ZodOptional<z.ZodUnknown>;
     type: z.ZodLiteral<"message">;
     input: z.ZodObject<{
         messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -31,6 +34,7 @@ declare const interruptResumeEventSchema: z.ZodObject<{
     address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     raw_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     identity_context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    actor: z.ZodOptional<z.ZodUnknown>;
     type: z.ZodLiteral<"interrupt_resume">;
     interaction: z.ZodObject<{
         type: z.ZodLiteral<"interrupt_resume">;
@@ -47,6 +51,7 @@ declare const slackUserPromptResponseEventSchema: z.ZodObject<{
     address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     raw_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     identity_context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    actor: z.ZodOptional<z.ZodUnknown>;
     type: z.ZodLiteral<"user_prompt_response">;
     provider: z.ZodLiteral<"slack">;
     interaction: z.ZodObject<{
@@ -65,6 +70,7 @@ declare const userPromptResponseEventSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     raw_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     identity_context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    actor: z.ZodOptional<z.ZodUnknown>;
     type: z.ZodLiteral<"user_prompt_response">;
     provider: z.ZodLiteral<"slack">;
     interaction: z.ZodObject<{
@@ -73,6 +79,23 @@ declare const userPromptResponseEventSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         correlation_id: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>], "provider">;
+/** A person in the source conversation asked to stop its runs (Slack Stop). */
+declare const runCancelEventSchema: 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>;
+    raw_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    identity_context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    actor: z.ZodOptional<z.ZodUnknown>;
+    type: z.ZodLiteral<"run_cancel">;
+    interaction: z.ZodObject<{
+        type: z.ZodLiteral<"run_cancel">;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 declare const eventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     version: z.ZodLiteral<"1">;
     event_id: z.ZodString;
@@ -83,6 +106,7 @@ declare const eventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     raw_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     identity_context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    actor: z.ZodOptional<z.ZodUnknown>;
     type: z.ZodLiteral<"message">;
     input: z.ZodObject<{
         messages: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -97,6 +121,7 @@ declare const eventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     raw_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     identity_context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    actor: z.ZodOptional<z.ZodUnknown>;
     type: z.ZodLiteral<"interrupt_resume">;
     interaction: z.ZodObject<{
         type: z.ZodLiteral<"interrupt_resume">;
@@ -112,6 +137,7 @@ declare const eventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     address: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     raw_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     identity_context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    actor: z.ZodOptional<z.ZodUnknown>;
     type: z.ZodLiteral<"user_prompt_response">;
     provider: z.ZodLiteral<"slack">;
     interaction: z.ZodObject<{
@@ -119,7 +145,22 @@ declare const eventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         value: z.ZodOptional<z.ZodUnknown>;
         correlation_id: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
-}, z.core.$strip>], "provider">], "type">;
+}, z.core.$strip>], "provider">, 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>;
+    raw_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    identity_context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    actor: z.ZodOptional<z.ZodUnknown>;
+    type: z.ZodLiteral<"run_cancel">;
+    interaction: z.ZodObject<{
+        type: z.ZodLiteral<"run_cancel">;
+    }, 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>;
@@ -130,7 +171,10 @@ export type TriggerChannelSlackUserPromptResponseEvent = z.infer<typeof slackUse
 export type TriggerChannelUserPromptResponseEvent = z.infer<typeof userPromptResponseEventSchema>;
 export type TriggerChannelUserPromptResponseInteraction = TriggerChannelSlackUserPromptResponseEvent["interaction"];
 export type TriggerChannelRawEvent = z.infer<typeof opaqueObject>;
+export type TriggerChannelRunCancelEvent = z.infer<typeof runCancelEventSchema>;
 export type TriggerChannelEvent = z.infer<typeof eventSchema>;
+/** Events that start or resume a run on the source thread. */
+export type TriggerChannelRunEvent = Exclude<TriggerChannelEvent, TriggerChannelRunCancelEvent>;
 interface TriggerChannelActionBase {
     action_id: string;
     address: TriggerChannelAddress;
@@ -142,6 +186,11 @@ export interface TriggerChannelPostAction extends TriggerChannelActionBase {
     message: {
         text: string;
     };
+    /**
+     * On a post that starts a thread, Trigger runs later replies in it, and
+     * their input starts after this post.
+     */
+    follow_thread?: boolean;
 }
 /**
  * React to the message that triggered the run.
@@ -159,10 +208,40 @@ export interface TriggerChannelReactAction extends TriggerChannelActionBase {
     };
 }
 export type TriggerChannelActionRequest = TriggerChannelPostAction | TriggerChannelReactAction;
+/** The Trigger target of a thread a top-level post started. */
+export type TriggerStartedThread = z.infer<typeof triggerTargetSchema>;
 export interface TriggerChannelActionResponse {
     id: string;
+    /** The thread the post started, when it was a top-level post. */
+    thread?: TriggerStartedThread;
+}
+export type TriggerChannelRuntimeEventType = "run.started" | "run.completed" | "run.interrupted" | "run.failed"
+/** The run was cancelled (Slack Stop, Studio, or the API) before it finished. */
+ | "run.cancelled"
+/** The run's status changed while it works; see {@link TriggerChannelRuntimeStatus}. */
+ | "run.thinking";
+/** One step of a run's status, as Slack's plan shows it. */
+export interface TriggerChannelStatusStep {
+    title: string;
+    status: "pending" | "in_progress" | "complete" | "error";
+}
+/**
+ * The status a channel set for a run, on `run.started` and `run.thinking`:
+ * a line (`message.text`), steps, or both. An older Trigger Server ignores
+ * `steps` and `display`.
+ */
+export interface TriggerChannelRuntimeStatus {
+    message?: {
+        text: string;
+    };
+    /** At most 50, each title one line of at most 256 characters. */
+    steps?: TriggerChannelStatusStep[];
+    /**
+     * How Slack shows the run's progress, fixed by the event that opens it:
+     * `plan` groups it under the status line.
+     */
+    display?: "timeline" | "plan";
 }
-export type TriggerChannelRuntimeEventType = "run.started" | "run.completed" | "run.interrupted" | "run.failed";
 /**
  * One pending LangGraph interrupt, forwarded verbatim on `run.interrupted`.
  *
@@ -187,6 +266,8 @@ export interface TriggerChannelRuntimeEventRequest {
     message?: {
         text: string;
     };
+    steps?: TriggerChannelRuntimeStatus["steps"];
+    display?: TriggerChannelRuntimeStatus["display"];
     /**
      * Present on `run.interrupted`. The Trigger Server cannot read the
      * deployment's threads, so pending interrupts travel on the event itself.
@@ -205,8 +286,16 @@ export interface TriggerChannelRuntimeEventResponse {
 /** Validate the envelope while retaining all original opaque object identities. */
 export declare function parseTriggerChannelEvent(value: unknown): TriggerChannelEvent;
 /** The provider-neutral view of a prompt response, also used as its resume value. */
+/**
+ * Who a delivery came from, as Trigger Server verified them from the
+ * provider's signed request: for Slack, the user (`subject`) and their own
+ * team (`issuer`). `undefined` when the delivery names no one, or someone
+ * malformed, or a provider Trigger Server doesn't serve: an older Trigger
+ * Server sends none, and a delivery never fails over it.
+ */
+export declare function triggerEventActor(event: TriggerChannelEvent): ChannelActor | undefined;
 export declare function normalizedUserPromptResponse(event: TriggerChannelUserPromptResponseEvent): NormalizedChannelEvent;
 /** Current typed event and private route, without identity tokens. */
-export declare function triggerChannelBinding(event: TriggerChannelEvent, provider: string, name: string): ChannelBinding;
+export declare function triggerChannelBinding(event: TriggerChannelRunEvent, provider: string, name: string): ChannelBinding;
 export {};
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/channels/trigger/types.js

@@ -1,6 +1,7 @@
 import { channelContextSchema } from "../../run-context.js";
 import { z } from "zod";
 import { normalizeUuid } from "./uuid.js";
+import { isRecord, nonblankString as nonblank } from "../../values.js";
 export const TRIGGER_SERVICE_KEY_HEADER = "x-service-key";
 const nonblankString = z.string().refine((value) => value.trim().length > 0, {
     message: "must be nonblank",
@@ -26,6 +27,14 @@ const channelEventBase = z.object({
      * its principal UUID as `x-mda-user-id` instead of `mda:channel`.
      */
     identity_context: z.string().nullish(),
+    /**
+     * The provider user behind the delivery, `{ provider, issuer, subject }`,
+     * as Trigger Server names them; read with {@link triggerEventActor},
+     * which ignores a malformed one rather than refusing the delivery. Not
+     * signed, so MDA keeps it only when Agent Auth keys it on the
+     * `identity_context` principal.
+     */
+    actor: z.unknown().optional(),
 });
 const messageEventSchema = channelEventBase.extend({
     type: z.literal("message"),
@@ -54,10 +63,16 @@ const slackUserPromptResponseEventSchema = userPromptResponseEventBase.extend({
 const userPromptResponseEventSchema = z.discriminatedUnion("provider", [
     slackUserPromptResponseEventSchema,
 ]);
+/** A person in the source conversation asked to stop its runs (Slack Stop). */
+const runCancelEventSchema = channelEventBase.extend({
+    type: z.literal("run_cancel"),
+    interaction: z.object({ type: z.literal("run_cancel") }),
+});
 const eventSchema = z.discriminatedUnion("type", [
     messageEventSchema,
     interruptResumeEventSchema,
     userPromptResponseEventSchema,
+    runCancelEventSchema,
 ]);
 /** Validate the envelope while retaining all original opaque object identities. */
 export function parseTriggerChannelEvent(value) {
@@ -65,6 +80,28 @@ export function parseTriggerChannelEvent(value) {
     return value;
 }
 /** The provider-neutral view of a prompt response, also used as its resume value. */
+/**
+ * Who a delivery came from, as Trigger Server verified them from the
+ * provider's signed request: for Slack, the user (`subject`) and their own
+ * team (`issuer`). `undefined` when the delivery names no one, or someone
+ * malformed, or a provider Trigger Server doesn't serve: an older Trigger
+ * Server sends none, and a delivery never fails over it.
+ */
+export function triggerEventActor(event) {
+    const actor = event.actor;
+    if (!isRecord(actor))
+        return undefined;
+    const id = nonblank(actor.subject);
+    const team = nonblank(actor.issuer);
+    if (!id || !team)
+        return undefined;
+    switch (actor.provider) {
+        case "slack":
+            return { provider: "slack", id, teamId: team };
+        default:
+            return undefined;
+    }
+}
 export function normalizedUserPromptResponse(event) {
     return {
         provider: event.provider,

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

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

package/dist/channels/types.d.ts

@@ -4,6 +4,7 @@
  * Provider-specific fields belong in a validated `native` payload or the
  * managed adapter — never on these core types.
  */
+import type { ChannelRunResult } from "./run-input.js";
 import type { z } from "zod";
 import type { channelContentMessageSchema, channelNativeMessageSchema } from "./message-schema.js";
 export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
@@ -35,6 +36,18 @@ export type ChannelContentMessage = Readonly<z.infer<typeof channelContentMessag
 export type ChannelNativeMessage = Readonly<z.infer<typeof channelNativeMessageSchema>>;
 export type ChannelMessage = ChannelContentMessage | ChannelNativeMessage;
 export type OutboundMessage = ChannelMessage;
+/**
+ * Whether a channel posts the run's final answer to the conversation:
+ * `auto` (the default) posts the agent's last reply once the run succeeds,
+ * and `none` leaves replying to the agent, through `runtime.channel.post` or
+ * its own tools. Either way the channel keeps its other updates, such as
+ * Slack's status and reactions.
+ *
+ * @experimental This may change in a minor release.
+ */
+export type ChannelReply = "auto" | "none";
+/** Every {@link ChannelReply}, for channels that check one. */
+export declare const CHANNEL_REPLIES: readonly ChannelReply[];
 export type ChannelEvent = {
     readonly type: "schedule";
     readonly new_thread: boolean;
@@ -53,7 +66,13 @@ export type ChannelEvent = {
 export interface ChannelInfo {
     readonly name: string;
     readonly provider: string;
-    readonly event: ChannelEvent;
+    /**
+     * The event that started this run, or the schedule event in a scheduled
+     * run. `null` when the channel comes from the thread's record, such as in a
+     * run LangSmith Studio resumes.
+     */
+    readonly event: ChannelEvent | null;
+    /** The provider's payload, set only alongside the event that started the run. */
     readonly rawEvent?: JsonValue;
 }
 export interface PostedChannelMessage {
@@ -63,12 +82,42 @@ export interface PostedChannelMessage {
     url?: string;
 }
 /**
- * Provider-neutral reply surface injected on channel-originated runs only.
+ * Provider-neutral reply surface for the conversation a thread came from.
  *
- * Absent for ordinary HTTP and schedule runs.
+ * Absent on threads no channel started.
  */
 export interface RuntimeChannel extends ChannelInfo {
-    readonly post?: (message: ChannelMessage) => Promise<PostedChannelMessage>;
+    readonly post?: {
+        (message: ChannelMessage): Promise<PostedChannelMessage>;
+        (message: ChannelMessage, options: ChannelPostOptions): Promise<PostedChannelThread>;
+    };
+}
+/**
+ * A post that starts a new provider thread in the same conversation.
+ *
+ * @experimental This may change in a minor release.
+ */
+export interface ChannelPostOptions {
+    /**
+     * Post at top level, which starts a new provider thread. Replies in it
+     * continue a thread of its own, also without a mention in Slack's thread
+     * mode. Only Trigger channels that name the new thread support it.
+     */
+    newThread: true;
+    /**
+     * Start a run in the new thread with this input, as a channel handler's run
+     * input. Without it, the thread's first run starts with the first reply.
+     */
+    run?: ChannelRunResult;
+}
+/**
+ * A post that started a new provider thread.
+ *
+ * @experimental This may change in a minor release.
+ */
+export interface PostedChannelThread extends PostedChannelMessage {
+    /** The LangGraph thread replies in the new provider thread run on. */
+    threadId: string;
 }
 /** Stable machine-readable channel error codes (npm / PyPI / traces). */
 export type ChannelErrorCode = "channel_invalid_signature" | "channel_replay_rejected" | "channel_installation_not_found" | "channel_event_filtered" | "channel_identity_unresolvable" | "channel_destination_forbidden" | "channel_invocation_rate_limited" | "channel_run_failed" | "channel_provider_rate_limited" | "channel_provider_rejected";

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,SAAS,EAAE,GACpB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE1C,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAC1C,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAC5C,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CACzC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAC3C,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC;AAE7C,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAC3D;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACvD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD,CAAC;AAEN,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC5E;AAED,yEAAyE;AACzE,MAAM,MAAM,gBAAgB,GACxB,2BAA2B,GAC3B,yBAAyB,GACzB,gCAAgC,GAChC,wBAAwB,GACxB,+BAA+B,GAC/B,+BAA+B,GAC/B,iCAAiC,GACjC,oBAAoB,GACpB,+BAA+B,GAC/B,2BAA2B,CAAC;AAEhC,0EAA0E;AAC1E,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,kBAAkB,GAE7B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CA0B5D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"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"}

package/dist/channels/types.js

@@ -4,6 +4,8 @@
  * Provider-specific fields belong in a validated `native` payload or the
  * managed adapter — never on these core types.
  */
+/** Every {@link ChannelReply}, for channels that check one. */
+export const CHANNEL_REPLIES = ["auto", "none"];
 /** Narrow a destination to its discriminant + required address fields. */
 export function normalizeChannelDestination(destination) {
     const type = destination.type;

package/dist/channels/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuGH,0EAA0E;AAC1E,MAAM,UAAU,2BAA2B,CACzC,WAA+B;IAK/B,MAAM,IAAI,GAAY,WAAW,CAAC,IAAI,CAAC;IACvC,IAAI,WAAW,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC3C,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC;QACjD,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;QACjD,MAAM,EAAE,cAAc,EAAE,GAAG,WAAW,CAAC;QACvC,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE,cAAc,EAAE,CAAC;IAC3D,CAAC;IACD,MAAM,IAAI,KAAK,CACb,yCAAyC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAChE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8DH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAgGzE,0EAA0E;AAC1E,MAAM,UAAU,2BAA2B,CACzC,WAA+B;IAK/B,MAAM,IAAI,GAAY,WAAW,CAAC,IAAI,CAAC;IACvC,IAAI,WAAW,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC3C,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC;QACjD,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;QACjD,MAAM,EAAE,cAAc,EAAE,GAAG,WAAW,CAAC;QACvC,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE,cAAc,EAAE,CAAC;IAC3D,CAAC;IACD,MAAM,IAAI,KAAK,CACb,yCAAyC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAChE,CAAC;AACJ,CAAC"}

package/dist/concurrency/batch-processor.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Collects items pushed from anywhere in the process and hands them to
+ * `handle` in batches: when `maxBatchSize` items are waiting, or `maxWaitMs`
+ * after the first one arrived, or without the wait once `shutdown` starts. One batch is handled
+ * at a time; a rejected `handle` drops that batch. Compose `handle` (see
+ * `resilience/`) for retries, passing on its signal.
+ *
+ * The worker starts on the first push and stops when the queue is empty, and
+ * its timers never keep the process alive; only `shutdown` holds it open,
+ * until its deadline.
+ */
+export interface BatchProcessorOptions<T> {
+    /** `signal` aborts at the `shutdown` deadline. */
+    handle: (batch: T[], signal: AbortSignal) => Promise<void>;
+    maxBatchSize: number;
+    maxWaitMs: number;
+    /** Items pushed while this many are waiting are dropped. */
+    maxQueued: number;
+    /**
+     * With `sizeOf`, a batch also stops before it would pass this many bytes.
+     * A single larger item still goes, alone.
+     */
+    maxBatchBytes?: number;
+    sizeOf?: (item: T) => number;
+}
+export declare class BatchProcessor<T> {
+    private readonly options;
+    private readonly queue;
+    /** The running worker; unset while the queue is empty. */
+    private worker;
+    private wake;
+    private closed;
+    private readonly deadline;
+    constructor(options: BatchProcessorOptions<T>);
+    /** Queue items without blocking or throwing. Returns how many were accepted. */
+    push(...items: T[]): number;
+    /** Resolves once everything pushed so far has been handled. */
+    idle(): Promise<void>;
+    /**
+     * Drain: refuse new items and send what is queued, a batch at a time as
+     * usual but without the batch wait, retrying as `handle` does. At
+     * `deadlineMs` the request in flight is aborted and the rest is dropped.
+     */
+    shutdown(deadlineMs: number): Promise<void>;
+    private run;
+    /** How many queued items fit the next batch. */
+    private nextBatchSize;
+    /** Resolves after `ms`, or as soon as a full batch is waiting. */
+    private waitUpTo;
+}
+//# sourceMappingURL=batch-processor.d.ts.map

package/dist/concurrency/batch-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-processor.d.ts","sourceRoot":"","sources":["../../src/concurrency/batch-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,kDAAkD;IAClD,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;CAC9B;AAED,qBAAa,cAAc,CAAC,CAAC;IAQf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,0DAA0D;IAC1D,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAElD,YAA6B,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAI;IAElE,gFAAgF;IAChF,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM,CAQ1B;IAED,+DAA+D;IAC/D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpB;IAED;;;;OAIG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchD;YAEa,GAAG;IAiBjB,gDAAgD;IAChD,OAAO,CAAC,aAAa;IAcrB,kEAAkE;IAClE,OAAO,CAAC,QAAQ;CAcjB"}

package/dist/concurrency/batch-processor.js

@@ -0,0 +1,99 @@
+export class BatchProcessor {
+    options;
+    queue = [];
+    /** The running worker; unset while the queue is empty. */
+    worker;
+    wake;
+    closed = false;
+    deadline = new AbortController();
+    constructor(options) {
+        this.options = options;
+    }
+    /** Queue items without blocking or throwing. Returns how many were accepted. */
+    push(...items) {
+        if (this.closed)
+            return 0;
+        const room = Math.max(this.options.maxQueued - this.queue.length, 0);
+        const accepted = items.slice(0, room);
+        this.queue.push(...accepted);
+        if (this.queue.length >= this.options.maxBatchSize)
+            this.wake?.();
+        if (!this.worker && this.queue.length > 0)
+            this.worker = this.run();
+        return accepted.length;
+    }
+    /** Resolves once everything pushed so far has been handled. */
+    idle() {
+        return this.worker ?? Promise.resolve();
+    }
+    /**
+     * Drain: refuse new items and send what is queued, a batch at a time as
+     * usual but without the batch wait, retrying as `handle` does. At
+     * `deadlineMs` the request in flight is aborted and the rest is dropped.
+     */
+    async shutdown(deadlineMs) {
+        this.closed = true;
+        this.wake?.();
+        let timer;
+        const deadline = new Promise((resolve) => {
+            timer = setTimeout(resolve, deadlineMs);
+        });
+        try {
+            await Promise.race([this.idle(), deadline]);
+        }
+        finally {
+            clearTimeout(timer);
+            this.deadline.abort();
+            this.queue.length = 0;
+        }
+    }
+    async run() {
+        try {
+            while (this.queue.length > 0) {
+                if (this.queue.length < this.options.maxBatchSize && !this.closed) {
+                    await this.waitUpTo(this.options.maxWaitMs);
+                }
+                const batch = this.queue.splice(0, this.nextBatchSize());
+                await this.options
+                    .handle(batch, this.deadline.signal)
+                    .catch(() => undefined);
+            }
+        }
+        finally {
+            // Same tick as the empty-queue check, so a later push starts a new worker.
+            this.worker = undefined;
+        }
+    }
+    /** How many queued items fit the next batch. */
+    nextBatchSize() {
+        const { maxBatchSize, maxBatchBytes, sizeOf } = this.options;
+        const limit = Math.min(maxBatchSize, this.queue.length);
+        if (maxBatchBytes === undefined || !sizeOf)
+            return limit;
+        let count = 0;
+        let bytes = 0;
+        while (count < limit) {
+            bytes += sizeOf(this.queue[count]);
+            if (count > 0 && bytes > maxBatchBytes)
+                break;
+            count++;
+        }
+        return count;
+    }
+    /** Resolves after `ms`, or as soon as a full batch is waiting. */
+    waitUpTo(ms) {
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.wake = undefined;
+                resolve();
+            }, ms);
+            timer.unref?.();
+            this.wake = () => {
+                clearTimeout(timer);
+                this.wake = undefined;
+                resolve();
+            };
+        });
+    }
+}
+//# sourceMappingURL=batch-processor.js.map

package/dist/concurrency/batch-processor.js.map

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

package/dist/connections.d.ts

@@ -12,7 +12,7 @@
  * middleware.
  */
 import type { RuntimeIdentity } from "./identity/index.js";
-import { CredentialStoreError, type AgentAuthContext } from "./agent-auth.js";
+import { CredentialStoreError, type AgentAuthContext, type ResolvePrincipalIdentity } from "./agent-auth.js";
 export { AGENT_AUTH_TIMEOUT_MS, AgentAuthUnknownProviderError, clearPrincipalResolveCacheForTests, CredentialAuthorizationRequiredError, CredentialStoreError, } from "./agent-auth.js";
 export type { AgentAuthContext, PendingAuthorization, ResolvePrincipalIdentity, } from "./agent-auth.js";
 export type AgentConnectionOwner = {
@@ -29,6 +29,7 @@ export interface ConnectionRequest {
     identity?: RuntimeIdentity;
 }
 declare const CONNECTION_REFERENCE: unique symbol;
+export declare const TRUSTED_BACKEND_PROVIDER = "trusted_backend";
 export declare class ConnectionNotFoundError extends Error {
     readonly slug: string;
     readonly ownerType: ConnectionOwner["type"];
@@ -86,6 +87,8 @@ export declare function resolveOwnerId(owner: ConnectionOwner, identity: Runtime
  * Agent Auth env is configured; does not require `LANGSMITH_HOST_PROJECT_ID`.
  */
 export declare function resolveAgentAuthContext(identity: RuntimeIdentity | undefined, env?: NodeJS.ProcessEnv, fetchImpl?: typeof fetch, timeoutMs?: number): Promise<AgentAuthContext>;
+/** Resolve an external identity to its Agent Auth principal with the deployment's key. */
+export declare function resolveExternalPrincipalId(identity: ResolvePrincipalIdentity): Promise<string>;
 /**
  * Why a Studio resume of a channel's conversation gets no user connections:
  * the conversation holds content from outside the workspace, which must not
@@ -121,17 +124,7 @@ export declare function channelProvider(identity: RuntimeIdentity | undefined):
  */
 export declare function resolveCredentialPrincipalId(identity: RuntimeIdentity | undefined, config: AgentAuthConfig, fetchImpl?: typeof fetch, timeoutMs?: number): Promise<string>;
 /**
- * The LangSmith workspace Agent Auth calls are scoped to. Users set
- * `LANGSMITH_WORKSPACE_ID`, which wins. A hosted deployment always runs with
- * `LANGSMITH_TENANT_ID`, which the platform sets, so a deploy that never named
- * a workspace still has one.
- */
-export declare function resolveWorkspaceId(env?: NodeJS.ProcessEnv): string | undefined;
-/**
- * Origin for Agent Auth HTTP calls from `LANGSMITH_ENDPOINT`.
- *
- * Cloud SaaS revisions omit that reserved name and inject `LANGCHAIN_ENDPOINT`
- * instead; read it as the same setting so we do not default to production.
+ * Origin for Agent Auth HTTP calls from the LangSmith endpoint.
  */
 export declare function resolveAgentAuthBaseUrl(env?: NodeJS.ProcessEnv): string;
 export declare const connections: Connections;