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

package/index.d.ts

@@ -1062,7 +1062,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>;
 
@@ -2887,6 +2887,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 +4317,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";

package/package.json

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