@playcraft/common 0.1.54 → 0.1.56-beta

package/dist/agent-tools/video-replication.d.ts

@@ -0,0 +1,421 @@
+import { z } from 'zod';
+export declare const VIDEO_UNDERSTANDING_VERSION: "playcraft.video-understanding.v1";
+export declare const VIDEO_MAX_BYTES: number;
+export declare const VIDEO_MAX_DURATION_MS = 180000;
+export declare const videoSourceSchema: z.ZodObject<{
+    sha256: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    mimeType: z.ZodEnum<{
+        "video/mp4": "video/mp4";
+        "video/webm": "video/webm";
+        "video/quicktime": "video/quicktime";
+    }>;
+    durationMs: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strict>;
+export declare const videoMediaInitSchema: z.ZodObject<{
+    workspaceId: z.ZodString;
+    mediaId: z.ZodUUID;
+    filename: z.ZodString;
+    sha256: z.ZodString;
+    contentMd5: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    mimeType: z.ZodEnum<{
+        "video/mp4": "video/mp4";
+        "video/webm": "video/webm";
+        "video/quicktime": "video/quicktime";
+    }>;
+}, z.core.$strict>;
+export declare const videoMediaFinalizeSchema: z.ZodObject<{
+    workspaceId: z.ZodString;
+    mediaId: z.ZodUUID;
+}, z.core.$strict>;
+export declare const videoProcessingSchema: z.ZodEnum<{
+    auto: "auto";
+    agentic: "agentic";
+    static: "static";
+}>;
+export declare const videoUnderstandingContentSchema: z.ZodObject<{
+    summary: z.ZodString;
+    observations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+        confidence: z.ZodNumber;
+    }, z.core.$strict>>;
+    events: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            action: "action";
+            result: "result";
+            other: "other";
+            initial: "initial";
+            "first-action-result": "first-action-result";
+            feedback: "feedback";
+            "end-card": "end-card";
+        }>;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+        observationIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    evidence: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+    }, z.core.$strict>>;
+    inferences: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+        confidence: z.ZodNumber;
+    }, z.core.$strict>>;
+    unknowns: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        affects: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    reconstructionHints: z.ZodObject<{
+        entities: z.ZodArray<z.ZodString>;
+        assets: z.ZodArray<z.ZodString>;
+        candidateRules: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const videoUnderstandingAnalysisSchema: z.ZodObject<{
+    summary: z.ZodString;
+    observations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+        confidence: z.ZodNumber;
+    }, z.core.$strict>>;
+    events: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            action: "action";
+            result: "result";
+            other: "other";
+            initial: "initial";
+            "first-action-result": "first-action-result";
+            feedback: "feedback";
+            "end-card": "end-card";
+        }>;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+        observationIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    evidence: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+    }, z.core.$strict>>;
+    inferences: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+        confidence: z.ZodNumber;
+    }, z.core.$strict>>;
+    unknowns: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        affects: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    reconstructionHints: z.ZodObject<{
+        entities: z.ZodArray<z.ZodString>;
+        assets: z.ZodArray<z.ZodString>;
+        candidateRules: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<"playcraft.video-understanding.v1">;
+    runId: z.ZodUUID;
+    state: z.ZodLiteral<"completed">;
+    source: z.ZodObject<{
+        sha256: z.ZodString;
+        sizeBytes: z.ZodNumber;
+        mimeType: z.ZodEnum<{
+            "video/mp4": "video/mp4";
+            "video/webm": "video/webm";
+            "video/quicktime": "video/quicktime";
+        }>;
+        durationMs: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+    model: z.ZodObject<{
+        configId: z.ZodUUID;
+        provider: z.ZodLiteral<"google">;
+        model: z.ZodLiteral<"gemini-3.8-flash">;
+        processing: z.ZodEnum<{
+            agentic: "agentic";
+            static: "static";
+        }>;
+        requestedProcessing: z.ZodEnum<{
+            auto: "auto";
+            agentic: "agentic";
+            static: "static";
+        }>;
+        selectionReason: z.ZodString;
+        agenticVerified: z.ZodBoolean;
+        execution: z.ZodDefault<z.ZodLiteral<"foreground">>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const videoAnalysisRequestSchema: z.ZodObject<{
+    workspaceId: z.ZodString;
+    runId: z.ZodUUID;
+    mediaId: z.ZodUUID;
+    modelConfigId: z.ZodOptional<z.ZodUUID>;
+    processing: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        agentic: "agentic";
+        static: "static";
+    }>>;
+    fps: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<4>, z.ZodLiteral<8>]>>;
+    clip: z.ZodOptional<z.ZodObject<{
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+    }, z.core.$strict>>;
+    question: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodObject<{
+        summary: z.ZodString;
+        observations: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            confidence: z.ZodNumber;
+        }, z.core.$strict>>;
+        events: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                action: "action";
+                result: "result";
+                other: "other";
+                initial: "initial";
+                "first-action-result": "first-action-result";
+                feedback: "feedback";
+                "end-card": "end-card";
+            }>;
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+            observationIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        evidence: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>;
+        inferences: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            confidence: z.ZodNumber;
+        }, z.core.$strict>>;
+        unknowns: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+            affects: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        reconstructionHints: z.ZodObject<{
+            entities: z.ZodArray<z.ZodString>;
+            assets: z.ZodArray<z.ZodString>;
+            candidateRules: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        schemaVersion: z.ZodLiteral<"playcraft.video-understanding.v1">;
+        runId: z.ZodUUID;
+        state: z.ZodLiteral<"completed">;
+        source: z.ZodObject<{
+            sha256: z.ZodString;
+            sizeBytes: z.ZodNumber;
+            mimeType: z.ZodEnum<{
+                "video/mp4": "video/mp4";
+                "video/webm": "video/webm";
+                "video/quicktime": "video/quicktime";
+            }>;
+            durationMs: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        model: z.ZodObject<{
+            configId: z.ZodUUID;
+            provider: z.ZodLiteral<"google">;
+            model: z.ZodLiteral<"gemini-3.8-flash">;
+            processing: z.ZodEnum<{
+                agentic: "agentic";
+                static: "static";
+            }>;
+            requestedProcessing: z.ZodEnum<{
+                auto: "auto";
+                agentic: "agentic";
+                static: "static";
+            }>;
+            selectionReason: z.ZodString;
+            agenticVerified: z.ZodBoolean;
+            execution: z.ZodDefault<z.ZodLiteral<"foreground">>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const videoAnalysisStateSchema: z.ZodEnum<{
+    pending: "pending";
+    failed: "failed";
+    uploading: "uploading";
+    completed: "completed";
+    running: "running";
+    uncertain: "uncertain";
+    cancelled: "cancelled";
+    submitting: "submitting";
+}>;
+export declare const videoModelCatalogSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"playcraft.video-models.v1">;
+    defaultConfigId: z.ZodNullable<z.ZodUUID>;
+    models: z.ZodArray<z.ZodObject<{
+        configId: z.ZodUUID;
+        provider: z.ZodLiteral<"google">;
+        model: z.ZodLiteral<"gemini-3.8-flash">;
+        processing: z.ZodArray<z.ZodEnum<{
+            agentic: "agentic";
+            static: "static";
+        }>>;
+        maxVideos: z.ZodNumber;
+        execution: z.ZodDefault<z.ZodLiteral<"foreground">>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const videoMediaInitResultSchema: z.ZodObject<{
+    mediaId: z.ZodUUID;
+    upload: z.ZodObject<{
+        method: z.ZodLiteral<"PUT">;
+        url: z.ZodString;
+        headers: z.ZodRecord<z.ZodString, z.ZodString>;
+        expiresAt: z.ZodString;
+        authenticated: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const videoMediaResultSchema: z.ZodObject<{
+    mediaId: z.ZodUUID;
+    state: z.ZodLiteral<"ready">;
+    source: z.ZodObject<{
+        sha256: z.ZodString;
+        sizeBytes: z.ZodNumber;
+        mimeType: z.ZodEnum<{
+            "video/mp4": "video/mp4";
+            "video/webm": "video/webm";
+            "video/quicktime": "video/quicktime";
+        }>;
+        durationMs: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const videoAnalysisRunSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"playcraft.video-analysis-run.v1">;
+    runId: z.ZodUUID;
+    workspaceId: z.ZodString;
+    mediaId: z.ZodUUID;
+    state: z.ZodEnum<{
+        pending: "pending";
+        failed: "failed";
+        uploading: "uploading";
+        completed: "completed";
+        running: "running";
+        uncertain: "uncertain";
+        cancelled: "cancelled";
+        submitting: "submitting";
+    }>;
+    analysis: z.ZodOptional<z.ZodObject<{
+        summary: z.ZodString;
+        observations: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            confidence: z.ZodNumber;
+        }, z.core.$strict>>;
+        events: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                action: "action";
+                result: "result";
+                other: "other";
+                initial: "initial";
+                "first-action-result": "first-action-result";
+                feedback: "feedback";
+                "end-card": "end-card";
+            }>;
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+            observationIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        evidence: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>;
+        inferences: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+            evidenceIds: z.ZodArray<z.ZodString>;
+            confidence: z.ZodNumber;
+        }, z.core.$strict>>;
+        unknowns: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+            affects: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        reconstructionHints: z.ZodObject<{
+            entities: z.ZodArray<z.ZodString>;
+            assets: z.ZodArray<z.ZodString>;
+            candidateRules: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        schemaVersion: z.ZodLiteral<"playcraft.video-understanding.v1">;
+        runId: z.ZodUUID;
+        state: z.ZodLiteral<"completed">;
+        source: z.ZodObject<{
+            sha256: z.ZodString;
+            sizeBytes: z.ZodNumber;
+            mimeType: z.ZodEnum<{
+                "video/mp4": "video/mp4";
+                "video/webm": "video/webm";
+                "video/quicktime": "video/quicktime";
+            }>;
+            durationMs: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        model: z.ZodObject<{
+            configId: z.ZodUUID;
+            provider: z.ZodLiteral<"google">;
+            model: z.ZodLiteral<"gemini-3.8-flash">;
+            processing: z.ZodEnum<{
+                agentic: "agentic";
+                static: "static";
+            }>;
+            requestedProcessing: z.ZodEnum<{
+                auto: "auto";
+                agentic: "agentic";
+                static: "static";
+            }>;
+            selectionReason: z.ZodString;
+            agenticVerified: z.ZodBoolean;
+            execution: z.ZodDefault<z.ZodLiteral<"foreground">>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        retryable: z.ZodBoolean;
+    }, z.core.$strict>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    pollAfterMs: z.ZodNumber;
+}, z.core.$strict>;
+export type VideoSource = z.infer<typeof videoSourceSchema>;
+export type VideoMediaInit = z.infer<typeof videoMediaInitSchema>;
+export type VideoMediaInitResult = z.infer<typeof videoMediaInitResultSchema>;
+export type VideoMediaResult = z.infer<typeof videoMediaResultSchema>;
+export type VideoAnalysisRequest = z.infer<typeof videoAnalysisRequestSchema>;
+export type VideoAnalysisRun = z.infer<typeof videoAnalysisRunSchema>;
+export type VideoUnderstandingContent = z.infer<typeof videoUnderstandingContentSchema>;
+export type VideoUnderstandingAnalysis = z.infer<typeof videoUnderstandingAnalysisSchema>;
+export type VideoModelCatalog = z.infer<typeof videoModelCatalogSchema>;
+export declare function videoUnderstandingJsonSchema(): Record<string, unknown>;
+/** Validate referential integrity and original-video timestamps, beyond structural JSON. */
+export declare function validateVideoUnderstandingContent(value: unknown, source: VideoSource, clip?: {
+    startMs: number;
+    endMs: number;
+}): VideoUnderstandingContent;
+//# sourceMappingURL=video-replication.d.ts.map

package/dist/agent-tools/video-replication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-replication.d.ts","sourceRoot":"","sources":["../../src/agent-tools/video-replication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,2BAA2B,EAAG,kCAA2C,CAAC;AACvF,eAAO,MAAM,eAAe,QAAoB,CAAC;AACjD,eAAO,MAAM,qBAAqB,SAAU,CAAC;AAG7C,eAAO,MAAM,iBAAiB;;;;;;;;;;;kBAKnB,CAAC;AACZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;kBAKtB,CAAC;AACZ,eAAO,MAAM,wBAAwB;;;kBAA4D,CAAC;AAClG,eAAO,MAAM,qBAAqB;;;;EAAwC,CAAC;AAI3E,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQjC,CAAC;AACZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAIlC,CAAC;AACZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQrC,CAAC;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;EAA6G,CAAC;AACnJ,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;kBAGzB,CAAC;AACZ,eAAO,MAAM,0BAA0B;;;;;;;;;kBAA0N,CAAC;AAClQ,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;kBAAiG,CAAC;AACrI,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKxB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,wBAAgB,4BAA4B,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAItE;AAED,4FAA4F;AAC5F,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,yBAAyB,CAoB3J"}

package/dist/agent-tools/video-replication.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+export const VIDEO_UNDERSTANDING_VERSION = 'playcraft.video-understanding.v1';
+export const VIDEO_MAX_BYTES = 100 * 1024 * 1024;
+export const VIDEO_MAX_DURATION_MS = 180_000;
+const id = z.string().min(1).max(128);
+const sha256 = z.string().regex(/^[a-f0-9]{64}$/);
+export const videoSourceSchema = z.object({
+    sha256, sizeBytes: z.number().int().positive().max(VIDEO_MAX_BYTES),
+    mimeType: z.enum(['video/mp4', 'video/webm', 'video/quicktime']),
+    durationMs: z.number().positive().max(VIDEO_MAX_DURATION_MS),
+    width: z.number().int().positive().max(8192), height: z.number().int().positive().max(8192),
+}).strict();
+export const videoMediaInitSchema = z.object({
+    workspaceId: id, mediaId: z.uuid(), filename: z.string().min(1).max(255),
+    sha256, contentMd5: z.string().regex(/^[A-Za-z0-9+/]{22}==$/),
+    sizeBytes: z.number().int().positive().max(VIDEO_MAX_BYTES),
+    mimeType: videoSourceSchema.shape.mimeType,
+}).strict();
+export const videoMediaFinalizeSchema = z.object({ workspaceId: id, mediaId: z.uuid() }).strict();
+export const videoProcessingSchema = z.enum(['auto', 'agentic', 'static']);
+const confidence = z.number().min(0).max(1);
+const evidenceItem = z.object({ id, startMs: z.number().nonnegative(), endMs: z.number().nonnegative() }).strict();
+const statement = z.object({ id, text: z.string().min(1).max(8000), evidenceIds: z.array(id).min(1).max(32), confidence }).strict();
+export const videoUnderstandingContentSchema = z.object({
+    summary: z.string().min(1).max(16000),
+    observations: z.array(statement).min(1).max(128),
+    events: z.array(z.object({ id, kind: z.enum(['initial', 'first-action-result', 'action', 'result', 'feedback', 'end-card', 'other']), startMs: z.number().nonnegative(), endMs: z.number().nonnegative(), observationIds: z.array(id).min(1).max(32) }).strict()).min(1).max(128),
+    evidence: z.array(evidenceItem).min(1).max(24),
+    inferences: z.array(statement).max(128),
+    unknowns: z.array(z.object({ id, text: z.string().min(1).max(8000), affects: z.array(z.string().min(1).max(128)).min(1).max(32) }).strict()).max(128),
+    reconstructionHints: z.object({ entities: z.array(z.string().max(4000)).max(64), assets: z.array(z.string().max(4000)).max(64), candidateRules: z.array(z.string().max(4000)).max(64) }).strict(),
+}).strict();
+export const videoUnderstandingAnalysisSchema = videoUnderstandingContentSchema.extend({
+    schemaVersion: z.literal(VIDEO_UNDERSTANDING_VERSION), runId: z.uuid(), state: z.literal('completed'),
+    source: videoSourceSchema,
+    model: z.object({ configId: z.uuid(), provider: z.literal('google'), model: z.literal('gemini-3.8-flash'), processing: z.enum(['agentic', 'static']), requestedProcessing: videoProcessingSchema, selectionReason: z.string(), agenticVerified: z.boolean(), execution: z.literal('foreground').default('foreground') }).strict(),
+}).strict();
+export const videoAnalysisRequestSchema = z.object({
+    workspaceId: id, runId: z.uuid(), mediaId: z.uuid(), modelConfigId: z.uuid().optional(),
+    processing: videoProcessingSchema.default('auto'), fps: z.union([z.literal(1), z.literal(2), z.literal(4), z.literal(8)]).optional(),
+    clip: z.object({ startMs: z.number().nonnegative(), endMs: z.number().positive() }).strict().optional(),
+    question: z.string().min(1).max(8000).optional(), context: videoUnderstandingAnalysisSchema.optional(),
+}).strict().superRefine((data, ctx) => {
+    if (data.processing === 'agentic' && (data.fps !== undefined || data.clip))
+        ctx.addIssue({ code: 'custom', message: 'video.staticOptionsRequired' });
+    if (data.clip && data.clip.endMs <= data.clip.startMs)
+        ctx.addIssue({ code: 'custom', message: 'video.clipInvalid' });
+});
+export const videoAnalysisStateSchema = z.enum(['pending', 'uploading', 'submitting', 'running', 'completed', 'failed', 'cancelled', 'uncertain']);
+export const videoModelCatalogSchema = z.object({
+    schemaVersion: z.literal('playcraft.video-models.v1'), defaultConfigId: z.uuid().nullable(),
+    models: z.array(z.object({ configId: z.uuid(), provider: z.literal('google'), model: z.literal('gemini-3.8-flash'), processing: z.array(z.enum(['agentic', 'static'])), maxVideos: z.number().int().min(1).max(6), execution: z.literal('foreground').default('foreground') }).strict()),
+}).strict();
+export const videoMediaInitResultSchema = z.object({ mediaId: z.uuid(), upload: z.object({ method: z.literal('PUT'), url: z.string().min(1), headers: z.record(z.string(), z.string()), expiresAt: z.string(), authenticated: z.boolean() }).strict() }).strict();
+export const videoMediaResultSchema = z.object({ mediaId: z.uuid(), state: z.literal('ready'), source: videoSourceSchema }).strict();
+export const videoAnalysisRunSchema = z.object({
+    schemaVersion: z.literal('playcraft.video-analysis-run.v1'), runId: z.uuid(), workspaceId: id, mediaId: z.uuid(), state: videoAnalysisStateSchema,
+    analysis: videoUnderstandingAnalysisSchema.optional(),
+    error: z.object({ code: z.string(), retryable: z.boolean() }).strict().optional(),
+    createdAt: z.string(), updatedAt: z.string(), pollAfterMs: z.number().int().nonnegative(),
+}).strict();
+export function videoUnderstandingJsonSchema() {
+    const schema = z.toJSONSchema(videoUnderstandingContentSchema);
+    delete schema.$schema;
+    return schema;
+}
+/** Validate referential integrity and original-video timestamps, beyond structural JSON. */
+export function validateVideoUnderstandingContent(value, source, clip) {
+    const result = videoUnderstandingContentSchema.parse(value);
+    const ids = new Set();
+    for (const item of [...result.evidence, ...result.observations, ...result.events, ...result.inferences, ...result.unknowns]) {
+        if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/.test(item.id) || ids.has(item.id))
+            throw new Error('video.evidenceIdInvalid');
+        ids.add(item.id);
+    }
+    const evidenceIds = new Set(result.evidence.map(item => item.id));
+    const observationIds = new Set(result.observations.map(item => item.id));
+    for (const item of [...result.evidence, ...result.events]) {
+        if (item.endMs < item.startMs || item.startMs >= source.durationMs || item.startMs < (clip?.startMs ?? 0) || item.endMs > (clip?.endMs ?? source.durationMs))
+            throw new Error('video.evidenceTimeInvalid');
+    }
+    for (const item of [...result.observations, ...result.inferences]) {
+        if (item.evidenceIds.some(ref => !evidenceIds.has(ref)))
+            throw new Error('video.evidenceReferenceInvalid');
+    }
+    for (const item of result.events)
+        if (item.observationIds.some(ref => !observationIds.has(ref)))
+            throw new Error('video.observationReferenceInvalid');
+    for (const kind of ['initial', 'first-action-result', 'result', 'end-card']) {
+        if (!result.events.some(event => event.kind === kind) && !result.unknowns.some(item => item.affects.includes(kind)))
+            throw new Error('video.requiredEventUnaccounted');
+    }
+    return result;
+}
+//# sourceMappingURL=video-replication.js.map

package/dist/agent-tools/video-replication.js.map

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

package/dist/asset-library-stream.d.ts

@@ -0,0 +1,14 @@
+import { type AssetLibrarySaveEnvelope, type AssetLibrarySourceFile } from './cloud-workspace/runtime/asset-library-save.js';
+type ByteStream = AsyncIterable<Uint8Array>;
+export declare function assetLibrarySaveDestination(header: AssetLibrarySaveEnvelope): string;
+/** A bounded manifest followed by exact file bytes; no credentials or storage keys enter the envelope. */
+export declare function encodeAssetLibraryEnvelope(input: AssetLibrarySaveEnvelope, load: (file: AssetLibrarySourceFile) => ByteStream | Promise<ByteStream>): AsyncIterable<Uint8Array>;
+export declare function readAssetLibraryEnvelope(stream: ByteStream, validateHeader?: (header: AssetLibrarySaveEnvelope) => void | Promise<void>): Promise<{
+    header: AssetLibrarySaveEnvelope;
+    files: Array<{
+        file: AssetLibrarySourceFile;
+        bytes: Buffer;
+    }>;
+}>;
+export {};
+//# sourceMappingURL=asset-library-stream.d.ts.map

package/dist/asset-library-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-library-stream.d.ts","sourceRoot":"","sources":["../src/asset-library-stream.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAAE,KAAK,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAGtH,KAAK,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;AAC5C,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAGpF;AAKD,0GAA0G;AAC1G,wBAAuB,0BAA0B,CAAC,KAAK,EAAE,wBAAwB,EAC/E,IAAI,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAgBrG;AAED,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,UAAU,EAC/D,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IACpF,MAAM,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,sBAAsB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjG,CAAC,CAwCH"}

package/dist/asset-library-stream.js

@@ -0,0 +1,101 @@
+import { createHash } from 'node:crypto';
+import { hashOperationPayload } from './cloud-workspace/runtime/operations.js';
+import { ASSET_LIBRARY_SAVE_HEADER_MAX_BYTES, ASSET_LIBRARY_SAVE_MAX_BYTES, assetLibrarySaveEnvelopeSchema } from './cloud-workspace/runtime/asset-library-save.js';
+const invalid = () => new Error('asset_library_invalid_stream');
+export function assetLibrarySaveDestination(header) {
+    const key = createHash('sha256').update(JSON.stringify([header.scope, header.taskId, header.saveId])).digest('hex');
+    return [header.request.path, `${key.slice(0, 20)}${header.source.bundle ? '.aiimage' : ''}`].filter(Boolean).join('/');
+}
+function verifyHeader(header) {
+    if (header.sourceHash !== hashOperationPayload(header.source) || header.payloadHash !== hashOperationPayload(header.request))
+        throw invalid();
+}
+/** A bounded manifest followed by exact file bytes; no credentials or storage keys enter the envelope. */
+export async function* encodeAssetLibraryEnvelope(input, load) {
+    const header = assetLibrarySaveEnvelopeSchema.parse(input), json = Buffer.from(JSON.stringify(header));
+    verifyHeader(header);
+    if (json.length > ASSET_LIBRARY_SAVE_HEADER_MAX_BYTES)
+        throw invalid();
+    const prefix = Buffer.alloc(4);
+    prefix.writeUInt32BE(json.length);
+    yield prefix;
+    yield json;
+    for (const file of header.source.files) {
+        let size = 0;
+        const hash = createHash('sha256');
+        for await (const chunk of await load(file)) {
+            if (!(chunk instanceof Uint8Array))
+                throw invalid();
+            size += chunk.byteLength;
+            if (size > file.size)
+                throw invalid();
+            hash.update(chunk);
+            yield chunk;
+        }
+        if (size !== file.size || hash.digest('hex') !== file.contentHash)
+            throw invalid();
+    }
+}
+export async function readAssetLibraryEnvelope(stream, validateHeader) {
+    const iterator = stream[Symbol.asyncIterator]();
+    let current = new Uint8Array(0), offset = 0, wireSize = 0, finished = false;
+    const next = async () => {
+        const chunk = await iterator.next();
+        if (chunk.done)
+            return false;
+        if (!(chunk.value instanceof Uint8Array))
+            throw invalid();
+        wireSize += chunk.value.byteLength;
+        if (wireSize > ASSET_LIBRARY_SAVE_MAX_BYTES + ASSET_LIBRARY_SAVE_HEADER_MAX_BYTES + 4)
+            throw invalid();
+        current = chunk.value;
+        offset = 0;
+        return true;
+    };
+    const take = async (size) => {
+        const output = Buffer.alloc(size);
+        let received = 0;
+        while (received < size) {
+            if (offset === current.length && !await next())
+                throw invalid();
+            const count = Math.min(size - received, current.length - offset);
+            output.set(current.subarray(offset, offset + count), received);
+            received += count;
+            offset += count;
+        }
+        return output;
+    };
+    try {
+        const length = (await take(4)).readUInt32BE();
+        if (!length || length > ASSET_LIBRARY_SAVE_HEADER_MAX_BYTES)
+            throw invalid();
+        let header;
+        try {
+            header = assetLibrarySaveEnvelopeSchema.parse(JSON.parse((await take(length)).toString('utf8')));
+        }
+        catch {
+            throw invalid();
+        }
+        verifyHeader(header);
+        await validateHeader?.(header);
+        const files = [];
+        for (const file of header.source.files) {
+            const bytes = await take(file.size);
+            if (createHash('sha256').update(bytes).digest('hex') !== file.contentHash)
+                throw invalid();
+            files.push({ file, bytes });
+        }
+        if (offset !== current.length)
+            throw invalid();
+        while (await next())
+            if (current.length)
+                throw invalid();
+        finished = true;
+        return { header, files };
+    }
+    finally {
+        if (!finished)
+            await iterator.return?.().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=asset-library-stream.js.map