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

package/dist/contracts/musicComposition.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSTRUMENTAL_COMPOSITION_TOOL = exports.LYRICS_COMPOSITION_TOOL = exports.LYRICS_MAX_TOKENS = void 0;
+exports.buildLyricsMessages = buildLyricsMessages;
+exports.buildInstrumentalMessages = buildInstrumentalMessages;
+exports.parseToolCallResult = parseToolCallResult;
+const musicSettings_js_1 = require("../media/musicSettings.js");
+const randomThemes_js_1 = require("./randomThemes.js");
+exports.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.`;
+exports.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'],
+        },
+    },
+};
+exports.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'],
+        },
+    },
+};
+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 || (0, randomThemes_js_1.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: ${musicSettings_js_1.LANGUAGE_LABELS[language]}`;
+    }
+    messages.push({ role: 'user', content: userMessage });
+    return messages;
+}
+function buildInstrumentalMessages(prompt, musicPrompt, randomTheme) {
+    const messages = [{ role: 'system', content: INSTRUMENTAL_SYSTEM_PROMPT }];
+    let userMessage;
+    if (prompt.trim()) {
+        userMessage = prompt;
+    }
+    else {
+        const theme = randomTheme || (0, randomThemes_js_1.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(musicSettings_js_1.MUSIC_TIME_SIGNATURES);
+    if (signatures.includes(str))
+        return str;
+    return null;
+}
+function parseTempo(value) {
+    const num = Number(value);
+    if (!isNaN(num) && num >= musicSettings_js_1.MUSIC_BPM.min && num <= musicSettings_js_1.MUSIC_BPM.max)
+        return Math.round(num);
+    return null;
+}
+function parseDuration(value) {
+    const num = Number(value);
+    if (!isNaN(num) && num >= musicSettings_js_1.MUSIC_DURATION.min && num <= musicSettings_js_1.MUSIC_DURATION.max)
+        return Math.round(num);
+    return null;
+}
+function parseKeyScale(value) {
+    if (!value)
+        return null;
+    const str = String(value);
+    const found = musicSettings_js_1.MUSIC_KEY_SCALES.find((k) => k.toLowerCase() === str.toLowerCase());
+    return found || null;
+}
+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/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/contracts/promptContract.d.ts

@@ -0,0 +1,11 @@
+export interface PromptContract {
+    contractId: string;
+    version: string;
+    toolName: string;
+    baseDescription: string;
+    parameterDocs: Record<string, string>;
+    voiceExamples?: string[];
+    conditionalNotes?: Record<string, string>;
+}
+export declare function isPromptContract(value: unknown): value is PromptContract;
+//# sourceMappingURL=promptContract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promptContract.d.ts","sourceRoot":"","sources":["../../src/contracts/promptContract.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAE7B,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,EAAE,MAAM,CAAC;IAEhB,QAAQ,EAAE,MAAM,CAAC;IAEjB,eAAe,EAAE,MAAM,CAAC;IAExB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAMzB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAUD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAcxE"}

package/dist/contracts/promptContract.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPromptContract = isPromptContract;
+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;
+}
+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/contracts/promptContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptContract.js","sourceRoot":"","sources":["../../src/contracts/promptContract.ts"],"names":[],"mappings":";;AAkCA,4CAcC;AAtBD,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,SAAgB,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/contracts/promptOverrideMarker.d.ts

@@ -0,0 +1,2 @@
+export declare 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.d.ts.map

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

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

package/dist/contracts/promptOverrideMarker.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LITERAL_PROMPT_OVERRIDE = void 0;
+exports.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/contracts/promptOverrideMarker.js.map

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

package/dist/contracts/randomThemes.d.ts

@@ -0,0 +1,5 @@
+export declare const RANDOM_THEMES: readonly ["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 declare const RANDOM_LYRICS_THEMES: readonly ["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"];
+export declare function getRandomTheme(random?: () => number): string;
+export declare function getRandomLyricsTheme(random?: () => number): string;
+//# sourceMappingURL=randomThemes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"randomThemes.d.ts","sourceRoot":"","sources":["../../src/contracts/randomThemes.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa,spFA2FhB,CAAC;AAEX,eAAO,MAAM,oBAAoB,s8CAmDvB,CAAC;AAMX,wBAAgB,cAAc,CAAC,MAAM,GAAE,MAAM,MAAoB,GAAG,MAAM,CAEzE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAAM,MAAoB,GAAG,MAAM,CAE/E"}

package/dist/contracts/randomThemes.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RANDOM_LYRICS_THEMES = exports.RANDOM_THEMES = void 0;
+exports.getRandomTheme = getRandomTheme;
+exports.getRandomLyricsTheme = getRandomLyricsTheme;
+exports.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',
+];
+exports.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)];
+}
+function getRandomTheme(random = Math.random) {
+    return pickRandom(exports.RANDOM_THEMES, random);
+}
+function getRandomLyricsTheme(random = Math.random) {
+    return pickRandom(exports.RANDOM_LYRICS_THEMES, random);
+}
+//# sourceMappingURL=randomThemes.js.map

package/dist/contracts/randomThemes.js.map

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

package/dist/contracts/registry.d.ts

@@ -0,0 +1,29 @@
+import { type PromptContract } from './promptContract.js';
+import { type ToolGatingPolicy } from './toolGatingPolicy.js';
+import { type RepairRecipe } from './repairRecipe.js';
+import type { ToolCostMetadata } from './data/toolCostMetadata.js';
+import type { ToolPermission } from './data/toolPermissions.js';
+export declare class ContractRegistry {
+    private readonly promptContracts;
+    private readonly gatingPolicies;
+    private readonly repairRecipes;
+    private readonly toolCostMetadata;
+    private readonly toolPermissions;
+    registerPromptContract(contract: PromptContract): void;
+    registerGatingPolicy(policy: ToolGatingPolicy): void;
+    registerRepairRecipe(recipe: RepairRecipe): void;
+    registerToolCostMetadata(metadata: ToolCostMetadata): void;
+    registerToolPermission(permission: ToolPermission): void;
+    getPromptContract(toolName: string): PromptContract | undefined;
+    getGatingPolicy(policyId: string): ToolGatingPolicy | undefined;
+    findRepairRecipe(toolName: string, errorCode: string): RepairRecipe | undefined;
+    getToolCostMetadata(toolName: string): ToolCostMetadata | undefined;
+    getToolPermission(toolName: string): ToolPermission | undefined;
+    listPromptContracts(): PromptContract[];
+    listGatingPolicies(): ToolGatingPolicy[];
+    listRepairRecipes(): RepairRecipe[];
+    listToolCostMetadata(): ToolCostMetadata[];
+    listToolPermissions(): ToolPermission[];
+    private repairKey;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/contracts/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAiChE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IACrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuC;IACtE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmC;IACjE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuC;IACxE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IAErE,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAOtD,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAOpD,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAOhD,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAO1D,sBAAsB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAOxD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/D,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI/E,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAInE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/D,mBAAmB,IAAI,cAAc,EAAE;IAIvC,kBAAkB,IAAI,gBAAgB,EAAE;IAIxC,iBAAiB,IAAI,YAAY,EAAE;IAInC,oBAAoB,IAAI,gBAAgB,EAAE;IAI1C,mBAAmB,IAAI,cAAc,EAAE;IAIvC,OAAO,CAAC,SAAS;CAGlB"}

package/dist/contracts/registry.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractRegistry = void 0;
+const promptContract_js_1 = require("./promptContract.js");
+const toolGatingPolicy_js_1 = require("./toolGatingPolicy.js");
+const repairRecipe_js_1 = require("./repairRecipe.js");
+function isString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function isStringRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isToolCostMetadata(value) {
+    if (!isStringRecord(value))
+        return false;
+    return isString(value.tool)
+        && isString(value.costClass)
+        && ['safe', 'paid', 'destructive'].includes(String(value.riskLevel))
+        && isString(value.userVisibleCost)
+        && isString(value.description);
+}
+function isToolPermission(value) {
+    if (!isStringRecord(value))
+        return false;
+    return isString(value.tool)
+        && ['allow', 'require_user_approval', 'require_explicit_intent'].includes(String(value.decision))
+        && ['safe', 'paid', 'destructive'].includes(String(value.riskLevel))
+        && typeof value.requiresUserApproval === 'boolean'
+        && isString(value.userVisibleCost);
+}
+class ContractRegistry {
+    constructor() {
+        this.promptContracts = new Map();
+        this.gatingPolicies = new Map();
+        this.repairRecipes = new Map();
+        this.toolCostMetadata = new Map();
+        this.toolPermissions = new Map();
+    }
+    registerPromptContract(contract) {
+        if (!(0, promptContract_js_1.isPromptContract)(contract)) {
+            throw new Error(`Invalid PromptContract: ${JSON.stringify(contract)}`);
+        }
+        this.promptContracts.set(contract.toolName, contract);
+    }
+    registerGatingPolicy(policy) {
+        if (!(0, toolGatingPolicy_js_1.isToolGatingPolicy)(policy)) {
+            throw new Error(`Invalid ToolGatingPolicy: ${JSON.stringify(policy)}`);
+        }
+        this.gatingPolicies.set(policy.policyId, policy);
+    }
+    registerRepairRecipe(recipe) {
+        if (!(0, repairRecipe_js_1.isRepairRecipe)(recipe)) {
+            throw new Error(`Invalid RepairRecipe: ${JSON.stringify(recipe)}`);
+        }
+        this.repairRecipes.set(this.repairKey(recipe.toolName, recipe.errorCode), recipe);
+    }
+    registerToolCostMetadata(metadata) {
+        if (!isToolCostMetadata(metadata)) {
+            throw new Error(`Invalid ToolCostMetadata: ${JSON.stringify(metadata)}`);
+        }
+        this.toolCostMetadata.set(metadata.tool, metadata);
+    }
+    registerToolPermission(permission) {
+        if (!isToolPermission(permission)) {
+            throw new Error(`Invalid ToolPermission: ${JSON.stringify(permission)}`);
+        }
+        this.toolPermissions.set(permission.tool, permission);
+    }
+    getPromptContract(toolName) {
+        return this.promptContracts.get(toolName);
+    }
+    getGatingPolicy(policyId) {
+        return this.gatingPolicies.get(policyId);
+    }
+    findRepairRecipe(toolName, errorCode) {
+        return this.repairRecipes.get(this.repairKey(toolName, errorCode));
+    }
+    getToolCostMetadata(toolName) {
+        return this.toolCostMetadata.get(toolName);
+    }
+    getToolPermission(toolName) {
+        return this.toolPermissions.get(toolName);
+    }
+    listPromptContracts() {
+        return Array.from(this.promptContracts.values());
+    }
+    listGatingPolicies() {
+        return Array.from(this.gatingPolicies.values());
+    }
+    listRepairRecipes() {
+        return Array.from(this.repairRecipes.values());
+    }
+    listToolCostMetadata() {
+        return Array.from(this.toolCostMetadata.values());
+    }
+    listToolPermissions() {
+        return Array.from(this.toolPermissions.values());
+    }
+    repairKey(toolName, errorCode) {
+        return `${toolName}::${errorCode}`;
+    }
+}
+exports.ContractRegistry = ContractRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/contracts/registry.js.map

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

package/dist/contracts/repairRecipe.d.ts

@@ -0,0 +1,14 @@
+export type RepairRecipeMode = 'autoRepair' | 'suggestFollowup' | 'stopAndAsk';
+export interface RepairRecipe {
+    recipeId: string;
+    version: string;
+    toolName: string;
+    errorCode: string;
+    mode: RepairRecipeMode;
+    maxRetries: number;
+    repairNoteTemplate: string;
+    autoRepairFields?: string[];
+    suggestedFollowupTool?: string;
+}
+export declare function isRepairRecipe(value: unknown): value is RepairRecipe;
+//# sourceMappingURL=repairRecipe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repairRecipe.d.ts","sourceRoot":"","sources":["../../src/contracts/repairRecipe.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,iBAAiB,GAAG,YAAY,CAAC;AAQ/E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IAKjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;IAEvB,UAAU,EAAE,MAAM,CAAC;IAKnB,kBAAkB,EAAE,MAAM,CAAC;IAK3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAK5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAkBpE"}