@cursor/july 0.1.1

package/dist/internal/chat-client.js

@@ -0,0 +1,327 @@
+/**
+ * `agent-serve chat` — a minimal terminal client for a served agent. It
+ * drives only the public HTTP API (create session, follow-up, NDJSON
+ * stream), so it works against any agent-serve server and demonstrates the
+ * same wire protocol the playground and curl use. Renders streamed
+ * assistant text live, tool calls inline, and a per-turn usage footer.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { createInterface } from "node:readline";
+const IDENTITY = (s) => s;
+function makePalette(enabled) {
+    if (!enabled) {
+        return {
+            dim: IDENTITY,
+            bold: IDENTITY,
+            cyan: IDENTITY,
+            green: IDENTITY,
+            red: IDENTITY,
+            magenta: IDENTITY,
+            yellow: IDENTITY,
+        };
+    }
+    const wrap = (code) => (s) => `\u001b[${code}m${s}\u001b[0m`;
+    return {
+        dim: wrap("2"),
+        bold: wrap("1"),
+        cyan: wrap("36"),
+        green: wrap("32"),
+        red: wrap("31"),
+        magenta: wrap("35"),
+        yellow: wrap("33"),
+    };
+}
+/** Run the terminal chat client. Resolves when the session/REPL ends. */
+export function runChat(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const baseUrl = options.baseUrl.replace(/\/$/, "");
+        const colorEnabled = !options.noColor && process.stdout.isTTY === true && !process.env.NO_COLOR;
+        const c = makePalette(colorEnabled);
+        const write = (s) => {
+            process.stdout.write(s);
+        };
+        const health = yield getJson(baseUrl, "/v1/health", options.bearerToken);
+        const agentName = typeof (health === null || health === void 0 ? void 0 : health.name) === "string" ? health.name : "agent-serve";
+        write(`${c.bold(agentName)} ${c.dim(`· ${baseUrl}`)}\n`);
+        const info = yield getJson(baseUrl, "/v1/info", options.bearerToken);
+        if (info && typeof info === "object") {
+            const model = info.model;
+            const tools = (_a = info.tools) !== null && _a !== void 0 ? _a : [];
+            const modelText = typeof model === "string" ? model : JSON.stringify(model !== null && model !== void 0 ? model : "");
+            write(c.dim(`model ${modelText} · ${tools.length} tool${tools.length === 1 ? "" : "s"}\n`));
+        }
+        write("\n");
+        let sessionId;
+        let continuationToken;
+        // Highest event index rendered so far; a follow-up streams from here so it
+        // shows only the new turn, not the replayed transcript.
+        let nextEventIndex = 0;
+        const runTurn = (message) => __awaiter(this, void 0, void 0, function* () {
+            write(`${c.cyan("› you")}  ${message}\n`);
+            const startIndex = sessionId === undefined ? 0 : nextEventIndex;
+            if (sessionId === undefined) {
+                const created = yield postJson(baseUrl, "/v1/session", { message }, options.bearerToken);
+                sessionId = str(created === null || created === void 0 ? void 0 : created.sessionId);
+                continuationToken = str(created === null || created === void 0 ? void 0 : created.continuationToken);
+            }
+            else {
+                const resp = yield postJson(baseUrl, `/v1/session/${sessionId}`, { message, continuationToken }, options.bearerToken);
+                if ((resp === null || resp === void 0 ? void 0 : resp.ok) === false) {
+                    write(`${c.red("error")} ${str(resp.error)}: ${str(resp.message)}\n\n`);
+                    return;
+                }
+                continuationToken = str(resp === null || resp === void 0 ? void 0 : resp.continuationToken);
+            }
+            if (sessionId === undefined) {
+                write(`${c.red("error")} server did not return a session id\n\n`);
+                return;
+            }
+            nextEventIndex = yield streamTurn({
+                baseUrl,
+                sessionId,
+                startIndex,
+                bearerToken: options.bearerToken,
+                palette: c,
+                write,
+            });
+            write("\n");
+        });
+        if (options.message !== undefined) {
+            yield runTurn(options.message);
+            return;
+        }
+        write(c.dim("Type a message and press Enter. Ctrl-D or /quit to exit.\n\n"));
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        yield new Promise((resolve) => {
+            const prompt = () => {
+                rl.setPrompt(c.cyan("› "));
+                rl.prompt();
+            };
+            prompt();
+            rl.on("line", (line) => {
+                const text = line.trim();
+                if (text === "") {
+                    prompt();
+                    return;
+                }
+                if (text === "/quit" || text === "/exit") {
+                    rl.close();
+                    return;
+                }
+                rl.pause();
+                runTurn(text)
+                    .catch((err) => {
+                    write(`${c.red("error")} ${describe(err)}\n\n`);
+                })
+                    .finally(() => {
+                    rl.resume();
+                    prompt();
+                });
+            });
+            rl.on("close", () => {
+                write(c.dim("\nbye\n"));
+                resolve();
+            });
+        });
+    });
+}
+const TERMINAL_TYPES = new Set([
+    "session.waiting",
+    "session.completed",
+    "session.failed",
+]);
+/** Streams a turn to the terminal; returns the next event index to resume at. */
+function streamTurn(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const { palette: c, write } = args;
+        const url = `${args.baseUrl}/v1/session/${args.sessionId}/stream?startIndex=${args.startIndex}`;
+        const resp = yield fetch(url, { headers: authHeaders(args.bearerToken) });
+        if (!resp.ok || resp.body === null) {
+            write(`${c.red("error")} stream failed (${resp.status})\n`);
+            return args.startIndex;
+        }
+        const reader = resp.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        let assistantOpen = false;
+        let thinkingShown = false;
+        let lastIndex = args.startIndex - 1;
+        const closeAssistant = () => {
+            if (assistantOpen) {
+                write("\n");
+                assistantOpen = false;
+            }
+        };
+        for (;;) {
+            const chunk = yield reader.read();
+            if (chunk.done) {
+                break;
+            }
+            buffer += decoder.decode(chunk.value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = (_a = lines.pop()) !== null && _a !== void 0 ? _a : "";
+            let stop = false;
+            for (const line of lines) {
+                if (line.trim() === "") {
+                    continue;
+                }
+                let event;
+                try {
+                    event = JSON.parse(line);
+                }
+                catch (_c) {
+                    continue;
+                }
+                if (typeof event.index === "number") {
+                    lastIndex = event.index;
+                }
+                if (event.type === "agent.bound") {
+                    closeAssistant();
+                    const { sdkAgentId, url } = event.data;
+                    write(`  ${c.cyan("agent")} ${c.bold(sdkAgentId)}\n`);
+                    if (url !== undefined) {
+                        write(`  ${c.dim(url)}\n`);
+                    }
+                    continue;
+                }
+                if (event.type === "reasoning.appended" && !thinkingShown) {
+                    thinkingShown = true;
+                    write(c.dim("  · thinking…\n"));
+                    continue;
+                }
+                if (event.type === "message.appended") {
+                    if (!assistantOpen) {
+                        write(`${c.green("‹ agent")}  `);
+                        assistantOpen = true;
+                    }
+                    write(event.data.delta);
+                    continue;
+                }
+                if (event.type === "message.completed") {
+                    closeAssistant();
+                    continue;
+                }
+                if (event.type === "actions.requested") {
+                    closeAssistant();
+                    for (const call of event.data.calls) {
+                        write(`  ${c.magenta("⚙")} ${c.bold(call.toolName)}${c.dim(formatArgs(call.args))}\n`);
+                    }
+                    continue;
+                }
+                if (event.type === "action.approval_requested") {
+                    closeAssistant();
+                    write(`    ${c.yellow("⏸")} ${c.bold(event.data.toolName)} ${c.dim("awaiting human approval")}\n`);
+                    continue;
+                }
+                if (event.type === "action.approval_resolved") {
+                    const mark = event.data.decision === "approve" ? c.green("✓") : c.red("✗");
+                    write(`    ${mark} ${c.bold(event.data.toolName)} ${c.dim(event.data.decision === "approve" ? "approved" : "denied")}\n`);
+                    continue;
+                }
+                if (event.type === "action.result") {
+                    const label = event.data.isError ? c.red("✗") : c.magenta("→");
+                    write(`    ${label} ${c.dim(truncate(stringify(event.data.output), 100))}\n`);
+                    continue;
+                }
+                if (event.type === "subagent.called") {
+                    closeAssistant();
+                    const detail = event.data.description
+                        ? ` — ${truncate(event.data.description, 60)}`
+                        : "";
+                    write(`  ${c.magenta("task")} ${c.bold((_b = event.data.name) !== null && _b !== void 0 ? _b : "subagent")}${c.dim(detail)}\n`);
+                    continue;
+                }
+                if (event.type === "turn.completed") {
+                    closeAssistant();
+                    const usage = event.data.usage;
+                    const tokens = usage
+                        ? ` · in ${usage.inputTokens} out ${usage.outputTokens} tok`
+                        : "";
+                    write(c.dim(`  ─ turn done${tokens}\n`));
+                    continue;
+                }
+                if (event.type === "turn.failed") {
+                    closeAssistant();
+                    write(`${c.red("  ✗ turn failed")} ${event.data.message}\n`);
+                    continue;
+                }
+                if (TERMINAL_TYPES.has(event.type)) {
+                    closeAssistant();
+                    stop = true;
+                    break;
+                }
+            }
+            if (stop) {
+                break;
+            }
+        }
+        yield reader.cancel().catch(() => { });
+        return lastIndex + 1;
+    });
+}
+// ---------------------------------------------------------------------------
+// HTTP helpers (built-in fetch; node 22+)
+// ---------------------------------------------------------------------------
+function authHeaders(bearerToken) {
+    return bearerToken === undefined
+        ? {}
+        : { authorization: `Bearer ${bearerToken}` };
+}
+function getJson(baseUrl, path, bearerToken) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const resp = yield fetch(`${baseUrl}${path}`, {
+                headers: authHeaders(bearerToken),
+            });
+            const text = yield resp.text();
+            return text ? JSON.parse(text) : undefined;
+        }
+        catch (_a) {
+            return undefined;
+        }
+    });
+}
+function postJson(baseUrl, path, body, bearerToken) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const resp = yield fetch(`${baseUrl}${path}`, {
+            method: "POST",
+            headers: Object.assign({ "content-type": "application/json" }, authHeaders(bearerToken)),
+            body: JSON.stringify(body),
+        });
+        const text = yield resp.text();
+        return text ? JSON.parse(text) : undefined;
+    });
+}
+function str(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function stringify(value) {
+    if (value === undefined || value === null) {
+        return "(no output)";
+    }
+    return typeof value === "string" ? value : JSON.stringify(value);
+}
+function formatArgs(args) {
+    if (args === undefined || args === null) {
+        return "";
+    }
+    const text = typeof args === "string" ? args : JSON.stringify(args);
+    return text === "{}" ? "" : `(${truncate(text, 80)})`;
+}
+function truncate(text, max) {
+    const oneLine = text.replace(/\s+/g, " ").trim();
+    return oneLine.length > max ? `${oneLine.slice(0, max - 1)}…` : oneLine;
+}
+function describe(err) {
+    return err instanceof Error ? err.message : String(err);
+}

package/dist/internal/cli-ax.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Agent-experience CLI commands:
+ *   init / run / trajectory / eval
+ *
+ * Coding agents get JSON-first output, ephemeral local servers, and
+ * filesystem-first evals under evals/ (*.eval.ts). Live A/B metrics
+ * (`defineAB` under `agent/ab`) plug into serve — there is no `ab` CLI.
+ */
+export interface AxCliOptions {
+    cwd?: string;
+    dir: string;
+    /** Agent slug when multiple agents are mounted. */
+    slug?: string;
+    bearerToken?: string;
+    stateRoot?: string;
+    /** One or more user turns. */
+    messages?: string[];
+    sessionId?: string;
+    continuationToken?: string;
+    timeoutMs?: number;
+    /**
+     * Write raw NDJSON session events (the visualizable trace).
+     * - `true` / omitted: auto path under `<dir>/.agent-serve/traces/`
+     * - string: explicit path
+     * - `false`: skip writing
+     */
+    events?: string | true | false;
+    text?: boolean;
+    json?: boolean;
+    list?: boolean;
+    verbose?: boolean;
+    tags?: string[];
+    /** Eval ids / path prefixes. */
+    evalIds?: string[];
+    /** Scaffold target directory for `init`. */
+    initTarget?: string;
+    /** Tool name for `call`. */
+    toolName?: string;
+    /** JSON input for `call`. */
+    toolInput?: string;
+    /** Remote agent base URL (skip local host) for run/eval. */
+    url?: string;
+    /**
+     * Stream live turn progress to stderr (default: stderr is a TTY).
+     * Final JSON/text still goes to stdout.
+     */
+    stream?: boolean;
+}
+export declare function cmdInit(options: AxCliOptions): Promise<number>;
+export declare function cmdRun(options: AxCliOptions): Promise<number>;
+/**
+ * `agent-serve call <tool>` — deterministic tool invocation over
+ * `POST /v1/tools/:toolName` (ephemeral local server unless --url).
+ */
+export declare function cmdCall(options: AxCliOptions): Promise<number>;
+export declare function cmdTrajectory(options: AxCliOptions): Promise<number>;
+export declare function cmdEval(options: AxCliOptions): Promise<number>;
+//# sourceMappingURL=cli-ax.d.ts.map

package/dist/internal/cli-ax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-ax.d.ts","sourceRoot":"","sources":["../../src/internal/cli-ax.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA+ED,wBAAsB,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BpE;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA8FnE;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDpE;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAe1E;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFpE"}