@supergrowthai/tq 1.0.13 → 1.1.1

package/README.md

@@ -119,17 +119,25 @@ taskHandler.processMatureTasks();
 
 ### TaskRunner
 
-Handles task execution with locking and async support:
+Handles task execution with locking and async support. Internal to TaskHandler — not typically instantiated directly.
 
 ```typescript
 import {TaskRunner} from '@supergrowthai/tq';
 
-const taskRunner = new TaskRunner(
+const taskRunner = new TaskRunner({
     messageQueue,
     taskQueue,
     taskStore,
-    cacheProvider
-);
+    cacheProvider,
+    generateId: databaseAdapter.generateId.bind(databaseAdapter),
+    lifecycleProvider,       // optional
+    lifecycleConfig,         // optional
+    entityProjection,        // optional
+    entityProjectionConfig,  // optional
+    flowMiddleware,          // optional — typically created by TaskHandler
+    flowLifecycleProvider,   // optional
+    workerId: 'my-worker',   // optional
+});
 
 // Run tasks
 const result = await taskRunner.run(
@@ -364,7 +372,7 @@ const workerLifecycleProvider: IWorkerLifecycleProvider = {
         console.log(`Heartbeat: ${info.worker_id}, processed: ${info.stats.tasks_processed}`);
     },
 
-    onWorkerStopped(info: WorkerInfo & { reason: string; final_stats: WorkerStats }) {
+    onWorkerStopped(info: WorkerInfo & { reason: 'shutdown' | 'error' | 'idle_timeout'; final_stats: WorkerStats }) {
         console.log(`Worker stopped: ${info.worker_id}, reason: ${info.reason}`);
     },
 
@@ -374,6 +382,62 @@ const workerLifecycleProvider: IWorkerLifecycleProvider = {
 
     onBatchCompleted(info: WorkerInfo & { batch_size: number; succeeded: number; failed: number }) {
         console.log(`Batch completed: ${info.succeeded}/${info.batch_size} succeeded`);
+    },
+
+    onConsumerStarted(info: ConsumerInfo) {
+        console.log(`Consumer started: ${info.consumer_id} on queue ${info.queue_id}`);
+    },
+
+    onConsumerStopped(info: ConsumerInfo & { reason: 'shutdown' | 'error' | 'idle_timeout'; stats: ConsumerStats }) {
+        console.log(`Consumer stopped: ${info.consumer_id}, processed: ${info.stats.tasks_processed}`);
+    }
+};
+```
+
+The heartbeat callback also includes `active_consumers: ConsumerStats[]` for per-consumer-per-worker visibility in SRE dashboards.
+
+### Flow Lifecycle Provider
+
+Track flow orchestration events (fan-out/fan-in):
+
+```typescript
+import {IFlowLifecycleProvider, FlowContext} from '@supergrowthai/tq';
+
+const flowLifecycleProvider: IFlowLifecycleProvider = {
+    onFlowStarted(ctx: FlowContext & { started_at: Date; step_types: string[] }) {
+        console.log(`Flow started: ${ctx.flow_id}, ${ctx.total_steps} steps`);
+    },
+
+    onFlowCompleted(ctx: FlowContext & { duration_ms: number; steps_succeeded: number; steps_failed: number }) {
+        console.log(`Flow completed: ${ctx.flow_id} in ${ctx.duration_ms}ms`);
+    },
+
+    onFlowAborted(ctx: FlowContext & { duration_ms: number; steps_completed: number; trigger_step_index: number }) {
+        console.log(`Flow aborted: ${ctx.flow_id}, trigger step: ${ctx.trigger_step_index}`);
+    },
+
+    onFlowTimedOut(ctx: FlowContext & { duration_ms: number; steps_completed: number }) {
+        console.log(`Flow timed out: ${ctx.flow_id}, ${ctx.steps_completed} steps completed`);
+    }
+};
+```
+
+Flow events are split across two pipeline stages:
+- `onFlowStarted` fires during task execution (when `actions.startFlow()` is called)
+- `onFlowCompleted/Aborted/TimedOut` fire during post-processing (when barriers resolve)
+
+### Batch Executor Lifecycle
+
+Track multi-task (batch) executor events for task-level accounting:
+
+```typescript
+const taskLifecycleProvider: ITaskLifecycleProvider = {
+    onTaskBatchStarted(ctx) {
+        console.log(`Batch started: ${ctx.task_type}, ${ctx.tasks.length} tasks`);
+    },
+
+    onTaskBatchCompleted(ctx) {
+        console.log(`Batch done: ${ctx.succeeded.length} ok, ${ctx.failed.length} failed in ${ctx.duration_ms}ms`);
     }
 };
 ```
@@ -437,6 +501,8 @@ const taskHandler = new TaskHandler(
 | max_retries  | number                  | Maximum retry attempts           |
 | scheduled_at | Date                    | When task was scheduled          |
 | worker_id    | string?                 | ID of worker processing the task |
+| consumer_id  | string?                 | Consumer stream identity (distinguishes multiple consumers on same worker) |
+| log_context  | Record<string, string>? | User-provided log correlation context (RFC-005) |
 
 ### WorkerInfo Properties
 
@@ -658,10 +724,9 @@ class RedisFlowBarrierProvider implements IFlowBarrierProvider {
 ### Wiring It Up
 
 ```typescript
-import { FlowMiddleware, InMemoryFlowBarrierProvider } from '@supergrowthai/tq';
+import { InMemoryFlowBarrierProvider } from '@supergrowthai/tq';
 
 const barrierProvider = new InMemoryFlowBarrierProvider(); // or your Redis impl
-const flowMiddleware = new FlowMiddleware(barrierProvider, generateId);
 
 const taskHandler = new TaskHandler(
     messageQueue,
@@ -674,11 +739,14 @@ const taskHandler = new TaskHandler(
         lifecycleProvider: myLifecycleProvider,
         workerProvider: myWorkerProvider,
         entityProjection: myProjectionProvider,
-        flowMiddleware,  // RFC-002
+        flowBarrierProvider: barrierProvider,        // RFC-002: TaskHandler creates FlowMiddleware internally
+        flowLifecycleProvider: myFlowLifecycleProvider,  // optional: flow lifecycle events
     }
 );
 ```
 
+TaskHandler assembles `FlowMiddleware` internally from the barrier provider — no need to construct it yourself. If `flowLifecycleProvider` is set without `flowBarrierProvider`, TaskHandler throws immediately (fail-fast).
+
 ### Entity Tracking on Flows
 
 When `config.entity` is provided, the flow lifecycle is projected through the same entity projection system (RFC-003):
@@ -700,6 +768,79 @@ Individual step tasks do **not** carry `CronTask.entity` — entity tracking is
 - **Nested flows**: A join executor can call `actions.startFlow()` to start another flow. Flow IDs are independent UUIDs — no special handling needed.
 - **IMultiTaskExecutor optimization**: Flow steps of the same type in the same processing cycle batch into a single executor call automatically via `TaskRunner`'s existing grouping logic.
 
+## API Reference — Lifecycle Interfaces
+
+### ITaskLifecycleProvider
+
+| Method | Context | Description |
+|--------|---------|-------------|
+| `onTaskScheduled?(ctx)` | `TaskContext` | Task added to queue |
+| `onTaskStarted?(ctx)` | `TaskContext & { started_at, queued_duration_ms }` | Worker picks up task |
+| `onTaskCompleted?(ctx)` | `TaskContext & { timing: TaskTiming, result? }` | Task succeeds |
+| `onTaskFailed?(ctx)` | `TaskContext & { timing: TaskTiming, error, will_retry, next_attempt_at? }` | Task fails (before retry decision) |
+| `onTaskExhausted?(ctx)` | `TaskContext & { timing: TaskTiming, error, total_attempts }` | All retries exhausted |
+| `onTaskCancelled?(ctx)` | `TaskContext & { reason }` | Task manually cancelled |
+| `onTaskBatchStarted?(ctx)` | `{ task_type, queue_id, tasks: TaskContext[], worker_id, consumer_id?, started_at }` | Batch executor starts |
+| `onTaskBatchCompleted?(ctx)` | `{ task_type, queue_id, tasks, worker_id, consumer_id?, succeeded: string[], failed: string[], duration_ms }` | Batch executor finishes |
+
+### IWorkerLifecycleProvider
+
+| Method | Context | Description |
+|--------|---------|-------------|
+| `onWorkerStarted?(info)` | `WorkerInfo` | Worker process starts consuming |
+| `onWorkerHeartbeat?(info)` | `WorkerInfo & { stats: WorkerStats, memory_usage_mb, active_consumers: ConsumerStats[] }` | Periodic health check |
+| `onWorkerStopped?(info)` | `WorkerInfo & { reason, final_stats: WorkerStats }` | Worker shuts down |
+| `onBatchStarted?(info)` | `WorkerInfo & { batch_size, task_types: string[] }` | Processing batch begins |
+| `onBatchCompleted?(info)` | `WorkerInfo & { batch_size, succeeded, failed, duration_ms }` | Processing batch ends |
+| `onConsumerStarted?(info)` | `ConsumerInfo` | First batch arrives on a consumer (lazy registration) |
+| `onConsumerStopped?(info)` | `ConsumerInfo & { reason, stats: ConsumerStats }` | Consumer stops (shutdown) |
+
+### IFlowLifecycleProvider
+
+| Method | Context | Description |
+|--------|---------|-------------|
+| `onFlowStarted?(ctx)` | `FlowContext & { started_at, step_types: string[] }` | `actions.startFlow()` called |
+| `onFlowCompleted?(ctx)` | `FlowContext & { duration_ms, steps_succeeded, steps_failed }` | All steps done, barrier met |
+| `onFlowAborted?(ctx)` | `FlowContext & { duration_ms, steps_completed, trigger_step_index }` | Step failed with `abort` policy |
+| `onFlowTimedOut?(ctx)` | `FlowContext & { duration_ms, steps_completed }` | Timeout sentinel fired before barrier met |
+
+### IFlowBarrierProvider
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `initBarrier` | `(flowId: string, totalSteps: number) => Promise<void>` | Initialize barrier for a new flow |
+| `batchDecrementAndCheck` | `(flowId: string, results: FlowStepResult[]) => Promise<BarrierDecrementResult>` | Record step results, decrement barrier (HSETNX dedup) |
+| `getStepResults` | `(flowId: string) => Promise<FlowStepResult[]>` | Get all recorded step results |
+| `markAborted` | `(flowId: string) => Promise<boolean>` | Mark flow aborted (returns true on first call) |
+| `isComplete` | `(flowId: string) => Promise<boolean>` | Check if barrier fully met |
+| `getStartedAt` | `(flowId: string) => Promise<Date \| null>` | Get barrier init timestamp (for duration tracking) |
+
+### TaskHandlerConfig
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `lifecycleProvider?` | `ITaskLifecycleProvider` | Task lifecycle event callbacks |
+| `workerProvider?` | `IWorkerLifecycleProvider` | Worker/consumer lifecycle event callbacks |
+| `lifecycle?` | `TaskHandlerLifecycleConfig` | Callback mode (`sync`/`async`), heartbeat interval, payload inclusion |
+| `entityProjection?` | `IEntityProjectionProvider` | Entity-task projection provider (RFC-003) |
+| `entityProjectionConfig?` | `EntityProjectionConfig` | Projection options (`includePayload`) |
+| `flowBarrierProvider?` | `IFlowBarrierProvider` | Flow barrier provider — enables flow orchestration (RFC-002) |
+| `flowLifecycleProvider?` | `IFlowLifecycleProvider` | Flow lifecycle events (requires `flowBarrierProvider`) |
+
+### Supporting Types
+
+| Type | Fields | Description |
+|------|--------|-------------|
+| `TaskContext` | `task_id, task_hash?, task_type, queue_id, payload, attempt, max_retries, scheduled_at, worker_id?, consumer_id?, log_context?` | Core task identity passed to all lifecycle callbacks |
+| `TaskTiming` | `queued_duration_ms, processing_duration_ms, total_duration_ms` | Timing breakdown for completed/failed tasks |
+| `WorkerInfo` | `worker_id, hostname, pid, started_at, enabled_queues` | Worker process identity |
+| `WorkerStats` | `tasks_processed, tasks_succeeded, tasks_failed, avg_processing_ms, current_task?` | Aggregate worker metrics |
+| `ConsumerInfo` | `consumer_id, queue_id, worker_id, started_at` | Consumer stream identity |
+| `ConsumerStats` | `consumer_id, queue_id, tasks_processed, tasks_succeeded, tasks_failed, last_task_at?` | Per-consumer metrics |
+| `FlowContext` | `flow_id, total_steps, join, failure_policy, entity?, worker_id, consumer_id?` | Flow identity for lifecycle events |
+| `FlowStepResult` | `step_index, status, result?, error?` | Individual step outcome in barrier |
+| `BarrierDecrementResult` | `remaining` | `0` = barrier met, `>0` = pending, `-1` = already complete/aborted |
+
 ## Error Handling and Retries
 
 ```typescript

package/dist/{AsyncActions-CZYO8ShR.js → AsyncActions-B8ImDgTo.js}

@@ -207,8 +207,17 @@ class AsyncActions {
         const executor = this.taskQueue.getExecutor(task.queue_id, task.type);
         const shouldStoreOnFailure = executor?.store_on_failure ?? false;
         const id = shouldStoreOnFailure ? { id: this.generateId() } : {};
-        return { ...id, ...task };
+        const partitionKey = executor?.getPartitionKey?.(task);
+        return { ...id, ...task, ...partitionKey ? { partition_key: partitionKey } : {} };
       });
+      if (this.entityProjection) {
+        try {
+          const projections = queueTasks.filter((t) => t.entity).map((t) => buildProjection(t, "scheduled", { includePayload: this.entityProjectionConfig?.includePayload })).filter((p) => p !== null);
+          await syncProjections(projections, this.entityProjection, logger);
+        } catch (err) {
+          logger.error(`[AsyncActions] Entity projection failed (non-fatal): ${err}`);
+        }
+      }
       try {
         await this.messageQueue.addMessages(queue, queueTasks);
         logger.info(`[AsyncActions] Added ${queueTasks.length} immediate tasks to queue ${queue}`);
@@ -216,14 +225,32 @@ class AsyncActions {
         logger.error(`[AsyncActions] Failed to add tasks to queue ${queue}:`, err);
         throw err;
       }
+      if (this.lifecycleEmitter?.onScheduled) {
+        for (const task of queueTasks) {
+          try {
+            this.lifecycleEmitter.onScheduled(task);
+          } catch (err) {
+            logger.error(`[AsyncActions] Lifecycle onScheduled error:`, err);
+          }
+        }
+      }
     }
     if (future.length > 0) {
       const futureTasks = future.map((task) => {
         const executor = this.taskQueue.getExecutor(task.queue_id, task.type);
         const shouldStoreOnFailure = executor?.store_on_failure ?? false;
         const id = shouldStoreOnFailure ? { id: this.generateId() } : {};
-        return { ...id, ...task };
+        const partitionKey = executor?.getPartitionKey?.(task);
+        return { ...id, ...task, ...partitionKey ? { partition_key: partitionKey } : {} };
       });
+      if (this.entityProjection) {
+        try {
+          const projections = futureTasks.filter((t) => t.entity).map((t) => buildProjection(t, "scheduled", { includePayload: this.entityProjectionConfig?.includePayload })).filter((p) => p !== null);
+          await syncProjections(projections, this.entityProjection, logger);
+        } catch (err) {
+          logger.error(`[AsyncActions] Entity projection failed (non-fatal): ${err}`);
+        }
+      }
       try {
         await this.taskStore.addTasksToScheduled(futureTasks);
         logger.info(`[AsyncActions] Added ${futureTasks.length} future tasks to database`);
@@ -231,6 +258,15 @@ class AsyncActions {
         logger.error(`[AsyncActions] Failed to add tasks to database:`, err);
         throw err;
       }
+      if (this.lifecycleEmitter?.onScheduled) {
+        for (const task of futureTasks) {
+          try {
+            this.lifecycleEmitter.onScheduled(task);
+          } catch (err) {
+            logger.error(`[AsyncActions] Lifecycle onScheduled error:`, err);
+          }
+        }
+      }
     }
   }
 }
@@ -239,4 +275,4 @@ export {
   buildProjection as b,
   syncProjections as s
 };
-//# sourceMappingURL=AsyncActions-CZYO8ShR.js.map
+//# sourceMappingURL=AsyncActions-B8ImDgTo.js.map

package/dist/AsyncActions-B8ImDgTo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncActions-B8ImDgTo.js","sources":["../src/core/async/retry-utils.ts","../src/core/entity/IEntityProjectionProvider.ts","../src/core/async/AsyncActions.ts"],"sourcesContent":["import {CronTask} from \"../../adapters\";\n\nconst MAX_RETRY_DELAY_MS = 5 * 60 * 1000; // 5 minutes\n\nexport interface RetryDecision<ID = any> {\n    action: 'retry' | 'fail';\n    retryTask?: CronTask<ID>;\n}\n\n/**\n * Compute whether a failed task should be retried and produce the retry-ready task.\n *\n * Mirrors the logic in TaskHandler.postProcessTasks() but usable from the async path.\n *\n * @param task       The failed task\n * @param maxRetries Maximum retry attempts for this task type\n * @returns RetryDecision — either { action: 'retry', retryTask } or { action: 'fail' }\n */\nexport function computeRetryDecision<ID>(\n    task: CronTask<ID>,\n    maxRetries: number\n): RetryDecision<ID> {\n    const retryCount = (task.execution_stats && typeof task.execution_stats.retry_count === 'number')\n        ? task.execution_stats.retry_count\n        : 0;\n\n    if (retryCount >= maxRetries) {\n        return {action: 'fail'};\n    }\n\n    const taskRetryAfter = Math.max(task.retry_after || 2000, 0);\n    const calculatedDelay = taskRetryAfter * Math.pow(retryCount + 1, 2);\n    const retryAfter = Math.min(calculatedDelay, MAX_RETRY_DELAY_MS);\n    const executeAt = Date.now() + retryAfter;\n\n    return {\n        action: 'retry',\n        retryTask: {\n            ...task,\n            status: 'scheduled' as const,\n            execute_at: new Date(executeAt),\n            execution_stats: {\n                ...(task.execution_stats || {}),\n                retry_count: retryCount + 1\n            }\n        }\n    };\n}\n","/**\n * RFC-003: Entity Task Projection\n *\n * Automatic entity-task status projection so dashboards can track\n * task lifecycle without querying the internal tasks table.\n */\n\nimport type {CronTask} from \"../../adapters/types.js\";\n\nexport type EntityTaskProjectionStatus = 'scheduled' | 'processing' | 'executed' | 'failed';\n\nexport interface EntityTaskProjection<ID = any> {\n    task_id: ID;\n    entity_id: string;\n    entity_type: string;\n    task_type: string;\n    queue_id: string;\n    status: EntityTaskProjectionStatus;\n    payload?: unknown;\n    error?: string;\n    result?: unknown;\n    created_at: Date;\n    updated_at: Date;\n}\n\n/**\n * Provider interface for persisting entity-task projections.\n * Implementations might write to a database table, cache, or external service.\n */\nexport interface IEntityProjectionProvider<ID = any> {\n    upsertProjections(entries: EntityTaskProjection<ID>[]): Promise<void>;\n}\n\n/**\n * Configuration for entity projection behavior.\n */\nexport interface EntityProjectionConfig {\n    /** Include task payload in projection (default: false for performance) */\n    includePayload?: boolean;\n}\n\n/**\n * Sync entity projections to the provider. Non-fatal — logs and continues on error.\n */\nexport async function syncProjections<ID>(\n    projections: EntityTaskProjection<ID>[],\n    provider: IEntityProjectionProvider<ID> | undefined,\n    logger: { error(msg: string): void }\n): Promise<void> {\n    if (projections.length === 0 || !provider) return;\n    try {\n        await provider.upsertProjections(projections);\n    } catch (err) {\n        logger.error(`[TQ] Entity projection sync failed (non-fatal): ${err}`);\n    }\n}\n\n/**\n * Build a single projection entry from a CronTask and target status.\n * Returns null if the task has no entity binding.\n * Throws if entity is present but task has no ID — fail-fast for developer errors.\n */\nexport function buildProjection<ID>(\n    task: CronTask<ID>,\n    status: EntityTaskProjectionStatus,\n    options?: {\n        includePayload?: boolean;\n        error?: string;\n        result?: unknown;\n    }\n): EntityTaskProjection<ID> | null {\n    if (!task.entity) return null;\n\n    if (task.id == null) {\n        throw new Error(\n            `[TQ/RFC-003] Task with entity (${task.entity.type}:${task.entity.id}) has no task ID. ` +\n            `Entity-bearing tasks must have an ID for projection keying. ` +\n            `Set store_on_failure:true, force_store:true, or assign an ID before addTasks().`\n        );\n    }\n\n    return {\n        task_id: task.id,\n        entity_id: task.entity.id,\n        entity_type: task.entity.type,\n        task_type: task.type,\n        queue_id: task.queue_id,\n        status,\n        payload: options?.includePayload ? task.payload : undefined,\n        error: options?.error,\n        result: options?.result,\n        created_at: task.created_at || new Date(),\n        updated_at: new Date(),\n    };\n}","import {Logger, LogLevel} from \"@supergrowthai/utils\";\nimport {TaskStore} from \"../TaskStore.js\";\nimport {Actions} from \"../Actions.js\";\nimport {IMessageQueue, QueueName} from \"@supergrowthai/mq\";\nimport {tId} from \"../../utils/task-id-gen.js\";\nimport {CronTask} from \"../../adapters\";\nimport {TaskQueuesManager} from \"../TaskQueuesManager.js\";\nimport {computeRetryDecision} from \"./retry-utils.js\";\nimport type {IEntityProjectionProvider, EntityProjectionConfig, EntityTaskProjection} from \"../entity/IEntityProjectionProvider.js\";\nimport {buildProjection, syncProjections} from \"../entity/IEntityProjectionProvider.js\";\nimport type {FlowMiddleware} from \"../flow/FlowMiddleware.js\";\n\nconst logger = new Logger('AsyncActions', LogLevel.INFO);\n\n/**\n * Interface for emitting async task lifecycle events.\n * Constructed from the sync-path's ITaskLifecycleProvider by TaskRunner.\n */\nexport interface AsyncLifecycleEmitter {\n    onCompleted(task: CronTask<any>, result?: unknown): void;\n    onFailed(task: CronTask<any>, error: Error, willRetry: boolean): void;\n    onScheduled?(task: CronTask<any>): void;\n}\n\nexport class AsyncActions<ID = any> {\n    private readonly actions: Actions<ID>;\n    private readonly taskId: string;\n\n    constructor(\n        private messageQueue: IMessageQueue<ID>,\n        private taskStore: TaskStore<ID>,\n        private taskQueue: TaskQueuesManager<ID>,\n        actions: Actions<ID>,\n        private task: CronTask<ID>,\n        private generateId: () => ID,\n        private lifecycleEmitter?: AsyncLifecycleEmitter,\n        private entityProjection?: IEntityProjectionProvider<ID>,\n        private entityProjectionConfig?: EntityProjectionConfig,\n        private flowMiddleware?: FlowMiddleware<ID>\n    ) {\n        this.actions = actions;\n        this.taskId = tId(task);\n    }\n\n    /**\n     * Called when the async promise completes to execute the collected actions\n     */\n    async onPromiseFulfilled(): Promise<void> {\n        // Extract this task's results (NO batch context for async tasks)\n        const results = this.actions.extractTaskActions(this.taskId);\n\n        // If task didn't call success or fail, default to fail (forgetful executor)\n        const hasCompletion = results.successTasks.length > 0 || results.failedTasks.length > 0;\n        if (!hasCompletion) {\n            logger.warn(`Async task ${this.taskId} completed without calling success() or fail() — defaulting to fail`);\n            results.failedTasks.push({\n                ...this.task,\n                execution_stats: {\n                    ...(this.task.execution_stats || {}),\n                    last_error: `Async task ${this.taskId} completed without calling success() or fail()`,\n                }\n            });\n        }\n\n        logger.info(`[AsyncActions] Processing results for async task ${this.taskId}: ` +\n            `${results.successTasks.length} success, ${results.failedTasks.length} failed, ` +\n            `${results.newTasks.length} new tasks`);\n\n        // Process failed tasks with retry logic\n        if (results.failedTasks.length > 0) {\n            for (const failedTask of results.failedTasks) {\n                try {\n                    await this.processFailedTaskWithRetry(failedTask);\n                } catch (err) {\n                    logger.error(`[AsyncActions] Failed to process failed task:`, err);\n                    throw err;\n                }\n            }\n        }\n\n        if (results.successTasks.length > 0) {\n            try {\n                await this.taskStore.markTasksAsSuccess(results.successTasks);\n                logger.info(`[AsyncActions] Marked ${results.successTasks.length} tasks as success in database`);\n\n                // Emit lifecycle event for each success\n                if (this.lifecycleEmitter) {\n                    for (const task of results.successTasks) {\n                        try {\n                            this.lifecycleEmitter.onCompleted(task, task.execution_result);\n                        } catch (err) {\n                            logger.error(`[AsyncActions] Lifecycle onCompleted error:`, err);\n                        }\n                    }\n                }\n\n                // RFC-003: Emit 'executed' entity projections for async success tasks\n                await syncProjections(\n                    results.successTasks\n                        .map(t => buildProjection(t, 'executed', {\n                            includePayload: this.entityProjectionConfig?.includePayload,\n                            result: t.execution_result,\n                        }))\n                        .filter((p): p is EntityTaskProjection<ID> => p !== null),\n                    this.entityProjection,\n                    logger\n                );\n            } catch (err) {\n                logger.error(`[AsyncActions] Failed to mark tasks as success:`, err);\n                throw err;\n            }\n        }\n\n        // RFC-002: Flow middleware — process terminal tasks for barrier tracking and join dispatch\n        if (this.flowMiddleware) {\n            try {\n                // Collect final failures (not retries) for flow middleware\n                const finalFailedTasks: CronTask<ID>[] = [];\n                for (const failedTask of results.failedTasks) {\n                    const executor = this.taskQueue.getExecutor(failedTask.queue_id, failedTask.type);\n                    const maxRetries = failedTask.retries ?? executor?.default_retries ?? 0;\n                    const decision = computeRetryDecision(failedTask, maxRetries);\n                    // Only include final failures (no more retries)\n                    if (decision.action !== 'retry' || !decision.retryTask) {\n                        finalFailedTasks.push(failedTask);\n                    }\n                }\n\n                if (results.successTasks.length > 0 || finalFailedTasks.length > 0) {\n                    const flowResult = await this.flowMiddleware.onPostProcess({\n                        successTasks: results.successTasks,\n                        failedTasks: finalFailedTasks,\n                    });\n\n                    if (flowResult.projections.length > 0 && this.entityProjection) {\n                        await syncProjections(flowResult.projections, this.entityProjection, logger);\n                    }\n\n                    if (flowResult.joinTasks.length > 0) {\n                        await this.scheduleNewTasks(flowResult.joinTasks);\n                    }\n                }\n            } catch (err) {\n                logger.error(`[AsyncActions] Flow middleware failed (non-fatal): ${err}`);\n            }\n        }\n\n        if (results.newTasks.length > 0) {\n            logger.info(`[AsyncActions] Scheduling ${results.newTasks.length} new tasks`);\n            await this.scheduleNewTasks(results.newTasks);\n        }\n    }\n\n    /**\n     * Process a failed task through the retry pipeline\n     */\n    private async processFailedTaskWithRetry(failedTask: CronTask<ID>): Promise<void> {\n        const executor = this.taskQueue.getExecutor(failedTask.queue_id, failedTask.type);\n        const maxRetries = failedTask.retries ?? executor?.default_retries ?? 0;\n        const decision = computeRetryDecision(failedTask, maxRetries);\n        const willRetry = decision.action === 'retry' && !!decision.retryTask;\n\n        if (willRetry) {\n            logger.info(`[AsyncActions] Retrying async task ${this.taskId} (attempt ${(decision.retryTask!.execution_stats?.retry_count as number) || 0})`);\n            await this.taskStore.updateTasksForRetry([decision.retryTask!]);\n        } else {\n            logger.info(`[AsyncActions] Async task ${this.taskId} exhausted retries, marking as failed`);\n            await this.taskStore.markTasksAsFailed([failedTask]);\n\n            // RFC-003: Emit 'failed' entity projection for final-failed async tasks\n            const errorMsg = failedTask.execution_stats?.last_error as string || 'Task failed';\n            const p = buildProjection(failedTask, 'failed', {\n                includePayload: this.entityProjectionConfig?.includePayload,\n                error: errorMsg,\n            });\n            if (p) await syncProjections([p], this.entityProjection, logger);\n        }\n\n        if (this.lifecycleEmitter) {\n            const errorMsg = failedTask.execution_stats?.last_error as string || 'Task failed';\n            try {\n                this.lifecycleEmitter.onFailed(failedTask, new Error(errorMsg), willRetry);\n            } catch (err) {\n                logger.error(`[AsyncActions] Lifecycle onFailed error:`, err);\n            }\n        }\n    }\n\n    /**\n     * Schedule new tasks - replicates the logic from task-handler's addTasks\n     */\n    private async scheduleNewTasks(tasks: CronTask<ID>[]): Promise<void> {\n        const now = new Date();\n        const immediate: { [key in QueueName]?: CronTask<ID>[] } = {};\n        const future: CronTask<ID>[] = [];\n\n        // Split tasks by timing\n        for (const task of tasks) {\n            const timeDiff = (task.execute_at.getTime() - now.getTime()) / 1000 / 60; // in minutes\n\n            if (timeDiff > 2) {\n                // Future task - goes to database\n                future.push(task);\n            } else {\n                // Immediate task - goes to message queue\n                const queue = task.queue_id;\n                if (!immediate[queue]) {\n                    immediate[queue] = [];\n                }\n                immediate[queue].push(task);\n            }\n        }\n\n        // Process immediate tasks\n        const iQueues = Object.keys(immediate) as QueueName[];\n        for (const queue of iQueues) {\n            const queueTasks = immediate[queue]!.map((task) => {\n                const executor = this.taskQueue.getExecutor(task.queue_id, task.type);\n                const shouldStoreOnFailure = executor?.store_on_failure ?? false;\n                const id = shouldStoreOnFailure ? {id: this.generateId()} : {};\n                const partitionKey = executor?.getPartitionKey?.(task);\n                return {...id, ...task, ...(partitionKey ? {partition_key: partitionKey} : {})};\n            });\n\n            // Entity projections for scheduled tasks (mirrors TaskHandler.addTasks pattern)\n            if (this.entityProjection) {\n                try {\n                    const projections = queueTasks\n                        .filter(t => t.entity)\n                        .map(t => buildProjection(t, 'scheduled', {includePayload: this.entityProjectionConfig?.includePayload}))\n                        .filter((p): p is EntityTaskProjection<ID> => p !== null);\n                    await syncProjections(projections, this.entityProjection, logger);\n                } catch (err) {\n                    logger.error(`[AsyncActions] Entity projection failed (non-fatal): ${err}`);\n                }\n            }\n\n            try {\n                await this.messageQueue.addMessages(queue, queueTasks as CronTask<ID>[]);\n                logger.info(`[AsyncActions] Added ${queueTasks.length} immediate tasks to queue ${queue}`);\n            } catch (err) {\n                logger.error(`[AsyncActions] Failed to add tasks to queue ${queue}:`, err);\n                throw err;\n            }\n\n            // Emit onScheduled lifecycle event for each task\n            if (this.lifecycleEmitter?.onScheduled) {\n                for (const task of queueTasks) {\n                    try {\n                        this.lifecycleEmitter.onScheduled(task);\n                    } catch (err) {\n                        logger.error(`[AsyncActions] Lifecycle onScheduled error:`, err);\n                    }\n                }\n            }\n        }\n\n        // Process future tasks\n        if (future.length > 0) {\n            const futureTasks = future.map((task) => {\n                const executor = this.taskQueue.getExecutor(task.queue_id, task.type);\n                const shouldStoreOnFailure = executor?.store_on_failure ?? false;\n                const id = shouldStoreOnFailure ? {id: this.generateId()} : {};\n                const partitionKey = executor?.getPartitionKey?.(task);\n                return {...id, ...task, ...(partitionKey ? {partition_key: partitionKey} : {})};\n            });\n\n            // Entity projections for future scheduled tasks\n            if (this.entityProjection) {\n                try {\n                    const projections = futureTasks\n                        .filter(t => t.entity)\n                        .map(t => buildProjection(t, 'scheduled', {includePayload: this.entityProjectionConfig?.includePayload}))\n                        .filter((p): p is EntityTaskProjection<ID> => p !== null);\n                    await syncProjections(projections, this.entityProjection, logger);\n                } catch (err) {\n                    logger.error(`[AsyncActions] Entity projection failed (non-fatal): ${err}`);\n                }\n            }\n\n            try {\n                await this.taskStore.addTasksToScheduled(futureTasks);\n                logger.info(`[AsyncActions] Added ${futureTasks.length} future tasks to database`);\n            } catch (err) {\n                logger.error(`[AsyncActions] Failed to add tasks to database:`, err);\n                throw err;\n            }\n\n            // Emit onScheduled lifecycle event for future tasks\n            if (this.lifecycleEmitter?.onScheduled) {\n                for (const task of futureTasks) {\n                    try {\n                        this.lifecycleEmitter.onScheduled(task);\n                    } catch (err) {\n                        logger.error(`[AsyncActions] Lifecycle onScheduled error:`, err);\n                    }\n                }\n            }\n        }\n    }\n}\n"],"names":["logger"],"mappings":"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"}

package/dist/{AsyncActions-BOO1ikWz.cjs → AsyncActions-BsxMX_Ib.cjs}

@@ -208,8 +208,17 @@ class AsyncActions {
         const executor = this.taskQueue.getExecutor(task.queue_id, task.type);
         const shouldStoreOnFailure = executor?.store_on_failure ?? false;
         const id = shouldStoreOnFailure ? { id: this.generateId() } : {};
-        return { ...id, ...task };
+        const partitionKey = executor?.getPartitionKey?.(task);
+        return { ...id, ...task, ...partitionKey ? { partition_key: partitionKey } : {} };
       });
+      if (this.entityProjection) {
+        try {
+          const projections = queueTasks.filter((t) => t.entity).map((t) => buildProjection(t, "scheduled", { includePayload: this.entityProjectionConfig?.includePayload })).filter((p) => p !== null);
+          await syncProjections(projections, this.entityProjection, logger);
+        } catch (err) {
+          logger.error(`[AsyncActions] Entity projection failed (non-fatal): ${err}`);
+        }
+      }
       try {
         await this.messageQueue.addMessages(queue, queueTasks);
         logger.info(`[AsyncActions] Added ${queueTasks.length} immediate tasks to queue ${queue}`);
@@ -217,14 +226,32 @@ class AsyncActions {
         logger.error(`[AsyncActions] Failed to add tasks to queue ${queue}:`, err);
         throw err;
       }
+      if (this.lifecycleEmitter?.onScheduled) {
+        for (const task of queueTasks) {
+          try {
+            this.lifecycleEmitter.onScheduled(task);
+          } catch (err) {
+            logger.error(`[AsyncActions] Lifecycle onScheduled error:`, err);
+          }
+        }
+      }
     }
     if (future.length > 0) {
       const futureTasks = future.map((task) => {
         const executor = this.taskQueue.getExecutor(task.queue_id, task.type);
         const shouldStoreOnFailure = executor?.store_on_failure ?? false;
         const id = shouldStoreOnFailure ? { id: this.generateId() } : {};
-        return { ...id, ...task };
+        const partitionKey = executor?.getPartitionKey?.(task);
+        return { ...id, ...task, ...partitionKey ? { partition_key: partitionKey } : {} };
       });
+      if (this.entityProjection) {
+        try {
+          const projections = futureTasks.filter((t) => t.entity).map((t) => buildProjection(t, "scheduled", { includePayload: this.entityProjectionConfig?.includePayload })).filter((p) => p !== null);
+          await syncProjections(projections, this.entityProjection, logger);
+        } catch (err) {
+          logger.error(`[AsyncActions] Entity projection failed (non-fatal): ${err}`);
+        }
+      }
       try {
         await this.taskStore.addTasksToScheduled(futureTasks);
         logger.info(`[AsyncActions] Added ${futureTasks.length} future tasks to database`);
@@ -232,10 +259,19 @@ class AsyncActions {
         logger.error(`[AsyncActions] Failed to add tasks to database:`, err);
         throw err;
       }
+      if (this.lifecycleEmitter?.onScheduled) {
+        for (const task of futureTasks) {
+          try {
+            this.lifecycleEmitter.onScheduled(task);
+          } catch (err) {
+            logger.error(`[AsyncActions] Lifecycle onScheduled error:`, err);
+          }
+        }
+      }
     }
   }
 }
 exports.AsyncActions = AsyncActions;
 exports.buildProjection = buildProjection;
 exports.syncProjections = syncProjections;
-//# sourceMappingURL=AsyncActions-BOO1ikWz.cjs.map
+//# sourceMappingURL=AsyncActions-BsxMX_Ib.cjs.map

package/dist/AsyncActions-BsxMX_Ib.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncActions-BsxMX_Ib.cjs","sources":["../src/core/async/retry-utils.ts","../src/core/entity/IEntityProjectionProvider.ts","../src/core/async/AsyncActions.ts"],"sourcesContent":["import {CronTask} from \"../../adapters\";\n\nconst MAX_RETRY_DELAY_MS = 5 * 60 * 1000; // 5 minutes\n\nexport interface RetryDecision<ID = any> {\n    action: 'retry' | 'fail';\n    retryTask?: CronTask<ID>;\n}\n\n/**\n * Compute whether a failed task should be retried and produce the retry-ready task.\n *\n * Mirrors the logic in TaskHandler.postProcessTasks() but usable from the async path.\n *\n * @param task       The failed task\n * @param maxRetries Maximum retry attempts for this task type\n * @returns RetryDecision — either { action: 'retry', retryTask } or { action: 'fail' }\n */\nexport function computeRetryDecision<ID>(\n    task: CronTask<ID>,\n    maxRetries: number\n): RetryDecision<ID> {\n    const retryCount = (task.execution_stats && typeof task.execution_stats.retry_count === 'number')\n        ? task.execution_stats.retry_count\n        : 0;\n\n    if (retryCount >= maxRetries) {\n        return {action: 'fail'};\n    }\n\n    const taskRetryAfter = Math.max(task.retry_after || 2000, 0);\n    const calculatedDelay = taskRetryAfter * Math.pow(retryCount + 1, 2);\n    const retryAfter = Math.min(calculatedDelay, MAX_RETRY_DELAY_MS);\n    const executeAt = Date.now() + retryAfter;\n\n    return {\n        action: 'retry',\n        retryTask: {\n            ...task,\n            status: 'scheduled' as const,\n            execute_at: new Date(executeAt),\n            execution_stats: {\n                ...(task.execution_stats || {}),\n                retry_count: retryCount + 1\n            }\n        }\n    };\n}\n","/**\n * RFC-003: Entity Task Projection\n *\n * Automatic entity-task status projection so dashboards can track\n * task lifecycle without querying the internal tasks table.\n */\n\nimport type {CronTask} from \"../../adapters/types.js\";\n\nexport type EntityTaskProjectionStatus = 'scheduled' | 'processing' | 'executed' | 'failed';\n\nexport interface EntityTaskProjection<ID = any> {\n    task_id: ID;\n    entity_id: string;\n    entity_type: string;\n    task_type: string;\n    queue_id: string;\n    status: EntityTaskProjectionStatus;\n    payload?: unknown;\n    error?: string;\n    result?: unknown;\n    created_at: Date;\n    updated_at: Date;\n}\n\n/**\n * Provider interface for persisting entity-task projections.\n * Implementations might write to a database table, cache, or external service.\n */\nexport interface IEntityProjectionProvider<ID = any> {\n    upsertProjections(entries: EntityTaskProjection<ID>[]): Promise<void>;\n}\n\n/**\n * Configuration for entity projection behavior.\n */\nexport interface EntityProjectionConfig {\n    /** Include task payload in projection (default: false for performance) */\n    includePayload?: boolean;\n}\n\n/**\n * Sync entity projections to the provider. Non-fatal — logs and continues on error.\n */\nexport async function syncProjections<ID>(\n    projections: EntityTaskProjection<ID>[],\n    provider: IEntityProjectionProvider<ID> | undefined,\n    logger: { error(msg: string): void }\n): Promise<void> {\n    if (projections.length === 0 || !provider) return;\n    try {\n        await provider.upsertProjections(projections);\n    } catch (err) {\n        logger.error(`[TQ] Entity projection sync failed (non-fatal): ${err}`);\n    }\n}\n\n/**\n * Build a single projection entry from a CronTask and target status.\n * Returns null if the task has no entity binding.\n * Throws if entity is present but task has no ID — fail-fast for developer errors.\n */\nexport function buildProjection<ID>(\n    task: CronTask<ID>,\n    status: EntityTaskProjectionStatus,\n    options?: {\n        includePayload?: boolean;\n        error?: string;\n        result?: unknown;\n    }\n): EntityTaskProjection<ID> | null {\n    if (!task.entity) return null;\n\n    if (task.id == null) {\n        throw new Error(\n            `[TQ/RFC-003] Task with entity (${task.entity.type}:${task.entity.id}) has no task ID. ` +\n            `Entity-bearing tasks must have an ID for projection keying. ` +\n            `Set store_on_failure:true, force_store:true, or assign an ID before addTasks().`\n        );\n    }\n\n    return {\n        task_id: task.id,\n        entity_id: task.entity.id,\n        entity_type: task.entity.type,\n        task_type: task.type,\n        queue_id: task.queue_id,\n        status,\n        payload: options?.includePayload ? task.payload : undefined,\n        error: options?.error,\n        result: options?.result,\n        created_at: task.created_at || new Date(),\n        updated_at: new Date(),\n    };\n}","import {Logger, LogLevel} from \"@supergrowthai/utils\";\nimport {TaskStore} from \"../TaskStore.js\";\nimport {Actions} from \"../Actions.js\";\nimport {IMessageQueue, QueueName} from \"@supergrowthai/mq\";\nimport {tId} from \"../../utils/task-id-gen.js\";\nimport {CronTask} from \"../../adapters\";\nimport {TaskQueuesManager} from \"../TaskQueuesManager.js\";\nimport {computeRetryDecision} from \"./retry-utils.js\";\nimport type {IEntityProjectionProvider, EntityProjectionConfig, EntityTaskProjection} from \"../entity/IEntityProjectionProvider.js\";\nimport {buildProjection, syncProjections} from \"../entity/IEntityProjectionProvider.js\";\nimport type {FlowMiddleware} from \"../flow/FlowMiddleware.js\";\n\nconst logger = new Logger('AsyncActions', LogLevel.INFO);\n\n/**\n * Interface for emitting async task lifecycle events.\n * Constructed from the sync-path's ITaskLifecycleProvider by TaskRunner.\n */\nexport interface AsyncLifecycleEmitter {\n    onCompleted(task: CronTask<any>, result?: unknown): void;\n    onFailed(task: CronTask<any>, error: Error, willRetry: boolean): void;\n    onScheduled?(task: CronTask<any>): void;\n}\n\nexport class AsyncActions<ID = any> {\n    private readonly actions: Actions<ID>;\n    private readonly taskId: string;\n\n    constructor(\n        private messageQueue: IMessageQueue<ID>,\n        private taskStore: TaskStore<ID>,\n        private taskQueue: TaskQueuesManager<ID>,\n        actions: Actions<ID>,\n        private task: CronTask<ID>,\n        private generateId: () => ID,\n        private lifecycleEmitter?: AsyncLifecycleEmitter,\n        private entityProjection?: IEntityProjectionProvider<ID>,\n        private entityProjectionConfig?: EntityProjectionConfig,\n        private flowMiddleware?: FlowMiddleware<ID>\n    ) {\n        this.actions = actions;\n        this.taskId = tId(task);\n    }\n\n    /**\n     * Called when the async promise completes to execute the collected actions\n     */\n    async onPromiseFulfilled(): Promise<void> {\n        // Extract this task's results (NO batch context for async tasks)\n        const results = this.actions.extractTaskActions(this.taskId);\n\n        // If task didn't call success or fail, default to fail (forgetful executor)\n        const hasCompletion = results.successTasks.length > 0 || results.failedTasks.length > 0;\n        if (!hasCompletion) {\n            logger.warn(`Async task ${this.taskId} completed without calling success() or fail() — defaulting to fail`);\n            results.failedTasks.push({\n                ...this.task,\n                execution_stats: {\n                    ...(this.task.execution_stats || {}),\n                    last_error: `Async task ${this.taskId} completed without calling success() or fail()`,\n                }\n            });\n        }\n\n        logger.info(`[AsyncActions] Processing results for async task ${this.taskId}: ` +\n            `${results.successTasks.length} success, ${results.failedTasks.length} failed, ` +\n            `${results.newTasks.length} new tasks`);\n\n        // Process failed tasks with retry logic\n        if (results.failedTasks.length > 0) {\n            for (const failedTask of results.failedTasks) {\n                try {\n                    await this.processFailedTaskWithRetry(failedTask);\n                } catch (err) {\n                    logger.error(`[AsyncActions] Failed to process failed task:`, err);\n                    throw err;\n                }\n            }\n        }\n\n        if (results.successTasks.length > 0) {\n            try {\n                await this.taskStore.markTasksAsSuccess(results.successTasks);\n                logger.info(`[AsyncActions] Marked ${results.successTasks.length} tasks as success in database`);\n\n                // Emit lifecycle event for each success\n                if (this.lifecycleEmitter) {\n                    for (const task of results.successTasks) {\n                        try {\n                            this.lifecycleEmitter.onCompleted(task, task.execution_result);\n                        } catch (err) {\n                            logger.error(`[AsyncActions] Lifecycle onCompleted error:`, err);\n                        }\n                    }\n                }\n\n                // RFC-003: Emit 'executed' entity projections for async success tasks\n                await syncProjections(\n                    results.successTasks\n                        .map(t => buildProjection(t, 'executed', {\n                            includePayload: this.entityProjectionConfig?.includePayload,\n                            result: t.execution_result,\n                        }))\n                        .filter((p): p is EntityTaskProjection<ID> => p !== null),\n                    this.entityProjection,\n                    logger\n                );\n            } catch (err) {\n                logger.error(`[AsyncActions] Failed to mark tasks as success:`, err);\n                throw err;\n            }\n        }\n\n        // RFC-002: Flow middleware — process terminal tasks for barrier tracking and join dispatch\n        if (this.flowMiddleware) {\n            try {\n                // Collect final failures (not retries) for flow middleware\n                const finalFailedTasks: CronTask<ID>[] = [];\n                for (const failedTask of results.failedTasks) {\n                    const executor = this.taskQueue.getExecutor(failedTask.queue_id, failedTask.type);\n                    const maxRetries = failedTask.retries ?? executor?.default_retries ?? 0;\n                    const decision = computeRetryDecision(failedTask, maxRetries);\n                    // Only include final failures (no more retries)\n                    if (decision.action !== 'retry' || !decision.retryTask) {\n                        finalFailedTasks.push(failedTask);\n                    }\n                }\n\n                if (results.successTasks.length > 0 || finalFailedTasks.length > 0) {\n                    const flowResult = await this.flowMiddleware.onPostProcess({\n                        successTasks: results.successTasks,\n                        failedTasks: finalFailedTasks,\n                    });\n\n                    if (flowResult.projections.length > 0 && this.entityProjection) {\n                        await syncProjections(flowResult.projections, this.entityProjection, logger);\n                    }\n\n                    if (flowResult.joinTasks.length > 0) {\n                        await this.scheduleNewTasks(flowResult.joinTasks);\n                    }\n                }\n            } catch (err) {\n                logger.error(`[AsyncActions] Flow middleware failed (non-fatal): ${err}`);\n            }\n        }\n\n        if (results.newTasks.length > 0) {\n            logger.info(`[AsyncActions] Scheduling ${results.newTasks.length} new tasks`);\n            await this.scheduleNewTasks(results.newTasks);\n        }\n    }\n\n    /**\n     * Process a failed task through the retry pipeline\n     */\n    private async processFailedTaskWithRetry(failedTask: CronTask<ID>): Promise<void> {\n        const executor = this.taskQueue.getExecutor(failedTask.queue_id, failedTask.type);\n        const maxRetries = failedTask.retries ?? executor?.default_retries ?? 0;\n        const decision = computeRetryDecision(failedTask, maxRetries);\n        const willRetry = decision.action === 'retry' && !!decision.retryTask;\n\n        if (willRetry) {\n            logger.info(`[AsyncActions] Retrying async task ${this.taskId} (attempt ${(decision.retryTask!.execution_stats?.retry_count as number) || 0})`);\n            await this.taskStore.updateTasksForRetry([decision.retryTask!]);\n        } else {\n            logger.info(`[AsyncActions] Async task ${this.taskId} exhausted retries, marking as failed`);\n            await this.taskStore.markTasksAsFailed([failedTask]);\n\n            // RFC-003: Emit 'failed' entity projection for final-failed async tasks\n            const errorMsg = failedTask.execution_stats?.last_error as string || 'Task failed';\n            const p = buildProjection(failedTask, 'failed', {\n                includePayload: this.entityProjectionConfig?.includePayload,\n                error: errorMsg,\n            });\n            if (p) await syncProjections([p], this.entityProjection, logger);\n        }\n\n        if (this.lifecycleEmitter) {\n            const errorMsg = failedTask.execution_stats?.last_error as string || 'Task failed';\n            try {\n                this.lifecycleEmitter.onFailed(failedTask, new Error(errorMsg), willRetry);\n            } catch (err) {\n                logger.error(`[AsyncActions] Lifecycle onFailed error:`, err);\n            }\n        }\n    }\n\n    /**\n     * Schedule new tasks - replicates the logic from task-handler's addTasks\n     */\n    private async scheduleNewTasks(tasks: CronTask<ID>[]): Promise<void> {\n        const now = new Date();\n        const immediate: { [key in QueueName]?: CronTask<ID>[] } = {};\n        const future: CronTask<ID>[] = [];\n\n        // Split tasks by timing\n        for (const task of tasks) {\n            const timeDiff = (task.execute_at.getTime() - now.getTime()) / 1000 / 60; // in minutes\n\n            if (timeDiff > 2) {\n                // Future task - goes to database\n                future.push(task);\n            } else {\n                // Immediate task - goes to message queue\n                const queue = task.queue_id;\n                if (!immediate[queue]) {\n                    immediate[queue] = [];\n                }\n                immediate[queue].push(task);\n            }\n        }\n\n        // Process immediate tasks\n        const iQueues = Object.keys(immediate) as QueueName[];\n        for (const queue of iQueues) {\n            const queueTasks = immediate[queue]!.map((task) => {\n                const executor = this.taskQueue.getExecutor(task.queue_id, task.type);\n                const shouldStoreOnFailure = executor?.store_on_failure ?? false;\n                const id = shouldStoreOnFailure ? {id: this.generateId()} : {};\n                const partitionKey = executor?.getPartitionKey?.(task);\n                return {...id, ...task, ...(partitionKey ? {partition_key: partitionKey} : {})};\n            });\n\n            // Entity projections for scheduled tasks (mirrors TaskHandler.addTasks pattern)\n            if (this.entityProjection) {\n                try {\n                    const projections = queueTasks\n                        .filter(t => t.entity)\n                        .map(t => buildProjection(t, 'scheduled', {includePayload: this.entityProjectionConfig?.includePayload}))\n                        .filter((p): p is EntityTaskProjection<ID> => p !== null);\n                    await syncProjections(projections, this.entityProjection, logger);\n                } catch (err) {\n                    logger.error(`[AsyncActions] Entity projection failed (non-fatal): ${err}`);\n                }\n            }\n\n            try {\n                await this.messageQueue.addMessages(queue, queueTasks as CronTask<ID>[]);\n                logger.info(`[AsyncActions] Added ${queueTasks.length} immediate tasks to queue ${queue}`);\n            } catch (err) {\n                logger.error(`[AsyncActions] Failed to add tasks to queue ${queue}:`, err);\n                throw err;\n            }\n\n            // Emit onScheduled lifecycle event for each task\n            if (this.lifecycleEmitter?.onScheduled) {\n                for (const task of queueTasks) {\n                    try {\n                        this.lifecycleEmitter.onScheduled(task);\n                    } catch (err) {\n                        logger.error(`[AsyncActions] Lifecycle onScheduled error:`, err);\n                    }\n                }\n            }\n        }\n\n        // Process future tasks\n        if (future.length > 0) {\n            const futureTasks = future.map((task) => {\n                const executor = this.taskQueue.getExecutor(task.queue_id, task.type);\n                const shouldStoreOnFailure = executor?.store_on_failure ?? false;\n                const id = shouldStoreOnFailure ? {id: this.generateId()} : {};\n                const partitionKey = executor?.getPartitionKey?.(task);\n                return {...id, ...task, ...(partitionKey ? {partition_key: partitionKey} : {})};\n            });\n\n            // Entity projections for future scheduled tasks\n            if (this.entityProjection) {\n                try {\n                    const projections = futureTasks\n                        .filter(t => t.entity)\n                        .map(t => buildProjection(t, 'scheduled', {includePayload: this.entityProjectionConfig?.includePayload}))\n                        .filter((p): p is EntityTaskProjection<ID> => p !== null);\n                    await syncProjections(projections, this.entityProjection, logger);\n                } catch (err) {\n                    logger.error(`[AsyncActions] Entity projection failed (non-fatal): ${err}`);\n                }\n            }\n\n            try {\n                await this.taskStore.addTasksToScheduled(futureTasks);\n                logger.info(`[AsyncActions] Added ${futureTasks.length} future tasks to database`);\n            } catch (err) {\n                logger.error(`[AsyncActions] Failed to add tasks to database:`, err);\n                throw err;\n            }\n\n            // Emit onScheduled lifecycle event for future tasks\n            if (this.lifecycleEmitter?.onScheduled) {\n                for (const task of futureTasks) {\n                    try {\n                        this.lifecycleEmitter.onScheduled(task);\n                    } catch (err) {\n                        logger.error(`[AsyncActions] Lifecycle onScheduled error:`, err);\n                    }\n                }\n            }\n        }\n    }\n}\n"],"names":["logger","Logger","LogLevel","tId"],"mappings":"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"}

package/dist/core/Actions.cjs

@@ -38,10 +38,12 @@ function enrichTaskWithError(task, error, meta) {
   return task;
 }
 class Actions {
-  constructor(taskRunnerId) {
+  constructor(taskRunnerId, flowLifecycleProvider, workerId = "") {
     this.taskContexts = /* @__PURE__ */ new Map();
     this._flowProjections = [];
     this.taskRunnerId = taskRunnerId;
+    this.flowLifecycleProvider = flowLifecycleProvider;
+    this.workerId = workerId;
     this.log = logger.child({});
   }
   /**
@@ -233,6 +235,26 @@ class Actions {
       });
     }
     logger.info(`[${this.taskRunnerId}] Started flow ${flowId} with ${steps.length} steps, join: ${config.join.type}`);
+    if (this.flowLifecycleProvider?.onFlowStarted) {
+      try {
+        const result = this.flowLifecycleProvider.onFlowStarted({
+          flow_id: flowId,
+          total_steps: steps.length,
+          join: config.join,
+          failure_policy: failurePolicy,
+          entity: config.entity,
+          worker_id: this.workerId,
+          consumer_id: this.taskRunnerId,
+          started_at: now,
+          step_types: steps.map((s) => s.type)
+        });
+        if (result instanceof Promise) {
+          result.catch((err) => logger.error(`[TQ] Flow lifecycle onFlowStarted error: ${err}`));
+        }
+      } catch (err) {
+        logger.error(`[TQ] Flow lifecycle onFlowStarted error: ${err}`);
+      }
+    }
     return flowId;
   }
   /**