@vellumai/plugin-api 0.12.0 → 0.12.1-staging.1

package/index.d.ts

@@ -167,10 +167,10 @@ declare const AssistantConfigSchema: z.ZodObject<{
             language: z.ZodDefault<z.ZodString>;
             providers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
             roles: z.ZodDefault<z.ZodRecord<z.ZodEnum<{
-                watch: "watch";
                 liveVoice: "liveVoice";
                 telephony: "telephony";
                 dictation: "dictation";
+                watch: "watch";
                 batch: "batch";
             }> & z.core.$partial, z.ZodObject<{
                 provider: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
@@ -592,6 +592,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
         retrospective: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
+            skillImprovement: z.ZodDefault<z.ZodBoolean>;
             timeThresholdMs: z.ZodDefault<z.ZodNumber>;
             messageThreshold: z.ZodDefault<z.ZodNumber>;
             minCooldownMs: z.ZodDefault<z.ZodNumber>;
@@ -945,31 +946,14 @@ declare const AssistantConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
         localDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
-    mcp: z.ZodDefault<z.ZodObject<{
-        servers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-            transport: z.ZodDiscriminatedUnion<[z.ZodObject<{
-                type: z.ZodLiteral<"stdio">;
-                command: z.ZodString;
-                args: z.ZodDefault<z.ZodArray<z.ZodString>>;
-                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            }, z.core.$strip>, z.ZodObject<{
-                type: z.ZodLiteral<"sse">;
-                url: z.ZodString;
-                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            }, z.core.$strip>, z.ZodObject<{
-                type: z.ZodLiteral<"streamable-http">;
-                url: z.ZodString;
-                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            }, z.core.$strip>], "type">;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
     acp: z.ZodDefault<z.ZodObject<{
         maxConcurrentSessions: z.ZodDefault<z.ZodNumber>;
         agents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-            command: z.ZodString;
+            command: z.ZodOptional<z.ZodString>;
             args: z.ZodDefault<z.ZodArray<z.ZodString>>;
             description: z.ZodOptional<z.ZodString>;
             env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            model: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
     skills: z.ZodDefault<z.ZodObject<{
@@ -981,8 +965,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
         }, z.core.$strip>>>;
         load: z.ZodDefault<z.ZodObject<{
             extraDirs: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            watch: z.ZodDefault<z.ZodBoolean>;
-            watchDebounceMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
         install: z.ZodDefault<z.ZodObject<{
             nodeManager: z.ZodDefault<z.ZodEnum<{
@@ -1077,15 +1059,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             text: z.ZodDefault<z.ZodString>;
         }, z.core.$strip>>;
-        safety: z.ZodDefault<z.ZodObject<{
-            denyCategories: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>>;
         voice: z.ZodDefault<z.ZodObject<{
-            interruptSensitivity: z.ZodDefault<z.ZodEnum<{
-                low: "low";
-                medium: "medium";
-                high: "high";
-            }>>;
             telephonyStreaming: z.ZodDefault<z.ZodBoolean>;
             utteranceEndMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
@@ -1100,10 +1074,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     liveVoice: z.ZodDefault<z.ZodObject<{
-        mode: z.ZodDefault<z.ZodEnum<{
-            ptt: "ptt";
-            "open-mic": "open-mic";
-        }>>;
         vad: z.ZodDefault<z.ZodObject<{
             speechEnergyThreshold: z.ZodDefault<z.ZodNumber>;
             noiseFloorMargin: z.ZodDefault<z.ZodNumber>;
@@ -1114,6 +1084,18 @@ declare const AssistantConfigSchema: z.ZodObject<{
             echoEmaHalfLifeMs: z.ZodDefault<z.ZodNumber>;
             echoDrainSlackMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
+        flux: z.ZodDefault<z.ZodObject<{
+            turnEnd: z.ZodDefault<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            model: z.ZodOptional<z.ZodString>;
+            eotThreshold: z.ZodDefault<z.ZodNumber>;
+            eagerEotThreshold: z.ZodOptional<z.ZodNumber>;
+            eotTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        archiveAudio: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    voice: z.ZodDefault<z.ZodObject<{
         frontModel: z.ZodDefault<z.ZodObject<{
             endpointDecisionTimeoutMs: z.ZodDefault<z.ZodNumber>;
             endpointExtensionMs: z.ZodDefault<z.ZodNumber>;
@@ -1128,17 +1110,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 generationTimeoutMs: z.ZodDefault<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
-        flux: z.ZodDefault<z.ZodObject<{
-            turnEnd: z.ZodDefault<z.ZodObject<{
-                enabled: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strip>>;
-            model: z.ZodOptional<z.ZodString>;
-            eotThreshold: z.ZodDefault<z.ZodNumber>;
-            eagerEotThreshold: z.ZodOptional<z.ZodNumber>;
-            eotTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strip>>;
-        maxSessionDurationSeconds: z.ZodDefault<z.ZodNumber>;
-        archiveAudio: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
     sight: z.ZodDefault<z.ZodObject<{
         keepLatestFrames: z.ZodDefault<z.ZodNumber>;
@@ -1313,6 +1284,18 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         type: z.ZodLiteral<"acp_session_error">;
         acpSessionId: z.ZodString;
         error: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"acp_session_model_update">;
+        acpSessionId: z.ZodString;
+        modelRevisionEpoch: z.ZodString;
+        modelRevision: z.ZodNumber;
+        model: z.ZodOptional<z.ZodString>;
+        availableModels: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            group: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"acp_session_spawned">;
         acpSessionId: z.ZodString;
@@ -2841,6 +2824,18 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"acp_session_error">;
     acpSessionId: z.ZodString;
     error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"acp_session_model_update">;
+    acpSessionId: z.ZodString;
+    modelRevisionEpoch: z.ZodString;
+    modelRevision: z.ZodNumber;
+    model: z.ZodOptional<z.ZodString>;
+    availableModels: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        group: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"acp_session_spawned">;
     acpSessionId: z.ZodString;
@@ -4849,6 +4844,7 @@ export declare type HookBroadcast = (detail: Record<string, unknown>) => void;
  *   - `post-model-call` — {@link PostModelCallContext}
  *   - `conversation-deleted` — {@link ConversationDeletedContext}
  *   - `conversations-cleared` — {@link ConversationsClearedContext}
+ *   - `message-deleted`: {@link MessageDeletedContext}
  */
 export declare type HookFunction<TCtx = unknown> = (ctx: TCtx) => Promise<Partial<TCtx> | void>;
 
@@ -4890,6 +4886,8 @@ export declare const HOOKS: {
     readonly CONVERSATION_DELETED: "conversation-deleted";
     /** Fires once when every conversation is wiped at once (the clear-all reset), after the main tables are cleared. Carries no `conversationId`; cleanup hooks wipe their own per-conversation state wholesale. */
     readonly CONVERSATIONS_CLEARED: "conversations-cleared";
+    /** Fires once per deleted message row, after the row is removed, carrying the row's `(createdAt, id)` so a hook can settle state that pointed at it. Fire-and-forget cleanup signal, like `conversation-deleted`; whole-conversation deletes dispatch that hook instead. */
+    readonly MESSAGE_DELETED: "message-deleted";
 };
 
 /**
@@ -5293,8 +5291,6 @@ declare interface LiveVoiceMetricsServerFrame extends LiveVoiceServerFrameBase {
      * condition as the two fields above.
      */
     readonly endpointDecisionSource?: "front-door" | "provider";
-    /** Which floor-holding ack actually spoke during the turn, if any. */
-    readonly ackSpoken?: "first_delta" | "tool_use";
     /**
      * Spoken progress narrations during the turn. Present only when at least
      * one progress update spoke (otherwise the field is absent, keeping frames
@@ -5535,6 +5531,37 @@ export declare interface Message {
     content: ContentBlock[];
 }
 
+/**
+ * The full `message-deleted` context a hook receives: the dispatching call
+ * site's {@link MessageDeletedInputContext} plus the pipeline-stamped
+ * {@link BaseHookContext} capabilities.
+ */
+export declare interface MessageDeletedContext extends MessageDeletedInputContext, BaseHookContext {
+}
+
+/**
+ * Context passed to the `message-deleted` hook. Fires once per deleted
+ * message row, from the shared single-message delete primitive, after the row
+ * is removed. Whole-conversation deletes dispatch `conversation-deleted`
+ * instead.
+ *
+ * Fire-and-forget like `conversation-deleted`: the primitive is synchronous
+ * and does not wait for the chain. The row is gone by the time a hook runs,
+ * so the context carries the row's `createdAt` alongside its id. Together
+ * they are the `(createdAt, id)` position the row held, which is what a hook
+ * keeping a cursor on that row needs to record once the row can no longer be
+ * looked up. The default memory plugin contributes a hook here that stamps
+ * its retrospective cursor.
+ */
+declare interface MessageDeletedInputContext {
+    /** ID of the conversation that owned the row. */
+    readonly conversationId: string;
+    /** ID of the deleted message row. */
+    readonly messageId: string;
+    /** The deleted row's `createdAt`. */
+    readonly createdAt: number;
+}
+
 declare type MessageLexicalSearchResult = Awaited<ReturnType<searchMessageIdsLexical_2>>[number];
 
 declare interface MessageLexicalSearchResult_2 {

package/package.json

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