zcw-shared 2.25.0 → 2.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "2.25.0",
+  "version": "2.27.0",
   "files": [
     "references",
     "dist",
@@ -33,9 +33,13 @@
     "typescript": "^5.8.3",
     "vitepress": "^1.6.4",
     "vue": "^3.5.22",
-    "zcw-vue-ui": "^1.25.1"
+    "zcw-vue-ui": "^1.31.0"
   },
   "exports": {
+    "./constants/agentAvatar3d": "./dist/constants/agentAvatar3d.js",
+    "./constants/agentAvatar3dModular": "./dist/constants/agentAvatar3dModular.js",
+    "./constants/agentPresence3dLabels": "./dist/constants/agentPresence3dLabels.js",
+    "./constants/aiApiRoutes": "./dist/constants/aiApiRoutes.js",
     "./constants/aiChatSuggestions": "./dist/constants/aiChatSuggestions.js",
     "./constants/api": "./dist/constants/api.js",
     "./constants/apiErrorCodes": "./dist/constants/apiErrorCodes.js",
@@ -51,26 +55,39 @@
     "./constants/namedColors": "./dist/constants/namedColors.js",
     "./constants/softwareConfigs": "./dist/constants/softwareConfigs.js",
     "./functions/ag-grid/generateLicense": "./dist/functions/ag-grid/generateLicense.js",
+    "./functions/ai/agentAvatar3dArkitMorph": "./dist/functions/ai/agentAvatar3dArkitMorph.js",
+    "./functions/ai/agentAvatar3dCapabilities": "./dist/functions/ai/agentAvatar3dCapabilities.js",
+    "./functions/ai/agentAvatar3dFacePresets": "./dist/functions/ai/agentAvatar3dFacePresets.js",
+    "./functions/ai/agentAvatar3dMaterialTint": "./dist/functions/ai/agentAvatar3dMaterialTint.js",
+    "./functions/ai/agentAvatar3dMorphCatalog": "./dist/functions/ai/agentAvatar3dMorphCatalog.js",
     "./functions/ai/aiAgentToolTimeline": "./dist/functions/ai/aiAgentToolTimeline.js",
     "./functions/ai/aiChatSessionListDom": "./dist/functions/ai/aiChatSessionListDom.js",
     "./functions/ai/aiChatSessionOps": "./dist/functions/ai/aiChatSessionOps.js",
     "./functions/ai/aiChatSessionPins": "./dist/functions/ai/aiChatSessionPins.js",
     "./functions/ai/aiLlmModelCapabilities": "./dist/functions/ai/aiLlmModelCapabilities.js",
     "./functions/ai/aiReplyStreamDisplay": "./dist/functions/ai/aiReplyStreamDisplay.js",
+    "./functions/ai/applyAiAgentAvatar3dFace": "./dist/functions/ai/applyAiAgentAvatar3dFace.js",
     "./functions/ai/applyLlmExtraBody": "./dist/functions/ai/applyLlmExtraBody.js",
     "./functions/ai/buildOpenAiChatCompletionsRequestBody": "./dist/functions/ai/buildOpenAiChatCompletionsRequestBody.js",
     "./functions/ai/buildResolvedLlmToolsList": "./dist/functions/ai/buildResolvedLlmToolsList.js",
     "./functions/ai/catalogLinkMode": "./dist/functions/ai/catalogLinkMode.js",
     "./functions/ai/createSyntheticAgentEmail": "./dist/functions/ai/createSyntheticAgentEmail.js",
     "./functions/ai/fetchAiChatSuggestions": "./dist/functions/ai/fetchAiChatSuggestions.js",
+    "./functions/ai/getEffectiveAvatar3dMorphWeights": "./dist/functions/ai/getEffectiveAvatar3dMorphWeights.js",
     "./functions/ai/isValidMcpToolWirePayload": "./dist/functions/ai/isValidMcpToolWirePayload.js",
     "./functions/ai/mapAiChatMessagesToImChat": "./dist/functions/ai/mapAiChatMessagesToImChat.js",
     "./functions/ai/mcpUpstreamAuthHeaders": "./dist/functions/ai/mcpUpstreamAuthHeaders.js",
+    "./functions/ai/normalizeAiAgentAvatar3d": "./dist/functions/ai/normalizeAiAgentAvatar3d.js",
+    "./functions/ai/normalizeAiAgentAvatar3dFace": "./dist/functions/ai/normalizeAiAgentAvatar3dFace.js",
+    "./functions/ai/normalizeAiAgentAvatar3dModular": "./dist/functions/ai/normalizeAiAgentAvatar3dModular.js",
     "./functions/ai/normalizeAiAgentReplyFormat": "./dist/functions/ai/normalizeAiAgentReplyFormat.js",
     "./functions/ai/normalizeAiAttachmentPayloadFormat": "./dist/functions/ai/normalizeAiAttachmentPayloadFormat.js",
     "./functions/ai/normalizeMcpToolsWireFormat": "./dist/functions/ai/normalizeMcpToolsWireFormat.js",
     "./functions/ai/normalizeToolProcessEnv": "./dist/functions/ai/normalizeToolProcessEnv.js",
     "./functions/ai/pickToolChoiceFromAgentToolsConfig": "./dist/functions/ai/pickToolChoiceFromAgentToolsConfig.js",
+    "./functions/ai/proceduralHumanoidMorph": "./dist/functions/ai/proceduralHumanoidMorph.js",
+    "./functions/ai/randomizeModularAvatar3dAppearance": "./dist/functions/ai/randomizeModularAvatar3dAppearance.js",
+    "./functions/ai/resolveAvatar3dModular": "./dist/functions/ai/resolveAvatar3dModular.js",
     "./functions/ai/toolCatalogInlineEnv": "./dist/functions/ai/toolCatalogInlineEnv.js",
     "./functions/algorithm/binarySearch": "./dist/functions/algorithm/binarySearch.js",
     "./functions/algorithm/canJump": "./dist/functions/algorithm/canJump.js",
@@ -173,9 +190,13 @@
     "./functions/browser/isMobile": "./dist/functions/browser/isMobile.js",
     "./functions/browser/isNonNativeBrowserShell": "./dist/functions/browser/isNonNativeBrowserShell.js",
     "./functions/browser/isWeChat": "./dist/functions/browser/isWeChat.js",
+    "./functions/browser/readBrowserAppendToBodyDeps": "./dist/functions/browser/readBrowserAppendToBodyDeps.js",
     "./functions/browser/readBrowserDetectDeps": "./dist/functions/browser/readBrowserDetectDeps.js",
+    "./functions/browser/readBrowserHost": "./dist/functions/browser/readBrowserHost.js",
     "./functions/browser/readBrowserImageCompressDeps": "./dist/functions/browser/readBrowserImageCompressDeps.js",
+    "./functions/browser/readBrowserLassoSelectionEnvironment": "./dist/functions/browser/readBrowserLassoSelectionEnvironment.js",
     "./functions/browser/readBrowserOsInfo": "./dist/functions/browser/readBrowserOsInfo.js",
+    "./functions/browser/readBrowserVueHookDeps": "./dist/functions/browser/readBrowserVueHookDeps.js",
     "./functions/browser/requireBrowserLocalStorage": "./dist/functions/browser/requireBrowserLocalStorage.js",
     "./functions/browser/shortcutModKeyHint": "./dist/functions/browser/shortcutModKeyHint.js",
     "./functions/build/readCapacitorShellExecBuildFlag": "./dist/functions/build/readCapacitorShellExecBuildFlag.js",
@@ -262,16 +283,20 @@
     "./functions/design-tokens/generateVariables": "./dist/functions/design-tokens/generateVariables.js",
     "./functions/design-tokens/mixColors": "./dist/functions/design-tokens/mixColors.js",
     "./functions/design-tokens/parseDesignTokens": "./dist/functions/design-tokens/parseDesignTokens.js",
+    "./functions/dom/appTheme": "./dist/functions/dom/appTheme.js",
     "./functions/dom/computePosition": "./dist/functions/dom/computePosition.js",
     "./functions/dom/copyHtmlAndPlainToClipboard": "./dist/functions/dom/copyHtmlAndPlainToClipboard.js",
     "./functions/dom/copyTextToClipboard": "./dist/functions/dom/copyTextToClipboard.js",
     "./functions/dom/createSharedKeyboardCenter": "./dist/functions/dom/createSharedKeyboardCenter.js",
     "./functions/dom/createThrottledEventListener": "./dist/functions/dom/createThrottledEventListener.js",
+    "./functions/dom/createTooltipLongPressHandlers": "./dist/functions/dom/createTooltipLongPressHandlers.js",
     "./functions/dom/demonstrateResourceLoading": "./dist/functions/dom/demonstrateResourceLoading.js",
     "./functions/dom/detectOverflow": "./dist/functions/dom/detectOverflow.js",
+    "./functions/dom/domDocumentSelection": "./dist/functions/dom/domDocumentSelection.js",
     "./functions/dom/domSelectionInElement": "./dist/functions/dom/domSelectionInElement.js",
     "./functions/dom/executeCopyTextToClipboard": "./dist/functions/dom/executeCopyTextToClipboard.js",
     "./functions/dom/fetchBlobFromUrl": "./dist/functions/dom/fetchBlobFromUrl.js",
+    "./functions/dom/fileDrag": "./dist/functions/dom/fileDrag.js",
     "./functions/dom/getAlignment": "./dist/functions/dom/getAlignment.js",
     "./functions/dom/getBasePlacement": "./dist/functions/dom/getBasePlacement.js",
     "./functions/dom/getCrossAxisFlip": "./dist/functions/dom/getCrossAxisFlip.js",
@@ -283,9 +308,12 @@
     "./functions/dom/imageBlobToPng": "./dist/functions/dom/imageBlobToPng.js",
     "./functions/dom/isTextTruncated": "./dist/functions/dom/isTextTruncated.js",
     "./functions/dom/isValidPlacement": "./dist/functions/dom/isValidPlacement.js",
+    "./functions/dom/lassoSelection": "./dist/functions/dom/lassoSelection.js",
     "./functions/dom/localFileInput": "./dist/functions/dom/localFileInput.js",
     "./functions/dom/pickFile": "./dist/functions/dom/pickFile.js",
+    "./functions/dom/readBrowserDomDeps": "./dist/functions/dom/readBrowserDomDeps.js",
     "./functions/dom/resolveChatMessageImageFromContextMenu": "./dist/functions/dom/resolveChatMessageImageFromContextMenu.js",
+    "./functions/dom/resolveOverlayTeleportParent": "./dist/functions/dom/resolveOverlayTeleportParent.js",
     "./functions/dom/writeImageBlobToClipboard": "./dist/functions/dom/writeImageBlobToClipboard.js",
     "./functions/download/adaptDownloadDispatcherForUrlFeedback": "./dist/functions/download/adaptDownloadDispatcherForUrlFeedback.js",
     "./functions/download/buildCapacitorDownloadRelativePath": "./dist/functions/download/buildCapacitorDownloadRelativePath.js",
@@ -483,6 +511,7 @@
     "./functions/im/imMessageNormalize": "./dist/functions/im/imMessageNormalize.js",
     "./functions/im/imMessageToChatMessage": "./dist/functions/im/imMessageToChatMessage.js",
     "./functions/im/imMultiSelectBatchAction": "./dist/functions/im/imMultiSelectBatchAction.js",
+    "./functions/im/imOrchestrationTypes": "./dist/functions/im/imOrchestrationTypes.js",
     "./functions/im/imOutboundListSummary": "./dist/functions/im/imOutboundListSummary.js",
     "./functions/im/imOutboundMediaHelpers": "./dist/functions/im/imOutboundMediaHelpers.js",
     "./functions/im/imOutboundPatch": "./dist/functions/im/imOutboundPatch.js",
@@ -581,6 +610,7 @@
     "./functions/math/percentile": "./dist/functions/math/percentile.js",
     "./functions/math/sum": "./dist/functions/math/sum.js",
     "./functions/number/clamp": "./dist/functions/number/clamp.js",
+    "./functions/number/clampIndex": "./dist/functions/number/clampIndex.js",
     "./functions/number/formatNumber": "./dist/functions/number/formatNumber.js",
     "./functions/number/random": "./dist/functions/number/random.js",
     "./functions/number/range": "./dist/functions/number/range.js",
@@ -635,6 +665,7 @@
     "./functions/project/buildProjectMachineHeaders": "./dist/functions/project/buildProjectMachineHeaders.js",
     "./functions/promise/sleep": "./dist/functions/promise/sleep.js",
     "./functions/promise/timeout": "./dist/functions/promise/timeout.js",
+    "./functions/qiankun/bootstrapQiankunDomPatch": "./dist/functions/qiankun/bootstrapQiankunDomPatch.js",
     "./functions/qiankun/createQiankunVueApp": "./dist/functions/qiankun/createQiankunVueApp.js",
     "./functions/release/buildCapacitorApkCacheRelPath": "./dist/functions/release/buildCapacitorApkCacheRelPath.js",
     "./functions/release/buildCapacitorApkUpdatePrompt": "./dist/functions/release/buildCapacitorApkUpdatePrompt.js",
@@ -660,6 +691,7 @@
     "./functions/release/openElectronDesktopClientDownload": "./dist/functions/release/openElectronDesktopClientDownload.js",
     "./functions/release/pickCapacitorAndroidPackage": "./dist/functions/release/pickCapacitorAndroidPackage.js",
     "./functions/release/pickElectronReleasePackage": "./dist/functions/release/pickElectronReleasePackage.js",
+    "./functions/release/readBrowserReleaseDeps": "./dist/functions/release/readBrowserReleaseDeps.js",
     "./functions/release/releaseUpdateDismissSession": "./dist/functions/release/releaseUpdateDismissSession.js",
     "./functions/release/releaseUpdatePolicy": "./dist/functions/release/releaseUpdatePolicy.js",
     "./functions/release/sanitizeCapacitorDownloadFileName": "./dist/functions/release/sanitizeCapacitorDownloadFileName.js",
@@ -670,6 +702,8 @@
     "./functions/software/findSoftware": "./dist/functions/software/findSoftware.js",
     "./functions/sse/namedSseStream": "./dist/functions/sse/namedSseStream.js",
     "./functions/storage/clearAppCachePreservingAuth": "./dist/functions/storage/clearAppCachePreservingAuth.js",
+    "./functions/storage/createBrowserSessionStorageKit": "./dist/functions/storage/createBrowserSessionStorageKit.js",
+    "./functions/storage/createBrowserStringStorageKit": "./dist/functions/storage/createBrowserStringStorageKit.js",
     "./functions/storage/useDexieShortcuts": "./dist/functions/storage/useDexieShortcuts.js",
     "./functions/storage/useLocalStorage": "./dist/functions/storage/useLocalStorage.js",
     "./functions/storage/useSessionStorage": "./dist/functions/storage/useSessionStorage.js",
@@ -782,6 +816,8 @@
     "./functions/vue/isVNode": "./dist/functions/vue/isVNode.js",
     "./functions/vue/isVueComponent": "./dist/functions/vue/isVueComponent.js",
     "./functions/vue/parseVueFile": "./dist/functions/vue/parseVueFile.js",
+    "./functions/vue-router/normalizeWebHistoryBase": "./dist/functions/vue-router/normalizeWebHistoryBase.js",
+    "./functions/vue-router/pushInAppRoute": "./dist/functions/vue-router/pushInAppRoute.js",
     "./functions/wallet/createBrowserWalletPayPasswordSessionAccess": "./dist/functions/wallet/createBrowserWalletPayPasswordSessionAccess.js",
     "./functions/wallet/trc20PayQr": "./dist/functions/wallet/trc20PayQr.js",
     "./functions/wallet/walletLedgerUi": "./dist/functions/wallet/walletLedgerUi.js",
@@ -803,8 +839,10 @@
     "./vue-hooks/browser/useBattery": "./dist/vue-hooks/browser/useBattery.js",
     "./vue-hooks/browser/useBluetooth": "./dist/vue-hooks/browser/useBluetooth.js",
     "./vue-hooks/browser/useBridgeMessage": "./dist/vue-hooks/browser/useBridgeMessage.js",
+    "./vue-hooks/browser/useBrowserFileObjectUrlMap": "./dist/vue-hooks/browser/useBrowserFileObjectUrlMap.js",
     "./vue-hooks/browser/useCamera": "./dist/vue-hooks/browser/useCamera.js",
     "./vue-hooks/browser/useClipboard": "./dist/vue-hooks/browser/useClipboard.js",
+    "./vue-hooks/browser/useFileObjectUrlMap": "./dist/vue-hooks/browser/useFileObjectUrlMap.js",
     "./vue-hooks/browser/useFileUpload": "./dist/vue-hooks/browser/useFileUpload.js",
     "./vue-hooks/browser/useFullscreen": "./dist/vue-hooks/browser/useFullscreen.js",
     "./vue-hooks/browser/useGamepad": "./dist/vue-hooks/browser/useGamepad.js",
@@ -821,9 +859,13 @@
     "./vue-hooks/browser/useWechatJSSDK": "./dist/vue-hooks/browser/useWechatJSSDK.js",
     "./vue-hooks/dom/useAppendToBody": "./dist/vue-hooks/dom/useAppendToBody.js",
     "./vue-hooks/dom/useAutoUpdate": "./dist/vue-hooks/dom/useAutoUpdate.js",
+    "./vue-hooks/dom/useBrowserFocusVisible": "./dist/vue-hooks/dom/useBrowserFocusVisible.js",
+    "./vue-hooks/dom/useBrowserLassoSelection": "./dist/vue-hooks/dom/useBrowserLassoSelection.js",
     "./vue-hooks/dom/useClickOutside": "./dist/vue-hooks/dom/useClickOutside.js",
     "./vue-hooks/dom/useDraggable": "./dist/vue-hooks/dom/useDraggable.js",
     "./vue-hooks/dom/useEventListener": "./dist/vue-hooks/dom/useEventListener.js",
+    "./vue-hooks/dom/useFocusVisible": "./dist/vue-hooks/dom/useFocusVisible.js",
+    "./vue-hooks/dom/useLassoSelection": "./dist/vue-hooks/dom/useLassoSelection.js",
     "./vue-hooks/dom/useResizable": "./dist/vue-hooks/dom/useResizable.js",
     "./vue-hooks/history/useDebouncedRefHistory": "./dist/vue-hooks/history/useDebouncedRefHistory.js",
     "./vue-hooks/history/useManualRefHistory": "./dist/vue-hooks/history/useManualRefHistory.js",
@@ -841,6 +883,8 @@
     "./vue-hooks/state/useToggle": "./dist/vue-hooks/state/useToggle.js",
     "./vue-hooks/state/useTokenManager": "./dist/vue-hooks/state/useTokenManager.js",
     "./vue-hooks/state/useUserManager": "./dist/vue-hooks/state/useUserManager.js",
+    "./vue-hooks/time/useBrowserDelayedTrue": "./dist/vue-hooks/time/useBrowserDelayedTrue.js",
+    "./vue-hooks/time/useDelayedTrue": "./dist/vue-hooks/time/useDelayedTrue.js",
     "./vue-hooks/time/useInterval": "./dist/vue-hooks/time/useInterval.js",
     "./vue-hooks/time/useTimeout": "./dist/vue-hooks/time/useTimeout.js",
     "./vue-hooks/worker/useWebWorker": "./dist/vue-hooks/worker/useWebWorker.js",
@@ -848,6 +892,7 @@
     "./vue-hooks/worker/useWorkerPool": "./dist/vue-hooks/worker/useWorkerPool.js",
     "./types/address": "./types/address.d.ts",
     "./types/agent-input-content": "./types/agent-input-content.d.ts",
+    "./types/ai-admin": "./types/ai-admin.d.ts",
     "./types/ai-agent": "./types/ai-agent.d.ts",
     "./types/ai-chat": "./types/ai-chat.d.ts",
     "./types/ai-llm-model-capabilities": "./types/ai-llm-model-capabilities.d.ts",
@@ -857,6 +902,8 @@
     "./types/altool": "./types/altool.d.ts",
     "./types/android-build": "./types/android-build.d.ts",
     "./types/api-client": "./types/api-client.d.ts",
+    "./types/api-contract-helpers": "./types/api-contract-helpers.d.ts",
+    "./types/api-contract": "./types/api-contract.d.ts",
     "./types/app-safe-area": "./types/app-safe-area.d.ts",
     "./types/assets": "./types/assets.d.ts",
     "./types/auth": "./types/auth.d.ts",
@@ -869,6 +916,8 @@
     "./types/cloud-disk-config": "./types/cloud-disk-config.d.ts",
     "./types/cloud-disk": "./types/cloud-disk.d.ts",
     "./types/color": "./types/color.d.ts",
+    "./types/community": "./types/community.d.ts",
+    "./types/component-material": "./types/component-material.d.ts",
     "./types/design-system": "./types/design-system.d.ts",
     "./types/download": "./types/download.d.ts",
     "./types/electron-release-manifest": "./types/electron-release-manifest.d.ts",
@@ -890,11 +939,14 @@
     "./types/im-wallet-message": "./types/im-wallet-message.d.ts",
     "./types/ios-build": "./types/ios-build.d.ts",
     "./types/llm-openai-wire": "./types/llm-openai-wire.d.ts",
+    "./types/lowcode": "./types/lowcode.d.ts",
     "./types/music": "./types/music.d.ts",
     "./types/named-sse": "./types/named-sse.d.ts",
     "./types/notification": "./types/notification.d.ts",
     "./types/observability": "./types/observability.d.ts",
+    "./types/openapi": "./types/openapi.d.ts",
     "./types/order": "./types/order.d.ts",
+    "./types/org": "./types/org.d.ts",
     "./types/oss-signed-upload": "./types/oss-signed-upload.d.ts",
     "./types/oss": "./types/oss.d.ts",
     "./types/page-config": "./types/page-config.d.ts",
@@ -907,6 +959,7 @@
     "./types/product": "./types/product.d.ts",
     "./types/rbac": "./types/rbac.d.ts",
     "./types/reactive": "./types/reactive.d.ts",
+    "./types/recharge": "./types/recharge.d.ts",
     "./types/report": "./types/report.d.ts",
     "./types/review": "./types/review.d.ts",
     "./types/semver": "./types/semver.d.ts",

package/types/address.d.ts

@@ -1,38 +1,7 @@
-export interface Address {
-  id: number
-  user_id?: string
-  name?: string
-  phone?: string
-  province?: string
-  city?: string
-  district?: string
-  detail?: string
-  is_default?: boolean
-  created_at?: string
-  updated_at?: string
-}
+import type { ApiSchema } from './api-contract'
 
-export interface AddressListResponse {
-  data: Address[]
-  count: number
-}
+export type Address = ApiSchema['Address']
 
-export interface CreateAddressPayload {
-  name: string
-  phone: string
-  province: string
-  city: string
-  district?: string
-  detail: string
-  is_default?: boolean
-}
+export type CreateAddressPayload = ApiSchema['CreateAddressRequest']
 
-export interface UpdateAddressPayload {
-  name?: string
-  phone?: string
-  province?: string
-  city?: string
-  district?: string
-  detail?: string
-  is_default?: boolean
-}
+export type UpdateAddressPayload = ApiSchema['UpdateAddressRequest']

package/types/ai-admin.d.ts

@@ -0,0 +1,33 @@
+import type { ApiSchema } from './api-contract'
+
+export type AiAgentPublic = ApiSchema['AiAgentPublic']
+
+export type AiAgentTask = ApiSchema['AiAgentTask']
+
+export type AiAgentTaskRun = ApiSchema['AiAgentTaskRun']
+
+export type AiAgentRuntimeSnapshot = ApiSchema['AiAgentRuntimeSnapshot']
+
+export type AiAgentAutomationConfig = ApiSchema['AiAgentAutomationConfig']
+
+export type AiAgentTaskExecution = ApiSchema['AiAgentTaskExecution']
+
+export type AiAgentOrchestration = ApiSchema['AiAgentOrchestration']
+
+export type AiAgentOrchestrationStep = ApiSchema['AiAgentOrchestrationStep']
+
+export type AiAgentOrchestrationDetail = ApiSchema['AiAgentOrchestrationDetail']
+
+export type AiToolCatalog = ApiSchema['AiToolCatalog']
+
+export type AiMcpCatalog = ApiSchema['AiMcpCatalog']
+
+export type LlmGatewayInfo = ApiSchema['LlmGatewayInfo']
+
+export type DynamicToolsHintBlock = ApiSchema['DynamicToolsHintBlock']
+
+export type AiSettingsHintBlocks = ApiSchema['AiSettingsHintBlocks']
+
+export type AgentActiveHours = ApiSchema['AgentActiveHours']
+
+export type AiGatewayTickResult = ApiSchema['AiGatewayTickResult']

package/types/ai-agent.d.ts

@@ -3,3 +3,46 @@ export type AiAgentReplyFormat = 'markdown' | 'text' | 'json'
 
 /** 智能体多模态载荷编码（`ai_agents.attachment_payload_format`） */
 export type AiAttachmentPayloadFormat = 'ag_ui' | 'openai'
+
+/** `ai_agents.avatar_3d.face` */
+export interface AiAgentAvatar3dFace {
+  skinColor?: string
+  hairColor?: string
+  eyeColor?: string
+  faceWidth?: number
+  faceRound?: number
+  eyeSize?: number
+  noseSize?: number
+  mouthSize?: number
+  morphWeights?: Record<string, number>
+}
+
+/** `avatar_3d.modular.slots` */
+export interface AiAgentAvatar3dModularSlots {
+  hair?: string
+  top?: string
+  bottom?: string
+  shoes?: string
+  gloves?: string
+  headwear?: string
+  faceAccessory?: string
+}
+
+/** `avatar_3d.modular` */
+export interface AiAgentAvatar3dModular {
+  version: 'v1'
+  basePartId: string
+  skeletonProfile: 'rpm_mixamo'
+  slots: AiAgentAvatar3dModularSlots
+}
+
+/** `ai_agents.avatar_3d` JSONB */
+export interface AiAgentAvatar3d {
+  modular?: AiAgentAvatar3dModular
+  builtin?: 'humanoid_v1'
+  modelUrl?: string
+  format?: 'glb' | 'gltf' | 'fbx'
+  scale?: number
+  rotationY?: number
+  face?: AiAgentAvatar3dFace
+}

package/types/ai-chat.d.ts

@@ -1,23 +1,39 @@
-export type AiChatMessageRole = 'user' | 'assistant' | 'system'
-
-export interface AiChatMessage {
-  id: string
-  session_id: string
-  role: AiChatMessageRole
-  content: string
-  created_at: string
-}
-
-export type AiChatSuggestionCategory = 'news' | 'creative' | 'qa' | 'general'
-
-export interface AiChatSuggestion {
-  id: string
-  text: string
-  category?: AiChatSuggestionCategory
-}
-
-/** GET /ai-chat/suggestions 响应体 */
-export interface AiChatSuggestionsPayload {
-  title: string
-  items: AiChatSuggestion[]
-}
+import type { ApiOpRequestBody, ApiSchema } from './api-contract'
+
+export type AiChatMessageRole = ApiSchema['AiChatMessage']['role']
+
+export type AiChatMessage = ApiSchema['AiChatMessage']
+
+export type AiChatAvailableModel = ApiSchema['AiChatModelOption']
+
+export type AiChatSession = ApiSchema['AiChatSession']
+
+export type AiChatMessageFeedbackVote = NonNullable<ApiSchema['AiChatMessage']['feedback_vote']>
+
+export type AiChatMessageFeedback = ApiSchema['AiChatMessageFeedback']
+
+export type AiChatMessageSpeechPayload = ApiSchema['AiChatMessageSpeech']
+
+export type AiChatMessageSharePayload = ApiSchema['AiChatMessageShare']
+
+export type AiChatMessageListPayload = ApiSchema['AiChatMessageList']
+
+export type AiChatSuggestionCategory = NonNullable<
+  ApiSchema['AiChatSuggestionItem']['category']
+>
+
+export type AiChatSuggestion = ApiSchema['AiChatSuggestionItem']
+
+/** GET /chat/ai/suggestions 响应体 */
+export type AiChatSuggestionsPayload = ApiSchema['AiChatSuggestionsPayload']
+
+/** GET /chat/ai/shares/:token 公开分享内容 */
+export type AiChatPublicSharePayload = ApiSchema['AiChatPublicShare']
+
+export type AiChatStreamMessageBody = ApiOpRequestBody<'ChatAi_sendMessage'>
+
+export type AiChatStreamFirstMessageBody = ApiOpRequestBody<'ChatAi_createSessionWithFirstMessage'>
+
+export type CreateAiChatSessionBody = ApiOpRequestBody<'ChatAi_createSession'>
+
+export type UpdateAiChatSessionBody = ApiOpRequestBody<'ChatAi_updateSession'>

package/types/api-contract-helpers.d.ts

@@ -0,0 +1,24 @@
+import type { operations } from "./openapi";
+
+type JsonBody<R> = R extends { content: { "application/json": infer B } } ? B : never;
+
+type Response200Body<Op extends keyof operations> = operations[Op] extends {
+  responses: { 200: infer R };
+}
+  ? JsonBody<R>
+  : never;
+
+/** 从 operation 提取 200 响应的 `data`（ApiEnvelope）；无 data 字段时取整个 body */
+export type ApiOpData<Op extends keyof operations> =
+  Response200Body<Op> extends { data: infer D } ? D : Response200Body<Op>;
+
+/** 从 operation 提取 JSON requestBody */
+export type ApiOpRequestBody<Op extends keyof operations> =
+  operations[Op] extends { requestBody: { content: { "application/json": infer B } } }
+    ? B
+    : never;
+
+/** 从 operation 提取 query 参数 */
+export type ApiOpQuery<Op extends keyof operations> = NonNullable<
+  operations[Op]["parameters"]["query"]
+>;

package/types/api-contract.d.ts

@@ -0,0 +1,6 @@
+/** TypeSpec 契约类型 re-export（由 api pnpm spec:sync-shared 生成） */
+export type { components, operations, paths } from "./openapi";
+
+export type ApiSchema = import("./openapi").components["schemas"];
+
+export type { ApiOpData, ApiOpQuery, ApiOpRequestBody } from "./api-contract-helpers";

package/types/auth.d.ts

@@ -1,18 +1,31 @@
 /**
- * 认证相关 API 类型定义
+ * 认证相关 API 类型定义（与 OpenAPI 契约对齐）
  */
 
+/** 内部 JWT 签发结果（仅服务端 token.service 使用） */
 export interface TokenResult {
   token: string
   expiresIn: number
   expiresAt: number
 }
 
-export interface TokenPair {
+/** 内部 JWT 令牌对（仅服务端签发流程使用） */
+export interface IssuedTokenPair {
   accessToken: TokenResult
   refreshToken: TokenResult
 }
 
+/** OpenAPI TokenPair — 扁平 JWT 登录令牌对 */
+export interface TokenPair {
+  accessToken: string
+  refreshToken: string
+  expiresIn: number
+}
+
+export interface OkResult {
+  ok: true
+}
+
 export interface UserInfo {
   id: string
   phone?: string
@@ -22,31 +35,6 @@ export interface UserInfo {
   avatarUrl?: string
 }
 
-export interface LoginResponse {
-  code: number
-  data: {
-    userInfo: UserInfo
-    tokenPair: TokenPair
-  }
-  message: string
-}
-
-export interface RefreshTokenResponse {
-  code: number
-  data: TokenPair
-  message: string
-}
-
-/** 发送验证码响应：data 不含验证码（安全），仅返回发送结果 */
-export interface SendSmsCodeResponse {
-  code: number
-  data: {
-    success: boolean
-    message: string
-  }
-  message: string
-}
-
 export interface PhoneLoginPayload {
   phone: string
   code: string