@sudobility/screenwriter_types 0.1.1

package/dist/assets/index.d.ts

@@ -0,0 +1,722 @@
+import { z } from 'zod';
+/**
+ * The asset library (slice B11; spec 05 §6.13, §8.6, §14.1, spec 11 §3 and §4.5). Assets are workspace files with metadata;
+ * bytes never pass through the API (presigned multipart PUT to R2). This file holds the vocabularies, the DTOs and the
+ * role-to-target table the server enforces (`ROLE_NOT_ALLOWED_FOR_TARGET`).
+ */
+export declare const ASSET_KINDS: readonly ["image", "video", "audio", "model3d", "document", "archive", "data"];
+export type AssetKind = (typeof ASSET_KINDS)[number];
+export declare const assetKindSchema: z.ZodEnum<{
+    document: "document";
+    image: "image";
+    video: "video";
+    audio: "audio";
+    model3d: "model3d";
+    archive: "archive";
+    data: "data";
+}>;
+export declare const ASSET_ROLES: readonly ["reference", "headshot", "photo", "logo", "beat_image", "inline_image", "panel_reference", "location_scout", "mood_board", "attachment", "turnaround", "expression_sheet", "costume_design", "set_concept", "set_plan", "storyboard_frame", "animatic", "previz", "rendered_video", "rendered_shot", "dialogue_audio", "voice_sample", "voice_profile", "music_cue", "sound_effect", "lip_sync", "captions", "model3d", "model3d_rig", "texture", "lora", "timeline"];
+export type AssetRole = (typeof ASSET_ROLES)[number];
+export declare const assetRoleSchema: z.ZodEnum<{
+    model3d: "model3d";
+    reference: "reference";
+    headshot: "headshot";
+    photo: "photo";
+    logo: "logo";
+    beat_image: "beat_image";
+    inline_image: "inline_image";
+    panel_reference: "panel_reference";
+    location_scout: "location_scout";
+    mood_board: "mood_board";
+    attachment: "attachment";
+    turnaround: "turnaround";
+    expression_sheet: "expression_sheet";
+    costume_design: "costume_design";
+    set_concept: "set_concept";
+    set_plan: "set_plan";
+    storyboard_frame: "storyboard_frame";
+    animatic: "animatic";
+    previz: "previz";
+    rendered_video: "rendered_video";
+    rendered_shot: "rendered_shot";
+    dialogue_audio: "dialogue_audio";
+    voice_sample: "voice_sample";
+    voice_profile: "voice_profile";
+    music_cue: "music_cue";
+    sound_effect: "sound_effect";
+    lip_sync: "lip_sync";
+    captions: "captions";
+    model3d_rig: "model3d_rig";
+    texture: "texture";
+    lora: "lora";
+    timeline: "timeline";
+}>;
+export declare const ASSET_ROLE_GROUPS: Record<AssetRole, 'reference' | 'design' | 'storyboard' | 'video' | 'audio' | '3d' | 'other'>;
+export declare const ASSET_TARGET_KINDS: readonly ["document", "scene", "element", "shot", "entity", "beat", "title_page", "snapshot"];
+export type AssetTargetKind = (typeof ASSET_TARGET_KINDS)[number];
+export declare const assetTargetKindSchema: z.ZodEnum<{
+    scene: "scene";
+    document: "document";
+    snapshot: "snapshot";
+    element: "element";
+    shot: "shot";
+    entity: "entity";
+    beat: "beat";
+    title_page: "title_page";
+}>;
+/**
+ * Which target kinds a role may sit on (spec 05 §6.13: "enforces spec 11's role-to-target table"; spec 11 §3.7 lists the
+ * roles but not the table, so this is the decision made in B11). A role not listed here may go on any target.
+ */
+export declare const ASSET_ROLE_TARGETS: Partial<Record<AssetRole, readonly AssetTargetKind[]>>;
+/** Roles that only fit an entity of one kind (checked against `proj_entities.kind`). */
+export declare const ASSET_ROLE_ENTITY_KINDS: Partial<Record<AssetRole, readonly string[]>>;
+export declare const ASSET_ORIGINS: readonly ["upload", "import", "generated", "external_tool"];
+export type AssetOrigin = (typeof ASSET_ORIGINS)[number];
+export declare const ASSET_VERSION_STATUSES: readonly ["uploading", "processing", "ready", "failed"];
+export type AssetVersionStatus = (typeof ASSET_VERSION_STATUSES)[number];
+export declare const STALENESS_VALUES: readonly ["fresh", "stale", "target_deleted", "unknown"];
+export type Staleness = (typeof STALENESS_VALUES)[number];
+/** Multipart parts are this big (the last one smaller); an upload of at most one part is a single presigned PUT. */
+export declare const ASSET_PART_SIZE_BYTES: number;
+/** How many part PUTs the client helper runs at once. */
+export declare const ASSET_UPLOAD_CONCURRENCY = 3;
+/** Presigned part URLs and the upload itself live this long (seconds); a resume re-signs. */
+export declare const ASSET_UPLOAD_TTL_S = 3600;
+/** Presigned GET lifetime for `GET /assets/:aid/versions/:vid/url` (seconds). */
+export declare const ASSET_URL_TTL_S = 300;
+/** Largest original per kind (spec 11 §3.2). */
+export declare const ASSET_MAX_BYTES: Record<AssetKind, number>;
+/** Extension -> kind and the MIME types accepted for it (spec 11 §3.2). The extension must be listed and the magic bytes must agree. */
+export declare const ASSET_EXTENSIONS: Record<string, {
+    kind: AssetKind;
+    mimes: readonly string[];
+}>;
+/** `.ext` of a file name, lower-cased ('' when it has none). */
+export declare const assetExtension: (filename: string) => string;
+/** Client-side pre-check that mirrors the server's: null when the file could be accepted, else why not. */
+export declare function checkAssetFile(filename: string, mimeType: string, sizeBytes: number, kind: AssetKind): 'type' | 'mime' | 'kind' | 'size' | null;
+export declare const assetRightsSchema: z.ZodObject<{
+    ownership: z.ZodDefault<z.ZodEnum<{
+        unknown: "unknown";
+        generated: "generated";
+        owned: "owned";
+        licensed: "licensed";
+        public_domain: "public_domain";
+    }>>;
+    license: z.ZodOptional<z.ZodString>;
+    attribution: z.ZodOptional<z.ZodString>;
+    sourceUrl: z.ZodOptional<z.ZodString>;
+    restrictions: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    containsLikenessOf: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    consentAssetId: z.ZodOptional<z.ZodString>;
+    aiTrainingAllowed: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AssetRights = z.output<typeof assetRightsSchema>;
+export declare const assetSourceRefSchema: z.ZodObject<{
+    documentId: z.ZodString;
+    snapshotId: z.ZodOptional<z.ZodString>;
+    targetKind: z.ZodEnum<{
+        scene: "scene";
+        document: "document";
+        element: "element";
+        shot: "shot";
+        entity: "entity";
+        beat: "beat";
+        title_page: "title_page";
+    }>;
+    targetId: z.ZodString;
+    sourceHash: z.ZodString;
+}, z.core.$strip>;
+export type AssetSourceRef = z.infer<typeof assetSourceRefSchema>;
+/** What a caller may send as `provenance` (the server fills `upload` and `import` itself). */
+export declare const assetProvenanceInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    origin: z.ZodLiteral<"external_tool">;
+    tool: z.ZodString;
+    toolVersion: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    sourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        documentId: z.ZodString;
+        snapshotId: z.ZodOptional<z.ZodString>;
+        targetKind: z.ZodEnum<{
+            scene: "scene";
+            document: "document";
+            element: "element";
+            shot: "shot";
+            entity: "entity";
+            beat: "beat";
+            title_page: "title_page";
+        }>;
+        targetId: z.ZodString;
+        sourceHash: z.ZodString;
+    }, z.core.$strip>>>;
+    createdVia: z.ZodDefault<z.ZodEnum<{
+        mcp: "mcp";
+        api: "api";
+        app: "app";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    origin: z.ZodLiteral<"generated">;
+    jobId: z.ZodOptional<z.ZodString>;
+    adapter: z.ZodString;
+    provider: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    negativePrompt: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        assetVersionId: z.ZodOptional<z.ZodString>;
+        packetHash: z.ZodOptional<z.ZodString>;
+        role: z.ZodString;
+    }, z.core.$strip>>>;
+    sourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        documentId: z.ZodString;
+        snapshotId: z.ZodOptional<z.ZodString>;
+        targetKind: z.ZodEnum<{
+            scene: "scene";
+            document: "document";
+            element: "element";
+            shot: "shot";
+            entity: "entity";
+            beat: "beat";
+            title_page: "title_page";
+        }>;
+        targetId: z.ZodString;
+        sourceHash: z.ZodString;
+    }, z.core.$strip>>>;
+    costCredits: z.ZodOptional<z.ZodNumber>;
+    providerJobId: z.ZodOptional<z.ZodString>;
+    createdVia: z.ZodDefault<z.ZodEnum<{
+        mcp: "mcp";
+        api: "api";
+        app: "app";
+    }>>;
+}, z.core.$strip>], "origin">;
+export type AssetProvenanceInput = z.input<typeof assetProvenanceInputSchema>;
+/** The stored, immutable provenance of a version (spec 11 §3.6). */
+export type AssetProvenance = {
+    origin: 'upload';
+    uploadedBy: string;
+    originalFilename: string;
+    client?: Record<string, unknown>;
+} | {
+    origin: 'import';
+    importJobId: string;
+    sourceFormat: string;
+    originalPath?: string;
+} | ({
+    origin: 'generated';
+    agent?: {
+        client: string;
+        apiKeyId: string;
+    };
+} & Record<string, unknown>) | ({
+    origin: 'external_tool';
+    agent?: {
+        client: string;
+        apiKeyId: string;
+    };
+} & Record<string, unknown>);
+export interface AssetDerivative {
+    mime: string;
+    sizeBytes: number;
+}
+export interface AssetVersion {
+    id: string;
+    assetId: string;
+    parentVersionId: string | null;
+    versionNumber: number;
+    mime: string;
+    ext: string;
+    sizeBytes: number;
+    sha256: string | null;
+    status: AssetVersionStatus;
+    errorCode: string | null;
+    media: Record<string, unknown>;
+    /** Derivative name (`thumb_256`, `preview_1600`, `poster`, `proxy_720p`, ...) -> its type and size. Empty until `asset.derive` has run. */
+    derivatives: Record<string, AssetDerivative>;
+    provenance: AssetProvenance;
+    origin: AssetOrigin;
+    rights: AssetRights;
+    createdBy: string | null;
+    createdAt: string;
+}
+export interface AssetSummary {
+    id: string;
+    workspaceId: string;
+    kind: AssetKind;
+    title: string;
+    description: string;
+    /** Null until the first version is ready (or processing finished without a derive worker: see `status`). */
+    currentVersionId: string | null;
+    versionCount: number;
+    /** Fields of the current version (the latest one when none is current yet). */
+    mime: string | null;
+    sizeBytes: number | null;
+    status: AssetVersionStatus | null;
+    origin: AssetOrigin | null;
+    rights: AssetRights | null;
+    hasThumbnail: boolean;
+    createdBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt: string | null;
+}
+export interface AssetLink {
+    id: string;
+    workspaceId: string;
+    assetId: string;
+    /** Null = follow the asset's current version. */
+    pinnedVersionId: string | null;
+    /** Null = a workspace-level link (its target is `{kind: 'document', id: <workspaceId>}`). */
+    documentId: string | null;
+    targetKind: AssetTargetKind;
+    targetId: string;
+    role: AssetRole;
+    sortOrder: number;
+    sourceHash: string | null;
+    sourceSnapshotId: string | null;
+    originalTargetId: string | null;
+    note: string;
+    createdBy: string | null;
+    createdAt: string;
+    deletedAt: string | null;
+}
+export type AssetListItem = AssetSummary & {
+    role?: AssetRole;
+    sortOrder?: number;
+};
+export type AssetDetail = AssetSummary & {
+    versions: AssetVersion[];
+    links: AssetLink[];
+};
+export declare const assetUploadRequestSchema: z.ZodObject<{
+    assetId: z.ZodOptional<z.ZodString>;
+    filename: z.ZodString;
+    mimeType: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    sha256Hex: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        document: "document";
+        image: "image";
+        video: "video";
+        audio: "audio";
+        model3d: "model3d";
+        archive: "archive";
+        data: "data";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    parentVersionId: z.ZodOptional<z.ZodString>;
+    provenance: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        origin: z.ZodLiteral<"external_tool">;
+        tool: z.ZodString;
+        toolVersion: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        sourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            documentId: z.ZodString;
+            snapshotId: z.ZodOptional<z.ZodString>;
+            targetKind: z.ZodEnum<{
+                scene: "scene";
+                document: "document";
+                element: "element";
+                shot: "shot";
+                entity: "entity";
+                beat: "beat";
+                title_page: "title_page";
+            }>;
+            targetId: z.ZodString;
+            sourceHash: z.ZodString;
+        }, z.core.$strip>>>;
+        createdVia: z.ZodDefault<z.ZodEnum<{
+            mcp: "mcp";
+            api: "api";
+            app: "app";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        origin: z.ZodLiteral<"generated">;
+        jobId: z.ZodOptional<z.ZodString>;
+        adapter: z.ZodString;
+        provider: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+        negativePrompt: z.ZodOptional<z.ZodString>;
+        parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            assetVersionId: z.ZodOptional<z.ZodString>;
+            packetHash: z.ZodOptional<z.ZodString>;
+            role: z.ZodString;
+        }, z.core.$strip>>>;
+        sourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            documentId: z.ZodString;
+            snapshotId: z.ZodOptional<z.ZodString>;
+            targetKind: z.ZodEnum<{
+                scene: "scene";
+                document: "document";
+                element: "element";
+                shot: "shot";
+                entity: "entity";
+                beat: "beat";
+                title_page: "title_page";
+            }>;
+            targetId: z.ZodString;
+            sourceHash: z.ZodString;
+        }, z.core.$strip>>>;
+        costCredits: z.ZodOptional<z.ZodNumber>;
+        providerJobId: z.ZodOptional<z.ZodString>;
+        createdVia: z.ZodDefault<z.ZodEnum<{
+            mcp: "mcp";
+            api: "api";
+            app: "app";
+        }>>;
+    }, z.core.$strip>], "origin">>;
+    rights: z.ZodOptional<z.ZodObject<{
+        ownership: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            unknown: "unknown";
+            generated: "generated";
+            owned: "owned";
+            licensed: "licensed";
+            public_domain: "public_domain";
+        }>>>;
+        license: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        attribution: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        sourceUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        restrictions: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        expiresAt: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        containsLikenessOf: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        consentAssetId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        aiTrainingAllowed: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AssetUploadRequest = z.input<typeof assetUploadRequestSchema>;
+export interface AssetPartUrl {
+    partNumber: number;
+    url: string;
+    expiresAt: string;
+}
+export interface AssetUploadInit {
+    uploadId: string;
+    assetId: string;
+    versionId: string;
+    partSizeBytes: number;
+    partCount: number;
+    parts: AssetPartUrl[];
+    expiresAt: string;
+    /** The workspace already holds these exact bytes: nothing to PUT (`parts` is empty); call complete. */
+    deduplicated: boolean;
+}
+export interface AssetCompletedPart {
+    partNumber: number;
+    etag: string;
+    sizeBytes?: number;
+}
+export interface AssetUploadStatus {
+    uploadId: string;
+    assetId: string;
+    versionId: string;
+    partSizeBytes: number;
+    partCount: number;
+    completedParts: AssetCompletedPart[];
+    expiresAt: string;
+    completedAt: string | null;
+}
+export declare const assetPartsRequestSchema: z.ZodObject<{
+    partNumbers: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>;
+export type AssetPartsRequest = z.infer<typeof assetPartsRequestSchema>;
+export interface AssetPartsResponse {
+    parts: AssetPartUrl[];
+}
+export declare const assetCompleteSchema: z.ZodObject<{
+    parts: z.ZodArray<z.ZodObject<{
+        partNumber: z.ZodNumber;
+        etag: z.ZodString;
+    }, z.core.$strip>>;
+    sha256Hex: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AssetCompleteRequest = z.infer<typeof assetCompleteSchema>;
+export interface AssetAbortResponse {
+    aborted: true;
+}
+export declare const assetListQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    documentId: z.ZodOptional<z.ZodString>;
+    linkedTo: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodEnum<{
+        model3d: "model3d";
+        reference: "reference";
+        headshot: "headshot";
+        photo: "photo";
+        logo: "logo";
+        beat_image: "beat_image";
+        inline_image: "inline_image";
+        panel_reference: "panel_reference";
+        location_scout: "location_scout";
+        mood_board: "mood_board";
+        attachment: "attachment";
+        turnaround: "turnaround";
+        expression_sheet: "expression_sheet";
+        costume_design: "costume_design";
+        set_concept: "set_concept";
+        set_plan: "set_plan";
+        storyboard_frame: "storyboard_frame";
+        animatic: "animatic";
+        previz: "previz";
+        rendered_video: "rendered_video";
+        rendered_shot: "rendered_shot";
+        dialogue_audio: "dialogue_audio";
+        voice_sample: "voice_sample";
+        voice_profile: "voice_profile";
+        music_cue: "music_cue";
+        sound_effect: "sound_effect";
+        lip_sync: "lip_sync";
+        captions: "captions";
+        model3d_rig: "model3d_rig";
+        texture: "texture";
+        lora: "lora";
+        timeline: "timeline";
+    }>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        document: "document";
+        image: "image";
+        video: "video";
+        audio: "audio";
+        model3d: "model3d";
+        archive: "archive";
+        data: "data";
+    }>>;
+    q: z.ZodOptional<z.ZodString>;
+    origin: z.ZodOptional<z.ZodEnum<{
+        import: "import";
+        upload: "upload";
+        generated: "generated";
+        external_tool: "external_tool";
+    }>>;
+}, z.core.$strip>;
+export type AssetListQuery = z.output<typeof assetListQuerySchema>;
+export declare const assetUpdateSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    rights: z.ZodOptional<z.ZodObject<{
+        ownership: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            unknown: "unknown";
+            generated: "generated";
+            owned: "owned";
+            licensed: "licensed";
+            public_domain: "public_domain";
+        }>>>;
+        license: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        attribution: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        sourceUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        restrictions: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        expiresAt: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        containsLikenessOf: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        consentAssetId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        aiTrainingAllowed: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AssetUpdateRequest = z.input<typeof assetUpdateSchema>;
+export declare const ASSET_URL_VARIANTS: readonly ["original", "thumb_256", "thumb_512", "preview_1600", "poster", "proxy_720p", "proxy_1080p", "preview", "waveform", "sprite"];
+export declare const assetUrlQuerySchema: z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type AssetUrlQuery = z.output<typeof assetUrlQuerySchema>;
+export interface AssetUrlResponse {
+    url: string;
+    expiresAt: string;
+}
+export interface AssetDeleteResponse {
+    deletedAt: string;
+}
+export declare const assetLinkCreateSchema: z.ZodObject<{
+    assetId: z.ZodString;
+    pinnedVersionId: z.ZodOptional<z.ZodString>;
+    documentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    target: z.ZodObject<{
+        kind: z.ZodEnum<{
+            scene: "scene";
+            document: "document";
+            snapshot: "snapshot";
+            element: "element";
+            shot: "shot";
+            entity: "entity";
+            beat: "beat";
+            title_page: "title_page";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>;
+    role: z.ZodEnum<{
+        model3d: "model3d";
+        reference: "reference";
+        headshot: "headshot";
+        photo: "photo";
+        logo: "logo";
+        beat_image: "beat_image";
+        inline_image: "inline_image";
+        panel_reference: "panel_reference";
+        location_scout: "location_scout";
+        mood_board: "mood_board";
+        attachment: "attachment";
+        turnaround: "turnaround";
+        expression_sheet: "expression_sheet";
+        costume_design: "costume_design";
+        set_concept: "set_concept";
+        set_plan: "set_plan";
+        storyboard_frame: "storyboard_frame";
+        animatic: "animatic";
+        previz: "previz";
+        rendered_video: "rendered_video";
+        rendered_shot: "rendered_shot";
+        dialogue_audio: "dialogue_audio";
+        voice_sample: "voice_sample";
+        voice_profile: "voice_profile";
+        music_cue: "music_cue";
+        sound_effect: "sound_effect";
+        lip_sync: "lip_sync";
+        captions: "captions";
+        model3d_rig: "model3d_rig";
+        texture: "texture";
+        lora: "lora";
+        timeline: "timeline";
+    }>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+    sourceHash: z.ZodOptional<z.ZodString>;
+    sourceSnapshotId: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AssetLinkCreateRequest = z.input<typeof assetLinkCreateSchema>;
+export declare const assetLinkUpdateSchema: z.ZodObject<{
+    role: z.ZodOptional<z.ZodEnum<{
+        model3d: "model3d";
+        reference: "reference";
+        headshot: "headshot";
+        photo: "photo";
+        logo: "logo";
+        beat_image: "beat_image";
+        inline_image: "inline_image";
+        panel_reference: "panel_reference";
+        location_scout: "location_scout";
+        mood_board: "mood_board";
+        attachment: "attachment";
+        turnaround: "turnaround";
+        expression_sheet: "expression_sheet";
+        costume_design: "costume_design";
+        set_concept: "set_concept";
+        set_plan: "set_plan";
+        storyboard_frame: "storyboard_frame";
+        animatic: "animatic";
+        previz: "previz";
+        rendered_video: "rendered_video";
+        rendered_shot: "rendered_shot";
+        dialogue_audio: "dialogue_audio";
+        voice_sample: "voice_sample";
+        voice_profile: "voice_profile";
+        music_cue: "music_cue";
+        sound_effect: "sound_effect";
+        lip_sync: "lip_sync";
+        captions: "captions";
+        model3d_rig: "model3d_rig";
+        texture: "texture";
+        lora: "lora";
+        timeline: "timeline";
+    }>>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+    pinnedVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AssetLinkUpdateRequest = z.input<typeof assetLinkUpdateSchema>;
+export declare const documentAssetLinksQuerySchema: z.ZodObject<{
+    targetKind: z.ZodOptional<z.ZodEnum<{
+        scene: "scene";
+        document: "document";
+        snapshot: "snapshot";
+        element: "element";
+        shot: "shot";
+        entity: "entity";
+        beat: "beat";
+        title_page: "title_page";
+    }>>;
+    targetId: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodEnum<{
+        model3d: "model3d";
+        reference: "reference";
+        headshot: "headshot";
+        photo: "photo";
+        logo: "logo";
+        beat_image: "beat_image";
+        inline_image: "inline_image";
+        panel_reference: "panel_reference";
+        location_scout: "location_scout";
+        mood_board: "mood_board";
+        attachment: "attachment";
+        turnaround: "turnaround";
+        expression_sheet: "expression_sheet";
+        costume_design: "costume_design";
+        set_concept: "set_concept";
+        set_plan: "set_plan";
+        storyboard_frame: "storyboard_frame";
+        animatic: "animatic";
+        previz: "previz";
+        rendered_video: "rendered_video";
+        rendered_shot: "rendered_shot";
+        dialogue_audio: "dialogue_audio";
+        voice_sample: "voice_sample";
+        voice_profile: "voice_profile";
+        music_cue: "music_cue";
+        sound_effect: "sound_effect";
+        lip_sync: "lip_sync";
+        captions: "captions";
+        model3d_rig: "model3d_rig";
+        texture: "texture";
+        lora: "lora";
+        timeline: "timeline";
+    }>>;
+    withStaleness: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>, z.ZodTransform<boolean, "true" | "false">>>;
+}, z.core.$strip>;
+export type DocumentAssetLinksQuery = z.output<typeof documentAssetLinksQuerySchema>;
+export type AssetLinkWithStaleness = AssetLink & {
+    staleness?: Staleness;
+};
+export interface AssetLinkDeleteResponse {
+    deletedAt: string;
+}
+export declare const STALENESS_TARGET_KINDS: readonly ["scene", "element", "shot", "entity"];
+export declare const documentStalenessQuerySchema: z.ZodObject<{
+    targetKind: z.ZodOptional<z.ZodEnum<{
+        scene: "scene";
+        element: "element";
+        shot: "shot";
+        entity: "entity";
+    }>>;
+}, z.core.$strip>;
+export type DocumentStalenessQuery = z.output<typeof documentStalenessQuerySchema>;
+/** `GET /documents/:did/staleness`: per target with derived links, for badges. */
+export interface TargetStaleness {
+    targetKind: (typeof STALENESS_TARGET_KINDS)[number];
+    targetId: string;
+    fresh: number;
+    stale: number;
+    deleted: number;
+}
+export interface LinkStaleness {
+    staleness: Staleness;
+    /** When the target's hash last changed (the normalizer's record); only for `stale`. */
+    changedAt?: string;
+    /** Snapshot-target links: how the live document compares (always `fresh` against the snapshot itself). */
+    liveStaleness?: Staleness;
+    /** Not built (needs the target's old element hashes, spec 11 §4.5's LCS diff); never sent. */
+    diffSummary?: {
+        added: number;
+        removed: number;
+        changed: number;
+    };
+}
+export declare const assetDeriveInputSchema: z.ZodObject<{
+    assetVersionId: z.ZodString;
+}, z.core.$strip>;
+export type AssetDeriveInput = z.infer<typeof assetDeriveInputSchema>;