@xingjisoft/neutrino 0.2.1 → 0.3.0

package/dist/web/session.js

@@ -10,6 +10,7 @@
  * registers itself in the live hub, so the regular `/api/live/*` endpoints
  * (snapshot, stream, pause, resume, message) work unchanged.
  */
+import { randomUUID } from "node:crypto";
 import { findModel, contextCompressionThreshold, loadConfig, loadPlannerPrompt, loadStepPrompt, loadSubAgentPrompt, normalizeApprovalMode, planFirstEnabled, loadModels, loadPrompt, saveSession, } from "../config.js";
 import { COMPACT_KEEP, planCompaction, transcriptFor, modelHistory, normalizeContext, } from "../compact.js";
 import { LLMClient, describeError } from "../llm/client.js";
@@ -31,6 +32,35 @@ const TOOL_PENDING = "…";
 const SUB_AGENT_TOOLS = getSubAgentToolDefinitions();
 /** Marker for the model-only summary, separate from the original transcript. */
 const SUMMARY_PREFIX = "Context was compressed. Summary of the earlier part:";
+/**
+ * A fresh session id in the same shape `saveSession` generates, so a new
+ * browser conversation has a stable identity before its first message exists.
+ */
+export function newSessionId(now = new Date()) {
+    return `${now.toISOString().replace(/[:.]/g, "-")}-${randomUUID().slice(0, 8)}`;
+}
+/**
+ * Start an empty conversation in a caller-chosen working directory. Nothing is
+ * written to disk until the first message, so an abandoned new-chat dialog
+ * cannot litter the history with empty transcripts.
+ */
+export function createWebSession(cwd, selection, approvalMode) {
+    const now = new Date();
+    const source = {
+        id: newSessionId(now),
+        created_at: now.toISOString(),
+        updated_at: now.toISOString(),
+        model: selection.model.name,
+        provider: selection.provider,
+        intensity: selection.intensity,
+        cwd,
+        title: "",
+        messages: [],
+        tokens: { prompt: 0, completion: 0 },
+        approval_mode: normalizeApprovalMode(approvalMode ?? loadConfig().approval_mode),
+    };
+    return new WebSession(source, selection.model);
+}
 function parseArguments(raw) {
     const text = raw?.trim() ?? "";
     if (!text)
@@ -267,6 +297,40 @@ export class WebSession {
         this.save();
         this.publishLive();
     }
+    /**
+     * Start a fresh chat in the same working directory, mirroring the terminal's
+     * clear shortcut. The finished transcript is checkpointed first and stays on
+     * disk; this session simply moves on under a new id.
+     */
+    liveClear() {
+        if (this.disposed)
+            return;
+        if (!this.checkpoint.flush())
+            return;
+        this.turnToken++;
+        if (this.pendingApproval) {
+            const pending = this.pendingApproval;
+            this.pendingApproval = null;
+            pending.resolve(false);
+        }
+        this.busy = false;
+        this.paused = false;
+        this.queued = null;
+        this.compressing = false;
+        this.retrying = null;
+        this.subagent = null;
+        this.reviewing = null;
+        this.streamingContent = null;
+        this.plan = null;
+        this.planning = false;
+        this.messages = [];
+        this.context = null;
+        this.lastPromptTokens = 0;
+        this.saveError = null;
+        this.sessionId = newSessionId();
+        this.publishLive();
+        this.touch();
+    }
     // ---- turn driving ----------------------------------------------------
     send(text) {
         const trimmed = text.trim();
@@ -725,7 +789,7 @@ export class WebSession {
                 return line.length > 80 ? `${line.slice(0, 77)}…` : line;
             }
         }
-        return "Resumed chat";
+        return "";
     }
     retainStreamingContent() {
         if (this.streamingContent) {

package/dist/web/settings.js

@@ -1,4 +1,4 @@
-import { DEFAULT_CONFIG, INTENSITY_LEVELS, contextWindow, isContextWindow, loadConfig, loadModels, resolveModelSelection, saveConfig, saveModels, } from "../config.js";
+import { DEFAULT_CONFIG, INTENSITY_LEVELS, WEB_LANGUAGES, contextWindow, isContextWindow, loadConfig, loadModels, normalizeApprovalMode, normalizeWebLanguage, resolveModelSelection, saveConfig, saveModels, } from "../config.js";
 import { hashWebPassword, validateWebPassword } from "./auth.js";
 /** Public settings use a whitelist: API keys and cached credentials stay on disk. */
 export function getWebSettings() {
@@ -15,6 +15,7 @@ export function getWebSettings() {
     return {
         providers,
         intensities: INTENSITY_LEVELS,
+        languages: WEB_LANGUAGES.map((value) => ({ value, label: value === "zh" ? "简体中文" : "English" })),
         selection: {
             provider: provider?.name ?? "",
             model: model?.name ?? "",
@@ -26,6 +27,10 @@ export function getWebSettings() {
             approval_model: String(config.approval_model ?? ""),
             auto_approve_extreme_risk: config.auto_approve_extreme_risk === true,
             sound_alerts: config.sound_alerts !== false,
+            language: normalizeWebLanguage(config.language),
+            plan_first: config.plan_first !== false,
+            approval_mode: normalizeApprovalMode(config.approval_mode),
+            web_console: config.web_console !== false,
         },
     };
 }
@@ -67,6 +72,27 @@ export function updateWebSettings(value) {
                     throw new Error("auto-approval must be a boolean");
                 config[key] = val;
             }
+            else if (key === "language") {
+                if (typeof val !== "string" || !WEB_LANGUAGES.includes(val)) {
+                    throw new Error("invalid language");
+                }
+                config.language = val;
+            }
+            else if (key === "plan_first") {
+                if (typeof val !== "boolean")
+                    throw new Error("invalid plan setting");
+                config.plan_first = val;
+            }
+            else if (key === "approval_mode") {
+                if (val !== "request" && val !== "auto")
+                    throw new Error("invalid approval mode");
+                config.approval_mode = val;
+            }
+            else if (key === "web_console") {
+                if (typeof val !== "boolean")
+                    throw new Error("web console must be a boolean");
+                config.web_console = val;
+            }
             else if (key === "web_password") {
                 validateWebPassword(val);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingjisoft/neutrino",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "XINGJI Neutrino - a CLI coding agent in the terminal.",
   "type": "module",
   "license": "Apache-2.0",
@@ -18,7 +18,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "npm run build && node scripts/test-paste.mjs && node scripts/test-mouse.mjs && node scripts/test-cursor.mjs && node scripts/test-selection.mjs && node scripts/test-drag-scroll.mjs && node scripts/test-selection-performance.mjs && node scripts/test-copy.mjs && node scripts/test-scrollbar.mjs && node scripts/test-render.mjs && node scripts/test-drift.mjs && node scripts/test-sanitize.mjs && node scripts/test-markdown.mjs && node scripts/test-wrap.mjs && node scripts/test-fetch.mjs && node scripts/test-compact.mjs && node scripts/test-history-fold.mjs && node scripts/test-web-history.mjs && node scripts/test-web-default.mjs && node scripts/test-turn-fold.mjs && node scripts/test-plan.mjs && node scripts/test-subagent.mjs && node scripts/test-web-settings.mjs && node scripts/test-tools.mjs && node scripts/test-approval.mjs && node scripts/test-approval-review.mjs && node scripts/test-approval-ui.mjs && node scripts/test-web-approval-details.mjs && node scripts/test-approval-mode.mjs && node scripts/test-approval-context.mjs && node scripts/test-settings-render.mjs && node scripts/test-approval-flow.mjs && node scripts/test-web.mjs && node scripts/test-web-settings-http.mjs && node scripts/test-web-auth.mjs && node scripts/test-web-auth-ui.mjs && node scripts/test-interrupt.mjs && node scripts/test-terminal-lifecycle.mjs && node scripts/test-persistence.mjs && node scripts/test-resilience.mjs && node scripts/test-approval-timeout.mjs && node scripts/test-approval-hardening.mjs && node scripts/test-approval-extreme.mjs && node scripts/test-approval-reason.mjs",
+    "test": "npm run build && node scripts/test-paste.mjs && node scripts/test-mouse.mjs && node scripts/test-cursor.mjs && node scripts/test-selection.mjs && node scripts/test-drag-scroll.mjs && node scripts/test-selection-performance.mjs && node scripts/test-copy.mjs && node scripts/test-scrollbar.mjs && node scripts/test-render.mjs && node scripts/test-drift.mjs && node scripts/test-sanitize.mjs && node scripts/test-markdown.mjs && node scripts/test-wrap.mjs && node scripts/test-fetch.mjs && node scripts/test-compact.mjs && node scripts/test-history-fold.mjs && node scripts/test-web-history.mjs && node scripts/test-web-default.mjs && node scripts/test-turn-fold.mjs && node scripts/test-plan.mjs && node scripts/test-subagent.mjs && node scripts/test-web-settings.mjs && node scripts/test-web-markdown.mjs && node scripts/test-web-i18n.mjs && node scripts/test-web-workspaces.mjs && node scripts/test-tools.mjs && node scripts/test-approval.mjs && node scripts/test-approval-review.mjs && node scripts/test-approval-ui.mjs && node scripts/test-web-approval-details.mjs && node scripts/test-approval-mode.mjs && node scripts/test-approval-context.mjs && node scripts/test-settings-render.mjs && node scripts/test-approval-flow.mjs && node scripts/test-web.mjs && node scripts/test-web-settings-http.mjs && node scripts/test-web-auth.mjs && node scripts/test-web-auth-ui.mjs && node scripts/test-interrupt.mjs && node scripts/test-terminal-lifecycle.mjs && node scripts/test-persistence.mjs && node scripts/test-resilience.mjs && node scripts/test-approval-timeout.mjs && node scripts/test-approval-hardening.mjs && node scripts/test-approval-extreme.mjs && node scripts/test-approval-reason.mjs",
     "prepare": "npm run build",
     "web": "node dist/bin.js web"
   },

package/web/README.md

@@ -8,8 +8,17 @@ A small, dependency-free single page app that is served by the Neutrino CLI at
 - watch a running terminal conversation stream in real time: the work behind every
   finished turn folds into one line that opens on a click, while the reply itself
   stays on screen (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;
+- switch the workspace between every known folder and **All directories**;
 - switch the provider, model and intensity for the next turn;
-- edit defaults, context compression and approval settings in a Settings dialog;
+- edit every terminal setting — defaults, interface language, plan-first turns,
+  default approval mode, context compression, reviewer and Web password;
+- switch the interface between English and 简体中文, instantly and persistently;
+- open the same plan / token card as the terminal's `ⓘ`, clear a conversation,
+  delete a saved transcript, and review other agents' read-only history;
 - drive the running conversation: pause / resume the current turn and send new
   messages (they queue while the agent is busy);
 - pick up a saved conversation in the browser and keep chatting, even when no
@@ -112,13 +121,42 @@ selection. Changing the selectors and then using **Continue here** or sending a
 message also uses the draft selection, so a transcript whose old model was
 removed can still be continued.
 
-The **Settings** (gear) button in the sidebar opens defaults for new conversations,
-the context compression threshold, the approval reviewer model, and the
-extreme-risk automatic approval option. Save settings explicitly; cancelling
-leaves the saved values intact. Conversation model changes are separate from
-these defaults. Models come from the same catalog as the terminal, and API keys
-stay on the server. Configure missing keys in the terminal model screen first.
-Intensity uses the same Low–Ultra sampling settings as the terminal.
+The **Settings** (gear) button in the sidebar opens the interface language,
+plan-first turns, the default approval mode, defaults for new conversations, the
+context compression threshold, the approval reviewer model, sound alerts, the
+extreme-risk automatic approval option, and the Web password. Save settings
+explicitly; cancelling leaves the saved values intact. Conversation model changes
+are separate from these defaults. Models come from the same catalog as the
+terminal, and API keys stay on the server. Configure missing keys in the terminal
+model screen first. Intensity uses the same Low–Ultra sampling settings as the
+terminal.
+
+## New conversations and working directories
+
+**New conversation** starts a chat that has no transcript yet. The dialog takes a
+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
+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.
+
+**Working directories** (the folder button under New conversation) shows every
+folder the console has opened or that already holds conversations. Choosing one
+scopes the sidebar to that folder and shows a landing page where typing starts a
+conversation there. **All directories** returns to the grouped view. Opened
+folders are stored in `config.json` under `web_workspaces`, so an empty folder
+that has no conversations yet is still listed after a restart.
+
+## Interface language
+
+The sidebar footer and **Settings → Interface** both offer English and 简体中文.
+The change is applied to the already-open page (labels, messages, status line,
+plan card and dialogs) without a reload, is stored in `config.json`, and is
+shared by every browser. The terminal UI stays in English. New conversation
+content, of course, remains in the language the model writes.
 
 ## History vs. live sessions
 
@@ -144,6 +182,22 @@ Browser-owned sessions are dropped after 30 idle minutes, or immediately through
 `POST /api/live/:key/close`. Sessions owned by the terminal cannot be closed from
 the web.
 
+**Clear** empties the running conversation in place (the previous transcript is
+checkpointed first and stays on disk), mirroring `Ctrl+L` in the terminal. A
+read-only transcript gets **Delete** instead, which removes the saved JSON file
+after confirmation; a conversation that is currently live cannot be deleted.
+Sessions from the terminal's `Ctrl+L` also appear as fresh live conversations in
+the sidebar.
+
+## Other agents' history
+
+**Other agents** in the sidebar lists read-only sessions recorded by Claude Code,
+Codex and OpenCode for the current working directory (the scoped workspace, the
+open conversation's folder, or the server's launch directory). Clicking one shows
+the complete transcript in the conversation pane with a `read-only` badge. The
+sources are the same as the terminal's history browser; OpenCode requires Node.js
+22.13+ because it reads its SQLite database through `node:sqlite`.
+
 ## Plan-first turns
 
 A browser-owned turn is planned before it runs, exactly like a turn in the
@@ -169,8 +223,10 @@ needed by a client:
 
 `status` is `pending`, `active`, `done` or `failed`; `stopped: true` marks a plan
 whose turn was paused before the last step. The terminal draws this in its `ⓘ`
-card; a browser client can render the same timeline from the snapshot. The page
-itself currently shows the plan as the message it already is.
+card, and the web console renders the same timeline in its `ⓘ` plan card: the
+active step is highlighted, finished steps are ticked, failed steps are red, and
+the footer counts the steps completed. The card also shows token usage when no
+plan is running.
 
 Planning is the default for both loops. It can be turned off with
 `"plan_first": false` in `~/.neutrino/config.json` or `NEUTRINO_PLAN=off`; a
@@ -193,21 +249,31 @@ to know whether a conversation is driven by the terminal or by the server.
 | --- | --- | --- |
 | GET | `/api/overview` | Sessions grouped by cwd + live sessions |
 | GET | `/api/sessions` | Flat list of saved sessions |
-| GET | `/api/settings` | Model catalog and public settings; no credentials |
-| POST | `/api/settings` | Save validated `{ selection?, settings? }` defaults |
+| 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/conversations` | Start `{ cwd, selection?, approval_mode? }`, returns `{ key, snapshot }` |
+| GET | `/api/settings` | Model catalog, languages and public settings; no credentials |
+| POST | `/api/settings` | Save validated `{ selection?, settings? }`, including `language`, `plan_first`, `approval_mode` and `web_password` |
 | GET | `/api/session/:id` | One saved transcript |
 | POST | `/api/session/:id/continue` | Resume a transcript with optional `{ selection }`, returns `{ key }` |
+| POST | `/api/session/:id/delete` | Delete a saved, non-running transcript |
+| GET | `/api/agents/:agent/sessions?cwd=…` | Read-only sessions from Claude Code / Codex / OpenCode |
+| GET | `/api/agents/:agent/sessions/:id` | Read-only messages of one other-agent session |
 | GET | `/api/live/:key` | Snapshot of a live session |
 | GET | `/api/live/:key/stream` | SSE stream of a live session |
 | POST | `/api/live/:key/pause` | Pause the running turn |
 | POST | `/api/live/:key/resume` | Resume a paused conversation |
 | POST | `/api/live/:key/message` | Send `{ "text": "…" }` |
 | POST | `/api/live/:key/model` | Apply `{ provider, model, intensity }` while idle or paused |
+| POST | `/api/live/:key/clear` | Empty the conversation in place; keeps the old transcript |
+| POST | `/api/live/:key/approve` | Answer `{ "approved": true|false }` |
+| POST | `/api/live/:key/approval-mode` | Set `{ "mode": "request"|"auto" }` |
 | POST | `/api/live/:key/close` | Dispose a browser-owned session |
 | GET | `/api/health` | Liveness probe |
 | POST | `/api/auth/login` | Sign in with `{ "password": "…" }` |
 | POST | `/api/auth/logout` | Clear the login cookie |
-| GET / POST | `/api/settings` | Read settings or update them, including `settings.web_password` |
 
 Conversation and settings routes require the login cookie; see
 [Authentication](#authentication). `OPTIONS` is answered unauthenticated so
@@ -219,8 +285,10 @@ When a running agent wants to do something risky (a delete-class command, an
 install, a path outside the working directory) the browser shows an orange
 **Request Approval** banner above the composer, showing the full command (or
 formatted tool arguments), working directory and risk reasons, plus two buttons.
-Long proposals remain complete and scroll inside the card. Automatic reviews
-show the same proposal details while they run.
+The banner only appears when a human decision is actually waiting. Long proposals
+remain complete and scroll inside the card.
+Automatic reviews are reported in the conversation's status badge instead
+(`reviewing round 2/3`), so auto approval never looks like a request for approval.
 `Approve` runs the call, `Deny` returns a note to the agent.
 The reviewer uses the current turn's captured user request and earlier user
 messages; queued input belongs to the next turn. Expand a denied tool result