@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
|
@@ -30,7 +30,8 @@ mock.module("./api.js", () => ({
|
|
|
30
30
|
}));
|
|
31
31
|
|
|
32
32
|
const { TelegramNonRetryableError } = await import("./api.js");
|
|
33
|
-
const { sendTelegramReply, sendTelegramRichReply } =
|
|
33
|
+
const { editTelegramMessage, sendTelegramReply, sendTelegramRichReply } =
|
|
34
|
+
await import("./send.js");
|
|
34
35
|
const { telegramTransport } = await import("./transport.js");
|
|
35
36
|
|
|
36
37
|
const approval: ApprovalUIMetadata = {
|
|
@@ -191,15 +192,15 @@ describe("telegramTransport.deliver routing", () => {
|
|
|
191
192
|
} as ChannelReplyPayload;
|
|
192
193
|
}
|
|
193
194
|
|
|
194
|
-
test("routes to the rich send when
|
|
195
|
-
await telegramTransport.deliver(ctx, payload({
|
|
195
|
+
test("routes to the rich send when a rich render is asked for", async () => {
|
|
196
|
+
await telegramTransport.deliver(ctx, payload({ renderRichly: true }));
|
|
196
197
|
|
|
197
198
|
expect(callsTo("sendRichMessage")).toHaveLength(1);
|
|
198
199
|
expect(callsTo("sendMessage")).toHaveLength(0);
|
|
199
200
|
});
|
|
200
201
|
|
|
201
|
-
test("stays on the plain send when
|
|
202
|
-
await telegramTransport.deliver(ctx, payload({
|
|
202
|
+
test("stays on the plain send when it is not", async () => {
|
|
203
|
+
await telegramTransport.deliver(ctx, payload({ renderRichly: false }));
|
|
203
204
|
|
|
204
205
|
expect(callsTo("sendRichMessage")).toHaveLength(0);
|
|
205
206
|
expect(callsTo("sendMessage")).toHaveLength(1);
|
|
@@ -208,7 +209,7 @@ describe("telegramTransport.deliver routing", () => {
|
|
|
208
209
|
test("forwards approval metadata through the rich path", async () => {
|
|
209
210
|
await telegramTransport.deliver(
|
|
210
211
|
ctx,
|
|
211
|
-
payload({
|
|
212
|
+
payload({ renderRichly: true, approval } as Partial<ChannelReplyPayload>),
|
|
212
213
|
);
|
|
213
214
|
|
|
214
215
|
expect(callTelegramBotApiMock).toHaveBeenCalledWith("sendRichMessage", {
|
|
@@ -238,7 +239,7 @@ describe("telegramTransport topic targeting", () => {
|
|
|
238
239
|
}
|
|
239
240
|
|
|
240
241
|
test("plain replies target the topic from the callback threadId param", async () => {
|
|
241
|
-
await telegramTransport.deliver(topicCtx, payload({
|
|
242
|
+
await telegramTransport.deliver(topicCtx, payload({ renderRichly: false }));
|
|
242
243
|
|
|
243
244
|
expect(callTelegramBotApiMock).toHaveBeenCalledWith("sendMessage", {
|
|
244
245
|
chat_id: "123",
|
|
@@ -248,7 +249,7 @@ describe("telegramTransport topic targeting", () => {
|
|
|
248
249
|
});
|
|
249
250
|
|
|
250
251
|
test("rich replies target the topic", async () => {
|
|
251
|
-
await telegramTransport.deliver(topicCtx, payload({
|
|
252
|
+
await telegramTransport.deliver(topicCtx, payload({ renderRichly: true }));
|
|
252
253
|
|
|
253
254
|
expect(callTelegramBotApiMock).toHaveBeenCalledWith("sendRichMessage", {
|
|
254
255
|
chat_id: "123",
|
|
@@ -262,7 +263,7 @@ describe("telegramTransport topic targeting", () => {
|
|
|
262
263
|
throw new TelegramNonRetryableError("rejected", "rejected");
|
|
263
264
|
});
|
|
264
265
|
|
|
265
|
-
await telegramTransport.deliver(topicCtx, payload({
|
|
266
|
+
await telegramTransport.deliver(topicCtx, payload({ renderRichly: true }));
|
|
266
267
|
|
|
267
268
|
expect(callTelegramBotApiMock).toHaveBeenNthCalledWith(2, "sendMessage", {
|
|
268
269
|
chat_id: "123",
|
|
@@ -272,10 +273,10 @@ describe("telegramTransport topic targeting", () => {
|
|
|
272
273
|
});
|
|
273
274
|
|
|
274
275
|
test("typing indicators target the topic", async () => {
|
|
275
|
-
await telegramTransport.
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
);
|
|
276
|
+
await telegramTransport.setActivity!(topicCtx, {
|
|
277
|
+
chatId: "123",
|
|
278
|
+
phase: "thinking",
|
|
279
|
+
});
|
|
279
280
|
|
|
280
281
|
expect(callTelegramBotApiMock).toHaveBeenCalledWith("sendChatAction", {
|
|
281
282
|
chat_id: "123",
|
|
@@ -284,17 +285,32 @@ describe("telegramTransport topic targeting", () => {
|
|
|
284
285
|
});
|
|
285
286
|
});
|
|
286
287
|
|
|
288
|
+
// Telegram's chat action expires on its own, so a phase that is not running
|
|
289
|
+
// has nothing to say. Asserting the call count rather than the absence of a
|
|
290
|
+
// "stop" call is what catches a clearing request being invented later.
|
|
291
|
+
test.each(["idle", "awaiting_confirmation"] as const)(
|
|
292
|
+
"says nothing to Telegram for the %s phase",
|
|
293
|
+
async (phase) => {
|
|
294
|
+
await telegramTransport.setActivity!(topicCtx, {
|
|
295
|
+
chatId: "123",
|
|
296
|
+
phase,
|
|
297
|
+
});
|
|
298
|
+
|
|
299
|
+
expect(callTelegramBotApiMock).not.toHaveBeenCalled();
|
|
300
|
+
},
|
|
301
|
+
);
|
|
302
|
+
|
|
287
303
|
test("a callback URL without threadId keeps sends thread-less", async () => {
|
|
288
304
|
const bareCtx: CallbackContext = {
|
|
289
305
|
callbackUrl: "/deliver/telegram",
|
|
290
306
|
params: {},
|
|
291
307
|
};
|
|
292
308
|
|
|
293
|
-
await telegramTransport.deliver(bareCtx, payload({
|
|
294
|
-
await telegramTransport.
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
);
|
|
309
|
+
await telegramTransport.deliver(bareCtx, payload({ renderRichly: false }));
|
|
310
|
+
await telegramTransport.setActivity!(bareCtx, {
|
|
311
|
+
chatId: "123",
|
|
312
|
+
phase: "thinking",
|
|
313
|
+
});
|
|
298
314
|
|
|
299
315
|
expect(callTelegramBotApiMock).toHaveBeenCalledWith("sendMessage", {
|
|
300
316
|
chat_id: "123",
|
|
@@ -306,3 +322,57 @@ describe("telegramTransport topic targeting", () => {
|
|
|
306
322
|
});
|
|
307
323
|
});
|
|
308
324
|
});
|
|
325
|
+
|
|
326
|
+
describe("editTelegramMessage", () => {
|
|
327
|
+
const ctx = { callbackUrl: "http://gw/deliver/telegram", params: {} };
|
|
328
|
+
|
|
329
|
+
const sendMessageCalls = () =>
|
|
330
|
+
callTelegramBotApiMock.mock.calls.filter(
|
|
331
|
+
(call) => call[0] === "sendMessage",
|
|
332
|
+
);
|
|
333
|
+
|
|
334
|
+
test("edits in place and never posts a new message", async () => {
|
|
335
|
+
await telegramTransport.edit!(ctx as CallbackContext, {
|
|
336
|
+
chatId: "123",
|
|
337
|
+
messageId: "456",
|
|
338
|
+
text: "revised",
|
|
339
|
+
});
|
|
340
|
+
|
|
341
|
+
expect(callTelegramBotApiMock).toHaveBeenCalledTimes(1);
|
|
342
|
+
const [method, body] = callTelegramBotApiMock.mock.calls[0]!;
|
|
343
|
+
expect(method).toBe("editMessageText");
|
|
344
|
+
// Telegram wants a numeric message id, where the capability carries the
|
|
345
|
+
// channel's id as a string.
|
|
346
|
+
expect(body).toEqual({ chat_id: "123", message_id: 456, text: "revised" });
|
|
347
|
+
});
|
|
348
|
+
|
|
349
|
+
test("treats an unchanged message as already done", async () => {
|
|
350
|
+
callTelegramBotApiMock.mockImplementationOnce(async () => {
|
|
351
|
+
throw new TelegramNonRetryableError(
|
|
352
|
+
"Bad Request",
|
|
353
|
+
"Bad Request: message is not modified",
|
|
354
|
+
);
|
|
355
|
+
});
|
|
356
|
+
|
|
357
|
+
// The edit asked for a state the message is already in, which is the
|
|
358
|
+
// request satisfied rather than refused.
|
|
359
|
+
await expect(
|
|
360
|
+
editTelegramMessage("123", "456", "same"),
|
|
361
|
+
).resolves.toBeUndefined();
|
|
362
|
+
expect(sendMessageCalls()).toHaveLength(0);
|
|
363
|
+
});
|
|
364
|
+
|
|
365
|
+
test("throws on any other rejection rather than posting a replacement", async () => {
|
|
366
|
+
callTelegramBotApiMock.mockImplementationOnce(async () => {
|
|
367
|
+
throw new TelegramNonRetryableError(
|
|
368
|
+
"Bad Request",
|
|
369
|
+
"Bad Request: message to edit not found",
|
|
370
|
+
);
|
|
371
|
+
});
|
|
372
|
+
|
|
373
|
+
// Posting instead would leave the original beside a duplicate, so the
|
|
374
|
+
// failure has to reach the caller.
|
|
375
|
+
await expect(editTelegramMessage("123", "456", "gone")).rejects.toThrow();
|
|
376
|
+
expect(sendMessageCalls()).toHaveLength(0);
|
|
377
|
+
});
|
|
378
|
+
});
|
|
@@ -137,6 +137,42 @@ export interface TelegramSendResult {
|
|
|
137
137
|
* Send a Telegram text reply, splitting long messages and optionally
|
|
138
138
|
* attaching inline keyboard buttons for approval prompts.
|
|
139
139
|
*/
|
|
140
|
+
/**
|
|
141
|
+
* Replace a Telegram message in place.
|
|
142
|
+
*
|
|
143
|
+
* Telegram rejects an edit whose text already matches the message. That is the
|
|
144
|
+
* request having been satisfied rather than a failure, so it resolves. Every
|
|
145
|
+
* other rejection throws: an edit that quietly became a new message would
|
|
146
|
+
* leave the original sitting beside it, which reads as answering twice.
|
|
147
|
+
*
|
|
148
|
+
* Unlike a send, this cannot split long text across messages, because an edit
|
|
149
|
+
* addresses exactly one. Telegram rejects text past its limit, and that
|
|
150
|
+
* rejection reaches the caller rather than being papered over.
|
|
151
|
+
*/
|
|
152
|
+
export async function editTelegramMessage(
|
|
153
|
+
chatId: string,
|
|
154
|
+
messageId: string,
|
|
155
|
+
text: string,
|
|
156
|
+
): Promise<void> {
|
|
157
|
+
try {
|
|
158
|
+
await callTelegramBotApi<TelegramMessage>("editMessageText", {
|
|
159
|
+
chat_id: chatId,
|
|
160
|
+
message_id: Number(messageId),
|
|
161
|
+
text,
|
|
162
|
+
});
|
|
163
|
+
} catch (err) {
|
|
164
|
+
if (
|
|
165
|
+
err instanceof TelegramNonRetryableError &&
|
|
166
|
+
err.description?.includes("message is not modified")
|
|
167
|
+
) {
|
|
168
|
+
log.debug({ chatId, messageId }, "Telegram edit already applied");
|
|
169
|
+
return;
|
|
170
|
+
}
|
|
171
|
+
throw err;
|
|
172
|
+
}
|
|
173
|
+
log.debug({ chatId, messageId }, "Telegram message edited");
|
|
174
|
+
}
|
|
175
|
+
|
|
140
176
|
export async function sendTelegramReply(
|
|
141
177
|
chatId: string,
|
|
142
178
|
text: string,
|
|
@@ -5,8 +5,10 @@ import type {
|
|
|
5
5
|
CallbackContext,
|
|
6
6
|
ChannelTransport,
|
|
7
7
|
} from "../channel-transport.js";
|
|
8
|
+
import { isBusyActivityPhase } from "../channel-transport.js";
|
|
8
9
|
import type { TelegramSendOptions } from "./send.js";
|
|
9
10
|
import {
|
|
11
|
+
editTelegramMessage,
|
|
10
12
|
sendTelegramAttachments,
|
|
11
13
|
sendTelegramReply,
|
|
12
14
|
sendTelegramRichReply,
|
|
@@ -27,16 +29,18 @@ function threadOptions(ctx: CallbackContext): TelegramSendOptions | undefined {
|
|
|
27
29
|
export const telegramTransport: ChannelTransport = {
|
|
28
30
|
channel: "telegram",
|
|
29
31
|
|
|
32
|
+
// Telegram clears a chat action after about five seconds.
|
|
33
|
+
activityRefreshMs: 4_000,
|
|
34
|
+
|
|
30
35
|
async deliver(ctx, payload) {
|
|
31
36
|
const { chatId, text, attachments, approval } = payload;
|
|
32
37
|
const opts = threadOptions(ctx);
|
|
33
38
|
|
|
34
39
|
if (text) {
|
|
35
|
-
//
|
|
36
|
-
//
|
|
37
|
-
//
|
|
38
|
-
|
|
39
|
-
if (payload.useBlocks) {
|
|
40
|
+
// Telegram answers a rich render by forwarding markdown to
|
|
41
|
+
// `sendRichMessage`, degrading to plain text otherwise and on any
|
|
42
|
+
// rich-send rejection.
|
|
43
|
+
if (payload.renderRichly) {
|
|
40
44
|
await sendTelegramRichReply(chatId, text, approval, opts);
|
|
41
45
|
} else {
|
|
42
46
|
await sendTelegramReply(chatId, text, approval, opts);
|
|
@@ -67,10 +71,20 @@ export const telegramTransport: ChannelTransport = {
|
|
|
67
71
|
return { ok: true };
|
|
68
72
|
},
|
|
69
73
|
|
|
70
|
-
async
|
|
71
|
-
await
|
|
74
|
+
async edit(_ctx, target) {
|
|
75
|
+
await editTelegramMessage(target.chatId, target.messageId, target.text);
|
|
76
|
+
return { ok: true };
|
|
77
|
+
},
|
|
78
|
+
|
|
79
|
+
async setActivity(ctx, target) {
|
|
80
|
+
// Telegram's chat action expires by itself after a few seconds, so a phase
|
|
81
|
+
// that is not running needs no clearing call.
|
|
82
|
+
if (!isBusyActivityPhase(target.phase)) {
|
|
83
|
+
return { ok: true };
|
|
84
|
+
}
|
|
85
|
+
await sendTelegramTypingIndicator(target.chatId, threadOptions(ctx));
|
|
72
86
|
log.debug(
|
|
73
|
-
{ chatId:
|
|
87
|
+
{ chatId: target.chatId, phase: target.phase },
|
|
74
88
|
"Telegram typing indicator delivered (direct)",
|
|
75
89
|
);
|
|
76
90
|
return { ok: true };
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
import { describe, expect, it } from "bun:test";
|
|
2
|
+
|
|
3
|
+
import {
|
|
4
|
+
groupingMessageId,
|
|
5
|
+
type ProviderMessageMetadata,
|
|
6
|
+
} from "./provider-message-metadata.js";
|
|
7
|
+
import type { SlackMessageMetadata } from "./providers/slack/message-metadata.js";
|
|
8
|
+
import { readProviderMetadata } from "./read-provider-metadata.js";
|
|
9
|
+
|
|
10
|
+
const CHANNEL = "C0123CHANNEL";
|
|
11
|
+
const MESSAGE_TS = "1700000000.000100";
|
|
12
|
+
const TARGET_TS = "1699999999.000001";
|
|
13
|
+
|
|
14
|
+
function slackRow(
|
|
15
|
+
overrides: Partial<SlackMessageMetadata> = {},
|
|
16
|
+
): SlackMessageMetadata {
|
|
17
|
+
return {
|
|
18
|
+
source: "slack",
|
|
19
|
+
channelId: CHANNEL,
|
|
20
|
+
channelTs: MESSAGE_TS,
|
|
21
|
+
eventKind: "message",
|
|
22
|
+
...overrides,
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
describe("readProviderMetadata", () => {
|
|
27
|
+
it("reads a row that only has the legacy Slack envelope", () => {
|
|
28
|
+
// Slack's own envelope is mapped on read, so no row is rewritten.
|
|
29
|
+
const metadata = JSON.stringify({
|
|
30
|
+
slackMeta: JSON.stringify(slackRow({ threadTs: TARGET_TS })),
|
|
31
|
+
});
|
|
32
|
+
|
|
33
|
+
expect(readProviderMetadata(metadata)).toEqual({
|
|
34
|
+
source: "slack",
|
|
35
|
+
conversationExternalId: CHANNEL,
|
|
36
|
+
messageId: MESSAGE_TS,
|
|
37
|
+
threadId: TARGET_TS,
|
|
38
|
+
eventKind: "message",
|
|
39
|
+
} satisfies ProviderMessageMetadata);
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
it("carries the actor's provider id, not just a display name", () => {
|
|
43
|
+
// Trust is keyed on the actor everywhere else, and a channel describing
|
|
44
|
+
// who reacted needs an identity rather than a label.
|
|
45
|
+
const metadata = JSON.stringify({
|
|
46
|
+
slackMeta: JSON.stringify(
|
|
47
|
+
slackRow({ actorExternalUserId: "U0123", displayName: "Jason" }),
|
|
48
|
+
),
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
const meta = readProviderMetadata(metadata);
|
|
52
|
+
expect(meta?.actorExternalId).toBe("U0123");
|
|
53
|
+
expect(meta?.displayName).toBe("Jason");
|
|
54
|
+
});
|
|
55
|
+
|
|
56
|
+
it("maps a reaction's target onto the neutral name", () => {
|
|
57
|
+
const metadata = JSON.stringify({
|
|
58
|
+
slackMeta: JSON.stringify(
|
|
59
|
+
slackRow({
|
|
60
|
+
eventKind: "reaction",
|
|
61
|
+
reaction: {
|
|
62
|
+
emoji: "thumbsup",
|
|
63
|
+
targetChannelTs: TARGET_TS,
|
|
64
|
+
op: "added",
|
|
65
|
+
actorDisplayName: "Jason",
|
|
66
|
+
},
|
|
67
|
+
}),
|
|
68
|
+
),
|
|
69
|
+
});
|
|
70
|
+
|
|
71
|
+
const meta = readProviderMetadata(metadata);
|
|
72
|
+
expect(meta?.eventKind).toBe("reaction");
|
|
73
|
+
// No channel gives a reaction an id of its own, so the row must not claim
|
|
74
|
+
// its target's: two rows sharing one id break resolution by message id.
|
|
75
|
+
expect(meta?.messageId).toBeUndefined();
|
|
76
|
+
expect(meta?.reaction).toEqual({
|
|
77
|
+
targetMessageId: TARGET_TS,
|
|
78
|
+
emoji: "thumbsup",
|
|
79
|
+
op: "added",
|
|
80
|
+
actorDisplayName: "Jason",
|
|
81
|
+
});
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
it("leaves threadId absent when the row is not in a thread", () => {
|
|
85
|
+
// A thread id here asserts that a thread exists. Synthesizing one from
|
|
86
|
+
// the message's own id is what keyed conversations on threads that never
|
|
87
|
+
// did (LUM-3330, LUM-3340), so absence has to survive the mapping.
|
|
88
|
+
const metadata = JSON.stringify({
|
|
89
|
+
slackMeta: JSON.stringify(slackRow()),
|
|
90
|
+
});
|
|
91
|
+
|
|
92
|
+
const meta = readProviderMetadata(metadata);
|
|
93
|
+
expect(meta).not.toBeNull();
|
|
94
|
+
expect(meta?.threadId).toBeUndefined();
|
|
95
|
+
expect(meta?.messageId).toBe(MESSAGE_TS);
|
|
96
|
+
});
|
|
97
|
+
|
|
98
|
+
it("reads a channel this repo has no code for", () => {
|
|
99
|
+
// The point of the neutral shape. A plugin channel cannot add an adapter
|
|
100
|
+
// here, so it describes its own rows directly and every channel-agnostic
|
|
101
|
+
// reader understands them with no Vellum code naming that channel.
|
|
102
|
+
const metadata = JSON.stringify({
|
|
103
|
+
providerMeta: JSON.stringify({
|
|
104
|
+
source: "plugin",
|
|
105
|
+
conversationExternalId: "room-42",
|
|
106
|
+
messageId: "evt-9",
|
|
107
|
+
threadId: "evt-1",
|
|
108
|
+
eventKind: "reaction",
|
|
109
|
+
reaction: {
|
|
110
|
+
targetMessageId: "evt-1",
|
|
111
|
+
emoji: "tada",
|
|
112
|
+
op: "added",
|
|
113
|
+
},
|
|
114
|
+
} satisfies ProviderMessageMetadata),
|
|
115
|
+
});
|
|
116
|
+
|
|
117
|
+
const meta = readProviderMetadata(metadata);
|
|
118
|
+
expect(meta?.source).toBe("plugin");
|
|
119
|
+
expect(meta?.reaction?.targetMessageId).toBe("evt-1");
|
|
120
|
+
// Grouping is what history assembly keys on, so a reaction from an
|
|
121
|
+
// unknown channel lands beside the message it was attached to.
|
|
122
|
+
expect(groupingMessageId(meta!)).toBe("evt-1");
|
|
123
|
+
});
|
|
124
|
+
|
|
125
|
+
it("groups a message by its own id", () => {
|
|
126
|
+
const metadata = JSON.stringify({
|
|
127
|
+
slackMeta: JSON.stringify(slackRow()),
|
|
128
|
+
});
|
|
129
|
+
|
|
130
|
+
expect(groupingMessageId(readProviderMetadata(metadata)!)).toBe(MESSAGE_TS);
|
|
131
|
+
});
|
|
132
|
+
|
|
133
|
+
it("keeps provider fields the neutral schema does not name", () => {
|
|
134
|
+
// The schema passes through, so a channel can carry its own fields on the
|
|
135
|
+
// same object instead of getting a second envelope.
|
|
136
|
+
const metadata = JSON.stringify({
|
|
137
|
+
providerMeta: JSON.stringify({
|
|
138
|
+
source: "slack",
|
|
139
|
+
conversationExternalId: CHANNEL,
|
|
140
|
+
messageId: MESSAGE_TS,
|
|
141
|
+
eventKind: "message",
|
|
142
|
+
slackFiles: [{ name: "diagram.png" }],
|
|
143
|
+
}),
|
|
144
|
+
});
|
|
145
|
+
|
|
146
|
+
expect(
|
|
147
|
+
(readProviderMetadata(metadata) as Record<string, unknown> | null)
|
|
148
|
+
?.slackFiles,
|
|
149
|
+
).toEqual([{ name: "diagram.png" }]);
|
|
150
|
+
});
|
|
151
|
+
|
|
152
|
+
it("reads as null when the row carries neither envelope", () => {
|
|
153
|
+
expect(readProviderMetadata(JSON.stringify({ other: 1 }))).toBeNull();
|
|
154
|
+
expect(readProviderMetadata("not json")).toBeNull();
|
|
155
|
+
expect(readProviderMetadata(null)).toBeNull();
|
|
156
|
+
});
|
|
157
|
+
});
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { safeParseRecord } from "../util/json.js";
|
|
2
|
+
import {
|
|
3
|
+
type ProviderMessageMetadata,
|
|
4
|
+
readProviderMessageMetadata,
|
|
5
|
+
} from "./provider-message-metadata.js";
|
|
6
|
+
import {
|
|
7
|
+
readSlackMetadataFromMessageMetadata,
|
|
8
|
+
slackMetadataAsProviderMetadata,
|
|
9
|
+
} from "./providers/slack/message-metadata.js";
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* Read a stored row's channel metadata in terms no single provider owns.
|
|
13
|
+
*
|
|
14
|
+
* Two ways a row can carry it, in this order.
|
|
15
|
+
*
|
|
16
|
+
* `providerMeta` is the neutral shape written directly. This is the path that
|
|
17
|
+
* matters most: a channel we have no code for, a plugin channel above all,
|
|
18
|
+
* can describe its own rows in it and every channel-agnostic reader
|
|
19
|
+
* understands them. History assembly, the conversation route and the
|
|
20
|
+
* transcript renderer then work for a channel nobody here has heard of.
|
|
21
|
+
*
|
|
22
|
+
* `slackMeta` is Slack's own envelope, mapped on read. It holds fields no
|
|
23
|
+
* other channel has an equivalent for, so Slack keeps writing it and loses
|
|
24
|
+
* nothing. A channel that writes `providerMeta` needs no adapter at all.
|
|
25
|
+
*
|
|
26
|
+
* Normalizing on read is what allows both. Writing stays where provider
|
|
27
|
+
* detail legitimately lives, and nothing is stored twice.
|
|
28
|
+
*
|
|
29
|
+
* A row with no recognized envelope, or one that fails validation, reads as
|
|
30
|
+
* null: callers already treat absent metadata as "not a channel row".
|
|
31
|
+
*/
|
|
32
|
+
export function readProviderMetadata(
|
|
33
|
+
metadata: string | null | undefined,
|
|
34
|
+
opts?: { allowFlatLegacy?: boolean },
|
|
35
|
+
): ProviderMessageMetadata | null {
|
|
36
|
+
if (!metadata) {
|
|
37
|
+
return null;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
// Malformed neutral metadata falls through to the provider envelopes rather
|
|
41
|
+
// than failing the read outright.
|
|
42
|
+
const neutral = readProviderMessageMetadata(
|
|
43
|
+
safeParseRecord(metadata).providerMeta,
|
|
44
|
+
);
|
|
45
|
+
if (neutral) {
|
|
46
|
+
return neutral;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
const slackMeta = readSlackMetadataFromMessageMetadata(metadata, opts);
|
|
50
|
+
return slackMeta ? slackMetadataAsProviderMetadata(slackMeta) : null;
|
|
51
|
+
}
|
|
@@ -94,6 +94,23 @@ mock.module("../../runtime/desktop-presence.js", () => ({
|
|
|
94
94
|
},
|
|
95
95
|
}));
|
|
96
96
|
|
|
97
|
+
// Defaults to unfocused, so every other case in this file exercises the
|
|
98
|
+
// unsuppressed path.
|
|
99
|
+
let webFocused = false;
|
|
100
|
+
let webPresenceShouldThrow = false;
|
|
101
|
+
const webPresenceArgs: unknown[][] = [];
|
|
102
|
+
const realWebPresence = await import("../../runtime/web-presence.js");
|
|
103
|
+
mock.module("../../runtime/web-presence.js", () => ({
|
|
104
|
+
...realWebPresence,
|
|
105
|
+
isWebConversationFocused: (...args: unknown[]) => {
|
|
106
|
+
webPresenceArgs.push(args);
|
|
107
|
+
if (webPresenceShouldThrow) {
|
|
108
|
+
throw new Error("simulated presence read failure");
|
|
109
|
+
}
|
|
110
|
+
return webFocused;
|
|
111
|
+
},
|
|
112
|
+
}));
|
|
113
|
+
|
|
97
114
|
const realAttentionStore =
|
|
98
115
|
await import("../../persistence/conversation-attention-store.js");
|
|
99
116
|
mock.module("../../persistence/conversation-attention-store.js", () => ({
|
|
@@ -183,6 +200,22 @@ function makeMacOriginatedMessage(): MessageRow {
|
|
|
183
200
|
});
|
|
184
201
|
}
|
|
185
202
|
|
|
203
|
+
/**
|
|
204
|
+
* A turn opened from a plain browser tab, as opposed to the Electron desktop
|
|
205
|
+
* renderer sharing the same web bundle: `client.os` is `"web"` only when
|
|
206
|
+
* `detectClientOs()` fails to resolve an Electron host OS first.
|
|
207
|
+
*/
|
|
208
|
+
function makeWebOriginatedMessage(): MessageRow {
|
|
209
|
+
return makeMessage({
|
|
210
|
+
metadata: JSON.stringify({
|
|
211
|
+
userMessageChannel: "vellum",
|
|
212
|
+
userMessageInterface: "web",
|
|
213
|
+
client: { os: "web" },
|
|
214
|
+
clientOsFromRequest: true,
|
|
215
|
+
}),
|
|
216
|
+
});
|
|
217
|
+
}
|
|
218
|
+
|
|
186
219
|
function makeAssistantRow(content: ContentBlock[]): MessageRow {
|
|
187
220
|
return makeMessage({
|
|
188
221
|
id: ASSISTANT_MESSAGE_ID,
|
|
@@ -250,9 +283,12 @@ beforeEach(() => {
|
|
|
250
283
|
messageLookups.length = 0;
|
|
251
284
|
attachmentLookups.length = 0;
|
|
252
285
|
desktopPresenceArgs.length = 0;
|
|
286
|
+
webPresenceArgs.length = 0;
|
|
253
287
|
assistantAttachments = [];
|
|
254
288
|
desktopAttended = false;
|
|
255
289
|
desktopPresenceShouldThrow = false;
|
|
290
|
+
webFocused = false;
|
|
291
|
+
webPresenceShouldThrow = false;
|
|
256
292
|
getConversationShouldThrow = false;
|
|
257
293
|
conversationRow = makeConversation();
|
|
258
294
|
assistantRow = makeAssistantRow([
|
|
@@ -433,6 +469,64 @@ describe("emitAssistantReplyNotification", () => {
|
|
|
433
469
|
});
|
|
434
470
|
});
|
|
435
471
|
|
|
472
|
+
// Same pre-gate as "desktop presence" above, scoped to a browser tab
|
|
473
|
+
// instead of the whole app.
|
|
474
|
+
describe("web presence", () => {
|
|
475
|
+
beforeEach(() => {
|
|
476
|
+
initiatingRow = makeWebOriginatedMessage();
|
|
477
|
+
webFocused = true;
|
|
478
|
+
});
|
|
479
|
+
|
|
480
|
+
test("marks the signal source-active while a web tab reports itself focused on this conversation", async () => {
|
|
481
|
+
await run();
|
|
482
|
+
|
|
483
|
+
expect(emitCalls).toHaveLength(1);
|
|
484
|
+
expect(emitCalls[0].attentionHints.visibleInSourceNow).toBe(true);
|
|
485
|
+
// Scoped to this conversation, unlike desktop attendance: a focused tab
|
|
486
|
+
// only speaks for the conversation it is actually looking at.
|
|
487
|
+
expect(webPresenceArgs).toEqual([[CONVERSATION_ID]]);
|
|
488
|
+
});
|
|
489
|
+
|
|
490
|
+
test("leaves the signal live when no web tab is focused on this conversation", async () => {
|
|
491
|
+
webFocused = false;
|
|
492
|
+
|
|
493
|
+
await run();
|
|
494
|
+
|
|
495
|
+
expect(emitCalls).toHaveLength(1);
|
|
496
|
+
expect(emitCalls[0].attentionHints.visibleInSourceNow).toBe(false);
|
|
497
|
+
});
|
|
498
|
+
|
|
499
|
+
test("leaves the signal live when the web presence flag is off", async () => {
|
|
500
|
+
setOverridesForTesting({ "web-presence-suppression": false });
|
|
501
|
+
|
|
502
|
+
await run();
|
|
503
|
+
|
|
504
|
+
expect(emitCalls).toHaveLength(1);
|
|
505
|
+
expect(emitCalls[0].attentionHints.visibleInSourceNow).toBe(false);
|
|
506
|
+
expect(webPresenceArgs).toEqual([]);
|
|
507
|
+
});
|
|
508
|
+
|
|
509
|
+
test("leaves the signal live when the web presence read throws", async () => {
|
|
510
|
+
webPresenceShouldThrow = true;
|
|
511
|
+
|
|
512
|
+
await run();
|
|
513
|
+
|
|
514
|
+
expect(emitCalls).toHaveLength(1);
|
|
515
|
+
expect(emitCalls[0].attentionHints.visibleInSourceNow).toBe(false);
|
|
516
|
+
expect(warnCalls).toHaveLength(1);
|
|
517
|
+
});
|
|
518
|
+
|
|
519
|
+
test("marks the signal source-active for a turn opened from the macOS app when a web tab is focused here", async () => {
|
|
520
|
+
initiatingRow = makeMacOriginatedMessage();
|
|
521
|
+
|
|
522
|
+
await run();
|
|
523
|
+
|
|
524
|
+
expect(emitCalls).toHaveLength(1);
|
|
525
|
+
expect(emitCalls[0].attentionHints.visibleInSourceNow).toBe(true);
|
|
526
|
+
expect(webPresenceArgs).toEqual([[CONVERSATION_ID]]);
|
|
527
|
+
});
|
|
528
|
+
});
|
|
529
|
+
|
|
436
530
|
test("omits requestedTitle when the conversation has no title", async () => {
|
|
437
531
|
conversationRow = makeConversation({ title: " " });
|
|
438
532
|
|