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

package/dist/skills/asset_reference_management/manifest.js

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAssetManifest = createAssetManifest;
+exports.addAsset = addAsset;
+exports.updateAsset = updateAsset;
+exports.findAsset = findAsset;
+exports.mapAssetsForModel = mapAssetsForModel;
+exports.validateAssetReferences = validateAssetReferences;
+exports.listAssets = listAssets;
+const modelRefRegistry_js_1 = require("./modelRefRegistry.js");
+function createAssetManifest() {
+    return {
+        assets: [],
+        next_index: 1,
+        updated_at: new Date().toISOString(),
+    };
+}
+const ASSET_ID_PATTERN = /^[A-Za-z0-9_.:/-]+$/;
+const MAX_ASSET_ID_LENGTH = 128;
+function validateAssetIdOrThrow(rawId) {
+    if (rawId.length === 0) {
+        return;
+    }
+    if (rawId.length > MAX_ASSET_ID_LENGTH) {
+        throw new Error(`Invalid asset_id: must be at most ${MAX_ASSET_ID_LENGTH} characters`);
+    }
+    if (!ASSET_ID_PATTERN.test(rawId)) {
+        throw new Error('Invalid asset_id: must match /^[A-Za-z0-9_.:/-]+$/ (no whitespace, control chars, or punctuation)');
+    }
+}
+function addAsset(manifest, input) {
+    const requestedId = (input.asset_id ?? `asset_${manifest.next_index.toString().padStart(3, '0')}`).trim();
+    validateAssetIdOrThrow(requestedId);
+    const existingIds = new Set(manifest.assets.map((asset) => asset.asset_id));
+    let asset_id = requestedId || `asset_${manifest.next_index.toString().padStart(3, '0')}`;
+    if (existingIds.has(asset_id)) {
+        const base = asset_id;
+        let suffix = 2;
+        while (existingIds.has(`${base}_${suffix}`))
+            suffix += 1;
+        asset_id = `${base}_${suffix}`;
+    }
+    const asset = {
+        asset_id,
+        user_label: input.user_label.trim() || asset_id,
+        type: input.type,
+        description: input.description?.trim() || undefined,
+        url: input.url?.trim() || undefined,
+        must_preserve: input.must_preserve?.length ? [...input.must_preserve] : undefined,
+        avoid: input.avoid?.length ? [...input.avoid] : undefined,
+        metadata: input.metadata,
+    };
+    return {
+        manifest: {
+            assets: [...manifest.assets, asset],
+            next_index: manifest.next_index + 1,
+            updated_at: new Date().toISOString(),
+        },
+        asset,
+    };
+}
+function updateAsset(manifest, input) {
+    const idx = manifest.assets.findIndex((a) => a.asset_id === input.asset_id);
+    if (idx < 0)
+        return null;
+    const prev = manifest.assets[idx];
+    const next = {
+        ...prev,
+        user_label: input.user_label?.trim() ? input.user_label.trim() : prev.user_label,
+        description: input.description !== undefined
+            ? input.description.trim() || undefined
+            : prev.description,
+        must_preserve: input.must_preserve ? [...input.must_preserve] : prev.must_preserve,
+        avoid: input.avoid ? [...input.avoid] : prev.avoid,
+        metadata: input.metadata !== undefined ? input.metadata : prev.metadata,
+        url: input.url !== undefined ? input.url.trim() || undefined : prev.url,
+    };
+    const assets = [...manifest.assets];
+    assets[idx] = next;
+    return {
+        manifest: { ...manifest, assets, updated_at: new Date().toISOString() },
+        asset: next,
+    };
+}
+function findAsset(manifest, selector) {
+    if (selector.asset_id) {
+        const byId = manifest.assets.find((a) => a.asset_id === selector.asset_id);
+        if (byId)
+            return byId;
+    }
+    if (selector.user_label) {
+        const target = selector.user_label.trim().toLowerCase();
+        if (target) {
+            const byLabel = manifest.assets.find((a) => a.user_label.toLowerCase() === target);
+            if (byLabel)
+                return byLabel;
+        }
+    }
+    return null;
+}
+function mapAssetsForModel(manifest, modelId) {
+    const perTypeIndex = new Map();
+    const out = [];
+    for (const asset of manifest.assets) {
+        const next = (perTypeIndex.get(asset.type) ?? 0) + 1;
+        perTypeIndex.set(asset.type, next);
+        out.push({
+            asset_id: asset.asset_id,
+            user_label: asset.user_label,
+            type: asset.type,
+            model_ref: (0, modelRefRegistry_js_1.formatModelRef)(modelId, next, asset.type),
+        });
+    }
+    return out;
+}
+function normalizeLabelForMatching(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[_-]+/g, ' ')
+        .replace(/[^\p{L}\p{N}]+/gu, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function metadataAliases(metadata) {
+    const rawAliases = metadata?.aliases ?? metadata?.alias;
+    if (typeof rawAliases === 'string')
+        return [rawAliases];
+    if (!Array.isArray(rawAliases))
+        return [];
+    return rawAliases.filter((item) => typeof item === 'string');
+}
+function labelCandidatesForAsset(asset) {
+    return [asset.user_label, ...metadataAliases(asset.metadata)]
+        .map((label) => label.trim())
+        .filter((label, index, labels) => label.length > 0 && labels.indexOf(label) === index);
+}
+function normalizedTextMentionsLabel(normalizedText, normalizedLabel) {
+    if (!normalizedText || !normalizedLabel)
+        return false;
+    return ` ${normalizedText} `.includes(` ${normalizedLabel} `);
+}
+function ambiguousLabelsForPrompt(manifest, promptText) {
+    const normalizedText = normalizeLabelForMatching(promptText);
+    if (!normalizedText)
+        return [];
+    const labelsByNormalized = new Map();
+    for (const asset of manifest.assets) {
+        for (const label of labelCandidatesForAsset(asset)) {
+            const normalized = normalizeLabelForMatching(label);
+            if (!normalized)
+                continue;
+            const entry = labelsByNormalized.get(normalized) ?? {
+                display: label,
+                assetIds: new Set(),
+            };
+            entry.assetIds.add(asset.asset_id);
+            labelsByNormalized.set(normalized, entry);
+        }
+    }
+    const ambiguous = [];
+    for (const [normalized, entry] of labelsByNormalized) {
+        if (entry.assetIds.size < 2)
+            continue;
+        if (!normalizedTextMentionsLabel(normalizedText, normalized))
+            continue;
+        ambiguous.push(entry.display);
+    }
+    return ambiguous.sort((a, b) => a.localeCompare(b));
+}
+function validateAssetReferences(manifest, modelId, promptText) {
+    const fmt = (0, modelRefRegistry_js_1.getModelRefFormat)(modelId);
+    const mapping = mapAssetsForModel(manifest, modelId);
+    const refToAsset = new Map(mapping.map((m) => [m.model_ref, m]));
+    const resolved = [];
+    const dangling = [];
+    const text = promptText || '';
+    const seenTokens = new Set();
+    for (const match of text.matchAll(fmt.scanRegex)) {
+        const token = match[0];
+        if (seenTokens.has(token))
+            continue;
+        seenTokens.add(token);
+        const hit = refToAsset.get(token);
+        if (hit) {
+            resolved.push({ token, asset_id: hit.asset_id, user_label: hit.user_label });
+            continue;
+        }
+        const parsed = fmt.parse(token);
+        if (!parsed) {
+            dangling.push({ token, reason: 'unknown_model_ref' });
+            continue;
+        }
+        const sameType = mapping.filter((m) => !parsed.type || m.type === parsed.type);
+        const aliasHit = sameType[parsed.index - 1];
+        if (aliasHit) {
+            resolved.push({ token, asset_id: aliasHit.asset_id, user_label: aliasHit.user_label });
+        }
+        else if (sameType.length === 0 || parsed.index > sameType.length) {
+            dangling.push({ token, reason: 'index_out_of_range' });
+        }
+        else {
+            dangling.push({ token, reason: 'unknown_model_ref' });
+        }
+    }
+    for (const entry of (0, modelRefRegistry_js_1.getModelRefFormatEntries)()) {
+        const otherFormat = entry.format;
+        if (otherFormat === fmt)
+            continue;
+        for (const match of text.matchAll(otherFormat.scanRegex)) {
+            const token = match[0];
+            if (seenTokens.has(token))
+                continue;
+            const parsedByTarget = fmt.parse(token);
+            if (parsedByTarget)
+                continue;
+            const parsedByOther = otherFormat.parse(token);
+            if (!parsedByOther)
+                continue;
+            seenTokens.add(token);
+            dangling.push({
+                token,
+                reason: 'wrong_model_ref_format',
+                expected_model_id: modelId,
+            });
+        }
+    }
+    return {
+        resolved,
+        dangling,
+        ambiguous_labels: ambiguousLabelsForPrompt(manifest, text),
+    };
+}
+function listAssets(manifest) {
+    return manifest.assets;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/skills/asset_reference_management/manifest.js.map

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

package/dist/skills/asset_reference_management/modelRefRegistry.d.ts

@@ -0,0 +1,24 @@
+import type { AssetType, KnownAssetModelId } from './types.js';
+export interface ParsedModelRef {
+    index: number;
+    type?: AssetType;
+}
+export interface ModelRefFormat {
+    format(index: number, type: AssetType): string;
+    parse(token: string): ParsedModelRef | null;
+    scanRegex: RegExp;
+}
+export interface ModelRefFormatResolution {
+    format: ModelRefFormat;
+    model_id: KnownAssetModelId | 'unknown';
+    fell_back: boolean;
+}
+export declare function getModelRefFormat(modelId: string): ModelRefFormat;
+export declare function getModelRefFormatResolution(modelId: string): ModelRefFormatResolution;
+export declare function getModelRefFormatEntries(): ReadonlyArray<{
+    model_id: KnownAssetModelId;
+    format: ModelRefFormat;
+}>;
+export declare function formatModelRef(modelId: string, index: number, type: AssetType): string;
+export declare function listKnownAssetModelIds(): KnownAssetModelId[];
+//# sourceMappingURL=modelRefRegistry.d.ts.map

package/dist/skills/asset_reference_management/modelRefRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelRefRegistry.d.ts","sourceRoot":"","sources":["../../../src/skills/asset_reference_management/modelRefRegistry.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,cAAc;IAE7B,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAE5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;CACpB;AA8ED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAEjE;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,CAoCrF;AAED,wBAAgB,wBAAwB,IAAI,aAAa,CAAC;IACxD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC,CASD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAEtF;AAED,wBAAgB,sBAAsB,IAAI,iBAAiB,EAAE,CAE5D"}

package/dist/skills/asset_reference_management/modelRefRegistry.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getModelRefFormat = getModelRefFormat;
+exports.getModelRefFormatResolution = getModelRefFormatResolution;
+exports.getModelRefFormatEntries = getModelRefFormatEntries;
+exports.formatModelRef = formatModelRef;
+exports.listKnownAssetModelIds = listKnownAssetModelIds;
+const SEEDANCE_FORMAT = {
+    format(index, type) {
+        if (type === 'video')
+            return `@Video${index}`;
+        if (type === 'audio')
+            return `@Audio${index}`;
+        return `@Image${index}`;
+    },
+    parse(token) {
+        const m = /^@(Image|Video|Audio)(\d+)$/.exec(token.trim());
+        if (!m)
+            return null;
+        const idx = Number.parseInt(m[2], 10);
+        if (!Number.isFinite(idx) || idx < 1)
+            return null;
+        const t = m[1] === 'Video' ? 'video' : m[1] === 'Audio' ? 'audio' : 'image';
+        return { index: idx, type: t };
+    },
+    scanRegex: /@(?:Image|Video|Audio)\d+/g,
+};
+const GPT_IMAGE_2_FORMAT = {
+    format(index, type) {
+        if (type === 'video')
+            return `Video ${index}`;
+        if (type === 'audio')
+            return `Audio ${index}`;
+        return `Image ${index}`;
+    },
+    parse(token) {
+        const m = /^(Image|Video|Audio)\s+(\d+)$/.exec(token.trim());
+        if (!m)
+            return null;
+        const kind = m[1];
+        const idx = Number.parseInt(m[2], 10);
+        if (!Number.isFinite(idx) || idx < 1)
+            return null;
+        const t = kind === 'Video' ? 'video' : kind === 'Audio' ? 'audio' : 'image';
+        return { index: idx, type: t };
+    },
+    scanRegex: /(?<!@)(?<!\b[Gg][Pp][Tt]\s)(?:\[(?:Image|Video|Audio)\s+\d+\]|\b(?:Image|Video|Audio)\s+\d+\b)/g,
+};
+const CONTEXT_FORMAT = {
+    format(index, type) {
+        const slot = Math.max(0, index - 1);
+        if (type === 'video')
+            return `context_video_${slot}`;
+        if (type === 'audio')
+            return `context_audio_${slot}`;
+        return `context_image_${slot}`;
+    },
+    parse(token) {
+        const m = /^context_(image|video|audio)_(\d+)$/.exec(token.trim());
+        if (!m)
+            return null;
+        const slot = Number.parseInt(m[2], 10);
+        if (!Number.isFinite(slot) || slot < 0)
+            return null;
+        return {
+            index: slot + 1,
+            type: m[1],
+        };
+    },
+    scanRegex: /context_(?:image|video|audio)_\d+/g,
+};
+const MODEL_REF_FORMATS = {
+    seedance: SEEDANCE_FORMAT,
+    'gpt-image-2': GPT_IMAGE_2_FORMAT,
+    ltx23: CONTEXT_FORMAT,
+    wan: CONTEXT_FORMAT,
+    'qwen-image-edit': CONTEXT_FORMAT,
+    flux: GPT_IMAGE_2_FORMAT,
+};
+function cloneGlobalRegex(regex) {
+    return new RegExp(regex.source, regex.flags.includes('g') ? regex.flags : `${regex.flags}g`);
+}
+function getModelRefFormat(modelId) {
+    return getModelRefFormatResolution(modelId).format;
+}
+function getModelRefFormatResolution(modelId) {
+    const trimmed = modelId.trim().toLowerCase();
+    if (trimmed in MODEL_REF_FORMATS) {
+        return {
+            format: MODEL_REF_FORMATS[trimmed],
+            model_id: trimmed,
+            fell_back: false,
+        };
+    }
+    if (trimmed.startsWith('seedance'))
+        return { format: SEEDANCE_FORMAT, model_id: 'seedance', fell_back: false };
+    if (trimmed.startsWith('gpt-image') || trimmed.startsWith('flux')) {
+        return {
+            format: GPT_IMAGE_2_FORMAT,
+            model_id: trimmed.startsWith('flux') ? 'flux' : 'gpt-image-2',
+            fell_back: false,
+        };
+    }
+    if (trimmed.startsWith('ltx') ||
+        trimmed.startsWith('wan') ||
+        trimmed.startsWith('qwen-image')) {
+        return {
+            format: CONTEXT_FORMAT,
+            model_id: trimmed.startsWith('wan') ? 'wan' : trimmed.startsWith('qwen-image') ? 'qwen-image-edit' : 'ltx23',
+            fell_back: false,
+        };
+    }
+    console.warn(`[ASSET REF] Unknown model_id "${modelId}" fell back to GPT Image 2 model_ref format.`);
+    return {
+        format: GPT_IMAGE_2_FORMAT,
+        model_id: 'unknown',
+        fell_back: true,
+    };
+}
+function getModelRefFormatEntries() {
+    return Object.entries(MODEL_REF_FORMATS)
+        .map(([model_id, format]) => ({
+        model_id,
+        format: {
+            ...format,
+            scanRegex: cloneGlobalRegex(format.scanRegex),
+        },
+    }));
+}
+function formatModelRef(modelId, index, type) {
+    return getModelRefFormat(modelId).format(index, type);
+}
+function listKnownAssetModelIds() {
+    return Object.keys(MODEL_REF_FORMATS);
+}
+//# sourceMappingURL=modelRefRegistry.js.map

package/dist/skills/asset_reference_management/modelRefRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelRefRegistry.js","sourceRoot":"","sources":["../../../src/skills/asset_reference_management/modelRefRegistry.ts"],"names":[],"mappings":";;AAiHA,8CAEC;AAED,kEAoCC;AAED,4DAYC;AAED,wCAEC;AAED,wDAEC;AA1ID,MAAM,eAAe,GAAmB;IACtC,MAAM,CAAC,KAAK,EAAE,IAAI;QAChB,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,SAAS,KAAK,EAAE,CAAC;QAC9C,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,SAAS,KAAK,EAAE,CAAC;QAC9C,OAAO,SAAS,KAAK,EAAE,CAAC;IAC1B,CAAC;IACD,KAAK,CAAC,KAAK;QACT,MAAM,CAAC,GAAG,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,CAAC,GAAc,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACvF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACjC,CAAC;IACD,SAAS,EAAE,4BAA4B;CACxC,CAAC;AAEF,MAAM,kBAAkB,GAAmB;IACzC,MAAM,CAAC,KAAK,EAAE,IAAI;QAChB,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,SAAS,KAAK,EAAE,CAAC;QAC9C,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,SAAS,KAAK,EAAE,CAAC;QAC9C,OAAO,SAAS,KAAK,EAAE,CAAC;IAC1B,CAAC;IACD,KAAK,CAAC,KAAK;QACT,MAAM,CAAC,GAAG,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACnB,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,CAAC,GAAc,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACvF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACjC,CAAC;IACD,SAAS,EAAE,iGAAiG;CAC7G,CAAC;AAMF,MAAM,cAAc,GAAmB;IACrC,MAAM,CAAC,KAAK,EAAE,IAAI;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,iBAAiB,IAAI,EAAE,CAAC;QACrD,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,iBAAiB,IAAI,EAAE,CAAC;QACrD,OAAO,iBAAiB,IAAI,EAAE,CAAC;IACjC,CAAC;IACD,KAAK,CAAC,KAAK;QACT,MAAM,CAAC,GAAG,qCAAqC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACpD,OAAO;YACL,KAAK,EAAE,IAAI,GAAG,CAAC;YACf,IAAI,EAAE,CAAC,CAAC,CAAC,CAAc;SACxB,CAAC;IACJ,CAAC;IACD,SAAS,EAAE,oCAAoC;CAChD,CAAC;AAEF,MAAM,iBAAiB,GAA8C;IACnE,QAAQ,EAAE,eAAe;IACzB,aAAa,EAAE,kBAAkB;IACjC,KAAK,EAAE,cAAc;IACrB,GAAG,EAAE,cAAc;IACnB,iBAAiB,EAAE,cAAc;IACjC,IAAI,EAAE,kBAAkB;CACzB,CAAC;AAEF,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;AAC/F,CAAC;AAMD,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,OAAO,2BAA2B,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AACrD,CAAC;AAED,SAAgB,2BAA2B,CAAC,OAAe;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,IAAI,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACjC,OAAO;YACL,MAAM,EAAE,iBAAiB,CAAC,OAA4B,CAAC;YACvD,QAAQ,EAAE,OAA4B;YACtC,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAGD,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC/G,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,MAAM,EAAE,kBAAkB;YAC1B,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa;YAC7D,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IACD,IACE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;QACzB,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;QACzB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAChC,CAAC;QACD,OAAO;YACL,MAAM,EAAE,cAAc;YACtB,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO;YAC5G,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,iCAAiC,OAAO,8CAA8C,CAAC,CAAC;IACrG,OAAO;QACL,MAAM,EAAE,kBAAkB;QAC1B,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,SAAgB,wBAAwB;IAItC,OAAQ,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAgD;SACrF,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5B,QAAQ;QACR,MAAM,EAAE;YACN,GAAG,MAAM;YACT,SAAS,EAAE,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC;SAC9C;KACF,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAgB,cAAc,CAAC,OAAe,EAAE,KAAa,EAAE,IAAe;IAC5E,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,SAAgB,sBAAsB;IACpC,OAAO,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAwB,CAAC;AAC/D,CAAC"}

package/dist/skills/asset_reference_management/types.d.ts

@@ -0,0 +1,31 @@
+export type AssetType = 'image' | 'video' | 'audio';
+export interface AssetRecord {
+    asset_id: string;
+    user_label: string;
+    description?: string;
+    type: AssetType;
+    url?: string;
+    must_preserve?: readonly string[];
+    avoid?: readonly string[];
+    metadata?: Readonly<Record<string, unknown>>;
+}
+export interface AssetManifest {
+    assets: readonly AssetRecord[];
+    next_index: number;
+    updated_at: string;
+}
+export type KnownAssetModelId = 'seedance' | 'ltx23' | 'gpt-image-2' | 'wan' | 'qwen-image-edit' | 'flux';
+export interface AssetReferenceValidationResult {
+    resolved: ReadonlyArray<{
+        token: string;
+        asset_id: string;
+        user_label: string;
+    }>;
+    dangling: ReadonlyArray<{
+        token: string;
+        reason: 'unknown_label' | 'unknown_model_ref' | 'index_out_of_range' | 'wrong_model_ref_format';
+        expected_model_id?: string;
+    }>;
+    ambiguous_labels: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/asset_reference_management/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/skills/asset_reference_management/types.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAGpD,MAAM,WAAW,WAAW;IAE1B,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,EAAE,SAAS,CAAC;IAEhB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE1B,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9C;AAGD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAE/B,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,OAAO,GACP,aAAa,GACb,KAAK,GACL,iBAAiB,GACjB,MAAM,CAAC;AAOX,MAAM,WAAW,8BAA8B;IAE7C,QAAQ,EAAE,aAAa,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IAEH,QAAQ,EAAE,aAAa,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,eAAe,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,wBAAwB,CAAC;QAChG,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC,CAAC;IAOH,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC"}

package/dist/skills/asset_reference_management/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/skills/asset_reference_management/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/skills/asset_reference_management/types.ts"],"names":[],"mappings":""}

package/dist/tools/definitions/add-subtitles/definition.d.ts

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

package/dist/tools/definitions/add-subtitles/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/tools/definitions/add-subtitles/definition.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,2BAA2B,sCAAuC,CAAC;AAEhF,eAAO,MAAM,UAAU,EAAE,cAkFxB,CAAC"}

package/dist/tools/definitions/add-subtitles/definition.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definition = exports.SUBTITLE_VERTICAL_POSITIONS = void 0;
+exports.SUBTITLE_VERTICAL_POSITIONS = ['bottom', 'top', 'center'];
+exports.definition = {
+    type: 'function',
+    function: {
+        name: 'add_subtitles',
+        description: 'Burn subtitles into a video from caller-supplied cues or an SRT/VTT string. ' +
+            'Use when the user asks to add captions, subtitles, on-screen dialogue, or burned-in lyrics to a video. ' +
+            'Either pass `cues` as an array of {startSeconds, endSeconds, text}, or pass a full `srt` string. ' +
+            'Pace cues like real subtitles: split the script into multiple short cues (typically 1.5–4 seconds each, ' +
+            '~1–8 words per cue, roughly 15–20 characters per second of cue duration). Never burn a single cue that ' +
+            'spans the entire clip — even a static image should get progressively revealed lines, not one paragraph ' +
+            'held on screen the whole time. ' +
+            'Auto-transcription (auto_transcribe=true) is not yet enabled and will return USER_INPUT_INCOMPLETE — ' +
+            'when the user has not supplied lines, ask them for the cue text and timing instead of calling with auto_transcribe. ' +
+            'If the user explicitly asks you to write, invent, improvise, or make up captions/subtitles, create a few short, ' +
+            'generic cue lines yourself and call this tool with cues; do not ask a follow-up for exact wording in that case.',
+        parameters: {
+            type: 'object',
+            properties: {
+                sourceVideoIndex: {
+                    type: 'number',
+                    description: 'Which video to subtitle. Default: -1 (most recent generated or uploaded video). ' +
+                        'Non-negative values are 0-based indices into prior generated video results. ' +
+                        'Negative values reference uploaded videos.',
+                },
+                cues: {
+                    type: 'array',
+                    description: 'Ordered subtitle cues. Each cue has startSeconds, endSeconds, and the line of text to display. ' +
+                        'Provide either `cues` or `srt`, not both. Aim for multiple short cues (1.5–4s each, ~1–8 words) ' +
+                        'rather than one long cue spanning the full clip.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            startSeconds: { type: 'number', minimum: 0 },
+                            endSeconds: { type: 'number', minimum: 0 },
+                            text: { type: 'string' },
+                        },
+                        required: ['startSeconds', 'endSeconds', 'text'],
+                    },
+                },
+                srt: {
+                    type: 'string',
+                    description: 'Full SRT (or VTT) document as a string, used in place of `cues`. Useful when the user pastes ' +
+                        'a subtitle file directly. Provide either `cues` or `srt`, not both.',
+                },
+                auto_transcribe: {
+                    type: 'boolean',
+                    description: 'Reserved for future speech-to-text support. Currently returns USER_INPUT_INCOMPLETE so the LLM ' +
+                        'can ask the user to supply cues. Do not set this — gather cue text from the user instead.',
+                },
+                style: {
+                    type: 'object',
+                    description: 'Optional styling overrides for the burned subtitles.',
+                    properties: {
+                        fontSizePct: {
+                            type: 'number',
+                            minimum: 1,
+                            maximum: 30,
+                            description: 'Font size as a percentage of the video height. Default 6.',
+                        },
+                        color: {
+                            type: 'string',
+                            description: 'Subtitle fill color. Default "#FFFFFF".',
+                        },
+                        outlineColor: {
+                            type: 'string',
+                            description: 'Subtitle outline color. Default "#000000".',
+                        },
+                        position: {
+                            type: 'string',
+                            enum: [...exports.SUBTITLE_VERTICAL_POSITIONS],
+                            description: 'Vertical placement of the subtitle line. Default "bottom".',
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=definition.js.map

package/dist/tools/definitions/add-subtitles/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/tools/definitions/add-subtitles/definition.ts"],"names":[],"mappings":";;;AAYa,QAAA,2BAA2B,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAEnE,QAAA,UAAU,GAAmB;IACxC,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,8EAA8E;YAC9E,yGAAyG;YACzG,mGAAmG;YACnG,0GAA0G;YAC1G,yGAAyG;YACzG,yGAAyG;YACzG,iCAAiC;YACjC,uGAAuG;YACvG,sHAAsH;YACtH,kHAAkH;YAClH,iHAAiH;QACnH,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,kFAAkF;wBAClF,8EAA8E;wBAC9E,4CAA4C;iBAC/C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,WAAW,EACT,iGAAiG;wBACjG,kGAAkG;wBAClG,kDAAkD;oBACpD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;4BAC5C,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;4BAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yBACzB;wBACD,QAAQ,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,MAAM,CAAC;qBACjD;iBACF;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,+FAA+F;wBAC/F,qEAAqE;iBACxE;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,iGAAiG;wBACjG,2FAA2F;iBAC9F;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;oBACnE,UAAU,EAAE;wBACV,WAAW,EAAE;4BACX,IAAI,EAAE,QAAQ;4BACd,OAAO,EAAE,CAAC;4BACV,OAAO,EAAE,EAAE;4BACX,WAAW,EAAE,2DAA2D;yBACzE;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,yCAAyC;yBACvD;wBACD,YAAY,EAAE;4BACZ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,4CAA4C;yBAC1D;wBACD,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,GAAG,mCAA2B,CAAC;4BACtC,WAAW,EAAE,4DAA4D;yBAC1E;qBACF;iBACF;aACF;SACF;KACF;CACF,CAAC"}

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

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

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

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