@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.
- package/bun.lock +20 -0
- package/docs/workspace-tools.md +42 -33
- package/eslint-rules/cli-no-daemon-internals.js +6 -0
- package/node_modules/@vellumai/gateway-client/src/__tests__/guardian-delivery-contract.test.ts +91 -0
- package/node_modules/@vellumai/gateway-client/src/__tests__/trust-verdict-contract.test.ts +31 -0
- package/node_modules/@vellumai/gateway-client/src/gateway-ipc-contracts.ts +44 -0
- package/node_modules/@vellumai/gateway-client/src/guardian-delivery-contract.ts +48 -0
- package/node_modules/@vellumai/gateway-client/src/index.ts +14 -0
- package/node_modules/@vellumai/gateway-client/src/trust-verdict-contract.ts +17 -0
- package/node_modules/@vellumai/service-contracts/package.json +1 -0
- package/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts +28 -0
- package/node_modules/@vellumai/service-contracts/src/channels.ts +41 -0
- package/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
- package/openapi.yaml +196 -56
- package/package.json +4 -1
- package/scripts/test.sh +36 -15
- package/src/__tests__/actor-token-service.test.ts +36 -14
- package/src/__tests__/actor-trust-resolver-address-fallback.test.ts +83 -31
- package/src/__tests__/agent-loop-override-profile.test.ts +1 -0
- package/src/__tests__/agent-wake-disk-pressure-callsite.test.ts +2 -0
- package/src/__tests__/agent-wake-override-profile.test.ts +2 -0
- package/src/__tests__/annotate-activity-metadata.test.ts +2 -0
- package/src/__tests__/annotate-risk-options.test.ts +2 -0
- package/src/__tests__/approval-cascade.test.ts +2 -0
- package/src/__tests__/assistant-attachments.test.ts +42 -0
- package/src/__tests__/background-workers-disk-pressure.test.ts +2 -0
- package/src/__tests__/btw-routes.test.ts +2 -0
- package/src/__tests__/build-persisted-content.test.ts +2 -0
- package/src/__tests__/call-controller.test.ts +19 -0
- package/src/__tests__/channel-approval-routes.test.ts +21 -26
- package/src/__tests__/channel-delivery-store.test.ts +28 -0
- package/src/__tests__/channel-guardian.test.ts +164 -78
- package/src/__tests__/channel-inbound-disk-pressure.test.ts +11 -19
- package/src/__tests__/channel-reply-delivery.test.ts +2 -0
- package/src/__tests__/code-search-tool.test.ts +585 -0
- package/src/__tests__/compaction-events.test.ts +2 -0
- package/src/__tests__/compaction-ledger-store.test.ts +128 -0
- package/src/__tests__/compaction.benchmark.test.ts +2 -0
- package/src/__tests__/compactor-call-site-logging.test.ts +2 -0
- package/src/__tests__/compactor-low-watermark-cut.test.ts +2 -0
- package/src/__tests__/compactor-preserved-tail-count.test.ts +2 -0
- package/src/__tests__/compactor-summary-call-truncation.test.ts +2 -0
- package/src/__tests__/compactor-web-search-strip.test.ts +2 -0
- package/src/__tests__/config-loader-backfill.test.ts +123 -10
- package/src/__tests__/config-schema.test.ts +1 -0
- package/src/__tests__/confirmation-request-guardian-bridge.test.ts +31 -29
- package/src/__tests__/consult-deadline.test.ts +60 -0
- package/src/__tests__/contact-store-interaction-info.test.ts +156 -0
- package/src/__tests__/contact-store-user-file.test.ts +7 -10
- package/src/__tests__/contacts-relay-reads.test.ts +19 -24
- package/src/__tests__/contacts-write.test.ts +0 -2
- package/src/__tests__/conversation-abort-tool-results.test.ts +2 -0
- package/src/__tests__/conversation-agent-loop-disk-pressure.test.ts +2 -0
- package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +2 -0
- package/src/__tests__/conversation-agent-loop-overflow.test.ts +2 -0
- package/src/__tests__/conversation-agent-loop.test.ts +134 -0
- package/src/__tests__/conversation-analysis-routes.test.ts +2 -0
- package/src/__tests__/conversation-app-control-lifecycle.test.ts +2 -0
- package/src/__tests__/conversation-attention-telegram.test.ts +9 -11
- package/src/__tests__/conversation-confirmation-signals.test.ts +2 -0
- package/src/__tests__/conversation-fork-crud.test.ts +354 -24
- package/src/__tests__/conversation-history-web-search.test.ts +2 -0
- package/src/__tests__/conversation-load-history-repair.test.ts +2 -0
- package/src/__tests__/conversation-load-history-stripped.test.ts +2 -0
- package/src/__tests__/conversation-pairing.test.ts +2 -0
- package/src/__tests__/conversation-process-app-control-preactivation.test.ts +2 -0
- package/src/__tests__/conversation-process-callsite.test.ts +2 -0
- package/src/__tests__/conversation-provider-retry-repair.test.ts +2 -0
- package/src/__tests__/conversation-queue.test.ts +91 -0
- package/src/__tests__/conversation-routes-guardian-reply.test.ts +14 -0
- package/src/__tests__/conversation-routes-slash-commands.test.ts +14 -0
- package/src/__tests__/conversation-slash-queue.test.ts +2 -0
- package/src/__tests__/conversation-slash-unknown.test.ts +2 -0
- package/src/__tests__/conversation-speed-override.test.ts +2 -0
- package/src/__tests__/conversation-surfaces-task-progress.test.ts +29 -0
- package/src/__tests__/conversation-title-service.test.ts +2 -0
- package/src/__tests__/conversation-tool-setup-attribution.test.ts +47 -0
- package/src/__tests__/conversation-usage.test.ts +2 -0
- package/src/__tests__/conversation-workspace-cache-state.test.ts +2 -0
- package/src/__tests__/conversation-workspace-injection.test.ts +2 -0
- package/src/__tests__/conversation-workspace-tool-tracking.test.ts +2 -0
- package/src/__tests__/credential-security-invariants.test.ts +1 -1
- package/src/__tests__/db-compaction-events-migration.test.ts +129 -0
- package/src/__tests__/db-migration-rollback.test.ts +205 -171
- package/src/__tests__/db-test-helpers.ts +5 -4
- package/src/__tests__/delete-propagation.test.ts +5 -3
- package/src/__tests__/deterministic-verification-control-plane.test.ts +4 -2
- package/src/__tests__/disk-pressure-guard.test.ts +41 -0
- package/src/__tests__/dm-backfill.test.ts +6 -4
- package/src/__tests__/dm-persistence.test.ts +2 -0
- package/src/__tests__/emit-signal-routing-intent.test.ts +7 -6
- package/src/__tests__/events-dev-bypass-actor.test.ts +7 -1
- package/src/__tests__/exploration-drift-hook.test.ts +3 -2
- package/src/__tests__/filing-service.test.ts +2 -0
- package/src/__tests__/guardian-binding-drift-heal.test.ts +104 -19
- package/src/__tests__/guardian-dispatch.test.ts +140 -1
- package/src/__tests__/guardian-expiry-notifier.test.ts +282 -0
- package/src/__tests__/guardian-outbound-http.test.ts +13 -0
- package/src/__tests__/guardian-routing-state.test.ts +6 -10
- package/src/__tests__/heartbeat-disk-pressure.test.ts +2 -0
- package/src/__tests__/heartbeat-service.test.ts +2 -0
- package/src/__tests__/helpers/channel-test-adapter.ts +46 -19
- package/src/__tests__/helpers/create-guardian-binding.ts +15 -23
- package/src/__tests__/helpers/mock-logger.ts +1 -0
- package/src/__tests__/helpers/seed-contact-channel.ts +96 -0
- package/src/__tests__/host-app-control-routes.test.ts +24 -30
- package/src/__tests__/host-bash-routes.test.ts +31 -41
- package/src/__tests__/host-browser-routes.test.ts +26 -32
- package/src/__tests__/host-cu-routes-targeted.test.ts +25 -33
- package/src/__tests__/host-file-routes-targeted.test.ts +40 -52
- package/src/__tests__/host-transfer-routes-targeted.test.ts +31 -43
- package/src/__tests__/http-user-message-parity.test.ts +290 -8
- package/src/__tests__/inbound-invite-redemption.test.ts +115 -10
- package/src/__tests__/inbound-slack-persistence.test.ts +2 -0
- package/src/__tests__/invite-redemption-service.test.ts +471 -53
- package/src/__tests__/invite-routes-http.test.ts +34 -0
- package/src/__tests__/invite-service-ipc.test.ts +65 -2
- package/src/__tests__/llm-context-normalization.test.ts +105 -0
- package/src/__tests__/llm-request-log-error-payload.test.ts +71 -9
- package/src/__tests__/llm-usage-store.test.ts +25 -0
- package/src/__tests__/mcp-config-secret-boundary.test.ts +392 -0
- package/src/__tests__/mcp-health-check.test.ts +2 -1
- package/src/__tests__/media-stream-server-integration.test.ts +127 -0
- package/src/__tests__/memory-retrieval-hook.test.ts +2 -0
- package/src/__tests__/messaging-send-tool.test.ts +2 -0
- package/src/__tests__/migration-import-from-url.test.ts +2 -2
- package/src/__tests__/mtime-cache.test.ts +275 -5
- package/src/__tests__/native-web-search.test.ts +2 -0
- package/src/__tests__/non-member-access-request.test.ts +191 -17
- package/src/__tests__/notification-broadcaster.test.ts +4 -0
- package/src/__tests__/notification-decision-recipient-context.test.ts +33 -32
- package/src/__tests__/notification-deep-link.test.ts +6 -0
- package/src/__tests__/notification-guardian-path.test.ts +19 -0
- package/src/__tests__/onboarding-persona-write.test.ts +52 -22
- package/src/__tests__/openai-provider.test.ts +22 -12
- package/src/__tests__/openai-responses-provider.test.ts +12 -2
- package/src/__tests__/outbound-slack-persistence.test.ts +2 -0
- package/src/__tests__/pending-interactions-resolved-event.test.ts +7 -4
- package/src/__tests__/persist-onboarding-artifacts.test.ts +1 -0
- package/src/__tests__/persistence-secret-redaction.test.ts +2 -0
- package/src/__tests__/persona-resolver.test.ts +75 -45
- package/src/__tests__/plugin-bootstrap.test.ts +21 -83
- package/src/__tests__/plugin-disabled-state.test.ts +190 -0
- package/src/__tests__/plugin-pipeline.test.ts +96 -0
- package/src/__tests__/plugin-route-contribution.test.ts +6 -19
- package/src/__tests__/plugin-tool-contribution.test.ts +5 -20
- package/src/__tests__/plugin-types.test.ts +2 -4
- package/src/__tests__/process-message-background-slack.test.ts +2 -0
- package/src/__tests__/process-message-display-content.test.ts +2 -0
- package/src/__tests__/provider-error-scenarios.test.ts +5 -4
- package/src/__tests__/provider-usage-tracking.test.ts +39 -0
- package/src/__tests__/reaction-intercept-cold-cache-warm.test.ts +135 -0
- package/src/__tests__/reaction-intercept-member-verdict-warm.test.ts +158 -0
- package/src/__tests__/reaction-persistence.test.ts +51 -4
- package/src/__tests__/regenerate-fire-and-forget-trace.test.ts +2 -0
- package/src/__tests__/registry.test.ts +4 -1
- package/src/__tests__/relay-server.test.ts +758 -32
- package/src/__tests__/runtime-attachment-metadata.test.ts +9 -12
- package/src/__tests__/secret-ingress-http.test.ts +14 -0
- package/src/__tests__/send-endpoint-busy.test.ts +30 -8
- package/src/__tests__/settings-routes.test.ts +32 -0
- package/src/__tests__/skills.test.ts +44 -0
- package/src/__tests__/slack-inbound-verification.test.ts +47 -2
- package/src/__tests__/sse-actor-principal-guardian-source.test.ts +79 -0
- package/src/__tests__/steer-on-enqueue-question.test.ts +181 -0
- package/src/__tests__/stt-hints.test.ts +49 -15
- package/src/__tests__/subagent-detail.test.ts +27 -0
- package/src/__tests__/subagent-disposal.test.ts +65 -0
- package/src/__tests__/subagent-fork-prompt-role.test.ts +195 -0
- package/src/__tests__/subagent-fork-spawn.test.ts +6 -7
- package/src/__tests__/subagent-notify-parent.test.ts +2 -0
- package/src/__tests__/subagent-role-registry.test.ts +24 -6
- package/src/__tests__/subagent-spawn-and-await.test.ts +546 -0
- package/src/__tests__/subagent-spawn-tool-fork.test.ts +2 -0
- package/src/__tests__/subagent-tools.test.ts +398 -1
- package/src/__tests__/suggestion-routes.test.ts +2 -0
- package/src/__tests__/thread-backfill.test.ts +3 -3
- package/src/__tests__/title-generate-hook.test.ts +2 -0
- package/src/__tests__/tool-executor-lifecycle-events.test.ts +2 -0
- package/src/__tests__/tool-executor.test.ts +16 -11
- package/src/__tests__/tool-preview-lifecycle.test.ts +2 -0
- package/src/__tests__/tool-result-metadata-plumbing.test.ts +2 -0
- package/src/__tests__/tool-start-timestamp.test.ts +2 -0
- package/src/__tests__/trusted-contact-approval-notifier.test.ts +37 -51
- package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +12 -12
- package/src/__tests__/trusted-contact-lifecycle-notifications.test.ts +9 -7
- package/src/__tests__/trusted-contact-multichannel.test.ts +16 -7
- package/src/__tests__/trusted-contact-verification.test.ts +79 -54
- package/src/__tests__/twilio-routes.test.ts +96 -0
- package/src/__tests__/ui-file-upload-surface.test.ts +86 -0
- package/src/__tests__/verification-control-plane-policy.test.ts +2 -0
- package/src/__tests__/voice-guardian-cold-cache-warm.test.ts +137 -0
- package/src/__tests__/voice-invite-redemption.test.ts +216 -20
- package/src/__tests__/web-search-backend-failure.test.ts +2 -0
- package/src/__tests__/workspace-migration-102-preserve-heartbeat-enabled-for-existing-workspaces.test.ts +3 -3
- package/src/__tests__/workspace-migration-111-prune-seeded-callsite-defaults.test.ts +208 -0
- package/src/__tests__/workspace-migration-112-remove-advisor-callsite-override.test.ts +170 -0
- package/src/__tests__/workspace-migration-drop-user-md.test.ts +196 -238
- package/src/__tests__/workspace-migration-remove-hooks.test.ts +14 -35
- package/src/__tests__/workspace-tool-loader.test.ts +195 -2
- package/src/a2a/__tests__/e2e-a2a-channel.test.ts +35 -47
- package/src/agent/loop-exclusive-tool.test.ts +154 -0
- package/src/agent/loop-native-web-search.test.ts +200 -0
- package/src/agent/loop.ts +164 -1
- package/src/api/constants/sse-replay.ts +41 -0
- package/src/api/events/conversation-notice.ts +26 -0
- package/src/api/index.ts +19 -1
- package/src/api/responses/llm-request-log-entry.ts +29 -0
- package/src/api/responses/subagent-detail.ts +17 -0
- package/src/api/surfaces.ts +39 -3
- package/src/approvals/guardian-channel-delivery.ts +30 -0
- package/src/approvals/guardian-expiry-notifier.ts +148 -0
- package/src/approvals/guardian-request-resolvers.ts +17 -15
- package/src/calls/__tests__/relay-setup-router.test.ts +267 -17
- package/src/calls/call-domain.ts +3 -3
- package/src/calls/guardian-dispatch.ts +14 -9
- package/src/calls/inbound-trust-reader.ts +24 -2
- package/src/calls/media-stream-server.ts +21 -0
- package/src/calls/relay-access-wait.ts +6 -6
- package/src/calls/relay-server.ts +188 -51
- package/src/calls/relay-setup-router.ts +47 -17
- package/src/calls/relay-verification.ts +4 -4
- package/src/calls/stt-hints.ts +9 -12
- package/src/calls/twilio-routes.ts +14 -4
- package/src/channels/types.ts +10 -20
- package/src/cli/commands/__tests__/cache.test.ts +8 -1
- package/src/cli/commands/__tests__/conversations-slack.test.ts +1 -0
- package/src/cli/commands/cache.ts +194 -181
- package/src/cli/commands/contacts.ts +10 -7
- package/src/cli/commands/db/__tests__/repair.test.ts +6 -5
- package/src/cli/commands/db/status.ts +37 -1
- package/src/cli/commands/mcp.ts +252 -218
- package/src/cli/commands/memory/__tests__/worker.test.ts +432 -0
- package/src/cli/commands/memory/index.ts +2 -0
- package/src/cli/commands/memory/worker.ts +242 -0
- package/src/cli/commands/plugins.ts +125 -13
- package/src/cli/lib/__tests__/install-from-github.test.ts +102 -0
- package/src/cli/lib/__tests__/list-installed-plugins.test.ts +160 -1
- package/src/cli/lib/__tests__/publish-plugin.test.ts +404 -0
- package/src/cli/lib/list-installed-plugins.ts +179 -1
- package/src/cli/lib/publish-plugin.ts +633 -0
- package/src/config/__tests__/loader-callsite-strip-fallback.test.ts +143 -0
- package/src/config/__tests__/sync-gated-profiles.test.ts +16 -10
- package/src/config/bundled-skills/contacts/tools/contact-merge.ts +27 -17
- package/src/config/bundled-skills/contacts/tools/contact-search.ts +13 -3
- package/src/config/bundled-skills/subagent/SKILL.md +17 -2
- package/src/config/bundled-skills/subagent/TOOLS.json +5 -4
- package/src/config/call-site-defaults.ts +0 -6
- package/src/config/feature-flag-registry.json +5 -13
- package/src/config/llm-resolver.ts +0 -3
- package/src/config/loader.ts +38 -5
- package/src/config/prune-seeded-callsite-defaults.ts +110 -0
- package/src/config/schemas/__tests__/memory-v3.test.ts +1 -0
- package/src/config/schemas/call-site-catalog.ts +0 -7
- package/src/config/schemas/heartbeat.ts +2 -5
- package/src/config/schemas/llm.ts +3 -12
- package/src/config/schemas/memory-lifecycle.ts +12 -0
- package/src/config/schemas/memory-v3.ts +7 -0
- package/src/config/schemas/memory.ts +4 -0
- package/src/config/schemas/timeouts.ts +8 -0
- package/src/config/seed-inference-profiles.ts +30 -34
- package/src/config/skills.ts +27 -5
- package/src/config/sync-gated-profiles.ts +12 -16
- package/src/contacts/__tests__/contacts-write-revoke-relay.test.ts +128 -0
- package/src/contacts/__tests__/guardian-delivery-reader.test.ts +312 -0
- package/src/contacts/__tests__/member-write-relay.test.ts +226 -0
- package/src/contacts/contact-store.ts +27 -237
- package/src/contacts/contacts-write.ts +18 -55
- package/src/contacts/gateway-channel-read.ts +51 -0
- package/src/contacts/guardian-delivery-reader.ts +223 -0
- package/src/contacts/member-write-relay.ts +183 -0
- package/src/contacts/types.ts +3 -15
- package/src/daemon/__tests__/conversation-tool-setup-exclude.test.ts +35 -0
- package/src/daemon/__tests__/conversation-tool-setup.test.ts +0 -44
- package/src/daemon/assistant-attachments.ts +27 -4
- package/src/daemon/conversation-agent-loop.ts +28 -0
- package/src/daemon/conversation-notices.ts +60 -0
- package/src/daemon/conversation-process.ts +35 -16
- package/src/daemon/conversation-surfaces.ts +111 -38
- package/src/daemon/conversation-tool-setup.ts +71 -30
- package/src/daemon/conversation.ts +23 -1
- package/src/daemon/disk-pressure-guard.ts +12 -2
- package/src/daemon/event-loop-watchdog.ts +28 -1
- package/src/daemon/external-plugins-bootstrap.ts +17 -41
- package/src/daemon/handlers/__tests__/config-a2a-accept.test.ts +0 -1
- package/src/daemon/handlers/__tests__/config-a2a-complete.test.ts +0 -2
- package/src/daemon/handlers/__tests__/config-a2a-redeem.test.ts +25 -2
- package/src/daemon/handlers/__tests__/config-channels.test.ts +220 -0
- package/src/daemon/handlers/config-a2a.ts +6 -14
- package/src/daemon/handlers/config-channels.ts +67 -26
- package/src/daemon/handlers/conversations.ts +77 -0
- package/src/daemon/lifecycle.ts +16 -0
- package/src/daemon/mcp-reload-service.ts +10 -0
- package/src/daemon/memory-v2-startup.test.ts +72 -0
- package/src/daemon/memory-v2-startup.ts +87 -19
- package/src/daemon/message-types/conversations.ts +2 -0
- package/src/daemon/message-types/surfaces.ts +12 -12
- package/src/daemon/server.ts +0 -4
- package/src/daemon/shutdown-handlers.ts +20 -0
- package/src/daemon/tool-setup-types.ts +9 -0
- package/src/heartbeat/heartbeat-service.ts +5 -0
- package/src/home/relationship-state-writer.ts +5 -0
- package/src/hooks/hook-loader.ts +341 -0
- package/src/ipc/__tests__/clients-list-ipc.test.ts +1 -1
- package/src/ipc/assistant-server.ts +2 -2
- package/src/mcp/__tests__/mcp-auth-orchestrator.test.ts +1 -0
- package/src/mcp/client.ts +15 -1
- package/src/mcp/mcp-auth-orchestrator.ts +6 -1
- package/src/mcp/mcp-header-store.ts +134 -0
- package/src/mcp/mcp-oauth-provider.ts +19 -8
- package/src/memory/__tests__/301-create-watchdog-events.test.ts +110 -0
- package/src/memory/__tests__/memory-retrospective-job.test.ts +8 -0
- package/src/memory/__tests__/prompt-override.test.ts +192 -0
- package/src/memory/__tests__/watchdog-events-store.test.ts +161 -0
- package/src/memory/compaction-ledger-store.ts +107 -0
- package/src/memory/conversation-crud.ts +129 -61
- package/src/memory/db-connection.ts +22 -3
- package/src/memory/db-init.ts +37 -503
- package/src/memory/db-singleton.ts +6 -4
- package/src/memory/jobs-worker.ts +104 -0
- package/src/memory/llm-request-log-store.ts +26 -1
- package/src/memory/llm-usage-store.ts +48 -20
- package/src/memory/memory-retrospective-job.ts +14 -8
- package/src/memory/migrations/209-strip-thinking-from-consolidated.ts +152 -56
- package/src/memory/migrations/300-add-processing-started-at.ts +30 -0
- package/src/memory/migrations/301-create-watchdog-events.ts +45 -0
- package/src/memory/migrations/302-create-compaction-events.ts +107 -0
- package/src/memory/migrations/__tests__/209-strip-thinking-from-consolidated.test.ts +297 -0
- package/src/memory/migrations/__tests__/run-migrations.test.ts +2 -2
- package/src/memory/migrations/run-migrations.ts +106 -10
- package/src/memory/migrations/validate-migration-state.ts +105 -67
- package/src/memory/prompt-override.ts +129 -0
- package/src/memory/schema/contacts.ts +6 -2
- package/src/memory/schema/conversations.ts +37 -0
- package/src/memory/schema/infrastructure.ts +20 -0
- package/src/memory/steps.ts +1294 -0
- package/src/memory/v2/__tests__/cli-command-store.test.ts +25 -0
- package/src/memory/v2/__tests__/skill-store.test.ts +80 -0
- package/src/memory/v2/cli-command-store.ts +75 -38
- package/src/memory/v2/prompts/consolidation.ts +13 -82
- package/src/memory/v2/prompts/router.ts +21 -93
- package/src/memory/v2/skill-store.ts +68 -31
- package/src/memory/watchdog-events-store.ts +87 -0
- package/src/memory/worker-control.ts +204 -0
- package/src/memory/worker-process.ts +89 -0
- package/src/messaging/channel-binding-metadata.ts +31 -0
- package/src/messaging/provider-types.ts +8 -0
- package/src/messaging/providers/slack/binding-metadata.ts +60 -0
- package/src/notifications/__tests__/broadcaster.test.ts +8 -8
- package/src/notifications/__tests__/connected-channels.test.ts +86 -0
- package/src/notifications/__tests__/decision-engine.test.ts +78 -9
- package/src/notifications/__tests__/destination-resolver.test.ts +151 -0
- package/src/notifications/broadcaster.ts +8 -1
- package/src/notifications/decision-engine.ts +15 -7
- package/src/notifications/destination-resolver.ts +53 -25
- package/src/notifications/emit-signal.ts +34 -15
- package/src/onboarding/checkin-event.test.ts +222 -0
- package/src/onboarding/checkin-event.ts +321 -0
- package/src/onboarding/schedule-checkin.ts +190 -0
- package/src/permissions/question-prompter.test.ts +1 -1
- package/src/permissions/question-prompter.ts +7 -4
- package/src/plugin-api/index.ts +12 -12
- package/src/plugin-api/types.ts +12 -14
- package/src/plugin-api/vision-support.test.ts +28 -4
- package/src/plugin-api/vision-support.ts +66 -31
- package/src/plugins/defaults/empty-response/hooks/post-model-call.ts +2 -2
- package/src/plugins/defaults/empty-response/hooks/stop.ts +2 -2
- package/src/plugins/defaults/exploration-drift/hooks/post-tool-use.ts +4 -3
- package/src/plugins/defaults/history-repair/hooks/post-model-call.ts +2 -2
- package/src/plugins/defaults/history-repair/hooks/stop.ts +2 -2
- package/src/plugins/defaults/history-repair/hooks/user-prompt-submit.ts +2 -2
- package/src/plugins/defaults/image-fallback/__tests__/image-fallback.test.ts +47 -7
- package/src/plugins/defaults/image-fallback/hooks/post-tool-use.ts +12 -13
- package/src/plugins/defaults/image-fallback/hooks/user-prompt-submit.ts +14 -22
- package/src/plugins/defaults/image-fallback/src/caption-blocks.ts +42 -11
- package/src/plugins/defaults/image-recovery/hooks/post-model-call.ts +2 -2
- package/src/plugins/defaults/image-recovery/hooks/stop.ts +2 -2
- package/src/plugins/defaults/index.ts +0 -35
- package/src/plugins/defaults/max-tokens-continue/hooks/post-model-call.ts +2 -2
- package/src/plugins/defaults/max-tokens-continue/hooks/stop.ts +2 -2
- package/src/plugins/defaults/memory-retrieval/hooks/post-compact.ts +2 -2
- package/src/plugins/defaults/memory-retrieval/hooks/user-prompt-submit.ts +2 -2
- package/src/plugins/defaults/memory-v3-shadow/__tests__/injection.test.ts +33 -3
- package/src/plugins/defaults/memory-v3-shadow/__tests__/pool-select.test.ts +48 -4
- package/src/plugins/defaults/memory-v3-shadow/__tests__/shadow-plugin.test.ts +4 -8
- package/src/plugins/defaults/memory-v3-shadow/hooks/post-compact.ts +2 -2
- package/src/plugins/defaults/memory-v3-shadow/hooks/user-prompt-submit.ts +2 -2
- package/src/plugins/defaults/memory-v3-shadow/injector.ts +43 -15
- package/src/plugins/defaults/memory-v3-shadow/orchestrate.ts +11 -2
- package/src/plugins/defaults/memory-v3-shadow/pool-select.test.ts +146 -0
- package/src/plugins/defaults/memory-v3-shadow/pool-select.ts +77 -13
- package/src/plugins/defaults/memory-v3-shadow/shadow-plugin.ts +12 -11
- package/src/plugins/defaults/surface-completion-nudge/hooks/post-model-call.ts +2 -2
- package/src/plugins/defaults/surface-completion-nudge/hooks/stop.ts +2 -2
- package/src/plugins/defaults/task-progress-nudge/hooks/post-tool-use.ts +2 -2
- package/src/plugins/defaults/title-generate/hooks/stop.ts +2 -2
- package/src/plugins/defaults/title-generate/hooks/user-prompt-submit.ts +2 -2
- package/src/plugins/defaults/tool-error/hooks/post-tool-use.ts +2 -2
- package/src/plugins/defaults/tool-result-truncate/hooks/post-tool-use.ts +2 -2
- package/src/plugins/disabled-state.ts +31 -0
- package/src/plugins/external-plugin-loader.ts +2 -2
- package/src/plugins/mtime-cache.ts +186 -330
- package/src/plugins/pipeline.ts +111 -13
- package/src/plugins/registry.ts +59 -16
- package/src/plugins/surface-import.ts +121 -0
- package/src/plugins/types.ts +7 -9
- package/src/prompts/persona-resolver.ts +43 -11
- package/src/providers/anthropic/client.ts +5 -0
- package/src/providers/call-site-routing.ts +45 -0
- package/src/providers/model-catalog.ts +16 -0
- package/src/providers/openai/__tests__/api-error-normalization.test.ts +321 -0
- package/src/providers/openai/api-error-normalization.ts +270 -0
- package/src/providers/openai/chat-completions-provider.ts +37 -83
- package/src/providers/openai/responses-provider.ts +50 -46
- package/src/providers/openrouter/client.ts +5 -0
- package/src/providers/provider-send-message.ts +10 -0
- package/src/providers/ratelimit.ts +10 -0
- package/src/providers/registry.ts +1 -1
- package/src/providers/retry.ts +10 -0
- package/src/providers/types.ts +22 -0
- package/src/providers/usage-tracking.ts +10 -0
- package/src/runtime/__tests__/channel-verification-service.test.ts +133 -0
- package/src/runtime/__tests__/guardian-vellum-migration.test.ts +184 -0
- package/src/runtime/__tests__/is-guardian-bound-for-channel.test.ts +66 -0
- package/src/runtime/__tests__/local-principal-trust.test.ts +162 -0
- package/src/runtime/__tests__/member-verdict-cache.test.ts +119 -0
- package/src/runtime/__tests__/trust-verdict-consumer.test.ts +402 -123
- package/src/runtime/access-request-helper.ts +18 -39
- package/src/runtime/actor-trust-resolver.ts +46 -19
- package/src/runtime/anchored-guardian.test.ts +109 -0
- package/src/runtime/anchored-guardian.ts +86 -0
- package/src/runtime/assistant-event-hub.ts +1 -1
- package/src/runtime/assistant-stream-state.ts +9 -2
- package/src/runtime/auth/__tests__/require-bound-guardian.test.ts +99 -0
- package/src/runtime/auth/require-bound-guardian.ts +21 -11
- package/src/runtime/channel-verification-service.ts +56 -31
- package/src/runtime/confirmation-request-guardian-bridge.ts +3 -3
- package/src/runtime/guardian-vellum-migration.ts +69 -8
- package/src/runtime/invite-redemption-service.ts +213 -187
- package/src/runtime/local-actor-identity.test.ts +108 -0
- package/src/runtime/local-actor-identity.ts +85 -13
- package/src/runtime/local-principal-trust.ts +52 -0
- package/src/runtime/member-verdict-cache.ts +0 -0
- package/src/runtime/pending-interactions.ts +11 -1
- package/src/runtime/routes/__tests__/channel-verification-revoke.test.ts +56 -5
- package/src/runtime/routes/__tests__/channel-verification-routes.test.ts +1 -1
- package/src/runtime/routes/__tests__/contact-routes.test.ts +305 -0
- package/src/runtime/routes/__tests__/global-search-routes.test.ts +92 -0
- package/src/runtime/routes/__tests__/http-adapter-actor-header.test.ts +129 -0
- package/src/runtime/routes/__tests__/surface-action-routes.test.ts +188 -0
- package/src/runtime/routes/browser-routes.ts +1 -1
- package/src/runtime/routes/canonical-guardian-expiry-sweep.ts +13 -5
- package/src/runtime/routes/channel-verification-routes.ts +3 -3
- package/src/runtime/routes/contact-routes.ts +48 -57
- package/src/runtime/routes/conversation-cli-routes.ts +4 -5
- package/src/runtime/routes/conversation-list-routes.ts +4 -7
- package/src/runtime/routes/conversation-query-routes.ts +72 -0
- package/src/runtime/routes/conversation-routes.ts +84 -85
- package/src/runtime/routes/events-routes.ts +2 -2
- package/src/runtime/routes/global-search-routes.ts +3 -1
- package/src/runtime/routes/guardian-action-routes.ts +4 -5
- package/src/runtime/routes/host-app-control-routes.ts +5 -4
- package/src/runtime/routes/host-bash-routes.ts +5 -4
- package/src/runtime/routes/host-browser-routes.ts +9 -11
- package/src/runtime/routes/host-cu-routes.ts +5 -4
- package/src/runtime/routes/host-file-routes.ts +5 -4
- package/src/runtime/routes/host-transfer-routes.ts +6 -6
- package/src/runtime/routes/http-adapter.ts +16 -1
- package/src/runtime/routes/identity-routes.ts +3 -2
- package/src/runtime/routes/inbound-message-handler.ts +5 -5
- package/src/runtime/routes/inbound-stages/acl-enforcement.test.ts +97 -5
- package/src/runtime/routes/inbound-stages/acl-enforcement.ts +61 -59
- package/src/runtime/routes/inbound-stages/background-dispatch.ts +13 -5
- package/src/runtime/routes/inbound-stages/escalation-intercept.ts +7 -7
- package/src/runtime/routes/inbound-stages/guardian-activation-intercept.test.ts +21 -8
- package/src/runtime/routes/inbound-stages/guardian-activation-intercept.ts +14 -3
- package/src/runtime/routes/inbound-stages/reaction-intercept.ts +19 -0
- package/src/runtime/routes/index.ts +2 -0
- package/src/runtime/routes/llm-context-normalization.ts +83 -0
- package/src/runtime/routes/mcp-auth-routes.ts +171 -19
- package/src/runtime/routes/migration-rollback-routes.ts +4 -3
- package/src/runtime/routes/migration-routes.ts +4 -1
- package/src/runtime/routes/onboarding-checkin-routes.ts +86 -0
- package/src/runtime/routes/settings-routes.ts +8 -3
- package/src/runtime/routes/subagents-routes.ts +5 -0
- package/src/runtime/routes/surface-action-routes.ts +42 -56
- package/src/runtime/services/__tests__/conversation-serializer.test.ts +1 -0
- package/src/runtime/services/conversation-serializer.ts +13 -58
- package/src/runtime/tool-grant-request-helper.ts +3 -3
- package/src/runtime/trust-verdict-consumer.ts +111 -40
- package/src/runtime/verification-outbound-actions.ts +18 -18
- package/src/signals/user-message.ts +16 -0
- package/src/subagent/__tests__/consult-prompt.test.ts +35 -0
- package/src/{plugins/defaults/advisor/__tests__/transcript.test.ts → subagent/__tests__/consult-transcript.test.ts} +47 -10
- package/src/{plugins/defaults/advisor/steering.ts → subagent/consult-prompt.ts} +22 -32
- package/src/{plugins/defaults/advisor/transcript.ts → subagent/consult-transcript.ts} +18 -8
- package/src/subagent/index.ts +1 -1
- package/src/subagent/manager.ts +254 -33
- package/src/subagent/types.ts +11 -4
- package/src/telemetry/types.ts +34 -1
- package/src/telemetry/usage-telemetry-reporter.test.ts +3 -2
- package/src/telemetry/usage-telemetry-reporter.ts +87 -3
- package/src/tools/ask-question/ask-question-tool.test.ts +29 -0
- package/src/tools/ask-question/ask-question-tool.ts +13 -0
- package/src/tools/executor.ts +4 -4
- package/src/tools/filesystem/search.ts +543 -0
- package/src/tools/registry.ts +38 -0
- package/src/tools/shared/filesystem/path-policy.ts +12 -5
- package/src/tools/subagent/consult-deadline.ts +49 -0
- package/src/tools/subagent/spawn.ts +234 -5
- package/src/tools/tool-approval-handler.ts +1 -1
- package/src/tools/tool-defaults.ts +9 -2
- package/src/tools/tool-manifest.ts +3 -0
- package/src/tools/types.ts +131 -25
- package/src/tools/workspace-tools/loader.ts +348 -244
- package/src/util/errors.ts +26 -1
- package/src/util/logger.ts +9 -0
- package/src/util/platform.ts +19 -0
- package/src/util/telemetry-db-path.ts +24 -0
- package/src/workflows/library.test.ts +140 -0
- package/src/workflows/library.ts +82 -28
- package/src/workspace/migrations/017-seed-persona-dirs.ts +3 -34
- package/src/workspace/migrations/019-scope-journal-to-guardian.ts +3 -24
- package/src/workspace/migrations/031-drop-user-md.ts +232 -148
- package/src/workspace/migrations/048-remove-workspace-hooks.ts +14 -66
- package/src/workspace/migrations/111-prune-seeded-callsite-defaults.ts +134 -0
- package/src/workspace/migrations/112-remove-advisor-callsite-override.ts +64 -0
- package/src/workspace/migrations/registry.ts +4 -0
- package/src/__tests__/workspace-tools-watcher-flag.test.ts +0 -70
- package/src/daemon/workspace-tools-watcher.ts +0 -328
- package/src/memory/migrations/registry.ts +0 -573
- package/src/plugins/defaults/advisor/__tests__/advisor-gate.test.ts +0 -56
- package/src/plugins/defaults/advisor/__tests__/advisor-state-store.test.ts +0 -43
- package/src/plugins/defaults/advisor/__tests__/agent-loop-integration.test.ts +0 -137
- package/src/plugins/defaults/advisor/__tests__/consult.test.ts +0 -153
- package/src/plugins/defaults/advisor/__tests__/hooks.test.ts +0 -138
- package/src/plugins/defaults/advisor/advisor-gate.ts +0 -29
- package/src/plugins/defaults/advisor/advisor-state-store.ts +0 -94
- package/src/plugins/defaults/advisor/config.ts +0 -21
- package/src/plugins/defaults/advisor/consult.ts +0 -93
- package/src/plugins/defaults/advisor/hooks/post-model-call.ts +0 -34
- package/src/plugins/defaults/advisor/hooks/pre-model-call.ts +0 -30
- package/src/plugins/defaults/advisor/hooks/user-prompt-submit.ts +0 -19
- package/src/plugins/defaults/advisor/package.json +0 -14
- package/src/plugins/defaults/advisor/tools/advisor.ts +0 -65
- 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
|
+
}
|