@baique/pi-web-sky 0.1.55 → 0.1.57

package/lib/chat-lazy-load.test.mjs

@@ -76,65 +76,3 @@ test("treats only the real message tail as live-follow attached", async () => {
   assert.equal(getLiveFollowAttached(false, 400, 400, 600, 1096), false);
   assert.equal(getLiveFollowAttached(false, 391, 392, 600, 1000), true);
 });
-
-test("prompt anchor spacer uses the rendered content end", async () => {
-  const { getPromptAnchorSpacerHeight } = await loadSubject();
-  const initial = getPromptAnchorSpacerHeight(400, 700, 600);
-  const afterRender = getPromptAnchorSpacerHeight(400, 700, 600);
-
-  assert.equal(initial, 300);
-  assert.equal(afterRender, initial);
-});
-
-test("prompt anchor spacer includes the viewport deficit for short conversations", async () => {
-  const { getPromptAnchorSpacerHeight } = await loadSubject();
-  const targetTop = 168;
-  const clientHeight = 579;
-
-  let contentHeight = 411;
-  let spacerHeight = getPromptAnchorSpacerHeight(targetTop, contentHeight, clientHeight);
-  assert.equal(spacerHeight, 336);
-  assert.equal(contentHeight + spacerHeight - clientHeight, targetTop);
-
-  contentHeight += 24;
-  spacerHeight = getPromptAnchorSpacerHeight(targetTop, contentHeight, clientHeight);
-  assert.equal(spacerHeight, 312);
-  assert.equal(contentHeight + spacerHeight - clientHeight, targetTop);
-});
-
-test("prompt anchor spacer clamps at zero once content can reach the target", async () => {
-  const { getPromptAnchorSpacerHeight } = await loadSubject();
-  assert.equal(getPromptAnchorSpacerHeight(100, 750, 600), 0);
-  assert.equal(getPromptAnchorSpacerHeight(-20, 200, 600), 0);
-});
-
-test("prompt anchor spacer rounds fractional layout measurements up", async () => {
-  const { getPromptAnchorSpacerHeight } = await loadSubject();
-  assert.equal(getPromptAnchorSpacerHeight(400.25, 700, 600), 301);
-});
-
-test("streaming content consumes the prompt anchor before advancing the tail", async () => {
-  const { getPromptAnchorSpacerHeight } = await loadSubject();
-  const targetTop = 400;
-  const clientHeight = 600;
-
-  let contentHeight = 700;
-  let spacerHeight = getPromptAnchorSpacerHeight(targetTop, contentHeight, clientHeight);
-  assert.equal(spacerHeight, 300);
-  assert.equal(contentHeight + spacerHeight - clientHeight, targetTop);
-
-  contentHeight += 120;
-  spacerHeight = getPromptAnchorSpacerHeight(targetTop, contentHeight, clientHeight);
-  assert.equal(spacerHeight, 180);
-  assert.equal(contentHeight + spacerHeight - clientHeight, targetTop);
-
-  contentHeight += 180;
-  spacerHeight = getPromptAnchorSpacerHeight(targetTop, contentHeight, clientHeight);
-  assert.equal(spacerHeight, 0);
-  assert.equal(contentHeight - clientHeight, targetTop);
-
-  contentHeight += 40;
-  spacerHeight = getPromptAnchorSpacerHeight(targetTop, contentHeight, clientHeight);
-  assert.equal(spacerHeight, 0);
-  assert.equal(contentHeight - clientHeight, targetTop + 40);
-});

package/lib/chat-lazy-load.ts

@@ -49,16 +49,3 @@ export function getLiveFollowAttached(
   ) return true;
   return wasAttached;
 }
-
-export function getPromptAnchorSpacerHeight(
-  targetTop: number,
-  contentEnd: number,
-  clientHeight: number,
-): number {
-  const clampedTargetTop = Math.max(0, targetTop);
-  if (clampedTargetTop === 0) return 0;
-
-  return Math.max(0, Math.ceil(
-    clampedTargetTop + clientHeight - Math.max(0, contentEnd),
-  ));
-}

package/lib/chat-only.ts

@@ -0,0 +1,23 @@
+export interface ContextFileContent {
+  path: string;
+  content: string;
+}
+
+export const CHAT_ONLY_RESOURCE_LOADER_OPTIONS = {
+  noExtensions: true,
+  noSkills: true,
+  noPromptTemplates: true,
+  noThemes: true,
+  noContextFiles: false,
+  // Truthy placeholders prevent the loader from discovering configured prompt
+  // files. The overrides ensure neither placeholder participates in the prompt.
+  systemPrompt: " ",
+  appendSystemPrompt: [" "],
+  systemPromptOverride: () => undefined,
+  appendSystemPromptOverride: () => [],
+};
+
+/** Preserve Pi's discovery order and include only the context-file contents. */
+export function contextFilesSystemPrompt(files: readonly ContextFileContent[]): string {
+  return files.map((file) => file.content).join("\n\n");
+}

package/lib/draft-stash.ts

@@ -2,6 +2,8 @@
 // 跨会话、浏览器全局存在；内容只增不自动删，删除仅靠手动。
 // 与 lib/draft-store.ts（会话级单条输入框草稿）完全独立，互不干扰。
 
+import { newId } from "./id";
+
 export interface DraftItem {
   id: string;
   content: string;
@@ -24,12 +26,9 @@ function isDraftItem(value: unknown): value is DraftItem {
   );
 }
 
-/** 生成草稿 id（优先 crypto.randomUUID，退化到时间戳+随机） */
+/** 生成草稿 id（统一走 lib/id 的兜底实现，安全上下文外也能用） */
 export function newDraftId(): string {
-  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-    return crypto.randomUUID();
-  }
-  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  return newId();
 }
 
 /** 读取全部草稿，按最近活动（updatedAt）降序；存储缺失/损坏时返回空数组 */

package/lib/file-types.ts

@@ -26,7 +26,14 @@ export const AUDIO_EXT_TO_MIME: Record<string, string> = {
   aac: "audio/aac",
   flac: "audio/flac",
   weba: "audio/webm",
-  webm: "audio/webm",
+};
+
+export const VIDEO_EXT_TO_MIME: Record<string, string> = {
+  mp4: "video/mp4",
+  m4v: "video/mp4",
+  webm: "video/webm",
+  mov: "video/quicktime",
+  ogv: "video/ogg",
 };
 
 export const DOCUMENT_EXT_TO_MIME: Record<DocumentPreviewKind, string> = {
@@ -50,6 +57,10 @@ export function getAudioMime(filePath: string): string | null {
   return AUDIO_EXT_TO_MIME[getFileExt(filePath)] ?? null;
 }
 
+export function getVideoMime(filePath: string): string | null {
+  return VIDEO_EXT_TO_MIME[getFileExt(filePath)] ?? null;
+}
+
 export function getDocumentMime(filePath: string): string | null {
   return DOCUMENT_EXT_TO_MIME[getFileExt(filePath) as DocumentPreviewKind] ?? null;
 }
@@ -68,6 +79,10 @@ export function isAudioPath(filePath: string): boolean {
   return getAudioMime(filePath) !== null;
 }
 
+export function isVideoPath(filePath: string): boolean {
+  return getVideoMime(filePath) !== null;
+}
+
 export function isDocumentPreviewPath(filePath: string): boolean {
   return documentPreviewKind(filePath) !== null;
 }

package/lib/i18n/messages/en.ts

@@ -10,6 +10,8 @@ export const enLocale: LocalePlugin = {
     "common.models": "Models",
     "common.skills": "Skills",
     "common.plugins": "Plugins",
+    "common.settings": "Settings",
+    "common.agents": "Agents",
     "appUpdate.releaseNotes": "Pi Web v{version} is available. View release notes",
     "sidebar.hide": "Hide sidebar",
     "sidebar.show": "Show sidebar",
@@ -146,6 +148,11 @@ export const enLocale: LocalePlugin = {
     "sidebar.filesTab": "Files",
     "sidebar.tasks": "Tasks",
     "sidebar.tempSessions": "Chat",
+    "sidebar.timeToday": "Today",
+    "sidebar.timeYesterday": "Yesterday",
+    "sidebar.timeThisWeek": "This week",
+    "sidebar.timeThisMonth": "Last 30 days",
+    "sidebar.timeOlder": "Older",
     "sidebar.newTask": "New task…",
     "sidebar.taskName": "Task name",
     "sidebar.newTaskSession": "New task session",
@@ -300,6 +307,17 @@ export const enLocale: LocalePlugin = {
     "chat.steer": "Steer",
     "chat.followUp": "Follow-up",
     "chat.send": "Send",
+    "chat.askSelection": "Ask about selected text",
+    "chat.askInCurrent": "Ask here",
+    "chat.askInNewChat": "Ask in new chat",
+    "chat.newQuoteChat": "New chat about selected text",
+    "chat.quoteIntro": "About this passage:",
+    "chat.quoteQuestion": "My question:",
+    "chat.quoteForkFailed": "Failed to create quoted chat",
+    "chat.quoteSelectionToggle": "Show an ask menu after selecting text",
+    "chat.sendQuestion": "Send question",
+    "chat.imageNotSupportedTitle": "The selected model does not support images",
+    "chat.imageNotSupportedBody": "Model {model} accepts text input only; attached images will not be sent. Switch to a vision-capable model or remove the attachments.",
     "chat.attachImage": "Attach image",
     "chat.previewImage": "Preview image",
     "chat.filterModels": "Filter models…",
@@ -360,6 +378,79 @@ export const enLocale: LocalePlugin = {
     "chat.commandCopy": "Copy the last assistant message",
     "chat.compacted": "Compacted",
     "chat.tokensSaved": "{saved} saved",
+    "settings.chatContentWidth": "Chat content width",
+    "settings.chatContentWidthDescription": "Set the maximum width of message content and the input box.",
+    "settings.chatContentFontSize": "Chat font size",
+    "settings.preferences": "Preferences",
+    "settings.title": "Settings",
+    "settings.general": "General",
+    "settings.appearance": "Appearance",
+    "settings.chat": "Chat",
+    "settings.quoteSelection": "Ask about selected text",
+    "settings.resetChatContentWidth": "Reset chat width",
+    "settings.resetChatContentFontSize": "Reset chat font size",
+    "settings.projectRequired": "Project required",
+    "settings.themeLight": "Light",
+    "settings.themeDark": "Dark",
+    "tools.title": "Tools enabled in the current session",
+    "tools.details": "Tool definition details",
+    "tools.load": "Tool definitions have not loaded yet",
+    "tools.loading": "Loading tool definitions…",
+    "tools.noTools": "No active tools",
+    "tools.description": "Description",
+    "tools.parameters": "Parameters",
+    "tools.parameterCount": "{count} parameters",
+    "tools.noParameters": "No parameters",
+    "tools.required": "Required",
+    "tools.optional": "Optional",
+    "tools.allowedValues": "Allowed",
+    "tools.defaultValue": "Default",
+    "tools.guidelines": "Prompt guidelines",
+
+    "tools.label": "Tools",
+    "agents.close": "Close",
+    "agents.builtInTitle": "Enable Pi Web built-in sub-agents",
+    "agents.builtInDescription": "Provides Pi Web's integrated Agent tools and disables a conflicting pi-subagents extension.",
+    "agents.reloadRequired": "Reload the current session to apply this change.",
+    "agents.reloadSession": "Reload session",
+    "agents.maxConcurrent": "Concurrent sub-agents",
+    "agents.maxConcurrentDescription": "Maximum prompts running at once per parent session.",
+    "agents.reloading": "Reloading...",
+    "agents.loading": "Loading sub-agents...",
+    "agents.new": "New sub-agent",
+    "agents.empty": "Select or create a sub-agent profile",
+    "agents.saveScope": "Save to",
+    "agents.name": "Sub-agent ID",
+    "agents.displayName": "Display name",
+    "agents.description": "Description",
+    "agents.prompt": "System instructions",
+    "agents.tools": "Tools",
+    "agents.resources": "Resources",
+    "agents.loadSkills": "Load skills",
+    "agents.loadExtensions": "Load extensions",
+    "agents.model": "Model override",
+    "agents.modelsLoading": "Loading models...",
+    "agents.modelUnavailable": "{model} (unavailable)",
+    "agents.thinking": "Thinking",
+    "agents.maxTurns": "Max turns",
+    "agents.inherit": "Parent default",
+    "agents.enable": "Enable sub-agent",
+    "agents.disable": "Disable sub-agent",
+    "agents.builtinPath": "Built-in profile",
+    "agents.inheritContext": "Inherit parent context",
+    "agents.background": "Run in background by default",
+    "agents.duplicate": "Duplicate",
+    "agents.copyName": "{name} copy",
+    "agents.delete": "Delete",
+    "agents.deleteConfirm": "Delete {name}?",
+    "agents.save": "Save",
+    "agents.saving": "Saving...",
+    "agents.scope.builtin": "built-in",
+    "agents.scope.global": "global",
+    "agents.scope.workspace": "workspace",
+    "agents.scope.project": "project",
+    "agents.overridden": "Overridden",
+
     "i18n.close": "Close",
     "i18n.copy": "Copy",
     "i18n.pin": "Pin",

package/lib/i18n/messages/zh-CN.ts

@@ -11,6 +11,8 @@ export const zhCNLocale: LocalePlugin = {
     "common.models": "模型",
     "common.skills": "技能",
     "common.plugins": "插件",
+    "common.settings": "设置",
+    "common.agents": "代理",
     "appUpdate.releaseNotes": "Pi Web v{version} 可用，查看更新说明",
     "sidebar.hide": "隐藏侧边栏",
     "sidebar.show": "显示侧边栏",
@@ -147,6 +149,11 @@ export const zhCNLocale: LocalePlugin = {
     "sidebar.filesTab": "文件",
     "sidebar.tasks": "任务",
     "sidebar.tempSessions": "聊天",
+    "sidebar.timeToday": "今天",
+    "sidebar.timeYesterday": "昨天",
+    "sidebar.timeThisWeek": "本周",
+    "sidebar.timeThisMonth": "近一月",
+    "sidebar.timeOlder": "更久之前",
     "sidebar.newTask": "新建任务…",
     "sidebar.taskName": "任务名称",
     "sidebar.newTaskSession": "新建任务会话",
@@ -301,6 +308,17 @@ export const zhCNLocale: LocalePlugin = {
     "chat.steer": "引导",
     "chat.followUp": "后续消息",
     "chat.send": "发送",
+    "chat.askSelection": "询问选中的文字",
+    "chat.askInCurrent": "在当前对话询问",
+    "chat.askInNewChat": "在新对话询问",
+    "chat.newQuoteChat": "关于选中文字的新对话",
+    "chat.quoteIntro": "关于这段内容：",
+    "chat.quoteQuestion": "我的问题是：",
+    "chat.quoteForkFailed": "无法创建引用对话",
+    "chat.quoteSelectionToggle": "选中文字后显示询问菜单",
+    "chat.sendQuestion": "发送问题",
+    "chat.imageNotSupportedTitle": "当前模型不支持图片",
+    "chat.imageNotSupportedBody": "模型 {model} 的输入只支持文本，图片不会被发送。请更换支持图片的模型或移除附件。",
     "chat.attachImage": "附加图片",
     "chat.previewImage": "预览图片",
     "chat.filterModels": "筛选模型…",
@@ -361,6 +379,79 @@ export const zhCNLocale: LocalePlugin = {
     "chat.commandCopy": "复制最后一条助手消息",
     "chat.compacted": "已压缩",
     "chat.tokensSaved": "节省 {saved}",
+    "settings.chatContentWidth": "聊天内容宽度",
+    "settings.chatContentWidthDescription": "设置消息内容和输入框的最大宽度。",
+    "settings.chatContentFontSize": "聊天字体大小",
+    "settings.preferences": "偏好",
+    "settings.title": "设置",
+    "settings.general": "通用",
+    "settings.appearance": "外观",
+    "settings.chat": "聊天",
+    "settings.quoteSelection": "选中文字后询问",
+    "settings.resetChatContentWidth": "重置聊天宽度",
+    "settings.resetChatContentFontSize": "重置聊天字号",
+    "settings.projectRequired": "需要项目",
+    "settings.themeLight": "浅色",
+    "settings.themeDark": "深色",
+    "tools.title": "当前会话启用的工具",
+    "tools.details": "工具定义详情",
+    "tools.load": "工具定义尚未加载",
+    "tools.loading": "正在加载工具定义…",
+    "tools.noTools": "没有启用的工具",
+    "tools.description": "描述",
+    "tools.parameters": "参数",
+    "tools.parameterCount": "{count} 个参数",
+    "tools.noParameters": "无参数",
+    "tools.required": "必填",
+    "tools.optional": "可选",
+    "tools.allowedValues": "可选值",
+    "tools.defaultValue": "默认值",
+    "tools.guidelines": "提示词规则",
+
+    "tools.label": "工具",
+    "agents.close": "关闭",
+    "agents.builtInTitle": "启用 Pi Web 内置子代理",
+    "agents.builtInDescription": "提供 Pi Web 集成的 Agent 工具，并停用发生冲突的 pi-subagents 扩展。",
+    "agents.reloadRequired": "重新加载当前会话后生效。",
+    "agents.reloadSession": "重新加载会话",
+    "agents.maxConcurrent": "并发子代理数",
+    "agents.maxConcurrentDescription": "每个父会话同时运行的最大任务数。",
+    "agents.reloading": "正在重新加载...",
+    "agents.loading": "正在加载子代理...",
+    "agents.new": "新建子代理",
+    "agents.empty": "选择或创建一个子代理配置",
+    "agents.saveScope": "保存到",
+    "agents.name": "子代理 ID",
+    "agents.displayName": "显示名称",
+    "agents.description": "描述",
+    "agents.prompt": "系统指令",
+    "agents.tools": "工具",
+    "agents.resources": "资源",
+    "agents.loadSkills": "加载技能",
+    "agents.loadExtensions": "加载扩展",
+    "agents.model": "指定模型",
+    "agents.modelsLoading": "正在加载模型...",
+    "agents.modelUnavailable": "{model}（不可用）",
+    "agents.thinking": "思考级别",
+    "agents.maxTurns": "最大轮次",
+    "agents.inherit": "跟随父会话",
+    "agents.enable": "启用子代理",
+    "agents.disable": "停用子代理",
+    "agents.builtinPath": "内置配置",
+    "agents.inheritContext": "继承父会话上下文",
+    "agents.background": "默认在后台运行",
+    "agents.duplicate": "创建副本",
+    "agents.copyName": "{name} 副本",
+    "agents.delete": "删除",
+    "agents.deleteConfirm": "删除 {name}？",
+    "agents.save": "保存",
+    "agents.saving": "正在保存...",
+    "agents.scope.builtin": "内置",
+    "agents.scope.global": "全局",
+    "agents.scope.workspace": "工作区",
+    "agents.scope.project": "项目",
+    "agents.overridden": "被覆盖",
+
     "i18n.close": "关闭",
     "i18n.copy": "复制",
     "i18n.pin": "钉",

package/lib/id.test.mjs

@@ -0,0 +1,38 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { createJiti } from "jiti";
+
+const jiti = createJiti(import.meta.url, { tsconfigPaths: true });
+const { newId } = await jiti.import("./id.ts");
+
+// 服务端 /api/agent/new 的会话 id 校验（SESSION_ID_RE）：兜底 id 必须也能当会话 id 用
+const SESSION_ID_RE = /^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/;
+
+const realCrypto = globalThis.crypto;
+
+test.afterEach(() => {
+  Object.defineProperty(globalThis, "crypto", { value: realCrypto, configurable: true, writable: true });
+});
+
+test("prefers crypto.randomUUID when the secure-context API exists", () => {
+  Object.defineProperty(globalThis, "crypto", { value: { randomUUID: () => "0b6f2f2e-1111-2222-3333-444455556666" }, configurable: true, writable: true });
+  assert.equal(newId(), "0b6f2f2e-1111-2222-3333-444455556666");
+});
+
+test("falls back on insecure origins where randomUUID is missing", () => {
+  // http://<LAN-IP>:30143 → crypto 在、randomUUID 不在（裸调会 TypeError）
+  Object.defineProperty(globalThis, "crypto", { value: { getRandomValues: (a) => a }, configurable: true, writable: true });
+  const id = newId();
+  assert.match(id, SESSION_ID_RE, `fallback id must be a valid session id, got ${id}`);
+});
+
+test("falls back when crypto itself is unavailable", () => {
+  Object.defineProperty(globalThis, "crypto", { value: undefined, configurable: true, writable: true });
+  assert.match(newId(), SESSION_ID_RE);
+});
+
+test("fallback ids stay unique across rapid calls", () => {
+  Object.defineProperty(globalThis, "crypto", { value: {}, configurable: true, writable: true });
+  const ids = new Set(Array.from({ length: 200 }, () => newId()));
+  assert.equal(ids.size, 200);
+});

package/lib/id.ts

@@ -0,0 +1,17 @@
+/**
+ * 前端 id 生成（会话 id / 画布节点 id / 草稿 id / 通知 id 等）。
+ *
+ * **一律用它，别裸调 `crypto.randomUUID()`**：该方法只在**安全上下文**存在
+ * （https / localhost）。局域网访问（`npm run dev:lan` → `http://192.168.x.x:30143`）
+ * 或老浏览器里它是 undefined，裸调直接抛 “crypto.randomUUID is not a function”
+ * —— 任务行「新建会话」2026-09-14 就栽在这里（同一批调用里有的做了兜底、有的漏了）。
+ *
+ * 退化实现产出的 id 仍是 `[A-Za-z0-9-]`，满足服务端会话 id 校验
+ * （`SESSION_ID_RE`，见 `app/api/agent/new/route.ts`），可直接当会话 id 用。
+ */
+export function newId(): string {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}

package/lib/ime-guard.test.mjs

@@ -0,0 +1,52 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+async function loadSubject() {
+  return import("./ime-guard.ts");
+}
+
+test("plain key events are not IME-busy", async () => {
+  const { createIMECompositionState, isIMEBusy } = await loadSubject();
+  const state = createIMECompositionState();
+
+  assert.equal(isIMEBusy(state, { isComposing: false, keyCode: 13 }), false);
+  assert.equal(isIMEBusy(state, {}), false);
+  assert.equal(isIMEBusy(state, null), false);
+});
+
+test("composition session marks every keydown as IME-busy", async () => {
+  const { createIMECompositionState, markCompositionStart, markCompositionEnd, isIMEBusy } = await loadSubject();
+  const state = createIMECompositionState();
+
+  markCompositionStart(state);
+  assert.equal(state.composing, true);
+  // 组合期间即使事件没带信号（老输入法）也要让开
+  assert.equal(isIMEBusy(state, { isComposing: false, keyCode: 13 }), true);
+
+  markCompositionEnd(state, 1_000);
+  assert.equal(state.composing, false);
+});
+
+test("isComposing and keyCode 229 are both honoured outside a tracked session", async () => {
+  const { createIMECompositionState, isIMEBusy } = await loadSubject();
+  const state = createIMECompositionState();
+
+  assert.equal(isIMEBusy(state, { isComposing: true, keyCode: 13 }), true);
+  assert.equal(isIMEBusy(state, { keyCode: 229 }), true);
+});
+
+test("keys right after compositionend are IME-busy (Safari / Sogou ordering)", async () => {
+  const { createIMECompositionState, markCompositionStart, markCompositionEnd, isIMEBusy, IME_GRACE_MS } = await loadSubject();
+  const state = createIMECompositionState();
+
+  markCompositionStart(state);
+  // Safari 反序：compositionend 先到，随后那次 keydown 的 isComposing 已是 false
+  markCompositionEnd(state, 5_000);
+
+  assert.equal(isIMEBusy(state, { isComposing: false, keyCode: 13 }, 5_000), true);
+  assert.equal(isIMEBusy(state, { isComposing: false, keyCode: 13 }, 5_000 + IME_GRACE_MS - 1), true);
+
+  // 宽限窗外恢复正常
+  assert.equal(isIMEBusy(state, { isComposing: false, keyCode: 13 }, 5_000 + IME_GRACE_MS), false);
+  assert.equal(isIMEBusy(state, { isComposing: false, keyCode: 13 }, 5_000 + IME_GRACE_MS + 1), false);
+});

package/lib/ime-guard.ts

@@ -0,0 +1,54 @@
+/**
+ * 输入法（IME）组合态判定。
+ *
+ * Enter / Escape / 方向键等业务快捷键在处理前必须先过 `isIMEBusy()`，
+ * 否则中文/日文/韩文输入法「回车确认候选」「Esc 取消候选」会被当成业务提交或业务取消。
+ *
+ * 四个信号缺一不可（靠前的先短路）：
+ *  1. `composing` —— 由 compositionstart / compositionend 自己维护，最可靠；
+ *  2. `event.isComposing` —— 标准属性；
+ *  3. `event.keyCode === 229` —— 老 WebKit 与部分输入法不上报 isComposing；
+ *  4. `endedAt` 宽限窗 —— Safari（以及部分搜狗场景）先发 compositionend 再发 keydown，
+ *     那次 keydown 的 isComposing 已经是 false，只看属性必然误判成「用户主动按了 Enter」。
+ */
+
+/** compositionend 之后仍把按键让给输入法的宽限窗口（ms）。 */
+export const IME_GRACE_MS = 100;
+
+export type IMECompositionState = {
+  /** 是否处于组合中（compositionstart 之后、compositionend 之前） */
+  composing: boolean;
+  /** 最近一次 compositionend 的时间戳；0 = 从未组合过 */
+  endedAt: number;
+};
+
+export function createIMECompositionState(): IMECompositionState {
+  return { composing: false, endedAt: 0 };
+}
+
+export function markCompositionStart(state: IMECompositionState): void {
+  state.composing = true;
+}
+
+export function markCompositionEnd(state: IMECompositionState, now: number = Date.now()): void {
+  state.composing = false;
+  state.endedAt = now;
+}
+
+/** keydown 上取得到的 IME 信号（KeyboardEvent 的结构子集，方便测试）。 */
+export type IMEKeyEvent = {
+  isComposing?: boolean;
+  keyCode?: number;
+};
+
+/** 这次按键是否属于输入法：true → 业务逻辑让开，交给输入法上屏/取消候选。 */
+export function isIMEBusy(
+  state: IMECompositionState,
+  event: IMEKeyEvent | null | undefined,
+  now: number = Date.now(),
+): boolean {
+  if (state.composing) return true;
+  if (event?.isComposing === true) return true;
+  if (event?.keyCode === 229) return true;
+  return now - state.endedAt < IME_GRACE_MS;
+}

package/lib/message-text.ts

@@ -0,0 +1,24 @@
+import type { AgentMessage } from "@/lib/types";
+
+/**
+ * 从消息中提取可渲染的 markdown 文本（钉卡快照用）。
+ * 只取 text 块，忽略 thinking / 工具调用 / 图片等结构 —— 钉卡只渲染内容，与消息气泡解耦。
+ */
+export function extractMessageMarkdown(message: AgentMessage): string {
+  const content = (message as unknown as { content?: unknown }).content;
+  const parts: string[] = [];
+  const push = (c: unknown): void => {
+    if (typeof c === "string") {
+      parts.push(c);
+    } else if (Array.isArray(c)) {
+      for (const b of c) {
+        if (b && typeof b === "object") {
+          const t = b as { type?: string; text?: string };
+          if (t.type === "text" && typeof t.text === "string") parts.push(t.text);
+        }
+      }
+    }
+  };
+  push(content);
+  return parts.join("\n\n").trim();
+}

package/lib/models-cache.ts

@@ -1,6 +1,6 @@
 export interface ModelsData {
   models: Record<string, string>;
-  modelList: { id: string; name: string; provider: string }[];
+  modelList: { id: string; name: string; provider: string; input?: string[] }[];
   defaultModel: { provider: string; modelId: string } | null;
   thinkingLevels: Record<string, string[]>;
   thinkingLevelMaps: Record<string, Record<string, string | null>>;

package/lib/pi-types.ts

@@ -6,7 +6,12 @@ import type {
   SlashCommandInfo,
   Theme,
 } from "@earendil-works/pi-coding-agent";
-import type { AgentMessage as PiAgentMessage } from "@earendil-works/pi-agent-core";
+import type {
+  AgentLoopTurnUpdate,
+  AgentMessage as PiAgentMessage,
+  PrepareNextTurnContext,
+} from "@earendil-works/pi-agent-core";
+import type { ImageContent, TextContent } from "@earendil-works/pi-ai";
 
 export interface ContextUsage {
   percent: number | null;
@@ -138,6 +143,10 @@ export interface AgentSessionLike {
       thinkingLevel?: string;
       streamingMessage?: PiAgentMessage;
     };
+    prepareNextTurnWithContext?: (
+      context: PrepareNextTurnContext,
+      signal?: AbortSignal,
+    ) => Promise<AgentLoopTurnUpdate | undefined> | AgentLoopTurnUpdate | undefined;
   };
   readonly extensionRunner: ExtensionRunnerLike;
   readonly promptTemplates: readonly PromptTemplateLike[];
@@ -153,6 +162,15 @@ export interface AgentSessionLike {
     source?: "interactive" | "rpc";
     preflightResult?: (success: boolean) => void;
   }): Promise<void>;
+  sendCustomMessage<T = unknown>(message: {
+    customType: string;
+    content: string | (TextContent | ImageContent)[];
+    display: boolean;
+    details?: T;
+  }, options?: {
+    triggerTurn?: boolean;
+    deliverAs?: "steer" | "followUp" | "nextTurn";
+  }): Promise<void>;
   abort(): Promise<void>;
   executeBash(command: string, onChunk?: (chunk: string) => void, options?: {
     excludeFromContext?: boolean;