@vellumai/assistant 0.4.52 → 0.4.54

package/src/config/bundled-skills/media-processing/tools/extract-keyframes.ts

@@ -1,10 +1,10 @@
 import { dirname, join } from "node:path";
 
-import { getConfig } from "../../../../config/loader.js";
 import {
   getKeyframesForAsset,
   getMediaAssetById,
 } from "../../../../memory/media-store.js";
+import { getSecureKeyAsync } from "../../../../security/secure-keys.js";
 import type {
   ToolContext,
   ToolExecutionResult,
@@ -31,8 +31,7 @@ export async function run(
 
   let openaiApiKey: string | undefined;
   if (includeAudio && (!transcriptionMode || transcriptionMode === "api")) {
-    const config = getConfig();
-    openaiApiKey = config.apiKeys.openai;
+    openaiApiKey = (await getSecureKeyAsync("openai")) ?? undefined;
   }
 
   const options: PreprocessOptions = {

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

@@ -7,7 +7,6 @@ metadata:
   vellum:
     display-name: "Messaging"
     user-invocable: true
-    feature-flag: "messaging"
 ---
 
 You are a unified messaging assistant with access to multiple platforms (Slack, Gmail, Telegram, and more). Use the messaging tools to help users read, search, organize, draft, and send messages across all connected platforms.

package/src/config/bundled-skills/phone-calls/references/CONFIG.md

@@ -15,7 +15,7 @@ All call-related settings can be managed via `assistant config`:
 | `calls.callerIdentity.userNumber`           | E.164 phone number for user-number mode                                                                                       | _(empty)_                                                                                                |
 | `calls.voice.language`                      | Language code for TTS and transcription                                                                                       | `en-US`                                                                                                  |
 | `calls.voice.transcriptionProvider`         | Speech-to-text provider (`Deepgram`, `Google`)                                                                                | `Deepgram`                                                                                               |
-| `elevenlabs.voiceId`                        | ElevenLabs voice ID used by both in-app TTS and phone calls. Set during setup from the curated voice list. Defaults to Rachel | `21m00Tcm4TlvDq8ikWAM`                                                                                   |
+| `elevenlabs.voiceId`                        | ElevenLabs voice ID used by both in-app TTS and phone calls. Set during setup from the curated voice list. Defaults to Amelia | `ZF6FPAbjXT4488VcRRnw`                                                                                   |
 | `elevenlabs.voiceModelId`                   | Optional Twilio ConversationRelay model suffix. Leave empty to send bare `voiceId`                                            | _(empty)_                                                                                                |
 | `elevenlabs.speed`                          | Playback speed (`0.7` – `1.2`)                                                                                                | `1.0`                                                                                                    |
 | `elevenlabs.stability`                      | Voice stability (`0.0` – `1.0`)                                                                                               | `0.5`                                                                                                    |

package/src/config/bundled-skills/sequences/SKILL.md

@@ -7,7 +7,6 @@ metadata:
   vellum:
     display-name: "Email Sequences"
     user-invocable: true
-    feature-flag: "sequences"
 ---
 
 You are an email sequence assistant. Use the sequence tools to help users create and manage automated multi-step email drip campaigns.

package/src/config/bundled-skills/transcribe/tools/transcribe-media.ts

@@ -10,8 +10,8 @@ import {
 import { tmpdir } from "node:os";
 import { extname, join } from "node:path";
 
-import { getConfig } from "../../../../config/loader.js";
 import { getAttachmentsByIds } from "../../../../memory/attachments-store.js";
+import { getSecureKeyAsync } from "../../../../security/secure-keys.js";
 import type {
   ToolContext,
   ToolExecutionResult,
@@ -417,10 +417,10 @@ export async function run(
   }
 
   // Validate API key for api mode
+  let openaiKey: string | undefined;
   if (mode === "api") {
-    const config = getConfig();
-    const apiKey = config.apiKeys.openai;
-    if (!apiKey) {
+    openaiKey = await getSecureKeyAsync("openai");
+    if (!openaiKey) {
       return {
         content:
           'No OpenAI API key configured. Set your OpenAI API key to use cloud transcription, or use mode "local" for on-device transcription with whisper.cpp.',
@@ -441,8 +441,7 @@ export async function run(
 
     let text: string;
     if (mode === "api") {
-      const config = getConfig();
-      text = await transcribeViaApi(wavPath, config.apiKeys.openai!, context);
+      text = await transcribeViaApi(wavPath, openaiKey!, context);
     } else {
       text = await transcribeViaLocal(wavPath, context);
     }

package/src/config/env.ts

@@ -154,6 +154,19 @@ export function getPlatformInternalApiKey(): string {
   return str("PLATFORM_INTERNAL_API_KEY") ?? "";
 }
 
+// ── Telemetry ──────────────────────────────────────────────────────────────────
+
+export function getTelemetryPlatformUrl(): string {
+  return str("TELEMETRY_PLATFORM_URL") ?? "https://platform.vellum.ai";
+}
+
+export function getTelemetryAppToken(): string {
+  return (
+    str("TELEMETRY_APP_TOKEN") ??
+    "e01cf85768cc3617e986f0a7f1966b72e25316526c5db54c8b94a9c3c5c9eaed"
+  );
+}
+
 // ── Startup validation ──────────────────────────────────────────────────────
 
 /**

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

@@ -25,20 +25,12 @@
       "description": "Enable browser skill prerequisites section in the system prompt",
       "defaultEnabled": true
     },
-    {
-      "id": "messaging",
-      "scope": "assistant",
-      "key": "feature_flags.messaging.enabled",
-      "label": "Messaging",
-      "description": "Enable messaging skill section in the system prompt",
-      "defaultEnabled": true
-    },
     {
       "id": "collect-usage-data",
       "scope": "assistant",
       "key": "feature_flags.collect-usage-data.enabled",
       "label": "Collect usage data",
-      "description": "Send crash reports and error diagnostics to help improve the app",
+      "description": "Send crash reports, error diagnostics, and anonymized usage telemetry to help improve the app",
       "defaultEnabled": true
     },
     {
@@ -49,14 +41,6 @@
       "description": "Enable user-hosted onboarding flow",
       "defaultEnabled": false
     },
-    {
-      "id": "command-palette",
-      "scope": "assistant",
-      "key": "feature_flags.command-palette.enabled",
-      "label": "Command Palette",
-      "description": "Enable the CMD+K command palette for unified search across conversations, memories, schedules, and contacts",
-      "defaultEnabled": false
-    },
     {
       "id": "contacts",
       "scope": "assistant",
@@ -73,14 +57,6 @@
       "description": "Show the Email channel card on the Contacts page and enable the email-setup skill",
       "defaultEnabled": false
     },
-    {
-      "id": "outbound-proxy-sidecar",
-      "scope": "assistant",
-      "key": "feature_flags.outbound-proxy-sidecar.enabled",
-      "label": "Outbound Proxy Sidecar",
-      "description": "Route proxy session management through the sidecar process instead of running in-process",
-      "defaultEnabled": false
-    },
     {
       "id": "app-builder-multifile",
       "scope": "assistant",
@@ -98,20 +74,12 @@
       "defaultEnabled": false
     },
     {
-      "id": "gmail",
-      "scope": "assistant",
-      "key": "feature_flags.gmail.enabled",
-      "label": "Gmail",
-      "description": "Enable Gmail management skill (archive, label, declutter)",
-      "defaultEnabled": true
-    },
-    {
-      "id": "sequences",
-      "scope": "assistant",
-      "key": "feature_flags.sequences.enabled",
-      "label": "Email Sequences",
-      "description": "Enable email sequence management skill",
-      "defaultEnabled": true
+      "id": "mobile-pairing",
+      "scope": "macos",
+      "key": "mobile_pairing_enabled",
+      "label": "Mobile Pairing",
+      "description": "Show the Mobile (iOS) pairing card in Settings > Account",
+      "defaultEnabled": false
     },
     {
       "id": "settings-developer-nav",
@@ -121,6 +89,14 @@
       "description": "Control Developer nav visibility in macOS settings",
       "defaultEnabled": true
     },
+    {
+      "id": "developer-menu-items",
+      "scope": "macos",
+      "key": "developer_menu_items_enabled",
+      "label": "Developer Menu Items",
+      "description": "Show Component Gallery and Replay Onboarding in the menu bar",
+      "defaultEnabled": false
+    },
     {
       "id": "logfire",
       "scope": "assistant",

package/src/config/loader.ts

@@ -7,11 +7,6 @@ import {
 } from "node:fs";
 import { dirname } from "node:path";
 
-import {
-  deleteSecureKey,
-  getSecureKey,
-  setSecureKey,
-} from "../security/secure-keys.js";
 import { ConfigError } from "../util/errors.js";
 import { getLogger } from "../util/logger.js";
 import {
@@ -162,7 +157,6 @@ export function deepMergeMissing(
 /**
  * Read the existing config.json from disk, merge any missing schema-default
  * keys, and rewrite only when there is an effective change.
- * Preserves exclusions: apiKeys and dataDir are never written.
  */
 function backfillConfigDefaults(
   configPath: string,
@@ -197,9 +191,9 @@ function backfillConfigDefaults(
 export function loadConfig(): AssistantConfig {
   if (cached) return cached;
 
-  // Re-entrancy guard: log calls during loading (e.g. file-mode warning,
-  // invalid apiKeys) can trigger loadConfig again. Return defaults to
-  // break the cycle instead of recursing to stack overflow.
+  // Re-entrancy guard: log calls during loading (e.g. file-mode warning)
+  // can trigger loadConfig again. Return defaults to break the cycle
+  // instead of recursing to stack overflow.
   if (loading) return cloneDefaultConfig();
   loading = true;
 
@@ -230,67 +224,6 @@ export function loadConfig(): AssistantConfig {
       configFileExisted = false;
     }
 
-    // Pre-validate apiKeys shape before migration (must be a plain object)
-    if (
-      fileConfig.apiKeys !== undefined &&
-      (typeof fileConfig.apiKeys !== "object" ||
-        fileConfig.apiKeys == null ||
-        Array.isArray(fileConfig.apiKeys))
-    ) {
-      log.warn(
-        "Invalid apiKeys in config file: must be an object with string values. Ignoring.",
-      );
-      delete fileConfig.apiKeys;
-    }
-
-    // Auto-migrate plaintext apiKeys from config.json to secure storage
-    if (fileConfig.apiKeys && typeof fileConfig.apiKeys === "object") {
-      const apiKeysObj = fileConfig.apiKeys as Record<string, unknown>;
-      const plaintextKeys = Object.entries(apiKeysObj).filter(
-        ([, v]) => typeof v === "string" && (v as string).length > 0,
-      );
-      if (plaintextKeys.length > 0) {
-        const migratedProviders: string[] = [];
-        for (const [provider, value] of plaintextKeys) {
-          if (setSecureKey(provider, value as string)) {
-            migratedProviders.push(provider);
-          } else {
-            log.warn(
-              `Failed to migrate API key for "${provider}" to secure storage`,
-            );
-          }
-        }
-        if (migratedProviders.length > 0) {
-          // Rewrite config.json without successfully migrated apiKeys
-          try {
-            const rawJson = JSON.parse(readFileSync(configPath, "utf-8"));
-            for (const p of migratedProviders) {
-              delete rawJson.apiKeys[p];
-            }
-            if (Object.keys(rawJson.apiKeys).length === 0) {
-              delete rawJson.apiKeys;
-            }
-            writeFileSync(configPath, JSON.stringify(rawJson, null, 2) + "\n");
-            log.info(
-              `Migrated ${migratedProviders.length} API key(s) from config.json to secure storage`,
-            );
-          } catch (err) {
-            log.warn(
-              { err },
-              "Failed to remove migrated keys from config.json",
-            );
-          }
-        }
-        // Clear only migrated keys from fileConfig so failed keys still flow into config
-        for (const p of migratedProviders) {
-          delete apiKeysObj[p];
-        }
-        if (Object.keys(apiKeysObj).length === 0) {
-          delete fileConfig.apiKeys;
-        }
-      }
-    }
-
     // Validate and apply defaults via Zod schema
     const config = validateWithSchema(fileConfig);
 
@@ -303,8 +236,8 @@ export function loadConfig(): AssistantConfig {
       if (!existsSync(dir)) {
         mkdirSync(dir, { recursive: true });
       }
-      // Strip apiKeys (managed in secure storage) and dataDir (runtime-derived)
-      const { apiKeys: _, dataDir: _d, ...persistable } = config;
+      // Strip dataDir (runtime-derived) from the persisted config
+      const { dataDir: _, ...persistable } = config;
 
       if (!configFileExisted) {
         writeFileSync(configPath, JSON.stringify(persistable, null, 2) + "\n");
@@ -316,48 +249,8 @@ export function loadConfig(): AssistantConfig {
       log.warn({ err }, "Failed to write/backfill config file");
     }
 
-    // Set cached before secure-key/env overrides so re-entrant calls
-    // return the in-flight config instead of bare defaults.
     cached = config;
 
-    // Secure storage keys override plaintext config file
-    try {
-      for (const provider of API_KEY_PROVIDERS) {
-        const secureKey = getSecureKey(provider);
-        if (secureKey) {
-          config.apiKeys[provider] = secureKey;
-        }
-      }
-    } catch (err) {
-      log.debug({ err }, "Failed to load keys from secure storage");
-    }
-
-    // Environment variables override everything
-    if (process.env.ANTHROPIC_API_KEY) {
-      config.apiKeys.anthropic = process.env.ANTHROPIC_API_KEY;
-    }
-    if (process.env.OPENAI_API_KEY) {
-      config.apiKeys.openai = process.env.OPENAI_API_KEY;
-    }
-    if (process.env.GEMINI_API_KEY) {
-      config.apiKeys.gemini = process.env.GEMINI_API_KEY;
-    }
-    if (process.env.OLLAMA_API_KEY) {
-      config.apiKeys.ollama = process.env.OLLAMA_API_KEY;
-    }
-    if (process.env.FIREWORKS_API_KEY) {
-      config.apiKeys.fireworks = process.env.FIREWORKS_API_KEY;
-    }
-    if (process.env.OPENROUTER_API_KEY) {
-      config.apiKeys.openrouter = process.env.OPENROUTER_API_KEY;
-    }
-    if (process.env.BRAVE_API_KEY) {
-      config.apiKeys.brave = process.env.BRAVE_API_KEY;
-    }
-    if (process.env.PERPLEXITY_API_KEY) {
-      config.apiKeys.perplexity = process.env.PERPLEXITY_API_KEY;
-    }
-
     loading = false;
     return config;
   } catch (err) {
@@ -372,25 +265,7 @@ export function saveConfig(config: AssistantConfig): void {
   ensureMigratedDataDir();
   const configPath = getConfigPath();
 
-  // Route apiKeys to secure storage, write config without them
-  for (const [provider, value] of Object.entries(config.apiKeys)) {
-    if (typeof value === "string" && value.length > 0) {
-      if (!setSecureKey(provider, value)) {
-        throw new ConfigError(
-          `Failed to save API key for "${provider}" to secure storage`,
-        );
-      }
-    }
-  }
-  // Delete secure keys for providers no longer in apiKeys or with empty values
-  for (const provider of API_KEY_PROVIDERS) {
-    const value = config.apiKeys[provider];
-    if (!value || (typeof value === "string" && value.length === 0)) {
-      deleteSecureKey(provider);
-    }
-  }
-  const { apiKeys: _, ...rest } = config;
-  writeFileSync(configPath, JSON.stringify(rest, null, 2) + "\n");
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
 
   cached = config;
 }
@@ -428,10 +303,7 @@ export function saveRawConfig(config: Record<string, unknown>): void {
   ensureMigratedDataDir();
   const configPath = getConfigPath();
 
-  // Strip apiKeys from plaintext config — secure storage is managed
-  // by saveConfig() and `assistant keys` commands, not here.
-  const { apiKeys: _, ...rest } = config;
-  writeFileSync(configPath, JSON.stringify(rest, null, 2) + "\n");
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
 
   cached = null; // invalidate cache
 }

package/src/config/schema.ts

@@ -232,12 +232,6 @@ export const AssistantConfigSchema = z
     imageGenModel: z
       .string({ error: "imageGenModel must be a string" })
       .default("gemini-2.5-flash-image"),
-    apiKeys: z
-      .record(
-        z.string(),
-        z.string({ error: "Each apiKeys value must be a string" }),
-      )
-      .default({} as Record<string, string>),
     webSearchProvider: z
       .enum(VALID_WEB_SEARCH_PROVIDERS, {
         error: `webSearchProvider must be one of: ${VALID_WEB_SEARCH_PROVIDERS.join(

package/src/config/schemas/channels.ts

@@ -34,6 +34,7 @@ export const WhatsAppConfigSchema = z.object({
 });
 
 export const TelegramConfigSchema = z.object({
+  botId: z.string({ error: "telegram.botId must be a string" }).default(""),
   botUsername: z
     .string({ error: "telegram.botUsername must be a string" })
     .default(""),

package/src/config/schemas/elevenlabs.ts

@@ -1,9 +1,9 @@
 import { z } from "zod";
 
-// Default ElevenLabs voice — "Rachel" (calm, warm, conversational).
+// Default ElevenLabs voice — "Amelia" (expressive, enthusiastic, British English).
 // Used by both in-app TTS and phone calls (via Twilio ConversationRelay).
 // Mirrored in: clients/macos/.../OpenAIVoiceService.swift (defaultVoiceId)
-export const DEFAULT_ELEVENLABS_VOICE_ID = "21m00Tcm4TlvDq8ikWAM";
+export const DEFAULT_ELEVENLABS_VOICE_ID = "ZF6FPAbjXT4488VcRRnw";
 
 export const ElevenLabsConfigSchema = z.object({
   voiceId: z

package/src/config/schemas/security.ts

@@ -5,7 +5,7 @@ const VALID_PERMISSIONS_MODES = ["strict", "workspace"] as const;
 
 export { VALID_PERMISSIONS_MODES, VALID_SECRET_ACTIONS };
 
-export const CustomSecretPatternSchema = z.object({
+const CustomSecretPatternSchema = z.object({
   label: z.string({
     error: "secretDetection.customPatterns[].label must be a string",
   }),
@@ -49,6 +49,5 @@ export const PermissionsConfigSchema = z.object({
     .default("workspace"),
 });
 
-export type CustomSecretPattern = z.infer<typeof CustomSecretPatternSchema>;
 export type SecretDetectionConfig = z.infer<typeof SecretDetectionConfigSchema>;
 export type PermissionsConfig = z.infer<typeof PermissionsConfigSchema>;

package/src/config/skills.ts

@@ -1294,7 +1294,7 @@ async function generateSkillIcon(
   name: string,
   description: string,
 ): Promise<string> {
-  const provider = getConfiguredProvider();
+  const provider = await getConfiguredProvider();
   if (!provider) {
     throw new Error("Configured provider unavailable for icon generation");
   }

package/src/contacts/contact-store.ts

@@ -2,7 +2,6 @@ import { and, asc, desc, eq, like, sql } from "drizzle-orm";
 import { v4 as uuid } from "uuid";
 
 import { getDb } from "../memory/db.js";
-import { rawChanges } from "../memory/raw-query.js";
 import {
   assistantContactMetadata,
   contactChannels,
@@ -34,8 +33,8 @@ function parseContact(row: typeof contacts.$inferSelect): Contact {
     id: row.id,
     displayName: row.displayName,
     notes: row.notes,
-    lastInteraction: row.lastInteraction,
-    interactionCount: row.interactionCount,
+    lastInteraction: null,
+    interactionCount: 0,
     createdAt: row.createdAt,
     updatedAt: row.updatedAt,
     role: row.role as Contact["role"],
@@ -63,6 +62,8 @@ function parseChannel(
     revokedReason: row.revokedReason,
     blockedReason: row.blockedReason,
     lastSeenAt: row.lastSeenAt,
+    interactionCount: row.interactionCount,
+    lastInteraction: row.lastInteraction,
     updatedAt: row.updatedAt,
     createdAt: row.createdAt,
   };
@@ -80,7 +81,15 @@ function getChannelsForContact(contactId: string): ContactChannel[] {
 }
 
 function withChannels(contact: Contact): ContactWithChannels {
-  return { ...contact, channels: getChannelsForContact(contact.id) };
+  const channels = getChannelsForContact(contact.id);
+  const interactionCount = channels.reduce(
+    (sum, ch) => sum + ch.interactionCount,
+    0,
+  );
+  const lastInteraction =
+    channels.reduce((max, ch) => Math.max(max, ch.lastInteraction ?? 0), 0) ||
+    null;
+  return { ...contact, interactionCount, lastInteraction, channels };
 }
 
 // ── Channel data type for syncChannels ───────────────────────────────
@@ -235,8 +244,6 @@ export function upsertContact(params: {
       id: contactId,
       displayName: params.displayName,
       notes: params.notes ?? null,
-      lastInteraction: null,
-      interactionCount: 0,
       role: params.role ?? "contact",
       contactType: params.contactType ?? "human",
       principalId: params.principalId ?? null,
@@ -488,7 +495,7 @@ export function searchContacts(params: {
       .from(contacts)
       .innerJoin(contactChannels, eq(contacts.id, contactChannels.contactId))
       .where(whereClause)
-      .orderBy(desc(contacts.updatedAt), desc(contacts.lastInteraction))
+      .orderBy(desc(contacts.updatedAt))
       .all();
 
     const contactIds = [...new Set(rows.map((r) => r.contactId))];
@@ -509,7 +516,7 @@ export function searchContacts(params: {
     .select()
     .from(contacts)
     .where(whereClause)
-    .orderBy(desc(contacts.updatedAt), desc(contacts.lastInteraction))
+    .orderBy(desc(contacts.updatedAt))
     .limit(limit)
     .all();
 
@@ -531,11 +538,7 @@ export function listContacts(
     .select()
     .from(contacts)
     .where(conditions.length === 1 ? conditions[0] : and(...conditions))
-    .orderBy(
-      sql`${contacts.role} = 'guardian' DESC`,
-      desc(contacts.updatedAt),
-      desc(contacts.lastInteraction),
-    )
+    .orderBy(sql`${contacts.role} = 'guardian' DESC`, desc(contacts.updatedAt))
     .limit(effectiveLimit)
     .all();
   return rows.map((r) => withChannels(parseContact(r)));
@@ -571,16 +574,8 @@ export function mergeContacts(
       .get();
     if (!merge) throw new Error(`Contact "${mergeId}" not found`);
 
-    // Resolve merged field values — pick the better/more recent value
-    const mergedInteractionCount =
-      keep.interactionCount + merge.interactionCount;
-    const mergedLastInteraction =
-      Math.max(keep.lastInteraction ?? 0, merge.lastInteraction ?? 0) || null;
-
     tx.update(contacts)
       .set({
-        interactionCount: mergedInteractionCount,
-        lastInteraction: mergedLastInteraction,
         notes: [keep.notes, merge.notes].filter(Boolean).join("\n") || null,
         updatedAt: now,
       })
@@ -792,46 +787,6 @@ export function findGuardianForChannel(
   };
 }
 
-/**
- * Revoke the guardian's active channel of the given type by setting its
- * status to 'revoked'. This ensures findGuardianForChannel() no longer
- * returns stale data after a binding is revoked.
- *
- * Returns true if a channel was found and revoked, false otherwise.
- */
-export function revokeGuardianChannel(channelType: string): boolean {
-  const db = getDb();
-  const conditions = [
-    eq(contacts.role, "guardian"),
-    eq(contactChannels.type, channelType),
-    eq(contactChannels.status, "active"),
-  ];
-  const rows = db
-    .select({
-      channelId: contactChannels.id,
-    })
-    .from(contacts)
-    .innerJoin(contactChannels, eq(contacts.id, contactChannels.contactId))
-    .where(and(...conditions))
-    .all();
-
-  if (rows.length === 0) return false;
-
-  const now = Date.now();
-  for (const row of rows) {
-    db.update(contactChannels)
-      .set({
-        status: "revoked",
-        revokedReason: "guardian_binding_revoked",
-        updatedAt: now,
-      })
-      .where(eq(contactChannels.id, row.channelId))
-      .run();
-  }
-
-  return true;
-}
-
 /**
  * List all active channels for guardian contacts.
  * This is the contacts-based equivalent of listActiveBindingsByAssistant(assistantId).
@@ -934,19 +889,19 @@ export function updateChannelLastSeenById(channelId: string): void {
 }
 
 /**
- * Atomically increment interactionCount and set lastInteraction on a contact.
+ * Atomically increment interactionCount and set lastInteraction on a contact channel.
  * Optimized for the hot path — single UPDATE with no prior SELECT.
  */
-export function updateContactInteraction(contactId: string): void {
+export function updateChannelInteraction(channelId: string): void {
   const db = getDb();
   const now = Date.now();
-  db.update(contacts)
+  db.update(contactChannels)
     .set({
       lastInteraction: now,
-      interactionCount: sql`${contacts.interactionCount} + 1`,
+      interactionCount: sql`${contactChannels.interactionCount} + 1`,
       updatedAt: now,
     })
-    .where(eq(contacts.id, contactId))
+    .where(eq(contactChannels.id, channelId))
     .run();
 }
 
@@ -1037,12 +992,3 @@ export function getAssistantContactMetadata(
   if (!row) return null;
   return parseAssistantMetadata(row);
 }
-
-export function deleteAssistantContactMetadata(contactId: string): boolean {
-  const db = getDb();
-  db.delete(assistantContactMetadata)
-    .where(eq(assistantContactMetadata.contactId, contactId))
-    .run();
-
-  return rawChanges() > 0;
-}

package/src/contacts/contacts-write.ts

@@ -16,9 +16,9 @@ import {
   findGuardianForChannel,
   getChannelById,
   getContactInternal,
+  updateChannelInteraction,
   updateChannelLastSeenById,
   updateChannelStatus,
-  updateContactInteraction,
   upsertContact,
 } from "./contact-store.js";
 import type {
@@ -287,13 +287,13 @@ export function touchChannelLastSeen(channelId: string): void {
 }
 
 /**
- * Increment the interaction count and update lastInteraction on a contact.
- * Expects a plain contact UUID (Contact.id).
+ * Track an interaction on the specific channel that received it.
+ * Swallows errors to avoid disrupting the inbound message hot path.
  */
-export function touchContactInteraction(contactId: string): void {
+export function touchContactInteraction(channelId: string): void {
   try {
-    updateContactInteraction(contactId);
+    updateChannelInteraction(channelId);
   } catch (err) {
-    log.warn({ err }, "Failed to update contact interaction stats");
+    log.warn({ err }, "Failed to update channel interaction stats");
   }
 }