zcw-shared 2.25.0 → 2.27.0

package/README.md

@@ -167,15 +167,6 @@ export interface MyFunctionDeps {
 import type { Ref } from '../../references/vue.d'  // Vue 没有 references 文件
 ```
 
-#### 规则 7：存储能力统一通过 `useStorage`
-
-- 不允许直接依赖 `localStorage` / `sessionStorage` 等同步 API
-- 必须组合 `useStorage` 与具体适配器（如 `useLocalStorage`、`useSessionStorage`、`useStorageWithIndexedDB`）创建 `storage` 对象
-- Env 类型统一定义为 `ReturnType<typeof useStorage<string>>`（或自定义 value 类型）
-- 在实现中仅使用 `storage.get/set/remove/clear` 等 Promise API，避免混用同步方法
-- 文档站中的 VitePress 交互示例同样需要使用 `useStorage` 与适配器，确保行为与生产代码一致
-- **多表结构化 IndexedDB**（多 object store、复合索引、`transaction`）可使用 **`useDexieShortcuts`**：将 `Dexie` 构造器与 `indexedDB` 注入 `deps`，应用侧安装 peer 依赖 **`dexie`**（版本范围见 `package.json` 的 `peerDependencies`）。详见 `docs/api/storage/useDexieShortcuts.md`。
-
 #### 规则 5：每个函数维护自己完整的依赖，不要分散
 
 ```typescript
@@ -270,6 +261,71 @@ export interface DeployTCBDeps {
 }
 ```
 
+#### 规则 7：存储能力统一通过 `useStorage`
+
+- 不允许直接依赖 `localStorage` / `sessionStorage` 等同步 API
+- 必须组合 `useStorage` 与具体适配器（如 `useLocalStorage`、`useSessionStorage`、`useStorageWithIndexedDB`）创建 `storage` 对象
+- Env 类型统一定义为 `ReturnType<typeof useStorage<string>>`（或自定义 value 类型）
+- 在实现中仅使用 `storage.get/set/remove/clear` 等 Promise API，避免混用同步方法
+- 文档站中的 VitePress 交互示例同样需要使用 `useStorage` 与适配器，确保行为与生产代码一致
+- **多表结构化 IndexedDB**（多 object store、复合索引、`transaction`）可使用 **`useDexieShortcuts`**：将 `Dexie` 构造器与 `indexedDB` 注入 `deps`，应用侧安装 peer 依赖 **`dexie`**（版本范围见 `package.json` 的 `peerDependencies`）。详见 `docs/api/storage/useDexieShortcuts.md`。
+
+#### 规则 8：浏览器宿主绑定层统一通过 `readBrowserHost`
+
+- 库内函数**不得**直接访问 `globalThis` / `window` / `document` / `localStorage`
+- 应用边界通过 `readBrowserHostFromGlobalThis()` 读取宿主，组装为 `ReadBrowserHostDeps` 后向下传递
+- `readBrowser*` / `createBrowser*` / `useBrowser*` 系列是**唯一**允许在内部调用 `readBrowserHostFromGlobalThis()` 的便捷封装，供 Web 宿主直引
+- `useBrowser*` Hook 可在绑定层直接 `import { ref, watch } from 'vue'`（与 Vue SFC 同级，属于应用边界）
+- 浏览器存储统一经 `createBrowserStringStorageKit` / `createBrowserSessionStorageKit` 组合 `useStorage` + 适配器；写入只用 `storage.set/remove`，同步 bootstrap 读可经 `backingStorage`
+- 新增浏览器绑定逻辑时，优先在 `src/functions/browser/readBrowserHost.ts` 扩展 `BrowserHostSnapshot`，不要在业务模块重复读取全局对象
+
+```typescript
+import {
+  readBrowserHostDepsFromGlobalThis,
+  requireBrowserHostLocalStorage,
+  type ReadBrowserHostDeps,
+} from '../browser/readBrowserHost'
+
+export function createBrowserExampleAccess(
+  hostDeps: ReadBrowserHostDeps = readBrowserHostDepsFromGlobalThis(),
+) {
+  return {
+    read(): string {
+      return requireBrowserHostLocalStorage(hostDeps).getItem('key') ?? ''
+    },
+  }
+}
+```
+
+#### 规则 9：编排类函数拆分 `{Name}Input` 与 `{Name}Deps`
+
+面向业务流程的编排函数（如 IM 复制、转发、媒体出站）允许将参数拆为两层：
+
+- **`{Name}Input`**：业务数据 + 由调用方实现的 I/O 回调（如 `copyImagePixels`）
+- **`{Name}Deps`**：环境能力（`document`、`setTimeout`、`URL` 等），第二参数传入；Web 宿主可使用 `readBrowserHost*` 默认注入
+
+```typescript
+export type ExecuteExampleInput = {
+  messageId: string
+  persist: (id: string) => Promise<void>
+}
+
+export interface ExecuteExampleDeps {
+  document?: Document
+}
+
+export async function executeExample(
+  input: ExecuteExampleInput,
+  deps: ExecuteExampleDeps = {
+    document: readBrowserHostDocument(readBrowserHostDepsFromGlobalThis()),
+  },
+) {
+  // input 承载业务数据与回调，deps 承载环境 API
+}
+```
+
+纯数据变换函数可只使用 `{Name}Deps` 或单一 `options`；命名与约定见 `src/functions/im/imOrchestrationTypes.ts`。
+
 #### 完整示例
 
 ```typescript
@@ -703,15 +759,15 @@ npm run publish:major  # 主要版本
 
 1. **不导入第三方库运行时函数**：不直接 `import { ref } from 'vue'`，而是通过 `env` 对象传入
 2. **Vue 类型特殊规则**：Vue 类型只能使用 `import type {} from 'vue'` 导入，不能从 `references/` 导入
-3. **不依赖全局对象**：不直接使用 `window`、`document`、`global`
-4. **接口命名规范**：`{FunctionName}Deps`，例如 `BuildProjectDeps`、`ModifyManifestDeps`
+3. **不依赖全局对象**：不直接使用 `window`、`document`、`global`；浏览器宿主统一经 `readBrowserHost`（规则 8）
+4. **接口命名规范**：`{FunctionName}Deps` 或编排函数的 `{FunctionName}Input` + `{FunctionName}Deps`
 5. **使用 deps. 前缀**：所有依赖访问都使用 `deps.methodName()`，不解构
 
 ### 快速检查清单
 
 在编写新函数或修改现有函数时，快速检查以下要点：
 
-**✅ 6大核心规则：**
+**✅ 9 大核心规则：**
 1. ❌ 不直接导入第三方库运行时函数 → ✅ 从 `references/` 导入类型（Vue 类型除外）
 2. ❌ Vue 类型不能从 `references/` 导入 → ✅ 只能使用 `import type {} from 'vue'`
 3. ❌ 不传入整个模块对象 → ✅ 只传入实际使用的函数
@@ -719,10 +775,14 @@ npm run publish:major  # 主要版本
 5. ❌ 不重复定义类型 → ✅ 使用 `Interface['method']` 提取
 6. ❌ 不分散依赖到多个参数 → ✅ 统一的 `Deps` 接口
 7. ❌ 第三方 SDK 也不能整个传入 → ✅ Vue、Wx 等也要拆分
+8. ❌ 业务代码不直接读 `globalThis` → ✅ 经 `readBrowserHost` / `readBrowser*` 绑定层注入
+9. ❌ 编排函数混用环境与业务参数 → ✅ `{Name}Input` + `{Name}Deps` 分层（见规则 9）
 
 **✅ 命名规范：**
 - 函数依赖接口：`{FunctionName}Deps`
+- 编排函数业务入参：`{FunctionName}Input`
 - Hook 环境接口：`{HookName}Environment`
+- 浏览器绑定便捷函数：`readBrowser*` / `createBrowser*` / `useBrowser*`
 - Playground 组件：`{FunctionName}Playground.vue`
 
 **✅ 文档完整性：**
@@ -1519,7 +1579,7 @@ p {
 添加新函数后，必须确认：
 
 - [ ] 函数文档已创建（`docs/api/category/functionName.md`）
-- [ ] 文档包含所有必需部分（Playground、导入、类型、说明、示例、注意事项）
+- [ ] 文档包含所有必需部分（函数描述、函数签名、参数表、返回值、工作原理；有 deps 时含前置依赖）
 - [ ] Playground 组件已创建（浏览器端函数）
 - [ ] 组件正确导入实际函数（不是 mock）
 - [ ] 侧边栏配置已更新

package/dist/constants/agentAvatar3d.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_AGENT_AVATAR_3D_MODEL_PATH = "/models/agent-avatar-full-body.glb";
+export declare const DEFAULT_AGENT_AVATAR_3D_MODEL_URL = "/models/agent-avatar-full-body.glb";
+export type BuiltinAgentAvatar3dCategory = 'character' | 'outfit' | 'accessory';
+export interface BuiltinAgentAvatar3dModelMeta {
+    id: string;
+    filename: string;
+    storagePath: string;
+    label: string;
+    category: BuiltinAgentAvatar3dCategory;
+}
+export declare const BUILTIN_AGENT_AVATAR_3D_MODELS: BuiltinAgentAvatar3dModelMeta[];
+export declare function hasAgentAvatar3dDefaultModel(): boolean;
+export declare function getBuiltinAgentAvatar3dModelById(id: string): BuiltinAgentAvatar3dModelMeta | undefined;
+export declare function resolveBuiltinAgentAvatar3dStoragePath(url: string): string | undefined;
+export declare function isBuiltinAgentAvatar3dModelUrl(url: string): boolean;

package/dist/constants/agentAvatar3d.js

@@ -0,0 +1,64 @@
+export const DEFAULT_AGENT_AVATAR_3D_MODEL_PATH = '/models/agent-avatar-full-body.glb';
+export const DEFAULT_AGENT_AVATAR_3D_MODEL_URL = DEFAULT_AGENT_AVATAR_3D_MODEL_PATH;
+export const BUILTIN_AGENT_AVATAR_3D_MODELS = [
+    {
+        id: 'full_body',
+        filename: 'agent-avatar-full-body.glb',
+        storagePath: '/models/agent-avatar-full-body.glb',
+        label: '全身底模',
+        category: 'character',
+    },
+    {
+        id: 'outfit_top_default',
+        filename: 'agent-avatar-outfit-top-default.glb',
+        storagePath: '/models/agent-avatar-outfit-top-default.glb',
+        label: '默认上装',
+        category: 'outfit',
+    },
+    {
+        id: 'outfit_bottom_default',
+        filename: 'agent-avatar-outfit-bottom-default.glb',
+        storagePath: '/models/agent-avatar-outfit-bottom-default.glb',
+        label: '默认下装',
+        category: 'outfit',
+    },
+    {
+        id: 'outfit_shoes_default',
+        filename: 'agent-avatar-outfit-shoes-default.glb',
+        storagePath: '/models/agent-avatar-outfit-shoes-default.glb',
+        label: '默认鞋靴',
+        category: 'outfit',
+    },
+    {
+        id: 'headwear',
+        filename: 'agent-avatar-headwear.glb',
+        storagePath: '/models/agent-avatar-headwear.glb',
+        label: '头饰',
+        category: 'accessory',
+    },
+];
+export function hasAgentAvatar3dDefaultModel() {
+    return true;
+}
+export function getBuiltinAgentAvatar3dModelById(id) {
+    return BUILTIN_AGENT_AVATAR_3D_MODELS.find((m) => m.id === id);
+}
+export function resolveBuiltinAgentAvatar3dStoragePath(url) {
+    const u = url.trim().toLowerCase();
+    if (!u)
+        return undefined;
+    for (const m of BUILTIN_AGENT_AVATAR_3D_MODELS) {
+        const fn = m.filename.toLowerCase();
+        const path = m.storagePath.toLowerCase();
+        if (u.includes(fn) || u.endsWith(path) || u === path)
+            return m.storagePath;
+    }
+    return undefined;
+}
+export function isBuiltinAgentAvatar3dModelUrl(url) {
+    const u = url.trim();
+    if (!u)
+        return true;
+    return resolveBuiltinAgentAvatar3dStoragePath(u) !== undefined;
+}
+//# sourceMappingURL=agentAvatar3d.js.map

package/dist/constants/agentAvatar3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentAvatar3d.js","sourceRoot":"","sources":["../../src/constants/agentAvatar3d.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kCAAkC,GAAG,oCAAoC,CAAA;AACtF,MAAM,CAAC,MAAM,iCAAiC,GAAG,kCAAkC,CAAA;AAYnF,MAAM,CAAC,MAAM,8BAA8B,GAAoC;IAC7E;QACE,EAAE,EAAE,WAAW;QACf,QAAQ,EAAE,4BAA4B;QACtC,WAAW,EAAE,oCAAoC;QACjD,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,WAAW;KACtB;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,QAAQ,EAAE,qCAAqC;QAC/C,WAAW,EAAE,6CAA6C;QAC1D,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,QAAQ;KACnB;IACD;QACE,EAAE,EAAE,uBAAuB;QAC3B,QAAQ,EAAE,wCAAwC;QAClD,WAAW,EAAE,gDAAgD;QAC7D,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,QAAQ;KACnB;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,uCAAuC;QACjD,WAAW,EAAE,+CAA+C;QAC5D,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,QAAQ;KACnB;IACD;QACE,EAAE,EAAE,UAAU;QACd,QAAQ,EAAE,2BAA2B;QACrC,WAAW,EAAE,mCAAmC;QAChD,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,WAAW;KACtB;CACF,CAAA;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,EAAU;IAEV,OAAO,8BAA8B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,sCAAsC,CAAC,GAAW;IAChE,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAClC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IACxB,KAAK,MAAM,CAAC,IAAI,8BAA8B,EAAE,CAAC;QAC/C,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;QACnC,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAA;QACxC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC,WAAW,CAAA;IAC5E,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,GAAW;IACxD,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IACpB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,OAAO,sCAAsC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAA;AAChE,CAAC"}

package/dist/constants/agentAvatar3dModular.d.ts

@@ -0,0 +1,34 @@
+export declare const AVATAR3D_MODULAR_SYSTEM_VERSION: "v1";
+export type Avatar3dModularSystemVersion = typeof AVATAR3D_MODULAR_SYSTEM_VERSION;
+export declare const AVATAR3D_STANDARD_SKELETON_PROFILE: "rpm_mixamo";
+export type Avatar3dSkeletonProfile = typeof AVATAR3D_STANDARD_SKELETON_PROFILE;
+export type Avatar3dModularSlotId = 'hair' | 'top' | 'bottom' | 'shoes' | 'gloves' | 'headwear' | 'faceAccessory';
+export type Avatar3dModularAttachMode = 'skinned_merge' | 'head_attach' | 'root_attach';
+export declare const AVATAR3D_MODULAR_SLOT_ORDER: Avatar3dModularSlotId[];
+export declare const AVATAR3D_MODULAR_SLOT_LABELS: Record<Avatar3dModularSlotId, string>;
+export interface Avatar3dModularBasePartMeta {
+    id: string;
+    filename: string;
+    storagePath: string;
+    label: string;
+    skeletonProfile: Avatar3dSkeletonProfile;
+    supportsFaceMorph: boolean;
+}
+export interface Avatar3dModularSlotPartMeta {
+    id: string;
+    slot: Avatar3dModularSlotId;
+    filename: string;
+    storagePath: string;
+    label: string;
+    skeletonProfile: Avatar3dSkeletonProfile;
+    attachMode: Avatar3dModularAttachMode;
+    hideBaseMeshHints?: string[];
+}
+export declare const DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID = "base_full_body";
+export declare const AVATAR3D_MODULAR_BASE_PARTS: Avatar3dModularBasePartMeta[];
+export declare const AVATAR3D_MODULAR_SLOT_PARTS: Avatar3dModularSlotPartMeta[];
+export declare function getAvatar3dModularBasePartById(id: string): Avatar3dModularBasePartMeta | undefined;
+export declare function getAvatar3dModularSlotPartById(id: string): Avatar3dModularSlotPartMeta | undefined;
+export declare function listAvatar3dModularSlotPartsForProfile(_profile: Avatar3dSkeletonProfile, slot?: Avatar3dModularSlotId): Avatar3dModularSlotPartMeta[];
+export declare function listActiveModularSlotIds(): Avatar3dModularSlotId[];
+export declare function normalizeModularBasePartId(basePartId: string): string;

package/dist/constants/agentAvatar3dModular.js

@@ -0,0 +1,93 @@
+export const AVATAR3D_MODULAR_SYSTEM_VERSION = 'v1';
+export const AVATAR3D_STANDARD_SKELETON_PROFILE = 'rpm_mixamo';
+export const AVATAR3D_MODULAR_SLOT_ORDER = [
+    'hair',
+    'top',
+    'bottom',
+    'shoes',
+    'gloves',
+    'headwear',
+    'faceAccessory',
+];
+export const AVATAR3D_MODULAR_SLOT_LABELS = {
+    hair: '发型',
+    top: '上装',
+    bottom: '下装',
+    shoes: '鞋靴',
+    gloves: '手套',
+    headwear: '头饰',
+    faceAccessory: '面部配饰',
+};
+export const DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID = 'base_full_body';
+export const AVATAR3D_MODULAR_BASE_PARTS = [
+    {
+        id: 'base_full_body',
+        filename: 'agent-avatar-full-body.glb',
+        storagePath: '/models/agent-avatar-full-body.glb',
+        label: '全身底模',
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        supportsFaceMorph: true,
+    },
+];
+export const AVATAR3D_MODULAR_SLOT_PARTS = [
+    {
+        id: 'slot_top_default',
+        slot: 'top',
+        filename: 'agent-avatar-outfit-top-default.glb',
+        storagePath: '/models/agent-avatar-outfit-top-default.glb',
+        label: '默认上装',
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        attachMode: 'skinned_merge',
+        hideBaseMeshHints: ['Outfit_Top'],
+    },
+    {
+        id: 'slot_bottom_default',
+        slot: 'bottom',
+        filename: 'agent-avatar-outfit-bottom-default.glb',
+        storagePath: '/models/agent-avatar-outfit-bottom-default.glb',
+        label: '默认下装',
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        attachMode: 'skinned_merge',
+        hideBaseMeshHints: ['Outfit_Bottom'],
+    },
+    {
+        id: 'slot_shoes_default',
+        slot: 'shoes',
+        filename: 'agent-avatar-outfit-shoes-default.glb',
+        storagePath: '/models/agent-avatar-outfit-shoes-default.glb',
+        label: '默认鞋靴',
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        attachMode: 'skinned_merge',
+        hideBaseMeshHints: ['Outfit_Footwear'],
+    },
+    {
+        id: 'slot_headwear_rpm',
+        slot: 'headwear',
+        filename: 'agent-avatar-headwear.glb',
+        storagePath: '/models/agent-avatar-headwear.glb',
+        label: '头饰',
+        skeletonProfile: AVATAR3D_STANDARD_SKELETON_PROFILE,
+        attachMode: 'head_attach',
+    },
+];
+export function getAvatar3dModularBasePartById(id) {
+    return AVATAR3D_MODULAR_BASE_PARTS.find((p) => p.id === id);
+}
+export function getAvatar3dModularSlotPartById(id) {
+    return AVATAR3D_MODULAR_SLOT_PARTS.find((p) => p.id === id);
+}
+export function listAvatar3dModularSlotPartsForProfile(_profile, slot) {
+    return AVATAR3D_MODULAR_SLOT_PARTS.filter((p) => !slot || p.slot === slot);
+}
+export function listActiveModularSlotIds() {
+    return AVATAR3D_MODULAR_SLOT_ORDER.filter((slotId) => AVATAR3D_MODULAR_SLOT_PARTS.some((p) => p.slot === slotId));
+}
+export function normalizeModularBasePartId(basePartId) {
+    const id = basePartId.trim();
+    const meta = getAvatar3dModularBasePartById(id);
+    if (meta && meta.skeletonProfile === AVATAR3D_STANDARD_SKELETON_PROFILE) {
+        return id;
+    }
+    return DEFAULT_AVATAR3D_MODULAR_BASE_PART_ID;
+}
+//# sourceMappingURL=agentAvatar3dModular.js.map

package/dist/constants/agentAvatar3dModular.js.map

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

package/dist/constants/agentPresence3dLabels.d.ts

@@ -0,0 +1,11 @@
+export declare const AGENT_PRESENCE_3D_LABELS: {
+    readonly sectionTitle: "3D 形象";
+    readonly shortName: "3D 形象";
+    readonly customizeAction: "定制形象";
+    readonly customizeDialogTitle: "定制 3D 形象";
+    readonly faceTuneTitle: "捏脸微调";
+    readonly applyAction: "应用";
+    readonly notConfigured: "未配置 3D 形象";
+    readonly loadingDefault: "加载中…";
+    readonly randomFaceSummary: "随机捏脸";
+};

package/dist/constants/agentPresence3dLabels.js

@@ -0,0 +1,12 @@
+export const AGENT_PRESENCE_3D_LABELS = {
+    sectionTitle: '3D 形象',
+    shortName: '3D 形象',
+    customizeAction: '定制形象',
+    customizeDialogTitle: '定制 3D 形象',
+    faceTuneTitle: '捏脸微调',
+    applyAction: '应用',
+    notConfigured: '未配置 3D 形象',
+    loadingDefault: '加载中…',
+    randomFaceSummary: '随机捏脸',
+};
+//# sourceMappingURL=agentPresence3dLabels.js.map

package/dist/constants/agentPresence3dLabels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentPresence3dLabels.js","sourceRoot":"","sources":["../../src/constants/agentPresence3dLabels.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,YAAY,EAAE,OAAO;IACrB,SAAS,EAAE,OAAO;IAClB,eAAe,EAAE,MAAM;IACvB,oBAAoB,EAAE,UAAU;IAChC,aAAa,EAAE,MAAM;IACrB,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE,WAAW;IAC1B,cAAc,EAAE,MAAM;IACtB,iBAAiB,EAAE,MAAM;CACjB,CAAA"}

package/dist/constants/aiApiRoutes.d.ts

@@ -0,0 +1,8 @@
+export declare const AI_ADMIN_API_PREFIX = "admin/ai";
+export declare const AI_CHAT_API_PREFIX = "chat/ai";
+export declare const LLM_GATEWAY_OPENAI_PREFIX = "v1";
+export declare function adminAiApiPath(suffix?: string): string;
+export declare function chatAiApiPath(suffix?: string): string;
+export declare const CHAT_AI_SPA_PREFIX = "ai";
+export declare function chatAiSpaPath(suffix?: string): string;
+export declare function adminAiAgentSubResourcePathRegex(suffix: string): RegExp;

package/dist/constants/aiApiRoutes.js

@@ -0,0 +1,23 @@
+export const AI_ADMIN_API_PREFIX = 'admin/ai';
+export const AI_CHAT_API_PREFIX = 'chat/ai';
+export const LLM_GATEWAY_OPENAI_PREFIX = 'v1';
+export function adminAiApiPath(suffix = '') {
+    const s = String(suffix ?? '').replace(/^\//, '');
+    return s ? `/${AI_ADMIN_API_PREFIX}/${s}` : `/${AI_ADMIN_API_PREFIX}`;
+}
+export function chatAiApiPath(suffix = '') {
+    const s = String(suffix ?? '').replace(/^\//, '');
+    return s ? `/${AI_CHAT_API_PREFIX}/${s}` : `/${AI_CHAT_API_PREFIX}`;
+}
+export const CHAT_AI_SPA_PREFIX = 'ai';
+export function chatAiSpaPath(suffix = '') {
+    const s = String(suffix ?? '').replace(/^\//, '');
+    return s ? `/${CHAT_AI_SPA_PREFIX}/${s}` : `/${CHAT_AI_SPA_PREFIX}`;
+}
+export function adminAiAgentSubResourcePathRegex(suffix) {
+    const seg = String(suffix ?? '')
+        .replace(/^\//, '')
+        .replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`^/${AI_ADMIN_API_PREFIX}/agents/[^/]+/${seg}$`);
+}
+//# sourceMappingURL=aiApiRoutes.js.map

package/dist/constants/aiApiRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiApiRoutes.js","sourceRoot":"","sources":["../../src/constants/aiApiRoutes.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAA;AAG7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAA;AAG3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAA;AAE7C,MAAM,UAAU,cAAc,CAAC,MAAM,GAAG,EAAE;IACxC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACjD,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,mBAAmB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,mBAAmB,EAAE,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAM,GAAG,EAAE;IACvC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACjD,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,kBAAkB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,kBAAkB,EAAE,CAAA;AACrE,CAAC;AAKD,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAA;AAEtC,MAAM,UAAU,aAAa,CAAC,MAAM,GAAG,EAAE;IACvC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACjD,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,kBAAkB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,kBAAkB,EAAE,CAAA;AACrE,CAAC;AAGD,MAAM,UAAU,gCAAgC,CAAC,MAAc;IAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;SAC7B,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;IACzC,OAAO,IAAI,MAAM,CAAC,KAAK,mBAAmB,iBAAiB,GAAG,GAAG,CAAC,CAAA;AACpE,CAAC"}

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

@@ -0,0 +1,14 @@
+export type ArkitMorphDirectionSpec = {
+    positive?: string[];
+    negative?: string[];
+};
+export declare const ARKIT_CATALOG_MORPH_SPECS: Record<string, ArkitMorphDirectionSpec>;
+export declare function isArkitBlendshapeModel(modelMorphNames: string[]): boolean;
+export declare function resolveMorphNamesInModel(templates: string[], modelMorphNames: string[]): string[];
+export declare function resolveArkitCatalogMorphNames(catalogId: string, modelMorphNames: string[]): {
+    positive: string[];
+    negative: string[];
+};
+export declare function isArkitMorphCatalogIdBound(catalogId: string, modelMorphNames: string[]): boolean;
+export declare function morphSliderToArkitInfluence(v: number): number;
+export declare function morphSliderToSymmetricInfluence(v: number): number;

package/dist/functions/ai/agentAvatar3dArkitMorph.js

@@ -0,0 +1,149 @@
+export const ARKIT_CATALOG_MORPH_SPECS = {
+    face_width: {
+        positive: ['cheekPuff'],
+        negative: ['jawLeft', 'jawRight'],
+    },
+    face_round: {
+        positive: ['cheekPuff'],
+        negative: ['cheekSquintLeft', 'cheekSquintRight'],
+    },
+    jaw_width: {
+        positive: ['jawLeft', 'jawRight'],
+        negative: ['jawForward'],
+    },
+    chin_length: {
+        positive: ['jawForward'],
+        negative: ['jawOpen'],
+    },
+    cheek_height: {
+        positive: ['cheekSquintLeft', 'cheekSquintRight'],
+        negative: ['cheekPuff'],
+    },
+    face_height: {
+        positive: ['jawOpen'],
+        negative: ['jawForward'],
+    },
+    brow_thickness: {
+        positive: ['browDownLeft', 'browDownRight'],
+        negative: ['browOuterUpLeft', 'browOuterUpRight'],
+    },
+    brow_height: {
+        positive: ['browInnerUp'],
+        negative: ['browDownLeft', 'browDownRight'],
+    },
+    brow_spacing: {
+        positive: ['browOuterUpLeft', 'browOuterUpRight'],
+        negative: ['browDownLeft', 'browDownRight'],
+    },
+    eye_size: {
+        positive: ['eyeWideLeft', 'eyeWideRight'],
+        negative: ['eyeSquintLeft', 'eyeSquintRight'],
+    },
+    eye_spacing: {
+        positive: ['eyeLookOutLeft', 'eyeLookOutRight'],
+        negative: ['eyeLookInLeft', 'eyeLookInRight'],
+    },
+    eye_height: {
+        positive: ['eyeLookUpLeft', 'eyeLookUpRight'],
+        negative: ['eyeLookDownLeft', 'eyeLookDownRight'],
+    },
+    eye_corner: {
+        positive: ['eyeSquintLeft', 'eyeSquintRight'],
+        negative: ['eyeWideLeft', 'eyeWideRight'],
+    },
+    eye_depth: {
+        positive: ['eyeSquintLeft', 'eyeSquintRight'],
+        negative: ['eyeWideLeft', 'eyeWideRight'],
+    },
+    nose_size: {
+        positive: ['noseSneerLeft', 'noseSneerRight'],
+        negative: [],
+    },
+    nose_width: {
+        positive: ['mouthFunnel'],
+        negative: ['mouthPucker'],
+    },
+    nose_height: {
+        positive: ['noseSneerLeft', 'noseSneerRight'],
+        negative: [],
+    },
+    nose_bridge: {
+        positive: ['jawForward'],
+        negative: [],
+    },
+    mouth_width: {
+        positive: ['mouthStretchLeft', 'mouthStretchRight'],
+        negative: ['mouthPucker'],
+    },
+    mouth_size: {
+        positive: ['mouthFunnel', 'mouthPucker'],
+        negative: [],
+    },
+    lip_thickness: {
+        positive: ['mouthPucker'],
+        negative: ['mouthStretchLeft', 'mouthStretchRight'],
+    },
+    mouth_corner: {
+        positive: ['mouthSmileLeft', 'mouthSmileRight'],
+        negative: ['mouthFrownLeft', 'mouthFrownRight'],
+    },
+};
+export function isArkitBlendshapeModel(modelMorphNames) {
+    const lower = modelMorphNames.map((n) => n.toLowerCase());
+    return lower.some((n) => n.startsWith('brow') ||
+        n.startsWith('jaw') ||
+        n.startsWith('mouthsmile') ||
+        n === 'browinnerup' ||
+        n === 'jawopen');
+}
+function findMorphName(needle, modelMorphNames) {
+    const lowerNeedle = needle.toLowerCase();
+    const exact = modelMorphNames.find((n) => n.toLowerCase() === lowerNeedle);
+    if (exact)
+        return exact;
+    const partial = modelMorphNames.find((n) => n.toLowerCase().includes(lowerNeedle));
+    return partial ?? null;
+}
+export function resolveMorphNamesInModel(templates, modelMorphNames) {
+    const modelSet = new Set(modelMorphNames);
+    const out = new Set();
+    for (const template of templates) {
+        const hit = findMorphName(template, modelMorphNames);
+        if (hit)
+            out.add(hit);
+        const lower = template.toLowerCase();
+        if (lower.endsWith('left')) {
+            const rightTemplate = template.replace(/left$/i, 'Right');
+            const rightHit = findMorphName(rightTemplate, modelMorphNames);
+            if (rightHit)
+                out.add(rightHit);
+        }
+        else if (lower.endsWith('right')) {
+            const leftTemplate = template.replace(/right$/i, 'Left');
+            const leftHit = findMorphName(leftTemplate, modelMorphNames);
+            if (leftHit)
+                out.add(leftHit);
+        }
+    }
+    return [...out].filter((n) => modelSet.has(n));
+}
+export function resolveArkitCatalogMorphNames(catalogId, modelMorphNames) {
+    const spec = ARKIT_CATALOG_MORPH_SPECS[catalogId];
+    if (!spec)
+        return { positive: [], negative: [] };
+    return {
+        positive: resolveMorphNamesInModel(spec.positive ?? [], modelMorphNames),
+        negative: resolveMorphNamesInModel(spec.negative ?? [], modelMorphNames),
+    };
+}
+export function isArkitMorphCatalogIdBound(catalogId, modelMorphNames) {
+    const { positive, negative } = resolveArkitCatalogMorphNames(catalogId, modelMorphNames);
+    return positive.length > 0 || negative.length > 0;
+}
+export function morphSliderToArkitInfluence(v) {
+    return Math.max(0, Math.min(1, v));
+}
+export function morphSliderToSymmetricInfluence(v) {
+    return (v + 1) / 2;
+}
+//# sourceMappingURL=agentAvatar3dArkitMorph.js.map

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

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

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

@@ -0,0 +1,44 @@
+export type Avatar3dEditorMode = 'procedural' | 'glb_custom' | 'glb_monolithic';
+export interface Avatar3dColorCapabilities {
+    skin: boolean;
+    hair: boolean;
+    eye: boolean;
+}
+export interface Avatar3dMeshInventoryEntry {
+    meshName: string;
+    materialNames: string[];
+    hasTextureMap: boolean;
+    visible: boolean;
+}
+export interface Avatar3dCapabilities {
+    mode: Avatar3dEditorMode;
+    colors: Avatar3dColorCapabilities;
+    morphBoundCount: number;
+    morphTotal: number;
+    isArkit: boolean;
+    colorHint?: string;
+    morphHint?: string;
+}
+type ThreeLikeMaterial = {
+    name?: string;
+    map?: unknown;
+};
+type ThreeLikeMesh = {
+    isMesh?: boolean;
+    name?: string;
+    visible?: boolean;
+    material?: ThreeLikeMaterial | ThreeLikeMaterial[];
+};
+type ThreeLikeObject = {
+    traverse: (fn: (obj: ThreeLikeMesh) => void) => void;
+};
+export declare function listAvatar3dMeshInventory(root: ThreeLikeObject | null | undefined): Avatar3dMeshInventoryEntry[];
+export declare function isMonolithicTextureAvatar(inventory: Avatar3dMeshInventoryEntry[]): boolean;
+export declare function proceduralAvatar3dCapabilities(): Avatar3dCapabilities;
+export declare function deriveAvatar3dCapabilities(input: {
+    useProcedural: boolean;
+    inventory: Avatar3dMeshInventoryEntry[];
+    morphNames: string[];
+}): Avatar3dCapabilities;
+export declare function hasAnyAvatar3dColorCapability(colors: Avatar3dColorCapabilities): boolean;
+export {};