@botiverse/oar 0.15.1 → 0.16.0

package/dist/runtimes/cursor/list-models.js

@@ -1,92 +1,60 @@
-/* oxlint-disable typescript/promise-function-async -- Deadline callbacks deliberately return the SDK's native promises. */
-import { client as createClient, methods, PROTOCOL_VERSION, RequestError, } from "@agentclientprotocol/sdk";
-import { acpThoughtLevelOption } from "../../shared/acp/model.js";
-import { startAcpProcess, withAcpDeadline } from "../../shared/acp/process.js";
-import { asRecord, asRecordList } from "../../shared/json.js";
-import { cursorAcpArgs, cursorClientCapabilitiesMeta, selectCursorAuthMethod } from "./session.js";
-const listMethod = "cursor/list_available_models";
-function text(value) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
+import { cursorEffortParameter } from "./model.js";
+import { loadCursorSdk } from "./sdk.js";
 /**
- * Project the `cursor/list_available_models` answer (cursor-agent
- * 2026.09.28): `{models: [{value, name, configOptions}]}`, where `value` is
- * the model name `session/set_config_option` accepts for `model`, `name` the
- * display name, and `configOptions` the model's parameters as select options
- * at their default values. The reasoning parameter is the `thought_level`
- * option a session would set for that model (`acpThoughtLevelOption`: the
- * `effort` menu over the `thinking` switch when a Claude model has both).
+ * Project `Cursor.models.list()` (SDK 1.0.35): `id` is the selector the SDK
+ * accepts, the effort menu is the model's reasoning parameter
+ * (`cursorEffortParameter`), and the default effort is that parameter's
+ * value in the variant the catalog marks `isDefault`.
  */
-export function projectCursorModels(result) {
-    const entries = [];
-    for (const model of asRecordList(asRecord(result)?.models)) {
-        const id = text(model.value);
-        if (id === undefined) {
-            continue;
-        }
-        const displayName = text(model.name);
-        const thoughtLevel = acpThoughtLevelOption({ configOptions: model.configOptions }) ?? undefined;
-        const effortLevels = thoughtLevel === undefined
+export function projectCursorModels(models) {
+    return models.map((model) => {
+        const parameter = cursorEffortParameter(model);
+        const defaultEffort = parameter === null
             ? undefined
-            : asRecordList(thoughtLevel.options).flatMap((option) => text(option.value) ?? []);
-        const defaultEffort = thoughtLevel === undefined ? undefined : text(thoughtLevel.currentValue);
-        entries.push({
-            id,
-            ...(displayName === undefined || displayName === id ? {} : { displayName }),
-            ...(effortLevels === undefined || effortLevels.length === 0 ? {} : { effortLevels }),
+            : model.variants?.find((variant) => variant.isDefault === true)?.params.find((param) => param.id === parameter.id)?.value;
+        return {
+            id: model.id,
+            ...(model.displayName === "" || model.displayName === model.id ? {} : { displayName: model.displayName }),
+            ...(parameter === null || parameter.levels.length === 0 ? {} : { effortLevels: parameter.levels }),
             ...(defaultEffort === undefined ? {} : { defaultEffort }),
-        });
-    }
-    return entries;
+        };
+    });
 }
-async function readModels(command, timeoutMs) {
-    const runtime = startAcpProcess(command, cursorAcpArgs, createClient({ name: "oar" }), { env: process.env });
-    try {
-        const initialize = methods.agent.initialize;
-        const response = await withAcpDeadline(runtime, initialize, timeoutMs, (requestOptions) => runtime.connection.agent.request(initialize, {
-            protocolVersion: PROTOCOL_VERSION,
-            clientCapabilities: {
-                fs: { readTextFile: false, writeTextFile: false },
-                terminal: false,
-                _meta: cursorClientCapabilitiesMeta(),
-            },
-            clientInfo: { name: "oar", version: "0.0.0" },
-        }, requestOptions));
-        const method = selectCursorAuthMethod(asRecord(response) ?? {});
-        if (method !== undefined) {
-            const authenticate = methods.agent.authenticate;
-            await withAcpDeadline(runtime, authenticate, timeoutMs, (requestOptions) => runtime.connection.agent.request(authenticate, { methodId: method }, requestOptions));
-        }
-        return await withAcpDeadline(runtime, listMethod, timeoutMs, (requestOptions) => runtime.connection.agent.request(listMethod, {}, requestOptions));
-    }
-    finally {
-        runtime.kill();
-        await runtime.exited;
+/** Without a credential the SDK refuses before asking (`ConfigurationError`: "API key is required …"). */
+function unauthenticated(error) {
+    if (!(error instanceof Error)) {
+        return null;
     }
+    return error.name === "AuthenticationError" || /api key is required|invalid (?:user )?api key/iu.test(error.message)
+        ? error.message
+        : null;
 }
-export const cursorListModels = async (installation, options = {}) => {
-    if (installation.via !== "executable") {
-        return { kind: "unsupported", reason: "cursor model listing requires the cursor-agent executable" };
-    }
-    try {
-        const result = await readModels(installation.command, options.timeoutMs ?? 15_000);
-        return { kind: "ok", models: projectCursorModels(result) };
-    }
-    catch (error) {
-        if (error instanceof RequestError) {
-            if (error.code === -32_601) {
-                return { kind: "unsupported", reason: `this cursor-agent build has no ${listMethod} method` };
-            }
-            // cursor-agent answers `authRequired` (-32000) until `cursor-agent login` has run.
-            if (error.code === -32_000 || /auth(?:entication)?|log(?:ged)? ?in/iu.test(error.message)) {
-                return { kind: "unauthenticated", detail: error.message };
+export function cursorListModelsWith(load) {
+    return async (installation, options = {}) => {
+        if (installation.via !== "bundled") {
+            return { kind: "unsupported", reason: "cursor model listing needs the bundled @cursor/sdk" };
+        }
+        const timeoutMs = options.timeoutMs ?? 15_000;
+        try {
+            const sdk = await load();
+            const models = await Promise.race([
+                sdk.Cursor.models.list(),
+                new Promise((_resolve, reject) => {
+                    setTimeout(() => {
+                        reject(new Error(`Cursor.models.list() did not answer within ${String(timeoutMs)} ms`));
+                    }, timeoutMs).unref();
+                }),
+            ]);
+            return { kind: "ok", models: projectCursorModels(models) };
+        }
+        catch (error) {
+            const detail = unauthenticated(error);
+            if (detail !== null) {
+                return { kind: "unauthenticated", detail };
             }
+            throw new Error("Failed to list Cursor models", { cause: error });
         }
-        throw new Error("Failed to list Cursor models", { cause: error });
-    }
-};
+    };
+}
+export const cursorListModels = cursorListModelsWith(loadCursorSdk);
 //# sourceMappingURL=list-models.js.map

package/dist/runtimes/cursor/list-models.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-models.js","sourceRoot":"","sources":["../../../src/runtimes/cursor/list-models.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"list-models.js","sourceRoot":"","sources":["../../../src/runtimes/cursor/list-models.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,aAAa,EAAsC,MAAM,UAAU,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAgC;IAClE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,aAAa,GAAG,SAAS,KAAK,IAAI;YACtC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC;QAC5H,OAAO;YACL,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,EAAE,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;YACzG,GAAG,CAAC,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;YAClG,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;SAC1D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0GAA0G;AAC1G,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,KAAK,qBAAqB,IAAI,iDAAiD,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAClH,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAA8B;IACjE,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;QAC1C,IAAI,YAAY,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,oDAAoD,EAAE,CAAC;QAC/F,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;gBACxB,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;oBACtC,UAAU,CAAC,GAAG,EAAE;wBACd,MAAM,CAAC,IAAI,KAAK,CAAC,8CAA8C,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC1F,CAAC,EAAE,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxB,CAAC,CAAC;aACH,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC;YAC7C,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAgB,oBAAoB,CAAC,aAAa,CAAC,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { SessionOptions } from "../../contracts/session.js";
+import type { CursorSdk, ModelListItem, ModelSelection } from "./sdk.js";
+/** The catalog's "Auto" entry; a local agent needs a model, and this is the one Cursor picks for the user. */
+export declare const CURSOR_DEFAULT_MODEL = "default";
+export declare function cursorEffortParameter(model: ModelListItem): {
+    readonly id: string;
+    readonly levels: readonly string[];
+} | null;
+/** The effort a selection carries, by the same parameter preference. */
+export declare function cursorSelectionEffort(selection: ModelSelection | undefined): string | null;
+/**
+ * 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 declare function validateCursorOptions(options: SessionOptions): void;
+export declare function cursorModelSelection(sdk: CursorSdk, options: SessionOptions): Promise<ModelSelection>;
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/runtimes/cursor/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAczE,8GAA8G;AAC9G,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAS9H;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAS1F;AAMD;;;;;;;;;;GAUG;AACH,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CASnE;AAED,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAsB3G"}

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":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAmB,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAqBnD,MAAM,CAAC,MAAM,uBAAuB,GAA0B,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;AAUpF;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,MAAkB,EAAE,IAAuB;IAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC9F,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,IAAuB,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEpE,MAAM,IAAI,GAAG,CAAC,KAAc,EAAsB,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAEzH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAyB;IACvE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,IAAa,EAAQ,EAAE;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC;IACF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACnB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACnB,kEAAkE;YAClE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnE,KAAK,MAAM;YACT,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACpB,MAAM;QACR,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACvB,MAAM;QACR;YACE,MAAM;IACV,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,WAAW,CAAC,MAAe;IAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC;AAED,iFAAiF;AACjF,SAAS,SAAS,CAAC,IAAY,EAAE,MAAyB;IACxD,MAAM,KAAK,GAAG,IAAI,KAAK,OAAO,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/F,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,SAAS,CAAC,MAAkB;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC;IAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,MAAM;QACN,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QAC7C,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACrD,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CACf,KAA4B,EAC5B,MAAkB,EAClB,IAAuB;IAEvB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC7F,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;QACvH,CAAC;QACD,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC/B,CAAC;YACD,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,mBAA4B,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;YACpG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACpH,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,CAAC;QACD,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,uEAAuE;YACvE,oEAAoE;YACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;YACjD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACzH,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC/B,CAAC;YACD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAC5E,wEAAwE;YACxE,uEAAuE;YACvE,MAAM,MAAM,GAAgB;gBAC1B,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBAC7I,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;aAC9D,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QACpI,CAAC;QACD;YACE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAAC,KAA4B,EAAE,MAAe;IAC3E,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;AAC7H,CAAC;AAED,SAAS,eAAe,CAAC,SAAqC;IAC5D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AACrH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,KAAiC;IAClF,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AACpH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,OAAO,KAAK,EAAE,EAAE,KAAK,QAAQ;QAC7C,CAAC,CAAC;YACE,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAc,EAAE,EAAE;gBACnF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC9B,OAAO,OAAO,KAAK,EAAE,EAAE,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxH,CAAC,CAAC;SACH;QACH,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AACpK,CAAC;AAED,SAAS,UAAU,CAAC,MAAkB;IACpC,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC/B,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,gCAAgC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAChH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,EAAE,OAAO,EAAE;QACnB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QACjH,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC"}

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"}