krexel 0.1.0

package/dist/mcp-client.d.ts

@@ -0,0 +1,168 @@
+/**
+ * mcp-client.ts — stdio JSON-RPC client for the Krexel MCP server.
+ *
+ * Why hand-rolled and not @modelcontextprotocol/sdk?
+ *   - The CLI is thin: it only needs `initialize` + `tools/call`.
+ *   - Hand-rolling makes the binary-not-found error deterministic and lets us
+ *     pin the exact failure message the brief calls for.
+ *   - Avoids dragging a second copy of the SDK into the CLI's bundle.
+ *
+ * Wire format (Model Context Protocol):
+ *   <Content-Length: N>\r\n\r\n<N bytes of JSON>
+ *
+ * Lifecycle:
+ *   start()  → resolves once the MCP server has replied to `initialize`.
+ *   callTool(name, args) → returns the parsed `result.content[0].text` JSON.
+ *   stop()   → closes the child process; idempotent.
+ *
+ * Resolving the MCP server binary (in order):
+ *   1. $KREXEL_MCP_BIN — full command, e.g. `node /abs/path/to/mcp-server/dist/index.js`
+ *   2. `krexel-mcp` on $PATH (preferred for installed users)
+ *   3. Sibling `../mcp-server/dist/index.js` (monorepo dev fallback)
+ *   If none of those exist, throw the install hint — never fake success.
+ */
+import { z } from "zod";
+import { nanoid } from "nanoid";
+declare const JsonRpcRequestSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    method: string;
+    jsonrpc: "2.0";
+    id: string | number;
+    params?: unknown;
+}, {
+    method: string;
+    jsonrpc: "2.0";
+    id: string | number;
+    params?: unknown;
+}>;
+export type JsonRpcRequest = z.infer<typeof JsonRpcRequestSchema>;
+declare const JsonRpcResponseSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        code: number;
+        message: string;
+        data?: unknown;
+    }, {
+        code: number;
+        message: string;
+        data?: unknown;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    } | undefined;
+}, {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    } | undefined;
+}>;
+type JsonRpcResponse = z.infer<typeof JsonRpcResponseSchema>;
+/** Shape returned by the MCP server's CallToolResult — see mcp-server/src/index.ts. */
+declare const CallToolResultSchema: z.ZodObject<{
+    content: z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        type: "text";
+    }, {
+        text: string;
+        type: "text";
+    }>, "many">;
+    isError: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    content: {
+        text: string;
+        type: "text";
+    }[];
+    isError?: boolean | undefined;
+}, {
+    content: {
+        text: string;
+        type: "text";
+    }[];
+    isError?: boolean | undefined;
+}>;
+export type CallToolResult = z.infer<typeof CallToolResultSchema>;
+export interface McpServerLocation {
+    command: string;
+    args: string[];
+    /** Path/command used to derive the location — for diagnostic messages. */
+    source: string;
+}
+/** Determine how to launch the MCP server. Throws the install hint if none found. */
+export declare function resolveMcpServer(envOverride?: NodeJS.ProcessEnv, pathOverride?: string, execPath?: string): McpServerLocation;
+/** The error called for in the brief — fired by resolveMcpServer when nothing is installed. */
+export declare class McpServerNotFoundError extends Error {
+    constructor();
+}
+/** A client is single-shot: one process, one initialize, many calls, then stop. */
+export declare class KrexelMcpClient {
+    private child;
+    private buf;
+    private pending;
+    private nextId;
+    private initDone;
+    private location;
+    /**
+     * Start the MCP server and complete the handshake.
+     * Resolves once initialize has been ack'd; throws on spawn failure.
+     */
+    start(): Promise<void>;
+    /** MCP `initialize` handshake — exchanges protocol version + capabilities. */
+    private handshake;
+    /**
+     * Call an MCP tool. The MCP server's tool implementations always return a
+     * `content` array with a single text item containing JSON-encoded payload.
+     * We parse that JSON here and return the typed object.
+     */
+    callTool<T = unknown>(name: string, args?: Record<string, unknown>): Promise<T>;
+    /** Gracefully terminate the MCP process. Idempotent. */
+    stop(): void;
+    /**
+     * Read framed MCP messages off stdout. Frame = "Content-Length: N\r\n\r\n<body>".
+     * Extra leading bytes (mcp server's debug noise on broken setups, etc.) are
+     * skipped; we don't expect any here because the server uses stderr for logs.
+     */
+    private onStdout;
+    private handleFrame;
+    private send;
+    /**
+     * Build a Content-Length framed JSON-RPC request and write it to the
+     * child's stdin. Public-and-testable so the wire shape can be unit-tested
+     * without spawning the real MCP server.
+     *
+     * Exposed for tests — not part of the public API callers should depend on.
+     */
+    writeFrame(request: JsonRpcRequest, idStr: string): Promise<JsonRpcResponse>;
+    /**
+     * Fire-and-forget notification (no id, no response). Used for
+     * `notifications/initialized` per the MCP spec.
+     */
+    private notify;
+    private failAllPending;
+    /** Diagnostic: which binary is in use. Useful for `krexel whoami` and tests. */
+    describeServer(): string;
+}
+export declare function getClient(): KrexelMcpClient;
+export { nanoid };

package/dist/mcp-client.js

@@ -0,0 +1,379 @@
+/**
+ * mcp-client.ts — stdio JSON-RPC client for the Krexel MCP server.
+ *
+ * Why hand-rolled and not @modelcontextprotocol/sdk?
+ *   - The CLI is thin: it only needs `initialize` + `tools/call`.
+ *   - Hand-rolling makes the binary-not-found error deterministic and lets us
+ *     pin the exact failure message the brief calls for.
+ *   - Avoids dragging a second copy of the SDK into the CLI's bundle.
+ *
+ * Wire format (Model Context Protocol):
+ *   <Content-Length: N>\r\n\r\n<N bytes of JSON>
+ *
+ * Lifecycle:
+ *   start()  → resolves once the MCP server has replied to `initialize`.
+ *   callTool(name, args) → returns the parsed `result.content[0].text` JSON.
+ *   stop()   → closes the child process; idempotent.
+ *
+ * Resolving the MCP server binary (in order):
+ *   1. $KREXEL_MCP_BIN — full command, e.g. `node /abs/path/to/mcp-server/dist/index.js`
+ *   2. `krexel-mcp` on $PATH (preferred for installed users)
+ *   3. Sibling `../mcp-server/dist/index.js` (monorepo dev fallback)
+ *   If none of those exist, throw the install hint — never fake success.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+import { nanoid } from "nanoid";
+import { printError } from "./output.js";
+// ---------------------------------------------------------------------------
+// JSON-RPC types — minimal, just enough to talk MCP initialize + tools/call.
+// ---------------------------------------------------------------------------
+const JsonRpcRequestSchema = z.object({
+    jsonrpc: z.literal("2.0"),
+    id: z.union([z.string(), z.number()]),
+    method: z.string(),
+    params: z.unknown().optional(),
+});
+const JsonRpcResponseSchema = z.object({
+    jsonrpc: z.literal("2.0"),
+    id: z.union([z.string(), z.number()]),
+    result: z.unknown().optional(),
+    error: z
+        .object({
+        code: z.number(),
+        message: z.string(),
+        data: z.unknown().optional(),
+    })
+        .optional(),
+});
+/** Shape returned by the MCP server's CallToolResult — see mcp-server/src/index.ts. */
+const CallToolResultSchema = z.object({
+    content: z.array(z.object({
+        type: z.literal("text"),
+        text: z.string(),
+    })),
+    isError: z.boolean().optional(),
+});
+// ---------------------------------------------------------------------------
+// Locate the MCP server binary.
+// ---------------------------------------------------------------------------
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+// From dist/mcp-client.js we look up to ../mcp-server/dist/index.js (built
+// output). From src/mcp-client.js we look up to ../mcp-server/dist/index.js too
+// — but `dist` may not exist in dev. We tolerate that and bail loudly.
+const DEFAULT_SIBLING_BIN = path.resolve(HERE, "../../mcp-server/dist/index.js");
+/** Test seam — override the location of the monorepo-sibling built binary. */
+function siblingBin() {
+    return process.env.KREXEL_MCP_SIBLING ?? DEFAULT_SIBLING_BIN;
+}
+function lookupSiblingBin() {
+    const candidate = siblingBin();
+    if (!existsSync(candidate))
+        return null;
+    return {
+        command: process.execPath,
+        args: [candidate],
+        source: candidate,
+    };
+}
+function lookupOnPath(name) {
+    const pathEnv = process.env.PATH ?? "";
+    const sep = process.platform === "win32" ? ";" : ":";
+    for (const dir of pathEnv.split(sep)) {
+        if (!dir)
+            continue;
+        const candidate = path.join(dir, name);
+        if (existsSync(candidate)) {
+            return { command: candidate, args: [], source: candidate };
+        }
+    }
+    return null;
+}
+/** Determine how to launch the MCP server. Throws the install hint if none found. */
+export function resolveMcpServer(envOverride = process.env, pathOverride = process.env.PATH ?? "", execPath = process.execPath) {
+    // 1. Caller-supplied full command — full freedom, used by tests + advanced setups.
+    if (envOverride.KREXEL_MCP_BIN) {
+        const parts = envOverride.KREXEL_MCP_BIN.split(/\s+/).filter(Boolean);
+        const cmd = parts[0];
+        if (!cmd)
+            throwMcpNotFound();
+        return {
+            command: cmd,
+            args: parts.slice(1),
+            source: "$KREXEL_MCP_BIN",
+        };
+    }
+    // 2. Same process node + sibling built binary (works in dev + when `npm link`ed).
+    if (execPath && existsSync(siblingBin())) {
+        return {
+            command: execPath,
+            args: [siblingBin()],
+            source: siblingBin(),
+        };
+    }
+    // 3. `krexel-mcp` on PATH (post `npm i -g krexel-mcp`).
+    // We override PATH lookups with the test path if provided.
+    const savedPath = process.env.PATH;
+    try {
+        process.env.PATH = pathOverride || savedPath || "";
+        const found = lookupOnPath("krexel-mcp");
+        if (found)
+            return { ...found, source: "krexel-mcp (PATH)" };
+    }
+    finally {
+        process.env.PATH = savedPath;
+    }
+    throwMcpNotFound();
+}
+/** The error called for in the brief — fired by resolveMcpServer when nothing is installed. */
+export class McpServerNotFoundError extends Error {
+    constructor() {
+        super("Install the Krexel MCP server first: `npm i -g krexel-mcp`. " +
+            "Or build the monorepo sibling: `cd ~/krexel/mcp-server && npm run build`.");
+        this.name = "McpServerNotFoundError";
+    }
+}
+function throwMcpNotFound() {
+    throw new McpServerNotFoundError();
+}
+/** A client is single-shot: one process, one initialize, many calls, then stop. */
+export class KrexelMcpClient {
+    child = null;
+    buf = Buffer.alloc(0);
+    pending = new Map();
+    nextId = 1;
+    initDone = null;
+    location = null;
+    /**
+     * Start the MCP server and complete the handshake.
+     * Resolves once initialize has been ack'd; throws on spawn failure.
+     */
+    start() {
+        if (this.initDone)
+            return this.initDone;
+        this.location = resolveMcpServer();
+        this.child = spawn(this.location.command, this.location.args, {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: process.env,
+        });
+        // Any spawn error (ENOENT, EACCES) lands here — the briefest possible message.
+        this.child.on("error", (err) => {
+            this.failAllPending(err);
+        });
+        // Surface server-side stderr for diagnostics — the MCP server uses stderr
+        // for its "[krexel-mcp] ready" line.
+        const child = this.child;
+        if (child.stderr) {
+            child.stderr.on("data", (chunk) => {
+                const s = chunk.toString("utf8").trimEnd();
+                if (s)
+                    process.stderr.write(`[mcp] ${s}\n`);
+            });
+        }
+        if (!child.stdout) {
+            throw new Error("MCP server stdout is not a pipe — cannot continue");
+        }
+        child.stdout.on("data", (chunk) => this.onStdout(chunk));
+        child.on("exit", (code) => {
+            // Drain any pending requests so callers see a clean failure rather than
+            // a hang. We only fail-not-reject if startup completed; if the server
+            // died during handshake, callers were already going to see spawn errors.
+            if (this.initDone)
+                this.failAllPending(new Error(`MCP server exited (code ${code ?? "?"})`));
+        });
+        this.initDone = this.handshake();
+        return this.initDone;
+    }
+    /** MCP `initialize` handshake — exchanges protocol version + capabilities. */
+    async handshake() {
+        const res = await this.send("initialize", {
+            protocolVersion: "2024-11-05",
+            capabilities: {},
+            clientInfo: { name: "krexel-cli", version: "0.1.0" },
+        });
+        if (res.error)
+            throw new Error(`MCP initialize failed: ${res.error.message}`);
+        // Per spec, send `notifications/initialized` to tell the server we're ready.
+        this.notify("notifications/initialized", {});
+    }
+    /**
+     * Call an MCP tool. The MCP server's tool implementations always return a
+     * `content` array with a single text item containing JSON-encoded payload.
+     * We parse that JSON here and return the typed object.
+     */
+    async callTool(name, args = {}) {
+        if (!this.initDone)
+            await this.start();
+        if (!this.child || !this.child.stdout)
+            throw new Error("MCP client not started");
+        const res = await this.send("tools/call", {
+            name,
+            arguments: args,
+        });
+        if (res.error) {
+            throw new Error(`MCP tool ${name} failed: ${res.error.message}`);
+        }
+        const parsed = CallToolResultSchema.parse(res.result);
+        if (parsed.isError) {
+            const text = parsed.content[0]?.text ?? "(no error message)";
+            throw new Error(`MCP tool ${name} returned error: ${text}`);
+        }
+        const text = parsed.content[0]?.text ?? "{}";
+        try {
+            return JSON.parse(text);
+        }
+        catch (err) {
+            throw new Error(`MCP tool ${name} returned non-JSON: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** Gracefully terminate the MCP process. Idempotent. */
+    stop() {
+        if (!this.child)
+            return;
+        if (this.child.exitCode === null) {
+            try {
+                this.child.kill();
+            }
+            catch {
+                // already dead — fine
+            }
+        }
+        this.child = null;
+        this.initDone = null;
+        this.pending.clear();
+    }
+    /**
+     * Read framed MCP messages off stdout. Frame = "Content-Length: N\r\n\r\n<body>".
+     * Extra leading bytes (mcp server's debug noise on broken setups, etc.) are
+     * skipped; we don't expect any here because the server uses stderr for logs.
+     */
+    onStdout(chunk) {
+        this.buf = Buffer.concat([this.buf, chunk]);
+        for (;;) {
+            const headerEnd = this.buf.indexOf("\r\n\r\n");
+            if (headerEnd === -1)
+                return;
+            const header = this.buf.subarray(0, headerEnd).toString("ascii");
+            const match = /^Content-Length:\s*(\d+)/i.exec(header);
+            if (!match) {
+                // Protocol violation — drop the bad header and resync.
+                // Anything before \r\n\r\n is junk we can't interpret; shift past it.
+                this.buf = this.buf.subarray(headerEnd + 4);
+                continue;
+            }
+            const len = Number(match[1]);
+            const total = headerEnd + 4 + len;
+            if (this.buf.length < total)
+                return; // wait for more
+            const body = this.buf.subarray(headerEnd + 4, total).toString("utf8");
+            this.buf = this.buf.subarray(total);
+            this.handleFrame(body);
+        }
+    }
+    handleFrame(body) {
+        let parsed;
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch (err) {
+            // Malformed JSON from server — surface but don't crash the whole client.
+            printError(`MCP server sent malformed JSON: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        const result = JsonRpcResponseSchema.safeParse(parsed);
+        if (!result.success)
+            return; // not a response (e.g. a server-initiated request we don't expect)
+        const handler = this.pending.get(result.data.id);
+        if (!handler)
+            return;
+        this.pending.delete(result.data.id);
+        handler.resolve(result.data);
+    }
+    send(method, params) {
+        if (!this.child || !this.child.stdin) {
+            return Promise.reject(new Error("MCP client not started"));
+        }
+        const id = this.nextId++;
+        const idStr = String(id);
+        const request = JsonRpcRequestSchema.parse({
+            jsonrpc: "2.0",
+            id: idStr,
+            method,
+            params,
+        });
+        return this.writeFrame(request, idStr);
+    }
+    /**
+     * Build a Content-Length framed JSON-RPC request and write it to the
+     * child's stdin. Public-and-testable so the wire shape can be unit-tested
+     * without spawning the real MCP server.
+     *
+     * Exposed for tests — not part of the public API callers should depend on.
+     */
+    writeFrame(request, idStr) {
+        if (!this.child || !this.child.stdin) {
+            return Promise.reject(new Error("MCP client not started"));
+        }
+        const body = JSON.stringify(request);
+        const frame = `Content-Length: ${Buffer.byteLength(body, "utf8")}\r\n\r\n${body}`;
+        return new Promise((resolve, reject) => {
+            this.pending.set(idStr, { resolve, reject });
+            this.child.stdin.write(frame, "utf8", (err) => {
+                if (err) {
+                    this.pending.delete(idStr);
+                    reject(err);
+                }
+            });
+        });
+    }
+    /**
+     * Fire-and-forget notification (no id, no response). Used for
+     * `notifications/initialized` per the MCP spec.
+     */
+    notify(method, params) {
+        if (!this.child || !this.child.stdin)
+            return;
+        const body = JSON.stringify({ jsonrpc: "2.0", method, params });
+        const frame = `Content-Length: ${Buffer.byteLength(body, "utf8")}\r\n\r\n${body}`;
+        try {
+            this.child.stdin.write(frame, "utf8");
+        }
+        catch {
+            // best-effort
+        }
+    }
+    failAllPending(err) {
+        for (const [, handler] of this.pending) {
+            handler.reject(err);
+        }
+        this.pending.clear();
+    }
+    /** Diagnostic: which binary is in use. Useful for `krexel whoami` and tests. */
+    describeServer() {
+        return this.location?.source ?? "(not started)";
+    }
+}
+/** Convenience singleton + auto-stop on process exit. */
+let _client = null;
+export function getClient() {
+    if (!_client) {
+        _client = new KrexelMcpClient();
+        // Make absolutely sure the child process doesn't outlive the CLI.
+        const cleanup = () => _client?.stop();
+        process.once("exit", cleanup);
+        process.once("SIGINT", () => {
+            cleanup();
+            process.exit(130);
+        });
+        process.once("SIGTERM", () => {
+            cleanup();
+            process.exit(143);
+        });
+    }
+    return _client;
+}
+export { nanoid };
+//# sourceMappingURL=mcp-client.js.map

package/dist/mcp-client.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,44 @@
+/**
+ * output.ts — terminal formatting primitives for the Krexel CLI.
+ *
+ * All user-facing output goes through these helpers so we get one consistent
+ * visual language and so `--json` can swap text for a JSON envelope without
+ * touching every subcommand.
+ *
+ * Conventions:
+ *   - success / warn / error are bold + colored
+ *   - dim is for side-notes and context
+ *   - Spinner factory returns a spinner only when the user is expected to
+ *     wait > 500ms; short ops just print and move on.
+ */
+import chalk from "chalk";
+export declare function setJsonMode(on: boolean): void;
+export declare function isJsonMode(): boolean;
+/** Print success line. */
+export declare function success(msg: string): void;
+/** Print warning line. */
+export declare function warn(msg: string): void;
+/** Print dim/secondary line. */
+export declare function dim(msg: string): void;
+/** Print error line on stderr — exits process with code 1. */
+export declare function error(msg: string): never;
+/** Print error without exiting — useful when caller wants to recover. */
+export declare function printError(msg: string): void;
+/** Bordered key/value line for account status / deploy summary. */
+export declare function kv(key: string, value: string | number | boolean | null | undefined): void;
+/**
+ * Run an async operation with a spinner iff the operation is expected to take
+ * more than ~500ms. We can't actually measure before we start, so we always
+ * show the spinner when called — subcommands decide whether to bother.
+ *
+ * If --json is set, the spinner is skipped (noise breaks jq pipelines).
+ */
+export declare function withSpinner<T>(text: string, fn: () => Promise<T>, opts?: {
+    enabled?: boolean;
+}): Promise<T>;
+/**
+ * Monospace block if the terminal reports it can render Unicode + color.
+ * Falls back to plain text on dumb pipes (so logs still grep cleanly).
+ */
+export declare function monospace(block: string): void;
+export { chalk };