@sayknow-cli/coding-agent 0.7.11 → 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 +10 -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 +116 -8
  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
@@ -25,10 +25,37 @@ export interface EventReplay {
25
25
  gap?: EventReplayGap;
26
26
  }
27
27
 
28
+ /** Kinds emit sites suppress once notification redaction is on. */
29
+ const REDACTED_REPLAY_KINDS: ReadonlySet<string> = new Set([
30
+ "turn_stream",
31
+ "context_update",
32
+ "image_attachment",
33
+ "file_attachment",
34
+ "reasoning_summary",
35
+ "tool_activity",
36
+ ]);
37
+
38
+ const outboundRedactBySession = new Map<string, boolean>();
39
+
40
+ /** Notification policy refresh records the live redaction bit for one session ring. */
41
+ export function setSessionOutboundRedact(sessionId: string, enabled: boolean): void {
42
+ outboundRedactBySession.set(sessionId, enabled);
43
+ }
44
+
45
+ function frameSessionId(frame: SdkFrame): string | undefined {
46
+ if (typeof frame.sessionId === "string") return frame.sessionId;
47
+ const payload = frame.payload;
48
+ if (!payload || typeof payload !== "object") return undefined;
49
+ const sessionId = (payload as { sessionId?: unknown }).sessionId;
50
+ return typeof sessionId === "string" ? sessionId : undefined;
51
+ }
52
+
28
53
  export class SessionEventStream {
29
54
  #generation = 0;
30
55
  #seq = 0;
31
56
  #frames: EventFrame[] = [];
57
+ #outboundRedact = false;
58
+ #sessionId: string | undefined;
32
59
  readonly #ringSize: number;
33
60
  readonly #resyncQueries: string[];
34
61
 
@@ -45,6 +72,12 @@ export class SessionEventStream {
45
72
  return this.#seq;
46
73
  }
47
74
 
75
+ /** Follow the session redaction bit. Replay then drops kinds emit sites already suppress. */
76
+ setOutboundRedact(enabled: boolean): void {
77
+ this.#outboundRedact = enabled;
78
+ if (this.#sessionId !== undefined) outboundRedactBySession.set(this.#sessionId, enabled);
79
+ }
80
+
48
81
  restart(): number {
49
82
  this.#generation += 1;
50
83
  this.#seq = 0;
@@ -53,6 +86,8 @@ export class SessionEventStream {
53
86
  }
54
87
 
55
88
  emit(frame: SdkFrame): EventFrame {
89
+ this.#noteSession(frame);
90
+ this.#noteConfigRedact(frame);
56
91
  const event: EventFrame = { ...frame, type: "event", generation: this.#generation, seq: ++this.#seq };
57
92
  this.#frames.push(event);
58
93
  if (this.#frames.length > this.#ringSize) this.#frames.shift();
@@ -61,10 +96,9 @@ export class SessionEventStream {
61
96
 
62
97
  /** Replays retained current-generation events and reports any required resynchronization. */
63
98
  replay(lastSeq: number, generation = this.#generation): EventReplay {
64
- const events = this.#frames.filter(frame => frame.seq > lastSeq);
65
99
  if (generation !== this.#generation) {
66
100
  return {
67
- events: [...this.#frames],
101
+ events: this.#visible(this.#frames),
68
102
  gap: {
69
103
  kind: "generation_reset",
70
104
  fromGeneration: generation,
@@ -77,7 +111,7 @@ export class SessionEventStream {
77
111
  const replayFrom = lastSeq + 1;
78
112
  if (replayFrom < oldest) {
79
113
  return {
80
- events: this.#frames.filter(frame => frame.seq >= oldest),
114
+ events: this.#visible(this.#frames.filter(frame => frame.seq >= oldest)),
81
115
  gap: {
82
116
  kind: "sequence_gap",
83
117
  fromSeq: replayFrom,
@@ -86,6 +120,35 @@ export class SessionEventStream {
86
120
  },
87
121
  };
88
122
  }
89
- return { events };
123
+ return { events: this.#visible(this.#frames.filter(frame => frame.seq > lastSeq)) };
124
+ }
125
+
126
+ #noteSession(frame: SdkFrame): void {
127
+ if (this.#sessionId !== undefined) return;
128
+ this.#sessionId = frameSessionId(frame);
129
+ }
130
+
131
+ #noteConfigRedact(frame: SdkFrame): void {
132
+ if (frame.kind !== "config_update") return;
133
+ const payload = frame.payload;
134
+ if (!payload || typeof payload !== "object") return;
135
+ const redact = (payload as { redact?: unknown }).redact;
136
+ if (typeof redact !== "boolean") return;
137
+ this.setOutboundRedact(redact);
138
+ }
139
+
140
+ #replayRedact(): boolean {
141
+ if (this.#sessionId !== undefined) {
142
+ const noted = outboundRedactBySession.get(this.#sessionId);
143
+ if (noted !== undefined) return noted;
144
+ }
145
+ return this.#outboundRedact;
146
+ }
147
+
148
+ #visible(frames: readonly EventFrame[]): EventFrame[] {
149
+ const retained = this.#replayRedact()
150
+ ? frames.filter(frame => !REDACTED_REPLAY_KINDS.has(String(frame.kind)))
151
+ : frames;
152
+ return [...retained];
90
153
  }
91
154
  }
@@ -1,5 +1,5 @@
1
1
  import path from "node:path";
2
- import { getAgentDir } from "@sayknow-cli/utils";
2
+ import { getAgentDir, VERSION } from "@sayknow-cli/utils";
3
3
  import { ensureBroker } from "../broker/ensure";
4
4
  import { SdkClient, SdkClientError } from "../client/client";
5
5
  import {
@@ -12,6 +12,8 @@ import { validateAdapterControl, validateAdapterSecretFields } from "../protocol
12
12
  import { adapterDispositionError, findOperation } from "../protocol/operation-registry";
13
13
 
14
14
  const PROTOCOL_VERSION = "2024-11-05";
15
+ const SUPPORTED_PROTOCOL_VERSIONS = [PROTOCOL_VERSION, "2025-03-26", "2025-06-18"] as const;
16
+ const NEWEST_PROTOCOL_VERSION = SUPPORTED_PROTOCOL_VERSIONS[SUPPORTED_PROTOCOL_VERSIONS.length - 1];
15
17
  const SERVER_NAME = "skc-sdk-mcp";
16
18
  const ENDPOINT_CREDENTIAL_OPERATION = "session.get_endpoint";
17
19
 
@@ -101,6 +103,17 @@ function isObject(value: unknown): value is Arguments {
101
103
  return typeof value === "object" && value !== null && !Array.isArray(value);
102
104
  }
103
105
 
106
+ /** Echo a supported client protocol version; otherwise offer the newest one this server speaks. */
107
+ function negotiatedProtocolVersion(params: unknown): string {
108
+ const requestedProtocolVersion = isObject(params) ? params.protocolVersion : undefined;
109
+ if (
110
+ typeof requestedProtocolVersion === "string" &&
111
+ (SUPPORTED_PROTOCOL_VERSIONS as readonly string[]).includes(requestedProtocolVersion)
112
+ )
113
+ return requestedProtocolVersion;
114
+ return NEWEST_PROTOCOL_VERSION;
115
+ }
116
+
104
117
  function asString(args: Arguments, name: string): string | null {
105
118
  return typeof args[name] === "string" && args[name] ? (args[name] as string) : null;
106
119
  }
@@ -271,9 +284,9 @@ export function createSdkMcpServer(options: SdkMcpServerOptions = {}) {
271
284
  jsonrpc: "2.0",
272
285
  id,
273
286
  result: {
274
- protocolVersion: PROTOCOL_VERSION,
287
+ protocolVersion: negotiatedProtocolVersion(request.params),
275
288
  capabilities: { tools: {} },
276
- serverInfo: { name: SERVER_NAME },
289
+ serverInfo: { name: SERVER_NAME, version: VERSION },
277
290
  },
278
291
  };
279
292
  if (request.method === "tools/list")
@@ -3388,6 +3388,28 @@
3388
3388
  "testIds": "not_applicable"
3389
3389
  }
3390
3390
  },
3391
+ {
3392
+ "sourceId": "agent_session:resolvePromptSkillInvocation",
3393
+ "sourceFile": "packages/coding-agent/src/session/agent-session.ts",
3394
+ "sourceKind": "agent_session",
3395
+ "decision": "exclude",
3396
+ "rationale": "internal prompt-dispatch classifier shared with interactive title seeding, not a user-facing control seam",
3397
+ "exclusionMetadata": {
3398
+ "adapterMappings": "not_applicable",
3399
+ "testIds": "not_applicable"
3400
+ }
3401
+ },
3402
+ {
3403
+ "sourceId": "agent_session:isLocallyHandledSlashCommand",
3404
+ "sourceFile": "packages/coding-agent/src/session/agent-session.ts",
3405
+ "sourceKind": "agent_session",
3406
+ "decision": "exclude",
3407
+ "rationale": "internal slash-command classifier that keeps command text out of title seeding, not a user-facing control seam",
3408
+ "exclusionMetadata": {
3409
+ "adapterMappings": "not_applicable",
3410
+ "testIds": "not_applicable"
3411
+ }
3412
+ },
3391
3413
  {
3392
3414
  "sourceId": "agent_session:prompt",
3393
3415
  "sourceFile": "packages/coding-agent/src/session/agent-session.ts",
@@ -34,6 +34,7 @@ import {
34
34
  resolveAppendOnlyMode,
35
35
  } from "../append-only-mode";
36
36
  import { type AsyncJob, AsyncJobManager, isBackgroundJobSupportEnabled, jobElapsedMs } from "../async";
37
+ import { formatAsyncResultForFollowUp } from "../async/result-formatting";
37
38
  import { loadCapability } from "../capability";
38
39
  import { type Rule, ruleCapability, setActiveRules } from "../capability/rule";
39
40
  import { kNoAuth, ModelRegistry } from "../config/model-registry";
@@ -90,6 +91,7 @@ import btwUserPrompt from "../prompts/system/btw-user.md" with { type: "text" };
90
91
  import asyncResultTemplate from "../prompts/tools/async-result.md" with { type: "text" };
91
92
  import { AgentRegistry, MAIN_AGENT_ID } from "../registry/agent-registry";
92
93
  import { MCPManager } from "../runtime-mcp";
94
+ import { omitPluginMcpNameShadows, retainPluginMcpMandatoryNames } from "../runtime-mcp/plugin-mcp-name-filter";
93
95
  import { createNotificationsExtension } from "../sdk/bus";
94
96
  import {
95
97
  getNotificationConfig,
@@ -156,6 +158,7 @@ import {
156
158
  WriteTool,
157
159
  } from "../tools";
158
160
  import { ToolContextStore } from "../tools/context";
161
+ import { wrapUntrustedContent } from "../tools/fetch";
159
162
  import { getImageGenTools } from "../tools/image-gen";
160
163
  import { wrapToolWithMetaNotice } from "../tools/output-meta";
161
164
  import { guardToolForUltragoalAsk } from "../tools/ultragoal-ask-guard";
@@ -862,7 +865,10 @@ function buildMCPPromptCommands(manager: MCPManager): LoadedCustomCommand[] {
862
865
  }
863
866
  }
864
867
  }
865
- return parts.join("\n\n");
868
+ const body = parts.join("\n\n");
869
+ // A blank body must stay blank so the prompt entry still rejects it.
870
+ if (body.trim().length === 0) return body;
871
+ return wrapUntrustedContent(body);
866
872
  },
867
873
  },
868
874
  });
@@ -1387,28 +1393,6 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
1387
1393
 
1388
1394
  const backgroundJobsEnabled = isBackgroundJobSupportEnabled(settings);
1389
1395
  const asyncMaxJobs = Math.min(100, Math.max(1, settings.get("async.maxJobs") ?? 100));
1390
- const ASYNC_INLINE_RESULT_MAX_CHARS = 12_000;
1391
- const ASYNC_PREVIEW_MAX_CHARS = 4_000;
1392
- const formatAsyncResultForFollowUp = async (result: string): Promise<string> => {
1393
- if (result.length <= ASYNC_INLINE_RESULT_MAX_CHARS) {
1394
- return result;
1395
- }
1396
-
1397
- const preview = `${result.slice(0, ASYNC_PREVIEW_MAX_CHARS)}\n\n[Output truncated. Showing first ${ASYNC_PREVIEW_MAX_CHARS.toLocaleString()} characters.]`;
1398
- try {
1399
- const { path: artifactPath, id: artifactId } = await sessionManager.allocateArtifactPath("async");
1400
- if (artifactPath && artifactId) {
1401
- await Bun.write(artifactPath, result);
1402
- return `${preview}\nFull output: artifact://${artifactId}`;
1403
- }
1404
- } catch (error) {
1405
- logger.warn("Failed to persist async follow-up artifact", {
1406
- error: error instanceof Error ? error.message : String(error),
1407
- });
1408
- }
1409
-
1410
- return preview;
1411
- };
1412
1396
  // Only top-level sessions own an AsyncJobManager. Subagents reach the
1413
1397
  // parent's manager via `AsyncJobManager.instance()` (set below), so creating
1414
1398
  // a second instance here just to leave it orphaned wastes a constructor and
@@ -1419,7 +1403,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
1419
1403
  maxRunningJobs: asyncMaxJobs,
1420
1404
  onJobComplete: async (jobId, result, job) => {
1421
1405
  if (!session || asyncJobManager!.isDeliverySuppressed(jobId)) return;
1422
- const formattedResult = await formatAsyncResultForFollowUp(result);
1406
+ const formattedResult = await formatAsyncResultForFollowUp(sessionManager, result);
1423
1407
  if (asyncJobManager!.isDeliverySuppressed(jobId)) return;
1424
1408
 
1425
1409
  const durationMs = job ? jobElapsedMs(job) : undefined;
@@ -1500,6 +1484,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
1500
1484
  getWorkflowGateEmitter: () => session?.getWorkflowGateEmitter(),
1501
1485
  getAskAnswerSource: () => session?.getAskAnswerSource(),
1502
1486
  getGoalRuntime: () => session?.goalRuntime,
1487
+ getSdkPermissionMode: () => session?.sdkPermissionMode ?? "allow",
1503
1488
  getClientBridge: () => session?.clientBridge,
1504
1489
  getCompactContext: () => session.formatCompactContext(),
1505
1490
  getTodoPhases: () => session.getTodoPhases(),
@@ -1761,7 +1746,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
1761
1746
  // register in-process tools/providers without enabling filesystem discovery.
1762
1747
  const inlineExtensions: ExtensionFactory[] = [...(options.extensions ?? [])];
1763
1748
  if (customTools.length > 0) {
1764
- inlineExtensions.push(createCustomToolsExtension(customTools));
1749
+ inlineExtensions.push(createCustomToolsExtension(omitPluginMcpNameShadows(customTools)));
1765
1750
  }
1766
1751
 
1767
1752
  // Always-on constrained plugin hooks (validated registry surfaces). Additive
@@ -2192,6 +2177,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
2192
2177
  repeatToolDescriptions,
2193
2178
  intentField,
2194
2179
  toolDiscoveryActive: effectiveDiscoveryMode === "all" || mcpDiscoveryEnabled,
2180
+ reverseEngineerAvailable: toolRegistry.has("reverse_engineer"),
2195
2181
  eagerTasks,
2196
2182
  secretsEnabled,
2197
2183
  reasoningLanguage,
@@ -2271,6 +2257,13 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
2271
2257
  }
2272
2258
  }
2273
2259
  }
2260
+ // Mandatory names follow the plugin tools that survived registration.
2261
+ // A colliding user tool keeps the normalized name and must stay selectable.
2262
+ pluginMcpToolNames.splice(
2263
+ 0,
2264
+ pluginMcpToolNames.length,
2265
+ ...retainPluginMcpMandatoryNames(customTools, pluginMcpToolNames),
2266
+ );
2274
2267
  const mandatoryMCPToolNameSet = new Set(pluginMcpToolNames);
2275
2268
  const selectableExplicitMCPToolNames = explicitlyRequestedMCPToolNames.filter(
2276
2269
  name => !mandatoryMCPToolNameSet.has(name),
@@ -21,17 +21,95 @@ export interface SecretEntry {
21
21
 
22
22
  const REPLACEMENT_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
23
23
 
24
- /** Generate a deterministic same-length replacement string from a secret value. */
25
- function generateDeterministicReplacement(secret: string): string {
26
- // Simple hash: use Bun.hash for speed, seed from the secret bytes
27
- const hash = BigInt(Bun.hash(secret));
24
+ /**
25
+ * Domain separator for replace-mode replacement derivation. Distinct from
26
+ * `PLACEHOLDER_DOMAIN` so a value minted under one construction can never be
27
+ * confused with a value minted under the other, even with the same key.
28
+ */
29
+ const REPLACEMENT_DOMAIN = "skc.secret-obfuscation.replacement.v1\0";
30
+
31
+ /** One HMAC-SHA256 digest block length in bytes. */
32
+ const REPLACEMENT_DIGEST_BYTES = 32;
33
+
34
+ /** Largest accepted byte for uniform rejection sampling (256 - (256 % 62)). */
35
+ const REPLACEMENT_REJECT_THRESHOLD = 248;
36
+
37
+ /**
38
+ * Generate a deterministic, keyed, same-length replacement string from a
39
+ * secret value.
40
+ *
41
+ * COMPATIBILITY CONTRACT (required behavior, must never regress):
42
+ * - Deterministic within a process: the same secret under the same key always
43
+ * yields the same replacement, independent of entry order or call order.
44
+ * - Same length: `result.length === secret.length` (UTF-16 code units, i.e.
45
+ * `String.prototype.length` semantics — unchanged from the pre-fix
46
+ * implementation). Astral-plane characters count as two units, exactly as
47
+ * they did before.
48
+ * - Allowed characters: output is restricted to `[A-Za-z0-9]` (62 chars).
49
+ * - Explicit `replacement` values in secrets.yml are authoritative and are
50
+ * never derived; this path runs only when `replacement` is undefined.
51
+ * - Replace mode stays one-way: the derived value is never reversed by
52
+ * `deobfuscate()`.
53
+ *
54
+ * THREAT MODEL (issue #4166):
55
+ * - Attacker model: an observer sees one or more replacements (model context,
56
+ * provider-side logs, saved/shared transcripts) and has full knowledge of
57
+ * the public algorithm. Without the 32-byte obfuscation key they cannot
58
+ * confirm a candidate secret offline and cannot predict or precompute the
59
+ * replacement for any secret. The construction is a keyed PRF
60
+ * (HMAC-SHA256), so output is unpredictable without the key, and keyed
61
+ * domain separation keeps this construction distinct from the placeholder
62
+ * construction.
63
+ * - Accepted residual disclosure: the replacement is same-length by design
64
+ * (required behavior above), so the secret's exact length is still
65
+ * observable. This is inherent to size-preserving substitution and is
66
+ * explicitly out of scope; the fix removes the *keyless confirmation*
67
+ * oracle, not the length signal.
68
+ * - Cross-process stability / key rotation: the process key is generated per
69
+ * process (`PROCESS_SECRET_OBFUSCATION_KEY`), so derived replacements are
70
+ * stable within a process and differ across processes or after a key
71
+ * rotation. This is a deliberate decision, identical in scope to the
72
+ * obfuscate-mode placeholder behavior. Users who need stable values across
73
+ * processes or restarts must set an explicit `replacement` in secrets.yml.
74
+ * - Collision/bias: output is a keyed pseudorandom mapping. Two distinct
75
+ * secrets can in principle collide (birthday bound over the 62^len output
76
+ * space); for realistic secret lengths this is negligible. Character
77
+ * distribution is uniform by construction: digest bytes are rejection-
78
+ * sampled (bytes 248-255 rejected, 256 - (256 % 62) = 248 = 62 * 4), so
79
+ * every character is exactly equally likely, with no modulo bias.
80
+ * - Empty secrets: a zero-length secret yields an empty replacement and the
81
+ * obfuscator treats it as a no-op (load-time validation rejects empty
82
+ * content anyway). Unicode secrets are hashed as UTF-8 bytes, so encoding
83
+ * is canonical. Very long secrets expand via a counter-based HMAC stream
84
+ * in O(length) blocks; generation cost is linear in the secret length.
85
+ * - Overlapping secrets and streaming: derivation is per-secret and does not
86
+ * depend on matching semantics (longest-first overlap handling is
87
+ * unchanged), and `obfuscate()` runs per complete text payload, so chunked
88
+ * output (e.g. streamed LLM messages) sees the same deterministic
89
+ * replacement for the same secret within a process.
90
+ */
91
+ function generateDeterministicReplacement(secret: string, key: Uint8Array): string {
92
+ const length = secret.length;
93
+ if (length === 0) return "";
28
94
  const chars: string[] = [];
29
- let h = hash;
30
- for (let i = 0; i < secret.length; i++) {
31
- // Mix the hash for each character position
32
- h = h ^ (BigInt(i + 1) * 0x9e3779b97f4a7c15n);
33
- const idx = Number((h < 0n ? -h : h) % BigInt(REPLACEMENT_CHARS.length));
34
- chars.push(REPLACEMENT_CHARS[idx]);
95
+ // CTR-style expansion: HMAC(key, DOMAIN || counter || secret) per 32-byte
96
+ // block. The counter is big-endian and fixed-width, so the stream is
97
+ // unambiguous and never repeats.
98
+ const counter = new Uint8Array(8);
99
+ const counterView = new DataView(counter.buffer);
100
+ let block: Uint8Array | undefined;
101
+ let blockOffset = REPLACEMENT_DIGEST_BYTES;
102
+ let blockIndex = 0;
103
+ while (chars.length < length) {
104
+ if (block === undefined || blockOffset >= REPLACEMENT_DIGEST_BYTES) {
105
+ counterView.setUint32(4, blockIndex, false);
106
+ block = createHmac("sha256", key).update(REPLACEMENT_DOMAIN).update(counter).update(secret, "utf8").digest();
107
+ blockOffset = 0;
108
+ blockIndex++;
109
+ }
110
+ const byte = block[blockOffset++]!;
111
+ if (byte >= REPLACEMENT_REJECT_THRESHOLD) continue;
112
+ chars.push(REPLACEMENT_CHARS[byte % REPLACEMENT_CHARS.length]!);
35
113
  }
36
114
  return chars.join("");
37
115
  }
@@ -115,7 +193,8 @@ export class SecretObfuscator {
115
193
  index++;
116
194
  } else {
117
195
  // replace mode
118
- const replacement = entry.replacement ?? generateDeterministicReplacement(entry.content);
196
+ const replacement =
197
+ entry.replacement ?? generateDeterministicReplacement(entry.content, this.#placeholderKey);
119
198
  this.#replaceMappings.set(entry.content, replacement);
120
199
  }
121
200
  } else {
@@ -168,7 +247,8 @@ export class SecretObfuscator {
168
247
 
169
248
  for (const matchValue of matches) {
170
249
  if (entry.mode === "replace") {
171
- const replacement = entry.replacement ?? generateDeterministicReplacement(matchValue);
250
+ const replacement =
251
+ entry.replacement ?? generateDeterministicReplacement(matchValue, this.#placeholderKey);
172
252
  result = replaceAll(result, matchValue, replacement);
173
253
  } else {
174
254
  // obfuscate mode — get or create stable index