maestro-flow 0.1.0

package/dist/agents/cli-agent-runner.js

@@ -0,0 +1,269 @@
+// ---------------------------------------------------------------------------
+// CLI Agent Runner
+// Orchestrates adapter selection, process spawning, stdout rendering, and
+// exit handling for the `maestro cli` command.
+// ---------------------------------------------------------------------------
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { randomBytes } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { DashboardBridge } from './dashboard-bridge.js';
+import { CliHistoryStore } from './cli-history-store.js';
+import { loadTemplate, loadProtocol } from '../config/template-discovery.js';
+// ---------------------------------------------------------------------------
+// Tool name -> AgentType mapping
+// ---------------------------------------------------------------------------
+const TOOL_TO_AGENT_TYPE = {
+    gemini: 'gemini',
+    qwen: 'qwen',
+    codex: 'codex',
+    claude: 'claude-code',
+    opencode: 'opencode',
+};
+// ---------------------------------------------------------------------------
+// Execution ID generation
+// ---------------------------------------------------------------------------
+const TOOL_PREFIX = {
+    gemini: 'gem',
+    qwen: 'qwn',
+    codex: 'cdx',
+    claude: 'cld',
+    opencode: 'opc',
+};
+function generateExecId(tool) {
+    const prefix = TOOL_PREFIX[tool] ?? 'run';
+    const now = new Date();
+    const hh = String(now.getHours()).padStart(2, '0');
+    const mm = String(now.getMinutes()).padStart(2, '0');
+    const ss = String(now.getSeconds()).padStart(2, '0');
+    const rand = randomBytes(2).toString('hex'); // 4 hex chars
+    return `${prefix}-${hh}${mm}${ss}-${rand}`;
+}
+// ---------------------------------------------------------------------------
+// Prompt assembly — protocol + user prompt + template
+// ---------------------------------------------------------------------------
+async function assemblePrompt(userPrompt, mode, rule) {
+    const parts = [];
+    // 1. Load mode protocol
+    const protocol = await loadProtocol(mode);
+    if (protocol) {
+        parts.push(protocol);
+    }
+    // 2. User prompt
+    parts.push(userPrompt);
+    // 3. Load rule template (if specified)
+    if (rule) {
+        const template = await loadTemplate(rule);
+        if (template) {
+            parts.push(template);
+        }
+        else {
+            console.error(`Warning: template "${rule}" not found, proceeding without it.`);
+        }
+    }
+    return parts.join('\n\n');
+}
+// ---------------------------------------------------------------------------
+// Adapter factory — dynamic import avoids rootDir cross-boundary issues
+// ---------------------------------------------------------------------------
+async function loadAdapterModule(adapterFile) {
+    const dashboardAgents = resolve(import.meta.dirname ?? __dirname, '..', '..', 'dashboard', 'dist-server', 'server', 'agents');
+    const fullPath = resolve(dashboardAgents, adapterFile);
+    // Convert to file:// URL for Windows compatibility with dynamic import()
+    const fileUrl = pathToFileURL(fullPath).href;
+    return await import(fileUrl);
+}
+async function createAdapter(agentType) {
+    switch (agentType) {
+        case 'gemini': {
+            const mod = await loadAdapterModule('stream-json-adapter.js');
+            const Cls = mod.StreamJsonAdapter;
+            return new Cls('npx -y @google/gemini-cli', 'gemini');
+        }
+        case 'qwen': {
+            const mod = await loadAdapterModule('stream-json-adapter.js');
+            const Cls = mod.StreamJsonAdapter;
+            return new Cls('qwen', 'qwen');
+        }
+        case 'codex': {
+            const mod = await loadAdapterModule('codex-cli-adapter.js');
+            const Cls = mod.CodexCliAdapter;
+            return new Cls();
+        }
+        case 'opencode': {
+            const mod = await loadAdapterModule('opencode-adapter.js');
+            const Cls = mod.OpenCodeAdapter;
+            return new Cls();
+        }
+        case 'claude-code': {
+            const mod = await loadAdapterModule('claude-code-adapter.js');
+            const Cls = mod.ClaudeCodeAdapter;
+            return new Cls();
+        }
+        default:
+            throw new Error(`Unsupported agent type: ${agentType}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Entry renderer — writes normalized entries to stdout/stderr
+// ---------------------------------------------------------------------------
+function renderEntry(entry) {
+    switch (entry.type) {
+        case 'assistant_message':
+            process.stdout.write(entry.content);
+            break;
+        case 'tool_use':
+            if (entry.status === 'running') {
+                console.log(`[Tool: ${entry.name}]`);
+            }
+            else if (entry.status === 'completed' || entry.status === 'failed') {
+                console.log(`[Tool ${entry.name}: ${entry.status}]`);
+                if (entry.result) {
+                    console.log(entry.result);
+                }
+            }
+            break;
+        case 'error':
+            console.error(`Error: ${entry.message}`);
+            break;
+        case 'file_change':
+            console.log(`[File ${entry.action}: ${entry.path}]`);
+            break;
+        case 'command_exec':
+            console.log(`[Exec: ${entry.command}]`);
+            break;
+        case 'token_usage':
+            console.log(`[Tokens: ${entry.inputTokens}in/${entry.outputTokens}out]`);
+            break;
+        // Silently skip: user_message, thinking, approval_request,
+        // approval_response, status_change (handled by the runner itself)
+        default:
+            break;
+    }
+}
+// ---------------------------------------------------------------------------
+// CliAgentRunner
+// ---------------------------------------------------------------------------
+export class CliAgentRunner {
+    /** Resolve dashboard WS URL from env → config → default port 3001 */
+    static getDashboardWsUrl() {
+        const envPort = process.env.MAESTRO_DASHBOARD_PORT;
+        if (envPort) {
+            const p = parseInt(envPort, 10);
+            if (!isNaN(p))
+                return `ws://127.0.0.1:${p}/ws`;
+        }
+        try {
+            const configPath = resolve(process.cwd(), '.workflow', 'config.json');
+            const raw = readFileSync(configPath, 'utf-8');
+            const json = JSON.parse(raw);
+            const dashboard = json['dashboard'];
+            if (dashboard?.port && typeof dashboard.port === 'number') {
+                return `ws://127.0.0.1:${dashboard.port}/ws`;
+            }
+        }
+        catch {
+            // Config missing or unreadable — use default
+        }
+        return 'ws://127.0.0.1:3001/ws';
+    }
+    /**
+     * Run a CLI agent to completion and return its exit code (0 = success).
+     */
+    async run(options) {
+        const agentType = TOOL_TO_AGENT_TYPE[options.tool];
+        if (!agentType) {
+            console.error(`Unknown tool: ${options.tool}`);
+            return 1;
+        }
+        // Generate or use provided execution ID
+        const execId = options.execId ?? generateExecId(options.tool);
+        process.stderr.write(`[MAESTRO_EXEC_ID=${execId}]\n`);
+        // History store for persistence and resume
+        const store = new CliHistoryStore();
+        // Handle --resume: prepend previous session context to user prompt
+        let userPrompt = options.prompt;
+        if (options.resume) {
+            let resumeId = options.resume;
+            if (resumeId === 'last') {
+                const recent = store.listRecent(1);
+                resumeId = recent.length > 0 ? recent[0].execId : '';
+            }
+            if (resumeId) {
+                userPrompt = store.buildResumePrompt(resumeId, userPrompt);
+            }
+            else {
+                console.error('No previous execution found for --resume');
+            }
+        }
+        // Assemble final prompt: protocol + user prompt + template
+        const finalPrompt = await assemblePrompt(userPrompt, options.mode, options.rule);
+        const adapter = await createAdapter(agentType);
+        // Optional Dashboard bridge — connect silently, don't block startup
+        const bridge = new DashboardBridge();
+        const bridgeConnected = await bridge.tryConnect(CliAgentRunner.getDashboardWsUrl(), 1000);
+        if (!bridgeConnected) {
+            process.stderr.write('[Dashboard not connected — real-time view unavailable]\n');
+        }
+        const config = {
+            type: agentType,
+            prompt: finalPrompt,
+            workDir: options.workDir,
+            model: options.model,
+            approvalMode: options.mode === 'write' ? 'auto' : 'suggest',
+        };
+        const agentProcess = await adapter.spawn(config);
+        bridge.forwardSpawn(agentProcess);
+        // Safety net: if the process exits without a stopped event (e.g. Windows
+        // shell process tree doesn't fire exit/close reliably), write meta.json
+        // from the synchronous process.on('exit') handler as a last resort.
+        let metaWritten = false;
+        const saveMeta = (exitCode) => {
+            if (metaWritten)
+                return;
+            metaWritten = true;
+            store.saveMeta(execId, {
+                execId,
+                tool: options.tool,
+                model: options.model,
+                mode: options.mode,
+                prompt: options.prompt.substring(0, 500),
+                workDir: options.workDir,
+                startedAt: agentProcess.startedAt,
+                completedAt: new Date().toISOString(),
+                exitCode,
+            });
+        };
+        const processExitHandler = () => {
+            saveMeta(0);
+        };
+        process.on('exit', processExitHandler);
+        return new Promise((resolvePromise) => {
+            const unsubscribe = adapter.onEntry(agentProcess.id, (entry) => {
+                // Persist entry to JSONL history before rendering
+                store.appendEntry(execId, entry);
+                renderEntry(entry);
+                bridge.forwardEntry(entry);
+                // Resolve when the agent process stops
+                if (entry.type === 'status_change' && entry.status === 'stopped') {
+                    saveMeta(0);
+                    process.removeListener('exit', processExitHandler);
+                    bridge.forwardStopped(agentProcess.id);
+                    bridge.close();
+                    unsubscribe();
+                    resolvePromise(0);
+                }
+                // Resolve with error code on error status
+                if (entry.type === 'status_change' && entry.status === 'error') {
+                    saveMeta(1);
+                    process.removeListener('exit', processExitHandler);
+                    bridge.forwardStopped(agentProcess.id);
+                    bridge.close();
+                    unsubscribe();
+                    resolvePromise(1);
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=cli-agent-runner.js.map

package/dist/agents/cli-agent-runner.js.map

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

package/dist/agents/cli-history-store.d.ts

@@ -0,0 +1,47 @@
+/** Minimal entry shape — mirrors NormalizedEntry without importing it. */
+export interface EntryLike {
+    type: string;
+    [key: string]: unknown;
+}
+export interface ExecutionMeta {
+    execId: string;
+    tool: string;
+    model?: string;
+    mode: string;
+    prompt: string;
+    workDir: string;
+    startedAt: string;
+    completedAt?: string;
+    exitCode?: number;
+}
+export declare class CliHistoryStore {
+    private get dir();
+    private jsonlPath;
+    private metaPath;
+    /** Expose JSONL file path for a given execution (used by watch). */
+    jsonlPathFor(execId: string): string;
+    /** Append a single entry as one JSONL line. */
+    appendEntry(execId: string, entry: EntryLike): void;
+    /** Save (or overwrite) execution metadata. */
+    saveMeta(execId: string, meta: ExecutionMeta): void;
+    /** Load execution metadata, or null if not found. */
+    loadMeta(execId: string): ExecutionMeta | null;
+    /**
+     * Load JSONL entries filtered for resume context.
+     * Excludes status_change, token_usage, thinking, approval_*, user_message,
+     * and partial assistant_message entries.
+     */
+    loadForResume(execId: string): EntryLike[];
+    /**
+     * Build a resume prompt by loading previous session context and wrapping
+     * it with the new prompt.
+     *
+     * Supports single or comma-separated execIds for merge scenarios.
+     */
+    buildResumePrompt(execIds: string | string[], newPrompt: string): string;
+    /** List recent execution metadata, sorted by modification time descending. */
+    listRecent(limit?: number): ExecutionMeta[];
+    /** Get final output text from an execution's JSONL. */
+    getOutput(execId: string): string;
+}
+//# sourceMappingURL=cli-history-store.d.ts.map

package/dist/agents/cli-history-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-history-store.d.ts","sourceRoot":"","sources":["../../src/agents/cli-history-store.ts"],"names":[],"mappings":"AAmBA,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAyBD,qBAAa,eAAe;IAC1B,OAAO,KAAK,GAAG,GAEd;IAED,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,QAAQ;IAIhB,oEAAoE;IACpE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAMpC,+CAA+C;IAC/C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAKnD,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAOnD,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAS9C;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IA2B1C;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAuCxE,8EAA8E;IAC9E,UAAU,CAAC,KAAK,SAAK,GAAG,aAAa,EAAE;IA0BvC,uDAAuD;IACvD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAuBlC"}

package/dist/agents/cli-history-store.js

@@ -0,0 +1,212 @@
+// ---------------------------------------------------------------------------
+// CLI History Store
+// Persistent JSONL storage for CLI execution history with resume support.
+// ---------------------------------------------------------------------------
+import { join } from 'node:path';
+import { appendFileSync, writeFileSync, readFileSync, readdirSync, statSync, } from 'node:fs';
+import { paths } from '../config/paths.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Entry types to include when building a resume prompt. */
+const RESUME_INCLUDE_TYPES = new Set([
+    'assistant_message',
+    'tool_use',
+    'file_change',
+    'command_exec',
+    'error',
+]);
+/** Warn when resume context exceeds this char count. */
+const RESUME_CONTEXT_WARN_CHARS = 32_000;
+/** Max chars per tool_use result or command_exec output in resume context. */
+const RESUME_ENTRY_MAX_CHARS = 4_096;
+// ---------------------------------------------------------------------------
+// CliHistoryStore
+// ---------------------------------------------------------------------------
+export class CliHistoryStore {
+    get dir() {
+        return paths.cliHistory;
+    }
+    jsonlPath(execId) {
+        return join(this.dir, `${execId}.jsonl`);
+    }
+    metaPath(execId) {
+        return join(this.dir, `${execId}.meta.json`);
+    }
+    /** Expose JSONL file path for a given execution (used by watch). */
+    jsonlPathFor(execId) {
+        return this.jsonlPath(execId);
+    }
+    // ---- Write operations ---------------------------------------------------
+    /** Append a single entry as one JSONL line. */
+    appendEntry(execId, entry) {
+        paths.ensure(this.dir);
+        appendFileSync(this.jsonlPath(execId), JSON.stringify(entry) + '\n', 'utf-8');
+    }
+    /** Save (or overwrite) execution metadata. */
+    saveMeta(execId, meta) {
+        paths.ensure(this.dir);
+        writeFileSync(this.metaPath(execId), JSON.stringify(meta, null, 2), 'utf-8');
+    }
+    // ---- Read operations ----------------------------------------------------
+    /** Load execution metadata, or null if not found. */
+    loadMeta(execId) {
+        try {
+            const raw = readFileSync(this.metaPath(execId), 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Load JSONL entries filtered for resume context.
+     * Excludes status_change, token_usage, thinking, approval_*, user_message,
+     * and partial assistant_message entries.
+     */
+    loadForResume(execId) {
+        let raw;
+        try {
+            raw = readFileSync(this.jsonlPath(execId), 'utf-8');
+        }
+        catch {
+            return [];
+        }
+        const entries = [];
+        for (const line of raw.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const entry = JSON.parse(trimmed);
+                if (!RESUME_INCLUDE_TYPES.has(entry.type))
+                    continue;
+                // Skip partial assistant messages
+                if (entry.type === 'assistant_message' && entry.partial === true)
+                    continue;
+                // For tool_use, only include completed
+                if (entry.type === 'tool_use' && entry.status !== 'completed')
+                    continue;
+                entries.push(entry);
+            }
+            catch {
+                // skip malformed lines
+            }
+        }
+        return entries;
+    }
+    /**
+     * Build a resume prompt by loading previous session context and wrapping
+     * it with the new prompt.
+     *
+     * Supports single or comma-separated execIds for merge scenarios.
+     */
+    buildResumePrompt(execIds, newPrompt) {
+        const ids = Array.isArray(execIds) ? execIds : execIds.split(',').map(s => s.trim());
+        const sections = [];
+        for (const id of ids) {
+            const meta = this.loadMeta(id);
+            const entries = this.loadForResume(id);
+            if (entries.length === 0 && !meta)
+                continue;
+            const header = meta
+                ? `Tool: ${meta.tool} | Mode: ${meta.mode}`
+                : `Session: ${id}`;
+            const formatted = entries.map(e => formatEntry(e)).join('\n');
+            sections.push(`${header}\n\n${formatted}`);
+        }
+        if (sections.length === 0) {
+            return newPrompt;
+        }
+        const result = [
+            '=== PREVIOUS CONVERSATION ===',
+            sections.join('\n\n---\n\n'),
+            '',
+            '=== NEW REQUEST ===',
+            newPrompt,
+        ].join('\n');
+        if (result.length > RESUME_CONTEXT_WARN_CHARS) {
+            console.error(`Warning: resume context is ${Math.round(result.length / 1024)}KB — may exceed model context limit.`);
+        }
+        return result;
+    }
+    // ---- Query operations ---------------------------------------------------
+    /** List recent execution metadata, sorted by modification time descending. */
+    listRecent(limit = 20) {
+        try {
+            const files = readdirSync(this.dir)
+                .filter(f => f.endsWith('.meta.json'))
+                .map(f => ({
+                name: f,
+                mtime: statSync(join(this.dir, f)).mtimeMs,
+            }))
+                .sort((a, b) => b.mtime - a.mtime)
+                .slice(0, limit);
+            const results = [];
+            for (const f of files) {
+                try {
+                    const raw = readFileSync(join(this.dir, f.name), 'utf-8');
+                    results.push(JSON.parse(raw));
+                }
+                catch {
+                    // skip corrupt meta files
+                }
+            }
+            return results;
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Get final output text from an execution's JSONL. */
+    getOutput(execId) {
+        let raw;
+        try {
+            raw = readFileSync(this.jsonlPath(execId), 'utf-8');
+        }
+        catch {
+            return '';
+        }
+        const parts = [];
+        for (const line of raw.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const entry = JSON.parse(trimmed);
+                if (entry.type === 'assistant_message' && entry.partial !== true) {
+                    parts.push(String(entry.content ?? ''));
+                }
+            }
+            catch {
+                // skip
+            }
+        }
+        return parts.join('');
+    }
+}
+// ---------------------------------------------------------------------------
+// Entry formatting for resume prompt
+// ---------------------------------------------------------------------------
+function truncate(s, max) {
+    return s.length <= max ? s : s.substring(0, max) + '…[truncated]';
+}
+function formatEntry(entry) {
+    switch (entry.type) {
+        case 'assistant_message':
+            return String(entry.content ?? '');
+        case 'tool_use':
+            return `[Tool ${String(entry.name ?? 'unknown')}: ${truncate(String(entry.result ?? ''), RESUME_ENTRY_MAX_CHARS)}]`;
+        case 'file_change':
+            return `[File ${String(entry.action ?? 'change')}: ${String(entry.path ?? '')}]`;
+        case 'command_exec': {
+            const output = entry.output ? `\n${truncate(String(entry.output), RESUME_ENTRY_MAX_CHARS)}` : '';
+            return `[Exec: ${String(entry.command ?? '')}]${output}`;
+        }
+        case 'error':
+            return `[Error: ${String(entry.message ?? '')}]`;
+        default:
+            return `[${entry.type}]`;
+    }
+}
+//# sourceMappingURL=cli-history-store.js.map

package/dist/agents/cli-history-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-history-store.js","sourceRoot":"","sources":["../../src/agents/cli-history-store.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oBAAoB;AACpB,0EAA0E;AAC1E,8EAA8E;AAE9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAwB3C,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,4DAA4D;AAC5D,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,mBAAmB;IACnB,UAAU;IACV,aAAa;IACb,cAAc;IACd,OAAO;CACR,CAAC,CAAC;AAEH,wDAAwD;AACxD,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEzC,8EAA8E;AAC9E,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAErC,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,OAAO,eAAe;IAC1B,IAAY,GAAG;QACb,OAAO,KAAK,CAAC,UAAU,CAAC;IAC1B,CAAC;IAEO,SAAS,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAEO,QAAQ,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED,oEAAoE;IACpE,YAAY,CAAC,MAAc;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,4EAA4E;IAE5E,+CAA+C;IAC/C,WAAW,CAAC,MAAc,EAAE,KAAgB;QAC1C,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;IAED,8CAA8C;IAC9C,QAAQ,CAAC,MAAc,EAAE,IAAmB;QAC1C,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,4EAA4E;IAE5E,qDAAqD;IACrD,QAAQ,CAAC,MAAc;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,MAAc;QAC1B,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAgB,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;gBAC/C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACpD,kCAAkC;gBAClC,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;oBAAE,SAAS;gBAC3E,uCAAuC;gBACvC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;oBAAE,SAAS;gBACxE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,OAA0B,EAAE,SAAiB;QAC7D,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrF,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAE5C,MAAM,MAAM,GAAG,IAAI;gBACjB,CAAC,CAAC,SAAS,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,IAAI,EAAE;gBAC3C,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,SAAS,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG;YACb,+BAA+B;YAC/B,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC;YAC5B,EAAE;YACF,qBAAqB;YACrB,SAAS;SACV,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,IAAI,MAAM,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;YAC9C,OAAO,CAAC,KAAK,CACX,8BAA8B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,sCAAsC,CACrG,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,4EAA4E;IAE5E,8EAA8E;IAC9E,UAAU,CAAC,KAAK,GAAG,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;iBAChC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;iBACrC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACT,IAAI,EAAE,CAAC;gBACP,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;aAC3C,CAAC,CAAC;iBACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;iBACjC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAEnB,MAAM,OAAO,GAAoB,EAAE,CAAC;YACpC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;oBAC1D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC,CAAC;gBACjD,CAAC;gBAAC,MAAM,CAAC;oBACP,0BAA0B;gBAC5B,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,SAAS,CAAC,MAAc;QACtB,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;gBAC/C,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;oBACjE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;CACF;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,SAAS,QAAQ,CAAC,CAAS,EAAE,GAAW;IACtC,OAAO,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,cAAc,CAAC;AACpE,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB;IACnC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,mBAAmB;YACtB,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACrC,KAAK,UAAU;YACb,OAAO,SAAS,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,sBAAsB,CAAC,GAAG,CAAC;QACtH,KAAK,aAAa;YAChB,OAAO,SAAS,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC;QACnF,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjG,OAAO,UAAU,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;QAC3D,CAAC;QACD,KAAK,OAAO;YACV,OAAO,WAAW,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,CAAC;QACnD;YACE,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/agents/dashboard-bridge.d.ts

@@ -0,0 +1,34 @@
+interface AgentProcess {
+    id: string;
+    type: string;
+    status: string;
+    config: unknown;
+    startedAt: string;
+    pid?: number;
+}
+interface NormalizedEntry {
+    id: string;
+    processId: string;
+    timestamp: string;
+    type: string;
+    [key: string]: unknown;
+}
+export declare class DashboardBridge {
+    private ws;
+    /**
+     * Attempt to connect to the Dashboard WS endpoint.
+     * Returns immediately if connection fails or times out.
+     */
+    tryConnect(url: string, timeoutMs?: number): Promise<boolean>;
+    /** Forward a process spawn event to the Dashboard */
+    forwardSpawn(process: AgentProcess): void;
+    /** Forward a normalized entry to the Dashboard */
+    forwardEntry(entry: NormalizedEntry): void;
+    /** Notify Dashboard that the CLI process has stopped */
+    forwardStopped(processId: string): void;
+    /** Close the WS connection */
+    close(): void;
+    private send;
+}
+export {};
+//# sourceMappingURL=dashboard-bridge.d.ts.map

package/dist/agents/dashboard-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-bridge.d.ts","sourceRoot":"","sources":["../../src/agents/dashboard-bridge.ts"],"names":[],"mappings":"AAWA,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAA0B;IAEpC;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBjE,qDAAqD;IACrD,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIzC,kDAAkD;IAClD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI1C,wDAAwD;IACxD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIvC,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,IAAI;CASb"}

package/dist/agents/dashboard-bridge.js

@@ -0,0 +1,63 @@
+// ---------------------------------------------------------------------------
+// DashboardBridge — optional WS client for forwarding CLI agent events to
+// a running Dashboard instance. Fails silently when Dashboard is unavailable.
+// ---------------------------------------------------------------------------
+import { WebSocket } from 'ws';
+// ---------------------------------------------------------------------------
+// DashboardBridge
+// ---------------------------------------------------------------------------
+export class DashboardBridge {
+    ws = null;
+    /**
+     * Attempt to connect to the Dashboard WS endpoint.
+     * Returns immediately if connection fails or times out.
+     */
+    async tryConnect(url, timeoutMs = 1000) {
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                ws.terminate();
+                resolve(false);
+            }, timeoutMs);
+            const ws = new WebSocket(url);
+            ws.on('open', () => {
+                clearTimeout(timer);
+                this.ws = ws;
+                resolve(true);
+            });
+            ws.on('error', () => {
+                clearTimeout(timer);
+                resolve(false);
+            });
+        });
+    }
+    /** Forward a process spawn event to the Dashboard */
+    forwardSpawn(process) {
+        this.send({ action: 'cli:spawned', process });
+    }
+    /** Forward a normalized entry to the Dashboard */
+    forwardEntry(entry) {
+        this.send({ action: 'cli:entry', entry });
+    }
+    /** Notify Dashboard that the CLI process has stopped */
+    forwardStopped(processId) {
+        this.send({ action: 'cli:stopped', processId });
+    }
+    /** Close the WS connection */
+    close() {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.close();
+        }
+        this.ws = null;
+    }
+    send(data) {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            try {
+                this.ws.send(JSON.stringify(data));
+            }
+            catch {
+                // Silent failure — dashboard monitoring is best-effort
+            }
+        }
+    }
+}
+//# sourceMappingURL=dashboard-bridge.js.map