@vellumai/assistant 0.12.1 → 0.12.2-dev.202609162214.308bda0
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/.env.example +2 -0
- package/AGENTS.md +5 -1
- package/ARCHITECTURE.md +20 -21
- package/Dockerfile +7 -7
- package/docs/architecture/integrations.md +7 -0
- package/docs/architecture/memory.md +11 -2
- package/docs/architecture/turn-actor.md +15 -8
- package/docs/credential-execution-service.md +1 -1
- package/docs/desktop-browser-cli.md +35 -0
- package/docs/guardian-request-flow.md +16 -0
- package/node_modules/@vellumai/environments/src/shell.test.ts +21 -0
- package/node_modules/@vellumai/environments/src/shell.ts +24 -0
- package/node_modules/@vellumai/gateway-client/src/inbound-contract.ts +8 -2
- package/node_modules/@vellumai/slack-text/src/index.ts +13 -8
- package/node_modules/@vellumai/slack-text/src/label-resolution-entities.test.ts +95 -0
- package/openapi.yaml +564 -111
- package/package.json +7 -4
- package/scripts/bundled-plugin-packages.ts +154 -0
- package/scripts/generate-bundled-plugin-packages.ts +29 -0
- package/scripts/postinstall.ts +33 -0
- package/scripts/smoke-desktop-browser-cli.ts +280 -0
- package/scripts/smoke-desktop-window-theme.ts +186 -0
- package/scripts/sync-llm-catalog.ts +3 -0
- package/scripts/test.ts +15 -13
- package/scripts/voice-ttft-spike.ts +2 -2
- package/src/__tests__/agent-loop.test.ts +124 -0
- package/src/__tests__/always-loaded-tools-guard.test.ts +18 -10
- package/src/__tests__/anthropic-provider.test.ts +0 -63
- package/src/__tests__/app-compiler.test.ts +6 -0
- package/src/__tests__/app-control-tool-schemas.test.ts +5 -2
- package/src/__tests__/app-dir-path-guard.test.ts +1 -3
- package/src/__tests__/approval-interception-trust-gates.test.ts +40 -0
- package/src/__tests__/assistant-event-hub-machine-name.test.ts +6 -7
- package/src/__tests__/assistant-event-hub.test.ts +44 -0
- package/src/__tests__/attachments-store.test.ts +22 -3
- package/src/__tests__/channel-approval.test.ts +9 -14
- package/src/__tests__/channel-reply-delivery.test.ts +56 -0
- package/src/__tests__/computer-use-screenshot-attachments.test.ts +411 -0
- package/src/__tests__/computer-use-screenshot-selection.test.ts +50 -0
- package/src/__tests__/computer-use-skill-manifest-regression.test.ts +1 -1
- package/src/__tests__/computer-use-skill-proxy-bridge.test.ts +5 -2
- package/src/__tests__/computer-use-tools.test.ts +19 -7
- package/src/__tests__/config-schema-cmd.test.ts +2 -2
- package/src/__tests__/config-schema.test.ts +29 -30
- package/src/__tests__/config-sounds-sync.test.ts +23 -0
- package/src/__tests__/config-watcher.test.ts +23 -8
- package/src/__tests__/connection-model-compat.test.ts +2 -2
- 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 +257 -6
- package/src/__tests__/conversation-attachments.test.ts +106 -0
- package/src/__tests__/conversation-error.test.ts +4 -1
- package/src/__tests__/conversation-fork-crud.test.ts +191 -0
- package/src/__tests__/conversation-key-store-disk-view.test.ts +1 -1
- package/src/__tests__/conversation-pairing.test.ts +26 -0
- package/src/__tests__/conversation-process-app-control-preactivation.test.ts +4 -10
- package/src/__tests__/conversation-queue.test.ts +48 -207
- package/src/__tests__/conversation-retry-discard.test.ts +54 -1
- package/src/__tests__/conversation-runtime-assembly.test.ts +33 -3
- package/src/__tests__/conversation-skill-tools.test.ts +27 -0
- package/src/__tests__/conversation-surfaces-app-control.test.ts +8 -3
- package/src/__tests__/conversation-surfaces-point-at-budget.test.ts +1 -0
- package/src/__tests__/conversation-surfaces-point-at-capability.test.ts +1 -0
- package/src/__tests__/conversation-surfaces-task-progress.test.ts +67 -0
- package/src/__tests__/conversation-title-service.test.ts +14 -10
- package/src/__tests__/conversation-tool-setup-app-refresh.test.ts +3 -5
- package/src/__tests__/conversation-tool-setup-attribution.test.ts +51 -0
- package/src/__tests__/credential-execution-client.test.ts +70 -53
- package/src/__tests__/credential-record-retire.test.ts +171 -1
- package/src/__tests__/credential-routes.test.ts +250 -3
- package/src/__tests__/credential-security-invariants.test.ts +5 -3
- package/src/__tests__/cu-unified-flow.test.ts +14 -4
- package/src/__tests__/db-conversation-tool-surface.test.ts +144 -0
- package/src/__tests__/document-sync-tags.test.ts +25 -0
- package/src/__tests__/drain-kick-guard.test.ts +0 -2
- package/src/__tests__/drain-requeue-on-contention.test.ts +0 -6
- package/src/__tests__/events-tail-route.test.ts +33 -0
- package/src/__tests__/evict-conversations-for-reload.test.ts +1 -1
- package/src/__tests__/external-plugin-loader.test.ts +52 -0
- package/src/__tests__/git-porcelain.test.ts +47 -0
- package/src/__tests__/headless-browser-mode.test.ts +48 -0
- package/src/__tests__/heartbeat-service.test.ts +56 -40
- package/src/__tests__/helpers/set-workspace-mcp.ts +11 -0
- package/src/__tests__/host-bash-proxy.test.ts +26 -45
- package/src/__tests__/host-browser-proxy.test.ts +6 -17
- package/src/__tests__/host-cu-proxy.test.ts +712 -18
- package/src/__tests__/host-file-proxy-targeted.test.ts +23 -0
- package/src/__tests__/host-file-proxy.test.ts +11 -23
- package/src/__tests__/host-transfer-proxy-targeted.test.ts +30 -9
- package/src/__tests__/inference-profile-session-handler.test.ts +26 -0
- package/src/__tests__/list-all-apps.test.ts +40 -8
- package/src/__tests__/list-messages-camera-frame.test.ts +121 -0
- package/src/__tests__/list-messages-tool-merge.test.ts +85 -1
- package/src/__tests__/llm-catalog-parity.test.ts +51 -3
- package/src/__tests__/managed-store.test.ts +121 -0
- package/src/__tests__/mcp-auth-routes.test.ts +104 -8
- package/src/__tests__/mcp-client-auth.test.ts +54 -0
- package/src/__tests__/mcp-config-secret-boundary.test.ts +78 -136
- package/src/__tests__/mcp-health-check.test.ts +40 -43
- package/src/__tests__/mcp-list-plugin-servers.test.ts +85 -42
- package/src/__tests__/mcp-tool-annotations-risk.test.ts +4 -2
- package/src/__tests__/message-deleted-hook-dispatch.test.ts +119 -0
- package/src/__tests__/messages-after-tiebreaker.test.ts +91 -0
- package/src/__tests__/messages-read-boundary-guard.test.ts +1 -1
- package/src/__tests__/messaging-send-tool.test.ts +355 -548
- package/src/__tests__/model-intents.test.ts +3 -0
- package/src/__tests__/notification-vellum-adapter.test.ts +85 -2
- package/src/__tests__/oauth-apps-routes.test.ts +1 -0
- package/src/__tests__/oauth-commands-routes.test.ts +282 -101
- package/src/__tests__/oauth-connect-orchestrator.test.ts +2 -0
- package/src/__tests__/oauth-provider-profiles.test.ts +18 -0
- package/src/__tests__/oauth-provider-serializer.test.ts +23 -0
- package/src/__tests__/oauth-providers-routes.test.ts +3 -0
- package/src/__tests__/openai-provider.test.ts +1 -0
- package/src/__tests__/outlook-messaging-provider.test.ts +6 -6
- package/src/__tests__/persist-media-references.test.ts +50 -0
- package/src/__tests__/platform-callback-registration.test.ts +8 -16
- package/src/__tests__/platform-client-verify-credential.test.ts +2 -0
- package/src/__tests__/plugin-import-boundary-guard.test.ts +13 -0
- package/src/__tests__/qdrant-manager.test.ts +132 -0
- package/src/__tests__/resolve-app.test.ts +135 -0
- package/src/__tests__/run-conversation-turn-persistence.test.ts +138 -1
- package/src/__tests__/scaffold-managed-skill-tool.test.ts +317 -6
- package/src/__tests__/schedule-routes.test.ts +20 -0
- package/src/__tests__/scheduler-result-notification.test.ts +23 -4
- package/src/__tests__/script-proxy-certs.test.ts +35 -0
- package/src/__tests__/secret-routes-acp-guard.test.ts +59 -1
- package/src/__tests__/secret-routes-platform-proxy.test.ts +86 -31
- package/src/__tests__/secret-routes-scrub.test.ts +22 -27
- package/src/__tests__/secure-keys-managed-failover.test.ts +8 -0
- package/src/__tests__/secure-keys.test.ts +7 -3
- package/src/__tests__/service-account-token.test.ts +247 -0
- package/src/__tests__/skill-feature-flags-integration.test.ts +1 -1
- package/src/__tests__/skill-feature-flags.test.ts +2 -2
- package/src/__tests__/skills.test.ts +20 -4
- package/src/__tests__/source-fingerprint.test.ts +184 -0
- package/src/__tests__/subagent-tool-gate-mode.test.ts +239 -3
- package/src/__tests__/subagent-tools.test.ts +3 -2
- package/src/__tests__/telephony-tts-guard.test.ts +38 -3
- package/src/__tests__/terminal-tools.test.ts +8 -0
- package/src/__tests__/test-support/computer-use-skill-harness.ts +3 -2
- package/src/__tests__/tool-result-metadata-plumbing.test.ts +63 -0
- package/src/__tests__/ui-channel-variants.test.ts +1 -56
- package/src/__tests__/unicode.test.ts +49 -0
- package/src/__tests__/user-plugin-loader.test.ts +21 -0
- package/src/__tests__/vellum-self-knowledge-inline-command.test.ts +4 -0
- package/src/__tests__/watch-retro-tool-availability.test.ts +8 -17
- package/src/__tests__/workspace-git-service.test.ts +26 -0
- package/src/__tests__/workspace-migration-154-repair-retired-codex-gpt-5-4-model-ids.test.ts +336 -0
- package/src/acp/__tests__/acp-claude-oauth.test.ts +257 -6
- package/src/acp/__tests__/acp-credentials.test.ts +13 -0
- package/src/acp/__tests__/agent-process.test.ts +258 -4
- package/src/acp/__tests__/auth-required.test.ts +96 -0
- package/src/acp/__tests__/claude-token-refresh.test.ts +257 -0
- package/src/acp/__tests__/client-handler.test.ts +90 -2
- package/src/acp/__tests__/helpers/acp-model-option.ts +51 -0
- package/src/acp/__tests__/prepare-agent-env.test.ts +60 -1
- package/src/acp/__tests__/session-manager-persistence.test.ts +5 -1
- package/src/acp/__tests__/session-manager-resume.test.ts +270 -6
- package/src/acp/__tests__/session-manager-usage.test.ts +4 -2
- package/src/acp/__tests__/session-manager.test.ts +895 -4
- package/src/acp/acp-claude-oauth.ts +328 -14
- package/src/acp/acp-credentials.ts +19 -0
- package/src/acp/agent-process.test.ts +4 -1
- package/src/acp/agent-process.ts +96 -10
- package/src/acp/auth-required.ts +50 -1
- package/src/acp/auto-install.test.ts +9 -7
- package/src/acp/claude-token-refresh.ts +150 -0
- package/src/acp/client-handler.ts +16 -3
- package/src/acp/model-config.test.ts +166 -0
- package/src/acp/model-config.ts +138 -0
- package/src/acp/prepare-agent-env.ts +21 -6
- package/src/acp/resolve-agent.test.ts +220 -6
- package/src/acp/resolve-agent.ts +88 -23
- package/src/acp/session-manager.test.ts +196 -3
- package/src/acp/session-manager.ts +441 -18
- package/src/acp/session-snapshot.ts +260 -0
- package/src/acp/types.ts +50 -5
- package/src/agent/loop.ts +20 -0
- package/src/api/attachment-provenance.test.ts +68 -0
- package/src/api/computer-use-tool.test.ts +55 -0
- package/src/api/computer-use-tool.ts +27 -0
- package/src/api/events/acp-session-model-update.test.ts +88 -0
- package/src/api/events/acp-session-model-update.ts +46 -0
- package/src/api/events/app-files-changed.ts +4 -3
- package/src/api/events/assistant-outbound-attachment.ts +3 -0
- package/src/api/events/desktop-activity-changed.ts +10 -0
- package/src/api/events/notification-intent.ts +2 -0
- package/src/api/events/user-message-echo.ts +7 -1
- package/src/api/index.ts +17 -0
- package/src/api/responses/conversation-message.ts +8 -0
- package/src/approvals/approval-primitive.ts +5 -2
- package/src/approvals/scoped-approval-grants.ts +6 -2
- package/src/apps/app-store.ts +7 -6
- package/src/apps/resolve-app.ts +81 -0
- package/src/apps/source-fingerprint.ts +266 -0
- package/src/avatar/identity-avatar.ts +7 -2
- package/src/browser/operations.ts +2 -1
- package/src/browser/types.ts +7 -0
- package/src/browser/virtual-desktop-target.ts +34 -0
- package/src/bundler/app-compiler.ts +15 -0
- package/src/calls/__tests__/barge-in-guard.test.ts +81 -0
- package/src/{__tests__ → calls/__tests__}/call-controller.test.ts +503 -82
- package/src/{__tests__ → calls/__tests__}/media-stream-audio-transcode.test.ts +1 -1
- package/src/{__tests__ → calls/__tests__}/media-stream-output.test.ts +37 -8
- package/src/{__tests__ → calls/__tests__}/media-stream-parser.test.ts +1 -1
- package/src/{__tests__ → calls/__tests__}/media-stream-server-integration.test.ts +150 -57
- package/src/{__tests__ → calls/__tests__}/media-stream-stt-session.test.ts +5 -5
- package/src/{__tests__ → calls/__tests__}/media-turn-detector.test.ts +1 -1
- package/src/{live-voice → calls}/__tests__/progress-narration.test.ts +27 -4
- package/src/{live-voice → calls}/__tests__/progress-phrases.test.ts +1 -1
- package/src/calls/__tests__/voice-control-protocol.test.ts +151 -27
- package/src/calls/__tests__/voice-leg-coordinator.test.ts +229 -0
- package/src/calls/__tests__/voice-progress-cadence.test.ts +274 -0
- package/src/{__tests__/voice-session-bridge.test.ts → calls/__tests__/voice-session-bridge-turn-flow.test.ts} +20 -12
- package/src/calls/__tests__/voice-session-bridge.test.ts +140 -3
- package/src/calls/__tests__/voice-triage-escalate.test.ts +105 -0
- package/src/calls/barge-in-guard.ts +118 -0
- package/src/calls/call-constants.ts +24 -4
- package/src/calls/call-controller.ts +499 -199
- package/src/calls/call-transport.ts +16 -0
- package/src/calls/media-stream-output.ts +32 -0
- package/src/calls/media-stream-server.ts +82 -30
- package/src/calls/media-stream-stt-session.ts +15 -0
- package/src/{live-voice → calls}/progress-narration.ts +17 -4
- package/src/calls/resolve-call-tts-provider.ts +33 -2
- package/src/calls/tts-call-strategy.ts +9 -5
- package/src/calls/types.ts +2 -0
- package/src/calls/voice-control-protocol.ts +194 -21
- package/src/calls/voice-leg-coordinator.ts +189 -0
- package/src/calls/voice-progress-cadence.ts +423 -0
- package/src/calls/voice-session-bridge.ts +140 -76
- package/src/calls/voice-triage-escalate.ts +178 -59
- package/src/cli/commands/__tests__/apps.test.ts +245 -0
- package/src/cli/commands/__tests__/bash.test.ts +53 -0
- package/src/cli/commands/__tests__/browser.test.ts +84 -3
- package/src/cli/commands/__tests__/cli-test-harness.ts +21 -3
- package/src/cli/commands/__tests__/plugins.test.ts +85 -0
- package/src/cli/commands/__tests__/roadmap.help.test.ts +19 -0
- package/src/cli/commands/__tests__/schedules.test.ts +14 -0
- package/src/cli/commands/apps.help.ts +67 -13
- package/src/cli/commands/apps.ts +183 -0
- package/src/cli/commands/bash.help.ts +9 -13
- package/src/cli/commands/bash.ts +7 -25
- package/src/cli/commands/browser.help.ts +43 -0
- package/src/cli/commands/browser.ts +52 -8
- package/src/cli/commands/channels/__tests__/send.test.ts +218 -0
- package/src/cli/commands/channels/index.help.ts +70 -2
- package/src/cli/commands/channels/index.ts +16 -3
- package/src/cli/commands/channels/send.ts +128 -0
- package/src/cli/commands/credentials.help.ts +9 -5
- package/src/cli/commands/credentials.ts +2 -2
- package/src/cli/commands/mcp.help.ts +8 -8
- package/src/cli/commands/mcp.ts +1 -1
- package/src/cli/commands/oauth/index.help.ts +10 -0
- package/src/cli/commands/oauth/providers.ts +12 -0
- package/src/cli/commands/oauth/request.test.ts +179 -2
- package/src/cli/commands/oauth/request.ts +41 -10
- package/src/cli/commands/oauth/status.ts +5 -0
- package/src/cli/commands/plugins.ts +73 -23
- package/src/cli/commands/roadmap.help.ts +5 -1
- package/src/cli/commands/roadmap.ts +1 -1
- package/src/cli/commands/schedules.ts +2 -0
- package/src/cli/lib/__tests__/inspect-plugin.test.ts +54 -0
- package/src/cli/lib/__tests__/install-from-github.test.ts +219 -0
- package/src/cli/lib/__tests__/install-from-platform.test.ts +77 -2
- package/src/cli/lib/__tests__/list-installed-plugins.test.ts +45 -3
- package/src/cli/lib/__tests__/local-plugin-upgrade.test.ts +251 -0
- package/src/cli/lib/__tests__/plugin-catalog-cache.test.ts +65 -2
- package/src/cli/lib/__tests__/plugin-catalog-platform.test.ts +14 -0
- package/src/cli/lib/__tests__/plugin-catalog-resolve.test.ts +27 -1
- package/src/cli/lib/__tests__/plugin-details.test.ts +35 -2
- package/src/cli/lib/__tests__/plugin-marketplace.test.ts +20 -0
- package/src/cli/lib/__tests__/plugins-install-offline.test.ts +43 -0
- package/src/cli/lib/__tests__/search-plugins.test.ts +31 -0
- package/src/cli/lib/__tests__/uninstall-plugin.test.ts +122 -5
- package/src/cli/lib/bundled-marketplace.json +962 -81
- package/src/cli/lib/bundled-plugin-packages.json +786 -0
- package/src/cli/lib/bundled-plugin-packages.ts +87 -0
- package/src/cli/lib/diff-plugin.ts +1 -1
- package/src/cli/lib/inspect-plugin.ts +87 -12
- package/src/cli/lib/install-from-github.ts +150 -94
- package/src/cli/lib/install-from-platform.ts +14 -9
- package/src/cli/lib/list-installed-plugins.ts +21 -35
- package/src/cli/lib/plugin-catalog-cache.ts +22 -3
- package/src/cli/lib/plugin-catalog-local.ts +13 -3
- package/src/cli/lib/plugin-catalog-platform.ts +6 -1
- package/src/cli/lib/plugin-catalog-resolve.ts +20 -0
- package/src/cli/lib/plugin-details.ts +33 -8
- package/src/cli/lib/plugin-marketplace.ts +121 -21
- package/src/cli/lib/plugin-pin-history.ts +5 -2
- package/src/cli/lib/search-plugins.ts +58 -16
- package/src/cli/lib/uninstall-plugin.ts +59 -1
- package/src/cli/lib/upgrade-plugin.ts +61 -8
- package/src/cli/output.ts +18 -4
- package/src/config/__tests__/default-profile-catalog.test.ts +22 -0
- package/src/config/__tests__/default-provider.test.ts +4 -0
- package/src/config/__tests__/memory-retrospective-schema.test.ts +15 -1
- package/src/config/__tests__/platform-identity.test.ts +255 -0
- package/src/config/__tests__/platform-rehydration.test.ts +99 -9
- package/src/config/__tests__/plugin-resident-skill-discovery.test.ts +21 -0
- package/src/config/acp-agent-write.ts +43 -0
- package/src/config/acp-defaults.test.ts +13 -3
- package/src/config/acp-defaults.ts +23 -6
- package/src/config/acp-schema.test.ts +81 -0
- package/src/config/acp-schema.ts +30 -2
- package/src/config/bundled-skills/acp/SKILL.md +23 -15
- package/src/config/bundled-skills/acp/TOOLS.json +7 -3
- package/src/config/bundled-skills/app-builder/SKILL.md +12 -9
- package/src/config/bundled-skills/app-builder/references/CUSTOM_ROUTES.md +1 -1
- package/src/config/bundled-skills/computer-use/SKILL.md +59 -2
- package/src/config/bundled-skills/computer-use/TOOLS.json +101 -2
- package/src/config/bundled-skills/computer-use/tools/computer-use-sequence.ts +12 -0
- package/src/config/bundled-skills/media-processing/services/preprocess.ts +2 -1
- package/src/config/bundled-skills/media-processing/services/processing-pipeline.ts +2 -1
- package/src/config/bundled-skills/media-processing/tools/generate-clip.ts +2 -1
- package/src/config/bundled-skills/messaging/SKILL.md +3 -3
- package/src/config/bundled-skills/messaging/TOOLS.json +3 -3
- package/src/config/bundled-skills/messaging/tools/messaging-send.ts +67 -139
- package/src/config/bundled-skills/phone-calls/references/TRANSCRIPTS.md +1 -1
- package/src/config/bundled-skills/playbooks/tools/playbook-create.ts +2 -1
- package/src/config/bundled-skills/playbooks/tools/playbook-update.ts +2 -1
- package/src/config/bundled-skills/schedule/SKILL.md +7 -8
- package/src/config/bundled-skills/screen-annotation/SKILL.md +10 -3
- package/src/config/bundled-skills/screen-annotation/tools/screen-annotation.test.ts +4 -1
- package/src/config/bundled-skills/skill-management/SKILL.md +1 -1
- package/src/config/bundled-skills/skill-management/TOOLS.json +13 -9
- package/src/config/bundled-skills/transcribe/tools/transcribe-media.ts +5 -2
- package/src/config/default-profile-catalog.ts +1 -1
- package/src/config/env.ts +2 -2
- package/src/config/feature-flag-registry.json +33 -13
- package/src/config/loader.ts +11 -17
- package/src/config/memory-v3-gate.test.ts +31 -0
- package/src/config/memory-v3-gate.ts +20 -16
- package/src/config/platform-identity.ts +201 -0
- package/src/config/platform-rehydration.ts +11 -27
- package/src/config/profile-text-generation.test.ts +51 -0
- package/src/config/profile-text-generation.ts +51 -0
- package/src/config/schema.ts +2 -2
- package/src/config/schemas/__tests__/live-voice.test.ts +8 -158
- package/src/config/schemas/__tests__/voice.test.ts +148 -0
- package/src/config/schemas/calls.ts +1 -28
- package/src/config/schemas/live-voice.ts +1 -173
- package/src/config/schemas/llm.ts +7 -2
- package/src/config/schemas/mcp.ts +15 -9
- package/src/config/schemas/memory-retrospective.ts +10 -0
- package/src/config/schemas/monitoring.ts +9 -0
- package/src/config/schemas/services.ts +18 -0
- package/src/config/schemas/skills.ts +0 -14
- package/src/config/schemas/voice.ts +150 -0
- package/src/config/skills.ts +13 -21
- package/src/credential-execution/ces-runtime.ts +2 -2
- package/src/credential-execution/executable-discovery.ts +36 -134
- package/src/credential-execution/process-manager.test.ts +37 -42
- package/src/credential-execution/process-manager.ts +24 -19
- package/src/credential-health/credential-health-service.ts +11 -17
- package/src/daemon/__tests__/conversation-tool-setup-exclude.test.ts +47 -0
- package/src/daemon/__tests__/conversation-tool-setup.test.ts +109 -121
- package/src/daemon/__tests__/plugin-mcp-reconcile.test.ts +5 -1
- package/src/daemon/__tests__/skill-memory-refresh-mtime.test.ts +133 -0
- package/src/daemon/__tests__/turn-tail-deleted-conversation.test.ts +36 -0
- package/src/daemon/app-change-notify.ts +45 -0
- package/src/daemon/assistant-attachments.ts +20 -12
- package/src/daemon/config-watcher.ts +13 -194
- package/src/daemon/conversation-agent-loop-handlers.ts +74 -3
- package/src/daemon/conversation-agent-loop.ts +12 -0
- package/src/daemon/conversation-attachments.ts +93 -12
- package/src/daemon/conversation-client-surface.ts +26 -0
- package/src/daemon/conversation-error.ts +3 -2
- package/src/daemon/conversation-media-retry.ts +2 -1
- package/src/daemon/conversation-process.ts +35 -64
- package/src/daemon/conversation-runtime-assembly.ts +21 -8
- package/src/daemon/conversation-skill-tools.ts +13 -31
- package/src/daemon/conversation-store.ts +1 -1
- package/src/daemon/conversation-surfaces.ts +21 -10
- package/src/daemon/conversation-tool-setup.ts +135 -109
- package/src/daemon/conversation-turn-finalize.ts +26 -13
- package/src/daemon/conversation.ts +17 -3
- package/src/daemon/daemon-control.ts +3 -7
- package/src/daemon/dictation-profile-store.ts +2 -1
- package/src/daemon/handlers/shared.ts +2 -1
- package/src/daemon/handlers/skills.ts +6 -3
- package/src/daemon/host-bash-proxy.ts +8 -12
- package/src/daemon/host-browser-proxy.ts +15 -1
- package/src/daemon/host-cu-proxy.ts +275 -45
- package/src/daemon/host-file-proxy.ts +8 -10
- package/src/daemon/host-proxy-preactivation.ts +4 -1
- package/src/daemon/host-transfer-proxy.ts +14 -18
- package/src/daemon/lifecycle.ts +4 -9
- package/src/daemon/mcp-reload-service.ts +13 -6
- package/src/daemon/message-types/shared.ts +1 -0
- package/src/daemon/message-types/sync.ts +2 -0
- package/src/daemon/orphan-reaper.ts +4 -3
- package/src/daemon/persist-media-references.ts +20 -3
- package/src/daemon/providers-setup.ts +5 -1
- package/src/daemon/reaction-history-render.ts +2 -1
- package/src/daemon/shutdown-handlers.ts +1 -9
- package/src/daemon/skill-memory-refresh.ts +64 -0
- package/src/daemon/tool-setup-types.ts +6 -0
- package/src/daemon/tool-side-effects.ts +7 -18
- package/src/daemon/wake-conversation-ops.ts +38 -15
- package/src/desktop/__tests__/fake-desktop.ts +123 -0
- package/src/desktop/desktop-automation-lease.test.ts +351 -0
- package/src/desktop/desktop-automation-lease.ts +306 -0
- package/src/desktop/desktop-browser-client.test.ts +413 -0
- package/src/desktop/desktop-browser-client.ts +430 -0
- package/src/desktop/desktop-browser-cursor.ts +40 -0
- package/src/desktop/desktop-browser-endpoint.test.ts +78 -0
- package/src/desktop/desktop-browser-endpoint.ts +145 -0
- package/src/desktop/desktop-browser-operations.ts +130 -0
- package/src/desktop/desktop-chrome-policy.test.ts +79 -0
- package/src/desktop/desktop-chrome-policy.ts +47 -0
- package/src/desktop/desktop-chrome-session.test.ts +48 -0
- package/src/desktop/desktop-chrome-session.ts +87 -0
- package/src/desktop/desktop-dependencies.test.ts +131 -0
- package/src/desktop/desktop-dependencies.ts +329 -0
- package/src/desktop/desktop-display.ts +9 -0
- package/src/desktop/desktop-panel-config.test.ts +135 -0
- package/src/desktop/desktop-panel-config.ts +162 -0
- package/src/desktop/desktop-session-manager.test.ts +813 -0
- package/src/desktop/desktop-session-manager.ts +970 -0
- package/src/desktop/desktop-stream-bridge.test.ts +395 -0
- package/src/desktop/desktop-stream-bridge.ts +214 -0
- package/src/desktop/desktop-wallpaper.test.ts +191 -0
- package/src/desktop/desktop-wallpaper.ts +113 -0
- package/src/desktop/desktop-window-drag.ts +177 -0
- package/src/desktop/desktop-window-manager-config.test.ts +230 -0
- package/src/desktop/desktop-window-manager-config.ts +238 -0
- package/src/desktop/desktop-window-theme.ts +170 -0
- package/src/desktop/virtual-desktop-feature.ts +18 -0
- package/src/desktop/virtual-desktop-platform.test.ts +61 -0
- package/src/heartbeat/heartbeat-service.ts +21 -3
- package/src/home/__tests__/feed-writer.test.ts +22 -0
- package/src/home/feed-writer.ts +11 -2
- package/src/hooks/types.ts +33 -0
- package/src/i18n/AGENTS.md +22 -0
- package/src/i18n/__tests__/i18n.test.ts +112 -0
- package/src/i18n/index.ts +16 -0
- package/src/i18n/locales.ts +93 -0
- package/src/i18n/messages.ts +70 -0
- package/src/i18n/title.ts +25 -0
- package/src/inbound/platform-callback-registration.ts +4 -5
- package/src/ipc/__tests__/browser-ipc.test.ts +230 -2
- package/src/ipc/__tests__/cancel-on-disconnect.test.ts +54 -0
- package/src/ipc/assistant-server.ts +15 -1
- package/src/ipc/cli-client.ts +13 -5
- package/src/live-voice/__tests__/live-voice-agent-turn.test.ts +143 -0
- package/src/live-voice/__tests__/live-voice-events.test.ts +9 -7
- package/src/live-voice/__tests__/live-voice-look-follow-up.test.ts +374 -0
- package/src/live-voice/__tests__/live-voice-metrics.test.ts +0 -3
- package/src/live-voice/__tests__/live-voice-progress.test.ts +94 -15
- package/src/live-voice/__tests__/live-voice-session-telemetry.test.ts +19 -0
- package/src/live-voice/__tests__/live-voice-sight-frame-echo.test.ts +238 -0
- package/src/live-voice/__tests__/live-voice-vad.test.ts +660 -5
- package/src/live-voice/__tests__/protocol.test.ts +95 -0
- package/src/live-voice/__tests__/runtime-websocket-shell.test.ts +13 -69
- package/src/live-voice/__tests__/session-controls.test.ts +156 -0
- package/src/live-voice/live-voice-metrics.ts +9 -0
- package/src/live-voice/live-voice-photo.ts +25 -6
- package/src/live-voice/live-voice-session.ts +1081 -760
- package/src/live-voice/protocol.ts +89 -2
- package/src/live-voice/session-controls.ts +197 -0
- package/src/mcp/__tests__/credential-target.test.ts +59 -0
- package/src/mcp/__tests__/effective-config.test.ts +13 -2
- package/src/mcp/__tests__/manager-state.test.ts +128 -0
- package/src/mcp/__tests__/manager-tool-caps.test.ts +111 -0
- package/src/mcp/__tests__/mcp-auth-orchestrator.test.ts +20 -6
- package/src/mcp/__tests__/mcp-auth-state-target.test.ts +49 -0
- package/src/mcp/__tests__/plugin-mcp-oauth-cleanup.test.ts +107 -0
- package/src/mcp/__tests__/plugin-mcp-oauth-provider-isolation.test.ts +89 -0
- package/src/mcp/__tests__/plugin-server-credential-isolation.test.ts +63 -11
- package/src/mcp/__tests__/reload-signal-emission.test.ts +39 -2
- package/src/mcp/__tests__/startup.test.ts +30 -7
- package/src/mcp/__tests__/tool-caps.test.ts +107 -0
- package/src/mcp/__tests__/workspace-mcp-config.test.ts +135 -0
- package/src/mcp/client.ts +64 -16
- package/src/mcp/credential-target.ts +105 -0
- package/src/mcp/effective-config.ts +45 -18
- package/src/mcp/manager.ts +201 -81
- package/src/mcp/mcp-auth-orchestrator.ts +17 -4
- package/src/mcp/mcp-auth-state.ts +38 -6
- package/src/mcp/mcp-header-store.ts +29 -45
- package/src/mcp/mcp-oauth-provider.ts +101 -33
- package/src/mcp/spec-schema.ts +111 -0
- package/src/mcp/startup.ts +41 -17
- package/src/mcp/tool-caps.ts +176 -0
- package/src/mcp/workspace-mcp-config.ts +188 -0
- package/src/messaging/provider-message-metadata.ts +3 -3
- package/src/messaging/provider.ts +10 -3
- package/src/messaging/providers/__tests__/proactive-address.test.ts +95 -0
- package/src/messaging/providers/callback-routing.ts +18 -0
- package/src/messaging/providers/channel-transport.ts +56 -0
- package/src/messaging/providers/discord/transport.ts +17 -0
- package/src/messaging/providers/slack/__tests__/adapter-token-routing.test.ts +6 -17
- package/src/messaging/providers/slack/adapter.ts +7 -44
- package/src/messaging/providers/slack/transport.ts +16 -0
- package/src/messaging/providers/telegram-bot/adapter.ts +1 -48
- package/src/messaging/providers/telegram-bot/client.ts +0 -26
- package/src/messaging/providers/telegram-bot/transport.ts +20 -0
- package/src/messaging/providers/whatsapp/adapter.ts +1 -48
- package/src/messaging/providers/whatsapp/transport.ts +18 -0
- package/src/monitoring/__tests__/mount-watch.test.ts +236 -0
- package/src/monitoring/__tests__/workspace-git-heartbeat.test.ts +8 -0
- package/src/monitoring/mount-watch.ts +348 -0
- package/src/monitoring/plugin-auto-update.ts +6 -0
- package/src/monitoring/worker.ts +9 -0
- package/src/notifications/__tests__/assistant-reply-producer.test.ts +55 -0
- package/src/notifications/__tests__/copy-composer.test.ts +70 -0
- package/src/notifications/__tests__/decision-engine.test.ts +175 -0
- package/src/notifications/__tests__/guardian-feed-projection.test.ts +158 -2
- package/src/notifications/__tests__/home-feed-side-effect.test.ts +153 -3
- package/src/notifications/__tests__/schedule-result-producer.test.ts +99 -3
- package/src/notifications/adapters/macos.ts +3 -0
- package/src/notifications/assistant-reply-producer.ts +8 -3
- package/src/notifications/conversation-pairing.ts +36 -16
- package/src/notifications/copy-composer.ts +11 -3
- package/src/notifications/decision-engine.ts +43 -8
- package/src/notifications/delivered-post-record.ts +11 -1
- package/src/notifications/guardian-feed-projection.ts +125 -5
- package/src/notifications/home-feed-side-effect.ts +55 -7
- package/src/notifications/schedule-result-producer.ts +64 -22
- package/src/oauth/AGENTS.md +4 -0
- package/src/oauth/__tests__/identity-verifier.test.ts +36 -1
- package/src/oauth/__tests__/seed-providers-managed.test.ts +149 -0
- package/src/oauth/byo-connection.test.ts +105 -0
- package/src/oauth/byo-connection.ts +36 -6
- package/src/oauth/connection-resolver.test.ts +100 -0
- package/src/oauth/connection-resolver.ts +120 -3
- package/src/oauth/identity-verifier.ts +24 -0
- package/src/oauth/oauth-store.ts +11 -1
- package/src/oauth/provider-serializer.ts +10 -0
- package/src/oauth/scope-utils.ts +24 -0
- package/src/oauth/seed-providers.ts +367 -27
- package/src/onboarding/checkin-event.ts +2 -1
- package/src/outbound-proxy/certs.ts +3 -5
- package/src/permissions/checker.test.ts +11 -6
- package/src/permissions/confirmation-guardian-request.test.ts +16 -0
- package/src/permissions/confirmation-guardian-request.ts +2 -3
- package/src/persistence/attachments-store.ts +84 -44
- package/src/persistence/compaction-log-store-clickhouse.ts +3 -3
- package/src/persistence/conversation-crud.ts +182 -83
- package/src/persistence/conversation-lineage.ts +12 -4
- package/src/persistence/conversation-plugin-facade.ts +13 -0
- package/src/persistence/conversation-queries.ts +2 -2
- package/src/persistence/conversation-title-placeholders.ts +23 -0
- package/src/persistence/conversation-title-service.ts +9 -26
- package/src/persistence/conversation-tool-surface.ts +86 -0
- package/src/persistence/conversation-types.test.ts +32 -0
- package/src/persistence/conversation-types.ts +26 -4
- package/src/persistence/embeddings/qdrant-manager.ts +163 -18
- package/src/persistence/llm-request-log-sink-clickhouse.ts +3 -3
- package/src/persistence/llm-request-log-source-clickhouse.ts +3 -3
- package/src/persistence/message-cursor.ts +78 -0
- package/src/persistence/message-reads.ts +30 -0
- package/src/persistence/migrations/157-invite-contact-id.ts +18 -6
- package/src/persistence/migrations/378-create-conversation-tool-surfaces.test.ts +78 -0
- package/src/persistence/migrations/378-create-conversation-tool-surfaces.ts +29 -0
- package/src/persistence/migrations/379-oauth-providers-response-ok-field.test.ts +92 -0
- package/src/persistence/migrations/379-oauth-providers-response-ok-field.ts +32 -0
- package/src/persistence/migrations/__tests__/157-invite-contact-id.test.ts +149 -0
- package/src/persistence/schema/conversation-tool-surfaces.ts +22 -0
- package/src/persistence/schema/index.ts +1 -0
- package/src/persistence/schema/memory-core.ts +5 -0
- package/src/persistence/schema/oauth.ts +1 -0
- package/src/persistence/steps.ts +15 -3
- package/src/platform/client.test.ts +4 -2
- package/src/platform/client.ts +2 -10
- package/src/plugin-api/constants.ts +2 -0
- package/src/plugin-api/conversation-turn.ts +31 -7
- package/src/plugin-api/index.ts +10 -1
- package/src/plugin-api/plugin-channel-turn-trust.test.ts +133 -0
- package/src/plugin-api/plugin-channel-turn-trust.ts +71 -0
- package/src/plugin-api/types.ts +2 -0
- package/src/plugins/__tests__/installed-plugin-dirs.test.ts +14 -1
- package/src/plugins/__tests__/mcp-servers.test.ts +38 -8
- package/src/plugins/defaults/index.ts +2 -0
- package/src/plugins/defaults/memory/AGENTS.md +14 -2
- package/src/plugins/defaults/memory/__tests__/buffer-file.test.ts +365 -0
- package/src/plugins/defaults/memory/__tests__/buffer-format.test.ts +43 -0
- package/src/plugins/defaults/memory/__tests__/fixtures/buffer-appender.ts +17 -0
- package/src/plugins/defaults/memory/__tests__/memory-retrospective-accounting.test.ts +46 -0
- package/src/plugins/defaults/memory/__tests__/memory-retrospective-cursor-backfill.test.ts +118 -0
- package/src/plugins/defaults/memory/__tests__/memory-retrospective-cursor-preserve.test.ts +83 -0
- package/src/plugins/defaults/memory/__tests__/memory-retrospective-enqueue.test.ts +9 -5
- package/src/plugins/defaults/memory/__tests__/memory-retrospective-job.test.ts +66 -10
- package/src/plugins/defaults/memory/__tests__/memory-retrospective-prompt.test.ts +20 -0
- package/src/plugins/defaults/memory/__tests__/memory-retrospective-state.test.ts +219 -0
- package/src/plugins/defaults/memory/__tests__/memory-retrospective-sweep.test.ts +31 -0
- package/src/plugins/defaults/memory/__tests__/memory-retrospective-trigger-check.test.ts +63 -0
- package/src/plugins/defaults/memory/__tests__/memory-run-evidence.test.ts +161 -0
- package/src/plugins/defaults/memory/__tests__/shutdown-hook.test.ts +4 -0
- package/src/plugins/defaults/memory/buffer-file.ts +354 -0
- package/src/plugins/defaults/memory/buffer-format.ts +40 -0
- package/src/plugins/defaults/memory/context-search/agent-runner.ts +3 -3
- package/src/plugins/defaults/memory/context-search/format.ts +4 -2
- package/src/plugins/defaults/memory/context-search/sources/memory-v2.ts +7 -3
- package/src/plugins/defaults/memory/context-search/sources/workspace.ts +4 -2
- package/src/plugins/defaults/memory/graph/capability-seed.ts +6 -8
- package/src/plugins/defaults/memory/graph/tool-handlers.ts +1 -42
- package/src/plugins/defaults/memory/hooks/init.ts +10 -0
- package/src/plugins/defaults/memory/hooks/message-deleted.ts +21 -0
- package/src/plugins/defaults/memory/hooks/shutdown.ts +2 -0
- package/src/plugins/defaults/memory/injectors.ts +4 -3
- package/src/plugins/defaults/memory/jobs-worker.ts +13 -0
- package/src/plugins/defaults/memory/memory-retrospective-accounting.ts +34 -60
- package/src/plugins/defaults/memory/memory-retrospective-cursor-backfill.ts +126 -0
- package/src/plugins/defaults/memory/memory-retrospective-cursor-preserve.ts +79 -0
- package/src/plugins/defaults/memory/memory-retrospective-cursor.ts +28 -0
- package/src/plugins/defaults/memory/memory-retrospective-enqueue.ts +3 -5
- package/src/plugins/defaults/memory/memory-retrospective-job.ts +67 -184
- package/src/plugins/defaults/memory/memory-retrospective-prompt.ts +1 -1
- package/src/plugins/defaults/memory/memory-retrospective-state.ts +312 -71
- package/src/plugins/defaults/memory/memory-retrospective-sweep.ts +2 -1
- package/src/plugins/defaults/memory/memory-retrospective-trigger-check.ts +5 -3
- package/src/plugins/defaults/memory/memory-run-evidence.ts +213 -0
- package/src/plugins/defaults/memory/skill-md-mtime-poll.ts +9 -0
- package/src/plugins/defaults/memory/src/memory-item-routes.test.ts +1 -1
- package/src/plugins/defaults/memory/startup.ts +28 -2
- package/src/plugins/defaults/memory/substrate/__tests__/consolidation-job.test.ts +407 -99
- package/src/plugins/defaults/memory/substrate/__tests__/consolidation-prompt-flag-gating-guard.test.ts +10 -0
- package/src/plugins/defaults/memory/substrate/__tests__/prompts-consolidation.test.ts +107 -7
- package/src/plugins/defaults/memory/substrate/__tests__/skill-content.test.ts +7 -9
- package/src/plugins/defaults/memory/substrate/consolidation-job.ts +307 -86
- package/src/plugins/defaults/memory/substrate/consolidation-tool-surface.ts +34 -0
- package/src/plugins/defaults/memory/substrate/page-index.ts +7 -1
- package/src/plugins/defaults/memory/substrate/prompts/consolidation.ts +89 -49
- package/src/plugins/defaults/memory/substrate/skill-content.ts +2 -2
- package/src/plugins/defaults/memory/substrate/sweep-job.ts +1 -1
- package/src/plugins/defaults/memory/tools.ts +1 -1
- package/src/plugins/defaults/memory/v1/graph/consolidation.ts +4 -2
- package/src/plugins/defaults/memory/v1/graph/extraction.ts +4 -1
- package/src/plugins/defaults/memory/v1/graph/retriever.ts +4 -1
- package/src/plugins/defaults/memory/v2/__tests__/migration.test.ts +5 -0
- package/src/plugins/defaults/memory/v2/__tests__/reranker.test.ts +5 -2
- package/src/plugins/defaults/memory/v2/reranker.ts +7 -1
- package/src/plugins/defaults/memory/v3/__tests__/card.test.ts +24 -0
- package/src/plugins/defaults/memory/v3/__tests__/injection.test.ts +81 -1
- package/src/plugins/defaults/memory/v3/__tests__/orchestrate.test.ts +87 -0
- package/src/plugins/defaults/memory/v3/__tests__/pool-select.test.ts +125 -0
- package/src/plugins/defaults/memory/v3/__tests__/sections.test.ts +26 -0
- package/src/plugins/defaults/memory/v3/__tests__/shadow-plugin.test.ts +51 -0
- package/src/plugins/defaults/memory/v3/card.ts +4 -2
- package/src/plugins/defaults/memory/v3/injector.ts +212 -178
- package/src/plugins/defaults/memory/v3/orchestrate.ts +86 -22
- package/src/plugins/defaults/memory/v3/pool-select.ts +13 -8
- package/src/plugins/defaults/memory/v3/sections.ts +10 -3
- package/src/plugins/defaults/memory/v3/shadow-plugin.ts +13 -1
- package/src/plugins/defaults/memory/worker.ts +6 -0
- package/src/plugins/defaults/tool-result-truncate/terminal.ts +1 -46
- package/src/plugins/external-plugin-loader.ts +49 -86
- package/src/plugins/installed-plugin-dirs.ts +6 -4
- package/src/plugins/mcp-servers.ts +24 -90
- package/src/plugins/mtime-cache.ts +2 -1
- package/src/plugins/user-loader.ts +2 -1
- package/src/providers/__tests__/connection-model-compat.test.ts +3 -3
- package/src/providers/__tests__/retry-callsite.test.ts +41 -0
- package/src/providers/__tests__/retry-outbound-sanitize.test.ts +176 -0
- package/src/providers/anthropic/client.ts +0 -47
- package/src/providers/gemini/client.ts +9 -23
- package/src/providers/gemini-thought-signature.test.ts +63 -0
- package/src/providers/gemini-thought-signature.ts +44 -0
- package/src/providers/inference/__tests__/endpoint-probe.test.ts +87 -3
- package/src/providers/inference/adapter-factory.ts +6 -0
- package/src/providers/inference/auth.ts +2 -3
- package/src/providers/inference/connection-availability.ts +27 -8
- package/src/providers/inference/endpoint-probe.ts +36 -12
- package/src/providers/inference/resolve-auth.ts +22 -4
- package/src/providers/inference/service-account-token.ts +248 -0
- package/src/providers/jev/client.test.ts +260 -0
- package/src/providers/jev/client.ts +518 -0
- package/src/providers/model-catalog.ts +92 -3
- package/src/providers/model-intents.ts +10 -5
- package/src/providers/openai/__tests__/chat-completions-output-token-limit.test.ts +141 -0
- package/src/providers/openai/__tests__/chat-completions-provider-reasoning.test.ts +146 -18
- package/src/providers/openai/__tests__/chat-completions-provider-thought-signature.test.ts +613 -0
- package/src/providers/openai/__tests__/google-thought-signature.test.ts +235 -0
- package/src/providers/openai/__tests__/tool-choice-mapping.test.ts +83 -1
- package/src/providers/openai/chat-completions-provider.ts +212 -79
- package/src/providers/openai/codex-models.ts +0 -4
- package/src/providers/openai/google-thought-signature.ts +320 -0
- package/src/providers/openai/responses-provider.ts +9 -2
- package/src/providers/opencode/client.test.ts +240 -4
- package/src/providers/opencode/client.ts +129 -3
- package/src/providers/openrouter/client.ts +20 -0
- package/src/providers/outbound-request-sanitize.ts +96 -0
- package/src/providers/retry.ts +30 -19
- package/src/providers/unparseable-tool-args.ts +5 -1
- package/src/runtime/AGENTS.md +9 -3
- package/src/runtime/__tests__/agent-wake.test.ts +86 -1
- package/src/runtime/__tests__/channel-send.test.ts +443 -0
- package/src/runtime/__tests__/desktop-stream-upgrade.test.ts +132 -0
- package/src/runtime/__tests__/host-observe.test.ts +40 -1
- package/src/runtime/__tests__/live-voice-upgrade.test.ts +58 -0
- package/src/runtime/__tests__/runtime-ws-test-utils.ts +72 -0
- package/src/runtime/__tests__/watch-stream-upgrade.test.ts +59 -0
- package/src/runtime/agent-wake.ts +22 -5
- package/src/runtime/assistant-event-hub.ts +21 -3
- package/src/runtime/auth/same-actor.ts +38 -3
- package/src/runtime/channel-send.ts +316 -0
- package/src/runtime/guardian-action-service.ts +2 -17
- package/src/runtime/guardian-reply-router.ts +1 -8
- package/src/runtime/host-observe.ts +11 -1
- package/src/runtime/http-server.ts +160 -151
- package/src/runtime/migrations/__tests__/vbundle-import-policy.test.ts +89 -0
- package/src/runtime/migrations/vbundle-import-policy.ts +33 -11
- package/src/runtime/routes/__tests__/acp-claude-auth-routes.test.ts +16 -5
- package/src/runtime/routes/__tests__/acp-routes.test.ts +178 -4
- package/src/runtime/routes/__tests__/apps-refresh-route.test.ts +275 -0
- package/src/runtime/routes/__tests__/channel-send-routes.test.ts +127 -0
- package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +108 -1
- package/src/runtime/routes/__tests__/default-provider-routes.test.ts +2 -2
- package/src/runtime/routes/__tests__/dictation-cleanup-guard.test.ts +107 -0
- package/src/runtime/routes/__tests__/inference-profiles-routes.test.ts +24 -2
- package/src/runtime/routes/__tests__/mcp-add-default-risk.test.ts +16 -12
- package/src/runtime/routes/__tests__/plugins-routes.test.ts +127 -3
- package/src/runtime/routes/acp-claude-auth-routes.ts +11 -3
- package/src/runtime/routes/acp-routes.test.ts +15 -0
- package/src/runtime/routes/acp-routes.ts +84 -165
- package/src/runtime/routes/app-management-routes.ts +90 -2
- package/src/runtime/routes/app-routes.ts +1 -1
- package/src/runtime/routes/browser-context.ts +39 -0
- package/src/runtime/routes/browser-routes.ts +16 -47
- package/src/runtime/routes/browser-tabs-routes.ts +72 -29
- package/src/runtime/routes/channel-route-shared.ts +1 -9
- package/src/runtime/routes/channel-send-routes.ts +85 -0
- package/src/runtime/routes/conversation-list-routes.ts +14 -3
- package/src/runtime/routes/conversation-query-routes.ts +40 -0
- package/src/runtime/routes/conversation-routes.ts +45 -7
- package/src/runtime/routes/credential-routes.ts +20 -14
- package/src/runtime/routes/desktop-setup-routes.test.ts +89 -0
- package/src/runtime/routes/desktop-setup-routes.ts +41 -0
- package/src/runtime/routes/diagnostics-routes.ts +61 -4
- package/src/runtime/routes/events-routes.ts +4 -0
- package/src/runtime/routes/guardian-approval-interception.ts +24 -0
- package/src/runtime/routes/host-cu-routes.ts +6 -0
- package/src/runtime/routes/inbound-message-handler.ts +2 -3
- package/src/runtime/routes/inbound-stages/background-dispatch.test.ts +1 -1
- package/src/runtime/routes/inbound-stages/background-dispatch.ts +7 -4
- package/src/runtime/routes/index.ts +4 -2
- package/src/runtime/routes/inference-profile-session-handler.ts +11 -1
- package/src/runtime/routes/inference-profiles-routes.ts +9 -0
- package/src/runtime/routes/log-export-routes.ts +2 -0
- package/src/runtime/routes/mcp-auth-routes.ts +141 -137
- package/src/runtime/routes/migration-routes.ts +6 -20
- package/src/runtime/routes/oauth-commands-routes.ts +98 -45
- package/src/runtime/routes/oauth-providers.ts +11 -0
- package/src/runtime/routes/oauth-request-hints.test.ts +246 -0
- package/src/runtime/routes/oauth-request-hints.ts +149 -0
- package/src/runtime/routes/platform-routes.ts +18 -15
- package/src/runtime/routes/plugins-routes.ts +83 -50
- package/src/runtime/routes/schedule-routes.ts +2 -0
- package/src/runtime/routes/secret-routes.ts +99 -119
- package/src/runtime/routes/workspace-routes.test.ts +55 -26
- package/src/runtime/routes/workspace-routes.ts +46 -63
- package/src/runtime/routes/workspace-tree-walk.test.ts +244 -0
- package/src/runtime/routes/workspace-tree-walk.ts +240 -0
- package/src/runtime/routes/workspace-utils.ts +17 -0
- package/src/runtime/services/__tests__/conversation-serializer.test.ts +28 -0
- package/src/runtime/services/conversation-serializer.ts +16 -3
- package/src/runtime/sync/resource-sync-events.ts +6 -1
- package/src/schedule/__tests__/worker-mcp-bootstrap.test.ts +107 -0
- package/src/schedule/__tests__/worker-mcp-readiness.test.ts +173 -0
- package/src/schedule/__tests__/worker-mcp-tools.test.ts +13 -47
- package/src/schedule/run-script.ts +4 -3
- package/src/schedule/schedule-store.ts +9 -2
- package/src/schedule/scheduler.ts +47 -11
- package/src/schedule/tool-surface-readiness.ts +65 -0
- package/src/schedule/worker-mcp.ts +85 -0
- package/src/schedule/worker.ts +9 -31
- package/src/security/__tests__/ces-http-record-backend.test.ts +137 -0
- package/src/security/ces-http-record-backend.ts +120 -0
- package/src/security/ces-rpc-record-backend.ts +7 -0
- package/src/security/secure-keys.ts +60 -48
- package/src/security/untrusted-content.ts +3 -1
- package/src/skills/__tests__/workspace-skill-md-signature.test.ts +60 -0
- package/src/skills/managed-store.ts +153 -31
- package/src/skills/workspace-skill-md-signature.ts +50 -0
- package/src/subagent/consult-context.ts +12 -25
- package/src/tools/__tests__/side-effect-abort-guard.test.ts +1 -0
- package/src/tools/acp/list-agents.test.ts +3 -1
- package/src/tools/acp/spawn.test.ts +146 -11
- package/src/tools/acp/spawn.ts +21 -3
- package/src/tools/acp/status.test.ts +349 -0
- package/src/tools/acp/status.ts +112 -9
- package/src/tools/app-control/skill-proxy-bridge.ts +2 -1
- package/src/tools/browser/browser-execution.ts +45 -14
- package/src/tools/browser/cdp-client/__tests__/factory.test.ts +69 -0
- package/src/tools/browser/cdp-client/accessibility-snapshot.ts +9 -3
- package/src/tools/browser/cdp-client/cdp-inspect/__tests__/ws-transport.test.ts +1 -0
- package/src/tools/browser/cdp-client/cdp-inspect/discovery.ts +2 -1
- package/src/tools/browser/cdp-client/cdp-inspect/ws-transport.ts +5 -0
- package/src/tools/browser/cdp-client/extension-cdp-client.ts +3 -2
- package/src/tools/browser/network-recorder.ts +2 -1
- package/src/tools/capability-offer.test.ts +22 -2
- package/src/tools/capability-offer.ts +16 -1
- package/src/tools/computer-use/definitions.ts +123 -5
- package/src/tools/computer-use/skill-proxy-bridge.ts +2 -1
- package/src/tools/credentials/metadata-store.ts +100 -0
- package/src/tools/filesystem/search.ts +2 -1
- package/src/tools/host-filesystem/edit.test.ts +2 -1
- package/src/tools/host-filesystem/edit.ts +2 -2
- package/src/tools/host-filesystem/read.test.ts +2 -1
- package/src/tools/host-filesystem/read.ts +2 -2
- package/src/tools/host-filesystem/transfer.test.ts +2 -1
- package/src/tools/host-filesystem/transfer.ts +2 -2
- package/src/tools/host-filesystem/write.test.ts +2 -1
- package/src/tools/host-filesystem/write.ts +2 -2
- package/src/tools/host-terminal/host-shell.test.ts +16 -0
- package/src/tools/host-terminal/host-shell.ts +16 -26
- package/src/tools/network/web-search.ts +6 -1
- package/src/tools/policy-context.ts +6 -7
- package/src/tools/shared/filesystem/file-ops-service.ts +1 -31
- package/src/tools/shared/shell-output.test.ts +10 -0
- package/src/tools/shared/shell-output.ts +14 -2
- package/src/tools/skills/find-similar-skills.test.ts +214 -2
- package/src/tools/skills/find-similar-skills.ts +62 -9
- package/src/tools/skills/resolve-execute-invocation.ts +24 -0
- package/src/tools/skills/sandbox-runner.ts +13 -2
- package/src/tools/skills/scaffold-managed.ts +78 -16
- package/src/tools/subagent/spawn.ts +5 -8
- package/src/tools/terminal/__tests__/safe-env.test.ts +33 -4
- package/src/tools/terminal/__tests__/sanitized-bash.test.ts +43 -0
- package/src/tools/terminal/safe-env.ts +35 -24
- package/src/tools/terminal/sanitized-bash.ts +118 -0
- package/src/tools/terminal/shell-launch.test.ts +162 -0
- package/src/tools/terminal/shell.test.ts +29 -0
- package/src/tools/terminal/shell.ts +13 -7
- package/src/tools/ui-surface/channel-variants.ts +10 -59
- package/src/tools/watch/watch-retro-report.ts +0 -8
- package/src/types/host-capabilities.ts +5 -3
- package/src/util/__tests__/language-subtag.test.ts +23 -1
- package/src/util/abort-reasons.ts +12 -1
- package/src/util/ca-bundle.ts +13 -0
- package/src/util/host-process.test.ts +17 -1
- package/src/util/host-process.ts +24 -0
- package/src/util/language-subtag.ts +16 -0
- package/src/util/platform.ts +8 -0
- package/src/util/plugin-manifest.ts +203 -0
- package/src/util/unicode.ts +44 -1
- package/src/watch/watch-retro.ts +6 -8
- package/src/watch/watch-timeline.ts +2 -2
- package/src/workflows/run-manager.ts +2 -1
- package/src/workspace/git-porcelain.ts +66 -0
- package/src/workspace/git-service.ts +6 -55
- package/src/workspace/migrations/154-repair-retired-codex-gpt-5-4-model-ids.ts +258 -0
- package/src/workspace/migrations/155-move-front-model-config-to-voice.ts +78 -0
- package/src/workspace/migrations/156-extract-workspace-mcp-json.ts +214 -0
- package/src/workspace/migrations/__tests__/155-move-front-model-config-to-voice.test.ts +102 -0
- package/src/workspace/migrations/__tests__/156-extract-workspace-mcp-json.test.ts +199 -0
- package/src/workspace/migrations/registry.ts +6 -0
- package/src/__tests__/app-source-watcher.test.ts +0 -218
- package/src/__tests__/config-watcher-skill-reseed.test.ts +0 -359
- package/src/__tests__/speaker-identification.test.ts +0 -56
- package/src/calls/speaker-identification.ts +0 -233
- package/src/daemon/app-source-watcher.ts +0 -218
- package/src/messaging/providers/whatsapp/client.ts +0 -29
- package/src/runtime/routes/debug-bash-routes.ts +0 -173
- package/src/util/fs-watcher-error.ts +0 -36
- /package/src/{live-voice → calls}/progress-phrases.ts +0 -0
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `assistant channels send`: post text to a chat on a channel, as the
|
|
3
|
+
* assistant's own bot.
|
|
4
|
+
*
|
|
5
|
+
* The send door. It runs the daemon function the messaging tool runs
|
|
6
|
+
* (`sendChannelText`, over `POST /v1/channels/send`), so a send from the
|
|
7
|
+
* command line reaches the chat through the channel's transport and leaves
|
|
8
|
+
* the same record: threaded where a thread is named, rendered the way the
|
|
9
|
+
* channel renders a reply, and written to the chat's conversation only once
|
|
10
|
+
* the channel has acknowledged it.
|
|
11
|
+
*
|
|
12
|
+
* Posting the same text through `channels request` reaches the platform API
|
|
13
|
+
* directly and leaves no record of what was said, which is why this command
|
|
14
|
+
* exists beside it. Both act as the bot and both carry the same rating: the
|
|
15
|
+
* effect is a message either way.
|
|
16
|
+
*
|
|
17
|
+
* A channel whose transport cannot be addressed from a named chat is
|
|
18
|
+
* refused by the route before anything is sent.
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
import type { Command } from "commander";
|
|
22
|
+
|
|
23
|
+
import { cliIpcCall, exitCodeFromIpcResult } from "../../../ipc/cli-client.js";
|
|
24
|
+
import { subcommand } from "../../lib/cli-command-help.js";
|
|
25
|
+
import { log } from "../../logger.js";
|
|
26
|
+
import { shouldOutputJson, writeError, writeOutput } from "../../output.js";
|
|
27
|
+
|
|
28
|
+
/** What the channel acknowledged, and where the post was recorded. */
|
|
29
|
+
interface ChannelSendResponse {
|
|
30
|
+
channel: string;
|
|
31
|
+
chatId: string;
|
|
32
|
+
threadId?: string;
|
|
33
|
+
messageIds: string[];
|
|
34
|
+
lastMessageId: string;
|
|
35
|
+
recordedIn?: string;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
interface ChannelSendOptions {
|
|
39
|
+
text?: string;
|
|
40
|
+
thread?: string;
|
|
41
|
+
plain?: boolean;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* How long to wait for the daemon before giving up on an answer.
|
|
46
|
+
*
|
|
47
|
+
* Longer than the IPC default because the work behind this call is a
|
|
48
|
+
* platform request that retries: a rate-limited Slack send sleeps for the
|
|
49
|
+
* `Retry-After` Slack names and tries again up to three times
|
|
50
|
+
* (`MAX_RATE_LIMIT_RETRIES`, providers/slack/web-api-transport.ts), and the
|
|
51
|
+
* other channels back off similarly. Waiting past that is better than
|
|
52
|
+
* abandoning a send that is still being made, because giving up tells the
|
|
53
|
+
* caller nothing about whether the message went out.
|
|
54
|
+
*/
|
|
55
|
+
const SEND_CALL_TIMEOUT_MS = 120_000;
|
|
56
|
+
|
|
57
|
+
export function registerChannelsSendCommand(channels: Command): void {
|
|
58
|
+
subcommand(channels, "send").action(
|
|
59
|
+
async (
|
|
60
|
+
channel: string,
|
|
61
|
+
chatId: string,
|
|
62
|
+
opts: ChannelSendOptions,
|
|
63
|
+
cmd: Command,
|
|
64
|
+
) => {
|
|
65
|
+
// Trimmed only to reject a blank message: the text goes out as the
|
|
66
|
+
// caller wrote it, which `--plain` in particular promises.
|
|
67
|
+
const text = opts.text;
|
|
68
|
+
if (!text?.trim()) {
|
|
69
|
+
writeError(cmd, "--text is required and cannot be empty.");
|
|
70
|
+
process.exitCode = 1;
|
|
71
|
+
return;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
const threadId = opts.thread?.trim();
|
|
75
|
+
const r = await cliIpcCall<ChannelSendResponse>(
|
|
76
|
+
"channels_send_post",
|
|
77
|
+
{
|
|
78
|
+
body: {
|
|
79
|
+
channel,
|
|
80
|
+
target: {
|
|
81
|
+
kind: "chat",
|
|
82
|
+
chatId,
|
|
83
|
+
...(threadId ? { threadId } : {}),
|
|
84
|
+
},
|
|
85
|
+
text,
|
|
86
|
+
// Rich unless asked otherwise, so a send from here reads like
|
|
87
|
+
// the assistant's other posts in that chat rather than like a
|
|
88
|
+
// different sender.
|
|
89
|
+
...(opts.plain ? {} : { renderRichly: true }),
|
|
90
|
+
},
|
|
91
|
+
},
|
|
92
|
+
{ timeoutMs: SEND_CALL_TIMEOUT_MS },
|
|
93
|
+
);
|
|
94
|
+
if (!r.ok) {
|
|
95
|
+
// A timeout is not a failure: closing the client socket does not
|
|
96
|
+
// stop the daemon, so the message may still go out. Saying so is
|
|
97
|
+
// what keeps a retry from posting it twice.
|
|
98
|
+
const message = r.timedOut
|
|
99
|
+
? `The daemon did not answer within ${Math.round(SEND_CALL_TIMEOUT_MS / 1000)}s. The send may still be in flight, so it may or may not have gone out. Check the chat before sending again.`
|
|
100
|
+
: (r.error ?? "The send failed.");
|
|
101
|
+
// Reported rather than exited, so `--json` gets an error envelope
|
|
102
|
+
// like every other answer this command gives.
|
|
103
|
+
writeError(cmd, message);
|
|
104
|
+
process.exitCode = exitCodeFromIpcResult({
|
|
105
|
+
statusCode: r.statusCode,
|
|
106
|
+
});
|
|
107
|
+
return;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
const sent = r.result!;
|
|
111
|
+
if (shouldOutputJson(cmd)) {
|
|
112
|
+
writeOutput(cmd, sent);
|
|
113
|
+
return;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
const where = sent.threadId
|
|
117
|
+
? `${sent.chatId}, thread ${sent.threadId}`
|
|
118
|
+
: sent.chatId;
|
|
119
|
+
log.info(`Sent to ${channel} ${where} (id: ${sent.lastMessageId})`);
|
|
120
|
+
if (sent.messageIds.length > 1) {
|
|
121
|
+
log.info(`The channel split it into ${sent.messageIds.length} posts`);
|
|
122
|
+
}
|
|
123
|
+
if (sent.recordedIn) {
|
|
124
|
+
log.info(`Recorded in conversation ${sent.recordedIn}`);
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
);
|
|
128
|
+
}
|
|
@@ -45,8 +45,12 @@ Examples:
|
|
|
45
45
|
},
|
|
46
46
|
],
|
|
47
47
|
helpText: `
|
|
48
|
-
Lists
|
|
49
|
-
|
|
48
|
+
Lists credentials from the live credential vault. Each entry includes the same
|
|
49
|
+
fields as inspect: scrubbed value, timestamps, policy, and metadata.
|
|
50
|
+
|
|
51
|
+
Fails immediately with an error if the credential vault is unreachable. An
|
|
52
|
+
empty list means the vault answered and has no matching credentials, not that
|
|
53
|
+
the store is down.
|
|
50
54
|
|
|
51
55
|
The --search flag filters results by case-insensitive substring match against
|
|
52
56
|
the credential's service name, field name, label, or description. For example, --search
|
|
@@ -70,9 +74,9 @@ path or connection details. Run this to diagnose credential lookup mismatches
|
|
|
70
74
|
for example, when the CLI and the daemon are reading from different stores.
|
|
71
75
|
|
|
72
76
|
Backend types:
|
|
73
|
-
encrypted-store Direct file read from keys.enc (standalone CLI, no
|
|
74
|
-
ces-rpc Delegates to the running CES process via
|
|
75
|
-
ces-http
|
|
77
|
+
encrypted-store Direct file read from keys.enc (standalone CLI, no assistant)
|
|
78
|
+
ces-rpc Delegates to the running CES process via socket RPC
|
|
79
|
+
ces-http Managed failover when the CES socket is unavailable
|
|
76
80
|
|
|
77
81
|
Also shows the CREDENTIAL_SECURITY_DIR, GATEWAY_SECURITY_DIR, and
|
|
78
82
|
VELLUM_WORKSPACE_DIR env vars so you can confirm which instance directory this
|
|
@@ -343,8 +343,8 @@ export function registerCredentialsCommand(program: Command): void {
|
|
|
343
343
|
} else {
|
|
344
344
|
printCredentialHuman(output);
|
|
345
345
|
if (output.brokerUnreachable) {
|
|
346
|
-
log.
|
|
347
|
-
"
|
|
346
|
+
log.warn(
|
|
347
|
+
" Credential store is unreachable. Retry in a moment, or check that the credential vault is running.",
|
|
348
348
|
);
|
|
349
349
|
}
|
|
350
350
|
}
|
|
@@ -7,8 +7,8 @@ export const mcpHelp: CliCommandHelp = {
|
|
|
7
7
|
description: "Manage MCP (Model Context Protocol) servers",
|
|
8
8
|
helpText: `
|
|
9
9
|
MCP servers extend the assistant's capabilities with external tools. Servers
|
|
10
|
-
are configured in the assistant's
|
|
11
|
-
|
|
10
|
+
are configured in the assistant's mcp.json, or declared by an installed
|
|
11
|
+
plugin in its root mcp.json. Each
|
|
12
12
|
server uses one of three transport types:
|
|
13
13
|
|
|
14
14
|
stdio Local process communicating over stdin/stdout
|
|
@@ -30,8 +30,8 @@ Examples:
|
|
|
30
30
|
options: [{ flags: "--json", description: "Output as JSON" }],
|
|
31
31
|
helpText: `
|
|
32
32
|
Shows each MCP server with its current status and configuration. Servers come
|
|
33
|
-
from two places: the mcp.
|
|
34
|
-
|
|
33
|
+
from two places: the workspace mcp.json, and the root mcp.json of any
|
|
34
|
+
installed plugin that declares one.
|
|
35
35
|
|
|
36
36
|
Name The server identifier
|
|
37
37
|
Status Health check result for workspace servers:
|
|
@@ -43,7 +43,7 @@ any installed plugin that declares one.
|
|
|
43
43
|
health-checked, so no stored credential can reach a URL a
|
|
44
44
|
plugin chose.
|
|
45
45
|
Source Shown only for plugin-declared servers, naming the plugin.
|
|
46
|
-
Servers from
|
|
46
|
+
Servers from workspace mcp.json print no Source line.
|
|
47
47
|
Transport stdio, sse, or streamable-http
|
|
48
48
|
URL/Command The server URL (sse/streamable-http) or command (stdio)
|
|
49
49
|
|
|
@@ -64,7 +64,7 @@ on their next turn automatically. The assistant must be running.
|
|
|
64
64
|
|
|
65
65
|
Examples:
|
|
66
66
|
$ vellum mcp reload
|
|
67
|
-
$ vellum mcp reload # after editing
|
|
67
|
+
$ vellum mcp reload # after editing mcp.json to add a new server
|
|
68
68
|
$ vellum mcp reload # after running "vellum mcp auth <server>"`,
|
|
69
69
|
},
|
|
70
70
|
{
|
|
@@ -95,7 +95,7 @@ Examples:
|
|
|
95
95
|
],
|
|
96
96
|
helpText: `
|
|
97
97
|
Arguments:
|
|
98
|
-
name Unique identifier for the server (used as the key in
|
|
98
|
+
name Unique identifier for the server (used as the key in mcp.json)
|
|
99
99
|
|
|
100
100
|
Transport-specific requirements:
|
|
101
101
|
stdio Requires --command (and optional --args for arguments)
|
|
@@ -149,7 +149,7 @@ Examples:
|
|
|
149
149
|
Arguments:
|
|
150
150
|
name Name of the MCP server to remove
|
|
151
151
|
|
|
152
|
-
Removes the server entry from
|
|
152
|
+
Removes the server entry from mcp.json and performs best-effort cleanup of
|
|
153
153
|
any stored OAuth credentials (tokens, client info, discovery metadata) for
|
|
154
154
|
sse/streamable-http servers. If no OAuth credentials exist, the cleanup is
|
|
155
155
|
silently skipped.
|
package/src/cli/commands/mcp.ts
CHANGED
|
@@ -20,7 +20,7 @@ interface McpServerEntry {
|
|
|
20
20
|
command?: string;
|
|
21
21
|
args?: string[];
|
|
22
22
|
};
|
|
23
|
-
/** Workspace `
|
|
23
|
+
/** Workspace `mcp.json` or a plugin's `mcp.json`. */
|
|
24
24
|
source?: "workspace" | "plugin";
|
|
25
25
|
/** Plugin that declared the server, when `source` is `plugin`. */
|
|
26
26
|
pluginName?: string;
|
|
@@ -258,6 +258,11 @@ Examples:
|
|
|
258
258
|
description:
|
|
259
259
|
"Dot-notation path to a boolean field that must be truthy for the response to be valid",
|
|
260
260
|
},
|
|
261
|
+
{
|
|
262
|
+
flags: "--response-ok-field <field>",
|
|
263
|
+
description:
|
|
264
|
+
"Dot-notation path to the boolean every response body carries to report success (Slack: ok); an explicit false under a 2xx fails the request",
|
|
265
|
+
},
|
|
261
266
|
{
|
|
262
267
|
flags: "--setup-notes <json>",
|
|
263
268
|
description:
|
|
@@ -430,6 +435,11 @@ Examples:
|
|
|
430
435
|
flags: "--identity-ok-field <field>",
|
|
431
436
|
description: "Dot-notation path to a boolean ok field",
|
|
432
437
|
},
|
|
438
|
+
{
|
|
439
|
+
flags: "--response-ok-field <field>",
|
|
440
|
+
description:
|
|
441
|
+
"Dot-notation path to the boolean every response body carries to report success",
|
|
442
|
+
},
|
|
433
443
|
{
|
|
434
444
|
flags: "--setup-notes <json>",
|
|
435
445
|
description: "JSON array of setup instruction notes",
|
|
@@ -49,6 +49,7 @@ interface SerializedProvider {
|
|
|
49
49
|
identityResponsePaths?: string[] | null;
|
|
50
50
|
identityFormat?: string | null;
|
|
51
51
|
identityOkField?: string | null;
|
|
52
|
+
responseOkField?: string | null;
|
|
52
53
|
availableScopes?: unknown;
|
|
53
54
|
setupNotes?: string[] | unknown;
|
|
54
55
|
featureFlag?: string | null;
|
|
@@ -217,6 +218,9 @@ function formatProviderDetail(p: SerializedProvider): string {
|
|
|
217
218
|
if (p.identityOkField) {
|
|
218
219
|
lines.push(` Identity ok field: ${p.identityOkField}`);
|
|
219
220
|
}
|
|
221
|
+
if (p.responseOkField) {
|
|
222
|
+
lines.push(` Response ok field: ${p.responseOkField}`);
|
|
223
|
+
}
|
|
220
224
|
if (p.setupNotes) {
|
|
221
225
|
if (Array.isArray(p.setupNotes)) {
|
|
222
226
|
lines.push(
|
|
@@ -403,6 +407,7 @@ export function registerProviderCommands(oauth: Command): void {
|
|
|
403
407
|
identityResponsePaths?: string;
|
|
404
408
|
identityFormat?: string;
|
|
405
409
|
identityOkField?: string;
|
|
410
|
+
responseOkField?: string;
|
|
406
411
|
setupNotes?: string;
|
|
407
412
|
availableScopes?: string;
|
|
408
413
|
},
|
|
@@ -505,6 +510,9 @@ export function registerProviderCommands(oauth: Command): void {
|
|
|
505
510
|
if (opts.identityOkField !== undefined) {
|
|
506
511
|
body.identity_ok_field = opts.identityOkField;
|
|
507
512
|
}
|
|
513
|
+
if (opts.responseOkField !== undefined) {
|
|
514
|
+
body.response_ok_field = opts.responseOkField;
|
|
515
|
+
}
|
|
508
516
|
if (opts.setupNotes !== undefined) {
|
|
509
517
|
body.setup_notes = JSON.parse(opts.setupNotes);
|
|
510
518
|
}
|
|
@@ -578,6 +586,7 @@ export function registerProviderCommands(oauth: Command): void {
|
|
|
578
586
|
identityResponsePaths?: string;
|
|
579
587
|
identityFormat?: string;
|
|
580
588
|
identityOkField?: string;
|
|
589
|
+
responseOkField?: string;
|
|
581
590
|
setupNotes?: string;
|
|
582
591
|
availableScopes?: string;
|
|
583
592
|
},
|
|
@@ -686,6 +695,9 @@ export function registerProviderCommands(oauth: Command): void {
|
|
|
686
695
|
if (opts.identityOkField !== undefined) {
|
|
687
696
|
body.identity_ok_field = opts.identityOkField;
|
|
688
697
|
}
|
|
698
|
+
if (opts.responseOkField !== undefined) {
|
|
699
|
+
body.response_ok_field = opts.responseOkField;
|
|
700
|
+
}
|
|
689
701
|
if (opts.setupNotes !== undefined) {
|
|
690
702
|
body.setup_notes = JSON.parse(opts.setupNotes);
|
|
691
703
|
}
|
|
@@ -17,6 +17,7 @@ let handleRequestResult: {
|
|
|
17
17
|
body: unknown;
|
|
18
18
|
bodyEncoding?: "base64";
|
|
19
19
|
account?: string | null;
|
|
20
|
+
hint?: string;
|
|
20
21
|
} = {
|
|
21
22
|
ok: true,
|
|
22
23
|
status: 200,
|
|
@@ -71,18 +72,71 @@ afterEach(() => {
|
|
|
71
72
|
process.exitCode = 0;
|
|
72
73
|
});
|
|
73
74
|
|
|
74
|
-
|
|
75
|
+
/**
|
|
76
|
+
* Runs the command with both streams captured and `process.exit` recorded.
|
|
77
|
+
* The stream stubs honour a write callback the way the real streams do, so an
|
|
78
|
+
* exit that rides the last write lands in `exitCalls`, and only after every
|
|
79
|
+
* chunk written before it has been captured. `holdStderr` keeps stderr
|
|
80
|
+
* callbacks back and returns them, for the case where stderr is still in
|
|
81
|
+
* flight when stdout has drained.
|
|
82
|
+
*/
|
|
83
|
+
async function runRequestCommand(
|
|
84
|
+
args: string[],
|
|
85
|
+
options: { holdStderr?: boolean } = {},
|
|
86
|
+
): Promise<{
|
|
75
87
|
stdout: Buffer;
|
|
88
|
+
stderr: string;
|
|
76
89
|
exitCode: number;
|
|
90
|
+
exitCalls: number[];
|
|
91
|
+
heldStderrCallbacks: Array<() => void>;
|
|
77
92
|
}> {
|
|
78
93
|
const chunks: Buffer[] = [];
|
|
94
|
+
const stderrChunks: string[] = [];
|
|
95
|
+
const exitCalls: number[] = [];
|
|
96
|
+
const heldStderrCallbacks: Array<() => void> = [];
|
|
79
97
|
const originalWrite = process.stdout.write;
|
|
80
|
-
process.
|
|
98
|
+
const originalStderrWrite = process.stderr.write;
|
|
99
|
+
const originalExit = process.exit;
|
|
100
|
+
const callbackOf = (rest: unknown[]): (() => void) | undefined =>
|
|
101
|
+
rest.find((arg) => typeof arg === "function") as (() => void) | undefined;
|
|
102
|
+
process.stdout.write = ((chunk: string | Uint8Array, ...rest: unknown[]) => {
|
|
81
103
|
chunks.push(
|
|
82
104
|
typeof chunk === "string" ? Buffer.from(chunk) : Buffer.from(chunk),
|
|
83
105
|
);
|
|
106
|
+
callbackOf(rest)?.();
|
|
84
107
|
return true;
|
|
85
108
|
}) as typeof process.stdout.write;
|
|
109
|
+
process.stderr.write = ((chunk: string | Uint8Array, ...rest: unknown[]) => {
|
|
110
|
+
stderrChunks.push(String(chunk));
|
|
111
|
+
const callback = callbackOf(rest);
|
|
112
|
+
if (callback) {
|
|
113
|
+
if (options.holdStderr) {
|
|
114
|
+
heldStderrCallbacks.push(holdCallback(callback));
|
|
115
|
+
} else {
|
|
116
|
+
callback();
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
return true;
|
|
120
|
+
}) as typeof process.stderr.write;
|
|
121
|
+
const recordExit = ((code?: number) => {
|
|
122
|
+
exitCalls.push(code ?? Number(process.exitCode ?? 0));
|
|
123
|
+
}) as typeof process.exit;
|
|
124
|
+
process.exit = recordExit;
|
|
125
|
+
// A held callback runs after this function has restored the real
|
|
126
|
+
// `process.exit`, so it reinstalls the recorder for the duration of the
|
|
127
|
+
// call; the exit it triggers must land in `exitCalls`, never end the test
|
|
128
|
+
// process.
|
|
129
|
+
const holdCallback = (callback: () => void): (() => void) => {
|
|
130
|
+
return () => {
|
|
131
|
+
const current = process.exit;
|
|
132
|
+
process.exit = recordExit;
|
|
133
|
+
try {
|
|
134
|
+
callback();
|
|
135
|
+
} finally {
|
|
136
|
+
process.exit = current;
|
|
137
|
+
}
|
|
138
|
+
};
|
|
139
|
+
};
|
|
86
140
|
|
|
87
141
|
try {
|
|
88
142
|
const program = new Command();
|
|
@@ -101,11 +155,16 @@ async function runRequestCommand(args: string[]): Promise<{
|
|
|
101
155
|
// Commander may throw under exitOverride for parse errors.
|
|
102
156
|
} finally {
|
|
103
157
|
process.stdout.write = originalWrite;
|
|
158
|
+
process.stderr.write = originalStderrWrite;
|
|
159
|
+
process.exit = originalExit;
|
|
104
160
|
}
|
|
105
161
|
|
|
106
162
|
return {
|
|
107
163
|
stdout: Buffer.concat(chunks),
|
|
164
|
+
stderr: stderrChunks.join(""),
|
|
108
165
|
exitCode: Number(process.exitCode ?? 0),
|
|
166
|
+
exitCalls,
|
|
167
|
+
heldStderrCallbacks,
|
|
109
168
|
};
|
|
110
169
|
}
|
|
111
170
|
|
|
@@ -308,6 +367,124 @@ describe("oauth request body output", () => {
|
|
|
308
367
|
expect(parsed.bodyEncoding).toBe("base64");
|
|
309
368
|
});
|
|
310
369
|
|
|
370
|
+
test("exits non-zero when the route reports failure inside a 2xx", async () => {
|
|
371
|
+
// The exit code follows the route's verdict, so a caller that only checks
|
|
372
|
+
// the exit code sees a refused call as a failure; the body still prints,
|
|
373
|
+
// since it carries the provider's own error code.
|
|
374
|
+
handleRequestResult = {
|
|
375
|
+
ok: false,
|
|
376
|
+
status: 200,
|
|
377
|
+
headers: { "content-type": "application/json" },
|
|
378
|
+
body: { ok: false, error: "not_in_channel" },
|
|
379
|
+
account: "user@example.com",
|
|
380
|
+
};
|
|
381
|
+
const { stdout, exitCode } = await runRequestCommand([
|
|
382
|
+
"--provider",
|
|
383
|
+
"slack_channel",
|
|
384
|
+
"-s",
|
|
385
|
+
"/chat.postMessage",
|
|
386
|
+
]);
|
|
387
|
+
|
|
388
|
+
expect(exitCode).toBe(1);
|
|
389
|
+
expect(stdout.toString("utf8")).toContain("not_in_channel");
|
|
390
|
+
});
|
|
391
|
+
|
|
392
|
+
test("exits itself once the whole body has drained", async () => {
|
|
393
|
+
// The in-process route leaves handles open, so the command has to exit;
|
|
394
|
+
// and it must do so on the write callback, because a bare exit after a
|
|
395
|
+
// large piped write drops everything past the first 64 KB.
|
|
396
|
+
const body = "x".repeat(200_000);
|
|
397
|
+
handleRequestResult = {
|
|
398
|
+
ok: true,
|
|
399
|
+
status: 200,
|
|
400
|
+
headers: { "content-type": "text/plain" },
|
|
401
|
+
body,
|
|
402
|
+
account: "user@example.com",
|
|
403
|
+
};
|
|
404
|
+
const { stdout, exitCode, exitCalls } = await runRequestCommand([
|
|
405
|
+
"--provider",
|
|
406
|
+
"google",
|
|
407
|
+
"-s",
|
|
408
|
+
"https://api.google.com/v1/big",
|
|
409
|
+
]);
|
|
410
|
+
|
|
411
|
+
expect(stdout.toString("utf8")).toBe(body + "\n");
|
|
412
|
+
expect(exitCode).toBe(0);
|
|
413
|
+
expect(exitCalls).toEqual([0]);
|
|
414
|
+
});
|
|
415
|
+
|
|
416
|
+
test("exits after writing an empty body to a file", async () => {
|
|
417
|
+
const target = join(tempDir, "empty.bin");
|
|
418
|
+
handleRequestResult = {
|
|
419
|
+
ok: true,
|
|
420
|
+
status: 204,
|
|
421
|
+
headers: {},
|
|
422
|
+
body: null,
|
|
423
|
+
account: "user@example.com",
|
|
424
|
+
};
|
|
425
|
+
const { exitCalls } = await runRequestCommand([
|
|
426
|
+
"--provider",
|
|
427
|
+
"google",
|
|
428
|
+
"-s",
|
|
429
|
+
"-o",
|
|
430
|
+
target,
|
|
431
|
+
"https://api.google.com/v1/none",
|
|
432
|
+
]);
|
|
433
|
+
|
|
434
|
+
expect(readFileSync(target)).toHaveLength(0);
|
|
435
|
+
expect(exitCalls).toEqual([0]);
|
|
436
|
+
});
|
|
437
|
+
|
|
438
|
+
test("waits for stderr to drain before exiting when stdout carried nothing", async () => {
|
|
439
|
+
// With `-o`, stdout carries nothing, so the exit cannot ride a stdout
|
|
440
|
+
// write, and the diagnostics on stderr (the account line, a hint) may
|
|
441
|
+
// still be in flight. The exit waits for the last of them.
|
|
442
|
+
const target = join(tempDir, "body.json");
|
|
443
|
+
handleRequestResult = {
|
|
444
|
+
ok: false,
|
|
445
|
+
status: 200,
|
|
446
|
+
headers: { "content-type": "application/json" },
|
|
447
|
+
body: { ok: false, error: "not_in_channel" },
|
|
448
|
+
account: "user@example.com",
|
|
449
|
+
hint: "slack_channel answered HTTP 200 but reported ok: false",
|
|
450
|
+
};
|
|
451
|
+
const { stderr, exitCalls, heldStderrCallbacks } = await runRequestCommand(
|
|
452
|
+
["--provider", "slack_channel", "-o", target, "/chat.postMessage"],
|
|
453
|
+
{ holdStderr: true },
|
|
454
|
+
);
|
|
455
|
+
|
|
456
|
+
expect(stderr).toContain("Account: user@example.com");
|
|
457
|
+
expect(stderr).toContain("ok: false");
|
|
458
|
+
expect(heldStderrCallbacks).toHaveLength(2);
|
|
459
|
+
expect(exitCalls).toEqual([]);
|
|
460
|
+
|
|
461
|
+
heldStderrCallbacks[0]();
|
|
462
|
+
expect(exitCalls).toEqual([]);
|
|
463
|
+
heldStderrCallbacks[1]();
|
|
464
|
+
expect(exitCalls).toEqual([1]);
|
|
465
|
+
});
|
|
466
|
+
|
|
467
|
+
test("a stdout body waits for stderr diagnostics written before it", async () => {
|
|
468
|
+
handleRequestResult = {
|
|
469
|
+
ok: true,
|
|
470
|
+
status: 200,
|
|
471
|
+
headers: { "content-type": "application/json" },
|
|
472
|
+
body: { hello: "world" },
|
|
473
|
+
account: "user@example.com",
|
|
474
|
+
};
|
|
475
|
+
const { stdout, exitCalls, heldStderrCallbacks } = await runRequestCommand(
|
|
476
|
+
["--provider", "google", "https://api.google.com/v1/me"],
|
|
477
|
+
{ holdStderr: true },
|
|
478
|
+
);
|
|
479
|
+
|
|
480
|
+
expect(stdout.toString("utf8")).toContain("hello");
|
|
481
|
+
expect(heldStderrCallbacks).toHaveLength(1);
|
|
482
|
+
expect(exitCalls).toEqual([]);
|
|
483
|
+
|
|
484
|
+
heldStderrCallbacks[0]();
|
|
485
|
+
expect(exitCalls).toEqual([0]);
|
|
486
|
+
});
|
|
487
|
+
|
|
311
488
|
test("writes text bodies as UTF-8 and appends a newline on stdout", async () => {
|
|
312
489
|
handleRequestResult = {
|
|
313
490
|
ok: true,
|
|
@@ -142,11 +142,38 @@ export async function runAuthenticatedRequest(params: {
|
|
|
142
142
|
const { providerKey, url, opts, cmd } = params;
|
|
143
143
|
const jsonMode = shouldOutputJson(cmd);
|
|
144
144
|
|
|
145
|
+
// The command exits itself, once its last write on either stream has
|
|
146
|
+
// drained. Running the route in-process leaves handles open that the event
|
|
147
|
+
// loop waits on (the lazy CES connection the credential resolves through is
|
|
148
|
+
// never closed by the CLI), so returning from the action would leave the
|
|
149
|
+
// process alive after a complete response. A bare `process.exit()` is not
|
|
150
|
+
// the answer either: with a pipe on the other end, Bun flushes what the
|
|
151
|
+
// pipe accepts and drops the rest, so the exit rides write callbacks, which
|
|
152
|
+
// fire when the bytes are out. Stdout's last write carries `exit` itself;
|
|
153
|
+
// stderr's writes are counted, so an exit requested while one is still in
|
|
154
|
+
// flight waits for it. The pipe's capacity is not a bound to lean on: a
|
|
155
|
+
// busy host can shrink an unprivileged pipe to a single page.
|
|
156
|
+
let stderrInFlight = 0;
|
|
157
|
+
let exitRequested = false;
|
|
158
|
+
const exit = (): void => {
|
|
159
|
+
exitRequested = true;
|
|
160
|
+
if (stderrInFlight === 0) {
|
|
161
|
+
process.exit(Number(process.exitCode ?? 0));
|
|
162
|
+
}
|
|
163
|
+
};
|
|
164
|
+
|
|
145
165
|
// Helper: write info to stderr (respects -s)
|
|
146
166
|
const writeInfo = (msg: string): void => {
|
|
147
|
-
if (
|
|
148
|
-
|
|
167
|
+
if (opts.silent) {
|
|
168
|
+
return;
|
|
149
169
|
}
|
|
170
|
+
stderrInFlight += 1;
|
|
171
|
+
process.stderr.write(msg + "\n", () => {
|
|
172
|
+
stderrInFlight -= 1;
|
|
173
|
+
if (exitRequested) {
|
|
174
|
+
exit();
|
|
175
|
+
}
|
|
176
|
+
});
|
|
150
177
|
};
|
|
151
178
|
|
|
152
179
|
try {
|
|
@@ -232,17 +259,18 @@ export async function runAuthenticatedRequest(params: {
|
|
|
232
259
|
// reported the way every other failure here is, so `--json` gets its
|
|
233
260
|
// envelope and the caller's diagnostics hint is not lost; only the
|
|
234
261
|
// exit code comes from the route's status.
|
|
235
|
-
writeError(cmd, `${err.message}\n\n${params.diagnosticsHint}`);
|
|
236
262
|
process.exitCode = exitCodeFromIpcResult({
|
|
237
263
|
statusCode: err.statusCode,
|
|
238
264
|
});
|
|
265
|
+
writeError(cmd, `${err.message}\n\n${params.diagnosticsHint}`, exit);
|
|
239
266
|
return;
|
|
240
267
|
}
|
|
241
268
|
throw err;
|
|
242
269
|
}
|
|
243
270
|
|
|
244
|
-
//
|
|
245
|
-
|
|
271
|
+
// The route's verdict, not the status code: a provider that reports
|
|
272
|
+
// failure inside a 2xx (Slack's `ok: false`) is a failed request.
|
|
273
|
+
if (!result.ok) {
|
|
246
274
|
process.exitCode = 1;
|
|
247
275
|
}
|
|
248
276
|
|
|
@@ -261,7 +289,7 @@ export async function runAuthenticatedRequest(params: {
|
|
|
261
289
|
|
|
262
290
|
// JSON output mode
|
|
263
291
|
if (jsonMode) {
|
|
264
|
-
writeOutput(cmd, result);
|
|
292
|
+
writeOutput(cmd, result, exit);
|
|
265
293
|
return;
|
|
266
294
|
}
|
|
267
295
|
|
|
@@ -282,20 +310,23 @@ export async function runAuthenticatedRequest(params: {
|
|
|
282
310
|
if (output) {
|
|
283
311
|
if (opts.output) {
|
|
284
312
|
writeFileSync(opts.output, output.bytes);
|
|
313
|
+
} else if (output.isBinary) {
|
|
314
|
+
process.stdout.write(output.bytes, exit);
|
|
315
|
+
return;
|
|
285
316
|
} else {
|
|
286
317
|
process.stdout.write(output.bytes);
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
}
|
|
318
|
+
process.stdout.write("\n", exit);
|
|
319
|
+
return;
|
|
290
320
|
}
|
|
291
321
|
}
|
|
292
322
|
} else if (opts.output) {
|
|
293
323
|
writeFileSync(opts.output, Buffer.alloc(0));
|
|
294
324
|
}
|
|
325
|
+
exit();
|
|
295
326
|
} catch (err) {
|
|
296
327
|
const message = err instanceof Error ? err.message : String(err);
|
|
297
|
-
writeError(cmd, `${message}\n\n${params.diagnosticsHint}`);
|
|
298
328
|
process.exitCode = 1;
|
|
329
|
+
writeError(cmd, `${message}\n\n${params.diagnosticsHint}`, exit);
|
|
299
330
|
}
|
|
300
331
|
}
|
|
301
332
|
|
|
@@ -40,6 +40,8 @@ interface ConnectionSummary {
|
|
|
40
40
|
status: string;
|
|
41
41
|
expiresAt?: string | null;
|
|
42
42
|
hasRefreshToken?: boolean;
|
|
43
|
+
/** Values the provider scopes the connection by (QuickBooks' realm id). */
|
|
44
|
+
providerParams?: Record<string, string>;
|
|
43
45
|
}
|
|
44
46
|
|
|
45
47
|
interface OAuthStatusResponse {
|
|
@@ -92,6 +94,9 @@ function formatConnection(c: ConnectionSummary, mode: string): string {
|
|
|
92
94
|
} else {
|
|
93
95
|
lines.push(` Granted scopes: (none)`);
|
|
94
96
|
}
|
|
97
|
+
for (const [key, value] of Object.entries(c.providerParams ?? {})) {
|
|
98
|
+
lines.push(` ${key}: ${value}`);
|
|
99
|
+
}
|
|
95
100
|
if (mode === "byo") {
|
|
96
101
|
if (c.expiresAt) {
|
|
97
102
|
lines.push(` Expires: ${c.expiresAt}`);
|