@vellumai/plugin-api 0.10.12-dev.202607272227.bd2aa0b → 0.10.12-dev.202607281637.45cc60c

package/index.d.ts

@@ -1388,11 +1388,11 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
             resolved_stale: "resolved_stale";
         }>;
         source: z.ZodEnum<{
+            system: "system";
             button: "button";
             inline_nl: "inline_nl";
             auto_deny: "auto_deny";
             timeout: "timeout";
-            system: "system";
         }>;
         causedByRequestId: z.ZodOptional<z.ZodString>;
         decisionText: z.ZodOptional<z.ZodString>;
@@ -2748,11 +2748,11 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         resolved_stale: "resolved_stale";
     }>;
     source: z.ZodEnum<{
+        system: "system";
         button: "button";
         inline_nl: "inline_nl";
         auto_deny: "auto_deny";
         timeout: "timeout";
-        system: "system";
     }>;
     causedByRequestId: z.ZodOptional<z.ZodString>;
     decisionText: z.ZodOptional<z.ZodString>;
@@ -3907,7 +3907,7 @@ declare interface CliSubcommandHelp {
 
 declare type ConfiguredProviderOptions = Pick<ResolveCallSiteOpts, "overrideProfile" | "forceOverrideProfile" | "selectionSeed">;
 
-export declare type ContentBlock = TextContent | ThinkingContent | RedactedThinkingContent | ImageContent | FileContent | ToolUseContent | ToolResultContent | ServerToolUseContent | WebSearchToolResultContent;
+export declare type ContentBlock = TextContent | ThinkingContent | RedactedThinkingContent | ImageContent | FileContent | ToolUseContent | ToolResultContent | ServerToolUseContent | WebSearchToolResultContent | UiSurfaceContent;
 
 /** How a conversation was created / its execution mode. */
 declare type ConversationCreateType = "standard" | "background" | "scheduled";
@@ -6714,6 +6714,36 @@ declare type TtsUseCase =
 /** In-app message playback — buffer-oriented, higher quality acceptable. */
 | "message-playback";
 
+/**
+ * A client-rendered UI card persisted into conversation history: call
+ * summaries, guardian approval cards, skill cards, wake notices, document
+ * previews.
+ *
+ * This is a rendering instruction, not model context — providers drop it when
+ * serializing history. Producers therefore pair the surface with a sibling
+ * `text` block flagged `_surfaceFallback` (see
+ * `notifications/approval-card-builder.ts`); that text is what feeds the model,
+ * search indexing, CLI display, and channel replies.
+ *
+ * `data` is deliberately opaque: its concrete shape is selected by
+ * `surfaceType` and owned by `daemon/message-types/surfaces.ts`.
+ */
+declare interface UiSurfaceContent {
+    type: "ui_surface";
+    surfaceId: string;
+    surfaceType: string;
+    title?: string;
+    data?: Record<string, unknown>;
+    actions?: unknown[];
+    /**
+     * Free-form, matching `CurrentTurnSurface.display` — NOT the `inline` /
+     * `panel` enum of the `ui_surface_show` wire event. Persisted surfaces carry
+     * whatever the `ui_show` tool wrote, so this must not narrow.
+     */
+    display?: string;
+    completed?: boolean;
+}
+
 /** Merge the given keys into a message's metadata JSON. */
 export declare function updateMessageMetadata(messageId: string, updates: Record<string, unknown>): Promise<void>;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.12-dev.202607272227.bd2aa0b",
+  "version": "0.10.12-dev.202607281637.45cc60c",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",