@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/ask.ts CHANGED
@@ -16,6 +16,8 @@
16
16
  */
17
17
 
18
18
  import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@sayknow-cli/agent-core";
19
+ import type { RawArgumentValidationResult } from "@sayknow-cli/ai/types";
20
+ import { validateToolArguments } from "@sayknow-cli/ai/utils/validation";
19
21
  import {
20
22
  type Component,
21
23
  Container,
@@ -171,10 +173,16 @@ const WorkflowGateMeta = z.object({
171
173
  kind: z.enum(["question", "approval", "execution"]).describe("workflow gate kind"),
172
174
  });
173
175
 
176
+ const QuestionText = z
177
+ .string()
178
+ .min(1)
179
+ .refine(value => value.trim().length > 0, "ask question body must contain non-whitespace text")
180
+ .describe("non-empty question text");
181
+
174
182
  function createQuestionItemSchema(deepInterviewSchema: z.ZodType<DeepInterviewMeta>) {
175
183
  return z.object({
176
184
  id: z.string().describe("question id"),
177
- question: z.string().describe("question text"),
185
+ question: QuestionText,
178
186
  options: z.array(OptionItem).describe("available options"),
179
187
  multi: z.boolean().describe("allow multiple selections").optional(),
180
188
  recommended: z.number().describe("recommended option index").optional(),
@@ -184,10 +192,21 @@ function createQuestionItemSchema(deepInterviewSchema: z.ZodType<DeepInterviewMe
184
192
  }
185
193
 
186
194
  const QuestionItem = createQuestionItemSchema(DeepInterviewMeta);
187
- /** Round 0 of an active deep interview: only the topology confirmation may carry intent authority. */
188
- const TopologyQuestionItem = createQuestionItemSchema(DeepInterviewTopologyMeta);
195
+ /**
196
+ * Round 0 of an active deep interview: only the topology confirmation may carry intent authority.
197
+ * The metadata is required: question prose and `workflowGate` cannot record an interview answer.
198
+ */
199
+ const TopologyQuestionItem = createQuestionItemSchema(DeepInterviewTopologyMeta).extend({
200
+ deepInterview: DeepInterviewTopologyMeta.describe("required Round 0 topology and locked-intent metadata"),
201
+ });
189
202
  /** After Round 0 locked a manifest: ordinary rounds and reduction reviews, never a new contract. */
190
- const PostTopologyQuestionItem = createQuestionItemSchema(z.union([DeepInterviewRoundMeta, DeepInterviewReviewMeta]));
203
+ const PostTopologyQuestionItem = createQuestionItemSchema(
204
+ z.union([DeepInterviewRoundMeta, DeepInterviewReviewMeta]),
205
+ ).extend({
206
+ deepInterview: z
207
+ .union([DeepInterviewRoundMeta, DeepInterviewReviewMeta])
208
+ .describe("required positive-round interview metadata"),
209
+ });
191
210
 
192
211
  /**
193
212
  * Outside an active deep interview no deep-interview authority exists, so the
@@ -195,7 +214,7 @@ const PostTopologyQuestionItem = createQuestionItemSchema(z.union([DeepInterview
195
214
  */
196
215
  const OrdinaryQuestionItem = z.object({
197
216
  id: z.string().describe("question id"),
198
- question: z.string().describe("question text"),
217
+ question: QuestionText,
199
218
  options: z.array(OptionItem).describe("available options"),
200
219
  multi: z.boolean().describe("allow multiple selections").optional(),
201
220
  recommended: z.number().describe("recommended option index").optional(),
@@ -207,13 +226,58 @@ export const askSchema = z.object({
207
226
  });
208
227
 
209
228
  const topologyAskSchema = z.object({
210
- questions: z.array(TopologyQuestionItem).min(1).describe("questions to ask"),
229
+ questions: z.array(TopologyQuestionItem).length(1).describe("exactly one Round 0 topology question"),
211
230
  });
212
231
 
213
232
  const postTopologyAskSchema = z.object({
214
- questions: z.array(PostTopologyQuestionItem).min(1).describe("questions to ask"),
233
+ questions: z.array(PostTopologyQuestionItem).length(1).describe("exactly one positive-round interview question"),
215
234
  });
216
235
 
236
+ type DeepInterviewAskStage = "topology" | "post-topology" | undefined;
237
+
238
+ /** Tool-call arguments may carry containers as JSON text before coercion. */
239
+ function decodeEncodedContainer(value: unknown): unknown {
240
+ if (typeof value !== "string") return value;
241
+ const trimmed = value.trim();
242
+ if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return value;
243
+ try {
244
+ return JSON.parse(trimmed);
245
+ } catch {
246
+ return value;
247
+ }
248
+ }
249
+
250
+ function isPlainRecord(value: unknown): value is Record<string, unknown> {
251
+ return typeof value === "object" && value !== null && !Array.isArray(value);
252
+ }
253
+
254
+ /**
255
+ * Integrity rejections with actionable corrections, checked on the raw
256
+ * arguments before any coercion: blank question bodies (including empty extra
257
+ * "metadata"/"ignore" questions), and active-interview asks that carry more
258
+ * than one question or no structured `deepInterview` metadata.
259
+ */
260
+ function askIntegrityRejection(
261
+ arguments_: Record<string, unknown>,
262
+ stage: DeepInterviewAskStage,
263
+ ): RawArgumentValidationResult | undefined {
264
+ const root = decodeEncodedContainer(arguments_);
265
+ if (!isPlainRecord(root)) return undefined;
266
+ const questions = decodeEncodedContainer(root.questions);
267
+ if (!Array.isArray(questions)) return undefined;
268
+ for (const rawQuestion of questions) {
269
+ const question = decodeEncodedContainer(rawQuestion);
270
+ if (isPlainRecord(question) && typeof question.question === "string" && question.question.trim().length === 0)
271
+ return { outcome: "reject", code: "ask-question-body-required" };
272
+ }
273
+ if (stage === undefined) return undefined;
274
+ if (questions.length !== 1) return { outcome: "reject", code: "ask-deep-interview-single-question-required" };
275
+ const question = decodeEncodedContainer(questions[0]);
276
+ if (isPlainRecord(question) && decodeEncodedContainer(question.deepInterview) == null)
277
+ return { outcome: "reject", code: "ask-deep-interview-metadata-required" };
278
+ return undefined;
279
+ }
280
+
217
281
  const ordinaryAskSchema = z.object({
218
282
  questions: z.array(OrdinaryQuestionItem).min(1).describe("questions to ask"),
219
283
  });
@@ -677,6 +741,8 @@ export class AskTool implements AgentTool<AskParametersSchema, AskToolDetails> {
677
741
  if (stage === "post-topology") return postTopologyAskSchema;
678
742
  return ordinaryAskSchema;
679
743
  }
744
+ readonly rawArgumentValidation = (arguments_: Record<string, unknown>): RawArgumentValidationResult =>
745
+ askIntegrityRejection(arguments_, this.session.getDeepInterviewAskStage?.()) ?? { outcome: "passthrough" };
680
746
  readonly strict = true;
681
747
  /**
682
748
  * These fields are rendered to the user and carry no executable or durable
@@ -753,6 +819,19 @@ export class AskTool implements AgentTool<AskParametersSchema, AskToolDetails> {
753
819
  context?: AgentToolContext,
754
820
  ): Promise<AgentToolResult<AskToolDetails>> {
755
821
  await assertUltragoalAskAllowed(this.session.cwd);
822
+ // Recheck at execution time as well: direct SDK callers and a phase change
823
+ // after tool-call validation must not open an unrecordable interview ask.
824
+ params = askSchema.parse(
825
+ validateToolArguments(
826
+ {
827
+ name: this.name,
828
+ description: this.description,
829
+ parameters: this.parameters,
830
+ rawArgumentValidation: this.rawArgumentValidation,
831
+ },
832
+ { type: "toolCall", id: _toolCallId, name: this.name, arguments: params },
833
+ ),
834
+ );
756
835
  const gateEmitter = this.session.getWorkflowGateEmitter?.();
757
836
  // A negotiated unattended run answers through workflow gates even when a UI
758
837
  // exists; otherwise gates are the headless answer path only.
@@ -995,13 +1074,6 @@ export class AskTool implements AgentTool<AskParametersSchema, AskToolDetails> {
995
1074
  // Send notification if waiting and not suppressed
996
1075
  this.#sendAskNotification();
997
1076
 
998
- if (params.questions.length === 0) {
999
- return {
1000
- content: [{ type: "text" as const, text: "Error: questions must not be empty" }],
1001
- details: {},
1002
- };
1003
- }
1004
-
1005
1077
  const askQuestion = async (
1006
1078
  q: AskParams["questions"][number],
1007
1079
  options?: {
@@ -0,0 +1,133 @@
1
+ import type { Stats } from "node:fs";
2
+ import * as fs from "node:fs/promises";
3
+ import * as path from "node:path";
4
+
5
+ const MAX_ANCESTOR_WALK = 64;
6
+
7
+ function isInside(root: string, target: string): boolean {
8
+ const relative = path.relative(root, target);
9
+ return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
10
+ }
11
+
12
+ /**
13
+ * Path the native writer will mutate: realpath of an existing file, or realpath
14
+ * of the nearest existing ancestor plus the missing tail.
15
+ */
16
+ export async function canonicalizeAstEditWritePath(absolutePath: string): Promise<string> {
17
+ const suffix: string[] = [];
18
+ let current = path.resolve(absolutePath);
19
+ for (let depth = 0; depth < MAX_ANCESTOR_WALK; depth++) {
20
+ try {
21
+ const real = await fs.realpath(current);
22
+ return suffix.length === 0 ? real : path.join(real, ...suffix.toReversed());
23
+ } catch {
24
+ const parent = path.dirname(current);
25
+ if (parent === current) break;
26
+ suffix.push(path.basename(current));
27
+ current = parent;
28
+ }
29
+ }
30
+ return path.resolve(absolutePath);
31
+ }
32
+
33
+ /**
34
+ * Preview paths as the workflow guard must see them.
35
+ *
36
+ * The guard compares lexically against the session cwd. A raw realpath misses
37
+ * `.skc/**` when that cwd is not already canonical (`/var` vs `/private/var`,
38
+ * or a symlinked workspace), so an in-workspace real path is reattached to `cwd`.
39
+ */
40
+ export async function resolveAstEditPreviewWritePaths(
41
+ cwd: string,
42
+ previewedPaths: readonly string[],
43
+ ): Promise<string[]> {
44
+ const resolvedCwd = path.resolve(cwd);
45
+ let realCwd = resolvedCwd;
46
+ try {
47
+ realCwd = await fs.realpath(resolvedCwd);
48
+ } catch {
49
+ // Missing cwd has no canonical spelling; keep the lexical root.
50
+ }
51
+ const resolved: string[] = [];
52
+ for (const previewed of previewedPaths) {
53
+ const lexical = path.resolve(resolvedCwd, previewed);
54
+ const real = await canonicalizeAstEditWritePath(lexical);
55
+ const relative = path.relative(realCwd, real);
56
+ const canonical =
57
+ isInside(realCwd, real) && relative !== ""
58
+ ? path.resolve(resolvedCwd, relative)
59
+ : isInside(realCwd, real)
60
+ ? resolvedCwd
61
+ : real;
62
+ // The guard matches `.skc` lexically. Keep the preview spelling so a
63
+ // symlinked `.skc` directory is still recognized, and add the canonical
64
+ // spelling so `src` → `.skc` is recognized too.
65
+ resolved.push(previewed);
66
+ if (path.resolve(canonical) !== lexical) resolved.push(canonical);
67
+ }
68
+ return resolved;
69
+ }
70
+
71
+ /** Refusal prefix when a single-file real path leaves its reference root. */
72
+ export const AST_EDIT_OUTSIDE_ROOT_MESSAGE = "AST edit target resolves outside its root";
73
+
74
+ function isEnoent(error: unknown): boolean {
75
+ return (error as NodeJS.ErrnoException | undefined)?.code === "ENOENT";
76
+ }
77
+
78
+ function staysInside(root: string, target: string): boolean {
79
+ const relative = path.relative(root, target);
80
+ return relative === "" || (relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative));
81
+ }
82
+
83
+ async function realOrLexical(target: string): Promise<string> {
84
+ try {
85
+ return await fs.realpath(target);
86
+ } catch (error) {
87
+ if (isEnoent(error)) return path.resolve(target);
88
+ throw error;
89
+ }
90
+ }
91
+
92
+ /**
93
+ * Native astEdit canonicalizes one file and writes that real path. Directory
94
+ * scans do not follow links. A lexical path inside cwd uses the real cwd as
95
+ * the reference root; an explicit path outside cwd uses its real parent, so a
96
+ * direct file there still applies. Returns the lexical path that would leave
97
+ * that root, if any.
98
+ */
99
+ export async function astEditSingleFileOutsideReferenceRoot(
100
+ cwd: string,
101
+ candidatePaths: readonly string[],
102
+ signal?: AbortSignal,
103
+ ): Promise<string | undefined> {
104
+ signal?.throwIfAborted();
105
+ const resolvedCwd = path.resolve(cwd);
106
+ const realCwd = await realOrLexical(resolvedCwd);
107
+ for (const candidate of candidatePaths) {
108
+ signal?.throwIfAborted();
109
+ const lexical = path.resolve(resolvedCwd, candidate);
110
+ let followed: string;
111
+ try {
112
+ followed = await fs.realpath(lexical);
113
+ } catch (error) {
114
+ if (isEnoent(error)) continue;
115
+ throw error;
116
+ }
117
+ let stat: Stats;
118
+ try {
119
+ stat = await fs.stat(followed);
120
+ } catch (error) {
121
+ if (isEnoent(error)) continue;
122
+ throw error;
123
+ }
124
+ if (!stat.isFile()) continue;
125
+ const root =
126
+ staysInside(resolvedCwd, lexical) || staysInside(realCwd, lexical)
127
+ ? realCwd
128
+ : await realOrLexical(path.dirname(lexical));
129
+ signal?.throwIfAborted();
130
+ if (!staysInside(root, followed)) return lexical;
131
+ }
132
+ return undefined;
133
+ }
@@ -13,10 +13,17 @@ import { assertWorkflowMutationRawPathsAllowed } from "../skill-state/workflow-m
13
13
  import { Ellipsis, fileHyperlink, renderStatusLine, renderTreeList, truncateToWidth } from "../tui";
14
14
  import { resolveFileDisplayMode } from "../utils/file-display-mode";
15
15
  import type { ToolSession } from ".";
16
+ import {
17
+ AST_EDIT_OUTSIDE_ROOT_MESSAGE,
18
+ astEditSingleFileOutsideReferenceRoot,
19
+ resolveAstEditPreviewWritePaths,
20
+ } from "./ast-edit-write-path";
21
+ import { assertEditableFile } from "./auto-generated-guard";
16
22
  import { createFileRecorder, formatResultPath } from "./file-recorder";
17
23
  import { formatGroupedFiles } from "./grouped-file-output";
18
24
  import type { OutputMeta } from "./output-meta";
19
25
  import { resolveToolSearchScope } from "./path-utils";
26
+ import { enforcePlanModeWrite, resolvePlanPath } from "./plan-mode-guard";
20
27
  import {
21
28
  appendParseErrorsBulletList,
22
29
  capParseErrors,
@@ -209,6 +216,18 @@ export class AstEditTool implements AgentTool<typeof astEditSchema, AstEditToolD
209
216
  });
210
217
  const { searchPath: resolvedSearchPath, scopePath, isDirectory, multiTargets, globFilter } = scope;
211
218
 
219
+ const assertSingleFileReferenceRoot = async (flowSignal?: AbortSignal): Promise<void> => {
220
+ const nativeWritePaths = multiTargets ? multiTargets.map(target => target.basePath) : [resolvedSearchPath];
221
+ const outsideRoot = await astEditSingleFileOutsideReferenceRoot(
222
+ this.session.cwd,
223
+ nativeWritePaths,
224
+ flowSignal,
225
+ );
226
+ if (outsideRoot) {
227
+ throw new ToolError(`${AST_EDIT_OUTSIDE_ROOT_MESSAGE}: ${outsideRoot}`);
228
+ }
229
+ };
230
+
212
231
  const result = await runAstEditOnce(multiTargets, resolvedSearchPath, globFilter, {
213
232
  rewrites: normalizedRewrites,
214
233
  dryRun: true,
@@ -329,11 +348,18 @@ export class AstEditTool implements AgentTool<typeof astEditSchema, AstEditToolD
329
348
  label: `AST Edit: ${result.totalReplacements} replacement${previewReplacementPlural} in ${result.filesTouched} file${previewFilePlural}`,
330
349
  sourceToolName: this.name,
331
350
  apply: async (_reason: string) => {
351
+ for (const filePath of previewedFiles) {
352
+ enforcePlanModeWrite(this.session, filePath, { op: "update" });
353
+ }
332
354
  await assertWorkflowMutationRawPathsAllowed({
333
355
  cwd: this.session.cwd,
334
356
  sessionId: this.session.getSessionId?.() ?? undefined,
335
- rawPaths: previewedFiles,
357
+ rawPaths: await resolveAstEditPreviewWritePaths(this.session.cwd, previewedFiles),
336
358
  });
359
+ for (const filePath of previewedFiles) {
360
+ await assertEditableFile(resolvePlanPath(this.session, filePath), filePath, this.session.settings);
361
+ }
362
+ await assertSingleFileReferenceRoot();
337
363
  const applyResult = await runAstEditOnce(multiTargets, resolvedSearchPath, globFilter, {
338
364
  rewrites: normalizedRewrites,
339
365
  dryRun: false,
@@ -11,6 +11,7 @@ import astGrepDescription from "../prompts/tools/ast-grep.md" with { type: "text
11
11
  import { Ellipsis, fileHyperlink, renderStatusLine, renderTreeList, truncateToWidth } from "../tui";
12
12
  import { resolveFileDisplayMode } from "../utils/file-display-mode";
13
13
  import type { ToolSession } from ".";
14
+ import { wrapUntrustedContent } from "./fetch";
14
15
  import { createFileRecorder, formatResultPath } from "./file-recorder";
15
16
  import { formatGroupedFiles } from "./grouped-file-output";
16
17
  import { formatMatchLine } from "./match-line-format";
@@ -213,7 +214,9 @@ export class AstGrepTool implements AgentTool<typeof astGrepSchema, AstGrepToolD
213
214
  const parseMessage = cappedParseErrors.length
214
215
  ? `\n${formatParseErrors(cappedParseErrors, parseErrorsTotal).join("\n")}`
215
216
  : "";
216
- return toolResult(baseDetails).text(`${noMatchMessage}${parseMessage}`).done();
217
+ return toolResult(baseDetails)
218
+ .text(wrapUntrustedContent(`${noMatchMessage}${parseMessage}`))
219
+ .done();
217
220
  }
218
221
 
219
222
  const useHashLines = resolveFileDisplayMode(this.session).hashLines;
@@ -283,7 +286,9 @@ export class AstGrepTool implements AgentTool<typeof astGrepSchema, AstGrepToolD
283
286
  outputLines.push("", ...formatParseErrors(cappedParseErrors, parseErrorsTotal));
284
287
  }
285
288
 
286
- return toolResult(details).text(outputLines.join("\n")).done();
289
+ return toolResult(details)
290
+ .text(wrapUntrustedContent(outputLines.join("\n")))
291
+ .done();
287
292
  });
288
293
  }
289
294
  }