@lotiai/composer 0.2.0 → 0.2.1

package/dist/build-config/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Composer Build Configuration Module
+ *
+ * This module provides build configuration utilities for the @lotiai/composer package.
+ * External teams can use this to configure their own composer setup.
+ *
+ * @example
+ * ```typescript
+ * // composer.build-config.ts
+ * import { defineBuildConfig } from "@lotiai/composer/build-config";
+ *
+ * export default defineBuildConfig({
+ *   dev: {
+ *     startAllWorkersJsScript: "dist/scripts/start-all-workers.js",
+ *     watchPatterns: ["src/**\/*.ts"],
+ *   },
+ * });
+ * ```
+ */
+import type { ComposerBuildConfig, ComposerBuildConfigInput } from "./schema";
+export { clearBuildConfigCache, getBuildConfigFilePath, hasBuildConfigFile, type LoadBuildConfigOptions, type LoadedBuildConfig, loadBuildConfig, } from "./loader";
+export { type ComposerBuildConfig, type ComposerBuildConfigInput, ComposerBuildConfigSchema, type EnvExclusiveOptIn, type WorkerProfileOverrides, type WorkerProfileResources, WorkerProfileResourcesSchema, } from "./schema";
+/**
+ * Helper function for creating a type-safe composer build configuration.
+ *
+ * This function provides TypeScript IntelliSense and validation hints
+ * when creating a composer.build-config.ts file.
+ *
+ * @param config - The composer build configuration
+ * @returns The same configuration (identity function for type inference)
+ *
+ * @example
+ * ```typescript
+ * // composer.build-config.ts
+ * import { defineBuildConfig } from "@lotiai/composer/build-config";
+ *
+ * export default defineBuildConfig({
+ *   workerProfiles: {
+ *     standard: {
+ *       cpu: 1024,
+ *       memory: 4096,
+ *       maxConcurrentActivities: 20,
+ *     },
+ *   },
+ *   dev: {
+ *     startAllWorkersJsScript: "dist/scripts/start-all-workers.js",
+ *   },
+ * });
+ * ```
+ */
+export declare function defineBuildConfig(config: ComposerBuildConfigInput): ComposerBuildConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/build-config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build-config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAI9E,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,4BAA4B,GAC7B,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,wBAAwB,GAAG,mBAAmB,CAEvF"}

package/dist/build-config/index.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Composer Build Configuration Module
+ *
+ * This module provides build configuration utilities for the @lotiai/composer package.
+ * External teams can use this to configure their own composer setup.
+ *
+ * @example
+ * ```typescript
+ * // composer.build-config.ts
+ * import { defineBuildConfig } from "@lotiai/composer/build-config";
+ *
+ * export default defineBuildConfig({
+ *   dev: {
+ *     startAllWorkersJsScript: "dist/scripts/start-all-workers.js",
+ *     watchPatterns: ["src/**\/*.ts"],
+ *   },
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerProfileResourcesSchema = exports.ComposerBuildConfigSchema = exports.loadBuildConfig = exports.hasBuildConfigFile = exports.getBuildConfigFilePath = exports.clearBuildConfigCache = void 0;
+exports.defineBuildConfig = defineBuildConfig;
+const schema_1 = require("./schema");
+// Loader exports
+var loader_1 = require("./loader");
+Object.defineProperty(exports, "clearBuildConfigCache", { enumerable: true, get: function () { return loader_1.clearBuildConfigCache; } });
+Object.defineProperty(exports, "getBuildConfigFilePath", { enumerable: true, get: function () { return loader_1.getBuildConfigFilePath; } });
+Object.defineProperty(exports, "hasBuildConfigFile", { enumerable: true, get: function () { return loader_1.hasBuildConfigFile; } });
+Object.defineProperty(exports, "loadBuildConfig", { enumerable: true, get: function () { return loader_1.loadBuildConfig; } });
+// Schema exports
+var schema_2 = require("./schema");
+Object.defineProperty(exports, "ComposerBuildConfigSchema", { enumerable: true, get: function () { return schema_2.ComposerBuildConfigSchema; } });
+Object.defineProperty(exports, "WorkerProfileResourcesSchema", { enumerable: true, get: function () { return schema_2.WorkerProfileResourcesSchema; } });
+/**
+ * Helper function for creating a type-safe composer build configuration.
+ *
+ * This function provides TypeScript IntelliSense and validation hints
+ * when creating a composer.build-config.ts file.
+ *
+ * @param config - The composer build configuration
+ * @returns The same configuration (identity function for type inference)
+ *
+ * @example
+ * ```typescript
+ * // composer.build-config.ts
+ * import { defineBuildConfig } from "@lotiai/composer/build-config";
+ *
+ * export default defineBuildConfig({
+ *   workerProfiles: {
+ *     standard: {
+ *       cpu: 1024,
+ *       memory: 4096,
+ *       maxConcurrentActivities: 20,
+ *     },
+ *   },
+ *   dev: {
+ *     startAllWorkersJsScript: "dist/scripts/start-all-workers.js",
+ *   },
+ * });
+ * ```
+ */
+function defineBuildConfig(config) {
+    return schema_1.ComposerBuildConfigSchema.parse(config);
+}
+//# sourceMappingURL=index.js.map

package/dist/build-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/build-config/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAqDH,8CAEC;AApDD,qCAAqD;AAErD,iBAAiB;AACjB,mCAOkB;AANhB,+GAAA,qBAAqB,OAAA;AACrB,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAGlB,yGAAA,eAAe,OAAA;AAEjB,iBAAiB;AACjB,mCAQkB;AALhB,mHAAA,yBAAyB,OAAA;AAIzB,sHAAA,4BAA4B,OAAA;AAG9B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,iBAAiB,CAAC,MAAgC;IAChE,OAAO,kCAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/build-config/loader.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Composer Build Configuration Loader
+ *
+ * Loads and validates composer build configuration from a config file.
+ * Supports TypeScript (.ts), JavaScript (.js), and JSON (.json) config files.
+ *
+ * TypeScript files are loaded using jiti, which provides transparent
+ * TypeScript support without requiring pre-compilation.
+ */
+import { type ComposerBuildConfig } from "./schema";
+/**
+ * Result of loading a build config file.
+ */
+export interface LoadedBuildConfig {
+    /** The validated and resolved configuration */
+    config: ComposerBuildConfig;
+    /** Absolute path to the config file */
+    configPath: string;
+    /** Directory containing the config file (used for resolving relative paths) */
+    configDir: string;
+}
+/**
+ * Options for loading build configuration.
+ */
+export interface LoadBuildConfigOptions {
+    /**
+     * Explicit path to config file.
+     * If not provided, searches for config files in searchDir.
+     */
+    configPath?: string;
+    /**
+     * Directory to search for config file.
+     * @default process.cwd()
+     */
+    searchDir?: string;
+}
+/**
+ * Clears the cached build config, forcing the next `loadBuildConfig()` call to reload from disk.
+ * Primarily useful for testing.
+ */
+export declare function clearBuildConfigCache(): void;
+/**
+ * Loads, validates, and resolves a composer build configuration.
+ *
+ * Results are cached per-process: the first call reads from disk and validates,
+ * subsequent calls return the cached result immediately. This is safe because
+ * config files do not change during a single CLI or build invocation.
+ *
+ * @param options - Options for loading the config
+ * @returns The loaded and validated configuration
+ * @throws Error if config file is not found or validation fails
+ *
+ * @example
+ * ```typescript
+ * // Load from current directory
+ * const { config, configDir } = await loadBuildConfig();
+ *
+ * // Load from specific path
+ * const { config } = await loadBuildConfig({ configPath: "./my-config.ts" });
+ *
+ * // Load from specific directory
+ * const { config } = await loadBuildConfig({ searchDir: "/path/to/project" });
+ * ```
+ */
+export declare function loadBuildConfig(options?: LoadBuildConfigOptions): Promise<LoadedBuildConfig>;
+/**
+ * Synchronously checks if a build config file exists in the given directory.
+ *
+ * @param searchDir - Directory to search in
+ * @returns true if a build config file exists
+ */
+export declare function hasBuildConfigFile(searchDir?: string): boolean;
+/**
+ * Gets the path to the build config file without loading it.
+ *
+ * @param searchDir - Directory to search in
+ * @returns Absolute path to config file, or undefined if not found
+ */
+export declare function getBuildConfigFilePath(searchDir?: string): string | undefined;
+//# sourceMappingURL=loader.d.ts.map

package/dist/build-config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/build-config/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,UAAU,CAAC;AAclB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAyGD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAoD5B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,MAAsB,GAAG,OAAO,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,MAAsB,GAAG,MAAM,GAAG,SAAS,CAE5F"}

package/dist/build-config/loader.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * Composer Build Configuration Loader
+ *
+ * Loads and validates composer build configuration from a config file.
+ * Supports TypeScript (.ts), JavaScript (.js), and JSON (.json) config files.
+ *
+ * TypeScript files are loaded using jiti, which provides transparent
+ * TypeScript support without requiring pre-compilation.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearBuildConfigCache = clearBuildConfigCache;
+exports.loadBuildConfig = loadBuildConfig;
+exports.hasBuildConfigFile = hasBuildConfigFile;
+exports.getBuildConfigFilePath = getBuildConfigFilePath;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const jiti_1 = require("jiti");
+const schema_1 = require("./schema");
+/**
+ * Default config file names to search for, in order of preference.
+ */
+const BUILD_CONFIG_FILE_NAMES = [
+    "composer.build-config.ts",
+    "composer.build-config.js",
+    "composer.build-config.json",
+    // Compiled fallback: src/build-config.ts -> dist/build-config.js
+    // In Docker images, root-level config files are pruned but dist/ survives.
+    "dist/build-config.js",
+];
+/**
+ * Finds a build config file by searching for known config file names.
+ *
+ * @param searchDir - Directory to search in
+ * @returns Absolute path to config file, or undefined if not found
+ */
+function findBuildConfigFile(searchDir) {
+    for (const fileName of BUILD_CONFIG_FILE_NAMES) {
+        const filePath = path.join(searchDir, fileName);
+        if (fs.existsSync(filePath)) {
+            return filePath;
+        }
+    }
+    return undefined;
+}
+/**
+ * Extracts the config object from a loaded module, supporting default export,
+ * named 'config' export, and direct module.exports.
+ *
+ * Handles jiti's double-wrapping of CJS default exports where
+ * `module.default` may itself contain a nested `default` key.
+ */
+function extractConfigExport(configPath, module) {
+    let config = module.default ??
+        module.config ??
+        module;
+    // jiti may double-wrap CJS default exports: { default: { default: actualConfig } }
+    if (config && typeof config === "object" && "default" in config) {
+        config = config.default;
+    }
+    if (!config || typeof config !== "object") {
+        throw new Error(`Config file ${configPath} must export a config object (default export, named 'config', or module.exports)`);
+    }
+    return config;
+}
+/**
+ * Loads a build config file and returns its contents.
+ * Uses jiti for TypeScript/JavaScript files to support .ts configs without compilation.
+ *
+ * @param configPath - Absolute path to the config file
+ * @returns The config object (unvalidated)
+ */
+async function loadBuildConfigFile(configPath) {
+    const ext = path.extname(configPath).toLowerCase();
+    if (ext === ".json") {
+        const content = fs.readFileSync(configPath, "utf-8");
+        return JSON.parse(content);
+    }
+    if (ext === ".ts" || ext === ".js") {
+        // Use jiti to load TypeScript/JavaScript config files
+        // jiti provides transparent TypeScript support without pre-compilation
+        const jiti = (0, jiti_1.createJiti)(__filename, {
+            fsCache: false,
+            moduleCache: false,
+        });
+        const module = await jiti.import(configPath);
+        return extractConfigExport(configPath, module);
+    }
+    throw new Error(`Unsupported config file extension: ${ext}`);
+}
+/**
+ * Resolves relative paths in the config to absolute paths.
+ *
+ * @param config - The parsed config
+ * @param configDir - Directory containing the config file
+ * @returns Config with resolved paths
+ */
+function resolveBuildConfigPaths(config, configDir) {
+    const watchPatterns = (config.dev.watchPatterns ?? ["src/**/*.ts"]).map((p) => path.isAbsolute(p) ? p : path.join(configDir, p));
+    return {
+        ...config,
+        dev: {
+            ...config.dev,
+            watchPatterns,
+        },
+    };
+}
+/**
+ * Cached config result. The config is loaded once per process and reused.
+ * Only a single config is supported per process; passing different options
+ * to subsequent calls is treated as a programming error and will throw.
+ */
+let cachedResult;
+/**
+ * Clears the cached build config, forcing the next `loadBuildConfig()` call to reload from disk.
+ * Primarily useful for testing.
+ */
+function clearBuildConfigCache() {
+    cachedResult = undefined;
+}
+/**
+ * Loads, validates, and resolves a composer build configuration.
+ *
+ * Results are cached per-process: the first call reads from disk and validates,
+ * subsequent calls return the cached result immediately. This is safe because
+ * config files do not change during a single CLI or build invocation.
+ *
+ * @param options - Options for loading the config
+ * @returns The loaded and validated configuration
+ * @throws Error if config file is not found or validation fails
+ *
+ * @example
+ * ```typescript
+ * // Load from current directory
+ * const { config, configDir } = await loadBuildConfig();
+ *
+ * // Load from specific path
+ * const { config } = await loadBuildConfig({ configPath: "./my-config.ts" });
+ *
+ * // Load from specific directory
+ * const { config } = await loadBuildConfig({ searchDir: "/path/to/project" });
+ * ```
+ */
+async function loadBuildConfig(options = {}) {
+    if (cachedResult) {
+        return cachedResult;
+    }
+    const searchDir = options.searchDir ?? process.cwd();
+    // Find or use explicit config path
+    let configPath;
+    if (options.configPath) {
+        configPath = path.isAbsolute(options.configPath)
+            ? options.configPath
+            : path.resolve(searchDir, options.configPath);
+        if (!fs.existsSync(configPath)) {
+            throw new Error(`Config file not found: ${configPath}`);
+        }
+    }
+    else {
+        const foundPath = findBuildConfigFile(searchDir);
+        if (!foundPath) {
+            throw new Error(`No config file found. Expected one of: ${BUILD_CONFIG_FILE_NAMES.join(", ")} in ${searchDir}`);
+        }
+        configPath = foundPath;
+    }
+    const configDir = path.dirname(configPath);
+    // Load and parse the config file
+    const rawConfig = await loadBuildConfigFile(configPath);
+    // Validate with Zod
+    const parseResult = schema_1.ComposerBuildConfigSchema.safeParse(rawConfig);
+    if (!parseResult.success) {
+        const issues = parseResult.error.issues
+            .map((issue) => `  - ${issue.path.join(".")}: ${issue.message}`)
+            .join("\n");
+        throw new Error(`Invalid composer build config at ${configPath}:\n${issues}`);
+    }
+    // Resolve relative paths
+    const resolvedConfig = resolveBuildConfigPaths(parseResult.data, configDir);
+    const result = {
+        config: resolvedConfig,
+        configPath,
+        configDir,
+    };
+    cachedResult = result;
+    return result;
+}
+/**
+ * Synchronously checks if a build config file exists in the given directory.
+ *
+ * @param searchDir - Directory to search in
+ * @returns true if a build config file exists
+ */
+function hasBuildConfigFile(searchDir = process.cwd()) {
+    return findBuildConfigFile(searchDir) !== undefined;
+}
+/**
+ * Gets the path to the build config file without loading it.
+ *
+ * @param searchDir - Directory to search in
+ * @returns Absolute path to config file, or undefined if not found
+ */
+function getBuildConfigFilePath(searchDir = process.cwd()) {
+    return findBuildConfigFile(searchDir);
+}
+//# sourceMappingURL=loader.js.map

package/dist/build-config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/build-config/loader.ts"],"names":[],"mappings":"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"}

package/dist/build-config/schema.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Composer Build Configuration Schema
+ *
+ * Defines the build configuration schema for the @lotiai/composer package.
+ * This allows external teams to configure their own steps, workflows,
+ * and worker profiles.
+ */
+import { z } from "zod";
+/**
+ * Worker profile resource configuration (required version for defaults).
+ * This is the single source of truth for worker profile fields.
+ */
+export declare const WorkerProfileResourcesSchema: z.ZodObject<{
+    cpu: z.ZodNumber;
+    memory: z.ZodNumber;
+    maxConcurrentActivities: z.ZodNumber;
+    minCount: z.ZodNumber;
+    maxConcurrentWorkflows: z.ZodNumber;
+    initialCount: z.ZodNumber;
+    maxCount: z.ZodNumber;
+}, z.core.$strict>;
+/**
+ * Worker profile resource configuration (partial version for config overrides).
+ * All fields are optional - only specify what you want to override.
+ */
+declare const EnvExclusiveOptInSchema: z.ZodObject<{
+    environments: z.ZodArray<z.ZodString>;
+    fallbackProfile: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Worker profile override configuration.
+ * Resource fields are optional and support environment-specific deployment via envExclusiveOptIn.
+ */
+declare const WorkerProfileOverridesSchema: z.ZodObject<{
+    envExclusiveOptIn: z.ZodOptional<z.ZodObject<{
+        environments: z.ZodArray<z.ZodString>;
+        fallbackProfile: z.ZodString;
+    }, z.core.$strict>>;
+    cpu: z.ZodOptional<z.ZodNumber>;
+    memory: z.ZodOptional<z.ZodNumber>;
+    maxConcurrentActivities: z.ZodOptional<z.ZodNumber>;
+    minCount: z.ZodOptional<z.ZodNumber>;
+    maxConcurrentWorkflows: z.ZodOptional<z.ZodNumber>;
+    initialCount: z.ZodOptional<z.ZodNumber>;
+    maxCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * Development configuration for the `composer dev` CLI command.
+ */
+declare const DevConfigSchema: z.ZodObject<{
+    startAllWorkersJsScript: z.ZodOptional<z.ZodString>;
+    watchPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * Complete composer build configuration schema.
+ */
+export declare const ComposerBuildConfigSchema: z.ZodObject<{
+    workerProfiles: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        envExclusiveOptIn: z.ZodOptional<z.ZodObject<{
+            environments: z.ZodArray<z.ZodString>;
+            fallbackProfile: z.ZodString;
+        }, z.core.$strict>>;
+        cpu: z.ZodOptional<z.ZodNumber>;
+        memory: z.ZodOptional<z.ZodNumber>;
+        maxConcurrentActivities: z.ZodOptional<z.ZodNumber>;
+        minCount: z.ZodOptional<z.ZodNumber>;
+        maxConcurrentWorkflows: z.ZodOptional<z.ZodNumber>;
+        initialCount: z.ZodOptional<z.ZodNumber>;
+        maxCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>>;
+    dev: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        startAllWorkersJsScript: z.ZodOptional<z.ZodString>;
+        watchPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/**
+ * Inferred TypeScript type from the Zod schema.
+ */
+export type ComposerBuildConfig = z.infer<typeof ComposerBuildConfigSchema>;
+/**
+ * Input type for defineBuildConfig (allows partial output config).
+ */
+export type ComposerBuildConfigInput = z.input<typeof ComposerBuildConfigSchema>;
+/**
+ * Development configuration type.
+ */
+export type DevConfig = z.infer<typeof DevConfigSchema>;
+/**
+ * Worker profile resources type (all fields required - for defaults).
+ */
+export type WorkerProfileResources = z.infer<typeof WorkerProfileResourcesSchema>;
+/**
+ * Worker profile env opt-in type.
+ */
+export type EnvExclusiveOptIn = z.infer<typeof EnvExclusiveOptInSchema>;
+/**
+ * Worker profile overrides type (all fields optional - for config).
+ */
+export type WorkerProfileOverrides = z.infer<typeof WorkerProfileOverridesSchema>;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/build-config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/build-config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;kBAevC,CAAC;AAEH;;;GAGG;AACH,QAAA,MAAM,uBAAuB;;;kBAU3B,CAAC;AAEH;;;GAGG;AACH,QAAA,MAAM,4BAA4B;;;;;;;;;;;;kBAGhC,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,eAAe;;;kBAoBnB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;kBAapC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/build-config/schema.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Composer Build Configuration Schema
+ *
+ * Defines the build configuration schema for the @lotiai/composer package.
+ * This allows external teams to configure their own steps, workflows,
+ * and worker profiles.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComposerBuildConfigSchema = exports.WorkerProfileResourcesSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Worker profile resource configuration (required version for defaults).
+ * This is the single source of truth for worker profile fields.
+ */
+exports.WorkerProfileResourcesSchema = zod_1.z.strictObject({
+    /** CPU units (1024 = 1 vCPU) */
+    cpu: zod_1.z.number().int().positive(),
+    /** Memory in MB */
+    memory: zod_1.z.number().int().positive(),
+    /** Maximum concurrent activities per worker */
+    maxConcurrentActivities: zod_1.z.number().int().positive(),
+    /** Minimum number of worker instances (auto-scaling floor) */
+    minCount: zod_1.z.number().int().nonnegative(),
+    /** Maximum concurrent workflow task executions per worker */
+    maxConcurrentWorkflows: zod_1.z.number().int().positive(),
+    /** Initial number of worker instances before autoscaling takes over */
+    initialCount: zod_1.z.number().int().nonnegative(),
+    /** Maximum number of worker instances for auto-scaling */
+    maxCount: zod_1.z.number().int().positive(),
+});
+/**
+ * Worker profile resource configuration (partial version for config overrides).
+ * All fields are optional - only specify what you want to override.
+ */
+const EnvExclusiveOptInSchema = zod_1.z.strictObject({
+    /**
+     * Environments where this profile should be deployed as a dedicated worker.
+     * If the current env is not listed, the profile's queue is absorbed by fallbackProfile.
+     */
+    environments: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+    /**
+     * Profile that should consume this profile's task queue when not deployed.
+     */
+    fallbackProfile: zod_1.z.string().min(1),
+});
+/**
+ * Worker profile override configuration.
+ * Resource fields are optional and support environment-specific deployment via envExclusiveOptIn.
+ */
+const WorkerProfileOverridesSchema = zod_1.z.strictObject({
+    ...exports.WorkerProfileResourcesSchema.partial().shape,
+    envExclusiveOptIn: EnvExclusiveOptInSchema.optional(),
+});
+/**
+ * Development configuration for the `composer dev` CLI command.
+ */
+const DevConfigSchema = zod_1.z.strictObject({
+    /**
+     * Path to the compiled start-all-workers script to spawn for local dev,
+     * relative to cwd (the package directory containing composer.build-config.ts).
+     *
+     * Can be overridden via the `--worker-script` CLI argument.
+     *
+     * @example "dist/scripts/start-all-workers.js"
+     */
+    startAllWorkersJsScript: zod_1.z.string().min(1).optional(),
+    /**
+     * Glob patterns for files to watch in dev mode.
+     * Paths are relative to the config file location (or absolute).
+     *
+     * @default ["src\/**\/*.ts"]
+     * @example ["src\/**\/*.ts"]
+     * @example ["../../packages\/**\/src\/**\/*.ts"] (workspace: watch sibling packages)
+     */
+    watchPatterns: zod_1.z.array(zod_1.z.string().min(1)).min(1).optional(),
+});
+/**
+ * Complete composer build configuration schema.
+ */
+exports.ComposerBuildConfigSchema = zod_1.z.strictObject({
+    /**
+     * Optional worker profile overrides.
+     * Values are merged with defaults from worker-profiles.ts.
+     * Only specify fields you want to override.
+     * @example { standard: { cpu: 1024, memory: 4096 } }
+     */
+    workerProfiles: zod_1.z.record(zod_1.z.string(), WorkerProfileOverridesSchema).optional().default({}),
+    /**
+     * Development configuration for the `composer dev` CLI command.
+     */
+    dev: DevConfigSchema.optional().default({}),
+});
+//# sourceMappingURL=schema.js.map

package/dist/build-config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/build-config/schema.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,6BAAwB;AAExB;;;GAGG;AACU,QAAA,4BAA4B,GAAG,OAAC,CAAC,YAAY,CAAC;IACzD,gCAAgC;IAChC,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAChC,mBAAmB;IACnB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC,+CAA+C;IAC/C,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpD,8DAA8D;IAC9D,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACxC,6DAA6D;IAC7D,sBAAsB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnD,uEAAuE;IACvE,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,0DAA0D;IAC1D,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,uBAAuB,GAAG,OAAC,CAAC,YAAY,CAAC;IAC7C;;;OAGG;IACH,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C;;OAEG;IACH,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACnC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,4BAA4B,GAAG,OAAC,CAAC,YAAY,CAAC;IAClD,GAAG,oCAA4B,CAAC,OAAO,EAAE,CAAC,KAAK;IAC/C,iBAAiB,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,eAAe,GAAG,OAAC,CAAC,YAAY,CAAC;IACrC;;;;;;;OAOG;IACH,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAErD;;;;;;;OAOG;IACH,aAAa,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5D,CAAC,CAAC;AAEH;;GAEG;AACU,QAAA,yBAAyB,GAAG,OAAC,CAAC,YAAY,CAAC;IACtD;;;;;OAKG;IACH,cAAc,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,4BAA4B,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAEzF;;OAEG;IACH,GAAG,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5C,CAAC,CAAC"}