minimal-agent 0.10.0 → 0.12.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 (573) hide show
  1. package/README.md +11 -3
  2. package/package.json +52 -5
  3. package/plugins/computer_use/.claude-plugin/plugin.json +6 -0
  4. package/plugins/computer_use/README.md +94 -0
  5. package/plugins/computer_use/app/_template.md +142 -0
  6. package/plugins/computer_use/app/chrome.md +165 -0
  7. package/plugins/computer_use/app/finder.md +76 -0
  8. package/plugins/computer_use/app/macos-system-settings.md +81 -0
  9. package/plugins/computer_use/app/microsoft-excel.md +80 -0
  10. package/plugins/computer_use/app/microsoft-powerpoint.md +80 -0
  11. package/plugins/computer_use/app/microsoft-word.md +79 -0
  12. package/plugins/computer_use/app/wechat.md +413 -0
  13. package/plugins/computer_use/app/weread.md +319 -0
  14. package/plugins/computer_use/commands/computeruse.md +25 -0
  15. package/plugins/computer_use/commands/cu.md +9 -0
  16. package/plugins/computer_use/plugin.js +26 -0
  17. package/plugins/computer_use/plugin.ts +30 -0
  18. package/plugins/computer_use/src/capture.js +90 -0
  19. package/plugins/computer_use/src/capture.ts +104 -0
  20. package/plugins/computer_use/src/commands.js +91 -0
  21. package/plugins/computer_use/src/commands.ts +103 -0
  22. package/plugins/computer_use/src/daemon.js +134 -0
  23. package/plugins/computer_use/src/daemon.ts +161 -0
  24. package/plugins/computer_use/src/manuals.js +135 -0
  25. package/plugins/computer_use/src/manuals.ts +159 -0
  26. package/plugins/computer_use/src/verify.js +168 -0
  27. package/plugins/computer_use/src/verify.ts +219 -0
  28. package/plugins/computer_use/test/commands.test.ts +73 -0
  29. package/plugins/cron-runner/plugin.ts +38 -0
  30. package/plugins/cron-runner/src/commands.ts +373 -0
  31. package/plugins/cron-runner/src/cronTime.ts +155 -0
  32. package/plugins/cron-runner/src/lock.ts +79 -0
  33. package/plugins/cron-runner/src/runs.ts +99 -0
  34. package/plugins/cron-runner/src/scheduleEngine.ts +76 -0
  35. package/plugins/cron-runner/src/scheduler.ts +376 -0
  36. package/plugins/cron-runner/src/schema.ts +139 -0
  37. package/plugins/cron-runner/src/service.ts +193 -0
  38. package/plugins/cron-runner/src/store.ts +333 -0
  39. package/plugins/cron-runner/src/types.ts +141 -0
  40. package/plugins/cron-runner/test/cronTime.test.ts +41 -0
  41. package/plugins/cron-runner/test/plugin-integration.test.ts +47 -0
  42. package/plugins/cron-runner/test/scheduleEngine.test.ts +41 -0
  43. package/plugins/cron-runner/test/service.test.ts +76 -0
  44. package/plugins/cron-runner/test/store-and-scheduler.test.ts +501 -0
  45. package/plugins/workflow-runner/plugin.js +56 -2
  46. package/plugins/workflow-runner/plugin.ts +113 -0
  47. package/plugins/workflow-runner/src/agentCommon.js +43 -4
  48. package/plugins/workflow-runner/src/agentCommon.ts +435 -0
  49. package/plugins/workflow-runner/src/controlFlow/branch.js +40 -0
  50. package/plugins/workflow-runner/src/controlFlow/branch.ts +46 -0
  51. package/plugins/workflow-runner/src/controlFlow/loop.js +211 -0
  52. package/plugins/workflow-runner/src/controlFlow/loop.ts +248 -0
  53. package/plugins/workflow-runner/src/controlFlow/pause.js +129 -0
  54. package/plugins/workflow-runner/src/controlFlow/pause.ts +141 -0
  55. package/plugins/workflow-runner/src/controlFlow/signal.js +21 -0
  56. package/plugins/workflow-runner/src/controlFlow/signal.ts +29 -0
  57. package/plugins/workflow-runner/src/controlFlow/types.js +18 -0
  58. package/plugins/workflow-runner/src/controlFlow/types.ts +63 -0
  59. package/plugins/workflow-runner/src/dslManifest.ts +127 -0
  60. package/plugins/workflow-runner/src/expressions.ts +622 -0
  61. package/plugins/workflow-runner/src/index.js +13 -4
  62. package/plugins/workflow-runner/src/index.ts +338 -0
  63. package/plugins/workflow-runner/src/jsonPayload.ts +84 -0
  64. package/plugins/workflow-runner/src/loader.js +23 -0
  65. package/plugins/workflow-runner/src/loader.ts +721 -0
  66. package/plugins/workflow-runner/src/multimodal.js +2 -1
  67. package/plugins/workflow-runner/src/multimodal.ts +64 -0
  68. package/plugins/workflow-runner/src/recovery.ts +149 -0
  69. package/plugins/workflow-runner/src/runner.js +75 -659
  70. package/plugins/workflow-runner/src/runner.ts +604 -0
  71. package/plugins/workflow-runner/src/stepExecutors/agent.ts +234 -0
  72. package/plugins/workflow-runner/src/stepExecutors/assert.ts +50 -0
  73. package/plugins/workflow-runner/src/stepExecutors/echo.js +31 -0
  74. package/plugins/workflow-runner/src/stepExecutors/echo.ts +38 -0
  75. package/plugins/workflow-runner/src/stepExecutors/llm.ts +133 -0
  76. package/plugins/workflow-runner/src/stepExecutors/set.js +49 -0
  77. package/plugins/workflow-runner/src/stepExecutors/set.ts +56 -0
  78. package/plugins/workflow-runner/src/stepExecutors/skill.js +5 -6
  79. package/plugins/workflow-runner/src/stepExecutors/skill.ts +140 -0
  80. package/plugins/workflow-runner/src/stepExecutors/tool.js +80 -8
  81. package/plugins/workflow-runner/src/stepExecutors/tool.ts +256 -0
  82. package/plugins/workflow-runner/src/stepExecutors/verify.ts +68 -0
  83. package/plugins/workflow-runner/src/stepPipeline.js +277 -0
  84. package/plugins/workflow-runner/src/stepPipeline.ts +366 -0
  85. package/plugins/workflow-runner/src/taskIdentity.ts +405 -0
  86. package/plugins/workflow-runner/src/toolRuntime.js +48 -0
  87. package/plugins/workflow-runner/src/toolRuntime.ts +64 -0
  88. package/plugins/workflow-runner/src/types.js +37 -1
  89. package/plugins/workflow-runner/src/types.ts +602 -0
  90. package/plugins/workflow-runner/src/workflowState.ts +733 -0
  91. package/plugins/workflow-runner/test/agent.test.ts +587 -0
  92. package/plugins/workflow-runner/test/agentLlmError.test.ts +373 -0
  93. package/plugins/workflow-runner/test/bashBlacklist.sweep.test.ts +65 -0
  94. package/plugins/workflow-runner/test/captureMisbind.test.ts +99 -0
  95. package/plugins/workflow-runner/test/cli.e2e.test.ts +147 -0
  96. package/plugins/workflow-runner/test/context-files.test.ts +320 -0
  97. package/plugins/workflow-runner/test/e2e.test.ts +370 -0
  98. package/plugins/workflow-runner/test/engineRobustness.test.ts +226 -0
  99. package/plugins/workflow-runner/test/expressions.test.ts +397 -0
  100. package/plugins/workflow-runner/test/foundation.test.ts +126 -0
  101. package/plugins/workflow-runner/test/graceful.test.ts +139 -0
  102. package/plugins/workflow-runner/test/greedyInputs.load.test.ts +47 -0
  103. package/plugins/workflow-runner/test/hostCapability.test.ts +108 -0
  104. package/plugins/workflow-runner/test/illustrate.load.test.ts +183 -0
  105. package/plugins/workflow-runner/test/jsonPayload.test.ts +83 -0
  106. package/plugins/workflow-runner/test/loader.test.ts +617 -0
  107. package/plugins/workflow-runner/test/maxTurnsRetryDelay.test.ts +33 -0
  108. package/plugins/workflow-runner/test/multimodal.test.ts +342 -0
  109. package/plugins/workflow-runner/test/output-schema.test.ts +213 -0
  110. package/plugins/workflow-runner/test/parseWorkflowArgs.test.ts +87 -0
  111. package/plugins/workflow-runner/test/pluginRunner.isolation.test.ts +269 -0
  112. package/plugins/workflow-runner/test/ppt.load.test.ts +1220 -0
  113. package/plugins/workflow-runner/test/ralphLoop.e2e.test.ts +220 -0
  114. package/plugins/workflow-runner/test/recovery.test.ts +265 -0
  115. package/plugins/workflow-runner/test/runner.test.ts +911 -0
  116. package/plugins/workflow-runner/test/runnerPreflight.test.ts +379 -0
  117. package/plugins/workflow-runner/test/skillTurnDone.test.ts +71 -0
  118. package/plugins/workflow-runner/test/stateLifecycle.test.ts +150 -0
  119. package/plugins/workflow-runner/test/stepPipeline.test.ts +114 -0
  120. package/plugins/workflow-runner/test/taskArbitration.test.ts +338 -0
  121. package/plugins/workflow-runner/test/taskIdentity.test.ts +237 -0
  122. package/plugins/workflow-runner/test/taskLifecycle.test.ts +270 -0
  123. package/plugins/workflow-runner/test/toolArtifactOverwrite.test.ts +221 -0
  124. package/plugins/workflow-runner/test/toolCapabilityBoundary.test.ts +29 -0
  125. package/plugins/workflow-runner/test/toolRuntimeIntegration.test.ts +168 -0
  126. package/plugins/workflow-runner/test/webppt.load.test.ts +250 -0
  127. package/plugins/workflow-runner/test/word.load.test.ts +208 -0
  128. package/plugins/workflow-runner/test/workflows.smoke.test.ts +76 -0
  129. package/plugins/workflow-runner/test/yamlGuardConditions.test.ts +207 -0
  130. package/skills/browser-automation/SKILL.md +9 -19
  131. package/skills/web-crawler/SKILL.md +9 -11
  132. package/src/askBridge.ts +249 -0
  133. package/src/bootstrap/cwdArg.js +10 -3
  134. package/src/bootstrap/cwdArg.ts +31 -0
  135. package/src/bootstrap/workingDir.ts +48 -0
  136. package/src/cli/args.js +70 -7
  137. package/src/cli/args.ts +146 -0
  138. package/src/cli/computerUse.js +185 -0
  139. package/src/cli/computerUse.ts +221 -0
  140. package/src/cli/configMenu.js +274 -202
  141. package/src/cli/configMenu.tsx +521 -0
  142. package/src/cli/memoryAccess.js +45 -0
  143. package/src/cli/memoryAccess.ts +53 -0
  144. package/src/cli/print.js +119 -5
  145. package/src/cli/print.ts +597 -0
  146. package/src/cli/quickModelSetup.js +60 -0
  147. package/src/cli/quickModelSetup.tsx +96 -0
  148. package/src/cli/streamJson.js +80 -4
  149. package/src/cli/streamJson.ts +433 -0
  150. package/src/cli/wizards/advisorWizard.js +1 -0
  151. package/src/cli/wizards/advisorWizard.tsx +195 -0
  152. package/src/cli/wizards/agentRuntimeWizard.js +84 -0
  153. package/src/cli/wizards/agentRuntimeWizard.tsx +134 -0
  154. package/src/cli/wizards/browserWizard.js +55 -0
  155. package/src/cli/wizards/browserWizard.tsx +77 -0
  156. package/src/cli/wizards/contextAdvisorWizard.js +84 -0
  157. package/src/cli/wizards/contextAdvisorWizard.tsx +124 -0
  158. package/src/cli/wizards/fieldForm.js +7 -4
  159. package/src/cli/wizards/fieldForm.tsx +250 -0
  160. package/src/cli/wizards/imageWizard.js +4 -5
  161. package/src/cli/wizards/imageWizard.tsx +96 -0
  162. package/src/cli/wizards/openRouterWizard.tsx +48 -0
  163. package/src/cli/wizards/providerPresets.js +1 -8
  164. package/src/cli/wizards/providerPresets.ts +106 -0
  165. package/src/cli/wizards/providerWizard.js +152 -205
  166. package/src/cli/wizards/providerWizard.tsx +266 -0
  167. package/src/cli/wizards/searchWizard.tsx +47 -0
  168. package/src/cli/wizards/ttsWizard.js +4 -3
  169. package/src/cli/wizards/ttsWizard.tsx +61 -0
  170. package/src/config/configDefaults.js +25 -0
  171. package/src/config/configDefaults.ts +33 -0
  172. package/src/config/configDiagnostics.js +117 -0
  173. package/src/config/configDiagnostics.ts +166 -0
  174. package/src/config/configFile.js +52 -32
  175. package/src/config/configFile.ts +633 -0
  176. package/src/config/configManagement.js +126 -0
  177. package/src/config/configManagement.ts +159 -0
  178. package/src/config/configService.js +66 -11
  179. package/src/config/configService.ts +554 -0
  180. package/src/config/numericLimits.js +61 -0
  181. package/src/config/numericLimits.ts +80 -0
  182. package/src/config.ts +109 -0
  183. package/src/context/agentHome.ts +11 -0
  184. package/src/context/archive.ts +144 -0
  185. package/src/context/budgetPlan.js +54 -0
  186. package/src/context/budgetPlan.ts +88 -0
  187. package/src/context/compact.js +179 -106
  188. package/src/context/compact.ts +584 -0
  189. package/src/context/contextBundle.js +119 -0
  190. package/src/context/contextBundle.ts +176 -0
  191. package/src/context/contextLock.ts +84 -0
  192. package/src/context/microCompactLite.ts +218 -0
  193. package/src/context/persistContext.ts +177 -0
  194. package/src/context/reactiveCompact.js +19 -4
  195. package/src/context/reactiveCompact.ts +240 -0
  196. package/src/context/recentDirs.ts +42 -0
  197. package/src/context/sessionPath.ts +206 -0
  198. package/src/context/sessionRegistry.js +8 -2
  199. package/src/context/sessionRegistry.ts +414 -0
  200. package/src/context/snipCompact.ts +163 -0
  201. package/src/context/tokenCounter.ts +106 -0
  202. package/src/context/workspaceIndex.js +2 -2
  203. package/src/context/workspaceIndex.ts +751 -0
  204. package/src/entry.compiled.tsx +20 -0
  205. package/src/harness/claimValidation.js +9 -0
  206. package/src/harness/claimValidation.ts +22 -0
  207. package/src/harness/evidenceLedger.js +92 -0
  208. package/src/harness/evidenceLedger.ts +96 -0
  209. package/src/harness/stallGuard.js +60 -0
  210. package/src/harness/stallGuard.ts +81 -0
  211. package/src/humanIntervention.js +129 -0
  212. package/src/humanIntervention.ts +216 -0
  213. package/src/infra/verification.ts +295 -0
  214. package/src/irreversible/rules.js +216 -0
  215. package/src/irreversible/rules.ts +261 -0
  216. package/src/llm/client.js +40 -3
  217. package/src/llm/client.ts +621 -0
  218. package/src/llm/promptCache.js +27 -0
  219. package/src/llm/promptCache.ts +41 -0
  220. package/src/llm/providers/anthropicFormat.js +41 -5
  221. package/src/llm/providers/anthropicFormat.ts +290 -0
  222. package/src/llm/providers/openaiFormat.js +186 -8
  223. package/src/llm/providers/openaiFormat.ts +428 -0
  224. package/src/loop.js +614 -63
  225. package/src/loop.ts +1454 -0
  226. package/src/main.js +67 -10
  227. package/src/main.tsx +344 -0
  228. package/src/memory/codec.js +204 -0
  229. package/src/memory/codec.ts +249 -0
  230. package/src/memory/constants.js +34 -0
  231. package/src/memory/constants.ts +50 -0
  232. package/src/memory/episodicMemory.js +684 -0
  233. package/src/memory/episodicMemory.ts +815 -0
  234. package/src/memory/fileStore.js +148 -0
  235. package/src/memory/fileStore.ts +184 -0
  236. package/src/memory/memoryService.js +570 -0
  237. package/src/memory/memoryService.ts +859 -0
  238. package/src/memory/migration.js +128 -0
  239. package/src/memory/migration.ts +160 -0
  240. package/src/memory/repository.js +789 -0
  241. package/src/memory/repository.ts +893 -0
  242. package/src/memory/retrieval.js +108 -0
  243. package/src/memory/retrieval.ts +145 -0
  244. package/src/memory/searchIndex.js +107 -0
  245. package/src/memory/searchIndex.ts +153 -0
  246. package/src/memory/topicView.js +82 -0
  247. package/src/memory/topicView.ts +95 -0
  248. package/src/memory/turnJournal.js +95 -0
  249. package/src/memory/turnJournal.ts +120 -0
  250. package/src/memory/types.js +2 -0
  251. package/src/memory/types.ts +186 -0
  252. package/src/messageQueue.ts +123 -0
  253. package/src/multimodal.js +128 -46
  254. package/src/multimodal.ts +349 -0
  255. package/src/plugin-sdk.js +21 -1
  256. package/src/plugin-sdk.ts +134 -0
  257. package/src/plugins/builtinPluginIds.js +47 -0
  258. package/src/plugins/builtinPluginIds.ts +51 -0
  259. package/src/plugins/builtinRegistry.ts +43 -0
  260. package/src/plugins/commandRouter.js +40 -26
  261. package/src/plugins/commandRouter.ts +261 -0
  262. package/src/plugins/hookEngine.ts +341 -0
  263. package/src/plugins/pluginApi.ts +133 -0
  264. package/src/plugins/pluginLifecycle.ts +34 -0
  265. package/src/plugins/pluginLoader.ts +147 -0
  266. package/src/plugins/pluginManifest.js +127 -0
  267. package/src/plugins/pluginManifest.ts +152 -0
  268. package/src/plugins/pluginRunner.js +47 -2
  269. package/src/plugins/pluginRunner.ts +207 -0
  270. package/src/plugins/transcript.ts +208 -0
  271. package/src/prompts/lint.js +169 -0
  272. package/src/prompts/lint.ts +220 -0
  273. package/src/prompts/pluginList.js +32 -16
  274. package/src/prompts/pluginList.ts +86 -0
  275. package/src/prompts/policyRegistry.js +318 -0
  276. package/src/prompts/policyRegistry.ts +358 -0
  277. package/src/prompts/projectInstructions.js +24 -0
  278. package/src/prompts/projectInstructions.ts +81 -0
  279. package/src/prompts/promptAssembly.js +311 -202
  280. package/src/prompts/promptAssembly.ts +510 -0
  281. package/src/prompts/skillList.js +106 -45
  282. package/src/prompts/skillList.ts +198 -0
  283. package/src/prompts/system.js +31 -6
  284. package/src/prompts/system.ts +81 -0
  285. package/src/runtime/agentRuntimeContext.js +53 -0
  286. package/src/runtime/agentRuntimeContext.ts +112 -0
  287. package/src/session/runAgentTurn.js +71 -12
  288. package/src/session/runAgentTurn.ts +181 -0
  289. package/src/session/runTurn.js +29 -0
  290. package/src/session/runTurn.ts +160 -0
  291. package/src/session/runtimeStore.js +149 -0
  292. package/src/session/runtimeStore.ts +197 -0
  293. package/src/session/sessionState.js +79 -3
  294. package/src/session/sessionState.ts +134 -0
  295. package/src/toolGate.ts +50 -0
  296. package/src/tools/advisor/advisor.js +76 -15
  297. package/src/tools/advisor/advisor.ts +512 -0
  298. package/src/tools/agent/agent.js +245 -29
  299. package/src/tools/agent/agent.ts +837 -0
  300. package/src/tools/agent/agentTaskService.js +60 -0
  301. package/src/tools/agent/agentTaskService.ts +113 -0
  302. package/src/tools/agent/agentTypes.js +20 -8
  303. package/src/tools/agent/agentTypes.ts +94 -0
  304. package/src/tools/agent/coordinator.ts +111 -0
  305. package/src/tools/agent/worktree.ts +296 -0
  306. package/src/tools/ask/ask.js +17 -0
  307. package/src/tools/ask/ask.ts +122 -0
  308. package/src/tools/bash/attachImage.js +223 -0
  309. package/src/tools/bash/attachImage.ts +281 -0
  310. package/src/tools/bash/bash.js +132 -14
  311. package/src/tools/bash/bash.ts +642 -0
  312. package/src/tools/bash/semantics.ts +103 -0
  313. package/src/tools/bash/warnings.js +17 -11
  314. package/src/tools/bash/warnings.ts +117 -0
  315. package/src/tools/capabilities.js +42 -0
  316. package/src/tools/capabilities.ts +69 -0
  317. package/src/tools/computeruse/accessibilityPermission.js +261 -0
  318. package/src/tools/computeruse/accessibilityPermission.ts +294 -0
  319. package/src/tools/computeruse/axSearch.js +96 -0
  320. package/src/tools/computeruse/axSearch.ts +120 -0
  321. package/src/tools/computeruse/axSnap.js +272 -0
  322. package/src/tools/computeruse/axSnap.ts +349 -0
  323. package/src/tools/computeruse/capabilityLabels.js +95 -0
  324. package/src/tools/computeruse/capabilityLabels.ts +115 -0
  325. package/src/tools/computeruse/computerUseService.js +2235 -0
  326. package/src/tools/computeruse/computerUseService.ts +2686 -0
  327. package/src/tools/computeruse/computeruse.js +2742 -0
  328. package/src/tools/computeruse/computeruse.ts +3265 -0
  329. package/src/tools/computeruse/diagnosticTrace.js +154 -0
  330. package/src/tools/computeruse/diagnosticTrace.ts +195 -0
  331. package/src/tools/computeruse/diagnostics.js +369 -0
  332. package/src/tools/computeruse/diagnostics.ts +453 -0
  333. package/src/tools/computeruse/grants.js +53 -0
  334. package/src/tools/computeruse/grants.ts +70 -0
  335. package/src/tools/computeruse/humanBoundary.js +159 -0
  336. package/src/tools/computeruse/humanBoundary.ts +199 -0
  337. package/src/tools/computeruse/intervention.js +77 -0
  338. package/src/tools/computeruse/intervention.ts +110 -0
  339. package/src/tools/computeruse/manualSchema.js +709 -0
  340. package/src/tools/computeruse/manualSchema.ts +916 -0
  341. package/src/tools/computeruse/observationImages.js +705 -0
  342. package/src/tools/computeruse/observationImages.ts +889 -0
  343. package/src/tools/computeruse/protocol.js +60 -0
  344. package/src/tools/computeruse/protocol.ts +515 -0
  345. package/src/tools/computeruse/telemetryLog.js +57 -0
  346. package/src/tools/computeruse/telemetryLog.ts +67 -0
  347. package/src/tools/computeruse/vision/appGuide.js +325 -0
  348. package/src/tools/computeruse/vision/appGuide.ts +482 -0
  349. package/src/tools/computeruse/vision/focus.js +291 -0
  350. package/src/tools/computeruse/vision/focus.ts +382 -0
  351. package/src/tools/computeruse/vision/frames.js +248 -0
  352. package/src/tools/computeruse/vision/frames.ts +329 -0
  353. package/src/tools/computeruse/vision/geometry.js +131 -0
  354. package/src/tools/computeruse/vision/geometry.ts +163 -0
  355. package/src/tools/computeruse/vision/imaging.js +201 -0
  356. package/src/tools/computeruse/vision/imaging.ts +281 -0
  357. package/src/tools/computeruse/vision/png.js +274 -0
  358. package/src/tools/computeruse/vision/png.ts +317 -0
  359. package/src/tools/computeruse/vision/raster.js +320 -0
  360. package/src/tools/computeruse/vision/raster.ts +408 -0
  361. package/src/tools/computeruse/vision/settle.js +131 -0
  362. package/src/tools/computeruse/vision/settle.ts +220 -0
  363. package/src/tools/computeruse/vision/telemetry.js +196 -0
  364. package/src/tools/computeruse/vision/telemetry.ts +241 -0
  365. package/src/tools/computeruse/visionOcr.js +115 -0
  366. package/src/tools/computeruse/visionOcr.ts +128 -0
  367. package/src/tools/computeruse/waitFor.js +237 -0
  368. package/src/tools/computeruse/waitFor.ts +291 -0
  369. package/src/tools/download/download.js +10 -6
  370. package/src/tools/download/download.ts +187 -0
  371. package/src/tools/edit/edit.js +30 -18
  372. package/src/tools/edit/edit.ts +349 -0
  373. package/src/tools/edit/multi-edit.js +25 -14
  374. package/src/tools/edit/multi-edit.ts +223 -0
  375. package/src/tools/effectiveToolSet.js +73 -0
  376. package/src/tools/effectiveToolSet.ts +91 -0
  377. package/src/tools/genimage/genimage.ts +257 -0
  378. package/src/tools/genspeech/genspeech.ts +83 -0
  379. package/src/tools/glob/glob.js +176 -29
  380. package/src/tools/glob/glob.ts +283 -0
  381. package/src/tools/grep/grep.js +61 -19
  382. package/src/tools/grep/grep.ts +239 -0
  383. package/src/tools/grep/rgPath.ts +206 -0
  384. package/src/tools/index.js +99 -5
  385. package/src/tools/index.ts +293 -0
  386. package/src/tools/lsp/config.js +113 -0
  387. package/src/tools/lsp/config.ts +113 -0
  388. package/src/tools/lsp/lsp.js +256 -0
  389. package/src/tools/lsp/lsp.ts +274 -0
  390. package/src/tools/lsp/service.js +303 -0
  391. package/src/tools/lsp/service.ts +296 -0
  392. package/src/tools/memory/memory.js +520 -0
  393. package/src/tools/memory/memory.ts +625 -0
  394. package/src/tools/memory/policy.js +53 -0
  395. package/src/tools/memory/policy.ts +72 -0
  396. package/src/tools/notebook/notebookEdit.js +114 -0
  397. package/src/tools/notebook/notebookEdit.ts +126 -0
  398. package/src/tools/powershell/powershell.js +210 -0
  399. package/src/tools/powershell/powershell.ts +239 -0
  400. package/src/tools/presentresult/presentresult.js +145 -0
  401. package/src/tools/presentresult/presentresult.ts +156 -0
  402. package/src/tools/read/read.js +371 -163
  403. package/src/tools/read/read.ts +558 -0
  404. package/src/tools/shared/diffSummary.js +44 -0
  405. package/src/tools/shared/diffSummary.ts +63 -0
  406. package/src/tools/shared/fileActivity.js +51 -0
  407. package/src/tools/shared/fileActivity.ts +66 -0
  408. package/src/tools/shared/fileMutationBus.js +13 -0
  409. package/src/tools/shared/fileMutationBus.ts +14 -0
  410. package/src/tools/shared/fileState.js +73 -65
  411. package/src/tools/shared/fileState.ts +145 -0
  412. package/src/tools/shared/fileUtils.js +81 -4
  413. package/src/tools/shared/fileUtils.ts +504 -0
  414. package/src/tools/shared/killTree.ts +50 -0
  415. package/src/tools/shared/permanentDeleteGuard.js +26 -0
  416. package/src/tools/shared/permanentDeleteGuard.ts +34 -0
  417. package/src/tools/shared/schemas.ts +20 -0
  418. package/src/tools/shared/toolOutputStore.js +97 -0
  419. package/src/tools/shared/toolOutputStore.ts +110 -0
  420. package/src/tools/skill/skill.js +86 -0
  421. package/src/tools/skill/skill.ts +94 -0
  422. package/src/tools/snip/snip.js +67 -0
  423. package/src/tools/snip/snip.ts +80 -0
  424. package/src/tools/tasks/backgroundTaskService.js +275 -0
  425. package/src/tools/tasks/backgroundTaskService.ts +369 -0
  426. package/src/tools/tasks/processEvidence.js +24 -0
  427. package/src/tools/tasks/processEvidence.ts +34 -0
  428. package/src/tools/tasks/taskManagement.js +163 -0
  429. package/src/tools/tasks/taskManagement.ts +180 -0
  430. package/src/tools/tasks/taskOutput.js +113 -0
  431. package/src/tools/tasks/taskOutput.ts +145 -0
  432. package/src/tools/tasks/taskStop.js +74 -0
  433. package/src/tools/tasks/taskStop.ts +99 -0
  434. package/src/tools/tasks/taskStore.js +46 -0
  435. package/src/tools/tasks/taskStore.ts +77 -0
  436. package/src/tools/terminal/terminalCapture.js +167 -0
  437. package/src/tools/terminal/terminalCapture.ts +179 -0
  438. package/src/tools/trash/trash.js +233 -0
  439. package/src/tools/trash/trash.ts +283 -0
  440. package/src/tools/types.js +1 -1
  441. package/src/tools/types.ts +24 -0
  442. package/src/tools/webbrowser/agentBrowserPath.ts +286 -0
  443. package/src/tools/webbrowser/browser.js +214 -11
  444. package/src/tools/webbrowser/browser.ts +293 -0
  445. package/src/tools/webbrowser/browserControl.js +153 -48
  446. package/src/tools/webbrowser/browserControl.ts +262 -0
  447. package/src/tools/webbrowser/browserDaemon.js +147 -39
  448. package/src/tools/webbrowser/browserDaemon.ts +270 -0
  449. package/src/tools/webbrowser/browserOutcome.js +273 -0
  450. package/src/tools/webbrowser/browserOutcome.ts +306 -0
  451. package/src/tools/webbrowser/browserRunRegistry.js +150 -0
  452. package/src/tools/webbrowser/browserRunRegistry.ts +179 -0
  453. package/src/tools/webbrowser/browserService.js +20 -6
  454. package/src/tools/webbrowser/browserService.ts +56 -0
  455. package/src/tools/webbrowser/browserStream.js +30 -1
  456. package/src/tools/webbrowser/browserStream.ts +216 -0
  457. package/src/tools/webbrowser/browserTabs.js +143 -0
  458. package/src/tools/webbrowser/browserTabs.ts +210 -0
  459. package/src/tools/webbrowser/webbrowser.js +831 -150
  460. package/src/tools/webbrowser/webbrowser.ts +1537 -0
  461. package/src/tools/webfetch/preapproved.ts +274 -0
  462. package/src/tools/webfetch/webfetch.js +24 -23
  463. package/src/tools/webfetch/webfetch.ts +383 -0
  464. package/src/tools/websearch/websearch.js +12 -11
  465. package/src/tools/websearch/websearch.ts +292 -0
  466. package/src/tools/worktree/sessionWorktree.js +128 -0
  467. package/src/tools/worktree/sessionWorktree.ts +158 -0
  468. package/src/tools/write/write.js +27 -44
  469. package/src/tools/write/write.ts +136 -0
  470. package/src/types.ts +960 -0
  471. package/src/ui/App.js +216 -12
  472. package/src/ui/App.tsx +879 -0
  473. package/src/ui/AskQuestion.tsx +300 -0
  474. package/src/ui/InputBox.js +77 -1
  475. package/src/ui/InputBox.tsx +567 -0
  476. package/src/ui/LiveArea.tsx +344 -0
  477. package/src/ui/MessageList.js +27 -6
  478. package/src/ui/MessageList.tsx +559 -0
  479. package/src/ui/ModelPicker.tsx +107 -0
  480. package/src/ui/QueuedMessagesBanner.tsx +51 -0
  481. package/src/ui/Root.js +6 -8
  482. package/src/ui/Root.tsx +100 -0
  483. package/src/ui/SessionPicker.tsx +169 -0
  484. package/src/ui/StatusLine.js +22 -1
  485. package/src/ui/StatusLine.tsx +145 -0
  486. package/src/ui/WorkspacePicker.tsx +84 -0
  487. package/src/ui/advisorCommand.js +54 -0
  488. package/src/ui/advisorCommand.ts +63 -0
  489. package/src/ui/computerCommand.js +19 -0
  490. package/src/ui/computerCommand.ts +35 -0
  491. package/src/ui/figures.ts +45 -0
  492. package/src/ui/hooks/askSlot.ts +112 -0
  493. package/src/ui/hooks/useChat.js +271 -7
  494. package/src/ui/hooks/useChat.ts +1578 -0
  495. package/src/ui/hooks/useInputHistory.ts +235 -0
  496. package/src/ui/hooks/usePasteHandler.ts +220 -0
  497. package/src/ui/hooks/useTerminalSize.ts +41 -0
  498. package/src/ui/hooks/useTextBuffer.ts +108 -0
  499. package/src/ui/hooks/useTokenUsage.ts +44 -0
  500. package/src/ui/liveViewport.ts +189 -0
  501. package/src/ui/markdown.ts +230 -0
  502. package/src/ui/textBuffer.ts +239 -0
  503. package/src/ui/theme.ts +35 -0
  504. package/src/utils/clipboardImage.js +358 -0
  505. package/src/utils/clipboardImage.ts +420 -0
  506. package/src/utils/debugLog.ts +50 -0
  507. package/src/utils/greenRoot.ts +35 -0
  508. package/src/utils/packageRoot.ts +40 -0
  509. package/src/utils/pathContains.js +28 -0
  510. package/src/utils/pathContains.ts +31 -0
  511. package/src/utils/resourcePaths.ts +71 -0
  512. package/src/utils/stripThink.ts +49 -0
  513. package/src/utils/zodToJson.ts +73 -0
  514. package/src/web/browserBridge.js +365 -66
  515. package/src/web/browserBridge.ts +672 -0
  516. package/src/web/protocol.ts +1804 -0
  517. package/vendor/computer-use/arm64-darwin/cu-helperd +0 -0
  518. package/workflows/ppt.yaml +13 -2
  519. package/workflows/wechat-reading-shots.yaml +315 -0
  520. package/workflows/word.yaml +11 -1
  521. package/skills/docx/scripts/office/helpers/__pycache__/__init__.cpython-314.pyc +0 -0
  522. package/skills/docx/scripts/office/helpers/__pycache__/merge_runs.cpython-314.pyc +0 -0
  523. package/skills/docx/scripts/office/helpers/__pycache__/simplify_redlines.cpython-314.pyc +0 -0
  524. package/skills/docx/scripts/office/validators/__pycache__/__init__.cpython-314.pyc +0 -0
  525. package/skills/docx/scripts/office/validators/__pycache__/base.cpython-314.pyc +0 -0
  526. package/skills/docx/scripts/office/validators/__pycache__/docx.cpython-314.pyc +0 -0
  527. package/skills/docx/scripts/office/validators/__pycache__/pptx.cpython-314.pyc +0 -0
  528. package/skills/docx/scripts/office/validators/__pycache__/redlining.cpython-314.pyc +0 -0
  529. package/skills/image-stats/scripts/__pycache__/image_stats.cpython-314.pyc +0 -0
  530. package/skills/image-stats/scripts/__pycache__/image_stats_test.cpython-314.pyc +0 -0
  531. package/skills/ui-design/scripts/__pycache__/assemble_material.cpython-314.pyc +0 -0
  532. package/skills/ui-design/scripts/__pycache__/assemble_material_test.cpython-314.pyc +0 -0
  533. package/skills/ui-design/scripts/__pycache__/chart_sanity_check.cpython-314.pyc +0 -0
  534. package/skills/ui-design/scripts/__pycache__/check_language_policy.cpython-314.pyc +0 -0
  535. package/skills/ui-design/scripts/__pycache__/check_ui_artifact.cpython-314.pyc +0 -0
  536. package/skills/ui-design/scripts/__pycache__/check_ui_artifact_pptx_test.cpython-314.pyc +0 -0
  537. package/skills/ui-design/scripts/__pycache__/deck_pages_check.cpython-314.pyc +0 -0
  538. package/skills/ui-design/scripts/__pycache__/deck_pages_check_test.cpython-314.pyc +0 -0
  539. package/skills/ui-design/scripts/__pycache__/deck_visual_style_check.cpython-314.pyc +0 -0
  540. package/skills/ui-design/scripts/__pycache__/deck_visual_style_check_test.cpython-314.pyc +0 -0
  541. package/skills/ui-design/scripts/__pycache__/design_budget_check.cpython-314.pyc +0 -0
  542. package/skills/ui-design/scripts/__pycache__/design_budget_check_test.cpython-314.pyc +0 -0
  543. package/skills/ui-design/scripts/__pycache__/design_repair_hints.cpython-314.pyc +0 -0
  544. package/skills/ui-design/scripts/__pycache__/design_repair_hints_test.cpython-314.pyc +0 -0
  545. package/skills/ui-design/scripts/__pycache__/design_style_check.cpython-314.pyc +0 -0
  546. package/skills/ui-design/scripts/__pycache__/design_style_check_test.cpython-314.pyc +0 -0
  547. package/skills/ui-design/scripts/__pycache__/draft_coverage_check.cpython-314.pyc +0 -0
  548. package/skills/ui-design/scripts/__pycache__/extract_source_assets.cpython-314.pyc +0 -0
  549. package/skills/ui-design/scripts/__pycache__/extract_source_assets_test.cpython-314.pyc +0 -0
  550. package/skills/ui-design/scripts/__pycache__/generated_image_review_collect.cpython-314.pyc +0 -0
  551. package/skills/ui-design/scripts/__pycache__/generated_image_review_collect_test.cpython-314.pyc +0 -0
  552. package/skills/ui-design/scripts/__pycache__/image_plan_lint.cpython-314.pyc +0 -0
  553. package/skills/ui-design/scripts/__pycache__/image_plan_lint_test.cpython-314.pyc +0 -0
  554. package/skills/ui-design/scripts/__pycache__/image_prompt_rewrite.cpython-314.pyc +0 -0
  555. package/skills/ui-design/scripts/__pycache__/image_prompt_rewrite_test.cpython-314.pyc +0 -0
  556. package/skills/ui-design/scripts/__pycache__/layout_balance.cpython-314.pyc +0 -0
  557. package/skills/ui-design/scripts/__pycache__/layout_balance_test.cpython-314.pyc +0 -0
  558. package/skills/ui-design/scripts/__pycache__/normalize_design_json.cpython-314.pyc +0 -0
  559. package/skills/ui-design/scripts/__pycache__/normalize_design_json_test.cpython-314.pyc +0 -0
  560. package/skills/ui-design/scripts/__pycache__/plan_source_layout.cpython-314.pyc +0 -0
  561. package/skills/ui-design/scripts/__pycache__/plan_source_layout_test.cpython-314.pyc +0 -0
  562. package/skills/ui-design/scripts/__pycache__/resolve_source_hint.cpython-314.pyc +0 -0
  563. package/skills/ui-design/scripts/__pycache__/resolve_source_hint_test.cpython-314.pyc +0 -0
  564. package/skills/ui-design/scripts/__pycache__/resolve_source_input.cpython-314.pyc +0 -0
  565. package/skills/ui-design/scripts/__pycache__/resolve_source_input_test.cpython-314.pyc +0 -0
  566. package/skills/ui-design/scripts/__pycache__/scaffold_ui_artifact.cpython-314.pyc +0 -0
  567. package/skills/ui-design/scripts/__pycache__/source_usage_check.cpython-314.pyc +0 -0
  568. package/skills/ui-design/scripts/__pycache__/source_usage_check_test.cpython-314.pyc +0 -0
  569. package/skills/ui-design/scripts/__pycache__/text_readability_pixel.cpython-314.pyc +0 -0
  570. package/skills/ui-design/scripts/__pycache__/visual_quality_gate.cpython-314.pyc +0 -0
  571. package/skills/ui-design/scripts/__pycache__/visual_quality_gate_test.cpython-314.pyc +0 -0
  572. /package/skills/ai-image/scripts/{generate_test.mjs → generate.selftest.mjs} +0 -0
  573. /package/skills/ai-image/scripts/{generate_from_plan_test.mjs → generate_from_plan.selftest.mjs} +0 -0
@@ -0,0 +1,83 @@
1
+ /**
2
+ * ============================================================
3
+ * test/jsonPayload.test.ts —— extractJsonPayload 纯函数验证
4
+ * ------------------------------------------------------------
5
+ * 根治 MiniMax-M2/M3 等思考型模型把 <think>…</think> 写进 content、
6
+ * 导致 output_schema 解析 "Unrecognized token '<'" 的回归测试。
7
+ * 纯函数、无 mock —— 直接断言提取结果可被 JSON.parse。
8
+ * ============================================================
9
+ */
10
+
11
+ import { describe, expect, it } from 'bun:test';
12
+
13
+ import { extractJsonPayload } from '../src/jsonPayload.js';
14
+
15
+ /** 提取后必须能 parse 成预期对象 */
16
+ function parsed(raw: string): unknown {
17
+ return JSON.parse(extractJsonPayload(raw));
18
+ }
19
+
20
+ describe('extractJsonPayload', () => {
21
+ it('干净 JSON 原样通过', () => {
22
+ expect(parsed('{"findings":["a","b"]}')).toEqual({ findings: ['a', 'b'] });
23
+ });
24
+
25
+ it('剥离 <think> 前缀(真实复现场景)', () => {
26
+ const raw =
27
+ '<think>\nThe user wants findings. Let me output JSON.\n</think>\n{"findings":["x"],"open_questions":[]}';
28
+ expect(parsed(raw)).toEqual({ findings: ['x'], open_questions: [] });
29
+ });
30
+
31
+ it('<think> 内部含 { } [ ] 也不会错锚(核心用例)', () => {
32
+ // 思维链里模型"想" JSON 结构、写了花括号;若不先剥 think 会锚到这里的 {
33
+ const raw =
34
+ '<think>I should return {"findings": [...]} with two items like { a }</think>{"findings":["real1","real2"]}';
35
+ expect(parsed(raw)).toEqual({ findings: ['real1', 'real2'] });
36
+ });
37
+
38
+ it('剥离 ```json 代码围栏(靠配平截取,无需专门去围栏)', () => {
39
+ const raw = '```json\n{"ok":true}\n```';
40
+ expect(parsed(raw)).toEqual({ ok: true });
41
+ });
42
+
43
+ it('think + 围栏 + 前后散文混合', () => {
44
+ const raw =
45
+ '<think>reasoning…</think>\nHere is the result:\n```json\n{"n":42}\n```\nDone.';
46
+ expect(parsed(raw)).toEqual({ n: 42 });
47
+ });
48
+
49
+ it('多个 <think> 块全部剥离', () => {
50
+ const raw = '<think>a</think>noise<think>b</think>{"v":1}';
51
+ expect(parsed(raw)).toEqual({ v: 1 });
52
+ });
53
+
54
+ it('未闭合 <think>(被 max tokens 截断)→ 砍掉尾巴、原文交调用方报错', () => {
55
+ const raw = 'prefix {"v":1} <think>incomplete reasoning without close';
56
+ // <think> 之前的 {"v":1} 应被正确提取(截断兜底先砍 <think> 起的尾巴)
57
+ expect(parsed(raw)).toEqual({ v: 1 });
58
+ });
59
+
60
+ it('数组负载(type:array 的 schema)', () => {
61
+ const raw = '<think>list</think>[{"id":1},{"id":2}]';
62
+ expect(parsed(raw)).toEqual([{ id: 1 }, { id: 2 }]);
63
+ });
64
+
65
+ it('JSON 后有尾随散文(只取配平那段)', () => {
66
+ const raw = '{"a":1}\n以上就是结果,希望有用。';
67
+ expect(parsed(raw)).toEqual({ a: 1 });
68
+ });
69
+
70
+ it('字符串值里的 } 不破坏配平', () => {
71
+ const raw = '{"msg":"a } b ] c","ok":true}';
72
+ expect(parsed(raw)).toEqual({ msg: 'a } b ] c', ok: true });
73
+ });
74
+
75
+ it('完全没有 JSON → 原样返回(让调用方 JSON.parse 报 honest error)', () => {
76
+ expect(extractJsonPayload('this is not json')).toBe('this is not json');
77
+ });
78
+
79
+ it('嵌套对象配平正确', () => {
80
+ const raw = '<think>x</think>{"outer":{"inner":[1,2,{"deep":true}]}}';
81
+ expect(parsed(raw)).toEqual({ outer: { inner: [1, 2, { deep: true }] } });
82
+ });
83
+ });
@@ -0,0 +1,617 @@
1
+ /**
2
+ * ============================================================
3
+ * test/workflows/loader.test.ts
4
+ * ------------------------------------------------------------
5
+ * loader 单测:
6
+ * - 双源扫描:cwd 优先、packageRoot fallback
7
+ * - 一个坏 yaml 不污染其它工作流
8
+ * - 校验阻断:name/description/steps/动作字段
9
+ * - 内置 book-review-short.yaml 能被解析
10
+ *
11
+ * ⚠️ 隔离性设计:
12
+ * listWorkflows() 内部依赖 getWorkingDir() → getResourceSearchPaths()。
13
+ * Bun 的 mock.module 是全局的,并行执行时其他测试文件对 workingDir.js
14
+ * 的 mock 会污染本文件的 getWorkingDir() 返回值,导致 listWorkflows()
15
+ * 扫描到错误的目录(或空目录)→ 4 个集成测试 flaky 失败。
16
+ *
17
+ * 解决方案:这 4 个测试改用 parseWorkflowFile() + 显式路径来验证等价逻辑,
18
+ * 零依赖 getWorkingDir() 全局状态。listWorkflows() 本身的"扫描+去重+容错"
19
+ * 行为由 parseWorkflowFile 的单测 + validate 单测联合保证。
20
+ * ============================================================
21
+ */
22
+
23
+ import { afterEach, beforeEach, describe, expect, it } from 'bun:test';
24
+ import { mkdirSync, mkdtempSync, readdir, rmSync, writeFileSync } from 'node:fs';
25
+ import { tmpdir } from 'node:os';
26
+ import { join } from 'node:path';
27
+
28
+ import {
29
+ WorkflowLoadError,
30
+ findWorkflowByName,
31
+ listWorkflows,
32
+ parseWorkflowFile,
33
+ } from '../src/loader.js';
34
+
35
+ describe('workflows/loader', () => {
36
+ let tmp: string;
37
+
38
+ beforeEach(() => {
39
+ tmp = mkdtempSync(join(tmpdir(), 'wf-loader-'));
40
+ });
41
+
42
+ afterEach(() => {
43
+ rmSync(tmp, { recursive: true, force: true });
44
+ });
45
+
46
+ function writeYaml(name: string, body: string): string {
47
+ mkdirSync(join(tmp, 'workflows'), { recursive: true });
48
+ const p = join(tmp, 'workflows', name);
49
+ writeFileSync(p, body, 'utf8');
50
+ return p;
51
+ }
52
+
53
+ // ── 原测试:cwd 下放 yaml 能被 listWorkflows 发现 ──
54
+ // 重构为:parseWorkflowFile 能正确解析 cwd 下写入的 yaml(等价语义)
55
+ it('cwd 下放 yaml 能被 parseWorkflowFile 正确解析', async () => {
56
+ const path = writeYaml(
57
+ 'my.yaml',
58
+ `name: my-wf
59
+ description: hello
60
+ steps:
61
+ - id: a
62
+ tool: Read
63
+ args: { file_path: a.txt }
64
+ `,
65
+ );
66
+
67
+ const def = await parseWorkflowFile(path);
68
+ expect(def.name).toBe('my-wf');
69
+ expect(def.description).toBe('hello');
70
+ expect(def.steps).toHaveLength(1);
71
+ expect(def.steps[0].id).toBe('a');
72
+ expect(def.__source).toBe(path);
73
+ });
74
+
75
+ // ── 原测试:packageRoot 自带 book-review-short 也能被发现 ──
76
+ // 重构为:直接定位 packageRoot 路径 + parseWorkflowFile 解析内置 workflow
77
+ it('packageRoot 自带 book-review-short.yaml 能被 parseWorkflowFile 正确解析', async () => {
78
+ // 直接定位 packageRoot 下的 workflows 目录(不依赖 getWorkingDir)
79
+ const packageRootWorkflows = join(
80
+ // 兼容 Windows:import.meta.dir 用反斜杠分隔,原 /\/test$/ 只匹配正斜杠 → 不生效,
81
+ // 路径算错一级(落到 plugins/workflows)。用 [/\\] 同时匹配两种分隔符。
82
+ import.meta.dir.replace(/[/\\]test$/, ''), // plugins/workflow-runner
83
+ '..', // plugins
84
+ '..', // kakadeai/minimal-agent 根
85
+ 'workflows',
86
+ );
87
+ const bookReviewPath = join(packageRootWorkflows, 'book-review-short.yaml');
88
+
89
+ // 验证文件存在且可解析
90
+ const def = await parseWorkflowFile(bookReviewPath);
91
+ expect(def.name).toBe('book-review-short');
92
+ expect(def.steps.length).toBeGreaterThanOrEqual(1);
93
+ });
94
+
95
+ // ── 原测试:cwd 同名 workflow 覆盖 packageRoot ──
96
+ // 重构为:显式构造两个同名 yaml,parseWorkflowFile 各自解析到正确内容
97
+ it('同 name 的两个 yaml 文件各自独立解析(覆盖语义由 listWorkflows 去重保证)', async () => {
98
+ // "packageRoot 版本"
99
+ const packageRootYaml = writeYaml(
100
+ 'book-review-short.yaml',
101
+ `name: book-review-short
102
+ description: original from packageRoot
103
+ steps:
104
+ - id: original
105
+ type: assert
106
+ condition: 'true'
107
+ `,
108
+ );
109
+
110
+ // "cwd 覆盖版本"(写到不同目录模拟)
111
+ const overrideDir = mkdtempSync(join(tmpdir(), 'wf-override-'));
112
+ const overridePath = join(overrideDir, 'book-review-short.yaml');
113
+ writeFileSync(
114
+ overridePath,
115
+ `name: book-review-short
116
+ description: cwd override
117
+ steps:
118
+ - id: overridden
119
+ type: assert
120
+ condition: 'true'
121
+ `,
122
+ 'utf8',
123
+ );
124
+
125
+ // 两个文件都能被 parseWorkflowFile 正确解析,各自内容独立
126
+ const original = await parseWorkflowFile(packageRootYaml);
127
+ const override = await parseWorkflowFile(overridePath);
128
+
129
+ expect(original.name).toBe('book-review-short');
130
+ expect(original.description).toBe('original from packageRoot');
131
+ expect(original.steps[0].id).toBe('original');
132
+
133
+ expect(override.name).toBe('book-review-short');
134
+ expect(override.description).toBe('cwd override');
135
+ expect(override.steps[0].id).toBe('overridden');
136
+
137
+ // 清理临时目录
138
+ rmSync(overrideDir, { recursive: true, force: true });
139
+ });
140
+
141
+ // ── 原测试:坏 yaml 不污染其他 workflow ──
142
+ // 重构为:parseWorkflowFile 对坏 yaml 抛错、对好 yaml 正常(单文件粒度验证)
143
+ it('坏 yaml 被 parseWorkflowFile 拒绝;好 yaml 正常解析(互不影响)', async () => {
144
+ const goodPath = writeYaml('good.yaml', `name: good
145
+ description: ok
146
+ steps:
147
+ - id: x
148
+ type: assert
149
+ condition: 'true'
150
+ `);
151
+ const badPath = writeYaml('bad.yaml', 'name: bad\n bad-indent\n: garbage:::\n');
152
+
153
+ // 好的能解析
154
+ const goodDef = await parseWorkflowFile(goodPath);
155
+ expect(goodDef.name).toBe('good');
156
+ expect(goodDef.steps[0].id).toBe('x');
157
+
158
+ // 坏的抛错(不阻塞好的那个——因为 parseWorkflowFile 是 per-file 的)
159
+ await expect(parseWorkflowFile(badPath)).rejects.toThrow(WorkflowLoadError);
160
+ });
161
+
162
+ it('findWorkflowByName 未命中返回 null', async () => {
163
+ const def = await findWorkflowByName('nonexistent-wf-xyz', tmp);
164
+ expect(def).toBeNull();
165
+ });
166
+
167
+ it('findWorkflowByName 可按 yaml 文件名兜底匹配', async () => {
168
+ writeYaml(
169
+ 'filename-fallback-test.yaml',
170
+ `name: internal-webppt-name
171
+ description: filename fallback
172
+ steps:
173
+ - id: x
174
+ type: assert
175
+ condition: 'true'
176
+ `,
177
+ );
178
+
179
+ const def = await findWorkflowByName('filename-fallback-test', tmp);
180
+ expect(def?.name).toBe('internal-webppt-name');
181
+ const bySuffix = await findWorkflowByName('filename-fallback-test.yaml', tmp);
182
+ expect(bySuffix?.name).toBe('internal-webppt-name');
183
+ const byPath = await findWorkflowByName(
184
+ 'workflows/filename-fallback-test.yaml',
185
+ tmp,
186
+ );
187
+ expect(byPath?.name).toBe('internal-webppt-name');
188
+ });
189
+
190
+ it('listWorkflows 对完全缺失 workflows/ 不抛错', async () => {
191
+ // 没有 workflows 目录,只有 packageRoot fallback
192
+ const list = await listWorkflows(tmp);
193
+ expect(Array.isArray(list)).toBe(true);
194
+ });
195
+ });
196
+
197
+ describe('workflows/loader::validate', () => {
198
+ let tmp: string;
199
+
200
+ beforeEach(() => {
201
+ tmp = mkdtempSync(join(tmpdir(), 'wf-loader-v-'));
202
+ });
203
+
204
+ afterEach(() => {
205
+ rmSync(tmp, { recursive: true, force: true });
206
+ });
207
+
208
+ function writeRaw(body: string): string {
209
+ const p = join(tmp, 'wf.yaml');
210
+ writeFileSync(p, body, 'utf8');
211
+ return p;
212
+ }
213
+
214
+ function writeIsolatedRaw(body: string): string {
215
+ const dir = mkdtempSync(join(tmpdir(), 'wf-loader-mm-'));
216
+ const p = join(dir, 'wf.yaml');
217
+ writeFileSync(p, body, 'utf8');
218
+ return p;
219
+ }
220
+
221
+ it('缺 name → 抛 WorkflowLoadError', async () => {
222
+ const p = writeRaw('description: x\nsteps:\n - id: a\n type: assert\n condition: "true"\n');
223
+ await expect(parseWorkflowFile(p)).rejects.toThrow(WorkflowLoadError);
224
+ });
225
+
226
+ it('缺 description → 抛错', async () => {
227
+ const p = writeRaw('name: x\nsteps:\n - id: a\n type: assert\n condition: "true"\n');
228
+ await expect(parseWorkflowFile(p)).rejects.toThrow();
229
+ });
230
+
231
+ it('steps 空数组 → 抛错', async () => {
232
+ const p = writeRaw('name: x\ndescription: y\nsteps: []\n');
233
+ await expect(parseWorkflowFile(p)).rejects.toThrow();
234
+ });
235
+
236
+ it('step 没有任何动作字段 → 抛错', async () => {
237
+ const p = writeRaw('name: x\ndescription: y\nsteps:\n - id: a\n');
238
+ await expect(parseWorkflowFile(p)).rejects.toThrow();
239
+ });
240
+
241
+ it('step 同时设置 tool + llm → 抛错', async () => {
242
+ const p = writeIsolatedRaw(`name: x
243
+ description: y
244
+ steps:
245
+ - id: a
246
+ tool: Read
247
+ llm: "say hi"
248
+ `);
249
+ await expect(parseWorkflowFile(p)).rejects.toThrow();
250
+ });
251
+
252
+ it('assert step 缺 condition → 抛错', async () => {
253
+ const p = writeIsolatedRaw(`name: x
254
+ description: y
255
+ steps:
256
+ - id: a
257
+ type: assert
258
+ `);
259
+ await expect(parseWorkflowFile(p)).rejects.toThrow();
260
+ });
261
+
262
+ it('同级 steps id 重复 → 抛错', async () => {
263
+ const p = writeRaw(`name: x
264
+ description: y
265
+ steps:
266
+ - id: dup
267
+ type: assert
268
+ condition: 'true'
269
+ - id: dup
270
+ type: assert
271
+ condition: 'true'
272
+ `);
273
+ await expect(parseWorkflowFile(p)).rejects.toThrow();
274
+ });
275
+
276
+ it('合法 yaml 通过 + __source 字段被注入', async () => {
277
+ const p = writeRaw(`name: ok-wf
278
+ description: nice
279
+ steps:
280
+ - id: a
281
+ tool: Read
282
+ args: { file_path: x.txt }
283
+ `);
284
+ const def = await parseWorkflowFile(p);
285
+ expect(def.name).toBe('ok-wf');
286
+ expect(def.__source).toBe(p);
287
+ });
288
+
289
+ it('inputs[].type=enum 缺 values → 抛错', async () => {
290
+ const p = writeRaw(`name: x
291
+ description: y
292
+ inputs:
293
+ - name: foo
294
+ type: enum
295
+ steps:
296
+ - id: a
297
+ type: assert
298
+ condition: 'true'
299
+ `);
300
+ await expect(parseWorkflowFile(p)).rejects.toThrow();
301
+ });
302
+
303
+ // ---------------- ADR-05 新校验 ----------------
304
+
305
+ it('已移除的孤儿类型(approval_loop/parallel/vote)按未知 type 拒绝', async () => {
306
+ // R1 减法重构:三个零使用 step 类型已从引擎删除(见 CLAUDE.md「两次规则」)。
307
+ // 锁定行为:旧 yaml 若还写这些 type,loader 必须响亮报错而不是静默跑偏。
308
+ for (const t of ['approval_loop', 'parallel', 'vote']) {
309
+ const p = writeRaw(`name: x
310
+ description: y
311
+ steps:
312
+ - id: s1
313
+ type: ${t}
314
+ `);
315
+ await expect(parseWorkflowFile(p)).rejects.toThrow();
316
+ }
317
+ });
318
+
319
+ it('ADR-05: type=branch 带 output_schema → 抛错', async () => {
320
+ const p = writeRaw(`name: x
321
+ description: y
322
+ steps:
323
+ - id: b
324
+ type: branch
325
+ condition: 'true'
326
+ output_schema:
327
+ type: object
328
+ `);
329
+ await expect(parseWorkflowFile(p)).rejects.toThrow(/output_schema.*branch/);
330
+ });
331
+
332
+ it('P3: type=skill 带 output_schema → 抛错(仅 llm 节点支持,不静默丢弃)', async () => {
333
+ const p = writeRaw(`name: x
334
+ description: y
335
+ steps:
336
+ - id: s
337
+ skill: some-skill
338
+ output_schema:
339
+ type: object
340
+ `);
341
+ await expect(parseWorkflowFile(p)).rejects.toThrow(/output_schema.*skill/);
342
+ });
343
+
344
+ it('P3: type=skill 带 context_files → 抛错(仅 llm 节点支持,不静默丢弃)', async () => {
345
+ const p = writeRaw(`name: x
346
+ description: y
347
+ steps:
348
+ - id: s
349
+ skill: some-skill
350
+ context_files:
351
+ - path: foo.md
352
+ `);
353
+ await expect(parseWorkflowFile(p)).rejects.toThrow(/context_files.*skill/);
354
+ });
355
+
356
+ it('ADR-05: 老 yaml 不带任何新字段 → 仍校验通过', async () => {
357
+ const p = writeRaw(`name: legacy
358
+ description: 老 workflow
359
+ steps:
360
+ - id: a
361
+ tool: Read
362
+ args: { file_path: a.txt }
363
+ - id: b
364
+ type: assert
365
+ condition: 'true'
366
+ `);
367
+ const def = await parseWorkflowFile(p);
368
+ expect(def.name).toBe('legacy');
369
+ });
370
+
371
+ // ---------------- onError / recover_hint 校验 ----------------
372
+
373
+ it('onError: recover + recover_hint 合法 → 通过', async () => {
374
+ const p = writeRaw(`name: x
375
+ description: y
376
+ steps:
377
+ - id: a
378
+ tool: Read
379
+ args: { file_path: a.txt }
380
+ onError: recover
381
+ recover_hint: "端口被占就换 3001"
382
+ `);
383
+ const def = await parseWorkflowFile(p);
384
+ expect(def.steps[0].onError).toBe('recover');
385
+ expect(def.steps[0].recover_hint).toBe('端口被占就换 3001');
386
+ });
387
+
388
+ it('onError 非法值(typo)→ 抛错', async () => {
389
+ const p = writeRaw(`name: x
390
+ description: y
391
+ steps:
392
+ - id: a
393
+ tool: Read
394
+ args: { file_path: a.txt }
395
+ onError: continnue
396
+ `);
397
+ await expect(parseWorkflowFile(p)).rejects.toThrow(/onError/);
398
+ });
399
+
400
+ it('recover_hint 非字符串 → 抛错', async () => {
401
+ const p = writeRaw(`name: x
402
+ description: y
403
+ steps:
404
+ - id: a
405
+ tool: Read
406
+ args: { file_path: a.txt }
407
+ recover_hint: [1, 2]
408
+ `);
409
+ await expect(parseWorkflowFile(p)).rejects.toThrow(/recover_hint/);
410
+ });
411
+
412
+ it('pause free_text=approve 合法', async () => {
413
+ const p = writeRaw(`name: x
414
+ description: y
415
+ steps:
416
+ - id: gate
417
+ type: pause
418
+ prompt: 是否继续
419
+ free_text: approve
420
+ `);
421
+ const def = await parseWorkflowFile(p);
422
+ expect(def.steps[0].free_text).toBe('approve');
423
+ });
424
+
425
+ it('free_text 只能用于 pause 且必须是合法枚举', async () => {
426
+ const nonPause = writeRaw(`name: x
427
+ description: y
428
+ steps:
429
+ - id: a
430
+ type: assert
431
+ condition: 'true'
432
+ free_text: approve
433
+ `);
434
+ await expect(parseWorkflowFile(nonPause)).rejects.toThrow(/free_text/);
435
+
436
+ const badValue = writeRaw(`name: x
437
+ description: y
438
+ steps:
439
+ - id: gate
440
+ type: pause
441
+ prompt: 是否继续
442
+ free_text: continue
443
+ `);
444
+ await expect(parseWorkflowFile(badValue)).rejects.toThrow(/free_text/);
445
+ });
446
+
447
+ it('done_when 仅 agent 步可用:tool 步声明被拒', async () => {
448
+ const p = writeRaw(`name: x
449
+ description: y
450
+ steps:
451
+ - id: a
452
+ tool: Read
453
+ args: { file_path: a.txt }
454
+ done_when: "fileExists('./a.txt')"
455
+ `);
456
+ await expect(parseWorkflowFile(p)).rejects.toThrow(/done_when.*agent/);
457
+ });
458
+
459
+ it('done_when 必须是非空字符串', async () => {
460
+ const p = writeRaw(`name: x
461
+ description: y
462
+ steps:
463
+ - id: a
464
+ agent: 干活
465
+ done_when: ""
466
+ `);
467
+ await expect(parseWorkflowFile(p)).rejects.toThrow(/done_when/);
468
+ });
469
+
470
+ it('onError: continue / halt 旧值仍合法', async () => {
471
+ const p = writeRaw(`name: x
472
+ description: y
473
+ steps:
474
+ - id: a
475
+ type: assert
476
+ condition: 'false'
477
+ onError: continue
478
+ - id: b
479
+ type: assert
480
+ condition: 'true'
481
+ onError: halt
482
+ `);
483
+ const def = await parseWorkflowFile(p);
484
+ expect(def.steps[0].onError).toBe('continue');
485
+ expect(def.steps[1].onError).toBe('halt');
486
+ });
487
+
488
+ it('llm.images 字符串数组合法', async () => {
489
+ const p = writeRaw(`name: x
490
+ description: y
491
+ steps:
492
+ - id: inspect
493
+ llm: "请看图"
494
+ images:
495
+ - "./build/screenshot.png"
496
+ image_detail: high
497
+ image_max_long_side_pixel: 1600
498
+ `);
499
+ const def = await parseWorkflowFile(p);
500
+ expect(def.steps[0].images).toEqual(['./build/screenshot.png']);
501
+ expect(def.steps[0].image_detail).toBe('high');
502
+ expect(def.steps[0].image_max_long_side_pixel).toBe(1600);
503
+ });
504
+
505
+ it('agent.images 对象数组合法', async () => {
506
+ const p = writeRaw(`name: x
507
+ description: y
508
+ steps:
509
+ - id: inspect
510
+ agent: "看图并写报告"
511
+ images:
512
+ - source: "\${inputs.image}"
513
+ detail: low
514
+ max_long_side_pixel: 800
515
+ parse_inline_images: true
516
+ `);
517
+ const def = await parseWorkflowFile(p);
518
+ expect(def.steps[0].parse_inline_images).toBe(true);
519
+ expect(def.steps[0].images).toEqual([
520
+ { source: '${inputs.image}', detail: 'low', max_long_side_pixel: 800 },
521
+ ]);
522
+ });
523
+
524
+ it('history_mode 仅允许 llm / agent / skill 使用', async () => {
525
+ const ok = writeIsolatedRaw(`name: x
526
+ description: y
527
+ steps:
528
+ - id: a
529
+ llm: "独立看图"
530
+ history_mode: isolated
531
+ - id: b
532
+ agent: "独立导出"
533
+ history_mode: isolated
534
+ - id: c
535
+ skill: ui-design
536
+ history_mode: shared
537
+ `);
538
+ const def = await parseWorkflowFile(ok);
539
+ expect(def.steps[0].history_mode).toBe('isolated');
540
+ expect(def.steps[1].history_mode).toBe('isolated');
541
+ expect(def.steps[2].history_mode).toBe('shared');
542
+
543
+ const badValue = writeIsolatedRaw(`name: x
544
+ description: y
545
+ steps:
546
+ - id: a
547
+ llm: "x"
548
+ history_mode: clean
549
+ `);
550
+ await expect(parseWorkflowFile(badValue)).rejects.toThrow(/history_mode.*shared \/ isolated/);
551
+
552
+ const badTool = writeIsolatedRaw(`name: x
553
+ description: y
554
+ steps:
555
+ - id: a
556
+ tool: Bash
557
+ args: { command: "true" }
558
+ history_mode: isolated
559
+ `);
560
+ await expect(parseWorkflowFile(badTool)).rejects.toThrow(/history_mode.*llm \/ agent \/ skill/);
561
+
562
+ const badControl = writeIsolatedRaw(`name: x
563
+ description: y
564
+ steps:
565
+ - id: a
566
+ type: assert
567
+ condition: "true"
568
+ history_mode: isolated
569
+ `);
570
+ await expect(parseWorkflowFile(badControl)).rejects.toThrow(/history_mode.*llm \/ agent \/ skill/);
571
+ });
572
+
573
+ it('images 不能用于 skill 或控制流节点', async () => {
574
+ const skillPath = writeIsolatedRaw(`name: x
575
+ description: y
576
+ steps:
577
+ - id: s
578
+ skill: ui-design
579
+ images: ["./a.png"]
580
+ `);
581
+ await expect(parseWorkflowFile(skillPath)).rejects.toThrow(/images.*llm \/ agent/);
582
+
583
+ const controlPath = writeIsolatedRaw(`name: x
584
+ description: y
585
+ steps:
586
+ - id: a
587
+ type: assert
588
+ condition: "true"
589
+ images: ["./a.png"]
590
+ `);
591
+ await expect(parseWorkflowFile(controlPath)).rejects.toThrow(/images.*llm \/ agent/);
592
+ });
593
+
594
+ it('非法图片 detail 和 max_long_side_pixel 会被拒绝', async () => {
595
+ const badDetail = writeIsolatedRaw(`name: x
596
+ description: y
597
+ steps:
598
+ - id: a
599
+ llm: "看图"
600
+ images:
601
+ - source: "./a.png"
602
+ detail: ultra
603
+ `);
604
+ await expect(parseWorkflowFile(badDetail)).rejects.toThrow(/detail/);
605
+
606
+ const badMax = writeIsolatedRaw(`name: x
607
+ description: y
608
+ steps:
609
+ - id: a
610
+ agent: "看图"
611
+ images:
612
+ - source: "./a.png"
613
+ max_long_side_pixel: 0
614
+ `);
615
+ await expect(parseWorkflowFile(badMax)).rejects.toThrow(/max_long_side_pixel/);
616
+ });
617
+ });