@xingjisoft/neutrino 0.6.2 → 0.7.0

package/web/LOCAL-API.md

@@ -0,0 +1,65 @@
+# Local programmatic API / 本机程序 API
+
+Neutrino 的后端运行时，会同时启动独立的本机 HTTP API。它只监听 IPv4 `127.0.0.1`；即使 Web 控制台开启局域网访问，本 API 也不会随之对局域网开放。默认端口为 `8766`，可在启动前设置 `NEUTRINO_API_PORT`（`0` 表示由操作系统选择空闲端口）。Web 端口设置为 `0` 时，未指定 API 端口也会自动选择空闲端口。端口被占用时后端启动失败并报告错误。API 随后端关闭而关闭。需要不启动 Web 界面时，可单独运行 `neutrino api`（可选 `--port 0` 自动选择端口），只启动本机 API；退出该进程后 API 关闭。`--no-web` 本身不会自动启动这个独立进程。
+
+后端启动后在 `~/.neutrino/api.json` 写入连接信息；设置了 `NEUTRINO_HOME` 时使用 `$NEUTRINO_HOME/api.json`。文件内容为 `{ "pid": 123, "url": "http://127.0.0.1:8766/api/v1", "token": "..." }`，其中端口以文件中的实际地址为准。正常关闭时文件会删除；异常退出可能留下旧文件，连接失败时应检查进程和重新读取文件。多个使用同一数据目录的独立服务会共用发现文件，最后启动的服务会更新它。不要把 token 分享到日志、URL 或网页。Unix 上文件以 `0600` 创建；Windows 的访问控制取决于用户目录的 ACL。
+
+所有请求都需要 `Authorization: Bearer <token>`；Host 必须是发现文件中的 `127.0.0.1:<port>`，带 `Origin` 的请求会被拒绝。使用编程语言的 HTTP 客户端访问；这个接口不开放浏览器跨域调用。接口中的路径均相对于 `api.json` 的 `url`。Pro 工作区在路径开头添加 `/pro`，例如 `/pro/conversations`、`/pro/live/:key/events`。普通和 Pro 的会话、历史互相隔离。
+
+## 开始对话
+
+1. `GET /models` 查看服务商、模型和支持的思考强度；`GET /capabilities` 查看模式。Pro 使用 `GET /pro/models` 查看团队预设。
+2. `POST /conversations` 创建对话：
+
+   ```json
+   {
+     "cwd": "/absolute/path/to/project",
+     "selection": { "provider": "Provider", "model": "Model", "intensity": "High" },
+     "agent_mode": "standard",
+     "approval_mode": "request"
+   }
+   ```
+
+   `cwd` 必须是存在的目录。`selection` 指已配置模型；可选 `agent_mode` 为 `standard`、`ptc`、`fast` 或 `fast_dag`，后者还受现有 Fast 可用性配置约束。审批模式为 `request` 或 `auto`。不传的字段沿用当前工作区默认值。返回 `{ok, key, cwd, snapshot}`；`key` 是当前进程中的活动会话标识，重启后应通过历史记录恢复。
+
+   Pro 创建使用 `POST /pro/conversations` 和 `{ "cwd": "...", "pro_preset": "medium", "approval_mode": "request" }`。Pro 按团队预设选择各角色的模型与强度，不能通过普通 `agent_mode` 指定其他执行模式。
+3. 建议先连接 `GET /live/:key/events`，再 `POST /live/:key/message`，请求体 `{ "text": "请检查这个项目" }`。运行中的消息按现有 Web 行为排队；请求也可带 `agent_mode` 指定下一回合的模式。
+4. 流中出现 `snapshot.approval` 或 `approval.requested` 时，使用 `POST /live/:key/approvals/:approval_id` 答复 `{ "approved": true }` 或 `{ "approved": false }`。必须传 JSON 布尔值。请求已取消、已回答或 ID 已过期时返回 `409`；不能用旧 ID 回答新请求。多个审批会依次呈现。`auto` 模式仍遵循现有的自动审查和极高风险规则。
+
+`examples/local-api.py` 是标准库示例：
+
+```sh
+python3 examples/local-api.py --cwd /path/to/project \
+  --provider Provider --model Model --intensity High --mode standard \
+  '请检查这个项目'
+```
+
+示例订阅输出与状态并在终端询问审批；按 Ctrl+C 可退出客户端。退出或断线不会自动停止服务端任务、批准或拒绝待处理审批；可重新连接并在快照中找到待处理请求，或调用暂停接口。长任务客户端应实现重连，保存事件 ID，并同时展示完整快照中的消息；示例只演示基础连接。
+
+## 流式协议
+
+`GET /live/:key/events` 返回 SSE，含 `snapshot`、`approval.requested`、`approval.resolved` 和 `gone` 事件，另有注释心跳。`snapshot` 与 Web 使用同一会话快照：
+
+- `messages` 和 `streamingContent` 提供已记录消息、工具调用与当前流式文本；文本为当前累计值，不是增量。
+- `busy`、`paused`、`queued`、`compressing`、`retrying`、`saveError`、`tokens`、`task`、`plan`、`subagent`、`fast`、`pro`、`reviewing` 和 `approval` 等字段描述运行状态。字段可为空或按模式缺省。应结合这些字段和最终消息判断结果，`busy: false` 本身不代表任务成功。
+- `approval` 包含 ID、工具、完整参数、工作目录、风险等级、摘要和原因；`reviewing` 是自动审查进度，不表示正在等待人工审批。`approval.resolved` 表示该请求不再等待，并不单独声明批准还是拒绝。
+
+快照更新采用现有 Web 的合并机制，适合实时显示当前状态，不保证逐 token 或每一次短暂中间状态都单独送达。订阅期间产生的事件带 `id`；重新连接时可用 `Last-Event-ID` 请求重放。服务端在首次订阅后为每个会话保留最近 256 个事件，且尽量限制到约 4 MiB，未连接的会话在 10 分钟后可被清理；单个大快照可能超过这个大小。重放历史不可用时发送 `reset`，随后发送当前完整 `snapshot`。每次连接都会提供当前快照；首次订阅之前的短暂事件和服务重启前的事件无法重放，历史消息请通过会话历史读取。服务支持最多 64 个同时被监视的会话，资源不足时返回 `503`。
+
+## 其他接口
+
+这些接口复用 Web 的业务处理，参数、响应及冲突行为与 [Web API](README.md#api) 一致；普通工作区在以下路径前加 `/api/v1`，Pro 在 `/api/v1` 后再加 `/pro`：
+
+| 功能 | 路径 |
+| --- | --- |
+| 会话列表和状态 | `GET /overview`、`GET /sessions`、`GET /live/:key` |
+| 活动会话控制 | `POST /live/:key/pause`、`resume`、`clear`、`close` |
+| 会话配置 | `POST /live/:key/model`、`agent-mode`、`approval-mode`；Pro 使用 `pro-preset` |
+| 历史记录 | `GET /session/:id`、`POST /session/:id/continue`、`POST /session/:id/delete` |
+| 工作目录 | `GET/POST /workspaces`、`GET /fs?path=...`、`POST /fs/mkdir`、`POST /fs/pick` |
+| 其他 Agent 会话 | `GET /agents/:agent/sessions?cwd=...`、`GET /agents/:agent/sessions/:id`、`POST /agents/:agent/sessions/:id/migrate` |
+| 插件 | `GET /plugins`、`GET /plugins/catalog`、`GET /plugins/asset`、`POST /plugins`；参见[插件文档](../docs/plugins/README.md) |
+| 更新状态与操作 | `GET /update/events`、`POST /update/check`、`POST /update` |
+| 侧边栏已读状态 | `GET/POST /seen` |
+
+`GET /health` 为健康检查。`GET /live/:key/stream` 仍提供 Web 原有快照流，推荐新客户端使用 `/events`。Web 自身的 `/api/...`、登录方式和局域网行为保持不变。本 API 不提供全局设置、登录、后台服务管理接口；对话级配置和插件操作可用。终端拥有的会话不能通过 `close` 关闭，与 Web 相同。

package/web/README.md

@@ -11,10 +11,11 @@ A small, dependency-free single page app that is served by the Neutrino CLI at
   (the turn being answered is open, and a pause is not a fold);
 - read replies as rendered markdown: headings, nested/task lists, tables, block
   quotes, code fences, emphasis, safe links and images; raw HTML is escaped;
-- start a new conversation in a working directory you choose, including a folder
-  created from the built-in folder picker;
+- start a new conversation in a working directory you choose, in the operating
+  system's folder window (or the in-page picker, which can also create a folder);
 - switch the workspace between every known folder and **All directories**;
 - switch the provider, model and intensity for the next turn;
+- select Standard, PTC, the original Fast mode, the new **Fast Mode** (`fast_dag`), or Pro from the composer menu; the choice is saved per conversation and frozen when a message is submitted. See [Fast Mode](../docs/fast-mode.md) for configuration and measured limitations;
 - edit every terminal setting — defaults, interface language, plan-first turns,
   default approval mode, context compression, reviewer, Web password, and LAN
   access;
@@ -260,10 +261,23 @@ working directory plus provider, model, thinking level and approval mode. The
 conversation is browser-owned from that moment: it appears in the sidebar under
 its folder and is written to its own session file once the first message exists.
 
-**Browse…** opens the server-side folder picker. It lists folders only, offers
+**Browse…** opens the operating system's own folder window — the Explorer
+dialog on Windows, `choose folder` on macOS, zenity or kdialog on Linux —
+drawn by the console process, so the folder is picked the way it is picked in
+any other application. A browser can only ever see the *contents* of a folder
+it was allowed to read, never the absolute path, which is why the window comes
+from the server and not from the page.
+
+The window is raised above the browser and flashed when it opens: it belongs to
+a process that has no window of its own, so Windows would otherwise leave it
+behind the page, with nothing in the taskbar to find it by.
+
+The in-page folder picker stays as the fallback: it lists folders only, offers
 the existing drive roots (on Windows) or `/`, moves up through the directory
-tree, and can create a folder in place. **Use this folder** fills the working
-directory of the new conversation.
+tree, and can create a folder in place. It opens when no system window can be
+drawn — a phone or another device on the LAN, a headless server, a desktop
+without zenity or kdialog — and **Use this folder** fills the working directory
+in that case too.
 
 **Working directories** (the folder button under New conversation) shows every
 folder the console has opened or that already holds conversations. Choosing one
@@ -392,6 +406,8 @@ to know whether a conversation is driven by the terminal or by the server.
 
 ## API
 
+For other local programs, use the independently authenticated, loopback-only [programmatic API](LOCAL-API.md).
+
 | Method | Path | Purpose |
 | --- | --- | --- |
 | GET | `/api/overview` | Sessions grouped by cwd + live sessions |
@@ -399,7 +415,8 @@ to know whether a conversation is driven by the terminal or by the server.
 | GET | `/api/workspaces` | Recent working directories, launch cwd and home |
 | POST | `/api/workspaces` | Validate and remember `{ "path": "…" }` |
 | GET | `/api/fs?path=…` | Folder listing for the picker (folders only, roots, parent) |
-| POST | `/api/fs/mkdir` | Create `{ "path": "…" }` and return the new path |
+| POST | `/api/fs/mkdir` | Create `{ "path": "…" }` and return the new path |
+| POST | `/api/fs/pick` | Open the operating system's folder window on this machine and return `{ "path": … }` — `null` when it was closed; loopback clients only |
 | POST | `/api/conversations` | Start `{ cwd, selection?, approval_mode? }`, returns `{ key, snapshot }` |
 | GET | `/api/settings` | Model catalog (each model lists its supported intensities), languages, public settings, the live bind address (`web_host`, `web_urls`) and the background state (`background`, `background_running`, `background_url`, one-time `background_prompt`); no credentials |
 | POST | `/api/settings` | Save validated `{ selection?, settings? }`, including `language`, `plan_first`, `approval_mode`, `web_lan`, `background` and `web_password` |
@@ -466,3 +483,7 @@ programmatically (409 when nothing is pending).
 
 `POST /api/live/:key/approval-mode` with `{"mode":"request"|"auto"}` changes
 the conversation mode and returns its current snapshot (400 for invalid modes).
+
+## Plugins / 插件
+
+Open **Plugins** in the sidebar to install local plugins, enable them per profile or project, edit configuration, and select replacement composers and cards. Views use sandboxed iframes and versioned draft APIs. See [插件文档](../docs/plugins/README.md).

package/web/app.js

@@ -1,3 +1,5 @@
+import { createPluginUI } from "./plugins.js";
+let pluginUI = null;
 import { createSettingsUI } from "./settings.js";
 import { createProUI } from "./pro.js";
 import { renderMarkdown as renderMarkdownHtml } from "./markdown.js";
@@ -596,9 +598,9 @@ function storedWorkspace() {
   return { key: pathKey(path), path };
 }
 
-const AGENT_MODE_LABELS = { standard: "Standard mode", ptc: "PTC mode", fast: "Fast mode", pro: "Professional mode" };
+const AGENT_MODE_LABELS = { standard: "Standard mode", ptc: "PTC mode", fast: "Fast mode", fast_dag: "Fast Mode", pro: "Professional mode" };
 let newAgentMode = readStorage("neutrino.agent-mode");
-if (!["standard", "ptc", "fast"].includes(newAgentMode)) newAgentMode = "standard";
+if (!["standard", "ptc", "fast", "fast_dag"].includes(newAgentMode)) newAgentMode = "standard";
 let agentModePending = Promise.resolve();
 let agentModeChanging = false;
 let workspaceNavigation = false;
@@ -625,7 +627,8 @@ function renderAgentMode() {
   el.modePicker.classList.toggle("is-pending", Boolean(agentModeChanging || nextTurn));
   for (const button of el.modePicker.querySelectorAll?.("[data-agent-mode]") || []) {
     button.setAttribute("aria-checked", String(button.dataset.agentMode === mode));
-    button.disabled = agentModeChanging || workspaceNavigation;
+    button.disabled = agentModeChanging || workspaceNavigation || (button.dataset.agentMode === "fast_dag" && state.overview?.fast_mode_enabled === false);
+    if (button.dataset.agentMode === "fast_dag") button.title = state.overview?.fast_mode_enabled === false ? tr("Fast Mode is disabled; select another mode.") : "";
   }
   if (el.modeFeedback) {
     el.modeFeedback.textContent = agentModeError || (agentModeChanging ? tr("Changing mode…") : nextTurn ? tr("Applies to the next turn") : "");
@@ -727,7 +730,7 @@ function initializeAgentMode() {
     if (event.key === "Escape") { el.modePicker.open = false; el.modePicker.querySelector("summary")?.focus(); event.stopPropagation(); }
     if (!["ArrowDown", "ArrowUp", "Home", "End"].includes(event.key)) return;
     event.preventDefault(); el.modePicker.open = true;
-    const buttons = [...el.modePicker.querySelectorAll("[data-agent-mode]")];
+    const buttons = [...el.modePicker.querySelectorAll("[data-agent-mode]")].filter(button => !button.disabled);
     let index = buttons.indexOf(document.activeElement);
     index = event.key === "Home" ? 0 : event.key === "End" ? buttons.length - 1 : (index + (event.key === "ArrowDown" ? 1 : -1) + buttons.length) % buttons.length;
     buttons[index]?.focus();
@@ -983,6 +986,7 @@ async function loadOverview(options = {}) {
     const overview = await response.json();
     if (gateShown) return;
     state.overview = overview;
+    if (el.modePicker) renderAgentMode();
     setStatus(state.selection?.kind === "live" ? "live" : "online", state.selection?.kind === "live" ? "live" : "online");
     renderWorkspaceChrome();
     renderSidebar();
@@ -1628,14 +1632,32 @@ function canPauseFromComposer() {
     && snapshot.busy && !snapshot.paused && !el.input.value.trim());
 }
 
+// A paused turn resumes from the composer button, exactly like an empty draft
+// pauses a running one: the draft wins, so typing always means "send".
+function canResumeFromComposer() {
+  const selection = state.selection;
+  const snapshot = state.snapshot;
+  return Boolean(selection?.kind === "live" && snapshot?.key === selection.key
+    && snapshot.paused && !el.input.value.trim());
+}
+
+function composerAction() {
+  if (canPauseFromComposer()) return "pause";
+  if (canResumeFromComposer()) return "resume";
+  return "send";
+}
+
 function renderComposerAction() {
-  const pause = canPauseFromComposer();
-  const label = pause ? "Pause" : "Send message";
-  el.send.classList.toggle("is-pause", pause);
-  el.send.setAttribute("data-i18n-title", label);
-  el.send.setAttribute("data-i18n-aria-label", label);
-  el.send.title = tr(label);
-  el.send.setAttribute("aria-label", tr(label));
+  const action = composerAction();
+  el.send.classList.toggle("is-pause", action === "pause");
+  el.send.classList.toggle("is-resume", action === "resume");
+  const [source, text] = action === "pause" ? ["Pause", tr("Pause")]
+    : action === "resume" ? ["Resume", tr("Resume")]
+      : ["Send message", tr("Send message")];
+  el.send.setAttribute("data-i18n-title", source);
+  el.send.setAttribute("data-i18n-aria-label", source);
+  el.send.title = text;
+  el.send.setAttribute("aria-label", text);
 }
 
 function hideComposer() {
@@ -1885,7 +1907,7 @@ function renderControls(snapshot) {
             ? reviewStatus(reviewing)
             : subagent
               ? tr("sub-agent: {label}", { label: subagent })
-              : tr("working")
+              : snapshot.fast && snapshot.activeAgentMode === "fast_dag" ? fastPhaseLabel(snapshot.fast.phase) : tr("working")
       : tr("idle");
   el.controls.appendChild(badge);
 
@@ -1896,12 +1918,15 @@ function renderControls(snapshot) {
     el.controls.appendChild(warning);
   }
 
-  if (snapshot.busy || snapshot.paused) {
+  // Resuming belongs to the composer button (see renderComposerAction), which
+  // offers "Continue" on an empty draft, so the status bar never shows a second
+  // way in. Pausing stays here, for a turn that is actually running.
+  if (snapshot.busy && !snapshot.paused) {
     const button = document.createElement("button");
     button.className = "control";
-    button.textContent = snapshot.paused ? tr("Resume") : tr("Pause");
+    button.textContent = tr("Pause");
     button.addEventListener("click", () => {
-      postAction(snapshot.key, snapshot.paused ? "resume" : "pause");
+      postAction(snapshot.key, "pause");
     });
     el.controls.appendChild(button);
   }
@@ -2028,6 +2053,7 @@ function renderMessageList(messages, streaming, options) {
 function renderMessage(message, index) {
   const article = document.createElement("article");
   article.className = `message ${message.role}`;
+  article.dataset.pluginMessage = String(index);
 
   if (message.role === "tool") {
     const details = document.createElement("details");
@@ -2178,52 +2204,69 @@ function scrollToBottom() {
 
 async function postAction(key, action, body) {
   try {
-    await apiFetch(`/api/live/${encodeURIComponent(key)}/${action}`, {
+    const response = await apiFetch(`/api/live/${encodeURIComponent(key)}/${action}`, {
       method: "POST",
       headers: body ? { "Content-Type": "application/json" } : undefined,
       body: body ? JSON.stringify(body) : undefined,
     });
+    if (!response.ok) { const data = await response.json(); throw new Error(data.error || `HTTP ${response.status}`); }
+    return true;
   } catch (error) {
+    el.sub.textContent = error.message;
     console.error(error);
+    return false;
   }
 }
 
 function activateComposer() {
-  if (canPauseFromComposer()) return postAction(state.selection.key, "pause");
+  const action = composerAction();
+  if (action === "pause" || action === "resume") return postAction(state.selection.key, action);
   return sendMessage();
 }
 
 async function sendMessage() {
+  // Internal plugin requests pin their originating selection and can preserve the user draft.
+  const pluginRequest = arguments[0] ?? null;
+  // The keydown handler passes the text it saw: sendMessage awaits the agent-mode
+  // preference before touching the textarea, so reading it here is too late.
+  const submittedText = arguments[1] ?? null;
   try { await agentModePending; } catch (error) { el.sub.textContent = error.message; return; }
+  if (pluginRequest && state.selection !== pluginRequest.selection) throw new Error("Conversation changed before the plugin message was sent");
   const selection = state.selection;
   if (!selection) return;
-  const text = el.input.value;
+  const text = pluginRequest?.text ?? submittedText ?? el.input.value;
   if (!text.trim()) return;
   try {
     if (PRO_MODE) await proUI?.flush();
     else await preferences.flush?.();
   } catch (error) { el.sub.textContent = tr(error.message); return; }
-  if (state.selection !== selection) return;
+  if (state.selection !== selection) { if (pluginRequest) throw new Error("Conversation changed before the plugin message was sent"); return; }
+  const messagePayload = { text, ...(PRO_MODE ? {} : { agent_mode: currentAgentMode() }) };
 
   if (selection.kind === "live") {
-    el.input.value = "";
+    if (!pluginRequest?.preserveDraft) el.input.value = "";
     autosize();
-    await postAction(selection.key, "message", { text });
+    // A paused turn only queues the text, so a user send resumes right away: the
+    // message then starts the turn instead of waiting for a separate continue click.
+    const resumes = !pluginRequest && state.snapshot?.key === selection.key && Boolean(state.snapshot.paused);
+    const sent = await postAction(selection.key, "message", messagePayload);
+    if (sent === false) { if (!pluginRequest?.preserveDraft) el.input.value = text; autosize(); }
+    else if (resumes) await postAction(selection.key, "resume");
     return;
   }
 
   if (selection.kind === "new") {
     // A workspace landing page: typing starts a fresh conversation there, just
     // like typing on the terminal's start screen.
-    el.input.value = "";
+    if (!pluginRequest?.preserveDraft) el.input.value = "";
     autosize();
     try {
       const created = await createConversation(selection.cwd, preferences.defaultSelection?.());
       await selectLive(created.key);
       setConversationView(true);
-      await postAction(created.key, "message", { text });
+      if (await postAction(created.key, "message", messagePayload) === false) { if (!pluginRequest?.preserveDraft) el.input.value = text; autosize(); }
     } catch (error) {
-      el.input.value = text;
+      if (!pluginRequest?.preserveDraft) el.input.value = text;
       autosize();
       el.sub.textContent = tr("Could not start the conversation: {error}", { error: error.message });
     }
@@ -2231,13 +2274,13 @@ async function sendMessage() {
   }
 
   // Reading a saved transcript: resume it in the browser, then deliver the text.
-  el.input.value = "";
+  if (!pluginRequest?.preserveDraft) el.input.value = "";
   autosize();
   try {
     const key = await continueSession(selection.id);
-    await postAction(key, "message", { text });
+    if (await postAction(key, "message", messagePayload) === false) { if (!pluginRequest?.preserveDraft) el.input.value = text; autosize(); }
   } catch (error) {
-    el.input.value = text;
+    if (!pluginRequest?.preserveDraft) el.input.value = text;
     autosize();
     el.sub.textContent = tr("Could not continue this conversation: {error}", { error: error.message });
   }
@@ -2709,6 +2752,46 @@ async function loadFolder(path) {
   }
 }
 
+/**
+ * Ask the server to open the operating system's folder window.
+ *
+ * The browser's own picker never reveals an absolute path, so a working
+ * directory has to be chosen on the machine that runs the agent. Resolves to the
+ * chosen path, "" when the user closed the window, or null when this browser
+ * cannot use a system window: another device, or no desktop behind the server.
+ */
+async function pickFolderInSystemWindow(start, feedback) {
+  if (feedback) feedback.textContent = tr("Waiting for the folder window on your desktop…");
+  try {
+    const response = await apiFetch("/api/fs/pick", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ start, title: tr("Select a working directory") }),
+    });
+    const data = await response.json().catch(() => ({}));
+    if (!response.ok) return null;
+    return typeof data.path === "string" ? data.path : "";
+  } catch {
+    // A window that could not open is a reason to fall back, never an error.
+    return null;
+  } finally {
+    if (feedback) feedback.textContent = "";
+  }
+}
+
+/**
+ * Choose a working directory: the system folder window first, the in-page
+ * folder browser when no window can open here.
+ */
+async function chooseFolder({ start = "", onPick = null, feedback = null } = {}) {
+  const picked = await pickFolderInSystemWindow(start, feedback);
+  if (picked === null) {
+    openFolderDialog({ start, onPick });
+    return;
+  }
+  if (picked && typeof onPick === "function") onPick(picked);
+}
+
 function openFolderDialog({ start = "", onPick = null } = {}) {
   state.folder = {
     path: "",
@@ -2812,12 +2895,28 @@ function planStatusLabel(status) {
   return tr("Pending");
 }
 
+function fastPhaseLabel(phase) {
+  switch (phase) {
+    case "planning": return tr("Planning tasks");
+    case "executing": return tr("Running tasks concurrently");
+    case "verifying": return tr("Verifying local results");
+    case "integrating": return tr("Integrating results");
+    case "reviewing": return tr("Final global review");
+    case "completed": return tr("Fast Mode completed");
+    case "cancelled": return tr("Fast Mode cancelled");
+    case "cancelling": return tr("Stopping tasks…");
+    default: return tr("Fast Mode failed");
+  }
+}
+
 function renderPlanCard(source) {
   if (!el.planCard) return;
   const plan = source && source.plan && Array.isArray(source.plan.steps) && source.plan.steps.length ? source.plan : null;
   const tokens = source && source.tokens ? source.tokens : null;
   const hasUsage = tokens && (Number(tokens.prompt) > 0 || Number(tokens.completion) > 0);
-  if (!state.planOpen || (!plan && !hasUsage)) {
+  const fast = (source?.activeAgentMode === "fast_dag" || (!source?.activeAgentMode && source?.agent_mode === "fast_dag"))
+    ? source.fast || source.fast_run : null;
+  if (!state.planOpen || (!plan && !hasUsage && !fast)) {
     el.planCard.classList.add("hidden");
     el.planCard.replaceChildren();
     return;
@@ -2842,6 +2941,39 @@ function renderPlanCard(source) {
   head.append(title, close);
   card.appendChild(head);
 
+  if (fast) {
+    const progress = document.createElement("div");
+    progress.className = "fast-progress";
+    progress.setAttribute("role", "status");
+    progress.setAttribute("aria-live", "polite");
+    const phase = document.createElement("strong");
+    phase.textContent = tr("Fast Mode") + " · " + fastPhaseLabel(fast.phase);
+    const tasks = (fast.tasks || []).filter(task => !task.verifies);
+    const count = document.createElement("p");
+    count.textContent = tr("{running} running · {verified}/{total} verified", {
+      running: (fast.tasks || []).filter(task => task.status === "RUNNING" || (task.kind === "verification" && task.status === "VERIFYING")).length,
+      verified: tasks.filter(task => task.status === "COMPLETED").length, total: tasks.length,
+    });
+    progress.append(phase, count);
+    const list = document.createElement("ul");
+    for (const task of tasks) {
+      const row = document.createElement("li");
+      row.textContent = `${task.task_goal} · ${task.status}`;
+      list.appendChild(row);
+    }
+    progress.appendChild(list);
+    if (fast.error) {
+      const error = document.createElement("p");
+      error.className = "error"; error.textContent = fast.error;
+      const fallback = document.createElement("button");
+      fallback.type = "button"; fallback.className = "control";
+      fallback.textContent = tr("Select Standard mode to continue");
+      fallback.addEventListener("click", () => { agentModePending = chooseAgentMode("standard"); void agentModePending.catch(() => {}); });
+      progress.append(error, fallback);
+    }
+    card.appendChild(progress);
+  }
+
   if (plan) {
     if (plan.goal) {
       const goal = document.createElement("div");
@@ -3367,9 +3499,12 @@ el.back.addEventListener("click", () => setConversationView(false));
 el.send.addEventListener("click", activateComposer);
 el.input.addEventListener("input", autosize);
 el.input.addEventListener("keydown", (event) => {
+  // An Enter that picks an IME candidate belongs to the input method, not to us:
+  // preventDefault would cancel the commit and send the uncommitted composition.
+  if (event.isComposing || event.keyCode === 229) return;
   if (event.key === "Enter" && !event.shiftKey) {
     event.preventDefault();
-    sendMessage();
+    sendMessage(null, el.input.value);
   }
 });
 
@@ -3383,8 +3518,20 @@ el.workspaceAll.addEventListener("click", () => {
   showHome();
 });
 el.workspaceAdd.addEventListener("click", () => {
-  el.workspaceDialog.close();
-  openFolderDialog({ start: state.workspace?.path || state.workspaces?.cwd || "", onPick: (path) => openWorkspace(path) });
+  // The window opens on the desktop of the machine running the console, so this
+  // sheet stays open with a line saying where to look, and closes once a folder
+  // has been chosen (or when the in-page browser takes over).
+  const start = state.workspace?.path || state.workspaces?.cwd || "";
+  void pickFolderInSystemWindow(start, el.workspaceFeedback).then((picked) => {
+    if (picked === null) {
+      el.workspaceDialog.close();
+      openFolderDialog({ start, onPick: (path) => openWorkspace(path) });
+      return;
+    }
+    if (!picked) return;
+    el.workspaceDialog.close();
+    openWorkspace(picked);
+  });
 });
 el.agentsOpen.addEventListener("click", () => openAgentsDialog());
 el.agentMigrate.addEventListener("click", () => migrateSelectedAgentSession());
@@ -3406,8 +3553,9 @@ el.newChatForm.addEventListener("submit", (event) => {
   submitNewChat();
 });
 el.newChatBrowse.addEventListener("click", () => {
-  openFolderDialog({
+  void chooseFolder({
     start: el.newChatCwd.value.trim() || state.workspace?.path || "",
+    feedback: el.newChatFeedback,
     onPick: (path) => {
       el.newChatCwd.value = path;
       renderNewChatRecents();
@@ -3495,3 +3643,24 @@ loadSeen().then(() => loadOverview()).then(async () => {
   if (state.workspace && !state.selection) renderWorkspaceLanding(state.workspace.path);
 });
 setInterval(() => loadOverview({ silent: true }), REFRESH_MS);
+
+// The plugin shell consumes the same public conversation projection as the built-in UI.
+if (typeof createPluginUI === "function") pluginUI = createPluginUI({
+  profile: PRO_MODE ? "pro" : "standard",
+  api: apiFetch,
+  context: () => {
+    const data = state.snapshot ?? state.fileData ?? state.agentData ?? {};
+    const selection = state.selection;
+    return { identity:selection ? `${selection.kind}:${selection.key ?? selection.id ?? selection.cwd ?? ""}` : "",
+      cwd:data.cwd ?? selection?.cwd ?? state.workspace?.path ?? "",messages:data.messages ?? [],
+      plan:data.plan,model:data.model,streamingContent:data.streamingContent,pluginUI:data.task?.pluginUI,pluginPrompt:data.task?.pluginPrompt,pluginErrors:data.task?.pluginErrors };
+  },
+  getDraft: () => el.input.value,
+  setDraft: text => { el.input.value=text; autosize(); },
+  submit: async () => { if (!state.selection) throw new Error("Open a conversation first"); await sendMessage({ selection:state.selection,text:el.input.value }); },
+  command: async (name,args) => {
+    if (!state.selection) throw new Error("Open a conversation first");
+    await sendMessage({ selection:state.selection,text:`/plugin ${name} ${JSON.stringify(args)}`,preserveDraft:true });
+  },
+  notice: message => { el.sub.textContent=message; },
+});

package/web/i18n.js

@@ -83,6 +83,19 @@ const ZH = {
   "Standard mode": "标准模式",
   "PTC mode": "PTC 模式",
   "Fast mode": "快速模式",
+  "Fast Mode": "极速模式",
+  "Fast Mode is disabled; select another mode.": "极速模式已关闭，请选择其他模式。",
+  "Dynamic task scheduling and concurrent execution shorten complex tasks while preserving reasoning capability.": "通过动态任务调度与多任务并发执行，大幅缩短复杂任务的完成时间，同时保持原有推理能力。",
+  "Planning tasks": "正在规划任务",
+  "Running tasks concurrently": "正在并发执行",
+  "Verifying local results": "正在执行局部验证",
+  "Integrating results": "正在整合结果",
+  "Final global review": "正在进行最终审查",
+  "Fast Mode completed": "极速模式已完成",
+  "Fast Mode failed": "极速模式执行失败",
+  "Fast Mode cancelled": "极速模式已取消",
+  "{running} running · {verified}/{total} verified": "{running} 个正在运行 · {verified}/{total} 个已验证",
+  "Select Standard mode to continue": "选择标准模式继续",
   "Professional mode": "专业模式",
   "Full-featured Agent for every scenario": "功能完整的 Agent ，适用于所有场景",
   "All standard capabilities, with code-based planning to save tokens": "拥有标准模式所有功能，通过代码实现规划，节省 Token ",
@@ -180,6 +193,8 @@ const ZH = {
   "Open folder…": "打开文件夹…",
   "Open working directory": "打开工作目录",
   "Choose a folder to open as the working directory.": "选择一个文件夹作为工作目录。",
+  "Select a working directory": "选择工作目录",
+  "Waiting for the folder window on your desktop…": "正在等待桌面上的文件夹窗口…",
   "This folder no longer exists.": "此文件夹已不存在。",
   "{n} conversations": "{n} 个对话",
   "Recent folders": "最近文件夹",

package/web/index.html

@@ -25,6 +25,7 @@
     <title>Neutrino</title>
     <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='%23f9fafb' stroke-width='1.7'%3E%3Cellipse cx='12' cy='12' rx='9.4' ry='3.8' transform='rotate(-30 12 12)'/%3E%3Ccircle cx='12' cy='12' r='3.1'/%3E%3C/svg%3E" />
     <link rel="stylesheet" href="style.css" />
+    <link rel="stylesheet" href="plugins.css" />
   </head>
   <body>
     <div id="app">
@@ -135,6 +136,7 @@
                   <button type="button" role="menuitemradio" aria-checked="true" data-agent-mode="standard"><span><strong data-i18n="Standard mode">Standard mode</strong><small data-i18n="Full-featured Agent for every scenario">Full-featured Agent for every scenario</small></span><svg class="agent-mode-check" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="m5 12 4 4L19 6" /></svg></button>
                   <button type="button" role="menuitemradio" aria-checked="false" data-agent-mode="ptc"><span><strong data-i18n="PTC mode">PTC mode</strong><small data-i18n="All standard capabilities, with code-based planning to save tokens">All standard capabilities, with code-based planning to save tokens</small></span><svg class="agent-mode-check" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="m5 12 4 4L19 6" /></svg></button>
                   <button type="button" role="menuitemradio" aria-checked="false" data-agent-mode="fast"><span><strong data-i18n="Fast mode">Fast mode</strong><small data-i18n="Less thinking and fewer calls for quick answers">Less thinking and fewer calls for quick answers</small></span><svg class="agent-mode-check" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="m5 12 4 4L19 6" /></svg></button>
+                  <button class="fast-mode-card" type="button" role="menuitemradio" aria-checked="false" data-agent-mode="fast_dag"><span><strong data-i18n="Fast Mode">Fast Mode</strong><small data-i18n="Dynamic task scheduling and concurrent execution shorten complex tasks while preserving reasoning capability.">Dynamic task scheduling and concurrent execution shorten complex tasks while preserving reasoning capability.</small></span><svg class="agent-mode-check" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="m5 12 4 4L19 6" /></svg></button>
                   <button type="button" role="menuitemradio" aria-checked="false" data-agent-mode="pro"><span><strong data-i18n="Professional mode">Professional mode</strong><small data-i18n="Assign tasks to the best-suited models so multiple models complement each other">Assign tasks to the best-suited models so multiple models complement each other</small></span><svg class="agent-mode-check" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="m5 12 4 4L19 6" /></svg></button>
                 </div>
                 <p id="agent-mode-feedback" class="agent-mode-feedback" role="status" aria-live="polite"></p>
@@ -182,7 +184,7 @@
                 </div>
               </details>
               <button id="send" class="primary" type="button" title="Send message" aria-label="Send message" data-i18n-title="Send message" data-i18n-aria-label="Send message">
-                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path class="send-icon" d="M12 19V5M5 12l7-7 7 7" /><rect class="pause-icon" x="5" y="5" width="14" height="14" rx="2" fill="currentColor" stroke="none" /></svg>
+                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path class="send-icon" d="M12 19V5M5 12l7-7 7 7" /><rect class="pause-icon" x="5" y="5" width="14" height="14" rx="2" fill="currentColor" stroke="none" /><path class="resume-icon" d="M8 5.6v12.8L19 12z" fill="currentColor" stroke="none" /></svg>
               </button>
             </div>
             <div class="composer-hint">

package/web/plugins.css

@@ -0,0 +1,10 @@
+.plugin-manager-body{display:flex;flex-direction:column;gap:14px}.plugin-dialog{width:min(860px,94vw)}
+.plugin-list{display:grid;gap:12px}.plugin-card{padding:16px;border:1px solid var(--border);border-radius:var(--radius-md);background:var(--surface-1)}
+.plugin-card-heading,.plugin-actions,.plugin-install{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.plugin-card-heading{justify-content:space-between}.plugin-card code{font-size:12px;color:var(--text-caption)}
+.plugin-card p{margin:9px 0}.plugin-badge{font-size:11px;color:var(--accent);border:1px solid var(--accent-line);border-radius:20px;padding:3px 8px}.plugin-warning{color:var(--amber);font-size:13px}
+.plugin-config,.plugin-providers{display:grid;gap:10px;margin-top:12px}.plugin-field{display:flex;justify-content:space-between;align-items:center;gap:12px;font-size:13px}.plugin-field>span{flex:1}.plugin-field select,.plugin-field input:not([type=checkbox]){max-width:55%;min-width:140px}.plugin-field textarea{max-width:60%;min-height:90px;color:var(--text);background:var(--surface-code);border:1px solid var(--border)}
+.plugin-install input{flex:1}.plugin-details{white-space:pre-wrap;overflow-wrap:anywhere;font-size:11px;max-height:280px;overflow:auto}.plugin-card summary{cursor:pointer;font-size:13px;margin-top:12px}
+.plugin-frame{width:100%;display:block;border:0;min-height:40px;background:transparent}.plugin-tabs,.plugin-toolbar,.plugin-header-actions,.plugin-menu{display:flex;flex-wrap:wrap;gap:7px}.plugin-tabs:empty,.plugin-toolbar:empty,.plugin-menu:empty{display:none}.plugin-tabs{padding:8px 22px}.plugin-tabs .control{font-size:12px}.plugin-toolbar{padding:0 0 7px}.plugin-sidebar{padding:8px 16px}.plugin-sidebar:empty{display:none}
+.plugin-panel{margin:8px 22px;padding:12px;background:var(--surface-1);border:1px solid var(--border);border-radius:var(--radius-md)}.plugin-panel-content{margin-top:10px}.plugin-skill-select{max-width:260px;font-size:12px}.plugin-composer-target{width:100%}
+.composer-card{border-radius:var(--neutrino-composer-radius,var(--radius-xl))}.message{border-radius:var(--neutrino-message-radius,0)}
+@media(max-width:640px){.plugin-field{align-items:flex-start;flex-direction:column}.plugin-field input:not([type=checkbox]),.plugin-field select,.plugin-field textarea{max-width:100%;width:100%}.plugin-panel{margin:6px}.plugin-actions .control{font-size:12px}}