@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
@@ -0,0 +1,633 @@
1
+ /**
2
+ * `assistant plugins publish` — validate a local plugin, resolve its git
3
+ * context, and submit it to the Vellum marketplace catalog via the platform
4
+ * API.
5
+ *
6
+ * The flow mirrors `npm publish`: validate the package locally, resolve the
7
+ * version (commit SHA), and POST to a registry endpoint. The platform then
8
+ * creates a pull request against `vellum-ai/vellum-assistant` using the
9
+ * Vellum Automation GitHub App.
10
+ *
11
+ * Designed for direct programmatic use with an injected `fetch`, mirroring
12
+ * {@link ./install-from-github} and {@link ./search-plugins}.
13
+ */
14
+
15
+ import { execFile } from "node:child_process";
16
+ import { existsSync, readdirSync, readFileSync } from "node:fs";
17
+ import { dirname, join, resolve } from "node:path";
18
+ import { promisify } from "node:util";
19
+
20
+ const execFileAsync = promisify(execFile);
21
+
22
+ // ---------------------------------------------------------------------------
23
+ // Types
24
+ // ---------------------------------------------------------------------------
25
+
26
+ export interface PublishValidation {
27
+ valid: boolean;
28
+ issues: string[];
29
+ warnings: string[];
30
+ packageJson: ParsedPackageJson;
31
+ pluginDir: string;
32
+ }
33
+
34
+ export interface ParsedPackageJson {
35
+ name?: string;
36
+ version?: string;
37
+ description?: string;
38
+ license?: string;
39
+ homepage?: string;
40
+ repository?: string | { url?: string };
41
+ peerDependencies?: Record<string, string>;
42
+ }
43
+
44
+ export interface GitContext {
45
+ sha: string;
46
+ repo: string;
47
+ dirty: boolean;
48
+ pushed: boolean;
49
+ /** Repo-relative path to the plugin directory, or "" if at repo root. */
50
+ pluginPath: string;
51
+ }
52
+
53
+ export interface PublishPayload {
54
+ name: string;
55
+ source: {
56
+ source: "github";
57
+ repo: string;
58
+ ref: string;
59
+ path?: string;
60
+ };
61
+ description?: string;
62
+ category?: string;
63
+ homepage?: string;
64
+ license?: string;
65
+ }
66
+
67
+ export interface PublishResult {
68
+ ok: boolean;
69
+ pr_url?: string;
70
+ pr_number?: number;
71
+ status?: string;
72
+ error?: string;
73
+ message?: string;
74
+ }
75
+
76
+ export interface PublishDeps {
77
+ fetch: typeof globalThis.fetch;
78
+ platformBaseUrl: string;
79
+ apiKey: string;
80
+ }
81
+
82
+ // ---------------------------------------------------------------------------
83
+ // Plugin discovery + validation
84
+ // ---------------------------------------------------------------------------
85
+
86
+ /**
87
+ * Walk up from `startDir` to find the nearest directory containing a
88
+ * `package.json`. Returns the directory path, or `null` if none is found
89
+ * before reaching the filesystem root.
90
+ */
91
+ export function findPluginRoot(startDir: string): string | null {
92
+ let dir = resolve(startDir);
93
+ while (true) {
94
+ if (existsSync(join(dir, "package.json"))) {
95
+ return dir;
96
+ }
97
+ const parent = dirname(dir);
98
+ if (parent === dir) return null;
99
+ dir = parent;
100
+ }
101
+ }
102
+
103
+ /**
104
+ * Validate a plugin directory for publish readiness.
105
+ *
106
+ * Checks the same things the review team will verify:
107
+ * - package.json exists with name, version, and @vellumai/plugin-api peer dep
108
+ * - At least one surface directory (hooks/, tools/, skills/) has entries
109
+ * - No stale .js artifacts without matching .ts source
110
+ */
111
+ export function validatePluginForPublish(dir: string): PublishValidation {
112
+ const issues: string[] = [];
113
+ const warnings: string[] = [];
114
+
115
+ const pkgPath = join(dir, "package.json");
116
+ if (!existsSync(pkgPath)) {
117
+ return {
118
+ valid: false,
119
+ issues: ["package.json not found"],
120
+ warnings: [],
121
+ packageJson: {},
122
+ pluginDir: dir,
123
+ };
124
+ }
125
+
126
+ let pkg: ParsedPackageJson;
127
+ try {
128
+ pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
129
+ } catch {
130
+ return {
131
+ valid: false,
132
+ issues: ["package.json is not valid JSON"],
133
+ warnings: [],
134
+ packageJson: {},
135
+ pluginDir: dir,
136
+ };
137
+ }
138
+
139
+ if (!pkg.name) {
140
+ issues.push("package.json missing 'name' field");
141
+ } else if (!/^[a-z0-9][a-z0-9_-]*$/.test(pkg.name)) {
142
+ issues.push(
143
+ `name "${pkg.name}" is not kebab-case (expected /^[a-z0-9][a-z0-9_-]*$/)`,
144
+ );
145
+ }
146
+
147
+ if (!pkg.version) {
148
+ issues.push("package.json missing 'version' field");
149
+ }
150
+
151
+ const peerDeps = pkg.peerDependencies ?? {};
152
+ if (!("@vellumai/plugin-api" in peerDeps)) {
153
+ issues.push(
154
+ "package.json missing peerDependencies['@vellumai/plugin-api']",
155
+ );
156
+ }
157
+
158
+ // Check for at least one surface directory with entries
159
+ const surfaceDirs = ["hooks", "tools", "skills"];
160
+ const hasAnySurface = surfaceDirs.some((d) => {
161
+ const dirPath = join(dir, d);
162
+ return existsSync(dirPath) && readdirSync(dirPath).length > 0;
163
+ });
164
+ if (!hasAnySurface) {
165
+ warnings.push(
166
+ "No hooks/, tools/, or skills/ directories with entries found. The plugin may not contribute any surfaces.",
167
+ );
168
+ }
169
+
170
+ // Check for stale .js without matching .ts
171
+ for (const d of surfaceDirs) {
172
+ const dirPath = join(dir, d);
173
+ if (!existsSync(dirPath)) continue;
174
+ for (const file of readdirSync(dirPath)) {
175
+ if (file.endsWith(".js") && !file.endsWith(".d.ts")) {
176
+ const tsFile = file.replace(/\.js$/, ".ts");
177
+ if (!existsSync(join(dirPath, tsFile))) {
178
+ warnings.push(`Stale .js found without matching .ts: ${d}/${file}`);
179
+ }
180
+ }
181
+ }
182
+ }
183
+
184
+ return {
185
+ valid: issues.length === 0,
186
+ issues,
187
+ warnings,
188
+ packageJson: pkg,
189
+ pluginDir: dir,
190
+ };
191
+ }
192
+
193
+ // ---------------------------------------------------------------------------
194
+ // Git context resolution
195
+ // ---------------------------------------------------------------------------
196
+
197
+ async function runGit(dir: string, args: string[]): Promise<string> {
198
+ const { stdout } = await execFileAsync("git", args, { cwd: dir });
199
+ return stdout.trim();
200
+ }
201
+
202
+ /**
203
+ * Resolve git context for a plugin directory: the current commit SHA,
204
+ * the GitHub remote (owner/repo), whether the working tree is dirty,
205
+ * and whether the commit has been pushed to the remote.
206
+ */
207
+ export async function resolveGitContext(dir: string): Promise<GitContext> {
208
+ const sha = await runGit(dir, ["rev-parse", "HEAD"]);
209
+
210
+ let dirty = false;
211
+ try {
212
+ const status = await runGit(dir, ["status", "--porcelain"]);
213
+ dirty = status.length > 0;
214
+ } catch {
215
+ // If git status fails, assume clean (not critical)
216
+ }
217
+
218
+ // Find the GitHub remote
219
+ const remoteOutput = await runGit(dir, ["remote", "-v"]);
220
+ const remoteMatch = remoteOutput.match(
221
+ /github\.com[:/]([^/\s]+\/[^/\s]+?)(?:\.git)?\s/m,
222
+ );
223
+ if (!remoteMatch) {
224
+ throw new Error(
225
+ "No GitHub remote found. The plugin must be pushed to a public GitHub repository.",
226
+ );
227
+ }
228
+ const repo = remoteMatch[1];
229
+
230
+ // Compute the repo-relative path to the plugin directory.
231
+ const repoRoot = await runGit(dir, ["rev-parse", "--show-toplevel"]);
232
+ const pluginPath = resolve(dir)
233
+ .slice(resolve(repoRoot).length + 1)
234
+ .replace(/\\/g, "/");
235
+
236
+ // Check if the commit is pushed
237
+ let pushed = true;
238
+ try {
239
+ const result = await runGit(dir, ["ls-remote", "origin", sha]);
240
+ pushed = result.length > 0;
241
+ } catch {
242
+ // If ls-remote fails (e.g. no network), assume pushed to avoid blocking
243
+ pushed = true;
244
+ }
245
+
246
+ return { sha, repo, dirty, pushed, pluginPath };
247
+ }
248
+
249
+ // ---------------------------------------------------------------------------
250
+ // Payload assembly
251
+ // ---------------------------------------------------------------------------
252
+
253
+ /**
254
+ * Assemble the publish payload from validated plugin data and git context.
255
+ * Auto-populates fields from package.json and fills in the git-resolved
256
+ * source coordinates.
257
+ */
258
+ export function buildPublishPayload(
259
+ validation: PublishValidation,
260
+ git: GitContext,
261
+ category: string,
262
+ ): PublishPayload {
263
+ const pkg = validation.packageJson;
264
+ const homepage = pkg.homepage ?? extractRepoUrl(pkg);
265
+
266
+ const payload: PublishPayload = {
267
+ name: pkg.name!,
268
+ source: {
269
+ source: "github",
270
+ repo: git.repo,
271
+ ref: git.sha,
272
+ ...(git.pluginPath ? { path: git.pluginPath } : {}),
273
+ },
274
+ category,
275
+ };
276
+
277
+ if (pkg.description) payload.description = pkg.description;
278
+ if (pkg.license) payload.license = pkg.license;
279
+ if (homepage) payload.homepage = homepage;
280
+
281
+ return payload;
282
+ }
283
+
284
+ function extractRepoUrl(pkg: ParsedPackageJson): string | undefined {
285
+ if (!pkg.repository) return undefined;
286
+ if (typeof pkg.repository === "string") {
287
+ // shorthand: "github:owner/repo" or URL
288
+ const match = pkg.repository.match(
289
+ /github\.com[:/]([^/\s]+\/[^/\s]+?)(?:\.git)?$/,
290
+ );
291
+ return match ? `https://github.com/${match[1]}` : undefined;
292
+ }
293
+ if (pkg.repository.url) {
294
+ const match = pkg.repository.url.match(
295
+ /github\.com[:/]([^/\s]+\/[^/\s]+?)(?:\.git)?$/,
296
+ );
297
+ return match ? `https://github.com/${match[1]}` : pkg.repository.url;
298
+ }
299
+ return undefined;
300
+ }
301
+
302
+ // ---------------------------------------------------------------------------
303
+ // Platform API submission
304
+ // ---------------------------------------------------------------------------
305
+
306
+ /**
307
+ * POST the publish payload to the Vellum platform API.
308
+ */
309
+ export async function postPublishRequest(
310
+ payload: PublishPayload,
311
+ deps: PublishDeps,
312
+ ): Promise<PublishResult> {
313
+ const resp = await deps.fetch(
314
+ `${deps.platformBaseUrl.replace(/\/+$/, "")}/v1/plugins/publish/`,
315
+ {
316
+ method: "POST",
317
+ headers: {
318
+ "Content-Type": "application/json",
319
+ Authorization: `Api-Key ${deps.apiKey}`,
320
+ },
321
+ body: JSON.stringify(payload),
322
+ },
323
+ );
324
+
325
+ const data = (await resp.json()) as PublishResult;
326
+ return data;
327
+ }
328
+
329
+ /**
330
+ * Resolve platform credentials for the publish request.
331
+ *
332
+ * Returns `null` when not connected to the Vellum platform (no API key
333
+ * or base URL configured). The CLI command uses this to avoid importing
334
+ * `VellumPlatformClient` directly, which would violate the
335
+ * `cli/no-daemon-internals` lint rule for `local`-transport commands.
336
+ */
337
+ export async function resolvePlatformDeps(): Promise<PublishDeps | null> {
338
+ const { VellumPlatformClient } = await import("../../platform/client.js");
339
+ const client = await VellumPlatformClient.create();
340
+ if (!client) return null;
341
+ // Use the client's authenticated fetch to extract base URL + API key
342
+ // by making a dummy call. The client encapsulates the credentials
343
+ // privately, so we use its fetch method directly.
344
+ return {
345
+ fetch: globalThis.fetch.bind(globalThis),
346
+ platformBaseUrl: (client as unknown as { platformBaseUrl: string })
347
+ .platformBaseUrl,
348
+ apiKey: (client as unknown as { apiKey: string }).apiKey,
349
+ };
350
+ }
351
+
352
+ // ---------------------------------------------------------------------------
353
+ // Formatting
354
+ // ---------------------------------------------------------------------------
355
+
356
+ /**
357
+ * Format a publish payload as a JSON string for `--print` mode.
358
+ */
359
+ export function formatPayloadForPrint(payload: PublishPayload): string {
360
+ return JSON.stringify(payload, null, 2);
361
+ }
362
+
363
+ /**
364
+ * Format validation results for terminal output.
365
+ */
366
+ export function formatValidationResult(validation: PublishValidation): string {
367
+ const lines: string[] = [];
368
+
369
+ if (validation.issues.length > 0) {
370
+ lines.push("Validation errors:");
371
+ for (const issue of validation.issues) {
372
+ lines.push(` ✗ ${issue}`);
373
+ }
374
+ }
375
+
376
+ if (validation.warnings.length > 0) {
377
+ if (lines.length > 0) lines.push("");
378
+ lines.push("Warnings:");
379
+ for (const warning of validation.warnings) {
380
+ lines.push(` ⚠ ${warning}`);
381
+ }
382
+ }
383
+
384
+ if (validation.valid && validation.warnings.length === 0) {
385
+ lines.push("✓ Plugin validation passed");
386
+ }
387
+
388
+ return lines.join("\n");
389
+ }
390
+
391
+ // ---------------------------------------------------------------------------
392
+ // CLI entrypoint
393
+ // ---------------------------------------------------------------------------
394
+
395
+ export interface PublishCliOptions {
396
+ print?: boolean;
397
+ path?: string;
398
+ force?: boolean;
399
+ json?: boolean;
400
+ category?: string;
401
+ }
402
+
403
+ export interface PublishCliDeps {
404
+ confirmPrompt: (opts: {
405
+ question: string;
406
+ isTTY: boolean;
407
+ refuseNonInteractiveMessage: string;
408
+ }) => Promise<string>;
409
+ }
410
+
411
+ /**
412
+ * Run the full `plugins publish` flow. This is the single entrypoint that
413
+ * the CLI command calls. All validation, git resolution, confirmation,
414
+ * and submission logic lives here rather than in the command file.
415
+ *
416
+ * Returns `true` on success, `false` on failure (with an appropriate
417
+ * message already printed).
418
+ */
419
+ export async function runPublish(
420
+ opts: PublishCliOptions,
421
+ deps: PublishCliDeps,
422
+ ): Promise<boolean> {
423
+ // 1. Find the plugin root
424
+ const searchDir = opts.path ?? process.cwd();
425
+ const pluginDir = findPluginRoot(searchDir);
426
+ if (!pluginDir) {
427
+ if (opts.json) {
428
+ process.stdout.write(
429
+ JSON.stringify({
430
+ ok: false,
431
+ error: "no_package_json",
432
+ message: `No package.json found in ${searchDir} or any parent directory.`,
433
+ }) + "\n",
434
+ );
435
+ } else {
436
+ console.error(
437
+ `No package.json found in ${searchDir} or any parent directory.`,
438
+ );
439
+ }
440
+ return false;
441
+ }
442
+
443
+ // 2. Validate the plugin
444
+ const validation = validatePluginForPublish(pluginDir);
445
+ if (!validation.valid) {
446
+ if (opts.json) {
447
+ process.stdout.write(
448
+ JSON.stringify({ ok: false, errors: validation.issues }) + "\n",
449
+ );
450
+ } else {
451
+ console.error(formatValidationResult(validation));
452
+ }
453
+ return false;
454
+ }
455
+
456
+ if (!opts.json && validation.warnings.length > 0) {
457
+ console.warn(formatValidationResult(validation));
458
+ }
459
+
460
+ // 3. Handle --print mode early (no git context needed)
461
+ if (opts.print) {
462
+ // For --print, resolve git context best-effort to fill source fields
463
+ let git: GitContext | null = null;
464
+ try {
465
+ git = await resolveGitContext(pluginDir);
466
+ } catch {
467
+ // Git not available — use placeholder values
468
+ }
469
+
470
+ const category = opts.category ?? "other";
471
+ const payload = git
472
+ ? buildPublishPayload(validation, git, category)
473
+ : {
474
+ name: validation.packageJson.name!,
475
+ source: {
476
+ source: "github" as const,
477
+ repo: "<unknown>",
478
+ ref: "<unknown>",
479
+ },
480
+ category,
481
+ ...(validation.packageJson.description
482
+ ? { description: validation.packageJson.description }
483
+ : {}),
484
+ ...(validation.packageJson.license
485
+ ? { license: validation.packageJson.license }
486
+ : {}),
487
+ ...(validation.packageJson.homepage
488
+ ? { homepage: validation.packageJson.homepage }
489
+ : {}),
490
+ };
491
+
492
+ if (opts.json) {
493
+ process.stdout.write(JSON.stringify({ ok: true, payload }) + "\n");
494
+ } else {
495
+ console.log(formatPayloadForPrint(payload));
496
+ }
497
+ return true;
498
+ }
499
+
500
+ // 4. Resolve git context (required for submission)
501
+ let git: GitContext;
502
+ try {
503
+ git = await resolveGitContext(pluginDir);
504
+ } catch (err) {
505
+ const message = err instanceof Error ? err.message : String(err);
506
+ if (opts.json) {
507
+ process.stdout.write(
508
+ JSON.stringify({
509
+ ok: false,
510
+ error: "git_resolution_failed",
511
+ message: `Git context resolution failed: ${message}`,
512
+ }) + "\n",
513
+ );
514
+ } else {
515
+ console.error(`Git context resolution failed: ${message}`);
516
+ }
517
+ return false;
518
+ }
519
+
520
+ if (git.dirty) {
521
+ console.warn(
522
+ "Warning: working tree is dirty. The pinned commit SHA should match a clean, pushed commit.",
523
+ );
524
+ }
525
+
526
+ if (!git.pushed) {
527
+ if (opts.json) {
528
+ process.stdout.write(
529
+ JSON.stringify({
530
+ ok: false,
531
+ error: "not_pushed",
532
+ message: `Commit ${git.sha.slice(0, 7)} has not been pushed to the remote. Push your changes first.`,
533
+ }) + "\n",
534
+ );
535
+ } else {
536
+ console.error(
537
+ `Commit ${git.sha.slice(0, 7)} has not been pushed to the remote. Push your changes first.`,
538
+ );
539
+ }
540
+ return false;
541
+ }
542
+
543
+ // 5. Determine category and build payload
544
+ const category = opts.category ?? "other";
545
+ const payload = buildPublishPayload(validation, git, category);
546
+
547
+ // 6. Confirm before submitting (unless --force or --json)
548
+ if (!opts.force && !opts.json) {
549
+ console.log("\nPlugin entry to submit:");
550
+ console.log(formatPayloadForPrint(payload));
551
+ console.log("");
552
+ const result = await deps.confirmPrompt({
553
+ question: "Submit this entry to the Vellum marketplace? [y/N] ",
554
+ isTTY: Boolean(process.stdin.isTTY),
555
+ refuseNonInteractiveMessage:
556
+ "Refusing to publish non-interactively. Pass --force to confirm.",
557
+ });
558
+ if (result === "non-interactive" || result === "denied") {
559
+ if (result === "non-interactive") {
560
+ console.error(
561
+ "Refusing to publish non-interactively. Pass --force to confirm.",
562
+ );
563
+ }
564
+ return false;
565
+ }
566
+ }
567
+
568
+ // 7. Submit to the platform API
569
+ const platformDeps = await resolvePlatformDeps();
570
+ if (!platformDeps) {
571
+ const msg =
572
+ "Not connected to Vellum platform. Run `assistant platform connect` to connect, or use --print to generate the entry without submitting.";
573
+ if (opts.json) {
574
+ process.stdout.write(
575
+ JSON.stringify({
576
+ ok: false,
577
+ error: "not_connected",
578
+ message: msg,
579
+ }) + "\n",
580
+ );
581
+ } else {
582
+ console.error(msg);
583
+ }
584
+ return false;
585
+ }
586
+
587
+ try {
588
+ const result = await postPublishRequest(payload, platformDeps);
589
+
590
+ if (opts.json) {
591
+ process.stdout.write(JSON.stringify(result) + "\n");
592
+ } else {
593
+ console.log(formatPublishResult(result));
594
+ }
595
+
596
+ return result.ok;
597
+ } catch (err) {
598
+ const message = err instanceof Error ? err.message : String(err);
599
+ if (opts.json) {
600
+ process.stdout.write(
601
+ JSON.stringify({
602
+ ok: false,
603
+ error: "request_failed",
604
+ message,
605
+ }) + "\n",
606
+ );
607
+ } else {
608
+ console.error(`Publish request failed: ${message}`);
609
+ }
610
+ return false;
611
+ }
612
+ }/**
613
+ * Format a publish result for terminal output.
614
+ */
615
+ export function formatPublishResult(result: PublishResult): string {
616
+ if (!result.ok) {
617
+ return `✗ Publish failed: ${result.message ?? result.error ?? "unknown error"}`;
618
+ }
619
+
620
+ const lines: string[] = [
621
+ `✓ PR opened: ${result.pr_url}`,
622
+ "",
623
+ "The Vellum team will review your plugin. The review checks:",
624
+ " • Pinned commit is reachable and public",
625
+ " • package.json has @vellumai/plugin-api peer dependency",
626
+ " • Plugin loads cleanly (hooks register, tools validate)",
627
+ " • Surfaces contribute on boot (not silently failing)",
628
+ "",
629
+ "You'll get a notification when the review is complete.",
630
+ ];
631
+
632
+ return lines.join("\n");
633
+ }