zcw-shared 2.26.0 → 2.29.1

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"randomizeAgentAvatar3dAppearance.js","sourceRoot":"","sources":["../../../src/functions/ai/randomizeAgentAvatar3dAppearance.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,EAChC,sCAAsC,GACvC,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EACL,gCAAgC,GACjC,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAW9E,SAAS,IAAI,CAAI,KAAU;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AACxD,CAAC;AAED,SAAS,KAAK,CAAC,WAAmB;IAChC,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAA;AACpC,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAU;IAClC,OAAO,gCAAgC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAA;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,QAA8C;IACpE,OAAO,8BAA8B;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,sCAAsC,CAAC,CAAC,CAAC,CAAC;SACnF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AACrB,CAAC;AAED,SAAS,UAAU,CAAC,EAAU;IAC5B,OAAO,gCAAgC,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE,CAAA;AAC1D,CAAC;AAED,SAAS,6BAA6B;IACpC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,2BAA2B,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,2BAA2B,CAAC,CAAA;QAChD,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAClD,OAAO,6BAA6B,CAAC;YACnC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,6BAA6B,CAAC;QACnC,YAAY,EAAE,gCAAgC,EAAE;KACjD,CAAC,CAAA;AACJ,CAAC;AAOD,MAAM,UAAU,gCAAgC;IAC9C,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;IACtF,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;IAC5E,MAAM,SAAS,GAAG,8BAA8B;SAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACnB,MAAM,YAAY,GAAG,8BAA8B;SAChD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAGnB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;QAChC,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QACvC,IAAI,CAAC,IAAI;YAAE,OAAO,gCAAgC,EAAE,CAAA;QACpD,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,6BAA6B,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;YACzD,OAAO,EAAE,QAAQ,UAAU,CAAC,QAAQ,CAAC,EAAE;SACxC,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,CAAA;IACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAA;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,QAAQ,EAAE,oCAAoC;gBAC9C,IAAI,EAAE,6BAA6B,EAAE;gBACrC,OAAO,EAAE,aAAa;aACvB,CAAA;QACH,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,6BAA6B,EAAE;YACrC,OAAO,EAAE,aAAa;SACvB,CAAA;IACH,CAAC;IAED,IAAI,cAAkC,CAAA;IACtC,IAAI,iBAAqC,CAAA;IACzC,MAAM,KAAK,GAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;IAE5C,MAAM,IAAI,GACR,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,YAAY;QAC/C,CAAC,CAAC,6BAA6B,EAAE;QACjC,CAAC,CAAC,6BAA6B,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAA;IAEzD,IAAI,MAAM,KAAK,WAAW,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;QAChC,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC7C,IAAI,UAAU,EAAE,CAAC;YACf,cAAc,GAAG,UAAU,CAAA;YAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,CAAA;QACtC,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAA;QACnD,IAAI,aAAa,EAAE,CAAC;YAClB,iBAAiB,GAAG,aAAa,CAAA;YACjC,KAAK,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACpB,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,IAAI;QACJ,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;KAC3B,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { AiAgentAvatar3dModular, AiAgentAvatar3dFace } from '../../../types/ai-agent';
+export interface RandomizedModularAvatar3dAppearance {
+    modular: AiAgentAvatar3dModular;
+    face: AiAgentAvatar3dFace;
+    summary: string;
+}
+export declare function randomizeModularAvatar3dAppearance(): RandomizedModularAvatar3dAppearance;

package/dist/functions/ai/randomizeModularAvatar3dAppearance.js

@@ -0,0 +1,60 @@
+import { AVATAR3D_MODULAR_SLOT_ORDER, DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID, getAvatar3dModularBasePartById, listAvatar3dModularSlotPartsForProfile, AVATAR3D_STANDARD_SKELETON_PROFILE, } from '../../constants/agentAvatar3dModular.js';
+import { AGENT_PRESENCE_3D_LABELS } from '../../constants/agentPresence3dLabels.js';
+import { AGENT_AVATAR3D_FACE_PRESETS } from './agentAvatar3dFacePresets.js';
+import { createRandomAvatar3dMorphWeights } from './agentAvatar3dMorphCatalog.js';
+import { applyAvatar3dFacePreset } from './agentAvatar3dFacePresets.js';
+import { mergeAvatar3dFaceWithDefaults } from './normalizeAiAgentAvatar3dFace.js';
+import { normalizeAiAgentAvatar3dModular } from './normalizeAiAgentAvatar3dModular.js';
+function pick(items) {
+    return items[Math.floor(Math.random() * items.length)];
+}
+function maybe(probability) {
+    return Math.random() < probability;
+}
+function randomFace() {
+    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(),
+    });
+}
+function slotKeyForId(slotId) {
+    return slotId;
+}
+export function randomizeModularAvatar3dAppearance() {
+    const basePartId = DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID;
+    const baseMeta = getAvatar3dModularBasePartById(basePartId);
+    const slots = {};
+    const parts = [baseMeta.label];
+    for (const slotId of AVATAR3D_MODULAR_SLOT_ORDER) {
+        const pool = listAvatar3dModularSlotPartsForProfile(AVATAR3D_STANDARD_SKELETON_PROFILE, slotId);
+        if (pool.length === 0)
+            continue;
+        if (!maybe(0.4))
+            continue;
+        const part = pick(pool);
+        slots[slotKeyForId(slotId)] = part.id;
+        parts.push(part.label);
+    }
+    parts.push(AGENT_PRESENCE_3D_LABELS.randomFaceSummary);
+    const modular = normalizeAiAgentAvatar3dModular({
+        version: 'v1',
+        basePartId,
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        slots,
+    });
+    return {
+        modular,
+        face: randomFace(),
+        summary: parts.join(' · '),
+    };
+}
+//# sourceMappingURL=randomizeModularAvatar3dAppearance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"randomizeModularAvatar3dAppearance.js","sourceRoot":"","sources":["../../../src/functions/ai/randomizeModularAvatar3dAppearance.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,qCAAqC,EACrC,8BAA8B,EAC9B,sCAAsC,EACtC,kCAAkC,GAEnC,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAMhF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAA;AAQnF,SAAS,IAAI,CAAI,KAAU;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AACxD,CAAC;AAED,SAAS,KAAK,CAAC,WAAmB;IAChC,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAA;AACpC,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,2BAA2B,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,2BAA2B,CAAC,CAAA;QAChD,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAClD,OAAO,6BAA6B,CAAC;YACnC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,6BAA6B,CAAC;QACnC,YAAY,EAAE,gCAAgC,EAAE;KACjD,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAA6B;IACjD,OAAO,MAAM,CAAA;AACf,CAAC;AAGD,MAAM,UAAU,kCAAkC;IAChD,MAAM,UAAU,GAAG,qCAAqC,CAAA;IACxD,MAAM,QAAQ,GAAG,8BAA8B,CAAC,UAAU,CAAE,CAAA;IAC5D,MAAM,KAAK,GAAgC,EAAE,CAAA;IAC7C,MAAM,KAAK,GAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAExC,KAAK,MAAM,MAAM,IAAI,2BAA2B,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,sCAAsC,CACjD,kCAAkC,EAClC,MAAM,CACP,CAAA;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAQ;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;YAAE,SAAQ;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAA;QACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,iBAAiB,CAAC,CAAA;IAEtD,MAAM,OAAO,GAAG,+BAA+B,CAAC;QAC9C,OAAO,EAAE,IAAI;QACb,UAAU;QACV,eAAe,EAAE,kCAAkC;QACnD,KAAK;KACN,CAAE,CAAA;IAEH,OAAO;QACL,OAAO;QACP,IAAI,EAAE,UAAU,EAAE;QAClB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;KAC3B,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { AiAgentAvatar3d, AiAgentAvatar3dModular } from '../../../types/ai-agent';
+import { type ResolvedAvatar3dModularLayer } from './normalizeAiAgentAvatar3dModular';
+export declare function ensureAvatar3dModular(cfg: AiAgentAvatar3d): AiAgentAvatar3dModular | undefined;
+export declare function resolveAvatar3dModularLayersFromConfig(cfg: AiAgentAvatar3d): ResolvedAvatar3dModularLayer[];

package/dist/functions/ai/resolveAvatar3dModular.js

@@ -0,0 +1,22 @@
+import { DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID, AVATAR3D_STANDARD_SKELETON_PROFILE, } from '../../constants/agentAvatar3dModular.js';
+import { normalizeAiAgentAvatar3dModular, resolveModularAvatar3dLayers, } from './normalizeAiAgentAvatar3dModular.js';
+export function ensureAvatar3dModular(cfg) {
+    if (cfg.modular)
+        return normalizeAiAgentAvatar3dModular(cfg.modular);
+    const modelUrl = String(cfg.modelUrl ?? '').trim();
+    if (!modelUrl && !cfg.builtin)
+        return undefined;
+    return normalizeAiAgentAvatar3dModular({
+        version: 'v1',
+        basePartId: DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID,
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        slots: {},
+    });
+}
+export function resolveAvatar3dModularLayersFromConfig(cfg) {
+    const modular = ensureAvatar3dModular(cfg);
+    if (!modular)
+        return [];
+    return resolveModularAvatar3dLayers(modular);
+}
+//# sourceMappingURL=resolveAvatar3dModular.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAvatar3dModular.js","sourceRoot":"","sources":["../../../src/functions/ai/resolveAvatar3dModular.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qCAAqC,EACrC,kCAAkC,GACnC,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EACL,+BAA+B,EAE/B,4BAA4B,GAC7B,MAAM,mCAAmC,CAAA;AAE1C,MAAM,UAAU,qBAAqB,CACnC,GAAoB;IAEpB,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,+BAA+B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAEpE,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAClD,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAE/C,OAAO,+BAA+B,CAAC;QACrC,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,qCAAqC;QACjD,eAAe,EAAE,kCAAkC;QACnD,KAAK,EAAE,EAAE;KACV,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,GAAoB;IAEpB,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IACvB,OAAO,4BAA4B,CAAC,OAAO,CAAC,CAAA;AAC9C,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { ImAiAgentCatalogRow } from '../../../types/im-ai-agent';
+export type AiAgentRowForCatalog = {
+    id: string;
+    user_id: string;
+    display_name?: string | null;
+    bio?: string | null;
+    avatar_url?: string | null;
+    account_kind?: string | null;
+    enabled?: boolean | null;
+    attachment_payload_format?: string | null;
+};
+export declare function toAiAgentCatalogRow(row: AiAgentRowForCatalog): ImAiAgentCatalogRow;

package/dist/functions/ai/toAiAgentCatalogRow.js

@@ -0,0 +1,13 @@
+export function toAiAgentCatalogRow(row) {
+    return {
+        id: row.id,
+        user_id: row.user_id,
+        display_name: row.display_name ?? '',
+        bio: row.bio ?? '',
+        avatar_url: row.avatar_url ?? '',
+        account_kind: row.account_kind ?? 'ai_agent',
+        enabled: row.enabled ?? false,
+        attachment_payload_format: row.attachment_payload_format ?? undefined,
+    };
+}
+//# sourceMappingURL=toAiAgentCatalogRow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toAiAgentCatalogRow.js","sourceRoot":"","sources":["../../../src/functions/ai/toAiAgentCatalogRow.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,mBAAmB,CACjC,GAAyB;IAEzB,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE;QACpC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE;QAClB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;QAChC,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,UAAU;QAC5C,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,KAAK;QAC7B,yBAAyB,EAAE,GAAG,CAAC,yBAAyB,IAAI,SAAS;KACtE,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+export type AiAgentTaskRunRowLike = {
+    id: string;
+    agent_id: string;
+    fsm_state: string;
+    terminal_status: string | null;
+    started_at: string;
+    ended_at: string | null;
+    reply_preview: string | null;
+};
+export declare function toAiAgentTaskRunForConsumer(row: AiAgentTaskRunRowLike): AiAgentTaskRunRowLike;

package/dist/functions/ai/toAiAgentTaskRunForConsumer.js

@@ -0,0 +1,12 @@
+export function toAiAgentTaskRunForConsumer(row) {
+    return {
+        id: row.id,
+        agent_id: row.agent_id,
+        fsm_state: row.fsm_state,
+        terminal_status: row.terminal_status,
+        started_at: row.started_at,
+        ended_at: row.ended_at,
+        reply_preview: row.reply_preview,
+    };
+}
+//# sourceMappingURL=toAiAgentTaskRunForConsumer.js.map