@vellumai/plugin-api 0.11.5-dev.202608251857.ea09afb → 0.11.5-dev.202608252008.65007aa

package/index.d.ts

@@ -600,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";
             }>>;
@@ -724,10 +724,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";
             }>>;
@@ -4158,6 +4158,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;
@@ -4186,6 +4199,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. */
@@ -4944,6 +4959,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 {
@@ -5118,6 +5139,27 @@ 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.11.5-dev.202608251857.ea09afb",
+  "version": "0.11.5-dev.202608252008.65007aa",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",