@epilot/sdk 2.8.0-rc.0 → 2.8.1

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 epilot GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -65,7 +65,6 @@ Full API documentation: [https://docs.epilot.io/api](https://docs.epilot.io/api)
 | `epilot.environments` | `@epilot/sdk/environments` | [docs](./docs/environments.md) |
 | `epilot.eventCatalog` | `@epilot/sdk/event-catalog` | [docs](./docs/event-catalog.md) |
 | `epilot.file` | `@epilot/sdk/file` | [docs](./docs/file.md) |
-| `epilot.focusPocus` | `@epilot/sdk/focus-pocus` | [docs](./docs/focus-pocus.md) |
 | `epilot.iban` | `@epilot/sdk/iban` | [docs](./docs/iban.md) |
 | `epilot.integrationToolkit` | `@epilot/sdk/integration-toolkit` | [docs](./docs/integration-toolkit.md) |
 | `epilot.journey` | `@epilot/sdk/journey` | [docs](./docs/journey.md) |

package/definitions/automation.json

@@ -1064,6 +1064,13 @@
               "$ref": "#/components/schemas/ActionSchedule"
             }
           },
+          "loops": {
+            "type": "array",
+            "description": "Loop scope definitions. Each loop has an id and a source_path resolved against the trigger entity at execution time. Actions referencing a loop's id via their loop_id property run once per item in the resolved array. Loop members must be contiguous in the actions array.\n",
+            "items": {
+              "$ref": "#/components/schemas/AutomationLoop"
+            }
+          },
           "actions": {
             "type": "array",
             "description": "The actions (nodes) of the automation flow",
@@ -1354,9 +1361,48 @@
           "schedule_id": {
             "type": "string",
             "description": "Schedule Id which indicates the schedule of the action"
+          },
+          "loop_id": {
+            "type": "string",
+            "description": "Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.\n"
           }
         }
       },
+      "AutomationLoop": {
+        "type": "object",
+        "description": "A loop scope on an automation flow.",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identifier referenced by AutomationActionConfig.loop_id",
+            "example": "loop_contracts"
+          },
+          "source_path": {
+            "type": "string",
+            "description": "Path resolved against the trigger entity to produce the array of iteration items. e.g. submission.steps[0]['Contracts'].\n",
+            "example": "submission.steps[0]['Contracts']"
+          },
+          "source_type": {
+            "type": "string",
+            "description": "How source_path is interpreted. 'journey-multi-select' is the v1 source type (journey card block with multi-select). Future source types (e.g. 'previous-action-outputs', 'entity-relation') will be added here.\n",
+            "enum": [
+              "journey-multi-select",
+              "previous-action-outputs",
+              "entity-relation"
+            ],
+            "default": "journey-multi-select"
+          },
+          "length": {
+            "type": "integer",
+            "description": "Maximum number of iterations. 0 / omitted = iterate the full resolved array.\n",
+            "minimum": 0
+          }
+        },
+        "required": [
+          "id",
+          "source_path"
+        ]
+      },
       "AutomationActionExecutionState": {
         "type": "object",
         "properties": {
@@ -1379,9 +1425,49 @@
           },
           "retry_strategy": {
             "$ref": "#/components/schemas/RetryStrategy"
+          },
+          "iterations": {
+            "type": "array",
+            "description": "For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.\n",
+            "items": {
+              "$ref": "#/components/schemas/AutomationActionIteration"
+            }
           }
         }
       },
+      "AutomationActionIteration": {
+        "type": "object",
+        "description": "A snapshot of a single completed pass through a looped action.",
+        "properties": {
+          "index": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Zero-based iteration index within the loop scope."
+          },
+          "execution_status": {
+            "$ref": "#/components/schemas/ExecutionStatus"
+          },
+          "started_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "ended_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "outputs": {
+            "type": "object",
+            "additionalProperties": true
+          },
+          "error_output": {
+            "$ref": "#/components/schemas/ErrorOutput"
+          }
+        },
+        "required": [
+          "index",
+          "execution_status"
+        ]
+      },
       "RetryStrategy": {
         "type": "string",
         "description": "different behaviors for retrying failed execution actions.",
@@ -3263,6 +3349,9 @@
             "type": "boolean",
             "description": "Result of the condition evaluation"
           },
+          "error_output": {
+            "$ref": "#/components/schemas/ErrorOutput"
+          },
           "statements": {
             "type": "array",
             "items": {
@@ -3433,6 +3522,20 @@
           },
           "workflow_context": {
             "$ref": "#/components/schemas/WorkflowExecutionContext"
+          },
+          "loops": {
+            "type": "array",
+            "description": "Loop scope definitions propagated from the flow onto the execution record. Each loop has an id and a source_path resolved against the trigger entity at execution time. Actions referencing a loop's id via their loop_id property run once per item in the resolved array.\n",
+            "items": {
+              "$ref": "#/components/schemas/AutomationLoop"
+            }
+          },
+          "loop_state": {
+            "type": "object",
+            "description": "Runtime iteration state, keyed by loop_id. Tracks the current_index and total for each active loop scope. Entries are removed once a loop exits.\n",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/AutomationLoopState"
+            }
           }
         },
         "required": [
@@ -3444,6 +3547,23 @@
           "actions"
         ]
       },
+      "AutomationLoopState": {
+        "type": "object",
+        "properties": {
+          "current_index": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "required": [
+          "current_index",
+          "total"
+        ]
+      },
       "WorkflowExecutionContext": {
         "type": "object",
         "required": [

package/definitions/blueprint-manifest-runtime.json

@@ -1 +1 @@
-{"s":"https://blueprint-manifest.sls.epilot.io","o":[["getJob","get","/v1/blueprint-manifest/jobs/{job_id}",[["JobID"]]],["createExport","post","/v1/blueprint-manifest/jobs:createExport",null,1],["exportManifest","post","/v1/blueprint-manifest/jobs/{job_id}:exportManifest",[["JobID"]],1],["uploadManifest","post","/v1/blueprint-manifest:uploadManifest",null,1],["createPlan","post","/v1/blueprint-manifest/jobs:createPlan",null,1],["applyPlan","post","/v1/blueprint-manifest/jobs/{job_id}:applyPlan",[["JobID"]],1],["listInstalledManifests","get","/v1/blueprint-manifest/manifests"],["getManifest","get","/v1/blueprint-manifest/manifests/{manifest_id}",[["manifest_id","p",true]]],["updateManifest","put","/v1/blueprint-manifest/manifests/{manifest_id}",[["manifest_id","p",true]],1],["deleteManifest","delete","/v1/blueprint-manifest/manifests/{manifest_id}",[["manifest_id","p",true]]],["listBlueprints","get","/v2/blueprint-manifest/blueprints",[["archived","q"]]],["createBlueprint","post","/v2/blueprint-manifest/blueprints",null,1],["listInstalledMarketplaceBlueprints","get","/v2/blueprint-manifest/blueprints:marketplace"],["preInstallBlueprint","post","/v2/blueprint-manifest/blueprints:pre-install",null,1],["getBlueprintPreview","get","/v2/blueprint-manifest/blueprints:preview/{preview_id}",[["preview_id","p",true]]],["installBlueprint","post","/v2/blueprint-manifest/blueprint:install",null,1],["getBlueprint","get","/v2/blueprint-manifest/blueprints/{blueprint_id}",[["blueprint_id","p",true]]],["updateBlueprint","put","/v2/blueprint-manifest/blueprints/{blueprint_id}",[["blueprint_id","p",true]],1],["deleteBlueprint","delete","/v2/blueprint-manifest/blueprints/{blueprint_id}",[["blueprint_id","p",true]]],["validateBlueprint","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/validate",[["blueprint_id","p",true]]],["verifyBlueprint","post","/v2/blueprint-manifest/blueprints/{blueprint_id}:verify",[["blueprint_id","p",true]],1],["exportBlueprint","post","/v2/blueprint-manifest/blueprints/{blueprint_id}:export",[["blueprint_id","p",true]],1],["listMarketplaceSlugs","get","/v2/blueprint-manifest/marketplace/slugs"],["publishBlueprint","post","/v2/blueprint-manifest/blueprints:publish",null,1],["formatBlueprintDescription","post","/v2/blueprint-manifest/blueprints/{blueprint_id}:format-description",[["blueprint_id","p",true]],1],["addBlueprintResource","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources",[["blueprint_id","p",true],["add_dependencies","q"]],1],["syncDependencies","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources:syncDependencies",[["blueprint_id","p",true]]],["bulkAddBlueprintResources","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources/bulk",[["blueprint_id","p",true],["add_dependencies","q"]],1],["bulkUpdateBlueprintResources","put","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources/bulk",[["blueprint_id","p",true]],1],["bulkDeleteBlueprintResources","delete","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources/bulk",[["blueprint_id","p",true]],1],["updateBlueprintResource","put","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources/{resource_id}",[["blueprint_id","p",true],["resource_id","p",true]],1],["deleteBlueprintResource","delete","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources/{resource_id}",[["blueprint_id","p",true],["resource_id","p",true]]],["listBlueprintJobs","get","/v2/blueprint-manifest/jobs"],["getBlueprintJob","get","/v2/blueprint-manifest/jobs/{job_id}",[["job_id","p",true]]],["continueInstallationJob","post","/v2/blueprint-manifest/jobs/{job_id}:continue",[["job_id","p",true]],1],["cancelBlueprintJob","post","/v2/blueprint-manifest/jobs/{job_id}:cancel",[["job_id","p",true]]],["createMarketplaceListing","post","/v1/blueprints/{blueprint_id}/marketplace-listing",[["blueprint_id","p",true]],1],["getMarketplaceListing","get","/v1/blueprints/{blueprint_id}/marketplace-listing",[["blueprint_id","p",true]]],["listMarketplaceListings","get","/v1/marketplace-listings"],["getMarketplaceListingById","get","/v1/marketplace-listings/{listing_id}",[["listing_id","p",true]]],["updateMarketplaceListing","patch","/v1/marketplace-listings/{listing_id}",[["listing_id","p",true]],1],["deleteMarketplaceListing","delete","/v1/marketplace-listings/{listing_id}",[["listing_id","p",true]]],["createMarketplaceListingVersion","post","/v1/marketplace-listings/{listing_id}/versions",[["listing_id","p",true]]],["listMarketplaceListingVersions","get","/v1/marketplace-listings/{listing_id}/versions",[["listing_id","p",true]]],["updateMarketplaceListingVersion","patch","/v1/marketplace-listings/{listing_id}/versions/{version_id}",[["listing_id","p",true],["version_id","p",true]],1],["publishMarketplaceListingVersion","post","/v1/marketplace-listings/{listing_id}/versions/{version_id}/publish",[["listing_id","p",true],["version_id","p",true]],1],["installBlueprintV3","post","/v3/blueprint-manifest/blueprint:install",null,1],["getBlueprintLineageV3","get","/v3/blueprint-manifest/blueprints/{blueprint_id}/lineage",[["blueprint_id","p",true]]]],"cp":{"JobID":["job_id","p",true]}}
+{"s":"https://blueprint-manifest.sls.epilot.io","o":[["getJob","get","/v1/blueprint-manifest/jobs/{job_id}",[["JobID"]]],["createExport","post","/v1/blueprint-manifest/jobs:createExport",null,1],["exportManifest","post","/v1/blueprint-manifest/jobs/{job_id}:exportManifest",[["JobID"]],1],["uploadManifest","post","/v1/blueprint-manifest:uploadManifest",null,1],["createPlan","post","/v1/blueprint-manifest/jobs:createPlan",null,1],["applyPlan","post","/v1/blueprint-manifest/jobs/{job_id}:applyPlan",[["JobID"]],1],["listInstalledManifests","get","/v1/blueprint-manifest/manifests"],["getManifest","get","/v1/blueprint-manifest/manifests/{manifest_id}",[["manifest_id","p",true]]],["updateManifest","put","/v1/blueprint-manifest/manifests/{manifest_id}",[["manifest_id","p",true]],1],["deleteManifest","delete","/v1/blueprint-manifest/manifests/{manifest_id}",[["manifest_id","p",true]]],["listBlueprints","get","/v2/blueprint-manifest/blueprints",[["archived","q"]]],["createBlueprint","post","/v2/blueprint-manifest/blueprints",null,1],["listInstalledMarketplaceBlueprints","get","/v2/blueprint-manifest/blueprints:marketplace"],["preInstallBlueprint","post","/v2/blueprint-manifest/blueprints:pre-install",null,1],["getBlueprintPreview","get","/v2/blueprint-manifest/blueprints:preview/{preview_id}",[["preview_id","p",true]]],["installBlueprint","post","/v2/blueprint-manifest/blueprint:install",null,1],["getBlueprint","get","/v2/blueprint-manifest/blueprints/{blueprint_id}",[["blueprint_id","p",true]]],["updateBlueprint","put","/v2/blueprint-manifest/blueprints/{blueprint_id}",[["blueprint_id","p",true]],1],["deleteBlueprint","delete","/v2/blueprint-manifest/blueprints/{blueprint_id}",[["blueprint_id","p",true]]],["validateBlueprint","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/validate",[["blueprint_id","p",true]]],["verifyBlueprint","post","/v2/blueprint-manifest/blueprints/{blueprint_id}:verify",[["blueprint_id","p",true]],1],["detectPatchChanges","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/patches:detect",[["blueprint_id","p",true]],1],["createPatch","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/patches",[["blueprint_id","p",true]],1],["listPatches","get","/v2/blueprint-manifest/blueprints/{blueprint_id}/patches",[["blueprint_id","p",true]]],["getPatch","get","/v2/blueprint-manifest/blueprints/{blueprint_id}/patches/{patch_id}",[["blueprint_id","p",true],["patch_id","p",true]]],["applyPatch","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/patches/{patch_id}:apply",[["blueprint_id","p",true],["patch_id","p",true]],1],["retryPatchOrg","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/patches/{patch_id}/orgs/{org_id}:retry",[["blueprint_id","p",true],["patch_id","p",true],["org_id","p",true]],1],["exportBlueprint","post","/v2/blueprint-manifest/blueprints/{blueprint_id}:export",[["blueprint_id","p",true]],1],["listMarketplaceSlugs","get","/v2/blueprint-manifest/marketplace/slugs"],["publishBlueprint","post","/v2/blueprint-manifest/blueprints:publish",null,1],["formatBlueprintDescription","post","/v2/blueprint-manifest/blueprints/{blueprint_id}:format-description",[["blueprint_id","p",true]],1],["suggestBlueprintResources","post","/v2/blueprint-manifest/blueprints:suggest-resources",null,1],["addBlueprintResource","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources",[["blueprint_id","p",true],["add_dependencies","q"]],1],["syncDependencies","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources:syncDependencies",[["blueprint_id","p",true]]],["bulkAddBlueprintResources","post","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources/bulk",[["blueprint_id","p",true],["add_dependencies","q"]],1],["bulkUpdateBlueprintResources","put","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources/bulk",[["blueprint_id","p",true]],1],["bulkDeleteBlueprintResources","delete","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources/bulk",[["blueprint_id","p",true]],1],["updateBlueprintResource","put","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources/{resource_id}",[["blueprint_id","p",true],["resource_id","p",true]],1],["deleteBlueprintResource","delete","/v2/blueprint-manifest/blueprints/{blueprint_id}/resources/{resource_id}",[["blueprint_id","p",true],["resource_id","p",true]]],["listBlueprintJobs","get","/v2/blueprint-manifest/jobs"],["getBlueprintJob","get","/v2/blueprint-manifest/jobs/{job_id}",[["job_id","p",true]]],["continueInstallationJob","post","/v2/blueprint-manifest/jobs/{job_id}:continue",[["job_id","p",true]],1],["cancelBlueprintJob","post","/v2/blueprint-manifest/jobs/{job_id}:cancel",[["job_id","p",true]]],["createMarketplaceListing","post","/v1/blueprints/{blueprint_id}/marketplace-listing",[["blueprint_id","p",true]],1],["getMarketplaceListing","get","/v1/blueprints/{blueprint_id}/marketplace-listing",[["blueprint_id","p",true]]],["listMarketplaceListings","get","/v1/marketplace-listings"],["getMarketplaceListingById","get","/v1/marketplace-listings/{listing_id}",[["listing_id","p",true]]],["updateMarketplaceListing","patch","/v1/marketplace-listings/{listing_id}",[["listing_id","p",true]],1],["deleteMarketplaceListing","delete","/v1/marketplace-listings/{listing_id}",[["listing_id","p",true]]],["createMarketplaceListingVersion","post","/v1/marketplace-listings/{listing_id}/versions",[["listing_id","p",true]]],["listMarketplaceListingVersions","get","/v1/marketplace-listings/{listing_id}/versions",[["listing_id","p",true]]],["updateMarketplaceListingVersion","patch","/v1/marketplace-listings/{listing_id}/versions/{version_id}",[["listing_id","p",true],["version_id","p",true]],1],["publishMarketplaceListingVersion","post","/v1/marketplace-listings/{listing_id}/versions/{version_id}/publish",[["listing_id","p",true],["version_id","p",true]],1],["installBlueprintV3","post","/v3/blueprint-manifest/blueprint:install",null,1],["getBlueprintLineageV3","get","/v3/blueprint-manifest/blueprints/{blueprint_id}/lineage",[["blueprint_id","p",true]]]],"cp":{"JobID":["job_id","p",true]}}