@epilot/sdk 2.20.57 → 2.20.59

package/definitions/integration-toolkit-runtime.json

@@ -1 +1 @@
-{"s":"https://integration-toolkit.sls.epilot.io","o":[["acknowledgeTracking","post","/v1/erp/tracking/acknowledgement",null,1],["triggerErp","post","/v1/erp/trigger",null,1],["processErpUpdatesEvents","post","/v1/erp/updates/events",null,1],["processErpUpdatesEventsV2","post","/v2/erp/updates/events",null,1],["processErpUpdatesEventsV3","post","/v3/erp/updates/events",null,1],["simulateMappingV2","post","/v2/erp/updates/mapping_simulation",null,1],["simulateDirect","post","/v1/erp/updates/direct_simulation",null,1],["simulateMapping","post","/v1/erp/updates/mapping_simulation",null,1],["listIntegrations","get","/v1/integrations"],["createIntegration","post","/v1/integrations",null,1],["getIntegration","get","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegration","put","/v1/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegration","delete","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["queryEvents","post","/v1/integrations/{integrationId}/events",[["integrationId","p",true]],1],["replayEvents","post","/v1/integrations/{integrationId}/events/replay",[["integrationId","p",true]],1],["listUseCases","get","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]]],["createUseCase","post","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]],1],["getUseCase","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["updateUseCase","put","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]],1],["deleteUseCase","delete","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["listUseCaseHistory","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}/history",[["integrationId","p",true],["useCaseId","p",true],["cursor","q"]]],["listDocumentationPages","get","/v1/integrations/{integrationId}/documentation",[["integrationId","p",true]]],["getDocumentationPage","get","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]]],["upsertDocumentationPage","put","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]],1],["deleteDocumentationPage","delete","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]]],["listIntegrationsV2","get","/v2/integrations"],["createIntegrationV2","post","/v2/integrations",null,1],["getIntegrationV2","get","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegrationV2","put","/v2/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegrationV2","delete","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["listNotificationHistory","get","/v2/integrations/{integrationId}/notifications/history",[["integrationId","p",true],["cursor","q"],["limit","q"],["type","q"]]],["testSendNotification","post","/v2/integrations/{integrationId}/notifications/test",[["integrationId","p",true]],1],["getNotificationStatus","get","/v2/integrations/{integrationId}/notifications/status",[["integrationId","p",true],["include","q"]]],["getSecureProxyWhitelist","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]]],["updateSecureProxyWhitelist","put","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]],1],["listSecureProxyWhitelistHistory","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist/history",[["integrationId","p",true],["useCaseId","p",true],["limit","q"]]],["setIntegrationAppMapping","put","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["deleteIntegrationAppMapping","delete","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["queryInboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/inbound-events",[["integrationId","p",true]],1],["getMonitoringStats","post","/v1/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeries","post","/v1/integrations/{integrationId}/monitoring/timeseries",[["integrationId","p",true]],1],["getOutboundStatus","get","/v1/integrations/{integrationId}/outbound-status",[["integrationId","p",true]]],["getEntitySyncStatus","get","/v1/integrations/entities/{entityId}/sync-status",[["entityId","p",true],["integration_id","q"]]],["pollOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/poll",[["integrationId","p",true]],1],["ackOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/ack",[["integrationId","p",true]],1],["listOutboundDlqMessages","get","/v1/integrations/{integrationId}/outbound/messages/dlq",[["integrationId","p",true],["limit","q"],["next_token","q"]]],["redriveOutboundDlqMessages","post","/v1/integrations/{integrationId}/outbound/messages/dlq/redrive",[["integrationId","p",true]],1],["unblockOutboundStream","post","/v1/integrations/{integrationId}/outbound/messages/unblock",[["integrationId","p",true]],1],["simulateOutboundMapping","post","/v1/integrations/{integrationId}/outbound/mapping-simulation",[["integrationId","p",true]],1],["queryAccessLogs","post","/v1/integrations/{integrationId}/monitoring/access-logs",[["integrationId","p",true]],1],["queryOutboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/outbound-events",[["integrationId","p",true]],1],["queryMonitoringEventsV2","post","/v2/integrations/{integrationId}/monitoring/events",[["integrationId","p",true]],1],["getMonitoringStatsV2","post","/v2/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeriesV2","post","/v2/integrations/{integrationId}/monitoring/time-series",[["integrationId","p",true]],1],["getAssociatedMonitoringEvents","get","/v2/integrations/{integrationId}/monitoring/events/{eventId}/associated",[["integrationId","p",true],["eventId","p",true]]],["ingestExternalMonitoringEvents","post","/v2/integrations/{integrationId}/monitoring/external-events",[["integrationId","p",true]],1],["getMonitoringTraceByCorrelation","get","/v2/integrations/{integrationId}/monitoring/traces/{correlationId}",[["integrationId","p",true],["correlationId","p",true]]],["listSecureProxies","get","/v1/integrations/secure-proxies"],["secureProxy","post","/v1/secure-proxy",null,1],["managedCallExecute","post","/v1/managed-call/{slug}/execute",[["slug","p",true]],1],["generateTypesPreview","post","/v1/integrations/{integrationId}/generate-types-preview",[["integrationId","p",true]]],["generateTypes","post","/v1/integrations/{integrationId}/generate-types",[["integrationId","p",true]],1],["commitTypes","post","/v1/integrations/{integrationId}/commit-types",[["integrationId","p",true]],1],["createErpImport","post","/v2/erp/imports",null,1],["listErpImports","get","/v2/erp/imports",[["limit","q"],["cursor","q"]]],["getErpImport","get","/v2/erp/imports/{importId}",[["importId","p",true]]],["deleteErpImport","delete","/v2/erp/imports/{importId}",[["importId","p",true]]],["getErpImportPreview","get","/v2/erp/imports/{importId}/preview",[["importId","p",true]]],["downloadErpImportFile","get","/v2/erp/imports/{importId}/download",[["importId","p",true]]],["validateErpImport","post","/v2/erp/imports/{importId}:validate",[["importId","p",true]],1],["suggestErpImportUseCases","post","/v2/erp/imports/{importId}:suggest-use-cases",[["importId","p",true]]],["executeErpImport","post","/v2/erp/imports/{importId}:execute",[["importId","p",true]],1],["abortErpImport","post","/v2/erp/imports/{importId}:abort",[["importId","p",true]]]],"v":"3.0.3"}
+{"s":"https://integration-toolkit.sls.epilot.io","o":[["acknowledgeTracking","post","/v1/erp/tracking/acknowledgement",null,1],["triggerErp","post","/v1/erp/trigger",null,1],["processErpUpdatesEvents","post","/v1/erp/updates/events",null,1],["processErpUpdatesEventsV2","post","/v2/erp/updates/events",null,1],["processErpUpdatesEventsV3","post","/v3/erp/updates/events",null,1],["simulateMappingV2","post","/v2/erp/updates/mapping_simulation",null,1],["simulateDirect","post","/v1/erp/updates/direct_simulation",null,1],["simulateMapping","post","/v1/erp/updates/mapping_simulation",null,1],["listIntegrations","get","/v1/integrations"],["createIntegration","post","/v1/integrations",null,1],["getIntegration","get","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegration","put","/v1/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegration","delete","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["queryEvents","post","/v1/integrations/{integrationId}/events",[["integrationId","p",true]],1],["replayEvents","post","/v1/integrations/{integrationId}/events/replay",[["integrationId","p",true]],1],["listUseCases","get","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]]],["createUseCase","post","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]],1],["getUseCase","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["updateUseCase","put","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]],1],["deleteUseCase","delete","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["listUseCaseHistory","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}/history",[["integrationId","p",true],["useCaseId","p",true],["cursor","q"]]],["listDocumentationPages","get","/v1/integrations/{integrationId}/documentation",[["integrationId","p",true]]],["getDocumentationPage","get","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]]],["upsertDocumentationPage","put","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]],1],["deleteDocumentationPage","delete","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]]],["listIntegrationsV2","get","/v2/integrations"],["createIntegrationV2","post","/v2/integrations",null,1],["getIntegrationV2","get","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegrationV2","put","/v2/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegrationV2","delete","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["listNotificationHistory","get","/v2/integrations/{integrationId}/notifications/history",[["integrationId","p",true],["cursor","q"],["limit","q"],["type","q"]]],["testSendNotification","post","/v2/integrations/{integrationId}/notifications/test",[["integrationId","p",true]],1],["getNotificationStatus","get","/v2/integrations/{integrationId}/notifications/status",[["integrationId","p",true],["include","q"]]],["getSecureProxyWhitelist","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]]],["updateSecureProxyWhitelist","put","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]],1],["listSecureProxyWhitelistHistory","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist/history",[["integrationId","p",true],["useCaseId","p",true],["limit","q"]]],["setIntegrationAppMapping","put","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["deleteIntegrationAppMapping","delete","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["queryInboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/inbound-events",[["integrationId","p",true]],1],["getMonitoringStats","post","/v1/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeries","post","/v1/integrations/{integrationId}/monitoring/timeseries",[["integrationId","p",true]],1],["getOutboundStatus","get","/v1/integrations/{integrationId}/outbound-status",[["integrationId","p",true]]],["getEntitySyncStatus","get","/v1/integrations/entities/{entityId}/sync-status",[["entityId","p",true],["integration_id","q"]]],["pollOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/poll",[["integrationId","p",true]],1],["ackOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/ack",[["integrationId","p",true]],1],["listOutboundDlqMessages","get","/v1/integrations/{integrationId}/outbound/messages/dlq",[["integrationId","p",true],["limit","q"],["next_token","q"]]],["redriveOutboundDlqMessages","post","/v1/integrations/{integrationId}/outbound/messages/dlq/redrive",[["integrationId","p",true]],1],["unblockOutboundStream","post","/v1/integrations/{integrationId}/outbound/messages/unblock",[["integrationId","p",true]],1],["simulateOutboundMapping","post","/v1/integrations/{integrationId}/outbound/mapping-simulation",[["integrationId","p",true]],1],["queryAccessLogs","post","/v1/integrations/{integrationId}/monitoring/access-logs",[["integrationId","p",true]],1],["queryOutboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/outbound-events",[["integrationId","p",true]],1],["queryMonitoringEventsV2","post","/v2/integrations/{integrationId}/monitoring/events",[["integrationId","p",true]],1],["getMonitoringStatsV2","post","/v2/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeriesV2","post","/v2/integrations/{integrationId}/monitoring/time-series",[["integrationId","p",true]],1],["getAssociatedMonitoringEvents","get","/v2/integrations/{integrationId}/monitoring/events/{eventId}/associated",[["integrationId","p",true],["eventId","p",true]]],["ingestExternalMonitoringEvents","post","/v2/integrations/{integrationId}/monitoring/external-events",[["integrationId","p",true]],1],["getMonitoringTraceByCorrelation","get","/v2/integrations/{integrationId}/monitoring/traces/{correlationId}",[["integrationId","p",true],["correlationId","p",true]]],["getMonitoringRunCompletionV2","post","/v2/integrations/{integrationId}/monitoring/runs/completion",[["integrationId","p",true]],1],["listSecureProxies","get","/v1/integrations/secure-proxies"],["secureProxy","post","/v1/secure-proxy",null,1],["managedCallExecute","post","/v1/managed-call/{slug}/execute",[["slug","p",true]],1],["generateTypesPreview","post","/v1/integrations/{integrationId}/generate-types-preview",[["integrationId","p",true]]],["generateTypes","post","/v1/integrations/{integrationId}/generate-types",[["integrationId","p",true]],1],["commitTypes","post","/v1/integrations/{integrationId}/commit-types",[["integrationId","p",true]],1],["createErpImport","post","/v2/erp/imports",null,1],["listErpImports","get","/v2/erp/imports",[["limit","q"],["cursor","q"]]],["getErpImport","get","/v2/erp/imports/{importId}",[["importId","p",true]]],["deleteErpImport","delete","/v2/erp/imports/{importId}",[["importId","p",true]]],["getErpImportPreview","get","/v2/erp/imports/{importId}/preview",[["importId","p",true]]],["downloadErpImportFile","get","/v2/erp/imports/{importId}/download",[["importId","p",true]]],["validateErpImport","post","/v2/erp/imports/{importId}:validate",[["importId","p",true]],1],["suggestErpImportUseCases","post","/v2/erp/imports/{importId}:suggest-use-cases",[["importId","p",true]]],["executeErpImport","post","/v2/erp/imports/{importId}:execute",[["importId","p",true]],1],["abortErpImport","post","/v2/erp/imports/{importId}:abort",[["importId","p",true]]]],"v":"3.0.3"}

package/definitions/integration-toolkit.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Integration Toolkit API",
-    "version": "1.43.0",
+    "version": "1.45.0",
     "description": "API for integrating with external systems in a standardised way."
   },
   "tags": [
@@ -4162,6 +4162,68 @@
         }
       }
     },
+    "/v2/integrations/{integrationId}/monitoring/runs/completion": {
+      "post": {
+        "operationId": "getMonitoringRunCompletionV2",
+        "x-epilot-permissions": [
+          {
+            "action": "integration:view"
+          }
+        ],
+        "summary": "getMonitoringRunCompletionV2",
+        "description": "Per-event completion of one or more runs (every monitoring event sharing a\n`correlation_id`), each reduced to \"how many events have reached a final\noutcome, and how many are still going\". Unlike `getMonitoringStatsV2`, which\ncounts rows, this groups `erp_monitoring_v2` by `event_id` first: an event\nretried twice and then processed counts once, as a success.\n\nPer event: it is **settled** once it has a `success` row, a terminal `error`\nrow (a non-retryable failure, retries exhausted, or the dead-letter closure),\nor nothing but informational rows (deduplicated, skipped). A `warning` never\nsettles an event on its own: mapping and relation caveats are written BEFORE\nthe final stage's success row, and a retry marker (`warning` with\n`will_retry: true`) means the queue will deliver it again. Everything else is\n**in flight**. A settled event's outcome is its worst terminal row — `error`\nbeats `warning` beats `success`.\n\nBatched so a history page costs one request: pass every run on the page. A run\nthat has reported nothing yet comes back with `seen: 0`, never omitted.\n\nThe denominator is NOT here: the producer owns it. For an ERP file import it is\n`ErpImportProgress.events_published`; `seen` is how many of those have reported\nanything yet. Freshness is near-real-time (ClickHouse ingestion lag).\n",
+        "tags": [
+          "monitoring",
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/GetMonitoringRunCompletionV2Request"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Per-event completion, one entry per requested run.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MonitoringRunCompletionV2Response"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v1/integrations/secure-proxies": {
       "get": {
         "operationId": "listSecureProxies",
@@ -5479,6 +5541,10 @@
           "total_rows": {
             "type": "integer",
             "description": "Rows in the file. Known only once a phase has read to EOF; the execute phase has it from the start, because validate recorded it first."
+          },
+          "events_published": {
+            "type": "integer",
+            "description": "Events handed to the platform so far — the denominator for \"has everything this run dispatched finished processing?\", answered per event by `getMonitoringRunCompletionV2` under the job's `correlation_id`. Equals `processed_rows` on the flat path; smaller on the grouped path, where rows sharing a variant-version collapse into one event. Execute phase only, and absent on jobs written before this field existed."
           }
         }
       },
@@ -13035,6 +13101,122 @@
           }
         }
       },
+      "GetMonitoringRunCompletionV2Request": {
+        "type": "object",
+        "required": [
+          "correlation_ids"
+        ],
+        "properties": {
+          "correlation_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The runs to report on — an import's `import_id` is its `correlation_id`. At least one; a history page's worth (tens, not thousands) is the intended batch."
+          }
+        }
+      },
+      "MonitoringRunCompletionV2Response": {
+        "type": "object",
+        "required": [
+          "runs"
+        ],
+        "properties": {
+          "runs": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MonitoringRunCompletionV2"
+            },
+            "description": "One entry per requested `correlation_id`, in request order."
+          }
+        }
+      },
+      "MonitoringRunCompletionV2": {
+        "type": "object",
+        "description": "Per-event completion of one run. Every count is in EVENTS (distinct `event_id`), never rows: `seen = in_flight + success + warning + error + info`.",
+        "required": [
+          "correlation_id",
+          "seen",
+          "in_flight",
+          "retrying",
+          "success",
+          "warning",
+          "error",
+          "info",
+          "entries",
+          "last_activity_at"
+        ],
+        "properties": {
+          "correlation_id": {
+            "type": "string"
+          },
+          "seen": {
+            "type": "integer",
+            "description": "Distinct events that have reported at least one row under this run."
+          },
+          "in_flight": {
+            "type": "integer",
+            "description": "Events that have reported something but no final outcome yet: only mapping or relation caveats so far (the success row comes last, from the final stage), or a failed attempt the queue will retry. An event stuck here with an old `last_activity_at` was most likely lost on its final attempt (processor crash) — a stall, not a slow run."
+          },
+          "retrying": {
+            "type": "integer",
+            "description": "The subset of `in_flight` whose latest row is a retry marker — the queue will deliver them again after a temporary failure."
+          },
+          "success": {
+            "type": "integer",
+            "description": "Settled events whose terminal rows were all successes."
+          },
+          "warning": {
+            "type": "integer",
+            "description": "Settled events processed with a caveat (unique-id matched several entities, attribute type mismatch, …) and no terminal error. Retry markers are not caveats and are never counted here."
+          },
+          "error": {
+            "type": "integer",
+            "description": "Settled events with at least one terminal error row (retries exhausted, or non-retryable)."
+          },
+          "info": {
+            "type": "integer",
+            "description": "Settled events whose rows were all informational — deduplicated or skipped, nothing to apply."
+          },
+          "entries": {
+            "$ref": "#/components/schemas/MonitoringRunEntriesV2"
+          },
+          "last_activity_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "Newest row of any level under this run; null when nothing has reported yet."
+          }
+        }
+      },
+      "MonitoringRunEntriesV2": {
+        "type": "object",
+        "description": "The run's monitoring rows counted by level, retry markers included — the same rows its trace lists. Unlike the event counts above, one event can contribute many rows (one per entity written, plus every caveat and retry).",
+        "required": [
+          "total",
+          "error",
+          "warning",
+          "success",
+          "info"
+        ],
+        "properties": {
+          "total": {
+            "type": "integer"
+          },
+          "error": {
+            "type": "integer"
+          },
+          "warning": {
+            "type": "integer"
+          },
+          "success": {
+            "type": "integer"
+          },
+          "info": {
+            "type": "integer"
+          }
+        }
+      },
       "MonitoringStatsV2": {
         "type": "object",
         "required": [

package/definitions/validation-rules-runtime.json

@@ -1 +1 @@
-{"s":"https://validation-rules.sls.epilot.io","o":[["getValidationRules","get","/v1/validation-rules"],["createValidationRule","post","/v1/validation-rules",null,1],["getValidationRuleById","get","/v1/validation-rules/{ruleId}",[["ruleId","p",true]]],["updateValidationRule","patch","/v1/validation-rules/{ruleId}",[["ruleId","p",true]],1],["deleteValidationRule","delete","/v1/validation-rules/{ruleId}",[["ruleId","p",true]]],["addUsedByReference","post","/v1/validation-rules/{ruleId}/used-by",[["ruleId","p",true]],1],["removeUsedByReference","delete","/v1/validation-rules/{ruleId}/used-by",[["ruleId","p",true]],1]],"v":"3.0.3"}
+{"s":"","o":[["getValidationRules","get","/v1/validation-rules"],["createValidationRule","post","/v1/validation-rules",null,1],["getValidationRuleById","get","/v1/validation-rules/{ruleId}",[["ruleId","p",true]]],["updateValidationRule","patch","/v1/validation-rules/{ruleId}",[["ruleId","p",true]],1],["deleteValidationRule","delete","/v1/validation-rules/{ruleId}",[["ruleId","p",true]]],["addUsedByReference","post","/v1/validation-rules/{ruleId}/used-by",[["ruleId","p",true]],1],["removeUsedByReference","delete","/v1/validation-rules/{ruleId}/used-by",[["ruleId","p",true]],1]],"v":"3.0.3"}

package/definitions/validation-rules.json

@@ -2143,9 +2143,23 @@
           }
         ]
       },
+      "ValueReference": {
+        "description": "A value resolved at evaluation time instead of written into the rule, identified by\n`source`. Each field that accepts a reference lists the sources it allows; a rule using\nany other source is rejected when it is saved.\n",
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/ContextValue"
+          },
+          {
+            "$ref": "#/components/schemas/EnvironmentValue"
+          },
+          {
+            "$ref": "#/components/schemas/ExternalValue"
+          }
+        ]
+      },
       "EnvironmentValue": {
         "type": "object",
-        "description": "A comparison value resolved at evaluation time from an organisation environment variable\n(environments-api). The rule stores the key, never the value, so one change to the variable\nreaches every rule that references it and a blueprint install never overwrites the\norganisation's own value.\n\nOnly browser-safe variable types are allowed: `Number` for numeric comparisons, `Text` for\ntext comparisons and for dates (ISO 8601 string), `Boolean` for `applies_when` values.\n`String` and `SecretString` variables are rejected at write time. Write-time validation also\nchecks that the variable exists in the organisation; a variable that exists without a value\n(for example seeded by a blueprint install) is accepted and resolves as unavailable until set.\n",
+        "description": "A comparison value resolved at evaluation time from an organisation environment variable\n(environments-api). The rule stores the key, never the value, so one change to the variable\nreaches every rule that references it and a blueprint install never overwrites the\norganisation's own value.\n\nOnly browser-safe variable types are allowed: `Number` for numeric comparisons, adjustment\namounts and relative-date offsets, `Text` for text comparisons and for dates (ISO 8601\nstring), `Boolean` for `applies_when` values.\n`String` and `SecretString` variables are rejected at write time. Write-time validation also\nchecks that the variable exists in the organisation; a variable that exists without a value\n(for example seeded by a blueprint install) is accepted and resolves as unavailable until set.\n",
         "required": [
           "source",
           "key"
@@ -2286,17 +2300,14 @@
             ]
           },
           "value": {
-            "description": "The adjustment amount - a fixed number, or a context path resolving to a number\n(e.g. a per-contract percentage limit). Contextual adjustment values must not\ncarry a nested adjustment.\n",
+            "description": "The adjustment amount - a fixed non-negative number, or a reference resolving to a\nnumber at evaluation time. Accepted reference sources: `context` (e.g. a per-contract\npercentage limit) and `environment` (a `Number` organisation environment variable).\nAny other source is rejected at write time, and the reference must not carry its own\n`adjust`.\n",
             "oneOf": [
               {
                 "type": "number",
                 "minimum": 0
               },
               {
-                "$ref": "#/components/schemas/ContextValue"
-              },
-              {
-                "$ref": "#/components/schemas/EnvironmentValue"
+                "$ref": "#/components/schemas/ValueReference"
               }
             ]
           },
@@ -2313,7 +2324,7 @@
               "up",
               "down"
             ],
-            "description": "Rounds the adjusted result to a whole number - `up` (ceiling) or `down` (floor).\nOmitted means no rounding. Used for bounds like \"round up(current \u00d7 0.9) to whole euros\".\n"
+            "description": "Rounds the adjusted result to a whole number - `up` (ceiling) or `down` (floor).\nOmitted means no rounding. Used for bounds like \"round up(current × 0.9) to whole euros\".\n"
           }
         }
       },
@@ -2334,10 +2345,17 @@
             ]
           },
           "offset": {
-            "type": "integer",
-            "minimum": -36500,
-            "maximum": 36500,
-            "description": "Offset from the anchor. Negative values are in the past, positive in the future, 0 is the anchor itself."
+            "description": "Offset from the anchor. Negative values are in the past, positive in the future, 0 is the anchor itself.\nEither a fixed whole number, or a reference resolved at evaluation time. Accepted reference source:\n`environment` (a `Number` organisation environment variable). Any other source is rejected at write\ntime, and the reference must not carry an `adjust`. If the referenced value is missing or is not a\nwhole number within ±36500, the comparison is unresolved.\n",
+            "oneOf": [
+              {
+                "type": "integer",
+                "minimum": -36500,
+                "maximum": 36500
+              },
+              {
+                "$ref": "#/components/schemas/ValueReference"
+              }
+            ]
           },
           "unit": {
             "type": "string",
@@ -2598,7 +2616,7 @@
             "description": "Comparison applied to the resolved context value. `isEmpty` / `isNotEmpty`\ntake no `value`; all other operators require one.\n"
           },
           "value": {
-            "description": "Comparison value for binary operators: a static number, string or boolean, or an\norganisation environment variable (`Number`, `Text` or `Boolean`) so a precondition\ncan act as a per-organisation switch or threshold.\n",
+            "description": "Comparison value for binary operators: a static number, string or boolean, or a\nreference resolved at evaluation time. Accepted reference source: `environment` (a\n`Number`, `Text` or `Boolean` organisation environment variable), so a precondition\ncan act as a per-organisation switch or threshold. Any other source is rejected at\nwrite time, and the reference must not carry an `adjust`.\n",
             "oneOf": [
               {
                 "type": "number"
@@ -2610,7 +2628,7 @@
                 "type": "boolean"
               },
               {
-                "$ref": "#/components/schemas/EnvironmentValue"
+                "$ref": "#/components/schemas/ValueReference"
               }
             ]
           }
@@ -2634,9 +2652,5 @@
       }
     }
   },
-  "servers": [
-    {
-      "url": "https://validation-rules.sls.epilot.io"
-    }
-  ]
+  "servers": []
 }

package/dist/apis/access-token.cjs

@@ -6,7 +6,7 @@ var _chunkZMBA3WV4cjs = require('../chunk-ZMBA3WV4.cjs');
 
 
 
-var _chunkIPYKWRRKcjs = require('../chunk-IPYKWRRK.cjs');
+var _chunkFPQK7U3Pcjs = require('../chunk-FPQK7U3P.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/access-token.ts
@@ -14,7 +14,7 @@ var _definition = null;
 var loadDefinition = () => {
   if (!_definition) {
     const mod = _chunkZMBA3WV4cjs.require_access_token_runtime.call(void 0, );
-    _definition = _chunkIPYKWRRKcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+    _definition = _chunkFPQK7U3Pcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
   }
   return _definition;
 };
@@ -22,13 +22,13 @@ var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkIPYKWRRKcjs.createApiClient.call(void 0, { definition: def, apiName: "accessToken" });
+    _instance = _chunkFPQK7U3Pcjs.createApiClient.call(void 0, { definition: def, apiName: "accessToken" });
   }
   return _instance;
 };
-var _handle = _chunkIPYKWRRKcjs.createApiHandle.call(void 0, {
+var _handle = _chunkFPQK7U3Pcjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkIPYKWRRKcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "accessToken" }),
+  createClient: () => _chunkFPQK7U3Pcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "accessToken" }),
   apiName: "accessToken"
 });
 var getClient = _handle.getClient;
@@ -39,4 +39,4 @@ var accessToken = _handle;
 
 
 
-exports.accessToken = accessToken; exports.authorize = _chunkIPYKWRRKcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.accessToken = accessToken; exports.authorize = _chunkFPQK7U3Pcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/access-token.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-7G7ZIF7P.js";
+} from "../chunk-WPDKRU5K.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/access-token.ts

package/dist/apis/address-suggestions.cjs

@@ -6,7 +6,7 @@ var _chunkLKRBFBFNcjs = require('../chunk-LKRBFBFN.cjs');
 
 
 
-var _chunkIPYKWRRKcjs = require('../chunk-IPYKWRRK.cjs');
+var _chunkFPQK7U3Pcjs = require('../chunk-FPQK7U3P.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/address-suggestions.ts
@@ -14,7 +14,7 @@ var _definition = null;
 var loadDefinition = () => {
   if (!_definition) {
     const mod = _chunkLKRBFBFNcjs.require_address_suggestions_runtime.call(void 0, );
-    _definition = _chunkIPYKWRRKcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+    _definition = _chunkFPQK7U3Pcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
   }
   return _definition;
 };
@@ -22,13 +22,13 @@ var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkIPYKWRRKcjs.createApiClient.call(void 0, { definition: def, apiName: "addressSuggestions" });
+    _instance = _chunkFPQK7U3Pcjs.createApiClient.call(void 0, { definition: def, apiName: "addressSuggestions" });
   }
   return _instance;
 };
-var _handle = _chunkIPYKWRRKcjs.createApiHandle.call(void 0, {
+var _handle = _chunkFPQK7U3Pcjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkIPYKWRRKcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "addressSuggestions" }),
+  createClient: () => _chunkFPQK7U3Pcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "addressSuggestions" }),
   apiName: "addressSuggestions"
 });
 var getClient = _handle.getClient;
@@ -39,4 +39,4 @@ var addressSuggestions = _handle;
 
 
 
-exports.addressSuggestions = addressSuggestions; exports.authorize = _chunkIPYKWRRKcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.addressSuggestions = addressSuggestions; exports.authorize = _chunkFPQK7U3Pcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/address-suggestions.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-7G7ZIF7P.js";
+} from "../chunk-WPDKRU5K.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/address-suggestions.ts

package/dist/apis/address.cjs

@@ -6,7 +6,7 @@ var _chunkT67ZXTVGcjs = require('../chunk-T67ZXTVG.cjs');
 
 
 
-var _chunkIPYKWRRKcjs = require('../chunk-IPYKWRRK.cjs');
+var _chunkFPQK7U3Pcjs = require('../chunk-FPQK7U3P.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/address.ts
@@ -14,7 +14,7 @@ var _definition = null;
 var loadDefinition = () => {
   if (!_definition) {
     const mod = _chunkT67ZXTVGcjs.require_address_runtime.call(void 0, );
-    _definition = _chunkIPYKWRRKcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+    _definition = _chunkFPQK7U3Pcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
   }
   return _definition;
 };
@@ -22,13 +22,13 @@ var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkIPYKWRRKcjs.createApiClient.call(void 0, { definition: def, apiName: "address" });
+    _instance = _chunkFPQK7U3Pcjs.createApiClient.call(void 0, { definition: def, apiName: "address" });
   }
   return _instance;
 };
-var _handle = _chunkIPYKWRRKcjs.createApiHandle.call(void 0, {
+var _handle = _chunkFPQK7U3Pcjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkIPYKWRRKcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "address" }),
+  createClient: () => _chunkFPQK7U3Pcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "address" }),
   apiName: "address"
 });
 var getClient = _handle.getClient;
@@ -39,4 +39,4 @@ var address = _handle;
 
 
 
-exports.address = address; exports.authorize = _chunkIPYKWRRKcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.address = address; exports.authorize = _chunkFPQK7U3Pcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/address.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-7G7ZIF7P.js";
+} from "../chunk-WPDKRU5K.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/address.ts

package/dist/apis/ai-agents.cjs

@@ -6,7 +6,7 @@ var _chunkGD6KHA54cjs = require('../chunk-GD6KHA54.cjs');
 
 
 
-var _chunkIPYKWRRKcjs = require('../chunk-IPYKWRRK.cjs');
+var _chunkFPQK7U3Pcjs = require('../chunk-FPQK7U3P.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/ai-agents.ts
@@ -14,7 +14,7 @@ var _definition = null;
 var loadDefinition = () => {
   if (!_definition) {
     const mod = _chunkGD6KHA54cjs.require_ai_agents_runtime.call(void 0, );
-    _definition = _chunkIPYKWRRKcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+    _definition = _chunkFPQK7U3Pcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
   }
   return _definition;
 };
@@ -22,13 +22,13 @@ var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkIPYKWRRKcjs.createApiClient.call(void 0, { definition: def, apiName: "aiAgents" });
+    _instance = _chunkFPQK7U3Pcjs.createApiClient.call(void 0, { definition: def, apiName: "aiAgents" });
   }
   return _instance;
 };
-var _handle = _chunkIPYKWRRKcjs.createApiHandle.call(void 0, {
+var _handle = _chunkFPQK7U3Pcjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkIPYKWRRKcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "aiAgents" }),
+  createClient: () => _chunkFPQK7U3Pcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "aiAgents" }),
   apiName: "aiAgents"
 });
 var getClient = _handle.getClient;
@@ -39,4 +39,4 @@ var aiAgents = _handle;
 
 
 
-exports.aiAgents = aiAgents; exports.authorize = _chunkIPYKWRRKcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.aiAgents = aiAgents; exports.authorize = _chunkFPQK7U3Pcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/ai-agents.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-7G7ZIF7P.js";
+} from "../chunk-WPDKRU5K.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/ai-agents.ts

package/dist/apis/app.cjs

@@ -6,7 +6,7 @@ var _chunkN2P6RELZcjs = require('../chunk-N2P6RELZ.cjs');
 
 
 
-var _chunkIPYKWRRKcjs = require('../chunk-IPYKWRRK.cjs');
+var _chunkFPQK7U3Pcjs = require('../chunk-FPQK7U3P.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/app.ts
@@ -14,7 +14,7 @@ var _definition = null;
 var loadDefinition = () => {
   if (!_definition) {
     const mod = _chunkN2P6RELZcjs.require_app_runtime.call(void 0, );
-    _definition = _chunkIPYKWRRKcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+    _definition = _chunkFPQK7U3Pcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
   }
   return _definition;
 };
@@ -22,13 +22,13 @@ var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkIPYKWRRKcjs.createApiClient.call(void 0, { definition: def, apiName: "app" });
+    _instance = _chunkFPQK7U3Pcjs.createApiClient.call(void 0, { definition: def, apiName: "app" });
   }
   return _instance;
 };
-var _handle = _chunkIPYKWRRKcjs.createApiHandle.call(void 0, {
+var _handle = _chunkFPQK7U3Pcjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkIPYKWRRKcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "app" }),
+  createClient: () => _chunkFPQK7U3Pcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "app" }),
   apiName: "app"
 });
 var getClient = _handle.getClient;
@@ -39,4 +39,4 @@ var app = _handle;
 
 
 
-exports.app = app; exports.authorize = _chunkIPYKWRRKcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.app = app; exports.authorize = _chunkFPQK7U3Pcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/app.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-7G7ZIF7P.js";
+} from "../chunk-WPDKRU5K.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/app.ts