@xingjisoft/neutrino 0.6.0 → 0.7.0

package/docs/plugins/skills-prompts.md

@@ -0,0 +1,69 @@
+# Skill 与提示词
+
+## Skill 格式和触发
+
+```text
+skills/review/
+  SKILL.md
+  references/
+  scripts/
+  assets/
+```
+
+`SKILL.md` 使用简短 front matter：
+
+```md
+---
+name: review
+description: Review code for concrete regressions and verification gaps.
+---
+
+Read the changes and their callers. Report findings supported by evidence.
+```
+
+本版解析单行 name / description；复杂 YAML、折叠字符串不属于此格式。name 应使用便于命令引用的短名称，例如 `review`。
+
+清单注册：
+
+```json
+{ "permissions": ["prompts.contribute"],
+  "contributes": { "skills": ["skills/review/SKILL.md"] } }
+```
+
+代码插件也可在 activate 中使用 `ctx.skills.register('skills/review/SKILL.md')`。
+
+提示词首先只包含 skill 名称和描述。完整正文仅在当前请求使用以下显式引用时加入：
+
+```text
+/skill community.review-skills/review 审查这次修改
+```
+
+浏览器输入框工具栏提供 skill 选择器。普通文本提到某个名称不会自动执行脚本或加载全部 skill 正文。
+
+resources 目录随包分发。skill 中的脚本不会自动执行；需要可执行能力时，另注册工具或命令，由宿主能力桥接执行。纯 skill 不需要 JS 入口。现有文件夹可添加最小的清单后直接安装。
+
+## 提示词片段
+
+```json
+{
+  "permissions": ["prompts.contribute"],
+  "contributes": {
+    "prompts": [
+      { "id": "style", "file": "prompts/style.md", "slot": "rules", "order": 100 },
+      { "id": "persona", "text": "You are a careful reviewer.", "slot": "persona", "replace": true, "roles": ["main"] }
+    ]
+  }
+}
+```
+
+先按 persona / rules / context 排序，再按 order 和完整 ID 排序。`roles` 省略时用于适用的业务 Agent，指定时精确匹配运行角色。常见角色包括 main、subagent，以及 main_model、plan_model、backend_output_model 等 Pro 角色。审批角色 confirm_model / reviewer 不接受插件人格与片段注入。
+
+replace 片段只有在 `persona` 提供者中被选中才生效，其他 replace 项不自动追加。普通片段加在所选基础提示词之后，并带有来源 ID。动态、与模型调用相关的上下文可以通过 request.before 的 systemSuffix 提供。
+
+宿主任务原始约束、权限、预算和执行策略由运行时另外保留。改写人格或规则不能授予文件权限、扩展子 Agent 的写入范围或跳过审批。
+
+## 检查实际生效内容
+
+插件页的“当前回合诊断”显示最近的插件提示词片段和运行错误。`task_run.plugins` 保存包版本与配置；任务 journal 的 `plugin_prompt` 和 `plugin_request_suffix` 保存组装与请求补充记录。
+
+配置或文件更新不会改变已经开始的回合。需要验证新片段时，保存配置后开始下一回合。子 Agent 使用同一份插件版本组合，并按自身角色选择提示词。

package/docs/plugins/ui-sdk.md

@@ -0,0 +1,109 @@
+# Web / TUI 界面 SDK
+
+## 插槽
+
+| 插槽 | 组合方式 | 用途 |
+| --- | --- | --- |
+| app.menu | 多项追加 | 插件菜单按钮 |
+| workspace.tabs | 多项追加 | 工作区选项卡 / 面板 |
+| sidebar.footer | 多项追加 | 侧栏信息 |
+| chat.header.actions | 多项追加 | 对话标题操作 |
+| chat.composer.toolbar | 多项追加 | 输入辅助、预设文本 |
+| chat.composer | 显式选择一个提供者 | 输入编辑器 |
+| chat.message.actions | 按消息匹配追加 | 消息操作按钮 |
+| chat.message.renderer | 显式选择一个提供者 | 消息正文视图 |
+| chat.card.plan | 显式选择一个提供者 | 计划卡片 |
+| chat.card.tool | 显式选择一个提供者 | 工具结果卡片 |
+| settings.sections | 声明设置页面 | 插件自己的设置相关内容 |
+
+追加项按 order 和完整 key 稳定排序。替换项必须在管理界面或 `plugin provider` 命令中选择；安装或排序靠前不会自动接管输入框。默认配置表单由管理器根据 configuration 自动生成。
+
+```json
+{
+  "id": "panel",
+  "slot": "workspace.tabs",
+  "title": "My panel",
+  "view": "panel.html",
+  "height": 240,
+  "text": "Terminal fallback text",
+  "platforms": ["web", "tui"]
+}
+```
+
+`id` 在包内唯一，完整 key 为 `<插件ID>/<id>`。`view` 是包内 HTML 文件；`height` 为 40–1200 像素。`text` 提供无需脚本的内容及终端回退。`command` 是插件自己的用户命令名；点击时通过活动会话提交 `/plugin` 命令。`insert` 将文本加入当前草稿。`match.role` 和 `match.tool` 可限定消息 / 工具卡片。
+
+## HTML 视图
+
+HTML 可以包含自己的样式与脚本。宿主在插件脚本之前注入 `window.neutrino`：
+
+```html
+<button id="read">Read draft</button><pre id="output"></pre>
+<script>
+document.getElementById('read').onclick = async () => {
+  const draft = await neutrino.composer.read();
+  document.getElementById('output').textContent = draft.text;
+};
+</script>
+```
+
+这需要清单的 `composer.read` 权限。建议处理 Promise 错误；未处理的脚本错误会触发视图回退。
+
+每个 iframe 使用 `sandbox="allow-scripts"`，不启用 same-origin。CSP 禁止网络请求、表单提交、外部脚本和任意资源加载；可使用内联样式、内联脚本、打包的模块与 data 图片。视图资源通过已认证的 JSON API 读取后嵌入，不作为同源 HTML 执行。
+
+如使用单文件 ESM，可设置 `entries.web`：
+
+```js
+export default {
+  mount(api, root) {
+    root.textContent = api.context.title;
+  },
+};
+```
+
+可从 `@xingjisoft/neutrino/plugin/web` 导入类型和 `defineWebPlugin`，构建时将依赖打包为一个 ES 模块。运行时不解析 npm 裸模块名。
+
+## 浏览器 API
+
+| 接口 | 权限 / 行为 |
+| --- | --- |
+| `neutrino.context` | 插件 ID、贡献 ID、标题、profile；读取会话权限存在时包含当前消息或计划 |
+| `composer.read()` | composer.read，返回 `{ text, revision }` |
+| `composer.write({ text, expectedRevision })` | composer.write，版本不匹配时拒绝，返回新版本 |
+| `composer.submit()` | composer.submit，通过宿主正常发送流程提交当前草稿 |
+| `conversation.read()` | conversation.read，返回当前只读会话投影 |
+| `commands.execute(name, args)` | commands.register，只能调用本插件命令，经活动会话执行 |
+| `configuration.read()` / `configuration.write({ values, expectedRevision })` | ui.contribute，仅当前插件配置；写入当前项目覆盖层，配置由服务端验证 |
+| `view.resize(height)` | 将当前 iframe 高度限制到 40–1200 |
+| `on('context.changed', handler)` | 订阅会话 / 草稿相关刷新，返回取消订阅函数 |
+
+宿主检查消息来源窗口、随机 nonce、当前会话身份、消息速率和每项权限。切换对话后旧 iframe 被释放。插件不能经此 API 直接批准请求或修改已保存消息。
+
+编辑草稿前先 read，写入时使用读取的 revision；发生冲突后重新 read，让用户决定如何合并。宿主 textarea 保留为草稿来源，iframe 成功准备后才隐藏它。停用、卸载、组件错误或十秒初始化超时会恢复默认组件和草稿。发送、停止、模式和审批控件仍由宿主维护。
+
+工具和消息原文保留在宿主的回退区域；成功加载的自定义视图只改变呈现。插件被移除后，文本仍能显示。
+
+## 主题
+
+`contributes.theme` 设置简单的 CSS 变量值。例如：
+
+```json
+{
+  "--bg": "#171725",
+  "--accent": "#b8b2ff",
+  "--neutrino-composer-radius": "12px",
+  "--neutrino-message-radius": "12px",
+  "--neutrino-tui-accent": "#b8b2ff"
+}
+```
+
+支持已有 Web 设计变量；`--neutrino-composer-radius` 和 `--neutrino-message-radius` 专用于聊天外观。CSS 值不允许 URL、表达式、规则或分号。移除主题时恢复原先变量。
+
+## TUI
+
+TUI 读取同一份声明。app.menu 和 workspace.tabs 出现在起始页；命令通过同一会话运行，文本页面支持返回和滚动。Web 专用组件使用 `platforms: ["web"]`，避免在终端显示无法使用的界面。
+
+选择了提供者后，终端 text 模板支持 `{{content}}`、`{{role}}`（消息），`{{name}}`、`{{result}}`、`{{arguments}}`（工具），`{{plan}}`（计划）和 `{{text}}`（输入提示）。模板替换显示文本，保留原始历史和输入行为。
+
+终端主题支持 `--neutrino-tui-accent`、`--neutrino-tui-tool-header`、`--neutrino-tui-user`、`--neutrino-tui-assistant`、`--neutrino-tui-dim`，值为六位十六进制颜色。取消主题会恢复内置颜色。审批状态色不受这些变量覆盖。
+
+v1 不把终端 Buffer、原始 stdin/stdout 或内部 App 暴露给脚本。新的键鼠交互组件应通过宿主后续版本的公开契约扩展，避免依赖私有渲染实现。完整 HTML 编辑器和任意 JavaScript 卡片在 Web 中提供。

package/examples/local-api.py

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+"""Start a local Neutrino conversation and handle its approval requests."""
+import argparse
+import json
+import os
+from pathlib import Path
+import sys
+from urllib.error import HTTPError
+from urllib.request import Request, urlopen
+
+parser = argparse.ArgumentParser()
+parser.add_argument("message")
+parser.add_argument("--cwd", default=os.getcwd())
+parser.add_argument("--provider", required=True)
+parser.add_argument("--model", required=True)
+parser.add_argument("--intensity", default="High")
+parser.add_argument("--mode", choices=["standard", "ptc", "fast", "fast_dag"], default="standard")
+args = parser.parse_args()
+
+home = Path(os.environ.get("NEUTRINO_HOME", Path.home() / ".neutrino"))
+connection = json.loads((home / "api.json").read_text(encoding="utf-8"))
+base = connection["url"]
+headers = {"Authorization": "Bearer " + connection["token"]}
+
+
+def request(route, data=None):
+    request_headers = dict(headers)
+    payload = None
+    if data is not None:
+        payload = json.dumps(data).encode()
+        request_headers["Content-Type"] = "application/json"
+    try:
+        with urlopen(Request(base + route, payload, request_headers), timeout=30) as response:
+            return json.load(response)
+    except HTTPError as error:
+        raise RuntimeError(error.read().decode()) from error
+
+
+conversation = request("/conversations", {
+    "cwd": os.path.abspath(args.cwd),
+    "selection": {"provider": args.provider, "model": args.model, "intensity": args.intensity},
+    "agent_mode": args.mode,
+    "approval_mode": "request",
+})
+key = conversation["key"]
+print(f"Conversation: {key}", file=sys.stderr)
+# Subscribe before sending: events generated after this point are retained for
+# reconnect, and the initial snapshot describes the newly-created conversation.
+with urlopen(Request(f"{base}/live/{key}/events", headers=headers)) as stream:
+    request(f"/live/{key}/message", {"text": args.message})
+    previous_text = ""
+    printed_messages = set()
+    previous_status = None
+    handled = set()
+    event = "message"
+    data = []
+    for raw in stream:
+        line = raw.decode("utf-8").rstrip("\r\n")
+        if line.startswith("event:"):
+            event = line[6:].strip()
+        elif line.startswith("data:"):
+            data.append(line[5:].lstrip())
+        elif not line:
+            if not data:
+                continue
+            value = json.loads("\n".join(data))
+            data = []
+            if event == "snapshot":
+                for index, message in enumerate(value.get("messages", [])):
+                    if message.get("role") != "assistant" or index in printed_messages:
+                        continue
+                    completed = message.get("content", "")
+                    if previous_text and completed.startswith(previous_text):
+                        print(completed[len(previous_text):], end="", flush=True)
+                    else:
+                        print("\n" + completed, end="", flush=True)
+                    printed_messages.add(index)
+                    previous_text = ""
+                text = value.get("streamingContent") or ""
+                if text.startswith(previous_text):
+                    print(text[len(previous_text):], end="", flush=True)
+                elif text:
+                    print("\n" + text, end="", flush=True)
+                previous_text = text
+                status = (value.get("busy"), value.get("paused"), bool(value.get("reviewing")))
+                if status != previous_status:
+                    print(f"\n[busy={status[0]} paused={status[1]} reviewing={status[2]}]", file=sys.stderr)
+                    previous_status = status
+                approval = value.get("approval")
+            elif event == "approval.requested":
+                approval = value
+            elif event == "gone":
+                break
+            else:
+                approval = None
+            if approval and approval.get("id") not in handled:
+                approval_id = approval["id"]
+                handled.add(approval_id)
+                print("\nApproval requested:\n" + json.dumps(approval, indent=2, ensure_ascii=False), file=sys.stderr)
+                answer = input("Approve? [y/N] ").strip().lower() == "y"
+                try:
+                    request(f"/live/{key}/approvals/{approval_id}", {"approved": answer})
+                except RuntimeError as error:
+                    print(f"Approval could not be applied: {error}", file=sys.stderr)
+            event = "message"

package/examples/plugins/cards/card.html

@@ -0,0 +1,6 @@
+<!doctype html><html><head><meta charset="utf-8"><style>
+body{box-sizing:border-box;margin:0;padding:14px;background:#1c2635;color:#e3ecf8;border:1px solid #54749d;border-radius:10px;font:13px system-ui}h3{margin:0 0 8px;color:#a6ccff}pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:250px;overflow:auto}
+</style></head><body><h3 id="title"></h3><pre id="result"></pre><script>
+function render(){const c=neutrino.context;document.getElementById('title').textContent=c.title;document.getElementById('result').textContent=JSON.stringify(c.message||c.plan||{},null,2)}
+neutrino.on('context.changed',render);render();
+</script></body></html>

package/examples/plugins/cards/neutrino.plugin.json

@@ -0,0 +1,42 @@
+{
+  "id": "community.inspector-cards",
+  "name": "Inspector Cards / 检查卡片",
+  "version": "1.0.0",
+  "apiVersion": 1,
+  "categories": [
+    "appearance"
+  ],
+  "description": "Alternative tool, plan and message renderers. Select each provider in Plugins.",
+  "permissions": [
+    "ui.contribute",
+    "conversation.read"
+  ],
+  "contributes": {
+    "ui": [
+      {
+        "id": "tool",
+        "slot": "chat.card.tool",
+        "title": "Inspector tool card / 工具卡片",
+        "view": "card.html",
+        "height": 200,
+        "text": "{{name}}\n{{result}}"
+      },
+      {
+        "id": "plan",
+        "slot": "chat.card.plan",
+        "title": "Inspector plan / 计划卡片",
+        "view": "card.html",
+        "height": 220,
+        "text": "Plan\n{{plan}}"
+      },
+      {
+        "id": "message",
+        "slot": "chat.message.renderer",
+        "title": "Inspector message / 消息卡片",
+        "view": "card.html",
+        "height": 160,
+        "text": "{{content}}"
+      }
+    ]
+  }
+}

package/examples/plugins/composer/editor.html

@@ -0,0 +1,10 @@
+<!doctype html><html><head><meta charset="utf-8"><style>
+body{margin:0;padding:8px;background:#202127;color:#eee;font:13px system-ui}textarea{box-sizing:border-box;width:100%;height:115px;background:#17181d;color:inherit;border:1px solid #586a91;border-radius:8px;padding:10px;resize:none}footer{display:flex;justify-content:space-between;align-items:center}button{background:#b8cbff;border:0;border-radius:6px;padding:6px 15px}#status{color:#c3cada}
+</style></head><body><textarea id="draft" aria-label="Writing draft / 写作草稿" placeholder="Write here / 在这里写作…"></textarea><footer><span id="status">Writing editor / 写作编辑器</span><button id="send">Send / 发送</button></footer><script>
+const input=document.getElementById('draft'),status=document.getElementById('status');let revision=0,writing=Promise.resolve();
+async function sync(){const draft=await neutrino.composer.read();revision=draft.revision;if(document.activeElement!==input)input.value=draft.text}
+input.oninput=()=>{const text=input.value;writing=writing.then(async()=>{const result=await neutrino.composer.write({text,expectedRevision:revision});revision=result.revision;status.textContent=Array.from(text).length+' characters / 字'}).catch(async e=>{status.textContent=e.message;await sync()})};
+document.getElementById('send').onclick=async()=>{await writing;try{await neutrino.composer.submit();input.value='';await sync()}catch(e){status.textContent=e.message}};
+input.onkeydown=e=>{if((e.ctrlKey||e.metaKey)&&e.key==='Enter'){e.preventDefault();document.getElementById('send').click()}};
+neutrino.on('context.changed',()=>sync().catch(e=>status.textContent=e.message));sync().catch(e=>status.textContent=e.message);
+</script></body></html>

package/examples/plugins/composer/neutrino.plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "community.writing-composer", "name": "Writing Composer / 写作输入框",
+  "version": "1.0.0", "apiVersion": 1, "categories": ["function", "appearance"],
+  "description": "Replace the web editor while the host retains the draft, send and stop controls.",
+  "permissions": ["ui.contribute", "composer.read", "composer.write", "composer.submit"],
+  "contributes": { "ui": [
+    { "id": "editor", "slot": "chat.composer", "title": "Writing editor / 写作编辑器", "view": "editor.html", "height": 185, "platforms": ["web"] },
+    { "id": "outline", "slot": "chat.composer.toolbar", "title": "Outline / 提纲", "insert": "请先列出提纲，再完成任务：\n" }
+  ] }
+}

package/examples/plugins/function-tools/agent.js

@@ -0,0 +1,32 @@
+// This module runs in QuickJS. Bundle third-party dependencies; Node globals are unavailable.
+export default {
+  activate(ctx) {
+    const statistics = (text) => ({
+      label: ctx.config.label,
+      characters: Array.from(text).length,
+      words: text.trim() ? text.trim().split(/\s+/u).length : 0,
+      lines: text ? text.split(/\r?\n/u).length : 0,
+    });
+    ctx.tools.register({
+      name: "word_count", description: "Count characters, whitespace-separated words and lines in text.",
+      parameters: { type: "object", properties: { text: { type: "string", maxLength: 100000 } }, required: ["text"], additionalProperties: false },
+      effects: [], execute: ({ text }) => statistics(text),
+    });
+    ctx.tools.register({
+      name: "file_stats", description: "Read a text file through the shared approval gate and count its contents.",
+      parameters: { type: "object", properties: { path: { type: "string" }, reason: { type: "string" } }, required: ["path", "reason"], additionalProperties: false },
+      effects: ["filesystem.read"],
+      async execute({ path, reason }) { return statistics(await ctx.fs.read(path, reason)); },
+    });
+    ctx.commands.register({
+      name: "count", description: "Count text without a model request.",
+      parameters: { type: "object", properties: { text: { type: "string" } }, required: ["text"], additionalProperties: false },
+      effects: [], execute: ({ text }) => statistics(text),
+    });
+    ctx.events.on("turn.finished", async () => {
+      const count = await ctx.storage.get("turn-count");
+      await ctx.storage.set("turn-count", Number(count || 0) + 1);
+    });
+    ctx.effect(() => ctx.log("Text tools disposed"));
+  },
+};

package/examples/plugins/function-tools/neutrino.plugin.json

@@ -0,0 +1,15 @@
+{
+  "id": "community.text-tools",
+  "name": "Text Tools / 文本工具",
+  "version": "1.0.0",
+  "apiVersion": 1,
+  "description": "Pure word counting, a read-only file summary, and a user command.",
+  "categories": ["function"],
+  "runtime": "sandbox",
+  "entries": { "agent": "agent.js" },
+  "permissions": ["tools.register", "commands.register", "filesystem.read", "hooks.register", "storage"],
+  "configuration": {
+    "type": "object", "additionalProperties": false,
+    "properties": { "label": { "type": "string", "default": "Text statistics", "maxLength": 80 } }
+  }
+}

package/examples/plugins/menus-tabs/neutrino.plugin.json

@@ -0,0 +1,15 @@
+{
+  "id": "community.workbench",
+  "name": "Workbench / 工作台",
+  "version": "1.0.0", "apiVersion": 1,
+  "description": "Menus, a workspace tab and a sidebar panel, with terminal text fallbacks.",
+  "categories": ["function"],
+  "permissions": ["ui.contribute", "conversation.read"],
+  "contributes": {
+    "ui": [
+      { "id": "guide", "slot": "app.menu", "title": "Plugin guide / 插件指南", "text": "Plugins contribute menus, tabs, tools, skills and prompts through the public API. Use Plugins to install, enable and configure them." },
+      { "id": "workspace", "slot": "workspace.tabs", "title": "Workbench / 工作台", "view": "panel.html", "text": "Workbench: use /plugin commands and /skill references in a conversation.", "height": 240 },
+      { "id": "sidebar", "slot": "sidebar.footer", "title": "Extensions / 扩展", "text": "Your workspace can be extended without editing Neutrino." }
+    ]
+  }
+}

package/examples/plugins/menus-tabs/panel.html

@@ -0,0 +1,6 @@
+<!doctype html><html><head><meta charset="utf-8"><style>
+body{font:14px system-ui;color:#e6e8ee;background:#202127;padding:18px}h2{margin-top:0}pre{white-space:pre-wrap;color:#a9c9fa}
+</style></head><body><h2>Workspace overview / 工作区概览</h2><pre id="info">Loading…</pre><script>
+async function update(){try{const c=await neutrino.conversation.read();document.getElementById('info').textContent=JSON.stringify({cwd:c.cwd,messages:c.messages?.length||0,model:c.model},null,2)}catch(e){document.getElementById('info').textContent=e.message}}
+neutrino.on('context.changed',update);update();
+</script></body></html>

package/examples/plugins/skills-prompts/neutrino.plugin.json

@@ -0,0 +1,13 @@
+{
+  "id": "community.review-skills", "name": "Review Skills / 审查技能",
+  "version": "1.0.0", "apiVersion": 1, "categories": ["skill", "prompt"],
+  "description": "Lazy code-review skill, an additive rule and an optional replacement persona.",
+  "permissions": ["prompts.contribute"],
+  "contributes": {
+    "skills": ["skills/review/SKILL.md"],
+    "prompts": [
+      { "id": "evidence", "file": "prompts/evidence.md", "slot": "rules", "roles": ["main", "subagent", "main_model", "backend_output_model"] },
+      { "id": "reviewer", "file": "prompts/reviewer.md", "slot": "persona", "replace": true, "roles": ["main", "main_model"] }
+    ]
+  }
+}

package/examples/plugins/skills-prompts/prompts/evidence.md

@@ -0,0 +1 @@
+Support completion claims with actual checks. Explain compatibility implications when changing public interfaces. Preserve existing user changes.

package/examples/plugins/skills-prompts/prompts/reviewer.md

@@ -0,0 +1 @@
+You are Neutrino, a careful code reviewer. Investigate the relevant code and report actionable findings with clear evidence. Follow the user's requested scope and the host's execution policies.

package/examples/plugins/skills-prompts/skills/review/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: review
+description: Review code changes for correctness, compatibility and missing validation.
+---
+
+Read the changed files and their callers. Identify concrete regressions that can occur through a real execution path. Give each finding a file location, trigger, impact and suggested correction. Distinguish verified defects from questions. Run relevant existing checks when available. Finish with remaining verification gaps.
+
+This skill supplies task guidance. File access, tools, approvals and task limits continue to be enforced by the host.

package/examples/plugins/theme/neutrino.plugin.json

@@ -0,0 +1,12 @@
+{
+  "id": "community.indigo-theme", "name": "Indigo / 靛蓝主题",
+  "version": "1.0.0", "apiVersion": 1, "categories": ["appearance"],
+  "description": "A declaration-only theme for both the browser and terminal.",
+  "permissions": ["ui.contribute"],
+  "contributes": { "theme": {
+    "--bg": "#171725", "--bg-sidebar": "#1c1c30", "--surface-1": "#24243b",
+    "--accent": "#b8b2ff", "--accent-strong": "#958bff", "--radius-lg": "12px",
+    "--neutrino-composer-radius": "12px", "--neutrino-message-radius": "12px",
+    "--neutrino-tui-accent": "#b8b2ff", "--neutrino-tui-tool-header": "#b8b2ff"
+  } }
+}

package/package.json

@@ -1,42 +1,66 @@
-{
-  "name": "@xingjisoft/neutrino",
-  "version": "0.6.0",
-  "description": "XINGJI Neutrino - a CLI coding agent in the terminal.",
-  "type": "module",
-  "license": "Apache-2.0",
-  "bin": {
-    "neutrino": "dist/bin.js"
-  },
-  "main": "dist/app.js",
-  "files": [
-    "dist",
-    "assets",
-    "web"
-  ],
-  "engines": {
-    "node": ">=18.17.0"
-  },
-  "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-web-search.mjs && node scripts/test-search-network.mjs && node scripts/test-compact.mjs && node scripts/test-history-fold.mjs && node scripts/test-web-history.mjs && node scripts/test-web-mobile-history.mjs && node scripts/test-session-migration.mjs && node scripts/test-web-session-migration.mjs && node scripts/test-web-default.mjs && node scripts/test-turn-fold.mjs && node scripts/test-long-turn.mjs && node scripts/test-plan.mjs && node scripts/test-agent-modes.mjs && node scripts/test-subagent.mjs && node scripts/test-task-runtime.mjs && node scripts/test-web-settings.mjs && node scripts/test-update.mjs && node scripts/test-update-ui.mjs && node scripts/test-update-web.mjs && node scripts/test-settings-update.mjs && node scripts/test-update-check.mjs && node scripts/test-update-watch.mjs && node scripts/test-model-intensity.mjs && node scripts/test-background.mjs && node scripts/test-background-lifetime.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-web-sidebar-status.mjs && node scripts/test-web-seen.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-lan.mjs && node scripts/test-web-auth.mjs && node scripts/test-web-auth-ui.mjs && node scripts/test-web-pro.mjs && node scripts/test-pro-preflight.mjs && node scripts/test-pro-runtime.mjs && node scripts/test-pro-team.mjs && node scripts/test-pro-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"
-  },
-  "keywords": [
-    "cli",
-    "agent",
-    "ai",
-    "terminal",
-    "llm",
-    "coding"
-  ],
-  "devDependencies": {
-    "@types/node": "^22.0.0"
-  },
-  "dependencies": {
-    "@cloudflare/codemode": "0.5.6",
-    "quickjs-emscripten": "0.32.0",
-    "typescript": "^5.5.0",
-    "undici": "^6.29.1"
-  }
-}
+{
+  "name": "@xingjisoft/neutrino",
+  "version": "0.7.0",
+  "description": "XINGJI Neutrino - a CLI coding agent in the terminal.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "bin": {
+    "neutrino": "dist/bin.js"
+  },
+  "main": "dist/app.js",
+  "files": [
+    "dist",
+    "assets",
+    "web",
+    "examples/plugins",
+    "examples/local-api.py",
+    "docs/plugins"
+  ],
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "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-web-search.mjs && node scripts/test-search-network.mjs && node scripts/test-compact.mjs && node scripts/test-history-fold.mjs && node scripts/test-web-history.mjs && node scripts/test-web-mobile-history.mjs && node scripts/test-session-migration.mjs && node scripts/test-web-session-migration.mjs && node scripts/test-web-default.mjs && node scripts/test-turn-fold.mjs && node scripts/test-long-turn.mjs && node scripts/test-plan.mjs && node scripts/test-agent-modes.mjs && node scripts/test-subagent.mjs && node scripts/test-task-runtime.mjs && node scripts/test-task-budget.mjs && node scripts/test-web-settings.mjs && node scripts/test-update.mjs && node scripts/test-update-ui.mjs && node scripts/test-update-web.mjs && node scripts/test-settings-update.mjs && node scripts/test-update-check.mjs && node scripts/test-update-watch.mjs && node scripts/test-model-intensity.mjs && node scripts/test-background.mjs && node scripts/test-background-lifetime.mjs && node scripts/test-web-markdown.mjs && node scripts/test-web-i18n.mjs && node scripts/test-web-workspaces.mjs && node scripts/test-web-folder-picker.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-web-sidebar-status.mjs && node scripts/test-web-seen.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-local-api.mjs && node scripts/test-web-settings-http.mjs && node scripts/test-web-lan.mjs && node scripts/test-web-auth.mjs && node scripts/test-web-auth-ui.mjs && node scripts/test-web-pro.mjs && node scripts/test-pro-preflight.mjs && node scripts/test-pro-runtime.mjs && node scripts/test-pro-team.mjs && node scripts/test-pro-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 && node scripts/test-plugins.mjs && node scripts/test-plugin-web.mjs && node scripts/test-fast-scheduler.mjs && node scripts/test-fast-engine.mjs && node scripts/test-fast-planner.mjs && node scripts/test-fast-verification.mjs && node scripts/test-fast-web.mjs && node scripts/test-fast-diagnostics.mjs && node scripts/test-fast-benchmark-budget.mjs && node scripts/test-fast-stability.mjs && node scripts/test-fast-efficiency.mjs",
+    "prepare": "npm run build",
+    "web": "node dist/bin.js web",
+    "test:plugins": "npm run build && node scripts/test-plugins.mjs && node scripts/test-plugin-web.mjs",
+    "test:fast": "npm run build && node scripts/test-fast-scheduler.mjs && node scripts/test-fast-engine.mjs && node scripts/test-fast-planner.mjs && node scripts/test-fast-verification.mjs && node scripts/test-fast-web.mjs && node scripts/test-fast-diagnostics.mjs && node scripts/test-fast-benchmark-budget.mjs && node scripts/test-fast-stability.mjs && node scripts/test-fast-efficiency.mjs",
+    "benchmark:fast": "npm run build && node scripts/benchmark-fast-scheduler.mjs",
+    "benchmark:fast:live": "npm run build && node scripts/benchmark-fast-live.mjs",
+    "test:fast:diagnostics": "npm run build && node scripts/test-fast-diagnostics.mjs && node scripts/test-fast-benchmark-budget.mjs && node scripts/test-fast-stability.mjs && node scripts/test-fast-efficiency.mjs",
+    "diagnose:fast:timeline": "npm run build && node scripts/diagnose-fast-timeline.mjs",
+    "report:fast:timeline": "node scripts/reanalyze-fast-timeline.mjs && node scripts/report-fast-timeline.mjs"
+  },
+  "keywords": [
+    "cli",
+    "agent",
+    "ai",
+    "terminal",
+    "llm",
+    "coding"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "linkedom": "0.18.12"
+  },
+  "dependencies": {
+    "@cloudflare/codemode": "0.5.6",
+    "quickjs-emscripten": "0.32.0",
+    "typescript": "^5.5.0",
+    "undici": "^6.29.1"
+  },
+  "exports": {
+    ".": "./dist/app.js",
+    "./plugin": {
+      "types": "./dist/plugins/types.d.ts",
+      "import": "./dist/plugins/types.js"
+    },
+    "./plugin/web": {
+      "types": "./dist/plugins/web-sdk.d.ts",
+      "import": "./dist/plugins/web-sdk.js"
+    },
+    "./package.json": "./package.json",
+    "./dist/*": "./dist/*"
+  }
+}