@lotiai/composer 0.2.0 → 0.2.1

package/dist/cli/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Composer CLI
+ *
+ * Command-line interface for the Composer framework.
+ * Reads configuration from composer.build-config.ts and provides commands for
+ * managing development workflows.
+ *
+ * Schedule synchronization is handled by the schedule-sync Lambda at deploy
+ * time and by the syncSchedulesViaLambda helper in @lotiai/composer, not via a
+ * CLI command. See packages/composer/src/internal/async/register-scripts/
+ * sync-schedules-via-lambda.ts and infrastructure/temporal/src/
+ * schedule-sync-handler.ts.
+ *
+ * Usage:
+ *   npx @lotiai/composer dev           # Start development watch mode
+ *   npx @lotiai/composer dev:up        # Start Temporal dev server
+ *   npx @lotiai/composer dev:down      # Stop Temporal dev server
+ *   npx @lotiai/composer profiles      # Resolve worker profile deployment topology
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/cli/index.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Composer CLI
+ *
+ * Command-line interface for the Composer framework.
+ * Reads configuration from composer.build-config.ts and provides commands for
+ * managing development workflows.
+ *
+ * Schedule synchronization is handled by the schedule-sync Lambda at deploy
+ * time and by the syncSchedulesViaLambda helper in @lotiai/composer, not via a
+ * CLI command. See packages/composer/src/internal/async/register-scripts/
+ * sync-schedules-via-lambda.ts and infrastructure/temporal/src/
+ * schedule-sync-handler.ts.
+ *
+ * Usage:
+ *   npx @lotiai/composer dev           # Start development watch mode
+ *   npx @lotiai/composer dev:up        # Start Temporal dev server
+ *   npx @lotiai/composer dev:down      # Stop Temporal dev server
+ *   npx @lotiai/composer profiles      # Resolve worker profile deployment topology
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const dev_1 = require("./commands/dev");
+const dev_temporal_1 = require("./commands/dev-temporal");
+const profiles_1 = require("./commands/profiles");
+void (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+    .scriptName("composer")
+    .usage("$0 <command> [options]")
+    .command(dev_1.devCommand)
+    .command(dev_temporal_1.devDownCommand)
+    .command(dev_temporal_1.devUpCommand)
+    .command(profiles_1.profilesCommand)
+    .demandCommand(1, "You must specify a command")
+    .strict()
+    .help()
+    .alias("h", "help")
+    .version()
+    .alias("v", "version")
+    .parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;AAEH,kDAA0B;AAC1B,2CAAwC;AACxC,wCAA4C;AAC5C,0DAAuE;AACvE,kDAAsD;AAEtD,KAAK,IAAA,eAAK,EAAC,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KAC9B,UAAU,CAAC,UAAU,CAAC;KACtB,KAAK,CAAC,wBAAwB,CAAC;KAC/B,OAAO,CAAC,gBAAU,CAAC;KACnB,OAAO,CAAC,6BAAc,CAAC;KACvB,OAAO,CAAC,2BAAY,CAAC;KACrB,OAAO,CAAC,0BAAe,CAAC;KACxB,aAAa,CAAC,CAAC,EAAE,4BAA4B,CAAC;KAC9C,MAAM,EAAE;KACR,IAAI,EAAE;KACN,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC;KAClB,OAAO,EAAE;KACT,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC;KACrB,KAAK,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { clearBuildConfigCache, defineBuildConfig, getBuildConfigFilePath, hasBuildConfigFile, type LoadBuildConfigOptions, type LoadedBuildConfig, loadBuildConfig, } from "./build-config/index";
+export type { ComposerBuildConfig, ComposerBuildConfigInput, EnvExclusiveOptIn, } from "./build-config/schema";
+export { type AsyncStepRuntime, type AsyncWorkflowOptions, type Composer, createComposer, createWorkflow, type DurationString, defineSchedule, type ErrorHandler, type FanOut, fanOut, type InferWorkflowResultFromWorkflow, isFanOutStep, type ScheduleDefinition, type ScheduleDefinitionOptions, ScheduleOverlapPolicy, type ScheduleSpec, type Step, type StepContextProvider, type StepRetryPolicy, type SyncComposer, type SyncSchedulesResult, scheduleDefinitionSchema, scheduleOverlapPolicySchema, step, syncSchedules, type TemporalConfig, use, type Workflow, type WorkflowBuilder, type WorkflowResult, } from "./internal";
+export { isScheduleDefinition, isWorkflow, } from "./internal/async/build-scripts/utils/type-guards";
+export { type ActivityWorkerRuntimeConfig, type CombinedWorkerConfig, type CombinedWorkerConfigOptions, DEFAULT_WORKER_PROFILE, getAllTaskQueues, getEffectiveProfileConfig, getEffectiveResources, getTaskQueueForProfile, isValidWorkerProfile, type LoadAndResolveActivityWorkerRuntimeConfigOptions, loadAndResolveActivityWorkerRuntimeConfig, loadAndResolveCombinedWorkerConfigForLocalDev, type ResolveActivityWorkerRuntimeConfigOptions, type ResolvedProfilesForEnvironment, resolveActivityWorkerRuntimeConfig, resolveProfilesForEnvironment, WORKER_PROFILES, type WorkerProfile, type WorkerProfileConfig, } from "./internal/async/config/worker-profiles";
+export { type StartActivityWorkerOptions, startActivityWorker, } from "./internal/async/register-scripts/start-activity-worker";
+export { type StartAllWorkersOptions, startAllWorkers, } from "./internal/async/register-scripts/start-all-workers";
+export { type StartWorkflowWorkerOptions, startWorkflowWorker, } from "./internal/async/register-scripts/start-workflow-worker";
+export { runScheduleSync, type SyncScheduleScriptOptions, } from "./internal/async/register-scripts/sync-schedules";
+export { type RunSyncSchedulesCliOptions, runSyncSchedulesCli, } from "./internal/async/register-scripts/sync-schedules-cli";
+export { type SyncSchedulesViaLambdaOptions, syncSchedulesViaLambda, } from "./internal/async/register-scripts/sync-schedules-via-lambda";
+export { findPackageRoot } from "./internal/async/utils/find-package-root";
+export { type ErrorMatchTarget, matchesError, WorkflowBatchError, WorkflowErrorHandlerFailure, WorkflowStepError, } from "./internal/errors";
+export type { ComposerLogger } from "./internal/types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,cAAc,EACd,cAAc,EACd,KAAK,cAAc,EACnB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,MAAM,EACN,KAAK,+BAA+B,EACpC,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,IAAI,EACT,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,IAAI,EACJ,aAAa,EACb,KAAK,cAAc,EACnB,GAAG,EACH,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,UAAU,GACX,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,sBAAsB,EACtB,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,gDAAgD,EACrD,yCAAyC,EACzC,6CAA6C,EAC7C,KAAK,yCAAyC,EAC9C,KAAK,8BAA8B,EACnC,kCAAkC,EAClC,6BAA6B,EAC7B,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,KAAK,0BAA0B,EAC/B,mBAAmB,GACpB,MAAM,yDAAyD,CAAC;AACjE,OAAO,EACL,KAAK,sBAAsB,EAC3B,eAAe,GAChB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EACL,KAAK,0BAA0B,EAC/B,mBAAmB,GACpB,MAAM,yDAAyD,CAAC;AACjE,OAAO,EACL,eAAe,EACf,KAAK,yBAAyB,GAC/B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,KAAK,0BAA0B,EAC/B,mBAAmB,GACpB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,KAAK,6BAA6B,EAClC,sBAAsB,GACvB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EACL,KAAK,gBAAgB,EACrB,YAAY,EACZ,kBAAkB,EAClB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,57 @@
+"use strict";
+// Composer factory and types
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowStepError = exports.WorkflowErrorHandlerFailure = exports.WorkflowBatchError = exports.matchesError = exports.findPackageRoot = exports.syncSchedulesViaLambda = exports.runSyncSchedulesCli = exports.runScheduleSync = exports.startWorkflowWorker = exports.startAllWorkers = exports.startActivityWorker = exports.WORKER_PROFILES = exports.resolveProfilesForEnvironment = exports.resolveActivityWorkerRuntimeConfig = exports.loadAndResolveCombinedWorkerConfigForLocalDev = exports.loadAndResolveActivityWorkerRuntimeConfig = exports.isValidWorkerProfile = exports.getTaskQueueForProfile = exports.getEffectiveResources = exports.getEffectiveProfileConfig = exports.getAllTaskQueues = exports.DEFAULT_WORKER_PROFILE = exports.isWorkflow = exports.isScheduleDefinition = exports.use = exports.syncSchedules = exports.step = exports.scheduleOverlapPolicySchema = exports.scheduleDefinitionSchema = exports.ScheduleOverlapPolicy = exports.isFanOutStep = exports.fanOut = exports.defineSchedule = exports.createWorkflow = exports.createComposer = exports.loadBuildConfig = exports.hasBuildConfigFile = exports.getBuildConfigFilePath = exports.defineBuildConfig = exports.clearBuildConfigCache = void 0;
+var index_1 = require("./build-config/index");
+Object.defineProperty(exports, "clearBuildConfigCache", { enumerable: true, get: function () { return index_1.clearBuildConfigCache; } });
+Object.defineProperty(exports, "defineBuildConfig", { enumerable: true, get: function () { return index_1.defineBuildConfig; } });
+Object.defineProperty(exports, "getBuildConfigFilePath", { enumerable: true, get: function () { return index_1.getBuildConfigFilePath; } });
+Object.defineProperty(exports, "hasBuildConfigFile", { enumerable: true, get: function () { return index_1.hasBuildConfigFile; } });
+Object.defineProperty(exports, "loadBuildConfig", { enumerable: true, get: function () { return index_1.loadBuildConfig; } });
+var internal_1 = require("./internal");
+Object.defineProperty(exports, "createComposer", { enumerable: true, get: function () { return internal_1.createComposer; } });
+Object.defineProperty(exports, "createWorkflow", { enumerable: true, get: function () { return internal_1.createWorkflow; } });
+Object.defineProperty(exports, "defineSchedule", { enumerable: true, get: function () { return internal_1.defineSchedule; } });
+Object.defineProperty(exports, "fanOut", { enumerable: true, get: function () { return internal_1.fanOut; } });
+Object.defineProperty(exports, "isFanOutStep", { enumerable: true, get: function () { return internal_1.isFanOutStep; } });
+Object.defineProperty(exports, "ScheduleOverlapPolicy", { enumerable: true, get: function () { return internal_1.ScheduleOverlapPolicy; } });
+Object.defineProperty(exports, "scheduleDefinitionSchema", { enumerable: true, get: function () { return internal_1.scheduleDefinitionSchema; } });
+Object.defineProperty(exports, "scheduleOverlapPolicySchema", { enumerable: true, get: function () { return internal_1.scheduleOverlapPolicySchema; } });
+Object.defineProperty(exports, "step", { enumerable: true, get: function () { return internal_1.step; } });
+Object.defineProperty(exports, "syncSchedules", { enumerable: true, get: function () { return internal_1.syncSchedules; } });
+Object.defineProperty(exports, "use", { enumerable: true, get: function () { return internal_1.use; } });
+var type_guards_1 = require("./internal/async/build-scripts/utils/type-guards");
+Object.defineProperty(exports, "isScheduleDefinition", { enumerable: true, get: function () { return type_guards_1.isScheduleDefinition; } });
+Object.defineProperty(exports, "isWorkflow", { enumerable: true, get: function () { return type_guards_1.isWorkflow; } });
+var worker_profiles_1 = require("./internal/async/config/worker-profiles");
+Object.defineProperty(exports, "DEFAULT_WORKER_PROFILE", { enumerable: true, get: function () { return worker_profiles_1.DEFAULT_WORKER_PROFILE; } });
+Object.defineProperty(exports, "getAllTaskQueues", { enumerable: true, get: function () { return worker_profiles_1.getAllTaskQueues; } });
+Object.defineProperty(exports, "getEffectiveProfileConfig", { enumerable: true, get: function () { return worker_profiles_1.getEffectiveProfileConfig; } });
+Object.defineProperty(exports, "getEffectiveResources", { enumerable: true, get: function () { return worker_profiles_1.getEffectiveResources; } });
+Object.defineProperty(exports, "getTaskQueueForProfile", { enumerable: true, get: function () { return worker_profiles_1.getTaskQueueForProfile; } });
+Object.defineProperty(exports, "isValidWorkerProfile", { enumerable: true, get: function () { return worker_profiles_1.isValidWorkerProfile; } });
+Object.defineProperty(exports, "loadAndResolveActivityWorkerRuntimeConfig", { enumerable: true, get: function () { return worker_profiles_1.loadAndResolveActivityWorkerRuntimeConfig; } });
+Object.defineProperty(exports, "loadAndResolveCombinedWorkerConfigForLocalDev", { enumerable: true, get: function () { return worker_profiles_1.loadAndResolveCombinedWorkerConfigForLocalDev; } });
+Object.defineProperty(exports, "resolveActivityWorkerRuntimeConfig", { enumerable: true, get: function () { return worker_profiles_1.resolveActivityWorkerRuntimeConfig; } });
+Object.defineProperty(exports, "resolveProfilesForEnvironment", { enumerable: true, get: function () { return worker_profiles_1.resolveProfilesForEnvironment; } });
+Object.defineProperty(exports, "WORKER_PROFILES", { enumerable: true, get: function () { return worker_profiles_1.WORKER_PROFILES; } });
+var start_activity_worker_1 = require("./internal/async/register-scripts/start-activity-worker");
+Object.defineProperty(exports, "startActivityWorker", { enumerable: true, get: function () { return start_activity_worker_1.startActivityWorker; } });
+var start_all_workers_1 = require("./internal/async/register-scripts/start-all-workers");
+Object.defineProperty(exports, "startAllWorkers", { enumerable: true, get: function () { return start_all_workers_1.startAllWorkers; } });
+var start_workflow_worker_1 = require("./internal/async/register-scripts/start-workflow-worker");
+Object.defineProperty(exports, "startWorkflowWorker", { enumerable: true, get: function () { return start_workflow_worker_1.startWorkflowWorker; } });
+var sync_schedules_1 = require("./internal/async/register-scripts/sync-schedules");
+Object.defineProperty(exports, "runScheduleSync", { enumerable: true, get: function () { return sync_schedules_1.runScheduleSync; } });
+var sync_schedules_cli_1 = require("./internal/async/register-scripts/sync-schedules-cli");
+Object.defineProperty(exports, "runSyncSchedulesCli", { enumerable: true, get: function () { return sync_schedules_cli_1.runSyncSchedulesCli; } });
+var sync_schedules_via_lambda_1 = require("./internal/async/register-scripts/sync-schedules-via-lambda");
+Object.defineProperty(exports, "syncSchedulesViaLambda", { enumerable: true, get: function () { return sync_schedules_via_lambda_1.syncSchedulesViaLambda; } });
+var find_package_root_1 = require("./internal/async/utils/find-package-root");
+Object.defineProperty(exports, "findPackageRoot", { enumerable: true, get: function () { return find_package_root_1.findPackageRoot; } });
+var errors_1 = require("./internal/errors");
+Object.defineProperty(exports, "matchesError", { enumerable: true, get: function () { return errors_1.matchesError; } });
+Object.defineProperty(exports, "WorkflowBatchError", { enumerable: true, get: function () { return errors_1.WorkflowBatchError; } });
+Object.defineProperty(exports, "WorkflowErrorHandlerFailure", { enumerable: true, get: function () { return errors_1.WorkflowErrorHandlerFailure; } });
+Object.defineProperty(exports, "WorkflowStepError", { enumerable: true, get: function () { return errors_1.WorkflowStepError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,6BAA6B;;;AAE7B,8CAQ8B;AAP5B,8GAAA,qBAAqB,OAAA;AACrB,0GAAA,iBAAiB,OAAA;AACjB,+GAAA,sBAAsB,OAAA;AACtB,2GAAA,kBAAkB,OAAA;AAGlB,wGAAA,eAAe,OAAA;AAOjB,uCA+BoB;AA3BlB,0GAAA,cAAc,OAAA;AACd,0GAAA,cAAc,OAAA;AAEd,0GAAA,cAAc,OAAA;AAGd,kGAAA,MAAM,OAAA;AAEN,wGAAA,YAAY,OAAA;AAGZ,iHAAA,qBAAqB,OAAA;AAOrB,oHAAA,wBAAwB,OAAA;AACxB,uHAAA,2BAA2B,OAAA;AAC3B,gGAAA,IAAI,OAAA;AACJ,yGAAA,aAAa,OAAA;AAEb,+FAAA,GAAG,OAAA;AAKL,gFAG0D;AAFxD,mHAAA,oBAAoB,OAAA;AACpB,yGAAA,UAAU,OAAA;AAEZ,2EAoBiD;AAhB/C,yHAAA,sBAAsB,OAAA;AACtB,mHAAA,gBAAgB,OAAA;AAChB,4HAAA,yBAAyB,OAAA;AACzB,wHAAA,qBAAqB,OAAA;AACrB,yHAAA,sBAAsB,OAAA;AACtB,uHAAA,oBAAoB,OAAA;AAEpB,4IAAA,yCAAyC,OAAA;AACzC,gJAAA,6CAA6C,OAAA;AAG7C,qIAAA,kCAAkC,OAAA;AAClC,gIAAA,6BAA6B,OAAA;AAC7B,kHAAA,eAAe,OAAA;AAIjB,iGAGiE;AAD/D,4HAAA,mBAAmB,OAAA;AAErB,yFAG6D;AAD3D,oHAAA,eAAe,OAAA;AAEjB,iGAGiE;AAD/D,4HAAA,mBAAmB,OAAA;AAErB,mFAG0D;AAFxD,iHAAA,eAAe,OAAA;AAGjB,2FAG8D;AAD5D,yHAAA,mBAAmB,OAAA;AAErB,yGAGqE;AADnE,mIAAA,sBAAsB,OAAA;AAExB,8EAA2E;AAAlE,oHAAA,eAAe,OAAA;AACxB,4CAM2B;AAJzB,sGAAA,YAAY,OAAA;AACZ,4GAAA,kBAAkB,OAAA;AAClB,qHAAA,2BAA2B,OAAA;AAC3B,2GAAA,iBAAiB,OAAA"}

package/dist/internal/async/build/workflow-factory.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Async Workflow Factory - Creates Temporal workflow functions from pre-computed plans.
+ *
+ * This factory ONLY uses @temporalio/workflow APIs to ensure deterministic execution.
+ * It is bundled by Temporal's workflow bundler and runs in an isolated sandbox.
+ * It CANNOT import Node.js APIs or external dependencies (no fs, no network,
+ * no logging libraries) -- only @temporalio/workflow primitives.
+ *
+ * ## Factory Pattern:
+ * - Input: WorkflowPlan (build-time generated, contains batches + activity mappings)
+ * - Output: Temporal workflow function (deterministic orchestration logic)
+ * - Result: Worker registers these functions, Temporal invokes them at runtime
+ *
+ * All business logic runs in activities, not in the workflow itself.
+ * The workflow only orchestrates: batch sequencing, parallel step execution, data flow.
+ *
+ * @module workflow-factory
+ */
+import type { DurationString } from "../../dag-sync-step";
+/**
+ * Input structure for our generated Temporal workflows.
+ */
+export interface WorkflowInput {
+    /** Initial data for the workflow bag */
+    initialData: Record<string, any>;
+    /** Additional metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Serializable error info for cause chains.
+ * Includes parentCodes to support LotiError subclass matching via extractIfPresent.
+ */
+export interface SerializedErrorInfo {
+    message: string;
+    code?: string;
+    /** Parent error codes for subclass matching (e.g., NOT_FOUND -> DB_NOT_FOUND) */
+    parentCodes?: readonly string[];
+    type?: string;
+    cause?: SerializedErrorInfo;
+}
+/**
+ * Information about a step failure, passed to error handler activities.
+ */
+export interface StepFailureInfo {
+    /** Step name that failed */
+    stepName: string;
+    /** Error message (from outermost error wrapper) */
+    message: string;
+    /** Error code if available */
+    code?: string;
+    /** Parent error codes for subclass matching */
+    parentCodes?: readonly string[];
+    /** Error type/name */
+    type: string;
+    /** Nested cause chain (Temporal wraps errors in ActivityFailure -> ApplicationFailure) */
+    cause?: SerializedErrorInfo;
+}
+/**
+ * Information about a batch failure, passed to error handler activities.
+ */
+export interface BatchErrorInfo {
+    /** Batch number (1-indexed) */
+    batchNumber: number;
+    /** Workflow ID */
+    workflowId: string;
+    /** All step failures in the batch */
+    errors: StepFailureInfo[];
+}
+/**
+ * A FanOut entry in a batch. Orchestrates dynamic child workflow parallelism:
+ * mapInput activity -> lane-based child workflow execution -> aggregateResults activity.
+ */
+export interface FanOutBatchEntry {
+    /** FanOut step name */
+    name: string;
+    /** Versioned Temporal workflow name for the child workflow */
+    childWorkflowName: string;
+    /** Activity that calls the user's mapInput function */
+    mapInputActivityName: string;
+    /** Activity that calls the user's aggregateResults function */
+    aggregateResultsActivityName: string;
+    /** Fields this FanOut needs from the bag (passed to mapInput) */
+    needs: string[];
+    /** Fields this FanOut provides to the bag (returned by aggregateResults) */
+    provides: string[];
+    /** Maximum concurrent child workflows (null = unbounded, from Infinity via JSON round-trip) */
+    concurrency: number | null;
+    /** Task queue for mapInput/aggregateResults activities */
+    taskQueue: string;
+    /** Per-step activity configuration (timeouts, retries) */
+    activityConfig?: StepActivityConfig;
+}
+/**
+ * Per-step activity configuration, threaded from step definitions through the plan.
+ * All fields are optional; the workflow factory falls back to defaults when absent.
+ */
+export interface StepActivityConfig {
+    startToCloseTimeout?: DurationString;
+    heartbeatTimeout?: DurationString;
+    retry?: {
+        maximumAttempts?: number;
+        backoffCoefficient?: number;
+        initialInterval?: DurationString;
+        maximumInterval?: DurationString;
+    };
+}
+/**
+ * Represents a batch of steps that can execute in parallel.
+ */
+export interface StepBatch {
+    /** Steps in this batch (all can execute in parallel) */
+    steps: Array<{
+        /** Step name (used for activity lookup) */
+        name: string;
+        /** Activity name (includes hash for versioning) */
+        activityName: string;
+        /** Fields this step needs from the bag */
+        needs: string[];
+        /** Fields this step provides to the bag */
+        provides: string[];
+        /** Task queue to execute on (based on worker profile) */
+        taskQueue: string;
+        /** Per-step activity configuration (timeouts, retries) */
+        activityConfig?: StepActivityConfig;
+    }>;
+    /** FanOut entries in this batch (execute in parallel alongside steps) */
+    fanOuts?: FanOutBatchEntry[];
+}
+/**
+ * Workflow execution plan - defines the order and parallelism of step execution.
+ */
+export interface WorkflowPlan {
+    /** Name of the workflow */
+    name: string;
+    /** Batches of steps (each batch executes sequentially, steps within batch run in parallel) */
+    batches: StepBatch[];
+    /**
+     * Optional error handler activity name.
+     * If provided, this activity will be called when a batch fails.
+     * The activity receives (workflowInput, bag, errorInfo) where errorInfo
+     * contains details about the batch failure.
+     */
+    errorHandlerActivityName?: string;
+    /**
+     * Task queue for the error handler activity.
+     * Defaults to 'workflow-tasks' if not specified.
+     */
+    errorHandlerTaskQueue?: string;
+    /**
+     * Checkpoints for early return in async workflows.
+     * Each checkpoint fires after its designated batch completes.
+     */
+    checkpoints?: Array<{
+        /** Unique checkpoint name (used by client to await) */
+        name: string;
+        /** 0-indexed batch number that triggers this checkpoint */
+        afterBatch: number;
+        /** Timeout in milliseconds for awaiting this checkpoint */
+        timeout: number;
+    }>;
+}
+/**
+ * Result type for Temporal workflow execution.
+ * Mirrors the sync runtime's WorkflowResult type.
+ */
+export interface TemporalWorkflowResult {
+    /** The workflow bag containing all step outputs and initial data */
+    bag: Record<string, any>;
+    /** Error if workflow failed, undefined if successful */
+    error?: {
+        /** Error message */
+        message: string;
+        /** Error code if available */
+        code?: string;
+        /** Error type/name */
+        type: string;
+        /** Batch number where the error occurred */
+        batchNumber?: number;
+        /** Individual step/child failures when this is a batch or fanOut error */
+        errors?: StepFailureInfo[];
+    };
+}
+/**
+ * Arguments for the awaitCheckpoint update.
+ */
+export interface AwaitCheckpointArgs {
+    /** Name of the checkpoint to wait for */
+    checkpointName: string;
+}
+/**
+ * Temporal Update definition for awaiting checkpoints.
+ * Clients call this to wait for a checkpoint and receive the partial bag state.
+ *
+ * The update handler blocks until the requested checkpoint is reached,
+ * then returns a snapshot of the bag at that point.
+ *
+ * Import this for type-safe executeUpdate calls from client code.
+ */
+export declare const awaitCheckpointUpdate: import("@temporalio/common").UpdateDefinition<Record<string, unknown>, [AwaitCheckpointArgs], string>;
+/**
+ * Factory function that creates a Temporal workflow function from a pre-computed plan.
+ *
+ * This factory creates deterministic orchestration logic using only Temporal workflow APIs.
+ * All actual business logic runs in activities - the workflow only coordinates execution.
+ *
+ * The workflow returns { bag, error? } instead of throwing, matching the sync runtime.
+ *
+ * @param plan - The workflow execution plan (generated at build time)
+ * @returns A Temporal workflow function ready for worker registration
+ */
+export declare function createWorkflowFunction(plan: WorkflowPlan): (input: WorkflowInput) => Promise<TemporalWorkflowResult>;
+//# sourceMappingURL=workflow-factory.d.ts.map

package/dist/internal/async/build/workflow-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-factory.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/build/workflow-factory.ts"],"names":[],"mappings":"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"}