@vellumai/plugin-api 0.10.12-staging.1 → 0.10.12-staging.2

package/index.d.ts

@@ -152,84 +152,14 @@ 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 interface AppDataResponse {
-    type: "app_data_response";
-    surfaceId: string;
-    callId: string;
-    success: boolean;
-    result?: unknown;
-    error?: string;
-}
-
-declare interface AppDeleteResponse {
-    type: "app_delete_response";
-    success: boolean;
-}
-
-declare interface AppDiffResponse {
-    type: "app_diff_response";
-    appId: string;
-    diff: string;
-}
-
-declare interface AppFileAtVersionResponse {
-    type: "app_file_at_version_response";
-    appId: string;
-    path: string;
-    content: string;
-}
-
-declare interface AppFilesChanged {
-    type: "app_files_changed";
-    appId: string;
-}
-
-declare interface AppHistoryResponse {
-    type: "app_history_response";
-    appId: string;
-    versions: Array<{
-        commitHash: string;
-        message: string;
-        timestamp: number;
-    }>;
-}
-
-declare interface AppPreviewResponse {
-    type: "app_preview_response";
-    appId: string;
-    preview?: string;
-}
-
-declare interface AppRestoreResponse {
-    type: "app_restore_response";
-    success: boolean;
-    error?: string;
-}
-
-declare interface AppsListResponse {
-    type: "apps_list_response";
-    apps: Array<{
-        id: string;
-        name: string;
-        description?: string;
-        icon?: string;
-        preview?: string;
-        createdAt: number;
-        version?: string;
-        contentId?: string;
-    }>;
-}
-
-declare type _AppsServerMessages = AppDataResponse | AppsListResponse | SharedAppsListResponse | AppDeleteResponse | SharedAppDeleteResponse | ForkSharedAppResponse | BundleAppResponse | OpenBundleResponse | SignBundlePayloadRequest | GetSigningIdentityRequest | ShareAppCloudResponse | AppHistoryResponse | AppDiffResponse | AppFileAtVersionResponse | AppRestoreResponse | AppUpdatePreviewResponse | AppPreviewResponse | PublishPageResponse | UnpublishPageResponse | AppFilesChanged;
+declare const AppFilesChangedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"app_files_changed">;
+    appId: z.ZodString;
+}, z.core.$strip>;
 
-declare interface AppUpdatePreviewResponse {
-    type: "app_update_preview_response";
-    success: boolean;
-    appId: string;
-}
+declare type _AppsServerMessages = AppFilesChangedEvent;
 
 /**
  * How {@link listConversations} (and friends) treats archived rows.
@@ -1688,39 +1618,6 @@ declare type _BookmarksServerMessages = BookmarkCreatedEvent | BookmarkDeletedEv
  */
 export declare function buildMessageExcerpt(rawContent: string, query: string): Promise<string>;
 
-declare interface BundleAppResponse {
-    type: "bundle_app_response";
-    bundlePath: string;
-    /** Base64-encoded PNG of the generated app icon, if available. */
-    iconImageBase64?: string;
-    manifest: {
-        format_version: number;
-        name: string;
-        description?: string;
-        icon?: string;
-        created_at: string;
-        created_by: string;
-        entry: string;
-        capabilities: string[];
-        version?: string;
-        content_id?: 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.
@@ -1809,28 +1706,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 {
@@ -2029,17 +1904,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<{
@@ -2306,14 +2170,6 @@ 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>;
-
 /** Create a live voice connection bound to the caller's `send` transport. */
 export declare function createLiveVoiceConnection(options: {
     send: LiveVoiceFrameSender;
@@ -2468,16 +2324,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;
 
 /**
@@ -2489,33 +2335,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>;
 
@@ -2567,82 +2386,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 interface ForkSharedAppResponse {
-    type: "fork_shared_app_response";
-    success: boolean;
-    appId?: string;
-    name?: string;
-    error?: string;
-}
-
-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<{
@@ -2716,11 +2459,6 @@ export declare function getMessages(conversationId: string): Promise<MessageRow[
  */
 export declare function getModelProfiles(): ModelProfileInfo[];
 
-declare interface GetSigningIdentityRequest {
-    type: "get_signing_identity";
-    requestId: string;
-}
-
 /**
  * Returns the workspace root for user-facing state.
  *
@@ -3261,22 +2999,6 @@ declare interface ImageEmbeddingInput {
     mimeType: string;
 }
 
-declare interface IngressConfigResponse {
-    type: "ingress_config_response";
-    enabled: boolean;
-    publicBaseUrl: string;
-    /** Read-only gateway target computed from GATEWAY_PORT env var (default 7830) + loopback host. */
-    localGatewayTarget: string;
-    /**
-     * When true, this assistant uses platform-managed callback routing.
-     * Webhook delivery is handled by the platform — no local tunnel or
-     * ngrok setup is needed. `publicBaseUrl` reflects the platform callback URL.
-     */
-    managedCallbacks?: boolean;
-    success: boolean;
-    error?: string;
-}
-
 /**
  * Context passed to `Plugin.init()` during bootstrap. Carries the resolved
  * config, a pino-compatible logger scoped to the plugin, a per-plugin
@@ -3320,29 +3042,7 @@ declare interface InsertedMessage {
     deduplicated: boolean;
 }
 
-declare interface IntegrationConnectResult {
-    type: "integration_connect_result";
-    integrationId: string;
-    success: boolean;
-    accountInfo?: string | null;
-    error?: string | null;
-    setupRequired?: boolean;
-    setupHint?: string;
-}
-
-declare interface IntegrationListResponse {
-    type: "integration_list_response";
-    integrations: Array<{
-        id: string;
-        connected: boolean;
-        accountInfo?: string | null;
-        connectedAt?: number | null;
-        lastUsed?: number | null;
-        error?: string | null;
-    }>;
-}
-
-declare type _IntegrationsServerMessages = SlackWebhookConfigResponse | IngressConfigResponse | PlatformConfigResponse | VercelApiConfigResponse | TelegramConfigResponse | ChannelVerificationSessionResponse | IntegrationListResponse | IntegrationConnectResult | OAuthConnectResultResponse | OpenUrlEvent | OpenPanelEvent | NavigateSettingsEvent | ShowPlatformLogin | PlatformDisconnected;
+declare type _IntegrationsServerMessages = ChannelVerificationSessionResponse | OAuthConnectResultEvent | OpenUrlEvent | OpenPanelEvent | NavigateSettingsEvent | ShowPlatformLoginEvent | PlatformDisconnectedEvent;
 
 declare type InteractionResolvedEvent = z.infer<typeof InteractionResolvedEventSchema>;
 
@@ -3450,23 +3150,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"];
@@ -4081,50 +3764,17 @@ declare const NotificationIntentEventSchema: z.ZodObject<{
 
 declare type _NotificationsServerMessages = NotificationIntentEvent | NotificationConversationCreatedEvent;
 
-declare interface OAuthConnectResultResponse {
-    type: "oauth_connect_result";
-    success: boolean;
-    service?: string;
-    grantedScopes?: string[];
-    accountInfo?: string;
-    error?: string;
-}
-
-declare type OAuthConnectSurfaceData = z.infer<typeof OAuthConnectSurfaceDataSchema>;
+declare type OAuthConnectResultEvent = z.infer<typeof OAuthConnectResultEventSchema>;
 
-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>>>;
+declare const OAuthConnectResultEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"oauth_connect_result">;
+    success: z.ZodBoolean;
+    service: z.ZodOptional<z.ZodString>;
+    grantedScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    accountInfo: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
-declare interface OpenBundleResponse {
-    type: "open_bundle_response";
-    manifest: {
-        format_version: number;
-        name: string;
-        description?: string;
-        icon?: string;
-        created_at: string;
-        created_by: string;
-        entry: string;
-        capabilities: string[];
-    };
-    scanResult: {
-        passed: boolean;
-        blocked: string[];
-        warnings: string[];
-    };
-    signatureResult: {
-        trustTier: "verified" | "signed" | "unsigned" | "tampered";
-        signerKeyId?: string;
-        signerDisplayName?: string;
-        signerAccount?: string;
-    };
-    bundleSizeBytes: number;
-}
-
 declare type OpenConversationEvent = z.infer<typeof OpenConversationEventSchema>;
 
 declare const OpenConversationEventSchema: z.ZodObject<{
@@ -4188,16 +3838,11 @@ export declare function parseMessageMetadata(metadataJson: string | null): Promi
  */
 declare function parseMessageMetadata_2(metadataJson: string | null): MessageMetadata_2 | undefined;
 
-declare interface PlatformConfigResponse {
-    type: "platform_config_response";
-    baseUrl: string;
-    success: boolean;
-    error?: string;
-}
+declare type PlatformDisconnectedEvent = z.infer<typeof PlatformDisconnectedEventSchema>;
 
-declare interface PlatformDisconnected {
-    type: "platform_disconnected";
-}
+declare const PlatformDisconnectedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"platform_disconnected">;
+}, z.core.$strip>;
 
 /**
  * The subset of {@link AssistantEventHub} workspace plugins may use. Picking
@@ -4688,15 +4333,6 @@ declare interface ProxyApprovalRequest {
 
 declare type ProxyToolResolver = (toolName: string, input: Record<string, unknown>) => Promise<ToolExecutionResult>;
 
-declare interface PublishPageResponse {
-    type: "publish_page_response";
-    success: boolean;
-    publicUrl?: string;
-    deploymentId?: string;
-    error?: string;
-    errorCode?: string;
-}
-
 /**
  * Remove every previously-refused exchange from a working history: for each
  * assistant message that is exactly the refusal fallback, drop it together with
@@ -5290,41 +4926,11 @@ declare const ServiceGroupUpdateStartingEventSchema: z.ZodObject<{
 
 declare type _SettingsServerMessages = ClientSettingsUpdateEvent | AvatarUpdatedEvent | ConfigChangedEvent | SoundsConfigUpdatedEvent;
 
-declare interface ShareAppCloudResponse {
-    type: "share_app_cloud_response";
-    success: boolean;
-    shareToken?: string;
-    shareUrl?: string;
-    error?: string;
-}
-
-declare interface SharedAppDeleteResponse {
-    type: "shared_app_delete_response";
-    success: boolean;
-}
+declare type ShowPlatformLoginEvent = z.infer<typeof ShowPlatformLoginEventSchema>;
 
-declare interface SharedAppsListResponse {
-    type: "shared_apps_list_response";
-    apps: Array<{
-        uuid: string;
-        name: string;
-        description?: string;
-        icon?: string;
-        preview?: string;
-        entry: string;
-        trustTier: string;
-        signerDisplayName?: string;
-        bundleSizeBytes: number;
-        installedAt: string;
-        version?: string;
-        contentId?: string;
-        updateAvailable?: boolean;
-    }>;
-}
-
-declare interface ShowPlatformLogin {
-    type: "show_platform_login";
-}
+declare const ShowPlatformLoginEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"show_platform_login">;
+}, z.core.$strip>;
 
 /**
  * Context passed to the `shutdown` hook. Kept intentionally narrower than
@@ -5367,12 +4973,6 @@ export declare interface ShutdownContext {
  */
 declare type ShutdownReason = "shutdown" | "uninstall" | "disable" | "reload";
 
-declare interface SignBundlePayloadRequest {
-    type: "sign_bundle_payload";
-    requestId: string;
-    payload: string;
-}
-
 declare interface SkillInstallMeta {
     origin: "vellum" | "clawhub" | "skillssh" | "custom";
     installedAt: string;
@@ -5417,13 +5017,6 @@ declare const SkillStateChangedEventSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 
-declare interface SlackWebhookConfigResponse {
-    type: "slack_webhook_config_response";
-    webhookUrl?: string;
-    success: boolean;
-    error?: string;
-}
-
 declare type SoundsConfigUpdatedEvent = z.infer<typeof SoundsConfigUpdatedEventSchema>;
 
 declare const SoundsConfigUpdatedEventSchema: z.ZodObject<{
@@ -5727,70 +5320,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 | UiSurfaceDismiss | UiSurfaceComplete | UiSurfaceUndoResult;
-
-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
@@ -5856,48 +5386,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>;
-
-declare interface TelegramConfigResponse {
-    type: "telegram_config_response";
-    success: boolean;
-    hasBotToken: boolean;
-    botId?: string;
-    botUsername?: string;
-    connected: boolean;
-    hasWebhookSecret: boolean;
-    lastError?: string;
-    error?: string;
-    /** Names of bot commands that were registered (present after set_commands or setup). */
-    commandsRegistered?: string[];
-    /** Non-fatal warning (e.g. commands registration failed during setup but token was configured). */
-    warning?: string;
-}
-
 export declare interface TextContent {
     type: "text";
     text: string;
@@ -5955,6 +5443,15 @@ export declare interface ToolContext {
     assistantId?: string;
     /** True when an interactive client is connected (not just a no-op callback). */
     isInteractive?: boolean;
+    /**
+     * Whether the current turn's channel can render dynamic UI surfaces
+     * (interactive cards, tappable option pickers, secure prompts). `false` on
+     * text-only channels (e.g. Telegram, SMS). UI-dependent tools read this to
+     * degrade to a text-formatted equivalent instead of emitting a surface the
+     * channel silently drops. `undefined` means unknown and is treated as
+     * supported (desktop/web/app clients).
+     */
+    supportsDynamicUi?: boolean;
     /**
      * When set, the tool execution is part of a task run. Used to retrieve ephemeral permission rules.
      * @legacy
@@ -6582,71 +6079,70 @@ declare type TtsUseCase =
 /** In-app message playback — buffer-oriented, higher quality acceptable. */
 | "message-playback";
 
-declare interface UiSurfaceComplete {
-    type: "ui_surface_complete";
-    conversationId: string;
-    surfaceId: string;
-    summary: string;
-    submittedData?: Record<string, unknown>;
-}
+declare type UISurfaceCompleteEvent = z.infer<typeof UISurfaceCompleteEventSchema>;
 
-declare interface UiSurfaceDismiss {
-    type: "ui_surface_dismiss";
-    conversationId: string;
-    surfaceId: string;
-}
+declare const UISurfaceCompleteEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_complete">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    summary: z.ZodString;
+    submittedData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, 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];
+declare type UISurfaceDismissEvent = z.infer<typeof UISurfaceDismissEventSchema>;
 
-/** 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 const UISurfaceDismissEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_dismiss">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+}, z.core.$strip>;
 
-/**
- * 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 type UISurfaceShowEvent = z.infer<typeof UISurfaceShowEventSchema>;
 
-declare interface UiSurfaceUndoResult {
-    type: "ui_surface_undo_result";
-    conversationId: string;
-    surfaceId: string;
-    success: boolean;
-    /** Number of remaining undo entries after this undo. */
-    remainingUndos: number;
-}
+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 interface UiSurfaceUpdate {
-    type: "ui_surface_update";
-    conversationId: string;
-    surfaceId: string;
-    data: Partial<AnySurfaceData>;
-}
+declare type UISurfaceUndoResultEvent = z.infer<typeof UISurfaceUndoResultEventSchema>;
+
+declare const UISurfaceUndoResultEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_undo_result">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    success: z.ZodBoolean;
+    remainingUndos: z.ZodNumber;
+}, z.core.$strip>;
+
+declare type UISurfaceUpdateEvent = z.infer<typeof UISurfaceUpdateEventSchema>;
+
+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>;
 
 declare interface UndoComplete {
     type: "undo_complete";
@@ -6654,12 +6150,6 @@ declare interface UndoComplete {
     conversationId?: string;
 }
 
-declare interface UnpublishPageResponse {
-    type: "unpublish_page_response";
-    success: boolean;
-    error?: string;
-}
-
 /** Merge the given keys into a message's metadata JSON. */
 export declare function updateMessageMetadata(messageId: string, updates: Record<string, unknown>): Promise<void>;
 
@@ -6861,13 +6351,6 @@ declare interface UserPromptSubmitInputContext {
     latestMessages: Message[];
 }
 
-declare interface VercelApiConfigResponse {
-    type: "vercel_api_config_response";
-    hasToken: boolean;
-    success: boolean;
-    error?: string;
-}
-
 declare interface VideoEmbeddingInput {
     type: "video";
     data: Buffer;
@@ -6999,64 +6482,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.12-staging.1",
+  "version": "0.10.12-staging.2",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",