@botiverse/oar 0.15.2 → 0.16.0

package/dist/runtimes/cursor/model.js

@@ -0,0 +1,98 @@
+/**
+ * Cursor's catalog (`Cursor.models.list()`, SDK 1.0.35) gives each model its
+ * own parameters, and the reasoning one has a different id per family:
+ * `effort` (Claude 5, Grok 4.6), `reasoning` (GPT), `reasoning_effort`
+ * (Grok 4.7, Gemini 3.8, Claude Sonnet 5.5). Several Claude models also have
+ * a `thinking` on/off switch; the level menu wins over it, and a model whose
+ * only reasoning parameter is the switch (claude-haiku-4-5) keeps it.
+ */
+const LEVEL_PARAMETERS = ["effort", "reasoning", "reasoning_effort"];
+const SWITCH_PARAMETER = "thinking";
+const EFFORT_PARAMETERS = [...LEVEL_PARAMETERS, SWITCH_PARAMETER];
+/** The catalog's "Auto" entry; a local agent needs a model, and this is the one Cursor picks for the user. */
+export const CURSOR_DEFAULT_MODEL = "default";
+export function cursorEffortParameter(model) {
+    const parameters = model.parameters ?? [];
+    for (const id of EFFORT_PARAMETERS) {
+        const parameter = parameters.find((entry) => entry.id === id);
+        if (parameter !== undefined) {
+            return { id, levels: parameter.values.map((value) => value.value) };
+        }
+    }
+    return null;
+}
+/** The effort a selection carries, by the same parameter preference. */
+export function cursorSelectionEffort(selection) {
+    const params = selection?.params ?? [];
+    for (const id of EFFORT_PARAMETERS) {
+        const param = params.find((entry) => entry.id === id);
+        if (param !== undefined) {
+            return param.value;
+        }
+    }
+    return null;
+}
+function findModel(models, id) {
+    return models.find((model) => model.id === id || model.aliases?.includes(id) === true);
+}
+/**
+ * The selection a session opens with. A local agent always needs one, and a
+ * resumed agent does not restore its own, so on resume without a model the
+ * agent's latest recorded run says what it ran. A requested effort is
+ * checked against the model's own parameter menu, because the SDK passes an
+ * unknown value through unchecked and reports it back as given (probed
+ * 2026-10-03: `reasoning: "ludicrous"` ran and came back verbatim). It
+ * replaces only that parameter: the other parameters stay as the resumed run
+ * had them, or as the catalog's default variant sets them (a `thinking`
+ * switch stays on beside an `effort` level).
+ */
+/** Options the SDK cannot honor, refused before anything opens. */
+export function validateCursorOptions(options) {
+    if (options.systemPrompt !== undefined || options.appendSystemPrompt !== undefined) {
+        // SDK 1.0.35 types a `systemPrompt`, but a local agent's run fails with
+        // "unknown option '--system-prompt'" (probed 2026-10-03), and there is no append.
+        throw new Error("Cursor's SDK runs no system prompt override for a local agent");
+    }
+    if (options.env !== undefined && Object.keys(options.env).length > 0) {
+        throw new Error("Cursor runs in this process and its SDK takes no environment for the agent's tools; SessionOptions.env is unsupported");
+    }
+}
+export async function cursorModelSelection(sdk, options) {
+    const base = options.model === undefined && options.resume !== undefined
+        ? await latestRunModel(sdk, options.resume, options.cwd)
+        : undefined;
+    const id = options.model ?? base?.id ?? CURSOR_DEFAULT_MODEL;
+    if (options.effort === undefined) {
+        return base ?? { id };
+    }
+    const model = findModel(await sdk.Cursor.models.list(), id);
+    if (model === undefined) {
+        throw new Error(`Cursor does not list model ${id}, so effort ${options.effort} cannot be checked`);
+    }
+    const parameter = cursorEffortParameter(model);
+    if (parameter === null) {
+        throw new Error(`Cursor model ${model.id} has no effort setting; requested effort ${options.effort}`);
+    }
+    if (!parameter.levels.includes(options.effort)) {
+        throw new Error(`Cursor model ${model.id} does not offer effort ${options.effort}; it lists ${parameter.levels.join(", ")}`);
+    }
+    const others = base?.params ?? model.variants?.find((variant) => variant.isDefault === true)?.params ?? [];
+    const kept = others.filter((param) => param.id !== parameter.id);
+    return { id: model.id, params: [...kept, { id: parameter.id, value: options.effort }] };
+}
+async function latestRunModel(sdk, agentId, cwd) {
+    let latest = null;
+    let cursor = null;
+    do {
+        // oxlint-disable-next-line no-await-in-loop -- pages are sequential by construction.
+        const page = await sdk.Agent.listRuns(agentId, { runtime: "local", cwd, ...(cursor === null ? {} : { cursor }) });
+        for (const run of page.items) {
+            if (run.model !== undefined && (latest === null || (run.createdAt ?? 0) >= (latest.createdAt ?? 0))) {
+                latest = run;
+            }
+        }
+        cursor = page.nextCursor === undefined || page.nextCursor === "" ? null : page.nextCursor;
+    } while (cursor !== null);
+    return latest?.model;
+}
+//# sourceMappingURL=model.js.map

package/dist/runtimes/cursor/model.js.map

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

package/dist/runtimes/cursor/projection.d.ts

@@ -0,0 +1,40 @@
+import type { RuntimeEventBody, TokenTotals, ToolOutputPart } from "../../contracts/session.js";
+import { type JsonRecord } from "../../shared/json.js";
+import type { ModelSelection } from "./sdk.js";
+/** `tokens`: cumulative per agent path, so usage events stay summable. */
+export interface CursorProjectionState {
+    readonly tokens: ReadonlyMap<string, TokenTotals>;
+}
+export declare const initialCursorProjection: CursorProjectionState;
+export interface CursorFrame {
+    readonly type: string;
+    readonly native: unknown;
+    readonly events: readonly RuntimeEventBody[];
+    /** The sub-agent a subagent's update came from: the `task` call ids, outermost first. */
+    readonly agentPath: readonly string[];
+}
+/**
+ * A tool result as content parts. Shell output is its stdout and stderr, a
+ * read is the file text, an edit is its diff, a failure is its message;
+ * every other result is kept whole as one `other` part.
+ */
+export declare function cursorToolContent(tool: string, result: JsonRecord | null): readonly ToolOutputPart[] | undefined;
+/** One `onDelta` update as one frame, attributed to the subagent it came from. */
+export declare function foldCursorDelta(state: CursorProjectionState, native: unknown): {
+    readonly state: CursorProjectionState;
+    readonly frame: CursorFrame;
+};
+/**
+ * The agent as the SDK holds it after open: its id and model selection (the
+ * SDK has resolved an alias to the catalog id, `composer` → `composer-2.5`).
+ */
+export declare function cursorOpenedFrame(agentId: string, model: ModelSelection | undefined): CursorFrame;
+/**
+ * `run.wait()`'s answer: the run's status is the turn's outcome (`finished`,
+ * `cancelled`, `error` with the SDK's message), and its `model` is what the
+ * SDK records the run ran with.
+ */
+export declare function cursorRunResultFrame(result: unknown): CursorFrame;
+/** `run.wait()` rejected instead of answering: the SDK's own message ends the turn. */
+export declare function cursorRunFailedFrame(message: string): CursorFrame;
+//# sourceMappingURL=projection.d.ts.map

package/dist/runtimes/cursor/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/runtimes/cursor/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAe,MAAM,4BAA4B,CAAC;AAE7G,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAe/C,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,uBAAuB,EAAE,qBAA6C,CAAC;AAEpF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,yFAAyF;IACzF,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAqBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,cAAc,EAAE,GAAG,SAAS,CAiChH;AA6FD,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,OAAO,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAKrJ;AAUD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,SAAS,GAAG,WAAW,CAEjG;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAajE;AAeD,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAOjE"}

package/dist/runtimes/cursor/projection.js

@@ -0,0 +1,205 @@
+import { classifyFailure } from "../../shared/failure-class.js";
+import { asNumber, asRecord } from "../../shared/json.js";
+import { toolContent } from "../../shared/tool-output.js";
+import { cursorSelectionEffort } from "./model.js";
+export const initialCursorProjection = { tokens: new Map() };
+/**
+ * A subagent speaks through its `task` call: `tool-call-delta` carries the
+ * child's own update under `taskUpdate`, keyed by the call id (probed
+ * 2026-10-03: the child's thinking, tool calls and text all arrive this way).
+ * SDK 1.0.35's schema allows no `tool-call-delta` inside a `taskUpdate`; if
+ * one ever came, it is unwrapped the same way, one call id deeper.
+ */
+function innermost(update, path) {
+    const nested = asRecord(update.taskUpdate);
+    if (update.type === "tool-call-delta" && typeof update.callId === "string" && nested !== null) {
+        return innermost(nested, [...path, update.callId]);
+    }
+    return { update, path };
+}
+const pathKey = (path) => path.join("/");
+const text = (value) => (typeof value === "string" && value.length > 0 ? value : undefined);
+/**
+ * A tool result as content parts. Shell output is its stdout and stderr, a
+ * read is the file text, an edit is its diff, a failure is its message;
+ * every other result is kept whole as one `other` part.
+ */
+export function cursorToolContent(tool, result) {
+    if (result === null) {
+        return undefined;
+    }
+    if (result.status === "error") {
+        const message = text(asRecord(result.error)?.message) ?? text(result.error);
+        return message === undefined ? toolContent(result.error) : [{ type: "text", text: message }];
+    }
+    const value = asRecord(result.value);
+    const parts = [];
+    const add = (part) => {
+        const found = text(part);
+        if (found !== undefined) {
+            parts.push({ type: "text", text: found });
+        }
+    };
+    switch (tool) {
+        case "shell":
+            add(value?.stdout);
+            add(value?.stderr);
+            // The command ran and printed nothing: a result, with empty text.
+            return parts.length === 0 ? [{ type: "text", text: "" }] : parts;
+        case "read":
+            add(value?.content);
+            break;
+        case "edit":
+        case "write":
+            add(value?.diffString);
+            break;
+        default:
+            break;
+    }
+    return parts.length > 0 ? parts : toolContent(result.value);
+}
+function toolOutcome(status) {
+    if (status === "success") {
+        return "ok";
+    }
+    return status === "error" ? "failed" : undefined;
+}
+/** A shell's exit code, or `null` when cursor names the signal that ended it. */
+function shellExit(tool, result) {
+    const value = tool === "shell" && result?.status === "success" ? asRecord(result.value) : null;
+    if (value === null) {
+        return {};
+    }
+    if (typeof value.signal === "string" && value.signal !== "") {
+        return { exitCode: null };
+    }
+    const exitCode = asNumber(value.exitCode);
+    return exitCode === null ? {} : { exitCode };
+}
+function toolEnded(update) {
+    const callId = text(update.callId);
+    if (callId === undefined) {
+        return null;
+    }
+    const call = asRecord(update.toolCall);
+    const tool = text(call?.type) ?? "unknown";
+    const result = asRecord(call?.result);
+    const content = cursorToolContent(tool, result);
+    const outcome = toolOutcome(result?.status);
+    return {
+        kind: "tool_call_ended",
+        callId,
+        ...(content === undefined ? {} : { content }),
+        ...(outcome === undefined ? {} : { result: outcome }),
+        ...shellExit(tool, result),
+    };
+}
+function eventsOf(state, update, path) {
+    switch (update.type) {
+        case "text-delta": {
+            const delta = text(update.text);
+            return { state, events: delta === undefined ? [] : [{ kind: "text_delta", text: delta }] };
+        }
+        case "thinking-delta": {
+            const delta = text(update.text);
+            return { state, events: delta === undefined ? [] : [{ kind: "reasoning", content: { kind: "text", text: delta } }] };
+        }
+        case "tool-call-started": {
+            const callId = text(update.callId);
+            const call = asRecord(update.toolCall);
+            if (callId === undefined) {
+                return { state, events: [] };
+            }
+            const started = { kind: "tool_call_started", callId, tool: text(call?.type) ?? "unknown" };
+            return { state, events: [call?.args === undefined ? started : { ...started, input: JSON.stringify(call.args) }] };
+        }
+        case "tool-call-completed": {
+            const ended = toolEnded(update);
+            return { state, events: ended === null ? [] : [ended] };
+        }
+        case "user-message-appended": {
+            // A user message entered the conversation (a delivered steer, probed):
+            // text only, so no input id is claimed (docs/spec/conversation.md).
+            const input = asRecord(update.userMessage)?.text;
+            return { state, events: typeof input === "string" ? [{ kind: "user_message", input, evidence: "conversation" }] : [] };
+        }
+        case "turn-ended": {
+            const usage = asRecord(update.usage);
+            if (usage === null) {
+                return { state, events: [] };
+            }
+            const previous = state.tokens.get(pathKey(path)) ?? { input: 0, output: 0 };
+            // `inputTokens` excludes cache reads and writes (totalTokens is the sum
+            // of all four), so input counts them back in, as claude's and pi's do.
+            const tokens = {
+                input: previous.input + (asNumber(usage.inputTokens) ?? 0) + (asNumber(usage.cacheReadTokens) ?? 0) + (asNumber(usage.cacheWriteTokens) ?? 0),
+                output: previous.output + (asNumber(usage.outputTokens) ?? 0),
+            };
+            return { state: { tokens: new Map([...state.tokens, [pathKey(path), tokens]]) }, events: [{ kind: "usage", usage: { tokens } }] };
+        }
+        default:
+            return { state, events: [] };
+    }
+}
+/** One `onDelta` update as one frame, attributed to the subagent it came from. */
+export function foldCursorDelta(state, native) {
+    const outer = asRecord(native) ?? {};
+    const { update, path } = innermost(outer, []);
+    const read = eventsOf(state, update, path);
+    return { state: read.state, frame: { type: text(outer.type) ?? "unknown", native, events: read.events, agentPath: path } };
+}
+function selectionEvents(selection) {
+    if (selection === undefined) {
+        return [];
+    }
+    const effort = cursorSelectionEffort(selection);
+    return [{ kind: "model", model: selection.id }, ...(effort === null ? [] : [{ kind: "effort", effort }])];
+}
+/**
+ * The agent as the SDK holds it after open: its id and model selection (the
+ * SDK has resolved an alias to the catalog id, `composer` → `composer-2.5`).
+ */
+export function cursorOpenedFrame(agentId, model) {
+    return { type: "cursor/agent_opened", native: { agentId, model }, events: selectionEvents(model), agentPath: [] };
+}
+/**
+ * `run.wait()`'s answer: the run's status is the turn's outcome (`finished`,
+ * `cancelled`, `error` with the SDK's message), and its `model` is what the
+ * SDK records the run ran with.
+ */
+export function cursorRunResultFrame(result) {
+    const record = asRecord(result) ?? {};
+    const model = asRecord(record.model);
+    const selection = typeof model?.id === "string"
+        ? {
+            id: model.id,
+            params: (Array.isArray(model.params) ? model.params : []).flatMap((param) => {
+                const entry = asRecord(param);
+                return typeof entry?.id === "string" && typeof entry.value === "string" ? [{ id: entry.id, value: entry.value }] : [];
+            }),
+        }
+        : undefined;
+    return { type: "cursor/run_result", native: result, events: [...selectionEvents(selection), { kind: "turn_ended", outcome: runOutcome(record) }], agentPath: [] };
+}
+function runOutcome(result) {
+    switch (result.status) {
+        case "finished":
+            return { kind: "completed" };
+        case "cancelled":
+            return { kind: "aborted" };
+        default: {
+            const reason = text(asRecord(result.error)?.message) ?? `cursor run ended with status ${String(result.status)}`;
+            return { kind: "failed", reason, failure: classifyFailure(reason) };
+        }
+    }
+}
+/** `run.wait()` rejected instead of answering: the SDK's own message ends the turn. */
+export function cursorRunFailedFrame(message) {
+    return {
+        type: "cursor/run_failed",
+        native: { message },
+        events: [{ kind: "turn_ended", outcome: { kind: "failed", reason: message, failure: classifyFailure(message) } }],
+        agentPath: [],
+    };
+}
+//# sourceMappingURL=projection.js.map

package/dist/runtimes/cursor/projection.js.map

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

package/dist/runtimes/cursor/run.d.ts

@@ -0,0 +1,33 @@
+import type { ResponseBody } from "../../contracts/session.js";
+import { type CursorFrame } from "./projection.js";
+import type { CursorRun } from "./sdk.js";
+export interface ActiveRun {
+    readonly run: CursorRun;
+    /** Settles once the run's end is in the stream. */
+    readonly ended: Promise<void>;
+}
+/**
+ * One `send` on its way to a run. The prompt's answer waits on `decided`;
+ * an abort that arrives first is held in `abortRequested`; a dispose or the
+ * send deadline gives the launch up, and a run the SDK returns after that is
+ * stopped rather than adopted. Each launch is its own object, so a later one
+ * never reads or clears an earlier one's state.
+ */
+export interface Launch {
+    state: "sending" | "sent" | "failed" | "given_up";
+    abortRequested: boolean;
+    current: ActiveRun | null;
+    /** Why it was not sent: the SDK's error, or the reason it was given up. */
+    reason: string;
+    readonly decided: Promise<void>;
+    readonly decide: () => void;
+}
+export declare function newLaunch(): Launch;
+export declare function giveUp(launch: Launch, reason: string): void;
+/**
+ * A run the SDK returned after its launch was given up: it did start, so it
+ * is stopped, and its end still enters the stream.
+ */
+export declare function stopOrphan(run: CursorRun, record: (frame: CursorFrame) => void): void;
+export declare function steerRun(current: ActiveRun, input: string): Promise<ResponseBody>;
+//# sourceMappingURL=run.d.ts.map

package/dist/runtimes/cursor/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/runtimes/cursor/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAA8C,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,UAAU,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IAClD,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM3D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAarF;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAiCvF"}

package/dist/runtimes/cursor/run.js

@@ -0,0 +1,68 @@
+import { cursorRunFailedFrame, cursorRunResultFrame } from "./projection.js";
+export function newLaunch() {
+    const { promise, resolve } = Promise.withResolvers();
+    return { state: "sending", abortRequested: false, current: null, reason: "", decided: promise, decide: resolve };
+}
+export function giveUp(launch, reason) {
+    if (launch.state === "sending") {
+        launch.state = "given_up";
+        launch.reason = reason;
+        launch.decide();
+    }
+}
+/**
+ * A run the SDK returned after its launch was given up: it did start, so it
+ * is stopped, and its end still enters the stream.
+ */
+export function stopOrphan(run, record) {
+    void (async () => {
+        try {
+            await run.cancel();
+        }
+        catch {
+            // It may have ended on its own.
+        }
+        try {
+            record(cursorRunResultFrame(await run.wait()));
+        }
+        catch (error) {
+            record(cursorRunFailedFrame(error instanceof Error ? error.message : String(error)));
+        }
+    })();
+}
+export async function steerRun(current, input) {
+    const steer = current.run.steer?.bind(current.run);
+    if (steer === undefined) {
+        return { kind: "rejected", code: "unsupported", reason: "not_steerable: this cursor run takes no mid-run input" };
+    }
+    // `run.steer` settles once the agent took the text ("complete_delivered")
+    // or handed it back ("revert_to_followup"); a run that ends first must
+    // not leave the request unanswered, and a steer it outran must not reject
+    // unobserved.
+    const delivery = (async () => {
+        try {
+            return await steer(input);
+        }
+        catch (error) {
+            return error instanceof Error ? error : new Error(String(error));
+        }
+    })();
+    const runEnded = (async () => {
+        await current.ended;
+        return null;
+    })();
+    const ack = await Promise.race([delivery, runEnded]);
+    if (ack instanceof Error) {
+        throw ack;
+    }
+    if (ack === "complete_delivered") {
+        return { kind: "accepted", native: { ack } };
+    }
+    return {
+        kind: "rejected",
+        code: "runtime_refused",
+        reason: ack === null ? "not_steerable: the run ended before cursor took the input" : `not_steerable: cursor handed the input back (${ack})`,
+        ...(ack === null ? {} : { native: { ack } }),
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/runtimes/cursor/run.js.map

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

package/dist/runtimes/cursor/sdk.d.ts

@@ -0,0 +1,64 @@
+import type { ModelListItem, ModelSelection, RunResult, SDKUserMessage, SteerAckOutcome } from "@cursor/sdk";
+export type { ModelListItem, ModelSelection, RunResult, SteerAckOutcome } from "@cursor/sdk";
+export type CursorDeltaListener = (args: {
+    readonly update: unknown;
+}) => void;
+/** One send: a run of the agent loop until the agent ends it. */
+export interface CursorRun {
+    readonly id: string;
+    /** Settles with the run's status once it ends (finished, error or cancelled). */
+    wait(): Promise<RunResult>;
+    cancel(): Promise<void>;
+    /** Present on runs that take mid-run input; settles once the agent took the text or handed it back. */
+    steer?(text: string): Promise<SteerAckOutcome>;
+}
+export interface CursorAgent {
+    readonly agentId: string;
+    readonly model: ModelSelection | undefined;
+    /** `local.force` takes the agent over from a run its store still holds as active. */
+    send(message: string | SDKUserMessage, options: {
+        readonly onDelta: CursorDeltaListener;
+        readonly local?: {
+            readonly force: boolean;
+        };
+    }): Promise<CursorRun>;
+    close(): void;
+}
+export interface CursorAgentOptions {
+    readonly model: ModelSelection;
+    readonly local: {
+        readonly cwd: string;
+        readonly sandboxOptions: {
+            readonly enabled: boolean;
+        };
+    };
+}
+export interface CursorSdk {
+    readonly Agent: {
+        create(options: CursorAgentOptions): Promise<CursorAgent>;
+        resume(agentId: string, options: CursorAgentOptions): Promise<CursorAgent>;
+        listRuns(agentId: string, options: {
+            readonly runtime: "local";
+            readonly cwd: string;
+            readonly cursor?: string;
+        }): Promise<{
+            readonly items: readonly {
+                readonly model?: ModelSelection;
+                readonly createdAt?: number;
+            }[];
+            readonly nextCursor?: string;
+        }>;
+    };
+    readonly Cursor: {
+        readonly models: {
+            list(): Promise<readonly ModelListItem[]>;
+        };
+    };
+}
+/**
+ * The SDK is loaded on first use, not with OAR: it is a large bundle with a
+ * native companion package per platform, and a host that never opens cursor
+ * should not pay for it.
+ */
+export declare function loadCursorSdk(): Promise<CursorSdk>;
+//# sourceMappingURL=sdk.d.ts.map

package/dist/runtimes/cursor/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/runtimes/cursor/sdk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7G,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAS7F,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,CAAC;AAE/E,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,uGAAuG;IACvG,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,qFAAqF;IACrF,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;YAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7J,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,cAAc,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;CAClG;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE;QACd,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YACzH,QAAQ,CAAC,KAAK,EAAE,SAAS;gBAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;gBAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;aAAE,EAAE,CAAC;YAC5F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;SAC9B,CAAC,CAAC;KACJ,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,MAAM,EAAE;YAAE,IAAI,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAA;SAAE,CAAC;KAChE,CAAC;CACH;AAyCD;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,CAIxD"}

package/dist/runtimes/cursor/sdk.js

@@ -0,0 +1,50 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+let loading = null;
+/**
+ * The SDK's native companion (`@cursor/sdk-<platform>-<arch>`: ripgrep and
+ * the tree-sitter shell parser) is found by walking up from the host's entry
+ * script for `node_modules/<package>`, which misses it in any layout that
+ * does not hoist it (pnpm's, a bundled host): the agent then warns "tree-sitter
+ * natives are unavailable" and searches without its own ripgrep. Resolved
+ * from the SDK itself, the package is found wherever it was installed, and
+ * the SDK's own variables point at it, unless the host set them.
+ */
+function nativePackageRoot() {
+    try {
+        const fromSdk = createRequire(import.meta.resolve("@cursor/sdk"));
+        return path.dirname(fromSdk.resolve(`@cursor/sdk-${process.platform}-${process.arch}/package.json`));
+    }
+    catch {
+        return null;
+    }
+}
+function pointSdkAtNativePackage() {
+    const root = nativePackageRoot();
+    if (root === null) {
+        return;
+    }
+    process.env.CURSOR_TREE_SITTER_VENDOR_DIR ??= path.join(root, "vendor");
+    process.env.CURSOR_RIPGREP_PATH ??= path.join(root, "bin", process.platform === "win32" ? "rg.exe" : "rg");
+}
+async function importSdk() {
+    try {
+        pointSdkAtNativePackage();
+        return await import("@cursor/sdk");
+    }
+    catch (error) {
+        loading = null;
+        throw error;
+    }
+}
+/**
+ * The SDK is loaded on first use, not with OAR: it is a large bundle with a
+ * native companion package per platform, and a host that never opens cursor
+ * should not pay for it.
+ */
+export async function loadCursorSdk() {
+    loading ??= importSdk();
+    const sdk = await loading;
+    return sdk;
+}
+//# sourceMappingURL=sdk.js.map

package/dist/runtimes/cursor/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../../src/runtimes/cursor/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAmD7B,IAAI,OAAO,GAA8B,IAAI,CAAC;AAE9C;;;;;;;;GAQG;AACH,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC;IACvG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB;IAC9B,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,6BAA6B,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7G,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,IAAI,CAAC;QACH,uBAAuB,EAAE,CAAC;QAC1B,OAAO,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,IAAI,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,KAAK,SAAS,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC"}