@vellumai/assistant 0.10.12 → 0.11.0-staging.2

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;

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

@@ -1,28 +1,5 @@
 // User/assistant messages, tool results, confirmations, secrets, errors, and generation lifecycle.
 
-import type { AssistantActivityStateEvent } from "../../api/events/assistant-activity-state.js";
-import type { AssistantTextDeltaEvent } from "../../api/events/assistant-text-delta.js";
-import type { AssistantThinkingDeltaEvent } from "../../api/events/assistant-thinking-delta.js";
-import type { AssistantTurnStartEvent } from "../../api/events/assistant-turn-start.js";
-import type { ConfirmationRequestEvent } from "../../api/events/confirmation-request.js";
-import type { ConfirmationStateChangedEvent } from "../../api/events/confirmation-state-changed.js";
-import type { ConversationInferenceProfileUpdatedEvent } from "../../api/events/conversation-inference-profile-updated.js";
-import type { ErrorEvent } from "../../api/events/error.js";
-import type { InteractionResolvedEvent } from "../../api/events/interaction-resolved.js";
-import type { MessageCompleteEvent } from "../../api/events/message-complete.js";
-import type { MessageDequeuedEvent } from "../../api/events/message-dequeued.js";
-import type { MessageQueuedEvent } from "../../api/events/message-queued.js";
-import type { MessageQueuedDeletedEvent } from "../../api/events/message-queued-deleted.js";
-import type { MessageRequestCompleteEvent } from "../../api/events/message-request-complete.js";
-import type { MessageSteeredEvent } from "../../api/events/message-steered.js";
-import type { QuestionRequestEvent } from "../../api/events/question-request.js";
-import type { SecretRequestEvent } from "../../api/events/secret-request.js";
-import type { ToolInputDeltaEvent } from "../../api/events/tool-input-delta.js";
-import type { ToolOutputChunkEvent } from "../../api/events/tool-output-chunk.js";
-import type { ToolResultEvent } from "../../api/events/tool-result.js";
-import type { ToolUsePreviewStartEvent } from "../../api/events/tool-use-preview-start.js";
-import type { ToolUseStartEvent } from "../../api/events/tool-use-start.js";
-import type { UserMessageEchoEvent } from "../../api/events/user-message-echo.js";
 import type { ChannelId, InterfaceId } from "../../channels/types.js";
 import type { CommandIntent, UserMessageAttachment } from "./shared.js";
 
@@ -74,28 +51,3 @@ export type _MessagesClientMessages =
   | UserMessage
   | ConfirmationResponse
   | SecretResponse;
-
-export type _MessagesServerMessages =
-  | UserMessageEchoEvent
-  | AssistantTurnStartEvent
-  | AssistantTextDeltaEvent
-  | AssistantThinkingDeltaEvent
-  | ToolUseStartEvent
-  | ToolUsePreviewStartEvent
-  | ToolOutputChunkEvent
-  | ToolInputDeltaEvent
-  | ToolResultEvent
-  | ConfirmationRequestEvent
-  | SecretRequestEvent
-  | QuestionRequestEvent
-  | MessageCompleteEvent
-  | ErrorEvent
-  | MessageQueuedEvent
-  | MessageDequeuedEvent
-  | MessageRequestCompleteEvent
-  | MessageQueuedDeletedEvent
-  | MessageSteeredEvent
-  | ConfirmationStateChangedEvent
-  | AssistantActivityStateEvent
-  | ConversationInferenceProfileUpdatedEvent
-  | InteractionResolvedEvent;

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

@@ -1,6 +1,3 @@
-import type { NotificationConversationCreatedEvent } from "../../api/events/notification-conversation-created.js";
-import type { NotificationIntentEvent } from "../../api/events/notification-intent.js";
-
 /** Client ack sent after UNUserNotificationCenter.add() completes (or fails). */
 export interface NotificationIntentResult {
   type: "notification_intent_result";
@@ -42,7 +39,3 @@ export type _NotificationsClientMessages =
   | NotificationIntentResult
   | ConversationSeenSignal
   | ConversationUnreadSignal;
-
-export type _NotificationsServerMessages =
-  | NotificationIntentEvent
-  | NotificationConversationCreatedEvent;

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

@@ -4,7 +4,6 @@
 // `api/events` wire schema; the remaining exports are HTTP-API response shapes
 // consumed by the skills routes.
 
-import type { SkillStateChangedEvent } from "../../api/events/skill-state-changed.js";
 import type { PartnerAudit } from "../../skills/skillssh-audit-types.js";
 import type { OwnerInfo } from "../../tools/types.js";
 
@@ -174,7 +173,3 @@ export interface SkillFileContentResponse {
   isBinary: boolean;
   content: string | null;
 }
-
-// --- Domain-level union aliases (consumed by the barrel file) ---
-
-export type _SkillsServerMessages = SkillStateChangedEvent;

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

@@ -155,12 +155,3 @@ export type UiSurfaceShowWorkResult = UiSurfaceShowFor<"work_result">;
 // types above are daemon-side construction helpers derived from the same
 // canonical `UISurfaceShowEvent` — they narrow `surfaceType` ↔ `data` for
 // typed construction and are assignable to the opaque wire type.
-
-// --- Domain-level union aliases (consumed by the barrel file) ---
-
-export type _SurfacesServerMessages =
-  | UISurfaceShowEvent
-  | UISurfaceUpdateEvent
-  | UISurfaceDismissEvent
-  | UISurfaceCompleteEvent
-  | UISurfaceUndoResultEvent;

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

@@ -59,5 +59,3 @@ export function buildSyncChangedMessage(
     ...(trimmedOrigin ? { originClientId: trimmedOrigin } : {}),
   });
 }
-
-export type _SyncInvalidationServerMessages = SyncChangedEvent;

package/src/daemon/process-message.ts

@@ -12,6 +12,7 @@ import {
   createAssistantMessage,
   createUserMessage,
 } from "../agent/message-types.js";
+import type { AssistantEvent } from "../api/index.js";
 import {
   type ChannelId,
   type InterfaceId,
@@ -69,14 +70,13 @@ import {
   preactivateHostProxySkills,
   shouldAttachHostProxyForCapability,
 } from "./host-proxy-preactivation.js";
-import type { ServerMessage } from "./message-protocol.js";
 import type { SubagentToolGateMode } from "./tool-setup-types.js";
 
 const log = getLogger("process-message");
 
 type ProcessMessageOptions = ConversationCreateOptions & {
   /** Per-turn observer for live agent-loop events. Does not replace SSE broadcast. */
-  onEvent?: (msg: ServerMessage) => void;
+  onEvent?: (msg: AssistantEvent) => void;
   /** IDs of user-uploaded attachments to resolve and include in the turn. */
   attachmentIds?: string[];
   /** Originating channel (e.g. "slack", "telegram"). Defaults to "vellum". */
@@ -152,9 +152,9 @@ export function deriveIngressIdempotencyKey(options?: {
 }
 
 function buildEventEmitter(
-  observer?: (msg: ServerMessage) => void,
-): (msg: ServerMessage) => void {
-  if (!observer) return broadcastMessage;
+  observer?: (msg: AssistantEvent) => void,
+): (msg: AssistantEvent) => void {
+  if (!observer) {return broadcastMessage;}
   return (msg) => {
     broadcastMessage(msg);
     try {

package/src/daemon/skill-memory-refresh.ts

@@ -5,9 +5,9 @@ import {
   seedUninstalledCatalogSkillMemories,
 } from "../plugins/defaults/memory/graph/capability-seed.js";
 import {
-  maybeSeedMemoryV2CliCommands,
-  maybeSeedMemoryV2Skills,
-} from "../plugins/defaults/memory/v3/substrate/memory-v2-startup.js";
+  maybeSeedCapabilitySkills,
+  maybeSeedCliCommandCards,
+} from "../plugins/defaults/memory/substrate/boot-maintenance.js";
 import { getLogger } from "../util/logger.js";
 
 const log = getLogger("skill-memory-refresh");
@@ -16,8 +16,8 @@ export function refreshSkillCapabilityMemories(
   config: AssistantConfig = getConfig(),
 ): void {
   seedSkillGraphNodes();
-  maybeSeedMemoryV2Skills(config);
-  maybeSeedMemoryV2CliCommands(config);
+  maybeSeedCapabilitySkills(config);
+  maybeSeedCliCommandCards(config);
   void seedUninstalledCatalogSkillMemories()
     .then(() => {
       // Re-run after the async catalog fetch populates the cache so stale