@cjhyy/code-shell-core 0.7.1 → 0.8.0

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 (594) hide show
  1. package/README.md +36 -23
  2. package/dist/agent/agent-definition-registry.d.ts +2 -2
  3. package/dist/agent/agent-definition-registry.js +47 -10
  4. package/dist/agent/agent-definition.d.ts +5 -0
  5. package/dist/agent/agent-definition.js +14 -0
  6. package/dist/automation/index.d.ts +7 -4
  7. package/dist/automation/index.js +4 -2
  8. package/dist/automation/runner.js +3 -1
  9. package/dist/automation/scheduler.d.ts +57 -1
  10. package/dist/automation/scheduler.js +123 -23
  11. package/dist/automation/store.d.ts +6 -2
  12. package/dist/automation/store.js +7 -3
  13. package/dist/capabilities/index.d.ts +109 -0
  14. package/dist/capabilities/index.js +80 -0
  15. package/dist/capability-control/disabled-lists.d.ts +2 -1
  16. package/dist/capability-control/disabled-lists.js +3 -5
  17. package/dist/capability-control/overlay.d.ts +14 -1
  18. package/dist/capability-control/overlay.js +40 -0
  19. package/dist/capability-control/service.js +6 -4
  20. package/dist/cli/agent-server-stdio.d.ts +1 -1
  21. package/dist/cli/agent-server-stdio.js +66 -6
  22. package/dist/cli/agent-server-tcp.js +7 -3
  23. package/dist/context/compaction.d.ts +39 -3
  24. package/dist/context/compaction.js +151 -39
  25. package/dist/context/manager.d.ts +17 -1
  26. package/dist/context/manager.js +36 -1
  27. package/dist/credentials/access.d.ts +3 -1
  28. package/dist/credentials/access.js +24 -3
  29. package/dist/credentials/index.d.ts +1 -1
  30. package/dist/credentials/index.js +1 -1
  31. package/dist/credentials/oauth.d.ts +4 -1
  32. package/dist/credentials/oauth.js +14 -0
  33. package/dist/credentials/store.d.ts +15 -1
  34. package/dist/credentials/store.js +17 -4
  35. package/dist/credentials/types.d.ts +24 -0
  36. package/dist/credentials/use-credential-tool.js +15 -1
  37. package/dist/engine/auxiliary-pipeline.d.ts +40 -0
  38. package/dist/engine/auxiliary-pipeline.js +181 -0
  39. package/dist/{settings → engine}/disk-defaults.d.ts +2 -2
  40. package/dist/{settings → engine}/disk-defaults.js +5 -2
  41. package/dist/engine/dynamic-tool-defs.d.ts +4 -0
  42. package/dist/engine/dynamic-tool-defs.js +4 -0
  43. package/dist/engine/engine.d.ts +254 -195
  44. package/dist/engine/engine.js +1812 -2041
  45. package/dist/engine/file-history-hook.d.ts +11 -0
  46. package/dist/engine/file-history-hook.js +31 -0
  47. package/dist/engine/goal-judge-context.d.ts +9 -0
  48. package/dist/engine/goal-judge-context.js +234 -0
  49. package/dist/engine/injected-context-cache.d.ts +6 -0
  50. package/dist/engine/injected-context-cache.js +13 -0
  51. package/dist/engine/input-attachments.d.ts +1 -1
  52. package/dist/engine/model-facade.d.ts +3 -3
  53. package/dist/engine/model-facade.js +15 -14
  54. package/dist/engine/permission-controller.d.ts +55 -0
  55. package/dist/engine/permission-controller.js +148 -0
  56. package/dist/engine/prompt-cache-diagnostics.d.ts +58 -0
  57. package/dist/engine/prompt-cache-diagnostics.js +178 -0
  58. package/dist/engine/run-accounting.d.ts +41 -0
  59. package/dist/engine/run-accounting.js +126 -0
  60. package/dist/engine/run-context.d.ts +44 -0
  61. package/dist/engine/run-context.js +88 -0
  62. package/dist/engine/run-environment.d.ts +30 -0
  63. package/dist/engine/run-environment.js +77 -0
  64. package/dist/engine/run-finalize.d.ts +58 -0
  65. package/dist/engine/run-finalize.js +245 -0
  66. package/dist/engine/run-goal.d.ts +58 -0
  67. package/dist/engine/run-goal.js +188 -0
  68. package/dist/engine/run-image-input.d.ts +1 -1
  69. package/dist/engine/run-image-input.js +5 -3
  70. package/dist/engine/run-session-open.d.ts +41 -0
  71. package/dist/engine/run-session-open.js +186 -0
  72. package/dist/engine/run-setup.d.ts +42 -0
  73. package/dist/engine/run-setup.js +58 -0
  74. package/dist/engine/run-tooling.d.ts +125 -0
  75. package/dist/engine/run-tooling.js +283 -0
  76. package/dist/engine/run-types.d.ts +139 -0
  77. package/dist/engine/run-types.js +12 -0
  78. package/dist/engine/run-workspace.d.ts +50 -0
  79. package/dist/engine/run-workspace.js +114 -0
  80. package/dist/engine/steer-queue.d.ts +1 -1
  81. package/dist/engine/subagent-spawner.d.ts +32 -0
  82. package/dist/engine/subagent-spawner.js +287 -0
  83. package/dist/engine/tool-summary.d.ts +2 -2
  84. package/dist/engine/tool-summary.js +2 -2
  85. package/dist/engine/turn-loop.d.ts +49 -10
  86. package/dist/engine/turn-loop.js +370 -104
  87. package/dist/engine/types.d.ts +30 -3
  88. package/dist/engine/types.js +1 -1
  89. package/dist/{engine/goal.d.ts → goal/lifecycle.d.ts} +76 -4
  90. package/dist/goal/lifecycle.js +482 -0
  91. package/dist/hooks/events.d.ts +24 -10
  92. package/dist/hooks/goal-stop-hook.d.ts +17 -28
  93. package/dist/hooks/goal-stop-hook.js +110 -465
  94. package/dist/hooks/registry.js +1 -1
  95. package/dist/index.d.ts +48 -108
  96. package/dist/index.extension.d.ts +51 -0
  97. package/dist/index.extension.js +39 -0
  98. package/dist/index.internal.d.ts +86 -0
  99. package/dist/index.internal.js +92 -0
  100. package/dist/index.js +34 -123
  101. package/dist/links/cli.d.ts +48 -0
  102. package/dist/links/cli.js +617 -0
  103. package/dist/links/http.d.ts +40 -0
  104. package/dist/links/http.js +166 -0
  105. package/dist/links/index.d.ts +4 -0
  106. package/dist/links/index.js +3 -0
  107. package/dist/links/link-action-tool.d.ts +5 -0
  108. package/dist/links/link-action-tool.js +241 -0
  109. package/dist/links/providers.d.ts +8 -0
  110. package/dist/links/providers.js +665 -0
  111. package/dist/links/types.d.ts +44 -0
  112. package/dist/llm/client-base.d.ts +7 -0
  113. package/dist/llm/client-base.js +60 -0
  114. package/dist/llm/model-pool.d.ts +1 -1
  115. package/dist/llm/model-pool.js +1 -1
  116. package/dist/llm/providers/anthropic.d.ts +1 -0
  117. package/dist/llm/providers/anthropic.js +9 -0
  118. package/dist/llm/providers/openai.d.ts +1 -0
  119. package/dist/llm/providers/openai.js +17 -0
  120. package/dist/model-catalog/index.js +15 -2
  121. package/dist/model-catalog/resolve.d.ts +13 -1
  122. package/dist/model-catalog/resolve.js +37 -2
  123. package/dist/model-catalog/types.d.ts +74 -48
  124. package/dist/model-catalog/types.js +16 -5
  125. package/dist/model-catalog/upsert.d.ts +3 -1
  126. package/dist/model-catalog/upsert.js +9 -0
  127. package/dist/onboarding.d.ts +0 -1
  128. package/dist/onboarding.js +1 -22
  129. package/dist/panel-apps/bindings.d.ts +24 -0
  130. package/dist/panel-apps/bindings.js +69 -0
  131. package/dist/panel-apps/github-archive.d.ts +21 -0
  132. package/dist/panel-apps/github-archive.js +98 -0
  133. package/dist/panel-apps/index.d.ts +4 -0
  134. package/dist/panel-apps/index.js +4 -0
  135. package/dist/panel-apps/installer.d.ts +68 -0
  136. package/dist/panel-apps/installer.js +622 -0
  137. package/dist/panel-apps/manifest.d.ts +364 -0
  138. package/dist/panel-apps/manifest.js +189 -0
  139. package/dist/panel-apps/paths.d.ts +13 -0
  140. package/dist/panel-apps/paths.js +38 -0
  141. package/dist/panel-apps/registry.d.ts +51 -0
  142. package/dist/panel-apps/registry.js +99 -0
  143. package/dist/panel-apps/runtime.d.ts +80 -0
  144. package/dist/panel-apps/runtime.js +154 -0
  145. package/dist/plugins/gitOps.js +8 -1
  146. package/dist/plugins/installedPlugins.d.ts +2 -1
  147. package/dist/plugins/installedPlugins.js +146 -8
  148. package/dist/plugins/installer/codex/convertAgents.d.ts +4 -1
  149. package/dist/plugins/installer/codex/convertAgents.js +62 -8
  150. package/dist/plugins/installer/codex/convertCommands.d.ts +5 -5
  151. package/dist/plugins/installer/codex/convertCommands.js +35 -12
  152. package/dist/plugins/installer/codex/convertHooks.d.ts +10 -0
  153. package/dist/plugins/installer/codex/convertHooks.js +82 -0
  154. package/dist/plugins/installer/codex/convertSkills.js +41 -6
  155. package/dist/plugins/installer/install.d.ts +7 -1
  156. package/dist/plugins/installer/install.js +21 -87
  157. package/dist/plugins/installer/installFromArchive.d.ts +26 -4
  158. package/dist/plugins/installer/installFromArchive.js +44 -27
  159. package/dist/plugins/installer/installFromNpm.d.ts +31 -0
  160. package/dist/plugins/installer/installFromNpm.js +273 -0
  161. package/dist/plugins/installer/loadPluginAgents.js +17 -4
  162. package/dist/plugins/installer/loadPluginMcp.d.ts +14 -0
  163. package/dist/plugins/installer/loadPluginMcp.js +245 -35
  164. package/dist/plugins/installer/normalizeManifest.d.ts +13 -0
  165. package/dist/plugins/installer/normalizeManifest.js +306 -0
  166. package/dist/plugins/installer/npmTar.d.ts +13 -0
  167. package/dist/plugins/installer/npmTar.js +321 -0
  168. package/dist/plugins/installer/parseSource.d.ts +11 -0
  169. package/dist/plugins/installer/parseSource.js +48 -0
  170. package/dist/plugins/installer/preview.d.ts +101 -0
  171. package/dist/plugins/installer/preview.js +336 -0
  172. package/dist/plugins/installer/projectPluginSource.d.ts +14 -0
  173. package/dist/plugins/installer/projectPluginSource.js +140 -0
  174. package/dist/plugins/installer/types.d.ts +775 -0
  175. package/dist/plugins/installer/types.js +100 -0
  176. package/dist/plugins/installer/unzip.d.ts +11 -0
  177. package/dist/plugins/installer/unzip.js +123 -9
  178. package/dist/plugins/installer/update.d.ts +2 -2
  179. package/dist/plugins/installer/update.js +43 -4
  180. package/dist/plugins/loadPluginHooks.d.ts +19 -2
  181. package/dist/plugins/loadPluginHooks.js +97 -86
  182. package/dist/plugins/pluginAutomationTemplates.d.ts +18 -0
  183. package/dist/plugins/pluginAutomationTemplates.js +50 -0
  184. package/dist/plugins/pluginCatalog.d.ts +45 -0
  185. package/dist/plugins/pluginCatalog.js +87 -0
  186. package/dist/plugins/pluginCommandHook.d.ts +6 -0
  187. package/dist/plugins/pluginCommandHook.js +25 -8
  188. package/dist/plugins/pluginCommandsLoader.d.ts +19 -0
  189. package/dist/plugins/pluginCommandsLoader.js +181 -7
  190. package/dist/plugins/pluginContent.d.ts +10 -1
  191. package/dist/plugins/pluginContent.js +87 -30
  192. package/dist/plugins/pluginHookApproval.d.ts +30 -0
  193. package/dist/plugins/pluginHookApproval.js +160 -0
  194. package/dist/plugins/pluginHookIntegrity.d.ts +69 -0
  195. package/dist/plugins/pluginHookIntegrity.js +361 -0
  196. package/dist/plugins/pluginInstaller.js +71 -12
  197. package/dist/plugins/pluginMcpApproval.d.ts +19 -0
  198. package/dist/plugins/pluginMcpApproval.js +110 -0
  199. package/dist/plugins/pluginMcpIntegrity.d.ts +21 -0
  200. package/dist/plugins/pluginMcpIntegrity.js +74 -0
  201. package/dist/plugins/types.d.ts +30 -0
  202. package/dist/plugins/varRewrite.d.ts +9 -5
  203. package/dist/plugins/varRewrite.js +26 -17
  204. package/dist/preset/index.d.ts +11 -8
  205. package/dist/preset/index.js +62 -203
  206. package/dist/product/define.js +9 -3
  207. package/dist/product/types.d.ts +0 -2
  208. package/dist/profile/activation.d.ts +36 -0
  209. package/dist/profile/activation.js +57 -0
  210. package/dist/profile/catalog-store.d.ts +77 -0
  211. package/dist/profile/catalog-store.js +346 -0
  212. package/dist/profile/catalog.d.ts +54 -0
  213. package/dist/profile/catalog.js +152 -0
  214. package/dist/profile/index.d.ts +7 -0
  215. package/dist/profile/index.js +7 -0
  216. package/dist/profile/requirements.d.ts +76 -0
  217. package/dist/profile/requirements.js +117 -0
  218. package/dist/profile/resolve.d.ts +11 -0
  219. package/dist/profile/resolve.js +41 -0
  220. package/dist/profile/store.d.ts +17 -0
  221. package/dist/profile/store.js +167 -0
  222. package/dist/profile/types.d.ts +321 -0
  223. package/dist/profile/types.js +104 -0
  224. package/dist/prompt/composer.d.ts +46 -7
  225. package/dist/prompt/composer.js +78 -48
  226. package/dist/prompt/instruction-scanner.d.ts +6 -5
  227. package/dist/prompt/instruction-scanner.js +8 -23
  228. package/dist/prompt/section-loader.d.ts +2 -2
  229. package/dist/prompt/section-loader.js +7 -4
  230. package/dist/prompt/sections/browser.md +10 -9
  231. package/dist/prompt/sections/harness-base.md +9 -0
  232. package/dist/protocol/chat-session-manager.d.ts +64 -1
  233. package/dist/protocol/chat-session-manager.js +104 -0
  234. package/dist/protocol/chat-session.d.ts +61 -10
  235. package/dist/protocol/chat-session.js +135 -25
  236. package/dist/protocol/client.d.ts +33 -3
  237. package/dist/protocol/client.js +96 -5
  238. package/dist/protocol/index.d.ts +2 -2
  239. package/dist/protocol/index.js +2 -2
  240. package/dist/protocol/mobile-remote-types.d.ts +406 -0
  241. package/dist/protocol/mobile-remote-types.js +1 -0
  242. package/dist/protocol/server.d.ts +127 -3
  243. package/dist/protocol/server.js +1309 -182
  244. package/dist/protocol/types.d.ts +152 -34
  245. package/dist/protocol/types.js +16 -0
  246. package/dist/run/ArtifactTracker.d.ts +6 -1
  247. package/dist/run/ArtifactTracker.js +29 -21
  248. package/dist/run/EngineRunner.d.ts +2 -0
  249. package/dist/run/EngineRunner.js +1 -0
  250. package/dist/run/RunManager.d.ts +26 -0
  251. package/dist/run/RunManager.js +82 -11
  252. package/dist/run/factory.d.ts +3 -0
  253. package/dist/run/factory.js +2 -0
  254. package/dist/runtime/safe-spawn.d.ts +6 -0
  255. package/dist/runtime/safe-spawn.js +8 -13
  256. package/dist/services/auto-dream.d.ts +13 -1
  257. package/dist/services/auto-dream.js +56 -8
  258. package/dist/services/dream-consolidation.js +10 -1
  259. package/dist/services/memory-orchestrator.js +6 -2
  260. package/dist/services/oauth.js +4 -1
  261. package/dist/services/session-memory.d.ts +4 -4
  262. package/dist/services/session-memory.js +13 -10
  263. package/dist/session/memory.d.ts +26 -7
  264. package/dist/session/memory.js +79 -21
  265. package/dist/session/session-manager.d.ts +182 -28
  266. package/dist/session/session-manager.js +910 -130
  267. package/dist/session/session-message.d.ts +22 -0
  268. package/dist/session/session-message.js +1 -0
  269. package/dist/session/transcript.d.ts +46 -5
  270. package/dist/session/transcript.js +159 -3
  271. package/dist/settings/feature-flags.d.ts +40 -0
  272. package/dist/settings/feature-flags.js +40 -0
  273. package/dist/settings/manager.d.ts +39 -1
  274. package/dist/settings/manager.js +102 -41
  275. package/dist/settings/migrate-config.js +4 -2
  276. package/dist/settings/schema.d.ts +511 -177
  277. package/dist/settings/schema.js +98 -25
  278. package/dist/skills/scanner.d.ts +6 -2
  279. package/dist/skills/scanner.js +160 -9
  280. package/dist/sources/adapter.d.ts +14 -0
  281. package/dist/sources/adapter.js +7 -0
  282. package/dist/sources/adapters/local-files.d.ts +10 -0
  283. package/dist/sources/adapters/local-files.js +127 -0
  284. package/dist/sources/adapters/mcp-resource.d.ts +17 -0
  285. package/dist/sources/adapters/mcp-resource.js +41 -0
  286. package/dist/sources/adapters/mock.d.ts +3 -0
  287. package/dist/sources/adapters/mock.js +29 -0
  288. package/dist/sources/binding.d.ts +6 -0
  289. package/dist/sources/binding.js +24 -0
  290. package/dist/sources/catalog.d.ts +6 -0
  291. package/dist/sources/catalog.js +64 -0
  292. package/dist/sources/context-summary.d.ts +8 -0
  293. package/dist/sources/context-summary.js +13 -0
  294. package/dist/sources/credential-status.d.ts +2 -0
  295. package/dist/sources/credential-status.js +13 -0
  296. package/dist/sources/index.d.ts +10 -0
  297. package/dist/sources/index.js +10 -0
  298. package/dist/sources/resolve.d.ts +28 -0
  299. package/dist/sources/resolve.js +47 -0
  300. package/dist/sources/truncate-utf8.d.ts +7 -0
  301. package/dist/sources/truncate-utf8.js +18 -0
  302. package/dist/sources/types.d.ts +71 -0
  303. package/dist/sources/types.js +26 -0
  304. package/dist/testing/fetch-stub.d.ts +32 -0
  305. package/dist/testing/fetch-stub.js +24 -0
  306. package/dist/themes/image.d.ts +18 -0
  307. package/dist/themes/image.js +117 -0
  308. package/dist/themes/index.d.ts +4 -0
  309. package/dist/themes/index.js +4 -0
  310. package/dist/themes/installer.d.ts +50 -0
  311. package/dist/themes/installer.js +290 -0
  312. package/dist/themes/manifest.d.ts +102 -0
  313. package/dist/themes/manifest.js +86 -0
  314. package/dist/themes/paths.d.ts +14 -0
  315. package/dist/themes/paths.js +33 -0
  316. package/dist/tool-system/browser-bridge.d.ts +53 -11
  317. package/dist/tool-system/browser-bridge.js +8 -9
  318. package/dist/tool-system/builtin/agent-heartbeat.d.ts +2 -2
  319. package/dist/tool-system/builtin/agent-heartbeat.js +20 -6
  320. package/dist/tool-system/builtin/agent-notifications.d.ts +127 -72
  321. package/dist/tool-system/builtin/agent-notifications.js +291 -101
  322. package/dist/tool-system/builtin/agent-output-file.js +1 -3
  323. package/dist/tool-system/builtin/agent-progress.d.ts +6 -0
  324. package/dist/tool-system/builtin/agent-progress.js +83 -0
  325. package/dist/tool-system/builtin/agent-registry.d.ts +38 -2
  326. package/dist/tool-system/builtin/agent-registry.js +178 -9
  327. package/dist/tool-system/builtin/agent-transcript-translator.js +1 -1
  328. package/dist/tool-system/builtin/agent.d.ts +2 -0
  329. package/dist/tool-system/builtin/agent.js +274 -33
  330. package/dist/tool-system/builtin/background-jobs.d.ts +55 -2
  331. package/dist/tool-system/builtin/background-jobs.js +96 -4
  332. package/dist/tool-system/builtin/background-work.d.ts +6 -0
  333. package/dist/tool-system/builtin/background-work.js +8 -1
  334. package/dist/tool-system/builtin/bash.js +5 -2
  335. package/dist/tool-system/builtin/browser-tools.d.ts +6 -3
  336. package/dist/tool-system/builtin/browser-tools.js +89 -23
  337. package/dist/tool-system/builtin/edit-model-catalog.d.ts +6 -0
  338. package/dist/tool-system/builtin/edit-model-catalog.js +172 -12
  339. package/dist/tool-system/builtin/edit.js +2 -6
  340. package/dist/tool-system/builtin/file-cache.d.ts +2 -0
  341. package/dist/tool-system/builtin/file-cache.js +4 -0
  342. package/dist/tool-system/builtin/generate-image.js +17 -10
  343. package/dist/tool-system/builtin/generate-video.js +26 -7
  344. package/dist/tool-system/builtin/grep.js +2 -2
  345. package/dist/tool-system/builtin/image-uploader.js +7 -1
  346. package/dist/tool-system/builtin/index.d.ts +32 -7
  347. package/dist/tool-system/builtin/index.js +237 -167
  348. package/dist/tool-system/builtin/memory.d.ts +6 -0
  349. package/dist/tool-system/builtin/memory.js +36 -15
  350. package/dist/tool-system/builtin/panel.d.ts +9 -0
  351. package/dist/tool-system/builtin/panel.js +314 -0
  352. package/dist/tool-system/builtin/read.js +5 -1
  353. package/dist/tool-system/builtin/send-message-to-session.d.ts +6 -0
  354. package/dist/tool-system/builtin/send-message-to-session.js +67 -0
  355. package/dist/tool-system/builtin/sources.d.ts +8 -0
  356. package/dist/tool-system/builtin/sources.js +137 -0
  357. package/dist/tool-system/builtin/tool-search.js +7 -2
  358. package/dist/tool-system/builtin/update-automation-memory.js +2 -0
  359. package/dist/tool-system/builtin/web-fetch.js +17 -13
  360. package/dist/tool-system/builtin/web-search.js +1 -3
  361. package/dist/tool-system/capability-module.d.ts +93 -0
  362. package/dist/tool-system/capability-module.js +53 -0
  363. package/dist/tool-system/context.d.ts +77 -19
  364. package/dist/tool-system/executor.js +75 -50
  365. package/dist/tool-system/external-tool-exposure.d.ts +60 -0
  366. package/dist/tool-system/external-tool-exposure.js +304 -0
  367. package/dist/tool-system/mcp-manager.d.ts +11 -1
  368. package/dist/tool-system/mcp-manager.js +19 -4
  369. package/dist/tool-system/mcp-tool-policy.d.ts +9 -0
  370. package/dist/tool-system/mcp-tool-policy.js +34 -0
  371. package/dist/tool-system/panel-bridge.d.ts +53 -0
  372. package/dist/tool-system/panel-bridge.js +1 -0
  373. package/dist/tool-system/permission.d.ts +26 -0
  374. package/dist/tool-system/permission.js +46 -0
  375. package/dist/tool-system/registry.d.ts +12 -1
  376. package/dist/tool-system/registry.js +31 -7
  377. package/dist/tool-system/sandbox/index.js +3 -8
  378. package/dist/tool-system/sandbox/seatbelt.js +2 -6
  379. package/dist/tool-system/session-tool-host.d.ts +139 -0
  380. package/dist/tool-system/session-tool-host.js +167 -0
  381. package/dist/tool-system/testing/tool-registry-harness.d.ts +31 -0
  382. package/dist/tool-system/testing/tool-registry-harness.js +51 -0
  383. package/dist/tool-system/validation.d.ts +14 -7
  384. package/dist/tool-system/validation.js +701 -7
  385. package/dist/types.d.ts +186 -20
  386. package/dist/{cc-orchestrator → utils}/cwd-normalize.d.ts +1 -0
  387. package/dist/{cc-orchestrator → utils}/cwd-normalize.js +1 -0
  388. package/dist/utils/file-mutex.d.ts +65 -0
  389. package/dist/utils/file-mutex.js +145 -0
  390. package/dist/utils/json.d.ts +2 -4
  391. package/dist/utils/json.js +2 -4
  392. package/dist/utils/lockfile.d.ts +30 -1
  393. package/dist/utils/lockfile.js +2 -2
  394. package/dist/utils/secret-scrubber.d.ts +8 -0
  395. package/dist/utils/secret-scrubber.js +227 -0
  396. package/dist/utils/toolDisplay.js +1 -1
  397. package/package.json +20 -5
  398. package/THIRD_PARTY_NOTICES.md +0 -206
  399. package/dist/arena/arena.d.ts +0 -45
  400. package/dist/arena/arena.js +0 -362
  401. package/dist/arena/context/context-tools.d.ts +0 -16
  402. package/dist/arena/context/context-tools.js +0 -272
  403. package/dist/arena/context/within-root.d.ts +0 -7
  404. package/dist/arena/context/within-root.js +0 -15
  405. package/dist/arena/detect-mode.d.ts +0 -20
  406. package/dist/arena/detect-mode.js +0 -78
  407. package/dist/arena/digest-builder.d.ts +0 -25
  408. package/dist/arena/digest-builder.js +0 -120
  409. package/dist/arena/index.d.ts +0 -29
  410. package/dist/arena/index.js +0 -29
  411. package/dist/arena/iterate/convergence.d.ts +0 -25
  412. package/dist/arena/iterate/convergence.js +0 -103
  413. package/dist/arena/iterate/formats/index.d.ts +0 -22
  414. package/dist/arena/iterate/formats/index.js +0 -283
  415. package/dist/arena/iterate/index.d.ts +0 -11
  416. package/dist/arena/iterate/index.js +0 -9
  417. package/dist/arena/iterate/iterative-arena.d.ts +0 -23
  418. package/dist/arena/iterate/iterative-arena.js +0 -237
  419. package/dist/arena/iterate/parse.d.ts +0 -42
  420. package/dist/arena/iterate/parse.js +0 -123
  421. package/dist/arena/iterate/phases/argue.d.ts +0 -22
  422. package/dist/arena/iterate/phases/argue.js +0 -165
  423. package/dist/arena/iterate/phases/revise.d.ts +0 -16
  424. package/dist/arena/iterate/phases/revise.js +0 -62
  425. package/dist/arena/iterate/phases/tournament.d.ts +0 -34
  426. package/dist/arena/iterate/phases/tournament.js +0 -113
  427. package/dist/arena/iterate/tools/web-tools.d.ts +0 -13
  428. package/dist/arena/iterate/tools/web-tools.js +0 -54
  429. package/dist/arena/iterate/types.d.ts +0 -152
  430. package/dist/arena/iterate/types.js +0 -8
  431. package/dist/arena/ledger.d.ts +0 -47
  432. package/dist/arena/ledger.js +0 -159
  433. package/dist/arena/lenses/architecture.d.ts +0 -5
  434. package/dist/arena/lenses/architecture.js +0 -22
  435. package/dist/arena/lenses/engineering.d.ts +0 -5
  436. package/dist/arena/lenses/engineering.js +0 -22
  437. package/dist/arena/lenses/general.d.ts +0 -5
  438. package/dist/arena/lenses/general.js +0 -20
  439. package/dist/arena/lenses/index.d.ts +0 -16
  440. package/dist/arena/lenses/index.js +0 -47
  441. package/dist/arena/lenses/product.d.ts +0 -5
  442. package/dist/arena/lenses/product.js +0 -22
  443. package/dist/arena/model-presets.d.ts +0 -23
  444. package/dist/arena/model-presets.js +0 -44
  445. package/dist/arena/phases/adjudication.d.ts +0 -25
  446. package/dist/arena/phases/adjudication.js +0 -142
  447. package/dist/arena/phases/build-consensus.d.ts +0 -30
  448. package/dist/arena/phases/build-consensus.js +0 -85
  449. package/dist/arena/phases/claim-registry.d.ts +0 -26
  450. package/dist/arena/phases/claim-registry.js +0 -60
  451. package/dist/arena/phases/cross-review.d.ts +0 -47
  452. package/dist/arena/phases/cross-review.js +0 -224
  453. package/dist/arena/phases/debate-rounds.d.ts +0 -28
  454. package/dist/arena/phases/debate-rounds.js +0 -161
  455. package/dist/arena/phases/participant-research.d.ts +0 -39
  456. package/dist/arena/phases/participant-research.js +0 -316
  457. package/dist/arena/phases/planning-detail-expansion.d.ts +0 -39
  458. package/dist/arena/phases/planning-detail-expansion.js +0 -120
  459. package/dist/arena/planner.d.ts +0 -28
  460. package/dist/arena/planner.js +0 -312
  461. package/dist/arena/providers/docs.d.ts +0 -7
  462. package/dist/arena/providers/docs.js +0 -111
  463. package/dist/arena/providers/git.d.ts +0 -8
  464. package/dist/arena/providers/git.js +0 -174
  465. package/dist/arena/providers/index.d.ts +0 -32
  466. package/dist/arena/providers/index.js +0 -132
  467. package/dist/arena/providers/none.d.ts +0 -7
  468. package/dist/arena/providers/none.js +0 -11
  469. package/dist/arena/providers/repo.d.ts +0 -7
  470. package/dist/arena/providers/repo.js +0 -258
  471. package/dist/arena/render/session.d.ts +0 -17
  472. package/dist/arena/render/session.js +0 -190
  473. package/dist/arena/render/terminal.d.ts +0 -34
  474. package/dist/arena/render/terminal.js +0 -286
  475. package/dist/arena/strategies/discussion.d.ts +0 -25
  476. package/dist/arena/strategies/discussion.js +0 -143
  477. package/dist/arena/strategies/index.d.ts +0 -15
  478. package/dist/arena/strategies/index.js +0 -28
  479. package/dist/arena/strategies/language-wrapper.d.ts +0 -17
  480. package/dist/arena/strategies/language-wrapper.js +0 -102
  481. package/dist/arena/strategies/lens-wrapper.d.ts +0 -16
  482. package/dist/arena/strategies/lens-wrapper.js +0 -236
  483. package/dist/arena/strategies/planning.d.ts +0 -30
  484. package/dist/arena/strategies/planning.js +0 -225
  485. package/dist/arena/strategies/review.d.ts +0 -26
  486. package/dist/arena/strategies/review.js +0 -168
  487. package/dist/arena/strategies/utils.d.ts +0 -36
  488. package/dist/arena/strategies/utils.js +0 -603
  489. package/dist/arena/tools/selector.d.ts +0 -17
  490. package/dist/arena/tools/selector.js +0 -61
  491. package/dist/arena/transitions.d.ts +0 -53
  492. package/dist/arena/transitions.js +0 -97
  493. package/dist/arena/types.d.ts +0 -518
  494. package/dist/arena/types.js +0 -27
  495. package/dist/cc-orchestrator/agent-adapter.d.ts +0 -54
  496. package/dist/cc-orchestrator/agent-adapter.js +0 -143
  497. package/dist/cc-orchestrator/cc-capability.d.ts +0 -19
  498. package/dist/cc-orchestrator/cc-capability.js +0 -53
  499. package/dist/cc-orchestrator/codex-session-discovery.d.ts +0 -24
  500. package/dist/cc-orchestrator/codex-session-discovery.js +0 -191
  501. package/dist/cc-orchestrator/codex-session-history.d.ts +0 -38
  502. package/dist/cc-orchestrator/codex-session-history.js +0 -247
  503. package/dist/cc-orchestrator/external-agent-bindings.d.ts +0 -27
  504. package/dist/cc-orchestrator/external-agent-bindings.js +0 -150
  505. package/dist/cc-orchestrator/external-agent-changes.d.ts +0 -19
  506. package/dist/cc-orchestrator/external-agent-changes.js +0 -231
  507. package/dist/cc-orchestrator/external-agent-driver.d.ts +0 -19
  508. package/dist/cc-orchestrator/external-agent-driver.js +0 -284
  509. package/dist/cc-orchestrator/external-agent-session-store.d.ts +0 -23
  510. package/dist/cc-orchestrator/external-agent-session-store.js +0 -146
  511. package/dist/cc-orchestrator/index.d.ts +0 -8
  512. package/dist/cc-orchestrator/index.js +0 -8
  513. package/dist/cc-orchestrator/relevance-judge.d.ts +0 -15
  514. package/dist/cc-orchestrator/relevance-judge.js +0 -29
  515. package/dist/cc-orchestrator/session-discovery.d.ts +0 -46
  516. package/dist/cc-orchestrator/session-discovery.js +0 -125
  517. package/dist/cc-orchestrator/session-history.d.ts +0 -54
  518. package/dist/cc-orchestrator/session-history.js +0 -150
  519. package/dist/cron/cron-runtime.d.ts +0 -2
  520. package/dist/cron/cron-runtime.js +0 -2
  521. package/dist/cron/cron-store.d.ts +0 -2
  522. package/dist/cron/cron-store.js +0 -2
  523. package/dist/cron/scheduler.d.ts +0 -7
  524. package/dist/cron/scheduler.js +0 -7
  525. package/dist/engine/goal.js +0 -206
  526. package/dist/external-agents/config.d.ts +0 -2
  527. package/dist/external-agents/config.js +0 -15
  528. package/dist/external-agents/types.d.ts +0 -31
  529. package/dist/git/parse-log.d.ts +0 -13
  530. package/dist/git/parse-log.js +0 -21
  531. package/dist/git/utils.d.ts +0 -49
  532. package/dist/git/utils.js +0 -161
  533. package/dist/git/worktree/crud.d.ts +0 -72
  534. package/dist/git/worktree/crud.js +0 -235
  535. package/dist/git/worktree/diff.d.ts +0 -14
  536. package/dist/git/worktree/diff.js +0 -82
  537. package/dist/git/worktree/git-exec.d.ts +0 -7
  538. package/dist/git/worktree/git-exec.js +0 -87
  539. package/dist/git/worktree/index.d.ts +0 -5
  540. package/dist/git/worktree/index.js +0 -5
  541. package/dist/git/worktree/query.d.ts +0 -43
  542. package/dist/git/worktree/query.js +0 -128
  543. package/dist/git/worktree/slug.d.ts +0 -11
  544. package/dist/git/worktree/slug.js +0 -58
  545. package/dist/git/worktree.d.ts +0 -1
  546. package/dist/git/worktree.js +0 -5
  547. package/dist/lsp/client.d.ts +0 -41
  548. package/dist/lsp/client.js +0 -186
  549. package/dist/lsp/manager.d.ts +0 -40
  550. package/dist/lsp/manager.js +0 -155
  551. package/dist/lsp/root-path.d.ts +0 -9
  552. package/dist/lsp/root-path.js +0 -12
  553. package/dist/lsp/servers.d.ts +0 -16
  554. package/dist/lsp/servers.js +0 -60
  555. package/dist/prompt/sections/coding.md +0 -35
  556. package/dist/quota/credentials.d.ts +0 -3
  557. package/dist/quota/credentials.js +0 -80
  558. package/dist/quota/index.d.ts +0 -36
  559. package/dist/quota/index.js +0 -155
  560. package/dist/quota/types.d.ts +0 -48
  561. package/dist/quota/types.js +0 -13
  562. package/dist/review/review-prompt.d.ts +0 -28
  563. package/dist/review/review-prompt.js +0 -81
  564. package/dist/state.d.ts +0 -160
  565. package/dist/state.js +0 -267
  566. package/dist/tool-system/builtin/apply-patch/applier.d.ts +0 -26
  567. package/dist/tool-system/builtin/apply-patch/applier.js +0 -308
  568. package/dist/tool-system/builtin/apply-patch/backup-targets.d.ts +0 -10
  569. package/dist/tool-system/builtin/apply-patch/backup-targets.js +0 -30
  570. package/dist/tool-system/builtin/apply-patch/index.d.ts +0 -20
  571. package/dist/tool-system/builtin/apply-patch/index.js +0 -105
  572. package/dist/tool-system/builtin/apply-patch/parser.d.ts +0 -17
  573. package/dist/tool-system/builtin/apply-patch/parser.js +0 -212
  574. package/dist/tool-system/builtin/apply-patch/seek-sequence.d.ts +0 -18
  575. package/dist/tool-system/builtin/apply-patch/seek-sequence.js +0 -123
  576. package/dist/tool-system/builtin/apply-patch/types.d.ts +0 -49
  577. package/dist/tool-system/builtin/apply-patch/types.js +0 -13
  578. package/dist/tool-system/builtin/arena.d.ts +0 -31
  579. package/dist/tool-system/builtin/arena.js +0 -416
  580. package/dist/tool-system/builtin/brief.d.ts +0 -6
  581. package/dist/tool-system/builtin/brief.js +0 -41
  582. package/dist/tool-system/builtin/check-quota.d.ts +0 -15
  583. package/dist/tool-system/builtin/check-quota.js +0 -34
  584. package/dist/tool-system/builtin/drive-claude-code.d.ts +0 -51
  585. package/dist/tool-system/builtin/drive-claude-code.js +0 -698
  586. package/dist/tool-system/builtin/lsp.d.ts +0 -7
  587. package/dist/tool-system/builtin/lsp.js +0 -144
  588. package/dist/tool-system/builtin/notebook-edit.d.ts +0 -7
  589. package/dist/tool-system/builtin/notebook-edit.js +0 -127
  590. package/dist/tool-system/builtin/worktree.d.ts +0 -11
  591. package/dist/tool-system/builtin/worktree.js +0 -363
  592. /package/dist/{external-agents → links}/types.js +0 -0
  593. /package/dist/{engine/session-usage.d.ts → session/usage.d.ts} +0 -0
  594. /package/dist/{engine/session-usage.js → session/usage.js} +0 -0
@@ -1,12 +0,0 @@
1
- import { fileURLToPath } from "node:url";
2
- /**
3
- * Convert a `file://` root URI to a platform filesystem path.
4
- *
5
- * The LSP manager used `rootUri.replace("file://", "")`, which only strips the
6
- * first occurrence and leaves percent-encoding intact, and on Windows turns
7
- * `file:///C:/x` into the invalid `/C:/x`. fileURLToPath does the proper
8
- * platform conversion (drive letters, percent-decoding, UNC).
9
- */
10
- export function rootUriToPath(rootUri) {
11
- return fileURLToPath(rootUri);
12
- }
@@ -1,16 +0,0 @@
1
- /**
2
- * Built-in language server configurations.
3
- */
4
- export interface LSPServerConfig {
5
- name: string;
6
- language: string;
7
- extensions: string[];
8
- command: string;
9
- args: string[];
10
- installHint: string;
11
- }
12
- export declare const BUILTIN_LSP_SERVERS: LSPServerConfig[];
13
- /**
14
- * Detect which LSP server to use based on file extension.
15
- */
16
- export declare function detectLSPServer(filePath: string): LSPServerConfig | undefined;
@@ -1,60 +0,0 @@
1
- /**
2
- * Built-in language server configurations.
3
- */
4
- export const BUILTIN_LSP_SERVERS = [
5
- {
6
- name: "typescript",
7
- language: "typescript",
8
- extensions: [".ts", ".tsx", ".js", ".jsx"],
9
- command: "typescript-language-server",
10
- args: ["--stdio"],
11
- installHint: "npm install -g typescript-language-server typescript",
12
- },
13
- {
14
- name: "python",
15
- language: "python",
16
- extensions: [".py"],
17
- command: "pylsp",
18
- args: [],
19
- installHint: "pip install python-lsp-server",
20
- },
21
- {
22
- name: "go",
23
- language: "go",
24
- extensions: [".go"],
25
- command: "gopls",
26
- args: ["serve"],
27
- installHint: "go install golang.org/x/tools/gopls@latest",
28
- },
29
- {
30
- name: "rust",
31
- language: "rust",
32
- extensions: [".rs"],
33
- command: "rust-analyzer",
34
- args: [],
35
- installHint: "rustup component add rust-analyzer",
36
- },
37
- {
38
- name: "json",
39
- language: "json",
40
- extensions: [".json"],
41
- command: "vscode-json-languageserver",
42
- args: ["--stdio"],
43
- installHint: "npm install -g vscode-langservers-extracted",
44
- },
45
- {
46
- name: "css",
47
- language: "css",
48
- extensions: [".css", ".scss", ".less"],
49
- command: "vscode-css-languageserver",
50
- args: ["--stdio"],
51
- installHint: "npm install -g vscode-langservers-extracted",
52
- },
53
- ];
54
- /**
55
- * Detect which LSP server to use based on file extension.
56
- */
57
- export function detectLSPServer(filePath) {
58
- const ext = filePath.slice(filePath.lastIndexOf("."));
59
- return BUILTIN_LSP_SERVERS.find((s) => s.extensions.includes(ext));
60
- }
@@ -1,35 +0,0 @@
1
- # Coding assistant
2
-
3
- The default job in this preset is software engineering in the current working directory.
4
-
5
- ## Reading before writing
6
- - Do not propose changes to code you haven't read. If a user asks about or wants you to modify a file, read it first. Understand existing code before suggesting modifications.
7
- - Read code before editing it, prefer modifying existing files, and avoid unrelated refactors.
8
-
9
- ## Investigation has a budget — looking is not acting
10
- - Read, search, and investigate freely, but treat read-only exploration as a means to action, not an end in itself. After about 3 read-only tool calls (Read/Grep/Glob) on the same question, you should either (a) make a change, (b) run a command with side effects (Bash, debug log, repro), or (c) ask the user a specific question. Continuing to read more files usually means your current strategy isn't working — change strategy instead.
11
- - Never re-read a file (or the same line range of a file) you've already read in this conversation. The content is already in your context. If you've re-derived the same conclusion twice from the same code, the answer isn't in static reading — switch to runtime verification.
12
- - For bug reports where static analysis hasn't pinpointed the cause in 2-3 reads, the right next step is almost always to add a debug log line and ask the user to reproduce, or to inspect runtime state — not to read more files.
13
- - Don't narrate the same code path twice in your reasoning. If you've already traced "input X → parser Y → handler Z" once and concluded "this looks correct", stop. Do not re-trace it from a different angle hoping for a different answer. Trust your first analysis and move to verification.
14
- - These rules are enforced at runtime by an investigation guard. A second read of the same target prepends a `<system-reminder>` to that tool's result; a third read of the same target is hard-blocked with an error. Four or more consecutive read-only calls without a side-effecting action also surface a reminder, and several consecutive turns of read-only work with no text update to the user surface another. When you see one of these reminders, treat it as a signal that your current strategy isn't producing new information — switch to a side-effecting verification (Bash, debug log, repro, edit) or ask the user a specific question rather than reading more.
15
-
16
- ## Code quality discipline
17
- - Don't add features, refactor code, or make "improvements" beyond what was asked. A bug fix doesn't need surrounding code cleaned up. A simple feature doesn't need extra configurability. Don't add docstrings, comments, or type annotations to code you didn't change. Only add comments where the logic isn't self-evident.
18
- - Don't add error handling, fallbacks, or validation for scenarios that can't happen. Trust internal code and framework guarantees. Only validate at system boundaries (user input, external APIs). Don't use feature flags or backwards-compatibility shims when you can just change the code.
19
- - Don't create helpers, utilities, or abstractions for one-time operations. Don't design for hypothetical future requirements. The right amount of complexity is what the task actually requires — no speculative abstractions, but no half-finished implementations either. Three similar lines of code is better than a premature abstraction.
20
- - Avoid backwards-compatibility hacks like renaming unused _vars, re-exporting types, adding // removed comments for removed code, etc. If you are certain that something is unused, you can delete it completely.
21
-
22
- ## Security
23
- - Be careful not to introduce security vulnerabilities such as command injection, XSS, SQL injection, and other OWASP top 10 vulnerabilities. If you notice that you wrote insecure code, immediately fix it. Prioritize writing safe, secure, and correct code.
24
-
25
- ## Git
26
- - When referencing specific functions or pieces of code include the pattern file_path:line_number to allow the user to easily navigate to the source code location.
27
- - When referencing GitHub issues or pull requests, use the owner/repo#123 format so they render as clickable links.
28
-
29
- ## Opening URLs and local previews
30
- - To show the user a web page or a local dev-server preview, print the address in your reply as a bare URL or a markdown link (e.g. `http://localhost:5173` or [预览](http://localhost:5173)) — do NOT wrap it in backticks. The desktop app turns a link in your answer into a clickable link that opens inside its built-in browser panel; backtick-wrapped URLs render as plain code and are not clickable.
31
- - Do NOT run shell commands to open a URL (`open <url>` on macOS, `xdg-open` on Linux, `start <url>` on Windows). Those launch the user's external system browser and bypass the in-app browser panel. Start the dev server, then just tell the user the address as a link.
32
-
33
- ## Coding tools
34
- - Use git/worktree/LSP/notebook tools when they help, but treat them as optional helpers rather than core assumptions.
35
- - If the user asks for help or feedback, point them to /help and the project repository.
@@ -1,3 +0,0 @@
1
- import type { QuotaCredentials } from "./types.js";
2
- /** Resolve all tokens from their standard local locations. Never throws. */
3
- export declare function resolveQuotaCredentials(): Promise<QuotaCredentials>;
@@ -1,80 +0,0 @@
1
- /**
2
- * Default resolver for the tokens `quota/` needs.
3
- *
4
- * This is the ONE platform-specific file in the module — it reads a vendor's
5
- * Keychain entry / auth.json. A host that stores secrets differently (or a
6
- * future plugin) can bypass this and build QuotaCredentials itself; core logic
7
- * in index.ts only depends on the QuotaCredentials shape.
8
- *
9
- * All reads are best-effort: a missing token yields `undefined`, never a throw,
10
- * so a machine without Codex or without Keychain access degrades to "quota
11
- * unavailable for that provider" instead of failing the whole call.
12
- */
13
- import { execFile } from "node:child_process";
14
- import { readFile } from "node:fs/promises";
15
- import { homedir } from "node:os";
16
- import { join } from "node:path";
17
- function userHome() {
18
- return process.env.HOME || process.env.USERPROFILE || homedir();
19
- }
20
- /** Read the Codex OAuth token + account id from ~/.codex/auth.json. */
21
- async function readCodexCreds() {
22
- try {
23
- const raw = await readFile(join(userHome(), ".codex", "auth.json"), "utf8");
24
- const j = JSON.parse(raw);
25
- const tokens = (j.tokens ?? {});
26
- const token = typeof tokens.access_token === "string" ? tokens.access_token : undefined;
27
- const acct = typeof tokens.account_id === "string" ? tokens.account_id : undefined;
28
- return { codexAccessToken: token, codexAccountId: acct };
29
- }
30
- catch {
31
- return {};
32
- }
33
- }
34
- /**
35
- * Read the Claude Code OAuth access token.
36
- * macOS: Keychain generic-password "Claude Code-credentials".
37
- * Other platforms: fall back to a plaintext ~/.claude/.credentials.json if present.
38
- */
39
- async function readClaudeCreds() {
40
- // macOS Keychain first.
41
- if (process.platform === "darwin") {
42
- const raw = await runSecurity();
43
- const token = parseClaudeToken(raw);
44
- if (token)
45
- return { claudeAccessToken: token };
46
- }
47
- // Cross-platform fallback: some installs keep a plaintext credentials file.
48
- try {
49
- const raw = await readFile(join(userHome(), ".claude", ".credentials.json"), "utf8");
50
- const token = parseClaudeToken(raw);
51
- if (token)
52
- return { claudeAccessToken: token };
53
- }
54
- catch {
55
- /* not present */
56
- }
57
- return {};
58
- }
59
- function parseClaudeToken(raw) {
60
- if (!raw)
61
- return undefined;
62
- try {
63
- const j = JSON.parse(raw);
64
- const oauth = (j.claudeAiOauth ?? {});
65
- return typeof oauth.accessToken === "string" ? oauth.accessToken : undefined;
66
- }
67
- catch {
68
- return undefined;
69
- }
70
- }
71
- function runSecurity() {
72
- return new Promise((resolve) => {
73
- execFile("security", ["find-generic-password", "-s", "Claude Code-credentials", "-w"], { timeout: 4000 }, (err, stdout) => resolve(err ? null : stdout.toString().trim()));
74
- });
75
- }
76
- /** Resolve all tokens from their standard local locations. Never throws. */
77
- export async function resolveQuotaCredentials() {
78
- const [codex, claude] = await Promise.all([readCodexCreds(), readClaudeCreds()]);
79
- return { ...codex, ...claude };
80
- }
@@ -1,36 +0,0 @@
1
- /**
2
- * Query remaining quota for the external coding-agent CLIs.
3
- *
4
- * Both lookups are verified against the real backends (2026-07-01):
5
- * - Codex: GET https://chatgpt.com/backend-api/wham/usage → JSON
6
- * rate_limit.{primary_window,secondary_window}.{used_percent,reset_at}.
7
- * Zero cost (no message sent).
8
- * - Claude: POST /v1/messages (max_tokens:1) → response headers
9
- * anthropic-ratelimit-unified-{5h,7d}-{utilization,reset}.
10
- * Costs ~1 output token (Claude exposes quota only via response
11
- * headers — there is no standalone usage endpoint).
12
- *
13
- * The `fetch` and credentials are injected so this is unit-testable offline and
14
- * so the host owns secret resolution (see types.ts boundary note).
15
- */
16
- import type { ProviderQuota, QuotaCredentials, QuotaResult } from "./types.js";
17
- type FetchLike = typeof fetch;
18
- export interface CheckQuotaOptions {
19
- creds: QuotaCredentials;
20
- /** Restrict to specific providers; defaults to both. */
21
- providers?: ("claude" | "codex")[];
22
- /** Injected for tests; defaults to global fetch. */
23
- fetchImpl?: FetchLike;
24
- /** Caller's abort signal (user Stop); composed with an internal timeout. */
25
- signal?: AbortSignal;
26
- timeoutMs?: number;
27
- }
28
- /** Codex: GET the usage endpoint and map its JSON to ProviderQuota. */
29
- export declare function queryCodexQuota(creds: QuotaCredentials, fetchImpl: FetchLike, signal: AbortSignal): Promise<ProviderQuota>;
30
- /** Claude: POST a 1-token probe and read the unified rate-limit headers. */
31
- export declare function queryClaudeQuota(creds: QuotaCredentials, fetchImpl: FetchLike, signal: AbortSignal): Promise<ProviderQuota>;
32
- /** Query both providers (or the subset requested), concurrently. */
33
- export declare function checkQuota(opts: CheckQuotaOptions): Promise<QuotaResult>;
34
- /** Render a QuotaResult as a compact human/agent-readable summary. */
35
- export declare function formatQuota(result: QuotaResult, nowSec: number): string;
36
- export {};
@@ -1,155 +0,0 @@
1
- const CODEX_USAGE_URL = "https://chatgpt.com/backend-api/wham/usage";
2
- const CLAUDE_MESSAGES_URL = "https://api.anthropic.com/v1/messages";
3
- /** Cheapest always-available model for the 1-token probe. */
4
- const CLAUDE_PROBE_MODEL = "claude-haiku-4-5-20251001";
5
- const DEFAULT_TIMEOUT_MS = 8000;
6
- /** Compose the caller signal with a timeout so a hung backend can't block. */
7
- function withTimeout(signal, timeoutMs) {
8
- const timeout = AbortSignal.timeout(timeoutMs);
9
- return signal ? AbortSignal.any([signal, timeout]) : timeout;
10
- }
11
- function num(v) {
12
- const n = typeof v === "string" ? parseFloat(v) : typeof v === "number" ? v : NaN;
13
- return Number.isFinite(n) ? n : null;
14
- }
15
- /** Codex: GET the usage endpoint and map its JSON to ProviderQuota. */
16
- export async function queryCodexQuota(creds, fetchImpl, signal) {
17
- if (!creds.codexAccessToken) {
18
- return { provider: "codex", error: "no Codex token (是否已 codex login?)" };
19
- }
20
- let resp;
21
- try {
22
- resp = await fetchImpl(CODEX_USAGE_URL, {
23
- method: "GET",
24
- headers: {
25
- authorization: `Bearer ${creds.codexAccessToken}`,
26
- ...(creds.codexAccountId ? { "chatgpt-account-id": creds.codexAccountId } : {}),
27
- originator: "codex_cli_rs",
28
- "user-agent": "codex_cli_rs",
29
- },
30
- signal,
31
- });
32
- }
33
- catch (err) {
34
- return { provider: "codex", error: `请求失败: ${err.message}` };
35
- }
36
- if (!resp.ok) {
37
- return { provider: "codex", error: `HTTP ${resp.status}${resp.status === 401 ? " (token 可能已过期)" : ""}` };
38
- }
39
- let body;
40
- try {
41
- body = (await resp.json());
42
- }
43
- catch {
44
- return { provider: "codex", error: "响应非 JSON" };
45
- }
46
- const rl = (body.rate_limit ?? {});
47
- const windows = [];
48
- const map = [
49
- ["primary_window", "5h"],
50
- ["secondary_window", "7d"],
51
- ];
52
- for (const [key, kind] of map) {
53
- const w = rl[key];
54
- if (!w)
55
- continue;
56
- const usedPercent = num(w.used_percent);
57
- if (usedPercent == null)
58
- continue;
59
- windows.push({ kind, usedPercent, resetsAt: num(w.reset_at) });
60
- }
61
- if (windows.length === 0)
62
- return { provider: "codex", error: "响应无 rate_limit 窗口" };
63
- return {
64
- provider: "codex",
65
- windows,
66
- planType: typeof body.plan_type === "string" ? body.plan_type : null,
67
- };
68
- }
69
- /** Claude: POST a 1-token probe and read the unified rate-limit headers. */
70
- export async function queryClaudeQuota(creds, fetchImpl, signal) {
71
- if (!creds.claudeAccessToken) {
72
- return { provider: "claude", error: "no Claude Code token (是否已登录 Claude Code?)" };
73
- }
74
- let resp;
75
- try {
76
- resp = await fetchImpl(CLAUDE_MESSAGES_URL, {
77
- method: "POST",
78
- headers: {
79
- authorization: `Bearer ${creds.claudeAccessToken}`,
80
- "anthropic-version": "2023-06-01",
81
- "anthropic-beta": "oauth-2025-04-20",
82
- "content-type": "application/json",
83
- },
84
- body: JSON.stringify({
85
- model: CLAUDE_PROBE_MODEL,
86
- max_tokens: 1,
87
- messages: [{ role: "user", content: "hi" }],
88
- }),
89
- signal,
90
- });
91
- }
92
- catch (err) {
93
- return { provider: "claude", error: `请求失败: ${err.message}` };
94
- }
95
- if (!resp.ok) {
96
- return { provider: "claude", error: `HTTP ${resp.status}${resp.status === 401 ? " (token 可能已过期)" : ""}` };
97
- }
98
- const h = resp.headers;
99
- const windows = [];
100
- const map = [
101
- ["anthropic-ratelimit-unified-5h-utilization", "anthropic-ratelimit-unified-5h-reset", "5h"],
102
- ["anthropic-ratelimit-unified-7d-utilization", "anthropic-ratelimit-unified-7d-reset", "7d"],
103
- ];
104
- for (const [utilKey, resetKey, kind] of map) {
105
- const util = num(h.get(utilKey)); // 0–1
106
- if (util == null)
107
- continue;
108
- windows.push({ kind, usedPercent: util * 100, resetsAt: num(h.get(resetKey)) });
109
- }
110
- if (windows.length === 0)
111
- return { provider: "claude", error: "响应头无 rate-limit 字段" };
112
- return { provider: "claude", windows };
113
- }
114
- /** Query both providers (or the subset requested), concurrently. */
115
- export async function checkQuota(opts) {
116
- const fetchImpl = opts.fetchImpl ?? fetch;
117
- const providers = opts.providers ?? ["claude", "codex"];
118
- const signal = withTimeout(opts.signal, opts.timeoutMs ?? DEFAULT_TIMEOUT_MS);
119
- const result = {};
120
- await Promise.all(providers.map(async (p) => {
121
- if (p === "codex")
122
- result.codex = await queryCodexQuota(opts.creds, fetchImpl, signal);
123
- else
124
- result.claude = await queryClaudeQuota(opts.creds, fetchImpl, signal);
125
- }));
126
- return result;
127
- }
128
- /** Render a QuotaResult as a compact human/agent-readable summary. */
129
- export function formatQuota(result, nowSec) {
130
- const lines = [];
131
- for (const pq of [result.claude, result.codex]) {
132
- if (!pq)
133
- continue;
134
- const name = pq.provider === "claude" ? "Claude Code" : "Codex";
135
- if (pq.error || !pq.windows) {
136
- lines.push(`${name}: 查询失败 — ${pq.error ?? "unknown"}`);
137
- continue;
138
- }
139
- const plan = pq.planType ? ` [${pq.planType}]` : "";
140
- const parts = pq.windows.map((w) => {
141
- const reset = w.resetsAt != null ? ` (重置 ${formatReset(w.resetsAt - nowSec)})` : "";
142
- return `${w.kind} 用了 ${w.usedPercent.toFixed(0)}%${reset}`;
143
- });
144
- lines.push(`${name}${plan}: ${parts.join(",")}`);
145
- }
146
- return lines.length ? lines.join("\n") : "(无可用额度信息)";
147
- }
148
- /** "2h13m" / "45m" / "已重置" from a seconds delta. */
149
- function formatReset(deltaSec) {
150
- if (deltaSec <= 0)
151
- return "已重置";
152
- const h = Math.floor(deltaSec / 3600);
153
- const m = Math.floor((deltaSec % 3600) / 60);
154
- return h > 0 ? `${h}h${m}m 后` : `${m}m 后`;
155
- }
@@ -1,48 +0,0 @@
1
- /**
2
- * Quota (rate-limit / usage) types for external coding-agent CLIs.
3
- *
4
- * DESIGN / BOUNDARY NOTE (see project_core_minimal_harness_business_layer):
5
- * "how to read Claude Code / Codex remaining quota" is provider-specific
6
- * BUSINESS policy, not core harness mechanism — it pokes a vendor's Keychain
7
- * entry, an undocumented usage endpoint, and private response headers. It lives
8
- * in this self-contained `quota/` module (one interface out: `checkQuota`) on
9
- * purpose, so it can be lifted wholesale into a plugin later without untangling
10
- * it from the rest of core. Nothing outside this module should know about
11
- * Keychain / wham endpoints / `anthropic-ratelimit-*` header names.
12
- */
13
- /** A single rolling limit window (e.g. the 5-hour or 7-day window). */
14
- export interface QuotaWindow {
15
- /** Which window this is. */
16
- kind: "5h" | "7d";
17
- /** Percent of the window's limit already used, 0–100. */
18
- usedPercent: number;
19
- /** Unix epoch seconds when this window resets, or null if unknown. */
20
- resetsAt: number | null;
21
- }
22
- /** Quota for one provider (claude | codex). */
23
- export interface ProviderQuota {
24
- provider: "claude" | "codex";
25
- /** Present when the lookup succeeded. */
26
- windows?: QuotaWindow[];
27
- /** Subscription tier, when the source exposes it (e.g. "team", "pro"). */
28
- planType?: string | null;
29
- /** Human-readable failure reason when the lookup did not succeed. */
30
- error?: string;
31
- }
32
- export interface QuotaResult {
33
- claude?: ProviderQuota;
34
- codex?: ProviderQuota;
35
- }
36
- /**
37
- * A credential the host supplies so this module can talk to a vendor backend.
38
- * Core never reads the Keychain / auth.json itself — the host (desktop main /
39
- * server) resolves the secret and hands it in. This is the seam that makes the
40
- * whole module portable to a plugin.
41
- */
42
- export interface QuotaCredentials {
43
- /** Claude Code OAuth access token (from Keychain "Claude Code-credentials"). */
44
- claudeAccessToken?: string;
45
- /** Codex OAuth access token + account id (from ~/.codex/auth.json). */
46
- codexAccessToken?: string;
47
- codexAccountId?: string;
48
- }
@@ -1,13 +0,0 @@
1
- /**
2
- * Quota (rate-limit / usage) types for external coding-agent CLIs.
3
- *
4
- * DESIGN / BOUNDARY NOTE (see project_core_minimal_harness_business_layer):
5
- * "how to read Claude Code / Codex remaining quota" is provider-specific
6
- * BUSINESS policy, not core harness mechanism — it pokes a vendor's Keychain
7
- * entry, an undocumented usage endpoint, and private response headers. It lives
8
- * in this self-contained `quota/` module (one interface out: `checkQuota`) on
9
- * purpose, so it can be lifted wholesale into a plugin later without untangling
10
- * it from the rest of core. Nothing outside this module should know about
11
- * Keychain / wham endpoints / `anthropic-ratelimit-*` header names.
12
- */
13
- export {};
@@ -1,28 +0,0 @@
1
- /**
2
- * Code-review prompt builder (TODO 7.3). Produces the instruction sent to the
3
- * model for `/review`. Pure + testable — the TUI/desktop command gathers the
4
- * diff or file contents and calls this; the model does the actual reasoning.
5
- *
6
- * Findings are structured: priority P0–P3, a confidence score, and a precise
7
- * location, so the output is consistent and (optionally) machine-readable for
8
- * CI/CD via `--json`.
9
- */
10
- export type ReviewDimension = "security" | "performance" | "readability" | "correctness";
11
- export declare const ALL_DIMENSIONS: ReviewDimension[];
12
- export interface ReviewPromptOptions {
13
- /** The unified diff (incremental) or full file contents to review. */
14
- content: string;
15
- /** Which dimensions to weigh. Defaults to all four. */
16
- dimensions?: ReviewDimension[];
17
- /** True when reviewing a diff (incremental); false when reviewing whole files. */
18
- incremental?: boolean;
19
- /** Emit a machine-readable JSON findings array (for CI/CD) instead of prose. */
20
- json?: boolean;
21
- /** Optional label for what's under review (e.g. a file path). */
22
- label?: string;
23
- /** Truncate content to this many chars (default 12000). */
24
- maxChars?: number;
25
- }
26
- /** Normalize a comma/space list of dimension names; invalid names dropped. */
27
- export declare function parseDimensions(input: string | undefined): ReviewDimension[];
28
- export declare function buildReviewPrompt(opts: ReviewPromptOptions): string;
@@ -1,81 +0,0 @@
1
- /**
2
- * Code-review prompt builder (TODO 7.3). Produces the instruction sent to the
3
- * model for `/review`. Pure + testable — the TUI/desktop command gathers the
4
- * diff or file contents and calls this; the model does the actual reasoning.
5
- *
6
- * Findings are structured: priority P0–P3, a confidence score, and a precise
7
- * location, so the output is consistent and (optionally) machine-readable for
8
- * CI/CD via `--json`.
9
- */
10
- export const ALL_DIMENSIONS = [
11
- "correctness",
12
- "security",
13
- "performance",
14
- "readability",
15
- ];
16
- const DIMENSION_LABEL = {
17
- security: "安全 (injection, authz, secret leakage, unsafe deserialization)",
18
- performance: "性能 (N+1, needless allocation, blocking I/O, complexity)",
19
- readability: "可读性 (naming, structure, dead code, comment accuracy)",
20
- correctness: "正确性 (logic bugs, edge cases, error handling, races)",
21
- };
22
- /** Normalize a comma/space list of dimension names; invalid names dropped. */
23
- export function parseDimensions(input) {
24
- if (!input)
25
- return ALL_DIMENSIONS;
26
- const wanted = input
27
- .split(/[\s,]+/)
28
- .map((s) => s.trim().toLowerCase())
29
- .filter(Boolean);
30
- const picked = ALL_DIMENSIONS.filter((d) => wanted.includes(d));
31
- return picked.length > 0 ? picked : ALL_DIMENSIONS;
32
- }
33
- const PRIORITY_GUIDE = "Priority: P0 = must fix before merge (data loss, security hole, crash); " +
34
- "P1 = should fix (likely bug, real risk); " +
35
- "P2 = nice to fix (smell, minor inefficiency); " +
36
- "P3 = optional (style, nit).";
37
- export function buildReviewPrompt(opts) {
38
- const dims = opts.dimensions?.length ? opts.dimensions : ALL_DIMENSIONS;
39
- const maxChars = opts.maxChars ?? 12_000;
40
- const body = opts.content.length > maxChars
41
- ? opts.content.slice(0, maxChars) + "\n…(truncated)…"
42
- : opts.content;
43
- const fence = opts.incremental === false ? "" : "diff";
44
- const what = opts.incremental === false ? "code" : "code changes (diff)";
45
- const subject = opts.label ? ` for \`${opts.label}\`` : "";
46
- const dimLines = dims.map((d) => ` - ${DIMENSION_LABEL[d]}`).join("\n");
47
- if (opts.json) {
48
- return [
49
- `Review the following ${what}${subject} across these dimensions:`,
50
- dimLines,
51
- ``,
52
- PRIORITY_GUIDE,
53
- ``,
54
- `Respond with ONLY a JSON object (no prose, no markdown fence) of the form:`,
55
- `{"summary": string, "findings": [{"priority": "P0"|"P1"|"P2"|"P3", ` +
56
- `"dimension": ${dims.map((d) => `"${d}"`).join("|")}, ` +
57
- `"confidence": number /*0..1*/, "location": string /*file:line*/, ` +
58
- `"title": string, "detail": string, "suggestion": string}]}`,
59
- `Order findings by priority then confidence. Omit a finding rather than guess.`,
60
- ``,
61
- "```" + fence,
62
- body,
63
- "```",
64
- ].join("\n");
65
- }
66
- return [
67
- `Review the following ${what}${subject} across these dimensions:`,
68
- dimLines,
69
- ``,
70
- PRIORITY_GUIDE,
71
- ``,
72
- `For each finding, give: **[P0-P3]** a short title, the location (file:line), ` +
73
- `your confidence (low/med/high), what's wrong, and a concrete fix.`,
74
- `Start with a one-line summary, then list findings ordered by priority. ` +
75
- `If nothing warrants a finding, say so plainly. Don't pad with nits to look thorough.`,
76
- ``,
77
- "```" + fence,
78
- body,
79
- "```",
80
- ].join("\n");
81
- }