maestro-flow 0.1.0

package/dashboard/dist-server/server/agents/codex-cli-adapter.js

@@ -0,0 +1,264 @@
+// ---------------------------------------------------------------------------
+// CodexCliAdapter -- spawns OpenAI Codex CLI with NDJSON protocol
+// ---------------------------------------------------------------------------
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { BaseAgentAdapter } from './base-adapter.js';
+import { EntryNormalizer } from './entry-normalizer.js';
+import { loadEnvFile } from './env-file-loader.js';
+import { StreamMonitor } from './stream-monitor.js';
+import { cleanSpawnEnv } from './env-cleanup.js';
+// ---------------------------------------------------------------------------
+// Stderr error pattern
+// ---------------------------------------------------------------------------
+const STDERR_ERROR_RE = /\b(error|fatal)\b/i;
+// ---------------------------------------------------------------------------
+// Adapter implementation
+// ---------------------------------------------------------------------------
+export class CodexCliAdapter extends BaseAgentAdapter {
+    agentType = 'codex';
+    childProcesses = new Map();
+    readlineInterfaces = new Map();
+    streamMonitors = new Map();
+    // --- Lifecycle hooks -----------------------------------------------------
+    async doSpawn(processId, config) {
+        const args = [
+            'exec',
+            '--full-auto',
+            '--json',
+            '--skip-git-repo-check',
+            '-',
+        ];
+        // Write mode: bypass approvals and sandbox
+        if (config.approvalMode === 'auto') {
+            args.push('--dangerously-bypass-approvals-and-sandbox');
+        }
+        // Profile from config.toml
+        if (config.settingsFile) {
+            args.push('--profile', config.settingsFile);
+        }
+        const envFromFile = config.envFile ? loadEnvFile(config.envFile) : {};
+        const envOverrides = { ...envFromFile, ...config.env };
+        if (config.apiKey)
+            envOverrides.OPENAI_API_KEY = config.apiKey;
+        const childEnv = cleanSpawnEnv(envOverrides);
+        const child = spawn('codex', args, {
+            cwd: config.workDir,
+            env: childEnv,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            shell: true,
+            windowsHide: true,
+        });
+        if (!child.stdout || !child.stdin || !child.stderr) {
+            throw new Error('Failed to spawn Codex CLI: stdio streams not available');
+        }
+        // Pipe prompt to stdin then close it
+        child.stdin.write(config.prompt);
+        child.stdin.end();
+        // Heartbeat monitor: detect stale streams (60s silence)
+        const monitor = new StreamMonitor(() => {
+            this.emitEntry(processId, EntryNormalizer.error(processId, 'Stream stale: no output for 60s', 'stream_stale'));
+        });
+        this.streamMonitors.set(processId, monitor);
+        // Line-by-line parsing of NDJSON stdout
+        const rl = createInterface({ input: child.stdout });
+        rl.on('line', (line) => {
+            monitor.heartbeat();
+            this.parseCodexMessage(line, processId);
+        });
+        // Stderr handling: classify progress vs error
+        child.stderr.on('data', (chunk) => {
+            const text = chunk.toString().trim();
+            if (text.length === 0)
+                return;
+            for (const line of text.split('\n')) {
+                const trimmed = line.trim();
+                if (trimmed.length === 0)
+                    continue;
+                if (STDERR_ERROR_RE.test(trimmed)) {
+                    this.emitEntry(processId, EntryNormalizer.error(processId, trimmed, 'stderr'));
+                }
+                else {
+                    this.emitEntry(processId, EntryNormalizer.assistantMessage(processId, trimmed, true));
+                }
+            }
+        });
+        // Process exit handling
+        this.setupProcessListeners(child, processId);
+        // Store references
+        this.childProcesses.set(processId, child);
+        this.readlineInterfaces.set(processId, rl);
+        return {
+            id: processId,
+            type: 'codex',
+            status: 'running',
+            config,
+            startedAt: new Date().toISOString(),
+            pid: child.pid,
+            interactive: false,
+        };
+    }
+    async doStop(processId) {
+        const child = this.childProcesses.get(processId);
+        if (!child)
+            return;
+        const proc = this.getProcess(processId);
+        if (proc) {
+            proc.status = 'stopping';
+            this.emitEntry(processId, EntryNormalizer.statusChange(processId, 'stopping', 'User requested stop'));
+        }
+        // Graceful SIGTERM
+        child.kill('SIGTERM');
+        // SIGKILL fallback after 5 seconds
+        const killTimer = setTimeout(() => {
+            if (!child.killed) {
+                child.kill('SIGKILL');
+            }
+        }, 5000);
+        child.once('exit', () => {
+            clearTimeout(killTimer);
+        });
+        this.cleanup(processId);
+    }
+    async doSendMessage(_processId, _content) {
+        // Codex exec uses single-prompt mode via stdin (already closed after spawn).
+        // Interactive messaging is not supported.
+        throw new Error('CodexCliAdapter does not support interactive messaging');
+    }
+    async doRespondApproval(_decision) {
+        // Codex --full-auto mode does not request approvals; no-op.
+    }
+    // --- NDJSON parsing ------------------------------------------------------
+    parseCodexMessage(line, processId) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0)
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(trimmed);
+        }
+        catch {
+            // Non-JSON lines silently skipped
+            return;
+        }
+        if (!msg || typeof msg !== 'object' || !('type' in msg))
+            return;
+        switch (msg.type) {
+            case 'thread.started': {
+                this.emitEntry(processId, EntryNormalizer.statusChange(processId, 'running', 'Codex session started'));
+                break;
+            }
+            case 'item.completed': {
+                const item = msg.item;
+                if (item) {
+                    this.classifyItem(item, processId);
+                }
+                break;
+            }
+            case 'turn.completed': {
+                const usage = msg.usage;
+                if (usage) {
+                    this.emitEntry(processId, EntryNormalizer.tokenUsage(processId, usage.input_tokens ?? 0, usage.output_tokens ?? 0));
+                }
+                break;
+            }
+            // turn.started and unknown types are silently skipped
+            default:
+                break;
+        }
+    }
+    // --- Item classification -------------------------------------------------
+    classifyItem(item, processId) {
+        const itemType = item.type ?? '';
+        const itemName = (item.name ?? '').toLowerCase();
+        // Function call that looks like a command execution
+        if (itemType === 'function_call_output' ||
+            (itemType === 'function_call' && this.isCommandCall(itemName)) ||
+            (typeof item.output === 'string' && itemType !== 'message')) {
+            const command = item.name ?? item.arguments ?? 'codex_exec';
+            const output = item.output ?? '';
+            this.emitEntry(processId, EntryNormalizer.commandExec(processId, command, undefined, output));
+            return;
+        }
+        // Function call that looks like a file operation
+        if (itemType === 'function_call' && this.isFileCall(itemName)) {
+            const filePath = item.filename ?? item.path ?? itemName;
+            const action = this.inferFileAction(itemName);
+            this.emitEntry(processId, EntryNormalizer.fileChange(processId, filePath, action, item.diff));
+            return;
+        }
+        // Default: treat as assistant message
+        const text = this.extractItemText(item);
+        if (text.length > 0) {
+            this.emitEntry(processId, EntryNormalizer.assistantMessage(processId, text, false));
+        }
+    }
+    isCommandCall(name) {
+        return /exec|shell|command|run|bash/.test(name);
+    }
+    isFileCall(name) {
+        return /file|write|create|patch|edit|apply|read/.test(name);
+    }
+    inferFileAction(name) {
+        if (/create|new/.test(name))
+            return 'create';
+        if (/delete|remove/.test(name))
+            return 'delete';
+        return 'modify';
+    }
+    extractItemText(item) {
+        // Try content array first
+        if (Array.isArray(item.content)) {
+            const parts = item.content
+                .filter((c) => typeof c.text === 'string')
+                .map((c) => c.text);
+            if (parts.length > 0)
+                return parts.join('');
+        }
+        // Try direct text field
+        if (typeof item.text === 'string')
+            return item.text;
+        // Try output field
+        if (typeof item.output === 'string')
+            return item.output;
+        // Fallback: stringify the item (skip empty objects)
+        const json = JSON.stringify(item);
+        return json === '{}' ? '' : json;
+    }
+    // --- Process lifecycle helpers -------------------------------------------
+    setupProcessListeners(child, processId) {
+        child.on('exit', (code, signal) => {
+            const reason = signal
+                ? `Terminated by signal: ${signal}`
+                : `Exited with code: ${code ?? 'unknown'}`;
+            this.emitEntry(processId, EntryNormalizer.statusChange(processId, 'stopped', reason));
+            const proc = this.getProcess(processId);
+            if (proc) {
+                proc.status = 'stopped';
+            }
+            this.cleanup(processId);
+            this.removeProcess(processId);
+        });
+        child.on('error', (err) => {
+            this.emitEntry(processId, EntryNormalizer.error(processId, err.message, 'spawn_error'));
+            const proc = this.getProcess(processId);
+            if (proc) {
+                proc.status = 'error';
+            }
+        });
+    }
+    cleanup(processId) {
+        const rl = this.readlineInterfaces.get(processId);
+        if (rl) {
+            rl.close();
+            this.readlineInterfaces.delete(processId);
+        }
+        const monitor = this.streamMonitors.get(processId);
+        if (monitor) {
+            monitor.dispose();
+            this.streamMonitors.delete(processId);
+        }
+        this.childProcesses.delete(processId);
+    }
+}
+//# sourceMappingURL=codex-cli-adapter.js.map

package/dashboard/dist-server/server/agents/codex-cli-adapter.js.map

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

package/dashboard/dist-server/server/agents/entry-normalizer.d.ts

@@ -0,0 +1,16 @@
+import type { AgentProcessStatus, UserMessageEntry, AssistantMessageEntry, ThinkingEntry, ToolUseEntry, FileChangeEntry, CommandExecEntry, ApprovalRequestEntry, ApprovalResponseEntry, ErrorEntry, StatusChangeEntry, TokenUsageEntry } from '../../shared/agent-types.js';
+/** Factory for creating NormalizedEntry instances with consistent base fields */
+export declare class EntryNormalizer {
+    private constructor();
+    static userMessage(processId: string, content: string): UserMessageEntry;
+    static assistantMessage(processId: string, content: string, partial: boolean): AssistantMessageEntry;
+    static thinking(processId: string, content: string): ThinkingEntry;
+    static toolUse(processId: string, name: string, input: Record<string, unknown>, status: ToolUseEntry['status'], result?: string): ToolUseEntry;
+    static fileChange(processId: string, path: string, action: FileChangeEntry['action'], diff?: string): FileChangeEntry;
+    static commandExec(processId: string, command: string, exitCode?: number, output?: string): CommandExecEntry;
+    static approvalRequest(processId: string, toolName: string, toolInput: Record<string, unknown>, requestId: string): ApprovalRequestEntry;
+    static approvalResponse(processId: string, requestId: string, allowed: boolean): ApprovalResponseEntry;
+    static error(processId: string, message: string, code?: string): ErrorEntry;
+    static statusChange(processId: string, status: AgentProcessStatus, reason?: string): StatusChangeEntry;
+    static tokenUsage(processId: string, inputTokens: number, outputTokens: number, cacheReadTokens?: number, cacheWriteTokens?: number): TokenUsageEntry;
+}

package/dashboard/dist-server/server/agents/entry-normalizer.js

@@ -0,0 +1,126 @@
+// ---------------------------------------------------------------------------
+// EntryNormalizer — static factory for creating NormalizedEntry instances
+// ---------------------------------------------------------------------------
+import { randomUUID } from 'node:crypto';
+/** Factory for creating NormalizedEntry instances with consistent base fields */
+export class EntryNormalizer {
+    constructor() {
+        // Static-only class
+    }
+    static userMessage(processId, content) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'user_message',
+            content,
+        };
+    }
+    static assistantMessage(processId, content, partial) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'assistant_message',
+            content,
+            partial,
+        };
+    }
+    static thinking(processId, content) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'thinking',
+            content,
+        };
+    }
+    static toolUse(processId, name, input, status, result) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'tool_use',
+            name,
+            input,
+            status,
+            result,
+        };
+    }
+    static fileChange(processId, path, action, diff) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'file_change',
+            path,
+            action,
+            diff,
+        };
+    }
+    static commandExec(processId, command, exitCode, output) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'command_exec',
+            command,
+            exitCode,
+            output,
+        };
+    }
+    static approvalRequest(processId, toolName, toolInput, requestId) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'approval_request',
+            toolName,
+            toolInput,
+            requestId,
+        };
+    }
+    static approvalResponse(processId, requestId, allowed) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'approval_response',
+            requestId,
+            allowed,
+        };
+    }
+    static error(processId, message, code) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'error',
+            message,
+            code,
+        };
+    }
+    static statusChange(processId, status, reason) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'status_change',
+            status,
+            reason,
+        };
+    }
+    static tokenUsage(processId, inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens) {
+        return {
+            id: randomUUID(),
+            processId,
+            timestamp: new Date().toISOString(),
+            type: 'token_usage',
+            inputTokens,
+            outputTokens,
+            cacheReadTokens,
+            cacheWriteTokens,
+        };
+    }
+}
+//# sourceMappingURL=entry-normalizer.js.map

package/dashboard/dist-server/server/agents/entry-normalizer.js.map

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

package/dashboard/dist-server/server/agents/entry-normalizer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dashboard/dist-server/server/agents/entry-normalizer.test.js

@@ -0,0 +1,128 @@
+import { describe, it, expect } from 'vitest';
+import { EntryNormalizer } from './entry-normalizer.js';
+const PID = 'proc-test-001';
+describe('EntryNormalizer', () => {
+    describe('userMessage', () => {
+        it('creates entry with correct type and content', () => {
+            const entry = EntryNormalizer.userMessage(PID, 'hello');
+            expect(entry.type).toBe('user_message');
+            expect(entry.content).toBe('hello');
+            expect(entry.processId).toBe(PID);
+        });
+        it('generates unique ids', () => {
+            const a = EntryNormalizer.userMessage(PID, 'a');
+            const b = EntryNormalizer.userMessage(PID, 'b');
+            expect(a.id).not.toBe(b.id);
+        });
+        it('generates ISO timestamp', () => {
+            const entry = EntryNormalizer.userMessage(PID, 'test');
+            expect(entry.timestamp).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+        });
+    });
+    describe('assistantMessage', () => {
+        it('includes partial flag', () => {
+            const entry = EntryNormalizer.assistantMessage(PID, 'reply', true);
+            expect(entry.type).toBe('assistant_message');
+            expect(entry.partial).toBe(true);
+        });
+        it('sets partial to false', () => {
+            const entry = EntryNormalizer.assistantMessage(PID, 'done', false);
+            expect(entry.partial).toBe(false);
+        });
+    });
+    describe('thinking', () => {
+        it('creates thinking entry', () => {
+            const entry = EntryNormalizer.thinking(PID, 'pondering...');
+            expect(entry.type).toBe('thinking');
+            expect(entry.content).toBe('pondering...');
+        });
+    });
+    describe('toolUse', () => {
+        it('creates tool use entry with status', () => {
+            const entry = EntryNormalizer.toolUse(PID, 'Read', { path: '/test' }, 'completed', 'ok');
+            expect(entry.type).toBe('tool_use');
+            expect(entry.name).toBe('Read');
+            expect(entry.input).toEqual({ path: '/test' });
+            expect(entry.status).toBe('completed');
+            expect(entry.result).toBe('ok');
+        });
+        it('result is optional', () => {
+            const entry = EntryNormalizer.toolUse(PID, 'Write', {}, 'pending');
+            expect(entry.result).toBeUndefined();
+        });
+    });
+    describe('fileChange', () => {
+        it('creates file change entry', () => {
+            const entry = EntryNormalizer.fileChange(PID, '/src/test.ts', 'create', '+line');
+            expect(entry.type).toBe('file_change');
+            expect(entry.path).toBe('/src/test.ts');
+            expect(entry.action).toBe('create');
+            expect(entry.diff).toBe('+line');
+        });
+        it('diff is optional', () => {
+            const entry = EntryNormalizer.fileChange(PID, '/src/x.ts', 'delete');
+            expect(entry.diff).toBeUndefined();
+        });
+    });
+    describe('commandExec', () => {
+        it('creates command exec entry', () => {
+            const entry = EntryNormalizer.commandExec(PID, 'npm test', 0, 'PASS');
+            expect(entry.type).toBe('command_exec');
+            expect(entry.command).toBe('npm test');
+            expect(entry.exitCode).toBe(0);
+            expect(entry.output).toBe('PASS');
+        });
+    });
+    describe('approvalRequest', () => {
+        it('creates approval request', () => {
+            const entry = EntryNormalizer.approvalRequest(PID, 'Bash', { cmd: 'rm -rf' }, 'req-1');
+            expect(entry.type).toBe('approval_request');
+            expect(entry.toolName).toBe('Bash');
+            expect(entry.requestId).toBe('req-1');
+        });
+    });
+    describe('approvalResponse', () => {
+        it('creates approval response', () => {
+            const entry = EntryNormalizer.approvalResponse(PID, 'req-1', true);
+            expect(entry.type).toBe('approval_response');
+            expect(entry.requestId).toBe('req-1');
+            expect(entry.allowed).toBe(true);
+        });
+    });
+    describe('error', () => {
+        it('creates error entry', () => {
+            const entry = EntryNormalizer.error(PID, 'something broke', 'ERR_001');
+            expect(entry.type).toBe('error');
+            expect(entry.message).toBe('something broke');
+            expect(entry.code).toBe('ERR_001');
+        });
+        it('code is optional', () => {
+            const entry = EntryNormalizer.error(PID, 'oops');
+            expect(entry.code).toBeUndefined();
+        });
+    });
+    describe('statusChange', () => {
+        it('creates status change entry', () => {
+            const entry = EntryNormalizer.statusChange(PID, 'running', 'started');
+            expect(entry.type).toBe('status_change');
+            expect(entry.status).toBe('running');
+            expect(entry.reason).toBe('started');
+        });
+    });
+    describe('tokenUsage', () => {
+        it('creates token usage entry', () => {
+            const entry = EntryNormalizer.tokenUsage(PID, 100, 200, 50, 25);
+            expect(entry.type).toBe('token_usage');
+            expect(entry.inputTokens).toBe(100);
+            expect(entry.outputTokens).toBe(200);
+            expect(entry.cacheReadTokens).toBe(50);
+            expect(entry.cacheWriteTokens).toBe(25);
+        });
+        it('cache tokens are optional', () => {
+            const entry = EntryNormalizer.tokenUsage(PID, 10, 20);
+            expect(entry.cacheReadTokens).toBeUndefined();
+            expect(entry.cacheWriteTokens).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=entry-normalizer.test.js.map

package/dashboard/dist-server/server/agents/entry-normalizer.test.js.map

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

package/dashboard/dist-server/server/agents/env-cleanup.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build a clean environment for spawning CLI child processes.
+ * Strips Electron/npm lifecycle variables that can interfere with
+ * child process behavior (e.g. NODE_OPTIONS set by Electron,
+ * npm_lifecycle_event causing unexpected behavior in npx).
+ */
+export declare function cleanSpawnEnv(overrides?: Record<string, string | undefined>): Record<string, string | undefined>;

package/dashboard/dist-server/server/agents/env-cleanup.js

@@ -0,0 +1,36 @@
+// ---------------------------------------------------------------------------
+// Spawn environment cleanup (AionUi prepareCleanEnv pattern)
+// ---------------------------------------------------------------------------
+/**
+ * Environment variable prefixes that interfere with child CLI processes
+ * when the dashboard is launched from Electron, npm scripts, or similar
+ * wrappers. These are stripped before spawning agent child processes.
+ */
+const INTERFERENCE_PREFIXES = [
+    'npm_',
+    'ELECTRON_',
+];
+const INTERFERENCE_KEYS = new Set([
+    'NODE_CHANNEL_FD',
+    'NODE_CHANNEL_SERIALIZATION_MODE',
+]);
+/**
+ * Build a clean environment for spawning CLI child processes.
+ * Strips Electron/npm lifecycle variables that can interfere with
+ * child process behavior (e.g. NODE_OPTIONS set by Electron,
+ * npm_lifecycle_event causing unexpected behavior in npx).
+ */
+export function cleanSpawnEnv(overrides) {
+    const env = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (INTERFERENCE_PREFIXES.some(p => key.startsWith(p)))
+            continue;
+        if (INTERFERENCE_KEYS.has(key))
+            continue;
+        env[key] = value;
+    }
+    if (overrides)
+        Object.assign(env, overrides);
+    return env;
+}
+//# sourceMappingURL=env-cleanup.js.map

package/dashboard/dist-server/server/agents/env-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-cleanup.js","sourceRoot":"","sources":["../../../src/server/agents/env-cleanup.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,qBAAqB,GAAG;IAC5B,MAAM;IACN,WAAW;CACZ,CAAC;AAEF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,iBAAiB;IACjB,iCAAiC;CAClC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,SAA8C;IAE9C,MAAM,GAAG,GAAuC,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAAE,SAAS;QACjE,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACzC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,IAAI,SAAS;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dashboard/dist-server/server/agents/env-file-loader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Load environment variables from a .env file path.
+ * Supports ~ for home directory and relative paths.
+ * Returns empty object if file not found or parse fails.
+ */
+export declare function loadEnvFile(envFilePath: string): Record<string, string>;