@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
package/src/main.ts CHANGED
@@ -5,6 +5,7 @@
5
5
  * createAgentSession() options. The SDK does the heavy lifting.
6
6
  */
7
7
 
8
+ import { existsSync } from "node:fs";
8
9
  import * as fs from "node:fs/promises";
9
10
  import * as os from "node:os";
10
11
  import * as path from "node:path";
@@ -21,13 +22,14 @@ import {
21
22
  VERSION,
22
23
  } from "@sayknow-cli/utils";
23
24
  import chalk from "chalk";
25
+ import { selectAppendSystemPromptFile } from "./cli/append-system-prompt";
24
26
  import type { Args } from "./cli/args";
25
27
  import { processFileArguments } from "./cli/file-processor";
26
28
  import { buildInitialMessage } from "./cli/initial-message";
27
29
  import { resolveLaunchDisposition } from "./cli/launch-disposition";
28
30
  import { runListModelsCommand } from "./cli/list-models";
29
31
  import { selectSession } from "./cli/session-picker";
30
- import { findConfigFile } from "./config";
32
+ import { getConfigDirs } from "./config";
31
33
  import { activateModelProfile, ModelProfileCredentialError } from "./config/model-profile-activation";
32
34
  import { ModelRegistry, ModelsConfigFile } from "./config/model-registry";
33
35
  import { resolveCliModel, resolveModelRoleValue, resolveModelScope, type ScopedModel } from "./config/model-resolver";
@@ -423,6 +425,13 @@ async function applyStartupModelProfilesWithPolicy(
423
425
  );
424
426
  } catch (error) {
425
427
  if (onCredentialError && error instanceof ModelProfileCredentialError) {
428
+ // The toast/stderr warning is transient; keep a log record so a session
429
+ // left on the provisional model can be diagnosed afterwards.
430
+ logger.warn("Startup model profile not applied: missing provider credentials", {
431
+ profile: profileName,
432
+ errorClass: error.name,
433
+ providers: error.providers,
434
+ });
426
435
  onCredentialError(error);
427
436
  return;
428
437
  }
@@ -643,6 +652,21 @@ export async function runInteractiveMode(
643
652
  }
644
653
  }
645
654
 
655
+ // Startup input bypasses the editor submit path, so seed the automatic title
656
+ // here. Only text that `prompt` actually dispatches to a loaded skill is
657
+ // skipped; unknown `/skill:` text is submitted as an ordinary prompt and is
658
+ // titled like one. It must run before the prompt (the title gate skips
659
+ // sessions that already hold a user message), and a title failure must never
660
+ // drop the prompt.
661
+ const maybeGenerateStartupTitle = (text: string, images?: readonly unknown[]): void => {
662
+ try {
663
+ if (session.resolvePromptSkillInvocation(text, images) || session.isLocallyHandledSlashCommand(text)) return;
664
+ mode.maybeGenerateSessionTitle(text);
665
+ } catch (error: unknown) {
666
+ logger.warn("Startup session title generation failed", { error: String(error) });
667
+ }
668
+ };
669
+
646
670
  const hasStartupInput = initialMessage !== undefined || initialMessages.length > 0;
647
671
  if (!hasStartupInput && resumeAction === "continue-tail") {
648
672
  try {
@@ -655,6 +679,7 @@ export async function runInteractiveMode(
655
679
 
656
680
  if (initialMessage !== undefined) {
657
681
  try {
682
+ maybeGenerateStartupTitle(initialMessage, initialImages);
658
683
  await session.prompt(initialMessage, { images: initialImages });
659
684
  } catch (error: unknown) {
660
685
  const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
@@ -671,6 +696,7 @@ export async function runInteractiveMode(
671
696
  });
672
697
  if (slashResult === true) continue;
673
698
  if (typeof slashResult === "string") text = slashResult;
699
+ maybeGenerateStartupTitle(text);
674
700
  await session.prompt(text);
675
701
  } catch (error: unknown) {
676
702
  const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
@@ -896,17 +922,13 @@ async function maybeAutoChdir(parsed: Args): Promise<void> {
896
922
  }
897
923
  }
898
924
 
899
- /** Discover APPEND_SYSTEM.md file if no CLI append system prompt was provided */
925
+ /** User APPEND_SYSTEM.md only. Repository copies are not appended. */
900
926
  function discoverAppendSystemPromptFile(): string | undefined {
901
- const projectPath = findConfigFile("APPEND_SYSTEM.md", { user: false });
902
- if (projectPath) {
903
- return projectPath;
904
- }
905
- const globalPath = findConfigFile("APPEND_SYSTEM.md", { user: true });
906
- if (globalPath) {
907
- return globalPath;
908
- }
909
- return undefined;
927
+ const candidates = getConfigDirs("", { existingOnly: false }).flatMap(entry => {
928
+ const filePath = path.join(entry.path, "APPEND_SYSTEM.md");
929
+ return existsSync(filePath) ? [{ level: entry.level, path: filePath }] : [];
930
+ });
931
+ return selectAppendSystemPromptFile(candidates);
910
932
  }
911
933
 
912
934
  async function buildSessionOptions(
@@ -3,7 +3,15 @@ import type * as fsNode from "node:fs";
3
3
  import * as fs from "node:fs/promises";
4
4
  import * as path from "node:path";
5
5
  import type { AgentMessage } from "@sayknow-cli/agent-core";
6
- import { completeSimple, Effort, type Model } from "@sayknow-cli/ai";
6
+ import { estimateTextTokensHeuristic } from "@sayknow-cli/agent-core/compaction";
7
+ import {
8
+ ANTHROPIC_THINKING,
9
+ completeSimple,
10
+ Effort,
11
+ type Model,
12
+ resolveDefaultRequestMaxTokens,
13
+ } from "@sayknow-cli/ai";
14
+ import { clampThinkingLevelForModel } from "@sayknow-cli/ai/model-thinking";
7
15
  import { getAgentDbPath, getMemoriesDir, logger, parseJsonlLenient, prompt } from "@sayknow-cli/utils";
8
16
  import type { ModelRegistry } from "../config/model-registry";
9
17
  import { resolveModelRoleValue } from "../config/model-resolver";
@@ -73,6 +81,20 @@ const DEFAULTS: MemoryRuntimeConfig = {
73
81
  summaryInjectionTokenLimit: 5_000,
74
82
  };
75
83
 
84
+ const PHASE2_RAW_MEMORIES_TOKEN_LIMIT = 20_000;
85
+ const PHASE2_ROLLOUT_SUMMARIES_TOKEN_LIMIT = 12_000;
86
+ // Ceiling for the phase 2 response. Phase 2 rewrites MEMORY.md, the summary and every
87
+ // skill in one JSON response, and on adaptive-thinking / reasoning-effort models the
88
+ // reasoning shares this budget. Twice the (approximate) input caps is a generous
89
+ // practical ceiling, not a guarantee that every response fits; a response that still
90
+ // overruns it is reported as truncation.
91
+ const PHASE2_MAX_OUTPUT_TOKENS = 2 * (PHASE2_RAW_MEMORIES_TOKEN_LIMIT + PHASE2_ROLLOUT_SUMMARIES_TOKEN_LIMIT);
92
+ // On a small context window phase 2 shrinks its inputs rather than let the response
93
+ // budget drop below the previous fixed budget.
94
+ const PHASE2_MIN_OUTPUT_TOKENS = 8_192;
95
+ // Request framing plus estimator error when fitting input + output into the context window.
96
+ const PHASE2_CONTEXT_SAFETY_TOKENS = 2_048;
97
+
76
98
  interface Stage1Stats {
77
99
  claimed: number;
78
100
  succeeded: number;
@@ -615,7 +637,7 @@ async function runStage1Job(options: {
615
637
  apiKey,
616
638
  metadata: options.metadata,
617
639
  maxTokens: Math.max(1024, Math.min(4096, Math.floor(modelMaxTokens * 0.2))),
618
- reasoning: Effort.Low,
640
+ reasoning: clampThinkingLevelForModel(model, Effort.Low),
619
641
  },
620
642
  );
621
643
 
@@ -737,26 +759,38 @@ async function runConsolidationModel(options: {
737
759
  const { memoryRoot, model, apiKey } = options;
738
760
  const rawMemories = await Bun.file(path.join(memoryRoot, "raw_memories.md")).text();
739
761
  const rolloutSummaries = await readRolloutSummaries(memoryRoot);
740
- const input = prompt.render(consolidationTemplate, {
741
- raw_memories: truncateByApproxTokens(rawMemories, 20_000),
742
- rollout_summaries: truncateByApproxTokens(rolloutSummaries, 12_000),
743
- });
762
+ const reasoning = clampThinkingLevelForModel(model, Effort.Low);
763
+ const { input, maxTokens } = buildPhase2Request(model, rawMemories, rolloutSummaries, reasoning);
744
764
 
745
765
  const response = await completeSimple(
746
766
  model,
747
767
  {
748
768
  messages: [{ role: "user", content: [{ type: "text", text: input }], timestamp: Date.now() }],
749
769
  },
750
- { apiKey, metadata: options.metadata, maxTokens: 8192, reasoning: Effort.Medium },
770
+ {
771
+ apiKey,
772
+ metadata: options.metadata,
773
+ maxTokens,
774
+ reasoning,
775
+ },
751
776
  );
752
777
  if (response.stopReason === "error") {
753
778
  throw new Error(response.errorMessage || "phase2 model error");
754
779
  }
780
+ if (response.stopReason === "length") {
781
+ throw new Error(`phase2 output truncated at the max output token limit (${response.usage.output} output tokens)`);
782
+ }
755
783
  const text = response.content
756
784
  .filter((c): c is { type: "text"; text: string } => c.type === "text")
757
785
  .map(c => c.text)
758
786
  .join("\n")
759
787
  .trim();
788
+ if (!text) {
789
+ const thinkingBlocks = response.content.filter(c => c.type === "thinking").length;
790
+ throw new Error(
791
+ `phase2 returned no text (stopReason=${response.stopReason}, ${response.usage.output} output tokens, ${thinkingBlocks} thinking blocks)`,
792
+ );
793
+ }
760
794
  const parsed = parseJsonObject(text);
761
795
  if (!parsed) throw new Error("phase2 JSON parse failure");
762
796
  const schemaOutput = parseConsolidationOutputSchema(parsed);
@@ -973,18 +1007,63 @@ function hasExactKeys(value: Record<string, unknown>, expectedKeys: string[], al
973
1007
  function redactSecrets(input: string): string {
974
1008
  let out = input;
975
1009
  const patterns = [
1010
+ // A PEM block is redacted whole and therefore runs first; the narrower rules
1011
+ // would otherwise consume its base64 body and leave a truncated key behind.
1012
+ /-----BEGIN [A-Z0-9 ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z0-9 ]*PRIVATE KEY-----/g,
976
1013
  /(?:sk|pk|rk|tok|key|secret|token|password)[-_A-Za-z0-9]{12,}/g,
977
- /[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}/g,
978
- /(?:AKIA|ASIA)[A-Z0-9]{16}/g,
1014
+ // The leading boundary is anchored. Without it the first segment re-tries
1015
+ // every offset of a long token-character run before failing to find `.`,
1016
+ // which is quadratic: 200 KB of ordinary prose cost ~10.6s.
1017
+ /(?<![A-Za-z0-9_-])[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}/g,
1018
+ // ABIA (bearer) and ACCA (context) complete the AWS identifier prefixes the
1019
+ // session-import and crash scrubbers already list.
1020
+ /(?:AKIA|ASIA|ABIA|ACCA)[A-Z0-9]{16}/g,
979
1021
  // GitHub tokens carry no keyword the first pattern recognizes, so without
980
1022
  // this they reached MEMORY.md and memory_summary.md verbatim — and the
981
1023
  // summary is injected into every later session. Same shapes the
982
1024
  // contribution-prep scrubber already covers.
983
1025
  /\b(?:gh[opsur]_[A-Za-z0-9_]{12,}|github_pat_[A-Za-z0-9_]{12,})\b/g,
1026
+ // Google API keys are a fixed 39-character shape carrying no keyword.
1027
+ /\bAIza[0-9A-Za-z_-]{35}\b/g,
1028
+ /\bxox[baprs]-[A-Za-z0-9-]{10,}\b/g,
1029
+ // The shapes `crash/upstream/envelope.ts` classifies as credential-like.
1030
+ // Stripe and Hugging Face separate with `_`, so the keyword rule above,
1031
+ // which requires `sk`/`pk`/`rk` followed by `[-_A-Za-z0-9]`, still misses
1032
+ // `hf_` and `npm_` entirely.
1033
+ /\bnpm_[A-Za-z0-9]{20,}\b/g,
1034
+ /\bglpat-[A-Za-z0-9_-]{20,}\b/g,
1035
+ /\b(?:sk|rk)_(?:live|test)_[A-Za-z0-9]{16,}\b/g,
1036
+ /\bhf_[A-Za-z0-9]{20,}\b/g,
1037
+ // Basic-auth credentials in a URL. The scheme repetition is bounded for the
1038
+ // same reason the boundary above is anchored.
1039
+ /(?<![A-Za-z0-9+.-])[a-z][a-z0-9+.-]{0,15}:\/\/[^/\s:@]{1,256}:[^/\s@]{1,256}@/gi,
984
1040
  ];
985
1041
  for (const pattern of patterns) {
986
1042
  out = out.replace(pattern, "[REDACTED]");
987
1043
  }
1044
+ return redactBearerAndBasicAssignments(out);
1045
+ }
1046
+
1047
+ /**
1048
+ * Bearer and Basic assignments have no vendor prefix, so the rules above miss
1049
+ * them. A following word with no digit, "+", "/", or "=" stays, which keeps
1050
+ * phrases such as "Basic authentication" and "the bearer of".
1051
+ */
1052
+ function bearerOrBasicValueIsCredential(value: string): boolean {
1053
+ if (value.length < 8) return false;
1054
+ if (value.includes("+") || value.includes("/") || value.includes("=")) return true;
1055
+ return value.length >= 12 && /[0-9]/.test(value);
1056
+ }
1057
+
1058
+ function redactBearerAndBasicAssignments(input: string): string {
1059
+ const labeled = /(["']?authorization["']?\s*[:=]\s*["']?)((?:bearer|basic)\s+["']?)([A-Za-z0-9._~+/=-]{8,})/gi;
1060
+ const bare = /\b((?:bearer|basic)\s+["']?)([A-Za-z0-9._~+/=-]{8,})/gi;
1061
+ let out = input.replace(labeled, (match, label: string, scheme: string, value: string) =>
1062
+ bearerOrBasicValueIsCredential(value) ? `${label}${scheme}[REDACTED]` : match,
1063
+ );
1064
+ out = out.replace(bare, (match, scheme: string, value: string) =>
1065
+ bearerOrBasicValueIsCredential(value) ? `${scheme}[REDACTED]` : match,
1066
+ );
988
1067
  return out;
989
1068
  }
990
1069
 
@@ -1073,6 +1152,59 @@ function truncateByApproxTokens(text: string, tokenLimit: number): string {
1073
1152
  return `${text.slice(0, head)}\n\n...[truncated]...\n\n${text.slice(-tail)}`;
1074
1153
  }
1075
1154
 
1155
+ /**
1156
+ * Render the phase 2 prompt and choose its response budget.
1157
+ *
1158
+ * The budget is the model's output limit capped at PHASE2_MAX_OUTPUT_TOKENS (or the
1159
+ * provider layer's request default when the limit is unknown). When the context window
1160
+ * is known, input + response + any thinking budget the provider adds on top must fit
1161
+ * in it: the response budget is clamped to the remaining room, and the inputs are
1162
+ * shrunk when that room would fall below PHASE2_MIN_OUTPUT_TOKENS.
1163
+ */
1164
+ function buildPhase2Request(
1165
+ model: Model,
1166
+ rawMemories: string,
1167
+ rolloutSummaries: string,
1168
+ reasoning: Effort | undefined,
1169
+ ): { input: string; maxTokens: number | undefined } {
1170
+ const outputLimit =
1171
+ Number.isSafeInteger(model.maxTokens) && model.maxTokens > 0
1172
+ ? Math.min(model.maxTokens, PHASE2_MAX_OUTPUT_TOKENS)
1173
+ : undefined;
1174
+ let rawTokens = Math.min(PHASE2_RAW_MEMORIES_TOKEN_LIMIT, Math.ceil(rawMemories.length / 4));
1175
+ let rolloutTokens = Math.min(PHASE2_ROLLOUT_SUMMARIES_TOKEN_LIMIT, Math.ceil(rolloutSummaries.length / 4));
1176
+ const render = () =>
1177
+ prompt.render(consolidationTemplate, {
1178
+ raw_memories: truncateByApproxTokens(rawMemories, rawTokens),
1179
+ rollout_summaries: truncateByApproxTokens(rolloutSummaries, rolloutTokens),
1180
+ });
1181
+
1182
+ const contextWindow =
1183
+ Number.isSafeInteger(model.contextWindow) && model.contextWindow > 0 ? model.contextWindow : undefined;
1184
+ if (contextWindow === undefined) return { input: render(), maxTokens: outputLimit };
1185
+
1186
+ const responseCeiling = resolveDefaultRequestMaxTokens(model, outputLimit);
1187
+ const minResponse = Math.min(PHASE2_MIN_OUTPUT_TOKENS, responseCeiling);
1188
+ // Budget-mode providers may add the thinking budget on top of maxTokens.
1189
+ const addsThinkingBudget = model.thinking?.mode === "budget" || model.thinking?.mode === "anthropic-budget-effort";
1190
+ const thinkingReserve = reasoning && addsThinkingBudget ? ANTHROPIC_THINKING[reasoning] : 0;
1191
+ const inputRoom = contextWindow - PHASE2_CONTEXT_SAFETY_TOKENS - thinkingReserve - minResponse;
1192
+
1193
+ for (let attempt = 0; attempt < 4; attempt++) {
1194
+ const input = render();
1195
+ const inputTokens = estimateTextTokensHeuristic(input);
1196
+ if (inputTokens <= inputRoom) {
1197
+ const room = contextWindow - PHASE2_CONTEXT_SAFETY_TOKENS - thinkingReserve - inputTokens;
1198
+ return { input, maxTokens: Math.min(responseCeiling, room) };
1199
+ }
1200
+ if (inputRoom <= 0 || rawTokens + rolloutTokens === 0) break;
1201
+ const scale = (inputRoom / inputTokens) * 0.9;
1202
+ rawTokens = Math.floor(rawTokens * scale);
1203
+ rolloutTokens = Math.floor(rolloutTokens * scale);
1204
+ }
1205
+ throw new Error(`phase2 input does not fit the model context window (${contextWindow} tokens)`);
1206
+ }
1207
+
1076
1208
  function computeModelTokenBudget(model: Model, config: MemoryRuntimeConfig): number {
1077
1209
  const maxTokens =
1078
1210
  Number.isFinite(model.contextWindow) && model.contextWindow > 0 ? model.contextWindow : config.fallbackTokenLimit;
@@ -314,5 +314,62 @@ export async function planMigration(input: PlanInput): Promise<PlanOutput> {
314
314
  }
315
315
  }
316
316
 
317
+ // 4. Instructions — all selected sources target the same scoped AGENTS.md.
318
+ const plannedInstructions = new Set<string>();
319
+ for (const result of input.results) {
320
+ for (const candidate of result.instructionCandidates) {
321
+ const destination = input.destinations.instructionsPath;
322
+ const base = { source: candidate.source, type: "instruction" as const, name: candidate.name, destination };
323
+ if (plannedInstructions.has(destination)) {
324
+ actions.push({
325
+ ...base,
326
+ operation: "skip",
327
+ status: "skipped_exists",
328
+ reason: "another selected source already targets this file; import one source at a time",
329
+ });
330
+ continue;
331
+ }
332
+
333
+ let exists = false;
334
+ try {
335
+ const stat = await fs.lstat(destination);
336
+ exists = true;
337
+ if (!stat.isFile() || stat.isSymbolicLink()) {
338
+ actions.push({
339
+ ...base,
340
+ operation: input.force ? "fail" : "skip",
341
+ status: input.force ? "failed_invalid_destination" : "skipped_exists",
342
+ reason: "destination is not a regular file; refusing to replace it",
343
+ });
344
+ plannedInstructions.add(destination);
345
+ continue;
346
+ }
347
+ } catch (error) {
348
+ if (!isEnoent(error)) {
349
+ actions.push({
350
+ ...base,
351
+ operation: "fail",
352
+ status: "failed_io",
353
+ reason: `failed to inspect destination: ${(error as Error).message}`,
354
+ });
355
+ plannedInstructions.add(destination);
356
+ continue;
357
+ }
358
+ }
359
+
360
+ if (exists && !input.force) {
361
+ actions.push({ ...base, operation: "skip", status: "skipped_exists" });
362
+ } else {
363
+ actions.push({
364
+ ...base,
365
+ operation: exists ? "update" : "create",
366
+ status: exists ? "updated" : "imported",
367
+ instruction: { content: candidate.content },
368
+ });
369
+ }
370
+ plannedInstructions.add(destination);
371
+ }
372
+ }
373
+
317
374
  return { actions, warnings };
318
375
  }
@@ -1,16 +1,29 @@
1
1
  /**
2
- * Claude Code adapter: reads `~/.claude.json` (mcpServers) and `~/.claude/skills`.
2
+ * Claude Code adapter: reads `~/.claude.json` (mcpServers), `~/.claude/skills`,
3
+ * and the selected scope's `CLAUDE.md`.
3
4
  */
4
5
  import * as path from "node:path";
5
6
  import type { AdapterResult, McpCandidate } from "../types";
6
- import { type Adapter, type AdapterOptions, collectSkillDir, parseSourceJson, readSourceText } from "./index";
7
+ import {
8
+ type Adapter,
9
+ type AdapterOptions,
10
+ collectInstructionFile,
11
+ collectSkillDir,
12
+ parseSourceJson,
13
+ readSourceText,
14
+ } from "./index";
7
15
 
8
16
  const SOURCE = "claude-code" as const;
9
17
 
10
18
  export const claudeCodeAdapter: Adapter = {
11
19
  source: SOURCE,
12
- async collect({ homeDir }: AdapterOptions): Promise<AdapterResult> {
13
- const result: AdapterResult = { mcpCandidates: [], skillCandidates: [], diagnostics: [] };
20
+ async collect({ homeDir, cwd, scope }: AdapterOptions): Promise<AdapterResult> {
21
+ const result: AdapterResult = {
22
+ mcpCandidates: [],
23
+ skillCandidates: [],
24
+ instructionCandidates: [],
25
+ diagnostics: [],
26
+ };
14
27
 
15
28
  const configPath = path.join(homeDir, ".claude.json");
16
29
  const read = await readSourceText(configPath, SOURCE, "mcp");
@@ -34,6 +47,12 @@ export const claudeCodeAdapter: Adapter = {
34
47
  result.skillCandidates.push(...skills.candidates);
35
48
  result.diagnostics.push(...skills.diagnostics);
36
49
 
50
+ const instructionsPath =
51
+ scope === "project" ? path.join(cwd, "CLAUDE.md") : path.join(homeDir, ".claude", "CLAUDE.md");
52
+ const instructions = await collectInstructionFile(instructionsPath, SOURCE);
53
+ result.instructionCandidates.push(...instructions.candidates);
54
+ result.diagnostics.push(...instructions.diagnostics);
55
+
37
56
  return result;
38
57
  },
39
58
  };
@@ -1,11 +1,18 @@
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
 
5
6
  import * as path from "node:path";
6
7
  import { TOML } from "bun";
7
8
  import type { AdapterResult, McpCandidate, SourceDiagnostic } from "../types";
8
- import { type Adapter, type AdapterOptions, collectMarkdownPrompts, readSourceText } from "./index";
9
+ import {
10
+ type Adapter,
11
+ type AdapterOptions,
12
+ collectInstructionFile,
13
+ collectMarkdownPrompts,
14
+ readSourceText,
15
+ } from "./index";
9
16
 
10
17
  const SOURCE = "codex" as const;
11
18
 
@@ -40,8 +47,13 @@ function parseToml(
40
47
 
41
48
  export const codexAdapter: Adapter = {
42
49
  source: SOURCE,
43
- async collect({ homeDir }: AdapterOptions): Promise<AdapterResult> {
44
- const result: AdapterResult = { mcpCandidates: [], skillCandidates: [], diagnostics: [] };
50
+ async collect({ homeDir, scope }: AdapterOptions): Promise<AdapterResult> {
51
+ const result: AdapterResult = {
52
+ mcpCandidates: [],
53
+ skillCandidates: [],
54
+ instructionCandidates: [],
55
+ diagnostics: [],
56
+ };
45
57
 
46
58
  const configPath = path.join(homeDir, ".codex", "config.toml");
47
59
  const read = await readSourceText(configPath, SOURCE, "mcp");
@@ -65,6 +77,12 @@ export const codexAdapter: Adapter = {
65
77
  result.skillCandidates.push(...prompts.candidates);
66
78
  result.diagnostics.push(...prompts.diagnostics);
67
79
 
80
+ if (scope === "user") {
81
+ const instructions = await collectInstructionFile(path.join(homeDir, ".codex", "AGENTS.md"), SOURCE);
82
+ result.instructionCandidates.push(...instructions.candidates);
83
+ result.diagnostics.push(...instructions.diagnostics);
84
+ }
85
+
68
86
  return result;
69
87
  },
70
88
  };
@@ -1,14 +1,15 @@
1
1
  /**
2
2
  * Source adapters for `skc migrate`.
3
3
  *
4
- * Each adapter reads GLOBAL/home config for one source agent and returns
5
- * normalized MCP + skill candidates plus source-level diagnostics. Adapters never
6
- * read project-level config and never connect to anything.
4
+ * Each adapter returns normalized home-scoped MCP/skill candidates, selected-scope
5
+ * instruction candidates, and source-level diagnostics. Adapters never connect to
6
+ * anything.
7
7
  */
8
8
  import * as fs from "node:fs/promises";
9
+ import * as path from "node:path";
9
10
  import { isEnoent } from "@sayknow-cli/utils";
10
11
  import { normalizeSkill } from "../skill-normalizer";
11
- import type { AdapterResult, MigrateSource, SkillCandidate, SourceDiagnostic } from "../types";
12
+ import type { AdapterResult, InstructionCandidate, MigrateSource, SkillCandidate, SourceDiagnostic } from "../types";
12
13
  import { claudeCodeAdapter } from "./claude-code";
13
14
  import { codexAdapter } from "./codex";
14
15
  import { opencodeAdapter } from "./opencode";
@@ -16,6 +17,10 @@ import { opencodeAdapter } from "./opencode";
16
17
  export interface AdapterOptions {
17
18
  /** Home directory root; overridable for tests. */
18
19
  homeDir: string;
20
+ /** Source scope for instructions; other source files remain home-scoped. */
21
+ scope: "project" | "user";
22
+ /** Project root used when importing project instructions. */
23
+ cwd: string;
19
24
  }
20
25
 
21
26
  export interface Adapter {
@@ -33,6 +38,19 @@ export function getAdapter(source: MigrateSource): Adapter {
33
38
  return ADAPTERS[source];
34
39
  }
35
40
 
41
+ /** Collect one source instruction file without interpreting or rewriting its content. */
42
+ export async function collectInstructionFile(
43
+ filePath: string,
44
+ source: MigrateSource,
45
+ ): Promise<{ candidates: InstructionCandidate[]; diagnostics: SourceDiagnostic[] }> {
46
+ const read = await readSourceText(filePath, source, "instruction");
47
+ if ("diagnostic" in read) return { candidates: [], diagnostics: [read.diagnostic] };
48
+ return {
49
+ candidates: [{ source, name: path.basename(filePath), content: read.text }],
50
+ diagnostics: [],
51
+ };
52
+ }
53
+
36
54
  /** Read a text file, classifying absence/IO errors into source diagnostics. */
37
55
  export async function readSourceText(
38
56
  filePath: string,
@@ -18,7 +18,12 @@ const SOURCE = "opencode" as const;
18
18
  export const opencodeAdapter: Adapter = {
19
19
  source: SOURCE,
20
20
  async collect({ homeDir }: AdapterOptions): Promise<AdapterResult> {
21
- const result: AdapterResult = { mcpCandidates: [], skillCandidates: [], diagnostics: [] };
21
+ const result: AdapterResult = {
22
+ mcpCandidates: [],
23
+ skillCandidates: [],
24
+ instructionCandidates: [],
25
+ diagnostics: [],
26
+ };
22
27
  const baseDir = path.join(homeDir, ".config", "opencode");
23
28
 
24
29
  const configPath = path.join(baseDir, "opencode.json");