npm - @vellumai/assistant - Versions diffs - 0.8.7 → 0.8.8 - Mend

@vellumai/assistant 0.8.7 → 0.8.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (387) hide show

package/Dockerfile +20 -4
package/docker-entrypoint.sh +4 -2
package/docker-init-apt-root.sh +3 -1
package/docker-kata-apt-env.sh +3 -1
package/docker-kata-runtime-family.sh +12 -0
package/docs/architecture/memory.md +1 -1
package/docs/plugins.md +75 -79
package/examples/plugins/echo/README.md +6 -12
package/examples/plugins/echo/register.ts +0 -41
package/node_modules/@vellumai/skill-host-contracts/src/server-message.ts +3 -3
package/openapi.yaml +3381 -348
package/package.json +1 -1
package/scripts/generate-openapi.ts +68 -41
package/src/__tests__/agent-loop-exit-reason.test.ts +34 -39
package/src/__tests__/agent-loop-provider-error-recording.test.ts +1 -1
package/src/__tests__/agent-loop.test.ts +37 -87
package/src/__tests__/agent-wake-disk-pressure-callsite.test.ts +2 -0
package/src/__tests__/annotate-activity-metadata.test.ts +262 -0
package/src/__tests__/annotate-risk-options.test.ts +2 -3
package/src/__tests__/anthropic-provider.test.ts +95 -2
package/src/__tests__/assistant-event-hub.test.ts +25 -0
package/src/__tests__/assistant-events-sse-shed.test.ts +8 -0
package/src/__tests__/{conversation-stream-state.test.ts → assistant-stream-state.test.ts} +252 -91
package/src/__tests__/auth-fallback-events-store.test.ts +116 -0
package/src/__tests__/background-workers-disk-pressure.test.ts +6 -0
package/src/__tests__/btw-routes.test.ts +62 -3
package/src/__tests__/build-persisted-content.test.ts +184 -0
package/src/__tests__/catalog-files.test.ts +1 -1
package/src/__tests__/clawhub-files.test.ts +1 -1
package/src/__tests__/compaction-pipeline.test.ts +1 -1
package/src/__tests__/compaction.benchmark.test.ts +0 -30
package/src/__tests__/config-watcher.test.ts +1 -1
package/src/__tests__/conversation-abort-tool-results.test.ts +57 -19
package/src/__tests__/conversation-agent-loop-disk-pressure.test.ts +6 -2
package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +10 -4
package/src/__tests__/conversation-agent-loop-overflow.test.ts +313 -1136
package/src/__tests__/conversation-agent-loop.test.ts +596 -1616
package/src/__tests__/conversation-analysis-routes.test.ts +6 -0
package/src/__tests__/conversation-history-web-search.test.ts +11 -1
package/src/__tests__/conversation-pairing.test.ts +4 -31
package/src/__tests__/conversation-process-app-control-preactivation.test.ts +6 -0
package/src/__tests__/conversation-provider-retry-repair.test.ts +26 -5
package/src/__tests__/conversation-queue.test.ts +2 -0
package/src/__tests__/conversation-routes-disk-view.test.ts +3 -0
package/src/__tests__/conversation-routes-slash-commands.test.ts +6 -5
package/src/__tests__/conversation-runtime-assembly.test.ts +170 -229
package/src/__tests__/conversation-runtime-workspace.test.ts +3 -24
package/src/__tests__/conversation-slash-commands.test.ts +8 -42
package/src/__tests__/conversation-slash-queue.test.ts +6 -1
package/src/__tests__/conversation-surfaces-action-delivery.test.ts +84 -0
package/src/__tests__/conversation-sync-tags.test.ts +27 -15
package/src/__tests__/conversation-title-service.test.ts +135 -2
package/src/__tests__/conversation-workspace-injection.test.ts +6 -1
package/src/__tests__/cross-provider-web-search.test.ts +214 -1
package/src/__tests__/db-schedule-syntax-migration.test.ts +5 -0
package/src/__tests__/dm-persistence.test.ts +5 -1
package/src/__tests__/empty-response-hook.test.ts +304 -0
package/src/__tests__/feature-flag-test-helpers.ts +2 -2
package/src/__tests__/gemini-image-service.test.ts +13 -0
package/src/__tests__/helpers/mock-provider.ts +110 -0
package/src/__tests__/helpers/native-web-search-harness.ts +129 -0
package/src/__tests__/history-repair-hook.test.ts +1 -0
package/src/__tests__/identity-intro-cache.test.ts +12 -100
package/src/__tests__/identity-routes.test.ts +248 -7
package/src/__tests__/inbound-slack-persistence.test.ts +5 -1
package/src/__tests__/injector-background-turn.test.ts +2 -8
package/src/__tests__/injector-chain.test.ts +106 -270
package/src/__tests__/injector-disk-pressure.test.ts +3 -12
package/src/__tests__/injector-document-comments.test.ts +2 -2
package/src/__tests__/injector-pkb-v2-silenced.test.ts +30 -22
package/src/__tests__/injector-v3-suppression.test.ts +31 -37
package/src/__tests__/internal-telemetry-routes.test.ts +109 -0
package/src/__tests__/list-messages-page-latest.test.ts +60 -0
package/src/__tests__/list-messages-tool-merge.test.ts +20 -0
package/src/__tests__/llm-usage-store.test.ts +223 -1
package/src/__tests__/memory-retrieval-hook.test.ts +297 -0
package/src/__tests__/memory-v2-static-injector.test.ts +103 -35
package/src/__tests__/native-web-search.test.ts +191 -0
package/src/__tests__/onboarding-template-contract.test.ts +2 -0
package/src/__tests__/openai-image-service.test.ts +17 -0
package/src/__tests__/openai-provider.test.ts +31 -1
package/src/__tests__/persist-unsendable-image.test.ts +215 -0
package/src/__tests__/persistence-secret-redaction.test.ts +1 -0
package/src/__tests__/pipeline-runner.test.ts +29 -39
package/src/__tests__/pkb-autoinject.test.ts +2 -5
package/src/__tests__/plugin-bootstrap.test.ts +13 -28
package/src/__tests__/plugin-registry.test.ts +0 -27
package/src/__tests__/plugin-types.test.ts +2 -125
package/src/__tests__/process-message-display-content.test.ts +6 -2
package/src/__tests__/regenerate-fire-and-forget-trace.test.ts +5 -1
package/src/__tests__/resolve-trust-class.test.ts +4 -4
package/src/__tests__/runtime-events-sse-reconnect.test.ts +60 -23
package/src/__tests__/schedule-routes.test.ts +603 -2
package/src/__tests__/schedule-store.test.ts +41 -0
package/src/__tests__/schedule-tools.test.ts +35 -0
package/src/__tests__/server-history-render.test.ts +314 -1
package/src/__tests__/skillssh-files.test.ts +1 -1
package/src/__tests__/system-prompt.test.ts +20 -0
package/src/__tests__/task-scheduler.test.ts +162 -1
package/src/__tests__/terminal-tools.test.ts +6 -1
package/src/__tests__/title-generate-hook.test.ts +319 -0
package/src/__tests__/tool-error-hook.test.ts +278 -0
package/src/__tests__/tool-preview-lifecycle.test.ts +468 -5
package/src/__tests__/tool-result-metadata-plumbing.test.ts +1 -0
package/src/__tests__/tool-result-truncate-hook.test.ts +127 -0
package/src/__tests__/tool-result-truncation.test.ts +0 -2
package/src/__tests__/ui-choice-copy-surfaces.test.ts +254 -0
package/src/__tests__/ui-work-result-surface.test.ts +159 -0
package/src/__tests__/usage-routes.test.ts +285 -1
package/src/__tests__/user-plugin-loader.test.ts +2 -2
package/src/__tests__/voice-session-bridge.test.ts +6 -3
package/src/__tests__/web-search-backend-failure.test.ts +166 -0
package/src/agent/loop.ts +346 -442
package/src/api/events/assistant-thinking-delta.ts +33 -0
package/src/api/events/tool-output-chunk.ts +45 -0
package/src/api/events/tool-use-preview-start.ts +32 -0
package/src/api/events/trace-event.ts +69 -0
package/src/api/index.ts +48 -13
package/src/api/responses/conversation-message.ts +368 -0
package/src/avatar/__tests__/avatar-store.test.ts +34 -29
package/src/cli/commands/__tests__/notifications.test.ts +58 -14
package/src/cli/commands/notifications.ts +112 -60
package/src/config/assistant-feature-flags.ts +22 -11
package/src/config/bundled-skills/app-builder/SKILL.md +3 -20
package/src/config/bundled-skills/app-builder/references/examples/README.md +17 -0
package/src/config/bundled-skills/app-builder/references/examples/expense-tracker.md +515 -0
package/src/config/bundled-skills/app-builder/references/examples/focus-timer.md +342 -0
package/src/config/bundled-skills/app-builder/references/examples/habit-tracker.md +490 -0
package/src/config/bundled-skills/document-editor/SKILL.md +1 -1
package/src/config/bundled-skills/messaging/SKILL.md +0 -7
package/src/config/feature-flag-cache.ts +3 -3
package/src/config/feature-flag-registry.json +35 -3
package/src/config/schemas/__tests__/memory-v2.test.ts +1 -0
package/src/config/schemas/__tests__/memory-v3.test.ts +25 -0
package/src/config/schemas/llm.ts +1 -0
package/src/config/schemas/memory-v2.ts +8 -0
package/src/config/schemas/memory-v3.ts +8 -0
package/src/config/schemas/platform.ts +8 -0
package/src/config/seed-inference-profiles.ts +2 -2
package/src/config/skills.ts +13 -0
package/src/context/compactor.ts +1 -1
package/src/context/strip-injections.ts +122 -0
package/src/context/token-estimator.ts +23 -0
package/src/context/tool-result-truncation.ts +0 -23
package/src/context/window-manager.ts +3 -6
package/src/credential-execution/executable-discovery.ts +16 -0
package/src/daemon/__tests__/conversation-lifecycle-auto-analyze.test.ts +6 -0
package/src/daemon/__tests__/inference-profile-notification.test.ts +153 -0
package/src/daemon/__tests__/native-web-search-metadata.test.ts +10 -8
package/src/daemon/assistant-attachments.ts +1 -1
package/src/daemon/config-watcher.ts +2 -2
package/src/daemon/context-overflow-reducer.ts +0 -1
package/src/daemon/conversation-agent-loop-handlers.ts +605 -153
package/src/daemon/conversation-agent-loop.ts +281 -760
package/src/daemon/conversation-history.ts +5 -4
package/src/daemon/conversation-lifecycle.ts +3 -4
package/src/daemon/conversation-messaging.ts +7 -6
package/src/daemon/conversation-process.ts +11 -16
package/src/daemon/conversation-runtime-assembly.ts +130 -347
package/src/daemon/conversation-slash.ts +6 -25
package/src/daemon/conversation-surfaces.ts +222 -4
package/src/daemon/conversation-tool-setup.ts +2 -29
package/src/daemon/conversation.ts +32 -14
package/src/daemon/external-plugins-bootstrap.ts +9 -10
package/src/daemon/handlers/config-a2a.ts +51 -36
package/src/daemon/handlers/config-slack-channel.ts +20 -14
package/src/daemon/handlers/config-telegram.ts +16 -2
package/src/daemon/handlers/shared.ts +156 -84
package/src/daemon/handlers/skills.ts +39 -10
package/src/daemon/lifecycle.ts +4 -0
package/src/daemon/message-types/apps.ts +1 -29
package/src/daemon/message-types/messages.ts +9 -57
package/src/daemon/message-types/skills.ts +2 -0
package/src/daemon/message-types/surfaces.ts +136 -3
package/src/daemon/now-scratchpad.ts +21 -0
package/src/daemon/orphan-reaper.test.ts +210 -0
package/src/daemon/orphan-reaper.ts +240 -0
package/src/daemon/persist-unsendable-image.ts +117 -0
package/src/daemon/process-message.ts +1 -3
package/src/daemon/trace-emitter.ts +6 -4
package/src/daemon/trust-context.ts +19 -0
package/src/daemon/wake-target-adapter.ts +3 -1
package/src/home/home-greeting-cache.ts +24 -1
package/src/ipc/gateway-client.test.ts +2 -2
package/src/ipc/gateway-client.ts +3 -3
package/src/media/gemini-image-service.ts +15 -0
package/src/media/openai-image-service.ts +14 -0
package/src/media/types.ts +34 -0
package/src/memory/__tests__/jobs-worker-v2-schedule.test.ts +56 -0
package/src/memory/auth-fallback-events-store.ts +94 -0
package/src/memory/conversation-title-service.ts +65 -41
package/src/memory/db-init.ts +4 -0
package/src/memory/graph/__tests__/conversation-graph-memory-registry.test.ts +119 -0
package/src/memory/graph/conversation-graph-memory.ts +65 -0
package/src/memory/jobs-store.ts +33 -0
package/src/memory/jobs-worker.ts +31 -4
package/src/memory/llm-usage-store.ts +224 -50
package/src/memory/migrations/222-strip-placeholder-sentinels-from-messages.ts +6 -5
package/src/memory/migrations/270-schedule-source-conversation.ts +13 -0
package/src/memory/migrations/271-create-auth-fallback-events.ts +21 -0
package/src/memory/migrations/index.ts +2 -0
package/src/memory/pkb/autoinject.ts +61 -0
package/src/memory/pkb/context.ts +50 -0
package/src/memory/pkb/types.ts +14 -0
package/src/memory/schedule-attribution-sql.ts +104 -0
package/src/memory/schema/infrastructure.ts +16 -0
package/src/memory/usage-grouped-buckets.ts +6 -1
package/src/memory/v2/__tests__/consolidation-job.test.ts +1 -1
package/src/memory/v2/consolidation-job.ts +1 -1
package/src/memory/v3/__tests__/health.test.ts +16 -0
package/src/memory/v3/__tests__/orchestrate.test.ts +45 -9
package/src/memory/v3/__tests__/provider-blocks.test.ts +13 -0
package/src/memory/v3/__tests__/router.test.ts +101 -29
package/src/memory/v3/__tests__/selector.test.ts +93 -27
package/src/memory/v3/__tests__/shadow-plugin.test.ts +23 -5
package/src/memory/v3/health.ts +0 -0
package/src/memory/v3/llm-retry.ts +32 -0
package/src/memory/v3/orchestrate.ts +26 -14
package/src/memory/v3/provider-blocks.ts +15 -5
package/src/memory/v3/router.ts +48 -42
package/src/memory/v3/selector.ts +57 -42
package/src/memory/v3/shadow-plugin.ts +47 -15
package/src/memory/v3/types.ts +8 -0
package/src/notifications/conversation-pairing.ts +8 -15
package/src/notifications/decision-engine.ts +6 -3
package/src/notifications/home-feed-side-effect.ts +12 -1
package/src/permissions/prompter.ts +4 -0
package/src/plugin-api/constants.ts +4 -0
package/src/plugin-api/index.ts +8 -1
package/src/plugin-api/types.ts +151 -1
package/src/plugins/defaults/empty-response/hooks/stop.ts +126 -0
package/src/plugins/defaults/empty-response/register.ts +8 -13
package/src/plugins/defaults/index.ts +1 -15
package/src/plugins/defaults/injectors/register.ts +243 -74
package/src/plugins/defaults/memory-retrieval/hooks/post-compact.ts +91 -0
package/src/plugins/defaults/memory-retrieval/hooks/user-prompt-submit-temp.ts +216 -0
package/src/plugins/defaults/memory-retrieval/injector-chain.ts +35 -0
package/src/plugins/defaults/title-generate/hooks/stop.ts +75 -0
package/src/plugins/defaults/title-generate/hooks/user-prompt-submit.ts +35 -0
package/src/plugins/defaults/title-generate/package.json +1 -1
package/src/plugins/defaults/title-generate/register.ts +18 -18
package/src/plugins/defaults/tool-error/hooks/post-tool-use.ts +118 -0
package/src/plugins/defaults/tool-error/package.json +1 -1
package/src/plugins/defaults/tool-error/register.ts +9 -21
package/src/plugins/defaults/tool-result-truncate/hooks/post-tool-use.ts +32 -0
package/src/plugins/defaults/tool-result-truncate/register.ts +10 -21
package/src/plugins/defaults/tool-result-truncate/terminal.ts +37 -18
package/src/plugins/pipeline.ts +6 -18
package/src/plugins/registry.ts +8 -25
package/src/plugins/types.ts +43 -474
package/src/proactive-artifact/aux-message-injector.ts +3 -3
package/src/proactive-artifact/job.test.ts +7 -12
package/src/prompts/__tests__/system-prompt.test.ts +36 -0
package/src/prompts/templates/BOOTSTRAP-ACTIVATION-RAIL.md +62 -0
package/src/prompts/templates/BOOTSTRAP.md +2 -2
package/src/prompts/templates/system-sections.ts +15 -0
package/src/providers/anthropic/client.ts +37 -29
package/src/providers/openai/__tests__/chat-completions-provider-reasoning.test.ts +112 -0
package/src/providers/openai/chat-completions-provider.ts +44 -0
package/src/providers/openrouter/client.ts +1 -0
package/src/providers/placeholder-sentinels.ts +35 -0
package/src/runtime/__tests__/agent-wake.test.ts +5 -1
package/src/runtime/agent-wake.ts +2 -2
package/src/runtime/assistant-event-hub.ts +36 -6
package/src/runtime/{conversation-stream-state.ts → assistant-stream-state.ts} +132 -58
package/src/runtime/http-router.ts +16 -21
package/src/runtime/http-types.ts +16 -70
package/src/runtime/pending-interactions.ts +1 -0
package/src/runtime/routes/__tests__/consolidation-routes.test.ts +265 -2
package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +31 -1
package/src/runtime/routes/__tests__/memory-v2-routes.test.ts +6 -2
package/src/runtime/routes/__tests__/tts-routes.test.ts +6 -2
package/src/runtime/routes/app-management-routes.ts +6 -117
package/src/runtime/routes/app-routes.ts +13 -15
package/src/runtime/routes/attachment-routes.ts +26 -15
package/src/runtime/routes/avatar-routes.ts +26 -0
package/src/runtime/routes/btw-routes.ts +29 -23
package/src/runtime/routes/consolidation-routes.ts +120 -20
package/src/runtime/routes/conversation-query-routes.ts +2 -0
package/src/runtime/routes/conversation-routes.ts +358 -184
package/src/runtime/routes/documents-routes.ts +4 -0
package/src/runtime/routes/domain-routes.ts +51 -37
package/src/runtime/routes/epoch-millis-range.ts +34 -0
package/src/runtime/routes/events-routes.ts +28 -34
package/src/runtime/routes/gateway-log-routes.ts +26 -4
package/src/runtime/routes/heartbeat-routes.ts +32 -12
package/src/runtime/routes/identity-intro-cache.ts +11 -34
package/src/runtime/routes/identity-routes.ts +208 -17
package/src/runtime/routes/image-generation-routes.ts +40 -2
package/src/runtime/routes/index.ts +2 -0
package/src/runtime/routes/integrations/a2a.ts +12 -10
package/src/runtime/routes/integrations/slack/__tests__/channel.test.ts +16 -0
package/src/runtime/routes/integrations/slack/channel.ts +4 -0
package/src/runtime/routes/integrations/slack/share.ts +27 -6
package/src/runtime/routes/integrations/telegram.ts +6 -0
package/src/runtime/routes/integrations/twilio.ts +42 -0
package/src/runtime/routes/internal-telemetry-routes.ts +88 -0
package/src/runtime/routes/log-export-routes.ts +8 -0
package/src/runtime/routes/memory-v2-routes.ts +15 -8
package/src/runtime/routes/memory-v3-routes.ts +50 -28
package/src/runtime/routes/oauth-apps.ts +66 -12
package/src/runtime/routes/oauth-providers.ts +44 -5
package/src/runtime/routes/platform-routes.ts +81 -5
package/src/runtime/routes/playground/__tests__/force-compact.test.ts +6 -4
package/src/runtime/routes/playground/force-compact.ts +1 -1
package/src/runtime/routes/rename-conversation-routes.ts +5 -0
package/src/runtime/routes/schedule-routes.ts +152 -42
package/src/runtime/routes/secret-routes.ts +14 -2
package/src/runtime/routes/skills-routes.ts +43 -14
package/src/runtime/routes/tool-call-confirmation-enrichment.test.ts +161 -0
package/src/runtime/routes/tool-call-confirmation-enrichment.ts +107 -0
package/src/runtime/routes/trust-rules-routes.ts +26 -2
package/src/runtime/routes/tts-routes.ts +35 -0
package/src/runtime/routes/types.ts +66 -8
package/src/runtime/routes/usage-routes.ts +47 -39
package/src/runtime/routes/webhook-routes.ts +41 -2
package/src/runtime/routes/workspace-routes.ts +4 -0
package/src/runtime/services/__tests__/analyze-conversation.test.ts +6 -0
package/src/runtime/services/analyze-conversation.ts +2 -2
package/src/schedule/schedule-store.ts +20 -1
package/src/schedule/schedule-usage-store.ts +83 -0
package/src/schedule/scheduler.ts +12 -5
package/src/skills/catalog-files.ts +2 -2
package/src/skills/catalog-install.ts +3 -0
package/src/skills/categories-cache.ts +118 -0
package/src/skills/clawhub-files.ts +1 -2
package/src/skills/skillssh-files.ts +1 -2
package/src/telemetry/types.ts +29 -1
package/src/telemetry/usage-telemetry-reporter.test.ts +112 -3
package/src/telemetry/usage-telemetry-reporter.ts +57 -2
package/src/tools/executor.ts +1 -53
package/src/tools/network/__tests__/web-search-metadata.test.ts +7 -1
package/src/tools/network/__tests__/web-search.test.ts +11 -3
package/src/tools/network/web-search-error.test.ts +248 -0
package/src/tools/network/web-search-error.ts +267 -0
package/src/tools/network/web-search.ts +207 -48
package/src/tools/schedule/create.ts +2 -0
package/src/tools/terminal/safe-env.ts +10 -1
package/src/tools/ui-surface/definitions.ts +9 -1
package/src/tts/__tests__/provider-catalog-consistency.test.ts +85 -1
package/src/tts/provider-catalog.ts +76 -1
package/src/util/mutex.ts +47 -0
package/src/workspace/git-service.ts +1 -42
package/src/workspace/migrations/095-bump-heartbeat-interval-30m-to-60m.ts +51 -0
package/src/workspace/migrations/096-reduce-quality-profile-effort.ts +72 -0
package/src/workspace/migrations/097-enable-adaptive-thinking-managed-profiles.ts +93 -0
package/src/workspace/migrations/registry.ts +6 -0
package/src/__tests__/bootstrap-turn-cleanup.test.ts +0 -44
package/src/__tests__/empty-response-pipeline.test.ts +0 -423
package/src/__tests__/llm-call-pipeline.test.ts +0 -287
package/src/__tests__/memory-retrieval-pipeline.test.ts +0 -418
package/src/__tests__/persistence-pipeline.test.ts +0 -503
package/src/__tests__/title-generate-pipeline.test.ts +0 -211
package/src/__tests__/token-estimate-pipeline.test.ts +0 -479
package/src/__tests__/tool-error-pipeline.test.ts +0 -241
package/src/__tests__/tool-execute-pipeline.test.ts +0 -417
package/src/__tests__/tool-result-truncate-pipeline.test.ts +0 -341
package/src/daemon/bootstrap-turn-cleanup.ts +0 -45
package/src/gallery/default-gallery.ts +0 -1359
package/src/gallery/gallery-manifest.ts +0 -28
package/src/home/feature-gate.ts +0 -22
package/src/plugins/defaults/empty-response/middlewares/emptyResponse.ts +0 -22
package/src/plugins/defaults/empty-response/terminal.ts +0 -106
package/src/plugins/defaults/injectors/package.json +0 -15
package/src/plugins/defaults/llm-call/middlewares/llmCall.ts +0 -17
package/src/plugins/defaults/llm-call/package.json +0 -15
package/src/plugins/defaults/llm-call/register.ts +0 -45
package/src/plugins/defaults/memory-retrieval/middlewares/memoryRetrieval.ts +0 -17
package/src/plugins/defaults/memory-retrieval/package.json +0 -15
package/src/plugins/defaults/memory-retrieval/register.ts +0 -181
package/src/plugins/defaults/persistence/middlewares/persistence.ts +0 -19
package/src/plugins/defaults/persistence/package.json +0 -15
package/src/plugins/defaults/persistence/register.ts +0 -38
package/src/plugins/defaults/persistence/terminal.ts +0 -83
package/src/plugins/defaults/title-generate/terminal.ts +0 -31
package/src/plugins/defaults/token-estimate/middlewares/tokenEstimate.ts +0 -23
package/src/plugins/defaults/token-estimate/package.json +0 -15
package/src/plugins/defaults/token-estimate/register.ts +0 -34
package/src/plugins/defaults/token-estimate/terminal.ts +0 -40
package/src/plugins/defaults/tool-error/middlewares/toolError.ts +0 -21
package/src/plugins/defaults/tool-error/terminal.ts +0 -47
package/src/plugins/defaults/tool-execute/middlewares/toolExecute.ts +0 -23
package/src/plugins/defaults/tool-execute/package.json +0 -15
package/src/plugins/defaults/tool-execute/register.ts +0 -49
package/src/plugins/defaults/tool-result-truncate/middlewares/toolResultTruncate.ts +0 -23
package/src/plugins/defaults/tool-result-truncate/types.ts +0 -22
package/src/skills/category-inference.ts +0 -111

package/src/config/bundled-skills/app-builder/references/examples/habit-tracker.md ADDED Viewed

@@ -0,0 +1,490 @@
+# Example — Habit Tracker
+A 7-day habit grid: add habits, toggle a checkmark per day, delete habits. This is the
+canonical **CRUD over a custom route** example — full create / read / update / delete
+backed by a JSON file on disk, called from a multi-file TSX (`formatVersion: 2`) app via
+`window.vellum.fetch`.
+**What it demonstrates**
+- A `routes/habits.ts` handler exporting `GET` / `POST` / `PATCH` / `DELETE`.
+- Mutations addressed by `id` via a **query param** (`/v1/x/habits?id=…`) — route files
+  cannot use `[id].ts` path segments (see [CUSTOM_ROUTES.md](../CUSTOM_ROUTES.md)).
+- A frontend that always checks `res.ok`, surfaces errors, and re-reads after every write
+  so the UI reflects persisted state rather than optimistic guesses.
+## File tree
+```
+src/index.html
+src/main.tsx
+src/components/HabitTracker.tsx
+src/components/HabitRow.tsx
+src/styles.css
+routes/habits.ts
+```
+## Route handler
+```typescript
+// routes/habits.ts — Habit CRUD, persisted as a JSON file in the app workspace.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+export const description = "Habit CRUD — stores habits as a JSON file";
+interface Habit {
+  id: string;
+  name: string;
+  completedDates: string[];
+  createdAt: string;
+}
+const DATA_DIR = join(process.env.VELLUM_WORKSPACE_DIR!, "data");
+const DATA_FILE = join(DATA_DIR, "habits.json");
+function loadHabits(): Habit[] {
+  mkdirSync(DATA_DIR, { recursive: true });
+  if (!existsSync(DATA_FILE)) return [];
+  return JSON.parse(readFileSync(DATA_FILE, "utf-8")) as Habit[];
+}
+function saveHabits(habits: Habit[]): void {
+  mkdirSync(DATA_DIR, { recursive: true });
+  writeFileSync(DATA_FILE, JSON.stringify(habits, null, 2));
+}
+export function GET(): Response {
+  return Response.json(loadHabits());
+}
+export async function POST(request: Request): Promise<Response> {
+  const body = (await request.json()) as { name?: unknown };
+  const name = typeof body.name === "string" ? body.name.trim() : "";
+  if (!name)
+    return Response.json({ error: "name is required" }, { status: 400 });
+  const habit: Habit = {
+    id: crypto.randomUUID(),
+    name,
+    completedDates: [],
+    createdAt: new Date().toISOString(),
+  };
+  const habits = loadHabits();
+  habits.push(habit);
+  saveHabits(habits);
+  return Response.json(habit, { status: 201 });
+}
+export async function PATCH(request: Request): Promise<Response> {
+  const id = new URL(request.url).searchParams.get("id");
+  if (!id) return Response.json({ error: "id is required" }, { status: 400 });
+  const body = (await request.json()) as { completedDates?: unknown };
+  if (!Array.isArray(body.completedDates)) {
+    return Response.json(
+      { error: "completedDates must be an array" },
+      { status: 400 },
+    );
+  }
+  const habits = loadHabits();
+  const habit = habits.find((h) => h.id === id);
+  if (!habit) return Response.json({ error: "not found" }, { status: 404 });
+  habit.completedDates = body.completedDates.filter(
+    (d): d is string => typeof d === "string",
+  );
+  saveHabits(habits);
+  return Response.json(habit);
+}
+export function DELETE(request: Request): Response {
+  const id = new URL(request.url).searchParams.get("id");
+  if (!id) return Response.json({ error: "id is required" }, { status: 400 });
+  const habits = loadHabits();
+  const next = habits.filter((h) => h.id !== id);
+  if (next.length === habits.length) {
+    return Response.json({ error: "not found" }, { status: 404 });
+  }
+  saveHabits(next);
+  return Response.json({ ok: true });
+}
+```
+## Frontend
+```html
+<!-- src/index.html -->
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Habit Tracker</title>
+  </head>
+  <body>
+    <div id="app"></div>
+  </body>
+</html>
+```
+```tsx
+// src/main.tsx
+import { render } from "preact";
+import { HabitTracker } from "./components/HabitTracker.js";
+import "./styles.css";
+render(<HabitTracker />, document.getElementById("app")!);
+```
+```tsx
+// src/components/HabitTracker.tsx
+import { useCallback, useEffect, useState } from "preact/hooks";
+import { HabitRow } from "./HabitRow.js";
+interface Habit {
+  id: string;
+  name: string;
+  completedDates: string[];
+}
+function getDates(): string[] {
+  const dates: string[] = [];
+  for (let i = 6; i >= 0; i--) {
+    const d = new Date();
+    d.setDate(d.getDate() - i);
+    dates.push(d.toISOString().slice(0, 10));
+  }
+  return dates;
+}
+function getDayNames(dates: string[]): string[] {
+  const names = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+  return dates.map((d) => names[new Date(d + "T12:00:00").getDay()]);
+}
+export function HabitTracker() {
+  const [habits, setHabits] = useState<Habit[]>([]);
+  const [input, setInput] = useState("");
+  const [error, setError] = useState<string | null>(null);
+  const dates = getDates();
+  const dayNames = getDayNames(dates);
+  const loadHabits = useCallback(async () => {
+    try {
+      const res = await window.vellum.fetch("/v1/x/habits");
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      setHabits(await res.json());
+      setError(null);
+    } catch (e) {
+      setError("Couldn't load habits. Try again.");
+      console.error(e);
+    }
+  }, []);
+  useEffect(() => {
+    loadHabits();
+  }, [loadHabits]);
+  const addHabit = async () => {
+    const name = input.trim();
+    if (!name) return;
+    setInput("");
+    try {
+      const res = await window.vellum.fetch("/v1/x/habits", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ name }),
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      await loadHabits();
+    } catch (e) {
+      setError("Couldn't add habit. Try again.");
+      console.error(e);
+    }
+  };
+  const toggleDate = async (id: string, date: string) => {
+    const habit = habits.find((h) => h.id === id);
+    if (!habit) return;
+    const completed = habit.completedDates.includes(date)
+      ? habit.completedDates.filter((d) => d !== date)
+      : [...habit.completedDates, date];
+    try {
+      const res = await window.vellum.fetch(`/v1/x/habits?id=${id}`, {
+        method: "PATCH",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ completedDates: completed }),
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      await loadHabits();
+    } catch (e) {
+      setError("Couldn't update habit. Try again.");
+      console.error(e);
+    }
+  };
+  const deleteHabit = async (id: string) => {
+    try {
+      const res = await window.vellum.fetch(`/v1/x/habits?id=${id}`, {
+        method: "DELETE",
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      await loadHabits();
+    } catch (e) {
+      setError("Couldn't delete habit. Try again.");
+      console.error(e);
+    }
+  };
+  return (
+    <div>
+      <div class="header">
+        <h1>Habit Tracker</h1>
+      </div>
+      {error && <div class="error-banner">{error}</div>}
+      <div class="add-form">
+        <input
+          type="text"
+          value={input}
+          onInput={(e) => setInput((e.target as HTMLInputElement).value)}
+          onKeyDown={(e) => e.key === "Enter" && addHabit()}
+          placeholder="Add a new habit..."
+        />
+        <button class="btn-primary" onClick={addHabit}>
+          Add
+        </button>
+      </div>
+      <div class="days-header">
+        <div />
+        {dayNames.map((name, i) => (
+          <div key={i} class="day-label">
+            {name}
+          </div>
+        ))}
+      </div>
+      <div>
+        {habits.length === 0 ? (
+          <div class="empty-state">No habits yet. Add one above!</div>
+        ) : (
+          habits.map((habit) => (
+            <HabitRow
+              key={habit.id}
+              habit={habit}
+              dates={dates}
+              onToggle={toggleDate}
+              onDelete={deleteHabit}
+            />
+          ))
+        )}
+      </div>
+    </div>
+  );
+}
+```
+```tsx
+// src/components/HabitRow.tsx
+interface Habit {
+  id: string;
+  name: string;
+  completedDates: string[];
+}
+interface HabitRowProps {
+  habit: Habit;
+  dates: string[];
+  onToggle: (id: string, date: string) => void;
+  onDelete: (id: string) => void;
+}
+export function HabitRow({ habit, dates, onToggle, onDelete }: HabitRowProps) {
+  return (
+    <div class="habit-row">
+      <div style={{ display: "flex", alignItems: "center", gap: "8px" }}>
+        <span class="habit-name">{habit.name}</span>
+        <button class="delete-btn" onClick={() => onDelete(habit.id)}>
+          x
+        </button>
+      </div>
+      {dates.map((date) => {
+        const checked = habit.completedDates.includes(date);
+        return (
+          <div key={date} class="check-cell">
+            <button
+              class={`check-btn${checked ? " checked" : ""}`}
+              onClick={() => onToggle(habit.id, date)}
+            >
+              {checked ? "\u2713" : ""}
+            </button>
+          </div>
+        );
+      })}
+    </div>
+  );
+}
+```
+```css
+/* src/styles.css */
+:root {
+  --bg: #0f172a;
+  --surface: #1e293b;
+  --primary: #6366f1;
+  --primary-hover: #5558e6;
+  --success: #22c55e;
+  --text: #f1f5f9;
+  --text-secondary: #94a3b8;
+  --border: #334155;
+  --radius: 10px;
+}
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+body {
+  font-family: -apple-system, BlinkMacSystemFont, "SF Pro Text", sans-serif;
+  background: var(--bg);
+  color: var(--text);
+  padding: 24px;
+  min-height: 100vh;
+}
+.header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 24px;
+}
+h1 {
+  font-size: 1.4rem;
+  font-weight: 600;
+}
+.error-banner {
+  background: rgba(239, 68, 68, 0.12);
+  color: #fca5a5;
+  padding: 10px 14px;
+  border-radius: var(--radius);
+  margin-bottom: 16px;
+  font-size: 0.85rem;
+}
+.add-form {
+  display: flex;
+  gap: 8px;
+  margin-bottom: 24px;
+}
+.add-form input {
+  flex: 1;
+  padding: 10px 14px;
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  color: var(--text);
+  font-family: inherit;
+  font-size: 0.9rem;
+  outline: none;
+}
+.add-form input:focus {
+  border-color: var(--primary);
+}
+.add-form input::placeholder {
+  color: var(--text-secondary);
+}
+button {
+  font-family: inherit;
+  font-size: 0.85rem;
+  font-weight: 500;
+  padding: 10px 18px;
+  border: none;
+  border-radius: var(--radius);
+  cursor: pointer;
+  transition: background 0.2s;
+}
+.btn-primary {
+  background: var(--primary);
+  color: white;
+}
+.btn-primary:hover {
+  background: var(--primary-hover);
+}
+.days-header {
+  display: grid;
+  grid-template-columns: 1fr repeat(7, 40px);
+  gap: 4px;
+  margin-bottom: 8px;
+  padding: 0 4px;
+}
+.day-label {
+  text-align: center;
+  font-size: 0.7rem;
+  color: var(--text-secondary);
+  text-transform: uppercase;
+}
+.habit-row {
+  display: grid;
+  grid-template-columns: 1fr repeat(7, 40px);
+  gap: 4px;
+  padding: 10px 4px;
+  border-radius: var(--radius);
+  margin-bottom: 4px;
+  align-items: center;
+}
+.habit-row:hover {
+  background: var(--surface);
+}
+.habit-name {
+  font-size: 0.9rem;
+  font-weight: 500;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.check-cell {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+}
+.check-btn {
+  width: 28px;
+  height: 28px;
+  border-radius: 6px;
+  border: 2px solid var(--border);
+  background: transparent;
+  cursor: pointer;
+  padding: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: all 0.15s;
+  color: transparent;
+  font-size: 14px;
+}
+.check-btn.checked {
+  background: var(--success);
+  border-color: var(--success);
+  color: white;
+}
+.check-btn:hover {
+  border-color: var(--success);
+}
+.delete-btn {
+  background: transparent;
+  color: var(--text-secondary);
+  border: none;
+  padding: 4px 8px;
+  font-size: 0.8rem;
+  cursor: pointer;
+  border-radius: 4px;
+}
+.delete-btn:hover {
+  color: #ef4444;
+  background: rgba(239, 68, 68, 0.1);
+}
+.empty-state {
+  text-align: center;
+  padding: 48px 0;
+  color: var(--text-secondary);
+}
+```

package/src/config/bundled-skills/document-editor/SKILL.md CHANGED Viewed

@@ -31,7 +31,7 @@ When the user asks to see, open, or pull up a document:
 1. Check the `<active_documents>` block in your context — it lists all documents in this conversation with their `surface_id` and title.
 2. If the document is NOT in `<active_documents>`, call `document_list` with a `query` matching the document title. For guardian/local users, this searches across previous conversations and sessions.
-3. Once you have the `surface_id`, call `document_open` to open the editor panel. This both surfaces the editor on the client and returns the document content. If the user only needs the text (not the editor), use `document_read` instead.
+3. Once you have the `surface_id`, call `document_open` to open the editor panel. This surfaces the editor on the client and returns document metadata (`surface_id`, `title`, `word_count`) — not the full content. If you need the actual document text, follow up with `document_read`.
 **Never** search the filesystem, conversation history, or archives to find a document. Always use `document_list` with a `query`.

package/src/config/bundled-skills/messaging/SKILL.md CHANGED Viewed

@@ -27,13 +27,6 @@ When the user mentions "email" - sending, reading, checking, decluttering, draft
 Do not offer the assistant's own email as an option unless the user specifically asks. If Gmail and Outlook are not connected, guide them through setup.
-## Communication Style
-- **Be action-oriented.** When the user asks to do something ("declutter", "check my email"), start doing it immediately. Don't ask for permission to read their inbox - that's obviously what they want.
-- **Keep it human.** Never mention OAuth, tokens, APIs, sandboxes, credential proxies, or other technical internals. If something isn't working, say "Gmail needs to be reconnected" - not "the OAuth2 access token for google has expired."
-- **Show progress.** When running a tool that scans many emails, tell the user what you're doing: "Scanning your inbox for clutter..." Don't go silent.
-- **Be brief and warm.** One or two sentences per update is plenty. Don't over-explain what you're about to do - just do it and narrate lightly.
 When a platform is connected (auth test succeeds), always use the messaging API tools for that platform. Never fall back to browser automation, shell commands (bash, curl), or any other approach for operations that messaging tools can handle. The messaging tools handle authentication internally - never try to access tokens or call APIs directly. Browser automation is only appropriate for initial credential setup (OAuth consent screens), not for day-to-day messaging operations.
 **Exception: Slack.** Slack messaging should use the Slack Web API directly via CLI, not messaging tools. See the **slack** skill for details.

package/src/config/feature-flag-cache.ts CHANGED Viewed

@@ -29,7 +29,7 @@
  */
 type FlagSlot = {
-  overrides: Record<string, boolean> | null;
+  overrides: Record<string, boolean | string> | null;
   fromGateway: boolean;
 };
@@ -44,7 +44,7 @@ function slot(): FlagSlot {
 }
 /** Read the current override cache. `null` means not yet populated. */
-export function getCachedOverrides(): Record<string, boolean> | null {
+export function getCachedOverrides(): Record<string, boolean | string> | null {
   return slot().overrides;
 }
@@ -66,7 +66,7 @@ export function isCachedFromGateway(): boolean {
  * `initFeatureFlagOverrides()` calls are no-ops.
  */
 export function setCachedOverrides(
-  overrides: Record<string, boolean>,
+  overrides: Record<string, boolean | string>,
   options: { fromGateway: boolean },
 ): void {
   const s = slot();

package/src/config/feature-flag-registry.json CHANGED Viewed

@@ -33,6 +33,14 @@
       "description": "Enable the condensed pre-chat onboarding flow for a standard LaunchDarkly percentage rollout.",
       "defaultEnabled": false
     },
+    {
+      "id": "experiment-activation-flow-2026-06-03",
+      "scope": "client",
+      "key": "experiment-activation-flow-2026-06-03",
+      "label": "Activation Flow Experiment 2026-06-03",
+      "description": "Route allowlisted users to the activation-rail bootstrap template after pre-chat. Off by default and targeted through LaunchDarkly.",
+      "defaultEnabled": false
+    },
     {
       "id": "local-docker-enabled",
       "scope": "client",
@@ -57,6 +65,14 @@
       "description": "Control Developer nav visibility in macOS settings",
       "defaultEnabled": false
     },
+    {
+      "id": "system-schedule-toggles",
+      "scope": "assistant",
+      "key": "system-schedule-toggles",
+      "label": "System Schedule Toggles",
+      "description": "Show Heartbeat and Consolidation pause toggles on the schedules settings page. The toggles only pause automatic runs; manual Run now remains available.",
+      "defaultEnabled": false
+    },
     {
       "id": "developer-menu-items",
       "scope": "client",
@@ -363,7 +379,7 @@
     },
     {
       "id": "home-page",
-      "scope": "both",
+      "scope": "client",
       "key": "home-page",
       "label": "Home Page",
       "description": "Enable the Home page as the default landing view.",
@@ -450,11 +466,27 @@
       "defaultEnabled": false
     },
     {
-      "id": "self-intro-greeting",
+      "id": "empty-state-dynamic-greetings",
       "scope": "assistant",
+      "key": "empty-state-dynamic-greetings",
+      "label": "Dynamic Empty-State Greetings",
+      "description": "Enable the empty new-chat screen to refresh cached greeting options via the empty-state greeting LLM call site. When off, the assistant serves workspace-authored greetings or static fallbacks only.",
+      "defaultEnabled": false
+    },
+    {
+      "id": "self-intro-greeting",
+      "scope": "both",
       "key": "self-intro-greeting",
       "label": "Self-intro first message",
-      "description": "On the first conversation, send a natural self-introduction (e.g. \"Hi Vela, I'm alex. Nice to meet you.\") on the user's behalf and route it through real LLM inference, instead of serving the canned first greeting. Names come from the onboarding context; falls back to the canned greeting when no name is known. See assistant/src/daemon/first-greeting.ts (buildSelfIntroMessage).",
+      "description": "On the first conversation, send a natural self-introduction (e.g. \"Hi Vela, I'm alex. Nice to meet you.\") on the user's behalf and route it through real LLM inference, instead of serving the canned first greeting. Names come from the onboarding context; falls back to the canned greeting when no name is known. Exposed to clients so pre-hatch onboarding can compute the source-of-truth initial message, and to the assistant so older clients can still be gated server-side. See assistant/src/daemon/first-greeting.ts (buildSelfIntroMessage).",
+      "defaultEnabled": false
+    },
+    {
+      "id": "provider-first-profile-creation",
+      "scope": "client",
+      "key": "provider-first-profile-creation",
+      "label": "Provider-First Profile Creation",
+      "description": "New profile creation flow: pick (or inline-create) a provider first, then a model, with pre-filled provider and profile name/key, plus a quick-add \"+\" in the chat composer's Model Profile menu. When off, profile creation uses the previous field order and there is no composer quick-add.",
       "defaultEnabled": false
     }
   ]

package/src/config/schemas/__tests__/memory-v2.test.ts CHANGED Viewed

@@ -23,6 +23,7 @@ describe("MemoryV2ConfigSchema", () => {
       bm25_k1: 1.2,
       bm25_b: 0.4,
       consolidation_interval_hours: 4,
+      consolidation_enabled: true,
       consolidation_max_buffer_lines: 100,
       max_page_chars: 5000,
       consolidation_prompt_path: null,

package/src/config/schemas/__tests__/memory-v3.test.ts ADDED Viewed

@@ -0,0 +1,25 @@
+import { describe, expect, test } from "bun:test";
+import { MemoryV3ConfigSchema } from "../memory-v3.js";
+describe("MemoryV3ConfigSchema", () => {
+  test("parses an empty object to documented defaults", () => {
+    const parsed = MemoryV3ConfigSchema.parse({});
+    expect(parsed).toEqual({
+      workingSet: { maxPages: 150, evictWindow: 5 },
+      l2Concurrency: 16,
+    });
+  });
+  test("accepts an explicit l2Concurrency override", () => {
+    expect(MemoryV3ConfigSchema.parse({ l2Concurrency: 8 }).l2Concurrency).toBe(
+      8,
+    );
+  });
+  test("rejects a non-positive or non-integer l2Concurrency", () => {
+    expect(() => MemoryV3ConfigSchema.parse({ l2Concurrency: 0 })).toThrow();
+    expect(() => MemoryV3ConfigSchema.parse({ l2Concurrency: -4 })).toThrow();
+    expect(() => MemoryV3ConfigSchema.parse({ l2Concurrency: 1.5 })).toThrow();
+  });
+});

package/src/config/schemas/llm.ts CHANGED Viewed

@@ -21,6 +21,7 @@ const LLMProvider = z.enum([
   "fireworks",
   "openrouter",
   "openai-compatible",
+  "minimax",
 ]);
 type LLMProvider = z.infer<typeof LLMProvider>;

package/src/config/schemas/memory-v2.ts CHANGED Viewed

@@ -194,6 +194,14 @@ export const MemoryV2ConfigSchema = z
       .describe(
         "Hours between scheduled consolidation runs that synthesize buffered memories into concept pages",
       ),
+    consolidation_enabled: z
+      .boolean({
+        error: "memory.v2.consolidation_enabled must be a boolean",
+      })
+      .default(true)
+      .describe(
+        "Whether automatic scheduled consolidation runs are enabled. Manual run-now requests remain available while memory.v2.enabled is true.",
+      ),
     consolidation_max_buffer_lines: z
       .number({
         error: "memory.v2.consolidation_max_buffer_lines must be a number",

package/src/config/schemas/memory-v3.ts CHANGED Viewed

@@ -33,6 +33,14 @@ export const MemoryV3ConfigSchema = z
     workingSet: MemoryV3WorkingSetSchema.default(
       MemoryV3WorkingSetSchema.parse({}),
     ),
+    l2Concurrency: z
+      .number({ error: "memory.v3.l2Concurrency must be a number" })
+      .int("memory.v3.l2Concurrency must be an integer")
+      .positive("memory.v3.l2Concurrency must be a positive integer")
+      .default(16)
+      .describe(
+        "Bounded fan-out for the per-leaf L2 selection (number of leaf selector calls in flight at once).",
+      ),
   })
   .describe("Memory v3 — topic-tree routing with a carry-forward working set");