@polderlabs/bizar 6.2.4 → 6.3.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 (332) hide show
  1. package/.claude/CLAUDE.md +15 -0
  2. package/.claude/agents/_shared/AGENT_BASELINE.md +168 -0
  3. package/.claude/agents/_shared/CLAUDE_TOOLS.md +412 -0
  4. package/.claude/agents/_shared/SKILLS.md +109 -0
  5. package/.claude/agents/agent-browser.md +80 -0
  6. package/.claude/agents/baldr.md +49 -0
  7. package/.claude/agents/forseti.md +51 -0
  8. package/.claude/agents/frigg.md +42 -0
  9. package/.claude/agents/heimdall.md +33 -0
  10. package/.claude/agents/hermod.md +53 -0
  11. package/.claude/agents/mimir.md +49 -0
  12. package/.claude/agents/odin.md +287 -0
  13. package/.claude/agents/quick.md +34 -0
  14. package/.claude/agents/semble-search.md +50 -0
  15. package/.claude/agents/thor.md +53 -0
  16. package/.claude/agents/tyr.md +56 -0
  17. package/.claude/agents/vidarr.md +54 -0
  18. package/.claude/agents/vor.md +53 -0
  19. package/.claude/commands/audit.md +25 -0
  20. package/.claude/commands/bizar.md +22 -0
  21. package/.claude/commands/explain.md +17 -0
  22. package/.claude/commands/init.md +29 -0
  23. package/.claude/commands/learn.md +44 -0
  24. package/.claude/commands/plan.md +35 -0
  25. package/.claude/commands/plow-through.md +50 -0
  26. package/.claude/commands/pr-review.md +49 -0
  27. package/.claude/commands/setup-provider.md +96 -0
  28. package/.claude/commands/tailscale-serve.md +100 -0
  29. package/.claude/commands/team.md +132 -0
  30. package/.claude/commands/test.md +62 -0
  31. package/.claude/commands/validate.md +68 -0
  32. package/.claude/commands/visual-plan.md +24 -0
  33. package/.claude/hooks/README.md +92 -0
  34. package/.claude/hooks/posttooluse-editwrite.mjs +91 -0
  35. package/.claude/hooks/pretooluse-bash.mjs +81 -0
  36. package/.claude/hooks/pretooluse-editwrite.mjs +139 -0
  37. package/.claude/hooks/sessionend-recall.mjs +74 -0
  38. package/.claude/hooks/sessionstart-prime.mjs +80 -0
  39. package/.claude/hooks/userpromptsubmit-tag.mjs +80 -0
  40. package/.claude/settings.json +116 -0
  41. package/.claude/skills/9router/SKILL.md +80 -0
  42. package/.claude/skills/9router-chat/SKILL.md +73 -0
  43. package/.claude/skills/9router-embeddings/SKILL.md +69 -0
  44. package/.claude/skills/9router-image/SKILL.md +86 -0
  45. package/.claude/skills/9router-stt/SKILL.md +79 -0
  46. package/.claude/skills/9router-tts/SKILL.md +80 -0
  47. package/.claude/skills/9router-web-fetch/SKILL.md +99 -0
  48. package/.claude/skills/9router-web-search/SKILL.md +91 -0
  49. package/.claude/skills/bizar/README.md +9 -0
  50. package/.claude/skills/bizar/SKILL.md +450 -0
  51. package/.claude/skills/cpp-coding-standards/README.md +28 -0
  52. package/.claude/skills/cpp-coding-standards/SKILL.md +634 -0
  53. package/.claude/skills/cpp-coding-standards/references/concurrency.md +320 -0
  54. package/.claude/skills/cpp-coding-standards/references/error-handling.md +229 -0
  55. package/.claude/skills/cpp-coding-standards/references/memory-safety.md +216 -0
  56. package/.claude/skills/cpp-coding-standards/references/modern-idioms.md +282 -0
  57. package/.claude/skills/cpp-coding-standards/references/review-checklist.md +96 -0
  58. package/.claude/skills/cpp-testing/README.md +28 -0
  59. package/.claude/skills/cpp-testing/SKILL.md +304 -0
  60. package/.claude/skills/cpp-testing/references/coverage.md +370 -0
  61. package/.claude/skills/cpp-testing/references/framework-compare.md +175 -0
  62. package/.claude/skills/cpp-testing/references/host-test-for-embedded.md +499 -0
  63. package/.claude/skills/cpp-testing/references/mocking.md +364 -0
  64. package/.claude/skills/cpp-testing/references/tdd-workflow.md +308 -0
  65. package/.claude/skills/cubesandbox/SKILL.md +148 -0
  66. package/.claude/skills/embedded-esp-idf/README.md +41 -0
  67. package/.claude/skills/embedded-esp-idf/SKILL.md +439 -0
  68. package/.claude/skills/embedded-esp-idf/references/freertos-patterns.md +214 -0
  69. package/.claude/skills/embedded-esp-idf/references/host-tests.md +164 -0
  70. package/.claude/skills/embedded-esp-idf/references/idf-py-commands.md +157 -0
  71. package/.claude/skills/embedded-esp-idf/references/kconfig.md +159 -0
  72. package/.claude/skills/embedded-esp-idf/references/logging-discipline.md +118 -0
  73. package/.claude/skills/embedded-esp-idf/references/memory-and-iram.md +137 -0
  74. package/.claude/skills/embedded-esp-idf/references/nvs.md +121 -0
  75. package/.claude/skills/embedded-esp-idf/references/packed-structs.md +192 -0
  76. package/.claude/skills/embedded-esp-idf/scripts/idf_env.sh +47 -0
  77. package/.claude/skills/embedded-esp-idf/scripts/size_check.sh +77 -0
  78. package/.claude/skills/glyph/SKILL.md +163 -0
  79. package/.claude/skills/harness-engineering/SKILL.md +143 -0
  80. package/.claude/skills/lightrag/SKILL.md +81 -0
  81. package/.claude/skills/memory-protocol/SKILL.md +105 -0
  82. package/.claude/skills/obsidian/SKILL.md +306 -0
  83. package/.claude/skills/read-the-damn-docs/SKILL.md +113 -0
  84. package/.claude/skills/self-improvement/SKILL.md +64 -0
  85. package/README.md +87 -59
  86. package/bizar-dash/dist/assets/{EnvVarsSection-DXM8gRm_.js → EnvVarsSection-B58aiJiE.js} +1 -1
  87. package/bizar-dash/dist/assets/{EnvVarsSection-DXM8gRm_.js.map → EnvVarsSection-B58aiJiE.js.map} +1 -1
  88. package/bizar-dash/dist/assets/{MobileChat-BnKN_Ks_.js → MobileChat-BJrqwVDd.js} +1 -1
  89. package/bizar-dash/dist/assets/{MobileChat-BnKN_Ks_.js.map → MobileChat-BJrqwVDd.js.map} +1 -1
  90. package/bizar-dash/dist/assets/{MobileSettings-DjCPxC-Q.js → MobileSettings-CEQNJNLJ.js} +1 -1
  91. package/bizar-dash/dist/assets/{MobileSettings-DjCPxC-Q.js.map → MobileSettings-CEQNJNLJ.js.map} +1 -1
  92. package/bizar-dash/dist/assets/{main-DYiZqMrn.js → main-IvfQAOfy.js} +1 -1
  93. package/bizar-dash/dist/assets/{main-DYiZqMrn.js.map → main-IvfQAOfy.js.map} +1 -1
  94. package/bizar-dash/dist/assets/{markdown-C6mXtQxD.js → markdown-tOLaD6nm.js} +1 -1
  95. package/bizar-dash/dist/assets/{markdown-C6mXtQxD.js.map → markdown-tOLaD6nm.js.map} +1 -1
  96. package/bizar-dash/dist/assets/{mobile-CMHqtLV2.js → mobile-DYCHcUpq.js} +1 -1
  97. package/bizar-dash/dist/assets/{mobile-CMHqtLV2.js.map → mobile-DYCHcUpq.js.map} +1 -1
  98. package/bizar-dash/dist/assets/{mobile-layout-3jIhHX_p.js → mobile-layout-CBHjpwsb.js} +2 -2
  99. package/bizar-dash/dist/assets/{mobile-layout-3jIhHX_p.js.map → mobile-layout-CBHjpwsb.js.map} +1 -1
  100. package/bizar-dash/dist/assets/{useSlashCommands-DtITw8Xv.js → useSlashCommands-Bd7_FA6U.js} +2 -2
  101. package/bizar-dash/dist/assets/{useSlashCommands-DtITw8Xv.js.map → useSlashCommands-Bd7_FA6U.js.map} +1 -1
  102. package/bizar-dash/dist/assets/{vendor-CeHGtduv.js → vendor-C843201K.js} +12 -12
  103. package/bizar-dash/dist/assets/vendor-C843201K.js.map +1 -0
  104. package/bizar-dash/dist/index.html +6 -6
  105. package/bizar-dash/dist/mobile.html +2 -2
  106. package/bizar-dash/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json +1 -1
  107. package/bizar-dash/src/server/api.mjs +4 -4
  108. package/bizar-dash/src/server/background-store.mjs +15 -16
  109. package/bizar-dash/src/server/bg-poller.mjs +25 -35
  110. package/bizar-dash/src/server/bg-retry.mjs +66 -194
  111. package/bizar-dash/src/server/claude-bg-spawner.mjs +390 -0
  112. package/bizar-dash/src/server/claude-info.mjs +412 -0
  113. package/bizar-dash/src/server/{cline-runner.mjs → claude-runner.mjs} +53 -48
  114. package/bizar-dash/src/server/claude-sdk.mjs +191 -0
  115. package/bizar-dash/src/server/providers-store.mjs +22 -49
  116. package/bizar-dash/src/server/routes/background.mjs +24 -20
  117. package/bizar-dash/src/server/routes/chat.mjs +223 -326
  118. package/bizar-dash/src/server/routes/claude-session-detail.mjs +329 -0
  119. package/bizar-dash/src/server/routes/claude-sessions.mjs +259 -0
  120. package/bizar-dash/src/server/routes/tasks.mjs +20 -28
  121. package/bizar-dash/src/server/task-delegator.mjs +76 -77
  122. package/bizar-dash/src/web/components/chat/useChat.ts +23 -27
  123. package/bizar-dash/src/web/views/Chat.tsx +8 -8
  124. package/cli/bin.mjs +31 -18
  125. package/cli/commands/claude-cmd.mjs +348 -0
  126. package/cli/commands/install.mjs +12 -11
  127. package/cli/commands/sandbox.mjs +220 -0
  128. package/cli/commands/validate.mjs +252 -288
  129. package/cli/dev-link.test.mjs +11 -11
  130. package/cli/doctor.mjs +131 -213
  131. package/cli/install.mjs +33 -37
  132. package/cli/install.test.mjs +9 -9
  133. package/cli/provision-claude.mjs +893 -0
  134. package/cli/provision.mjs +330 -226
  135. package/cli/provision.test.mjs +102 -0
  136. package/cli/utils.mjs +72 -58
  137. package/config/AGENTS.md +28 -28
  138. package/config/agents/_shared/AGENT_BASELINE.md +104 -684
  139. package/config/skills/bizar/SKILL.md +197 -0
  140. package/config/skills/cubesandbox/SKILL.md +148 -0
  141. package/config/skills/harness-engineering/SKILL.md +142 -0
  142. package/install.sh +66 -44
  143. package/package.json +19 -11
  144. package/packages/sdk/ARCHITECTURE.md +40 -36
  145. package/packages/sdk/package-lock.json +32 -0
  146. package/packages/sdk/package.json +15 -5
  147. package/{plugins/bizar → packages/sdk}/src/dangerous-patterns.ts +6 -28
  148. package/packages/sdk/src/fingerprint.ts +0 -0
  149. package/packages/sdk/src/index.ts +38 -73
  150. package/packages/sdk/src/mcp/bin.ts +51 -0
  151. package/packages/sdk/src/mcp/server.ts +498 -0
  152. package/{plugins/bizar/src/memory-vault.ts → packages/sdk/src/memory/index.ts} +18 -21
  153. package/packages/sdk/tests/sdk.test.mjs +148 -0
  154. package/packages/sdk/vitest.config.ts +1 -1
  155. package/scripts/bh-full-e2e.mjs +166 -363
  156. package/scripts/check-deps.mjs +28 -46
  157. package/scripts/mirror-claude-md.sh +78 -0
  158. package/scripts/test-in-container.sh +157 -0
  159. package/templates/clean-state-checklist.md +3 -3
  160. package/templates/sprint-contract.md +2 -2
  161. package/bizar-dash/.bizar/activity.log +0 -3
  162. package/bizar-dash/.omx/logs/omx-2026-07-07.jsonl +0 -1
  163. package/bizar-dash/.omx/state/session.json +0 -10
  164. package/bizar-dash/bizar-design/EXPLANATION.md +0 -307
  165. package/bizar-dash/bizar-design/INSTRUCTIONS.md +0 -149
  166. package/bizar-dash/bizar-design/canvas.html +0 -281
  167. package/bizar-dash/bizar-design/canvas.html.artifact.json +0 -19
  168. package/bizar-dash/bizar-design/components.css +0 -1665
  169. package/bizar-dash/bizar-design/components.html +0 -557
  170. package/bizar-dash/bizar-design/components.html.artifact.json +0 -19
  171. package/bizar-dash/bizar-design/desktop/agents.html +0 -74
  172. package/bizar-dash/bizar-design/desktop/agents.html.artifact.json +0 -19
  173. package/bizar-dash/bizar-design/desktop/memory.html +0 -75
  174. package/bizar-dash/bizar-design/desktop/memory.html.artifact.json +0 -19
  175. package/bizar-dash/bizar-design/desktop/metrics.html +0 -63
  176. package/bizar-dash/bizar-design/desktop/metrics.html.artifact.json +0 -19
  177. package/bizar-dash/bizar-design/desktop/overview.html +0 -95
  178. package/bizar-dash/bizar-design/desktop/overview.html.artifact.json +0 -19
  179. package/bizar-dash/bizar-design/desktop/settings.html +0 -70
  180. package/bizar-dash/bizar-design/desktop/settings.html.artifact.json +0 -19
  181. package/bizar-dash/bizar-design/icons.svg +0 -44
  182. package/bizar-dash/bizar-design/index.html +0 -192
  183. package/bizar-dash/bizar-design/index.html.artifact.json +0 -19
  184. package/bizar-dash/bizar-design/mobile/agents.html +0 -29
  185. package/bizar-dash/bizar-design/mobile/agents.html.artifact.json +0 -19
  186. package/bizar-dash/bizar-design/mobile/memory.html +0 -28
  187. package/bizar-dash/bizar-design/mobile/memory.html.artifact.json +0 -19
  188. package/bizar-dash/bizar-design/mobile/metrics.html +0 -29
  189. package/bizar-dash/bizar-design/mobile/metrics.html.artifact.json +0 -19
  190. package/bizar-dash/bizar-design/mobile/overview.html +0 -33
  191. package/bizar-dash/bizar-design/mobile/overview.html.artifact.json +0 -19
  192. package/bizar-dash/bizar-design/mobile/settings.html +0 -28
  193. package/bizar-dash/bizar-design/mobile/settings.html.artifact.json +0 -19
  194. package/bizar-dash/bizar-design/prototype.js +0 -114
  195. package/bizar-dash/bizar-design/tokens.css +0 -106
  196. package/bizar-dash/dist/assets/vendor-CeHGtduv.js.map +0 -1
  197. package/bizar-dash/node_modules/.package-lock.json +0 -6
  198. package/bizar-dash/package-lock.json +0 -6
  199. package/bizar-dash/src/server/cline-sdk.mjs +0 -132
  200. package/bizar-dash/src/server/routes/cline-session-detail.mjs +0 -559
  201. package/bizar-dash/src/server/routes/cline-sessions.mjs +0 -291
  202. package/cli/commands/cline-cmd.mjs +0 -289
  203. package/cli/commands/validate.test.mjs +0 -344
  204. package/cli/doctor.test.mjs +0 -350
  205. package/config/cline.json.template +0 -342
  206. package/packages/sdk/src/client.ts +0 -188
  207. package/packages/sdk/src/cline-events.ts +0 -134
  208. package/packages/sdk/src/cline-types.ts +0 -66
  209. package/packages/sdk/src/cline.ts +0 -339
  210. package/packages/sdk/src/errors.ts +0 -129
  211. package/packages/sdk/src/events.ts +0 -153
  212. package/packages/sdk/src/types.ts +0 -176
  213. package/packages/sdk/tests/client.test.ts +0 -217
  214. package/packages/sdk/tests/errors.test.ts +0 -108
  215. package/packages/sdk/tests/events.test.ts +0 -139
  216. package/packages/sdk/tests/fixtures/fetch-mock.ts +0 -152
  217. package/packages/sdk/tests/fixtures/sse-mock.ts +0 -30
  218. package/plugins/bizar/ARCHITECTURE.md +0 -142
  219. package/plugins/bizar/CONSTRAINTS.md +0 -67
  220. package/plugins/bizar/LICENSE +0 -21
  221. package/plugins/bizar/README.md +0 -448
  222. package/plugins/bizar/index.ts +0 -872
  223. package/plugins/bizar/package.json +0 -39
  224. package/plugins/bizar/scripts/check-forbidden-imports.sh +0 -33
  225. package/plugins/bizar/src/background-state.ts +0 -641
  226. package/plugins/bizar/src/background.ts +0 -1806
  227. package/plugins/bizar/src/cline-runner.ts +0 -203
  228. package/plugins/bizar/src/clineruntime.ts +0 -227
  229. package/plugins/bizar/src/commands-impl.ts +0 -151
  230. package/plugins/bizar/src/commands.ts +0 -1799
  231. package/plugins/bizar/src/compaction.d.mts +0 -48
  232. package/plugins/bizar/src/compaction.mjs +0 -192
  233. package/plugins/bizar/src/dashboard-client.ts +0 -233
  234. package/plugins/bizar/src/event-stream.ts +0 -606
  235. package/plugins/bizar/src/fingerprint.ts +0 -120
  236. package/plugins/bizar/src/handoff.ts +0 -79
  237. package/plugins/bizar/src/hooks/memory-flush-on-compact.ts +0 -123
  238. package/plugins/bizar/src/hooks/memory-inject.ts +0 -247
  239. package/plugins/bizar/src/hooks/memory-write-on-end.ts +0 -188
  240. package/plugins/bizar/src/hooks/skill-curator.ts +0 -180
  241. package/plugins/bizar/src/http-client.ts +0 -467
  242. package/plugins/bizar/src/key-rotation.ts +0 -218
  243. package/plugins/bizar/src/logger.ts +0 -144
  244. package/plugins/bizar/src/loop-engineering.ts +0 -241
  245. package/plugins/bizar/src/loop.ts +0 -176
  246. package/plugins/bizar/src/mistake-recovery.ts +0 -98
  247. package/plugins/bizar/src/odin.ts +0 -227
  248. package/plugins/bizar/src/options.ts +0 -470
  249. package/plugins/bizar/src/plan-fs.ts +0 -323
  250. package/plugins/bizar/src/reasoning-clean.ts +0 -454
  251. package/plugins/bizar/src/report.ts +0 -178
  252. package/plugins/bizar/src/research-prompt.ts +0 -35
  253. package/plugins/bizar/src/serve-info.ts +0 -228
  254. package/plugins/bizar/src/serve.ts +0 -496
  255. package/plugins/bizar/src/settings.ts +0 -349
  256. package/plugins/bizar/src/state.ts +0 -298
  257. package/plugins/bizar/src/tool-discipline.ts +0 -105
  258. package/plugins/bizar/src/tools/agent-browser.ts +0 -315
  259. package/plugins/bizar/src/tools/bg-collect.ts +0 -131
  260. package/plugins/bizar/src/tools/bg-get-comments.ts +0 -266
  261. package/plugins/bizar/src/tools/bg-kill.ts +0 -116
  262. package/plugins/bizar/src/tools/bg-pause.ts +0 -99
  263. package/plugins/bizar/src/tools/bg-report-progress.ts +0 -115
  264. package/plugins/bizar/src/tools/bg-resume.ts +0 -94
  265. package/plugins/bizar/src/tools/bg-send-message.ts +0 -223
  266. package/plugins/bizar/src/tools/bg-spawn.ts +0 -502
  267. package/plugins/bizar/src/tools/bg-status.ts +0 -130
  268. package/plugins/bizar/src/tools/graph-query.ts +0 -278
  269. package/plugins/bizar/src/tools/loop-engineering.ts +0 -193
  270. package/plugins/bizar/src/tools/memory-list.ts +0 -43
  271. package/plugins/bizar/src/tools/memory-read.ts +0 -69
  272. package/plugins/bizar/src/tools/memory-search.ts +0 -47
  273. package/plugins/bizar/src/tools/memory-write.ts +0 -54
  274. package/plugins/bizar/src/tools/open-kb.ts +0 -198
  275. package/plugins/bizar/src/tools/plan-action.ts +0 -785
  276. package/plugins/bizar/src/tools/read-glyph-feedback.ts +0 -191
  277. package/plugins/bizar/src/tools/team-spawn.ts +0 -73
  278. package/plugins/bizar/src/tools/team-status.ts +0 -76
  279. package/plugins/bizar/src/tools/wait-for-feedback.ts +0 -415
  280. package/plugins/bizar/src/trajectory.ts +0 -104
  281. package/plugins/bizar/tests/README.md +0 -99
  282. package/plugins/bizar/tests/attach-handler-bug.test.ts +0 -169
  283. package/plugins/bizar/tests/background-state.test.ts +0 -277
  284. package/plugins/bizar/tests/background.test.ts +0 -402
  285. package/plugins/bizar/tests/block.test.ts +0 -195
  286. package/plugins/bizar/tests/canonical-key-order.test.ts +0 -75
  287. package/plugins/bizar/tests/clineruntime-config.test.ts +0 -283
  288. package/plugins/bizar/tests/commands-impl.test.ts +0 -316
  289. package/plugins/bizar/tests/commands.test.ts +0 -584
  290. package/plugins/bizar/tests/compaction.test.ts +0 -264
  291. package/plugins/bizar/tests/config.test.ts +0 -128
  292. package/plugins/bizar/tests/dashboard-client.test.ts +0 -159
  293. package/plugins/bizar/tests/dispose.test.ts +0 -336
  294. package/plugins/bizar/tests/event-stream.test.ts +0 -409
  295. package/plugins/bizar/tests/event.test.ts +0 -262
  296. package/plugins/bizar/tests/fingerprint.test.ts +0 -162
  297. package/plugins/bizar/tests/http-client.test.ts +0 -404
  298. package/plugins/bizar/tests/init-helpers.test.ts +0 -203
  299. package/plugins/bizar/tests/integration/slash-command.test.ts +0 -349
  300. package/plugins/bizar/tests/integration/tool-routing.test.ts +0 -98
  301. package/plugins/bizar/tests/key-rotation.test.ts +0 -396
  302. package/plugins/bizar/tests/loop-engineering.test.ts +0 -168
  303. package/plugins/bizar/tests/loop.test.ts +0 -397
  304. package/plugins/bizar/tests/memory-write-on-end.test.ts +0 -92
  305. package/plugins/bizar/tests/mistake-recovery.test.ts +0 -116
  306. package/plugins/bizar/tests/odin.test.ts +0 -125
  307. package/plugins/bizar/tests/options.test.ts +0 -329
  308. package/plugins/bizar/tests/reasoning-clean.test.ts +0 -422
  309. package/plugins/bizar/tests/safety.test.ts +0 -256
  310. package/plugins/bizar/tests/serve.test.ts +0 -339
  311. package/plugins/bizar/tests/settings.test.ts +0 -351
  312. package/plugins/bizar/tests/stall-think.test.ts +0 -750
  313. package/plugins/bizar/tests/state.test.ts +0 -276
  314. package/plugins/bizar/tests/tool-discipline.test.ts +0 -77
  315. package/plugins/bizar/tests/tools/agent-browser.test.ts +0 -98
  316. package/plugins/bizar/tests/tools/bg-collect.test.ts +0 -337
  317. package/plugins/bizar/tests/tools/bg-get-comments.test.ts +0 -485
  318. package/plugins/bizar/tests/tools/bg-kill.test.ts +0 -235
  319. package/plugins/bizar/tests/tools/bg-pause.test.ts +0 -61
  320. package/plugins/bizar/tests/tools/bg-report-progress.test.ts +0 -79
  321. package/plugins/bizar/tests/tools/bg-resume.test.ts +0 -40
  322. package/plugins/bizar/tests/tools/bg-send-message.test.ts +0 -116
  323. package/plugins/bizar/tests/tools/bg-spawn-delegation.test.ts +0 -147
  324. package/plugins/bizar/tests/tools/bg-spawn-http.test.ts +0 -233
  325. package/plugins/bizar/tests/tools/bg-spawn.test.ts +0 -311
  326. package/plugins/bizar/tests/tools/bg-status.test.ts +0 -217
  327. package/plugins/bizar/tests/tools/cline-runner.test.ts +0 -115
  328. package/plugins/bizar/tests/tools/plan-action.test.ts +0 -599
  329. package/plugins/bizar/tests/tools/read-glyph-feedback.test.ts +0 -253
  330. package/plugins/bizar/tests/tools/wait-for-feedback.test.ts +0 -390
  331. package/plugins/bizar/tests/update-deadlock.test.ts +0 -151
  332. package/plugins/bizar/tsconfig.json +0 -29
@@ -1,283 +0,0 @@
1
- /**
2
- * tests/clineruntime-config.test.ts
3
- *
4
- * v6.0.1 — Unit tests for `clineruntime.ts` config plumbing.
5
- *
6
- * Verifies that `startSession` routes `execution`,
7
- * `onConsecutiveMistakeLimitReached`, and the per-runtime defaults
8
- * through to `core.start()`. We do NOT call `ClineCore.create()` — a
9
- * stub core is injected via the (private) `core` field. `ensure()` is
10
- * the only path that touches ClineCore; once `core` is set, ensure()
11
- * returns synchronously, so the stub captures calls without booting
12
- * the real runtime.
13
- */
14
-
15
- import { afterEach, beforeEach, describe, expect, test } from "bun:test";
16
- import {
17
- ClineRuntime,
18
- } from "../src/clineruntime";
19
- import type { ConsecutiveMistakeLimitContext } from "@cline/shared";
20
-
21
- interface CapturedStartInput {
22
- config: Record<string, unknown>;
23
- prompt: string;
24
- }
25
-
26
- const capturedConfig: CapturedStartInput[] = [];
27
-
28
- function makeFakeCore() {
29
- const fake = {
30
- sessionId: "sess-fake-001",
31
- async start(input: CapturedStartInput): Promise<{ ok: true; sessionId: string }> {
32
- capturedConfig.push(input);
33
- return { ok: true, sessionId: fake.sessionId };
34
- },
35
- async send(): Promise<unknown> { return { ok: true }; },
36
- async abort(): Promise<unknown> { return { ok: true }; },
37
- async stop(): Promise<unknown> { return { ok: true }; },
38
- subscribe(): () => void { return () => undefined; },
39
- async dispose(): Promise<unknown> { return { ok: true }; },
40
- };
41
- return fake;
42
- }
43
-
44
- beforeEach(() => {
45
- capturedConfig.length = 0;
46
- });
47
-
48
- afterEach(() => {
49
- capturedConfig.length = 0;
50
- });
51
-
52
- describe("ClineRuntime.startSession — execution plumbing", () => {
53
- test("no execution + no runtime default → config.execution is absent", async () => {
54
- const runtime = new ClineRuntime({ logger: stubLogger() });
55
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
56
- await runtime.startSession({
57
- providerId: "anthropic",
58
- modelId: "claude-sonnet-4-6",
59
- workspaceRoot: "/tmp",
60
- prompt: "go",
61
- });
62
- expect(capturedConfig.length).toBe(1);
63
- const cfg = capturedConfig[0]!.config;
64
- expect("execution" in cfg).toBe(false);
65
- expect("onConsecutiveMistakeLimitReached" in cfg).toBe(false);
66
- });
67
-
68
- test("runtime default is applied when caller omits execution", async () => {
69
- const recoveryCalls: Array<ConsecutiveMistakeLimitContext> = [];
70
- const recovery = (ctx: ConsecutiveMistakeLimitContext) => {
71
- recoveryCalls.push(ctx);
72
- return { action: "continue" as const, guidance: "x" };
73
- };
74
- const runtime = new ClineRuntime({
75
- logger: stubLogger(),
76
- defaultMaxConsecutiveMistakes: 10,
77
- defaultOnConsecutiveMistakeLimitReached: recovery,
78
- });
79
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
80
- await runtime.startSession({
81
- providerId: "anthropic",
82
- modelId: "claude-sonnet-4-6",
83
- workspaceRoot: "/tmp",
84
- prompt: "go",
85
- });
86
- const cfg = capturedConfig[0]!.config;
87
- expect(cfg.execution).toEqual({ maxConsecutiveMistakes: 10 });
88
- expect(typeof cfg.onConsecutiveMistakeLimitReached).toBe("function");
89
- // Invoke the wire-through function and confirm it IS the recovery closure.
90
- const fn = cfg.onConsecutiveMistakeLimitReached as (ctx: ConsecutiveMistakeLimitContext) => unknown;
91
- fn({ iteration: 1, consecutiveMistakes: 3, maxConsecutiveMistakes: 10, reason: "invalid_tool_call" });
92
- expect(recoveryCalls.length).toBe(1);
93
- expect(recoveryCalls[0]!.reason).toBe("invalid_tool_call");
94
- });
95
-
96
- test("v6.2.4 — plugin default is a FLOOR; CLI default of 3 is bumped to plugin default", async () => {
97
- // This is the v6.2.0 → v6.2.4 regression test. Previously the
98
- // caller's maxConsecutiveMistakes (e.g. the Cline CLI's --retries
99
- // default of 3) would silently override the plugin's higher
100
- // default. Now we use Math.max so the plugin's 10 wins.
101
- const runtime = new ClineRuntime({
102
- logger: stubLogger(),
103
- defaultMaxConsecutiveMistakes: 10,
104
- });
105
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
106
- await runtime.startSession({
107
- providerId: "anthropic",
108
- modelId: "claude-sonnet-4-6",
109
- workspaceRoot: "/tmp",
110
- prompt: "go",
111
- execution: { maxConsecutiveMistakes: 3, reminderAfterIterations: 8 },
112
- });
113
- const cfg = capturedConfig[0]!.config;
114
- expect(cfg.execution?.maxConsecutiveMistakes).toBe(10,
115
- "plugin default must win over CLI default of 3 (was a v6.0 regression)");
116
- expect(cfg.execution?.reminderAfterIterations).toBe(8, "other caller fields pass through");
117
- });
118
-
119
- test("caller-supplied HIGHER execution.maxConsecutiveMistakes still wins", async () => {
120
- const runtime = new ClineRuntime({
121
- logger: stubLogger(),
122
- defaultMaxConsecutiveMistakes: 10,
123
- });
124
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
125
- await runtime.startSession({
126
- providerId: "anthropic",
127
- modelId: "claude-sonnet-4-6",
128
- workspaceRoot: "/tmp",
129
- prompt: "go",
130
- execution: { maxConsecutiveMistakes: 20, reminderAfterIterations: 8 },
131
- });
132
- const cfg = capturedConfig[0]!.config;
133
- expect(cfg.execution?.maxConsecutiveMistakes).toBe(20,
134
- "user can still raise the limit with --retries 20");
135
- });
136
-
137
- test("caller-supplied execution.maxConsecutiveMistakes wins over default (legacy behavior)", async () => {
138
- const runtime = new ClineRuntime({
139
- logger: stubLogger(),
140
- defaultMaxConsecutiveMistakes: 4,
141
- });
142
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
143
- await runtime.startSession({
144
- providerId: "anthropic",
145
- modelId: "claude-sonnet-4-6",
146
- workspaceRoot: "/tmp",
147
- prompt: "go",
148
- execution: { maxConsecutiveMistakes: 12, reminderAfterIterations: 8 },
149
- });
150
- const cfg = capturedConfig[0]!.config;
151
- expect(cfg.execution).toEqual({ maxConsecutiveMistakes: 12, reminderAfterIterations: 8 });
152
- });
153
-
154
- test("caller-supplied recovery callback overrides runtime default", async () => {
155
- let defaultCalled = false;
156
- let overrideCalled = false;
157
- const runtime = new ClineRuntime({
158
- logger: stubLogger(),
159
- defaultOnConsecutiveMistakeLimitReached: () => {
160
- defaultCalled = true;
161
- return { action: "continue" as const };
162
- },
163
- });
164
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
165
- await runtime.startSession({
166
- providerId: "anthropic",
167
- modelId: "claude-sonnet-4-6",
168
- workspaceRoot: "/tmp",
169
- prompt: "go",
170
- onConsecutiveMistakeLimitReached: () => {
171
- overrideCalled = true;
172
- return { action: "continue" as const };
173
- },
174
- });
175
- const fn = capturedConfig[0]!.config.onConsecutiveMistakeLimitReached as () => { action: string };
176
- fn();
177
- expect(overrideCalled).toBe(true);
178
- expect(defaultCalled).toBe(false);
179
- });
180
-
181
- test("defaultMaxConsecutiveMistakes floors at 3", () => {
182
- const runtime = new ClineRuntime({ logger: stubLogger(), defaultMaxConsecutiveMistakes: 1 });
183
- const value = (runtime as unknown as { defaultMaxConsecutiveMistakes?: number }).defaultMaxConsecutiveMistakes;
184
- expect(value).toBe(3);
185
- });
186
-
187
- test("reminderText and loopDetection pass through unchanged", async () => {
188
- const runtime = new ClineRuntime({ logger: stubLogger() });
189
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
190
- await runtime.startSession({
191
- providerId: "anthropic",
192
- modelId: "claude-sonnet-4-6",
193
- workspaceRoot: "/tmp",
194
- prompt: "go",
195
- execution: {
196
- reminderAfterIterations: 5,
197
- reminderText: "synthesize now",
198
- loopDetection: { softThreshold: 4, hardThreshold: 7 },
199
- },
200
- });
201
- const cfg = capturedConfig[0]!.config;
202
- expect(cfg.execution).toEqual({
203
- reminderAfterIterations: 5,
204
- reminderText: "synthesize now",
205
- loopDetection: { softThreshold: 4, hardThreshold: 7 },
206
- });
207
- });
208
- });
209
-
210
- describe("ClineRuntime.startSession — agent teams plumbing (v6.2.0)", () => {
211
- test("enableAgentTeams is true on every session (team-spawn requires it)", async () => {
212
- const runtime = new ClineRuntime({ logger: stubLogger() });
213
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
214
- await runtime.startSession({
215
- providerId: "anthropic",
216
- modelId: "claude-sonnet-4-6",
217
- workspaceRoot: "/tmp",
218
- prompt: "go",
219
- });
220
- const cfg = capturedConfig[0]!.config;
221
- expect(cfg.enableAgentTeams).toBe(true);
222
- });
223
-
224
- test("enableTools is true, enableSpawnAgent is true (subagents + task tool)", async () => {
225
- const runtime = new ClineRuntime({ logger: stubLogger() });
226
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
227
- await runtime.startSession({
228
- providerId: "anthropic",
229
- modelId: "claude-sonnet-4-6",
230
- workspaceRoot: "/tmp",
231
- prompt: "go",
232
- });
233
- const cfg = capturedConfig[0]!.config;
234
- expect(cfg.enableTools).toBe(true);
235
- expect(cfg.enableSpawnAgent).toBe(true,
236
- "enableSpawnAgent must be true so Odin can use the `task` tool and `use_subagents`");
237
- });
238
-
239
- test("all three boolean flags survive even when caller passes no opts", async () => {
240
- const runtime = new ClineRuntime({ logger: stubLogger() });
241
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
242
- await runtime.startSession({
243
- providerId: "anthropic",
244
- modelId: "claude-sonnet-4-6",
245
- workspaceRoot: "/tmp",
246
- prompt: "go",
247
- });
248
- const cfg = capturedConfig[0]!.config;
249
- expect(cfg.enableAgentTeams).toBe(true);
250
- expect(cfg.enableTools).toBe(true);
251
- expect(cfg.enableSpawnAgent).toBe(true,
252
- "v6.2.3 — subagents + task tool must be available even without caller opts");
253
- });
254
- });
255
-
256
- describe("ClineRuntime.startSession — subagents plumbing (v6.2.3)", () => {
257
- test("enableSpawnAgent regression: must NEVER be false (v6.2.3 fix)", async () => {
258
- // v6.2.3 flipped enableSpawnAgent from false → true. Before this
259
- // change, Odin could not use the `task` tool or `use_subagents`,
260
- // which silently broke subagent delegation. This test pins the fix.
261
- const runtime = new ClineRuntime({ logger: stubLogger() });
262
- (runtime as unknown as { core: unknown }).core = makeFakeCore();
263
- await runtime.startSession({
264
- providerId: "anthropic",
265
- modelId: "claude-sonnet-4-6",
266
- workspaceRoot: "/tmp",
267
- prompt: "go",
268
- });
269
- const cfg = capturedConfig[0]!.config;
270
- expect(cfg.enableSpawnAgent).not.toBe(false);
271
- expect(cfg.enableSpawnAgent).toBe(true);
272
- });
273
- });
274
-
275
- function stubLogger(): { info: (m: string) => void; warn: (m: string) => void; error: (m: string) => void; debug: (m: string) => void; log: (o: { level: string; message: string }) => void } {
276
- return {
277
- info: () => {},
278
- warn: () => {},
279
- error: () => {},
280
- debug: () => {},
281
- log: () => {},
282
- };
283
- }
@@ -1,316 +0,0 @@
1
- /**
2
- * commands-impl.test.ts
3
- *
4
- * Unit tests for src/commands-impl.ts (the slash-command side-effect
5
- * executor). Phase 2 — Cline SDK port: uses Cline's `createTool` API
6
- * and the new `AgentToolContext` shape (no `metadata()` method, no
7
- * `ask()` method).
8
- */
9
-
10
- import { describe, test, expect, beforeAll, afterAll } from "bun:test";
11
- import { mkdtempSync, rmSync, existsSync, readFileSync } from "node:fs";
12
- import { join } from "node:path";
13
- import { tmpdir } from "node:os";
14
- import { z } from "zod";
15
- import { createTool, type AgentTool, type AgentToolContext } from "@cline/sdk";
16
-
17
- import {
18
- executeSideEffect,
19
- buildSyntheticToolContext,
20
- validateToolArgs,
21
- type ExecuteOptions,
22
- type ExecutorContext,
23
- } from "../src/commands-impl";
24
- import type { SideEffect } from "../src/commands";
25
- import { createPlanActionTool } from "../src/tools/plan-action";
26
- import { createBgGetCommentsTool } from "../src/tools/bg-get-comments";
27
- import { createWaitForFeedbackTool } from "../src/tools/wait-for-feedback";
28
-
29
- // ---------------------------------------------------------------------------
30
- // Test doubles
31
- // ---------------------------------------------------------------------------
32
-
33
- class MockLogger {
34
- messages: Array<{ level: string; message: string }> = [];
35
- debug(m: string) { this.messages.push({ level: "debug", message: m }); }
36
- info(m: string) { this.messages.push({ level: "info", message: m }); }
37
- warn(m: string) { this.messages.push({ level: "warn", message: m }); }
38
- error(m: string) { this.messages.push({ level: "error", message: m }); }
39
- log(_o: { level: string; message: string }) {}
40
- }
41
-
42
- let worktree: string;
43
- const logger = new MockLogger();
44
-
45
- beforeAll(() => {
46
- worktree = mkdtempSync(join(tmpdir(), "bizar-commands-impl-test-"));
47
- });
48
-
49
- afterAll(() => {
50
- if (worktree) rmSync(worktree, { recursive: true, force: true });
51
- });
52
-
53
- function ctx(): ExecutorContext {
54
- return { worktree, directory: worktree, logger };
55
- }
56
-
57
- function optsWith(tools: Record<string, AgentTool>): ExecuteOptions {
58
- return { tools, defaultTemplate: "blank", defaultPort: 4321 };
59
- }
60
-
61
- const planTools = (): Record<string, AgentTool> => ({
62
- bizar_plan_action: createPlanActionTool({ worktree, logger }) as unknown as AgentTool,
63
- bizar_get_plan_comments: createBgGetCommentsTool({ worktree, logger }) as unknown as AgentTool,
64
- bizar_wait_for_feedback: createWaitForFeedbackTool({ worktree, logger }) as unknown as AgentTool,
65
- });
66
-
67
- // ---------------------------------------------------------------------------
68
- // Group 1 — buildSyntheticToolContext
69
- // ---------------------------------------------------------------------------
70
-
71
- describe("buildSyntheticToolContext", () => {
72
- test("populates all required fields (R6)", () => {
73
- const tctx = buildSyntheticToolContext(ctx()) as unknown as Record<string, unknown>;
74
- expect(tctx.sessionId).toBe("slash-command");
75
- expect(typeof tctx.runId).toBe("string");
76
- expect(String(tctx.runId)).toMatch(/^slash-command-\d+$/);
77
- expect(tctx.agentId).toBe("slash-command");
78
- expect(tctx.iteration).toBe(0);
79
- const meta = tctx.metadata as { worktree: string; directory: string };
80
- expect(meta.worktree).toBe(worktree);
81
- expect(meta.directory).toBe(worktree);
82
- });
83
-
84
- test("each call gets a fresh AbortSignal (not shared)", () => {
85
- const a = buildSyntheticToolContext(ctx()) as unknown as { signal: AbortSignal };
86
- const b = buildSyntheticToolContext(ctx()) as unknown as { signal: AbortSignal };
87
- expect(a.signal).not.toBe(b.signal);
88
- expect(a.signal).toBeInstanceOf(AbortSignal);
89
- expect(a.signal.aborted).toBe(false);
90
- });
91
- });
92
-
93
- // ---------------------------------------------------------------------------
94
- // Group 2 — validateToolArgs
95
- // ---------------------------------------------------------------------------
96
-
97
- describe("validateToolArgs", () => {
98
- const echoSchema = z.object({ message: z.string() });
99
- const echoTool: AgentTool = createTool({
100
- name: "echo",
101
- description: "echo",
102
- inputSchema: echoSchema.shape,
103
- execute: async (input) => ({ echoed: input }),
104
- });
105
-
106
- test("ok on well-formed args", () => {
107
- const r = validateToolArgs(echoTool, { message: "hi" });
108
- expect(r.ok).toBe(true);
109
- if (r.ok) expect(r.args.message).toBe("hi");
110
- });
111
-
112
- test("error on malformed args (returns path + message)", () => {
113
- const r = validateToolArgs(echoTool, { message: 42 });
114
- expect(r.ok).toBe(false);
115
- if (!r.ok) expect(r.error).toMatch(/message/);
116
- });
117
-
118
- test("error on missing required arg", () => {
119
- const r = validateToolArgs(echoTool, {});
120
- expect(r.ok).toBe(false);
121
- });
122
- });
123
-
124
- // ---------------------------------------------------------------------------
125
- // Group 3 — executeSideEffect — create_plan
126
- // ---------------------------------------------------------------------------
127
-
128
- describe("executeSideEffect — create_plan", () => {
129
- test("happy path: writes plans/<slug>/meta.json and plan.json", async () => {
130
- const slug = "create-happy";
131
- const sideEffect: SideEffect = { kind: "create_plan", slug, template: null };
132
- const res = await executeSideEffect(sideEffect, ctx(), optsWith(planTools()));
133
-
134
- expect(res.responseOverride).toBeDefined();
135
- expect(res.responseOverride).toContain(slug);
136
-
137
- const dir = join(worktree, "plans", slug);
138
- expect(existsSync(dir)).toBe(true);
139
- expect(existsSync(join(dir, "meta.json"))).toBe(true);
140
- expect(existsSync(join(dir, "plan.json"))).toBe(true);
141
-
142
- const meta = JSON.parse(readFileSync(join(dir, "meta.json"), "utf-8"));
143
- expect(meta.status).toBe("draft");
144
- expect(typeof meta.lastEdited).toBe("string");
145
-
146
- const canvas = JSON.parse(readFileSync(join(dir, "plan.json"), "utf-8"));
147
- expect(canvas.schemaVersion).toBe(2);
148
- expect(canvas.elements).toEqual([]);
149
- });
150
-
151
- test("refuses to clobber an existing plan (returns responseOverride)", async () => {
152
- const slug = "create-existing";
153
- const sideEffect: SideEffect = { kind: "create_plan", slug, template: null };
154
- const r1 = await executeSideEffect(sideEffect, ctx(), optsWith(planTools()));
155
- expect(r1.responseOverride).toBeDefined();
156
-
157
- const r2 = await executeSideEffect(sideEffect, ctx(), optsWith(planTools()));
158
- expect(r2.responseOverride).toBeDefined();
159
- expect(r2.responseOverride).toMatch(/already exists|Failed to create/);
160
- expect(r2.responseOverride).toContain(slug);
161
- });
162
- });
163
-
164
- // ---------------------------------------------------------------------------
165
- // Group 4 — executeSideEffect — list_plans
166
- // ---------------------------------------------------------------------------
167
-
168
- describe("executeSideEffect — list_plans", () => {
169
- test("returns rich list with status + draft", async () => {
170
- await executeSideEffect({ kind: "create_plan", slug: "list-a", template: null }, ctx(), optsWith(planTools()));
171
- await executeSideEffect({ kind: "create_plan", slug: "list-b", template: null }, ctx(), optsWith(planTools()));
172
-
173
- const res = await executeSideEffect({ kind: "list_plans" }, ctx(), optsWith(planTools()));
174
- expect(res.responseOverride).toBeDefined();
175
- expect(res.responseOverride).toMatch(/list-a/);
176
- expect(res.responseOverride).toMatch(/list-b/);
177
- expect(res.responseOverride).toMatch(/draft/);
178
- });
179
-
180
- test("returns 'No plans found' when worktree has no plans", async () => {
181
- const tmp = mkdtempSync(join(tmpdir(), "bizar-empty-"));
182
- const c: ExecutorContext = { worktree: tmp, directory: tmp, logger };
183
- try {
184
- const res = await executeSideEffect({ kind: "list_plans" }, c, optsWith(planTools()));
185
- expect(res.responseOverride).toMatch(/No plans found/);
186
- } finally {
187
- rmSync(tmp, { recursive: true, force: true });
188
- }
189
- });
190
- });
191
-
192
- // ---------------------------------------------------------------------------
193
- // Group 5 — executeSideEffect — open_plan_url
194
- // ---------------------------------------------------------------------------
195
-
196
- describe("executeSideEffect — open_plan_url", () => {
197
- test("returns the open URL", async () => {
198
- const res = await executeSideEffect({ kind: "open_plan_url", slug: "any-slug" }, ctx(), optsWith(planTools()));
199
- expect(res.responseOverride).toBeDefined();
200
- expect(res.responseOverride).toContain("any-slug");
201
- expect(res.responseOverride).toMatch(/^Open plan:/);
202
- });
203
- });
204
-
205
- // ---------------------------------------------------------------------------
206
- // Group 6 — executeToolInvocation — happy path
207
- // ---------------------------------------------------------------------------
208
-
209
- describe("executeToolInvocation — happy path", () => {
210
- test("invokes bizar_plan_action (get_canvas) with synthetic context", async () => {
211
- const slug = "inv-get-canvas";
212
- await executeSideEffect({ kind: "create_plan", slug, template: null }, ctx(), optsWith(planTools()));
213
-
214
- const realPlanTool = planTools().bizar_plan_action!;
215
- let capturedCtx: AgentToolContext | null = null;
216
- let capturedArgs: unknown = null;
217
- const spy: AgentTool = createTool({
218
- name: realPlanTool!.name,
219
- description: realPlanTool!.description,
220
- inputSchema: (realPlanTool! as unknown as { inputSchema: Record<string, unknown> }).inputSchema,
221
- execute: async (a, c) => {
222
- capturedCtx = c;
223
- capturedArgs = a;
224
- return (realPlanTool!.execute as (a: unknown, c: unknown) => Promise<unknown>)(a, c);
225
- },
226
- });
227
-
228
- const tools: Record<string, AgentTool> = {
229
- bizar_plan_action: spy,
230
- bizar_get_plan_comments: planTools().bizar_get_plan_comments!,
231
- bizar_wait_for_feedback: planTools().bizar_wait_for_feedback!,
232
- };
233
-
234
- const sideEffect: SideEffect = { kind: "tool_invocation", toolName: "bizar_plan_action", args: { action: "get_canvas", planSlug: slug } };
235
- const res = await executeSideEffect(sideEffect, ctx(), optsWith(tools));
236
-
237
- expect(res.responseOverride).toBeDefined();
238
- // The tool returns a structured object that gets stringified.
239
- expect(capturedCtx).not.toBeNull();
240
- const cc = capturedCtx as unknown as { sessionId: string; agentId: string };
241
- expect(cc.sessionId).toBe("slash-command");
242
- expect(cc.agentId).toBe("slash-command");
243
- expect(capturedArgs).toMatchObject({ action: "get_canvas", planSlug: slug });
244
- });
245
- });
246
-
247
- // ---------------------------------------------------------------------------
248
- // Group 7 — executeToolInvocation — arg validation
249
- // ---------------------------------------------------------------------------
250
-
251
- describe("executeToolInvocation — arg validation", () => {
252
- test("rejects malformed args (missing planSlug) with a responseOverride", async () => {
253
- const sideEffect: SideEffect = { kind: "tool_invocation", toolName: "bizar_plan_action", args: { action: "get_canvas" } };
254
- const res = await executeSideEffect(sideEffect, ctx(), optsWith(planTools()));
255
- expect(res.responseOverride).toBeDefined();
256
- expect(res.responseOverride).toMatch(/Invalid arguments for bizar_plan_action/);
257
- });
258
-
259
- test("rejects malformed args (invalid slug) with a responseOverride", async () => {
260
- const sideEffect: SideEffect = { kind: "tool_invocation", toolName: "bizar_plan_action", args: { action: "get_canvas", planSlug: "UPPERCASE" } };
261
- const res = await executeSideEffect(sideEffect, ctx(), optsWith(planTools()));
262
- expect(res.responseOverride).toBeDefined();
263
- expect(res.responseOverride).toMatch(/Invalid arguments/);
264
- });
265
- });
266
-
267
- // ---------------------------------------------------------------------------
268
- // Group 8 — executeToolInvocation — unknown tool
269
- // ---------------------------------------------------------------------------
270
-
271
- describe("executeToolInvocation — unknown tool", () => {
272
- test("returns responseOverride listing available tools", async () => {
273
- const sideEffect: SideEffect = { kind: "tool_invocation", toolName: "bizar_nonexistent", args: {} };
274
- const res = await executeSideEffect(sideEffect, ctx(), optsWith(planTools()));
275
- expect(res.responseOverride).toBeDefined();
276
- expect(res.responseOverride).toMatch(/bizar_nonexistent.*not registered/);
277
- expect(res.responseOverride).toMatch(/bizar_plan_action/);
278
- });
279
-
280
- test("when no tools are registered, the error says (none)", async () => {
281
- const sideEffect: SideEffect = { kind: "tool_invocation", toolName: "bizar_anything", args: {} };
282
- const res = await executeSideEffect(sideEffect, ctx(), optsWith({}));
283
- expect(res.responseOverride).toMatch(/\(none\)/);
284
- });
285
- });
286
-
287
- // ---------------------------------------------------------------------------
288
- // Group 9 — executeToolInvocation — tool throws
289
- // ---------------------------------------------------------------------------
290
-
291
- describe("executeToolInvocation — tool throws", () => {
292
- test("stringifies the error into responseOverride (does NOT throw)", async () => {
293
- const explodingTool: AgentTool = createTool({
294
- name: "bizar_explode",
295
- description: "explodes",
296
- inputSchema: z.object({ x: z.string() }).shape,
297
- execute: async () => { throw new Error("boom!"); },
298
- });
299
- const sideEffect: SideEffect = { kind: "tool_invocation", toolName: "bizar_explode", args: { x: "hi" } };
300
- const res = await executeSideEffect(sideEffect, ctx(), optsWith({ bizar_explode: explodingTool }));
301
- expect(res.responseOverride).toMatch(/bizar_explode failed: boom!/);
302
- });
303
- });
304
-
305
- // ---------------------------------------------------------------------------
306
- // Group 10 — synthetic context field check
307
- // ---------------------------------------------------------------------------
308
-
309
- describe("synthetic context — exhaustive field check", () => {
310
- test("exposes sessionId, agentId, runId, iteration, signal, metadata", () => {
311
- const tctx = buildSyntheticToolContext(ctx()) as unknown as Record<string, unknown>;
312
- for (const k of ["sessionId", "agentId", "runId", "iteration", "signal", "metadata"]) {
313
- expect(tctx[k]).toBeDefined();
314
- }
315
- });
316
- });