@botiverse/oar 0.15.1 → 0.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botiverse/oar",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "description": "A programming interface for all agent harnesses: provider-independent contracts for controlling and observing agent runtimes",
   "type": "module",
   "main": "./dist/index.js",
@@ -51,11 +51,12 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@agentclientprotocol/sdk": "^1.4.0",
-    "cross-spawn": "^7.0.6",
-    "which": "^2.0.2",
-    "@earendil-works/pi-coding-agent": "^1.0.0",
+    "@cursor/sdk": "1.0.35",
     "@earendil-works/pi-ai": "^1.0.0",
-    "undici": "8.10.2"
+    "@earendil-works/pi-coding-agent": "^1.0.0",
+    "cross-spawn": "^7.0.6",
+    "undici": "8.10.2",
+    "which": "^2.0.2"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",

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

@@ -1,19 +0,0 @@
-import type { AvailableInstallation } from "../../contracts/installation.js";
-import type { UpdateCheck, UpdateChecker, UpgradeOptions, UpgradeResult } from "../../contracts/update.js";
-/**
- * cursor-agent 2026.09.28 reports `latestVersion` and a `latestStatus` of
- * `up_to_date`, `update_available`, `disabled` (the `static` channel) or
- * `unavailable` in `about --format json`, without a login. Builds before it
- * (2026.08.11) report neither; for them the check asks the release service
- * cursor-agent's own updater asks, for the configured channel.
- */
-export declare function projectCursorAbout(installed: string, about: unknown): UpdateCheck;
-export interface CursorUpdateSources {
-    /** Connect RPC answering `{ channel }` with `{ version, url }`. */
-    readonly releases: string;
-    readonly configPath: () => string;
-}
-export declare function cursorUpdateCheck(from?: CursorUpdateSources): UpdateChecker;
-export declare const cursorCheckUpdate: UpdateChecker;
-export declare function cursorUpgrade(installation: AvailableInstallation, options?: UpgradeOptions): Promise<UpgradeResult>;
-//# sourceMappingURL=update.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/runtimes/cursor/update.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAsB,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAY/H;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAkBjF;AAED,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC;CACnC;AAsCD,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,mBAA6B,GAAG,aAAa,CAcpF;AAED,eAAO,MAAM,iBAAiB,eAAsB,CAAC;AAErD,wBAAsB,aAAa,CAAC,YAAY,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAGzH"}

package/dist/runtimes/cursor/update.js

@@ -1,88 +0,0 @@
-import { readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import path from "node:path";
-import { asRecord, parseJson } from "../../shared/json.js";
-import { CHECK_TIMEOUT_MS, comparedCheck, executableUpdate, runCheckCommand, upgradeExecutable, } from "../../shared/update.js";
-const SOURCE = "cursor-agent about --format json";
-/**
- * cursor-agent 2026.09.28 reports `latestVersion` and a `latestStatus` of
- * `up_to_date`, `update_available`, `disabled` (the `static` channel) or
- * `unavailable` in `about --format json`, without a login. Builds before it
- * (2026.08.11) report neither; for them the check asks the release service
- * cursor-agent's own updater asks, for the configured channel.
- */
-export function projectCursorAbout(installed, about) {
-    const fields = asRecord(about);
-    const status = fields?.latestStatus;
-    if (status === "disabled") {
-        return { kind: "unavailable", reason: "updates_disabled", detail: "cursor-agent is on the static channel", source: SOURCE };
-    }
-    const latest = fields?.latestVersion;
-    if (typeof latest !== "string" || status === "unavailable") {
-        return { kind: "unavailable", reason: "lookup_failed", detail: "cursor-agent reports no latest version", source: SOURCE };
-    }
-    const check = comparedCheck(installed, latest, SOURCE);
-    if (check.kind !== "ok") {
-        return check;
-    }
-    if (status === "update_available" || status === "up_to_date") {
-        return { ...check, updateAvailable: status === "update_available" };
-    }
-    return check;
-}
-const sources = {
-    releases: "https://api2.cursor.sh/aiserver.v1.DashboardService/GetCliDownloadUrl",
-    configPath: () => path.join(homedir(), ".cursor", "cli-config.json"),
-};
-function cursorChannel(configPath) {
-    try {
-        const channel = asRecord(parseJson(readFileSync(configPath, "utf8")))?.channel;
-        return typeof channel === "string" && channel !== "" ? channel : "prod";
-    }
-    catch {
-        return "prod";
-    }
-}
-async function releaseServiceCheck(installed, from, timeoutMs) {
-    const channel = cursorChannel(from.configPath());
-    if (channel === "static") {
-        return { kind: "unavailable", reason: "updates_disabled", detail: "cursor-agent is on the static channel" };
-    }
-    try {
-        const response = await fetch(from.releases, {
-            method: "POST",
-            headers: { "content-type": "application/json", "connect-protocol-version": "1" },
-            body: JSON.stringify({ channel }),
-            signal: AbortSignal.timeout(timeoutMs),
-        });
-        const version = asRecord(parseJson(await response.text()))?.version;
-        return response.ok && typeof version === "string"
-            ? comparedCheck(installed, version, from.releases, channel)
-            : { kind: "unavailable", reason: "lookup_failed", detail: `HTTP ${String(response.status)}`, source: from.releases };
-    }
-    catch (error) {
-        const detail = error instanceof Error ? error.message : String(error);
-        return { kind: "unavailable", reason: "lookup_failed", detail, source: from.releases };
-    }
-}
-export function cursorUpdateCheck(from = sources) {
-    return async (installation, options = {}) => {
-        const update = executableUpdate(installation);
-        if (update.kind === "unavailable") {
-            return update.check;
-        }
-        const timeoutMs = options.timeoutMs ?? CHECK_TIMEOUT_MS;
-        const { json } = await runCheckCommand(update.installation.command, ["about", "--format", "json"], timeoutMs);
-        const about = asRecord(json);
-        if (about !== null && about.latestStatus === undefined && about.latestVersion === undefined) {
-            return releaseServiceCheck(update.installed, from, timeoutMs);
-        }
-        return projectCursorAbout(update.installed, json);
-    };
-}
-export const cursorCheckUpdate = cursorUpdateCheck();
-export async function cursorUpgrade(installation, options) {
-    const result = await upgradeExecutable(installation, { check: cursorCheckUpdate, args: ["update"] }, options);
-    return result;
-}
-//# sourceMappingURL=update.js.map

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

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

package/dist/shared/acp/vendor-updates.d.ts

@@ -1,7 +0,0 @@
-import type { AnyMessage, SessionNotification } from "@agentclientprotocol/sdk";
-import { type JsonRecord } from "../json.js";
-/** A stream transform that carries the listed vendor update kinds past the SDK's parse. */
-export declare function vendorSessionUpdateCarrier(kinds: readonly string[]): TransformStream<AnyMessage, AnyMessage>;
-/** The vendor update a carried frame holds, or null for a standard one. */
-export declare function carriedVendorUpdate(notification: SessionNotification): JsonRecord | null;
-//# sourceMappingURL=vendor-updates.d.ts.map

package/dist/shared/acp/vendor-updates.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vendor-updates.d.ts","sourceRoot":"","sources":["../../../src/shared/acp/vendor-updates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AA6BvD,2FAA2F;AAC3F,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAQ5G;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,mBAAmB,GAAG,UAAU,GAAG,IAAI,CAOxF"}

package/dist/shared/acp/vendor-updates.js

@@ -1,46 +0,0 @@
-import { asRecord } from "../json.js";
-/**
- * Vendor `session/update` kinds the SDK would drop. SDK 1.4.0 parses every
- * `session/update` against a closed union of standard kinds and swallows the
- * frame when the parse fails ("Error handling notification"), so cursor-agent
- * 2026.09.28's `subagent_spawned` / `subagent_state_update` never reach a
- * handler. The frame is carried through as a standard `session_info_update`
- * whose `_meta` (an open record the SDK keeps as is) holds the original
- * update, and the recorder restores it. Renaming the method instead would
- * move the frame to another handler chain, which the SDK dispatches without
- * ordering against `session/update`; this way it stays in wire order.
- */
-const carrierKey = "oar/vendorSessionUpdate";
-function disguise(message, kinds) {
-    if (Array.isArray(message)) {
-        return message.map((item) => disguise(item, kinds));
-    }
-    const frame = asRecord(message);
-    const params = asRecord(frame?.params);
-    const update = asRecord(params?.update);
-    const kind = update?.sessionUpdate;
-    if (frame === null || frame.method !== "session/update" || params === null || typeof kind !== "string" || !kinds.has(kind)) {
-        return message;
-    }
-    return { ...frame, params: { ...params, update: { sessionUpdate: "session_info_update", _meta: { [carrierKey]: update } } } };
-}
-/** A stream transform that carries the listed vendor update kinds past the SDK's parse. */
-export function vendorSessionUpdateCarrier(kinds) {
-    const listed = new Set(kinds);
-    return new TransformStream({
-        transform(message, controller) {
-            // oxlint-disable-next-line typescript/consistent-type-assertions, typescript/no-unsafe-type-assertion -- Only the update payload changes; the JSON-RPC envelope keeps its shape.
-            controller.enqueue(listed.size === 0 ? message : disguise(message, listed));
-        },
-    });
-}
-/** The vendor update a carried frame holds, or null for a standard one. */
-export function carriedVendorUpdate(notification) {
-    const update = asRecord(notification.update);
-    if (update?.sessionUpdate !== "session_info_update") {
-        return null;
-    }
-    // oxlint-disable-next-line eslint/no-underscore-dangle -- `_meta` is the ACP extension envelope.
-    return asRecord(asRecord(update._meta)?.[carrierKey]);
-}
-//# sourceMappingURL=vendor-updates.js.map

package/dist/shared/acp/vendor-updates.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"vendor-updates.js","sourceRoot":"","sources":["../../../src/shared/acp/vendor-updates.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAE7C,SAAS,QAAQ,CAAC,OAAgB,EAAE,KAA0B;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,EAAE,aAAa,CAAC;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,gBAAgB,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3H,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,qBAAqB,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;AAChI,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,0BAA0B,CAAC,KAAwB;IACjE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,IAAI,eAAe,CAAyB;QACjD,SAAS,CAAC,OAAO,EAAE,UAAU;YAC3B,iLAAiL;YACjL,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAe,CAAC,CAAC;QAC5F,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,YAAiC;IACnE,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,EAAE,aAAa,KAAK,qBAAqB,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,iGAAiG;IACjG,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;AACxD,CAAC"}