@vellumai/plugin-api 0.11.11-staging.1 → 0.11.11-staging.3

package/index.d.ts

@@ -793,6 +793,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
             vision: "vision";
             voiceProgressNarration: "voiceProgressNarration";
             voiceFrontDoor: "voiceFrontDoor";
+            voiceContinuationLabel: "voiceContinuationLabel";
             trustRuleSuggestion: "trustRuleSuggestion";
             homeGreeting: "homeGreeting";
             homeSuggestedPrompts: "homeSuggestedPrompts";
@@ -960,17 +961,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 url: z.ZodString;
                 headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             }, z.core.$strip>], "type">;
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            defaultRiskLevel: z.ZodDefault<z.ZodEnum<{
-                low: "low";
-                medium: "medium";
-                high: "high";
-            }>>;
-            maxTools: z.ZodDefault<z.ZodNumber>;
-            allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            blockedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>>;
-        globalMaxTools: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
     acp: z.ZodDefault<z.ZodObject<{
         maxConcurrentSessions: z.ZodDefault<z.ZodNumber>;
@@ -1031,6 +1022,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
         interactiveGitTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        stageBatchSize: z.ZodDefault<z.ZodNumber>;
         enrichmentQueueSize: z.ZodDefault<z.ZodNumber>;
         enrichmentConcurrency: z.ZodDefault<z.ZodNumber>;
         enrichmentJobTimeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -1607,6 +1599,7 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         type: z.ZodLiteral<"conversation_error">;
         conversationId: z.ZodString;
         code: z.ZodEnum<{
+            UNKNOWN: "UNKNOWN";
             PROVIDER_NETWORK: "PROVIDER_NETWORK";
             PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
             MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
@@ -1625,7 +1618,6 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
             CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
             CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
             DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
-            UNKNOWN: "UNKNOWN";
         }>;
         userMessage: z.ZodString;
         retryable: z.ZodBoolean;
@@ -1646,6 +1638,7 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
             memory_v3: "memory_v3";
         }>;
         code: z.ZodEnum<{
+            UNKNOWN: "UNKNOWN";
             PROVIDER_NETWORK: "PROVIDER_NETWORK";
             PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
             MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
@@ -1664,7 +1657,6 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
             CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
             CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
             DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
-            UNKNOWN: "UNKNOWN";
         }>;
         userMessage: z.ZodString;
         errorCategory: z.ZodOptional<z.ZodString>;
@@ -2805,8 +2797,8 @@ declare const AssistantEventPublishOptionsSchema: z.ZodObject<{
         macos: "macos";
         windows: "windows";
         linux: "linux";
-        cli: "cli";
         "chrome-extension": "chrome-extension";
+        cli: "cli";
     }>>;
     excludeClientId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -3130,6 +3122,7 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"conversation_error">;
     conversationId: z.ZodString;
     code: z.ZodEnum<{
+        UNKNOWN: "UNKNOWN";
         PROVIDER_NETWORK: "PROVIDER_NETWORK";
         PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
         MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
@@ -3148,7 +3141,6 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
         CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
         DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
-        UNKNOWN: "UNKNOWN";
     }>;
     userMessage: z.ZodString;
     retryable: z.ZodBoolean;
@@ -3169,6 +3161,7 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         memory_v3: "memory_v3";
     }>;
     code: z.ZodEnum<{
+        UNKNOWN: "UNKNOWN";
         PROVIDER_NETWORK: "PROVIDER_NETWORK";
         PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
         MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
@@ -3187,7 +3180,6 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
         CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
         DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
-        UNKNOWN: "UNKNOWN";
     }>;
     userMessage: z.ZodString;
     errorCategory: z.ZodOptional<z.ZodString>;
@@ -4879,9 +4871,16 @@ export declare const HOOKS: {
 };
 
 /**
- * Host proxy capabilities that an interface can support. macOS supports all
- * of them, Windows and Linux withhold app control, and chrome-extension
- * supports only host_browser through the Chrome DevTools Protocol proxy.
+ * Which client provides which host capability.
+ *
+ * This is the single source of truth for host routing. `supportsHostProxy` in
+ * `channels/types.ts` answers from this table, and the `assistant clients` help
+ * text renders it so the assistant can tell a user which client unblocks a
+ * task. It lives in the shared leaf zone because the CLI reads it on every
+ * `assistant clients --help`, and the CLI may not hoist daemon-internal
+ * modules into its static import graph.
+ *
+ * Pure data and pure functions only: no imports, no daemon runtime graph.
  */
 declare const HOST_PROXY_CAPABILITIES: readonly ["host_bash", "host_file", "host_cu", "host_cu_window_capture", "host_cu_annotate", "host_browser", "host_app_control", "host_ui_snapshot"];
 
@@ -5485,6 +5484,7 @@ declare const LLMCallSiteEnum: z.ZodEnum<{
     vision: "vision";
     voiceProgressNarration: "voiceProgressNarration";
     voiceFrontDoor: "voiceFrontDoor";
+    voiceContinuationLabel: "voiceContinuationLabel";
     trustRuleSuggestion: "trustRuleSuggestion";
     homeGreeting: "homeGreeting";
     homeSuggestedPrompts: "homeSuggestedPrompts";
@@ -5565,8 +5565,8 @@ declare const messageMetadataSchema: z.ZodObject<{
         discord: "discord";
         plugin: "plugin";
     }>>;
-    userMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "cli" | "chrome-extension" | null, string>> & z.ZodType<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "cli" | "chrome-extension", string, z.core.$ZodTypeInternals<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "cli" | "chrome-extension", string>>>;
-    assistantMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "cli" | "chrome-extension" | null, string>> & z.ZodType<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "cli" | "chrome-extension", string, z.core.$ZodTypeInternals<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "cli" | "chrome-extension", string>>>;
+    userMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "chrome-extension" | "cli" | null, string>> & z.ZodType<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "chrome-extension" | "cli", string, z.core.$ZodTypeInternals<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "chrome-extension" | "cli", string>>>;
+    assistantMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "chrome-extension" | "cli" | null, string>> & z.ZodType<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "chrome-extension" | "cli", string, z.core.$ZodTypeInternals<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "route" | "web" | "ios" | "macos" | "windows" | "linux" | "chrome-extension" | "cli", string>>>;
     client: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     clientOsFromRequest: z.ZodOptional<z.ZodBoolean>;
     subagentNotification: z.ZodOptional<z.ZodObject<{
@@ -5731,6 +5731,17 @@ export declare function parseMessageMetadata(metadataJson: string | null): Promi
  */
 declare function parseMessageMetadata_2(metadataJson: string | null): MessageMetadata_2 | undefined;
 
+/**
+ * Read the `surfaceId` out of a `ui_show` tool result, or `undefined` when the
+ * content is not a surface envelope.
+ *
+ * Trailing prose after the JSON object is tolerated: guidance belongs in a
+ * `note` field, but a caller that appends it instead must not silently cost
+ * the reader its `surfaceId`: losing the id makes a live progress surface
+ * invisible to the completion nudge, and the user watches it spin forever.
+ */
+export declare function parseSurfaceShowResultId(content: string): string | undefined;
+
 /**
  * Plugin-facing facade over the host's system-card writer: a daemon-authored
  * transcript notice, persisted as an assistant row stamped

package/index.js

@@ -42,6 +42,7 @@ export const listInstalledSkills = api.listInstalledSkills;
 export const mediaBlockAttachmentId = api.mediaBlockAttachmentId;
 export const openTranscriptionSession = api.openTranscriptionSession;
 export const parseMessageMetadata = api.parseMessageMetadata;
+export const parseSurfaceShowResultId = api.parseSurfaceShowResultId;
 export const persistSystemCard = api.persistSystemCard;
 export const publishEvent = api.publishEvent;
 export const quarantineRefusedExchanges = api.quarantineRefusedExchanges;

package/package.json

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