@sayknow-cli/coding-agent 0.7.10 → 0.7.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/dist/types/async/result-formatting.d.ts +2 -0
  3. package/dist/types/capability/fs.d.ts +22 -3
  4. package/dist/types/capability/mcp.d.ts +2 -0
  5. package/dist/types/cli/append-system-prompt.d.ts +6 -0
  6. package/dist/types/cli/update-cli.d.ts +3 -0
  7. package/dist/types/commands/contribution-prep.d.ts +0 -3
  8. package/dist/types/commands/migrate.d.ts +1 -1
  9. package/dist/types/commands/sdk.d.ts +9 -0
  10. package/dist/types/commit/changelog/index.d.ts +1 -0
  11. package/dist/types/config/settings-schema.d.ts +14 -0
  12. package/dist/types/config/settings.d.ts +7 -1
  13. package/dist/types/coordinator-mcp/session-reaper.d.ts +5 -0
  14. package/dist/types/cursor-delete-path.d.ts +1 -0
  15. package/dist/types/cursor-mcp-name.d.ts +8 -0
  16. package/dist/types/dap/config.d.ts +8 -4
  17. package/dist/types/dap/session.d.ts +11 -2
  18. package/dist/types/debug/report-bundle-parent.d.ts +2 -0
  19. package/dist/types/debug/system-info.d.ts +6 -1
  20. package/dist/types/discovery/helpers.d.ts +11 -3
  21. package/dist/types/discovery/mcp-json.d.ts +1 -0
  22. package/dist/types/edit/file-read-cache.d.ts +4 -0
  23. package/dist/types/edit/modes/patch.d.ts +14 -0
  24. package/dist/types/edit/modes/replace.d.ts +8 -0
  25. package/dist/types/eval/py/runtime.d.ts +9 -0
  26. package/dist/types/exa/mcp-client.d.ts +11 -6
  27. package/dist/types/exec/bash-executor.d.ts +18 -1
  28. package/dist/types/export/html/css-color.d.ts +2 -0
  29. package/dist/types/export/html/html-export-destination.d.ts +2 -0
  30. package/dist/types/export/html/template.generated.d.ts +1 -1
  31. package/dist/types/extensibility/custom-tools/loader.d.ts +3 -2
  32. package/dist/types/extensibility/custom-tools/types.d.ts +3 -1
  33. package/dist/types/extensibility/plugins/marketplace/cache.d.ts +2 -0
  34. package/dist/types/extensibility/plugins/plugin-link-path.d.ts +2 -0
  35. package/dist/types/goals/runtime.d.ts +6 -0
  36. package/dist/types/harness-control-plane/receipt-spool.d.ts +4 -0
  37. package/dist/types/hindsight/content.d.ts +5 -6
  38. package/dist/types/internal-urls/skill-path.d.ts +1 -0
  39. package/dist/types/internal-urls/types.d.ts +2 -0
  40. package/dist/types/lsp/clients/swiftlint-client.d.ts +0 -4
  41. package/dist/types/lsp/config.d.ts +8 -5
  42. package/dist/types/lsp/workspace-path.d.ts +1 -0
  43. package/dist/types/migrate/adapters/codex.d.ts +2 -1
  44. package/dist/types/migrate/adapters/index.d.ts +10 -1
  45. package/dist/types/migrate/executor.d.ts +3 -1
  46. package/dist/types/migrate/types.d.ts +15 -3
  47. package/dist/types/modes/components/custom-editor.d.ts +6 -0
  48. package/dist/types/modes/components/extensions/state-manager.d.ts +4 -3
  49. package/dist/types/modes/components/model-selector.d.ts +46 -0
  50. package/dist/types/modes/controllers/input-controller.d.ts +9 -0
  51. package/dist/types/modes/interactive-mode.d.ts +1 -0
  52. package/dist/types/modes/utils/macos-option-forwarding.d.ts +17 -0
  53. package/dist/types/runtime-mcp/content-limits.d.ts +4 -0
  54. package/dist/types/runtime-mcp/manager.d.ts +9 -1
  55. package/dist/types/runtime-mcp/mcp-redirect.d.ts +9 -0
  56. package/dist/types/runtime-mcp/oauth-public-url.d.ts +1 -0
  57. package/dist/types/runtime-mcp/plugin-mcp-name-filter.d.ts +22 -0
  58. package/dist/types/runtime-mcp/plugin-network-boundary.d.ts +1 -0
  59. package/dist/types/runtime-mcp/project-host-values.d.ts +33 -0
  60. package/dist/types/runtime-mcp/smithery-registry.d.ts +24 -0
  61. package/dist/types/runtime-mcp/tool-bridge.d.ts +4 -0
  62. package/dist/types/runtime-mcp/types.d.ts +6 -0
  63. package/dist/types/sdk/broker/ensure.d.ts +2 -0
  64. package/dist/types/sdk/broker/lifecycle-ledger.d.ts +5 -1
  65. package/dist/types/sdk/broker/runtime.d.ts +1 -1
  66. package/dist/types/sdk/bus/chat-daemon-control.d.ts +3 -1
  67. package/dist/types/sdk/bus/telegram-daemon-contract.d.ts +3 -1
  68. package/dist/types/sdk/bus/telegram-daemon.d.ts +1 -0
  69. package/dist/types/sdk/host/events.d.ts +4 -0
  70. package/dist/types/session/agent-session.d.ts +20 -1
  71. package/dist/types/session/messages.d.ts +5 -1
  72. package/dist/types/session/session-manager.d.ts +13 -0
  73. package/dist/types/session/session-storage.d.ts +8 -0
  74. package/dist/types/session/streaming-output.d.ts +11 -0
  75. package/dist/types/session-import/redact.d.ts +1 -1
  76. package/dist/types/skc-runtime/managed-owner-admission.d.ts +3 -0
  77. package/dist/types/skc-runtime/psmux-detect.d.ts +5 -4
  78. package/dist/types/skc-runtime/ralplan-runtime.d.ts +5 -0
  79. package/dist/types/skc-runtime/sidecar-bootstrap-env.d.ts +6 -0
  80. package/dist/types/skc-runtime/state-writer.d.ts +4 -1
  81. package/dist/types/skc-runtime/tmux-sessions.d.ts +24 -0
  82. package/dist/types/skc-runtime/ultragoal-runtime.d.ts +4 -0
  83. package/dist/types/skill-state/workflow-mutation-guard.d.ts +20 -1
  84. package/dist/types/slash-commands/helpers/mcp.d.ts +5 -0
  85. package/dist/types/ssh/ssh-executor.d.ts +3 -1
  86. package/dist/types/system-prompt.d.ts +5 -2
  87. package/dist/types/task/executor.d.ts +17 -3
  88. package/dist/types/task/isolation-dir.d.ts +26 -0
  89. package/dist/types/task/role-body.d.ts +11 -0
  90. package/dist/types/task/token-log-mode.test.d.ts +1 -0
  91. package/dist/types/tools/ask.d.ts +77 -254
  92. package/dist/types/tools/ast-edit-write-path.d.ts +23 -0
  93. package/dist/types/tools/atomic-file-write.d.ts +74 -0
  94. package/dist/types/tools/auto-generated-guard.d.ts +5 -2
  95. package/dist/types/tools/bash-allowed-prefixes.d.ts +16 -0
  96. package/dist/types/tools/bash-interactive.d.ts +2 -0
  97. package/dist/types/tools/bash-skill-urls.d.ts +5 -1
  98. package/dist/types/tools/bash.d.ts +1 -0
  99. package/dist/types/tools/browser/cdp-url.d.ts +2 -0
  100. package/dist/types/tools/browser/tab-worker.d.ts +2 -0
  101. package/dist/types/tools/debug.d.ts +2 -2
  102. package/dist/types/tools/explicit-artifact.d.ts +8 -0
  103. package/dist/types/tools/fetch.d.ts +7 -4
  104. package/dist/types/tools/github-side-effect.d.ts +22 -0
  105. package/dist/types/tools/index.d.ts +3 -0
  106. package/dist/types/tools/monitor-mutation.d.ts +9 -0
  107. package/dist/types/tools/recipe/index.d.ts +2 -0
  108. package/dist/types/tools/recipe/recipe-guard.d.ts +7 -0
  109. package/dist/types/tools/restricted-cwd.d.ts +1 -0
  110. package/dist/types/tools/reverse-engineer.d.ts +81 -0
  111. package/dist/types/tools/search-tool-bm25.d.ts +2 -0
  112. package/dist/types/tools/tmux-self-injection-guard.d.ts +17 -0
  113. package/dist/types/tools/untrusted-content.d.ts +12 -0
  114. package/dist/types/utils/file-mentions.d.ts +5 -0
  115. package/dist/types/utils/open.d.ts +0 -1
  116. package/dist/types/utils/shell-snapshot.d.ts +2 -0
  117. package/dist/types/utils/title-generator.d.ts +12 -2
  118. package/dist/types/utils/tools-checksum.d.ts +7 -0
  119. package/dist/types/utils/xml-escape.d.ts +2 -0
  120. package/dist/types/web/scrapers/types.d.ts +8 -1
  121. package/dist/types/web/search/providers/codex.d.ts +6 -7
  122. package/dist/types/web/search/providers/insane.d.ts +7 -1
  123. package/dist/types/web/search/providers/kimi.d.ts +2 -0
  124. package/dist/types/web/search/providers/searxng.d.ts +7 -0
  125. package/dist/types/web/search/providers/xai.d.ts +2 -0
  126. package/package.json +7 -7
  127. package/scripts/generate-sdk-operation-inventory.ts +4 -0
  128. package/src/async/job-manager.ts +23 -9
  129. package/src/async/result-formatting.ts +40 -0
  130. package/src/capability/fs.ts +78 -11
  131. package/src/capability/mcp.ts +2 -0
  132. package/src/cli/append-system-prompt.ts +12 -0
  133. package/src/cli/auth-broker-cli.ts +22 -12
  134. package/src/cli/config-cli.ts +8 -18
  135. package/src/cli/migrate-cli.ts +7 -5
  136. package/src/cli/ssh-cli.ts +6 -3
  137. package/src/cli/stats-cli.ts +9 -4
  138. package/src/cli/update-cli.ts +42 -0
  139. package/src/cli/web-search-cli.ts +9 -3
  140. package/src/cli.ts +5 -9
  141. package/src/commands/commit.ts +2 -2
  142. package/src/commands/contribution-prep.ts +1 -3
  143. package/src/commands/harness.ts +25 -15
  144. package/src/commands/launch.ts +1 -1
  145. package/src/commands/migrate.ts +3 -3
  146. package/src/commands/sdk.ts +115 -14
  147. package/src/commands/ultragoal.ts +14 -8
  148. package/src/commit/agentic/agent.ts +6 -6
  149. package/src/commit/analysis/conventional.ts +14 -5
  150. package/src/commit/changelog/index.ts +39 -1
  151. package/src/commit/message.ts +10 -3
  152. package/src/config/config-file.ts +106 -3
  153. package/src/config/keybindings.ts +154 -7
  154. package/src/config/mcp-schema.json +4 -0
  155. package/src/config/model-registry.ts +10 -2
  156. package/src/config/settings-schema.ts +18 -0
  157. package/src/config/settings.ts +32 -4
  158. package/src/coordinator-mcp/policy.ts +14 -4
  159. package/src/coordinator-mcp/server.ts +44 -4
  160. package/src/coordinator-mcp/session-reaper.ts +9 -1
  161. package/src/cursor-delete-path.ts +10 -0
  162. package/src/cursor-mcp-name.ts +15 -0
  163. package/src/cursor.ts +13 -2
  164. package/src/dap/client.ts +9 -2
  165. package/src/dap/config.ts +33 -13
  166. package/src/dap/defaults.json +1 -1
  167. package/src/dap/session.ts +161 -36
  168. package/src/debug/crash-diagnostics.ts +89 -6
  169. package/src/debug/report-bundle-parent.ts +22 -0
  170. package/src/debug/report-bundle.ts +100 -3
  171. package/src/debug/system-info.ts +21 -4
  172. package/src/defaults/skc/extensions/grok-cli-vendor/src/shared/base-url.ts +21 -7
  173. package/src/defaults/skc/skills/deep-interview/SKILL.md +1 -1
  174. package/src/discovery/agents-md.ts +3 -2
  175. package/src/discovery/agents.ts +3 -2
  176. package/src/discovery/builtin.ts +21 -11
  177. package/src/discovery/claude.ts +5 -4
  178. package/src/discovery/cline.ts +2 -2
  179. package/src/discovery/codex.ts +6 -5
  180. package/src/discovery/cursor.ts +11 -2
  181. package/src/discovery/gemini.ts +4 -3
  182. package/src/discovery/github.ts +2 -2
  183. package/src/discovery/helpers.ts +51 -11
  184. package/src/discovery/mcp-json.ts +28 -12
  185. package/src/discovery/opencode.ts +2 -1
  186. package/src/discovery/ssh.ts +11 -6
  187. package/src/discovery/substitute-plugin-root.ts +3 -1
  188. package/src/discovery/vscode.ts +3 -3
  189. package/src/edit/apply-patch/index.ts +12 -1
  190. package/src/edit/file-read-cache.ts +24 -6
  191. package/src/edit/index.ts +90 -20
  192. package/src/edit/modes/patch.ts +215 -9
  193. package/src/edit/modes/replace.ts +141 -0
  194. package/src/eval/js/context-manager.ts +29 -3
  195. package/src/eval/js/worker-entry.ts +51 -18
  196. package/src/eval/py/runner.py +144 -5
  197. package/src/eval/py/runtime.ts +44 -4
  198. package/src/eval/py/tool-bridge.ts +4 -0
  199. package/src/exa/mcp-client.ts +53 -11
  200. package/src/exec/bash-executor.ts +87 -4
  201. package/src/exec/non-interactive-env.ts +0 -1
  202. package/src/export/html/css-color.ts +9 -0
  203. package/src/export/html/html-export-destination.ts +16 -0
  204. package/src/export/html/index.ts +102 -8
  205. package/src/export/html/template.generated.ts +1 -1
  206. package/src/extensibility/custom-tools/loader.ts +13 -3
  207. package/src/extensibility/custom-tools/types.ts +3 -1
  208. package/src/extensibility/custom-tools/wrapper.ts +3 -1
  209. package/src/extensibility/plugins/manager.ts +3 -2
  210. package/src/extensibility/plugins/marketplace/cache.ts +15 -0
  211. package/src/extensibility/plugins/marketplace/fetcher.ts +2 -2
  212. package/src/extensibility/plugins/marketplace/manager.ts +5 -3
  213. package/src/extensibility/plugins/plugin-link-path.ts +12 -0
  214. package/src/extensibility/skc-plugins/mcp-policy.ts +2 -1
  215. package/src/goals/runtime.ts +30 -8
  216. package/src/harness-control-plane/finalize.ts +10 -0
  217. package/src/harness-control-plane/operate.ts +12 -4
  218. package/src/harness-control-plane/owner.ts +8 -1
  219. package/src/harness-control-plane/receipt-spool.ts +105 -28
  220. package/src/harness-control-plane/storage.ts +124 -6
  221. package/src/hashline/execute.ts +3 -3
  222. package/src/hashline/recovery.ts +85 -2
  223. package/src/hindsight/config.ts +9 -3
  224. package/src/hindsight/content.ts +116 -16
  225. package/src/hindsight/mental-models.ts +22 -10
  226. package/src/hindsight/state.ts +7 -4
  227. package/src/hooks/native-skill-hook.ts +17 -12
  228. package/src/i18n/messages/de.settings.ts +3 -0
  229. package/src/i18n/messages/es.settings.ts +3 -0
  230. package/src/i18n/messages/fr.settings.ts +3 -0
  231. package/src/i18n/messages/ja.settings.ts +3 -0
  232. package/src/i18n/messages/ko.settings.ts +3 -0
  233. package/src/i18n/messages/zh.settings.ts +3 -0
  234. package/src/internal-urls/artifact-protocol.ts +3 -1
  235. package/src/internal-urls/docs-index.generated.ts +10 -10
  236. package/src/internal-urls/local-protocol.ts +167 -8
  237. package/src/internal-urls/skill-path.ts +18 -0
  238. package/src/internal-urls/skill-protocol.ts +2 -0
  239. package/src/internal-urls/types.ts +2 -0
  240. package/src/lsp/client.ts +2 -1
  241. package/src/lsp/clients/biome-client.ts +2 -0
  242. package/src/lsp/clients/swiftlint-client.ts +2 -0
  243. package/src/lsp/config.ts +18 -62
  244. package/src/lsp/edits.ts +6 -0
  245. package/src/lsp/index.ts +29 -0
  246. package/src/lsp/workspace-path.ts +75 -0
  247. package/src/main.ts +33 -11
  248. package/src/memories/index.ts +141 -9
  249. package/src/migrate/action-planner.ts +57 -0
  250. package/src/migrate/adapters/claude-code.ts +23 -4
  251. package/src/migrate/adapters/codex.ts +22 -4
  252. package/src/migrate/adapters/index.ts +22 -4
  253. package/src/migrate/adapters/opencode.ts +6 -1
  254. package/src/migrate/executor.ts +84 -7
  255. package/src/migrate/report.ts +19 -2
  256. package/src/migrate/types.ts +14 -4
  257. package/src/modes/DESIGN.md +5 -0
  258. package/src/modes/acp/acp-agent.ts +35 -2
  259. package/src/modes/acp/permission-mode.ts +18 -1
  260. package/src/modes/components/custom-editor.ts +14 -0
  261. package/src/modes/components/extensions/extension-dashboard.ts +2 -2
  262. package/src/modes/components/extensions/inspector-panel.ts +9 -5
  263. package/src/modes/components/extensions/state-manager.ts +15 -5
  264. package/src/modes/components/model-selector.ts +144 -94
  265. package/src/modes/components/welcome.ts +3 -2
  266. package/src/modes/controllers/command-controller.ts +300 -9
  267. package/src/modes/controllers/event-controller.ts +1 -1
  268. package/src/modes/controllers/extension-ui-controller.ts +32 -19
  269. package/src/modes/controllers/input-controller.ts +62 -26
  270. package/src/modes/controllers/plan-mode-controller.ts +17 -7
  271. package/src/modes/controllers/runtime-mcp-command-controller.ts +25 -20
  272. package/src/modes/controllers/ssh-command-controller.ts +3 -1
  273. package/src/modes/interactive-mode.ts +10 -0
  274. package/src/modes/utils/macos-option-forwarding.ts +80 -0
  275. package/src/prompts/system/irc-incoming.md +3 -1
  276. package/src/prompts/system/project-prompt.md +19 -0
  277. package/src/prompts/system/system-prompt.md +3 -0
  278. package/src/prompts/tools/ask.md +2 -0
  279. package/src/prompts/tools/debug.md +1 -1
  280. package/src/prompts/tools/monitor.md +7 -5
  281. package/src/prompts/tools/reverse-engineer.md +29 -0
  282. package/src/runtime-credential-selector.ts +2 -2
  283. package/src/runtime-mcp/config-writer.ts +10 -6
  284. package/src/runtime-mcp/config.ts +1 -0
  285. package/src/runtime-mcp/content-limits.ts +7 -0
  286. package/src/runtime-mcp/json-rpc.ts +2 -1
  287. package/src/runtime-mcp/manager.ts +57 -9
  288. package/src/runtime-mcp/mcp-redirect.ts +73 -0
  289. package/src/runtime-mcp/oauth-flow.ts +43 -5
  290. package/src/runtime-mcp/oauth-public-url.ts +8 -0
  291. package/src/runtime-mcp/plugin-mcp-name-filter.ts +62 -0
  292. package/src/runtime-mcp/plugin-network-boundary.ts +4 -0
  293. package/src/runtime-mcp/project-host-values.ts +50 -0
  294. package/src/runtime-mcp/render.ts +16 -1
  295. package/src/runtime-mcp/smithery-registry.ts +22 -3
  296. package/src/runtime-mcp/tool-bridge.ts +194 -21
  297. package/src/runtime-mcp/transports/http.ts +4 -3
  298. package/src/runtime-mcp/transports/stdio.ts +2 -1
  299. package/src/runtime-mcp/types.ts +6 -0
  300. package/src/sdk/broker/broker.ts +11 -2
  301. package/src/sdk/broker/ensure.ts +131 -10
  302. package/src/sdk/broker/lifecycle-ledger.ts +18 -3
  303. package/src/sdk/broker/lifecycle.ts +21 -19
  304. package/src/sdk/broker/runtime.ts +1 -1
  305. package/src/sdk/bus/chat-daemon-cli.ts +38 -1
  306. package/src/sdk/bus/chat-daemon-control.ts +5 -3
  307. package/src/sdk/bus/index.ts +5 -3
  308. package/src/sdk/bus/lifecycle-control-runtime.ts +9 -2
  309. package/src/sdk/bus/session-control.ts +2 -0
  310. package/src/sdk/bus/slack-daemon.ts +8 -1
  311. package/src/sdk/bus/slack-live-provider.ts +3 -1
  312. package/src/sdk/bus/telegram-daemon-contract.ts +3 -1
  313. package/src/sdk/bus/telegram-daemon-control.ts +17 -12
  314. package/src/sdk/bus/telegram-daemon.ts +41 -1
  315. package/src/sdk/host/events.ts +67 -4
  316. package/src/sdk/mcp/server.ts +16 -3
  317. package/src/sdk/protocol/operation-inventory.generated.json +22 -0
  318. package/src/sdk/session.ts +18 -25
  319. package/src/secrets/obfuscator.ts +92 -12
  320. package/src/session/agent-session.ts +395 -79
  321. package/src/session/artifacts.ts +3 -1
  322. package/src/session/history-storage.ts +172 -8
  323. package/src/session/internal/managed-session-scope.ts +130 -52
  324. package/src/session/messages.ts +47 -6
  325. package/src/session/session-manager.ts +170 -10
  326. package/src/session/session-storage.ts +31 -1
  327. package/src/session/streaming-output.ts +263 -4
  328. package/src/session-import/redact.ts +76 -3
  329. package/src/setup/hermes-setup.ts +4 -1
  330. package/src/skc-runtime/gc-runtime.ts +26 -4
  331. package/src/skc-runtime/launch-tmux.ts +21 -11
  332. package/src/skc-runtime/launch-worktree.ts +42 -3
  333. package/src/skc-runtime/managed-owner-admission.ts +46 -2
  334. package/src/skc-runtime/psmux-detect.ts +29 -5
  335. package/src/skc-runtime/ralplan-runtime.ts +14 -1
  336. package/src/skc-runtime/session-resolution.ts +38 -6
  337. package/src/skc-runtime/sidecar-bootstrap-env.ts +19 -0
  338. package/src/skc-runtime/state-writer.ts +134 -16
  339. package/src/skc-runtime/tmux-sessions.ts +85 -4
  340. package/src/skc-runtime/ultragoal-change-set.ts +18 -2
  341. package/src/skc-runtime/ultragoal-guard.ts +9 -1
  342. package/src/skc-runtime/ultragoal-runtime.ts +26 -9
  343. package/src/skill-state/active-state.ts +13 -0
  344. package/src/skill-state/workflow-mutation-guard.ts +3297 -180
  345. package/src/slash-commands/builtin-registry.ts +14 -8
  346. package/src/slash-commands/helpers/mcp.ts +20 -7
  347. package/src/ssh/ssh-executor.ts +3 -1
  348. package/src/stt/recorder.ts +26 -9
  349. package/src/system-prompt.ts +65 -16
  350. package/src/task/commands.ts +3 -1
  351. package/src/task/executor.ts +52 -7
  352. package/src/task/index.ts +28 -0
  353. package/src/task/isolation-dir.ts +143 -0
  354. package/src/task/role-body.ts +84 -0
  355. package/src/task/token-log-mode.test.ts +162 -0
  356. package/src/task/token-log.ts +91 -2
  357. package/src/task/worktree.ts +16 -7
  358. package/src/tools/archive-reader.ts +653 -31
  359. package/src/tools/ask.ts +86 -14
  360. package/src/tools/ast-edit-write-path.ts +133 -0
  361. package/src/tools/ast-edit.ts +27 -1
  362. package/src/tools/ast-grep.ts +7 -2
  363. package/src/tools/atomic-file-write.ts +625 -0
  364. package/src/tools/auto-generated-guard.ts +28 -8
  365. package/src/tools/bash-allowed-prefixes.ts +225 -6
  366. package/src/tools/bash-interactive.ts +12 -0
  367. package/src/tools/bash-skill-urls.ts +113 -7
  368. package/src/tools/bash.ts +152 -20
  369. package/src/tools/browser/cdp-url.ts +18 -0
  370. package/src/tools/browser/tab-worker.ts +49 -14
  371. package/src/tools/browser.ts +25 -8
  372. package/src/tools/cron.ts +10 -1
  373. package/src/tools/debug.ts +16 -8
  374. package/src/tools/eval.ts +71 -34
  375. package/src/tools/explicit-artifact.ts +89 -0
  376. package/src/tools/fetch.ts +26 -17
  377. package/src/tools/gh.ts +40 -12
  378. package/src/tools/github-side-effect.ts +112 -0
  379. package/src/tools/image-gen.ts +24 -10
  380. package/src/tools/index.ts +6 -0
  381. package/src/tools/monitor-mutation.ts +27 -0
  382. package/src/tools/monitor.ts +28 -1
  383. package/src/tools/output-meta.ts +74 -5
  384. package/src/tools/read.ts +24 -36
  385. package/src/tools/recipe/index.ts +12 -0
  386. package/src/tools/recipe/recipe-guard.ts +19 -0
  387. package/src/tools/recipe/runner.ts +23 -12
  388. package/src/tools/render-utils.ts +2 -2
  389. package/src/tools/restricted-cwd.ts +10 -0
  390. package/src/tools/reverse-engineer.ts +497 -0
  391. package/src/tools/search-tool-bm25.ts +14 -3
  392. package/src/tools/search.ts +3 -2
  393. package/src/tools/ssh.ts +235 -8
  394. package/src/tools/subagent-render.ts +43 -7
  395. package/src/tools/subagent.ts +7 -3
  396. package/src/tools/tmux-self-injection-guard.ts +3538 -0
  397. package/src/tools/todo-write.ts +41 -3
  398. package/src/tools/untrusted-content.ts +23 -0
  399. package/src/tools/vim.ts +2 -2
  400. package/src/tools/write.ts +37 -4
  401. package/src/tui/tree-list.ts +15 -1
  402. package/src/utils/commit-message-generator.ts +9 -2
  403. package/src/utils/external-editor.ts +21 -7
  404. package/src/utils/file-mentions.ts +75 -7
  405. package/src/utils/git.ts +38 -7
  406. package/src/utils/open.ts +73 -4
  407. package/src/utils/shell-snapshot.ts +9 -1
  408. package/src/utils/title-generator.ts +61 -16
  409. package/src/utils/tools-checksum.ts +34 -0
  410. package/src/utils/tools-manager.ts +24 -6
  411. package/src/utils/xml-escape.ts +14 -0
  412. package/src/web/insane/url-guard.ts +2 -1
  413. package/src/web/scrapers/types.ts +8 -0
  414. package/src/web/scrapers/youtube.ts +3 -2
  415. package/src/web/search/index.ts +4 -3
  416. package/src/web/search/providers/anthropic.ts +4 -4
  417. package/src/web/search/providers/codex.ts +31 -34
  418. package/src/web/search/providers/insane.ts +145 -28
  419. package/src/web/search/providers/kimi.ts +15 -5
  420. package/src/web/search/providers/searxng.ts +47 -4
  421. package/src/web/search/providers/xai.ts +7 -2
  422. package/dist/types/cli/shell-cli.d.ts +0 -8
  423. package/dist/types/commands/shell.d.ts +0 -21
  424. package/src/cli/shell-cli.ts +0 -176
  425. package/src/commands/shell.ts +0 -29
@@ -1,6 +1,7 @@
1
1
  import type { AgentToolResult } from "@sayknow-cli/agent-core";
2
2
  import type { HookUIContext } from "../../extensibility/hooks/types";
3
3
  import type { LoadedCustomTool, ToolLoadError } from "./types";
4
+ export type CustomToolImportGuard = (resolvedPath: string) => Promise<void>;
4
5
  /** Tool path with optional source metadata */
5
6
  interface ToolPathWithSource {
6
7
  path: string;
@@ -27,7 +28,7 @@ export declare class CustomToolLoader {
27
28
  apply(reason: string): Promise<AgentToolResult<unknown>>;
28
29
  reject?(reason: string): Promise<AgentToolResult<unknown> | undefined>;
29
30
  }) => void);
30
- load(pathsWithSources: ToolPathWithSource[]): Promise<void>;
31
+ load(pathsWithSources: ToolPathWithSource[], beforeImport?: CustomToolImportGuard): Promise<void>;
31
32
  setUIContext(uiContext: HookUIContext, hasUI: boolean): void;
32
33
  }
33
34
  /**
@@ -41,7 +42,7 @@ export declare function loadCustomTools(pathsWithSources: ToolPathWithSource[],
41
42
  sourceToolName: string;
42
43
  apply(reason: string): Promise<AgentToolResult<unknown>>;
43
44
  reject?(reason: string): Promise<AgentToolResult<unknown> | undefined>;
44
- }) => void): Promise<{
45
+ }) => void, beforeImport?: CustomToolImportGuard): Promise<{
45
46
  tools: LoadedCustomTool<import("@sayknow-cli/ai").TSchema, any>[];
46
47
  errors: ToolLoadError[];
47
48
  setUIContext: (uiContext: HookUIContext, hasUI: boolean) => void;
@@ -64,6 +64,8 @@ export interface CustomToolContext {
64
64
  sessionManager: ReadonlySessionManager;
65
65
  /** Model registry - use for API key resolution and model retrieval */
66
66
  modelRegistry: ModelRegistry;
67
+ /** Credential-selection identity for provider authentication. */
68
+ credentialSessionId?: string;
67
69
  /** Current model (may be undefined if no model is selected yet) */
68
70
  model: Model | undefined;
69
71
  /** Whether the agent is idle (not streaming) */
@@ -72,7 +74,7 @@ export interface CustomToolContext {
72
74
  hasQueuedMessages(): boolean;
73
75
  /** Abort the current agent operation (fire-and-forget, does not wait) */
74
76
  abort(): void;
75
- /** Settings instance for the current session. Prefer over the global singleton. */
77
+ /** Settings-compatible, read-only session facade. Mutating or secret accessors are blocked at runtime. */
76
78
  settings?: Settings;
77
79
  }
78
80
  /** Session event passed to onSession callback */
@@ -11,6 +11,8 @@
11
11
  */
12
12
  /** Return true when `version` is safe for use as a cache path component. */
13
13
  export declare function isValidVersionForCache(version: string): boolean;
14
+ /** Write a regular file. A symlink at the destination is removed, not followed. */
15
+ export declare function writeCachedRegularFile(targetPath: string, content: string): Promise<void>;
14
16
  /**
15
17
  * Return the absolute path for a cached plugin directory.
16
18
  * Throws if any component fails validation.
@@ -0,0 +1,2 @@
1
+ /** Resolve a package.json name under the plugins node_modules root, or throw. */
2
+ export declare function resolvePluginLinkPath(root: string, name: string): string;
@@ -37,6 +37,12 @@ export declare class GoalRuntime {
37
37
  get snapshot(): GoalRuntimeSnapshot;
38
38
  shouldTrackTurnBaseline(): boolean;
39
39
  onTurnStart(turnId: string, baselineUsage: GoalTokenUsage): void;
40
+ /**
41
+ * Tool boundaries refresh live accounting in memory only. Persisting a
42
+ * `mode_change` per tool call made usage counters the dominant session-log
43
+ * writer (issue #5949); the durable copy is written at agent end and on every
44
+ * status transition, which already carry the latest in-memory counters.
45
+ */
40
46
  onToolCompleted(toolName: string): Promise<void>;
41
47
  onGoalToolCompleted(): Promise<void>;
42
48
  onAgentEnd(options?: {
@@ -10,6 +10,10 @@ export interface ReceiptSpoolAppendResult {
10
10
  cursor: string;
11
11
  path: string;
12
12
  }
13
+ /** True only when an exception's `code` is `ENOENT`. Other codes propagate. */
14
+ export declare function isEnoent(error: unknown): boolean;
15
+ /** A spool directory the startup project snapshot does not declare. */
16
+ export declare function trustedReceiptSpoolDir(raw: string | undefined): string | undefined;
13
17
  /** @internal Test-only instrumentation for steady-state spool scan coverage. */
14
18
  export declare function receiptSpoolFullScanCountForTesting(): number;
15
19
  /** @internal Test-only cache reset. */
@@ -20,12 +20,11 @@ export interface RecallResultLike {
20
20
  /**
21
21
  * Strip `<memories>`, `<mental_models>`, and legacy memory blocks.
22
22
  *
23
- * Both `<memories>` (per-turn recall) and `<mental_models>` (curated semantic
24
- * memory) are injected into the system prompt. If either leaks into the
25
- * retention transcript, every retain becomes a tighter feedback loop —
26
- * paraphrased memories feed the next consolidation, which feeds the next
27
- * mental-model refresh, which feeds the next retain. Always strip before
28
- * retaining.
23
+ * Matching is case-insensitive and allows whitespace inside the tag.
24
+ * Both per-turn recall and curated mental models are injected around the
25
+ * prompt. If a closer, a case variant, or an early-ended frame leaks into
26
+ * the retention transcript, the next retain stores the breakout as a new
27
+ * memory. Always strip before retaining.
29
28
  */
30
29
  export declare function stripMemoryTags(content: string): string;
31
30
  /** Format recall results into a bullet list for context injection. */
@@ -0,0 +1 @@
1
+ export declare function realSkillPath(baseDir: string, targetPath: string): Promise<string>;
@@ -20,6 +20,8 @@ export interface InternalResource {
20
20
  size?: number;
21
21
  /** Underlying filesystem path (for debugging, not exposed to agent) */
22
22
  sourcePath?: string;
23
+ /** True when model-facing reads must wrap the selected content as untrusted. */
24
+ untrusted?: boolean;
23
25
  /** Additional notes about resolution */
24
26
  notes?: string[];
25
27
  /**
@@ -1,7 +1,3 @@
1
- /**
2
- * SwiftLint CLI-based linter client.
3
- * Parses SwiftLint's JSON reporter output into LSP Diagnostic format.
4
- */
5
1
  import type { Diagnostic, LinterClient, ServerConfig } from "../../lsp/types";
6
2
  /**
7
3
  * SwiftLint CLI-based linter client.
@@ -9,13 +9,16 @@ export interface LspConfig {
9
9
  */
10
10
  export declare function hasRootMarkers(cwd: string, markers: string[]): boolean;
11
11
  /**
12
- * Resolve a command to an executable path.
13
- * Checks project-local bin directories first, then falls back to $PATH.
12
+ * Resolve a host-spawn executable from $PATH without consulting project-controlled bin directories.
13
+ * LSP auto-detection and DAP adapter launch both use this rule.
14
14
  *
15
- * @param command - The command name (e.g., "typescript-language-server")
16
- * @param cwd - Working directory to search from
17
- * @returns Absolute path to the executable, or null if not found
15
+ * Trust is evaluated on both the discovered and canonical paths, but the returned
16
+ * path is the discovered one: multiplexed launchers such as rustup pick the proxied
17
+ * tool from argv[0], so `~/.cargo/bin/rust-analyzer -> rustup` must be spawned as
18
+ * `rust-analyzer`, not as the resolved `rustup` binary.
18
19
  */
20
+ export declare function resolveTrustedCommand(command: string, cwd: string): string | null;
21
+ /** Same rule as `resolveTrustedCommand`: project-local bin directories are never searched. */
19
22
  export declare function resolveCommand(command: string, cwd: string): string | null;
20
23
  /**
21
24
  * Load LSP configuration.
@@ -0,0 +1 @@
1
+ export declare function assertInsideWorkspace(cwd: string, filePath: string): Promise<void>;
@@ -1,5 +1,6 @@
1
1
  /**
2
- * Codex adapter: reads `~/.codex/config.toml` ([mcp_servers]) and `~/.codex/prompts`.
2
+ * Codex adapter: reads `~/.codex/config.toml` ([mcp_servers]), `~/.codex/prompts`,
3
+ * and user-level `~/.codex/AGENTS.md` instructions. Project AGENTS.md is native SKC input.
3
4
  */
4
5
  import { type Adapter } from "./index";
5
6
  export declare const codexAdapter: Adapter;
@@ -1,13 +1,22 @@
1
- import type { AdapterResult, MigrateSource, SkillCandidate, SourceDiagnostic } from "../types";
1
+ import type { AdapterResult, InstructionCandidate, MigrateSource, SkillCandidate, SourceDiagnostic } from "../types";
2
2
  export interface AdapterOptions {
3
3
  /** Home directory root; overridable for tests. */
4
4
  homeDir: string;
5
+ /** Source scope for instructions; other source files remain home-scoped. */
6
+ scope: "project" | "user";
7
+ /** Project root used when importing project instructions. */
8
+ cwd: string;
5
9
  }
6
10
  export interface Adapter {
7
11
  source: MigrateSource;
8
12
  collect(options: AdapterOptions): Promise<AdapterResult>;
9
13
  }
10
14
  export declare function getAdapter(source: MigrateSource): Adapter;
15
+ /** Collect one source instruction file without interpreting or rewriting its content. */
16
+ export declare function collectInstructionFile(filePath: string, source: MigrateSource): Promise<{
17
+ candidates: InstructionCandidate[];
18
+ diagnostics: SourceDiagnostic[];
19
+ }>;
11
20
  /** Read a text file, classifying absence/IO errors into source diagnostics. */
12
21
  export declare function readSourceText(filePath: string, source: MigrateSource, type: SourceDiagnostic["type"]): Promise<{
13
22
  text: string;
@@ -1,2 +1,4 @@
1
1
  import type { MigrateAction } from "./types";
2
- export declare function executeActions(actions: MigrateAction[]): Promise<MigrateAction[]>;
2
+ export declare function executeActions(actions: MigrateAction[], options?: {
3
+ project?: boolean;
4
+ }): Promise<MigrateAction[]>;
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * Shared types for `skc migrate`.
3
3
  *
4
- * Imports MCP servers and skills from other coding agents (Claude Code, Codex,
5
- * OpenCode) into native SKC config. See the consensus plan under
4
+ * Imports MCP servers, skills, and instruction files from other coding agents
5
+ * (Claude Code, Codex, OpenCode) into native SKC config. See the consensus plan under
6
6
  * `.skc/plans/ralplan/` for the full taxonomy and force/collision semantics.
7
7
  */
8
8
  import type { MCPServerConfig } from "../runtime-mcp/types";
@@ -12,7 +12,7 @@ export declare const MIGRATE_SOURCES: readonly MigrateSource[];
12
12
  /** Canonical, deterministic ordering used when expanding `--from all` / repeated `--from`. */
13
13
  export declare const CANONICAL_SOURCE_ORDER: readonly MigrateSource[];
14
14
  /** What kind of thing an action/coverage row is about. */
15
- export type MigrateItemType = "mcp" | "skill" | "source";
15
+ export type MigrateItemType = "mcp" | "skill" | "instruction" | "source";
16
16
  /**
17
17
  * Per-item outcome taxonomy.
18
18
  *
@@ -42,6 +42,12 @@ export interface SkillCandidate {
42
42
  content: string;
43
43
  warnings: string[];
44
44
  }
45
+ /** An instructions file imported as the active SKC AGENTS.md for its scope. */
46
+ export interface InstructionCandidate {
47
+ source: MigrateSource;
48
+ name: string;
49
+ content: string;
50
+ }
45
51
  /**
46
52
  * Source-level diagnostic for a single source/type pair (e.g. "codex mcp config
47
53
  * was malformed"). Distinct from per-item actions so absent/unreadable sources
@@ -57,6 +63,7 @@ export interface SourceDiagnostic {
57
63
  export interface AdapterResult {
58
64
  mcpCandidates: McpCandidate[];
59
65
  skillCandidates: SkillCandidate[];
66
+ instructionCandidates: InstructionCandidate[];
60
67
  diagnostics: SourceDiagnostic[];
61
68
  }
62
69
  /** A single planned action consumed identically by dry-run and live execution. */
@@ -80,6 +87,9 @@ export interface MigrateAction {
80
87
  skill?: {
81
88
  content: string;
82
89
  };
90
+ instruction?: {
91
+ content: string;
92
+ };
83
93
  }
84
94
  export interface MigrateWarning {
85
95
  source: MigrateSource;
@@ -91,6 +101,7 @@ export type StatusCounts = Record<MigrationStatus, number>;
91
101
  export interface MigrateDestinations {
92
102
  mcpConfigPath: string;
93
103
  skillsDir: string;
104
+ instructionsPath: string;
94
105
  }
95
106
  /** The full machine-readable report emitted with `--json`. */
96
107
  export interface MigrateReport {
@@ -105,6 +116,7 @@ export interface MigrateReport {
105
116
  byType: {
106
117
  mcp: StatusCounts;
107
118
  skill: StatusCounts;
119
+ instruction: StatusCounts;
108
120
  source: StatusCounts;
109
121
  };
110
122
  bySource: Record<MigrateSource, StatusCounts>;
@@ -49,6 +49,12 @@ export declare class CustomEditor extends Editor {
49
49
  onQueue?: () => void;
50
50
  /** Called when Caps Lock is pressed. */
51
51
  onCapsLock?: () => void;
52
+ /**
53
+ * Called when typed text is what macOS composes for a bound Option chord
54
+ * (for example `œ` for a bound `alt+q`), meaning the terminal sent Option as
55
+ * text. The text is still inserted; the callback only explains the miss.
56
+ */
57
+ onUnforwardedOptionChord?: (key: KeyId, text: string) => void;
52
58
  /** Called when PageUp/PageDown should scroll the transcript viewport instead of prompt history. */
53
59
  onViewportPageScroll?: (direction: -1 | 1) => void;
54
60
  /** Called before regular composer input should return the transcript viewport to the live bottom. */
@@ -1,3 +1,4 @@
1
+ import type { Settings } from "../../../config/settings";
1
2
  import type { DashboardState, Extension, FlatTreeItem, ProviderTab, TreeNode } from "./types";
2
3
  /**
3
4
  * Settings manager interface for granular toggle persistence.
@@ -9,7 +10,7 @@ export interface ExtensionSettingsManager {
9
10
  /**
10
11
  * Load all extensions from all capabilities.
11
12
  */
12
- export declare function loadAllExtensions(cwd?: string, disabledIds?: string[]): Promise<Extension[]>;
13
+ export declare function loadAllExtensions(cwd?: string, disabledIds?: string[], settings?: Settings): Promise<Extension[]>;
13
14
  /**
14
15
  * Build sidebar tree from extensions.
15
16
  * Groups by provider → kind.
@@ -39,7 +40,7 @@ export declare function applyDisabledExtensionsToState(state: DashboardState, di
39
40
  /**
40
41
  * Create initial dashboard state.
41
42
  */
42
- export declare function createInitialState(cwd?: string, disabledIds?: string[]): Promise<DashboardState>;
43
+ export declare function createInitialState(cwd?: string, disabledIds?: string[], settings?: Settings): Promise<DashboardState>;
43
44
  /**
44
45
  * Toggle provider enabled state.
45
46
  */
@@ -47,4 +48,4 @@ export declare function toggleProvider(providerId: string): boolean;
47
48
  /**
48
49
  * Refresh state after toggle.
49
50
  */
50
- export declare function refreshState(state: DashboardState, cwd?: string, disabledIds?: string[]): Promise<DashboardState>;
51
+ export declare function refreshState(state: DashboardState, cwd?: string, disabledIds?: string[], settings?: Settings): Promise<DashboardState>;
@@ -4,9 +4,55 @@ import { Container, Input, type TUI } from "@sayknow-cli/tui";
4
4
  import type { ModelRegistry, SkcModelAssignmentTargetId } from "../../config/model-registry";
5
5
  import { type ScopedModelSelection } from "../../config/model-resolver";
6
6
  import type { ModelProfileConfig } from "../../config/models-config-schema";
7
+ import { type ProviderAuthState } from "../../config/provider-ranking";
7
8
  import type { Settings } from "../../config/settings";
8
9
  import { type TaskModelSpecialty } from "../../config/task-model-specialties";
10
+ interface SearchableItem {
11
+ searchText: string;
12
+ normalizedSearchText: string;
13
+ compactSearchText: string;
14
+ }
15
+ interface ModelItem extends SearchableItem {
16
+ kind: "provider";
17
+ provider: string;
18
+ id: string;
19
+ model: Model;
20
+ selector: string;
21
+ thinkingLevel?: ThinkingLevel;
22
+ explicitThinkingLevel?: boolean;
23
+ /** Tokenized fuzzy match score for the active query; lower is better. */
24
+ fuzzyScore?: number;
25
+ }
26
+ interface CanonicalModelItem extends SearchableItem {
27
+ kind: "canonical";
28
+ id: string;
29
+ model: Model;
30
+ selector: string;
31
+ variantCount: number;
32
+ thinkingLevel?: ThinkingLevel;
33
+ explicitThinkingLevel?: boolean;
34
+ /** Tokenized fuzzy match score for the active query; lower is better. */
35
+ fuzzyScore?: number;
36
+ }
37
+ type ModelScoreItem = Pick<ModelItem, "id" | "provider" | "fuzzyScore">;
38
+ type CanonicalScoreItem = Pick<CanonicalModelItem, "searchText" | "fuzzyScore">;
39
+ type RankedModelItem = Pick<ModelItem, "id" | "provider" | "model" | "selector" | "fuzzyScore">;
40
+ type RankedCanonicalItem = Pick<CanonicalModelItem, "id" | "model" | "fuzzyScore">;
41
+ /** Assign every item its score for `query`, overwriting stale scores from an earlier query. */
42
+ export declare function assignFuzzyScoresToModels(items: ModelScoreItem[], query: string): void;
43
+ export declare function assignFuzzyScoresToCanonicalModels(items: CanonicalScoreItem[], query: string): void;
44
+ export interface RankedModelOrderContext {
45
+ roles: Record<string, RoleAssignment | undefined>;
46
+ mruIndex: ReadonlyMap<string, number>;
47
+ providerAuthStateById: ReadonlyMap<string, ProviderAuthState>;
48
+ }
49
+ export declare function compareModelItemsForRanking(a: RankedModelItem, b: RankedModelItem, context: RankedModelOrderContext): number;
50
+ export declare function compareCanonicalModelItemsForRanking(a: RankedCanonicalItem, b: RankedCanonicalItem, context: RankedModelOrderContext): number;
9
51
  type ScopedModelItem = ScopedModelSelection;
52
+ interface RoleAssignment {
53
+ model: Model;
54
+ thinkingLevel: ThinkingLevel;
55
+ }
10
56
  export type ModelSelectorSelection = {
11
57
  kind: "assignment";
12
58
  model: Model;
@@ -24,6 +24,15 @@ export declare class InputController {
24
24
  handleDequeue(): void;
25
25
  /** Send editor text as a follow-up message (queued behind current stream). */
26
26
  handleFollowUp(): Promise<void>;
27
+ /**
28
+ * Generate the automatic session title from the first user message. Called
29
+ * from the editor submit and queue-shortcut paths (idle and streaming) and
30
+ * from interactive startup messages; it is a no-op once the session has a
31
+ * user message, a name, or a title request already in flight. The result is
32
+ * bound to the session that requested it: a completion that lands after the
33
+ * session was replaced (New Session, switch, resume) is discarded.
34
+ */
35
+ maybeGenerateSessionTitle(text: string): void;
27
36
  /** Send editor text explicitly as a queued next-turn message. */
28
37
  handleQueueSubmit(): Promise<void>;
29
38
  restoreLatestQueuedMessageToEditor(): number;
@@ -285,6 +285,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
285
285
  handleCtrlZ(): void;
286
286
  handleDequeue(): void;
287
287
  handleBackgroundCommand(): void;
288
+ maybeGenerateSessionTitle(text: string): void;
288
289
  handleImagePaste(): Promise<boolean>;
289
290
  handleBtwCommand(question: string): Promise<void>;
290
291
  hasActiveBtw(): boolean;
@@ -0,0 +1,17 @@
1
+ import type { KeyId } from "@sayknow-cli/tui";
2
+ /** The Option chord that composes `text` on the macOS US/ABC layout, if any. */
3
+ export declare function macosOptionChordForComposedText(text: string): KeyId | undefined;
4
+ /** Terminal-specific instruction for sending Option as Alt/Meta, when the terminal is known. */
5
+ export declare function macosOptionForwardingInstruction(terminalProgram: string | undefined): string | undefined;
6
+ export interface UnforwardedOptionChordWarnerOptions {
7
+ platform: NodeJS.Platform;
8
+ terminalProgram: string | undefined;
9
+ formatKeyHint: (key: KeyId) => string;
10
+ showWarning: (message: string) => void;
11
+ }
12
+ /**
13
+ * Builds the composer callback that explains, once, why a bound Option shortcut
14
+ * produced a character instead of firing. Returns undefined off macOS, where the
15
+ * composition table does not apply.
16
+ */
17
+ export declare function createUnforwardedOptionChordWarner(options: UnforwardedOptionChordWarnerOptions): ((key: KeyId, text: string) => void) | undefined;
@@ -1,4 +1,8 @@
1
1
  export declare const MCP_MAX_CONTENT_BYTES: number;
2
+ export declare const MCP_MAX_IMAGES = 16;
3
+ export declare const MCP_MAX_IMAGE_SOURCE_DIMENSION = 8192;
4
+ export declare const MCP_MAX_IMAGE_SOURCE_PIXELS = 16000000;
5
+ export declare const MCP_MAX_IMAGE_OUTPUT_BYTES: number;
2
6
  export declare const MCP_MAX_ERROR_BYTES: number;
3
7
  export declare const MCP_MAX_SSE_REQUEST_MESSAGES = 1024;
4
8
  export declare const MCP_MAX_SSE_BATCH_MESSAGES = 1024;
@@ -31,6 +31,8 @@ export interface MCPLoadResult {
31
31
  /** Extracted Exa API keys from filtered MCP servers */
32
32
  exaApiKeys: string[];
33
33
  }
34
+ /** Drop project stdio servers unless the caller approved project stdio. */
35
+ export declare function omitUnapprovedProjectStdio(configs: Record<string, MCPServerConfig>, sources: Record<string, SourceMeta>, allowProjectStdio: boolean, toolsOnly?: boolean): void;
34
36
  /** Options for discovering and connecting to MCP servers */
35
37
  export interface MCPDiscoverOptions {
36
38
  /** Whether to load project-level config (default: true) */
@@ -49,6 +51,12 @@ export interface MCPDiscoverOptions {
49
51
  export interface MCPManagerOptions {
50
52
  /** Restrict this instance to tools from an explicit MCP config. */
51
53
  toolsOnly?: boolean;
54
+ /**
55
+ * Spawn stdio servers loaded from a project MCP file during discovery.
56
+ * Default false. User-scope servers and an explicit `--mcp-config` file are
57
+ * unaffected, and so is an explicit connectServers() call.
58
+ */
59
+ allowUntrustedProjectStdio?: boolean;
52
60
  /**
53
61
  * Ceiling for the startup wait, in milliseconds. Only ACP lifecycle launches
54
62
  * set this, so a slow ACP MCP handshake gets the readiness budget while every
@@ -130,7 +138,7 @@ export declare class MCPManager {
130
138
  /**
131
139
  * Resolve auth and shell-command substitutions in config before connecting.
132
140
  */
133
- prepareConfig(config: MCPServerConfig): Promise<MCPServerConfig>;
141
+ prepareConfig(config: MCPServerConfig, source?: SourceMeta): Promise<MCPServerConfig>;
134
142
  /**
135
143
  * Get all connected server names.
136
144
  */
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Follow same-origin MCP redirects only.
3
+ *
4
+ * A cross-origin 307/308 would carry custom credential headers, `Mcp-Session-Id`,
5
+ * and the JSON-RPC body. The first request uses `rawUrl` unchanged so a caller
6
+ * that cannot be parsed (diagnostic redaction) still reaches fetch, but with
7
+ * `redirect: "manual"` so that hop is not followed either.
8
+ */
9
+ export declare function fetchMcpRespectingOrigin(rawUrl: string, init: BunFetchRequestInit): Promise<Response>;
@@ -0,0 +1 @@
1
+ export declare function assertPublicOAuthUrl(url: string): Promise<void>;
@@ -0,0 +1,22 @@
1
+ export declare const SKC_PLUGIN_MCP_PROVIDER = "skc-plugins";
2
+ /**
3
+ * A repository plugin MCP server must not occupy a normalized tool name that a
4
+ * non-plugin server already published. The whole plugin server is omitted so a
5
+ * sibling tool from that server is not left registered. Non-plugin collisions
6
+ * and the input order stay unchanged.
7
+ */
8
+ export declare function omitPluginMcpNameShadows<T extends {
9
+ name: string;
10
+ }>(tools: readonly T[]): T[];
11
+ /** Normalized names of plugin tools that remain after shadow omission. */
12
+ export declare function survivingPluginMcpToolNames<T extends {
13
+ name: string;
14
+ }>(tools: readonly T[]): string[];
15
+ /**
16
+ * The required-name list is the plugin tools that survived the name filter,
17
+ * plus requested names this batch did not omit. An omitted plugin tool, including
18
+ * a sibling that does not itself collide, is not required.
19
+ */
20
+ export declare function retainPluginMcpMandatoryNames(tools: readonly {
21
+ name: string;
22
+ }[], requested: readonly string[]): string[];
@@ -3,6 +3,7 @@ import type { MCPHttpServerConfig, MCPSseServerConfig } from "./types";
3
3
  /** Mark an in-memory plugin-bundle remote MCP config for connection-bound public-network enforcement. */
4
4
  export declare function bindPluginMcpToPublicNetwork<T extends MCPHttpServerConfig | MCPSseServerConfig>(config: T): T;
5
5
  /** The marker is an internal symbol, so persisted user MCP configs cannot opt into or forge this path. */
6
+ export declare function usesPublicNetworkMcpFetch(config: MCPHttpServerConfig | MCPSseServerConfig): boolean;
6
7
  export declare function isPluginMcpPublicNetworkBound(config: MCPHttpServerConfig | MCPSseServerConfig): boolean;
7
8
  /**
8
9
  * Fetch a plugin-bundle MCP request through a DNS-pinned public address. Every
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Host-value policy for MCP config that comes from an untrusted project file.
3
+ *
4
+ * User mcp.json and an explicit `--mcp-config` file may still substitute
5
+ * secret-named environment variables and run `!` shell commands. Any
6
+ * project-level source, including providers other than native `.skc/mcp.json`
7
+ * and repo-root `mcp.json`, uses the same sensitive-name rule as project
8
+ * `ssh.json`: do not copy those host values into server env or headers, and
9
+ * do not execute `!`.
10
+ */
11
+ import type { SourceMeta } from "../capability/types";
12
+ export declare function nativeMcpSource(level: "user" | "project", filePath: string): SourceMeta;
13
+ /**
14
+ * True when this server was loaded from untrusted project MCP config.
15
+ * Every project-level provider is untrusted, including providers other than
16
+ * native `.skc/mcp.json` and repo-root `mcp.json`. User scope and a tools-only
17
+ * load stay on the previous path.
18
+ */
19
+ export declare function isUntrustedProjectMcpSource(source: SourceMeta | undefined, toolsOnly: boolean): boolean;
20
+ export type ProjectHostValueDecision = {
21
+ action: "resolve";
22
+ } | {
23
+ action: "drop";
24
+ } | {
25
+ action: "literal";
26
+ value: string;
27
+ };
28
+ /**
29
+ * Decide how to interpret one env or header value.
30
+ * `drop` means "do not run the shell, and omit the value".
31
+ * `literal` means "do not read process.env".
32
+ */
33
+ export declare function decideUntrustedProjectConfigValue(value: string, untrusted: boolean): ProjectHostValueDecision;
@@ -1,4 +1,22 @@
1
+ import { type AddressResolver } from "../web/insane/url-guard";
1
2
  import type { MCPServerConfig } from "./types";
3
+ type SmitheryConnection = {
4
+ type?: "http" | "stdio";
5
+ deploymentUrl?: string;
6
+ configSchema?: SmitheryConfigSchema;
7
+ };
8
+ type SmitheryConfigSchema = {
9
+ type?: string;
10
+ required?: string[];
11
+ properties?: Record<string, SmitheryConfigProperty>;
12
+ };
13
+ type SmitheryConfigProperty = {
14
+ type?: string;
15
+ description?: string;
16
+ default?: unknown;
17
+ enum?: unknown[];
18
+ format?: string;
19
+ };
2
20
  type RegistryInputType = "string" | "number" | "boolean";
3
21
  export type SmitherySearchResult = {
4
22
  id: string;
@@ -46,6 +64,12 @@ export declare class SmitheryRegistryError extends Error {
46
64
  status: number;
47
65
  constructor(message: string, status: number);
48
66
  }
67
+ export declare function resolveSmitheryServerConfig(qualifiedName: string, selected: {
68
+ connection: SmitheryConnection;
69
+ useDirectHttp: boolean;
70
+ }, options?: {
71
+ resolver?: AddressResolver;
72
+ }): Promise<MCPServerConfig | null>;
49
73
  export declare function searchSmitheryRegistry(keyword: string, options?: SmitherySearchOptions): Promise<SmitherySearchResult[]>;
50
74
  export declare function toConfigName(candidate: string): string;
51
75
  export {};
@@ -53,6 +53,8 @@ export declare class MCPTool implements CustomTool<TSchema, MCPToolDetails> {
53
53
  readonly mcpToolName: string;
54
54
  /** Server name */
55
55
  readonly mcpServerName: string;
56
+ /** True when this tool came from a repository SKC plugin bundle. */
57
+ readonly skcPluginBundle: boolean;
56
58
  /** Create MCPTool instances for all tools from an MCP server connection */
57
59
  static fromTools(connection: MCPServerConnection, tools: MCPToolDefinition[], reconnect?: MCPReconnect): MCPTool[];
58
60
  constructor(connection: MCPServerConnection, tool: MCPToolDefinition, reconnect?: MCPReconnect | undefined);
@@ -77,6 +79,8 @@ export declare class DeferredMCPTool implements CustomTool<TSchema, MCPToolDetai
77
79
  readonly mcpToolName: string;
78
80
  /** Server name */
79
81
  readonly mcpServerName: string;
82
+ /** True when this tool came from a repository SKC plugin bundle. */
83
+ readonly skcPluginBundle: boolean;
80
84
  /** Create DeferredMCPTool instances for all tools from an MCP server */
81
85
  static fromTools(serverName: string, tools: MCPToolDefinition[], getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect): DeferredMCPTool[];
82
86
  constructor(serverName: string, tool: MCPToolDefinition, getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect | undefined);
@@ -85,6 +85,12 @@ export interface MCPHttpServerConfig extends MCPServerConfigBase {
85
85
  type: "http";
86
86
  url: string;
87
87
  headers?: Record<string, string>;
88
+ /**
89
+ * When true, every request and redirect for this URL is rechecked against
90
+ * the public-network policy. Persisted so a later process cannot fall back
91
+ * to an unguarded fetch. Ordinary localhost MCP servers leave this unset.
92
+ */
93
+ publicNetwork?: boolean;
88
94
  }
89
95
  /** SSE server configuration (deprecated, use HTTP) */
90
96
  export interface MCPSseServerConfig extends MCPServerConfigBase {
@@ -39,6 +39,8 @@ interface BrokerOwner {
39
39
  stop(): Promise<void>;
40
40
  canReuse(discovery: BrokerDiscovery | null): boolean;
41
41
  markReady(discovery: BrokerDiscovery): boolean;
42
+ /** Rebinds ownership to the broker identity a trampoline reported. */
43
+ setTarget(pid: number, incarnation: string): void;
42
44
  }
43
45
  interface ReapTiming {
44
46
  gracefulMs: number;
@@ -93,12 +93,16 @@ export declare class LifecycleLedger {
93
93
  constructor(agentDir: string, limits?: LifecycleLedgerLimits);
94
94
  open(): Promise<this>;
95
95
  /**
96
- * Reads terminal proof for one request without recovering or changing the ledger.
96
+ * Reads the durable terminal record for one request without recovering or changing the ledger.
97
97
  *
98
98
  * This intentionally accepts an unrelated unterminated final write: concurrent
99
99
  * appenders may have started a different row after this request's synced terminal
100
100
  * row. Complete rows are still decoded and validated strictly, and any incomplete
101
101
  * tail that identifies this request withholds proof.
102
+ *
103
+ * `terminal_uncertain` is a durable terminal record too: an operation that concluded
104
+ * uncertainly persists that conclusion, and refusing to read it back would report a
105
+ * synced row as unpersisted and replace its true reason with a generic one.
102
106
  */
103
107
  readTerminal(identity: string, requestHash: string): Promise<LifecycleLedgerEntry | undefined>;
104
108
  get warnings(): readonly string[];
@@ -1,4 +1,4 @@
1
- export type SdkInternalAction = "broker-internal" | "session-host-internal";
1
+ export type SdkInternalAction = "broker-internal" | "broker-trampoline-internal" | "session-host-internal";
2
2
  export type SdkInternalSpawnCommand = {
3
3
  kind: "bun-source";
4
4
  file: string;