@vellumai/plugin-api 0.11.5-staging.2 → 0.11.6-dev.202608252309.48526e7

package/index.d.ts

@@ -137,19 +137,20 @@ declare const AssistantConfigSchema: z.ZodObject<{
             provider: z.ZodDefault<z.ZodEnum<{
                 [x: string]: string;
             }>>;
+            apiBase: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         "web-fetch": z.ZodDefault<z.ZodObject<{
             provider: z.ZodDefault<z.ZodEnum<{
                 [x: string]: string;
             }>>;
+            apiBase: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         stt: z.ZodDefault<z.ZodObject<{
             provider: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
                 vellum: "vellum";
+                "openai-whisper": "openai-whisper";
                 deepgram: "deepgram";
-                "deepgram-flux": "deepgram-flux";
                 "google-gemini": "google-gemini";
-                "openai-whisper": "openai-whisper";
                 xai: "xai";
             }>>;
             language: z.ZodDefault<z.ZodString>;
@@ -278,6 +279,24 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 "your-own": "your-own";
             }>>;
         }, z.core.$strip>>;
+        "monday-oauth": z.ZodDefault<z.ZodObject<{
+            mode: z.ZodDefault<z.ZodEnum<{
+                managed: "managed";
+                "your-own": "your-own";
+            }>>;
+        }, z.core.$strip>>;
+        "eventbrite-oauth": z.ZodDefault<z.ZodObject<{
+            mode: z.ZodDefault<z.ZodEnum<{
+                managed: "managed";
+                "your-own": "your-own";
+            }>>;
+        }, z.core.$strip>>;
+        "calendly-oauth": z.ZodDefault<z.ZodObject<{
+            mode: z.ZodDefault<z.ZodEnum<{
+                managed: "managed";
+                "your-own": "your-own";
+            }>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     memory: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -598,10 +617,10 @@ declare const AssistantConfigSchema: z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
             effort: z.ZodOptional<z.ZodEnum<{
+                none: "none";
                 low: "low";
                 medium: "medium";
                 high: "high";
-                none: "none";
                 xhigh: "xhigh";
                 max: "max";
             }>>;
@@ -662,6 +681,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
             label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             description: z.ZodOptional<z.ZodString>;
             provider_connection: z.ZodOptional<z.ZodString>;
+            allowUnlisted: z.ZodOptional<z.ZodBoolean>;
             status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 active: "active";
                 disabled: "disabled";
@@ -670,6 +690,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 profile: z.ZodString;
                 weight: z.ZodNumber;
             }, z.core.$strip>>>;
+            fallbackProfile: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         profileOrder: z.ZodDefault<z.ZodArray<z.ZodString>>;
         callSites: z.ZodDefault<z.ZodRecord<z.ZodEnum<{
@@ -720,10 +741,10 @@ declare const AssistantConfigSchema: z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
             effort: z.ZodOptional<z.ZodEnum<{
+                none: "none";
                 low: "low";
                 medium: "medium";
                 high: "high";
-                none: "none";
                 xhigh: "xhigh";
                 max: "max";
             }>>;
@@ -1057,7 +1078,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
             turnEnd: z.ZodDefault<z.ZodObject<{
                 enabled: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$strip>>;
-            model: z.ZodDefault<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
             eotThreshold: z.ZodDefault<z.ZodNumber>;
             eagerEotThreshold: z.ZodOptional<z.ZodNumber>;
             eotTimeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -1331,9 +1352,9 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         id: z.ZodString;
         conversationId: z.ZodString;
         status: z.ZodEnum<{
-            cancelled: "cancelled";
             completed: "completed";
             failed: "failed";
+            cancelled: "cancelled";
         }>;
         exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         output: z.ZodOptional<z.ZodString>;
@@ -1672,8 +1693,8 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         hookName: z.ZodString;
         owner: z.ZodObject<{
             kind: z.ZodEnum<{
-                workspace: "workspace";
                 plugin: "plugin";
+                workspace: "workspace";
             }>;
             id: z.ZodString;
         }, z.core.$strip>;
@@ -2266,6 +2287,7 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
                     tavily: "tavily";
                     keenable: "keenable";
                     firecrawl: "firecrawl";
+                    fastcrw: "fastcrw";
                 }>;
                 resultCount: z.ZodNumber;
                 durationMs: z.ZodNumber;
@@ -2287,6 +2309,7 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
                 provider: z.ZodOptional<z.ZodEnum<{
                     default: "default";
                     firecrawl: "firecrawl";
+                    fastcrw: "fastcrw";
                 }>>;
                 status: z.ZodNumber;
                 contentType: z.ZodOptional<z.ZodString>;
@@ -2427,6 +2450,11 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         requestId: z.ZodOptional<z.ZodString>;
         clientMessageId: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"watch_retro_completed">;
+        sessionId: z.ZodString;
+        conversationId: z.ZodString;
+        reportReady: z.ZodBoolean;
+    }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"workflow_completed">;
         runId: z.ZodString;
         conversationId: z.ZodOptional<z.ZodString>;
@@ -2662,12 +2690,12 @@ declare const AssistantEventPublishOptionsSchema: z.ZodObject<{
     targetClientId: z.ZodOptional<z.ZodString>;
     targetInterfaceId: z.ZodOptional<z.ZodEnum<{
         phone: "phone";
-        a2a: "a2a";
-        whatsapp: "whatsapp";
-        discord: "discord";
         telegram: "telegram";
+        whatsapp: "whatsapp";
         slack: "slack";
         email: "email";
+        a2a: "a2a";
+        discord: "discord";
         plugin: "plugin";
         macos: "macos";
         windows: "windows";
@@ -2815,9 +2843,9 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodString;
     conversationId: z.ZodString;
     status: z.ZodEnum<{
-        cancelled: "cancelled";
         completed: "completed";
         failed: "failed";
+        cancelled: "cancelled";
     }>;
     exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     output: z.ZodOptional<z.ZodString>;
@@ -3156,8 +3184,8 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     hookName: z.ZodString;
     owner: z.ZodObject<{
         kind: z.ZodEnum<{
-            workspace: "workspace";
             plugin: "plugin";
+            workspace: "workspace";
         }>;
         id: z.ZodString;
     }, z.core.$strip>;
@@ -3750,6 +3778,7 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 tavily: "tavily";
                 keenable: "keenable";
                 firecrawl: "firecrawl";
+                fastcrw: "fastcrw";
             }>;
             resultCount: z.ZodNumber;
             durationMs: z.ZodNumber;
@@ -3771,6 +3800,7 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             provider: z.ZodOptional<z.ZodEnum<{
                 default: "default";
                 firecrawl: "firecrawl";
+                fastcrw: "fastcrw";
             }>>;
             status: z.ZodNumber;
             contentType: z.ZodOptional<z.ZodString>;
@@ -3911,6 +3941,11 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     requestId: z.ZodOptional<z.ZodString>;
     clientMessageId: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"watch_retro_completed">;
+    sessionId: z.ZodString;
+    conversationId: z.ZodString;
+    reportReady: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"workflow_completed">;
     runId: z.ZodString;
     conversationId: z.ZodOptional<z.ZodString>;
@@ -4057,6 +4092,13 @@ declare interface BaseSubscriberEntry {
  */
 export declare function buildMessageExcerpt(rawContent: string, query: string): Promise<string>;
 
+/**
+ * Conversation-type axis within an adapter (the "channel-type" cascade
+ * level): direct message, private channel/group, public channel. Adapters
+ * map their native surfaces onto these three.
+ */
+declare const CHANNEL_CONVERSATION_TYPES: readonly ["dm", "private", "public"];
+
 /**
  * Canonical channel-id vocabulary shared between the assistant daemon and the
  * gateway.
@@ -4090,6 +4132,8 @@ export declare function buildMessageExcerpt(rawContent: string, query: string):
  */
 declare const CHANNEL_IDS: readonly ["telegram", "phone", "vellum", "whatsapp", "slack", "email", "platform", "a2a", "discord", "plugin"];
 
+declare type ChannelConversationType = (typeof CHANNEL_CONVERSATION_TYPES)[number];
+
 declare type ChannelId = (typeof CHANNEL_IDS)[number];
 
 export declare const CLI_COMMAND_HELP: readonly CliCommandHelp[];
@@ -4131,6 +4175,19 @@ declare interface CliCommandHelp {
     subcommands?: CliSubcommandHelp[];
 }
 
+/**
+ * Client OS surfaces — the value set for the message-body `clientOs` field.
+ *
+ * This is deliberately SEPARATE from {@link INTERFACE_IDS}: `clientOs`
+ * describes which OS the user's device runs, not which transport the turn
+ * arrived on. `"android"` (and `"ios"` for a mobile browser) are real OS
+ * surfaces but not transports — they must never answer transport questions
+ * (`supportsHostProxy`, `isInteractiveInterface`), so they live here rather
+ * than polluting the interface vocabulary. Drives only the per-turn
+ * `client_os` context line (e.g. app-builder mobile-first for `ios`/`android`).
+ */
+declare const CLIENT_OS_VALUES: readonly ["web", "ios", "macos", "windows", "android"];
+
 declare interface ClientEntry extends BaseSubscriberEntry {
     type: "client";
     clientId: string;
@@ -4159,6 +4216,8 @@ declare interface ClientEntry extends BaseSubscriberEntry {
     webPresence?: ClientWebPresence;
 }
 
+declare type ClientOs = (typeof CLIENT_OS_VALUES)[number];
+
 declare interface ClientPresence {
     state: DesktopPresenceState;
     /** When the daemon last heard from the client. Drives staleness. */
@@ -4323,9 +4382,17 @@ export declare type ConversationsClearedContext = BaseHookContext;
 /** Read-side alias of {@link ConversationCreateType}. */
 declare type ConversationType = ConversationCreateType;
 
-/** Create a live voice connection bound to the caller's `send` transport. */
+/**
+ * Create a live voice connection bound to the caller's `send` transport.
+ *
+ * `close` is how the daemon hangs up. It is optional only because a transport
+ * may not be able to (an in-process pipe), but a real one should always pass
+ * it: without it, a session the daemon reclaims from an absent client leaves
+ * the transport open behind it.
+ */
 export declare function createLiveVoiceConnection(options: {
     send: LiveVoiceFrameSender;
+    close?: () => void;
 }): LiveVoiceConnection;
 
 /**
@@ -4516,11 +4583,11 @@ export declare function getDocument(documentId: string): Promise<IndexedDocument
 export declare function getMessages(conversationId: string): Promise<MessageRow[]>;
 
 /**
- * List the workspace inference profiles a plugin can route to, in the order the
- * `/model` picker presents them (`llm.profileOrder` first, then the rest
- * alphabetically). Metadata-only entries without a provider, model, or mix are
- * not routing targets, so plugins never see them. Disabled profiles are
- * included and flagged via
+ * List the workspace inference profiles a plugin can route to, in the order a
+ * user-facing model picker presents them (`llm.profileOrder` first, then the
+ * rest alphabetically). Managed backup routes are internal and omitted.
+ * Metadata-only entries without a provider, model, or mix are not routing
+ * targets, so plugins never see them. Disabled profiles are included and flagged via
  * {@link ModelProfileInfo.isDisabled}; weighted "mix" profiles are included and
  * flagged via {@link ModelProfileInfo.isMix}, since a mix is itself a valid
  * routing target (it resolves to one constituent per conversation).
@@ -4909,6 +4976,12 @@ declare interface LiveVoiceAssistantTextDeltaServerFrame extends LiveVoiceServer
 declare interface LiveVoiceBusyServerFrame extends LiveVoiceServerFrameBase {
     readonly type: "busy";
     readonly activeSessionId: string;
+    /**
+     * Absent from daemons that predate it, and from a holder that revealed
+     * neither field, so a client must degrade to the unspecific copy rather
+     * than assume.
+     */
+    readonly holder?: LiveVoiceSessionHolder;
 }
 
 export declare interface LiveVoiceConnection {
@@ -5053,6 +5126,23 @@ declare interface LiveVoiceReadyServerFrame extends LiveVoiceServerFrameBase {
      * (older daemons) means "manual".
      */
     readonly turnDetection?: LiveVoiceTurnDetectionMode;
+    /**
+     * Whether this daemon will accept `text` frames on the session. Absent
+     * (older daemons) means no, which is what lets a client that asked for
+     * `textInput` fall back rather than type into a socket that would answer
+     * every typed turn with an `unknown_type` error.
+     */
+    readonly textInput?: boolean;
+    /**
+     * Whether the session's speech-to-text leg is live. Absent means yes, which
+     * is the only thing an older daemon can have meant: it rejects a session it
+     * cannot transcribe, so every session it readies can hear.
+     *
+     * False is reachable only for a client that declared `textInput`, and tells
+     * it to present the session as typed rather than draw a microphone that
+     * will never hear anything.
+     */
+    readonly audioInput?: boolean;
 }
 
 export declare type LiveVoiceServerFrame = LiveVoiceReadyServerFrame | LiveVoiceBusyServerFrame | LiveVoiceSpeechStartedServerFrame | LiveVoiceUtteranceEndServerFrame | LiveVoiceUtteranceDiscardedServerFrame | LiveVoiceSttPartialServerFrame | LiveVoiceSttFinalServerFrame | LiveVoiceThinkingServerFrame | LiveVoiceActivityServerFrame | LiveVoiceAssistantTextDeltaServerFrame | LiveVoiceTtsAudioServerFrame | LiveVoiceTtsDoneServerFrame | LiveVoiceTurnCancelledServerFrame | LiveVoiceMinimizeRoomServerFrame | LiveVoiceMetricsServerFrame | LiveVoiceArchivedServerFrame | LiveVoiceErrorServerFrame;
@@ -5064,7 +5154,28 @@ declare interface LiveVoiceServerFrameBase {
 
 declare type LiveVoiceServerFrameType = (typeof _LIVE_VOICE_SERVER_FRAME_TYPES)[number];
 
-export declare type LiveVoiceSessionCloseReason = "client_end" | "error" | "websocket_close" | "transport_closed" | "manager_shutdown";
+export declare type LiveVoiceSessionCloseReason = "client_end" | "error" | "websocket_close" | "transport_closed" | "client_timeout" | "forced_end" | "manager_shutdown";
+
+/**
+ * Where the session holding the daemon's single live-voice slot is running,
+ * as much of it as the daemon knows.
+ *
+ * Display only: it is what lets a client refused a session say where the one
+ * that blocked it is. Nothing routes, authorizes, or decides capability on
+ * it, and every field is optional, so a holder that names neither its surface
+ * nor a conversation is simply less specific.
+ */
+declare interface LiveVoiceSessionHolder {
+    /**
+     * The OS surface the holder is running on, from its `start` frame. A
+     * {@link ClientOs} carries no transport meaning by contract (see
+     * `channels/types.ts`), which is exactly right for a label: it says which
+     * device the user should go looking on, and answers nothing else.
+     */
+    readonly client?: ClientOs;
+    /** The conversation the holder is talking in, once it has one. */
+    readonly conversationId?: string;
+}
 
 /**
  * Emitted when the server VAD detects user speech. The client MUST
@@ -5222,30 +5333,30 @@ declare const messageMetadataSchema: z.ZodObject<{
     sentAt: z.ZodOptional<z.ZodNumber>;
     userMessageChannel: z.ZodOptional<z.ZodEnum<{
         phone: "phone";
-        platform: "platform";
-        a2a: "a2a";
+        telegram: "telegram";
         vellum: "vellum";
         whatsapp: "whatsapp";
-        discord: "discord";
-        telegram: "telegram";
         slack: "slack";
         email: "email";
+        platform: "platform";
+        a2a: "a2a";
+        discord: "discord";
         plugin: "plugin";
     }>>;
     assistantMessageChannel: z.ZodOptional<z.ZodEnum<{
         phone: "phone";
-        platform: "platform";
-        a2a: "a2a";
+        telegram: "telegram";
         vellum: "vellum";
         whatsapp: "whatsapp";
-        discord: "discord";
-        telegram: "telegram";
         slack: "slack";
         email: "email";
+        platform: "platform";
+        a2a: "a2a";
+        discord: "discord";
         plugin: "plugin";
     }>>;
-    userMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "windows" | "ios" | "cli" | "web" | "chrome-extension" | "route" | null, string>> & z.ZodType<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "windows" | "ios" | "cli" | "web" | "chrome-extension" | "route", string, z.core.$ZodTypeInternals<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "windows" | "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" | "windows" | "ios" | "cli" | "web" | "chrome-extension" | "route" | null, string>> & z.ZodType<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "windows" | "ios" | "cli" | "web" | "chrome-extension" | "route", string, z.core.$ZodTypeInternals<"phone" | "a2a" | "whatsapp" | "discord" | "telegram" | "slack" | "email" | "plugin" | "macos" | "windows" | "ios" | "cli" | "web" | "chrome-extension" | "route", string>>>;
+    userMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "macos" | "windows" | "ios" | "cli" | "web" | "chrome-extension" | "route" | null, string>> & z.ZodType<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "macos" | "windows" | "ios" | "cli" | "web" | "chrome-extension" | "route", string, z.core.$ZodTypeInternals<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "macos" | "windows" | "ios" | "cli" | "web" | "chrome-extension" | "route", string>>>;
+    assistantMessageInterface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "macos" | "windows" | "ios" | "cli" | "web" | "chrome-extension" | "route" | null, string>> & z.ZodType<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "macos" | "windows" | "ios" | "cli" | "web" | "chrome-extension" | "route", string, z.core.$ZodTypeInternals<"phone" | "telegram" | "whatsapp" | "slack" | "email" | "a2a" | "discord" | "plugin" | "macos" | "windows" | "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<{
@@ -5274,14 +5385,14 @@ declare const messageMetadataSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     provenanceSourceChannel: z.ZodOptional<z.ZodEnum<{
         phone: "phone";
-        platform: "platform";
-        a2a: "a2a";
+        telegram: "telegram";
         vellum: "vellum";
         whatsapp: "whatsapp";
-        discord: "discord";
-        telegram: "telegram";
         slack: "slack";
         email: "email";
+        platform: "platform";
+        a2a: "a2a";
+        discord: "discord";
         plugin: "plugin";
     }>>;
     provenanceGuardianExternalUserId: z.ZodOptional<z.ZodString>;
@@ -5299,9 +5410,9 @@ declare const messageMetadataSchema: z.ZodObject<{
         command: z.ZodString;
         startedAt: z.ZodNumber;
         status: z.ZodEnum<{
-            cancelled: "cancelled";
             completed: "completed";
             failed: "failed";
+            cancelled: "cancelled";
         }>;
         exitCode: z.ZodNullable<z.ZodNumber>;
         output: z.ZodString;
@@ -5891,6 +6002,15 @@ export declare interface ProviderResponse {
     model: string;
     /** Provider that actually produced this response, which may differ from a wrapper provider name. */
     actualProvider?: string;
+    /**
+     * Inference profile key that actually governed this response when a
+     * wrapper re-routed the request away from the caller's own resolution
+     * (`RetryProvider`'s fallback-route escalation). `UsageTrackingProvider`
+     * prefers this over re-resolving from the original request options, so a
+     * successful fallback serve is attributed to the backup profile rather
+     * than the failed primary's. Absent on the normal (non-rerouted) path.
+     */
+    actualInferenceProfile?: string;
     /**
      * Base URL the provider's HTTP client actually resolved to for this request,
      * read from the live SDK client instance rather than re-derived from config.
@@ -6411,6 +6531,18 @@ export declare interface SendMessageConfig {
      * request.
      */
     forceOverrideProfile?: boolean;
+    /**
+     * True when the caller appended {@link NATIVE_WEB_SEARCH_TOOL_NAME} purely
+     * to activate the route's provider-native web search, rather than passing an
+     * app-executed search tool of the same name (which is what runs when a
+     * search backend like Brave or the platform search proxy is configured).
+     * Only the caller can tell those apart, and a route change after that
+     * decision has to: `RetryProvider` drops the tool on a backup that runs no
+     * native search, and must not touch it when the daemon executes it itself.
+     * A resolution/routing-time concern only; stripped before any provider wire
+     * request.
+     */
+    nativeWebSearchSentinel?: boolean;
     /**
      * Per-conversation seed for deterministic `mix`-profile expansion. The agent
      * loop sets this to the conversation id so every resolver call this send
@@ -6783,28 +6915,33 @@ export declare type SttErrorCategory =
 | "provider-error";
 
 /**
- * Provider-agnostic speech-to-text domain types for daemon transcription.
+ * Catalog identity for a daemon-hosted STT backend.
  *
- * These types define the boundary between callers that need audio transcription
- * and the concrete STT provider implementations. The goal is to let daemon
- * callsites program against a single typed interface so that provider swaps are
- * localized to the adapter layer.
+ * This is the key capability is stored under, NOT the set of values a user may
+ * put in `services.stt.provider`. A provider that offers more than one model
+ * family with genuinely different capabilities gets a row per family, because
+ * the catalog is a capability matrix and those capabilities differ. Users
+ * select the family with `services.stt.providers.<id>.model`, and
+ * {@link resolveSttCatalogKey} maps that pair onto the row.
  *
- * Two execution modes are supported:
- * - **Batch** — a single audio buffer is sent and a final transcript returned.
- * - **Streaming** — audio chunks are sent over a persistent session, and the
- *   provider emits partial/final transcript events in real time.
- */
-/**
- * Canonical provider identifiers for daemon-hosted STT backends.
- * Extend this union as new providers are integrated.
+ * Keeping the two apart bounds the user-facing surface: adding a model family
+ * costs a catalog row and nothing else, while adding a provider id costs an
+ * enum entry, a settings-picker row, and a place in every predicate that
+ * classifies providers.
  */
 export declare type SttProviderId = "openai-whisper" | "deepgram"
 /**
 * Deepgram's Flux conversational speech model. Shares the `deepgram`
 * credential and is streaming-only: Flux has no batch endpoint.
 */
-| "deepgram-flux" | "google-gemini" | "xai" | "vellum";
+| "deepgram-flux" | "google-gemini" | "xai" | "vellum"
+/**
+* Managed Flux: the same conversational model as `deepgram-flux`, reached
+* through the platform's speech relay instead of a Deepgram key. Dials the
+* relay's STT v2 endpoint asking for native Flux frames, so it keeps the
+* turn events the relay's default v1-shaped translation drops.
+*/
+| "vellum-flux";
 
 /** The streaming session has closed (no more events will be emitted). */
 export declare interface SttStreamServerClosedEvent {
@@ -7261,7 +7398,7 @@ export declare interface ToolContext {
      * resolution; undefined when the chat type is unknown or ambiguous.
      * @legacy
      */
-    channelConversationType?: "dm" | "private" | "public";
+    channelConversationType?: ChannelConversationType;
     /**
      * External channel/conversation ID of the current chat (the binding's
      * external chat id — Slack channel, Telegram chat, …). Keys the channel
@@ -7740,7 +7877,7 @@ declare interface WebFetchMetadata {
 }
 
 /** Provider that backed a `web_fetch` call. `default` is the built-in fetcher. */
-declare type WebFetchProviderId = "default" | "firecrawl";
+declare type WebFetchProviderId = "default" | "firecrawl" | "fastcrw";
 
 /**
  * Public URL resolution for a plugin's own ingress route.
@@ -7797,7 +7934,7 @@ declare interface WebSearchMetadata {
     errorMessage?: string;
 }
 
-declare type WebSearchProviderId = "anthropic-native" | "brave" | "perplexity" | "tavily" | "keenable" | "firecrawl";
+declare type WebSearchProviderId = "anthropic-native" | "brave" | "perplexity" | "tavily" | "keenable" | "firecrawl" | "fastcrw";
 
 declare interface WebSearchResultItem {
     rank: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.11.5-staging.2",
+  "version": "0.11.6-dev.202608252309.48526e7",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",