@lotiai/composer 0.2.0 → 0.2.1

package/dist/internal/async/register-scripts/start-all-workers.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Start All Workers
+ *
+ * Generic framework function that starts both Temporal Workflow Workers and
+ * Activity Workers in parallel from a configured Composer instance. This is a
+ * convenience function for local development when you want to run the entire
+ * worker system in a single process.
+ *
+ * ## Usage:
+ *
+ * ```typescript
+ * import { startAllWorkers } from "@lotiai/composer";
+ * import { composer } from "./my-app-composer";
+ * import { myWorkflow } from "./workflows/my-workflow";
+ *
+ * await startAllWorkers(composer, {
+ *   workflows: [myWorkflow],
+ *   workflow: {
+ *     taskQueues: ["workflow-tasks"],
+ *     maxConcurrentWorkflowTaskExecutions: 100,
+ *   },
+ *   activity: {
+ *     taskQueues: ["standard-tasks"],
+ *     maxConcurrentActivityTaskExecutions: 15,
+ *   },
+ * });
+ * ```
+ *
+ * ## Note:
+ *
+ * In production, you would typically run these workers in separate containers/processes
+ * to enable independent scaling and deployment. This function is primarily for
+ * local development convenience.
+ *
+ * @module start-all-workers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startAllWorkers = startAllWorkers;
+const ensure_namespace_1 = require("../utils/ensure-namespace");
+const start_activity_worker_1 = require("./start-activity-worker");
+const start_workflow_worker_1 = require("./start-workflow-worker");
+/**
+ * Starts both Temporal Workflow Workers and Activity Workers in parallel
+ * using a configured Composer instance.
+ *
+ * This function:
+ * 1. Optionally ensures the Temporal namespace exists (once, not per worker)
+ * 2. Logs the combined worker configuration
+ * 3. Delegates to `startWorkflowWorker()` and `startActivityWorker()` via `Promise.all`
+ *
+ * @param composer - A fully configured Composer instance (must have temporal config)
+ * @param options - Combined worker startup options
+ */
+async function startAllWorkers(composer, options) {
+    const logger = composer.logger;
+    const { serverAddress, namespace } = composer.temporal;
+    logger.info("Starting All Workers", {
+        serverAddress,
+        namespace,
+        workflowTaskQueues: options.workflow.taskQueues,
+        activityTaskQueues: options.activity.taskQueues,
+        maxConcurrentWorkflowTaskExecutions: options.workflow.maxConcurrentWorkflowTaskExecutions,
+        maxConcurrentActivityTaskExecutions: options.activity.maxConcurrentActivityTaskExecutions,
+        ensureNamespace: options.ensureNamespace ?? true,
+    });
+    // Ensure namespace once before starting both workers
+    if (options.ensureNamespace !== false) {
+        await (0, ensure_namespace_1.ensureNamespaceExists)(serverAddress, namespace);
+    }
+    await Promise.all([
+        (0, start_workflow_worker_1.startWorkflowWorker)(composer, {
+            ...options.workflow,
+            workflows: options.workflows,
+            ensureNamespace: false,
+        }),
+        (0, start_activity_worker_1.startActivityWorker)(composer, {
+            ...options.activity,
+            workflows: options.workflows,
+            ensureNamespace: false,
+        }),
+    ]);
+}
+//# sourceMappingURL=start-all-workers.js.map

package/dist/internal/async/register-scripts/start-all-workers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-all-workers.js","sourceRoot":"","sources":["../../../../src/internal/async/register-scripts/start-all-workers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;;AAmDH,0CAkCC;AAjFD,gEAAkE;AAClE,mEAA+F;AAC/F,mEAA+F;AAiC/F;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,eAAe,CACnC,QAA4B,EAC5B,OAA+B;IAE/B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAEvD,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE;QAClC,aAAa;QACb,SAAS;QACT,kBAAkB,EAAE,OAAO,CAAC,QAAQ,CAAC,UAAU;QAC/C,kBAAkB,EAAE,OAAO,CAAC,QAAQ,CAAC,UAAU;QAC/C,mCAAmC,EAAE,OAAO,CAAC,QAAQ,CAAC,mCAAmC;QACzF,mCAAmC,EAAE,OAAO,CAAC,QAAQ,CAAC,mCAAmC;QACzF,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;KACjD,CAAC,CAAC;IAEH,qDAAqD;IACrD,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;QACtC,MAAM,IAAA,wCAAqB,EAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,IAAA,2CAAmB,EAAC,QAAQ,EAAE;YAC5B,GAAG,OAAO,CAAC,QAAQ;YACnB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,eAAe,EAAE,KAAK;SACvB,CAAC;QACF,IAAA,2CAAmB,EAAC,QAAQ,EAAE;YAC5B,GAAG,OAAO,CAAC,QAAQ;YACnB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,eAAe,EAAE,KAAK;SACvB,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/internal/async/register-scripts/start-workflow-worker.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Start Workflow Worker
+ *
+ * Generic framework function that starts Temporal Workflow Workers from a
+ * configured Composer instance. The Composer provides the Temporal connection
+ * config (server address, namespace) and logger.
+ *
+ * The caller is responsible for determining task queues and concurrency settings
+ * (e.g., from environment variables or hardcoded defaults).
+ *
+ * ## Usage:
+ *
+ * ```typescript
+ * import { startWorkflowWorker } from "@lotiai/composer";
+ * import { composer } from "./my-app-composer";
+ *
+ * await startWorkflowWorker(composer, {
+ *   taskQueues: ["workflow-tasks"],
+ *   maxConcurrentWorkflowTaskExecutions: 100,
+ * });
+ * ```
+ *
+ * @module start-workflow-worker
+ */
+import type { Composer } from "../../context-provider";
+import type { Workflow } from "../../dag-sync-workflow";
+/**
+ * Options for starting a workflow worker.
+ */
+export interface StartWorkflowWorkerOptions {
+    /**
+     * Task queues to listen on for workflow tasks.
+     */
+    taskQueues: string[];
+    /**
+     * Maximum number of concurrent workflow task executions per queue.
+     */
+    maxConcurrentWorkflowTaskExecutions: number;
+    /**
+     * Workflow definitions to register. Plans are generated from these.
+     */
+    workflows: Workflow<any, any, any>[];
+    /**
+     * Whether to ensure the Temporal namespace exists before starting workers.
+     * Useful for local development where the namespace may not exist yet.
+     *
+     * @default true
+     */
+    ensureNamespace?: boolean;
+}
+/**
+ * Starts Temporal Workflow Workers using a configured Composer instance.
+ *
+ * This function:
+ * 1. Optionally ensures the Temporal namespace exists (idempotent)
+ * 2. Logs the worker configuration
+ * 3. Delegates to `composer.runWorkflowWorkers()` which handles worker lifecycle
+ *    (connection, bundle loading, shutdown signals)
+ * 4. Exits with code 1 on failure
+ *
+ * The Composer instance provides:
+ * - Temporal server address and namespace (from its temporal config)
+ * - Logger (for structured log output)
+ *
+ * @param composer - A fully configured Composer instance (must have temporal config)
+ * @param options - Worker startup options (task queues, concurrency)
+ */
+export declare function startWorkflowWorker<TContext>(composer: Composer<TContext>, options: StartWorkflowWorkerOptions): Promise<void>;
+//# sourceMappingURL=start-workflow-worker.d.ts.map

package/dist/internal/async/register-scripts/start-workflow-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-workflow-worker.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/register-scripts/start-workflow-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB;;OAEG;IACH,mCAAmC,EAAE,MAAM,CAAC;IAE5C;;OAEG;IACH,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAErC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAChD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC5B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/internal/async/register-scripts/start-workflow-worker.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Start Workflow Worker
+ *
+ * Generic framework function that starts Temporal Workflow Workers from a
+ * configured Composer instance. The Composer provides the Temporal connection
+ * config (server address, namespace) and logger.
+ *
+ * The caller is responsible for determining task queues and concurrency settings
+ * (e.g., from environment variables or hardcoded defaults).
+ *
+ * ## Usage:
+ *
+ * ```typescript
+ * import { startWorkflowWorker } from "@lotiai/composer";
+ * import { composer } from "./my-app-composer";
+ *
+ * await startWorkflowWorker(composer, {
+ *   taskQueues: ["workflow-tasks"],
+ *   maxConcurrentWorkflowTaskExecutions: 100,
+ * });
+ * ```
+ *
+ * @module start-workflow-worker
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startWorkflowWorker = startWorkflowWorker;
+const ensure_namespace_1 = require("../utils/ensure-namespace");
+/**
+ * Starts Temporal Workflow Workers using a configured Composer instance.
+ *
+ * This function:
+ * 1. Optionally ensures the Temporal namespace exists (idempotent)
+ * 2. Logs the worker configuration
+ * 3. Delegates to `composer.runWorkflowWorkers()` which handles worker lifecycle
+ *    (connection, bundle loading, shutdown signals)
+ * 4. Exits with code 1 on failure
+ *
+ * The Composer instance provides:
+ * - Temporal server address and namespace (from its temporal config)
+ * - Logger (for structured log output)
+ *
+ * @param composer - A fully configured Composer instance (must have temporal config)
+ * @param options - Worker startup options (task queues, concurrency)
+ */
+async function startWorkflowWorker(composer, options) {
+    const logger = composer.logger;
+    const { serverAddress, namespace } = composer.temporal;
+    logger.info("Starting Workflow Workers", {
+        serverAddress,
+        namespace,
+        taskQueues: options.taskQueues,
+        maxConcurrentWorkflowTaskExecutions: options.maxConcurrentWorkflowTaskExecutions,
+        ensureNamespace: options.ensureNamespace ?? true,
+    });
+    try {
+        // Ensure namespace exists before starting workers (idempotent)
+        if (options.ensureNamespace !== false) {
+            await (0, ensure_namespace_1.ensureNamespaceExists)(serverAddress, namespace);
+        }
+        await composer.runWorkflowWorkers({
+            taskQueues: options.taskQueues,
+            maxConcurrentWorkflowTaskExecutions: options.maxConcurrentWorkflowTaskExecutions,
+            workflows: options.workflows,
+        });
+    }
+    catch (error) {
+        logger.error("Failed to start Workflow Workers", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=start-workflow-worker.js.map

package/dist/internal/async/register-scripts/start-workflow-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-workflow-worker.js","sourceRoot":"","sources":["../../../../src/internal/async/register-scripts/start-workflow-worker.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;AAmDH,kDAgCC;AA/ED,gEAAkE;AA8BlE;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,mBAAmB,CACvC,QAA4B,EAC5B,OAAmC;IAEnC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAEvD,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;QACvC,aAAa;QACb,SAAS;QACT,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,mCAAmC,EAAE,OAAO,CAAC,mCAAmC;QAChF,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;KACjD,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,+DAA+D;QAC/D,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;YACtC,MAAM,IAAA,wCAAqB,EAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,QAAQ,CAAC,kBAAkB,CAAC;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,mCAAmC,EAAE,OAAO,CAAC,mCAAmC;YAChF,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE;YAC/C,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/internal/async/register-scripts/sync-schedules-cli.d.ts

@@ -0,0 +1,28 @@
+import type { Composer } from "../../context-provider";
+import type { ScheduleDefinition } from "../schedule/define-schedule";
+/**
+ * Options for `runSyncSchedulesCli`.
+ */
+export interface RunSyncSchedulesCliOptions {
+    /**
+     * Schedule definitions to reconcile. Typically the values of a
+     * composer-instance's `schedules/` barrel filtered by
+     * `isScheduleDefinition`.
+     */
+    schedules: ScheduleDefinition[];
+    /**
+     * argv to parse. Defaults to `process.argv`; primarily useful for
+     * testing.
+     */
+    argv?: string[];
+}
+/**
+ * Parses CLI flags and dispatches to either `syncSchedulesViaLambda`
+ * (default) or `runScheduleSync` (with `--direct`). Intended to be the
+ * entire body of a composer-instance's `sync-schedules` script.
+ *
+ * @param composer - Composer instance providing the Temporal connection + logger
+ * @param options - Schedules to reconcile (and optional argv override)
+ */
+export declare function runSyncSchedulesCli<TContext>(composer: Composer<TContext>, options: RunSyncSchedulesCliOptions): Promise<void>;
+//# sourceMappingURL=sync-schedules-cli.d.ts.map

package/dist/internal/async/register-scripts/sync-schedules-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-schedules-cli.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/register-scripts/sync-schedules-cli.ts"],"names":[],"mappings":"AA2CA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AActE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAEhC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAChD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC5B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAiEf"}

package/dist/internal/async/register-scripts/sync-schedules-cli.js

@@ -0,0 +1,124 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSyncSchedulesCli = runSyncSchedulesCli;
+/**
+ * Run Sync Schedules CLI
+ *
+ * Framework helper that implements the complete command-line entrypoint for
+ * a composer-instance's `sync-schedules` script. Each composer instance
+ * (interchange, josu, etc.) needs exactly one thin wrapper that:
+ *
+ * ```typescript
+ * import { isScheduleDefinition, runSyncSchedulesCli } from "@lotiai/composer";
+ * import { getComposer } from "../app-composer";
+ * import * as scheduleExports from "../schedules";
+ *
+ * void runSyncSchedulesCli(getComposer(), {
+ *   schedules: Object.values(scheduleExports).filter(isScheduleDefinition),
+ * });
+ * ```
+ *
+ * Everything else -- argv parsing, current-environment resolution, default
+ * Lambda function name, direct-vs-Lambda dispatch, and process exit on
+ * errors -- is owned here so flag names and behavior stay consistent across
+ * composer instances.
+ *
+ * ## Flags
+ *
+ * - `--lambda <name>`   Override the schedule-sync Lambda function name.
+ *                       Defaults to `loti-ic-<ENVIRONMENT_NAME>-temporalschedulesync`.
+ * - `--mode invoke|emit` How to reconcile via the Lambda path. `invoke`
+ *                        (default) calls the Lambda; `emit` prints the JSON
+ *                        payload to stdout and exits 0.
+ * - `--dry-run`          Reconcile in dry-run mode on the server
+ *                        (no changes). Defaults to
+ *                        `COMPOSER_SCHEDULE_SYNC_DRY_RUN === "true"`.
+ * - `--direct`           Connect to Temporal directly from this process
+ *                        using the composer's configured `serverAddress`
+ *                        (local dev / escape hatch). Incompatible with
+ *                        `--mode`.
+ * - `--region <region>`  AWS region for the Lambda client (default
+ *                        `us-east-1`).
+ *
+ * @module sync-schedules-cli
+ */
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const sync_schedules_1 = require("./sync-schedules");
+const sync_schedules_via_lambda_1 = require("./sync-schedules-via-lambda");
+/**
+ * Builds the default schedule-sync Lambda function name for the current
+ * environment. Mirrors `createResourceName(taggingConfig,
+ * "temporal-schedule-sync")` in `infrastructure/shared`: `loti-ic` prefix +
+ * environment + resource slug with hyphens stripped.
+ */
+function defaultLambdaFunctionName(environment) {
+    return `loti-ic-${environment}-temporalschedulesync`;
+}
+/**
+ * Parses CLI flags and dispatches to either `syncSchedulesViaLambda`
+ * (default) or `runScheduleSync` (with `--direct`). Intended to be the
+ * entire body of a composer-instance's `sync-schedules` script.
+ *
+ * @param composer - Composer instance providing the Temporal connection + logger
+ * @param options - Schedules to reconcile (and optional argv override)
+ */
+async function runSyncSchedulesCli(composer, options) {
+    const argv = await (0, yargs_1.default)(options.argv ?? (0, helpers_1.hideBin)(process.argv))
+        .scriptName("sync-schedules")
+        .usage("$0 [--mode invoke|emit] [--dry-run] [--direct]")
+        .option("lambda", {
+        type: "string",
+        describe: "Name of the schedule-sync Lambda function (defaults to loti-ic-<env>-temporalschedulesync).",
+    })
+        .option("mode", {
+        type: "string",
+        choices: ["invoke", "emit"],
+        default: "invoke",
+        describe: 'How to reconcile: "invoke" calls the Lambda, "emit" prints the JSON payload to stdout and exits.',
+    })
+        .option("dry-run", {
+        type: "boolean",
+        describe: "Reconcile in dry-run mode (log the diff, change nothing). Defaults to the COMPOSER_SCHEDULE_SYNC_DRY_RUN env var.",
+    })
+        .option("direct", {
+        type: "boolean",
+        default: false,
+        describe: "Connect to Temporal directly from this process instead of invoking the Lambda (local dev).",
+    })
+        .option("region", {
+        type: "string",
+        describe: "AWS region for the Lambda client (defaults to us-east-1).",
+    })
+        .strict()
+        .help()
+        .parseAsync();
+    const currentEnvironment = process.env.ENVIRONMENT_NAME ?? null;
+    if (argv.direct) {
+        if (argv.mode !== "invoke") {
+            throw new Error("--mode is only valid when invoking the Lambda; remove --direct or --mode");
+        }
+        await (0, sync_schedules_1.runScheduleSync)(composer, {
+            schedules: options.schedules,
+            currentEnvironment,
+            dryRun: argv.dryRun,
+        });
+        return;
+    }
+    if (currentEnvironment === null) {
+        throw new Error("ENVIRONMENT_NAME must be set to derive the default Lambda function name (or pass --lambda explicitly).");
+    }
+    const lambdaFunctionName = argv.lambda ?? defaultLambdaFunctionName(currentEnvironment);
+    await (0, sync_schedules_via_lambda_1.syncSchedulesViaLambda)(composer, {
+        schedules: options.schedules,
+        lambdaFunctionName,
+        currentEnvironment,
+        dryRun: argv.dryRun,
+        mode: argv.mode,
+        region: argv.region,
+    });
+}
+//# sourceMappingURL=sync-schedules-cli.js.map

package/dist/internal/async/register-scripts/sync-schedules-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-schedules-cli.js","sourceRoot":"","sources":["../../../../src/internal/async/register-scripts/sync-schedules-cli.ts"],"names":[],"mappings":";;;;;AAoFA,kDAoEC;AAxJD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,kDAA0B;AAC1B,2CAAwC;AAGxC,qDAAmD;AACnD,2EAAqE;AAErE;;;;;GAKG;AACH,SAAS,yBAAyB,CAAC,WAAmB;IACpD,OAAO,WAAW,WAAW,uBAAuB,CAAC;AACvD,CAAC;AAoBD;;;;;;;GAOG;AACI,KAAK,UAAU,mBAAmB,CACvC,QAA4B,EAC5B,OAAmC;IAEnC,MAAM,IAAI,GAAG,MAAM,IAAA,eAAK,EAAC,OAAO,CAAC,IAAI,IAAI,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC5D,UAAU,CAAC,gBAAgB,CAAC;SAC5B,KAAK,CAAC,gDAAgD,CAAC;SACvD,MAAM,CAAC,QAAQ,EAAE;QAChB,IAAI,EAAE,QAAQ;QACd,QAAQ,EACN,6FAA6F;KAChG,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAU;QACpC,OAAO,EAAE,QAAiB;QAC1B,QAAQ,EACN,kGAAkG;KACrG,CAAC;SACD,MAAM,CAAC,SAAS,EAAE;QACjB,IAAI,EAAE,SAAS;QACf,QAAQ,EACN,mHAAmH;KACtH,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,QAAQ,EACN,4FAA4F;KAC/F,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,2DAA2D;KACtE,CAAC;SACD,MAAM,EAAE;SACR,IAAI,EAAE;SACN,UAAU,EAAE,CAAC;IAEhB,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAEhE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,IAAA,gCAAe,EAAC,QAAQ,EAAE;YAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,kBAAkB;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,IAAI,yBAAyB,CAAC,kBAAkB,CAAC,CAAC;IAExF,MAAM,IAAA,kDAAsB,EAAC,QAAQ,EAAE;QACrC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,kBAAkB;QAClB,kBAAkB;QAClB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/internal/async/register-scripts/sync-schedules-via-lambda.d.ts

@@ -0,0 +1,55 @@
+import type { Composer } from "../../context-provider";
+import type { ScheduleDefinition } from "../schedule/define-schedule";
+/**
+ * Options for `syncSchedulesViaLambda`.
+ */
+export interface SyncSchedulesViaLambdaOptions {
+    /**
+     * Schedule definitions to reconcile. Typically the values of a
+     * composer-instance's `schedules/` barrel filtered by `isScheduleDefinition`.
+     */
+    schedules: ScheduleDefinition[];
+    /**
+     * Name of the schedule-sync Lambda to invoke (e.g.
+     * `"loti-ic-prod-temporalschedulesync"`).
+     *
+     * Ignored in `"emit"` mode but still required for type-safety.
+     */
+    lambdaFunctionName: string;
+    /**
+     * Current environment used to filter schedules by their `environments`
+     * allowlist.
+     *
+     * @default process.env.ENVIRONMENT_NAME
+     */
+    currentEnvironment?: string | null;
+    /**
+     * If true, the Lambda runs the reconciliation in dry-run mode (logs what
+     * would change, touches nothing on the server).
+     *
+     * @default process.env.COMPOSER_SCHEDULE_SYNC_DRY_RUN === "true"
+     */
+    dryRun?: boolean;
+    /**
+     * `"invoke"` calls the Lambda synchronously; `"emit"` prints the payload
+     * to stdout and exits without invoking.
+     *
+     * @default "invoke"
+     */
+    mode?: "invoke" | "emit";
+    /**
+     * AWS region for the Lambda client.
+     *
+     * @default "us-east-1"
+     */
+    region?: string;
+}
+/**
+ * Syncs composer schedules by invoking a schedule-sync Lambda (or emitting
+ * the payload to stdout).
+ *
+ * @param composer - Composer instance providing the namespace + logger
+ * @param options  - Schedules, Lambda function name, and mode/region/env flags
+ */
+export declare function syncSchedulesViaLambda<TContext>(composer: Composer<TContext>, options: SyncSchedulesViaLambdaOptions): Promise<void>;
+//# sourceMappingURL=sync-schedules-via-lambda.d.ts.map

package/dist/internal/async/register-scripts/sync-schedules-via-lambda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-schedules-via-lambda.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/register-scripts/sync-schedules-via-lambda.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AActE;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EACnD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC5B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAiHf"}

package/dist/internal/async/register-scripts/sync-schedules-via-lambda.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncSchedulesViaLambda = syncSchedulesViaLambda;
+/**
+ * Sync Schedules via Lambda
+ *
+ * Framework helper that reconciles composer schedules by invoking a
+ * `schedule-sync` Lambda rather than connecting to the Temporal server
+ * directly. The Lambda receives `{ namespace, schedules, dryRun }` as JSON,
+ * calls the reconciler (`syncSchedules`), and returns a diff summary.
+ *
+ * This is the intended deploy-time path: CI assumes an AWS role with
+ * `lambda:InvokeFunction` permission and runs this helper from a
+ * composer-instance script (e.g. `@loti/composer-ix` `sync-schedules`).
+ *
+ * Supports two modes:
+ * - `"invoke"` (default): invokes the Lambda synchronously, logs tail logs
+ *   from the response, and exits `1` on any failure path (FunctionError,
+ *   per-schedule errors, or SDK errors).
+ * - `"emit"`: prints the JSON payload to stdout and exits `0` without
+ *   invoking. Useful for capturing the payload as a CI artifact or for
+ *   manually passing it through an approval gate.
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { isScheduleDefinition, syncSchedulesViaLambda } from "@lotiai/composer";
+ * import { composer } from "./my-app-composer";
+ * import * as schedules from "./schedules";
+ *
+ * await syncSchedulesViaLambda(composer, {
+ *   schedules: Object.values(schedules).filter(isScheduleDefinition),
+ *   lambdaFunctionName: "loti-ic-prod-temporalschedulesync",
+ * });
+ * ```
+ *
+ * @module sync-schedules-via-lambda
+ */
+const client_lambda_1 = require("@aws-sdk/client-lambda");
+const DEFAULT_REGION = "us-east-1";
+/**
+ * Syncs composer schedules by invoking a schedule-sync Lambda (or emitting
+ * the payload to stdout).
+ *
+ * @param composer - Composer instance providing the namespace + logger
+ * @param options  - Schedules, Lambda function name, and mode/region/env flags
+ */
+async function syncSchedulesViaLambda(composer, options) {
+    const logger = composer.logger;
+    const { namespace } = composer.temporal;
+    const currentEnvironment = options.currentEnvironment ?? process.env.ENVIRONMENT_NAME ?? null;
+    const dryRun = options.dryRun ?? process.env.COMPOSER_SCHEDULE_SYNC_DRY_RUN === "true";
+    const mode = options.mode ?? "invoke";
+    const region = options.region ?? DEFAULT_REGION;
+    if (currentEnvironment === null && options.schedules.length > 0) {
+        logger.error("Cannot sync schedules: no current environment was provided", {
+            hint: "Set ENVIRONMENT_NAME or pass options.currentEnvironment to syncSchedulesViaLambda",
+            scheduleCount: options.schedules.length,
+        });
+        process.exit(1);
+    }
+    const activeSchedules = [];
+    const skippedSchedules = [];
+    for (const schedule of options.schedules) {
+        if (currentEnvironment !== null && schedule.environments.includes(currentEnvironment)) {
+            activeSchedules.push(schedule);
+        }
+        else {
+            skippedSchedules.push({
+                scheduleId: schedule.scheduleId,
+                environments: schedule.environments,
+            });
+        }
+    }
+    const payload = {
+        namespace,
+        schedules: activeSchedules,
+        dryRun,
+    };
+    logger.info("Preparing schedule sync payload", {
+        namespace,
+        currentEnvironment,
+        dryRun,
+        mode,
+        active: activeSchedules.length,
+        skipped: skippedSchedules.length,
+        ...(mode === "invoke" ? { lambdaFunctionName: options.lambdaFunctionName } : {}),
+    });
+    for (const { scheduleId, environments } of skippedSchedules) {
+        logger.debug("Skipping schedule (not active in current environment)", {
+            scheduleId,
+            environments,
+            currentEnvironment,
+        });
+    }
+    if (mode === "emit") {
+        process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+        return;
+    }
+    const client = new client_lambda_1.LambdaClient({ region });
+    let response;
+    try {
+        response = await client.send(new client_lambda_1.InvokeCommand({
+            FunctionName: options.lambdaFunctionName,
+            Payload: new TextEncoder().encode(JSON.stringify(payload)),
+            LogType: "Tail",
+        }));
+    }
+    catch (error) {
+        logger.error("Failed to invoke schedule-sync Lambda", {
+            lambdaFunctionName: options.lambdaFunctionName,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+    if (response.LogResult) {
+        const logs = Buffer.from(response.LogResult, "base64").toString("utf-8");
+        logger.info("Schedule-sync Lambda tail logs", { logs });
+    }
+    const responsePayload = response.Payload
+        ? JSON.parse(new TextDecoder().decode(response.Payload))
+        : null;
+    if (response.FunctionError) {
+        logger.error("Schedule-sync Lambda returned FunctionError", {
+            functionError: response.FunctionError,
+            payload: responsePayload,
+        });
+        process.exit(1);
+    }
+    const result = responsePayload;
+    logger.info("Schedule sync complete", {
+        namespace,
+        dryRun,
+        created: result?.created?.length ?? 0,
+        updated: result?.updated?.length ?? 0,
+        deleted: result?.deleted?.length ?? 0,
+        errors: result?.errors?.length ?? 0,
+    });
+    if (result?.errors && result.errors.length > 0) {
+        for (const { scheduleId, error } of result.errors) {
+            logger.error("Schedule failed to sync", { scheduleId, error });
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=sync-schedules-via-lambda.js.map

package/dist/internal/async/register-scripts/sync-schedules-via-lambda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-schedules-via-lambda.js","sourceRoot":"","sources":["../../../../src/internal/async/register-scripts/sync-schedules-via-lambda.ts"],"names":[],"mappings":"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"}