@epilot/sdk 2.15.13 → 2.15.15

package/docs/automation.md

@@ -35,6 +35,7 @@ const { data } = await automationClient.searchFlows(...)
 **executions**
 - [`getExecutions`](#getexecutions)
 - [`startExecution`](#startexecution)
+- [`searchExecutions`](#searchexecutions)
 - [`getExecution`](#getexecution)
 - [`cancelExecution`](#cancelexecution)
 - [`retriggerAction`](#retriggeraction)
@@ -137,6 +138,8 @@ const { data } = await automationClient.searchFlows(...)
 - [`ApiCallerContext`](#apicallercontext)
 - [`ExecutionStatus`](#executionstatus)
 - [`GetExecutionsResp`](#getexecutionsresp)
+- [`SearchExecutionsReq`](#searchexecutionsreq)
+- [`SearchExecutionsResp`](#searchexecutionsresp)
 - [`StartExecutionRequest`](#startexecutionrequest)
 - [`PatchBulkJobRequest`](#patchbulkjobrequest)
 - [`BulkTriggerRequest`](#bulktriggerrequest)
@@ -494,6 +497,67 @@ const { data } = await client.startExecution(
 
 ---
 
+### `searchExecutions`
+
+Search automation executions of an entity with cursor-based pagination.
+Returns pages of up to 100 executions, newest first.
+Prefer this over GET /v1/automation/executions, which returns the full
+exec
+
+`POST /v1/automation/executions:search`
+
+```ts
+const { data } = await client.searchExecutions(
+  null,
+  {
+    entity_id: 'e3d3ebac-baab-4395-abf4-50b5bf1f8b74',
+    include_flows: false,
+    size: 25,
+    cursor: 'string'
+  },
+)
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "total": 0,
+  "results": [
+    {
+      "id": "9baf184f-bc81-4128-bca3-d974c90a12c4",
+      "execution_status": "pending",
+      "entity_id": "e3d3ebac-baab-4395-abf4-50b5bf1f8b74",
+      "activity_id": "e3d3ebac-baab-4395-abf4-50b5bf1f8b74",
+      "entity_snapshot": {},
+      "org_id": "e3d3ebac-baab-4395-abf4-50b5bf1f8b74",
+      "flow_id": "7791b04a-16d2-44a2-9af9-2d59c25c512f",
+      "flow_name": "Handle contact form",
+      "created_at": "1970-01-01T00:00:00.000Z",
+      "updated_at": "1970-01-01T00:00:00.000Z",
+      "current_action_id": "9ec3711b-db63-449c-b894-54d5bb622a8f",
+      "conditions": [],
+      "schedules": [],
+      "actions": [],
+      "resume_token": "eyJraWQiOiJrZXkifQ==",
+      "trigger_context": {},
+      "version": 2,
+      "trigger_event": {},
+      "workflow_context": {},
+      "loops": [],
+      "loop_state": {},
+      "chain": ["string"]
+    }
+  ],
+  "next_cursor": "string"
+}
+```
+
+</details>
+
+---
+
 ### `bulkTriggerExecutions`
 
 Create a bulk job that triggers multiple automation executions
@@ -2284,6 +2348,13 @@ type AssignThreadAction = {
   config?: {
     remove?: string[]
     add?: string[]
+    assignment_type?: "direct" | "even_distribution" | "sequential"
+    only_available_users?: boolean
+    match_user_skills?: boolean
+    required_skill_categories?: string[]
+    skill_match_mode?: "require_all" | "prefer"
+    fallback?: "leave_unassigned" | "assign_to_fallback"
+    fallback_assignees?: string[]
   }
 }
 ```
@@ -2302,6 +2373,13 @@ type MoveThreadConfig = {
 type AssignThreadConfig = {
   remove?: string[]
   add?: string[]
+  assignment_type?: "direct" | "even_distribution" | "sequential"
+  only_available_users?: boolean
+  match_user_skills?: boolean
+  required_skill_categories?: string[]
+  skill_match_mode?: "require_all" | "prefer"
+  fallback?: "leave_unassigned" | "assign_to_fallback"
+  fallback_assignees?: string[]
 }
 ```
 
@@ -3402,6 +3480,124 @@ type GetExecutionsResp = {
 }
 ```
 
+### `SearchExecutionsReq`
+
+```ts
+type SearchExecutionsReq = {
+  entity_id: string
+  include_flows?: boolean
+  size?: number
+  cursor?: string
+}
+```
+
+### `SearchExecutionsResp`
+
+```ts
+type SearchExecutionsResp = {
+  total: number
+  results: Array<{
+    id: string
+    execution_status?: "pending" | "starting" | "in_progress" | "paused" | "success" | "failed" | "cancelled" | "skipped" | "scheduled" | "hot"
+    entity_id: string
+    activity_id?: string
+    entity_snapshot?: {
+      _id: { ... }
+      _title: { ... }
+      _org: { ... }
+      _schema: { ... }
+      _tags?: { ... }
+      _created_at: { ... }
+      _updated_at: { ... }
+    }
+    org_id: string
+    flow_id: string
+    flow_name?: string
+    created_at?: string // date-time
+    updated_at?: string // date-time
+    current_action_id?: string
+    conditions?: Array<{
+      id?: { ... }
+      schedule_id?: { ... }
+      evaluation_order?: { ... }
+      evaluationResult?: { ... }
+      error_output?: { ... }
+      allow_failure?: { ... }
+      statements?: { ... }
+    }>
+    schedules?: Array<{
+      id: { ... }
+      scheduleApiId?: { ... }
+      numberOfUnits?: { ... }
+      timePeriod?: { ... }
+      timeRelation?: { ... }
+      source: { ... }
+    }>
+    actions: Array<{
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      id?: { ... }
+      flow_action_id?: { ... }
+      name?: { ... }
+      type?: { ... }
+      config?: { ... }
+      allow_failure?: { ... }
+      created_automatically?: { ... }
+      is_bulk_action?: { ... }
+      reason?: { ... }
+      condition_id?: { ... }
+      schedule_id?: { ... }
+      loop_id?: { ... }
+      execution_status?: { ... }
+      started_at?: { ... }
+      updated_at?: { ... }
+      outputs?: { ... }
+      error_output?: { ... }
+      retry_strategy?: { ... }
+      iterations?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    } | {
+      type?: { ... }
+      config?: { ... }
+    }>
+    resume_token?: string
+  // ...
+}
+```
+
 ### `StartExecutionRequest`
 
 ```ts

package/docs/integration-toolkit.md

@@ -88,7 +88,22 @@ const { data } = await integrationToolkitClient.acknowledgeTracking(...)
 **managed-call**
 - [`managedCallExecute`](#managedcallexecute)
 
+**erp-imports**
+- [`createErpImport`](#createerpimport)
+- [`listErpImports`](#listerpimports)
+- [`getErpImport`](#geterpimport)
+- [`executeErpImport`](#executeerpimport)
+- [`abortErpImport`](#aborterpimport)
+
 **Schemas**
+- [`S3Reference`](#s3reference)
+- [`CreateErpImportRequest`](#createerpimportrequest)
+- [`ErpImportValidation`](#erpimportvalidation)
+- [`ErpImportProgress`](#erpimportprogress)
+- [`ErpImportError`](#erpimporterror)
+- [`CreateErpImportResponse`](#createerpimportresponse)
+- [`ErpImportJob`](#erpimportjob)
+- [`ErpImportList`](#erpimportlist)
 - [`NotificationHistoryItem`](#notificationhistoryitem)
 - [`NotificationHistoryResponse`](#notificationhistoryresponse)
 - [`TestNotificationRequest`](#testnotificationrequest)
@@ -953,6 +968,15 @@ const { data } = await client.replayEvents(
 
 ```json
 {
+  "replayed": 2,
+  "results": [
+    {
+      "event_id": "string",
+      "status": "success",
+      "replay_event_id": "string",
+      "message": "string"
+    }
+  ],
   "event_ids": ["string"]
 }
 ```
@@ -3075,8 +3099,351 @@ const { data } = await client.commitTypes(
 
 ---
 
+### `createErpImport`
+
+Create a pricing-file import job from an already-uploaded file (S3 ref). Returns a job id and starts the validate phase asynchronously — poll GET /v2/erp/imports/{importId}.
+
+`POST /v2/erp/imports`
+
+```ts
+const { data } = await client.createErpImport(
+  null,
+  {
+    s3_reference: {
+      bucket: 'string',
+      key: 'string'
+    },
+    integration_id: 'string',
+    use_case_slug: 'string'
+  },
+)
+```
+
+---
+
+### `listErpImports`
+
+List recent pricing-file import jobs for the org, newest first.
+
+`GET /v2/erp/imports`
+
+```ts
+const { data } = await client.listErpImports({
+  limit: 1,
+  cursor: 'example',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "results": [
+    {
+      "import_id": "string",
+      "org_id": "string",
+      "created_by": "string",
+      "integration_id": "string",
+      "use_case_slug": "string",
+      "format": "csv",
+      "status": "PENDING",
+      "s3_input_ref": {
+        "bucket": "string",
+        "key": "string"
+      },
+      "validation": {
+        "total_rows": 0,
+        "blocking": 0,
+        "warnings": 0,
+        "entities": {}
+      },
+      "progress": {
+        "processed_rows": 0,
+        "total_rows": 0
+      },
+      "error": {
+        "type": "VALIDATION_BLOCKED",
+        "message": "string"
+      },
+      "correlation_id": "string",
+      "activity_id": "string",
+      "created_at": "1970-01-01T00:00:00.000Z",
+      "updated_at": "1970-01-01T00:00:00.000Z"
+    }
+  ],
+  "next_cursor": "string"
+}
+```
+
+</details>
+
+---
+
+### `getErpImport`
+
+Get a pricing-file import job (status, counts, result links).
+
+`GET /v2/erp/imports/{importId}`
+
+```ts
+const { data } = await client.getErpImport({
+  importId: 'example',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "import_id": "string",
+  "org_id": "string",
+  "created_by": "string",
+  "integration_id": "string",
+  "use_case_slug": "string",
+  "format": "csv",
+  "status": "PENDING",
+  "s3_input_ref": {
+    "bucket": "string",
+    "key": "string"
+  },
+  "validation": {
+    "total_rows": 0,
+    "blocking": 0,
+    "warnings": 0,
+    "entities": {}
+  },
+  "progress": {
+    "processed_rows": 0,
+    "total_rows": 0
+  },
+  "error": {
+    "type": "VALIDATION_BLOCKED",
+    "message": "string"
+  },
+  "correlation_id": "string",
+  "activity_id": "string",
+  "created_at": "1970-01-01T00:00:00.000Z",
+  "updated_at": "1970-01-01T00:00:00.000Z"
+}
+```
+
+</details>
+
+---
+
+### `executeErpImport`
+
+Confirm and run the write phase of a validated import. Only a READY job may be executed; any other status returns 409.
+
+`POST /v2/erp/imports/{importId}:execute`
+
+```ts
+const { data } = await client.executeErpImport({
+  importId: 'example',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "import_id": "string",
+  "org_id": "string",
+  "created_by": "string",
+  "integration_id": "string",
+  "use_case_slug": "string",
+  "format": "csv",
+  "status": "PENDING",
+  "s3_input_ref": {
+    "bucket": "string",
+    "key": "string"
+  },
+  "validation": {
+    "total_rows": 0,
+    "blocking": 0,
+    "warnings": 0,
+    "entities": {}
+  },
+  "progress": {
+    "processed_rows": 0,
+    "total_rows": 0
+  },
+  "error": {
+    "type": "VALIDATION_BLOCKED",
+    "message": "string"
+  },
+  "correlation_id": "string",
+  "activity_id": "string",
+  "created_at": "1970-01-01T00:00:00.000Z",
+  "updated_at": "1970-01-01T00:00:00.000Z"
+}
+```
+
+</details>
+
+---
+
+### `abortErpImport`
+
+Ask a running import to stop. Valid while the job is VALIDATING or PROCESSING; any other status returns 409.
+The stop is cooperative: the job passes through CANCELLING and typically reaches CANCELLED 
+
+`POST /v2/erp/imports/{importId}:abort`
+
+```ts
+const { data } = await client.abortErpImport({
+  importId: 'example',
+})
+```
+
+---
+
 ## Schemas
 
+### `S3Reference`
+
+```ts
+type S3Reference = {
+  bucket: string
+  key: string
+}
+```
+
+### `CreateErpImportRequest`
+
+```ts
+type CreateErpImportRequest = {
+  s3_reference: {
+    bucket: string
+    key: string
+  }
+  integration_id: string
+  use_case_slug?: string
+}
+```
+
+### `ErpImportValidation`
+
+Validate-phase summary: what the file will create, and whether it may be confirmed. Absent until the validate phase completes. No per-row detail is kept — a rejected file is corrected and imported again.
+
+```ts
+type ErpImportValidation = {
+  total_rows: number
+  blocking: number
+  warnings: number
+  entities: Record<string, number>
+}
+```
+
+### `ErpImportProgress`
+
+How far the currently running phase has got. Written at every batch boundary, so it advances during long runs rather than only at the end.
+`total_rows` is ABSENT during the validate phase until the file has been read to the end — there is deliberately no counting pass, since that would be a second u
+
+```ts
+type ErpImportProgress = {
+  processed_rows: number
+  total_rows?: number
+}
+```
+
+### `ErpImportError`
+
+Why the import failed — present if and only if status = FAILED.
+
+```ts
+type ErpImportError = {
+  type: "VALIDATION_BLOCKED" | "PROCESSING_ERROR" | "INTERNAL_ERROR"
+  message: string
+}
+```
+
+### `CreateErpImportResponse`
+
+```ts
+type CreateErpImportResponse = {
+  import_id: string
+}
+```
+
+### `ErpImportJob`
+
+```ts
+type ErpImportJob = {
+  import_id: string
+  org_id: string
+  created_by?: string
+  integration_id: string
+  use_case_slug?: string
+  format: "csv" | "xlsx"
+  status: "PENDING" | "VALIDATING" | "READY" | "PROCESSING" | "IMPORTED" | "FAILED" | "CANCELLING" | "CANCELLED"
+  s3_input_ref: {
+    bucket: string
+    key: string
+  }
+  validation?: {
+    total_rows: number
+    blocking: number
+    warnings: number
+    entities: Record<string, number>
+  }
+  progress?: {
+    processed_rows: number
+    total_rows?: number
+  }
+  error?: {
+    type: "VALIDATION_BLOCKED" | "PROCESSING_ERROR" | "INTERNAL_ERROR"
+    message: string
+  }
+  correlation_id?: string
+  activity_id?: string
+  created_at: string // date-time
+  updated_at: string // date-time
+}
+```
+
+### `ErpImportList`
+
+```ts
+type ErpImportList = {
+  results: Array<{
+    import_id: string
+    org_id: string
+    created_by?: string
+    integration_id: string
+    use_case_slug?: string
+    format: "csv" | "xlsx"
+    status: "PENDING" | "VALIDATING" | "READY" | "PROCESSING" | "IMPORTED" | "FAILED" | "CANCELLING" | "CANCELLED"
+    s3_input_ref: {
+      bucket: { ... }
+      key: { ... }
+    }
+    validation?: {
+      total_rows: { ... }
+      blocking: { ... }
+      warnings: { ... }
+      entities: { ... }
+    }
+    progress?: {
+      processed_rows: { ... }
+      total_rows?: { ... }
+    }
+    error?: {
+      type: { ... }
+      message: { ... }
+    }
+    correlation_id?: string
+    activity_id?: string
+    created_at: string // date-time
+    updated_at: string // date-time
+  }>
+  next_cursor?: string
+}
+```
+
 ### `NotificationHistoryItem`
 
 A single notification-history row (one real notification decision).

package/package.json

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