@vanillaskyai/video 0.7.1 → 0.8.0

package/docs/persistence.md

@@ -3,9 +3,12 @@
 # Persistence and replay
 
 A completed `Video` is ordinary JSON owned by your application. VanillaSky
-does not provide a database or hosted media store. Save the value returned by
-`await video.generate(...)` with the platform-native `JSON.stringify`; there is
-no SDK serializer.
+does not provide a database or hosted media store. For a custom interface, observe `useVideoChat().turns` and save a turn’s
+`video` only when `turn.completed` is true and `turn.video` is present. Use
+`JSON.stringify(turn.video)` and deduplicate writes by `turn.id`; there is no
+SDK serializer. An interrupted turn can remain visible without qualifying as
+completed conversation history. The default `VideoChat` keeps history in memory;
+use the headless hook when the application needs durable storage.
 
 Every stored video has `schemaVersion: "0.1"`. This storage version is separate
 from streaming protocol `0.5`. The 0.1 policy supports the current storage
@@ -48,31 +51,13 @@ runs; it never renders a partial future document.
 
 ## Retention
 
-By default, completed snapshots omit raw source, creative instructions, and
-the supplied-media URL index. A customer-owned route may retain individual
-fields only when its privacy and deletion policy allows it:
-
-```ts
-createVideoHandler({
-  authorize: verifySession,
-  streamText,
-  snapshotRetention: {
-    source: true,
-    instructions: true,
-    suppliedMediaUrls: true,
-  },
-});
-```
-
-Opt-in values are bounded in the snapshot:
-
-- source: 16,384 characters;
-- instructions: 4,096 characters;
-- supplied-media index: 16 URLs, each at most 2,048 characters.
+Completed snapshots omit raw source, creative instructions, and the supplied-media
+URL index. Store an authorized prompt separately with the completed turn only
+when the host's privacy and deletion policy permits it. Saved-video replay does
+not rehydrate a chat session or its voice queue.
 
-These metadata limits do not replace a host retention policy. Renderable scene
-variables may still contain a media URL when that asset is necessary for
-replay. Store only approved assets and avoid signed URLs whose lifetime is
+Renderable scene variables may contain a media URL when that asset is necessary
+for replay. Store only approved assets and avoid signed URLs whose lifetime is
 shorter than the replay window.
 
 ## Storage ownership

package/docs/production.md

@@ -59,7 +59,7 @@ can begin while the planner streams later scenes.
 - Treat late media as a fallback case, not a reason to freeze playback.
 - Keep the current scene and its narration during recoverable generation gaps.
 - End cleanly on a terminal error and show an application retry control.
-- Retry only before visible output or from an explicit validated resume point.
+- Retry only before visible output; preserve accepted scenes after playback starts.
 
 ## Measure the stages
 
@@ -106,6 +106,6 @@ npm test
 - [ ] Both orientations render and narration stays synchronized.
 - [ ] A packed-artifact consumer and deterministic browser chat pass.
 - [ ] One bounded real-provider run meets the product's latency and quality target.
-- [ ] Stored responses replay exactly and application-owned export is verified.
+- [ ] Completed stored responses parse and replay correctly.
 
 [← Documentation home](../README.md) · [Previous: Errors and recovery](errors.md)

package/docs/provider-integration.md

@@ -1,4 +1,4 @@
-[← Documentation home](../README.md) · [Previous: Getting started](getting-started.md) · [Next: Branding and personalization →](branding-and-personalization.md)
+[← Documentation home](../README.md) · [Previous: Getting started](getting-started.md) · [Next: Customization →](customization.md)
 
 # Provider integration
 
@@ -11,10 +11,16 @@ npx vanillasky doctor
 npm run dev
 ```
 
-The generated `server.ts` is the canonical provider example. It starts with one
-text key, packaged templates, and browser voice. Adding the optional generated
-speech, stock, transcription, or generated-video key enables its callback and
-advertises the capability automatically; `src/main.tsx` does not change.
+Init runs doctor automatically. The generated `server.ts` starts with one
+`ANTHROPIC_API_KEY`, packaged templates, and browser voice; it installs no
+optional speech or video packages.
+
+Use `npx vanillasky providers add speech` to install xAI speech, or
+`npx vanillasky providers add video` to install FAL video and transcription.
+Add `XAI_API_KEY` or `FAL_KEY` to `.env.local` and restart the server. Stock media
+needs only `PEXELS_API_KEY`, with no extra installation. These app-owned
+adapters advertise their capabilities automatically; `src/main.tsx` does not
+change. Rerun an interrupted setup command to finish installation.
 
 For the full chat experience, mount one `createVideoChatHandler` and keep every
 provider choice in its callbacks:

package/docs/reference/provider-adapters.md

@@ -1,11 +1,11 @@
 # Secure LLM provider adapters
 
 This page covers the planner boundary. For Pexels and other visual providers,
-read [Media and audio](../media-and-audio.md#media-providers).
+read [Media and voice](../media-and-audio.md).
 
 VanillaSky deliberately does not depend on a model provider or AI framework.
-Your server owns the model and credentials; `createVideoHandler` accepts one
-small `streamText` callback. The recommended adapter is the [AI SDK](https://ai-sdk.dev/docs/reference/ai-sdk-core/stream-text),
+Your server owns the model and credentials; `createVideoChatHandler` accepts
+`streamText` and `generateText` callbacks. The recommended adapter is the [AI SDK](https://ai-sdk.dev/docs/reference/ai-sdk-core/stream-text),
 which gives the application one `LanguageModel` interface across official,
 community, AI Gateway, OpenAI-compatible, and custom providers.
 
@@ -19,14 +19,23 @@ npm install ai @ai-sdk/anthropic
 
 ```ts
 import { anthropic } from "@ai-sdk/anthropic";
-import { streamText } from "ai";
-import { createVideoHandler } from "@vanillaskyai/video/server";
+import { generateText, streamText } from "ai";
+import { createVideoChatHandler } from "@vanillaskyai/video/server";
 
 const modelId = process.env.ANTHROPIC_MODEL;
 if (!modelId) throw new Error("Set ANTHROPIC_MODEL in the server environment");
 
-export const POST = createVideoHandler({
+export const POST = createVideoChatHandler({
   authorize: verifySession,
+  generateText: async ({ systemPrompt, userPrompt, signal }) => {
+    const result = await generateText({
+      model: anthropic(modelId),
+      system: systemPrompt,
+      prompt: userPrompt,
+      abortSignal: signal,
+    });
+    return result.text;
+  },
   streamText: ({ systemPrompt, userPrompt, signal }) => streamText({
     model: anthropic(modelId),
     system: systemPrompt,
@@ -67,92 +76,31 @@ replace that per-line validator with whole-response structured output: motion
 streaming intentionally renders the first scene before the full composition is
 complete.
 
-## Advanced: native provider loops
-
-Use the lower-level callback directly when the AI SDK does not expose a
-provider-specific feature you need. `streamText` may return either an
-`AsyncIterable<string>` or an object with `textStream` plus optional
-`finishReason`, `rawFinishReason`, `usage`, `providerMetadata`, and
-response/final-step metadata. Requested model IDs are read from the final
-step's `model.modelId`; resolved IDs are read from response metadata. Prefer the
-richer form when the native provider exposes completion metadata.
-
-Provider retries remain host-owned. Retry only within an explicit request and
-time budget, and never silently restart after visible output unless the host
-has validated durable resume storage.
-
-### OpenAI Responses API
-
-```ts
-import OpenAI from "openai";
-import { createVideoHandler } from "@vanillaskyai/video/server";
-
-const apiKey = process.env.OPENAI_API_KEY;
-const model = process.env.OPENAI_MODEL;
-if (!apiKey || !model) throw new Error("Set OPENAI_API_KEY and OPENAI_MODEL");
+## Native or self-hosted providers
 
-const openai = new OpenAI({ apiKey });
+The same chat contract supports a native provider without an AI SDK dependency.
+Return an `AsyncIterable<string>` from `streamText`, or an object with
+`textStream` and optional completion metadata. Implement `generateText` for the
+small welcome, suggestion, and fallback narration tasks and return its text.
+Infer each callback from `VideoChatHandlerOptions` so the adapter stays aligned
+with the public contract.
 
-export const POST = createVideoHandler({
-  authorize: verifySession,
-  streamText: async function* ({ systemPrompt, userPrompt, signal }) {
-    const stream = await openai.responses.create({
-      model,
-      input: [
-        { role: "system", content: systemPrompt },
-        { role: "user", content: userPrompt },
-      ],
-      stream: true,
-    }, { signal });
-
-    for await (const event of stream) {
-      if (event.type === "response.output_text.delta") yield event.delta;
-    }
-  },
-});
-```
+Forward the supplied signal, preserve both prompt strings, and keep provider
+errors and credentials on the server. Retry only within an explicit time and
+spend budget before output is visible. The chat does not expose a durable
+stream-reconnect contract.
 
-OpenAI documents the typed `response.output_text.delta` event in its
-[Responses streaming guide](https://developers.openai.com/api/docs/guides/streaming-responses).
-
-### Anthropic Messages API
-
-```ts
-import Anthropic from "@anthropic-ai/sdk";
-import { createVideoHandler } from "@vanillaskyai/video/server";
-
-const apiKey = process.env.ANTHROPIC_API_KEY;
-const model = process.env.ANTHROPIC_MODEL;
-if (!apiKey || !model) throw new Error("Set ANTHROPIC_API_KEY and ANTHROPIC_MODEL");
-
-const anthropic = new Anthropic({ apiKey });
-
-export const POST = createVideoHandler({
-  authorize: verifySession,
-  streamText: async function* ({ systemPrompt, userPrompt, signal }) {
-    const stream = anthropic.messages.stream({
-      model,
-      max_tokens: 4096,
-      system: systemPrompt,
-      messages: [{ role: "user", content: userPrompt }],
-    }, { signal });
-
-    for await (const event of stream) {
-      if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
-        yield event.delta.text;
-      }
-    }
-  },
-});
-```
+## Generated-video budget
 
-Anthropic documents `content_block_delta` and `text_delta` in its
-[Messages streaming guide](https://platform.claude.com/docs/en/build-with-claude/streaming).
+Set `maxGeneratedVideos` on `createVideoChatHandler` to a nonnegative safe integer
+(default `5`). This is a per-response attempt limit for full mode, including the
+reserved first shot and failures. Use `0` to keep the configured full mode on
+stock footage. Stock lookup is independent of this limit. Retries inside your
+provider callback can incur additional charges; bound those separately. Never
+copy an untrusted request value into this application-owned option.
 
-## Optional web fetch and other tools
+## Application retrieval
 
-Keep tools server-side and outside the SDK core. Fetch or search before motion
-generation, append only the approved grounded result to `input`, and
-record provenance separately. Apply domain allowlists, SSRF protection,
-timeouts, redirect limits, and response-size limits. Do not give a model a
-general-purpose fetch tool unless the application truly needs one.
+Fetch or search approved context in the application before asking the chat.
+Include only authorized facts in the prompt or conversation and record
+provenance separately. Keep retrieval tools and private URLs server-side.

package/docs/security.md

@@ -7,7 +7,7 @@ The SDK validates protocol shape; your application still owns identity, authoriz
 ## Required server controls
 
 - Authenticate the user and tenant before reading the prompt body.
-- `createVideoChatHandler` and the lower-level `createVideoHandler` require an
+- `createVideoChatHandler` requires an
   explicit `authorize` policy. The
   `authorize: "none"` escape hatch is for intentionally non-public in-process
   tests only; do not use it on a billable generation route.

package/docs/streaming-protocol.md

@@ -2,7 +2,7 @@
 
 # Streaming protocol
 
-`createVideoHandler` returns validated server-sent events and `useVideo` consumes
+`createVideoChatHandler` returns validated server-sent events and `useVideoChat` consumes
 them. Normal applications do not parse SSE or reduce events themselves.
 
 The internal protocol is deterministic and versioned. A run starts once, adds or
@@ -10,6 +10,6 @@ patches only complete validated scenes, and terminates exactly once as complete,
 error, or aborted. Every event has a run ID and sequence. Completion carries the
 authoritative snapshot and drift-detection checksum.
 
-Persist `video.video` when replay, editing, or export is required. Played scenes
+Persist completed `chat.turns` video values when replay is required. Played scenes
 are immutable; patches may affect only future scenes. See the [protocol reference](reference/protocol.md)
 when implementing infrastructure rather than an ordinary SDK integration.

package/examples/custom-template/README.md

@@ -8,12 +8,12 @@ templates sync` and `npx vanillasky templates check`.
 | --- | --- |
 | [Minimal text](minimal-text.tsx) | One short, grounded idea should fill the scene. |
 | [Structured data](structured-data.tsx) | An exact metric and its change are the central proof. |
-| [Supplied media](supplied-media.tsx) | An image already supplied by the application is the strongest evidence. |
 
-All three use only `defineTemplate` from the public
+Both use only `defineTemplate` from the public
 `@vanillaskyai/video/templates` entry point. They include selection guidance,
 JSON Schema defaults, a named example, deterministic progress-based motion,
-safe-zone layout, and portrait/landscape handling. The media reference uses
-`format: "supplied-image"` for an image that must appear in
-`VideoInput.suppliedMedia`; use `format: "uri"` for another approved media or
-link URL governed by the same server media policy.
+safe-zone layout, and portrait/landscape handling. Connect the generated browser
+registry through `VideoChat` options and the server registry through
+`createVideoChatHandler`, as shown in [Custom templates](../../docs/custom-templates.md).
+For media-backed answers, start from a built-in template using
+`npx vanillasky templates add media` and configure the handler's `searchMedia`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanillaskyai/video",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Open-source voice-and-video chat SDK for AI applications.",
   "keywords": [
     "video-chat",
@@ -36,6 +36,9 @@
     "starters/video-chat/index.html",
     "starters/video-chat/package.json",
     "starters/video-chat/server.ts",
+    "starters/video-chat/providers.ts",
+    "starters/video-chat/providers/speech.ts",
+    "starters/video-chat/providers/video.ts",
     "starters/video-chat/src/main.tsx",
     "starters/video-chat/stock.ts",
     "starters/video-chat/tsconfig.json",
@@ -90,9 +93,6 @@
     "./video-chat.css": "./styles/video-chat.css"
   },
   "scripts": {
-    "acceptance:live": "tsx scripts/acceptance/run-live.ts",
-    "acceptance:review": "tsx scripts/acceptance/review.ts",
-    "acceptance:replay": "tsx scripts/acceptance/run-replay.ts",
     "browser:install": "playwright install chromium firefox webkit",
     "browser:test": "playwright test",
     "build": "tsup",
@@ -112,7 +112,8 @@
     "verify:package-size": "tsx scripts/verify-package-size.ts",
     "verify:api": "npm run build && node scripts/verify-public-api-surface.mjs",
     "verify:package": "npm run build && node scripts/verify-packed-package.mjs",
-    "release:build": "node scripts/release-build.mjs"
+    "release:build": "node scripts/release-build.mjs",
+    "acceptance:chat": "tsx scripts/acceptance/run.ts"
   },
   "peerDependencies": {
     "react": ">=18 <20",
@@ -131,7 +132,6 @@
     }
   },
   "devDependencies": {
-    "@anthropic-ai/sdk": "^0.120.0",
     "@eslint/js": "^9.39.1",
     "@playwright/test": "1.62.0",
     "@testing-library/react": "^16.3.0",
@@ -142,7 +142,6 @@
     "eslint": "^9.39.1",
     "globals": "^16.5.0",
     "jsdom": "^26.1.0",
-    "openai": "^7.5.0",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "tsup": "^8.5.1",

package/registry/items/barChart.json

@@ -164,7 +164,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -183,7 +183,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/bigNumber.json

@@ -149,7 +149,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -168,7 +168,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/brandMessage.json

@@ -89,7 +89,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -108,7 +108,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/cardList.json

@@ -134,7 +134,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -153,7 +153,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/codeEditor.json

@@ -110,7 +110,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -129,7 +129,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/ctaLogo.json

@@ -86,7 +86,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "default": ""
           },
           "mediaType": {
@@ -104,7 +104,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/ctaMedia.json

@@ -110,7 +110,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -129,7 +129,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/incomingCall.json

@@ -101,7 +101,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -120,7 +120,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/media.json

@@ -102,7 +102,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -121,7 +121,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/milestone.json

@@ -134,7 +134,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -153,7 +153,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/notification.json

@@ -108,7 +108,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -127,7 +127,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/phoneMockup.json

@@ -185,7 +185,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "default": ""
           },
           "mediaType": {
@@ -203,7 +203,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },

package/registry/items/problemSolution.json

@@ -116,7 +116,7 @@
           "mediaKeyword": {
             "type": "string",
             "title": "Background search keyword",
-            "description": "2-4 word English term for Pexels stock-footage search (auto-fills mediaUrl).",
+            "description": "2-4 word English term for stock-media search (auto-fills mediaUrl).",
             "format": "stock-media-keyword",
             "default": ""
           },
@@ -135,7 +135,7 @@
           "mediaPoster": {
             "type": "string",
             "title": "Background poster image",
-            "description": "Still image URL shown while a video backdrop is decoding its first frame. Auto-filled from Pexels' thumbnail when fillPexelsUrls sets a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
+            "description": "Still image URL shown while a video backdrop is decoding its first frame. A media resolver can supply a poster alongside a video mediaUrl. Hides the gradient flash that would otherwise appear in the ~50–400ms gap between a <video> mounting and decoding its first frame.",
             "format": "uri",
             "default": ""
           },