skedyul 1.7.9 → 1.7.12

package/dist/.build-stamp

@@ -1 +1 @@
-1785987631012
+1786072268866

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
           });
         });
       });
@@ -10103,6 +10113,7 @@ var ThreadEventTypeSchema = import_v44.z.enum([
   // Message events
   "thread.message.received",
   "thread.message.sent",
+  "thread.attachment.received",
   // Participant events
   "thread.participant.joined",
   "thread.participant.left",

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/core/client.d.ts

@@ -192,6 +192,42 @@ export declare const communicationChannel: {
     receiveMessage(input: ReceiveMessageInput): Promise<{
         messageId: string;
     }>;
+    /**
+     * Attach uploaded files to a message created via {@link receiveMessage}.
+     *
+     * Safe to call before or after the inbox processor creates the ThreadMessage:
+     * - Before: attachments are stashed on MessageInbox and linked when the message is created
+     * - After: rows are created immediately and `thread.attachment.received` is emitted
+     *
+     * Typical flow for email/MMS: `receiveMessage` → `file.upload` → `attachFilesToMessage`.
+     *
+     * @example
+     * ```ts
+     * const { messageId } = await communicationChannel.receiveMessage({ ... })
+     * const uploaded = await file.upload({ content, name, mimeType })
+     * await communicationChannel.attachFilesToMessage({
+     *   messageId,
+     *   attachments: [{
+     *     fileId: uploaded.id,
+     *     name: uploaded.name,
+     *     mimeType: 'audio/mpeg',
+     *     size: content.length,
+     *   }],
+     * })
+     * ```
+     */
+    attachFilesToMessage(input: {
+        messageId: string;
+        attachments: Array<{
+            fileId: string;
+            name?: string;
+            mimeType?: string;
+            size?: number;
+        }>;
+    }): Promise<{
+        success: boolean;
+        attachmentCount: number;
+    }>;
     /**
      * Update a communication channel's properties.
      *

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

@@ -490,6 +490,7 @@ var ThreadEventTypeSchema = z4.enum([
   // Message events
   "thread.message.received",
   "thread.message.sent",
+  "thread.attachment.received",
   // Participant events
   "thread.participant.joined",
   "thread.participant.left",
@@ -1923,8 +1924,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 +1941,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()
@@ -2585,6 +2594,40 @@ var communicationChannel = {
     });
     return data;
   },
+  /**
+   * Attach uploaded files to a message created via {@link receiveMessage}.
+   *
+   * Safe to call before or after the inbox processor creates the ThreadMessage:
+   * - Before: attachments are stashed on MessageInbox and linked when the message is created
+   * - After: rows are created immediately and `thread.attachment.received` is emitted
+   *
+   * Typical flow for email/MMS: `receiveMessage` → `file.upload` → `attachFilesToMessage`.
+   *
+   * @example
+   * ```ts
+   * const { messageId } = await communicationChannel.receiveMessage({ ... })
+   * const uploaded = await file.upload({ content, name, mimeType })
+   * await communicationChannel.attachFilesToMessage({
+   *   messageId,
+   *   attachments: [{
+   *     fileId: uploaded.id,
+   *     name: uploaded.name,
+   *     mimeType: 'audio/mpeg',
+   *     size: content.length,
+   *   }],
+   * })
+   * ```
+   */
+  async attachFilesToMessage(input) {
+    const { data } = await callCore(
+      "communicationChannel.attachFilesToMessage",
+      {
+        messageId: input.messageId,
+        attachments: input.attachments
+      }
+    );
+    return data;
+  },
   /**
    * Update a communication channel's properties.
    *
@@ -5598,7 +5641,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 +5668,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 +8731,7 @@ export {
   AssociationSchema,
   AuthenticationError,
   BaseEventPayloadSchema,
+  BatchCascadePhaseSchema,
   BatchOperationDefinitionSchema,
   BatchOperationIterateResultSchema,
   BatchOperationSetupResultSchema,

package/dist/events/types.d.ts

@@ -6,6 +6,7 @@ import { z } from 'zod/v4';
 export declare const ThreadEventTypeSchema: z.ZodEnum<{
     "thread.message.received": "thread.message.received";
     "thread.message.sent": "thread.message.sent";
+    "thread.attachment.received": "thread.attachment.received";
     "thread.participant.joined": "thread.participant.joined";
     "thread.participant.left": "thread.participant.left";
     "thread.participant.mentioned": "thread.participant.mentioned";
@@ -32,6 +33,7 @@ export type CustomEventType = z.infer<typeof CustomEventTypeSchema>;
 export declare const EventTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     "thread.message.received": "thread.message.received";
     "thread.message.sent": "thread.message.sent";
+    "thread.attachment.received": "thread.attachment.received";
     "thread.participant.joined": "thread.participant.joined";
     "thread.participant.left": "thread.participant.left";
     "thread.participant.mentioned": "thread.participant.mentioned";
@@ -274,6 +276,7 @@ export declare const ThreadEventSchema: z.ZodObject<{
     type: z.ZodUnion<readonly [z.ZodEnum<{
         "thread.message.received": "thread.message.received";
         "thread.message.sent": "thread.message.sent";
+        "thread.attachment.received": "thread.attachment.received";
         "thread.participant.joined": "thread.participant.joined";
         "thread.participant.left": "thread.participant.left";
         "thread.participant.mentioned": "thread.participant.mentioned";
@@ -380,6 +383,7 @@ export declare const CreateThreadEventInputSchema: z.ZodObject<{
     type: z.ZodUnion<readonly [z.ZodEnum<{
         "thread.message.received": "thread.message.received";
         "thread.message.sent": "thread.message.sent";
+        "thread.attachment.received": "thread.attachment.received";
         "thread.participant.joined": "thread.participant.joined";
         "thread.participant.left": "thread.participant.left";
         "thread.participant.mentioned": "thread.participant.mentioned";
@@ -404,6 +408,7 @@ export declare const EventSubscriptionSchema: z.ZodObject<{
     subscribes: z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
         "thread.message.received": "thread.message.received";
         "thread.message.sent": "thread.message.sent";
+        "thread.attachment.received": "thread.attachment.received";
         "thread.participant.joined": "thread.participant.joined";
         "thread.participant.left": "thread.participant.left";
         "thread.participant.mentioned": "thread.participant.mentioned";
@@ -421,6 +426,7 @@ export declare const EventSubscriptionSchema: z.ZodObject<{
     cancels: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
         "thread.message.received": "thread.message.received";
         "thread.message.sent": "thread.message.sent";
+        "thread.attachment.received": "thread.attachment.received";
         "thread.participant.joined": "thread.participant.joined";
         "thread.participant.left": "thread.participant.left";
         "thread.participant.mentioned": "thread.participant.mentioned";
@@ -444,6 +450,7 @@ export declare const EventWaitSchema: z.ZodObject<{
     event: z.ZodUnion<readonly [z.ZodEnum<{
         "thread.message.received": "thread.message.received";
         "thread.message.sent": "thread.message.sent";
+        "thread.attachment.received": "thread.attachment.received";
         "thread.participant.joined": "thread.participant.joined";
         "thread.participant.left": "thread.participant.left";
         "thread.participant.mentioned": "thread.participant.mentioned";
@@ -468,6 +475,7 @@ export declare const EventsConfigSchema: z.ZodObject<{
     subscribes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
         "thread.message.received": "thread.message.received";
         "thread.message.sent": "thread.message.sent";
+        "thread.attachment.received": "thread.attachment.received";
         "thread.participant.joined": "thread.participant.joined";
         "thread.participant.left": "thread.participant.left";
         "thread.participant.mentioned": "thread.participant.mentioned";
@@ -485,6 +493,7 @@ export declare const EventsConfigSchema: z.ZodObject<{
     emits: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
         "thread.message.received": "thread.message.received";
         "thread.message.sent": "thread.message.sent";
+        "thread.attachment.received": "thread.attachment.received";
         "thread.participant.joined": "thread.participant.joined";
         "thread.participant.left": "thread.participant.left";
         "thread.participant.mentioned": "thread.participant.mentioned";
@@ -502,6 +511,7 @@ export declare const EventsConfigSchema: z.ZodObject<{
         event: z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";
@@ -521,6 +531,7 @@ export declare const EventsConfigSchema: z.ZodObject<{
     cancels: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
         "thread.message.received": "thread.message.received";
         "thread.message.sent": "thread.message.sent";
+        "thread.attachment.received": "thread.attachment.received";
         "thread.participant.joined": "thread.participant.joined";
         "thread.participant.left": "thread.participant.left";
         "thread.participant.mentioned": "thread.participant.mentioned";

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,
@@ -870,6 +871,7 @@ var ThreadEventTypeSchema = import_v44.z.enum([
   // Message events
   "thread.message.received",
   "thread.message.sent",
+  "thread.attachment.received",
   // Participant events
   "thread.participant.joined",
   "thread.participant.left",
@@ -2303,8 +2305,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 +2322,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()
@@ -2965,6 +2975,40 @@ var communicationChannel = {
     });
     return data;
   },
+  /**
+   * Attach uploaded files to a message created via {@link receiveMessage}.
+   *
+   * Safe to call before or after the inbox processor creates the ThreadMessage:
+   * - Before: attachments are stashed on MessageInbox and linked when the message is created
+   * - After: rows are created immediately and `thread.attachment.received` is emitted
+   *
+   * Typical flow for email/MMS: `receiveMessage` → `file.upload` → `attachFilesToMessage`.
+   *
+   * @example
+   * ```ts
+   * const { messageId } = await communicationChannel.receiveMessage({ ... })
+   * const uploaded = await file.upload({ content, name, mimeType })
+   * await communicationChannel.attachFilesToMessage({
+   *   messageId,
+   *   attachments: [{
+   *     fileId: uploaded.id,
+   *     name: uploaded.name,
+   *     mimeType: 'audio/mpeg',
+   *     size: content.length,
+   *   }],
+   * })
+   * ```
+   */
+  async attachFilesToMessage(input) {
+    const { data } = await callCore(
+      "communicationChannel.attachFilesToMessage",
+      {
+        messageId: input.messageId,
+        attachments: input.attachments
+      }
+    );
+    return data;
+  },
   /**
    * Update a communication channel's properties.
    *
@@ -5978,7 +6022,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 +6049,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 +9113,7 @@ var index_default = { z: import_v414.z };
   AssociationSchema,
   AuthenticationError,
   BaseEventPayloadSchema,
+  BatchCascadePhaseSchema,
   BatchOperationDefinitionSchema,
   BatchOperationIterateResultSchema,
   BatchOperationSetupResultSchema,

package/dist/schemas/agent-schema-v3.d.ts

@@ -528,6 +528,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
         subscribes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";
@@ -545,6 +546,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
         emits: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";
@@ -562,6 +564,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
             event: z.ZodUnion<readonly [z.ZodEnum<{
                 "thread.message.received": "thread.message.received";
                 "thread.message.sent": "thread.message.sent";
+                "thread.attachment.received": "thread.attachment.received";
                 "thread.participant.joined": "thread.participant.joined";
                 "thread.participant.left": "thread.participant.left";
                 "thread.participant.mentioned": "thread.participant.mentioned";
@@ -581,6 +584,7 @@ export declare const AgentYAMLV3Schema: z.ZodObject<{
         cancels: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";

package/dist/schemas/agent-schema-v3.js

@@ -62,6 +62,7 @@ var ThreadEventTypeSchema = import_v4.z.enum([
   // Message events
   "thread.message.received",
   "thread.message.sent",
+  "thread.attachment.received",
   // Participant events
   "thread.participant.joined",
   "thread.participant.left",

package/dist/schemas/agent-schema-v3.mjs

@@ -9,6 +9,7 @@ var ThreadEventTypeSchema = z.enum([
   // Message events
   "thread.message.received",
   "thread.message.sent",
+  "thread.attachment.received",
   // Participant events
   "thread.participant.joined",
   "thread.participant.left",

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/triggers/types.d.ts

@@ -62,6 +62,7 @@ export declare const TriggerContextSchema: z.ZodObject<{
         type: z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";
@@ -189,6 +190,7 @@ export declare const ResolvedTriggerSchema: z.ZodObject<{
             subscribes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
                 "thread.message.received": "thread.message.received";
                 "thread.message.sent": "thread.message.sent";
+                "thread.attachment.received": "thread.attachment.received";
                 "thread.participant.joined": "thread.participant.joined";
                 "thread.participant.left": "thread.participant.left";
                 "thread.participant.mentioned": "thread.participant.mentioned";
@@ -211,6 +213,7 @@ export declare const ResolvedTriggerSchema: z.ZodObject<{
             type: z.ZodUnion<readonly [z.ZodEnum<{
                 "thread.message.received": "thread.message.received";
                 "thread.message.sent": "thread.message.sent";
+                "thread.attachment.received": "thread.attachment.received";
                 "thread.participant.joined": "thread.participant.joined";
                 "thread.participant.left": "thread.participant.left";
                 "thread.participant.mentioned": "thread.participant.mentioned";

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/dist/workflows/types.d.ts

@@ -71,6 +71,7 @@ export declare const WorkflowYAMLSchema: z.ZodObject<{
         subscribes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";
@@ -88,6 +89,7 @@ export declare const WorkflowYAMLSchema: z.ZodObject<{
         emits: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";
@@ -105,6 +107,7 @@ export declare const WorkflowYAMLSchema: z.ZodObject<{
             event: z.ZodUnion<readonly [z.ZodEnum<{
                 "thread.message.received": "thread.message.received";
                 "thread.message.sent": "thread.message.sent";
+                "thread.attachment.received": "thread.attachment.received";
                 "thread.participant.joined": "thread.participant.joined";
                 "thread.participant.left": "thread.participant.left";
                 "thread.participant.mentioned": "thread.participant.mentioned";
@@ -124,6 +127,7 @@ export declare const WorkflowYAMLSchema: z.ZodObject<{
         cancels: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";
@@ -185,6 +189,7 @@ export declare const WorkflowMetadataSchema: z.ZodObject<{
         subscribes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";
@@ -202,6 +207,7 @@ export declare const WorkflowMetadataSchema: z.ZodObject<{
         emits: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";
@@ -219,6 +225,7 @@ export declare const WorkflowMetadataSchema: z.ZodObject<{
             event: z.ZodUnion<readonly [z.ZodEnum<{
                 "thread.message.received": "thread.message.received";
                 "thread.message.sent": "thread.message.sent";
+                "thread.attachment.received": "thread.attachment.received";
                 "thread.participant.joined": "thread.participant.joined";
                 "thread.participant.left": "thread.participant.left";
                 "thread.participant.mentioned": "thread.participant.mentioned";
@@ -238,6 +245,7 @@ export declare const WorkflowMetadataSchema: z.ZodObject<{
         cancels: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
             "thread.message.received": "thread.message.received";
             "thread.message.sent": "thread.message.sent";
+            "thread.attachment.received": "thread.attachment.received";
             "thread.participant.joined": "thread.participant.joined";
             "thread.participant.left": "thread.participant.left";
             "thread.participant.mentioned": "thread.participant.mentioned";

package/package.json

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