@kilnai/cli 0.1.1

package/dist/index.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env bun
+export { ClaudeSession } from "./wrapper/claude-code-process.js";
+export { SessionManager } from "./wrapper/session-manager.js";
+export { KilnMcpServer, KILN_TOOLS } from "./mcp/index.js";
+export async function createCli(config) {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    const COMMANDS = {
+        init: `Initialize ${config.appName} in the current project (--force, --non-interactive, --domain, --provider, --channels, --team-mode)`,
+        run: "Start a CLI-only coding session with Claude Code",
+        status: "Show current phase, tasks, and costs",
+        memory: "Browse and search memory layers",
+        config: "Edit domain config and provider settings",
+        serve: `Start ${config.appName} MCP server (used by Claude Code)`,
+        "mcp-config": "Generate MCP client configuration JSON",
+        domain: "Manage domain packages (install, list, search, info, remove)",
+        gateway: "Start persistent Gateway (multi-app hosting)",
+        dev: "Start development mode with hot-reload and event streaming (--playground)",
+        skill: "Manage skills (list, install, publish)",
+    };
+    function printHelp() {
+        console.log(`\n${capitalize(config.appName)} -- ${config.description}\n`);
+        console.log(`Usage: ${config.appName} [command] [options]\n`);
+        console.log("Commands:");
+        for (const [cmd, desc] of Object.entries(COMMANDS)) {
+            console.log(`  ${cmd.padEnd(12)} ${desc}`);
+        }
+        console.log("\nOptions:");
+        console.log("  --api-key    Anthropic API key (required for Mode A)");
+        console.log("  --provider   LLM provider (claude, openai, deepseek)");
+        console.log("  --port       Port override (dev/gateway)");
+        console.log("  --playground Open Studio in browser (dev mode)");
+        console.log(`\nRun '${config.appName} <command> --help' for command-specific help.\n`);
+    }
+    if (!command) {
+        const { devCommand } = await import("./commands/dev.js");
+        await devCommand(config, {});
+        return;
+    }
+    if (command === "--help" || command === "-h") {
+        printHelp();
+        process.exit(0);
+    }
+    if (command === "--version" || command === "-v") {
+        console.log(`${config.appName} ${config.version}`);
+        process.exit(0);
+    }
+    if (!(command in COMMANDS)) {
+        console.error(`Unknown command: ${command}`);
+        printHelp();
+        process.exit(1);
+    }
+    if (command === "init") {
+        const { initCommand } = await import("./commands/init.js");
+        await initCommand(config, process.cwd(), {
+            force: args.includes("--force"),
+            interactive: !args.includes("--non-interactive"),
+            domain: findFlag(args, "--domain"),
+            provider: findFlag(args, "--provider"),
+            channels: findFlag(args, "--channels"),
+            teamMode: findFlag(args, "--team-mode"),
+        });
+        return;
+    }
+    if (command === "serve") {
+        const { serveCommand } = await import("./commands/serve.js");
+        await serveCommand(config);
+        return;
+    }
+    if (command === "run") {
+        const { task, flags } = parseRunArgs(args.slice(1));
+        const { runCommand } = await import("./commands/run.js");
+        await runCommand(config, task, flags);
+        return;
+    }
+    if (command === "status") {
+        const { statusCommand } = await import("./commands/status.js");
+        statusCommand(config);
+        return;
+    }
+    if (command === "memory") {
+        const { memoryCommand } = await import("./commands/memory.js");
+        memoryCommand(config, args[1] ?? "", args.slice(2));
+        return;
+    }
+    if (command === "config") {
+        const { configCommand } = await import("./commands/config.js");
+        configCommand(config, args[1] ?? "", args.slice(2));
+        return;
+    }
+    if (command === "mcp-config") {
+        const { mcpConfigCommand } = await import("./commands/mcp-config.js");
+        const client = args[1];
+        const transport = args.find(a => a.startsWith("--transport="))?.split("=")[1];
+        const port = args.find(a => a.startsWith("--port="))?.split("=")[1];
+        mcpConfigCommand(config, client, transport, port ? parseInt(port, 10) : undefined);
+        return;
+    }
+    if (command === "domain") {
+        const { domainCommand } = await import("./commands/domain.js");
+        await domainCommand(config, args[1] ?? "", args.slice(2));
+        return;
+    }
+    if (command === "gateway") {
+        const { gatewayCommand } = await import("./commands/gateway.js");
+        await gatewayCommand(args.slice(1));
+        return;
+    }
+    if (command === "dev") {
+        const { devCommand } = await import("./commands/dev.js");
+        const port = parsePort(args);
+        const configPath = findFlag(args, "--config");
+        const playground = args.includes("--playground");
+        await devCommand(config, { port, configPath, playground });
+        return;
+    }
+    if (command === "skill") {
+        const { skillCommand } = await import("./commands/skill.js");
+        await skillCommand(config, args[1] ?? "", args.slice(2));
+        return;
+    }
+}
+function findFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx >= 0 && idx + 1 < args.length)
+        return args[idx + 1];
+    return undefined;
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function parsePort(args) {
+    const portIdx = args.indexOf("--port");
+    if (portIdx >= 0 && portIdx + 1 < args.length) {
+        const parsed = parseInt(args[portIdx + 1], 10);
+        if (!Number.isNaN(parsed) && parsed > 0)
+            return parsed;
+    }
+    return 4800;
+}
+function parseRunArgs(rawArgs) {
+    const flags = {};
+    const taskParts = [];
+    let i = 0;
+    while (i < rawArgs.length) {
+        const arg = rawArgs[i];
+        if (arg === "--api-key" && i + 1 < rawArgs.length) {
+            flags.apiKey = rawArgs[i + 1];
+            i += 2;
+        }
+        else if (arg === "--provider" && i + 1 < rawArgs.length) {
+            flags.provider = rawArgs[i + 1];
+            i += 2;
+        }
+        else if (arg === "--dangerously-skip-permissions") {
+            flags.dangerouslySkipPermissions = true;
+            i += 1;
+        }
+        else {
+            taskParts.push(arg);
+            i += 1;
+        }
+    }
+    return { task: taskParts.join(" "), flags };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp/config-generator.d.ts

@@ -0,0 +1,10 @@
+export type McpClient = "claude-code" | "cursor" | "generic";
+export interface McpClientConfig {
+    readonly client: McpClient;
+    readonly transport: "stdio" | "sse";
+    readonly port?: number;
+    readonly mcpServerName: string;
+    readonly appName: string;
+}
+export declare function generateConfig(config: McpClientConfig): string;
+//# sourceMappingURL=config-generator.d.ts.map

package/dist/mcp/config-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-generator.d.ts","sourceRoot":"","sources":["../../src/mcp/config-generator.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,KAAK,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAmD9D"}

package/dist/mcp/config-generator.js

@@ -0,0 +1,49 @@
+export function generateConfig(config) {
+    const serverName = config.mcpServerName;
+    const mcpBin = `${config.appName}-mcp`;
+    if (config.client === "claude-code" && config.transport === "stdio") {
+        return JSON.stringify({
+            mcpServers: {
+                [serverName]: {
+                    command: mcpBin,
+                    args: [],
+                    env: {},
+                },
+            },
+        }, null, 2);
+    }
+    if (config.client === "cursor" && config.transport === "stdio") {
+        return JSON.stringify({
+            mcpServers: {
+                [serverName]: {
+                    command: mcpBin,
+                    args: [],
+                    transportType: "stdio",
+                },
+            },
+        }, null, 2);
+    }
+    // Generic or SSE
+    const port = config.port ?? 3001;
+    if (config.transport === "sse") {
+        return JSON.stringify({
+            mcpServers: {
+                [serverName]: {
+                    url: `http://localhost:${port}/sse`,
+                    transportType: "sse",
+                },
+            },
+        }, null, 2);
+    }
+    // Generic stdio
+    return JSON.stringify({
+        mcpServers: {
+            [serverName]: {
+                command: mcpBin,
+                args: [],
+                transportType: "stdio",
+            },
+        },
+    }, null, 2);
+}
+//# sourceMappingURL=config-generator.js.map

package/dist/mcp/config-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-generator.js","sourceRoot":"","sources":["../../src/mcp/config-generator.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC;IACxC,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,MAAM,CAAC;IAEvC,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,UAAU,EAAE;gBACV,CAAC,UAAU,CAAC,EAAE;oBACZ,OAAO,EAAE,MAAM;oBACf,IAAI,EAAE,EAAE;oBACR,GAAG,EAAE,EAAE;iBACR;aACF;SACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,UAAU,EAAE;gBACV,CAAC,UAAU,CAAC,EAAE;oBACZ,OAAO,EAAE,MAAM;oBACf,IAAI,EAAE,EAAE;oBACR,aAAa,EAAE,OAAO;iBACvB;aACF;SACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,CAAC;IAED,iBAAiB;IACjB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;IACjC,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,UAAU,EAAE;gBACV,CAAC,UAAU,CAAC,EAAE;oBACZ,GAAG,EAAE,oBAAoB,IAAI,MAAM;oBACnC,aAAa,EAAE,KAAK;iBACrB;aACF;SACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,CAAC;IAED,gBAAgB;IAChB,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,UAAU,EAAE;YACV,CAAC,UAAU,CAAC,EAAE;gBACZ,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,EAAE;gBACR,aAAa,EAAE,OAAO;aACvB;SACF;KACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACd,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Kiln MCP Server -- exposes memory, phases, and cost tools
+ * to Claude Code (or any MCP client) during an active session.
+ */
+/** MCP tool names exposed by Kiln */
+export type KilnTool = "kiln_init" | "kiln_phase_start" | "kiln_memory_save" | "kiln_memory_recall" | "kiln_memory_search" | "kiln_cost_track" | "kiln_cost_summary";
+/** MCP tool registration */
+export interface McpToolDefinition {
+    readonly name: KilnTool;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly annotations?: {
+        readonly readOnlyHint?: boolean;
+        readonly destructiveHint?: boolean;
+        readonly idempotentHint?: boolean;
+    };
+}
+/** All tools the MCP server exposes */
+export declare const KILN_TOOLS: readonly McpToolDefinition[];
+export { KilnMcpServer } from "./server.js";
+export type { McpServerInfo } from "./server.js";
+export type { TransportType, TransportConfig, TransportResult } from "./transports.js";
+export { createStdioTransport, createSSETransport } from "./transports.js";
+export { generateConfig } from "./config-generator.js";
+export type { McpClient, McpClientConfig } from "./config-generator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qCAAqC;AACrC,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,mBAAmB,CAAC;AAExB,4BAA4B;AAC5B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;QACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;KACnC,CAAC;CACH;AAED,uCAAuC;AACvC,eAAO,MAAM,UAAU,EAAE,SAAS,iBAAiB,EA0EzC,CAAC;AAEX,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,103 @@
+/**
+ * Kiln MCP Server -- exposes memory, phases, and cost tools
+ * to Claude Code (or any MCP client) during an active session.
+ */
+/** All tools the MCP server exposes */
+export const KILN_TOOLS = [
+    {
+        name: "kiln_init",
+        description: "Initialize a Kiln session. Returns the session ID and current orchestrator status.",
+        inputSchema: { type: "object", properties: {} },
+        annotations: { readOnlyHint: true },
+    },
+    {
+        name: "kiln_phase_start",
+        description: "Advance the orchestrator to the next phase. Returns the new phase name.",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "kiln_memory_save",
+        description: "Save an insight, pattern, or decision to persistent memory. The agent decides what is worth saving.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                content: { type: "string", description: "The insight or pattern to save" },
+                layer: { type: "string", enum: ["user", "agent", "project"], description: "Which memory layer to save to" },
+                tags: { type: "array", items: { type: "string" }, description: "Tags for categorization" },
+            },
+            required: ["content", "layer"],
+        },
+        annotations: { destructiveHint: false, idempotentHint: false },
+    },
+    {
+        name: "kiln_memory_recall",
+        description: "Retrieve relevant memories for the current task. Searches all 3 layers with progressive disclosure.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "What to search for" },
+                layer: { type: "string", enum: ["user", "agent", "project", "all"], description: "Which layer(s) to search" },
+                limit: { type: "number", description: "Max results to return" },
+            },
+            required: ["query"],
+        },
+        annotations: { readOnlyHint: true },
+    },
+    {
+        name: "kiln_memory_search",
+        description: "Full-text search across all memory layers. Returns matching entries ranked by relevance.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query" },
+                limit: { type: "number", description: "Max results to return" },
+            },
+            required: ["query"],
+        },
+        annotations: { readOnlyHint: true },
+    },
+    {
+        name: "kiln_cost_track",
+        description: "Record token usage for a specific agent role.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                role: { type: "string", description: "Agent role (e.g. architect, worker, optimizer)" },
+                model: { type: "string", description: "Model identifier for cost calculation" },
+                inputTokens: { type: "number" },
+                outputTokens: { type: "number" },
+                cacheReadTokens: { type: "number" },
+            },
+            required: ["role", "model", "inputTokens", "outputTokens"],
+        },
+    },
+    {
+        name: "kiln_cost_summary",
+        description: "Get the current cost breakdown by role.",
+        inputSchema: { type: "object", properties: {} },
+        annotations: { readOnlyHint: true },
+    },
+];
+export { KilnMcpServer } from "./server.js";
+export { createStdioTransport, createSSETransport } from "./transports.js";
+export { generateConfig } from "./config-generator.js";
+/**
+ * When run directly by Claude Code (via MCP config), start a stdio MCP server.
+ * This is the entry point that Claude Code spawns as a subprocess.
+ */
+if (import.meta.main) {
+    const { Orchestrator } = await import("@kilnai/core");
+    const { KilnMcpServer } = await import("./server.js");
+    const orchestrator = new Orchestrator();
+    const server = new KilnMcpServer(orchestrator);
+    console.error("[kiln-mcp] Starting stdio MCP server...");
+    try {
+        await server.start({ type: "stdio" });
+        console.error("[kiln-mcp] MCP server connected via stdio");
+    }
+    catch (err) {
+        console.error("[kiln-mcp] Failed to start MCP server:", err);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,36 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { Orchestrator, MemoryManager } from "@kilnai/core";
+import { type KilnTool } from "./index.js";
+import { type TransportConfig } from "./transports.js";
+type ToolHandler = (args: Record<string, unknown>) => CallToolResult | Promise<CallToolResult>;
+/** MCP server identity passed to the MCP protocol handshake. */
+export interface McpServerInfo {
+    readonly name: string;
+    readonly version: string;
+}
+/**
+ * MCP server exposing 7 Kiln tools via stdio or SSE transport.
+ * Bridges the MCP protocol to the Orchestrator.
+ */
+export declare class KilnMcpServer {
+    private readonly orchestrator;
+    private _mcpServer;
+    private _httpServer;
+    private readonly _handlers;
+    private readonly _memoryManager;
+    private readonly _serverInfo;
+    constructor(orchestrator: Orchestrator, memoryManager?: MemoryManager, serverInfo?: McpServerInfo);
+    /** Start listening on the configured transport. */
+    start(config?: TransportConfig): Promise<void>;
+    /** Graceful shutdown. */
+    stop(): Promise<void>;
+    /** Get a tool handler by name (for testing without stdio). */
+    getHandler(toolName: KilnTool): ToolHandler | undefined;
+    /** All registered tool names. */
+    get toolNames(): readonly KilnTool[];
+    private _createMcpServer;
+    private _registerToolsOn;
+    private _buildHandlers;
+}
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAe,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AAEzB,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAM/F,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,aAAa;IAQtB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAP/B,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;gBAGzB,YAAY,EAAE,YAAY,EAC3C,aAAa,CAAC,EAAE,aAAa,EAC7B,UAAU,CAAC,EAAE,aAAa;IAO5B,mDAAmD;IAC7C,KAAK,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBpD,yBAAyB;IACnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,8DAA8D;IAC9D,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS;IAIvD,iCAAiC;IACjC,IAAI,SAAS,IAAI,SAAS,QAAQ,EAAE,CAEnC;IAED,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,cAAc;CAsFvB"}

package/dist/mcp/server.js

@@ -0,0 +1,155 @@
+import { randomUUID } from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KILN_TOOLS } from "./index.js";
+import { createStdioTransport, createSSETransport, } from "./transports.js";
+function jsonResult(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+/**
+ * MCP server exposing 7 Kiln tools via stdio or SSE transport.
+ * Bridges the MCP protocol to the Orchestrator.
+ */
+export class KilnMcpServer {
+    orchestrator;
+    _mcpServer = null;
+    _httpServer = null;
+    _handlers;
+    _memoryManager;
+    _serverInfo;
+    constructor(orchestrator, memoryManager, serverInfo) {
+        this.orchestrator = orchestrator;
+        this._memoryManager = memoryManager ?? null;
+        this._serverInfo = serverInfo ?? { name: "kiln", version: "0.2.1" };
+        this._handlers = this._buildHandlers();
+    }
+    /** Start listening on the configured transport. */
+    async start(config) {
+        const transportType = config?.type ?? "stdio";
+        if (transportType === "sse") {
+            const result = createSSETransport(config?.port);
+            this._httpServer = result.httpServer;
+            // Each SSE client gets its own McpServer instance sharing the same handlers
+            result.attachServerFactory(() => {
+                const server = this._createMcpServer();
+                this._registerToolsOn(server);
+                return server;
+            });
+            return;
+        }
+        // stdio (default)
+        this._mcpServer = this._createMcpServer();
+        this._registerToolsOn(this._mcpServer);
+        const result = createStdioTransport();
+        await this._mcpServer.connect(result.transport);
+    }
+    /** Graceful shutdown. */
+    async stop() {
+        if (this._httpServer) {
+            await new Promise((resolve) => {
+                this._httpServer.close(() => resolve());
+            });
+            this._httpServer = null;
+        }
+        if (this._mcpServer) {
+            await this._mcpServer.close();
+            this._mcpServer = null;
+        }
+    }
+    /** Get a tool handler by name (for testing without stdio). */
+    getHandler(toolName) {
+        return this._handlers.get(toolName);
+    }
+    /** All registered tool names. */
+    get toolNames() {
+        return [...this._handlers.keys()];
+    }
+    _createMcpServer() {
+        return new McpServer({ name: this._serverInfo.name, version: this._serverInfo.version }, { capabilities: { tools: {} } });
+    }
+    _registerToolsOn(server) {
+        for (const tool of KILN_TOOLS) {
+            const handler = this._handlers.get(tool.name);
+            if (!handler)
+                continue;
+            server.registerTool(tool.name, {
+                description: tool.description,
+                annotations: tool.annotations,
+            }, async (args) => {
+                return handler(args);
+            });
+        }
+    }
+    _buildHandlers() {
+        const handlers = new Map();
+        handlers.set("kiln_init", () => jsonResult({
+            sessionId: this.orchestrator.sessionId,
+            status: this.orchestrator.status,
+        }));
+        handlers.set("kiln_phase_start", () => {
+            const result = this.orchestrator.advancePhase();
+            // advancePhase can return Phase | Promise<Phase | null> | null
+            // For sync results, return immediately
+            if (result instanceof Promise) {
+                return result.then((phase) => jsonResult({ phase, advanced: phase !== null }));
+            }
+            return jsonResult({ phase: result, advanced: result !== null });
+        });
+        handlers.set("kiln_memory_save", async (args) => {
+            if (!this._memoryManager) {
+                return jsonResult({ saved: true, id: randomUUID() });
+            }
+            const content = args["content"] ?? "";
+            const layer = args["layer"] ?? "project";
+            const tags = args["tags"] ?? [];
+            const id = await this._memoryManager.save({ content, layer, tags });
+            return jsonResult({ saved: true, id });
+        });
+        handlers.set("kiln_memory_recall", async (args) => {
+            if (!this._memoryManager) {
+                return jsonResult({ results: [] });
+            }
+            const query = args["query"] ?? "";
+            const tokenBudget = args["limit"] ?? 2000;
+            const text = await this._memoryManager.recall(query, tokenBudget);
+            return jsonResult({ results: text });
+        });
+        handlers.set("kiln_memory_search", async (args) => {
+            if (!this._memoryManager) {
+                return jsonResult({ results: [] });
+            }
+            const query = args["query"] ?? "";
+            const layer = args["layer"];
+            const limit = args["limit"];
+            const results = layer
+                ? await this._memoryManager.searchByLayer(query, layer, limit)
+                : await this._memoryManager.search(query, limit);
+            return jsonResult({
+                results: results.map((r) => ({
+                    id: r.entry.id,
+                    content: r.entry.content,
+                    layer: r.entry.layer,
+                    score: r.score,
+                    snippet: r.snippet,
+                    tags: r.entry.tags,
+                })),
+            });
+        });
+        handlers.set("kiln_cost_track", (args) => {
+            const role = args["role"];
+            const model = args["model"] ?? "unknown";
+            const inputTokens = args["inputTokens"] ?? 0;
+            const outputTokens = args["outputTokens"] ?? 0;
+            const cacheReadTokens = args["cacheReadTokens"] ?? 0;
+            this.orchestrator.recordUsage(role, model, {
+                inputTokens,
+                outputTokens,
+                cacheReadTokens,
+                cacheWriteTokens: 0,
+            });
+            return jsonResult({ recorded: true });
+        });
+        handlers.set("kiln_cost_summary", () => jsonResult(this.orchestrator.costSummary));
+        return handlers;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/transports.d.ts

@@ -0,0 +1,28 @@
+import { type Server } from "node:http";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+export type TransportType = "stdio" | "sse";
+export interface TransportConfig {
+    readonly type: TransportType;
+    readonly port?: number;
+}
+export interface StdioTransportResult {
+    readonly type: "stdio";
+    readonly transport: StdioServerTransport;
+}
+export interface SSETransportResult {
+    readonly type: "sse";
+    readonly httpServer: Server;
+    /**
+     * Attach an MCP server factory so each SSE client connection
+     * gets its own McpServer instance with tools registered.
+     *
+     * SSEServerTransport requires a live ServerResponse at construction,
+     * so transports are created per-connection, not upfront.
+     */
+    readonly attachServerFactory: (factory: () => McpServer) => void;
+}
+export type TransportResult = StdioTransportResult | SSETransportResult;
+export declare function createStdioTransport(): StdioTransportResult;
+export declare function createSSETransport(port?: number): SSETransportResult;
+//# sourceMappingURL=transports.d.ts.map

package/dist/mcp/transports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports.d.ts","sourceRoot":"","sources":["../../src/mcp/transports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,SAAS,KAAK,IAAI,CAAC;CAClE;AAED,MAAM,MAAM,eAAe,GAAG,oBAAoB,GAAG,kBAAkB,CAAC;AAExE,wBAAgB,oBAAoB,IAAI,oBAAoB,CAE3D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAa,GAAG,kBAAkB,CA2F1E"}