@epilot/sdk 2.4.2 → 2.4.4-alpha.0

package/README.md

@@ -49,6 +49,7 @@ Full API documentation: [https://docs.epilot.io/api](https://docs.epilot.io/api)
 | `epilot.automation` | `@epilot/sdk/automation` | [docs](./docs/automation.md) |
 | `epilot.billing` | `@epilot/sdk/billing` | [docs](./docs/billing.md) |
 | `epilot.blueprintManifest` | `@epilot/sdk/blueprint-manifest` | [docs](./docs/blueprint-manifest.md) |
+| `epilot.calendar` | `@epilot/sdk/calendar` | [docs](./docs/calendar.md) |
 | `epilot.configurationHub` | `@epilot/sdk/configuration-hub` | [docs](./docs/configuration-hub.md) |
 | `epilot.consent` | `@epilot/sdk/consent` | [docs](./docs/consent.md) |
 | `epilot.customerPortal` | `@epilot/sdk/customer-portal` | [docs](./docs/customer-portal.md) |

package/definitions/app-runtime.json

@@ -1 +1 @@
-{"s":"https://app.sls.epilot.io","o":[["getPublicFacingComponent","get","/v1/public/app/{appId}/components/{componentId}"],["listConfigurations","get","/v1/app-configurations",[["page","q"],["pageSize","q"]]],["createConfiguration","post","/v1/app-configurations",null,1],["listPublicConfigurations","get","/v1/app-configurations/public",[["page","q"],["pageSize","q"]]],["getPublicConfiguration","get","/v1/app-configurations/public/{appId}",[["version","q"]]],["getConfiguration","get","/v1/app-configurations/{appId}",[["version","q"]]],["patchMetadata","patch","/v1/app-configurations/{appId}",null,1],["deleteConfiguration","delete","/v1/app-configurations/{appId}"],["queryEvents","post","/v1/app-configurations/{appId}/events",[["appId","p",true]],1],["createBundleUploadUrl","post","/v1/app-configurations/{appId}/bundle",[["appId","p",true]],1],["createZipUploadUrl","post","/v1/app-configurations/{appId}/zip",[["appId","p",true]],1],["createLogoUploadUrl","post","/v1/app-configurations/{appId}/logo",null,1],["deleteLogo","delete","/v1/app-configurations/{appId}/logo"],["listVersions","get","/v1/app-configurations/{appId}/versions",[["appId","p",true],["page","q"],["pageSize","q"]]],["getVersion","get","/v1/app-configurations/{appId}/versions/{version}",[["appId","p",true],["version","p",true]]],["deleteVersion","delete","/v1/app-configurations/{appId}/versions/{version}",[["appId","p",true],["version","p",true]]],["patchVersion","patch","/v1/app-configurations/{appId}/versions/{version}",[["appId","p",true],["version","p",true]],1],["getReview","get","/v1/app-configurations/{appId}/versions/{version}/review",[["appId","p",true],["version","p",true]]],["createReview","post","/v1/app-configurations/{appId}/versions/{version}/review",[["appId","p",true],["version","p",true]],1],["createComponent","post","/v1/app-configurations/{appId}/versions/{version}/components",[["appId","p",true],["version","p",true]],1],["patchComponent","patch","/v1/app-configurations/{appId}/versions/{version}/components/{componentId}",[["appId","p",true],["version","p",true],["componentId","p",true]],1],["deleteComponent","delete","/v1/app-configurations/{appId}/versions/{version}/components/{componentId}",[["appId","p",true],["version","p",true],["componentId","p",true]]],["cloneVersion","post","/v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}",[["appId","p",true],["sourceVersion","p",true],["targetVersion","p",true]]],["listInstallations","get","/v1/app",[["componentType","q"],["enabled","q"],["page","q"],["pageSize","q"]]],["getInstallation","get","/v1/app/{appId}",[["appId","p",true]]],["install","post","/v1/app/{appId}",[["appId","p",true]],1],["patchInstallation","patch","/v1/app/{appId}",[["appId","p",true]],1],["uninstall","delete","/v1/app/{appId}",[["appId","p",true]]],["promoteVersion","post","/v1/app/{appId}/promote-to/{version}",[["appId","p",true],["version","p",true]]],["ingestEvent","post","/v1/app-events",null,1]],"v":"3.1.0","pp":{"/v1/public/app/{appId}/components/{componentId}":[["appId","p",true],["componentId","p",true]],"/v1/app-configurations/public/{appId}":[["appId","p",true]],"/v1/app-configurations/{appId}":[["appId","p",true]],"/v1/app-configurations/{appId}/logo":[["appId","p",true]]}}
+{"s":"https://app.sls.epilot.io","o":[["getPublicFacingComponent","get","/v1/public/app/{appId}/components/{componentId}"],["listConfigurations","get","/v1/app-configurations",[["page","q"],["pageSize","q"]]],["createConfiguration","post","/v1/app-configurations",null,1],["listPublicConfigurations","get","/v1/app-configurations/public",[["page","q"],["pageSize","q"]]],["getPublicConfiguration","get","/v1/app-configurations/public/{appId}",[["version","q"]]],["getConfiguration","get","/v1/app-configurations/{appId}",[["version","q"]]],["patchMetadata","patch","/v1/app-configurations/{appId}",null,1],["deleteConfiguration","delete","/v1/app-configurations/{appId}"],["queryEvents","post","/v1/app-configurations/{appId}/events",[["appId","p",true]],1],["createBundleUploadUrl","post","/v1/app-configurations/{appId}/bundle",[["appId","p",true]],1],["createZipUploadUrl","post","/v1/app-configurations/{appId}/zip",[["appId","p",true]],1],["createLogoUploadUrl","post","/v1/app-configurations/{appId}/logo",null,1],["deleteLogo","delete","/v1/app-configurations/{appId}/logo"],["listVersions","get","/v1/app-configurations/{appId}/versions",[["appId","p",true],["page","q"],["pageSize","q"]]],["getVersion","get","/v1/app-configurations/{appId}/versions/{version}",[["appId","p",true],["version","p",true]]],["deleteVersion","delete","/v1/app-configurations/{appId}/versions/{version}",[["appId","p",true],["version","p",true]]],["patchVersion","patch","/v1/app-configurations/{appId}/versions/{version}",[["appId","p",true],["version","p",true]],1],["getReview","get","/v1/app-configurations/{appId}/versions/{version}/review",[["appId","p",true],["version","p",true]]],["createReview","post","/v1/app-configurations/{appId}/versions/{version}/review",[["appId","p",true],["version","p",true]],1],["createComponent","post","/v1/app-configurations/{appId}/versions/{version}/components",[["appId","p",true],["version","p",true]],1],["patchComponent","patch","/v1/app-configurations/{appId}/versions/{version}/components/{componentId}",[["appId","p",true],["version","p",true],["componentId","p",true]],1],["deleteComponent","delete","/v1/app-configurations/{appId}/versions/{version}/components/{componentId}",[["appId","p",true],["version","p",true],["componentId","p",true]]],["cloneVersion","post","/v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}",[["appId","p",true],["sourceVersion","p",true],["targetVersion","p",true]]],["listInstallations","get","/v1/app",[["componentType","q"],["enabled","q"],["page","q"],["pageSize","q"]]],["getInstallation","get","/v1/app/{appId}",[["appId","p",true]]],["install","post","/v1/app/{appId}",[["appId","p",true]],1],["patchInstallation","patch","/v1/app/{appId}",[["appId","p",true]],1],["uninstall","delete","/v1/app/{appId}",[["appId","p",true]]],["promoteVersion","post","/v1/app/{appId}/promote-to/{version}",[["appId","p",true],["version","p",true]]],["ingestEvent","post","/v1/app-events",null,1],["publicProxyGet","get","/v1/public/app/{appId}/proxy/{proxyName}/{path}"],["publicProxyPost","post","/v1/public/app/{appId}/proxy/{proxyName}/{path}",null,1]],"v":"3.1.0","pp":{"/v1/public/app/{appId}/components/{componentId}":[["appId","p",true],["componentId","p",true]],"/v1/app-configurations/public/{appId}":[["appId","p",true]],"/v1/app-configurations/{appId}":[["appId","p",true]],"/v1/app-configurations/{appId}/logo":[["appId","p",true]],"/v1/public/app/{appId}/proxy/{proxyName}/{path}":[["appId","p",true],["proxyName","p",true],["path","p",true]]}}

package/definitions/app.json

@@ -17,6 +17,10 @@
     {
       "name": "App Analytics",
       "description": "Analytics for installed apps"
+    },
+    {
+      "name": "App Proxy",
+      "description": "Forward requests to external APIs via registered proxy targets"
     }
   ],
   "servers": [
@@ -1468,6 +1472,100 @@
           }
         }
       }
+    },
+    "/v1/public/app/{appId}/proxy/{proxyName}/{path}": {
+      "parameters": [
+        {
+          "name": "appId",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          },
+          "description": "ID of the installed app"
+        },
+        {
+          "name": "proxyName",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          },
+          "description": "Name of the proxy target as defined in the app manifest"
+        },
+        {
+          "name": "path",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          },
+          "description": "Path to forward to the proxy target"
+        }
+      ],
+      "get": {
+        "summary": "publicProxyGet",
+        "operationId": "publicProxyGet",
+        "description": "Forward a GET request to a registered proxy target from a public-facing component (e.g. journey blocks)",
+        "tags": [
+          "App Proxy"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Proxied response from the target API"
+          },
+          "403": {
+            "description": "Forbidden - app not installed or no public component uses this proxy"
+          },
+          "404": {
+            "description": "Proxy target not found"
+          },
+          "502": {
+            "description": "Bad gateway - proxy target unreachable or error"
+          }
+        }
+      },
+      "post": {
+        "summary": "publicProxyPost",
+        "operationId": "publicProxyPost",
+        "description": "Forward a POST request to a registered proxy target from a public-facing component (e.g. journey blocks)",
+        "tags": [
+          "App Proxy"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Proxied response from the target API"
+          },
+          "403": {
+            "description": "Forbidden - app not installed or no public component uses this proxy"
+          },
+          "404": {
+            "description": "Proxy target not found"
+          },
+          "502": {
+            "description": "Bad gateway - proxy target unreachable or error"
+          }
+        }
+      }
     }
   },
   "components": {
@@ -1832,7 +1930,8 @@
           "ERP_INFORM_TOOLKIT",
           "CUSTOM_CAPABILITY",
           "EXTERNAL_PRODUCT_CATALOG",
-          "CUSTOM_PAGE"
+          "CUSTOM_PAGE",
+          "API_PROXY"
         ],
         "description": "Type of app component"
       },
@@ -1944,7 +2043,8 @@
                 "ERP_INFORM_TOOLKIT": "#/components/schemas/ErpInformToolkitComponent",
                 "CUSTOM_CAPABILITY": "#/components/schemas/CustomCapabilityComponent",
                 "EXTERNAL_PRODUCT_CATALOG": "#/components/schemas/ExternalProductCatalogComponent",
-                "CUSTOM_PAGE": "#/components/schemas/CustomPageComponent"
+                "CUSTOM_PAGE": "#/components/schemas/CustomPageComponent",
+                "API_PROXY": "#/components/schemas/ApiProxyComponent"
               }
             },
             "oneOf": [
@@ -1971,11 +2071,32 @@
               },
               {
                 "$ref": "#/components/schemas/CustomPageComponent"
+              },
+              {
+                "$ref": "#/components/schemas/ApiProxyComponent"
               }
             ]
           }
         ]
       },
+      "ApiProxyComponent": {
+        "type": "object",
+        "required": [
+          "component_type",
+          "configuration"
+        ],
+        "properties": {
+          "component_type": {
+            "type": "string",
+            "enum": [
+              "API_PROXY"
+            ]
+          },
+          "configuration": {
+            "$ref": "#/components/schemas/ApiProxyConfig"
+          }
+        }
+      },
       "CustomCapabilityComponent": {
         "type": "object",
         "required": [
@@ -2488,6 +2609,7 @@
                   "contractIdentification": "#/components/schemas/PortalExtensionHookContractIdentification",
                   "priceDataRetrieval": "#/components/schemas/PortalExtensionHookPriceDataRetrieval",
                   "consumptionDataRetrieval": "#/components/schemas/PortalExtensionHookConsumptionDataRetrieval",
+                  "dataExport": "#/components/schemas/PortalExtensionHookDataExport",
                   "costDataRetrieval": "#/components/schemas/PortalExtensionHookCostDataRetrieval",
                   "meterReadingPlausibilityCheck": "#/components/schemas/PortalExtensionHookMeterReadingPlausibilityCheck"
                 }
@@ -2505,6 +2627,9 @@
                 {
                   "$ref": "#/components/schemas/PortalExtensionHookConsumptionDataRetrieval"
                 },
+                {
+                  "$ref": "#/components/schemas/PortalExtensionHookDataExport"
+                },
                 {
                   "$ref": "#/components/schemas/PortalExtensionHookCostDataRetrieval"
                 },
@@ -2594,7 +2719,8 @@
           },
           "use_static_ips": {
             "type": "boolean",
-            "description": "If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.",
+            "deprecated": true,
+            "description": "Deprecated. Prefer `secure_proxy` instead.\nIf true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.\n",
             "default": false
           },
           "secure_proxy": {
@@ -2707,7 +2833,8 @@
           },
           "use_static_ips": {
             "type": "boolean",
-            "description": "If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.",
+            "deprecated": true,
+            "description": "Deprecated. Prefer `secure_proxy` instead.\nIf true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.\n",
             "default": false
           },
           "secure_proxy": {
@@ -2818,7 +2945,8 @@
           },
           "use_static_ips": {
             "type": "boolean",
-            "description": "If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.",
+            "deprecated": true,
+            "description": "Deprecated. Prefer `secure_proxy` instead.\nIf true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.\n",
             "default": false
           },
           "secure_proxy": {
@@ -2918,7 +3046,8 @@
           },
           "use_static_ips": {
             "type": "boolean",
-            "description": "If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.",
+            "deprecated": true,
+            "description": "Deprecated. Prefer `secure_proxy` instead.\nIf true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.\n",
             "default": false
           },
           "secure_proxy": {
@@ -2963,6 +3092,20 @@
               ]
             }
           },
+          "type_options": {
+            "type": "array",
+            "description": "Consumption types advertised by the hook (e.g. `ht`/`nt`, `feed-in`/`feed-out`). The `id` has to match the `type` field returned in the consumption response.\n",
+            "items": {
+              "$ref": "#/components/schemas/PortalExtensionHookConsumptionOption"
+            }
+          },
+          "aggregation_method_options": {
+            "type": "array",
+            "description": "Aggregation methods advertised by the hook (e.g. `sum`, `average`, `min`, `max`). The `id` has to match the `aggregation_method` field returned in the consumption response.\n",
+            "items": {
+              "$ref": "#/components/schemas/PortalExtensionHookConsumptionAggregationMethodOption"
+            }
+          },
           "auth": {
             "$ref": "#/components/schemas/PortalExtensionAuthBlock"
           },
@@ -3017,7 +3160,85 @@
           },
           "use_static_ips": {
             "type": "boolean",
-            "description": "If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.",
+            "deprecated": true,
+            "description": "Deprecated. Prefer `secure_proxy` instead.\nIf true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.\n",
+            "default": false
+          },
+          "secure_proxy": {
+            "$ref": "#/components/schemas/PortalExtensionSecureProxy"
+          }
+        },
+        "required": [
+          "id",
+          "type",
+          "call"
+        ],
+        "additionalProperties": false
+      },
+      "PortalExtensionHookDataExport": {
+        "description": "Generic data export hook. When configured on blocks that support it, the portal delegates the export action (e.g. CSV/Excel/PDF download) to the configured external source instead of generating the file itself. Can be used by any block that supports export — consumption charts, dynamic tariff charts, etc. The expected response to the call is:\n  - 200 with a JSON body describing the exported file (download_url, optional filename, content_type, expires_at)\n",
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]+$",
+            "description": "Identifier of the hook. Should not change between updates."
+          },
+          "name": {
+            "$ref": "#/components/schemas/TranslatedString"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "dataExport"
+            ]
+          },
+          "auth": {
+            "$ref": "#/components/schemas/PortalExtensionAuthBlock"
+          },
+          "call": {
+            "type": "object",
+            "properties": {
+              "method": {
+                "type": "string",
+                "description": "HTTP method to use for the call",
+                "default": "GET"
+              },
+              "url": {
+                "type": "string",
+                "description": "URL to call. Supports variable interpolation."
+              },
+              "params": {
+                "type": "object",
+                "description": "Parameters to append to the URL. Supports variable interpolation.",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "default": {}
+              },
+              "headers": {
+                "type": "object",
+                "description": "Headers to use. Supports variable interpolation.",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "default": {}
+              },
+              "body": {
+                "type": "object",
+                "description": "Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.",
+                "additionalProperties": true
+              }
+            },
+            "required": [
+              "url"
+            ],
+            "additionalProperties": false
+          },
+          "use_static_ips": {
+            "type": "boolean",
+            "deprecated": true,
+            "description": "Deprecated. Prefer `secure_proxy` instead.\nIf true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.\n",
             "default": false
           },
           "secure_proxy": {
@@ -3031,6 +3252,53 @@
         ],
         "additionalProperties": false
       },
+      "PortalExtensionHookConsumptionOption": {
+        "type": "object",
+        "description": "A consumption type advertised by a consumption data retrieval hook.",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Identifier of the option. Matches the `type` value returned by the hook (e.g. `ht`, `nt`, `feed-in`)."
+          },
+          "label": {
+            "$ref": "#/components/schemas/TranslatedString"
+          },
+          "aggregation_group": {
+            "type": "string",
+            "description": "Optional grouping key. Types sharing the same aggregation_group are interpreted as values that can be aggregated (e.g. ht/nt shown as a stacked bar chart - summed into total consumption per interval). Types in different groups — or types without a group — are not (e.g. feed-in vs feed-out shown as separate bars).\n",
+            "example": "consumption"
+          }
+        },
+        "required": [
+          "id",
+          "label"
+        ],
+        "additionalProperties": false
+      },
+      "PortalExtensionHookConsumptionAggregationMethodOption": {
+        "type": "object",
+        "description": "An aggregation method advertised by a consumption data retrieval hook.",
+        "properties": {
+          "id": {
+            "type": "string",
+            "enum": [
+              "sum",
+              "average",
+              "min",
+              "max"
+            ],
+            "description": "Identifier of the option. Matches the `aggregation_method` value returned by the hook."
+          },
+          "label": {
+            "$ref": "#/components/schemas/TranslatedString"
+          }
+        },
+        "required": [
+          "id",
+          "label"
+        ],
+        "additionalProperties": false
+      },
       "PortalExtensionHookCostDataRetrieval": {
         "description": "Hook that will allow using the specified source as data for consumption visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:\n  - 200 with the time series data\n",
         "type": "object",
@@ -3116,7 +3384,8 @@
           },
           "use_static_ips": {
             "type": "boolean",
-            "description": "If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.",
+            "deprecated": true,
+            "description": "Deprecated. Prefer `secure_proxy` instead.\nIf true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.\n",
             "default": false
           },
           "secure_proxy": {
@@ -3430,7 +3699,8 @@
                 "enum": [
                   "text",
                   "boolean",
-                  "enum"
+                  "enum",
+                  "block_reference"
                 ]
               },
               "required": {
@@ -3467,7 +3737,8 @@
               "mapping": {
                 "text": "#/components/schemas/TextArg",
                 "boolean": "#/components/schemas/BooleanArg",
-                "enum": "#/components/schemas/EnumArg"
+                "enum": "#/components/schemas/EnumArg",
+                "block_reference": "#/components/schemas/BlockReferenceArg"
               }
             },
             "oneOf": [
@@ -3479,6 +3750,9 @@
               },
               {
                 "$ref": "#/components/schemas/EnumArg"
+              },
+              {
+                "$ref": "#/components/schemas/BlockReferenceArg"
               }
             ]
           }
@@ -3506,6 +3780,25 @@
           }
         }
       },
+      "BlockReferenceArg": {
+        "type": "object",
+        "description": "References another journey block by its ID. The configuring user picks\na block from the journey via a dropdown in the journey-builder; the\nchosen block's ID is stored as the arg value (a string). The bundle can\nthen call `subscribe(blockId, cb)` / `getValue(blockId)` against that ID.\n",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "block_reference"
+            ]
+          },
+          "allowed_types": {
+            "type": "array",
+            "description": "Restrict the picker to blocks of these journey block types\n(e.g. [\"availability-check\", \"address\"]). Omit to allow any type.\n",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
       "EnumArg": {
         "type": "object",
         "required": [
@@ -3876,6 +4169,49 @@
           }
         }
       },
+      "ApiProxyConfig": {
+        "type": "object",
+        "description": "Configuration for an API proxy component",
+        "required": [
+          "name",
+          "target",
+          "auth_type"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Human-friendly proxy name used in SDK calls",
+            "pattern": "^[a-zA-Z0-9_-]+$",
+            "maxLength": 64
+          },
+          "target": {
+            "type": "string",
+            "format": "uri",
+            "description": "Base URL of the target API. Must be HTTPS.",
+            "pattern": "^https://"
+          },
+          "auth_type": {
+            "type": "string",
+            "enum": [
+              "header",
+              "bearer",
+              "oauth2",
+              "none"
+            ],
+            "description": "Authentication strategy"
+          },
+          "auth_header": {
+            "type": "string",
+            "description": "Header name for 'header' auth type"
+          },
+          "token_url": {
+            "type": "string",
+            "format": "uri",
+            "description": "OAuth2 token endpoint URL",
+            "pattern": "^https://"
+          }
+        }
+      },
       "Grants": {
         "type": "array",
         "description": "Required grants for the app in order to call APIs for the installing tenant",

package/definitions/automation.json

@@ -70,6 +70,15 @@
               "example": "600945fe-212e-4b97-acf7-391d64648384"
             }
           },
+          {
+            "name": "target_workflow",
+            "in": "query",
+            "description": "Filter by target workflow ID. Returns only automations that have a trigger-workflow action targeting this workflow.",
+            "schema": {
+              "type": "string",
+              "example": "wfABCDEFGH"
+            }
+          },
           {
             "name": "include_flows",
             "in": "query",
@@ -2239,6 +2248,11 @@
             "type": "boolean",
             "description": "When enabled, the email thread will be automatically marked as done after this action completes.",
             "default": false
+          },
+          "mark_as_read": {
+            "type": "boolean",
+            "description": "When enabled, the email thread will be marked as read after this action completes.",
+            "default": true
           }
         },
         "required": [
@@ -2323,6 +2337,11 @@
             "type": "boolean",
             "description": "When enabled, the email thread will be automatically marked as done after this action completes.",
             "default": false
+          },
+          "mark_as_read": {
+            "type": "boolean",
+            "description": "When enabled, the email thread will be marked as read after this action completes.",
+            "default": false
           }
         }
       },
@@ -2373,6 +2392,11 @@
             "description": "When enabled, the email thread will be automatically marked as done after this action completes.",
             "default": true
           },
+          "mark_as_read": {
+            "type": "boolean",
+            "description": "When enabled, the email thread will be marked as read after this action completes.",
+            "default": true
+          },
           "attachments": {
             "type": "array",
             "description": "Include extra file attachments in sent email.\nAttachments in email template will be sent regardless of this configuration.\n",
@@ -3438,6 +3462,24 @@
           },
           "_execution_chain": {
             "$ref": "#/components/schemas/ExecutionChain"
+          },
+          "entity_contexts": {
+            "type": "array",
+            "description": "Additional entity contexts from the parent flow execution. Used when an automation is triggered from a workflow task to carry all flow contexts into the automation, not just the primary entity.\n",
+            "items": {
+              "type": "object",
+              "properties": {
+                "entity_id": {
+                  "type": "string"
+                },
+                "entity_schema": {
+                  "type": "string"
+                },
+                "is_primary": {
+                  "type": "boolean"
+                }
+              }
+            }
           }
         }
       },

package/definitions/calendar-runtime.json

@@ -0,0 +1 @@
+{"s":"https://calendar.sls.epilot.io","o":[["listCalendars","get","/v1/calendar",[["size","q"],["cursor","q"]]],["getCalendar","get","/v1/calendar/{calendar_id}",[["calendar_id","p",true]]],["listEvents","get","/v1/calendar/events",[["from","q",true],["to","q",true],["calendar_id","q"],["size","q"],["cursor","q"]]],["getEvent","get","/v1/calendar/events/{event_id}",[["event_id","p",true]]]],"v":"3.0.3"}