@polderlabs/bizar 6.2.5 → 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 (329) 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 +17 -18
  125. package/cli/commands/claude-cmd.mjs +348 -0
  126. package/cli/commands/install.mjs +12 -11
  127. package/cli/commands/validate.mjs +252 -325
  128. package/cli/dev-link.test.mjs +11 -11
  129. package/cli/doctor.mjs +131 -213
  130. package/cli/install.mjs +33 -37
  131. package/cli/install.test.mjs +9 -9
  132. package/cli/provision-claude.mjs +893 -0
  133. package/cli/provision.mjs +224 -227
  134. package/cli/utils.mjs +72 -58
  135. package/config/AGENTS.md +28 -28
  136. package/install.sh +66 -44
  137. package/package.json +19 -11
  138. package/packages/sdk/ARCHITECTURE.md +40 -36
  139. package/packages/sdk/package-lock.json +32 -0
  140. package/packages/sdk/package.json +15 -5
  141. package/{plugins/bizar → packages/sdk}/src/dangerous-patterns.ts +6 -28
  142. package/packages/sdk/src/fingerprint.ts +0 -0
  143. package/packages/sdk/src/index.ts +38 -73
  144. package/packages/sdk/src/mcp/bin.ts +51 -0
  145. package/packages/sdk/src/mcp/server.ts +498 -0
  146. package/{plugins/bizar/src/memory-vault.ts → packages/sdk/src/memory/index.ts} +18 -21
  147. package/packages/sdk/tests/sdk.test.mjs +148 -0
  148. package/packages/sdk/vitest.config.ts +1 -1
  149. package/scripts/bh-full-e2e.mjs +166 -363
  150. package/scripts/check-deps.mjs +28 -46
  151. package/scripts/mirror-claude-md.sh +78 -0
  152. package/scripts/test-in-container.sh +31 -9
  153. package/templates/clean-state-checklist.md +3 -3
  154. package/templates/sprint-contract.md +2 -2
  155. package/bizar-dash/.bizar/activity.log +0 -3
  156. package/bizar-dash/.omx/logs/omx-2026-07-07.jsonl +0 -1
  157. package/bizar-dash/.omx/state/session.json +0 -10
  158. package/bizar-dash/bizar-design/EXPLANATION.md +0 -307
  159. package/bizar-dash/bizar-design/INSTRUCTIONS.md +0 -149
  160. package/bizar-dash/bizar-design/canvas.html +0 -281
  161. package/bizar-dash/bizar-design/canvas.html.artifact.json +0 -19
  162. package/bizar-dash/bizar-design/components.css +0 -1665
  163. package/bizar-dash/bizar-design/components.html +0 -557
  164. package/bizar-dash/bizar-design/components.html.artifact.json +0 -19
  165. package/bizar-dash/bizar-design/desktop/agents.html +0 -74
  166. package/bizar-dash/bizar-design/desktop/agents.html.artifact.json +0 -19
  167. package/bizar-dash/bizar-design/desktop/memory.html +0 -75
  168. package/bizar-dash/bizar-design/desktop/memory.html.artifact.json +0 -19
  169. package/bizar-dash/bizar-design/desktop/metrics.html +0 -63
  170. package/bizar-dash/bizar-design/desktop/metrics.html.artifact.json +0 -19
  171. package/bizar-dash/bizar-design/desktop/overview.html +0 -95
  172. package/bizar-dash/bizar-design/desktop/overview.html.artifact.json +0 -19
  173. package/bizar-dash/bizar-design/desktop/settings.html +0 -70
  174. package/bizar-dash/bizar-design/desktop/settings.html.artifact.json +0 -19
  175. package/bizar-dash/bizar-design/icons.svg +0 -44
  176. package/bizar-dash/bizar-design/index.html +0 -192
  177. package/bizar-dash/bizar-design/index.html.artifact.json +0 -19
  178. package/bizar-dash/bizar-design/mobile/agents.html +0 -29
  179. package/bizar-dash/bizar-design/mobile/agents.html.artifact.json +0 -19
  180. package/bizar-dash/bizar-design/mobile/memory.html +0 -28
  181. package/bizar-dash/bizar-design/mobile/memory.html.artifact.json +0 -19
  182. package/bizar-dash/bizar-design/mobile/metrics.html +0 -29
  183. package/bizar-dash/bizar-design/mobile/metrics.html.artifact.json +0 -19
  184. package/bizar-dash/bizar-design/mobile/overview.html +0 -33
  185. package/bizar-dash/bizar-design/mobile/overview.html.artifact.json +0 -19
  186. package/bizar-dash/bizar-design/mobile/settings.html +0 -28
  187. package/bizar-dash/bizar-design/mobile/settings.html.artifact.json +0 -19
  188. package/bizar-dash/bizar-design/prototype.js +0 -114
  189. package/bizar-dash/bizar-design/tokens.css +0 -106
  190. package/bizar-dash/dist/assets/vendor-CeHGtduv.js.map +0 -1
  191. package/bizar-dash/node_modules/.package-lock.json +0 -6
  192. package/bizar-dash/package-lock.json +0 -6
  193. package/bizar-dash/src/server/cline-sdk.mjs +0 -132
  194. package/bizar-dash/src/server/routes/cline-session-detail.mjs +0 -559
  195. package/bizar-dash/src/server/routes/cline-sessions.mjs +0 -291
  196. package/cli/commands/cline-cmd.mjs +0 -289
  197. package/cli/commands/validate.test.mjs +0 -379
  198. package/cli/doctor.test.mjs +0 -350
  199. package/config/cline.json.template +0 -342
  200. package/packages/sdk/src/client.ts +0 -188
  201. package/packages/sdk/src/cline-events.ts +0 -134
  202. package/packages/sdk/src/cline-types.ts +0 -66
  203. package/packages/sdk/src/cline.ts +0 -339
  204. package/packages/sdk/src/errors.ts +0 -129
  205. package/packages/sdk/src/events.ts +0 -153
  206. package/packages/sdk/src/types.ts +0 -176
  207. package/packages/sdk/tests/client.test.ts +0 -217
  208. package/packages/sdk/tests/errors.test.ts +0 -108
  209. package/packages/sdk/tests/events.test.ts +0 -139
  210. package/packages/sdk/tests/fixtures/fetch-mock.ts +0 -152
  211. package/packages/sdk/tests/fixtures/sse-mock.ts +0 -30
  212. package/plugins/bizar/ARCHITECTURE.md +0 -142
  213. package/plugins/bizar/CONSTRAINTS.md +0 -67
  214. package/plugins/bizar/LICENSE +0 -21
  215. package/plugins/bizar/README.md +0 -448
  216. package/plugins/bizar/index.ts +0 -925
  217. package/plugins/bizar/package.json +0 -39
  218. package/plugins/bizar/scripts/check-forbidden-imports.sh +0 -33
  219. package/plugins/bizar/src/background-state.ts +0 -641
  220. package/plugins/bizar/src/background.ts +0 -1806
  221. package/plugins/bizar/src/cline-runner.ts +0 -203
  222. package/plugins/bizar/src/clineruntime.ts +0 -227
  223. package/plugins/bizar/src/commands-impl.ts +0 -151
  224. package/plugins/bizar/src/commands.ts +0 -1799
  225. package/plugins/bizar/src/compaction.d.mts +0 -48
  226. package/plugins/bizar/src/compaction.mjs +0 -192
  227. package/plugins/bizar/src/dashboard-client.ts +0 -233
  228. package/plugins/bizar/src/event-stream.ts +0 -606
  229. package/plugins/bizar/src/fingerprint.ts +0 -120
  230. package/plugins/bizar/src/handoff.ts +0 -79
  231. package/plugins/bizar/src/hooks/memory-flush-on-compact.ts +0 -123
  232. package/plugins/bizar/src/hooks/memory-inject.ts +0 -247
  233. package/plugins/bizar/src/hooks/memory-write-on-end.ts +0 -188
  234. package/plugins/bizar/src/hooks/skill-curator.ts +0 -180
  235. package/plugins/bizar/src/http-client.ts +0 -467
  236. package/plugins/bizar/src/key-rotation.ts +0 -218
  237. package/plugins/bizar/src/logger.ts +0 -144
  238. package/plugins/bizar/src/loop-engineering.ts +0 -241
  239. package/plugins/bizar/src/loop.ts +0 -176
  240. package/plugins/bizar/src/mistake-recovery.ts +0 -98
  241. package/plugins/bizar/src/odin.ts +0 -227
  242. package/plugins/bizar/src/options.ts +0 -470
  243. package/plugins/bizar/src/plan-fs.ts +0 -323
  244. package/plugins/bizar/src/reasoning-clean.ts +0 -454
  245. package/plugins/bizar/src/report.ts +0 -178
  246. package/plugins/bizar/src/research-prompt.ts +0 -35
  247. package/plugins/bizar/src/serve-info.ts +0 -228
  248. package/plugins/bizar/src/serve.ts +0 -496
  249. package/plugins/bizar/src/settings.ts +0 -349
  250. package/plugins/bizar/src/state.ts +0 -298
  251. package/plugins/bizar/src/tool-discipline.ts +0 -105
  252. package/plugins/bizar/src/tools/agent-browser.ts +0 -315
  253. package/plugins/bizar/src/tools/bg-collect.ts +0 -131
  254. package/plugins/bizar/src/tools/bg-get-comments.ts +0 -266
  255. package/plugins/bizar/src/tools/bg-kill.ts +0 -116
  256. package/plugins/bizar/src/tools/bg-pause.ts +0 -99
  257. package/plugins/bizar/src/tools/bg-report-progress.ts +0 -115
  258. package/plugins/bizar/src/tools/bg-resume.ts +0 -94
  259. package/plugins/bizar/src/tools/bg-send-message.ts +0 -223
  260. package/plugins/bizar/src/tools/bg-spawn.ts +0 -502
  261. package/plugins/bizar/src/tools/bg-status.ts +0 -130
  262. package/plugins/bizar/src/tools/graph-query.ts +0 -278
  263. package/plugins/bizar/src/tools/loop-engineering.ts +0 -193
  264. package/plugins/bizar/src/tools/memory-list.ts +0 -43
  265. package/plugins/bizar/src/tools/memory-read.ts +0 -69
  266. package/plugins/bizar/src/tools/memory-search.ts +0 -47
  267. package/plugins/bizar/src/tools/memory-write.ts +0 -54
  268. package/plugins/bizar/src/tools/open-kb.ts +0 -198
  269. package/plugins/bizar/src/tools/plan-action.ts +0 -785
  270. package/plugins/bizar/src/tools/read-glyph-feedback.ts +0 -191
  271. package/plugins/bizar/src/tools/sandbox.ts +0 -232
  272. package/plugins/bizar/src/tools/team-spawn.ts +0 -73
  273. package/plugins/bizar/src/tools/team-status.ts +0 -76
  274. package/plugins/bizar/src/tools/wait-for-feedback.ts +0 -415
  275. package/plugins/bizar/src/trajectory.ts +0 -104
  276. package/plugins/bizar/tests/README.md +0 -99
  277. package/plugins/bizar/tests/attach-handler-bug.test.ts +0 -169
  278. package/plugins/bizar/tests/background-state.test.ts +0 -277
  279. package/plugins/bizar/tests/background.test.ts +0 -402
  280. package/plugins/bizar/tests/block.test.ts +0 -195
  281. package/plugins/bizar/tests/canonical-key-order.test.ts +0 -75
  282. package/plugins/bizar/tests/clineruntime-config.test.ts +0 -283
  283. package/plugins/bizar/tests/commands-impl.test.ts +0 -316
  284. package/plugins/bizar/tests/commands.test.ts +0 -584
  285. package/plugins/bizar/tests/compaction.test.ts +0 -264
  286. package/plugins/bizar/tests/config.test.ts +0 -128
  287. package/plugins/bizar/tests/dashboard-client.test.ts +0 -159
  288. package/plugins/bizar/tests/dispose.test.ts +0 -336
  289. package/plugins/bizar/tests/event-stream.test.ts +0 -409
  290. package/plugins/bizar/tests/event.test.ts +0 -262
  291. package/plugins/bizar/tests/fingerprint.test.ts +0 -190
  292. package/plugins/bizar/tests/http-client.test.ts +0 -404
  293. package/plugins/bizar/tests/init-helpers.test.ts +0 -203
  294. package/plugins/bizar/tests/integration/slash-command.test.ts +0 -349
  295. package/plugins/bizar/tests/integration/tool-routing.test.ts +0 -98
  296. package/plugins/bizar/tests/key-rotation.test.ts +0 -396
  297. package/plugins/bizar/tests/loop-engineering.test.ts +0 -168
  298. package/plugins/bizar/tests/loop.test.ts +0 -397
  299. package/plugins/bizar/tests/memory-write-on-end.test.ts +0 -92
  300. package/plugins/bizar/tests/mistake-recovery.test.ts +0 -116
  301. package/plugins/bizar/tests/odin.test.ts +0 -125
  302. package/plugins/bizar/tests/options.test.ts +0 -329
  303. package/plugins/bizar/tests/reasoning-clean.test.ts +0 -422
  304. package/plugins/bizar/tests/safety.test.ts +0 -281
  305. package/plugins/bizar/tests/serve.test.ts +0 -339
  306. package/plugins/bizar/tests/settings.test.ts +0 -351
  307. package/plugins/bizar/tests/stall-think.test.ts +0 -750
  308. package/plugins/bizar/tests/state.test.ts +0 -276
  309. package/plugins/bizar/tests/tool-discipline.test.ts +0 -77
  310. package/plugins/bizar/tests/tools/agent-browser.test.ts +0 -98
  311. package/plugins/bizar/tests/tools/bg-collect.test.ts +0 -337
  312. package/plugins/bizar/tests/tools/bg-get-comments.test.ts +0 -485
  313. package/plugins/bizar/tests/tools/bg-kill.test.ts +0 -235
  314. package/plugins/bizar/tests/tools/bg-pause.test.ts +0 -61
  315. package/plugins/bizar/tests/tools/bg-report-progress.test.ts +0 -79
  316. package/plugins/bizar/tests/tools/bg-resume.test.ts +0 -40
  317. package/plugins/bizar/tests/tools/bg-send-message.test.ts +0 -116
  318. package/plugins/bizar/tests/tools/bg-spawn-delegation.test.ts +0 -147
  319. package/plugins/bizar/tests/tools/bg-spawn-http.test.ts +0 -233
  320. package/plugins/bizar/tests/tools/bg-spawn.test.ts +0 -311
  321. package/plugins/bizar/tests/tools/bg-status.test.ts +0 -217
  322. package/plugins/bizar/tests/tools/cline-runner.test.ts +0 -115
  323. package/plugins/bizar/tests/tools/plan-action.test.ts +0 -599
  324. package/plugins/bizar/tests/tools/read-glyph-feedback.test.ts +0 -253
  325. package/plugins/bizar/tests/tools/sandbox.test.ts +0 -117
  326. package/plugins/bizar/tests/tools/wait-for-feedback.test.ts +0 -390
  327. package/plugins/bizar/tests/update-deadlock.test.ts +0 -151
  328. package/plugins/bizar/tsconfig.json +0 -29
  329. package/scripts/mirror-agents-md.sh +0 -69
@@ -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
- });