dvalincode 0.23.0 → 0.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (167) hide show
  1. package/README.md +92 -12
  2. package/README.zh-CN.md +75 -12
  3. package/dist/agent/compact.js +9 -1
  4. package/dist/agent/compact.js.map +1 -1
  5. package/dist/agent/loop.d.ts +9 -1
  6. package/dist/agent/loop.js +68 -17
  7. package/dist/agent/loop.js.map +1 -1
  8. package/dist/agent/modes.js +7 -0
  9. package/dist/agent/modes.js.map +1 -1
  10. package/dist/agent/runner.d.ts +2 -1
  11. package/dist/agent/runner.js +180 -32
  12. package/dist/agent/runner.js.map +1 -1
  13. package/dist/agent/session.d.ts +21 -0
  14. package/dist/agent/session.js +71 -33
  15. package/dist/agent/session.js.map +1 -1
  16. package/dist/agent/toolFollowups.d.ts +13 -0
  17. package/dist/agent/toolFollowups.js +50 -0
  18. package/dist/agent/toolFollowups.js.map +1 -0
  19. package/dist/agent/types.d.ts +14 -8
  20. package/dist/agent/types.js.map +1 -1
  21. package/dist/audit/log.d.ts +41 -1
  22. package/dist/audit/log.js.map +1 -1
  23. package/dist/audit/minimize.js +2 -1
  24. package/dist/audit/minimize.js.map +1 -1
  25. package/dist/audit/taps.js +10 -1
  26. package/dist/audit/taps.js.map +1 -1
  27. package/dist/cli.js +2 -0
  28. package/dist/cli.js.map +1 -1
  29. package/dist/commands/checkpoint.d.ts +3 -0
  30. package/dist/commands/checkpoint.js +34 -0
  31. package/dist/commands/checkpoint.js.map +1 -0
  32. package/dist/commands/run.d.ts +1 -0
  33. package/dist/commands/run.js +46 -18
  34. package/dist/commands/run.js.map +1 -1
  35. package/dist/core/checkpoint.d.ts +41 -0
  36. package/dist/core/checkpoint.js +159 -0
  37. package/dist/core/checkpoint.js.map +1 -0
  38. package/dist/core/context.d.ts +7 -0
  39. package/dist/core/context.js +1 -0
  40. package/dist/core/context.js.map +1 -1
  41. package/dist/core/gitRead.d.ts +20 -0
  42. package/dist/core/gitRead.js +97 -0
  43. package/dist/core/gitRead.js.map +1 -0
  44. package/dist/core/ignorefile.d.ts +2 -0
  45. package/dist/core/ignorefile.js +8 -0
  46. package/dist/core/ignorefile.js.map +1 -1
  47. package/dist/core/policy.d.ts +4 -0
  48. package/dist/core/policy.js +8 -6
  49. package/dist/core/policy.js.map +1 -1
  50. package/dist/core/redactSecrets.d.ts +14 -0
  51. package/dist/core/redactSecrets.js +35 -0
  52. package/dist/core/redactSecrets.js.map +1 -0
  53. package/dist/core/trust.d.ts +5 -0
  54. package/dist/core/trust.js +12 -0
  55. package/dist/core/trust.js.map +1 -1
  56. package/dist/core/webEgress.d.ts +66 -0
  57. package/dist/core/webEgress.js +281 -0
  58. package/dist/core/webEgress.js.map +1 -0
  59. package/dist/evidence/compliance.js +1 -1
  60. package/dist/evidence/compliance.js.map +1 -1
  61. package/dist/harness/run.d.ts +4 -0
  62. package/dist/harness/run.js +20 -15
  63. package/dist/harness/run.js.map +1 -1
  64. package/dist/mcp/register.js +4 -1
  65. package/dist/mcp/register.js.map +1 -1
  66. package/dist/mcp/server.d.ts +3 -2
  67. package/dist/mcp/server.js +28 -9
  68. package/dist/mcp/server.js.map +1 -1
  69. package/dist/providers/anthropic.js +16 -1
  70. package/dist/providers/anthropic.js.map +1 -1
  71. package/dist/providers/chatImages.d.ts +21 -0
  72. package/dist/providers/chatImages.js +18 -0
  73. package/dist/providers/chatImages.js.map +1 -0
  74. package/dist/providers/egress.js +7 -0
  75. package/dist/providers/egress.js.map +1 -1
  76. package/dist/providers/openaiCompatible.js +19 -1
  77. package/dist/providers/openaiCompatible.js.map +1 -1
  78. package/dist/providers/retry.js +2 -0
  79. package/dist/providers/retry.js.map +1 -1
  80. package/dist/providers/runBudget.d.ts +11 -0
  81. package/dist/providers/runBudget.js +74 -0
  82. package/dist/providers/runBudget.js.map +1 -0
  83. package/dist/providers/types.d.ts +6 -0
  84. package/dist/server/auth.d.ts +33 -0
  85. package/dist/server/auth.js +53 -0
  86. package/dist/server/auth.js.map +1 -0
  87. package/dist/server/configStore.d.ts +13 -0
  88. package/dist/server/configStore.js +9 -0
  89. package/dist/server/configStore.js.map +1 -1
  90. package/dist/server/folderPicker.d.ts +29 -0
  91. package/dist/server/folderPicker.js +100 -0
  92. package/dist/server/folderPicker.js.map +1 -0
  93. package/dist/server/index.d.ts +5 -0
  94. package/dist/server/index.js +73 -5
  95. package/dist/server/index.js.map +1 -1
  96. package/dist/server/routes/config.js +57 -0
  97. package/dist/server/routes/config.js.map +1 -1
  98. package/dist/server/routes/projects.js +1 -30
  99. package/dist/server/routes/projects.js.map +1 -1
  100. package/dist/server/routes/sessions.js +2 -1
  101. package/dist/server/routes/sessions.js.map +1 -1
  102. package/dist/server/wsHandler.js +23 -12
  103. package/dist/server/wsHandler.js.map +1 -1
  104. package/dist/sessions/journal.d.ts +2 -0
  105. package/dist/sessions/journal.js.map +1 -1
  106. package/dist/sessions/store.d.ts +6 -0
  107. package/dist/sessions/store.js +11 -0
  108. package/dist/sessions/store.js.map +1 -1
  109. package/dist/tools/applyPatch.d.ts +13 -0
  110. package/dist/tools/applyPatch.js +144 -0
  111. package/dist/tools/applyPatch.js.map +1 -0
  112. package/dist/tools/askUser.d.ts +3 -0
  113. package/dist/tools/askUser.js +23 -0
  114. package/dist/tools/askUser.js.map +1 -0
  115. package/dist/tools/checkDiagnostics.d.ts +8 -0
  116. package/dist/tools/checkDiagnostics.js +48 -0
  117. package/dist/tools/checkDiagnostics.js.map +1 -0
  118. package/dist/tools/editFile.d.ts +8 -2
  119. package/dist/tools/editFile.js +95 -26
  120. package/dist/tools/editFile.js.map +1 -1
  121. package/dist/tools/gitBlame.d.ts +11 -0
  122. package/dist/tools/gitBlame.js +43 -0
  123. package/dist/tools/gitBlame.js.map +1 -0
  124. package/dist/tools/gitDiff.js +13 -24
  125. package/dist/tools/gitDiff.js.map +1 -1
  126. package/dist/tools/gitLog.d.ts +11 -0
  127. package/dist/tools/gitLog.js +39 -0
  128. package/dist/tools/gitLog.js.map +1 -0
  129. package/dist/tools/gitShow.d.ts +11 -0
  130. package/dist/tools/gitShow.js +41 -0
  131. package/dist/tools/gitShow.js.map +1 -0
  132. package/dist/tools/gitStatus.js +2 -5
  133. package/dist/tools/gitStatus.js.map +1 -1
  134. package/dist/tools/htmlText.d.ts +19 -0
  135. package/dist/tools/htmlText.js +104 -0
  136. package/dist/tools/htmlText.js.map +1 -0
  137. package/dist/tools/readFile.js +84 -1
  138. package/dist/tools/readFile.js.map +1 -1
  139. package/dist/tools/registry.d.ts +2 -1
  140. package/dist/tools/registry.js +29 -3
  141. package/dist/tools/registry.js.map +1 -1
  142. package/dist/tools/rollbackRun.d.ts +5 -0
  143. package/dist/tools/rollbackRun.js +142 -0
  144. package/dist/tools/rollbackRun.js.map +1 -0
  145. package/dist/tools/runCheck.js +10 -1
  146. package/dist/tools/runCheck.js.map +1 -1
  147. package/dist/tools/searchText.d.ts +10 -0
  148. package/dist/tools/searchText.js +193 -19
  149. package/dist/tools/searchText.js.map +1 -1
  150. package/dist/tools/updatePlan.d.ts +38 -0
  151. package/dist/tools/updatePlan.js +81 -0
  152. package/dist/tools/updatePlan.js.map +1 -0
  153. package/dist/tools/webFetch.d.ts +8 -0
  154. package/dist/tools/webFetch.js +103 -0
  155. package/dist/tools/webFetch.js.map +1 -0
  156. package/dist/tools/webSearch.d.ts +31 -0
  157. package/dist/tools/webSearch.js +244 -0
  158. package/dist/tools/webSearch.js.map +1 -0
  159. package/dist/tools/writeFile.js +4 -1
  160. package/dist/tools/writeFile.js.map +1 -1
  161. package/dist/tui/app.js +22 -1
  162. package/dist/tui/app.js.map +1 -1
  163. package/dist/tui/render.js +7 -1
  164. package/dist/tui/render.js.map +1 -1
  165. package/dist/version.d.ts +1 -1
  166. package/dist/version.js +1 -1
  167. package/package.json +1 -1
package/README.md CHANGED
@@ -9,7 +9,7 @@
9
9
  <p align="center">
10
10
  <a href="https://github.com/arthurpanhku/dvalincode/releases/latest"><img src="https://img.shields.io/github/v/release/arthurpanhku/dvalincode?style=for-the-badge&color=818cf8&label=Release" alt="Release"></a>
11
11
  <a href="https://github.com/arthurpanhku/dvalincode/releases"><img src="https://img.shields.io/github/downloads/arthurpanhku/dvalincode/total?style=for-the-badge&color=blue&label=Downloads" alt="Downloads"></a>
12
- <a href="#-tests"><img src="https://img.shields.io/badge/Tests-584%20%2F%20584%20%E2%9C%93-success?style=for-the-badge" alt="Tests"></a>
12
+ <a href="#-tests"><img src="https://img.shields.io/badge/Tests-819%20%2F%20819%20%E2%9C%93-success?style=for-the-badge" alt="Tests"></a>
13
13
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License"></a>
14
14
  <a href="https://scorecard.dev/viewer/?uri=github.com/arthurpanhku/dvalincode"><img src="https://api.scorecard.dev/projects/github.com/arthurpanhku/dvalincode/badge" alt="OpenSSF Scorecard"></a>
15
15
  <a href="#-quick-install"><img src="https://img.shields.io/badge/Platforms-macOS%20·%20Windows%20·%20Linux-blue?style=for-the-badge" alt="Platforms"></a>
@@ -112,7 +112,7 @@ To gate every commit locally too, add the [pre-commit](https://pre-commit.com) h
112
112
  # .pre-commit-config.yaml
113
113
  repos:
114
114
  - repo: https://github.com/arthurpanhku/dvalincode
115
- rev: v0.22.0 # the hook ships in v0.22.0
115
+ rev: v0.24.0 # the hook ships in v0.22.0 and later
116
116
  hooks:
117
117
  - id: dvalin-scan # or dvalin-scan-installed, to use the CLI you installed
118
118
  ```
@@ -263,7 +263,7 @@ steps:
263
263
  - uses: actions/checkout@v5
264
264
  with:
265
265
  fetch-depth: 0 # so the scan can reach the base commit
266
- - uses: arthurpanhku/dvalincode@v0.22.0
266
+ - uses: arthurpanhku/dvalincode@v0.24.0
267
267
  with:
268
268
  fail-on: high
269
269
  diff: true # only report on what this PR changed
@@ -287,7 +287,7 @@ engines were missing is not the same answer as "no findings" from a complete one
287
287
  If your pipeline produced a fix record, hand it to the same action:
288
288
 
289
289
  ```yaml
290
- - uses: arthurpanhku/dvalincode@v0.22.0
290
+ - uses: arthurpanhku/dvalincode@v0.24.0
291
291
  with:
292
292
  fix-record: fix-record.json
293
293
  ```
@@ -331,7 +331,7 @@ A repair that regressed says so in the same place, and fails the job with it:
331
331
  with:
332
332
  fetch-depth: 0 # the base commit has to be reachable
333
333
  - run: npm ci # the project's checks run on the runner
334
- - uses: arthurpanhku/dvalincode@v0.22.0 # reverify ships in v0.22.0; until it is tagged, pin a main commit SHA
334
+ - uses: arthurpanhku/dvalincode@v0.24.0 # reverify needs v0.22.0 or later
335
335
  with:
336
336
  fix-record: fix-record.json
337
337
  reverify: true
@@ -742,6 +742,77 @@ not claim third-party ISO certification.
742
742
 
743
743
  ---
744
744
 
745
+ ## ⭐ What's New in v0.24.0 — web access, more governed tools, a leaner GUI
746
+
747
+ - **The GUI server requires an access token** — `dvalincode serve` now refuses
748
+ `/api` and `/ws` without the token it mints at each start, and the desktop
749
+ app's embedded server does too from its next build. The printed launch link
750
+ carries the token once, and the page trades it for an HttpOnly cookie; scripts
751
+ send `Authorization: Bearer`. `DVALINCODE_SERVER_TOKEN` keeps one token across
752
+ restarts. A link without it opens an unlock screen.
753
+ - **A leaner GUI** — the web GUI (and the desktop app from its next build) has
754
+ one sidebar for every workspace: New chat (⌘N), the Chat / Code / Dvalin
755
+ switch (Home is now Chat), recent conversations grouped by project, and
756
+ Settings at the bottom. Ask and Collaborate move into the composer's mode
757
+ menu. Controls that did nothing, like the intensity picker and the sidebar
758
+ prompt templates, are gone. Enter no longer sends a message while an input
759
+ method is still composing, the connection comes back after sleep, and the
760
+ light theme renders code legibly.
761
+ - **The agent can search and read the web** — `web_search` uses Tavily, Brave
762
+ Search or your own SearXNG endpoint. `web_fetch` reads a public page as text,
763
+ asks once per site per turn, and refuses private, loopback and metadata
764
+ addresses. Both follow the policy's `network` level and are audited by origin.
765
+ - **More governed tools** — read-only Git history (`git_log`, `git_show`,
766
+ `git_blame`), regex search, ranged reads, batched `edit_file`, multi-file
767
+ `apply_patch`, an `update_plan` checklist, structured `ask_user` questions,
768
+ and image attachments in the GUI. Each passes the same policy and approval
769
+ checks as every other tool.
770
+ - **Secrets stay out of the model** — tool output is filtered for recognizable
771
+ credential formats before it is sent, and `write_file`, `edit_file` and
772
+ `apply_patch` refuse to write the redaction placeholder back over a real key.
773
+ - **Budgets and rollback** — a policy can cap model spend with `maxCostUsd`.
774
+ `dvalincode run --checkpoint` snapshots covered files, so
775
+ `dvalincode rollback <run-id>` can restore them after a headless run, whether
776
+ it succeeded or failed.
777
+ - **Stricter headless runs** — one policy snapshot holds for the whole run,
778
+ unattended runs refuse a policy they cannot apply, and resumes stay in their
779
+ original workspace. `stream-json` consumers should read
780
+ `tool_call.inputSummary` instead of `tool_call.input`.
781
+ - **Release inventories** — every release now ships CycloneDX SBOMs for the CLI
782
+ and the web bundle.
783
+
784
+ ---
785
+
786
+ ## ⭐ What's New in v0.23.0 — connect Dvalin to the agents you already use
787
+
788
+ - **`dvalin agents` finds the coding agents on this machine** — Claude Code,
789
+ Codex, Cursor, VS Code, Gemini CLI and OpenCode, and where Dvalin is already
790
+ connected to each. It only looks: a command on `PATH`, the folder the agent
791
+ creates, or its macOS app. Nothing is run or written.
792
+ - **`dvalin agents connect` wires Dvalin in** — it plans the MCP entry for every
793
+ agent that lacks one and writes only with `--yes`, through the same writers as
794
+ `mcp-install`. That command now also covers Codex (through `codex mcp add`),
795
+ Gemini CLI and OpenCode. [Editors and MCP →](integrations/mcp/)
796
+ - **CC Switch support** — `dvalin agents connect cc-switch` hands Dvalin to
797
+ CC Switch through its own import link, and CC Switch syncs it into every agent
798
+ it manages. `provider set cc-switch` now points at CC Switch's local routing,
799
+ `127.0.0.1:15721`. It used to point at port 3456, which belongs to
800
+ claude-code-router.
801
+ - **Import Codex Security scans** — `dvalin import` reads a sealed Codex
802
+ Security scan directory, checking its manifest, hashes and coverage, or a
803
+ SARIF handoff, into remediation cases. A portable Codex security skill and a
804
+ repository-local plugin marketplace ship alongside.
805
+ [Codex Security interop →](integrations/codex-security/)
806
+ - **MCP clients learn the workflow when they connect** — at initialization the
807
+ server tells an agent to scan uncommitted changes, check coverage before
808
+ trusting zero findings, then inspect a finding and ask for independent
809
+ verification.
810
+ - **A failed turn keeps its work** — a turn that fails part-way now saves what it
811
+ finished, so its session can resume, and the audit log records its iterations
812
+ and tokens.
813
+
814
+ ---
815
+
745
816
  ## ⭐ What's New in v0.14.0 — Dvalin security engineering
746
817
 
747
818
  - **Home unifies Chat and Cowork** — the GUI now has a single Home workspace
@@ -1004,7 +1075,7 @@ source ~/.zshrc # or ~/.bashrc
1004
1075
  dvalincode # interactive terminal agent
1005
1076
  dvalincode dvalin . # white-box security scan (GUI-independent)
1006
1077
  dvalincode serve # start the web GUI, open the browser
1007
- dvalincode serve --host 0.0.0.0 --no-open # host it on a server for remote/browser use
1078
+ dvalincode serve --host 0.0.0.0 --no-open # host it on a server; open the printed ?token= link
1008
1079
  echo "inspect src and summarize" | dvalincode run - --output-format stream-json
1009
1080
  dvalincode mcp-serve # task-level stdio MCP server for external agents
1010
1081
  ```
@@ -1083,15 +1154,17 @@ restarts `DvalinCode.app`. A failed replacement rolls back to the previous app.
1083
1154
 
1084
1155
  ## 🎬 First-time setup
1085
1156
 
1086
- **Terminal (default):** run `dvalincode`. On first launch it walks you through a one-time provider setup (pick a provider, paste your API key, choose a model) and saves it to `~/.dvalincode/config.json`. Then you're at the prompt — type to chat, `/mode` to switch between Chat / Cowork / Code / Dvalin, `/help` for commands. In the GUI, Chat and Cowork are grouped under **Home**.
1157
+ **Terminal (default):** run `dvalincode`. On first launch it walks you through a one-time provider setup (pick a provider, paste your API key, choose a model) and saves it to `~/.dvalincode/config.json`. Then you're at the prompt — type to chat, `/mode` to switch between Chat / Cowork / Code / Dvalin, `/help` for commands. In the GUI, Chat and Cowork are the **Chat** workspace, as Ask and Collaborate in the composer's mode menu.
1087
1158
 
1088
1159
  **Web GUI:** run `dvalincode serve` and:
1089
1160
 
1090
- 1. The server starts on `http://localhost:3000` and your browser opens automatically.
1091
- 2. Click **LLM Configuration** in the sidebar (bottom-left).
1161
+ 1. The server starts on `http://localhost:3000` and opens your browser at the link it prints.
1162
+ 2. Open **Settings** (bottom of the sidebar) → **LLM Providers** → **Configure**.
1092
1163
  3. Pick a provider, paste your API key, choose a model, hit **Save**.
1093
1164
  4. Optional: save the current config as a named profile (e.g. `fast`, `cheap`, `local-ollama`) to switch quickly later.
1094
1165
 
1166
+ **Access token:** the server drives an agent that edits files and runs commands, so it refuses `/api` and `/ws` without its access token. A fresh token is minted on every start and printed in the launch link (`http://localhost:3000/?token=…`); the page trades it for an HttpOnly cookie. Keep the link private. A browser without it shows an unlock screen where you can paste the link or the token; scripts send `Authorization: Bearer <token>`. Set `DVALINCODE_SERVER_TOKEN` (16+ characters of `A–Z a–z 0–9 - _`) to keep one token across restarts. The desktop app handles its token on its own. To use the GUI from another machine (`--host 0.0.0.0`), also set `DVALINCODE_ALLOWED_ORIGINS` to the URL you open it at.
1167
+
1095
1168
  Both share the same config and sessions in `~/.dvalincode/`.
1096
1169
 
1097
1170
  ---
@@ -1105,6 +1178,7 @@ Both share the same config and sessions in `~/.dvalincode/`.
1105
1178
  | **Workspaces** | Open folder / Import Git / Add worktree | Cowork and Code can switch to a local folder, clone a Git project, or create a Git worktree from the UI |
1106
1179
  | **Governance** | OpenSSF Scorecard / ISO 42001 AIMS alignment | Scorecard, CodeQL, Dependabot, pinned Actions, AI impact assessment, risk register, and review cadence are documented under `docs/security/` and `docs/governance/` |
1107
1180
  | **Secure remediation** | Built-in + Semgrep CE + Trivy + OSV-Scanner / SARIF / cases / worktrees / tests / draft PR | Dvalin detects installed engines, normalizes SARIF, scores risk, persists cases, drives evidence-backed fixes, verifies changes, and publishes only after an explicit user action |
1181
+ | **Agent integrations** | `dvalin agents` / MCP server | Finds Claude Code, Codex, Cursor, VS Code, Gemini CLI and OpenCode on this machine and wires Dvalin's MCP server into each, writing only with `--yes`; or hands it to CC Switch. [Editors and MCP →](integrations/mcp/) |
1108
1182
  | **Skills** | Upload / download / built-in security skills | Skills live under `~/.dvalincode/skills`; built-ins guide security scanning and remediation with dedicated agent tools. [Format →](docs/SKILLS.md) |
1109
1183
  | **Composer** | `@` file references | Type `@` for a fuzzy file search; selected files get inlined into the prompt |
1110
1184
  | | `/` slash commands | `/clear` `/compact` `/git` `/plan` `/undo` `/help` |
@@ -1115,8 +1189,11 @@ Both share the same config and sessions in `~/.dvalincode/`.
1115
1189
  | **Agent** | LLM-based context compaction | `/compact` summarises into Goal / Completed / Decisions / Pending |
1116
1190
  | | Persistent undo stack | `/undo [N]` reverses the last N tool calls |
1117
1191
  | | Run Report | Markdown summary per run (files, commands, decisions, test result) — GUI card + `dvalincode report` |
1118
- | | Git awareness | Branch name in topbar; `git_status` tool; git context auto-injected into prompt |
1192
+ | | Git awareness | Branch name in topbar; git context auto-injected into prompt; read-only `git_status`, `git_diff`, `git_log`, `git_show` and `git_blame` tools, also in Ask and Plan |
1193
+ | | Code search and edits | `search_text` takes regular expressions, shows context lines, and skips `.gitignore`d paths; `edit_file` makes several edits or a replace-all in one call; `read_file` reads line ranges of files over 256 KB |
1194
+ | | Task checklist | `update_plan` keeps a step checklist that the desktop app shows as a card; in Code mode the agent is sent back if it stops with steps still open |
1119
1195
  | | `AGENTS.md` project memory | Per-repo persistent instructions, auto-loaded each turn |
1196
+ | | Web search + fetch | `web_search` is opt-in. Choose Exa in Settings → LLM Providers → Web search to search with no key: Exa receives the queries and rate-limits keyless use, and `EXA_API_KEY` or a saved key raises the limit. Alternatively use a Tavily or Brave Search key (`TAVILY_API_KEY` / `BRAVE_API_KEY`) or your own SearXNG endpoint (`DVALINCODE_SEARXNG_URL`). The CLI reads the same choice from `~/.dvalincode/config.json`, where `"webSearch": {"provider": "exa"}` turns Exa on. `web_fetch` needs no key and reads public pages as text, asking once per site per turn. Both obey the policy `network` level and are audited by origin only |
1120
1197
  | **Security** | Tamper-evident audit trail | Hash-chained JSONL per run in `~/.dvalincode/audit/`; `dvalincode report verify` detects edits |
1121
1198
  | | macOS shell sandbox | `sandbox-exec` denies network; allows writes only inside cwd + `/tmp` |
1122
1199
  | | `.dvalincodeignore` | gitignore-style exclusion; blocks `read_file` / `list_files` / `search_text` |
@@ -1175,6 +1252,8 @@ Both share the same config and sessions in `~/.dvalincode/`.
1175
1252
  │ + audit taps: tool_call · file_* · shell_exec │
1176
1253
  │ read_file · list_files · search_text · git_status · │
1177
1254
  │ write_file · edit_file · delete_file · shell │
1255
+ │ web_search · web_fetch │
1256
+ │ git_log · git_show · git_blame · update_plan │
1178
1257
  └─────────────────────────────────────────────────────────┘
1179
1258
  ```
1180
1259
 
@@ -1201,7 +1280,7 @@ RESTORE → COMPACT → COMMAND → BUILD → RUN → SAVE → RESPOND → DONE
1201
1280
  npm test
1202
1281
  ```
1203
1282
 
1204
- **584 core tests · 74 files · all green.** The VS Code extension has a separate
1283
+ **819 core tests · 95 files · all green.** The VS Code extension has a separate
1205
1284
  37-test suite plus one opt-in published-package integration test.
1206
1285
 
1207
1286
  ---
@@ -1251,6 +1330,7 @@ DvalinCode supports any OpenAI-compatible endpoint. Built-in presets, sorted by
1251
1330
  | **OpenRouter** | `google/gemini-2.0-flash-001` | $0.10 / $0.40 per 1M | 200+ models including Claude, Gemini, Llama |
1252
1331
  | **OpenAI** | `gpt-4o-mini` | $0.15 / $0.60 per 1M | Reliable; `o1` available for deep reasoning |
1253
1332
  | **Custom** | — | depends | Any OpenAI-compatible base URL |
1333
+ | **CC Switch** | — | depends | `provider set cc-switch`: requests go through CC Switch's local routing (`127.0.0.1:15721`) to whichever provider its Codex app uses; CC Switch holds the key |
1254
1334
 
1255
1335
  DvalinCode shows the per-session cost live in the topbar — flip between providers in the **LLM Configuration** modal, save named profiles, and compare on the fly.
1256
1336
 
@@ -1323,7 +1403,7 @@ Contributions welcome. The codebase is intentionally small and surgical — see
1323
1403
  ```sh
1324
1404
  git clone https://github.com/arthurpanhku/dvalincode
1325
1405
  cd dvalincode && npm install
1326
- npm test # 584/584 core tests ✅
1406
+ npm test # 819/819 core tests ✅
1327
1407
  npm run typecheck
1328
1408
  ```
1329
1409
 
package/README.zh-CN.md CHANGED
@@ -9,7 +9,7 @@
9
9
  <p align="center">
10
10
  <a href="https://github.com/arthurpanhku/dvalincode/releases/latest"><img src="https://img.shields.io/github/v/release/arthurpanhku/dvalincode?style=for-the-badge&color=818cf8&label=Release" alt="Release"></a>
11
11
  <a href="https://github.com/arthurpanhku/dvalincode/releases"><img src="https://img.shields.io/github/downloads/arthurpanhku/dvalincode/total?style=for-the-badge&color=blue&label=Downloads" alt="Downloads"></a>
12
- <a href="#-测试"><img src="https://img.shields.io/badge/Tests-584%20%2F%20584%20%E2%9C%93-success?style=for-the-badge" alt="Tests"></a>
12
+ <a href="#-测试"><img src="https://img.shields.io/badge/Tests-819%20%2F%20819%20%E2%9C%93-success?style=for-the-badge" alt="Tests"></a>
13
13
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License"></a>
14
14
  <a href="https://scorecard.dev/viewer/?uri=github.com/arthurpanhku/dvalincode"><img src="https://api.scorecard.dev/projects/github.com/arthurpanhku/dvalincode/badge" alt="OpenSSF Scorecard"></a>
15
15
  <a href="#-一行安装"><img src="https://img.shields.io/badge/Platforms-macOS%20·%20Windows%20·%20Linux-blue?style=for-the-badge" alt="Platforms"></a>
@@ -99,7 +99,7 @@ finding 记录为可接受的存量(`.dvalin/baseline.json`),并为 GitHub
99
99
  # .pre-commit-config.yaml
100
100
  repos:
101
101
  - repo: https://github.com/arthurpanhku/dvalincode
102
- rev: v0.22.0 # hook 随 v0.22.0 发布
102
+ rev: v0.24.0 # hook 自 v0.22.0 起提供
103
103
  hooks:
104
104
  - id: dvalin-scan # PATH 上已有 dvalin 时用 dvalin-scan-installed
105
105
  ```
@@ -213,7 +213,7 @@ steps:
213
213
  - uses: actions/checkout@v5
214
214
  with:
215
215
  fetch-depth: 0 # 让扫描能取到 base commit
216
- - uses: arthurpanhku/dvalincode@v0.22.0
216
+ - uses: arthurpanhku/dvalincode@v0.24.0
217
217
  with:
218
218
  fail-on: high
219
219
  diff: true # 只报告这个 PR 改动的部分
@@ -236,7 +236,7 @@ steps:
236
236
  如果你的流水线产出了 fix record,把它交给同一个 action:
237
237
 
238
238
  ```yaml
239
- - uses: arthurpanhku/dvalincode@v0.22.0
239
+ - uses: arthurpanhku/dvalincode@v0.24.0
240
240
  with:
241
241
  fix-record: fix-record.json
242
242
  ```
@@ -276,7 +276,7 @@ runner 会仅凭这个文件本身重新推导它 —— 重算哈希,并从
276
276
  with:
277
277
  fetch-depth: 0 # 需要能拿到 base commit
278
278
  - run: npm ci # 项目自己的检查会在 runner 上执行
279
- - uses: arthurpanhku/dvalincode@v0.22.0 # reverify 随 v0.22.0 发布;打 tag 之前请固定到 main 的某个 commit SHA
279
+ - uses: arthurpanhku/dvalincode@v0.24.0 # reverify 需要 v0.22.0 或更高版本
280
280
  with:
281
281
  fix-record: fix-record.json
282
282
  reverify: true
@@ -625,6 +625,60 @@ DvalinCode 维护项目级治理证据,便于开源用户和企业安全评审
625
625
 
626
626
  ---
627
627
 
628
+ ## ⭐ v0.24.0 新功能 —— 能上网、更多受治理的工具、更精简的 GUI
629
+
630
+ - **GUI 服务端需要访问令牌** —— `dvalincode serve` 现在会拒绝不带令牌的 `/api` 和
631
+ `/ws` 请求,令牌在每次启动时生成;桌面应用的内嵌服务端从下一个版本起也一样。
632
+ 打印出的启动链接带着令牌,页面会把它换成 HttpOnly cookie;脚本用
633
+ `Authorization: Bearer`。设置 `DVALINCODE_SERVER_TOKEN` 可在重启后沿用同一个令牌。
634
+ 不带令牌的链接会打开解锁页。
635
+ - **更精简的 GUI** —— Web GUI(以及下一个版本的桌面应用)所有工作区共用一个侧栏:
636
+ New chat(⌘N)、Chat / Code / Dvalin 切换(Home 改名为 Chat)、按项目分组的最近
637
+ 会话,以及底部的 Settings。Ask 和 Collaborate 移进了输入框的模式菜单。不起作用的
638
+ 控件,比如"强度"选择和侧栏提示词模板,已经去掉。输入法还在选字时按回车不再误发送,
639
+ 电脑睡眠唤醒后连接会自动恢复,浅色主题下代码也清晰可读。
640
+ - **Agent 可以搜索和阅读网页** —— `web_search` 使用 Tavily、Brave Search 或你自己的
641
+ SearXNG;`web_fetch` 把公开网页读成文本,每轮首次访问某个站点时请求批准,并拒绝
642
+ 私有、回环和元数据地址。两者都遵守策略的 `network` 级别,审计只记录来源。
643
+ - **更多受治理的工具** —— 只读 Git 历史(`git_log`、`git_show`、`git_blame`)、正则
644
+ 搜索、按范围读取、批量 `edit_file`、多文件 `apply_patch`、`update_plan` 任务清单、
645
+ 结构化的 `ask_user` 提问,以及 GUI 里的图片附件。它们和其他工具一样,经过同一套
646
+ 策略与审批检查。
647
+ - **密钥不进模型** —— 工具输出发给模型前会过滤可识别的凭据格式;`write_file`、
648
+ `edit_file` 和 `apply_patch` 拒绝把脱敏占位符写回去覆盖真实密钥。
649
+ - **预算与回滚** —— 策略可以用 `maxCostUsd` 限制模型花费。`dvalincode run --checkpoint`
650
+ 会给覆盖范围内的文件做快照,无头运行无论成功还是失败,都能用
651
+ `dvalincode rollback <run-id>` 恢复。
652
+ - **更严格的无头运行** —— 整个运行使用同一份策略快照;无人值守的运行若无法应用已配置
653
+ 的策略会直接拒绝;恢复的会话只能回到原来的工作区。`stream-json` 的使用方请改读
654
+ `tool_call.inputSummary`,不再是 `tool_call.input`。
655
+ - **发布清单** —— 每个版本现在都附带 CLI 和 Web bundle 的 CycloneDX SBOM。
656
+
657
+ ---
658
+
659
+ ## ⭐ v0.23.0 新功能 —— 把 Dvalin 接进你已经在用的 agent
660
+
661
+ - **`dvalin agents` 找出本机的 coding agent** —— Claude Code、Codex、Cursor、
662
+ VS Code、Gemini CLI 和 OpenCode,以及 Dvalin 已经接在了哪里。它只看不动:看
663
+ `PATH` 上的命令、agent 创建的目录或 macOS 应用,不运行也不写入任何东西。
664
+ - **`dvalin agents connect` 一键接入** —— 为还没有 Dvalin 的 agent 列出 MCP 接入
665
+ 计划,加 `--yes` 才写入,写入逻辑和 `mcp-install` 相同。`mcp-install` 现在也支持
666
+ Codex(通过 `codex mcp add`)、Gemini CLI 和 OpenCode。[编辑器与 MCP →](integrations/mcp/)
667
+ - **支持 CC Switch** —— `dvalin agents connect cc-switch` 通过 CC Switch 自己的导入
668
+ 链接把 Dvalin 交给它,再由它同步进所管理的每个 agent。`provider set cc-switch`
669
+ 现在指向 CC Switch 的本地路由 `127.0.0.1:15721`;原来的 3456 其实是
670
+ claude-code-router 的端口。
671
+ - **导入 Codex Security 扫描结果** —— `dvalin import` 读取密封的 Codex Security
672
+ 扫描目录(校验 manifest、哈希和覆盖范围)或 SARIF 交接文件,转成 remediation
673
+ case;同时提供可移植的 Codex 安全 skill 和仓库内插件 marketplace。
674
+ [Codex Security 互操作 →](integrations/codex-security/)
675
+ - **MCP 客户端一连上就知道流程** —— server 在初始化时告诉 agent:先扫描未提交的
676
+ 改动,把零发现当作干净之前先确认覆盖范围,再查看单条发现并请求独立验证。
677
+ - **失败的回合不再丢工作** —— 中途失败的回合会保存已完成的部分,会话可以接着
678
+ 继续;审计日志也会记录它的迭代次数和 token。
679
+
680
+ ---
681
+
628
682
  ## ⭐ v0.14.0 新功能 —— Dvalin 安全工程
629
683
 
630
684
  - **Home 合并 Chat 与 Cowork** —— Home 统一提供只读 Ask 与审批式 Collaborate,
@@ -844,7 +898,7 @@ dvalincode # 交互式终端代理
844
898
  dvalincode dvalin . # 白盒安全扫描
845
899
  dvalincode dvalin . --fix --verify --draft-pr # 隔离修复、验证并创建草稿 PR
846
900
  dvalincode serve # 启动 Web GUI 并打开浏览器
847
- dvalincode serve --host 0.0.0.0 --no-open # 部署到服务器,供远程/浏览器访问
901
+ dvalincode serve --host 0.0.0.0 --no-open # 部署到服务器;打开打印出的 ?token= 链接
848
902
  echo "检查 src 并总结" | dvalincode run - --output-format stream-json
849
903
  dvalincode mcp-serve # 供外部 Agent 调用的任务级 stdio MCP 服务
850
904
  ```
@@ -909,15 +963,17 @@ dvalincode update # 下载、校验并安装最新版本
909
963
 
910
964
  ## 🎬 首次配置
911
965
 
912
- **终端(默认):** 运行 `dvalincode`。首次启动会引导你完成一次性的 Provider 配置(选择 Provider、粘贴 API Key、选择模型),保存到 `~/.dvalincode/config.json`。随后即进入对话提示符 —— 直接输入即可对话,`/mode` 切换 Home / Code / Dvalin,`/help` 查看命令。
966
+ **终端(默认):** 运行 `dvalincode`。首次启动会引导你完成一次性的 Provider 配置(选择 Provider、粘贴 API Key、选择模型),保存到 `~/.dvalincode/config.json`。随后即进入对话提示符 —— 直接输入即可对话,`/mode` 在 Chat / Cowork / Code / Dvalin 之间切换,`/help` 查看命令。在 GUI 中,Chat 和 Cowork 合为 **Chat** 工作区,就是输入框模式菜单里的 Ask 和 Collaborate。
913
967
 
914
968
  **Web GUI:** 运行 `dvalincode serve`:
915
969
 
916
- 1. 服务在 `http://localhost:3000` 启动,浏览器自动打开。
917
- 2. 点击侧边栏底部的 **LLM Configuration**。
970
+ 1. 服务在 `http://localhost:3000` 启动,并用它打印出的链接自动打开浏览器。
971
+ 2. 打开侧边栏底部的 **Settings** → **LLM Providers** → **Configure**。
918
972
  3. 选择 Provider、粘贴 API Key、选择模型、保存。
919
973
  4. 可选:将当前配置保存为命名 Profile(如 `fast`、`cheap`、`local-ollama`),日后一键切换。
920
974
 
975
+ **访问令牌:** 服务端驱动的 Agent 能改文件、跑命令,所以没有访问令牌的 `/api` 和 `/ws` 请求一律拒绝。每次启动都会生成新令牌,放在打印出的启动链接里(`http://localhost:3000/?token=…`),页面会把它换成 HttpOnly cookie。这个链接请勿外传。没有令牌的浏览器会看到解锁页,可以粘贴链接或令牌;脚本用 `Authorization: Bearer <token>`。设置 `DVALINCODE_SERVER_TOKEN`(至少 16 个字符,仅限 `A–Z a–z 0–9 - _`)可在重启后沿用同一令牌。桌面应用会自动处理令牌。若要从另一台机器使用 GUI(`--host 0.0.0.0`),还需把 `DVALINCODE_ALLOWED_ORIGINS` 设为你在浏览器中打开的地址。
976
+
921
977
  两种方式共享 `~/.dvalincode/` 下的同一份配置与 Session。
922
978
 
923
979
  ---
@@ -931,6 +987,7 @@ dvalincode update # 下载、校验并安装最新版本
931
987
  | **工作区** | 打开文件夹 / 导入 Git / 添加 worktree | Home、Code 与 Dvalin 可使用本地文件夹、Git 项目和隔离 remediation worktree |
932
988
  | **治理** | OpenSSF Scorecard / ISO 42001 AIMS 对齐 | Scorecard、CodeQL、Dependabot、固定 SHA 的 Actions、AI 影响评估、风险登记和审查节奏记录在 `docs/security/` 与 `docs/governance/` |
933
989
  | **安全修复** | 内置 + Semgrep CE + Trivy + OSV-Scanner / SARIF / 测试 / Draft PR | Dvalin 检测已安装引擎、统一 SARIF、风险评分、驱动证据化修复、验证变更,并只在用户显式操作后发布 Draft PR |
990
+ | **Agent 集成** | `dvalin agents` / MCP server | 找出这台机器上的 Claude Code、Codex、Cursor、VS Code、Gemini CLI 和 OpenCode,把 Dvalin 的 MCP server 接进每一个,加 `--yes` 才写入;也可以交给 CC Switch 同步。[编辑器与 MCP →](integrations/mcp/) |
934
991
  | **Skills** | 上传 / 下载 / 内置安全 skills | Skills 保存在 `~/.dvalincode/skills`;内置 skills 用专门的 agent tools 引导安全扫描与修复。[格式 →](docs/SKILLS.md) |
935
992
  | **输入框** | `@` 文件引用 | 输入 `@` 触发模糊文件搜索,选中文件自动插入到 prompt |
936
993
  | | `/` 斜杠命令 | `/clear` `/compact` `/git` `/plan` `/undo` `/help` |
@@ -941,8 +998,11 @@ dvalincode update # 下载、校验并安装最新版本
941
998
  | **Agent** | LLM 上下文压缩 | `/compact` 将历史压缩为 目标/已完成/决策/待办 结构化摘要 |
942
999
  | | 持久化 Undo 栈 | `/undo [N]` 撤销最近 N 个工具调用 |
943
1000
  | | Run Report | 每次运行的 Markdown 摘要(文件、命令、决策、测试结果)—— GUI 卡片 + `dvalincode report` |
944
- | | Git 感知 | 顶栏显示分支名;`git_status` 工具;Git 上下文自动注入 prompt |
1001
+ | | Git 感知 | 顶栏显示分支名;Git 上下文自动注入 prompt;只读的 `git_status`、`git_diff`、`git_log`、`git_show`、`git_blame` 工具,在 Ask 和 Plan 中同样可用 |
1002
+ | | 代码搜索与编辑 | `search_text` 支持正则表达式、显示上下文行,并跳过 `.gitignore` 忽略的路径;`edit_file` 一次调用即可完成多处编辑或全部替换;`read_file` 可按行范围读取超过 256 KB 的文件 |
1003
+ | | 任务清单 | `update_plan` 维护一份步骤清单,桌面应用以卡片形式展示;在 Code 模式下,若 Agent 在仍有未完成步骤时停下,会被要求继续 |
945
1004
  | | `AGENTS.md` 项目记忆 | 每个仓库的持久指令,每轮对话自动加载 |
1005
+ | | 联网搜索 + 网页读取 | `web_search` 需要用户主动开启:在 设置 → LLM Providers → Web search 里选 Exa,不需要密钥就能搜索,但搜索词会发给 Exa,没有密钥时 Exa 会限制频率,配置 `EXA_API_KEY` 或在设置里保存密钥可以提高额度;也可以用 Tavily 或 Brave Search 密钥(`TAVILY_API_KEY` / `BRAVE_API_KEY`),或你自己的 SearXNG 地址(`DVALINCODE_SEARXNG_URL`)。CLI 读取 `~/.dvalincode/config.json` 里的同一份选择,写入 `"webSearch": {"provider": "exa"}` 即可开启 Exa。`web_fetch` 无需密钥,把公开网页读取为文本,每轮首次访问某个站点时请求批准。两者都遵守策略的 `network` 级别,审计只记录来源(origin) |
946
1006
  | **安全** | 防篡改审计日志 | 每次运行在 `~/.dvalincode/audit/` 生成哈希链 JSONL;`dvalincode report verify` 可检测修改 |
947
1007
  | | macOS Shell 沙箱 | `sandbox-exec` 拒绝网络;写入仅限 cwd 与 `/tmp` |
948
1008
  | | `.dvalincodeignore` | 类 gitignore 排除;阻止 `read_file` / `list_files` / `search_text` |
@@ -1003,6 +1063,8 @@ dvalincode update # 下载、校验并安装最新版本
1003
1063
  │ + 审计埋点:tool_call · file_* · shell_exec │
1004
1064
  │ read_file · list_files · search_text · git_status · │
1005
1065
  │ write_file · edit_file · delete_file · shell │
1066
+ │ web_search · web_fetch │
1067
+ │ git_log · git_show · git_blame · update_plan │
1006
1068
  └─────────────────────────────────────────────────────────┘
1007
1069
  ```
1008
1070
 
@@ -1029,7 +1091,7 @@ RESTORE → COMPACT → COMMAND → BUILD → RUN → SAVE → RESPOND → DONE
1029
1091
  npm test
1030
1092
  ```
1031
1093
 
1032
- **584 个核心测试 · 74 个文件 · 全部通过。** VS Code 扩展另有 37 个测试,
1094
+ **819 个核心测试 · 95 个文件 · 全部通过。** VS Code 扩展另有 37 个测试,
1033
1095
  以及一个可选的已发布包集成测试。
1034
1096
 
1035
1097
  ---
@@ -1079,6 +1141,7 @@ DvalinCode 支持任意 OpenAI 兼容端点。内置预设,按价格排序:
1079
1141
  | **OpenRouter** | `google/gemini-2.0-flash-001` | $0.10 / $0.40 每 1M | 200+ 模型,包括 Claude、Gemini、Llama |
1080
1142
  | **OpenAI** | `gpt-4o-mini` | $0.15 / $0.60 每 1M | 可靠;`o1` 用于深度推理 |
1081
1143
  | **Custom** | — | 取决于服务方 | 任意 OpenAI 兼容 base URL |
1144
+ | **CC Switch** | — | 取决于服务方 | `provider set cc-switch`:请求经 CC Switch 的本地路由(`127.0.0.1:15721`)转给它的 Codex 当前使用的服务商;key 由 CC Switch 保管 |
1082
1145
 
1083
1146
  DvalinCode 顶栏实时显示本 session 的费用 —— 在 **LLM Configuration** 中切换 Provider、保存命名 Profile、实时比较。
1084
1147
 
@@ -1157,7 +1220,7 @@ Linux 与 macOS 命令通过 <code>/bin/sh</code> 执行;Windows 命令通过
1157
1220
  ```sh
1158
1221
  git clone https://github.com/arthurpanhku/dvalincode
1159
1222
  cd dvalincode && npm install
1160
- npm test # 584/584 核心测试 ✅
1223
+ npm test # 819/819 核心测试 ✅
1161
1224
  npm run typecheck
1162
1225
  ```
1163
1226
 
@@ -1,3 +1,4 @@
1
+ import { redactToolText } from '../core/redactSecrets.js';
1
2
  export function estimateTokens(messages) {
2
3
  const total = messages.reduce((acc, m) => acc + roughTokens(m.content ?? '') + roughTokens(JSON.stringify(m.tool_calls ?? [])), 0);
3
4
  return Math.ceil(total);
@@ -35,7 +36,14 @@ const COMPACT_PROMPT = `Summarize this coding session using exactly this format:
35
36
 
36
37
  Be concise. Each bullet is one line. Omit sections with no content.`;
37
38
  export async function summarizeWithLLM(messages, provider, runtime, signal) {
38
- const transcript = compactTranscript(messages);
39
+ const transcript = compactTranscript(messages.map(message => {
40
+ if (message.role !== 'tool')
41
+ return message;
42
+ const redacted = redactToolText(message.content);
43
+ if (redacted.count)
44
+ runtime?.audit?.append({ type: 'tool_redaction', tool: message.name ?? 'history', count: redacted.count });
45
+ return { ...message, content: redacted.text };
46
+ }));
39
47
  const resp = await provider.chat({
40
48
  messages: [{ role: 'user', content: `${COMPACT_PROMPT}\n\n---\n${transcript}` }],
41
49
  maxTokens: 1_500,
@@ -1 +1 @@
1
- {"version":3,"file":"compact.js","sourceRoot":"","sources":["../../src/agent/compact.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"compact.js","sourceRoot":"","sources":["../../src/agent/compact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,MAAM,UAAU,cAAc,CAAC,QAAuB;IACpD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAC3B,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,EAChG,CAAC,CACF,CAAC;IACF,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,qBAAqB,CACnC,QAAuB,EACvB,YAAoB,EACpB,KAAK,GAAc,EAAE;IAErB,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;YAAE,QAAQ,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;AACjD,CAAC;AAED,MAAM,cAAc,GAAG;;;;;;;;;;;;;;oEAc6C,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAuB,EACvB,QAAyB,EACzB,OAAgC,EAChC,MAAoB;IAEpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAC1D,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,OAAO,CAAC;QAC5C,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,QAAQ,CAAC,KAAK;YAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/H,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC,CAAC;IAEJ,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;QAC/B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,YAAY,UAAU,EAAE,EAAE,CAAC;QAChF,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,GAAG;QAChB,OAAO;QACP,MAAM;KACP,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,QAAuB,EAAE,QAAQ,GAAG,MAAM;IACnE,MAAM,OAAO,GAAG,QAAQ;QACtB,0EAA0E;QAC1E,yEAAyE;SACxE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;SACpF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,KAAK,QAAQ;YAC/B,CAAC,CAAC,0BAA0B;YAC5B,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM;gBACjB,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW;oBACtB,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEL,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAC1B,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,QAAQ;YAAE,MAAM;QAC9C,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO;QACL,cAAc,CAAC,OAAO,CAAC;QACvB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wDAAwD,EAAE;QACnF,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,kEAAkE,EAAE;KACnG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,6BAA6B,OAAO,EAAE,EAAE,CAAC;AAC7E,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,GAAG,IAAI,uHAAuH;KACxI,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAuB,EAAE,MAAc;IAChE,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,IAAI,IAAI,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;QACvC,IAAI,IAAI,GAAG,MAAM;YAAE,MAAM;QACzB,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,WAAW;YAAE,KAAK,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}
@@ -1,3 +1,5 @@
1
+ import { type CheckpointStatus } from '../core/checkpoint.js';
2
+ import type { ChatImage } from '../providers/chatImages.js';
1
3
  import { type TurnConfig, type LoopResult, type SlashCommand, type AgentEventHandler } from './types.js';
2
4
  import { type RunOrigin } from '../audit/log.js';
3
5
  import { type LoadedPolicy } from '../core/policy.js';
@@ -19,6 +21,12 @@ export type AuditOptions = {
19
21
  sessionId?: string;
20
22
  /** Surface that initiated the run. */
21
23
  origin?: RunOrigin;
24
+ /** Capture covered workspace files for run-level rollback. */
25
+ checkpoint?: boolean;
26
+ /** Fired after checkpoint finalization, including on a failed turn. */
27
+ onCheckpoint?: (status: CheckpointStatus) => void;
28
+ /** Discover tools with the active run's policy and audit sink. */
29
+ initializeTools?: (context: DvalinContext) => Promise<void>;
22
30
  /** Fired after run_start has been appended and before any provider request. */
23
31
  onRunStart?: (details: {
24
32
  runId: string;
@@ -45,7 +53,7 @@ export declare class AgentLoop {
45
53
  private auditOptions;
46
54
  constructor(options: AgentLoopOptions);
47
55
  /** Process a user message through the full state machine */
48
- processMessage(userMessage: string, history: ChatMessage[], onEvent?: AgentEventHandler, signal?: AbortSignal): Promise<LoopResult>;
56
+ processMessage(userMessage: string, history: ChatMessage[], onEvent?: AgentEventHandler, signal?: AbortSignal, images?: ChatImage[]): Promise<LoopResult>;
49
57
  /** Emit the terminal run_end event, folding in any best-effort write warnings. */
50
58
  private finishRun;
51
59
  /**