@vellumai/plugin-api 0.10.11-dev.202607231934.db954e6 → 0.10.11-dev.202607232029.2295f95

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 +268 -380
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -671,6 +671,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
671
671
  timeThresholdMs: z.ZodDefault<z.ZodNumber>;
672
672
  messageThreshold: z.ZodDefault<z.ZodNumber>;
673
673
  minCooldownMs: z.ZodDefault<z.ZodNumber>;
674
+ sweepIntervalMs: z.ZodDefault<z.ZodNumber>;
674
675
  keepSupersededRuns: z.ZodDefault<z.ZodBoolean>;
675
676
  matchConversationProfile: z.ZodDefault<z.ZodBoolean>;
676
677
  promptPath: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -1486,11 +1487,13 @@ export declare interface AssistantEventSubscription {
1486
1487
  readonly connectionId: string;
1487
1488
  }
1488
1489
 
1489
- declare interface AssistantStatusMessage {
1490
- type: "assistant_status";
1491
- version?: string;
1492
- keyFingerprint?: string;
1493
- }
1490
+ declare type AssistantStatusEvent = z.infer<typeof AssistantStatusEventSchema>;
1491
+
1492
+ declare const AssistantStatusEventSchema: z.ZodObject<{
1493
+ type: z.ZodLiteral<"assistant_status">;
1494
+ version: z.ZodOptional<z.ZodString>;
1495
+ keyFingerprint: z.ZodOptional<z.ZodString>;
1496
+ }, z.core.$strip>;
1494
1497
 
1495
1498
  declare type AssistantTextDeltaEvent = z.infer<typeof AssistantTextDeltaEventSchema>;
1496
1499
 
@@ -1525,12 +1528,6 @@ declare interface AudioEmbeddingInput {
1525
1528
  mimeType: string;
1526
1529
  }
1527
1530
 
1528
- declare interface AuthResult {
1529
- type: "auth_result";
1530
- success: boolean;
1531
- message?: string;
1532
- }
1533
-
1534
1531
  declare type AvatarUpdatedEvent = z.infer<typeof AvatarUpdatedEventSchema>;
1535
1532
 
1536
1533
  declare const AvatarUpdatedEventSchema: z.ZodObject<{
@@ -2007,25 +2004,30 @@ declare const ConfirmationRequestEventSchema: z.ZodObject<{
2007
2004
  }, z.core.$strip>>>;
2008
2005
  }, z.core.$strip>;
2009
2006
 
2010
- /**
2011
- * Authoritative per-request confirmation state transition emitted by the daemon.
2012
- *
2013
- * The client must use this event (not local phrase inference) to update
2014
- * confirmation bubble state.
2015
- */
2016
- declare interface ConfirmationStateChanged {
2017
- type: "confirmation_state_changed";
2018
- conversationId: string;
2019
- requestId: string;
2020
- state: "pending" | "approved" | "denied" | "timed_out" | "resolved_stale";
2021
- source: "button" | "inline_nl" | "auto_deny" | "timeout" | "system";
2022
- /** requestId of the user message that triggered this transition. */
2023
- causedByRequestId?: string;
2024
- /** Normalized user text for analytics/debug (e.g. "approve", "deny"). */
2025
- decisionText?: string;
2026
- /** The tool_use block ID this confirmation applies to, for disambiguating parallel tool calls. */
2027
- toolUseId?: string;
2028
- }
2007
+ declare type ConfirmationStateChangedEvent = z.infer<typeof ConfirmationStateChangedEventSchema>;
2008
+
2009
+ declare const ConfirmationStateChangedEventSchema: z.ZodObject<{
2010
+ type: z.ZodLiteral<"confirmation_state_changed">;
2011
+ conversationId: z.ZodString;
2012
+ requestId: z.ZodString;
2013
+ state: z.ZodEnum<{
2014
+ timed_out: "timed_out";
2015
+ pending: "pending";
2016
+ approved: "approved";
2017
+ denied: "denied";
2018
+ resolved_stale: "resolved_stale";
2019
+ }>;
2020
+ source: z.ZodEnum<{
2021
+ button: "button";
2022
+ inline_nl: "inline_nl";
2023
+ auto_deny: "auto_deny";
2024
+ timeout: "timeout";
2025
+ system: "system";
2026
+ }>;
2027
+ causedByRequestId: z.ZodOptional<z.ZodString>;
2028
+ decisionText: z.ZodOptional<z.ZodString>;
2029
+ toolUseId: z.ZodOptional<z.ZodString>;
2030
+ }, z.core.$strip>;
2029
2031
 
2030
2032
  declare type ConfirmationSurfaceData = z.infer<typeof ConfirmationSurfaceDataSchema>;
2031
2033
 
@@ -2060,42 +2062,24 @@ declare type _ContactsServerMessages = ContactsChangedEvent | ContactRequestEven
2060
2062
 
2061
2063
  export declare type ContentBlock = TextContent | ThinkingContent | RedactedThinkingContent | ImageContent | FileContent | ToolUseContent | ToolResultContent | ServerToolUseContent | WebSearchToolResultContent;
2062
2064
 
2063
- /**
2064
- * Emitted after a compaction turn completes (both auto-compaction and
2065
- * `/compact`). Carries the fresh `estimatedInputTokens` so clients can refresh
2066
- * the context-window indicator without waiting for the next `usage_update`.
2067
- *
2068
- * Scoped per-conversation — see `CompactionCircuitOpenEvent` doc for why.
2069
- */
2070
- declare interface ContextCompacted {
2071
- type: "context_compacted";
2072
- conversationId: string;
2073
- previousEstimatedInputTokens: number;
2074
- estimatedInputTokens: number;
2075
- maxInputTokens: number;
2076
- thresholdTokens: number;
2077
- compactedMessages: number;
2078
- summaryCalls: number;
2079
- summaryInputTokens: number;
2080
- summaryOutputTokens: number;
2081
- summaryModel: string;
2082
- /**
2083
- * Quality signals for the generated summary. Emitted for every
2084
- * compaction (including truncation-only paths where the summary text
2085
- * is unchanged from the prior pass). Consumers can use these to detect
2086
- * regressions without needing to read the summary text itself.
2087
- *
2088
- * - `summaryCharCount`: length of the produced summary text.
2089
- * - `summaryHeaderCount`: number of `## ` section headers in the summary.
2090
- * - `summaryHadMemoryEcho`: `true` if the summary contains any runtime
2091
- * injection tag (e.g. `<memory`, `<turn_context>`, `<workspace>`). The
2092
- * durable summary should be clean prose, so `true` flags an echoed or
2093
- * invented tag worth investigating.
2094
- */
2095
- summaryCharCount?: number;
2096
- summaryHeaderCount?: number;
2097
- summaryHadMemoryEcho?: boolean;
2098
- }
2065
+ declare type ContextCompactedEvent = z.infer<typeof ContextCompactedEventSchema>;
2066
+
2067
+ declare const ContextCompactedEventSchema: z.ZodObject<{
2068
+ type: z.ZodLiteral<"context_compacted">;
2069
+ conversationId: z.ZodString;
2070
+ previousEstimatedInputTokens: z.ZodNumber;
2071
+ estimatedInputTokens: z.ZodNumber;
2072
+ maxInputTokens: z.ZodNumber;
2073
+ thresholdTokens: z.ZodNumber;
2074
+ compactedMessages: z.ZodNumber;
2075
+ summaryCalls: z.ZodNumber;
2076
+ summaryInputTokens: z.ZodNumber;
2077
+ summaryOutputTokens: z.ZodNumber;
2078
+ summaryModel: z.ZodString;
2079
+ summaryCharCount: z.ZodOptional<z.ZodNumber>;
2080
+ summaryHeaderCount: z.ZodOptional<z.ZodNumber>;
2081
+ summaryHadMemoryEcho: z.ZodOptional<z.ZodBoolean>;
2082
+ }, z.core.$strip>;
2099
2083
 
2100
2084
  /** How a conversation was created / its execution mode. */
2101
2085
  declare type ConversationCreateType = "standard" | "background" | "scheduled";
@@ -2167,19 +2151,15 @@ declare interface ConversationForkParent {
2167
2151
  title: string;
2168
2152
  }
2169
2153
 
2170
- /**
2171
- * Broadcast to clients when a conversation's inference-profile override
2172
- * changes. `profile` is the profile name (a key in `llm.profiles`) or
2173
- * `null` when the override is cleared and the conversation falls back to
2174
- * the workspace `llm.activeProfile` resolution.
2175
- */
2176
- declare interface ConversationInferenceProfileUpdated {
2177
- type: "conversation_inference_profile_updated";
2178
- conversationId: string;
2179
- profile: string | null;
2180
- sessionId?: string | null;
2181
- expiresAt?: number | null;
2182
- }
2154
+ declare type ConversationInferenceProfileUpdatedEvent = z.infer<typeof ConversationInferenceProfileUpdatedEventSchema>;
2155
+
2156
+ declare const ConversationInferenceProfileUpdatedEventSchema: z.ZodObject<{
2157
+ type: z.ZodLiteral<"conversation_inference_profile_updated">;
2158
+ conversationId: z.ZodString;
2159
+ profile: z.ZodNullable<z.ZodString>;
2160
+ sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
2161
+ expiresAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
2162
+ }, z.core.$strip>;
2183
2163
 
2184
2164
  declare interface ConversationInfo {
2185
2165
  type: "conversation_info";
@@ -2311,33 +2291,7 @@ export declare interface ConversationRow {
2311
2291
  */
2312
2292
  export declare type ConversationsClearedContext = BaseHookContext;
2313
2293
 
2314
- declare interface ConversationsClearResponse {
2315
- type: "conversations_clear_response";
2316
- cleared: number;
2317
- }
2318
-
2319
- declare interface ConversationSearchMatchingMessage {
2320
- messageId: string;
2321
- role: string;
2322
- /** Plain-text excerpt around the match, truncated to ~200 chars. */
2323
- excerpt: string;
2324
- createdAt: number;
2325
- }
2326
-
2327
- declare interface ConversationSearchResponse {
2328
- type: "conversation_search_response";
2329
- query: string;
2330
- results: ConversationSearchResultItem[];
2331
- }
2332
-
2333
- declare interface ConversationSearchResultItem {
2334
- conversationId: string;
2335
- conversationTitle: string | null;
2336
- conversationUpdatedAt: number;
2337
- matchingMessages: ConversationSearchMatchingMessage[];
2338
- }
2339
-
2340
- declare type _ConversationsServerMessages = AuthResult | PongMessage | AssistantStatusMessage | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfo | HistoryResponse | UndoComplete | UsageUpdateEvent | UsageProgressEvent | UsageResponse | ContextCompacted | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationNoticeEvent | ConversationInfo | ConversationTitleUpdatedEvent | ConversationListResponse | ConversationsClearResponse | ConversationSearchResponse | MessageContentResponse | ConversationListInvalidatedEvent | ScheduleConversationCreated | OpenConversationEvent;
2294
+ declare type _ConversationsServerMessages = AssistantStatusEvent | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfoEvent | HistoryResponse | UndoComplete | UsageUpdateEvent | UsageProgressEvent | UsageResponse | ContextCompactedEvent | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationNoticeEvent | ConversationInfo | ConversationTitleUpdatedEvent | ConversationListResponse | ConversationListInvalidatedEvent | ScheduleConversationCreatedEvent | OpenConversationEvent;
2341
2295
 
2342
2296
  declare type ConversationTitleUpdatedEvent = z.infer<typeof ConversationTitleUpdatedEventSchema>;
2343
2297
 
@@ -3085,117 +3039,84 @@ export declare const HOOKS: {
3085
3039
  */
3086
3040
  declare const HOST_PROXY_CAPABILITIES: readonly ["host_bash", "host_file", "host_cu", "host_browser", "host_app_control", "host_ui_snapshot"];
3087
3041
 
3088
- declare interface HostAppControlCancel {
3089
- type: "host_app_control_cancel";
3090
- requestId: string;
3091
- conversationId: string;
3092
- }
3093
-
3094
- declare interface HostAppControlClickInput {
3095
- tool: "click";
3096
- app: string;
3097
- x: number;
3098
- y: number;
3099
- button?: "left" | "right" | "middle";
3100
- double?: boolean;
3101
- }
3102
-
3103
- declare interface HostAppControlComboInput {
3104
- tool: "combo";
3105
- app: string;
3106
- /** Sequence of keys pressed simultaneously, e.g. ["cmd", "shift", "4"]. */
3107
- keys: string[];
3108
- /** Hold duration in milliseconds. */
3109
- duration_ms?: number;
3110
- }
3111
-
3112
- declare interface HostAppControlDragInput {
3113
- tool: "drag";
3114
- app: string;
3115
- from_x: number;
3116
- from_y: number;
3117
- to_x: number;
3118
- to_y: number;
3119
- button?: "left" | "right" | "middle";
3120
- }
3121
-
3122
- /** Inputs accepted by the nine app-control tool variants. */
3123
- declare type HostAppControlInput = HostAppControlStartInput | HostAppControlObserveInput | HostAppControlPressInput | HostAppControlComboInput | HostAppControlSequenceInput | HostAppControlTypeInput | HostAppControlClickInput | HostAppControlDragInput | HostAppControlStopInput;
3124
-
3125
- declare interface HostAppControlObserveInput {
3126
- tool: "observe";
3127
- app: string;
3128
- /**
3129
- * Milliseconds to wait between receiving the request and capturing the
3130
- * window. Lets the target app process pending input and the WindowServer
3131
- * composite a fresh frame. When omitted, the client uses its default
3132
- * (~200ms, sized for emulator-class apps at 60fps). Pass `0` for static
3133
- * UIs to make `observe` snappier; raise it for slow-feedback apps.
3134
- */
3135
- settle_ms?: number;
3136
- }
3137
-
3138
- declare interface HostAppControlPressInput {
3139
- tool: "press";
3140
- app: string;
3141
- /** Single key identifier, e.g. "return", "a", "f12". */
3142
- key: string;
3143
- /** Modifier list, e.g. ["cmd", "shift"]. */
3144
- modifiers?: string[];
3145
- /** Hold duration in milliseconds. */
3146
- duration_ms?: number;
3147
- }
3042
+ declare type HostAppControlCancelEvent = z.infer<typeof HostAppControlCancelEventSchema>;
3148
3043
 
3149
- declare interface HostAppControlRequest {
3150
- type: "host_app_control_request";
3151
- requestId: string;
3152
- conversationId: string;
3153
- toolName: string;
3154
- input: HostAppControlInput;
3155
- }
3156
-
3157
- declare interface HostAppControlSequenceInput {
3158
- tool: "sequence";
3159
- app: string;
3160
- /** Ordered list of single-key presses to execute serially. */
3161
- steps: HostAppControlSequenceStep[];
3162
- }
3163
-
3164
- /** A single step inside a sequence: one key press with optional modifiers, hold duration, and post-press gap. */
3165
- declare interface HostAppControlSequenceStep {
3166
- /** Single key identifier, e.g. "right", "a", "return". */
3167
- key: string;
3168
- /** Modifier list, e.g. ["cmd", "shift"]. Omit for no modifiers. */
3169
- modifiers?: string[];
3170
- /** Hold duration for this key in milliseconds. */
3171
- duration_ms?: number;
3172
- /** Pause after this step before starting the next, in milliseconds. */
3173
- gap_ms?: number;
3174
- }
3175
-
3176
- declare type _HostAppControlServerMessages = HostAppControlRequest | HostAppControlCancel;
3044
+ declare const HostAppControlCancelEventSchema: z.ZodObject<{
3045
+ type: z.ZodLiteral<"host_app_control_cancel">;
3046
+ requestId: z.ZodString;
3047
+ conversationId: z.ZodString;
3048
+ }, z.core.$strip>;
3177
3049
 
3178
- declare interface HostAppControlStartInput {
3179
- tool: "start";
3180
- /** Bundle ID (preferred) or process name. */
3181
- app: string;
3182
- /** Optional command-line arguments to launch the app with. */
3183
- args?: string[];
3184
- }
3050
+ declare type HostAppControlRequestEvent = z.infer<typeof HostAppControlRequestEventSchema>;
3185
3051
 
3186
- declare interface HostAppControlStopInput {
3187
- tool: "stop";
3188
- /** Optional — when omitted the proxy stops whichever app currently holds the session. */
3189
- app?: string;
3190
- /** Free-form reason, surfaced for logging. */
3191
- reason?: string;
3192
- }
3052
+ declare const HostAppControlRequestEventSchema: z.ZodObject<{
3053
+ type: z.ZodLiteral<"host_app_control_request">;
3054
+ requestId: z.ZodString;
3055
+ conversationId: z.ZodString;
3056
+ toolName: z.ZodString;
3057
+ input: z.ZodDiscriminatedUnion<[z.ZodObject<{
3058
+ tool: z.ZodLiteral<"start">;
3059
+ app: z.ZodString;
3060
+ args: z.ZodOptional<z.ZodArray<z.ZodString>>;
3061
+ }, z.core.$strip>, z.ZodObject<{
3062
+ tool: z.ZodLiteral<"observe">;
3063
+ app: z.ZodString;
3064
+ settle_ms: z.ZodOptional<z.ZodNumber>;
3065
+ }, z.core.$strip>, z.ZodObject<{
3066
+ tool: z.ZodLiteral<"press">;
3067
+ app: z.ZodString;
3068
+ key: z.ZodString;
3069
+ modifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
3070
+ duration_ms: z.ZodOptional<z.ZodNumber>;
3071
+ }, z.core.$strip>, z.ZodObject<{
3072
+ tool: z.ZodLiteral<"combo">;
3073
+ app: z.ZodString;
3074
+ keys: z.ZodArray<z.ZodString>;
3075
+ duration_ms: z.ZodOptional<z.ZodNumber>;
3076
+ }, z.core.$strip>, z.ZodObject<{
3077
+ tool: z.ZodLiteral<"sequence">;
3078
+ app: z.ZodString;
3079
+ steps: z.ZodArray<z.ZodObject<{
3080
+ key: z.ZodString;
3081
+ modifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
3082
+ duration_ms: z.ZodOptional<z.ZodNumber>;
3083
+ gap_ms: z.ZodOptional<z.ZodNumber>;
3084
+ }, z.core.$strip>>;
3085
+ }, z.core.$strip>, z.ZodObject<{
3086
+ tool: z.ZodLiteral<"type">;
3087
+ app: z.ZodString;
3088
+ text: z.ZodString;
3089
+ }, z.core.$strip>, z.ZodObject<{
3090
+ tool: z.ZodLiteral<"click">;
3091
+ app: z.ZodString;
3092
+ x: z.ZodNumber;
3093
+ y: z.ZodNumber;
3094
+ button: z.ZodOptional<z.ZodEnum<{
3095
+ left: "left";
3096
+ right: "right";
3097
+ middle: "middle";
3098
+ }>>;
3099
+ double: z.ZodOptional<z.ZodBoolean>;
3100
+ }, z.core.$strip>, z.ZodObject<{
3101
+ tool: z.ZodLiteral<"drag">;
3102
+ app: z.ZodString;
3103
+ from_x: z.ZodNumber;
3104
+ from_y: z.ZodNumber;
3105
+ to_x: z.ZodNumber;
3106
+ to_y: z.ZodNumber;
3107
+ button: z.ZodOptional<z.ZodEnum<{
3108
+ left: "left";
3109
+ right: "right";
3110
+ middle: "middle";
3111
+ }>>;
3112
+ }, z.core.$strip>, z.ZodObject<{
3113
+ tool: z.ZodLiteral<"stop">;
3114
+ app: z.ZodOptional<z.ZodString>;
3115
+ reason: z.ZodOptional<z.ZodString>;
3116
+ }, z.core.$strip>], "tool">;
3117
+ }, z.core.$strip>;
3193
3118
 
3194
- declare interface HostAppControlTypeInput {
3195
- tool: "type";
3196
- app: string;
3197
- text: string;
3198
- }
3119
+ declare type _HostAppControlServerMessages = HostAppControlRequestEvent | HostAppControlCancelEvent;
3199
3120
 
3200
3121
  declare type HostBashCancelEvent = z.infer<typeof HostBashCancelEventSchema>;
3201
3122
 
@@ -3221,26 +3142,26 @@ declare const HostBashRequestEventSchema: z.ZodObject<{
3221
3142
 
3222
3143
  declare type _HostBashServerMessages = HostBashRequestEvent | HostBashCancelEvent;
3223
3144
 
3224
- declare interface HostBrowserCancelRequest {
3225
- type: "host_browser_cancel";
3226
- requestId: string;
3227
- }
3145
+ declare type HostBrowserCancelEvent = z.infer<typeof HostBrowserCancelEventSchema>;
3228
3146
 
3229
- declare interface HostBrowserRequest {
3230
- type: "host_browser_request";
3231
- requestId: string;
3232
- conversationId: string;
3233
- /** CDP method name, e.g. "Page.navigate", "Runtime.evaluate", "Accessibility.getFullAXTree". */
3234
- cdpMethod: string;
3235
- /** Opaque JSON params object forwarded verbatim to CDP. */
3236
- cdpParams?: Record<string, unknown>;
3237
- /** Optional CDP target/session ID; omitted = "most-recently-active tab". */
3238
- cdpSessionId?: string;
3239
- /** Client-side timeout hint; defaults to 30s in the proxy. */
3240
- timeout_seconds?: number;
3241
- }
3147
+ declare const HostBrowserCancelEventSchema: z.ZodObject<{
3148
+ type: z.ZodLiteral<"host_browser_cancel">;
3149
+ requestId: z.ZodString;
3150
+ }, z.core.$strip>;
3242
3151
 
3243
- declare type _HostBrowserServerMessages = HostBrowserRequest | HostBrowserCancelRequest;
3152
+ declare type HostBrowserRequestEvent = z.infer<typeof HostBrowserRequestEventSchema>;
3153
+
3154
+ declare const HostBrowserRequestEventSchema: z.ZodObject<{
3155
+ type: z.ZodLiteral<"host_browser_request">;
3156
+ requestId: z.ZodString;
3157
+ conversationId: z.ZodString;
3158
+ cdpMethod: z.ZodString;
3159
+ cdpParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3160
+ cdpSessionId: z.ZodOptional<z.ZodString>;
3161
+ timeout_seconds: z.ZodOptional<z.ZodNumber>;
3162
+ }, z.core.$strip>;
3163
+
3164
+ declare type _HostBrowserServerMessages = HostBrowserRequestEvent | HostBrowserCancelEvent;
3244
3165
 
3245
3166
  declare type HostCuCancelEvent = z.infer<typeof HostCuCancelEventSchema>;
3246
3167
 
@@ -3266,85 +3187,83 @@ declare const HostCuRequestEventSchema: z.ZodObject<{
3266
3187
 
3267
3188
  declare type _HostCuServerMessages = HostCuRequestEvent | HostCuCancelEvent;
3268
3189
 
3269
- declare interface HostFileCancelRequest {
3270
- type: "host_file_cancel";
3271
- requestId: string;
3272
- conversationId: string;
3273
- targetClientId?: string;
3274
- }
3190
+ declare type HostFileCancelEvent = z.infer<typeof HostFileCancelEventSchema>;
3275
3191
 
3276
- declare interface HostFileEditRequest {
3277
- type: "host_file_request";
3278
- requestId: string;
3279
- conversationId: string;
3280
- targetClientId?: string;
3281
- operation: "edit";
3282
- path: string;
3283
- old_string: string;
3284
- new_string: string;
3285
- replace_all?: boolean;
3286
- }
3192
+ declare const HostFileCancelEventSchema: z.ZodObject<{
3193
+ type: z.ZodLiteral<"host_file_cancel">;
3194
+ requestId: z.ZodString;
3195
+ conversationId: z.ZodString;
3196
+ targetClientId: z.ZodOptional<z.ZodString>;
3197
+ }, z.core.$strip>;
3287
3198
 
3288
- declare interface HostFileReadRequest {
3289
- type: "host_file_request";
3290
- requestId: string;
3291
- conversationId: string;
3292
- targetClientId?: string;
3293
- operation: "read";
3294
- path: string;
3295
- offset?: number;
3296
- limit?: number;
3297
- }
3199
+ declare type HostFileRequestEvent = z.infer<typeof HostFileRequestEventSchema>;
3298
3200
 
3299
- declare type HostFileRequest = HostFileReadRequest | HostFileWriteRequest | HostFileEditRequest;
3201
+ declare const HostFileRequestEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
3202
+ type: z.ZodLiteral<"host_file_request">;
3203
+ requestId: z.ZodString;
3204
+ conversationId: z.ZodString;
3205
+ targetClientId: z.ZodOptional<z.ZodString>;
3206
+ operation: z.ZodLiteral<"read">;
3207
+ path: z.ZodString;
3208
+ offset: z.ZodOptional<z.ZodNumber>;
3209
+ limit: z.ZodOptional<z.ZodNumber>;
3210
+ }, z.core.$strip>, z.ZodObject<{
3211
+ type: z.ZodLiteral<"host_file_request">;
3212
+ requestId: z.ZodString;
3213
+ conversationId: z.ZodString;
3214
+ targetClientId: z.ZodOptional<z.ZodString>;
3215
+ operation: z.ZodLiteral<"write">;
3216
+ path: z.ZodString;
3217
+ content: z.ZodString;
3218
+ }, z.core.$strip>, z.ZodObject<{
3219
+ type: z.ZodLiteral<"host_file_request">;
3220
+ requestId: z.ZodString;
3221
+ conversationId: z.ZodString;
3222
+ targetClientId: z.ZodOptional<z.ZodString>;
3223
+ operation: z.ZodLiteral<"edit">;
3224
+ path: z.ZodString;
3225
+ old_string: z.ZodString;
3226
+ new_string: z.ZodString;
3227
+ replace_all: z.ZodOptional<z.ZodBoolean>;
3228
+ }, z.core.$strip>], "operation">;
3300
3229
 
3301
- declare type _HostFileServerMessages = HostFileRequest | HostFileCancelRequest;
3302
-
3303
- declare interface HostFileWriteRequest {
3304
- type: "host_file_request";
3305
- requestId: string;
3306
- conversationId: string;
3307
- targetClientId?: string;
3308
- operation: "write";
3309
- path: string;
3310
- content: string;
3311
- }
3230
+ declare type _HostFileServerMessages = HostFileRequestEvent | HostFileCancelEvent;
3312
3231
 
3313
3232
  declare type HostProxyCapability = (typeof HOST_PROXY_CAPABILITIES)[number];
3314
3233
 
3315
- declare interface HostTransferCancelRequest {
3316
- type: "host_transfer_cancel";
3317
- requestId: string;
3318
- conversationId: string;
3319
- targetClientId?: string;
3320
- }
3234
+ declare type HostTransferCancelEvent = z.infer<typeof HostTransferCancelEventSchema>;
3321
3235
 
3322
- declare type HostTransferRequest = HostTransferToHostRequest | HostTransferToSandboxRequest;
3236
+ declare const HostTransferCancelEventSchema: z.ZodObject<{
3237
+ type: z.ZodLiteral<"host_transfer_cancel">;
3238
+ requestId: z.ZodString;
3239
+ conversationId: z.ZodString;
3240
+ targetClientId: z.ZodOptional<z.ZodString>;
3241
+ }, z.core.$strip>;
3323
3242
 
3324
- declare type _HostTransferServerMessages = HostTransferRequest | HostTransferCancelRequest;
3243
+ declare type HostTransferRequestEvent = z.infer<typeof HostTransferRequestEventSchema>;
3325
3244
 
3326
- declare interface HostTransferToHostRequest {
3327
- type: "host_transfer_request";
3328
- requestId: string;
3329
- conversationId: string;
3330
- targetClientId?: string;
3331
- direction: "to_host";
3332
- transferId: string;
3333
- destPath: string;
3334
- sizeBytes: number;
3335
- sha256: string;
3336
- overwrite: boolean;
3337
- }
3245
+ declare const HostTransferRequestEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
3246
+ type: z.ZodLiteral<"host_transfer_request">;
3247
+ requestId: z.ZodString;
3248
+ conversationId: z.ZodString;
3249
+ targetClientId: z.ZodOptional<z.ZodString>;
3250
+ direction: z.ZodLiteral<"to_host">;
3251
+ transferId: z.ZodString;
3252
+ destPath: z.ZodString;
3253
+ sizeBytes: z.ZodNumber;
3254
+ sha256: z.ZodString;
3255
+ overwrite: z.ZodBoolean;
3256
+ }, z.core.$strip>, z.ZodObject<{
3257
+ type: z.ZodLiteral<"host_transfer_request">;
3258
+ requestId: z.ZodString;
3259
+ conversationId: z.ZodString;
3260
+ targetClientId: z.ZodOptional<z.ZodString>;
3261
+ direction: z.ZodLiteral<"to_sandbox">;
3262
+ transferId: z.ZodString;
3263
+ sourcePath: z.ZodString;
3264
+ }, z.core.$strip>], "direction">;
3338
3265
 
3339
- declare interface HostTransferToSandboxRequest {
3340
- type: "host_transfer_request";
3341
- requestId: string;
3342
- conversationId: string;
3343
- targetClientId?: string;
3344
- direction: "to_sandbox";
3345
- transferId: string;
3346
- sourcePath: string;
3347
- }
3266
+ declare type _HostTransferServerMessages = HostTransferRequestEvent | HostTransferCancelEvent;
3348
3267
 
3349
3268
  declare type HostUiSnapshotCancelEvent = z.infer<typeof HostUiSnapshotCancelEventSchema>;
3350
3269
 
@@ -3950,18 +3869,6 @@ declare const MessageCompleteEventSchema: z.ZodObject<{
3950
3869
  attachmentWarnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
3951
3870
  }, z.core.$strip>;
3952
3871
 
3953
- declare interface MessageContentResponse {
3954
- type: "message_content_response";
3955
- conversationId: string;
3956
- messageId: string;
3957
- text?: string;
3958
- toolCalls?: Array<{
3959
- name: string;
3960
- result?: string;
3961
- input?: Record<string, unknown>;
3962
- }>;
3963
- }
3964
-
3965
3872
  declare type MessageDequeuedEvent = z.infer<typeof MessageDequeuedEventSchema>;
3966
3873
 
3967
3874
  declare const MessageDequeuedEventSchema: z.ZodObject<{
@@ -4137,36 +4044,40 @@ declare interface MessageRow {
4137
4044
  finalized: number;
4138
4045
  }
4139
4046
 
4140
- declare type _MessagesServerMessages = UserMessageEchoEvent | AssistantTurnStartEvent | AssistantTextDeltaEvent | AssistantThinkingDeltaEvent | ToolUseStartEvent | ToolUsePreviewStartEvent | ToolOutputChunkEvent | ToolInputDelta | ToolResultEvent | ConfirmationRequestEvent | SecretRequestEvent | QuestionRequestEvent | MessageCompleteEvent | ErrorEvent_2 | MessageQueuedEvent | MessageDequeuedEvent | MessageRequestCompleteEvent | MessageQueuedDeletedEvent | MessageSteered | SuggestionResponse | ConfirmationStateChanged | AssistantActivityStateEvent | ConversationInferenceProfileUpdated | InteractionResolvedEvent;
4047
+ declare type _MessagesServerMessages = UserMessageEchoEvent | AssistantTurnStartEvent | AssistantTextDeltaEvent | AssistantThinkingDeltaEvent | ToolUseStartEvent | ToolUsePreviewStartEvent | ToolOutputChunkEvent | ToolInputDeltaEvent | ToolResultEvent | ConfirmationRequestEvent | SecretRequestEvent | QuestionRequestEvent | MessageCompleteEvent | ErrorEvent_2 | MessageQueuedEvent | MessageDequeuedEvent | MessageRequestCompleteEvent | MessageQueuedDeletedEvent | MessageSteeredEvent | ConfirmationStateChangedEvent | AssistantActivityStateEvent | ConversationInferenceProfileUpdatedEvent | InteractionResolvedEvent;
4141
4048
 
4142
- declare interface MessageSteered {
4143
- type: "message_steered";
4144
- conversationId: string;
4145
- requestId: string;
4146
- }
4049
+ declare type MessageSteeredEvent = z.infer<typeof MessageSteeredEventSchema>;
4147
4050
 
4148
- declare interface ModelInfo {
4149
- type: "model_info";
4150
- conversationId?: string;
4151
- model: string;
4152
- provider: string;
4153
- configuredProviders?: string[];
4154
- availableModels?: Array<{
4155
- id: string;
4156
- displayName: string;
4157
- }>;
4158
- allProviders?: Array<{
4159
- id: string;
4160
- displayName: string;
4161
- models: Array<{
4162
- id: string;
4163
- displayName: string;
4164
- }>;
4165
- defaultModel: string;
4166
- apiKeyUrl?: string;
4167
- apiKeyPlaceholder?: string;
4168
- }>;
4169
- }
4051
+ declare const MessageSteeredEventSchema: z.ZodObject<{
4052
+ type: z.ZodLiteral<"message_steered">;
4053
+ conversationId: z.ZodString;
4054
+ requestId: z.ZodString;
4055
+ }, z.core.$strip>;
4056
+
4057
+ declare type ModelInfoEvent = z.infer<typeof ModelInfoEventSchema>;
4058
+
4059
+ declare const ModelInfoEventSchema: z.ZodObject<{
4060
+ type: z.ZodLiteral<"model_info">;
4061
+ conversationId: z.ZodOptional<z.ZodString>;
4062
+ model: z.ZodString;
4063
+ provider: z.ZodString;
4064
+ configuredProviders: z.ZodOptional<z.ZodArray<z.ZodString>>;
4065
+ availableModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
4066
+ id: z.ZodString;
4067
+ displayName: z.ZodString;
4068
+ }, z.core.$strip>>>;
4069
+ allProviders: z.ZodOptional<z.ZodArray<z.ZodObject<{
4070
+ id: z.ZodString;
4071
+ displayName: z.ZodString;
4072
+ models: z.ZodArray<z.ZodObject<{
4073
+ id: z.ZodString;
4074
+ displayName: z.ZodString;
4075
+ }, z.core.$strip>>;
4076
+ defaultModel: z.ZodString;
4077
+ apiKeyUrl: z.ZodOptional<z.ZodString>;
4078
+ apiKeyPlaceholder: z.ZodOptional<z.ZodString>;
4079
+ }, z.core.$strip>>>;
4080
+ }, z.core.$strip>;
4170
4081
 
4171
4082
  /**
4172
4083
  * A workspace inference profile a plugin can route to. Returned by
@@ -4376,10 +4287,6 @@ export declare interface PluginLogger {
4376
4287
  debug(obj: Record<string, unknown>, msg?: string): void;
4377
4288
  }
4378
4289
 
4379
- declare interface PongMessage {
4380
- type: "pong";
4381
- }
4382
-
4383
4290
  /**
4384
4291
  * The full `post-compact` context a hook receives — the dispatching call
4385
4292
  * site's {@link PostCompactInputContext} plus the pipeline-stamped
@@ -5197,25 +5104,14 @@ export declare interface RunConversationTurnResult {
5197
5104
  queued?: boolean;
5198
5105
  }
5199
5106
 
5200
- /**
5201
- * Emitted when the compaction circuit breaker trips. After three consecutive
5202
- * summary-LLM failures (with local fallback covering each), auto-compaction is
5203
- * suspended until `openUntil` to avoid repeatedly hammering a broken provider.
5204
- * User-initiated compaction (`/compact`, `force: true`) bypasses the breaker.
5205
- *
5206
- * `conversationId` scopes the event so clients can ignore breaker trips from
5207
- * other conversations — `EventStreamClient` broadcasts every parsed server
5208
- * message to all subscribers, so without this field a breaker trip in one
5209
- * conversation would set the "auto-compaction paused" banner on every open
5210
- * `ChatViewModel`.
5211
- */
5212
- /** Server push — broadcast when a schedule creates a conversation. */
5213
- declare interface ScheduleConversationCreated {
5214
- type: "schedule_conversation_created";
5215
- conversationId: string;
5216
- scheduleJobId: string;
5217
- title: string;
5218
- }
5107
+ declare type ScheduleConversationCreatedEvent = z.infer<typeof ScheduleConversationCreatedEventSchema>;
5108
+
5109
+ declare const ScheduleConversationCreatedEventSchema: z.ZodObject<{
5110
+ type: z.ZodLiteral<"schedule_conversation_created">;
5111
+ conversationId: z.ZodString;
5112
+ scheduleJobId: z.ZodString;
5113
+ title: z.ZodString;
5114
+ }, z.core.$strip>;
5219
5115
 
5220
5116
  declare interface SchedulesListResponse {
5221
5117
  type: "schedules_list_response";
@@ -5918,13 +5814,6 @@ declare type SubscriberInput = DistributiveOmit<SubscriberEntry, "active" | "con
5918
5814
  onEvict?: () => void;
5919
5815
  };
5920
5816
 
5921
- declare interface SuggestionResponse {
5922
- type: "suggestion_response";
5923
- requestId: string;
5924
- suggestion: string | null;
5925
- source: "llm" | "none";
5926
- }
5927
-
5928
5817
  declare interface SurfaceAction {
5929
5818
  id: string;
5930
5819
  label: string;
@@ -6534,17 +6423,16 @@ export declare interface ToolExecutionResult {
6534
6423
  activityMetadata?: ToolActivityMetadata;
6535
6424
  }
6536
6425
 
6537
- declare interface ToolInputDelta {
6538
- type: "tool_input_delta";
6539
- toolName: string;
6540
- content: string;
6541
- conversationId?: string;
6542
- /** The tool_use block ID for client-side correlation. */
6543
- toolUseId?: string;
6544
- /** Database ID of the assistant message that owns this tool_use block.
6545
- * Same semantics as `AssistantTextDeltaEvent.messageId`. */
6546
- messageId?: string;
6547
- }
6426
+ declare type ToolInputDeltaEvent = z.infer<typeof ToolInputDeltaEventSchema>;
6427
+
6428
+ declare const ToolInputDeltaEventSchema: z.ZodObject<{
6429
+ type: z.ZodLiteral<"tool_input_delta">;
6430
+ toolName: z.ZodString;
6431
+ content: z.ZodString;
6432
+ conversationId: z.ZodOptional<z.ZodString>;
6433
+ toolUseId: z.ZodOptional<z.ZodString>;
6434
+ messageId: z.ZodOptional<z.ZodString>;
6435
+ }, z.core.$strip>;
6548
6436
 
6549
6437
  declare interface ToolInputSchema {
6550
6438
  type: "object";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vellumai/plugin-api",
3
- "version": "0.10.11-dev.202607231934.db954e6",
3
+ "version": "0.10.11-dev.202607232029.2295f95",
4
4
  "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
5
5
  "license": "MIT",
6
6
  "type": "module",