@vellumai/assistant 0.6.5 → 0.6.6

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 (443) hide show
  1. package/AGENTS.md +9 -1
  2. package/ARCHITECTURE.md +15 -17
  3. package/Dockerfile +6 -4
  4. package/__tests__/permissions/gateway-threshold-reader.test.ts +283 -0
  5. package/docs/architecture/integrations.md +32 -39
  6. package/docs/architecture/memory.md +25 -30
  7. package/docs/architecture/security.md +7 -6
  8. package/docs/browser-use-architecture-phase2.md +63 -20
  9. package/docs/plugins.md +761 -0
  10. package/examples/plugins/echo/README.md +132 -0
  11. package/examples/plugins/echo/package.json +17 -0
  12. package/examples/plugins/echo/register.ts +187 -0
  13. package/node_modules/@vellumai/egress-proxy/src/types.ts +19 -0
  14. package/openapi.yaml +212 -68
  15. package/package.json +1 -1
  16. package/src/__tests__/app-compiler.test.ts +57 -0
  17. package/src/__tests__/approval-cascade.test.ts +7 -2
  18. package/src/__tests__/auto-analysis-end-to-end.test.ts +1 -0
  19. package/src/__tests__/avatar-generator.test.ts +4 -2
  20. package/src/__tests__/bundled-asset.test.ts +6 -6
  21. package/src/__tests__/catalog-cache.test.ts +69 -0
  22. package/src/__tests__/checker.test.ts +459 -171
  23. package/src/__tests__/circuit-breaker-pipeline.test.ts +406 -0
  24. package/src/__tests__/compaction-events.test.ts +501 -0
  25. package/src/__tests__/compaction-pipeline.test.ts +210 -0
  26. package/src/__tests__/compaction-strip-metadata-clear.test.ts +181 -0
  27. package/src/__tests__/compaction-timeout-recovery.test.ts +262 -0
  28. package/src/__tests__/config-model-image-provider.test.ts +110 -0
  29. package/src/__tests__/config-schema.test.ts +22 -9
  30. package/src/__tests__/config-watcher-cleanup-throttle.test.ts +0 -4
  31. package/src/__tests__/contacts-tools.test.ts +26 -0
  32. package/src/__tests__/context-overflow-policy.test.ts +7 -7
  33. package/src/__tests__/context-window-manager.test.ts +355 -4
  34. package/src/__tests__/conversation-abort-tool-results.test.ts +4 -1
  35. package/src/__tests__/conversation-agent-loop-overflow.test.ts +26 -30
  36. package/src/__tests__/conversation-agent-loop.test.ts +30 -141
  37. package/src/__tests__/conversation-confirmation-signals.test.ts +6 -1
  38. package/src/__tests__/conversation-history-web-search.test.ts +1 -0
  39. package/src/__tests__/conversation-init.benchmark.test.ts +2 -16
  40. package/src/__tests__/conversation-pairing.test.ts +174 -10
  41. package/src/__tests__/conversation-pre-run-repair.test.ts +4 -1
  42. package/src/__tests__/conversation-process-callsite.test.ts +3 -0
  43. package/src/__tests__/conversation-provider-retry-repair.test.ts +16 -7
  44. package/src/__tests__/conversation-queue.test.ts +29 -14
  45. package/src/__tests__/conversation-routes-disk-view.test.ts +7 -6
  46. package/src/__tests__/conversation-runtime-assembly.test.ts +155 -110
  47. package/src/__tests__/conversation-runtime-workspace.test.ts +23 -38
  48. package/src/__tests__/conversation-seed-composer.test.ts +2 -2
  49. package/src/__tests__/conversation-slash-queue.test.ts +7 -2
  50. package/src/__tests__/conversation-slash-unknown.test.ts +25 -2
  51. package/src/__tests__/conversation-speed-override.test.ts +6 -1
  52. package/src/__tests__/conversation-title-service.test.ts +116 -0
  53. package/src/__tests__/conversation-tool-setup-app-refresh.test.ts +41 -2
  54. package/src/__tests__/conversation-usage.test.ts +1 -1
  55. package/src/__tests__/conversation-workspace-cache-state.test.ts +4 -1
  56. package/src/__tests__/conversation-workspace-injection.test.ts +3 -0
  57. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +4 -1
  58. package/src/__tests__/credential-health-service.test.ts +78 -9
  59. package/src/__tests__/credential-security-invariants.test.ts +2 -2
  60. package/src/__tests__/db-schedule-syntax-migration.test.ts +1 -0
  61. package/src/__tests__/empty-response-pipeline.test.ts +305 -0
  62. package/src/__tests__/extension-id-sync-guard.test.ts +3 -3
  63. package/src/__tests__/first-greeting.test.ts +247 -5
  64. package/src/__tests__/headless-browser-mode.test.ts +57 -0
  65. package/src/__tests__/history-repair-pipeline.test.ts +399 -0
  66. package/src/__tests__/host-browser-e2e-cloud.test.ts +307 -0
  67. package/src/__tests__/host-browser-e2e-self-hosted.test.ts +3 -3
  68. package/src/__tests__/host-proxy-interface.test.ts +36 -2
  69. package/src/__tests__/image-credentials.test.ts +137 -0
  70. package/src/__tests__/image-service-dispatcher.test.ts +186 -0
  71. package/src/__tests__/injector-chain.test.ts +526 -0
  72. package/src/__tests__/intent-routing.test.ts +0 -26
  73. package/src/__tests__/llm-call-pipeline.test.ts +285 -0
  74. package/src/__tests__/llm-schema.test.ts +1 -1
  75. package/src/__tests__/media-generate-image.test.ts +119 -13
  76. package/src/__tests__/memory-retrieval-pipeline.test.ts +401 -0
  77. package/src/__tests__/memory-upsert-concurrency.test.ts +1 -0
  78. package/src/__tests__/migration-import-from-url.test.ts +5 -68
  79. package/src/__tests__/model-intents.test.ts +4 -2
  80. package/src/__tests__/notification-broadcaster.test.ts +3 -3
  81. package/src/__tests__/notification-decision-strategy.test.ts +0 -11
  82. package/src/__tests__/notification-schedule-notify-dedup.test.ts +108 -0
  83. package/src/__tests__/oauth-apps-routes.test.ts +1 -1
  84. package/src/__tests__/oauth-cli.test.ts +14 -12
  85. package/src/__tests__/oauth-connect-orchestrator.test.ts +4 -13
  86. package/src/__tests__/oauth-provider-serializer.test.ts +6 -4
  87. package/src/__tests__/oauth-provider-visibility.test.ts +3 -5
  88. package/src/__tests__/oauth-providers-routes.test.ts +3 -2
  89. package/src/__tests__/oauth-store.test.ts +41 -76
  90. package/src/__tests__/onboarding-template-contract.test.ts +16 -64
  91. package/src/__tests__/openai-image-service.test.ts +368 -0
  92. package/src/__tests__/overflow-reduce-pipeline.test.ts +676 -0
  93. package/src/__tests__/permission-checker-host-gate.test.ts +0 -24
  94. package/src/__tests__/persist-onboarding-artifacts.test.ts +266 -0
  95. package/src/__tests__/persistence-pipeline.test.ts +377 -0
  96. package/src/__tests__/pipeline-runner.test.ts +565 -0
  97. package/src/__tests__/platform.test.ts +5 -2
  98. package/src/__tests__/plugin-bootstrap.test.ts +483 -0
  99. package/src/__tests__/plugin-registry.test.ts +273 -0
  100. package/src/__tests__/plugin-route-contribution.test.ts +288 -0
  101. package/src/__tests__/plugin-skill-contribution.test.ts +367 -0
  102. package/src/__tests__/plugin-tool-contribution.test.ts +286 -0
  103. package/src/__tests__/plugin-types.test.ts +320 -0
  104. package/src/__tests__/pricing.test.ts +44 -12
  105. package/src/__tests__/proxy-approval-callback.test.ts +69 -8
  106. package/src/__tests__/reaction-persistence.test.ts +1 -0
  107. package/src/__tests__/regenerate-fire-and-forget-trace.test.ts +1 -0
  108. package/src/__tests__/registry.test.ts +0 -2
  109. package/src/__tests__/schedule-routes.test.ts +131 -1
  110. package/src/__tests__/scheduler-recurrence.test.ts +14 -70
  111. package/src/__tests__/scheduler-reuse-conversation.test.ts +10 -50
  112. package/src/__tests__/secret-detection-handler.test.ts +0 -10
  113. package/src/__tests__/shell-identity.test.ts +0 -134
  114. package/src/__tests__/suggestion-routes.test.ts +103 -4
  115. package/src/__tests__/task-memory-cleanup.test.ts +1 -0
  116. package/src/__tests__/task-scheduler.test.ts +3 -15
  117. package/src/__tests__/test-preload.ts +11 -0
  118. package/src/__tests__/title-generate-pipeline.test.ts +224 -0
  119. package/src/__tests__/token-estimate-pipeline.test.ts +431 -0
  120. package/src/__tests__/tool-error-pipeline.test.ts +244 -0
  121. package/src/__tests__/tool-execute-pipeline.test.ts +431 -0
  122. package/src/__tests__/tool-execution-pipeline.benchmark.test.ts +0 -6
  123. package/src/__tests__/tool-executor-shell-integration.test.ts +7 -10
  124. package/src/__tests__/tool-executor.test.ts +141 -0
  125. package/src/__tests__/tool-result-truncate-pipeline.test.ts +356 -0
  126. package/src/__tests__/tool-result-truncation.test.ts +0 -110
  127. package/src/__tests__/user-plugin-loader.test.ts +191 -0
  128. package/src/__tests__/workspace-migration-046-seed-conversation-starters-callsite.test.ts +185 -0
  129. package/src/__tests__/workspace-migration-049-release-notes-default-sonnet.test.ts +100 -0
  130. package/src/__tests__/workspace-migration-050-seed-main-agent-opus-callsite.test.ts +171 -0
  131. package/src/__tests__/workspace-migration-051-seed-conversation-summarization-callsite.test.ts +252 -0
  132. package/src/__tests__/workspace-migration-remove-hooks.test.ts +99 -0
  133. package/src/__tests__/workspace-policy.test.ts +21 -3
  134. package/src/agent/loop.ts +340 -102
  135. package/src/approvals/__tests__/guardian-feed-event.test.ts +304 -0
  136. package/src/approvals/guardian-request-resolvers.ts +80 -0
  137. package/src/backup/__tests__/backup-worker.test.ts +2 -13
  138. package/src/backup/backup-worker.ts +3 -15
  139. package/src/bundler/app-compiler.ts +84 -1
  140. package/src/calls/call-state.ts +2 -2
  141. package/src/channels/__tests__/types.test.ts +3 -3
  142. package/src/channels/types.ts +6 -4
  143. package/src/cli/__tests__/notifications.test.ts +87 -211
  144. package/src/cli/commands/__tests__/backup.test.ts +1 -1
  145. package/src/cli/commands/__tests__/image-generation.test.ts +255 -35
  146. package/src/cli/commands/__tests__/inference-send.test.ts +12 -0
  147. package/src/cli/commands/__tests__/tts-synthesize.test.ts +12 -0
  148. package/src/cli/commands/backup.ts +2 -2
  149. package/src/cli/commands/clients.ts +138 -0
  150. package/src/cli/commands/completions.ts +2 -9
  151. package/src/cli/commands/conversations.ts +55 -7
  152. package/src/cli/commands/image-generation.ts +33 -34
  153. package/src/cli/commands/notifications.ts +68 -103
  154. package/src/cli/commands/oauth/__tests__/providers-register.test.ts +1 -1
  155. package/src/cli/commands/oauth/__tests__/providers-update.test.ts +1 -1
  156. package/src/cli/commands/oauth/connect.ts +2 -2
  157. package/src/cli/commands/oauth/providers.ts +176 -8
  158. package/src/cli/commands/oauth/status.ts +46 -36
  159. package/src/cli/commands/skills.ts +3 -4
  160. package/src/cli/program.ts +25 -29
  161. package/src/config/__tests__/backup-schema.test.ts +7 -2
  162. package/src/config/bundled-skills/app-builder/SKILL.md +2 -2
  163. package/src/config/bundled-skills/app-builder/references/WIDGETS.md +10 -10
  164. package/src/config/bundled-skills/contacts/tools/contact-merge.ts +66 -87
  165. package/src/config/bundled-skills/contacts/tools/contact-search.ts +28 -51
  166. package/src/config/bundled-skills/contacts/tools/contact-upsert.ts +22 -40
  167. package/src/config/bundled-skills/image-studio/SKILL.md +2 -1
  168. package/src/config/bundled-skills/image-studio/TOOLS.json +2 -1
  169. package/src/config/bundled-skills/image-studio/tools/media-generate-image.ts +23 -39
  170. package/src/config/bundled-skills/messaging/SKILL.md +3 -3
  171. package/src/config/bundled-skills/messaging/tools/__tests__/messaging-feed-events.test.ts +207 -0
  172. package/src/config/bundled-skills/messaging/tools/messaging-archive-by-sender.ts +12 -0
  173. package/src/config/bundled-skills/messaging/tools/messaging-send.ts +58 -0
  174. package/src/config/bundled-skills/schedule/SKILL.md +8 -3
  175. package/src/config/bundled-skills/schedule/TOOLS.json +15 -7
  176. package/src/config/bundled-skills/schedule/references/SCRIPT_MODE_PATTERNS.md +59 -0
  177. package/src/config/bundled-tool-registry.ts +0 -15
  178. package/src/config/feature-flag-registry.json +17 -1
  179. package/src/config/schema.ts +19 -0
  180. package/src/config/schemas/backup.ts +1 -1
  181. package/src/config/schemas/conversations.ts +16 -0
  182. package/src/config/schemas/llm.ts +2 -3
  183. package/src/config/schemas/security.ts +6 -6
  184. package/src/config/schemas/tts.ts +11 -0
  185. package/src/config/skill-state.ts +6 -2
  186. package/src/config/skills.ts +94 -5
  187. package/src/context/__tests__/compact-prompt.test.ts +27 -9
  188. package/src/context/prompts/compact.md +26 -12
  189. package/src/context/tool-result-truncation.ts +3 -63
  190. package/src/context/window-manager.ts +190 -16
  191. package/src/credential-health/credential-health-service.ts +19 -6
  192. package/src/daemon/__tests__/conversation-feed-event.test.ts +317 -0
  193. package/src/daemon/__tests__/conversation-lifecycle-auto-analyze.test.ts +4 -12
  194. package/src/daemon/__tests__/conversation-tool-setup.test.ts +14 -15
  195. package/src/daemon/config-watcher.ts +0 -2
  196. package/src/daemon/context-overflow-policy.ts +4 -13
  197. package/src/daemon/conversation-agent-loop-handlers.ts +83 -22
  198. package/src/daemon/conversation-agent-loop.ts +984 -683
  199. package/src/daemon/conversation-history.ts +10 -19
  200. package/src/daemon/conversation-lifecycle.ts +37 -19
  201. package/src/daemon/conversation-notifiers.ts +2 -110
  202. package/src/daemon/conversation-process.ts +14 -7
  203. package/src/daemon/conversation-runtime-assembly.ts +532 -411
  204. package/src/daemon/conversation-tool-setup.ts +41 -4
  205. package/src/daemon/conversation.ts +80 -35
  206. package/src/daemon/external-plugins-bootstrap.ts +478 -0
  207. package/src/daemon/first-greeting.ts +191 -14
  208. package/src/daemon/handlers/config-model.ts +11 -0
  209. package/src/daemon/handlers/skills.ts +5 -1
  210. package/src/daemon/lifecycle.ts +33 -68
  211. package/src/daemon/message-types/computer-use.ts +2 -34
  212. package/src/daemon/message-types/conversations.ts +49 -0
  213. package/src/daemon/message-types/messages.ts +12 -0
  214. package/src/daemon/server.ts +5 -3
  215. package/src/daemon/shutdown-handlers.ts +2 -12
  216. package/src/daemon/tool-side-effects.ts +14 -56
  217. package/src/heartbeat/__tests__/heartbeat-feed-event.test.ts +160 -0
  218. package/src/heartbeat/heartbeat-service.ts +24 -1
  219. package/src/home/__tests__/feed-population-integration.test.ts +312 -0
  220. package/src/home/emit-feed-event.ts +7 -0
  221. package/src/home/feed-types.ts +41 -2
  222. package/src/home/rewrite-command-preview.ts +66 -0
  223. package/src/ipc/__tests__/socket-path.test.ts +11 -50
  224. package/src/ipc/cli-client.ts +1 -1
  225. package/src/ipc/cli-server.ts +3 -3
  226. package/src/ipc/gateway-client.ts +4 -1
  227. package/src/ipc/routes/browser-context.ts +2 -0
  228. package/src/ipc/routes/browser.ts +1 -0
  229. package/src/ipc/routes/get-contact.ts +16 -0
  230. package/src/ipc/routes/index.ts +14 -0
  231. package/src/ipc/routes/list-clients.ts +31 -0
  232. package/src/ipc/routes/merge-contacts.ts +17 -0
  233. package/src/ipc/routes/notification.ts +133 -0
  234. package/src/ipc/routes/rename-conversation.ts +59 -0
  235. package/src/ipc/routes/search-contacts.ts +19 -0
  236. package/src/ipc/routes/upsert-contact.ts +25 -0
  237. package/src/ipc/socket-path.ts +14 -38
  238. package/src/media/app-icon-generator.ts +23 -46
  239. package/src/media/avatar-router.ts +26 -41
  240. package/src/media/gemini-image-service.ts +8 -41
  241. package/src/media/image-credentials.ts +73 -0
  242. package/src/media/image-service.ts +85 -0
  243. package/src/media/openai-image-service.ts +131 -0
  244. package/src/media/types.ts +46 -0
  245. package/src/memory/conversation-crud.ts +48 -18
  246. package/src/memory/conversation-queries.ts +57 -4
  247. package/src/memory/conversation-title-service.ts +25 -0
  248. package/src/memory/db-init.ts +8 -0
  249. package/src/memory/embedding-gemini.test.ts +41 -2
  250. package/src/memory/embedding-gemini.ts +6 -1
  251. package/src/memory/graph/bootstrap.test.ts +282 -0
  252. package/src/memory/graph/bootstrap.ts +8 -5
  253. package/src/memory/graph/extraction.ts +10 -2
  254. package/src/memory/graph/graph-search.test.ts +1 -0
  255. package/src/memory/graph/inspect.ts +2 -2
  256. package/src/memory/graph/retriever.ts +10 -3
  257. package/src/memory/migrations/041-approval-prompt-ts-tracker.ts +26 -0
  258. package/src/memory/migrations/149-oauth-tables.ts +1 -0
  259. package/src/memory/migrations/223-schedule-script-column.ts +11 -0
  260. package/src/memory/migrations/224-oauth-providers-managed-service-is-paid.ts +24 -0
  261. package/src/memory/migrations/225-oauth-providers-available-scopes.ts +13 -0
  262. package/src/memory/migrations/index.ts +4 -0
  263. package/src/memory/pkb/pkb-index.test.ts +1 -0
  264. package/src/memory/pkb/pkb-reconcile.test.ts +1 -0
  265. package/src/memory/pkb/pkb-search.test.ts +65 -4
  266. package/src/memory/pkb/pkb-search.ts +40 -18
  267. package/src/memory/qdrant-client.test.ts +60 -0
  268. package/src/memory/qdrant-client.ts +25 -0
  269. package/src/memory/schema/infrastructure.ts +1 -0
  270. package/src/memory/schema/oauth.ts +4 -1
  271. package/src/messaging/providers/slack/render-transcript.test.ts +77 -29
  272. package/src/messaging/providers/slack/render-transcript.ts +58 -0
  273. package/src/notifications/conversation-pairing.ts +78 -19
  274. package/src/notifications/copy-composer.ts +0 -5
  275. package/src/notifications/emit-signal.ts +1 -1
  276. package/src/notifications/signal.ts +1 -2
  277. package/src/oauth/AGENTS.md +1 -1
  278. package/src/oauth/__tests__/identity-verifier.test.ts +2 -1
  279. package/src/oauth/connect-orchestrator.ts +8 -34
  280. package/src/oauth/connect-types.ts +6 -10
  281. package/src/oauth/manual-token-connection.ts +23 -0
  282. package/src/oauth/oauth-store.ts +30 -14
  283. package/src/oauth/provider-serializer.ts +6 -1
  284. package/src/oauth/seed-providers.ts +56 -108
  285. package/src/outbound-proxy/http-forwarder.ts +9 -0
  286. package/src/permissions/approval-policy.test.ts +293 -18
  287. package/src/permissions/approval-policy.ts +110 -58
  288. package/src/permissions/arg-parser.test.ts +161 -0
  289. package/src/permissions/arg-parser.ts +141 -0
  290. package/src/permissions/bash-risk-classifier.test.ts +414 -2
  291. package/src/permissions/bash-risk-classifier.ts +303 -60
  292. package/src/permissions/checker.ts +157 -29
  293. package/src/permissions/command-registry.test.ts +239 -0
  294. package/src/permissions/command-registry.ts +234 -54
  295. package/src/permissions/defaults.ts +5 -4
  296. package/src/permissions/gateway-threshold-reader.ts +196 -0
  297. package/src/permissions/prompter.ts +4 -0
  298. package/src/permissions/risk-types.ts +61 -4
  299. package/src/permissions/schedule-risk-classifier.test.ts +129 -0
  300. package/src/permissions/schedule-risk-classifier.ts +85 -0
  301. package/src/permissions/shell-identity.ts +2 -42
  302. package/src/permissions/types.ts +2 -0
  303. package/src/permissions/workspace-policy.ts +8 -3
  304. package/src/plugins/defaults/circuit-breaker.ts +146 -0
  305. package/src/plugins/defaults/compaction.ts +145 -0
  306. package/src/plugins/defaults/empty-response.ts +126 -0
  307. package/src/plugins/defaults/history-repair.ts +85 -0
  308. package/src/plugins/defaults/index.ts +116 -0
  309. package/src/plugins/defaults/injectors.ts +491 -0
  310. package/src/plugins/defaults/llm-call.ts +82 -0
  311. package/src/plugins/defaults/memory-retrieval.ts +226 -0
  312. package/src/plugins/defaults/overflow-reduce.ts +181 -0
  313. package/src/plugins/defaults/persistence.ts +129 -0
  314. package/src/plugins/defaults/title-generate.ts +95 -0
  315. package/src/plugins/defaults/token-estimate.ts +104 -0
  316. package/src/plugins/defaults/tool-error.ts +126 -0
  317. package/src/plugins/defaults/tool-execute.ts +89 -0
  318. package/src/plugins/defaults/tool-result-truncate.ts +88 -0
  319. package/src/plugins/pipeline.ts +316 -0
  320. package/src/plugins/plugin-skill-contributions.ts +292 -0
  321. package/src/plugins/registry.ts +241 -0
  322. package/src/plugins/types.ts +1134 -0
  323. package/src/plugins/user-loader.ts +177 -0
  324. package/src/prompts/templates/BOOTSTRAP.md +27 -77
  325. package/src/providers/model-catalog.ts +52 -29
  326. package/src/providers/model-intents.ts +1 -1
  327. package/src/providers/openrouter/client.ts +5 -1
  328. package/src/providers/speech-to-text/deepgram-realtime.test.ts +61 -0
  329. package/src/providers/speech-to-text/deepgram-realtime.ts +57 -0
  330. package/src/providers/speech-to-text/xai-realtime.test.ts +72 -4
  331. package/src/providers/speech-to-text/xai-realtime.ts +39 -14
  332. package/src/runtime/AGENTS.md +25 -16
  333. package/src/runtime/__tests__/browser-extension-pair-routes.test.ts +3 -3
  334. package/src/runtime/__tests__/client-registry.test.ts +293 -0
  335. package/src/runtime/client-registry.ts +261 -0
  336. package/src/runtime/http-server.ts +77 -8
  337. package/src/runtime/http-types.ts +0 -2
  338. package/src/runtime/migrations/vbundle-builder.ts +1 -22
  339. package/src/runtime/routes/approval-prompt-ts-tracker.ts +51 -31
  340. package/src/runtime/routes/approval-routes.ts +17 -0
  341. package/src/runtime/routes/browser-extension-pair-routes.ts +27 -8
  342. package/src/runtime/routes/conversation-routes.ts +223 -116
  343. package/src/runtime/routes/inbound-message-handler.ts +88 -13
  344. package/src/runtime/routes/memory-item-routes.test.ts +1 -0
  345. package/src/runtime/routes/migration-routes.ts +0 -3
  346. package/src/runtime/routes/playground/__tests__/force-compact.test.ts +284 -0
  347. package/src/runtime/routes/playground/__tests__/guard.test.ts +80 -0
  348. package/src/runtime/routes/playground/__tests__/inject-failures.test.ts +294 -0
  349. package/src/runtime/routes/playground/__tests__/reset-circuit.test.ts +271 -0
  350. package/src/runtime/routes/playground/__tests__/seed-conversation.test.ts +202 -0
  351. package/src/runtime/routes/playground/__tests__/seeded-conversations.test.ts +309 -0
  352. package/src/runtime/routes/playground/__tests__/state.test.ts +224 -0
  353. package/src/runtime/routes/playground/conversation-not-found.ts +29 -0
  354. package/src/runtime/routes/playground/deps.ts +56 -0
  355. package/src/runtime/routes/playground/force-compact.ts +73 -0
  356. package/src/runtime/routes/playground/guard.ts +37 -0
  357. package/src/runtime/routes/playground/index.ts +28 -0
  358. package/src/runtime/routes/playground/inject-failures.ts +159 -0
  359. package/src/runtime/routes/playground/reset-circuit.ts +115 -0
  360. package/src/runtime/routes/playground/seed-conversation.ts +139 -0
  361. package/src/runtime/routes/playground/seeded-conversations.ts +78 -0
  362. package/src/runtime/routes/playground/state.ts +78 -0
  363. package/src/runtime/routes/schedule-routes.ts +89 -8
  364. package/src/runtime/skill-route-registry.ts +75 -15
  365. package/src/schedule/run-script.ts +68 -0
  366. package/src/schedule/schedule-store.ts +7 -1
  367. package/src/schedule/scheduler.ts +48 -8
  368. package/src/skills/catalog-cache.ts +12 -5
  369. package/src/tools/browser/__tests__/browser-status.test.ts +189 -0
  370. package/src/tools/browser/browser-execution.ts +88 -19
  371. package/src/tools/browser/cdp-client/__tests__/extension-cdp-client.test.ts +230 -0
  372. package/src/tools/browser/cdp-client/__tests__/factory.test.ts +146 -3
  373. package/src/tools/browser/cdp-client/extension-cdp-client.ts +54 -3
  374. package/src/tools/browser/cdp-client/factory.ts +15 -4
  375. package/src/tools/executor.ts +126 -74
  376. package/src/tools/network/script-proxy/session-manager.ts +37 -1
  377. package/src/tools/permission-checker.ts +98 -49
  378. package/src/tools/policy-context.ts +4 -0
  379. package/src/tools/registry.ts +140 -3
  380. package/src/tools/schedule/create.ts +23 -8
  381. package/src/tools/schedule/update.ts +3 -1
  382. package/src/tools/secret-detection-handler.ts +0 -51
  383. package/src/tools/system/avatar-generator.ts +6 -2
  384. package/src/tools/types.ts +28 -2
  385. package/src/util/platform.ts +7 -2
  386. package/src/util/pricing.ts +26 -3
  387. package/src/workspace/migrations/006-services-config.ts +2 -4
  388. package/src/workspace/migrations/022-move-hooks-to-workspace.ts +2 -3
  389. package/src/workspace/migrations/041-backfill-google-gmail-settings-scope.ts +3 -4
  390. package/src/workspace/migrations/046-seed-conversation-starters-callsite.ts +108 -0
  391. package/src/workspace/migrations/047-remove-watch-callsites.ts +54 -0
  392. package/src/workspace/migrations/048-remove-workspace-hooks.ts +81 -0
  393. package/src/workspace/migrations/049-release-notes-default-sonnet.ts +80 -0
  394. package/src/workspace/migrations/050-seed-main-agent-opus-callsite.ts +86 -0
  395. package/src/workspace/migrations/051-seed-conversation-summarization-callsite.ts +128 -0
  396. package/src/workspace/migrations/registry.ts +12 -0
  397. package/tsconfig.json +1 -1
  398. package/hook-templates/debug-prompt-logger/hook.json +0 -7
  399. package/hook-templates/debug-prompt-logger/run.sh +0 -66
  400. package/src/__tests__/compaction-circuit-breaker.test.ts +0 -336
  401. package/src/__tests__/context-overflow-approval.test.ts +0 -156
  402. package/src/__tests__/hooks-blocking.test.ts +0 -178
  403. package/src/__tests__/hooks-cli.test.ts +0 -182
  404. package/src/__tests__/hooks-config.test.ts +0 -108
  405. package/src/__tests__/hooks-discovery.test.ts +0 -211
  406. package/src/__tests__/hooks-integration.test.ts +0 -196
  407. package/src/__tests__/hooks-manager.test.ts +0 -226
  408. package/src/__tests__/hooks-runner.test.ts +0 -175
  409. package/src/__tests__/hooks-settings.test.ts +0 -160
  410. package/src/__tests__/hooks-templates.test.ts +0 -169
  411. package/src/__tests__/hooks-ts-runner.test.ts +0 -170
  412. package/src/__tests__/hooks-watch.test.ts +0 -112
  413. package/src/__tests__/notification-schedule-dedup.test.ts +0 -213
  414. package/src/__tests__/oauth-scope-policy.test.ts +0 -180
  415. package/src/__tests__/send-notification-tool.test.ts +0 -83
  416. package/src/cli/commands/shotgun.ts +0 -266
  417. package/src/config/bundled-skills/conversations/SKILL.md +0 -20
  418. package/src/config/bundled-skills/conversations/TOOLS.json +0 -23
  419. package/src/config/bundled-skills/conversations/tools/rename-conversation.ts +0 -88
  420. package/src/config/bundled-skills/heartbeat/SKILL.md +0 -43
  421. package/src/config/bundled-skills/notifications/SKILL.md +0 -40
  422. package/src/config/bundled-skills/notifications/TOOLS.json +0 -80
  423. package/src/config/bundled-skills/notifications/tools/send-notification.ts +0 -152
  424. package/src/config/bundled-skills/notifications/tools/shared.ts +0 -13
  425. package/src/config/bundled-skills/screen-watch/SKILL.md +0 -27
  426. package/src/config/bundled-skills/screen-watch/TOOLS.json +0 -35
  427. package/src/config/bundled-skills/screen-watch/tools/start-screen-watch.ts +0 -12
  428. package/src/config/bundled-skills/skills-catalog/SKILL.md +0 -84
  429. package/src/daemon/context-overflow-approval.ts +0 -52
  430. package/src/daemon/watch-handler.ts +0 -399
  431. package/src/hooks/cli.ts +0 -253
  432. package/src/hooks/config.ts +0 -100
  433. package/src/hooks/discovery.ts +0 -135
  434. package/src/hooks/manager.ts +0 -179
  435. package/src/hooks/runner.ts +0 -117
  436. package/src/hooks/templates.ts +0 -77
  437. package/src/hooks/types.ts +0 -75
  438. package/src/oauth/scope-policy.ts +0 -89
  439. package/src/runtime/gateway-internal-client.ts +0 -94
  440. package/src/runtime/routes/watch-routes.ts +0 -156
  441. package/src/signals/shotgun.ts +0 -203
  442. package/src/tools/watch/screen-watch.ts +0 -144
  443. package/src/tools/watch/watch-state.ts +0 -142
@@ -1,211 +0,0 @@
1
- import { chmodSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
2
- import { tmpdir } from "node:os";
3
- import { join } from "node:path";
4
- import { afterEach, beforeEach, describe, expect, test } from "bun:test";
5
-
6
- import { saveHooksConfig } from "../hooks/config.js";
7
- import { discoverHooks } from "../hooks/discovery.js";
8
-
9
- // Set VELLUM_WORKSPACE_DIR before importing modules that use platform helpers
10
- const testDir = join(tmpdir(), `hooks-discovery-test-${Date.now()}`);
11
- process.env.VELLUM_WORKSPACE_DIR = testDir;
12
-
13
- function createHook(
14
- hooksDir: string,
15
- name: string,
16
- manifest: Record<string, unknown>,
17
- scriptContent = "#!/bin/bash\nexit 0",
18
- ): void {
19
- const hookDir = join(hooksDir, name);
20
- mkdirSync(hookDir, { recursive: true });
21
- writeFileSync(join(hookDir, "hook.json"), JSON.stringify(manifest));
22
- const scriptName = (manifest.script as string) ?? "run.sh";
23
- const scriptPath = join(hookDir, scriptName);
24
- writeFileSync(scriptPath, scriptContent);
25
- chmodSync(scriptPath, 0o755);
26
- }
27
-
28
- describe("Hooks Discovery", () => {
29
- let hooksDir: string;
30
-
31
- beforeEach(() => {
32
- hooksDir = join(testDir, "hooks");
33
- mkdirSync(hooksDir, { recursive: true });
34
- });
35
-
36
- afterEach(() => {
37
- rmSync(testDir, { recursive: true, force: true });
38
- });
39
-
40
- test("returns empty array when no hooks exist", () => {
41
- const hooks = discoverHooks(hooksDir);
42
- expect(hooks).toEqual([]);
43
- });
44
-
45
- test("discovers a valid hook", () => {
46
- createHook(hooksDir, "my-hook", {
47
- name: "my-hook",
48
- description: "Test hook",
49
- version: "1.0.0",
50
- events: ["pre-tool-execute"],
51
- script: "run.sh",
52
- });
53
-
54
- const hooks = discoverHooks(hooksDir);
55
- expect(hooks).toHaveLength(1);
56
- expect(hooks[0].name).toBe("my-hook");
57
- expect(hooks[0].manifest.events).toEqual(["pre-tool-execute"]);
58
- expect(hooks[0].enabled).toBe(false);
59
- });
60
-
61
- test("discovers multiple hooks sorted alphabetically", () => {
62
- createHook(hooksDir, "zebra-hook", {
63
- name: "zebra-hook",
64
- description: "Z hook",
65
- version: "1.0.0",
66
- events: ["on-error"],
67
- script: "run.sh",
68
- });
69
- createHook(hooksDir, "alpha-hook", {
70
- name: "alpha-hook",
71
- description: "A hook",
72
- version: "1.0.0",
73
- events: ["post-message"],
74
- script: "run.sh",
75
- });
76
-
77
- const hooks = discoverHooks(hooksDir);
78
- expect(hooks).toHaveLength(2);
79
- expect(hooks[0].name).toBe("alpha-hook");
80
- expect(hooks[1].name).toBe("zebra-hook");
81
- });
82
-
83
- test("skips directory without hook.json", () => {
84
- mkdirSync(join(hooksDir, "no-manifest"), { recursive: true });
85
- writeFileSync(
86
- join(hooksDir, "no-manifest", "run.sh"),
87
- "#!/bin/bash\nexit 0",
88
- );
89
-
90
- const hooks = discoverHooks(hooksDir);
91
- expect(hooks).toEqual([]);
92
- });
93
-
94
- test("skips hook with invalid JSON in manifest", () => {
95
- const hookDir = join(hooksDir, "bad-json");
96
- mkdirSync(hookDir, { recursive: true });
97
- writeFileSync(join(hookDir, "hook.json"), "NOT JSON {{{");
98
- writeFileSync(join(hookDir, "run.sh"), "#!/bin/bash\nexit 0");
99
-
100
- const hooks = discoverHooks(hooksDir);
101
- expect(hooks).toEqual([]);
102
- });
103
-
104
- test("skips hook with missing required fields", () => {
105
- createHook(hooksDir, "missing-fields", {
106
- name: "missing-fields",
107
- // missing events and script
108
- });
109
-
110
- const hooks = discoverHooks(hooksDir);
111
- expect(hooks).toEqual([]);
112
- });
113
-
114
- test("skips hook with invalid event names", () => {
115
- createHook(hooksDir, "bad-events", {
116
- name: "bad-events",
117
- description: "Bad",
118
- version: "1.0.0",
119
- events: ["not-a-real-event"],
120
- script: "run.sh",
121
- });
122
-
123
- const hooks = discoverHooks(hooksDir);
124
- expect(hooks).toEqual([]);
125
- });
126
-
127
- test("skips hook with missing script file", () => {
128
- const hookDir = join(hooksDir, "no-script");
129
- mkdirSync(hookDir, { recursive: true });
130
- writeFileSync(
131
- join(hookDir, "hook.json"),
132
- JSON.stringify({
133
- name: "no-script",
134
- description: "Missing script",
135
- version: "1.0.0",
136
- events: ["on-error"],
137
- script: "nonexistent.sh",
138
- }),
139
- );
140
-
141
- const hooks = discoverHooks(hooksDir);
142
- expect(hooks).toEqual([]);
143
- });
144
-
145
- test("respects enabled state from config", () => {
146
- createHook(hooksDir, "enabled-hook", {
147
- name: "enabled-hook",
148
- description: "Enabled",
149
- version: "1.0.0",
150
- events: ["pre-tool-execute"],
151
- script: "run.sh",
152
- });
153
-
154
- saveHooksConfig({
155
- version: 1,
156
- hooks: { "enabled-hook": { enabled: true } },
157
- });
158
-
159
- const hooks = discoverHooks(hooksDir);
160
- expect(hooks).toHaveLength(1);
161
- expect(hooks[0].enabled).toBe(true);
162
- });
163
-
164
- test("defaults to disabled when not in config", () => {
165
- createHook(hooksDir, "unconfigured", {
166
- name: "unconfigured",
167
- description: "Not in config",
168
- version: "1.0.0",
169
- events: ["on-error"],
170
- script: "run.sh",
171
- });
172
-
173
- const hooks = discoverHooks(hooksDir);
174
- expect(hooks[0].enabled).toBe(false);
175
- });
176
-
177
- test("returns empty for nonexistent hooks directory", () => {
178
- const hooks = discoverHooks("/nonexistent/path");
179
- expect(hooks).toEqual([]);
180
- });
181
-
182
- test("skips non-directory entries", () => {
183
- writeFileSync(join(hooksDir, "some-file.txt"), "not a directory");
184
-
185
- createHook(hooksDir, "valid-hook", {
186
- name: "valid-hook",
187
- description: "Valid",
188
- version: "1.0.0",
189
- events: ["on-error"],
190
- script: "run.sh",
191
- });
192
-
193
- const hooks = discoverHooks(hooksDir);
194
- expect(hooks).toHaveLength(1);
195
- expect(hooks[0].name).toBe("valid-hook");
196
- });
197
-
198
- test("hook with multiple events is discovered", () => {
199
- createHook(hooksDir, "multi-event", {
200
- name: "multi-event",
201
- description: "Multi",
202
- version: "1.0.0",
203
- events: ["pre-tool-execute", "post-tool-execute", "on-error"],
204
- script: "run.sh",
205
- });
206
-
207
- const hooks = discoverHooks(hooksDir);
208
- expect(hooks).toHaveLength(1);
209
- expect(hooks[0].manifest.events).toHaveLength(3);
210
- });
211
- });
@@ -1,196 +0,0 @@
1
- import {
2
- chmodSync,
3
- mkdirSync,
4
- readFileSync,
5
- rmSync,
6
- writeFileSync,
7
- } from "node:fs";
8
- import { tmpdir } from "node:os";
9
- import { join } from "node:path";
10
- import { afterEach, beforeEach, describe, expect, test } from "bun:test";
11
-
12
- // Set VELLUM_WORKSPACE_DIR before importing modules that use getWorkspaceDir()
13
- const testDir = join(tmpdir(), `hooks-integration-test-${Date.now()}`);
14
- process.env.VELLUM_WORKSPACE_DIR = testDir;
15
-
16
- import { saveHooksConfig } from "../hooks/config.js";
17
- import { HookManager, resetHookManager } from "../hooks/manager.js";
18
-
19
- function createHook(
20
- hooksDir: string,
21
- name: string,
22
- events: string[],
23
- scriptContent: string,
24
- ): void {
25
- const hookDir = join(hooksDir, name);
26
- mkdirSync(hookDir, { recursive: true });
27
- writeFileSync(
28
- join(hookDir, "hook.json"),
29
- JSON.stringify({
30
- name,
31
- description: `Integration test hook: ${name}`,
32
- version: "1.0.0",
33
- events,
34
- script: "run.sh",
35
- }),
36
- );
37
- const scriptPath = join(hookDir, "run.sh");
38
- writeFileSync(scriptPath, scriptContent);
39
- chmodSync(scriptPath, 0o755);
40
- }
41
-
42
- describe("Hooks Integration", () => {
43
- let hooksDir: string;
44
-
45
- beforeEach(() => {
46
- hooksDir = join(testDir, "hooks");
47
- mkdirSync(hooksDir, { recursive: true });
48
- resetHookManager();
49
- });
50
-
51
- afterEach(() => {
52
- resetHookManager();
53
- rmSync(testDir, { recursive: true, force: true });
54
- });
55
-
56
- test("hook receives event data via stdin", async () => {
57
- const outputFile = join(testDir, "stdin-data.json");
58
- createHook(
59
- hooksDir,
60
- "stdin-capture",
61
- ["pre-tool-execute"],
62
- `#!/bin/bash\ncat > "${outputFile}"`,
63
- );
64
- saveHooksConfig({
65
- version: 1,
66
- hooks: { "stdin-capture": { enabled: true } },
67
- });
68
-
69
- const manager = new HookManager();
70
- manager.initialize();
71
-
72
- await manager.trigger("pre-tool-execute", {
73
- toolName: "bash",
74
- command: "ls -la",
75
- riskLevel: "medium",
76
- });
77
-
78
- // Wait for file write to complete
79
- await new Promise((r) => setTimeout(r, 200));
80
- const data = JSON.parse(readFileSync(outputFile, "utf-8"));
81
- expect(data.event).toBe("pre-tool-execute");
82
- expect(data.toolName).toBe("bash");
83
- expect(data.command).toBe("ls -la");
84
- });
85
-
86
- test("hook receives environment variables", async () => {
87
- const outputFile = join(testDir, "env-data.txt");
88
- createHook(
89
- hooksDir,
90
- "env-capture",
91
- ["daemon-start"],
92
- `#!/bin/bash\necho "$VELLUM_HOOK_EVENT|$VELLUM_HOOK_NAME|$VELLUM_WORKSPACE_DIR" > "${outputFile}"`,
93
- );
94
- saveHooksConfig({
95
- version: 1,
96
- hooks: { "env-capture": { enabled: true } },
97
- });
98
-
99
- const manager = new HookManager();
100
- manager.initialize();
101
-
102
- await manager.trigger("daemon-start", { pid: 12345 });
103
-
104
- await new Promise((r) => setTimeout(r, 200));
105
- const output = readFileSync(outputFile, "utf-8").trim();
106
- const parts = output.split("|");
107
- expect(parts[0]).toBe("daemon-start");
108
- expect(parts[1]).toBe("env-capture");
109
- expect(parts[2]).toBe(testDir);
110
- });
111
-
112
- test("multiple hooks for same event run in order", async () => {
113
- const outputFile = join(testDir, "order.txt");
114
- createHook(
115
- hooksDir,
116
- "hook-c",
117
- ["on-error"],
118
- `#!/bin/bash\necho "c" >> "${outputFile}"`,
119
- );
120
- createHook(
121
- hooksDir,
122
- "hook-a",
123
- ["on-error"],
124
- `#!/bin/bash\necho "a" >> "${outputFile}"`,
125
- );
126
- createHook(
127
- hooksDir,
128
- "hook-b",
129
- ["on-error"],
130
- `#!/bin/bash\necho "b" >> "${outputFile}"`,
131
- );
132
- saveHooksConfig({
133
- version: 1,
134
- hooks: {
135
- "hook-a": { enabled: true },
136
- "hook-b": { enabled: true },
137
- "hook-c": { enabled: true },
138
- },
139
- });
140
-
141
- const manager = new HookManager();
142
- manager.initialize();
143
-
144
- await manager.trigger("on-error", { message: "test error" });
145
-
146
- await new Promise((r) => setTimeout(r, 200));
147
- const lines = readFileSync(outputFile, "utf-8").trim().split("\n");
148
- expect(lines).toEqual(["a", "b", "c"]);
149
- });
150
-
151
- test("hook failure does not prevent subsequent hooks", async () => {
152
- const outputFile = join(testDir, "after-failure.txt");
153
- createHook(hooksDir, "hook-fail", ["post-message"], "#!/bin/bash\nexit 1");
154
- createHook(
155
- hooksDir,
156
- "hook-success",
157
- ["post-message"],
158
- `#!/bin/bash\necho "ran" > "${outputFile}"`,
159
- );
160
- saveHooksConfig({
161
- version: 1,
162
- hooks: {
163
- "hook-fail": { enabled: true },
164
- "hook-success": { enabled: true },
165
- },
166
- });
167
-
168
- const manager = new HookManager();
169
- manager.initialize();
170
-
171
- await manager.trigger("post-message", {});
172
-
173
- await new Promise((r) => setTimeout(r, 200));
174
- const output = readFileSync(outputFile, "utf-8").trim();
175
- expect(output).toBe("ran");
176
- });
177
-
178
- test("disabled hooks are not triggered", async () => {
179
- const outputFile = join(testDir, "disabled.txt");
180
- createHook(
181
- hooksDir,
182
- "disabled-hook",
183
- ["pre-message"],
184
- `#!/bin/bash\necho "should not run" > "${outputFile}"`,
185
- );
186
- // Not enabled in config (defaults to disabled)
187
-
188
- const manager = new HookManager();
189
- manager.initialize();
190
-
191
- await manager.trigger("pre-message", {});
192
-
193
- await new Promise((r) => setTimeout(r, 200));
194
- expect(() => readFileSync(outputFile, "utf-8")).toThrow();
195
- });
196
- });
@@ -1,226 +0,0 @@
1
- import { chmodSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
2
- import { tmpdir } from "node:os";
3
- import { join } from "node:path";
4
- import { afterEach, beforeEach, describe, expect, test } from "bun:test";
5
-
6
- // Set VELLUM_WORKSPACE_DIR before importing modules that use getWorkspaceDir()
7
- const testDir = join(tmpdir(), `hooks-manager-test-${Date.now()}`);
8
- process.env.VELLUM_WORKSPACE_DIR = testDir;
9
-
10
- import { saveHooksConfig } from "../hooks/config.js";
11
- import {
12
- getHookManager,
13
- HookManager,
14
- resetHookManager,
15
- } from "../hooks/manager.js";
16
-
17
- function createHook(
18
- hooksDir: string,
19
- name: string,
20
- events: string[],
21
- scriptContent = "#!/bin/bash\nexit 0",
22
- ): void {
23
- const hookDir = join(hooksDir, name);
24
- mkdirSync(hookDir, { recursive: true });
25
- writeFileSync(
26
- join(hookDir, "hook.json"),
27
- JSON.stringify({
28
- name,
29
- description: `Test hook ${name}`,
30
- version: "1.0.0",
31
- events,
32
- script: "run.sh",
33
- }),
34
- );
35
- const scriptPath = join(hookDir, "run.sh");
36
- writeFileSync(scriptPath, scriptContent);
37
- chmodSync(scriptPath, 0o755);
38
- }
39
-
40
- describe("HookManager", () => {
41
- let hooksDir: string;
42
-
43
- beforeEach(() => {
44
- hooksDir = join(testDir, "hooks");
45
- mkdirSync(hooksDir, { recursive: true });
46
- resetHookManager();
47
- });
48
-
49
- afterEach(() => {
50
- resetHookManager();
51
- rmSync(testDir, { recursive: true, force: true });
52
- });
53
-
54
- test("initialize discovers hooks", () => {
55
- createHook(hooksDir, "test-hook", ["on-error"]);
56
- saveHooksConfig({ version: 1, hooks: { "test-hook": { enabled: true } } });
57
-
58
- const manager = new HookManager();
59
- manager.initialize();
60
- expect(manager.getDiscoveredHooks()).toHaveLength(1);
61
- expect(manager.getDiscoveredHooks()[0].name).toBe("test-hook");
62
- });
63
-
64
- test("initialize returns empty when no hooks", () => {
65
- const manager = new HookManager();
66
- manager.initialize();
67
- expect(manager.getDiscoveredHooks()).toHaveLength(0);
68
- });
69
-
70
- test("trigger does nothing for event with no hooks", async () => {
71
- const manager = new HookManager();
72
- manager.initialize();
73
- // Should not throw
74
- await manager.trigger("on-error", {});
75
- });
76
-
77
- test("trigger runs enabled hooks for matching event", async () => {
78
- createHook(
79
- hooksDir,
80
- "log-hook",
81
- ["pre-tool-execute"],
82
- '#!/bin/bash\necho "executed"',
83
- );
84
- saveHooksConfig({ version: 1, hooks: { "log-hook": { enabled: true } } });
85
-
86
- const manager = new HookManager();
87
- manager.initialize();
88
- await manager.trigger("pre-tool-execute", { tool: "Bash" });
89
- });
90
-
91
- test("trigger skips disabled hooks", async () => {
92
- createHook(
93
- hooksDir,
94
- "disabled-hook",
95
- ["on-error"],
96
- '#!/bin/bash\necho "should not run"',
97
- );
98
- // Not enabled in config (defaults to disabled)
99
-
100
- const manager = new HookManager();
101
- manager.initialize();
102
- await manager.trigger("on-error", {});
103
- });
104
-
105
- test("trigger only runs hooks subscribed to the event", async () => {
106
- createHook(
107
- hooksDir,
108
- "tool-hook",
109
- ["pre-tool-execute"],
110
- '#!/bin/bash\necho "tool"',
111
- );
112
- createHook(
113
- hooksDir,
114
- "error-hook",
115
- ["on-error"],
116
- '#!/bin/bash\necho "error"',
117
- );
118
- saveHooksConfig({
119
- version: 1,
120
- hooks: {
121
- "tool-hook": { enabled: true },
122
- "error-hook": { enabled: true },
123
- },
124
- });
125
-
126
- const manager = new HookManager();
127
- manager.initialize();
128
- await manager.trigger("pre-tool-execute", {});
129
- });
130
-
131
- test("trigger runs hooks sequentially in alphabetical order", async () => {
132
- // Create hooks that append to a shared file to verify execution order
133
- const orderFile = join(testDir, "order.txt");
134
- createHook(
135
- hooksDir,
136
- "zebra",
137
- ["post-message"],
138
- `#!/bin/bash\necho "zebra" >> "${orderFile}"`,
139
- );
140
- createHook(
141
- hooksDir,
142
- "alpha",
143
- ["post-message"],
144
- `#!/bin/bash\necho "alpha" >> "${orderFile}"`,
145
- );
146
- createHook(
147
- hooksDir,
148
- "middle",
149
- ["post-message"],
150
- `#!/bin/bash\necho "middle" >> "${orderFile}"`,
151
- );
152
- saveHooksConfig({
153
- version: 1,
154
- hooks: {
155
- zebra: { enabled: true },
156
- alpha: { enabled: true },
157
- middle: { enabled: true },
158
- },
159
- });
160
-
161
- const manager = new HookManager();
162
- manager.initialize();
163
- await manager.trigger("post-message", {});
164
-
165
- await new Promise((r) => setTimeout(r, 100));
166
- const { readFileSync } = await import("node:fs");
167
- const order = readFileSync(orderFile, "utf-8").trim().split("\n");
168
- expect(order).toEqual(["alpha", "middle", "zebra"]);
169
- });
170
-
171
- test("trigger handles hook failure gracefully", async () => {
172
- createHook(hooksDir, "bad-hook", ["on-error"], "#!/bin/bash\nexit 1");
173
- saveHooksConfig({ version: 1, hooks: { "bad-hook": { enabled: true } } });
174
-
175
- const manager = new HookManager();
176
- manager.initialize();
177
- await manager.trigger("on-error", { message: "test error" });
178
- });
179
-
180
- test("getDiscoveredHooks returns a copy", () => {
181
- createHook(hooksDir, "hook-a", ["on-error"]);
182
- saveHooksConfig({ version: 1, hooks: { "hook-a": { enabled: true } } });
183
-
184
- const manager = new HookManager();
185
- manager.initialize();
186
-
187
- const hooks1 = manager.getDiscoveredHooks();
188
- const hooks2 = manager.getDiscoveredHooks();
189
- expect(hooks1).toEqual(hooks2);
190
- expect(hooks1).not.toBe(hooks2);
191
- });
192
-
193
- test("getHookManager returns singleton", () => {
194
- const mgr1 = getHookManager();
195
- const mgr2 = getHookManager();
196
- expect(mgr1).toBe(mgr2);
197
- });
198
-
199
- test("resetHookManager clears singleton", () => {
200
- const mgr1 = getHookManager();
201
- resetHookManager();
202
- const mgr2 = getHookManager();
203
- expect(mgr1).not.toBe(mgr2);
204
- });
205
-
206
- test("multi-event hook is triggered for each subscribed event", async () => {
207
- const outputFile = join(testDir, "multi-event.txt");
208
- createHook(
209
- hooksDir,
210
- "multi",
211
- ["pre-tool-execute", "on-error"],
212
- `#!/bin/bash\necho "$VELLUM_HOOK_EVENT" >> "${outputFile}"`,
213
- );
214
- saveHooksConfig({ version: 1, hooks: { multi: { enabled: true } } });
215
-
216
- const manager = new HookManager();
217
- manager.initialize();
218
- await manager.trigger("pre-tool-execute", {});
219
- await manager.trigger("on-error", {});
220
-
221
- await new Promise((r) => setTimeout(r, 100));
222
- const { readFileSync } = await import("node:fs");
223
- const events = readFileSync(outputFile, "utf-8").trim().split("\n");
224
- expect(events).toEqual(["pre-tool-execute", "on-error"]);
225
- });
226
- });