@skyphusion-labs/vivijure-core 0.9.0

package/dist/operator-config.js

@@ -0,0 +1,85 @@
+// operator-config: the persistent, INSTANCE-scoped store for config_schema fields marked
+// `scope: "install"` (the operator-set-once knobs, e.g. notify-email's recipient address).
+//
+// The identity strip (#292) zeroed user_email, so this is NOT per-user: it is per-INSTALL, keyed on
+// (module_name, field_key) in the operator_module_config D1 table (migration 0005). The operator sets
+// these on the studio settings page (GET/PATCH /api/modules/:name/config); the core persists them
+// here and INJECTS them into the module invoke at hook time, so a field like notify_email actually
+// reaches the module at render.complete. Per-render fields (scope omitted / "render") are untouched
+// by this store -- they still flow through the per-render config path.
+//
+// The pure helpers (install-subschema projection, clamp-on-write) are vitest-testable without a D1
+// binding; the two query functions are verified live (matches the user-prefs / renders-db split).
+import { validateConfig } from "./modules/registry.js";
+/** Project a module's config_schema down to ONLY its install-scope fields. A field with no `scope`
+ *  (or scope "render") is a per-render knob and is excluded -- so this store never owns render config. */
+export function installSubschema(schema) {
+    const out = {};
+    if (!schema)
+        return out;
+    for (const [key, field] of Object.entries(schema)) {
+        if (field.scope === "install")
+            out[key] = field;
+    }
+    return out;
+}
+/** Does this module expose any install-scope config at all? */
+export function hasInstallConfig(schema) {
+    return Object.keys(installSubschema(schema)).length > 0;
+}
+/** The set of writable install field keys for a module (what PATCH is allowed to set). */
+export function installFieldKeys(schema) {
+    return Object.keys(installSubschema(schema));
+}
+/** Clamp an incoming patch to the module's install subschema, dropping unknown / render-scope keys.
+ *  Reuses the SAME validateConfig clamp the invoke path uses, so a stored value can never violate the
+ *  contract. Returns the full install-config (every install field, missing ones at their default). */
+export function clampInstallPatch(schema, current, patch) {
+    const sub = installSubschema(schema);
+    const merged = { ...current, ...(patch ?? {}) };
+    return validateConfig(sub, merged);
+}
+// --------------------------------------------------------------------------- D1 (verified live)
+/** Read the raw stored install values for a module (field_key -> decoded scalar). No schema applied;
+ *  callers pass through validateConfig / the subschema to get a contract-clean, default-filled view. */
+async function readStored(env, moduleName) {
+    const rs = await env.DB.prepare("SELECT field_key, value_json FROM operator_module_config WHERE module_name = ?")
+        .bind(moduleName)
+        .all();
+    const out = {};
+    for (const row of rs.results ?? []) {
+        try {
+            out[row.field_key] = JSON.parse(row.value_json);
+        }
+        catch {
+            // a corrupt row is ignored; the field falls back to its schema default downstream.
+        }
+    }
+    return out;
+}
+/** The module's install-config as the INVOKE path consumes it: every install field present, missing
+ *  ones at their schema default, clamped to the contract. Empty schema -> {} (a clean no-op). */
+export async function loadInstallConfig(env, moduleName, schema) {
+    const sub = installSubschema(schema);
+    if (Object.keys(sub).length === 0)
+        return {};
+    const stored = await readStored(env, moduleName);
+    return validateConfig(sub, stored);
+}
+/** Persist an operator PATCH: clamp to the install subschema (unknown / render keys dropped), then
+ *  upsert each field. Returns the resulting full install-config view. */
+export async function setInstallConfig(env, moduleName, schema, patch) {
+    const sub = installSubschema(schema);
+    const current = await readStored(env, moduleName);
+    const next = clampInstallPatch(schema, current, patch);
+    const now = Math.floor(Date.now() / 1000);
+    const stmt = env.DB.prepare(`INSERT INTO operator_module_config (module_name, field_key, value_json, updated_at)
+     VALUES (?, ?, ?, ?)
+     ON CONFLICT(module_name, field_key) DO UPDATE SET
+       value_json = excluded.value_json, updated_at = excluded.updated_at`);
+    const writes = Object.keys(sub).map((key) => stmt.bind(moduleName, key, JSON.stringify(next[key]), now));
+    if (writes.length)
+        await env.DB.batch(writes);
+    return next;
+}
+//# sourceMappingURL=operator-config.js.map

package/dist/operator-config.js.map

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

package/dist/output-extract.d.ts

@@ -0,0 +1,8 @@
+export declare function extractOutput(result: unknown): string;
+export declare function extractUsage(result: unknown): {
+    in_: number | null;
+    out_: number | null;
+};
+export declare function detectProviderFailure(result: unknown): string | null;
+export declare function extractProxiedImageUrl(result: unknown): string | null;
+//# sourceMappingURL=output-extract.d.ts.map

package/dist/output-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-extract.d.ts","sourceRoot":"","sources":["../src/output-extract.ts"],"names":[],"mappings":"AAeA,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAmDrD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAqBzF;AAcD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASpE;AAQD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOrE"}

package/dist/output-extract.js

@@ -0,0 +1,129 @@
+// Text-model output + usage extraction (v0.21.0).
+//
+// Extracted from src/index.ts so these pure functions are unit-testable
+// without importing index.ts (which pulls in `cloudflare:workers` and so
+// can't be loaded under the plain-Node vitest pool). Mirrors the same
+// extraction discipline used for parsers, chunking, discord, and ai-binding.
+//
+// Both functions normalize the many response shapes that reach the
+// non-streaming chat path. The shapes come from: Workers AI hosted models
+// (env.AI.run), Anthropic Messages API, Gemini, and OpenAI-style responses
+// (both chat-completions and the Responses API) returned by unified-billing
+// proxied models routed through env.AI.run. New shapes should be added here
+// with a unit test in tests/output-extract.test.ts rather than inlined at a
+// call site.
+export function extractOutput(result) {
+    if (typeof result === "string")
+        return result;
+    const r = result;
+    if (typeof r?.response === "string")
+        return r.response;
+    if (typeof r?.result === "string")
+        return r.result;
+    // OpenAI chat-completions shape (also what AI Gateway returns for most
+    // proxied OpenAI/OpenAI-compatible chat models): { choices: [{ message }] }
+    const choices = r?.choices;
+    if (Array.isArray(choices) && typeof choices[0]?.message?.content === "string") {
+        return choices[0].message.content;
+    }
+    // Anthropic Messages API: top-level content array
+    const content = r?.content;
+    if (Array.isArray(content)) {
+        const text = content.filter((b) => b.type === "text").map((b) => b.text ?? "").join("");
+        if (text)
+            return text;
+    }
+    // OpenAI Responses API shape (used by gpt-5.x-pro and similar): a top-level
+    // `output` array of items, each with a `content` array of typed blocks.
+    // Output text lives in blocks of type "output_text" (or plain "text").
+    const out = r?.output;
+    if (Array.isArray(out)) {
+        const text = out
+            .flatMap((block) => {
+            const b = block;
+            return (b?.content ?? [])
+                .filter((c) => c?.type === "output_text" || c?.type === "text")
+                .map((c) => c.text ?? "");
+        })
+            .join("");
+        if (text)
+            return text;
+    }
+    // Gemini-native (google/gemini-* via the binding, v0.21.3):
+    // { candidates: [{ content: { parts: [{ text }] } }] }
+    const candidates = r?.candidates;
+    if (Array.isArray(candidates)) {
+        const text = (candidates[0]?.content?.parts ?? [])
+            .map((p) => p.text ?? "")
+            .join("");
+        if (text)
+            return text;
+    }
+    // LLaVA 1.5 image-to-text (@cf/llava-hf/llava-1.5-7b-hf): { description }
+    if (typeof r?.description === "string")
+        return r.description;
+    return JSON.stringify(result);
+}
+export function extractUsage(result) {
+    const r = result;
+    // OpenAI / Anthropic: usage object on result. OpenAI uses
+    // prompt_tokens/completion_tokens; Anthropic uses input_tokens/output_tokens.
+    const u = r?.usage;
+    if (u) {
+        return {
+            in_: u.prompt_tokens ?? u.input_tokens ?? null,
+            out_: u.completion_tokens ?? u.output_tokens ?? null,
+        };
+    }
+    // Gemini-native usage (v0.21.3): usageMetadata.promptTokenCount /
+    // candidatesTokenCount (thoughtsTokenCount is reasoning, not counted as out).
+    const um = r?.usageMetadata;
+    if (um) {
+        return {
+            in_: um.promptTokenCount ?? null,
+            out_: um.candidatesTokenCount ?? null,
+        };
+    }
+    return { in_: null, out_: null };
+}
+// Detect a provider failure envelope returned as a normal resolved value
+// rather than thrown. Unified-billing proxied models (seen first with the
+// OpenAI chat models in v0.21.0) can return { state: "Failed", error: "..." }
+// from env.AI.run instead of rejecting; the gateway uses the same envelope
+// the LongRunWorkflow already checks for video/music. Without catching it,
+// extractOutput would JSON.stringify the envelope into chats.output and a
+// failed turn would persist as if it succeeded.
+//
+// Sync chat responses (OpenAI {choices}, Anthropic {content}, Workers AI
+// {response}) carry no `state` field, so a present `state` that isn't
+// "Completed" is the signal. Returns the upstream error message (for the
+// caller to surface as a 502) or null when the result looks normal.
+export function detectProviderFailure(result) {
+    if (!result || typeof result !== "object")
+        return null;
+    const r = result;
+    if (typeof r.state === "string" && r.state !== "Completed") {
+        return typeof r.error === "string" && r.error.trim()
+            ? r.error
+            : `provider returned state "${r.state}"`;
+    }
+    return null;
+}
+// Pull the generated-image URL out of a proxied image-gen response. Proxied
+// image models (the Google nano-banana family, added v0.21.2) return a URL,
+// not base64, wrapped in the same { state, result } envelope as video/music:
+//   { state: "Completed", result: { image: "<url>" } }
+// The bare { image: "<url>" } form (the documented Output schema, without the
+// binding wrapper) is accepted too. Returns the URL string or null.
+export function extractProxiedImageUrl(result) {
+    if (!result || typeof result !== "object")
+        return null;
+    const r = result;
+    const wrapped = r.result?.image;
+    if (typeof wrapped === "string" && wrapped.length > 0)
+        return wrapped;
+    if (typeof r.image === "string" && r.image.length > 0)
+        return r.image;
+    return null;
+}
+//# sourceMappingURL=output-extract.js.map

package/dist/output-extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-extract.js","sourceRoot":"","sources":["../src/output-extract.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,sEAAsE;AACtE,6EAA6E;AAC7E,EAAE;AACF,mEAAmE;AACnE,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,aAAa;AAEb,MAAM,UAAU,aAAa,CAAC,MAAe;IAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,MAAM,CAAC,GAAG,MAAiC,CAAC;IAE5C,IAAI,OAAO,CAAC,EAAE,QAAQ,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,QAAQ,CAAC;IACvD,IAAI,OAAO,CAAC,EAAE,MAAM,KAAK,QAAQ;QAAI,OAAO,CAAC,CAAC,MAAM,CAAC;IAErD,uEAAuE;IACvE,4EAA4E;IAC5E,MAAM,OAAO,GAAG,CAAC,EAAE,OAAgE,CAAC;IACpF,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC/E,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,kDAAkD;IAClD,MAAM,OAAO,GAAG,CAAC,EAAE,OAA8D,CAAC;IAClF,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxF,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,uEAAuE;IACvE,MAAM,GAAG,GAAG,CAAC,EAAE,MAAoC,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG;aACb,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACjB,MAAM,CAAC,GAAG,KAA8D,CAAC;YACzE,OAAO,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;iBACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,aAAa,IAAI,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC;iBAC9D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC;aACD,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IAED,4DAA4D;IAC5D,uDAAuD;IACvD,MAAM,UAAU,GAAG,CAAC,EAAE,UAAmF,CAAC;IAC1G,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;aAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;aACxB,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IAED,0EAA0E;IAC1E,IAAI,OAAO,CAAC,EAAE,WAAW,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,WAAW,CAAC;IAE7D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,MAAM,CAAC,GAAG,MAAiC,CAAC;IAC5C,0DAA0D;IAC1D,8EAA8E;IAC9E,MAAM,CAAC,GAAG,CAAC,EAAE,KAA2C,CAAC;IACzD,IAAI,CAAC,EAAE,CAAC;QACN,OAAO;YACL,GAAG,EAAG,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,YAAY,IAAI,IAAI;YAC/C,IAAI,EAAE,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,aAAa,IAAI,IAAI;SACrD,CAAC;IACJ,CAAC;IACD,kEAAkE;IAClE,8EAA8E;IAC9E,MAAM,EAAE,GAAG,CAAC,EAAE,aAAmD,CAAC;IAClE,IAAI,EAAE,EAAE,CAAC;QACP,OAAO;YACL,GAAG,EAAG,EAAE,CAAC,gBAAgB,IAAI,IAAI;YACjC,IAAI,EAAE,EAAE,CAAC,oBAAoB,IAAI,IAAI;SACtC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,yEAAyE;AACzE,0EAA0E;AAC1E,8EAA8E;AAC9E,2EAA2E;AAC3E,2EAA2E;AAC3E,0EAA0E;AAC1E,gDAAgD;AAChD,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,yEAAyE;AACzE,oEAAoE;AACpE,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,CAAC,GAAG,MAAiC,CAAC;IAC5C,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAC3D,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE;YAClD,CAAC,CAAC,CAAC,CAAC,KAAK;YACT,CAAC,CAAC,4BAA4B,CAAC,CAAC,KAAK,GAAG,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,uDAAuD;AACvD,8EAA8E;AAC9E,oEAAoE;AACpE,MAAM,UAAU,sBAAsB,CAAC,MAAe;IACpD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,CAAC,GAAG,MAA2D,CAAC;IACtE,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC;IAChC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACtE,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/planner-prompt.d.ts

@@ -0,0 +1,12 @@
+import type { SlotId } from "./storyboard-validate.js";
+export interface PlannerCharacter {
+    slot: SlotId;
+    name: string;
+    bible: string;
+}
+export declare function buildPlanningSystemPrompt(): string;
+export declare function buildPlanningUserMessage(brief: string, characters: PlannerCharacter[], beatBlock?: string): string;
+export declare function buildRefinementSystemPrompt(): string;
+export declare function buildRefinementUserMessage(currentStoryboard: unknown, message: string): string;
+export declare function stripJsonFences(raw: string): string;
+//# sourceMappingURL=planner-prompt.d.ts.map

package/dist/planner-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-prompt.d.ts","sourceRoot":"","sources":["../src/planner-prompt.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAYvD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,wBAAgB,yBAAyB,IAAI,MAAM,CA6JlD;AAMD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,gBAAgB,EAAE,EAC9B,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAsBR;AAaD,wBAAgB,2BAA2B,IAAI,MAAM,CA+FpD;AAED,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,MAAM,GACd,MAAM,CAUR;AASD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAanD"}

package/dist/planner-prompt.js

@@ -0,0 +1,337 @@
+// Pure string helpers for the storyboard planner (v0.28.0).
+//
+// Holds the system + user prompt builders and the JSON fence stripper.
+// Extracted from planner.ts so the prompt text and the output cleanup are
+// unit-testable without dragging Env, fetch, or env.AI into the test
+// (same pattern as parsers/, longrun-params.ts, output-extract.ts).
+import { DIALOGUE_MAX_CHARS, FULL_PROMPT_MAX_CHARS, SCENE_PROMPT_MAX_WORDS, STORYBOARD_MAX_SCENES, STYLE_PREFIX_MAX_CHARS, } from "./storyboard-validate.js";
+// System prompt sent to the model. Constrains output to a JSON object
+// matching StoryboardInput. Declares the slot id enum, the style_prefix
+// once-only rule (style_prefix is prepended to every scene at manifest-
+// build time, so repeating style words inside a scene prompt double-
+// applies them), and the literal-"None" convention for style_category /
+// style_preset (the renderer disables on the string, not on null).
+export function buildPlanningSystemPrompt() {
+    return `You are the storyboard planner for a music-video / short-film AI pipeline.
+Your output is consumed directly by a renderer that turns each scene into
+a Wan I2V clip with an SDXL keyframe. Return ONE JSON object that exactly
+matches the schema below. No prose. No markdown. No YAML. Do not wrap the
+JSON in code fences.
+
+SCHEMA:
+{
+  "title": string,
+  "full_prompt": string,
+  "duration_seconds": number,
+  "clip_seconds": number,
+  "style_prefix": string,
+  "style_category": string,
+  "style_preset": string,
+  "use_characters": ["A" | "B" | "C" | "D", ...],
+  "cast_rules": string,
+  "scenes": [
+    {
+      "prompt": string,
+      "character_slots": ["A" | "B" | "C" | "D", ...],
+      "act": string,
+      "start": number,
+      "end": number,
+      "target_seconds": number,
+      "dialogue": { "slot": "A" | "B" | "C" | "D", "text": string }
+    },
+    ...
+  ]
+}
+
+FIELDS:
+- title: short film title; spaces become underscores in the on-disk slug.
+- full_prompt: one or two sentence film-level summary (optional).
+- duration_seconds: total film length target in seconds (positive number).
+- clip_seconds: per-shot target length in seconds (positive number).
+- style_prefix: ALL style language goes here, EXACTLY ONCE. Palette, lens,
+  era, lighting register, film stock, color grade, key visual vocabulary.
+  The renderer prepends this string verbatim to every scene prompt at
+  manifest-build time, so any style word repeated inside a scene prompt
+  is double-applied and biases the keyframe.
+- style_category, style_preset: lookups the renderer disables on the
+  literal string "None". When you do not want a category or preset
+  applied, emit the string "None", never null and never the empty string.
+- use_characters: slot ids loaded for this render. Slot ids are exactly
+  the literal strings "A", "B", "C", "D". Nothing else is valid. Set this
+  to the slots you plan to feature; omit slots that will not appear.
+- cast_rules: optional plain-text rules for cast cohesion (pairings,
+  outfit constraints, prop continuity).
+- scenes: REQUIRED, at least one entry, one per shot.
+- scenes[].prompt: SHOT CONTENT ONLY. Subject action, framing, moment,
+  emotional beat. Do NOT include style language; that lives in
+  style_prefix above. Do NOT repeat the film title or full_prompt.
+- scenes[].character_slots: subset of use_characters. Omit the field
+  entirely for an empty-frame shot rather than send an unloaded slot.
+- scenes[].act: optional act tag, one of "opening", "rising", "turn",
+  "climax", "resolution".
+- scenes[].start, end, target_seconds: optional per-shot timing in
+  seconds. start may be 0; end must be strictly greater than start;
+  target_seconds must be positive.
+- scenes[].dialogue: OPTIONAL spoken line for the shot (auto-direction).
+  Include it ONLY when a character actually speaks on camera in that shot.
+  "slot" is the speaking character and MUST be one of that scene's
+  character_slots. "text" is the line itself: natural spoken words only,
+  no quotation marks, no "Name:" speaker prefix, no stage directions. Keep
+  it short enough to be said within the shot's length (roughly 2-3 spoken
+  words per second). Omit the field entirely for a silent shot.
+
+HARD RULES:
+1. style_prefix is the ONLY place style language belongs. Repeating style
+   words inside scenes[].prompt double-applies them because style_prefix
+   is prepended to every scene at manifest-build time.
+2. Every entry in a scene's character_slots must appear in the top-level
+   use_characters array. Never lock a scene to a slot you have not loaded.
+3. Slot ids are exactly "A", "B", "C", "D". No lowercase, no other letters.
+4. style_category and style_preset default to the literal string "None"
+   when you do not want a lookup. Never null. Never empty string.
+5. Numeric fields are plain JSON numbers, never strings. No units ("s",
+   "sec", "min"); seconds is implicit.
+6. Plan 3 to 12 scenes for a vignette / single-track music video unless
+   the brief specifies otherwise.
+6a. A scene's dialogue.slot MUST be one of that scene's character_slots
+    (the speaker has to be in the shot). Only one character speaks per
+    shot. Most shots have no dialogue; reserve it for genuine spoken beats.
+
+LENGTH CAPS (the renderer rejects outputs over these caps because they
+overflow SDXL's CLIP 77-token text encoder or break manifest builds):
+7. Each scenes[].prompt: at most ${SCENE_PROMPT_MAX_WORDS} words. The pod
+   prepends 2-4 LoRA trigger tokens plus the style_prefix to every scene,
+   leaving roughly ${SCENE_PROMPT_MAX_WORDS}-word headroom inside CLIP 77.
+   Move character appearance details to the cast bible (already loaded),
+   not into the scene prompt.
+8. style_prefix: at most ${STYLE_PREFIX_MAX_CHARS} characters. Compress.
+   Three or four palette / lens / lighting clauses is plenty; the model
+   reads ALL of it once per scene, so verbosity here costs every shot.
+9. full_prompt: at most ${FULL_PROMPT_MAX_CHARS} characters. This is the
+   film-level summary, not the script; one or two sentences.
+10. scenes array length: at most ${STORYBOARD_MAX_SCENES} entries. A 50-
+    shot render is already 25+ minutes of GPU time at typical clip
+    seconds; if the brief implies more, shorten clip_seconds or split.
+11. scenes[].dialogue.text: at most ${DIALOGUE_MAX_CHARS} characters. One
+    spoken line per shot; a clip is only a few seconds, so a sentence or
+    two is the ceiling, not a speech.
+
+GOLDEN EXAMPLE (mirrors the renderer's storyboard.example.yaml). This
+shape is the canonical output; produce JSON that matches its style:
+
+{
+  "title": "morning_walk",
+  "full_prompt": "Three-shot vignette: Elena walks into a hilltop clearing at dawn.",
+  "duration_seconds": 21,
+  "clip_seconds": 7,
+  "style_prefix": "cinematic 35mm film, soft golden hour light, shallow depth of field",
+  "style_category": "None",
+  "style_preset": "None",
+  "use_characters": ["A"],
+  "cast_rules": "",
+  "scenes": [
+    {
+      "prompt": "Wide establishing shot of a quiet hilltop at dawn, mist over the valley below.",
+      "act": "opening"
+    },
+    {
+      "prompt": "Elena walks into frame from the left, looks out over the valley, wind in her coat.",
+      "character_slots": ["A"],
+      "act": "rising"
+    },
+    {
+      "prompt": "Close-up on Elena's face, soft side light, expression of quiet resolve, eyes catching the last warm light.",
+      "character_slots": ["A"],
+      "act": "turn"
+    }
+  ]
+}
+
+What that example demonstrates concretely:
+- Each scene's prompt is ~15-25 words: subject + action + framing +
+  one beat of mood. Well inside the ${SCENE_PROMPT_MAX_WORDS}-word cap.
+- The cast member is referenced by NAME ("Elena"), not by slot id.
+  The slot id only appears in scenes[].character_slots, never in prose.
+- Scene 1 omits character_slots entirely because nothing in the prompt
+  references a character. Do NOT send character_slots:[] either; omit
+  the field. (The example.yaml puts ["A"] on every shot; both forms
+  are accepted, but omitting is clearer for empty-frame shots.)
+- No appearance details in any scene prompt (no "red hair, green coat",
+  no "weathered older man"). The cast bible carries those; the renderer
+  prepends a LoRA trigger that injects the appearance vector for you.
+- No style language in any scene prompt: "cinematic", "35mm",
+  "golden hour" all live in style_prefix and are prepended once per
+  shot. Repeating them inside a scene double-applies them.
+- style_category and style_preset are literal "None" strings (never
+  null, never empty) because the renderer disables on the string.
+- act values are lowercase: "opening", "rising", "turn", "climax",
+  "resolution". Each scene optionally tagged.
+
+Return ONLY the JSON object. Nothing before it. Nothing after it.`;
+}
+// User-side message that carries the brief plus the cast bible. The model
+// uses the cast to populate use_characters and per-scene character_slots.
+// Characters are sorted by slot id so the same input always renders the
+// same prompt, which keeps planner cache hits stable.
+export function buildPlanningUserMessage(brief, characters, beatBlock) {
+    const sorted = [...characters].sort((a, b) => a.slot.localeCompare(b.slot));
+    const castLines = sorted.length === 0
+        ? ["(none)"]
+        : sorted.map((c) => `${c.slot}) ${c.name}: ${c.bible}`);
+    const parts = [
+        "BRIEF:",
+        brief.trim(),
+        "",
+        "CAST LOADED FOR THIS RENDER:",
+        ...castLines,
+        "",
+    ];
+    // Beat-synced timing block (built by beat-timing.buildBeatTimingBlock when
+    // the request carried an audio beat plan). It pins the shot count, so it
+    // goes BEFORE the final instruction the model acts on.
+    if (beatBlock && beatBlock.trim().length > 0) {
+        parts.push(beatBlock.trim(), "");
+    }
+    parts.push("Plan the storyboard and return the JSON now.");
+    return parts.join("\n");
+}
+// ---------- Refinement chat (v0.50.0) ----------
+//
+// The plan route is single-shot: brief in, storyboard out. /api/storyboard/refine
+// is the iterative path: take the current storyboard plus a free-form user
+// message ("make scene 2 darker", "add a fight before the ending", etc.) and
+// return a new storyboard with the change applied. Each request is stateless
+// from the model's perspective: the current storyboard is the entire state,
+// and the user message is the delta to apply. The frontend keeps a chat
+// history for display but does not replay it to the model; the assumption is
+// that the storyboard already reflects all prior accepted changes.
+export function buildRefinementSystemPrompt() {
+    return `You are refining an existing storyboard for a music-video / short-film AI
+pipeline. The user will request specific changes (add a scene, rewrite a
+prompt, shorten a shot, swap which character appears, etc.). Apply EXACTLY
+the requested change and PRESERVE everything else unchanged. Return ONE
+JSON object matching the same schema the planner uses:
+
+{
+  "title": string,
+  "full_prompt": string,
+  "duration_seconds": number,
+  "clip_seconds": number,
+  "style_prefix": string,
+  "style_category": string,
+  "style_preset": string,
+  "use_characters": ["A" | "B" | "C" | "D", ...],
+  "cast_rules": string,
+  "scenes": [
+    {
+      "prompt": string,
+      "character_slots": ["A" | "B" | "C" | "D", ...],
+      "act": string,
+      "start": number,
+      "end": number,
+      "target_seconds": number,
+      "dialogue": { "slot": "A" | "B" | "C" | "D", "text": string }
+    },
+    ...
+  ]
+}
+
+REFINEMENT RULES:
+- If the user is silent about a field, KEEP THE OLD VALUE BIT-FOR-BIT.
+  Do not paraphrase prompts the user did not ask you to touch. Do not
+  re-tune target_seconds the user did not mention. Stability matters.
+- If the user asks for a new scene, place it at the position they request
+  ("before the ending", "after scene 2", "first"); when ambiguous, append.
+- If the user asks to delete a scene, remove the entry; preserve the order
+  of the remaining scenes.
+- character_slots on each scene must be a subset of use_characters. If
+  the user adds a new character or removes one, also update use_characters.
+- dialogue: KEEP each scene's existing dialogue bit-for-bit unless the user
+  asks to change it. When you do edit or add a line, dialogue.slot must be
+  one of that scene's character_slots, "text" is plain spoken words (no
+  quotes, no speaker prefix), and at most ${DIALOGUE_MAX_CHARS} characters.
+- style_prefix carries ALL style language. Do not add style words to
+  individual scene prompts; the renderer prepends style_prefix to every
+  scene at manifest-build time, so style words inside a scene double-apply.
+- style_category and style_preset are "None" literal strings unless the
+  user explicitly names a category / preset. Never null. Never empty.
+
+LENGTH CAPS (same caps as the planner; the renderer rejects outputs
+over these because they overflow SDXL's CLIP 77-token text encoder):
+- Each scenes[].prompt: at most ${SCENE_PROMPT_MAX_WORDS} words. If the
+  user asks you to add detail to a scene, tighten the existing wording
+  rather than letting the word count drift past the cap.
+- style_prefix: at most ${STYLE_PREFIX_MAX_CHARS} characters. If the user
+  asks to expand the style, compress earlier clauses to make room.
+- full_prompt: at most ${FULL_PROMPT_MAX_CHARS} characters.
+- scenes array length: at most ${STORYBOARD_MAX_SCENES} entries. If the
+  user asks for more shots than the cap allows, add as many as fit
+  under the cap and keep the remaining requested scenes for a future
+  refinement turn; never let the array exceed the cap.
+
+CANONICAL SHAPE (any new or edited scene must match this style;
+mirrors the renderer's storyboard.example.yaml):
+
+{
+  "scenes": [
+    {
+      "prompt": "Wide establishing shot of a quiet hilltop at dawn, mist over the valley below.",
+      "act": "opening"
+    },
+    {
+      "prompt": "Elena walks into frame from the left, looks out over the valley, wind in her coat.",
+      "character_slots": ["A"],
+      "act": "rising"
+    },
+    {
+      "prompt": "Close-up on Elena's face, soft side light, expression of quiet resolve, eyes catching the last warm light.",
+      "character_slots": ["A"],
+      "act": "turn"
+    }
+  ]
+}
+
+What that example demonstrates:
+- Each prompt is ~15-25 words; subject + action + framing + one beat
+  of mood. No style language, no appearance descriptors.
+- Cast referenced by NAME in prose; slot id only in character_slots.
+- character_slots omitted entirely for empty-frame shots (don't send
+  an empty array).
+- act tags lowercase: opening / rising / turn / climax / resolution.
+
+Return ONLY the JSON object. No prose, no markdown, no fences.`;
+}
+export function buildRefinementUserMessage(currentStoryboard, message) {
+    return [
+        "CURRENT STORYBOARD:",
+        JSON.stringify(currentStoryboard, null, 2),
+        "",
+        "USER REQUEST:",
+        message.trim(),
+        "",
+        "Return the updated storyboard JSON now.",
+    ].join("\n");
+}
+// Pulls a JSON object out of a model completion. Handles:
+//   - bare JSON;
+//   - one or more ```json (or bare ```) code fences (prefers the LAST fence,
+//     because models often give an example block before the final answer);
+//   - prose before or after the JSON / fence.
+// Returns the input unchanged when no JSON-looking content is found, so
+// JSON.parse downstream surfaces a clear error.
+export function stripJsonFences(raw) {
+    let s = raw.trim();
+    const fences = [...s.matchAll(/```(?:json)?\s*([\s\S]*?)```/g)];
+    if (fences.length > 0) {
+        s = fences[fences.length - 1][1];
+    }
+    else {
+        const firstBrace = s.indexOf("{");
+        const lastBrace = s.lastIndexOf("}");
+        if (firstBrace !== -1 && lastBrace !== -1 && lastBrace > firstBrace) {
+            s = s.slice(firstBrace, lastBrace + 1);
+        }
+    }
+    return s.trim();
+}
+//# sourceMappingURL=planner-prompt.js.map

package/dist/planner-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-prompt.js","sourceRoot":"","sources":["../src/planner-prompt.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,uEAAuE;AACvE,0EAA0E;AAC1E,qEAAqE;AACrE,oEAAoE;AAGpE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAWlC,sEAAsE;AACtE,wEAAwE;AACxE,wEAAwE;AACxE,qEAAqE;AACrE,wEAAwE;AACxE,mEAAmE;AACnE,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAuF0B,sBAAsB;;qBAEpC,sBAAsB;;;2BAGhB,sBAAsB;;;0BAGvB,qBAAqB;;mCAEZ,qBAAqB;;;sCAGlB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCAqClB,sBAAsB;;;;;;;;;;;;;;;;;;kEAkBM,CAAC;AACnE,CAAC;AAED,0EAA0E;AAC1E,0EAA0E;AAC1E,wEAAwE;AACxE,sDAAsD;AACtD,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,UAA8B,EAC9B,SAAkB;IAElB,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,MAAM,SAAS,GACb,MAAM,CAAC,MAAM,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC,QAAQ,CAAC;QACZ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG;QACZ,QAAQ;QACR,KAAK,CAAC,IAAI,EAAE;QACZ,EAAE;QACF,8BAA8B;QAC9B,GAAG,SAAS;QACZ,EAAE;KACH,CAAC;IACF,2EAA2E;IAC3E,yEAAyE;IACzE,uDAAuD;IACvD,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,kDAAkD;AAClD,EAAE;AACF,kFAAkF;AAClF,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,wEAAwE;AACxE,6EAA6E;AAC7E,mEAAmE;AAEnE,MAAM,UAAU,2BAA2B;IACzC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CA2CmC,kBAAkB;;;;;;;;;kCAS5B,sBAAsB;;;0BAG9B,sBAAsB;;yBAEvB,qBAAqB;iCACb,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAmCS,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,iBAA0B,EAC1B,OAAe;IAEf,OAAO;QACL,qBAAqB;QACrB,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,EAAE;QACF,eAAe;QACf,OAAO,CAAC,IAAI,EAAE;QACd,EAAE;QACF,yCAAyC;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,0DAA0D;AAC1D,iBAAiB;AACjB,6EAA6E;AAC7E,2EAA2E;AAC3E,8CAA8C;AAC9C,wEAAwE;AACxE,gDAAgD;AAChD,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,UAAU,KAAK,CAAC,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,SAAS,GAAG,UAAU,EAAE,CAAC;YACpE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAClB,CAAC"}

package/dist/planner-yaml.d.ts

@@ -0,0 +1,15 @@
+import type { StoryboardValidated } from "./storyboard-validate.js";
+export { parseShotDurations } from "./shot-durations-parse.js";
+export interface ParsedBundleScene {
+    shot_id: string;
+    prompt: string;
+    seconds: number;
+    dialogue?: {
+        slot: string;
+        text: string;
+    };
+}
+/** Extract { shot_id, prompt, seconds } from an emitted storyboard.yaml. */
+export declare function parseStoryboardScenes(yaml: string, defaultSeconds?: number): ParsedBundleScene[];
+export declare function serializeStoryboardYaml(value: StoryboardValidated): string;
+//# sourceMappingURL=planner-yaml.d.ts.map

package/dist/planner-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-yaml.d.ts","sourceRoot":"","sources":["../src/planner-yaml.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAoD/D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAIhB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,iBAAiB,EAAE,CA4D3F;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CA4B1E"}