@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
@@ -22,6 +22,11 @@ import {
22
22
  isUnparseableToolArgs,
23
23
  wrapUnparseableToolArgs,
24
24
  } from "../unparseable-tool-args.js";
25
+ import {
26
+ captureRawErrorBodyFetch,
27
+ formatNormalizedOpenAIAPIError,
28
+ normalizeOpenAIAPIError,
29
+ } from "./api-error-normalization.js";
25
30
  import {
26
31
  coerceObjectParamsToJsonString,
27
32
  decodeCoercedObjectArgs,
@@ -43,6 +48,7 @@ import {
43
48
  */
44
49
  export function detectOpenAICompatibleContextOverflow(
45
50
  error: InstanceType<typeof OpenAI.APIError>,
51
+ extraMessage?: string,
46
52
  ): { actualTokens?: number; maxTokens?: number } | null {
47
53
  // OpenAI-compatible providers use 400 (most) or 413 (rarer payload-too-large).
48
54
  const status = error.status;
@@ -53,7 +59,9 @@ export function detectOpenAICompatibleContextOverflow(
53
59
  /context_length_exceeded|context_window_exceeded|input_too_long|prompt_too_long/i.test(
54
60
  code,
55
61
  );
56
- const message = error.message ?? "";
62
+ // Include the normalized upstream message: the SDK's `error.message` is often
63
+ // generic ("400 Provider returned error") while the real signal is in the body.
64
+ const message = `${error.message ?? ""} ${extraMessage ?? ""}`;
57
65
  const messageMatches =
58
66
  /context.?length.?exceeded|context.?window.?exceeded|prompt.?is.?too.?long|prompt_too_long|input.?too.?long|too.?many.?(?:input.?)?tokens|maximum.?context/i.test(
59
67
  message,
@@ -63,53 +71,6 @@ export function detectOpenAICompatibleContextOverflow(
63
71
  return extractOverflowTokensFromMessage(message);
64
72
  }
65
73
 
66
- /**
67
- * Build the human-readable error string surfaced from an
68
- * `OpenAI.APIError`. The SDK's `error.message` is typically a one-line
69
- * summary like `"400 Provider returned error"` — useless when the
70
- * upstream is OpenRouter (which wraps the real downstream error on
71
- * `error.error.metadata.raw`) or any provider that returns nested
72
- * structured details.
73
- *
74
- * Returns `{ detail, requestId }` where `detail` includes the JSON body
75
- * (truncated) and `requestId` is the upstream correlation header when
76
- * present. Callers fold these into the thrown `ProviderError` so log
77
- * lines actually identify the failure without re-running the request.
78
- *
79
- * Exported for tests.
80
- */
81
- export function extractApiErrorDetail(
82
- error: InstanceType<typeof OpenAI.APIError>,
83
- ): { detail: string; requestId: string | undefined } {
84
- const body = (error as { error?: unknown }).error;
85
- let detail = "";
86
- if (body !== undefined && body !== null) {
87
- try {
88
- const serialized = typeof body === "string" ? body : JSON.stringify(body);
89
- if (serialized && serialized !== "{}") {
90
- detail =
91
- serialized.length > MAX_API_ERROR_DETAIL_CHARS
92
- ? `${serialized.slice(0, MAX_API_ERROR_DETAIL_CHARS)}…`
93
- : serialized;
94
- }
95
- } catch {
96
- // Body had a cycle or threw on toJSON — fall through with empty detail.
97
- }
98
- }
99
- const requestId = readHeader(error.headers, [
100
- "x-request-id",
101
- "x-openrouter-request-id",
102
- "openai-request-id",
103
- "x-amzn-requestid",
104
- ]);
105
- return { detail, requestId };
106
- }
107
-
108
- /** Cap on the inline-rendered body to keep log lines readable while still
109
- * surfacing the meaningful upstream payload. Tuned to comfortably hold
110
- * OpenRouter's `error.metadata.raw` strings, which are typically <1KB. */
111
- const MAX_API_ERROR_DETAIL_CHARS = 2000;
112
-
113
74
  const VISION_NOT_SUPPORTED_PATTERNS = [
114
75
  /no endpoints found that support image input/i,
115
76
  /does not support image/i,
@@ -121,8 +82,9 @@ const VISION_NOT_SUPPORTED_PATTERNS = [
121
82
 
122
83
  export function detectVisionNotSupported(
123
84
  error: InstanceType<typeof OpenAI.APIError>,
85
+ extraMessage?: string,
124
86
  ): boolean {
125
- const haystack = `${error.message} ${JSON.stringify((error as { error?: unknown }).error ?? "")}`;
87
+ const haystack = `${error.message} ${extraMessage ?? ""} ${JSON.stringify((error as { error?: unknown }).error ?? "")}`;
126
88
  return VISION_NOT_SUPPORTED_PATTERNS.some((re) => re.test(haystack));
127
89
  }
128
90
 
@@ -146,34 +108,6 @@ export function detectVisionNotSupported(
146
108
  */
147
109
  export const EMPTY_ASSISTANT_TURN_PLACEHOLDER = PLACEHOLDER_EMPTY_TURN.slice(1);
148
110
 
149
- /**
150
- * Read the first matching header from an SDK error's headers object,
151
- * tolerating both Map-like (`Headers.get()`) and plain-object shapes.
152
- * Mirrors the shape-tolerance already in `extractRetryAfterMs`.
153
- */
154
- function readHeader(
155
- headers: unknown,
156
- names: readonly string[],
157
- ): string | undefined {
158
- if (!headers) return undefined;
159
- const getter =
160
- typeof (headers as { get?: unknown }).get === "function"
161
- ? (headers as { get(name: string): string | null }).get.bind(headers)
162
- : undefined;
163
- for (const name of names) {
164
- let value: string | null | undefined;
165
- if (getter) {
166
- value = getter(name);
167
- } else if (typeof headers === "object") {
168
- const record = headers as Record<string, unknown>;
169
- const raw = record[name] ?? record[name.toLowerCase()];
170
- value = typeof raw === "string" ? raw : undefined;
171
- }
172
- if (typeof value === "string" && value.length > 0) return value;
173
- }
174
- return undefined;
175
- }
176
-
177
111
  export interface OpenAIChatCompletionsProviderOptions {
178
112
  baseURL?: string;
179
113
  providerName?: string;
@@ -342,6 +276,8 @@ export class OpenAIChatCompletionsProvider implements Provider {
342
276
  apiKey,
343
277
  baseURL: options.baseURL,
344
278
  timeout: sdkTimeoutMs,
279
+ // Capture the raw non-2xx body before the SDK parses (and drops) it.
280
+ fetch: captureRawErrorBodyFetch,
345
281
  });
346
282
  this.model = model;
347
283
  this.extraCreateParams = options.extraCreateParams ?? {};
@@ -763,11 +699,16 @@ export class OpenAIChatCompletionsProvider implements Provider {
763
699
  ? signal.reason
764
700
  : undefined;
765
701
  if (error instanceof OpenAI.APIError) {
766
- const { detail, requestId } = extractApiErrorDetail(error);
767
- const detailSuffix = detail ? ` ${detail}` : "";
768
- const requestIdSuffix = requestId ? ` [request_id=${requestId}]` : "";
769
- const formattedMessage = `${this.providerLabel} API error (${error.status}): ${error.message}${detailSuffix}${requestIdSuffix}`;
770
- const overflow = detectOpenAICompatibleContextOverflow(error);
702
+ const normalized = normalizeOpenAIAPIError(error);
703
+ const formattedMessage = formatNormalizedOpenAIAPIError(
704
+ this.providerLabel,
705
+ error.status,
706
+ normalized,
707
+ );
708
+ const overflow = detectOpenAICompatibleContextOverflow(
709
+ error,
710
+ normalized.message,
711
+ );
771
712
  if (overflow) {
772
713
  throw new ContextOverflowError(formattedMessage, this.name, {
773
714
  actualTokens: overflow.actualTokens,
@@ -776,7 +717,7 @@ export class OpenAIChatCompletionsProvider implements Provider {
776
717
  cause: error,
777
718
  });
778
719
  }
779
- if (detectVisionNotSupported(error)) {
720
+ if (detectVisionNotSupported(error, normalized.message)) {
780
721
  const model = modelOverride ?? this.model;
781
722
  throw new ProviderError(
782
723
  `This model (${model}) doesn't support image input. Remove the image or switch to a vision-capable model.`,
@@ -789,10 +730,23 @@ export class OpenAIChatCompletionsProvider implements Provider {
789
730
  const errorOptions: {
790
731
  retryAfterMs?: number;
791
732
  abortReason?: unknown;
733
+ apiErrorCode?: string;
734
+ apiErrorType?: string;
735
+ apiErrorParam?: string;
736
+ requestId?: string;
737
+ rawBody?: string;
792
738
  } = {};
793
739
  if (retryAfterMs !== undefined)
794
740
  errorOptions.retryAfterMs = retryAfterMs;
795
741
  if (abortReason) errorOptions.abortReason = abortReason;
742
+ if (normalized.apiErrorCode)
743
+ errorOptions.apiErrorCode = normalized.apiErrorCode;
744
+ if (normalized.apiErrorType)
745
+ errorOptions.apiErrorType = normalized.apiErrorType;
746
+ if (normalized.apiErrorParam)
747
+ errorOptions.apiErrorParam = normalized.apiErrorParam;
748
+ if (normalized.requestId) errorOptions.requestId = normalized.requestId;
749
+ if (normalized.rawBody) errorOptions.rawBody = normalized.rawBody;
796
750
  throw new ProviderError(
797
751
  formattedMessage,
798
752
  this.name,
@@ -16,6 +16,11 @@ import type {
16
16
  } from "../types.js";
17
17
  import { ContextOverflowError } from "../types.js";
18
18
  import { wrapUnparseableToolArgs } from "../unparseable-tool-args.js";
19
+ import {
20
+ captureRawErrorBodyFetch,
21
+ formatNormalizedOpenAIAPIError,
22
+ normalizeOpenAIAPIError,
23
+ } from "./api-error-normalization.js";
19
24
  import { detectOpenAICompatibleContextOverflow } from "./chat-completions-provider.js";
20
25
 
21
26
  const log = getLogger("openai-responses");
@@ -148,7 +153,6 @@ export class OpenAIResponsesProvider implements Provider {
148
153
  private streamTimeoutMs: number;
149
154
  private useNativeWebSearch: boolean;
150
155
  private codexSubscription: boolean;
151
- private lastCodexErrorBody: string | undefined;
152
156
 
153
157
  constructor(
154
158
  apiKey: string,
@@ -168,32 +172,18 @@ export class OpenAIResponsesProvider implements Provider {
168
172
  ? "https://chatgpt.com/backend-api/codex"
169
173
  : options.baseURL,
170
174
  timeout: sdkTimeoutMs,
171
- ...(this.codexSubscription
172
- ? {
173
- fetch: async (url: RequestInfo | URL, init?: RequestInit) => {
174
- const res = await globalThis.fetch(url, init);
175
- if (!res.ok) {
176
- const body = await res.text();
177
- this.lastCodexErrorBody = body;
178
- log.warn(
179
- { status: res.status, body, url: String(url) },
180
- "Codex endpoint raw error response",
181
- );
182
- return new Response(body, {
183
- status: res.status,
184
- statusText: res.statusText,
185
- headers: res.headers,
186
- });
187
- }
188
- return res;
189
- },
190
- }
191
- : {}),
175
+ // Capture the raw non-2xx body before the SDK parses (and drops) it.
176
+ fetch: captureRawErrorBodyFetch,
192
177
  });
193
178
  this.model = model;
194
179
  this.useNativeWebSearch = options.useNativeWebSearch ?? false;
195
180
  }
196
181
 
182
+ /** See {@link Provider.supportsNativeWebSearch}. */
183
+ get supportsNativeWebSearch(): boolean {
184
+ return this.useNativeWebSearch;
185
+ }
186
+
197
187
  async sendMessage(
198
188
  messages: Message[],
199
189
  options?: SendMessageOptions,
@@ -510,43 +500,57 @@ export class OpenAIResponsesProvider implements Provider {
510
500
  ? signal.reason
511
501
  : undefined;
512
502
  if (error instanceof OpenAI.APIError) {
513
- const overflow = detectOpenAICompatibleContextOverflow(error);
514
- if (overflow) {
515
- throw new ContextOverflowError(
516
- `${this.providerLabel} API error (${error.status}): ${error.message}`,
517
- this.name,
503
+ const normalized = normalizeOpenAIAPIError(error);
504
+ if (this.codexSubscription) {
505
+ log.warn(
518
506
  {
519
- actualTokens: overflow.actualTokens,
520
- maxTokens: overflow.maxTokens,
521
- statusCode: error.status,
522
- cause: error,
507
+ status: error.status,
508
+ message: normalized.message,
509
+ requestId: normalized.requestId,
523
510
  },
511
+ "Codex endpoint raw error response",
524
512
  );
525
513
  }
514
+ const formattedMessage = formatNormalizedOpenAIAPIError(
515
+ this.providerLabel,
516
+ error.status,
517
+ normalized,
518
+ );
519
+ const overflow = detectOpenAICompatibleContextOverflow(
520
+ error,
521
+ normalized.message,
522
+ );
523
+ if (overflow) {
524
+ throw new ContextOverflowError(formattedMessage, this.name, {
525
+ actualTokens: overflow.actualTokens,
526
+ maxTokens: overflow.maxTokens,
527
+ statusCode: error.status,
528
+ cause: error,
529
+ });
530
+ }
526
531
  const retryAfterMs = extractRetryAfterMs(error.headers);
527
532
  const errorOptions: {
528
533
  retryAfterMs?: number;
529
534
  abortReason?: unknown;
535
+ apiErrorCode?: string;
536
+ apiErrorType?: string;
537
+ apiErrorParam?: string;
538
+ requestId?: string;
539
+ rawBody?: string;
530
540
  } = {};
531
541
  if (retryAfterMs !== undefined)
532
542
  errorOptions.retryAfterMs = retryAfterMs;
533
543
  if (abortReason) errorOptions.abortReason = abortReason;
534
- let errorDetail = error.message;
535
- if (this.lastCodexErrorBody) {
536
- try {
537
- const parsed = JSON.parse(this.lastCodexErrorBody);
538
- if (parsed.detail) errorDetail = parsed.detail;
539
- } catch {
540
- errorDetail = this.lastCodexErrorBody.slice(0, 200);
541
- }
542
- this.lastCodexErrorBody = undefined;
543
- }
544
- const extras = [error.code, error.type, error.param]
545
- .filter(Boolean)
546
- .join(", ");
547
- const extraSuffix = extras ? ` [${extras}]` : "";
544
+ if (normalized.apiErrorCode)
545
+ errorOptions.apiErrorCode = normalized.apiErrorCode;
546
+ if (normalized.apiErrorType)
547
+ errorOptions.apiErrorType = normalized.apiErrorType;
548
+ if (normalized.apiErrorParam)
549
+ errorOptions.apiErrorParam = normalized.apiErrorParam;
550
+ if (normalized.requestId) errorOptions.requestId = normalized.requestId;
551
+ if (normalized.rawBody) errorOptions.rawBody = normalized.rawBody;
548
552
  throw new ProviderError(
549
- `${this.providerLabel} API error (${error.status}): ${errorDetail}${extraSuffix}`,
553
+ formattedMessage,
550
554
  this.name,
551
555
  error.status,
552
556
  Object.keys(errorOptions).length > 0 ? errorOptions : undefined,
@@ -140,6 +140,11 @@ export class OpenRouterProvider extends OpenAIChatCompletionsProvider {
140
140
  return isAnthropicModel(this.defaultModel) ? "anthropic" : this.name;
141
141
  }
142
142
 
143
+ /** See {@link Provider.supportsNativeWebSearch}. Set per model at construction. */
144
+ get supportsNativeWebSearch(): boolean {
145
+ return this.useNativeWebSearch;
146
+ }
147
+
143
148
  override async sendMessage(
144
149
  messages: Message[],
145
150
  options?: SendMessageOptions,
@@ -43,6 +43,9 @@ let lazyInitPromise: Promise<void> | null = null;
43
43
  export class CallSiteConfiguredProvider implements Provider {
44
44
  public readonly name: string;
45
45
  public readonly tokenEstimationProvider?: string;
46
+ // Forward native web-search capability so it survives the wrapper chain
47
+ // (callers like the advisor consult gate on it). Fixed at construction.
48
+ public readonly supportsNativeWebSearch?: boolean;
46
49
 
47
50
  constructor(
48
51
  private readonly inner: Provider,
@@ -52,6 +55,13 @@ export class CallSiteConfiguredProvider implements Provider {
52
55
  ) {
53
56
  this.name = inner.name;
54
57
  this.tokenEstimationProvider = inner.tokenEstimationProvider;
58
+ this.supportsNativeWebSearch = inner.supportsNativeWebSearch;
59
+ }
60
+
61
+ supportsNativeWebSearchFor(options?: SendMessageOptions): boolean {
62
+ return this.inner.supportsNativeWebSearchFor
63
+ ? this.inner.supportsNativeWebSearchFor(options)
64
+ : this.inner.supportsNativeWebSearch === true;
55
65
  }
56
66
 
57
67
  sendMessage(
@@ -23,6 +23,16 @@ export class RateLimitProvider implements Provider {
23
23
  return this.inner.tokenEstimationProvider;
24
24
  }
25
25
 
26
+ get supportsNativeWebSearch(): boolean | undefined {
27
+ return this.inner.supportsNativeWebSearch;
28
+ }
29
+
30
+ supportsNativeWebSearchFor(options?: SendMessageOptions): boolean {
31
+ return this.inner.supportsNativeWebSearchFor
32
+ ? this.inner.supportsNativeWebSearchFor(options)
33
+ : this.inner.supportsNativeWebSearch === true;
34
+ }
35
+
26
36
  private requestTimestamps: number[];
27
37
 
28
38
  // Forward the optional token-counting endpoint so the capability survives
@@ -118,7 +118,7 @@ export function isNativeWebSearchCapableProvider(
118
118
  return false;
119
119
  }
120
120
 
121
- function shouldUseNativeWebSearch(
121
+ export function shouldUseNativeWebSearch(
122
122
  config: ProvidersConfig,
123
123
  providerName: string,
124
124
  model: string,
@@ -618,6 +618,16 @@ export class RetryProvider implements Provider {
618
618
  return this.inner.tokenEstimationProvider;
619
619
  }
620
620
 
621
+ get supportsNativeWebSearch(): boolean | undefined {
622
+ return this.inner.supportsNativeWebSearch;
623
+ }
624
+
625
+ supportsNativeWebSearchFor(options?: SendMessageOptions): boolean {
626
+ return this.inner.supportsNativeWebSearchFor
627
+ ? this.inner.supportsNativeWebSearchFor(options)
628
+ : this.inner.supportsNativeWebSearch === true;
629
+ }
630
+
621
631
  // Forward the optional token-counting endpoint so the capability survives
622
632
  // the wrapper chain (callers gate on its presence). Bound straight to the
623
633
  // inner provider — count_tokens is a cheap separate endpoint and its caller
@@ -265,6 +265,28 @@ export interface Provider {
265
265
  * Falls back to `name` when unset.
266
266
  */
267
267
  tokenEstimationProvider?: string;
268
+ /**
269
+ * True when this provider instance was constructed to run web search
270
+ * server-side (provider-native). The native search only activates when a
271
+ * `web_search`-named tool is passed in the request, so callers that want to
272
+ * enable web search on a one-shot completion (e.g. the advisor consult) check
273
+ * this first — passing the tool to a non-native instance would surface an
274
+ * unexecutable client tool call. Absent/false on providers without it.
275
+ */
276
+ supportsNativeWebSearch?: boolean;
277
+ /**
278
+ * Per-call native web-search capability for the provider/model this specific
279
+ * request will route to. Unlike the static {@link supportsNativeWebSearch}
280
+ * flag — fixed to the DEFAULT provider/model at construction — this consults
281
+ * the resolved call-site (`options.config.callSite` + `overrideProfile`) so a
282
+ * routing wrapper reports the ROUTED target's capability. Callers that gate a
283
+ * `web_search` server tool on a possibly-routed call (e.g. the advisor
284
+ * consult, whose `advisorProfile` may point at a different provider/model)
285
+ * must use this rather than the construction-time snapshot. Optional: wrappers
286
+ * forward it to their inner provider; leaf providers may omit it, in which
287
+ * case callers fall back to {@link supportsNativeWebSearch}.
288
+ */
289
+ supportsNativeWebSearchFor?(options?: SendMessageOptions): boolean;
268
290
  sendMessage(
269
291
  messages: Message[],
270
292
  options?: SendMessageOptions,
@@ -18,6 +18,9 @@ const log = getLogger("provider-usage-tracking");
18
18
  export class UsageTrackingProvider implements Provider {
19
19
  public readonly name: string;
20
20
  public readonly tokenEstimationProvider?: string;
21
+ // Forward native web-search capability so it survives the wrapper chain
22
+ // (callers like the advisor consult gate on it). Fixed at construction.
23
+ public readonly supportsNativeWebSearch?: boolean;
21
24
  // Forward the optional token-counting endpoint so the capability survives
22
25
  // the wrapper chain. Bound straight to the inner provider — count_tokens is
23
26
  // not billed, so there's no usage to track.
@@ -26,11 +29,18 @@ export class UsageTrackingProvider implements Provider {
26
29
  constructor(private readonly inner: Provider) {
27
30
  this.name = inner.name;
28
31
  this.tokenEstimationProvider = inner.tokenEstimationProvider;
32
+ this.supportsNativeWebSearch = inner.supportsNativeWebSearch;
29
33
  if (inner.countInputTokens) {
30
34
  this.countInputTokens = inner.countInputTokens.bind(inner);
31
35
  }
32
36
  }
33
37
 
38
+ supportsNativeWebSearchFor(options?: SendMessageOptions): boolean {
39
+ return this.inner.supportsNativeWebSearchFor
40
+ ? this.inner.supportsNativeWebSearchFor(options)
41
+ : this.inner.supportsNativeWebSearch === true;
42
+ }
43
+
34
44
  async sendMessage(
35
45
  messages: Message[],
36
46
  options?: SendMessageOptions,
@@ -0,0 +1,133 @@
1
+ import { beforeEach, describe, expect, mock, test } from "bun:test";
2
+
3
+ // Gateway guardian-delivery list drives both getGuardianBinding and isGuardian:
4
+ // null = couldn't determine, [] = authoritative unbound, one active entry =
5
+ // bound. Tests set this to mirror the gateway-owned ACL state.
6
+ let mockGuardianList: Array<Record<string, unknown>> | null = [];
7
+ const cachedCalls: Array<{ channelTypes?: string[] } | undefined> = [];
8
+
9
+ const resolveList = (input?: { channelTypes?: string[] }) => {
10
+ cachedCalls.push(input);
11
+ return Promise.resolve(mockGuardianList);
12
+ };
13
+
14
+ mock.module("../../contacts/guardian-delivery-reader.js", () => ({
15
+ getGuardianDelivery: resolveList,
16
+ getGuardianDeliveryFresh: resolveList,
17
+ guardianForChannel: (
18
+ list: Array<{ channelType: string; status: string }>,
19
+ channelType: string,
20
+ ) => list.find((g) => g.channelType === channelType && g.status === "active"),
21
+ }));
22
+
23
+ const { getGuardianBinding, isGuardian } = await import(
24
+ "../channel-verification-service.js"
25
+ );
26
+
27
+ const TELEGRAM_DELIVERY = {
28
+ channelType: "telegram",
29
+ contactId: "contact-1",
30
+ principalId: "principal-1",
31
+ displayName: "Guardian",
32
+ address: "guardian-handle",
33
+ externalChatId: "chat-1",
34
+ status: "active",
35
+ verifiedAt: 1700,
36
+ };
37
+
38
+ describe("getGuardianBinding", () => {
39
+ beforeEach(() => {
40
+ mockGuardianList = [];
41
+ cachedCalls.length = 0;
42
+ });
43
+
44
+ test("filters delivery by the requested channel type", async () => {
45
+ await getGuardianBinding("asst-1", "telegram");
46
+ expect(cachedCalls).toEqual([{ channelTypes: ["telegram"] }]);
47
+ });
48
+
49
+ test("returns null when no guardian is bound", async () => {
50
+ mockGuardianList = [];
51
+ expect(await getGuardianBinding("asst-1", "telegram")).toBeNull();
52
+ });
53
+
54
+ test("returns null when the gateway is unreachable", async () => {
55
+ mockGuardianList = null;
56
+ expect(await getGuardianBinding("asst-1", "telegram")).toBeNull();
57
+ });
58
+
59
+ test("synthesizes the binding from the gateway delivery", async () => {
60
+ mockGuardianList = [TELEGRAM_DELIVERY];
61
+
62
+ const binding = await getGuardianBinding("asst-1", "telegram");
63
+
64
+ expect(binding).not.toBeNull();
65
+ expect(binding?.assistantId).toBe("asst-1");
66
+ expect(binding?.channel).toBe("telegram");
67
+ expect(binding?.id).toBe("contact-1");
68
+ expect(binding?.guardianPrincipalId).toBe("principal-1");
69
+ expect(binding?.guardianExternalUserId).toBe("guardian-handle");
70
+ expect(binding?.guardianDeliveryChatId).toBe("chat-1");
71
+ expect(binding?.verifiedAt).toBe(1700);
72
+ expect(binding?.status).toBe("active");
73
+ expect(binding?.verifiedVia).toBe("verified");
74
+ });
75
+
76
+ test("falls back to empty strings for absent optional delivery fields", async () => {
77
+ mockGuardianList = [
78
+ {
79
+ channelType: "telegram",
80
+ contactId: "contact-2",
81
+ address: "addr",
82
+ status: "active",
83
+ },
84
+ ];
85
+
86
+ const binding = await getGuardianBinding("asst-1", "telegram");
87
+
88
+ expect(binding?.guardianPrincipalId).toBe("");
89
+ expect(binding?.guardianDeliveryChatId).toBe("");
90
+ expect(binding?.verifiedAt).toBe(0);
91
+ });
92
+
93
+ test("ignores deliveries for a different channel", async () => {
94
+ mockGuardianList = [TELEGRAM_DELIVERY];
95
+ expect(await getGuardianBinding("asst-1", "phone")).toBeNull();
96
+ });
97
+ });
98
+
99
+ describe("isGuardian", () => {
100
+ beforeEach(() => {
101
+ mockGuardianList = [];
102
+ cachedCalls.length = 0;
103
+ });
104
+
105
+ test("returns true when the address matches the gateway guardian", async () => {
106
+ mockGuardianList = [TELEGRAM_DELIVERY];
107
+ expect(await isGuardian("asst-1", "telegram", "guardian-handle")).toBe(true);
108
+ });
109
+
110
+ test("compares case-insensitively", async () => {
111
+ mockGuardianList = [TELEGRAM_DELIVERY];
112
+ expect(await isGuardian("asst-1", "telegram", "GUARDIAN-HANDLE")).toBe(true);
113
+ });
114
+
115
+ test("returns false for a non-matching address", async () => {
116
+ mockGuardianList = [TELEGRAM_DELIVERY];
117
+ expect(await isGuardian("asst-1", "telegram", "someone-else")).toBe(false);
118
+ });
119
+
120
+ test("returns false when no guardian is bound", async () => {
121
+ mockGuardianList = [];
122
+ expect(await isGuardian("asst-1", "telegram", "guardian-handle")).toBe(
123
+ false,
124
+ );
125
+ });
126
+
127
+ test("returns false when the gateway is unreachable", async () => {
128
+ mockGuardianList = null;
129
+ expect(await isGuardian("asst-1", "telegram", "guardian-handle")).toBe(
130
+ false,
131
+ );
132
+ });
133
+ });