@vellumai/assistant 0.5.6 → 0.5.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 (442) hide show
  1. package/.env.example +16 -2
  2. package/ARCHITECTURE.md +6 -75
  3. package/Dockerfile +3 -2
  4. package/README.md +0 -2
  5. package/bun.lock +0 -414
  6. package/docker-entrypoint.sh +9 -0
  7. package/docs/architecture/keychain-broker.md +45 -240
  8. package/docs/architecture/memory.md +13 -11
  9. package/docs/architecture/security.md +0 -17
  10. package/docs/credential-execution-service.md +2 -2
  11. package/node_modules/@vellumai/ces-contracts/package.json +1 -0
  12. package/node_modules/@vellumai/ces-contracts/src/error.ts +1 -1
  13. package/node_modules/@vellumai/ces-contracts/src/grants.ts +1 -1
  14. package/node_modules/@vellumai/ces-contracts/src/handles.ts +1 -1
  15. package/node_modules/@vellumai/ces-contracts/src/index.ts +1 -1
  16. package/node_modules/@vellumai/ces-contracts/src/rpc.ts +120 -1
  17. package/node_modules/@vellumai/credential-storage/package.json +1 -0
  18. package/node_modules/@vellumai/egress-proxy/package.json +1 -0
  19. package/package.json +2 -3
  20. package/src/__tests__/actor-token-service.test.ts +0 -114
  21. package/src/__tests__/approval-cascade.test.ts +0 -1
  22. package/src/__tests__/assistant-feature-flags-integration.test.ts +30 -29
  23. package/src/__tests__/browser-fill-credential.test.ts +1 -1
  24. package/src/__tests__/browser-skill-endstate.test.ts +6 -5
  25. package/src/__tests__/btw-routes.test.ts +0 -39
  26. package/src/__tests__/call-controller.test.ts +0 -1
  27. package/src/__tests__/call-domain.test.ts +0 -128
  28. package/src/__tests__/ces-rpc-credential-backend.test.ts +199 -0
  29. package/src/__tests__/ces-startup-timeout.test.ts +40 -0
  30. package/src/__tests__/channel-approval-routes.test.ts +0 -5
  31. package/src/__tests__/channel-readiness-service.test.ts +1 -60
  32. package/src/__tests__/checker.test.ts +4 -2
  33. package/src/__tests__/cli-command-risk-guard.test.ts +112 -0
  34. package/src/__tests__/config-schema-cmd.test.ts +0 -2
  35. package/src/__tests__/config-schema.test.ts +3 -1
  36. package/src/__tests__/conversation-abort-tool-results.test.ts +0 -1
  37. package/src/__tests__/conversation-agent-loop-overflow.test.ts +0 -2
  38. package/src/__tests__/conversation-agent-loop.test.ts +2 -4
  39. package/src/__tests__/conversation-attention-telegram.test.ts +0 -5
  40. package/src/__tests__/conversation-confirmation-signals.test.ts +0 -1
  41. package/src/__tests__/conversation-error.test.ts +15 -1
  42. package/src/__tests__/conversation-init.benchmark.test.ts +0 -2
  43. package/src/__tests__/conversation-messaging-secret-redirect.test.ts +1 -1
  44. package/src/__tests__/conversation-pre-run-repair.test.ts +0 -1
  45. package/src/__tests__/conversation-provider-retry-repair.test.ts +0 -1
  46. package/src/__tests__/conversation-queue.test.ts +0 -1
  47. package/src/__tests__/conversation-skill-tools.test.ts +0 -54
  48. package/src/__tests__/conversation-slash-queue.test.ts +0 -1
  49. package/src/__tests__/conversation-slash-unknown.test.ts +0 -1
  50. package/src/__tests__/conversation-title-service.test.ts +87 -0
  51. package/src/__tests__/conversation-workspace-injection.test.ts +0 -1
  52. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +0 -1
  53. package/src/__tests__/credential-execution-client.test.ts +5 -2
  54. package/src/__tests__/credential-execution-feature-gates.test.ts +59 -30
  55. package/src/__tests__/credential-execution-managed-contract.test.ts +35 -20
  56. package/src/__tests__/credential-security-e2e.test.ts +1 -67
  57. package/src/__tests__/credential-security-invariants.test.ts +6 -50
  58. package/src/__tests__/credentials-cli.test.ts +82 -3
  59. package/src/__tests__/daemon-credential-client.test.ts +123 -0
  60. package/src/__tests__/db-migration-rollback.test.ts +2015 -1
  61. package/src/__tests__/deterministic-verification-control-plane.test.ts +1 -0
  62. package/src/__tests__/docker-signing-key-bootstrap.test.ts +34 -143
  63. package/src/__tests__/dynamic-skill-workflow-prompt.test.ts +6 -4
  64. package/src/__tests__/gateway-client-managed-outbound.test.ts +79 -1
  65. package/src/__tests__/guardian-routing-state.test.ts +0 -5
  66. package/src/__tests__/host-shell-tool.test.ts +6 -7
  67. package/src/__tests__/http-user-message-parity.test.ts +3 -103
  68. package/src/__tests__/inbound-invite-redemption.test.ts +0 -4
  69. package/src/__tests__/inline-skill-load-permissions.test.ts +6 -8
  70. package/src/__tests__/intent-routing.test.ts +0 -13
  71. package/src/__tests__/jobs-store-qdrant-breaker.test.ts +178 -0
  72. package/src/__tests__/journal-context.test.ts +335 -0
  73. package/src/__tests__/keychain-broker-client.test.ts +161 -22
  74. package/src/__tests__/memory-context-benchmark.benchmark.test.ts +0 -3
  75. package/src/__tests__/memory-jobs-worker-backoff.test.ts +150 -0
  76. package/src/__tests__/memory-lifecycle-e2e.test.ts +70 -25
  77. package/src/__tests__/memory-recall-quality.test.ts +48 -17
  78. package/src/__tests__/memory-regressions.test.ts +408 -363
  79. package/src/__tests__/memory-retrieval.benchmark.test.ts +0 -3
  80. package/src/__tests__/migration-export-http.test.ts +2 -2
  81. package/src/__tests__/migration-import-commit-http.test.ts +2 -2
  82. package/src/__tests__/migration-import-preflight-http.test.ts +2 -2
  83. package/src/__tests__/migration-validate-http.test.ts +2 -2
  84. package/src/__tests__/non-member-access-request.test.ts +2 -7
  85. package/src/__tests__/notification-decision-fallback.test.ts +4 -0
  86. package/src/__tests__/notification-decision-identity.test.ts +4 -0
  87. package/src/__tests__/notification-decision-strategy.test.ts +71 -0
  88. package/src/__tests__/oauth-cli.test.ts +5 -1
  89. package/src/__tests__/permission-types.test.ts +1 -0
  90. package/src/__tests__/provider-commit-message-generator.test.ts +0 -37
  91. package/src/__tests__/provider-error-scenarios.test.ts +0 -267
  92. package/src/__tests__/provider-managed-proxy-integration.test.ts +5 -6
  93. package/src/__tests__/provider-streaming.benchmark.test.ts +2 -81
  94. package/src/__tests__/qdrant-manager.test.ts +28 -2
  95. package/src/__tests__/registry.test.ts +0 -6
  96. package/src/__tests__/relay-server.test.ts +1 -2
  97. package/src/__tests__/runtime-attachment-metadata.test.ts +0 -4
  98. package/src/__tests__/script-proxy-injection-runtime.test.ts +1 -1
  99. package/src/__tests__/secret-onetime-send.test.ts +1 -1
  100. package/src/__tests__/secret-routes-managed-proxy.test.ts +0 -4
  101. package/src/__tests__/secure-keys.test.ts +95 -272
  102. package/src/__tests__/shell-identity.test.ts +96 -6
  103. package/src/__tests__/skill-feature-flags-integration.test.ts +22 -14
  104. package/src/__tests__/skill-feature-flags.test.ts +46 -45
  105. package/src/__tests__/skill-load-feature-flag.test.ts +7 -10
  106. package/src/__tests__/skill-load-inline-command.test.ts +8 -12
  107. package/src/__tests__/skill-load-inline-includes.test.ts +6 -10
  108. package/src/__tests__/skill-load-tool.test.ts +0 -2
  109. package/src/__tests__/skill-memory.test.ts +17 -3
  110. package/src/__tests__/skill-projection-feature-flag.test.ts +33 -29
  111. package/src/__tests__/skills.test.ts +0 -2
  112. package/src/__tests__/slack-inbound-verification.test.ts +0 -4
  113. package/src/__tests__/stale-approval-dedup.test.ts +171 -0
  114. package/src/__tests__/stt-hints.test.ts +437 -0
  115. package/src/__tests__/suggestion-routes.test.ts +1 -32
  116. package/src/__tests__/system-prompt.test.ts +0 -1
  117. package/src/__tests__/task-memory-cleanup.test.ts +14 -0
  118. package/src/__tests__/tool-executor-shell-integration.test.ts +5 -3
  119. package/src/__tests__/trusted-contact-lifecycle-notifications.test.ts +0 -5
  120. package/src/__tests__/trusted-contact-multichannel.test.ts +0 -4
  121. package/src/__tests__/twilio-routes-twiml.test.ts +139 -1
  122. package/src/__tests__/update-bulletin.test.ts +0 -2
  123. package/src/__tests__/vellum-self-knowledge-inline-command.test.ts +6 -9
  124. package/src/__tests__/voice-quality.test.ts +58 -0
  125. package/src/__tests__/voice-scoped-grant-consumer.test.ts +0 -7
  126. package/src/__tests__/workspace-migration-015-migrate-credentials-to-keychain.test.ts +252 -0
  127. package/src/__tests__/workspace-migration-016-migrate-credentials-from-keychain.test.ts +220 -0
  128. package/src/__tests__/workspace-migration-down-functions.test.ts +1009 -0
  129. package/src/__tests__/workspace-migrations-runner.test.ts +114 -0
  130. package/src/acp/agent-process.ts +9 -1
  131. package/src/agent/loop.ts +1 -1
  132. package/src/approvals/guardian-request-resolvers.ts +164 -38
  133. package/src/calls/__tests__/tts-text-sanitizer.test.ts +254 -0
  134. package/src/calls/audio-store.test.ts +97 -0
  135. package/src/calls/audio-store.ts +205 -0
  136. package/src/calls/call-controller.ts +90 -8
  137. package/src/calls/call-domain.ts +3 -0
  138. package/src/calls/call-store.ts +10 -3
  139. package/src/calls/fish-audio-client.ts +129 -0
  140. package/src/calls/relay-server.ts +27 -0
  141. package/src/calls/stt-hints.ts +189 -0
  142. package/src/calls/tts-text-sanitizer.ts +61 -0
  143. package/src/calls/twilio-routes.ts +34 -5
  144. package/src/calls/types.ts +1 -0
  145. package/src/calls/voice-ingress-preflight.ts +0 -42
  146. package/src/calls/voice-quality.ts +38 -5
  147. package/src/calls/voice-session-bridge.ts +7 -12
  148. package/src/cli/commands/avatar.ts +2 -2
  149. package/src/cli/commands/config.ts +1 -4
  150. package/src/cli/commands/credentials.ts +128 -82
  151. package/src/cli/commands/doctor.ts +2 -2
  152. package/src/cli/commands/keys.ts +7 -7
  153. package/src/cli/commands/memory.ts +1 -1
  154. package/src/cli/commands/oauth/connections.ts +11 -29
  155. package/src/cli/commands/oauth/index.ts +7 -0
  156. package/src/cli/commands/oauth/platform.ts +525 -0
  157. package/src/cli/commands/platform.ts +3 -3
  158. package/src/cli/lib/daemon-credential-client.ts +284 -0
  159. package/src/cli.ts +1 -1
  160. package/src/config/assistant-feature-flags.ts +186 -5
  161. package/src/config/bundled-skills/AGENTS.md +34 -0
  162. package/src/config/bundled-skills/acp/SKILL.md +10 -0
  163. package/src/config/bundled-skills/app-builder/SKILL.md +0 -4
  164. package/src/config/bundled-skills/messaging/SKILL.md +5 -5
  165. package/src/config/bundled-skills/messaging/tools/messaging-analyze-style.ts +2 -2
  166. package/src/config/bundled-skills/phone-calls/TOOLS.json +4 -0
  167. package/src/config/bundled-skills/playbooks/tools/playbook-create.ts +1 -0
  168. package/src/config/bundled-skills/playbooks/tools/playbook-update.ts +1 -0
  169. package/src/config/bundled-skills/settings/SKILL.md +15 -2
  170. package/src/config/bundled-skills/settings/TOOLS.json +47 -2
  171. package/src/config/bundled-skills/settings/tools/avatar-remove.ts +59 -0
  172. package/src/config/bundled-skills/settings/tools/avatar-update.ts +80 -0
  173. package/src/config/bundled-skills/settings/tools/voice-config-update.ts +42 -0
  174. package/src/config/bundled-skills/slack/SKILL.md +1 -1
  175. package/src/config/bundled-tool-registry.ts +5 -11
  176. package/src/config/defaults.ts +0 -2
  177. package/src/config/env-registry.ts +5 -5
  178. package/src/config/env.ts +21 -14
  179. package/src/config/feature-flag-registry.json +49 -9
  180. package/src/config/loader.ts +106 -42
  181. package/src/config/schema.ts +9 -29
  182. package/src/config/schemas/calls.ts +30 -0
  183. package/src/config/schemas/fish-audio.ts +39 -0
  184. package/src/config/schemas/inference.ts +2 -2
  185. package/src/config/schemas/journal.ts +16 -0
  186. package/src/config/schemas/memory-processing.ts +2 -2
  187. package/src/config/schemas/security.ts +0 -4
  188. package/src/config/types.ts +1 -1
  189. package/src/contacts/contact-store.ts +39 -0
  190. package/src/contacts/types.ts +2 -0
  191. package/src/credential-execution/approval-bridge.ts +1 -0
  192. package/src/credential-execution/executable-discovery.ts +28 -4
  193. package/src/credential-execution/feature-gates.ts +16 -0
  194. package/src/credential-execution/process-manager.ts +38 -0
  195. package/src/credential-execution/startup-timeout.ts +36 -0
  196. package/src/daemon/approval-generators.ts +3 -9
  197. package/src/daemon/assistant-attachments.ts +9 -0
  198. package/src/daemon/config-watcher.ts +5 -0
  199. package/src/daemon/conversation-error.ts +13 -1
  200. package/src/daemon/conversation-memory.ts +1 -2
  201. package/src/daemon/conversation-process.ts +18 -1
  202. package/src/daemon/conversation-surfaces.ts +30 -1
  203. package/src/daemon/conversation-tool-setup.ts +0 -105
  204. package/src/daemon/conversation.ts +21 -1
  205. package/src/daemon/guardian-action-generators.ts +3 -9
  206. package/src/daemon/handlers/config-vercel.ts +92 -0
  207. package/src/daemon/handlers/skills.ts +2 -15
  208. package/src/daemon/install-symlink.ts +195 -0
  209. package/src/daemon/lifecycle.ts +234 -51
  210. package/src/daemon/message-types/conversations.ts +4 -4
  211. package/src/daemon/message-types/diagnostics.ts +3 -22
  212. package/src/daemon/message-types/messages.ts +0 -2
  213. package/src/daemon/message-types/upgrades.ts +8 -0
  214. package/src/daemon/server.ts +32 -95
  215. package/src/events/domain-events.ts +2 -1
  216. package/src/inbound/platform-callback-registration.ts +3 -3
  217. package/src/instrument.ts +8 -5
  218. package/src/memory/app-store.ts +31 -0
  219. package/src/memory/conversation-title-service.ts +50 -1
  220. package/src/memory/db-init.ts +16 -0
  221. package/src/memory/indexer.ts +19 -10
  222. package/src/memory/items-extractor.ts +328 -321
  223. package/src/memory/job-handlers/conversation-starters.ts +4 -1
  224. package/src/memory/job-handlers/summarization.ts +26 -16
  225. package/src/memory/jobs-store.ts +63 -6
  226. package/src/memory/jobs-worker.ts +31 -7
  227. package/src/memory/journal-memory.ts +214 -0
  228. package/src/memory/migrations/001-job-deferrals.ts +19 -0
  229. package/src/memory/migrations/004-entity-relation-dedup.ts +10 -0
  230. package/src/memory/migrations/005-fingerprint-scope-unique.ts +76 -0
  231. package/src/memory/migrations/006-scope-salted-fingerprints.ts +50 -0
  232. package/src/memory/migrations/007-assistant-id-to-self.ts +10 -0
  233. package/src/memory/migrations/008-remove-assistant-id-columns.ts +34 -0
  234. package/src/memory/migrations/009-llm-usage-events-drop-assistant-id.ts +26 -0
  235. package/src/memory/migrations/014-backfill-inbox-thread-state.ts +10 -0
  236. package/src/memory/migrations/015-drop-active-search-index.ts +17 -0
  237. package/src/memory/migrations/019-notification-tables-schema-migration.ts +12 -0
  238. package/src/memory/migrations/020-rename-macos-ios-channel-to-vellum.ts +121 -0
  239. package/src/memory/migrations/024-embedding-vector-blob.ts +74 -0
  240. package/src/memory/migrations/026a-embeddings-nullable-vector-json.ts +82 -0
  241. package/src/memory/migrations/036-normalize-phone-identities.ts +11 -0
  242. package/src/memory/migrations/116-messages-fts.ts +106 -1
  243. package/src/memory/migrations/126-backfill-guardian-principal-id.ts +52 -0
  244. package/src/memory/migrations/127-guardian-principal-id-not-null.ts +77 -0
  245. package/src/memory/migrations/134-contacts-notes-column.ts +13 -0
  246. package/src/memory/migrations/135-backfill-contact-interaction-stats.ts +20 -0
  247. package/src/memory/migrations/136-drop-assistant-id-columns.ts +52 -0
  248. package/src/memory/migrations/140-backfill-usage-cache-accounting.ts +13 -0
  249. package/src/memory/migrations/141-rename-verification-table.ts +54 -0
  250. package/src/memory/migrations/142-rename-verification-session-id-column.ts +25 -0
  251. package/src/memory/migrations/143-rename-guardian-verification-values.ts +35 -0
  252. package/src/memory/migrations/144-rename-voice-to-phone.ts +136 -0
  253. package/src/memory/migrations/145-drop-accounts-table.ts +32 -0
  254. package/src/memory/migrations/147-migrate-reminders-to-schedules.ts +14 -1
  255. package/src/memory/migrations/148-drop-reminders-table.ts +35 -1
  256. package/src/memory/migrations/150-oauth-apps-client-secret-path.ts +69 -1
  257. package/src/memory/migrations/162-guardian-timestamps-epoch-ms.ts +290 -0
  258. package/src/memory/migrations/169-rename-gmail-provider-key-to-google.ts +51 -1
  259. package/src/memory/migrations/174-rename-thread-starters-table.ts +47 -1
  260. package/src/memory/migrations/176-drop-capability-card-state.ts +13 -0
  261. package/src/memory/migrations/180-backfill-inline-attachments-to-disk.ts +16 -0
  262. package/src/memory/migrations/181-rename-thread-starters-checkpoints.ts +28 -1
  263. package/src/memory/migrations/190-call-session-skip-disclosure.ts +15 -0
  264. package/src/memory/migrations/191-backfill-audio-attachment-mime-types.ts +64 -0
  265. package/src/memory/migrations/192-contacts-user-file-column.ts +15 -0
  266. package/src/memory/migrations/193-add-source-type-columns.ts +81 -0
  267. package/src/memory/migrations/index.ts +5 -0
  268. package/src/memory/migrations/registry.ts +98 -0
  269. package/src/memory/migrations/validate-migration-state.ts +137 -11
  270. package/src/memory/qdrant-circuit-breaker.ts +9 -0
  271. package/src/memory/qdrant-manager.ts +64 -7
  272. package/src/memory/retriever.test.ts +37 -25
  273. package/src/memory/retriever.ts +24 -49
  274. package/src/memory/schema/calls.ts +1 -0
  275. package/src/memory/schema/contacts.ts +1 -0
  276. package/src/memory/schema/memory-core.ts +2 -0
  277. package/src/memory/search/formatting.ts +7 -44
  278. package/src/memory/search/staleness.ts +4 -0
  279. package/src/memory/search/tier-classifier.ts +10 -2
  280. package/src/memory/search/types.ts +2 -5
  281. package/src/memory/task-memory-cleanup.ts +4 -3
  282. package/src/notifications/adapters/slack.ts +168 -6
  283. package/src/notifications/broadcaster.ts +1 -0
  284. package/src/notifications/copy-composer.ts +59 -2
  285. package/src/notifications/decision-engine.ts +4 -1
  286. package/src/notifications/signal.ts +2 -0
  287. package/src/notifications/types.ts +2 -0
  288. package/src/oauth/connection-resolver.ts +6 -4
  289. package/src/permissions/checker.ts +0 -38
  290. package/src/permissions/shell-identity.ts +76 -22
  291. package/src/permissions/types.ts +4 -2
  292. package/src/platform/client.ts +35 -7
  293. package/src/prompts/journal-context.ts +133 -0
  294. package/src/prompts/persona-resolver.ts +194 -0
  295. package/src/prompts/system-prompt.ts +44 -4
  296. package/src/prompts/templates/SOUL.md +10 -0
  297. package/src/prompts/templates/users/default.md +1 -0
  298. package/src/providers/provider-send-message.ts +3 -32
  299. package/src/providers/registry.ts +29 -179
  300. package/src/providers/types.ts +1 -1
  301. package/src/runtime/access-request-helper.ts +4 -0
  302. package/src/runtime/auth/__tests__/credential-service.test.ts +0 -1
  303. package/src/runtime/auth/__tests__/external-assistant-id.test.ts +13 -68
  304. package/src/runtime/auth/__tests__/guard-tests.test.ts +9 -50
  305. package/src/runtime/auth/external-assistant-id.ts +13 -59
  306. package/src/runtime/auth/route-policy.ts +17 -1
  307. package/src/runtime/auth/token-service.ts +43 -138
  308. package/src/runtime/channel-readiness-service.ts +1 -16
  309. package/src/runtime/gateway-client.ts +47 -4
  310. package/src/runtime/guardian-decision-types.ts +45 -4
  311. package/src/runtime/http-server.ts +31 -3
  312. package/src/runtime/middleware/error-handler.ts +1 -9
  313. package/src/runtime/routes/access-request-decision.ts +2 -2
  314. package/src/runtime/routes/app-management-routes.ts +2 -1
  315. package/src/runtime/routes/approval-strategies/guardian-callback-strategy.ts +219 -30
  316. package/src/runtime/routes/approval-strategies/guardian-text-engine-strategy.ts +37 -14
  317. package/src/runtime/routes/audio-routes.ts +40 -0
  318. package/src/runtime/routes/btw-routes.ts +0 -17
  319. package/src/runtime/routes/channel-readiness-routes.ts +9 -4
  320. package/src/runtime/routes/conversation-query-routes.ts +63 -1
  321. package/src/runtime/routes/conversation-routes.ts +4 -44
  322. package/src/runtime/routes/debug-routes.ts +12 -9
  323. package/src/runtime/routes/diagnostics-routes.ts +1 -477
  324. package/src/runtime/routes/guardian-approval-interception.ts +168 -11
  325. package/src/runtime/routes/guardian-approval-prompt.ts +6 -1
  326. package/src/runtime/routes/guardian-approval-reply-helpers.ts +103 -21
  327. package/src/runtime/routes/identity-routes.ts +19 -30
  328. package/src/runtime/routes/inbound-message-handler.ts +31 -1
  329. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +64 -5
  330. package/src/runtime/routes/inbound-stages/background-dispatch.ts +52 -40
  331. package/src/runtime/routes/inbound-stages/secret-ingress-check.ts +4 -33
  332. package/src/runtime/routes/inbound-stages/transcribe-audio.test.ts +1 -1
  333. package/src/runtime/routes/integrations/twilio.ts +52 -10
  334. package/src/runtime/routes/integrations/vercel.ts +89 -0
  335. package/src/runtime/routes/log-export-routes.ts +5 -0
  336. package/src/runtime/routes/memory-item-routes.test.ts +3 -3
  337. package/src/runtime/routes/memory-item-routes.ts +46 -14
  338. package/src/runtime/routes/migration-rollback-routes.ts +209 -0
  339. package/src/runtime/routes/migration-routes.ts +17 -1
  340. package/src/runtime/routes/notification-routes.ts +58 -0
  341. package/src/runtime/routes/schedule-routes.ts +65 -0
  342. package/src/runtime/routes/secret-routes.ts +141 -10
  343. package/src/runtime/routes/settings-routes.ts +41 -1
  344. package/src/runtime/routes/tts-routes.ts +96 -0
  345. package/src/runtime/routes/upgrade-broadcast-routes.ts +26 -2
  346. package/src/runtime/routes/workspace-commit-routes.ts +62 -0
  347. package/src/runtime/routes/workspace-routes.test.ts +22 -1
  348. package/src/runtime/routes/workspace-routes.ts +1 -1
  349. package/src/runtime/routes/workspace-utils.ts +86 -2
  350. package/src/security/ces-credential-client.ts +75 -29
  351. package/src/security/ces-rpc-credential-backend.ts +86 -0
  352. package/src/security/credential-backend.ts +22 -92
  353. package/src/security/keychain-broker-client.ts +10 -2
  354. package/src/security/secure-keys.ts +113 -115
  355. package/src/skills/catalog-install.ts +6 -32
  356. package/src/skills/skill-memory.ts +1 -0
  357. package/src/subagent/manager.ts +2 -5
  358. package/src/telemetry/usage-telemetry-reporter.ts +4 -2
  359. package/src/tools/acp/spawn.ts +78 -1
  360. package/src/tools/calls/call-start.ts +1 -0
  361. package/src/tools/credentials/vault.ts +5 -3
  362. package/src/tools/executor.ts +0 -4
  363. package/src/tools/memory/definitions.ts +3 -2
  364. package/src/tools/memory/handlers.ts +10 -7
  365. package/src/tools/network/script-proxy/session-manager.ts +19 -4
  366. package/src/tools/network/web-fetch.ts +3 -1
  367. package/src/tools/skills/execute.ts +1 -1
  368. package/src/tools/terminal/safe-env.ts +1 -0
  369. package/src/tools/types.ts +0 -8
  370. package/src/util/browser.ts +15 -0
  371. package/src/util/errors.ts +0 -12
  372. package/src/util/platform.ts +4 -51
  373. package/src/workspace/git-service.ts +5 -2
  374. package/src/workspace/migrations/001-avatar-rename.ts +15 -0
  375. package/src/workspace/migrations/003-seed-device-id.ts +17 -1
  376. package/src/workspace/migrations/004-extract-collect-usage-data.ts +33 -0
  377. package/src/workspace/migrations/005-add-send-diagnostics.ts +3 -0
  378. package/src/workspace/migrations/006-services-config.ts +49 -0
  379. package/src/workspace/migrations/007-web-search-provider-rename.ts +27 -0
  380. package/src/workspace/migrations/008-voice-timeout-and-max-steps.ts +3 -0
  381. package/src/workspace/migrations/009-backfill-conversation-disk-view.ts +4 -0
  382. package/src/workspace/migrations/010-app-dir-rename.ts +78 -0
  383. package/src/workspace/migrations/011-backfill-installation-id.ts +11 -0
  384. package/src/workspace/migrations/012-rename-conversation-disk-view-dirs.ts +44 -0
  385. package/src/workspace/migrations/013-repair-conversation-disk-view.ts +5 -0
  386. package/src/workspace/migrations/015-migrate-credentials-to-keychain.ts +153 -0
  387. package/src/workspace/migrations/016-extract-feature-flags-to-protected.ts +156 -0
  388. package/src/workspace/migrations/016-migrate-credentials-from-keychain.ts +150 -0
  389. package/src/workspace/migrations/017-seed-persona-dirs.ts +96 -0
  390. package/src/workspace/migrations/018-rekey-compound-credential-keys.ts +184 -0
  391. package/src/workspace/migrations/019-scope-journal-to-guardian.ts +103 -0
  392. package/src/workspace/migrations/migrate-to-workspace-volume.ts +27 -5
  393. package/src/workspace/migrations/registry.ts +12 -0
  394. package/src/workspace/migrations/runner.ts +106 -2
  395. package/src/workspace/migrations/types.ts +4 -0
  396. package/src/workspace/provider-commit-message-generator.ts +12 -21
  397. package/src/__tests__/claude-code-skill-regression.test.ts +0 -206
  398. package/src/__tests__/claude-code-tool-profiles.test.ts +0 -99
  399. package/src/__tests__/diagnostics-export.test.ts +0 -288
  400. package/src/__tests__/local-gateway-health.test.ts +0 -209
  401. package/src/__tests__/provider-fail-open-selection.test.ts +0 -271
  402. package/src/__tests__/provider-failover-actual-provider.test.ts +0 -66
  403. package/src/__tests__/secret-ingress-handler.test.ts +0 -120
  404. package/src/__tests__/swarm-conversation-integration.test.ts +0 -358
  405. package/src/__tests__/swarm-dag-pathological.test.ts +0 -547
  406. package/src/__tests__/swarm-orchestrator.test.ts +0 -463
  407. package/src/__tests__/swarm-plan-validator.test.ts +0 -384
  408. package/src/__tests__/swarm-recursion.test.ts +0 -197
  409. package/src/__tests__/swarm-router-planner.test.ts +0 -234
  410. package/src/__tests__/swarm-tool.test.ts +0 -185
  411. package/src/__tests__/swarm-worker-backend.test.ts +0 -144
  412. package/src/__tests__/swarm-worker-runner.test.ts +0 -288
  413. package/src/commands/__tests__/cc-command-registry.test.ts +0 -396
  414. package/src/commands/cc-command-registry.ts +0 -248
  415. package/src/config/bundled-skills/claude-code/SKILL.md +0 -53
  416. package/src/config/bundled-skills/claude-code/TOOLS.json +0 -47
  417. package/src/config/bundled-skills/claude-code/tools/claude-code.ts +0 -12
  418. package/src/config/bundled-skills/orchestration/SKILL.md +0 -33
  419. package/src/config/bundled-skills/orchestration/TOOLS.json +0 -35
  420. package/src/config/bundled-skills/orchestration/tools/swarm-delegate.ts +0 -12
  421. package/src/config/schemas/swarm.ts +0 -82
  422. package/src/logfire.ts +0 -135
  423. package/src/memory/search/lexical.ts +0 -48
  424. package/src/providers/failover.ts +0 -186
  425. package/src/runtime/local-gateway-health.ts +0 -275
  426. package/src/security/secret-ingress.ts +0 -68
  427. package/src/swarm/backend-claude-code.ts +0 -225
  428. package/src/swarm/checkpoint.ts +0 -137
  429. package/src/swarm/graph-utils.ts +0 -53
  430. package/src/swarm/index.ts +0 -55
  431. package/src/swarm/limits.ts +0 -66
  432. package/src/swarm/orchestrator.ts +0 -424
  433. package/src/swarm/plan-validator.ts +0 -117
  434. package/src/swarm/router-planner.ts +0 -162
  435. package/src/swarm/router-prompts.ts +0 -39
  436. package/src/swarm/synthesizer.ts +0 -81
  437. package/src/swarm/types.ts +0 -72
  438. package/src/swarm/worker-backend.ts +0 -131
  439. package/src/swarm/worker-prompts.ts +0 -80
  440. package/src/swarm/worker-runner.ts +0 -170
  441. package/src/tools/claude-code/claude-code.ts +0 -610
  442. package/src/tools/swarm/delegate.ts +0 -205
@@ -2,19 +2,15 @@ import {
2
2
  existsSync,
3
3
  mkdirSync,
4
4
  readFileSync,
5
+ renameSync,
5
6
  statSync,
6
7
  writeFileSync,
7
8
  } from "node:fs";
8
- import { dirname } from "node:path";
9
+ import { dirname, join } from "node:path";
9
10
 
10
11
  import { ConfigError } from "../util/errors.js";
11
12
  import { getLogger } from "../util/logger.js";
12
- import {
13
- ensureDataDir,
14
- getWorkspaceConfigPath,
15
- readLockfile,
16
- writeLockfile,
17
- } from "../util/platform.js";
13
+ import { ensureDataDir, getWorkspaceConfigPath } from "../util/platform.js";
18
14
  import { AssistantConfigSchema } from "./schema.js";
19
15
  import type { AssistantConfig } from "./types.js";
20
16
 
@@ -44,19 +40,16 @@ function ensureMigratedDataDir(): void {
44
40
  }
45
41
 
46
42
  /**
47
- * Zod 4's .default({}) returns {} as output without running inner-schema
48
- * parsing, so nested object defaults are never applied. Re-parse the config
49
- * to cascade defaults through each nesting level.
50
- * Max chain of .default({}) on object schemas is 4
51
- * (e.g. memory retrieval freshness maxAgeDays),
52
- * so 5 parses are needed (N+1) to fully cascade.
43
+ * Parse a raw config through the Zod schema, applying all nested defaults.
44
+ *
45
+ * All nested object schemas use `.default(SubSchema.parse({}))` which
46
+ * pre-computes fully-resolved defaults at schema construction time, so a
47
+ * single parse is sufficient to cascade defaults through every nesting level.
53
48
  */
54
49
  export function applyNestedDefaults(config: unknown): AssistantConfig {
55
- let current: unknown = config;
56
- for (let i = 0; i < 5; i++) {
57
- current = AssistantConfigSchema.parse(current);
58
- }
59
- return current as AssistantConfig;
50
+ return structuredClone(
51
+ AssistantConfigSchema.parse(config),
52
+ ) as AssistantConfig;
60
53
  }
61
54
 
62
55
  function cloneDefaultConfig(): AssistantConfig {
@@ -214,6 +207,35 @@ export function deepMergeMissing(
214
207
  return changed;
215
208
  }
216
209
 
210
+ /**
211
+ * Deep-merge `overrides` into `target`, overwriting leaf values.
212
+ * Recursively merges nested objects; scalars and arrays from `overrides`
213
+ * replace corresponding values in `target`.
214
+ */
215
+ export function deepMergeOverwrite(
216
+ target: Record<string, unknown>,
217
+ overrides: Record<string, unknown>,
218
+ ): void {
219
+ for (const key of Object.keys(overrides)) {
220
+ const ov = overrides[key];
221
+ if (
222
+ ov != null &&
223
+ typeof ov === "object" &&
224
+ !Array.isArray(ov) &&
225
+ target[key] != null &&
226
+ typeof target[key] === "object" &&
227
+ !Array.isArray(target[key])
228
+ ) {
229
+ deepMergeOverwrite(
230
+ target[key] as Record<string, unknown>,
231
+ ov as Record<string, unknown>,
232
+ );
233
+ } else {
234
+ target[key] = ov;
235
+ }
236
+ }
237
+ }
238
+
217
239
  /**
218
240
  * Read the existing config.json from disk, merge any missing schema-default
219
241
  * keys, and rewrite only when there is an effective change.
@@ -248,6 +270,72 @@ function backfillConfigDefaults(
248
270
  }
249
271
  }
250
272
 
273
+ /**
274
+ * Merge default workspace config from the file referenced by
275
+ * VELLUM_DEFAULT_WORKSPACE_CONFIG_PATH into the workspace config on disk.
276
+ *
277
+ * Called once at daemon startup (before the first loadConfig()) so the
278
+ * defaults are persisted to the workspace config file alongside any
279
+ * schema-level defaults that loadConfig() backfills.
280
+ */
281
+ export function mergeDefaultWorkspaceConfig(): void {
282
+ const defaultConfigPath = process.env.VELLUM_DEFAULT_WORKSPACE_CONFIG_PATH;
283
+ if (!defaultConfigPath || !existsSync(defaultConfigPath)) return;
284
+
285
+ let defaults: unknown;
286
+ try {
287
+ defaults = JSON.parse(readFileSync(defaultConfigPath, "utf-8"));
288
+ } catch (err) {
289
+ log.warn(
290
+ { err },
291
+ "Failed to read default workspace config from %s",
292
+ defaultConfigPath,
293
+ );
294
+ return;
295
+ }
296
+
297
+ if (
298
+ defaults == null ||
299
+ typeof defaults !== "object" ||
300
+ Array.isArray(defaults)
301
+ ) {
302
+ return;
303
+ }
304
+
305
+ const configPath = getConfigPath();
306
+ let existing: Record<string, unknown> = {};
307
+ if (existsSync(configPath)) {
308
+ try {
309
+ existing = JSON.parse(readFileSync(configPath, "utf-8"));
310
+ } catch {
311
+ // If existing config is corrupt, start fresh
312
+ }
313
+ }
314
+
315
+ deepMergeOverwrite(existing, defaults as Record<string, unknown>);
316
+
317
+ const dir = dirname(configPath);
318
+ if (!existsSync(dir)) {
319
+ mkdirSync(dir, { recursive: true });
320
+ }
321
+ writeFileSync(configPath, JSON.stringify(existing, null, 2) + "\n");
322
+
323
+ // Move the temp file into the workspace directory as a permanent record.
324
+ // This prevents re-application on daemon restart (the env var still points
325
+ // at the old /tmp path which no longer exists).
326
+ try {
327
+ const dest = join(dir, "default-config.json");
328
+ renameSync(defaultConfigPath, dest);
329
+ log.info(
330
+ "Merged default workspace config from %s (archived to %s)",
331
+ defaultConfigPath,
332
+ dest,
333
+ );
334
+ } catch {
335
+ log.info("Merged default workspace config from %s", defaultConfigPath);
336
+ }
337
+ }
338
+
251
339
  export function loadConfig(): AssistantConfig {
252
340
  if (cached) return cached;
253
341
 
@@ -375,30 +463,6 @@ export function saveRawConfig(config: Record<string, unknown>): void {
375
463
  cached = null; // invalidate cache
376
464
  }
377
465
 
378
- /**
379
- * Sync client-relevant config values (e.g. platform.baseUrl) to the lockfile
380
- * so external tools (e.g. vel) can discover them without importing the full
381
- * config schema. Mirrors the behaviour of `syncConfigToLockfile` in the
382
- * lightweight CLI (`cli/src/lib/assistant-config.ts`).
383
- */
384
- export function syncConfigToLockfile(): void {
385
- const configPath = getWorkspaceConfigPath();
386
- if (!existsSync(configPath)) return;
387
-
388
- try {
389
- const raw = JSON.parse(readFileSync(configPath, "utf-8")) as Record<
390
- string,
391
- unknown
392
- >;
393
- const platform = raw.platform as Record<string, unknown> | undefined;
394
- const data = readLockfile() ?? {};
395
- data.platformBaseUrl = (platform?.baseUrl as string) || undefined;
396
- writeLockfile(data);
397
- } catch {
398
- // Config file unreadable — skip sync
399
- }
400
- }
401
-
402
466
  export function getNestedValue(
403
467
  obj: Record<string, unknown>,
404
468
  path: string,
@@ -40,6 +40,8 @@ export {
40
40
  ElevenLabsConfigSchema,
41
41
  VALID_CONVERSATION_TIMEOUTS,
42
42
  } from "./schemas/elevenlabs.js";
43
+ export type { FishAudioConfig } from "./schemas/fish-audio.js";
44
+ export { FishAudioConfigSchema } from "./schemas/fish-audio.js";
43
45
  export type { HeartbeatConfig } from "./schemas/heartbeat.js";
44
46
  export { HeartbeatConfigSchema } from "./schemas/heartbeat.js";
45
47
  export type {
@@ -66,6 +68,8 @@ export {
66
68
  IngressRateLimitConfigSchema,
67
69
  IngressWebhookConfigSchema,
68
70
  } from "./schemas/ingress.js";
71
+ export type { JournalConfig } from "./schemas/journal.js";
72
+ export { JournalConfigSchema } from "./schemas/journal.js";
69
73
  export type { AuditLogConfig, LogFileConfig } from "./schemas/logging.js";
70
74
  export {
71
75
  AuditLogConfigSchema,
@@ -173,8 +177,6 @@ export {
173
177
  SkillsInstallConfigSchema,
174
178
  SkillsLoadConfigSchema,
175
179
  } from "./schemas/skills.js";
176
- export type { SwarmConfig } from "./schemas/swarm.js";
177
- export { SwarmConfigSchema } from "./schemas/swarm.js";
178
180
  export type { RateLimitConfig, TimeoutConfig } from "./schemas/timeouts.js";
179
181
  export {
180
182
  RateLimitConfigSchema,
@@ -193,6 +195,7 @@ import {
193
195
  WhatsAppConfigSchema,
194
196
  } from "./schemas/channels.js";
195
197
  import { ElevenLabsConfigSchema } from "./schemas/elevenlabs.js";
198
+ import { FishAudioConfigSchema } from "./schemas/fish-audio.js";
196
199
  import { HeartbeatConfigSchema } from "./schemas/heartbeat.js";
197
200
  import {
198
201
  ContextWindowConfigSchema,
@@ -201,6 +204,7 @@ import {
201
204
  ThinkingConfigSchema,
202
205
  } from "./schemas/inference.js";
203
206
  import { IngressConfigSchema } from "./schemas/ingress.js";
207
+ import { JournalConfigSchema } from "./schemas/journal.js";
204
208
  import {
205
209
  AuditLogConfigSchema,
206
210
  LogFileConfigSchema,
@@ -218,12 +222,8 @@ import {
218
222
  PermissionsConfigSchema,
219
223
  SecretDetectionConfigSchema,
220
224
  } from "./schemas/security.js";
221
- import {
222
- ServicesSchema,
223
- VALID_INFERENCE_PROVIDERS,
224
- } from "./schemas/services.js";
225
+ import { ServicesSchema } from "./schemas/services.js";
225
226
  import { SkillsConfigSchema } from "./schemas/skills.js";
226
- import { SwarmConfigSchema } from "./schemas/swarm.js";
227
227
  import {
228
228
  RateLimitConfigSchema,
229
229
  TimeoutConfigSchema,
@@ -233,18 +233,6 @@ import { WorkspaceGitConfigSchema } from "./schemas/workspace-git.js";
233
233
  export const AssistantConfigSchema = z
234
234
  .object({
235
235
  services: ServicesSchema.default(ServicesSchema.parse({})),
236
- providerOrder: z
237
- .array(
238
- z.enum(VALID_INFERENCE_PROVIDERS, {
239
- error: `Each providerOrder entry must be one of: ${VALID_INFERENCE_PROVIDERS.join(
240
- ", ",
241
- )}`,
242
- }),
243
- )
244
- .default([])
245
- .describe(
246
- "Fallback order of LLM providers — the assistant tries each in sequence if the previous one fails",
247
- ),
248
236
  maxTokens: z
249
237
  .number({ error: "maxTokens must be a number" })
250
238
  .int("maxTokens must be an integer")
@@ -281,7 +269,7 @@ export const AssistantConfigSchema = z
281
269
  "Custom pricing overrides for specific provider/model combinations",
282
270
  ),
283
271
  heartbeat: HeartbeatConfigSchema.default(HeartbeatConfigSchema.parse({})),
284
- swarm: SwarmConfigSchema.default(SwarmConfigSchema.parse({})),
272
+ journal: JournalConfigSchema.default(JournalConfigSchema.parse({})),
285
273
  mcp: McpConfigSchema.default(McpConfigSchema.parse({})),
286
274
  acp: AcpConfigSchema.default(AcpConfigSchema.parse({})),
287
275
  skills: SkillsConfigSchema.default(SkillsConfigSchema.parse({})),
@@ -293,6 +281,7 @@ export const AssistantConfigSchema = z
293
281
  elevenlabs: ElevenLabsConfigSchema.default(
294
282
  ElevenLabsConfigSchema.parse({}),
295
283
  ),
284
+ fishAudio: FishAudioConfigSchema.default(FishAudioConfigSchema.parse({})),
296
285
  whatsapp: WhatsAppConfigSchema.default(WhatsAppConfigSchema.parse({})),
297
286
  telegram: TelegramConfigSchema.default(TelegramConfigSchema.parse({})),
298
287
  slack: SlackConfigSchema.default(SlackConfigSchema.parse({})),
@@ -303,15 +292,6 @@ export const AssistantConfigSchema = z
303
292
  NotificationsConfigSchema.parse({}),
304
293
  ),
305
294
  ui: UiConfigSchema.default(UiConfigSchema.parse({})),
306
- assistantFeatureFlagValues: z
307
- .record(
308
- z.string(),
309
- z.boolean({
310
- error: "assistantFeatureFlagValues values must be booleans",
311
- }),
312
- )
313
- .optional()
314
- .describe("Feature flag overrides — map of flag names to boolean values"),
315
295
  collectUsageData: z
316
296
  .boolean()
317
297
  .default(true)
@@ -6,6 +6,7 @@ export const VALID_CALLER_IDENTITY_MODES = [
6
6
  "user_number",
7
7
  ] as const;
8
8
  const VALID_CALL_TRANSCRIPTION_PROVIDERS = ["Deepgram", "Google"] as const;
9
+ export const VALID_TTS_PROVIDERS = ["elevenlabs", "fish-audio"] as const;
9
10
 
10
11
  export const CallsDisclosureConfigSchema = z
11
12
  .object({
@@ -57,6 +58,35 @@ export const CallsVoiceConfigSchema = z
57
58
  })
58
59
  .default("Deepgram")
59
60
  .describe("Speech-to-text provider used for call transcription"),
61
+ speechModel: z
62
+ .string({ error: "calls.voice.speechModel must be a string" })
63
+ .optional()
64
+ .describe(
65
+ "ASR model to use for speech recognition (e.g. nova-3, nova-2-phonecall for Deepgram; telephony, long for Google)",
66
+ ),
67
+ ttsProvider: z
68
+ .enum(VALID_TTS_PROVIDERS, {
69
+ error: `calls.voice.ttsProvider must be one of: ${VALID_TTS_PROVIDERS.join(", ")}`,
70
+ })
71
+ .default("elevenlabs")
72
+ .describe("Text-to-speech provider for phone calls"),
73
+ hints: z
74
+ .array(
75
+ z.string({ error: "calls.voice.hints values must be strings" }),
76
+ )
77
+ .default([])
78
+ .describe(
79
+ "Static vocabulary hints for speech recognition — proper nouns, domain terms, and other words the STT provider should prioritize",
80
+ ),
81
+ interruptSensitivity: z
82
+ .enum(["low", "medium", "high"], {
83
+ error:
84
+ "calls.voice.interruptSensitivity must be one of: low, medium, high",
85
+ })
86
+ .default("low")
87
+ .describe(
88
+ "How aggressively the STT provider detects the start of caller speech — low reduces false interrupts from background noise",
89
+ ),
60
90
  })
61
91
  .describe("Voice and speech settings for phone calls");
62
92
 
@@ -0,0 +1,39 @@
1
+ import { z } from "zod";
2
+
3
+ export const FishAudioConfigSchema = z
4
+ .object({
5
+ referenceId: z
6
+ .string({ error: "fishAudio.referenceId must be a string" })
7
+ .default("")
8
+ .describe("Fish Audio voice/clone reference ID"),
9
+ chunkLength: z
10
+ .number({ error: "fishAudio.chunkLength must be a number" })
11
+ .int("fishAudio.chunkLength must be an integer")
12
+ .min(100, "fishAudio.chunkLength must be >= 100")
13
+ .max(300, "fishAudio.chunkLength must be <= 300")
14
+ .default(200)
15
+ .describe("Text chunk size for streaming synthesis"),
16
+ format: z
17
+ .enum(["mp3", "wav", "opus"], {
18
+ error: "fishAudio.format must be one of: mp3, wav, opus",
19
+ })
20
+ .default("mp3")
21
+ .describe("Output audio format"),
22
+ latency: z
23
+ .enum(["normal", "balanced"], {
24
+ error: "fishAudio.latency must be one of: normal, balanced",
25
+ })
26
+ .default("normal")
27
+ .describe(
28
+ "Latency/quality tradeoff for Fish Audio S2 synthesis. 'normal' prioritizes lower latency; 'balanced' trades latency for higher quality.",
29
+ ),
30
+ speed: z
31
+ .number({ error: "fishAudio.speed must be a number" })
32
+ .min(0.5, "fishAudio.speed must be >= 0.5")
33
+ .max(2.0, "fishAudio.speed must be <= 2.0")
34
+ .default(1.0)
35
+ .describe("Playback speed multiplier (0.5 = slower, 2.0 = faster)"),
36
+ })
37
+ .describe("Fish Audio text-to-speech configuration");
38
+
39
+ export type FishAudioConfig = z.infer<typeof FishAudioConfigSchema>;
@@ -26,8 +26,8 @@ export const ThinkingConfigSchema = z
26
26
  .describe("Extended thinking (chain-of-thought) configuration");
27
27
 
28
28
  export const EffortSchema = z
29
- .enum(["low", "medium", "high"], {
30
- error: 'effort must be "low", "medium", or "high"',
29
+ .enum(["low", "medium", "high", "max"], {
30
+ error: 'effort must be "low", "medium", "high", or "max"',
31
31
  })
32
32
  .default("high")
33
33
  .describe(
@@ -0,0 +1,16 @@
1
+ import { z } from "zod";
2
+
3
+ export const JournalConfigSchema = z
4
+ .object({
5
+ contextWindowSize: z
6
+ .number({ error: "journal.contextWindowSize must be a number" })
7
+ .int("journal.contextWindowSize must be an integer")
8
+ .min(0, "journal.contextWindowSize must be >= 0")
9
+ .default(10)
10
+ .describe(
11
+ "Number of recent journal entries to include in context (0 to disable)",
12
+ ),
13
+ })
14
+ .describe("Journal context window configuration");
15
+
16
+ export type JournalConfig = z.infer<typeof JournalConfigSchema>;
@@ -12,7 +12,7 @@ export const MemoryExtractionConfigSchema = z
12
12
  .enum(["latency-optimized", "quality-optimized", "vision-optimized"], {
13
13
  error: "memory.extraction.modelIntent must be a valid model intent",
14
14
  })
15
- .default("latency-optimized")
15
+ .default("quality-optimized")
16
16
  .describe(
17
17
  "Model selection strategy for extraction — trade off speed vs quality",
18
18
  ),
@@ -39,7 +39,7 @@ export const MemorySummarizationConfigSchema = z
39
39
  .enum(["latency-optimized", "quality-optimized", "vision-optimized"], {
40
40
  error: "memory.summarization.modelIntent must be a valid model intent",
41
41
  })
42
- .default("latency-optimized")
42
+ .default("quality-optimized")
43
43
  .describe(
44
44
  "Model selection strategy for summarization — trade off speed vs quality",
45
45
  ),
@@ -50,10 +50,6 @@ export const SecretDetectionConfigSchema = z
50
50
  .describe(
51
51
  "Whether to allow sending a detected secret once (with user confirmation) before redacting future occurrences",
52
52
  ),
53
- blockIngress: z
54
- .boolean({ error: "secretDetection.blockIngress must be a boolean" })
55
- .default(true)
56
- .describe("Whether to block secrets in incoming ingress messages"),
57
53
  customPatterns: z
58
54
  .array(CustomSecretPatternSchema)
59
55
  .optional()
@@ -12,6 +12,7 @@ export type {
12
12
  ImageGenerationService,
13
13
  InferenceService,
14
14
  IngressConfig,
15
+ JournalConfig,
15
16
  LogFileConfig,
16
17
  MemoryConfig,
17
18
  MemoryEmbeddingsConfig,
@@ -35,7 +36,6 @@ export type {
35
36
  SkillsInstallConfig,
36
37
  SkillsLoadConfig,
37
38
  SlackConfig,
38
- SwarmConfig,
39
39
  ThinkingConfig,
40
40
  TimeoutConfig,
41
41
  UiConfig,
@@ -28,6 +28,36 @@ function escapeLike(value: string): string {
28
28
  return value.replace(/%/g, "").replace(/_/g, "");
29
29
  }
30
30
 
31
+ /**
32
+ * Generate a collision-free slugified filename for a contact's per-user persona file.
33
+ * Produces filenames like "alice.md", "alice-2.md", "alice-3.md", etc.
34
+ */
35
+ export function generateUserFileSlug(displayName: string): string {
36
+ const slug =
37
+ displayName
38
+ .toLowerCase()
39
+ .replace(/[^a-z0-9]+/g, "-")
40
+ .replace(/^-+|-+$/g, "")
41
+ .slice(0, 100) || "user";
42
+
43
+ const db = getDb();
44
+ const rows = db
45
+ .select({ userFile: contacts.userFile })
46
+ .from(contacts)
47
+ .where(like(contacts.userFile, `${escapeLike(slug)}%`))
48
+ .all();
49
+
50
+ const taken = new Set(rows.map((r) => r.userFile?.toLowerCase()));
51
+
52
+ const base = `${slug}.md`;
53
+ if (!taken.has(base)) return base;
54
+
55
+ for (let i = 2; ; i++) {
56
+ const candidate = `${slug}-${i}.md`;
57
+ if (!taken.has(candidate)) return candidate;
58
+ }
59
+ }
60
+
31
61
  function parseContact(row: typeof contacts.$inferSelect): Contact {
32
62
  return {
33
63
  id: row.id,
@@ -40,6 +70,7 @@ function parseContact(row: typeof contacts.$inferSelect): Contact {
40
70
  role: row.role as Contact["role"],
41
71
  contactType: (row.contactType as Contact["contactType"]) ?? "human",
42
72
  principalId: row.principalId,
73
+ userFile: row.userFile ?? null,
43
74
  };
44
75
  }
45
76
 
@@ -148,6 +179,7 @@ export function upsertContact(params: {
148
179
  role?: ContactRole;
149
180
  contactType?: ContactType;
150
181
  principalId?: string | null;
182
+ userFile?: string | null;
151
183
  channels?: SyncChannelData[];
152
184
  /** When true, conflicting channels on other contacts are reassigned to this
153
185
  * contact instead of being skipped. Used by invite redemption to bind a
@@ -177,6 +209,7 @@ export function upsertContact(params: {
177
209
  updateSet.contactType = params.contactType;
178
210
  if (params.principalId !== undefined)
179
211
  updateSet.principalId = params.principalId;
212
+ if (params.userFile !== undefined) updateSet.userFile = params.userFile;
180
213
 
181
214
  db.update(contacts)
182
215
  .set(updateSet)
@@ -224,6 +257,7 @@ export function upsertContact(params: {
224
257
  updateSet.contactType = params.contactType;
225
258
  if (params.principalId !== undefined)
226
259
  updateSet.principalId = params.principalId;
260
+ if (params.userFile !== undefined) updateSet.userFile = params.userFile;
227
261
 
228
262
  db.update(contacts)
229
263
  .set(updateSet)
@@ -239,6 +273,10 @@ export function upsertContact(params: {
239
273
 
240
274
  // Create new contact
241
275
  contactId = contactId ?? uuid();
276
+ const userFileValue =
277
+ params.userFile !== undefined
278
+ ? params.userFile
279
+ : generateUserFileSlug(params.displayName);
242
280
  db.insert(contacts)
243
281
  .values({
244
282
  id: contactId,
@@ -247,6 +285,7 @@ export function upsertContact(params: {
247
285
  role: params.role ?? "contact",
248
286
  contactType: params.contactType ?? "human",
249
287
  principalId: params.principalId ?? null,
288
+ userFile: userFileValue ?? null,
250
289
  createdAt: now,
251
290
  updatedAt: now,
252
291
  })
@@ -44,6 +44,8 @@ export interface Contact {
44
44
  * identified by channel address instead.
45
45
  */
46
46
  principalId: string | null;
47
+ /** Workspace-relative path to a per-user persona file for this contact. */
48
+ userFile: string | null;
47
49
  }
48
50
 
49
51
  export type ChannelStatus =
@@ -103,6 +103,7 @@ function mapUserDecisionToCesDecision(
103
103
  userDecision: decision,
104
104
  };
105
105
  case "temporary_override":
106
+ case "dangerously_skip_permissions":
106
107
  return {
107
108
  grantDecision: "approved",
108
109
  ttl: undefined,
@@ -79,6 +79,11 @@ export interface LocalDiscoverySuccess {
79
79
  executablePath: string;
80
80
  }
81
81
 
82
+ export interface LocalSourceDiscoverySuccess {
83
+ mode: "local-source";
84
+ sourcePath: string;
85
+ }
86
+
82
87
  export interface ManagedDiscoverySuccess {
83
88
  mode: "managed";
84
89
  socketPath: string;
@@ -91,6 +96,7 @@ export interface DiscoveryFailure {
91
96
 
92
97
  export type DiscoveryResult =
93
98
  | LocalDiscoverySuccess
99
+ | LocalSourceDiscoverySuccess
94
100
  | ManagedDiscoverySuccess
95
101
  | DiscoveryFailure;
96
102
 
@@ -101,11 +107,16 @@ export type DiscoveryResult =
101
107
  /**
102
108
  * Discover the local CES executable.
103
109
  *
104
- * Searches well-known paths for the `credential-executor` binary. Returns
105
- * a structured result never throws. If the binary is not found, returns
110
+ * Searches well-known paths for the `credential-executor` binary. If the
111
+ * compiled binary is not found, falls back to the TypeScript source entry
112
+ * point in the monorepo. Returns a structured result — never throws. If
113
+ * neither the binary nor the source entry point is found, returns
106
114
  * `{ mode: "unavailable" }` so the caller can fail closed.
107
115
  */
108
- export function discoverLocalCes(): LocalDiscoverySuccess | DiscoveryFailure {
116
+ export function discoverLocalCes():
117
+ | LocalDiscoverySuccess
118
+ | LocalSourceDiscoverySuccess
119
+ | DiscoveryFailure {
109
120
  const searchPaths = getLocalBinarySearchPaths();
110
121
 
111
122
  for (const candidate of searchPaths) {
@@ -115,7 +126,20 @@ export function discoverLocalCes(): LocalDiscoverySuccess | DiscoveryFailure {
115
126
  }
116
127
  }
117
128
 
118
- const reason = `CES executable not found. Searched: ${searchPaths.join(", ")}`;
129
+ // Fallback: check for source entry point in the monorepo
130
+ const monorepoRoot = join(import.meta.dir, "..", "..", "..");
131
+ const sourceEntry = join(
132
+ monorepoRoot,
133
+ "credential-executor",
134
+ "src",
135
+ "main.ts",
136
+ );
137
+ if (existsSync(sourceEntry)) {
138
+ log.info({ path: sourceEntry }, "Found local CES source entry point");
139
+ return { mode: "local-source", sourcePath: sourceEntry };
140
+ }
141
+
142
+ const reason = `CES executable not found. Searched: ${searchPaths.join(", ")}; also checked source at ${sourceEntry}`;
119
143
  log.warn(reason);
120
144
  return { mode: "unavailable", reason };
121
145
  }
@@ -35,6 +35,10 @@ export const CES_GRANT_AUDIT_FLAG_KEY =
35
35
  export const CES_MANAGED_SIDECAR_FLAG_KEY =
36
36
  "feature_flags.ces-managed-sidecar.enabled" as const;
37
37
 
38
+ /** Gate for routing credential reads/writes through the CES process. */
39
+ export const CES_CREDENTIAL_BACKEND_FLAG_KEY =
40
+ "feature_flags.ces-credential-backend.enabled" as const;
41
+
38
42
  // ---------------------------------------------------------------------------
39
43
  // Public API — predicate functions
40
44
  // ---------------------------------------------------------------------------
@@ -73,3 +77,15 @@ export function isCesGrantAuditEnabled(config: AssistantConfig): boolean {
73
77
  export function isCesManagedSidecarEnabled(config: AssistantConfig): boolean {
74
78
  return isAssistantFeatureFlagEnabled(CES_MANAGED_SIDECAR_FLAG_KEY, config);
75
79
  }
80
+
81
+ /**
82
+ * Whether credential reads and writes should be routed through the CES process.
83
+ */
84
+ export function isCesCredentialBackendEnabled(
85
+ config: AssistantConfig,
86
+ ): boolean {
87
+ return isAssistantFeatureFlagEnabled(
88
+ CES_CREDENTIAL_BACKEND_FLAG_KEY,
89
+ config,
90
+ );
91
+ }