@vellumai/plugin-api 0.8.12-dev.202606150559.f5afe8b → 0.8.12-dev.202606150824.4ddebe7

package/index.d.ts

@@ -2163,6 +2163,7 @@ declare const LLMCallSiteEnum: z.ZodEnum<{
     trustRuleSuggestion: "trustRuleSuggestion";
     homeGreeting: "homeGreeting";
     homeSuggestedPrompts: "homeSuggestedPrompts";
+    workflowLeaf: "workflowLeaf";
 }>;
 
 /**
@@ -3163,7 +3164,7 @@ declare interface SensitiveOutputBinding {
 
 declare type SensitiveOutputKind = "invite_code";
 
-declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _WorkItemsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _GuardianActionsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _MeetServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _DiagnosticsServerMessages | _InboxServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BookmarksServerMessages | DiskPressureStatusChangedEvent | SubagentEvent;
+declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _WorkItemsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _GuardianActionsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _MeetServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _DiagnosticsServerMessages | _InboxServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | SubagentEvent;
 
 export declare interface ServerToolUseContent {
     type: "server_tool_use";
@@ -4533,6 +4534,60 @@ export declare interface WebSearchToolResultContent {
     content: unknown;
 }
 
+/**
+ * Terminal push for a workflow run. Carries the final status, counts, token
+ * usage, and a human-readable result/error summary the originating
+ * conversation also receives via an agent wake.
+ */
+declare interface WorkflowCompleted {
+    type: "workflow_completed";
+    runId: string;
+    status: WorkflowRunStatus;
+    agentsSpawned: number;
+    inputTokens: number;
+    outputTokens: number;
+    /** Human-readable result-or-error summary. */
+    summary?: string;
+}
+
+/**
+ * Progress push for an in-flight workflow run. Maps the engine's
+ * `onProgress` (`phase`/`log`) callback plus the current usage snapshot into a
+ * single wire event. `phase` carries the latest `phase(title)`; `message`
+ * carries the latest `log(msg)`; only one is set per emission.
+ */
+declare interface WorkflowProgress {
+    type: "workflow_progress";
+    runId: string;
+    /** Latest phase title, when this emission came from a `phase(...)` call. */
+    phase?: string;
+    /** Run label (the workflow's `meta.name`), for client display. */
+    label?: string;
+    /** Live agent count at emission time. */
+    agentsSpawned: number;
+    /** Latest log line, when this emission came from a `log(...)` call. */
+    message?: string;
+}
+
+/**
+ * Typed persistence for the workflow orchestration engine.
+ *
+ * Two tables (created by migration 282):
+ *
+ * - `workflow_runs` — one row per orchestration run (a sandboxed script that
+ *   spawns parallel leaf agents), tracking lifecycle status and token usage.
+ * - `workflow_journal` — append-only `(run_id, seq)` log of every leaf call
+ *   (agent / host function / nested workflow). On resume after a daemon
+ *   restart, the engine replays cached results for the unchanged call prefix
+ *   instead of re-spawning agents.
+ *
+ * This module is pure persistence — no `workflows` feature-flag logic. Callers
+ * (the engine, a later PR) own gating.
+ */
+declare type WorkflowRunStatus = "running" | "completed" | "failed" | "aborted" | "cap_exceeded" | "interrupted";
+
+declare type _WorkflowsServerMessages = WorkflowProgress | WorkflowCompleted;
+
 declare interface WorkItemApprovePermissionsResponse {
     type: "work_item_approve_permissions_response";
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.8.12-dev.202606150559.f5afe8b",
+  "version": "0.8.12-dev.202606150824.4ddebe7",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",