skedyul 1.7.9 → 1.7.11

package/dist/.build-stamp

@@ -1 +1 @@
-1785987631012
+1786058725534

package/dist/cli/index.js

@@ -4781,7 +4781,11 @@ async function handleBatchOperationRoute(req, ctx) {
           status: 200,
           body: {
             success: true,
-            result: { state: {}, total: void 0 },
+            result: {
+              state: {},
+              total: void 0,
+              cascade: operation.cascade
+            },
             billing: normalizeBilling(void 0)
           }
         };
@@ -4804,20 +4808,26 @@ async function handleBatchOperationRoute(req, ctx) {
         status: 200,
         body: {
           success: true,
-          result: domain2,
+          result: {
+            ...domain2,
+            // Expose definition cascade to the platform workflow
+            cascade: operation.cascade ?? domain2.cascade
+          },
           billing: normalizeBilling(setupResult.billing)
         }
       };
     }
+    const iterateBody = body;
     const raw = await runWithConfig(requestConfig, async () => {
       return runWithRateLimitExecutionContext(rateLimitContext, async () => {
         return runWithLogContext({ invocation }, async () => {
           return operation.iterate({
             ...opContextBase,
-            state: body.state,
-            page: body.page,
-            cursor: body.cursor,
-            limit: body.limit
+            state: iterateBody.state,
+            page: iterateBody.page,
+            cursor: iterateBody.cursor,
+            limit: iterateBody.limit,
+            cascadeEntities: iterateBody.cascadeEntities
           });
         });
       });

package/dist/config/types/batch-operation.d.ts

@@ -42,17 +42,48 @@ export interface BatchOperationSetupResult {
     state?: Record<string, unknown>;
     /** Optional total count for progress display */
     total?: number;
+    /**
+     * Cascade phases (usually injected from the operation definition by the
+     * route handler so the platform workflow can resolve map-gated targets).
+     */
+    cascade?: BatchCascadePhase[];
     /** Optional billing (normalized by the route if omitted) */
     billing?: ToolBilling;
     /** Optional success discriminator (default true when domain fields present) */
     success?: true;
 }
+/**
+ * Cascade phase for multi-entity batch imports.
+ * Platform upserts configured entities in `order` within each wave.
+ */
+export interface BatchCascadePhase {
+    /** App entity handle to upsert */
+    entity: string;
+    /** Lower runs first within the same wave */
+    order: number;
+    /** setup = once (typically first iterate); page = every iterate page */
+    wave: 'setup' | 'page';
+    /**
+     * Other cascade entities that must also be CRM-configured for this phase
+     * to run (e.g. plan requires package).
+     */
+    requires?: string[];
+}
 /**
  * Result from a batch operation iterate function.
  */
 export interface BatchOperationIterateResult {
-    /** Array of raw items from the external source */
+    /**
+     * Array of raw items for the primary `entity`.
+     * Prefer `itemsByEntity` for cascade imports; when both are set, platform
+     * uses `itemsByEntity` and falls back to `items` for the primary entity.
+     */
     items: Record<string, unknown>[];
+    /**
+     * Multi-entity items keyed by entity handle (cascade imports).
+     * Platform upserts each configured entity in cascade order.
+     */
+    itemsByEntity?: Record<string, Record<string, unknown>[]>;
     /** Pagination info for fetching more pages */
     pagination: BatchPagination;
     /** Optional state to persist for the next iterate call */
@@ -89,6 +120,12 @@ export interface BatchOperationContext {
     env: Record<string, string>;
     /** Invocation context for log traceability */
     invocation?: InvocationContext;
+    /**
+     * Entity handles whose CRM maps are configured for this job's cascade.
+     * Platform injects this on iterate so apps can skip expensive fetches
+     * (e.g. per-member credits) when that entity is not mapped.
+     */
+    cascadeEntities?: string[];
     /** Logger instance */
     log: {
         info: (message: string, meta?: Record<string, unknown>) => void;
@@ -150,10 +187,15 @@ export interface BatchOperationDefinition {
     /** Description of what this operation does */
     description?: string;
     /**
-     * Entity handle that items will be upserted to.
+     * Primary entity handle (progress + start gate).
      * The platform applies CRM mappings and calls upsertMany.
      */
     entity: string;
+    /**
+     * Optional multi-entity cascade. When set, iterate may return
+     * `itemsByEntity` and the platform upserts map-configured phases in order.
+     */
+    cascade?: BatchCascadePhase[];
     /**
      * Setup function called once at the start of the operation.
      * Use to initialize state, fetch total count, etc.

package/dist/dedicated/server.js

@@ -2111,7 +2111,11 @@ async function handleBatchOperationRoute(req, ctx) {
           status: 200,
           body: {
             success: true,
-            result: { state: {}, total: void 0 },
+            result: {
+              state: {},
+              total: void 0,
+              cascade: operation.cascade
+            },
             billing: normalizeBilling(void 0)
           }
         };
@@ -2134,20 +2138,26 @@ async function handleBatchOperationRoute(req, ctx) {
         status: 200,
         body: {
           success: true,
-          result: domain2,
+          result: {
+            ...domain2,
+            // Expose definition cascade to the platform workflow
+            cascade: operation.cascade ?? domain2.cascade
+          },
           billing: normalizeBilling(setupResult.billing)
         }
       };
     }
+    const iterateBody = body;
     const raw = await runWithConfig(requestConfig, async () => {
       return runWithRateLimitExecutionContext(rateLimitContext, async () => {
         return runWithLogContext({ invocation }, async () => {
           return operation.iterate({
             ...opContextBase,
-            state: body.state,
-            page: body.page,
-            cursor: body.cursor,
-            limit: body.limit
+            state: iterateBody.state,
+            page: iterateBody.page,
+            cursor: iterateBody.cursor,
+            limit: iterateBody.limit,
+            cascadeEntities: iterateBody.cascadeEntities
           });
         });
       });

package/dist/esm/index.mjs

@@ -1923,8 +1923,15 @@ var BatchOperationSetupResultSchema = z8.object({
   state: z8.record(z8.string(), z8.unknown()).optional(),
   total: z8.number().int().nonnegative().optional()
 });
+var BatchCascadePhaseSchema = z8.object({
+  entity: z8.string(),
+  order: z8.number().int(),
+  wave: z8.enum(["setup", "page"]),
+  requires: z8.array(z8.string()).optional()
+});
 var BatchOperationIterateResultSchema = z8.object({
   items: z8.array(z8.record(z8.string(), z8.unknown())),
+  itemsByEntity: z8.record(z8.string(), z8.array(z8.record(z8.string(), z8.unknown()))).optional(),
   pagination: BatchPaginationSchema,
   state: z8.record(z8.string(), z8.unknown()).optional()
 });
@@ -1933,6 +1940,7 @@ var BatchOperationDefinitionSchema = z8.object({
   label: z8.string(),
   description: z8.string().optional(),
   entity: z8.string(),
+  cascade: z8.array(BatchCascadePhaseSchema).optional(),
   maxConcurrent: z8.number().int().positive().optional(),
   pageSize: z8.number().int().positive().optional(),
   icon: z8.string().optional()
@@ -5598,7 +5606,11 @@ async function handleBatchOperationRoute(req, ctx) {
           status: 200,
           body: {
             success: true,
-            result: { state: {}, total: void 0 },
+            result: {
+              state: {},
+              total: void 0,
+              cascade: operation.cascade
+            },
             billing: normalizeBilling(void 0)
           }
         };
@@ -5621,20 +5633,26 @@ async function handleBatchOperationRoute(req, ctx) {
         status: 200,
         body: {
           success: true,
-          result: domain2,
+          result: {
+            ...domain2,
+            // Expose definition cascade to the platform workflow
+            cascade: operation.cascade ?? domain2.cascade
+          },
           billing: normalizeBilling(setupResult.billing)
         }
       };
     }
+    const iterateBody = body;
     const raw = await runWithConfig(requestConfig, async () => {
       return runWithRateLimitExecutionContext(rateLimitContext, async () => {
         return runWithLogContext({ invocation }, async () => {
           return operation.iterate({
             ...opContextBase,
-            state: body.state,
-            page: body.page,
-            cursor: body.cursor,
-            limit: body.limit
+            state: iterateBody.state,
+            page: iterateBody.page,
+            cursor: iterateBody.cursor,
+            limit: iterateBody.limit,
+            cascadeEntities: iterateBody.cascadeEntities
           });
         });
       });
@@ -8678,6 +8696,7 @@ export {
   AssociationSchema,
   AuthenticationError,
   BaseEventPayloadSchema,
+  BatchCascadePhaseSchema,
   BatchOperationDefinitionSchema,
   BatchOperationIterateResultSchema,
   BatchOperationSetupResultSchema,

package/dist/index.d.ts

@@ -35,7 +35,7 @@ export type { CRMContext, SenderContext, ThreadContextItem, ThreadInfo, SandboxC
 export { MemoryEntryTypeSchema, MemoryEntrySchema, WorkingMemoryConfigSchema, SemanticMemoryConfigSchema, ExternalMemoryConfigSchema, MemoryConfigSchema, MemoryScopeSchema, MemoryQueryOptionsSchema, ConversationSummarySchema, AgentObservationSchema, ExternalDataCacheSchema, MemoryService, InMemoryStore, createInMemoryService, } from './memory';
 export type { MemoryEntryType, MemoryEntry, WorkingMemoryConfig as MemoryWorkingConfig, SemanticMemoryConfig as MemorySemanticConfig, ExternalMemoryConfig as MemoryExternalConfig, MemoryConfig, MemoryScope, MemoryQueryOptions, ConversationSummary, AgentObservation, ExternalDataCache, MemoryStore, } from './memory';
 export type { CRMFieldType, CRMFieldRequirement, CRMFieldOption, CRMFieldDefinition, CRMFieldSchema, CRMModelSchema, CRMCardinality, CRMOnDelete, CRMRelationshipLink, CRMRelationshipSchema, CRMSchema, CRMSchemaValidationResult, } from './schemas';
-export type { SkedyulConfig, SerializableSkedyulConfig, InstallConfig, ProvisionConfig, BaseDefinition, Scope, FieldOwner, Visibility, ComputeLayer, StructuredFilter, FilterOperator, FilterCondition, FieldOption, EnvVariable, EnvSchema, FieldType, Cardinality, OnDelete, InlineFieldDefinition, FieldVisibility, FieldDefinition, ModelDefinition, RelationshipLink, RelationshipDefinition, CapabilityType, ChannelCapability, ChannelBatchCapability, ChannelFieldPermissions, ChannelField, ChannelDefinition, WorkflowActionInput, WorkflowAction, WorkflowDefinition, AgentDefinition, NavigationItem, NavigationSection, NavigationSidebar, BreadcrumbItem, NavigationBreadcrumb, NavigationConfig, ContextMode, ContextItemModel, ContextItemTool, ContextItem, ContextDefinition, FormStyleProps, ButtonVariant, ButtonSize, ButtonProps, RelationshipExtension, FormHeader, FormActionDefinition, ActionDefinition, ModalFormDefinition, InputComponent, TextareaComponent, SelectComponent, ComboboxComponent, CheckboxComponent, DatePickerComponent, TimePickerComponent, StatusIndicator, FieldSettingComponent, ImageSettingComponent, FileSettingComponent, ListItemTemplate, ListComponent, EmptyFormComponent, AlertComponent, FormComponent, FormLayoutColumn, FormLayoutRow, FormLayoutConfig, FormProps, CardHeader, CardBlock, ListBlock, BlockDefinition, SetupStepDefinition, SetupStepKind, PageType, PageDefinition, HttpMethod, WebhookRequest, WebhookHandlerContext, WebhookHandlerResponse, WebhookHandlerFn, WebhookHandlerDefinition, Webhooks, WebhookHandlerMetadata, ModelDependency, ChannelDependency, WorkflowDependency, ResourceDependency, } from './config';
+export type { SkedyulConfig, SerializableSkedyulConfig, InstallConfig, ProvisionConfig, BaseDefinition, Scope, FieldOwner, Visibility, ComputeLayer, StructuredFilter, FilterOperator, FilterCondition, FieldOption, EnvVariable, EnvSchema, FieldType, Cardinality, OnDelete, InlineFieldDefinition, FieldVisibility, FieldDefinition, ModelDefinition, RelationshipLink, RelationshipDefinition, CapabilityType, ChannelCapability, ChannelBatchCapability, ChannelFieldPermissions, ChannelField, ChannelDefinition, WorkflowActionInput, WorkflowAction, WorkflowDefinition, AgentDefinition, NavigationItem, NavigationSection, NavigationSidebar, BreadcrumbItem, NavigationBreadcrumb, NavigationConfig, ContextMode, ContextItemModel, ContextItemTool, ContextItem, ContextDefinition, FormStyleProps, ButtonVariant, ButtonSize, ButtonProps, RelationshipExtension, FormHeader, FormActionDefinition, ActionDefinition, ModalFormDefinition, InputComponent, TextareaComponent, SelectComponent, ComboboxComponent, CheckboxComponent, DatePickerComponent, TimePickerComponent, StatusIndicator, FieldSettingComponent, ImageSettingComponent, FileSettingComponent, ListItemTemplate, ListComponent, EmptyFormComponent, AlertComponent, FormComponent, FormLayoutColumn, FormLayoutRow, FormLayoutConfig, FormProps, CardHeader, CardBlock, ListBlock, BlockDefinition, SetupStepDefinition, SetupStepKind, BatchCascadePhase, BatchOperationDefinition, BatchOperationContext, BatchOperationIterateResult, BatchOperationSetupResult, PageType, PageDefinition, HttpMethod, WebhookRequest, WebhookHandlerContext, WebhookHandlerResponse, WebhookHandlerFn, WebhookHandlerDefinition, Webhooks, WebhookHandlerMetadata, ModelDependency, ChannelDependency, WorkflowDependency, ResourceDependency, } from './config';
 export { compileAgent, compileWorkflow } from './compiler';
 export type { ValidationError, ValidationWarning, ResolvedPersona, ResolvedTool, EventConfig as CompilerEventConfig, IRMemoryConfig, PolicyConfig, IRRuntimeConfig, AgentIR, WorkflowStepIR, WorkflowIR, CompilationResult, } from './compiler';
 export { TimeStampSchema, DayOfWeekSchema, TimeWindowSlotSchema, WaitUnitSchema, WaitInputRelativeSchema, WaitInputAbsoluteSchema, WaitInputSchema, } from './scheduling/types';

package/dist/index.js

@@ -42,6 +42,7 @@ __export(index_exports, {
   AssociationSchema: () => AssociationSchema,
   AuthenticationError: () => AuthenticationError,
   BaseEventPayloadSchema: () => BaseEventPayloadSchema,
+  BatchCascadePhaseSchema: () => BatchCascadePhaseSchema,
   BatchOperationDefinitionSchema: () => BatchOperationDefinitionSchema,
   BatchOperationIterateResultSchema: () => BatchOperationIterateResultSchema,
   BatchOperationSetupResultSchema: () => BatchOperationSetupResultSchema,
@@ -2303,8 +2304,15 @@ var BatchOperationSetupResultSchema = import_v48.z.object({
   state: import_v48.z.record(import_v48.z.string(), import_v48.z.unknown()).optional(),
   total: import_v48.z.number().int().nonnegative().optional()
 });
+var BatchCascadePhaseSchema = import_v48.z.object({
+  entity: import_v48.z.string(),
+  order: import_v48.z.number().int(),
+  wave: import_v48.z.enum(["setup", "page"]),
+  requires: import_v48.z.array(import_v48.z.string()).optional()
+});
 var BatchOperationIterateResultSchema = import_v48.z.object({
   items: import_v48.z.array(import_v48.z.record(import_v48.z.string(), import_v48.z.unknown())),
+  itemsByEntity: import_v48.z.record(import_v48.z.string(), import_v48.z.array(import_v48.z.record(import_v48.z.string(), import_v48.z.unknown()))).optional(),
   pagination: BatchPaginationSchema,
   state: import_v48.z.record(import_v48.z.string(), import_v48.z.unknown()).optional()
 });
@@ -2313,6 +2321,7 @@ var BatchOperationDefinitionSchema = import_v48.z.object({
   label: import_v48.z.string(),
   description: import_v48.z.string().optional(),
   entity: import_v48.z.string(),
+  cascade: import_v48.z.array(BatchCascadePhaseSchema).optional(),
   maxConcurrent: import_v48.z.number().int().positive().optional(),
   pageSize: import_v48.z.number().int().positive().optional(),
   icon: import_v48.z.string().optional()
@@ -5978,7 +5987,11 @@ async function handleBatchOperationRoute(req, ctx) {
           status: 200,
           body: {
             success: true,
-            result: { state: {}, total: void 0 },
+            result: {
+              state: {},
+              total: void 0,
+              cascade: operation.cascade
+            },
             billing: normalizeBilling(void 0)
           }
         };
@@ -6001,20 +6014,26 @@ async function handleBatchOperationRoute(req, ctx) {
         status: 200,
         body: {
           success: true,
-          result: domain2,
+          result: {
+            ...domain2,
+            // Expose definition cascade to the platform workflow
+            cascade: operation.cascade ?? domain2.cascade
+          },
           billing: normalizeBilling(setupResult.billing)
         }
       };
     }
+    const iterateBody = body;
     const raw = await runWithConfig(requestConfig, async () => {
       return runWithRateLimitExecutionContext(rateLimitContext, async () => {
         return runWithLogContext({ invocation }, async () => {
           return operation.iterate({
             ...opContextBase,
-            state: body.state,
-            page: body.page,
-            cursor: body.cursor,
-            limit: body.limit
+            state: iterateBody.state,
+            page: iterateBody.page,
+            cursor: iterateBody.cursor,
+            limit: iterateBody.limit,
+            cascadeEntities: iterateBody.cascadeEntities
           });
         });
       });
@@ -9059,6 +9078,7 @@ var index_default = { z: import_v414.z };
   AssociationSchema,
   AuthenticationError,
   BaseEventPayloadSchema,
+  BatchCascadePhaseSchema,
   BatchOperationDefinitionSchema,
   BatchOperationIterateResultSchema,
   BatchOperationSetupResultSchema,

package/dist/schemas.d.ts

@@ -3368,8 +3368,18 @@ export declare const BatchOperationSetupResultSchema: z.ZodObject<{
     state: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     total: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+export declare const BatchCascadePhaseSchema: z.ZodObject<{
+    entity: z.ZodString;
+    order: z.ZodNumber;
+    wave: z.ZodEnum<{
+        page: "page";
+        setup: "setup";
+    }>;
+    requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
 export declare const BatchOperationIterateResultSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    itemsByEntity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
     pagination: z.ZodObject<{
         hasMore: z.ZodBoolean;
         page: z.ZodOptional<z.ZodNumber>;
@@ -3384,6 +3394,15 @@ export declare const BatchOperationDefinitionSchema: z.ZodObject<{
     label: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     entity: z.ZodString;
+    cascade: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        entity: z.ZodString;
+        order: z.ZodNumber;
+        wave: z.ZodEnum<{
+            page: "page";
+            setup: "setup";
+        }>;
+        requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
     maxConcurrent: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
     icon: z.ZodOptional<z.ZodString>;
@@ -4197,6 +4216,15 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
         label: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         entity: z.ZodString;
+        cascade: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            entity: z.ZodString;
+            order: z.ZodNumber;
+            wave: z.ZodEnum<{
+                page: "page";
+                setup: "setup";
+            }>;
+            requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
         maxConcurrent: z.ZodOptional<z.ZodNumber>;
         pageSize: z.ZodOptional<z.ZodNumber>;
         icon: z.ZodOptional<z.ZodString>;
@@ -5021,6 +5049,15 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
             label: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
             entity: z.ZodString;
+            cascade: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                entity: z.ZodString;
+                order: z.ZodNumber;
+                wave: z.ZodEnum<{
+                    page: "page";
+                    setup: "setup";
+                }>;
+                requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>>;
             maxConcurrent: z.ZodOptional<z.ZodNumber>;
             pageSize: z.ZodOptional<z.ZodNumber>;
             icon: z.ZodOptional<z.ZodString>;

package/dist/server.js

@@ -2111,7 +2111,11 @@ async function handleBatchOperationRoute(req, ctx) {
           status: 200,
           body: {
             success: true,
-            result: { state: {}, total: void 0 },
+            result: {
+              state: {},
+              total: void 0,
+              cascade: operation.cascade
+            },
             billing: normalizeBilling(void 0)
           }
         };
@@ -2134,20 +2138,26 @@ async function handleBatchOperationRoute(req, ctx) {
         status: 200,
         body: {
           success: true,
-          result: domain2,
+          result: {
+            ...domain2,
+            // Expose definition cascade to the platform workflow
+            cascade: operation.cascade ?? domain2.cascade
+          },
           billing: normalizeBilling(setupResult.billing)
         }
       };
     }
+    const iterateBody = body;
     const raw = await runWithConfig(requestConfig, async () => {
       return runWithRateLimitExecutionContext(rateLimitContext, async () => {
         return runWithLogContext({ invocation }, async () => {
           return operation.iterate({
             ...opContextBase,
-            state: body.state,
-            page: body.page,
-            cursor: body.cursor,
-            limit: body.limit
+            state: iterateBody.state,
+            page: iterateBody.page,
+            cursor: iterateBody.cursor,
+            limit: iterateBody.limit,
+            cascadeEntities: iterateBody.cascadeEntities
           });
         });
       });

package/dist/serverless/server.mjs

@@ -2072,7 +2072,11 @@ async function handleBatchOperationRoute(req, ctx) {
           status: 200,
           body: {
             success: true,
-            result: { state: {}, total: void 0 },
+            result: {
+              state: {},
+              total: void 0,
+              cascade: operation.cascade
+            },
             billing: normalizeBilling(void 0)
           }
         };
@@ -2095,20 +2099,26 @@ async function handleBatchOperationRoute(req, ctx) {
         status: 200,
         body: {
           success: true,
-          result: domain2,
+          result: {
+            ...domain2,
+            // Expose definition cascade to the platform workflow
+            cascade: operation.cascade ?? domain2.cascade
+          },
           billing: normalizeBilling(setupResult.billing)
         }
       };
     }
+    const iterateBody = body;
     const raw = await runWithConfig(requestConfig, async () => {
       return runWithRateLimitExecutionContext(rateLimitContext, async () => {
         return runWithLogContext({ invocation }, async () => {
           return operation.iterate({
             ...opContextBase,
-            state: body.state,
-            page: body.page,
-            cursor: body.cursor,
-            limit: body.limit
+            state: iterateBody.state,
+            page: iterateBody.page,
+            cursor: iterateBody.cursor,
+            limit: iterateBody.limit,
+            cascadeEntities: iterateBody.cascadeEntities
           });
         });
       });

package/dist/types/batch-operation.d.ts

@@ -3,8 +3,8 @@
  *
  * These types define the registry and context for batch operations at runtime.
  */
-import type { BatchOperationSetupFn, BatchOperationIterateFn } from '../config/types/batch-operation';
-export type { BatchOperationContext } from '../config/types/batch-operation';
+import type { BatchCascadePhase, BatchOperationSetupFn, BatchOperationIterateFn } from '../config/types/batch-operation';
+export type { BatchCascadePhase, BatchOperationContext, } from '../config/types/batch-operation';
 /**
  * Entry in the batch operation registry.
  * Contains both metadata and function implementations.
@@ -16,8 +16,10 @@ export interface BatchOperationRegistryEntry {
     label: string;
     /** Description of what this operation does */
     description?: string;
-    /** Entity handle that items will be upserted to */
+    /** Primary entity handle that items will be upserted to */
     entity: string;
+    /** Optional multi-entity cascade phases */
+    cascade?: BatchCascadePhase[];
     /** Setup function called once at the start */
     setup?: BatchOperationSetupFn;
     /** Iterate function called for each page */
@@ -41,6 +43,7 @@ export interface BatchOperationMetadata {
     label: string;
     description?: string;
     entity: string;
+    cascade?: BatchCascadePhase[];
     maxConcurrent?: number;
     pageSize?: number;
     icon?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.7.9",
+  "version": "1.7.11",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",