@vellumai/plugin-api 0.11.1-dev.202608032128.6f59e1c → 0.11.1-dev.202608032326.ca2b5a1

package/index.d.ts

@@ -1441,6 +1441,11 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         summaryCharCount: z.ZodOptional<z.ZodNumber>;
         summaryHeaderCount: z.ZodOptional<z.ZodNumber>;
         summaryHadMemoryEcho: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"context_window_usage">;
+        conversationId: z.ZodString;
+        tokens: z.ZodNumber;
+        maxTokens: z.ZodNumber;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"conversation_error">;
         conversationId: z.ZodString;
@@ -2819,6 +2824,11 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     summaryCharCount: z.ZodOptional<z.ZodNumber>;
     summaryHeaderCount: z.ZodOptional<z.ZodNumber>;
     summaryHadMemoryEcho: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"context_window_usage">;
+    conversationId: z.ZodString;
+    tokens: z.ZodNumber;
+    maxTokens: z.ZodNumber;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"conversation_error">;
     conversationId: z.ZodString;
@@ -4503,10 +4513,30 @@ export declare function listConversations(limit?: number, conversationType?: Con
  */
 export declare function listInstalledSkills(): Promise<ResolvedSkillEntry[]>;
 
-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", "minimize_room", "metrics", "archived", "error"];
+declare const _LIVE_VOICE_SERVER_FRAME_TYPES: readonly ["ready", "busy", "speech_started", "utterance_end", "utterance_discarded", "stt_partial", "stt_final", "thinking", "activity", "assistant_text_delta", "tts_audio", "tts_done", "turn_cancelled", "minimize_room", "metrics", "archived", "error"];
 
 declare const LIVE_VOICE_TURN_DETECTION_MODES: readonly ["manual", "server_vad"];
 
+/**
+ * What the assistant is doing inside a turn, as one short user-facing line.
+ *
+ * Exists because a live-voice turn can go silent for a long time while it
+ * works, and the surfaces that show the session (the iOS Live Activity, and
+ * the room) can otherwise only say "Thinking...". The label is composed here
+ * rather than by each surface for the same reason phase wording is composed
+ * once: the Live Activity has two independent drivers (this socket and an APNs
+ * push the daemon dispatches), they must carry identical content, and the only
+ * way to guarantee that is for both to be handed the same string.
+ *
+ * An empty `label` means "no current activity", which is what a turn's end
+ * sends. Emitted only on change, never per tool result.
+ */
+declare interface LiveVoiceActivityServerFrame extends LiveVoiceServerFrameBase {
+    readonly type: "activity";
+    readonly turnId: string;
+    readonly label: string;
+}
+
 declare interface LiveVoiceArchivedServerFrame extends LiveVoiceServerFrameBase {
     readonly type: "archived";
     readonly conversationId: string;
@@ -4642,7 +4672,7 @@ declare interface LiveVoiceReadyServerFrame extends LiveVoiceServerFrameBase {
     readonly turnDetection?: LiveVoiceTurnDetectionMode;
 }
 
-export declare type LiveVoiceServerFrame = LiveVoiceReadyServerFrame | LiveVoiceBusyServerFrame | LiveVoiceSpeechStartedServerFrame | LiveVoiceUtteranceEndServerFrame | LiveVoiceUtteranceDiscardedServerFrame | LiveVoiceSttPartialServerFrame | LiveVoiceSttFinalServerFrame | LiveVoiceThinkingServerFrame | LiveVoiceAssistantTextDeltaServerFrame | LiveVoiceTtsAudioServerFrame | LiveVoiceTtsDoneServerFrame | LiveVoiceTurnCancelledServerFrame | LiveVoiceMinimizeRoomServerFrame | LiveVoiceMetricsServerFrame | LiveVoiceArchivedServerFrame | LiveVoiceErrorServerFrame;
+export declare type LiveVoiceServerFrame = LiveVoiceReadyServerFrame | LiveVoiceBusyServerFrame | LiveVoiceSpeechStartedServerFrame | LiveVoiceUtteranceEndServerFrame | LiveVoiceUtteranceDiscardedServerFrame | LiveVoiceSttPartialServerFrame | LiveVoiceSttFinalServerFrame | LiveVoiceThinkingServerFrame | LiveVoiceActivityServerFrame | LiveVoiceAssistantTextDeltaServerFrame | LiveVoiceTtsAudioServerFrame | LiveVoiceTtsDoneServerFrame | LiveVoiceTurnCancelledServerFrame | LiveVoiceMinimizeRoomServerFrame | LiveVoiceMetricsServerFrame | LiveVoiceArchivedServerFrame | LiveVoiceErrorServerFrame;
 
 declare interface LiveVoiceServerFrameBase {
     readonly type: LiveVoiceServerFrameType;
@@ -5337,6 +5367,8 @@ declare interface ProcessEntry extends BaseSubscriberEntry {
 
 export declare interface Provider {
     name: string;
+    /** Connection route whose credentials this provider instance uses. */
+    routeAttribution?: ProviderRouteAttribution;
     /**
      * Provider key used by the local token estimator to select model-family
      * specific rules (e.g. Anthropic's `width * height / 750` image sizing).
@@ -5390,6 +5422,8 @@ export declare interface Provider {
     countInputTokens?(messages: Message[], systemPrompt: string, tools?: ToolDefinition_2[]): Promise<number>;
 }
 
+declare type ProviderCredentialSource = "byok" | "no-auth" | "oauth-subscription" | "vellum-managed";
+
 export declare type ProviderEvent = {
     type: "text_delta";
     text: string;
@@ -5460,6 +5494,18 @@ export declare interface ProviderResponse {
     rawResponse?: unknown;
 }
 
+declare interface ProviderRouteAttribution {
+    connectionName?: string;
+    profileName?: string;
+    isManagedRoute?: boolean;
+    /**
+     * Credential surface used for this request. Finer than `isManagedRoute`:
+     * it separates personal provider keys, keyless endpoints, and subscription
+     * logins from each other so error copy can name what the user must fix.
+     */
+    credentialSource?: ProviderCredentialSource;
+}
+
 /** Callback for proxy policy decisions requiring user confirmation. Returns true if approved. */
 declare type ProxyApprovalCallback = (request: ProxyApprovalRequest) => Promise<boolean>;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.11.1-dev.202608032128.6f59e1c",
+  "version": "0.11.1-dev.202608032326.ca2b5a1",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",