@vellumai/plugin-api 0.11.3-dev.202608181811.60ef9e5 → 0.11.3-dev.202608182007.738dd45

package/index.d.ts

@@ -127,9 +127,9 @@ declare const AssistantConfigSchema: z.ZodObject<{
         inference: z.ZodDefault<z.ZodObject<{}, z.core.$strip>>;
         "image-generation": z.ZodDefault<z.ZodObject<{
             provider: z.ZodDefault<z.ZodEnum<{
+                vellum: "vellum";
                 openai: "openai";
                 gemini: "gemini";
-                vellum: "vellum";
             }>>;
             model: z.ZodDefault<z.ZodString>;
         }, z.core.$strip>>;
@@ -601,9 +601,9 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 low: "low";
                 medium: "medium";
                 high: "high";
+                none: "none";
                 xhigh: "xhigh";
                 max: "max";
-                none: "none";
             }>>;
             speed: z.ZodOptional<z.ZodEnum<{
                 standard: "standard";
@@ -656,8 +656,8 @@ declare const AssistantConfigSchema: z.ZodObject<{
             }>>;
             disableCache: z.ZodOptional<z.ZodBoolean>;
             source: z.ZodOptional<z.ZodEnum<{
-                managed: "managed";
                 user: "user";
+                managed: "managed";
             }>>;
             label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             description: z.ZodOptional<z.ZodString>;
@@ -723,9 +723,9 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 low: "low";
                 medium: "medium";
                 high: "high";
+                none: "none";
                 xhigh: "xhigh";
                 max: "max";
-                none: "none";
             }>>;
             speed: z.ZodOptional<z.ZodEnum<{
                 standard: "standard";
@@ -1171,8 +1171,8 @@ declare const AssistantConfigSchema: z.ZodObject<{
     plugins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     pluginUpdates: z.ZodDefault<z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<{
-            auto: "auto";
             manual: "manual";
+            auto: "auto";
         }>>;
         strategy: z.ZodDefault<z.ZodEnum<{
             theirs: "theirs";
@@ -1240,12 +1240,12 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         type: z.ZodLiteral<"acp_session_update">;
         acpSessionId: z.ZodString;
         updateType: z.ZodEnum<{
+            plan: "plan";
             agent_message_chunk: "agent_message_chunk";
             agent_thought_chunk: "agent_thought_chunk";
             user_message_chunk: "user_message_chunk";
             tool_call: "tool_call";
             tool_call_update: "tool_call_update";
-            plan: "plan";
         }>;
         content: z.ZodOptional<z.ZodString>;
         toolCallId: z.ZodOptional<z.ZodString>;
@@ -1331,8 +1331,8 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         id: z.ZodString;
         conversationId: z.ZodString;
         status: z.ZodEnum<{
-            completed: "completed";
             cancelled: "cancelled";
+            completed: "completed";
             failed: "failed";
         }>;
         exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -1424,18 +1424,18 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         conversationId: z.ZodString;
         requestId: z.ZodString;
         state: z.ZodEnum<{
-            timed_out: "timed_out";
             pending: "pending";
             approved: "approved";
             denied: "denied";
+            timed_out: "timed_out";
             resolved_stale: "resolved_stale";
         }>;
         source: z.ZodEnum<{
+            timeout: "timeout";
             system: "system";
             button: "button";
             inline_nl: "inline_nl";
             auto_deny: "auto_deny";
-            timeout: "timeout";
         }>;
         causedByRequestId: z.ZodOptional<z.ZodString>;
         decisionText: z.ZodOptional<z.ZodString>;
@@ -1510,9 +1510,9 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"conversation_list_invalidated">;
         reason: z.ZodEnum<{
+            deleted: "deleted";
             created: "created";
             renamed: "renamed";
-            deleted: "deleted";
             reordered: "reordered";
             seen_changed: "seen_changed";
         }>;
@@ -1555,9 +1555,9 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
             enabled: z.ZodBoolean;
             state: z.ZodEnum<{
                 unknown: "unknown";
+                ok: "ok";
                 disabled: "disabled";
                 critical: "critical";
-                ok: "ok";
                 warning: "warning";
             }>;
             locked: z.ZodBoolean;
@@ -1672,8 +1672,8 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         hookName: z.ZodString;
         owner: z.ZodObject<{
             kind: z.ZodEnum<{
-                plugin: "plugin";
                 workspace: "workspace";
+                plugin: "plugin";
             }>;
             id: z.ZodString;
         }, z.core.$strip>;
@@ -1865,9 +1865,9 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         requestId: z.ZodString;
         conversationId: z.ZodString;
         state: z.ZodEnum<{
+            approved: "approved";
             cancelled: "cancelled";
             superseded: "superseded";
-            approved: "approved";
             rejected: "rejected";
             answered: "answered";
         }>;
@@ -2160,9 +2160,9 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         type: z.ZodLiteral<"subagent_status_changed">;
         subagentId: z.ZodString;
         status: z.ZodEnum<{
+            pending: "pending";
             completed: "completed";
             failed: "failed";
-            pending: "pending";
             running: "running";
             awaiting_input: "awaiting_input";
             aborted: "aborted";
@@ -2636,14 +2636,14 @@ declare const AssistantEventPublishOptionsSchema: z.ZodObject<{
     }>>;
     targetClientId: z.ZodOptional<z.ZodString>;
     targetInterfaceId: z.ZodOptional<z.ZodEnum<{
-        plugin: "plugin";
-        telegram: "telegram";
         phone: "phone";
+        a2a: "a2a";
         whatsapp: "whatsapp";
+        discord: "discord";
+        telegram: "telegram";
         slack: "slack";
         email: "email";
-        a2a: "a2a";
-        discord: "discord";
+        plugin: "plugin";
         macos: "macos";
         ios: "ios";
         cli: "cli";
@@ -2698,12 +2698,12 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"acp_session_update">;
     acpSessionId: z.ZodString;
     updateType: z.ZodEnum<{
+        plan: "plan";
         agent_message_chunk: "agent_message_chunk";
         agent_thought_chunk: "agent_thought_chunk";
         user_message_chunk: "user_message_chunk";
         tool_call: "tool_call";
         tool_call_update: "tool_call_update";
-        plan: "plan";
     }>;
     content: z.ZodOptional<z.ZodString>;
     toolCallId: z.ZodOptional<z.ZodString>;
@@ -2789,8 +2789,8 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodString;
     conversationId: z.ZodString;
     status: z.ZodEnum<{
-        completed: "completed";
         cancelled: "cancelled";
+        completed: "completed";
         failed: "failed";
     }>;
     exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -2882,18 +2882,18 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     conversationId: z.ZodString;
     requestId: z.ZodString;
     state: z.ZodEnum<{
-        timed_out: "timed_out";
         pending: "pending";
         approved: "approved";
         denied: "denied";
+        timed_out: "timed_out";
         resolved_stale: "resolved_stale";
     }>;
     source: z.ZodEnum<{
+        timeout: "timeout";
         system: "system";
         button: "button";
         inline_nl: "inline_nl";
         auto_deny: "auto_deny";
-        timeout: "timeout";
     }>;
     causedByRequestId: z.ZodOptional<z.ZodString>;
     decisionText: z.ZodOptional<z.ZodString>;
@@ -2968,9 +2968,9 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"conversation_list_invalidated">;
     reason: z.ZodEnum<{
+        deleted: "deleted";
         created: "created";
         renamed: "renamed";
-        deleted: "deleted";
         reordered: "reordered";
         seen_changed: "seen_changed";
     }>;
@@ -3013,9 +3013,9 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         enabled: z.ZodBoolean;
         state: z.ZodEnum<{
             unknown: "unknown";
+            ok: "ok";
             disabled: "disabled";
             critical: "critical";
-            ok: "ok";
             warning: "warning";
         }>;
         locked: z.ZodBoolean;
@@ -3130,8 +3130,8 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     hookName: z.ZodString;
     owner: z.ZodObject<{
         kind: z.ZodEnum<{
-            plugin: "plugin";
             workspace: "workspace";
+            plugin: "plugin";
         }>;
         id: z.ZodString;
     }, z.core.$strip>;
@@ -3323,9 +3323,9 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     requestId: z.ZodString;
     conversationId: z.ZodString;
     state: z.ZodEnum<{
+        approved: "approved";
         cancelled: "cancelled";
         superseded: "superseded";
-        approved: "approved";
         rejected: "rejected";
         answered: "answered";
     }>;
@@ -3618,9 +3618,9 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"subagent_status_changed">;
     subagentId: z.ZodString;
     status: z.ZodEnum<{
+        pending: "pending";
         completed: "completed";
         failed: "failed";
-        pending: "pending";
         running: "running";
         awaiting_input: "awaiting_input";
         aborted: "aborted";
@@ -5122,31 +5122,31 @@ declare type MessageMetadata_2 = z.infer<typeof messageMetadataSchema>;
 
 declare const messageMetadataSchema: z.ZodObject<{
     userMessageChannel: z.ZodOptional<z.ZodEnum<{
-        plugin: "plugin";
-        vellum: "vellum";
-        platform: "platform";
-        telegram: "telegram";
         phone: "phone";
+        platform: "platform";
+        a2a: "a2a";
+        vellum: "vellum";
         whatsapp: "whatsapp";
+        discord: "discord";
+        telegram: "telegram";
         slack: "slack";
         email: "email";
-        a2a: "a2a";
-        discord: "discord";
+        plugin: "plugin";
     }>>;
     assistantMessageChannel: z.ZodOptional<z.ZodEnum<{
-        plugin: "plugin";
-        vellum: "vellum";
-        platform: "platform";
-        telegram: "telegram";
         phone: "phone";
+        platform: "platform";
+        a2a: "a2a";
+        vellum: "vellum";
         whatsapp: "whatsapp";
+        discord: "discord";
+        telegram: "telegram";
         slack: "slack";
         email: "email";
-        a2a: "a2a";
-        discord: "discord";
+        plugin: "plugin";
     }>>;
-    userMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"plugin" | "telegram" | "phone" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route" | null, string>> & z.ZodType<"plugin" | "telegram" | "phone" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route", string, z.core.$ZodTypeInternals<"plugin" | "telegram" | "phone" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route", string>>>;
-    assistantMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"plugin" | "telegram" | "phone" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route" | null, string>> & z.ZodType<"plugin" | "telegram" | "phone" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route", string, z.core.$ZodTypeInternals<"plugin" | "telegram" | "phone" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route", string>>>;
+    userMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route" | null, string>> & z.ZodType<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route", string, z.core.$ZodTypeInternals<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route", string>>>;
+    assistantMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route" | null, string>> & z.ZodType<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route", string, z.core.$ZodTypeInternals<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "ios" | "cli" | "web" | "chrome-extension" | "route", string>>>;
     client: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     clientOsFromRequest: z.ZodOptional<z.ZodBoolean>;
     subagentNotification: z.ZodOptional<z.ZodObject<{
@@ -5174,16 +5174,16 @@ declare const messageMetadataSchema: z.ZodObject<{
     }>>;
     model: z.ZodOptional<z.ZodString>;
     provenanceSourceChannel: z.ZodOptional<z.ZodEnum<{
-        plugin: "plugin";
-        vellum: "vellum";
-        platform: "platform";
-        telegram: "telegram";
         phone: "phone";
+        platform: "platform";
+        a2a: "a2a";
+        vellum: "vellum";
         whatsapp: "whatsapp";
+        discord: "discord";
+        telegram: "telegram";
         slack: "slack";
         email: "email";
-        a2a: "a2a";
-        discord: "discord";
+        plugin: "plugin";
     }>>;
     provenanceGuardianExternalUserId: z.ZodOptional<z.ZodString>;
     provenanceRequesterIdentifier: z.ZodOptional<z.ZodString>;
@@ -5200,8 +5200,8 @@ declare const messageMetadataSchema: z.ZodObject<{
         command: z.ZodString;
         startedAt: z.ZodNumber;
         status: z.ZodEnum<{
-            completed: "completed";
             cancelled: "cancelled";
+            completed: "completed";
             failed: "failed";
         }>;
         exitCode: z.ZodNullable<z.ZodNumber>;
@@ -6083,6 +6083,23 @@ export declare function resolveUserName(workspaceDir: string): string | null;
  */
 export declare function resolveWebhookUrl(options: WebhookUrlOptions): Promise<string>;
 
+declare type RiskAllowlistOption = z.infer<typeof RiskAllowlistOptionSchema>;
+
+/** Minimatch ladder for the "always allow" prompt option (what a rule matches). */
+declare const RiskAllowlistOptionSchema: z.ZodObject<{
+    label: z.ZodString;
+    description: z.ZodString;
+    pattern: z.ZodString;
+}, z.core.$strip>;
+
+declare type RiskDirectoryScopeOption = z.infer<typeof RiskDirectoryScopeOptionSchema>;
+
+/** Directory ladder for filesystem operations; `scope` is a path glob or `everywhere`. */
+declare const RiskDirectoryScopeOptionSchema: z.ZodObject<{
+    scope: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strip>;
+
 export declare enum RiskLevel {
     Low = "low",
     Medium = "medium",
@@ -7288,16 +7305,9 @@ export declare interface ToolExecutionResult {
      * wildcards) — what the gateway actually matches against. Mirrors
      * the `allowlistOptions` field on `ConfirmationRequest` SSE events.
      */
-    riskAllowlistOptions?: Array<{
-        label: string;
-        description: string;
-        pattern: string;
-    }>;
+    riskAllowlistOptions?: RiskAllowlistOption[];
     /** Directory scope ladder for the rule editor (narrowest to broadest). */
-    riskDirectoryScopeOptions?: Array<{
-        scope: string;
-        label: string;
-    }>;
+    riskDirectoryScopeOptions?: RiskDirectoryScopeOption[];
     /** Structured activity metadata for client rendering (web search, web fetch, etc).
      *  Populated by daemon-internal tools; plugins must not set this. */
     activityMetadata?: ToolActivityMetadata;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.11.3-dev.202608181811.60ef9e5",
+  "version": "0.11.3-dev.202608182007.738dd45",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",