@oxagen/cli 0.5.0 → 0.6.1

package/dist/mcp/client.d.ts

@@ -0,0 +1,89 @@
+/**
+ * client.ts — Connects the CLI agent loop to external MCP servers.
+ *
+ * Servers are declared in `settings.json` under `mcpServers` (the same schema
+ * the platform agent runtime reads). For each enabled server we open a client
+ * over the configured transport, list its tools, apply the file-based tool
+ * visibility + permission rules, and wrap each surviving tool as an AI SDK tool
+ * named `mcp__<server>__<tool>` (Claude Code's convention) so it sits alongside
+ * the local coding tools in one tool set.
+ *
+ * Unlike the platform's HTTP-only contributor, this supports stdio servers too
+ * (the dominant local-MCP transport: filesystem, git, etc.).
+ *
+ * Failures are isolated per server: a server that won't connect is reported and
+ * skipped — it never breaks the turn or the other servers.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { type ToolSet } from "ai";
+import type { McpServerConfig } from "@oxagen/mcp-config/schema";
+import type { OxagenSettings } from "../settings/schema.js";
+/** The slice of the MCP SDK client the CLI uses (structural, so tests can fake it). */
+export interface McpClientLike {
+    listTools(): Promise<{
+        tools: Array<{
+            name: string;
+            description?: string | null;
+        }>;
+    }>;
+    callTool(args: {
+        name: string;
+        arguments?: Record<string, unknown>;
+    }): Promise<unknown>;
+    close(): Promise<void>;
+}
+export interface McpServerStatus {
+    name: string;
+    transport: McpServerConfig["transport"];
+    /** Tools advertised to the model after visibility + permission filtering. */
+    toolCount: number;
+    ok: boolean;
+    error?: string;
+}
+export interface LoadedMcpTools {
+    tools: ToolSet;
+    servers: McpServerStatus[];
+    /** Disconnect every server opened by this load. Always safe to call. */
+    close: () => Promise<void>;
+}
+/** The double-underscore tool name the model sees for an MCP tool. */
+export declare function mcpToolName(server: string, tool: string): string;
+/** Open a client to one MCP server. Caller owns closing it. */
+export declare function connectServer(name: string, config: McpServerConfig): Promise<Client>;
+/** The tool names a server advertises, after visibility + permission filtering. */
+export declare function filterServerTools(serverName: string, toolNames: string[], settings: OxagenSettings): string[];
+/**
+ * Wrap a connected server's allowed tools as AI SDK tools keyed
+ * `mcp__<server>__<tool>`. The MCP server re-validates arguments, so we accept
+ * an open record rather than reconstruct its JSON Schema as Zod.
+ */
+export declare function materializeServerTools(client: McpClientLike, serverName: string, settings: OxagenSettings): Promise<ToolSet>;
+export interface ServerToolReport {
+    /** Tools advertised to the model (pass visibility + permission). */
+    advertised: string[];
+    /** Tools removed by `toolVisibility` include/exclude. */
+    hidden: string[];
+    /** Tools removed by a permission deny rule. */
+    denied: string[];
+}
+/** Classify a server's advertised tool names into advertised / hidden / denied. */
+export declare function buildServerReport(serverName: string, allToolNames: string[], settings: OxagenSettings): ServerToolReport;
+export interface CheckResult {
+    name: string;
+    ok: boolean;
+    error?: string;
+    /** Total tools the server advertises (before filtering). */
+    total?: number;
+    report?: ServerToolReport;
+}
+/** Connect to one server, list its tools, and report what would be exposed. */
+export declare function checkServer(name: string, config: McpServerConfig, settings: OxagenSettings): Promise<CheckResult>;
+/**
+ * Connect every enabled MCP server in `settings`, materialize their tools, and
+ * return the merged set plus a `close()` that disconnects them all. Per-server
+ * failures are isolated and reported in `servers`.
+ */
+export declare function loadMcpTools(settings: OxagenSettings, opts?: {
+    onStatus?: (status: McpServerStatus) => void;
+}): Promise<LoadedMcpTools>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AAIxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,uBAAuB,CAAC;AAEzE,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IACtF,QAAQ,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;IACxC,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,wEAAwE;IACxE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAwDD,+DAA+D;AAC/D,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAK1F;AAwBD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,cAAc,GACvB,MAAM,EAAE,CAGV;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EAAE,EACtB,QAAQ,EAAE,cAAc,GACvB,gBAAgB,CAQlB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,+EAA+E;AAC/E,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,CAYtB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,cAAc,EACxB,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAA;CAAO,GAC1D,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/dist/mcp/client.js

@@ -0,0 +1,201 @@
+/**
+ * client.ts — Connects the CLI agent loop to external MCP servers.
+ *
+ * Servers are declared in `settings.json` under `mcpServers` (the same schema
+ * the platform agent runtime reads). For each enabled server we open a client
+ * over the configured transport, list its tools, apply the file-based tool
+ * visibility + permission rules, and wrap each surviving tool as an AI SDK tool
+ * named `mcp__<server>__<tool>` (Claude Code's convention) so it sits alongside
+ * the local coding tools in one tool set.
+ *
+ * Unlike the platform's HTTP-only contributor, this supports stdio servers too
+ * (the dominant local-MCP transport: filesystem, git, etc.).
+ *
+ * Failures are isolated per server: a server that won't connect is reported and
+ * skipped — it never breaks the turn or the other servers.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { WebSocketClientTransport } from "@modelcontextprotocol/sdk/client/websocket.js";
+import { tool } from "ai";
+import { z } from "zod";
+import { resolveCredential } from "@oxagen/mcp-config/credentials";
+import { filterToolVisibility, getNonDeniedTools } from "@oxagen/mcp-config/permissions";
+/** The double-underscore tool name the model sees for an MCP tool. */
+export function mcpToolName(server, tool) {
+    return `mcp__${server}__${tool}`;
+}
+/** Adapt the unified permissions to @oxagen/mcp-config's per-server gate shape. */
+function toMcpPermissions(p) {
+    return { ...p, defaultMcpPolicy: p?.defaultMcpPolicy ?? "ask" };
+}
+/** Resolve auth headers for an HTTP-family server (none for stdio). */
+async function resolveHeaders(name, config) {
+    if (config.transport === "stdio")
+        return {};
+    const auth = "auth" in config ? config.auth : "none";
+    if (auth === "none")
+        return {};
+    const cred = await resolveCredential({ serverName: name, config });
+    if (cred.source === "none") {
+        throw new Error(`MCP server "${name}" needs ${auth} auth but no credential was found ` +
+            `(set ${"envToken" in config && config.envToken ? config.envToken : "the token env var"} ` +
+            `or run \`oxagen mcp check ${name}\`).`);
+    }
+    if (cred.expired && !cred.hasRefreshToken) {
+        throw new Error(`MCP server "${name}" credential is expired — re-authenticate.`);
+    }
+    const headers = {};
+    if (cred.token)
+        headers["authorization"] = `Bearer ${cred.token}`;
+    else if (cred.headers)
+        Object.assign(headers, cred.headers);
+    return headers;
+}
+async function buildTransport(name, config) {
+    if (config.transport === "stdio") {
+        return new StdioClientTransport({
+            command: config.command,
+            args: config.args,
+            env: config.env,
+            cwd: config.cwd,
+        });
+    }
+    const url = new URL(config.url);
+    const headers = await resolveHeaders(name, config);
+    switch (config.transport) {
+        case "streamable-http":
+            return new StreamableHTTPClientTransport(url, { requestInit: { headers } });
+        case "sse":
+            return new SSEClientTransport(url, { requestInit: { headers } });
+        case "websocket":
+            // The WS transport carries no request headers; bearer/header auth over WS
+            // is not expressible, so we connect unauthenticated.
+            return new WebSocketClientTransport(url);
+    }
+}
+/** Open a client to one MCP server. Caller owns closing it. */
+export async function connectServer(name, config) {
+    const transport = await buildTransport(name, config);
+    const client = new Client({ name: "oxagen-cli", version: "0.1.0" }, { capabilities: {} });
+    await client.connect(transport);
+    return client;
+}
+/** MCP content → a string the model can read. */
+function formatResult(result) {
+    if (result === null || typeof result !== "object")
+        return String(result ?? "");
+    const obj = result;
+    const content = obj.content;
+    let text;
+    if (Array.isArray(content)) {
+        const parts = content
+            .map((c) => {
+            if (c && typeof c === "object" && "text" in c && typeof c.text === "string") {
+                return c.text;
+            }
+            return JSON.stringify(c);
+        })
+            .filter(Boolean);
+        text = parts.join("\n") || JSON.stringify(content);
+    }
+    else {
+        text = JSON.stringify(obj);
+    }
+    return obj.isError ? `MCP tool error: ${text}` : text;
+}
+/** The tool names a server advertises, after visibility + permission filtering. */
+export function filterServerTools(serverName, toolNames, settings) {
+    const visible = filterToolVisibility(toolNames, settings.toolVisibility?.[serverName]);
+    return getNonDeniedTools(serverName, visible, toMcpPermissions(settings.permissions));
+}
+/**
+ * Wrap a connected server's allowed tools as AI SDK tools keyed
+ * `mcp__<server>__<tool>`. The MCP server re-validates arguments, so we accept
+ * an open record rather than reconstruct its JSON Schema as Zod.
+ */
+export async function materializeServerTools(client, serverName, settings) {
+    const { tools } = await client.listTools();
+    const allowed = new Set(filterServerTools(serverName, tools.map((t) => t.name), settings));
+    const out = {};
+    for (const t of tools) {
+        if (!allowed.has(t.name))
+            continue;
+        out[mcpToolName(serverName, t.name)] = tool({
+            description: t.description ?? `External MCP tool ${t.name} (server: ${serverName})`,
+            inputSchema: z.record(z.string(), z.unknown()),
+            execute: async (input) => {
+                const res = await client.callTool({
+                    name: t.name,
+                    arguments: (input ?? {}),
+                });
+                return formatResult(res);
+            },
+        });
+    }
+    return out;
+}
+/** Classify a server's advertised tool names into advertised / hidden / denied. */
+export function buildServerReport(serverName, allToolNames, settings) {
+    const visible = filterToolVisibility(allToolNames, settings.toolVisibility?.[serverName]);
+    const visibleSet = new Set(visible);
+    const hidden = allToolNames.filter((t) => !visibleSet.has(t));
+    const advertised = getNonDeniedTools(serverName, visible, toMcpPermissions(settings.permissions));
+    const advertisedSet = new Set(advertised);
+    const denied = visible.filter((t) => !advertisedSet.has(t));
+    return { advertised, hidden, denied };
+}
+/** Connect to one server, list its tools, and report what would be exposed. */
+export async function checkServer(name, config, settings) {
+    let client;
+    try {
+        client = await connectServer(name, config);
+        const { tools } = await client.listTools();
+        const names = tools.map((t) => t.name);
+        return { name, ok: true, total: names.length, report: buildServerReport(name, names, settings) };
+    }
+    catch (err) {
+        return { name, ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+    finally {
+        await client?.close();
+    }
+}
+/**
+ * Connect every enabled MCP server in `settings`, materialize their tools, and
+ * return the merged set plus a `close()` that disconnects them all. Per-server
+ * failures are isolated and reported in `servers`.
+ */
+export async function loadMcpTools(settings, opts = {}) {
+    const servers = [];
+    const clients = [];
+    const tools = {};
+    for (const [name, config] of Object.entries(settings.mcpServers ?? {})) {
+        if ("disabled" in config && config.disabled)
+            continue;
+        const status = { name, transport: config.transport, toolCount: 0, ok: false };
+        try {
+            const client = await connectServer(name, config);
+            clients.push(client);
+            const serverTools = await materializeServerTools(client, name, settings);
+            Object.assign(tools, serverTools);
+            status.ok = true;
+            status.toolCount = Object.keys(serverTools).length;
+        }
+        catch (err) {
+            status.error = err instanceof Error ? err.message : String(err);
+        }
+        servers.push(status);
+        opts.onStatus?.(status);
+    }
+    return {
+        tools,
+        servers,
+        close: async () => {
+            await Promise.allSettled(clients.map((c) => c.close()));
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/mcp/client.js.map

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

package/dist/repl/__tests__/_queue_demo.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=_queue_demo.test.d.ts.map

package/dist/repl/__tests__/_queue_demo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_queue_demo.test.d.ts","sourceRoot":"","sources":["../../../src/repl/__tests__/_queue_demo.test.tsx"],"names":[],"mappings":""}

package/dist/repl/__tests__/_queue_demo.test.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/* TEMP demo — prints the live REPL frame while prompts are queued. Deleted after capture. */
+import { it, vi } from "vitest";
+import { render } from "ink-testing-library";
+const pending = [];
+vi.mock("../../agent/loop.js", () => ({
+    runAgent: (opts) => new Promise((resolve) => {
+        pending.push({
+            finish: () => resolve({ text: `done:${opts.prompt}`, steps: 1, messages: [], usage: {} }),
+        });
+    }),
+    MissingGatewayKeyError: class extends Error {
+    },
+}));
+vi.mock("../../agent/memory.js", () => ({
+    openSessionMemory: async () => ({
+        remember: async () => { },
+        recallContext: async () => "",
+        close: async () => { },
+    }),
+}));
+vi.mock("../../agent/project-context.js", () => ({
+    loadProjectContext: () => ({ text: "", sources: [] }),
+}));
+vi.mock("../../agent/model.js", () => ({ resolveModelId: () => "test/model" }));
+const { ReplApp } = await import("../interactive.js");
+const tick = (ms = 20) => new Promise((r) => setTimeout(r, ms));
+it("captures the queued frame", async () => {
+    const { stdin, lastFrame } = render(_jsx(ReplApp, { options: {} }));
+    await tick();
+    for (const t of ["refactor the auth module", "add tests for billing", "update the docs"]) {
+        stdin.write(t);
+        await tick();
+        stdin.write("\r");
+        await tick();
+    }
+    // eslint-disable-next-line no-console
+    console.log("\n========= LIVE REPL FRAME (turn 1 running, 2 queued) =========\n" + lastFrame() + "\n=============================================================\n");
+});
+//# sourceMappingURL=_queue_demo.test.js.map

package/dist/repl/__tests__/_queue_demo.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_queue_demo.test.js","sourceRoot":"","sources":["../../../src/repl/__tests__/_queue_demo.test.tsx"],"names":[],"mappings":";AAAA,6FAA6F;AAC7F,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,OAAO,GAAkC,EAAE,CAAC;AAClD,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,IAAwB,EAAE,EAAE,CACrC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACtB,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,GAAG,EAAE,CACX,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC,CAAC;IACJ,sBAAsB,EAAE,KAAM,SAAQ,KAAK;KAAG;CAC/C,CAAC,CAAC,CAAC;AACJ,EAAE,CAAC,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,CAAC;IACtC,iBAAiB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9B,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACxB,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAC7B,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACtB,CAAC;CACH,CAAC,CAAC,CAAC;AACJ,EAAE,CAAC,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/C,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;CACtD,CAAC,CAAC,CAAC;AACJ,EAAE,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AAEhF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;AACtD,MAAM,IAAI,GAAG,CAAC,EAAE,GAAG,EAAE,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAE/E,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;IACzC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,KAAC,OAAO,IAAC,OAAO,EAAE,EAAE,GAAI,CAAC,CAAC;IAC9D,MAAM,IAAI,EAAE,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,uBAAuB,EAAE,iBAAiB,CAAC,EAAE,CAAC;QACzF,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACf,MAAM,IAAI,EAAE,CAAC;QACb,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;IACD,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,oEAAoE,GAAG,SAAS,EAAE,GAAG,mEAAmE,CAAC,CAAC;AACxK,CAAC,CAAC,CAAC"}

package/dist/repl/__tests__/components.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=components.test.d.ts.map

package/dist/repl/__tests__/components.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.test.d.ts","sourceRoot":"","sources":["../../../src/repl/__tests__/components.test.tsx"],"names":[],"mappings":""}

package/dist/repl/__tests__/components.test.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, it, expect } from "vitest";
+import { render } from "ink-testing-library";
+import React from "react";
+import { ApprovalPrompt, humanizeTokens, modeLabel, StatusLine, ThinkingIndicator, } from "../components.js";
+const sampleReq = {
+    tool: "bash",
+    command: "rm -rf build",
+    cwd: "/x",
+    summary: "Run: rm -rf build",
+    reason: "command matches a dangerous pattern",
+};
+/** Ink delivers stdin to useInput on a microtask; let it settle before asserting. */
+const tick = () => new Promise((r) => setTimeout(r, 10));
+describe("humanizeTokens", () => {
+    it("formats token counts compactly", () => {
+        expect(humanizeTokens(0)).toBe("0");
+        expect(humanizeTokens(980)).toBe("980");
+        expect(humanizeTokens(1234)).toBe("1.2k");
+        expect(humanizeTokens(23000)).toBe("23k");
+    });
+});
+describe("StatusLine (token counter)", () => {
+    it("renders the session token counter and model", () => {
+        const { lastFrame } = render(_jsx(StatusLine, { model: "anthropic/claude-sonnet-4.5", readOnly: false, turns: 2, inputTokens: 1234, outputTokens: 5678 }));
+        const frame = lastFrame() ?? "";
+        expect(frame).toContain("tokens:");
+        expect(frame).toContain("1.2k"); // input ↑
+        expect(frame).toContain("5.7k"); // output ↓
+        expect(frame).toContain("claude-sonnet-4.5");
+    });
+    it("shows a read-only badge when enabled", () => {
+        const { lastFrame } = render(_jsx(StatusLine, { model: "x/y", readOnly: true, turns: 0, inputTokens: 0, outputTokens: 0 }));
+        expect(lastFrame() ?? "").toContain("read-only");
+    });
+});
+describe("StatusLine (permission mode)", () => {
+    it("shows the mode chip when a mode is provided", () => {
+        const { lastFrame } = render(_jsx(StatusLine, { model: "x/y", readOnly: false, turns: 0, inputTokens: 0, outputTokens: 0, mode: "acceptEdits" }));
+        const frame = lastFrame() ?? "";
+        expect(frame).toContain("mode:");
+        expect(frame).toContain("auto-edit");
+    });
+});
+describe("modeLabel", () => {
+    it("maps modes to friendly labels", () => {
+        expect(modeLabel("acceptEdits")).toBe("auto-edit");
+        expect(modeLabel("readonly")).toBe("read-only");
+        expect(modeLabel("ask")).toBe("ask");
+        expect(modeLabel("bypass")).toBe("bypass");
+    });
+});
+describe("ApprovalPrompt", () => {
+    it("renders the call summary and the reason it is asking", () => {
+        const { lastFrame, unmount } = render(_jsx(ApprovalPrompt, { req: sampleReq, onResolve: () => { } }));
+        const frame = lastFrame() ?? "";
+        expect(frame).toContain("Run: rm -rf build");
+        expect(frame).toContain("dangerous");
+        expect(frame).toContain("allow once");
+        unmount();
+    });
+    it("resolves allow on 'y', allow+remember on 'a', deny on 'n'", async () => {
+        for (const [key, expected] of [
+            ["y", { decision: "allow" }],
+            ["a", { decision: "allow", remember: true }],
+            ["n", { decision: "deny" }],
+        ]) {
+            const calls = [];
+            const { stdin, unmount } = render(_jsx(ApprovalPrompt, { req: sampleReq, onResolve: (r) => calls.push(r) }));
+            stdin.write(key);
+            await tick();
+            expect(calls).toEqual([expected]);
+            unmount();
+        }
+    });
+});
+describe("ThinkingIndicator", () => {
+    it("shows the thinking label, elapsed seconds, and live token estimate", () => {
+        const { lastFrame, unmount } = render(_jsx(ThinkingIndicator, { startedAt: Date.now() - 3000, getTokens: () => 800 }));
+        const frame = lastFrame() ?? "";
+        expect(frame).toContain("Thinking…");
+        expect(frame).toMatch(/\d+s/);
+        expect(frame).toContain("800 tok");
+        unmount();
+    });
+});
+//# sourceMappingURL=components.test.js.map

package/dist/repl/__tests__/components.test.js.map

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

package/dist/repl/__tests__/interactive.queue.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interactive.queue.test.d.ts.map

package/dist/repl/__tests__/interactive.queue.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.queue.test.d.ts","sourceRoot":"","sources":["../../../src/repl/__tests__/interactive.queue.test.tsx"],"names":[],"mappings":""}

package/dist/repl/__tests__/interactive.queue.test.js

@@ -0,0 +1,124 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Proof of the Claude Code-style prompt queue in the interactive REPL.
+ *
+ * The turn pipeline (`runTurn`) is replaced with a controllable mock so each turn
+ * stays "in flight" until the test resolves it. We drive the real <ReplApp/>
+ * through ink-testing-library's stdin and assert that prompts submitted while a
+ * turn is running are (a) visibly queued, (b) not started early, and (c) run in
+ * FIFO order as each prior turn completes.
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { render } from "ink-testing-library";
+// Each runTurn call parks here until the test resolves it, simulating a turn
+// that takes real wall-clock time (so later submissions have to queue). The REPL
+// runs every prompt through the pipeline's `runTurn` (eval → enhance → agent →
+// judge), so that is the seam we control — not the lower-level agent loop.
+const pending = [];
+const runTurnSpy = vi.fn();
+vi.mock("../../agent/pipeline.js", () => ({
+    runTurn: (opts) => new Promise((resolve) => {
+        runTurnSpy(opts);
+        pending.push({
+            prompt: opts.prompt,
+            finish: () => resolve({
+                text: `done:${opts.prompt}`,
+                messages: [],
+                usage: {},
+                trace: {},
+            }),
+        });
+    }),
+    MissingGatewayKeyError: class extends Error {
+    },
+}));
+// The REPL records each completed turn's trace; stub the durable store so the
+// test neither writes to ~/.config nor couples to the TurnTrace shape.
+vi.mock("../../agent/trace-store.js", () => ({
+    openTraceStore: () => ({
+        record: () => { },
+        get: () => undefined,
+        list: () => [],
+        last: () => undefined,
+        resolve: () => undefined,
+    }),
+}));
+vi.mock("../../agent/memory.js", () => ({
+    openSessionMemory: async () => ({
+        remember: async () => { },
+        recallContext: async () => "",
+        close: async () => { },
+    }),
+}));
+vi.mock("../../agent/project-context.js", () => ({
+    loadProjectContext: () => ({ text: "", sources: [] }),
+}));
+vi.mock("../../agent/model.js", () => ({
+    resolveModelId: (override) => override ?? "test/model",
+}));
+const { ReplApp } = await import("../interactive.js");
+const tick = (ms = 15) => new Promise((resolve) => setTimeout(resolve, ms));
+async function waitFor(cond, ms = 1500) {
+    const start = Date.now();
+    while (!cond()) {
+        if (Date.now() - start > ms)
+            throw new Error("waitFor: condition timed out");
+        await tick(5);
+    }
+}
+/** Type `text` then press Enter into the REPL's stdin. */
+async function submit(stdin, text) {
+    stdin.write(text);
+    await tick();
+    stdin.write("\r");
+    await tick();
+}
+describe("REPL prompt queue (Claude Code-style)", () => {
+    beforeEach(() => {
+        pending.length = 0;
+        runTurnSpy.mockClear();
+    });
+    it("queues prompts submitted mid-turn and runs them FIFO", async () => {
+        const { stdin, lastFrame } = render(_jsx(ReplApp, { options: {} }));
+        await tick();
+        // 1) First prompt starts a turn; runTurn is invoked and parks (in flight).
+        await submit(stdin, "first task");
+        await waitFor(() => runTurnSpy.mock.calls.length === 1);
+        expect(runTurnSpy.mock.calls[0]?.[0].prompt).toBe("first task");
+        // 2) Submit two more WHILE the first turn is still running.
+        await submit(stdin, "second task");
+        await submit(stdin, "third task");
+        // They must NOT have started — only the first turn is running.
+        expect(runTurnSpy).toHaveBeenCalledTimes(1);
+        // And they must be visibly queued in the UI.
+        const queuedFrame = lastFrame() ?? "";
+        expect(queuedFrame).toContain("queued");
+        expect(queuedFrame).toContain("second task");
+        expect(queuedFrame).toContain("third task");
+        // 3) Finish the first turn → the next queued prompt auto-runs.
+        pending[0]?.finish();
+        await waitFor(() => runTurnSpy.mock.calls.length === 2);
+        expect(runTurnSpy.mock.calls[1]?.[0].prompt).toBe("second task");
+        // 4) Finish the second → the third runs, preserving order.
+        pending[1]?.finish();
+        await waitFor(() => runTurnSpy.mock.calls.length === 3);
+        expect(runTurnSpy.mock.calls[2]?.[0].prompt).toBe("third task");
+        // 5) Finish the third → queue fully drained, nothing else runs.
+        pending[2]?.finish();
+        await tick(30);
+        expect(runTurnSpy).toHaveBeenCalledTimes(3);
+        expect(lastFrame() ?? "").not.toContain("queued");
+    });
+    it("runs a prompt immediately when idle (no queue wait)", async () => {
+        const { stdin } = render(_jsx(ReplApp, { options: {} }));
+        await tick();
+        await submit(stdin, "solo task");
+        await waitFor(() => runTurnSpy.mock.calls.length === 1);
+        expect(runTurnSpy.mock.calls[0]?.[0].prompt).toBe("solo task");
+        // Nothing queued behind it.
+        pending[0]?.finish();
+        await tick(30);
+        expect(runTurnSpy).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=interactive.queue.test.js.map

package/dist/repl/__tests__/interactive.queue.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.queue.test.js","sourceRoot":"","sources":["../../../src/repl/__tests__/interactive.queue.test.tsx"],"names":[],"mappings":"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"}