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

package/dist/contracts/turnPolicy.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyTurnPolicy = emptyTurnPolicy;
+function emptyTurnPolicy() {
+    return {
+        signals: [],
+        visibleTools: [],
+        forbiddenTools: [],
+        forbiddenToolPolicies: {},
+        requiredTools: [],
+        contextHints: [],
+        appliedPolicies: [],
+        rationale: '',
+    };
+}
+//# sourceMappingURL=turnPolicy.js.map

package/dist/contracts/turnPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnPolicy.js","sourceRoot":"","sources":["../../src/contracts/turnPolicy.ts"],"names":[],"mappings":";;AA6CA,0CAWC;AAXD,SAAgB,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/contracts/videoComposition.d.ts

@@ -0,0 +1,35 @@
+import type { SogniChatMessage } from '../runtime/chatTypes.js';
+import type { ToolDefinition } from '../tools/definitions/types.js';
+export declare const SCRIPT_MAX_TOKENS = 2048;
+export declare const CHARACTER_REFERENCE_VIDEO_COMPOSITION_SYSTEM_PROMPT: string;
+export declare const SCRIPT_COMPOSITION_TOOL: ToolDefinition;
+export interface VideoFramePromptOptions {
+    firstFrameDataUrl?: string;
+    lastFrameDataUrl?: string;
+    randomTheme?: string;
+}
+export type ScriptOptions = VideoFramePromptOptions;
+export interface GenerateWanPromptParams extends VideoFramePromptOptions {
+    prompt?: string;
+    firstFrameDescription?: string;
+    duration?: number;
+}
+export interface CharacterReferenceVideoCompositionMessageInput {
+    brief: string;
+    imageDataUrl?: string | null;
+}
+export interface CompositionToolCallResultLike {
+    tool_calls?: Array<{
+        function?: {
+            name?: string | null;
+            arguments?: string | null;
+        } | null;
+    }>;
+    content?: string | null;
+}
+export declare function buildLtxScriptMessages(prompt: string, duration: number, options?: VideoFramePromptOptions): SogniChatMessage[];
+export declare function buildWanScriptMessages(params: GenerateWanPromptParams): SogniChatMessage[];
+export declare function parseToolCallScript(args: Record<string, unknown>): string;
+export declare function buildCharacterReferenceVideoCompositionMessages(input: CharacterReferenceVideoCompositionMessageInput): SogniChatMessage[];
+export declare function parseCompositionToolScriptFromResult(result: CompositionToolCallResultLike | null | undefined): string;
+//# sourceMappingURL=videoComposition.d.ts.map

package/dist/contracts/videoComposition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoComposition.d.ts","sourceRoot":"","sources":["../../src/contracts/videoComposition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAIpE,eAAO,MAAM,iBAAiB,OAAO,CAAC;AA2DtC,eAAO,MAAM,mDAAmD,QAIpD,CAAC;AAEb,eAAO,MAAM,uBAAuB,EAAE,cAiBrC,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAEpD,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,8CAA8C;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,6BAA6B;IAC5C,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,QAAQ,CAAC,EAAE;YACT,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAC3B,GAAG,IAAI,CAAC;KACV,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAMD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,EAAE,CAyCpB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,EAAE,CAmD1F;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEzE;AAED,wBAAgB,+CAA+C,CAC7D,KAAK,EAAE,8CAA8C,GACpD,gBAAgB,EAAE,CAUpB;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,6BAA6B,GAAG,IAAI,GAAG,SAAS,GACvD,MAAM,CAgBR"}

package/dist/contracts/videoComposition.js

@@ -0,0 +1,224 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCRIPT_COMPOSITION_TOOL = exports.CHARACTER_REFERENCE_VIDEO_COMPOSITION_SYSTEM_PROMPT = exports.SCRIPT_MAX_TOKENS = void 0;
+exports.buildLtxScriptMessages = buildLtxScriptMessages;
+exports.buildWanScriptMessages = buildWanScriptMessages;
+exports.parseToolCallScript = parseToolCallScript;
+exports.buildCharacterReferenceVideoCompositionMessages = buildCharacterReferenceVideoCompositionMessages;
+exports.parseCompositionToolScriptFromResult = parseCompositionToolScriptFromResult;
+const llmHelpers_js_1 = require("../tools/shared/llmHelpers.js");
+const randomThemes_js_1 = require("./randomThemes.js");
+exports.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."`;
+exports.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');
+exports.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' } };
+}
+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 || (0, randomThemes_js_1.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;
+}
+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 || (0, randomThemes_js_1.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;
+}
+function parseToolCallScript(args) {
+    return String(args.script || '').trim();
+}
+function buildCharacterReferenceVideoCompositionMessages(input) {
+    const content = [];
+    if (input.imageDataUrl) {
+        content.push(imageContentPart(input.imageDataUrl));
+    }
+    content.push({ type: 'text', text: input.brief });
+    return [
+        { role: 'system', content: exports.CHARACTER_REFERENCE_VIDEO_COMPOSITION_SYSTEM_PROMPT },
+        { role: 'user', content },
+    ];
+}
+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'
+        ? (0, llmHelpers_js_1.stripThinkBlocks)(result.content, false, false).cleaned.trim()
+        : '';
+    return content;
+}
+//# sourceMappingURL=videoComposition.js.map

package/dist/contracts/videoComposition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoComposition.js","sourceRoot":"","sources":["../../src/contracts/videoComposition.ts"],"names":[],"mappings":";;;AA0HA,wDA6CC;AAED,wDAmDC;AAED,kDAEC;AAED,0GAYC;AAED,oFAkBC;AAhQD,iEAAiE;AACjE,uDAAmD;AAEtC,QAAA,iBAAiB,GAAG,IAAI,CAAC;AAEtC,MAAM,gBAAgB,GAAG,2cAA2c,CAAC;AAEre,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;wuBAc8sB,CAAC;AAEzuB,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;knBAkBolB,CAAC;AAEnnB,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;ubAiByZ,CAAC;AAE3a,QAAA,mDAAmD,GAAG;IACjE,mFAAmF;IACnF,mKAAmK;IACnK,mJAAmJ;CACpJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEA,QAAA,uBAAuB,GAAmB;IACrD,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,6CAA6C;QAC1D,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,8FAA8F;iBACjG;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC;AA+BF,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;AAC5E,CAAC;AAED,SAAgB,sBAAsB,CACpC,MAAc,EACd,QAAgB,EAChB,UAAmC,EAAE;IAErC,MAAM,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,cAAc,GAAG,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,gBAAgB,CAAC;IACjE,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAChG,MAAM,QAAQ,GAAuB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IAElF,IAAI,QAAgB,CAAC;IACrB,IAAI,cAAc,EAAE,CAAC;QACnB,IAAI,iBAAiB,IAAI,gBAAgB,EAAE,CAAC;YAC1C,QAAQ;gBACN,2GAA2G,CAAC;QAChH,CAAC;aAAM,IAAI,gBAAgB,EAAE,CAAC;YAC5B,QAAQ,GAAG,sDAAsD,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,wDAAwD,CAAC;QACtE,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAClB,QAAQ,IAAI,6BAA6B,MAAM,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACzB,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,IAAA,gCAAc,GAAE,CAAC;QACtD,QAAQ,GAAG,4DAA4D,KAAK,+CAA+C,CAAC;IAC9H,CAAC;IACD,QAAQ,IAAI,8BAA8B,QAAQ,WAAW,CAAC;IAE9D,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,sBAAsB,CAAC,MAA+B;IACpE,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAChG,MAAM,cAAc,GAAG,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,gBAAgB,CAAC;IACjE,MAAM,KAAK,GAAG,cAAc,IAAI,CAAC,CAAC,qBAAqB,CAAC;IACxD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAC3E,MAAM,QAAQ,GAAuB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IAEjF,IAAI,QAAgB,CAAC;IACrB,IAAI,cAAc,EAAE,CAAC;QACnB,IAAI,iBAAiB,IAAI,gBAAgB,EAAE,CAAC;YAC1C,QAAQ;gBACN,8JAA8J,CAAC;QACnK,CAAC;aAAM,IAAI,gBAAgB,EAAE,CAAC;YAC5B,QAAQ;gBACN,8GAA8G,CAAC;QACnH,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,wDAAwD,CAAC;QACtE,CAAC;QACD,IAAI,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACnB,QAAQ,IAAI,6BAA6B,MAAM,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,EAAE,CAAC;QACjB,QAAQ,GAAG,8CAA8C,qBAAqB,GAAG,CAAC;QAClF,IAAI,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACnB,QAAQ,IAAI,6BAA6B,MAAM,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QAC1B,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,IAAI,IAAA,gCAAc,GAAE,CAAC;QACrD,QAAQ,GAAG,4DAA4D,KAAK,+CAA+C,CAAC;IAC9H,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,IAAI,8BAA8B,QAAQ,WAAW,CAAC;IAChE,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,mBAAmB,CAAC,IAA6B;IAC/D,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,SAAgB,+CAA+C,CAC7D,KAAqD;IAErD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAClD,OAAO;QACL,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,2DAAmD,EAAE;QAChF,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;KAC1B,CAAC;AACJ,CAAC;AAED,SAAgB,oCAAoC,CAClD,MAAwD;IAExD,MAAM,SAAS,GAAG,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,KAAK,gBAAgB;YAAE,SAAS;QACvD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,IAAI,CAA4B,CAAC;YACtF,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,MAAM,EAAE,OAAO,KAAK,QAAQ;QACjD,CAAC,CAAC,IAAA,gCAAgB,EAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE;QAC/D,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { SogniClientWrapper } from './client/SogniClientWrapper';
+export type { SogniClientConfig, AuthType, TokenAuthConfig, CookieAuthConfig, ApiKeyAuthConfig, ProjectConfig, ImageProjectConfig, VideoProjectConfig, AudioProjectConfig, ProjectResult, ProjectProgress, VideoCostEstimateParams, AudioCostEstimateParams, CostEstimate, ConnectionStatus, ConnectionState, ModelInfo, BalanceInfo, SizePreset, GetModelsOptions, CreateProjectOptions, ErrorData, JobCompletedData, JobFailedData, ChatErrorData, QwenImageEditConfig, Project, Job, AvailableModel, SupernetType, TokenType, AudioProjectParams, ImageOutputFormat, VideoOutputFormat, AudioOutputFormat, AudioFormat, VideoFormat, VideoWorkflowType, ChatMessage, ChatCompletionParams, ChatCompletionChunk, ChatCompletionResult, ChatJobStateEvent, ContentPart, TextContentPart, ImageUrlContentPart, ChatTokenUsage, LLMCostEstimation, LLMJobCost, LLMModelInfo, LLMParamConstraint, LLMSamplingDefaults, ToolDefinition, ToolCall, ToolCallDelta, ToolCallFunction, ToolChoice, ToolFunction, SogniToolsMode, ToolExecutionOptions, ToolExecutionProgress, ToolExecutionResult, ToolHistoryEntry, CreativeWorkflowArtifact, CreativeWorkflowEvent, CreativeWorkflowRecord, CreativeWorkflowSseEvent, CreativeWorkflowStatus, CreativeWorkflowHostedToolName, ListCreativeWorkflowOptions, StartCreativeWorkflowOptions, StartCreativeWorkflowParams, StreamCreativeWorkflowEventsOptions, InputMedia, ProjectEvent, JobEvent, ControlNetParams, ControlNetName, ControlNetMode, VideoControlNetName, VideoControlNetParams, } from './types';
+export { ClientEvent } from './types';
+export { SogniError, SogniConnectionError, SogniAuthenticationError, SogniProjectError, SogniTimeoutError, SogniBalanceError, SogniValidationError, SogniConfigurationError, SogniModelNotFoundError, SogniNetworkError, } from './utils/errors';
+export { generateAppId, validateClientConfig, validateProjectConfig, isImageProjectConfig, isVideoProjectConfig, isAudioProjectConfig, isWanVideoModel, isLtxVideoModel, isSeedanceVideoModel, isCookieAuth, sleep, retry, formatBytes, formatDuration, getMaxContextImages, supportsContextImages, } from './utils/helpers';
+export { ChatStream, CreativeWorkflowsApi, SogniClient, SogniTools, isSogniToolCall, parseCreativeWorkflowSseChunk, parseToolCallArguments, } from '@sogni-ai/sogni-client';
+export { SogniClientWrapper as default } from './client/SogniClientWrapper';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGjE,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,mBAAmB,EAEnB,OAAO,EACP,GAAG,EACH,cAAc,EACd,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,8BAA8B,EAC9B,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,mCAAmC,EACnC,UAAU,EACV,YAAY,EACZ,QAAQ,EAER,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,KAAK,EACL,KAAK,EACL,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,eAAe,EACf,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,kBAAkB,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.parseToolCallArguments = exports.parseCreativeWorkflowSseChunk = exports.isSogniToolCall = exports.SogniTools = exports.SogniClient = exports.CreativeWorkflowsApi = exports.ChatStream = exports.supportsContextImages = exports.getMaxContextImages = exports.formatDuration = exports.formatBytes = exports.retry = exports.sleep = exports.isCookieAuth = exports.isSeedanceVideoModel = exports.isLtxVideoModel = exports.isWanVideoModel = exports.isAudioProjectConfig = exports.isVideoProjectConfig = exports.isImageProjectConfig = exports.validateProjectConfig = exports.validateClientConfig = exports.generateAppId = exports.SogniNetworkError = exports.SogniModelNotFoundError = exports.SogniConfigurationError = exports.SogniValidationError = exports.SogniBalanceError = exports.SogniTimeoutError = exports.SogniProjectError = exports.SogniAuthenticationError = exports.SogniConnectionError = exports.SogniError = exports.ClientEvent = exports.SogniClientWrapper = void 0;
+var SogniClientWrapper_1 = require("./client/SogniClientWrapper");
+Object.defineProperty(exports, "SogniClientWrapper", { enumerable: true, get: function () { return SogniClientWrapper_1.SogniClientWrapper; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "ClientEvent", { enumerable: true, get: function () { return types_1.ClientEvent; } });
+var errors_1 = require("./utils/errors");
+Object.defineProperty(exports, "SogniError", { enumerable: true, get: function () { return errors_1.SogniError; } });
+Object.defineProperty(exports, "SogniConnectionError", { enumerable: true, get: function () { return errors_1.SogniConnectionError; } });
+Object.defineProperty(exports, "SogniAuthenticationError", { enumerable: true, get: function () { return errors_1.SogniAuthenticationError; } });
+Object.defineProperty(exports, "SogniProjectError", { enumerable: true, get: function () { return errors_1.SogniProjectError; } });
+Object.defineProperty(exports, "SogniTimeoutError", { enumerable: true, get: function () { return errors_1.SogniTimeoutError; } });
+Object.defineProperty(exports, "SogniBalanceError", { enumerable: true, get: function () { return errors_1.SogniBalanceError; } });
+Object.defineProperty(exports, "SogniValidationError", { enumerable: true, get: function () { return errors_1.SogniValidationError; } });
+Object.defineProperty(exports, "SogniConfigurationError", { enumerable: true, get: function () { return errors_1.SogniConfigurationError; } });
+Object.defineProperty(exports, "SogniModelNotFoundError", { enumerable: true, get: function () { return errors_1.SogniModelNotFoundError; } });
+Object.defineProperty(exports, "SogniNetworkError", { enumerable: true, get: function () { return errors_1.SogniNetworkError; } });
+var helpers_1 = require("./utils/helpers");
+Object.defineProperty(exports, "generateAppId", { enumerable: true, get: function () { return helpers_1.generateAppId; } });
+Object.defineProperty(exports, "validateClientConfig", { enumerable: true, get: function () { return helpers_1.validateClientConfig; } });
+Object.defineProperty(exports, "validateProjectConfig", { enumerable: true, get: function () { return helpers_1.validateProjectConfig; } });
+Object.defineProperty(exports, "isImageProjectConfig", { enumerable: true, get: function () { return helpers_1.isImageProjectConfig; } });
+Object.defineProperty(exports, "isVideoProjectConfig", { enumerable: true, get: function () { return helpers_1.isVideoProjectConfig; } });
+Object.defineProperty(exports, "isAudioProjectConfig", { enumerable: true, get: function () { return helpers_1.isAudioProjectConfig; } });
+Object.defineProperty(exports, "isWanVideoModel", { enumerable: true, get: function () { return helpers_1.isWanVideoModel; } });
+Object.defineProperty(exports, "isLtxVideoModel", { enumerable: true, get: function () { return helpers_1.isLtxVideoModel; } });
+Object.defineProperty(exports, "isSeedanceVideoModel", { enumerable: true, get: function () { return helpers_1.isSeedanceVideoModel; } });
+Object.defineProperty(exports, "isCookieAuth", { enumerable: true, get: function () { return helpers_1.isCookieAuth; } });
+Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return helpers_1.sleep; } });
+Object.defineProperty(exports, "retry", { enumerable: true, get: function () { return helpers_1.retry; } });
+Object.defineProperty(exports, "formatBytes", { enumerable: true, get: function () { return helpers_1.formatBytes; } });
+Object.defineProperty(exports, "formatDuration", { enumerable: true, get: function () { return helpers_1.formatDuration; } });
+Object.defineProperty(exports, "getMaxContextImages", { enumerable: true, get: function () { return helpers_1.getMaxContextImages; } });
+Object.defineProperty(exports, "supportsContextImages", { enumerable: true, get: function () { return helpers_1.supportsContextImages; } });
+var sogni_client_1 = require("@sogni-ai/sogni-client");
+Object.defineProperty(exports, "ChatStream", { enumerable: true, get: function () { return sogni_client_1.ChatStream; } });
+Object.defineProperty(exports, "CreativeWorkflowsApi", { enumerable: true, get: function () { return sogni_client_1.CreativeWorkflowsApi; } });
+Object.defineProperty(exports, "SogniClient", { enumerable: true, get: function () { return sogni_client_1.SogniClient; } });
+Object.defineProperty(exports, "SogniTools", { enumerable: true, get: function () { return sogni_client_1.SogniTools; } });
+Object.defineProperty(exports, "isSogniToolCall", { enumerable: true, get: function () { return sogni_client_1.isSogniToolCall; } });
+Object.defineProperty(exports, "parseCreativeWorkflowSseChunk", { enumerable: true, get: function () { return sogni_client_1.parseCreativeWorkflowSseChunk; } });
+Object.defineProperty(exports, "parseToolCallArguments", { enumerable: true, get: function () { return sogni_client_1.parseToolCallArguments; } });
+var SogniClientWrapper_2 = require("./client/SogniClientWrapper");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return SogniClientWrapper_2.SogniClientWrapper; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAMA,kEAAiE;AAAxD,wHAAA,kBAAkB,OAAA;AAyF3B,iCAAsC;AAA7B,oGAAA,WAAW,OAAA;AAGpB,yCAWwB;AAVtB,oGAAA,UAAU,OAAA;AACV,8GAAA,oBAAoB,OAAA;AACpB,kHAAA,wBAAwB,OAAA;AACxB,2GAAA,iBAAiB,OAAA;AACjB,2GAAA,iBAAiB,OAAA;AACjB,2GAAA,iBAAiB,OAAA;AACjB,8GAAA,oBAAoB,OAAA;AACpB,iHAAA,uBAAuB,OAAA;AACvB,iHAAA,uBAAuB,OAAA;AACvB,2GAAA,iBAAiB,OAAA;AAInB,2CAiByB;AAhBvB,wGAAA,aAAa,OAAA;AACb,+GAAA,oBAAoB,OAAA;AACpB,gHAAA,qBAAqB,OAAA;AACrB,+GAAA,oBAAoB,OAAA;AACpB,+GAAA,oBAAoB,OAAA;AACpB,+GAAA,oBAAoB,OAAA;AACpB,0GAAA,eAAe,OAAA;AACf,0GAAA,eAAe,OAAA;AACf,+GAAA,oBAAoB,OAAA;AACpB,uGAAA,YAAY,OAAA;AACZ,gGAAA,KAAK,OAAA;AACL,gGAAA,KAAK,OAAA;AACL,sGAAA,WAAW,OAAA;AACX,yGAAA,cAAc,OAAA;AACd,8GAAA,mBAAmB,OAAA;AACnB,gHAAA,qBAAqB,OAAA;AAIvB,uDAQgC;AAP9B,0GAAA,UAAU,OAAA;AACV,oHAAA,oBAAoB,OAAA;AACpB,2GAAA,WAAW,OAAA;AACX,0GAAA,UAAU,OAAA;AACV,+GAAA,eAAe,OAAA;AACf,6HAAA,6BAA6B,OAAA;AAC7B,sHAAA,sBAAsB,OAAA;AAIxB,kEAA4E;AAAnE,6GAAA,kBAAkB,OAAW"}

package/dist/media/aspectRatio.d.ts

@@ -0,0 +1,15 @@
+export interface MediaDimensionBounds {
+    minDimension: number;
+    maxDimension: number;
+    maxAspectRatio?: number;
+    minPixels?: number;
+    maxPixels?: number;
+    label?: string;
+}
+export declare const DEFAULT_MAX_MEDIA_ASPECT_RATIO = 4;
+export declare function validateMediaAspectRatio(width: number, height: number, maxAspectRatio?: number): string | null;
+export declare function validateMediaDimensions(width: number, height: number, bounds: MediaDimensionBounds): string | null;
+export declare function validateMediaDimensionValue(value: number, bounds: MediaDimensionBounds, dimensionName?: string): string | null;
+export declare function validateMediaAspectRatioString(aspectRatio: string | undefined, bounds: MediaDimensionBounds): string | null;
+export declare const ASPECT_RATIO_DESCRIPTION = "Do NOT set unless the user explicitly requests an aspect ratio, format, orientation, or exact pixel dimensions. When a reference/source image is used and the user did not ask to change its shape, omit this field so the handler preserves the selected source image's own ratio.\n\nFormats: \"16:9\", \"9:16\", \"4:5\", \"1:1\", \"4:3\", \"3:2\", \"21:9\", or exact pixels like \"1920x1080\".\n\nCRITICAL: When the user specifies exact pixel dimensions (e.g., \"1280x720\", \"1080x1920\", \"1920x1080\", \"3840x2160\") or an orientation-qualified named resolution (e.g., \"720p landscape\", \"720p portrait\"), use the exact pixel format, NOT a ratio like \"16:9\" or \"9:16\". Exact user-requested dimensions override the selected default media quality, including Pro/HQ defaults. A bare named video resolution like \"720p resolution\" is only a resolution tier/short-side request; do not turn it into landscape pixels and do not set aspectRatio unless the user also states landscape, portrait, vertical, horizontal, or exact pixels. If requested pixels are in bounds but not on the model's pixel step, still pass the user's exact pixel request; the handler snaps to the nearest supported size internally. Only use ratio format when the user says a generic format name without pixel dimensions.\n\nMappings (use ONLY when user does NOT specify pixel dimensions): landscape/widescreen/YouTube/cinematic \u2192 \"16:9\". portrait \u2192 \"9:16\". TikTok/Reels/IG Reels \u2192 \"1080x1920\". ultrawide/cinema scope \u2192 \"21:9\". Instagram post \u2192 \"4:5\". square \u2192 \"1:1\". standard/TV \u2192 \"4:3\". 720p landscape \u2192 \"1280x720\". 720p portrait \u2192 \"720x1280\". 1080p landscape \u2192 \"1920x1080\". 1080p portrait/HD portrait \u2192 \"1080x1920\". 4K landscape \u2192 \"3840x2160\". 4K portrait \u2192 \"2160x3840\". Never set for generic requests like \"make a video\".";
+//# sourceMappingURL=aspectRatio.d.ts.map

package/dist/media/aspectRatio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aspectRatio.d.ts","sourceRoot":"","sources":["../../src/media/aspectRatio.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,cAAc,SAAiC,GAC9C,MAAM,GAAG,IAAI,CASf;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,GAC3B,MAAM,GAAG,IAAI,CAsBf;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,oBAAoB,EAC5B,aAAa,SAAc,GAC1B,MAAM,GAAG,IAAI,CAYf;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE,oBAAoB,GAC3B,MAAM,GAAG,IAAI,CAOf;AAED,eAAO,MAAM,wBAAwB,s2DAMgd,CAAC"}

package/dist/media/aspectRatio.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASPECT_RATIO_DESCRIPTION = exports.DEFAULT_MAX_MEDIA_ASPECT_RATIO = void 0;
+exports.validateMediaAspectRatio = validateMediaAspectRatio;
+exports.validateMediaDimensions = validateMediaDimensions;
+exports.validateMediaDimensionValue = validateMediaDimensionValue;
+exports.validateMediaAspectRatioString = validateMediaAspectRatioString;
+const imageDimensions_js_1 = require("./imageDimensions.js");
+exports.DEFAULT_MAX_MEDIA_ASPECT_RATIO = 4;
+function validateMediaAspectRatio(width, height, maxAspectRatio = exports.DEFAULT_MAX_MEDIA_ASPECT_RATIO) {
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+        return 'Resolution dimensions must be positive numbers.';
+    }
+    const ratio = Math.max(width, height) / Math.min(width, height);
+    if (ratio > maxAspectRatio) {
+        return `Aspect ratio ${width}:${height} is too extreme; use ${maxAspectRatio}:1 or less.`;
+    }
+    return null;
+}
+function validateMediaDimensions(width, height, bounds) {
+    if (!Number.isInteger(width) || !Number.isInteger(height)) {
+        return 'Resolution width and height must be whole pixel values.';
+    }
+    const label = bounds.label ? `${bounds.label} ` : '';
+    if (width < bounds.minDimension || height < bounds.minDimension) {
+        return `${label}resolution must be at least ${bounds.minDimension}px on each side.`;
+    }
+    if (width > bounds.maxDimension || height > bounds.maxDimension) {
+        return `${label}resolution must be ${bounds.maxDimension}px or less on each side.`;
+    }
+    const aspectError = validateMediaAspectRatio(width, height, bounds.maxAspectRatio);
+    if (aspectError)
+        return aspectError;
+    const pixels = width * height;
+    if (bounds.minPixels !== undefined && pixels < bounds.minPixels) {
+        return `${label}resolution must contain at least ${bounds.minPixels.toLocaleString()} total pixels.`;
+    }
+    if (bounds.maxPixels !== undefined && pixels > bounds.maxPixels) {
+        return `${label}resolution must contain ${bounds.maxPixels.toLocaleString()} total pixels or fewer.`;
+    }
+    return null;
+}
+function validateMediaDimensionValue(value, bounds, dimensionName = 'dimension') {
+    if (!Number.isInteger(value)) {
+        return `Resolution ${dimensionName} must be a whole pixel value.`;
+    }
+    const label = bounds.label ? `${bounds.label} ` : '';
+    if (value < bounds.minDimension) {
+        return `${label}resolution ${dimensionName} must be at least ${bounds.minDimension}px.`;
+    }
+    if (value > bounds.maxDimension) {
+        return `${label}resolution ${dimensionName} must be ${bounds.maxDimension}px or less.`;
+    }
+    return null;
+}
+function validateMediaAspectRatioString(aspectRatio, bounds) {
+    const parsed = (0, imageDimensions_js_1.parseAspectRatio)(aspectRatio);
+    if (!parsed)
+        return null;
+    if (parsed.type === 'exact') {
+        return validateMediaDimensions(parsed.width, parsed.height, bounds);
+    }
+    return validateMediaAspectRatio(parsed.ratioW, parsed.ratioH, bounds.maxAspectRatio);
+}
+exports.ASPECT_RATIO_DESCRIPTION = `Do NOT set unless the user explicitly requests an aspect ratio, format, orientation, or exact pixel dimensions. When a reference/source image is used and the user did not ask to change its shape, omit this field so the handler preserves the selected source image's own ratio.
+
+Formats: "16:9", "9:16", "4:5", "1:1", "4:3", "3:2", "21:9", or exact pixels like "1920x1080".
+
+CRITICAL: When the user specifies exact pixel dimensions (e.g., "1280x720", "1080x1920", "1920x1080", "3840x2160") or an orientation-qualified named resolution (e.g., "720p landscape", "720p portrait"), use the exact pixel format, NOT a ratio like "16:9" or "9:16". Exact user-requested dimensions override the selected default media quality, including Pro/HQ defaults. A bare named video resolution like "720p resolution" is only a resolution tier/short-side request; do not turn it into landscape pixels and do not set aspectRatio unless the user also states landscape, portrait, vertical, horizontal, or exact pixels. If requested pixels are in bounds but not on the model's pixel step, still pass the user's exact pixel request; the handler snaps to the nearest supported size internally. Only use ratio format when the user says a generic format name without pixel dimensions.
+
+Mappings (use ONLY when user does NOT specify pixel dimensions): landscape/widescreen/YouTube/cinematic → "16:9". portrait → "9:16". TikTok/Reels/IG Reels → "1080x1920". ultrawide/cinema scope → "21:9". Instagram post → "4:5". square → "1:1". standard/TV → "4:3". 720p landscape → "1280x720". 720p portrait → "720x1280". 1080p landscape → "1920x1080". 1080p portrait/HD portrait → "1080x1920". 4K landscape → "3840x2160". 4K portrait → "2160x3840". Never set for generic requests like "make a video".`;
+//# sourceMappingURL=aspectRatio.js.map

package/dist/media/aspectRatio.js.map

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

package/dist/media/audioReference.d.ts

@@ -0,0 +1,57 @@
+export type ReferenceAudioFormat = 'mp3' | 'm4a' | 'wav' | 'flac' | 'ogg' | 'unknown';
+export interface PreparedReferenceAudio {
+    data: Uint8Array;
+    mimeType: string;
+    sourceFormat: ReferenceAudioFormat;
+    transcoded: boolean;
+    trimmed: boolean;
+    requestedDuration?: number;
+    startOffset?: number;
+    sourceDuration?: number;
+}
+export interface ReferenceAudioTranscodeRequest {
+    data: Uint8Array;
+    filename: string;
+    inputMimeType: string;
+    sourceFormat: ReferenceAudioFormat;
+}
+export interface ReferenceAudioTranscodeResult {
+    data: Uint8Array;
+    mimeType?: string | null;
+}
+export type ReferenceAudioTranscoder = (request: ReferenceAudioTranscodeRequest) => Promise<ReferenceAudioTranscodeResult>;
+export declare const SEEDANCE_R2V_REFERENCE_AUDIO_MAX_DURATION_SECONDS = 15.2;
+export interface ReferenceAudioTrimRequest {
+    data: Uint8Array;
+    filename: string;
+    inputMimeType: string;
+    sourceFormat: ReferenceAudioFormat;
+    duration: number;
+    start: number;
+}
+export interface ReferenceAudioTrimResult {
+    data: Uint8Array;
+    mimeType?: string | null;
+}
+export type ReferenceAudioTrimmer = (request: ReferenceAudioTrimRequest) => Promise<ReferenceAudioTrimResult>;
+export interface PrepareReferenceAudioOptions {
+    transcodeToM4a?: ReferenceAudioTranscoder;
+    transcodeToMp3?: ReferenceAudioTranscoder;
+    transcodeMp3?: ReferenceAudioTranscoder;
+    trimAudio?: ReferenceAudioTrimmer;
+    sourceDurationSeconds?: number;
+    maxDurationSeconds?: number;
+    startOffsetSeconds?: number;
+    normalizeToM4a?: boolean;
+    normalizeToMp3?: boolean;
+}
+export declare function normalizeReferenceAudioMimeType(mimeType?: string | null): string;
+export declare function detectReferenceAudioFormat(data: Uint8Array, mimeType?: string | null): ReferenceAudioFormat;
+export declare function shouldTrimSeedanceReferenceAudio(input: {
+    sourceDurationSeconds?: number;
+    maxDurationSeconds?: number;
+    startOffsetSeconds?: number;
+}): boolean;
+export declare function prepareReferenceAudioForVideo(data: Uint8Array, mimeType?: string | null, filename?: string, options?: PrepareReferenceAudioOptions): Promise<PreparedReferenceAudio>;
+export declare function prepareSeedanceReferenceAudioForVideo(data: Uint8Array, mimeType?: string | null, filename?: string, options?: PrepareReferenceAudioOptions): Promise<PreparedReferenceAudio>;
+//# sourceMappingURL=audioReference.d.ts.map

package/dist/media/audioReference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioReference.d.ts","sourceRoot":"","sources":["../../src/media/audioReference.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAEtF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,oBAAoB,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,oBAAoB,CAAC;CACpC;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,8BAA8B,KACpC,OAAO,CAAC,6BAA6B,CAAC,CAAC;AAE5C,eAAO,MAAM,iDAAiD,OAAO,CAAC;AAEtE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,oBAAoB,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAEvC,MAAM,WAAW,4BAA4B;IAE3C,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAE1C,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAE1C,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAM5B,cAAc,CAAC,EAAE,OAAO,CAAC;IAKzB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAWD,wBAAgB,+BAA+B,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGhF;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,oBAAoB,CAmCtB;AA+BD,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,OAAO,CAaV;AAED,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,SAAoB,EAC5B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,sBAAsB,CAAC,CA4DjC;AAED,wBAAsB,qCAAqC,CACzD,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,SAAoB,EAC5B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,sBAAsB,CAAC,CA4DjC"}