maestro-flow 0.1.0

package/dashboard/dist-server/server/coordinator/coordinator-routes.test.js

@@ -0,0 +1,233 @@
+import { describe, it, expect, vi } from 'vitest';
+import { Hono } from 'hono';
+import { createCoordinatorRoutes } from './coordinator-routes.js';
+// ---------------------------------------------------------------------------
+// Mock WorkflowCoordinator
+// ---------------------------------------------------------------------------
+function createMockSession(overrides) {
+    return {
+        sessionId: 'coord-test-abc12345',
+        status: 'running',
+        intent: 'implement feature X',
+        chainName: 'analyze-plan-execute',
+        tool: 'claude',
+        autoMode: false,
+        currentStep: 0,
+        steps: [],
+        avgQuality: null,
+        ...overrides,
+    };
+}
+function createMockCoordinator() {
+    const session = createMockSession();
+    const mocks = {
+        start: vi.fn().mockResolvedValue(session),
+        stop: vi.fn().mockResolvedValue(undefined),
+        resume: vi.fn().mockResolvedValue(session),
+        clarify: vi.fn().mockResolvedValue(undefined),
+        getSession: vi.fn().mockReturnValue(session),
+        destroy: vi.fn(),
+    };
+    return {
+        coordinator: mocks,
+        mocks,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('Coordinator Routes', () => {
+    function createApp() {
+        const { coordinator, mocks } = createMockCoordinator();
+        const routes = createCoordinatorRoutes(coordinator);
+        const app = new Hono();
+        app.route('/', routes);
+        return { app, coordinator, mocks };
+    }
+    // --- POST /api/coordinate/start ---
+    describe('POST /api/coordinate/start', () => {
+        it('starts a session with intent and returns session', async () => {
+            const { app, mocks } = createApp();
+            const res = await app.request('/api/coordinate/start', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ intent: 'implement feature X', tool: 'gemini' }),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.ok).toBe(true);
+            expect(body.session).toBeDefined();
+            expect(body.session.sessionId).toBe('coord-test-abc12345');
+            expect(mocks.start).toHaveBeenCalledWith('implement feature X', {
+                tool: 'gemini',
+                autoMode: undefined,
+                chainName: undefined,
+                phase: undefined,
+            });
+        });
+        it('returns 400 when intent is missing', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/coordinate/start', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({}),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(400);
+            expect(body.error).toContain('intent');
+        });
+        it('returns 500 when start throws', async () => {
+            const { app, mocks } = createApp();
+            mocks.start.mockRejectedValueOnce(new Error('Session already running'));
+            const res = await app.request('/api/coordinate/start', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ intent: 'do something' }),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(500);
+            expect(body.error).toBe('Session already running');
+        });
+    });
+    // --- POST /api/coordinate/stop ---
+    describe('POST /api/coordinate/stop', () => {
+        it('stops the session and returns ok', async () => {
+            const { app, mocks } = createApp();
+            const res = await app.request('/api/coordinate/stop', { method: 'POST' });
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.ok).toBe(true);
+            expect(mocks.stop).toHaveBeenCalledOnce();
+        });
+        it('returns 500 when stop throws', async () => {
+            const { app, mocks } = createApp();
+            mocks.stop.mockRejectedValueOnce(new Error('Agent cleanup failed'));
+            const res = await app.request('/api/coordinate/stop', { method: 'POST' });
+            const body = await res.json();
+            expect(res.status).toBe(500);
+            expect(body.error).toBe('Agent cleanup failed');
+        });
+    });
+    // --- GET /api/coordinate/status ---
+    describe('GET /api/coordinate/status', () => {
+        it('returns current session state', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/coordinate/status');
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.session).toBeDefined();
+            expect(body.session.status).toBe('running');
+            expect(body.session.intent).toBe('implement feature X');
+        });
+        it('returns null session when no session exists', async () => {
+            const { app, mocks } = createApp();
+            mocks.getSession.mockReturnValueOnce(null);
+            const res = await app.request('/api/coordinate/status');
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.session).toBeNull();
+        });
+    });
+    // --- POST /api/coordinate/resume ---
+    describe('POST /api/coordinate/resume', () => {
+        it('resumes a session by id', async () => {
+            const { app, mocks } = createApp();
+            const res = await app.request('/api/coordinate/resume', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ sessionId: 'coord-test-abc12345' }),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.ok).toBe(true);
+            expect(body.session).toBeDefined();
+            expect(mocks.resume).toHaveBeenCalledWith('coord-test-abc12345');
+        });
+        it('resumes without sessionId (latest)', async () => {
+            const { app, mocks } = createApp();
+            const res = await app.request('/api/coordinate/resume', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({}),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.ok).toBe(true);
+            expect(mocks.resume).toHaveBeenCalledWith(undefined);
+        });
+        it('returns 404 when no session found', async () => {
+            const { app, mocks } = createApp();
+            mocks.resume.mockResolvedValueOnce(null);
+            const res = await app.request('/api/coordinate/resume', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({}),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(404);
+            expect(body.error).toContain('No session found');
+        });
+        it('returns 500 when resume throws', async () => {
+            const { app, mocks } = createApp();
+            mocks.resume.mockRejectedValueOnce(new Error('Corrupt state file'));
+            const res = await app.request('/api/coordinate/resume', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({}),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(500);
+            expect(body.error).toBe('Corrupt state file');
+        });
+    });
+    // --- POST /api/coordinate/clarify ---
+    describe('POST /api/coordinate/clarify', () => {
+        it('sends clarification response', async () => {
+            const { app, mocks } = createApp();
+            const res = await app.request('/api/coordinate/clarify', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ sessionId: 'coord-test-abc12345', response: 'Use the staging DB' }),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.ok).toBe(true);
+            expect(mocks.clarify).toHaveBeenCalledWith('coord-test-abc12345', 'Use the staging DB');
+        });
+        it('returns 400 when sessionId is missing', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/coordinate/clarify', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ response: 'something' }),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(400);
+            expect(body.error).toContain('sessionId');
+        });
+        it('returns 400 when response is missing', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/coordinate/clarify', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ sessionId: 'coord-test-abc12345' }),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(400);
+            expect(body.error).toContain('response');
+        });
+        it('returns 500 when clarify throws', async () => {
+            const { app, mocks } = createApp();
+            mocks.clarify.mockRejectedValueOnce(new Error('Classification failed'));
+            const res = await app.request('/api/coordinate/clarify', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ sessionId: 'coord-test-abc12345', response: 'answer' }),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(500);
+            expect(body.error).toBe('Classification failed');
+        });
+    });
+});
+//# sourceMappingURL=coordinator-routes.test.js.map

package/dashboard/dist-server/server/coordinator/coordinator-routes.test.js.map

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

package/dashboard/dist-server/server/coordinator/dashboard-executor.d.ts

@@ -0,0 +1,13 @@
+import type { DashboardEventBus } from '../state/event-bus.js';
+import type { AgentManager } from '../agents/agent-manager.js';
+import type { ExecuteRequest, ExecuteResult, CommandExecutor } from '../../../../src/coordinator/graph-types.js';
+export declare class DashboardExecutor implements CommandExecutor {
+    private readonly agentManager;
+    private readonly eventBus;
+    private activeProcessId;
+    constructor(agentManager: AgentManager, eventBus: DashboardEventBus);
+    execute(request: ExecuteRequest): Promise<ExecuteResult>;
+    abort(): Promise<void>;
+    private waitForStopped;
+    private collectOutput;
+}

package/dashboard/dist-server/server/coordinator/dashboard-executor.js

@@ -0,0 +1,98 @@
+// ---------------------------------------------------------------------------
+// DashboardExecutor — CommandExecutor implementation for the Dashboard.
+// Bridges the Graph Coordinator's ExecuteRequest/ExecuteResult interface
+// to the Dashboard's AgentManager spawn/stop lifecycle.
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// DashboardExecutor
+// ---------------------------------------------------------------------------
+export class DashboardExecutor {
+    agentManager;
+    eventBus;
+    activeProcessId = null;
+    constructor(agentManager, eventBus) {
+        this.agentManager = agentManager;
+        this.eventBus = eventBus;
+    }
+    async execute(request) {
+        const startTime = Date.now();
+        try {
+            const agentType = request.agent_type;
+            const proc = await this.agentManager.spawn(agentType, {
+                type: agentType,
+                prompt: request.prompt,
+                workDir: request.work_dir,
+                approvalMode: request.approval_mode,
+            });
+            this.activeProcessId = proc.id;
+            // Wait for the agent to stop (completed or errored)
+            const reason = await this.waitForStopped(proc.id, request.timeout_ms);
+            this.activeProcessId = null;
+            const output = this.collectOutput(proc.id);
+            const durationMs = Date.now() - startTime;
+            return {
+                success: !reason?.startsWith('error'),
+                raw_output: output,
+                exec_id: proc.id,
+                duration_ms: durationMs,
+                process_id: proc.id,
+            };
+        }
+        catch (err) {
+            this.activeProcessId = null;
+            return {
+                success: false,
+                raw_output: err instanceof Error ? err.message : String(err),
+                exec_id: '',
+                duration_ms: Date.now() - startTime,
+            };
+        }
+    }
+    async abort() {
+        if (!this.activeProcessId)
+            return;
+        try {
+            await this.agentManager.stop(this.activeProcessId);
+        }
+        catch { /* Agent may have already stopped */ }
+        this.activeProcessId = null;
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    waitForStopped(processId, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            let timer = null;
+            const handler = (event) => {
+                const payload = event.data;
+                if (payload.processId !== processId)
+                    return;
+                cleanup();
+                resolve(payload.reason);
+            };
+            const cleanup = () => {
+                this.eventBus.off('agent:stopped', handler);
+                if (timer)
+                    clearTimeout(timer);
+            };
+            this.eventBus.on('agent:stopped', handler);
+            timer = setTimeout(() => {
+                cleanup();
+                reject(new Error(`Agent timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+        });
+    }
+    collectOutput(processId) {
+        const entries = this.agentManager.getEntries(processId);
+        const parts = [];
+        for (const entry of entries) {
+            if (entry.type === 'assistant_message') {
+                const msg = entry;
+                parts.push(msg.content ?? msg.message ?? '');
+            }
+        }
+        const joined = parts.join('\n');
+        return joined.length > 50_000 ? joined.slice(-50_000) : joined;
+    }
+}
+//# sourceMappingURL=dashboard-executor.js.map

package/dashboard/dist-server/server/coordinator/dashboard-executor.js.map

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

package/dashboard/dist-server/server/coordinator/dashboard-step-analyzer.d.ts

@@ -0,0 +1,7 @@
+import type { CommandNode, WalkerContext, AssembleRequest, AnalysisResult, StepAnalyzer } from '../../../../src/coordinator/graph-types.js';
+import type { QualityReviewerAgent } from './agents/quality-reviewer-agent.js';
+export declare class DashboardStepAnalyzer implements StepAnalyzer {
+    private readonly qualityReviewer;
+    constructor(qualityReviewer: QualityReviewerAgent);
+    analyze(node: CommandNode, rawOutput: string, _ctx: WalkerContext, _prevCmd?: AssembleRequest['previous_command']): Promise<AnalysisResult>;
+}

package/dashboard/dist-server/server/coordinator/dashboard-step-analyzer.js

@@ -0,0 +1,34 @@
+// ---------------------------------------------------------------------------
+// DashboardStepAnalyzer -- thin adapter: StepAnalyzer → QualityReviewerAgent
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// DashboardStepAnalyzer
+// ---------------------------------------------------------------------------
+export class DashboardStepAnalyzer {
+    qualityReviewer;
+    constructor(qualityReviewer) {
+        this.qualityReviewer = qualityReviewer;
+    }
+    async analyze(node, rawOutput, _ctx, _prevCmd) {
+        // Convert CommandNode → CoordinateStep for QualityReviewerAgent
+        const step = {
+            index: 0,
+            cmd: node.cmd,
+            args: node.args ?? '',
+            status: 'completed',
+            processId: null,
+            analysis: null,
+            summary: null,
+        };
+        const analysis = await this.qualityReviewer.review(step, rawOutput);
+        // Convert StepAnalysis (camelCase) → AnalysisResult (snake_case)
+        return {
+            quality_score: analysis.qualityScore,
+            issues: analysis.issues,
+            next_step_hints: {
+                prompt_additions: analysis.nextStepHints || undefined,
+            },
+        };
+    }
+}
+//# sourceMappingURL=dashboard-step-analyzer.js.map

package/dashboard/dist-server/server/coordinator/dashboard-step-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-step-analyzer.js","sourceRoot":"","sources":["../../../src/server/coordinator/dashboard-step-analyzer.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAM9E,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,eAAqC;QAArC,oBAAe,GAAf,eAAe,CAAsB;IAAG,CAAC;IAEtE,KAAK,CAAC,OAAO,CACX,IAAiB,EACjB,SAAiB,EACjB,IAAmB,EACnB,QAA8C;QAE9C,gEAAgE;QAChE,MAAM,IAAI,GAAmB;YAC3B,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;YACrB,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEpE,iEAAiE;QACjE,OAAO;YACL,aAAa,EAAE,QAAQ,CAAC,YAAY;YACpC,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,eAAe,EAAE;gBACf,gBAAgB,EAAE,QAAQ,CAAC,aAAa,IAAI,SAAS;aACtD;SACF,CAAC;IACJ,CAAC;CACF"}

package/dashboard/dist-server/server/coordinator/graph-walker-factory.d.ts

@@ -0,0 +1,22 @@
+import type { WalkerEventEmitter, StepAnalyzer } from '../../../../src/coordinator/graph-types.js';
+import type { AgentManager } from '../agents/agent-manager.js';
+import type { DashboardEventBus } from '../state/event-bus.js';
+export interface GraphWalkerCreateConfig {
+    agentManager: AgentManager;
+    eventBus: DashboardEventBus;
+    workDir: string;
+    emitter: WalkerEventEmitter;
+    analyzer: StepAnalyzer | null;
+    sessionDir: string;
+}
+export declare class GraphWalkerFactory {
+    private infraPromise;
+    /** Cache ALL dynamic imports in a single promise on first access */
+    private ensureInfra;
+    /** Create a fully-wired GraphWalker + IntentRouter + DashboardExecutor */
+    create(config: GraphWalkerCreateConfig): Promise<{
+        walker: InstanceType<any>;
+        router: InstanceType<any>;
+        executor: InstanceType<any>;
+    }>;
+}

package/dashboard/dist-server/server/coordinator/graph-walker-factory.js

@@ -0,0 +1,53 @@
+// ---------------------------------------------------------------------------
+// GraphWalkerFactory -- cached dynamic imports + create(config) for GraphWalker
+// ---------------------------------------------------------------------------
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+// ---------------------------------------------------------------------------
+// GraphWalkerFactory
+// ---------------------------------------------------------------------------
+export class GraphWalkerFactory {
+    infraPromise = null;
+    /** Cache ALL dynamic imports in a single promise on first access */
+    ensureInfra() {
+        if (!this.infraPromise) {
+            this.infraPromise = Promise.all([
+                import('../../../../src/coordinator/graph-walker.js'),
+                import('../../../../src/coordinator/graph-loader.js'),
+                import('../../../../src/coordinator/expr-evaluator.js'),
+                import('../../../../src/coordinator/output-parser.js'),
+                import('../../../../src/coordinator/prompt-assembler.js'),
+                import('./dashboard-executor.js'),
+                import('../../../../src/coordinator/intent-router.js'),
+                import('node:os'),
+            ]).then(([gw, gl, ee, op, pa, de, ir, os]) => ({
+                GraphWalker: gw.GraphWalker,
+                GraphLoader: gl.GraphLoader,
+                DefaultExprEvaluator: ee.DefaultExprEvaluator,
+                DefaultOutputParser: op.DefaultOutputParser,
+                DefaultPromptAssembler: pa.DefaultPromptAssembler,
+                DashboardExecutor: de.DashboardExecutor,
+                IntentRouter: ir.IntentRouter,
+                homedir: os.homedir,
+            }));
+        }
+        return this.infraPromise;
+    }
+    /** Create a fully-wired GraphWalker + IntentRouter + DashboardExecutor */
+    async create(config) {
+        const infra = await this.ensureInfra();
+        const globalChainsRoot = resolve(infra.homedir(), '.maestro', 'chains');
+        const localChainsRoot = resolve(config.workDir, 'chains');
+        const chainsRoot = existsSync(localChainsRoot) ? localChainsRoot : globalChainsRoot;
+        const templateDir = resolve(infra.homedir(), '.maestro', 'templates', 'cli', 'prompts');
+        const loader = new infra.GraphLoader(chainsRoot);
+        const executor = new infra.DashboardExecutor(config.agentManager, config.eventBus);
+        const assembler = new infra.DefaultPromptAssembler(config.workDir, templateDir);
+        const evaluator = new infra.DefaultExprEvaluator();
+        const parser = new infra.DefaultOutputParser();
+        const router = new infra.IntentRouter(loader, chainsRoot);
+        const walker = new infra.GraphWalker(loader, assembler, executor, config.analyzer, parser, evaluator, config.emitter, config.sessionDir);
+        return { walker, router, executor };
+    }
+}
+//# sourceMappingURL=graph-walker-factory.js.map

package/dashboard/dist-server/server/coordinator/graph-walker-factory.js.map

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

package/dashboard/dist-server/server/coordinator/prompts/index.d.ts

@@ -0,0 +1,18 @@
+/** Configure the user-customizable prompts directory */
+export declare function setPromptsDir(workflowRoot: string): void;
+/** Clear cached prompts (useful after user edits override files) */
+export declare function clearPromptCache(): void;
+/**
+ * Load a prompt template by name.
+ * Checks {workflowRoot}/coordinator/prompts/{name}.md first,
+ * then falls back to the built-in default.
+ */
+export declare function loadPrompt(name: string): Promise<string>;
+/**
+ * List available prompt names from both user and built-in directories.
+ * Returns deduplicated names (without .md extension).
+ */
+export declare function listPrompts(): Promise<{
+    name: string;
+    source: 'user' | 'builtin';
+}[]>;

package/dashboard/dist-server/server/coordinator/prompts/index.js

@@ -0,0 +1,82 @@
+// ---------------------------------------------------------------------------
+// Prompt loader — manages built-in + user-customized prompt templates
+//
+// Directory structure:
+//   Built-in (fallback):  <compiled>/coordinator/prompts/{name}.md
+//   User override:        {workflowRoot}/coordinator/prompts/{name}.md
+//
+// Resolution: user override → built-in default
+// Cache is per-process; restart dashboard to pick up changes.
+// ---------------------------------------------------------------------------
+import { readFile, readdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cache = new Map();
+let _userPromptsDir = null;
+/** Configure the user-customizable prompts directory */
+export function setPromptsDir(workflowRoot) {
+    _userPromptsDir = join(workflowRoot, 'coordinator', 'prompts');
+}
+/** Clear cached prompts (useful after user edits override files) */
+export function clearPromptCache() {
+    cache.clear();
+}
+/**
+ * Load a prompt template by name.
+ * Checks {workflowRoot}/coordinator/prompts/{name}.md first,
+ * then falls back to the built-in default.
+ */
+export async function loadPrompt(name) {
+    if (cache.has(name))
+        return cache.get(name);
+    // Try user override
+    if (_userPromptsDir) {
+        try {
+            const content = await readFile(join(_userPromptsDir, `${name}.md`), 'utf-8');
+            cache.set(name, content);
+            return content;
+        }
+        catch {
+            // Not found — fall through to built-in
+        }
+    }
+    // Built-in default
+    const content = await readFile(join(__dirname, `${name}.md`), 'utf-8');
+    cache.set(name, content);
+    return content;
+}
+/**
+ * List available prompt names from both user and built-in directories.
+ * Returns deduplicated names (without .md extension).
+ */
+export async function listPrompts() {
+    const results = new Map();
+    // User prompts first (higher priority)
+    if (_userPromptsDir) {
+        try {
+            const files = await readdir(_userPromptsDir);
+            for (const f of files) {
+                if (f.endsWith('.md'))
+                    results.set(f.replace(/\.md$/, ''), 'user');
+            }
+        }
+        catch {
+            // Directory doesn't exist
+        }
+    }
+    // Built-in prompts (only add if not already overridden)
+    try {
+        const files = await readdir(__dirname);
+        for (const f of files) {
+            if (f.endsWith('.md') && !results.has(f.replace(/\.md$/, ''))) {
+                results.set(f.replace(/\.md$/, ''), 'builtin');
+            }
+        }
+    }
+    catch {
+        // Should not happen
+    }
+    return Array.from(results.entries()).map(([name, source]) => ({ name, source }));
+}
+//# sourceMappingURL=index.js.map

package/dashboard/dist-server/server/coordinator/prompts/index.js.map

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

package/dashboard/dist-server/server/coordinator/tools/workflow-mcp-server.d.ts

@@ -0,0 +1,3 @@
+import type { McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
+import type { StateManager } from '../../state/state-manager.js';
+export declare function createWorkflowMcpServer(stateManager: StateManager, workflowRoot: string): McpSdkServerConfigWithInstance;