@surething/cockpit 1.0.217 → 1.0.218

package/.next-prod/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":19799218,"timestamp":143062609,"id":14,"parentId":1,"tags":{},"startTime":1779817892339,"traceId":"98826c66cc2d55a4"},{"name":"run-typescript","duration":16474894,"timestamp":162871841,"id":1519,"parentId":1,"tags":{},"startTime":1779817912148,"traceId":"98826c66cc2d55a4"},{"name":"static-check","duration":1046300,"timestamp":179379791,"id":1522,"parentId":1,"tags":{},"startTime":1779817928656,"traceId":"98826c66cc2d55a4"},{"name":"static-generation","duration":5774227,"timestamp":180539499,"id":1778,"parentId":1,"tags":{},"startTime":1779817929815,"traceId":"98826c66cc2d55a4"},{"name":"collect-build-traces","duration":18014017,"timestamp":180426813,"id":1775,"parentId":1,"tags":{},"startTime":1779817929703,"traceId":"98826c66cc2d55a4"},{"name":"telemetry-flush","duration":57,"timestamp":198445089,"id":1787,"parentId":1,"tags":{},"startTime":1779817947721,"traceId":"98826c66cc2d55a4"},{"name":"next-build","duration":55513834,"timestamp":142931325,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1779817892207,"traceId":"98826c66cc2d55a4"}]
+[{"name":"run-webpack","duration":20896395,"timestamp":174952275,"id":14,"parentId":1,"tags":{},"startTime":1780281928939,"traceId":"3ec3dff617736784"},{"name":"run-typescript","duration":17461310,"timestamp":195858899,"id":1519,"parentId":1,"tags":{},"startTime":1780281949846,"traceId":"3ec3dff617736784"},{"name":"static-check","duration":1101493,"timestamp":213361199,"id":1522,"parentId":1,"tags":{},"startTime":1780281967348,"traceId":"3ec3dff617736784"},{"name":"static-generation","duration":6075258,"timestamp":214649341,"id":1778,"parentId":1,"tags":{},"startTime":1780281968637,"traceId":"3ec3dff617736784"},{"name":"collect-build-traces","duration":19739218,"timestamp":214463475,"id":1775,"parentId":1,"tags":{},"startTime":1780281968451,"traceId":"3ec3dff617736784"},{"name":"telemetry-flush","duration":64,"timestamp":234206747,"id":1787,"parentId":1,"tags":{},"startTime":1780281988194,"traceId":"3ec3dff617736784"},{"name":"next-build","duration":59413969,"timestamp":174792856,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1780281928780,"traceId":"3ec3dff617736784"}]

package/README.md

@@ -26,7 +26,7 @@
 
 ---
 
-> **OpenCockpit is the open-source Claude Code GUI** — and a single canvas for whatever agent you bring next. Run multi-project Claude sessions out of the box; pop open a tab for **OpenAI Codex, DeepSeek, Kimi, or local Ollama** whenever you need. Built-in terminal, Chrome control, PostgreSQL / MySQL / Redis bubbles, code review, and slash modes — all local.
+> **OpenCockpit is the open-source Claude Code GUI** — and a single canvas for whatever agent you bring next. Run multi-project Claude sessions out of the box; pop open a tab for **Codex, DeepSeek, Kimi, or local Ollama** whenever you need. Built-in terminal, Chrome control, PostgreSQL / MySQL / Redis bubbles, code review, and slash modes — all local.
 
 https://github.com/user-attachments/assets/18f1a5dc-64f3-4ff6-b9fc-9cd08181fbb8
 
@@ -42,7 +42,7 @@ Cockpit is the instrument panel. It does **not** replace Claude Code; it stands
 
 | Pain with raw Claude Code | What Cockpit adds |
 |---|---|
-| Stuck on one model | **5 engines side by side** in tabs: Claude (default), OpenAI Codex, DeepSeek, Kimi, local Ollama — each its own session |
+| Stuck on one model | **5 engines side by side** in tabs: Claude (default), Codex, DeepSeek, Kimi, local Ollama — each its own session |
 | One session at a time, terminal chaos at 3+ projects | **Multi-project tabs**, parallel agent sessions, red-dot inbox, desktop notifications |
 | Image attachments are awkward | Drop / paste images straight into chat |
 | "What was I debugging yesterday?" | Cmd+K cross-project session browser, pinning, forking |
@@ -58,7 +58,7 @@ Cockpit is the instrument panel. It does **not** replace Claude Code; it stands
 ### Engines — Claude by default, bring any agent you want
 
 - **Claude** *(default)* — full official Agent SDK; zero setup if `claude` CLI is already configured
-- **OpenAI Codex** — reuses your `~/.codex` config; same chat, same shell + bubbles
+- **Codex** — reuses your `~/.codex` config; same chat, same shell + bubbles
 - **DeepSeek** — Anthropic-compatible endpoint via the Claude SDK; paste a key, pick `v4-pro` or `v4-flash`
 - **Kimi** *(Moonshot)* — tool calls render in chat just like Claude's
 - **Ollama** — auto-starts the daemon; pick any pulled model from the chat header; fully offline
@@ -146,7 +146,7 @@ No install, no AI chat (read-only sandbox, 5 min):
 
 ### Optional, per non-Claude engine
 
-- **OpenAI Codex** — log in once with `codex login` to populate `~/.codex`
+- **Codex** — log in once with `codex login` to populate `~/.codex`
 - **DeepSeek** — get an API key at [api-docs.deepseek.com](https://api-docs.deepseek.com/); paste it into the engine picker
 - **Kimi (Moonshot)** — get an API key at [platform.moonshot.cn](https://platform.moonshot.cn/); paste it into the engine picker
 - **Ollama** — install [ollama.com](https://ollama.com/) and `ollama pull <model>`; Cockpit auto-starts the daemon
@@ -207,7 +207,7 @@ Next.js 16 · React 19 · TypeScript · TailwindCSS · xterm.js · node-pty · S
 
 ## Contributing
 
-Issues and PRs welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) and [GUIDE.md](GUIDE.md).
+Issues and PRs welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) and the [OpenCockpit docs](https://opencockpit.dev/en/docs/).
 
 ## License
 

package/README.zh.md

@@ -26,7 +26,7 @@
 
 ---
 
-> **OpenCockpit 是开源的 Claude Code GUI** —— 也是你想接入的任何 Agent 的统一画布。多项目 Claude 会话开箱即用；想用 **OpenAI Codex、DeepSeek、Kimi 或本地 Ollama**？直接新开一个 tab。内置终端、Chrome 自动化、PostgreSQL / MySQL / Redis 气泡、代码评审与斜杠模式 —— 全部本地。
+> **OpenCockpit 是开源的 Claude Code GUI** —— 也是你想接入的任何 Agent 的统一画布。多项目 Claude 会话开箱即用；想用 **Codex、DeepSeek、Kimi 或本地 Ollama**？直接新开一个 tab。内置终端、Chrome 自动化、PostgreSQL / MySQL / Redis 气泡、代码评审与斜杠模式 —— 全部本地。
 
 https://github.com/user-attachments/assets/18f1a5dc-64f3-4ff6-b9fc-9cd08181fbb8
 
@@ -42,7 +42,7 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 
 | 裸用 Claude Code 的痛 | Cockpit 的解法 |
 |---|---|
-| 只能用一个模型 | **5 个引擎按 tab 并排**：Claude（默认）、OpenAI Codex、DeepSeek、Kimi、本地 Ollama —— 每个 tab 独立会话 |
+| 只能用一个模型 | **5 个引擎按 tab 并排**：Claude（默认）、Codex、DeepSeek、Kimi、本地 Ollama —— 每个 tab 独立会话 |
 | 一次只能开一个会话，3+ 项目就乱 | **多项目标签页**、并发 Agent 会话、红点收件箱、桌面通知 |
 | 图片附件麻烦 | 拖拽 / 粘贴图片直接进对话 |
 | "我昨天调的那个 bug 在哪？" | Cmd+K 跨项目会话浏览，会话固定 / 分叉 |
@@ -58,7 +58,7 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 ### 引擎 —— 默认 Claude，也接得住你想要的任何 Agent
 
 - **Claude** *(默认)* —— 完整官方 Agent SDK；`claude` CLI 已配置即零额外设置
-- **OpenAI Codex** —— 直接读 `~/.codex` 配置，聊天 / Shell / 气泡都一样
+- **Codex** —— 直接读 `~/.codex` 配置，聊天 / Shell / 气泡都一样
 - **DeepSeek** —— 通过 Claude SDK 走 Anthropic 兼容端点；粘 Key，选 `v4-pro` 或 `v4-flash`
 - **Kimi** *(Moonshot)* —— 函数调用在聊天里完整渲染，跟 Claude 一样
 - **Ollama** —— 自动拉起守护进程；从聊天头部下拉任意已 pull 的模型；完全离线
@@ -146,7 +146,7 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 
 ### 可选，按引擎
 
-- **OpenAI Codex** —— 执行一次 `codex login` 即可生成 `~/.codex` 配置
+- **Codex** —— 执行一次 `codex login` 即可生成 `~/.codex` 配置
 - **DeepSeek** —— 到 [api-docs.deepseek.com](https://api-docs.deepseek.com/) 申请 API Key，在引擎选择器里粘贴
 - **Kimi (Moonshot)** —— 到 [platform.moonshot.cn](https://platform.moonshot.cn/) 申请 API Key，在引擎选择器里粘贴
 - **Ollama** —— 安装 [ollama.com](https://ollama.com/) 并 `ollama pull <model>`；Cockpit 会自动拉起守护进程
@@ -207,7 +207,7 @@ Next.js 16 · React 19 · TypeScript · TailwindCSS · xterm.js · node-pty · S
 
 ## 贡献
 
-欢迎 Issue 和 PR。详见 [CONTRIBUTING.md](CONTRIBUTING.md) 与 [GUIDE.md](GUIDE.md)。
+欢迎 Issue 和 PR。详见 [CONTRIBUTING.md](CONTRIBUTING.md) 和 [OpenCockpit 文档](https://opencockpit.dev/zh/docs/)。
 
 ## 许可证
 

package/bin/cock-browser.messages.mjs

@@ -0,0 +1,176 @@
+/**
+ * Centralized messages & generic example pool for the browser CLI.
+ *
+ * ALL user-facing text (help / errors / warnings) MUST source examples from
+ * EXAMPLES below. Never inline business-specific selectors or API paths.
+ *
+ * Single source of truth — PR review greps for case-specific leakage:
+ *   grep -E '<known case keywords>' bin/cock-browser.* chrome-extension/messages.js
+ *
+ * The extension side has its own copy (chrome-extension/messages.js); the
+ * subset that the extension generates locally (e.g. STALE_REF_MSG) lives
+ * there. Templates here are CLI-side only.
+ */
+
+// ─────────────────────────────────────────────────────────
+// Generic example pool. DO NOT add case-specific values.
+// ─────────────────────────────────────────────────────────
+
+export const EXAMPLES = Object.freeze({
+  selectorEmail: 'input[name="email"]',
+  selectorPassword: 'input[type="password"]',
+  selectorSubmit: 'button[type="submit"]',
+  selectorAriaSave: 'button[aria-label="Save"]',
+  selectorSearchBox: 'input[role="searchbox"]',
+  selectorStatus: '[role="status"]',
+  selectorContentEditable: '[contenteditable="true"]',
+  selectorLoginForm: 'form#login',
+  textSignIn: 'Sign in',
+  textSave: 'Save',
+  textSubmit: 'Submit',
+  apiUsersMe: '/api/users/me',
+  apiItems: '/api/items',
+  apiItemsId: '/api/items/123',
+});
+
+// ─────────────────────────────────────────────────────────
+// CLI-side error / warn templates
+// (server-side errors come back as data.error and are printed verbatim;
+//  the templates below cover errors the CLI itself originates.)
+// ─────────────────────────────────────────────────────────
+
+export const TIMEOUT_MSG = (timeoutMs, id) =>
+`Timeout: no response within ${timeoutMs}ms.
+  Likely cause: the page is busy (long render / streaming / network).
+  Diagnose:
+    cockpit browser ${id} health                    # is extension alive? (server-side, never blocks)
+    cockpit browser ${id} wait --extension-ready    # wait until responsive
+    cockpit browser ${id} wait --network-idle       # wait for the page to settle
+  If health returns alive but evaluate still hangs, the page itself is blocked.
+  Consider a service-level test if the page is driven by an async LLM/agent flow.`;
+
+export const CONNECT_REFUSED_MSG = (baseUrl) =>
+`Connection refused: Cockpit server not reachable at ${baseUrl}.
+  Recover:
+    1. Start the server: \`cockpit\` (prod, default port 3457) or \`cockpit-dev\` (dev, default 3456)
+    2. Or set COCKPIT_PORT env var if your server runs on a non-default port.`;
+
+// Used by F1.7 post-verify when click / key / submit succeeded per CDP
+// but no observable side-effect happened in the verify window.
+export const CLICK_NO_OP_WARN = (action, id, observed) =>
+`⚠ ${action} succeeded per CDP but no DOM mutation / URL change / network request in ${observed.windowMs}ms.
+  Likely a no-op (no real handler / portal-rendered / framework not listening).
+  Observed: url-changed=${observed.urlChanged} dom-changed=${observed.domChanged} new-requests=${observed.newRequests}
+  Try one of:
+    cockpit browser ${id} evaluate "(() => { const el = document.querySelector('${EXAMPLES.selectorAriaSave}'); el.click(); return el.outerHTML.slice(0,200); })()"
+    cockpit browser ${id} submit --form-selector '${EXAMPLES.selectorLoginForm}'
+    cockpit browser ${id} fetch ${EXAMPLES.apiItems} --method POST --body '{}'`;
+
+// ─────────────────────────────────────────────────────────
+// help fragments (composed in cock-browser.mjs printHelp)
+// ─────────────────────────────────────────────────────────
+
+export const HELP_WHEN_NOT_TO_USE =
+`── When NOT to use this CLI ───────────────────────────
+- Testing LLM-agent driven flows end-to-end: the agent's stochastic tool
+  choice and stop_reason make UI assertions flaky. Prefer a thin runtime
+  script that calls the same middleware / service directly with controlled
+  inputs.
+
+- Pages that stream / re-render for >10s: evaluate calls queue behind page
+  work and time out (~15s default). Run \`wait --extension-ready\` between
+  acts and asserts; if it stays hung, pivot to a service-level test.
+
+- Multi-tab / popup OAuth flows: each browser bubble tracks one tab. Open
+  the secondary tab in its own bubble or stub the OAuth handshake.`;
+
+export const HELP_INTERACTION_BY_SELECTOR = (idForExamples) =>
+`Interaction by selector (preferred — refs go stale on re-render):
+  click <ref|text>                Click by ref (e5#v3), or fall back to:
+  click --text <substr>           Click button/link by visible text or aria-label
+                                    e.g. click --text "${EXAMPLES.textSignIn}"
+  click --selector <css>          Click first element matching CSS
+                                    e.g. click --selector '${EXAMPLES.selectorSubmit}'
+  fill <ref> <value>              Fill via ref, or:
+  fill --selector <css> --value V Fill via native setter (works on React-controlled inputs)
+                                    e.g. fill --selector '${EXAMPLES.selectorEmail}' --value "user@example.com"
+  submit [--form-selector <css>]  form.requestSubmit() — works where key Enter is ignored
+                                    e.g. submit --form-selector '${EXAMPLES.selectorLoginForm}'
+
+  Post-verify (click / key / submit / click-by-text/-selector):
+  --verify-ms <N>                 Window in ms to wait before re-probing page state
+                                  (default 1000). Lower = faster but more false positives
+                                  on slow-rendering React. Higher = more tolerant.
+  --skip-verify (or --no-verify)  Disable post-verify for this command
+                                  (e.g. legit clicks that have no observable side-effect).`;
+
+export const HELP_FETCH =
+`Backend probing (inherits page auth):
+  fetch <url>                     GET, returns JSON or text
+                                    e.g. fetch ${EXAMPLES.apiUsersMe}
+  fetch <url> --method POST --body '{"name":"hello"}'
+  fetch <url> --json $.data.id    Extract via simple JSONPath ($, .key, [N], [*])`;
+
+export const HELP_HEALTH =
+`Diagnostics:
+  health                          Server-side bridge state (never blocks page).
+                                  Returns: ws status, last command timestamp, pending count.
+                                  Use when evaluate times out to distinguish
+                                  "extension dead" vs "page busy".
+  health --deep                   Also probe the page itself (may block if page is busy).`;
+
+export const HELP_WAIT =
+`Wait (synchronisation between act and assert):
+  wait --text <substr>            Wait for substring in body text
+  wait --selector <css> [--state visible|hidden|attached|detached]
+                                  Wait for element to reach state (default: visible)
+                                    e.g. wait --selector '${EXAMPLES.selectorStatus}' --state visible
+  wait --url <pat>                Wait for URL match (substring or *-glob)
+  wait --network-idle [--quiet-ms 500] [--max-request-age-ms 30000]
+                                  Wait until 0 in-flight HTTP requests for quiet-ms.
+                                  Long-running (>max-request-age-ms) are ignored
+                                  so SSE / long-poll don't block.
+                                    e.g. wait --network-idle --quiet-ms 800
+  wait --dom-stable [--quiet-ms 300]
+                                  Wait until MutationObserver sees no changes
+                                  for quiet-ms (useful between act and snapshot).
+  wait --extension-ready [--quiet-ms 500]
+                                  CLI-side poll of \`health\` (never blocks on page).
+                                  Replaces manual \`until evaluate "1+1"\` loops.
+  wait --time <ms>                Sleep <ms> (escape hatch — prefer above)
+  wait --ref <ref>                Wait for ref to still be connected`;
+
+export const HELP_LIFECYCLE =
+`Lifecycle / fixtures:
+  status                          One-line summary: url, title, last console error,
+                                  last failed request, top visible buttons.
+                                  Run after a long gap before another act.
+  reset [--cookies] [--storage] [--cache] [--reload]
+                                  Atomic test-isolation. Combine flags as needed.
+                                    e.g. reset --cookies --storage --reload
+  set --type cookie --name K --value V [--domain D] [--path P] [--secure]
+                                  [--same-site Lax|Strict|None] [--expires <date>]
+  set --type local-storage --name K --value V
+  set --type session-storage --name K --value V
+                                    e.g. set --type cookie --name auth --value abc123 --secure
+                                    e.g. set --type local-storage --name theme --value '"dark"'`;
+
+export const HELP_ASSERT =
+`Assert (act + assert atoms; non-zero exit on failure):
+  assert --selector <css> [--text X | --visible <bool> | --attr "k=v"]
+                                    e.g. assert --selector '${EXAMPLES.selectorStatus}' --text "Saved"
+                                    e.g. assert --selector '${EXAMPLES.selectorSubmit}' --visible true
+                                    e.g. assert --selector '[role="dialog"]' --attr "aria-modal=true"
+  assert --ref <ref> --text/...   Legacy ref-based form (refs go stale; prefer --selector)
+  assert --url <pat>              URL substring or *-glob match
+  assert --title <substr>
+  assert --console-no-errors
+  assert --network --method M --url U --status S [--since <ms>]
+                                  Assert a matching request occurred in networkBuffer.
+                                  Status accepts ints or "2xx"/"4xx"/etc.
+                                    e.g. assert --network --method POST --url ${EXAMPLES.apiItems} --status 200
+  assert --fetch <url> [--fetch-method M] [--body B] [--fetch-status N]
+         [--jsonpath P --equals V | --contains V | --not-contains V]
+                                  Make a fetch and assert response. Inherits auth.
+                                    e.g. assert --fetch ${EXAMPLES.apiItems} --jsonpath '$.count' --equals 5
+                                    e.g. assert --fetch ${EXAMPLES.apiItems} --jsonpath '$[*].id' --contains 42`;