@sayknow-cli/coding-agent 0.7.10 → 0.7.12

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 (425) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/dist/types/async/result-formatting.d.ts +2 -0
  3. package/dist/types/capability/fs.d.ts +22 -3
  4. package/dist/types/capability/mcp.d.ts +2 -0
  5. package/dist/types/cli/append-system-prompt.d.ts +6 -0
  6. package/dist/types/cli/update-cli.d.ts +3 -0
  7. package/dist/types/commands/contribution-prep.d.ts +0 -3
  8. package/dist/types/commands/migrate.d.ts +1 -1
  9. package/dist/types/commands/sdk.d.ts +9 -0
  10. package/dist/types/commit/changelog/index.d.ts +1 -0
  11. package/dist/types/config/settings-schema.d.ts +14 -0
  12. package/dist/types/config/settings.d.ts +7 -1
  13. package/dist/types/coordinator-mcp/session-reaper.d.ts +5 -0
  14. package/dist/types/cursor-delete-path.d.ts +1 -0
  15. package/dist/types/cursor-mcp-name.d.ts +8 -0
  16. package/dist/types/dap/config.d.ts +8 -4
  17. package/dist/types/dap/session.d.ts +11 -2
  18. package/dist/types/debug/report-bundle-parent.d.ts +2 -0
  19. package/dist/types/debug/system-info.d.ts +6 -1
  20. package/dist/types/discovery/helpers.d.ts +11 -3
  21. package/dist/types/discovery/mcp-json.d.ts +1 -0
  22. package/dist/types/edit/file-read-cache.d.ts +4 -0
  23. package/dist/types/edit/modes/patch.d.ts +14 -0
  24. package/dist/types/edit/modes/replace.d.ts +8 -0
  25. package/dist/types/eval/py/runtime.d.ts +9 -0
  26. package/dist/types/exa/mcp-client.d.ts +11 -6
  27. package/dist/types/exec/bash-executor.d.ts +18 -1
  28. package/dist/types/export/html/css-color.d.ts +2 -0
  29. package/dist/types/export/html/html-export-destination.d.ts +2 -0
  30. package/dist/types/export/html/template.generated.d.ts +1 -1
  31. package/dist/types/extensibility/custom-tools/loader.d.ts +3 -2
  32. package/dist/types/extensibility/custom-tools/types.d.ts +3 -1
  33. package/dist/types/extensibility/plugins/marketplace/cache.d.ts +2 -0
  34. package/dist/types/extensibility/plugins/plugin-link-path.d.ts +2 -0
  35. package/dist/types/goals/runtime.d.ts +6 -0
  36. package/dist/types/harness-control-plane/receipt-spool.d.ts +4 -0
  37. package/dist/types/hindsight/content.d.ts +5 -6
  38. package/dist/types/internal-urls/skill-path.d.ts +1 -0
  39. package/dist/types/internal-urls/types.d.ts +2 -0
  40. package/dist/types/lsp/clients/swiftlint-client.d.ts +0 -4
  41. package/dist/types/lsp/config.d.ts +8 -5
  42. package/dist/types/lsp/workspace-path.d.ts +1 -0
  43. package/dist/types/migrate/adapters/codex.d.ts +2 -1
  44. package/dist/types/migrate/adapters/index.d.ts +10 -1
  45. package/dist/types/migrate/executor.d.ts +3 -1
  46. package/dist/types/migrate/types.d.ts +15 -3
  47. package/dist/types/modes/components/custom-editor.d.ts +6 -0
  48. package/dist/types/modes/components/extensions/state-manager.d.ts +4 -3
  49. package/dist/types/modes/components/model-selector.d.ts +46 -0
  50. package/dist/types/modes/controllers/input-controller.d.ts +9 -0
  51. package/dist/types/modes/interactive-mode.d.ts +1 -0
  52. package/dist/types/modes/utils/macos-option-forwarding.d.ts +17 -0
  53. package/dist/types/runtime-mcp/content-limits.d.ts +4 -0
  54. package/dist/types/runtime-mcp/manager.d.ts +9 -1
  55. package/dist/types/runtime-mcp/mcp-redirect.d.ts +9 -0
  56. package/dist/types/runtime-mcp/oauth-public-url.d.ts +1 -0
  57. package/dist/types/runtime-mcp/plugin-mcp-name-filter.d.ts +22 -0
  58. package/dist/types/runtime-mcp/plugin-network-boundary.d.ts +1 -0
  59. package/dist/types/runtime-mcp/project-host-values.d.ts +33 -0
  60. package/dist/types/runtime-mcp/smithery-registry.d.ts +24 -0
  61. package/dist/types/runtime-mcp/tool-bridge.d.ts +4 -0
  62. package/dist/types/runtime-mcp/types.d.ts +6 -0
  63. package/dist/types/sdk/broker/ensure.d.ts +2 -0
  64. package/dist/types/sdk/broker/lifecycle-ledger.d.ts +5 -1
  65. package/dist/types/sdk/broker/runtime.d.ts +1 -1
  66. package/dist/types/sdk/bus/chat-daemon-control.d.ts +3 -1
  67. package/dist/types/sdk/bus/telegram-daemon-contract.d.ts +3 -1
  68. package/dist/types/sdk/bus/telegram-daemon.d.ts +1 -0
  69. package/dist/types/sdk/host/events.d.ts +4 -0
  70. package/dist/types/session/agent-session.d.ts +20 -1
  71. package/dist/types/session/messages.d.ts +5 -1
  72. package/dist/types/session/session-manager.d.ts +13 -0
  73. package/dist/types/session/session-storage.d.ts +8 -0
  74. package/dist/types/session/streaming-output.d.ts +11 -0
  75. package/dist/types/session-import/redact.d.ts +1 -1
  76. package/dist/types/skc-runtime/managed-owner-admission.d.ts +3 -0
  77. package/dist/types/skc-runtime/psmux-detect.d.ts +5 -4
  78. package/dist/types/skc-runtime/ralplan-runtime.d.ts +5 -0
  79. package/dist/types/skc-runtime/sidecar-bootstrap-env.d.ts +6 -0
  80. package/dist/types/skc-runtime/state-writer.d.ts +4 -1
  81. package/dist/types/skc-runtime/tmux-sessions.d.ts +24 -0
  82. package/dist/types/skc-runtime/ultragoal-runtime.d.ts +4 -0
  83. package/dist/types/skill-state/workflow-mutation-guard.d.ts +20 -1
  84. package/dist/types/slash-commands/helpers/mcp.d.ts +5 -0
  85. package/dist/types/ssh/ssh-executor.d.ts +3 -1
  86. package/dist/types/system-prompt.d.ts +5 -2
  87. package/dist/types/task/executor.d.ts +17 -3
  88. package/dist/types/task/isolation-dir.d.ts +26 -0
  89. package/dist/types/task/role-body.d.ts +11 -0
  90. package/dist/types/task/token-log-mode.test.d.ts +1 -0
  91. package/dist/types/tools/ask.d.ts +77 -254
  92. package/dist/types/tools/ast-edit-write-path.d.ts +23 -0
  93. package/dist/types/tools/atomic-file-write.d.ts +74 -0
  94. package/dist/types/tools/auto-generated-guard.d.ts +5 -2
  95. package/dist/types/tools/bash-allowed-prefixes.d.ts +16 -0
  96. package/dist/types/tools/bash-interactive.d.ts +2 -0
  97. package/dist/types/tools/bash-skill-urls.d.ts +5 -1
  98. package/dist/types/tools/bash.d.ts +1 -0
  99. package/dist/types/tools/browser/cdp-url.d.ts +2 -0
  100. package/dist/types/tools/browser/tab-worker.d.ts +2 -0
  101. package/dist/types/tools/debug.d.ts +2 -2
  102. package/dist/types/tools/explicit-artifact.d.ts +8 -0
  103. package/dist/types/tools/fetch.d.ts +7 -4
  104. package/dist/types/tools/github-side-effect.d.ts +22 -0
  105. package/dist/types/tools/index.d.ts +3 -0
  106. package/dist/types/tools/monitor-mutation.d.ts +9 -0
  107. package/dist/types/tools/recipe/index.d.ts +2 -0
  108. package/dist/types/tools/recipe/recipe-guard.d.ts +7 -0
  109. package/dist/types/tools/restricted-cwd.d.ts +1 -0
  110. package/dist/types/tools/reverse-engineer.d.ts +81 -0
  111. package/dist/types/tools/search-tool-bm25.d.ts +2 -0
  112. package/dist/types/tools/tmux-self-injection-guard.d.ts +17 -0
  113. package/dist/types/tools/untrusted-content.d.ts +12 -0
  114. package/dist/types/utils/file-mentions.d.ts +5 -0
  115. package/dist/types/utils/open.d.ts +0 -1
  116. package/dist/types/utils/shell-snapshot.d.ts +2 -0
  117. package/dist/types/utils/title-generator.d.ts +12 -2
  118. package/dist/types/utils/tools-checksum.d.ts +7 -0
  119. package/dist/types/utils/xml-escape.d.ts +2 -0
  120. package/dist/types/web/scrapers/types.d.ts +8 -1
  121. package/dist/types/web/search/providers/codex.d.ts +6 -7
  122. package/dist/types/web/search/providers/insane.d.ts +7 -1
  123. package/dist/types/web/search/providers/kimi.d.ts +2 -0
  124. package/dist/types/web/search/providers/searxng.d.ts +7 -0
  125. package/dist/types/web/search/providers/xai.d.ts +2 -0
  126. package/package.json +7 -7
  127. package/scripts/generate-sdk-operation-inventory.ts +4 -0
  128. package/src/async/job-manager.ts +23 -9
  129. package/src/async/result-formatting.ts +40 -0
  130. package/src/capability/fs.ts +78 -11
  131. package/src/capability/mcp.ts +2 -0
  132. package/src/cli/append-system-prompt.ts +12 -0
  133. package/src/cli/auth-broker-cli.ts +22 -12
  134. package/src/cli/config-cli.ts +8 -18
  135. package/src/cli/migrate-cli.ts +7 -5
  136. package/src/cli/ssh-cli.ts +6 -3
  137. package/src/cli/stats-cli.ts +9 -4
  138. package/src/cli/update-cli.ts +42 -0
  139. package/src/cli/web-search-cli.ts +9 -3
  140. package/src/cli.ts +5 -9
  141. package/src/commands/commit.ts +2 -2
  142. package/src/commands/contribution-prep.ts +1 -3
  143. package/src/commands/harness.ts +25 -15
  144. package/src/commands/launch.ts +1 -1
  145. package/src/commands/migrate.ts +3 -3
  146. package/src/commands/sdk.ts +115 -14
  147. package/src/commands/ultragoal.ts +14 -8
  148. package/src/commit/agentic/agent.ts +6 -6
  149. package/src/commit/analysis/conventional.ts +14 -5
  150. package/src/commit/changelog/index.ts +39 -1
  151. package/src/commit/message.ts +10 -3
  152. package/src/config/config-file.ts +106 -3
  153. package/src/config/keybindings.ts +154 -7
  154. package/src/config/mcp-schema.json +4 -0
  155. package/src/config/model-registry.ts +10 -2
  156. package/src/config/settings-schema.ts +18 -0
  157. package/src/config/settings.ts +32 -4
  158. package/src/coordinator-mcp/policy.ts +14 -4
  159. package/src/coordinator-mcp/server.ts +44 -4
  160. package/src/coordinator-mcp/session-reaper.ts +9 -1
  161. package/src/cursor-delete-path.ts +10 -0
  162. package/src/cursor-mcp-name.ts +15 -0
  163. package/src/cursor.ts +13 -2
  164. package/src/dap/client.ts +9 -2
  165. package/src/dap/config.ts +33 -13
  166. package/src/dap/defaults.json +1 -1
  167. package/src/dap/session.ts +161 -36
  168. package/src/debug/crash-diagnostics.ts +89 -6
  169. package/src/debug/report-bundle-parent.ts +22 -0
  170. package/src/debug/report-bundle.ts +100 -3
  171. package/src/debug/system-info.ts +21 -4
  172. package/src/defaults/skc/extensions/grok-cli-vendor/src/shared/base-url.ts +21 -7
  173. package/src/defaults/skc/skills/deep-interview/SKILL.md +1 -1
  174. package/src/discovery/agents-md.ts +3 -2
  175. package/src/discovery/agents.ts +3 -2
  176. package/src/discovery/builtin.ts +21 -11
  177. package/src/discovery/claude.ts +5 -4
  178. package/src/discovery/cline.ts +2 -2
  179. package/src/discovery/codex.ts +6 -5
  180. package/src/discovery/cursor.ts +11 -2
  181. package/src/discovery/gemini.ts +4 -3
  182. package/src/discovery/github.ts +2 -2
  183. package/src/discovery/helpers.ts +51 -11
  184. package/src/discovery/mcp-json.ts +28 -12
  185. package/src/discovery/opencode.ts +2 -1
  186. package/src/discovery/ssh.ts +11 -6
  187. package/src/discovery/substitute-plugin-root.ts +3 -1
  188. package/src/discovery/vscode.ts +3 -3
  189. package/src/edit/apply-patch/index.ts +12 -1
  190. package/src/edit/file-read-cache.ts +24 -6
  191. package/src/edit/index.ts +90 -20
  192. package/src/edit/modes/patch.ts +215 -9
  193. package/src/edit/modes/replace.ts +141 -0
  194. package/src/eval/js/context-manager.ts +29 -3
  195. package/src/eval/js/worker-entry.ts +51 -18
  196. package/src/eval/py/runner.py +144 -5
  197. package/src/eval/py/runtime.ts +44 -4
  198. package/src/eval/py/tool-bridge.ts +4 -0
  199. package/src/exa/mcp-client.ts +53 -11
  200. package/src/exec/bash-executor.ts +87 -4
  201. package/src/exec/non-interactive-env.ts +0 -1
  202. package/src/export/html/css-color.ts +9 -0
  203. package/src/export/html/html-export-destination.ts +16 -0
  204. package/src/export/html/index.ts +102 -8
  205. package/src/export/html/template.generated.ts +1 -1
  206. package/src/extensibility/custom-tools/loader.ts +13 -3
  207. package/src/extensibility/custom-tools/types.ts +3 -1
  208. package/src/extensibility/custom-tools/wrapper.ts +3 -1
  209. package/src/extensibility/plugins/manager.ts +3 -2
  210. package/src/extensibility/plugins/marketplace/cache.ts +15 -0
  211. package/src/extensibility/plugins/marketplace/fetcher.ts +2 -2
  212. package/src/extensibility/plugins/marketplace/manager.ts +5 -3
  213. package/src/extensibility/plugins/plugin-link-path.ts +12 -0
  214. package/src/extensibility/skc-plugins/mcp-policy.ts +2 -1
  215. package/src/goals/runtime.ts +30 -8
  216. package/src/harness-control-plane/finalize.ts +10 -0
  217. package/src/harness-control-plane/operate.ts +12 -4
  218. package/src/harness-control-plane/owner.ts +8 -1
  219. package/src/harness-control-plane/receipt-spool.ts +105 -28
  220. package/src/harness-control-plane/storage.ts +124 -6
  221. package/src/hashline/execute.ts +3 -3
  222. package/src/hashline/recovery.ts +85 -2
  223. package/src/hindsight/config.ts +9 -3
  224. package/src/hindsight/content.ts +116 -16
  225. package/src/hindsight/mental-models.ts +22 -10
  226. package/src/hindsight/state.ts +7 -4
  227. package/src/hooks/native-skill-hook.ts +17 -12
  228. package/src/i18n/messages/de.settings.ts +3 -0
  229. package/src/i18n/messages/es.settings.ts +3 -0
  230. package/src/i18n/messages/fr.settings.ts +3 -0
  231. package/src/i18n/messages/ja.settings.ts +3 -0
  232. package/src/i18n/messages/ko.settings.ts +3 -0
  233. package/src/i18n/messages/zh.settings.ts +3 -0
  234. package/src/internal-urls/artifact-protocol.ts +3 -1
  235. package/src/internal-urls/docs-index.generated.ts +10 -10
  236. package/src/internal-urls/local-protocol.ts +167 -8
  237. package/src/internal-urls/skill-path.ts +18 -0
  238. package/src/internal-urls/skill-protocol.ts +2 -0
  239. package/src/internal-urls/types.ts +2 -0
  240. package/src/lsp/client.ts +2 -1
  241. package/src/lsp/clients/biome-client.ts +2 -0
  242. package/src/lsp/clients/swiftlint-client.ts +2 -0
  243. package/src/lsp/config.ts +18 -62
  244. package/src/lsp/edits.ts +6 -0
  245. package/src/lsp/index.ts +29 -0
  246. package/src/lsp/workspace-path.ts +75 -0
  247. package/src/main.ts +33 -11
  248. package/src/memories/index.ts +141 -9
  249. package/src/migrate/action-planner.ts +57 -0
  250. package/src/migrate/adapters/claude-code.ts +23 -4
  251. package/src/migrate/adapters/codex.ts +22 -4
  252. package/src/migrate/adapters/index.ts +22 -4
  253. package/src/migrate/adapters/opencode.ts +6 -1
  254. package/src/migrate/executor.ts +84 -7
  255. package/src/migrate/report.ts +19 -2
  256. package/src/migrate/types.ts +14 -4
  257. package/src/modes/DESIGN.md +5 -0
  258. package/src/modes/acp/acp-agent.ts +35 -2
  259. package/src/modes/acp/permission-mode.ts +18 -1
  260. package/src/modes/components/custom-editor.ts +14 -0
  261. package/src/modes/components/extensions/extension-dashboard.ts +2 -2
  262. package/src/modes/components/extensions/inspector-panel.ts +9 -5
  263. package/src/modes/components/extensions/state-manager.ts +15 -5
  264. package/src/modes/components/model-selector.ts +144 -94
  265. package/src/modes/components/welcome.ts +3 -2
  266. package/src/modes/controllers/command-controller.ts +300 -9
  267. package/src/modes/controllers/event-controller.ts +1 -1
  268. package/src/modes/controllers/extension-ui-controller.ts +32 -19
  269. package/src/modes/controllers/input-controller.ts +62 -26
  270. package/src/modes/controllers/plan-mode-controller.ts +17 -7
  271. package/src/modes/controllers/runtime-mcp-command-controller.ts +25 -20
  272. package/src/modes/controllers/ssh-command-controller.ts +3 -1
  273. package/src/modes/interactive-mode.ts +10 -0
  274. package/src/modes/utils/macos-option-forwarding.ts +80 -0
  275. package/src/prompts/system/irc-incoming.md +3 -1
  276. package/src/prompts/system/project-prompt.md +19 -0
  277. package/src/prompts/system/system-prompt.md +3 -0
  278. package/src/prompts/tools/ask.md +2 -0
  279. package/src/prompts/tools/debug.md +1 -1
  280. package/src/prompts/tools/monitor.md +7 -5
  281. package/src/prompts/tools/reverse-engineer.md +29 -0
  282. package/src/runtime-credential-selector.ts +2 -2
  283. package/src/runtime-mcp/config-writer.ts +10 -6
  284. package/src/runtime-mcp/config.ts +1 -0
  285. package/src/runtime-mcp/content-limits.ts +7 -0
  286. package/src/runtime-mcp/json-rpc.ts +2 -1
  287. package/src/runtime-mcp/manager.ts +57 -9
  288. package/src/runtime-mcp/mcp-redirect.ts +73 -0
  289. package/src/runtime-mcp/oauth-flow.ts +43 -5
  290. package/src/runtime-mcp/oauth-public-url.ts +8 -0
  291. package/src/runtime-mcp/plugin-mcp-name-filter.ts +62 -0
  292. package/src/runtime-mcp/plugin-network-boundary.ts +4 -0
  293. package/src/runtime-mcp/project-host-values.ts +50 -0
  294. package/src/runtime-mcp/render.ts +16 -1
  295. package/src/runtime-mcp/smithery-registry.ts +22 -3
  296. package/src/runtime-mcp/tool-bridge.ts +194 -21
  297. package/src/runtime-mcp/transports/http.ts +4 -3
  298. package/src/runtime-mcp/transports/stdio.ts +2 -1
  299. package/src/runtime-mcp/types.ts +6 -0
  300. package/src/sdk/broker/broker.ts +11 -2
  301. package/src/sdk/broker/ensure.ts +131 -10
  302. package/src/sdk/broker/lifecycle-ledger.ts +18 -3
  303. package/src/sdk/broker/lifecycle.ts +21 -19
  304. package/src/sdk/broker/runtime.ts +1 -1
  305. package/src/sdk/bus/chat-daemon-cli.ts +38 -1
  306. package/src/sdk/bus/chat-daemon-control.ts +5 -3
  307. package/src/sdk/bus/index.ts +5 -3
  308. package/src/sdk/bus/lifecycle-control-runtime.ts +9 -2
  309. package/src/sdk/bus/session-control.ts +2 -0
  310. package/src/sdk/bus/slack-daemon.ts +8 -1
  311. package/src/sdk/bus/slack-live-provider.ts +3 -1
  312. package/src/sdk/bus/telegram-daemon-contract.ts +3 -1
  313. package/src/sdk/bus/telegram-daemon-control.ts +17 -12
  314. package/src/sdk/bus/telegram-daemon.ts +41 -1
  315. package/src/sdk/host/events.ts +67 -4
  316. package/src/sdk/mcp/server.ts +16 -3
  317. package/src/sdk/protocol/operation-inventory.generated.json +22 -0
  318. package/src/sdk/session.ts +18 -25
  319. package/src/secrets/obfuscator.ts +92 -12
  320. package/src/session/agent-session.ts +395 -79
  321. package/src/session/artifacts.ts +3 -1
  322. package/src/session/history-storage.ts +172 -8
  323. package/src/session/internal/managed-session-scope.ts +130 -52
  324. package/src/session/messages.ts +47 -6
  325. package/src/session/session-manager.ts +170 -10
  326. package/src/session/session-storage.ts +31 -1
  327. package/src/session/streaming-output.ts +263 -4
  328. package/src/session-import/redact.ts +76 -3
  329. package/src/setup/hermes-setup.ts +4 -1
  330. package/src/skc-runtime/gc-runtime.ts +26 -4
  331. package/src/skc-runtime/launch-tmux.ts +21 -11
  332. package/src/skc-runtime/launch-worktree.ts +42 -3
  333. package/src/skc-runtime/managed-owner-admission.ts +46 -2
  334. package/src/skc-runtime/psmux-detect.ts +29 -5
  335. package/src/skc-runtime/ralplan-runtime.ts +14 -1
  336. package/src/skc-runtime/session-resolution.ts +38 -6
  337. package/src/skc-runtime/sidecar-bootstrap-env.ts +19 -0
  338. package/src/skc-runtime/state-writer.ts +134 -16
  339. package/src/skc-runtime/tmux-sessions.ts +85 -4
  340. package/src/skc-runtime/ultragoal-change-set.ts +18 -2
  341. package/src/skc-runtime/ultragoal-guard.ts +9 -1
  342. package/src/skc-runtime/ultragoal-runtime.ts +26 -9
  343. package/src/skill-state/active-state.ts +13 -0
  344. package/src/skill-state/workflow-mutation-guard.ts +3297 -180
  345. package/src/slash-commands/builtin-registry.ts +14 -8
  346. package/src/slash-commands/helpers/mcp.ts +20 -7
  347. package/src/ssh/ssh-executor.ts +3 -1
  348. package/src/stt/recorder.ts +26 -9
  349. package/src/system-prompt.ts +65 -16
  350. package/src/task/commands.ts +3 -1
  351. package/src/task/executor.ts +52 -7
  352. package/src/task/index.ts +28 -0
  353. package/src/task/isolation-dir.ts +143 -0
  354. package/src/task/role-body.ts +84 -0
  355. package/src/task/token-log-mode.test.ts +162 -0
  356. package/src/task/token-log.ts +91 -2
  357. package/src/task/worktree.ts +16 -7
  358. package/src/tools/archive-reader.ts +653 -31
  359. package/src/tools/ask.ts +86 -14
  360. package/src/tools/ast-edit-write-path.ts +133 -0
  361. package/src/tools/ast-edit.ts +27 -1
  362. package/src/tools/ast-grep.ts +7 -2
  363. package/src/tools/atomic-file-write.ts +625 -0
  364. package/src/tools/auto-generated-guard.ts +28 -8
  365. package/src/tools/bash-allowed-prefixes.ts +225 -6
  366. package/src/tools/bash-interactive.ts +12 -0
  367. package/src/tools/bash-skill-urls.ts +113 -7
  368. package/src/tools/bash.ts +152 -20
  369. package/src/tools/browser/cdp-url.ts +18 -0
  370. package/src/tools/browser/tab-worker.ts +49 -14
  371. package/src/tools/browser.ts +25 -8
  372. package/src/tools/cron.ts +10 -1
  373. package/src/tools/debug.ts +16 -8
  374. package/src/tools/eval.ts +71 -34
  375. package/src/tools/explicit-artifact.ts +89 -0
  376. package/src/tools/fetch.ts +26 -17
  377. package/src/tools/gh.ts +40 -12
  378. package/src/tools/github-side-effect.ts +112 -0
  379. package/src/tools/image-gen.ts +24 -10
  380. package/src/tools/index.ts +6 -0
  381. package/src/tools/monitor-mutation.ts +27 -0
  382. package/src/tools/monitor.ts +28 -1
  383. package/src/tools/output-meta.ts +74 -5
  384. package/src/tools/read.ts +24 -36
  385. package/src/tools/recipe/index.ts +12 -0
  386. package/src/tools/recipe/recipe-guard.ts +19 -0
  387. package/src/tools/recipe/runner.ts +23 -12
  388. package/src/tools/render-utils.ts +2 -2
  389. package/src/tools/restricted-cwd.ts +10 -0
  390. package/src/tools/reverse-engineer.ts +497 -0
  391. package/src/tools/search-tool-bm25.ts +14 -3
  392. package/src/tools/search.ts +3 -2
  393. package/src/tools/ssh.ts +235 -8
  394. package/src/tools/subagent-render.ts +43 -7
  395. package/src/tools/subagent.ts +7 -3
  396. package/src/tools/tmux-self-injection-guard.ts +3538 -0
  397. package/src/tools/todo-write.ts +41 -3
  398. package/src/tools/untrusted-content.ts +23 -0
  399. package/src/tools/vim.ts +2 -2
  400. package/src/tools/write.ts +37 -4
  401. package/src/tui/tree-list.ts +15 -1
  402. package/src/utils/commit-message-generator.ts +9 -2
  403. package/src/utils/external-editor.ts +21 -7
  404. package/src/utils/file-mentions.ts +75 -7
  405. package/src/utils/git.ts +38 -7
  406. package/src/utils/open.ts +73 -4
  407. package/src/utils/shell-snapshot.ts +9 -1
  408. package/src/utils/title-generator.ts +61 -16
  409. package/src/utils/tools-checksum.ts +34 -0
  410. package/src/utils/tools-manager.ts +24 -6
  411. package/src/utils/xml-escape.ts +14 -0
  412. package/src/web/insane/url-guard.ts +2 -1
  413. package/src/web/scrapers/types.ts +8 -0
  414. package/src/web/scrapers/youtube.ts +3 -2
  415. package/src/web/search/index.ts +4 -3
  416. package/src/web/search/providers/anthropic.ts +4 -4
  417. package/src/web/search/providers/codex.ts +31 -34
  418. package/src/web/search/providers/insane.ts +145 -28
  419. package/src/web/search/providers/kimi.ts +15 -5
  420. package/src/web/search/providers/searxng.ts +47 -4
  421. package/src/web/search/providers/xai.ts +7 -2
  422. package/dist/types/cli/shell-cli.d.ts +0 -8
  423. package/dist/types/commands/shell.d.ts +0 -21
  424. package/src/cli/shell-cli.ts +0 -176
  425. package/src/commands/shell.ts +0 -29
package/src/tools/ssh.ts CHANGED
@@ -5,18 +5,33 @@ import { prompt } from "@sayknow-cli/utils";
5
5
  import * as z from "zod/v4";
6
6
  import type { SSHHost } from "../capability/ssh";
7
7
  import { sshCapability } from "../capability/ssh";
8
+ import { getDefault, type Settings } from "../config/settings";
8
9
  import { loadCapability } from "../discovery";
9
10
  import type { RenderResultOptions } from "../extensibility/custom-tools/types";
10
11
  import type { Theme } from "../modes/theme/theme";
11
12
  import sshDescriptionBase from "../prompts/tools/ssh.md" with { type: "text" };
12
- import { DEFAULT_MAX_BYTES, streamTailUpdates, TailBuffer } from "../session/streaming-output";
13
+ import {
14
+ DEFAULT_MAX_BYTES,
15
+ streamTailUpdates,
16
+ TailBuffer,
17
+ type TruncationResult,
18
+ truncateMiddle,
19
+ truncateMiddleWindows,
20
+ truncateTail,
21
+ } from "../session/streaming-output";
13
22
  import type { SSHHostInfo } from "../ssh/connection-manager";
14
23
  import { ensureHostInfo, getHostInfoForHost } from "../ssh/connection-manager";
15
- import { executeSSH } from "../ssh/ssh-executor";
24
+ import { executeSSH, type SSHResult } from "../ssh/ssh-executor";
16
25
  import { renderStatusLine } from "../tui";
17
26
  import { CachedOutputBlock } from "../tui/output-block";
18
27
  import type { ToolSession } from ".";
19
- import { formatStyledTruncationWarning, type OutputMeta, stripOutputNotice } from "./output-meta";
28
+ import { wrapUntrustedContent } from "./fetch";
29
+ import {
30
+ formatFullOutputReference,
31
+ formatStyledTruncationWarning,
32
+ type OutputMeta,
33
+ stripOutputNotice,
34
+ } from "./output-meta";
20
35
  import { ToolError } from "./tool-errors";
21
36
  import { toolResult } from "./tool-result";
22
37
  import { clampTimeout } from "./tool-timeouts";
@@ -88,6 +103,158 @@ function quoteCmdPath(value: string): string {
88
103
  return `"${escaped}"`;
89
104
  }
90
105
 
106
+ const FENCE_OPEN = "<untrusted-content>\n";
107
+ const FENCE_CLOSE = "\n</untrusted-content>";
108
+ const UNTRUSTED_FENCE_OVERHEAD = Buffer.byteLength(`${FENCE_OPEN}${FENCE_CLOSE}`, "utf-8");
109
+ const INLINE_MARKER_RESERVE = 256;
110
+ /** `</untrusted-content>` grows when `wrapUntrustedContent` escapes it. */
111
+ const CLOSER_RAW_BYTES = "</untrusted-content>".length;
112
+ const CLOSER_ESCAPED_BYTES = "&lt;/untrusted-content&gt;".length;
113
+
114
+ type OutputBudgetPath = "tools.maxInlineResultBytes" | "tools.artifactHeadBytes" | "tools.artifactTailLines";
115
+
116
+ function settingNumber(settings: Settings | undefined, path: OutputBudgetPath): number {
117
+ return settings?.get(path) ?? getDefault(path);
118
+ }
119
+
120
+ type RemoteFrame = {
121
+ text: string;
122
+ truncation?: TruncationResult;
123
+ direction?: "head" | "tail" | "middle";
124
+ /** True only after the full remote text is already stored. */
125
+ shrunk: boolean;
126
+ visibleLines: number;
127
+ visibleBytes: number;
128
+ };
129
+
130
+ function inlineCapBytes(settings: Settings | undefined): number {
131
+ return settingNumber(settings, "tools.maxInlineResultBytes") * 1024;
132
+ }
133
+
134
+ function exceedsInlineCap(output: string, settings: Settings | undefined): boolean {
135
+ const cap = inlineCapBytes(settings);
136
+ if (cap <= 0) return false;
137
+ // Measure the escaped frame. A raw-size check misses closer expansion.
138
+ return Buffer.byteLength(wrapUntrustedContent(output), "utf-8") > cap;
139
+ }
140
+
141
+ function frameFullRemoteOutput(output: string): RemoteFrame {
142
+ return { text: wrapUntrustedContent(output), shrunk: false, visibleLines: 0, visibleBytes: 0 };
143
+ }
144
+
145
+ /**
146
+ * Cut to the inline window, then frame that excerpt. Call only when the full
147
+ * remote text is already stored, so a tail cut cannot drop the opening fence
148
+ * or the only copy of the output.
149
+ */
150
+ function frameShrunkRemoteOutput(output: string, settings: Settings | undefined): RemoteFrame {
151
+ const cap = inlineCapBytes(settings);
152
+ const escapedRoom = Math.max(1, cap - UNTRUSTED_FENCE_OVERHEAD - INLINE_MARKER_RESERVE);
153
+ // Budget in remote-output bytes so framing and closer escaping cannot distort
154
+ // the source coordinates reported by truncation metadata.
155
+ let budget = Math.max(1, Math.floor((escapedRoom * CLOSER_RAW_BYTES) / CLOSER_ESCAPED_BYTES));
156
+ const headBytes = settingNumber(settings, "tools.artifactHeadBytes") * 1024;
157
+ const tailLines = settingNumber(settings, "tools.artifactTailLines");
158
+ const headBudget = Math.max(
159
+ 1,
160
+ Math.floor((Math.min(headBytes, escapedRoom / 2) * CLOSER_RAW_BYTES) / CLOSER_ESCAPED_BYTES),
161
+ );
162
+ const cutRemoteOutput = (maxBytes: number) => {
163
+ if (headBytes > 0) {
164
+ const options = {
165
+ maxBytes,
166
+ maxLines: tailLines * 2,
167
+ maxHeadBytes: Math.min(headBudget, Math.floor(maxBytes / 2)),
168
+ maxHeadLines: tailLines,
169
+ };
170
+ return {
171
+ truncation: truncateMiddle(output, options),
172
+ windows: truncateMiddleWindows(output, options),
173
+ };
174
+ }
175
+ const options = { maxBytes, maxLines: tailLines };
176
+ return {
177
+ truncation: truncateTail(output, options),
178
+ windows: truncateMiddleWindows(output, { ...options, maxHeadBytes: 0, maxHeadLines: 0 }),
179
+ };
180
+ };
181
+ let { truncation, windows } = cutRemoteOutput(budget);
182
+ let excerpt = truncation.truncated ? truncation.content : output;
183
+ let text = wrapUntrustedContent(excerpt);
184
+ let textBytes = Buffer.byteLength(text, "utf-8");
185
+ while (textBytes > cap && budget > 1) {
186
+ const scaledBudget = Math.floor((budget * cap) / textBytes);
187
+ budget = Math.max(1, Math.min(budget - 1, scaledBudget));
188
+ ({ truncation, windows } = cutRemoteOutput(budget));
189
+ excerpt = truncation.truncated ? truncation.content : output;
190
+ text = wrapUntrustedContent(excerpt);
191
+ textBytes = Buffer.byteLength(text, "utf-8");
192
+ }
193
+ if (text === wrapUntrustedContent(output)) return frameFullRemoteOutput(output);
194
+ if (windows.kind === "full") return frameFullRemoteOutput(output);
195
+ const direction = windows.kind === "middle" ? "middle" : windows.kind === "head-only" ? "head" : "tail";
196
+ return {
197
+ text,
198
+ truncation,
199
+ direction,
200
+ shrunk: true,
201
+ visibleLines: (windows.head?.lines ?? 0) + (windows.tail?.lines ?? 0),
202
+ visibleBytes: (windows.head?.bytes ?? 0) + (windows.tail?.bytes ?? 0),
203
+ };
204
+ }
205
+
206
+ /**
207
+ * Store the full remote text. Never write an already-shortened excerpt.
208
+ * The command has already finished, so a rejected reservation must not discard it.
209
+ */
210
+ async function storeFullRemoteOutput(session: ToolSession, output: string): Promise<string | undefined> {
211
+ let allocated: { id?: string; path?: string } | undefined;
212
+ try {
213
+ allocated = await session.allocateOutputArtifact?.("ssh");
214
+ } catch {
215
+ return undefined;
216
+ }
217
+ if (!allocated?.path || !allocated.id) return undefined;
218
+ try {
219
+ await Bun.write(allocated.path, output);
220
+ return allocated.id;
221
+ } catch {
222
+ return undefined;
223
+ }
224
+ }
225
+
226
+ /** Artifact reference; notes bytes the artifact storage cap omitted. */
227
+ function formatArtifactReference(artifactId: string, artifactTruncatedBytes?: number): string {
228
+ if (artifactTruncatedBytes != null && artifactTruncatedBytes > 0) {
229
+ return `Read artifact://${artifactId} for retained output (at least ${artifactTruncatedBytes} bytes omitted by the artifact storage cap)`;
230
+ }
231
+ return formatFullOutputReference(artifactId);
232
+ }
233
+
234
+ function hasCompleteRemoteOutput(result: SSHResult, output: string): boolean {
235
+ return (
236
+ !result.truncated &&
237
+ result.outputBytes === result.totalBytes &&
238
+ Buffer.byteLength(output, "utf-8") === result.outputBytes
239
+ );
240
+ }
241
+
242
+ function incompleteOutputNotice(result: SSHResult, artifactId: string | undefined): string | undefined {
243
+ const retainedWindowIncomplete = result.truncated || result.outputBytes < result.totalBytes;
244
+ if (!retainedWindowIncomplete) return undefined;
245
+
246
+ const artifactIncomplete = (result.artifactTruncatedBytes ?? 0) > 0;
247
+ const completeArtifactAvailable = artifactId !== undefined && !artifactIncomplete;
248
+ if (completeArtifactAvailable) return undefined;
249
+
250
+ const notes = [`SSH output is incomplete: retained ${result.outputBytes} of ${result.totalBytes} bytes`];
251
+ notes.push("no complete output artifact is available");
252
+ if ((result.artifactTruncatedBytes ?? 0) > 0) {
253
+ notes.push(`artifact storage omitted at least ${result.artifactTruncatedBytes} bytes`);
254
+ }
255
+ return notes.join("; ");
256
+ }
257
+
91
258
  function buildRemoteCommand(command: string, cwd: string | undefined, info: SSHHostInfo): string {
92
259
  if (!cwd) return command;
93
260
 
@@ -160,6 +327,7 @@ export class SshTool implements AgentTool<typeof sshSchema, SSHToolDetails> {
160
327
  // Clamp to reasonable range: 1s - 3600s (1 hour)
161
328
  const timeoutSec = clampTimeout("ssh", rawTimeout);
162
329
  const timeoutMs = timeoutSec * 1000;
330
+ const outputSettings = _ctx?.settings ?? this.session.settings;
163
331
 
164
332
  const tailBuffer = new TailBuffer(DEFAULT_MAX_BYTES);
165
333
  const { path: artifactPath, id: artifactId } = (await this.session.allocateOutputArtifact?.("ssh")) ?? {};
@@ -173,19 +341,78 @@ export class SshTool implements AgentTool<typeof sshSchema, SSHToolDetails> {
173
341
  onChunk: streamTailUpdates(tailBuffer, onUpdate),
174
342
  });
175
343
 
344
+ const remote = result.output ?? "";
345
+ let storedArtifactId = result.artifactId;
346
+ let framed: RemoteFrame | undefined;
347
+ if (!remote) {
348
+ framed = undefined;
349
+ } else if (!exceedsInlineCap(remote, outputSettings)) {
350
+ framed = frameFullRemoteOutput(remote);
351
+ } else {
352
+ if (!storedArtifactId && hasCompleteRemoteOutput(result, remote)) {
353
+ storedArtifactId = await storeFullRemoteOutput(this.session, remote);
354
+ }
355
+ framed = storedArtifactId ? frameShrunkRemoteOutput(remote, outputSettings) : frameFullRemoteOutput(remote);
356
+ }
357
+ // The artifact id stays in truncation metadata. A line after the closing
358
+ // fence makes the inline backstop drop the opening fence.
359
+ const modelText = framed?.text;
360
+ const storedNote =
361
+ (framed?.shrunk || result.truncated) && storedArtifactId
362
+ ? `\n\n${formatArtifactReference(storedArtifactId, result.artifactTruncatedBytes)}`
363
+ : "";
364
+ const incompleteNote = incompleteOutputNotice(result, storedArtifactId);
176
365
  if (result.cancelled) {
177
- throw new ToolError(result.output || "Command aborted");
366
+ const message = [modelText || "Command aborted", storedNote.trim() || undefined, incompleteNote]
367
+ .filter((part): part is string => part !== undefined)
368
+ .join("\n\n");
369
+ throw new ToolError(message);
178
370
  }
179
371
 
180
- const outputText = result.output || "(no output)";
372
+ const outputText = modelText ?? "(no output)";
181
373
  const details: SSHToolDetails = {};
182
- const resultBuilder = toolResult(details).text(outputText).truncationFromSummary(result, { direction: "tail" });
374
+ const resultBuilder = toolResult(details).text(outputText);
375
+ if (framed?.shrunk && framed.truncation && storedArtifactId) {
376
+ resultBuilder.truncation(framed.truncation, {
377
+ direction: framed.direction ?? "tail",
378
+ artifactId: storedArtifactId,
379
+ });
380
+ } else {
381
+ resultBuilder.truncationFromSummary(result, { direction: "tail" });
382
+ }
183
383
 
184
384
  if (result.exitCode !== 0 && result.exitCode !== undefined) {
185
- throw new ToolError(`${outputText}\n\nCommand exited with code ${result.exitCode}`);
385
+ const message = [
386
+ outputText,
387
+ storedNote.trim() || undefined,
388
+ incompleteNote,
389
+ `Command exited with code ${result.exitCode}`,
390
+ ]
391
+ .filter((part): part is string => part !== undefined)
392
+ .join("\n\n");
393
+ throw new ToolError(message);
186
394
  }
187
395
 
188
- return resultBuilder.done();
396
+ const built = resultBuilder.done();
397
+ const truncation = built.details?.meta?.truncation;
398
+ if (framed?.shrunk && truncation) {
399
+ // The cut is a window of an earlier excerpt. Keep the stream totals
400
+ // and do not present that window's coordinates as the original range.
401
+ truncation.totalLines = result.totalLines;
402
+ truncation.totalBytes = result.totalBytes;
403
+ truncation.outputLines = framed.visibleLines;
404
+ truncation.outputBytes = framed.visibleBytes;
405
+ truncation.artifactId = storedArtifactId;
406
+ delete truncation.shownRange;
407
+ delete truncation.headRange;
408
+ delete truncation.tailRange;
409
+ delete truncation.nextOffset;
410
+ if (framed.direction === "middle") {
411
+ truncation.elidedLines = Math.max(0, result.totalLines - framed.visibleLines);
412
+ truncation.elidedBytes = Math.max(0, result.totalBytes - framed.visibleBytes);
413
+ }
414
+ }
415
+ return built;
189
416
  }
190
417
  }
191
418
 
@@ -26,12 +26,14 @@ import {
26
26
  replaceTabs,
27
27
  type ToolUIStatus,
28
28
  truncateToWidth,
29
+ wrapTextWithAnsi,
29
30
  } from "./render-utils";
30
31
  import { type SubagentSnapshot, type SubagentToolDetails, subagentAwaitRenderedStateSignature } from "./subagent";
31
32
 
32
33
  export { subagentAwaitRenderedStateSignature } from "./subagent";
33
34
 
34
35
  const PREVIEW_LINES_COLLAPSED = 1;
36
+ const GUIDANCE_MAX_LINES = 12;
35
37
  const PREVIEW_LINES_EXPANDED = 4;
36
38
  const PREVIEW_LINE_WIDTH = 80;
37
39
 
@@ -93,6 +95,44 @@ function boundSubagentBodyLines(lines: string[], width: number): string[] {
93
95
  return lines.map(line => (line.length > 0 ? truncateToWidth(replaceTabs(line), width, Ellipsis.Omit) : ""));
94
96
  }
95
97
 
98
+ // Guidance is an instruction the caller must act on (e.g. "inspect before
99
+ // cancelling" after an await timeout), so it wraps to the terminal width instead
100
+ // of being cut to one preview line.
101
+ function renderSubagentGuidanceLines(snapshot: SubagentSnapshot, width: number, theme: Theme): string[] {
102
+ const guidance = snapshot.guidance?.trim();
103
+ if (!guidance) return [];
104
+ const indent = " ";
105
+ const wrapWidth = Math.max(1, width - indent.length);
106
+ const wrapped = guidance.split("\n").flatMap(segment => wrapTextWithAnsi(replaceTabs(segment), wrapWidth));
107
+ // Still bounded: producer guidance is a short fixed sentence, so the cap only
108
+ // bites on pathologically narrow terminals.
109
+ if (wrapped.length > GUIDANCE_MAX_LINES) {
110
+ wrapped.length = GUIDANCE_MAX_LINES;
111
+ wrapped[GUIDANCE_MAX_LINES - 1] = truncateToWidth(
112
+ `${wrapped[GUIDANCE_MAX_LINES - 1]!}…`,
113
+ wrapWidth,
114
+ Ellipsis.Unicode,
115
+ );
116
+ }
117
+ return wrapped.map(line => `${indent}${theme.fg("dim", line)}`);
118
+ }
119
+
120
+ function renderBoundSubagentBody(
121
+ snapshot: SubagentSnapshot,
122
+ expanded: boolean,
123
+ width: number,
124
+ theme: Theme,
125
+ staticTime: boolean,
126
+ ): string[] {
127
+ return boundSubagentBodyLines(
128
+ [
129
+ ...renderSubagentSnapshotBody(snapshot, expanded, theme, staticTime),
130
+ ...renderSubagentGuidanceLines(snapshot, width, theme),
131
+ ],
132
+ width,
133
+ );
134
+ }
135
+
96
136
  function renderCachedSubagentBody(
97
137
  snapshot: SubagentSnapshot,
98
138
  signature: string,
@@ -108,7 +148,7 @@ function renderCachedSubagentBody(
108
148
  subagentBodyCache.set(key, hit);
109
149
  return hit;
110
150
  }
111
- const lines = boundSubagentBodyLines(renderSubagentSnapshotBody(snapshot, expanded, theme), width);
151
+ const lines = renderBoundSubagentBody(snapshot, expanded, width, theme, true);
112
152
  subagentBodyRenderCount += 1;
113
153
  subagentBodyCache.set(key, lines);
114
154
  if (subagentBodyCache.size > SUBAGENT_BODY_CACHE_MAX) {
@@ -125,7 +165,7 @@ function renderDynamicSubagentBody(
125
165
  theme: Theme,
126
166
  ): string[] {
127
167
  subagentBodyRenderCount += 1;
128
- return boundSubagentBodyLines(renderSubagentSnapshotBody(snapshot, expanded, theme, false), width);
168
+ return renderBoundSubagentBody(snapshot, expanded, width, theme, false);
129
169
  }
130
170
 
131
171
  function statusIconKind(status: SubagentSnapshot["status"]): ToolUIStatus {
@@ -231,11 +271,7 @@ function renderSubagentSnapshotBody(
231
271
  }
232
272
  }
233
273
 
234
- if (snapshot.guidance) {
235
- for (const line of getPreviewLines(snapshot.guidance, 1, PREVIEW_LINE_WIDTH, Ellipsis.Unicode)) {
236
- lines.push(` ${theme.fg("dim", replaceTabs(line))}`);
237
- }
238
- }
274
+ // `snapshot.guidance` is appended by renderBoundSubagentBody, wrapped to width.
239
275
 
240
276
  return lines;
241
277
  }
@@ -6,6 +6,7 @@ import { type AsyncJob, AsyncJobManager, jobElapsedMs, type SubagentRecord } fro
6
6
  import subagentDescription from "../prompts/tools/subagent.md" with { type: "text" };
7
7
  import type { AgentProgress, AgentSource, TaskToolDetails } from "../task/types";
8
8
  import { Ellipsis, truncateToWidth } from "../tui";
9
+ import { wrapUntrustedContent } from "./fetch";
9
10
  import type { ToolSession } from "./index";
10
11
  import { replaceTabs } from "./render-utils";
11
12
  import { ToolError } from "./tool-errors";
@@ -603,13 +604,16 @@ export class SubagentTool implements AgentTool<typeof subagentSchema, SubagentTo
603
604
  }
604
605
  if (snapshot.description) lines.push(`Description: ${snapshot.description}`);
605
606
  if (snapshot.outputRef) lines.push(`Output: ${snapshot.outputRef}`);
606
- if (snapshot.assignment) lines.push("Assignment:", "```", snapshot.assignment, "```");
607
+ // A markdown fence is not a boundary: subagent text can contain ``` and
608
+ // close it, leaving the rest as raw tool-result text. Frame the data.
609
+ if (snapshot.assignment) lines.push(wrapUntrustedContent(`Assignment:\n${snapshot.assignment}`));
607
610
  if (snapshot.steerMessage) {
608
- lines.push(`Steer (${snapshot.steerState ?? "queued"}):`, "```", snapshot.steerMessage, "```");
611
+ lines.push(wrapUntrustedContent(`Steer (${snapshot.steerState ?? "queued"}):\n${snapshot.steerMessage}`));
609
612
  lines.push(STEER_QUEUED_GUIDANCE);
610
613
  }
611
614
  if (snapshot.resultPreview) {
612
- lines.push(snapshot.errorText ? "Error preview:" : "Result preview:", "```", snapshot.resultPreview, "```");
615
+ const previewLabel = snapshot.errorText ? "Error preview:" : "Result preview:";
616
+ lines.push(wrapUntrustedContent(`${previewLabel}\n${snapshot.resultPreview}`));
613
617
  if (snapshot.truncated)
614
618
  lines.push("Preview truncated; use the output ref or explicit ids with `verbosity=full` for more.");
615
619
  }