Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
refactor: validate provider requests once
kashorinfc1727b3d5c9
diff --git a/examples/talking-film-graph-check/svml.packages.lock b/examples/talking-film-graph-check/svml.packages.lockindex 7a310c3f..db46804f 100644--- a/examples/talking-film-graph-check/svml.packages.lock+++ b/examples/talking-film-graph-check/svml.packages.lock@@ -632,7 +632,7 @@{"name": "@narratage/generation","version": "0.0.0-dev",- "digest": "sha256:42db294253448a665ce2d53be321f4c4d584614d8d8a4dc0e002bf3b173bdf9b"+ "digest": "sha256:840cbc1a4b0d611761d917e7c3be744ba5aa513e8556b92290470cd917c64ce1"},{"name": "@narratage/host",@@ -891,7 +891,7 @@}],"facetsDigest": "sha256:d9ee4c44949ca2d24967e7d81898999db84ab592fdaaafe1bd6d22a28ea5e094",- "closureDigest": "sha256:96eb8b61d6f100ce61b44d00ff990a76ba6c32a6da4dd4ba32924fb94d2573b8"+ "closureDigest": "sha256:a420c50eaef59ccce8a995a05b320ee3b18d0c4a26b54d58ff78a1280800f066"},{"package": {@@ -1031,7 +1031,7 @@}],"facetsDigest": "sha256:943d0307a0d1141d326bedea224b7916051fedb79368ebe98304596237269e6d",- "closureDigest": "sha256:67ef4de7781d0f81e1a115776d037aefdcc0d73c4814b4852fe30c32e3545b2a"+ "closureDigest": "sha256:351aad7ca915d9815f0050fee289cfd8174fdd277c60914c3487696dab8c3de8"},{"package": {@@ -1224,5 +1224,5 @@"closureDigest": "sha256:836ad9421ea7c617f3d825d36077071db0a0f7d461296ae099165642ddb1ecc7"}],- "digest": "sha256:23f29dca126b6acb986fe69aacabfec0d8131262e5301d21958350e3be61f573"+ "digest": "sha256:8d1a5ba06772c39b26b7e4959463fb48444ec5ef98cdbb5a35d3c27ef983f176"}diff --git a/examples/talking-film-live/svml.packages.lock b/examples/talking-film-live/svml.packages.lockindex de5811c2..4c990c29 100644--- a/examples/talking-film-live/svml.packages.lock+++ b/examples/talking-film-live/svml.packages.lock@@ -623,7 +623,7 @@{"name": "@narratage/generation","version": "0.0.0-dev",- "digest": "sha256:42db294253448a665ce2d53be321f4c4d584614d8d8a4dc0e002bf3b173bdf9b"+ "digest": "sha256:840cbc1a4b0d611761d917e7c3be744ba5aa513e8556b92290470cd917c64ce1"},{"name": "@narratage/host",@@ -901,7 +901,7 @@}],"facetsDigest": "sha256:d9ee4c44949ca2d24967e7d81898999db84ab592fdaaafe1bd6d22a28ea5e094",- "closureDigest": "sha256:96eb8b61d6f100ce61b44d00ff990a76ba6c32a6da4dd4ba32924fb94d2573b8"+ "closureDigest": "sha256:a420c50eaef59ccce8a995a05b320ee3b18d0c4a26b54d58ff78a1280800f066"},{"package": {@@ -1027,7 +1027,7 @@}],"facetsDigest": "sha256:943d0307a0d1141d326bedea224b7916051fedb79368ebe98304596237269e6d",- "closureDigest": "sha256:67ef4de7781d0f81e1a115776d037aefdcc0d73c4814b4852fe30c32e3545b2a"+ "closureDigest": "sha256:351aad7ca915d9815f0050fee289cfd8174fdd277c60914c3487696dab8c3de8"},{"package": {@@ -1206,5 +1206,5 @@"closureDigest": "sha256:836ad9421ea7c617f3d825d36077071db0a0f7d461296ae099165642ddb1ecc7"}],- "digest": "sha256:c686f4320ed0cf1955e5acea1cadad6249860d0a703ee946790e6969418a3a04"+ "digest": "sha256:bad58522ae9c591899e67ec91e2b2b0acc033f29216c347542a46db266b928ff"}diff --git a/examples/talking-film-live/svml.runtime-packages.lock b/examples/talking-film-live/svml.runtime-packages.lockindex 2cbece04..b8655e48 100644--- a/examples/talking-film-live/svml.runtime-packages.lock+++ b/examples/talking-film-live/svml.runtime-packages.lock@@ -100,7 +100,7 @@{"name": "@narratage/generation","version": "0.0.0-dev",- "digest": "sha256:42db294253448a665ce2d53be321f4c4d584614d8d8a4dc0e002bf3b173bdf9b"+ "digest": "sha256:840cbc1a4b0d611761d917e7c3be744ba5aa513e8556b92290470cd917c64ce1"},{"name": "@narratage/host",@@ -160,7 +160,7 @@{"name": "@narratage/provider-google-vertex","version": "0.0.0-dev",- "digest": "sha256:ea939a5e51da650265342aae191b659499254f31cf3e9797038d8ef3c63678be"+ "digest": "sha256:c8861059e5e7b652bfc1f0d4da6fef5b05d149f21c57916c4dabc8bb90c0276b"},{"name": "@narratage/provider-hyperframes-local",@@ -170,7 +170,7 @@{"name": "@narratage/provider-kie","version": "0.0.0-dev",- "digest": "sha256:bd526ec704763d9e4e9bf6a01dec54feebcef088ddc609b218b763205f7e25eb"+ "digest": "sha256:fd20bf5ea9611ff5f5b624871953b0cc39c02441d34ae314bcca0bf8950afbe7"},{"name": "@narratage/provider-media-local",@@ -963,7 +963,7 @@}],"facetsDigest": "sha256:485fc29d1efcdaeb4e395980975b35090ea6aef0f78d02108d3bd9b3f11aeb91",- "closureDigest": "sha256:a8410cf5d4c1d900536d5ffefec6df6c629cbda61ab76663c83a744fe9bf8279"+ "closureDigest": "sha256:91c6afa0f7eb1a609e62628734743e04f7f3a74cf964a4321a588bf0f70046e2"},{"package": {@@ -991,7 +991,7 @@}],"facetsDigest": "sha256:110648301d69b5b49ea553d285a27626f6fb74ebc74ee67175f688f914d7d74b",- "closureDigest": "sha256:7f93c613c436c57c72288886b98cb7c9ea8e752c049881120cb00c74b017eecf"+ "closureDigest": "sha256:d25cc97ccca0c3d74691edcc4747fa46ddbc8c4a823d64f64080cdff0a946d1c"},{"package": {@@ -1036,5 +1036,5 @@"closureDigest": "sha256:b4418acf6ded1afcfb82c50699738b6dd3ce98ec3380f77cb5887a9d12e36e9b"}],- "digest": "sha256:5da30a93738b96f2ef194ca4a2cc09da4d05d4a7f8fd75c341f43e9c39e7aecf"+ "digest": "sha256:acc437a593d24a68a7f3bdd89d1a5ae86fa69e7ec748ab95b5ff01e5bbeba03c"}diff --git a/examples/talking-head-aroll/svml.packages.lock b/examples/talking-head-aroll/svml.packages.lockindex 7422da7b..46baacd9 100644--- a/examples/talking-head-aroll/svml.packages.lock+++ b/examples/talking-head-aroll/svml.packages.lock@@ -622,7 +622,7 @@{"name": "@narratage/generation","version": "0.0.0-dev",- "digest": "sha256:42db294253448a665ce2d53be321f4c4d584614d8d8a4dc0e002bf3b173bdf9b"+ "digest": "sha256:840cbc1a4b0d611761d917e7c3be744ba5aa513e8556b92290470cd917c64ce1"},{"name": "@narratage/host",@@ -895,7 +895,7 @@}],"facetsDigest": "sha256:d9ee4c44949ca2d24967e7d81898999db84ab592fdaaafe1bd6d22a28ea5e094",- "closureDigest": "sha256:96eb8b61d6f100ce61b44d00ff990a76ba6c32a6da4dd4ba32924fb94d2573b8"+ "closureDigest": "sha256:a420c50eaef59ccce8a995a05b320ee3b18d0c4a26b54d58ff78a1280800f066"},{"package": {@@ -1021,7 +1021,7 @@}],"facetsDigest": "sha256:943d0307a0d1141d326bedea224b7916051fedb79368ebe98304596237269e6d",- "closureDigest": "sha256:67ef4de7781d0f81e1a115776d037aefdcc0d73c4814b4852fe30c32e3545b2a"+ "closureDigest": "sha256:351aad7ca915d9815f0050fee289cfd8174fdd277c60914c3487696dab8c3de8"},{"package": {@@ -1186,5 +1186,5 @@"closureDigest": "sha256:836ad9421ea7c617f3d825d36077071db0a0f7d461296ae099165642ddb1ecc7"}],- "digest": "sha256:354a329137234e84e51cb8cb4bec38ae67afec28c976124f5480b9a3797bc8f0"+ "digest": "sha256:480d288a318b59ff147c57c41857c3a13cd93f81d6b807dcc4df25bbfe0a189c"}diff --git a/examples/talking-head-aroll/svml.runtime-packages.lock b/examples/talking-head-aroll/svml.runtime-packages.lockindex 2cbece04..b8655e48 100644--- a/examples/talking-head-aroll/svml.runtime-packages.lock+++ b/examples/talking-head-aroll/svml.runtime-packages.lock@@ -100,7 +100,7 @@{"name": "@narratage/generation","version": "0.0.0-dev",- "digest": "sha256:42db294253448a665ce2d53be321f4c4d584614d8d8a4dc0e002bf3b173bdf9b"+ "digest": "sha256:840cbc1a4b0d611761d917e7c3be744ba5aa513e8556b92290470cd917c64ce1"},{"name": "@narratage/host",@@ -160,7 +160,7 @@{"name": "@narratage/provider-google-vertex","version": "0.0.0-dev",- "digest": "sha256:ea939a5e51da650265342aae191b659499254f31cf3e9797038d8ef3c63678be"+ "digest": "sha256:c8861059e5e7b652bfc1f0d4da6fef5b05d149f21c57916c4dabc8bb90c0276b"},{"name": "@narratage/provider-hyperframes-local",@@ -170,7 +170,7 @@{"name": "@narratage/provider-kie","version": "0.0.0-dev",- "digest": "sha256:bd526ec704763d9e4e9bf6a01dec54feebcef088ddc609b218b763205f7e25eb"+ "digest": "sha256:fd20bf5ea9611ff5f5b624871953b0cc39c02441d34ae314bcca0bf8950afbe7"},{"name": "@narratage/provider-media-local",@@ -963,7 +963,7 @@}],"facetsDigest": "sha256:485fc29d1efcdaeb4e395980975b35090ea6aef0f78d02108d3bd9b3f11aeb91",- "closureDigest": "sha256:a8410cf5d4c1d900536d5ffefec6df6c629cbda61ab76663c83a744fe9bf8279"+ "closureDigest": "sha256:91c6afa0f7eb1a609e62628734743e04f7f3a74cf964a4321a588bf0f70046e2"},{"package": {@@ -991,7 +991,7 @@}],"facetsDigest": "sha256:110648301d69b5b49ea553d285a27626f6fb74ebc74ee67175f688f914d7d74b",- "closureDigest": "sha256:7f93c613c436c57c72288886b98cb7c9ea8e752c049881120cb00c74b017eecf"+ "closureDigest": "sha256:d25cc97ccca0c3d74691edcc4747fa46ddbc8c4a823d64f64080cdff0a946d1c"},{"package": {@@ -1036,5 +1036,5 @@"closureDigest": "sha256:b4418acf6ded1afcfb82c50699738b6dd3ce98ec3380f77cb5887a9d12e36e9b"}],- "digest": "sha256:5da30a93738b96f2ef194ca4a2cc09da4d05d4a7f8fd75c341f43e9c39e7aecf"+ "digest": "sha256:acc437a593d24a68a7f3bdd89d1a5ae86fa69e7ec748ab95b5ff01e5bbeba03c"}diff --git a/packages/generation/src/mapping.ts b/packages/generation/src/mapping.tsindex 50b038ac..fae7211c 100644--- a/packages/generation/src/mapping.ts+++ b/packages/generation/src/mapping.ts@@ -88,6 +88,8 @@ export async function compileWireRequest(request: GenerationRequest,resolve: GenerationArtifactUrlResolver,): Promise<GenerationWireRequest> {+ assert(mappingSupportsRequest(mapping, request),+ `${mapping.capability.name} request contains a port this Provider cannot map`);const present = presentPorts(request);const input: Record<string, CanonicalValue> = { ...(mapping.constants ?? {}) };diff --git a/packages/provider-google-vertex/src/provider.ts b/packages/provider-google-vertex/src/provider.tsindex 12842598..9d135afe 100644--- a/packages/provider-google-vertex/src/provider.ts+++ b/packages/provider-google-vertex/src/provider.ts@@ -235,14 +235,6 @@ export function createGoogleVertexCaptionProvider(options: CreateGoogleVertexCapcapability: captionGeminiCapabilities.plan,returns: captionTypes.plan,lifecycle: "immediate",- supports: (need) => {- try {- verifyCaptionGeminiRequest(need.constraints);- return true;- } catch {- return false;- }- },handler: async (context) => {const request = requestValue(context.need.constraints);const project = resolveProject();diff --git a/packages/provider-image-opencv-local/src/provider.ts b/packages/provider-image-opencv-local/src/provider.tsindex aa928e2a..d39f86c4 100644--- a/packages/provider-image-opencv-local/src/provider.ts+++ b/packages/provider-image-opencv-local/src/provider.ts@@ -110,14 +110,6 @@ export function createLocalOpenCvImageProvider(config: CreateLocalOpenCvImageProlifecycle: "immediate" as const,capability: rasterCapabilities.execute,returns: artifactTypes.blob,- supports: (need) => {- try {- request(need.constraints);- return true;- } catch {- return false;- }- },handler: async (context): Promise<EndpointFulfillment> => {const need = request(context.need.constraints);const sources = [...new Map(rasterSources(need).map((source) => [source.digest, source])).values()];diff --git a/packages/provider-kie/src/provider.ts b/packages/provider-kie/src/provider.tsindex cbde832a..b831e2d4 100644--- a/packages/provider-kie/src/provider.ts+++ b/packages/provider-kie/src/provider.ts@@ -13,7 +13,6 @@ import type {BlobRef,CanonicalValue,Digest,- Need,} from "@narratage/protocol";import {defineEndpointPackage,@@ -655,7 +654,6 @@ export function createKieProvider(config: CreateKieProviderOptions) {lifecycle: "recoverable" as const,endpoint: providerEndpoint,retry: { maxAttempts: 3 },- supports: (need: Need) => route.supports(need.constraints),})),});}diff --git a/packages/provider-kie/src/routes.ts b/packages/provider-kie/src/routes.tsindex 50997eb7..47afd3b0 100644--- a/packages/provider-kie/src/routes.ts+++ b/packages/provider-kie/src/routes.ts@@ -7,7 +7,6 @@ import type { BackgroundRemovalRequest } from "@narratage/background-removal";import {compileWireRequest,generationTypes,- mappingSupportsRequest,sealGeneratedImageSet,sealGeneratedVideoSet,} from "@narratage/generation";@@ -28,7 +27,6 @@ export type KieRoute = {readonly returns: TypeRef;readonly media: "image" | "video";readonly maxResults: number;- readonly supports: (constraints: CanonicalValue) => boolean;readonly compile: (constraints: CanonicalValue,resolve: GenerationArtifactUrlResolver,@@ -53,7 +51,6 @@ const generationRoutes: readonly KieRoute[] = kieGenerationMappings.map((mappingreturns: mapping.result === "image" ? generationTypes.imageSet : generationTypes.videoSet,media: mapping.result,maxResults: mapping.result === "image" ? 16 : 8,- supports: (constraints) => mappingSupportsRequest(mapping, constraints),compile: async (constraints, resolve) => await compileWireRequest(mapping,constraints as unknown as GenerationRequest,@@ -73,14 +70,6 @@ const backgroundRemovalRoute: KieRoute = {returns: artifactTypes.blob,media: "image",maxResults: 1,- supports: (constraints) => {- try {- assertBackgroundRemovalRequest(constraints as unknown as BackgroundRemovalRequest);- return true;- } catch {- return false;- }- },compile: async (constraints, resolve) => {const request = constraints as unknown as BackgroundRemovalRequest;assertBackgroundRemovalRequest(request);diff --git a/packages/provider-xiaomi-mimo/src/provider.ts b/packages/provider-xiaomi-mimo/src/provider.tsindex e50f4fc8..e45e740e 100644--- a/packages/provider-xiaomi-mimo/src/provider.ts+++ b/packages/provider-xiaomi-mimo/src/provider.ts@@ -59,9 +59,16 @@ function normalizeBaseUrl(value: string): string {return url.href.replace(/\/$/u, "");}-function request(value: CanonicalValue): GenerationRequest {+function request(value: CanonicalValue, model: Model): GenerationRequest {const result = value as unknown as GenerationRequest;assert(result.ports !== null && typeof result.ports === "object", "Xiaomi MiMo request has no ports");+ const allowed = model === "mimo-v2.5-tts"+ ? new Set(["text", "instruction", "voice"])+ : model === "mimo-v2.5-tts-voicedesign"+ ? new Set(["text", "voiceDescription"])+ : new Set(["text", "instruction", "sample"]);+ assert(Object.keys(result.ports).every((name) => allowed.has(name)),+ `${model} request contains an unsupported port`);return result;}@@ -107,17 +114,6 @@ async function readVoiceSample(return `data:${mediaType};base64,${encoded}`;}-function supports(model: Model, value: CanonicalValue): boolean {- const req = value as unknown as GenerationRequest;- if (req === undefined || req.ports === null || typeof req.ports !== "object") return false;- const allowed = model === "mimo-v2.5-tts"- ? new Set(["text", "instruction", "voice"])- : model === "mimo-v2.5-tts-voicedesign"- ? new Set(["text", "voiceDescription"])- : new Set(["text", "instruction", "sample"]);- return Object.keys(req.ports).every((name) => allowed.has(name));-}-function parseAudio(text: string, maxAudioBytes: number): Uint8Array {let raw: unknown;try {@@ -187,9 +183,8 @@ export function createXiaomiMimoProvider(options: CreateXiaomiMimoProviderOptioncapability: capabilities[model],returns: generationTypes.audioSet,lifecycle: "immediate" as const,- supports: (need: { readonly constraints: CanonicalValue }) => supports(model, need.constraints),handler: async (context: EndpointInvocationContext) => {- const req = request(context.need.constraints);+ const req = request(context.need.constraints, model);const text = scalar(req, model, "text")!;const messages: Array<{ role: "user" | "assistant"; content: string }> = [];const audio: Record<string, CanonicalValue> = { format: "wav" };