@vellumai/assistant 0.4.41 → 0.4.43

package/src/daemon/{ipc-contract → message-types}/integrations.ts

@@ -52,22 +52,25 @@ export interface TelegramConfigRequest {
   commands?: Array<{ command: string; description: string }>; // Only for action: 'set_commands' or 'setup'
 }
 
-export interface GuardianVerificationRequest {
-  type: "guardian_verification";
+export interface ChannelVerificationSessionRequest {
+  type: "channel_verification_session";
   action:
-    | "create_challenge"
+    | "create_session"
     | "status"
+    | "cancel_session"
     | "revoke"
-    | "start_outbound"
-    | "resend_outbound"
-    | "cancel_outbound";
+    | "resend_session";
   channel?: ChannelId; // Defaults to 'telegram'
   sessionId?: string;
   rebind?: boolean; // When true, allows creating a challenge even if a binding already exists
-  /** E.164 phone number for SMS/voice, Telegram handle/chat-id. Used by outbound actions. */
+  /** E.164 phone number for phone, Telegram handle/chat-id. Used by outbound actions. */
   destination?: string;
   /** Origin conversation ID so completion/failure pointers can route back. */
   originConversationId?: string;
+  /** Distinguishes guardian vs trusted-contact verification flows in the unified create endpoint. */
+  purpose?: "guardian" | "trusted_contact";
+  /** Contact-channel ID for the absorbed contact-channel verify flow. */
+  contactChannelId?: string;
 }
 
 export interface TwitterAuthStartRequest {
@@ -137,11 +140,22 @@ export interface VercelApiConfigResponse {
   error?: string;
 }
 
+export interface ManagedPrerequisites {
+  /** Whether twitter.integrationMode is set to "managed" in config. */
+  integrationModeManaged: boolean;
+  /** Whether the assistant API key credential exists in secure storage. */
+  assistantApiKeyPresent: boolean;
+  /** Whether the platform base URL is configured (platform registration resolvable). */
+  platformAssistantIdResolvable: boolean;
+}
+
 export interface TwitterIntegrationConfigResponse {
   type: "twitter_integration_config_response";
   success: boolean;
   mode?: "local_byo" | "managed";
   managedAvailable: boolean;
+  /** Detailed prerequisite status for managed Twitter availability. */
+  managedPrerequisites?: ManagedPrerequisites;
   localClientConfigured: boolean;
   connected: boolean;
   accountInfo?: string;
@@ -166,15 +180,15 @@ export interface TelegramConfigResponse {
   warning?: string;
 }
 
-export interface GuardianVerificationResponse {
-  type: "guardian_verification_response";
+export interface ChannelVerificationSessionResponse {
+  type: "channel_verification_session_response";
   success: boolean;
   secret?: string;
   instruction?: string;
   /** Present when action is 'status'. */
   bound?: boolean;
   guardianExternalUserId?: string;
-  /** The channel this status pertains to (e.g. "telegram", "sms"). Present when action is 'status'. */
+  /** The channel this status pertains to (e.g. "telegram", "phone"). Present when action is 'status'. */
   channel?: ChannelId;
   /** The assistant ID scoped to this status. Present when action is 'status'. */
   assistantId?: string;
@@ -195,7 +209,7 @@ export interface GuardianVerificationResponse {
   expiresAt?: number;
   /** Epoch ms after which a resend is allowed. */
   nextResendAt?: number;
-  /** Number of SMS sends for this session. */
+  /** Number of sends for this session. */
   sendCount?: number;
   /** Telegram deep-link URL for bootstrap (M3 placeholder). */
   telegramBootstrapUrl?: string;
@@ -207,6 +221,8 @@ export interface TwitterAuthResult {
   type: "twitter_auth_result";
   success: boolean;
   accountInfo?: string;
+  /** Machine-readable error code for programmatic handling (e.g. "managed_missing_api_key", "managed_auth_via_platform"). */
+  errorCode?: string;
   error?: string;
 }
 
@@ -269,7 +285,7 @@ export type _IntegrationsClientMessages =
   | VercelApiConfigRequest
   | TwitterIntegrationConfigRequest
   | TelegramConfigRequest
-  | GuardianVerificationRequest
+  | ChannelVerificationSessionRequest
   | TwitterAuthStartRequest
   | TwitterAuthStatusRequest
   | IntegrationListRequest
@@ -285,7 +301,7 @@ export type _IntegrationsServerMessages =
   | VercelApiConfigResponse
   | TwitterIntegrationConfigResponse
   | TelegramConfigResponse
-  | GuardianVerificationResponse
+  | ChannelVerificationSessionResponse
   | TwitterAuthResult
   | TwitterAuthStatusResponse
   | IntegrationListResponse

package/src/daemon/{ipc-contract → message-types}/memory.ts

@@ -1,5 +1,11 @@
 // Memory recall and status types.
 
+export interface MemoryRecalledDegradation {
+  semanticUnavailable: boolean;
+  reason: string;
+  fallbackSources: string[];
+}
+
 export interface MemoryRecalledCandidateDebug {
   key: string;
   type: string;
@@ -14,6 +20,7 @@ export interface MemoryRecalled {
   type: "memory_recalled";
   provider: string;
   model: string;
+  degradation?: MemoryRecalledDegradation;
   lexicalHits: number;
   semanticHits: number;
   recencyHits: number;
@@ -35,6 +42,7 @@ export interface MemoryStatus {
   type: "memory_status";
   enabled: boolean;
   degraded: boolean;
+  degradation?: MemoryRecalledDegradation;
   reason?: string;
   provider?: string;
   model?: string;

package/src/daemon/{ipc-contract → message-types}/notifications.ts

@@ -51,11 +51,25 @@ export interface ConversationSeenSignal {
   metadata?: Record<string, unknown>;
 }
 
+/** Client signal indicating the user wants a conversation marked unread again. */
+export interface ConversationUnreadSignal {
+  type: "conversation_unread_signal";
+  conversationId: string;
+  sourceChannel: string;
+  signalType: string;
+  confidence: string;
+  source: string;
+  evidenceText?: string;
+  observedAt?: number;
+  metadata?: Record<string, unknown>;
+}
+
 // --- Domain-level union aliases (consumed by the barrel file) ---
 
 export type _NotificationsClientMessages =
   | NotificationIntentResult
-  | ConversationSeenSignal;
+  | ConversationSeenSignal
+  | ConversationUnreadSignal;
 
 export type _NotificationsServerMessages =
   | NotificationIntent

package/src/daemon/{ipc-contract → message-types}/sessions.ts

@@ -259,6 +259,7 @@ export interface DaemonStatusMessage {
   type: "daemon_status";
   httpPort?: number;
   version?: string;
+  keyFingerprint?: string;
 }
 
 export interface GenerationCancelled {

package/src/daemon/{ipc-contract → message-types}/shared.ts

@@ -9,14 +9,6 @@ export function normalizeThreadType(
   return raw === "private" ? "private" : "standard";
 }
 
-export interface IpcBlobRef {
-  id: string;
-  kind: "ax_tree" | "screenshot_jpeg";
-  encoding: "utf8" | "binary";
-  byteLength: number;
-  sha256?: string;
-}
-
 export interface UsageStats {
   inputTokens: number;
   outputTokens: number;

package/src/daemon/{ipc-contract → message-types}/workspace.ts

@@ -57,8 +57,8 @@ export interface WorkspaceFileReadResponse {
 
 export interface IdentityGetResponse {
   type: "identity_get_response";
-  /** Whether an IDENTITY.md file was found. When false, all fields are empty defaults. Optional for backwards compat with older daemons. */
-  found?: boolean;
+  /** Whether an IDENTITY.md file was found. When false, all fields are empty defaults. */
+  found: boolean;
   name: string;
   role: string;
   personality: string;

package/src/daemon/providers-setup.ts

@@ -2,7 +2,6 @@ import type { AssistantConfig } from "../config/types.js";
 import { getMcpServerManager } from "../mcp/manager.js";
 import { gmailMessagingProvider } from "../messaging/providers/gmail/adapter.js";
 import { slackProvider as slackMessagingProvider } from "../messaging/providers/slack/adapter.js";
-import { smsMessagingProvider } from "../messaging/providers/sms/adapter.js";
 import { telegramBotMessagingProvider } from "../messaging/providers/telegram-bot/adapter.js";
 import { whatsappMessagingProvider } from "../messaging/providers/whatsapp/adapter.js";
 import { registerMessagingProvider } from "../messaging/registry.js";
@@ -16,8 +15,6 @@ import { githubProvider } from "../watcher/providers/github.js";
 import { gmailProvider } from "../watcher/providers/gmail.js";
 import { googleCalendarProvider } from "../watcher/providers/google-calendar.js";
 import { linearProvider } from "../watcher/providers/linear.js";
-import { slackProvider as slackWatcherProvider } from "../watcher/providers/slack.js";
-
 const log = getLogger("lifecycle");
 
 export async function initializeProvidersAndTools(
@@ -55,7 +52,6 @@ export async function initializeProvidersAndTools(
 export function registerWatcherProviders(): void {
   registerWatcherProvider(gmailProvider);
   registerWatcherProvider(googleCalendarProvider);
-  registerWatcherProvider(slackWatcherProvider);
   registerWatcherProvider(githubProvider);
   registerWatcherProvider(linearProvider);
   initWatcherEngine();
@@ -65,6 +61,5 @@ export function registerMessagingProviders(): void {
   registerMessagingProvider(slackMessagingProvider);
   registerMessagingProvider(gmailMessagingProvider);
   registerMessagingProvider(telegramBotMessagingProvider);
-  registerMessagingProvider(smsMessagingProvider);
   registerMessagingProvider(whatsappMessagingProvider);
 }

package/src/daemon/recording-executor.ts

@@ -3,8 +3,6 @@
 // handlers/recording.ts (side effects), so both sessions.ts and misc.ts
 // can share the same execution logic without duplicating switch/case blocks.
 
-import type * as net from "node:net";
-
 import {
   handleRecordingPause,
   handleRecordingRestart,
@@ -18,7 +16,6 @@ import type { RecordingIntentResult } from "./recording-intent.js";
 
 export interface RecordingExecutionContext {
   conversationId: string;
-  socket: net.Socket;
   ctx: HandlerContext;
 }
 
@@ -51,7 +48,6 @@ export function executeRecordingIntent(
       const recordingId = handleRecordingStart(
         context.conversationId,
         { promptForSource: true },
-        context.socket,
         context.ctx,
       );
       return {
@@ -94,7 +90,6 @@ export function executeRecordingIntent(
       // blocking the new recording.
       const restartResult = handleRecordingRestart(
         context.conversationId,
-        context.socket,
         context.ctx,
       );
 
@@ -110,7 +105,6 @@ export function executeRecordingIntent(
         const recordingId = handleRecordingStart(
           context.conversationId,
           { promptForSource: true },
-          context.socket,
           context.ctx,
         );
         return {
@@ -145,7 +139,6 @@ export function executeRecordingIntent(
     case "restart_only": {
       const restartResult = handleRecordingRestart(
         context.conversationId,
-        context.socket,
         context.ctx,
       );
       return {

package/src/daemon/ride-shotgun-handler.ts

@@ -1,5 +1,4 @@
 import { randomUUID } from "node:crypto";
-import type * as net from "node:net";
 
 import { autoNavigate } from "../tools/browser/auto-navigate.js";
 import {
@@ -20,8 +19,8 @@ import {
   watchSessions,
 } from "../tools/watch/watch-state.js";
 import { getLogger } from "../util/logger.js";
-import type { HandlerContext } from "./handlers.js";
-import type { RideShotgunStart, RideShotgunStop } from "./ipc-protocol.js";
+import type { HandlerContext } from "./handlers/shared.js";
+import type { RideShotgunStart, RideShotgunStop } from "./message-protocol.js";
 import { generateSummary, lastSummaryBySession } from "./watch-handler.js";
 
 const log = getLogger("ride-shotgun-handler");
@@ -134,7 +133,6 @@ async function completeSession(session: WatchSession): Promise<void> {
 
 export async function handleRideShotgunStart(
   msg: RideShotgunStart,
-  socket: net.Socket,
   ctx: HandlerContext,
 ): Promise<void> {
   const watchId = randomUUID();
@@ -224,7 +222,7 @@ export async function handleRideShotgunStart(
           { err, watchId },
           "Failed to ensure Chrome with CDP — cannot start recording",
         );
-        ctx.send(socket, {
+        ctx.send({
           type: "ride_shotgun_error",
           watchId,
           sessionId,
@@ -291,7 +289,7 @@ export async function handleRideShotgunStart(
                   { watchId, currentCount },
                   "Activity resumed — clearing idleHint",
                 );
-                ctx.send(socket, {
+                ctx.send({
                   type: "ride_shotgun_progress",
                   watchId,
                   message: `Recording network traffic...`,
@@ -315,7 +313,7 @@ export async function handleRideShotgunStart(
               );
             }
 
-            ctx.send(socket, {
+            ctx.send({
               type: "ride_shotgun_progress",
               watchId,
               message: `Recording network traffic...`,
@@ -374,7 +372,7 @@ export async function handleRideShotgunStart(
                 // Send progress to connected client
                 if (progress.type === "visiting" && progress.url) {
                   const shortUrl = progress.url.replace(/^https?:\/\//, "");
-                  ctx.send(socket, {
+                  ctx.send({
                     type: "ride_shotgun_progress",
                     watchId,
                     message: `[${progress.pageNumber || "?"}] ${shortUrl}`,
@@ -423,7 +421,7 @@ export async function handleRideShotgunStart(
               { err, watchId },
               "Failed to start network recording after 10 attempts",
             );
-            ctx.send(socket, {
+            ctx.send({
               type: "ride_shotgun_error",
               watchId,
               sessionId,
@@ -466,12 +464,11 @@ export async function handleRideShotgunStart(
           sessionId,
           observationCount,
           summaryLength: summary.length,
-          socketDestroyed: socket.destroyed,
         },
         "Completion notifier firing — sending ride_shotgun_result to client",
       );
 
-      ctx.send(socket, {
+      ctx.send({
         type: "ride_shotgun_result",
         sessionId,
         watchId,
@@ -494,7 +491,7 @@ export async function handleRideShotgunStart(
   fireWatchStartNotifier(sessionId, session);
 
   // Send watch_started so the Swift client knows the watchId/sessionId
-  ctx.send(socket, {
+  ctx.send({
     type: "watch_started",
     sessionId,
     watchId,
@@ -510,7 +507,6 @@ export async function handleRideShotgunStart(
 
 export async function handleRideShotgunStop(
   msg: RideShotgunStop,
-  _socket: net.Socket,
   _ctx: HandlerContext,
 ): Promise<void> {
   const { watchId } = msg;