@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
@@ -15,6 +15,7 @@
15
15
  * - Questions may time out and auto-select the recommended option (configurable, disabled in plan mode)
16
16
  */
17
17
  import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@sayknow-cli/agent-core";
18
+ import type { RawArgumentValidationResult } from "@sayknow-cli/ai/types";
18
19
  import { type Component } from "@sayknow-cli/tui";
19
20
  import * as z from "zod/v4";
20
21
  import type { RenderResultOptions } from "../extensibility/custom-tools/types";
@@ -191,133 +192,34 @@ declare const topologyAskSchema: z.ZodObject<{
191
192
  execution: "execution";
192
193
  }>;
193
194
  }, z.core.$strip>>;
194
- deepInterview: z.ZodOptional<z.ZodType<{
195
- round: 0;
196
- component: "review-topology";
197
- intent_contract: {
198
- items: {
199
- id: string;
200
- category: "surface" | "artifact" | "integration" | "constraint";
201
- statement: string;
202
- }[];
203
- confirmation_options: string[];
204
- };
205
- dimension: string;
206
- ambiguity: number;
207
- round_id?: string | undefined;
208
- confused_terms?: string[] | undefined;
209
- references?: {
210
- reference_id: string;
211
- label: string;
212
- origin: string;
213
- url?: string | undefined;
214
- excerpt?: string | undefined;
215
- }[] | undefined;
216
- } | {
217
- round: number;
218
- intent_review: {
219
- observed_items: {
220
- id: string;
221
- category: "surface" | "artifact" | "integration" | "constraint";
222
- statement: string;
223
- }[];
224
- supporting_substitutions: {
225
- removed_id: string;
226
- replacement_ids: string[];
227
- rationale: string;
228
- }[];
229
- approval_options: string[];
230
- };
231
- component: string;
232
- dimension: string;
233
- ambiguity: number;
234
- round_id?: string | undefined;
235
- confused_terms?: string[] | undefined;
236
- references?: {
237
- reference_id: string;
238
- label: string;
239
- origin: string;
240
- url?: string | undefined;
241
- excerpt?: string | undefined;
242
- }[] | undefined;
243
- } | {
244
- round: number;
245
- component: string;
246
- dimension: string;
247
- ambiguity: number;
248
- round_id?: string | undefined;
249
- confused_terms?: string[] | undefined;
250
- references?: {
251
- reference_id: string;
252
- label: string;
253
- origin: string;
254
- url?: string | undefined;
255
- excerpt?: string | undefined;
256
- }[] | undefined;
257
- }, unknown, z.core.$ZodTypeInternals<{
258
- round: 0;
259
- component: "review-topology";
260
- intent_contract: {
261
- items: {
262
- id: string;
263
- category: "surface" | "artifact" | "integration" | "constraint";
264
- statement: string;
265
- }[];
266
- confirmation_options: string[];
267
- };
268
- dimension: string;
269
- ambiguity: number;
270
- round_id?: string | undefined;
271
- confused_terms?: string[] | undefined;
272
- references?: {
273
- reference_id: string;
274
- label: string;
275
- origin: string;
276
- url?: string | undefined;
277
- excerpt?: string | undefined;
278
- }[] | undefined;
279
- } | {
280
- round: number;
281
- intent_review: {
282
- observed_items: {
283
- id: string;
284
- category: "surface" | "artifact" | "integration" | "constraint";
285
- statement: string;
286
- }[];
287
- supporting_substitutions: {
288
- removed_id: string;
289
- replacement_ids: string[];
290
- rationale: string;
291
- }[];
292
- approval_options: string[];
293
- };
294
- component: string;
295
- dimension: string;
296
- ambiguity: number;
297
- round_id?: string | undefined;
298
- confused_terms?: string[] | undefined;
299
- references?: {
300
- reference_id: string;
301
- label: string;
302
- origin: string;
303
- url?: string | undefined;
304
- excerpt?: string | undefined;
305
- }[] | undefined;
306
- } | {
307
- round: number;
308
- component: string;
309
- dimension: string;
310
- ambiguity: number;
311
- round_id?: string | undefined;
312
- confused_terms?: string[] | undefined;
313
- references?: {
314
- reference_id: string;
315
- label: string;
316
- origin: string;
317
- url?: string | undefined;
318
- excerpt?: string | undefined;
319
- }[] | undefined;
320
- }, unknown>>>;
195
+ deepInterview: z.ZodObject<{
196
+ round: z.ZodLiteral<0>;
197
+ component: z.ZodLiteral<"review-topology">;
198
+ intent_contract: z.ZodObject<{
199
+ items: z.ZodArray<z.ZodObject<{
200
+ id: z.ZodString;
201
+ category: z.ZodEnum<{
202
+ surface: "surface";
203
+ artifact: "artifact";
204
+ integration: "integration";
205
+ constraint: "constraint";
206
+ }>;
207
+ statement: z.ZodString;
208
+ }, z.core.$strict>>;
209
+ confirmation_options: z.ZodArray<z.ZodString>;
210
+ }, z.core.$strict>;
211
+ round_id: z.ZodOptional<z.ZodString>;
212
+ dimension: z.ZodString;
213
+ ambiguity: z.ZodNumber;
214
+ confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
215
+ references: z.ZodOptional<z.ZodArray<z.ZodObject<{
216
+ reference_id: z.ZodString;
217
+ label: z.ZodString;
218
+ origin: z.ZodString;
219
+ url: z.ZodOptional<z.ZodString>;
220
+ excerpt: z.ZodOptional<z.ZodString>;
221
+ }, z.core.$strict>>>;
222
+ }, z.core.$strict>;
321
223
  }, z.core.$strip>>;
322
224
  }, z.core.$strip>;
323
225
  declare const postTopologyAskSchema: z.ZodObject<{
@@ -341,133 +243,53 @@ declare const postTopologyAskSchema: z.ZodObject<{
341
243
  execution: "execution";
342
244
  }>;
343
245
  }, z.core.$strip>>;
344
- deepInterview: z.ZodOptional<z.ZodType<{
345
- round: 0;
346
- component: "review-topology";
347
- intent_contract: {
348
- items: {
349
- id: string;
350
- category: "surface" | "artifact" | "integration" | "constraint";
351
- statement: string;
352
- }[];
353
- confirmation_options: string[];
354
- };
355
- dimension: string;
356
- ambiguity: number;
357
- round_id?: string | undefined;
358
- confused_terms?: string[] | undefined;
359
- references?: {
360
- reference_id: string;
361
- label: string;
362
- origin: string;
363
- url?: string | undefined;
364
- excerpt?: string | undefined;
365
- }[] | undefined;
366
- } | {
367
- round: number;
368
- intent_review: {
369
- observed_items: {
370
- id: string;
371
- category: "surface" | "artifact" | "integration" | "constraint";
372
- statement: string;
373
- }[];
374
- supporting_substitutions: {
375
- removed_id: string;
376
- replacement_ids: string[];
377
- rationale: string;
378
- }[];
379
- approval_options: string[];
380
- };
381
- component: string;
382
- dimension: string;
383
- ambiguity: number;
384
- round_id?: string | undefined;
385
- confused_terms?: string[] | undefined;
386
- references?: {
387
- reference_id: string;
388
- label: string;
389
- origin: string;
390
- url?: string | undefined;
391
- excerpt?: string | undefined;
392
- }[] | undefined;
393
- } | {
394
- round: number;
395
- component: string;
396
- dimension: string;
397
- ambiguity: number;
398
- round_id?: string | undefined;
399
- confused_terms?: string[] | undefined;
400
- references?: {
401
- reference_id: string;
402
- label: string;
403
- origin: string;
404
- url?: string | undefined;
405
- excerpt?: string | undefined;
406
- }[] | undefined;
407
- }, unknown, z.core.$ZodTypeInternals<{
408
- round: 0;
409
- component: "review-topology";
410
- intent_contract: {
411
- items: {
412
- id: string;
413
- category: "surface" | "artifact" | "integration" | "constraint";
414
- statement: string;
415
- }[];
416
- confirmation_options: string[];
417
- };
418
- dimension: string;
419
- ambiguity: number;
420
- round_id?: string | undefined;
421
- confused_terms?: string[] | undefined;
422
- references?: {
423
- reference_id: string;
424
- label: string;
425
- origin: string;
426
- url?: string | undefined;
427
- excerpt?: string | undefined;
428
- }[] | undefined;
429
- } | {
430
- round: number;
431
- intent_review: {
432
- observed_items: {
433
- id: string;
434
- category: "surface" | "artifact" | "integration" | "constraint";
435
- statement: string;
436
- }[];
437
- supporting_substitutions: {
438
- removed_id: string;
439
- replacement_ids: string[];
440
- rationale: string;
441
- }[];
442
- approval_options: string[];
443
- };
444
- component: string;
445
- dimension: string;
446
- ambiguity: number;
447
- round_id?: string | undefined;
448
- confused_terms?: string[] | undefined;
449
- references?: {
450
- reference_id: string;
451
- label: string;
452
- origin: string;
453
- url?: string | undefined;
454
- excerpt?: string | undefined;
455
- }[] | undefined;
456
- } | {
457
- round: number;
458
- component: string;
459
- dimension: string;
460
- ambiguity: number;
461
- round_id?: string | undefined;
462
- confused_terms?: string[] | undefined;
463
- references?: {
464
- reference_id: string;
465
- label: string;
466
- origin: string;
467
- url?: string | undefined;
468
- excerpt?: string | undefined;
469
- }[] | undefined;
470
- }, unknown>>>;
246
+ deepInterview: z.ZodUnion<readonly [z.ZodObject<{
247
+ round_id: z.ZodOptional<z.ZodString>;
248
+ round: z.ZodNumber;
249
+ component: z.ZodString;
250
+ dimension: z.ZodString;
251
+ ambiguity: z.ZodNumber;
252
+ confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
253
+ references: z.ZodOptional<z.ZodArray<z.ZodObject<{
254
+ reference_id: z.ZodString;
255
+ label: z.ZodString;
256
+ origin: z.ZodString;
257
+ url: z.ZodOptional<z.ZodString>;
258
+ excerpt: z.ZodOptional<z.ZodString>;
259
+ }, z.core.$strict>>>;
260
+ }, z.core.$strict>, z.ZodObject<{
261
+ round: z.ZodNumber;
262
+ intent_review: z.ZodObject<{
263
+ observed_items: z.ZodArray<z.ZodObject<{
264
+ id: z.ZodString;
265
+ category: z.ZodEnum<{
266
+ surface: "surface";
267
+ artifact: "artifact";
268
+ integration: "integration";
269
+ constraint: "constraint";
270
+ }>;
271
+ statement: z.ZodString;
272
+ }, z.core.$strict>>;
273
+ supporting_substitutions: z.ZodArray<z.ZodObject<{
274
+ removed_id: z.ZodString;
275
+ replacement_ids: z.ZodArray<z.ZodString>;
276
+ rationale: z.ZodString;
277
+ }, z.core.$strict>>;
278
+ approval_options: z.ZodArray<z.ZodString>;
279
+ }, z.core.$strict>;
280
+ round_id: z.ZodOptional<z.ZodString>;
281
+ component: z.ZodString;
282
+ dimension: z.ZodString;
283
+ ambiguity: z.ZodNumber;
284
+ confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
285
+ references: z.ZodOptional<z.ZodArray<z.ZodObject<{
286
+ reference_id: z.ZodString;
287
+ label: z.ZodString;
288
+ origin: z.ZodString;
289
+ url: z.ZodOptional<z.ZodString>;
290
+ excerpt: z.ZodOptional<z.ZodString>;
291
+ }, z.core.$strict>>>;
292
+ }, z.core.$strict>]>;
471
293
  }, z.core.$strip>>;
472
294
  }, z.core.$strip>;
473
295
  declare const ordinaryAskSchema: z.ZodObject<{
@@ -537,6 +359,7 @@ export declare class AskTool implements AgentTool<AskParametersSchema, AskToolDe
537
359
  * one, so it keeps the complete (still mutually exclusive) metadata union.
538
360
  */
539
361
  get parameters(): AskParametersSchema;
362
+ readonly rawArgumentValidation: (arguments_: Record<string, unknown>) => RawArgumentValidationResult;
540
363
  readonly strict = true;
541
364
  /**
542
365
  * These fields are rendered to the user and carry no executable or durable
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Path the native writer will mutate: realpath of an existing file, or realpath
3
+ * of the nearest existing ancestor plus the missing tail.
4
+ */
5
+ export declare function canonicalizeAstEditWritePath(absolutePath: string): Promise<string>;
6
+ /**
7
+ * Preview paths as the workflow guard must see them.
8
+ *
9
+ * The guard compares lexically against the session cwd. A raw realpath misses
10
+ * `.skc/**` when that cwd is not already canonical (`/var` vs `/private/var`,
11
+ * or a symlinked workspace), so an in-workspace real path is reattached to `cwd`.
12
+ */
13
+ export declare function resolveAstEditPreviewWritePaths(cwd: string, previewedPaths: readonly string[]): Promise<string[]>;
14
+ /** Refusal prefix when a single-file real path leaves its reference root. */
15
+ export declare const AST_EDIT_OUTSIDE_ROOT_MESSAGE = "AST edit target resolves outside its root";
16
+ /**
17
+ * Native astEdit canonicalizes one file and writes that real path. Directory
18
+ * scans do not follow links. A lexical path inside cwd uses the real cwd as
19
+ * the reference root; an explicit path outside cwd uses its real parent, so a
20
+ * direct file there still applies. Returns the lexical path that would leave
21
+ * that root, if any.
22
+ */
23
+ export declare function astEditSingleFileOutsideReferenceRoot(cwd: string, candidatePaths: readonly string[], signal?: AbortSignal): Promise<string | undefined>;
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Fail-atomic user-file writes for the write/edit/LSP writethrough path.
3
+ *
4
+ * The guarantee is visibility, not crash durability: a failed write never
5
+ * publishes partial or truncated bytes, and the destination is left byte-
6
+ * identical. It is deliberately NOT crash-atomic -- the parent directory is
7
+ * never fsynced, so a rename can be lost across a system crash.
8
+ *
9
+ * Publication is last-writer-wins, not conditional. Identity is revalidated
10
+ * immediately before the rename, which rejects a destination that was replaced
11
+ * or retargeted while staging, but `rename(2)` commits against the pathname:
12
+ * a writer that publishes a successor inside the window between that check and
13
+ * the rename is overwritten. Closing that window needs an OS conditional-
14
+ * replace primitive; the exchange-based one available here was removed because
15
+ * it validated only after committing and leaked protocol debris into user
16
+ * directories on every successful write. `write` is a last-writer-wins tool by
17
+ * contract, so this is the documented behavior rather than a silent race.
18
+ *
19
+ * `Bun.write` truncates the destination then copies bytes. A permission or IO
20
+ * failure after that truncate leaves a 0-byte target even though the tool
21
+ * reported an error. Stage to a sibling temp, then rename over the destination
22
+ * so a failed attempt never publishes a truncated file. Directory fsync is
23
+ * intentionally omitted: Windows reports `EPERM` for it (#4457) and user-file
24
+ * publication does not need that durability barrier.
25
+ *
26
+ * Destination symlinks are followed: the referent is replaced, the link stays.
27
+ * The referent is re-resolved immediately before publication so a retargeted
28
+ * link cannot silently repoint the write. When the lexical destination sits
29
+ * inside the active explicit artifacts local root (`<artifacts>/local`) or a
30
+ * session-scoped `skc-local` root, the resolved referent and its parent must
31
+ * remain inside that root (a link there must not redirect the write out of
32
+ * the trust boundary).
33
+ *
34
+ * Staging uses exclusive create (`wx`) so a colliding leftover temp is never
35
+ * truncated or unlinked; only the temp this call created is cleaned on failure.
36
+ * Existing-file mode and ownership are re-applied after staging so a process
37
+ * umask or replacement inode never changes the target's identity. Hard-linked
38
+ * targets are rejected because replacement would split their link group, and
39
+ * target identity is revalidated before the final same-directory rename. The
40
+ * staged bytes are synced before publication; directory fsync is intentionally not
41
+ * promised because Windows reports EPERM for it (#4457).
42
+ */
43
+ export type FileWritePublicationState = "not_published" | "published" | "unknown";
44
+ export declare class FileWriteNotPublishedError extends Error {
45
+ readonly dest: string;
46
+ readonly destUnchanged: boolean;
47
+ readonly publicationState: FileWritePublicationState;
48
+ readonly cause: unknown;
49
+ constructor(dest: string, cause: unknown, options?: {
50
+ destUnchanged?: boolean;
51
+ publicationState?: FileWritePublicationState;
52
+ });
53
+ }
54
+ export declare function isFileWritePermissionError(error: unknown): boolean;
55
+ export declare function formatFileWriteError(error: unknown, dest: string, options?: {
56
+ destUnchanged?: boolean;
57
+ }): string;
58
+ export interface WriteFileAtomicallyOptions {
59
+ /**
60
+ * Trusted root that a resolved symlink referent and its parent must not
61
+ * leave. When omitted, a destination inside the active explicit artifacts
62
+ * local root (`<artifacts>/local`) uses that root. Otherwise the helper
63
+ * still enforces the session-scoped `skc-local` boundary implied by a
64
+ * lexical destination under `<tmpdir>/skc-local/<session-id>`.
65
+ */
66
+ trustBoundary?: string;
67
+ /** Platform override used by deterministic retry tests. */
68
+ platform?: NodeJS.Platform;
69
+ /** Sleep seam used by deterministic retry tests. */
70
+ sleep?: (delayMs: number) => Promise<void>;
71
+ /** Test seam invoked after the fallback handle is opened and before mutation. */
72
+ beforeInPlaceMutation?: () => Promise<void>;
73
+ }
74
+ export declare function writeFileAtomically(dest: string, content: string | Uint8Array, options?: WriteFileAtomicallyOptions): Promise<void>;
@@ -1,3 +1,5 @@
1
+ import { type Settings as SettingsType } from "../config/settings";
2
+ type SettingsReader = Pick<SettingsType, "get">;
1
3
  /**
2
4
  * Check if a file is auto-generated by examining its content.
3
5
  * Throws ToolError if the file appears to be auto-generated.
@@ -5,7 +7,7 @@
5
7
  * @param absolutePath - Absolute path to the file
6
8
  * @param displayPath - Path to show in error messages (relative or as provided)
7
9
  */
8
- export declare function assertEditableFile(absolutePath: string, displayPath?: string): Promise<void>;
10
+ export declare function assertEditableFile(absolutePath: string, displayPath?: string, settings?: SettingsReader): Promise<void>;
9
11
  /**
10
12
  * Check if file content is auto-generated.
11
13
  * Uses only the first CHECK_BYTE_COUNT characters of the content.
@@ -14,4 +16,5 @@ export declare function assertEditableFile(absolutePath: string, displayPath?: s
14
16
  * @param content - File content to check (can be full content or prefix)
15
17
  * @param displayPath - Path to show in error messages
16
18
  */
17
- export declare function assertEditableFileContent(content: string, displayPath: string): void;
19
+ export declare function assertEditableFileContent(content: string, displayPath: string, settings?: SettingsReader): void;
20
+ export {};
@@ -3,8 +3,24 @@ export interface BashAllowedPrefixesCheck {
3
3
  reason?: string;
4
4
  }
5
5
  export type BashRestrictionProfile = "workflow" | "read-only";
6
+ /** Session identity and workspace the restricted `skc` command may name. */
7
+ export interface SkcSessionBinding {
8
+ /** Tool session id; it is also the SKC_SESSION_ID the restricted child receives. */
9
+ sessionId?: string | null;
10
+ /** Session workspace. A `--worktree-root` must be this repo, not a foreign one. */
11
+ worktreeRoot: string;
12
+ /** Child cwd. Relative `--worktree-root` resolves against it, as ralplan does. */
13
+ invocationCwd: string;
14
+ }
6
15
  export interface BashRestrictionOptions {
7
16
  profile?: BashRestrictionProfile;
17
+ skcSessionBinding?: SkcSessionBinding;
8
18
  }
19
+ /**
20
+ * Workflow restricted bash keeps the lexical prefix check, then runs the resolved
21
+ * executable. Callers also skip the shell snapshot and shell prefix, because a
22
+ * snapshot function can be named for that absolute path.
23
+ */
24
+ export declare function normalizeWorkflowBashCommand(command: string, allowedPrefixes: readonly string[] | undefined, options?: BashRestrictionOptions): string | undefined;
9
25
  export declare function normalizeReadOnlyBashCommand(command: string): string | undefined;
10
26
  export declare function checkBashAllowedPrefixes(command: string, allowedPrefixes: readonly string[] | undefined, options?: BashRestrictionOptions): BashAllowedPrefixesCheck;
@@ -11,6 +11,8 @@ export declare function runInteractiveBashPty(ui: NonNullable<AgentToolContext["
11
11
  timeoutMs: number;
12
12
  signal?: AbortSignal;
13
13
  env?: Record<string, string>;
14
+ /** Environment names to hide from the PTY child. Explicit `env` values win. */
15
+ unsetEnv?: string[];
14
16
  artifactPath?: string;
15
17
  artifactId?: string;
16
18
  }): Promise<BashInteractiveResult>;
@@ -1,5 +1,5 @@
1
1
  import type { Skill } from "../extensibility/skills";
2
- import { type LocalProtocolOptions } from "../internal-urls";
2
+ import { type LocalProtocolOptions } from "../internal-urls/local-protocol";
3
3
  import type { InternalResource } from "../internal-urls/types";
4
4
  interface InternalUrlResolver {
5
5
  canHandle(input: string): boolean;
@@ -16,6 +16,10 @@ export interface InternalUrlExpansionOptions {
16
16
  * Resolve a single skill:// URL to its absolute filesystem path.
17
17
  * Does NOT read file content or verify existence.
18
18
  */
19
+ export declare function resolveSkillUrl(url: string, skills: readonly Skill[]): {
20
+ skill: Skill;
21
+ lexicalPath: string;
22
+ };
19
23
  export declare function resolveSkillUrlToPath(url: string, skills: readonly Skill[]): string;
20
24
  /**
21
25
  * Expand all skill:// URIs in a bash command string.
@@ -6,6 +6,7 @@ import { type Theme } from "../modes/theme/theme";
6
6
  import type { ToolSession } from ".";
7
7
  import { type OutputMeta } from "./output-meta";
8
8
  export declare const BASH_DEFAULT_PREVIEW_LINES = 10;
9
+ export declare const MANAGED_OWNER_BASH_ENV: readonly ["SKC_TMUX_OWNER_STATE_DIR", "SKC_TMUX_OWNER_GENERATION", "SKC_MANAGED_OWNER_RUN_ID", "SKC_MANAGED_OWNER_INCARNATION", "SKC_MANAGED_OWNER_CHILD_TOKEN", "SKC_MANAGED_OWNER_COMMAND_JSON", "SKC_MANAGED_OWNER_PREDECESSOR_TOKEN", "SKC_MANAGED_OWNER_PREDECESSOR_GENERATION", "SKC_MANAGED_OWNER_PREDECESSOR_RUN_ID", "SKC_MANAGED_OWNER_PREDECESSOR_INCARNATION", "SKC_MANAGED_OWNER_TRANSCRIPT_PATH", "SKC_TMUX_OWNER_SERVER_KEY", "SKC_TMUX_LAUNCHED"];
9
10
  export declare function saveBashOriginalArtifactForTests(session: ToolSession, originalText: string): Promise<string | undefined>;
10
11
  declare const bashSchemaBase: z.ZodObject<{
11
12
  command: z.ZodString;
@@ -0,0 +1,2 @@
1
+ /** Require an http(s) CDP URL whose host is loopback. */
2
+ export declare function assertLoopbackCdpUrl(cdpUrl: string): string;
@@ -1,5 +1,6 @@
1
1
  import type { HTMLElement } from "linkedom";
2
2
  import type { ElementHandle } from "puppeteer-core";
3
+ import { loadPuppeteerInWorker } from "./launch";
3
4
  import type { Transport } from "./tab-protocol";
4
5
  declare global {
5
6
  interface Element extends HTMLElement {
@@ -11,6 +12,7 @@ declare global {
11
12
  elementFromPoint(x: number, y: number): Element | null;
12
13
  };
13
14
  }
15
+ export declare function __setLoadPuppeteerInWorkerForTest(loader: typeof loadPuppeteerInWorker | undefined): void;
14
16
  export declare class WorkerCore {
15
17
  #private;
16
18
  constructor(transport: Transport);
@@ -10,6 +10,7 @@ declare const debugSchema: z.ZodObject<{
10
10
  output: "output";
11
11
  sessions: "sessions";
12
12
  pause: "pause";
13
+ continue: "continue";
13
14
  scopes: "scopes";
14
15
  variables: "variables";
15
16
  evaluate: "evaluate";
@@ -22,7 +23,6 @@ declare const debugSchema: z.ZodObject<{
22
23
  data_breakpoint_info: "data_breakpoint_info";
23
24
  set_data_breakpoint: "set_data_breakpoint";
24
25
  remove_data_breakpoint: "remove_data_breakpoint";
25
- continue: "continue";
26
26
  step_over: "step_over";
27
27
  step_in: "step_in";
28
28
  step_out: "step_out";
@@ -133,6 +133,7 @@ export declare class DebugTool implements AgentTool<typeof debugSchema, DebugToo
133
133
  output: "output";
134
134
  sessions: "sessions";
135
135
  pause: "pause";
136
+ continue: "continue";
136
137
  scopes: "scopes";
137
138
  variables: "variables";
138
139
  evaluate: "evaluate";
@@ -145,7 +146,6 @@ export declare class DebugTool implements AgentTool<typeof debugSchema, DebugToo
145
146
  data_breakpoint_info: "data_breakpoint_info";
146
147
  set_data_breakpoint: "set_data_breakpoint";
147
148
  remove_data_breakpoint: "remove_data_breakpoint";
148
- continue: "continue";
149
149
  step_over: "step_over";
150
150
  step_in: "step_in";
151
151
  step_out: "step_out";
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Publish text at an explicit artifact path the way `ArtifactManager.save` does:
3
+ * a temp file opened with `O_NOFOLLOW` and mode 0600, then rename. A symlink is
4
+ * not followed. A pre-existing regular file is replaced, so mode 0644 is not kept.
5
+ *
6
+ * Node built-ins only, so `gh` can publish without importing `tools/fetch`.
7
+ */
8
+ export declare function publishExplicitArtifactText(destination: string, text: string): Promise<void>;
@@ -6,7 +6,9 @@ import { type Theme } from "../modes/theme/theme";
6
6
  import type { ToolSession } from "../sdk";
7
7
  import { type TruncationDirection } from "../session/streaming-output";
8
8
  import type { RenderResult } from "../web/scrapers/types";
9
+ import { publishExplicitArtifactText } from "./explicit-artifact";
9
10
  import { type OutputMeta } from "./output-meta";
11
+ import { escapeUntrustedContent, WRAP_PREFIX_CHARS, wrapUntrustedContent } from "./untrusted-content";
10
12
  export declare function isReadableUrlPath(value: string): boolean;
11
13
  export interface ParsedReadUrlTarget {
12
14
  path: string;
@@ -58,6 +60,11 @@ interface ReadUrlCacheEntry {
58
60
  /** Offset of the preamble after `wrapUntrustedContent(output)` is persisted. */
59
61
  wrappedPreambleChars?: number;
60
62
  }
63
+ /** Test seam: the read-url cache is process-wide, so suites reset it between cases. */
64
+ export declare const readUrlCacheTestHooks: {
65
+ reset(): void;
66
+ };
67
+ export { escapeUntrustedContent, publishExplicitArtifactText, WRAP_PREFIX_CHARS, wrapUntrustedContent };
61
68
  export declare function loadReadUrlCacheEntry(session: ToolSession, params: {
62
69
  path: string;
63
70
  raw?: boolean;
@@ -65,9 +72,6 @@ export declare function loadReadUrlCacheEntry(session: ToolSession, params: {
65
72
  ensureArtifact?: boolean;
66
73
  preferCached?: boolean;
67
74
  }): Promise<ReadUrlCacheEntry>;
68
- export declare const WRAP_PREFIX_CHARS: number;
69
- export declare function escapeUntrustedContent(content: string): string;
70
- export declare function wrapUntrustedContent(content: string): string;
71
75
  /**
72
76
  * Remove only the outer URL-output wrapper before line pagination. The content
73
77
  * remains escaped exactly as persisted; it is deliberately never unescaped.
@@ -95,4 +99,3 @@ export declare function renderReadUrlResult(result: {
95
99
  details?: ReadUrlToolDetails;
96
100
  isError?: boolean;
97
101
  }, options: RenderResultOptions, uiTheme?: Theme): Component;
98
- export {};