zcw-shared 2.24.0 → 2.26.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/aiChatSuggestions.d.ts

@@ -0,0 +1,3 @@
+import type { AiChatSuggestionsPayload } from '../../types/ai-chat';
+export declare const AI_CHAT_WELCOME_SUGGESTIONS_MAX_NARROW = 4;
+export declare const AI_CHAT_SUGGESTIONS_SEED: AiChatSuggestionsPayload;

package/dist/constants/aiChatSuggestions.js

@@ -0,0 +1,52 @@
+export const AI_CHAT_WELCOME_SUGGESTIONS_MAX_NARROW = 4;
+export const AI_CHAT_SUGGESTIONS_SEED = {
+    title: '有什么我能帮你的吗？',
+    items: [
+        {
+            id: 'seed-news-1',
+            category: 'news',
+            text: '资讯：半导体设备 ETF 易方达半日净申购超 7000 万份',
+        },
+        {
+            id: 'seed-creative-1',
+            category: 'creative',
+            text: '设计一段 30 秒的简单女团舞片段',
+        },
+        {
+            id: 'seed-qa-1',
+            category: 'qa',
+            text: '每天睡够几小时才算睡眠充足？',
+        },
+        {
+            id: 'seed-qa-2',
+            category: 'qa',
+            text: 'CODEX 是什么类型的 AI 模型？',
+        },
+        {
+            id: 'seed-news-2',
+            category: 'news',
+            text: '资讯：存储芯片业绩向好带动富国 4 只科创 ETF 拉升',
+        },
+        {
+            id: 'seed-qa-3',
+            category: 'qa',
+            text: '如何使用实时翻译与外国朋友交流？',
+        },
+        {
+            id: 'seed-qa-4',
+            category: 'qa',
+            text: '为什么睡醒后感觉很累',
+        },
+        {
+            id: 'seed-creative-2',
+            category: 'creative',
+            text: '帮我规划 Roblox 小游戏开发步骤',
+        },
+        {
+            id: 'seed-news-3',
+            category: 'news',
+            text: '资讯：五部门禁止向未成年人提供虚拟亲密关系服务',
+        },
+    ],
+};
+//# sourceMappingURL=aiChatSuggestions.js.map

package/dist/constants/aiChatSuggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiChatSuggestions.js","sourceRoot":"","sources":["../../src/constants/aiChatSuggestions.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAA;AAGvD,MAAM,CAAC,MAAM,wBAAwB,GAA6B;IAChE,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE;QACL;YACE,EAAE,EAAE,aAAa;YACjB,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,gCAAgC;SACvC;QACD;YACE,EAAE,EAAE,iBAAiB;YACrB,QAAQ,EAAE,UAAU;YACpB,IAAI,EAAE,mBAAmB;SAC1B;QACD;YACE,EAAE,EAAE,WAAW;YACf,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,gBAAgB;SACvB;QACD;YACE,EAAE,EAAE,WAAW;YACf,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,qBAAqB;SAC5B;QACD;YACE,EAAE,EAAE,aAAa;YACjB,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,8BAA8B;SACrC;QACD;YACE,EAAE,EAAE,WAAW;YACf,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,kBAAkB;SACzB;QACD;YACE,EAAE,EAAE,WAAW;YACf,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,YAAY;SACnB;QACD;YACE,EAAE,EAAE,iBAAiB;YACrB,QAAQ,EAAE,UAAU;YACpB,IAAI,EAAE,qBAAqB;SAC5B;QACD;YACE,EAAE,EAAE,aAAa;YACjB,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,yBAAyB;SAChC;KACF;CACF,CAAA"}

package/dist/constants/chatCommunityMedia.d.ts

@@ -0,0 +1,2 @@
+export declare const CHAT_COMMUNITY_IMAGE_OSS_PREFIX = "chat/community/images";
+export declare const CHAT_COMMUNITY_VIDEO_COVER_OSS_PREFIX = "chat/community/covers";

package/dist/constants/chatCommunityMedia.js

@@ -0,0 +1,3 @@
+export const CHAT_COMMUNITY_IMAGE_OSS_PREFIX = 'chat/community/images';
+export const CHAT_COMMUNITY_VIDEO_COVER_OSS_PREFIX = 'chat/community/covers';
+//# sourceMappingURL=chatCommunityMedia.js.map

package/dist/constants/chatCommunityMedia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatCommunityMedia.js","sourceRoot":"","sources":["../../src/constants/chatCommunityMedia.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAAG,uBAAuB,CAAA;AACtE,MAAM,CAAC,MAAM,qCAAqC,GAAG,uBAAuB,CAAA"}

package/dist/constants/chatConversationBackground.d.ts

@@ -0,0 +1,10 @@
+export declare const CHAT_CONVERSATION_BG_DEFAULT_ID = "default";
+export declare const CHAT_CONVERSATION_BG_CUSTOM_PREFIX = "custom:";
+export declare const CHAT_CONVERSATION_BG_MAX_BYTES: number;
+export declare const CHAT_CONVERSATION_BG_MAX_SIDE_PX = 1440;
+export declare function chatConversationBackgroundBlobKey(conversationId: string): string;
+export declare function isCustomChatConversationBackground(value: string | undefined | null): boolean;
+export declare function resolveCustomChatBackgroundLayer(objectUrl: string): Record<string, string>;
+export declare function normalizeChatBackgroundPrefValue(value: string | undefined | null): string;
+export declare function parseCustomChatBackgroundBlobKey(backgroundId: string): string | null;
+export declare function buildCustomChatBackgroundPrefId(blobKey: string): string;

package/dist/constants/chatConversationBackground.js

@@ -0,0 +1,41 @@
+export const CHAT_CONVERSATION_BG_DEFAULT_ID = 'default';
+export const CHAT_CONVERSATION_BG_CUSTOM_PREFIX = 'custom:';
+export const CHAT_CONVERSATION_BG_MAX_BYTES = 512 * 1024;
+export const CHAT_CONVERSATION_BG_MAX_SIDE_PX = 1440;
+const LEGACY_PRESET_COLOR_IDS = new Set(['warm', 'cool', 'mint', 'lavender']);
+export function chatConversationBackgroundBlobKey(conversationId) {
+    return `chat-bg-${String(conversationId ?? '').trim()}`;
+}
+export function isCustomChatConversationBackground(value) {
+    const v = String(value ?? '').trim();
+    return v.startsWith(CHAT_CONVERSATION_BG_CUSTOM_PREFIX);
+}
+export function resolveCustomChatBackgroundLayer(objectUrl) {
+    return {
+        backgroundImage: `url("${objectUrl}")`,
+        backgroundSize: 'cover',
+        backgroundPosition: 'center center',
+        backgroundRepeat: 'no-repeat',
+    };
+}
+export function normalizeChatBackgroundPrefValue(value) {
+    const v = String(value ?? '').trim();
+    if (!v || v === CHAT_CONVERSATION_BG_DEFAULT_ID)
+        return CHAT_CONVERSATION_BG_DEFAULT_ID;
+    if (isCustomChatConversationBackground(v))
+        return v;
+    if (LEGACY_PRESET_COLOR_IDS.has(v))
+        return CHAT_CONVERSATION_BG_DEFAULT_ID;
+    return CHAT_CONVERSATION_BG_DEFAULT_ID;
+}
+export function parseCustomChatBackgroundBlobKey(backgroundId) {
+    const id = backgroundId.trim();
+    if (!id.startsWith(CHAT_CONVERSATION_BG_CUSTOM_PREFIX))
+        return null;
+    const key = id.slice(CHAT_CONVERSATION_BG_CUSTOM_PREFIX.length).trim();
+    return key || null;
+}
+export function buildCustomChatBackgroundPrefId(blobKey) {
+    return `${CHAT_CONVERSATION_BG_CUSTOM_PREFIX}${blobKey}`;
+}
+//# sourceMappingURL=chatConversationBackground.js.map

package/dist/constants/chatConversationBackground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatConversationBackground.js","sourceRoot":"","sources":["../../src/constants/chatConversationBackground.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,+BAA+B,GAAG,SAAS,CAAA;AAGxD,MAAM,CAAC,MAAM,kCAAkC,GAAG,SAAS,CAAA;AAG3D,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,GAAG,IAAI,CAAA;AAGxD,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAA;AAGpD,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;AAE7E,MAAM,UAAU,iCAAiC,CAAC,cAAsB;IACtE,OAAO,WAAW,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAA;AACzD,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAAgC;IACjF,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACpC,OAAO,CAAC,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAA;AACzD,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,SAAiB;IAChE,OAAO;QACL,eAAe,EAAE,QAAQ,SAAS,IAAI;QACtC,cAAc,EAAE,OAAO;QACvB,kBAAkB,EAAE,eAAe;QACnC,gBAAgB,EAAE,WAAW;KAC9B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,KAAgC;IAEhC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACpC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,+BAA+B;QAAE,OAAO,+BAA+B,CAAA;IACvF,IAAI,kCAAkC,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAA;IACnD,IAAI,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,+BAA+B,CAAA;IAC1E,OAAO,+BAA+B,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,YAAoB;IACnE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,CAAA;IAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,kCAAkC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnE,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,kCAAkC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;IACtE,OAAO,GAAG,IAAI,IAAI,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,OAAe;IAC7D,OAAO,GAAG,kCAAkC,GAAG,OAAO,EAAE,CAAA;AAC1D,CAAC"}

package/dist/constants/chatDownloadDirectory.d.ts

@@ -0,0 +1 @@
+export declare const CHAT_DOWNLOAD_DIRECTORY_PREF_STORAGE_KEY = "chat.download.defaultDirectory.v1";

package/dist/constants/chatDownloadDirectory.js

@@ -0,0 +1,2 @@
+export const CHAT_DOWNLOAD_DIRECTORY_PREF_STORAGE_KEY = 'chat.download.defaultDirectory.v1';
+//# sourceMappingURL=chatDownloadDirectory.js.map

package/dist/constants/chatDownloadDirectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatDownloadDirectory.js","sourceRoot":"","sources":["../../src/constants/chatDownloadDirectory.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,wCAAwC,GAAG,mCAAmC,CAAA"}

package/dist/constants/chatFileMessageLocalPath.d.ts

@@ -0,0 +1 @@
+export declare const CHAT_FILE_MESSAGE_LOCAL_PATH_STORAGE_KEY = "chat.im.fileDownload.localPath.v1";

package/dist/constants/chatFileMessageLocalPath.js

@@ -0,0 +1,2 @@
+export const CHAT_FILE_MESSAGE_LOCAL_PATH_STORAGE_KEY = 'chat.im.fileDownload.localPath.v1';
+//# sourceMappingURL=chatFileMessageLocalPath.js.map

package/dist/constants/chatFileMessageLocalPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatFileMessageLocalPath.js","sourceRoot":"","sources":["../../src/constants/chatFileMessageLocalPath.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,wCAAwC,GAAG,mCAAmC,CAAA"}

package/dist/constants/chatLayout.d.ts

@@ -0,0 +1,6 @@
+export declare const CHAT_ROOT_FONT_SIZE_MIN_PX = 1;
+export declare const CHAT_ROOT_FONT_SIZE_MAX_PX = 99;
+export declare const CHAT_ROOT_FONT_SIZE_DEFAULT_PX = 16;
+export declare const CHAT_ROOT_FONT_SIZE_STORAGE_KEY = "chat.rootFontSizePx.v1";
+export declare function clampChatRootFontSizePx(v: number): number;
+export declare function parseChatRootFontSizePxFromStorage(raw: string | null | undefined): number;

package/dist/constants/chatLayout.js

@@ -0,0 +1,14 @@
+export const CHAT_ROOT_FONT_SIZE_MIN_PX = 1;
+export const CHAT_ROOT_FONT_SIZE_MAX_PX = 99;
+export const CHAT_ROOT_FONT_SIZE_DEFAULT_PX = 16;
+export const CHAT_ROOT_FONT_SIZE_STORAGE_KEY = 'chat.rootFontSizePx.v1';
+export function clampChatRootFontSizePx(v) {
+    if (!Number.isFinite(v))
+        return CHAT_ROOT_FONT_SIZE_DEFAULT_PX;
+    return Math.min(CHAT_ROOT_FONT_SIZE_MAX_PX, Math.max(CHAT_ROOT_FONT_SIZE_MIN_PX, Math.round(v)));
+}
+export function parseChatRootFontSizePxFromStorage(raw) {
+    const parsed = Number(raw?.trim());
+    return Number.isFinite(parsed) ? clampChatRootFontSizePx(parsed) : CHAT_ROOT_FONT_SIZE_DEFAULT_PX;
+}
+//# sourceMappingURL=chatLayout.js.map

package/dist/constants/chatLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatLayout.js","sourceRoot":"","sources":["../../src/constants/chatLayout.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAA;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAA;AAC5C,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAA;AAEhD,MAAM,CAAC,MAAM,+BAA+B,GAAG,wBAAwB,CAAA;AAEvE,MAAM,UAAU,uBAAuB,CAAC,CAAS;IAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,8BAA8B,CAAA;IAC9D,OAAO,IAAI,CAAC,GAAG,CACb,0BAA0B,EAC1B,IAAI,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACpD,CAAA;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,GAA8B;IAC/E,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;IAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAA;AACnG,CAAC"}

package/dist/constants/imStorage.d.ts

@@ -0,0 +1 @@
+export declare const IM_STORAGE_BUCKET_DEFAULT = "im-uploads";

package/dist/constants/imStorage.js

@@ -0,0 +1,2 @@
+export const IM_STORAGE_BUCKET_DEFAULT = 'im-uploads';
+//# sourceMappingURL=imStorage.js.map

package/dist/constants/imStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imStorage.js","sourceRoot":"","sources":["../../src/constants/imStorage.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAA"}

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

@@ -0,0 +1,16 @@
+export declare function truncateAgentToolPreview(value: unknown, max?: number): string;
+export type AiReplyToolStartPayload = {
+    conversationId: string;
+    runId: string;
+    toolCallId: string;
+    toolName: string;
+    argumentsPreview?: string;
+};
+export type AiReplyToolDonePayload = {
+    conversationId: string;
+    runId: string;
+    toolCallId: string;
+    ok?: boolean;
+    resultPreview?: string;
+    error?: string;
+};

package/dist/functions/ai/aiAgentToolTimeline.js

@@ -0,0 +1,18 @@
+const PREVIEW_MAX = 1200;
+export function truncateAgentToolPreview(value, max = PREVIEW_MAX) {
+    const s = typeof value === 'string'
+        ? value
+        : (() => {
+            try {
+                return JSON.stringify(value ?? {});
+            }
+            catch {
+                return String(value ?? '');
+            }
+        })();
+    const t = s.trim();
+    if (t.length <= max)
+        return t;
+    return `${t.slice(0, max)}…`;
+}
+//# sourceMappingURL=aiAgentToolTimeline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aiAgentToolTimeline.js","sourceRoot":"","sources":["../../../src/functions/ai/aiAgentToolTimeline.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,IAAI,CAAA;AAExB,MAAM,UAAU,wBAAwB,CAAC,KAAc,EAAE,GAAG,GAAG,WAAW;IACxE,MAAM,CAAC,GACL,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,CAAC,GAAG,EAAE;YACJ,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;YAC5B,CAAC;QACH,CAAC,CAAC,EAAE,CAAA;IACV,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IAClB,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAA;AAC9B,CAAC"}

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

@@ -0,0 +1,4 @@
+export declare function resolveAiChatSessionIdFromListContextTarget(target: unknown): string | null;
+export declare function resolveAiChatSessionFromListById<T extends {
+    id: string;
+}>(sessions: readonly T[], sessionId: string): T | null;

package/dist/functions/ai/aiChatSessionListDom.js

@@ -0,0 +1,32 @@
+const SESSION_ROW_SELECTOR = '[data-ai-chat-session-id]';
+const SESSION_ID_ATTR = 'data-ai-chat-session-id';
+function asDomLike(target) {
+    if (!target || typeof target !== 'object')
+        return null;
+    const el = target;
+    if (typeof el.closest !== 'function')
+        return null;
+    return el;
+}
+export function resolveAiChatSessionIdFromListContextTarget(target) {
+    const t = asDomLike(target);
+    if (!t)
+        return null;
+    const row = t.closest(SESSION_ROW_SELECTOR);
+    if (!row)
+        return null;
+    const fromDataset = row.dataset?.aiChatSessionId?.trim();
+    if (fromDataset)
+        return fromDataset;
+    const fromAttr = typeof row.getAttribute === 'function'
+        ? row.getAttribute(SESSION_ID_ATTR)?.trim()
+        : null;
+    return fromAttr && fromAttr.length > 0 ? fromAttr : null;
+}
+export function resolveAiChatSessionFromListById(sessions, sessionId) {
+    const id = sessionId.trim();
+    if (!id)
+        return null;
+    return sessions.find((s) => s.id === id) ?? null;
+}
+//# sourceMappingURL=aiChatSessionListDom.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aiChatSessionListDom.js","sourceRoot":"","sources":["../../../src/functions/ai/aiChatSessionListDom.ts"],"names":[],"mappings":"AAMA,MAAM,oBAAoB,GAAG,2BAA2B,CAAA;AACxD,MAAM,eAAe,GAAG,yBAAyB,CAAA;AAEjD,SAAS,SAAS,CAAC,MAAe;IAChC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IACtD,MAAM,EAAE,GAAG,MAA0B,CAAA;IACrC,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,UAAU;QAAE,OAAO,IAAI,CAAA;IACjD,OAAO,EAAa,CAAA;AACtB,CAAC;AAGD,MAAM,UAAU,2CAA2C,CACzD,MAAe;IAEf,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;IAC3B,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAA;IACxD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAA;IACnC,MAAM,QAAQ,GACZ,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU;QACpC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE;QAC3C,CAAC,CAAC,IAAI,CAAA;IACV,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,gCAAgC,CAE9C,QAAsB,EAAE,SAAiB;IACzC,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAA;IACpB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAA;AAClD,CAAC"}

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

@@ -0,0 +1,25 @@
+export declare const AI_CHAT_DEFAULT_SESSION_TITLE = "\u65B0\u5BF9\u8BDD";
+export declare function defaultAiChatTemperatureForModel(model?: {
+    capabilities?: {
+        parameters?: {
+            temperature?: {
+                default?: number;
+            };
+        };
+    };
+}): number;
+export declare function titleFromAiChatFirstMessage(content: string): string;
+export declare function isPlaceholderAiChatSessionTitle(title: string | null | undefined): boolean;
+export declare function firstAiChatUserMessageTitle(messagesList: readonly {
+    role: string;
+    content?: string;
+}[]): string | null;
+export declare function mapAiChatSessionFromSseRecord(raw: Record<string, unknown>): {
+    id: string;
+    user_id: string;
+    title: string;
+    model_id: string | null;
+    created_at: string;
+    updated_at: string;
+    last_message_at: string;
+};

package/dist/functions/ai/aiChatSessionOps.js

@@ -0,0 +1,36 @@
+import { normalizeAiChatSessionTitlePlainText } from '../im/imAiChatSessionTitle.js';
+export const AI_CHAT_DEFAULT_SESSION_TITLE = '新对话';
+export function defaultAiChatTemperatureForModel(model) {
+    const spec = model?.capabilities?.parameters?.temperature;
+    if (spec?.default != null && Number.isFinite(spec.default))
+        return spec.default;
+    return 0.7;
+}
+export function titleFromAiChatFirstMessage(content) {
+    const t = normalizeAiChatSessionTitlePlainText(content);
+    if (!t)
+        return AI_CHAT_DEFAULT_SESSION_TITLE;
+    return t.length > 80 ? `${t.slice(0, 80)}…` : t;
+}
+export function isPlaceholderAiChatSessionTitle(title) {
+    const t = title?.trim();
+    return !t || t === AI_CHAT_DEFAULT_SESSION_TITLE;
+}
+export function firstAiChatUserMessageTitle(messagesList) {
+    const content = messagesList.find((m) => m.role === 'user')?.content?.trim();
+    if (!content)
+        return null;
+    return titleFromAiChatFirstMessage(content);
+}
+export function mapAiChatSessionFromSseRecord(raw) {
+    return {
+        id: String(raw.id ?? ''),
+        user_id: String(raw.user_id ?? ''),
+        title: String(raw.title ?? AI_CHAT_DEFAULT_SESSION_TITLE),
+        model_id: raw.model_id != null && raw.model_id !== '' ? String(raw.model_id) : null,
+        created_at: String(raw.created_at ?? ''),
+        updated_at: String(raw.updated_at ?? ''),
+        last_message_at: String(raw.last_message_at ?? ''),
+    };
+}
+//# sourceMappingURL=aiChatSessionOps.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aiChatSessionOps.js","sourceRoot":"","sources":["../../../src/functions/ai/aiChatSessionOps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,MAAM,4BAA4B,CAAA;AAEjF,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAA;AAElD,MAAM,UAAU,gCAAgC,CAAC,KAEhD;IACC,MAAM,IAAI,GAAG,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,CAAA;IACzD,IAAI,IAAI,EAAE,OAAO,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAA;IAC/E,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAe;IACzD,MAAM,CAAC,GAAG,oCAAoC,CAAC,OAAO,CAAC,CAAA;IACvD,IAAI,CAAC,CAAC;QAAE,OAAO,6BAA6B,CAAA;IAC5C,OAAO,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAgC;IAEhC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,CAAA;IACvB,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,6BAA6B,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,YAA2D;IAE3D,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC5E,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACzB,OAAO,2BAA2B,CAAC,OAAO,CAAC,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,GAA4B;IASxE,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QAClC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,6BAA6B,CAAC;QACzD,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,IAAI,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;QACnF,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QACxC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QACxC,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;KACnD,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,14 @@
+export declare const AI_CHAT_PINNED_SESSION_IDS_STORAGE_KEY = "ai-chat-pinned-session-ids";
+export declare function parseAiChatPinnedSessionIdsFromStorage(raw: string | null | undefined): Set<string>;
+export declare function serializeAiChatPinnedSessionIdsForStorage(ids: ReadonlySet<string>): string;
+export declare function sortAiChatSessionsByPin<T extends {
+    id: string;
+    last_message_at?: string;
+    updated_at?: string;
+}>(sessions: T[], pinnedIds: ReadonlySet<string>): T[];
+export declare function loadAiChatPinnedSessionIdsFromBrowserStorage(storage: {
+    getItem(key: string): string | null;
+} | null | undefined): Set<string>;
+export declare function saveAiChatPinnedSessionIdsToBrowserStorage(storage: {
+    setItem(key: string, value: string): void;
+} | null | undefined, ids: ReadonlySet<string>): void;

package/dist/functions/ai/aiChatSessionPins.js

@@ -0,0 +1,39 @@
+export const AI_CHAT_PINNED_SESSION_IDS_STORAGE_KEY = 'ai-chat-pinned-session-ids';
+export function parseAiChatPinnedSessionIdsFromStorage(raw) {
+    if (!raw)
+        return new Set();
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return new Set();
+        return new Set(parsed.map((id) => String(id)).filter(Boolean));
+    }
+    catch {
+        return new Set();
+    }
+}
+export function serializeAiChatPinnedSessionIdsForStorage(ids) {
+    return JSON.stringify([...ids]);
+}
+export function sortAiChatSessionsByPin(sessions, pinnedIds) {
+    return [...sessions].sort((a, b) => {
+        const ap = pinnedIds.has(a.id) ? 1 : 0;
+        const bp = pinnedIds.has(b.id) ? 1 : 0;
+        if (ap !== bp)
+            return bp - ap;
+        const at = new Date(a.last_message_at || a.updated_at || 0).getTime();
+        const bt = new Date(b.last_message_at || b.updated_at || 0).getTime();
+        return bt - at;
+    });
+}
+export function loadAiChatPinnedSessionIdsFromBrowserStorage(storage) {
+    if (!storage)
+        return new Set();
+    return parseAiChatPinnedSessionIdsFromStorage(storage.getItem(AI_CHAT_PINNED_SESSION_IDS_STORAGE_KEY));
+}
+export function saveAiChatPinnedSessionIdsToBrowserStorage(storage, ids) {
+    if (!storage)
+        return;
+    storage.setItem(AI_CHAT_PINNED_SESSION_IDS_STORAGE_KEY, serializeAiChatPinnedSessionIdsForStorage(ids));
+}
+//# sourceMappingURL=aiChatSessionPins.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aiChatSessionPins.js","sourceRoot":"","sources":["../../../src/functions/ai/aiChatSessionPins.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sCAAsC,GAAG,4BAA4B,CAAA;AAElF,MAAM,UAAU,sCAAsC,CACpD,GAA8B;IAE9B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,GAAG,EAAE,CAAA;IAC1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAA;QACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,GAAG,EAAE,CAAA;QAC5C,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yCAAyC,CAAC,GAAwB;IAChF,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAErC,QAAa,EAAE,SAA8B;IAC7C,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACtC,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACtC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAA;QAC7B,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;QACrE,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;QACrE,OAAO,EAAE,GAAG,EAAE,CAAA;IAChB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,4CAA4C,CAC1D,OAAmE;IAEnE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,GAAG,EAAE,CAAA;IAC9B,OAAO,sCAAsC,CAC3C,OAAO,CAAC,OAAO,CAAC,sCAAsC,CAAC,CACxD,CAAA;AACH,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,OAAyE,EACzE,GAAwB;IAExB,IAAI,CAAC,OAAO;QAAE,OAAM;IACpB,OAAO,CAAC,OAAO,CACb,sCAAsC,EACtC,yCAAyC,CAAC,GAAG,CAAC,CAC/C,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { AgentToolStep, ChatMessage } from '../../../types/im-chat';
+import type { ImFormattedDisplayBlock, ImMessageDisplaySpecV2 } from '../../../types/im-message-display';
+import { type AiReplyToolDonePayload, type AiReplyToolStartPayload } from './aiAgentToolTimeline';
+export declare const IM_AGENT_TOOL_BLOCK_TYPE = "im.agent_tool";
+export declare const IM_MARKDOWN_BLOCK_TYPE = "im.markdown";
+export type AiReplyStreamDisplayState = {
+    blocks: ImFormattedDisplayBlock[];
+};
+export declare function agentToolStepToBlockProps(step: AgentToolStep): Record<string, unknown>;
+export declare function agentToolStepFromBlockProps(props: Record<string, unknown>): AgentToolStep | null;
+export declare function aggregateMarkdownFromBlocks(blocks: readonly ImFormattedDisplayBlock[]): string;
+export declare function buildDisplaySpecFromBlocks(blocks: readonly ImFormattedDisplayBlock[]): ImMessageDisplaySpecV2 | undefined;
+export declare function createAiReplyStreamDisplayState(): {
+    byRunId: Map<string, AiReplyStreamDisplayState>;
+    clearRun: (runId: string) => void;
+    getBlocks: (runId: string) => ImFormattedDisplayBlock[];
+    getDisplaySpec: (runId: string) => ImMessageDisplaySpecV2 | undefined;
+    getAggregateContent: (runId: string) => string;
+    appendDelta: (runId: string, delta: string) => void;
+    onToolStart: (p: AiReplyToolStartPayload) => void;
+    onToolDone: (p: AiReplyToolDonePayload) => void;
+};
+export type AiReplyStreamDisplayApi = Pick<ReturnType<typeof createAiReplyStreamDisplayState>, 'getDisplaySpec' | 'getAggregateContent'>;
+export declare function computePatchedAiStreamBubbleDisplay(messages: readonly ChatMessage[], runId: string, state: AiReplyStreamDisplayApi): {
+    next: ChatMessage[];
+    changed: boolean;
+};