@sogni-ai/sogni-intelligence-client 3.0.0-alpha.0

package/dist-esm/contracts/registry.js

@@ -0,0 +1,100 @@
+import { isPromptContract } from './promptContract.js';
+import { isToolGatingPolicy } from './toolGatingPolicy.js';
+import { isRepairRecipe } from './repairRecipe.js';
+function isString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function isStringRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isToolCostMetadata(value) {
+    if (!isStringRecord(value))
+        return false;
+    return isString(value.tool)
+        && isString(value.costClass)
+        && ['safe', 'paid', 'destructive'].includes(String(value.riskLevel))
+        && isString(value.userVisibleCost)
+        && isString(value.description);
+}
+function isToolPermission(value) {
+    if (!isStringRecord(value))
+        return false;
+    return isString(value.tool)
+        && ['allow', 'require_user_approval', 'require_explicit_intent'].includes(String(value.decision))
+        && ['safe', 'paid', 'destructive'].includes(String(value.riskLevel))
+        && typeof value.requiresUserApproval === 'boolean'
+        && isString(value.userVisibleCost);
+}
+export class ContractRegistry {
+    constructor() {
+        this.promptContracts = new Map();
+        this.gatingPolicies = new Map();
+        this.repairRecipes = new Map();
+        this.toolCostMetadata = new Map();
+        this.toolPermissions = new Map();
+    }
+    registerPromptContract(contract) {
+        if (!isPromptContract(contract)) {
+            throw new Error(`Invalid PromptContract: ${JSON.stringify(contract)}`);
+        }
+        this.promptContracts.set(contract.toolName, contract);
+    }
+    registerGatingPolicy(policy) {
+        if (!isToolGatingPolicy(policy)) {
+            throw new Error(`Invalid ToolGatingPolicy: ${JSON.stringify(policy)}`);
+        }
+        this.gatingPolicies.set(policy.policyId, policy);
+    }
+    registerRepairRecipe(recipe) {
+        if (!isRepairRecipe(recipe)) {
+            throw new Error(`Invalid RepairRecipe: ${JSON.stringify(recipe)}`);
+        }
+        this.repairRecipes.set(this.repairKey(recipe.toolName, recipe.errorCode), recipe);
+    }
+    registerToolCostMetadata(metadata) {
+        if (!isToolCostMetadata(metadata)) {
+            throw new Error(`Invalid ToolCostMetadata: ${JSON.stringify(metadata)}`);
+        }
+        this.toolCostMetadata.set(metadata.tool, metadata);
+    }
+    registerToolPermission(permission) {
+        if (!isToolPermission(permission)) {
+            throw new Error(`Invalid ToolPermission: ${JSON.stringify(permission)}`);
+        }
+        this.toolPermissions.set(permission.tool, permission);
+    }
+    getPromptContract(toolName) {
+        return this.promptContracts.get(toolName);
+    }
+    getGatingPolicy(policyId) {
+        return this.gatingPolicies.get(policyId);
+    }
+    findRepairRecipe(toolName, errorCode) {
+        return this.repairRecipes.get(this.repairKey(toolName, errorCode));
+    }
+    getToolCostMetadata(toolName) {
+        return this.toolCostMetadata.get(toolName);
+    }
+    getToolPermission(toolName) {
+        return this.toolPermissions.get(toolName);
+    }
+    listPromptContracts() {
+        return Array.from(this.promptContracts.values());
+    }
+    listGatingPolicies() {
+        return Array.from(this.gatingPolicies.values());
+    }
+    listRepairRecipes() {
+        return Array.from(this.repairRecipes.values());
+    }
+    listToolCostMetadata() {
+        return Array.from(this.toolCostMetadata.values());
+    }
+    listToolPermissions() {
+        return Array.from(this.toolPermissions.values());
+    }
+    repairKey(toolName, errorCode) {
+        return `${toolName}::${errorCode}`;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist-esm/contracts/registry.js.map

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

package/dist-esm/contracts/repairRecipe.js

@@ -0,0 +1,35 @@
+const VALID_MODES = new Set([
+    'autoRepair',
+    'suggestFollowup',
+    'stopAndAsk',
+]);
+export function isRepairRecipe(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const v = value;
+    if (typeof v.recipeId !== 'string' || v.recipeId.length === 0)
+        return false;
+    if (typeof v.version !== 'string' || v.version.length === 0)
+        return false;
+    if (typeof v.toolName !== 'string' || v.toolName.length === 0)
+        return false;
+    if (typeof v.errorCode !== 'string' || v.errorCode.length === 0)
+        return false;
+    if (typeof v.mode !== 'string' || !VALID_MODES.has(v.mode))
+        return false;
+    if (typeof v.maxRetries !== 'number' || !Number.isFinite(v.maxRetries) || v.maxRetries < 0)
+        return false;
+    if (typeof v.repairNoteTemplate !== 'string')
+        return false;
+    if (v.autoRepairFields !== undefined) {
+        if (!Array.isArray(v.autoRepairFields))
+            return false;
+        if (v.autoRepairFields.some((x) => typeof x !== 'string'))
+            return false;
+    }
+    if (v.suggestedFollowupTool !== undefined && typeof v.suggestedFollowupTool !== 'string') {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=repairRecipe.js.map

package/dist-esm/contracts/repairRecipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repairRecipe.js","sourceRoot":"","sources":["../../src/contracts/repairRecipe.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,GAAkC,IAAI,GAAG,CAAC;IACzD,YAAY;IACZ,iBAAiB;IACjB,YAAY;CACb,CAAC,CAAC;AA+BH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAwB,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7F,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzG,IAAI,OAAO,CAAC,CAAC,kBAAkB,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3D,IAAI,CAAC,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAAE,OAAO,KAAK,CAAC;QACrD,IAAI,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,CAAC,qBAAqB,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,qBAAqB,KAAK,QAAQ,EAAE,CAAC;QACzF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist-esm/contracts/storyboard.js

@@ -0,0 +1,4 @@
+export const CAMPAIGN_STORYBOARD_SCHEMA_VERSION = 'campaign-storyboard/v1';
+export const CAMPAIGN_STORYBOARD_METADATA_PREFIX = 'SOGNI_CAMPAIGN_STORYBOARD_JSON:';
+export const SEEDANCE_STORYBOARD_REFERENCE_PROMPT = 'Create a full-screen cinematic video from the storyboard in @Image1. Treat @Image1 as the controlling source for shot order and intent, and as a source layout reference: use the thumbnails, timing, Dialogue/VO, Audio/SFX, timecodes, camera/motion notes, transitions, and scene order as instructions, not as a visual board to reproduce. Do not display the storyboard grid, borders, caption bars, storyboard title/footer text, panel numbers, section labels, slide titles, headings, or transcribed narration. Convert the ordered thumbnails into full-screen chronological beats; do not reuse only one or two motifs while skipping panels. When the board has panel titles, captions, section numbers, slide titles, or headings but no formal Dialogue/VO labels, treat those labels as short audio-only narration/voiceover or key-message beats in order unless they are clearly visual-only metadata. Voice each label as its own brief phrase with a pause; do not concatenate labels into run-on sentences and do not speak panel numbers. Show storyboard labels as visible text only when the user explicitly asks for visible text, subtitles, a title card, lower third, signage, or a title/end frame. Preserve the story spine, character/product/reference continuity, and cause-and-effect progression between beats. Treat transitions as motion instructions, not unrelated hard cuts unless the storyboard explicitly asks for hard cuts. Use brand color, lighting, product imagery, and composition instead of invented typography. Keep visible text limited to exact copy the user or storyboard explicitly marks as on-screen text, signage, title text, or end-frame text. Use a music/SFX arc that follows the storyboard audio notes and lands the final beat. Keep unrelated UI, extra logos, microtext, subtitles, and extra scenes out of the frame.';
+//# sourceMappingURL=storyboard.js.map

package/dist-esm/contracts/storyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard.js","sourceRoot":"","sources":["../../src/contracts/storyboard.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,kCAAkC,GAAG,wBAAiC,CAAC;AACpF,MAAM,CAAC,MAAM,mCAAmC,GAAG,iCAAiC,CAAC;AAyIrF,MAAM,CAAC,MAAM,oCAAoC,GAC/C,iyDAAiyD,CAAC"}

package/dist-esm/contracts/telemetry.js

@@ -0,0 +1,33 @@
+const VALID_KINDS = new Set([
+    'turn_classified',
+    'gating_policy_applied',
+    'prompt_contract_emitted',
+    'tool_dispatch_resolved',
+    'repair_recipe_fired',
+]);
+export function isContractsTelemetryEvent(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const v = value;
+    if (typeof v.kind !== 'string' || !VALID_KINDS.has(v.kind))
+        return false;
+    if (typeof v.timestamp !== 'number')
+        return false;
+    if (v.payload === null || typeof v.payload !== 'object')
+        return false;
+    return true;
+}
+export function makeBufferedSink(capacity = 256) {
+    const buf = [];
+    return {
+        emit(event) {
+            buf.push(event);
+            if (buf.length > capacity)
+                buf.splice(0, buf.length - capacity);
+        },
+        events() {
+            return [...buf];
+        },
+    };
+}
+//# sourceMappingURL=telemetry.js.map

package/dist-esm/contracts/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/contracts/telemetry.ts"],"names":[],"mappings":"AA8CA,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,iBAAiB;IACjB,uBAAuB;IACvB,yBAAyB;IACzB,wBAAwB;IACxB,qBAAqB;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACzE,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAWD,MAAM,UAAU,gBAAgB,CAAC,QAAQ,GAAG,GAAG;IAG7C,MAAM,GAAG,GAA8B,EAAE,CAAC;IAC1C,OAAO;QACL,IAAI,CAAC,KAAK;YACR,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChB,IAAI,GAAG,CAAC,MAAM,GAAG,QAAQ;gBAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;QAClE,CAAC;QACD,MAAM;YACJ,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist-esm/contracts/toolGatingPolicy.js

@@ -0,0 +1,60 @@
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((v) => typeof v === 'string');
+}
+function isSignalSource(value) {
+    return value === 'planner'
+        || value === 'regex'
+        || value === 'classifier'
+        || value === 'session_state';
+}
+function isSourceConstraintMap(value) {
+    if (value === undefined)
+        return true;
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    return Object.values(value).every((constraint) => isSignalSource(constraint)
+        || (Array.isArray(constraint) && constraint.length > 0 && constraint.every(isSignalSource)));
+}
+function isTrigger(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const t = value;
+    if (!isStringArray(t.allOf))
+        return false;
+    if (t.noneOf !== undefined && !isStringArray(t.noneOf))
+        return false;
+    const hasAllOf = t.allOf.length > 0;
+    const hasNoneOf = Array.isArray(t.noneOf) && t.noneOf.length > 0;
+    if (!hasAllOf && !hasNoneOf)
+        return false;
+    if (!isSourceConstraintMap(t.sources))
+        return false;
+    return true;
+}
+function isEffect(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const e = value;
+    if (!isStringArray(e.forbid))
+        return false;
+    if (e.require !== undefined && !isStringArray(e.require))
+        return false;
+    return true;
+}
+export function isToolGatingPolicy(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const v = value;
+    if (typeof v.policyId !== 'string' || v.policyId.length === 0)
+        return false;
+    if (typeof v.version !== 'string' || v.version.length === 0)
+        return false;
+    if (!isTrigger(v.trigger))
+        return false;
+    if (!isEffect(v.effect))
+        return false;
+    if (typeof v.rationale !== 'string')
+        return false;
+    return true;
+}
+//# sourceMappingURL=toolGatingPolicy.js.map

package/dist-esm/contracts/toolGatingPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolGatingPolicy.js","sourceRoot":"","sources":["../../src/contracts/toolGatingPolicy.ts"],"names":[],"mappings":"AAoCA,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,KAAK,SAAS;WACrB,KAAK,KAAK,OAAO;WACjB,KAAK,KAAK,YAAY;WACtB,KAAK,KAAK,eAAe,CAAC;AACjC,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAC/C,cAAc,CAAC,UAAU,CAAC;WACvB,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAC5F,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAMrE,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACjE,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist-esm/contracts/toolPromptMarkers.js

@@ -0,0 +1,10 @@
+import { LITERAL_PROMPT_OVERRIDE } from './promptOverrideMarker.js';
+export const LITERAL_VIDEO_PROMPT_OVERRIDE = `${LITERAL_PROMPT_OVERRIDE} Set skipPromptProcessing=true; for Seedance also set expandPrompt=false.`;
+export const SEEDANCE_EXPAND_PROMPT_DESCRIPTION = 'Seedance only. Whether to run the shared Seedance prompt shaper before dispatch. Defaults to true; set false only when the user explicitly asks to submit the compact prompt directly or not modify the prompt.';
+export const GENERATE_VIDEO_SKIP_PROMPT_PROCESSING_DESCRIPTION = 'Bypass automatic prompt shaping/refinement and voice-identity prompt formatting so the prompt text is sent unchanged to the video model. Set true ONLY when the user explicitly says not to modify/rewrite/enhance/expand/change/improve the prompt, or to use/send it exactly, verbatim, or as-is, AND the provided prompt already satisfies the tool requirements. Continue to set non-prompt parameters such as model, duration, count, aspect ratio, and seed. For Seedance literal prompt requests, also set expandPrompt=false. Do not set for ordinary underspecified requests.';
+export const ANIMATE_PHOTO_SKIP_PROMPT_PROCESSING_DESCRIPTION = 'Bypass automatic prompt shaping/refinement, image-description anchoring, transition-prompt rewriting, and voice-identity prompt formatting so the prompt text is sent unchanged to the video model. Set true ONLY when the user explicitly says not to modify/rewrite/enhance/expand/change/improve the prompt, or to use/send it exactly, verbatim, or as-is, AND the provided prompt already satisfies the tool requirements. Continue to set non-prompt parameters such as source indices, frameRole, model, duration, count, and aspect ratio. For Seedance literal prompt requests, also set expandPrompt=false. Do not set for ordinary underspecified requests.';
+export const LITERAL_SEEDANCE_PROMPT_OVERRIDE = `${LITERAL_PROMPT_OVERRIDE} For Seedance, set expandPrompt=false.`;
+export const SEEDANCE_TOOL_MULTIMODAL_REFERENCE_GUIDANCE = `Seedance supports multimodal loose reference assets: images (up to 9), videos (up to 3), and audios (up to 3), with no more than 12 asset files total. Use @Image1/@Video1/@Audio1 style references in creative briefs when assigning roles. Assign every useful reference asset a role and prefer positive preservation constraints. If an uploaded video is the source clip to transform, upscale, enhance, restyle, or remaster, use video_to_video with controlMode="seedance-v2v" instead of generate_video referenceVideoIndices.`;
+export const SEEDANCE_TOOL_V2V_REFERENCE_GUIDANCE = `Seedance V2V reads @Video1 holistically. Use it for restyling, motion transfer, extension, subject replacement, or scene transformation, and assign @Video1 a clear role such as source clip, camera movement, action timing, edit rhythm, or continuation anchor.`;
+export const SEEDANCE_TOOL_AUDIO_REFERENCE_GUIDANCE = `For Seedance audio-reference prompts, preserve exact spoken dialogue when the user supplied it, and assign @Image1/@Audio1 roles. If the user asks for speech without words, describe the vocal performance without inventing quoted dialogue. Treat lip-sync, voice cloning, and real-human reference behavior as provider-sensitive rather than guaranteed.`;
+//# sourceMappingURL=toolPromptMarkers.js.map

package/dist-esm/contracts/toolPromptMarkers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolPromptMarkers.js","sourceRoot":"","sources":["../../src/contracts/toolPromptMarkers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,CAAC,MAAM,6BAA6B,GACxC,GAAG,uBAAuB,2EAA2E,CAAC;AAExG,MAAM,CAAC,MAAM,kCAAkC,GAC7C,iNAAiN,CAAC;AAEpN,MAAM,CAAC,MAAM,iDAAiD,GAC5D,wjBAAwjB,CAAC;AAE3jB,MAAM,CAAC,MAAM,gDAAgD,GAC3D,woBAAwoB,CAAC;AAE3oB,MAAM,CAAC,MAAM,gCAAgC,GAC3C,GAAG,uBAAuB,wCAAwC,CAAC;AAErE,MAAM,CAAC,MAAM,2CAA2C,GAAG,ygBAAygB,CAAC;AAErkB,MAAM,CAAC,MAAM,oCAAoC,GAAG,oQAAoQ,CAAC;AAEzT,MAAM,CAAC,MAAM,sCAAsC,GAAG,+VAA+V,CAAC"}

package/dist-esm/contracts/toolSurface.js

@@ -0,0 +1,110 @@
+import { classifyTurn, compileToolsForTurn, } from './evaluators.js';
+export const DEFAULT_CONTRACT_CONTEXT_PREFIX = 'Sogni Creative Agent tool policy for this turn:';
+export function normalizeContractMessages(messages) {
+    return messages.map((message) => ({
+        role: message.role,
+        content: contractMessageContentToText(message.content),
+    }));
+}
+export function buildContractTurnPolicy(input) {
+    return classifyTurn({
+        messages: normalizeContractMessages(input.messages ?? []),
+        assetManifest: input.assetManifest ?? { items: [] },
+        sessionState: {
+            hasGeneratedVideo: false,
+            hasUploadedVideo: false,
+            repairCount: 0,
+            ...input.sessionState,
+        },
+        availableTools: input.availableTools,
+        registry: input.registry,
+        signals: input.signals ?? [],
+        telemetry: input.telemetry,
+    });
+}
+export function compileContractToolSurface(input) {
+    const definitions = input.tools.map(normalizeContractToolDefinition);
+    const availableTools = definitions.map((tool) => tool.function.name);
+    const turnPolicy = input.turnPolicy
+        ? turnPolicyWithDefaultVisibleTools(input.turnPolicy, availableTools)
+        : buildContractTurnPolicy({
+            availableTools,
+            registry: input.registry,
+            messages: input.messages,
+            assetManifest: input.assetManifest,
+            sessionState: input.sessionState,
+            signals: input.signals,
+            telemetry: input.telemetry,
+        });
+    const compiled = compileToolsForTurn({
+        turnPolicy,
+        registry: input.registry,
+        availableToolDefinitions: definitions,
+        telemetry: input.telemetry,
+    });
+    return {
+        ...compiled,
+        turnPolicy,
+    };
+}
+export function formatContractsContextBlock(contextBlock, prefix = DEFAULT_CONTRACT_CONTEXT_PREFIX) {
+    const trimmed = contextBlock.trim();
+    if (!trimmed)
+        return '';
+    return `${prefix}\n${trimmed}`;
+}
+export function appendContractsContextToSystemContent(systemContent, contextBlock) {
+    const formatted = formatContractsContextBlock(contextBlock);
+    return formatted ? `${systemContent}\n\n${formatted}` : systemContent;
+}
+export function reconcileToolChoiceForCompiledTools(toolChoice, tools) {
+    if (!toolChoice)
+        return toolChoice;
+    if (tools.length === 0)
+        return undefined;
+    if (typeof toolChoice !== 'object' || toolChoice.type !== 'function')
+        return toolChoice;
+    const forcedToolName = toolChoice.function.name;
+    const isStillVisible = tools.some((tool) => tool.function.name === forcedToolName);
+    return isStillVisible ? toolChoice : 'auto';
+}
+function contractMessageContentToText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((part) => {
+        if (part && typeof part === 'object' && 'text' in part) {
+            const text = part.text;
+            return typeof text === 'string' ? text : '';
+        }
+        return '';
+    })
+        .filter(Boolean)
+        .join(' ');
+}
+function normalizeContractToolDefinition(tool) {
+    return {
+        type: 'function',
+        function: {
+            name: tool.function.name,
+            description: tool.function.description ?? '',
+            parameters: tool.function.parameters ?? { type: 'object', properties: {} },
+        },
+    };
+}
+function turnPolicyWithDefaultVisibleTools(turnPolicy, availableTools) {
+    if (turnPolicy.visibleTools.length > 0
+        || turnPolicy.forbiddenTools.length > 0
+        || turnPolicy.requiredTools.length > 0
+        || turnPolicy.appliedPolicies.length > 0
+        || turnPolicy.rationale) {
+        return turnPolicy;
+    }
+    return {
+        ...turnPolicy,
+        visibleTools: [...availableTools],
+    };
+}
+//# sourceMappingURL=toolSurface.js.map

package/dist-esm/contracts/toolSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSurface.js","sourceRoot":"","sources":["../../src/contracts/toolSurface.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EACZ,mBAAmB,GAIpB,MAAM,iBAAiB,CAAC;AAyCzB,MAAM,CAAC,MAAM,+BAA+B,GAC1C,iDAAiD,CAAC;AAEpD,MAAM,UAAU,yBAAyB,CACvC,QAA4C;IAE5C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC,OAAO,CAAC;KACvD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAmC;IACzE,OAAO,YAAY,CAAC;QAClB,QAAQ,EAAE,yBAAyB,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QACzD,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACnD,YAAY,EAAE;YACZ,iBAAiB,EAAE,KAAK;YACxB,gBAAgB,EAAE,KAAK;YACvB,WAAW,EAAE,CAAC;YACd,GAAG,KAAK,CAAC,YAAY;SACtB;QACD,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,KAAsC;IAEtC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU;QACjC,CAAC,CAAC,iCAAiC,CAAC,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC;QACrE,CAAC,CAAC,uBAAuB,CAAC;YACxB,cAAc;YACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;IAEL,MAAM,QAAQ,GAAG,mBAAmB,CAAC;QACnC,UAAU;QACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,wBAAwB,EAAE,WAAW;QACrC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,QAAQ;QACX,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,YAAoB,EACpB,MAAM,GAAG,+BAA+B;IAExC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,aAAqB,EACrB,YAAoB;IAEpB,MAAM,SAAS,GAAG,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAC5D,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,aAAa,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,UAAa,EACb,KAAgD;IAEhD,IAAI,CAAC,UAAU;QAAE,OAAO,UAAU,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAExF,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;IAChD,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;IACnF,OAAO,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,SAAS,4BAA4B,CAAC,OAAgB;IACpD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACvD,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;YAC/C,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,+BAA+B,CACtC,IAAgC;IAEhC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YACxB,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE;YAC5C,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;SAC3E;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iCAAiC,CACxC,UAAsB,EACtB,cAAqC;IAErC,IACE,UAAU,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;WAC/B,UAAU,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;WACpC,UAAU,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;WACnC,UAAU,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;WACrC,UAAU,CAAC,SAAS,EACvB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO;QACL,GAAG,UAAU;QACb,YAAY,EAAE,CAAC,GAAG,cAAc,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist-esm/contracts/turnPolicy.js

@@ -0,0 +1,13 @@
+export function emptyTurnPolicy() {
+    return {
+        signals: [],
+        visibleTools: [],
+        forbiddenTools: [],
+        forbiddenToolPolicies: {},
+        requiredTools: [],
+        contextHints: [],
+        appliedPolicies: [],
+        rationale: '',
+    };
+}
+//# sourceMappingURL=turnPolicy.js.map

package/dist-esm/contracts/turnPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnPolicy.js","sourceRoot":"","sources":["../../src/contracts/turnPolicy.ts"],"names":[],"mappings":"AA6CA,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,EAAE;QAClB,qBAAqB,EAAE,EAAE;QACzB,aAAa,EAAE,EAAE;QACjB,YAAY,EAAE,EAAE;QAChB,eAAe,EAAE,EAAE;QACnB,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC"}

package/dist-esm/contracts/videoComposition.js

@@ -0,0 +1,216 @@
+import { stripThinkBlocks } from '../tools/shared/llmHelpers.js';
+import { getRandomTheme } from './randomThemes.js';
+export const SCRIPT_MAX_TOKENS = 2048;
+const LTX_I2V_GUIDANCE = `\n\nIMPORTANT: One or more reference frame images are attached to this message. They define the subject, costume, environment, lighting, and composition. Do NOT re-describe appearance in detail — the model sees the image. Focus the prose on motion, camera move, ambient motion, sound, and how the scene evolves over the target duration. If both a starting and an ending frame are attached, the action must believably progress from the first into the second.`;
+const LTX_SYSTEM_PROMPT = `You are an expert cinematographer writing prompts for LTX-2, an AI video generation model. Expand the user's idea into a single dense paragraph of 4-8 present-tense sentences (~200 words). One continuous shot — no cuts, no montage. Return your result via the compose_script tool.
+
+PROMPT CONSTRUCTION — include these elements in flowing prose:
+1. SHOT & STYLE: Shot scale + visual genre. "A medium close-up noir-lit shot..." Front-load this.
+2. SCENE: Environment, time of day, atmosphere, surface textures. Name light sources explicitly: "warm tungsten practicals," "golden hour backlight through dusty blinds."
+3. SUBJECT: Age (always a specific number), build, hair, clothing, distinguishing features. Be explicit and specific — use the same words the user used. Match detail to shot scale — close-ups need physical precision, wide shots need environmental richness.
+4. ACTION: One main thread of physically filmable movement evolving start to end. Use temporal connectors ("as," "then," "while"). Express emotion through visible behavior — jaw tension, grip pressure, breathing pace, posture shifts — never emotional labels.
+5. CAMERA: ONE movement only — dolly in, slow pan, tracking follow, handheld drift, etc. Stacking multiple movements causes jitter. Describe as prose: "the camera performs a slow push-in."
+6. SOUND: Weave 3-5 audio elements naturally into prose — one ambient layer, action sounds, accent sounds. Never use [AMBIENT:] or [SOUND:] tags. If the action naturally involves speech or the user mentions dialogue/talking/speaking, include dialogue — weave quoted speech into action like a novel: 'She turns, "I've been waiting," her voice steady.' Describe vocal quality (whispers, warm tone, gravelly).
+7. TECHNICAL: End with a stability anchor and lens cue: "Shot on 35mm at f/1.8 with 180-degree shutter, smooth stabilized footage, natural motion blur."
+
+CONSTRAINTS: Present tense only. Positive phrasing — describe what IS, never what isn't. No on-screen text/logos. Dense prose, never bullet lists. No vague words ("beautiful," "nice") — be visually specific.
+
+REFERENCE PROMPT (match this style):
+"A medium close-up cinematic shot in a quiet rain-soaked alley at night, neon reflections shimmering across wet pavement. A man in his 30s with short dark hair and a worn leather jacket stands under a flickering sign, water beading on his collar. He exhales slowly, shoulders tightening as his fingers clamp around a small metal lighter, then steadies his hand and clicks it once, watching the flame struggle against the damp air, rain tapping softly against the awning while a distant car horn echoes. The camera performs a slow push-in toward his face as his jaw sets, tendons rising, weight shifting forward by half a step, breathing measured. Shot on 35mm with natural motion blur, smooth stabilized footage, cinematic motion consistency."`;
+const WAN_T2V_SYSTEM_PROMPT = `You are an expert cinematographer writing prompts for Wan 2.2, an AI video generation model by Alibaba. Expand the user's idea into a single dense paragraph of flowing present-tense prose (80-120 words). One continuous shot — no cuts, no montage. Return your result via the compose_script tool.
+
+PROMPT CONSTRUCTION — weave these elements into flowing prose:
+1. SUBJECT: Main focus with rich appearance details — age, build, clothing, distinguishing features. Be explicit and physically specific. Match detail to shot scale.
+2. SCENE: Environment, time of day, atmosphere, surface textures. Name light sources explicitly: "golden hour backlight," "warm tungsten practicals," "neon rim light," "soft overcast diffusion." Use professional lighting terms — volumetric, rim light, backlit, side light.
+3. MOTION: One primary thread of physically filmable movement evolving start to end. Use temporal connectors ("as," "then," "while"). Express emotion through visible behavior — posture, gesture, breathing — never emotional labels. Limit to 5-7 well-chosen motion descriptors. Control pacing with words like "slowly," "gently," "briskly."
+4. CAMERA: ONE movement only — dolly in, slow pan, tracking shot, orbital arc, crane up, handheld drift, push-in, pull-back. Stacking multiple movements causes jitter. Specify shot type: close-up, medium, wide, extreme wide.
+5. STYLE: End with a color/lens anchor: film stock reference (Kodak Portra, 35mm grain), color grading (teal-and-orange, warm tones, desaturated), depth of field (shallow, anamorphic bokeh), and a stability note.
+
+CONSTRAINTS:
+- Present tense only. Positive phrasing — describe what IS, never what isn't.
+- No on-screen text, logos, or watermarks.
+- Dense prose, never bullet lists. No vague words ("beautiful," "nice") — be visually specific.
+- Avoid contradictory instructions (conflicting motion directions or styles).
+- Limit style combinations to 2-3 compatible aesthetics.
+- One primary subject with one main motion — avoid complex multi-subject choreography.
+
+REFERENCE PROMPT (match this style and density):
+"A young woman in a flowing ivory dress walks slowly through a field of tall golden wheat at sunset, her fingers trailing across the grain tips as warm backlight catches wisps of hair around her face. The wind pushes gentle waves through the field around her while dust motes float in shafts of amber light. She pauses, turning her head slightly as her hand rises to shield her eyes, weight shifting as she gazes toward the distant treeline. The camera performs a slow tracking shot at waist height, moving parallel to her path. Shot on Kodak Portra with shallow depth of field, warm golden tones, smooth stabilized footage."`;
+const WAN_I2V_SYSTEM_PROMPT = `You are an expert cinematographer writing prompts for Wan 2.2 image-to-video generation. The user has attached the actual reference frame(s) — a starting frame, and optionally an ending frame. Your job is to write a video prompt that brings this image to life with motion. Return your result via the compose_script tool.
+
+CRITICAL: The image already defines the subject and scene. Do NOT re-describe appearance, clothing, or environment in detail — the model sees the image. Focus entirely on MOTION, CAMERA, and TEMPORAL PROGRESSION. If an ending frame is also provided, plan the motion so the scene naturally evolves from the start frame to the end frame.
+
+PROMPT CONSTRUCTION — weave these elements into flowing prose (60-100 words):
+1. MOTION: The primary action thread — what moves, how, at what pace. Use temporal connectors ("as," "then," "while"). Describe physically filmable movement. Limit to 5-7 well-chosen motion descriptors. Control pacing: "slowly," "gently," "briskly."
+2. CAMERA: ONE movement only — dolly in, slow pan, tracking shot, orbital arc, crane up, handheld drift, push-in, pull-back.
+3. AMBIENT MOTION: Secondary environmental movement — wind, light shifts, particles, reflections. Keep subtle.
+4. STYLE: Brief color/lens anchor if needed.
+
+CONSTRAINTS:
+- Present tense only. Positive phrasing — describe what IS, never what isn't.
+- Do NOT describe the subject's appearance — the image defines that.
+- One continuous shot — no cuts, no montage.
+- Dense prose, never bullet lists.
+
+REFERENCE PROMPT (for an image of a woman in a wheat field):
+"She walks slowly forward, fingers trailing across the grain tips as warm backlight catches wisps of hair. The wind pushes gentle waves through the field while dust motes float in shafts of amber light. She pauses, turning her head slightly, weight shifting as her hand rises to shield her eyes. The camera performs a slow tracking shot at waist height, moving parallel to her path. Smooth stabilized footage with shallow depth of field."`;
+export const CHARACTER_REFERENCE_VIDEO_COMPOSITION_SYSTEM_PROMPT = [
+    'You are Sogni compose_script, a creative writing tool for polished video prompts.',
+    'Return exactly one compose_script tool call. The script should be concrete, surprising, production-ready, and compact enough to become a downstream video prompt.',
+    'Respect all explicit user constraints. If no exact dialogue is supplied, describe voice quality or performance without inventing quoted dialogue.',
+].join('\n');
+export const SCRIPT_COMPOSITION_TOOL = {
+    type: 'function',
+    function: {
+        name: 'compose_script',
+        description: 'Output the composed video generation prompt',
+        parameters: {
+            type: 'object',
+            properties: {
+                script: {
+                    type: 'string',
+                    description: 'The full cinematic video prompt as dense flowing prose. The scene ends when the script ends.',
+                },
+            },
+            required: ['script'],
+        },
+    },
+};
+function imageContentPart(dataUrl) {
+    return { type: 'image_url', image_url: { url: dataUrl, detail: 'auto' } };
+}
+export function buildLtxScriptMessages(prompt, duration, options = {}) {
+    const { firstFrameDataUrl, lastFrameDataUrl } = options;
+    const hasVisionImage = !!firstFrameDataUrl || !!lastFrameDataUrl;
+    const systemContent = hasVisionImage ? LTX_SYSTEM_PROMPT + LTX_I2V_GUIDANCE : LTX_SYSTEM_PROMPT;
+    const messages = [{ role: 'system', content: systemContent }];
+    let userText;
+    if (hasVisionImage) {
+        if (firstFrameDataUrl && lastFrameDataUrl) {
+            userText =
+                'Two reference frames are attached: the first image is the STARTING frame, the second is the ENDING frame.';
+        }
+        else if (lastFrameDataUrl) {
+            userText = 'The attached image is the ENDING frame of the video.';
+        }
+        else {
+            userText = 'The attached image is the STARTING frame of the video.';
+        }
+        if (prompt.trim()) {
+            userText += `\n\nAdditional direction: ${prompt}`;
+        }
+    }
+    else if (prompt.trim()) {
+        userText = prompt;
+    }
+    else {
+        const theme = options.randomTheme || getRandomTheme();
+        userText = `Come up with a unique, original video scene inspired by: ${theme}. Be creative and surprising — avoid clichés.`;
+    }
+    userText += `\n\nTarget video duration: ${duration} seconds.`;
+    if (hasVisionImage) {
+        const content = [];
+        if (firstFrameDataUrl) {
+            content.push(imageContentPart(firstFrameDataUrl));
+        }
+        if (lastFrameDataUrl) {
+            content.push(imageContentPart(lastFrameDataUrl));
+        }
+        content.push({ type: 'text', text: userText });
+        messages.push({ role: 'user', content });
+    }
+    else {
+        messages.push({ role: 'user', content: userText });
+    }
+    return messages;
+}
+export function buildWanScriptMessages(params) {
+    const { prompt, firstFrameDescription, firstFrameDataUrl, lastFrameDataUrl, duration } = params;
+    const hasVisionImage = !!firstFrameDataUrl || !!lastFrameDataUrl;
+    const isI2V = hasVisionImage || !!firstFrameDescription;
+    const systemPrompt = isI2V ? WAN_I2V_SYSTEM_PROMPT : WAN_T2V_SYSTEM_PROMPT;
+    const messages = [{ role: 'system', content: systemPrompt }];
+    let userText;
+    if (hasVisionImage) {
+        if (firstFrameDataUrl && lastFrameDataUrl) {
+            userText =
+                'The two attached images are the starting frame and the ending frame of the video. Plan a single continuous shot that evolves from the first into the second.';
+        }
+        else if (lastFrameDataUrl) {
+            userText =
+                'The attached image is the ENDING frame of the video. Plan motion that naturally arrives at this composition.';
+        }
+        else {
+            userText = 'The attached image is the starting frame of the video.';
+        }
+        if (prompt?.trim()) {
+            userText += `\n\nAdditional direction: ${prompt}`;
+        }
+    }
+    else if (isI2V) {
+        userText = `The first frame is an image described as: "${firstFrameDescription}"`;
+        if (prompt?.trim()) {
+            userText += `\n\nAdditional direction: ${prompt}`;
+        }
+    }
+    else if (prompt?.trim()) {
+        userText = prompt;
+    }
+    else {
+        const theme = params.randomTheme || getRandomTheme();
+        userText = `Come up with a unique, original video scene inspired by: ${theme}. Be creative and surprising — avoid clichés.`;
+    }
+    if (duration) {
+        userText += `\n\nTarget video duration: ${duration} seconds.`;
+    }
+    if (hasVisionImage) {
+        const content = [];
+        if (firstFrameDataUrl) {
+            content.push(imageContentPart(firstFrameDataUrl));
+        }
+        if (lastFrameDataUrl) {
+            content.push(imageContentPart(lastFrameDataUrl));
+        }
+        content.push({ type: 'text', text: userText });
+        messages.push({ role: 'user', content });
+    }
+    else {
+        messages.push({ role: 'user', content: userText });
+    }
+    return messages;
+}
+export function parseToolCallScript(args) {
+    return String(args.script || '').trim();
+}
+export function buildCharacterReferenceVideoCompositionMessages(input) {
+    const content = [];
+    if (input.imageDataUrl) {
+        content.push(imageContentPart(input.imageDataUrl));
+    }
+    content.push({ type: 'text', text: input.brief });
+    return [
+        { role: 'system', content: CHARACTER_REFERENCE_VIDEO_COMPOSITION_SYSTEM_PROMPT },
+        { role: 'user', content },
+    ];
+}
+export function parseCompositionToolScriptFromResult(result) {
+    const toolCalls = result?.tool_calls ?? [];
+    for (const call of toolCalls) {
+        if (call.function?.name !== 'compose_script')
+            continue;
+        try {
+            const parsed = JSON.parse(call.function.arguments || '{}');
+            const script = parseToolCallScript(parsed);
+            if (script)
+                return script;
+        }
+        catch {
+            continue;
+        }
+    }
+    const content = typeof result?.content === 'string'
+        ? stripThinkBlocks(result.content, false, false).cleaned.trim()
+        : '';
+    return content;
+}
+//# sourceMappingURL=videoComposition.js.map