@cursor/july 0.1.1

package/dist/internal/router.js

@@ -0,0 +1,93 @@
+/**
+ * Tiny path router: literal segments, `:param` captures, and a trailing
+ * `*param` catch-all, compiled once at server startup.
+ */
+export class Router {
+    constructor() {
+        this.routes = [];
+    }
+    add(route) {
+        this.routes.push({ route, segments: compilePattern(route.pattern) });
+    }
+    match(method, pathname) {
+        const direct = this.matchExact(method, pathname);
+        if (direct !== undefined) {
+            return direct;
+        }
+        // HTTP: HEAD may be served by the corresponding GET handler (wget --spider,
+        // some load-balancer probes). Without this, GET-only routes return 405.
+        if (method === "HEAD") {
+            return this.matchExact("GET", pathname);
+        }
+        return undefined;
+    }
+    matchExact(method, pathname) {
+        const pathSegments = splitPath(pathname);
+        for (const { route, segments } of this.routes) {
+            if (route.method !== method) {
+                continue;
+            }
+            const params = matchSegments(segments, pathSegments);
+            if (params !== undefined) {
+                return { route, params };
+            }
+        }
+        return undefined;
+    }
+    /** True when the path matches some route with a different method. */
+    hasPath(pathname) {
+        const pathSegments = splitPath(pathname);
+        return this.routes.some(({ segments }) => matchSegments(segments, pathSegments) !== undefined);
+    }
+}
+function compilePattern(pattern) {
+    const segments = splitPath(pattern).map((part) => part.startsWith(":")
+        ? { kind: "param", name: part.slice(1) }
+        : part.startsWith("*")
+            ? { kind: "rest", name: part.slice(1) }
+            : { kind: "literal", value: part });
+    const restIndex = segments.findIndex((segment) => segment.kind === "rest");
+    if (restIndex !== -1 && restIndex !== segments.length - 1) {
+        throw new Error(`Route pattern "${pattern}" may only use a catch-all (*name) as the last segment.`);
+    }
+    return segments;
+}
+function splitPath(path) {
+    return path.split("/").filter((part) => part !== "");
+}
+function matchSegments(segments, pathSegments) {
+    const last = segments[segments.length - 1];
+    const hasRest = last !== undefined && last.kind === "rest";
+    if (hasRest) {
+        if (pathSegments.length < segments.length - 1) {
+            return undefined;
+        }
+    }
+    else if (segments.length !== pathSegments.length) {
+        return undefined;
+    }
+    const params = {};
+    const fixedCount = hasRest ? segments.length - 1 : segments.length;
+    for (let i = 0; i < fixedCount; i++) {
+        const segment = segments[i];
+        const value = pathSegments[i];
+        if (segment === undefined || value === undefined) {
+            return undefined;
+        }
+        if (segment.kind === "literal") {
+            if (segment.value !== value) {
+                return undefined;
+            }
+        }
+        else if (segment.kind === "param") {
+            params[segment.name] = decodeURIComponent(value);
+        }
+    }
+    if (hasRest) {
+        params[last.name] = pathSegments
+            .slice(fixedCount)
+            .map((value) => decodeURIComponent(value))
+            .join("/");
+    }
+    return params;
+}

package/dist/internal/run-client.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Programmatic HTTP client for agent-serve sessions.
+ *
+ * Used by `agent-serve run` and `chat --json`: create/follow a
+ * session, collect the NDJSON stream until the turn parks, and return a
+ * compact {@link Trajectory} plus the continuation token for follow-ups.
+ */
+import type { SessionEvent, SessionPurpose } from "../types.js";
+import { type Trajectory } from "./trajectory.js";
+/** Thrown when a turn stream exceeds `timeoutMs`; carries the session id. */
+export declare class RunSessionTimeoutError extends Error {
+    readonly sessionId: string;
+    constructor(message: string, sessionId: string);
+}
+export interface RunClientOptions {
+    baseUrl: string;
+    bearerToken?: string;
+    /** Abort a hung turn. */
+    timeoutMs?: number;
+    /** Called for each stream event as it arrives (for CLI progress). */
+    onEvent?: (event: SessionEvent) => void;
+    /**
+     * Create-time session purpose. Pass `"eval"` from the eval harness so
+     * live `defineAB` enrollment is skipped. Default `"live"`.
+     */
+    purpose?: SessionPurpose;
+}
+export interface RunSessionResult {
+    sessionId: string;
+    continuationToken?: string;
+    baseUrl: string;
+    events: SessionEvent[];
+    trajectory: Trajectory;
+    ok: boolean;
+}
+/**
+ * Run one or more messages against a live agent-serve base URL
+ * (e.g. `http://127.0.0.1:3000/weather-agent`).
+ */
+export declare function runSession(options: RunClientOptions & {
+    messages: string[];
+    sessionId?: string;
+    continuationToken?: string;
+    /** Applied only when creating a new session (first message). */
+    workspaceDir?: string;
+    /** Applied only when creating a new session (first message). */
+    workspaceFiles?: Record<string, string>;
+}): Promise<RunSessionResult>;
+//# sourceMappingURL=run-client.d.ts.map

package/dist/internal/run-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-client.d.ts","sourceRoot":"","sources":["../../src/internal/run-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnE,6EAA6E;AAC7E,qBAAa,sBAAuB,SAAQ,KAAK;IAG7C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAF5B,YACE,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,MAAM,EAI3B;CACF;AACD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,EAAE,EAAE,OAAO,CAAC;CACb;AAQD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,gBAAgB,GAAG;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC,GACA,OAAO,CAAC,gBAAgB,CAAC,CAuD3B"}

package/dist/internal/run-client.js

@@ -0,0 +1,208 @@
+/**
+ * Programmatic HTTP client for agent-serve sessions.
+ *
+ * Used by `agent-serve run` and `chat --json`: create/follow a
+ * session, collect the NDJSON stream until the turn parks, and return a
+ * compact {@link Trajectory} plus the continuation token for follow-ups.
+ */
+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 { buildTrajectory } from "./trajectory.js";
+/** Thrown when a turn stream exceeds `timeoutMs`; carries the session id. */
+export class RunSessionTimeoutError extends Error {
+    constructor(message, sessionId) {
+        super(message);
+        this.sessionId = sessionId;
+        this.name = "RunSessionTimeoutError";
+    }
+}
+const TERMINAL_TYPES = new Set([
+    "session.waiting",
+    "session.completed",
+    "session.failed",
+]);
+/**
+ * Run one or more messages against a live agent-serve base URL
+ * (e.g. `http://127.0.0.1:3000/weather-agent`).
+ */
+export function runSession(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (options.messages.length === 0) {
+            throw new Error("runSession requires at least one message");
+        }
+        const baseUrl = options.baseUrl.replace(/\/$/, "");
+        let sessionId = options.sessionId;
+        let continuationToken = options.continuationToken;
+        const allEvents = [];
+        let nextEventIndex = 0;
+        for (const message of options.messages) {
+            const turn = yield runOneTurn(Object.assign(Object.assign(Object.assign({ baseUrl,
+                message,
+                sessionId,
+                continuationToken, startIndex: sessionId === undefined ? 0 : nextEventIndex, bearerToken: options.bearerToken, timeoutMs: options.timeoutMs, onEvent: options.onEvent }, (sessionId === undefined && options.purpose !== undefined
+                ? { purpose: options.purpose }
+                : {})), (sessionId === undefined && options.workspaceDir !== undefined
+                ? { workspaceDir: options.workspaceDir }
+                : {})), (sessionId === undefined && options.workspaceFiles !== undefined
+                ? { workspaceFiles: options.workspaceFiles }
+                : {})));
+            sessionId = turn.sessionId;
+            continuationToken = turn.continuationToken;
+            allEvents.push(...turn.events);
+            if (turn.events.length > 0) {
+                const last = turn.events[turn.events.length - 1];
+                nextEventIndex = last.index + 1;
+            }
+            if (!turn.ok) {
+                break;
+            }
+        }
+        if (sessionId === undefined) {
+            throw new Error("server did not return a session id");
+        }
+        const trajectory = buildTrajectory(allEvents);
+        return Object.assign(Object.assign({ sessionId }, (continuationToken === undefined ? {} : { continuationToken })), { baseUrl, events: allEvents, trajectory, ok: trajectory.ok });
+    });
+}
+function runOneTurn(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        let sessionId = args.sessionId;
+        let continuationToken = args.continuationToken;
+        if (sessionId === undefined) {
+            const created = yield postJson(args.baseUrl, "/v1/session", Object.assign(Object.assign(Object.assign({ message: args.message }, (args.purpose === undefined ? {} : { purpose: args.purpose })), (args.workspaceDir === undefined
+                ? {}
+                : { workspaceDir: args.workspaceDir })), (args.workspaceFiles === undefined
+                ? {}
+                : { workspaceFiles: args.workspaceFiles })), args.bearerToken);
+            if (created.status >= 400 || created.body.ok === false) {
+                throw new Error(`POST /v1/session failed: ${(_a = str(created.body.error)) !== null && _a !== void 0 ? _a : created.status} ${(_b = str(created.body.message)) !== null && _b !== void 0 ? _b : ""}`.trim());
+            }
+            sessionId = str(created.body.sessionId);
+            continuationToken = str(created.body.continuationToken);
+        }
+        else {
+            const resp = yield postJson(args.baseUrl, `/v1/session/${sessionId}`, { message: args.message, continuationToken }, args.bearerToken);
+            if (resp.status >= 400 || resp.body.ok === false) {
+                throw new Error(`follow-up failed: ${(_c = str(resp.body.error)) !== null && _c !== void 0 ? _c : resp.status}: ${(_d = str(resp.body.message)) !== null && _d !== void 0 ? _d : ""}`.trim());
+            }
+            continuationToken = (_e = str(resp.body.continuationToken)) !== null && _e !== void 0 ? _e : continuationToken;
+        }
+        if (sessionId === undefined) {
+            throw new Error("server did not return a session id");
+        }
+        const events = yield collectStream({
+            baseUrl: args.baseUrl,
+            sessionId,
+            startIndex: args.startIndex,
+            bearerToken: args.bearerToken,
+            timeoutMs: args.timeoutMs,
+            onEvent: args.onEvent,
+        });
+        const turnFailed = events.some((e) => e.type === "turn.failed");
+        const sessionFailed = events.some((e) => e.type === "session.failed");
+        return Object.assign(Object.assign({ sessionId }, (continuationToken === undefined ? {} : { continuationToken })), { events, ok: !turnFailed && !sessionFailed });
+    });
+}
+function collectStream(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        var _b, _c;
+        const controller = new AbortController();
+        const timer = args.timeoutMs === undefined
+            ? undefined
+            : setTimeout(() => controller.abort(), args.timeoutMs);
+        try {
+            const resp = yield fetch(`${args.baseUrl}/v1/session/${args.sessionId}/stream?startIndex=${args.startIndex}`, {
+                headers: authHeaders(args.bearerToken),
+                signal: controller.signal,
+            });
+            if (!resp.ok || resp.body === null) {
+                throw new Error(`stream failed (${resp.status})`);
+            }
+            const reader = resp.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            const events = [];
+            for (;;) {
+                const chunk = yield reader.read();
+                if (chunk.done) {
+                    break;
+                }
+                buffer += decoder.decode(chunk.value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = (_b = lines.pop()) !== null && _b !== void 0 ? _b : "";
+                let stop = false;
+                for (const line of lines) {
+                    if (line.trim() === "") {
+                        continue;
+                    }
+                    let event;
+                    try {
+                        event = JSON.parse(line);
+                    }
+                    catch (_d) {
+                        continue;
+                    }
+                    events.push(event);
+                    (_a = args.onEvent) === null || _a === void 0 ? void 0 : _a.call(args, event);
+                    if (TERMINAL_TYPES.has(event.type)) {
+                        stop = true;
+                        break;
+                    }
+                }
+                if (stop) {
+                    break;
+                }
+            }
+            yield reader.cancel().catch(() => { });
+            return events;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new RunSessionTimeoutError(`turn timed out after ${(_c = args.timeoutMs) !== null && _c !== void 0 ? _c : "?"}ms (session ${args.sessionId})`, args.sessionId);
+            }
+            throw error;
+        }
+        finally {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+        }
+    });
+}
+function authHeaders(bearerToken) {
+    return bearerToken === undefined
+        ? {}
+        : { authorization: `Bearer ${bearerToken}` };
+}
+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();
+        let parsed = {};
+        if (text) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch (_a) {
+                parsed = { message: text };
+            }
+        }
+        return { status: resp.status, body: parsed };
+    });
+}
+function str(value) {
+    return typeof value === "string" ? value : undefined;
+}

package/dist/internal/schedule-runner.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Cron dispatch for `agent/schedules/`. In production mode a minute-aligned
+ * ticker fires matching schedules (UTC evaluation); in dev mode nothing
+ * fires automatically and `POST /v1/dev/schedules/:scheduleId` dispatches a
+ * schedule by hand, exactly once, through the same path.
+ */
+import type { AgentProject, AuthContext } from "../types.js";
+import { type SessionEngine } from "./session-engine.js";
+export declare const APP_AUTH: AuthContext;
+export declare class UnknownScheduleError extends Error {
+    readonly availableScheduleIds: string[];
+    constructor(scheduleId: string, availableScheduleIds: string[]);
+}
+export declare class ScheduleRunner {
+    private readonly engine;
+    private readonly logger;
+    private readonly schedules;
+    private timer;
+    private lastFiredMinute;
+    constructor(engine: SessionEngine, project: AgentProject, logger?: (line: string) => void);
+    get scheduleIds(): string[];
+    start(): void;
+    stop(): void;
+    private arm;
+    private tick;
+    /** Fire a schedule by name, exactly once. Returns the started sessions. */
+    dispatch(scheduleId: string): Promise<{
+        sessionIds: string[];
+    }>;
+}
+//# sourceMappingURL=schedule-runner.d.ts.map

package/dist/internal/schedule-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-runner.d.ts","sourceRoot":"","sources":["../../src/internal/schedule-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAGZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,QAAQ,EAAE,WAItB,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAFzC,YACE,UAAU,EAAE,MAAM,EACT,oBAAoB,EAAE,MAAM,EAAE,EAIxC;CACF;AAQD,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,eAAe,CAAM;IAE7B,YACmB,MAAM,EAAE,aAAa,EACtC,OAAO,EAAE,YAAY,EACJ,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe,EAO3D;IAED,IAAI,WAAW,IAAI,MAAM,EAAE,CAE1B;IAED,KAAK,IAAI,IAAI,CAKZ;IAED,IAAI,IAAI,IAAI,CAKX;IAED,OAAO,CAAC,GAAG;IAOX,OAAO,CAAC,IAAI;IAoBZ,2EAA2E;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAuDpE;CACF"}

package/dist/internal/schedule-runner.js

@@ -0,0 +1,126 @@
+/**
+ * Cron dispatch for `agent/schedules/`. In production mode a minute-aligned
+ * ticker fires matching schedules (UTC evaluation); in dev mode nothing
+ * fires automatically and `POST /v1/dev/schedules/:scheduleId` dispatches a
+ * schedule by hand, exactly once, through the same path.
+ */
+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 { parseCron } from "./cron.js";
+import { SCHEDULE_CHANNEL_PREFIX, } from "./session-engine.js";
+export const APP_AUTH = {
+    authenticator: "app",
+    principalId: "agent-serve:app",
+    principalType: "runtime",
+};
+export class UnknownScheduleError extends Error {
+    constructor(scheduleId, availableScheduleIds) {
+        super(`Unknown schedule "${scheduleId}"`);
+        this.availableScheduleIds = availableScheduleIds;
+        this.name = "UnknownScheduleError";
+    }
+}
+export class ScheduleRunner {
+    constructor(engine, project, logger = () => { }) {
+        this.engine = engine;
+        this.logger = logger;
+        this.lastFiredMinute = -1;
+        this.schedules = project.schedules.map((schedule) => ({
+            name: schedule.name,
+            cron: parseCron(schedule.cron),
+            discovered: schedule,
+        }));
+    }
+    get scheduleIds() {
+        return this.schedules.map((schedule) => schedule.name);
+    }
+    start() {
+        if (this.timer !== undefined || this.schedules.length === 0) {
+            return;
+        }
+        this.arm();
+    }
+    stop() {
+        if (this.timer !== undefined) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+    }
+    arm() {
+        var _a, _b;
+        const now = Date.now();
+        const nextMinute = (Math.floor(now / 60000) + 1) * 60000;
+        this.timer = setTimeout(() => this.tick(), nextMinute - now + 250);
+        (_b = (_a = this.timer).unref) === null || _b === void 0 ? void 0 : _b.call(_a);
+    }
+    tick() {
+        const now = new Date();
+        const minute = Math.floor(now.getTime() / 60000);
+        if (minute !== this.lastFiredMinute) {
+            this.lastFiredMinute = minute;
+            for (const schedule of this.schedules) {
+                if (schedule.cron.matches(now)) {
+                    void this.dispatch(schedule.name).catch((error) => {
+                        this.logger(`[agent-serve] schedule "${schedule.name}" dispatch failed: ${error instanceof Error ? error.message : String(error)}`);
+                    });
+                }
+            }
+        }
+        this.arm();
+    }
+    /** Fire a schedule by name, exactly once. Returns the started sessions. */
+    dispatch(scheduleId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const schedule = this.schedules.find((s) => s.name === scheduleId);
+            if (schedule === undefined) {
+                throw new UnknownScheduleError(scheduleId, this.scheduleIds);
+            }
+            const definition = schedule.discovered.definition;
+            const channelId = `${SCHEDULE_CHANNEL_PREFIX}${schedule.name}`;
+            if (definition.markdown !== undefined) {
+                const { sessionId, done } = yield this.engine.runTask({
+                    channelId,
+                    prompt: definition.markdown,
+                    auth: APP_AUTH,
+                    title: `Schedule ${schedule.name}`,
+                });
+                this.engine.trackBackground(done);
+                return { sessionIds: [sessionId] };
+            }
+            if (definition.run === undefined) {
+                throw new Error(`Schedule "${scheduleId}" has no markdown or run form`);
+            }
+            const sessionIds = [];
+            const receivePromises = [];
+            const receive = (channel, input) => {
+                const promise = this.engine.receive(channel, input).then((session) => {
+                    sessionIds.push(session.id);
+                    return session;
+                });
+                receivePromises.push(promise.catch(() => { }));
+                return promise;
+            };
+            yield definition.run({
+                receive,
+                callTool: (toolName, input, callOptions) => this.engine.callTool(toolName, input, Object.assign({ auth: APP_AUTH }, callOptions)),
+                waitUntil: (promise) => {
+                    this.engine.trackBackground(promise);
+                },
+                appAuth: APP_AUTH,
+                host: this.engine.host,
+            });
+            // Collect ids from receive() calls the handler chose not to await
+            // (commonly wrapped in waitUntil); receive resolves at message accept,
+            // not turn completion, so this settles fast.
+            yield Promise.allSettled(receivePromises);
+            return { sessionIds };
+        });
+    }
+}

package/dist/internal/sdk-runner.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Executes turns on the Cursor harness through `@cursor/sdk`.
+ * Each framework session maps 1:1 to an SDK agent. Local agents use the
+ * session id as the SDK agent id and materialize a workspace for project
+ * settings; cloud agents use Cursor cloud (`bc-…` ids) with optional
+ * `cloud` options from `defineAgent`.
+ */
+import { type LocalAgentStore, type ModelSelection } from "@cursor/sdk";
+import { type ModelSetting, type RunnerTurnRequest, type TurnOutcome } from "../types.js";
+/** Internal seam between the session engine and the Cursor SDK harness. */
+export interface AgentRunner {
+    runTurn(request: RunnerTurnRequest): Promise<TurnOutcome>;
+    dispose?(): Promise<void>;
+}
+export interface CursorSdkRunnerOptions {
+    /** Cursor API key. Defaults to the `CURSOR_API_KEY` environment variable. */
+    apiKey?: string;
+    /**
+     * Conversation store override. Defaults to a JSONL store under the
+     * engine's state root; install `sqlite3` and pass an SQLite-backed
+     * `LocalAgentStore` for heavy multi-session concurrency.
+     */
+    store?: LocalAgentStore;
+}
+export declare class CursorSdkRunner implements AgentRunner {
+    private readonly options;
+    private readonly agents;
+    private readonly stores;
+    constructor(options?: CursorSdkRunnerOptions);
+    runTurn(request: RunnerTurnRequest): Promise<TurnOutcome>;
+    dispose(): Promise<void>;
+    private getAgent;
+    private openAgent;
+    private openLocalAgent;
+    private openCloudAgent;
+    private getStore;
+}
+/** Cloud agent ids minted by the server are `bc-…`; those always resume. */
+export declare function isServerMintedCloudAgentId(id: string): boolean;
+export declare function toModelSelection(model: ModelSetting): ModelSelection;
+//# sourceMappingURL=sdk-runner.d.ts.map

package/dist/internal/sdk-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,cAAc,EAGpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAErB,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,qBAAa,eAAgB,YAAW,WAAW;IAIrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IAEtE,YAA6B,OAAO,GAAE,sBAA2B,EAAI;IAE/D,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CA0D9D;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ7B;IAED,OAAO,CAAC,QAAQ;YAYF,SAAS;YA2BT,cAAc;YAwBd,cAAc;IAqC5B,OAAO,CAAC,QAAQ;CAUjB;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAQpE"}