@vellumai/assistant 0.10.2 → 0.10.3-dev.202606252046.9075fd5

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 (546) hide show
  1. package/bun.lock +20 -0
  2. package/docs/workspace-tools.md +42 -33
  3. package/eslint-rules/cli-no-daemon-internals.js +6 -0
  4. package/node_modules/@vellumai/gateway-client/src/__tests__/guardian-delivery-contract.test.ts +91 -0
  5. package/node_modules/@vellumai/gateway-client/src/__tests__/trust-verdict-contract.test.ts +31 -0
  6. package/node_modules/@vellumai/gateway-client/src/gateway-ipc-contracts.ts +44 -0
  7. package/node_modules/@vellumai/gateway-client/src/guardian-delivery-contract.ts +48 -0
  8. package/node_modules/@vellumai/gateway-client/src/index.ts +14 -0
  9. package/node_modules/@vellumai/gateway-client/src/trust-verdict-contract.ts +17 -0
  10. package/node_modules/@vellumai/service-contracts/package.json +1 -0
  11. package/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts +28 -0
  12. package/node_modules/@vellumai/service-contracts/src/channels.ts +41 -0
  13. package/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  14. package/openapi.yaml +196 -56
  15. package/package.json +4 -1
  16. package/scripts/test.sh +36 -15
  17. package/src/__tests__/actor-token-service.test.ts +36 -14
  18. package/src/__tests__/actor-trust-resolver-address-fallback.test.ts +83 -31
  19. package/src/__tests__/agent-loop-override-profile.test.ts +1 -0
  20. package/src/__tests__/agent-wake-disk-pressure-callsite.test.ts +2 -0
  21. package/src/__tests__/agent-wake-override-profile.test.ts +2 -0
  22. package/src/__tests__/annotate-activity-metadata.test.ts +2 -0
  23. package/src/__tests__/annotate-risk-options.test.ts +2 -0
  24. package/src/__tests__/approval-cascade.test.ts +2 -0
  25. package/src/__tests__/assistant-attachments.test.ts +42 -0
  26. package/src/__tests__/background-workers-disk-pressure.test.ts +2 -0
  27. package/src/__tests__/btw-routes.test.ts +2 -0
  28. package/src/__tests__/build-persisted-content.test.ts +2 -0
  29. package/src/__tests__/call-controller.test.ts +19 -0
  30. package/src/__tests__/channel-approval-routes.test.ts +21 -26
  31. package/src/__tests__/channel-delivery-store.test.ts +28 -0
  32. package/src/__tests__/channel-guardian.test.ts +164 -78
  33. package/src/__tests__/channel-inbound-disk-pressure.test.ts +11 -19
  34. package/src/__tests__/channel-reply-delivery.test.ts +2 -0
  35. package/src/__tests__/code-search-tool.test.ts +585 -0
  36. package/src/__tests__/compaction-events.test.ts +2 -0
  37. package/src/__tests__/compaction-ledger-store.test.ts +128 -0
  38. package/src/__tests__/compaction.benchmark.test.ts +2 -0
  39. package/src/__tests__/compactor-call-site-logging.test.ts +2 -0
  40. package/src/__tests__/compactor-low-watermark-cut.test.ts +2 -0
  41. package/src/__tests__/compactor-preserved-tail-count.test.ts +2 -0
  42. package/src/__tests__/compactor-summary-call-truncation.test.ts +2 -0
  43. package/src/__tests__/compactor-web-search-strip.test.ts +2 -0
  44. package/src/__tests__/config-loader-backfill.test.ts +123 -10
  45. package/src/__tests__/config-schema.test.ts +1 -0
  46. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +31 -29
  47. package/src/__tests__/consult-deadline.test.ts +60 -0
  48. package/src/__tests__/contact-store-interaction-info.test.ts +156 -0
  49. package/src/__tests__/contact-store-user-file.test.ts +7 -10
  50. package/src/__tests__/contacts-relay-reads.test.ts +19 -24
  51. package/src/__tests__/contacts-write.test.ts +0 -2
  52. package/src/__tests__/conversation-abort-tool-results.test.ts +2 -0
  53. package/src/__tests__/conversation-agent-loop-disk-pressure.test.ts +2 -0
  54. package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +2 -0
  55. package/src/__tests__/conversation-agent-loop-overflow.test.ts +2 -0
  56. package/src/__tests__/conversation-agent-loop.test.ts +134 -0
  57. package/src/__tests__/conversation-analysis-routes.test.ts +2 -0
  58. package/src/__tests__/conversation-app-control-lifecycle.test.ts +2 -0
  59. package/src/__tests__/conversation-attention-telegram.test.ts +9 -11
  60. package/src/__tests__/conversation-confirmation-signals.test.ts +2 -0
  61. package/src/__tests__/conversation-fork-crud.test.ts +354 -24
  62. package/src/__tests__/conversation-history-web-search.test.ts +2 -0
  63. package/src/__tests__/conversation-load-history-repair.test.ts +2 -0
  64. package/src/__tests__/conversation-load-history-stripped.test.ts +2 -0
  65. package/src/__tests__/conversation-pairing.test.ts +2 -0
  66. package/src/__tests__/conversation-process-app-control-preactivation.test.ts +2 -0
  67. package/src/__tests__/conversation-process-callsite.test.ts +2 -0
  68. package/src/__tests__/conversation-provider-retry-repair.test.ts +2 -0
  69. package/src/__tests__/conversation-queue.test.ts +91 -0
  70. package/src/__tests__/conversation-routes-guardian-reply.test.ts +14 -0
  71. package/src/__tests__/conversation-routes-slash-commands.test.ts +14 -0
  72. package/src/__tests__/conversation-slash-queue.test.ts +2 -0
  73. package/src/__tests__/conversation-slash-unknown.test.ts +2 -0
  74. package/src/__tests__/conversation-speed-override.test.ts +2 -0
  75. package/src/__tests__/conversation-surfaces-task-progress.test.ts +29 -0
  76. package/src/__tests__/conversation-title-service.test.ts +2 -0
  77. package/src/__tests__/conversation-tool-setup-attribution.test.ts +47 -0
  78. package/src/__tests__/conversation-usage.test.ts +2 -0
  79. package/src/__tests__/conversation-workspace-cache-state.test.ts +2 -0
  80. package/src/__tests__/conversation-workspace-injection.test.ts +2 -0
  81. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +2 -0
  82. package/src/__tests__/credential-security-invariants.test.ts +1 -1
  83. package/src/__tests__/db-compaction-events-migration.test.ts +129 -0
  84. package/src/__tests__/db-migration-rollback.test.ts +205 -171
  85. package/src/__tests__/db-test-helpers.ts +5 -4
  86. package/src/__tests__/delete-propagation.test.ts +5 -3
  87. package/src/__tests__/deterministic-verification-control-plane.test.ts +4 -2
  88. package/src/__tests__/disk-pressure-guard.test.ts +41 -0
  89. package/src/__tests__/dm-backfill.test.ts +6 -4
  90. package/src/__tests__/dm-persistence.test.ts +2 -0
  91. package/src/__tests__/emit-signal-routing-intent.test.ts +7 -6
  92. package/src/__tests__/events-dev-bypass-actor.test.ts +7 -1
  93. package/src/__tests__/exploration-drift-hook.test.ts +3 -2
  94. package/src/__tests__/filing-service.test.ts +2 -0
  95. package/src/__tests__/guardian-binding-drift-heal.test.ts +104 -19
  96. package/src/__tests__/guardian-dispatch.test.ts +140 -1
  97. package/src/__tests__/guardian-expiry-notifier.test.ts +282 -0
  98. package/src/__tests__/guardian-outbound-http.test.ts +13 -0
  99. package/src/__tests__/guardian-routing-state.test.ts +6 -10
  100. package/src/__tests__/heartbeat-disk-pressure.test.ts +2 -0
  101. package/src/__tests__/heartbeat-service.test.ts +2 -0
  102. package/src/__tests__/helpers/channel-test-adapter.ts +46 -19
  103. package/src/__tests__/helpers/create-guardian-binding.ts +15 -23
  104. package/src/__tests__/helpers/mock-logger.ts +1 -0
  105. package/src/__tests__/helpers/seed-contact-channel.ts +96 -0
  106. package/src/__tests__/host-app-control-routes.test.ts +24 -30
  107. package/src/__tests__/host-bash-routes.test.ts +31 -41
  108. package/src/__tests__/host-browser-routes.test.ts +26 -32
  109. package/src/__tests__/host-cu-routes-targeted.test.ts +25 -33
  110. package/src/__tests__/host-file-routes-targeted.test.ts +40 -52
  111. package/src/__tests__/host-transfer-routes-targeted.test.ts +31 -43
  112. package/src/__tests__/http-user-message-parity.test.ts +290 -8
  113. package/src/__tests__/inbound-invite-redemption.test.ts +115 -10
  114. package/src/__tests__/inbound-slack-persistence.test.ts +2 -0
  115. package/src/__tests__/invite-redemption-service.test.ts +471 -53
  116. package/src/__tests__/invite-routes-http.test.ts +34 -0
  117. package/src/__tests__/invite-service-ipc.test.ts +65 -2
  118. package/src/__tests__/llm-context-normalization.test.ts +105 -0
  119. package/src/__tests__/llm-request-log-error-payload.test.ts +71 -9
  120. package/src/__tests__/llm-usage-store.test.ts +25 -0
  121. package/src/__tests__/mcp-config-secret-boundary.test.ts +392 -0
  122. package/src/__tests__/mcp-health-check.test.ts +2 -1
  123. package/src/__tests__/media-stream-server-integration.test.ts +127 -0
  124. package/src/__tests__/memory-retrieval-hook.test.ts +2 -0
  125. package/src/__tests__/messaging-send-tool.test.ts +2 -0
  126. package/src/__tests__/migration-import-from-url.test.ts +2 -2
  127. package/src/__tests__/mtime-cache.test.ts +275 -5
  128. package/src/__tests__/native-web-search.test.ts +2 -0
  129. package/src/__tests__/non-member-access-request.test.ts +191 -17
  130. package/src/__tests__/notification-broadcaster.test.ts +4 -0
  131. package/src/__tests__/notification-decision-recipient-context.test.ts +33 -32
  132. package/src/__tests__/notification-deep-link.test.ts +6 -0
  133. package/src/__tests__/notification-guardian-path.test.ts +19 -0
  134. package/src/__tests__/onboarding-persona-write.test.ts +52 -22
  135. package/src/__tests__/openai-provider.test.ts +22 -12
  136. package/src/__tests__/openai-responses-provider.test.ts +12 -2
  137. package/src/__tests__/outbound-slack-persistence.test.ts +2 -0
  138. package/src/__tests__/pending-interactions-resolved-event.test.ts +7 -4
  139. package/src/__tests__/persist-onboarding-artifacts.test.ts +1 -0
  140. package/src/__tests__/persistence-secret-redaction.test.ts +2 -0
  141. package/src/__tests__/persona-resolver.test.ts +75 -45
  142. package/src/__tests__/plugin-bootstrap.test.ts +21 -83
  143. package/src/__tests__/plugin-disabled-state.test.ts +190 -0
  144. package/src/__tests__/plugin-pipeline.test.ts +96 -0
  145. package/src/__tests__/plugin-route-contribution.test.ts +6 -19
  146. package/src/__tests__/plugin-tool-contribution.test.ts +5 -20
  147. package/src/__tests__/plugin-types.test.ts +2 -4
  148. package/src/__tests__/process-message-background-slack.test.ts +2 -0
  149. package/src/__tests__/process-message-display-content.test.ts +2 -0
  150. package/src/__tests__/provider-error-scenarios.test.ts +5 -4
  151. package/src/__tests__/provider-usage-tracking.test.ts +39 -0
  152. package/src/__tests__/reaction-intercept-cold-cache-warm.test.ts +135 -0
  153. package/src/__tests__/reaction-intercept-member-verdict-warm.test.ts +158 -0
  154. package/src/__tests__/reaction-persistence.test.ts +51 -4
  155. package/src/__tests__/regenerate-fire-and-forget-trace.test.ts +2 -0
  156. package/src/__tests__/registry.test.ts +4 -1
  157. package/src/__tests__/relay-server.test.ts +758 -32
  158. package/src/__tests__/runtime-attachment-metadata.test.ts +9 -12
  159. package/src/__tests__/secret-ingress-http.test.ts +14 -0
  160. package/src/__tests__/send-endpoint-busy.test.ts +30 -8
  161. package/src/__tests__/settings-routes.test.ts +32 -0
  162. package/src/__tests__/skills.test.ts +44 -0
  163. package/src/__tests__/slack-inbound-verification.test.ts +47 -2
  164. package/src/__tests__/sse-actor-principal-guardian-source.test.ts +79 -0
  165. package/src/__tests__/steer-on-enqueue-question.test.ts +181 -0
  166. package/src/__tests__/stt-hints.test.ts +49 -15
  167. package/src/__tests__/subagent-detail.test.ts +27 -0
  168. package/src/__tests__/subagent-disposal.test.ts +65 -0
  169. package/src/__tests__/subagent-fork-prompt-role.test.ts +195 -0
  170. package/src/__tests__/subagent-fork-spawn.test.ts +6 -7
  171. package/src/__tests__/subagent-notify-parent.test.ts +2 -0
  172. package/src/__tests__/subagent-role-registry.test.ts +24 -6
  173. package/src/__tests__/subagent-spawn-and-await.test.ts +546 -0
  174. package/src/__tests__/subagent-spawn-tool-fork.test.ts +2 -0
  175. package/src/__tests__/subagent-tools.test.ts +398 -1
  176. package/src/__tests__/suggestion-routes.test.ts +2 -0
  177. package/src/__tests__/thread-backfill.test.ts +3 -3
  178. package/src/__tests__/title-generate-hook.test.ts +2 -0
  179. package/src/__tests__/tool-executor-lifecycle-events.test.ts +2 -0
  180. package/src/__tests__/tool-executor.test.ts +16 -11
  181. package/src/__tests__/tool-preview-lifecycle.test.ts +2 -0
  182. package/src/__tests__/tool-result-metadata-plumbing.test.ts +2 -0
  183. package/src/__tests__/tool-start-timestamp.test.ts +2 -0
  184. package/src/__tests__/trusted-contact-approval-notifier.test.ts +37 -51
  185. package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +12 -12
  186. package/src/__tests__/trusted-contact-lifecycle-notifications.test.ts +9 -7
  187. package/src/__tests__/trusted-contact-multichannel.test.ts +16 -7
  188. package/src/__tests__/trusted-contact-verification.test.ts +79 -54
  189. package/src/__tests__/twilio-routes.test.ts +96 -0
  190. package/src/__tests__/ui-file-upload-surface.test.ts +86 -0
  191. package/src/__tests__/verification-control-plane-policy.test.ts +2 -0
  192. package/src/__tests__/voice-guardian-cold-cache-warm.test.ts +137 -0
  193. package/src/__tests__/voice-invite-redemption.test.ts +216 -20
  194. package/src/__tests__/web-search-backend-failure.test.ts +2 -0
  195. package/src/__tests__/workspace-migration-102-preserve-heartbeat-enabled-for-existing-workspaces.test.ts +3 -3
  196. package/src/__tests__/workspace-migration-111-prune-seeded-callsite-defaults.test.ts +208 -0
  197. package/src/__tests__/workspace-migration-112-remove-advisor-callsite-override.test.ts +170 -0
  198. package/src/__tests__/workspace-migration-drop-user-md.test.ts +196 -238
  199. package/src/__tests__/workspace-migration-remove-hooks.test.ts +14 -35
  200. package/src/__tests__/workspace-tool-loader.test.ts +195 -2
  201. package/src/a2a/__tests__/e2e-a2a-channel.test.ts +35 -47
  202. package/src/agent/loop-exclusive-tool.test.ts +154 -0
  203. package/src/agent/loop-native-web-search.test.ts +200 -0
  204. package/src/agent/loop.ts +164 -1
  205. package/src/api/constants/sse-replay.ts +41 -0
  206. package/src/api/events/conversation-notice.ts +26 -0
  207. package/src/api/index.ts +19 -1
  208. package/src/api/responses/llm-request-log-entry.ts +29 -0
  209. package/src/api/responses/subagent-detail.ts +17 -0
  210. package/src/api/surfaces.ts +39 -3
  211. package/src/approvals/guardian-channel-delivery.ts +30 -0
  212. package/src/approvals/guardian-expiry-notifier.ts +148 -0
  213. package/src/approvals/guardian-request-resolvers.ts +17 -15
  214. package/src/calls/__tests__/relay-setup-router.test.ts +267 -17
  215. package/src/calls/call-domain.ts +3 -3
  216. package/src/calls/guardian-dispatch.ts +14 -9
  217. package/src/calls/inbound-trust-reader.ts +24 -2
  218. package/src/calls/media-stream-server.ts +21 -0
  219. package/src/calls/relay-access-wait.ts +6 -6
  220. package/src/calls/relay-server.ts +188 -51
  221. package/src/calls/relay-setup-router.ts +47 -17
  222. package/src/calls/relay-verification.ts +4 -4
  223. package/src/calls/stt-hints.ts +9 -12
  224. package/src/calls/twilio-routes.ts +14 -4
  225. package/src/channels/types.ts +10 -20
  226. package/src/cli/commands/__tests__/cache.test.ts +8 -1
  227. package/src/cli/commands/__tests__/conversations-slack.test.ts +1 -0
  228. package/src/cli/commands/cache.ts +194 -181
  229. package/src/cli/commands/contacts.ts +10 -7
  230. package/src/cli/commands/db/__tests__/repair.test.ts +6 -5
  231. package/src/cli/commands/db/status.ts +37 -1
  232. package/src/cli/commands/mcp.ts +252 -218
  233. package/src/cli/commands/memory/__tests__/worker.test.ts +432 -0
  234. package/src/cli/commands/memory/index.ts +2 -0
  235. package/src/cli/commands/memory/worker.ts +242 -0
  236. package/src/cli/commands/plugins.ts +125 -13
  237. package/src/cli/lib/__tests__/install-from-github.test.ts +102 -0
  238. package/src/cli/lib/__tests__/list-installed-plugins.test.ts +160 -1
  239. package/src/cli/lib/__tests__/publish-plugin.test.ts +404 -0
  240. package/src/cli/lib/list-installed-plugins.ts +179 -1
  241. package/src/cli/lib/publish-plugin.ts +633 -0
  242. package/src/config/__tests__/loader-callsite-strip-fallback.test.ts +143 -0
  243. package/src/config/__tests__/sync-gated-profiles.test.ts +16 -10
  244. package/src/config/bundled-skills/contacts/tools/contact-merge.ts +27 -17
  245. package/src/config/bundled-skills/contacts/tools/contact-search.ts +13 -3
  246. package/src/config/bundled-skills/subagent/SKILL.md +17 -2
  247. package/src/config/bundled-skills/subagent/TOOLS.json +5 -4
  248. package/src/config/call-site-defaults.ts +0 -6
  249. package/src/config/feature-flag-registry.json +5 -13
  250. package/src/config/llm-resolver.ts +0 -3
  251. package/src/config/loader.ts +38 -5
  252. package/src/config/prune-seeded-callsite-defaults.ts +110 -0
  253. package/src/config/schemas/__tests__/memory-v3.test.ts +1 -0
  254. package/src/config/schemas/call-site-catalog.ts +0 -7
  255. package/src/config/schemas/heartbeat.ts +2 -5
  256. package/src/config/schemas/llm.ts +3 -12
  257. package/src/config/schemas/memory-lifecycle.ts +12 -0
  258. package/src/config/schemas/memory-v3.ts +7 -0
  259. package/src/config/schemas/memory.ts +4 -0
  260. package/src/config/schemas/timeouts.ts +8 -0
  261. package/src/config/seed-inference-profiles.ts +30 -34
  262. package/src/config/skills.ts +27 -5
  263. package/src/config/sync-gated-profiles.ts +12 -16
  264. package/src/contacts/__tests__/contacts-write-revoke-relay.test.ts +128 -0
  265. package/src/contacts/__tests__/guardian-delivery-reader.test.ts +312 -0
  266. package/src/contacts/__tests__/member-write-relay.test.ts +226 -0
  267. package/src/contacts/contact-store.ts +27 -237
  268. package/src/contacts/contacts-write.ts +18 -55
  269. package/src/contacts/gateway-channel-read.ts +51 -0
  270. package/src/contacts/guardian-delivery-reader.ts +223 -0
  271. package/src/contacts/member-write-relay.ts +183 -0
  272. package/src/contacts/types.ts +3 -15
  273. package/src/daemon/__tests__/conversation-tool-setup-exclude.test.ts +35 -0
  274. package/src/daemon/__tests__/conversation-tool-setup.test.ts +0 -44
  275. package/src/daemon/assistant-attachments.ts +27 -4
  276. package/src/daemon/conversation-agent-loop.ts +28 -0
  277. package/src/daemon/conversation-notices.ts +60 -0
  278. package/src/daemon/conversation-process.ts +35 -16
  279. package/src/daemon/conversation-surfaces.ts +111 -38
  280. package/src/daemon/conversation-tool-setup.ts +71 -30
  281. package/src/daemon/conversation.ts +23 -1
  282. package/src/daemon/disk-pressure-guard.ts +12 -2
  283. package/src/daemon/event-loop-watchdog.ts +28 -1
  284. package/src/daemon/external-plugins-bootstrap.ts +17 -41
  285. package/src/daemon/handlers/__tests__/config-a2a-accept.test.ts +0 -1
  286. package/src/daemon/handlers/__tests__/config-a2a-complete.test.ts +0 -2
  287. package/src/daemon/handlers/__tests__/config-a2a-redeem.test.ts +25 -2
  288. package/src/daemon/handlers/__tests__/config-channels.test.ts +220 -0
  289. package/src/daemon/handlers/config-a2a.ts +6 -14
  290. package/src/daemon/handlers/config-channels.ts +67 -26
  291. package/src/daemon/handlers/conversations.ts +77 -0
  292. package/src/daemon/lifecycle.ts +16 -0
  293. package/src/daemon/mcp-reload-service.ts +10 -0
  294. package/src/daemon/memory-v2-startup.test.ts +72 -0
  295. package/src/daemon/memory-v2-startup.ts +87 -19
  296. package/src/daemon/message-types/conversations.ts +2 -0
  297. package/src/daemon/message-types/surfaces.ts +12 -12
  298. package/src/daemon/server.ts +0 -4
  299. package/src/daemon/shutdown-handlers.ts +20 -0
  300. package/src/daemon/tool-setup-types.ts +9 -0
  301. package/src/heartbeat/heartbeat-service.ts +5 -0
  302. package/src/home/relationship-state-writer.ts +5 -0
  303. package/src/hooks/hook-loader.ts +341 -0
  304. package/src/ipc/__tests__/clients-list-ipc.test.ts +1 -1
  305. package/src/ipc/assistant-server.ts +2 -2
  306. package/src/mcp/__tests__/mcp-auth-orchestrator.test.ts +1 -0
  307. package/src/mcp/client.ts +15 -1
  308. package/src/mcp/mcp-auth-orchestrator.ts +6 -1
  309. package/src/mcp/mcp-header-store.ts +134 -0
  310. package/src/mcp/mcp-oauth-provider.ts +19 -8
  311. package/src/memory/__tests__/301-create-watchdog-events.test.ts +110 -0
  312. package/src/memory/__tests__/memory-retrospective-job.test.ts +8 -0
  313. package/src/memory/__tests__/prompt-override.test.ts +192 -0
  314. package/src/memory/__tests__/watchdog-events-store.test.ts +161 -0
  315. package/src/memory/compaction-ledger-store.ts +107 -0
  316. package/src/memory/conversation-crud.ts +129 -61
  317. package/src/memory/db-connection.ts +22 -3
  318. package/src/memory/db-init.ts +37 -503
  319. package/src/memory/db-singleton.ts +6 -4
  320. package/src/memory/jobs-worker.ts +104 -0
  321. package/src/memory/llm-request-log-store.ts +26 -1
  322. package/src/memory/llm-usage-store.ts +48 -20
  323. package/src/memory/memory-retrospective-job.ts +14 -8
  324. package/src/memory/migrations/209-strip-thinking-from-consolidated.ts +152 -56
  325. package/src/memory/migrations/300-add-processing-started-at.ts +30 -0
  326. package/src/memory/migrations/301-create-watchdog-events.ts +45 -0
  327. package/src/memory/migrations/302-create-compaction-events.ts +107 -0
  328. package/src/memory/migrations/__tests__/209-strip-thinking-from-consolidated.test.ts +297 -0
  329. package/src/memory/migrations/__tests__/run-migrations.test.ts +2 -2
  330. package/src/memory/migrations/run-migrations.ts +106 -10
  331. package/src/memory/migrations/validate-migration-state.ts +105 -67
  332. package/src/memory/prompt-override.ts +129 -0
  333. package/src/memory/schema/contacts.ts +6 -2
  334. package/src/memory/schema/conversations.ts +37 -0
  335. package/src/memory/schema/infrastructure.ts +20 -0
  336. package/src/memory/steps.ts +1294 -0
  337. package/src/memory/v2/__tests__/cli-command-store.test.ts +25 -0
  338. package/src/memory/v2/__tests__/skill-store.test.ts +80 -0
  339. package/src/memory/v2/cli-command-store.ts +75 -38
  340. package/src/memory/v2/prompts/consolidation.ts +13 -82
  341. package/src/memory/v2/prompts/router.ts +21 -93
  342. package/src/memory/v2/skill-store.ts +68 -31
  343. package/src/memory/watchdog-events-store.ts +87 -0
  344. package/src/memory/worker-control.ts +204 -0
  345. package/src/memory/worker-process.ts +89 -0
  346. package/src/messaging/channel-binding-metadata.ts +31 -0
  347. package/src/messaging/provider-types.ts +8 -0
  348. package/src/messaging/providers/slack/binding-metadata.ts +60 -0
  349. package/src/notifications/__tests__/broadcaster.test.ts +8 -8
  350. package/src/notifications/__tests__/connected-channels.test.ts +86 -0
  351. package/src/notifications/__tests__/decision-engine.test.ts +78 -9
  352. package/src/notifications/__tests__/destination-resolver.test.ts +151 -0
  353. package/src/notifications/broadcaster.ts +8 -1
  354. package/src/notifications/decision-engine.ts +15 -7
  355. package/src/notifications/destination-resolver.ts +53 -25
  356. package/src/notifications/emit-signal.ts +34 -15
  357. package/src/onboarding/checkin-event.test.ts +222 -0
  358. package/src/onboarding/checkin-event.ts +321 -0
  359. package/src/onboarding/schedule-checkin.ts +190 -0
  360. package/src/permissions/question-prompter.test.ts +1 -1
  361. package/src/permissions/question-prompter.ts +7 -4
  362. package/src/plugin-api/index.ts +12 -12
  363. package/src/plugin-api/types.ts +12 -14
  364. package/src/plugin-api/vision-support.test.ts +28 -4
  365. package/src/plugin-api/vision-support.ts +66 -31
  366. package/src/plugins/defaults/empty-response/hooks/post-model-call.ts +2 -2
  367. package/src/plugins/defaults/empty-response/hooks/stop.ts +2 -2
  368. package/src/plugins/defaults/exploration-drift/hooks/post-tool-use.ts +4 -3
  369. package/src/plugins/defaults/history-repair/hooks/post-model-call.ts +2 -2
  370. package/src/plugins/defaults/history-repair/hooks/stop.ts +2 -2
  371. package/src/plugins/defaults/history-repair/hooks/user-prompt-submit.ts +2 -2
  372. package/src/plugins/defaults/image-fallback/__tests__/image-fallback.test.ts +47 -7
  373. package/src/plugins/defaults/image-fallback/hooks/post-tool-use.ts +12 -13
  374. package/src/plugins/defaults/image-fallback/hooks/user-prompt-submit.ts +14 -22
  375. package/src/plugins/defaults/image-fallback/src/caption-blocks.ts +42 -11
  376. package/src/plugins/defaults/image-recovery/hooks/post-model-call.ts +2 -2
  377. package/src/plugins/defaults/image-recovery/hooks/stop.ts +2 -2
  378. package/src/plugins/defaults/index.ts +0 -35
  379. package/src/plugins/defaults/max-tokens-continue/hooks/post-model-call.ts +2 -2
  380. package/src/plugins/defaults/max-tokens-continue/hooks/stop.ts +2 -2
  381. package/src/plugins/defaults/memory-retrieval/hooks/post-compact.ts +2 -2
  382. package/src/plugins/defaults/memory-retrieval/hooks/user-prompt-submit.ts +2 -2
  383. package/src/plugins/defaults/memory-v3-shadow/__tests__/injection.test.ts +33 -3
  384. package/src/plugins/defaults/memory-v3-shadow/__tests__/pool-select.test.ts +48 -4
  385. package/src/plugins/defaults/memory-v3-shadow/__tests__/shadow-plugin.test.ts +4 -8
  386. package/src/plugins/defaults/memory-v3-shadow/hooks/post-compact.ts +2 -2
  387. package/src/plugins/defaults/memory-v3-shadow/hooks/user-prompt-submit.ts +2 -2
  388. package/src/plugins/defaults/memory-v3-shadow/injector.ts +43 -15
  389. package/src/plugins/defaults/memory-v3-shadow/orchestrate.ts +11 -2
  390. package/src/plugins/defaults/memory-v3-shadow/pool-select.test.ts +146 -0
  391. package/src/plugins/defaults/memory-v3-shadow/pool-select.ts +77 -13
  392. package/src/plugins/defaults/memory-v3-shadow/shadow-plugin.ts +12 -11
  393. package/src/plugins/defaults/surface-completion-nudge/hooks/post-model-call.ts +2 -2
  394. package/src/plugins/defaults/surface-completion-nudge/hooks/stop.ts +2 -2
  395. package/src/plugins/defaults/task-progress-nudge/hooks/post-tool-use.ts +2 -2
  396. package/src/plugins/defaults/title-generate/hooks/stop.ts +2 -2
  397. package/src/plugins/defaults/title-generate/hooks/user-prompt-submit.ts +2 -2
  398. package/src/plugins/defaults/tool-error/hooks/post-tool-use.ts +2 -2
  399. package/src/plugins/defaults/tool-result-truncate/hooks/post-tool-use.ts +2 -2
  400. package/src/plugins/disabled-state.ts +31 -0
  401. package/src/plugins/external-plugin-loader.ts +2 -2
  402. package/src/plugins/mtime-cache.ts +186 -330
  403. package/src/plugins/pipeline.ts +111 -13
  404. package/src/plugins/registry.ts +59 -16
  405. package/src/plugins/surface-import.ts +121 -0
  406. package/src/plugins/types.ts +7 -9
  407. package/src/prompts/persona-resolver.ts +43 -11
  408. package/src/providers/anthropic/client.ts +5 -0
  409. package/src/providers/call-site-routing.ts +45 -0
  410. package/src/providers/model-catalog.ts +16 -0
  411. package/src/providers/openai/__tests__/api-error-normalization.test.ts +321 -0
  412. package/src/providers/openai/api-error-normalization.ts +270 -0
  413. package/src/providers/openai/chat-completions-provider.ts +37 -83
  414. package/src/providers/openai/responses-provider.ts +50 -46
  415. package/src/providers/openrouter/client.ts +5 -0
  416. package/src/providers/provider-send-message.ts +10 -0
  417. package/src/providers/ratelimit.ts +10 -0
  418. package/src/providers/registry.ts +1 -1
  419. package/src/providers/retry.ts +10 -0
  420. package/src/providers/types.ts +22 -0
  421. package/src/providers/usage-tracking.ts +10 -0
  422. package/src/runtime/__tests__/channel-verification-service.test.ts +133 -0
  423. package/src/runtime/__tests__/guardian-vellum-migration.test.ts +184 -0
  424. package/src/runtime/__tests__/is-guardian-bound-for-channel.test.ts +66 -0
  425. package/src/runtime/__tests__/local-principal-trust.test.ts +162 -0
  426. package/src/runtime/__tests__/member-verdict-cache.test.ts +119 -0
  427. package/src/runtime/__tests__/trust-verdict-consumer.test.ts +402 -123
  428. package/src/runtime/access-request-helper.ts +18 -39
  429. package/src/runtime/actor-trust-resolver.ts +46 -19
  430. package/src/runtime/anchored-guardian.test.ts +109 -0
  431. package/src/runtime/anchored-guardian.ts +86 -0
  432. package/src/runtime/assistant-event-hub.ts +1 -1
  433. package/src/runtime/assistant-stream-state.ts +9 -2
  434. package/src/runtime/auth/__tests__/require-bound-guardian.test.ts +99 -0
  435. package/src/runtime/auth/require-bound-guardian.ts +21 -11
  436. package/src/runtime/channel-verification-service.ts +56 -31
  437. package/src/runtime/confirmation-request-guardian-bridge.ts +3 -3
  438. package/src/runtime/guardian-vellum-migration.ts +69 -8
  439. package/src/runtime/invite-redemption-service.ts +213 -187
  440. package/src/runtime/local-actor-identity.test.ts +108 -0
  441. package/src/runtime/local-actor-identity.ts +85 -13
  442. package/src/runtime/local-principal-trust.ts +52 -0
  443. package/src/runtime/member-verdict-cache.ts +0 -0
  444. package/src/runtime/pending-interactions.ts +11 -1
  445. package/src/runtime/routes/__tests__/channel-verification-revoke.test.ts +56 -5
  446. package/src/runtime/routes/__tests__/channel-verification-routes.test.ts +1 -1
  447. package/src/runtime/routes/__tests__/contact-routes.test.ts +305 -0
  448. package/src/runtime/routes/__tests__/global-search-routes.test.ts +92 -0
  449. package/src/runtime/routes/__tests__/http-adapter-actor-header.test.ts +129 -0
  450. package/src/runtime/routes/__tests__/surface-action-routes.test.ts +188 -0
  451. package/src/runtime/routes/browser-routes.ts +1 -1
  452. package/src/runtime/routes/canonical-guardian-expiry-sweep.ts +13 -5
  453. package/src/runtime/routes/channel-verification-routes.ts +3 -3
  454. package/src/runtime/routes/contact-routes.ts +48 -57
  455. package/src/runtime/routes/conversation-cli-routes.ts +4 -5
  456. package/src/runtime/routes/conversation-list-routes.ts +4 -7
  457. package/src/runtime/routes/conversation-query-routes.ts +72 -0
  458. package/src/runtime/routes/conversation-routes.ts +84 -85
  459. package/src/runtime/routes/events-routes.ts +2 -2
  460. package/src/runtime/routes/global-search-routes.ts +3 -1
  461. package/src/runtime/routes/guardian-action-routes.ts +4 -5
  462. package/src/runtime/routes/host-app-control-routes.ts +5 -4
  463. package/src/runtime/routes/host-bash-routes.ts +5 -4
  464. package/src/runtime/routes/host-browser-routes.ts +9 -11
  465. package/src/runtime/routes/host-cu-routes.ts +5 -4
  466. package/src/runtime/routes/host-file-routes.ts +5 -4
  467. package/src/runtime/routes/host-transfer-routes.ts +6 -6
  468. package/src/runtime/routes/http-adapter.ts +16 -1
  469. package/src/runtime/routes/identity-routes.ts +3 -2
  470. package/src/runtime/routes/inbound-message-handler.ts +5 -5
  471. package/src/runtime/routes/inbound-stages/acl-enforcement.test.ts +97 -5
  472. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +61 -59
  473. package/src/runtime/routes/inbound-stages/background-dispatch.ts +13 -5
  474. package/src/runtime/routes/inbound-stages/escalation-intercept.ts +7 -7
  475. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.test.ts +21 -8
  476. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.ts +14 -3
  477. package/src/runtime/routes/inbound-stages/reaction-intercept.ts +19 -0
  478. package/src/runtime/routes/index.ts +2 -0
  479. package/src/runtime/routes/llm-context-normalization.ts +83 -0
  480. package/src/runtime/routes/mcp-auth-routes.ts +171 -19
  481. package/src/runtime/routes/migration-rollback-routes.ts +4 -3
  482. package/src/runtime/routes/migration-routes.ts +4 -1
  483. package/src/runtime/routes/onboarding-checkin-routes.ts +86 -0
  484. package/src/runtime/routes/settings-routes.ts +8 -3
  485. package/src/runtime/routes/subagents-routes.ts +5 -0
  486. package/src/runtime/routes/surface-action-routes.ts +42 -56
  487. package/src/runtime/services/__tests__/conversation-serializer.test.ts +1 -0
  488. package/src/runtime/services/conversation-serializer.ts +13 -58
  489. package/src/runtime/tool-grant-request-helper.ts +3 -3
  490. package/src/runtime/trust-verdict-consumer.ts +111 -40
  491. package/src/runtime/verification-outbound-actions.ts +18 -18
  492. package/src/signals/user-message.ts +16 -0
  493. package/src/subagent/__tests__/consult-prompt.test.ts +35 -0
  494. package/src/{plugins/defaults/advisor/__tests__/transcript.test.ts → subagent/__tests__/consult-transcript.test.ts} +47 -10
  495. package/src/{plugins/defaults/advisor/steering.ts → subagent/consult-prompt.ts} +22 -32
  496. package/src/{plugins/defaults/advisor/transcript.ts → subagent/consult-transcript.ts} +18 -8
  497. package/src/subagent/index.ts +1 -1
  498. package/src/subagent/manager.ts +254 -33
  499. package/src/subagent/types.ts +11 -4
  500. package/src/telemetry/types.ts +34 -1
  501. package/src/telemetry/usage-telemetry-reporter.test.ts +3 -2
  502. package/src/telemetry/usage-telemetry-reporter.ts +87 -3
  503. package/src/tools/ask-question/ask-question-tool.test.ts +29 -0
  504. package/src/tools/ask-question/ask-question-tool.ts +13 -0
  505. package/src/tools/executor.ts +4 -4
  506. package/src/tools/filesystem/search.ts +543 -0
  507. package/src/tools/registry.ts +38 -0
  508. package/src/tools/shared/filesystem/path-policy.ts +12 -5
  509. package/src/tools/subagent/consult-deadline.ts +49 -0
  510. package/src/tools/subagent/spawn.ts +234 -5
  511. package/src/tools/tool-approval-handler.ts +1 -1
  512. package/src/tools/tool-defaults.ts +9 -2
  513. package/src/tools/tool-manifest.ts +3 -0
  514. package/src/tools/types.ts +131 -25
  515. package/src/tools/workspace-tools/loader.ts +348 -244
  516. package/src/util/errors.ts +26 -1
  517. package/src/util/logger.ts +9 -0
  518. package/src/util/platform.ts +19 -0
  519. package/src/util/telemetry-db-path.ts +24 -0
  520. package/src/workflows/library.test.ts +140 -0
  521. package/src/workflows/library.ts +82 -28
  522. package/src/workspace/migrations/017-seed-persona-dirs.ts +3 -34
  523. package/src/workspace/migrations/019-scope-journal-to-guardian.ts +3 -24
  524. package/src/workspace/migrations/031-drop-user-md.ts +232 -148
  525. package/src/workspace/migrations/048-remove-workspace-hooks.ts +14 -66
  526. package/src/workspace/migrations/111-prune-seeded-callsite-defaults.ts +134 -0
  527. package/src/workspace/migrations/112-remove-advisor-callsite-override.ts +64 -0
  528. package/src/workspace/migrations/registry.ts +4 -0
  529. package/src/__tests__/workspace-tools-watcher-flag.test.ts +0 -70
  530. package/src/daemon/workspace-tools-watcher.ts +0 -328
  531. package/src/memory/migrations/registry.ts +0 -573
  532. package/src/plugins/defaults/advisor/__tests__/advisor-gate.test.ts +0 -56
  533. package/src/plugins/defaults/advisor/__tests__/advisor-state-store.test.ts +0 -43
  534. package/src/plugins/defaults/advisor/__tests__/agent-loop-integration.test.ts +0 -137
  535. package/src/plugins/defaults/advisor/__tests__/consult.test.ts +0 -153
  536. package/src/plugins/defaults/advisor/__tests__/hooks.test.ts +0 -138
  537. package/src/plugins/defaults/advisor/advisor-gate.ts +0 -29
  538. package/src/plugins/defaults/advisor/advisor-state-store.ts +0 -94
  539. package/src/plugins/defaults/advisor/config.ts +0 -21
  540. package/src/plugins/defaults/advisor/consult.ts +0 -93
  541. package/src/plugins/defaults/advisor/hooks/post-model-call.ts +0 -34
  542. package/src/plugins/defaults/advisor/hooks/pre-model-call.ts +0 -30
  543. package/src/plugins/defaults/advisor/hooks/user-prompt-submit.ts +0 -19
  544. package/src/plugins/defaults/advisor/package.json +0 -14
  545. package/src/plugins/defaults/advisor/tools/advisor.ts +0 -65
  546. package/src/providers/openai/__tests__/api-error-detail.test.ts +0 -120
@@ -112,9 +112,9 @@ type VerificationCallResult =
112
112
  * so the caller can apply side-effects (state mutations, TTS, session
113
113
  * updates) without this function needing access to the relay connection.
114
114
  */
115
- export function attemptVerificationCode(
115
+ export async function attemptVerificationCode(
116
116
  params: VerificationCallParams,
117
- ): VerificationCallResult {
117
+ ): Promise<VerificationCallResult> {
118
118
  const {
119
119
  verificationAssistantId,
120
120
  verificationFromNumber,
@@ -142,7 +142,7 @@ export function attemptVerificationCode(
142
142
  let canonicalPrincipal: string | undefined;
143
143
 
144
144
  if (result.verificationType === "guardian") {
145
- const existingBinding = getGuardianBinding(
145
+ const existingBinding = await getGuardianBinding(
146
146
  verificationAssistantId,
147
147
  "phone",
148
148
  );
@@ -155,7 +155,7 @@ export function attemptVerificationCode(
155
155
  };
156
156
  } else {
157
157
  // Resolve canonical principal from the vellum channel binding
158
- const vellumBinding = getGuardianBinding(
158
+ const vellumBinding = await getGuardianBinding(
159
159
  verificationAssistantId,
160
160
  "vellum",
161
161
  );
@@ -1,9 +1,8 @@
1
+ import { findContactByAddress, listContacts } from "../contacts/contact-store.js";
1
2
  import {
2
- findContactByAddress,
3
- findGuardianForChannel,
4
- listContacts,
5
- listGuardianChannels,
6
- } from "../contacts/contact-store.js";
3
+ getGuardianDelivery,
4
+ voiceGuardianDisplayName,
5
+ } from "../contacts/guardian-delivery-reader.js";
7
6
  import { getAssistantName } from "../daemon/identity-helpers.js";
8
7
  import { DEFAULT_USER_REFERENCE, resolveGuardianName } from "../prompts/user-reference.js";
9
8
  import { getLogger } from "../util/logger.js";
@@ -119,7 +118,7 @@ export function buildSttHints(input: SttHintsInput): string {
119
118
  * {@link buildSttHints}. All DB lookups are best-effort — errors are
120
119
  * logged but never propagate so hints can never fail a call.
121
120
  */
122
- export function resolveCallHints(
121
+ export async function resolveCallHints(
123
122
  session: {
124
123
  task: string | null;
125
124
  toNumber: string;
@@ -129,16 +128,14 @@ export function resolveCallHints(
129
128
  inviteGuardianName: string | null;
130
129
  } | null,
131
130
  staticHints: string[],
132
- ): string {
131
+ ): Promise<string> {
133
132
  const assistantName = getAssistantName();
134
133
 
135
- // Look up the guardian contact for a displayName fallback (mirrors relay-server pattern)
134
+ // Resolve the guardian displayName from the gateway binding for STT vocabulary.
136
135
  let guardianDisplayName: string | undefined;
137
136
  try {
138
- const voiceGuardian = findGuardianForChannel("phone");
139
- const guardianChannels = voiceGuardian ? null : listGuardianChannels();
140
- const guardianContact = voiceGuardian?.contact ?? guardianChannels?.contact;
141
- guardianDisplayName = guardianContact?.displayName;
137
+ const list = await getGuardianDelivery();
138
+ guardianDisplayName = voiceGuardianDisplayName(list);
142
139
  } catch (err) {
143
140
  logger.warn({ err }, "Failed to look up guardian contact for STT hints");
144
141
  }
@@ -55,6 +55,7 @@ import {
55
55
  updateCallSession,
56
56
  } from "./call-store.js";
57
57
  import { getChannelAdmissionPolicy } from "./channel-admission-reader.js";
58
+ import { getPhoneCallerVerdict } from "./inbound-trust-reader.js";
58
59
  import { routeSetup } from "./relay-setup-router.js";
59
60
  import { resolveCallHints } from "./stt-hints.js";
60
61
  import { resolveTelephonySttRouting } from "./telephony-stt-routing.js";
@@ -298,7 +299,7 @@ async function processVoiceWebhook(
298
299
  "Inbound voice webhook — creating/reusing session",
299
300
  );
300
301
 
301
- const { session } = createInboundVoiceSession({
302
+ const { session } = await createInboundVoiceSession({
302
303
  callSid,
303
304
  fromNumber: callerFrom,
304
305
  toNumber: callerTo,
@@ -484,12 +485,21 @@ async function buildVoiceWebhookTwiml(
484
485
  // admits the caller.
485
486
  const admissionPolicy = await getChannelAdmissionPolicy("phone");
486
487
 
488
+ // Verdict-first caller trust so this preflight matches handleSetup's ACL.
489
+ // routeSetup uses it when present and not resolutionFailed, else falls back
490
+ // to local resolution. The reader returns null on failure, keeping the
491
+ // local path on a gateway blip.
492
+ const isInbound = sessionContext?.direction !== "outbound";
493
+ const otherPartyNumber = isInbound ? from : to;
494
+ const verdict = await getPhoneCallerVerdict(otherPartyNumber);
495
+
487
496
  const { outcome } = routeSetup({
488
497
  callSessionId,
489
498
  session: session ?? null,
490
499
  from,
491
500
  to,
492
501
  admissionPolicy,
502
+ verdict,
493
503
  });
494
504
 
495
505
  // The media-stream transport supports normal_call and deny (which speaks
@@ -522,7 +532,7 @@ async function buildVoiceWebhookTwiml(
522
532
  /**
523
533
  * Build ConversationRelay TwiML for Twilio-native STT providers.
524
534
  */
525
- function buildConversationRelayTwiml(
535
+ async function buildConversationRelayTwiml(
526
536
  callSessionId: string,
527
537
  profile: ReturnType<typeof resolveVoiceQualityProfile>,
528
538
  sessionContext: {
@@ -535,8 +545,8 @@ function buildConversationRelayTwiml(
535
545
  } | null,
536
546
  verificationSessionId: string | null | undefined,
537
547
  sttAttrs: { transcriptionProvider: string; speechModel: string | undefined },
538
- ): string {
539
- const rawHints = resolveCallHints(sessionContext, profile.hints);
548
+ ): Promise<string> {
549
+ const rawHints = await resolveCallHints(sessionContext, profile.hints);
540
550
 
541
551
  const speechConfig: TwilioRelaySpeechConfig = {
542
552
  transcriptionProvider: sttAttrs.transcriptionProvider,
@@ -1,26 +1,16 @@
1
- export const CHANNEL_IDS = [
2
- "telegram",
3
- "phone",
4
- "vellum",
5
- "whatsapp",
6
- "slack",
7
- "email",
8
- "platform",
9
- "a2a",
10
- ] as const;
1
+ import {
2
+ CHANNEL_IDS,
3
+ type ChannelId,
4
+ isChannelId,
5
+ } from "@vellumai/service-contracts/channels";
11
6
 
12
- export type ChannelId = (typeof CHANNEL_IDS)[number];
13
-
14
- export function isChannelId(value: unknown): value is ChannelId {
15
- return (
16
- typeof value === "string" &&
17
- (CHANNEL_IDS as readonly string[]).includes(value)
18
- );
19
- }
7
+ // The assistant understands the full canonical channel set, so it adopts the
8
+ // shared vocabulary wholesale. `parseChannelId` stays local — it is only used
9
+ // daemon-side and is a thin convenience over the shared guard.
10
+ export { CHANNEL_IDS, type ChannelId, isChannelId };
20
11
 
21
12
  export function parseChannelId(value: unknown): ChannelId | null {
22
- if (isChannelId(value)) return value;
23
- return null;
13
+ return isChannelId(value) ? value : null;
24
14
  }
25
15
 
26
16
  export interface TurnChannelContext {
@@ -88,8 +88,15 @@ mock.module("../../../util/logger.js", () => ({
88
88
  }));
89
89
 
90
90
  mock.module("../../lib/cache-fs.js", () => ({
91
- readFileSync: (path: string, encoding?: BufferEncoding) => {
91
+ readFileSync: (path: string | number, encoding?: BufferEncoding) => {
92
+ // Stdin must be read via fd 0, not by reopening "/dev/stdin": a spawned
93
+ // subprocess whose stdin is a pipe (Bun.spawn stdin:"pipe") cannot reopen
94
+ // its read-end by path — open("/dev/stdin") fails ENXIO. Throwing here on
95
+ // the path makes any regression to path-based reading fail loudly.
92
96
  if (path === "/dev/stdin") {
97
+ throw new Error("ENXIO: no such device or address, open '/dev/stdin'");
98
+ }
99
+ if (path === 0) {
93
100
  if (mockStdinContent === null) {
94
101
  throw new Error("EAGAIN: resource temporarily unavailable");
95
102
  }
@@ -142,6 +142,7 @@ mock.module("../../../util/logger.js", () => ({
142
142
  truncateForLog: (value: string) => value,
143
143
  pruneOldLogFiles: () => 0,
144
144
  LOG_FILE_PATTERN: /^assistant-(\d{4}-\d{2}-\d{2})\.log$/,
145
+ getCurrentLogFilePath: () => "/tmp/test-assistant.log",
145
146
  }));
146
147
 
147
148
  const { registerConversationsCommand } = await import("../conversations.js");
@@ -17,6 +17,9 @@ import { log } from "../logger.js";
17
17
  /** Warn (stderr) when a raw payload exceeds this byte count. */
18
18
  const MAX_PAYLOAD_BYTES = 1_000_000; // 1 MB
19
19
 
20
+ /** Standard input file descriptor. */
21
+ const STDIN_FD = 0;
22
+
20
23
  // ── TTL parsing ───────────────────────────────────────────────────────
21
24
 
22
25
  const TTL_PATTERN = /^(\d+(?:\.\d+)?)\s*(ms|s|m|h)$/;
@@ -99,6 +102,11 @@ function parseJsonPayload(raw: string, source: string): unknown {
99
102
  * Read JSON payload from stdin when piped. Throws when stdin is a TTY
100
103
  * (no piped input) or when the input is empty/invalid JSON, so the CLI
101
104
  * can surface actionable parse errors.
105
+ *
106
+ * Reads file descriptor 0 directly rather than reopening the `/dev/stdin`
107
+ * path. When the caller is a spawned subprocess whose stdin is a pipe (e.g.
108
+ * `Bun.spawn(..., { stdin: "pipe" })`), `open("/dev/stdin")` fails with ENXIO
109
+ * because a pipe read-end cannot be reopened by path; the fd is readable.
102
110
  */
103
111
  function readPayloadFromStdin(): unknown {
104
112
  if (process.stdin.isTTY) {
@@ -111,7 +119,7 @@ function readPayloadFromStdin(): unknown {
111
119
 
112
120
  let raw: string;
113
121
  try {
114
- raw = readFileSync("/dev/stdin", "utf-8");
122
+ raw = readFileSync(STDIN_FD, "utf-8");
115
123
  } catch (err) {
116
124
  throw new Error(
117
125
  `Failed to read stdin: ${err instanceof Error ? err.message : String(err)}.\n` +
@@ -173,10 +181,9 @@ export function registerCacheCommand(program: Command): void {
173
181
  transport: "ipc",
174
182
  description: "Interact with the assistant's in-memory key/value cache",
175
183
  build: (cache) => {
176
-
177
- cache.addHelpText(
178
- "after",
179
- `
184
+ cache.addHelpText(
185
+ "after",
186
+ `
180
187
  The cache is a TTL-aware, LRU-evicting in-memory store managed by the
181
188
  running assistant. Data is scoped to the assistant process lifetime and
182
189
  is not persisted across restarts.
@@ -190,33 +197,33 @@ Examples:
190
197
  $ echo '{"result": [1,2,3]}' | assistant cache set --ttl 5m
191
198
  $ assistant cache get my-key
192
199
  $ assistant cache delete my-key`,
193
- );
194
-
195
- // ── set ───────────────────────────────────────────────────────────
196
-
197
- cache
198
- .command("set")
199
- .description("Store a JSON value in the cache")
200
- .option(
201
- "--key <key>",
202
- "Cache key for idempotent upsert. Omit to auto-generate.",
203
- )
204
- .option(
205
- "--ttl <duration>",
206
- "Time-to-live (minimum 1s). Units: ms, s, m, h (e.g. 1000ms, 30s, 5m, 2h). Defaults to 30m if omitted.",
207
- )
208
- .option(
209
- "--value <json>",
210
- "JSON payload to store. Alternative to piping via stdin.",
211
- )
212
- .option(
213
- "--file <path>",
214
- "Path to a file containing the JSON payload. Alternative to piping via stdin.",
215
- )
216
- .option("--json", "Output result as machine-readable JSON.")
217
- .addHelpText(
218
- "after",
219
- `
200
+ );
201
+
202
+ // ── set ───────────────────────────────────────────────────────────
203
+
204
+ cache
205
+ .command("set")
206
+ .description("Store a JSON value in the cache")
207
+ .option(
208
+ "--key <key>",
209
+ "Cache key for idempotent upsert. Omit to auto-generate.",
210
+ )
211
+ .option(
212
+ "--ttl <duration>",
213
+ "Time-to-live (minimum 1s). Units: ms, s, m, h (e.g. 1000ms, 30s, 5m, 2h). Defaults to 30m if omitted.",
214
+ )
215
+ .option(
216
+ "--value <json>",
217
+ "JSON payload to store. Alternative to piping via stdin.",
218
+ )
219
+ .option(
220
+ "--file <path>",
221
+ "Path to a file containing the JSON payload. Alternative to piping via stdin.",
222
+ )
223
+ .option("--json", "Output result as machine-readable JSON.")
224
+ .addHelpText(
225
+ "after",
226
+ `
220
227
  Stores a JSON payload in the cache and prints the assigned key. The payload
221
228
  can be provided via --value, --file, or piped through stdin. If --key is
222
229
  provided, the entry is upserted (created or replaced). If omitted, a new
@@ -240,86 +247,86 @@ Examples:
240
247
  $ assistant cache set --file /tmp/payload.json --key scores --ttl 10m
241
248
  $ echo '{"scores":[98,85,72]}' | assistant cache set
242
249
  $ echo '"simple string"' | assistant cache set --ttl 1h --json`,
243
- )
244
- .action(
245
- async (opts: {
246
- key?: string;
247
- ttl?: string;
248
- value?: string;
249
- file?: string;
250
- json?: boolean;
251
- }) => {
252
- let data: unknown;
253
- try {
254
- data = resolvePayload(opts);
255
- } catch (err) {
256
- const msg = err instanceof Error ? err.message : String(err);
257
- if (opts.json) {
258
- process.stdout.write(
259
- JSON.stringify({ ok: false, error: msg }) + "\n",
260
- );
261
- } else {
262
- log.error(msg);
263
- }
264
- process.exitCode = 1;
265
- return;
266
- }
267
-
268
- let ttl_ms: number | undefined;
269
- try {
270
- ttl_ms = parseTtl(opts.ttl);
271
- } catch (err) {
272
- const msg = err instanceof Error ? err.message : String(err);
273
- if (opts.json) {
274
- process.stdout.write(
275
- JSON.stringify({ ok: false, error: msg }) + "\n",
276
- );
277
- } else {
278
- log.error(msg);
279
- }
280
- process.exitCode = 1;
281
- return;
282
- }
283
-
284
- const params: Record<string, unknown> = { data };
285
- if (ttl_ms !== undefined) params.ttl_ms = ttl_ms;
286
- if (opts.key) params.key = opts.key;
287
-
288
- const result = await cliIpcCall<{ key: string }>("cache_set", {
289
- body: params,
290
- });
291
-
292
- if (!result.ok) {
293
- if (opts.json) {
294
- process.stdout.write(
295
- JSON.stringify({ ok: false, error: result.error }) + "\n",
296
- );
297
- } else {
298
- log.error(`Error: ${result.error}`);
299
- }
300
- process.exitCode = 1;
301
- return;
302
- }
303
-
304
- if (opts.json) {
305
- process.stdout.write(
306
- JSON.stringify({ ok: true, key: result.result!.key }) + "\n",
307
- );
308
- } else {
309
- log.info(`Cached with key: ${result.result!.key}`);
310
- }
311
- },
312
- );
250
+ )
251
+ .action(
252
+ async (opts: {
253
+ key?: string;
254
+ ttl?: string;
255
+ value?: string;
256
+ file?: string;
257
+ json?: boolean;
258
+ }) => {
259
+ let data: unknown;
260
+ try {
261
+ data = resolvePayload(opts);
262
+ } catch (err) {
263
+ const msg = err instanceof Error ? err.message : String(err);
264
+ if (opts.json) {
265
+ process.stdout.write(
266
+ JSON.stringify({ ok: false, error: msg }) + "\n",
267
+ );
268
+ } else {
269
+ log.error(msg);
270
+ }
271
+ process.exitCode = 1;
272
+ return;
273
+ }
274
+
275
+ let ttl_ms: number | undefined;
276
+ try {
277
+ ttl_ms = parseTtl(opts.ttl);
278
+ } catch (err) {
279
+ const msg = err instanceof Error ? err.message : String(err);
280
+ if (opts.json) {
281
+ process.stdout.write(
282
+ JSON.stringify({ ok: false, error: msg }) + "\n",
283
+ );
284
+ } else {
285
+ log.error(msg);
286
+ }
287
+ process.exitCode = 1;
288
+ return;
289
+ }
290
+
291
+ const params: Record<string, unknown> = { data };
292
+ if (ttl_ms !== undefined) params.ttl_ms = ttl_ms;
293
+ if (opts.key) params.key = opts.key;
294
+
295
+ const result = await cliIpcCall<{ key: string }>("cache_set", {
296
+ body: params,
297
+ });
298
+
299
+ if (!result.ok) {
300
+ if (opts.json) {
301
+ process.stdout.write(
302
+ JSON.stringify({ ok: false, error: result.error }) + "\n",
303
+ );
304
+ } else {
305
+ log.error(`Error: ${result.error}`);
306
+ }
307
+ process.exitCode = 1;
308
+ return;
309
+ }
310
+
311
+ if (opts.json) {
312
+ process.stdout.write(
313
+ JSON.stringify({ ok: true, key: result.result!.key }) + "\n",
314
+ );
315
+ } else {
316
+ log.info(`Cached with key: ${result.result!.key}`);
317
+ }
318
+ },
319
+ );
313
320
 
314
- // ── get ───────────────────────────────────────────────────────────
321
+ // ── get ───────────────────────────────────────────────────────────
315
322
 
316
- cache
317
- .command("get <key>")
318
- .description("Retrieve a cached value by key")
319
- .option("--json", "Output result as machine-readable JSON.")
320
- .addHelpText(
321
- "after",
322
- `
323
+ cache
324
+ .command("get <key>")
325
+ .description("Retrieve a cached value by key")
326
+ .option("--json", "Output result as machine-readable JSON.")
327
+ .addHelpText(
328
+ "after",
329
+ `
323
330
  Arguments:
324
331
  key The cache key to look up. Run 'assistant cache set' to store a
325
332
  value and receive its key.
@@ -331,49 +338,52 @@ exist or has expired, reports not-found. In --json mode, a miss returns
331
338
  Examples:
332
339
  $ assistant cache get my-key
333
340
  $ assistant cache get my-key --json`,
334
- )
335
- .action(async (key: string, opts: { json?: boolean }) => {
336
- const result = await cliIpcCall<{ data: unknown } | null>("cache_get", {
337
- body: { key },
338
- });
339
-
340
- if (!result.ok) {
341
- if (opts.json) {
342
- process.stdout.write(
343
- JSON.stringify({ ok: false, error: result.error }) + "\n",
341
+ )
342
+ .action(async (key: string, opts: { json?: boolean }) => {
343
+ const result = await cliIpcCall<{ data: unknown } | null>(
344
+ "cache_get",
345
+ {
346
+ body: { key },
347
+ },
344
348
  );
345
- } else {
346
- log.error(`Error: ${result.error}`);
347
- }
348
- process.exitCode = 1;
349
- return;
350
- }
351
-
352
- if (opts.json) {
353
- process.stdout.write(
354
- JSON.stringify({
355
- ok: true,
356
- data: result.result ? result.result.data : null,
357
- }) + "\n",
358
- );
359
- } else {
360
- if (result.result == null) {
361
- log.info(`No cache entry found for key "${key}".`);
362
- } else {
363
- log.info(JSON.stringify(result.result.data, null, 2));
364
- }
365
- }
366
- });
367
-
368
- // ── delete ────────────────────────────────────────────────────────
369
-
370
- cache
371
- .command("delete <key>")
372
- .description("Remove a cached entry by key")
373
- .option("--json", "Output result as machine-readable JSON.")
374
- .addHelpText(
375
- "after",
376
- `
349
+
350
+ if (!result.ok) {
351
+ if (opts.json) {
352
+ process.stdout.write(
353
+ JSON.stringify({ ok: false, error: result.error }) + "\n",
354
+ );
355
+ } else {
356
+ log.error(`Error: ${result.error}`);
357
+ }
358
+ process.exitCode = 1;
359
+ return;
360
+ }
361
+
362
+ if (opts.json) {
363
+ process.stdout.write(
364
+ JSON.stringify({
365
+ ok: true,
366
+ data: result.result ? result.result.data : null,
367
+ }) + "\n",
368
+ );
369
+ } else {
370
+ if (result.result == null) {
371
+ log.info(`No cache entry found for key "${key}".`);
372
+ } else {
373
+ log.info(JSON.stringify(result.result.data, null, 2));
374
+ }
375
+ }
376
+ });
377
+
378
+ // ── delete ────────────────────────────────────────────────────────
379
+
380
+ cache
381
+ .command("delete <key>")
382
+ .description("Remove a cached entry by key")
383
+ .option("--json", "Output result as machine-readable JSON.")
384
+ .addHelpText(
385
+ "after",
386
+ `
377
387
  Arguments:
378
388
  key The cache key to remove. Run 'assistant cache get <key>' to
379
389
  verify a key exists before deleting.
@@ -384,36 +394,39 @@ existed or not, but reports whether an entry was actually removed.
384
394
  Examples:
385
395
  $ assistant cache delete my-key
386
396
  $ assistant cache delete my-key --json`,
387
- )
388
- .action(async (key: string, opts: { json?: boolean }) => {
389
- const result = await cliIpcCall<{ deleted: boolean }>("cache_delete", {
390
- body: { key },
391
- });
392
-
393
- if (!result.ok) {
394
- if (opts.json) {
395
- process.stdout.write(
396
- JSON.stringify({ ok: false, error: result.error }) + "\n",
397
+ )
398
+ .action(async (key: string, opts: { json?: boolean }) => {
399
+ const result = await cliIpcCall<{ deleted: boolean }>(
400
+ "cache_delete",
401
+ {
402
+ body: { key },
403
+ },
397
404
  );
398
- } else {
399
- log.error(`Error: ${result.error}`);
400
- }
401
- process.exitCode = 1;
402
- return;
403
- }
404
-
405
- const deleted = result.result!.deleted;
406
-
407
- if (opts.json) {
408
- process.stdout.write(JSON.stringify({ ok: true, deleted }) + "\n");
409
- } else {
410
- if (deleted) {
411
- log.info(`Deleted cache entry "${key}".`);
412
- } else {
413
- log.info(`No cache entry "${key}" (nothing to delete).`);
414
- }
415
- }
416
- });
405
+
406
+ if (!result.ok) {
407
+ if (opts.json) {
408
+ process.stdout.write(
409
+ JSON.stringify({ ok: false, error: result.error }) + "\n",
410
+ );
411
+ } else {
412
+ log.error(`Error: ${result.error}`);
413
+ }
414
+ process.exitCode = 1;
415
+ return;
416
+ }
417
+
418
+ const deleted = result.result!.deleted;
419
+
420
+ if (opts.json) {
421
+ process.stdout.write(JSON.stringify({ ok: true, deleted }) + "\n");
422
+ } else {
423
+ if (deleted) {
424
+ log.info(`Deleted cache entry "${key}".`);
425
+ } else {
426
+ log.info(`No cache entry "${key}" (nothing to delete).`);
427
+ }
428
+ }
429
+ });
417
430
  },
418
431
  });
419
432
  }