@northflare/runner 0.0.1

package/dist/types/messages.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * JSONRPC message types for communication between runner and orchestrator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=messages.js.map

package/dist/types/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/types/messages.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/runner-interface.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Interface for RunnerApp to ensure compatibility between different implementations
+ */
+import { RunnerConfig, ConversationContext, JsonRpcMessage } from './index';
+import { ClaudeManager } from '../components/claude-sdk-manager';
+import { EnhancedRepositoryManager } from '../components/enhanced-repository-manager';
+export interface IRunnerApp {
+    notify(method: string, params: any): Promise<void>;
+    sendToOrchestrator(message: JsonRpcMessage): Promise<any>;
+    getConversationContext(conversationId: string): ConversationContext | undefined;
+    get config_(): RunnerConfig;
+    get activeConversations_(): Map<string, ConversationContext>;
+    get claudeManager_(): ClaudeManager;
+    get repositoryManager_(): EnhancedRepositoryManager;
+    getRunnerId(): string | undefined;
+    getRunnerUid(): string | null;
+    getLastProcessedAt(): Date | null;
+    getIsActiveRunner(): boolean;
+    setIsActiveRunner(active: boolean): void;
+    setLastProcessedAt(timestamp: Date | null): void;
+    getPreHandoffConversations(): Set<string>;
+    updateLastProcessedAt?(timestamp: Date | null): Promise<void>;
+}
+//# sourceMappingURL=runner-interface.d.ts.map

package/dist/types/runner-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-interface.d.ts","sourceRoot":"","sources":["../../src/types/runner-interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAEtF,MAAM,WAAW,UAAU;IAEzB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAG1D,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAGhF,IAAI,OAAO,IAAI,YAAY,CAAC;IAC5B,IAAI,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC7D,IAAI,cAAc,IAAI,aAAa,CAAC;IACpC,IAAI,kBAAkB,IAAI,yBAAyB,CAAC;IAGpD,WAAW,IAAI,MAAM,GAAG,SAAS,CAAC;IAClC,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,IAAI,IAAI,GAAG,IAAI,CAAC;IAClC,iBAAiB,IAAI,OAAO,CAAC;IAC7B,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,kBAAkB,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjD,0BAA0B,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAG1C,qBAAqB,CAAC,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D"}

package/dist/types/runner-interface.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Interface for RunnerApp to ensure compatibility between different implementations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=runner-interface.js.map

package/dist/types/runner-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-interface.js","sourceRoot":"","sources":["../../src/types/runner-interface.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils/StateManager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * State Manager for persisting runner state
+ *
+ * Manages persistent state including lastProcessedAt timestamp
+ * to enable proper catch-up on restart.
+ */
+export interface RunnerState {
+    runnerId: string;
+    runnerUid: string | null;
+    lastProcessedAt: string | null;
+    isActiveRunner: boolean;
+    updatedAt: string;
+}
+export declare class StateManager {
+    private statePath;
+    private state;
+    private saveTimer;
+    constructor(dataDir: string, runnerId: string);
+    /**
+     * Load state from disk
+     */
+    loadState(): Promise<RunnerState | null>;
+    /**
+     * Save state to disk
+     */
+    saveState(state: RunnerState): Promise<void>;
+    /**
+     * Update lastProcessedAt timestamp
+     */
+    updateLastProcessedAt(timestamp: Date | string): Promise<void>;
+    /**
+     * Update runner registration details
+     */
+    updateRunnerRegistration(runnerId: string, runnerUid: string | null, lastProcessedAt: Date | null): Promise<void>;
+    /**
+     * Update active runner status
+     */
+    updateActiveStatus(isActive: boolean): Promise<void>;
+    /**
+     * Get current state
+     */
+    getState(): RunnerState | null;
+    /**
+     * Get lastProcessedAt as Date
+     */
+    getLastProcessedAt(): Date | null;
+    /**
+     * Clear state (for testing or reset)
+     */
+    clearState(): Promise<void>;
+}
+//# sourceMappingURL=StateManager.d.ts.map

package/dist/utils/StateManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateManager.d.ts","sourceRoot":"","sources":["../../src/utils/StateManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,SAAS,CAA+B;gBAEpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAM7C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAqB9C;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAmClD;;OAEG;IACG,qBAAqB,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAepE;;OAEG;IACG,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,eAAe,EAAE,IAAI,GAAG,IAAI,GAC3B,OAAO,CAAC,IAAI,CAAC;IAmBhB;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1D;;OAEG;IACH,QAAQ,IAAI,WAAW,GAAG,IAAI;IAI9B;;OAEG;IACH,kBAAkB,IAAI,IAAI,GAAG,IAAI;IAOjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAYlC"}

package/dist/utils/StateManager.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * State Manager for persisting runner state
+ *
+ * Manages persistent state including lastProcessedAt timestamp
+ * to enable proper catch-up on restart.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateManager = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const logger_1 = require("./logger");
+const logger = (0, logger_1.createLogger)('StateManager');
+class StateManager {
+    statePath;
+    state = null;
+    saveTimer = null;
+    constructor(dataDir, runnerId) {
+        // Namespace state file by runnerId (stable external ID) to separate different users
+        const stateFile = `runner-state-${runnerId}.json`;
+        this.statePath = path_1.default.join(dataDir, stateFile);
+    }
+    /**
+     * Load state from disk
+     */
+    async loadState() {
+        try {
+            const content = await promises_1.default.readFile(this.statePath, 'utf-8');
+            this.state = JSON.parse(content);
+            logger.info('Loaded runner state', {
+                runnerId: this.state?.runnerId,
+                runnerUid: this.state?.runnerUid,
+                lastProcessedAt: this.state?.lastProcessedAt,
+                isActiveRunner: this.state?.isActiveRunner,
+            });
+            return this.state;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                logger.debug('No state file found, starting fresh');
+                return null;
+            }
+            logger.error('Failed to load state file:', error);
+            return null;
+        }
+    }
+    /**
+     * Save state to disk
+     */
+    async saveState(state) {
+        this.state = state;
+        // Cancel any pending save
+        if (this.saveTimer) {
+            clearTimeout(this.saveTimer);
+        }
+        // Debounce saves to avoid excessive disk writes
+        this.saveTimer = setTimeout(async () => {
+            try {
+                // Ensure directory exists
+                const dir = path_1.default.dirname(this.statePath);
+                await promises_1.default.mkdir(dir, { recursive: true });
+                // Update timestamp
+                state.updatedAt = new Date().toISOString();
+                // Write atomically by writing to temp file first
+                const tempPath = `${this.statePath}.tmp`;
+                await promises_1.default.writeFile(tempPath, JSON.stringify(state, null, 2), 'utf-8');
+                await promises_1.default.rename(tempPath, this.statePath);
+                logger.debug('Saved runner state', {
+                    runnerId: state.runnerId,
+                    lastProcessedAt: state.lastProcessedAt,
+                    isActiveRunner: state.isActiveRunner,
+                });
+            }
+            catch (error) {
+                logger.error('Failed to save state file:', error);
+                throw error;
+            }
+        }, 1000); // 1 second debounce
+    }
+    /**
+     * Update lastProcessedAt timestamp
+     */
+    async updateLastProcessedAt(timestamp) {
+        if (!this.state) {
+            throw new Error('State not loaded');
+        }
+        const isoString = timestamp instanceof Date ? timestamp.toISOString() : timestamp;
+        const updatedState = {
+            ...this.state,
+            lastProcessedAt: isoString,
+        };
+        await this.saveState(updatedState);
+    }
+    /**
+     * Update runner registration details
+     */
+    async updateRunnerRegistration(runnerId, runnerUid, lastProcessedAt) {
+        const state = this.state || {
+            runnerId: '',
+            runnerUid: null,
+            lastProcessedAt: null,
+            isActiveRunner: false,
+            updatedAt: new Date().toISOString(),
+        };
+        const updatedState = {
+            ...state,
+            runnerId,
+            runnerUid,
+            lastProcessedAt: lastProcessedAt ? lastProcessedAt.toISOString() : null,
+        };
+        await this.saveState(updatedState);
+    }
+    /**
+     * Update active runner status
+     */
+    async updateActiveStatus(isActive) {
+        if (!this.state) {
+            throw new Error('State not loaded');
+        }
+        const updatedState = {
+            ...this.state,
+            isActiveRunner: isActive,
+        };
+        await this.saveState(updatedState);
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get lastProcessedAt as Date
+     */
+    getLastProcessedAt() {
+        if (!this.state || !this.state.lastProcessedAt) {
+            return null;
+        }
+        return new Date(this.state.lastProcessedAt);
+    }
+    /**
+     * Clear state (for testing or reset)
+     */
+    async clearState() {
+        this.state = null;
+        try {
+            await promises_1.default.unlink(this.statePath);
+            logger.info('Cleared runner state');
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                logger.error('Failed to clear state file:', error);
+                throw error;
+            }
+        }
+    }
+}
+exports.StateManager = StateManager;
+//# sourceMappingURL=StateManager.js.map

package/dist/utils/StateManager.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Configuration management utilities
+ */
+import { RunnerConfig, EnvironmentConfig } from "../types";
+export declare class ConfigManager {
+    private static DEFAULT_CONFIG;
+    /**
+     * Load configuration without parsing command line arguments
+     * Used when arguments have already been parsed by the CLI
+     */
+    static loadConfig(configPath?: string): Promise<RunnerConfig>;
+    /**
+     * Parse command line arguments and load configuration
+     */
+    static parseArgsAndLoadConfig(argv: string[]): Promise<RunnerConfig>;
+    /**
+     * Validate required environment variables
+     */
+    private static validateEnvironment;
+    /**
+     * Load configuration from environment variables
+     */
+    private static loadFromEnvironment;
+    /**
+     * Load configuration from file
+     */
+    private static loadConfigFile;
+    /**
+     * Validate final configuration
+     */
+    private static validateConfig;
+    /**
+     * Get all environment configuration
+     */
+    static getEnvironmentConfig(): EnvironmentConfig;
+    /**
+     * Save configuration file with updated data
+     */
+    static saveConfigFile(configPath: string, config: any): Promise<void>;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAiB,MAAM,UAAU,CAAC;AAQ1E,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,cAAc,CAM3B;IAEF;;;OAGG;WACU,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA4CnE;;OAEG;WACU,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IA0E1E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAkClC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAalC;;OAEG;mBACkB,cAAc;IAkCnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAiD7B;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,iBAAiB;IAShD;;OAEG;WACU,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAW5E"}

package/dist/utils/config.js

@@ -0,0 +1,250 @@
+"use strict";
+/**
+ * Configuration management utilities
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigManager = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const logger_1 = require("./logger");
+const commander_1 = require("commander");
+const logger = (0, logger_1.createLogger)("ConfigManager");
+class ConfigManager {
+    static DEFAULT_CONFIG = {
+        dataDir: "./data",
+        heartbeatInterval: 120000, // 2 minutes
+        retryStrategy: "exponential",
+        retryIntervalSecs: 60,
+        retryDurationSecs: 900,
+    };
+    /**
+     * Load configuration without parsing command line arguments
+     * Used when arguments have already been parsed by the CLI
+     */
+    static async loadConfig(configPath) {
+        // Validate required environment variables
+        this.validateEnvironment();
+        // Start with defaults
+        let config = { ...this.DEFAULT_CONFIG };
+        // Determine config path - use provided path or default location
+        let effectiveConfigPath = configPath;
+        if (!effectiveConfigPath) {
+            // Try to use default config location
+            try {
+                const envPaths = require("env-paths").default || require("env-paths");
+                const paths = envPaths("northflare-runner", { suffix: "" });
+                const defaultConfigPath = path_1.default.join(paths.config, "config.json");
+                // Check if default config exists
+                const fs = require("fs");
+                if (fs.existsSync(defaultConfigPath)) {
+                    effectiveConfigPath = defaultConfigPath;
+                    logger.info(`Using default config file: ${defaultConfigPath}`);
+                }
+            }
+            catch (error) {
+                // env-paths not available or error accessing default location
+                logger.debug("Could not check default config location:", error);
+            }
+        }
+        // Load from config file if we have a path
+        if (effectiveConfigPath) {
+            const fileConfig = await this.loadConfigFile(effectiveConfigPath);
+            config = { ...config, ...fileConfig };
+        }
+        // Override with environment variables
+        const envConfig = this.loadFromEnvironment();
+        config = { ...config, ...envConfig };
+        // Validate final configuration
+        this.validateConfig(config);
+        return config;
+    }
+    /**
+     * Parse command line arguments and load configuration
+     */
+    static async parseArgsAndLoadConfig(argv) {
+        const program = new commander_1.Command();
+        program
+            .name("northflare-runner")
+            .description("Northflare Runner - Executes Claude agents for task processing")
+            .version("1.0.0")
+            .option("-c, --config <path>", "Path to configuration file")
+            .option("--retry-strategy <strategy>", "Registration retry strategy (none, interval, exponential)", "exponential")
+            .option("--retry-interval-secs <seconds>", "Retry interval in seconds for interval strategy", "60")
+            .option("--retry-duration-secs <seconds>", "Max retry duration in seconds for exponential strategy", "900")
+            .option("--data-dir <path>", "Data directory path", "./data")
+            .option("--heartbeat-interval <ms>", "Heartbeat interval in milliseconds", "120000");
+        program.parse(argv);
+        const options = program.opts();
+        // Validate required environment variables
+        this.validateEnvironment();
+        // Start with defaults
+        let config = { ...this.DEFAULT_CONFIG };
+        // Load from config file if provided
+        if (options["config"]) {
+            const fileConfig = await this.loadConfigFile(options["config"]);
+            config = { ...config, ...fileConfig };
+        }
+        // Override with environment variables
+        const envConfig = this.loadFromEnvironment();
+        config = { ...config, ...envConfig };
+        // Override with CLI arguments (highest priority)
+        if (options["retryStrategy"]) {
+            config.retryStrategy = options["retryStrategy"];
+        }
+        if (options["retryIntervalSecs"]) {
+            config.retryIntervalSecs = parseInt(options["retryIntervalSecs"]);
+        }
+        if (options["retryDurationSecs"]) {
+            config.retryDurationSecs = parseInt(options["retryDurationSecs"]);
+        }
+        if (options["dataDir"]) {
+            config.dataDir = options["dataDir"];
+        }
+        if (options["heartbeatInterval"]) {
+            config.heartbeatInterval = parseInt(options["heartbeatInterval"]);
+        }
+        // Validate final configuration
+        this.validateConfig(config);
+        return config;
+    }
+    /**
+     * Validate required environment variables
+     */
+    static validateEnvironment() {
+        // Set default for NORTHFLARE_WORKSPACE_DIR if not provided
+        if (!process.env["NORTHFLARE_WORKSPACE_DIR"]) {
+            try {
+                const envPaths = require("env-paths").default || require("env-paths");
+                const paths = envPaths("northflare-runner", { suffix: "" });
+                process.env["NORTHFLARE_WORKSPACE_DIR"] = paths.data;
+            }
+            catch (error) {
+                // Fallback to original default if env-paths is not available
+                process.env["NORTHFLARE_WORKSPACE_DIR"] = "/workspace";
+            }
+        }
+        // Set default for NORTHFLARE_ORCHESTRATOR_URL if not provided
+        if (!process.env["NORTHFLARE_ORCHESTRATOR_URL"]) {
+            process.env["NORTHFLARE_ORCHESTRATOR_URL"] = "https://api.northflare.ai";
+        }
+        const required = [
+            "NORTHFLARE_RUNNER_TOKEN",
+            "NORTHFLARE_WORKSPACE_DIR",
+            "NORTHFLARE_ORCHESTRATOR_URL",
+        ];
+        const missing = required.filter((key) => !process.env[key]);
+        if (missing.length > 0) {
+            throw new Error(`Missing required environment variables: ${missing.join(", ")}\n` +
+                "Please set these environment variables before starting the runner.");
+        }
+    }
+    /**
+     * Load configuration from environment variables
+     */
+    static loadFromEnvironment() {
+        const config = {
+            orchestratorUrl: process.env["NORTHFLARE_ORCHESTRATOR_URL"],
+        };
+        // Optional environment overrides
+        if (process.env["NORTHFLARE_DATA_DIR"]) {
+            config.dataDir = process.env["NORTHFLARE_DATA_DIR"];
+        }
+        return config;
+    }
+    /**
+     * Load configuration from file
+     */
+    static async loadConfigFile(configPath) {
+        try {
+            const absolutePath = path_1.default.resolve(configPath);
+            const content = await promises_1.default.readFile(absolutePath, "utf-8");
+            // Support both JSON and YAML formats
+            if (configPath.endsWith(".json")) {
+                const config = JSON.parse(content);
+                // Log if runnerRepos are found in config
+                if (config.runnerRepos && Array.isArray(config.runnerRepos)) {
+                    logger.info(`Found ${config.runnerRepos.length} runner repos in config file`);
+                }
+                return config;
+            }
+            else if (configPath.endsWith(".yaml") || configPath.endsWith(".yml")) {
+                // For YAML support, we'd need to add a yaml parser dependency
+                throw new Error("YAML configuration files are not yet supported");
+            }
+            else {
+                throw new Error("Configuration file must be .json format");
+            }
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                logger.warn(`Configuration file not found: ${configPath}`);
+                return {};
+            }
+            throw error;
+        }
+    }
+    /**
+     * Validate final configuration
+     */
+    static validateConfig(config) {
+        // Note: Runner ID will be generated by server during registration
+        if (!config.orchestratorUrl) {
+            throw new Error("orchestratorUrl is required");
+        }
+        if (!config.dataDir) {
+            throw new Error("dataDir is required");
+        }
+        if (!config.heartbeatInterval || config.heartbeatInterval < 1000) {
+            throw new Error("heartbeatInterval must be at least 1000ms");
+        }
+        // Validate retry strategy
+        const validStrategies = [
+            "none",
+            "interval",
+            "exponential",
+        ];
+        if (!config.retryStrategy ||
+            !validStrategies.includes(config.retryStrategy)) {
+            throw new Error(`retryStrategy must be one of: ${validStrategies.join(", ")}`);
+        }
+        if (config.retryStrategy === "interval" &&
+            (!config.retryIntervalSecs || config.retryIntervalSecs < 1)) {
+            throw new Error("retryIntervalSecs must be at least 1 when using interval strategy");
+        }
+        if (config.retryStrategy === "exponential" &&
+            (!config.retryDurationSecs || config.retryDurationSecs < 1)) {
+            throw new Error("retryDurationSecs must be at least 1 when using exponential strategy");
+        }
+    }
+    /**
+     * Get all environment configuration
+     */
+    static getEnvironmentConfig() {
+        return {
+            NORTHFLARE_RUNNER_TOKEN: process.env["NORTHFLARE_RUNNER_TOKEN"],
+            NORTHFLARE_WORKSPACE_DIR: process.env["NORTHFLARE_WORKSPACE_DIR"],
+            NORTHFLARE_ORCHESTRATOR_URL: process.env["NORTHFLARE_ORCHESTRATOR_URL"],
+            DEBUG: process.env["DEBUG"],
+        };
+    }
+    /**
+     * Save configuration file with updated data
+     */
+    static async saveConfigFile(configPath, config) {
+        try {
+            const absolutePath = path_1.default.resolve(configPath);
+            const content = JSON.stringify(config, null, 2);
+            await promises_1.default.writeFile(absolutePath, content, "utf-8");
+            logger.info(`Updated configuration file: ${absolutePath}`);
+        }
+        catch (error) {
+            logger.error("Failed to save configuration file", error);
+            throw error;
+        }
+    }
+}
+exports.ConfigManager = ConfigManager;
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/console.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Console wrapper that suppresses output when not in debug mode
+ */
+export declare const console: {
+    log: (message?: any, ...optionalParams: any[]) => void;
+    warn: (message?: any, ...optionalParams: any[]) => void;
+    error: (message?: any, ...optionalParams: any[]) => void;
+    info: (message?: any, ...optionalParams: any[]) => void;
+    debug: (message?: any, ...optionalParams: any[]) => void;
+};
+//# sourceMappingURL=console.d.ts.map

package/dist/utils/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/utils/console.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,OAAO;;;;;;CAMnB,CAAC"}

package/dist/utils/console.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Console wrapper that suppresses output when not in debug mode
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.console = void 0;
+const isDebug = process.env["DEBUG"] === "true";
+exports.console = {
+    log: isDebug ? global.console.log.bind(global.console) : () => { },
+    warn: isDebug ? global.console.warn.bind(global.console) : () => { },
+    error: global.console.error.bind(global.console), // Always show errors
+    info: isDebug ? global.console.info.bind(global.console) : () => { },
+    debug: isDebug ? global.console.debug.bind(global.console) : () => { },
+};
+//# sourceMappingURL=console.js.map

package/dist/utils/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/utils/console.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC;AAEnC,QAAA,OAAO,GAAG;IACrB,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC;IACjE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC;IACnE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,qBAAqB;IACvE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC;IACnE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC;CACtE,CAAC"}

package/dist/utils/expand-env.d.ts

@@ -0,0 +1,2 @@
+export declare function expandEnv(obj: any, env?: Record<string, string | undefined>): any;
+//# sourceMappingURL=expand-env.d.ts.map

package/dist/utils/expand-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-env.d.ts","sourceRoot":"","sources":["../../src/utils/expand-env.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CACvB,GAAG,EAAE,GAAG,EACR,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,GAAG,CAkBL"}

package/dist/utils/expand-env.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expandEnv = expandEnv;
+function expandEnv(obj, env = process.env) {
+    if (typeof obj === "string") {
+        return obj.replace(/\$\{([^}]+)\}/g, (match, key) => env[key] || match);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => expandEnv(item, env));
+    }
+    if (obj && typeof obj === "object") {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = expandEnv(value, env);
+        }
+        return result;
+    }
+    return obj;
+}
+//# sourceMappingURL=expand-env.js.map