@generacy-ai/generacy 0.0.0-preview-20260304013206

package/dist/cli/commands/worker.js

@@ -0,0 +1,224 @@
+/**
+ * Worker command implementation.
+ * Connects to orchestrator and processes jobs.
+ */
+import { Command } from 'commander';
+import { randomUUID } from 'node:crypto';
+import { hostname } from 'node:os';
+import { getLogger, createWorkflowLogger } from '../utils/logger.js';
+import { createConfig } from '../utils/config.js';
+import { OrchestratorClient, OrchestratorClientError, HeartbeatManager, JobHandler, } from '../../orchestrator/index.js';
+import { HumancyApiDecisionHandler } from '@generacy-ai/workflow-engine';
+import { createHealthServer } from '../../health/server.js';
+/**
+ * Create the worker command
+ */
+export function workerCommand() {
+    const command = new Command('worker');
+    command
+        .description('Start a worker that processes jobs from the orchestrator')
+        .option('-u, --url <url>', 'Orchestrator URL', process.env['ORCHESTRATOR_URL'])
+        .option('-i, --worker-id <id>', 'Worker ID (auto-generated if not provided)')
+        .option('-n, --worker-name <name>', 'Worker name', `worker-${hostname()}`)
+        .option('-c, --capabilities <caps...>', 'Worker capabilities/tags', [])
+        .option('-w, --workdir <path>', 'Working directory for job execution', process.cwd())
+        .option('-p, --health-port <port>', 'Health check port', '8080')
+        .option('--heartbeat-interval <ms>', 'Heartbeat interval in milliseconds', '30000')
+        .option('--poll-interval <ms>', 'Job poll interval in milliseconds', '5000')
+        .option('--max-concurrent <n>', 'Maximum concurrent jobs', '1')
+        .action(async (options) => {
+        const logger = getLogger();
+        // Validate required options
+        if (!options['url']) {
+            logger.error('Orchestrator URL is required. Set ORCHESTRATOR_URL env var or use --url option');
+            process.exit(1);
+        }
+        // Create configuration
+        const config = createConfig({
+            orchestratorUrl: options['url'],
+            workerId: options['workerId'],
+            workdir: options['workdir'],
+            healthPort: parseInt(options['healthPort'], 10),
+            heartbeatInterval: parseInt(options['heartbeatInterval'], 10),
+            pollInterval: parseInt(options['pollInterval'], 10),
+        });
+        const workerId = config.workerId ?? randomUUID();
+        const workerName = options['workerName'] ?? `worker-${hostname()}`;
+        const capabilities = options['capabilities'] ?? [];
+        logger.info({ workerId, workerName, capabilities }, 'Starting worker');
+        // Create orchestrator client
+        const client = new OrchestratorClient({
+            baseUrl: config.orchestratorUrl,
+        });
+        // Register worker
+        const registration = {
+            id: workerId,
+            name: workerName,
+            capabilities,
+            maxConcurrent: parseInt(options['maxConcurrent'], 10),
+            healthEndpoint: `http://localhost:${config.healthPort}/health`,
+        };
+        try {
+            await client.register(registration);
+            logger.info({ workerId }, 'Worker registered with orchestrator');
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            logger.error({ error: msg }, 'Failed to register worker');
+            process.exit(1);
+        }
+        // Re-registration helper for when the orchestrator drops us
+        let isReregistering = false;
+        const reregister = async () => {
+            if (isReregistering)
+                return;
+            isReregistering = true;
+            try {
+                logger.info({ workerId }, 'Worker not found in orchestrator, re-registering...');
+                await client.register(registration);
+                logger.info({ workerId }, 'Worker re-registered with orchestrator');
+            }
+            catch (regError) {
+                const msg = regError instanceof Error ? regError.message : String(regError);
+                logger.error({ error: msg }, 'Re-registration failed');
+            }
+            finally {
+                isReregistering = false;
+            }
+        };
+        // Helper to detect WORKER_NOT_FOUND errors
+        const isWorkerNotFound = (error) => error instanceof OrchestratorClientError && error.code === 'WORKER_NOT_FOUND';
+        // Create heartbeat manager
+        const heartbeatManager = new HeartbeatManager({
+            client,
+            workerId,
+            interval: config.heartbeatInterval,
+            onCommand: (cmd) => {
+                logger.info({ command: cmd }, 'Received command from orchestrator');
+                if (cmd.type === 'shutdown') {
+                    logger.info('Shutdown requested by orchestrator');
+                    shutdown();
+                }
+                else if (cmd.type === 'cancel') {
+                    logger.info('Cancel requested by orchestrator');
+                    jobHandler.cancelCurrentJob();
+                }
+            },
+            onError: (error) => {
+                logger.warn({ error: error.message }, 'Heartbeat failed');
+                if (isWorkerNotFound(error)) {
+                    reregister();
+                }
+            },
+        });
+        // Create Humancy API decision handler if configured
+        const humancyApiUrl = process.env['HUMANCY_API_URL'];
+        let humanDecisionHandler;
+        if (humancyApiUrl) {
+            const humancyAgentId = process.env['HUMANCY_AGENT_ID'] ?? workerId;
+            const humancyAuthToken = process.env['HUMANCY_AUTH_TOKEN'] ?? process.env['ORCHESTRATOR_TOKEN'];
+            const handlerLogger = {
+                info: (msg) => logger.info(msg),
+                warn: (msg) => logger.warn(msg),
+                error: (msg) => logger.error(msg),
+                debug: (msg) => logger.debug(msg),
+            };
+            humanDecisionHandler = new HumancyApiDecisionHandler({
+                apiUrl: humancyApiUrl,
+                agentId: humancyAgentId,
+                authToken: humancyAuthToken,
+                fallbackToSimulation: true,
+            }, handlerLogger);
+            logger.info({ humancyApiUrl, humancyAgentId }, 'Humancy API decision handler configured');
+        }
+        // Create job handler
+        const workflowLogger = createWorkflowLogger(logger);
+        const jobHandler = new JobHandler({
+            client,
+            workerId,
+            pollInterval: config.pollInterval,
+            logger: workflowLogger,
+            workdir: config.workdir,
+            capabilities,
+            humanDecisionHandler,
+            onJobStart: (job) => {
+                logger.info({ jobId: job.id, jobName: job.name }, 'Job started');
+                heartbeatManager.setStatus('busy');
+                heartbeatManager.setCurrentJob(job.id);
+            },
+            onJobComplete: (job, result) => {
+                logger.info({ jobId: job.id, status: result.status }, 'Job completed');
+                heartbeatManager.setStatus('idle');
+                heartbeatManager.setCurrentJob(undefined);
+            },
+            onError: (error, job) => {
+                logger.error({ error: error.message, jobId: job?.id }, 'Job error');
+                if (isWorkerNotFound(error)) {
+                    reregister();
+                }
+            },
+        });
+        // Create health server
+        const healthServer = createHealthServer({
+            port: config.healthPort,
+            getStatus: () => ({
+                status: jobHandler.isBusy() ? 'busy' : 'healthy',
+                uptime: heartbeatManager.getUptime(),
+                lastHeartbeat: heartbeatManager.getLastHeartbeat()?.toISOString(),
+                currentJob: jobHandler.getCurrentJob()?.id,
+            }),
+        });
+        // Graceful shutdown handler
+        let isShuttingDown = false;
+        const shutdown = async () => {
+            if (isShuttingDown) {
+                return;
+            }
+            isShuttingDown = true;
+            logger.info('Shutting down worker...');
+            heartbeatManager.setStatus('stopping');
+            // Stop accepting new jobs
+            jobHandler.stop();
+            // Wait for current job to finish (with timeout)
+            const shutdownTimeout = 60000; // 1 minute
+            const startTime = Date.now();
+            while (jobHandler.isBusy() && Date.now() - startTime < shutdownTimeout) {
+                await new Promise(resolve => setTimeout(resolve, 1000));
+            }
+            // Force cancel if still running
+            if (jobHandler.isBusy()) {
+                logger.warn('Shutdown timeout reached, cancelling current job');
+                jobHandler.cancelCurrentJob();
+                await new Promise(resolve => setTimeout(resolve, 5000));
+            }
+            // Stop heartbeat
+            heartbeatManager.stop();
+            // Unregister from orchestrator
+            try {
+                await client.unregister(workerId);
+                logger.info('Worker unregistered from orchestrator');
+            }
+            catch (error) {
+                logger.warn({ error }, 'Failed to unregister worker');
+            }
+            // Close health server
+            healthServer.close();
+            logger.info('Worker shutdown complete');
+            process.exit(0);
+        };
+        // Handle signals
+        process.on('SIGTERM', shutdown);
+        process.on('SIGINT', shutdown);
+        // Start services
+        heartbeatManager.start();
+        jobHandler.start();
+        healthServer.listen();
+        logger.info({
+            workerId,
+            orchestratorUrl: config.orchestratorUrl,
+            healthPort: config.healthPort,
+        }, 'Worker started and ready to process jobs');
+    });
+    return command;
+}
+//# sourceMappingURL=worker.js.map

package/dist/cli/commands/worker.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CLI entry point.
+ * Sets up Commander.js program and registers subcommands.
+ */
+import { Command } from 'commander';
+/**
+ * Create and configure the CLI program
+ */
+export declare function createProgram(): Command;
+/**
+ * Run the CLI with given arguments
+ */
+export declare function run(args?: string[]): Promise<void>;
+//# 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;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA6BvC;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBtE"}

package/dist/cli/index.js

@@ -0,0 +1,68 @@
+/**
+ * CLI entry point.
+ * Sets up Commander.js program and registers subcommands.
+ */
+import { Command } from 'commander';
+import { runCommand } from './commands/run.js';
+import { workerCommand } from './commands/worker.js';
+import { agentCommand } from './commands/agent.js';
+import { orchestratorCommand } from './commands/orchestrator.js';
+import { setupCommand } from './commands/setup.js';
+import { validateCommand } from './commands/validate.js';
+import { doctorCommand } from './commands/doctor.js';
+import { initCommand } from './commands/init/index.js';
+import { createLogger, setLogger } from './utils/logger.js';
+// Package version - will be replaced at build time
+const VERSION = '0.0.1';
+/**
+ * Create and configure the CLI program
+ */
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('generacy')
+        .description('Generacy CLI - Headless workflow execution engine')
+        .version(VERSION)
+        .option('-l, --log-level <level>', 'Log level (trace, debug, info, warn, error, fatal, silent)', 'info')
+        .option('--no-pretty', 'Disable pretty logging (use JSON)')
+        .hook('preAction', (thisCommand) => {
+        const opts = thisCommand.opts();
+        const logger = createLogger({
+            level: opts['logLevel'],
+            pretty: opts['pretty'] !== false,
+        });
+        setLogger(logger);
+    });
+    // Register subcommands
+    program.addCommand(runCommand());
+    program.addCommand(workerCommand());
+    program.addCommand(agentCommand());
+    program.addCommand(orchestratorCommand());
+    program.addCommand(setupCommand());
+    program.addCommand(validateCommand());
+    program.addCommand(doctorCommand());
+    program.addCommand(initCommand());
+    return program;
+}
+/**
+ * Run the CLI with given arguments
+ */
+export async function run(args = process.argv) {
+    const program = createProgram();
+    try {
+        await program.parseAsync(args);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Error: ${error.message}`);
+            if (process.env['DEBUG']) {
+                console.error(error.stack);
+            }
+        }
+        else {
+            console.error('An unknown error occurred');
+        }
+        process.exit(1);
+    }
+}
+//# 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;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG5D,mDAAmD;AACnD,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,mDAAmD,CAAC;SAChE,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,yBAAyB,EAAE,4DAA4D,EAAE,MAAM,CAAC;SACvG,MAAM,CAAC,aAAa,EAAE,mCAAmC,CAAC;SAC1D,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,KAAK,EAAE,IAAI,CAAC,UAAU,CAAa;YACnC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK;SACjC,CAAC,CAAC;QACH,SAAS,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEL,uBAAuB;IACvB,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IAElC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAiB,OAAO,CAAC,IAAI;IACrD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzC,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/utils/config.d.ts

@@ -0,0 +1,49 @@
+/**
+ * CLI configuration resolution.
+ * Merges defaults, environment variables, and CLI arguments.
+ */
+import type { LogLevel } from './logger.js';
+/**
+ * CLI configuration interface
+ */
+export interface CLIConfig {
+    /** Log level */
+    logLevel: LogLevel;
+    /** Enable pretty logging (colors, formatting) */
+    prettyLog: boolean;
+    /** Default workflow file path */
+    workflowFile?: string;
+    /** Working directory for workflow execution */
+    workdir: string;
+    /** Orchestrator URL for worker mode */
+    orchestratorUrl?: string;
+    /** Worker ID for registration */
+    workerId?: string;
+    /** Health check port */
+    healthPort: number;
+    /** Heartbeat interval in milliseconds */
+    heartbeatInterval: number;
+    /** Job poll interval in milliseconds */
+    pollInterval: number;
+    /** Agency mode: 'subprocess' | 'network' */
+    agencyMode: 'subprocess' | 'network';
+    /** Agency URL for network mode */
+    agencyUrl?: string;
+    /** Agency command for subprocess mode */
+    agencyCommand?: string;
+}
+/**
+ * Resolve final configuration by merging sources
+ * Priority: CLI args > env vars > defaults
+ */
+export declare function resolveConfig(cliArgs?: Partial<CLIConfig>): CLIConfig;
+/**
+ * Validate configuration
+ * @throws Error if configuration is invalid
+ */
+export declare function validateConfig(config: CLIConfig): void;
+/**
+ * Create and validate configuration
+ */
+export declare function createConfig(cliArgs?: Partial<CLIConfig>): CLIConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,gBAAgB;IAChB,QAAQ,EAAE,QAAQ,CAAC;IAEnB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IAEnB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IAErB,4CAA4C;IAC5C,UAAU,EAAE,YAAY,GAAG,SAAS,CAAC;IAErC,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAoFD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS,CAQzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqBtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS,CAIxE"}

package/dist/cli/utils/config.js

@@ -0,0 +1,110 @@
+/**
+ * Default configuration values
+ */
+const defaults = {
+    logLevel: 'info',
+    prettyLog: process.env['NODE_ENV'] !== 'production',
+    workdir: process.cwd(),
+    healthPort: 8080,
+    heartbeatInterval: 30000, // 30 seconds
+    pollInterval: 5000, // 5 seconds
+    agencyMode: 'subprocess',
+};
+/**
+ * Read configuration from environment variables
+ */
+function readEnvConfig() {
+    const config = {};
+    if (process.env['LOG_LEVEL']) {
+        config.logLevel = process.env['LOG_LEVEL'];
+    }
+    if (process.env['GENERACY_PRETTY_LOG']) {
+        config.prettyLog = process.env['GENERACY_PRETTY_LOG'] === 'true';
+    }
+    if (process.env['GENERACY_WORKFLOW_FILE']) {
+        config.workflowFile = process.env['GENERACY_WORKFLOW_FILE'];
+    }
+    if (process.env['GENERACY_WORKDIR']) {
+        config.workdir = process.env['GENERACY_WORKDIR'];
+    }
+    if (process.env['ORCHESTRATOR_URL']) {
+        config.orchestratorUrl = process.env['ORCHESTRATOR_URL'];
+    }
+    if (process.env['WORKER_ID']) {
+        config.workerId = process.env['WORKER_ID'];
+    }
+    if (process.env['HEALTH_PORT']) {
+        const port = parseInt(process.env['HEALTH_PORT'], 10);
+        if (!isNaN(port)) {
+            config.healthPort = port;
+        }
+    }
+    if (process.env['HEARTBEAT_INTERVAL']) {
+        const interval = parseInt(process.env['HEARTBEAT_INTERVAL'], 10);
+        if (!isNaN(interval)) {
+            config.heartbeatInterval = interval;
+        }
+    }
+    if (process.env['POLL_INTERVAL']) {
+        const interval = parseInt(process.env['POLL_INTERVAL'], 10);
+        if (!isNaN(interval)) {
+            config.pollInterval = interval;
+        }
+    }
+    if (process.env['AGENCY_MODE']) {
+        const mode = process.env['AGENCY_MODE'];
+        if (mode === 'subprocess' || mode === 'network') {
+            config.agencyMode = mode;
+        }
+    }
+    if (process.env['AGENCY_URL']) {
+        config.agencyUrl = process.env['AGENCY_URL'];
+    }
+    if (process.env['AGENCY_COMMAND']) {
+        config.agencyCommand = process.env['AGENCY_COMMAND'];
+    }
+    return config;
+}
+/**
+ * Resolve final configuration by merging sources
+ * Priority: CLI args > env vars > defaults
+ */
+export function resolveConfig(cliArgs = {}) {
+    const envConfig = readEnvConfig();
+    return {
+        ...defaults,
+        ...envConfig,
+        ...cliArgs,
+    };
+}
+/**
+ * Validate configuration
+ * @throws Error if configuration is invalid
+ */
+export function validateConfig(config) {
+    const validLogLevels = ['trace', 'debug', 'info', 'warn', 'error', 'fatal', 'silent'];
+    if (!validLogLevels.includes(config.logLevel)) {
+        throw new Error(`Invalid log level: ${config.logLevel}. Valid levels: ${validLogLevels.join(', ')}`);
+    }
+    if (config.healthPort < 0 || config.healthPort > 65535) {
+        throw new Error(`Invalid health port: ${config.healthPort}. Must be between 0 and 65535`);
+    }
+    if (config.heartbeatInterval < 1000) {
+        throw new Error(`Heartbeat interval too short: ${config.heartbeatInterval}ms. Minimum is 1000ms`);
+    }
+    if (config.pollInterval < 1000) {
+        throw new Error(`Poll interval too short: ${config.pollInterval}ms. Minimum is 1000ms`);
+    }
+    if (config.agencyMode === 'network' && !config.agencyUrl) {
+        throw new Error('Agency URL is required when agency mode is "network"');
+    }
+}
+/**
+ * Create and validate configuration
+ */
+export function createConfig(cliArgs = {}) {
+    const config = resolveConfig(cliArgs);
+    validateConfig(config);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/utils/config.js.map

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

package/dist/cli/utils/exec.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shell execution utilities for CLI commands.
+ * Wraps child_process.execSync and spawn with structured logging.
+ */
+import { type ChildProcess, type SpawnOptions } from 'node:child_process';
+/**
+ * Options for synchronous command execution.
+ */
+export interface ExecOptions {
+    /** Working directory for the command */
+    cwd?: string;
+    /** Environment variables merged with process.env */
+    env?: Record<string, string | undefined>;
+    /** Execution timeout in milliseconds */
+    timeout?: number;
+    /** stdout/stderr handling: 'pipe' captures output, 'inherit' streams to parent */
+    stdio?: 'pipe' | 'inherit';
+}
+/**
+ * Result of a safe (non-throwing) command execution.
+ */
+export interface ExecResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Run a command synchronously, return stdout. Throws on non-zero exit.
+ */
+export declare function exec(cmd: string, options?: ExecOptions): string;
+/**
+ * Run a command synchronously, return success boolean. Does not throw.
+ */
+export declare function execSafe(cmd: string, options?: ExecOptions): ExecResult;
+/**
+ * Spawn a long-running background process. Returns ChildProcess.
+ */
+export declare function spawnBackground(cmd: string, args: string[], options?: SpawnOptions): ChildProcess;
+//# sourceMappingURL=exec.d.ts.map

package/dist/cli/utils/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/exec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG3F;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAe/D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU,CAsBvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,YAAY,GACrB,YAAY,CAUd"}

package/dist/cli/utils/exec.js

@@ -0,0 +1,68 @@
+/**
+ * Shell execution utilities for CLI commands.
+ * Wraps child_process.execSync and spawn with structured logging.
+ */
+import { execSync, spawn } from 'node:child_process';
+import { getLogger } from './logger.js';
+/**
+ * Run a command synchronously, return stdout. Throws on non-zero exit.
+ */
+export function exec(cmd, options) {
+    const logger = getLogger();
+    logger.debug({ cmd, cwd: options?.cwd }, 'exec');
+    try {
+        return execSync(cmd, {
+            encoding: 'utf-8',
+            cwd: options?.cwd,
+            env: options?.env ? { ...process.env, ...options.env } : undefined,
+            timeout: options?.timeout,
+            stdio: options?.stdio === 'inherit' ? 'inherit' : 'pipe',
+        }).trim();
+    }
+    catch (error) {
+        logger.error({ cmd, error: String(error) }, 'Command failed');
+        throw error;
+    }
+}
+/**
+ * Run a command synchronously, return success boolean. Does not throw.
+ */
+export function execSafe(cmd, options) {
+    const logger = getLogger();
+    logger.debug({ cmd, cwd: options?.cwd }, 'execSafe');
+    try {
+        const stdout = execSync(cmd, {
+            encoding: 'utf-8',
+            cwd: options?.cwd,
+            env: options?.env ? { ...process.env, ...options.env } : undefined,
+            timeout: options?.timeout,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return { ok: true, stdout, stderr: '' };
+    }
+    catch (error) {
+        const execError = error;
+        const stdout = typeof execError.stdout === 'string'
+            ? execError.stdout.trim()
+            : (execError.stdout?.toString() ?? '').trim();
+        const stderr = typeof execError.stderr === 'string'
+            ? execError.stderr.trim()
+            : (execError.stderr?.toString() ?? '').trim();
+        return { ok: false, stdout, stderr };
+    }
+}
+/**
+ * Spawn a long-running background process. Returns ChildProcess.
+ */
+export function spawnBackground(cmd, args, options) {
+    const logger = getLogger();
+    logger.debug({ cmd, args, cwd: options?.cwd }, 'spawnBackground');
+    const child = spawn(cmd, args, {
+        detached: true,
+        stdio: 'ignore',
+        ...options,
+    });
+    child.unref();
+    return child;
+}
+//# sourceMappingURL=exec.js.map

package/dist/cli/utils/exec.js.map

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