@vellumai/assistant 0.9.0 → 0.10.0-staging.2

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 (572) hide show
  1. package/ARCHITECTURE.md +18 -34
  2. package/bun.lock +7 -8
  3. package/docs/activation-funnel-telemetry.md +28 -22
  4. package/docs/architecture/security.md +29 -28
  5. package/docs/stt-provider-onboarding.md +3 -5
  6. package/docs/workflows-testing.md +13 -44
  7. package/docs/workflows.md +3 -5
  8. package/node_modules/@vellumai/ces-client/src/__tests__/ces-client.test.ts +47 -0
  9. package/node_modules/@vellumai/ces-client/src/rpc-client.ts +28 -5
  10. package/node_modules/@vellumai/environments/src/seeds.ts +2 -5
  11. package/node_modules/@vellumai/gateway-client/src/admission-policy-contract.ts +97 -0
  12. package/node_modules/@vellumai/gateway-client/src/inbound-contract.ts +10 -0
  13. package/node_modules/@vellumai/gateway-client/src/index.ts +32 -6
  14. package/node_modules/@vellumai/gateway-client/src/outbound-contract.ts +119 -0
  15. package/node_modules/@vellumai/gateway-client/src/types.ts +15 -84
  16. package/openapi.yaml +976 -63
  17. package/package.json +2 -1
  18. package/scripts/sync-llm-catalog.ts +6 -15
  19. package/scripts/sync-web-search-catalog.ts +3 -11
  20. package/src/__tests__/access-request-card-view.test.ts +98 -0
  21. package/src/__tests__/access-request-seed-content-blocks.test.ts +2 -4
  22. package/src/__tests__/actor-trust-resolver-address-fallback.test.ts +72 -32
  23. package/src/__tests__/agent-loop-compaction-strip.test.ts +241 -0
  24. package/src/__tests__/agent-loop-mutable-latest-user-message.test.ts +16 -13
  25. package/src/__tests__/agent-loop-output-hooks.test.ts +69 -0
  26. package/src/__tests__/agent-loop-override-profile.test.ts +25 -0
  27. package/src/__tests__/always-loaded-tools-guard.test.ts +2 -3
  28. package/src/__tests__/app-compiler.test.ts +15 -1
  29. package/src/__tests__/app-dir-path-guard.test.ts +0 -1
  30. package/src/__tests__/assistant-feature-flag-guard.test.ts +1 -4
  31. package/src/__tests__/assistant-feature-flag-guardrails.test.ts +0 -2
  32. package/src/__tests__/auth-fallback-events-store.test.ts +6 -14
  33. package/src/__tests__/avatar-identity-sync.test.ts +2 -27
  34. package/src/__tests__/btw-routes.test.ts +6 -8
  35. package/src/__tests__/call-pointer-messages.test.ts +28 -0
  36. package/src/__tests__/cancel-clears-processing.test.ts +89 -0
  37. package/src/__tests__/channel-approval-routes.test.ts +0 -4
  38. package/src/__tests__/channel-inbound-disk-pressure.test.ts +5 -15
  39. package/src/__tests__/checker.test.ts +0 -3
  40. package/src/__tests__/cli-memory-v2-reembed-skills.test.ts +3 -4
  41. package/src/__tests__/compactor-image-manifest-trust.test.ts +21 -1
  42. package/src/__tests__/compactor-summary-call-truncation.test.ts +223 -0
  43. package/src/__tests__/config-loader-backfill.test.ts +268 -27
  44. package/src/__tests__/config-schema.test.ts +35 -0
  45. package/src/__tests__/config-watcher.test.ts +0 -18
  46. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +2 -2
  47. package/src/__tests__/contact-store-user-file.test.ts +0 -6
  48. package/src/__tests__/contacts-tools.test.ts +29 -0
  49. package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +22 -0
  50. package/src/__tests__/conversation-agent-loop-overflow.test.ts +1 -0
  51. package/src/__tests__/conversation-agent-loop.test.ts +58 -0
  52. package/src/__tests__/conversation-attention-telegram.test.ts +0 -1
  53. package/src/__tests__/conversation-lifecycle.test.ts +7 -9
  54. package/src/__tests__/conversation-load-history-repair.test.ts +101 -0
  55. package/src/__tests__/conversation-routes-guardian-reply.test.ts +15 -12
  56. package/src/__tests__/conversation-surfaces-activation-emit.test.ts +6 -3
  57. package/src/__tests__/conversation-title-service.test.ts +62 -0
  58. package/src/__tests__/credential-broker.test.ts +449 -1
  59. package/src/__tests__/credential-execution-shell-lockdown.test.ts +18 -11
  60. package/src/__tests__/credential-execution-tools.test.ts +0 -1
  61. package/src/__tests__/credential-prompt-route.test.ts +4 -4
  62. package/src/__tests__/credential-routes.test.ts +360 -0
  63. package/src/__tests__/credential-security-invariants.test.ts +4 -13
  64. package/src/__tests__/disk-pressure-policy.test.ts +12 -0
  65. package/src/__tests__/disk-usage.test.ts +65 -0
  66. package/src/__tests__/dynamic-page-surface.test.ts +152 -1
  67. package/src/__tests__/fixtures/credential-security-fixtures.ts +2 -33
  68. package/src/__tests__/gateway-flag-listener.test.ts +110 -1
  69. package/src/__tests__/gateway-only-guard.test.ts +3 -7
  70. package/src/__tests__/guardian-binding-drift-heal.test.ts +1 -1
  71. package/src/__tests__/guardian-card-withdrawal.test.ts +403 -0
  72. package/src/__tests__/guardian-decision-primitive-canonical.test.ts +5 -3
  73. package/src/__tests__/guardian-grant-minting.test.ts +3 -35
  74. package/src/__tests__/guardian-routing-invariants.test.ts +64 -26
  75. package/src/__tests__/guardian-routing-state.test.ts +0 -1
  76. package/src/__tests__/headless-browser-mode.test.ts +10 -0
  77. package/src/__tests__/headless-browser-navigate.test.ts +8 -3
  78. package/src/__tests__/helpers/create-guardian-binding.ts +0 -1
  79. package/src/__tests__/host-browser-proxy.test.ts +87 -0
  80. package/src/__tests__/identity-routes.test.ts +0 -189
  81. package/src/__tests__/inbound-invite-redemption.test.ts +4 -4
  82. package/src/__tests__/injector-v3-suppression.test.ts +27 -20
  83. package/src/__tests__/internal-telemetry-routes.test.ts +6 -14
  84. package/src/__tests__/invite-redemption-service.test.ts +4 -7
  85. package/src/__tests__/llm-callsite-catalog.test.ts +5 -6
  86. package/src/__tests__/llm-catalog-parity.test.ts +30 -23
  87. package/src/__tests__/llm-resolver.test.ts +70 -24
  88. package/src/__tests__/llm-schema.test.ts +1 -0
  89. package/src/__tests__/managed-profile-guard.test.ts +163 -4
  90. package/src/__tests__/mcp-health-check.test.ts +6 -7
  91. package/src/__tests__/media-stream-server-integration.test.ts +317 -13
  92. package/src/__tests__/oauth-provider-seed-logos.test.ts +4 -6
  93. package/src/__tests__/onboarding-persona-write.test.ts +1 -1
  94. package/src/__tests__/path-policy.test.ts +34 -0
  95. package/src/__tests__/persona-resolver.test.ts +49 -14
  96. package/src/__tests__/plugin-api-model-profiles.test.ts +178 -0
  97. package/src/__tests__/plugin-api-provider.test.ts +24 -0
  98. package/src/__tests__/plugin-tool-contribution.test.ts +6 -3
  99. package/src/__tests__/post-compaction-reinjection-idempotency.test.ts +214 -0
  100. package/src/__tests__/provider-send-message-override-profile.test.ts +76 -0
  101. package/src/__tests__/reaction-persistence.test.ts +150 -29
  102. package/src/__tests__/registry.test.ts +2 -7
  103. package/src/__tests__/relay-server.test.ts +285 -0
  104. package/src/__tests__/runtime-attachment-metadata.test.ts +0 -1
  105. package/src/__tests__/schedule-routes-workflow-validation.test.ts +1 -10
  106. package/src/__tests__/schedule-routes.test.ts +0 -30
  107. package/src/__tests__/schedule-tools.test.ts +2 -18
  108. package/src/__tests__/scheduler-reuse-conversation.test.ts +8 -5
  109. package/src/__tests__/skill-execute-input.test.ts +51 -1
  110. package/src/__tests__/skill-runtime-path.test.ts +2 -3
  111. package/src/__tests__/skills.test.ts +51 -0
  112. package/src/__tests__/slack-notification-approval-card.test.ts +176 -0
  113. package/src/__tests__/slack-reaction-canonical-approval.test.ts +285 -0
  114. package/src/__tests__/subagent-tools.test.ts +266 -0
  115. package/src/__tests__/surface-completion-nudge-hook.test.ts +367 -0
  116. package/src/__tests__/task-progress-nudge-hook.test.ts +1 -1
  117. package/src/__tests__/title-generate-hook.test.ts +100 -3
  118. package/src/__tests__/token-estimator-accuracy.benchmark.test.ts +1 -29
  119. package/src/__tests__/token-manager.test.ts +519 -0
  120. package/src/__tests__/tool-approval-seed-content-blocks.test.ts +1 -1
  121. package/src/__tests__/tool-audit-listener.test.ts +7 -7
  122. package/src/__tests__/tool-executor-lifecycle-events.test.ts +6 -3
  123. package/src/__tests__/tool-executor.test.ts +0 -79
  124. package/src/__tests__/trusted-contact-approval-notifier.test.ts +4 -2
  125. package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +220 -3
  126. package/src/__tests__/trusted-contact-multichannel.test.ts +3 -3
  127. package/src/__tests__/trusted-contact-verification.test.ts +8 -10
  128. package/src/__tests__/twilio-routes.test.ts +81 -1
  129. package/src/__tests__/voice-invite-redemption.test.ts +2 -3
  130. package/src/__tests__/weak-open-model.test.ts +30 -0
  131. package/src/__tests__/web-search-catalog-parity.test.ts +6 -25
  132. package/src/__tests__/workspace-greetings.test.ts +152 -0
  133. package/src/__tests__/workspace-migration-105-enable-memory-v3-live-for-new-workspaces.test.ts +149 -0
  134. package/src/__tests__/workspace-migration-108-drop-balanced-economy-profile.test.ts +285 -0
  135. package/src/__tests__/workspace-migration-add-send-diagnostics.test.ts +1 -1
  136. package/src/__tests__/workspace-migration-drop-collect-usage-data.test.ts +118 -0
  137. package/src/__tests__/workspace-migration-drop-send-diagnostics.test.ts +118 -0
  138. package/src/a2a/__tests__/e2e-a2a-channel.test.ts +0 -4
  139. package/src/agent/loop.ts +49 -29
  140. package/src/api/README.md +6 -6
  141. package/src/api/events/tool-result.ts +6 -0
  142. package/src/api/events/workflow-completed.ts +53 -0
  143. package/src/api/events/workflow-leaf-finished.ts +38 -0
  144. package/src/api/events/workflow-leaf-started.ts +35 -0
  145. package/src/api/events/workflow-progress.ts +32 -0
  146. package/src/api/events/workflow-started.ts +31 -0
  147. package/src/api/index.ts +40 -0
  148. package/src/api/responses/conversation-message.ts +28 -4
  149. package/src/api/responses/home.ts +26 -4
  150. package/src/api/responses/workflow-journal.ts +53 -0
  151. package/src/approvals/guardian-card-withdrawal.ts +145 -0
  152. package/src/approvals/guardian-decision-primitive.ts +26 -3
  153. package/src/approvals/guardian-request-resolvers.ts +183 -80
  154. package/src/calls/__tests__/channel-admission-reader.test.ts +132 -0
  155. package/src/calls/__tests__/relay-setup-router.test.ts +350 -0
  156. package/src/calls/call-pointer-messages.ts +10 -4
  157. package/src/calls/channel-admission-reader.ts +104 -0
  158. package/src/calls/guardian-dispatch.ts +17 -45
  159. package/src/calls/media-stream-server.ts +84 -2
  160. package/src/calls/relay-access-wait.ts +1 -1
  161. package/src/calls/relay-server.ts +66 -0
  162. package/src/calls/relay-setup-router.ts +82 -1
  163. package/src/calls/twilio-routes.ts +17 -8
  164. package/src/calls/voice-session-bridge.ts +2 -2
  165. package/src/cli/commands/clients.ts +3 -0
  166. package/src/cli/commands/{__tests__ → memory/__tests__}/memory-v2-compare-render.test.ts +1 -1
  167. package/src/cli/commands/{__tests__ → memory/__tests__}/memory-v2.test.ts +8 -7
  168. package/src/cli/commands/{__tests__ → memory/__tests__}/memory-v3.test.ts +5 -4
  169. package/src/cli/commands/memory/index.ts +30 -0
  170. package/src/cli/commands/{memory-v2-compare-render.ts → memory/memory-v2-compare-render.ts} +1 -1
  171. package/src/cli/commands/{memory-v2.ts → memory/memory-v2.ts} +6 -15
  172. package/src/cli/commands/{memory-v3.ts → memory/memory-v3.ts} +97 -11
  173. package/src/cli/commands/oauth/status.test.ts +36 -0
  174. package/src/cli/commands/oauth/status.ts +23 -3
  175. package/src/cli/commands/plugins.ts +197 -4
  176. package/src/cli/lib/__tests__/diff-plugin.test.ts +443 -0
  177. package/src/cli/lib/__tests__/inspect-plugin.test.ts +54 -0
  178. package/src/cli/lib/__tests__/merge-plugin-tree.test.ts +443 -0
  179. package/src/cli/lib/__tests__/plugin-surfaces.test.ts +111 -0
  180. package/src/cli/lib/__tests__/upgrade-plugin.test.ts +295 -2
  181. package/src/cli/lib/diff-plugin.ts +346 -0
  182. package/src/cli/lib/inspect-plugin.ts +12 -1
  183. package/src/cli/lib/install-from-github.ts +105 -17
  184. package/src/cli/lib/merge-plugin-tree.ts +328 -0
  185. package/src/cli/lib/plugin-fingerprint.ts +14 -0
  186. package/src/cli/lib/plugin-surfaces.ts +104 -0
  187. package/src/cli/lib/upgrade-plugin.ts +298 -10
  188. package/src/cli/program.ts +2 -6
  189. package/src/config/__tests__/sync-gated-profiles.test.ts +368 -0
  190. package/src/config/assistant-feature-flags.ts +22 -7
  191. package/src/config/bundled-skills/contacts/tools/contact-search.ts +0 -1
  192. package/src/config/bundled-skills/messaging/SKILL.md +6 -4
  193. package/src/config/bundled-skills/messaging/tools/messaging-archive-by-sender.ts +9 -8
  194. package/src/config/bundled-skills/subagent/SKILL.md +4 -0
  195. package/src/config/bundled-skills/subagent/TOOLS.json +4 -0
  196. package/src/config/bundled-skills/workflows/SKILL.md +14 -8
  197. package/src/config/bundled-tool-registry.ts +2 -7
  198. package/src/config/call-site-defaults.ts +15 -2
  199. package/src/config/feature-flag-registry.json +46 -31
  200. package/src/config/inference-profile-validation.ts +26 -0
  201. package/src/config/llm-resolver.ts +3 -0
  202. package/src/config/loader.ts +4 -0
  203. package/src/config/memory-v3-gate.ts +11 -0
  204. package/src/config/profile-order.ts +28 -0
  205. package/src/config/schema.ts +8 -6
  206. package/src/config/schemas/__tests__/memory-v3.test.ts +1 -0
  207. package/src/config/schemas/call-site-catalog.ts +7 -0
  208. package/src/config/schemas/channels.ts +11 -0
  209. package/src/config/schemas/elevenlabs.ts +0 -1
  210. package/src/config/schemas/llm.ts +31 -0
  211. package/src/config/schemas/memory-lifecycle.ts +3 -7
  212. package/src/config/schemas/memory-v3.ts +6 -0
  213. package/src/config/schemas/platform.ts +0 -8
  214. package/src/config/schemas/services.ts +18 -0
  215. package/src/config/seed-inference-profiles.ts +109 -44
  216. package/src/config/skills.ts +21 -0
  217. package/src/config/sync-gated-profiles.ts +220 -0
  218. package/src/contacts/contact-store.ts +89 -106
  219. package/src/contacts/contacts-write.ts +5 -22
  220. package/src/contacts/types.ts +0 -1
  221. package/src/context/compactor.ts +88 -54
  222. package/src/context/strip-injections.ts +58 -10
  223. package/src/context/token-estimator.ts +1 -1
  224. package/src/credential-execution/process-manager.ts +55 -14
  225. package/src/credential-execution/prompted-credential.ts +2 -3
  226. package/src/daemon/__tests__/conversation-lifecycle-auto-analyze.test.ts +3 -2
  227. package/src/daemon/config-watcher.ts +0 -4
  228. package/src/daemon/conversation-agent-loop-handlers.ts +2 -0
  229. package/src/daemon/conversation-agent-loop.ts +114 -22
  230. package/src/daemon/conversation-history.ts +1 -1
  231. package/src/daemon/conversation-lifecycle.ts +3 -5
  232. package/src/daemon/conversation-process.ts +13 -5
  233. package/src/daemon/conversation-runtime-assembly.ts +13 -15
  234. package/src/daemon/conversation-slash.ts +2 -23
  235. package/src/daemon/conversation-surfaces.ts +26 -0
  236. package/src/daemon/conversation-tool-setup.ts +27 -14
  237. package/src/daemon/conversation.ts +66 -14
  238. package/src/daemon/disk-pressure-policy.ts +5 -3
  239. package/src/daemon/handlers/__tests__/config-a2a-complete.test.ts +0 -1
  240. package/src/daemon/handlers/__tests__/config-a2a-redeem.test.ts +0 -1
  241. package/src/daemon/handlers/config-a2a.ts +0 -2
  242. package/src/daemon/handlers/config-channels.ts +15 -16
  243. package/src/daemon/handlers/config-slack-channel.ts +22 -3
  244. package/src/daemon/handlers/conversations.ts +107 -0
  245. package/src/daemon/host-browser-proxy.ts +41 -0
  246. package/src/daemon/lifecycle.ts +55 -27
  247. package/src/daemon/message-provenance.ts +2 -0
  248. package/src/daemon/message-types/contacts.ts +0 -1
  249. package/src/daemon/message-types/conversations.ts +3 -3
  250. package/src/daemon/message-types/sync.ts +0 -1
  251. package/src/daemon/message-types/web-activity.ts +7 -1
  252. package/src/daemon/message-types/workflows.ts +83 -1
  253. package/src/daemon/orphan-reaper.test.ts +0 -19
  254. package/src/daemon/orphan-reaper.ts +2 -24
  255. package/src/daemon/server.ts +0 -10
  256. package/src/daemon/tool-setup-types.ts +4 -0
  257. package/src/daemon/trust-context.ts +1 -1
  258. package/src/events/tool-audit-listener.ts +2 -2
  259. package/src/home/feed-source-enrichment.test.ts +151 -0
  260. package/src/home/feed-source-enrichment.ts +176 -0
  261. package/src/home/relationship-state.ts +2 -4
  262. package/src/instrument.ts +18 -6
  263. package/src/ipc/__tests__/binary-result-ipc.test.ts +81 -0
  264. package/src/ipc/__tests__/clients-list-ipc.test.ts +20 -0
  265. package/src/ipc/assistant-server.ts +37 -4
  266. package/src/ipc/gateway-flag-listener.ts +18 -2
  267. package/src/memory/__tests__/auto-analysis-enqueue.test.ts +5 -16
  268. package/src/memory/__tests__/jobs-store-enqueue-gate.test.ts +7 -11
  269. package/src/memory/__tests__/memory-retrospective-enqueue.test.ts +37 -7
  270. package/src/memory/__tests__/memory-retrospective-job.test.ts +229 -401
  271. package/src/memory/__tests__/onboarding-events-store.test.ts +7 -7
  272. package/src/memory/auth-fallback-events-store.ts +2 -2
  273. package/src/memory/auto-analysis-enqueue.ts +3 -5
  274. package/src/memory/bookmark-crud.ts +1 -2
  275. package/src/memory/canonical-guardian-store.ts +39 -1
  276. package/src/memory/conversation-crud.ts +9 -4
  277. package/src/memory/conversation-key-store.ts +17 -2
  278. package/src/memory/conversation-title-service.ts +64 -7
  279. package/src/memory/db-init.ts +17 -17
  280. package/src/memory/embedding-backend.ts +38 -1
  281. package/src/memory/embedding-billing-breaker.ts +96 -0
  282. package/src/memory/jobs-store.ts +25 -13
  283. package/src/memory/jobs-worker.ts +54 -1
  284. package/src/memory/lifecycle-events-store.ts +2 -2
  285. package/src/memory/memory-retrospective-constants.ts +4 -4
  286. package/src/memory/memory-retrospective-enqueue.ts +31 -6
  287. package/src/memory/memory-retrospective-job.ts +28 -227
  288. package/src/memory/migrations/129-contact-channels-access-fields.ts +18 -9
  289. package/src/memory/migrations/131-drop-legacy-member-guardian-tables.ts +14 -2
  290. package/src/memory/migrations/289-contact-channels-unique-ext-user.ts +10 -0
  291. package/src/memory/migrations/291-contact-channels-renormalize-addresses.ts +72 -0
  292. package/src/memory/migrations/292-schedule-default-no-reuse-conversation.test.ts +67 -0
  293. package/src/memory/migrations/292-schedule-default-no-reuse-conversation.ts +25 -0
  294. package/src/memory/migrations/293-workflow-journal-leaf-tokens.ts +32 -0
  295. package/src/memory/migrations/294-drop-external-user-id.ts +31 -0
  296. package/src/memory/migrations/295-drop-approval-prompt-ts-tracker.ts +20 -0
  297. package/src/memory/migrations/296-rewrite-balanced-economy-profile-pins.test.ts +110 -0
  298. package/src/memory/migrations/296-rewrite-balanced-economy-profile-pins.ts +68 -0
  299. package/src/memory/migrations/__tests__/131-drop-legacy-member-guardian-tables.test.ts +154 -0
  300. package/src/memory/migrations/__tests__/289-contact-channels-unique-ext-user.test.ts +31 -0
  301. package/src/memory/migrations/__tests__/291-contact-channels-renormalize-addresses.test.ts +341 -0
  302. package/src/memory/migrations/__tests__/run-migrations.test.ts +52 -0
  303. package/src/memory/migrations/index.ts +6 -0
  304. package/src/memory/migrations/run-migrations.ts +41 -0
  305. package/src/memory/migrations/validate-migration-state.ts +1 -1
  306. package/src/memory/onboarding-events-store.ts +3 -3
  307. package/src/memory/schema/contacts.ts +0 -5
  308. package/src/memory/skill-loaded-events-store.test.ts +7 -15
  309. package/src/memory/skill-loaded-events-store.ts +2 -2
  310. package/src/memory/tool-executed-events-store.test.ts +7 -7
  311. package/src/memory/turn-trace-store.test.ts +736 -0
  312. package/src/memory/turn-trace-store.ts +364 -0
  313. package/src/memory/v2/__tests__/consolidation-job.test.ts +8 -0
  314. package/src/memory/v2/__tests__/skill-content.test.ts +30 -0
  315. package/src/memory/v2/consolidation-job.ts +2 -2
  316. package/src/memory/v2/skill-content.ts +25 -7
  317. package/src/memory/v2/skill-store.ts +7 -1
  318. package/src/memory/v3-eval/__tests__/eval-packets.test.ts +248 -0
  319. package/src/memory/v3-eval/eval-packets.ts +546 -0
  320. package/src/messaging/providers/slack/adapter.ts +1 -1
  321. package/src/messaging/providers/slack/api.ts +31 -0
  322. package/src/messaging/providers/slack/send.test.ts +114 -2
  323. package/src/messaging/providers/slack/send.ts +30 -7
  324. package/src/messaging/providers/slack/withdraw.test.ts +200 -0
  325. package/src/messaging/providers/slack/withdraw.ts +161 -0
  326. package/src/notifications/AGENTS.md +2 -0
  327. package/src/notifications/access-request-copy.ts +72 -59
  328. package/src/notifications/adapters/shared.ts +29 -0
  329. package/src/notifications/adapters/slack.ts +58 -103
  330. package/src/notifications/adapters/telegram.ts +2 -20
  331. package/src/notifications/approval-card-data.ts +333 -0
  332. package/src/notifications/broadcaster.ts +16 -3
  333. package/src/notifications/canonical-delivery-recorder.ts +139 -0
  334. package/src/notifications/copy-composer.ts +3 -3
  335. package/src/notifications/decision-engine.ts +4 -2
  336. package/src/notifications/destination-resolver.ts +4 -6
  337. package/src/notifications/guardian-question-mode.ts +10 -0
  338. package/src/notifications/home-feed-side-effect.ts +7 -16
  339. package/src/notifications/notification-utils.ts +19 -20
  340. package/src/notifications/signal.ts +79 -43
  341. package/src/notifications/types.ts +98 -121
  342. package/src/oauth/AGENTS.md +5 -24
  343. package/src/permissions/checker.test.ts +51 -0
  344. package/src/permissions/checker.ts +185 -26
  345. package/src/permissions/ipc-risk-types.ts +24 -0
  346. package/src/permissions/question-prompter.test.ts +27 -0
  347. package/src/permissions/question-prompter.ts +4 -0
  348. package/src/platform/client.test.ts +119 -0
  349. package/src/platform/client.ts +66 -0
  350. package/src/platform/consent-cache.test.ts +267 -0
  351. package/src/platform/consent-cache.ts +174 -0
  352. package/src/plugin-api/constants.ts +1 -1
  353. package/src/plugin-api/index.ts +33 -1
  354. package/src/plugin-api/model-profiles.ts +33 -0
  355. package/src/plugin-api/types.ts +50 -2
  356. package/src/plugins/defaults/advisor/__tests__/advisor-gate.test.ts +56 -0
  357. package/src/plugins/defaults/advisor/__tests__/advisor-state-store.test.ts +43 -0
  358. package/src/plugins/defaults/advisor/__tests__/agent-loop-integration.test.ts +137 -0
  359. package/src/plugins/defaults/advisor/__tests__/consult.test.ts +153 -0
  360. package/src/plugins/defaults/advisor/__tests__/hooks.test.ts +138 -0
  361. package/src/plugins/defaults/advisor/__tests__/transcript.test.ts +147 -0
  362. package/src/plugins/defaults/advisor/advisor-gate.ts +29 -0
  363. package/src/plugins/defaults/advisor/advisor-state-store.ts +94 -0
  364. package/src/plugins/defaults/advisor/config.ts +21 -0
  365. package/src/plugins/defaults/advisor/consult.ts +93 -0
  366. package/src/plugins/defaults/advisor/hooks/post-model-call.ts +34 -0
  367. package/src/plugins/defaults/advisor/hooks/pre-model-call.ts +30 -0
  368. package/src/plugins/defaults/advisor/hooks/user-prompt-submit.ts +19 -0
  369. package/src/plugins/defaults/advisor/package.json +14 -0
  370. package/src/plugins/defaults/advisor/steering.ts +67 -0
  371. package/src/plugins/defaults/advisor/tools/advisor.ts +65 -0
  372. package/src/plugins/defaults/advisor/transcript.ts +76 -0
  373. package/src/plugins/defaults/index.ts +60 -0
  374. package/src/plugins/defaults/memory-retrieval/hooks/post-compact.ts +22 -9
  375. package/src/plugins/defaults/memory-retrieval/hooks/user-prompt-submit.ts +2 -2
  376. package/src/plugins/defaults/memory-retrieval/tail-reinjection-strip.ts +64 -0
  377. package/src/plugins/defaults/memory-retrieval/unified-turn-context.ts +29 -21
  378. package/src/plugins/defaults/memory-v3-shadow/__tests__/carry-integration.test.ts +1 -0
  379. package/src/plugins/defaults/memory-v3-shadow/__tests__/injection.test.ts +1 -0
  380. package/src/plugins/defaults/memory-v3-shadow/__tests__/maintain-job.test.ts +129 -9
  381. package/src/plugins/defaults/memory-v3-shadow/__tests__/orchestrate.test.ts +31 -4
  382. package/src/plugins/defaults/memory-v3-shadow/__tests__/selection-log-store.test.ts +77 -2
  383. package/src/plugins/defaults/memory-v3-shadow/__tests__/shadow-plugin.test.ts +1 -0
  384. package/src/plugins/defaults/memory-v3-shadow/injector.ts +7 -10
  385. package/src/plugins/defaults/memory-v3-shadow/maintain-job.ts +144 -11
  386. package/src/plugins/defaults/memory-v3-shadow/orchestrate.ts +32 -20
  387. package/src/plugins/defaults/memory-v3-shadow/selection-log-store.ts +56 -3
  388. package/src/plugins/defaults/memory-v3-shadow/shadow-plugin.ts +23 -2
  389. package/src/plugins/defaults/surface-completion-nudge/hooks/post-model-call.ts +276 -0
  390. package/src/plugins/defaults/surface-completion-nudge/hooks/stop.ts +22 -0
  391. package/src/plugins/defaults/surface-completion-nudge/nudge-state-store.ts +46 -0
  392. package/src/plugins/defaults/surface-completion-nudge/package.json +14 -0
  393. package/src/plugins/defaults/task-progress-nudge/hooks/post-tool-use.ts +3 -13
  394. package/src/plugins/defaults/title-generate/hooks/stop.ts +56 -21
  395. package/src/prompts/persona-resolver.ts +14 -4
  396. package/src/prompts/templates/system-sections.ts +7 -2
  397. package/src/providers/__tests__/provider-env-vars.test.ts +6 -0
  398. package/src/providers/__tests__/provider-secret-catalog.test.ts +1 -0
  399. package/src/providers/__tests__/retry-callsite.test.ts +176 -0
  400. package/src/providers/atlascloud/client.ts +85 -0
  401. package/src/providers/fetch-provider-catalog.ts +85 -0
  402. package/src/providers/inference/adapter-factory.ts +3 -0
  403. package/src/providers/model-catalog.ts +58 -0
  404. package/src/providers/openai/__tests__/chat-completions-provider-reasoning.test.ts +33 -0
  405. package/src/providers/openai/chat-completions-provider.ts +7 -0
  406. package/src/providers/openai/responses-provider.ts +10 -0
  407. package/src/providers/provider-send-message.ts +11 -3
  408. package/src/providers/retry.ts +53 -12
  409. package/src/providers/search-provider-catalog.ts +10 -0
  410. package/src/providers/weak-open-model.ts +22 -0
  411. package/src/runtime/AGENTS.md +0 -1
  412. package/src/runtime/__tests__/agent-wake.test.ts +181 -0
  413. package/src/runtime/__tests__/client-health.test.ts +44 -0
  414. package/src/runtime/access-request-helper.ts +21 -53
  415. package/src/runtime/actor-trust-resolver.ts +59 -63
  416. package/src/runtime/agent-wake.ts +52 -0
  417. package/src/runtime/assistant-event-hub.ts +18 -4
  418. package/src/runtime/auth/__tests__/route-policy.test.ts +12 -0
  419. package/src/runtime/auth/require-bound-guardian.ts +1 -4
  420. package/src/runtime/btw-sidechain.ts +3 -6
  421. package/src/runtime/capabilities.test.ts +120 -0
  422. package/src/runtime/capabilities.ts +197 -0
  423. package/src/runtime/channel-approval-types.ts +22 -45
  424. package/src/runtime/channel-invite-transports/telegram.ts +4 -4
  425. package/src/runtime/channel-retry-sweep.ts +1 -0
  426. package/src/runtime/channel-verification-service.ts +3 -3
  427. package/src/runtime/client-health.ts +26 -0
  428. package/src/runtime/confirmation-request-guardian-bridge.ts +38 -29
  429. package/src/runtime/effective-capabilities.test.ts +128 -0
  430. package/src/runtime/effective-capabilities.ts +84 -0
  431. package/src/runtime/guardian-reply-router.ts +106 -21
  432. package/src/runtime/invite-redemption-service.ts +9 -25
  433. package/src/runtime/migrations/__tests__/vbundle-builder-fd-leak.test.ts +123 -0
  434. package/src/runtime/migrations/vbundle-builder.ts +49 -20
  435. package/src/runtime/pending-interactions.ts +15 -0
  436. package/src/runtime/routes/__tests__/client-routes.test.ts +13 -0
  437. package/src/runtime/routes/__tests__/conversation-management-routes.test.ts +67 -0
  438. package/src/runtime/routes/__tests__/plugins-routes.test.ts +240 -1
  439. package/src/runtime/routes/app-routes.ts +1 -1
  440. package/src/runtime/routes/approval-strategies/guardian-callback-strategy.ts +2 -2
  441. package/src/runtime/routes/assets/vellum-design-system.css +1959 -0
  442. package/src/runtime/routes/browser-tabs-routes.ts +9 -0
  443. package/src/runtime/routes/btw-routes.ts +1 -27
  444. package/src/runtime/routes/canonical-guardian-expiry-sweep.ts +17 -8
  445. package/src/runtime/routes/client-routes.ts +10 -0
  446. package/src/runtime/routes/contact-routes.ts +31 -8
  447. package/src/runtime/routes/conversation-compaction-routes.ts +1 -1
  448. package/src/runtime/routes/conversation-management-routes.ts +80 -1
  449. package/src/runtime/routes/conversation-query-routes.ts +68 -22
  450. package/src/runtime/routes/conversation-routes.ts +39 -14
  451. package/src/runtime/routes/credential-routes.ts +40 -16
  452. package/src/runtime/routes/empty-state-greeting-cache.ts +1 -2
  453. package/src/runtime/routes/events-routes.ts +1 -3
  454. package/src/runtime/routes/guardian-approval-interception.ts +14 -73
  455. package/src/runtime/routes/guardian-approval-prompt.ts +22 -4
  456. package/src/runtime/routes/home-feed-routes.ts +8 -3
  457. package/src/runtime/routes/identity-routes.ts +1 -296
  458. package/src/runtime/routes/inbound-message-handler.ts +214 -228
  459. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +89 -7
  460. package/src/runtime/routes/inbound-stages/admission-policy.test.ts +154 -0
  461. package/src/runtime/routes/inbound-stages/admission-policy.ts +140 -0
  462. package/src/runtime/routes/inbound-stages/background-dispatch.test.ts +3 -3
  463. package/src/runtime/routes/inbound-stages/background-dispatch.ts +11 -6
  464. package/src/runtime/routes/inbound-stages/escalation-intercept.ts +1 -2
  465. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.ts +1 -2
  466. package/src/runtime/routes/inbound-stages/guardian-reply-intercept.test.ts +7 -7
  467. package/src/runtime/routes/inbound-stages/guardian-reply-intercept.ts +47 -28
  468. package/src/runtime/routes/inbound-stages/reaction-intercept.ts +358 -0
  469. package/src/runtime/routes/index.ts +2 -0
  470. package/src/runtime/routes/integrations/slack/__tests__/channel.test.ts +8 -0
  471. package/src/runtime/routes/integrations/slack/channel.ts +36 -0
  472. package/src/runtime/routes/internal-telemetry-routes.ts +1 -1
  473. package/src/runtime/routes/mcp-auth-routes.ts +233 -41
  474. package/src/runtime/routes/memory-eval-routes.ts +87 -0
  475. package/src/runtime/routes/notification-routes.ts +122 -133
  476. package/src/runtime/routes/platform-routes.ts +2 -2
  477. package/src/runtime/routes/plugins-routes.ts +202 -3
  478. package/src/runtime/routes/schedule-routes.ts +0 -22
  479. package/src/runtime/routes/secret-routes.ts +10 -0
  480. package/src/runtime/routes/surface-action-routes.ts +2 -1
  481. package/src/runtime/routes/tool-call-question-enrichment.test.ts +146 -0
  482. package/src/runtime/routes/tool-call-question-enrichment.ts +66 -0
  483. package/src/runtime/routes/workflow-routes.test.ts +229 -44
  484. package/src/runtime/routes/workflow-routes.ts +131 -29
  485. package/src/runtime/routes/workspace-greetings.ts +55 -0
  486. package/src/runtime/sync/resource-sync-events.ts +1 -11
  487. package/src/runtime/tool-grant-request-helper.ts +18 -16
  488. package/src/runtime/trust-context-resolver.ts +8 -5
  489. package/src/schedule/inference-profile.ts +2 -14
  490. package/src/schedule/schedule-store.ts +1 -1
  491. package/src/schedule/scheduler-types.ts +5 -1
  492. package/src/security/__tests__/provider-key-env-fallback.test.ts +6 -0
  493. package/src/security/secret-patterns.ts +3 -0
  494. package/src/subagent/manager.ts +17 -4
  495. package/src/subagent/types.ts +6 -0
  496. package/src/telemetry/trace-collection-policy.test.ts +28 -0
  497. package/src/telemetry/trace-collection-policy.ts +30 -0
  498. package/src/telemetry/types.ts +89 -0
  499. package/src/telemetry/usage-telemetry-reporter.test.ts +586 -36
  500. package/src/telemetry/usage-telemetry-reporter.ts +148 -41
  501. package/src/tools/AGENTS.md +3 -3
  502. package/src/tools/browser/__tests__/browser-execution-acquire.test.ts +31 -0
  503. package/src/tools/browser/browser-execution.ts +30 -19
  504. package/src/tools/document/document-tool.ts +2 -3
  505. package/src/tools/executor.ts +5 -3
  506. package/src/tools/host-terminal/host-shell.ts +5 -4
  507. package/src/tools/memory/register.ts +2 -2
  508. package/src/tools/network/__tests__/web-fetch-firecrawl.test.ts +360 -0
  509. package/src/tools/network/__tests__/web-search.test.ts +143 -0
  510. package/src/tools/network/web-fetch.ts +372 -1
  511. package/src/tools/network/web-search-error.ts +1 -1
  512. package/src/tools/network/web-search.ts +213 -10
  513. package/src/tools/permission-checker.ts +4 -3
  514. package/src/tools/registry.ts +20 -0
  515. package/src/tools/schedule/create.ts +7 -12
  516. package/src/tools/schedule/update.ts +4 -11
  517. package/src/tools/shared/filesystem/path-policy.ts +39 -13
  518. package/src/tools/side-effects.ts +2 -17
  519. package/src/tools/skills/execute.ts +33 -0
  520. package/src/tools/subagent/spawn.ts +61 -12
  521. package/src/tools/terminal/shell.ts +10 -4
  522. package/src/tools/tool-approval-handler.ts +18 -13
  523. package/src/tools/tool-manifest.ts +0 -2
  524. package/src/tools/types.ts +9 -0
  525. package/src/tools/ui-surface/definitions.ts +64 -3
  526. package/src/tools/verification-control-plane-policy.ts +3 -1
  527. package/src/tools/workflows/run-workflow.test.ts +8 -18
  528. package/src/tools/workflows/run-workflow.ts +1 -0
  529. package/src/util/disk-usage.ts +78 -23
  530. package/src/util/platform.ts +10 -3
  531. package/src/watcher/telemetry.ts +2 -2
  532. package/src/workflows/capabilities.ts +2 -3
  533. package/src/workflows/engine.test.ts +175 -1
  534. package/src/workflows/engine.ts +82 -0
  535. package/src/workflows/journal-store.test.ts +70 -0
  536. package/src/workflows/journal-store.ts +18 -3
  537. package/src/workflows/run-manager.test.ts +171 -28
  538. package/src/workflows/run-manager.ts +66 -24
  539. package/src/workspace/migrations/105-enable-memory-v3-live-for-new-workspaces.ts +63 -0
  540. package/src/workspace/migrations/106-drop-collect-usage-data.ts +47 -0
  541. package/src/workspace/migrations/107-drop-send-diagnostics.ts +47 -0
  542. package/src/workspace/migrations/108-drop-balanced-economy-profile.ts +129 -0
  543. package/src/workspace/migrations/registry.ts +8 -0
  544. package/src/__tests__/app-control-no-global-cgevent.test.ts +0 -98
  545. package/src/__tests__/credential-security-e2e.test.ts +0 -362
  546. package/src/__tests__/credential-vault-unit.test.ts +0 -1528
  547. package/src/__tests__/credential-vault.test.ts +0 -1706
  548. package/src/__tests__/identity-intro-cache.test.ts +0 -315
  549. package/src/__tests__/secret-onetime-send.test.ts +0 -182
  550. package/src/cli/commands/__tests__/task.test.ts +0 -914
  551. package/src/cli/commands/task.ts +0 -771
  552. package/src/config/bundled-skills/personal-page/SKILL.md +0 -57
  553. package/src/config/bundled-skills/personal-page/TOOLS.json +0 -27
  554. package/src/config/bundled-skills/personal-page/tools/app-refresh.ts +0 -17
  555. package/src/config/preloaded-apps/personal-page/src/components/About.tsx +0 -22
  556. package/src/config/preloaded-apps/personal-page/src/components/App.tsx +0 -16
  557. package/src/config/preloaded-apps/personal-page/src/components/Features.tsx +0 -77
  558. package/src/config/preloaded-apps/personal-page/src/components/Hero.tsx +0 -57
  559. package/src/config/preloaded-apps/personal-page/src/components/Pending.tsx +0 -28
  560. package/src/config/preloaded-apps/personal-page/src/components/animations.tsx +0 -234
  561. package/src/config/preloaded-apps/personal-page/src/components/icons.tsx +0 -48
  562. package/src/config/preloaded-apps/personal-page/src/components/media.ts +0 -16
  563. package/src/config/preloaded-apps/personal-page/src/index.html +0 -20
  564. package/src/config/preloaded-apps/personal-page/src/main.tsx +0 -7
  565. package/src/config/preloaded-apps/personal-page/src/profile-data.ts +0 -82
  566. package/src/config/preloaded-apps/personal-page/src/styles.css +0 -759
  567. package/src/memory/__tests__/preloaded-apps.test.ts +0 -85
  568. package/src/memory/preloaded-apps.ts +0 -116
  569. package/src/notifications/tool-approval-copy.ts +0 -142
  570. package/src/runtime/routes/approval-prompt-ts-tracker.ts +0 -78
  571. package/src/runtime/routes/identity-intro-cache.ts +0 -172
  572. package/src/tools/credentials/vault.ts +0 -712
@@ -1,914 +0,0 @@
1
- /**
2
- * Tests for the `assistant task` CLI command.
3
- *
4
- * Validates:
5
- * - Template subcommands: list, save, run, delete
6
- * - Queue subcommands: show, add, update, remove, run
7
- * - Conversation ID resolution (explicit, __SKILL_CONTEXT_JSON, __CONVERSATION_ID)
8
- * - --json output mode for both template and queue commands
9
- * - Error propagation (IPC failure -> exitCode 1)
10
- * - --required-tools comma-splitting for queue add
11
- */
12
-
13
- import { beforeEach, describe, expect, mock, test } from "bun:test";
14
-
15
- import { Command } from "commander";
16
-
17
- // ---------------------------------------------------------------------------
18
- // Mock state
19
- // ---------------------------------------------------------------------------
20
-
21
- /** The last `cliIpcCall` invocation captured for assertions. */
22
-
23
- let lastIpcCall: {
24
- method: string;
25
- params?: any;
26
- } | null = null;
27
-
28
- /** The result that cliIpcCall will return. */
29
- let mockIpcResult: {
30
- ok: boolean;
31
- result?: unknown;
32
- error?: string;
33
- } = { ok: true, result: {} };
34
-
35
- // ---------------------------------------------------------------------------
36
- // Mocks
37
- // ---------------------------------------------------------------------------
38
-
39
- mock.module("../../../ipc/cli-client.js", () => ({
40
- cliIpcCall: async (method: string, params?: Record<string, unknown>) => {
41
- lastIpcCall = { method, params };
42
- return mockIpcResult;
43
- },
44
- }));
45
-
46
- mock.module("../../../util/logger.js", () => ({
47
- getLogger: () => ({
48
- info: () => {},
49
- warn: () => {},
50
- error: () => {},
51
- debug: () => {},
52
- }),
53
- getCliLogger: () => ({
54
- info: () => {},
55
- warn: () => {},
56
- error: () => {},
57
- debug: () => {},
58
- }),
59
- }));
60
-
61
- // ---------------------------------------------------------------------------
62
- // Import module under test (after mocks)
63
- // ---------------------------------------------------------------------------
64
-
65
- const { registerTaskCommand } = await import("../task.js");
66
-
67
- // ---------------------------------------------------------------------------
68
- // Test helper
69
- // ---------------------------------------------------------------------------
70
-
71
- async function runCommand(
72
- args: string[],
73
- ): Promise<{ stdout: string; exitCode: number }> {
74
- const originalStdoutWrite = process.stdout.write.bind(process.stdout);
75
- const stdoutChunks: string[] = [];
76
-
77
- process.stdout.write = ((chunk: unknown) => {
78
- stdoutChunks.push(typeof chunk === "string" ? chunk : String(chunk));
79
- return true;
80
- }) as typeof process.stdout.write;
81
-
82
- process.exitCode = 0;
83
-
84
- try {
85
- const program = new Command();
86
- program.exitOverride();
87
- program.configureOutput({
88
- writeErr: () => {},
89
- writeOut: (str: string) => stdoutChunks.push(str),
90
- });
91
- registerTaskCommand(program);
92
- await program.parseAsync(["node", "assistant", ...args]);
93
- } catch {
94
- if (process.exitCode === 0) process.exitCode = 1;
95
- } finally {
96
- process.stdout.write = originalStdoutWrite;
97
- }
98
-
99
- const exitCode = process.exitCode ?? 0;
100
- process.exitCode = 0;
101
-
102
- return {
103
- exitCode,
104
- stdout: stdoutChunks.join(""),
105
- };
106
- }
107
-
108
- // ---------------------------------------------------------------------------
109
- // Setup
110
- // ---------------------------------------------------------------------------
111
-
112
- /** Saved env vars to restore after each test. */
113
- let savedConvId: string | undefined;
114
- let savedSkillCtx: string | undefined;
115
-
116
- beforeEach(() => {
117
- lastIpcCall = null;
118
- mockIpcResult = { ok: true, result: {} };
119
- process.exitCode = 0;
120
-
121
- // Save and clear env vars that resolveConversationId reads
122
- savedConvId = process.env.__CONVERSATION_ID;
123
- savedSkillCtx = process.env.__SKILL_CONTEXT_JSON;
124
- delete process.env.__CONVERSATION_ID;
125
- delete process.env.__SKILL_CONTEXT_JSON;
126
- });
127
-
128
- // Restore env vars after each test
129
- import { afterEach } from "bun:test";
130
-
131
- afterEach(() => {
132
- if (savedConvId !== undefined) {
133
- process.env.__CONVERSATION_ID = savedConvId;
134
- } else {
135
- delete process.env.__CONVERSATION_ID;
136
- }
137
- if (savedSkillCtx !== undefined) {
138
- process.env.__SKILL_CONTEXT_JSON = savedSkillCtx;
139
- } else {
140
- delete process.env.__SKILL_CONTEXT_JSON;
141
- }
142
- });
143
-
144
- // ===========================================================================
145
- // Template subcommands
146
- // ===========================================================================
147
-
148
- // ---------------------------------------------------------------------------
149
- // task list
150
- // ---------------------------------------------------------------------------
151
-
152
- describe("task list", () => {
153
- test("calls task/list IPC and succeeds", async () => {
154
- mockIpcResult = {
155
- ok: true,
156
- result: [{ id: "t1", name: "deploy" }],
157
- };
158
-
159
- const { exitCode } = await runCommand(["task", "list"]);
160
-
161
- expect(exitCode).toBe(0);
162
- expect(lastIpcCall).toBeDefined();
163
- expect(lastIpcCall!.method).toBe("task_list");
164
- });
165
-
166
- test("--json outputs { ok: true, result: ... }", async () => {
167
- mockIpcResult = {
168
- ok: true,
169
- result: [{ id: "t1", name: "deploy" }],
170
- };
171
-
172
- const { exitCode, stdout } = await runCommand(["task", "list", "--json"]);
173
-
174
- expect(exitCode).toBe(0);
175
- const parsed = JSON.parse(stdout);
176
- expect(parsed).toEqual({
177
- ok: true,
178
- result: [{ id: "t1", name: "deploy" }],
179
- });
180
- });
181
-
182
- test("IPC failure sets exitCode 1", async () => {
183
- mockIpcResult = { ok: false, error: "Connection refused" };
184
-
185
- const { exitCode } = await runCommand(["task", "list"]);
186
-
187
- expect(exitCode).toBe(1);
188
- });
189
- });
190
-
191
- // ---------------------------------------------------------------------------
192
- // task save
193
- // ---------------------------------------------------------------------------
194
-
195
- describe("task save", () => {
196
- test("calls task/save with explicit --conversation-id and --title", async () => {
197
- mockIpcResult = { ok: true, result: { id: "task-1" } };
198
-
199
- const { exitCode } = await runCommand([
200
- "task",
201
- "save",
202
- "--conversation-id",
203
- "conv-123",
204
- "--title",
205
- "My Task",
206
- ]);
207
-
208
- expect(exitCode).toBe(0);
209
- expect(lastIpcCall).toBeDefined();
210
- expect(lastIpcCall!.method).toBe("task_save");
211
- expect(lastIpcCall!.params!.body).toEqual({
212
- conversation_id: "conv-123",
213
- title: "My Task",
214
- });
215
- });
216
-
217
- test("resolves conversation ID from __CONVERSATION_ID env var", async () => {
218
- process.env.__CONVERSATION_ID = "env-conv-456";
219
- mockIpcResult = { ok: true, result: { id: "task-2" } };
220
-
221
- const { exitCode } = await runCommand(["task", "save"]);
222
-
223
- expect(exitCode).toBe(0);
224
- expect(lastIpcCall!.method).toBe("task_save");
225
- expect(lastIpcCall!.params!.body!.conversation_id).toBe("env-conv-456");
226
- });
227
-
228
- test("prefers __SKILL_CONTEXT_JSON over __CONVERSATION_ID", async () => {
229
- process.env.__CONVERSATION_ID = "env-conv-should-not-use";
230
- process.env.__SKILL_CONTEXT_JSON = JSON.stringify({
231
- conversationId: "skill-conv-789",
232
- });
233
- mockIpcResult = { ok: true, result: { id: "task-3" } };
234
-
235
- const { exitCode } = await runCommand(["task", "save"]);
236
-
237
- expect(exitCode).toBe(0);
238
- expect(lastIpcCall!.params!.body!.conversation_id).toBe("skill-conv-789");
239
- });
240
-
241
- test("exits with error when no conversation ID is available", async () => {
242
- // No env vars set, no explicit flag
243
- const { exitCode } = await runCommand(["task", "save"]);
244
-
245
- expect(exitCode).toBe(1);
246
- expect(lastIpcCall).toBeNull();
247
- });
248
-
249
- test("--json outputs error when no conversation ID is available", async () => {
250
- const { exitCode, stdout } = await runCommand(["task", "save", "--json"]);
251
-
252
- expect(exitCode).toBe(1);
253
- const parsed = JSON.parse(stdout);
254
- expect(parsed.ok).toBe(false);
255
- expect(parsed.error).toContain("No conversation ID");
256
- });
257
-
258
- test("--json outputs { ok: true, result: ... } on success", async () => {
259
- process.env.__CONVERSATION_ID = "conv-json-test";
260
- mockIpcResult = { ok: true, result: { id: "task-json" } };
261
-
262
- const { exitCode, stdout } = await runCommand(["task", "save", "--json"]);
263
-
264
- expect(exitCode).toBe(0);
265
- const parsed = JSON.parse(stdout);
266
- expect(parsed).toEqual({ ok: true, result: { id: "task-json" } });
267
- });
268
-
269
- test("IPC failure sets exitCode 1", async () => {
270
- process.env.__CONVERSATION_ID = "conv-fail";
271
- mockIpcResult = { ok: false, error: "Internal error" };
272
-
273
- const { exitCode } = await runCommand(["task", "save"]);
274
-
275
- expect(exitCode).toBe(1);
276
- });
277
- });
278
-
279
- // ---------------------------------------------------------------------------
280
- // task run
281
- // ---------------------------------------------------------------------------
282
-
283
- describe("task run", () => {
284
- test("calls task/run with --name and --inputs", async () => {
285
- mockIpcResult = { ok: true, result: { conversationId: "c1" } };
286
-
287
- const { exitCode } = await runCommand([
288
- "task",
289
- "run",
290
- "--name",
291
- "deploy",
292
- "--inputs",
293
- '{"env":"prod"}',
294
- ]);
295
-
296
- expect(exitCode).toBe(0);
297
- expect(lastIpcCall).toBeDefined();
298
- expect(lastIpcCall!.method).toBe("task_run");
299
- expect(lastIpcCall!.params!.body).toEqual({
300
- task_name: "deploy",
301
- inputs: { env: "prod" },
302
- });
303
- });
304
-
305
- test("calls task/run with --id", async () => {
306
- mockIpcResult = { ok: true, result: { conversationId: "c2" } };
307
-
308
- const { exitCode } = await runCommand([
309
- "task",
310
- "run",
311
- "--id",
312
- "task_abc123",
313
- ]);
314
-
315
- expect(exitCode).toBe(0);
316
- expect(lastIpcCall!.params!.body).toEqual({ task_id: "task_abc123" });
317
- });
318
-
319
- test("exits with error on invalid JSON --inputs", async () => {
320
- const { exitCode } = await runCommand([
321
- "task",
322
- "run",
323
- "--name",
324
- "deploy",
325
- "--inputs",
326
- "{bad json}",
327
- ]);
328
-
329
- expect(exitCode).toBe(1);
330
- expect(lastIpcCall).toBeNull();
331
- });
332
-
333
- test("--json outputs error on invalid --inputs", async () => {
334
- const { exitCode, stdout } = await runCommand([
335
- "task",
336
- "run",
337
- "--name",
338
- "deploy",
339
- "--inputs",
340
- "{bad}",
341
- "--json",
342
- ]);
343
-
344
- expect(exitCode).toBe(1);
345
- const parsed = JSON.parse(stdout);
346
- expect(parsed.ok).toBe(false);
347
- expect(parsed.error).toContain("Invalid JSON for --inputs");
348
- });
349
-
350
- test("--json outputs { ok: true, result: ... } on success", async () => {
351
- mockIpcResult = { ok: true, result: { conversationId: "c3" } };
352
-
353
- const { exitCode, stdout } = await runCommand([
354
- "task",
355
- "run",
356
- "--name",
357
- "deploy",
358
- "--json",
359
- ]);
360
-
361
- expect(exitCode).toBe(0);
362
- const parsed = JSON.parse(stdout);
363
- expect(parsed).toEqual({
364
- ok: true,
365
- result: { conversationId: "c3" },
366
- });
367
- });
368
-
369
- test("IPC failure sets exitCode 1", async () => {
370
- mockIpcResult = { ok: false, error: "Task not found" };
371
-
372
- const { exitCode } = await runCommand([
373
- "task",
374
- "run",
375
- "--name",
376
- "nonexistent",
377
- ]);
378
-
379
- expect(exitCode).toBe(1);
380
- });
381
- });
382
-
383
- // ---------------------------------------------------------------------------
384
- // task delete
385
- // ---------------------------------------------------------------------------
386
-
387
- describe("task delete", () => {
388
- test("passes variadic IDs as task_ids array", async () => {
389
- mockIpcResult = { ok: true, result: { deleted: 2 } };
390
-
391
- const { exitCode } = await runCommand(["task", "delete", "id1", "id2"]);
392
-
393
- expect(exitCode).toBe(0);
394
- expect(lastIpcCall).toBeDefined();
395
- expect(lastIpcCall!.method).toBe("task_delete");
396
- expect(lastIpcCall!.params!.body).toEqual({ task_ids: ["id1", "id2"] });
397
- });
398
-
399
- test("passes single ID as task_ids array", async () => {
400
- mockIpcResult = { ok: true, result: { deleted: 1 } };
401
-
402
- const { exitCode } = await runCommand(["task", "delete", "id1"]);
403
-
404
- expect(exitCode).toBe(0);
405
- expect(lastIpcCall!.params!.body).toEqual({ task_ids: ["id1"] });
406
- });
407
-
408
- test("--json outputs { ok: true, result: ... } on success", async () => {
409
- mockIpcResult = { ok: true, result: { deleted: 1 } };
410
-
411
- const { exitCode, stdout } = await runCommand([
412
- "task",
413
- "delete",
414
- "id1",
415
- "--json",
416
- ]);
417
-
418
- expect(exitCode).toBe(0);
419
- const parsed = JSON.parse(stdout);
420
- expect(parsed).toEqual({ ok: true, result: { deleted: 1 } });
421
- });
422
-
423
- test("IPC failure sets exitCode 1", async () => {
424
- mockIpcResult = { ok: false, error: "Not found" };
425
-
426
- const { exitCode } = await runCommand(["task", "delete", "id1"]);
427
-
428
- expect(exitCode).toBe(1);
429
- });
430
-
431
- test("--json outputs error on IPC failure", async () => {
432
- mockIpcResult = { ok: false, error: "Not found" };
433
-
434
- const { exitCode, stdout } = await runCommand([
435
- "task",
436
- "delete",
437
- "id1",
438
- "--json",
439
- ]);
440
-
441
- expect(exitCode).toBe(1);
442
- const parsed = JSON.parse(stdout);
443
- expect(parsed).toEqual({ ok: false, error: "Not found" });
444
- });
445
- });
446
-
447
- // ===========================================================================
448
- // Queue subcommands
449
- // ===========================================================================
450
-
451
- // ---------------------------------------------------------------------------
452
- // task queue show
453
- // ---------------------------------------------------------------------------
454
-
455
- describe("task queue show", () => {
456
- test("calls task/queue/show IPC with no params", async () => {
457
- mockIpcResult = {
458
- ok: true,
459
- result: { content: "No items in queue" },
460
- };
461
-
462
- const { exitCode } = await runCommand(["task", "queue", "show"]);
463
-
464
- expect(exitCode).toBe(0);
465
- expect(lastIpcCall).toBeDefined();
466
- expect(lastIpcCall!.method).toBe("task_queue_show");
467
- expect(lastIpcCall!.params!.body).toEqual({});
468
- });
469
-
470
- test("passes --status filter", async () => {
471
- mockIpcResult = {
472
- ok: true,
473
- result: { content: "1 queued item" },
474
- };
475
-
476
- const { exitCode } = await runCommand([
477
- "task",
478
- "queue",
479
- "show",
480
- "--status",
481
- "queued",
482
- ]);
483
-
484
- expect(exitCode).toBe(0);
485
- expect(lastIpcCall!.params!.body).toEqual({ status: "queued" });
486
- });
487
-
488
- test("--json outputs { ok: true, result: ... } on success", async () => {
489
- mockIpcResult = {
490
- ok: true,
491
- result: { content: "items" },
492
- };
493
-
494
- const { exitCode, stdout } = await runCommand([
495
- "task",
496
- "queue",
497
- "show",
498
- "--json",
499
- ]);
500
-
501
- expect(exitCode).toBe(0);
502
- const parsed = JSON.parse(stdout);
503
- expect(parsed).toEqual({ ok: true, result: { content: "items" } });
504
- });
505
-
506
- test("IPC failure sets exitCode 1", async () => {
507
- mockIpcResult = { ok: false, error: "Connection refused" };
508
-
509
- const { exitCode } = await runCommand(["task", "queue", "show"]);
510
-
511
- expect(exitCode).toBe(1);
512
- });
513
- });
514
-
515
- // ---------------------------------------------------------------------------
516
- // task queue add
517
- // ---------------------------------------------------------------------------
518
-
519
- describe("task queue add", () => {
520
- test("maps flags to snake_case params", async () => {
521
- mockIpcResult = {
522
- ok: true,
523
- result: { content: "Added" },
524
- };
525
-
526
- const { exitCode } = await runCommand([
527
- "task",
528
- "queue",
529
- "add",
530
- "--title",
531
- "Fix bug",
532
- "--priority",
533
- "0",
534
- ]);
535
-
536
- expect(exitCode).toBe(0);
537
- expect(lastIpcCall).toBeDefined();
538
- expect(lastIpcCall!.method).toBe("task_queue_add");
539
- expect(lastIpcCall!.params!.body!.title).toBe("Fix bug");
540
- expect(lastIpcCall!.params!.body!.priority_tier).toBe(0);
541
- });
542
-
543
- test("splits --required-tools by comma", async () => {
544
- mockIpcResult = {
545
- ok: true,
546
- result: { content: "Added" },
547
- };
548
-
549
- const { exitCode } = await runCommand([
550
- "task",
551
- "queue",
552
- "add",
553
- "--title",
554
- "Build",
555
- "--required-tools",
556
- "host_bash,host_file_read",
557
- ]);
558
-
559
- expect(exitCode).toBe(0);
560
- expect(lastIpcCall!.params!.body!.required_tools).toEqual([
561
- "host_bash",
562
- "host_file_read",
563
- ]);
564
- });
565
-
566
- test("handles --required-tools with spaces after commas", async () => {
567
- mockIpcResult = {
568
- ok: true,
569
- result: { content: "Added" },
570
- };
571
-
572
- const { exitCode } = await runCommand([
573
- "task",
574
- "queue",
575
- "add",
576
- "--title",
577
- "Build",
578
- "--required-tools",
579
- "host_bash, host_file_read, browser",
580
- ]);
581
-
582
- expect(exitCode).toBe(0);
583
- expect(lastIpcCall!.params!.body!.required_tools).toEqual([
584
- "host_bash",
585
- "host_file_read",
586
- "browser",
587
- ]);
588
- });
589
-
590
- test("passes --if-exists strategy", async () => {
591
- mockIpcResult = {
592
- ok: true,
593
- result: { content: "Reused" },
594
- };
595
-
596
- const { exitCode } = await runCommand([
597
- "task",
598
- "queue",
599
- "add",
600
- "--title",
601
- "Deploy",
602
- "--if-exists",
603
- "reuse_existing",
604
- ]);
605
-
606
- expect(exitCode).toBe(0);
607
- expect(lastIpcCall!.params!.body!.if_exists).toBe("reuse_existing");
608
- });
609
-
610
- test("passes --name as task_name", async () => {
611
- mockIpcResult = {
612
- ok: true,
613
- result: { content: "Added" },
614
- };
615
-
616
- const { exitCode } = await runCommand([
617
- "task",
618
- "queue",
619
- "add",
620
- "--name",
621
- "Deploy workflow",
622
- "--title",
623
- "Deploy v2",
624
- ]);
625
-
626
- expect(exitCode).toBe(0);
627
- expect(lastIpcCall!.params!.body!.task_name).toBe("Deploy workflow");
628
- expect(lastIpcCall!.params!.body!.title).toBe("Deploy v2");
629
- });
630
-
631
- test("--json outputs { ok: true, result: ... } on success", async () => {
632
- mockIpcResult = {
633
- ok: true,
634
- result: { content: "Added item" },
635
- };
636
-
637
- const { exitCode, stdout } = await runCommand([
638
- "task",
639
- "queue",
640
- "add",
641
- "--title",
642
- "Test",
643
- "--json",
644
- ]);
645
-
646
- expect(exitCode).toBe(0);
647
- const parsed = JSON.parse(stdout);
648
- expect(parsed).toEqual({ ok: true, result: { content: "Added item" } });
649
- });
650
-
651
- test("IPC failure sets exitCode 1", async () => {
652
- mockIpcResult = { ok: false, error: "Internal error" };
653
-
654
- const { exitCode } = await runCommand([
655
- "task",
656
- "queue",
657
- "add",
658
- "--title",
659
- "Test",
660
- ]);
661
-
662
- expect(exitCode).toBe(1);
663
- });
664
- });
665
-
666
- // ---------------------------------------------------------------------------
667
- // task queue update
668
- // ---------------------------------------------------------------------------
669
-
670
- describe("task queue update", () => {
671
- test("passes --work-item-id and --status", async () => {
672
- mockIpcResult = {
673
- ok: true,
674
- result: { content: "Updated" },
675
- };
676
-
677
- const { exitCode } = await runCommand([
678
- "task",
679
- "queue",
680
- "update",
681
- "--work-item-id",
682
- "wi-1",
683
- "--status",
684
- "done",
685
- ]);
686
-
687
- expect(exitCode).toBe(0);
688
- expect(lastIpcCall).toBeDefined();
689
- expect(lastIpcCall!.method).toBe("task_queue_update");
690
- expect(lastIpcCall!.params!.body!.work_item_id).toBe("wi-1");
691
- expect(lastIpcCall!.params!.body!.status).toBe("done");
692
- });
693
-
694
- test("passes --priority as priority_tier", async () => {
695
- mockIpcResult = {
696
- ok: true,
697
- result: { content: "Updated" },
698
- };
699
-
700
- const { exitCode } = await runCommand([
701
- "task",
702
- "queue",
703
- "update",
704
- "--work-item-id",
705
- "wi-2",
706
- "--priority",
707
- "1",
708
- ]);
709
-
710
- expect(exitCode).toBe(0);
711
- expect(lastIpcCall!.params!.body!.priority_tier).toBe(1);
712
- });
713
-
714
- test("--json outputs { ok: true, result: ... } on success", async () => {
715
- mockIpcResult = {
716
- ok: true,
717
- result: { content: "Updated" },
718
- };
719
-
720
- const { exitCode, stdout } = await runCommand([
721
- "task",
722
- "queue",
723
- "update",
724
- "--work-item-id",
725
- "wi-1",
726
- "--status",
727
- "done",
728
- "--json",
729
- ]);
730
-
731
- expect(exitCode).toBe(0);
732
- const parsed = JSON.parse(stdout);
733
- expect(parsed).toEqual({ ok: true, result: { content: "Updated" } });
734
- });
735
-
736
- test("IPC failure sets exitCode 1", async () => {
737
- mockIpcResult = { ok: false, error: "Not found" };
738
-
739
- const { exitCode } = await runCommand([
740
- "task",
741
- "queue",
742
- "update",
743
- "--work-item-id",
744
- "wi-1",
745
- "--status",
746
- "done",
747
- ]);
748
-
749
- expect(exitCode).toBe(1);
750
- });
751
- });
752
-
753
- // ---------------------------------------------------------------------------
754
- // task queue remove
755
- // ---------------------------------------------------------------------------
756
-
757
- describe("task queue remove", () => {
758
- test("passes --title filter", async () => {
759
- mockIpcResult = {
760
- ok: true,
761
- result: { content: "Removed" },
762
- };
763
-
764
- const { exitCode } = await runCommand([
765
- "task",
766
- "queue",
767
- "remove",
768
- "--title",
769
- "Fix bug",
770
- ]);
771
-
772
- expect(exitCode).toBe(0);
773
- expect(lastIpcCall).toBeDefined();
774
- expect(lastIpcCall!.method).toBe("task_queue_remove");
775
- expect(lastIpcCall!.params!.body!.title).toBe("Fix bug");
776
- });
777
-
778
- test("passes --work-item-id", async () => {
779
- mockIpcResult = {
780
- ok: true,
781
- result: { content: "Removed" },
782
- };
783
-
784
- const { exitCode } = await runCommand([
785
- "task",
786
- "queue",
787
- "remove",
788
- "--work-item-id",
789
- "wi-abc",
790
- ]);
791
-
792
- expect(exitCode).toBe(0);
793
- expect(lastIpcCall!.params!.body!.work_item_id).toBe("wi-abc");
794
- });
795
-
796
- test("--json outputs { ok: true, result: ... } on success", async () => {
797
- mockIpcResult = {
798
- ok: true,
799
- result: { content: "Removed 1 item" },
800
- };
801
-
802
- const { exitCode, stdout } = await runCommand([
803
- "task",
804
- "queue",
805
- "remove",
806
- "--title",
807
- "Fix bug",
808
- "--json",
809
- ]);
810
-
811
- expect(exitCode).toBe(0);
812
- const parsed = JSON.parse(stdout);
813
- expect(parsed).toEqual({
814
- ok: true,
815
- result: { content: "Removed 1 item" },
816
- });
817
- });
818
-
819
- test("IPC failure sets exitCode 1", async () => {
820
- mockIpcResult = { ok: false, error: "Queue error" };
821
-
822
- const { exitCode } = await runCommand([
823
- "task",
824
- "queue",
825
- "remove",
826
- "--title",
827
- "Fix bug",
828
- ]);
829
-
830
- expect(exitCode).toBe(1);
831
- });
832
- });
833
-
834
- // ---------------------------------------------------------------------------
835
- // task queue run
836
- // ---------------------------------------------------------------------------
837
-
838
- describe("task queue run", () => {
839
- test("calls task/queue/run with --work-item-id", async () => {
840
- mockIpcResult = {
841
- ok: true,
842
- result: { content: "Running" },
843
- };
844
-
845
- const { exitCode } = await runCommand([
846
- "task",
847
- "queue",
848
- "run",
849
- "--work-item-id",
850
- "wi-1",
851
- ]);
852
-
853
- expect(exitCode).toBe(0);
854
- expect(lastIpcCall).toBeDefined();
855
- expect(lastIpcCall!.method).toBe("task_queue_run");
856
- expect(lastIpcCall!.params!.body!.work_item_id).toBe("wi-1");
857
- });
858
-
859
- test("calls task/queue/run with no params (next eligible)", async () => {
860
- mockIpcResult = {
861
- ok: true,
862
- result: { content: "Running next item" },
863
- };
864
-
865
- const { exitCode } = await runCommand(["task", "queue", "run"]);
866
-
867
- expect(exitCode).toBe(0);
868
- expect(lastIpcCall!.method).toBe("task_queue_run");
869
- expect(lastIpcCall!.params!.body).toEqual({});
870
- });
871
-
872
- test("--json outputs { ok: true, result: ... } on success", async () => {
873
- mockIpcResult = {
874
- ok: true,
875
- result: { content: "Running" },
876
- };
877
-
878
- const { exitCode, stdout } = await runCommand([
879
- "task",
880
- "queue",
881
- "run",
882
- "--work-item-id",
883
- "wi-1",
884
- "--json",
885
- ]);
886
-
887
- expect(exitCode).toBe(0);
888
- const parsed = JSON.parse(stdout);
889
- expect(parsed).toEqual({ ok: true, result: { content: "Running" } });
890
- });
891
-
892
- test("IPC failure sets exitCode 1", async () => {
893
- mockIpcResult = { ok: false, error: "No items available" };
894
-
895
- const { exitCode } = await runCommand(["task", "queue", "run"]);
896
-
897
- expect(exitCode).toBe(1);
898
- });
899
-
900
- test("--json outputs error on IPC failure", async () => {
901
- mockIpcResult = { ok: false, error: "No items available" };
902
-
903
- const { exitCode, stdout } = await runCommand([
904
- "task",
905
- "queue",
906
- "run",
907
- "--json",
908
- ]);
909
-
910
- expect(exitCode).toBe(1);
911
- const parsed = JSON.parse(stdout);
912
- expect(parsed).toEqual({ ok: false, error: "No items available" });
913
- });
914
- });