@vanillaskyai/video 0.4.0 → 0.5.0

package/docs/reference/protocol.md

@@ -1,10 +1,10 @@
-# Video Response Protocol 0.4
+# Video Response Protocol 0.5
 
 ## Transport
 
 The public transport is UTF-8 Server-Sent Events returned from a `POST` request.
 Responses use `Content-Type: text/event-stream`,
-`x-vanillasky-video-stream: 0.4`, `Cache-Control: no-cache, no-transform`, and
+`x-vanillasky-video-stream: 0.5`, `Cache-Control: no-cache, no-transform`, and
 `X-Accel-Buffering: no`. Each block has an SSE `id`, the event name
 `video`, and one JSON envelope in `data`. A final `data: [DONE]`
 closes the transport after a terminal protocol event. Comment heartbeats do not
@@ -14,7 +14,7 @@ change protocol state.
 
 ```ts
 type VideoEvent<T extends string, D> = {
-  protocolVersion: "0.4";
+  protocolVersion: "0.5";
   runId: string;
   sequence: number;
   eventId: string;        // exactly `${runId}:${sequence}`
@@ -33,10 +33,8 @@ midstream and events cannot follow a terminal state.
 1. `response.start` establishes request ID, orientation, style, and negotiated
    templates/extensions.
 2. Optional `audio.set` occurs at most once and before the first scene.
-3. `scene.add` appends one trusted-template scene at revision `0`.
-4. `scene.patch` or `asset.patch` advances that scene revision by exactly one.
-   A host must reject patches after the scene has played.
-5. Exactly one terminal event ends the run:
+3. `scene.add` appends one complete, immutable trusted-template scene.
+4. Exactly one terminal event ends the run:
    `response.complete`, terminal `response.error`, or `response.abort`.
 
 `response.complete` carries the complete replayable `Video`, a
@@ -55,8 +53,8 @@ server callback.
 
 ### Duration ceiling
 
-`maxDurationSec` is enforced by the runtime for scene additions and timing
-patches. A final scene may be shortened to the remaining duration. If a later
+`maxDurationSec` is enforced by the runtime for scene additions. A final scene
+may be shortened to the remaining duration. If a later
 scene would start at the ceiling, the runtime preserves the partial response
 and emits `response.complete` with `finishReason: "length"`; reaching the
 declared maximum is normal completion, not a generation error. The value is a
@@ -73,9 +71,8 @@ change core video state.
 ## Planning boundary
 
 LLMs do not emit public protocol envelopes. A server-only planner emits
-validated `scene.add`, `scene.patch`, `asset.patch`, `plan.complete`, or
-`plan.error` parts. The runtime assigns sequences, revisions, IDs, terminal
-snapshots, and checksums. Generated HTML, React, JavaScript, CSS, component
+validated `scene.add` or `plan.complete` parts. The runtime assigns sequences,
+IDs, terminal snapshots, and checksums. Generated HTML, React, JavaScript, CSS, component
 source, audio events, protocol envelopes, and unknown part types are rejected.
 
 A planner may add `placement: "closer"` to exactly one `scene.add`. The

package/docs/reference/provider-adapters.md

@@ -14,21 +14,21 @@ community, AI Gateway, OpenAI-compatible, and custom providers.
 Install the AI SDK plus the provider package your application chooses:
 
 ```bash
-npm install ai @ai-sdk/openai
+npm install ai @ai-sdk/anthropic
 ```
 
 ```ts
-import { openai } from "@ai-sdk/openai";
+import { anthropic } from "@ai-sdk/anthropic";
 import { streamText } from "ai";
 import { createVideoHandler } from "@vanillaskyai/video/server";
 
-const modelId = process.env.OPENAI_MODEL;
-if (!modelId) throw new Error("Set OPENAI_MODEL in the server environment");
+const modelId = process.env.ANTHROPIC_MODEL;
+if (!modelId) throw new Error("Set ANTHROPIC_MODEL in the server environment");
 
 export const POST = createVideoHandler({
   authorize: verifySession,
   streamText: ({ systemPrompt, userPrompt, signal }) => streamText({
-    model: openai(modelId),
+    model: anthropic(modelId),
     system: systemPrompt,
     prompt: userPrompt,
     abortSignal: signal,

package/docs/testing.md

@@ -28,7 +28,7 @@ describe("POST /api/video", () => {
     const response = await handle(new Request("https://app.test/api/video", {
       method: "POST",
       body: JSON.stringify({
-        protocolVersion: "0.4",
+        protocolVersion: "0.5",
         requestId: "route-test",
         input: videoFixtures.portrait.input,
       }),

package/examples/nextjs-quickstart/.env.example

@@ -1,2 +1,2 @@
-OPENAI_API_KEY=replace-me
-OPENAI_MODEL=gpt-4.1
+ANTHROPIC_API_KEY=replace-me
+ANTHROPIC_MODEL=replace-with-current-sonnet-model

package/examples/nextjs-quickstart/README.md

@@ -12,7 +12,10 @@ npm run dev
 ```
 <!-- verify:end -->
 
-Add your OpenAI API key to `.env.local` before selecting **Generate video**.
+Before selecting **Generate video**, add your Anthropic API key and replace the
+model placeholder with a current Claude Sonnet model ID available to your
+account. Provider and model selection happen here, after SDK installation, so
+VanillaSky never silently chooses either one.
 
 Open <http://localhost:3000> and select **Generate video**.
 

package/examples/nextjs-quickstart/package.json

@@ -8,10 +8,10 @@
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^4.0.42",
-    "@vanillaskyai/video": "0.4.0",
-    "ai": "^7.0.66",
-    "next": "16.3.1",
+    "@ai-sdk/anthropic": "^4.0.41",
+    "@vanillaskyai/video": "0.5.0",
+    "ai": "^7.0.77",
+    "next": "16.3.2",
     "react": "19.2.8",
     "react-dom": "19.2.8"
   },

package/examples/nextjs-quickstart/src/app/api/video/route.ts

@@ -1,8 +1,10 @@
-import { openai } from "@ai-sdk/openai";
+import { anthropic } from "@ai-sdk/anthropic";
 import { streamText } from "ai";
 import { createVideoHandler } from "@vanillaskyai/video/server";
 
-const model = openai(process.env.OPENAI_MODEL ?? "gpt-4.1");
+const modelId = process.env.ANTHROPIC_MODEL;
+if (!modelId) throw new Error("Set ANTHROPIC_MODEL in the server environment");
+const model = anthropic(modelId);
 
 const handle = createVideoHandler({
   authorize: (request) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanillaskyai/video",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Open-source video response SDK for personalized AI applications.",
   "keywords": [
     "generative-video",
@@ -131,21 +131,21 @@
     }
   },
   "devDependencies": {
-    "@anthropic-ai/sdk": "^0.116.0",
+    "@anthropic-ai/sdk": "^0.120.0",
     "@eslint/js": "^9.39.1",
     "@playwright/test": "1.62.0",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^24.10.1",
-    "@types/react": "^18.3.28",
-    "@types/react-dom": "^18.3.7",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
     "es-module-lexer": "^1.7.0",
     "eslint": "^9.39.1",
     "globals": "^16.5.0",
     "jsdom": "^26.1.0",
     "mdast-util-from-markdown": "2.0.3",
-    "openai": "^7.4.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
+    "openai": "^7.5.0",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
     "tsup": "^8.5.1",
     "tsx": "^4.23.12",
     "typescript": "^5.9.3",
@@ -156,7 +156,7 @@
     "esbuild": "^0.28.2"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "packageManager": "npm@11.17.0",
   "publishConfig": {

package/dist/chunk-CR7FE7BW.js

@@ -1,109 +0,0 @@
-import {
-  assertTemplateTransitionMetadata
-} from "./chunk-2E6T633S.js";
-
-// src/visual-system/catalog/kit.ts
-function toMetadata(template) {
-  return {
-    id: template.id,
-    label: template.label,
-    description: template.description,
-    category: template.category,
-    family: template.family,
-    usesGlobalTextEffect: template.usesGlobalTextEffect,
-    usesGlobalTransition: template.usesGlobalTransition,
-    transitionTiming: template.transitionTiming,
-    usesGlobalBackgroundEffect: template.usesGlobalBackgroundEffect,
-    textCanvas: template.textCanvas,
-    jobs: template.jobs,
-    register: template.register,
-    useWhen: template.useWhen,
-    avoidWhen: template.avoidWhen,
-    schema: template.schema,
-    minDuration: template.minDuration,
-    preferredDuration: template.preferredDuration,
-    timing: template.timing
-  };
-}
-function isTemplateJsonSchema(value) {
-  if (typeof value !== "object" || value == null) return false;
-  const schema = value;
-  return schema.type === "object" && typeof schema.properties === "object" && schema.properties != null;
-}
-function defineTemplate(definition) {
-  if (!/^[A-Za-z][A-Za-z0-9_-]*$/.test(definition.id)) {
-    throw new Error(`Invalid template id: ${definition.id}`);
-  }
-  const suppliedSchema = "schema" in definition ? definition.schema : void 0;
-  const standard = suppliedSchema && "~standard" in suppliedSchema ? suppliedSchema["~standard"] : void 0;
-  const convertedSchema = standard?.jsonSchema ? standard.jsonSchema.input({ target: "draft-07" }) : suppliedSchema && !("~standard" in suppliedSchema) ? suppliedSchema : void 0;
-  if (standard && !standard.jsonSchema) {
-    throw new Error("Template schemas must expose Standard JSON Schema so the server registry can be generated safely");
-  }
-  if (!convertedSchema || !isTemplateJsonSchema(convertedSchema)) {
-    throw new Error("Template schema must describe a JSON object");
-  }
-  const schema = { ...convertedSchema, additionalProperties: convertedSchema.additionalProperties ?? false };
-  const transitionMetadata = {
-    id: definition.id,
-    usesGlobalTransition: definition.usesGlobalTransition ?? false,
-    transitionTiming: definition.transitionTiming
-  };
-  assertTemplateTransitionMetadata(transitionMetadata);
-  const { schema: _runtimeSchema, duration, ...definitionWithoutSchema } = definition;
-  return Object.freeze({
-    label: definition.id,
-    description: "",
-    usesGlobalTextEffect: false,
-    usesGlobalTransition: false,
-    usesGlobalBackgroundEffect: false,
-    ...definitionWithoutSchema,
-    schema,
-    ...duration == null ? {} : { preferredDuration: duration }
-  });
-}
-function createRenderTemplateRegistry(options) {
-  const byId = /* @__PURE__ */ new Map();
-  for (const template of options.templates) {
-    assertTemplateTransitionMetadata(template);
-    if (byId.has(template.id)) throw new Error(`Duplicate template id: ${template.id}`);
-    byId.set(template.id, template);
-  }
-  const templates = Object.freeze([...options.templates]);
-  if (options.metadata && options.metadata.map(({ id }) => id).join("\0") !== templates.map(({ id }) => id).join("\0")) {
-    throw new Error("Template metadata does not match render templates");
-  }
-  const metadata = new Map((options.metadata ?? templates.map(toMetadata)).map((template) => [template.id, template]));
-  const capabilities = { templates: templates.map(({ id }) => id) };
-  return Object.freeze({
-    templates,
-    capabilities,
-    getTemplate: (id) => byId.get(id),
-    getTemplateMetadata: (id) => metadata.get(id),
-    listTemplateMetadata: () => [...metadata.values()]
-  });
-}
-function overlayTemplateRegistry(defaults, customer) {
-  const customerTemplates = new Map(customer.templates.map((template) => [template.id, template]));
-  const defaultIds = new Set(defaults.templates.map(({ id }) => id));
-  const templates = [
-    ...defaults.templates.map((template) => customerTemplates.get(template.id) ?? template),
-    ...customer.templates.filter(({ id }) => !defaultIds.has(id))
-  ];
-  const customerMetadataList = customer.listTemplateMetadata();
-  const customerMetadata = new Map(customerMetadataList.map((template) => [template.id, template]));
-  const metadata = [
-    ...defaults.listTemplateMetadata().map((template) => customerMetadata.get(template.id) ?? template),
-    ...customerMetadataList.filter(({ id }) => !defaultIds.has(id))
-  ];
-  return createRenderTemplateRegistry({ templates, metadata });
-}
-function createTemplateRegistry(options) {
-  return createRenderTemplateRegistry({ templates: options.definitions });
-}
-
-export {
-  defineTemplate,
-  overlayTemplateRegistry,
-  createTemplateRegistry
-};

package/dist/compose-video-6UQ33DOO.js

@@ -1,13 +0,0 @@
-import {
-  createVideo
-} from "./chunk-LHFADNWJ.js";
-import "./chunk-E7CL7UPB.js";
-import "./chunk-STIFILQG.js";
-import "./chunk-JW47XCRL.js";
-import "./chunk-GHJEAP4O.js";
-import "./chunk-EE6PK6XC.js";
-import "./chunk-3O7OMMMF.js";
-import "./chunk-XGRA2MUV.js";
-export {
-  createVideo
-};