@vellumai/plugin-api 0.9.0-dev.202606181513.fd39213 → 0.9.0-dev.202606181735.ae6e1d8

package/index.d.ts

@@ -4802,6 +4802,13 @@ export declare interface WebSearchToolResultContent {
 declare interface WorkflowCompleted {
     type: "workflow_completed";
     runId: string;
+    /**
+     * Originating conversation id, when launched from one; lets `broadcastMessage`
+     * auto-scope + seq-stamp the event to that conversation's SSE stream. Omitted
+     * for a conversationless run (e.g. a scheduled workflow), which broadcasts
+     * unscoped for raw SSE listeners and the DB record.
+     */
+    conversationId?: string;
     status: WorkflowRunStatus;
     agentsSpawned: number;
     inputTokens: number;
@@ -4810,6 +4817,49 @@ declare interface WorkflowCompleted {
     summary?: string;
 }
 
+/**
+ * A leaf agent within a workflow run has finished. `seq` matches the
+ * corresponding `workflow_leaf_started` event.
+ */
+declare interface WorkflowLeafFinished {
+    type: "workflow_leaf_finished";
+    runId: string;
+    /**
+     * Originating conversation id; lets `broadcastMessage` auto-scope +
+     * seq-stamp the event to the conversation's SSE stream.
+     */
+    conversationId: string;
+    seq: number;
+    status: "completed" | "failed";
+    /** Leaf label, for client display. */
+    label?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    /** Short summary of the leaf's result, for client display. */
+    resultSummary?: string;
+}
+
+/**
+ * A leaf agent within a workflow run has started. `seq` orders leaves within
+ * the run for stable client-side tree placement.
+ */
+declare interface WorkflowLeafStarted {
+    type: "workflow_leaf_started";
+    runId: string;
+    /**
+     * Originating conversation id; lets `broadcastMessage` auto-scope +
+     * seq-stamp the event to the conversation's SSE stream.
+     */
+    conversationId: string;
+    seq: number;
+    /** Leaf label, for client display. */
+    label?: string;
+    /** Phase the leaf belongs to, when the workflow declares phases. */
+    phase?: string;
+    /** Short summary of the leaf's prompt, for client display. */
+    promptSummary?: string;
+}
+
 /**
  * Progress push for an in-flight workflow run. Maps the engine's
  * `onProgress` (`phase`/`log`) callback plus the current usage snapshot into a
@@ -4819,6 +4869,13 @@ declare interface WorkflowCompleted {
 declare interface WorkflowProgress {
     type: "workflow_progress";
     runId: string;
+    /**
+     * Originating conversation id, when launched from one; lets `broadcastMessage`
+     * auto-scope + seq-stamp the event to that conversation's SSE stream. Omitted
+     * for a conversationless run (e.g. a scheduled workflow), which broadcasts
+     * unscoped for raw SSE listeners and the DB record.
+     */
+    conversationId?: string;
     /** Latest phase title, when this emission came from a `phase(...)` call. */
     phase?: string;
     /** Run label (the workflow's `meta.name`), for client display. */
@@ -4846,7 +4903,27 @@ declare interface WorkflowProgress {
  */
 declare type WorkflowRunStatus = "running" | "completed" | "failed" | "aborted" | "cap_exceeded" | "interrupted";
 
-declare type _WorkflowsServerMessages = WorkflowProgress | WorkflowCompleted;
+declare type _WorkflowsServerMessages = WorkflowProgress | WorkflowCompleted | WorkflowStarted | WorkflowLeafStarted | WorkflowLeafFinished;
+
+/**
+ * A workflow run has started. Emitted once at launch, before any leaf events.
+ */
+declare interface WorkflowStarted {
+    type: "workflow_started";
+    runId: string;
+    /**
+     * Originating conversation id; lets `broadcastMessage` auto-scope +
+     * seq-stamp the event to the conversation's SSE stream.
+     */
+    conversationId: string;
+    /**
+     * Tool-use id of the `skill_execute` block that launched this run, for
+     * anchoring the inline workflow card to the exact spawn tool call.
+     */
+    toolUseId?: string;
+    /** Run label (the workflow's `meta.name`), for client display. */
+    label?: string;
+}
 
 declare interface WorkItemApprovePermissionsResponse {
     type: "work_item_approve_permissions_response";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.9.0-dev.202606181513.fd39213",
+  "version": "0.9.0-dev.202606181735.ae6e1d8",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",