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

package/dist-esm/contracts/imagePrompt.js

@@ -0,0 +1,143 @@
+import { getRandomTheme } from './randomThemes.js';
+export const IMAGE_PROMPT_MAX_TOKENS = 1024;
+const FLUX_GUIDE = `FLUX & Next-Gen models use natural language descriptions, not keyword lists.
+- Write flowing, descriptive prose: subject, environment, lighting, mood.
+- Be specific about what you want rather than using abstract quality boosters.
+- You can mix descriptive phrases with comma-separated keywords, but lean toward sentences.
+- Camera/lens terms and lighting descriptions work well.
+- Keep guidance context in mind: these models use very low guidance (1-5), so prompts should be clear and direct.`;
+const SDXL_GUIDE = `SDXL models work well with a hybrid approach: natural language descriptions combined with comma-separated quality/style keywords.
+Prompt structure (in this order):
+1. Subject — what/who is in the image
+2. Details — appearance, clothing, expression, pose
+3. Environment — setting, background, time of day
+4. Lighting & mood — lighting setup, atmosphere
+5. Quality/style boosters — technical quality keywords (e.g. "highly detailed, 8K, photorealistic")
+For anime SDXL models, use danbooru-style tags: "1girl, long hair, blue eyes" with quality tags first: "masterpiece, best quality".
+Camera/lens terminology helps photorealistic models: "Canon EOS R5, 85mm lens, f/1.4, shallow depth of field".`;
+const SD15_GUIDE = `SD 1.5 models are most responsive to keyword/tag-based prompts. Structured comma-separated tags give the best results.
+Prompt structure (in this order):
+1. Quality boosters first: "RAW photo, best quality, masterpiece, highly detailed"
+2. Subject description
+3. Environment/setting
+4. Style/medium: "watercolor, oil painting, digital art, photograph"
+5. Lighting/camera: "studio lighting, golden hour, Fujifilm XT3, 85mm"
+For photorealistic: start with "RAW photo" or "photograph", include camera references and film grain.
+For anime: use danbooru tags "1girl, solo, long_hair", quality tags first "masterpiece, best quality", higher guidance (8-14).
+Keep prompts keyword-rich rather than conversational.`;
+const PONY_GUIDE = `Pony Diffusion models use a unique score-based tag system for quality control.
+Add score tags at the BEGINNING of the prompt:
+- Full range: "score_9, score_8_up, score_7_up, score_6_up, score_5_up, score_4_up"
+- Short range: "score_9, score_8_up, score_7_up"
+After score tags, describe the subject using comma-separated tags similar to SDXL.
+Content rating tags are available: "rating_safe", "rating_suggestive".
+The model understands character names from anime/cartoon/anthro fandoms.
+Example: "score_9, score_8_up, score_7_up, punk rock singer, leather jacket, crazy hair, dynamic angle, highly detailed, film grain, 8k"`;
+const FAST_GUIDE = `Turbo, Lightning, and LCM models are optimized for speed (2-7 steps). They have less capacity to process complex prompts.
+- Keep prompts concise and direct — under ~50 tokens for best results.
+- Focus on the core subject and one clear style direction.
+- Use strong, specific descriptors.
+- Don't overload with quality boosters — at very low guidance they have minimal effect.
+- Don't use extremely long, multi-sentence prompts.
+Example: "a majestic lion in golden savanna, sunset, cinematic"`;
+const SD3_GUIDE = `SD3 has improved natural language understanding, multi-subject composition, and typography rendering.
+- Write clear, descriptive natural language prompts — not keyword lists.
+- You can be specific about spatial relationships: "on the left", "in the background", "above".
+- Multi-subject scenes work well: describe each subject and their relationship.
+- For text in images, spell out exactly what to render in quotes.
+- Don't over-tag with "masterpiece, best quality" etc. — just describe what you want.
+- SD3 handles complex scenes better than SD1.5/SDXL.`;
+const EDITING_GUIDE = `Image editing models accept reference images alongside text prompts. The prompt acts as an instruction for how to modify or build upon the input image(s).
+- Write prompts as transformation instructions referencing the existing image.
+- Describe changes as transformations: "is now wearing", "now has", "the background changes to".
+- You can reference elements in the image: "she", "the background", "his jacket".
+- For text rendering: include text in quotes — 'Title text "SOMETHING"'.
+- Short, clear instructions often work better than long detailed descriptions.
+- The reference image drives the result more than the prompt.`;
+const PROMPTING_GUIDES = {
+    flux: FLUX_GUIDE,
+    sdxl: SDXL_GUIDE,
+    sd15: SD15_GUIDE,
+    pony: PONY_GUIDE,
+    fast: FAST_GUIDE,
+    sd3: SD3_GUIDE,
+    editing: EDITING_GUIDE,
+    video: '',
+};
+function buildSystemPrompt(promptingType, modelTitle) {
+    const guide = PROMPTING_GUIDES[promptingType] || PROMPTING_GUIDES.sdxl;
+    return `You are an expert prompt engineer for AI image generation models. The user will give you a short idea or rough prompt. Your job is to expand and enhance it into an optimized prompt for the "${modelTitle}" model, then return it via the enhance_prompt tool.
+
+MODEL-SPECIFIC PROMPTING GUIDE:
+${guide}
+
+RULES:
+- Enhance and expand the user's idea while preserving their creative intent.
+- Add vivid details: lighting, textures, atmosphere, composition, colors.
+- Write the prompt in the style that best suits this model type (see guide above).
+- Do NOT add negative prompt content — only write the positive prompt.
+- If the user provides a style context, complement it — don't repeat or contradict it.
+- Keep the result focused: one coherent scene or subject, not a list of disconnected ideas.
+- Output only the prompt text — no explanations, no preamble.`;
+}
+export const IMAGE_PROMPT_TOOL = {
+    type: 'function',
+    function: {
+        name: 'enhance_prompt',
+        description: 'Output the enhanced image generation prompt',
+        parameters: {
+            type: 'object',
+            properties: {
+                prompt: {
+                    type: 'string',
+                    description: 'The enhanced image generation prompt optimized for the target model',
+                },
+            },
+            required: ['prompt'],
+        },
+    },
+};
+function normalizeBuildImagePromptInput(inputOrPrompt, stylePrompt = '', promptingType = 'sdxl', modelTitle = 'Unknown Model') {
+    if (typeof inputOrPrompt === 'string') {
+        return {
+            prompt: inputOrPrompt,
+            stylePrompt,
+            promptingType,
+            modelTitle,
+            randomTheme: '',
+        };
+    }
+    return {
+        prompt: inputOrPrompt.prompt,
+        stylePrompt: inputOrPrompt.stylePrompt ?? '',
+        promptingType: inputOrPrompt.promptingType ?? 'sdxl',
+        modelTitle: inputOrPrompt.modelTitle ?? 'Unknown Model',
+        randomTheme: inputOrPrompt.randomTheme ?? '',
+    };
+}
+export function buildImagePromptMessages(inputOrPrompt, stylePrompt = '', promptingType = 'sdxl', modelTitle = 'Unknown Model') {
+    const input = normalizeBuildImagePromptInput(inputOrPrompt, stylePrompt, promptingType, modelTitle);
+    const messages = [
+        { role: 'system', content: buildSystemPrompt(input.promptingType, input.modelTitle) },
+    ];
+    let userMessage;
+    if (input.prompt.trim()) {
+        userMessage = input.prompt;
+        if (input.stylePrompt) {
+            userMessage += `\n\nCurrent style context (complement this, don't repeat): ${input.stylePrompt}`;
+        }
+    }
+    else {
+        const theme = input.randomTheme || getRandomTheme();
+        userMessage = `Come up with a unique, creative image inspired by: ${theme}. Be original and surprising — avoid clichés.`;
+        if (input.stylePrompt) {
+            userMessage += `\n\nUse this style as inspiration: ${input.stylePrompt}`;
+        }
+    }
+    messages.push({ role: 'user', content: userMessage });
+    return messages;
+}
+export function parseToolCallPrompt(args) {
+    return String(args.prompt || '').trim();
+}
+//# sourceMappingURL=imagePrompt.js.map

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

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

package/dist-esm/contracts/index.js

@@ -0,0 +1,27 @@
+export { isPromptContract } from './promptContract.js';
+export { isToolGatingPolicy } from './toolGatingPolicy.js';
+export { isRepairRecipe } from './repairRecipe.js';
+export { emptyTurnPolicy } from './turnPolicy.js';
+export { ContractRegistry } from './registry.js';
+export { classifyTurn } from './evaluators.js';
+export { compileToolsForTurn } from './evaluators.js';
+export { dispatchToolCall } from './evaluators.js';
+export { DEFAULT_CONTRACT_CONTEXT_PREFIX, appendContractsContextToSystemContent, buildContractTurnPolicy, compileContractToolSurface, formatContractsContextBlock, normalizeContractMessages, reconcileToolChoiceForCompiledTools, } from './toolSurface.js';
+export { isContractsTelemetryEvent, makeBufferedSink } from './telemetry.js';
+export { MEDIA_TOOL_NAMES, PHASE_3_GATING_POLICIES, TOOL_SURFACE_GATING_POLICIES, IMAGE_CONTEXT_TOOL_NAMES, VIDEO_CONTEXT_TOOL_NAMES, PHASE_4_REPAIR_RECIPES, PHASE_5_PROMPT_CONTRACTS, CANONICAL_TOOL_CATALOG, TOOL_COST_METADATA, TOOL_PERMISSIONS, getCanonicalToolCatalogEntry, populateContractsGatingPolicies, populateContractsToolSurfaceGatingPolicies, populateContractsRepairRecipes, populateContractsPromptContracts, populateToolCostMetadata, populateToolPermissions, populateContractsDefaults, getToolCostMetadata, getToolPermission, getToolPermissionDecision, evaluatePermissionGate, toolRequiresUserApproval, listPaidTools, listToolsByRiskLevel, listCanonicalToolCatalogEntries, listHostedApiImplementedToolNames, listHostedApiToolCatalogEntries, } from './data/index.js';
+export { LITERAL_PROMPT_OVERRIDE } from './promptOverrideMarker.js';
+export { BACKBONE_APP_TOOL_NAMES, BACKBONE_COMPOSITION_TOOL_NAMES, BACKBONE_DURABLE_HOSTED_CREATIVE_TOOL_NAMES, BACKBONE_GENERATION_TOOL_NAMES, BACKBONE_HOSTED_APP_TOOL_NAMES, } from './backboneToolCatalog.js';
+export { BACKBONE_DURABLE_HOSTED_STEP_TOOL_NAMES, BACKBONE_MODEL_KB_VERSION, BACKBONE_ROUTING_POLICY_VERSION, BACKBONE_SCHEMA_VERSION, } from './backboneDurableWorkflow.js';
+export { CAMPAIGN_STORYBOARD_METADATA_PREFIX, CAMPAIGN_STORYBOARD_SCHEMA_VERSION, } from './storyboard.js';
+export * from './hostedToolValidation.js';
+export { RANDOM_THEMES, RANDOM_LYRICS_THEMES, getRandomTheme, getRandomLyricsTheme, } from './randomThemes.js';
+export { ID_LORA_MAX_TOKENS, ID_LORA_COMPOSITION_TOOL, buildIdLoRaConversionMessages, parseToolCallIdLoRaParts, formatIdLoRaPrompt, } from './idLoraPrompt.js';
+export { IMAGE_PROMPT_MAX_TOKENS, IMAGE_PROMPT_TOOL, buildImagePromptMessages, parseToolCallPrompt, } from './imagePrompt.js';
+export { LYRICS_MAX_TOKENS, LYRICS_COMPOSITION_TOOL, INSTRUMENTAL_COMPOSITION_TOOL, buildLyricsMessages, buildInstrumentalMessages, parseToolCallResult, } from './musicComposition.js';
+export { SCRIPT_MAX_TOKENS, SCRIPT_COMPOSITION_TOOL, CHARACTER_REFERENCE_VIDEO_COMPOSITION_SYSTEM_PROMPT, buildLtxScriptMessages, buildWanScriptMessages, parseToolCallScript, buildCharacterReferenceVideoCompositionMessages, parseCompositionToolScriptFromResult, } from './videoComposition.js';
+export { HOSTED_COMPOSITION_ROUTER_MAX_TOKENS, buildEnhancePromptToolArgs, buildLyricsCompositionToolArgs, buildInstrumentalCompositionToolArgs, buildScriptCompositionToolArgs, buildComposeWorkflowToolArgs, buildComposeWorkflowTemplateToolArgs, buildWanScriptCompositionToolArgs, buildHostedCompositionToolMessages, } from './hostedComposition.js';
+export { SEEDANCE_STORYBOARD_REFERENCE_PROMPT, } from './storyboard.js';
+export { LITERAL_VIDEO_PROMPT_OVERRIDE, LITERAL_SEEDANCE_PROMPT_OVERRIDE, SEEDANCE_EXPAND_PROMPT_DESCRIPTION, GENERATE_VIDEO_SKIP_PROMPT_PROCESSING_DESCRIPTION, ANIMATE_PHOTO_SKIP_PROMPT_PROCESSING_DESCRIPTION, SEEDANCE_TOOL_MULTIMODAL_REFERENCE_GUIDANCE, SEEDANCE_TOOL_AUDIO_REFERENCE_GUIDANCE, SEEDANCE_TOOL_V2V_REFERENCE_GUIDANCE, } from './toolPromptMarkers.js';
+export { BACKBONE_VERSIONS, BackboneWorkflowValidationError, MAX_HOSTED_TOOL_SEQUENCE_STEPS, normalizeBackboneDurableWorkflowSteps, buildBackboneDurableWorkflowRun, } from './backboneDurableWorkflow.js';
+export { getCostClassNumericWeight, UNKNOWN_COST_CLASS_FALLBACK_WEIGHT, COST_CLASS_NUMERIC_WEIGHTS, } from './data/costEstimation.js';
+//# sourceMappingURL=index.js.map

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

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

package/dist-esm/contracts/musicComposition.js

@@ -0,0 +1,182 @@
+import { LANGUAGE_LABELS, MUSIC_BPM, MUSIC_DURATION, MUSIC_KEY_SCALES, MUSIC_TIME_SIGNATURES, } from '../media/musicSettings.js';
+import { getRandomLyricsTheme } from './randomThemes.js';
+export const LYRICS_MAX_TOKENS = 2048;
+const LYRICS_SYSTEM_PROMPT = `You are an expert songwriter. Generate song lyrics using the ACE-Step structured format and return them via the compose_lyrics tool.
+
+Section headers — each section tag can optionally include a vocal/performance modifier after a hyphen, e.g. [Section - modifier]. Choose modifiers that fit the song's mood and vary them across sections.
+Common structures: Verse, Chorus, Bridge, Intro, Outro, Instrumental, Interlude, Build, Drop, Breakdown — but you can use any descriptive section name like Guitar Solo, Piano Interlude, Fade Out, etc.
+Modifiers are free-form — describe vocal delivery or performance feel in your own words. Not every section needs one. Examples for inspiration: raspy, breathy, falsetto, belting, spoken word, humming, anthemic, gentle, building, harmonies, a cappella
+Keep modifiers to one or two words per tag.
+
+Rules:
+- Write natural, creative lyrics that match the requested style/mood
+- Keep line lengths appropriate for singing (6-10 syllables per line for optimal rhythm)
+- Use CAPS for intense/shouted lines: "WE ARE THE FIRE!"
+- Use parentheses for background vocals: "We rise together (together)"
+- The lyrics should be suitable for a song, not a poem
+
+Suggest a duration that fits the lyrics naturally at the chosen tempo.`;
+const INSTRUMENTAL_SYSTEM_PROMPT = `You are an expert music composer and arranger. Design an instrumental music structure using the ACE-Step structured format and return it via the compose_instrumental tool.
+
+Output ONLY section tags in brackets — one per line, nothing else between them. The AI music model interprets any text outside brackets as lyrics to sing, so do NOT include descriptions, directions, or any other text between section tags.
+
+Section tags — use tags like [Intro], [Main Theme], [Bridge], [Build], [Drop], [Breakdown], [Climax], [Outro], [Guitar Solo], [Piano Interlude], [Fade Out], etc.
+Each tag can optionally include a performance modifier after a hyphen, e.g. [Section - modifier]. Choose modifiers that describe the instrumental feel.
+Modifiers are free-form — describe the energy, dynamics, or featured instruments. Examples: building, ambient, driving, melodic, percussive, atmospheric, powerful, delicate, syncopated, distorted
+
+Example output format:
+[Intro - ambient pads]
+[Main Theme - driving guitar]
+[Bridge - stripped back piano]
+[Build - percussive, rising]
+[Drop - powerful, full band]
+[Outro - fade out]
+
+Rules:
+- Output ONLY bracketed section tags, one per line — NO text between sections
+- Use modifiers within the brackets to convey dynamics, instrumentation, and energy
+- Structure the sections to create a natural musical arc
+- Match the requested style/mood
+
+Suggest a duration that fits the structure naturally at the chosen tempo.`;
+export const LYRICS_COMPOSITION_TOOL = {
+    type: 'function',
+    function: {
+        name: 'compose_lyrics',
+        description: 'Output the composed song lyrics and musical parameters',
+        parameters: {
+            type: 'object',
+            properties: {
+                lyrics: {
+                    type: 'string',
+                    description: 'Song lyrics with enriched section headers (e.g. [Verse 1 - soft vocal]). Use \\n for newlines.',
+                },
+                bpm: { type: 'number', description: 'Tempo in beats per minute, e.g. 120 for a pop song' },
+                keyscale: {
+                    type: 'string',
+                    description: 'Musical key and scale, e.g. "D minor", "A major", "F# minor"',
+                },
+                timesignature: {
+                    type: 'string',
+                    enum: ['2/4', '3/4', '4/4', '6/8'],
+                    description: 'Time signature. Most songs use 4/4; waltzes use 3/4',
+                },
+                duration: {
+                    type: 'number',
+                    description: 'Estimated song duration in seconds that fits the lyrics at the chosen tempo',
+                },
+            },
+            required: ['lyrics', 'bpm', 'keyscale', 'timesignature', 'duration'],
+        },
+    },
+};
+export const INSTRUMENTAL_COMPOSITION_TOOL = {
+    type: 'function',
+    function: {
+        name: 'compose_instrumental',
+        description: 'Output the composed instrumental music structure and musical parameters',
+        parameters: {
+            type: 'object',
+            properties: {
+                structure: {
+                    type: 'string',
+                    description: 'Instrumental structure as ONLY bracketed section tags, one per line, with NO text between them (e.g. [Intro - ambient pads]\\n[Main Theme - driving guitar]\\n[Bridge - stripped back]). Use \\n for newlines.',
+                },
+                bpm: {
+                    type: 'number',
+                    description: 'Tempo in beats per minute, e.g. 120 for an upbeat track',
+                },
+                keyscale: {
+                    type: 'string',
+                    description: 'Musical key and scale, e.g. "D minor", "A major", "F# minor"',
+                },
+                timesignature: {
+                    type: 'string',
+                    enum: ['2/4', '3/4', '4/4', '6/8'],
+                    description: 'Time signature. Most songs use 4/4; waltzes use 3/4',
+                },
+                duration: {
+                    type: 'number',
+                    description: 'Estimated track duration in seconds that fits the structure at the chosen tempo',
+                },
+            },
+            required: ['structure', 'bpm', 'keyscale', 'timesignature', 'duration'],
+        },
+    },
+};
+export function buildLyricsMessages(prompt, language, musicPrompt, randomTheme) {
+    const messages = [{ role: 'system', content: LYRICS_SYSTEM_PROMPT }];
+    let userMessage;
+    if (prompt.trim()) {
+        userMessage = prompt;
+    }
+    else {
+        const theme = randomTheme || getRandomLyricsTheme();
+        userMessage = `Come up with a unique, original song about: ${theme}. Be creative and surprising.`;
+    }
+    if (musicPrompt) {
+        userMessage += `\n\nMusic style context: ${musicPrompt}`;
+    }
+    if (language && language !== 'unknown') {
+        userMessage += `\n\nWrite the lyrics in: ${LANGUAGE_LABELS[language]}`;
+    }
+    messages.push({ role: 'user', content: userMessage });
+    return messages;
+}
+export function buildInstrumentalMessages(prompt, musicPrompt, randomTheme) {
+    const messages = [{ role: 'system', content: INSTRUMENTAL_SYSTEM_PROMPT }];
+    let userMessage;
+    if (prompt.trim()) {
+        userMessage = prompt;
+    }
+    else {
+        const theme = randomTheme || getRandomLyricsTheme();
+        userMessage = `Come up with a unique, original instrumental piece inspired by: ${theme}. Be creative and surprising.`;
+    }
+    if (musicPrompt) {
+        userMessage += `\n\nMusic style context: ${musicPrompt}`;
+    }
+    messages.push({ role: 'user', content: userMessage });
+    return messages;
+}
+function parseTimeSignature(value) {
+    const str = String(value ?? '');
+    const map = { '2/4': '2', '3/4': '3', '4/4': '4', '6/8': '6' };
+    if (map[str])
+        return map[str];
+    const signatures = Object.keys(MUSIC_TIME_SIGNATURES);
+    if (signatures.includes(str))
+        return str;
+    return null;
+}
+function parseTempo(value) {
+    const num = Number(value);
+    if (!isNaN(num) && num >= MUSIC_BPM.min && num <= MUSIC_BPM.max)
+        return Math.round(num);
+    return null;
+}
+function parseDuration(value) {
+    const num = Number(value);
+    if (!isNaN(num) && num >= MUSIC_DURATION.min && num <= MUSIC_DURATION.max)
+        return Math.round(num);
+    return null;
+}
+function parseKeyScale(value) {
+    if (!value)
+        return null;
+    const str = String(value);
+    const found = MUSIC_KEY_SCALES.find((k) => k.toLowerCase() === str.toLowerCase());
+    return found || null;
+}
+export function parseToolCallResult(args) {
+    const rawText = String(args.lyrics || args.structure || '');
+    const lyrics = rawText.includes('\n') ? rawText : rawText.replace(/\\n/g, '\n');
+    return {
+        lyrics: lyrics.trim(),
+        tempo: parseTempo(args.bpm),
+        key: parseKeyScale(args.keyscale),
+        timeSignature: parseTimeSignature(args.timesignature),
+        duration: parseDuration(args.duration),
+    };
+}
+//# sourceMappingURL=musicComposition.js.map

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

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

package/dist-esm/contracts/promptContract.js

@@ -0,0 +1,34 @@
+function isStringRecord(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    for (const v of Object.values(value)) {
+        if (typeof v !== 'string')
+            return false;
+    }
+    return true;
+}
+export function isPromptContract(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const v = value;
+    if (typeof v.contractId !== 'string' || v.contractId.length === 0)
+        return false;
+    if (typeof v.version !== 'string' || v.version.length === 0)
+        return false;
+    if (typeof v.toolName !== 'string' || v.toolName.length === 0)
+        return false;
+    if (typeof v.baseDescription !== 'string')
+        return false;
+    if (!isStringRecord(v.parameterDocs))
+        return false;
+    if (v.voiceExamples !== undefined) {
+        if (!Array.isArray(v.voiceExamples))
+            return false;
+        if (v.voiceExamples.some((x) => typeof x !== 'string'))
+            return false;
+    }
+    if (v.conditionalNotes !== undefined && !isStringRecord(v.conditionalNotes))
+        return false;
+    return true;
+}
+//# sourceMappingURL=promptContract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promptContract.js","sourceRoot":"","sources":["../../src/contracts/promptContract.ts"],"names":[],"mappings":"AA0BA,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,EAAE,CAAC;QAChE,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChF,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,OAAO,CAAC,CAAC,eAAe,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,CAAC,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC;YAAE,OAAO,KAAK,CAAC;QAClD,IAAI,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,CAAC,gBAAgB,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1F,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist-esm/contracts/promptOverrideMarker.js

@@ -0,0 +1,2 @@
+export const LITERAL_PROMPT_OVERRIDE = 'LITERAL PROMPT OVERRIDE: If the user explicitly says not to modify the prompt, or to use it exactly/verbatim/as-is, copy the identified prompt text verbatim instead of applying these construction rules unless a hard requirement is missing.';
+//# sourceMappingURL=promptOverrideMarker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promptOverrideMarker.js","sourceRoot":"","sources":["../../src/contracts/promptOverrideMarker.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,uBAAuB,GAClC,iPAAiP,CAAC"}

package/dist-esm/contracts/randomThemes.js

@@ -0,0 +1,154 @@
+export const RANDOM_THEMES = [
+    'a mountain summit',
+    'a bamboo forest',
+    'a frozen waterfall',
+    'a lavender field',
+    'a volcanic coastline',
+    'a bay at night',
+    'a salt flat with cracked earth',
+    'a redwood forest',
+    'a coral reef with sea life',
+    'a rolling prairie',
+    'a narrow alley in the rain',
+    'an old movie theater',
+    'a busy outdoor market',
+    'a concrete overpass',
+    'a rooftop garden above a city',
+    'a canal with boats',
+    'a glass skyscraper',
+    'a subway station',
+    'a cobblestone square',
+    'an open-air night market',
+    'a bookshop with tall shelves',
+    'an arcade with game machines',
+    'a cathedral interior',
+    'a cabin interior during a storm',
+    'an artist studio with paint everywhere',
+    'an abandoned hallway',
+    'a spaceship control room',
+    'a greenhouse full of plants',
+    'a small music club with a stage',
+    'a pottery workshop',
+    'a street musician playing violin',
+    'a fisherman mending nets',
+    'a dancer practicing alone',
+    'a blacksmith forging metal',
+    'a child chasing fireflies',
+    'a surfer riding a wave',
+    'a chef preparing food in a kitchen',
+    'a climber resting on a ridge',
+    'a painter working on a mural',
+    'a person walking through a temple garden',
+    'a wolf pack crossing a river',
+    'a hummingbird near flowers',
+    'an octopus moving through a shipwreck',
+    'wild horses galloping on a beach',
+    'a leopard on a cliff edge',
+    'an owl swooping through a forest',
+    'jellyfish drifting in deep water',
+    'a fox on a forest floor',
+    'a whale breaching the surface',
+    'flamingos on a lake',
+    'a city floating above clouds',
+    'a street vendor selling unusual wares',
+    'a dragon on a tower',
+    'an explorer in an alien jungle',
+    'a knight crossing a stone bridge',
+    'a person stepping out of a portal',
+    'a robot tending a garden',
+    'a potion brewer in a tower',
+    'a warrior standing in a flower field',
+    'a domed city underwater',
+    'a locomotive crossing a bridge',
+    'a sailboat on the open ocean',
+    'a motorcycle on a coastal road',
+    'a hot air balloon over a valley',
+    'a truck on a desert road',
+    'a fishing boat in rough seas',
+    'a bicycle leaning against a wall',
+    'a cable car over a gorge',
+    'a canoe on a still lake',
+    'a spaceship landing on a planet',
+    'a lightning storm over a field',
+    'a rainbow over a waterfall',
+    'a sandstorm approaching an oasis',
+    'an aurora over a tundra',
+    'fog rolling through a harbor',
+    'a downpour flooding a street',
+    'snowfall covering a village',
+    'heat shimmer over a highway',
+    'a wildfire on a ridge',
+    'rain falling on a garden',
+    'a table set for a feast outdoors',
+    'a bowl of soup in a small shop',
+    'a market stall with tropical fruits',
+    'a pastry display in a bakery',
+    'a campfire under the stars',
+    'ink dissolving in water',
+    'glass fragments mid-explosion',
+    'paint splashing on a canvas',
+    'smoke forming spirals',
+    'leaves caught in wind',
+];
+export const RANDOM_LYRICS_THEMES = [
+    'missing someone far away',
+    'falling for a stranger',
+    'letting go of the past',
+    'a love that came too late',
+    'growing apart from a friend',
+    'forgiving someone who hurt you',
+    'the moment before a first kiss',
+    'a letter you never sent',
+    'dancing alone in your room',
+    'waiting for a phone call',
+    'finding yourself after losing everything',
+    'pretending to be fine',
+    'the person you used to be',
+    'learning to trust yourself',
+    'the mask you wear for others',
+    'outgrowing your hometown',
+    'starting over in a new place',
+    'the voice inside your head',
+    'becoming someone unexpected',
+    'celebrating your own flaws',
+    'a road trip with no destination',
+    'the last day of summer',
+    'a conversation at 3am',
+    'running away from responsibility',
+    'a promise made in the rain',
+    'sneaking out at midnight',
+    'a goodbye at a train station',
+    'waking up in an unfamiliar place',
+    'a party that changed everything',
+    'chasing a dream everyone doubts',
+    'the ocean at night',
+    'walking through an empty city',
+    'a fire burning low',
+    'stars seen from a rooftop',
+    'a storm rolling in',
+    'footprints in fresh snow',
+    'a river that keeps flowing',
+    'the silence after thunder',
+    'a garden growing wild',
+    'the horizon at sunrise',
+    'time moving too fast',
+    'the weight of unspoken words',
+    'chasing shadows',
+    'a door that only opens once',
+    'the space between heartbeats',
+    'colors you cannot name',
+    'echoes of a forgotten song',
+    'building something from nothing',
+    'the price of freedom',
+    'a world inside a dream',
+];
+function pickRandom(items, random) {
+    return items[Math.floor(random() * items.length)];
+}
+export function getRandomTheme(random = Math.random) {
+    return pickRandom(RANDOM_THEMES, random);
+}
+export function getRandomLyricsTheme(random = Math.random) {
+    return pickRandom(RANDOM_LYRICS_THEMES, random);
+}
+//# sourceMappingURL=randomThemes.js.map

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

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