@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
@@ -293,11 +293,131 @@ export function sessionPaths(root: string, sessionId: string): SessionPaths {
293
293
  };
294
294
  }
295
295
 
296
+ const NO_FOLLOW = process.platform === "win32" ? 0 : (fsSync.constants.O_NOFOLLOW ?? 0);
297
+
298
+ function errnoCode(error: unknown): string | undefined {
299
+ return error instanceof Error && "code" in error ? (error as NodeJS.ErrnoException).code : undefined;
300
+ }
301
+
302
+ function sameInode(left: fsSync.BigIntStats, right: fsSync.BigIntStats): boolean {
303
+ return left.dev === right.dev && left.ino === right.ino && left.nlink === right.nlink;
304
+ }
305
+
306
+ /**
307
+ * Leaf directory mode 0700. `lstat` plus `chmod` does not need read permission, so a
308
+ * mode 0300 directory stays writable. A symlink leaf is refused before chmod.
309
+ * This does not pin the directory against a later rename in a writable parent.
310
+ */
311
+ async function ensureOwnerDirectory(dir: string): Promise<void> {
312
+ await fs.mkdir(dir, { recursive: true, mode: 0o700 });
313
+ let current: fsSync.Stats;
314
+ try {
315
+ current = await fs.lstat(dir);
316
+ } catch (error) {
317
+ const code = errnoCode(error);
318
+ if (code === "ELOOP" || code === "ENOTDIR") throw new Error("harness state directory is not a directory");
319
+ throw error;
320
+ }
321
+ if (current.isSymbolicLink() || !current.isDirectory())
322
+ throw new Error("harness state directory is not a directory");
323
+ if (process.platform === "win32" || (current.mode & 0o077) === 0) return;
324
+ await fs.chmod(dir, 0o700);
325
+ const tightened = await fs.lstat(dir);
326
+ if (tightened.isSymbolicLink() || !tightened.isDirectory() || (tightened.mode & 0o777) !== 0o700) {
327
+ throw new Error("harness state directory could not be tightened to mode 0700");
328
+ }
329
+ }
330
+
331
+ async function assertRegularOrMissing(file: string): Promise<void> {
332
+ try {
333
+ const existing = await fs.lstat(file);
334
+ if (existing.isSymbolicLink() || !existing.isFile()) throw new Error("harness state path is not a regular file");
335
+ } catch (error) {
336
+ if (errnoCode(error) !== "ENOENT") throw error;
337
+ }
338
+ }
339
+
340
+ /**
341
+ * Append like the workflow owner-only writer: mode 0600, `O_NOFOLLOW` when the file
342
+ * exists, `O_EXCL` when it does not, and chmod to 0600 when group or other bits are set.
343
+ */
344
+ async function appendOwnerOnly(filePath: string, text: string): Promise<void> {
345
+ await ensureOwnerDirectory(path.dirname(filePath));
346
+ let handle: fs.FileHandle | undefined;
347
+ let initial: fsSync.BigIntStats | undefined;
348
+ for (let attempt = 0; attempt < 2; attempt++) {
349
+ initial = undefined;
350
+ try {
351
+ initial = await fs.lstat(filePath, { bigint: true });
352
+ if (initial.isSymbolicLink() || !initial.isFile()) throw new Error("harness state path is not a regular file");
353
+ } catch (error) {
354
+ if (errnoCode(error) !== "ENOENT") throw error;
355
+ }
356
+ const flags = initial
357
+ ? fsSync.constants.O_WRONLY | fsSync.constants.O_APPEND | NO_FOLLOW
358
+ : fsSync.constants.O_WRONLY | fsSync.constants.O_APPEND | fsSync.constants.O_CREAT | fsSync.constants.O_EXCL;
359
+ try {
360
+ handle = await fs.open(filePath, flags, 0o600);
361
+ break;
362
+ } catch (error) {
363
+ const code = errnoCode(error);
364
+ if (code === "ELOOP") throw new Error("harness state path is not a regular file");
365
+ if (initial === undefined && code === "EEXIST" && attempt === 0) continue;
366
+ throw error;
367
+ }
368
+ }
369
+ if (!handle) throw new Error("harness state path identity changed before append");
370
+ try {
371
+ const opened = await handle.stat({ bigint: true });
372
+ const named = await fs.lstat(filePath, { bigint: true });
373
+ if (
374
+ opened.isSymbolicLink() ||
375
+ !opened.isFile() ||
376
+ named.isSymbolicLink() ||
377
+ !named.isFile() ||
378
+ (initial !== undefined && !sameInode(initial, opened)) ||
379
+ !sameInode(opened, named)
380
+ ) {
381
+ throw new Error("harness state path identity changed before append");
382
+ }
383
+ if (process.platform !== "win32" && (Number(opened.mode) & 0o077) !== 0) {
384
+ await handle.chmod(0o600);
385
+ const tightened = await handle.stat({ bigint: true });
386
+ if ((Number(tightened.mode) & 0o777) !== 0o600) {
387
+ throw new Error("harness state path could not be tightened to mode 0600");
388
+ }
389
+ }
390
+ await handle.writeFile(text, "utf8");
391
+ } finally {
392
+ await handle.close();
393
+ }
394
+ }
395
+
296
396
  async function writeJsonAtomic(file: string, value: unknown): Promise<void> {
297
- await fs.mkdir(path.dirname(file), { recursive: true });
397
+ await ensureOwnerDirectory(path.dirname(file));
398
+ await assertRegularOrMissing(file);
298
399
  const tmp = `${file}.tmp-${randomBytes(4).toString("hex")}`;
299
- await fs.writeFile(tmp, `${JSON.stringify(value, null, 2)}\n`, "utf8");
300
- await fs.rename(tmp, file);
400
+ const flags = fsSync.constants.O_WRONLY | fsSync.constants.O_CREAT | fsSync.constants.O_EXCL | NO_FOLLOW;
401
+ const handle = await fs.open(tmp, flags, 0o600);
402
+ try {
403
+ if (process.platform !== "win32") {
404
+ await handle.chmod(0o600);
405
+ const created = await handle.stat();
406
+ if (!created.isFile() || (created.mode & 0o777) !== 0o600) {
407
+ throw new Error("harness state path could not be tightened to mode 0600");
408
+ }
409
+ }
410
+ await handle.writeFile(`${JSON.stringify(value, null, 2)}\n`, "utf8");
411
+ } finally {
412
+ await handle.close();
413
+ }
414
+ try {
415
+ await assertRegularOrMissing(file);
416
+ await fs.rename(tmp, file);
417
+ } catch (error) {
418
+ await fs.rm(tmp, { force: true }).catch(() => undefined);
419
+ throw error;
420
+ }
301
421
  }
302
422
 
303
423
  async function readJson<T>(file: string): Promise<T | null> {
@@ -396,7 +516,6 @@ export async function resolveHarnessSessionRoot(
396
516
 
397
517
  export async function writeSessionState(root: string, state: SessionState): Promise<void> {
398
518
  const paths = sessionPaths(root, state.sessionId);
399
- await fs.mkdir(paths.dir, { recursive: true });
400
519
  await writeJsonAtomic(paths.state, state);
401
520
  }
402
521
 
@@ -407,8 +526,7 @@ export async function sessionExists(root: string, sessionId: string): Promise<bo
407
526
  /** Append a single severity envelope to events.jsonl. Single-writer discipline is the owner's job (M3). */
408
527
  export async function appendEvent(root: string, sessionId: string, envelope: EventEnvelope): Promise<void> {
409
528
  const paths = sessionPaths(root, sessionId);
410
- await fs.mkdir(paths.dir, { recursive: true });
411
- await fs.appendFile(paths.events, `${JSON.stringify(envelope)}\n`, "utf8");
529
+ await appendOwnerOnly(paths.events, `${JSON.stringify(envelope)}\n`);
412
530
  }
413
531
 
414
532
  /** Read events from cursor (exclusive). Tail-only: never mutates the log. */
@@ -111,7 +111,7 @@ async function preflightHashlineSection(options: ExecuteHashlineSingleOptions &
111
111
 
112
112
  const source = await readHashlineFile(absolutePath, sectionPath);
113
113
  if (!source.exists && hasAnchorScopedEdit(edits)) throw new Error(`File not found: ${sectionPath}`);
114
- if (source.exists) assertEditableFileContent(source.rawContent, sectionPath);
114
+ if (source.exists) assertEditableFileContent(source.rawContent, sectionPath, session.settings);
115
115
 
116
116
  const { text } = stripBom(source.rawContent);
117
117
  const normalized = normalizeToLF(text);
@@ -144,7 +144,7 @@ async function executeHashlineSection(
144
144
 
145
145
  const source = await readHashlineFile(absolutePath, sourcePath);
146
146
  if (!source.exists && hasAnchorScopedEdit(edits)) throw new Error(`File not found: ${sourcePath}`);
147
- if (source.exists) assertEditableFileContent(source.rawContent, sourcePath);
147
+ if (source.exists) assertEditableFileContent(source.rawContent, sourcePath, session.settings);
148
148
 
149
149
  const { bom, text } = stripBom(source.rawContent);
150
150
  const originalEnding = detectLineEnding(text);
@@ -182,7 +182,7 @@ async function executeHashlineSection(
182
182
  // of the file: the model just received it back as the diff/preview. Cache
183
183
  // it so a follow-up edit anchored against this state can still recover
184
184
  // if the file is touched out-of-band before the next edit lands.
185
- getFileReadCache(session).recordContiguous(absolutePath, 1, result.lines.split("\n"));
185
+ getFileReadCache(session).recordFull(absolutePath, result.lines.split("\n"));
186
186
 
187
187
  const diffResult = generateDiffString(originalNormalized, result.lines);
188
188
  const meta = outputMeta()
@@ -1,8 +1,9 @@
1
1
  import * as Diff from "diff";
2
2
  import { generateDiffString } from "../edit/diff";
3
- import type { FileReadCache } from "../edit/file-read-cache";
3
+ import type { FileReadCache, FileReadSnapshot } from "../edit/file-read-cache";
4
4
  import { HashlineMismatchError } from "./anchors";
5
5
  import { applyHashlineEdits, type HashlineApplyResult } from "./apply";
6
+ import { RANGE_INTERIOR_HASH } from "./constants";
6
7
  import { computeLineHash } from "./hash";
7
8
  import type { Anchor, HashlineApplyOptions, HashlineEdit } from "./types";
8
9
 
@@ -28,6 +29,69 @@ const HASHLINE_RECOVERY_FUZZ_FACTOR = 0;
28
29
  const HASHLINE_RECOVERY_WARNING =
29
30
  "Recovered from stale anchors using a previous read snapshot (file changed externally between read and edit).";
30
31
 
32
+ /**
33
+ * Line numbers outside a partial snapshot were filled from the live file when
34
+ * building the replay base, so they say nothing about the version the anchors
35
+ * were authored against. Drop such lines from a hunk's leading and trailing
36
+ * context; refuse the hunk if any remaining old-side line is not covered.
37
+ */
38
+ function trimHunkToSnapshot(
39
+ hunk: Diff.StructuredPatchHunk,
40
+ snapshot: FileReadSnapshot,
41
+ ): Diff.StructuredPatchHunk | null {
42
+ const oldLineNumbers: Array<number | undefined> = [];
43
+ let oldLine = hunk.oldStart;
44
+ for (const line of hunk.lines) {
45
+ if (line[0] === " " || line[0] === "-") oldLineNumbers.push(oldLine++);
46
+ else oldLineNumbers.push(undefined);
47
+ }
48
+ const covered = (index: number): boolean => {
49
+ const lineNum = oldLineNumbers[index];
50
+ return lineNum !== undefined && snapshot.lines.has(lineNum);
51
+ };
52
+
53
+ let start = 0;
54
+ while (start < hunk.lines.length && hunk.lines[start][0] === " " && !covered(start)) start++;
55
+ let end = hunk.lines.length;
56
+ while (end > start && hunk.lines[end - 1][0] === " " && !covered(end - 1)) end--;
57
+ const lines = hunk.lines.slice(start, end);
58
+ for (let index = start; index < end; index++) {
59
+ if (oldLineNumbers[index] !== undefined && !covered(index)) return null;
60
+ }
61
+ return {
62
+ oldStart: hunk.oldStart + start,
63
+ oldLines: lines.filter(line => line[0] === " " || line[0] === "-").length,
64
+ newStart: hunk.newStart + start,
65
+ newLines: lines.filter(line => line[0] === " " || line[0] === "+").length,
66
+ lines,
67
+ };
68
+ }
69
+
70
+ /**
71
+ * `Diff.applyPatch` searches the whole file for a spot where a hunk's context
72
+ * matches, so a hunk whose old side (context + deleted lines) occurs more than
73
+ * once could land on the wrong copy. Refuse such replays.
74
+ */
75
+ function everyHunkLandsUniquely(hunks: Diff.StructuredPatchHunk[], lines: string[]): boolean {
76
+ for (const hunk of hunks) {
77
+ const oldSide = hunk.lines.filter(line => line[0] === " " || line[0] === "-").map(line => line.slice(1));
78
+ if (oldSide.length === 0) return false;
79
+ let occurrences = 0;
80
+ for (let start = 0; start + oldSide.length <= lines.length; start++) {
81
+ let matches = true;
82
+ for (let offset = 0; offset < oldSide.length; offset++) {
83
+ if (lines[start + offset] !== oldSide[offset]) {
84
+ matches = false;
85
+ break;
86
+ }
87
+ }
88
+ if (matches && ++occurrences > 1) return false;
89
+ }
90
+ if (occurrences !== 1) return false;
91
+ }
92
+ return true;
93
+ }
94
+
31
95
  /** Collect every line anchor an edit batch depends on. */
32
96
  function collectEditAnchors(edits: HashlineEdit[]): Anchor[] {
33
97
  const anchors: Anchor[] = [];
@@ -64,11 +128,14 @@ export function tryRecoverHashlineWithCache(args: HashlineRecoveryArgs): Hashlin
64
128
  // Precondition: the model's anchors must be vouched-for by the cache. If
65
129
  // even one anchored line is missing from the snapshot, or its cached
66
130
  // content hashes to a different value than the model supplied, refuse —
67
- // any merge from here is a guess.
131
+ // any merge from here is a guess. Range interiors carry no model-supplied
132
+ // hash (the endpoints vouch for the range), so they only need to be present;
133
+ // the replayed hunk still has to match those snapshot lines exactly.
68
134
  const anchors = collectEditAnchors(edits);
69
135
  for (const anchor of anchors) {
70
136
  const cachedLine = snapshot.lines.get(anchor.line);
71
137
  if (cachedLine === undefined) return null;
138
+ if (anchor.hash === RANGE_INTERIOR_HASH) continue;
72
139
  if (computeLineHash(anchor.line, cachedLine) !== anchor.hash) return null;
73
140
  }
74
141
 
@@ -81,6 +148,9 @@ export function tryRecoverHashlineWithCache(args: HashlineRecoveryArgs): Hashlin
81
148
  for (const [lineNum, content] of snapshot.lines) {
82
149
  overlaid[lineNum - 1] = content;
83
150
  }
151
+ // A full-file snapshot is authoritative about length too: live lines past
152
+ // its end did not exist in the version the anchors were authored against.
153
+ if (snapshot.lineCount !== undefined) overlaid.length = snapshot.lineCount;
84
154
  const previousText = overlaid.join("\n");
85
155
  if (previousText === currentText) return null;
86
156
 
@@ -94,6 +164,19 @@ export function tryRecoverHashlineWithCache(args: HashlineRecoveryArgs): Hashlin
94
164
  if (applied.lines === previousText) return null;
95
165
 
96
166
  const patch = Diff.structuredPatch("file", "file", previousText, applied.lines, "", "", { context: 3 });
167
+ const hunks: Diff.StructuredPatchHunk[] = [];
168
+ for (const hunk of patch.hunks) {
169
+ const trimmed = trimHunkToSnapshot(hunk, snapshot);
170
+ if (!trimmed) return null;
171
+ hunks.push(trimmed);
172
+ }
173
+ patch.hunks = hunks;
174
+ // Content is the only location evidence a replayed hunk carries, so it must
175
+ // identify one site in the authored version and in the live file. A single
176
+ // live match may otherwise be an unrelated identical copy left standing after
177
+ // the anchored copy changed out-of-band.
178
+ if (!everyHunkLandsUniquely(hunks, previousText.split("\n"))) return null;
179
+ if (!everyHunkLandsUniquely(hunks, currentText.split("\n"))) return null;
97
180
  const merged = Diff.applyPatch(currentText, patch, { fuzzFactor: HASHLINE_RECOVERY_FUZZ_FACTOR });
98
181
  if (typeof merged !== "string" || merged === currentText) return null;
99
182
 
@@ -62,11 +62,17 @@ function envBool(value: string | undefined): boolean | undefined {
62
62
  return ["true", "1", "yes"].includes(value.toLowerCase());
63
63
  }
64
64
 
65
- /** Coerce an env var value into an int, returning undefined for non-numeric input. */
65
+ /**
66
+ * Coerce an env var value into a non-negative int, returning undefined (so the
67
+ * settings value applies) for anything that is not plain digits. `parseInt`
68
+ * alone would read "5turns" as 5, "1e3" as 1 and "-3" as -3.
69
+ */
66
70
  function envInt(value: string | undefined): number | undefined {
67
71
  if (value === undefined) return undefined;
68
- const n = Number.parseInt(value, 10);
69
- return Number.isFinite(n) ? n : undefined;
72
+ const trimmed = value.trim();
73
+ if (!/^\d+$/.test(trimmed)) return undefined;
74
+ const n = Number(trimmed);
75
+ return Number.isSafeInteger(n) ? n : undefined;
70
76
  }
71
77
 
72
78
  function envString(value: string | undefined): string | undefined {
@@ -20,27 +20,126 @@ export interface RecallResultLike {
20
20
  mentioned_at?: string | null;
21
21
  }
22
22
 
23
- const MEMORIES_REGEX = /<memories>[\s\S]*?<\/memories>/g;
24
- const LEGACY_HINDSIGHT_MEMORIES_REGEX = /<hindsight_memories>[\s\S]*?<\/hindsight_memories>/g;
25
- const LEGACY_RELEVANT_MEMORIES_REGEX = /<relevant_memories>[\s\S]*?<\/relevant_memories>/g;
26
- const MENTAL_MODELS_REGEX = /<mental_models>[\s\S]*?<\/mental_models>/g;
23
+ const MEMORY_TAG_NAMES = ["memories", "hindsight_memories", "relevant_memories", "mental_models"] as const;
24
+
25
+ function memoryTagExpression(name: string): RegExp {
26
+ return new RegExp(`<\\s*\\/?\\s*${name}\\s*>`, "gi");
27
+ }
28
+
29
+ interface MemoryTagSpan {
30
+ start: number;
31
+ end: number;
32
+ close: boolean;
33
+ paired: boolean;
34
+ absorbed: boolean;
35
+ }
36
+
37
+ function findMemoryTagSpans(content: string, name: string): MemoryTagSpan[] {
38
+ const spans: MemoryTagSpan[] = [];
39
+ for (const match of content.matchAll(memoryTagExpression(name))) {
40
+ const raw = match[0];
41
+ const start = match.index ?? 0;
42
+ spans.push({
43
+ start,
44
+ end: start + raw.length,
45
+ close: raw.includes("/"),
46
+ paired: false,
47
+ absorbed: false,
48
+ });
49
+ }
50
+ return spans;
51
+ }
52
+
53
+ function mergeSpans(ranges: Array<[number, number]>): Array<[number, number]> {
54
+ const sorted = ranges.filter(([start, end]) => end > start).sort((a, b) => a[0] - b[0] || b[1] - a[1]);
55
+ const merged: Array<[number, number]> = [];
56
+ for (const [start, end] of sorted) {
57
+ const last = merged[merged.length - 1];
58
+ if (!last || start > last[1]) merged.push([start, end]);
59
+ else last[1] = Math.max(last[1], end);
60
+ }
61
+ return merged;
62
+ }
63
+
64
+ /**
65
+ * Remove one memory-tag family.
66
+ *
67
+ * A matched block is removed whole. An extra closer after that block is the
68
+ * recall frame ending early: the escaped text through that closer is removed
69
+ * so it is not retained as instructions. A closer or opener with no block
70
+ * before it is removed as a token only, and the surrounding prose stays.
71
+ */
72
+ function stripMemoryTagFamily(content: string, name: string): string {
73
+ const tags = findMemoryTagSpans(content, name);
74
+ if (tags.length === 0) return content;
75
+
76
+ const ranges: Array<[number, number]> = [];
77
+ const stack: MemoryTagSpan[] = [];
78
+ for (const tag of tags) {
79
+ if (!tag.close) {
80
+ stack.push(tag);
81
+ continue;
82
+ }
83
+ const open = stack.pop();
84
+ if (!open) continue;
85
+ open.paired = true;
86
+ tag.paired = true;
87
+ ranges.push([open.start, tag.end]);
88
+ }
89
+
90
+ for (const tag of tags) {
91
+ if (!tag.close || tag.paired) continue;
92
+ let previous: MemoryTagSpan | undefined;
93
+ for (const candidate of tags) {
94
+ if (candidate.end <= tag.start) previous = candidate;
95
+ else break;
96
+ }
97
+ const followsClosedBlock = Boolean(previous?.close && (previous.paired || previous.absorbed));
98
+ if (followsClosedBlock && previous) {
99
+ ranges.push([previous.end, tag.end]);
100
+ tag.absorbed = true;
101
+ } else {
102
+ ranges.push([tag.start, tag.end]);
103
+ }
104
+ }
105
+
106
+ for (const tag of tags) {
107
+ if (!tag.close && !tag.paired) ranges.push([tag.start, tag.end]);
108
+ }
109
+
110
+ let out = content;
111
+ for (const [start, end] of mergeSpans(ranges).reverse()) {
112
+ out = out.slice(0, start) + out.slice(end);
113
+ }
114
+ return out;
115
+ }
116
+
117
+ /** Escape recognized tag delimiters so recalled text cannot close the outer frame. */
118
+ function stripMemoryTagTokens(text: string): string {
119
+ let out = text;
120
+ for (const name of MEMORY_TAG_NAMES) {
121
+ out = out.replace(memoryTagExpression(name), tag => tag.replace("<", "&lt;"));
122
+ }
123
+ return out;
124
+ }
27
125
 
28
126
  /**
29
127
  * Strip `<memories>`, `<mental_models>`, and legacy memory blocks.
30
128
  *
31
- * Both `<memories>` (per-turn recall) and `<mental_models>` (curated semantic
32
- * memory) are injected into the system prompt. If either leaks into the
33
- * retention transcript, every retain becomes a tighter feedback loop —
34
- * paraphrased memories feed the next consolidation, which feeds the next
35
- * mental-model refresh, which feeds the next retain. Always strip before
36
- * retaining.
129
+ * Matching is case-insensitive and allows whitespace inside the tag.
130
+ * Both per-turn recall and curated mental models are injected around the
131
+ * prompt. If a closer, a case variant, or an early-ended frame leaks into
132
+ * the retention transcript, the next retain stores the breakout as a new
133
+ * memory. Always strip before retaining.
37
134
  */
38
135
  export function stripMemoryTags(content: string): string {
39
- return content
40
- .replace(MEMORIES_REGEX, "")
41
- .replace(MENTAL_MODELS_REGEX, "")
42
- .replace(LEGACY_HINDSIGHT_MEMORIES_REGEX, "")
43
- .replace(LEGACY_RELEVANT_MEMORIES_REGEX, "");
136
+ let out = content;
137
+ while (true) {
138
+ let stripped = out;
139
+ for (const name of MEMORY_TAG_NAMES) stripped = stripMemoryTagFamily(stripped, name);
140
+ if (stripped === out) return out;
141
+ out = stripped;
142
+ }
44
143
  }
45
144
 
46
145
  /** Format recall results into a bullet list for context injection. */
@@ -50,7 +149,8 @@ export function formatMemories(results: RecallResultLike[]): string {
50
149
  .map(r => {
51
150
  const typeStr = r.type ? ` [${r.type}]` : "";
52
151
  const dateStr = r.mentioned_at ? ` (${r.mentioned_at})` : "";
53
- return `- ${r.text}${typeStr}${dateStr}`;
152
+ const text = stripMemoryTagTokens(r.text);
153
+ return `- ${text}${typeStr}${dateStr}`;
54
154
  })
55
155
  .join("\n\n");
56
156
  }
@@ -219,6 +219,17 @@ const TRUNCATION_MARKER = "\n\n…[mental-model snapshot truncated at render bud
219
219
  */
220
220
  const MIN_CONTENT_ROOM_CHARS = 64;
221
221
 
222
+ const MEMORY_FRAME_NAMES = ["memories", "hindsight_memories", "relevant_memories", "mental_models"] as const;
223
+
224
+ /** Escape the same frame tokens as recalled memory text so a stored closer cannot end this block early. */
225
+ function escapeMemoryFrameTokens(text: string): string {
226
+ let out = text;
227
+ for (const name of MEMORY_FRAME_NAMES) {
228
+ out = out.replace(new RegExp(`<\\s*\\/?\\s*${name}\\s*>`, "gi"), tag => tag.replace("<", "&lt;"));
229
+ }
230
+ return out;
231
+ }
232
+
222
233
  /** Smallest budget that can yield a usable block (wrapper + preamble + marker + a few chars of content). */
223
234
  function minRenderBudgetChars(): number {
224
235
  const cleanOverhead = `<mental_models>\n${PREAMBLE}\n\n\n</mental_models>`.length;
@@ -235,7 +246,6 @@ export function renderMentalModelsBlock(models: MentalModelSummary[], budgetChar
235
246
  if (budgetChars < minRenderBudgetChars()) return "";
236
247
 
237
248
  const truncatedOverhead = `<mental_models>\n${PREAMBLE}\n\n${TRUNCATION_MARKER}\n</mental_models>`.length;
238
- const cleanOverhead = `<mental_models>\n${PREAMBLE}\n\n\n</mental_models>`.length;
239
249
  const innerBudget = Math.max(0, budgetChars - truncatedOverhead);
240
250
  const perModelBudget = Math.max(120, Math.floor(innerBudget / Math.max(1, models.length)));
241
251
 
@@ -260,18 +270,20 @@ export function renderMentalModelsBlock(models: MentalModelSummary[], budgetChar
260
270
  consumed += sectionCost;
261
271
  }
262
272
 
273
+ // Escape after the heading/body join. A closer split across that newline
274
+ // (`</mental_models` + `>`) is not visible in either field alone.
275
+ // The wrapper is added after this step and is not escaped.
276
+ let inner = escapeMemoryFrameTokens(sections.join("\n\n"));
263
277
  const tail = truncated ? TRUNCATION_MARKER : "";
264
- let assembled = `<mental_models>\n${PREAMBLE}\n\n${sections.join("\n\n")}${tail}\n</mental_models>`;
278
+ let assembled = `<mental_models>\n${PREAMBLE}\n\n${inner}${tail}\n</mental_models>`;
265
279
 
266
- // Final hard-cap: if the careful per-model budgeting still slips past the
267
- // requested ceiling (small budgets, fat preambles, etc.), brutally truncate
268
- // the body region while keeping the wrapper intact so `stripMemoryTags` can
269
- // still find the closing tag.
280
+ // Final hard-cap: slice the already escaped body so a cut cannot restore a raw closer.
281
+ // The marker is always appended on this path, so reserve its overhead.
282
+ // Escaped tags are longer than the raw text the per-model budget measured.
270
283
  if (assembled.length > budgetChars) {
271
- const overhead = truncated ? truncatedOverhead : cleanOverhead;
272
- const room = Math.max(0, budgetChars - overhead);
273
- const body = sections.join("\n\n").slice(0, room).trimEnd();
274
- assembled = `<mental_models>\n${PREAMBLE}\n\n${body}${TRUNCATION_MARKER}\n</mental_models>`;
284
+ const room = Math.max(0, budgetChars - truncatedOverhead);
285
+ inner = inner.slice(0, room).trimEnd();
286
+ assembled = `<mental_models>\n${PREAMBLE}\n\n${inner}${TRUNCATION_MARKER}\n</mental_models>`;
275
287
  }
276
288
  return assembled;
277
289
  }
@@ -1,6 +1,7 @@
1
1
  import { createHash } from "node:crypto";
2
2
 
3
3
  import { logger } from "@sayknow-cli/utils";
4
+ import { redactMemorySecretsForTesting as redactMemorySecrets } from "../memories";
4
5
  import type { AgentSession } from "../session/agent-session";
5
6
  import { type BankScope, ensureBankMission } from "./bank";
6
7
  import type { HindsightApi, MemoryItemInput } from "./client";
@@ -149,8 +150,8 @@ export class HindsightRetainQueue {
149
150
  try {
150
151
  await ensureBankMission(state.client, state.bankId, state.config, state.missionsSet);
151
152
  const batch: MemoryItemInput[] = items.map(item => ({
152
- content: item.content,
153
- context: item.context ?? state.config.retainContext,
153
+ content: redactMemorySecrets(item.content),
154
+ context: item.context === undefined ? state.config.retainContext : redactMemorySecrets(item.context),
154
155
  metadata: { session_id: sessionId },
155
156
  tags: state.retainTags,
156
157
  }));
@@ -316,8 +317,10 @@ export class HindsightSessionState {
316
317
  documentId = `${this.sessionId}-${Date.now()}`;
317
318
  }
318
319
 
319
- const { transcript } = prepareRetentionTranscript(target, true);
320
- if (!transcript) return false;
320
+ const prepared = prepareRetentionTranscript(target, true);
321
+ if (!prepared.transcript) return false;
322
+ // Same scrub the local memory backend applies before it stores consolidation text.
323
+ const transcript = redactMemorySecrets(prepared.transcript);
321
324
 
322
325
  await ensureBankMission(this.client, this.bankId, this.config, this.missionsSet);
323
326
  await this.client.retain(this.bankId, transcript, {
@@ -2,11 +2,13 @@ import { appendFile, mkdir, stat } from "node:fs/promises";
2
2
  import * as os from "node:os";
3
3
  import * as path from "node:path";
4
4
  import { getAgentDir, getConfigDirName } from "@sayknow-cli/utils";
5
+ import { projectEnvSnapshot } from "@sayknow-cli/utils/env-file";
5
6
  import { YAML } from "bun";
6
7
  import type { SkillDiscoverySettings } from "../config/skill-settings-defaults";
7
8
  import { DEFAULT_DISABLED_EXTENSIONS, DEFAULT_SKILL_DISCOVERY_SETTINGS } from "../config/skill-settings-defaults";
8
9
  import type { PromptTriager } from "../decisions/prompt-triage";
9
10
  import { sessionLogsDir } from "../skc-runtime/session-layout";
11
+ import { trustedCoordinatorEnv } from "../skc-runtime/sidecar-bootstrap-env";
10
12
  import { routeNativePrompt } from "./native-prompt-routing";
11
13
  import {
12
14
  buildActiveUltragoalPromptContext,
@@ -278,14 +280,14 @@ function readTurnId(payload: HookPayload): string | undefined {
278
280
  return safeString(payload.turn_id ?? payload.turnId).trim() || undefined;
279
281
  }
280
282
 
281
- function readSessionFile(payload: HookPayload): string | undefined {
282
- return (
283
- safeString(
284
- payload.session_file ?? payload.sessionFile ?? payload.transcript_path ?? payload.transcriptPath,
285
- ).trim() ||
286
- process.env.SKC_SESSION_FILE?.trim() ||
287
- undefined
288
- );
283
+ function readSessionFile(payload: HookPayload, cwd: string): string | undefined {
284
+ const explicit = safeString(
285
+ payload.session_file ?? payload.sessionFile ?? payload.transcript_path ?? payload.transcriptPath,
286
+ ).trim();
287
+ if (explicit) return explicit;
288
+ // Bun has already copied the project dotenv into the environment. A value
289
+ // that matches that snapshot must not select another transcript.
290
+ return trustedCoordinatorEnv("SKC_SESSION_FILE", process.env, projectEnvSnapshot(cwd));
289
291
  }
290
292
 
291
293
  export async function dispatchSkcNativeSkillHook(
@@ -308,6 +310,7 @@ async function dispatchSkcNativeSkillHookInner(
308
310
  ): Promise<SkcNativeHookDispatchResult> {
309
311
  const hookEventName = readHookEventName(payload);
310
312
  const cwd = (options.cwd ?? safeString(payload.cwd).trim()) || process.cwd();
313
+ const sessionFile = readSessionFile(payload, cwd);
311
314
  if (hookEventName === "UserPromptSubmit") {
312
315
  const prompt = readPromptText(payload);
313
316
  // Compute the bundled UI-skill directive first so a later state/recovery
@@ -332,7 +335,7 @@ async function dispatchSkcNativeSkillHookInner(
332
335
  threadId: readThreadId(payload),
333
336
  stateDir: options.stateDir,
334
337
  prompt,
335
- sessionFile: readSessionFile(payload),
338
+ sessionFile,
336
339
  });
337
340
  recoveryContext = buildStateRecoveryDiagnosticsContext(recoveryDiagnostics);
338
341
  } catch {
@@ -384,7 +387,7 @@ async function dispatchSkcNativeSkillHookInner(
384
387
  threadId: readThreadId(payload),
385
388
  stateDir: options.stateDir,
386
389
  prompt,
387
- sessionFile: readSessionFile(payload),
390
+ sessionFile,
388
391
  });
389
392
  } catch {
390
393
  activeUltragoalContext = null;
@@ -432,7 +435,7 @@ async function dispatchSkcNativeSkillHookInner(
432
435
  sessionId: readSessionId(payload),
433
436
  threadId: readThreadId(payload),
434
437
  stateDir: options.stateDir,
435
- sessionFile: readSessionFile(payload),
438
+ sessionFile,
436
439
  }),
437
440
  };
438
441
  }
@@ -466,7 +469,9 @@ async function readStdinJson(): Promise<{ payload: HookPayload; parseError: Erro
466
469
  }
467
470
 
468
471
  async function logHookError(cwd: string, type: string, error: unknown): Promise<void> {
469
- const skcSessionId = process.env.SKC_SESSION_ID?.trim();
472
+ // Bun has already copied the project dotenv into the environment. A value
473
+ // that matches that snapshot must not select another session's log directory.
474
+ const skcSessionId = trustedCoordinatorEnv("SKC_SESSION_ID", process.env, projectEnvSnapshot(cwd));
470
475
  if (!skcSessionId) {
471
476
  console.error(
472
477
  JSON.stringify({
@@ -589,6 +589,9 @@ export const deSettings: Record<string, string> = {
589
589
  "skill-Tool aktivieren, damit der Agent im nächsten Zug zu einer anderen verfügbaren Skill wechseln kann",
590
590
  "set:fetch.enabled:l": "URLs lesen",
591
591
  "set:fetch.enabled:d": "read-Tool das Abrufen und Verarbeiten von URLs erlauben",
592
+ "set:reverseEngineer.enabled:l": "Reverse Engineer (REA)",
593
+ "set:reverseEngineer.enabled:d":
594
+ "reverse_engineer-Werkzeug aktivieren (REA über npx/bunx), um etwas nach einem vom Benutzer angegebenen Link, einer App oder Binärdatei nachzubauen",
592
595
  "set:gitlab.enabled:l": "GitLab CLI",
593
596
  "set:gitlab.enabled:d":
594
597
  "gitlab-Werkzeug aktivieren (op-basierte Ausführung für Merge-Request-Erstellung/-Ansicht/-Liste und Pipeline-Status über glab)",