@cursor/july 0.1.1

package/dist/internal/init-project.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Scaffold a minimal agent-serve project (`agent-serve init`).
+ */
+export interface InitProjectOptions {
+    /** Directory to create (created if missing). */
+    dir: string;
+    /** Agent display name; defaults to the directory basename. */
+    name?: string;
+    /** Model id override written into agent.ts. */
+    model?: string;
+}
+export interface InitProjectResult {
+    rootDir: string;
+    files: string[];
+}
+export declare function initProject(options: InitProjectOptions): Promise<InitProjectResult>;
+/**
+ * Coding-agent setup guide printed by `agent-serve init`
+ * with no target directory (does not scaffold).
+ */
+export declare function printInitGuide(): void;
+//# sourceMappingURL=init-project.d.ts.map

package/dist/internal/init-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-project.d.ts","sourceRoot":"","sources":["../../src/internal/init-project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAUD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CA+E5B;AAuBD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAqBrC"}

package/dist/internal/init-project.js

@@ -0,0 +1,125 @@
+/**
+ * Scaffold a minimal agent-serve project (`agent-serve init`).
+ */
+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 { mkdir, writeFile } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+import { CLI_COMMAND_NAME, PACKAGE_NAME, packageVersion, } from "./distribution.js";
+const DEFAULT_MODEL = {
+    id: "grok-4.5",
+    params: [
+        { id: "effort", value: "high" },
+        { id: "fast", value: "true" },
+    ],
+};
+export function initProject(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const rootDir = resolve(options.dir);
+        const name = (_a = options.name) !== null && _a !== void 0 ? _a : basename(rootDir);
+        const model = formatModelLiteral((_b = options.model) !== null && _b !== void 0 ? _b : DEFAULT_MODEL);
+        const agentDir = join(rootDir, "agent");
+        yield mkdir(agentDir, { recursive: true });
+        const written = [];
+        const write = (rel, contents) => __awaiter(this, void 0, void 0, function* () {
+            const abs = join(rootDir, rel);
+            yield mkdir(dirname(abs), { recursive: true });
+            yield writeFile(abs, contents, { flag: "wx" });
+            written.push(rel);
+        });
+        try {
+            yield write("package.json", `${JSON.stringify({
+                name,
+                private: true,
+                type: "module",
+                description: `agent project: ${name}`,
+                dependencies: {
+                    [PACKAGE_NAME]: `^${packageVersion()}`,
+                    zod: "^3.25.0",
+                },
+            }, null, 2)}\n`);
+            yield write("agent/agent.ts", `import { defineAgent } from "${PACKAGE_NAME}";
+
+export default defineAgent({
+  model: ${model},
+});
+`);
+            yield write("agent/instructions.md", `# ${name}
+
+You are a helpful agent. Prefer tools when they fit the request.
+Keep answers concise unless the user asks for detail.
+`);
+            yield write("agent/tools/echo.ts", `import { defineTool } from "${PACKAGE_NAME}/tools";
+import { z } from "zod";
+
+export default defineTool({
+  description: "Echo a short message back (demo tool).",
+  inputSchema: z.object({ message: z.string() }),
+  async execute({ message }) {
+    return { echoed: message };
+  },
+});
+`);
+        }
+        catch (error) {
+            if (error !== null &&
+                typeof error === "object" &&
+                "code" in error &&
+                error.code === "EEXIST") {
+                throw new Error(`Refusing to overwrite existing files under ${rootDir}. Pick an empty directory or remove the conflicting files.`);
+            }
+            throw error;
+        }
+        return { rootDir, files: written };
+    });
+}
+function formatModelLiteral(model) {
+    if (typeof model === "string") {
+        return JSON.stringify(model);
+    }
+    const params = model.params === undefined
+        ? ""
+        : `,
+    params: [
+${model.params
+            .map((param) => `      { id: ${JSON.stringify(param.id)}, value: ${JSON.stringify(param.value)} },`)
+            .join("\n")}
+    ]`;
+    return `{
+    id: ${JSON.stringify(model.id)}${params},
+  }`;
+}
+/**
+ * Coding-agent setup guide printed by `agent-serve init`
+ * with no target directory (does not scaffold).
+ */
+export function printInitGuide() {
+    process.stdout.write(`${CLI_COMMAND_NAME} — coding agent setup
+
+Recommended loop:
+  1. Edit agent/ + tools under agent/tools/
+  2. ${CLI_COMMAND_NAME} info --dir . --json
+  3. ${CLI_COMMAND_NAME} run --dir . --message "..."
+  4. ${CLI_COMMAND_NAME} eval --dir .
+
+Scaffold a project:
+  ${CLI_COMMAND_NAME} init ./my-agent
+
+Evals:
+  Create evals/**/*.eval.ts using defineEval from ${PACKAGE_NAME}/evals
+  Case id is the path: evals/weather/nyc.eval.ts → weather/nyc
+  Required: evals/evals.config.ts with defineEvalConfig({ maxConcurrency })
+    (hard-capped at 200 due to model provider request limits)
+  Run: ${CLI_COMMAND_NAME} eval [--json] [evalId...]
+
+See AGENTS.md in the ${PACKAGE_NAME} package for the full loop.
+`);
+}

package/dist/internal/json-dir-store.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Small filesystem helpers for one-JSON-file-per-id persistence under a
+ * project-relative directory (eval run snapshots, A/B aggregate snapshots).
+ */
+export declare function assertNonEmptyDir(dir: string, fnName: string): string;
+/** Resolve `dir` against `projectRoot` when relative. */
+export declare function resolveProjectRelativeDir(args: {
+    dir: string;
+    projectRoot: string;
+}): string;
+/** List `*.json` basenames in `root` (any order). Missing dir → []. */
+export declare function listJsonBasenames(root: string): Promise<string[]>;
+/**
+ * Read and JSON.parse every `*.json` file under `root`. Missing dir → [].
+ * Unreadable or corrupt files are skipped so one bad snapshot cannot wipe
+ * the rest of the history.
+ */
+export declare function readJsonDir<T>(root: string, options?: {
+    sortBasenames?: "asc" | "desc";
+}): Promise<T[]>;
+/** Atomically write JSON under `root`/`fileName` (temp file + rename). */
+export declare function writeJsonFile(args: {
+    root: string;
+    fileName: string;
+    value: unknown;
+}): Promise<void>;
+/** Best-effort delete; ignores missing files. */
+export declare function deleteFileInDir(args: {
+    root: string;
+    fileName: string;
+}): Promise<void>;
+//# sourceMappingURL=json-dir-store.d.ts.map

package/dist/internal/json-dir-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-dir-store.d.ts","sourceRoot":"","sources":["../../src/internal/json-dir-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED,yDAAyD;AACzD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAET;AAWD,uEAAuE;AACvE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWvE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC,CAAC,EAAE,CAAC,CAiBd;AAED,0EAA0E;AAC1E,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB;AAED,iDAAiD;AACjD,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhB"}

package/dist/internal/json-dir-store.js

@@ -0,0 +1,100 @@
+/**
+ * Small filesystem helpers for one-JSON-file-per-id persistence under a
+ * project-relative directory (eval run snapshots, A/B aggregate snapshots).
+ */
+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 { randomBytes } from "node:crypto";
+import { mkdir, readdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
+import { isAbsolute, join } from "node:path";
+export function assertNonEmptyDir(dir, fnName) {
+    if (typeof dir !== "string" || dir.trim() === "") {
+        throw new Error(`${fnName}: dir must be a non-empty string`);
+    }
+    return dir;
+}
+/** Resolve `dir` against `projectRoot` when relative. */
+export function resolveProjectRelativeDir(args) {
+    return isAbsolute(args.dir) ? args.dir : join(args.projectRoot, args.dir);
+}
+function isEnoent(error) {
+    return (error !== null &&
+        typeof error === "object" &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+/** List `*.json` basenames in `root` (any order). Missing dir → []. */
+export function listJsonBasenames(root) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let names;
+        try {
+            names = yield readdir(root);
+        }
+        catch (error) {
+            if (isEnoent(error)) {
+                return [];
+            }
+            throw error;
+        }
+        return names.filter((name) => name.endsWith(".json"));
+    });
+}
+/**
+ * Read and JSON.parse every `*.json` file under `root`. Missing dir → [].
+ * Unreadable or corrupt files are skipped so one bad snapshot cannot wipe
+ * the rest of the history.
+ */
+export function readJsonDir(root, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let names = yield listJsonBasenames(root);
+        if ((options === null || options === void 0 ? void 0 : options.sortBasenames) === "asc") {
+            names = [...names].sort();
+        }
+        else if ((options === null || options === void 0 ? void 0 : options.sortBasenames) === "desc") {
+            names = [...names].sort().reverse();
+        }
+        const out = [];
+        for (const name of names) {
+            try {
+                const raw = yield readFile(join(root, name), "utf8");
+                out.push(JSON.parse(raw));
+            }
+            catch (_a) {
+                // skip corrupt / unreadable files
+            }
+        }
+        return out;
+    });
+}
+/** Atomically write JSON under `root`/`fileName` (temp file + rename). */
+export function writeJsonFile(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { root, fileName, value } = args;
+        // Serialize before any await so callers get a stable snapshot even if they
+        // mutate `value` afterward.
+        const body = `${JSON.stringify(value, null, 2)}\n`;
+        yield mkdir(root, { recursive: true });
+        const finalPath = join(root, fileName);
+        const tmpPath = `${finalPath}.${randomBytes(4).toString("hex")}.tmp`;
+        yield writeFile(tmpPath, body, "utf8");
+        yield rename(tmpPath, finalPath);
+    });
+}
+/** Best-effort delete; ignores missing files. */
+export function deleteFileInDir(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield rm(join(args.root, args.fileName), { force: true });
+        }
+        catch (_a) {
+            // ignore
+        }
+    });
+}

package/dist/internal/json-schema.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { JsonSchemaObject } from "../types.js";
+export declare function isZodSchema(value: unknown): value is z.ZodTypeAny;
+/** Convert an authored input schema into the JSON Schema shown to the model. */
+export declare function toolInputJsonSchema(inputSchema: z.ZodTypeAny | JsonSchemaObject | undefined): JsonSchemaObject;
+export type ToolInputValidation = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Validate tool-call args before `execute` runs. Zod schemas validate (and
+ * transform); plain JSON schemas pass through unvalidated.
+ */
+export declare function validateToolInput(inputSchema: z.ZodTypeAny | JsonSchemaObject | undefined, args: unknown): ToolInputValidation;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/internal/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/internal/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,UAAU,CAYjE;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,CAAC,CAAC,UAAU,GAAG,gBAAgB,GAAG,SAAS,GACvD,gBAAgB,CAalB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,CAAC,CAAC,UAAU,GAAG,gBAAgB,GAAG,SAAS,EACxD,IAAI,EAAE,OAAO,GACZ,mBAAmB,CAerB"}

package/dist/internal/json-schema.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+const ANY_OBJECT_SCHEMA = {
+    type: "object",
+    properties: {},
+    additionalProperties: true,
+};
+export function isZodSchema(value) {
+    if (value instanceof z.ZodType) {
+        return true;
+    }
+    // Structural check for zod instances that come from a different module
+    // copy in the authoring project's node_modules.
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.safeParse === "function" &&
+        "_def" in value);
+}
+/** Convert an authored input schema into the JSON Schema shown to the model. */
+export function toolInputJsonSchema(inputSchema) {
+    if (inputSchema === undefined) {
+        return ANY_OBJECT_SCHEMA;
+    }
+    if (isZodSchema(inputSchema)) {
+        const converted = zodToJsonSchema(inputSchema, {
+            $refStrategy: "none",
+            target: "jsonSchema7",
+        });
+        delete converted.$schema;
+        return converted;
+    }
+    return inputSchema;
+}
+/**
+ * Validate tool-call args before `execute` runs. Zod schemas validate (and
+ * transform); plain JSON schemas pass through unvalidated.
+ */
+export function validateToolInput(inputSchema, args) {
+    if (inputSchema === undefined || !isZodSchema(inputSchema)) {
+        return { ok: true, value: args };
+    }
+    const parsed = inputSchema.safeParse(args);
+    if (parsed.success) {
+        return { ok: true, value: parsed.data };
+    }
+    const issues = parsed.error.issues
+        .map((issue) => {
+        const path = issue.path.join(".");
+        return path === "" ? issue.message : `${path}: ${issue.message}`;
+    })
+        .join("; ");
+    return { ok: false, message: issues || "invalid input" };
+}

package/dist/internal/log-ring.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Bounded in-memory log buffer for the playground Logs tab.
+ *
+ * Wraps {@link ServeOptions.logger} so every channel/session line that hits
+ * the console is also retained for `GET /v1/logs`.
+ */
+export interface LogRingEntry {
+    index: number;
+    at: string;
+    line: string;
+}
+export interface LogRing {
+    /** Append a line (also called by {@link wrap}). */
+    push(line: string): void;
+    /** Snapshot entries with `index > after` (exclusive), oldest first. */
+    since(after?: number): LogRingEntry[];
+    /** Wrap a logger so each write is recorded then forwarded. */
+    wrap(inner: (line: string) => void): (line: string) => void;
+}
+export declare function createLogRing(options?: {
+    capacity?: number;
+}): LogRing;
+//# sourceMappingURL=log-ring.d.ts.map

package/dist/internal/log-ring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-ring.d.ts","sourceRoot":"","sources":["../../src/internal/log-ring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,mDAAmD;IACnD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IACtC,8DAA8D;IAC9D,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAoC1E"}

package/dist/internal/log-ring.js

@@ -0,0 +1,42 @@
+/**
+ * Bounded in-memory log buffer for the playground Logs tab.
+ *
+ * Wraps {@link ServeOptions.logger} so every channel/session line that hits
+ * the console is also retained for `GET /v1/logs`.
+ */
+export function createLogRing(options = {}) {
+    var _a;
+    const capacity = Math.max(1, (_a = options.capacity) !== null && _a !== void 0 ? _a : 1000);
+    const entries = [];
+    let nextIndex = 0;
+    function push(line) {
+        entries.push({
+            index: nextIndex,
+            at: new Date().toISOString(),
+            line,
+        });
+        nextIndex += 1;
+        while (entries.length > capacity) {
+            entries.shift();
+        }
+    }
+    return {
+        push,
+        since(after = -1) {
+            if (entries.length === 0) {
+                return [];
+            }
+            const start = entries.findIndex((e) => e.index > after);
+            if (start < 0) {
+                return [];
+            }
+            return entries.slice(start);
+        },
+        wrap(inner) {
+            return (line) => {
+                push(line);
+                inner(line);
+            };
+        },
+    };
+}

package/dist/internal/map-pool.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Run `fn` over `items` with at most `concurrency` in flight; preserve order
+ * of results (and of side-effect completion relative to index assignment).
+ */
+export declare function mapPool<T, R>(items: readonly T[], concurrency: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=map-pool.d.ts.map

package/dist/internal/map-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-pool.d.ts","sourceRoot":"","sources":["../../src/internal/map-pool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,CAAC,EAChC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAuBd"}

package/dist/internal/map-pool.js

@@ -0,0 +1,41 @@
+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());
+    });
+};
+/**
+ * Run `fn` over `items` with at most `concurrency` in flight; preserve order
+ * of results (and of side-effect completion relative to index assignment).
+ */
+export function mapPool(items, concurrency, fn) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const results = new Array(items.length);
+        let next = 0;
+        function worker() {
+            return __awaiter(this, void 0, void 0, function* () {
+                for (;;) {
+                    const index = next;
+                    next += 1;
+                    if (index >= items.length) {
+                        return;
+                    }
+                    const item = items[index];
+                    if (item === undefined) {
+                        return;
+                    }
+                    results[index] = yield fn(item, index);
+                }
+            });
+        }
+        const workerCount = Math.min(Math.max(1, concurrency), items.length);
+        if (workerCount === 0) {
+            return results;
+        }
+        yield Promise.all(Array.from({ length: workerCount }, () => worker()));
+        return results;
+    });
+}

package/dist/internal/mcp-endpoint.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Per-agent MCP surface: every mounted agent is also a Model Context
+ * Protocol server over streamable HTTP at `<base>/v1/mcp`, so other agents
+ * (peer MCP connections) and ordinary MCP clients can delegate work to it.
+ *
+ * The endpoint is stateless (a fresh `McpServer` + transport per POST, JSON
+ * response mode): session identity travels in tool arguments, not in MCP
+ * transport session headers, so any number of hosts can sit in front of it.
+ *
+ * Tools:
+ * - `ask` — start (or continue, via `sessionId`) a conversation with this
+ *   agent; runs a model turn in the agent's own context and returns the
+ *   reply. Bounded wait: long turns return `status: "running"`.
+ * - `check` — wait for / poll a running session started by `ask`.
+ * - `call_tool` — call one of the agent's deterministic server tools
+ *   directly (no model turn). Registered only when server tools exist.
+ */
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import type { AgentProject, AuthContext } from "../types.js";
+import { type SessionEngine } from "./session-engine.js";
+/** Channel id recorded on sessions created through the MCP surface. */
+export declare const MCP_CHANNEL_ID = "mcp";
+/** Mount path of the MCP surface, relative to the agent base. */
+export declare const MCP_ENDPOINT_PATH = "/v1/mcp";
+export interface AgentMcpEndpoint {
+    /**
+     * Handle one HTTP request to the MCP mount. `auth` is the principal
+     * resolved by the route auth chain; sessions created through `ask` bind
+     * to it, and follow-ups enforce the same principal.
+     */
+    handle(request: Request, auth: AuthContext | null): Promise<Response>;
+}
+/** Minimal shape both `McpServer` and the low-level `Server` satisfy. */
+interface ConnectableMcpServer {
+    connect(transport: WebStandardStreamableHTTPServerTransport): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Serve one stateless streamable-HTTP MCP request: a fresh server +
+ * transport per POST, JSON response mode, spec-compliant 405 on other
+ * methods. Shared by the per-agent MCP endpoint and the Cursor account
+ * bridge so the subtle transport/error plumbing exists once.
+ */
+export declare function handleStatelessMcpRequest(args: {
+    request: Request;
+    /** Builds the per-request MCP server (tools close over request state). */
+    buildServer: () => ConnectableMcpServer;
+    /** Label used in the failure log line, e.g. `"mcp endpoint"`. */
+    label: string;
+    logger?: (line: string) => void;
+}): Promise<Response>;
+/** Tool names the MCP surface exposes for `project` (info projection). */
+export declare function mcpEndpointToolNames(project: AgentProject): string[];
+export declare function createAgentMcpEndpoint(args: {
+    engine: SessionEngine;
+    logger?: (line: string) => void;
+}): AgentMcpEndpoint;
+export {};
+//# sourceMappingURL=mcp-endpoint.d.ts.map

package/dist/internal/mcp-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-endpoint.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC;AAEzH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAGZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,aAAa,EAKnB,MAAM,qBAAqB,CAAC;AAE7B,uEAAuE;AACvE,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAU3C,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvE;AAED,yEAAyE;AACzE,UAAU,oBAAoB;IAC5B,OAAO,CAAC,SAAS,EAAE,wCAAwC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,oBAAoB,CAAC;IACxC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,QAAQ,CAAC,CA2CpB;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAMpE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,gBAAgB,CAanB"}