Support video issue attachments

packages/shared/src/index.ts

@@ -411,6 +411,7 @@ export type {
   DocumentTextProjection,
   DocumentTextRange,
   UpdateDocumentAnnotationThreadRequest,
+  AttachmentArtifactWorkProductMetadata,
   Issue,
   IssueAssigneeAdapterOverrides,
   IssueBlockerAttention,
@@ -921,6 +922,7 @@ export {
   createIssueAttachmentMetadataSchema,
   createIssueWorkProductSchema,
   updateIssueWorkProductSchema,
+  attachmentArtifactWorkProductMetadataSchema,
   issueWorkProductTypeSchema,
   issueWorkProductStatusSchema,
   issueWorkProductReviewStateSchema,

packages/shared/src/types/index.ts

@@ -172,6 +172,7 @@ export type {
   IssueWorkProductProvider,
   IssueWorkProductStatus,
   IssueWorkProductReviewState,
+  AttachmentArtifactWorkProductMetadata,
 } from "./work-product.js";
 export type {
   Issue,

packages/shared/src/types/issue.ts

@@ -845,4 +845,6 @@ export interface IssueAttachment {
   createdAt: Date;
   updatedAt: Date;
   contentPath: string;
+  openPath?: string;
+  downloadPath?: string;
 }

packages/shared/src/types/work-product.ts

@@ -53,3 +53,13 @@ export interface IssueWorkProduct {
   createdAt: Date;
   updatedAt: Date;
 }
+
+export interface AttachmentArtifactWorkProductMetadata {
+  attachmentId: string;
+  contentType: string;
+  byteSize: number;
+  contentPath: string;
+  openPath: string;
+  downloadPath: string;
+  originalFilename?: string | null;
+}

packages/shared/src/validators/index.ts

@@ -282,6 +282,7 @@ export {
 export {
   createIssueWorkProductSchema,
   updateIssueWorkProductSchema,
+  attachmentArtifactWorkProductMetadataSchema,
   issueWorkProductTypeSchema,
   issueWorkProductStatusSchema,
   issueWorkProductReviewStateSchema,

packages/shared/src/validators/work-product.test.ts

@@ -0,0 +1,19 @@
+import { describe, expect, it } from "vitest";
+import { attachmentArtifactWorkProductMetadataSchema } from "./work-product.js";
+
+describe("attachmentArtifactWorkProductMetadataSchema", () => {
+  it("accepts the attachment-backed artifact metadata contract", () => {
+    const parsed = attachmentArtifactWorkProductMetadataSchema.parse({
+      attachmentId: "11111111-1111-4111-8111-111111111111",
+      contentType: "video/mp4",
+      byteSize: 1234,
+      contentPath: "/api/attachments/11111111-1111-4111-8111-111111111111/content",
+      openPath: "/api/attachments/11111111-1111-4111-8111-111111111111/content",
+      downloadPath: "/api/attachments/11111111-1111-4111-8111-111111111111/content?download=1",
+      originalFilename: "demo.mp4",
+    });
+
+    expect(parsed.contentType).toBe("video/mp4");
+    expect(parsed.downloadPath).toContain("download=1");
+  });
+});

packages/shared/src/validators/work-product.ts

@@ -29,6 +29,18 @@ export const issueWorkProductReviewStateSchema = z.enum([
   "changes_requested",
 ]);
 
+export const attachmentArtifactWorkProductMetadataSchema = z.object({
+  attachmentId: z.string().uuid(),
+  contentType: z.string().min(1),
+  byteSize: z.number().int().nonnegative(),
+  contentPath: z.string().min(1),
+  openPath: z.string().min(1),
+  downloadPath: z.string().min(1),
+  originalFilename: z.string().optional().nullable(),
+});
+
+export type AttachmentArtifactWorkProductMetadata = z.infer<typeof attachmentArtifactWorkProductMetadataSchema>;
+
 export const createIssueWorkProductSchema = z.object({
   projectId: z.string().uuid().optional().nullable(),
   executionWorkspaceId: z.string().uuid().optional().nullable(),