@artu-ai/compliance-sdk 0.13.3 → 0.14.0

package/dist/models/Product.js

@@ -64,24 +64,24 @@ export class Product extends BaseModel {
         return this._data.tags ?? [];
     }
     // ─────────────────────────────────────────────────────────────────
-    // Jurisdiction
+    // Scope
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Checks if product has data for a specific jurisdiction
+     * Checks if product has data for a specific scope
      */
-    hasJurisdiction(jurisdiction) {
-        if (!this._data.jurisdictions)
+    hasScope(scope) {
+        if (!this._data.scopeData)
             return false;
-        return jurisdiction in this._data.jurisdictions;
+        return scope in this._data.scopeData;
     }
     /**
-     * Raw jurisdiction data object
+     * Raw scope data object
      */
-    get jurisdictions() {
-        return this._data.jurisdictions ?? {};
+    get scopeData() {
+        return this._data.scopeData ?? {};
     }
     /**
-     * Raw data for jurisdiction-specific access
+     * Raw data for scope-specific access
      */
     get data() {
         return this._data;

package/dist/models/Transaction.d.ts

@@ -4,14 +4,14 @@
  * Pure data model with no API calls.
  * Provides type-safe access to common transaction properties.
  */
-import type { BaseTransaction, EmbeddedTag, Jurisdiction, RiskAssessmentSnapshot, RiskAssessments } from "@artu-ai/shared";
+import type { EmbeddedTag, RelatedClient, RiskAssessmentSnapshot, RiskAssessments, Scope, TransactionResponse } from "@artu-ai/shared";
 import { TransactionStatus } from "@artu-ai/shared";
 import { BaseModel } from "./base";
 /**
  * Transaction data as returned from the API.
  * Extends the base schema with server-generated fields.
  */
-export interface TransactionData extends Omit<BaseTransaction, "timestamp"> {
+export interface TransactionData extends Omit<TransactionResponse, "timestamp"> {
     id: string;
     timestamp: string;
     createdAt: string;
@@ -26,7 +26,7 @@ export interface TransactionData extends Omit<BaseTransaction, "timestamp"> {
  * Base Transaction Model.
  *
  * Pure data model with no API calls.
- * Extended by jurisdiction-specific models (MexTransaction, etc.).
+ * Extended by scope-specific models (MexTransaction, etc.).
  *
  * @example
  * ```typescript
@@ -69,6 +69,13 @@ export declare class Transaction extends BaseModel<TransactionData> {
      * IDs of clients related to this transaction
      */
     get relatedClientIds(): string[];
+    /**
+     * Per-link client payload (with `role` + `metadata`) when the API
+     * populated it — `retrieve` and mutation responses include this.
+     * List endpoints may return only `relatedClientIds` for cost reasons,
+     * in which case this getter returns the same set with no role/metadata.
+     */
+    get relatedClients(): RelatedClient[];
     /**
      * Whether this transaction is referenced by at least one active alert item
      */
@@ -98,13 +105,13 @@ export declare class Transaction extends BaseModel<TransactionData> {
      */
     get tags(): EmbeddedTag[];
     /**
-     * Checks if transaction has data for a specific jurisdiction
+     * Checks if transaction has data for a specific scope
      */
-    hasJurisdiction(jurisdiction: Jurisdiction): boolean;
+    hasScope(scope: Scope): boolean;
     /**
-     * Raw jurisdiction data object
+     * Raw scope data object
      */
-    get jurisdictions(): BaseTransaction["jurisdictions"];
+    get scopeData(): TransactionResponse["scopeData"];
     /**
      * Raw risk assessments map — keyed by assessment name, each value is an
      * append-only array of snapshots representing the assessment history.
@@ -154,7 +161,9 @@ export declare class Transaction extends BaseModel<TransactionData> {
      */
     riskAssessmentDisplayScore(): {
         score: number;
+        minScore: number;
         maxScore: number;
+        label?: string;
     } | undefined;
     /** Find the most recently calculated snapshot across all assessments */
     private _latestRiskSnapshot;

package/dist/models/Transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transaction.d.ts","sourceRoot":"","sources":["../../src/models/Transaction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Transaction.d.ts","sourceRoot":"","sources":["../../src/models/Transaction.ts"],"names":[],"mappings":"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"}

package/dist/models/Transaction.js

@@ -9,15 +9,16 @@ import { BaseModel } from "./base";
 // ===========================
 // Utilities
 // ===========================
-function applyRiskRounding(value, mode) {
+function applyRiskRounding(value, mode, decimalPlaces = 0) {
+    const factor = Math.pow(10, decimalPlaces);
     switch (mode) {
         case "floor":
-            return Math.floor(value);
+            return Math.floor(value * factor) / factor;
         case "round":
-            return Math.round(value);
+            return Math.round(value * factor) / factor;
         case "ceil":
         default:
-            return Math.ceil(value);
+            return Math.ceil(value * factor) / factor;
     }
 }
 // ===========================
@@ -27,7 +28,7 @@ function applyRiskRounding(value, mode) {
  * Base Transaction Model.
  *
  * Pure data model with no API calls.
- * Extended by jurisdiction-specific models (MexTransaction, etc.).
+ * Extended by scope-specific models (MexTransaction, etc.).
  *
  * @example
  * ```typescript
@@ -105,6 +106,16 @@ export class Transaction extends BaseModel {
     get relatedClientIds() {
         return this._data.relatedClientIds ?? [];
     }
+    /**
+     * Per-link client payload (with `role` + `metadata`) when the API
+     * populated it — `retrieve` and mutation responses include this.
+     * List endpoints may return only `relatedClientIds` for cost reasons,
+     * in which case this getter returns the same set with no role/metadata.
+     */
+    get relatedClients() {
+        return (this._data.relatedClients ??
+            this.relatedClientIds.map((clientId) => ({ clientId })));
+    }
     /**
      * Whether this transaction is referenced by at least one active alert item
      */
@@ -136,7 +147,7 @@ export class Transaction extends BaseModel {
         return this._data.productId;
     }
     // ─────────────────────────────────────────────────────────────────
-    // Jurisdiction
+    // Scope
     // ─────────────────────────────────────────────────────────────────
     /**
      * Scopes this transaction belongs to (e.g. ["MX", "MX:AV:AVI"]).
@@ -151,18 +162,18 @@ export class Transaction extends BaseModel {
         return this._data.tags ?? [];
     }
     /**
-     * Checks if transaction has data for a specific jurisdiction
+     * Checks if transaction has data for a specific scope
      */
-    hasJurisdiction(jurisdiction) {
-        if (!this._data.jurisdictions)
+    hasScope(scope) {
+        if (!this._data.scopeData)
             return false;
-        return jurisdiction in this._data.jurisdictions;
+        return scope in this._data.scopeData;
     }
     /**
-     * Raw jurisdiction data object
+     * Raw scope data object
      */
-    get jurisdictions() {
-        return this._data.jurisdictions ?? {};
+    get scopeData() {
+        return this._data.scopeData ?? {};
     }
     // ─────────────────────────────────────────────────────────────────
     // Risk Assessments
@@ -238,12 +249,24 @@ export class Transaction extends BaseModel {
         const snapshot = this._latestRiskSnapshot();
         if (!snapshot)
             return undefined;
+        const minScore = snapshot.minScore ?? 0;
         const maxScore = snapshot.maxScore ?? 100;
         const mode = snapshot.roundingMode ?? "ceil";
-        return {
-            score: applyRiskRounding(snapshot.overall * maxScore, mode),
-            maxScore,
-        };
+        const dp = snapshot.decimalPlaces ?? 0;
+        const score = applyRiskRounding(minScore + snapshot.overall * (maxScore - minScore), mode, dp);
+        let label;
+        if (snapshot.riskLevels && snapshot.riskLevels.length > 0) {
+            const sorted = [...snapshot.riskLevels].sort((a, b) => a.maxValue - b.maxValue);
+            for (const level of sorted) {
+                if (score <= level.maxValue) {
+                    label = level.label;
+                    break;
+                }
+            }
+            if (!label)
+                label = sorted[sorted.length - 1]?.label;
+        }
+        return { score, minScore, maxScore, label };
     }
     /** Find the most recently calculated snapshot across all assessments */
     _latestRiskSnapshot() {

package/dist/models/Workflow.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Workflow Model
+ *
+ * Pure data model for monitoring workflows.
+ * Workflows define triggers and visual graphs for the workflow engine.
+ */
+import { type EmbeddedTag, type WorkflowGraph, type WorkflowResponse, type WorkflowStatus, type WorkflowTrigger } from "@artu-ai/shared";
+import { BaseModel } from "./base";
+export type WorkflowData = WorkflowResponse;
+/**
+ * Workflow model - represents a monitoring workflow.
+ *
+ * A workflow consists of:
+ * - Trigger: When the workflow fires (event or schedule)
+ * - Graph: A visual DAG of nodes (source, transform, condition, action)
+ */
+export declare class Workflow extends BaseModel<WorkflowData> {
+    get id(): string;
+    get organizationId(): string;
+    get environment(): "test" | "live";
+    get name(): string;
+    get description(): string | undefined;
+    get externalId(): string | undefined;
+    get status(): WorkflowStatus;
+    get trigger(): WorkflowTrigger | null;
+    /** ID of the trigger node within the workflow graph, if any. */
+    get triggerNodeId(): string | null;
+    get workflow(): WorkflowGraph;
+    get metadata(): Record<string, unknown> | undefined;
+    /**
+     * Tags applied to this workflow.
+     */
+    get tags(): EmbeddedTag[];
+    get createdAt(): Date;
+    get updatedAt(): Date;
+    /**
+     * Whether this is an event-triggered workflow
+     */
+    get isEventTrigger(): boolean;
+    /**
+     * Whether this is a schedule-triggered workflow
+     */
+    get isScheduleTrigger(): boolean;
+    /**
+     * Whether this is a manual-triggered workflow
+     */
+    get isManualTrigger(): boolean;
+    /**
+     * Whether this is a manual file-triggered workflow
+     */
+    get isManualFileTrigger(): boolean;
+    /**
+     * Whether this is a form-link-triggered workflow (shareable URL).
+     * These workflows can't be run with "Run Now" — they start when
+     * an external user visits a workflow link.
+     */
+    get isFormLinkTrigger(): boolean;
+    /**
+     * Whether this is an API-triggered workflow. External callers POST to
+     * a public URL minted via `createApiEndpoint` to start a run.
+     */
+    get isApiTrigger(): boolean;
+    /**
+     * Whether this is a workflow-completion-triggered workflow — runs
+     * when another workflow finishes. Manual "Run Now" simulates the
+     * upstream completion with no parent execution attached.
+     */
+    get isWorkflowCompletionTrigger(): boolean;
+    /**
+     * Whether the workflow is active
+     */
+    get isActive(): boolean;
+    /**
+     * Whether the workflow is in draft status
+     */
+    get isDraft(): boolean;
+    /**
+     * Whether the workflow is inactive
+     */
+    get isInactive(): boolean;
+    /**
+     * ID of the corresponding live workflow (only set on test workflows after promotion)
+     */
+    get liveWorkflowId(): string | null | undefined;
+    /**
+     * ID of the source test workflow (only set on live workflows after promotion)
+     */
+    get testWorkflowId(): string | null | undefined;
+    /**
+     * Timestamp of last promotion
+     */
+    get promotedAt(): Date | undefined;
+    /**
+     * Whether this workflow has been promoted to live
+     */
+    get isPromoted(): boolean;
+    /**
+     * Whether this is a live environment workflow
+     */
+    get isLiveWorkflow(): boolean;
+    /**
+     * Whether this is a test environment workflow
+     */
+    get isTestWorkflow(): boolean;
+    toString(): string;
+}
+export declare function isWorkflow(value: unknown): value is Workflow;
+//# sourceMappingURL=Workflow.d.ts.map

package/dist/models/Workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Workflow.d.ts","sourceRoot":"","sources":["../../src/models/Workflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACN,KAAK,WAAW,EAEhB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAM5C;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,SAAS,CAAC,YAAY,CAAC;IACpD,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,MAAM,CAEjC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,IAAI,MAAM,IAAI,cAAc,CAE3B;IAED,IAAI,OAAO,IAAI,eAAe,GAAG,IAAI,CAEpC;IAED,gEAAgE;IAChE,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAKjC;IAED,IAAI,QAAQ,IAAI,aAAa,CAE5B;IAED,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAElD;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,EAAE,CAExB;IAED,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMD;;OAEG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED;;;;OAIG;IACH,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED;;;OAGG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;OAIG;IACH,IAAI,2BAA2B,IAAI,OAAO,CAEzC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAE9C;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAE9C;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,IAAI,GAAG,SAAS,CAEjC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAEQ,QAAQ,IAAI,MAAM;CAG3B;AAMD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D"}

package/dist/models/Workflow.js

@@ -0,0 +1,180 @@
+/**
+ * Workflow Model
+ *
+ * Pure data model for monitoring workflows.
+ * Workflows define triggers and visual graphs for the workflow engine.
+ */
+import { getTriggerFromWorkflow, } from "@artu-ai/shared";
+import { BaseModel } from "./base";
+// ===========================
+// Workflow Model
+// ===========================
+/**
+ * Workflow model - represents a monitoring workflow.
+ *
+ * A workflow consists of:
+ * - Trigger: When the workflow fires (event or schedule)
+ * - Graph: A visual DAG of nodes (source, transform, condition, action)
+ */
+export class Workflow extends BaseModel {
+    get id() {
+        return this._data.id;
+    }
+    get organizationId() {
+        return this._data.organizationId;
+    }
+    get environment() {
+        return this._data.environment;
+    }
+    get name() {
+        return this._data.name;
+    }
+    get description() {
+        return this._data.description;
+    }
+    get externalId() {
+        return this._data.externalId;
+    }
+    get status() {
+        return this._data.status;
+    }
+    get trigger() {
+        return getTriggerFromWorkflow(this._data.workflow);
+    }
+    /** ID of the trigger node within the workflow graph, if any. */
+    get triggerNodeId() {
+        const node = this._data.workflow.nodes.find((n) => n.type.startsWith("trigger."));
+        return node?.id ?? null;
+    }
+    get workflow() {
+        return this._data.workflow;
+    }
+    get metadata() {
+        return this._data.metadata;
+    }
+    /**
+     * Tags applied to this workflow.
+     */
+    get tags() {
+        return this._data.tags ?? [];
+    }
+    get createdAt() {
+        return new Date(this._data.createdAt);
+    }
+    get updatedAt() {
+        return new Date(this._data.updatedAt);
+    }
+    // ===========================
+    // Derived Properties
+    // ===========================
+    /**
+     * Whether this is an event-triggered workflow
+     */
+    get isEventTrigger() {
+        return this.trigger?.type === "event";
+    }
+    /**
+     * Whether this is a schedule-triggered workflow
+     */
+    get isScheduleTrigger() {
+        return this.trigger?.type === "schedule";
+    }
+    /**
+     * Whether this is a manual-triggered workflow
+     */
+    get isManualTrigger() {
+        return this.trigger?.type === "manual";
+    }
+    /**
+     * Whether this is a manual file-triggered workflow
+     */
+    get isManualFileTrigger() {
+        return this.trigger?.type === "manual_file";
+    }
+    /**
+     * Whether this is a form-link-triggered workflow (shareable URL).
+     * These workflows can't be run with "Run Now" — they start when
+     * an external user visits a workflow link.
+     */
+    get isFormLinkTrigger() {
+        return this.trigger?.type === "form_link";
+    }
+    /**
+     * Whether this is an API-triggered workflow. External callers POST to
+     * a public URL minted via `createApiEndpoint` to start a run.
+     */
+    get isApiTrigger() {
+        return this.trigger?.type === "api";
+    }
+    /**
+     * Whether this is a workflow-completion-triggered workflow — runs
+     * when another workflow finishes. Manual "Run Now" simulates the
+     * upstream completion with no parent execution attached.
+     */
+    get isWorkflowCompletionTrigger() {
+        return this.trigger?.type === "workflow_completion";
+    }
+    /**
+     * Whether the workflow is active
+     */
+    get isActive() {
+        return this._data.status === "active";
+    }
+    /**
+     * Whether the workflow is in draft status
+     */
+    get isDraft() {
+        return this._data.status === "draft";
+    }
+    /**
+     * Whether the workflow is inactive
+     */
+    get isInactive() {
+        return this._data.status === "inactive";
+    }
+    /**
+     * ID of the corresponding live workflow (only set on test workflows after promotion)
+     */
+    get liveWorkflowId() {
+        return this._data.liveWorkflowId;
+    }
+    /**
+     * ID of the source test workflow (only set on live workflows after promotion)
+     */
+    get testWorkflowId() {
+        return this._data.testWorkflowId;
+    }
+    /**
+     * Timestamp of last promotion
+     */
+    get promotedAt() {
+        return this._data.promotedAt ? new Date(this._data.promotedAt) : undefined;
+    }
+    /**
+     * Whether this workflow has been promoted to live
+     */
+    get isPromoted() {
+        return !!this._data.liveWorkflowId;
+    }
+    /**
+     * Whether this is a live environment workflow
+     */
+    get isLiveWorkflow() {
+        return this._data.environment === "live";
+    }
+    /**
+     * Whether this is a test environment workflow
+     */
+    get isTestWorkflow() {
+        return this._data.environment === "test";
+    }
+    toString() {
+        return `Workflow(${this.name}, ${this.status}, ${this.trigger?.type ?? "unknown"})`;
+    }
+}
+// ===========================
+// Type Guards
+// ===========================
+export function isWorkflow(value) {
+    return value instanceof Workflow;
+}

package/dist/models/WorkflowExecution.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Workflow Execution Model
+ *
+ * Pure data model for workflow execution records.
+ * Executions are append-only records of workflow engine runs.
+ */
+import type { NodeTrace, WorkflowExecutionResponse, WorkflowGraph, WorkflowTrace, WorkflowWarning } from "@artu-ai/shared";
+import { BaseModel } from "./base";
+export type WorkflowExecutionData = WorkflowExecutionResponse;
+/**
+ * WorkflowExecution model - represents a single workflow execution result.
+ */
+export declare class WorkflowExecution extends BaseModel<WorkflowExecutionData> {
+    get id(): string;
+    get organizationId(): string;
+    get environment(): "test" | "live";
+    get workflowId(): string;
+    get eventId(): string;
+    get triggerType(): string;
+    get entityType(): string | null;
+    get entityId(): string | null;
+    get eventType(): string | null;
+    get status(): string;
+    get error(): string | null;
+    get alertIds(): string[];
+    get durationMs(): number | null;
+    get inputs(): Record<string, unknown> | null;
+    get resolvedVariables(): Record<string, unknown> | null;
+    get workflowTrace(): WorkflowTrace | null;
+    get nodeTraces(): NodeTrace[];
+    get workflowSnapshot(): WorkflowGraph | null;
+    /**
+     * Structured warnings emitted by node executors during this run.
+     * Surfaced on the execution-detail UI; persisted to
+     * `workflow_executions.warnings`.
+     */
+    get warnings(): WorkflowWarning[];
+    get createdAt(): Date;
+    get completedAt(): Date | null;
+    get hasError(): boolean;
+    get createdAlert(): boolean;
+    toString(): string;
+}
+export declare function isWorkflowExecution(value: unknown): value is WorkflowExecution;
+//# sourceMappingURL=WorkflowExecution.d.ts.map

package/dist/models/WorkflowExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowExecution.d.ts","sourceRoot":"","sources":["../../src/models/WorkflowExecution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,SAAS,EACT,yBAAyB,EACzB,aAAa,EACb,aAAa,EACb,eAAe,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAM9D;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS,CAAC,qBAAqB,CAAC;IACtE,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,MAAM,CAEjC;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE3C;IAED,IAAI,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEtD;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,IAAI,CAExC;IAED,IAAI,UAAU,IAAI,SAAS,EAAE,CAE5B;IAED,IAAI,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAE3C;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,eAAe,EAAE,CAEhC;IAED,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED,IAAI,WAAW,IAAI,IAAI,GAAG,IAAI,CAE7B;IAMD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAEQ,QAAQ,IAAI,MAAM;CAG3B;AAMD,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,iBAAiB,CAE5B"}

package/dist/models/{RuleEvaluation.js → WorkflowExecution.js}

@@ -1,17 +1,17 @@
 /**
- * Rule Evaluation Model
+ * Workflow Execution Model
  *
- * Pure data model for rule evaluation records.
- * Evaluations are append-only records of rule engine runs.
+ * Pure data model for workflow execution records.
+ * Executions are append-only records of workflow engine runs.
  */
 import { BaseModel } from "./base";
 // ===========================
-// RuleEvaluation Model
+// WorkflowExecution Model
 // ===========================
 /**
- * RuleEvaluation model - represents a single rule evaluation result.
+ * WorkflowExecution model - represents a single workflow execution result.
  */
-export class RuleEvaluation extends BaseModel {
+export class WorkflowExecution extends BaseModel {
     get id() {
         return this._data.id;
     }
@@ -21,8 +21,8 @@ export class RuleEvaluation extends BaseModel {
     get environment() {
         return this._data.environment;
     }
-    get ruleId() {
-        return this._data.ruleId;
+    get workflowId() {
+        return this._data.workflowId;
     }
     get eventId() {
         return this._data.eventId;
@@ -39,8 +39,8 @@ export class RuleEvaluation extends BaseModel {
     get eventType() {
         return this._data.eventType;
     }
-    get matched() {
-        return this._data.matched;
+    get status() {
+        return this._data.status;
     }
     get error() {
         return this._data.error;
@@ -66,9 +66,20 @@ export class RuleEvaluation extends BaseModel {
     get workflowSnapshot() {
         return this._data.workflowTrace?.workflowSnapshot ?? null;
     }
+    /**
+     * Structured warnings emitted by node executors during this run.
+     * Surfaced on the execution-detail UI; persisted to
+     * `workflow_executions.warnings`.
+     */
+    get warnings() {
+        return this._data.warnings ?? [];
+    }
     get createdAt() {
         return new Date(this._data.createdAt);
     }
+    get completedAt() {
+        return this._data.completedAt ? new Date(this._data.completedAt) : null;
+    }
     // ===========================
     // Derived Properties
     // ===========================
@@ -79,12 +90,12 @@ export class RuleEvaluation extends BaseModel {
         return this._data.alertIds.length > 0;
     }
     toString() {
-        return `RuleEvaluation(${this.id}, matched=${this.matched})`;
+        return `WorkflowExecution(${this.id}, hasError=${this.hasError})`;
     }
 }
 // ===========================
 // Type Guards
 // ===========================
-export function isRuleEvaluation(value) {
-    return value instanceof RuleEvaluation;
+export function isWorkflowExecution(value) {
+    return value instanceof WorkflowExecution;
 }