@vellumai/assistant 0.5.5 → 0.5.7

package/src/config/env.ts

@@ -51,9 +51,15 @@ export function getGatewayPort(): number {
   return int("GATEWAY_PORT", DEFAULT_GATEWAY_PORT);
 }
 
-/** Resolve the gateway base URL for internal service-to-service calls. */
+/**
+ * Resolve the gateway base URL for internal service-to-service calls.
+ *
+ * In containerized deployments the gateway runs in a separate container,
+ * reachable via `GATEWAY_INTERNAL_URL` (e.g. `http://gateway:7822`).
+ * Falls back to `http://127.0.0.1:<GATEWAY_PORT>` for local deployments.
+ */
 export function getGatewayInternalBaseUrl(): string {
-  return `http://127.0.0.1:${getGatewayPort()}`;
+  return str("GATEWAY_INTERNAL_URL") ?? `http://127.0.0.1:${getGatewayPort()}`;
 }
 
 // ── Ingress ──────────────────────────────────────────────────────────────────
@@ -105,15 +111,8 @@ export function hasUngatedHttpAuthDisabled(): boolean {
 
 // ── Monitoring ───────────────────────────────────────────────────────────────
 
-export function getLogfireToken(): string | undefined {
-  return str("LOGFIRE_TOKEN");
-}
-
-const DEFAULT_SENTRY_DSN =
-  "https://db2d38a082e4ee35eeaea08c44b376ec@o4504590528675840.ingest.us.sentry.io/4510874712276992";
-
 export function getSentryDsn(): string {
-  return str("SENTRY_DSN") ?? DEFAULT_SENTRY_DSN;
+  return str("SENTRY_DSN_ASSISTANT") ?? "";
 }
 
 // ── Qdrant ───────────────────────────────────────────────────────────────────
@@ -126,6 +125,10 @@ export function getQdrantHttpPortEnv(): number | undefined {
   return int("QDRANT_HTTP_PORT");
 }
 
+export function getQdrantReadyzTimeoutMs(): number | undefined {
+  return int("QDRANT_READYZ_TIMEOUT_MS");
+}
+
 // ── Ollama ───────────────────────────────────────────────────────────────────
 
 export function getOllamaBaseUrlEnv(): string | undefined {
@@ -141,7 +144,7 @@ export function setPlatformBaseUrl(value: string | undefined): void {
 }
 
 export function getPlatformBaseUrl(): string {
-  return str("PLATFORM_BASE_URL") ?? _platformBaseUrlOverride ?? "";
+  return str("VELLUM_PLATFORM_URL") ?? _platformBaseUrlOverride ?? "";
 }
 
 let _platformAssistantIdOverride: string | undefined;
@@ -199,14 +202,11 @@ export function getPlatformInternalApiKey(): string {
 // ── Telemetry ──────────────────────────────────────────────────────────────────
 
 export function getTelemetryPlatformUrl(): string {
-  return str("TELEMETRY_PLATFORM_URL") ?? "https://platform.vellum.ai";
+  return str("TELEMETRY_PLATFORM_URL") ?? "";
 }
 
 export function getTelemetryAppToken(): string {
-  return (
-    str("TELEMETRY_APP_TOKEN") ??
-    "e01cf85768cc3617e986f0a7f1966b72e25316526c5db54c8b94a9c3c5c9eaed"
-  );
+  return str("TELEMETRY_APP_TOKEN") ?? "";
 }
 
 // ── Startup validation ──────────────────────────────────────────────────────

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

@@ -17,6 +17,14 @@
       "description": "Enable user-hosted onboarding flow",
       "defaultEnabled": false
     },
+    {
+      "id": "platform-hosted-enabled",
+      "scope": "macos",
+      "key": "platform_hosted_enabled",
+      "label": "Platform Hosted Assistants",
+      "description": "Enable the Vellum Cloud hosting option on the Hosting screen",
+      "defaultEnabled": false
+    },
     {
       "id": "contacts",
       "scope": "assistant",
@@ -25,14 +33,6 @@
       "description": "Show the Contacts tab in Settings for viewing and managing contacts",
       "defaultEnabled": true
     },
-    {
-      "id": "custom-inference-provider",
-      "scope": "macos",
-      "key": "custom_inference_provider_enabled",
-      "label": "Custom Inference Provider",
-      "description": "Allow selecting a specific LLM provider and model for inference in Your Own mode",
-      "defaultEnabled": false
-    },
     {
       "id": "email-channel",
       "scope": "assistant",
@@ -73,14 +73,6 @@
       "description": "Show Component Gallery and Replay Onboarding in the menu bar",
       "defaultEnabled": false
     },
-    {
-      "id": "logfire",
-      "scope": "assistant",
-      "key": "feature_flags.logfire.enabled",
-      "label": "Logfire LLM Observability",
-      "description": "Enable Logfire tracing for LLM request/response telemetry when LOGFIRE_TOKEN is set",
-      "defaultEnabled": false
-    },
     {
       "id": "ces-tools",
       "scope": "assistant",
@@ -121,6 +113,14 @@
       "description": "Use managed sidecar transport for CES communication when running in a containerized environment",
       "defaultEnabled": false
     },
+    {
+      "id": "ces-credential-backend",
+      "scope": "assistant",
+      "key": "feature_flags.ces-credential-backend.enabled",
+      "label": "CES Credential Backend",
+      "description": "Route credential reads and writes through the CES process instead of accessing the encrypted store directly",
+      "defaultEnabled": true
+    },
     {
       "id": "settings-billing",
       "scope": "macos",
@@ -265,6 +265,14 @@
       "description": "Show the Embedding service card in Models & Services settings",
       "defaultEnabled": false
     },
+    {
+      "id": "settings-schedules",
+      "scope": "assistant",
+      "key": "feature_flags.settings-schedules.enabled",
+      "label": "Schedules Settings Tab",
+      "description": "Show the Schedules tab in Settings for viewing and managing schedules",
+      "defaultEnabled": false
+    },
     {
       "id": "quick-input",
       "scope": "macos",
@@ -296,6 +304,30 @@
       "label": "Channel Voice Transcription",
       "description": "Auto-transcribe voice/audio messages received from channels (Telegram, WhatsApp) before processing",
       "defaultEnabled": true
+    },
+    {
+      "id": "sounds",
+      "scope": "assistant",
+      "key": "feature_flags.sounds.enabled",
+      "label": "Sounds",
+      "description": "Enable the Sounds tab in Settings and all app sound playback (event sounds, random ambient sounds)",
+      "defaultEnabled": true
+    },
+    {
+      "id": "message-tts",
+      "scope": "assistant",
+      "key": "feature_flags.message-tts.enabled",
+      "label": "Message Text-to-Speech",
+      "description": "Show a speaker button on assistant messages to generate and play the message as audio via Fish Audio TTS",
+      "defaultEnabled": false
+    },
+    {
+      "id": "backward-releases",
+      "scope": "assistant",
+      "key": "feature_flags.backward-releases.enabled",
+      "label": "Backward Releases",
+      "description": "Show older versions in the version picker, allowing rollback to previous releases",
+      "defaultEnabled": true
     }
   ]
 }

package/src/config/loader.ts

@@ -2,19 +2,15 @@ import {
   existsSync,
   mkdirSync,
   readFileSync,
+  renameSync,
   statSync,
   writeFileSync,
 } from "node:fs";
-import { dirname } from "node:path";
+import { dirname, join } from "node:path";
 
 import { ConfigError } from "../util/errors.js";
 import { getLogger } from "../util/logger.js";
-import {
-  ensureDataDir,
-  getWorkspaceConfigPath,
-  readLockfile,
-  writeLockfile,
-} from "../util/platform.js";
+import { ensureDataDir, getWorkspaceConfigPath } from "../util/platform.js";
 import { AssistantConfigSchema } from "./schema.js";
 import type { AssistantConfig } from "./types.js";
 
@@ -214,6 +210,35 @@ export function deepMergeMissing(
   return changed;
 }
 
+/**
+ * Deep-merge `overrides` into `target`, overwriting leaf values.
+ * Recursively merges nested objects; scalars and arrays from `overrides`
+ * replace corresponding values in `target`.
+ */
+export function deepMergeOverwrite(
+  target: Record<string, unknown>,
+  overrides: Record<string, unknown>,
+): void {
+  for (const key of Object.keys(overrides)) {
+    const ov = overrides[key];
+    if (
+      ov != null &&
+      typeof ov === "object" &&
+      !Array.isArray(ov) &&
+      target[key] != null &&
+      typeof target[key] === "object" &&
+      !Array.isArray(target[key])
+    ) {
+      deepMergeOverwrite(
+        target[key] as Record<string, unknown>,
+        ov as Record<string, unknown>,
+      );
+    } else {
+      target[key] = ov;
+    }
+  }
+}
+
 /**
  * Read the existing config.json from disk, merge any missing schema-default
  * keys, and rewrite only when there is an effective change.
@@ -248,6 +273,72 @@ function backfillConfigDefaults(
   }
 }
 
+/**
+ * Merge default workspace config from the file referenced by
+ * VELLUM_DEFAULT_WORKSPACE_CONFIG_PATH into the workspace config on disk.
+ *
+ * Called once at daemon startup (before the first loadConfig()) so the
+ * defaults are persisted to the workspace config file alongside any
+ * schema-level defaults that loadConfig() backfills.
+ */
+export function mergeDefaultWorkspaceConfig(): void {
+  const defaultConfigPath = process.env.VELLUM_DEFAULT_WORKSPACE_CONFIG_PATH;
+  if (!defaultConfigPath || !existsSync(defaultConfigPath)) return;
+
+  let defaults: unknown;
+  try {
+    defaults = JSON.parse(readFileSync(defaultConfigPath, "utf-8"));
+  } catch (err) {
+    log.warn(
+      { err },
+      "Failed to read default workspace config from %s",
+      defaultConfigPath,
+    );
+    return;
+  }
+
+  if (
+    defaults == null ||
+    typeof defaults !== "object" ||
+    Array.isArray(defaults)
+  ) {
+    return;
+  }
+
+  const configPath = getConfigPath();
+  let existing: Record<string, unknown> = {};
+  if (existsSync(configPath)) {
+    try {
+      existing = JSON.parse(readFileSync(configPath, "utf-8"));
+    } catch {
+      // If existing config is corrupt, start fresh
+    }
+  }
+
+  deepMergeOverwrite(existing, defaults as Record<string, unknown>);
+
+  const dir = dirname(configPath);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  writeFileSync(configPath, JSON.stringify(existing, null, 2) + "\n");
+
+  // Move the temp file into the workspace directory as a permanent record.
+  // This prevents re-application on daemon restart (the env var still points
+  // at the old /tmp path which no longer exists).
+  try {
+    const dest = join(dir, "default-config.json");
+    renameSync(defaultConfigPath, dest);
+    log.info(
+      "Merged default workspace config from %s (archived to %s)",
+      defaultConfigPath,
+      dest,
+    );
+  } catch {
+    log.info("Merged default workspace config from %s", defaultConfigPath);
+  }
+}
+
 export function loadConfig(): AssistantConfig {
   if (cached) return cached;
 
@@ -375,30 +466,6 @@ export function saveRawConfig(config: Record<string, unknown>): void {
   cached = null; // invalidate cache
 }
 
-/**
- * Sync client-relevant config values (e.g. platform.baseUrl) to the lockfile
- * so external tools (e.g. vel) can discover them without importing the full
- * config schema.  Mirrors the behaviour of `syncConfigToLockfile` in the
- * lightweight CLI (`cli/src/lib/assistant-config.ts`).
- */
-export function syncConfigToLockfile(): void {
-  const configPath = getWorkspaceConfigPath();
-  if (!existsSync(configPath)) return;
-
-  try {
-    const raw = JSON.parse(readFileSync(configPath, "utf-8")) as Record<
-      string,
-      unknown
-    >;
-    const platform = raw.platform as Record<string, unknown> | undefined;
-    const data = readLockfile() ?? {};
-    data.platformBaseUrl = (platform?.baseUrl as string) || undefined;
-    writeLockfile(data);
-  } catch {
-    // Config file unreadable — skip sync
-  }
-}
-
 export function getNestedValue(
   obj: Record<string, unknown>,
   path: string,

package/src/config/schema.ts

@@ -40,6 +40,8 @@ export {
   ElevenLabsConfigSchema,
   VALID_CONVERSATION_TIMEOUTS,
 } from "./schemas/elevenlabs.js";
+export type { FishAudioConfig } from "./schemas/fish-audio.js";
+export { FishAudioConfigSchema } from "./schemas/fish-audio.js";
 export type { HeartbeatConfig } from "./schemas/heartbeat.js";
 export { HeartbeatConfigSchema } from "./schemas/heartbeat.js";
 export type {
@@ -106,18 +108,6 @@ export {
   MemoryDynamicBudgetConfigSchema,
   MemoryRetrievalConfigSchema,
 } from "./schemas/memory-retrieval.js";
-export type {
-  MemorySimplifiedArchiveRecallConfig,
-  MemorySimplifiedBriefConfig,
-  MemorySimplifiedConfig,
-  MemorySimplifiedReducerConfig,
-} from "./schemas/memory-simplified.js";
-export {
-  MemorySimplifiedArchiveRecallConfigSchema,
-  MemorySimplifiedBriefConfigSchema,
-  MemorySimplifiedConfigSchema,
-  MemorySimplifiedReducerConfigSchema,
-} from "./schemas/memory-simplified.js";
 export type {
   MemoryEmbeddingsConfig,
   MemorySegmentationConfig,
@@ -185,8 +175,6 @@ export {
   SkillsInstallConfigSchema,
   SkillsLoadConfigSchema,
 } from "./schemas/skills.js";
-export type { SwarmConfig } from "./schemas/swarm.js";
-export { SwarmConfigSchema } from "./schemas/swarm.js";
 export type { RateLimitConfig, TimeoutConfig } from "./schemas/timeouts.js";
 export {
   RateLimitConfigSchema,
@@ -205,6 +193,7 @@ import {
   WhatsAppConfigSchema,
 } from "./schemas/channels.js";
 import { ElevenLabsConfigSchema } from "./schemas/elevenlabs.js";
+import { FishAudioConfigSchema } from "./schemas/fish-audio.js";
 import { HeartbeatConfigSchema } from "./schemas/heartbeat.js";
 import {
   ContextWindowConfigSchema,
@@ -235,7 +224,6 @@ import {
   VALID_INFERENCE_PROVIDERS,
 } from "./schemas/services.js";
 import { SkillsConfigSchema } from "./schemas/skills.js";
-import { SwarmConfigSchema } from "./schemas/swarm.js";
 import {
   RateLimitConfigSchema,
   TimeoutConfigSchema,
@@ -293,7 +281,6 @@ export const AssistantConfigSchema = z
         "Custom pricing overrides for specific provider/model combinations",
       ),
     heartbeat: HeartbeatConfigSchema.default(HeartbeatConfigSchema.parse({})),
-    swarm: SwarmConfigSchema.default(SwarmConfigSchema.parse({})),
     mcp: McpConfigSchema.default(McpConfigSchema.parse({})),
     acp: AcpConfigSchema.default(AcpConfigSchema.parse({})),
     skills: SkillsConfigSchema.default(SkillsConfigSchema.parse({})),
@@ -305,6 +292,7 @@ export const AssistantConfigSchema = z
     elevenlabs: ElevenLabsConfigSchema.default(
       ElevenLabsConfigSchema.parse({}),
     ),
+    fishAudio: FishAudioConfigSchema.default(FishAudioConfigSchema.parse({})),
     whatsapp: WhatsAppConfigSchema.default(WhatsAppConfigSchema.parse({})),
     telegram: TelegramConfigSchema.default(TelegramConfigSchema.parse({})),
     slack: SlackConfigSchema.default(SlackConfigSchema.parse({})),
@@ -315,15 +303,6 @@ export const AssistantConfigSchema = z
       NotificationsConfigSchema.parse({}),
     ),
     ui: UiConfigSchema.default(UiConfigSchema.parse({})),
-    assistantFeatureFlagValues: z
-      .record(
-        z.string(),
-        z.boolean({
-          error: "assistantFeatureFlagValues values must be booleans",
-        }),
-      )
-      .optional()
-      .describe("Feature flag overrides — map of flag names to boolean values"),
     collectUsageData: z
       .boolean()
       .default(true)

package/src/config/schemas/calls.ts

@@ -6,6 +6,7 @@ export const VALID_CALLER_IDENTITY_MODES = [
   "user_number",
 ] as const;
 const VALID_CALL_TRANSCRIPTION_PROVIDERS = ["Deepgram", "Google"] as const;
+export const VALID_TTS_PROVIDERS = ["elevenlabs", "fish-audio"] as const;
 
 export const CallsDisclosureConfigSchema = z
   .object({
@@ -57,6 +58,18 @@ export const CallsVoiceConfigSchema = z
       })
       .default("Deepgram")
       .describe("Speech-to-text provider used for call transcription"),
+    speechModel: z
+      .string({ error: "calls.voice.speechModel must be a string" })
+      .optional()
+      .describe(
+        "ASR model to use for speech recognition (e.g. nova-3, nova-2-phonecall for Deepgram; telephony, long for Google)",
+      ),
+    ttsProvider: z
+      .enum(VALID_TTS_PROVIDERS, {
+        error: `calls.voice.ttsProvider must be one of: ${VALID_TTS_PROVIDERS.join(", ")}`,
+      })
+      .default("elevenlabs")
+      .describe("Text-to-speech provider for phone calls"),
   })
   .describe("Voice and speech settings for phone calls");
 

package/src/config/schemas/fish-audio.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+
+export const FishAudioConfigSchema = z
+  .object({
+    referenceId: z
+      .string({ error: "fishAudio.referenceId must be a string" })
+      .default("")
+      .describe("Fish Audio voice/clone reference ID"),
+    chunkLength: z
+      .number({ error: "fishAudio.chunkLength must be a number" })
+      .int("fishAudio.chunkLength must be an integer")
+      .min(100, "fishAudio.chunkLength must be >= 100")
+      .max(300, "fishAudio.chunkLength must be <= 300")
+      .default(200)
+      .describe("Text chunk size for streaming synthesis"),
+    format: z
+      .enum(["mp3", "wav", "opus"], {
+        error: "fishAudio.format must be one of: mp3, wav, opus",
+      })
+      .default("mp3")
+      .describe("Output audio format"),
+    latency: z
+      .enum(["normal", "balanced"], {
+        error: "fishAudio.latency must be one of: normal, balanced",
+      })
+      .default("normal")
+      .describe(
+        "Latency/quality tradeoff for Fish Audio S2 synthesis. 'normal' prioritizes lower latency; 'balanced' trades latency for higher quality.",
+      ),
+    speed: z
+      .number({ error: "fishAudio.speed must be a number" })
+      .min(0.5, "fishAudio.speed must be >= 0.5")
+      .max(2.0, "fishAudio.speed must be <= 2.0")
+      .default(1.0)
+      .describe("Playback speed multiplier (0.5 = slower, 2.0 = faster)"),
+  })
+  .describe("Fish Audio text-to-speech configuration");
+
+export type FishAudioConfig = z.infer<typeof FishAudioConfigSchema>;

package/src/config/schemas/memory.ts

@@ -10,7 +10,6 @@ import {
   MemorySummarizationConfigSchema,
 } from "./memory-processing.js";
 import { MemoryRetrievalConfigSchema } from "./memory-retrieval.js";
-import { MemorySimplifiedConfigSchema } from "./memory-simplified.js";
 import {
   MemoryEmbeddingsConfigSchema,
   MemorySegmentationConfigSchema,
@@ -46,9 +45,6 @@ export const MemoryConfigSchema = z
     summarization: MemorySummarizationConfigSchema.default(
       MemorySummarizationConfigSchema.parse({}),
     ),
-    simplified: MemorySimplifiedConfigSchema.default(
-      MemorySimplifiedConfigSchema.parse({}),
-    ),
   })
   .describe(
     "Long-term memory system — stores, retrieves, and manages persistent knowledge across conversations",

package/src/config/schemas/platform.ts

@@ -43,7 +43,7 @@ export const DaemonConfigSchema = z
       .number({ error: "daemon.titleGenerationMaxTokens must be a number" })
       .int("daemon.titleGenerationMaxTokens must be an integer")
       .positive("daemon.titleGenerationMaxTokens must be a positive integer")
-      .default(30)
+      .default(50)
       .describe(
         "Maximum number of tokens for auto-generated conversation titles",
       ),

package/src/config/schemas/security.ts

@@ -50,10 +50,6 @@ export const SecretDetectionConfigSchema = z
       .describe(
         "Whether to allow sending a detected secret once (with user confirmation) before redacting future occurrences",
       ),
-    blockIngress: z
-      .boolean({ error: "secretDetection.blockIngress must be a boolean" })
-      .default(true)
-      .describe("Whether to block secrets in incoming ingress messages"),
     customPatterns: z
       .array(CustomSecretPatternSchema)
       .optional()
@@ -77,6 +73,10 @@ export const PermissionsConfigSchema = z
       .describe(
         "Permission mode — 'strict' requires explicit approval for all operations, 'workspace' allows operations within the workspace",
       ),
+    dangerouslySkipPermissions: z
+      .boolean({ error: "permissions.dangerouslySkipPermissions must be a boolean" })
+      .default(false)
+      .describe("Auto-accept all permission prompts without asking"),
   })
   .describe("Permission enforcement mode for tool operations");
 

package/src/config/types.ts

@@ -35,7 +35,6 @@ export type {
   SkillsInstallConfig,
   SkillsLoadConfig,
   SlackConfig,
-  SwarmConfig,
   ThinkingConfig,
   TimeoutConfig,
   UiConfig,

package/src/contacts/contact-store.ts

@@ -28,6 +28,36 @@ function escapeLike(value: string): string {
   return value.replace(/%/g, "").replace(/_/g, "");
 }
 
+/**
+ * Generate a collision-free slugified filename for a contact's per-user persona file.
+ * Produces filenames like "alice.md", "alice-2.md", "alice-3.md", etc.
+ */
+export function generateUserFileSlug(displayName: string): string {
+  const slug =
+    displayName
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, "-")
+      .replace(/^-+|-+$/g, "")
+      .slice(0, 50) || "user";
+
+  const db = getDb();
+  const rows = db
+    .select({ userFile: contacts.userFile })
+    .from(contacts)
+    .where(like(contacts.userFile, `${escapeLike(slug)}%`))
+    .all();
+
+  const taken = new Set(rows.map((r) => r.userFile));
+
+  const base = `${slug}.md`;
+  if (!taken.has(base)) return base;
+
+  for (let i = 2; ; i++) {
+    const candidate = `${slug}-${i}.md`;
+    if (!taken.has(candidate)) return candidate;
+  }
+}
+
 function parseContact(row: typeof contacts.$inferSelect): Contact {
   return {
     id: row.id,
@@ -40,6 +70,7 @@ function parseContact(row: typeof contacts.$inferSelect): Contact {
     role: row.role as Contact["role"],
     contactType: (row.contactType as Contact["contactType"]) ?? "human",
     principalId: row.principalId,
+    userFile: row.userFile ?? null,
   };
 }
 
@@ -148,6 +179,7 @@ export function upsertContact(params: {
   role?: ContactRole;
   contactType?: ContactType;
   principalId?: string | null;
+  userFile?: string | null;
   channels?: SyncChannelData[];
   /** When true, conflicting channels on other contacts are reassigned to this
    *  contact instead of being skipped. Used by invite redemption to bind a
@@ -177,6 +209,7 @@ export function upsertContact(params: {
         updateSet.contactType = params.contactType;
       if (params.principalId !== undefined)
         updateSet.principalId = params.principalId;
+      if (params.userFile !== undefined) updateSet.userFile = params.userFile;
 
       db.update(contacts)
         .set(updateSet)
@@ -224,6 +257,7 @@ export function upsertContact(params: {
           updateSet.contactType = params.contactType;
         if (params.principalId !== undefined)
           updateSet.principalId = params.principalId;
+        if (params.userFile !== undefined) updateSet.userFile = params.userFile;
 
         db.update(contacts)
           .set(updateSet)
@@ -239,6 +273,10 @@ export function upsertContact(params: {
 
   // Create new contact
   contactId = contactId ?? uuid();
+  const userFileValue =
+    params.userFile !== undefined
+      ? params.userFile
+      : generateUserFileSlug(params.displayName);
   db.insert(contacts)
     .values({
       id: contactId,
@@ -247,6 +285,7 @@ export function upsertContact(params: {
       role: params.role ?? "contact",
       contactType: params.contactType ?? "human",
       principalId: params.principalId ?? null,
+      userFile: userFileValue ?? null,
       createdAt: now,
       updatedAt: now,
     })

package/src/contacts/types.ts

@@ -44,6 +44,8 @@ export interface Contact {
    * identified by channel address instead.
    */
   principalId: string | null;
+  /** Workspace-relative path to a per-user persona file for this contact. */
+  userFile: string | null;
 }
 
 export type ChannelStatus =