@vellumai/plugin-api 0.10.11-dev.202607231953.b64451d → 0.10.11-dev.202607232108.d026831

package/index.d.ts

@@ -1487,11 +1487,13 @@ export declare interface AssistantEventSubscription {
     readonly connectionId: string;
 }
 
-declare interface AssistantStatusMessage {
-    type: "assistant_status";
-    version?: string;
-    keyFingerprint?: string;
-}
+declare type AssistantStatusEvent = z.infer<typeof AssistantStatusEventSchema>;
+
+declare const AssistantStatusEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"assistant_status">;
+    version: z.ZodOptional<z.ZodString>;
+    keyFingerprint: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 
 declare type AssistantTextDeltaEvent = z.infer<typeof AssistantTextDeltaEventSchema>;
 
@@ -1526,12 +1528,6 @@ declare interface AudioEmbeddingInput {
     mimeType: string;
 }
 
-declare interface AuthResult {
-    type: "auth_result";
-    success: boolean;
-    message?: string;
-}
-
 declare type AvatarUpdatedEvent = z.infer<typeof AvatarUpdatedEventSchema>;
 
 declare const AvatarUpdatedEventSchema: z.ZodObject<{
@@ -2008,25 +2004,30 @@ declare const ConfirmationRequestEventSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 
-/**
- * Authoritative per-request confirmation state transition emitted by the daemon.
- *
- * The client must use this event (not local phrase inference) to update
- * confirmation bubble state.
- */
-declare interface ConfirmationStateChanged {
-    type: "confirmation_state_changed";
-    conversationId: string;
-    requestId: string;
-    state: "pending" | "approved" | "denied" | "timed_out" | "resolved_stale";
-    source: "button" | "inline_nl" | "auto_deny" | "timeout" | "system";
-    /** requestId of the user message that triggered this transition. */
-    causedByRequestId?: string;
-    /** Normalized user text for analytics/debug (e.g. "approve", "deny"). */
-    decisionText?: string;
-    /** The tool_use block ID this confirmation applies to, for disambiguating parallel tool calls. */
-    toolUseId?: string;
-}
+declare type ConfirmationStateChangedEvent = z.infer<typeof ConfirmationStateChangedEventSchema>;
+
+declare const ConfirmationStateChangedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"confirmation_state_changed">;
+    conversationId: z.ZodString;
+    requestId: z.ZodString;
+    state: z.ZodEnum<{
+        timed_out: "timed_out";
+        pending: "pending";
+        approved: "approved";
+        denied: "denied";
+        resolved_stale: "resolved_stale";
+    }>;
+    source: z.ZodEnum<{
+        button: "button";
+        inline_nl: "inline_nl";
+        auto_deny: "auto_deny";
+        timeout: "timeout";
+        system: "system";
+    }>;
+    causedByRequestId: z.ZodOptional<z.ZodString>;
+    decisionText: z.ZodOptional<z.ZodString>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 
 declare type ConfirmationSurfaceData = z.infer<typeof ConfirmationSurfaceDataSchema>;
 
@@ -2061,42 +2062,24 @@ declare type _ContactsServerMessages = ContactsChangedEvent | ContactRequestEven
 
 export declare type ContentBlock = TextContent | ThinkingContent | RedactedThinkingContent | ImageContent | FileContent | ToolUseContent | ToolResultContent | ServerToolUseContent | WebSearchToolResultContent;
 
-/**
- * Emitted after a compaction turn completes (both auto-compaction and
- * `/compact`). Carries the fresh `estimatedInputTokens` so clients can refresh
- * the context-window indicator without waiting for the next `usage_update`.
- *
- * Scoped per-conversation — see `CompactionCircuitOpenEvent` doc for why.
- */
-declare interface ContextCompacted {
-    type: "context_compacted";
-    conversationId: string;
-    previousEstimatedInputTokens: number;
-    estimatedInputTokens: number;
-    maxInputTokens: number;
-    thresholdTokens: number;
-    compactedMessages: number;
-    summaryCalls: number;
-    summaryInputTokens: number;
-    summaryOutputTokens: number;
-    summaryModel: string;
-    /**
-     * Quality signals for the generated summary. Emitted for every
-     * compaction (including truncation-only paths where the summary text
-     * is unchanged from the prior pass). Consumers can use these to detect
-     * regressions without needing to read the summary text itself.
-     *
-     * - `summaryCharCount`: length of the produced summary text.
-     * - `summaryHeaderCount`: number of `## ` section headers in the summary.
-     * - `summaryHadMemoryEcho`: `true` if the summary contains any runtime
-     *   injection tag (e.g. `<memory`, `<turn_context>`, `<workspace>`). The
-     *   durable summary should be clean prose, so `true` flags an echoed or
-     *   invented tag worth investigating.
-     */
-    summaryCharCount?: number;
-    summaryHeaderCount?: number;
-    summaryHadMemoryEcho?: boolean;
-}
+declare type ContextCompactedEvent = z.infer<typeof ContextCompactedEventSchema>;
+
+declare const ContextCompactedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"context_compacted">;
+    conversationId: z.ZodString;
+    previousEstimatedInputTokens: z.ZodNumber;
+    estimatedInputTokens: z.ZodNumber;
+    maxInputTokens: z.ZodNumber;
+    thresholdTokens: z.ZodNumber;
+    compactedMessages: z.ZodNumber;
+    summaryCalls: z.ZodNumber;
+    summaryInputTokens: z.ZodNumber;
+    summaryOutputTokens: z.ZodNumber;
+    summaryModel: z.ZodString;
+    summaryCharCount: z.ZodOptional<z.ZodNumber>;
+    summaryHeaderCount: z.ZodOptional<z.ZodNumber>;
+    summaryHadMemoryEcho: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
 
 /** How a conversation was created / its execution mode. */
 declare type ConversationCreateType = "standard" | "background" | "scheduled";
@@ -2168,19 +2151,15 @@ declare interface ConversationForkParent {
     title: string;
 }
 
-/**
- * Broadcast to clients when a conversation's inference-profile override
- * changes. `profile` is the profile name (a key in `llm.profiles`) or
- * `null` when the override is cleared and the conversation falls back to
- * the workspace `llm.activeProfile` resolution.
- */
-declare interface ConversationInferenceProfileUpdated {
-    type: "conversation_inference_profile_updated";
-    conversationId: string;
-    profile: string | null;
-    sessionId?: string | null;
-    expiresAt?: number | null;
-}
+declare type ConversationInferenceProfileUpdatedEvent = z.infer<typeof ConversationInferenceProfileUpdatedEventSchema>;
+
+declare const ConversationInferenceProfileUpdatedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation_inference_profile_updated">;
+    conversationId: z.ZodString;
+    profile: z.ZodNullable<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
 
 declare interface ConversationInfo {
     type: "conversation_info";
@@ -2312,33 +2291,7 @@ export declare interface ConversationRow {
  */
 export declare type ConversationsClearedContext = BaseHookContext;
 
-declare interface ConversationsClearResponse {
-    type: "conversations_clear_response";
-    cleared: number;
-}
-
-declare interface ConversationSearchMatchingMessage {
-    messageId: string;
-    role: string;
-    /** Plain-text excerpt around the match, truncated to ~200 chars. */
-    excerpt: string;
-    createdAt: number;
-}
-
-declare interface ConversationSearchResponse {
-    type: "conversation_search_response";
-    query: string;
-    results: ConversationSearchResultItem[];
-}
-
-declare interface ConversationSearchResultItem {
-    conversationId: string;
-    conversationTitle: string | null;
-    conversationUpdatedAt: number;
-    matchingMessages: ConversationSearchMatchingMessage[];
-}
-
-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;
+declare type _ConversationsServerMessages = AssistantStatusEvent | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfoEvent | HistoryResponse | UndoComplete | UsageUpdateEvent | UsageProgressEvent | UsageResponse | ContextCompactedEvent | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationNoticeEvent | ConversationInfo | ConversationTitleUpdatedEvent | ConversationListResponse | ConversationListInvalidatedEvent | ScheduleConversationCreatedEvent | OpenConversationEvent;
 
 declare type ConversationTitleUpdatedEvent = z.infer<typeof ConversationTitleUpdatedEventSchema>;
 
@@ -2623,25 +2576,6 @@ declare const FileUploadSurfaceDataSchema: z.ZodObject<{
     maxSizeBytes: z.ZodCatch<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
 }, z.core.$strip>;
 
-declare interface FilingConfigResponse {
-    type: "filing_config_response";
-    enabled: boolean;
-    intervalMs: number;
-    activeHoursStart: number | null;
-    activeHoursEnd: number | null;
-    nextRunAt: number | null;
-    lastRunAt: number | null;
-    success: boolean;
-    error?: string;
-}
-
-declare interface FilingRunNowResponse {
-    type: "filing_run_now_response";
-    success: boolean;
-    ran: boolean;
-    error?: string;
-}
-
 declare interface ForkSharedAppResponse {
     type: "fork_shared_app_response";
     success: boolean;
@@ -2818,64 +2752,21 @@ declare interface GraphNodeSweepResult {
 /** Whether the text tokenizes to at least one lexical search token. */
 export declare function hasLexicalTokens(text: string): Promise<boolean>;
 
-declare interface HeartbeatAlert {
-    type: "heartbeat_alert";
-    title: string;
-    body: string;
-}
-
-declare interface HeartbeatChecklistResponse {
-    type: "heartbeat_checklist_response";
-    content: string;
-    isDefault: boolean;
-}
-
-declare interface HeartbeatChecklistWriteResponse {
-    type: "heartbeat_checklist_write_response";
-    success: boolean;
-    error?: string;
-}
-
-declare interface HeartbeatConfigResponse {
-    type: "heartbeat_config_response";
-    enabled: boolean;
-    intervalMs: number;
-    activeHoursStart: number | null;
-    activeHoursEnd: number | null;
-    nextRunAt: number | null;
-    lastRunAt: number | null;
-    success: boolean;
-    error?: string;
-}
+declare type HeartbeatAlertEvent = z.infer<typeof HeartbeatAlertEventSchema>;
 
-/** Server push — broadcast when a heartbeat creates a conversation. */
-declare interface HeartbeatConversationCreated {
-    type: "heartbeat_conversation_created";
-    conversationId: string;
-    title: string;
-}
+declare const HeartbeatAlertEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat_alert">;
+    title: z.ZodString;
+    body: z.ZodString;
+}, z.core.$strip>;
 
-declare interface HeartbeatRunNowResponse {
-    type: "heartbeat_run_now_response";
-    success: boolean;
-    error?: string;
-}
+declare type HeartbeatConversationCreatedEvent = z.infer<typeof HeartbeatConversationCreatedEventSchema>;
 
-declare interface HeartbeatRunsListResponse {
-    type: "heartbeat_runs_list_response";
-    runs: Array<{
-        id: string;
-        scheduledFor: number;
-        startedAt: number | null;
-        finishedAt: number | null;
-        durationMs: number | null;
-        status: string;
-        skipReason: string | null;
-        error: string | null;
-        conversationId: string | null;
-        createdAt: number;
-    }>;
-}
+declare const HeartbeatConversationCreatedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat_conversation_created">;
+    conversationId: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
 
 declare interface HistoryResponse {
     type: "history_response";
@@ -3916,18 +3807,6 @@ declare const MessageCompleteEventSchema: z.ZodObject<{
     attachmentWarnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 
-declare interface MessageContentResponse {
-    type: "message_content_response";
-    conversationId: string;
-    messageId: string;
-    text?: string;
-    toolCalls?: Array<{
-        name: string;
-        result?: string;
-        input?: Record<string, unknown>;
-    }>;
-}
-
 declare type MessageDequeuedEvent = z.infer<typeof MessageDequeuedEventSchema>;
 
 declare const MessageDequeuedEventSchema: z.ZodObject<{
@@ -4103,36 +3982,40 @@ declare interface MessageRow {
     finalized: number;
 }
 
-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;
+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;
 
-declare interface MessageSteered {
-    type: "message_steered";
-    conversationId: string;
-    requestId: string;
-}
+declare type MessageSteeredEvent = z.infer<typeof MessageSteeredEventSchema>;
 
-declare interface ModelInfo {
-    type: "model_info";
-    conversationId?: string;
-    model: string;
-    provider: string;
-    configuredProviders?: string[];
-    availableModels?: Array<{
-        id: string;
-        displayName: string;
-    }>;
-    allProviders?: Array<{
-        id: string;
-        displayName: string;
-        models: Array<{
-            id: string;
-            displayName: string;
-        }>;
-        defaultModel: string;
-        apiKeyUrl?: string;
-        apiKeyPlaceholder?: string;
-    }>;
-}
+declare const MessageSteeredEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"message_steered">;
+    conversationId: z.ZodString;
+    requestId: z.ZodString;
+}, z.core.$strip>;
+
+declare type ModelInfoEvent = z.infer<typeof ModelInfoEventSchema>;
+
+declare const ModelInfoEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"model_info">;
+    conversationId: z.ZodOptional<z.ZodString>;
+    model: z.ZodString;
+    provider: z.ZodString;
+    configuredProviders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    availableModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+    }, z.core.$strip>>>;
+    allProviders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        models: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            displayName: z.ZodString;
+        }, z.core.$strip>>;
+        defaultModel: z.ZodString;
+        apiKeyUrl: z.ZodOptional<z.ZodString>;
+        apiKeyPlaceholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 
 /**
  * A workspace inference profile a plugin can route to. Returned by
@@ -4342,10 +4225,6 @@ export declare interface PluginLogger {
     debug(obj: Record<string, unknown>, msg?: string): void;
 }
 
-declare interface PongMessage {
-    type: "pong";
-}
-
 /**
  * The full `post-compact` context a hook receives — the dispatching call
  * site's {@link PostCompactInputContext} plus the pipeline-stamped
@@ -5163,52 +5042,16 @@ export declare interface RunConversationTurnResult {
     queued?: boolean;
 }
 
-/**
- * Emitted when the compaction circuit breaker trips. After three consecutive
- * summary-LLM failures (with local fallback covering each), auto-compaction is
- * suspended until `openUntil` to avoid repeatedly hammering a broken provider.
- * User-initiated compaction (`/compact`, `force: true`) bypasses the breaker.
- *
- * `conversationId` scopes the event so clients can ignore breaker trips from
- * other conversations — `EventStreamClient` broadcasts every parsed server
- * message to all subscribers, so without this field a breaker trip in one
- * conversation would set the "auto-compaction paused" banner on every open
- * `ChatViewModel`.
- */
-/** Server push — broadcast when a schedule creates a conversation. */
-declare interface ScheduleConversationCreated {
-    type: "schedule_conversation_created";
-    conversationId: string;
-    scheduleJobId: string;
-    title: string;
-}
+declare type ScheduleConversationCreatedEvent = z.infer<typeof ScheduleConversationCreatedEventSchema>;
 
-declare interface SchedulesListResponse {
-    type: "schedules_list_response";
-    schedules: Array<{
-        id: string;
-        name: string;
-        enabled: boolean;
-        syntax: string;
-        expression: string | null;
-        cronExpression: string | null;
-        timezone: string | null;
-        message: string;
-        nextRunAt: number;
-        lastRunAt: number | null;
-        lastStatus: string | null;
-        description: string;
-        cadenceDescription: string;
-        mode: string;
-        status: string;
-        routingIntent: string;
-        reuseConversation: boolean;
-        wakeConversationId: string | null;
-        isOneShot: boolean;
-    }>;
-}
+declare const ScheduleConversationCreatedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"schedule_conversation_created">;
+    conversationId: z.ZodString;
+    scheduleJobId: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
 
-declare type _SchedulesServerMessages = SchedulesListResponse | HeartbeatAlert | HeartbeatConversationCreated | HeartbeatConfigResponse | HeartbeatRunsListResponse | HeartbeatRunNowResponse | HeartbeatChecklistResponse | HeartbeatChecklistWriteResponse | FilingConfigResponse | FilingRunNowResponse;
+declare type _SchedulesServerMessages = HeartbeatAlertEvent | HeartbeatConversationCreatedEvent;
 
 /** Sparse lexical search over stored message text; ranked message-id hits. */
 export declare function searchMessageIdsLexical(query: string, limit: number, opts?: {
@@ -5884,13 +5727,6 @@ declare type SubscriberInput = DistributiveOmit<SubscriberEntry, "active" | "con
     onEvict?: () => void;
 };
 
-declare interface SuggestionResponse {
-    type: "suggestion_response";
-    requestId: string;
-    suggestion: string | null;
-    source: "llm" | "none";
-}
-
 declare interface SurfaceAction {
     id: string;
     label: string;
@@ -6500,17 +6336,16 @@ export declare interface ToolExecutionResult {
     activityMetadata?: ToolActivityMetadata;
 }
 
-declare interface ToolInputDelta {
-    type: "tool_input_delta";
-    toolName: string;
-    content: string;
-    conversationId?: string;
-    /** The tool_use block ID for client-side correlation. */
-    toolUseId?: string;
-    /** Database ID of the assistant message that owns this tool_use block.
-     *  Same semantics as `AssistantTextDeltaEvent.messageId`. */
-    messageId?: string;
-}
+declare type ToolInputDeltaEvent = z.infer<typeof ToolInputDeltaEventSchema>;
+
+declare const ToolInputDeltaEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool_input_delta">;
+    toolName: z.ZodString;
+    content: z.ZodString;
+    conversationId: z.ZodOptional<z.ZodString>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 
 declare interface ToolInputSchema {
     type: "object";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.11-dev.202607231953.b64451d",
+  "version": "0.10.11-dev.202607232108.d026831",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",