@vanillaskyai/video 0.10.22 → 0.11.0

package/dist/chunk-IQMYK5DX.js

@@ -1,133 +0,0 @@
-import {
-  validateTemplateSchemaValue
-} from "./chunk-EGVQODKU.js";
-import {
-  getTemplateSchemaGates,
-  isMeaningfullyPresentTemplateValue
-} from "./chunk-73NTSFFI.js";
-
-// src/visual-system/catalog/validate.ts
-function* walkSchemaValue(property, value, path) {
-  yield { property, value, path };
-  if (property.type === "array" && property.items && Array.isArray(value)) {
-    for (const [index, item] of value.entries()) {
-      yield* walkSchemaValue(property.items, item, `${path}.${index}`);
-    }
-  }
-  if (property.type === "object" && value && typeof value === "object" && !Array.isArray(value)) {
-    for (const [name, child] of Object.entries(property.properties ?? {})) {
-      if (Object.hasOwn(value, name)) {
-        yield* walkSchemaValue(child, value[name], `${path}.${name}`);
-      }
-    }
-  }
-}
-function schemaValues(schema, variables) {
-  const values = [];
-  for (const [name, property] of Object.entries(schema.properties)) {
-    if (Object.hasOwn(variables, name)) values.push(...walkSchemaValue(property, variables[name], name));
-  }
-  return values;
-}
-function validateTemplateSceneStructure(schema, value, deferMediaUrls = false) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error("Template variable variables must be object");
-  }
-  const object = value;
-  const requiredFields = new Set(schema.required ?? []);
-  for (const required of schema.required ?? []) {
-    if (!Object.hasOwn(object, required)) throw new Error(`Template variable ${required} is required`);
-  }
-  if (schema.additionalProperties === false) {
-    for (const name of Object.keys(object)) {
-      if (!Object.hasOwn(schema.properties, name)) throw new Error(`Template variable ${name} is not declared`);
-    }
-  }
-  for (const [name, property] of Object.entries(schema.properties)) {
-    if (Object.hasOwn(object, name)) validateTemplateSchemaValue(property, object[name], name, {
-      deferMediaUrls,
-      errorPrefix: "Template variable ",
-      includeTypeArticle: true,
-      allowEmptyOptionalMedia: property.default === "",
-      optional: !requiredFields.has(name)
-    });
-  }
-}
-function validateConditionalPresence(templateId, groups, variables) {
-  for (const group of groups) {
-    if (group.some((field) => Object.hasOwn(variables, field) && isMeaningfullyPresentTemplateValue(variables[field]))) continue;
-    throw new Error(`Template ${templateId} requires a non-empty value for ${group.join(" or ")}`);
-  }
-}
-function suppliedUrls(input) {
-  const urls = /* @__PURE__ */ new Set();
-  for (const media of input.suppliedMedia ?? []) {
-    urls.add(media.url);
-    if (media.posterUrl) urls.add(media.posterUrl);
-  }
-  return urls;
-}
-function containsSuppliedQuantity(input, value) {
-  if (typeof value !== "string" && typeof value !== "number") return false;
-  const normalize = (text) => text.normalize("NFKC").replace(/\u2212/g, "-").replace(/\s+/gu, " ").replace(/([\p{Sc}]) (?=[+−-]?\d)/gu, "$1").replace(/(\d) (?=[%‰])/gu, "$1").trim();
-  const quantity = normalize(String(value));
-  if (!/\d/u.test(quantity)) return false;
-  const source = normalize(input);
-  let offset = source.indexOf(quantity);
-  while (offset !== -1) {
-    const before = source.slice(0, offset);
-    const after = source.slice(offset + quantity.length);
-    const beginsInside = /[\p{L}\p{N}\p{Sc}%‰+−-]$/u.test(before) || /\d[.,]$/u.test(before);
-    const endsInside = /^[\p{L}\p{N}\p{Sc}%‰]/u.test(after) || /^[.,]\d/u.test(after);
-    const dropsUnit = /\d$/u.test(quantity) && /^ (?:%|‰|percent\b|per cent\b|thousand\b|million\b|billion\b|trillion\b|usd\b|eur\b|gbp\b|dollars?\b|euros?\b|pounds?\b)/iu.test(after);
-    if (!beginsInside && !endsInside && !dropsUnit) return true;
-    offset = source.indexOf(quantity, offset + 1);
-  }
-  return false;
-}
-function createTemplateSceneValidator(options) {
-  return (scene, context) => {
-    const template = options.kit.getTemplateMetadata(scene.templateId);
-    if (!template) throw new Error(`Template ${scene.templateId} is not installed`);
-    const schema = template.schema;
-    const gates = getTemplateSchemaGates(schema);
-    validateConditionalPresence(scene.templateId, gates.requiredAnyOf, scene.variables);
-    validateTemplateSceneStructure(schema, scene.variables);
-    const values = schemaValues(schema, scene.variables);
-    const allowedUrls = suppliedUrls(context.input);
-    const suppliedImageUrls = new Set((context.input.suppliedMedia ?? []).filter(({ type }) => type === "image").map(({ url }) => url));
-    if (gates.requiresScreenshot) {
-      const screenshots = values.filter(({ property }) => property.format === "supplied-image").map(({ value }) => value).filter((value) => typeof value === "string" && Boolean(value.trim()));
-      if (!screenshots.length || screenshots.some((url) => !suppliedImageUrls.has(url))) {
-        throw new Error(`Template ${scene.templateId} requires a supplied screenshot image`);
-      }
-    }
-    for (const { path, property, value } of values) {
-      const isMedia = property.format === "uri" || property.format === "supplied-image";
-      if (!isMedia || typeof value !== "string" || !value.trim()) continue;
-      const permitted = allowedUrls.has(value) || options.allowMediaUrl?.(value, {
-        ...context,
-        scene,
-        variable: path
-      });
-      if (!permitted) throw new Error(`Template variable ${path} must use supplied media`);
-    }
-    if (gates.requiresStat) {
-      const quantities = values.filter(({ property }) => property.format === "grounded-stat");
-      if (!quantities.length || quantities.some(({ value }) => !containsSuppliedQuantity(context.input.input, value))) {
-        throw new Error(`Template ${scene.templateId} requires an exact supplied quantity, preserving its unit`);
-      }
-    }
-    if (gates.requiresQuote) {
-      const quoteValues = values.filter(({ property, value }) => property.format === "grounded-quote" && typeof value === "string" && value.trim()).map(({ value }) => String(value).trim());
-      if (!quoteValues.length || quoteValues.some((quote) => !context.input.input.includes(quote))) {
-        throw new Error(`Template ${scene.templateId} requires an exact quote from the raw input`);
-      }
-    }
-  };
-}
-
-export {
-  validateTemplateSceneStructure,
-  createTemplateSceneValidator
-};

package/dist/chunk-IR44XKBI.js

@@ -1,46 +0,0 @@
-import {
-  BUILTIN_TEMPLATE_CATALOG
-} from "./chunk-IIN5M5HW.js";
-import {
-  assertTemplateTransitionMetadata
-} from "./chunk-2E6T633S.js";
-
-// src/visual-system/catalog/server-kit.ts
-function createServerTemplateRegistry(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]);
-  const capabilities = { templates: templates.map(({ id }) => id) };
-  return Object.freeze({
-    capabilities,
-    getTemplateMetadata: (id) => byId.get(id),
-    listTemplateMetadata: () => [...templates]
-  });
-}
-function overlayServerTemplateRegistry(defaults, customer) {
-  const defaultTemplates = defaults.listTemplateMetadata();
-  const customerTemplates = customer.listTemplateMetadata();
-  const customerMetadata = new Map(customerTemplates.map((template) => [template.id, template]));
-  const defaultIds = new Set(defaultTemplates.map(({ id }) => id));
-  return createServerTemplateRegistry({
-    templates: [
-      ...defaultTemplates.map((template) => customerMetadata.get(template.id) ?? template),
-      ...customerTemplates.filter(({ id }) => !defaultIds.has(id))
-    ]
-  });
-}
-
-// src/visual-system/catalog/builtin-server.ts
-var BUILTIN_SERVER_TEMPLATE_KIT = createServerTemplateRegistry({
-  templates: BUILTIN_TEMPLATE_CATALOG
-});
-
-export {
-  createServerTemplateRegistry,
-  overlayServerTemplateRegistry,
-  BUILTIN_SERVER_TEMPLATE_KIT
-};

package/dist/chunk-JKVOBTRO.js

@@ -1,145 +0,0 @@
-import {
-  createVideoSystemPrompt
-} from "./chunk-LVM5Q2DL.js";
-import {
-  PACING_PLANNER_RULES
-} from "./chunk-3O7OMMMF.js";
-import {
-  getTemplateSchemaGates,
-  templateVariableNotation
-} from "./chunk-73NTSFFI.js";
-
-// src/visual-system/catalog/media-resolver-contract.ts
-function getStandardMediaResolverContract(schema) {
-  const keyword = schema.properties.mediaKeyword;
-  const url = schema.properties.mediaUrl;
-  const type = schema.properties.mediaType;
-  const allowedTypes = new Set(type?.enum ?? []);
-  if (keyword?.format !== "stock-media-keyword" || url?.format !== "uri" || !["photo", "video"].every((value) => allowedTypes.has(value))) {
-    return void 0;
-  }
-  return {
-    acceptsPoster: schema.properties.mediaPoster?.format === "uri"
-  };
-}
-
-// src/visual-system/catalog/prompt.ts
-function plannerProperty(property) {
-  return {
-    ...property.description == null ? {} : { description: property.description },
-    ...property.examples == null ? {} : { examples: property.examples.slice(0, 1) },
-    ...property.type == null ? {} : { type: property.type },
-    ...property.format == null ? {} : { format: property.format },
-    ...property.enum == null ? {} : { enum: property.enum },
-    ...property.minItems == null ? {} : { minItems: property.minItems },
-    ...property.maxItems == null ? {} : { maxItems: property.maxItems },
-    ...property.minLength == null ? {} : { minLength: property.minLength },
-    ...property.maxLength == null ? {} : { maxLength: property.maxLength },
-    ...property.minimum == null ? {} : { minimum: property.minimum },
-    ...property.maximum == null ? {} : { maximum: property.maximum },
-    ...property.items == null ? {} : { items: plannerProperty(property.items) },
-    ...property.properties == null ? {} : {
-      properties: Object.fromEntries(Object.entries(property.properties).map(([name, child]) => [name, plannerProperty(child)]))
-    },
-    ...property.required == null ? {} : { required: property.required },
-    ...property.additionalProperties == null ? {} : {
-      additionalProperties: property.additionalProperties
-    }
-  };
-}
-function plannerSchema(schema, exposeMediaKeyword) {
-  const hiddenFields = exposeMediaKeyword ? /* @__PURE__ */ new Set() : /* @__PURE__ */ new Set(["mediaKeyword"]);
-  const properties = Object.fromEntries(
-    Object.entries(schema.properties).filter(([name]) => !hiddenFields.has(name)).map(([name, property]) => [name, name === "mediaKeyword" ? plannerProperty({ ...property, minLength: 2, maxLength: 80 }) : plannerProperty(property)])
-  );
-  const required = schema.required?.filter((name) => !hiddenFields.has(name));
-  return {
-    type: "object",
-    properties,
-    ...required === void 0 ? {} : { required },
-    ...schema.additionalProperties == null ? {} : {
-      additionalProperties: schema.additionalProperties
-    }
-  };
-}
-function isMediaProperty(property) {
-  return property?.format === "uri" || property?.format === "supplied-image" || property?.format === "stock-media-keyword";
-}
-function requiresAvailableMedia(template) {
-  const gates = getTemplateSchemaGates(template.schema);
-  return (template.schema.required ?? []).some((name) => isMediaProperty(template.schema.properties[name])) || gates.requiredAnyOf.some((group) => group.every((name) => isMediaProperty(template.schema.properties[name])));
-}
-function plannerCatalog(templates, mediaResolverAvailable) {
-  return templates.map((template) => {
-    const gates = getTemplateSchemaGates(template.schema);
-    const exposeMediaKeyword = mediaResolverAvailable && getStandardMediaResolverContract(template.schema) != null;
-    const variables = Object.fromEntries(
-      Object.entries(template.schema.properties).filter(([name]) => name !== "mediaKeyword" || exposeMediaKeyword).map(([name, property]) => [
-        name,
-        name === "mediaKeyword" ? "string{2..80}" : templateVariableNotation(property, template.schema.required?.includes(name) === true)
-      ])
-    );
-    return {
-      id: template.id,
-      jobs: template.jobs,
-      use: template.useWhen ?? template.description,
-      ...template.avoidWhen ? { avoid: template.avoidWhen } : {},
-      ...template.minDuration == null && template.preferredDuration == null ? {} : {
-        seconds: [template.minDuration ?? null, template.preferredDuration ?? null]
-      },
-      ...gates.requiresStat ? { requiresStat: true } : {},
-      ...gates.requiresQuote ? { requiresQuote: true } : {},
-      ...gates.requiresScreenshot ? { requiresScreenshot: true } : {},
-      ...gates.requiredAnyOf.length > 0 ? { requiredAnyOf: gates.requiredAnyOf.map((group) => group.filter((name) => name !== "mediaKeyword" || exposeMediaKeyword)) } : {},
-      schema: plannerSchema(template.schema, exposeMediaKeyword),
-      variables
-    };
-  });
-}
-function createTemplateSystemPrompt(options) {
-  const templates = options.kit.listTemplateMetadata().filter((template) => !requiresAvailableMedia(template) || options.suppliedMediaAvailable === true || options.mediaResolverAvailable === true && getStandardMediaResolverContract(template.schema) != null);
-  const resolverMediaAvailable = options.mediaResolverAvailable === true && templates.some(({ schema }) => getStandardMediaResolverContract(schema) != null);
-  const basePrompt = createVideoSystemPrompt(options.knowledgeMode, options.narrate === true).split("\n").filter(
-    (line) => !line.includes("Never use media, ctaMedia, or reaction as the first generated body template") && // The rule that keeps the opening beat asset-free belongs to the same
-    // pair as the one below it: both exist so playback can start without
-    // waiting on a provider, and both go when the host owns that wait.
-    !(options.mediaOnFirstScene === true && line.includes("The first generated body scene must be asset-free")) && !(resolverMediaAvailable && line.includes("Never expose a loading placeholder or unresolved media keyword"))
-  ).join("\n");
-  const mediaTemplates = templates.filter(({ schema }) => getStandardMediaResolverContract(schema) != null).map(({ id }) => id);
-  const terminalPayoffs = templates.filter(({ jobs }) => jobs?.includes("payoff")).map(({ id }) => id);
-  return [
-    basePrompt.trim(),
-    options.basePrompt?.trim() ? `
-APPLICATION GUIDANCE
-${options.basePrompt.trim()}` : void 0,
-    "",
-    "TRUSTED TEMPLATE CATALOG",
-    "Only use template IDs from this catalog. Only emit variables declared for the selected template.",
-    "Variable notation is type[count]{characters}(options)! where count is list cardinality, characters is the inclusive character count for a string or each string-array item, and ! means required. Omitted ! means optional.",
-    "Choose a template only when the permitted factual basis contains every fact it needs. Never invent peer values to complete a chart, comparison, stat set, timeline, or list.",
-    ...PACING_PLANNER_RULES,
-    "Let narration carry ordinary lists. Use a structured overlay only when a comparison, sequence, exact quote or key figure adds understanding beyond the voice. Prefer relevant full-bleed footage for the remaining visual beats, with varied purposeful action and framing.",
-    "If the catalog includes a suitable ask template and the input supplies a grounded CTA or URL, keep that concise action closer as its own final scene instead of folding it into preceding content.",
-    "When a grounded CTA or URL is supplied and the catalog contains jobs:[ask], emit that final closer. A brand name may accompany the action but never qualifies as an ask by itself.",
-    terminalPayoffs.length > 0 ? `When there is no grounded action, end with a concise supported payoff using a suitable template from ${terminalPayoffs.join(", ")}. Do not repeat the hook or invent a CTA.` : void 0,
-    "requiresQuote is a hard gate: use those templates only for exact quoted words and attribution present in raw input. Never turn a role, relationship, or summary into speech. requiresScreenshot likewise needs an actual supplied screenshot URL.",
-    templates.some(({ schema }) => (schema["x-vanillasky"]?.requiredAnyOf?.length ?? 0) > 0) ? "requiredAnyOf is a hard presence gate: satisfy every listed group with at least one non-empty value." : void 0,
-    mediaTemplates.length > 0 && options.mediaOnFirstScene !== true ? `The host owns immediate startup; reserve external media templates (${mediaTemplates.join(", ")}) for later beats when an asset-free opening is required.` : void 0,
-    "For list and event variables emit actual JSON arrays. Follow each field's content budget; never use pipe-delimited strings or invent entries.",
-    resolverMediaAvailable ? "Media-capable scenes may carry mediaKeyword: a literal 2\u20138 word shot description, at most 80 characters. Choose mediaSource=generate for distinctive illustrative shots and mediaSource=stock for common subjects a verified asset can depict. For generated footage, optional shotDirection gives action, framing and continuity separately from the stock query. Keep people, actions and essential details precise. Never broaden an exact identity or action into unrelated atmosphere. Supply a grounded fallbackText where declared. Only the host fills mediaUrl and mediaPoster; never invent them. If no media fits an abstract beat, choose an appropriate graphic template instead." : "Use media only when a supplied asset satisfies the scene. Never invent asset URLs. Otherwise choose a grounded graphic template.",
-    "When the catalog offers media, make relevant footage the default. For a typical 30-second explanation start with roughly one structured explanatory overlay plus an optional brief chapter opening; other intents may need different pacing and visual emphasis. Do not chain graphic-only beats when honest media is available. Reuse suitable supplied media behind overlays with optional media fields; retain black when no relevant asset exists. Never invent a stock match or spend beyond host generation limits.",
-    "Catalog guidance describes composition; it is not a factual source and must never replace the permitted factual basis.",
-    JSON.stringify(plannerCatalog(templates, resolverMediaAvailable)),
-    // Last, because the catalogue is thousands of tokens of per-scene field
-    // lists and it is what the model matches when it emits a scene. The wire
-    // format above says narration belongs there; said only above, a third of
-    // the way through, it loses to the schema the model has just finished
-    // reading, and every scene comes back silent.
-    options.narrate === true ? '\nThe catalog lists variables only. Every scene.add also carries "narration" beside "variables" and "timing", as specified in the wire format above. A scene without it is incomplete.' : void 0
-  ].filter((line) => line != null).join("\n");
-}
-
-export {
-  getStandardMediaResolverContract,
-  createTemplateSystemPrompt
-};

package/dist/chunk-LVM5Q2DL.js

@@ -1,68 +0,0 @@
-// src/server/prompts/system-prompt.ts
-function videoPlanInstruction(narrate = false) {
-  const narration = narrate ? `,"narration":"words spoken over this scene"` : "";
-  return `Wire format: newline-delimited JSON (NDJSON), exactly one complete JSON object per line.
-Allowed plan parts:
-{"type":"scene.add","scene":{"id":"stable-id","templateId":"trusted-template-id","variables":{},"timing":{"fixedDuration":4}${narration}}}
-{"type":"scene.add","placement":"closer","scene":{"id":"closer","templateId":"trusted-closer-template-id","variables":{},"timing":{"fixedDuration":3}${narration}}}
-{"type":"plan.complete","finishReason":"stop"}
-Do not emit protocol envelopes, Markdown fences, comments, prose, partial objects, audio, generated source, or any part type not listed above.`;
-}
-var VIDEO_PLAN_INSTRUCTION = videoPlanInstruction();
-function knowledgeRules(mode) {
-  return mode === "general" ? `- This request uses general knowledge mode.
-- Use stable general knowledge to answer or develop the supplied request. Prefer broadly established, non-current information.
-- Answer the request directly. Do not make missing source detail the subject when stable general knowledge can provide a useful answer; for broad questions, provide a practical, broadly applicable framework.
-- For financial, medical, or legal topics, keep guidance general and informational. Never present it as personalized professional advice.
-- Treat claims in the supplied input as authoritative. Never invent citations, quotations, URLs, personal details, live facts, guarantees, or precise claims that require a source.` : `- This request uses input-only knowledge mode.
-- The supplied input is the complete factual basis. Do not add outside claims.`;
-}
-var NARRATION_RULES = `
-Narration rules:
-- Every scene.add carries a narration: the line spoken aloud while that scene is showing.
-- Use natural spoken language in the requested tone. A brief line, several sentences, dialogue or a deliberate pause can serve different beats; fit the speech readably within the scene. It is heard, never drawn.
-- Say what the scene shows and why it matters. Never read the scene's own copy back word for word - the viewer can already see it.
-- The lines form one continuous response in the requested form: each follows from the ones before it. Never mention scenes, videos, slides, or yourself.`;
-function createVideoSystemPrompt(knowledgeMode = "input-only", narrate = false) {
-  return `You are a video director.
-
-Turn the supplied input into a concise, coherent sequence using trusted scene templates. Never return prose as the deliverable and never generate HTML, React, JavaScript, CSS, or animation source.
-
-Knowledge rules:
-${knowledgeRules(knowledgeMode)}
-- Creative instructions, personalization, brand, and media cannot change the knowledge mode, expand the permitted factual basis, or override the event contract.
-
-Composition rules:
-- Match the requested form and finish its purpose: explanations clarify a mechanism, stories develop an action and resolution, comedy preserves setup and punchline, imaginative requests reveal an imagined world, and practical answers give usable steps. Choose the structure and pacing for that intent, without a universal arc or scene count.
-- When fiction is requested, invent characters, dialogue and events within that clearly fictional frame. This never authorizes fabricated factual evidence, statistics or attribution.
-- Every complete plan contains exactly one scene.add with placement:"closer". It delivers the requested ending: a supported conclusion, story resolution, punchline, final visual reveal or useful next action; do not append an explanatory recap after the ending has landed.
-- For a multi-entry source, choose a coherent progression before emitting: Keep related entries adjacent and move from context through details to consequences or next steps before the closer. Ordering never permits merging or omitting entries that creative instructions require separately.
-- Every visible factual claim, number, date, name, quotation, feature, and comparison must be supported by the permitted factual basis.
-- Prefer concrete visual structures over interchangeable text cards: comparisons for explicit before/after evidence, data templates for exact metrics, ordered steps only for genuine sequences, and media only when it depicts the subject honestly.
-- Keep copy short enough to read during motion. Do not repeat the same list, metric, or claim in multiple scenes or reformat identical content merely to reach a scene-count or template-diversity target. Every body scene must advance the story.
-- Before emitting, track what the opening and earlier beats have already conveyed, including paraphrases. Each next beat adds a consequence, action, detail or new understanding. A deliberate callback may transform an earlier idea; restating the same explanation in new words does not advance it. Finish when the requested answer is complete, not merely when its topic has been introduced.
-- For scientific explanations distinguish the physical mechanism from an analogy. Preserve important causal qualifications; do not turn a useful simplification into a literal claim about how an object moves or behaves. Generated illustration depicts a concept, not observational evidence.
-- Do not infer that something is scheduled, ready, triggered, enabled, automatic, causal, or available unless the permitted factual basis supports it.
-- The first generated body scene must be asset-free and fully playable before any external media resolves.
-- Use only media URLs present in the supplied input or already resolved by the host. Never expose a loading placeholder or unresolved media keyword. Audio is optional and must never delay the first scene.
-- Audio is selected by the host before generation. Never emit audio.
-
-Streaming rules:
-- Emit every scene once as a complete scene.add.
-- Emit exactly one closer using placement:"closer". It is held and appended last; preserve the intended story order.
-- Prefer resolved media on scene.add. Scenes are immutable after emission.
-- End explicitly with plan.complete. A truncated stream is never treated as complete.
-- Return only plan parts accepted by the provided schema.
-
-${narrate ? NARRATION_RULES : ""}
-
-${videoPlanInstruction(narrate)}`;
-}
-var DEFAULT_VIDEO_SYSTEM_PROMPT = createVideoSystemPrompt();
-
-export {
-  videoPlanInstruction,
-  VIDEO_PLAN_INSTRUCTION,
-  createVideoSystemPrompt,
-  DEFAULT_VIDEO_SYSTEM_PROMPT
-};