@vellumai/plugin-api 0.11.1 → 0.11.2-staging.2

package/index.d.ts

@@ -487,6 +487,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
             timeThresholdMs: z.ZodDefault<z.ZodNumber>;
             messageThreshold: z.ZodDefault<z.ZodNumber>;
             minCooldownMs: z.ZodDefault<z.ZodNumber>;
+            requireUserActivity: z.ZodDefault<z.ZodBoolean>;
             sweepIntervalMs: z.ZodDefault<z.ZodNumber>;
             sweepLookbackMs: z.ZodDefault<z.ZodNumber>;
             keepSupersededRuns: z.ZodDefault<z.ZodBoolean>;
@@ -499,6 +500,9 @@ declare const AssistantConfigSchema: z.ZodObject<{
         ringBufferSize: z.ZodDefault<z.ZodNumber>;
         highMemThresholdRatio: z.ZodDefault<z.ZodNumber>;
         snapshotCooldownMs: z.ZodDefault<z.ZodNumber>;
+        fdPollIntervalMs: z.ZodDefault<z.ZodNumber>;
+        highFdThresholdRatio: z.ZodDefault<z.ZodNumber>;
+        fdWarnCooldownMs: z.ZodDefault<z.ZodNumber>;
         pluginSourceScanIntervalMs: z.ZodDefault<z.ZodNumber>;
         baselineSnapshotIntervalMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -944,6 +948,9 @@ declare const AssistantConfigSchema: z.ZodObject<{
         failureBackoffBaseMs: z.ZodDefault<z.ZodNumber>;
         failureBackoffMaxMs: z.ZodDefault<z.ZodNumber>;
         maxFileSizeBytes: z.ZodDefault<z.ZodNumber>;
+        historyCompaction: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
         interactiveGitTimeoutMs: z.ZodDefault<z.ZodNumber>;
         enrichmentQueueSize: z.ZodDefault<z.ZodNumber>;
         enrichmentConcurrency: z.ZodDefault<z.ZodNumber>;
@@ -1434,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;
@@ -1967,9 +1979,15 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         title: z.ZodString;
         body: z.ZodString;
         deliveryId: z.ZodOptional<z.ZodString>;
+        correlationId: z.ZodOptional<z.ZodString>;
         deepLinkMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         targetGuardianPrincipalId: z.ZodOptional<z.ZodString>;
         silent: z.ZodOptional<z.ZodBoolean>;
+        remotePushDispatched: z.ZodOptional<z.ZodBoolean>;
+        remotePushPlatforms: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            ios: "ios";
+            android: "android";
+        }>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"oauth_connect_result">;
         success: z.ZodBoolean;
@@ -2268,6 +2286,12 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         type: z.ZodLiteral<"ui_surface_dismiss">;
         conversationId: z.ZodString;
         surfaceId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"ui_surface_pending">;
+        conversationId: z.ZodString;
+        surfaceType: z.ZodLiteral<"visual">;
+        toolUseId: z.ZodString;
+        messageId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"ui_surface_show">;
         conversationId: z.ZodString;
@@ -2805,6 +2829,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;
@@ -3338,9 +3367,15 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     title: z.ZodString;
     body: z.ZodString;
     deliveryId: z.ZodOptional<z.ZodString>;
+    correlationId: z.ZodOptional<z.ZodString>;
     deepLinkMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     targetGuardianPrincipalId: z.ZodOptional<z.ZodString>;
     silent: z.ZodOptional<z.ZodBoolean>;
+    remotePushDispatched: z.ZodOptional<z.ZodBoolean>;
+    remotePushPlatforms: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        ios: "ios";
+        android: "android";
+    }>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"oauth_connect_result">;
     success: z.ZodBoolean;
@@ -3639,6 +3674,12 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"ui_surface_dismiss">;
     conversationId: z.ZodString;
     surfaceId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_pending">;
+    conversationId: z.ZodString;
+    surfaceType: z.ZodLiteral<"visual">;
+    toolUseId: z.ZodString;
+    messageId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"ui_surface_show">;
     conversationId: z.ZodString;
@@ -4482,10 +4523,42 @@ 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;
+    /**
+     * The confirmation this turn is blocked on, when the label describes a wait
+     * rather than work in flight. Absent otherwise.
+     *
+     * It travels so that a surface outside the app — the Live Activity's
+     * Approve/Deny buttons — can answer the request it was drawn against rather
+     * than whatever is pending by the time the press lands. Content on a Lock
+     * Screen can be seconds old, and a decision is the one thing that must not
+     * be re-pointed when it is: the id lets a client drop a press aimed at a
+     * request already answered, timed out, or superseded.
+     */
+    readonly approvalRequestId?: string;
+}
+
 declare interface LiveVoiceArchivedServerFrame extends LiveVoiceServerFrameBase {
     readonly type: "archived";
     readonly conversationId: string;
@@ -4621,7 +4694,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;
@@ -4849,7 +4922,10 @@ declare const messageMetadataSchema: z.ZodObject<{
     provenanceRequesterIdentifier: z.ZodOptional<z.ZodString>;
     automated: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;
+    voiceSessionTurn: z.ZodOptional<z.ZodBoolean>;
     messageKind: z.ZodOptional<z.ZodString>;
+    providerErrorCode: z.ZodOptional<z.ZodString>;
+    providerErrorCategory: z.ZodOptional<z.ZodString>;
     backgroundToolCompletion: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
         toolName: z.ZodString;
@@ -5313,6 +5389,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).
@@ -5366,6 +5444,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;
@@ -5436,6 +5516,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",
+  "version": "0.11.2-staging.2",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",