@vellumai/plugin-api 0.10.11-dev.202607241308.39465e9 → 0.10.11-dev.202607241439.ab7e771

package/index.d.ts

@@ -152,9 +152,6 @@ export declare type AgentLoopExitReason =
 /** An unhandled error ended the turn. */
 | "error";
 
-/** Any surface `data` payload, including the opaque (non-renderable) types. */
-declare type AnySurfaceData = SurfaceDataByType[SurfaceType];
-
 declare type AppFilesChangedEvent = z.infer<typeof AppFilesChangedEventSchema>;
 
 declare const AppFilesChangedEventSchema: z.ZodObject<{
@@ -213,15 +210,6 @@ declare const AssistantActivityStateEventSchema: z.ZodObject<{
     statusText: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
-/** Attention state metadata for a conversation's latest assistant message. */
-declare interface AssistantAttention {
-    hasUnseenLatestAssistantMessage: boolean;
-    latestAssistantMessageAt?: number;
-    lastSeenAssistantMessageAt?: number;
-    lastSeenConfidence?: string;
-    lastSeenSignalType?: string;
-}
-
 declare type AssistantConfig = z.infer<typeof AssistantConfigSchema>;
 
 declare const AssistantConfigSchema: z.ZodObject<{
@@ -1621,20 +1609,6 @@ declare type _BookmarksServerMessages = BookmarkCreatedEvent | BookmarkDeletedEv
  */
 export declare function buildMessageExcerpt(rawContent: string, query: string): Promise<string>;
 
-declare type CardSurfaceData = z.infer<typeof CardSurfaceDataSchema>;
-
-declare const CardSurfaceDataSchema: z.ZodObject<{
-    title: z.ZodOptional<z.ZodString>;
-    subtitle: z.ZodOptional<z.ZodString>;
-    body: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        label: z.ZodCoercedString<unknown>;
-        value: z.ZodCoercedString<unknown>;
-    }, z.core.$strip>>>;
-    template: z.ZodOptional<z.ZodString>;
-    templateData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
-
 /**
  * Canonical channel-id vocabulary shared between the assistant daemon and the
  * gateway.
@@ -1658,32 +1632,6 @@ declare const CardSurfaceDataSchema: z.ZodObject<{
  */
 declare const CHANNEL_IDS: readonly ["telegram", "phone", "vellum", "whatsapp", "slack", "email", "platform", "a2a"];
 
-/** Channel binding metadata exposed in conversation list APIs. */
-declare 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;
-        };
-    };
-}
-
 declare type ChannelId = (typeof CHANNEL_IDS)[number];
 
 declare interface ChannelVerificationSessionResponse {
@@ -1723,28 +1671,6 @@ declare interface ChannelVerificationSessionResponse {
     pendingBootstrap?: boolean;
 }
 
-declare type ChoiceSurfaceData = z.infer<typeof ChoiceSurfaceDataSchema>;
-
-declare const ChoiceSurfaceDataSchema: z.ZodObject<{
-    description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    options: z.ZodPipe<z.ZodTransform<{
-        id: string;
-        title: string;
-    }[], unknown>, z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        recommended: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
-        data: z.ZodCatch<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    }, z.core.$strip>>>;
-    selectionMode: z.ZodPipe<z.ZodTransform<"single" | "multiple", unknown>, z.ZodEnum<{
-        single: "single";
-        multiple: "multiple";
-    }>>;
-    commitOnSelect: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
-    submitLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-}, z.core.$strip>;
-
 export declare const CLI_COMMAND_HELP: readonly CliCommandHelp[];
 
 declare interface CliArgumentHelp {
@@ -1943,17 +1869,6 @@ declare const ConfirmationStateChangedEventSchema: z.ZodObject<{
     toolUseId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
-declare type ConfirmationSurfaceData = z.infer<typeof ConfirmationSurfaceDataSchema>;
-
-declare const ConfirmationSurfaceDataSchema: z.ZodObject<{
-    message: z.ZodCatch<z.ZodString>;
-    detail: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    confirmLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    confirmedLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    cancelLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    destructive: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
-}, z.core.$strip>;
-
 declare type ContactRequestEvent = z.infer<typeof ContactRequestEventSchema>;
 
 declare const ContactRequestEventSchema: z.ZodObject<{
@@ -2059,12 +1974,6 @@ declare const ConversationErrorEventSchema: z.ZodObject<{
     profileName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
-declare interface ConversationForkParent {
-    conversationId: string;
-    messageId: string;
-    title: string;
-}
-
 declare type ConversationInferenceProfileUpdatedEvent = z.infer<typeof ConversationInferenceProfileUpdatedEventSchema>;
 
 declare const ConversationInferenceProfileUpdatedEventSchema: z.ZodObject<{
@@ -2075,19 +1984,6 @@ declare const ConversationInferenceProfileUpdatedEventSchema: z.ZodObject<{
     expiresAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 
-declare 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;
-}
-
 declare type ConversationListInvalidatedEvent = z.infer<typeof ConversationListInvalidatedEventSchema>;
 
 declare const ConversationListInvalidatedEventSchema: z.ZodObject<{
@@ -2101,33 +1997,6 @@ declare const ConversationListInvalidatedEventSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 
-declare 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;
-}
-
 declare type ConversationNoticeEvent = z.infer<typeof ConversationNoticeEventSchema>;
 
 declare const ConversationNoticeEventSchema: z.ZodObject<{
@@ -2205,7 +2074,7 @@ export declare interface ConversationRow {
  */
 export declare type ConversationsClearedContext = BaseHookContext;
 
-declare type _ConversationsServerMessages = AssistantStatusEvent | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfoEvent | HistoryResponse | UndoComplete | UsageUpdateEvent | UsageProgressEvent | UsageResponse | ContextCompactedEvent | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationNoticeEvent | ConversationInfo | ConversationTitleUpdatedEvent | ConversationListResponse | ConversationListInvalidatedEvent | ScheduleConversationCreatedEvent | OpenConversationEvent;
+declare type _ConversationsServerMessages = AssistantStatusEvent | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfoEvent | UsageUpdateEvent | UsageProgressEvent | ContextCompactedEvent | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationNoticeEvent | ConversationTitleUpdatedEvent | ConversationListInvalidatedEvent | ScheduleConversationCreatedEvent | OpenConversationEvent;
 
 declare type ConversationTitleUpdatedEvent = z.infer<typeof ConversationTitleUpdatedEventSchema>;
 
@@ -2215,18 +2084,8 @@ declare const ConversationTitleUpdatedEventSchema: z.ZodObject<{
     title: z.ZodString;
 }, z.core.$strip>;
 
-declare type ConversationType = "standard" | "background" | "scheduled";
-
 /** Read-side alias of {@link ConversationCreateType}. */
-declare type ConversationType_2 = ConversationCreateType;
-
-declare type CopyBlockSurfaceData = z.infer<typeof CopyBlockSurfaceDataSchema>;
-
-declare const CopyBlockSurfaceDataSchema: z.ZodObject<{
-    text: z.ZodCatch<z.ZodString>;
-    label: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    language: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-}, z.core.$strip>;
+declare type ConversationType = ConversationCreateType;
 
 /** Create a live voice connection bound to the caller's `send` transport. */
 export declare function createLiveVoiceConnection(options: {
@@ -2382,16 +2241,6 @@ declare const DocumentEditorUpdateEventSchema: z.ZodObject<{
     mode: z.ZodString;
 }, z.core.$strip>;
 
-declare type DocumentPreviewSurfaceData = z.infer<typeof DocumentPreviewSurfaceDataSchema>;
-
-declare const DocumentPreviewSurfaceDataSchema: z.ZodObject<{
-    title: z.ZodCatch<z.ZodString>;
-    surfaceId: z.ZodCatch<z.ZodString>;
-    subtitle: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    content: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    mimeType: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-}, z.core.$strip>;
-
 declare type _DocumentsServerMessages = DocumentEditorShowEvent | DocumentEditorUpdateEvent;
 
 /**
@@ -2403,33 +2252,6 @@ declare type _DocumentsServerMessages = DocumentEditorShowEvent | DocumentEditor
  */
 export declare function doesSupportVision(modelOrProfile: ModelProfileInfo | string): boolean;
 
-declare type DynamicPageSurfaceData = z.infer<typeof DynamicPageSurfaceDataSchema>;
-
-declare const DynamicPageSurfaceDataSchema: z.ZodObject<{
-    html: z.ZodCatch<z.ZodString>;
-    width: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
-    height: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
-    appId: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    dirName: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    reloadGeneration: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
-    status: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    preview: z.ZodCatch<z.ZodOptional<z.ZodObject<{
-        title: z.ZodCatch<z.ZodString>;
-        subtitle: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        icon: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        metrics: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
-            label: z.ZodCoercedString<unknown>;
-            value: z.ZodCoercedString<unknown>;
-        }, z.core.$strip>>>>;
-        context: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
-            app_create: "app_create";
-            general: "general";
-        }>>>;
-        previewImage: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-
 /** Embed a target and upsert its vector into the vector store. */
 export declare function embedAndUpsert(targetType: EmbeddingTargetType, targetId: string, input: EmbeddingInput, extraPayload?: Record<string, unknown>): Promise<void>;
 
@@ -2481,74 +2303,6 @@ export declare interface FileContent {
     _attachmentId?: string;
 }
 
-declare type FileUploadSurfaceData = z.infer<typeof FileUploadSurfaceDataSchema>;
-
-declare const FileUploadSurfaceDataSchema: z.ZodObject<{
-    prompt: z.ZodOptional<z.ZodCoercedString<unknown>>;
-    acceptedTypes: z.ZodPipe<z.ZodTransform<string[] | undefined, unknown>, z.ZodOptional<z.ZodArray<z.ZodString>>>;
-    maxFiles: z.ZodCatch<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-    maxSizeBytes: z.ZodCatch<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-}, z.core.$strip>;
-
-declare type FormSurfaceData = z.infer<typeof FormSurfaceDataSchema>;
-
-declare const FormSurfaceDataSchema: z.ZodObject<{
-    description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    fields: z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-        id: z.ZodCatch<z.ZodString>;
-        type: z.ZodCatch<z.ZodEnum<{
-            number: "number";
-            text: "text";
-            textarea: "textarea";
-            select: "select";
-            toggle: "toggle";
-            password: "password";
-        }>>;
-        label: z.ZodCatch<z.ZodString>;
-        placeholder: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        required: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
-        defaultValue: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-        options: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
-            label: z.ZodCoercedString<unknown>;
-            value: z.ZodCoercedString<unknown>;
-        }, z.core.$strip>>>>;
-    }, z.core.$strip>>>;
-    submitLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    pages: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-        id: z.ZodCatch<z.ZodString>;
-        title: z.ZodCatch<z.ZodString>;
-        description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        fields: z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-            id: z.ZodCatch<z.ZodString>;
-            type: z.ZodCatch<z.ZodEnum<{
-                number: "number";
-                text: "text";
-                textarea: "textarea";
-                select: "select";
-                toggle: "toggle";
-                password: "password";
-            }>>;
-            label: z.ZodCatch<z.ZodString>;
-            placeholder: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-            required: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
-            defaultValue: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-            options: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
-                label: z.ZodCoercedString<unknown>;
-                value: z.ZodCoercedString<unknown>;
-            }, z.core.$strip>>>>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>>>>;
-    pageLabels: z.ZodCatch<z.ZodOptional<z.ZodObject<{
-        next: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        back: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        submit: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    }, z.core.$strip>>>;
-    progressStyle: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
-        bar: "bar";
-        tabs: "tabs";
-    }>>>;
-}, z.core.$strip>;
-
 declare type GenerationCancelledEvent = z.infer<typeof GenerationCancelledEventSchema>;
 
 declare const GenerationCancelledEventSchema: z.ZodObject<{
@@ -2669,99 +2423,6 @@ declare const HeartbeatConversationCreatedEventSchema: z.ZodObject<{
     title: z.ZodString;
 }, z.core.$strip>;
 
-declare 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;
-}
-
-declare 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;
-}
-
-declare 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;
-}
-
 declare type HomeFeedUpdatedEvent = z.infer<typeof HomeFeedUpdatedEventSchema>;
 
 declare const HomeFeedUpdatedEventSchema: z.ZodObject<{
@@ -3303,7 +2964,7 @@ export declare function lastToolResultUserMessageIndex(history: Message[]): numb
 export declare function listCatalogSkills(): Promise<ResolvedSkillEntry[]>;
 
 /** List conversation rows, newest first. */
-export declare function listConversations(limit?: number, conversationType?: ConversationType_2, offset?: number, archiveStatus?: ArchiveStatusFilter, originChannel?: string): Promise<ConversationRow[]>;
+export declare function listConversations(limit?: number, conversationType?: ConversationType, offset?: number, archiveStatus?: ArchiveStatusFilter, originChannel?: string): Promise<ConversationRow[]>;
 
 /**
  * The locally installed skill catalog with resolved states. Includes every
@@ -3313,23 +2974,6 @@ export declare function listConversations(limit?: number, conversationType?: Con
  */
 export declare function listInstalledSkills(): Promise<ResolvedSkillEntry[]>;
 
-declare type ListSurfaceData = z.infer<typeof ListSurfaceDataSchema>;
-
-declare const ListSurfaceDataSchema: z.ZodObject<{
-    items: z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-        id: z.ZodCatch<z.ZodString>;
-        title: z.ZodCatch<z.ZodString>;
-        subtitle: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        icon: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        selected: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
-    }, z.core.$strip>>>;
-    selectionMode: z.ZodCatch<z.ZodEnum<{
-        none: "none";
-        single: "single";
-        multiple: "multiple";
-    }>>;
-}, z.core.$strip>;
-
 declare const _LIVE_VOICE_SERVER_FRAME_TYPES: readonly ["ready", "busy", "speech_started", "utterance_end", "utterance_discarded", "stt_partial", "stt_final", "thinking", "assistant_text_delta", "tts_audio", "tts_done", "turn_cancelled", "metrics", "archived", "error"];
 
 declare const LIVE_VOICE_TURN_DETECTION_MODES: readonly ["manual", "server_vad"];
@@ -3955,15 +3599,6 @@ declare const OAuthConnectResultEventSchema: z.ZodObject<{
     error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
-declare type OAuthConnectSurfaceData = z.infer<typeof OAuthConnectSurfaceDataSchema>;
-
-declare const OAuthConnectSurfaceDataSchema: z.ZodObject<{
-    providerKey: z.ZodCatch<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>>;
-    displayName: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    logoUrl: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-}, z.core.$strip>;
-
 declare type OpenConversationEvent = z.infer<typeof OpenConversationEventSchema>;
 
 declare const OpenConversationEventSchema: z.ZodObject<{
@@ -4522,6 +4157,17 @@ declare interface ProxyApprovalRequest {
 
 declare type ProxyToolResolver = (toolName: string, input: Record<string, unknown>) => Promise<ToolExecutionResult>;
 
+/**
+ * Publish a runtime event to the assistant's event hub. Resolves once fanout to
+ * all subscribers has been attempted (a throwing subscriber never aborts
+ * delivery to the rest). Rejects if the event is non-serializable or is a
+ * host-proxy control event, which plugins may not publish.
+ */
+export declare function publishEvent(event: AssistantEvent, options?: PublishEventOptions): Promise<void>;
+
+/** Publish options, mirroring the hub's `publish` options (targeting, self-echo suppression). */
+export declare type PublishEventOptions = NonNullable<Parameters<PluginEventHub["publish"]>[1]>;
+
 /**
  * Remove every previously-refused exchange from a working history: for each
  * assistant message that is exactly the refusal fallback, drop it together with
@@ -5080,7 +4726,7 @@ declare interface SensitiveOutputBinding {
 
 declare type SensitiveOutputKind = "invite_code";
 
-declare 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;
+declare 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 | SubagentEventEvent;
 
 export declare interface ServerToolUseContent {
     type: "server_tool_use";
@@ -5443,27 +5089,23 @@ export declare interface SttStreamServerPartialEvent {
     readonly confidence?: number;
 }
 
-declare interface SubagentDetailResponse {
-    type: "subagent_detail_response";
-    subagentId: string;
-    objective?: string;
-    usage?: UsageStats;
-    events: Array<{
-        type: string;
-        content: string;
-        toolName?: string;
-        isError?: boolean;
-        messageId?: string;
-    }>;
-}
+declare type SubagentEventEvent = z.infer<typeof SubagentEventEventSchema>;
 
-/** Wraps any ServerMessage emitted by a subagent conversation for routing to the client. */
-declare interface SubagentEvent {
-    type: "subagent_event";
-    subagentId: string;
-    conversationId: string;
-    event: ServerMessage;
-}
+declare const SubagentEventEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"subagent_event">;
+    conversationId: z.ZodString;
+    subagentId: z.ZodString;
+    event: z.ZodObject<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        result: z.ZodOptional<z.ZodString>;
+        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        toolName: z.ZodOptional<z.ZodString>;
+        isError: z.ZodOptional<z.ZodBoolean>;
+        toolUseId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strict>;
 
 declare type SubagentSpawnedEvent = z.infer<typeof SubagentSpawnedEventSchema>;
 
@@ -5477,7 +5119,7 @@ declare const SubagentSpawnedEventSchema: z.ZodObject<{
     parentToolUseId: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 
-declare type _SubagentsServerMessages = SubagentSpawnedEvent | SubagentStatusChangedEvent | SubagentDetailResponse;
+declare type _SubagentsServerMessages = SubagentSpawnedEvent | SubagentStatusChangedEvent;
 
 declare type SubagentStatusChangedEvent = z.infer<typeof SubagentStatusChangedEventSchema>;
 
@@ -5488,9 +5130,9 @@ declare const SubagentStatusChangedEventSchema: z.ZodObject<{
         completed: "completed";
         failed: "failed";
         running: "running";
-        aborted: "aborted";
         pending: "pending";
         awaiting_input: "awaiting_input";
+        aborted: "aborted";
         interrupted: "interrupted";
     }>;
     error: z.ZodOptional<z.ZodString>;
@@ -5509,70 +5151,7 @@ declare type SubscriberInput = DistributiveOmit<SubscriberEntry, "active" | "con
     onEvict?: () => void;
 };
 
-declare interface SurfaceAction {
-    id: string;
-    label: string;
-    style?: "primary" | "secondary" | "destructive";
-    /** Optional data payload returned to the daemon when this action is clicked. */
-    data?: Record<string, unknown>;
-}
-
-/**
- * Per-type `data` payload shapes, keyed by surface type. This is the
- * correlation source for everything that pairs a `surfaceType` with its
- * `data`: generic code indexes it (`SurfaceDataByType[K]`) so the compiler
- * tracks which data shape belongs to which type instead of collapsing to
- * the undiscriminated `SurfaceData` union.
- *
- * Several types are opaque records — they carry data the daemon persists
- * and serves verbatim but whose shape it does not model, which is why they
- * are absent from the renderable `SurfaceData` union: `channel_setup` (a
- * side-effect command forwarded to the setup panel), `task_preferences` (a
- * fixed grid that reads no data), and `skill_card` / `call_summary` (cards
- * the daemon appends to history directly — the memory retrospective and a
- * call summary — and whose data shape is owned by their client renderers).
- */
-declare interface SurfaceDataByType {
-    card: CardSurfaceData;
-    channel_setup: Record<string, unknown>;
-    choice: ChoiceSurfaceData;
-    copy_block: CopyBlockSurfaceData;
-    oauth_connect: OAuthConnectSurfaceData;
-    form: FormSurfaceData;
-    list: ListSurfaceData;
-    table: TableSurfaceData;
-    confirmation: ConfirmationSurfaceData;
-    dynamic_page: DynamicPageSurfaceData;
-    file_upload: FileUploadSurfaceData;
-    document_preview: DocumentPreviewSurfaceData;
-    task_preferences: Record<string, unknown>;
-    work_result: WorkResultSurfaceData;
-    skill_card: Record<string, unknown>;
-    call_summary: Record<string, unknown>;
-}
-
-declare type _SurfacesServerMessages = UiSurfaceShow | UiSurfaceUpdate | UISurfaceDismissEvent | UISurfaceCompleteEvent | UISurfaceUndoResultEvent;
-
-declare type SurfaceType = z.infer<typeof SurfaceTypeSchema>;
-
-declare const SurfaceTypeSchema: z.ZodEnum<{
-    table: "table";
-    card: "card";
-    channel_setup: "channel_setup";
-    choice: "choice";
-    copy_block: "copy_block";
-    oauth_connect: "oauth_connect";
-    form: "form";
-    list: "list";
-    confirmation: "confirmation";
-    dynamic_page: "dynamic_page";
-    file_upload: "file_upload";
-    document_preview: "document_preview";
-    task_preferences: "task_preferences";
-    work_result: "work_result";
-    skill_card: "skill_card";
-    call_summary: "call_summary";
-}>;
+declare type _SurfacesServerMessages = UISurfaceShowEvent | UISurfaceUpdateEvent | UISurfaceDismissEvent | UISurfaceCompleteEvent | UISurfaceUndoResultEvent;
 
 /**
  * Delete `graph_node` Qdrant points whose backing `memory_graph_nodes` row no
@@ -5638,32 +5217,6 @@ export declare interface SynthesizeTextOptions {
     signal?: AbortSignal;
 }
 
-declare type TableSurfaceData = z.infer<typeof TableSurfaceDataSchema>;
-
-declare const TableSurfaceDataSchema: z.ZodObject<{
-    columns: z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-        id: z.ZodCatch<z.ZodString>;
-        label: z.ZodCatch<z.ZodString>;
-        width: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
-    }, z.core.$strip>>>;
-    rows: z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-        id: z.ZodCatch<z.ZodString>;
-        cells: z.ZodCatch<z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            text: z.ZodCatch<z.ZodCoercedString<unknown>>;
-            icon: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-            iconColor: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        }, z.core.$strip>]>>>>;
-        selectable: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
-        selected: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
-    }, z.core.$strip>>>;
-    selectionMode: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        single: "single";
-        multiple: "multiple";
-    }>>>;
-    caption: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-}, z.core.$strip>;
-
 export declare interface TextContent {
     type: "text";
     text: string;
@@ -6375,41 +5928,33 @@ declare const UISurfaceDismissEventSchema: z.ZodObject<{
     surfaceId: z.ZodString;
 }, z.core.$strip>;
 
-/**
- * Discriminated union over every surface type, derived from
- * `SurfaceDataByType` so a type added there appears here automatically.
- * Includes the opaque types (`channel_setup`, `task_preferences`) — their
- * show events carry opaque record data.
- */
-declare type UiSurfaceShow = {
-    [K in SurfaceType]: UiSurfaceShowFor<K>;
-}[SurfaceType];
-
-/** Common fields shared by all UiSurfaceShow variants. */
-declare interface UiSurfaceShowBase {
-    type: "ui_surface_show";
-    conversationId: string;
-    surfaceId: string;
-    title?: string;
-    actions?: SurfaceAction[];
-    display?: "inline" | "panel";
-    /** The message ID that this surface belongs to (for history loading). */
-    messageId?: string;
-    /** When `true`, clicking an action does not dismiss the surface — the client keeps the card visible and only marks the clicked `actionId` as spent so siblings remain clickable. */
-    persistent?: boolean;
-    /** Id of the tool call that produced this surface (the `ui_show` proxy tool). Lets the client gate app previews on the tool result's arrival rather than whole-turn streaming state. */
-    toolCallId?: string;
-}
+declare type UISurfaceShowEvent = z.infer<typeof UISurfaceShowEventSchema>;
 
-/**
- * The show event for one specific surface type: base fields plus the
- * correlated `surfaceType`/`data` pair, both indexed from
- * `SurfaceDataByType` so generic code keeps the pairing.
- */
-declare type UiSurfaceShowFor<K extends SurfaceType> = UiSurfaceShowBase & {
-    surfaceType: K;
-    data: SurfaceDataByType[K];
-};
+declare const UISurfaceShowEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_show">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    surfaceType: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        style: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            secondary: "secondary";
+            destructive: "destructive";
+        }>>;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    display: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        panel: "panel";
+    }>>;
+    messageId: z.ZodOptional<z.ZodString>;
+    persistent: z.ZodOptional<z.ZodBoolean>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 
 declare type UISurfaceUndoResultEvent = z.infer<typeof UISurfaceUndoResultEventSchema>;
 
@@ -6421,18 +5966,14 @@ declare const UISurfaceUndoResultEventSchema: z.ZodObject<{
     remainingUndos: z.ZodNumber;
 }, z.core.$strip>;
 
-declare interface UiSurfaceUpdate {
-    type: "ui_surface_update";
-    conversationId: string;
-    surfaceId: string;
-    data: Partial<AnySurfaceData>;
-}
+declare type UISurfaceUpdateEvent = z.infer<typeof UISurfaceUpdateEventSchema>;
 
-declare interface UndoComplete {
-    type: "undo_complete";
-    removedCount: number;
-    conversationId?: string;
-}
+declare const UISurfaceUpdateEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_update">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
 
 /** Merge the given keys into a message's metadata JSON. */
 export declare function updateMessageMetadata(messageId: string, updates: Record<string, unknown>): Promise<void>;
@@ -6469,20 +6010,6 @@ declare const UsageProgressEventSchema: z.ZodObject<{
     model: z.ZodString;
 }, z.core.$strip>;
 
-declare interface UsageResponse {
-    type: "usage_response";
-    totalInputTokens: number;
-    totalOutputTokens: number;
-    estimatedCost: number;
-    model: string;
-}
-
-declare interface UsageStats {
-    inputTokens: number;
-    outputTokens: number;
-    estimatedCost: number;
-}
-
 declare type UsageUpdateEvent = z.infer<typeof UsageUpdateEventSchema>;
 
 declare const UsageUpdateEventSchema: z.ZodObject<{
@@ -6500,24 +6027,6 @@ declare const UsageUpdateEventSchema: z.ZodObject<{
     contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 
-declare interface UserMessageAttachment {
-    id?: string;
-    filename: string;
-    mimeType: string;
-    data: string;
-    /** Origin of the attachment on the daemon side, when known. */
-    sourceType?: "sandbox_file" | "host_file" | "tool_block";
-    extractedText?: string;
-    /** Original file size in bytes. Present when data was omitted from history_response to reduce payload size. */
-    sizeBytes?: number;
-    /** Base64-encoded JPEG thumbnail. Generated server-side for video attachments. */
-    thumbnailData?: string;
-    /** Absolute path to the local file on disk. Present for file-backed attachments (e.g. recordings). */
-    filePath?: string;
-    /** True when the attachment is file-backed and clients should hydrate via the /content endpoint. */
-    fileBacked?: boolean;
-}
-
 declare type UserMessageEchoEvent = z.infer<typeof UserMessageEchoEventSchema>;
 
 declare const UserMessageEchoEventSchema: z.ZodObject<{
@@ -6766,64 +6275,6 @@ declare const WorkflowStartedEventSchema: z.ZodObject<{
     label: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 
-declare type WorkResultSurfaceData = z.infer<typeof WorkResultSurfaceDataSchema>;
-
-declare const WorkResultSurfaceDataSchema: z.ZodObject<{
-    eyebrow: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    status: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
-        completed: "completed";
-        failed: "failed";
-        partial: "partial";
-        in_progress: "in_progress";
-    }>>>;
-    summary: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    metrics: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-        detail: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        tone: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
-            neutral: "neutral";
-            positive: "positive";
-            warning: "warning";
-            negative: "negative";
-        }>>>;
-        label: z.ZodCatch<z.ZodCoercedString<unknown>>;
-        value: z.ZodCatch<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-    }, z.core.$strip>>>>>;
-    sections: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-        id: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        title: z.ZodCatch<z.ZodCoercedString<unknown>>;
-        description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        type: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
-            diff: "diff";
-            items: "items";
-            timeline: "timeline";
-            artifacts: "artifacts";
-            warnings: "warnings";
-        }>>>;
-        items: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-            id: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-            title: z.ZodCatch<z.ZodCoercedString<unknown>>;
-            description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-            status: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-            tone: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
-                neutral: "neutral";
-                positive: "positive";
-                warning: "warning";
-                negative: "negative";
-            }>>>;
-            metadata: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-                label: z.ZodCatch<z.ZodCoercedString<unknown>>;
-                value: z.ZodCatch<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-            }, z.core.$strip>>>>>;
-            href: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        }, z.core.$strip>>>>>;
-        diffs: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
-            label: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-            before: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-            after: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-        }, z.core.$strip>>>>>;
-    }, z.core.$strip>>>>>;
-}, z.core.$strip>;
-
 declare interface WorkspaceFileReadResponse {
     type: "workspace_file_read_response";
     path: string;

package/index.js

@@ -33,6 +33,7 @@ export const listConversations = api.listConversations;
 export const listInstalledSkills = api.listInstalledSkills;
 export const openTranscriptionSession = api.openTranscriptionSession;
 export const parseMessageMetadata = api.parseMessageMetadata;
+export const publishEvent = api.publishEvent;
 export const quarantineRefusedExchanges = api.quarantineRefusedExchanges;
 export const resolveCredential = api.resolveCredential;
 export const resolveMediaSourceData = api.resolveMediaSourceData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.11-dev.202607241308.39465e9",
+  "version": "0.10.11-dev.202607241439.ab7e771",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",