agent-dealer 1.2.13 → 1.2.15

package/bundle/server/static-ui/index.html

@@ -8,7 +8,7 @@
     <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
     <meta name="theme-color" content="#0a0e14" />
     <link rel="preload" href="/fonts/Monaco.ttf" as="font" type="font/ttf" crossorigin />
-    <script type="module" crossorigin src="/assets/index-BzLjMBI9.js"></script>
+    <script type="module" crossorigin src="/assets/index-DVyqblie.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-COYJxD1y.css">
   </head>
   <body>

package/bundle/shared/dist/index.d.ts

@@ -593,16 +593,16 @@ export declare const Artifact: z.ZodObject<{
     createdAt: string;
     kind: "slack_draft" | "email_draft" | "service_draft" | "task_snapshot" | "draft_plan" | "approved_plan" | "plan_triage" | "plan_answers" | "acceptance_criteria" | "transcript" | "stream_trace" | "usage" | "agent_session" | "execution_result" | "diff" | "pr" | "document" | "research_brief" | "deliverable" | "feedback" | "playbook_patch" | "playbook_use_receipt" | "deck_feedback_signal" | "reflect_status" | "linear_sync" | "send_receipt" | "result_qa";
     runId: string;
-    contentJson: string | null;
     blobPath: string | null;
+    contentJson: string | null;
     author: "human" | "system" | "agent";
 }, {
     id: string;
     createdAt: string;
     kind: "slack_draft" | "email_draft" | "service_draft" | "task_snapshot" | "draft_plan" | "approved_plan" | "plan_triage" | "plan_answers" | "acceptance_criteria" | "transcript" | "stream_trace" | "usage" | "agent_session" | "execution_result" | "diff" | "pr" | "document" | "research_brief" | "deliverable" | "feedback" | "playbook_patch" | "playbook_use_receipt" | "deck_feedback_signal" | "reflect_status" | "linear_sync" | "send_receipt" | "result_qa";
     runId: string;
-    contentJson: string | null;
     blobPath: string | null;
+    contentJson: string | null;
     author: "human" | "system" | "agent";
 }>;
 export type Artifact = z.infer<typeof Artifact>;
@@ -994,6 +994,12 @@ export declare const LinearCandidate: z.ZodObject<{
     state: z.ZodOptional<z.ZodString>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     teamId: z.ZodOptional<z.ZodString>;
+    /**
+     * NOT-362: Linear's own suggested branch name for the issue. Intake persists
+     * it as the Dealer issue's branch so Linear's GitHub integration can link
+     * the PR on repositories it covers.
+     */
+    branchName: z.ZodOptional<z.ZodString>;
     /**
      * NOT-242: server-resolved repository hint read from explicit `repo:` labels.
      * Raw labels stay on the candidate; this is the deterministic read of them.
@@ -1017,6 +1023,29 @@ export declare const LinearCandidate: z.ZodObject<{
         labels?: string[] | undefined;
         error?: string | undefined;
     }>>;
+    /**
+     * NOT-364: the issue's own file/link attachments (never comment uploads).
+     * Hosted files are snapshotted at import/reload; links stay metadata only.
+     */
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+        subtitle: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        url: string;
+        subtitle?: string | undefined;
+        source?: string | undefined;
+    }, {
+        id: string;
+        title: string;
+        url: string;
+        subtitle?: string | undefined;
+        source?: string | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     title: string;
@@ -1026,6 +1055,7 @@ export declare const LinearCandidate: z.ZodObject<{
     labels?: string[] | undefined;
     state?: string | undefined;
     teamId?: string | undefined;
+    branchName?: string | undefined;
     repoResolution?: {
         status: "resolved" | "unresolved" | "conflict" | "invalid";
         repository?: string | undefined;
@@ -1033,6 +1063,13 @@ export declare const LinearCandidate: z.ZodObject<{
         labels?: string[] | undefined;
         error?: string | undefined;
     } | undefined;
+    attachments?: {
+        id: string;
+        title: string;
+        url: string;
+        subtitle?: string | undefined;
+        source?: string | undefined;
+    }[] | undefined;
 }, {
     id: string;
     title: string;
@@ -1042,6 +1079,7 @@ export declare const LinearCandidate: z.ZodObject<{
     labels?: string[] | undefined;
     state?: string | undefined;
     teamId?: string | undefined;
+    branchName?: string | undefined;
     repoResolution?: {
         status: "resolved" | "unresolved" | "conflict" | "invalid";
         repository?: string | undefined;
@@ -1049,6 +1087,13 @@ export declare const LinearCandidate: z.ZodObject<{
         labels?: string[] | undefined;
         error?: string | undefined;
     } | undefined;
+    attachments?: {
+        id: string;
+        title: string;
+        url: string;
+        subtitle?: string | undefined;
+        source?: string | undefined;
+    }[] | undefined;
 }>;
 export type LinearCandidate = z.infer<typeof LinearCandidate>;
 export declare const LinearIntakeConfig: z.ZodObject<{
@@ -1274,6 +1319,12 @@ export declare const LinearCandidatesPage: z.ZodObject<{
         state: z.ZodOptional<z.ZodString>;
         labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         teamId: z.ZodOptional<z.ZodString>;
+        /**
+         * NOT-362: Linear's own suggested branch name for the issue. Intake persists
+         * it as the Dealer issue's branch so Linear's GitHub integration can link
+         * the PR on repositories it covers.
+         */
+        branchName: z.ZodOptional<z.ZodString>;
         /**
          * NOT-242: server-resolved repository hint read from explicit `repo:` labels.
          * Raw labels stay on the candidate; this is the deterministic read of them.
@@ -1297,6 +1348,29 @@ export declare const LinearCandidatesPage: z.ZodObject<{
             labels?: string[] | undefined;
             error?: string | undefined;
         }>>;
+        /**
+         * NOT-364: the issue's own file/link attachments (never comment uploads).
+         * Hosted files are snapshotted at import/reload; links stay metadata only.
+         */
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            url: z.ZodString;
+            subtitle: z.ZodOptional<z.ZodString>;
+            source: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            url: string;
+            subtitle?: string | undefined;
+            source?: string | undefined;
+        }, {
+            id: string;
+            title: string;
+            url: string;
+            subtitle?: string | undefined;
+            source?: string | undefined;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         title: string;
@@ -1306,6 +1380,7 @@ export declare const LinearCandidatesPage: z.ZodObject<{
         labels?: string[] | undefined;
         state?: string | undefined;
         teamId?: string | undefined;
+        branchName?: string | undefined;
         repoResolution?: {
             status: "resolved" | "unresolved" | "conflict" | "invalid";
             repository?: string | undefined;
@@ -1313,6 +1388,13 @@ export declare const LinearCandidatesPage: z.ZodObject<{
             labels?: string[] | undefined;
             error?: string | undefined;
         } | undefined;
+        attachments?: {
+            id: string;
+            title: string;
+            url: string;
+            subtitle?: string | undefined;
+            source?: string | undefined;
+        }[] | undefined;
     }, {
         id: string;
         title: string;
@@ -1322,6 +1404,7 @@ export declare const LinearCandidatesPage: z.ZodObject<{
         labels?: string[] | undefined;
         state?: string | undefined;
         teamId?: string | undefined;
+        branchName?: string | undefined;
         repoResolution?: {
             status: "resolved" | "unresolved" | "conflict" | "invalid";
             repository?: string | undefined;
@@ -1329,6 +1412,13 @@ export declare const LinearCandidatesPage: z.ZodObject<{
             labels?: string[] | undefined;
             error?: string | undefined;
         } | undefined;
+        attachments?: {
+            id: string;
+            title: string;
+            url: string;
+            subtitle?: string | undefined;
+            source?: string | undefined;
+        }[] | undefined;
     }>, "many">;
     hasMore: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
@@ -1341,6 +1431,7 @@ export declare const LinearCandidatesPage: z.ZodObject<{
         labels?: string[] | undefined;
         state?: string | undefined;
         teamId?: string | undefined;
+        branchName?: string | undefined;
         repoResolution?: {
             status: "resolved" | "unresolved" | "conflict" | "invalid";
             repository?: string | undefined;
@@ -1348,6 +1439,13 @@ export declare const LinearCandidatesPage: z.ZodObject<{
             labels?: string[] | undefined;
             error?: string | undefined;
         } | undefined;
+        attachments?: {
+            id: string;
+            title: string;
+            url: string;
+            subtitle?: string | undefined;
+            source?: string | undefined;
+        }[] | undefined;
     }[];
     hasMore: boolean;
 }, {
@@ -1360,6 +1458,7 @@ export declare const LinearCandidatesPage: z.ZodObject<{
         labels?: string[] | undefined;
         state?: string | undefined;
         teamId?: string | undefined;
+        branchName?: string | undefined;
         repoResolution?: {
             status: "resolved" | "unresolved" | "conflict" | "invalid";
             repository?: string | undefined;
@@ -1367,6 +1466,13 @@ export declare const LinearCandidatesPage: z.ZodObject<{
             labels?: string[] | undefined;
             error?: string | undefined;
         } | undefined;
+        attachments?: {
+            id: string;
+            title: string;
+            url: string;
+            subtitle?: string | undefined;
+            source?: string | undefined;
+        }[] | undefined;
     }[];
     hasMore: boolean;
 }>;

package/bundle/shared/dist/index.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { LinearRepoResolution } from "./linear-intake.js";
+import { LinearAttachment, LinearRepoResolution } from "./linear-intake.js";
 import { Runtime } from "./runtime.js";
 import { AgentWithHealth } from "./agents.js";
 import { PhaseBudget, RunBudget } from "./budget.js";
@@ -267,11 +267,22 @@ export const LinearCandidate = z.object({
     state: z.string().optional(),
     labels: z.array(z.string()).optional(),
     teamId: z.string().optional(),
+    /**
+     * NOT-362: Linear's own suggested branch name for the issue. Intake persists
+     * it as the Dealer issue's branch so Linear's GitHub integration can link
+     * the PR on repositories it covers.
+     */
+    branchName: z.string().optional(),
     /**
      * NOT-242: server-resolved repository hint read from explicit `repo:` labels.
      * Raw labels stay on the candidate; this is the deterministic read of them.
      */
     repoResolution: LinearRepoResolution.optional(),
+    /**
+     * NOT-364: the issue's own file/link attachments (never comment uploads).
+     * Hosted files are snapshotted at import/reload; links stay metadata only.
+     */
+    attachments: z.array(LinearAttachment).optional(),
 });
 // NOT-71: defaultAgentId and routingRules (label -> agent `autoAgent` routing) are gone
 // with intake/agent-routing.ts and the promote endpoint that consumed them. The persisted

package/bundle/shared/dist/issues.d.ts

@@ -209,6 +209,33 @@ export declare const CreateIssueInput: z.ZodObject<{
      * `false` creates a draft that sits outside the queue until someone adds or starts it.
      */
     enqueue: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * NOT-364: Linear issue attachment metadata captured by the From-Linear form
+     * at lookup time. The server snapshots every Linear-hosted file before the
+     * issue/queue rows are written (atomic: any download/limit failure refuses
+     * the whole create); external links are stored as metadata only. Ignored
+     * for non-Linear sources. Never a stored issue field — rows live in
+     * `issue_source_attachments`.
+     */
+    linearAttachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+        subtitle: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        url: string;
+        subtitle?: string | undefined;
+        source?: string | undefined;
+    }, {
+        id: string;
+        title: string;
+        url: string;
+        subtitle?: string | undefined;
+        source?: string | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     repo: string;
     title: string;
@@ -225,6 +252,13 @@ export declare const CreateIssueInput: z.ZodObject<{
     externalId?: string | undefined;
     externalLabel?: string | undefined;
     externalUrl?: string | undefined;
+    linearAttachments?: {
+        id: string;
+        title: string;
+        url: string;
+        subtitle?: string | undefined;
+        source?: string | undefined;
+    }[] | undefined;
 }, {
     repo: string;
     title: string;
@@ -241,6 +275,13 @@ export declare const CreateIssueInput: z.ZodObject<{
     maxInfraAttempts?: number | undefined;
     autoMerge?: boolean | undefined;
     enqueue?: boolean | undefined;
+    linearAttachments?: {
+        id: string;
+        title: string;
+        url: string;
+        subtitle?: string | undefined;
+        source?: string | undefined;
+    }[] | undefined;
 }>;
 /** Wire/API body shape — defaults applied by `CreateIssueInput.parse` / repository. */
 export type CreateIssueInput = z.input<typeof CreateIssueInput>;
@@ -528,18 +569,18 @@ export declare const IssueArtifact: z.ZodObject<{
     issueId: string | null;
     createdAt: string;
     kind: string;
+    blobPath: string | null;
     workerSessionId: string | null;
     contentJson: string | null;
-    blobPath: string | null;
     author: "human" | "system" | "agent";
 }, {
     id: string;
     issueId: string | null;
     createdAt: string;
     kind: string;
+    blobPath: string | null;
     workerSessionId: string | null;
     contentJson: string | null;
-    blobPath: string | null;
     author: "human" | "system" | "agent";
 }>;
 export type IssueArtifact = z.infer<typeof IssueArtifact>;

package/bundle/shared/dist/issues.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { GitHubRepoInput } from "./github-repo.js";
+import { LinearAttachment } from "./linear-intake.js";
 import { ExecutionContractV1 } from "./execution-contract.js";
 export const IssueStatus = z.enum([
     "ready",
@@ -98,6 +99,15 @@ export const CreateIssueInput = z.object({
      * `false` creates a draft that sits outside the queue until someone adds or starts it.
      */
     enqueue: z.boolean().default(true),
+    /**
+     * NOT-364: Linear issue attachment metadata captured by the From-Linear form
+     * at lookup time. The server snapshots every Linear-hosted file before the
+     * issue/queue rows are written (atomic: any download/limit failure refuses
+     * the whole create); external links are stored as metadata only. Ignored
+     * for non-Linear sources. Never a stored issue field — rows live in
+     * `issue_source_attachments`.
+     */
+    linearAttachments: z.array(LinearAttachment).optional(),
 });
 /** Pre-start (or parked-on-`needs_human`) edits only — the route enforces no active
  * workflow instance; status/owner/intent/branch/SHA/PR stay coordinator-owned. */

package/bundle/shared/dist/linear-intake.d.ts

@@ -133,3 +133,88 @@ export declare function resolveLinearRepoWithMappings(labels: readonly string[]
  * identity and a manually entered one cannot drift.
  */
 export declare function resolveLinearRepoLabels(labels: readonly string[] | undefined): LinearRepoResolution;
+/**
+ * NOT-364: a Linear issue attachment as returned by the direct GraphQL query.
+ * `subtitle` and `source` are Linear's own optional metadata (present on link
+ * attachments that point at external documents, often absent on uploaded
+ * files). Files that exist only inside Linear *comments* never appear here —
+ * the query reads the issue's own `attachments` connection only.
+ */
+export declare const LinearAttachment: z.ZodObject<{
+    /** Stable Linear attachment id — the reconciliation key across reloads. */
+    id: z.ZodString;
+    /** Display name (`repro.tar.gz`) or link title. */
+    title: z.ZodString;
+    /** Download URL for hosted files (short-lived) or the external target for links. */
+    url: z.ZodString;
+    subtitle: z.ZodOptional<z.ZodString>;
+    /** Linear's source metadata, coerced to a string by the adapter when needed. */
+    source: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    url: string;
+    subtitle?: string | undefined;
+    source?: string | undefined;
+}, {
+    id: string;
+    title: string;
+    url: string;
+    subtitle?: string | undefined;
+    source?: string | undefined;
+}>;
+export type LinearAttachment = z.infer<typeof LinearAttachment>;
+/**
+ * NOT-364: Linear-hosted file uploads live under Linear's own upload hosts;
+ * everything else is an ordinary external link. Hosted files are snapshotted
+ * into Dealer-owned storage at import/reload so a queued Builder never needs
+ * the (expiring) Linear URL; links are metadata only and never downloaded.
+ */
+export declare function isLinearHostedAttachmentUrl(rawUrl: string): boolean;
+/**
+ * NOT-364: a durable Dealer-side record of one Linear issue attachment.
+ * `kind: "file"` rows carry a Dealer-owned `blobPath` plus integrity fields;
+ * `kind: "link"` rows carry source metadata only and must never be presented
+ * as offline-available files.
+ */
+export declare const SourceAttachmentRecord: z.ZodObject<{
+    linearAttachmentId: z.ZodString;
+    kind: z.ZodEnum<["file", "link"]>;
+    title: z.ZodString;
+    /** Worktree-local safe basename for files — absent on links. */
+    safeFileName: z.ZodOptional<z.ZodString>;
+    /** Dealer-owned blob path for downloaded files — absent on links. */
+    blobPath: z.ZodOptional<z.ZodString>;
+    contentType: z.ZodOptional<z.ZodString>;
+    sizeBytes: z.ZodOptional<z.ZodNumber>;
+    sha256: z.ZodOptional<z.ZodString>;
+    /** The Linear (possibly expiring) URL for files, the external target for links. */
+    url: z.ZodString;
+    subtitle: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "link" | "file";
+    title: string;
+    url: string;
+    linearAttachmentId: string;
+    subtitle?: string | undefined;
+    source?: string | undefined;
+    safeFileName?: string | undefined;
+    blobPath?: string | undefined;
+    contentType?: string | undefined;
+    sizeBytes?: number | undefined;
+    sha256?: string | undefined;
+}, {
+    kind: "link" | "file";
+    title: string;
+    url: string;
+    linearAttachmentId: string;
+    subtitle?: string | undefined;
+    source?: string | undefined;
+    safeFileName?: string | undefined;
+    blobPath?: string | undefined;
+    contentType?: string | undefined;
+    sizeBytes?: number | undefined;
+    sha256?: string | undefined;
+}>;
+export type SourceAttachmentRecord = z.infer<typeof SourceAttachmentRecord>;

package/bundle/shared/dist/linear-intake.js

@@ -178,3 +178,59 @@ export function resolveLinearRepoLabels(labels) {
         return { status: "invalid", labels: [raw], error: err.message };
     }
 }
+/**
+ * NOT-364: a Linear issue attachment as returned by the direct GraphQL query.
+ * `subtitle` and `source` are Linear's own optional metadata (present on link
+ * attachments that point at external documents, often absent on uploaded
+ * files). Files that exist only inside Linear *comments* never appear here —
+ * the query reads the issue's own `attachments` connection only.
+ */
+export const LinearAttachment = z.object({
+    /** Stable Linear attachment id — the reconciliation key across reloads. */
+    id: z.string(),
+    /** Display name (`repro.tar.gz`) or link title. */
+    title: z.string(),
+    /** Download URL for hosted files (short-lived) or the external target for links. */
+    url: z.string(),
+    subtitle: z.string().optional(),
+    /** Linear's source metadata, coerced to a string by the adapter when needed. */
+    source: z.string().optional(),
+});
+/**
+ * NOT-364: Linear-hosted file uploads live under Linear's own upload hosts;
+ * everything else is an ordinary external link. Hosted files are snapshotted
+ * into Dealer-owned storage at import/reload so a queued Builder never needs
+ * the (expiring) Linear URL; links are metadata only and never downloaded.
+ */
+export function isLinearHostedAttachmentUrl(rawUrl) {
+    let host;
+    try {
+        host = new URL(rawUrl).hostname.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+    return host === "uploads.linear.app" || host.endsWith(".uploads.linear.app") || host === "linear.app" || host.endsWith(".linear.app");
+}
+/**
+ * NOT-364: a durable Dealer-side record of one Linear issue attachment.
+ * `kind: "file"` rows carry a Dealer-owned `blobPath` plus integrity fields;
+ * `kind: "link"` rows carry source metadata only and must never be presented
+ * as offline-available files.
+ */
+export const SourceAttachmentRecord = z.object({
+    linearAttachmentId: z.string(),
+    kind: z.enum(["file", "link"]),
+    title: z.string(),
+    /** Worktree-local safe basename for files — absent on links. */
+    safeFileName: z.string().optional(),
+    /** Dealer-owned blob path for downloaded files — absent on links. */
+    blobPath: z.string().optional(),
+    contentType: z.string().optional(),
+    sizeBytes: z.number().int().nonnegative().optional(),
+    sha256: z.string().optional(),
+    /** The Linear (possibly expiring) URL for files, the external target for links. */
+    url: z.string(),
+    subtitle: z.string().optional(),
+    source: z.string().optional(),
+});

package/bundle/shared/dist/linear-intake.test.js

@@ -2,7 +2,7 @@
 import { test } from "node:test";
 import assert from "node:assert/strict";
 import { LinearCandidate, LinearCandidatesPage, LinearIntakeConfigPatch, LinearIntakeConfigView, LinearIntakeMetadata, } from "./index.js";
-import { LinearRepoResolution, extractRepoLabels, normalizeLinearIntakePickerPatch, normalizeMappingLabel, normalizeRepositoryMappings, resolveLinearRepoLabels, resolveLinearRepoWithMappings, } from "./linear-intake.js";
+import { LinearAttachment, LinearRepoResolution, SourceAttachmentRecord, extractRepoLabels, isLinearHostedAttachmentUrl, normalizeLinearIntakePickerPatch, normalizeMappingLabel, normalizeRepositoryMappings, resolveLinearRepoLabels, resolveLinearRepoWithMappings, } from "./linear-intake.js";
 test("one valid repo: label resolves to the canonical identity", () => {
     const r = resolveLinearRepoLabels(["agent-dealer", "repo:github.com/not-so-fat/agent-dealer"]);
     assert.equal(r.status, "resolved");
@@ -187,6 +187,60 @@ test("LinearIntakeConfigView and Patch reject deleted routing fields and empty s
     const patch = LinearIntakeConfigPatch.parse({ assigneeMe: true, teamId: "t-1" });
     assert.deepEqual(patch, { assigneeMe: true, teamId: "t-1" });
 });
+// NOT-364: Linear-hosted files vs external links, and the durable record shape.
+test("isLinearHostedAttachmentUrl distinguishes Linear uploads from external links", () => {
+    assert.equal(isLinearHostedAttachmentUrl("https://uploads.linear.app/abc/repro.tar.gz"), true);
+    assert.equal(isLinearHostedAttachmentUrl("https://files.uploads.linear.app/x.zip"), true);
+    assert.equal(isLinearHostedAttachmentUrl("https://linear.app/issue/attachment/x"), true);
+    assert.equal(isLinearHostedAttachmentUrl("https://docs.google.com/document/d/x"), false);
+    assert.equal(isLinearHostedAttachmentUrl("https://github.com/acme/app/archive/refs/heads/main.zip"), false);
+    assert.equal(isLinearHostedAttachmentUrl("https://evil-linear.app.evil.com/x.tar.gz"), false);
+    assert.equal(isLinearHostedAttachmentUrl("not a url"), false);
+});
+test("LinearAttachment and SourceAttachmentRecord parse the attachment contract", () => {
+    const file = LinearAttachment.parse({
+        id: "att-1",
+        title: "repro.tar.gz",
+        url: "https://uploads.linear.app/abc/repro.tar.gz",
+    });
+    assert.equal(file.subtitle, undefined);
+    const link = LinearAttachment.parse({
+        id: "att-2",
+        title: "Design doc",
+        url: "https://docs.example.com/x",
+        subtitle: "Spec",
+        source: "google-docs",
+    });
+    assert.equal(link.subtitle, "Spec");
+    const record = SourceAttachmentRecord.parse({
+        linearAttachmentId: "att-1",
+        kind: "file",
+        title: "repro.tar.gz",
+        safeFileName: "repro.tar.gz",
+        blobPath: "/data/source-attachments/issue-1/repro.tar.gz",
+        contentType: "application/gzip",
+        sizeBytes: 12,
+        sha256: "abc",
+        url: "https://uploads.linear.app/abc/repro.tar.gz",
+    });
+    assert.equal(record.kind, "file");
+    // Attachments stay optional so older candidates still parse.
+    const bare = LinearCandidate.parse({
+        id: "uuid-1",
+        identifier: "NOT-1",
+        title: "t",
+        url: "https://linear.app/x/issue/NOT-1/t",
+    });
+    assert.equal(bare.attachments, undefined);
+    const withAttachments = LinearCandidate.parse({
+        id: "uuid-1",
+        identifier: "NOT-1",
+        title: "t",
+        url: "https://linear.app/x/issue/NOT-1/t",
+        attachments: [file, link],
+    });
+    assert.equal(withAttachments.attachments?.length, 2);
+});
 test("LinearCandidatesPage and LinearIntakeMetadata parse the picker contracts", () => {
     const page = LinearCandidatesPage.parse({
         candidates: [],