@vellumai/plugin-api 0.10.11-dev.202607221913.60a3564 → 0.10.11-dev.202607222029.495c516

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/index.d.ts +265 -213
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -1818,27 +1818,27 @@ declare interface ChannelVerificationSessionResponse {
1818
1818
  pendingBootstrap?: boolean;
1819
1819
  }
1820
1820
 
1821
- declare interface ChoiceOption {
1822
- id: string;
1823
- title: string;
1824
- description?: string;
1825
- /** Visually highlight this option as the assistant's recommendation. */
1826
- recommended?: boolean;
1827
- /** Optional structured payload returned with this choice. */
1828
- data?: Record<string, unknown>;
1829
- }
1821
+ declare type ChoiceSurfaceData = z.infer<typeof ChoiceSurfaceDataSchema>;
1830
1822
 
1831
- declare interface ChoiceSurfaceData {
1832
- description?: string;
1833
- options: ChoiceOption[];
1834
- selectionMode?: "single" | "multiple";
1835
- /**
1836
- * When true, clicking an option submits it immediately. Defaults to true for
1837
- * single-select choice surfaces.
1838
- */
1839
- commitOnSelect?: boolean;
1840
- submitLabel?: string;
1841
- }
1823
+ declare const ChoiceSurfaceDataSchema: z.ZodObject<{
1824
+ description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
1825
+ options: z.ZodPipe<z.ZodTransform<{
1826
+ id: string;
1827
+ title: string;
1828
+ }[], unknown>, z.ZodArray<z.ZodObject<{
1829
+ id: z.ZodString;
1830
+ title: z.ZodString;
1831
+ description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
1832
+ recommended: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
1833
+ data: z.ZodCatch<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
1834
+ }, z.core.$strip>>>;
1835
+ selectionMode: z.ZodPipe<z.ZodTransform<"single" | "multiple", unknown>, z.ZodEnum<{
1836
+ single: "single";
1837
+ multiple: "multiple";
1838
+ }>>;
1839
+ commitOnSelect: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
1840
+ submitLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
1841
+ }, z.core.$strip>;
1842
1842
 
1843
1843
  declare interface ClawhubSlimSkill extends SlimSkillBase {
1844
1844
  origin: "clawhub";
@@ -2044,14 +2044,16 @@ declare interface ConfirmationStateChanged {
2044
2044
  toolUseId?: string;
2045
2045
  }
2046
2046
 
2047
- declare interface ConfirmationSurfaceData {
2048
- message: string;
2049
- detail?: string;
2050
- confirmLabel?: string;
2051
- confirmedLabel?: string;
2052
- cancelLabel?: string;
2053
- destructive?: boolean;
2054
- }
2047
+ declare type ConfirmationSurfaceData = z.infer<typeof ConfirmationSurfaceDataSchema>;
2048
+
2049
+ declare const ConfirmationSurfaceDataSchema: z.ZodObject<{
2050
+ message: z.ZodCatch<z.ZodString>;
2051
+ detail: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2052
+ confirmLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2053
+ confirmedLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2054
+ cancelLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2055
+ destructive: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
2056
+ }, z.core.$strip>;
2055
2057
 
2056
2058
  declare interface ContactChannelPayload {
2057
2059
  id: string;
@@ -2381,6 +2383,16 @@ export declare interface ConversationRow {
2381
2383
  processingStartedAt: number | null;
2382
2384
  }
2383
2385
 
2386
+ /**
2387
+ * The full `conversations-cleared` context a hook receives. Fires once when the
2388
+ * clear-all reset wipes every conversation, so unlike `conversation-deleted` it
2389
+ * carries no `conversationId` — a hook keyed on it wipes its own
2390
+ * per-conversation state wholesale. Only the pipeline-stamped
2391
+ * {@link BaseHookContext} capabilities are present, so the context is exactly
2392
+ * {@link BaseHookContext}.
2393
+ */
2394
+ export declare type ConversationsClearedContext = BaseHookContext;
2395
+
2384
2396
  declare interface ConversationsClearResponse {
2385
2397
  type: "conversations_clear_response";
2386
2398
  cleared: number;
@@ -2422,11 +2434,13 @@ declare type ConversationType = "standard" | "background" | "scheduled";
2422
2434
  /** Read-side alias of {@link ConversationCreateType}. */
2423
2435
  declare type ConversationType_2 = ConversationCreateType;
2424
2436
 
2425
- declare interface CopyBlockSurfaceData {
2426
- text: string;
2427
- label?: string;
2428
- language?: string;
2429
- }
2437
+ declare type CopyBlockSurfaceData = z.infer<typeof CopyBlockSurfaceDataSchema>;
2438
+
2439
+ declare const CopyBlockSurfaceDataSchema: z.ZodObject<{
2440
+ text: z.ZodCatch<z.ZodString>;
2441
+ label: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2442
+ language: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2443
+ }, z.core.$strip>;
2430
2444
 
2431
2445
  /** Create a live voice connection bound to the caller's `send` transport. */
2432
2446
  export declare function createLiveVoiceConnection(options: {
@@ -2620,11 +2634,13 @@ declare interface DocumentLoadResponse {
2620
2634
  error?: string;
2621
2635
  }
2622
2636
 
2623
- declare interface DocumentPreviewSurfaceData {
2624
- title: string;
2625
- surfaceId: string;
2626
- subtitle?: string;
2627
- }
2637
+ declare type DocumentPreviewSurfaceData = z.infer<typeof DocumentPreviewSurfaceDataSchema>;
2638
+
2639
+ declare const DocumentPreviewSurfaceDataSchema: z.ZodObject<{
2640
+ title: z.ZodCatch<z.ZodString>;
2641
+ surfaceId: z.ZodCatch<z.ZodString>;
2642
+ subtitle: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2643
+ }, z.core.$strip>;
2628
2644
 
2629
2645
  declare interface DocumentSaveResponse {
2630
2646
  type: "document_save_response";
@@ -2644,30 +2660,32 @@ declare type _DocumentsServerMessages = DocumentEditorShow | DocumentEditorUpdat
2644
2660
  */
2645
2661
  export declare function doesSupportVision(modelOrProfile: ModelProfileInfo | string): boolean;
2646
2662
 
2647
- declare interface DynamicPagePreview {
2648
- title: string;
2649
- subtitle?: string;
2650
- description?: string;
2651
- icon?: string;
2652
- metrics?: Array<{
2653
- label: string;
2654
- value: string;
2655
- }>;
2656
- context?: "app_create" | "general";
2657
- previewImage?: string;
2658
- }
2659
-
2660
- declare interface DynamicPageSurfaceData {
2661
- html: string;
2662
- width?: number;
2663
- height?: number;
2664
- appId?: string;
2665
- /** Filesystem directory name for this app (may differ from `appId`). */
2666
- dirName?: string;
2667
- reloadGeneration?: number;
2668
- status?: string;
2669
- preview?: DynamicPagePreview;
2670
- }
2663
+ declare type DynamicPageSurfaceData = z.infer<typeof DynamicPageSurfaceDataSchema>;
2664
+
2665
+ declare const DynamicPageSurfaceDataSchema: z.ZodObject<{
2666
+ html: z.ZodCatch<z.ZodString>;
2667
+ width: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
2668
+ height: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
2669
+ appId: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2670
+ dirName: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2671
+ reloadGeneration: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
2672
+ status: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2673
+ preview: z.ZodCatch<z.ZodOptional<z.ZodObject<{
2674
+ title: z.ZodCatch<z.ZodString>;
2675
+ subtitle: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2676
+ description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2677
+ icon: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2678
+ metrics: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
2679
+ label: z.ZodCoercedString<unknown>;
2680
+ value: z.ZodCoercedString<unknown>;
2681
+ }, z.core.$strip>>>>;
2682
+ context: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
2683
+ app_create: "app_create";
2684
+ general: "general";
2685
+ }>>>;
2686
+ previewImage: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2687
+ }, z.core.$strip>>>;
2688
+ }, z.core.$strip>;
2671
2689
 
2672
2690
  /** Embed a target and upsert its vector into the vector store. */
2673
2691
  export declare function embedAndUpsert(targetType: EmbeddingTargetType, targetId: string, input: EmbeddingInput, extraPayload?: Record<string, unknown>): Promise<void>;
@@ -2761,39 +2779,64 @@ declare interface ForkSharedAppResponse {
2761
2779
  error?: string;
2762
2780
  }
2763
2781
 
2764
- declare interface FormField {
2765
- id: string;
2766
- type: "text" | "textarea" | "select" | "toggle" | "number" | "password";
2767
- label: string;
2768
- placeholder?: string;
2769
- required?: boolean;
2770
- defaultValue?: string | number | boolean;
2771
- options?: Array<{
2772
- label: string;
2773
- value: string;
2774
- }>;
2775
- }
2776
-
2777
- declare interface FormPage {
2778
- id: string;
2779
- title: string;
2780
- description?: string;
2781
- fields: FormField[];
2782
- }
2782
+ declare type FormSurfaceData = z.infer<typeof FormSurfaceDataSchema>;
2783
2783
 
2784
- declare interface FormSurfaceData {
2785
- description?: string;
2786
- fields: FormField[];
2787
- submitLabel?: string;
2788
- pages?: FormPage[];
2789
- pageLabels?: {
2790
- next?: string;
2791
- back?: string;
2792
- submit?: string;
2793
- };
2794
- /** Progress indicator style for multi-page forms: segment bar or labeled tabs. */
2795
- progressStyle?: "bar" | "tabs";
2796
- }
2784
+ declare const FormSurfaceDataSchema: z.ZodObject<{
2785
+ description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2786
+ fields: z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
2787
+ id: z.ZodCatch<z.ZodString>;
2788
+ type: z.ZodCatch<z.ZodEnum<{
2789
+ number: "number";
2790
+ text: "text";
2791
+ select: "select";
2792
+ textarea: "textarea";
2793
+ toggle: "toggle";
2794
+ password: "password";
2795
+ }>>;
2796
+ label: z.ZodCatch<z.ZodString>;
2797
+ placeholder: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2798
+ required: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
2799
+ defaultValue: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
2800
+ options: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
2801
+ label: z.ZodCoercedString<unknown>;
2802
+ value: z.ZodCoercedString<unknown>;
2803
+ }, z.core.$strip>>>>;
2804
+ }, z.core.$strip>>>;
2805
+ submitLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2806
+ pages: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
2807
+ id: z.ZodCatch<z.ZodString>;
2808
+ title: z.ZodCatch<z.ZodString>;
2809
+ description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2810
+ fields: z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
2811
+ id: z.ZodCatch<z.ZodString>;
2812
+ type: z.ZodCatch<z.ZodEnum<{
2813
+ number: "number";
2814
+ text: "text";
2815
+ select: "select";
2816
+ textarea: "textarea";
2817
+ toggle: "toggle";
2818
+ password: "password";
2819
+ }>>;
2820
+ label: z.ZodCatch<z.ZodString>;
2821
+ placeholder: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2822
+ required: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
2823
+ defaultValue: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
2824
+ options: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
2825
+ label: z.ZodCoercedString<unknown>;
2826
+ value: z.ZodCoercedString<unknown>;
2827
+ }, z.core.$strip>>>>;
2828
+ }, z.core.$strip>>>;
2829
+ }, z.core.$strip>>>>>;
2830
+ pageLabels: z.ZodCatch<z.ZodOptional<z.ZodObject<{
2831
+ next: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2832
+ back: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2833
+ submit: z.ZodCatch<z.ZodOptional<z.ZodString>>;
2834
+ }, z.core.$strip>>>;
2835
+ progressStyle: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
2836
+ bar: "bar";
2837
+ tabs: "tabs";
2838
+ }>>>;
2839
+ }, z.core.$strip>;
2797
2840
 
2798
2841
  /** Response to a generate_avatar request indicating success or failure. */
2799
2842
  declare interface GenerateAvatarResponse {
@@ -3191,6 +3234,7 @@ declare const HookEventSchema: z.ZodObject<{
3191
3234
  * - `stop` — {@link StopContext}
3192
3235
  * - `post-model-call` — {@link PostModelCallContext}
3193
3236
  * - `conversation-deleted` — {@link ConversationDeletedContext}
3237
+ * - `conversations-cleared` — {@link ConversationsClearedContext}
3194
3238
  */
3195
3239
  export declare type HookFunction<TCtx = unknown> = (ctx: TCtx) => Promise<Partial<TCtx> | void>;
3196
3240
 
@@ -3230,6 +3274,8 @@ export declare const HOOKS: {
3230
3274
  readonly POST_COMPACT: "post-compact";
3231
3275
  /** Fires once per deleted conversation, after its rows are removed. Fire-and-forget cleanup signal — hooks run async with no ordering guarantee relative to the caller. */
3232
3276
  readonly CONVERSATION_DELETED: "conversation-deleted";
3277
+ /** Fires once when every conversation is wiped at once (the clear-all reset), after the main tables are cleared. Carries no `conversationId`; cleanup hooks wipe their own per-conversation state wholesale. */
3278
+ readonly CONVERSATIONS_CLEARED: "conversations-cleared";
3233
3279
  };
3234
3280
 
3235
3281
  /**
@@ -3746,18 +3792,22 @@ export declare function listConversations(limit?: number, conversationType?: Con
3746
3792
  */
3747
3793
  export declare function listInstalledSkills(): Promise<ResolvedSkillEntry[]>;
3748
3794
 
3749
- declare interface ListItem {
3750
- id: string;
3751
- title: string;
3752
- subtitle?: string;
3753
- icon?: string;
3754
- selected?: boolean;
3755
- }
3795
+ declare type ListSurfaceData = z.infer<typeof ListSurfaceDataSchema>;
3756
3796
 
3757
- declare interface ListSurfaceData {
3758
- items: ListItem[];
3759
- selectionMode: "single" | "multiple" | "none";
3760
- }
3797
+ declare const ListSurfaceDataSchema: z.ZodObject<{
3798
+ items: z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
3799
+ id: z.ZodCatch<z.ZodString>;
3800
+ title: z.ZodCatch<z.ZodString>;
3801
+ subtitle: z.ZodCatch<z.ZodOptional<z.ZodString>>;
3802
+ icon: z.ZodCatch<z.ZodOptional<z.ZodString>>;
3803
+ selected: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
3804
+ }, z.core.$strip>>>;
3805
+ selectionMode: z.ZodCatch<z.ZodEnum<{
3806
+ none: "none";
3807
+ single: "single";
3808
+ multiple: "multiple";
3809
+ }>>;
3810
+ }, z.core.$strip>;
3761
3811
 
3762
3812
  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"];
3763
3813
 
@@ -4405,16 +4455,14 @@ declare interface OAuthConnectResultResponse {
4405
4455
  error?: string;
4406
4456
  }
4407
4457
 
4408
- declare interface OAuthConnectSurfaceData {
4409
- /** OAuth provider key from the managed provider catalog, e.g. "google". */
4410
- providerKey: string;
4411
- /** Optional display label. The client falls back to the provider catalog. */
4412
- displayName?: string;
4413
- /** Optional helper text. The client falls back to the provider catalog. */
4414
- description?: string;
4415
- /** Optional provider logo URL. The client falls back to the provider catalog. */
4416
- logoUrl?: string | null;
4417
- }
4458
+ declare type OAuthConnectSurfaceData = z.infer<typeof OAuthConnectSurfaceDataSchema>;
4459
+
4460
+ declare const OAuthConnectSurfaceDataSchema: z.ZodObject<{
4461
+ providerKey: z.ZodCatch<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>>;
4462
+ displayName: z.ZodCatch<z.ZodOptional<z.ZodString>>;
4463
+ description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
4464
+ logoUrl: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
4465
+ }, z.core.$strip>;
4418
4466
 
4419
4467
  declare interface OpenBundleResponse {
4420
4468
  type: "open_bundle_response";
@@ -5644,32 +5692,29 @@ export declare interface ServerToolUseContent {
5644
5692
  input: Record<string, unknown>;
5645
5693
  }
5646
5694
 
5647
- /** Broadcast to connected clients when a service group update has completed. */
5648
- declare interface ServiceGroupUpdateComplete {
5649
- type: "service_group_update_complete";
5650
- /** The version that was installed (may differ from target if rolled back). */
5651
- installedVersion: string;
5652
- /** Whether the update succeeded or rolled back. */
5653
- success: boolean;
5654
- /** If rolled back, the version reverted to. */
5655
- rolledBackToVersion?: string;
5656
- }
5695
+ declare type ServiceGroupUpdateCompleteEvent = z.infer<typeof ServiceGroupUpdateCompleteEventSchema>;
5657
5696
 
5658
- /** Broadcast to connected clients with a progress update during an upgrade or rollback. */
5659
- declare interface ServiceGroupUpdateProgress {
5660
- type: "service_group_update_progress";
5661
- /** A short, user-friendly status message describing what's happening right now. */
5662
- statusMessage: string;
5663
- }
5697
+ declare const ServiceGroupUpdateCompleteEventSchema: z.ZodObject<{
5698
+ type: z.ZodLiteral<"service_group_update_complete">;
5699
+ installedVersion: z.ZodString;
5700
+ success: z.ZodBoolean;
5701
+ rolledBackToVersion: z.ZodOptional<z.ZodString>;
5702
+ }, z.core.$strip>;
5664
5703
 
5665
- /** Broadcast to connected clients when a service group update is about to begin. */
5666
- declare interface ServiceGroupUpdateStarting {
5667
- type: "service_group_update_starting";
5668
- /** The version being upgraded to. */
5669
- targetVersion: string;
5670
- /** Estimated seconds of downtime. */
5671
- expectedDowntimeSeconds: number;
5672
- }
5704
+ declare type ServiceGroupUpdateProgressEvent = z.infer<typeof ServiceGroupUpdateProgressEventSchema>;
5705
+
5706
+ declare const ServiceGroupUpdateProgressEventSchema: z.ZodObject<{
5707
+ type: z.ZodLiteral<"service_group_update_progress">;
5708
+ statusMessage: z.ZodString;
5709
+ }, z.core.$strip>;
5710
+
5711
+ declare type ServiceGroupUpdateStartingEvent = z.infer<typeof ServiceGroupUpdateStartingEventSchema>;
5712
+
5713
+ declare const ServiceGroupUpdateStartingEventSchema: z.ZodObject<{
5714
+ type: z.ZodLiteral<"service_group_update_starting">;
5715
+ targetVersion: z.ZodString;
5716
+ expectedDowntimeSeconds: z.ZodNumber;
5717
+ }, z.core.$strip>;
5673
5718
 
5674
5719
  declare type _SettingsServerMessages = ClientSettingsUpdate | AvatarUpdatedEvent | ConfigChanged | SoundsConfigUpdated | GenerateAvatarResponse;
5675
5720
 
@@ -6277,31 +6322,31 @@ export declare interface SynthesizeTextOptions {
6277
6322
  signal?: AbortSignal;
6278
6323
  }
6279
6324
 
6280
- declare interface TableCellValue {
6281
- text: string;
6282
- icon?: string;
6283
- iconColor?: string;
6284
- }
6285
-
6286
- declare interface TableColumn {
6287
- id: string;
6288
- label: string;
6289
- width?: number;
6290
- }
6291
-
6292
- declare interface TableRow {
6293
- id: string;
6294
- cells: Record<string, string | TableCellValue>;
6295
- selectable?: boolean;
6296
- selected?: boolean;
6297
- }
6325
+ declare type TableSurfaceData = z.infer<typeof TableSurfaceDataSchema>;
6298
6326
 
6299
- declare interface TableSurfaceData {
6300
- columns: TableColumn[];
6301
- rows: TableRow[];
6302
- selectionMode?: "none" | "single" | "multiple";
6303
- caption?: string;
6304
- }
6327
+ declare const TableSurfaceDataSchema: z.ZodObject<{
6328
+ columns: z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
6329
+ id: z.ZodCatch<z.ZodString>;
6330
+ label: z.ZodCatch<z.ZodString>;
6331
+ width: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
6332
+ }, z.core.$strip>>>;
6333
+ rows: z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
6334
+ id: z.ZodCatch<z.ZodString>;
6335
+ cells: z.ZodCatch<z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
6336
+ text: z.ZodCatch<z.ZodCoercedString<unknown>>;
6337
+ icon: z.ZodCatch<z.ZodOptional<z.ZodString>>;
6338
+ iconColor: z.ZodCatch<z.ZodOptional<z.ZodString>>;
6339
+ }, z.core.$strip>]>>>>;
6340
+ selectable: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
6341
+ selected: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
6342
+ }, z.core.$strip>>>;
6343
+ selectionMode: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
6344
+ none: "none";
6345
+ single: "single";
6346
+ multiple: "multiple";
6347
+ }>>>;
6348
+ caption: z.ZodCatch<z.ZodOptional<z.ZodString>>;
6349
+ }, z.core.$strip>;
6305
6350
 
6306
6351
  declare interface TelegramConfigResponse {
6307
6352
  type: "telegram_config_response";
@@ -7119,7 +7164,7 @@ declare interface UnpublishPageResponse {
7119
7164
  /** Merge the given keys into a message's metadata JSON. */
7120
7165
  export declare function updateMessageMetadata(messageId: string, updates: Record<string, unknown>): Promise<void>;
7121
7166
 
7122
- declare type _UpgradesServerMessages = ServiceGroupUpdateStarting | ServiceGroupUpdateProgress | ServiceGroupUpdateComplete;
7167
+ declare type _UpgradesServerMessages = ServiceGroupUpdateStartingEvent | ServiceGroupUpdateProgressEvent | ServiceGroupUpdateCompleteEvent;
7123
7168
 
7124
7169
  declare type UsageAttributionProfileSource = "call_site" | "conversation" | "active" | "default" | "unknown";
7125
7170
 
@@ -7459,56 +7504,63 @@ declare const WorkflowStartedEventSchema: z.ZodObject<{
7459
7504
  label: z.ZodOptional<z.ZodString>;
7460
7505
  }, z.core.$strict>;
7461
7506
 
7462
- declare interface WorkResultDiff {
7463
- label?: string;
7464
- before?: string;
7465
- after?: string;
7466
- }
7467
-
7468
- declare interface WorkResultItem {
7469
- id?: string;
7470
- title: string;
7471
- description?: string;
7472
- status?: string;
7473
- tone?: WorkResultTone;
7474
- metadata?: WorkResultMetadata[];
7475
- href?: string;
7476
- }
7477
-
7478
- declare interface WorkResultMetadata {
7479
- label: string;
7480
- value: string | number;
7481
- }
7482
-
7483
- declare interface WorkResultMetric {
7484
- label: string;
7485
- value: string | number;
7486
- detail?: string;
7487
- tone?: WorkResultTone;
7488
- }
7507
+ declare type WorkResultSurfaceData = z.infer<typeof WorkResultSurfaceDataSchema>;
7489
7508
 
7490
- declare interface WorkResultSection {
7491
- id?: string;
7492
- title: string;
7493
- description?: string;
7494
- type?: WorkResultSectionType;
7495
- items?: WorkResultItem[];
7496
- diffs?: WorkResultDiff[];
7497
- }
7498
-
7499
- declare type WorkResultSectionType = "items" | "timeline" | "diff" | "artifacts" | "warnings";
7500
-
7501
- declare type WorkResultStatus = "completed" | "partial" | "failed" | "in_progress";
7502
-
7503
- declare interface WorkResultSurfaceData {
7504
- eyebrow?: string;
7505
- status?: WorkResultStatus;
7506
- summary?: string;
7507
- metrics?: WorkResultMetric[];
7508
- sections?: WorkResultSection[];
7509
- }
7510
-
7511
- declare type WorkResultTone = "neutral" | "positive" | "warning" | "negative";
7509
+ declare const WorkResultSurfaceDataSchema: z.ZodObject<{
7510
+ eyebrow: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7511
+ status: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
7512
+ failed: "failed";
7513
+ partial: "partial";
7514
+ in_progress: "in_progress";
7515
+ completed: "completed";
7516
+ }>>>;
7517
+ summary: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7518
+ metrics: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
7519
+ detail: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7520
+ tone: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
7521
+ neutral: "neutral";
7522
+ positive: "positive";
7523
+ warning: "warning";
7524
+ negative: "negative";
7525
+ }>>>;
7526
+ label: z.ZodCatch<z.ZodCoercedString<unknown>>;
7527
+ value: z.ZodCatch<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
7528
+ }, z.core.$strip>>>>>;
7529
+ sections: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
7530
+ id: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7531
+ title: z.ZodCatch<z.ZodCoercedString<unknown>>;
7532
+ description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7533
+ type: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
7534
+ diff: "diff";
7535
+ items: "items";
7536
+ timeline: "timeline";
7537
+ artifacts: "artifacts";
7538
+ warnings: "warnings";
7539
+ }>>>;
7540
+ items: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
7541
+ id: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7542
+ title: z.ZodCatch<z.ZodCoercedString<unknown>>;
7543
+ description: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7544
+ status: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7545
+ tone: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
7546
+ neutral: "neutral";
7547
+ positive: "positive";
7548
+ warning: "warning";
7549
+ negative: "negative";
7550
+ }>>>;
7551
+ metadata: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
7552
+ label: z.ZodCatch<z.ZodCoercedString<unknown>>;
7553
+ value: z.ZodCatch<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
7554
+ }, z.core.$strip>>>>>;
7555
+ href: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7556
+ }, z.core.$strip>>>>>;
7557
+ diffs: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
7558
+ label: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7559
+ before: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7560
+ after: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7561
+ }, z.core.$strip>>>>>;
7562
+ }, z.core.$strip>>>>>;
7563
+ }, z.core.$strip>;
7512
7564
 
7513
7565
  declare interface WorkspaceFileReadResponse {
7514
7566
  type: "workspace_file_read_response";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vellumai/plugin-api",
3
- "version": "0.10.11-dev.202607221913.60a3564",
3
+ "version": "0.10.11-dev.202607222029.495c516",
4
4
  "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
5
5
  "license": "MIT",
6
6
  "type": "module",