@vellumai/plugin-api 0.11.1-dev.202608042034.3c87207 → 0.11.1-dev.202608042130.2b7da8d

package/index.d.ts

@@ -76,6 +76,37 @@ export declare type AgentLoopExitReason =
 /** An unhandled error ended the turn. */
 | "error";
 
+declare type AnsweredQuestion = z.infer<typeof AnsweredQuestionSchema>;
+
+declare const AnsweredQuestionSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        question: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        freeTextPlaceholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    responses: z.ZodArray<z.ZodObject<{
+        questionId: z.ZodString;
+        decision: z.ZodEnum<{
+            option: "option";
+            free_text: "free_text";
+            skipped: "skipped";
+        }>;
+        optionId: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    overall: z.ZodEnum<{
+        completed: "completed";
+        closed: "closed";
+    }>;
+}, z.core.$strip>;
+
 /**
  * How {@link listConversations} (and friends) treats archived rows.
  *
@@ -767,12 +798,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
             disableCache: z.ZodOptional<z.ZodBoolean>;
             profile: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
-        defaultProfileOverrides: z.ZodDefault<z.ZodRecord<z.ZodEnum<{
-            balanced: "balanced";
-            "quality-optimized": "quality-optimized";
-            "cost-optimized": "cost-optimized";
-            "latency-optimized": "latency-optimized";
-        }> & z.core.$partial, z.ZodString>>;
         activeProfile: z.ZodOptional<z.ZodString>;
         advisorProfile: z.ZodOptional<z.ZodString>;
         defaultProvider: z.ZodCatch<z.ZodOptional<z.ZodObject<{
@@ -1312,8 +1337,8 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         id: z.ZodString;
         conversationId: z.ZodString;
         status: z.ZodEnum<{
-            cancelled: "cancelled";
             completed: "completed";
+            cancelled: "cancelled";
             failed: "failed";
         }>;
         exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -2264,6 +2289,34 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
                 mayRequireJavaScript: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        answeredQuestion: z.ZodOptional<z.ZodObject<{
+            requestId: z.ZodString;
+            questions: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                question: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                options: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodString;
+                    description: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                freeTextPlaceholder: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            responses: z.ZodArray<z.ZodObject<{
+                questionId: z.ZodString;
+                decision: z.ZodEnum<{
+                    option: "option";
+                    free_text: "free_text";
+                    skipped: "skipped";
+                }>;
+                optionId: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            overall: z.ZodEnum<{
+                completed: "completed";
+                closed: "closed";
+            }>;
+        }, z.core.$strip>>;
         errorCode: z.ZodOptional<z.ZodString>;
         completedAt: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
@@ -2700,8 +2753,8 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodString;
     conversationId: z.ZodString;
     status: z.ZodEnum<{
-        cancelled: "cancelled";
         completed: "completed";
+        cancelled: "cancelled";
         failed: "failed";
     }>;
     exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -3652,6 +3705,34 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             mayRequireJavaScript: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    answeredQuestion: z.ZodOptional<z.ZodObject<{
+        requestId: z.ZodString;
+        questions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            question: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            options: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            freeTextPlaceholder: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        responses: z.ZodArray<z.ZodObject<{
+            questionId: z.ZodString;
+            decision: z.ZodEnum<{
+                option: "option";
+                free_text: "free_text";
+                skipped: "skipped";
+            }>;
+            optionId: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        overall: z.ZodEnum<{
+            completed: "completed";
+            closed: "closed";
+        }>;
+    }, z.core.$strip>>;
     errorCode: z.ZodOptional<z.ZodString>;
     completedAt: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
@@ -4939,8 +5020,8 @@ declare const messageMetadataSchema: z.ZodObject<{
         command: z.ZodString;
         startedAt: z.ZodNumber;
         status: z.ZodEnum<{
-            cancelled: "cancelled";
             completed: "completed";
+            cancelled: "cancelled";
             failed: "failed";
         }>;
         exitCode: z.ZodNullable<z.ZodNumber>;
@@ -5628,12 +5709,10 @@ declare type ResolutionFallbackReason = "missing" | "disabled" | "incomplete";
  *   2. `llm.activeProfile` — `mainAgent` only, since it IS that call site's
  *      user-facing chat-model selection
  *   3. `llm.callSites[callSite].profile` (the call site's named profile)
- *   4. `CALL_SITE_DEFAULTS[callSite].profile` intent, remapped through
- *      `llm.defaultProfileOverrides[intent]` when set, otherwise resolved
- *      through `llm.defaultProvider`
- *   5. balanced intent (same remap consult) through `llm.defaultProvider`:
- *      the code-owned anchor for profileless call sites, or when nothing
- *      above is usable
+ *   4. `CALL_SITE_DEFAULTS[callSite].profile` intent resolved through
+ *      `llm.defaultProvider`
+ *   5. balanced intent through `llm.defaultProvider`: the code-owned anchor
+ *      for profileless call sites, or when nothing above is usable
  *
  * A winner must carry its own `provider` AND `model`: the base layer's schema
  * default identity never stands in for a selected profile. The anchor is
@@ -6868,6 +6947,14 @@ export declare interface ToolExecutionResult {
     /** Structured activity metadata for client rendering (web search, web fetch, etc).
      *  Populated by daemon-internal tools; plugins must not set this. */
     activityMetadata?: ToolActivityMetadata;
+    /**
+     * Typed side channel from the `ask_question` executor to the agent loop: the
+     * questions asked and the answers the user gave. The loop forwards it on the
+     * `tool_result` event and persists it on the tool_use block, so the answered
+     * card renders live and survives a history reopen instead of the decision
+     * disappearing with the interactive prompt. Set only by `ask_question`.
+     */
+    answeredQuestion?: AnsweredQuestion;
 }
 
 export declare interface ToolResultContent {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.11.1-dev.202608042034.3c87207",
+  "version": "0.11.1-dev.202608042130.2b7da8d",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",