zcw-shared 2.23.6 → 2.25.0

package/references/browser.d.ts

@@ -4,7 +4,7 @@ import type { AbortController, Response, FetchFunction } from './fetch.d'
 import type { URLSearchParams } from './url.d'
 import type { Storage } from './storage.d'
 import type { WorkerConstructor } from './worker.d'
-import type { Document, HTMLElement, Element, HTMLImageElement, CSSStyleDeclaration } from './dom.d'
+import type { Document, HTMLElement, Element, HTMLImageElement, CSSStyleDeclaration, Selection } from './dom.d'
 import type { IDBFactory } from './indexeddb.d'
 import type { Blob, BlobPart, BlobPropertyBag, MediaSource, ReadableStream } from './blob.d'
 import type { ImageBitmap } from './dom.d'
@@ -118,6 +118,9 @@ export interface Window {
   // Navigator API
   navigator: Navigator
 
+  // 选区 API
+  getSelection(): Selection | null
+
   // 事件监听API
   addEventListener(type: string, listener: EventListener, options?: boolean | AddEventListenerOptions): void
   removeEventListener(type: string, listener: EventListener, options?: boolean | EventListenerOptions): void

package/references/cos-js-sdk-v5.d.ts

@@ -0,0 +1,36 @@
+/** cos-js-sdk-v5 最小类型（浏览器分片上传） */
+
+export interface CosStsAuthCredentials {
+  TmpSecretId: string
+  TmpSecretKey: string
+  XCosSecurityToken: string
+  StartTime: number
+  ExpiredTime: number
+}
+
+export interface CosSliceUploadProgressInfo {
+  loaded?: number
+  total?: number
+}
+
+export interface CosSliceUploadFileOptions {
+  Bucket: string
+  Region: string
+  Key: string
+  Body: Blob
+  ContentType?: string
+  onProgress?: (info: CosSliceUploadProgressInfo) => void
+}
+
+export interface CosClient {
+  sliceUploadFile: (options: CosSliceUploadFileOptions) => Promise<unknown>
+}
+
+export interface CosConstructor {
+  new (options: {
+    getAuthorization: (
+      options: unknown,
+      callback: (auth: CosStsAuthCredentials) => void,
+    ) => void
+  }): CosClient
+}

package/references/crypto.d.ts

@@ -0,0 +1,10 @@
+import type { BufferSource } from './arraybuffer.d'
+
+export interface SubtleCrypto {
+  digest(algorithm: string, data: BufferSource): Promise<ArrayBuffer>
+}
+
+export interface Crypto {
+  getRandomValues<T extends Uint8Array>(array: T): T
+  subtle: SubtleCrypto
+}

package/references/dom.d.ts

@@ -28,6 +28,8 @@ export interface Node {
 // parentNode 不可标为可选：undefined 会破坏与 Node 的结构兼容，导致 appendChild/removeChild 参数报错
 export interface Element extends Node {
   parentNode: Element | null
+  closest(selectors: string): Element | null
+  querySelector(selectors: string): Element | null
 }
 
 export interface HTMLElement extends Element {
@@ -57,6 +59,8 @@ export interface HTMLElement extends Element {
 
 export interface HTMLImageElement extends HTMLElement {
   src: string
+  crossOrigin: string | null
+  complete: boolean
   naturalWidth: number
   naturalHeight: number
   onload: (() => void) | null
@@ -82,7 +86,9 @@ export interface HTMLLinkElement extends HTMLElement {
 
 export interface HTMLAnchorElement extends HTMLElement {
   href: string
+  rel: string
   download: string
+  style: CSSStyleDeclaration
   click(): void
 }
 
@@ -161,6 +167,8 @@ export interface Document extends Node {
   createElement(tagName: 'iframe'): HTMLIFrameElement
   createElement(tagName: 'input'): HTMLInputElement
   createElement(tagName: string): HTMLElement
+  createDocumentFragment(): DocumentFragment
+  createRange(): Range
   querySelector(selector: string): Element | null
   querySelectorAll(selector: string): NodeListOf<Element>
   documentElement: {
@@ -217,6 +225,13 @@ export interface DOMStringList {
   contains(string: string): boolean
 }
 
+export interface DataTransfer {
+  setData(format: string, data: string): void
+  getData(format: string): string
+  readonly types: readonly string[]
+  effectAllowed: string
+}
+
 export interface CSSStyleDeclaration {
   position: string
   left: string
@@ -225,4 +240,23 @@ export interface CSSStyleDeclaration {
   height: string
   transform: string
   [property: string]: string
+}
+
+export interface Range {
+  startContainer: Node
+  endContainer: Node
+  cloneRange(): Range
+  cloneContents(): DocumentFragment
+  toString(): string
+  selectNodeContents(node: Node): void
+}
+
+export interface DocumentFragment extends Node {
+  appendChild<T extends Node>(node: T): T
+}
+
+export interface Selection {
+  rangeCount: number
+  isCollapsed: boolean
+  getRangeAt(index: number): Range
 }

package/references/xhr.d.ts

@@ -1,6 +1,16 @@
 import type { BodyInit, FormData } from './fetch.d'
 import type { Document } from './dom.d'
 
+export interface ProgressEvent {
+  lengthComputable: boolean
+  loaded: number
+  total: number
+}
+
+export interface XMLHttpRequestUpload {
+  onprogress: ((ev: ProgressEvent) => void) | null
+}
+
 export type XMLHttpRequestResponseType =
   | ''
   | 'arraybuffer'
@@ -10,6 +20,7 @@ export type XMLHttpRequestResponseType =
   | 'text'
 
 export interface XMLHttpRequest {
+  readonly upload: XMLHttpRequestUpload
   readonly readyState: number
   response: any
   responseText: string

package/types/agent-input-content.d.ts

@@ -0,0 +1,12 @@
+/** 内部会话线（Agent / IM）用的多模态用户内容块；发往上游前须经 adapters 转换 */
+export type AgentInputContentPart =
+  | { type: 'text'; text: string }
+  | {
+      type: 'binary'
+      mimeType: string
+      url: string
+      filename?: string
+    }
+  | { type: 'image_url'; image_url: { url: string } }
+  | { type: 'video_url'; video_url: { url: string } }
+  | { type: 'file_url'; file_url: { url: string } }

package/types/ai-agent.d.ts

@@ -0,0 +1,5 @@
+/** 助手回复写入 IM 消息时的正文格式（`ai_agents.reply_format`） */
+export type AiAgentReplyFormat = 'markdown' | 'text' | 'json'
+
+/** 智能体多模态载荷编码（`ai_agents.attachment_payload_format`） */
+export type AiAttachmentPayloadFormat = 'ag_ui' | 'openai'

package/types/ai-chat.d.ts

@@ -0,0 +1,23 @@
+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[]
+}

package/types/ai-mcp.d.ts

@@ -0,0 +1,18 @@
+/** 与 `ai_llm_models.mcp_tools_wire_format` 一致 */
+export type McpToolsWireFormat = 'zhipu' | 'openai_flat'
+
+export type AiMcpAuthorizationHeaderMode =
+  | 'authorization_bearer'
+  | 'custom_header'
+
+/** 目录行解析 LLM tools 所需的最小字段 */
+export interface AiToolCatalogRowForLlmResolve {
+  id: string
+  name: string
+  enabled: boolean
+}
+
+export interface AiMcpCatalogRowForLlmResolve {
+  id: string
+  enabled: boolean
+}

package/types/api-client.d.ts

@@ -0,0 +1,35 @@
+/** API 客户端请求选项 */
+export interface DoFetchOptions {
+  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
+  body?: unknown
+  /** GET 默认合并并发同 path 请求；true 则单独发请求（如强制刷新） */
+  skipInFlightDedupe?: boolean
+  /** 附加请求头（如桌面端 X-Machine-Id） */
+  headers?: Record<string, string>
+}
+
+export interface DoFetchGetOptions {
+  skipInFlightDedupe?: boolean
+}
+
+export interface BuildApiUrlConfig {
+  /** 后端根 URL；空字符串表示同源 + apiPrefix */
+  baseUrl: string
+  /** 同源时的 API 前缀，默认 `/api` */
+  apiPrefix: string
+}
+
+export interface ApiFailureReport {
+  path: string
+  method: string
+  statusCode?: number
+  message: string
+}
+
+export interface DoFetchFormDataOptions {
+  method?: 'POST' | 'PUT' | 'PATCH'
+}
+
+export interface DoFetchFormDataWithProgressOptions extends DoFetchFormDataOptions {
+  onUploadProgress?: (loaded: number, total: number) => void
+}

package/types/app-safe-area.d.ts

@@ -0,0 +1,9 @@
+export type AppSafeAreaProfile = 'capacitor-native' | 'mobile-browser' | 'desktop'
+
+/** 壳层 chrome 由谁负责 safe area */
+export type AppChromeState =
+  | 'standard'
+  | 'tabbar'
+  | 'tabbar-page-top'
+  | 'immersive-top'
+  | 'immersive-full'

package/types/capacitor-ota-release-manifest.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 自建 Web 资源 OTA 清单（zip 整包），供壳内或后续 Capgo 等消费。
+ * 发布路径示例：`/capacitor/ota-manifests/stable/latest.json`
+ */
+
+export interface CapacitorOtaReleaseManifest {
+  version: string
+  pubDate: string
+  channel: string
+  updateMode: 'web'
+  /** 与前端 package version 对齐，用于与原生壳 App.getInfo().version 比较 */
+  minNativeVersion?: string
+  forceUpdate?: boolean
+  minSupportedVersion?: string
+  deadlineAt?: string
+  notes?: string
+  bundleFileName: string
+  bundleUrl: string
+  sha256: string
+  size: number
+}

package/types/capacitor-release-manifest.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 自建 Capacitor（Android）整包更新清单，与 Electron `latest.json` 同字段语义（仅使用 full + packages）。
+ * 发布路径示例：`/capacitor/manifests/stable/latest.json`
+ */
+
+export interface CapacitorAndroidPackage {
+  platform: 'android'
+  /** 可选：arm64-v8a | armeabi-v7a | universal */
+  abi?: string
+  fileName: string
+  url: string
+  sha256: string
+  size: number
+}
+
+export interface CapacitorReleaseManifest {
+  version: string
+  pubDate: string
+  channel: string
+  /** 移动端仅支持 full（整包 APK） */
+  updateMode?: 'full'
+  forceUpdate?: boolean
+  minSupportedVersion?: string
+  deadlineAt?: string
+  notes?: string
+  packages: CapacitorAndroidPackage[]
+}

package/types/chat-appearance.d.ts

@@ -0,0 +1 @@
+export type ChatAppearanceMode = 'light' | 'dark' | 'system'

package/types/cloud-disk.d.ts

@@ -0,0 +1,82 @@
+export type CloudDiskNodeKind = 'folder' | 'file'
+
+/** 列表视图语义（部分 tab 由客户端筛选实现） */
+export type CloudDiskListTab = 'all' | 'recent' | 'shared' | 'trash'
+
+export type CloudDiskNode = {
+  id: string
+  name: string
+  kind: CloudDiskNodeKind
+  parent_id: string | null
+  owner_id: string
+  size?: number | null
+  mime_type?: string | null
+  updated_at: string
+  created_at?: string
+  path_breadcrumb?: string | null
+  is_starred?: boolean
+  is_shared?: boolean
+  is_private?: boolean
+  deleted_at?: string | null
+  url?: string | null
+  thumbnail_url?: string | null
+}
+
+export type CloudDiskListResult = { items: CloudDiskNode[]; total: number }
+
+/** 后端 cloud_disk_files 行（GET /cloud-disk/files 解包后） */
+export type CloudDiskFileDto = {
+  id: string
+  user_id: string
+  name: string
+  type: 'file' | 'folder'
+  parent_id?: string | null
+  path?: string
+  mime_type?: string | null
+  size?: number | null
+  is_starred?: boolean
+  is_shared?: boolean
+  is_private?: boolean
+  created_at?: string
+  updated_at: string
+  deleted_at?: string | null
+  url?: string | null
+  thumbnail_url?: string | null
+}
+
+export type CloudDiskFileCategory =
+  | 'image'
+  | 'doc'
+  | 'video'
+  | 'audio'
+  | 'other'
+
+export type CloudDiskUploadPhase =
+  | 'preparing'
+  | 'uploading'
+  | 'confirming'
+  | 'done'
+  | 'failed'
+
+export type CloudDiskUploadTask = {
+  id: string
+  name: string
+  progress: number
+  phase: CloudDiskUploadPhase
+  error?: string
+}
+
+export type CloudDiskPrivateFolderEntry = { id: string; path: string }
+
+export type CloudDiskMediaAttachmentKind = 'image' | 'video' | 'file'
+
+export type CloudDiskPrivateFolderGuard = {
+  privateEntries: readonly CloudDiskPrivateFolderEntry[]
+  parentMap: ReadonlyMap<string, string | null | undefined>
+  unlockedFolderIds: ReadonlySet<string>
+}
+
+export type CloudDiskNodeDragPayload = {
+  id: string
+  name: string
+}

package/types/download.d.ts

@@ -0,0 +1,54 @@
+/** 下载任务进度（Electron 经 IPC 推送；浏览器通常无中间进度） */
+export interface DownloadProgress {
+  downloadId: string
+  url: string
+  state: 'progressing' | 'completed' | 'cancelled' | 'interrupted'
+  receivedBytes: number
+  totalBytes: number | null
+  /** 0–100；总量未知时为 null */
+  percent: number | null
+  filePath?: string
+  error?: string
+}
+
+export type DownloadBrowserMode = 'window' | 'anchor'
+
+export interface DownloadOptions {
+  url: string
+  /** 建议文件名（不含路径） */
+  filename?: string
+  /**
+   * 落盘目录（绝对路径，仅 Electron）。
+   * 与 `filename` 组合；未给 `filename` 时从 URL 推断。
+   */
+  directory?: string
+  /** 完整落盘路径（绝对路径，仅 Electron）；优先于 directory + filename */
+  savePath?: string
+  /** Electron：无 directory/savePath 时是否弹出另存为，默认 true */
+  showSaveDialog?: boolean
+  /** 浏览器：http(s) 默认 `window` 新标签；blob/data 自动走 `anchor` */
+  browserMode?: DownloadBrowserMode
+  /** 复用任务 id（Electron 进度事件关联） */
+  downloadId?: string
+  onProgress?: (progress: DownloadProgress) => void
+  /** Electron 下载超时（毫秒），默认 180000 */
+  timeoutMs?: number
+}
+
+export type DownloadResult =
+  | {
+      ok: true
+      downloadId: string
+      filePath?: string
+    }
+  | {
+      ok: false
+      downloadId: string
+      error: string
+      cancelled?: boolean
+    }
+
+export type DownloadByUrlHandler = (
+  url: string,
+  suggestedFileName?: string,
+) => void

package/types/electron-release-manifest.d.ts

@@ -0,0 +1,40 @@
+/** 与 `scripts/generate-update-manifest.ts` / `electron/updater.cjs` 清单结构一致 */
+
+export type ElectronReleasePlatform = 'darwin' | 'win32' | 'linux'
+export type ElectronReleaseArch = 'x64' | 'arm64'
+
+export interface ElectronReleasePackage {
+  platform: ElectronReleasePlatform
+  arch: ElectronReleaseArch
+  fileName: string
+  url: string
+  sha256: string
+  size: number
+  blockmapUrl?: string
+}
+
+export interface ElectronReleaseManifest {
+  version: string
+  pubDate?: string
+  channel?: string
+  updateMode?: 'full' | 'renderer' | 'main' | 'mixed'
+  forceUpdate?: boolean
+  minSupportedVersion?: string
+  deadlineAt?: string
+  notes?: string
+  rollout?: number
+  packages?: ElectronReleasePackage[]
+  rendererPackage?: {
+    url: string
+    sha256: string
+    size: number
+    entryHtml: string
+  }
+  mainPackage?: {
+    url: string
+    sha256: string
+    size: number
+    restartRequired: boolean
+  }
+  fallbackFull?: ElectronReleasePackage
+}

package/types/im-account-kind.d.ts

@@ -0,0 +1,2 @@
+/** 与 users.account_kind 一致 */
+export type ImAccountKind = 'person' | 'ai_agent'

package/types/im-ai-agent.d.ts

@@ -0,0 +1,23 @@
+import type { ImAccountKind } from './im-account-kind'
+
+/** `/ai/agents` 列表行（映射 Agent 选项所需字段） */
+export type ImAiAgentCatalogRow = {
+  id?: string | null
+  user_id?: string | null
+  display_name?: string | null
+  bio?: string | null
+  avatar_url?: string | null
+  account_kind?: string | null
+  enabled?: boolean | null
+}
+
+/** 会话侧 AI Agent 选项（新建会话 / @ 提及等） */
+export type ImAiChatAgentOption = {
+  userId: string
+  displayName: string
+  avatarUrl?: string
+  bio?: string
+  accountKind: ImAccountKind
+  /** `ai_agents.id`，用于运行状态 API */
+  agentRowId?: string
+}

package/types/im-api.d.ts

@@ -66,6 +66,8 @@ export interface ImApiMessage {
   extra_data?: Record<string, any>
   created_at?: string
   updated_at?: string
+  /** 软删除时刻（ISO）；存在时列表接口不应返回该条（服务端过滤） */
+  deleted_at?: string | null
 }
 
 /** 会话对象（接口返回；成员 id 列表 + 可选最后一条消息） */
@@ -114,6 +116,7 @@ export interface ImDbMessageRow {
   extra_data?: Record<string, any>
   created_at?: string
   updated_at?: string
+  deleted_at?: string | null
 }
 
 export interface ImDbConversationRow {

package/types/im-chat.d.ts

@@ -193,3 +193,17 @@ export interface ChatConversation {
   /** 消息免打扰：列表不展示未读红点（仅客户端） */
   muted?: boolean
 }
+
+export type ChatConversationHistoryTab = 'records' | 'file' | 'image' | 'link'
+
+export interface ChatConversationHistoryFilters {
+  senderIds: string[]
+  timeStartMs: number | null
+  timeEndMs: number | null
+  mentionUserIds: string[]
+}
+
+export interface ChatConversationHistoryMessagePreview {
+  primary: string
+  thumbnailUrl?: string
+}

package/types/im-code-project.d.ts

@@ -0,0 +1,32 @@
+/** IM 代码工作区项目（GET/POST /im/code-projects，HTTP JSON 驼峰） */
+export interface ImProjectMachineBinding {
+  machineId: string
+  machineLabel: string | null
+  localRootPath: string
+  /** 该 machineId 是否有活跃桌面 Socket（HTTP 初值 + Socket 推送更新） */
+  online: boolean
+  /** 是否为当前请求头 X-Machine-Id 对应电脑 */
+  isViewerMachine: boolean
+}
+
+export interface ImProject {
+  id: string
+  ownerId: string
+  /** 拥有者展示名（会话绑定查询时由服务端解析） */
+  ownerName?: string
+  /** 项目负责人 user id（可选；须为会话内 AI 智能体） */
+  leadUserId?: string | null
+  /** 项目负责人展示名 */
+  leadName?: string
+  conversationId: string
+  name: string
+  rootFolderName: string
+  /** 当前请求携带的 X-Machine-Id（未传则为 null） */
+  viewerMachineId: string | null
+  /** 各桌面端绑定（拥有者可见路径；成员为空数组） */
+  machineBindings: ImProjectMachineBinding[]
+  /** 预留皮肤/主题 id（后端字段 doorSkin） */
+  doorSkin?: string | null
+  createdAt: string
+  updatedAt: string
+}

package/types/im-composer.d.ts

@@ -0,0 +1,23 @@
+export type ImComposerToolbarAction =
+  | { type: 'emit' }
+  | { type: 'open-file-picker'; accept: string; multiple?: boolean }
+
+export type ImComposerToolbarItemSpec = {
+  key: string
+  label: string
+  icon: string
+  disabled?: boolean
+  action?: ImComposerToolbarAction
+  buttonClass?: string
+}
+
+export type ImComposerMobileMoreItemSpec = {
+  key: string
+  label: string
+  icon: string
+}
+
+export type ImComposerToolbarOptions = {
+  /** 双人会话时显示语音/视频通话入口 */
+  showVoiceCall?: boolean
+}

package/types/im-contact.d.ts

@@ -0,0 +1,22 @@
+import type { ImAccountKind } from './im-account-kind'
+
+/** GET /im/contacts 联系人行（HTTP JSON snake_case） */
+export interface ImContact {
+  id: string
+  owner_id: string
+  /** 已注册用户 id */
+  peer_user_id: string
+  /** 对方手机号（冗余，来自 users.phone） */
+  peer_phone?: string | null
+  /** 本人备注名 */
+  display_name?: string | null
+  /** 对方 users 表展示名（GET /im/contacts 由服务端填充） */
+  peer_display_name?: string | null
+  /** 对方 users.account_kind（GET /im/contacts 由服务端填充） */
+  peer_account_kind?: ImAccountKind | null
+  /** 对方头像 URL（GET /im/contacts 由服务端填充） */
+  peer_avatar?: string | null
+  pinned?: boolean
+  created_at?: string
+  updated_at?: string
+}