@vellumai/plugin-api 0.8.11-staging.1 → 0.8.12-dev.202606131539.b0e5ff7

package/index.d.ts

@@ -463,14 +463,15 @@ declare const AssistantTextDeltaEventSchema: z.ZodObject<{
     conversationId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
-declare interface AssistantThinkingDelta {
-    type: "assistant_thinking_delta";
-    thinking: string;
-    conversationId?: string;
-    /** Database ID of the assistant message this thinking delta belongs to.
-     *  Same semantics as `AssistantTextDeltaEvent.messageId`. */
-    messageId?: string;
-}
+declare type AssistantThinkingDeltaEvent = z.infer<typeof AssistantThinkingDeltaEventSchema>;
+
+declare const AssistantThinkingDeltaEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"assistant_thinking_delta">;
+    thinking: z.ZodString;
+    messageId: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    timestampMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
 
 declare type AssistantTurnStartEvent = z.infer<typeof AssistantTurnStartEventSchema>;
 
@@ -1062,7 +1063,7 @@ declare interface ConversationSearchResultItem {
     matchingMessages: ConversationSearchMatchingMessage[];
 }
 
-declare type _ConversationsServerMessages = AuthResult | PongMessage | AssistantStatusMessage | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfo | HistoryResponse | UndoComplete | UsageUpdateEvent | UsageProgress | UsageResponse | ContextCompacted | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationInfo | ConversationTitleUpdatedEvent | ConversationListResponse | ConversationsClearResponse | ConversationSearchResponse | MessageContentResponse | ConversationListInvalidatedEvent | ScheduleConversationCreated | OpenConversation;
+declare type _ConversationsServerMessages = AuthResult | PongMessage | AssistantStatusMessage | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfo | HistoryResponse | UndoComplete | UsageUpdateEvent | UsageProgressEvent | UsageResponse | ContextCompacted | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationInfo | ConversationTitleUpdatedEvent | ConversationListResponse | ConversationsClearResponse | ConversationSearchResponse | MessageContentResponse | ConversationListInvalidatedEvent | ScheduleConversationCreated | OpenConversation;
 
 declare type ConversationTitleUpdatedEvent = z.infer<typeof ConversationTitleUpdatedEventSchema>;
 
@@ -2420,7 +2421,7 @@ declare const MessageRequestCompleteEventSchema: z.ZodObject<{
     runStillActive: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 
-declare type _MessagesServerMessages = UserMessageEchoEvent | AssistantTurnStartEvent | AssistantTextDeltaEvent | AssistantThinkingDelta | ToolUseStartEvent | ToolUsePreviewStartEvent | ToolOutputChunkEvent | ToolInputDelta | ToolResultEvent | ConfirmationRequestEvent | SecretRequestEvent | QuestionRequestEvent | MessageCompleteEvent | ErrorEvent_2 | MessageQueuedEvent | MessageDequeuedEvent | MessageRequestCompleteEvent | MessageQueuedDeletedEvent | MessageSteered | SuggestionResponse | TraceEvent | ConfirmationStateChanged | AssistantActivityStateEvent | TurnProfileAutoRoutedEvent | ConversationInferenceProfileUpdated | InteractionResolvedEvent;
+declare type _MessagesServerMessages = UserMessageEchoEvent | AssistantTurnStartEvent | AssistantTextDeltaEvent | AssistantThinkingDeltaEvent | ToolUseStartEvent | ToolUsePreviewStartEvent | ToolOutputChunkEvent | ToolInputDelta | ToolResultEvent | ConfirmationRequestEvent | SecretRequestEvent | QuestionRequestEvent | MessageCompleteEvent | ErrorEvent_2 | MessageQueuedEvent | MessageDequeuedEvent | MessageRequestCompleteEvent | MessageQueuedDeletedEvent | MessageSteered | SuggestionResponse | TraceEvent | ConfirmationStateChanged | AssistantActivityStateEvent | TurnProfileAutoRoutedEvent | ConversationInferenceProfileUpdated | InteractionResolvedEvent;
 
 declare interface MessageSteered {
     type: "message_steered";
@@ -2887,6 +2888,13 @@ export declare interface PostToolUseContext {
      * singular of Codex's `additional_contexts`. `null` means no extra context.
      */
     additionalContext: string | null;
+    /**
+     * Model id reported by the provider for the assistant turn that issued
+     * this tool call (e.g. `claude-opus-4-8`,
+     * `accounts/fireworks/models/kimi-k2p6`). Hooks use it to vary coaching by
+     * model family — some models need earlier or firmer steering than others.
+     */
+    readonly model: string;
     /**
      * The model's context-window size in tokens. Plugins derive their own
      * character budget from this (e.g. a share of the window) rather than
@@ -4310,19 +4318,16 @@ declare interface UsageAttributionSnapshot {
     resolvedMixArm: string | null;
 }
 
-/**
- * Emitted after each LLM call with per-call token deltas and estimated cost.
- * Clients accumulate these additively for live-updating usage metrics.
- * This is a UI-only hint — it does not persist to DB or affect billing.
- */
-declare interface UsageProgress {
-    type: "usage_progress";
-    conversationId: string;
-    inputTokens: number;
-    outputTokens: number;
-    estimatedCost: number;
-    model: string;
-}
+declare type UsageProgressEvent = z.infer<typeof UsageProgressEventSchema>;
+
+declare const UsageProgressEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"usage_progress">;
+    conversationId: z.ZodString;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    estimatedCost: z.ZodNumber;
+    model: z.ZodString;
+}, z.core.$strip>;
 
 declare interface UsageResponse {
     type: "usage_response";
@@ -4345,6 +4350,8 @@ declare const UsageUpdateEventSchema: z.ZodObject<{
     conversationId: z.ZodString;
     inputTokens: z.ZodNumber;
     outputTokens: z.ZodNumber;
+    cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
     totalInputTokens: z.ZodNumber;
     totalOutputTokens: z.ZodNumber;
     estimatedCost: z.ZodNumber;

package/package.json

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