ridgeline 0.4.4 → 0.5.7

package/dist/engine/claude/claude.exec.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.invokeClaude = exports.killAllClaudeSync = exports.killAllClaude = void 0;
 const node_child_process_1 = require("node:child_process");
-const stream_decode_1 = require("./stream.decode");
+const stream_result_1 = require("./stream.result");
 /** Default: kill if no stdout arrives within 2 minutes of spawn. */
 const DEFAULT_STARTUP_TIMEOUT_MS = 2 * 60 * 1000;
 /** Default: kill if no stdout arrives for 5 minutes during execution. */
@@ -165,7 +165,7 @@ const invokeClaude = async (opts) => {
                 return;
             }
             try {
-                resolve((0, stream_decode_1.extractResult)(stdoutData));
+                resolve((0, stream_result_1.extractResult)(stdoutData));
             }
             catch (err) {
                 reject(new Error(`Failed to parse claude output: ${err}`));

package/dist/engine/claude/stream.display.d.ts

@@ -0,0 +1,17 @@
+interface DisplayCallbackOptions {
+    /** Suppress fenced JSON blocks (```json ... ```) from display output. */
+    suppressJsonBlock?: boolean;
+    /** When set, strip this prefix from tool-call file paths so the display shows relative paths. */
+    projectRoot?: string;
+}
+/**
+ * Create an onStdout callback that streams assistant text to stdout.
+ * The spinner pauses while text is streaming and resumes after a
+ * debounce period of inactivity, keeping it visible during tool-use pauses.
+ * Returns the callback and a flush function to finalize output.
+ */
+export declare const createDisplayCallbacks: (opts?: DisplayCallbackOptions) => {
+    onStdout: (chunk: string) => void;
+    flush: () => void;
+};
+export {};

package/dist/engine/claude/stream.display.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDisplayCallbacks = void 0;
+const stream_parse_1 = require("./stream.parse");
+const spinner_1 = require("../../ui/spinner");
+const RESUME_DEBOUNCE_MS = 200;
+/**
+ * Create an onStdout callback that streams assistant text to stdout.
+ * The spinner pauses while text is streaming and resumes after a
+ * debounce period of inactivity, keeping it visible during tool-use pauses.
+ * Returns the callback and a flush function to finalize output.
+ */
+const createDisplayCallbacks = (opts) => {
+    let hasStreamedText = false;
+    let lastCharWasNewline = true;
+    let jsonSuppressed = false;
+    let lastEventWasTool = false;
+    let resumeTimer = null;
+    const spinner = (0, spinner_1.startSpinner)();
+    const scheduleResume = () => {
+        if (resumeTimer)
+            clearTimeout(resumeTimer);
+        resumeTimer = setTimeout(() => {
+            resumeTimer = null;
+            if (!lastCharWasNewline) {
+                process.stdout.write("\n");
+                lastCharWasNewline = true;
+            }
+            spinner.resume();
+        }, RESUME_DEBOUNCE_MS);
+    };
+    const writeText = (text) => {
+        if (opts?.suppressJsonBlock) {
+            const lines = text.split("\n");
+            const output = [];
+            for (const line of lines) {
+                if (!jsonSuppressed && /^\s*```json\s*$/.test(line)) {
+                    jsonSuppressed = true;
+                    continue;
+                }
+                if (jsonSuppressed)
+                    continue;
+                output.push(line);
+            }
+            if (output.length === 0)
+                return;
+            text = output.join("\n");
+            if (text.length === 0)
+                return;
+        }
+        if (!lastCharWasNewline) {
+            process.stdout.write("\n");
+        }
+        process.stdout.write(text);
+        lastCharWasNewline = text.endsWith("\n");
+    };
+    const handler = (0, stream_parse_1.createStreamHandler)((event) => {
+        if (event.type === "text") {
+            if (!hasStreamedText) {
+                hasStreamedText = true;
+            }
+            spinner.pause();
+            if (resumeTimer)
+                clearTimeout(resumeTimer);
+            if (lastEventWasTool) {
+                process.stdout.write("\n");
+                lastEventWasTool = false;
+            }
+            writeText(event.text);
+            scheduleResume();
+        }
+        else if (event.type === "tool_use") {
+            let summary = event.summary;
+            if (summary && opts?.projectRoot) {
+                const root = opts.projectRoot.endsWith("/") ? opts.projectRoot : opts.projectRoot + "/";
+                summary = summary.replaceAll(root, "");
+            }
+            const line = summary
+                ? `[${event.tool}] ${summary}`
+                : `[${event.tool}]`;
+            spinner.printAbove(line);
+            spinner.setDetail(event.tool);
+            lastEventWasTool = true;
+        }
+    });
+    return {
+        onStdout: handler,
+        flush: () => {
+            if (resumeTimer) {
+                clearTimeout(resumeTimer);
+                resumeTimer = null;
+            }
+            spinner.stop();
+            if (hasStreamedText && !lastCharWasNewline) {
+                process.stdout.write("\n");
+            }
+        },
+    };
+};
+exports.createDisplayCallbacks = createDisplayCallbacks;
+//# sourceMappingURL=stream.display.js.map

package/dist/engine/claude/stream.display.js.map

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

package/dist/engine/claude/stream.parse.d.ts

@@ -0,0 +1,21 @@
+import { ClaudeResult } from "../../types";
+export type StreamEvent = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool_use";
+    tool: string;
+    summary?: string;
+} | {
+    type: "result";
+    result: ClaudeResult;
+} | {
+    type: "other";
+};
+export declare const parseClaudeResult: (parsed: Record<string, unknown>) => ClaudeResult;
+export declare const parseStreamLine: (line: string) => StreamEvent;
+/**
+ * Line-buffered chunk handler. Splits raw stdout chunks on newlines,
+ * parses complete lines, and calls `onEvent` for each.
+ */
+export declare const createStreamHandler: (onEvent: (event: StreamEvent) => void) => ((chunk: string) => void);

package/dist/engine/claude/stream.parse.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStreamHandler = exports.parseStreamLine = exports.parseClaudeResult = void 0;
+/**
+ * Parse a single NDJSON line from `claude --output-format stream-json`.
+ *
+ * Relevant event shapes:
+ * - `{"type":"assistant","subtype":"text","text":"..."}` — streamed model text
+ * - `{"type":"result","result":"...","total_cost_usd":...}` — final result with usage
+ */
+const MAX_SUMMARY_LEN = 200;
+const summarizeToolInput = (input) => {
+    // Pick the most informative field per tool type
+    const raw = input.command ?? // Bash
+        input.file_path ?? // Read, Write, Edit
+        input.pattern ?? // Grep, Glob
+        input.prompt; // Agent
+    if (typeof raw !== "string" || raw.length === 0)
+        return undefined;
+    // Take first line only
+    const firstLine = raw.split("\n")[0];
+    if (firstLine.length <= MAX_SUMMARY_LEN)
+        return firstLine;
+    return firstLine.slice(0, MAX_SUMMARY_LEN - 1) + "…";
+};
+const parseClaudeResult = (parsed) => {
+    const result = parsed.result;
+    return {
+        success: !parsed.is_error,
+        result: typeof result === "string"
+            ? result
+            : (result != null ? JSON.stringify(result) : ""),
+        durationMs: parsed.duration_ms ?? 0,
+        costUsd: parsed.total_cost_usd ?? 0,
+        usage: {
+            inputTokens: parsed.usage?.input_tokens ?? 0,
+            outputTokens: parsed.usage?.output_tokens ?? 0,
+            cacheReadInputTokens: parsed.usage?.cache_read_input_tokens ?? 0,
+            cacheCreationInputTokens: parsed.usage?.cache_creation_input_tokens ?? 0,
+        },
+        sessionId: parsed.session_id ?? "",
+    };
+};
+exports.parseClaudeResult = parseClaudeResult;
+const parseStreamLine = (line) => {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+        return { type: "other" };
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return { type: "other" };
+    }
+    // Legacy format: {"type":"assistant","subtype":"text","text":"..."}
+    if (parsed.type === "assistant" && parsed.subtype === "text") {
+        const text = parsed.text;
+        if (typeof text === "string" && text.length > 0) {
+            return { type: "text", text };
+        }
+        return { type: "other" };
+    }
+    // Legacy format: {"type":"assistant","subtype":"tool_use","tool":"Read"}
+    if (parsed.type === "assistant" && parsed.subtype === "tool_use") {
+        const tool = parsed.tool;
+        if (typeof tool === "string" && tool.length > 0) {
+            return { type: "tool_use", tool };
+        }
+        return { type: "other" };
+    }
+    // Current format: {"type":"assistant","message":{"content":[...]}}
+    if (parsed.type === "assistant" && parsed.message) {
+        const message = parsed.message;
+        const content = message.content;
+        if (Array.isArray(content)) {
+            const textParts = content
+                .filter((c) => c.type === "text" && typeof c.text === "string")
+                .map((c) => c.text)
+                .join("");
+            if (textParts.length > 0) {
+                return { type: "text", text: textParts };
+            }
+            // No text found — check for tool_use blocks
+            const toolBlock = content.find((c) => c.type === "tool_use" && typeof c.name === "string");
+            if (toolBlock) {
+                const summary = toolBlock.input
+                    ? summarizeToolInput(toolBlock.input)
+                    : undefined;
+                return { type: "tool_use", tool: toolBlock.name, summary };
+            }
+        }
+        return { type: "other" };
+    }
+    if (parsed.type === "result") {
+        return { type: "result", result: (0, exports.parseClaudeResult)(parsed) };
+    }
+    return { type: "other" };
+};
+exports.parseStreamLine = parseStreamLine;
+/**
+ * Line-buffered chunk handler. Splits raw stdout chunks on newlines,
+ * parses complete lines, and calls `onEvent` for each.
+ */
+const createStreamHandler = (onEvent) => {
+    let buffer = "";
+    return (chunk) => {
+        buffer += chunk;
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            if (line.trim().length > 0) {
+                onEvent((0, exports.parseStreamLine)(line));
+            }
+        }
+    };
+};
+exports.createStreamHandler = createStreamHandler;
+//# sourceMappingURL=stream.parse.js.map

package/dist/engine/claude/stream.parse.js.map

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

package/dist/engine/claude/stream.result.d.ts

@@ -0,0 +1,6 @@
+import { ClaudeResult } from "../../types";
+/**
+ * Scan accumulated NDJSON stdout for the final `type: "result"` event
+ * and return a parsed ClaudeResult.
+ */
+export declare const extractResult: (ndjsonStdout: string) => ClaudeResult;

package/dist/engine/claude/stream.result.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractResult = void 0;
+const stream_parse_1 = require("./stream.parse");
+const collectContentFallbacks = (parsed, acc) => {
+    // Check for StructuredOutput tool_use in assistant messages
+    if (parsed.type === "assistant" && parsed.message) {
+        const content = parsed.message.content;
+        if (Array.isArray(content)) {
+            for (const block of content) {
+                if (block.type === "tool_use" && block.name === "StructuredOutput" && block.input != null) {
+                    acc.structuredOutput = typeof block.input === "string"
+                        ? block.input
+                        : JSON.stringify(block.input);
+                }
+                if (block.type === "text" && typeof block.text === "string") {
+                    acc.textParts.push(block.text);
+                }
+            }
+        }
+    }
+    // Legacy format text
+    if (parsed.type === "assistant" && parsed.subtype === "text" && typeof parsed.text === "string") {
+        acc.textParts.push(parsed.text);
+    }
+};
+/**
+ * Scan accumulated NDJSON stdout for the final `type: "result"` event
+ * and return a parsed ClaudeResult.
+ */
+const extractResult = (ndjsonStdout) => {
+    const lines = ndjsonStdout.trim().split("\n");
+    // Collect fallback content for when result field is empty.
+    // --json-schema uses a synthetic StructuredOutput tool_use whose input IS the JSON.
+    // Text content is also collected as a secondary fallback.
+    const fallbacks = { textParts: [], structuredOutput: null };
+    let resultEvent = null;
+    for (const line of lines) {
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed.type === "result") {
+                resultEvent = (0, stream_parse_1.parseClaudeResult)(parsed);
+                continue;
+            }
+            collectContentFallbacks(parsed, fallbacks);
+        }
+        catch {
+            // Not valid JSON, skip
+        }
+    }
+    if (!resultEvent) {
+        throw new Error("No result event found in stream-json output");
+    }
+    // Populate result from fallbacks: StructuredOutput first, then text content
+    if (!resultEvent.result) {
+        resultEvent.result = fallbacks.structuredOutput ?? (fallbacks.textParts.length > 0 ? fallbacks.textParts.join("") : "");
+    }
+    return resultEvent;
+};
+exports.extractResult = extractResult;
+//# sourceMappingURL=stream.result.js.map

package/dist/engine/claude/stream.result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.result.js","sourceRoot":"","sources":["../../../src/engine/claude/stream.result.ts"],"names":[],"mappings":";;;AACA,iDAAkD;AAOlD,MAAM,uBAAuB,GAAG,CAAC,MAA+B,EAAE,GAAqB,EAAQ,EAAE;IAC/F,4DAA4D;IAC5D,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAClD,MAAM,OAAO,GAAI,MAAM,CAAC,OAAmC,CAAC,OAAqD,CAAA;QACjH,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;oBAC1F,GAAG,CAAC,gBAAgB,GAAG,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;wBACpD,CAAC,CAAC,KAAK,CAAC,KAAK;wBACb,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;gBACjC,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC5D,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAc,CAAC,CAAA;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAChG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAc,CAAC,CAAA;IAC3C,CAAC;AACH,CAAC,CAAA;AAED;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAC,YAAoB,EAAgB,EAAE;IAClE,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAE7C,2DAA2D;IAC3D,oFAAoF;IACpF,0DAA0D;IAC1D,MAAM,SAAS,GAAqB,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAA;IAE7E,IAAI,WAAW,GAAwB,IAAI,CAAA;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC/B,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,WAAW,GAAG,IAAA,gCAAiB,EAAC,MAAM,CAAC,CAAA;gBACvC,SAAQ;YACV,CAAC;YACD,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAChE,CAAC;IAED,4EAA4E;IAC5E,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;QACxB,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACzH,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA;AAhCY,QAAA,aAAa,iBAgCzB"}

package/dist/engine/discovery/agent.registry.d.ts

@@ -0,0 +1,27 @@
+import { DiscoveredAgent } from "./agent.scan";
+export type SpecialistDef = {
+    perspective: string;
+    overlay: string;
+};
+type AgentRegistry = {
+    /** Get a core agent prompt by filename (e.g., "builder.md"). Throws if missing. */
+    getCorePrompt: (filename: string) => string;
+    /** Get ensemble specialists for a subfolder (e.g., "planners"). */
+    getSpecialists: (subfolder: string) => SpecialistDef[];
+    /** Get shared context for an ensemble subfolder. Returns null if no context.md. */
+    getContext: (subfolder: string) => string | null;
+    /** Get sub-agents from specialists/ as DiscoveredAgent[]. */
+    getSubAgents: () => DiscoveredAgent[];
+    /** Get the agents flag object for Claude invocation. */
+    getAgentsFlag: () => Record<string, {
+        description: string;
+        prompt: string;
+        model?: string;
+    }>;
+};
+/**
+ * Build an agent registry that resolves agents from an optional flavour
+ * directory with per-subfolder fallback to the generic defaults in src/agents/.
+ */
+export declare const buildAgentRegistry: (flavourPath: string | null) => AgentRegistry;
+export {};

package/dist/engine/discovery/agent.registry.js

@@ -0,0 +1,152 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAgentRegistry = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const agent_scan_1 = require("./agent.scan");
+// ---------------------------------------------------------------------------
+// Path resolution helpers
+// ---------------------------------------------------------------------------
+/** Resolve the built-in agents/ directory across dist and src layouts. */
+const resolveDefaultAgentsDir = () => {
+    const candidates = [
+        path.join(__dirname, "..", "agents"),
+        path.join(__dirname, "..", "..", "agents"),
+        path.join(__dirname, "..", "..", "..", "src", "agents"),
+    ];
+    for (const dir of candidates) {
+        if (fs.existsSync(dir) && fs.statSync(dir).isDirectory())
+            return dir;
+    }
+    return null;
+};
+/**
+ * For a given subfolder (core, planners, specifiers, specialists), return the
+ * directory to use — flavour's version if present, otherwise the default.
+ */
+const resolveSubfolder = (subfolder, flavourPath, defaultAgentsDir) => {
+    if (flavourPath) {
+        const flavourSub = path.join(flavourPath, subfolder);
+        if (fs.existsSync(flavourSub) && fs.statSync(flavourSub).isDirectory()) {
+            return flavourSub;
+        }
+    }
+    const defaultSub = path.join(defaultAgentsDir, subfolder);
+    if (fs.existsSync(defaultSub) && fs.statSync(defaultSub).isDirectory()) {
+        return defaultSub;
+    }
+    return null;
+};
+// ---------------------------------------------------------------------------
+// Specialist discovery (extracted from ensemble.exec.ts)
+// ---------------------------------------------------------------------------
+const discoverSpecialistsInDir = (dir, excludeFiles) => {
+    const exclude = new Set(excludeFiles ?? []);
+    const specialists = [];
+    for (const entry of fs.readdirSync(dir)) {
+        if (!entry.endsWith(".md"))
+            continue;
+        if (exclude.has(entry))
+            continue;
+        const filepath = path.join(dir, entry);
+        try {
+            const content = fs.readFileSync(filepath, "utf-8");
+            const fm = (0, agent_scan_1.parseFrontmatter)(content);
+            if (!fm)
+                continue;
+            const perspectiveMatch = content.match(/^perspective:\s*(.+)$/m);
+            const perspective = perspectiveMatch ? perspectiveMatch[1].trim() : fm.name;
+            const body = content.replace(/^---\n[\s\S]*?\n---\n*/, "").trim();
+            if (!body)
+                continue;
+            specialists.push({ perspective, overlay: body });
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return specialists;
+};
+// ---------------------------------------------------------------------------
+// Registry builder
+// ---------------------------------------------------------------------------
+/**
+ * Build an agent registry that resolves agents from an optional flavour
+ * directory with per-subfolder fallback to the generic defaults in src/agents/.
+ */
+const buildAgentRegistry = (flavourPath) => {
+    const defaultAgentsDir = resolveDefaultAgentsDir();
+    if (!defaultAgentsDir) {
+        throw new Error("Built-in agents directory not found");
+    }
+    const getCorePrompt = (filename) => {
+        const coreDir = resolveSubfolder("core", flavourPath, defaultAgentsDir);
+        if (!coreDir)
+            throw new Error("No core agents directory found");
+        const filepath = path.join(coreDir, filename);
+        if (!fs.existsSync(filepath)) {
+            throw new Error(`Core agent not found: ${filename}`);
+        }
+        return fs.readFileSync(filepath, "utf-8");
+    };
+    const getSpecialists = (subfolder) => {
+        const dir = resolveSubfolder(subfolder, flavourPath, defaultAgentsDir);
+        if (!dir)
+            return [];
+        return discoverSpecialistsInDir(dir, ["context.md"]);
+    };
+    const getContext = (subfolder) => {
+        const dir = resolveSubfolder(subfolder, flavourPath, defaultAgentsDir);
+        if (!dir)
+            return null;
+        const contextPath = path.join(dir, "context.md");
+        if (!fs.existsSync(contextPath))
+            return null;
+        return fs.readFileSync(contextPath, "utf-8");
+    };
+    const getSubAgents = () => {
+        const dir = resolveSubfolder("specialists", flavourPath, defaultAgentsDir);
+        if (!dir)
+            return [];
+        return (0, agent_scan_1.discoverAgentsInDir)(dir);
+    };
+    const getAgentsFlag = () => {
+        return (0, agent_scan_1.buildAgentsFlag)(getSubAgents());
+    };
+    return { getCorePrompt, getSpecialists, getContext, getSubAgents, getAgentsFlag };
+};
+exports.buildAgentRegistry = buildAgentRegistry;
+//# sourceMappingURL=agent.registry.js.map

package/dist/engine/discovery/agent.registry.js.map

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

package/dist/engine/discovery/agent.scan.d.ts

@@ -12,7 +12,6 @@ type Frontmatter = {
 };
 export declare const parseFrontmatter: (content: string) => Frontmatter | null;
 export declare const discoverAgentsInDir: (dir: string) => DiscoveredAgent[];
-export declare const discoverBuiltinAgents: () => DiscoveredAgent[];
 export declare const buildAgentsFlag: (agents: DiscoveredAgent[]) => Record<string, {
     description: string;
     prompt: string;

package/dist/engine/discovery/agent.scan.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildAgentsFlag = exports.discoverBuiltinAgents = exports.discoverAgentsInDir = exports.parseFrontmatter = void 0;
+exports.buildAgentsFlag = exports.discoverAgentsInDir = exports.parseFrontmatter = void 0;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const parseFrontmatter = (content) => {
@@ -53,18 +53,6 @@ const parseFrontmatter = (content) => {
     };
 };
 exports.parseFrontmatter = parseFrontmatter;
-const resolveSpecialistsDir = () => {
-    const candidates = [
-        path.join(__dirname, "agents", "specialists"),
-        path.join(__dirname, "..", "agents", "specialists"),
-        path.join(__dirname, "..", "..", "src", "agents", "specialists"),
-    ];
-    for (const dir of candidates) {
-        if (fs.existsSync(dir) && fs.statSync(dir).isDirectory())
-            return dir;
-    }
-    return null;
-};
 const discoverAgentsInDir = (dir) => {
     if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory())
         return [];
@@ -93,13 +81,6 @@ const discoverAgentsInDir = (dir) => {
     return agents;
 };
 exports.discoverAgentsInDir = discoverAgentsInDir;
-const discoverBuiltinAgents = () => {
-    const specialistsDir = resolveSpecialistsDir();
-    if (!specialistsDir)
-        return [];
-    return (0, exports.discoverAgentsInDir)(specialistsDir);
-};
-exports.discoverBuiltinAgents = discoverBuiltinAgents;
 const buildAgentsFlag = (agents) => {
     const result = {};
     for (const agent of agents) {

package/dist/engine/discovery/agent.scan.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.scan.js","sourceRoot":"","sources":["../../../src/engine/discovery/agent.scan.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.scan.js","sourceRoot":"","sources":["../../../src/engine/discovery/agent.scan.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAgB1B,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAsB,EAAE;IACtE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IAEvB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACtB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;IAChD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAA;IACvD,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAA;IAEzC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;IAElD,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QACzB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QAChC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;KAChD,CAAA;AACH,CAAC,CAAA;AAhBY,QAAA,gBAAgB,oBAgB5B;AAEM,MAAM,mBAAmB,GAAG,CACjC,GAAW,EACQ,EAAE;IACrB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;QAAE,OAAO,EAAE,CAAA;IAErE,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAQ;QAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACtC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAClD,MAAM,EAAE,GAAG,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAA;YACpC,IAAI,CAAC,EAAE;gBAAE,SAAQ;YAEjB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AA7BY,QAAA,mBAAmB,uBA6B/B;AAEM,MAAM,eAAe,GAAG,CAC7B,MAAyB,EACgD,EAAE;IAC3E,MAAM,MAAM,GAA4E,EAAE,CAAA;IAE1F,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAA4D;YACrE,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAA;QACD,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;QAE1C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IAC5B,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAhBY,QAAA,eAAe,mBAgB3B"}

package/dist/engine/discovery/flavour.resolve.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve a flavour identifier to an absolute directory path.
+ *
+ * - If the value looks like a filesystem path (contains / or . or ~),
+ *   resolve it against the current working directory.
+ * - Otherwise treat it as a built-in flavour name and look it up
+ *   under src/flavours/{name}/.
+ * - Returns null when no flavour is specified.
+ * - Throws when a flavour is specified but cannot be found.
+ */
+export declare const resolveFlavour: (flavour: string | null) => string | null;