@epilot/sdk 2.20.76 → 2.20.78

package/dist/{app.d-CZELwNO3.d.cts → app.d-cnyQ-loP.d.cts}

@@ -919,6 +919,10 @@ declare namespace Components {
                 versioned_by?: string;
             };
         }
+        /**
+         * A requirement a hook reads from `Context`, discriminated by `type`. More types will be added later; consumers must ignore types they do not know.
+         */
+        export type 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. */ /* The consumer supplies the bound entities of `schema` under `Context.<schema>`. */ EntityContextRequirement | /* The consumer supplies one scalar value under `Context.<name>`, e.g. a date the customer entered in a journey block. A value input is optional: the consumer sends it when it has a value and omits it otherwise, so the hook's templates must cope with its absence, e.g. `{{ Context.reading_date | default: "now" | date: "%Y-%m-%d" }}`. `date` values are ISO 8601 strings (`YYYY-MM-DD` or a date-time). */ ValueContextRequirement;
         export interface CustomCapabilityComponent {
             component_type: "CUSTOM_CAPABILITY";
             configuration: {
@@ -986,6 +990,18 @@ declare namespace Components {
              */
             nav_description?: string;
         }
+        /**
+         * The consumer supplies the bound entities of `schema` under `Context.<schema>`.
+         */
+        export interface EntityContextRequirement {
+            type: "entity";
+            /**
+             * Entity schema slug, e.g. `contract`.
+             * example:
+             * contract
+             */
+            schema: string; // ^[a-z0-9_-]{1,100}$
+        }
         export interface EnumArg {
             type?: "enum";
             /**
@@ -1281,17 +1297,17 @@ declare namespace Components {
              * Hooks exposed by this component. Hook ids must be unique within the component.
              */
             hooks: /**
-             * 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.input }}`).
+             * 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 single name → value map the consumer supplies. The names in it are up to the consumer — by convention the journey runtime passes the validated value of a validation rule as `context.input` and every configured context binding under its own configured name.
+             * `Context` is the name → value map the consumer supplies, one entry per context requirement it bound: `Context.<schema>` for an `entity` requirement, `Context.<name>` for a `value` requirement. Declare what a hook reads from `Context` in `contexts` so consumers can require it.
              *
              */
             ExternalValuesHook[];
         }
         /**
-         * 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.input }}`).
+         * 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 single name → value map the consumer supplies. The names in it are up to the consumer — by convention the journey runtime passes the validated value of a validation rule as `context.input` and every configured context binding under its own configured name.
+         * `Context` is the name → value map the consumer supplies, one entry per context requirement it bound: `Context.<schema>` for an `entity` requirement, `Context.<name>` for a `value` requirement. Declare what a hook reads from `Context` in `contexts` so consumers can require it.
          *
          */
         export interface ExternalValuesHook {
@@ -1378,6 +1394,10 @@ declare namespace Components {
              * Behaviour when the external system is unavailable (timeout, network or upstream error). `skip`: consumers ignore conditions depending on this hook. `block`: consumers treat the dependent action as not allowed.
              */
             on_unavailable?: "skip" | "block";
+            /**
+             * The requirements the hook reads from `Context` (at most 10). An `entity` requirement means the consumer supplies the bound entities of that schema under `Context.<schema>` (e.g. `{{ Context.contract[0].external_id }}` needs `{ type: entity, schema: contract }`). A `value` requirement means the consumer supplies one scalar value under `Context.<name>` (e.g. `{{ Context.reading_date }}` needs `{ type: value, name: reading_date, value_type: date }`); value inputs are optional at runtime, so templates must cope with their absence. Entity schemas are unique, value names are unique, and a value name must not equal an entity schema of the same hook (both land in `Context`). More requirement types will be added later; consumers must ignore types they do not know.
+             */
+            contexts?: /* A requirement a hook reads from `Context`, discriminated by `type`. More types will be added later; consumers must ignore types they do not know. */ ContextRequirement[];
             /**
              * Response caching. Off when omitted.
              */
@@ -3237,6 +3257,24 @@ declare namespace Components {
              */
             de: string;
         }
+        /**
+         * The consumer supplies one scalar value under `Context.<name>`, e.g. a date the customer entered in a journey block. A value input is optional: the consumer sends it when it has a value and omits it otherwise, so the hook's templates must cope with its absence, e.g. `{{ Context.reading_date | default: "now" | date: "%Y-%m-%d" }}`. `date` values are ISO 8601 strings (`YYYY-MM-DD` or a date-time).
+         */
+        export interface ValueContextRequirement {
+            type: "value";
+            /**
+             * Key under which the value is sent (`Context.<name>`). Same pattern as validation rule parameter names. Unique among the hook's `value` requirements and must not equal the `schema` of an `entity` requirement of the same hook.
+             * example:
+             * reading_date
+             */
+            name: string; // ^[a-z][a-z0-9_]{0,63}$
+            /**
+             * Type of the value: `number` and `boolean` are sent as JSON numbers and booleans, `text` as a string, `date` as an ISO 8601 string (`YYYY-MM-DD` or a date-time).
+             * example:
+             * date
+             */
+            value_type: "number" | "text" | "date" | "boolean";
+        }
     }
 }
 declare namespace Paths {
@@ -4708,11 +4746,13 @@ type ComponentType = Components.Schemas.ComponentType;
 type Configuration = Components.Schemas.Configuration;
 type ConfigurationMetadata = Components.Schemas.ConfigurationMetadata;
 type ConfigurationVersion = Components.Schemas.ConfigurationVersion;
+type ContextRequirement = Components.Schemas.ContextRequirement;
 type CustomCapabilityComponent = Components.Schemas.CustomCapabilityComponent;
 type CustomFlowActionComponent = Components.Schemas.CustomFlowActionComponent;
 type CustomFlowConfig = Components.Schemas.CustomFlowConfig;
 type CustomPageComponent = Components.Schemas.CustomPageComponent;
 type CustomPageConfig = Components.Schemas.CustomPageConfig;
+type EntityContextRequirement = Components.Schemas.EntityContextRequirement;
 type EnumArg = Components.Schemas.EnumArg;
 type ErpInformToolkitComponent = Components.Schemas.ErpInformToolkitComponent;
 type EventsQuery = Components.Schemas.EventsQuery;
@@ -4769,5 +4809,6 @@ type Role = Components.Schemas.Role;
 type S3Reference = Components.Schemas.S3Reference;
 type TextArg = Components.Schemas.TextArg;
 type TranslatedString = Components.Schemas.TranslatedString;
+type ValueContextRequirement = Components.Schemas.ValueContextRequirement;
 
-export { type NotificationConfig as $, type Actor as A, type BaseComponent as B, type Client as C, type ErpInformToolkitComponent as D, type EnumArg as E, type EventsQuery as F, type EventsQueryResponse as G, type ExternalIntegrationCustomActionConfig as H, type ExternalProductCatalogAuthBlock as I, type ExternalProductCatalogComponent as J, type ExternalProductCatalogConfig as K, type ExternalProductCatalogHookProductRecommendations as L, type ExternalProductCatalogHookProducts as M, type ExternalValuesComponent as N, type OperationMethods as O, Paths as P, type ExternalValuesConfig as Q, type ExternalValuesHook as R, type ExternalValuesResult as S, type FunctionDefinition as T, type FunctionRefCustomActionConfig as U, type Grants as V, type Installation as W, type InternalReview as X, type JourneyBlockComponent as Y, type JourneyBlockComponentArgs as Z, type JourneyBlockConfig as _, Components as a, type NotificationEvent as a0, type ObjectField as a1, type Option as a2, type Options as a3, type OptionsRef as a4, type OverrideDevMode as a5, type PortalBlockComponent as a6, type PortalBlockConfig as a7, type PortalBlockSurfaceConfig as a8, type PortalExtensionAuthBlock as a9, type PortalExtensionComponent as aa, type PortalExtensionConfig as ab, type PortalExtensionHookChangeEmail as ac, type PortalExtensionHookChangePassword as ad, type PortalExtensionHookConsumptionDataRetrieval as ae, type PortalExtensionHookContractIdentification as af, type PortalExtensionHookCostDataRetrieval as ag, type PortalExtensionHookDataExport as ah, type PortalExtensionHookDeleteAccount as ai, type PortalExtensionHookMeterReadingPlausibilityCheck as aj, type PortalExtensionHookPriceDataRetrieval as ak, type PortalExtensionHookRegistrationIdentifiersCheck as al, type PortalExtensionHookVisualizationMetadata as am, type PortalExtensionSeamlessLink as an, type PortalExtensionSecureProxy as ao, type Pricing as ap, type PublicConfiguration as aq, type RawEvents as ar, type Review as as, type Role as at, type S3Reference as au, type TextArg as av, type TranslatedString as aw, type PathsDictionary as b, type AggregatedEvents as c, type ApiProxyComponent as d, type ApiProxyConfig as e, type AppBridgeSurfaceConfig as f, type AppEventData as g, type Audit as h, type Author as i, type BaseComponentCommon as j, type BaseCustomActionConfig as k, type BatchEventRequest as l, type BillingFrequency as m, type BlockReferenceArg as n, type BlueprintRef as o, type BooleanArg as p, type CallerIdentity as q, type ComponentType as r, type Configuration as s, type ConfigurationMetadata as t, type ConfigurationVersion as u, type CustomCapabilityComponent as v, type CustomFlowActionComponent as w, type CustomFlowConfig as x, type CustomPageComponent as y, type CustomPageConfig as z };
+export { type JourneyBlockComponentArgs as $, type Actor as A, type BaseComponent as B, type Client as C, type CustomPageConfig as D, type EntityContextRequirement as E, type EnumArg as F, type ErpInformToolkitComponent as G, type EventsQuery as H, type EventsQueryResponse as I, type ExternalIntegrationCustomActionConfig as J, type ExternalProductCatalogAuthBlock as K, type ExternalProductCatalogComponent as L, type ExternalProductCatalogConfig as M, type ExternalProductCatalogHookProductRecommendations as N, type OperationMethods as O, Paths as P, type ExternalProductCatalogHookProducts as Q, type ExternalValuesComponent as R, type ExternalValuesConfig as S, type ExternalValuesHook as T, type ExternalValuesResult as U, type FunctionDefinition as V, type FunctionRefCustomActionConfig as W, type Grants as X, type Installation as Y, type InternalReview as Z, type JourneyBlockComponent as _, Components as a, type JourneyBlockConfig as a0, type NotificationConfig as a1, type NotificationEvent as a2, type ObjectField as a3, type Option as a4, type Options as a5, type OptionsRef as a6, type OverrideDevMode as a7, type PortalBlockComponent as a8, type PortalBlockConfig as a9, type PortalBlockSurfaceConfig as aa, type PortalExtensionAuthBlock as ab, type PortalExtensionComponent as ac, type PortalExtensionConfig as ad, type PortalExtensionHookChangeEmail as ae, type PortalExtensionHookChangePassword as af, type PortalExtensionHookConsumptionDataRetrieval as ag, type PortalExtensionHookContractIdentification as ah, type PortalExtensionHookCostDataRetrieval as ai, type PortalExtensionHookDataExport as aj, type PortalExtensionHookDeleteAccount as ak, type PortalExtensionHookMeterReadingPlausibilityCheck as al, type PortalExtensionHookPriceDataRetrieval as am, type PortalExtensionHookRegistrationIdentifiersCheck as an, type PortalExtensionHookVisualizationMetadata as ao, type PortalExtensionSeamlessLink as ap, type PortalExtensionSecureProxy as aq, type Pricing as ar, type PublicConfiguration as as, type RawEvents as at, type Review as au, type Role as av, type S3Reference as aw, type TextArg as ax, type TranslatedString as ay, type ValueContextRequirement as az, type PathsDictionary as b, type AggregatedEvents as c, type ApiProxyComponent as d, type ApiProxyConfig as e, type AppBridgeSurfaceConfig as f, type AppEventData as g, type Audit as h, type Author as i, type BaseComponentCommon as j, type BaseCustomActionConfig as k, type BatchEventRequest as l, type BillingFrequency as m, type BlockReferenceArg as n, type BlueprintRef as o, type BooleanArg as p, type CallerIdentity as q, type ComponentType as r, type Configuration as s, type ConfigurationMetadata as t, type ConfigurationVersion as u, type ContextRequirement as v, type CustomCapabilityComponent as w, type CustomFlowActionComponent as x, type CustomFlowConfig as y, type CustomPageComponent as z };

package/dist/{app.d-CZELwNO3.d.ts → app.d-cnyQ-loP.d.ts}

@@ -919,6 +919,10 @@ declare namespace Components {
                 versioned_by?: string;
             };
         }
+        /**
+         * A requirement a hook reads from `Context`, discriminated by `type`. More types will be added later; consumers must ignore types they do not know.
+         */
+        export type 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. */ /* The consumer supplies the bound entities of `schema` under `Context.<schema>`. */ EntityContextRequirement | /* The consumer supplies one scalar value under `Context.<name>`, e.g. a date the customer entered in a journey block. A value input is optional: the consumer sends it when it has a value and omits it otherwise, so the hook's templates must cope with its absence, e.g. `{{ Context.reading_date | default: "now" | date: "%Y-%m-%d" }}`. `date` values are ISO 8601 strings (`YYYY-MM-DD` or a date-time). */ ValueContextRequirement;
         export interface CustomCapabilityComponent {
             component_type: "CUSTOM_CAPABILITY";
             configuration: {
@@ -986,6 +990,18 @@ declare namespace Components {
              */
             nav_description?: string;
         }
+        /**
+         * The consumer supplies the bound entities of `schema` under `Context.<schema>`.
+         */
+        export interface EntityContextRequirement {
+            type: "entity";
+            /**
+             * Entity schema slug, e.g. `contract`.
+             * example:
+             * contract
+             */
+            schema: string; // ^[a-z0-9_-]{1,100}$
+        }
         export interface EnumArg {
             type?: "enum";
             /**
@@ -1281,17 +1297,17 @@ declare namespace Components {
              * Hooks exposed by this component. Hook ids must be unique within the component.
              */
             hooks: /**
-             * 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.input }}`).
+             * 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 single name → value map the consumer supplies. The names in it are up to the consumer — by convention the journey runtime passes the validated value of a validation rule as `context.input` and every configured context binding under its own configured name.
+             * `Context` is the name → value map the consumer supplies, one entry per context requirement it bound: `Context.<schema>` for an `entity` requirement, `Context.<name>` for a `value` requirement. Declare what a hook reads from `Context` in `contexts` so consumers can require it.
              *
              */
             ExternalValuesHook[];
         }
         /**
-         * 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.input }}`).
+         * 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 single name → value map the consumer supplies. The names in it are up to the consumer — by convention the journey runtime passes the validated value of a validation rule as `context.input` and every configured context binding under its own configured name.
+         * `Context` is the name → value map the consumer supplies, one entry per context requirement it bound: `Context.<schema>` for an `entity` requirement, `Context.<name>` for a `value` requirement. Declare what a hook reads from `Context` in `contexts` so consumers can require it.
          *
          */
         export interface ExternalValuesHook {
@@ -1378,6 +1394,10 @@ declare namespace Components {
              * Behaviour when the external system is unavailable (timeout, network or upstream error). `skip`: consumers ignore conditions depending on this hook. `block`: consumers treat the dependent action as not allowed.
              */
             on_unavailable?: "skip" | "block";
+            /**
+             * The requirements the hook reads from `Context` (at most 10). An `entity` requirement means the consumer supplies the bound entities of that schema under `Context.<schema>` (e.g. `{{ Context.contract[0].external_id }}` needs `{ type: entity, schema: contract }`). A `value` requirement means the consumer supplies one scalar value under `Context.<name>` (e.g. `{{ Context.reading_date }}` needs `{ type: value, name: reading_date, value_type: date }`); value inputs are optional at runtime, so templates must cope with their absence. Entity schemas are unique, value names are unique, and a value name must not equal an entity schema of the same hook (both land in `Context`). More requirement types will be added later; consumers must ignore types they do not know.
+             */
+            contexts?: /* A requirement a hook reads from `Context`, discriminated by `type`. More types will be added later; consumers must ignore types they do not know. */ ContextRequirement[];
             /**
              * Response caching. Off when omitted.
              */
@@ -3237,6 +3257,24 @@ declare namespace Components {
              */
             de: string;
         }
+        /**
+         * The consumer supplies one scalar value under `Context.<name>`, e.g. a date the customer entered in a journey block. A value input is optional: the consumer sends it when it has a value and omits it otherwise, so the hook's templates must cope with its absence, e.g. `{{ Context.reading_date | default: "now" | date: "%Y-%m-%d" }}`. `date` values are ISO 8601 strings (`YYYY-MM-DD` or a date-time).
+         */
+        export interface ValueContextRequirement {
+            type: "value";
+            /**
+             * Key under which the value is sent (`Context.<name>`). Same pattern as validation rule parameter names. Unique among the hook's `value` requirements and must not equal the `schema` of an `entity` requirement of the same hook.
+             * example:
+             * reading_date
+             */
+            name: string; // ^[a-z][a-z0-9_]{0,63}$
+            /**
+             * Type of the value: `number` and `boolean` are sent as JSON numbers and booleans, `text` as a string, `date` as an ISO 8601 string (`YYYY-MM-DD` or a date-time).
+             * example:
+             * date
+             */
+            value_type: "number" | "text" | "date" | "boolean";
+        }
     }
 }
 declare namespace Paths {
@@ -4708,11 +4746,13 @@ type ComponentType = Components.Schemas.ComponentType;
 type Configuration = Components.Schemas.Configuration;
 type ConfigurationMetadata = Components.Schemas.ConfigurationMetadata;
 type ConfigurationVersion = Components.Schemas.ConfigurationVersion;
+type ContextRequirement = Components.Schemas.ContextRequirement;
 type CustomCapabilityComponent = Components.Schemas.CustomCapabilityComponent;
 type CustomFlowActionComponent = Components.Schemas.CustomFlowActionComponent;
 type CustomFlowConfig = Components.Schemas.CustomFlowConfig;
 type CustomPageComponent = Components.Schemas.CustomPageComponent;
 type CustomPageConfig = Components.Schemas.CustomPageConfig;
+type EntityContextRequirement = Components.Schemas.EntityContextRequirement;
 type EnumArg = Components.Schemas.EnumArg;
 type ErpInformToolkitComponent = Components.Schemas.ErpInformToolkitComponent;
 type EventsQuery = Components.Schemas.EventsQuery;
@@ -4769,5 +4809,6 @@ type Role = Components.Schemas.Role;
 type S3Reference = Components.Schemas.S3Reference;
 type TextArg = Components.Schemas.TextArg;
 type TranslatedString = Components.Schemas.TranslatedString;
+type ValueContextRequirement = Components.Schemas.ValueContextRequirement;
 
-export { type NotificationConfig as $, type Actor as A, type BaseComponent as B, type Client as C, type ErpInformToolkitComponent as D, type EnumArg as E, type EventsQuery as F, type EventsQueryResponse as G, type ExternalIntegrationCustomActionConfig as H, type ExternalProductCatalogAuthBlock as I, type ExternalProductCatalogComponent as J, type ExternalProductCatalogConfig as K, type ExternalProductCatalogHookProductRecommendations as L, type ExternalProductCatalogHookProducts as M, type ExternalValuesComponent as N, type OperationMethods as O, Paths as P, type ExternalValuesConfig as Q, type ExternalValuesHook as R, type ExternalValuesResult as S, type FunctionDefinition as T, type FunctionRefCustomActionConfig as U, type Grants as V, type Installation as W, type InternalReview as X, type JourneyBlockComponent as Y, type JourneyBlockComponentArgs as Z, type JourneyBlockConfig as _, Components as a, type NotificationEvent as a0, type ObjectField as a1, type Option as a2, type Options as a3, type OptionsRef as a4, type OverrideDevMode as a5, type PortalBlockComponent as a6, type PortalBlockConfig as a7, type PortalBlockSurfaceConfig as a8, type PortalExtensionAuthBlock as a9, type PortalExtensionComponent as aa, type PortalExtensionConfig as ab, type PortalExtensionHookChangeEmail as ac, type PortalExtensionHookChangePassword as ad, type PortalExtensionHookConsumptionDataRetrieval as ae, type PortalExtensionHookContractIdentification as af, type PortalExtensionHookCostDataRetrieval as ag, type PortalExtensionHookDataExport as ah, type PortalExtensionHookDeleteAccount as ai, type PortalExtensionHookMeterReadingPlausibilityCheck as aj, type PortalExtensionHookPriceDataRetrieval as ak, type PortalExtensionHookRegistrationIdentifiersCheck as al, type PortalExtensionHookVisualizationMetadata as am, type PortalExtensionSeamlessLink as an, type PortalExtensionSecureProxy as ao, type Pricing as ap, type PublicConfiguration as aq, type RawEvents as ar, type Review as as, type Role as at, type S3Reference as au, type TextArg as av, type TranslatedString as aw, type PathsDictionary as b, type AggregatedEvents as c, type ApiProxyComponent as d, type ApiProxyConfig as e, type AppBridgeSurfaceConfig as f, type AppEventData as g, type Audit as h, type Author as i, type BaseComponentCommon as j, type BaseCustomActionConfig as k, type BatchEventRequest as l, type BillingFrequency as m, type BlockReferenceArg as n, type BlueprintRef as o, type BooleanArg as p, type CallerIdentity as q, type ComponentType as r, type Configuration as s, type ConfigurationMetadata as t, type ConfigurationVersion as u, type CustomCapabilityComponent as v, type CustomFlowActionComponent as w, type CustomFlowConfig as x, type CustomPageComponent as y, type CustomPageConfig as z };
+export { type JourneyBlockComponentArgs as $, type Actor as A, type BaseComponent as B, type Client as C, type CustomPageConfig as D, type EntityContextRequirement as E, type EnumArg as F, type ErpInformToolkitComponent as G, type EventsQuery as H, type EventsQueryResponse as I, type ExternalIntegrationCustomActionConfig as J, type ExternalProductCatalogAuthBlock as K, type ExternalProductCatalogComponent as L, type ExternalProductCatalogConfig as M, type ExternalProductCatalogHookProductRecommendations as N, type OperationMethods as O, Paths as P, type ExternalProductCatalogHookProducts as Q, type ExternalValuesComponent as R, type ExternalValuesConfig as S, type ExternalValuesHook as T, type ExternalValuesResult as U, type FunctionDefinition as V, type FunctionRefCustomActionConfig as W, type Grants as X, type Installation as Y, type InternalReview as Z, type JourneyBlockComponent as _, Components as a, type JourneyBlockConfig as a0, type NotificationConfig as a1, type NotificationEvent as a2, type ObjectField as a3, type Option as a4, type Options as a5, type OptionsRef as a6, type OverrideDevMode as a7, type PortalBlockComponent as a8, type PortalBlockConfig as a9, type PortalBlockSurfaceConfig as aa, type PortalExtensionAuthBlock as ab, type PortalExtensionComponent as ac, type PortalExtensionConfig as ad, type PortalExtensionHookChangeEmail as ae, type PortalExtensionHookChangePassword as af, type PortalExtensionHookConsumptionDataRetrieval as ag, type PortalExtensionHookContractIdentification as ah, type PortalExtensionHookCostDataRetrieval as ai, type PortalExtensionHookDataExport as aj, type PortalExtensionHookDeleteAccount as ak, type PortalExtensionHookMeterReadingPlausibilityCheck as al, type PortalExtensionHookPriceDataRetrieval as am, type PortalExtensionHookRegistrationIdentifiersCheck as an, type PortalExtensionHookVisualizationMetadata as ao, type PortalExtensionSeamlessLink as ap, type PortalExtensionSecureProxy as aq, type Pricing as ar, type PublicConfiguration as as, type RawEvents as at, type Review as au, type Role as av, type S3Reference as aw, type TextArg as ax, type TranslatedString as ay, type ValueContextRequirement as az, type PathsDictionary as b, type AggregatedEvents as c, type ApiProxyComponent as d, type ApiProxyConfig as e, type AppBridgeSurfaceConfig as f, type AppEventData as g, type Audit as h, type Author as i, type BaseComponentCommon as j, type BaseCustomActionConfig as k, type BatchEventRequest as l, type BillingFrequency as m, type BlockReferenceArg as n, type BlueprintRef as o, type BooleanArg as p, type CallerIdentity as q, type ComponentType as r, type Configuration as s, type ConfigurationMetadata as t, type ConfigurationVersion as u, type ContextRequirement as v, type CustomCapabilityComponent as w, type CustomFlowActionComponent as x, type CustomFlowConfig as y, type CustomPageComponent as z };

package/dist/{chunk-H65UWQLJ.cjs → chunk-M5Z7JYJ3.cjs}

@@ -33,7 +33,7 @@ var globImport_docs = _chunkNJK5F5TFcjs.__glob.call(void 0, {
   "./docs/address-suggestions.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./address-suggestions-IUQMYF27.cjs"))),
   "./docs/address.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./address-HA4RMRNQ.cjs"))),
   "./docs/ai-agents.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./ai-agents-HDLQXHEO.cjs"))),
-  "./docs/app.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./app-ERJHXY64.cjs"))),
+  "./docs/app.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./app-7VPZV72D.cjs"))),
   "./docs/audit-logs.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./audit-logs-D2LFUA2R.cjs"))),
   "./docs/automation.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./automation-G2CKAQNB.cjs"))),
   "./docs/billing.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./billing-CKCFSK6K.cjs"))),
@@ -55,7 +55,7 @@ var globImport_docs = _chunkNJK5F5TFcjs.__glob.call(void 0, {
   "./docs/environments.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./environments-QII3AKWU.cjs"))),
   "./docs/erp-integration.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./erp-integration-PAVHSUDM.cjs"))),
   "./docs/event-catalog.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./event-catalog-YYCD2DBK.cjs"))),
-  "./docs/external-values.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./external-values-R2XB2ALG.cjs"))),
+  "./docs/external-values.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./external-values-WET4FHGU.cjs"))),
   "./docs/file.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./file-2KT6MMMG.cjs"))),
   "./docs/iban.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./iban-24GHLFDB.cjs"))),
   "./docs/identity.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./identity-XCFH3MIW.cjs"))),
@@ -82,7 +82,7 @@ var globImport_docs = _chunkNJK5F5TFcjs.__glob.call(void 0, {
   "./docs/targeting.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./targeting-2JCGF4IR.cjs"))),
   "./docs/template-variables.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./template-variables-I72B5WS6.cjs"))),
   "./docs/user.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./user-DR7IAWFI.cjs"))),
-  "./docs/validation-rules.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./validation-rules-QYVRILMT.cjs"))),
+  "./docs/validation-rules.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./validation-rules-2XORVEWP.cjs"))),
   "./docs/webhooks.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./webhooks-PNLMQFE2.cjs"))),
   "./docs/workflow-definition.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./workflow-definition-XTWO4RMY.cjs"))),
   "./docs/workflow.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./workflow-JQT3F5NJ.cjs")))

package/dist/{chunk-OETNMHSD.js → chunk-ZREXF3XS.js}

@@ -33,7 +33,7 @@ var globImport_docs = __glob({
   "./docs/address-suggestions.json": () => import("./address-suggestions-74244BAJ.js"),
   "./docs/address.json": () => import("./address-QVJUGMOG.js"),
   "./docs/ai-agents.json": () => import("./ai-agents-5EG5UUP7.js"),
-  "./docs/app.json": () => import("./app-CKQAJ7EE.js"),
+  "./docs/app.json": () => import("./app-3WUZHA43.js"),
   "./docs/audit-logs.json": () => import("./audit-logs-5VXHOQ7S.js"),
   "./docs/automation.json": () => import("./automation-UPTNUOYO.js"),
   "./docs/billing.json": () => import("./billing-UJ6I7FPG.js"),
@@ -55,7 +55,7 @@ var globImport_docs = __glob({
   "./docs/environments.json": () => import("./environments-MKY6TF4Z.js"),
   "./docs/erp-integration.json": () => import("./erp-integration-SBQJ6HEG.js"),
   "./docs/event-catalog.json": () => import("./event-catalog-R4ZGZQVY.js"),
-  "./docs/external-values.json": () => import("./external-values-7BS76RVR.js"),
+  "./docs/external-values.json": () => import("./external-values-66ANK66M.js"),
   "./docs/file.json": () => import("./file-N3SGGI6E.js"),
   "./docs/iban.json": () => import("./iban-LDKYDVQV.js"),
   "./docs/identity.json": () => import("./identity-OT3MIWHV.js"),
@@ -82,7 +82,7 @@ var globImport_docs = __glob({
   "./docs/targeting.json": () => import("./targeting-2NHAG7B5.js"),
   "./docs/template-variables.json": () => import("./template-variables-6CLOG67C.js"),
   "./docs/user.json": () => import("./user-7W5JUUKB.js"),
-  "./docs/validation-rules.json": () => import("./validation-rules-D4OW6VYI.js"),
+  "./docs/validation-rules.json": () => import("./validation-rules-Y5BLH5AA.js"),
   "./docs/webhooks.json": () => import("./webhooks-QYVT2NUP.js"),
   "./docs/workflow-definition.json": () => import("./workflow-definition-MSO4JDA3.js"),
   "./docs/workflow.json": () => import("./workflow-Q6FAE5OL.js")

package/dist/external-values-66ANK66M.js

@@ -0,0 +1,7 @@
+import "./chunk-YPSWSI3M.js";
+
+// src/docs/external-values.json
+var external_values_default = '# External Values API\n\n- **Base URL:** `https://external-values.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/external-values](https://docs.epilot.io/api/external-values)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.externalValues.listExternalValues(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/external-values\'\n\nconst externalValuesClient = getClient()\nauthorize(externalValuesClient, () => \'<token>\')\nconst { data } = await externalValuesClient.listExternalValues(...)\n```\n\n## Operations\n\n**external-values**\n- [`listExternalValues`](#listexternalvalues)\n- [`resolveExternalValue`](#resolveexternalvalue)\n- [`resolvePortalExternalValue`](#resolveportalexternalvalue)\n\n**Schemas**\n- [`TranslatedString`](#translatedstring)\n- [`ExternalValueType`](#externalvaluetype)\n- [`ResolveExternalValueRequest`](#resolveexternalvaluerequest)\n- [`ExternalValueErrorCode`](#externalvalueerrorcode)\n- [`ExternalValueError`](#externalvalueerror)\n- [`ResolveExternalValueResponse`](#resolveexternalvalueresponse)\n- [`ExternalValueResultSummary`](#externalvalueresultsummary)\n- [`ExternalValueHookSummary`](#externalvaluehooksummary)\n- [`ContextRequirement`](#contextrequirement)\n- [`EntityContextRequirement`](#entitycontextrequirement)\n- [`ValueContextRequirement`](#valuecontextrequirement)\n- [`ExternalValueHookList`](#externalvaluehooklist)\n\n### `listExternalValues`\n\nList hooks and their results of all enabled installed apps that declare an\n`EXTERNAL_VALUES` component. Intended for pickers (e.g. the validation-rules builder).\n\n`GET /v1/external-values`\n\n```ts\nconst { data } = await client.listExternalValues()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hooks": [\n    {\n      "app_id": "string",\n      "app_name": "string",\n      "hook_id": "string",\n      "name": {\n        "de": "string",\n        "en": "string"\n      },\n      "description": {\n        "de": "string",\n        "en": "string"\n      },\n      "results": [\n        {\n          "id": "string",\n          "type": "number",\n          "name": {\n            "de": "string",\n            "en": "string"\n          }\n        }\n      ],\n      "contexts": [\n        {\n          "type": "entity",\n          "schema": "contract"\n        }\n      ]\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `resolveExternalValue`\n\nResolve an external value hook for an epilot 360 user (builder preview, entity-attribute\nrules). The organization is taken from the caller\'s token.\n\n`POST /v1/external-values/{app_id}/hooks/{hook_id}:resolve`\n\n```ts\nconst { data } = await client.resolveExternalValue(\n  {\n    app_id: \'example\',\n    hook_id: \'example\',\n  },\n  {\n    context: {\n      contract: [\n        {\n          _id: \'8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a\',\n          external_id: \'C-1001\',\n          installment_amount: 110\n        }\n      ]\n    },\n    consumer: {\n      type: \'validation_rule\',\n      rule_id: \'6c0a9e1e-2f4b-4e6a-8f8e-2b2b2b2b2b2b\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "values": {\n    "predicted": 132\n  },\n  "errors": [\n    {\n      "result_id": "limit",\n      "code": "coercion_failed",\n      "message": "Cannot coerce \\"n/a\\" to number"\n    }\n  ],\n  "policy": {\n    "on_unavailable": "skip"\n  }\n}\n```\n\n</details>\n\n---\n\n### `resolvePortalExternalValue`\n\nResolve an external value hook for a portal end customer (private journeys, portal).\nThe organization is taken from the portal token claims.\n\n`POST /v1/portal/external-values/{app_id}/hooks/{hook_id}:resolve`\n\n```ts\nconst { data } = await client.resolvePortalExternalValue(\n  {\n    app_id: \'example\',\n    hook_id: \'example\',\n  },\n  {\n    context: {\n      contract: [\n        {\n          _id: \'8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a\',\n          external_id: \'C-1001\',\n          installment_amount: 110\n        }\n      ]\n    },\n    consumer: {\n      type: \'validation_rule\',\n      rule_id: \'6c0a9e1e-2f4b-4e6a-8f8e-2b2b2b2b2b2b\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "values": {\n    "predicted": 132\n  },\n  "errors": [\n    {\n      "result_id": "limit",\n      "code": "coercion_failed",\n      "message": "Cannot coerce \\"n/a\\" to number"\n    }\n  ],\n  "policy": {\n    "on_unavailable": "skip"\n  }\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `TranslatedString`\n\n```ts\ntype TranslatedString = {\n  de: string\n  en?: string\n}\n```\n\n### `ExternalValueType`\n\n```ts\ntype ExternalValueType = "number" | "text" | "date" | "boolean"\n```\n\n### `ResolveExternalValueRequest`\n\n```ts\ntype ResolveExternalValueRequest = {\n  context: Record<string, unknown>\n  consumer?: {\n    type?: string\n    rule_id?: string\n    journey_id?: string\n  }\n}\n```\n\n### `ExternalValueErrorCode`\n\n- `timeout`: the third-party call exceeded `timeout_ms`\n- `upstream_error`: the third-party call failed or returned a non-2xx status\n- `auth_failed`: the `auth` pre-call failed\n- `extraction_failed`: template/path/jsonata threw or yielded null / empty\n- `coercion_failed`: the extracted value could n\n\n```ts\ntype ExternalValueErrorCode = "timeout" | "upstream_error" | "auth_failed" | "extraction_failed" | "coercion_failed"\n```\n\n### `ExternalValueError`\n\n```ts\ntype ExternalValueError = {\n  result_id?: string\n  code: "timeout" | "upstream_error" | "auth_failed" | "extraction_failed" | "coercion_failed"\n  message: string\n}\n```\n\n### `ResolveExternalValueResponse`\n\n```ts\ntype ResolveExternalValueResponse = {\n  values: Record<string, number | string | boolean>\n  errors: Array<{\n    result_id?: string\n    code: "timeout" | "upstream_error" | "auth_failed" | "extraction_failed" | "coercion_failed"\n    message: string\n  }>\n  policy: {\n    on_unavailable: "skip" | "block"\n  }\n  cached?: boolean\n}\n```\n\n### `ExternalValueResultSummary`\n\n```ts\ntype ExternalValueResultSummary = {\n  id: string\n  type: "number" | "text" | "date" | "boolean"\n  name: {\n    de: string\n    en?: string\n  }\n}\n```\n\n### `ExternalValueHookSummary`\n\n```ts\ntype ExternalValueHookSummary = {\n  app_id: string\n  app_name: string\n  hook_id: string\n  name: {\n    de: string\n    en?: string\n  }\n  description?: {\n    de: string\n    en?: string\n  }\n  results: Array<{\n    id: string\n    type: "number" | "text" | "date" | "boolean"\n    name: {\n      de: { ... }\n      en?: { ... }\n    }\n  }>\n  contexts?: Array<{\n    type: "entity"\n    schema: string\n  } | {\n    type: "value"\n    name: string\n    value_type: "number" | "text" | "date" | "boolean"\n  }>\n}\n```\n\n### `ContextRequirement`\n\nSomething a hook needs the consumer to supply in `context`, discriminated by `type`:\nbound entities (`entity`) or an optional scalar input (`value`). More types may follow;\nconsumers ignore types they do not know.\n\n\n```ts\ntype ContextRequirement = {\n  type: "entity"\n  schema: string\n} | {\n  type: "value"\n  name: string\n  value_type: "number" | "text" | "date" | "boolean"\n}\n```\n\n### `EntityContextRequirement`\n\nThe consumer supplies the bound entities of `schema` under `Context.`<schema>``, e.g. a hook\ninterpolating `{{ Context.contract[0].external_id }}` declares\n`{ type: entity, schema: contract }`.\n\n\n```ts\ntype EntityContextRequirement = {\n  type: "entity"\n  schema: string\n}\n```\n\n### `ValueContextRequirement`\n\nAn optional scalar input. When the consumer has a value it supplies it under\n`Context.`<name>`` (dates as ISO 8601 strings, `YYYY-MM-DD` or a date-time); otherwise the\nkey is absent, so the hook template must provide a fallback, e.g.\n`{{ Context.reading_date | default: "now" | date: "%Y-%m-%d" }}` dec\n\n```ts\ntype ValueContextRequirement = {\n  type: "value"\n  name: string\n  value_type: "number" | "text" | "date" | "boolean"\n}\n```\n\n### `ExternalValueHookList`\n\n```ts\ntype ExternalValueHookList = {\n  hooks: Array<{\n    app_id: string\n    app_name: string\n    hook_id: string\n    name: {\n      de: { ... }\n      en?: { ... }\n    }\n    description?: {\n      de: { ... }\n      en?: { ... }\n    }\n    results: Array<{\n      id: { ... }\n      type: { ... }\n      name: { ... }\n    }>\n    contexts?: Array<{\n      type: { ... }\n      schema: { ... }\n    } | {\n      type: { ... }\n      name: { ... }\n      value_type: { ... }\n    }>\n  }>\n}\n```\n';
+export {
+  external_values_default as default
+};

package/dist/external-values-WET4FHGU.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
+
+// src/docs/external-values.json
+var external_values_default = '# External Values API\n\n- **Base URL:** `https://external-values.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/external-values](https://docs.epilot.io/api/external-values)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.externalValues.listExternalValues(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/external-values\'\n\nconst externalValuesClient = getClient()\nauthorize(externalValuesClient, () => \'<token>\')\nconst { data } = await externalValuesClient.listExternalValues(...)\n```\n\n## Operations\n\n**external-values**\n- [`listExternalValues`](#listexternalvalues)\n- [`resolveExternalValue`](#resolveexternalvalue)\n- [`resolvePortalExternalValue`](#resolveportalexternalvalue)\n\n**Schemas**\n- [`TranslatedString`](#translatedstring)\n- [`ExternalValueType`](#externalvaluetype)\n- [`ResolveExternalValueRequest`](#resolveexternalvaluerequest)\n- [`ExternalValueErrorCode`](#externalvalueerrorcode)\n- [`ExternalValueError`](#externalvalueerror)\n- [`ResolveExternalValueResponse`](#resolveexternalvalueresponse)\n- [`ExternalValueResultSummary`](#externalvalueresultsummary)\n- [`ExternalValueHookSummary`](#externalvaluehooksummary)\n- [`ContextRequirement`](#contextrequirement)\n- [`EntityContextRequirement`](#entitycontextrequirement)\n- [`ValueContextRequirement`](#valuecontextrequirement)\n- [`ExternalValueHookList`](#externalvaluehooklist)\n\n### `listExternalValues`\n\nList hooks and their results of all enabled installed apps that declare an\n`EXTERNAL_VALUES` component. Intended for pickers (e.g. the validation-rules builder).\n\n`GET /v1/external-values`\n\n```ts\nconst { data } = await client.listExternalValues()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hooks": [\n    {\n      "app_id": "string",\n      "app_name": "string",\n      "hook_id": "string",\n      "name": {\n        "de": "string",\n        "en": "string"\n      },\n      "description": {\n        "de": "string",\n        "en": "string"\n      },\n      "results": [\n        {\n          "id": "string",\n          "type": "number",\n          "name": {\n            "de": "string",\n            "en": "string"\n          }\n        }\n      ],\n      "contexts": [\n        {\n          "type": "entity",\n          "schema": "contract"\n        }\n      ]\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `resolveExternalValue`\n\nResolve an external value hook for an epilot 360 user (builder preview, entity-attribute\nrules). The organization is taken from the caller\'s token.\n\n`POST /v1/external-values/{app_id}/hooks/{hook_id}:resolve`\n\n```ts\nconst { data } = await client.resolveExternalValue(\n  {\n    app_id: \'example\',\n    hook_id: \'example\',\n  },\n  {\n    context: {\n      contract: [\n        {\n          _id: \'8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a\',\n          external_id: \'C-1001\',\n          installment_amount: 110\n        }\n      ]\n    },\n    consumer: {\n      type: \'validation_rule\',\n      rule_id: \'6c0a9e1e-2f4b-4e6a-8f8e-2b2b2b2b2b2b\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "values": {\n    "predicted": 132\n  },\n  "errors": [\n    {\n      "result_id": "limit",\n      "code": "coercion_failed",\n      "message": "Cannot coerce \\"n/a\\" to number"\n    }\n  ],\n  "policy": {\n    "on_unavailable": "skip"\n  }\n}\n```\n\n</details>\n\n---\n\n### `resolvePortalExternalValue`\n\nResolve an external value hook for a portal end customer (private journeys, portal).\nThe organization is taken from the portal token claims.\n\n`POST /v1/portal/external-values/{app_id}/hooks/{hook_id}:resolve`\n\n```ts\nconst { data } = await client.resolvePortalExternalValue(\n  {\n    app_id: \'example\',\n    hook_id: \'example\',\n  },\n  {\n    context: {\n      contract: [\n        {\n          _id: \'8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a\',\n          external_id: \'C-1001\',\n          installment_amount: 110\n        }\n      ]\n    },\n    consumer: {\n      type: \'validation_rule\',\n      rule_id: \'6c0a9e1e-2f4b-4e6a-8f8e-2b2b2b2b2b2b\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "values": {\n    "predicted": 132\n  },\n  "errors": [\n    {\n      "result_id": "limit",\n      "code": "coercion_failed",\n      "message": "Cannot coerce \\"n/a\\" to number"\n    }\n  ],\n  "policy": {\n    "on_unavailable": "skip"\n  }\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `TranslatedString`\n\n```ts\ntype TranslatedString = {\n  de: string\n  en?: string\n}\n```\n\n### `ExternalValueType`\n\n```ts\ntype ExternalValueType = "number" | "text" | "date" | "boolean"\n```\n\n### `ResolveExternalValueRequest`\n\n```ts\ntype ResolveExternalValueRequest = {\n  context: Record<string, unknown>\n  consumer?: {\n    type?: string\n    rule_id?: string\n    journey_id?: string\n  }\n}\n```\n\n### `ExternalValueErrorCode`\n\n- `timeout`: the third-party call exceeded `timeout_ms`\n- `upstream_error`: the third-party call failed or returned a non-2xx status\n- `auth_failed`: the `auth` pre-call failed\n- `extraction_failed`: template/path/jsonata threw or yielded null / empty\n- `coercion_failed`: the extracted value could n\n\n```ts\ntype ExternalValueErrorCode = "timeout" | "upstream_error" | "auth_failed" | "extraction_failed" | "coercion_failed"\n```\n\n### `ExternalValueError`\n\n```ts\ntype ExternalValueError = {\n  result_id?: string\n  code: "timeout" | "upstream_error" | "auth_failed" | "extraction_failed" | "coercion_failed"\n  message: string\n}\n```\n\n### `ResolveExternalValueResponse`\n\n```ts\ntype ResolveExternalValueResponse = {\n  values: Record<string, number | string | boolean>\n  errors: Array<{\n    result_id?: string\n    code: "timeout" | "upstream_error" | "auth_failed" | "extraction_failed" | "coercion_failed"\n    message: string\n  }>\n  policy: {\n    on_unavailable: "skip" | "block"\n  }\n  cached?: boolean\n}\n```\n\n### `ExternalValueResultSummary`\n\n```ts\ntype ExternalValueResultSummary = {\n  id: string\n  type: "number" | "text" | "date" | "boolean"\n  name: {\n    de: string\n    en?: string\n  }\n}\n```\n\n### `ExternalValueHookSummary`\n\n```ts\ntype ExternalValueHookSummary = {\n  app_id: string\n  app_name: string\n  hook_id: string\n  name: {\n    de: string\n    en?: string\n  }\n  description?: {\n    de: string\n    en?: string\n  }\n  results: Array<{\n    id: string\n    type: "number" | "text" | "date" | "boolean"\n    name: {\n      de: { ... }\n      en?: { ... }\n    }\n  }>\n  contexts?: Array<{\n    type: "entity"\n    schema: string\n  } | {\n    type: "value"\n    name: string\n    value_type: "number" | "text" | "date" | "boolean"\n  }>\n}\n```\n\n### `ContextRequirement`\n\nSomething a hook needs the consumer to supply in `context`, discriminated by `type`:\nbound entities (`entity`) or an optional scalar input (`value`). More types may follow;\nconsumers ignore types they do not know.\n\n\n```ts\ntype ContextRequirement = {\n  type: "entity"\n  schema: string\n} | {\n  type: "value"\n  name: string\n  value_type: "number" | "text" | "date" | "boolean"\n}\n```\n\n### `EntityContextRequirement`\n\nThe consumer supplies the bound entities of `schema` under `Context.`<schema>``, e.g. a hook\ninterpolating `{{ Context.contract[0].external_id }}` declares\n`{ type: entity, schema: contract }`.\n\n\n```ts\ntype EntityContextRequirement = {\n  type: "entity"\n  schema: string\n}\n```\n\n### `ValueContextRequirement`\n\nAn optional scalar input. When the consumer has a value it supplies it under\n`Context.`<name>`` (dates as ISO 8601 strings, `YYYY-MM-DD` or a date-time); otherwise the\nkey is absent, so the hook template must provide a fallback, e.g.\n`{{ Context.reading_date | default: "now" | date: "%Y-%m-%d" }}` dec\n\n```ts\ntype ValueContextRequirement = {\n  type: "value"\n  name: string\n  value_type: "number" | "text" | "date" | "boolean"\n}\n```\n\n### `ExternalValueHookList`\n\n```ts\ntype ExternalValueHookList = {\n  hooks: Array<{\n    app_id: string\n    app_name: string\n    hook_id: string\n    name: {\n      de: { ... }\n      en?: { ... }\n    }\n    description?: {\n      de: { ... }\n      en?: { ... }\n    }\n    results: Array<{\n      id: { ... }\n      type: { ... }\n      name: { ... }\n    }>\n    contexts?: Array<{\n      type: { ... }\n      schema: { ... }\n    } | {\n      type: { ... }\n      name: { ... }\n      value_type: { ... }\n    }>\n  }>\n}\n```\n';
+
+
+exports.default = external_values_default;

package/dist/{external-values.d-23q55J5P.d.cts → external-values.d-DeDtCu_V.d.cts}

@@ -14,13 +14,15 @@ declare namespace Components {
     }
     namespace Schemas {
         /**
-         * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
-         * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+         * Something a hook needs the consumer to supply in `context`, discriminated by `type`:
+         * bound entities (`entity`) or an optional scalar input (`value`). More types may follow;
+         * consumers ignore types they do not know.
          *
          */
         export type ContextRequirement = /**
-         * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
-         * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+         * Something a hook needs the consumer to supply in `context`, discriminated by `type`:
+         * bound entities (`entity`) or an optional scalar input (`value`). More types may follow;
+         * consumers ignore types they do not know.
          *
          */
         /**
@@ -29,7 +31,16 @@ declare namespace Components {
          * `{ type: entity, schema: contract }`.
          *
          */
-        EntityContextRequirement;
+        EntityContextRequirement | /**
+         * An optional scalar input. When the consumer has a value it supplies it under
+         * `Context.<name>` (dates as ISO 8601 strings, `YYYY-MM-DD` or a date-time); otherwise the
+         * key is absent, so the hook template must provide a fallback, e.g.
+         * `{{ Context.reading_date | default: "now" | date: "%Y-%m-%d" }}` declares
+         * `{ type: value, name: reading_date, value_type: date }`. `name` is unique among the hook's
+         * `value` requirements and never equals the `schema` of one of its `entity` requirements.
+         *
+         */
+        ValueContextRequirement;
         /**
          * The consumer supplies the bound entities of `schema` under `Context.<schema>`, e.g. a hook
          * interpolating `{{ Context.contract[0].external_id }}` declares
@@ -83,13 +94,15 @@ declare namespace Components {
             /**
              * What the hook needs the consumer to supply in `context`, as declared in the hook
              * config. Omitted when the hook declares none. A rule builder must require these
-             * contexts on any rule that uses the hook, so the caller passes them in `context`.
-             * More requirement types will follow; consumers ignore types they do not know.
+             * contexts (and offer these value inputs) on any rule that uses the hook, so the
+             * caller passes them in `context`. More requirement types may follow; consumers
+             * ignore types they do not know.
              *
              */
             contexts?: /**
-             * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
-             * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+             * Something a hook needs the consumer to supply in `context`, discriminated by `type`:
+             * bound entities (`entity`) or an optional scalar input (`value`). More types may follow;
+             * consumers ignore types they do not know.
              *
              */
             ContextRequirement[];
@@ -126,8 +139,9 @@ declare namespace Components {
              *
              * One entry per context requirement the consumer bound (see
              * `ExternalValueHookSummary.contexts`): for an `entity` requirement, the bound
-             * entities of that schema under its schema slug. This API gives no name special
-             * treatment.
+             * entities of that schema under its schema slug; for a `value` requirement, the
+             * bound scalar under its `name` (e.g. `"reading_date": "2026-03-01"`), omitted when
+             * the consumer has no value. This API gives no name special treatment.
              *
              */
             context: {
@@ -194,6 +208,25 @@ declare namespace Components {
              */
             en?: string | null;
         }
+        /**
+         * An optional scalar input. When the consumer has a value it supplies it under
+         * `Context.<name>` (dates as ISO 8601 strings, `YYYY-MM-DD` or a date-time); otherwise the
+         * key is absent, so the hook template must provide a fallback, e.g.
+         * `{{ Context.reading_date | default: "now" | date: "%Y-%m-%d" }}` declares
+         * `{ type: value, name: reading_date, value_type: date }`. `name` is unique among the hook's
+         * `value` requirements and never equals the `schema` of one of its `entity` requirements.
+         *
+         */
+        export interface ValueContextRequirement {
+            type: "value";
+            /**
+             * Key under `Context`, same pattern as validation rule parameter names.
+             * example:
+             * reading_date
+             */
+            name: string; // ^[a-z][a-z0-9_]{0,63}$
+            value_type: ExternalValueType;
+        }
     }
 }
 declare namespace Paths {
@@ -441,5 +474,6 @@ type ExternalValueType = Components.Schemas.ExternalValueType;
 type ResolveExternalValueRequest = Components.Schemas.ResolveExternalValueRequest;
 type ResolveExternalValueResponse = Components.Schemas.ResolveExternalValueResponse;
 type TranslatedString = Components.Schemas.TranslatedString;
+type ValueContextRequirement = Components.Schemas.ValueContextRequirement;
 
-export { type Client as C, type EntityContextRequirement as E, type OperationMethods as O, Paths as P, type ResolveExternalValueRequest as R, type TranslatedString as T, Components as a, type PathsDictionary as b, type ContextRequirement as c, type ExternalValueError as d, type ExternalValueErrorCode as e, type ExternalValueHookList as f, type ExternalValueHookSummary as g, type ExternalValueResultSummary as h, type ExternalValueType as i, type ResolveExternalValueResponse as j };
+export { type Client as C, type EntityContextRequirement as E, type OperationMethods as O, Paths as P, type ResolveExternalValueRequest as R, type TranslatedString as T, type ValueContextRequirement as V, Components as a, type PathsDictionary as b, type ContextRequirement as c, type ExternalValueError as d, type ExternalValueErrorCode as e, type ExternalValueHookList as f, type ExternalValueHookSummary as g, type ExternalValueResultSummary as h, type ExternalValueType as i, type ResolveExternalValueResponse as j };

package/dist/{external-values.d-23q55J5P.d.ts → external-values.d-DeDtCu_V.d.ts}

@@ -14,13 +14,15 @@ declare namespace Components {
     }
     namespace Schemas {
         /**
-         * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
-         * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+         * Something a hook needs the consumer to supply in `context`, discriminated by `type`:
+         * bound entities (`entity`) or an optional scalar input (`value`). More types may follow;
+         * consumers ignore types they do not know.
          *
          */
         export type ContextRequirement = /**
-         * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
-         * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+         * Something a hook needs the consumer to supply in `context`, discriminated by `type`:
+         * bound entities (`entity`) or an optional scalar input (`value`). More types may follow;
+         * consumers ignore types they do not know.
          *
          */
         /**
@@ -29,7 +31,16 @@ declare namespace Components {
          * `{ type: entity, schema: contract }`.
          *
          */
-        EntityContextRequirement;
+        EntityContextRequirement | /**
+         * An optional scalar input. When the consumer has a value it supplies it under
+         * `Context.<name>` (dates as ISO 8601 strings, `YYYY-MM-DD` or a date-time); otherwise the
+         * key is absent, so the hook template must provide a fallback, e.g.
+         * `{{ Context.reading_date | default: "now" | date: "%Y-%m-%d" }}` declares
+         * `{ type: value, name: reading_date, value_type: date }`. `name` is unique among the hook's
+         * `value` requirements and never equals the `schema` of one of its `entity` requirements.
+         *
+         */
+        ValueContextRequirement;
         /**
          * The consumer supplies the bound entities of `schema` under `Context.<schema>`, e.g. a hook
          * interpolating `{{ Context.contract[0].external_id }}` declares
@@ -83,13 +94,15 @@ declare namespace Components {
             /**
              * What the hook needs the consumer to supply in `context`, as declared in the hook
              * config. Omitted when the hook declares none. A rule builder must require these
-             * contexts on any rule that uses the hook, so the caller passes them in `context`.
-             * More requirement types will follow; consumers ignore types they do not know.
+             * contexts (and offer these value inputs) on any rule that uses the hook, so the
+             * caller passes them in `context`. More requirement types may follow; consumers
+             * ignore types they do not know.
              *
              */
             contexts?: /**
-             * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
-             * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+             * Something a hook needs the consumer to supply in `context`, discriminated by `type`:
+             * bound entities (`entity`) or an optional scalar input (`value`). More types may follow;
+             * consumers ignore types they do not know.
              *
              */
             ContextRequirement[];
@@ -126,8 +139,9 @@ declare namespace Components {
              *
              * One entry per context requirement the consumer bound (see
              * `ExternalValueHookSummary.contexts`): for an `entity` requirement, the bound
-             * entities of that schema under its schema slug. This API gives no name special
-             * treatment.
+             * entities of that schema under its schema slug; for a `value` requirement, the
+             * bound scalar under its `name` (e.g. `"reading_date": "2026-03-01"`), omitted when
+             * the consumer has no value. This API gives no name special treatment.
              *
              */
             context: {
@@ -194,6 +208,25 @@ declare namespace Components {
              */
             en?: string | null;
         }
+        /**
+         * An optional scalar input. When the consumer has a value it supplies it under
+         * `Context.<name>` (dates as ISO 8601 strings, `YYYY-MM-DD` or a date-time); otherwise the
+         * key is absent, so the hook template must provide a fallback, e.g.
+         * `{{ Context.reading_date | default: "now" | date: "%Y-%m-%d" }}` declares
+         * `{ type: value, name: reading_date, value_type: date }`. `name` is unique among the hook's
+         * `value` requirements and never equals the `schema` of one of its `entity` requirements.
+         *
+         */
+        export interface ValueContextRequirement {
+            type: "value";
+            /**
+             * Key under `Context`, same pattern as validation rule parameter names.
+             * example:
+             * reading_date
+             */
+            name: string; // ^[a-z][a-z0-9_]{0,63}$
+            value_type: ExternalValueType;
+        }
     }
 }
 declare namespace Paths {
@@ -441,5 +474,6 @@ type ExternalValueType = Components.Schemas.ExternalValueType;
 type ResolveExternalValueRequest = Components.Schemas.ResolveExternalValueRequest;
 type ResolveExternalValueResponse = Components.Schemas.ResolveExternalValueResponse;
 type TranslatedString = Components.Schemas.TranslatedString;
+type ValueContextRequirement = Components.Schemas.ValueContextRequirement;
 
-export { type Client as C, type EntityContextRequirement as E, type OperationMethods as O, Paths as P, type ResolveExternalValueRequest as R, type TranslatedString as T, Components as a, type PathsDictionary as b, type ContextRequirement as c, type ExternalValueError as d, type ExternalValueErrorCode as e, type ExternalValueHookList as f, type ExternalValueHookSummary as g, type ExternalValueResultSummary as h, type ExternalValueType as i, type ResolveExternalValueResponse as j };
+export { type Client as C, type EntityContextRequirement as E, type OperationMethods as O, Paths as P, type ResolveExternalValueRequest as R, type TranslatedString as T, type ValueContextRequirement as V, Components as a, type PathsDictionary as b, type ContextRequirement as c, type ExternalValueError as d, type ExternalValueErrorCode as e, type ExternalValueHookList as f, type ExternalValueHookSummary as g, type ExternalValueResultSummary as h, type ExternalValueType as i, type ResolveExternalValueResponse as j };