@vellumai/plugin-api 0.10.8-dev.202607102324.096fdf1 → 0.10.8-dev.202607110139.afd85ad

package/index.d.ts

@@ -3430,10 +3430,10 @@ declare interface HostFileWriteRequest {
 
 /**
  * Host proxy capabilities that an interface can support. The macOS client
- * supports all five; the chrome-extension interface only supports
+ * supports all of them; the chrome-extension interface only supports
  * host_browser (via the Chrome DevTools Protocol proxy).
  */
-declare type HostProxyCapability = "host_bash" | "host_file" | "host_cu" | "host_browser" | "host_app_control";
+declare type HostProxyCapability = "host_bash" | "host_file" | "host_cu" | "host_browser" | "host_app_control" | "host_ui_snapshot";
 
 declare interface HostTransferCancelRequest {
     type: "host_transfer_cancel";
@@ -3469,6 +3469,29 @@ declare interface HostTransferToSandboxRequest {
     sourcePath: string;
 }
 
+declare interface HostUiSnapshotCancelMessage {
+    type: "host_ui_snapshot_cancel";
+    requestId: string;
+}
+
+declare interface HostUiSnapshotRequestMessage {
+    type: "host_ui_snapshot_request";
+    requestId: string;
+    view: HostUiSnapshotView;
+    /**
+     * Validated workspace-theme tokens to apply on the stage. The daemon reads
+     * them from ui/theme.json at request time so the capture reflects the
+     * current file even before connected clients refetch. Absent when no valid
+     * theme exists — the stage renders the built-in base theme.
+     */
+    tokens?: Record<string, string>;
+}
+
+declare type _HostUiSnapshotServerMessages = HostUiSnapshotRequestMessage | HostUiSnapshotCancelMessage;
+
+/** Staged compositions the web client can render for capture. */
+declare type HostUiSnapshotView = "sampler" | "chat";
+
 declare type IdentityChangedEvent = z.infer<typeof IdentityChangedEventSchema>;
 
 declare const IdentityChangedEventSchema: z.ZodObject<{
@@ -5055,6 +5078,18 @@ export declare interface SendMessageConfig {
      * stripped before any provider wire request.
      */
     selectionSeed?: string;
+    /**
+     * Per-conversation prompt-cache key for providers with explicit prompt
+     * caching (sent as the OpenAI `prompt_cache_key` request param). Set by
+     * `RetryProvider` from `selectionSeed` (the durable conversation id) for
+     * the `openai` and `openrouter` providers — GPT-5.6+ requires the key for
+     * reliable breakpoint matching, and OpenAI's ~15 req/min-per-key routing
+     * guidance is satisfied by per-conversation ids. A non-wire field for
+     * every other provider client (the Anthropic client strips it, covering
+     * OpenRouter's `anthropic/*` delegation); the request param is omitted
+     * when absent.
+     */
+    promptCacheKey?: string;
     /**
      * Internal per-request HTTP headers for managed-proxy usage attribution.
      * Provider clients may pass these through SDK request options only when the
@@ -5116,7 +5151,7 @@ declare interface SensitiveOutputBinding {
 
 declare type SensitiveOutputKind = "invite_code";
 
-declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _WorkItemsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _GuardianActionsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _DiagnosticsServerMessages | _InboxServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BackgroundToolsServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | HookEvent | SubagentEvent;
+declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _WorkItemsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _GuardianActionsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _HostUiSnapshotServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _DiagnosticsServerMessages | _InboxServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BackgroundToolsServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | HookEvent | SubagentEvent;
 
 export declare interface ServerToolUseContent {
     type: "server_tool_use";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.8-dev.202607102324.096fdf1",
+  "version": "0.10.8-dev.202607110139.afd85ad",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",