@vellumai/assistant 0.11.4 → 0.11.5-dev.202608220019.a778cf0
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/AGENTS.md +6 -2
- package/ARCHITECTURE.md +29 -4
- package/README.md +1 -1
- package/docs/architecture/memory.md +17 -5
- package/docs/architecture/security.md +96 -152
- package/docs/guardian-request-flow.md +13 -2
- package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/package.json +1 -0
- package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +118 -0
- package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/url-normalization.test.ts +135 -0
- package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
- package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/ingress.ts +103 -0
- package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/url-normalization.ts +107 -0
- package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/package.json +1 -0
- package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +118 -0
- package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/url-normalization.test.ts +135 -0
- package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
- package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/ingress.ts +103 -0
- package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/url-normalization.ts +107 -0
- package/node_modules/@vellumai/gateway-client/src/gateway-ipc-contracts.ts +166 -1
- package/node_modules/@vellumai/gateway-client/src/http-delivery.ts +7 -14
- package/node_modules/@vellumai/gateway-client/src/index.ts +2 -0
- package/node_modules/@vellumai/gateway-client/src/outbound-contract.ts +30 -32
- package/node_modules/@vellumai/service-contracts/package.json +1 -0
- package/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +118 -0
- package/node_modules/@vellumai/service-contracts/src/__tests__/url-normalization.test.ts +135 -0
- package/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
- package/node_modules/@vellumai/service-contracts/src/ingress.ts +103 -0
- package/node_modules/@vellumai/service-contracts/src/url-normalization.ts +107 -0
- package/openapi.yaml +487 -11
- package/package.json +1 -1
- package/scripts/sync-web-search-catalog.ts +6 -0
- package/src/__tests__/anthropic-provider.test.ts +10 -3
- package/src/__tests__/approval-interception-trust-gates.test.ts +40 -0
- package/src/__tests__/background-workers-disk-pressure.test.ts +1 -1
- package/src/__tests__/channel-approval-routes.test.ts +4 -0
- package/src/__tests__/channel-inbound-disk-pressure.test.ts +5 -6
- package/src/__tests__/channel-readiness-service.test.ts +126 -0
- package/src/__tests__/channel-reply-delivery.test.ts +30 -17
- package/src/__tests__/checker.test.ts +20 -314
- package/src/__tests__/cli-memory-v2-reembed-skills.test.ts +6 -2
- package/src/__tests__/client-os-metadata-persistence.test.ts +16 -0
- package/src/__tests__/compactor-retained-image-validation.test.ts +142 -0
- package/src/__tests__/config-loader-backfill.test.ts +19 -10
- package/src/__tests__/container-cpu-sampler.test.ts +153 -0
- package/src/__tests__/context-search-memory-v2-source.test.ts +0 -1
- package/src/__tests__/conversation-attachments.test.ts +0 -1
- package/src/__tests__/conversation-delete-watch-timeline.test.ts +231 -0
- package/src/__tests__/conversation-error.test.ts +17 -0
- package/src/__tests__/conversation-lifecycle.test.ts +20 -26
- package/src/__tests__/conversation-pairing.test.ts +186 -0
- package/src/__tests__/conversation-runtime-assembly.test.ts +21 -2
- package/src/__tests__/credential-broker-server-use.test.ts +24 -5
- package/src/__tests__/credential-routes.test.ts +22 -3
- package/src/__tests__/credential-security-invariants.test.ts +2 -1
- package/src/__tests__/daemon-credential-client.test.ts +88 -0
- package/src/__tests__/default-plugin-names-guard.test.ts +12 -1
- package/src/__tests__/dm-backfill.test.ts +63 -0
- package/src/__tests__/dynamic-skill-background-guard.test.ts +0 -2
- package/src/__tests__/edit-propagation.test.ts +107 -4
- package/src/__tests__/events-client-registration.test.ts +28 -0
- package/src/__tests__/file-write-tool.test.ts +4 -2
- package/src/__tests__/guardian-prompt-notice-privacy.test.ts +133 -0
- package/src/__tests__/guardian-verify-setup-skill-regression.test.ts +143 -97
- package/src/__tests__/helpers/gateway-classify-mock.ts +27 -6
- package/src/__tests__/host-proxy-interface.test.ts +11 -1
- package/src/__tests__/host-shell-tool.test.ts +23 -4
- package/src/__tests__/image-conversion.test.ts +143 -1
- package/src/__tests__/inline-skill-load-permissions.test.ts +47 -36
- package/src/__tests__/input-repairs.test.ts +207 -0
- package/src/__tests__/live-workspace-guard.test.ts +75 -0
- package/src/__tests__/managed-profile-guard.test.ts +4 -2
- package/src/__tests__/mcp-abort-signal.test.ts +1 -1
- package/src/__tests__/mcp-client-auth.test.ts +1 -1
- package/src/__tests__/mcp-tool-annotations-risk.test.ts +1 -1
- package/src/__tests__/media-resolve-image-validation.test.ts +310 -0
- package/src/__tests__/mtime-cache.test.ts +2 -0
- package/src/__tests__/notification-vellum-adapter.test.ts +124 -1
- package/src/__tests__/openai-provider.test.ts +40 -0
- package/src/__tests__/openai-responses-provider.test.ts +18 -0
- package/src/__tests__/personal-memory-auth-bypass.test.ts +22 -6
- package/src/__tests__/platform-bash-auto-approve.test.ts +0 -4
- package/src/__tests__/platform.test.ts +16 -1
- package/src/__tests__/plugin-api-resolve-credential.test.ts +22 -13
- package/src/__tests__/plugin-api-shim.test.ts +5 -0
- package/src/__tests__/plugin-api-store-credential.test.ts +268 -0
- package/src/__tests__/plugin-config-data-migration.test.ts +8 -1
- package/src/__tests__/plugin-disabled-state.test.ts +2 -0
- package/src/__tests__/plugin-effective-enabled-set.test.ts +55 -3
- package/src/__tests__/plugin-execution-context.test.ts +73 -0
- package/src/__tests__/plugin-import-boundary-guard.test.ts +0 -1
- package/src/__tests__/plugin-import-boundary-reverse-guard.test.ts +0 -1
- package/src/__tests__/reaction-persistence.test.ts +200 -7
- package/src/__tests__/require-fresh-approval.test.ts +0 -4
- package/src/__tests__/resource-pressure-guard.test.ts +428 -0
- package/src/__tests__/resource-pressure-routes.test.ts +113 -0
- package/src/__tests__/risk-classification-boundary-guard.test.ts +115 -0
- package/src/__tests__/run-conversation-turn-persistence.test.ts +27 -1
- package/src/__tests__/sanitize-config-for-transfer.test.ts +28 -0
- package/src/__tests__/secret-routes-platform-proxy.test.ts +7 -0
- package/src/__tests__/settings-routes.test.ts +85 -3
- package/src/__tests__/skill-tool-factory.test.ts +161 -0
- package/src/__tests__/tool-execution-pipeline.benchmark.test.ts +1 -1
- package/src/__tests__/tool-executor-lifecycle-events.test.ts +132 -5
- package/src/__tests__/tool-executor.test.ts +63 -38
- package/src/__tests__/tool-policy.test.ts +97 -1
- package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +7 -4
- package/src/__tests__/user-plugin-loader.test.ts +2 -0
- package/src/__tests__/validate-input.test.ts +243 -7
- package/src/__tests__/verification-control-plane-policy.test.ts +0 -2
- package/src/__tests__/voice-scoped-grant-consumer.test.ts +2 -0
- package/src/__tests__/voice-session-bridge.test.ts +42 -0
- package/src/__tests__/web-search-catalog-parity.test.ts +8 -0
- package/src/acp/__tests__/acp-claude-oauth.test.ts +97 -29
- package/src/acp/__tests__/prepare-agent-env.test.ts +376 -153
- package/src/acp/acp-claude-oauth.ts +38 -21
- package/src/acp/prepare-agent-env.ts +146 -55
- package/src/agent/loop-tool-dedup.test.ts +161 -0
- package/src/agent/loop.ts +68 -22
- package/src/api/constants/app-tools.ts +34 -0
- package/src/api/constants/profile-config-validation.ts +60 -0
- package/src/api/events/resource-pressure-status-changed.ts +53 -0
- package/src/api/events/tool-result.ts +6 -1
- package/src/api/events/watch-retro-completed.ts +52 -0
- package/src/api/index.ts +30 -0
- package/src/api/responses/resource-pressure-status.ts +25 -0
- package/src/approvals/guardian-channel-delivery.ts +70 -6
- package/src/approvals/guardian-request-resolvers.ts +32 -66
- package/src/calls/__tests__/voice-session-bridge.test.ts +114 -0
- package/src/calls/voice-session-bridge.ts +60 -6
- package/src/channels/__tests__/message-audience.test.ts +49 -0
- package/src/channels/__tests__/types.test.ts +17 -3
- package/src/channels/message-audience.ts +40 -0
- package/src/channels/types.ts +16 -12
- package/src/cli/__tests__/catalog-search-help.test.ts +50 -0
- package/src/cli/commands/__tests__/channel-verification-sessions.test.ts +31 -0
- package/src/cli/commands/__tests__/conversations-search.test.ts +289 -0
- package/src/cli/commands/__tests__/conversations-slack.test.ts +2 -1
- package/src/cli/commands/__tests__/inference-profiles.test.ts +16 -4
- package/src/cli/commands/__tests__/inference-providers.test.ts +135 -2
- package/src/cli/commands/__tests__/keys.test.ts +89 -8
- package/src/cli/commands/__tests__/plugins.test.ts +57 -1
- package/src/cli/commands/channel-verification-sessions.help.ts +11 -9
- package/src/cli/commands/channel-verification-sessions.ts +11 -21
- package/src/cli/commands/conversations.help.ts +34 -0
- package/src/cli/commands/conversations.ts +125 -0
- package/src/cli/commands/inference-profiles.ts +56 -3
- package/src/cli/commands/inference-providers.ts +37 -6
- package/src/cli/commands/inference.help.ts +9 -4
- package/src/cli/commands/keys.help.ts +13 -1
- package/src/cli/commands/keys.ts +26 -15
- package/src/cli/commands/memory/__tests__/memory-v2.test.ts +57 -7
- package/src/cli/commands/memory/index.help.ts +41 -27
- package/src/cli/commands/memory/index.ts +2 -0
- package/src/cli/commands/memory/memory-v2.ts +58 -54
- package/src/cli/commands/memory/memory-validate.ts +18 -0
- package/src/cli/commands/monitoring.ts +1 -0
- package/src/cli/commands/oauth/request.test.ts +93 -0
- package/src/cli/commands/oauth/request.ts +23 -9
- package/src/cli/commands/plugins.help.ts +28 -31
- package/src/cli/commands/plugins.ts +10 -0
- package/src/cli/commands/skills.help.ts +13 -16
- package/src/cli/commands/trust.ts +3 -14
- package/src/cli/lib/__tests__/install-from-github.test.ts +38 -0
- package/src/cli/lib/__tests__/merge-plugin-tree.test.ts +34 -0
- package/src/cli/lib/__tests__/plugin-surfaces.test.ts +32 -1
- package/src/cli/lib/__tests__/toggle-plugin.test.ts +2 -1
- package/src/cli/lib/__tests__/upgrade-plugin.test.ts +64 -0
- package/src/cli/lib/bundled-marketplace.json +26 -0
- package/src/cli/lib/daemon-credential-client.ts +25 -3
- package/src/cli/lib/install-from-github.ts +35 -24
- package/src/cli/lib/merge-plugin-tree.ts +22 -4
- package/src/cli/lib/open-browser.test.ts +67 -0
- package/src/cli/lib/open-browser.ts +24 -5
- package/src/cli/lib/plugin-surfaces.ts +27 -0
- package/src/config/__tests__/balanced-model-experiment.test.ts +7 -7
- package/src/config/__tests__/default-profile-catalog.test.ts +3 -3
- package/src/config/__tests__/profile-materialization.test.ts +26 -0
- package/src/config/default-profile-catalog.ts +5 -6
- package/src/config/feature-flag-registry.json +36 -28
- package/src/config/profile-materialization.ts +29 -0
- package/src/config/sanitize-for-transfer.ts +16 -0
- package/src/config/schemas/llm.ts +7 -0
- package/src/config/schemas/services.ts +6 -0
- package/src/config/webhook-routing.ts +8 -0
- package/src/context/compactor.ts +31 -2
- package/src/context/outbound-sanitize.ts +6 -0
- package/src/daemon/__tests__/lifecycle-watch-timeline-sweep.test.ts +98 -0
- package/src/daemon/__tests__/provider-rejection-log-fields.test.ts +272 -0
- package/src/daemon/conversation-agent-loop-handlers.ts +4 -1
- package/src/daemon/conversation-error.ts +19 -2
- package/src/daemon/conversation-messaging.ts +22 -2
- package/src/daemon/conversation-process.ts +11 -0
- package/src/daemon/conversation-store.ts +10 -0
- package/src/daemon/conversation-surfaces.ts +21 -8
- package/src/daemon/conversation.ts +12 -10
- package/src/daemon/daemon-control.ts +1 -0
- package/src/daemon/handlers/__tests__/config-ingress-tunnel-records.test.ts +208 -0
- package/src/daemon/handlers/config-ingress.ts +115 -5
- package/src/daemon/lifecycle.ts +30 -2
- package/src/daemon/message-types/conversations.ts +5 -7
- package/src/daemon/message-types/web-activity.ts +3 -2
- package/src/daemon/provider-rejection-log-fields.ts +124 -0
- package/src/daemon/resource-pressure-guard-lifecycle.ts +66 -0
- package/src/daemon/resource-pressure-guard.ts +387 -0
- package/src/daemon/shutdown-handlers.ts +2 -0
- package/src/daemon/startup-error.ts +16 -0
- package/src/daemon/trust-context.ts +14 -10
- package/src/daemon/unsendable-image-notice.ts +76 -0
- package/src/hooks/registry.ts +65 -51
- package/src/inbound/__tests__/tunnel-probe.test.ts +448 -0
- package/src/inbound/tunnel-probe.ts +261 -0
- package/src/ipc/__tests__/socket-path.test.ts +15 -7
- package/src/ipc/gateway-client.test.ts +1 -1
- package/src/ipc/gateway-client.ts +14 -21
- package/src/ipc/socket-cleanup.ts +2 -11
- package/src/mcp/__tests__/mcp-auth-orchestrator.test.ts +1 -1
- package/src/messaging/provider-message-metadata.ts +128 -0
- package/src/messaging/providers/__tests__/transport-dispatch.test.ts +138 -73
- package/src/messaging/providers/channel-transport.ts +100 -16
- package/src/messaging/providers/discord/send.ts +16 -0
- package/src/messaging/providers/discord/transport.ts +23 -1
- package/src/messaging/providers/index.ts +84 -16
- package/src/messaging/providers/slack/message-metadata.ts +45 -0
- package/src/messaging/providers/slack/render-transcript.ts +1 -4
- package/src/messaging/providers/slack/send.test.ts +88 -34
- package/src/messaging/providers/slack/send.ts +99 -50
- package/src/messaging/providers/slack/transport.ts +35 -37
- package/src/messaging/providers/telegram-bot/send.test.ts +88 -18
- package/src/messaging/providers/telegram-bot/send.ts +36 -0
- package/src/messaging/providers/telegram-bot/transport.ts +22 -8
- package/src/messaging/read-provider-metadata.test.ts +157 -0
- package/src/messaging/read-provider-metadata.ts +51 -0
- package/src/notifications/__tests__/assistant-reply-producer.test.ts +94 -0
- package/src/notifications/__tests__/edit-notification.test.ts +174 -2
- package/src/notifications/__tests__/home-feed-side-effect.test.ts +536 -4
- package/src/notifications/adapters/macos.ts +55 -0
- package/src/notifications/adapters/slack.ts +10 -5
- package/src/notifications/assistant-reply-producer.ts +37 -4
- package/src/notifications/conversation-pairing.ts +111 -21
- package/src/notifications/edit-notification.ts +38 -8
- package/src/notifications/emit-signal.ts +12 -14
- package/src/notifications/home-feed-side-effect.ts +218 -15
- package/src/notifications/types.ts +5 -0
- package/src/permissions/AGENTS.md +16 -0
- package/src/permissions/checker.test.ts +75 -122
- package/src/permissions/checker.ts +44 -560
- package/src/permissions/confirmation-guardian-request.test.ts +28 -3
- package/src/permissions/confirmation-guardian-request.ts +5 -1
- package/src/persistence/conversation-crud.ts +69 -20
- package/src/persistence/conversation-queries.ts +14 -1
- package/src/persistence/conversation-types.ts +22 -0
- package/src/persistence/db-async-query.ts +2 -1
- package/src/persistence/db-maintenance.ts +15 -0
- package/src/persistence/delivery-crud.ts +122 -15
- package/src/persistence/embeddings/qdrant-manager.ts +1 -0
- package/src/persistence/migrations/367-create-watch-timeline-entries.ts +46 -0
- package/src/persistence/migrations/368-watch-timeline-screenshot-blob.ts +33 -0
- package/src/persistence/migrations/__tests__/367-create-watch-timeline-entries.test.ts +98 -0
- package/src/persistence/migrations/__tests__/368-watch-timeline-screenshot-blob.test.ts +98 -0
- package/src/persistence/schema/index.ts +1 -0
- package/src/persistence/schema/watch.ts +29 -0
- package/src/persistence/steps.ts +4 -0
- package/src/plugin-api/__tests__/import-graph-partial-mock.test.ts +67 -0
- package/src/plugin-api/conversation-turn.ts +27 -0
- package/src/plugin-api/credential-scope.test.ts +15 -0
- package/src/plugin-api/credential-scope.ts +14 -0
- package/src/plugin-api/index.ts +19 -1
- package/src/plugin-api/resolve-credential.ts +15 -10
- package/src/plugin-api/store-credential.ts +148 -0
- package/src/plugin-api/system-card.ts +36 -0
- package/src/plugin-api/vision-support.test.ts +82 -0
- package/src/plugin-api/vision-support.ts +14 -2
- package/src/plugins/defaults/image-fallback/__tests__/image-fallback.test.ts +361 -110
- package/src/plugins/defaults/image-fallback/__tests__/vision-recovery.test.ts +4 -0
- package/src/plugins/defaults/image-fallback/hooks/user-prompt-submit.ts +58 -0
- package/src/plugins/defaults/image-fallback/src/caption-blocks.ts +64 -23
- package/src/plugins/defaults/image-recovery/detect.ts +24 -1
- package/src/plugins/defaults/main.ts +15 -0
- package/src/plugins/defaults/memory/AGENTS.md +11 -3
- package/src/plugins/defaults/memory/__tests__/memory-tier-boundary-guard.test.ts +0 -1
- package/src/plugins/defaults/memory/graph-topology/pending-buffer.ts +9 -12
- package/src/plugins/defaults/memory/memory-retrospective-prompt.ts +1 -1
- package/src/plugins/defaults/memory/src/memory-v2-routes.ts +12 -10
- package/src/plugins/defaults/memory/substrate/__tests__/consolidation-job.test.ts +114 -0
- package/src/plugins/defaults/memory/substrate/__tests__/consolidation-prompt-flag-gating-guard.test.ts +8 -0
- package/src/plugins/defaults/memory/substrate/__tests__/edge-index.test.ts +0 -30
- package/src/plugins/defaults/memory/substrate/__tests__/ingest.test.ts +73 -1
- package/src/plugins/defaults/memory/substrate/__tests__/page-index.test.ts +37 -0
- package/src/plugins/defaults/memory/substrate/__tests__/page-links.test.ts +208 -0
- package/src/plugins/defaults/memory/substrate/__tests__/prompts-consolidation.test.ts +158 -1
- package/src/plugins/defaults/memory/substrate/__tests__/static-context.test.ts +1 -61
- package/src/plugins/defaults/memory/substrate/consolidation-job.ts +68 -6
- package/src/plugins/defaults/memory/substrate/edge-index.ts +0 -31
- package/src/plugins/defaults/memory/substrate/ingest.ts +59 -0
- package/src/plugins/defaults/memory/substrate/page-index.ts +35 -8
- package/src/plugins/defaults/memory/substrate/page-links.ts +133 -0
- package/src/plugins/defaults/memory/substrate/page-store.ts +10 -0
- package/src/plugins/defaults/memory/substrate/prompts/consolidation.ts +124 -34
- package/src/plugins/defaults/memory/substrate/static-context.ts +0 -29
- package/src/plugins/defaults/memory/v3/__tests__/shadow-plugin.test.ts +3 -1
- package/src/plugins/defaults/memory/v3/card.ts +9 -9
- package/src/plugins/defaults/memory/v3/core-set.test.ts +7 -0
- package/src/plugins/defaults/memory/v3/core-set.ts +5 -1
- package/src/plugins/defaults/memory/v3/edge.ts +13 -57
- package/src/plugins/mtime-cache.ts +1 -1
- package/src/plugins/pipeline.ts +14 -7
- package/src/plugins/plugin-execution-context.ts +35 -11
- package/src/plugins/plugin-tree-walk.ts +63 -4
- package/src/providers/__tests__/retry-network-error.test.ts +84 -0
- package/src/providers/anthropic/__tests__/pause-turn-continuation.test.ts +170 -0
- package/src/providers/anthropic/client.ts +332 -241
- package/src/providers/connection-resolution.ts +25 -2
- package/src/providers/content-blocks.ts +22 -0
- package/src/providers/fetch-provider-catalog.ts +19 -0
- package/src/providers/gemini/client.ts +5 -2
- package/src/providers/inference/__tests__/adapter-factory-litellm.test.ts +47 -1
- package/src/providers/inference/__tests__/adapter-factory-ollama.test.ts +83 -0
- package/src/providers/inference/__tests__/adapter-factory-openai-compatible.test.ts +98 -1
- package/src/providers/inference/__tests__/base-url-route-validation.test.ts +38 -0
- package/src/providers/inference/__tests__/base-url-security.test.ts +10 -0
- package/src/providers/inference/__tests__/connections-ollama.test.ts +90 -0
- package/src/providers/inference/__tests__/endpoint-probe.test.ts +92 -0
- package/src/providers/inference/__tests__/missing-credential-guard.test.ts +117 -0
- package/src/providers/inference/__tests__/profile-config-validation.test.ts +39 -0
- package/src/providers/inference/__tests__/profile-probe-classify.test.ts +66 -0
- package/src/providers/inference/adapter-factory.ts +33 -2
- package/src/providers/inference/auth.ts +13 -2
- package/src/providers/inference/credential-usage.ts +37 -0
- package/src/providers/inference/endpoint-probe.ts +115 -0
- package/src/providers/inference/missing-credential-guard.ts +110 -0
- package/src/providers/inference/profile-probe.ts +256 -0
- package/src/providers/inference/resolve-auth.ts +7 -7
- package/src/providers/media-resolve.ts +176 -15
- package/src/providers/model-catalog.ts +10 -0
- package/src/providers/openai/__tests__/api-error-normalization.test.ts +17 -1
- package/src/providers/openai/__tests__/chat-completions-provider-reasoning.test.ts +576 -46
- package/src/providers/openai/__tests__/connection-error-wrap.test.ts +44 -0
- package/src/providers/openai/__tests__/tool-choice-mapping.test.ts +125 -2
- package/src/providers/openai/api-error-normalization.ts +16 -2
- package/src/providers/openai/chat-completions-provider.ts +326 -44
- package/src/providers/openai/responses-provider.ts +5 -2
- package/src/providers/provider-send-message.ts +11 -0
- package/src/providers/retry.ts +6 -0
- package/src/providers/search-provider-catalog.ts +20 -0
- package/src/routes/route-host-protocol.ts +7 -0
- package/src/routes/worker.ts +31 -10
- package/src/runtime/AGENTS.md +36 -0
- package/src/runtime/__tests__/host-observe.test.ts +302 -0
- package/src/runtime/__tests__/runtime-http-port-collision.test.ts +131 -0
- package/src/runtime/__tests__/web-presence.test.ts +234 -0
- package/src/runtime/assistant-event-hub.ts +38 -0
- package/src/runtime/channel-readiness-service.ts +39 -13
- package/src/runtime/channel-readiness-types.ts +49 -2
- package/src/runtime/channel-reply-delivery.ts +55 -32
- package/src/runtime/channel-retry-sweep.ts +6 -4
- package/src/runtime/effective-capabilities.test.ts +19 -0
- package/src/runtime/effective-capabilities.ts +25 -0
- package/src/runtime/guardian-reply-router.ts +6 -2
- package/src/runtime/host-observe.ts +246 -0
- package/src/runtime/http-errors.ts +1 -0
- package/src/runtime/http-server.ts +185 -6
- package/src/runtime/routes/__tests__/client-routes.test.ts +150 -0
- package/src/runtime/routes/__tests__/conversation-list-routes.test.ts +133 -0
- package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +80 -0
- package/src/runtime/routes/__tests__/credential-delete-in-use.test.ts +155 -0
- package/src/runtime/routes/__tests__/inference-profiles-routes.test.ts +118 -0
- package/src/runtime/routes/__tests__/inference-provider-connection-routes.test.ts +72 -1
- package/src/runtime/routes/__tests__/ingress-status-routes.test.ts +508 -0
- package/src/runtime/routes/__tests__/monitoring-routes.test.ts +1 -0
- package/src/runtime/routes/__tests__/pending-interactions-route.test.ts +175 -0
- package/src/runtime/routes/__tests__/plugins-routes.test.ts +103 -71
- package/src/runtime/routes/__tests__/surface-action-routes.test.ts +55 -6
- package/src/runtime/routes/__tests__/system-card-turn-termination.test.ts +107 -0
- package/src/runtime/routes/__tests__/user-route-dispatcher-host.test.ts +52 -1
- package/src/runtime/routes/__tests__/user-route-dispatcher.test.ts +75 -4
- package/src/runtime/routes/__tests__/watch-routes-guardian-cache.test.ts +139 -0
- package/src/runtime/routes/__tests__/watch-routes.test.ts +598 -0
- package/src/runtime/routes/approval-routes.ts +37 -4
- package/src/runtime/routes/approval-strategies/guardian-text-engine-strategy.ts +16 -22
- package/src/runtime/routes/canned-message-complete.ts +68 -29
- package/src/runtime/routes/channel-readiness-routes.ts +14 -2
- package/src/runtime/routes/client-routes.ts +113 -0
- package/src/runtime/routes/conversation-list-routes.ts +22 -7
- package/src/runtime/routes/conversation-management-routes.ts +15 -9
- package/src/runtime/routes/conversation-query-routes.ts +10 -0
- package/src/runtime/routes/conversation-routes.ts +36 -22
- package/src/runtime/routes/credential-in-use.ts +85 -0
- package/src/runtime/routes/credential-routes.ts +55 -85
- package/src/runtime/routes/guardian-approval-interception.ts +44 -53
- package/src/runtime/routes/guardian-approval-reply-helpers.ts +14 -12
- package/src/runtime/routes/host-cu-routes.ts +18 -0
- package/src/runtime/routes/identity-routes.ts +5 -121
- package/src/runtime/routes/inbound-message-handler.ts +74 -30
- package/src/runtime/routes/inbound-stages/acl-enforcement.ts +16 -17
- package/src/runtime/routes/inbound-stages/background-dispatch.test.ts +182 -297
- package/src/runtime/routes/inbound-stages/background-dispatch.ts +173 -386
- package/src/runtime/routes/inbound-stages/edit-intercept.ts +101 -77
- package/src/runtime/routes/inbound-stages/guardian-reply-intercept.ts +17 -8
- package/src/runtime/routes/inbound-stages/reaction-intercept.test.ts +91 -7
- package/src/runtime/routes/inbound-stages/reaction-intercept.ts +72 -70
- package/src/runtime/routes/index.ts +4 -0
- package/src/runtime/routes/inference-profiles-routes.ts +232 -31
- package/src/runtime/routes/inference-provider-connection-routes.ts +33 -11
- package/src/runtime/routes/ingress-status-routes.ts +180 -0
- package/src/runtime/routes/monitoring-routes.ts +9 -1
- package/src/runtime/routes/oauth-commands-routes.ts +1 -1
- package/src/runtime/routes/plugins-routes.ts +28 -32
- package/src/runtime/routes/resource-pressure-routes.ts +22 -0
- package/src/runtime/routes/secret-routes.ts +39 -8
- package/src/runtime/routes/settings-routes.ts +15 -12
- package/src/runtime/routes/surface-action-routes.ts +20 -19
- package/src/runtime/routes/user-route-dispatcher.ts +31 -2
- package/src/runtime/routes/user-route-resolution.ts +18 -1
- package/src/runtime/routes/watch-routes.ts +807 -0
- package/src/runtime/slack-reply-session.test.ts +23 -13
- package/src/runtime/slack-reply-session.ts +38 -55
- package/src/runtime/web-presence.ts +90 -0
- package/src/security/__tests__/untrusted-content.test.ts +42 -0
- package/src/security/untrusted-content.ts +28 -9
- package/src/skills/validate-input.ts +177 -40
- package/src/subagent/__tests__/consult-context-gating.test.ts +6 -10
- package/src/subagent/consult-context.ts +7 -23
- package/src/tools/credentials/broker.ts +24 -79
- package/src/tools/credentials/ref-parse.ts +35 -0
- package/src/tools/credentials/resolve.ts +4 -10
- package/src/tools/credentials/store.ts +168 -0
- package/src/tools/credentials/tool-policy.ts +67 -0
- package/src/tools/executor.ts +53 -15
- package/src/tools/network/__tests__/firecrawl-compat.test.ts +77 -0
- package/src/tools/network/__tests__/web-fetch-fastcrw.test.ts +169 -0
- package/src/tools/network/__tests__/web-search.test.ts +138 -3
- package/src/tools/network/firecrawl-compat.ts +90 -0
- package/src/tools/network/url-safety.ts +9 -16
- package/src/tools/network/web-fetch.ts +142 -62
- package/src/tools/network/web-search.ts +162 -58
- package/src/tools/permission-checker.ts +43 -52
- package/src/tools/schema-transforms.ts +40 -5
- package/src/tools/shared/input-repairs.ts +160 -0
- package/src/tools/skills/skill-tool-factory.ts +18 -4
- package/src/tools/subagent/spawn.ts +0 -1
- package/src/tools/tool-approval-handler.ts +16 -10
- package/src/tools/tool-types.ts +26 -13
- package/src/tools/types.ts +6 -6
- package/src/util/__tests__/cgroup-memory.test.ts +3 -0
- package/src/util/cgroup-memory.ts +3 -0
- package/src/util/container-cpu-sampler.ts +250 -0
- package/src/util/image-conversion.ts +178 -14
- package/src/util/platform.ts +93 -10
- package/src/util/worker-process.ts +1 -0
- package/src/watch/__tests__/watch-retro.test.ts +665 -0
- package/src/watch/__tests__/watch-session-manager.test.ts +566 -0
- package/src/watch/__tests__/watch-timeline.test.ts +670 -0
- package/src/watch/watch-retro.ts +480 -0
- package/src/watch/watch-session-manager.ts +575 -0
- package/src/watch/watch-timeline.ts +848 -0
- package/src/permissions/ipc-risk-types.ts +0 -143
- package/src/permissions/risk-types.ts +0 -76
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Ingress status route: is the assistant's public tunnel actually up?
|
|
3
|
+
*
|
|
4
|
+
* The recorded `ingress.publicBaseUrl` only says a tunnel was configured at
|
|
5
|
+
* some point. It stays behind in both directions: a killed tunnel leaves the
|
|
6
|
+
* URL in place, and an edge can survive while the gateway behind it dies or
|
|
7
|
+
* while it starts fronting a different assistant. This route resolves that by
|
|
8
|
+
* probing the URL live (`inbound/tunnel-probe.ts`) and reporting one of six
|
|
9
|
+
* states, so a client can tell the user what to do instead of guessing. The
|
|
10
|
+
* card the states drive exists to pair devices, so an address that answers
|
|
11
|
+
* without serving the pairing app is its own state (`unpairable`) rather than
|
|
12
|
+
* a healthy one.
|
|
13
|
+
*
|
|
14
|
+
* Platform-hosted assistants receive webhooks through platform callback
|
|
15
|
+
* routing and never run `vellum tunnel`, so they report `unconfigured`
|
|
16
|
+
* rather than a tunnel state they cannot act on. A self-hosted gateway whose
|
|
17
|
+
* Velay tunnel owns the URL is the same story one layer down: that URL
|
|
18
|
+
* carries webhooks alone, so it is `unconfigured` for pairing too, and the
|
|
19
|
+
* gateway publishes and restores it without a tunnel command either way.
|
|
20
|
+
*/
|
|
21
|
+
import { normalizePublicBaseUrl } from "@vellumai/service-contracts/ingress";
|
|
22
|
+
import { z } from "zod";
|
|
23
|
+
|
|
24
|
+
import {
|
|
25
|
+
getIngressConfigResult,
|
|
26
|
+
isVelayManagedIngress,
|
|
27
|
+
loadLastTunnelRecord,
|
|
28
|
+
loadPairingTunnelRecord,
|
|
29
|
+
loadRecordedAssistantId,
|
|
30
|
+
} from "../../daemon/handlers/config-ingress.js";
|
|
31
|
+
import { probeTunnel } from "../../inbound/tunnel-probe.js";
|
|
32
|
+
import { ACTOR_PRINCIPALS } from "../auth/route-policy.js";
|
|
33
|
+
import type { RouteDefinition } from "./types.js";
|
|
34
|
+
|
|
35
|
+
// ── Schemas ─────────────────────────────────────────────────────────────
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Flat rather than a union on `state` so the generated client SDK stays a
|
|
39
|
+
* single type; which fields are populated follows from `state`.
|
|
40
|
+
*/
|
|
41
|
+
const IngressStatusResponseSchema = z.object({
|
|
42
|
+
state: z.enum([
|
|
43
|
+
"unconfigured",
|
|
44
|
+
"stopped",
|
|
45
|
+
"healthy",
|
|
46
|
+
"unpairable",
|
|
47
|
+
"unreachable",
|
|
48
|
+
"foreign",
|
|
49
|
+
]),
|
|
50
|
+
publicBaseUrl: z
|
|
51
|
+
.string()
|
|
52
|
+
.optional()
|
|
53
|
+
.describe(
|
|
54
|
+
"The probed URL. Set for healthy, unpairable, unreachable, and foreign.",
|
|
55
|
+
),
|
|
56
|
+
lastTunnel: z
|
|
57
|
+
.object({ provider: z.string(), publicBaseUrl: z.string() })
|
|
58
|
+
.optional()
|
|
59
|
+
.describe(
|
|
60
|
+
"The tunnel to restart. Set on stopped whenever one is recorded, and on unpairable, unreachable and foreign when the recorded tunnel fronted the configured URL.",
|
|
61
|
+
),
|
|
62
|
+
servingAssistantName: z
|
|
63
|
+
.string()
|
|
64
|
+
.optional()
|
|
65
|
+
.describe(
|
|
66
|
+
"Name the edge serves under. Set for foreign when it reports one.",
|
|
67
|
+
),
|
|
68
|
+
detail: z
|
|
69
|
+
.string()
|
|
70
|
+
.optional()
|
|
71
|
+
.describe(
|
|
72
|
+
"Short failure reason, free of the URL. Set for unreachable, and for unpairable when the edge gave one.",
|
|
73
|
+
),
|
|
74
|
+
checkedAt: z
|
|
75
|
+
.string()
|
|
76
|
+
.optional()
|
|
77
|
+
.describe("ISO-8601 instant the probe finished. Set whenever one ran."),
|
|
78
|
+
});
|
|
79
|
+
type IngressStatusResponse = z.infer<typeof IngressStatusResponseSchema>;
|
|
80
|
+
|
|
81
|
+
// ── Handlers ────────────────────────────────────────────────────────────
|
|
82
|
+
|
|
83
|
+
async function handleIngressStatus(): Promise<IngressStatusResponse> {
|
|
84
|
+
const config = getIngressConfigResult();
|
|
85
|
+
if (config.managedCallbacks) {
|
|
86
|
+
return { state: "unconfigured" };
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
// A tunnel published for pairing alone is the address this route reports on:
|
|
90
|
+
// it exists to answer the pairing card, and the `publicBaseUrl` beside it is
|
|
91
|
+
// a webhook callback base that tunnel deliberately left in place. The user
|
|
92
|
+
// owns and restarts that tunnel even where Velay owns the callback ingress.
|
|
93
|
+
const pairingTunnel = loadPairingTunnelRecord();
|
|
94
|
+
// A Velay-managed URL belongs to the gateway, which writes it, clears it,
|
|
95
|
+
// and reconnects on its own, so there is no tunnel for the user to restart.
|
|
96
|
+
// Velay's allowlist (`gateway/src/velay/allowed-paths.ts`) also exposes
|
|
97
|
+
// neither `/healthz` nor the `/assistant/*` pairing surface, so that URL can
|
|
98
|
+
// only ever probe as dead and prefills a page pairing cannot open. Without a
|
|
99
|
+
// pairing tunnel beside it there is no address to report at all.
|
|
100
|
+
if (isVelayManagedIngress() && !pairingTunnel) {
|
|
101
|
+
return { state: "unconfigured" };
|
|
102
|
+
}
|
|
103
|
+
const lastTunnel = pairingTunnel ?? loadLastTunnelRecord();
|
|
104
|
+
|
|
105
|
+
const publicBaseUrl =
|
|
106
|
+
pairingTunnel?.publicBaseUrl ?? config.publicBaseUrl.trim();
|
|
107
|
+
if (!publicBaseUrl && !lastTunnel) {
|
|
108
|
+
return { state: "unconfigured" };
|
|
109
|
+
}
|
|
110
|
+
// `ingress.enabled` governs callback ingress alone, and the URL survives
|
|
111
|
+
// that toggle, so probing a callback base while ingress is opted out would
|
|
112
|
+
// report an address the user switched off as healthy. A pairing tunnel is
|
|
113
|
+
// published outside the toggle, so the opt-out says nothing about it. An
|
|
114
|
+
// unset flag is not an opt-out either: a bring-your-own-HTTPS front sets
|
|
115
|
+
// only the URL.
|
|
116
|
+
if (!publicBaseUrl || (!pairingTunnel && config.explicitlyDisabled)) {
|
|
117
|
+
return { state: "stopped", ...(lastTunnel ? { lastTunnel } : {}) };
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
// A record left over from an address that is no longer configured names a
|
|
121
|
+
// tunnel that never fronted this one, so it is no help in getting back.
|
|
122
|
+
const restartHint =
|
|
123
|
+
lastTunnel &&
|
|
124
|
+
normalizePublicBaseUrl(lastTunnel.publicBaseUrl) ===
|
|
125
|
+
normalizePublicBaseUrl(publicBaseUrl)
|
|
126
|
+
? { lastTunnel }
|
|
127
|
+
: {};
|
|
128
|
+
|
|
129
|
+
// Omitted when unrecorded so the probe skips the identity check entirely
|
|
130
|
+
// rather than reading every served id as a mismatch.
|
|
131
|
+
const expectedAssistantId = loadRecordedAssistantId();
|
|
132
|
+
const result = await probeTunnel({
|
|
133
|
+
publicBaseUrl,
|
|
134
|
+
...(expectedAssistantId ? { expectedAssistantId } : {}),
|
|
135
|
+
});
|
|
136
|
+
const checked = { publicBaseUrl, checkedAt: new Date().toISOString() };
|
|
137
|
+
|
|
138
|
+
switch (result.kind) {
|
|
139
|
+
case "healthy":
|
|
140
|
+
return { state: "healthy", ...checked };
|
|
141
|
+
// One remedy for both: start a tunnel that serves the web app.
|
|
142
|
+
case "unpairable":
|
|
143
|
+
case "unreachable":
|
|
144
|
+
return {
|
|
145
|
+
state: result.kind,
|
|
146
|
+
...checked,
|
|
147
|
+
...restartHint,
|
|
148
|
+
...(result.detail ? { detail: result.detail } : {}),
|
|
149
|
+
};
|
|
150
|
+
case "foreign":
|
|
151
|
+
return {
|
|
152
|
+
state: "foreign",
|
|
153
|
+
...checked,
|
|
154
|
+
...restartHint,
|
|
155
|
+
...(result.assistantName
|
|
156
|
+
? { servingAssistantName: result.assistantName }
|
|
157
|
+
: {}),
|
|
158
|
+
};
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
// ── Route definitions ───────────────────────────────────────────────────
|
|
163
|
+
|
|
164
|
+
export const ROUTES: RouteDefinition[] = [
|
|
165
|
+
{
|
|
166
|
+
operationId: "integrations_ingress_status",
|
|
167
|
+
endpoint: "integrations/ingress/status",
|
|
168
|
+
method: "GET",
|
|
169
|
+
policy: {
|
|
170
|
+
requiredScopes: ["settings.read"],
|
|
171
|
+
allowedPrincipalTypes: ACTOR_PRINCIPALS,
|
|
172
|
+
},
|
|
173
|
+
summary: "Get ingress tunnel status",
|
|
174
|
+
description:
|
|
175
|
+
"Probe the configured public ingress URL and report whether a tunnel is serving this assistant. `unconfigured` means no tunnel has ever been recorded (or the ingress is managed for this assistant, as it is when platform-hosted or fronted by a Velay tunnel), `stopped` means a tunnel ran before and is not running now (callback ingress is explicitly switched off, or its URL is gone), `healthy` means the URL answers and fronts this assistant's web app, `unpairable` means it answers but does not serve that app, so a pairing link minted against it would not open, `unreachable` means it does not answer, and `foreign` means it answers for a different assistant. `lastTunnel` names the tunnel to restart, on the states where a recorded one applies to the configured URL.",
|
|
176
|
+
tags: ["config"],
|
|
177
|
+
handler: handleIngressStatus,
|
|
178
|
+
responseBody: IngressStatusResponseSchema,
|
|
179
|
+
},
|
|
180
|
+
];
|
|
@@ -56,6 +56,7 @@ const sampleEventsSchema = z.object({
|
|
|
56
56
|
const sampleMemoryStatSchema = z.object({
|
|
57
57
|
anonBytes: z.number().nullable(),
|
|
58
58
|
fileBytes: z.number().nullable(),
|
|
59
|
+
inactiveFileBytes: z.number().nullable(),
|
|
59
60
|
kernelBytes: z.number().nullable(),
|
|
60
61
|
slabReclaimableBytes: z.number().nullable(),
|
|
61
62
|
slabUnreclaimableBytes: z.number().nullable(),
|
|
@@ -195,9 +196,16 @@ function readLatestSample(): ResourceSample | null {
|
|
|
195
196
|
}
|
|
196
197
|
// Samples persisted by an older monitor may predate some fields; fill
|
|
197
198
|
// them with null so the response always matches the documented shape.
|
|
199
|
+
// The nested memoryStat needs the same backfill for fields added after
|
|
200
|
+
// a sample was written.
|
|
198
201
|
return {
|
|
199
202
|
...sample,
|
|
200
|
-
memoryStat: sample.memoryStat
|
|
203
|
+
memoryStat: sample.memoryStat
|
|
204
|
+
? {
|
|
205
|
+
...sample.memoryStat,
|
|
206
|
+
inactiveFileBytes: sample.memoryStat.inactiveFileBytes ?? null,
|
|
207
|
+
}
|
|
208
|
+
: null,
|
|
201
209
|
reclaim: sample.reclaim ?? null,
|
|
202
210
|
cpu: sample.cpu ?? null,
|
|
203
211
|
deltas: sample.deltas ?? null,
|
|
@@ -749,7 +749,7 @@ function readBodyData(data: string): unknown {
|
|
|
749
749
|
return tryJsonParse(data);
|
|
750
750
|
}
|
|
751
751
|
|
|
752
|
-
async function handleRequest({ body = {} }: RouteHandlerArgs) {
|
|
752
|
+
export async function handleRequest({ body = {} }: RouteHandlerArgs) {
|
|
753
753
|
const b = body as {
|
|
754
754
|
provider: string;
|
|
755
755
|
url: string;
|
|
@@ -1641,29 +1641,6 @@ function mapTogglePluginError(err: unknown): RouteError {
|
|
|
1641
1641
|
);
|
|
1642
1642
|
}
|
|
1643
1643
|
|
|
1644
|
-
/**
|
|
1645
|
-
* Converge plugin-declared schedules against the sentinel this route just
|
|
1646
|
-
* wrote, so a toggled plugin's rows disarm or re-arm now rather than at the
|
|
1647
|
-
* reconciler's next backstop sweep.
|
|
1648
|
-
*
|
|
1649
|
-
* Fire-and-forget: the toggle itself already succeeded on disk, so a reconcile
|
|
1650
|
-
* failure must not turn it into a route error. Imported lazily, matching the
|
|
1651
|
-
* plugin source reconcile's own hook, to keep the schedule and notification
|
|
1652
|
-
* modules out of this route module's static graph. The scheduler applies the
|
|
1653
|
-
* sentinel at fire time as well, so a slow or failed pass here delays the row
|
|
1654
|
-
* bookkeeping without letting a disabled plugin run.
|
|
1655
|
-
*/
|
|
1656
|
-
function reconcilePluginSchedulesInBackground(): void {
|
|
1657
|
-
void import("../../schedule/plugin-schedule-reconciler.js")
|
|
1658
|
-
.then(({ reconcilePluginSchedules }) => reconcilePluginSchedules())
|
|
1659
|
-
.catch((err: unknown) => {
|
|
1660
|
-
log.error(
|
|
1661
|
-
{ err },
|
|
1662
|
-
"plugin schedule reconcile after a plugin toggle failed",
|
|
1663
|
-
);
|
|
1664
|
-
});
|
|
1665
|
-
}
|
|
1666
|
-
|
|
1667
1644
|
/**
|
|
1668
1645
|
* Toggle a plugin's `.disabled` sentinel through the shared toggle-plugin lib,
|
|
1669
1646
|
* then publish a generic `sync_changed(plugins:list)` so every client refetches
|
|
@@ -1671,26 +1648,45 @@ function reconcilePluginSchedulesInBackground(): void {
|
|
|
1671
1648
|
* names WHICH resource is stale, not the new value. The origin client id is
|
|
1672
1649
|
* threaded through for self-echo suppression.
|
|
1673
1650
|
*/
|
|
1674
|
-
function handleEnablePlugin({
|
|
1651
|
+
async function handleEnablePlugin({
|
|
1652
|
+
pathParams = {},
|
|
1653
|
+
headers,
|
|
1654
|
+
}: RouteHandlerArgs) {
|
|
1675
1655
|
try {
|
|
1676
1656
|
enablePlugin(pathParams.name ?? "");
|
|
1677
|
-
publishPluginsChanged(getOriginClientId(headers));
|
|
1678
|
-
reconcilePluginSchedulesInBackground();
|
|
1679
|
-
return { ok: true };
|
|
1680
1657
|
} catch (err) {
|
|
1681
1658
|
throw mapTogglePluginError(err);
|
|
1682
1659
|
}
|
|
1660
|
+
// A plugin the boot scan skipped for its sentinel has no hooks, tools or
|
|
1661
|
+
// MCP servers in the caches, so clearing the sentinel is not enough to
|
|
1662
|
+
// bring it up. Run the same imperative source reconcile the install and
|
|
1663
|
+
// upgrade routes use, which activates the plugin and then converges its
|
|
1664
|
+
// schedules and MCP servers. Awaited, like the install route, so a client
|
|
1665
|
+
// that lists tools right after enabling sees the plugin up; the reconcile
|
|
1666
|
+
// contains its own failures, so a broken plugin cannot turn a successful
|
|
1667
|
+
// enable into a route error. The invalidation publishes after it for the
|
|
1668
|
+
// same reason: refetching clients should see the post-activation state.
|
|
1669
|
+
await reconcilePluginSourcesNow();
|
|
1670
|
+
publishPluginsChanged(getOriginClientId(headers));
|
|
1671
|
+
return { ok: true };
|
|
1683
1672
|
}
|
|
1684
1673
|
|
|
1685
|
-
function handleDisablePlugin({
|
|
1674
|
+
async function handleDisablePlugin({
|
|
1675
|
+
pathParams = {},
|
|
1676
|
+
headers,
|
|
1677
|
+
}: RouteHandlerArgs) {
|
|
1686
1678
|
try {
|
|
1687
1679
|
disablePlugin(pathParams.name ?? "");
|
|
1688
|
-
publishPluginsChanged(getOriginClientId(headers));
|
|
1689
|
-
reconcilePluginSchedulesInBackground();
|
|
1690
|
-
return { ok: true };
|
|
1691
1680
|
} catch (err) {
|
|
1692
1681
|
throw mapTogglePluginError(err);
|
|
1693
1682
|
}
|
|
1683
|
+
// Same poke enable uses. The sentinel hides tools and hooks at read time,
|
|
1684
|
+
// but a plugin that already ran `init` still owns in-process work (a live
|
|
1685
|
+
// gRPC subscribe, a poll worker). The source reconcile is what runs
|
|
1686
|
+
// `shutdown` and drops that work before this route returns.
|
|
1687
|
+
await reconcilePluginSourcesNow();
|
|
1688
|
+
publishPluginsChanged(getOriginClientId(headers));
|
|
1689
|
+
return { ok: true };
|
|
1694
1690
|
}
|
|
1695
1691
|
|
|
1696
1692
|
// ---------------------------------------------------------------------------
|
|
@@ -2134,7 +2130,7 @@ export const ROUTES: RouteDefinition[] = [
|
|
|
2134
2130
|
},
|
|
2135
2131
|
summary: "Disable a plugin",
|
|
2136
2132
|
description:
|
|
2137
|
-
"Disable a plugin in this workspace by dropping a `.disabled` sentinel, mirroring the CLI's `assistant plugins disable <name>`.
|
|
2133
|
+
"Disable a plugin in this workspace by dropping a `.disabled` sentinel, mirroring the CLI's `assistant plugins disable <name>`. Awaits the same source reconcile enable uses so the plugin's shutdown hook runs. Tools, injectors, and hook gates also honor the sentinel at read time. Broadcasts a `sync_changed` invalidation carrying the `plugins:list` tag so other clients refetch `GET /v1/plugins`. An already-disabled plugin returns 409; a user plugin with no directory returns 404 (default plugins are stubbed on demand via the `default-` prefix); a malformed name returns 400.",
|
|
2138
2134
|
tags: ["plugins"],
|
|
2139
2135
|
pathParams: [
|
|
2140
2136
|
{
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { ResourcePressureStatusResponseSchema } from "../../api/responses/resource-pressure-status.js";
|
|
2
|
+
import { getResourcePressureStatus } from "../../daemon/resource-pressure-guard.js";
|
|
3
|
+
import { ACTOR_PRINCIPALS } from "../auth/route-policy.js";
|
|
4
|
+
import type { RouteDefinition } from "./types.js";
|
|
5
|
+
|
|
6
|
+
export const ROUTES: RouteDefinition[] = [
|
|
7
|
+
{
|
|
8
|
+
operationId: "getResourcePressureStatus",
|
|
9
|
+
endpoint: "resource-pressure/status",
|
|
10
|
+
method: "GET",
|
|
11
|
+
policy: {
|
|
12
|
+
requiredScopes: ["settings.read"],
|
|
13
|
+
allowedPrincipalTypes: ACTOR_PRINCIPALS,
|
|
14
|
+
},
|
|
15
|
+
summary: "Get resource pressure status",
|
|
16
|
+
description:
|
|
17
|
+
"Return the current resource pressure status snapshot. Off-platform the guard does not run, so a disabled status is returned.",
|
|
18
|
+
tags: ["resource-pressure"],
|
|
19
|
+
responseBody: ResourcePressureStatusResponseSchema,
|
|
20
|
+
handler: () => ({ status: getResourcePressureStatus() }),
|
|
21
|
+
},
|
|
22
|
+
];
|
|
@@ -58,7 +58,16 @@ import {
|
|
|
58
58
|
} from "../../tools/credentials/metadata-store.js";
|
|
59
59
|
import { getLogger } from "../../util/logger.js";
|
|
60
60
|
import { ACTOR_PRINCIPALS } from "../auth/route-policy.js";
|
|
61
|
-
import {
|
|
61
|
+
import {
|
|
62
|
+
assertCredentialNotInUse,
|
|
63
|
+
invalidateConnectionsAfterCredentialDelete,
|
|
64
|
+
} from "./credential-in-use.js";
|
|
65
|
+
import {
|
|
66
|
+
BadRequestError,
|
|
67
|
+
InternalError,
|
|
68
|
+
NotFoundError,
|
|
69
|
+
RouteError,
|
|
70
|
+
} from "./errors.js";
|
|
62
71
|
import type { RouteDefinition, RouteHandlerArgs } from "./types.js";
|
|
63
72
|
|
|
64
73
|
const log = getLogger("runtime-http");
|
|
@@ -550,7 +559,11 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
|
|
|
550
559
|
throw new BadRequestError("Request body is required");
|
|
551
560
|
}
|
|
552
561
|
|
|
553
|
-
const { type, name } = body as {
|
|
562
|
+
const { type, name, force } = body as {
|
|
563
|
+
type?: string;
|
|
564
|
+
name?: string;
|
|
565
|
+
force?: boolean;
|
|
566
|
+
};
|
|
554
567
|
|
|
555
568
|
if (!type || typeof type !== "string") {
|
|
556
569
|
throw new BadRequestError("type is required");
|
|
@@ -583,6 +596,13 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
|
|
|
583
596
|
throw new NotFoundError(`API key not found: ${name}`);
|
|
584
597
|
}
|
|
585
598
|
}
|
|
599
|
+
// Provider connections reference the namespaced account, so the in-use
|
|
600
|
+
// check keys off `credKey`: the bare pre-migration account is never a
|
|
601
|
+
// connection's `resolve_auth` target.
|
|
602
|
+
const affectedConnections = assertCredentialNotInUse(
|
|
603
|
+
credKey,
|
|
604
|
+
force === true,
|
|
605
|
+
);
|
|
586
606
|
// Delete from both locations. During a migration overlap both may exist;
|
|
587
607
|
// ignore "not-found" since one location may already be empty.
|
|
588
608
|
const credDeleteResult = await deleteSecureKeyAsync(credKey);
|
|
@@ -598,6 +618,7 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
|
|
|
598
618
|
);
|
|
599
619
|
}
|
|
600
620
|
await refreshProvidersAfterSecretChange();
|
|
621
|
+
invalidateConnectionsAfterCredentialDelete(affectedConnections);
|
|
601
622
|
log.info({ provider: name }, "API key deleted via HTTP");
|
|
602
623
|
return { success: true, type, name };
|
|
603
624
|
}
|
|
@@ -617,6 +638,7 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
|
|
|
617
638
|
if (existing === undefined) {
|
|
618
639
|
throw new NotFoundError(`Credential not found: ${name}`);
|
|
619
640
|
}
|
|
641
|
+
const affectedConnections = assertCredentialNotInUse(key, force === true);
|
|
620
642
|
const deleteResult = await deleteSecureKeyAsync(key);
|
|
621
643
|
if (deleteResult === "error") {
|
|
622
644
|
throw new InternalError(
|
|
@@ -639,6 +661,7 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
|
|
|
639
661
|
if (isManagedProxyCredential(service, field)) {
|
|
640
662
|
await refreshProvidersAfterSecretChange();
|
|
641
663
|
}
|
|
664
|
+
invalidateConnectionsAfterCredentialDelete(affectedConnections);
|
|
642
665
|
log.info({ service, field }, "Credential deleted via HTTP");
|
|
643
666
|
return { success: true, type, name };
|
|
644
667
|
}
|
|
@@ -647,11 +670,10 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
|
|
|
647
670
|
`Unknown secret type: ${type}. Valid types: api_key, credential`,
|
|
648
671
|
);
|
|
649
672
|
} catch (err) {
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
) {
|
|
673
|
+
// Every RouteError is already a deliberate client-facing outcome (including
|
|
674
|
+
// CREDENTIAL_IN_USE); re-wrapping one as a 500 would hide its code, status,
|
|
675
|
+
// and details from the caller.
|
|
676
|
+
if (err instanceof RouteError) {
|
|
655
677
|
throw err;
|
|
656
678
|
}
|
|
657
679
|
const message = err instanceof Error ? err.message : String(err);
|
|
@@ -793,11 +815,20 @@ export const ROUTES: RouteDefinition[] = [
|
|
|
793
815
|
allowedPrincipalTypes: ACTOR_PRINCIPALS,
|
|
794
816
|
},
|
|
795
817
|
summary: "Delete a secret",
|
|
796
|
-
description:
|
|
818
|
+
description:
|
|
819
|
+
"Remove a secret from the credential vault by name. Refused with " +
|
|
820
|
+
"CREDENTIAL_IN_USE while an LLM provider connection resolves its auth " +
|
|
821
|
+
"through the credential, unless `force` is set.",
|
|
797
822
|
tags: ["secrets"],
|
|
798
823
|
requestBody: z.object({
|
|
799
824
|
type: z.string().describe("Secret type: 'api_key' or 'credential'"),
|
|
800
825
|
name: z.string().describe("Name of the secret to delete"),
|
|
826
|
+
force: z
|
|
827
|
+
.boolean()
|
|
828
|
+
.optional()
|
|
829
|
+
.describe(
|
|
830
|
+
"Delete even when provider connections depend on the credential",
|
|
831
|
+
),
|
|
801
832
|
}),
|
|
802
833
|
responseBody: z.object({
|
|
803
834
|
success: z.boolean(),
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
import { readFileSync } from "node:fs";
|
|
7
7
|
import { basename, join } from "node:path";
|
|
8
8
|
|
|
9
|
+
import { normalizePublicBaseUrl } from "@vellumai/service-contracts/ingress";
|
|
9
10
|
import { z } from "zod";
|
|
10
11
|
|
|
11
12
|
import { setImage } from "../../avatar/avatar-store.js";
|
|
@@ -24,6 +25,7 @@ import {
|
|
|
24
25
|
} from "../../daemon/conversation-tool-setup.js";
|
|
25
26
|
import {
|
|
26
27
|
computeGatewayTarget,
|
|
28
|
+
dropTunnelRecordsForNewUrl,
|
|
27
29
|
getIngressConfigResult,
|
|
28
30
|
} from "../../daemon/handlers/config-ingress.js";
|
|
29
31
|
import { normalizeActivationKey } from "../../daemon/handlers/config-voice.js";
|
|
@@ -37,7 +39,6 @@ import {
|
|
|
37
39
|
import {
|
|
38
40
|
check,
|
|
39
41
|
classifyRisk,
|
|
40
|
-
generateAllowlistOptions,
|
|
41
42
|
generateScopeOptions,
|
|
42
43
|
} from "../../permissions/checker.js";
|
|
43
44
|
import { resolveGuardianPersonaPath } from "../../prompts/persona-resolver.js";
|
|
@@ -710,19 +711,22 @@ async function handleToolPermissionSimulate({ body = {} }: RouteHandlerArgs) {
|
|
|
710
711
|
isInteractive === false ? "headless" : "conversation";
|
|
711
712
|
const policyContext = { executionTarget, executionContext } as const;
|
|
712
713
|
|
|
713
|
-
const
|
|
714
|
+
const classification = await classifyRisk(
|
|
714
715
|
toolName,
|
|
715
716
|
input,
|
|
716
717
|
workingDir,
|
|
717
718
|
undefined,
|
|
718
719
|
manifestOverride,
|
|
719
720
|
);
|
|
721
|
+
const riskLevel = classification.level;
|
|
720
722
|
const result = await check(
|
|
721
723
|
toolName,
|
|
722
724
|
input,
|
|
723
725
|
workingDir,
|
|
724
726
|
policyContext,
|
|
725
727
|
manifestOverride,
|
|
728
|
+
undefined,
|
|
729
|
+
classification,
|
|
726
730
|
);
|
|
727
731
|
|
|
728
732
|
if (isInteractive === false && result.decision === "prompt") {
|
|
@@ -743,11 +747,9 @@ async function handleToolPermissionSimulate({ body = {} }: RouteHandlerArgs) {
|
|
|
743
747
|
| undefined;
|
|
744
748
|
|
|
745
749
|
if (result.decision === "prompt") {
|
|
746
|
-
const allowlistOptions = await generateAllowlistOptions(toolName, input);
|
|
747
|
-
const scopeOptions = generateScopeOptions(workingDir, toolName);
|
|
748
750
|
promptPayload = {
|
|
749
|
-
allowlistOptions,
|
|
750
|
-
scopeOptions,
|
|
751
|
+
allowlistOptions: classification.allowlistOptions ?? [],
|
|
752
|
+
scopeOptions: generateScopeOptions(workingDir, toolName),
|
|
751
753
|
persistentDecisionsAllowed: true,
|
|
752
754
|
};
|
|
753
755
|
}
|
|
@@ -837,12 +839,12 @@ function handleGetPlatformConfig() {
|
|
|
837
839
|
function handleUpdatePlatformConfig({ body = {} }: RouteHandlerArgs) {
|
|
838
840
|
try {
|
|
839
841
|
const { baseUrl: rawBaseUrl } = body as { baseUrl?: string };
|
|
840
|
-
const value = (rawBaseUrl
|
|
842
|
+
const value = normalizePublicBaseUrl(rawBaseUrl);
|
|
841
843
|
const raw = loadRawConfig();
|
|
842
844
|
const platform = (raw?.platform ?? {}) as Record<string, unknown>;
|
|
843
|
-
platform.baseUrl = value
|
|
845
|
+
platform.baseUrl = value;
|
|
844
846
|
saveRawConfig({ ...raw, platform });
|
|
845
|
-
return { baseUrl: value, success: true };
|
|
847
|
+
return { baseUrl: value ?? "", success: true };
|
|
846
848
|
} catch (err) {
|
|
847
849
|
const message = err instanceof Error ? err.message : String(err);
|
|
848
850
|
log.error({ err }, "Failed to update platform config");
|
|
@@ -860,10 +862,11 @@ function handleUpdateIngressConfig({ body = {} }: RouteHandlerArgs) {
|
|
|
860
862
|
publicBaseUrl?: string;
|
|
861
863
|
enabled?: boolean;
|
|
862
864
|
};
|
|
863
|
-
const value = (rawUrl
|
|
865
|
+
const value = normalizePublicBaseUrl(rawUrl);
|
|
864
866
|
const raw = loadRawConfig();
|
|
865
867
|
const ingress = (raw?.ingress ?? {}) as Record<string, unknown>;
|
|
866
|
-
ingress
|
|
868
|
+
dropTunnelRecordsForNewUrl(ingress, value);
|
|
869
|
+
ingress.publicBaseUrl = value;
|
|
867
870
|
if (enabled !== undefined) {
|
|
868
871
|
ingress.enabled = enabled;
|
|
869
872
|
}
|
|
@@ -878,7 +881,7 @@ function handleUpdateIngressConfig({ body = {} }: RouteHandlerArgs) {
|
|
|
878
881
|
|
|
879
882
|
return {
|
|
880
883
|
enabled: isEnabled,
|
|
881
|
-
publicBaseUrl: value,
|
|
884
|
+
publicBaseUrl: value ?? "",
|
|
882
885
|
localGatewayTarget: computeGatewayTarget(),
|
|
883
886
|
success: true,
|
|
884
887
|
};
|
|
@@ -37,26 +37,25 @@ const log = getLogger("surface-action-routes");
|
|
|
37
37
|
|
|
38
38
|
/**
|
|
39
39
|
* Resolve trust context for the actor principal from the gateway guardian
|
|
40
|
-
* binding and
|
|
41
|
-
* nobody, so the mapper yields guardian or
|
|
42
|
-
* dev-bypass principal translation and the
|
|
43
|
-
*
|
|
44
|
-
*
|
|
40
|
+
* binding, and return it for the caller to attribute this action with. A vellum
|
|
41
|
+
* principal is the guardian or nobody, so the mapper yields guardian or
|
|
42
|
+
* unknown. Resolution (including the dev-bypass principal translation and the
|
|
43
|
+
* mutating reset-drift repair) lives in the shared
|
|
44
|
+
* {@link resolveVellumActorTrustContext} so the surface content route's
|
|
45
|
+
* read-only requester scoping cannot drift from it.
|
|
46
|
+
*
|
|
47
|
+
* Resolution only: the requester travels to `handleSurfaceAction` as an
|
|
48
|
+
* argument, and the conversation's slot is stamped there, at the point the
|
|
49
|
+
* click is committed to starting a turn. Stamping here instead would repoint
|
|
50
|
+
* the actor of a turn already in flight, or of a turn that starts between this
|
|
51
|
+
* call and the dispatch.
|
|
45
52
|
*/
|
|
46
|
-
async function
|
|
47
|
-
conversation: {
|
|
48
|
-
setTrustContext?(ctx: TrustContext): void;
|
|
49
|
-
},
|
|
53
|
+
async function resolveRequesterTrustContext(
|
|
50
54
|
actorPrincipalId: string | undefined,
|
|
51
|
-
): Promise<
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
}
|
|
55
|
-
conversation.setTrustContext(
|
|
56
|
-
await resolveVellumActorTrustContext(actorPrincipalId, {
|
|
57
|
-
healResetDrift: true,
|
|
58
|
-
}),
|
|
59
|
-
);
|
|
55
|
+
): Promise<TrustContext> {
|
|
56
|
+
return resolveVellumActorTrustContext(actorPrincipalId, {
|
|
57
|
+
healResetDrift: true,
|
|
58
|
+
});
|
|
60
59
|
}
|
|
61
60
|
|
|
62
61
|
// ---------------------------------------------------------------------------
|
|
@@ -154,7 +153,8 @@ async function handleSurfaceAction({
|
|
|
154
153
|
}
|
|
155
154
|
|
|
156
155
|
const actorPrincipalId = headers?.["x-vellum-actor-principal-id"];
|
|
157
|
-
|
|
156
|
+
const requesterTrustContext =
|
|
157
|
+
await resolveRequesterTrustContext(actorPrincipalId);
|
|
158
158
|
|
|
159
159
|
// Translate dev-bypass → real guardian so the surface turn's principal matches
|
|
160
160
|
// the SSE host-proxy client's registered principal; otherwise CU/app-control
|
|
@@ -170,6 +170,7 @@ async function handleSurfaceAction({
|
|
|
170
170
|
actionId,
|
|
171
171
|
data,
|
|
172
172
|
resolvedActorPrincipalId,
|
|
173
|
+
requesterTrustContext,
|
|
173
174
|
);
|
|
174
175
|
const result =
|
|
175
176
|
raw && typeof raw === "object" && "accepted" in raw
|
|
@@ -37,6 +37,7 @@
|
|
|
37
37
|
|
|
38
38
|
import { statSync } from "node:fs";
|
|
39
39
|
|
|
40
|
+
import { runInPluginContext } from "../../plugins/plugin-execution-context.js";
|
|
40
41
|
import { isRouteHostEnabled } from "../../routes/control.js";
|
|
41
42
|
import {
|
|
42
43
|
RouteHostClient,
|
|
@@ -55,6 +56,7 @@ import {
|
|
|
55
56
|
routeSourceRoot,
|
|
56
57
|
} from "./user-route-import.js";
|
|
57
58
|
import {
|
|
59
|
+
pluginNameForRoutePath,
|
|
58
60
|
resolveHandlerFile,
|
|
59
61
|
resolveRouteLocation,
|
|
60
62
|
} from "./user-route-resolution.js";
|
|
@@ -150,11 +152,36 @@ export class UserRouteDispatcher {
|
|
|
150
152
|
);
|
|
151
153
|
}
|
|
152
154
|
|
|
155
|
+
// A plugin's own routes execute as that plugin, so the host APIs a handler
|
|
156
|
+
// reaches scope to it exactly as they do inside its hooks and tools. Both
|
|
157
|
+
// execution paths carry it: in-thread here, and the route host through the
|
|
158
|
+
// invoke params it marks its own execution with.
|
|
159
|
+
const pluginName = pluginNameForRoutePath(routePath);
|
|
160
|
+
|
|
153
161
|
if (isRouteHostEnabled()) {
|
|
154
|
-
return this.dispatchViaHost(filePath, routePath, request);
|
|
162
|
+
return this.dispatchViaHost(filePath, routePath, request, pluginName);
|
|
155
163
|
}
|
|
156
164
|
|
|
157
|
-
|
|
165
|
+
// The context covers module evaluation, not just the handler call. A route
|
|
166
|
+
// module can reach a scoped host API at import time (a top-level `await`),
|
|
167
|
+
// and that import happens once per mtime, so a load left outside the
|
|
168
|
+
// context would take the unscoped branch and never be re-run scoped.
|
|
169
|
+
const serve = () =>
|
|
170
|
+
this.serveInThread(filePath, location.routesDir, routePath, request);
|
|
171
|
+
return pluginName ? runInPluginContext(pluginName, serve) : serve();
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* Load the handler module and run the method's handler in this thread.
|
|
176
|
+
* Called inside the owning plugin's execution context, when the route has one.
|
|
177
|
+
*/
|
|
178
|
+
private async serveInThread(
|
|
179
|
+
filePath: string,
|
|
180
|
+
routesDir: string,
|
|
181
|
+
routePath: string,
|
|
182
|
+
request: Request,
|
|
183
|
+
): Promise<Response> {
|
|
184
|
+
const mod = await this.loadModule(filePath, routesDir);
|
|
158
185
|
const method = request.method as HttpMethod;
|
|
159
186
|
const handler = mod.handlers[method];
|
|
160
187
|
|
|
@@ -180,6 +207,7 @@ export class UserRouteDispatcher {
|
|
|
180
207
|
filePath: string,
|
|
181
208
|
routePath: string,
|
|
182
209
|
request: Request,
|
|
210
|
+
pluginName: string | undefined,
|
|
183
211
|
): Promise<Response> {
|
|
184
212
|
const mtimeMs = statSync(filePath).mtimeMs;
|
|
185
213
|
|
|
@@ -201,6 +229,7 @@ export class UserRouteDispatcher {
|
|
|
201
229
|
method: request.method,
|
|
202
230
|
url: request.url,
|
|
203
231
|
headers,
|
|
232
|
+
pluginName,
|
|
204
233
|
},
|
|
205
234
|
body,
|
|
206
235
|
);
|