@uug-ai/models 1.6.6 → 1.6.8

package/dist/types.d.ts

@@ -31085,6 +31085,19 @@ export interface components {
              * @example 507f1f77bcf86cd799439011
              */
             id?: string;
+            /**
+             * @description MediaKeys optionally pins this marker to specific recordings by their stable
+             *     key (media.videoFile). When set, the marker writer links the marker to
+             *     exactly these recordings — scoped to the marker's device and organisation —
+             *     instead of inferring the link from timestamp overlap. This is authoritative:
+             *     the producer (e.g. a stage worker) knows precisely which recording a
+             *     detection came from, so it is immune to timing/fps drift. Leave empty to keep
+             *     the default timestamp-overlap association.
+             * @example [
+             *       "1752482068_...device_1920_1080_10000.mp4"
+             *     ]
+             */
+            mediaKeys?: string[];
             /** @description Additional metadata */
             metadata?: components["schemas"]["models.MarkerMetadata"];
             /**
@@ -32731,7 +32744,21 @@ export interface components {
             name?: string;
             nodes?: components["schemas"]["models.WorkflowNode"][];
             organisation_id?: string;
+            /**
+             * @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;
@@ -32829,6 +32856,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
@@ -32885,6 +32922,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;
             /**
@@ -32899,6 +32942,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
@@ -32934,6 +32985,8 @@ export interface components {
              */
             workflowName?: string;
         };
+        /** @enum {string} */
+        "models.WorkflowRunOrigin": "automatic" | "manual";
         "models.WorkflowStage": {
             /** @description Description explains what the stage does, for the catalog UI. */
             description?: string;
@@ -33036,14 +33089,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.6",
+  "version": "1.6.8",
   "description": "TypeScript type definitions for Go models",
   "main": "dist/types.js",
   "types": "dist/types.d.ts",