@uug-ai/models 1.7.62 → 1.7.64

package/dist/types.d.ts

@@ -31437,6 +31437,45 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/internal/workflowrunoverview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get WorkflowRunOverview (schema generation only)
+         * @description Internal endpoint used only to ensure WorkflowRunOverview 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"]["api.WorkflowRunOverview"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/internal/workflowrunstage": {
         parameters: {
             query?: never;
@@ -31476,6 +31515,45 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/internal/workflowrunstagedecision": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get WorkflowRunStageDecision (schema generation only)
+         * @description Internal endpoint used only to ensure WorkflowRunStageDecision 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.WorkflowRunStageDecision"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/internal/workflowrunstageexecution": {
         parameters: {
             query?: never;
@@ -31554,6 +31632,45 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/internal/workflowrunstageneeddecision": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get WorkflowRunStageNeedDecision (schema generation only)
+         * @description Internal endpoint used only to ensure WorkflowRunStageNeedDecision 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.WorkflowRunStageNeedDecision"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/internal/workflowrunstatussummary": {
         parameters: {
             query?: never;
@@ -31593,6 +31710,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;
@@ -35037,7 +35193,7 @@ export interface components {
         };
         "api.ListWorkflowRunsResponse": {
             pagination?: components["schemas"]["api.CursorPagination"];
-            runs?: components["schemas"]["models.WorkflowRun"][];
+            runs?: components["schemas"]["api.WorkflowRunOverview"][];
             summary?: components["schemas"]["api.WorkflowRunStatusSummary"];
         };
         "api.ListWorkflowRunsSuccessResponse": {
@@ -35416,6 +35572,9 @@ export interface components {
         "api.RunWorkflowRequest": {
             attachmentIds?: string[];
             mediaIds?: string[];
+            /** @description Surface is case (the default) or redaction. The workflow must expose a
+             *     manual trigger on this surface; all case/media access checks still apply. */
+            surface?: components["schemas"]["models.WorkflowTriggerSurface"];
             workflowId?: string;
         };
         "api.RunWorkflowResponse": {
@@ -36282,6 +36441,33 @@ export interface components {
             to?: number;
             workflowIds?: string[];
         };
+        "api.WorkflowRunOverview": {
+            caseMediaId?: string;
+            deviceKey?: string;
+            deviceName?: string;
+            dispatched?: number;
+            durationMs?: number;
+            end?: number;
+            hasResults?: boolean;
+            key?: string;
+            mediaId?: string;
+            operations?: components["schemas"]["models.WorkflowRunOperationStatus"][];
+            origin?: components["schemas"]["models.WorkflowRunOrigin"];
+            recordingTimestamp?: number;
+            resolved?: number;
+            runId?: string;
+            /** @enum {string} */
+            sourceAccess?: "available" | "restricted" | "unavailable";
+            sourceLabel?: string;
+            sourceRef?: string;
+            /** @enum {string} */
+            sourceType?: "media" | "case";
+            stageExecutions?: components["schemas"]["models.WorkflowRunStageExecution"][];
+            start?: number;
+            state?: components["schemas"]["models.WorkflowRunState"];
+            workflowId?: string;
+            workflowName?: string;
+        };
         "api.WorkflowRunStatusSummary": {
             completed?: number;
             noResult?: number;
@@ -36310,7 +36496,7 @@ export interface components {
             userId?: string;
         };
         /** @enum {string} */
-        "models.AccessTokenScope": "media.read" | "media.update" | "media.export" | "media.share" | "media.redact" | "media.delete" | "application" | "workflow-runs.create" | "workflow-runs.read" | "workflow-runs.update" | "cases.read" | "cases.create" | "cases.update" | "cases.share" | "cases.export" | "cases.runWorkflow" | "cases.delete" | "days.read" | "markers.read" | "markers.write" | "markers.all" | "workflows.read" | "workflows.create" | "workflows.update" | "workflows.delete";
+        "models.AccessTokenScope": "days.read" | "markers.read" | "markers.write" | "markers.all" | "cases.read" | "cases.create" | "cases.update" | "cases.share" | "cases.export" | "cases.runWorkflow" | "cases.delete" | "media.read" | "media.update" | "media.export" | "media.share" | "media.redact" | "media.delete" | "workflows.read" | "workflows.create" | "workflows.update" | "workflows.delete" | "application" | "workflow-runs.create" | "workflow-runs.read" | "workflow-runs.update";
         "models.Account": {
             account?: components["schemas"]["models.AccountBody"];
         };
@@ -38762,7 +38948,7 @@ export interface components {
             videowall?: components["schemas"]["models.Videowall"];
         };
         /** @enum {string} */
-        "models.Permission": "media.read" | "media.update" | "media.export" | "media.share" | "media.redact" | "media.delete" | "application" | "workflow-runs.create" | "workflow-runs.read" | "workflow-runs.update" | "cases.read" | "cases.create" | "cases.update" | "cases.share" | "cases.export" | "cases.runWorkflow" | "cases.delete" | "days.read" | "markers.read" | "markers.write" | "markers.all" | "workflows.read" | "workflows.create" | "workflows.update" | "workflows.delete";
+        "models.Permission": "days.read" | "markers.read" | "markers.write" | "markers.all" | "cases.read" | "cases.create" | "cases.update" | "cases.share" | "cases.export" | "cases.runWorkflow" | "cases.delete" | "media.read" | "media.update" | "media.export" | "media.share" | "media.redact" | "media.delete" | "workflows.read" | "workflows.create" | "workflows.update" | "workflows.delete" | "application" | "workflow-runs.create" | "workflow-runs.read" | "workflow-runs.update";
         /** @enum {integer} */
         "models.PermissionLevel": 1 | 2 | 3 | 4 | 2 | 3 | 4 | 5 | 2 | 3 | 2 | 2 | 3 | 2 | 3 | 4;
         "models.Permissions": {
@@ -39118,6 +39304,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. */
@@ -39126,7 +39313,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;
@@ -40057,7 +40244,7 @@ export interface components {
             data?: {
                 [key: string]: unknown;
             };
-            /** @description Devices scopes a device node to recordings from these devices. Empty means
+            /** @description Devices scopes an automatic root to recordings from these devices. Empty means
              *     every device the workflow's owner can see. Ignored on stage nodes. */
             devices?: components["schemas"]["models.DeviceKey"][];
             /** @description Id is this instance's identity within the workflow. It is the stable
@@ -40067,15 +40254,19 @@ export interface components {
             label?: string;
             /** @description StageRef is the referenced stage's Operation key (the catalog key shared
              *     by platform- and user-defined stages), not its Mongo Id. Set on every
-             *     stage node and resolved at compile time; empty on a device node. */
+             *     stage node and resolved at compile time; empty on a root node. */
             stageRef?: string;
+            /** @description Trigger is required on Start nodes. Automatic settings and inactive manual
+             *     surface selections are retained here; NormalizeTriggers derives runtime
+             *     triggers without exposing inactive settings. */
+            trigger?: components["schemas"]["models.WorkflowTrigger"];
             /** @description Type is what the node represents; empty means WorkflowNodeStage. */
             type?: components["schemas"]["models.WorkflowNodeType"];
             x?: number;
             y?: number;
         };
         /** @enum {string} */
-        "models.WorkflowNodeType": "stage" | "device";
+        "models.WorkflowNodeType": "stage" | "device" | "start";
         "models.WorkflowPredicate": {
             op?: components["schemas"]["models.ConditionOp"];
             path?: string;
@@ -40094,6 +40285,7 @@ export interface components {
             stage?: components["schemas"]["models.WorkflowStageReference"];
         };
         "models.WorkflowRun": {
+            caseMediaId?: string;
             /** @description Device identifies the recording the run derives from, with the few fields
              *     vault-override resolution and logging need (device key/name and where the
              *     media is stored/served from). Copied from the recording at hand-off time.
@@ -40111,7 +40303,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
@@ -40146,6 +40337,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
@@ -40224,12 +40426,17 @@ export interface components {
              *     and short-lived, so — like Storage — it is wire-only and never lands in the
              *     run's persisted state; a stage dispatched after a reload fetches via Storage. */
             signedUrl?: string;
+            sourceAccess?: string;
+            sourceLabel?: string;
             /** @description SourceRef ties a manual run back to the thing it was launched from — e.g.
              *     the case id when launched from a case surface — so sibling runs fanned out
              *     from one user action (one seed per selected media key) can be grouped above
              *     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 SourceType disambiguates case launches from media launch-group references.
+             *     Legacy readers infer case ownership from SourceRef and case input metadata. */
+            sourceType?: string;
             /** @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.
@@ -40241,13 +40448,9 @@ export interface components {
              *     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 (unix seconds). They remain for
-             *     compatibility with existing runs and list indexes. */
+            /** @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"];
@@ -40261,6 +40464,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
@@ -40279,6 +40487,8 @@ export interface components {
             workflowName?: string;
         };
         /** @enum {string} */
+        "models.WorkflowRunDecisionOutcome": "passed" | "failed" | "waiting" | "notEvaluated";
+        /** @enum {string} */
         "models.WorkflowRunOperationState": "dispatched" | "resolved";
         "models.WorkflowRunOperationStatus": {
             operation?: string;
@@ -40297,6 +40507,11 @@ export interface components {
             operation?: string;
             queue?: string;
         };
+        "models.WorkflowRunStageDecision": {
+            eligible?: boolean;
+            evaluatedAtMs?: number;
+            needs?: components["schemas"]["models.WorkflowRunStageNeedDecision"][];
+        };
         "models.WorkflowRunStageExecution": {
             dependencies?: string[];
             dispatchAttempts?: number;
@@ -40311,6 +40526,10 @@ export interface components {
             state?: components["schemas"]["models.WorkflowRunStageState"];
         };
         "models.WorkflowRunStageExecutionDetails": {
+            /** @description Decision is the latest captured routing evaluation while waiting, then the
+             *     decision associated with dispatch. Nil means no decision was captured.
+             *     Writers preserve the dispatch decision; readers never infer it from state. */
+            decision?: components["schemas"]["models.WorkflowRunStageDecision"];
             dispatchAttempts?: number;
             dispatchedAtMs?: number;
             durationMs?: number;
@@ -40320,10 +40539,23 @@ export interface components {
             resolvedAtMs?: number;
             state?: components["schemas"]["models.WorkflowRunStageState"];
         };
+        "models.WorkflowRunStageNeedDecision": {
+            index?: number;
+            outcome?: components["schemas"]["models.WorkflowRunDecisionOutcome"];
+        };
         /** @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": {
@@ -40788,8 +41020,11 @@ export declare namespace models {
     type WorkflowRun = components['schemas']['models.WorkflowRun'];
     type WorkflowRunOperationStatus = components['schemas']['models.WorkflowRunOperationStatus'];
     type WorkflowRunStage = components['schemas']['models.WorkflowRunStage'];
+    type WorkflowRunStageDecision = components['schemas']['models.WorkflowRunStageDecision'];
     type WorkflowRunStageExecution = components['schemas']['models.WorkflowRunStageExecution'];
     type WorkflowRunStageExecutionDetails = components['schemas']['models.WorkflowRunStageExecutionDetails'];
+    type WorkflowRunStageNeedDecision = components['schemas']['models.WorkflowRunStageNeedDecision'];
+    type WorkflowRunTriggerMatch = components['schemas']['models.WorkflowRunTriggerMatch'];
     type WorkflowStage = components['schemas']['models.WorkflowStage'];
     type WorkflowStageReference = components['schemas']['models.WorkflowStageReference'];
     type WorkflowStorage = components['schemas']['models.WorkflowStorage'];
@@ -41260,5 +41495,6 @@ export declare namespace api {
     type WarningResponse = components['schemas']['api.WarningResponse'];
     type WorkflowFilter = components['schemas']['api.WorkflowFilter'];
     type WorkflowRunFilter = components['schemas']['api.WorkflowRunFilter'];
+    type WorkflowRunOverview = components['schemas']['api.WorkflowRunOverview'];
     type WorkflowRunStatusSummary = components['schemas']['api.WorkflowRunStatusSummary'];
 }

package/package.json

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