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

package/dist/tools/definitions/generate-video/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/tools/definitions/generate-video/definition.ts"],"names":[],"mappings":";;;AAMA,kFAKiD;AACjD,sDAAmE;AAEtD,QAAA,UAAU,GAAmB;IACxC,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,m1IAAm1I;QACr1I,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE;;EAErB,oDAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;uQA0BwO;iBAC9P;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,yDAAkC;iBAChD;gBACD,oBAAoB,EAAE;oBACpB,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,wEAAiD;iBAC/D;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,8GAA8G;oBAChH,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,EAAE;iBACZ;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,0PAA0P;iBAC7P;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,CAAC;oBACvD,WAAW,EACT,i+BAAi+B;wBACj+B,kEAA2C;iBAC9C;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,oKAAoK;iBACvK;gBACD,qBAAqB,EAAE;oBACrB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EACT,w0BAAw0B;iBAC30B;gBACD,qBAAqB,EAAE;oBACrB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EACT,mfAAmf;iBACtf;gBACD,qBAAqB,EAAE;oBACrB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EACT,6sBAA6sB;iBAChtB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,i/BAAi/B;iBACp/B;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,urBAAurB;iBAC1rB;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,kyBAAkyB;iBACryB;gBACD,kBAAkB,EAAE;oBAClB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,wLAAwL;oBAC1L,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,EAAE;iBACZ;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAwB;iBACtC;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,8jBAA8jB;iBACjkB;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC"}

package/dist/tools/definitions/index.d.ts

@@ -0,0 +1,25 @@
+import { definition as generateImageDefinition } from './generate-image/definition.js';
+import { definition as generateVideoDefinition } from './generate-video/definition.js';
+import { definition as generateMusicDefinition } from './generate-music/definition.js';
+import { definition as editImageDefinition } from './edit-image/definition.js';
+import { definition as applyStyleDefinition } from './apply-style/definition.js';
+import { definition as restorePhotoDefinition } from './restore-photo/definition.js';
+import { definition as refineResultDefinition } from './refine-result/definition.js';
+import { definition as animatePhotoDefinition } from './animate-photo/definition.js';
+import { definition as changeAngleDefinition } from './change-angle/definition.js';
+import { definition as videoToVideoDefinition } from './video-to-video/definition.js';
+import { definition as stitchVideoDefinition, STITCH_TRANSITION_TYPES } from './stitch-video/definition.js';
+import { definition as orbitVideoDefinition } from './orbit-video/definition.js';
+import { definition as danceMontageDefinition } from './dance-montage/definition.js';
+import { definition as soundToVideoDefinition } from './sound-to-video/definition.js';
+import { definition as extendVideoDefinition } from './extend-video/definition.js';
+import { definition as replaceVideoSegmentDefinition } from './replace-video-segment/definition.js';
+import { definition as overlayVideoDefinition, OVERLAY_POSITIONS } from './overlay-video/definition.js';
+import { definition as addSubtitlesDefinition, SUBTITLE_VERTICAL_POSITIONS } from './add-subtitles/definition.js';
+import type { ToolDefinition } from './types.js';
+export { addSubtitlesDefinition, animatePhotoDefinition, applyStyleDefinition, changeAngleDefinition, danceMontageDefinition, editImageDefinition, extendVideoDefinition, generateImageDefinition, generateMusicDefinition, generateVideoDefinition, orbitVideoDefinition, overlayVideoDefinition, refineResultDefinition, replaceVideoSegmentDefinition, restorePhotoDefinition, soundToVideoDefinition, stitchVideoDefinition, videoToVideoDefinition, OVERLAY_POSITIONS, STITCH_TRANSITION_TYPES, SUBTITLE_VERTICAL_POSITIONS, };
+export declare const generationToolDefinitions: readonly [ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition, ToolDefinition];
+export { DANCE_PRESETS, resolveDancePresetForRequest } from './dance-montage/dances.js';
+export type { DancePreset } from './dance-montage/dances.js';
+export type { ToolDefinition } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,UAAU,IAAI,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,UAAU,IAAI,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,UAAU,IAAI,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,UAAU,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,UAAU,IAAI,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,UAAU,IAAI,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,UAAU,IAAI,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,UAAU,IAAI,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,IAAI,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EACL,UAAU,IAAI,qBAAqB,EACnC,uBAAuB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,UAAU,IAAI,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,UAAU,IAAI,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,UAAU,IAAI,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,IAAI,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AACpG,OAAO,EACL,UAAU,IAAI,sBAAsB,EACpC,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,UAAU,IAAI,sBAAsB,EACpC,2BAA2B,EAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,GAC5B,CAAC;AAEF,eAAO,MAAM,yBAAyB,2SAmBQ,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACxF,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/definitions/index.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDancePresetForRequest = exports.DANCE_PRESETS = exports.generationToolDefinitions = exports.SUBTITLE_VERTICAL_POSITIONS = exports.STITCH_TRANSITION_TYPES = exports.OVERLAY_POSITIONS = exports.videoToVideoDefinition = exports.stitchVideoDefinition = exports.soundToVideoDefinition = exports.restorePhotoDefinition = exports.replaceVideoSegmentDefinition = exports.refineResultDefinition = exports.overlayVideoDefinition = exports.orbitVideoDefinition = exports.generateVideoDefinition = exports.generateMusicDefinition = exports.generateImageDefinition = exports.extendVideoDefinition = exports.editImageDefinition = exports.danceMontageDefinition = exports.changeAngleDefinition = exports.applyStyleDefinition = exports.animatePhotoDefinition = exports.addSubtitlesDefinition = void 0;
+const definition_js_1 = require("./generate-image/definition.js");
+Object.defineProperty(exports, "generateImageDefinition", { enumerable: true, get: function () { return definition_js_1.definition; } });
+const definition_js_2 = require("./generate-video/definition.js");
+Object.defineProperty(exports, "generateVideoDefinition", { enumerable: true, get: function () { return definition_js_2.definition; } });
+const definition_js_3 = require("./generate-music/definition.js");
+Object.defineProperty(exports, "generateMusicDefinition", { enumerable: true, get: function () { return definition_js_3.definition; } });
+const definition_js_4 = require("./edit-image/definition.js");
+Object.defineProperty(exports, "editImageDefinition", { enumerable: true, get: function () { return definition_js_4.definition; } });
+const definition_js_5 = require("./apply-style/definition.js");
+Object.defineProperty(exports, "applyStyleDefinition", { enumerable: true, get: function () { return definition_js_5.definition; } });
+const definition_js_6 = require("./restore-photo/definition.js");
+Object.defineProperty(exports, "restorePhotoDefinition", { enumerable: true, get: function () { return definition_js_6.definition; } });
+const definition_js_7 = require("./refine-result/definition.js");
+Object.defineProperty(exports, "refineResultDefinition", { enumerable: true, get: function () { return definition_js_7.definition; } });
+const definition_js_8 = require("./animate-photo/definition.js");
+Object.defineProperty(exports, "animatePhotoDefinition", { enumerable: true, get: function () { return definition_js_8.definition; } });
+const definition_js_9 = require("./change-angle/definition.js");
+Object.defineProperty(exports, "changeAngleDefinition", { enumerable: true, get: function () { return definition_js_9.definition; } });
+const definition_js_10 = require("./video-to-video/definition.js");
+Object.defineProperty(exports, "videoToVideoDefinition", { enumerable: true, get: function () { return definition_js_10.definition; } });
+const definition_js_11 = require("./stitch-video/definition.js");
+Object.defineProperty(exports, "stitchVideoDefinition", { enumerable: true, get: function () { return definition_js_11.definition; } });
+Object.defineProperty(exports, "STITCH_TRANSITION_TYPES", { enumerable: true, get: function () { return definition_js_11.STITCH_TRANSITION_TYPES; } });
+const definition_js_12 = require("./orbit-video/definition.js");
+Object.defineProperty(exports, "orbitVideoDefinition", { enumerable: true, get: function () { return definition_js_12.definition; } });
+const definition_js_13 = require("./dance-montage/definition.js");
+Object.defineProperty(exports, "danceMontageDefinition", { enumerable: true, get: function () { return definition_js_13.definition; } });
+const definition_js_14 = require("./sound-to-video/definition.js");
+Object.defineProperty(exports, "soundToVideoDefinition", { enumerable: true, get: function () { return definition_js_14.definition; } });
+const definition_js_15 = require("./extend-video/definition.js");
+Object.defineProperty(exports, "extendVideoDefinition", { enumerable: true, get: function () { return definition_js_15.definition; } });
+const definition_js_16 = require("./replace-video-segment/definition.js");
+Object.defineProperty(exports, "replaceVideoSegmentDefinition", { enumerable: true, get: function () { return definition_js_16.definition; } });
+const definition_js_17 = require("./overlay-video/definition.js");
+Object.defineProperty(exports, "overlayVideoDefinition", { enumerable: true, get: function () { return definition_js_17.definition; } });
+Object.defineProperty(exports, "OVERLAY_POSITIONS", { enumerable: true, get: function () { return definition_js_17.OVERLAY_POSITIONS; } });
+const definition_js_18 = require("./add-subtitles/definition.js");
+Object.defineProperty(exports, "addSubtitlesDefinition", { enumerable: true, get: function () { return definition_js_18.definition; } });
+Object.defineProperty(exports, "SUBTITLE_VERTICAL_POSITIONS", { enumerable: true, get: function () { return definition_js_18.SUBTITLE_VERTICAL_POSITIONS; } });
+exports.generationToolDefinitions = [
+    definition_js_1.definition,
+    definition_js_2.definition,
+    definition_js_3.definition,
+    definition_js_4.definition,
+    definition_js_5.definition,
+    definition_js_6.definition,
+    definition_js_7.definition,
+    definition_js_8.definition,
+    definition_js_9.definition,
+    definition_js_10.definition,
+    definition_js_11.definition,
+    definition_js_12.definition,
+    definition_js_13.definition,
+    definition_js_14.definition,
+    definition_js_15.definition,
+    definition_js_16.definition,
+    definition_js_17.definition,
+    definition_js_18.definition,
+];
+var dances_js_1 = require("./dance-montage/dances.js");
+Object.defineProperty(exports, "DANCE_PRESETS", { enumerable: true, get: function () { return dances_js_1.DANCE_PRESETS; } });
+Object.defineProperty(exports, "resolveDancePresetForRequest", { enumerable: true, get: function () { return dances_js_1.resolveDancePresetForRequest; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/definitions/index.ts"],"names":[],"mappings":";;;AAAA,kEAAuF;AAqCrF,wGArCqB,0BAAuB,OAqCrB;AApCzB,kEAAuF;AAsCrF,wGAtCqB,0BAAuB,OAsCrB;AArCzB,kEAAuF;AAoCrF,wGApCqB,0BAAuB,OAoCrB;AAnCzB,8DAA+E;AAgC7E,oGAhCqB,0BAAmB,OAgCrB;AA/BrB,+DAAiF;AA4B/E,qGA5BqB,0BAAoB,OA4BrB;AA3BtB,iEAAqF;AAuCnF,uGAvCqB,0BAAsB,OAuCrB;AAtCxB,iEAAqF;AAoCnF,uGApCqB,0BAAsB,OAoCrB;AAnCxB,iEAAqF;AAwBnF,uGAxBqB,0BAAsB,OAwBrB;AAvBxB,gEAAmF;AAyBjF,sGAzBqB,0BAAqB,OAyBrB;AAxBvB,mEAAsF;AAsCpF,uGAtCqB,2BAAsB,OAsCrB;AArCxB,iEAGsC;AAiCpC,sGAnCc,2BAAqB,OAmCd;AAGrB,wGArCA,wCAAuB,OAqCA;AAnCzB,gEAAiF;AA0B/E,qGA1BqB,2BAAoB,OA0BrB;AAzBtB,kEAAqF;AAmBnF,uGAnBqB,2BAAsB,OAmBrB;AAlBxB,mEAAsF;AA6BpF,uGA7BqB,2BAAsB,OA6BrB;AA5BxB,iEAAmF;AAmBjF,sGAnBqB,2BAAqB,OAmBrB;AAlBvB,0EAAoG;AAyBlG,8GAzBqB,2BAA6B,OAyBrB;AAxB/B,kEAGuC;AAmBrC,uGArBc,2BAAsB,OAqBd;AAOtB,kGA3BA,kCAAiB,OA2BA;AAzBnB,kEAGuC;AAIrC,uGANc,2BAAsB,OAMd;AAoBtB,4GAzBA,4CAA2B,OAyBA;AAGhB,QAAA,yBAAyB,GAAG;IACvC,0BAAuB;IACvB,0BAAuB;IACvB,0BAAuB;IACvB,0BAAmB;IACnB,0BAAoB;IACpB,0BAAsB;IACtB,0BAAsB;IACtB,0BAAsB;IACtB,0BAAqB;IACrB,2BAAsB;IACtB,2BAAqB;IACrB,2BAAoB;IACpB,2BAAsB;IACtB,2BAAsB;IACtB,2BAAqB;IACrB,2BAA6B;IAC7B,2BAAsB;IACtB,2BAAsB;CACsB,CAAC;AAE/C,uDAAwF;AAA/E,0GAAA,aAAa,OAAA;AAAE,yHAAA,4BAA4B,OAAA"}

package/dist/tools/definitions/orbit-video/definition.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../types.js';
+export declare const definition: ToolDefinition;
+//# sourceMappingURL=definition.d.ts.map

package/dist/tools/definitions/orbit-video/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/tools/definitions/orbit-video/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,UAAU,EAAE,cAyGxB,CAAC"}

package/dist/tools/definitions/orbit-video/definition.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definition = void 0;
+exports.definition = {
+    type: 'function',
+    function: {
+        name: 'orbit_video',
+        description: 'Create a 360-degree orbit video around a subject. This is a SELF-CONTAINED ' +
+            'pipeline — it automatically generates angle views (via change_angle), creates ' +
+            'transition video clips, and stitches them into one seamless looping video. ' +
+            'You only need ONE source image as the front view — either an uploaded image ' +
+            'or a previously generated result. If the user uploaded an image, call this ' +
+            'tool directly without generating anything first. Do NOT pre-generate multiple ' +
+            'angles or variations — this tool handles everything internally. ' +
+            'Use when the user asks for a "360 pan", "orbit", "rotate around", "spin ' +
+            'around", or "turntable" view.',
+        parameters: {
+            type: 'object',
+            properties: {
+                elevation: {
+                    type: 'string',
+                    enum: ['low-angle shot', 'eye-level shot', 'elevated shot', 'high-angle shot'],
+                    description: 'Camera elevation for all angles. Default: "eye-level shot".',
+                },
+                distance: {
+                    type: 'string',
+                    enum: ['close-up', 'medium shot', 'wide shot'],
+                    description: 'Camera distance for all angles. Default: "medium shot".',
+                },
+                prompt: {
+                    type: 'string',
+                    description: 'Describe the SUBJECT and ambient environment (for example, a concise ' +
+                        'description of the visible subject, location, weather, props, and ambience). ' +
+                        'Do NOT describe camera motion, rotation, panning, orbiting, ' +
+                        'or 360-degree movement — camera motion is handled automatically. ' +
+                        'Do NOT put spoken dialogue here — use the dialogue parameter instead. ' +
+                        'Music is automatically suppressed — use generate_music separately.',
+                },
+                dialogue: {
+                    type: 'string',
+                    description: 'Spoken dialogue or narration for a SINGLE segment of the orbit video. ' +
+                        'This is applied ONLY to the segment specified by dialogueSegment (default: ' +
+                        'first segment). All other segments get foley/ambient audio only. Keep it ' +
+                        'brief — each segment is 2.5 seconds (~6 words max). If the user asks for ' +
+                        'dialogue in "just the first segment" or "only at the start", put the speech ' +
+                        'here and leave prompt for motion/foley only. If the user asks for dialogue ' +
+                        'in multiple/every segment, use dialogues instead.',
+                },
+                dialogues: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Per-segment spoken dialogue lines for multiple orbit transitions. Use this ' +
+                        'when the user asks for dialogue in multiple segments, every turn, or before ' +
+                        'each 90-degree turn. With the default standard 360° orbit there are 4 ' +
+                        'transitions, so provide exactly 4 short lines in order. Each line should be ' +
+                        'brief enough for a 2.5 second segment (~6 words max). Preserve real names ' +
+                        'from the request or prior generated image; never invent placeholder speakers. ' +
+                        'For "us"/"we"/couple requests, make the named people speak together. ' +
+                        'Omit entries or use an empty string for ' +
+                        'segments that should have foley/ambient audio only. Do NOT also put these ' +
+                        'dialogue lines in prompt.',
+                },
+                dialogueSegment: {
+                    type: 'number',
+                    description: 'Which transition segment receives the dialogue (0-based index into the ' +
+                        'transition sequence). 0 = first transition (default), last index = wrap-back ' +
+                        'to front. With default angles there are 4 transitions (0-3). With custom ' +
+                        'angles the count equals angles.length + 1. Only used when dialogue is provided.',
+                },
+                angles: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: [
+                            'front-right quarter view',
+                            'right side view',
+                            'back-right quarter view',
+                            'back view',
+                            'back-left quarter view',
+                            'left side view',
+                            'front-left quarter view',
+                        ],
+                    },
+                    description: 'OMIT THIS PARAMETER for standard 360° orbits — the default (3 angles ' +
+                        'at 90° increments: right, back, left + source as front = 4 transitions) ' +
+                        'works for nearly all requests. Only provide this when the user explicitly ' +
+                        'asks for specific angles, a partial orbit, or extra-smooth rotation. ' +
+                        'Each additional angle costs extra credits and generation time. ' +
+                        'Values are clockwise azimuths between the source (front) and wrap-back.',
+                },
+                sourceImageIndex: {
+                    type: 'number',
+                    description: 'Which result image to orbit around (0-based). If the user picked a ' +
+                        '1-based image number, subtract 1 and set this explicitly (number 3 -> 2). ' +
+                        'Omit only when the user did not choose a specific prior result; then the ' +
+                        'tool uses the latest result or original upload.',
+                },
+            },
+            required: [],
+        },
+    },
+};
+//# sourceMappingURL=definition.js.map

package/dist/tools/definitions/orbit-video/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/tools/definitions/orbit-video/definition.ts"],"names":[],"mappings":";;;AAEa,QAAA,UAAU,GAAmB;IACxC,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,6EAA6E;YAC7E,gFAAgF;YAChF,6EAA6E;YAC7E,8EAA8E;YAC9E,6EAA6E;YAC7E,gFAAgF;YAChF,kEAAkE;YAClE,0EAA0E;YAC1E,+BAA+B;QACjC,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,CAAC;oBAC9E,WAAW,EAAE,6DAA6D;iBAC3E;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC;oBAC9C,WAAW,EAAE,yDAAyD;iBACvE;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,uEAAuE;wBACvE,+EAA+E;wBAC/E,8DAA8D;wBAC9D,mEAAmE;wBACnE,wEAAwE;wBACxE,oEAAoE;iBACvE;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,wEAAwE;wBACxE,6EAA6E;wBAC7E,2EAA2E;wBAC3E,2EAA2E;wBAC3E,8EAA8E;wBAC9E,6EAA6E;wBAC7E,mDAAmD;iBACtD;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EACT,6EAA6E;wBAC7E,8EAA8E;wBAC9E,wEAAwE;wBACxE,8EAA8E;wBAC9E,4EAA4E;wBAC5E,gFAAgF;wBAChF,uEAAuE;wBACvE,0CAA0C;wBAC1C,4EAA4E;wBAC5E,2BAA2B;iBAC9B;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,yEAAyE;wBACzE,+EAA+E;wBAC/E,2EAA2E;wBAC3E,iFAAiF;iBACpF;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE;4BACJ,0BAA0B;4BAC1B,iBAAiB;4BACjB,yBAAyB;4BACzB,WAAW;4BACX,wBAAwB;4BACxB,gBAAgB;4BAChB,yBAAyB;yBAC1B;qBACF;oBACD,WAAW,EACT,uEAAuE;wBACvE,0EAA0E;wBAC1E,4EAA4E;wBAC5E,uEAAuE;wBACvE,iEAAiE;wBACjE,yEAAyE;iBAC5E;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,qEAAqE;wBACrE,4EAA4E;wBAC5E,2EAA2E;wBAC3E,iDAAiD;iBACpD;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC"}

package/dist/tools/definitions/overlay-video/definition.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from '../types.js';
+export declare const OVERLAY_POSITIONS: readonly ["top-left", "top-center", "top-right", "center", "bottom-left", "bottom-center", "bottom-right"];
+export declare const definition: ToolDefinition;
+//# sourceMappingURL=definition.d.ts.map

package/dist/tools/definitions/overlay-video/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/tools/definitions/overlay-video/definition.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,iBAAiB,4GAQpB,CAAC;AAEX,eAAO,MAAM,UAAU,EAAE,cA6IxB,CAAC"}

package/dist/tools/definitions/overlay-video/definition.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definition = exports.OVERLAY_POSITIONS = void 0;
+exports.OVERLAY_POSITIONS = [
+    'top-left',
+    'top-center',
+    'top-right',
+    'center',
+    'bottom-left',
+    'bottom-center',
+    'bottom-right',
+];
+exports.definition = {
+    type: 'function',
+    function: {
+        name: 'overlay_video',
+        description: 'Burn text and/or logo/watermark image overlays onto a previously rendered or uploaded video. ' +
+            'Use when the user asks to add a title, caption, label, watermark, brand logo, sponsor mark, lower-third, ' +
+            'tagline, sticker, or any persistent text/graphic over the existing video frames. ' +
+            'Multiple overlays can be supplied in one call (e.g. a corner logo plus a top-center title). ' +
+            'Each overlay can optionally be limited to a [startSeconds, endSeconds] time range. ' +
+            'When the user asks for an overlay to appear for a specific window (for example "2 seconds in the middle"), set startSeconds/endSeconds on the overlay item in the same call. ' +
+            'Negative startSeconds/endSeconds are relative to the end of the base video, so startSeconds=-2 with omitted endSeconds means "the last 2 seconds". ' +
+            'When replacing a video time window with an uploaded still image or screenshot, use an image overlay with widthPct=100 and fit="cover" for that window. ' +
+            'This is a pure ffmpeg post-production op — it does not regenerate the video. ' +
+            'Do not use for generative intro/outro/bumper/end-card/start-card requests; those add or regenerate video time and should use extend_video or replace_video_segment. ' +
+            'Do not call it again just to refine default size/placement after it succeeds; finalize and wait for user feedback. ' +
+            'Do not use for animated typography, kinetic captions, or moving stickers; this lays down static overlays only.',
+        parameters: {
+            type: 'object',
+            properties: {
+                sourceVideoIndex: {
+                    type: 'number',
+                    description: 'Which video to overlay onto. Omit to use the most recent generated video, or the first uploaded video when no generated video exists. ' +
+                        'Non-negative values are 0-based indices into prior generated video results. ' +
+                        'Negative values reference uploaded videos: -1 = first uploaded video, -2 = second, etc., ' +
+                        'falling back to the most recent generated video when no uploads exist.',
+                },
+                overlays: {
+                    type: 'array',
+                    minItems: 1,
+                    description: 'Ordered list of overlays to burn in. Each overlay is rendered on top of all previous overlays. ' +
+                        'Either kind="text" (with `text` and styling) or kind="image" (with `sourceImageIndex`).',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            kind: {
+                                type: 'string',
+                                enum: ['text', 'image'],
+                                description: 'Overlay kind. "text" renders drawtext; "image" composites an existing image asset.',
+                            },
+                            position: {
+                                type: 'string',
+                                enum: [...exports.OVERLAY_POSITIONS],
+                                description: 'Anchor position on the frame. Pixel offsets nudge inward; the renderer pads ' +
+                                    'each anchor by a small safe margin so overlays do not touch the frame edge.',
+                            },
+                            offsetX: {
+                                type: 'number',
+                                description: 'Optional horizontal offset in pixels. Positive = inward from the anchor edge.',
+                            },
+                            offsetY: {
+                                type: 'number',
+                                description: 'Optional vertical offset in pixels. Positive = inward from the anchor edge.',
+                            },
+                            startSeconds: {
+                                type: 'number',
+                                description: 'Show the overlay from this time. Default 0 (show from the start). ' +
+                                    'Negative values are relative to the end of the base video; startSeconds=-2 means start 2 seconds before the end.',
+                            },
+                            endSeconds: {
+                                type: 'number',
+                                description: 'Hide the overlay at this time. Default = full video duration. ' +
+                                    'Negative values are relative to the end of the base video.',
+                            },
+                            text: {
+                                type: 'string',
+                                description: 'Overlay text. Required when kind="text". Use plain text; line breaks are honored.',
+                            },
+                            fontSizePct: {
+                                type: 'number',
+                                minimum: 1,
+                                maximum: 30,
+                                description: 'Font size as a percentage of the video height. Default: 6 (≈ 43px on a 720p frame). ' +
+                                    'Only valid when kind="text".',
+                            },
+                            color: {
+                                type: 'string',
+                                description: 'Text fill color (CSS hex like "#FFFFFF" or named ffmpeg color). Default "#FFFFFF". ' +
+                                    'Only valid when kind="text".',
+                            },
+                            outlineColor: {
+                                type: 'string',
+                                description: 'Text outline color. Default "#000000" with a thin stroke for legibility. ' +
+                                    'Only valid when kind="text".',
+                            },
+                            backgroundColor: {
+                                type: ['string', 'null'],
+                                description: 'Optional rgba background pill behind the text (e.g. "rgba(0,0,0,0.5)"). null = no box. ' +
+                                    'Only valid when kind="text".',
+                            },
+                            fontWeight: {
+                                type: 'string',
+                                enum: ['normal', 'bold'],
+                                description: 'Default "normal". Only valid when kind="text".',
+                            },
+                            sourceImageIndex: {
+                                type: 'number',
+                                description: 'Which image to overlay. Required when kind="image". ' +
+                                    'Non-negative values are 0-based indices into prior generated image results. ' +
+                                    'Negative values reference uploaded images in image-only order: -1 = first uploaded image, -2 = second, etc. ' +
+                                    'If the user uploaded one video and one logo image, the logo is sourceImageIndex=-1.',
+                            },
+                            widthPct: {
+                                type: 'number',
+                                minimum: 1,
+                                maximum: 100,
+                                description: 'Logo width as a percentage of the video width. Default: 15. ' +
+                                    'Only valid when kind="image".',
+                            },
+                            opacity: {
+                                type: 'number',
+                                minimum: 0,
+                                maximum: 1,
+                                description: 'Image overlay opacity, 0..1. Default 1.0 (fully opaque). Only valid when kind="image".',
+                            },
+                            fit: {
+                                type: 'string',
+                                enum: ['contain', 'cover'],
+                                description: 'Image sizing mode. Default "contain" scales by widthPct and preserves the full overlay image. ' +
+                                    '"cover" scales/crops the image to cover the full video frame; use with widthPct=100 for screenshot/still-frame replacement windows.',
+                            },
+                        },
+                        required: ['kind', 'position'],
+                    },
+                },
+            },
+            required: ['overlays'],
+        },
+    },
+};
+//# sourceMappingURL=definition.js.map

package/dist/tools/definitions/overlay-video/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/tools/definitions/overlay-video/definition.ts"],"names":[],"mappings":";;;AAYa,QAAA,iBAAiB,GAAG;IAC/B,UAAU;IACV,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,aAAa;IACb,eAAe;IACf,cAAc;CACN,CAAC;AAEE,QAAA,UAAU,GAAmB;IACxC,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,+FAA+F;YAC/F,2GAA2G;YAC3G,mFAAmF;YACnF,8FAA8F;YAC9F,qFAAqF;YACrF,+KAA+K;YAC/K,qJAAqJ;YACrJ,yJAAyJ;YACzJ,+EAA+E;YAC/E,sKAAsK;YACtK,qHAAqH;YACrH,gHAAgH;QAClH,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,wIAAwI;wBACxI,8EAA8E;wBAC9E,2FAA2F;wBAC3F,wEAAwE;iBAC3E;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,CAAC;oBACX,WAAW,EACT,iGAAiG;wBACjG,yFAAyF;oBAC3F,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;gCACvB,WAAW,EAAE,oFAAoF;6BAClG;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,GAAG,yBAAiB,CAAC;gCAC5B,WAAW,EACT,8EAA8E;oCAC9E,6EAA6E;6BAChF;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,+EAA+E;6BAC7F;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,6EAA6E;6BAC3F;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,oEAAoE;oCACpE,kHAAkH;6BACrH;4BACD,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,gEAAgE;oCAChE,4DAA4D;6BAC/D;4BACD,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,mFAAmF;6BACjG;4BACD,WAAW,EAAE;gCACX,IAAI,EAAE,QAAQ;gCACd,OAAO,EAAE,CAAC;gCACV,OAAO,EAAE,EAAE;gCACX,WAAW,EACT,sFAAsF;oCACtF,8BAA8B;6BACjC;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,qFAAqF;oCACrF,8BAA8B;6BACjC;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,2EAA2E;oCAC3E,8BAA8B;6BACjC;4BACD,eAAe,EAAE;gCACf,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;gCACxB,WAAW,EACT,yFAAyF;oCACzF,8BAA8B;6BACjC;4BACD,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;gCACxB,WAAW,EAAE,gDAAgD;6BAC9D;4BACD,gBAAgB,EAAE;gCAChB,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,sDAAsD;oCACtD,8EAA8E;oCAC9E,8GAA8G;oCAC9G,qFAAqF;6BACxF;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,OAAO,EAAE,CAAC;gCACV,OAAO,EAAE,GAAG;gCACZ,WAAW,EACT,8DAA8D;oCAC9D,+BAA+B;6BAClC;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,OAAO,EAAE,CAAC;gCACV,OAAO,EAAE,CAAC;gCACV,WAAW,EAAE,wFAAwF;6BACtG;4BACD,GAAG,EAAE;gCACH,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;gCAC1B,WAAW,EACT,gGAAgG;oCAChG,qIAAqI;6BACxI;yBACF;wBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;qBAC/B;iBACF;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;CACF,CAAC"}

package/dist/tools/definitions/refine-result/definition.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../types.js';
+export declare const definition: ToolDefinition;
+//# sourceMappingURL=definition.d.ts.map

package/dist/tools/definitions/refine-result/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/tools/definitions/refine-result/definition.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,UAAU,EAAE,cAqDxB,CAAC"}

package/dist/tools/definitions/refine-result/definition.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definition = void 0;
+const promptOverrideMarker_js_1 = require("../../../contracts/promptOverrideMarker.js");
+const index_js_1 = require("../../../media/index.js");
+exports.definition = {
+    type: 'function',
+    function: {
+        name: 'refine_result',
+        description: 'Make ANY edit to an existing result image. This is the DEFAULT tool for follow-up requests after results exist. Use whenever the user wants to modify, adjust, or build upon a previous result — including brightness, color, sharpening, object removal, background changes, further restoration, or any other edit. If the user does not specify which image, use the most recent result (index 0 if only one result, or the last result the user referenced). Only use restore_photo instead if the user explicitly wants to start over from the original upload.',
+        parameters: {
+            type: 'object',
+            properties: {
+                prompt: {
+                    type: 'string',
+                    description: `Targeted refinement prompt for Qwen Image Edit 2511 (50-150 words, natural language sentences).
+
+${promptOverrideMarker_js_1.LITERAL_PROMPT_OVERRIDE}
+
+PROMPT ORDER: [IDENTITY LOCK if people] → [SPECIFIC CHANGE] → [PRESERVE EVERYTHING ELSE]
+
+Rules:
+- Use POSITIVE phrasing only. The model ignores negatives ("preserve exact facial likeness" NOT "don't change the face").
+- Describe ONLY what needs to change (the delta). The base image already contains most of the truth — do not rewrite the entire image.
+- Be specific about what to change: "warmer skin tones", "cooler shadows", "sharper facial features", "more natural greens".
+- For creative refinements: lean into specifics — "add more dramatic Rembrandt lighting", "push the colors more toward Warhol neon pop", "make the anime eyes larger and more expressive", "add more superhero energy with glowing effects".
+- CRITICAL for photos with people: FRONT-LOAD identity preservation before the edit. Start with "Preserve exact facial likeness, face structure, eye shape, nose shape, mouth shape, jawline, skin tone, hairline, apparent age, and overall recognizability."
+- ALWAYS end with "Preserve all unmentioned details" to prevent unwanted changes.
+
+BATCH VARIATIONS: Only use Dynamic Prompt syntax when the user explicitly asks to explore different refinement directions. Example: "refine with {more contrast|softer lighting|richer colors}". Default to identical prompts for refine_result batches.`,
+                },
+                sourceImageIndex: {
+                    type: 'number',
+                    description: 'Which result image to refine (0-based index). If the user specifies an image number, use that index. If omitted, the latest result is used automatically. When multiple results exist and the user previously referenced a specific one, use that one.',
+                },
+                numberOfVariations: {
+                    type: 'number',
+                    description: 'Number of variations (1-16). Use 1 unless user requests multiple. Default: 1.',
+                    minimum: 1,
+                    maximum: 16,
+                },
+                scale: {
+                    type: 'number',
+                    enum: [1, 1.5, 2, 3, 4],
+                    description: 'Output scale multiplier relative to the source image size. 1 = same resolution as source (default). Use higher values when user asks to upscale, enlarge, make bigger, or increase resolution. Small images (<480px) are automatically upscaled to at least 480px regardless of this setting. Default: 1.',
+                },
+                aspectRatio: {
+                    type: 'string',
+                    description: index_js_1.ASPECT_RATIO_DESCRIPTION,
+                },
+            },
+            required: ['prompt'],
+        },
+    },
+};
+//# sourceMappingURL=definition.js.map

package/dist/tools/definitions/refine-result/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/tools/definitions/refine-result/definition.ts"],"names":[],"mappings":";;;AAMA,wFAAqF;AACrF,sDAAmE;AAEtD,QAAA,UAAU,GAAmB;IACxC,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,siBAAsiB;QACxiB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE;;EAErB,iDAAuB;;;;;;;;;;;;yPAYgO;iBAChP;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,wPAAwP;iBAC3P;gBACD,kBAAkB,EAAE;oBAClB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,+EAA+E;oBACjF,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,EAAE;iBACZ;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBACvB,WAAW,EACT,2SAA2S;iBAC9S;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAwB;iBACtC;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC"}

package/dist/tools/definitions/replace-video-segment/definition.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../types.js';
+export declare const definition: ToolDefinition;
+//# sourceMappingURL=definition.d.ts.map

package/dist/tools/definitions/replace-video-segment/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/tools/definitions/replace-video-segment/definition.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,UAAU,EAAE,cAsExB,CAAC"}

package/dist/tools/definitions/replace-video-segment/definition.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definition = void 0;
+exports.definition = {
+    type: 'function',
+    function: {
+        name: 'replace_video_segment',
+        description: 'Regenerate a slice of a video and splice the new segment into the original at the same position. Works on BOTH videos previously rendered in this session AND user-uploaded videos — set videoIndex to a negative number (e.g. -1) to target an uploaded video when no prior render exists. ' +
+            'Use when the user asks to modify a portion of an existing video while keeping the rest intact: "regenerate from 5s to 10s", "redo the last 3 seconds", "swap out the middle of the video", "replace the bumper at the end", "swap the end card", "change the outro", "redo the intro", "change the ending", "replace the last clip", etc. ' +
+            'Also use this tool for pure ffmpeg splices where the replacement already exists as another uploaded or generated video: "splice video 2 into video 1", "insert the second clip at 5s", or "replace 5s to 15s with uploaded clip 2". In that case pass replacementVideoIndex, do not call generate_video/animate_photo/video_to_video, and set endSeconds=startSeconds for an insertion that should not remove time from the base video. ' +
+            'For time-sliced edits such as "alternate 1 second from each video", pass replacementStartSeconds and replacementEndSeconds to cut the next source slice out of the replacement video before splicing it into the base. Repeat this call for each alternating window. Use replacement windows (endSeconds=startSeconds+sliceDuration), not insertion windows, unless the user explicitly asks to lengthen the output by inserting extra slices. replacementStartSeconds and replacementEndSeconds must be concrete non-negative seconds; never use -1 as an end-of-source sentinel. Do not use stitch_video for interleaving because stitch_video only concatenates whole clips end-to-end. ' +
+            'STRONGLY PREFER this over re-running generate_video / animate_photo on the original prompt when the user only wants part of the video changed — re-rendering wastes credits, loses the unchanged sections, and breaks the original timing. ' +
+            'If the user does not specify the exact start/end seconds (e.g. "replace the bumper at the end"), call analyze_video first to identify the correct window, OR derive it from the storyboard timing already in the conversation (e.g. last beat\'s time range). Do not guess wildly — pick a sensible bumper/end-card window such as the final 1-3 seconds when the storyboard says scene_07 is 14-15s. ' +
+            'Returns both the standalone replacement clip and the spliced composite. ' +
+            'For LTX-2.3 and Wan 2.2 base videos the tool locks both ends with first/last-frame keyframes for seamless edges. ' +
+            'For Seedance base videos the tool uses the original window as a reference for video-to-video transformation. If a requested window is shorter than the selected model\'s native render minimum, the handler renders a slightly larger handled clip, trims the result back to the requested seconds, then splices exactly that requested range. ' +
+            'By default the regenerated segment\'s audio replaces the original audio in the [startSeconds, endSeconds] window, so new motion stays in sync with new sound. Pass keepOriginalAudio=true only when the user explicitly asks to keep the existing audio — phrasings like "keep the audio", "leave the original audio", "preserve the music/score/dialogue", "don\'t change the audio". If the user uses an ambiguous phrasing such as "with the audio" (which could mean either "with the original audio kept" or "with new audio"), DO NOT call this tool yet — first ask the user whether to preserve or replace the original audio in the replaced window. When replacementVideoIndex is set, the existing replacement clip\'s own audio is used; pass keepOriginalAudio=true only when the user explicitly wants the base video audio to stay over the replacement window.',
+        parameters: {
+            type: 'object',
+            properties: {
+                startSeconds: {
+                    type: 'number',
+                    description: 'Start of the window (in seconds) inside the base video that should be regenerated. Must be ≥ 0 and < endSeconds. For "the last N seconds" requests, set startSeconds = max(0, baseDuration - N). When unsure of the exact base duration, you may pass a sentinel value of -1 to mean "from the end of the base video"; the handler will resolve it after probing.',
+                },
+                endSeconds: {
+                    type: 'number',
+                    description: 'End of the window (in seconds) inside the base video. For regenerated segments it must be > startSeconds and ≤ base video duration. When replacementVideoIndex is set, endSeconds may equal startSeconds to insert the replacement clip at that timestamp without removing any base-video time. For alternating/interleaved time-slice edits, use endSeconds=startSeconds+sliceDuration so the source slice replaces that base window; do not use insertion unless the user explicitly asks to lengthen the output. Pass -1 to mean "until the end of the base video". Windows shorter than the selected model\'s native render minimum are rendered with handles and trimmed before splicing; windows longer than the model maximum must be split.',
+                },
+                prompt: {
+                    type: 'string',
+                    description: 'What should happen in the replaced window — motion, action, dialogue, audio. For LTX include exact spoken words in double quotes when speech is requested. For Seedance V2V describe the transformation relative to the existing visuals (the original window is provided as a reference clip).',
+                },
+                videoIndex: {
+                    type: 'number',
+                    description: 'Which video to edit. Default: -1 (most recent video in this session, falling back to the first uploaded video when no prior render exists). Use 0-based non-negative indices for prior tool result videos. For uploaded videos with no prior render, leave this absent or pass -1 — the handler will pick the uploaded base automatically.',
+                },
+                replacementVideoIndex: {
+                    type: 'number',
+                    description: 'Optional existing video clip to splice into the base video instead of regenerating a segment. Non-negative values reference prior generated videos; negative values reference uploaded videos (-1 = first uploaded video, -2 = second, etc.). Use for requests like "splice video 2 into video 1", "replace 5s to 15s with uploaded clip 2", or alternating/interleaved edits that pull timed slices from another existing clip. When this is set, the operation is pure ffmpeg post-production and keeps the replacement clip audio unless keepOriginalAudio=true.',
+                },
+                replacementStartSeconds: {
+                    type: 'number',
+                    minimum: 0,
+                    description: 'Optional start time, in seconds, inside replacementVideoIndex. Must be a concrete non-negative source time; do not use -1 sentinels for replacement source windows. Use with replacementEndSeconds when only a slice of the replacement clip should be spliced. Example: alternating 1-second clips from video 1 and video 2 should replace base window 1..2 with the first replacement slice by setting replacementVideoIndex=-2, replacementStartSeconds=0, replacementEndSeconds=1.',
+                },
+                replacementEndSeconds: {
+                    type: 'number',
+                    minimum: 0,
+                    description: 'Optional end time, in seconds, inside replacementVideoIndex. Must be a concrete non-negative source time greater than replacementStartSeconds. Do not pass -1 to mean "end of replacement video"; use the known uploaded/generated clip duration from metadata for routine time-sliced edits, or omit both replacementStartSeconds and replacementEndSeconds to use the whole replacement clip. Do not call analyze_video just to learn duration.',
+                },
+                videoModel: {
+                    type: 'string',
+                    enum: ['auto', 'ltx23', 'wan22', 'seedance2', 'seedance2-fast'],
+                    description: 'Which model to use for the new segment. Default: "auto" — detect from the base video\'s producer (Seedance base → Seedance, Wan base → Wan 2.2, otherwise LTX-2.3). Override only when the user explicitly requests a different model.',
+                },
+                keepOriginalAudio: {
+                    type: 'boolean',
+                    description: 'When true, the audio from the original [startSeconds, endSeconds] window is muxed onto the regenerated visuals so the user keeps the original dialogue/score. When false (default), the new clip\'s own audio is used (LTX renders fresh audio; Seedance V2V depends on generateAudio). Default: false. Set true only when the user explicitly asks to preserve the existing audio; if the user uses an ambiguous phrasing like "with the audio", ask the user to clarify rather than guessing.',
+                },
+            },
+            required: ['startSeconds', 'endSeconds'],
+        },
+    },
+};
+//# sourceMappingURL=definition.js.map

package/dist/tools/definitions/replace-video-segment/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/tools/definitions/replace-video-segment/definition.ts"],"names":[],"mappings":";;;AAuBa,QAAA,UAAU,GAAmB;IACxC,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,8RAA8R;YAC9R,4UAA4U;YAC5U,0aAA0a;YAC1a,6pBAA6pB;YAC7pB,6OAA6O;YAC7O,wYAAwY;YACxY,0EAA0E;YAC1E,mHAAmH;YACnH,iVAAiV;YACjV,g1BAAg1B;QACl1B,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,mWAAmW;iBACtW;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,qtBAAqtB;iBACxtB;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,iSAAiS;iBACpS;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4UAA4U;iBAC/U;gBACD,qBAAqB,EAAE;oBACrB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,qiBAAqiB;iBACxiB;gBACD,uBAAuB,EAAE;oBACvB,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,CAAC;oBACV,WAAW,EACT,wdAAwd;iBAC3d;gBACD,qBAAqB,EAAE;oBACrB,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,CAAC;oBACV,WAAW,EACT,mbAAmb;iBACtb;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,CAAC;oBAC/D,WAAW,EACT,wOAAwO;iBAC3O;gBACD,iBAAiB,EAAE;oBACjB,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,ieAAie;iBACpe;aACF;YACD,QAAQ,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;SACzC;KACF;CACF,CAAC"}

package/dist/tools/definitions/restore-photo/definition.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../types.js';
+export declare const definition: ToolDefinition;
+//# sourceMappingURL=definition.d.ts.map

package/dist/tools/definitions/restore-photo/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/tools/definitions/restore-photo/definition.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,UAAU,EAAE,cAuDxB,CAAC"}