managed-deepagents 0.10.0-dev.3 → 0.10.0-dev.5

package/dist/channels/linear/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/channels/linear/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,kFAAkF;AAClF,eAAO,MAAM,mBAAmB;;;;;;;iBAO9B,CAAC;AA+GH,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAiD/B,CAAC;AAEH,eAAO,MAAM,oBAAoB,qHAEhC,CAAC;AAyDF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAxBrB,MAAM;eAAS,MAAM;eAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyC3C,CAAC"}

package/dist/channels/linear/schema.js

@@ -0,0 +1,216 @@
+import { z } from "zod";
+// Shared scalar constraints. Linear identifiers are UUIDs, but only their
+// presence matters here.
+const nonblankStringSchema = z
+    .string()
+    .refine((value) => value.trim().length > 0);
+const optionalTextSchema = z.string().nullish();
+/** Receipt metadata only, not a complete Linear webhook payload specification. */
+export const linearReceiptSchema = z.object({
+    deliveryId: nonblankStringSchema,
+    payload: z.looseObject({
+        type: nonblankStringSchema,
+        action: nonblankStringSchema,
+        organizationId: z.string().optional(),
+    }),
+});
+const teamSchema = z.looseObject({
+    id: nonblankStringSchema,
+    key: nonblankStringSchema,
+    name: z.string().optional(),
+});
+const actorSchema = z.looseObject({
+    id: nonblankStringSchema,
+    type: z.string().optional(),
+    name: z.string().optional(),
+});
+// Payload subjects. Loose objects retain unmodeled provider fields.
+const issueSchema = z.looseObject({
+    id: nonblankStringSchema,
+    identifier: nonblankStringSchema,
+    title: z.string(),
+    description: optionalTextSchema,
+    url: z.string().optional(),
+    teamId: z.string().optional(),
+    team: teamSchema.optional(),
+    labelIds: z.array(z.string()).optional(),
+    labels: z
+        .array(z.looseObject({ id: z.string(), name: z.string() }))
+        .optional(),
+    botActor: z.unknown().optional(),
+});
+const commentSchema = z.looseObject({
+    id: nonblankStringSchema,
+    body: z.string(),
+    issueId: nonblankStringSchema,
+    parentId: z.string().nullish(),
+    userId: z.string().nullish(),
+    user: z
+        .looseObject({ id: z.string(), name: z.string().optional() })
+        .nullish(),
+    issue: z
+        .looseObject({
+        id: nonblankStringSchema,
+        identifier: z.string().optional(),
+        title: z.string().optional(),
+        url: z.string().optional(),
+        team: teamSchema.optional(),
+    })
+        .optional(),
+    botActor: z.unknown().optional(),
+});
+const sessionIssueSchema = z.looseObject({
+    id: nonblankStringSchema,
+    identifier: z.string().optional(),
+    title: z.string().optional(),
+    url: z.string().optional(),
+    description: optionalTextSchema,
+    team: teamSchema.optional(),
+});
+/** A Linear agent session: the app was mentioned or delegated an issue. */
+const agentSessionSchema = z.looseObject({
+    id: nonblankStringSchema,
+    status: z.string().optional(),
+    url: z.string().optional(),
+    issueId: z.string().nullish(),
+    issue: sessionIssueSchema.nullish(),
+    // The comment that started the session, when a mention did.
+    commentId: z.string().nullish(),
+    comment: z
+        .looseObject({ id: nonblankStringSchema, body: z.string().optional() })
+        .nullish(),
+    creatorId: z.string().nullish(),
+    creator: z
+        .looseObject({ id: nonblankStringSchema, name: z.string().optional() })
+        .nullish(),
+});
+/** What a user said in a session: a reply, or a signal such as `stop`. */
+const agentActivitySchema = z.looseObject({
+    content: z.looseObject({ type: z.string(), body: z.string().optional() }),
+    signal: z.string().nullish(),
+    signalMetadata: z.unknown().optional(),
+    sourceCommentId: z.string().nullish(),
+    userId: z.string().nullish(),
+    user: z
+        .looseObject({ id: nonblankStringSchema, name: z.string().optional() })
+        .nullish(),
+});
+// Common delivery context.
+const envelopeSchema = z.looseObject({
+    organizationId: nonblankStringSchema,
+    webhookId: z.string().optional(),
+    webhookTimestamp: z.number(),
+    createdAt: z.string().optional(),
+    url: z.string().optional(),
+    actor: actorSchema.optional(),
+});
+function dispatchEventSchema(key, payloadSchema) {
+    return z.object({
+        key: z.literal(key),
+        deliveryId: nonblankStringSchema,
+        payload: payloadSchema,
+    });
+}
+/** Each supported event key requires its exact type, action and subject. */
+export const linearDispatchSchema = z.discriminatedUnion("key", [
+    dispatchEventSchema("Issue.create", envelopeSchema.extend({
+        type: z.literal("Issue"),
+        action: z.literal("create"),
+        data: issueSchema,
+    })),
+    dispatchEventSchema("Issue.update", envelopeSchema.extend({
+        type: z.literal("Issue"),
+        action: z.literal("update"),
+        data: issueSchema,
+        // The changed fields' previous values.
+        updatedFrom: z.record(z.string(), z.unknown()).optional(),
+    })),
+    dispatchEventSchema("Comment.create", envelopeSchema.extend({
+        type: z.literal("Comment"),
+        action: z.literal("create"),
+        data: commentSchema,
+    })),
+    dispatchEventSchema("AgentSessionEvent.created", envelopeSchema.extend({
+        type: z.literal("AgentSessionEvent"),
+        action: z.literal("created"),
+        appUserId: z.string().optional(),
+        agentSession: agentSessionSchema,
+        // Linear's ready-made prompt: the issue, the thread and who asked.
+        promptContext: z.string().nullish(),
+        guidance: z.unknown().optional(),
+    })),
+    dispatchEventSchema("AgentSessionEvent.prompted", envelopeSchema.extend({
+        type: z.literal("AgentSessionEvent"),
+        action: z.literal("prompted"),
+        appUserId: z.string().optional(),
+        agentSession: agentSessionSchema,
+        agentActivity: agentActivitySchema,
+    })),
+]);
+export const SUPPORTED_EVENT_KEYS = linearDispatchSchema.options.map((option) => option.shape.key.value);
+/** The issue an event is about, wherever its payload keeps it. */
+function eventIssue(event) {
+    if (event.payload.type === "AgentSessionEvent") {
+        const session = event.payload.agentSession;
+        const id = session.issue?.id ?? session.issueId;
+        // Linear opens sessions on issues; one without could not be answered.
+        if (!id)
+            throw new TypeError("Linear agent session has no issue");
+        return { id, ...(session.issue?.team && { team: session.issue.team }) };
+    }
+    if (event.payload.type === "Comment") {
+        const { data } = event.payload;
+        return {
+            id: data.issueId,
+            ...(data.issue?.team && { team: data.issue.team }),
+        };
+    }
+    const { data } = event.payload;
+    return { id: data.id, ...(data.team && { team: data.team }) };
+}
+/**
+ * Who acted: the webhook's actor, or for a session the user who started it or
+ * replied in it.
+ */
+function eventActor(event) {
+    const payload = event.payload;
+    const person = payload.type !== "AgentSessionEvent"
+        ? payload.actor
+        : payload.action === "prompted"
+            ? (payload.agentActivity.user ??
+                (payload.agentActivity.userId
+                    ? { id: payload.agentActivity.userId }
+                    : undefined))
+            : (payload.agentSession.creator ??
+                (payload.agentSession.creatorId
+                    ? { id: payload.agentSession.creatorId }
+                    : undefined));
+    if (!person)
+        return undefined;
+    const { type, name } = person;
+    return {
+        id: person.id,
+        ...(typeof type === "string" && { type }),
+        ...(typeof name === "string" && { name }),
+    };
+}
+// Expose common routing metadata while preserving the original payload.
+export const linearEventSchema = linearDispatchSchema.transform((event) => {
+    const issue = eventIssue(event);
+    const actor = eventActor(event);
+    return {
+        ...event,
+        type: event.payload.type,
+        action: event.payload.action,
+        organizationId: event.payload.organizationId,
+        issueId: issue.id,
+        ...(issue.team && {
+            team: { id: issue.team.id, key: issue.team.key },
+        }),
+        ...(actor && { actor }),
+        ...(event.payload.type === "AgentSessionEvent" && {
+            sessionId: event.payload.agentSession.id,
+        }),
+    };
+});
+//# sourceMappingURL=schema.js.map

package/dist/channels/linear/schema.js.map

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

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

@@ -0,0 +1,112 @@
+import type { z } from "zod";
+import type { MultitaskStrategy } from "../../ingress/runs.js";
+import type { linearEventSchema } from "./schema.js";
+import type { ChannelRunResult } from "../run-input.js";
+/** Handwritten schema subsets; unmodeled provider fields remain unknown. */
+type EventUnion = z.output<typeof linearEventSchema>;
+export type LinearEventKey = EventUnion["key"];
+export type LinearEvent<K extends LinearEventKey = LinearEventKey> = Extract<EventUnion, {
+    key: K;
+}>;
+export type LinearPayloadFor<K extends LinearEventKey> = LinearEvent<K>["payload"];
+export interface LinearChannelRuntime {
+    channel: {
+        name: string;
+    };
+}
+/**
+ * What an event handler returns: a run's input, as `agent.invoke` takes it —
+ * a string, a message such as `new HumanMessage(...)`, state such as
+ * `{ messages: [...] }`, or `[input, { context }]`. `null` or `undefined`
+ * starts nothing.
+ */
+export type LinearEventResult = ChannelRunResult | null | undefined | void;
+export type LinearEventCallback<K extends LinearEventKey> = (event: LinearEvent<K>, runtime: LinearChannelRuntime) => LinearEventResult | Promise<LinearEventResult>;
+/** The Linear app `mda deploy` sets up: how it looks, and what it may do. */
+export interface LinearAppOptions {
+    /**
+     * The app's name, shown where people mention it and in its comments: 2–80
+     * characters, without "Linear" or a URL. Defaults to the agent's name.
+     * Deploy fills it in when the app is created; rename an existing app on
+     * its settings page in Linear.
+     */
+    name?: string;
+    /**
+     * What the app does, shown when a workspace admin installs it: up to 1,000
+     * characters. Like `name`, it applies when the app is created.
+     */
+    description?: string;
+    /**
+     * The app's icon: a PNG or JPEG image, as a path relative to `channels/`
+     * like the Slack channel's `icon`, such as `assets/icon.png`. At least
+     * 256×256 pixels and at most 1 MB. The deployment serves it at
+     * `/channels/{name}/icon`, and deploy points the new app's icon there.
+     */
+    icon?: string;
+    /**
+     * Keys of the teams (as in `ENG-123`) the channel is limited to: events
+     * about other teams' issues start nothing. Defaults to every team the app
+     * can see. The app's token still reaches every team it was granted, so
+     * limit its team access in Linear too.
+     */
+    teams?: string[];
+}
+/**
+ * Options for `channels.linear(...)`: the app's scope and event handlers that
+ * start runs. Each issue is one conversation.
+ */
+export interface LinearChannelOptions {
+    /** The Linear app `mda deploy` sets up: its name, description, icon and teams. */
+    app?: LinearAppOptions;
+    /**
+     * What an event that starts a run does while its conversation already
+     * runs: `enqueue` (the default) waits for the run and starts after it,
+     * `interrupt` cancels the run, keeping its progress, and starts at once,
+     * `rollback` cancels it and discards its progress, and `reject` starts
+     * nothing.
+     *
+     * @example
+     * ```ts
+     * // A newer comment replaces the work on an older one.
+     * channels.linear({ multitaskStrategy: "interrupt", onEvent })
+     * ```
+     */
+    multitaskStrategy?: MultitaskStrategy;
+    /**
+     * Event handlers that start runs. Return a prompt (string, message, or
+     * state), or nothing to skip. The run's final reply is posted as a comment
+     * on the issue, under the comment that started it.
+     *
+     * @example
+     * ```ts
+     * { "Issue.create": (e) => `Triage ${e.payload.data.identifier}` }
+     * ```
+     *
+     * In agent sessions the reply goes to the session instead.
+     */
+    onEvent?: {
+        [K in LinearEventKey]?: LinearEventCallback<K>;
+    };
+    /**
+     * Answer Linear agent sessions, which open when someone mentions the app or
+     * delegates an issue to it. Defaults to `true`. Without a handler, a new
+     * session runs with Linear's prompt for it (`promptContext`), and a reply
+     * in the session continues the conversation. The run's progress and reply
+     * show in the session, and Stop cancels the run. A run that stops on
+     * interrupts answers with a link to its thread in LangSmith Studio, where
+     * they are resumed.
+     *
+     * @experimental Sessions use Linear's Agents API, a Developer Preview, so
+     * they may change as Linear changes it.
+     */
+    sessions?: boolean;
+    /**
+     * Ignore changes made by other apps and integrations (a delivery whose
+     * actor isn't a person, or the creation of an issue or comment with a
+     * `botActor`), so automations don't trigger each other. Defaults to `true`.
+     * The app's own changes are always ignored.
+     */
+    ignoreBots?: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/channels/linear/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,4EAA4E;AAC5E,KAAK,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACrD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI,OAAO,CAC1E,UAAU,EACV;IAAE,GAAG,EAAE,CAAC,CAAA;CAAE,CACX,CAAC;AACF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,IACnD,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;AAE3E,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,cAAc,IAAI,CAC1D,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,OAAO,EAAE,oBAAoB,KAC1B,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEpD,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE;SAAG,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;KAAE,CAAC;IAC7D;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/channels/linear/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/channels/linear/types.ts"],"names":[],"mappings":""}

package/dist/channels/reserved-connections.d.ts

@@ -1,7 +1,7 @@
 /**
  * Why a channel's reserved agent connection cannot be read as a user
- * connection, or undefined for any other slug. Reading the GitHub App's token
- * as the person running the agent is not supported yet.
+ * connection, or undefined for any other slug. Reading an app's token as the
+ * person running the agent is not supported yet.
  */
 export declare function reservedUserConnectionError(slug: string): string | undefined;
 /**

package/dist/channels/reserved-connections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reserved-connections.d.ts","sourceRoot":"","sources":["../../src/channels/reserved-connections.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ5E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,CAGR"}
+{"version":3,"file":"reserved-connections.d.ts","sourceRoot":"","sources":["../../src/channels/reserved-connections.ts"],"names":[],"mappings":"AAuCA;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS5E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,CAGR"}

package/dist/channels/reserved-connections.js

@@ -1,28 +1,45 @@
 import { GITHUB_TOKEN_SLUG, githubAppConnectionSlug, } from "./github/connections.js";
+import { LINEAR_TOKEN_SLUG, linearAppConnectionSlug, } from "./linear/connections.js";
 // First-party channels' reserved agent connection names, listed here so
 // resolution does not depend on adapter modules being loaded.
 const builtinReservedConnections = new Map([
-    [GITHUB_TOKEN_SLUG, (deploymentId) => githubAppConnectionSlug(deploymentId)],
+    [
+        GITHUB_TOKEN_SLUG,
+        {
+            resolve: githubAppConnectionSlug,
+            token: "the GitHub App's installation token",
+            actsAs: "act on GitHub as the App",
+        },
+    ],
+    [
+        LINEAR_TOKEN_SLUG,
+        {
+            resolve: linearAppConnectionSlug,
+            token: "the Linear app's token",
+            actsAs: "act in Linear as the app",
+        },
+    ],
 ]);
 /**
  * Why a channel's reserved agent connection cannot be read as a user
- * connection, or undefined for any other slug. Reading the GitHub App's token
- * as the person running the agent is not supported yet.
+ * connection, or undefined for any other slug. Reading an app's token as the
+ * person running the agent is not supported yet.
  */
 export function reservedUserConnectionError(slug) {
-    if (!builtinReservedConnections.has(slug))
+    const reserved = builtinReservedConnections.get(slug);
+    if (!reserved)
         return undefined;
     const name = JSON.stringify(slug);
-    return (`${name} is not supported as a user connection yet: it is the GitHub App's ` +
-        `installation token, an agent connection. Use connections.get(${name}, ` +
-        `{ type: "agent" }) to act on GitHub as the App.`);
+    return (`${name} is not supported as a user connection yet: it is ${reserved.token}, ` +
+        `an agent connection. Use connections.get(${name}, { type: "agent" }) to ` +
+        `${reserved.actsAs}.`);
 }
 /**
  * The connection that actually holds a channel's reserved agent connection;
  * other slugs pass through unchanged.
  */
 export function reservedAgentConnectionSlug(slug, deploymentId) {
-    const resolve = builtinReservedConnections.get(slug);
-    return resolve && deploymentId ? resolve(deploymentId) : slug;
+    const reserved = builtinReservedConnections.get(slug);
+    return reserved && deploymentId ? reserved.resolve(deploymentId) : slug;
 }
 //# sourceMappingURL=reserved-connections.js.map

package/dist/channels/reserved-connections.js.map

@@ -1 +1 @@
-{"version":3,"file":"reserved-connections.js","sourceRoot":"","sources":["../../src/channels/reserved-connections.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,wEAAwE;AACxE,8DAA8D;AAC9D,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAGxC;IACA,CAAC,iBAAiB,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAC;CAC7E,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,CACL,GAAG,IAAI,qEAAqE;QAC5E,gEAAgE,IAAI,IAAI;QACxE,iDAAiD,CAClD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,YAAgC;IAEhC,MAAM,OAAO,GAAG,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChE,CAAC"}
+{"version":3,"file":"reserved-connections.js","sourceRoot":"","sources":["../../src/channels/reserved-connections.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,wEAAwE;AACxE,8DAA8D;AAC9D,MAAM,0BAA0B,GAAG,IAAI,GAAG,CASxC;IACA;QACE,iBAAiB;QACjB;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,qCAAqC;YAC5C,MAAM,EAAE,0BAA0B;SACnC;KACF;IACD;QACE,iBAAiB;QACjB;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,wBAAwB;YAC/B,MAAM,EAAE,0BAA0B;SACnC;KACF;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,MAAM,QAAQ,GAAG,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,CACL,GAAG,IAAI,qDAAqD,QAAQ,CAAC,KAAK,IAAI;QAC9E,4CAA4C,IAAI,0BAA0B;QAC1E,GAAG,QAAQ,CAAC,MAAM,GAAG,CACtB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,YAAgC;IAEhC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC"}

package/dist/channels/source-providers.js

@@ -1,6 +1,6 @@
 const declaredProviders = new Set();
 // Keep first-party ingress working before adapter modules are loaded.
-const builtinProviders = new Set(["slack", "github"]);
+const builtinProviders = new Set(["slack", "github", "linear"]);
 /** Register declared providers independently of outbound messaging support. */
 export function registerDeclaredSourceProviders(sources) {
     const providers = new Set();

package/dist/channels/source-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-providers.js","sourceRoot":"","sources":["../../src/channels/source-providers.ts"],"names":[],"mappings":"AAMA,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;AAC5C,sEAAsE;AACtE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEtD,+EAA+E;AAC/E,MAAM,UAAU,+BAA+B,CAC7C,OAAkC;IAElC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,SAAS;QAC3B,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1D,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,YAAY,GAChB,OAAO,MAAM,CAAC,YAAY,KAAK,UAAU;YACvC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;YAClC,CAAC,CAAC,SAAS,CAAC;QAChB,IACE,OAAO,YAAY,EAAE,QAAQ,KAAK,QAAQ;YAC1C,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,EAC5B,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,0EAA0E;IAC1E,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"source-providers.js","sourceRoot":"","sources":["../../src/channels/source-providers.ts"],"names":[],"mappings":"AAMA,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;AAC5C,sEAAsE;AACtE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEhE,+EAA+E;AAC/E,MAAM,UAAU,+BAA+B,CAC7C,OAAkC;IAElC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,SAAS;QAC3B,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1D,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,YAAY,GAChB,OAAO,MAAM,CAAC,YAAY,KAAK,UAAU;YACvC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;YAClC,CAAC,CAAC,SAAS,CAAC;QAChB,IACE,OAAO,YAAY,EAAE,QAAQ,KAAK,QAAQ;YAC1C,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,EAC5B,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,0EAA0E;IAC1E,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC3E,CAAC"}

package/dist/connections.d.ts

@@ -71,6 +71,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;
 /**
@@ -82,11 +87,17 @@ export declare function resolveOwnerId(owner: ConnectionOwner, identity: Runtime
  */
 export declare function resolveAgentAuthContext(identity: RuntimeIdentity | undefined, env?: NodeJS.ProcessEnv, fetchImpl?: typeof fetch, timeoutMs?: number): Promise<AgentAuthContext>;
 /**
- * Why a run on a channel's conversation gets no user connections, even when a
- * person resumes it from Studio: the conversation holds content from outside
- * the workspace, which must not steer a person's grants.
+ * 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 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

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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"}

package/dist/connections.js

@@ -77,7 +77,8 @@ export class AgentAuthConnectionStore {
     }
     async fetch(request) {
         if (this.env.MDA_LOCAL_DEV === "1" && request.owner.type === "agent") {
-            const value = this.env[agentConnectionEnvKey(request.slug)];
+            const value = this.env[agentConnectionEnvKey(request.slug)] ??
+                this.env[legacyAgentConnectionEnvKey(request.slug)];
             if (value !== undefined && value.trim()) {
                 return value;
             }
@@ -170,7 +171,19 @@ export class Connections {
         return value;
     }
 }
+/**
+ * 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 function agentConnectionEnvKey(slug) {
+    return `${DEV_CREDENTIAL_PREFIX}${normalizeSlug(slug)
+        .toUpperCase()
+        .replaceAll("-", "_")
+        .replaceAll("/", "__")}`;
+}
+/** The earlier spelling, with `/` kept; Linux shells drop such names. */
+function legacyAgentConnectionEnvKey(slug) {
     return `${DEV_CREDENTIAL_PREFIX}${normalizeSlug(slug)
         .toUpperCase()
         .replaceAll("-", "_")}`;
@@ -246,13 +259,24 @@ export async function resolveAgentAuthContext(identity, env = process.env, fetch
     };
 }
 /**
- * Why a run on a channel's conversation gets no user connections, even when a
- * person resumes it from Studio: the conversation holds content from outside
- * the workspace, which must not steer a person's grants.
+ * 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 const CHANNEL_THREAD_USER_CONNECTION_ERROR = "user-owned connections are unavailable when resuming a channel's " +
+    "conversation from outside that channel: it holds content from outside " +
+    "the workspace, which must not act with your grants";
+/**
+ * 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 const CHANNEL_THREAD_USER_CONNECTION_ERROR = "user-owned connections are unavailable in a channel's conversation: " +
-    "it holds content from outside the workspace, so its runs never act " +
-    "with a person's grants, including runs resumed from Studio";
+export function outsideCallerOnChannelThread(identity) {
+    if (!onChannelThread())
+        return false;
+    const provider = identity?.source.provider;
+    return !provider || !isTrustedSourceProvider(provider);
+}
 /**
  * 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
@@ -279,8 +303,7 @@ export async function resolveCredentialPrincipalId(identity, config, fetchImpl =
     if (!identity?.user.id) {
         throw new CredentialStoreError("user connections require an authenticated user principal");
     }
-    // A channel run gets the channel's own reason below.
-    if (!channelProvider(identity) && onChannelThread()) {
+    if (outsideCallerOnChannelThread(identity)) {
         throw new CredentialStoreError(CHANNEL_THREAD_USER_CONNECTION_ERROR);
     }
     if (identity.user.kind === "service") {