zcw-shared 2.25.0 → 2.27.0

package/dist/functions/ai/applyAiAgentAvatar3dFace.js

@@ -0,0 +1,140 @@
+import { deriveAvatar3dCapabilities, isMonolithicTextureAvatar, listAvatar3dMeshInventory, } from './agentAvatar3dCapabilities.js';
+import { isArkitBlendshapeModel, isArkitMorphCatalogIdBound, morphSliderToArkitInfluence, morphSliderToSymmetricInfluence, resolveArkitCatalogMorphNames, } from './agentAvatar3dArkitMorph.js';
+import { canTintAvatar3dMaterial, resolveAvatar3dMaterialTintTarget, } from './agentAvatar3dMaterialTint.js';
+import { resolveAvatar3dMorphBindings } from './agentAvatar3dMorphCatalog.js';
+import { getEffectiveAvatar3dMorphWeights } from './getEffectiveAvatar3dMorphWeights.js';
+import { mergeAvatar3dFaceWithDefaults, normalizeAiAgentAvatar3dFace, } from './normalizeAiAgentAvatar3dFace.js';
+function applyMaterialColor(mat, hex) {
+    if (!mat?.color?.set)
+        return;
+    try {
+        mat.color.set(hex);
+    }
+    catch {
+    }
+}
+function resetMorphInfluences(influences) {
+    for (let i = 0; i < influences.length; i++)
+        influences[i] = 0;
+}
+function setMorphInfluenceAt(influences, idx, amount) {
+    if (idx < 0 || idx >= influences.length)
+        return;
+    influences[idx] = amount;
+}
+function applyMorphAtNames(dict, influences, morphNames, amount) {
+    for (const morphName of morphNames) {
+        const idx = dict[morphName];
+        if (idx === undefined)
+            continue;
+        setMorphInfluenceAt(influences, idx, amount);
+    }
+}
+function applyLegacyMorphInfluence(dict, influences, morphName, sliderValue, arkit) {
+    const amount = arkit
+        ? morphSliderToArkitInfluence(sliderValue)
+        : morphSliderToSymmetricInfluence(sliderValue);
+    applyMorphAtNames(dict, influences, [morphName], amount);
+}
+export function applyAiAgentAvatar3dFace(root, cfg) {
+    if (!root?.traverse)
+        return;
+    const faceRaw = cfg && 'face' in cfg
+        ? cfg.face
+        : cfg;
+    const face = mergeAvatar3dFaceWithDefaults(normalizeAiAgentAvatar3dFace(faceRaw));
+    const morphWeights = getEffectiveAvatar3dMorphWeights(face);
+    const inventory = listAvatar3dMeshInventory(root);
+    const monolithic = isMonolithicTextureAvatar(inventory);
+    const capabilities = deriveAvatar3dCapabilities({
+        useProcedural: false,
+        inventory,
+        morphNames: listAvatar3dMorphNames(root),
+    });
+    const modelMorphNames = [];
+    root.traverse((child) => {
+        if (!child?.isMesh)
+            return;
+        const dict = child.morphTargetDictionary;
+        if (!dict)
+            return;
+        for (const name of Object.keys(dict))
+            modelMorphNames.push(name);
+    });
+    const uniqueMorphNames = [...new Set(modelMorphNames)];
+    const arkit = isArkitBlendshapeModel(uniqueMorphNames);
+    const bindings = resolveAvatar3dMorphBindings(uniqueMorphNames);
+    root.traverse((child) => {
+        if (!child?.isMesh)
+            return;
+        const mesh = child;
+        const meshName = String(mesh.name ?? '');
+        const materials = Array.isArray(mesh.material)
+            ? mesh.material
+            : mesh.material
+                ? [mesh.material]
+                : [];
+        for (const mat of materials) {
+            if (!canTintAvatar3dMaterial(mat))
+                continue;
+            const matName = String(mat?.name ?? '');
+            const tintTarget = resolveAvatar3dMaterialTintTarget(meshName, matName, {
+                monolithic,
+            });
+            if (tintTarget === 'hair' &&
+                capabilities.colors.hair &&
+                face.hairColor) {
+                applyMaterialColor(mat, face.hairColor);
+            }
+            else if (tintTarget === 'eye' &&
+                capabilities.colors.eye &&
+                face.eyeColor) {
+                applyMaterialColor(mat, face.eyeColor);
+            }
+            else if (tintTarget === 'skin' &&
+                capabilities.colors.skin &&
+                face.skinColor) {
+                applyMaterialColor(mat, face.skinColor);
+            }
+        }
+        const dict = mesh.morphTargetDictionary;
+        const influences = mesh.morphTargetInfluences;
+        if (!dict || !influences?.length)
+            return;
+        resetMorphInfluences(influences);
+        for (const [catalogId, sliderValue] of Object.entries(morphWeights)) {
+            if (sliderValue === undefined || sliderValue === 0)
+                continue;
+            if (arkit && isArkitMorphCatalogIdBound(catalogId, uniqueMorphNames)) {
+                const { positive, negative } = resolveArkitCatalogMorphNames(catalogId, uniqueMorphNames);
+                if (sliderValue > 0 && positive.length) {
+                    applyMorphAtNames(dict, influences, positive, morphSliderToArkitInfluence(sliderValue));
+                }
+                else if (sliderValue < 0 && negative.length) {
+                    applyMorphAtNames(dict, influences, negative, morphSliderToArkitInfluence(-sliderValue));
+                }
+                continue;
+            }
+            const morphName = bindings[catalogId];
+            if (!morphName)
+                continue;
+            applyLegacyMorphInfluence(dict, influences, morphName, sliderValue, arkit);
+        }
+    });
+}
+export function listAvatar3dMorphNames(root) {
+    const names = new Set();
+    if (!root?.traverse)
+        return [];
+    root.traverse((child) => {
+        if (!child?.isMesh)
+            return;
+        const dict = child.morphTargetDictionary;
+        if (!dict)
+            return;
+        for (const name of Object.keys(dict))
+            names.add(name);
+    });
+    return [...names].sort();
+}
+//# sourceMappingURL=applyAiAgentAvatar3dFace.js.map

package/dist/functions/ai/applyAiAgentAvatar3dFace.js.map

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

package/dist/functions/ai/buildResolvedLlmToolsList.d.ts

@@ -11,4 +11,3 @@ export declare function buildResolvedLlmToolsList(params: {
     rowToOpenAiTool: (row: AiToolCatalogRowForLlmResolve) => unknown;
     rowToOpenAiMcpTool: (row: AiMcpCatalogRowForLlmResolve, wire: McpToolsWireFormat) => Record<string, unknown>;
 }): unknown[];
-export declare const buildResolvedLlmToolsListPure: typeof buildResolvedLlmToolsList;

package/dist/functions/ai/buildResolvedLlmToolsList.js

@@ -25,5 +25,4 @@ export function buildResolvedLlmToolsList(params) {
     }
     return out;
 }
-export const buildResolvedLlmToolsListPure = buildResolvedLlmToolsList;
 //# sourceMappingURL=buildResolvedLlmToolsList.js.map

package/dist/functions/ai/buildResolvedLlmToolsList.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildResolvedLlmToolsList.js","sourceRoot":"","sources":["../../../src/functions/ai/buildResolvedLlmToolsList.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAGvE,MAAM,UAAU,yBAAyB,CAAC,MAazC;IACC,MAAM,GAAG,GAAc,EAAE,CAAA;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAQ;QACxB,IACE,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,EAC1E,CAAC;YACD,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAAE,SAAQ;QAC1C,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAQ;QACxB,IACE,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,EACxE,CAAC;YACD,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACzD,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC;YAAE,SAAQ;QAC9D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAGD,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAA"}
+{"version":3,"file":"buildResolvedLlmToolsList.js","sourceRoot":"","sources":["../../../src/functions/ai/buildResolvedLlmToolsList.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAGvE,MAAM,UAAU,yBAAyB,CAAC,MAazC;IACC,MAAM,GAAG,GAAc,EAAE,CAAA;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAQ;QACxB,IACE,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,EAC1E,CAAC;YACD,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAAE,SAAQ;QAC1C,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAQ;QACxB,IACE,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,EACxE,CAAC;YACD,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACzD,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC;YAAE,SAAQ;QAC9D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/functions/ai/getEffectiveAvatar3dMorphWeights.d.ts

@@ -0,0 +1,3 @@
+import type { AiAgentAvatar3dFace } from '../../../types/ai-agent';
+export declare function mergeLegacyFaceFieldsToMorphWeights(face: AiAgentAvatar3dFace): Record<string, number>;
+export declare function getEffectiveAvatar3dMorphWeights(face?: AiAgentAvatar3dFace | null): Record<string, number>;

package/dist/functions/ai/getEffectiveAvatar3dMorphWeights.js

@@ -0,0 +1,28 @@
+import { AVATAR3D_LEGACY_FACE_TO_CATALOG, createEmptyAvatar3dMorphWeights, listAvatar3dMorphCatalogIds, } from './agentAvatar3dMorphCatalog.js';
+export function mergeLegacyFaceFieldsToMorphWeights(face) {
+    const base = { ...(face.morphWeights ?? {}) };
+    for (const [legacyKey, catalogId] of Object.entries(AVATAR3D_LEGACY_FACE_TO_CATALOG)) {
+        const v = face[legacyKey];
+        if (typeof v !== 'number' || !Number.isFinite(v))
+            continue;
+        if (base[catalogId] === undefined || base[catalogId] === 0) {
+            base[catalogId] = Math.max(-1, Math.min(1, v));
+        }
+    }
+    return base;
+}
+export function getEffectiveAvatar3dMorphWeights(face) {
+    const empty = createEmptyAvatar3dMorphWeights();
+    if (!face)
+        return empty;
+    const merged = mergeLegacyFaceFieldsToMorphWeights(face);
+    const out = { ...empty };
+    for (const id of listAvatar3dMorphCatalogIds()) {
+        const v = merged[id];
+        if (v !== undefined && Number.isFinite(v)) {
+            out[id] = Math.max(-1, Math.min(1, v));
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=getEffectiveAvatar3dMorphWeights.js.map

package/dist/functions/ai/getEffectiveAvatar3dMorphWeights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEffectiveAvatar3dMorphWeights.js","sourceRoot":"","sources":["../../../src/functions/ai/getEffectiveAvatar3dMorphWeights.ts"],"names":[],"mappings":"AACA,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,6BAA6B,CAAA;AAGpC,MAAM,UAAU,mCAAmC,CACjD,IAAyB;IAEzB,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAA;IAC7C,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,+BAA+B,CAAC,EAAE,CAAC;QACrF,MAAM,CAAC,GAAI,IAAgC,CAAC,SAAS,CAAC,CAAA;QACtD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,SAAQ;QAC1D,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAGD,MAAM,UAAU,gCAAgC,CAC9C,IAAiC;IAEjC,MAAM,KAAK,GAAG,+BAA+B,EAAE,CAAA;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IACvB,MAAM,MAAM,GAAG,mCAAmC,CAAC,IAAI,CAAC,CAAA;IACxD,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;IACxB,KAAK,MAAM,EAAE,IAAI,2BAA2B,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAA;QACpB,IAAI,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACxC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/functions/ai/normalizeAiAgentAvatar3d.d.ts

@@ -0,0 +1,4 @@
+import type { AiAgentAvatar3d } from '../../../types/ai-agent';
+export declare function normalizeAiAgentAvatar3d(raw: unknown): AiAgentAvatar3d;
+export declare function isEmptyAiAgentAvatar3d(cfg: AiAgentAvatar3d): boolean;
+export declare function finalizeAiAgentAvatar3dForStorage(cfg: AiAgentAvatar3d): AiAgentAvatar3d;

package/dist/functions/ai/normalizeAiAgentAvatar3d.js

@@ -0,0 +1,57 @@
+import { AVATAR3D_BUILTIN_HUMANOID } from './proceduralHumanoidMorph.js';
+import { normalizeAiAgentAvatar3dFace } from './normalizeAiAgentAvatar3dFace.js';
+import { normalizeAiAgentAvatar3dModular } from './normalizeAiAgentAvatar3dModular.js';
+import { modularAvatar3dBaseStoragePath } from './normalizeAiAgentAvatar3dModular.js';
+import { DEFAULT_AGENT_AVATAR_3D_MODEL_PATH } from '../../constants/agentAvatar3d.js';
+const MAX_SCALE = 20;
+const MIN_SCALE = 0.05;
+export function normalizeAiAgentAvatar3d(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return {};
+    const o = raw;
+    const modelUrl = String(o.modelUrl ?? o.model_url ?? '').trim();
+    const builtinRaw = String(o.builtin ?? '').trim();
+    const builtin = builtinRaw === AVATAR3D_BUILTIN_HUMANOID ? AVATAR3D_BUILTIN_HUMANOID : undefined;
+    const modular = normalizeAiAgentAvatar3dModular(o.modular);
+    if (!modelUrl && !builtin && !modular)
+        return {};
+    const scaleRaw = Number(o.scale);
+    const scale = Number.isFinite(scaleRaw) && scaleRaw > 0
+        ? Math.min(MAX_SCALE, Math.max(MIN_SCALE, scaleRaw))
+        : 1;
+    const rotRaw = Number(o.rotationY ?? o.rotation_y);
+    const rotationY = Number.isFinite(rotRaw) ? rotRaw : 0;
+    const formatRaw = String(o.format ?? 'glb').trim().toLowerCase();
+    const format = formatRaw === 'fbx' || formatRaw === 'gltf' ? formatRaw : 'glb';
+    const face = normalizeAiAgentAvatar3dFace(o.face);
+    const effectiveModelUrl = modelUrl ||
+        (modular ? modularAvatar3dBaseStoragePath(modular) : undefined) ||
+        DEFAULT_AGENT_AVATAR_3D_MODEL_PATH;
+    return {
+        ...(modular ? { modular } : {}),
+        ...(builtin ? { builtin } : {}),
+        ...(effectiveModelUrl ? { modelUrl: effectiveModelUrl, format } : {}),
+        scale,
+        rotationY,
+        ...(face ? { face } : {}),
+    };
+}
+export function isEmptyAiAgentAvatar3d(cfg) {
+    return (!String(cfg.modelUrl ?? '').trim() &&
+        !cfg.builtin &&
+        !cfg.modular);
+}
+export function finalizeAiAgentAvatar3dForStorage(cfg) {
+    const modular = cfg.modular
+        ? normalizeAiAgentAvatar3dModular(cfg.modular)
+        : undefined;
+    if (!modular)
+        return cfg;
+    const basePath = modularAvatar3dBaseStoragePath(modular);
+    return {
+        ...cfg,
+        modular,
+        ...(basePath ? { modelUrl: basePath } : {}),
+    };
+}
+//# sourceMappingURL=normalizeAiAgentAvatar3d.js.map

package/dist/functions/ai/normalizeAiAgentAvatar3d.js.map

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

package/dist/functions/ai/normalizeAiAgentAvatar3dFace.d.ts

@@ -0,0 +1,4 @@
+import type { AiAgentAvatar3dFace } from '../../../types/ai-agent';
+export declare const DEFAULT_AVATAR3D_FACE: AiAgentAvatar3dFace;
+export declare function normalizeAiAgentAvatar3dFace(raw: unknown): AiAgentAvatar3dFace | undefined;
+export declare function mergeAvatar3dFaceWithDefaults(face?: AiAgentAvatar3dFace | null): AiAgentAvatar3dFace;

package/dist/functions/ai/normalizeAiAgentAvatar3dFace.js

@@ -0,0 +1,84 @@
+const HEX6 = /^#[0-9a-f]{6}$/i;
+export const DEFAULT_AVATAR3D_FACE = {
+    skinColor: '#ffdbac',
+    hairColor: '#3d2314',
+    eyeColor: '#4a6741',
+    faceWidth: 0,
+    faceRound: 0,
+    eyeSize: 0,
+    noseSize: 0,
+    mouthSize: 0,
+};
+function normalizeHexColor(raw) {
+    const s = String(raw ?? '').trim();
+    if (HEX6.test(s))
+        return s.toLowerCase();
+    if (/^[0-9a-f]{6}$/i.test(s))
+        return `#${s.toLowerCase()}`;
+    return undefined;
+}
+function clampMorph(raw) {
+    const n = Number(raw);
+    if (!Number.isFinite(n))
+        return undefined;
+    return Math.max(-1, Math.min(1, n));
+}
+import { listAvatar3dMorphCatalogIds, } from './agentAvatar3dMorphCatalog.js';
+function normalizeMorphWeights(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const allowed = new Set(listAvatar3dMorphCatalogIds());
+    const out = {};
+    for (const [k, v] of Object.entries(raw)) {
+        const key = String(k).trim();
+        if (!key || !allowed.has(key))
+            continue;
+        const w = clampMorph(v);
+        if (w === undefined || w === 0)
+            continue;
+        out[key] = w;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export function normalizeAiAgentAvatar3dFace(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const o = raw;
+    const face = {};
+    const skin = normalizeHexColor(o.skinColor ?? o.skin_color);
+    if (skin)
+        face.skinColor = skin;
+    const hair = normalizeHexColor(o.hairColor ?? o.hair_color);
+    if (hair)
+        face.hairColor = hair;
+    const eye = normalizeHexColor(o.eyeColor ?? o.eye_color);
+    if (eye)
+        face.eyeColor = eye;
+    const faceWidth = clampMorph(o.faceWidth ?? o.face_width);
+    if (faceWidth !== undefined)
+        face.faceWidth = faceWidth;
+    const faceRound = clampMorph(o.faceRound ?? o.face_round);
+    if (faceRound !== undefined)
+        face.faceRound = faceRound;
+    const eyeSize = clampMorph(o.eyeSize ?? o.eye_size);
+    if (eyeSize !== undefined)
+        face.eyeSize = eyeSize;
+    const noseSize = clampMorph(o.noseSize ?? o.nose_size);
+    if (noseSize !== undefined)
+        face.noseSize = noseSize;
+    const mouthSize = clampMorph(o.mouthSize ?? o.mouth_size);
+    if (mouthSize !== undefined)
+        face.mouthSize = mouthSize;
+    const morphWeights = normalizeMorphWeights(o.morphWeights ?? o.morph_weights);
+    if (morphWeights)
+        face.morphWeights = morphWeights;
+    return Object.keys(face).length > 0 ? face : undefined;
+}
+export function mergeAvatar3dFaceWithDefaults(face) {
+    return {
+        ...DEFAULT_AVATAR3D_FACE,
+        ...(face ?? {}),
+        morphWeights: { ...(face?.morphWeights ?? {}) },
+    };
+}
+//# sourceMappingURL=normalizeAiAgentAvatar3dFace.js.map

package/dist/functions/ai/normalizeAiAgentAvatar3dFace.js.map

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

package/dist/functions/ai/normalizeAiAgentAvatar3dModular.d.ts

@@ -0,0 +1,14 @@
+import type { AiAgentAvatar3dModular, AiAgentAvatar3dModularSlots } from '../../../types/ai-agent';
+import { type Avatar3dModularAttachMode, type Avatar3dModularSlotId } from '../../constants/agentAvatar3dModular';
+export declare function createEmptyAvatar3dModularSlots(): AiAgentAvatar3dModularSlots;
+export declare function normalizeAiAgentAvatar3dModularSlots(raw: unknown): AiAgentAvatar3dModularSlots;
+export declare function normalizeAiAgentAvatar3dModular(raw: unknown): AiAgentAvatar3dModular | undefined;
+export interface ResolvedAvatar3dModularLayer {
+    slot: Avatar3dModularSlotId | 'base';
+    partId: string;
+    storagePath: string;
+    attachMode: Avatar3dModularAttachMode | 'base';
+    hideBaseMeshHints?: string[];
+}
+export declare function resolveModularAvatar3dLayers(modular: AiAgentAvatar3dModular): ResolvedAvatar3dModularLayer[];
+export declare function modularAvatar3dBaseStoragePath(modular: AiAgentAvatar3dModular): string | undefined;

package/dist/functions/ai/normalizeAiAgentAvatar3dModular.js

@@ -0,0 +1,92 @@
+import { AVATAR3D_MODULAR_SLOT_ORDER, AVATAR3D_MODULAR_SYSTEM_VERSION, AVATAR3D_STANDARD_SKELETON_PROFILE, DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID, getAvatar3dModularBasePartById, getAvatar3dModularSlotPartById, normalizeModularBasePartId, } from '../../constants/agentAvatar3dModular.js';
+const SLOT_KEYS = [
+    'hair',
+    'top',
+    'bottom',
+    'shoes',
+    'gloves',
+    'headwear',
+    'faceAccessory',
+];
+function cleanPartId(raw) {
+    const id = String(raw ?? '').trim();
+    return id.length > 0 ? id : undefined;
+}
+export function createEmptyAvatar3dModularSlots() {
+    return {};
+}
+export function normalizeAiAgentAvatar3dModularSlots(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return createEmptyAvatar3dModularSlots();
+    }
+    const o = raw;
+    const slots = {};
+    for (const key of SLOT_KEYS) {
+        const id = cleanPartId(o[key]);
+        if (id)
+            slots[key] = id;
+    }
+    return slots;
+}
+export function normalizeAiAgentAvatar3dModular(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const o = raw;
+    const version = String(o.version ?? '').trim();
+    if (version !== AVATAR3D_MODULAR_SYSTEM_VERSION)
+        return undefined;
+    const rawBasePartId = cleanPartId(o.basePartId ?? o.base_part_id) ??
+        DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID;
+    const basePartId = normalizeModularBasePartId(rawBasePartId);
+    const baseMeta = getAvatar3dModularBasePartById(basePartId);
+    const slots = normalizeAiAgentAvatar3dModularSlots(o.slots);
+    const validatedSlots = {};
+    for (const [key, partId] of Object.entries(slots)) {
+        const meta = getAvatar3dModularSlotPartById(partId);
+        if (!meta)
+            continue;
+        validatedSlots[key] = partId;
+    }
+    return {
+        version: AVATAR3D_MODULAR_SYSTEM_VERSION,
+        basePartId: baseMeta ? basePartId : DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID,
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        slots: validatedSlots,
+    };
+}
+export function resolveModularAvatar3dLayers(modular) {
+    const basePartId = normalizeModularBasePartId(modular.basePartId);
+    const base = getAvatar3dModularBasePartById(basePartId);
+    if (!base)
+        return [];
+    const layers = [
+        {
+            slot: 'base',
+            partId: base.id,
+            storagePath: base.storagePath,
+            attachMode: 'base',
+        },
+    ];
+    for (const slotId of AVATAR3D_MODULAR_SLOT_ORDER) {
+        const slotKey = slotId;
+        const partId = modular.slots[slotKey];
+        if (!partId)
+            continue;
+        const meta = getAvatar3dModularSlotPartById(partId);
+        if (!meta || meta.slot !== slotId)
+            continue;
+        layers.push({
+            slot: slotId,
+            partId: meta.id,
+            storagePath: meta.storagePath,
+            attachMode: meta.attachMode,
+            hideBaseMeshHints: meta.hideBaseMeshHints,
+        });
+    }
+    return layers;
+}
+export function modularAvatar3dBaseStoragePath(modular) {
+    const base = getAvatar3dModularBasePartById(normalizeModularBasePartId(modular.basePartId));
+    return base?.storagePath;
+}
+//# sourceMappingURL=normalizeAiAgentAvatar3dModular.js.map

package/dist/functions/ai/normalizeAiAgentAvatar3dModular.js.map

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

package/dist/functions/ai/proceduralHumanoidMorph.d.ts

@@ -0,0 +1,5 @@
+import type { AiAgentAvatar3dFace } from '../../../types/ai-agent';
+export declare const AVATAR3D_BUILTIN_HUMANOID: "humanoid_v1";
+export type Avatar3dBuiltinId = typeof AVATAR3D_BUILTIN_HUMANOID;
+export declare function proceduralHumanoidMorphFactors(face?: AiAgentAvatar3dFace | null): Record<string, number>;
+export declare function morphToScaleFactor(v: number, span?: number): number;

package/dist/functions/ai/proceduralHumanoidMorph.js

@@ -0,0 +1,9 @@
+import { getEffectiveAvatar3dMorphWeights } from './getEffectiveAvatar3dMorphWeights.js';
+export const AVATAR3D_BUILTIN_HUMANOID = 'humanoid_v1';
+export function proceduralHumanoidMorphFactors(face) {
+    return getEffectiveAvatar3dMorphWeights(face);
+}
+export function morphToScaleFactor(v, span = 0.25) {
+    return 1 + v * span;
+}
+//# sourceMappingURL=proceduralHumanoidMorph.js.map

package/dist/functions/ai/proceduralHumanoidMorph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proceduralHumanoidMorph.js","sourceRoot":"","sources":["../../../src/functions/ai/proceduralHumanoidMorph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAA;AAGrF,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAsB,CAAA;AAK/D,MAAM,UAAU,8BAA8B,CAC5C,IAAiC;IAEjC,OAAO,gCAAgC,CAAC,IAAI,CAAC,CAAA;AAC/C,CAAC;AAGD,MAAM,UAAU,kBAAkB,CAAC,CAAS,EAAE,IAAI,GAAG,IAAI;IACvD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;AACrB,CAAC"}

package/dist/functions/ai/randomizeAgentAvatar3dAppearance.d.ts

@@ -0,0 +1,9 @@
+import type { AiAgentAvatar3dFace } from '../../../types/ai-agent';
+export interface RandomizedAgentAvatar3dAppearance {
+    modelUrl: string;
+    outfitModelUrl?: string;
+    accessoryModelUrl?: string;
+    face: AiAgentAvatar3dFace;
+    summary: string;
+}
+export declare function randomizeAgentAvatar3dAppearance(): RandomizedAgentAvatar3dAppearance;

package/dist/functions/ai/randomizeAgentAvatar3dAppearance.js

@@ -0,0 +1,108 @@
+import { BUILTIN_AGENT_AVATAR_3D_MODELS, getBuiltinAgentAvatar3dModelById, isRecommendedBuiltinAgentAvatar3dModel, } from '../../constants/agentAvatar3d.js';
+import { AGENT_AVATAR3D_FACE_PRESETS } from './agentAvatar3dFacePresets.js';
+import { createRandomAvatar3dMorphWeights, } from './agentAvatar3dMorphCatalog.js';
+import { applyAvatar3dFacePreset } from './agentAvatar3dFacePresets.js';
+import { mergeAvatar3dFaceWithDefaults } from './normalizeAiAgentAvatar3dFace.js';
+function pick(items) {
+    return items[Math.floor(Math.random() * items.length)];
+}
+function maybe(probability) {
+    return Math.random() < probability;
+}
+function storagePathForId(id) {
+    return getBuiltinAgentAvatar3dModelById(id)?.storagePath;
+}
+function recommendedIds(category) {
+    return BUILTIN_AGENT_AVATAR_3D_MODELS
+        .filter((m) => m.category === category && isRecommendedBuiltinAgentAvatar3dModel(m))
+        .map((m) => m.id);
+}
+function labelForId(id) {
+    return getBuiltinAgentAvatar3dModelById(id)?.label ?? id;
+}
+function randomFaceForMorphCapableBase() {
+    if (maybe(0.45) && AGENT_AVATAR3D_FACE_PRESETS.length > 0) {
+        const preset = pick(AGENT_AVATAR3D_FACE_PRESETS);
+        const applied = applyAvatar3dFacePreset(preset.id);
+        return mergeAvatar3dFaceWithDefaults({
+            morphWeights: applied.morphWeights,
+            skinColor: applied.skinColor,
+            hairColor: applied.hairColor,
+            eyeColor: applied.eyeColor,
+        });
+    }
+    return mergeAvatar3dFaceWithDefaults({
+        morphWeights: createRandomAvatar3dMorphWeights(),
+    });
+}
+export function randomizeAgentAvatar3dAppearance() {
+    const kaykitIds = recommendedIds('character').filter((id) => id.startsWith('kaykit_'));
+    const layeredBaseIds = ['half_body', 'half_body', 'half_body', 'rpm_sample'];
+    const outfitIds = BUILTIN_AGENT_AVATAR_3D_MODELS
+        .filter((m) => m.category === 'outfit')
+        .map((m) => m.id);
+    const accessoryIds = BUILTIN_AGENT_AVATAR_3D_MODELS
+        .filter((m) => m.category === 'accessory')
+        .map((m) => m.id);
+    if (kaykitIds.length > 0 && maybe(0.35)) {
+        const kaykitId = pick(kaykitIds);
+        const path = storagePathForId(kaykitId);
+        if (!path)
+            return randomizeAgentAvatar3dAppearance();
+        return {
+            modelUrl: path,
+            face: mergeAvatar3dFaceWithDefaults({ morphWeights: {} }),
+            summary: `整套造型：${labelForId(kaykitId)}`,
+        };
+    }
+    const baseId = pick(layeredBaseIds);
+    const basePath = storagePathForId(baseId);
+    if (!basePath) {
+        const fallback = storagePathForId('half_body');
+        if (!fallback) {
+            return {
+                modelUrl: '/models/agent-avatar-half-body.glb',
+                face: randomFaceForMorphCapableBase(),
+                summary: '默认半身 + 随机捏脸',
+            };
+        }
+        return {
+            modelUrl: fallback,
+            face: randomFaceForMorphCapableBase(),
+            summary: '真实半身 + 随机捏脸',
+        };
+    }
+    let outfitModelUrl;
+    let accessoryModelUrl;
+    const parts = [labelForId(baseId)];
+    const face = baseId === 'half_body' || baseId === 'rpm_sample'
+        ? randomFaceForMorphCapableBase()
+        : mergeAvatar3dFaceWithDefaults({ morphWeights: {} });
+    if (baseId === 'half_body' && outfitIds.length > 0 && maybe(0.3)) {
+        const outfitId = pick(outfitIds);
+        const outfitPath = storagePathForId(outfitId);
+        if (outfitPath) {
+            outfitModelUrl = outfitPath;
+            parts.push(`服饰层 ${labelForId(outfitId)}`);
+        }
+    }
+    if (accessoryIds.length > 0 && maybe(0.55)) {
+        const accessoryId = pick(accessoryIds);
+        const accessoryPath = storagePathForId(accessoryId);
+        if (accessoryPath) {
+            accessoryModelUrl = accessoryPath;
+            parts.push(`配饰 ${labelForId(accessoryId)}`);
+        }
+    }
+    if (baseId === 'half_body') {
+        parts.push('随机捏脸');
+    }
+    return {
+        modelUrl: basePath,
+        ...(outfitModelUrl ? { outfitModelUrl } : {}),
+        ...(accessoryModelUrl ? { accessoryModelUrl } : {}),
+        face,
+        summary: parts.join(' · '),
+    };
+}
+//# sourceMappingURL=randomizeAgentAvatar3dAppearance.js.map