@uug-ai/models 1.6.7 → 1.6.9

package/dist/types.d.ts

@@ -32744,7 +32744,43 @@ export interface components {
             name?: string;
             nodes?: components["schemas"]["models.WorkflowNode"][];
             organisation_id?: string;
+            /**
+             * @description Source is the workflow's provenance and availability (see WorkflowSource).
+             *     Empty means WorkflowSourceUser: an ordinary user workflow scoped to its
+             *     OrganisationId. WorkflowSourceConfig marks a helm-seeded, deployment-global,
+             *     read-only workflow. Every workflow persisted before this field existed
+             *     decodes as user.
+             */
+            source?: components["schemas"]["models.WorkflowSource"];
+            /**
+             * @description Stages is the workflow's executable stage set: the runtime-authoritative
+             *     projection the engine dispatches against. When set it is used as-is (config
+             *     workflows author it directly in the helm registry form: operation, dispatch,
+             *     needs, needsMode); when empty it is derived from Nodes+Edges on demand (UI
+             *     workflows author the graph and CompileStages projects it). Read it through
+             *     CompileStages, never directly, so both authoring styles resolve uniformly.
+             *
+             *     Only the routing fields (Operation, Dispatch, Needs, NeedsMode) are
+             *     meaningful here; a stage's deployment fields (image, queue, replicas, …) are
+             *     resolved by Operation against the shared deployed catalog, not per workflow.
+             *     Operations need only be unique within a single workflow, not globally.
+             */
+            stages?: components["schemas"]["models.WorkflowStage"][];
+            /**
+             * @description Trigger is the legacy single-trigger field kept only so workflows persisted
+             *     before Triggers existed still decode (and are not silently dropped on
+             *     re-save). New code should read and write Triggers; call NormalizeTriggers to
+             *     fold any legacy value into Triggers.
+             *
+             *     Deprecated: use Triggers.
+             */
             trigger?: components["schemas"]["models.WorkflowTrigger"];
+            /**
+             * @description Triggers is the set of activation modes for this workflow. A workflow may
+             *     carry both an automatic and a manual trigger so it runs on its own for
+             *     matching recordings and can also be launched on demand from a surface.
+             */
+            triggers?: components["schemas"]["models.WorkflowTrigger"][];
             updated_at?: number;
             user_id?: string;
             username?: string;
@@ -32842,6 +32878,16 @@ export interface components {
              *         disambiguate a dispatch from a result.
              */
             operation?: string;
+            /**
+             * @description Origin records how this run was opened — the run-side counterpart of the
+             *     Workflow's trigger Type. An automatic run was teed off the pipeline by
+             *     analysis for a matching recording; a manual run was launched on demand by a
+             *     user from a surface. The engine reads it to skip automatic selection/time
+             *     gating for on-demand runs; it is persisted so "all runs for a media key" can
+             *     be filtered by how they started. Empty is treated as automatic for runs
+             *     opened before origins existed.
+             */
+            origin?: components["schemas"]["models.WorkflowRunOrigin"];
             /**
              * @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
@@ -32898,6 +32944,12 @@ export interface components {
              *     is empty on the analysis hand-off — the run is keyed by Key until the
              *     engine opens it — and set on every engine→worker dispatch. The persisted
              *     identity is Id, so RunId itself is wire-only.
+             *
+             *     It is never set by hand: MarshalJSON derives it from Id whenever a run that
+             *     has been opened (its _id is set) is serialized, so a producer only has to
+             *     stamp Id and the two representations can never drift. A run without an Id
+             *     yet (the analysis hand-off) keeps whatever RunId it was given (normally
+             *     empty, so runId is omitted).
              */
             runId?: string;
             /**
@@ -32912,6 +32964,14 @@ export interface components {
              *     run's persisted state; a stage dispatched after a reload fetches via Storage.
              */
             signedUrl?: 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 Storage carries the credentials a dispatched stage worker needs to fetch
              *     the media (global Kerberos Storage plus any resolved per-recording vault
@@ -32947,6 +33007,10 @@ export interface components {
              */
             workflowName?: string;
         };
+        /** @enum {string} */
+        "models.WorkflowRunOrigin": "automatic" | "manual";
+        /** @enum {string} */
+        "models.WorkflowSource": "user" | "config";
         "models.WorkflowStage": {
             /** @description Description explains what the stage does, for the catalog UI. */
             description?: string;
@@ -33049,14 +33113,36 @@ export interface components {
             vaultOverrideUri?: string;
         };
         "models.WorkflowTrigger": {
-            endAt?: string;
-            /** @description Selection is the set of devices/streams the workflow applies to. */
-            selection?: string;
-            /** @description StartAt and EndAt bound a daily time window (e.g. "08:00"/"18:00"). */
-            startAt?: string;
-            /** @description Weekdays restricts the workflow to the listed days of week. */
-            weekdays?: number[];
+            /**
+             * @description Devices restricts the automatic trigger to recordings from the listed
+             *     devices, matched by DeviceKey.Key. An empty list means every device is
+             *     eligible. Mirrors the alert device selection (see CustomAlert.DevicesList).
+             */
+            devices?: components["schemas"]["models.DeviceKey"][];
+            /**
+             * @description Surfaces lists the UI surfaces a manual trigger can be launched from
+             *     (manual). Ignored for automatic triggers.
+             */
+            surfaces?: components["schemas"]["models.WorkflowTriggerSurface"][];
+            /**
+             * @description Type is the activation mode. An empty Type is treated as
+             *     WorkflowTriggerAutomatic for backwards compatibility with triggers authored
+             *     before manual triggers existed.
+             */
+            type?: components["schemas"]["models.WorkflowTriggerType"];
+            /**
+             * @description WeeklySchedule bounds the automatic trigger to recurring weekly windows,
+             *     each with its own day, time segments and IANA Timezone. An empty schedule
+             *     means any time is eligible. Reuses the alert weekly-schedule shape so the
+             *     same editor and evaluation semantics apply. The Timezone on each entry is
+             *     the user's timezone captured when the schedule was authored.
+             */
+            weeklySchedule?: components["schemas"]["models.WeeklySchedule"][];
         };
+        /** @enum {string} */
+        "models.WorkflowTriggerSurface": "case" | "media";
+        /** @enum {string} */
+        "models.WorkflowTriggerType": "automatic" | "manual";
         "models.WorkflowUser": {
             organisationId?: string;
             storage?: components["schemas"]["models.Storage"];

package/package.json

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