@uug-ai/models 1.7.61 → 1.7.63

package/dist/types.d.ts

@@ -31437,6 +31437,45 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/internal/workflowrunstage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get WorkflowRunStage (schema generation only)
+         * @description Internal endpoint used only to ensure WorkflowRunStage schema is generated in OpenAPI spec
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["models.WorkflowRunStage"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/internal/workflowrunstageexecution": {
         parameters: {
             query?: never;
@@ -31476,6 +31515,45 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/internal/workflowrunstageexecutiondetails": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get WorkflowRunStageExecutionDetails (schema generation only)
+         * @description Internal endpoint used only to ensure WorkflowRunStageExecutionDetails schema is generated in OpenAPI spec
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["models.WorkflowRunStageExecutionDetails"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/internal/workflowrunstatussummary": {
         parameters: {
             query?: never;
@@ -31515,6 +31593,45 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/internal/workflowruntriggermatch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get WorkflowRunTriggerMatch (schema generation only)
+         * @description Internal endpoint used only to ensure WorkflowRunTriggerMatch schema is generated in OpenAPI spec
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["models.WorkflowRunTriggerMatch"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/internal/workflowstage": {
         parameters: {
             query?: never;
@@ -36232,7 +36349,7 @@ export interface components {
             userId?: string;
         };
         /** @enum {string} */
-        "models.AccessTokenScope": "days.read" | "media.read" | "media.update" | "media.export" | "media.share" | "media.redact" | "media.delete" | "cases.read" | "cases.create" | "cases.update" | "cases.share" | "cases.export" | "cases.runWorkflow" | "cases.delete" | "workflow-runs.create" | "workflow-runs.read" | "workflow-runs.update" | "markers.read" | "markers.write" | "markers.all" | "application" | "workflows.read" | "workflows.create" | "workflows.update" | "workflows.delete";
+        "models.AccessTokenScope": "media.read" | "media.update" | "media.export" | "media.share" | "media.redact" | "media.delete" | "cases.read" | "cases.create" | "cases.update" | "cases.share" | "cases.export" | "cases.runWorkflow" | "cases.delete" | "workflow-runs.create" | "workflow-runs.read" | "workflow-runs.update" | "workflows.read" | "workflows.create" | "workflows.update" | "workflows.delete" | "days.read" | "application" | "markers.read" | "markers.write" | "markers.all";
         "models.Account": {
             account?: components["schemas"]["models.AccountBody"];
         };
@@ -38684,7 +38801,7 @@ export interface components {
             videowall?: components["schemas"]["models.Videowall"];
         };
         /** @enum {string} */
-        "models.Permission": "days.read" | "media.read" | "media.update" | "media.export" | "media.share" | "media.redact" | "media.delete" | "cases.read" | "cases.create" | "cases.update" | "cases.share" | "cases.export" | "cases.runWorkflow" | "cases.delete" | "workflow-runs.create" | "workflow-runs.read" | "workflow-runs.update" | "markers.read" | "markers.write" | "markers.all" | "application" | "workflows.read" | "workflows.create" | "workflows.update" | "workflows.delete";
+        "models.Permission": "media.read" | "media.update" | "media.export" | "media.share" | "media.redact" | "media.delete" | "cases.read" | "cases.create" | "cases.update" | "cases.share" | "cases.export" | "cases.runWorkflow" | "cases.delete" | "workflow-runs.create" | "workflow-runs.read" | "workflow-runs.update" | "workflows.read" | "workflows.create" | "workflows.update" | "workflows.delete" | "days.read" | "application" | "markers.read" | "markers.write" | "markers.all";
         /** @enum {integer} */
         "models.PermissionLevel": 1 | 2 | 3 | 4 | 2 | 3 | 4 | 5 | 2 | 3 | 2 | 2 | 3 | 2 | 3 | 4;
         "models.Permissions": {
@@ -39040,6 +39157,7 @@ export interface components {
         "models.StageParam": {
             /** @description Default is applied when a node supplies no value for this parameter. */
             default?: unknown;
+            description?: string;
             label?: string;
             name?: string;
             /** @description Options enumerates the permitted values when Type is StageParamSelect. */
@@ -39048,7 +39166,7 @@ export interface components {
             type?: components["schemas"]["models.StageParamType"];
         };
         /** @enum {string} */
-        "models.StageParamType": "string" | "number" | "boolean" | "select";
+        "models.StageParamType": "string" | "number" | "boolean" | "select" | "secret";
         "models.StagePort": {
             label?: string;
             name?: string;
@@ -40033,7 +40151,6 @@ export interface components {
             dispatchedOperations?: string[];
             durationMs?: number;
             end?: number;
-            endedAtMs?: number;
             hasResults?: boolean;
             /** @description Inputs is the immutable start context the run opens with, keyed by the
              *     upstream operation that produced it (e.g. "classify" → the classification
@@ -40068,6 +40185,17 @@ export interface components {
              *     be filtered by how they started. Empty is treated as automatic for runs
              *     opened before origins existed. */
             origin?: components["schemas"]["models.WorkflowRunOrigin"];
+            /** @description Params carries the per-placement parameter values the workflow editor
+             *     stored for the dispatched stage (WorkflowNode.Data, declared by the
+             *     stage's WorkflowStage.Params). The engine resolves them from the workflow
+             *     definition on every engine→worker dispatch, so a worker such as the
+             *     forwarder can let a tenant override deployment defaults. Values may include
+             *     StageParamSecret credentials, so `bson:"-"` is load-bearing — like Storage,
+             *     they never persist in run state — and a worker must never echo them back
+             *     or copy them into anything it forwards. */
+            params?: {
+                [key: string]: unknown;
+            };
             /** @description Payload is the self-describing block envelope a delegated-ingest worker
              *     hands back for the platform to persist: one or more typed blocks (e.g. a
              *     "detection" block carrying a PostDetectionsRequest, optionally followed by
@@ -40152,30 +40280,20 @@ export interface components {
              *     the run. Empty for automatic runs. It generalises to any run-grouping handle
              *     (a case id today; a temporal device-series id is a forward-looking twin). */
             sourceRef?: string;
-            /** @description StageExecutions is the bounded stage plan and execution summary used by run
-             *     detail surfaces. The compiled routing plan already occupies the JSON
-             *     "stages" field, so the execution timeline has its own unambiguous name.
-             *     Sparse queue messages leave this field empty. */
+            /** @description StageExecutions reads the legacy split timeline. NormalizeStages moves
+             *     matched summaries into Stages, retaining unmatched history without
+             *     reconstructing missing routing. Serialization does not normalize implicitly.
+             *     Deprecated: new writers use Stages[i].Execution. */
             stageExecutions?: components["schemas"]["models.WorkflowRunStageExecution"][];
-            /** @description Stages is the run's self-describing routing: the compiled stage set of the
-             *     workflow this run executes (the output of Workflow.CompileStages) embedded
-             *     on the hand-off so the engine can dispatch a workflow it does not hold in
-             *     its boot-loaded config registry — a user/DB workflow launched manually.
-             *     Only routing fields are meaningful here (Operation, Dispatch, Needs,
-             *     NeedsMode; Queue when the source workflow set one); the engine compiles
-             *     these into the same validated registry a config workflow gets. Empty is the
-             *     legacy/config path: the engine falls back to the config registry keyed by
-             *     WorkflowId, so config workflows and older hand-offs are unchanged. It is
-             *     persisted so the return path — a stage result reopening the run on any
-             *     replica — resolves the same routing without re-fetching the definition. */
-            stages?: components["schemas"]["models.WorkflowStage"][];
-            /** @description Start and End stamp the run's lifecycle (unix seconds). They remain for
-             *     compatibility with existing runs and list indexes. */
+            /** @description Stages captures the run's compiled rules and per-stage execution facts.
+             *     New writers use NewWorkflowRunStages after resolving queues and defaults.
+             *     Legacy routing-only elements decode unchanged; NormalizeStages joins any
+             *     split lifecycle summaries. Nil means no captured routing (legacy fallback);
+             *     an explicit empty slice is an authoritative zero-stage plan. */
+            stages?: components["schemas"]["models.WorkflowRunStage"][];
+            /** @description Start and End stamp the run's lifecycle in Unix milliseconds. Readers
+             *     normalize legacy runs whose values were persisted in Unix seconds. */
             start?: number;
-            /** @description StartedAtMs and EndedAtMs are the millisecond-precision counterparts of the
-             *     legacy Start and End fields. New writers populate both pairs; readers fall
-             *     back to Start/End for runs created before these fields existed. */
-            startedAtMs?: number;
             /** @description The fields below are API read projections. They are derived or joined by
              *     the service after loading a run and never persist back into workflow state. */
             state?: components["schemas"]["models.WorkflowRunState"];
@@ -40189,6 +40307,11 @@ export interface components {
             /** @description TraceId continues the distributed trace across the workflow tail and lets
              *     authorized detail surfaces correlate the durable run with telemetry. */
             traceId?: string;
+            /** @description TriggerMatch records the first automatic trigger that selected this run.
+             *     It is immutable engine-owned provenance, not stage execution state. Nil
+             *     means no captured match (legacy or a launch that bypassed automatic matching).
+             *     Readers must not reconstruct it from Origin or today's workflow definition. */
+            triggerMatch?: components["schemas"]["models.WorkflowRunTriggerMatch"];
             /** @description User is the curated, secret-free account context a run needs: the
              *     organisation that owns the recording (for logging/scoping) and the account
              *     Storage block used to resolve a per-recording vault override. Copied (and
@@ -40214,6 +40337,17 @@ export interface components {
         };
         /** @enum {string} */
         "models.WorkflowRunOrigin": "automatic" | "manual";
+        "models.WorkflowRunStage": {
+            dispatch?: components["schemas"]["models.Dispatch"];
+            /** @description A non-nil execution, including {}, takes precedence over the entire legacy
+             *     summary. Missing execution means lifecycle facts may still live there. */
+            execution?: components["schemas"]["models.WorkflowRunStageExecutionDetails"];
+            name?: string;
+            needs?: components["schemas"]["models.StageDependency"][];
+            needsMode?: components["schemas"]["models.NeedsMode"];
+            operation?: string;
+            queue?: string;
+        };
         "models.WorkflowRunStageExecution": {
             dependencies?: string[];
             dispatchAttempts?: number;
@@ -40227,10 +40361,29 @@ export interface components {
             resolvedAtMs?: number;
             state?: components["schemas"]["models.WorkflowRunStageState"];
         };
+        "models.WorkflowRunStageExecutionDetails": {
+            dispatchAttempts?: number;
+            dispatchedAtMs?: number;
+            durationMs?: number;
+            firstDispatchAttemptAtMs?: number;
+            lastDispatchAttemptAtMs?: number;
+            lastDispatchErrorCode?: string;
+            resolvedAtMs?: number;
+            state?: components["schemas"]["models.WorkflowRunStageState"];
+        };
         /** @enum {string} */
         "models.WorkflowRunStageState": "waiting" | "retrying" | "dispatched" | "resolved" | "dispatchFailed" | "timedOut" | "skipped";
         /** @enum {string} */
         "models.WorkflowRunState": "running" | "completed" | "noResult";
+        "models.WorkflowRunTriggerMatch": {
+            /** @description EvaluatedAtMs is the Unix-millisecond instant used for schedule matching
+             *     (usually recording time), not when the engine processed or opened the run. */
+            evaluatedAtMs?: number;
+            /** @description Index is zero-based in the normalized trigger list at selection time.
+             *     It is historical context, not a stable ID into an edited definition. */
+            index?: number;
+            trigger?: components["schemas"]["models.WorkflowTrigger"];
+        };
         /** @enum {string} */
         "models.WorkflowSource": "user" | "config";
         "models.WorkflowStage": {
@@ -40694,7 +40847,10 @@ export declare namespace models {
     type WorkflowResult = components['schemas']['models.WorkflowResult'];
     type WorkflowRun = components['schemas']['models.WorkflowRun'];
     type WorkflowRunOperationStatus = components['schemas']['models.WorkflowRunOperationStatus'];
+    type WorkflowRunStage = components['schemas']['models.WorkflowRunStage'];
     type WorkflowRunStageExecution = components['schemas']['models.WorkflowRunStageExecution'];
+    type WorkflowRunStageExecutionDetails = components['schemas']['models.WorkflowRunStageExecutionDetails'];
+    type WorkflowRunTriggerMatch = components['schemas']['models.WorkflowRunTriggerMatch'];
     type WorkflowStage = components['schemas']['models.WorkflowStage'];
     type WorkflowStageReference = components['schemas']['models.WorkflowStageReference'];
     type WorkflowStorage = components['schemas']['models.WorkflowStorage'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uug-ai/models",
-  "version": "1.7.61",
+  "version": "1.7.63",
   "description": "TypeScript type definitions for Go models",
   "main": "dist/types.js",
   "types": "dist/types.d.ts",