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

package/dist-esm/tools/definitions/generate-music/definition.js

@@ -0,0 +1,72 @@
+import { LITERAL_PROMPT_OVERRIDE } from '../../../contracts/promptOverrideMarker.js';
+export const definition = {
+    type: 'function',
+    function: {
+        name: 'generate_music',
+        description: 'Generate music from a text description. Creates original songs with optional lyrics, BPM, key signature, and duration control. Use when the user wants to create music, a song, a beat, a melody, background music, or any audio content.',
+        parameters: {
+            type: 'object',
+            properties: {
+                prompt: {
+                    type: 'string',
+                    description: `Genre, mood, and style description for the music. Be specific about musical characteristics.
+
+${LITERAL_PROMPT_OVERRIDE}
+
+Examples:
+- "upbeat electronic dance music with driving bass and synth arpeggios"
+- "mellow jazz ballad with soft piano, brushed drums, and walking bass"
+- "epic orchestral soundtrack with soaring strings and powerful brass"
+- "lo-fi hip hop beat with vinyl crackle, muted keys, and chill vibes"
+- "acoustic folk song with fingerpicked guitar and warm harmonies"
+
+Include:
+- Genre (rock, jazz, electronic, classical, hip-hop, etc.)
+- Mood (happy, melancholic, energetic, relaxing, epic, etc.)
+- Instruments (piano, guitar, drums, synth, strings, etc.)
+- Style descriptors (driving, mellow, atmospheric, punchy, etc.)
+
+BATCH VARIATIONS: When numberOfVariations > 1, use Dynamic Prompt syntax to vary ONE dimension across separate tracks. Lock in any genre/mood/instruments the user specified, vary the rest. Example: "{lo-fi hip hop beat with muted keys|jazz piano trio with brushed drums|ambient electronic with soft pads} with warm reverb and vinyl texture".`,
+                },
+                duration: {
+                    type: 'number',
+                    description: 'Duration in seconds. Default: 30. Range: 10-600 (10 seconds to 10 minutes). Short clips: 10-30s. Standard songs: 120-300s.',
+                    minimum: 10,
+                    maximum: 600,
+                },
+                bpm: {
+                    type: 'number',
+                    description: 'Beats per minute / tempo. Default: 120. Range: 30-300. Slow ballad: 60-80. Mid-tempo: 90-120. Upbeat: 120-140. Fast dance: 140-180. Very fast: 180+.',
+                    minimum: 30,
+                    maximum: 300,
+                },
+                keyscale: {
+                    type: 'string',
+                    description: 'Musical key and scale. E.g., "C major", "A minor", "F# minor", "Bb major". Default: "C major". Only set when the user specifies a key or when a particular mood calls for it (minor keys for sad/dark, major for happy/bright).',
+                },
+                lyrics: {
+                    type: 'string',
+                    description: 'Song lyrics. Optional — omit for instrumental music. Format: write lyrics naturally with line breaks. The model will attempt to sing these lyrics with the generated music. Works best with clear, rhythmic phrasing that matches the BPM.',
+                },
+                model: {
+                    type: 'string',
+                    enum: ['turbo', 'sft'],
+                    description: 'ACE-Step model variant. "turbo" (default): Higher quality audio generation with 4-16 steps and half the cost. Always use turbo unless the user explicitly requests the SFT model. "sft": Experimental model with lower audio quality but very strong lyric handling. 10-200 steps, full cost. Only use when the user specifically asks for SFT. Default: "turbo".',
+                },
+                timesig: {
+                    type: 'number',
+                    enum: [2, 3, 4, 6],
+                    description: 'Time signature (beats per measure). 4 = 4/4 time (default, most common). 3 = 3/4 time (waltz). 2 = 2/4 time (march). 6 = 6/8 time (compound). Default: 4.',
+                },
+                numberOfVariations: {
+                    type: 'number',
+                    description: 'Number of variations (1-16). Use 1 unless user requests multiple. Default: 1.',
+                    minimum: 1,
+                    maximum: 16,
+                },
+            },
+            required: ['prompt'],
+        },
+    },
+};
+//# sourceMappingURL=definition.js.map

package/dist-esm/tools/definitions/generate-music/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/tools/definitions/generate-music/definition.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,2OAA2O;QAC7O,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE;;EAErB,uBAAuB;;;;;;;;;;;;;;;sVAe6T;iBAC7U;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4HAA4H;oBAC9H,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,GAAG;iBACb;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,sJAAsJ;oBACxJ,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,GAAG;iBACb;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,iOAAiO;iBACpO;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4OAA4O;iBAC/O;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC;oBACtB,WAAW,EACT,mWAAmW;iBACtW;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBAClB,WAAW,EACT,2JAA2J;iBAC9J;gBACD,kBAAkB,EAAE;oBAClB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,+EAA+E;oBACjF,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,EAAE;iBACZ;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC"}

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

@@ -0,0 +1,117 @@
+import { GENERATE_VIDEO_SKIP_PROMPT_PROCESSING_DESCRIPTION, LITERAL_VIDEO_PROMPT_OVERRIDE, SEEDANCE_EXPAND_PROMPT_DESCRIPTION, SEEDANCE_TOOL_MULTIMODAL_REFERENCE_GUIDANCE, } from '../../../contracts/toolPromptMarkers.js';
+import { ASPECT_RATIO_DESCRIPTION } from '../../../media/index.js';
+export const definition = {
+    type: "function",
+    function: {
+        name: "generate_video",
+        description: 'Generate a video from text or Seedance multimodal references. LTX 2.3 generates audio natively (dialogue, sounds, ambient music) — describe audio in the prompt. If the user provides exact speech, include it in double quotes; if they only imply speech, describe the performance and voice without inventing quoted words. Never use placeholders such as "while speaking", "dialogue begins", "explaining", or "final line lands". PERSONA VOICE: Only when the user explicitly asks to use/clone a registered persona voice clip, call resolve_personas first, then set voicePersonaName to select which persona\'s voice clip to use. Do not set voicePersonaName for ordinary character dialogue or inferred voices; describe those voices in the prompt for native LTX audio. For cross-persona narration (e.g. David narrates a video of Aleyna), resolve both personas and set voicePersonaName to the narrator only if that registered voice was requested. Persona voice requires ltx23 (WAN 2.2 does not support voice identity). For non-Seedance syncing to a specific song or audio track, use sound_to_video instead. For non-Seedance animation from a locked source photo, use animate_photo. Do NOT use for My Personas unless generating a Seedance reference-based video — standard persona videos use resolve_personas → edit_image → animate_photo. SEEDANCE DEFAULT: For seedance2 or seedance2-fast, default to exactly one 4-15s video unless the user explicitly asks for multiple separate outputs. Multiple beats, shots, or scene descriptions in one up-to-15s Seedance prompt are still one video. If the user requests one continuous Seedance video longer than 15s, preserve the requested total duration in the prompt/context; chat orchestration should split it into supported segment renders and stitch them instead of clamping it to a 15s excerpt. Uploaded/generated storyboard, shot-sheet, or trailer-concept images used as Seedance references should become one Seedance generate_video call by default; do not extract panels with edit_image and do not animate the storyboard sheet with LTX unless the user explicitly asks for separate non-Seedance clips. Seedance loose image, video, and audio references go through this tool; do not use animate_photo sourceImageIndex/frameRole/endImageIndex for Seedance. If an uploaded video is the source clip to transform, upscale, enhance, restyle, or remaster, use video_to_video with controlMode="seedance-v2v" instead of generate_video referenceVideoIndices. If the uploaded audio is the primary sync target, lip-sync target, or requested as sound-to-video/audio-sync, use sound_to_video with videoModel="seedance2" instead of this tool. Use referenceAudioIndices here only when audio is a loose reference under an image/video-anchored Seedance shot. For Seedance, every image — first frame, last frame, or loose reference — is passed through referenceImageIndices (auto-uploaded as referenceImageUrls). Anchor frame intent in the prompt with @Image tags such as "Use @Image1 as the opening shot reference. Begin the video with a composition, subject placement, lighting, mood, and camera framing that closely match @Image1." (or @Image2 as the final shot reference). For seamless-loop or "first frame and last frame identical" requests with a single uploaded image, anchor it explicitly as both: "Use @Image1 as both the first frame and last frame so the video loops cleanly back to the opening composition." Assign each useful @Image/@Video/@Audio tag a role. APPROVED STORYBOARD PRODUCTION: When the user asks for a production workflow from an approved storyboard, the chat orchestrator should use the durable CampaignStoryboard contract: render the composite board, audit it, generate per-scene GPT Image 2 keyframes, then render Seedance scene clips and stitch them. Do not replace that with a generic storyboard-reference video unless the user asks for a fast draft. PARTIAL VIDEO EDITS: Do NOT call generate_video to re-render an existing rendered/uploaded video just to change part of it (the bumper, the intro, the end card, a single scene, the last few seconds, etc.). Use replace_video_segment for that — it preserves the unchanged portion, keeps the original audio outside the replaced window, and costs far less. Likewise use extend_video to add new time to the end without rewriting the rest. If the request is vague, ask about vision/mood/style first. Only call once you have clear creative intent.',
+        parameters: {
+            type: "object",
+            properties: {
+                prompt: {
+                    type: "string",
+                    description: `Write one flowing paragraph like a cinematographer describing a shot. Present tense, specific natural language. Longer clips need longer prompts; close-ups need more detail than wide shots.
+
+${LITERAL_VIDEO_PROMPT_OVERRIDE}
+
+STRUCTURE: shot/style → subject (age, clothing, hairstyle, distinguishing details) → environment, lighting, atmosphere → action beat by beat → camera movement → audio and dialogue.
+
+CAST CONTINUITY: For screenplay, script, storyboard, commercial, series, or other longer-form video tasks with recurring characters, use stable character names and repeat the same visual anchors every time they appear (age range, build, hairstyle, outfit silhouette, color palette, signature prop/accessory, posture, voice). Do not rename, merge, redesign, or drift characters between scenes unless the user asks.
+
+MOTION PACING: Scale complexity to duration. <=6s: 1 main action beat + 1 simple camera move. Around 10s: 2-3 clear action beats + 1 camera move. >10s: up to 4 action beats in clear sequence. Prefer fewer readable beats over dense micro-actions, especially in short clips.
+
+BLOCKING: Direct the layout like scene blocking. State left/right placement, foreground/background, facing toward/away, and relative distance when multiple subjects or important objects are involved.
+
+ACTION: Drive motion with concrete verbs. Specify who moves, what moves, how it moves, and what the camera does. Avoid generic phrases like "comes alive."
+
+DIALOGUE: Put user-provided spoken lines in double quotes. For screenplay-style or longer-form tasks, prefix each spoken line with a stable speaker tag outside the quotes, e.g. CHARACTER: "We made it." Break long speech into short quoted phrases with acting beats between them (gestures, pauses, glances). If the user asks for speech but provides no exact words, describe the visible delivery, voice quality, and emotion without inventing quoted dialogue; ask only when exact wording is the point of the request. Never write placeholders such as "while speaking", "dialogue begins", "explaining", or "final line lands". Show emotion through visible behavior — not "she is sad", instead "she looks down, pauses, and her voice cracks". QUOTING RULE: ONLY use double quotes for spoken dialogue. Never quote on-screen text, overlay text, titles, captions, signs, or any visual text — describe them without quotes.
+
+STORYBOARD TEXT: For storyboard references, structural headings, section numbers, slide titles, panel titles, and captions may become short audio-only narration/voiceover or key-message beats, but they are not subtitles, title cards, lower thirds, or visible overlays unless the user explicitly asks for visible text/on-screen text/title card/subtitle/lower third/signage/CTA. Do not concatenate storyboard labels into run-on voiceover; use separate brief phrases with pauses.
+
+AUDIO: Prompt sound intentionally — voice quality, volume, room tone, ambience, music, weather, footsteps. Include language or accent if relevant. Useful voice/volume anchors: whisper, mutter, shout, scream, energetic announcer, resonant voice with gravitas, distorted radio-style, robotic monotone, childlike curiosity.
+
+CAMERA: Cinematic terms — close-up, tracking shot, dolly in, handheld, slow arc, static frame. Describe movement relative to subject.
+
+For specific characters (movies, TV): describe visual appearance — don't rely on names alone.
+
+For complex/creative scenes (characters, dialogue, skits): capture the full creative intent. The system auto-expands into a detailed prompt.
+
+AVOID: Vague prompts, too many characters at once, conflicting lighting logic, readable text or logos, abstract emotions with no visible behavior, rigid numeric constraints (exact angles, counts, speeds).
+
+BATCH VARIATIONS: When numberOfVariations > 1, use Dynamic Prompt syntax. Lock in any camera/subject/style the user specified, vary the rest. Example: "slow dolly in on a city street {at dawn with golden light|during a rainstorm|at night with neon reflections}".`,
+                },
+                expandPrompt: {
+                    type: "boolean",
+                    description: SEEDANCE_EXPAND_PROMPT_DESCRIPTION,
+                },
+                skipPromptProcessing: {
+                    type: "boolean",
+                    description: GENERATE_VIDEO_SKIP_PROMPT_PROCESSING_DESCRIPTION,
+                },
+                duration: {
+                    type: "number",
+                    description: "Video duration in seconds. Default: 5. Range: 2-20. Use when the user explicitly requests a specific length.",
+                    minimum: 2,
+                    maximum: 20,
+                },
+                negativePrompt: {
+                    type: "string",
+                    description: "Non-Seedance only. Optional negative prompt for video models that expose a separate negative-prompt field. Do not set for seedance2 or seedance2-fast; rewrite user-provided Seedance avoid/ban/no-X requests as positive visual instructions in prompt.",
+                },
+                videoModel: {
+                    type: "string",
+                    enum: ["ltx23", "wan22", "seedance2", "seedance2-fast"],
+                    description: 'Video model. "ltx23" (default): LTX 2.3 with native audio; Fast/HQ use the distilled 8-step worker and Default Media Quality Pro uses the non-distilled dev worker. "wan22": Fast 4-step, simple motion, no audio. Default: "ltx23". For ordinary Seedance 2.0 video requests, use seedance2-fast by default: 720p unless Default Media Quality is Fast, which should use 480p. Use seedance2 when the user explicitly asks for 1080p / the non-standard full-quality version, or whenever a generated/uploaded video storyboard image is the Seedance reference unless the user explicitly asks for a draft or the Seedance fast model/version. Storyboard-reference Seedance requests default to High Quality: set targetResolution 720 even when Default Media Quality is Fast, unless the user explicitly asks for another named resolution such as 480p. Default Media Quality Pro alone is not an explicit 1080p request; keep default Seedance resolution at 720p unless the user asks for 1080p or another resolution. ' +
+                        SEEDANCE_TOOL_MULTIMODAL_REFERENCE_GUIDANCE,
+                },
+                generateAudio: {
+                    type: "boolean",
+                    description: "Seedance only. Whether Seedance should generate a native audio track. Omit by default; set false only when the user explicitly asks for silent output or no audio.",
+                },
+                referenceImageIndices: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: "Seedance only. Image references for @Image tags. Use negative indices for uploaded images (-1 first upload, -2 second upload) and non-negative indices for generated image results. Omit by default: uploaded images are auto-forwarded as @Image references. Anchor frame intent in the prompt with @Image tags: \"Use @Image1 as the opening shot reference. Begin the video with a composition, subject placement, lighting, mood, and camera framing that closely match @Image1.\" (or @Image2 as the final shot reference). For seamless-loop or \"first frame and last frame identical\" requests with a single uploaded image, anchor it explicitly as both: \"Use @Image1 as both the first frame and last frame so the video loops cleanly back to the opening composition.\" Do not use animate_photo sourceImageIndex/frameRole/endImageIndex for Seedance.",
+                },
+                referenceVideoIndices: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: 'Seedance only. Optional loose video references. Use negative indices for uploaded videos (-1 first uploaded video, -2 second uploaded video) and non-negative indices for generated video results. Omit by default: uploaded videos are auto-forwarded as @Video references. Set to choose a subset or include previously generated video URLs. Do not use this for uploaded source-video transforms, upscales, enhancements, restyles, or remasters; use video_to_video with controlMode="seedance-v2v" instead.',
+                },
+                referenceAudioIndices: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: 'Seedance only. Optional loose audio references. Use negative indices for uploaded audio files (-1 first uploaded audio, -2 second uploaded audio) and non-negative indices for generated audio results. Omit by default: uploaded audio is auto-forwarded as @Audio references when the Seedance request also has an image or video reference. Use this only for loose background, mood, timing, or style references under an image/video-anchored Seedance shot. If the uploaded audio is the primary sync target, lip-sync target, or requested as sound-to-video/audio-sync, use sound_to_video with videoModel="seedance2" instead. Audio-only Seedance requests are unsupported; use sound_to_video for uploaded-audio-only workflows.',
+                },
+                width: {
+                    type: "number",
+                    description: 'Video width in pixels. LTX 2.3: 640-3840. WAN: 480-1536. Default resolution depends on model and quality tier: LTX Fast about 720p and High/Pro about 1080p; WAN Fast uses 480p short side and High/Pro uses 720p short side. Set width only when the user specifies an exact width or orientation-qualified exact pixels. A bare named resolution like "720p resolution" is a short-side target, not an instruction to make landscape 1280x720. If the user gives only one exact dimension, set only that dimension and preserve/infer the sensible aspect ratio. User-requested exact dimensions override the default media quality. Mappings when orientation is explicit: 480p landscape=854x480, 480p portrait=480x854, 720p landscape=1280x720, 720p portrait=720x1280, 1080p landscape=1920x1080, 1080p portrait=1080x1920, 4K landscape=3840x2160. Non-step values are accepted when in bounds; LTX snaps to the nearest 64px step and WAN snaps to the nearest 16px step internally, so do not ask the user to adjust by a few pixels.',
+                },
+                height: {
+                    type: "number",
+                    description: 'Video height in pixels. LTX 2.3: 640-3840. WAN: 480-1536. Set height only when the user specifies an exact height or orientation-qualified exact pixels. A bare named resolution like "720p resolution" is a short-side target; do not convert it to landscape dimensions unless the user says landscape/horizontal/widescreen. If the user gives only one exact dimension, set only that dimension and preserve/infer the sensible aspect ratio. User-requested exact dimensions override Default Media Quality, including Pro. Non-step values are accepted when in bounds; LTX snaps to the nearest 64px step and WAN snaps to the nearest 16px step internally, so do not ask the user to adjust by a few pixels.',
+                },
+                targetResolution: {
+                    type: "number",
+                    description: 'Short-side video resolution target in pixels. Use when the user asks for a bare named resolution such as "480p", "720p", or "1080p" without exact pixels or an output orientation. Also set for default Seedance 2.0 requests: 480 when Default Media Quality is Fast, otherwise 720, including Pro unless the user explicitly asks for 1080p or another resolution. For generated/uploaded storyboard images used as Seedance references, default to 720 even when Default Media Quality is Fast; only use 480 when the user explicitly asks for 480p. This preserves/inherits the current video shape instead of forcing landscape. Do NOT set width, height, or exact-pixel aspectRatio for bare named resolution requests. If the user says "720p portrait" or "720p landscape", use exact width/height/aspectRatio instead.',
+                },
+                numberOfVariations: {
+                    type: "number",
+                    description: "Number of variations (1-16). Use 1 unless user explicitly requests multiple separate video outputs. For Seedance, default to 1 because each variation is an expensive separate render.",
+                    minimum: 1,
+                    maximum: 16,
+                },
+                aspectRatio: {
+                    type: "string",
+                    description: ASPECT_RATIO_DESCRIPTION,
+                },
+                voicePersonaName: {
+                    type: "string",
+                    description: 'ONLY when the user explicitly requests a registered/reference persona voice clip. Name of the persona whose voice clip to use as referenceAudioIdentity. Set this when the narrator/speaker is a different persona than the one described in the video (e.g. "David" narrates a scene featuring Aleyna), or to explicitly select a requested voice when multiple personas with voice clips are resolved. Do NOT set this for ordinary character dialogue, inferred voices, or personas without a voice clip — LTX 2.3 generates voice natively from the text prompt instead. Requires ltx23.',
+                },
+            },
+            required: ["prompt"],
+        },
+    },
+};
+//# sourceMappingURL=definition.js.map

package/dist-esm/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,OAAO,EACL,iDAAiD,EACjD,6BAA6B,EAC7B,kCAAkC,EAClC,2CAA2C,GAC5C,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,CAAC,MAAM,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,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;uQA0BwO;iBAC9P;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,kCAAkC;iBAChD;gBACD,oBAAoB,EAAE;oBACpB,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,iDAAiD;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,2CAA2C;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,wBAAwB;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-esm/tools/definitions/index.js

@@ -0,0 +1,41 @@
+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';
+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 const generationToolDefinitions = [
+    generateImageDefinition,
+    generateVideoDefinition,
+    generateMusicDefinition,
+    editImageDefinition,
+    applyStyleDefinition,
+    restorePhotoDefinition,
+    refineResultDefinition,
+    animatePhotoDefinition,
+    changeAngleDefinition,
+    videoToVideoDefinition,
+    stitchVideoDefinition,
+    orbitVideoDefinition,
+    danceMontageDefinition,
+    soundToVideoDefinition,
+    extendVideoDefinition,
+    replaceVideoSegmentDefinition,
+    overlayVideoDefinition,
+    addSubtitlesDefinition,
+];
+export { DANCE_PRESETS, resolveDancePresetForRequest } from './dance-montage/dances.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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,GACxB,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,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,UAAU,IAAI,sBAAsB,EACpC,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AAGvC,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,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,uBAAuB;IACvB,uBAAuB;IACvB,uBAAuB;IACvB,mBAAmB;IACnB,oBAAoB;IACpB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IACrB,sBAAsB;IACtB,qBAAqB;IACrB,oBAAoB;IACpB,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IACrB,6BAA6B;IAC7B,sBAAsB;IACtB,sBAAsB;CACsB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,100 @@
+export const 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-esm/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,MAAM,CAAC,MAAM,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-esm/tools/definitions/overlay-video/definition.js

@@ -0,0 +1,139 @@
+export const OVERLAY_POSITIONS = [
+    'top-left',
+    'top-center',
+    'top-right',
+    'center',
+    'bottom-left',
+    'bottom-center',
+    'bottom-right',
+];
+export const 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: [...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-esm/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":"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"}

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

@@ -0,0 +1,53 @@
+import { LITERAL_PROMPT_OVERRIDE } from '../../../contracts/promptOverrideMarker.js';
+import { ASPECT_RATIO_DESCRIPTION } from '../../../media/index.js';
+export const 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).
+
+${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: ASPECT_RATIO_DESCRIPTION,
+                },
+            },
+            required: ['prompt'],
+        },
+    },
+};
+//# sourceMappingURL=definition.js.map

package/dist-esm/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,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,CAAC,MAAM,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,uBAAuB;;;;;;;;;;;;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,wBAAwB;iBACtC;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC"}