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

package/dist-esm/contracts/hostedComposition.js

@@ -0,0 +1,128 @@
+import { getRandomLyricsTheme, getRandomTheme } from './randomThemes.js';
+export const HOSTED_COMPOSITION_ROUTER_MAX_TOKENS = 512;
+export function buildEnhancePromptToolArgs(input) {
+    return {
+        prompt: input.prompt.trim() || `Come up with a unique, creative image inspired by: ${input.randomTheme || getRandomTheme()}. Be original and surprising.`,
+        target_output: input.targetOutput ?? 'image_prompt',
+        destination_tool: input.destinationTool ?? 'generate_image',
+        ...(input.destinationModel ? { destination_model: input.destinationModel } : {}),
+        ...(input.promptingType ? { prompting_type: input.promptingType } : {}),
+        ...(input.modelTitle ? { model_title: input.modelTitle } : {}),
+        ...(input.stylePrompt?.trim() ? { style_prompt: input.stylePrompt.trim() } : {}),
+    };
+}
+export function buildLyricsCompositionToolArgs(input) {
+    return {
+        prompt: input.prompt.trim() || `Come up with a unique, original song about: ${input.randomTheme || getRandomLyricsTheme()}. Be creative and surprising.`,
+        language: input.language ?? 'unknown',
+        ...(input.musicPrompt?.trim() ? { music_prompt: input.musicPrompt.trim() } : {}),
+    };
+}
+export function buildInstrumentalCompositionToolArgs(input) {
+    return {
+        prompt: input.prompt.trim() || `Come up with a unique, original instrumental piece inspired by: ${input.randomTheme || getRandomLyricsTheme()}. Be creative and surprising.`,
+        ...(input.musicPrompt?.trim() ? { music_prompt: input.musicPrompt.trim() } : {}),
+    };
+}
+export function buildScriptCompositionToolArgs(input) {
+    const brief = input.brief ?? input.prompt ?? '';
+    return {
+        brief: brief.trim() || input.firstFrameDescription?.trim() || `Come up with a unique, original video scene inspired by: ${input.randomTheme || getRandomTheme()}. Be creative and surprising.`,
+        script_type: input.scriptType ?? 'video_prompt',
+        destination_tool: input.destinationTool ?? 'generate_video',
+        ...(input.destinationModel ? { destination_model: input.destinationModel } : {}),
+        ...(input.durationSeconds ? { duration_seconds: input.durationSeconds } : {}),
+        ...(input.firstFrameDescription?.trim()
+            ? { first_frame_description: input.firstFrameDescription.trim() }
+            : {}),
+        ...(input.firstFrameDataUrl ? { first_frame_data_url: input.firstFrameDataUrl } : {}),
+        ...(input.lastFrameDataUrl ? { last_frame_data_url: input.lastFrameDataUrl } : {}),
+    };
+}
+export function buildComposeWorkflowToolArgs(input) {
+    const destinationModels = input.destinationModels ? {
+        ...(input.destinationModels.image ? { image: input.destinationModels.image } : {}),
+        ...(input.destinationModels.video ? { video: input.destinationModels.video } : {}),
+        ...(input.destinationModels.music ? { music: input.destinationModels.music } : {}),
+    } : undefined;
+    return {
+        brief: input.brief.trim(),
+        ...(typeof input.sceneCount === 'number' && Number.isFinite(input.sceneCount)
+            ? { scene_count: input.sceneCount }
+            : {}),
+        ...(typeof input.durationSeconds === 'number' && Number.isFinite(input.durationSeconds)
+            ? { duration_seconds: input.durationSeconds }
+            : {}),
+        ...(input.aspectRatio?.trim() ? { aspect_ratio: input.aspectRatio.trim() } : {}),
+        ...(input.style?.trim() ? { style: input.style.trim() } : {}),
+        ...(destinationModels && Object.keys(destinationModels).length > 0
+            ? { destination_models: destinationModels }
+            : {}),
+        ...(typeof input.maxEstimatedCapacityUnits === 'number'
+            && Number.isFinite(input.maxEstimatedCapacityUnits)
+            ? { max_estimated_capacity_units: input.maxEstimatedCapacityUnits }
+            : {}),
+        ...(typeof input.includeAudio === 'boolean' ? { include_audio: input.includeAudio } : {}),
+        ...(input.returnFormat ? { return_format: input.returnFormat } : {}),
+    };
+}
+export function buildComposeWorkflowTemplateToolArgs(input) {
+    const base = buildComposeWorkflowToolArgs(input);
+    const out = { ...base, name: input.name.trim() };
+    const description = input.description?.trim();
+    if (description)
+        out.description = description;
+    if (input.category)
+        out.category = input.category;
+    if (input.visibility)
+        out.visibility = input.visibility;
+    if (input.inputs && input.inputs.length > 0) {
+        out.inputs = input.inputs.map((decl) => {
+            const entry = { name: decl.name, type: decl.type };
+            if (decl.required !== undefined)
+                entry.required = decl.required;
+            if (decl.description?.trim())
+                entry.description = decl.description.trim();
+            if (decl.default !== undefined)
+                entry.default = decl.default;
+            if (decl.options && decl.options.length > 0)
+                entry.options = decl.options;
+            if (decl.multiple)
+                entry.multiple = decl.multiple;
+            if (decl.internal !== undefined)
+                entry.internal = decl.internal;
+            return entry;
+        });
+    }
+    if (input.existingTemplate) {
+        out.existing_template = input.existingTemplate;
+    }
+    return out;
+}
+export function buildWanScriptCompositionToolArgs(params) {
+    return buildScriptCompositionToolArgs({
+        brief: params.prompt,
+        destinationModel: 'wan22',
+        durationSeconds: params.duration,
+        firstFrameDescription: params.firstFrameDescription,
+        firstFrameDataUrl: params.firstFrameDataUrl,
+        lastFrameDataUrl: params.lastFrameDataUrl,
+        randomTheme: params.randomTheme,
+    });
+}
+export function buildHostedCompositionToolMessages(request) {
+    return [
+        {
+            role: 'system',
+            content: 'You are a strict dispatcher for Sogni synchronous creative tools. Call the requested tool exactly once with the exact JSON arguments supplied by the user. Do not rewrite, summarize, or add creative content in this dispatch step.',
+        },
+        {
+            role: 'user',
+            content: JSON.stringify({
+                tool: request.toolName,
+                arguments: request.arguments,
+            }),
+        },
+    ];
+}
+//# sourceMappingURL=hostedComposition.js.map

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

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

package/dist-esm/contracts/hostedToolValidation.js

@@ -0,0 +1,296 @@
+function matchesType(value, type) {
+    switch (type) {
+        case 'array':
+            return Array.isArray(value);
+        case 'integer':
+            return typeof value === 'number' && Number.isInteger(value);
+        case 'number':
+            return typeof value === 'number' && Number.isFinite(value);
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'object':
+            return typeof value === 'object' && value !== null && !Array.isArray(value);
+        case 'string':
+            return typeof value === 'string';
+        case 'null':
+            return value === null;
+        default:
+            return true;
+    }
+}
+function typeLabel(type) {
+    if (Array.isArray(type))
+        return type.join(' or ');
+    return type ?? 'valid value';
+}
+function typeList(type) {
+    if (!type)
+        return [];
+    return Array.isArray(type) ? type : [type];
+}
+function formatEnum(values) {
+    return values.map(value => JSON.stringify(value)).join(', ');
+}
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function valuesEqual(left, right) {
+    if (Object.is(left, right))
+        return true;
+    if (typeof left !== typeof right)
+        return false;
+    if (left === null || right === null)
+        return left === right;
+    if (typeof left !== 'object')
+        return false;
+    try {
+        return JSON.stringify(left) === JSON.stringify(right);
+    }
+    catch {
+        return false;
+    }
+}
+function coerceValueForTypes(value, allowedTypes) {
+    if (typeof value !== 'string')
+        return { value, coerced: false };
+    const trimmed = value.trim();
+    if (!trimmed)
+        return { value, coerced: false };
+    if (allowedTypes.includes('integer') || allowedTypes.includes('number')) {
+        const numberValue = Number(trimmed);
+        if (Number.isFinite(numberValue)
+            && (!allowedTypes.includes('integer') || Number.isInteger(numberValue))) {
+            return { value: numberValue, coerced: true };
+        }
+    }
+    if (allowedTypes.includes('boolean')) {
+        if (/^(?:true|false)$/i.test(trimmed)) {
+            return { value: trimmed.toLowerCase() === 'true', coerced: true };
+        }
+    }
+    return { value, coerced: false };
+}
+function validateNumberBounds(path, value, schema, errors) {
+    if (schema.minimum !== undefined && value < schema.minimum) {
+        errors.push(`Argument "${path}" must be at least ${schema.minimum}`);
+    }
+    if (schema.maximum !== undefined && value > schema.maximum) {
+        errors.push(`Argument "${path}" must be at most ${schema.maximum}`);
+    }
+    if (typeof schema.exclusiveMinimum === 'number' && value <= schema.exclusiveMinimum) {
+        errors.push(`Argument "${path}" must be greater than ${schema.exclusiveMinimum}`);
+    }
+    if (typeof schema.exclusiveMaximum === 'number' && value >= schema.exclusiveMaximum) {
+        errors.push(`Argument "${path}" must be less than ${schema.exclusiveMaximum}`);
+    }
+    if (schema.exclusiveMinimum === true && schema.minimum !== undefined && value <= schema.minimum) {
+        errors.push(`Argument "${path}" must be greater than ${schema.minimum}`);
+    }
+    if (schema.exclusiveMaximum === true && schema.maximum !== undefined && value >= schema.maximum) {
+        errors.push(`Argument "${path}" must be less than ${schema.maximum}`);
+    }
+}
+function validateStringConstraints(path, value, schema, errors) {
+    if (schema.minLength !== undefined && value.length < schema.minLength) {
+        errors.push(`Argument "${path}" must contain at least ${schema.minLength} character${schema.minLength === 1 ? '' : 's'}`);
+    }
+    if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+        errors.push(`Argument "${path}" must contain at most ${schema.maxLength} character${schema.maxLength === 1 ? '' : 's'}`);
+    }
+    if (schema.pattern) {
+        try {
+            if (!new RegExp(`^(?:${schema.pattern})$`).test(value)) {
+                errors.push(`Argument "${path}" must match pattern ${JSON.stringify(schema.pattern)}`);
+            }
+        }
+        catch {
+            errors.push(`Schema for "${path}" contains invalid pattern ${JSON.stringify(schema.pattern)}`);
+        }
+    }
+}
+function validateCompositeSchema(path, value, schema, context) {
+    if (schema.allOf) {
+        let nextValue = value;
+        for (const childSchema of schema.allOf) {
+            const result = validateValueAgainstSchema(path, nextValue, childSchema, context);
+            nextValue = result.value;
+        }
+        return { matched: true, value: nextValue };
+    }
+    const alternatives = schema.oneOf ?? schema.anyOf;
+    if (!alternatives)
+        return { matched: true, value };
+    const matches = [];
+    for (const childSchema of alternatives) {
+        const trial = {
+            ...context,
+            errors: [],
+            warnings: [],
+        };
+        const result = validateValueAgainstSchema(path, value, childSchema, trial);
+        if (trial.errors.length === 0)
+            matches.push(result.value);
+    }
+    if (schema.oneOf && matches.length !== 1) {
+        context.errors.push(`Argument "${path}" must match exactly one allowed schema`);
+        return { matched: false, value };
+    }
+    if (schema.anyOf && matches.length < 1) {
+        context.errors.push(`Argument "${path}" must match at least one allowed schema`);
+        return { matched: false, value };
+    }
+    return { matched: true, value: matches[0] ?? value };
+}
+function validateObjectAgainstSchema(path, value, schema, context) {
+    const properties = schema.properties ?? {};
+    const cleaned = {};
+    for (const required of schema.required ?? []) {
+        const propValue = value[required];
+        const isMissing = propValue === undefined
+            || propValue === null
+            || propValue === ''
+            || (Array.isArray(propValue) && propValue.length === 0);
+        if (isMissing) {
+            context.errors.push(`Missing required argument "${path ? `${path}.` : ''}${required}"`);
+        }
+    }
+    for (const [name, entryValue] of Object.entries(value)) {
+        if (entryValue === undefined || entryValue === null) {
+            if (name in properties || !context.stripUnknownProperties)
+                cleaned[name] = entryValue;
+            continue;
+        }
+        const property = properties[name];
+        if (!property) {
+            if (schema.additionalProperties === false || context.stripUnknownProperties) {
+                context.warnings.push(`Stripped unknown argument "${path ? `${path}.` : ''}${name}"`);
+            }
+            else if (isRecord(schema.additionalProperties)) {
+                cleaned[name] = validateValueAgainstSchema(path ? `${path}.${name}` : name, entryValue, schema.additionalProperties, context).value;
+            }
+            else {
+                cleaned[name] = entryValue;
+            }
+            continue;
+        }
+        cleaned[name] = validateValueAgainstSchema(path ? `${path}.${name}` : name, entryValue, property, context).value;
+    }
+    return cleaned;
+}
+function validateArrayAgainstSchema(path, value, schema, context) {
+    if (schema.minItems !== undefined && value.length < schema.minItems) {
+        context.errors.push(`Argument "${path}" must contain at least ${schema.minItems} item${schema.minItems === 1 ? '' : 's'}`);
+    }
+    if (schema.maxItems !== undefined && value.length > schema.maxItems) {
+        context.errors.push(`Argument "${path}" must contain at most ${schema.maxItems} item${schema.maxItems === 1 ? '' : 's'}`);
+    }
+    if (!schema.items)
+        return value;
+    if (Array.isArray(schema.items)) {
+        const tupleSchemas = schema.items;
+        return value.map((item, index) => {
+            const itemSchema = tupleSchemas[index];
+            return itemSchema
+                ? validateValueAgainstSchema(`${path}[${index}]`, item, itemSchema, context).value
+                : item;
+        });
+    }
+    return value.map((item, index) => validateValueAgainstSchema(`${path}[${index}]`, item, schema.items, context).value);
+}
+function validateValueAgainstSchema(path, rawValue, schema, context) {
+    const composite = validateCompositeSchema(path, rawValue, schema, context);
+    if (!composite.matched)
+        return { value: rawValue };
+    let value = composite.value;
+    const allowedTypes = typeList(schema.type);
+    if (context.coercePrimitives
+        && allowedTypes.length > 0
+        && !allowedTypes.some(type => matchesType(value, type))) {
+        const coerced = coerceValueForTypes(value, allowedTypes);
+        if (coerced.coerced) {
+            context.warnings.push(`Coerced argument "${path}" to ${typeof coerced.value}`);
+            value = coerced.value;
+        }
+    }
+    if (allowedTypes.length > 0 && !allowedTypes.some(type => matchesType(value, type))) {
+        context.errors.push(`Argument "${path}" must be ${typeLabel(schema.type)}`);
+        return { value };
+    }
+    if (schema.const !== undefined && !valuesEqual(value, schema.const)) {
+        context.errors.push(`Argument "${path}" must be ${JSON.stringify(schema.const)}`);
+    }
+    if (schema.enum
+        && !context.skipEnumProperties.has(path)
+        && !context.skipEnumProperties.has(path.split('.').at(-1) ?? path)
+        && !schema.enum.some(candidate => valuesEqual(candidate, value))) {
+        context.errors.push(`Argument "${path}" must be one of ${formatEnum(schema.enum)}`);
+    }
+    if (typeof value === 'number') {
+        validateNumberBounds(path, value, schema, context.errors);
+    }
+    if (typeof value === 'string') {
+        validateStringConstraints(path, value, schema, context.errors);
+    }
+    if (Array.isArray(value)) {
+        value = validateArrayAgainstSchema(path, value, schema, context);
+    }
+    if (isRecord(value)) {
+        value = validateObjectAgainstSchema(path, value, schema, context);
+    }
+    return { value };
+}
+export function validateAndNormalizeHostedToolArguments(tools, toolName, args, options = {}) {
+    if (!args || typeof args !== 'object' || Array.isArray(args)) {
+        return {
+            ok: false,
+            errors: ['Tool arguments must be a JSON object'],
+            cleaned: {},
+            warnings: [],
+        };
+    }
+    const tool = tools.find(candidate => candidate.function.name === toolName);
+    if (!tool) {
+        return {
+            ok: false,
+            errors: [`Unknown hosted Sogni tool "${toolName}"`],
+            cleaned: args,
+            warnings: [],
+        };
+    }
+    const schema = tool.function.parameters;
+    if (!schema) {
+        return { ok: true, errors: [], cleaned: args, warnings: [] };
+    }
+    const context = {
+        skipEnumProperties: new Set(options.skipEnumProperties ?? ['model']),
+        coercePrimitives: options.coercePrimitives === true,
+        stripUnknownProperties: options.stripUnknownProperties === true,
+        errors: [],
+        warnings: [],
+    };
+    const normalizedSchema = {
+        ...schema,
+        type: schema.type ?? 'object',
+    };
+    const cleaned = validateValueAgainstSchema('', args, normalizedSchema, context).value;
+    return {
+        ok: context.errors.length === 0,
+        errors: context.errors,
+        cleaned: isRecord(cleaned) ? cleaned : args,
+        warnings: context.warnings,
+    };
+}
+export function validateHostedToolArguments(tools, toolName, args, options = {}) {
+    const result = validateAndNormalizeHostedToolArguments(tools, toolName, args, options);
+    return {
+        ok: result.ok,
+        errors: result.errors,
+    };
+}
+export function assertHostedToolArguments(tools, toolName, args, options) {
+    const result = validateHostedToolArguments(tools, toolName, args, options);
+    if (!result.ok) {
+        throw new Error(`Invalid ${toolName} arguments: ${result.errors.join('; ')}`);
+    }
+}
+//# sourceMappingURL=hostedToolValidation.js.map

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

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

package/dist-esm/contracts/idLoraPrompt.js

@@ -0,0 +1,72 @@
+export const ID_LORA_MAX_TOKENS = 1024;
+const ID_LORA_SYSTEM_PROMPT = `You restructure dense cinematic LTX video prompts into the three-section format used by ID-LoRA, an identity-preserving audio-video generation model. This is a structural transform — preserve every piece of information from the input, do not summarize, do not drop detail. Every piece of input information must appear in exactly one section. Return your result via the compose_id_lora_prompt tool.
+
+SECTION RULES:
+
+[VISUAL]: Scene, subject appearance (age, build, hair, clothing, distinguishing features), setting, lighting, camera shot/movement, and physically visible action. Be descriptive — include shot type, colors, clothing, background details. MUST mention that the person is speaking to avoid voice-overs (e.g. "his mouth moves as he speaks", "she talks animatedly", "lips move in time with the words"). Physical acting beats belong here. Dialogue WORDS must NOT appear here — replace any quoted speech with narrative descriptions like "starts speaking", "continues talking", "pauses mid-sentence". Keep present-tense and concrete. No ambient sound descriptions here.
+
+[SPEECH]: Raw transcript ONLY — the literal words spoken, no quotation marks, no attribution ("he says"), no acting descriptions, no stage directions. Use \`...\` for pauses or beats between phrases.
+  - If the source contains quoted dialogue, use it verbatim.
+  - If the source mentions speaking/talking/whispering but provides no exact words, leave this empty and keep only the visible mouth movement / vocal delivery cues in [VISUAL] or [SOUNDS]. Do not invent words.
+  - If the source has no speech cues at all, leave this empty.
+
+[SOUNDS]: Controls both speaking style AND ambient audio. First describe the speaker's vocal qualities (tone, volume, pace, microphone proximity, accent — e.g. "warm male voice, close mic, conversational pace"). Then describe ambient and environmental audio from the source (music, room noise, weather, sound effects). 1-3 sentences combined.
+
+EXAMPLE:
+
+Input:
+"You know, I used to think this was a bad idea," he says while pausing to light a cigarette, "But now I'm not so sure." Warm bar lighting, low jazz playing.
+
+Output:
+visual: Medium shot in a warm-lit bar. A man looks at the camera, starts speaking, pauses to take out a cigarette and light it, then continues talking while exhaling a little smoke. Natural hand motion, subtle pause during the lighting action, his mouth moves clearly in sync with the words.
+speech: You know, I used to think this was a bad idea. ... But now I'm not so sure.
+sounds: Calm conversational male voice, close mic, brief pause mid-sentence. Lighter flick and cigarette inhale audible, low jazz plays softly in the background, quiet bar ambience.`;
+export const ID_LORA_COMPOSITION_TOOL = {
+    type: 'function',
+    function: {
+        name: 'compose_id_lora_prompt',
+        description: 'Output the LTX prompt restructured into ID-LoRA visual/speech/sounds sections.',
+        parameters: {
+            type: 'object',
+            properties: {
+                visual: {
+                    type: 'string',
+                    description: 'Scene, subject appearance, lighting, camera, and visible action. No dialogue, no ambient sound.',
+                },
+                speech: {
+                    type: 'string',
+                    description: 'Literal words spoken by the subject, verbatim, no quotes. Empty string if the source has no speech.',
+                },
+                sounds: {
+                    type: 'string',
+                    description: "Speaker vocal qualities (volume, tone, mic proximity) followed by ambient/background audio.",
+                },
+            },
+            required: ['visual', 'speech', 'sounds'],
+        },
+    },
+};
+export function buildIdLoRaConversionMessages(ltxPrompt) {
+    return [
+        { role: 'system', content: ID_LORA_SYSTEM_PROMPT },
+        {
+            role: 'user',
+            content: `Convert this LTX prompt to ID-LoRA format:\n\n${ltxPrompt.trim()}`,
+        },
+    ];
+}
+export function parseToolCallIdLoRaParts(args) {
+    return {
+        visual: String(args.visual || '').trim(),
+        speech: String(args.speech || '').trim(),
+        sounds: String(args.sounds || '').trim(),
+    };
+}
+export function formatIdLoRaPrompt(parts) {
+    const lines = [`[VISUAL]: ${parts.visual}`];
+    if (parts.speech)
+        lines.push(`[SPEECH]: ${parts.speech}`);
+    lines.push(`[SOUNDS]: ${parts.sounds}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=idLoraPrompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idLoraPrompt.js","sourceRoot":"","sources":["../../src/contracts/idLoraPrompt.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEvC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;sLAqBwJ,CAAC;AAEvL,MAAM,CAAC,MAAM,wBAAwB,GAAmB;IACtD,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,gFAAgF;QAC7F,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,iGAAiG;iBACpG;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,qGAAqG;iBACxG;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,6FAA6F;iBAChG;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;SACzC;KACF;CACF,CAAC;AAQF,MAAM,UAAU,6BAA6B,CAAC,SAAiB;IAC7D,OAAO;QACL,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,EAAE;QAClD;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,iDAAiD,SAAS,CAAC,IAAI,EAAE,EAAE;SAC7E;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAA6B;IACpE,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACxC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACxC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IACzD,MAAM,KAAK,GAAG,CAAC,aAAa,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}