@epilot/sdk 2.20.22 → 2.20.23

package/dist/{chunk-R6RAUX3Z.js → chunk-KZXOYL5D.js}

@@ -27,7 +27,7 @@ var authorize = (client, token) => {
 
 // import("./docs/**/*") in src/help.ts
 var globImport_docs = __glob({
-  "./docs/README.json": () => import("./README-NBWAQWQS.js"),
+  "./docs/README.json": () => import("./README-7F36AG5O.js"),
   "./docs/_index.json": () => import("./_index-6FK4PV6Y.js"),
   "./docs/access-token.json": () => import("./access-token-ADVHFJ63.js"),
   "./docs/address-suggestions.json": () => import("./address-suggestions-74244BAJ.js"),
@@ -35,7 +35,7 @@ var globImport_docs = __glob({
   "./docs/ai-agents.json": () => import("./ai-agents-MY4QE4CP.js"),
   "./docs/app.json": () => import("./app-B3TAEVS4.js"),
   "./docs/audit-logs.json": () => import("./audit-logs-5VXHOQ7S.js"),
-  "./docs/automation.json": () => import("./automation-HJGT6QK5.js"),
+  "./docs/automation.json": () => import("./automation-XFMSH7Y3.js"),
   "./docs/billing.json": () => import("./billing-UJ6I7FPG.js"),
   "./docs/blueprint-manifest.json": () => import("./blueprint-manifest-YU2UZLHV.js"),
   "./docs/calendar.json": () => import("./calendar-2H4RGMV3.js"),
@@ -113,7 +113,7 @@ var globImport_definitions_json = __glob({
   "./definitions/app.json": () => import("./app-VJW2KKWE.js"),
   "./definitions/audit-logs-runtime.json": () => import("./audit-logs-runtime-76R6WRAB.js"),
   "./definitions/audit-logs.json": () => import("./audit-logs-F2NHDISQ.js"),
-  "./definitions/automation-runtime.json": () => import("./automation-runtime-ORW5BVCD.js"),
+  "./definitions/automation-runtime.json": () => import("./automation-runtime-Y52HM57N.js"),
   "./definitions/automation.json": () => import("./automation-WEVRW77F.js"),
   "./definitions/billing-runtime.json": () => import("./billing-runtime-OSGDEA63.js"),
   "./definitions/billing.json": () => import("./billing-ASWY7HC3.js"),

package/dist/chunk-QW3ROE6H.js

@@ -0,0 +1,14 @@
+import {
+  __commonJS
+} from "./chunk-YPSWSI3M.js";
+
+// src/definitions/automation-runtime.json
+var require_automation_runtime = __commonJS({
+  "src/definitions/automation-runtime.json"(exports, module) {
+    module.exports = { s: "https://automation.sls.epilot.io", o: [["searchFlows", "get", "/v1/automation/flows", [["schema", "q"], ["size", "q"], ["from", "q"], ["trigger_source_id", "q"], ["target_workflow", "q"], ["trigger_event_name", "q"], ["include_flows", "q"]]], ["createFlow", "post", "/v1/automation/flows", null, 1], ["batchGetFlows", "post", "/v1/automation/flows:batchGet", null, 1], ["getFlow", "get", "/v1/automation/flows/{flow_id}", [["flow_id", "p", true]]], ["putFlow", "put", "/v1/automation/flows/{flow_id}", [["flow_id", "p", true]], 1], ["deleteFlow", "delete", "/v1/automation/flows/{flow_id}", [["flow_id", "p", true]]], ["getExecutions", "get", "/v1/automation/executions", [["entity_id", "q"], ["size", "q"], ["from", "q"], ["include_flows", "q"]]], ["startExecution", "post", "/v1/automation/executions", null, 1], ["searchExecutions", "post", "/v1/automation/executions:search", null, 1], ["bulkTriggerExecutions", "post", "/v1/automation/executions/bulk-jobs", null, 1], ["getBulkJob", "get", "/v1/automation/executions/bulk-jobs/{job_id}", [["job_id", "p", true]]], ["patchBulkJob", "patch", "/v1/automation/executions/bulk-jobs/{job_id}", [["job_id", "p", true]], 1], ["getExecution", "get", "/v1/automation/executions/{execution_id}", [["execution_id", "p", true]]], ["cancelExecution", "delete", "/v1/automation/executions/{execution_id}", [["execution_id", "p", true]]], ["retriggerAction", "post", "/v1/automation/executions/{execution_id}/{action_id}/retrigger", [["execution_id", "p", true], ["action_id", "p", true]], 1], ["resumeExecutionWithToken", "post", "/v1/automation/public/executions:resume", null, 1], ["cancelSchedule", "delete", "/v1/automation/executions/{execution_id}/schedules/{schedule_id}", [["execution_id", "p", true], ["schedule_id", "p", true]]]], v: "3.0.3" };
+  }
+});
+
+export {
+  require_automation_runtime
+};

package/dist/chunk-WOUASZJW.cjs

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
+
+// src/definitions/automation-runtime.json
+var require_automation_runtime = _chunkNJK5F5TFcjs.__commonJS.call(void 0, {
+  "src/definitions/automation-runtime.json"(exports, module) {
+    module.exports = { s: "https://automation.sls.epilot.io", o: [["searchFlows", "get", "/v1/automation/flows", [["schema", "q"], ["size", "q"], ["from", "q"], ["trigger_source_id", "q"], ["target_workflow", "q"], ["trigger_event_name", "q"], ["include_flows", "q"]]], ["createFlow", "post", "/v1/automation/flows", null, 1], ["batchGetFlows", "post", "/v1/automation/flows:batchGet", null, 1], ["getFlow", "get", "/v1/automation/flows/{flow_id}", [["flow_id", "p", true]]], ["putFlow", "put", "/v1/automation/flows/{flow_id}", [["flow_id", "p", true]], 1], ["deleteFlow", "delete", "/v1/automation/flows/{flow_id}", [["flow_id", "p", true]]], ["getExecutions", "get", "/v1/automation/executions", [["entity_id", "q"], ["size", "q"], ["from", "q"], ["include_flows", "q"]]], ["startExecution", "post", "/v1/automation/executions", null, 1], ["searchExecutions", "post", "/v1/automation/executions:search", null, 1], ["bulkTriggerExecutions", "post", "/v1/automation/executions/bulk-jobs", null, 1], ["getBulkJob", "get", "/v1/automation/executions/bulk-jobs/{job_id}", [["job_id", "p", true]]], ["patchBulkJob", "patch", "/v1/automation/executions/bulk-jobs/{job_id}", [["job_id", "p", true]], 1], ["getExecution", "get", "/v1/automation/executions/{execution_id}", [["execution_id", "p", true]]], ["cancelExecution", "delete", "/v1/automation/executions/{execution_id}", [["execution_id", "p", true]]], ["retriggerAction", "post", "/v1/automation/executions/{execution_id}/{action_id}/retrigger", [["execution_id", "p", true], ["action_id", "p", true]], 1], ["resumeExecutionWithToken", "post", "/v1/automation/public/executions:resume", null, 1], ["cancelSchedule", "delete", "/v1/automation/executions/{execution_id}/schedules/{schedule_id}", [["execution_id", "p", true], ["schedule_id", "p", true]]]], v: "3.0.3" };
+  }
+});
+
+
+
+exports.require_automation_runtime = require_automation_runtime;

package/dist/{chunk-4GR5MDWN.cjs → chunk-YCTBOY3T.cjs}

@@ -27,7 +27,7 @@ var authorize = (client, token) => {
 
 // import("./docs/**/*") in src/help.ts
 var globImport_docs = _chunkNJK5F5TFcjs.__glob.call(void 0, {
-  "./docs/README.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./README-XCIDDEAE.cjs"))),
+  "./docs/README.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./README-I7JMAFA4.cjs"))),
   "./docs/_index.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./_index-655GNTWT.cjs"))),
   "./docs/access-token.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./access-token-CQMYWZIG.cjs"))),
   "./docs/address-suggestions.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./address-suggestions-IUQMYF27.cjs"))),
@@ -35,7 +35,7 @@ var globImport_docs = _chunkNJK5F5TFcjs.__glob.call(void 0, {
   "./docs/ai-agents.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./ai-agents-ME5VRKMY.cjs"))),
   "./docs/app.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./app-C5H6RLZ5.cjs"))),
   "./docs/audit-logs.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./audit-logs-D2LFUA2R.cjs"))),
-  "./docs/automation.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./automation-FTFGFHT7.cjs"))),
+  "./docs/automation.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./automation-CDMOEYVP.cjs"))),
   "./docs/billing.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./billing-CKCFSK6K.cjs"))),
   "./docs/blueprint-manifest.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./blueprint-manifest-SXG3M6B4.cjs"))),
   "./docs/calendar.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./calendar-UADWQX7G.cjs"))),
@@ -113,7 +113,7 @@ var globImport_definitions_json = _chunkNJK5F5TFcjs.__glob.call(void 0, {
   "./definitions/app.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./app-5VPBDFW2.cjs"))),
   "./definitions/audit-logs-runtime.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./audit-logs-runtime-4WMHPWNX.cjs"))),
   "./definitions/audit-logs.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./audit-logs-RFEMBILB.cjs"))),
-  "./definitions/automation-runtime.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./automation-runtime-RM5EOZH2.cjs"))),
+  "./definitions/automation-runtime.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./automation-runtime-KLCXZKEC.cjs"))),
   "./definitions/automation.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./automation-HZASSUCS.cjs"))),
   "./definitions/billing-runtime.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./billing-runtime-YZEHKRAZ.cjs"))),
   "./definitions/billing.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./billing-3VZPNG6M.cjs"))),

package/dist/index.cjs

@@ -153,7 +153,7 @@ var _chunkN2P6RELZcjs = require('./chunk-N2P6RELZ.cjs');
 var _chunkRUZRPIHWcjs = require('./chunk-RUZRPIHW.cjs');
 
 
-var _chunkADSWGLIVcjs = require('./chunk-ADSWGLIV.cjs');
+var _chunkWOUASZJWcjs = require('./chunk-WOUASZJW.cjs');
 
 
 
@@ -161,7 +161,7 @@ var _chunkADSWGLIVcjs = require('./chunk-ADSWGLIV.cjs');
 
 
 
-var _chunk4GR5MDWNcjs = require('./chunk-4GR5MDWN.cjs');
+var _chunkYCTBOY3Tcjs = require('./chunk-YCTBOY3T.cjs');
 
 
 var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
@@ -228,7 +228,7 @@ var resolveClient = (params) => {
   }
   if (!entry.instance) {
     const definition = entry.loader();
-    entry.instance = _chunk4GR5MDWNcjs.createApiClient.call(void 0, {
+    entry.instance = _chunkYCTBOY3Tcjs.createApiClient.call(void 0, {
       definition,
       token: state.token,
       headers: state.globalHeaders,
@@ -261,7 +261,7 @@ var resetAllClients = (registry) => {
 };
 
 // src/apis/_registry.ts
-var expandDef = (mod) => _chunk4GR5MDWNcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+var expandDef = (mod) => _chunkYCTBOY3Tcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
@@ -296,7 +296,7 @@ var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
     name: "automation",
-    loader: () => expandDef(_chunkADSWGLIVcjs.require_automation_runtime.call(void 0, ))
+    loader: () => expandDef(_chunkWOUASZJWcjs.require_automation_runtime.call(void 0, ))
   });
   registerApi({
     registry,
@@ -609,9 +609,9 @@ var createSDK = () => {
       const available = [...registry.keys()].join(", ");
       throw new Error(`Unknown API: "${name}". Available: ${available}`);
     }
-    return _chunk4GR5MDWNcjs.createApiHandle.call(void 0, {
+    return _chunkYCTBOY3Tcjs.createApiHandle.call(void 0, {
       resolveClient: () => resolveClient({ registry, name, state }),
-      createClient: () => _chunk4GR5MDWNcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
+      createClient: () => _chunkYCTBOY3Tcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
       apiName: name
     });
   };
@@ -659,9 +659,9 @@ var createSDK = () => {
           return interceptorUse;
         }
         case "help":
-          return (apiName) => _chunk4GR5MDWNcjs.help.call(void 0, apiName);
+          return (apiName) => _chunkYCTBOY3Tcjs.help.call(void 0, apiName);
         case "openapi":
-          return (apiName) => _chunk4GR5MDWNcjs.openapi.call(void 0, apiName);
+          return (apiName) => _chunkYCTBOY3Tcjs.openapi.call(void 0, apiName);
         case "then":
         case "catch":
         case "finally":
@@ -691,4 +691,4 @@ var epilot = createSDK();
 
 
 
-exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunk4GR5MDWNcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunk4GR5MDWNcjs.help; exports.openapi = _chunk4GR5MDWNcjs.openapi;
+exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkYCTBOY3Tcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkYCTBOY3Tcjs.help; exports.openapi = _chunkYCTBOY3Tcjs.openapi;

package/dist/index.d.cts

@@ -9,7 +9,7 @@ import { C as Client$2 } from './address-suggestions.d-_YwTOR-9.cjs';
 import { C as Client$3 } from './ai-agents.d-B3TkP4mo.cjs';
 import { C as Client$4 } from './app.d-CqXqNLxq.cjs';
 import { C as Client$5 } from './audit-logs.d-BRToFqeX.cjs';
-import { C as Client$6 } from './automation.d-Bp45eKlU.cjs';
+import { C as Client$6 } from './automation.d-2biAmiMc.cjs';
 import { C as Client$7 } from './billing.d-DA3sViEF.cjs';
 import { C as Client$8 } from './blueprint-manifest.d-B8YKYzSJ.cjs';
 import { C as Client$9 } from './calendar.d-mk-ltGpk.cjs';

package/dist/index.d.ts

@@ -9,7 +9,7 @@ import { C as Client$2 } from './address-suggestions.d-_YwTOR-9.js';
 import { C as Client$3 } from './ai-agents.d-B3TkP4mo.js';
 import { C as Client$4 } from './app.d-CqXqNLxq.js';
 import { C as Client$5 } from './audit-logs.d-BRToFqeX.js';
-import { C as Client$6 } from './automation.d-Bp45eKlU.js';
+import { C as Client$6 } from './automation.d-2biAmiMc.js';
 import { C as Client$7 } from './billing.d-DA3sViEF.js';
 import { C as Client$8 } from './blueprint-manifest.d-B8YKYzSJ.js';
 import { C as Client$9 } from './calendar.d-mk-ltGpk.js';

package/dist/index.js

@@ -153,7 +153,7 @@ import {
 } from "./chunk-RELUU5QZ.js";
 import {
   require_automation_runtime
-} from "./chunk-LCE7N4ZL.js";
+} from "./chunk-QW3ROE6H.js";
 import {
   authorize,
   createApiClient,
@@ -161,7 +161,7 @@ import {
   expand,
   help,
   openapi
-} from "./chunk-R6RAUX3Z.js";
+} from "./chunk-KZXOYL5D.js";
 import {
   __require
 } from "./chunk-YPSWSI3M.js";

package/docs/automation.md

@@ -146,6 +146,8 @@ const { data } = await automationClient.searchFlows(...)
 - [`TriggerEventEntityActivity`](#triggerevententityactivity)
 - [`TriggerEventMessaging`](#triggereventmessaging)
 - [`TriggerEventEntityOperation`](#triggerevententityoperation)
+- [`TriggerEventEventCatalog`](#triggereventeventcatalog)
+- [`TriggerEventPayloadRef`](#triggereventpayloadref)
 - [`ApiCallerContext`](#apicallercontext)
 - [`ExecutionStatus`](#executionstatus)
 - [`GetExecutionsResp`](#getexecutionsresp)
@@ -175,6 +177,7 @@ const { data } = await automationClient.searchFlows(...)
 - [`EntitySearchFilter`](#entitysearchfilter)
 - [`EntitySearchFilterValue`](#entitysearchfiltervalue)
 - [`EntityManualTrigger`](#entitymanualtrigger)
+- [`EventCatalogTrigger`](#eventcatalogtrigger)
 - [`TriggerCondition`](#triggercondition)
 - [`Comparison`](#comparison)
 - [`FilterConditionOnEvent`](#filterconditiononevent)
@@ -210,6 +213,7 @@ const { data } = await client.searchFlows({
   from: 1,
   trigger_source_id: 'example',
   target_workflow: 'example',
+  trigger_event_name: 'example',
   include_flows: true,
 })
 ```
@@ -506,6 +510,7 @@ const { data } = await client.startExecution(
       "id": "loop_contracts",
       "source_path": "submission.steps[0]['Contracts']",
       "source_type": "journey-multi-select",
+      "filter_tags": ["_hidden_ 2a4b1c3d-0000-4000-8000-000000000000 - Dokumente"],
       "length": 0
     }
   ],
@@ -879,6 +884,7 @@ const { data } = await client.getExecution({
       "id": "loop_contracts",
       "source_path": "submission.steps[0]['Contracts']",
       "source_type": "journey-multi-select",
+      "filter_tags": ["_hidden_ 2a4b1c3d-0000-4000-8000-000000000000 - Dokumente"],
       "length": 0
     }
   ],
@@ -1030,6 +1036,7 @@ const { data } = await client.cancelExecution({
       "id": "loop_contracts",
       "source_path": "submission.steps[0]['Contracts']",
       "source_type": "journey-multi-select",
+      "filter_tags": ["_hidden_ 2a4b1c3d-0000-4000-8000-000000000000 - Dokumente"],
       "length": 0
     }
   ],
@@ -1316,6 +1323,16 @@ type AutomationFlow = {
     configuration?: {
       journey_id?: { ... }
     }
+  } | {
+    id?: string // uuid
+    type: "event_catalog"
+    configuration: {
+      event_name: { ... }
+      event_version: { ... }
+      entity_node_id: { ... }
+      entity_schema: { ... }
+      ignore_automation_triggered?: { ... }
+    }
   }>
   trigger_conditions?: Array<{
     source: string
@@ -1336,16 +1353,6 @@ type AutomationFlow = {
     allow_failure?: boolean
     statements?: Array<{
       id?: { ... }
-      source?: { ... }
-      operation?: { ... }
-      values?: { ... }
-    }>
-  }>
-  schedules?: Array<{
-    id: string
-    scheduleApiId?: string
-    numberOfUnits?: number
-    timePeriod?: "minutes" | "hours" | "days" | "weeks" | "months"
   // ...
 }
 ```
@@ -1408,6 +1415,10 @@ type SearchAutomationsResp = {
       id?: { ... }
       type: { ... }
       configuration?: { ... }
+    } | {
+      id?: { ... }
+      type: { ... }
+      configuration: { ... }
     }>
     trigger_conditions?: Array<{
       source: { ... }
@@ -1436,6 +1447,7 @@ type SearchAutomationsResp = {
       id: { ... }
       source_path: { ... }
       source_type?: { ... }
+      filter_tags?: { ... }
       length?: { ... }
     }>
     actions: Array<{
@@ -1456,11 +1468,6 @@ type SearchAutomationsResp = {
     } | {
       type?: { ... }
       config?: { ... }
-    } | {
-      type?: { ... }
-      config?: { ... }
-    } | {
-      type?: { ... }
   // ...
 }
 ```
@@ -1536,6 +1543,16 @@ type AnyTrigger = {
   configuration?: {
     journey_id?: string // uuid
   }
+} | {
+  id?: string // uuid
+  type: "event_catalog"
+  configuration: {
+    event_name: string
+    event_version: string
+    entity_node_id: string
+    entity_schema: string
+    ignore_automation_triggered?: boolean
+  }
 }
 ```
 
@@ -1783,7 +1800,8 @@ A loop scope on an automation flow.
 type AutomationLoop = {
   id: string
   source_path: string
-  source_type?: "journey-multi-select" | "previous-action-outputs" | "entity-relation"
+  source_type?: "journey-multi-select" | "journey-file-upload" | "previous-action-outputs" | "entity-relation"
+  filter_tags?: string[]
   length?: number
 }
 ```
@@ -2598,6 +2616,9 @@ type AssignEntityConfig = {
     attribute?: string
     values?: string[]
   }
+  match_user_skills?: boolean
+  required_skill_categories?: string[]
+  skill_match_mode?: "require_all" | "prefer"
   fallback?: "leave_unassigned" | "assign_to_fallback"
   fallback_assignees?: Array<{
     type: "user" | "partner_user" | "partner_organization" | "group"
@@ -2651,6 +2672,9 @@ type AssignEntityActionConfig = {
       attribute?: { ... }
       values?: { ... }
     }
+    match_user_skills?: boolean
+    required_skill_categories?: string[]
+    skill_match_mode?: "require_all" | "prefer"
     fallback?: "leave_unassigned" | "assign_to_fallback"
     fallback_assignees?: Array<{
       type: { ... }
@@ -2712,6 +2736,9 @@ type AssignEntityAction = {
       attribute?: { ... }
       values?: { ... }
     }
+    match_user_skills?: boolean
+    required_skill_categories?: string[]
+    skill_match_mode?: "require_all" | "prefer"
     fallback?: "leave_unassigned" | "assign_to_fallback"
     fallback_assignees?: Array<{
       type: { ... }
@@ -3395,7 +3422,7 @@ type ConditionStatement = {
   source?: {
     id?: string
     origin?: "trigger" | "action"
-    originType?: "entity" | "workflow" | "journey_block"
+    originType?: "entity" | "workflow" | "journey_block" | "event"
     schema?: string
     attribute?: string
     attributeType?: "string" | "text" | "number" | "boolean" | "date" | "datetime" | "tags" | "country" | "email" | "phone" | "product" | "price" | "status" | "relation" | "multiselect" | "select" | "radio" | "relation_user" | "purpose" | "label" | "payment" | "relation_payment_method"
@@ -3717,6 +3744,42 @@ type TriggerEventEntityOperation = {
 }
 ```
 
+### `TriggerEventEventCatalog`
+
+Set on executions started by an Event Catalog event (see EventCatalogTrigger). The full event payload is not stored inline (it may be up to 256 KB) but by reference in `payload_ref`; automation workers hydrate it before every action.
+
+
+```ts
+type TriggerEventEventCatalog = {
+  type: "event_catalog"
+  org_id: string
+  entity_id: string
+  entity_node_id: string
+  event_id: string
+  event_name: string
+  event_version: string
+  published_version?: string
+  event_time?: string // date-time
+  trigger_source_type?: string
+  trigger_source?: string
+  payload_ref?: {
+    bucket: string
+    key: string
+  }
+}
+```
+
+### `TriggerEventPayloadRef`
+
+S3 reference to the stored trigger event payload (`_downgrades` stripped, downgraded to the pinned version)
+
+```ts
+type TriggerEventPayloadRef = {
+  bucket: string
+  key: string
+}
+```
+
 ### `ApiCallerContext`
 
 ```ts
@@ -4438,6 +4501,25 @@ type EntityManualTrigger = {
 }
 ```
 
+### `EventCatalogTrigger`
+
+Starts the flow when an Event Catalog event is published for the organization. The execution runs in the context of one entity from the event's entity graph (`entity_node_id`), and the event payload is available to conditions and actions as the `event` variable context.
+
+
+```ts
+type EventCatalogTrigger = {
+  id?: string // uuid
+  type: "event_catalog"
+  configuration: {
+    event_name: string
+    event_version: string
+    entity_node_id: string
+    entity_schema: string
+    ignore_automation_triggered?: boolean
+  }
+}
+```
+
 ### `TriggerCondition`
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.20.22",
+  "version": "2.20.23",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/README-NBWAQWQS.js

@@ -1,7 +0,0 @@
-import "./chunk-YPSWSI3M.js";
-
-// src/docs/README.json
-var README_default = "<h1 align=\"center\"><img alt=\"epilot\" src=\"https://raw.githubusercontent.com/epilot-dev/sdk-js/main/logo.png\" width=\"200\"><br>@epilot/sdk</h1>\n\n<p align=\"center\">\n  <a href=\"https://github.com/epilot-dev/sdk-js/actions?query=workflow%3ACI\"><img src=\"https://github.com/epilot-dev/sdk-js/workflows/CI/badge.svg\" alt=\"CI\"></a>\n  <a href=\"https://www.npmjs.com/package/@epilot/sdk\"><img src=\"https://img.shields.io/npm/v/@epilot/sdk.svg\" alt=\"npm version\"></a>\n  <a href=\"https://github.com/epilot-dev/sdk-js/blob/main/\"><img src=\"http://img.shields.io/:license-mit-blue.svg\" alt=\"License\"></a>\n</p>\n\n<p align=\"center\">JavaScript/TypeScript SDK for epilot APIs. Full types, tree-shakeable imports, and lazy-loaded OpenAPI specs.</p>\n\n## Install\n\n```bash\nnpm i @epilot/sdk axios openapi-client-axios\n```\n\n## Quick Start\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-bearer-token>')\n\nconst { data: entity } = await epilot.entity.createEntity(\n  { slug: 'contact' },\n  { first_name: 'John', last_name: 'Doe' },\n)\n\nconst { data: file } = await epilot.file.getFile({ id: 'file-123' })\n\nconst { data: executions } = await epilot.workflow.getExecutions()\n```\n\nAPI clients are built on [openapi-client-axios](https://openapistack.co/docs/openapi-client-axios/intro/), which generates fully typed operation methods on top of regular [axios](https://axios-http.com/docs/intro) instances. All standard axios features (interceptors, defaults, config) work as expected. Each operation is forwarded to a lazy singleton \u2014 the spec is loaded and the client initialized on first use, then cached.\n\nFull API documentation: [https://docs.epilot.io/api](https://docs.epilot.io/api)\n\n## API Reference\n\n<!-- api-reference-table -->\n| API | Import | Docs |\n| --- | ------ | ---- |\n| `epilot.accessToken` | `@epilot/sdk/access-token` | [docs](./docs/access-token.md) |\n| `epilot.address` | `@epilot/sdk/address` | [docs](./docs/address.md) |\n| `epilot.addressSuggestions` | `@epilot/sdk/address-suggestions` | [docs](./docs/address-suggestions.md) |\n| `epilot.aiAgents` | `@epilot/sdk/ai-agents` | [docs](./docs/ai-agents.md) |\n| `epilot.app` | `@epilot/sdk/app` | [docs](./docs/app.md) |\n| `epilot.auditLogs` | `@epilot/sdk/audit-logs` | [docs](./docs/audit-logs.md) |\n| `epilot.automation` | `@epilot/sdk/automation` | [docs](./docs/automation.md) |\n| `epilot.billing` | `@epilot/sdk/billing` | [docs](./docs/billing.md) |\n| `epilot.blueprintManifest` | `@epilot/sdk/blueprint-manifest` | [docs](./docs/blueprint-manifest.md) |\n| `epilot.calendar` | `@epilot/sdk/calendar` | [docs](./docs/calendar.md) |\n| `epilot.configurationHub` | `@epilot/sdk/configuration-hub` | [docs](./docs/configuration-hub.md) |\n| `epilot.consent` | `@epilot/sdk/consent` | [docs](./docs/consent.md) |\n| `epilot.customerPortal` | `@epilot/sdk/customer-portal` | [docs](./docs/customer-portal.md) |\n| `epilot.dashboard` | `@epilot/sdk/dashboard` | [docs](./docs/dashboard.md) |\n| `epilot.dataGovernance` | `@epilot/sdk/data-governance` | [docs](./docs/data-governance.md) |\n| `epilot.deduplication` | `@epilot/sdk/deduplication` | [docs](./docs/deduplication.md) |\n| `epilot.design` | `@epilot/sdk/design` | [docs](./docs/design.md) |\n| `epilot.document` | `@epilot/sdk/document` | [docs](./docs/document.md) |\n| `epilot.emailSettings` | `@epilot/sdk/email-settings` | [docs](./docs/email-settings.md) |\n| `epilot.emailTemplate` | `@epilot/sdk/email-template` | [docs](./docs/email-template.md) |\n| `epilot.entity` | `@epilot/sdk/entity` | [docs](./docs/entity.md) |\n| `epilot.entityMapping` | `@epilot/sdk/entity-mapping` | [docs](./docs/entity-mapping.md) |\n| `epilot.environments` | `@epilot/sdk/environments` | [docs](./docs/environments.md) |\n| `epilot.eventCatalog` | `@epilot/sdk/event-catalog` | [docs](./docs/event-catalog.md) |\n| `epilot.file` | `@epilot/sdk/file` | [docs](./docs/file.md) |\n| `epilot.iban` | `@epilot/sdk/iban` | [docs](./docs/iban.md) |\n| `epilot.integrationToolkit` | `@epilot/sdk/integration-toolkit` | [docs](./docs/integration-toolkit.md) |\n| `epilot.journey` | `@epilot/sdk/journey` | [docs](./docs/journey.md) |\n| `epilot.kanban` | `@epilot/sdk/kanban` | [docs](./docs/kanban.md) |\n| `epilot.message` | `@epilot/sdk/message` | [docs](./docs/message.md) |\n| `epilot.metering` | `@epilot/sdk/metering` | [docs](./docs/metering.md) |\n| `epilot.notes` | `@epilot/sdk/notes` | [docs](./docs/notes.md) |\n| `epilot.notification` | `@epilot/sdk/notification` | [docs](./docs/notification.md) |\n| `epilot.organization` | `@epilot/sdk/organization` | [docs](./docs/organization.md) |\n| `epilot.partnerDirectory` | `@epilot/sdk/partner-directory` | [docs](./docs/partner-directory.md) |\n| `epilot.permissions` | `@epilot/sdk/permissions` | [docs](./docs/permissions.md) |\n| `epilot.pricing` | `@epilot/sdk/pricing` | [docs](./docs/pricing.md) |\n| `epilot.pricingTier` | `@epilot/sdk/pricing-tier` | [docs](./docs/pricing-tier.md) |\n| `epilot.purpose` | `@epilot/sdk/purpose` | [docs](./docs/purpose.md) |\n| `epilot.query` | `@epilot/sdk/query` | [docs](./docs/query.md) |\n| `epilot.sandbox` | `@epilot/sdk/sandbox` | [docs](./docs/sandbox.md) |\n| `epilot.sharing` | `@epilot/sdk/sharing` | [docs](./docs/sharing.md) |\n| `epilot.snapshot` | `@epilot/sdk/snapshot` | [docs](./docs/snapshot.md) |\n| `epilot.submission` | `@epilot/sdk/submission` | [docs](./docs/submission.md) |\n| `epilot.targeting` | `@epilot/sdk/targeting` | [docs](./docs/targeting.md) |\n| `epilot.templateVariables` | `@epilot/sdk/template-variables` | [docs](./docs/template-variables.md) |\n| `epilot.user` | `@epilot/sdk/user` | [docs](./docs/user.md) |\n| `epilot.validationRules` | `@epilot/sdk/validation-rules` | [docs](./docs/validation-rules.md) |\n| `epilot.webhooks` | `@epilot/sdk/webhooks` | [docs](./docs/webhooks.md) |\n| `epilot.workflow` | `@epilot/sdk/workflow` | [docs](./docs/workflow.md) |\n| `epilot.workflowDefinition` | `@epilot/sdk/workflow-definition` | [docs](./docs/workflow-definition.md) |\n<!-- /api-reference-table -->\n\n## OpenAPI Spec\n\nRetrieve the full OpenAPI specification for any API at runtime. The spec is lazy-loaded on first call and cached.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Via API handle\nconst entitySpec = await epilot.entity.openapi()\nconsole.log(entitySpec.info.title) // \"Entity API\"\nconsole.log(entitySpec.paths)       // all paths with full schemas\n\n// Via top-level method\nconst spec = await epilot.openapi('entity')\n```\n\nFor tree-shakeable imports:\n\n```ts\nimport { openapi } from '@epilot/sdk/entity'\n\nconst spec = await openapi()\n```\n\n## Explicit Client Access\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\n\n// Get the cached singleton client\nconst entityClient = epilot.entity.getClient()\nconst { data } = await entityClient.getEntity({ slug: 'contact', id: '123' })\n\n// Create a fresh (non-singleton) client instance\nconst freshClient = epilot.entity.createClient()\nauthorize(freshClient, () => '<my-token>')\n```\n\n## Tree-Shakeable Imports\n\nImport only what you need. Other APIs never touch your bundle.\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\n\nconst { data } = await entityClient.getEntity({ slug: 'contact', id: '123' })\n\n// Or use the handle for direct operation forwarding\nimport { entity } from '@epilot/sdk/entity'\nconst { data } = await entity.getEntity({ slug: 'contact', id: '123' })\n```\n\n## Types\n\nEach API subpath re-exports all schema types generated from the OpenAPI spec. Import them directly:\n\n```ts\nimport type { Entity, EntitySchema, RelationAttribute } from '@epilot/sdk/entity'\nimport type { FileItem } from '@epilot/sdk/file'\nimport type { AutomationFlow } from '@epilot/sdk/automation'\n```\n\nThe `Client`, `OperationMethods`, and `PathsDictionary` types are also available for typing client instances:\n\n```ts\nimport type { Client } from '@epilot/sdk/entity'\n\nconst entityClient: Client = epilot.entity.getClient()\n```\n\n## Headers\n\n### Global Headers\n\nSet default headers applied to all clients. Useful for `x-epilot-org-id`, `x-epilot-user-id`, etc.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\nepilot.headers({\n  'x-epilot-org-id': 'org-123',\n  'x-epilot-user-id': 'user-456',\n})\n\nconst { data } = await epilot.entity.searchEntities(...)\n```\n\n### Standard Axios Headers\n\nUse standard axios `defaults.headers.common` on individual clients:\n\n```ts\nconst entityClient = epilot.entity.getClient()\nentityClient.defaults.headers.common['x-epilot-org-id'] = 'org-123'\n```\n\n## Auth Patterns\n\n`authorize()` accepts a string or a function. The function form is preferred \u2014 it is called on every request, so tokens stay fresh.\n\n```ts\nimport { authorize } from '@epilot/sdk'\nimport { getClient } from '@epilot/sdk/entity'\n\n// Per-client \u2014 function predicate (recommended)\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\n\n// Per-client \u2014 async function (e.g. OAuth / session)\nauthorize(entityClient, async () => {\n  return await getTokenFromSession()\n})\n\n// Per-client \u2014 static string (sets default header once)\nauthorize(entityClient, 'my-static-api-token')\n```\n\n```ts\n// Global \u2014 applies to all clients resolved from the SDK\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\nepilot.authorize(async () => await getTokenFromSession())\nepilot.authorize('my-static-api-token')\n```\n\n## Fresh Client Instance\n\n```ts\nimport { createClient, authorize } from '@epilot/sdk/entity'\n\nconst entityClient = createClient()\nauthorize(entityClient, () => '<my-token>')\nentityClient.defaults.headers.common['x-epilot-org-id'] = 'org-123'\n```\n\n## Multiple SDK Instances\n\n```ts\nimport { createSDK } from '@epilot/sdk'\n\nconst sdk1 = createSDK()\nsdk1.authorize(() => '<token-for-org-1>')\nsdk1.headers({ 'x-epilot-org-id': 'org-1' })\n\nconst sdk2 = createSDK()\nsdk2.authorize(() => '<token-for-org-2>')\nsdk2.headers({ 'x-epilot-org-id': 'org-2' })\n```\n\n\n## Interceptors\n\nUse axios interceptors for custom request/response processing. Since clients are axios instances, you can use `client.interceptors` directly:\n\n```ts\nentityClient.interceptors.response.use((response) => {\n  console.debug(`${response.config.method?.toUpperCase()} ${response.config.url}`, {\n    status: response.status,\n    data: response.data,\n  })\n  return response\n})\n```\n\nOr register global interceptors applied to all clients:\n\n```ts\nepilot.interceptors.request((config) => {\n  config.headers['x-correlation-id'] = generateTraceId()\n  return config\n})\n```\n\n## Auto-Retry (429 Too Many Requests)\n\nThe SDK automatically retries requests that receive a `429 Too Many Requests` response. It respects the `Retry-After` header (in seconds) to determine how long to wait before retrying.\n\nEnabled by default with up to 3 retries.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Customize retry behavior\nepilot.retry({ maxRetries: 5, defaultDelayMs: 2000 })\n\n// Disable retries\nepilot.retry({ maxRetries: 0 })\n```\n\n| Option | Default | Description |\n| --- | --- | --- |\n| `maxRetries` | `3` | Maximum number of retries. Set to `0` to disable. |\n| `defaultDelayMs` | `1000` | Fallback delay in ms when `Retry-After` header is missing. |\n\nFor individually imported clients (tree-shakeable imports), apply the interceptor manually:\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\nimport { applyRetryInterceptor } from '@epilot/sdk'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\napplyRetryInterceptor({ client: entityClient, config: { maxRetries: 3 } })\n```\n\n## Large Response Handling (413 Payload Too Large)\n\nepilot APIs use a [large response middleware](https://github.com/epilot-dev/aws-lambda-utility-middlewares) to work around the AWS Lambda 6MB response limit. When a response exceeds ~5.1MB, the API uploads the payload to S3 and returns a presigned URL instead.\n\nThe SDK handles this transparently \u2014 it sends the opt-in `Accept` header and automatically fetches the full payload from S3 when a large response URL is returned. Enabled by default.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Disable large response handling\nepilot.largeResponse({ enabled: false })\n```\n\nFor individually imported clients (tree-shakeable imports), apply the interceptor manually:\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\nimport { applyLargeResponseInterceptor } from '@epilot/sdk'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\napplyLargeResponseInterceptor({ client: entityClient, config: { enabled: true } })\n```\n\n## Overrides & Custom APIs\n\nOverride built-in API specs or register custom APIs via `.epilot/sdk-overrides.json`. This is useful for testing new versions of an API spec or getting the latest types without waiting for an SDK release.\n\n```json\n{\n  \"entity\": \"./specs/entity-openapi.json\",\n  \"myNewApi\": \"./specs/my-new-api-openapi.json\"\n}\n```\n\n```ts\n// Built-in API with overridden spec\nconst { data } = await epilot.entity.getEntity({ slug: 'contact', id: '123' })\n```\n\n### Override Commands\n\n```bash\n# Apply all overrides from .epilot/sdk-overrides.json\nnpx epilot-sdk override\n\n# Override a single API\nnpx epilot-sdk override entity ./my-local-entity-spec.yaml\n\n# Regenerate types after spec changes\nnpx epilot-sdk typegen\n```\n\n<details>\n<summary>Migration from <code>@epilot/*-client</code></summary>\n\nDrop-in replacement \u2014 just change the import path:\n\n```ts\n// Before\nimport { getClient, createClient, authorize } from '@epilot/entity-client'\nimport type { Client, Entity } from '@epilot/entity-client'\n\n// After\nimport { getClient, createClient, authorize } from '@epilot/sdk/entity'\nimport type { Client, Entity } from '@epilot/sdk/entity'\n```\n\n</details>\n\n<details>\n<summary>Client Lifecycle</summary>\n\nWhen you call `authorize()`, `headers()`, `retry()`, `largeResponse()`, or `interceptors`, the SDK invalidates all cached client instances. The next operation call creates a fresh client with the updated configuration.\n\n**Operation methods are always up to date** \u2014 calls like `epilot.entity.getEntity(...)` re-resolve the client on every invocation, so they always use the latest config.\n\n**Direct `getClient()` references can go stale** \u2014 if you hold a reference and then change config, your reference still points to the old client:\n\n```ts\nconst entityClient = epilot.entity.getClient()\n\nepilot.authorize('new-token') // invalidates all cached clients\n\n// entityClient still has the old token\n// epilot.entity.getEntity(...) will use a new client with the new token\n```\n\nIf you need a long-lived reference that survives config changes, call `getClient()` again after changing config, or use operation methods directly.\n\n</details>\n";
-export {
-  README_default as default
-};

package/dist/README-XCIDDEAE.cjs

@@ -1,7 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
-
-// src/docs/README.json
-var README_default = "<h1 align=\"center\"><img alt=\"epilot\" src=\"https://raw.githubusercontent.com/epilot-dev/sdk-js/main/logo.png\" width=\"200\"><br>@epilot/sdk</h1>\n\n<p align=\"center\">\n  <a href=\"https://github.com/epilot-dev/sdk-js/actions?query=workflow%3ACI\"><img src=\"https://github.com/epilot-dev/sdk-js/workflows/CI/badge.svg\" alt=\"CI\"></a>\n  <a href=\"https://www.npmjs.com/package/@epilot/sdk\"><img src=\"https://img.shields.io/npm/v/@epilot/sdk.svg\" alt=\"npm version\"></a>\n  <a href=\"https://github.com/epilot-dev/sdk-js/blob/main/\"><img src=\"http://img.shields.io/:license-mit-blue.svg\" alt=\"License\"></a>\n</p>\n\n<p align=\"center\">JavaScript/TypeScript SDK for epilot APIs. Full types, tree-shakeable imports, and lazy-loaded OpenAPI specs.</p>\n\n## Install\n\n```bash\nnpm i @epilot/sdk axios openapi-client-axios\n```\n\n## Quick Start\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-bearer-token>')\n\nconst { data: entity } = await epilot.entity.createEntity(\n  { slug: 'contact' },\n  { first_name: 'John', last_name: 'Doe' },\n)\n\nconst { data: file } = await epilot.file.getFile({ id: 'file-123' })\n\nconst { data: executions } = await epilot.workflow.getExecutions()\n```\n\nAPI clients are built on [openapi-client-axios](https://openapistack.co/docs/openapi-client-axios/intro/), which generates fully typed operation methods on top of regular [axios](https://axios-http.com/docs/intro) instances. All standard axios features (interceptors, defaults, config) work as expected. Each operation is forwarded to a lazy singleton \u2014 the spec is loaded and the client initialized on first use, then cached.\n\nFull API documentation: [https://docs.epilot.io/api](https://docs.epilot.io/api)\n\n## API Reference\n\n<!-- api-reference-table -->\n| API | Import | Docs |\n| --- | ------ | ---- |\n| `epilot.accessToken` | `@epilot/sdk/access-token` | [docs](./docs/access-token.md) |\n| `epilot.address` | `@epilot/sdk/address` | [docs](./docs/address.md) |\n| `epilot.addressSuggestions` | `@epilot/sdk/address-suggestions` | [docs](./docs/address-suggestions.md) |\n| `epilot.aiAgents` | `@epilot/sdk/ai-agents` | [docs](./docs/ai-agents.md) |\n| `epilot.app` | `@epilot/sdk/app` | [docs](./docs/app.md) |\n| `epilot.auditLogs` | `@epilot/sdk/audit-logs` | [docs](./docs/audit-logs.md) |\n| `epilot.automation` | `@epilot/sdk/automation` | [docs](./docs/automation.md) |\n| `epilot.billing` | `@epilot/sdk/billing` | [docs](./docs/billing.md) |\n| `epilot.blueprintManifest` | `@epilot/sdk/blueprint-manifest` | [docs](./docs/blueprint-manifest.md) |\n| `epilot.calendar` | `@epilot/sdk/calendar` | [docs](./docs/calendar.md) |\n| `epilot.configurationHub` | `@epilot/sdk/configuration-hub` | [docs](./docs/configuration-hub.md) |\n| `epilot.consent` | `@epilot/sdk/consent` | [docs](./docs/consent.md) |\n| `epilot.customerPortal` | `@epilot/sdk/customer-portal` | [docs](./docs/customer-portal.md) |\n| `epilot.dashboard` | `@epilot/sdk/dashboard` | [docs](./docs/dashboard.md) |\n| `epilot.dataGovernance` | `@epilot/sdk/data-governance` | [docs](./docs/data-governance.md) |\n| `epilot.deduplication` | `@epilot/sdk/deduplication` | [docs](./docs/deduplication.md) |\n| `epilot.design` | `@epilot/sdk/design` | [docs](./docs/design.md) |\n| `epilot.document` | `@epilot/sdk/document` | [docs](./docs/document.md) |\n| `epilot.emailSettings` | `@epilot/sdk/email-settings` | [docs](./docs/email-settings.md) |\n| `epilot.emailTemplate` | `@epilot/sdk/email-template` | [docs](./docs/email-template.md) |\n| `epilot.entity` | `@epilot/sdk/entity` | [docs](./docs/entity.md) |\n| `epilot.entityMapping` | `@epilot/sdk/entity-mapping` | [docs](./docs/entity-mapping.md) |\n| `epilot.environments` | `@epilot/sdk/environments` | [docs](./docs/environments.md) |\n| `epilot.eventCatalog` | `@epilot/sdk/event-catalog` | [docs](./docs/event-catalog.md) |\n| `epilot.file` | `@epilot/sdk/file` | [docs](./docs/file.md) |\n| `epilot.iban` | `@epilot/sdk/iban` | [docs](./docs/iban.md) |\n| `epilot.integrationToolkit` | `@epilot/sdk/integration-toolkit` | [docs](./docs/integration-toolkit.md) |\n| `epilot.journey` | `@epilot/sdk/journey` | [docs](./docs/journey.md) |\n| `epilot.kanban` | `@epilot/sdk/kanban` | [docs](./docs/kanban.md) |\n| `epilot.message` | `@epilot/sdk/message` | [docs](./docs/message.md) |\n| `epilot.metering` | `@epilot/sdk/metering` | [docs](./docs/metering.md) |\n| `epilot.notes` | `@epilot/sdk/notes` | [docs](./docs/notes.md) |\n| `epilot.notification` | `@epilot/sdk/notification` | [docs](./docs/notification.md) |\n| `epilot.organization` | `@epilot/sdk/organization` | [docs](./docs/organization.md) |\n| `epilot.partnerDirectory` | `@epilot/sdk/partner-directory` | [docs](./docs/partner-directory.md) |\n| `epilot.permissions` | `@epilot/sdk/permissions` | [docs](./docs/permissions.md) |\n| `epilot.pricing` | `@epilot/sdk/pricing` | [docs](./docs/pricing.md) |\n| `epilot.pricingTier` | `@epilot/sdk/pricing-tier` | [docs](./docs/pricing-tier.md) |\n| `epilot.purpose` | `@epilot/sdk/purpose` | [docs](./docs/purpose.md) |\n| `epilot.query` | `@epilot/sdk/query` | [docs](./docs/query.md) |\n| `epilot.sandbox` | `@epilot/sdk/sandbox` | [docs](./docs/sandbox.md) |\n| `epilot.sharing` | `@epilot/sdk/sharing` | [docs](./docs/sharing.md) |\n| `epilot.snapshot` | `@epilot/sdk/snapshot` | [docs](./docs/snapshot.md) |\n| `epilot.submission` | `@epilot/sdk/submission` | [docs](./docs/submission.md) |\n| `epilot.targeting` | `@epilot/sdk/targeting` | [docs](./docs/targeting.md) |\n| `epilot.templateVariables` | `@epilot/sdk/template-variables` | [docs](./docs/template-variables.md) |\n| `epilot.user` | `@epilot/sdk/user` | [docs](./docs/user.md) |\n| `epilot.validationRules` | `@epilot/sdk/validation-rules` | [docs](./docs/validation-rules.md) |\n| `epilot.webhooks` | `@epilot/sdk/webhooks` | [docs](./docs/webhooks.md) |\n| `epilot.workflow` | `@epilot/sdk/workflow` | [docs](./docs/workflow.md) |\n| `epilot.workflowDefinition` | `@epilot/sdk/workflow-definition` | [docs](./docs/workflow-definition.md) |\n<!-- /api-reference-table -->\n\n## OpenAPI Spec\n\nRetrieve the full OpenAPI specification for any API at runtime. The spec is lazy-loaded on first call and cached.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Via API handle\nconst entitySpec = await epilot.entity.openapi()\nconsole.log(entitySpec.info.title) // \"Entity API\"\nconsole.log(entitySpec.paths)       // all paths with full schemas\n\n// Via top-level method\nconst spec = await epilot.openapi('entity')\n```\n\nFor tree-shakeable imports:\n\n```ts\nimport { openapi } from '@epilot/sdk/entity'\n\nconst spec = await openapi()\n```\n\n## Explicit Client Access\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\n\n// Get the cached singleton client\nconst entityClient = epilot.entity.getClient()\nconst { data } = await entityClient.getEntity({ slug: 'contact', id: '123' })\n\n// Create a fresh (non-singleton) client instance\nconst freshClient = epilot.entity.createClient()\nauthorize(freshClient, () => '<my-token>')\n```\n\n## Tree-Shakeable Imports\n\nImport only what you need. Other APIs never touch your bundle.\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\n\nconst { data } = await entityClient.getEntity({ slug: 'contact', id: '123' })\n\n// Or use the handle for direct operation forwarding\nimport { entity } from '@epilot/sdk/entity'\nconst { data } = await entity.getEntity({ slug: 'contact', id: '123' })\n```\n\n## Types\n\nEach API subpath re-exports all schema types generated from the OpenAPI spec. Import them directly:\n\n```ts\nimport type { Entity, EntitySchema, RelationAttribute } from '@epilot/sdk/entity'\nimport type { FileItem } from '@epilot/sdk/file'\nimport type { AutomationFlow } from '@epilot/sdk/automation'\n```\n\nThe `Client`, `OperationMethods`, and `PathsDictionary` types are also available for typing client instances:\n\n```ts\nimport type { Client } from '@epilot/sdk/entity'\n\nconst entityClient: Client = epilot.entity.getClient()\n```\n\n## Headers\n\n### Global Headers\n\nSet default headers applied to all clients. Useful for `x-epilot-org-id`, `x-epilot-user-id`, etc.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\nepilot.headers({\n  'x-epilot-org-id': 'org-123',\n  'x-epilot-user-id': 'user-456',\n})\n\nconst { data } = await epilot.entity.searchEntities(...)\n```\n\n### Standard Axios Headers\n\nUse standard axios `defaults.headers.common` on individual clients:\n\n```ts\nconst entityClient = epilot.entity.getClient()\nentityClient.defaults.headers.common['x-epilot-org-id'] = 'org-123'\n```\n\n## Auth Patterns\n\n`authorize()` accepts a string or a function. The function form is preferred \u2014 it is called on every request, so tokens stay fresh.\n\n```ts\nimport { authorize } from '@epilot/sdk'\nimport { getClient } from '@epilot/sdk/entity'\n\n// Per-client \u2014 function predicate (recommended)\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\n\n// Per-client \u2014 async function (e.g. OAuth / session)\nauthorize(entityClient, async () => {\n  return await getTokenFromSession()\n})\n\n// Per-client \u2014 static string (sets default header once)\nauthorize(entityClient, 'my-static-api-token')\n```\n\n```ts\n// Global \u2014 applies to all clients resolved from the SDK\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\nepilot.authorize(async () => await getTokenFromSession())\nepilot.authorize('my-static-api-token')\n```\n\n## Fresh Client Instance\n\n```ts\nimport { createClient, authorize } from '@epilot/sdk/entity'\n\nconst entityClient = createClient()\nauthorize(entityClient, () => '<my-token>')\nentityClient.defaults.headers.common['x-epilot-org-id'] = 'org-123'\n```\n\n## Multiple SDK Instances\n\n```ts\nimport { createSDK } from '@epilot/sdk'\n\nconst sdk1 = createSDK()\nsdk1.authorize(() => '<token-for-org-1>')\nsdk1.headers({ 'x-epilot-org-id': 'org-1' })\n\nconst sdk2 = createSDK()\nsdk2.authorize(() => '<token-for-org-2>')\nsdk2.headers({ 'x-epilot-org-id': 'org-2' })\n```\n\n\n## Interceptors\n\nUse axios interceptors for custom request/response processing. Since clients are axios instances, you can use `client.interceptors` directly:\n\n```ts\nentityClient.interceptors.response.use((response) => {\n  console.debug(`${response.config.method?.toUpperCase()} ${response.config.url}`, {\n    status: response.status,\n    data: response.data,\n  })\n  return response\n})\n```\n\nOr register global interceptors applied to all clients:\n\n```ts\nepilot.interceptors.request((config) => {\n  config.headers['x-correlation-id'] = generateTraceId()\n  return config\n})\n```\n\n## Auto-Retry (429 Too Many Requests)\n\nThe SDK automatically retries requests that receive a `429 Too Many Requests` response. It respects the `Retry-After` header (in seconds) to determine how long to wait before retrying.\n\nEnabled by default with up to 3 retries.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Customize retry behavior\nepilot.retry({ maxRetries: 5, defaultDelayMs: 2000 })\n\n// Disable retries\nepilot.retry({ maxRetries: 0 })\n```\n\n| Option | Default | Description |\n| --- | --- | --- |\n| `maxRetries` | `3` | Maximum number of retries. Set to `0` to disable. |\n| `defaultDelayMs` | `1000` | Fallback delay in ms when `Retry-After` header is missing. |\n\nFor individually imported clients (tree-shakeable imports), apply the interceptor manually:\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\nimport { applyRetryInterceptor } from '@epilot/sdk'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\napplyRetryInterceptor({ client: entityClient, config: { maxRetries: 3 } })\n```\n\n## Large Response Handling (413 Payload Too Large)\n\nepilot APIs use a [large response middleware](https://github.com/epilot-dev/aws-lambda-utility-middlewares) to work around the AWS Lambda 6MB response limit. When a response exceeds ~5.1MB, the API uploads the payload to S3 and returns a presigned URL instead.\n\nThe SDK handles this transparently \u2014 it sends the opt-in `Accept` header and automatically fetches the full payload from S3 when a large response URL is returned. Enabled by default.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Disable large response handling\nepilot.largeResponse({ enabled: false })\n```\n\nFor individually imported clients (tree-shakeable imports), apply the interceptor manually:\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\nimport { applyLargeResponseInterceptor } from '@epilot/sdk'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\napplyLargeResponseInterceptor({ client: entityClient, config: { enabled: true } })\n```\n\n## Overrides & Custom APIs\n\nOverride built-in API specs or register custom APIs via `.epilot/sdk-overrides.json`. This is useful for testing new versions of an API spec or getting the latest types without waiting for an SDK release.\n\n```json\n{\n  \"entity\": \"./specs/entity-openapi.json\",\n  \"myNewApi\": \"./specs/my-new-api-openapi.json\"\n}\n```\n\n```ts\n// Built-in API with overridden spec\nconst { data } = await epilot.entity.getEntity({ slug: 'contact', id: '123' })\n```\n\n### Override Commands\n\n```bash\n# Apply all overrides from .epilot/sdk-overrides.json\nnpx epilot-sdk override\n\n# Override a single API\nnpx epilot-sdk override entity ./my-local-entity-spec.yaml\n\n# Regenerate types after spec changes\nnpx epilot-sdk typegen\n```\n\n<details>\n<summary>Migration from <code>@epilot/*-client</code></summary>\n\nDrop-in replacement \u2014 just change the import path:\n\n```ts\n// Before\nimport { getClient, createClient, authorize } from '@epilot/entity-client'\nimport type { Client, Entity } from '@epilot/entity-client'\n\n// After\nimport { getClient, createClient, authorize } from '@epilot/sdk/entity'\nimport type { Client, Entity } from '@epilot/sdk/entity'\n```\n\n</details>\n\n<details>\n<summary>Client Lifecycle</summary>\n\nWhen you call `authorize()`, `headers()`, `retry()`, `largeResponse()`, or `interceptors`, the SDK invalidates all cached client instances. The next operation call creates a fresh client with the updated configuration.\n\n**Operation methods are always up to date** \u2014 calls like `epilot.entity.getEntity(...)` re-resolve the client on every invocation, so they always use the latest config.\n\n**Direct `getClient()` references can go stale** \u2014 if you hold a reference and then change config, your reference still points to the old client:\n\n```ts\nconst entityClient = epilot.entity.getClient()\n\nepilot.authorize('new-token') // invalidates all cached clients\n\n// entityClient still has the old token\n// epilot.entity.getEntity(...) will use a new client with the new token\n```\n\nIf you need a long-lived reference that survives config changes, call `getClient()` again after changing config, or use operation methods directly.\n\n</details>\n";
-
-
-exports.default = README_default;