@sogni-ai/sogni-intelligence-client 4.5.2 → 4.6.0

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

@@ -1 +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,oFAAoF,CAAC;AAEjH,MAAM,CAAC,MAAM,kCAAkC,GAC7C,gMAAgM,CAAC;AAEnM,MAAM,CAAC,MAAM,iDAAiD,GAC5D,ikBAAikB,CAAC;AAEpkB,MAAM,CAAC,MAAM,gDAAgD,GAC3D,ipBAAipB,CAAC;AAEppB,MAAM,CAAC,MAAM,gCAAgC,GAC3C,GAAG,uBAAuB,iDAAiD,CAAC;AAE9E,MAAM,CAAC,MAAM,2CAA2C,GAAG,ygBAAygB,CAAC;AAErkB,MAAM,CAAC,MAAM,oCAAoC,GAAG,oQAAoQ,CAAC;AAEzT,MAAM,CAAC,MAAM,sCAAsC,GAAG,+VAA+V,CAAC;AAEtZ,MAAM,CAAC,MAAM,kCAAkC,GAAG,khBAAkhB,CAAC;AAErkB,MAAM,CAAC,MAAM,2CAA2C,GACtD,mgBAAmgB;IACngB,kCAAkC,CAAC;AAOrC,MAAM,CAAC,MAAM,0DAA0D,GACrE,ilBAAilB,CAAC;AAEplB,MAAM,CAAC,MAAM,uDAAuD,GAClE,8xDAA8xD,CAAC;AAEjyD,MAAM,CAAC,MAAM,kDAAkD,GAC7D,mdAAmd,CAAC;AAEtd,MAAM,CAAC,MAAM,qDAAqD,GAChE,+OAA+O,CAAC;AAElP,MAAM,CAAC,MAAM,8CAA8C,GACzD,yHAAyH,CAAC;AAE5H,MAAM,CAAC,MAAM,2CAA2C,GACtD,uOAAuO,CAAC;AAE1O,MAAM,CAAC,MAAM,iDAAiD,GAC5D,sHAAsH,CAAC;AAEzH,MAAM,CAAC,MAAM,kDAAkD,GAC7D,+IAA+I,CAAC;AAElJ,MAAM,CAAC,MAAM,yCAAyC,GACpD,oXAAoX,CAAC"}
+{"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,oFAAoF,CAAC;AAEjH,MAAM,CAAC,MAAM,kCAAkC,GAC7C,gMAAgM,CAAC;AAEnM,MAAM,CAAC,MAAM,iDAAiD,GAC5D,ikBAAikB,CAAC;AAEpkB,MAAM,CAAC,MAAM,gDAAgD,GAC3D,ipBAAipB,CAAC;AAEppB,MAAM,CAAC,MAAM,gCAAgC,GAC3C,GAAG,uBAAuB,iDAAiD,CAAC;AAE9E,MAAM,CAAC,MAAM,2CAA2C,GAAG,ygBAAygB,CAAC;AAErkB,MAAM,CAAC,MAAM,oCAAoC,GAAG,oQAAoQ,CAAC;AAEzT,MAAM,CAAC,MAAM,sCAAsC,GAAG,+VAA+V,CAAC;AAEtZ,MAAM,CAAC,MAAM,kCAAkC,GAAG,khBAAkhB,CAAC;AAErkB,MAAM,CAAC,MAAM,2CAA2C,GACtD,mgBAAmgB;IACngB,kCAAkC,CAAC;AAOrC,MAAM,CAAC,MAAM,0DAA0D,GACrE,ilBAAilB,CAAC;AAEplB,MAAM,CAAC,MAAM,uDAAuD,GAClE,8xDAA8xD,CAAC;AAEjyD,MAAM,CAAC,MAAM,kDAAkD,GAC7D,mdAAmd,CAAC;AAEtd,MAAM,CAAC,MAAM,qDAAqD,GAChE,+OAA+O,CAAC;AAElP,MAAM,CAAC,MAAM,8CAA8C,GACzD,yHAAyH,CAAC;AAE5H,MAAM,CAAC,MAAM,2CAA2C,GACtD,uOAAuO,CAAC;AAE1O,MAAM,CAAC,MAAM,iDAAiD,GAC5D,sHAAsH,CAAC;AAEzH,MAAM,CAAC,MAAM,kDAAkD,GAC7D,+IAA+I,CAAC;AASlJ,MAAM,CAAC,MAAM,gCAAgC,GAC3C,ulBAAulB,CAAC;AAE1lB,MAAM,CAAC,MAAM,2CAA2C,GACtD,sIAAsI,CAAC;AAEzI,MAAM,CAAC,MAAM,0CAA0C,GACrD,yJAAyJ,CAAC;AAE5J,MAAM,CAAC,MAAM,8CAA8C,GACzD,GAAG,gCAAgC,+UAA+U,CAAC;AAErX,MAAM,CAAC,MAAM,+CAA+C,GAC1D,GAAG,gCAAgC,ilBAAilB,CAAC;AAEvnB,MAAM,CAAC,MAAM,+CAA+C,GAC1D,GAAG,gCAAgC,qYAAqY,CAAC;AAE3a,MAAM,CAAC,MAAM,6BAA6B,GACxC,gsBAAgsB,CAAC;AAEnsB,MAAM,CAAC,MAAM,yCAAyC,GACpD,oXAAoX,CAAC"}

package/dist-esm/media/index.js

@@ -1,5 +1,6 @@
 export * from './imageDimensions.js';
 export * from './videoSettings.js';
+export * from './minimaxH3Keyframes.js';
 export * from './aspectRatio.js';
 export * from './gptImage.js';
 export * from './characterSheet.js';

package/dist-esm/media/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist-esm/media/minimaxH3Keyframes.js

@@ -0,0 +1,168 @@
+import { calculateVideoFrames, isMinimaxH3AudioGuideModelId } from './videoSettings.js';
+export const MINIMAX_H3_MAX_KEYFRAMES = 8;
+export const MINIMAX_H3_KEYFRAME_FPS = 24;
+const MINIMAX_H3_SHORTEST_CLIP_FRAMES = 124;
+const MINIMAX_H3_FRAME_STEP = 17;
+const MINIMAX_H3_LONGEST_CLIP_FRAMES = 362;
+const KEYFRAME_WORKFLOWS = new Set([
+    'i2v',
+    'flf2v',
+    'ia2v',
+    'flfa2v',
+    'a2v',
+    'r2v',
+]);
+export function minimaxH3KeyframeWorkflow(modelId) {
+    if (typeof modelId !== 'string')
+        return null;
+    const normalized = modelId.trim().toLowerCase().replace(/[\s_.]+/g, '-').replace(/-+/g, '-');
+    if (!normalized.startsWith('minimax-h3-'))
+        return null;
+    const workflow = normalized.split('-').find(token => KEYFRAME_WORKFLOWS.has(token));
+    return workflow ?? null;
+}
+export function isMinimaxH3KeyframeModelId(modelId) {
+    return minimaxH3KeyframeWorkflow(modelId) !== null;
+}
+export function minimaxH3KeyframeFrameIndex(atSeconds) {
+    return Math.round(atSeconds * MINIMAX_H3_KEYFRAME_FPS);
+}
+export function minimaxH3KeyframeSeconds(frameIndex) {
+    return frameIndex / MINIMAX_H3_KEYFRAME_FPS;
+}
+export function minimaxH3FramesForDuration(durationSeconds) {
+    if (!Number.isFinite(durationSeconds) || durationSeconds <= 0) {
+        throw new RangeError(`MiniMax H3 duration must be a finite number of seconds greater than 0; received ${String(durationSeconds)}`);
+    }
+    return calculateVideoFrames(durationSeconds, 'minimax-h3-i2v');
+}
+export function minimaxH3AudioGuideFramesForDuration(durationSeconds) {
+    if (!Number.isFinite(durationSeconds) || durationSeconds <= 0) {
+        throw new RangeError(`MiniMax H3 duration must be a finite number of seconds greater than 0; received ${String(durationSeconds)}`);
+    }
+    const neededFrames = Math.ceil(durationSeconds * MINIMAX_H3_KEYFRAME_FPS - 1e-6);
+    const steps = Math.max(0, Math.ceil((neededFrames - MINIMAX_H3_SHORTEST_CLIP_FRAMES) / MINIMAX_H3_FRAME_STEP));
+    return Math.min(MINIMAX_H3_LONGEST_CLIP_FRAMES, MINIMAX_H3_SHORTEST_CLIP_FRAMES + steps * MINIMAX_H3_FRAME_STEP);
+}
+export function minimaxH3JobFramesForDuration(modelId, durationSeconds) {
+    return isMinimaxH3AudioGuideModelId(modelId)
+        ? minimaxH3AudioGuideFramesForDuration(durationSeconds)
+        : minimaxH3FramesForDuration(durationSeconds);
+}
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function formatClipSeconds(seconds) {
+    const rounded = Math.round(seconds * 100) / 100;
+    return Number.isInteger(rounded) ? rounded.toFixed(1) : String(rounded);
+}
+function keyframeWindow(frames) {
+    const latest = Math.floor(((frames - 2) / MINIMAX_H3_KEYFRAME_FPS) * 10 + 1e-9) / 10;
+    return { earliest: '0.1', latest: latest.toFixed(1) };
+}
+function shortestDurationFor(frameIndex, modelId) {
+    const neededFrames = frameIndex + 2;
+    if (neededFrames > MINIMAX_H3_LONGEST_CLIP_FRAMES)
+        return null;
+    let seconds = Math.max(1, Math.floor(neededFrames / MINIMAX_H3_KEYFRAME_FPS));
+    while (minimaxH3JobFramesForDuration(modelId, seconds) < neededFrames)
+        seconds += 1;
+    return seconds;
+}
+export function minimaxH3KeyframeEdgeHint(modelId) {
+    switch (minimaxH3KeyframeWorkflow(modelId)) {
+        case 'i2v':
+        case 'flf2v':
+        case 'flfa2v':
+            return 'the first and last frames come from sourceImageIndex and endImageIndex';
+        case 'ia2v':
+            return 'the first frame comes from sourceImageIndex, and the last frame cannot be pinned';
+        case 'a2v':
+            return 'audio-only clips cannot pin their first or last frame';
+        case 'r2v':
+            return 'reference-to-video cannot pin its first or last frame';
+        default:
+            return 'the first and last frames are never keyframes';
+    }
+}
+export function checkMinimaxH3Keyframes(keyframes, options = {}) {
+    const errors = [];
+    if (keyframes === undefined || keyframes === null) {
+        return { ok: true, errors, keyframes: [] };
+    }
+    if (!Array.isArray(keyframes)) {
+        errors.push('"keyframes" must be a list of {imageIndex, atSeconds} items.');
+        return { ok: false, errors, keyframes: [] };
+    }
+    if (keyframes.length > MINIMAX_H3_MAX_KEYFRAMES) {
+        const extra = keyframes.length - MINIMAX_H3_MAX_KEYFRAMES;
+        errors.push(`"keyframes" has ${keyframes.length} items; MiniMax H3 pins at most ${MINIMAX_H3_MAX_KEYFRAMES}. Remove ${extra} of them.`);
+    }
+    const frames = options.frames;
+    if (frames !== undefined && (!Number.isInteger(frames) || frames < 3)) {
+        throw new RangeError(`MiniMax H3 keyframes need the job's frame count; received ${String(frames)}`);
+    }
+    const lastPinnable = (frames ?? MINIMAX_H3_LONGEST_CLIP_FRAMES) - 2;
+    const window = keyframeWindow(lastPinnable + 2);
+    const keep = `keep keyframes between ${window.earliest} s and ${window.latest} s`;
+    const edge = options.edgeHint ? ` (${options.edgeHint})` : '';
+    const checked = [];
+    keyframes.forEach((entry, argumentIndex) => {
+        const label = `keyframes[${argumentIndex}]`;
+        if (!isRecord(entry)) {
+            errors.push(`${label} must be an object {imageIndex, atSeconds}.`);
+            return;
+        }
+        const { imageIndex, atSeconds } = entry;
+        let wellFormed = true;
+        if (typeof imageIndex !== 'number' || !Number.isInteger(imageIndex)) {
+            errors.push(`${label}.imageIndex must be a whole-number image index (-1 = first upload, -2 = second upload, 0 and up = generated results).`);
+            wellFormed = false;
+        }
+        if (typeof atSeconds !== 'number' || !Number.isFinite(atSeconds)) {
+            errors.push(`${label}.atSeconds must be a number of seconds from the start of the video.`);
+            wellFormed = false;
+        }
+        if (!wellFormed)
+            return;
+        const seconds = atSeconds;
+        const frameIndex = minimaxH3KeyframeFrameIndex(seconds);
+        if (seconds < 0) {
+            errors.push(`${label} at ${seconds} s is before the video starts; ${keep}.`);
+            return;
+        }
+        if (frameIndex < 1) {
+            errors.push(`${label} at ${seconds} s lands on the first frame, which is never a keyframe${edge}; ${keep}.`);
+            return;
+        }
+        if (frames !== undefined && frameIndex === frames - 1) {
+            errors.push(`${label} at ${seconds} s lands on the last frame of the ${formatClipSeconds(frames / MINIMAX_H3_KEYFRAME_FPS)} s clip, which is never a keyframe${edge}; ${keep}.`);
+            return;
+        }
+        if (frameIndex > lastPinnable) {
+            if (frames === undefined) {
+                errors.push(`${label} at ${seconds} s is at or past the end of the longest MiniMax H3 clip (${formatClipSeconds(MINIMAX_H3_LONGEST_CLIP_FRAMES / MINIMAX_H3_KEYFRAME_FPS)} s); ${keep}.`);
+                return;
+            }
+            const source = options.framesSource ? ` (${options.framesSource})` : '';
+            const longer = options.suggestDuration ? shortestDurationFor(frameIndex, options.modelId) : null;
+            errors.push(`${label} at ${seconds} s is past the ${formatClipSeconds(frames / MINIMAX_H3_KEYFRAME_FPS)} s clip${source}; ${keep}${longer ? `, or set duration to at least ${longer} s` : ''}.`);
+            return;
+        }
+        checked.push({ imageIndex: imageIndex, atSeconds: seconds, argumentIndex, frameIndex });
+    });
+    const byFrame = new Map();
+    for (const keyframe of checked) {
+        const earlier = byFrame.get(keyframe.frameIndex);
+        if (earlier) {
+            errors.push(`keyframes[${earlier.argumentIndex}] and keyframes[${keyframe.argumentIndex}] both land on frame ${keyframe.frameIndex} (${formatClipSeconds(minimaxH3KeyframeSeconds(keyframe.frameIndex))} s); give each keyframe its own time, at least 0.1 s apart.`);
+            continue;
+        }
+        byFrame.set(keyframe.frameIndex, keyframe);
+    }
+    const sorted = [...checked].sort((left, right) => left.frameIndex - right.frameIndex);
+    return errors.length === 0
+        ? { ok: true, errors, keyframes: sorted }
+        : { ok: false, errors, keyframes: [] };
+}
+//# sourceMappingURL=minimaxH3Keyframes.js.map

package/dist-esm/media/minimaxH3Keyframes.js.map

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

package/dist-esm/public-skill-runtime/index.js

@@ -5,6 +5,7 @@ import { resolveRegisteredVideoModelFamily } from '../utils/videoModelIds.js';
 import { resolveRegisteredImageReferenceModelId } from '../utils/imageReferenceModelIds.js';
 import { isGptImageModel, normalizeGptImageModelAlias } from '../media/gptImage.js';
 import { WAN22_MAX_VIDEO_PIXELS } from '../media/videoSettings.js';
+import { MINIMAX_H3_KEYFRAMES_GUIDANCE } from '../contracts/toolPromptMarkers.js';
 function isLtxWorkflow(workflow) {
     return workflow === 't2v' || workflow === 'i2v' || workflow === 'ia2v' || workflow === 'a2v' || workflow === 'v2v';
 }
@@ -666,6 +667,7 @@ export const VIDEO_GENERATION_SKILL = {
         'For My Personas video requests, default to image_editing first to produce a conditioned scene image before animation. Use direct video only when the user explicitly asks to animate an existing persona image/reference or no source image is available for a voice-only request.',
         'Wan 3.0 Enhanced uses exact Sogni model id wan3.0-spicy-video (MuleRouter provider id w3.0-video): 2-30 seconds at 30 fps, 480p/720p/1080p, native audio, prompt expansion, adaptive/fixed ratios, and up to 10 image/5 video/5 audio references. First/last-frame mode and loose-reference mode are mutually exclusive. It has no document/web context, watermark, negative prompt, source-video edit, or extend mode.',
         'MiniMax H3 two-stage: 1080p and 2K H3 delivery is its own selector, not an option. minimax-h3-fasth3-t2v-turbo-2stage on generate_video (animate_photo carries minimax-h3-fasth3-i2v-turbo-2stage and minimax-h3-fasth3-flf2v-turbo-2stage) renders the FastH3 canvas, then the worker enlarges it 2x and refines it, so the clip is delivered at twice the canvas with the same length and audio. targetResolution names the delivered class: 1080 renders a 544px short-edge canvas (960x544 becomes 1920x1088) for 10 Spark per second, 1440 or omitted renders the 768p canvas for 2K (1344x768 becomes 2688x1536) for 16 Spark per second, and 720 renders a 384px canvas (672x384 becomes 1344x768) for the regular FastH3 price of 4 Spark per second. Choose it when the user asks for 1080p, 1440p or 2K H3 output, for two-stage output, or for the sharpest/best H3 quality, and send the same prompt contract, durations and LoRAs as the matching FastH3 selector; keep ordinary 768p FastH3 output on the regular FastH3 selector at targetResolution 768. Reference-to-video has its own two-stage selectors on generate_video: minimax-h3-r2v-2stage (Standard, 20 steps) and minimax-h3-r2v-balanced-2stage (Balanced, 8 steps) take exactly the references, prompt contract, durations and LoRAs of minimax-h3-r2v and minimax-h3-r2v-balanced, deliver twice the canvas, and read targetResolution the same way; each bills its tier\'s rate plus the two-stage surcharge of the delivered class. Keep the one-stage R2V selectors for ordinary 768p output.',
+        `${MINIMAX_H3_KEYFRAMES_GUIDANCE} On generate_video only the MiniMax H3 reference-to-video selectors take keyframes, never text-to-video; the keyframe images are not references and do not go in referenceImageIndices.`,
     ],
 };
 export const VIDEO_EDITING_SKILL = {
@@ -690,6 +692,7 @@ export const VIDEO_EDITING_SKILL = {
         'animate_photo errors with all_failed must surface to the user; do not auto-retry from inside the chat loop.',
         'Use upscale_video for a promptless 1080p/1440p resolution increase of an existing video; it keeps every frame, the frame rate, and the audio. Do not substitute video_to_video unless the user explicitly asks a generative model such as Seedance to re-render the clip.',
         'MiniMax H3 audio guide: sound_to_video takes minimax-h3-fasth3-ia2v-turbo (first-frame image + audio), minimax-h3-fasth3-flfa2v-turbo (first and last frame + audio, with endImageIndex) and minimax-h3-fasth3-a2v-turbo (audio only), each with a -2stage form for 1080p or 2K output. The uploaded audio drives the picture from frame 0 and stays in the output; clips are 5.2-15.1 seconds at 24 fps, audioStart picks the window, and MiniMax H3 catalog and Personal LoRAs work across audio modes and tiers; generateAudio false and negativePrompt are refused. Use them only when the user asks for MiniMax H3 or FastH3; the LTX 2.5 audio selectors stay the default.',
+        `${MINIMAX_H3_KEYFRAMES_GUIDANCE} animate_photo takes keyframes on every MiniMax H3 image-to-video and first-and-last-frame selector, and sound_to_video on every MiniMax H3 audio selector (set duration with keyframes; the audio selectors render the shortest H3 length that covers it, so duration 6 renders 6.58 s).`,
     ],
 };
 export const MUSIC_GENERATION_SKILL = {