@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
@@ -6,6 +6,7 @@
6
6
  import * as fs from "node:fs/promises";
7
7
  import { executeShell, type MinimizerOptions, Shell } from "@sayknow-cli/natives";
8
8
  import { postmortem } from "@sayknow-cli/utils";
9
+ import { projectDeclaredSpawnHookNames, stripProjectSpawnHooks } from "@sayknow-cli/utils/shell-config";
9
10
  import { Settings, type ShellMinimizerSettings } from "../config/settings";
10
11
  import { formatCrashDiagnosticNotice, writeCrashReport } from "../debug/crash-diagnostics";
11
12
  import { OutputSink } from "../session/streaming-output";
@@ -25,10 +26,14 @@ export interface BashExecutorOptions {
25
26
  */
26
27
  onRawChunk?: (chunk: string) => void;
27
28
  signal?: AbortSignal;
29
+ /** Session settings used for shell policy; defaults to the process settings. */
30
+ settings?: Settings;
28
31
  /** Session key suffix to isolate shell sessions per agent */
29
32
  sessionKey?: string;
30
33
  /** Additional environment variables to inject */
31
34
  env?: Record<string, string>;
35
+ /** Environment variable names to remove for this command only. Explicit `env` values win. */
36
+ unsetEnv?: string[];
32
37
  /** Artifact path/id for full output storage */
33
38
  artifactPath?: string;
34
39
  artifactId?: string;
@@ -110,29 +115,105 @@ async function resolveShellCwd(cwd: string | undefined): Promise<string | undefi
110
115
  }
111
116
  }
112
117
 
118
+ function presentMinimizerString(value: unknown): string | undefined {
119
+ return typeof value === "string" && value.length > 0 ? value : undefined;
120
+ }
121
+
122
+ type ShellMinimizerSource = {
123
+ getGroup(prefix: "shellMinimizer"): ShellMinimizerSettings;
124
+ getGlobal?(path: "shellMinimizer.settingsPath" | "shellMinimizer.settingsHash"): unknown;
125
+ getOverride?(path: "shellMinimizer.settingsPath"): unknown;
126
+ };
127
+
128
+ /**
129
+ * A repo `.skc/settings.json` must not point the minimizer at a TOML file.
130
+ * The native gate loads that file only when `settingsHash` matches, and the
131
+ * pin is the user/global value. A user path or a runtime override is still
132
+ * passed through. A project path is passed only together with that pin.
133
+ */
134
+ export function resolveTrustedShellMinimizer(settings: ShellMinimizerSource): ShellMinimizerSettings {
135
+ const group = settings.getGroup("shellMinimizer");
136
+ const globalPath =
137
+ typeof settings.getGlobal === "function"
138
+ ? presentMinimizerString(settings.getGlobal("shellMinimizer.settingsPath"))
139
+ : undefined;
140
+ const globalHash =
141
+ typeof settings.getGlobal === "function"
142
+ ? presentMinimizerString(settings.getGlobal("shellMinimizer.settingsHash"))
143
+ : undefined;
144
+ const overridePath =
145
+ typeof settings.getOverride === "function"
146
+ ? presentMinimizerString(settings.getOverride("shellMinimizer.settingsPath"))
147
+ : undefined;
148
+ const effectivePath = presentMinimizerString(group.settingsPath);
149
+
150
+ let settingsPath: string | undefined;
151
+ if (overridePath && effectivePath === overridePath) {
152
+ settingsPath = overridePath;
153
+ } else if (globalPath) {
154
+ settingsPath = globalPath;
155
+ } else if (effectivePath && globalHash) {
156
+ settingsPath = effectivePath;
157
+ }
158
+
159
+ // A runtime override of a different path is operator input, not the file the
160
+ // user hash pins. Every other admitted path is checked with that pin.
161
+ const unpinnedOverride = overridePath !== undefined && settingsPath === overridePath && settingsPath !== globalPath;
162
+ return {
163
+ ...group,
164
+ settingsPath,
165
+ settingsHash: globalHash && settingsPath && !unpinnedOverride ? globalHash : undefined,
166
+ };
167
+ }
168
+
113
169
  /** Translate `ShellMinimizerSettings` into native `MinimizerOptions`, or `undefined` when disabled. */
114
170
  export function buildMinimizerOptions(group: ShellMinimizerSettings): MinimizerOptions | undefined {
115
171
  if (!group.enabled) return undefined;
172
+ const settingsPath = group.settingsPath || undefined;
173
+ const settingsHash = settingsPath && group.settingsHash ? group.settingsHash : undefined;
116
174
  return {
117
175
  enabled: true,
118
- settingsPath: group.settingsPath || undefined,
176
+ settingsPath,
177
+ ...(settingsHash ? { settingsHash } : {}),
119
178
  only: group.only.length > 0 ? group.only : undefined,
120
179
  except: group.except.length > 0 ? group.except : undefined,
121
180
  maxCaptureBytes: group.maxCaptureBytes,
122
181
  };
123
182
  }
124
183
 
184
+ function projectHookUnsetEnv(
185
+ unsetEnv: string[] | undefined,
186
+ env: Record<string, string> | undefined,
187
+ sessionEnv: Record<string, string>,
188
+ ): string[] | undefined {
189
+ // Keys present in `sessionEnv` (e.g. the trusted HOME replacement) already
190
+ // override the ambient import, so only shadow the ones it does not carry.
191
+ const hooks = projectDeclaredSpawnHookNames().filter(
192
+ name => !Object.hasOwn(env ?? {}, name) && !Object.hasOwn(sessionEnv, name),
193
+ );
194
+ if (hooks.length === 0) return unsetEnv;
195
+ return [...(unsetEnv ?? []), ...hooks.filter(name => !unsetEnv?.includes(name))];
196
+ }
197
+
125
198
  export async function executeBash(command: string, options?: BashExecutorOptions): Promise<BashResult> {
126
- const settings = await Settings.init();
127
- const { shell, env: shellEnv, prefix } = settings.getShellConfig();
199
+ const settings = options?.settings ?? (await Settings.init());
200
+ const { shell, env: configEnv, prefix } = settings.getShellConfig();
201
+ // The shell config env is shared with other consumers (Python kernels keep
202
+ // their own documented allowlist). Only the bash tool's shell must not see
203
+ // project hook variables such as GIT_CONFIG_* or NODE_OPTIONS.
204
+ const shellEnv = stripProjectSpawnHooks({ ...configEnv });
128
205
  const configuredPrefix = options?.ignoreShellPrefix ? undefined : prefix;
129
206
  const snapshotPath =
130
207
  !options?.disableShellSnapshot && shell.includes("bash") ? await getOrCreateSnapshot(shell, shellEnv) : null;
131
208
 
132
- const minimizer = buildMinimizerOptions(settings.getGroup("shellMinimizer"));
209
+ const minimizer = buildMinimizerOptions(resolveTrustedShellMinimizer(settings));
133
210
 
134
211
  const commandCwd = await resolveShellCwd(options?.cwd);
135
212
  const commandEnv = options?.env ? { ...NON_INTERACTIVE_ENV, ...options.env } : NON_INTERACTIVE_ENV;
213
+ // The native shell runs in-process and imports the host environment, which
214
+ // holds the autoloaded project `.env`, before `sessionEnv`. Shadow project
215
+ // hook variables per run unless this call sets them explicitly.
216
+ const unsetEnv = projectHookUnsetEnv(options?.unsetEnv, options?.env, shellEnv);
136
217
 
137
218
  // Apply command prefix if configured and allowed for this execution.
138
219
  const prefixedCommand = configuredPrefix ? `${configuredPrefix} ${command}` : command;
@@ -234,6 +315,7 @@ export async function executeBash(command: string, options?: BashExecutorOptions
234
315
  command: finalCommand,
235
316
  cwd: commandCwd,
236
317
  env: commandEnv,
318
+ unsetEnv,
237
319
  timeoutMs: executionTimeoutMs,
238
320
  signal: runAbortController.signal,
239
321
  },
@@ -248,6 +330,7 @@ export async function executeBash(command: string, options?: BashExecutorOptions
248
330
  command: finalCommand,
249
331
  cwd: commandCwd,
250
332
  env: commandEnv,
333
+ unsetEnv,
251
334
  sessionEnv: shellEnv,
252
335
  snapshotPath: snapshotPath ?? undefined,
253
336
  minimizer,
@@ -24,7 +24,6 @@ export const NON_INTERACTIVE_ENV: Readonly<Record<string, string>> = {
24
24
  EDITOR: "true",
25
25
  GIT_TERMINAL_PROMPT: "0",
26
26
  SSH_ASKPASS: "/usr/bin/false",
27
- CI: "1",
28
27
  // Package manager defaults for unattended execution.
29
28
  npm_config_yes: "true",
30
29
  npm_config_update_notifier: "false",
@@ -0,0 +1,9 @@
1
+ const SAFE_CSS_COLOR =
2
+ /^(?:#[0-9a-fA-F]{3,8}|rgb\(\s*\d{1,3}\s*,\s*\d{1,3}\s*,\s*\d{1,3}\s*\)|rgba\(\s*\d{1,3}\s*,\s*\d{1,3}\s*,\s*\d{1,3}\s*,\s*(?:0|1|0?\.\d+)\s*\))$/;
3
+
4
+ /** Keep a theme color that is safe to place in a `<style>` block. */
5
+ export function cssColorOrFallback(value: string | undefined, fallback: string): string {
6
+ const trimmed = value?.trim();
7
+ if (trimmed && SAFE_CSS_COLOR.test(trimmed)) return trimmed;
8
+ return fallback;
9
+ }
@@ -0,0 +1,16 @@
1
+ import * as fs from "node:fs";
2
+
3
+ const HTML_EXPORT_DESTINATION_OPEN_FLAGS =
4
+ fs.constants.O_WRONLY | fs.constants.O_CREAT | (process.platform === "win32" ? 0 : (fs.constants.O_NOFOLLOW ?? 0));
5
+
6
+ /** Owner-only HTML export. A replaced file is locked down on the opened descriptor. */
7
+ export function openHtmlExportDestination(outputPath: string): number {
8
+ const fd = fs.openSync(outputPath, HTML_EXPORT_DESTINATION_OPEN_FLAGS, 0o600);
9
+ try {
10
+ fs.fchmodSync(fd, 0o600);
11
+ return fd;
12
+ } catch (error) {
13
+ fs.closeSync(fd);
14
+ throw error;
15
+ }
16
+ }
@@ -1,9 +1,12 @@
1
+ import * as fs from "node:fs";
1
2
  import * as path from "node:path";
2
3
  import type { AgentState } from "@sayknow-cli/agent-core";
3
- import { APP_NAME, isEnoent } from "@sayknow-cli/utils";
4
+ import { APP_NAME, isCredentialKey, isEnoent, redactCrashSecrets } from "@sayknow-cli/utils";
4
5
  import { getResolvedThemeColors, getThemeExportColors } from "../../modes/theme/theme";
5
6
  import { type SessionEntry, type SessionHeader, SessionManager } from "../../session/session-manager";
6
7
  // Pre-generated template (created by scripts/generate-template.ts at publish time)
8
+ import { cssColorOrFallback } from "./css-color";
9
+ import { openHtmlExportDestination } from "./html-export-destination";
7
10
  import { TEMPLATE } from "./template.generated";
8
11
 
9
12
  export interface ExportOptions {
@@ -76,16 +79,16 @@ async function generateThemeVars(themeName?: string): Promise<string> {
76
79
  const colors = await getResolvedThemeColors(themeName);
77
80
  const lines: string[] = [];
78
81
  for (const [key, value] of Object.entries(colors)) {
79
- lines.push(`--${key}: ${value};`);
82
+ lines.push(`--${key}: ${cssColorOrFallback(value, "transparent")};`);
80
83
  }
81
84
 
82
85
  const themeExport = await getThemeExportColors(themeName);
83
86
  const userMessageBg = colors.userMessageBg || "#343541";
84
87
  const derived = deriveExportColors(userMessageBg);
85
88
 
86
- lines.push(`--body-bg: ${themeExport.pageBg ?? derived.pageBg};`);
87
- lines.push(`--container-bg: ${themeExport.cardBg ?? derived.cardBg};`);
88
- lines.push(`--info-bg: ${themeExport.infoBg ?? derived.infoBg};`);
89
+ lines.push(`--body-bg: ${cssColorOrFallback(themeExport.pageBg, derived.pageBg)};`);
90
+ lines.push(`--container-bg: ${cssColorOrFallback(themeExport.cardBg, derived.cardBg)};`);
91
+ lines.push(`--info-bg: ${cssColorOrFallback(themeExport.infoBg, derived.infoBg)};`);
89
92
 
90
93
  return lines.join(" ");
91
94
  }
@@ -98,10 +101,90 @@ interface SessionData {
98
101
  tools?: { name: string; description: string }[];
99
102
  }
100
103
 
104
+ /**
105
+ * Own `__proto__` stays a data property; a normal object would turn that assignment into the prototype.
106
+ * Credential keys mask every JSON value, and string values are scrubbed directly so JSON escaping
107
+ * cannot turn ordinary quote characters into credential-value delimiters.
108
+ */
109
+ function redactJsonValue(value: unknown): unknown {
110
+ if (typeof value === "string") return redactCrashSecrets(value);
111
+ if (Array.isArray(value)) {
112
+ const isFlatKeyValueArray =
113
+ value.length > 0 &&
114
+ value.length % 2 === 0 &&
115
+ value.every((item, index) => index % 2 === 1 || typeof item === "string");
116
+ if (isFlatKeyValueArray) {
117
+ return value.map((item, index) => {
118
+ if (index % 2 === 1) {
119
+ const key = value[index - 1];
120
+ if (typeof key === "string" && isCredentialKey(key)) return "«redacted»";
121
+ }
122
+ return redactJsonValue(item);
123
+ });
124
+ }
125
+ return value.map(item => redactJsonValue(item));
126
+ }
127
+ if (value === null || typeof value !== "object") return value;
128
+ const source = value as Record<string, unknown>;
129
+ const sourceKeys = Object.keys(source);
130
+ let hasCredentialHeaderName = false;
131
+ let hasHeaderValue = false;
132
+ for (const key of sourceKeys) {
133
+ const field = key.toLowerCase();
134
+ if (field === "value" || field === "values") hasHeaderValue = true;
135
+ if (field !== "name" && field !== "key") continue;
136
+ const headerName = source[key];
137
+ if (typeof headerName === "string" && isCredentialKey(headerName)) hasCredentialHeaderName = true;
138
+ }
139
+ const redactHeaderValue = hasCredentialHeaderName && hasHeaderValue;
140
+ const redacted = Object.create(null) as Record<string, unknown>;
141
+ const nextSuffixByKey = new Map<string, number>();
142
+ for (const key of sourceKeys) {
143
+ const redactedKey = uniqueJsonObjectKey(redacted, redactCrashSecrets(key), nextSuffixByKey);
144
+ const field = key.toLowerCase();
145
+ if (redactHeaderValue && (field === "value" || field === "values")) {
146
+ const headerValue = source[key];
147
+ redacted[redactedKey] =
148
+ field === "values" && Array.isArray(headerValue) ? headerValue.map(() => "«redacted»") : "«redacted»";
149
+ } else {
150
+ redacted[redactedKey] = redactKeyedValue(key, source[key]);
151
+ }
152
+ }
153
+ return redacted;
154
+ }
155
+
156
+ // Resume after the last collision for this base key rather than rescanning prior suffixes.
157
+ function uniqueJsonObjectKey(
158
+ target: Record<string, unknown>,
159
+ key: string,
160
+ nextSuffixByKey: Map<string, number>,
161
+ ): string {
162
+ if (!Object.hasOwn(target, key)) return key;
163
+ let suffix = nextSuffixByKey.get(key) ?? 2;
164
+ let candidate = `${key}#${suffix}`;
165
+ while (Object.hasOwn(target, candidate)) {
166
+ suffix += 1;
167
+ candidate = `${key}#${suffix}`;
168
+ }
169
+ nextSuffixByKey.set(key, suffix + 1);
170
+ return candidate;
171
+ }
172
+
173
+ function redactKeyedValue(key: string, value: unknown): unknown {
174
+ // A recognized key is authoritative for every JSON type, including a short
175
+ // string, a number, an array, or a nested object.
176
+ if (isCredentialKey(key)) return "«redacted»";
177
+ return typeof value === "string" ? redactCrashSecrets(value) : redactJsonValue(value);
178
+ }
179
+
180
+ function sessionEmbedJson(value: unknown): string {
181
+ return JSON.stringify(redactJsonValue(JSON.parse(JSON.stringify(value))));
182
+ }
183
+
101
184
  /** Generate HTML from bundled template with runtime substitutions. */
102
185
  async function generateHtml(sessionData: SessionData, themeName?: string): Promise<string> {
103
186
  const themeVars = await generateThemeVars(themeName);
104
- const sessionDataBase64 = Buffer.from(JSON.stringify(sessionData)).toBase64();
187
+ const sessionDataBase64 = Buffer.from(sessionEmbedJson(sessionData)).toBase64();
105
188
 
106
189
  // Use function replacements so `$'`, `$&`, `$$`, `$n`, etc. in the
107
190
  // substituted CSS/base64 are not interpreted as substitution patterns
@@ -112,6 +195,17 @@ async function generateHtml(sessionData: SessionData, themeName?: string): Promi
112
195
  );
113
196
  }
114
197
 
198
+ /** Write the export through an owner-only, no-follow descriptor; a replaced file is truncated on it. */
199
+ function writeHtmlExport(outputPath: string, html: string): void {
200
+ const fd = openHtmlExportDestination(outputPath);
201
+ try {
202
+ fs.ftruncateSync(fd, 0);
203
+ fs.writeFileSync(fd, html);
204
+ } finally {
205
+ fs.closeSync(fd);
206
+ }
207
+ }
208
+
115
209
  /** Export session to HTML using SessionManager and AgentState. */
116
210
  export async function exportSessionToHtml(
117
211
  sm: SessionManager,
@@ -134,7 +228,7 @@ export async function exportSessionToHtml(
134
228
  const html = await generateHtml(sessionData, opts.themeName);
135
229
  const outputPath = opts.outputPath || `${APP_NAME}-session-${path.basename(sessionFile, ".jsonl")}.html`;
136
230
 
137
- await Bun.write(outputPath, html);
231
+ writeHtmlExport(outputPath, html);
138
232
  return outputPath;
139
233
  }
140
234
 
@@ -160,7 +254,7 @@ export async function exportFromFile(inputPath: string, options?: ExportOptions
160
254
  const html = await generateHtml(sessionData, opts.themeName);
161
255
  const outputPath = opts.outputPath || `${APP_NAME}-session-${path.basename(inputPath, ".jsonl")}.html`;
162
256
 
163
- await Bun.write(outputPath, html);
257
+ writeHtmlExport(outputPath, html);
164
258
  return outputPath;
165
259
  } finally {
166
260
  await sm.close();