@epilot/sdk 2.20.58 → 2.20.60

package/dist/{integration-toolkit-runtime-FT2J5NFV.js → integration-toolkit-runtime-3LKW4ORQ.js}

@@ -1,5 +1,5 @@
 import {
   require_integration_toolkit_runtime
-} from "./chunk-6JWMDS4Z.js";
+} from "./chunk-MBWCGRCK.js";
 import "./chunk-YPSWSI3M.js";
 export default require_integration_toolkit_runtime();

package/dist/{integration-toolkit-runtime-GDJVWSKC.cjs → integration-toolkit-runtime-3PM3MBEF.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkEPZ3JT2Wcjs = require('./chunk-EPZ3JT2W.cjs');
+var _chunkY7KWK5H2cjs = require('./chunk-Y7KWK5H2.cjs');
 require('./chunk-NJK5F5TF.cjs');
-exports. default = _chunkEPZ3JT2Wcjs.require_integration_toolkit_runtime.call(void 0, );
+exports. default = _chunkY7KWK5H2cjs.require_integration_toolkit_runtime.call(void 0, );

package/dist/{integration-toolkit.d-DWslwG3c.d.cts → integration-toolkit.d-oORkWs_H.d.cts}

@@ -3145,6 +3145,10 @@ declare namespace Components {
              * 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.
              */
             total_rows?: number;
+            /**
+             * 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.
+             */
+            events_published?: number;
         }
         export interface ErpImportUseCaseSuggestion {
             integration_id: string;
@@ -4080,6 +4084,12 @@ declare namespace Components {
             };
             warnings?: string[];
         }
+        export interface GetMonitoringRunCompletionV2Request {
+            /**
+             * 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.
+             */
+            correlation_ids: string[];
+        }
         export interface GetMonitoringStatsRequest {
             /**
              * Start date for statistics period (inclusive)
@@ -5899,6 +5909,61 @@ declare namespace Components {
              */
             created_at: string; // date-time
         }
+        /**
+         * Per-event completion of one run. Every count is in EVENTS (distinct `event_id`), never rows: `seen = in_flight + success + warning + error + info`.
+         */
+        export interface MonitoringRunCompletionV2 {
+            correlation_id: string;
+            /**
+             * Distinct events that have reported at least one row under this run.
+             */
+            seen: number;
+            /**
+             * 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.
+             */
+            in_flight: number;
+            /**
+             * The subset of `in_flight` whose latest row is a retry marker — the queue will deliver them again after a temporary failure.
+             */
+            retrying: number;
+            /**
+             * Settled events whose terminal rows were all successes.
+             */
+            success: number;
+            /**
+             * 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.
+             */
+            warning: number;
+            /**
+             * Settled events with at least one terminal error row (retries exhausted, or non-retryable).
+             */
+            error: number;
+            /**
+             * Settled events whose rows were all informational — deduplicated or skipped, nothing to apply.
+             */
+            info: number;
+            entries: /* 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). */ MonitoringRunEntriesV2;
+            /**
+             * Newest row of any level under this run; null when nothing has reported yet.
+             */
+            last_activity_at: string | null; // date-time
+        }
+        export interface MonitoringRunCompletionV2Response {
+            /**
+             * One entry per requested `correlation_id`, in request order.
+             */
+            runs: /* Per-event completion of one run. Every count is in EVENTS (distinct `event_id`), never rows: `seen = in_flight + success + warning + error + info`. */ MonitoringRunCompletionV2[];
+        }
+        /**
+         * 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).
+         */
+        export interface MonitoringRunEntriesV2 {
+            total: number;
+            error: number;
+            warning: number;
+            success: number;
+            info: number;
+        }
         export interface MonitoringStats {
             /**
              * Statistics for inbound (ERP sync) events
@@ -9087,6 +9152,22 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetMonitoringRunCompletionV2 {
+        namespace Parameters {
+            export type IntegrationId = string; // uuid
+        }
+        export interface PathParameters {
+            integrationId: Parameters.IntegrationId /* uuid */;
+        }
+        export type RequestBody = Components.Schemas.GetMonitoringRunCompletionV2Request;
+        namespace Responses {
+            export type $200 = Components.Schemas.MonitoringRunCompletionV2Response;
+            export type $400 = Components.Responses.BadRequest;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace GetMonitoringStats {
         namespace Parameters {
             export type IntegrationId = string; // uuid
@@ -10751,6 +10832,37 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetMonitoringTraceByCorrelation.Responses.$200>
+  /**
+   * getMonitoringRunCompletionV2 - getMonitoringRunCompletionV2
+   * 
+   * Per-event completion of one or more runs (every monitoring event sharing a
+   * `correlation_id`), each reduced to "how many events have reached a final
+   * outcome, and how many are still going". Unlike `getMonitoringStatsV2`, which
+   * counts rows, this groups `erp_monitoring_v2` by `event_id` first: an event
+   * retried twice and then processed counts once, as a success.
+   * 
+   * Per event: it is **settled** once it has a `success` row, a terminal `error`
+   * row (a non-retryable failure, retries exhausted, or the dead-letter closure),
+   * or nothing but informational rows (deduplicated, skipped). A `warning` never
+   * settles an event on its own: mapping and relation caveats are written BEFORE
+   * the final stage's success row, and a retry marker (`warning` with
+   * `will_retry: true`) means the queue will deliver it again. Everything else is
+   * **in flight**. A settled event's outcome is its worst terminal row — `error`
+   * beats `warning` beats `success`.
+   * 
+   * Batched so a history page costs one request: pass every run on the page. A run
+   * that has reported nothing yet comes back with `seen: 0`, never omitted.
+   * 
+   * The denominator is NOT here: the producer owns it. For an ERP file import it is
+   * `ErpImportProgress.events_published`; `seen` is how many of those have reported
+   * anything yet. Freshness is near-real-time (ClickHouse ingestion lag).
+   * 
+   */
+  'getMonitoringRunCompletionV2'(
+    parameters?: Parameters<Paths.GetMonitoringRunCompletionV2.PathParameters> | null,
+    data?: Paths.GetMonitoringRunCompletionV2.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetMonitoringRunCompletionV2.Responses.$200>
   /**
    * listSecureProxies - listSecureProxies
    * 
@@ -11821,6 +11933,39 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetMonitoringTraceByCorrelation.Responses.$200>
   }
+  ['/v2/integrations/{integrationId}/monitoring/runs/completion']: {
+    /**
+     * getMonitoringRunCompletionV2 - getMonitoringRunCompletionV2
+     * 
+     * Per-event completion of one or more runs (every monitoring event sharing a
+     * `correlation_id`), each reduced to "how many events have reached a final
+     * outcome, and how many are still going". Unlike `getMonitoringStatsV2`, which
+     * counts rows, this groups `erp_monitoring_v2` by `event_id` first: an event
+     * retried twice and then processed counts once, as a success.
+     * 
+     * Per event: it is **settled** once it has a `success` row, a terminal `error`
+     * row (a non-retryable failure, retries exhausted, or the dead-letter closure),
+     * or nothing but informational rows (deduplicated, skipped). A `warning` never
+     * settles an event on its own: mapping and relation caveats are written BEFORE
+     * the final stage's success row, and a retry marker (`warning` with
+     * `will_retry: true`) means the queue will deliver it again. Everything else is
+     * **in flight**. A settled event's outcome is its worst terminal row — `error`
+     * beats `warning` beats `success`.
+     * 
+     * Batched so a history page costs one request: pass every run on the page. A run
+     * that has reported nothing yet comes back with `seen: 0`, never omitted.
+     * 
+     * The denominator is NOT here: the producer owns it. For an ERP file import it is
+     * `ErpImportProgress.events_published`; `seen` is how many of those have reported
+     * anything yet. Freshness is near-real-time (ClickHouse ingestion lag).
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.GetMonitoringRunCompletionV2.PathParameters> | null,
+      data?: Paths.GetMonitoringRunCompletionV2.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetMonitoringRunCompletionV2.Responses.$200>
+  }
   ['/v1/integrations/secure-proxies']: {
     /**
      * listSecureProxies - listSecureProxies
@@ -12116,6 +12261,7 @@ type FileProxyUseCaseHistoryEntry = Components.Schemas.FileProxyUseCaseHistoryEn
 type GenerateTypesPreviewResponse = Components.Schemas.GenerateTypesPreviewResponse;
 type GenerateTypesRequest = Components.Schemas.GenerateTypesRequest;
 type GenerateTypesResponse = Components.Schemas.GenerateTypesResponse;
+type GetMonitoringRunCompletionV2Request = Components.Schemas.GetMonitoringRunCompletionV2Request;
 type GetMonitoringStatsRequest = Components.Schemas.GetMonitoringStatsRequest;
 type GetMonitoringStatsV2Request = Components.Schemas.GetMonitoringStatsV2Request;
 type GetMonitoringTimeSeriesRequest = Components.Schemas.GetMonitoringTimeSeriesRequest;
@@ -12161,6 +12307,9 @@ type MeterReadingUpdate = Components.Schemas.MeterReadingUpdate;
 type MeterUniqueIdsConfig = Components.Schemas.MeterUniqueIdsConfig;
 type MonitoringCode = Components.Schemas.MonitoringCode;
 type MonitoringEventV2 = Components.Schemas.MonitoringEventV2;
+type MonitoringRunCompletionV2 = Components.Schemas.MonitoringRunCompletionV2;
+type MonitoringRunCompletionV2Response = Components.Schemas.MonitoringRunCompletionV2Response;
+type MonitoringRunEntriesV2 = Components.Schemas.MonitoringRunEntriesV2;
 type MonitoringStats = Components.Schemas.MonitoringStats;
 type MonitoringStatsV2 = Components.Schemas.MonitoringStatsV2;
 type MonitoringTraceResponse = Components.Schemas.MonitoringTraceResponse;
@@ -12255,4 +12404,4 @@ type ValidateErpImportRequest = Components.Schemas.ValidateErpImportRequest;
 type WebhookDeliveryConfig = Components.Schemas.WebhookDeliveryConfig;
 type WebhookStatus = Components.Schemas.WebhookStatus;
 
-export { type ErpImportEntityDetail as $, type AccessLogEntry as A, type DirectRelationValue as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type DirectSimulationError as E, type DirectSimulationRequest as F, type DirectSimulationResponse as G, type DocumentationPage as H, type DocumentationPageSummary as I, type EmbeddedFileProxyUseCaseRequest as J, type EmbeddedInboundUseCaseRequest as K, type EmbeddedManagedCallUseCaseRequest as L, type EmbeddedOutboundUseCaseRequest as M, type EmbeddedSecureProxyUseCaseRequest as N, type OperationMethods as O, Paths as P, type EmbeddedUseCaseRequest as Q, type EmbeddedUseCaseRequestBase as R, type EntityPruneScopeUpdate as S, type EntitySyncState as T, type EntitySyncStatusResponse as U, type EntityUpdate as V, type EnvVarRefConfig as W, type EnvironmentFieldConfig as X, type ErpEvent as Y, type ErpEventV3 as Z, type ErpImportDownload as _, Components as a, type ManagedCallUseCaseHistoryEntry as a$, type ErpImportError as a0, type ErpImportFilePreview as a1, type ErpImportIssue as a2, type ErpImportJob as a3, type ErpImportList as a4, type ErpImportProgress as a5, type ErpImportUseCaseSuggestion as a6, type ErpImportValidation as a7, type ErpUpdatesEventsV2Request as a8, type ErpUpdatesEventsV3Request as a9, type InboundUseCase as aA, type InboundUseCaseHistoryEntry as aB, type IngestExternalMonitoringEventsRequest as aC, type IngestExternalMonitoringEventsResponse as aD, type Integration as aE, type IntegrationAppMapping as aF, type IntegrationConfigurationV1 as aG, type IntegrationConfigurationV2 as aH, type IntegrationEditableFields as aI, type IntegrationEntity as aJ, type IntegrationEntityConditional as aK, type IntegrationEntityField as aL, type IntegrationEntityFromRows as aM, type IntegrationFieldV1 as aN, type IntegrationMap as aO, type IntegrationMeterReading as aP, type IntegrationNotificationConfig as aQ, type IntegrationObjectV1 as aR, type IntegrationSettings as aS, type IntegrationWithUseCases as aT, type ManagedCallAuth as aU, type ManagedCallErrorResponse as aV, type ManagedCallExecuteRequest as aW, type ManagedCallExecuteResponse as aX, type ManagedCallOperation as aY, type ManagedCallOperationConfig as aZ, type ManagedCallUseCase as a_, type ErrorResponseBase as aa, type ExecuteErpImportRequest as ab, type ExternalMonitoringSpan as ac, type FileProxyAuth as ad, type FileProxyDeliveryConfig as ae, type FileProxyFanOutConfig as af, type FileProxyParam as ag, type FileProxyResponseConfig as ah, type FileProxySecureProxyAttachment as ai, type FileProxyStep as aj, type FileProxyUploadConfig as ak, type FileProxyUrlConfig as al, type FileProxyUrlParam as am, type FileProxyUrlParams as an, type FileProxyUseCase as ao, type FileProxyUseCaseConfiguration as ap, type FileProxyUseCaseHistoryEntry as aq, type GenerateTypesPreviewResponse as ar, type GenerateTypesRequest as as, type GenerateTypesResponse as at, type GetMonitoringStatsRequest as au, type GetMonitoringStatsV2Request as av, type GetMonitoringTimeSeriesRequest as aw, type GetMonitoringTimeSeriesV2Request as ax, type InboundIntegrationEventConfiguration as ay, type InboundMonitoringEvent as az, type PathsDictionary as b, type SecureProxyResponse as b$, type MappedFieldValue as b0, type MappingSimulationRequest as b1, type MappingSimulationResponse as b2, type MappingSimulationV2Request as b3, type MappingSimulationWarning as b4, type MeterReadingPruneScopeConfig as b5, type MeterReadingPruneScopeUpdate as b6, type MeterReadingUpdate as b7, type MeterUniqueIdsConfig as b8, type MonitoringCode as b9, type PollDeliveryConfig as bA, type PollOutboundMessagesRequest as bB, type PollOutboundMessagesResponse as bC, type PortalOrigin as bD, type PortalRefConfig as bE, type PortalRefFilter as bF, type PruneScopeConfig as bG, type QueryAccessLogsRequest as bH, type QueryEventsRequest as bI, type QueryInboundMonitoringEventsRequest as bJ, type QueryMonitoringEventsV2Request as bK, type QueryOutboundMonitoringEventsRequest as bL, type RedriveOutboundDlqRequest as bM, type RedriveOutboundDlqResponse as bN, type RedriveOutboundDlqResult as bO, type RelationConfig as bP, type RelationItemConfig as bQ, type RelationRefItemConfig as bR, type RelationRefValueConfig as bS, type RelationRefsConfig as bT, type RelationUniqueIdField as bU, type RepeatableFieldType as bV, type ReplayEventsRequest as bW, type RuleBaselineBucket as bX, type RuleBaselineStatus as bY, type S3Reference as bZ, type SecureProxyRequest as b_, type MonitoringEventV2 as ba, type MonitoringStats as bb, type MonitoringStatsV2 as bc, type MonitoringTraceResponse as bd, type NotificationChannelSet as be, type NotificationDigestConfig as bf, type NotificationHistoryItem as bg, type NotificationHistoryResponse as bh, type NotificationRecipient as bi, type NotificationRule as bj, type NotificationRuleStatus as bk, type NotificationStatusResponse as bl, type OutboundConflict as bm, type OutboundDlqListResponse as bn, type OutboundDlqMessage as bo, type OutboundFileProxyTargetStatus as bp, type OutboundIntegrationEventConfiguration as bq, type OutboundMapping as br, type OutboundMappingSimulationError as bs, type OutboundMessage as bt, type OutboundMonitoringEvent as bu, type OutboundPollStatus as bv, type OutboundStatusResponse as bw, type OutboundUseCase as bx, type OutboundUseCaseHistoryEntry as by, type OutboundUseCaseStatus as bz, type AckOutboundMessagesRequest as c, type SecureProxySummary as c0, type SecureProxyUpstreamError as c1, type SecureProxyUseCase as c2, type SecureProxyUseCaseConfiguration as c3, type SecureProxyUseCaseHistoryEntry as c4, type SecureProxyWhitelist as c5, type SecureProxyWhitelistUpdate as c6, type SetIntegrationAppMappingRequest as c7, type SimulateOutboundMappingRequest as c8, type SimulateOutboundMappingResponse as c9, type UseCaseTypePreview as cA, type ValidateErpImportRequest as cB, type WebhookDeliveryConfig as cC, type WebhookStatus as cD, type SuggestErpImportUseCasesResponse as ca, type TestNotificationRequest as cb, type TestNotificationResponse as cc, type TimeSeriesBreakdownItemV2 as cd, type TimeSeriesBucket as ce, type TimeSeriesBucketV2 as cf, type TriggerErpActionRequest as cg, type TriggerWebhookResp as ch, type TypeAnnotations as ci, type TypeDescriptor as cj, type UnblockOutboundStreamRequest as ck, type UnblockOutboundStreamResponse as cl, type UpdateFileProxyUseCaseRequest as cm, type UpdateInboundUseCaseRequest as cn, type UpdateIntegrationRequest as co, type UpdateManagedCallUseCaseRequest as cp, type UpdateOutboundUseCaseRequest as cq, type UpdateSecureProxyUseCaseRequest as cr, type UpdateUseCaseRequest as cs, type UpdateUseCaseRequestBase as ct, type UpsertDocumentationPageRequest as cu, type UpsertIntegrationWithUseCasesRequest as cv, type UseCase as cw, type UseCaseBase as cx, type UseCaseHistoryEntry as cy, type UseCaseHistoryEntryBase as cz, type AckOutboundMessagesResponse as d, type AckResult as e, type AutoRefreshSettings as f, type CommitTypesRequest as g, type CommitTypesResponse as h, type ConnectorConfig as i, type CreateErpImportRequest as j, type CreateErpImportResponse as k, type CreateFileProxyUseCaseRequest as l, type CreateInboundUseCaseRequest as m, type CreateIntegrationRequest as n, type CreateManagedCallUseCaseRequest as o, type CreateOutboundUseCaseRequest as p, type CreateSecureProxyUseCaseRequest as q, type CreateUseCaseRequest as r, type CreateUseCaseRequestBase as s, type DeliveryConfig as t, type DirectEntityOperation as u, type DirectMeterReadingOperation as v, type DirectPayload as w, type DirectRelationItem as x, type DirectRelationRefItem as y, type DirectRelationRefValue as z };
+export { type ErpImportEntityDetail as $, type AccessLogEntry as A, type DirectRelationValue as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type DirectSimulationError as E, type DirectSimulationRequest as F, type DirectSimulationResponse as G, type DocumentationPage as H, type DocumentationPageSummary as I, type EmbeddedFileProxyUseCaseRequest as J, type EmbeddedInboundUseCaseRequest as K, type EmbeddedManagedCallUseCaseRequest as L, type EmbeddedOutboundUseCaseRequest as M, type EmbeddedSecureProxyUseCaseRequest as N, type OperationMethods as O, Paths as P, type EmbeddedUseCaseRequest as Q, type EmbeddedUseCaseRequestBase as R, type EntityPruneScopeUpdate as S, type EntitySyncState as T, type EntitySyncStatusResponse as U, type EntityUpdate as V, type EnvVarRefConfig as W, type EnvironmentFieldConfig as X, type ErpEvent as Y, type ErpEventV3 as Z, type ErpImportDownload as _, Components as a, type ManagedCallUseCase as a$, type ErpImportError as a0, type ErpImportFilePreview as a1, type ErpImportIssue as a2, type ErpImportJob as a3, type ErpImportList as a4, type ErpImportProgress as a5, type ErpImportUseCaseSuggestion as a6, type ErpImportValidation as a7, type ErpUpdatesEventsV2Request as a8, type ErpUpdatesEventsV3Request as a9, type InboundMonitoringEvent as aA, type InboundUseCase as aB, type InboundUseCaseHistoryEntry as aC, type IngestExternalMonitoringEventsRequest as aD, type IngestExternalMonitoringEventsResponse as aE, type Integration as aF, type IntegrationAppMapping as aG, type IntegrationConfigurationV1 as aH, type IntegrationConfigurationV2 as aI, type IntegrationEditableFields as aJ, type IntegrationEntity as aK, type IntegrationEntityConditional as aL, type IntegrationEntityField as aM, type IntegrationEntityFromRows as aN, type IntegrationFieldV1 as aO, type IntegrationMap as aP, type IntegrationMeterReading as aQ, type IntegrationNotificationConfig as aR, type IntegrationObjectV1 as aS, type IntegrationSettings as aT, type IntegrationWithUseCases as aU, type ManagedCallAuth as aV, type ManagedCallErrorResponse as aW, type ManagedCallExecuteRequest as aX, type ManagedCallExecuteResponse as aY, type ManagedCallOperation as aZ, type ManagedCallOperationConfig as a_, type ErrorResponseBase as aa, type ExecuteErpImportRequest as ab, type ExternalMonitoringSpan as ac, type FileProxyAuth as ad, type FileProxyDeliveryConfig as ae, type FileProxyFanOutConfig as af, type FileProxyParam as ag, type FileProxyResponseConfig as ah, type FileProxySecureProxyAttachment as ai, type FileProxyStep as aj, type FileProxyUploadConfig as ak, type FileProxyUrlConfig as al, type FileProxyUrlParam as am, type FileProxyUrlParams as an, type FileProxyUseCase as ao, type FileProxyUseCaseConfiguration as ap, type FileProxyUseCaseHistoryEntry as aq, type GenerateTypesPreviewResponse as ar, type GenerateTypesRequest as as, type GenerateTypesResponse as at, type GetMonitoringRunCompletionV2Request as au, type GetMonitoringStatsRequest as av, type GetMonitoringStatsV2Request as aw, type GetMonitoringTimeSeriesRequest as ax, type GetMonitoringTimeSeriesV2Request as ay, type InboundIntegrationEventConfiguration as az, type PathsDictionary as b, type RuleBaselineBucket as b$, type ManagedCallUseCaseHistoryEntry as b0, type MappedFieldValue as b1, type MappingSimulationRequest as b2, type MappingSimulationResponse as b3, type MappingSimulationV2Request as b4, type MappingSimulationWarning as b5, type MeterReadingPruneScopeConfig as b6, type MeterReadingPruneScopeUpdate as b7, type MeterReadingUpdate as b8, type MeterUniqueIdsConfig as b9, type OutboundStatusResponse as bA, type OutboundUseCase as bB, type OutboundUseCaseHistoryEntry as bC, type OutboundUseCaseStatus as bD, type PollDeliveryConfig as bE, type PollOutboundMessagesRequest as bF, type PollOutboundMessagesResponse as bG, type PortalOrigin as bH, type PortalRefConfig as bI, type PortalRefFilter as bJ, type PruneScopeConfig as bK, type QueryAccessLogsRequest as bL, type QueryEventsRequest as bM, type QueryInboundMonitoringEventsRequest as bN, type QueryMonitoringEventsV2Request as bO, type QueryOutboundMonitoringEventsRequest as bP, type RedriveOutboundDlqRequest as bQ, type RedriveOutboundDlqResponse as bR, type RedriveOutboundDlqResult as bS, type RelationConfig as bT, type RelationItemConfig as bU, type RelationRefItemConfig as bV, type RelationRefValueConfig as bW, type RelationRefsConfig as bX, type RelationUniqueIdField as bY, type RepeatableFieldType as bZ, type ReplayEventsRequest as b_, type MonitoringCode as ba, type MonitoringEventV2 as bb, type MonitoringRunCompletionV2 as bc, type MonitoringRunCompletionV2Response as bd, type MonitoringRunEntriesV2 as be, type MonitoringStats as bf, type MonitoringStatsV2 as bg, type MonitoringTraceResponse as bh, type NotificationChannelSet as bi, type NotificationDigestConfig as bj, type NotificationHistoryItem as bk, type NotificationHistoryResponse as bl, type NotificationRecipient as bm, type NotificationRule as bn, type NotificationRuleStatus as bo, type NotificationStatusResponse as bp, type OutboundConflict as bq, type OutboundDlqListResponse as br, type OutboundDlqMessage as bs, type OutboundFileProxyTargetStatus as bt, type OutboundIntegrationEventConfiguration as bu, type OutboundMapping as bv, type OutboundMappingSimulationError as bw, type OutboundMessage as bx, type OutboundMonitoringEvent as by, type OutboundPollStatus as bz, type AckOutboundMessagesRequest as c, type RuleBaselineStatus as c0, type S3Reference as c1, type SecureProxyRequest as c2, type SecureProxyResponse as c3, type SecureProxySummary as c4, type SecureProxyUpstreamError as c5, type SecureProxyUseCase as c6, type SecureProxyUseCaseConfiguration as c7, type SecureProxyUseCaseHistoryEntry as c8, type SecureProxyWhitelist as c9, type UseCase as cA, type UseCaseBase as cB, type UseCaseHistoryEntry as cC, type UseCaseHistoryEntryBase as cD, type UseCaseTypePreview as cE, type ValidateErpImportRequest as cF, type WebhookDeliveryConfig as cG, type WebhookStatus as cH, type SecureProxyWhitelistUpdate as ca, type SetIntegrationAppMappingRequest as cb, type SimulateOutboundMappingRequest as cc, type SimulateOutboundMappingResponse as cd, type SuggestErpImportUseCasesResponse as ce, type TestNotificationRequest as cf, type TestNotificationResponse as cg, type TimeSeriesBreakdownItemV2 as ch, type TimeSeriesBucket as ci, type TimeSeriesBucketV2 as cj, type TriggerErpActionRequest as ck, type TriggerWebhookResp as cl, type TypeAnnotations as cm, type TypeDescriptor as cn, type UnblockOutboundStreamRequest as co, type UnblockOutboundStreamResponse as cp, type UpdateFileProxyUseCaseRequest as cq, type UpdateInboundUseCaseRequest as cr, type UpdateIntegrationRequest as cs, type UpdateManagedCallUseCaseRequest as ct, type UpdateOutboundUseCaseRequest as cu, type UpdateSecureProxyUseCaseRequest as cv, type UpdateUseCaseRequest as cw, type UpdateUseCaseRequestBase as cx, type UpsertDocumentationPageRequest as cy, type UpsertIntegrationWithUseCasesRequest as cz, type AckOutboundMessagesResponse as d, type AckResult as e, type AutoRefreshSettings as f, type CommitTypesRequest as g, type CommitTypesResponse as h, type ConnectorConfig as i, type CreateErpImportRequest as j, type CreateErpImportResponse as k, type CreateFileProxyUseCaseRequest as l, type CreateInboundUseCaseRequest as m, type CreateIntegrationRequest as n, type CreateManagedCallUseCaseRequest as o, type CreateOutboundUseCaseRequest as p, type CreateSecureProxyUseCaseRequest as q, type CreateUseCaseRequest as r, type CreateUseCaseRequestBase as s, type DeliveryConfig as t, type DirectEntityOperation as u, type DirectMeterReadingOperation as v, type DirectPayload as w, type DirectRelationItem as x, type DirectRelationRefItem as y, type DirectRelationRefValue as z };

package/dist/{integration-toolkit.d-DWslwG3c.d.ts → integration-toolkit.d-oORkWs_H.d.ts}

@@ -3145,6 +3145,10 @@ declare namespace Components {
              * 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.
              */
             total_rows?: number;
+            /**
+             * 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.
+             */
+            events_published?: number;
         }
         export interface ErpImportUseCaseSuggestion {
             integration_id: string;
@@ -4080,6 +4084,12 @@ declare namespace Components {
             };
             warnings?: string[];
         }
+        export interface GetMonitoringRunCompletionV2Request {
+            /**
+             * 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.
+             */
+            correlation_ids: string[];
+        }
         export interface GetMonitoringStatsRequest {
             /**
              * Start date for statistics period (inclusive)
@@ -5899,6 +5909,61 @@ declare namespace Components {
              */
             created_at: string; // date-time
         }
+        /**
+         * Per-event completion of one run. Every count is in EVENTS (distinct `event_id`), never rows: `seen = in_flight + success + warning + error + info`.
+         */
+        export interface MonitoringRunCompletionV2 {
+            correlation_id: string;
+            /**
+             * Distinct events that have reported at least one row under this run.
+             */
+            seen: number;
+            /**
+             * 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.
+             */
+            in_flight: number;
+            /**
+             * The subset of `in_flight` whose latest row is a retry marker — the queue will deliver them again after a temporary failure.
+             */
+            retrying: number;
+            /**
+             * Settled events whose terminal rows were all successes.
+             */
+            success: number;
+            /**
+             * 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.
+             */
+            warning: number;
+            /**
+             * Settled events with at least one terminal error row (retries exhausted, or non-retryable).
+             */
+            error: number;
+            /**
+             * Settled events whose rows were all informational — deduplicated or skipped, nothing to apply.
+             */
+            info: number;
+            entries: /* 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). */ MonitoringRunEntriesV2;
+            /**
+             * Newest row of any level under this run; null when nothing has reported yet.
+             */
+            last_activity_at: string | null; // date-time
+        }
+        export interface MonitoringRunCompletionV2Response {
+            /**
+             * One entry per requested `correlation_id`, in request order.
+             */
+            runs: /* Per-event completion of one run. Every count is in EVENTS (distinct `event_id`), never rows: `seen = in_flight + success + warning + error + info`. */ MonitoringRunCompletionV2[];
+        }
+        /**
+         * 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).
+         */
+        export interface MonitoringRunEntriesV2 {
+            total: number;
+            error: number;
+            warning: number;
+            success: number;
+            info: number;
+        }
         export interface MonitoringStats {
             /**
              * Statistics for inbound (ERP sync) events
@@ -9087,6 +9152,22 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetMonitoringRunCompletionV2 {
+        namespace Parameters {
+            export type IntegrationId = string; // uuid
+        }
+        export interface PathParameters {
+            integrationId: Parameters.IntegrationId /* uuid */;
+        }
+        export type RequestBody = Components.Schemas.GetMonitoringRunCompletionV2Request;
+        namespace Responses {
+            export type $200 = Components.Schemas.MonitoringRunCompletionV2Response;
+            export type $400 = Components.Responses.BadRequest;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace GetMonitoringStats {
         namespace Parameters {
             export type IntegrationId = string; // uuid
@@ -10751,6 +10832,37 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetMonitoringTraceByCorrelation.Responses.$200>
+  /**
+   * getMonitoringRunCompletionV2 - getMonitoringRunCompletionV2
+   * 
+   * Per-event completion of one or more runs (every monitoring event sharing a
+   * `correlation_id`), each reduced to "how many events have reached a final
+   * outcome, and how many are still going". Unlike `getMonitoringStatsV2`, which
+   * counts rows, this groups `erp_monitoring_v2` by `event_id` first: an event
+   * retried twice and then processed counts once, as a success.
+   * 
+   * Per event: it is **settled** once it has a `success` row, a terminal `error`
+   * row (a non-retryable failure, retries exhausted, or the dead-letter closure),
+   * or nothing but informational rows (deduplicated, skipped). A `warning` never
+   * settles an event on its own: mapping and relation caveats are written BEFORE
+   * the final stage's success row, and a retry marker (`warning` with
+   * `will_retry: true`) means the queue will deliver it again. Everything else is
+   * **in flight**. A settled event's outcome is its worst terminal row — `error`
+   * beats `warning` beats `success`.
+   * 
+   * Batched so a history page costs one request: pass every run on the page. A run
+   * that has reported nothing yet comes back with `seen: 0`, never omitted.
+   * 
+   * The denominator is NOT here: the producer owns it. For an ERP file import it is
+   * `ErpImportProgress.events_published`; `seen` is how many of those have reported
+   * anything yet. Freshness is near-real-time (ClickHouse ingestion lag).
+   * 
+   */
+  'getMonitoringRunCompletionV2'(
+    parameters?: Parameters<Paths.GetMonitoringRunCompletionV2.PathParameters> | null,
+    data?: Paths.GetMonitoringRunCompletionV2.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetMonitoringRunCompletionV2.Responses.$200>
   /**
    * listSecureProxies - listSecureProxies
    * 
@@ -11821,6 +11933,39 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetMonitoringTraceByCorrelation.Responses.$200>
   }
+  ['/v2/integrations/{integrationId}/monitoring/runs/completion']: {
+    /**
+     * getMonitoringRunCompletionV2 - getMonitoringRunCompletionV2
+     * 
+     * Per-event completion of one or more runs (every monitoring event sharing a
+     * `correlation_id`), each reduced to "how many events have reached a final
+     * outcome, and how many are still going". Unlike `getMonitoringStatsV2`, which
+     * counts rows, this groups `erp_monitoring_v2` by `event_id` first: an event
+     * retried twice and then processed counts once, as a success.
+     * 
+     * Per event: it is **settled** once it has a `success` row, a terminal `error`
+     * row (a non-retryable failure, retries exhausted, or the dead-letter closure),
+     * or nothing but informational rows (deduplicated, skipped). A `warning` never
+     * settles an event on its own: mapping and relation caveats are written BEFORE
+     * the final stage's success row, and a retry marker (`warning` with
+     * `will_retry: true`) means the queue will deliver it again. Everything else is
+     * **in flight**. A settled event's outcome is its worst terminal row — `error`
+     * beats `warning` beats `success`.
+     * 
+     * Batched so a history page costs one request: pass every run on the page. A run
+     * that has reported nothing yet comes back with `seen: 0`, never omitted.
+     * 
+     * The denominator is NOT here: the producer owns it. For an ERP file import it is
+     * `ErpImportProgress.events_published`; `seen` is how many of those have reported
+     * anything yet. Freshness is near-real-time (ClickHouse ingestion lag).
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.GetMonitoringRunCompletionV2.PathParameters> | null,
+      data?: Paths.GetMonitoringRunCompletionV2.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetMonitoringRunCompletionV2.Responses.$200>
+  }
   ['/v1/integrations/secure-proxies']: {
     /**
      * listSecureProxies - listSecureProxies
@@ -12116,6 +12261,7 @@ type FileProxyUseCaseHistoryEntry = Components.Schemas.FileProxyUseCaseHistoryEn
 type GenerateTypesPreviewResponse = Components.Schemas.GenerateTypesPreviewResponse;
 type GenerateTypesRequest = Components.Schemas.GenerateTypesRequest;
 type GenerateTypesResponse = Components.Schemas.GenerateTypesResponse;
+type GetMonitoringRunCompletionV2Request = Components.Schemas.GetMonitoringRunCompletionV2Request;
 type GetMonitoringStatsRequest = Components.Schemas.GetMonitoringStatsRequest;
 type GetMonitoringStatsV2Request = Components.Schemas.GetMonitoringStatsV2Request;
 type GetMonitoringTimeSeriesRequest = Components.Schemas.GetMonitoringTimeSeriesRequest;
@@ -12161,6 +12307,9 @@ type MeterReadingUpdate = Components.Schemas.MeterReadingUpdate;
 type MeterUniqueIdsConfig = Components.Schemas.MeterUniqueIdsConfig;
 type MonitoringCode = Components.Schemas.MonitoringCode;
 type MonitoringEventV2 = Components.Schemas.MonitoringEventV2;
+type MonitoringRunCompletionV2 = Components.Schemas.MonitoringRunCompletionV2;
+type MonitoringRunCompletionV2Response = Components.Schemas.MonitoringRunCompletionV2Response;
+type MonitoringRunEntriesV2 = Components.Schemas.MonitoringRunEntriesV2;
 type MonitoringStats = Components.Schemas.MonitoringStats;
 type MonitoringStatsV2 = Components.Schemas.MonitoringStatsV2;
 type MonitoringTraceResponse = Components.Schemas.MonitoringTraceResponse;
@@ -12255,4 +12404,4 @@ type ValidateErpImportRequest = Components.Schemas.ValidateErpImportRequest;
 type WebhookDeliveryConfig = Components.Schemas.WebhookDeliveryConfig;
 type WebhookStatus = Components.Schemas.WebhookStatus;
 
-export { type ErpImportEntityDetail as $, type AccessLogEntry as A, type DirectRelationValue as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type DirectSimulationError as E, type DirectSimulationRequest as F, type DirectSimulationResponse as G, type DocumentationPage as H, type DocumentationPageSummary as I, type EmbeddedFileProxyUseCaseRequest as J, type EmbeddedInboundUseCaseRequest as K, type EmbeddedManagedCallUseCaseRequest as L, type EmbeddedOutboundUseCaseRequest as M, type EmbeddedSecureProxyUseCaseRequest as N, type OperationMethods as O, Paths as P, type EmbeddedUseCaseRequest as Q, type EmbeddedUseCaseRequestBase as R, type EntityPruneScopeUpdate as S, type EntitySyncState as T, type EntitySyncStatusResponse as U, type EntityUpdate as V, type EnvVarRefConfig as W, type EnvironmentFieldConfig as X, type ErpEvent as Y, type ErpEventV3 as Z, type ErpImportDownload as _, Components as a, type ManagedCallUseCaseHistoryEntry as a$, type ErpImportError as a0, type ErpImportFilePreview as a1, type ErpImportIssue as a2, type ErpImportJob as a3, type ErpImportList as a4, type ErpImportProgress as a5, type ErpImportUseCaseSuggestion as a6, type ErpImportValidation as a7, type ErpUpdatesEventsV2Request as a8, type ErpUpdatesEventsV3Request as a9, type InboundUseCase as aA, type InboundUseCaseHistoryEntry as aB, type IngestExternalMonitoringEventsRequest as aC, type IngestExternalMonitoringEventsResponse as aD, type Integration as aE, type IntegrationAppMapping as aF, type IntegrationConfigurationV1 as aG, type IntegrationConfigurationV2 as aH, type IntegrationEditableFields as aI, type IntegrationEntity as aJ, type IntegrationEntityConditional as aK, type IntegrationEntityField as aL, type IntegrationEntityFromRows as aM, type IntegrationFieldV1 as aN, type IntegrationMap as aO, type IntegrationMeterReading as aP, type IntegrationNotificationConfig as aQ, type IntegrationObjectV1 as aR, type IntegrationSettings as aS, type IntegrationWithUseCases as aT, type ManagedCallAuth as aU, type ManagedCallErrorResponse as aV, type ManagedCallExecuteRequest as aW, type ManagedCallExecuteResponse as aX, type ManagedCallOperation as aY, type ManagedCallOperationConfig as aZ, type ManagedCallUseCase as a_, type ErrorResponseBase as aa, type ExecuteErpImportRequest as ab, type ExternalMonitoringSpan as ac, type FileProxyAuth as ad, type FileProxyDeliveryConfig as ae, type FileProxyFanOutConfig as af, type FileProxyParam as ag, type FileProxyResponseConfig as ah, type FileProxySecureProxyAttachment as ai, type FileProxyStep as aj, type FileProxyUploadConfig as ak, type FileProxyUrlConfig as al, type FileProxyUrlParam as am, type FileProxyUrlParams as an, type FileProxyUseCase as ao, type FileProxyUseCaseConfiguration as ap, type FileProxyUseCaseHistoryEntry as aq, type GenerateTypesPreviewResponse as ar, type GenerateTypesRequest as as, type GenerateTypesResponse as at, type GetMonitoringStatsRequest as au, type GetMonitoringStatsV2Request as av, type GetMonitoringTimeSeriesRequest as aw, type GetMonitoringTimeSeriesV2Request as ax, type InboundIntegrationEventConfiguration as ay, type InboundMonitoringEvent as az, type PathsDictionary as b, type SecureProxyResponse as b$, type MappedFieldValue as b0, type MappingSimulationRequest as b1, type MappingSimulationResponse as b2, type MappingSimulationV2Request as b3, type MappingSimulationWarning as b4, type MeterReadingPruneScopeConfig as b5, type MeterReadingPruneScopeUpdate as b6, type MeterReadingUpdate as b7, type MeterUniqueIdsConfig as b8, type MonitoringCode as b9, type PollDeliveryConfig as bA, type PollOutboundMessagesRequest as bB, type PollOutboundMessagesResponse as bC, type PortalOrigin as bD, type PortalRefConfig as bE, type PortalRefFilter as bF, type PruneScopeConfig as bG, type QueryAccessLogsRequest as bH, type QueryEventsRequest as bI, type QueryInboundMonitoringEventsRequest as bJ, type QueryMonitoringEventsV2Request as bK, type QueryOutboundMonitoringEventsRequest as bL, type RedriveOutboundDlqRequest as bM, type RedriveOutboundDlqResponse as bN, type RedriveOutboundDlqResult as bO, type RelationConfig as bP, type RelationItemConfig as bQ, type RelationRefItemConfig as bR, type RelationRefValueConfig as bS, type RelationRefsConfig as bT, type RelationUniqueIdField as bU, type RepeatableFieldType as bV, type ReplayEventsRequest as bW, type RuleBaselineBucket as bX, type RuleBaselineStatus as bY, type S3Reference as bZ, type SecureProxyRequest as b_, type MonitoringEventV2 as ba, type MonitoringStats as bb, type MonitoringStatsV2 as bc, type MonitoringTraceResponse as bd, type NotificationChannelSet as be, type NotificationDigestConfig as bf, type NotificationHistoryItem as bg, type NotificationHistoryResponse as bh, type NotificationRecipient as bi, type NotificationRule as bj, type NotificationRuleStatus as bk, type NotificationStatusResponse as bl, type OutboundConflict as bm, type OutboundDlqListResponse as bn, type OutboundDlqMessage as bo, type OutboundFileProxyTargetStatus as bp, type OutboundIntegrationEventConfiguration as bq, type OutboundMapping as br, type OutboundMappingSimulationError as bs, type OutboundMessage as bt, type OutboundMonitoringEvent as bu, type OutboundPollStatus as bv, type OutboundStatusResponse as bw, type OutboundUseCase as bx, type OutboundUseCaseHistoryEntry as by, type OutboundUseCaseStatus as bz, type AckOutboundMessagesRequest as c, type SecureProxySummary as c0, type SecureProxyUpstreamError as c1, type SecureProxyUseCase as c2, type SecureProxyUseCaseConfiguration as c3, type SecureProxyUseCaseHistoryEntry as c4, type SecureProxyWhitelist as c5, type SecureProxyWhitelistUpdate as c6, type SetIntegrationAppMappingRequest as c7, type SimulateOutboundMappingRequest as c8, type SimulateOutboundMappingResponse as c9, type UseCaseTypePreview as cA, type ValidateErpImportRequest as cB, type WebhookDeliveryConfig as cC, type WebhookStatus as cD, type SuggestErpImportUseCasesResponse as ca, type TestNotificationRequest as cb, type TestNotificationResponse as cc, type TimeSeriesBreakdownItemV2 as cd, type TimeSeriesBucket as ce, type TimeSeriesBucketV2 as cf, type TriggerErpActionRequest as cg, type TriggerWebhookResp as ch, type TypeAnnotations as ci, type TypeDescriptor as cj, type UnblockOutboundStreamRequest as ck, type UnblockOutboundStreamResponse as cl, type UpdateFileProxyUseCaseRequest as cm, type UpdateInboundUseCaseRequest as cn, type UpdateIntegrationRequest as co, type UpdateManagedCallUseCaseRequest as cp, type UpdateOutboundUseCaseRequest as cq, type UpdateSecureProxyUseCaseRequest as cr, type UpdateUseCaseRequest as cs, type UpdateUseCaseRequestBase as ct, type UpsertDocumentationPageRequest as cu, type UpsertIntegrationWithUseCasesRequest as cv, type UseCase as cw, type UseCaseBase as cx, type UseCaseHistoryEntry as cy, type UseCaseHistoryEntryBase as cz, type AckOutboundMessagesResponse as d, type AckResult as e, type AutoRefreshSettings as f, type CommitTypesRequest as g, type CommitTypesResponse as h, type ConnectorConfig as i, type CreateErpImportRequest as j, type CreateErpImportResponse as k, type CreateFileProxyUseCaseRequest as l, type CreateInboundUseCaseRequest as m, type CreateIntegrationRequest as n, type CreateManagedCallUseCaseRequest as o, type CreateOutboundUseCaseRequest as p, type CreateSecureProxyUseCaseRequest as q, type CreateUseCaseRequest as r, type CreateUseCaseRequestBase as s, type DeliveryConfig as t, type DirectEntityOperation as u, type DirectMeterReadingOperation as v, type DirectPayload as w, type DirectRelationItem as x, type DirectRelationRefItem as y, type DirectRelationRefValue as z };
+export { type ErpImportEntityDetail as $, type AccessLogEntry as A, type DirectRelationValue as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type DirectSimulationError as E, type DirectSimulationRequest as F, type DirectSimulationResponse as G, type DocumentationPage as H, type DocumentationPageSummary as I, type EmbeddedFileProxyUseCaseRequest as J, type EmbeddedInboundUseCaseRequest as K, type EmbeddedManagedCallUseCaseRequest as L, type EmbeddedOutboundUseCaseRequest as M, type EmbeddedSecureProxyUseCaseRequest as N, type OperationMethods as O, Paths as P, type EmbeddedUseCaseRequest as Q, type EmbeddedUseCaseRequestBase as R, type EntityPruneScopeUpdate as S, type EntitySyncState as T, type EntitySyncStatusResponse as U, type EntityUpdate as V, type EnvVarRefConfig as W, type EnvironmentFieldConfig as X, type ErpEvent as Y, type ErpEventV3 as Z, type ErpImportDownload as _, Components as a, type ManagedCallUseCase as a$, type ErpImportError as a0, type ErpImportFilePreview as a1, type ErpImportIssue as a2, type ErpImportJob as a3, type ErpImportList as a4, type ErpImportProgress as a5, type ErpImportUseCaseSuggestion as a6, type ErpImportValidation as a7, type ErpUpdatesEventsV2Request as a8, type ErpUpdatesEventsV3Request as a9, type InboundMonitoringEvent as aA, type InboundUseCase as aB, type InboundUseCaseHistoryEntry as aC, type IngestExternalMonitoringEventsRequest as aD, type IngestExternalMonitoringEventsResponse as aE, type Integration as aF, type IntegrationAppMapping as aG, type IntegrationConfigurationV1 as aH, type IntegrationConfigurationV2 as aI, type IntegrationEditableFields as aJ, type IntegrationEntity as aK, type IntegrationEntityConditional as aL, type IntegrationEntityField as aM, type IntegrationEntityFromRows as aN, type IntegrationFieldV1 as aO, type IntegrationMap as aP, type IntegrationMeterReading as aQ, type IntegrationNotificationConfig as aR, type IntegrationObjectV1 as aS, type IntegrationSettings as aT, type IntegrationWithUseCases as aU, type ManagedCallAuth as aV, type ManagedCallErrorResponse as aW, type ManagedCallExecuteRequest as aX, type ManagedCallExecuteResponse as aY, type ManagedCallOperation as aZ, type ManagedCallOperationConfig as a_, type ErrorResponseBase as aa, type ExecuteErpImportRequest as ab, type ExternalMonitoringSpan as ac, type FileProxyAuth as ad, type FileProxyDeliveryConfig as ae, type FileProxyFanOutConfig as af, type FileProxyParam as ag, type FileProxyResponseConfig as ah, type FileProxySecureProxyAttachment as ai, type FileProxyStep as aj, type FileProxyUploadConfig as ak, type FileProxyUrlConfig as al, type FileProxyUrlParam as am, type FileProxyUrlParams as an, type FileProxyUseCase as ao, type FileProxyUseCaseConfiguration as ap, type FileProxyUseCaseHistoryEntry as aq, type GenerateTypesPreviewResponse as ar, type GenerateTypesRequest as as, type GenerateTypesResponse as at, type GetMonitoringRunCompletionV2Request as au, type GetMonitoringStatsRequest as av, type GetMonitoringStatsV2Request as aw, type GetMonitoringTimeSeriesRequest as ax, type GetMonitoringTimeSeriesV2Request as ay, type InboundIntegrationEventConfiguration as az, type PathsDictionary as b, type RuleBaselineBucket as b$, type ManagedCallUseCaseHistoryEntry as b0, type MappedFieldValue as b1, type MappingSimulationRequest as b2, type MappingSimulationResponse as b3, type MappingSimulationV2Request as b4, type MappingSimulationWarning as b5, type MeterReadingPruneScopeConfig as b6, type MeterReadingPruneScopeUpdate as b7, type MeterReadingUpdate as b8, type MeterUniqueIdsConfig as b9, type OutboundStatusResponse as bA, type OutboundUseCase as bB, type OutboundUseCaseHistoryEntry as bC, type OutboundUseCaseStatus as bD, type PollDeliveryConfig as bE, type PollOutboundMessagesRequest as bF, type PollOutboundMessagesResponse as bG, type PortalOrigin as bH, type PortalRefConfig as bI, type PortalRefFilter as bJ, type PruneScopeConfig as bK, type QueryAccessLogsRequest as bL, type QueryEventsRequest as bM, type QueryInboundMonitoringEventsRequest as bN, type QueryMonitoringEventsV2Request as bO, type QueryOutboundMonitoringEventsRequest as bP, type RedriveOutboundDlqRequest as bQ, type RedriveOutboundDlqResponse as bR, type RedriveOutboundDlqResult as bS, type RelationConfig as bT, type RelationItemConfig as bU, type RelationRefItemConfig as bV, type RelationRefValueConfig as bW, type RelationRefsConfig as bX, type RelationUniqueIdField as bY, type RepeatableFieldType as bZ, type ReplayEventsRequest as b_, type MonitoringCode as ba, type MonitoringEventV2 as bb, type MonitoringRunCompletionV2 as bc, type MonitoringRunCompletionV2Response as bd, type MonitoringRunEntriesV2 as be, type MonitoringStats as bf, type MonitoringStatsV2 as bg, type MonitoringTraceResponse as bh, type NotificationChannelSet as bi, type NotificationDigestConfig as bj, type NotificationHistoryItem as bk, type NotificationHistoryResponse as bl, type NotificationRecipient as bm, type NotificationRule as bn, type NotificationRuleStatus as bo, type NotificationStatusResponse as bp, type OutboundConflict as bq, type OutboundDlqListResponse as br, type OutboundDlqMessage as bs, type OutboundFileProxyTargetStatus as bt, type OutboundIntegrationEventConfiguration as bu, type OutboundMapping as bv, type OutboundMappingSimulationError as bw, type OutboundMessage as bx, type OutboundMonitoringEvent as by, type OutboundPollStatus as bz, type AckOutboundMessagesRequest as c, type RuleBaselineStatus as c0, type S3Reference as c1, type SecureProxyRequest as c2, type SecureProxyResponse as c3, type SecureProxySummary as c4, type SecureProxyUpstreamError as c5, type SecureProxyUseCase as c6, type SecureProxyUseCaseConfiguration as c7, type SecureProxyUseCaseHistoryEntry as c8, type SecureProxyWhitelist as c9, type UseCase as cA, type UseCaseBase as cB, type UseCaseHistoryEntry as cC, type UseCaseHistoryEntryBase as cD, type UseCaseTypePreview as cE, type ValidateErpImportRequest as cF, type WebhookDeliveryConfig as cG, type WebhookStatus as cH, type SecureProxyWhitelistUpdate as ca, type SetIntegrationAppMappingRequest as cb, type SimulateOutboundMappingRequest as cc, type SimulateOutboundMappingResponse as cd, type SuggestErpImportUseCasesResponse as ce, type TestNotificationRequest as cf, type TestNotificationResponse as cg, type TimeSeriesBreakdownItemV2 as ch, type TimeSeriesBucket as ci, type TimeSeriesBucketV2 as cj, type TriggerErpActionRequest as ck, type TriggerWebhookResp as cl, type TypeAnnotations as cm, type TypeDescriptor as cn, type UnblockOutboundStreamRequest as co, type UnblockOutboundStreamResponse as cp, type UpdateFileProxyUseCaseRequest as cq, type UpdateInboundUseCaseRequest as cr, type UpdateIntegrationRequest as cs, type UpdateManagedCallUseCaseRequest as ct, type UpdateOutboundUseCaseRequest as cu, type UpdateSecureProxyUseCaseRequest as cv, type UpdateUseCaseRequest as cw, type UpdateUseCaseRequestBase as cx, type UpsertDocumentationPageRequest as cy, type UpsertIntegrationWithUseCasesRequest as cz, type AckOutboundMessagesResponse as d, type AckResult as e, type AutoRefreshSettings as f, type CommitTypesRequest as g, type CommitTypesResponse as h, type ConnectorConfig as i, type CreateErpImportRequest as j, type CreateErpImportResponse as k, type CreateFileProxyUseCaseRequest as l, type CreateInboundUseCaseRequest as m, type CreateIntegrationRequest as n, type CreateManagedCallUseCaseRequest as o, type CreateOutboundUseCaseRequest as p, type CreateSecureProxyUseCaseRequest as q, type CreateUseCaseRequest as r, type CreateUseCaseRequestBase as s, type DeliveryConfig as t, type DirectEntityOperation as u, type DirectMeterReadingOperation as v, type DirectPayload as w, type DirectRelationItem as x, type DirectRelationRefItem as y, type DirectRelationRefValue as z };

package/docs/app.md

@@ -136,6 +136,8 @@ const { data } = await appClient.getPublicFacingComponent(...)
 - [`ApiProxyConfig`](#apiproxyconfig)
 - [`ExternalValuesConfig`](#externalvaluesconfig)
 - [`ExternalValuesHook`](#externalvalueshook)
+- [`ContextRequirement`](#contextrequirement)
+- [`EntityContextRequirement`](#entitycontextrequirement)
 - [`ExternalValuesResult`](#externalvaluesresult)
 - [`Grants`](#grants)
 - [`BlueprintRef`](#blueprintref)
@@ -2268,6 +2270,7 @@ type ExternalValuesComponent = {
       result: { ... }
       timeout_ms?: { ... }
       on_unavailable?: { ... }
+      contexts?: { ... }
       cache?: { ... }
       secure_proxy?: { ... }
     }>
@@ -3793,6 +3796,10 @@ type ExternalValuesConfig = {
     }>
     timeout_ms?: number
     on_unavailable?: "skip" | "block"
+    contexts?: Array<{
+      type: { ... }
+      schema: { ... }
+    }>
     cache?: {
       ttl_seconds: { ... }
       key?: { ... }
@@ -3807,8 +3814,9 @@ type ExternalValuesConfig = {
 
 ### `ExternalValuesHook`
 
-One external call that returns one or more typed results. Interpolated templates (Liquid) have access to `Input`, `Context`, `Consumer`, `Options`, `Env` and — for `result` templates — `Response` and `AuthResponse`.
+One external call that returns one or more typed results. Interpolated templates (Liquid) have access to `Context`, `Consumer`, `Options`, `Env` and — for `result` templates — `Response` and `AuthResponse` (each is also available snake_case, e.g. `{{ context.contract }}`).
 
+`Context` is the name → v
 
 ```ts
 type ExternalValuesHook = {
@@ -3855,6 +3863,10 @@ type ExternalValuesHook = {
   }>
   timeout_ms?: number
   on_unavailable?: "skip" | "block"
+  contexts?: Array<{
+    type: "entity"
+    schema: string
+  }>
   cache?: {
     ttl_seconds: number
     key?: string
@@ -3866,6 +3878,28 @@ type ExternalValuesHook = {
 }
 ```
 
+### `ContextRequirement`
+
+A requirement a hook reads from `Context`, discriminated by `type`. More types will be added later; consumers must ignore types they do not know.
+
+```ts
+type ContextRequirement = {
+  type: "entity"
+  schema: string
+}
+```
+
+### `EntityContextRequirement`
+
+The consumer supplies the bound entities of `schema` under `Context.`<schema>``.
+
+```ts
+type EntityContextRequirement = {
+  type: "entity"
+  schema: string
+}
+```
+
 ### `ExternalValuesResult`
 
 A single typed value extracted from the hook response. Exactly one of `template`, `path` or `jsonata` must be set.