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

package/index.d.ts

@@ -148,9 +148,10 @@ declare const AssistantConfigSchema: z.ZodObject<{
         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>;
@@ -279,24 +280,6 @@ 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>;
@@ -617,10 +600,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";
             }>>;
@@ -690,7 +673,6 @@ 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<{
@@ -741,10 +723,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";
             }>>;
@@ -1078,7 +1060,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
             turnEnd: z.ZodDefault<z.ZodObject<{
                 enabled: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$strip>>;
-            model: z.ZodOptional<z.ZodString>;
+            model: z.ZodDefault<z.ZodString>;
             eotThreshold: z.ZodDefault<z.ZodNumber>;
             eagerEotThreshold: z.ZodOptional<z.ZodNumber>;
             eotTimeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -4175,19 +4157,6 @@ 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;
@@ -4216,8 +4185,6 @@ 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. */
@@ -4583,11 +4550,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 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
+ * 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
  * {@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).
@@ -4976,12 +4943,6 @@ 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 {
@@ -5126,23 +5087,6 @@ 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;
@@ -5156,27 +5100,6 @@ declare type LiveVoiceServerFrameType = (typeof _LIVE_VOICE_SERVER_FRAME_TYPES)[
 
 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
  * immediately stop local TTS playback — this doubles as the flush-tail-audio
@@ -6002,15 +5925,6 @@ 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.
@@ -6531,18 +6445,6 @@ 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
@@ -6915,33 +6817,28 @@ export declare type SttErrorCategory =
 | "provider-error";
 
 /**
- * Catalog identity for a daemon-hosted STT backend.
+ * Provider-agnostic speech-to-text domain types for daemon transcription.
  *
- * 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.
+ * 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.
  *
- * 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.
+ * 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.
  */
 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"
-/**
-* 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";
+| "deepgram-flux" | "google-gemini" | "xai" | "vellum";
 
 /** The streaming session has closed (no more events will be emitted). */
 export declare interface SttStreamServerClosedEvent {

package/package.json

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