managed-deepagents 0.10.0-dev.8 → 0.10.0

package/dist/runtime/thread-record.js

@@ -0,0 +1,213 @@
+/**
+ * The thread record: where a thread's conversation lives and who takes part.
+ *
+ * Managed ingress keeps it in thread metadata, so every run on the thread
+ * (Studio resumes and schedules included) reads it from its own config. Thread
+ * metadata reaches traces, so the record never holds message text, the event
+ * or the provider's raw payload. Keys inside it are snake_case wire data,
+ * shared with the Python runtime.
+ */
+import { isDeepStrictEqual } from "node:util";
+import { z } from "zod";
+import { logger } from "./log.js";
+export const THREAD_RECORD_METADATA = "ls_mda_thread";
+export const THREAD_PARTICIPANTS_METADATA = "ls_mda_participants";
+/**
+ * The source thread key of a conversation a scheduled run started, on the
+ * run's own thread. Ingress runs the conversation's events there.
+ */
+export const THREAD_CONVERSATION_METADATA = "ls_mda_conversation";
+/** Every thread-record key; only managed ingress may write one. */
+export const THREAD_RECORD_METADATA_PREFIX = "ls_mda_";
+const nonblankString = z.string().refine((value) => value.trim().length > 0);
+const storedChannelSchema = z.strictObject({
+    name: nonblankString,
+    provider: nonblankString,
+    transport: z.enum(["trigger_server", "direct"]),
+    source_thread_key: nonblankString,
+    address: z.json(),
+    delivery_id: nonblankString,
+});
+const storedOriginSchema = z.strictObject({
+    channel: storedChannelSchema,
+    sender: z.string().nullable().default(null),
+});
+const recordSchema = z.strictObject({
+    v: z.literal(1),
+    origin: z.unknown().optional(),
+    participants: z
+        .record(z.string(), z.strictObject({ role: z.enum(["owner", "member"]) }))
+        .default({}),
+});
+/** A Trigger binding's target: the channel, its opaque address and its thread. */
+export const triggerTargetSchema = z.object({
+    channel_id: nonblankString,
+    address: z.record(z.string(), z.json()),
+    source_thread_key: nonblankString,
+});
+/** A stored Trigger address: the target's address with its channel id. */
+const triggerAddressSchema = z
+    .object({ channel_id: nonblankString })
+    .catchall(z.json());
+let reportedMalformed = false;
+/** Say once that a record was ignored, without any of its values. */
+function reportMalformed(part) {
+    if (reportedMalformed)
+        return;
+    reportedMalformed = true;
+    logger.warn(`thread ${part} metadata is malformed and was ignored`);
+}
+/**
+ * A person is a non-blank principal id outside the `mda:` service namespace
+ * (`mda:channel`, `mda:slack`, `mda:schedule:*`).
+ */
+export function isPersonPrincipal(id) {
+    return typeof id === "string" && !!id.trim() && !id.startsWith("mda:");
+}
+/** The stored form of a binding: no event, and its target as `address`. */
+export function originFromBinding(binding, sender) {
+    const trigger = binding.transport === "trigger_server"
+        ? triggerTargetSchema.safeParse(binding.target)
+        : undefined;
+    // A Trigger target that doesn't parse is stored as is, and no run can
+    // rebuild it.
+    const address = trigger?.success
+        ? { channel_id: trigger.data.channel_id, ...trigger.data.address }
+        : binding.target;
+    return {
+        channel: {
+            name: binding.name,
+            provider: binding.provider,
+            transport: binding.transport,
+            source_thread_key: binding.sourceThreadKey,
+            address,
+            delivery_id: binding.deliveryId,
+        },
+        sender,
+    };
+}
+/** The binding a stored origin was made from, without its event. */
+export function bindingFromOrigin(origin) {
+    const { channel } = origin;
+    let target = channel.address;
+    if (channel.transport === "trigger_server") {
+        const address = triggerAddressSchema.safeParse(channel.address);
+        if (!address.success)
+            return undefined;
+        const { channel_id, ...rest } = address.data;
+        target = {
+            channel_id,
+            address: rest,
+            source_thread_key: channel.source_thread_key,
+        };
+    }
+    return {
+        name: channel.name,
+        provider: channel.provider,
+        transport: channel.transport,
+        sourceThreadKey: channel.source_thread_key,
+        deliveryId: channel.delivery_id,
+        target,
+    };
+}
+/**
+ * The record in a thread's or run's metadata, or `null` when there is none or
+ * it is malformed. A malformed origin keeps the participants. With `exact`,
+ * as a write must be, a malformed origin or a participant list that does not
+ * name exactly the participants rejects the whole record.
+ */
+export function parseThreadRecord(metadata, { exact = false } = {}) {
+    if (!isRecord(metadata) || metadata[THREAD_RECORD_METADATA] == null)
+        return null;
+    const parsed = recordSchema.safeParse(metadata[THREAD_RECORD_METADATA]);
+    if (!parsed.success) {
+        reportMalformed("record");
+        return null;
+    }
+    const roles = parsed.data.participants;
+    const origin = parsed.data.origin == null
+        ? undefined
+        : storedOriginSchema.safeParse(parsed.data.origin);
+    if (origin?.success === false)
+        reportMalformed("origin");
+    // JSON object keys that look like integers lose their order, so the list
+    // carries who joined first.
+    const listed = metadata[THREAD_PARTICIPANTS_METADATA];
+    const ids = isStringList(listed) &&
+        listed.length === Object.keys(roles).length &&
+        new Set(listed).size === listed.length &&
+        listed.every((id) => Object.hasOwn(roles, id))
+        ? listed
+        : undefined;
+    if (exact && (origin?.success === false || !ids))
+        return null;
+    return {
+        origin: origin?.success ? origin.data : null,
+        participants: (ids ?? Object.keys(roles)).map((id) => ({
+            id,
+            role: roles[id].role,
+        })),
+    };
+}
+/**
+ * The record after a channel event: the event's channel is the origin, and a
+ * person who sends it joins, as owner when they are the first.
+ */
+export function nextThreadRecord(current, binding, senderId) {
+    const sender = isPersonPrincipal(senderId) ? senderId : null;
+    const participants = [...(current?.participants ?? [])];
+    if (sender !== null && !participants.some(({ id }) => id === sender))
+        participants.push({
+            id: sender,
+            role: participants.length ? "member" : "owner",
+        });
+    return { origin: originFromBinding(binding, sender), participants };
+}
+/** The metadata keys that store a record. */
+export function threadRecordMetadata(record) {
+    return {
+        [THREAD_RECORD_METADATA]: {
+            v: 1,
+            // Absent rather than `null`: a SQLite metadata patch deletes nulls.
+            ...(record.origin !== null && { origin: record.origin }),
+            participants: Object.fromEntries(record.participants.map(({ id, role }) => [id, { role }])),
+        },
+        [THREAD_PARTICIPANTS_METADATA]: record.participants.map(({ id }) => id),
+    };
+}
+/** Whether metadata already stores exactly this record. */
+export function storesThreadRecord(metadata, record) {
+    const stored = threadRecordMetadata(record);
+    return (isRecord(metadata) &&
+        isDeepStrictEqual(metadata[THREAD_RECORD_METADATA], stored[THREAD_RECORD_METADATA]) &&
+        isDeepStrictEqual(metadata[THREAD_PARTICIPANTS_METADATA], stored[THREAD_PARTICIPANTS_METADATA]));
+}
+/**
+ * Remove every thread-record key from a metadata object, in place. With
+ * `keepRecord`, the two keys a record is stored in stay; with
+ * `keepConversation`, the conversation key stays too.
+ */
+export function stripThreadRecordKeys(metadata, { keepRecord = false, keepConversation = false, } = {}) {
+    if (!isRecord(metadata))
+        return;
+    for (const key of Object.keys(metadata)) {
+        const kept = (keepRecord &&
+            (key === THREAD_RECORD_METADATA ||
+                key === THREAD_PARTICIPANTS_METADATA)) ||
+            (keepConversation && key === THREAD_CONVERSATION_METADATA);
+        if (key.startsWith(THREAD_RECORD_METADATA_PREFIX) && !kept)
+            delete metadata[key];
+    }
+}
+/** Whether metadata names any thread-record key. */
+export function hasThreadRecordKeys(metadata) {
+    return (isRecord(metadata) &&
+        Object.keys(metadata).some((key) => key.startsWith(THREAD_RECORD_METADATA_PREFIX)));
+}
+function isStringList(value) {
+    return (Array.isArray(value) && value.every((item) => typeof item === "string"));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=thread-record.js.map

package/dist/runtime/thread-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-record.js","sourceRoot":"","sources":["../../src/runtime/thread-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAC;AACtD,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,CAAC;AAClE;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,CAAC;AAClE,mEAAmE;AACnE,MAAM,CAAC,MAAM,6BAA6B,GAAG,SAAS,CAAC;AAUvD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC7E,MAAM,mBAAmB,GAAG,CAAC,CAAC,YAAY,CAAC;IACzC,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAC/C,iBAAiB,EAAE,cAAc;IACjC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;IACjB,WAAW,EAAE,cAAc;CAC5B,CAAC,CAAC;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC,YAAY,CAAC;IACxC,OAAO,EAAE,mBAAmB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC5C,CAAC,CAAC;AACH,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;IAClC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACf,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,YAAY,EAAE,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;SACzE,OAAO,CAAC,EAAE,CAAC;CACf,CAAC,CAAC;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,cAAc;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,iBAAiB,EAAE,cAAc;CAClC,CAAC,CAAC;AACH,0EAA0E;AAC1E,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;KACtC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAatB,IAAI,iBAAiB,GAAG,KAAK,CAAC;AAE9B,qEAAqE;AACrE,SAAS,eAAe,CAAC,IAAyB;IAChD,IAAI,iBAAiB;QAAE,OAAO;IAC9B,iBAAiB,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,wCAAwC,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAW;IAC3C,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAC/B,OAAsB,EACtB,MAAqB;IAErB,MAAM,OAAO,GACX,OAAO,CAAC,SAAS,KAAK,gBAAgB;QACpC,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/C,CAAC,CAAC,SAAS,CAAC;IAChB,sEAAsE;IACtE,cAAc;IACd,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO;QAC9B,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE;QAClE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACnB,OAAO;QACL,OAAO,EAAE;YACP,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,iBAAiB,EAAE,OAAO,CAAC,eAAe;YAC1C,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,UAAU;SAChC;QACD,MAAM;KACP,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,iBAAiB,CAC/B,MAAoB;IAEpB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC3B,IAAI,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,OAAO,CAAC,SAAS,KAAK,gBAAgB,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QACvC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;QAC7C,MAAM,GAAG;YACP,UAAU;YACV,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC7C,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe,EAAE,OAAO,CAAC,iBAAiB;QAC1C,UAAU,EAAE,OAAO,CAAC,WAAW;QAC/B,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAiB,EACjB,EAAE,KAAK,GAAG,KAAK,EAAE,GAAwB,EAAE;IAE3C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,sBAAsB,CAAC,IAAI,IAAI;QACjE,OAAO,IAAI,CAAC;IACd,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;IACvC,MAAM,MAAM,GACV,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI;QACxB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,MAAM,EAAE,OAAO,KAAK,KAAK;QAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzD,yEAAyE;IACzE,4BAA4B;IAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,4BAA4B,CAAC,CAAC;IACtD,MAAM,GAAG,GACP,YAAY,CAAC,MAAM,CAAC;QACpB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;QAC3C,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;QACtC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO;QACL,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC5C,YAAY,EAAE,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACrD,EAAE;YACF,IAAI,EAAE,KAAK,CAAC,EAAE,CAAE,CAAC,IAAI;SACtB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA4B,EAC5B,OAAsB,EACtB,QAAgB;IAEhB,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;IACxD,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC;QAClE,YAAY,CAAC,IAAI,CAAC;YAChB,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO;SAC/C,CAAC,CAAC;IACL,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;AACtE,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IAIvD,OAAO;QACL,CAAC,sBAAsB,CAAC,EAAE;YACxB,CAAC,EAAE,CAAC;YACJ,oEAAoE;YACpE,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;YACxD,YAAY,EAAE,MAAM,CAAC,WAAW,CAC9B,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAC1D;SACF;QACD,CAAC,4BAA4B,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAChC,QAAiB,EACjB,MAAoB;IAEpB,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,CACL,QAAQ,CAAC,QAAQ,CAAC;QAClB,iBAAiB,CACf,QAAQ,CAAC,sBAAsB,CAAC,EAChC,MAAM,CAAC,sBAAsB,CAAC,CAC/B;QACD,iBAAiB,CACf,QAAQ,CAAC,4BAA4B,CAAC,EACtC,MAAM,CAAC,4BAA4B,CAAC,CACrC,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAiB,EACjB,EACE,UAAU,GAAG,KAAK,EAClB,gBAAgB,GAAG,KAAK,GACzB,GAAyD,EAAE;IAE5D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO;IAChC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,GACR,CAAC,UAAU;YACT,CAAC,GAAG,KAAK,sBAAsB;gBAC7B,GAAG,KAAK,4BAA4B,CAAC,CAAC;YAC1C,CAAC,gBAAgB,IAAI,GAAG,KAAK,4BAA4B,CAAC,CAAC;QAC7D,IAAI,GAAG,CAAC,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI;YACxD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,mBAAmB,CAAC,QAAiB;IACnD,OAAO,CACL,QAAQ,CAAC,QAAQ,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACjC,GAAG,CAAC,UAAU,CAAC,6BAA6B,CAAC,CAC9C,CACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CACxE,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/runtime/types.d.ts

@@ -1,10 +1,12 @@
 import type { LangGraphRunnableConfig } from "@langchain/langgraph";
 import type { ServerRuntime } from "@langchain/langgraph-sdk";
+import type { BrowserDefinition } from "../browser.js";
 import type { IdentityDefinition } from "../identity/index.js";
 import type { MemoryDefinition } from "../memory/index.js";
 import type { SandboxDefinition } from "../sandbox.js";
 import type { Channel } from "./channel.js";
 import type { ManagedRuntimeExtras } from "./managed-tools.js";
+import type { ManagedThread } from "./managed-thread.js";
 import type { Connector } from "./connector.js";
 /**
  * The LangGraph runnable config passed to a graph factory at invocation time.
@@ -14,7 +16,10 @@ import type { Connector } from "./connector.js";
  */
 export type ManagedRunConfig = LangGraphRunnableConfig<Record<string, unknown>>;
 /** Native Agent Server factory runtime with managed fields. */
-export type ManagedServerRuntime<AppContext = Record<string, unknown>> = ServerRuntime<AppContext> & ManagedRuntimeExtras;
+export type ManagedServerRuntime<AppContext = Record<string, unknown>> = ServerRuntime<AppContext> & Omit<ManagedRuntimeExtras, "thread"> & {
+    /** The run's thread; `null` outside a run, such as for graph inspection. */
+    thread?: ManagedThread | null;
+};
 /**
  * Managed values the CLI injects into the generated entry module.
  *
@@ -69,6 +74,8 @@ export interface ManagedAgentOptions {
      * not select memory, and remains independent of identity.
      */
     memory?: MemoryDefinition<never>;
+    /** The root `browser.ts` declaration, if the project gives the agent a browser. */
+    browser?: BrowserDefinition;
     /**
      * Harbor eval trial workspace root (usually `/app`). When set, the managed
      * runtime installs a disk `FilesystemBackend` so verifier-visible writes land
@@ -85,5 +92,9 @@ export interface ManagedAgentOptions {
      * CLI's own `command_completed`.
      */
     reportTelemetry?: boolean;
+    /** Graph id of each async subagent, by name (set by the generated entry). */
+    asyncSubagentGraphs?: Readonly<Record<string, string>>;
+    /** Build this async subagent's own graph instead of the lead's. */
+    asyncSubagent?: string;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhF,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACnE,aAAa,CAAC,UAAU,CAAC,GAAG,oBAAoB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACjC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhF,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACnE,aAAa,CAAC,UAAU,CAAC,GACvB,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,GAAG;IACrC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEN;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACjC,mFAAmF;IACnF,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/runtime-schedules.d.ts

@@ -1,5 +1,6 @@
 import type { JsonValue } from "./channels/types.js";
 import { type RuntimeConfigLike } from "./runtime/identity-runtime.js";
+import type { ThreadParticipant } from "./runtime/managed-thread.js";
 import type { ScheduleDeliveryTarget, ScheduleThreadConfig } from "./schedules.js";
 export type ScheduleOwner = {
     type: "agent";
@@ -34,6 +35,14 @@ export type ScheduleCreate = Timing & Input & {
     paused?: boolean;
     metadata?: Record<string, JsonValue>;
     context?: Record<string, JsonValue>;
+    /**
+     * Run the schedule as this participant of the current thread instead of
+     * the caller. Needs `owner: { type: "user" }`; the caller still owns the
+     * schedule.
+     *
+     * @experimental This may change in a minor release.
+     */
+    runAs?: ThreadParticipant | null;
 };
 export type SchedulePatch = ({
     cron?: string;
@@ -68,8 +77,14 @@ export interface ScheduleRecord {
     input?: ScheduleInput;
     thread: ScheduleThreadConfig;
     newThread: boolean;
+    /**
+     * The channel a new-thread schedule posts to. `null` for a same-thread
+     * schedule, whose thread decides at each run.
+     */
     channel: string | null;
     target: JsonValue;
+    /** Who the schedule runs as, when not its owner. */
+    runAs: ThreadParticipant | null;
     deliverTo?: ScheduleDeliveryTarget;
     context?: Record<string, JsonValue>;
     paused: boolean;

package/dist/runtime-schedules.d.ts.map

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

package/dist/runtime-schedules.js

@@ -1,11 +1,12 @@
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
-import { readScheduleDeliverTo } from "./channels/schedule-delivery.js";
+import { getDeploymentId, readScheduleDeliverTo, } from "./channels/schedule-delivery.js";
 import { resolveAgentAuthContext, resolveOwnerId } from "./connections.js";
 import { buildRuntimeIdentity, resolveAuthUser, resolveRuntimeConfigurable, } from "./runtime/identity-runtime.js";
-import { SCHEDULE_LIMIT_PREFIX, scheduleRequestConfig, } from "./runtime/schedule-auth.js";
-import { captureScheduleChannel } from "./schedule-channel.js";
+import { SCHEDULE_LIMIT_PREFIX, runAsSchema, scheduleRequestConfig, } from "./runtime/schedule-auth.js";
+import { scheduleThread } from "./schedule-channel.js";
 import { channelContextSchema, isManagedKey } from "./run-context.js";
+import { THREAD_RECORD_METADATA_PREFIX, bindingFromOrigin, isPersonPrincipal, originFromBinding, parseThreadRecord, threadRecordMetadata, } from "./runtime/thread-record.js";
 import { scheduleTiming } from "./schedule-time.js";
 const ownerSchema = z.union([
     z.strictObject({ type: z.literal("agent") }),
@@ -36,7 +37,7 @@ const contextSchema = z
     .refine((value) => !Object.keys(value).some(isManagedKey), "Context keys mda_* are reserved");
 const metadataSchema = z
     .record(z.string(), z.json())
-    .refine((value) => Object.keys(value).every((key) => !key.startsWith("mda_")), "Metadata keys starting with mda_ are reserved");
+    .refine((value) => Object.keys(value).every((key) => !isReservedMetadataKey(key)), "Metadata keys starting with mda_ or ls_mda_ are reserved");
 const fields = {
     cron: z.string().optional(),
     at: z.string().optional(),
@@ -47,6 +48,7 @@ const fields = {
     newThread: z.boolean().optional(),
     paused: z.boolean().optional(),
     metadata: metadataSchema.optional(),
+    runAs: runAsSchema.nullable().optional(),
 };
 const specSchema = z.strictObject(fields);
 const createSchema = specSchema.omit({ deliverTo: true }).extend({
@@ -55,7 +57,7 @@ const createSchema = specSchema.omit({ deliverTo: true }).extend({
     context: contextSchema.optional(),
 });
 const patchSchema = specSchema
-    .omit({ deliverTo: true, newThread: true })
+    .omit({ deliverTo: true, newThread: true, runAs: true })
     .extend({
     at: z.union([z.string(), z.date()]).optional(),
     context: contextSchema.optional(),
@@ -78,22 +80,27 @@ const wireSchema = z.object({
             .optional(),
     }),
 });
+function isReservedMetadataKey(key) {
+    return (key.startsWith("mda_") || key.startsWith(THREAD_RECORD_METADATA_PREFIX));
+}
 function readSpec(raw) {
-    const { deliver_to, new_thread, ...rest } = z
+    const { deliver_to, new_thread, run_as, ...rest } = z
         .record(z.string(), z.unknown())
         .parse(raw ?? {});
     return specSchema.parse({
         ...rest,
         ...(new_thread !== undefined ? { newThread: new_thread } : {}),
+        ...(run_as !== undefined ? { runAs: run_as } : {}),
         ...(deliver_to ? { deliverTo: readScheduleDeliverTo(deliver_to) } : {}),
     });
 }
 function writeSpec(spec) {
-    const { deliverTo, newThread, metadata: _metadata, input: _input, ...rest } = spec;
+    const { deliverTo, newThread, runAs, metadata: _metadata, input: _input, ...rest } = spec;
     const to = deliverTo?.to;
     return {
         ...rest,
         ...(newThread !== undefined ? { new_thread: newThread } : {}),
+        ...(runAs !== undefined ? { run_as: runAs } : {}),
         ...(deliverTo && to
             ? {
                 deliver_to: {
@@ -130,8 +137,7 @@ async function context(owner, config) {
     const selected = ownerSchema.parse(owner);
     const identity = buildRuntimeIdentity(config);
     const assistant = z.string().uuid().parse(config.assistant_id);
-    const deployment = process.env.LANGSMITH_HOST_PROJECT_ID?.trim() ||
-        process.env.LANGGRAPH_CLOUD_ID?.trim();
+    const deployment = getDeploymentId();
     if (!deployment)
         throw new Error("Schedules require a deployment ID");
     if (!identity)
@@ -236,9 +242,12 @@ function record(wire, ctx, now = Date.now()) {
     const routing = wire.payload.context ?? wire.payload.config?.configurable;
     const schedule = routing?.mda_schedule;
     const deliverTo = spec.deliverTo ?? readScheduleDeliverTo(schedule?.deliver_to);
+    // New-thread schedules carry their thread's record; older ones a channel.
+    const stored = parseThreadRecord(wire.metadata)?.origin;
     const rawChannel = routing?.mda_channel ??
         (wire.payload.context == null ? routing?.channel : undefined);
-    const channel = rawChannel == null ? undefined : channelContextSchema.parse(rawChannel);
+    const channel = (stored && bindingFromOrigin(stored)) ??
+        (rawChannel == null ? undefined : channelContextSchema.parse(rawChannel));
     const context = Object.fromEntries(Object.entries(wire.payload.context ?? {}).filter(([key]) => !isManagedKey(key)));
     const managedBy = wire.metadata.mda_managed_by;
     if (managedBy !== "runtime" && managedBy !== "deploy")
@@ -247,12 +256,13 @@ function record(wire, ctx, now = Date.now()) {
         id: wire.cron_id,
         owner: {
             type: ctx.access.owner === "agent" ? "agent" : "user",
+            // Not the execution's: a schedule can run as someone else.
             id: ctx.access.owner === "agent"
                 ? ctx.deployment
-                : ctx.access.execution.mda_user_id,
+                : ctx.access.owner.slice("user:".length),
         },
         managedBy,
-        metadata: metadataSchema.parse(Object.fromEntries(Object.entries(wire.metadata).filter(([key]) => !key.startsWith("mda_")))),
+        metadata: metadataSchema.parse(Object.fromEntries(Object.entries(wire.metadata).filter(([key]) => !isReservedMetadataKey(key)))),
         ...(spec.at ? { at: spec.at } : { cron: wire.schedule }),
         timezone: spec.timezone ?? wire.timezone ?? "UTC",
         ...(spec.prompt ? { prompt: spec.prompt } : { input: wire.payload.input }),
@@ -264,6 +274,7 @@ function record(wire, ctx, now = Date.now()) {
         newThread: spec.newThread ?? !wire.thread_id,
         channel: channel?.name ?? null,
         target: channel?.target ?? null,
+        runAs: spec.runAs ?? null,
         paused: !wire.enabled,
         expired: wire.end_time != null && Date.parse(wire.end_time) < now,
     };
@@ -293,6 +304,52 @@ async function verifyTarget(wire, target, ctx, created = true) {
         throw new Error(`One-time target was missed; schedule ${created ? "removed" : "paused"}`);
     }
 }
+/**
+ * Run a schedule as a participant of the current thread. The caller keeps
+ * owning it; only the identity its runs act as changes.
+ */
+async function runAsParticipant(ctx, owner, runAs, run) {
+    if (owner.type !== "user")
+        throw new Error('runAs requires owner { type: "user" }');
+    const participant = run.thread?.participants.find(({ id, role }) => id === runAs.id && role === runAs.role);
+    if (!participant)
+        throw new Error("runAs must be a participant of the current thread");
+    const origin = run.origin;
+    if (!origin)
+        throw new Error("runAs requires the thread's channel");
+    // A Trigger participant's id is their Agent Auth principal.
+    let principal = participant.id;
+    if (origin.transport !== "trigger_server") {
+        try {
+            principal = (await resolveAgentAuthContext({
+                user: { kind: "person", id: participant.id },
+                source: { provider: origin.provider },
+            })).principalId;
+        }
+        catch (error) {
+            throw new Error(`Cannot run the schedule as this participant: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    ctx.access.run_as = { id: participant.id, role: participant.role };
+    ctx.access.execution = {
+        identity: participant.id,
+        permissions: [],
+        mda_user_id: participant.id,
+        mda_agent_auth_principal_id: principal,
+        mda_source_provider: "schedule",
+        mda_scheduled_run: true,
+    };
+}
+/** The record a new-thread schedule's thread starts with. */
+function newThreadRecord(origin, run, access) {
+    const executor = access.execution.mda_user_id;
+    return threadRecordMetadata({
+        origin: originFromBinding(origin, run.thread?.origin?.sender?.id ?? null),
+        participants: access.owner !== "agent" && isPersonPrincipal(executor)
+            ? [{ id: executor, role: "owner" }]
+            : [],
+    });
+}
 /**
  * Bind schedule operations to a tool or middleware runtime. MDA attaches the
  * result as `runtime.schedules`; each call reads the run's trusted identity.
@@ -305,14 +362,17 @@ export function createRuntimeSchedules(runtime) {
             const input = runInput(value);
             const timing = scheduleTiming(value);
             const newThread = value.newThread ?? value.cron !== undefined;
-            const channel = captureScheduleChannel(configurable, newThread);
+            const run = scheduleThread(runtime, configurable);
+            const origin = run.origin;
             const threadId = configurable?.thread_id;
             if (!newThread && !threadId)
                 throw new Error("Same-thread schedules require a current thread; use newThread=true");
             const ctx = await context(value.owner, configurable);
-            if (channel) {
-                ctx.access.execution.mda_source_provider = channel.provider;
-                ctx.access.execution.mda_source_thread_id = channel.sourceThreadKey;
+            if (value.runAs)
+                await runAsParticipant(ctx, value.owner, value.runAs, run);
+            if (origin) {
+                ctx.access.execution.mda_source_provider = origin.provider;
+                ctx.access.execution.mda_source_thread_id = origin.sourceThreadKey;
             }
             else if (!newThread && value.owner.type === "agent") {
                 throw new Error("Agent-owned schedules outside a channel require newThread=true");
@@ -328,7 +388,7 @@ export function createRuntimeSchedules(runtime) {
                 }
             }
             const name = randomUUID();
-            const { owner: _owner, context: runContext, ...spec } = { ...value, newThread };
+            const { owner: _owner, context: runContext, ...spec } = { ...value, newThread, runAs: value.runAs ?? null };
             if (timing.at) {
                 spec.at = timing.at;
                 spec.timezone = "UTC";
@@ -343,16 +403,18 @@ export function createRuntimeSchedules(runtime) {
                 ...(timing.end_time ? { end_time: timing.end_time } : {}),
                 input,
                 enabled: !value.paused,
-                on_run_completed: (!newThread || channel
+                on_run_completed: (!newThread || origin
                     ? "keep"
                     : "delete"),
-                context: {
-                    mda_schedule: { name },
-                    ...(channel ? { mda_channel: channel } : {}),
-                    ...runContext,
-                },
+                // A same-thread schedule answers wherever its thread's record
+                // points when it runs, so it carries no channel of its own.
+                context: { mda_schedule: { name }, ...runContext },
                 metadata: {
                     ...value.metadata,
+                    // The cron's new thread starts with the conversation's record.
+                    ...(newThread &&
+                        origin &&
+                        newThreadRecord(origin, run, ctx.access)),
                     mda_managed: true,
                     mda_managed_by: "runtime",
                     mda_schedule: name,