@vellumai/assistant 0.10.12 → 0.11.0-staging.1

package/src/daemon/message-protocol.ts

@@ -1,173 +1,37 @@
 /**
  * Message Protocol -- message types and serialization.
  *
- * All message types are defined in domain files under ./message-types/.
- * Each domain file exports `_<Domain>ClientMessages` and/or
- * `_<Domain>ServerMessages` type aliases. This file composes those
- * into the aggregate ClientMessage and ServerMessage unions.
- *
- * To add a new message type:
- *   1. Define its interface in the appropriate domain file.
- *   2. Add it to that file's _<Domain>ClientMessages or _<Domain>ServerMessages.
- * No changes needed here unless you're adding an entirely new domain file.
+ * Client message types are defined in domain files under ./message-types/;
+ * each exports a `_<Domain>ClientMessages` alias that this file composes into
+ * the aggregate `ClientMessage` union.
  */
 
 // Re-export domain modules (all individual types remain importable)
-export * from "./message-types/acp.js";
-export * from "./message-types/apps.js";
-export * from "./message-types/background-tools.js";
-export * from "./message-types/bookmarks.js";
 export * from "./message-types/computer-use.js";
-export * from "./message-types/contacts.js";
 export * from "./message-types/conversations.js";
 export * from "./message-types/diagnostics.js";
-export * from "./message-types/document-comments.js";
-export * from "./message-types/documents.js";
-export * from "./message-types/home.js";
 export * from "./message-types/host-app-control.js";
-export * from "./message-types/host-bash.js";
 export * from "./message-types/host-browser.js";
-export * from "./message-types/host-cu.js";
-export * from "./message-types/host-file.js";
-export * from "./message-types/host-transfer.js";
-export * from "./message-types/integrations.js";
-export * from "./message-types/memory.js";
 export * from "./message-types/messages.js";
 export * from "./message-types/notifications.js";
-export * from "./message-types/schedules.js";
-export * from "./message-types/settings.js";
 export * from "./message-types/shared.js";
 export * from "./message-types/skills.js";
-export * from "./message-types/subagents.js";
 export * from "./message-types/surfaces.js";
 export * from "./message-types/sync.js";
-export * from "./message-types/upgrades.js";
 export * from "./message-types/web-activity.js";
-export * from "./message-types/workflows.js";
-export * from "./message-types/workspace.js";
 
-// Import domain-level union aliases for composition
-import type { DiskPressureStatusChangedEvent } from "../api/events/disk-pressure-status-changed.js";
-import type { HookEvent } from "../api/events/hook-event.js";
-import type { _AcpServerMessages } from "./message-types/acp.js";
-import type { _AppsServerMessages } from "./message-types/apps.js";
-import type { _BackgroundToolsServerMessages } from "./message-types/background-tools.js";
-import type { _BookmarksServerMessages } from "./message-types/bookmarks.js";
-import type {
-  _ComputerUseClientMessages,
-  _ComputerUseServerMessages,
-} from "./message-types/computer-use.js";
-import type { _ContactsServerMessages } from "./message-types/contacts.js";
-import type {
-  _ConversationsClientMessages,
-  _ConversationsServerMessages,
-} from "./message-types/conversations.js";
+// Client-message domain aliases for the ClientMessage union.
+import type { _ComputerUseClientMessages } from "./message-types/computer-use.js";
 import type { _DiagnosticsClientMessages } from "./message-types/diagnostics.js";
-import type { _DocumentCommentsServerMessages } from "./message-types/document-comments.js";
-import type { _DocumentsServerMessages } from "./message-types/documents.js";
-import type { _HomeServerMessages } from "./message-types/home.js";
-import type { _HostAppControlServerMessages } from "./message-types/host-app-control.js";
-import type { _HostBashServerMessages } from "./message-types/host-bash.js";
-import type {
-  _HostBrowserClientMessages,
-  _HostBrowserServerMessages,
-} from "./message-types/host-browser.js";
-import type { _HostCuServerMessages } from "./message-types/host-cu.js";
-import type { _HostFileServerMessages } from "./message-types/host-file.js";
-import type { _HostTransferServerMessages } from "./message-types/host-transfer.js";
-import type { _HostUiSnapshotServerMessages } from "./message-types/host-ui-snapshot.js";
-import type {
-  _IntegrationsClientMessages,
-  _IntegrationsServerMessages,
-} from "./message-types/integrations.js";
-import type { _MemoryServerMessages } from "./message-types/memory.js";
-import type {
-  _MessagesClientMessages,
-  _MessagesServerMessages,
-} from "./message-types/messages.js";
-import type {
-  _NotificationsClientMessages,
-  _NotificationsServerMessages,
-} from "./message-types/notifications.js";
-import type { _SchedulesServerMessages } from "./message-types/schedules.js";
-import type { _SettingsServerMessages } from "./message-types/settings.js";
-import type { _SkillsServerMessages } from "./message-types/skills.js";
-import type {
-  _SubagentsClientMessages,
-  _SubagentsServerMessages,
-} from "./message-types/subagents.js";
-import type { _SurfacesServerMessages } from "./message-types/surfaces.js";
-import type { _SyncInvalidationServerMessages } from "./message-types/sync.js";
-import type { _UpgradesServerMessages } from "./message-types/upgrades.js";
-import type { _WorkflowsServerMessages } from "./message-types/workflows.js";
-import type {
-  _WorkspaceClientMessages,
-  _WorkspaceServerMessages,
-} from "./message-types/workspace.js";
-
-// === SubagentEvent -- defined here because it references ServerMessage ===
-
-/** Wraps any ServerMessage emitted by a subagent conversation for routing to the client. */
-export interface SubagentEvent {
-  type: "subagent_event";
-  subagentId: string;
-  conversationId: string;
-  event: ServerMessage;
-}
+import type { _HostBrowserClientMessages } from "./message-types/host-browser.js";
+import type { _MessagesClientMessages } from "./message-types/messages.js";
+import type { _NotificationsClientMessages } from "./message-types/notifications.js";
 
 // === Client -> Server aggregate union ===
 
 export type ClientMessage =
-  | _ConversationsClientMessages
   | _MessagesClientMessages
-  | _IntegrationsClientMessages
   | _ComputerUseClientMessages
   | _HostBrowserClientMessages
-  | _SubagentsClientMessages
-  | _WorkspaceClientMessages
   | _DiagnosticsClientMessages
   | _NotificationsClientMessages;
-
-// === Server -> Client aggregate union ===
-
-export type ServerMessage =
-  | _ConversationsServerMessages
-  | _MessagesServerMessages
-  | _SurfacesServerMessages
-  | _SkillsServerMessages
-  | _AppsServerMessages
-  | _IntegrationsServerMessages
-  | _ComputerUseServerMessages
-  | _ContactsServerMessages
-  | _SubagentsServerMessages
-  | _DocumentsServerMessages
-  | _DocumentCommentsServerMessages
-  | _SyncInvalidationServerMessages
-  | _HomeServerMessages
-  | _HostAppControlServerMessages
-  | _HostBashServerMessages
-  | _HostBrowserServerMessages
-  | _HostCuServerMessages
-  | _HostFileServerMessages
-  | _HostTransferServerMessages
-  | _HostUiSnapshotServerMessages
-  | _MemoryServerMessages
-  | _WorkspaceServerMessages
-  | _SchedulesServerMessages
-  | _SettingsServerMessages
-  | _NotificationsServerMessages
-  | _UpgradesServerMessages
-  | _AcpServerMessages
-  | _BackgroundToolsServerMessages
-  | _BookmarksServerMessages
-  | _WorkflowsServerMessages
-  | DiskPressureStatusChangedEvent
-  | HookEvent
-  | SubagentEvent;
-
-// === Contract schema ===
-
-export interface ContractSchema {
-  client: ClientMessage;
-  server: ServerMessage;
-}

package/src/daemon/message-types/computer-use.ts

@@ -4,12 +4,6 @@
 // single-sourced from their canonical `api/events` wire schemas; the shared
 // `RecordingOptions` shape is re-exported from there for barrel consumers.
 
-import type {
-  RecordingPauseEvent,
-  RecordingResumeEvent,
-  RecordingStartEvent,
-  RecordingStopEvent,
-} from "../../api/events/recording.js";
 import type { CommandIntent, UserMessageAttachment } from "./shared.js";
 
 export type { RecordingOptions } from "../../api/events/recording.js";
@@ -49,9 +43,3 @@ export interface RecordingStatus {
 // --- Domain-level union aliases (consumed by the barrel file) ---
 
 export type _ComputerUseClientMessages = TaskSubmit | RecordingStatus;
-
-export type _ComputerUseServerMessages =
-  | RecordingStartEvent
-  | RecordingStopEvent
-  | RecordingPauseEvent
-  | RecordingResumeEvent;

package/src/daemon/message-types/conversations.ts

@@ -1,38 +1,20 @@
-// Conversation lifecycle, auth, model config, and history types.
+// Conversation lifecycle, model config, and transport metadata types.
+//
+// Server→client events are single-sourced from their canonical `api/events`
+// wire schemas; this file composes them into the domain union consumed by
+// `message-protocol.ts` and defines the transport-metadata shapes the create /
+// messaging path uses. Conversation management (create, list, switch, rename,
+// history, undo, usage, clear, reorder) is served by the HTTP conversation
+// routes, not by client messages.
 
-import type { AssistantStatusEvent } from "../../api/events/assistant-status.js";
-import type { CompactionCircuitClosedEvent } from "../../api/events/compaction-circuit-closed.js";
-import type { CompactionCircuitOpenEvent } from "../../api/events/compaction-circuit-open.js";
-import type { ContextCompactedEvent } from "../../api/events/context-compacted.js";
-import type { ConversationErrorEvent } from "../../api/events/conversation-error.js";
-import type { ConversationListInvalidatedEvent } from "../../api/events/conversation-list-invalidated.js";
-import type { ConversationNoticeEvent } from "../../api/events/conversation-notice.js";
-import type { ConversationTitleUpdatedEvent } from "../../api/events/conversation-title-updated.js";
-import type { GenerationCancelledEvent } from "../../api/events/generation-cancelled.js";
-import type { GenerationHandoffEvent } from "../../api/events/generation-handoff.js";
-import type { ModelInfoEvent } from "../../api/events/model-info.js";
-import type { OpenConversationEvent } from "../../api/events/open-conversation.js";
-import type { ScheduleConversationCreatedEvent } from "../../api/events/schedule-conversation-created.js";
-import type { UsageProgressEvent } from "../../api/events/usage-progress.js";
-import type { UsageUpdateEvent } from "../../api/events/usage-update.js";
 import type {
   ChannelId,
   HostProxyInterfaceId,
   InterfaceId,
 } from "../../channels/types.js";
 import { supportsHostProxy } from "../../channels/types.js";
-import type { ConversationType } from "./shared.js";
-import type { UserMessageAttachment } from "./shared.js";
 
-// === Client → Server ===
-
-export interface ConversationListRequest {
-  type: "conversation_list";
-  /** Number of conversations to skip (for pagination). Defaults to 0. */
-  offset?: number;
-  /** Maximum number of conversations to return. Defaults to 50. */
-  limit?: number;
-}
+// === Transport metadata ===
 
 /** Shared fields for all transport metadata variants. */
 interface BaseTransportMetadata {
@@ -114,327 +96,9 @@ export function isHostProxyTransport(
   );
 }
 
-export interface ConversationCreateRequest {
-  type: "conversation_create";
-  title?: string;
-  systemPromptOverride?: string;
-  maxResponseTokens?: number;
-  correlationId?: string;
-  transport?: ConversationTransportMetadata;
-  conversationType?: ConversationType;
-  /** Skill IDs to pre-activate in the new conversation (loaded before the first message). */
-  preactivatedSkillIds?: string[];
-  /** If provided, automatically sent as the first user message after conversation creation. */
-  initialMessage?: string;
-}
-
-export interface ConversationSwitchRequest {
-  type: "conversation_switch";
-  conversationId: string;
-}
-
-export interface ConversationRenameRequest {
-  type: "conversation_rename";
-  conversationId: string;
-  title: string;
-}
-
-export interface AuthMessage {
-  type: "auth";
-  token: string;
-}
-
-export interface PingMessage {
-  type: "ping";
-}
-
-export interface CancelRequest {
-  type: "cancel";
-  conversationId?: string;
-}
-
-export interface DeleteQueuedMessage {
-  type: "delete_queued_message";
-  conversationId: string;
-  requestId: string;
-}
-
-export interface ModelGetRequest {
-  type: "model_get";
-}
-
-export interface ImageGenModelSetRequest {
-  type: "image_gen_model_set";
-  model: string;
-}
-
-export interface UndoRequest {
-  type: "undo";
-  conversationId: string;
-}
-
-export interface UsageRequest {
-  type: "usage_request";
-  conversationId: string;
-}
-
-export interface ConversationsClearRequest {
-  type: "conversations_clear";
-}
-
-export interface ReorderConversationsRequest {
-  type: "reorder_conversations";
-  updates: Array<{
-    conversationId: string;
-    displayOrder: number | null;
-    isPinned: boolean;
-  }>;
-}
-
 // === Server → Client ===
 
-export interface ConversationInfo {
-  type: "conversation_info";
-  conversationId: string;
-  title: string;
-  correlationId?: string;
-  conversationType?: ConversationType;
-  /**
-   * Per-conversation override for the LLM inference profile. `undefined`
-   * means the conversation inherits the workspace `llm.activeProfile`.
-   */
-  inferenceProfile?: string;
-}
-
-/** Channel binding metadata exposed in conversation list APIs. */
-interface ChannelBinding {
-  sourceChannel: ChannelId;
-  externalChatId: string;
-  externalChatName?: string | null;
-  externalThreadId?: string | null;
-  externalUserId?: string | null;
-  displayName?: string | null;
-  username?: string | null;
-  slackThread?: {
-    channelId: string;
-    threadTs: string;
-    link?: {
-      appUrl?: string;
-      webUrl?: string;
-    };
-  };
-  slackChannel?: {
-    channelId: string;
-    name?: string;
-    link?: {
-      webUrl?: string;
-    };
-  };
-}
-
-/** Attention state metadata for a conversation's latest assistant message. */
-interface AssistantAttention {
-  hasUnseenLatestAssistantMessage: boolean;
-  latestAssistantMessageAt?: number;
-  lastSeenAssistantMessageAt?: number;
-  lastSeenConfidence?: string;
-  lastSeenSignalType?: string;
-}
-
-interface ConversationForkParent {
-  conversationId: string;
-  messageId: string;
-  title: string;
-}
-
-export interface ConversationListResponse {
-  type: "conversation_list_response";
-  conversations: Array<{
-    id: string;
-    title: string;
-    createdAt?: number;
-    updatedAt: number;
-    conversationType?: ConversationType;
-    source?: string;
-    scheduleJobId?: string;
-    channelBinding?: ChannelBinding;
-    conversationOriginChannel?: ChannelId;
-    conversationOriginInterface?: InterfaceId;
-    assistantAttention?: AssistantAttention;
-    displayOrder?: number;
-    isPinned?: boolean;
-    forkParent?: ConversationForkParent;
-    /**
-     * Per-conversation override for the LLM inference profile. Omitted when
-     * the conversation inherits the workspace `llm.activeProfile`.
-     */
-    inferenceProfile?: string;
-  }>;
-  /** Whether more conversations exist beyond the returned page. */
-  hasMore?: boolean;
-}
-
-interface HistoryResponseToolCall {
-  name: string;
-  input: Record<string, unknown>;
-  result?: string;
-  isError?: boolean;
-  /** Base64-encoded image data from tool contentBlocks (e.g. browser_screenshot). @deprecated Use imageDataList. */
-  imageData?: string;
-  /** Base64-encoded image data from tool contentBlocks (e.g. browser_screenshot, image generation). */
-  imageDataList?: string[];
-  /** Workspace attachment ids for tool-result images persisted as references; clients fetch bytes by id on render instead of embedding base64. */
-  imageAttachmentIds?: string[];
-  /** Unix ms when the tool started executing. */
-  startedAt?: number;
-  /** Unix ms when the tool completed. */
-  completedAt?: number;
-  /** Confirmation decision for this tool call: "approved" | "denied" | "timed_out". */
-  confirmationDecision?: string;
-  /** Friendly label for the confirmation (e.g. "Edit File", "Run Command"). */
-  confirmationLabel?: string;
-  /** Risk level at the time of invocation ("low" | "medium" | "high" | "unknown"). */
-  riskLevel?: string;
-  /** Human-readable reason for the risk classification. */
-  riskReason?: string;
-  /**
-   * @deprecated Use `approvalMode` and `approvalReason` instead.
-   * Kept for backward compatibility during the migration window.
-   */
-  autoApproved?: boolean;
-  /** How the approval decision was reached: prompted, auto, blocked, or unknown (legacy). */
-  approvalMode?: string;
-  /** Why the approval decision was reached (stable enum for client display). */
-  approvalReason?: string;
-  /** Snapshot of the auto-approve threshold at execution time. */
-  riskThreshold?: string;
-}
-
-interface HistoryResponseSurface {
-  surfaceId: string;
-  surfaceType: string;
-  title?: string;
-  data: Record<string, unknown>;
-  actions?: Array<{
-    id: string;
-    label: string;
-    style?: string;
-    data?: Record<string, unknown>;
-  }>;
-  display?: string;
-  /** True when the surface was completed (e.g. form submitted, action taken). */
-  completed?: boolean;
-  /** Human-readable summary shown in the completion chip. */
-  completionSummary?: string;
-}
-
-export interface HistoryResponse {
-  type: "history_response";
-  conversationId: string;
-  messages: Array<{
-    /** Database ID used by clients for the rendered message. */
-    id?: string;
-    role: string;
-    text: string;
-    timestamp: number;
-    toolCalls?: HistoryResponseToolCall[];
-    /** True when tool_use blocks appeared before any text block in the original content. */
-    toolCallsBeforeText?: boolean;
-    attachments?: UserMessageAttachment[];
-    /** Text segments split by tool-call boundaries. Preserves interleaving order. */
-    textSegments?: string[];
-    /** Content block ordering using "text:N", "tool:N", "surface:N" encoding. */
-    contentOrder?: string[];
-    /** UI surfaces (widgets) embedded in the message. */
-    surfaces?: HistoryResponseSurface[];
-    /** Present when this message is a subagent lifecycle notification (running/completed/failed/aborted). */
-    subagentNotification?: {
-      subagentId: string;
-      label: string;
-      status: "running" | "completed" | "failed" | "aborted";
-      error?: string;
-      conversationId?: string;
-      objective?: string;
-    };
-    /** True when text or tool result content was truncated due to maxTextChars/maxToolResultChars. */
-    wasTruncated?: boolean;
-  }>;
-  /** Whether older messages exist beyond the returned page. */
-  hasMore: boolean;
-  /** Timestamp of the oldest message in the response (client uses as next pagination cursor). */
-  oldestTimestamp?: number;
-  /** ID of the oldest message in the response (tie-breaker for same-millisecond cursors). */
-  oldestMessageId?: string;
-}
-
-export interface UndoComplete {
-  type: "undo_complete";
-  removedCount: number;
-  conversationId?: string;
-}
-
-export interface UsageResponse {
-  type: "usage_response";
-  totalInputTokens: number;
-  totalOutputTokens: number;
-  estimatedCost: number;
-  model: string;
-}
-
-/**
- * Emitted when the compaction circuit breaker trips. After three consecutive
- * summary-LLM failures (with local fallback covering each), auto-compaction is
- * suspended until `openUntil` to avoid repeatedly hammering a broken provider.
- * User-initiated compaction (`/compact`, `force: true`) bypasses the breaker.
- *
- * `conversationId` scopes the event so clients can ignore breaker trips from
- * other conversations — `EventStreamClient` broadcasts every parsed server
- * message to all subscribers, so without this field a breaker trip in one
- * conversation would set the "auto-compaction paused" banner on every open
- * `ChatViewModel`.
- */
-
 // `open_conversation` is a migrated event: its canonical wire contract lives
 // in `../../api/events/open-conversation.ts` (imported as
 // `OpenConversationEvent`). Instructs the client to open and, by default,
 // focus a conversation — see that file for the full field docs.
-
-// --- Domain-level union aliases (consumed by the barrel file) ---
-
-export type _ConversationsClientMessages =
-  | AuthMessage
-  | PingMessage
-  | CancelRequest
-  | DeleteQueuedMessage
-  | ModelGetRequest
-  | ImageGenModelSetRequest
-  | UndoRequest
-  | UsageRequest
-  | ConversationListRequest
-  | ConversationCreateRequest
-  | ConversationSwitchRequest
-  | ConversationRenameRequest
-  | ConversationsClearRequest
-  | ReorderConversationsRequest;
-
-export type _ConversationsServerMessages =
-  | AssistantStatusEvent
-  | GenerationCancelledEvent
-  | GenerationHandoffEvent
-  | ModelInfoEvent
-  | HistoryResponse
-  | UndoComplete
-  | UsageUpdateEvent
-  | UsageProgressEvent
-  | UsageResponse
-  | ContextCompactedEvent
-  | CompactionCircuitOpenEvent
-  | CompactionCircuitClosedEvent
-  | ConversationErrorEvent
-  | ConversationNoticeEvent
-  | ConversationInfo
-  | ConversationTitleUpdatedEvent
-  | ConversationListResponse
-  | ConversationListInvalidatedEvent
-  | ScheduleConversationCreatedEvent
-  | OpenConversationEvent;

package/src/daemon/message-types/host-app-control.ts

@@ -6,20 +6,11 @@
 // body the client POSTs to /v1/host-app-control-result — a route contract, not
 // an event.
 
-import type { HostAppControlCancelEvent } from "../../api/events/host-app-control.js";
-import type { HostAppControlRequestEvent } from "../../api/events/host-app-control.js";
-
 export type {
   HostAppControlInput,
   HostAppControlSequenceStep,
 } from "../../api/events/host-app-control.js";
 
-// --- Domain-level union aliases (consumed by the barrel file) ---
-
-export type _HostAppControlServerMessages =
-  | HostAppControlRequestEvent
-  | HostAppControlCancelEvent;
-
 // === Result payload (HTTP /v1/host-app-control-result body) ===
 
 /** Lifecycle state of the targeted application as seen by the client. */

package/src/daemon/message-types/host-browser.ts

@@ -5,9 +5,6 @@
 // wire schema. The client→server events below are unsolicited signals the
 // chrome extension pushes back to the runtime.
 
-import type { HostBrowserCancelEvent } from "../../api/events/host-browser.js";
-import type { HostBrowserRequestEvent } from "../../api/events/host-browser.js";
-
 // === Client → Server ===
 
 /**
@@ -76,10 +73,6 @@ export interface HostBrowserSessionInvalidated {
 
 // --- Domain-level union aliases (consumed by the barrel file) ---
 
-export type _HostBrowserServerMessages =
-  | HostBrowserRequestEvent
-  | HostBrowserCancelEvent;
-
 export type _HostBrowserClientMessages =
   | HostBrowserEvent
   | HostBrowserSessionInvalidated;

package/src/daemon/message-types/host-ui-snapshot.ts

@@ -5,15 +5,8 @@
 // wire schema. `HostUiSnapshotResultPayload` is the HTTP body the client POSTs
 // to /v1/host-ui-snapshot-result — a route contract, not an event.
 
-import type { HostUiSnapshotCancelEvent } from "../../api/events/host-ui-snapshot.js";
-import type { HostUiSnapshotRequestEvent } from "../../api/events/host-ui-snapshot.js";
-
 export type { HostUiSnapshotView } from "../../api/events/host-ui-snapshot.js";
 
-export type _HostUiSnapshotServerMessages =
-  | HostUiSnapshotRequestEvent
-  | HostUiSnapshotCancelEvent;
-
 /** Body the desktop client POSTs to /v1/host-ui-snapshot-result. */
 export interface HostUiSnapshotResultPayload {
   requestId: string;