managed-deepagents 0.9.6-dev.19 → 0.9.6-dev.20

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":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,QAAQ,EAAE,cAAc,IAAI,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEvE,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,yEAAyE;AACzE,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;IACrB,SAAS,EAAE,YAAY,CAAC,OAAO,EAAE;IACjC;;;OAGG;IACH,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACtC;;;;;;OAMG;IACH,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC9B,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,2BAA2B,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;CACxC,CAAC,CAAC;AACH,MAAM,kCAAkC,GAAG,2BAA2B,CAAC,MAAM,CAAC;IAC5E,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,MAAM,EAAE,cAAc;QACtB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC7B,cAAc,EAAE,cAAc,CAAC,QAAQ,EAAE;KAC1C,CAAC;CACH,CAAC,CAAC;AACH,MAAM,6BAA6B,GAAG,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE;IACrE,kCAAkC;CACnC,CAAC,CAAC;AACH,+EAA+E;AAC/E,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;CACzD,CAAC,CAAC;AACH,MAAM,WAAW,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC/C,kBAAkB;IAClB,0BAA0B;IAC1B,6BAA6B;IAC7B,oBAAoB;CACrB,CAAC,CAAC;AAoJH,mFAAmF;AACnF,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,KAA4B,CAAC;AACtC,CAAC;AAED,qFAAqF;AACrF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA0B;IAE1B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IACnC,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvB,KAAK,OAAO;YACV,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjD;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAA4C;IAE5C,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM;QAChC,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,IAAI,IAAI;YAC1C,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE;YACtD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,qBAAqB,CACnC,KAA6B,EAC7B,QAAgB,EAChB,IAAY;IAEZ,IAAI,UAAwB,CAAC;IAC7B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,UAAU,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjE,MAAM;QACR,KAAK,kBAAkB;YACrB,UAAU,GAAG;gBACX,IAAI,EAAE,kBAAkB;gBACxB,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM;aACjC,CAAC;YACF,MAAM;QACR,KAAK,sBAAsB;YACzB,UAAU,GAAG;gBACX,IAAI,EAAE,sBAAsB;gBAC5B,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM;gBAChC,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,WAAW;oBAC9B,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE;oBACpC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,KAAK,SAAS;oBAChD,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;aAC1D,CAAC;YACF,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,oBAAoB,CAAC,KAAK,CAAC;QAChC,IAAI;QACJ,QAAQ;QACR,eAAe,EAAE,KAAK,CAAC,iBAAiB;QACxC,UAAU,EAAE,KAAK,CAAC,WAAW;QAC7B,SAAS,EAAE,gBAAgB;QAC3B,KAAK,EAAE,UAAU;QACjB,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI;YACzB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,SAAsB,EAAE,CAAC;QAC/C,MAAM,EAAE;YACN,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAoB;YACnC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;SAC3C;KACF,CAAC,CAAC;AACL,CAAC"}

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":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,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;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,+DAA+D;AAC/D,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAAqB,CAAC;AAEzE,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;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC,iFAAiF;IACjF,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;QACd,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACzD,CACE,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAAC;KACjC,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,SAAS,EAAE,IAAI,CAAC;IAChB;;;OAGG;IACH,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;CAClB;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"}

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/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"];
@@ -55,6 +56,8 @@ export interface AgentAuthConfig {
     workspaceId?: string;
     localDevPrincipalId?: string;
 }
+/** Env var holding the deployment id, which is the agent owner's `owner_id`. */
+export declare const DEPLOYMENT_ID_ENV = "LANGSMITH_HOST_PROJECT_ID";
 export declare class AgentAuthConnectionStore {
     private readonly env;
     private readonly fetchImpl;
@@ -69,6 +72,11 @@ export declare class Connections {
     resolve(slug: string, owner: ConnectionOwner): Promise<string>;
     resolveDeploymentSecret(slug: string): Promise<string>;
 }
+/**
+ * The variable `mda dev` reads an agent connection's local value from:
+ * `MDA_DEV_` and the slug uppercased, `-` as `_` and `/` as `__`
+ * (`mda/github-token` → `MDA_DEV_MDA__GITHUB_TOKEN`), so shells keep it.
+ */
 export declare function agentConnectionEnvKey(slug: string): string;
 export declare function resolveOwnerId(owner: ConnectionOwner, identity: RuntimeIdentity | undefined, deploymentId: string | undefined): string;
 /**
@@ -79,6 +87,32 @@ 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
+ * steer the grants of whoever resumes it.
+ */
+export declare const CHANNEL_THREAD_USER_CONNECTION_ERROR: string;
+/**
+ * Whether the run continues a channel's conversation for a caller who is not
+ * that channel, such as a person resuming it from Studio. The channel's own
+ * runs, a linked Slack person's included, keep their connections.
+ */
+export declare function outsideCallerOnChannelThread(identity: RuntimeIdentity | undefined): boolean;
+/**
+ * The channel, e.g. `github`, whose sender the run acts for without a user of
+ * the agent's identity behind them. Such a person has user memory but no
+ * user-owned connections.
+ */
+export declare function unmappedChannelProvider(identity: RuntimeIdentity | undefined): string | undefined;
+/**
+ * The channel a run started by a channel event runs as, e.g. `github`. Such a
+ * run runs as the channel, not as the person who sent the event, so there is
+ * no one to own a user grant.
+ */
+export declare function channelProvider(identity: RuntimeIdentity | undefined): string | undefined;
 /**
  * Map a runtime identity to the Agent Auth principal used for user grants.
  *

package/dist/connections.d.ts.map

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