@epilot/app-client 0.14.1 → 0.16.0

package/dist/definition.js

@@ -1 +1 @@
-(()=>{"use strict";var e={330(e,r,t){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(r,"__esModule",{value:!0});var o=n(t(466));r.default=o.default},466(e){e.exports=JSON.parse('{"openapi":"3.1.0","info":{"title":"","version":""},"servers":[{"url":"https://app.sls.epilot.io"}],"paths":{"/v1/public/app/{appId}/components/{componentId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration to install"},{"name":"componentId","in":"path","required":true,"description":"ID of the component to retrieve"}],"get":{"operationId":"getPublicFacingComponent","responses":{}}},"/v1/app-configurations":{"get":{"operationId":"listConfigurations","parameters":[{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}},"post":{"operationId":"createConfiguration","requestBody":{"$ref":"#/components/requestBodies/CreateConfigRequest"},"responses":{}}},"/v1/app-configurations/public":{"get":{"operationId":"listPublicConfigurations","parameters":[{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app-configurations/public/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration to install"}],"get":{"operationId":"getPublicConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"get":{"operationId":"getConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}},"patch":{"operationId":"patchMetadata","requestBody":{"$ref":"#/components/requestBodies/PatchConfigMetadataRequest"},"responses":{}},"delete":{"operationId":"deleteConfiguration","responses":{}}},"/v1/app-configurations/{appId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/bundle":{"post":{"operationId":"createBundleUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CreateBundlePresignedRequest"},"responses":{}}},"/v1/app-configurations/{appId}/zip":{"post":{"operationId":"createZipUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/logo":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"post":{"operationId":"createLogoUploadUrl","requestBody":{"$ref":"#/components/requestBodies/CreateLogoPresignedRequest"},"responses":{}},"delete":{"operationId":"deleteLogo","responses":{}}},"/v1/app-configurations/{appId}/versions":{"get":{"operationId":"listVersions","parameters":[{"name":"appId","in":"path","required":true},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}":{"get":{"operationId":"getVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"delete":{"operationId":"deleteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"patch":{"operationId":"patchVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/PatchVersionRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/review":{"get":{"operationId":"getReview","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"post":{"operationId":"createReview","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CreateReviewRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components":{"post":{"operationId":"createComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components/{componentId}":{"patch":{"operationId":"patchComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}},"delete":{"operationId":"deleteComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}":{"post":{"operationId":"cloneVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"sourceVersion","in":"path","required":true},{"name":"targetVersion","in":"path","required":true}],"responses":{}}},"/v1/app":{"get":{"operationId":"listInstallations","parameters":[{"name":"componentType","in":"query"},{"name":"enabled","in":"query"},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app/{appId}":{"get":{"operationId":"getInstallation","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}},"post":{"operationId":"install","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"patch":{"operationId":"patchInstallation","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"delete":{"operationId":"uninstall","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}}},"/v1/app/{appId}/promote-to/{version}":{"post":{"operationId":"promoteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}}},"/v1/app/{appId}/options/resolve":{"post":{"operationId":"resolveOptions","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/app-events":{"post":{"operationId":"ingestEvent","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/public/app/{appId}/proxy/{proxyName}/{path}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the installed app"},{"name":"proxyName","in":"path","required":true,"description":"Name of the proxy target as defined in the app manifest"},{"name":"path","in":"path","required":true,"description":"Path to forward to the proxy target"},{"name":"query","in":"query","required":false,"style":"form","explode":true,"description":"Free-form query parameters, forwarded unchanged to the proxy target"}],"get":{"operationId":"publicProxyGet","responses":{}},"post":{"operationId":"publicProxyPost","requestBody":{"content":{"application/json":{}}},"responses":{}},"put":{"operationId":"publicProxyPut","requestBody":{"content":{"application/json":{}}},"responses":{}},"patch":{"operationId":"publicProxyPatch","requestBody":{"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"publicProxyDelete","responses":{}}}},"components":{"requestBodies":{"CreateReviewRequest":{"required":true,"content":{"application/json":{}}},"CreateLogoPresignedRequest":{"required":true,"content":{"application/json":{}}},"CreateBundlePresignedRequest":{"required":true,"content":{"application/json":{}}},"PatchConfigMetadataRequest":{"required":true,"content":{"application/json":{}}},"PatchVersionRequest":{"required":true,"content":{"application/json":{}}},"UpsertComponentRequest":{"required":true,"content":{"application/json":{}}},"CreateConfigRequest":{"required":true,"content":{"application/json":{}}},"InstallRequest":{"content":{"application/json":{}}}}}}')}},r={},t=function t(n){var o=r[n];if(void 0!==o)return o.exports;var p=r[n]={exports:{}};return e[n].call(p.exports,p,p.exports,t),p.exports}(330),n=exports;for(var o in t)n[o]=t[o];t.__esModule&&Object.defineProperty(n,"__esModule",{value:!0})})();
+(()=>{"use strict";var e={438(e,r,t){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(r,"__esModule",{value:!0});var o=n(t(466));r.default=o.default},466(e){e.exports=JSON.parse('{"openapi":"3.1.0","info":{"title":"","version":""},"servers":[{"url":"https://app.sls.epilot.io"}],"paths":{"/v1/public/app/{appId}/components/{componentId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration to install"},{"name":"componentId","in":"path","required":true,"description":"ID of the component to retrieve"}],"get":{"operationId":"getPublicFacingComponent","responses":{}}},"/v1/app-configurations":{"get":{"operationId":"listConfigurations","parameters":[{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}},"post":{"operationId":"createConfiguration","requestBody":{"$ref":"#/components/requestBodies/CreateConfigRequest"},"responses":{}}},"/v1/app-configurations/public":{"get":{"operationId":"listPublicConfigurations","parameters":[{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app-configurations/public/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration to install"}],"get":{"operationId":"getPublicConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"get":{"operationId":"getConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}},"patch":{"operationId":"patchMetadata","requestBody":{"$ref":"#/components/requestBodies/PatchConfigMetadataRequest"},"responses":{}},"delete":{"operationId":"deleteConfiguration","responses":{}}},"/v1/app-configurations/{appId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/bundle":{"post":{"operationId":"createBundleUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CreateBundlePresignedRequest"},"responses":{}}},"/v1/app-configurations/{appId}/zip":{"post":{"operationId":"createZipUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/logo":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"post":{"operationId":"createLogoUploadUrl","requestBody":{"$ref":"#/components/requestBodies/CreateLogoPresignedRequest"},"responses":{}},"delete":{"operationId":"deleteLogo","responses":{}}},"/v1/app-configurations/{appId}/versions":{"get":{"operationId":"listVersions","parameters":[{"name":"appId","in":"path","required":true},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}":{"get":{"operationId":"getVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"delete":{"operationId":"deleteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"patch":{"operationId":"patchVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/PatchVersionRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/review":{"get":{"operationId":"getReview","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"post":{"operationId":"createReview","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CreateReviewRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components":{"post":{"operationId":"createComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components/{componentId}":{"patch":{"operationId":"patchComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}},"delete":{"operationId":"deleteComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}":{"post":{"operationId":"cloneVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"sourceVersion","in":"path","required":true},{"name":"targetVersion","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CloneVersionRequest"},"responses":{}}},"/v1/app":{"get":{"operationId":"listInstallations","parameters":[{"name":"componentType","in":"query"},{"name":"enabled","in":"query"},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app/{appId}":{"get":{"operationId":"getInstallation","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}},"post":{"operationId":"install","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"patch":{"operationId":"patchInstallation","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"delete":{"operationId":"uninstall","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}}},"/v1/app/{appId}/promote-to/{version}":{"post":{"operationId":"promoteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}}},"/v1/app/{appId}/options/resolve":{"post":{"operationId":"resolveOptions","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/app-events":{"post":{"operationId":"ingestEvent","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/public/app/{appId}/proxy/{proxyName}/{path}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the installed app"},{"name":"proxyName","in":"path","required":true,"description":"Name of the proxy target as defined in the app manifest"},{"name":"path","in":"path","required":true,"description":"Path to forward to the proxy target"},{"name":"query","in":"query","required":false,"style":"form","explode":true,"description":"Free-form query parameters, forwarded unchanged to the proxy target"}],"get":{"operationId":"publicProxyGet","responses":{}},"post":{"operationId":"publicProxyPost","requestBody":{"content":{"application/json":{}}},"responses":{}},"put":{"operationId":"publicProxyPut","requestBody":{"content":{"application/json":{}}},"responses":{}},"patch":{"operationId":"publicProxyPatch","requestBody":{"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"publicProxyDelete","responses":{}}}},"components":{"requestBodies":{"CreateReviewRequest":{"required":true,"content":{"application/json":{}}},"CreateLogoPresignedRequest":{"required":true,"content":{"application/json":{}}},"CreateBundlePresignedRequest":{"required":true,"content":{"application/json":{}}},"PatchConfigMetadataRequest":{"required":true,"content":{"application/json":{}}},"PatchVersionRequest":{"required":true,"content":{"application/json":{}}},"CloneVersionRequest":{"required":false,"content":{"application/json":{}}},"UpsertComponentRequest":{"required":true,"content":{"application/json":{}}},"CreateConfigRequest":{"required":true,"content":{"application/json":{}}},"InstallRequest":{"content":{"application/json":{}}}}}}')}},r={},t=function t(n){var o=r[n];if(void 0!==o)return o.exports;var p=r[n]={exports:{}};return e[n].call(p.exports,p,p.exports,t),p.exports}(438),n=exports;for(var o in t)n[o]=t[o];t.__esModule&&Object.defineProperty(n,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -393,6 +393,9 @@
             "required": true
           }
         ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/CloneVersionRequest"
+        },
         "responses": {}
       }
     },
@@ -618,6 +621,12 @@
           "application/json": {}
         }
       },
+      "CloneVersionRequest": {
+        "required": false,
+        "content": {
+          "application/json": {}
+        }
+      },
       "UpsertComponentRequest": {
         "required": true,
         "content": {

package/dist/openapi.d.ts

@@ -8,6 +8,12 @@ import type {
 
 declare namespace Components {
     namespace RequestBodies {
+        export interface CloneVersionRequest {
+            /**
+             * Short description of what the new version will change
+             */
+            changelog?: string;
+        }
         export interface CreateBundlePresignedRequest {
             /**
              * Version of the app
@@ -119,7 +125,11 @@ declare namespace Components {
              * sensitive and must not declare `sensitive: false`.
              *
              */
-            options?: /* Options for the component configuration */ Schemas.Options[];
+            options?: /* An option declaration — a setting the installing org fills in. Declared at app level. */ Schemas.Options[];
+            /**
+             * Short description of what changed in this version
+             */
+            changelog?: string;
         }
         export type UpsertComponentRequest = Schemas.BaseComponent;
     }
@@ -291,7 +301,7 @@ declare namespace Components {
             /**
              * List of options for the app component
              */
-            options?: /* Options for the component configuration */ Options[];
+            options?: /* An option declaration — a setting the installing org fills in. Declared at app level. */ Options[];
             /**
              * Keys of app-level options this component uses. Narrows which options are
              * folded back into `options` for legacy consumers (e.g. which values a journey
@@ -304,7 +314,11 @@ declare namespace Components {
             surfaces?: {
                 [key: string]: any;
             };
-        } & (JourneyBlockComponent | PortalBlockComponent | PortalExtensionComponent | CustomFlowActionComponent | ErpInformToolkitComponent | CustomCapabilityComponent | ExternalProductCatalogComponent | CustomPageComponent | ApiProxyComponent);
+        } & (JourneyBlockComponent | PortalBlockComponent | PortalExtensionComponent | CustomFlowActionComponent | ErpInformToolkitComponent | CustomCapabilityComponent | ExternalProductCatalogComponent | CustomPageComponent | ApiProxyComponent | /**
+         * Exposes typed values resolved from an external system at runtime (e.g. a meter reading prediction). Consumers such as validation rules reference a hook and one of its results by id. Resolution is performed by the external-values-api on behalf of authenticated epilot 360 users and portal end customers.
+         *
+         */
+        ExternalValuesComponent);
         export interface BaseComponentCommon {
             /**
              * Unique identifier for the component
@@ -339,7 +353,7 @@ declare namespace Components {
             /**
              * List of options for the app component
              */
-            options?: /* Options for the component configuration */ Options[];
+            options?: /* An option declaration — a setting the installing org fills in. Declared at app level. */ Options[];
             /**
              * Keys of app-level options this component uses. Narrows which options are
              * folded back into `options` for legacy consumers (e.g. which values a journey
@@ -537,7 +551,7 @@ declare namespace Components {
         /**
          * Type of app component
          */
-        export type ComponentType = "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE" | "API_PROXY" | "APP_FUNCTION";
+        export type ComponentType = "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE" | "API_PROXY" | "EXTERNAL_VALUES" | "APP_FUNCTION";
         /**
          * Configuration of the published app
          */
@@ -656,7 +670,7 @@ declare namespace Components {
             /**
              * App-level option declarations (with sensitivity) of this version
              */
-            options?: /* Options for the component configuration */ Options[];
+            options?: /* An option declaration — a setting the installing org fills in. Declared at app level. */ Options[];
             /**
              * Visibility of the app version
              */
@@ -846,7 +860,7 @@ declare namespace Components {
             /**
              * App-level option declarations (with sensitivity) of this version
              */
-            options?: /* Options for the component configuration */ Options[];
+            options?: /* An option declaration — a setting the installing org fills in. Declared at app level. */ Options[];
             /**
              * Visibility of the app version
              */
@@ -1254,6 +1268,167 @@ declare namespace Components {
                 };
             };
         }
+        /**
+         * Exposes typed values resolved from an external system at runtime (e.g. a meter reading prediction). Consumers such as validation rules reference a hook and one of its results by id. Resolution is performed by the external-values-api on behalf of authenticated epilot 360 users and portal end customers.
+         *
+         */
+        export interface ExternalValuesComponent {
+            component_type: "EXTERNAL_VALUES";
+            configuration: /* Configuration for an EXTERNAL_VALUES component */ ExternalValuesConfig;
+        }
+        /**
+         * Configuration for an EXTERNAL_VALUES component
+         */
+        export interface ExternalValuesConfig {
+            /**
+             * 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 `Input`, `Context`, `Consumer`, `Options`, `Env` and — for `result` templates — `Response` and `AuthResponse`.
+             *
+             */
+            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`.
+         *
+         */
+        export interface ExternalValuesHook {
+            /**
+             * Stable identifier; consumers (e.g. validation rules) reference it. Renaming breaks references.
+             */
+            id: string; // ^[a-zA-Z0-9_-]{1,100}$
+            name: TranslatedString;
+            description?: TranslatedString;
+            /**
+             * Static request authentication applied to the call.
+             * - `none`: no static authentication.
+             * - `header`: sends `auth_secret` in header `auth_header` (default `X-API-Key`).
+             * - `bearer`: sends `Authorization: Bearer <auth_secret>`.
+             * - `hmac`: signs the request per Standard Webhooks (headers `webhook-id`,
+             *   `webhook-timestamp`, `webhook-signature` = `v1,<base64 HMAC-SHA256>` over
+             *   `<id>.<timestamp>.<body>`) using `auth_secret` as a `whsec_`-prefixed
+             *   base64 secret, exactly as epilot webhooks do.
+             *
+             * `auth_secret` is required when `auth_type` is `header`, `bearer` or `hmac`.
+             * Combine with `auth` (a pre-call that fetches a token) when the target needs both.
+             *
+             */
+            auth_type?: "none" | "header" | "bearer" | "hmac";
+            /**
+             * Header name used when `auth_type` is `header`. Defaults to `X-API-Key`.
+             */
+            auth_header?: string;
+            /**
+             * Liquid template resolving to the secret, e.g. "{{Options.api_key}}". Must reference an option declared with `type: secret`; literals are rejected. Required when `auth_type` is `header`, `bearer` or `hmac`.
+             * example:
+             * {{Options.api_key}}
+             */
+            auth_secret?: string;
+            auth?: PortalExtensionAuthBlock;
+            call: {
+                /**
+                 * HTTP method to use for the call
+                 */
+                method?: "GET" | "POST" | "PUT" | "PATCH";
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * Headers to send with the call. Supports variable interpolation.
+                 */
+                headers?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Query parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+                /**
+                 * JSON body to send. Values support variable interpolation. When omitted, `{ Input, Context, Consumer }` is sent as-is.
+                 */
+                body?: {
+                    [name: string]: any;
+                };
+            };
+            /**
+             * Typed results extracted from the response. Result ids must be unique within the hook.
+             */
+            result: [
+                /**
+                 * A single typed value extracted from the hook response. Exactly one of `template`, `path` or `jsonata` must be set.
+                 *
+                 */
+                ExternalValuesResult,
+                .../**
+                 * A single typed value extracted from the hook response. Exactly one of `template`, `path` or `jsonata` must be set.
+                 *
+                 */
+                ExternalValuesResult[]
+            ];
+            /**
+             * Timeout for the external call in milliseconds.
+             */
+            timeout_ms?: number;
+            /**
+             * 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";
+            /**
+             * Response caching. Off when omitted.
+             */
+            cache?: {
+                /**
+                 * Time to live in seconds. 0 disables caching.
+                 */
+                ttl_seconds: number;
+                /**
+                 * Liquid template for the cache key. Defaults to a hash of org, app, hook, `Input` and `Context`.
+                 */
+                key?: string;
+            };
+            /**
+             * If set, requests are sent from epilot's static egress IPs. Mutually exclusive with secure_proxy.
+             */
+            use_static_ips?: boolean;
+            secure_proxy?: /* If set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips. */ PortalExtensionSecureProxy;
+        }
+        /**
+         * A single typed value extracted from the hook response. Exactly one of `template`, `path` or `jsonata` must be set.
+         *
+         */
+        export interface ExternalValuesResult {
+            /**
+             * Stable identifier of the result within the hook. Renaming breaks references.
+             */
+            id: string; // ^[a-zA-Z0-9_-]{1,100}$
+            /**
+             * Type the extracted value is coerced to.
+             */
+            type: "number" | "text" | "date" | "boolean";
+            name: TranslatedString;
+            /**
+             * Liquid template over `Response` etc.; output coerced to `type`.
+             * example:
+             * {{Response.value}}
+             */
+            template?: string;
+            /**
+             * Dot path into the response body, e.g. "data.limit".
+             * example:
+             * data.limit
+             */
+            path?: string;
+            /**
+             * JSONata expression over `{ Response, Input, Context, Options, Env }`.
+             * example:
+             * $sum(Response.items.amount)
+             */
+            jsonata?: string;
+        }
         /**
          * A named server-side function belonging to the app. Runs in the epilot code-execution sandbox with an installation-scoped app token. Functions with a schedule are executed automatically once per installation.
          *
@@ -1405,7 +1580,7 @@ declare namespace Components {
              * `configured` and `value_updated_at` instead.
              *
              */
-            options?: /* Options for the component configuration */ Options[];
+            options?: /* An option declaration — a setting the installing org fills in. Declared at app level. */ Options[];
             /**
              * Version of the app that is installed
              */
@@ -1618,7 +1793,7 @@ declare namespace Components {
             value: any;
         }
         /**
-         * Options for the component configuration
+         * An option declaration — a setting the installing org fills in. Declared at app level.
          */
         export interface Options {
             /**
@@ -1677,7 +1852,7 @@ declare namespace Components {
              * Write-only, server-side only value — like a sensitive environment variable
              * (app-level options only). Sensitive values are never serialized in any response;
              * they are resolvable only via server-side channels (API proxy injection, function
-             * `secrets` allowlist, the internal options/resolve endpoint). Non-sensitive values
+             * runs, the internal options/resolve endpoint). Non-sensitive values
              * are readable wherever the app runs, including the end-customer browser (journey and
              * portal runtime). Forced to true for `secret`-touching options. Default: false.
              *
@@ -1855,7 +2030,7 @@ declare namespace Components {
              *         { "id": "ht", "label": { "en": "High tariff" }, "aggregation_group": "consumption", "statistical_method": "sum", "unit": "kWh", "color": "primary", "precision": 2 },
              *         ...
              *       ],
-             *       "intervals": ["PT15M", "PT1H", "P1D", "P1M"],
+             *       "intervals": ["PT15M", "PT1H", "P1D", "P1M", "P1Y"],
              *       "data_range": { "from": "2024-01-01T00:00:00Z", "to": "2026-05-01T00:00:00Z" }
              *     }
              *   Each type option carries its own `statistical_method`, which describes the method already applied to that type's data and dictates the chart shape: `sum` is rendered as a bar chart; `min`, `average`, and `max` are rendered as a line chart. A single visualization can therefore mix bar-shaped types with line-shaped types. Defaults to `sum` when omitted.
@@ -2098,7 +2273,7 @@ declare namespace Components {
              * Intervals supported by the API. If omitted, it is assumed that all intervals are supported.
              *
              */
-            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M")[];
+            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y")[];
             auth?: PortalExtensionAuthBlock;
             call: {
                 /**
@@ -2269,7 +2444,7 @@ declare namespace Components {
              * Intervals supported by the API. If omitted, it is assumed that all intervals are supported.
              *
              */
-            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M")[];
+            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y")[];
             auth?: PortalExtensionAuthBlock;
             call: {
                 /**
@@ -2600,7 +2775,7 @@ declare namespace Components {
              * Intervals supported by the API. If omitted, it is assumed that all intervals are supported.
              *
              */
-            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M")[];
+            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y")[];
             auth?: PortalExtensionAuthBlock;
             call: {
                 /**
@@ -2732,7 +2907,7 @@ declare namespace Components {
          *         { "id": "ht", "label": { "en": "High tariff" }, "aggregation_group": "consumption", "statistical_method": "sum", "unit": "kWh", "color": "primary", "precision": 2 },
          *         ...
          *       ],
-         *       "intervals": ["PT15M", "PT1H", "P1D", "P1M"],
+         *       "intervals": ["PT15M", "PT1H", "P1D", "P1M", "P1Y"],
          *       "data_range": { "from": "2024-01-01T00:00:00Z", "to": "2026-05-01T00:00:00Z" }
          *     }
          *   Each type option carries its own `statistical_method`, which describes the method already applied to that type's data and dictates the chart shape: `sum` is rendered as a bar chart; `min`, `average`, and `max` are rendered as a line chart. A single visualization can therefore mix bar-shaped types with line-shaped types. Defaults to `sum` when omitted.
@@ -2920,7 +3095,7 @@ declare namespace Components {
             /**
              * App-level option declarations (with sensitivity) of this version
              */
-            options?: /* Options for the component configuration */ Options[];
+            options?: /* An option declaration — a setting the installing org fills in. Declared at app level. */ Options[];
             /**
              * Flag to indicate if the app is in beta.
              */
@@ -3030,6 +3205,7 @@ declare namespace Paths {
             sourceVersion: Parameters.SourceVersion;
             targetVersion: Parameters.TargetVersion;
         }
+        export type RequestBody = Components.RequestBodies.CloneVersionRequest;
         namespace Responses {
             export interface $201 {
                 app_id?: string;
@@ -3613,7 +3789,7 @@ declare namespace Paths {
         }
         namespace Responses {
             export interface $200 {
-                options?: /* Options for the component configuration */ Components.Schemas.Options[];
+                options?: /* An option declaration — a setting the installing org fills in. Declared at app level. */ Components.Schemas.Options[];
             }
             export interface $403 {
             }
@@ -3919,7 +4095,7 @@ export interface OperationMethods {
    */
   'cloneVersion'(
     parameters?: Parameters<Paths.CloneVersion.PathParameters> | null,
-    data?: any,
+    data?: Paths.CloneVersion.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.CloneVersion.Responses.$201>
   /**
@@ -4312,7 +4488,7 @@ export interface PathsDictionary {
      */
     'post'(
       parameters?: Parameters<Paths.CloneVersion.PathParameters> | null,
-      data?: any,
+      data?: Paths.CloneVersion.RequestBody,
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.CloneVersion.Responses.$201>
   }
@@ -4499,6 +4675,10 @@ export type ExternalProductCatalogComponent = Components.Schemas.ExternalProduct
 export type ExternalProductCatalogConfig = Components.Schemas.ExternalProductCatalogConfig;
 export type ExternalProductCatalogHookProductRecommendations = Components.Schemas.ExternalProductCatalogHookProductRecommendations;
 export type ExternalProductCatalogHookProducts = Components.Schemas.ExternalProductCatalogHookProducts;
+export type ExternalValuesComponent = Components.Schemas.ExternalValuesComponent;
+export type ExternalValuesConfig = Components.Schemas.ExternalValuesConfig;
+export type ExternalValuesHook = Components.Schemas.ExternalValuesHook;
+export type ExternalValuesResult = Components.Schemas.ExternalValuesResult;
 export type FunctionDefinition = Components.Schemas.FunctionDefinition;
 export type FunctionRefCustomActionConfig = Components.Schemas.FunctionRefCustomActionConfig;
 export type Grants = Components.Schemas.Grants;

package/dist/openapi.json

@@ -1150,6 +1150,9 @@
             "description": "Target version to create"
           }
         ],
+        "requestBody": {
+          "$ref": "#/components/requestBodies/CloneVersionRequest"
+        },
         "responses": {
           "201": {
             "description": "New version created successfully",
@@ -1902,6 +1905,28 @@
                     "$ref": "#/components/schemas/Options"
                   },
                   "description": "Replaces the full set of app-level option declarations for this version.\nOption keys must be unique app-wide; `secret`-touching options are always\nsensitive and must not declare `sensitive: false`.\n"
+                },
+                "changelog": {
+                  "type": "string",
+                  "maxLength": 250,
+                  "description": "Short description of what changed in this version"
+                }
+              }
+            }
+          }
+        }
+      },
+      "CloneVersionRequest": {
+        "required": false,
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "changelog": {
+                  "type": "string",
+                  "maxLength": 250,
+                  "description": "Short description of what the new version will change"
                 }
               }
             }
@@ -2009,7 +2034,7 @@
       },
       "Options": {
         "type": "object",
-        "description": "Options for the component configuration",
+        "description": "An option declaration — a setting the installing org fills in. Declared at app level.",
         "required": [
           "key",
           "type"
@@ -2058,7 +2083,7 @@
           },
           "sensitive": {
             "type": "boolean",
-            "description": "Write-only, server-side only value — like a sensitive environment variable\n(app-level options only). Sensitive values are never serialized in any response;\nthey are resolvable only via server-side channels (API proxy injection, function\n`secrets` allowlist, the internal options/resolve endpoint). Non-sensitive values\nare readable wherever the app runs, including the end-customer browser (journey and\nportal runtime). Forced to true for `secret`-touching options. Default: false.\n"
+            "description": "Write-only, server-side only value — like a sensitive environment variable\n(app-level options only). Sensitive values are never serialized in any response;\nthey are resolvable only via server-side channels (API proxy injection, function\nruns, the internal options/resolve endpoint). Non-sensitive values\nare readable wherever the app runs, including the end-customer browser (journey and\nportal runtime). Forced to true for `secret`-touching options. Default: false.\n"
           },
           "configured": {
             "type": "boolean",
@@ -2179,6 +2204,7 @@
           "EXTERNAL_PRODUCT_CATALOG",
           "CUSTOM_PAGE",
           "API_PROXY",
+          "EXTERNAL_VALUES",
           "APP_FUNCTION"
         ],
         "description": "Type of app component"
@@ -2375,7 +2401,8 @@
                 "CUSTOM_CAPABILITY": "#/components/schemas/CustomCapabilityComponent",
                 "EXTERNAL_PRODUCT_CATALOG": "#/components/schemas/ExternalProductCatalogComponent",
                 "CUSTOM_PAGE": "#/components/schemas/CustomPageComponent",
-                "API_PROXY": "#/components/schemas/ApiProxyComponent"
+                "API_PROXY": "#/components/schemas/ApiProxyComponent",
+                "EXTERNAL_VALUES": "#/components/schemas/ExternalValuesComponent"
               }
             },
             "oneOf": [
@@ -2405,6 +2432,9 @@
               },
               {
                 "$ref": "#/components/schemas/ApiProxyComponent"
+              },
+              {
+                "$ref": "#/components/schemas/ExternalValuesComponent"
               }
             ]
           }
@@ -2428,6 +2458,25 @@
           }
         }
       },
+      "ExternalValuesComponent": {
+        "type": "object",
+        "description": "Exposes typed values resolved from an external system at runtime (e.g. a meter reading prediction). Consumers such as validation rules reference a hook and one of its results by id. Resolution is performed by the external-values-api on behalf of authenticated epilot 360 users and portal end customers.\n",
+        "required": [
+          "component_type",
+          "configuration"
+        ],
+        "properties": {
+          "component_type": {
+            "type": "string",
+            "enum": [
+              "EXTERNAL_VALUES"
+            ]
+          },
+          "configuration": {
+            "$ref": "#/components/schemas/ExternalValuesConfig"
+          }
+        }
+      },
       "CustomCapabilityComponent": {
         "type": "object",
         "required": [
@@ -3375,7 +3424,8 @@
                 "PT15M",
                 "PT1H",
                 "P1D",
-                "P1M"
+                "P1M",
+                "P1Y"
               ]
             }
           },
@@ -3486,7 +3536,8 @@
                 "PT15M",
                 "PT1H",
                 "P1D",
-                "P1M"
+                "P1M",
+                "P1Y"
               ]
             }
           },
@@ -3665,7 +3716,7 @@
         "additionalProperties": false
       },
       "PortalExtensionHookVisualizationMetadata": {
-        "description": "Hook that returns runtime metadata describing how a visualization (consumption / price / cost chart) should be rendered for a given portal context (meter, contract, etc). It is invoked by the portal before fetching data, with the same context the data hook would receive, so that the discovery shape can vary per meter/contract. The expected response to the call is:\n  - 200 with a JSON body of shape:\n    {\n      \"type_options\": [\n        { \"id\": \"ht\", \"label\": { \"en\": \"High tariff\" }, \"aggregation_group\": \"consumption\", \"statistical_method\": \"sum\", \"unit\": \"kWh\", \"color\": \"primary\", \"precision\": 2 },\n        ...\n      ],\n      \"intervals\": [\"PT15M\", \"PT1H\", \"P1D\", \"P1M\"],\n      \"data_range\": { \"from\": \"2024-01-01T00:00:00Z\", \"to\": \"2026-05-01T00:00:00Z\" }\n    }\n  Each type option carries its own `statistical_method`, which describes the method already applied to that type's data and dictates the chart shape: `sum` is rendered as a bar chart; `min`, `average`, and `max` are rendered as a line chart. A single visualization can therefore mix bar-shaped types with line-shaped types. Defaults to `sum` when omitted.\n  Each type option may also customize its rendering: `color` picks a Spark palette color (`primary`, `slate`, `mauve`, `orange`, `red`, `tomato`, `amber`, `green`, `blue`) used to draw the type's series; `precision` sets the number of decimal places to show for that type's values (axis labels, tooltips, summaries). Both are optional — the consumer falls back to its own defaults when they are omitted.\n  `aggregation_group` controls how types within a group are visually combined (depends on the per-type `statistical_method`):\n    - bar chart (`sum`): same-group types are stacked into a single bar (e.g. ht/nt summed into total consumption); different-group types render side-by-side.\n    - line chart (`min` / `average` / `max`): same-group types are rendered as an area chart; different-group types render as separate lines.\n  All fields are optional; the consumer falls back to its defaults for whatever the hook does not return.\nThe portal looks up this hook implicitly per extension (one `visualizationMetadata` hook per extension) — there is no need for a data-retrieval hook to reference it explicitly.\n",
+        "description": "Hook that returns runtime metadata describing how a visualization (consumption / price / cost chart) should be rendered for a given portal context (meter, contract, etc). It is invoked by the portal before fetching data, with the same context the data hook would receive, so that the discovery shape can vary per meter/contract. The expected response to the call is:\n  - 200 with a JSON body of shape:\n    {\n      \"type_options\": [\n        { \"id\": \"ht\", \"label\": { \"en\": \"High tariff\" }, \"aggregation_group\": \"consumption\", \"statistical_method\": \"sum\", \"unit\": \"kWh\", \"color\": \"primary\", \"precision\": 2 },\n        ...\n      ],\n      \"intervals\": [\"PT15M\", \"PT1H\", \"P1D\", \"P1M\", \"P1Y\"],\n      \"data_range\": { \"from\": \"2024-01-01T00:00:00Z\", \"to\": \"2026-05-01T00:00:00Z\" }\n    }\n  Each type option carries its own `statistical_method`, which describes the method already applied to that type's data and dictates the chart shape: `sum` is rendered as a bar chart; `min`, `average`, and `max` are rendered as a line chart. A single visualization can therefore mix bar-shaped types with line-shaped types. Defaults to `sum` when omitted.\n  Each type option may also customize its rendering: `color` picks a Spark palette color (`primary`, `slate`, `mauve`, `orange`, `red`, `tomato`, `amber`, `green`, `blue`) used to draw the type's series; `precision` sets the number of decimal places to show for that type's values (axis labels, tooltips, summaries). Both are optional — the consumer falls back to its own defaults when they are omitted.\n  `aggregation_group` controls how types within a group are visually combined (depends on the per-type `statistical_method`):\n    - bar chart (`sum`): same-group types are stacked into a single bar (e.g. ht/nt summed into total consumption); different-group types render side-by-side.\n    - line chart (`min` / `average` / `max`): same-group types are rendered as an area chart; different-group types render as separate lines.\n  All fields are optional; the consumer falls back to its defaults for whatever the hook does not return.\nThe portal looks up this hook implicitly per extension (one `visualizationMetadata` hook per extension) — there is no need for a data-retrieval hook to reference it explicitly.\n",
         "type": "object",
         "properties": {
           "id": {
@@ -3789,7 +3840,8 @@
                 "PT15M",
                 "PT1H",
                 "P1D",
-                "P1M"
+                "P1M",
+                "P1Y"
               ]
             }
           },
@@ -5079,6 +5131,204 @@
           }
         }
       },
+      "ExternalValuesConfig": {
+        "type": "object",
+        "description": "Configuration for an EXTERNAL_VALUES component",
+        "required": [
+          "hooks"
+        ],
+        "properties": {
+          "hooks": {
+            "type": "array",
+            "description": "Hooks exposed by this component. Hook ids must be unique within the component.",
+            "items": {
+              "$ref": "#/components/schemas/ExternalValuesHook"
+            }
+          }
+        }
+      },
+      "ExternalValuesHook": {
+        "type": "object",
+        "description": "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`.\n",
+        "required": [
+          "id",
+          "name",
+          "call",
+          "result"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]{1,100}$",
+            "description": "Stable identifier; consumers (e.g. validation rules) reference it. Renaming breaks references."
+          },
+          "name": {
+            "$ref": "#/components/schemas/TranslatedString"
+          },
+          "description": {
+            "$ref": "#/components/schemas/TranslatedString"
+          },
+          "auth_type": {
+            "type": "string",
+            "enum": [
+              "none",
+              "header",
+              "bearer",
+              "hmac"
+            ],
+            "default": "none",
+            "description": "Static request authentication applied to the call.\n- `none`: no static authentication.\n- `header`: sends `auth_secret` in header `auth_header` (default `X-API-Key`).\n- `bearer`: sends `Authorization: Bearer <auth_secret>`.\n- `hmac`: signs the request per Standard Webhooks (headers `webhook-id`,\n  `webhook-timestamp`, `webhook-signature` = `v1,<base64 HMAC-SHA256>` over\n  `<id>.<timestamp>.<body>`) using `auth_secret` as a `whsec_`-prefixed\n  base64 secret, exactly as epilot webhooks do.\n\n`auth_secret` is required when `auth_type` is `header`, `bearer` or `hmac`.\nCombine with `auth` (a pre-call that fetches a token) when the target needs both.\n"
+          },
+          "auth_header": {
+            "type": "string",
+            "description": "Header name used when `auth_type` is `header`. Defaults to `X-API-Key`."
+          },
+          "auth_secret": {
+            "type": "string",
+            "description": "Liquid template resolving to the secret, e.g. \"{{Options.api_key}}\". Must reference an option declared with `type: secret`; literals are rejected. Required when `auth_type` is `header`, `bearer` or `hmac`.",
+            "example": "{{Options.api_key}}"
+          },
+          "auth": {
+            "$ref": "#/components/schemas/PortalExtensionAuthBlock"
+          },
+          "call": {
+            "type": "object",
+            "required": [
+              "url"
+            ],
+            "properties": {
+              "method": {
+                "type": "string",
+                "enum": [
+                  "GET",
+                  "POST",
+                  "PUT",
+                  "PATCH"
+                ],
+                "default": "POST",
+                "description": "HTTP method to use for the call"
+              },
+              "url": {
+                "type": "string",
+                "description": "URL to call. Supports variable interpolation."
+              },
+              "headers": {
+                "type": "object",
+                "description": "Headers to send with the call. Supports variable interpolation.",
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "params": {
+                "type": "object",
+                "description": "Query parameters to append to the URL. Supports variable interpolation.",
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "body": {
+                "type": "object",
+                "description": "JSON body to send. Values support variable interpolation. When omitted, `{ Input, Context, Consumer }` is sent as-is.",
+                "additionalProperties": true
+              }
+            }
+          },
+          "result": {
+            "type": "array",
+            "minItems": 1,
+            "description": "Typed results extracted from the response. Result ids must be unique within the hook.",
+            "items": {
+              "$ref": "#/components/schemas/ExternalValuesResult"
+            }
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 500,
+            "maximum": 5000,
+            "default": 3000,
+            "description": "Timeout for the external call in milliseconds."
+          },
+          "on_unavailable": {
+            "type": "string",
+            "enum": [
+              "skip",
+              "block"
+            ],
+            "default": "skip",
+            "description": "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."
+          },
+          "cache": {
+            "type": "object",
+            "description": "Response caching. Off when omitted.",
+            "required": [
+              "ttl_seconds"
+            ],
+            "properties": {
+              "ttl_seconds": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 3600,
+                "description": "Time to live in seconds. 0 disables caching."
+              },
+              "key": {
+                "type": "string",
+                "description": "Liquid template for the cache key. Defaults to a hash of org, app, hook, `Input` and `Context`."
+              }
+            }
+          },
+          "use_static_ips": {
+            "type": "boolean",
+            "description": "If set, requests are sent from epilot's static egress IPs. Mutually exclusive with secure_proxy."
+          },
+          "secure_proxy": {
+            "$ref": "#/components/schemas/PortalExtensionSecureProxy"
+          }
+        }
+      },
+      "ExternalValuesResult": {
+        "type": "object",
+        "description": "A single typed value extracted from the hook response. Exactly one of `template`, `path` or `jsonata` must be set.\n",
+        "required": [
+          "id",
+          "type",
+          "name"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]{1,100}$",
+            "description": "Stable identifier of the result within the hook. Renaming breaks references."
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "number",
+              "text",
+              "date",
+              "boolean"
+            ],
+            "description": "Type the extracted value is coerced to."
+          },
+          "name": {
+            "$ref": "#/components/schemas/TranslatedString"
+          },
+          "template": {
+            "type": "string",
+            "description": "Liquid template over `Response` etc.; output coerced to `type`.",
+            "example": "{{Response.value}}"
+          },
+          "path": {
+            "type": "string",
+            "description": "Dot path into the response body, e.g. \"data.limit\".",
+            "example": "data.limit"
+          },
+          "jsonata": {
+            "type": "string",
+            "description": "JSONata expression over `{ Response, Input, Context, Options, Env }`.",
+            "example": "$sum(Response.items.amount)"
+          }
+        }
+      },
       "Grants": {
         "type": "array",
         "description": "Required grants for the app in order to call APIs for the installing tenant",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/app-client",
-  "version": "0.14.1",
+  "version": "0.16.0",
   "description": "JavaScript client library for the epilot App API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",