@sogni-ai/sogni-intelligence-client 2.1.0

package/dist/runtime/durableWorkflowClient.js

@@ -0,0 +1,312 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DURABLE_CREATIVE_WORKFLOW_ENDPOINT = void 0;
+exports.getDurableCreativeWorkflowUrl = getDurableCreativeWorkflowUrl;
+exports.getDurableCreativeWorkflowEventsUrl = getDurableCreativeWorkflowEventsUrl;
+exports.buildDurableCreativeWorkflowPreview = buildDurableCreativeWorkflowPreview;
+exports.buildStartDurableCreativeWorkflowRequest = buildStartDurableCreativeWorkflowRequest;
+exports.startDurableCreativeWorkflow = startDurableCreativeWorkflow;
+exports.getDurableCreativeWorkflow = getDurableCreativeWorkflow;
+exports.listDurableCreativeWorkflows = listDurableCreativeWorkflows;
+exports.getDurableCreativeWorkflowEvents = getDurableCreativeWorkflowEvents;
+exports.parseSseChunk = parseSseChunk;
+exports.streamDurableCreativeWorkflowEvents = streamDurableCreativeWorkflowEvents;
+exports.getDurableCreativeWorkflowCancelUrl = getDurableCreativeWorkflowCancelUrl;
+exports.getDurableCreativeWorkflowResumeUrl = getDurableCreativeWorkflowResumeUrl;
+exports.cancelDurableCreativeWorkflow = cancelDurableCreativeWorkflow;
+exports.resumeDurableCreativeWorkflow = resumeDurableCreativeWorkflow;
+const backboneDurableWorkflow_js_1 = require("../contracts/backboneDurableWorkflow.js");
+exports.DURABLE_CREATIVE_WORKFLOW_ENDPOINT = '/v1/creative-agent/workflows';
+function appendPath(baseUrl, path) {
+    const cleanBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+    const cleanPath = path.startsWith('/') ? path : `/${path}`;
+    return `${cleanBase}${cleanPath}`;
+}
+function getDurableCreativeWorkflowUrl(workflowId, apiBaseUrl) {
+    const path = workflowId
+        ? `${exports.DURABLE_CREATIVE_WORKFLOW_ENDPOINT}/${encodeURIComponent(workflowId)}`
+        : exports.DURABLE_CREATIVE_WORKFLOW_ENDPOINT;
+    return appendPath(apiBaseUrl, path);
+}
+function getDurableCreativeWorkflowEventsUrl(workflowId, apiBaseUrl) {
+    return `${getDurableCreativeWorkflowUrl(workflowId, apiBaseUrl)}/events`;
+}
+function buildDurableCreativeWorkflowPreview(input, options = {}) {
+    return (0, backboneDurableWorkflow_js_1.buildBackboneDurableWorkflowRun)(input, {
+        workflowId: options.workflowId ?? 'wf_durable_workflow_preview',
+        ...(options.now ? { now: options.now } : {}),
+        ...(options.title ? { title: options.title } : {}),
+    });
+}
+function buildStartDurableCreativeWorkflowRequest(input, options = {}) {
+    const { mediaReferences, ...requestInput } = input;
+    return {
+        input: requestInput,
+        ...(options.tokenType ? { token_type: options.tokenType } : {}),
+        ...(options.appSource ? { app_source: options.appSource } : {}),
+        ...(mediaReferences !== undefined ? { media_references: mediaReferences } : {}),
+        ...(options.maxEstimatedCapacityUnits !== undefined
+            ? { max_estimated_capacity_units: options.maxEstimatedCapacityUnits }
+            : {}),
+        ...(options.confirmCost !== undefined ? { confirm_cost: options.confirmCost } : {}),
+    };
+}
+function getFetch(options) {
+    return options.fetchImpl ?? fetch;
+}
+function buildHeaders(apiKey) {
+    return {
+        'Content-Type': 'application/json',
+        ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),
+    };
+}
+function buildRequestHeaders(options) {
+    return {
+        ...buildHeaders(options.apiKey),
+        ...(options.idempotencyKey ? { 'Idempotency-Key': options.idempotencyKey } : {}),
+    };
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+async function readJsonEnvelope(response) {
+    const text = await response.text();
+    let body = {};
+    if (text) {
+        try {
+            const parsed = JSON.parse(text);
+            if (isPlainObject(parsed)) {
+                body = parsed;
+            }
+        }
+        catch {
+        }
+    }
+    if (!response.ok) {
+        const detail = typeof body.message === 'string'
+            ? body.message
+            : typeof body.error === 'string'
+                ? body.error
+                : response.statusText;
+        throw new Error(`Creative workflow API request failed (${response.status}): ${detail}`);
+    }
+    if (!('data' in body)) {
+        throw new Error('Creative workflow API response did not include a data envelope');
+    }
+    return body;
+}
+function requireRecord(value, path) {
+    if (!isPlainObject(value)) {
+        throw new Error(`Creative workflow API response missing ${path}`);
+    }
+    return value;
+}
+function requireArray(value, path) {
+    if (!Array.isArray(value)) {
+        throw new Error(`Creative workflow API response missing ${path}`);
+    }
+    return value;
+}
+async function startDurableCreativeWorkflow(input, options) {
+    if (!options.apiKey) {
+        throw new Error('Durable creative workflow execution requires an API key');
+    }
+    const response = await getFetch(options)(getDurableCreativeWorkflowUrl(undefined, options.apiBaseUrl), {
+        method: 'POST',
+        credentials: options.credentials ?? 'include',
+        signal: options.signal,
+        headers: buildRequestHeaders(options),
+        body: JSON.stringify(buildStartDurableCreativeWorkflowRequest(input, {
+            tokenType: options.tokenType,
+            appSource: options.appSource,
+            maxEstimatedCapacityUnits: options.maxEstimatedCapacityUnits,
+            confirmCost: options.confirmCost,
+        })),
+    });
+    const envelope = await readJsonEnvelope(response);
+    const data = requireRecord(envelope.data, 'data');
+    return requireRecord(data.workflow, 'data.workflow');
+}
+async function getDurableCreativeWorkflow(workflowId, options) {
+    const response = await getFetch(options)(getDurableCreativeWorkflowUrl(workflowId, options.apiBaseUrl), {
+        method: 'GET',
+        credentials: options.credentials ?? 'include',
+        signal: options.signal,
+        headers: buildHeaders(options.apiKey),
+    });
+    const envelope = await readJsonEnvelope(response);
+    const data = requireRecord(envelope.data, 'data');
+    return requireRecord(data.workflow, 'data.workflow');
+}
+async function listDurableCreativeWorkflows(options) {
+    const params = new URLSearchParams();
+    if (options.limit !== undefined)
+        params.set('limit', String(options.limit));
+    if (options.offset !== undefined)
+        params.set('offset', String(options.offset));
+    const query = params.toString();
+    const url = `${getDurableCreativeWorkflowUrl(undefined, options.apiBaseUrl)}${query ? `?${query}` : ''}`;
+    const response = await getFetch(options)(url, {
+        method: 'GET',
+        credentials: options.credentials ?? 'include',
+        signal: options.signal,
+        headers: buildHeaders(options.apiKey),
+    });
+    const envelope = await readJsonEnvelope(response);
+    const data = requireRecord(envelope.data, 'data');
+    const workflows = requireArray(data.workflows, 'data.workflows');
+    const nextRaw = data.next;
+    const next = nextRaw === null || typeof nextRaw === 'number' ? nextRaw : null;
+    return { workflows, next };
+}
+async function getDurableCreativeWorkflowEvents(workflowId, options) {
+    const response = await getFetch(options)(getDurableCreativeWorkflowEventsUrl(workflowId, options.apiBaseUrl), {
+        method: 'GET',
+        credentials: options.credentials ?? 'include',
+        signal: options.signal,
+        headers: buildHeaders(options.apiKey),
+    });
+    const envelope = await readJsonEnvelope(response);
+    const data = requireRecord(envelope.data, 'data');
+    return requireArray(data.events, 'data.events');
+}
+function parseSseChunk(chunk) {
+    let id;
+    let event = 'message';
+    const dataLines = [];
+    let hasNonComment = false;
+    for (const rawLine of chunk.split('\n')) {
+        const line = rawLine.endsWith('\r') ? rawLine.slice(0, -1) : rawLine;
+        if (line === '')
+            continue;
+        if (line.startsWith(':'))
+            continue;
+        hasNonComment = true;
+        const colon = line.indexOf(':');
+        const field = colon === -1 ? line : line.slice(0, colon);
+        let value = colon === -1 ? '' : line.slice(colon + 1);
+        if (value.startsWith(' '))
+            value = value.slice(1);
+        if (field === 'id')
+            id = value;
+        else if (field === 'event')
+            event = value;
+        else if (field === 'data')
+            dataLines.push(value);
+    }
+    if (!hasNonComment || dataLines.length === 0)
+        return null;
+    const rawData = dataLines.join('\n');
+    let data = rawData;
+    try {
+        data = JSON.parse(rawData);
+    }
+    catch {
+    }
+    return id !== undefined ? { id, event, data } : { event, data };
+}
+async function* streamDurableCreativeWorkflowEvents(workflowId, options) {
+    const url = getDurableCreativeWorkflowEventsUrl(workflowId, options.apiBaseUrl) + '/stream'
+        + (options.lastEventId !== undefined ? `?after=${encodeURIComponent(String(options.lastEventId))}` : '');
+    const headers = {
+        Accept: 'text/event-stream',
+        ...(options.apiKey ? { Authorization: `Bearer ${options.apiKey}` } : {}),
+        ...(options.lastEventId !== undefined ? { 'Last-Event-ID': String(options.lastEventId) } : {}),
+    };
+    const response = await getFetch(options)(url, {
+        method: 'GET',
+        credentials: options.credentials ?? 'include',
+        signal: options.signal,
+        headers,
+    });
+    if (!response.ok) {
+        throw new Error(`Creative workflow stream failed (${response.status}): ${response.statusText}`);
+    }
+    if (!response.body) {
+        throw new Error('Creative workflow stream returned no response body');
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let boundary = findFrameBoundary(buffer);
+            while (boundary !== -1) {
+                const chunk = buffer.slice(0, boundary.index);
+                buffer = buffer.slice(boundary.index + boundary.length);
+                const frame = parseSseChunk(chunk);
+                if (frame)
+                    yield frame;
+                boundary = findFrameBoundary(buffer);
+            }
+        }
+        if (buffer.length > 0) {
+            const frame = parseSseChunk(buffer);
+            if (frame)
+                yield frame;
+        }
+    }
+    finally {
+        try {
+            reader.releaseLock();
+        }
+        catch { }
+    }
+}
+function findFrameBoundary(buffer) {
+    const lf = buffer.indexOf('\n\n');
+    const crlf = buffer.indexOf('\r\n\r\n');
+    if (lf === -1 && crlf === -1)
+        return -1;
+    if (lf !== -1 && (crlf === -1 || lf < crlf))
+        return { index: lf, length: 2 };
+    return { index: crlf, length: 4 };
+}
+function getDurableCreativeWorkflowCancelUrl(workflowId, apiBaseUrl) {
+    return `${getDurableCreativeWorkflowUrl(workflowId, apiBaseUrl)}/cancel`;
+}
+function getDurableCreativeWorkflowResumeUrl(workflowId, apiBaseUrl) {
+    return `${getDurableCreativeWorkflowUrl(workflowId, apiBaseUrl)}/resume`;
+}
+async function cancelDurableCreativeWorkflow(workflowId, options) {
+    if (!options.apiKey) {
+        throw new Error('Durable creative workflow cancellation requires an API key');
+    }
+    const response = await getFetch(options)(getDurableCreativeWorkflowCancelUrl(workflowId, options.apiBaseUrl), {
+        method: 'POST',
+        credentials: options.credentials ?? 'include',
+        signal: options.signal,
+        headers: buildHeaders(options.apiKey),
+    });
+    const envelope = await readJsonEnvelope(response);
+    const data = requireRecord(envelope.data, 'data');
+    const workflow = requireRecord(data.workflow, 'data.workflow');
+    const transitioned = typeof data.transitioned === 'boolean' ? data.transitioned : false;
+    return { workflow, transitioned };
+}
+async function resumeDurableCreativeWorkflow(workflowId, options) {
+    if (!options.apiKey) {
+        throw new Error('Durable creative workflow resume requires an API key');
+    }
+    const body = {
+        ...(options.tokenType ? { token_type: options.tokenType } : {}),
+        ...(options.appSource ? { app_source: options.appSource } : {}),
+    };
+    const response = await getFetch(options)(getDurableCreativeWorkflowResumeUrl(workflowId, options.apiBaseUrl), {
+        method: 'POST',
+        credentials: options.credentials ?? 'include',
+        signal: options.signal,
+        headers: buildHeaders(options.apiKey),
+        ...(Object.keys(body).length > 0 ? { body: JSON.stringify(body) } : {}),
+    });
+    const envelope = await readJsonEnvelope(response);
+    const data = requireRecord(envelope.data, 'data');
+    const workflow = requireRecord(data.workflow, 'data.workflow');
+    const resumed = typeof data.resumed === 'boolean' ? data.resumed : false;
+    return { workflow, resumed };
+}
+//# sourceMappingURL=durableWorkflowClient.js.map

package/dist/runtime/durableWorkflowClient.js.map

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

package/dist/runtime/index.d.ts

@@ -0,0 +1,3 @@
+export type { ChatContent, ChatContentPart, ChatImageContentPart, ChatMessage, ChatRole, ChatTextContentPart, ChatToolCall, SogniChatContent, SogniChatContentPart, SogniChatMessage, SogniChatToolCall, } from './chatTypes.js';
+export * from './durableWorkflowClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,cAAc,4BAA4B,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./durableWorkflowClient.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAaA,6DAA2C"}

package/dist/schemas/errors/error.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.sogni.ai/creative-agent/2026-04-27.1/errors/error.schema.json",
+  "title": "Creative agent error",
+  "schemaVersion": "2026-04-27.1",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "code": { "type": "string" },
+    "message": { "type": "string" },
+    "classification": {
+      "type": "string",
+      "enum": ["validation", "auth", "billing", "rate_limit", "transient", "provider", "policy", "cancelled", "unknown"]
+    },
+    "retryable": { "type": "boolean" },
+    "toolName": { "type": "string" },
+    "stepId": { "type": "string" },
+    "details": { "type": "object", "additionalProperties": true }
+  },
+  "required": ["code", "message", "classification", "retryable"]
+}

package/dist/schemas/errors/repair-control.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.sogni.ai/creative-agent/2026-04-27.1/errors/repair-control.schema.json",
+  "title": "Creative agent repair control payload",
+  "schemaVersion": "2026-04-27.1",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "error": { "type": "string" },
+    "message": { "type": "string" },
+    "controlAction": {
+      "type": "string",
+      "enum": ["execute_tool", "wait_for_user", "finish_response", "none"]
+    },
+    "retryPolicy": {
+      "type": "string",
+      "enum": [
+        "auto_tool_call",
+        "auto",
+        "auto_repair",
+        "llm_repair",
+        "manual_ui_only",
+        "manual_user_confirmation",
+        "none",
+        "no_retry",
+        "terminal"
+      ]
+    },
+    "requiredTool": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]{1,40}$"
+    },
+    "suggestedArgs": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "nextAction": { "type": "string" }
+  },
+  "required": ["controlAction"]
+}

package/dist/schemas/events/artifact-reference.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.sogni.ai/creative-agent/2026-04-27.1/events/artifact-reference.schema.json",
+  "title": "Creative agent artifact reference",
+  "schemaVersion": "2026-04-27.1",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string" },
+    "kind": { "type": "string", "enum": ["image", "video", "audio", "archive", "json", "text", "other"] },
+    "url": { "type": "string" },
+    "mimeType": { "type": "string" },
+    "width": { "type": "number" },
+    "height": { "type": "number" },
+    "durationSeconds": { "type": "number" },
+    "sizeBytes": { "type": "number" },
+    "toolName": { "type": "string" },
+    "stepId": { "type": "string" },
+    "metadata": { "type": "object", "additionalProperties": true }
+  },
+  "required": ["id", "kind", "url"]
+}

package/dist/schemas/events/progress-event.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.sogni.ai/creative-agent/2026-04-27.1/events/progress-event.schema.json",
+  "title": "Creative agent progress event",
+  "schemaVersion": "2026-04-27.1",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string" },
+    "workflowId": { "type": "string" },
+    "stepId": { "type": "string" },
+    "sequence": { "type": "integer", "minimum": 0 },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "type": {
+      "type": "string",
+      "enum": ["started", "progress", "completed", "error", "artifact", "tool_call", "llm_request", "cancelled", "custom"]
+    },
+    "toolName": { "type": "string" },
+    "progress": { "type": "number", "minimum": 0, "maximum": 1 },
+    "message": { "type": "string" },
+    "artifacts": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "data": { "type": "object", "additionalProperties": true }
+  },
+  "required": ["id", "workflowId", "sequence", "timestamp", "type"]
+}

package/dist/schemas/events/workflow-event.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.sogni.ai/creative-agent/2026-04-27.1/events/workflow-event.schema.json",
+  "title": "Creative agent workflow event",
+  "schemaVersion": "2026-04-27.1",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string" },
+    "workflowId": { "type": "string" },
+    "sequence": { "type": "integer", "minimum": 0 },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "type": {
+      "type": "string",
+      "enum": ["workflow_started", "workflow_progress", "workflow_completed", "workflow_failed", "workflow_cancelled", "workflow_waiting_for_user", "step_started", "step_completed", "step_failed", "step_waiting_for_user", "artifact_created", "custom"]
+    },
+    "status": { "type": "string", "enum": ["queued", "running", "completed", "partial_failure", "waiting_for_user", "failed", "cancelled"] },
+    "message": { "type": "string" },
+    "data": { "type": "object", "additionalProperties": true }
+  },
+  "required": ["id", "workflowId", "sequence", "timestamp", "type"]
+}

package/dist/schemas/storyboards/storyboard-planning-contract.schema.json

@@ -0,0 +1,108 @@
+{
+  "title": "storyboard planning contract",
+  "schemaVersion": "2026-05-12.1",
+  "description": "Typed planner payload for storyboard layout and text-rendering decisions. Renderable visible text is intentionally separate from non-renderable production metadata labels.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "source", "layout", "scenes", "endCard", "metadataLabels"],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "const": "storyboard-planning-contract/v1"
+    },
+    "source": {
+      "type": "string",
+      "enum": ["llm_schema", "assistant_metadata", "user_schema", "fallback_text"]
+    },
+    "layout": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "storyboardCanvasAspectRatio", "storyboardCellAspectRatio", "targetVideoAspectRatio", "boardDimensions"],
+      "properties": {
+        "source": {
+          "type": "string",
+          "enum": ["llm_schema", "assistant_metadata", "user_schema", "fallback_text"]
+        },
+        "storyboardCanvasAspectRatio": {
+          "type": "string",
+          "description": "Aspect ratio for the composite storyboard sheet/page, such as 16:9 or 9:16."
+        },
+        "storyboardCellAspectRatio": {
+          "type": "string",
+          "description": "Aspect ratio for each cinematic video-frame artwork area inside the storyboard."
+        },
+        "targetVideoAspectRatio": {
+          "type": "string",
+          "description": "Final video aspect ratio, such as 9:16 for vertical social video."
+        },
+        "boardDimensions": {
+          "type": "string",
+          "description": "Optional exact storyboard board dimensions, such as 2560x1440 or 1440x2560."
+        }
+      }
+    },
+    "scenes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "index", "visibleText", "metadataLabels", "referenceUsage"],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "index": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 24
+          },
+          "visibleText": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Only text that should actually appear inside the final video frame, such as brand copy, CTA text, signage, captions, or diegetic text."
+          },
+          "metadataLabels": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Production labels, timing notes, scene numbers, overlay markers, placeholders, and other notes that may guide the storyboard but must not be rendered inside a video scene or Seedance output."
+          },
+          "referenceUsage": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "endCard": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["visibleText", "metadataLabels"],
+      "properties": {
+        "visibleText": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "metadataLabels": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "metadataLabels": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}