@botiverse/oar 0.10.3 → 0.11.0

package/dist/shared/update.js

@@ -0,0 +1,139 @@
+import { realpathSync } from "node:fs";
+import { readExecutableVersion, runIsolated } from "./executable/index.js";
+import { parseJson } from "./json.js";
+export const CHECK_TIMEOUT_MS = 20_000;
+const UPGRADE_TIMEOUT_MS = 600_000;
+/** The slowest installation probes (cursor, kimi) allow 30 s for `--version`; a kimi start after an upgrade also swaps the staged binary in. */
+const VERSION_TIMEOUT_MS = 30_000;
+/** The release version inside a `--version` line or release pointer: a cursor date build or a semver. */
+export function releaseVersion(text) {
+    return /\b\d{4}\.\d{2}\.\d{2}-[\da-f]+\b/u.exec(text)?.[0]
+        ?? /\b\d+\.\d+\.\d+(?:-[\w.]+)?\b/u.exec(text)?.[0];
+}
+function numericParts(value) {
+    const release = value.split("-")[0] ?? "";
+    return release.split(".").map(Number);
+}
+/** Numeric `major.minor.patch` order; prerelease tags are ignored. */
+export function versionAtLeast(version, floor) {
+    const [left, right] = [numericParts(version), numericParts(floor)];
+    for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+        const difference = (left[index] ?? 0) - (right[index] ?? 0);
+        if (difference !== 0) {
+            return difference > 0;
+        }
+    }
+    return true;
+}
+const SCRIPT_CONTEXT = /^npm_(?:config_user_agent|lifecycle_|package_|execpath$|node_execpath$|command$)/iu;
+/**
+ * The host environment without the markers a package script run (`npm run`,
+ * `pnpm run`) adds: given `npm_config_user_agent`, grok 1.0.46 treats a
+ * script install as npm-managed and installs a second copy. npm
+ * configuration itself (such as the prefix) stays: npm-method updaters
+ * should honor it, and the version read-back catches an update that went to
+ * another prefix.
+ */
+export function updaterEnv(env = process.env) {
+    return Object.fromEntries(Object.entries(env).filter(([key]) => !SCRIPT_CONTEXT.test(key)));
+}
+/** The executable and its installed release version, or why a check cannot start. */
+export function executableUpdate(installation) {
+    if (installation.via !== "executable") {
+        return {
+            kind: "unavailable",
+            check: { kind: "unavailable", reason: "unsupported_installation", detail: "bundled with oar; it moves with the oar version" },
+        };
+    }
+    const installed = installation.version === undefined ? undefined : releaseVersion(installation.version);
+    if (installed === undefined) {
+        return {
+            kind: "unavailable",
+            check: { kind: "unavailable", reason: "version_unreadable", detail: `${installation.command} --version gave no release version` },
+        };
+    }
+    return { kind: "executable", installation, installed };
+}
+/** The executable's real path with `/` separators, for install-layout tests. */
+export function installedPath(command) {
+    try {
+        return realpathSync(command).replaceAll("\\", "/");
+    }
+    catch {
+        return command.replaceAll("\\", "/");
+    }
+}
+/** A check from an installed and a released version, when the runtime gives no verdict of its own. */
+export function comparedCheck(installed, released, source, channel) {
+    const latest = releaseVersion(released);
+    if (latest === undefined) {
+        return { kind: "unavailable", reason: "version_unreadable", detail: `no release version in ${JSON.stringify(released.slice(0, 80))}`, source };
+    }
+    return {
+        kind: "ok",
+        installed,
+        latest,
+        updateAvailable: latest !== installed,
+        ...(channel === undefined ? {} : { channel }),
+        source,
+    };
+}
+/** GET one release source; failures come back as the check's `lookup_failed`. */
+export async function readReleaseSource(url, timeoutMs) {
+    try {
+        const response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+        if (!response.ok) {
+            return { ok: false, check: { kind: "unavailable", reason: "lookup_failed", detail: `HTTP ${String(response.status)}`, source: url } };
+        }
+        return { ok: true, text: await response.text() };
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return { ok: false, check: { kind: "unavailable", reason: "lookup_failed", detail, source: url } };
+    }
+}
+/** Run one of the runtime's own check commands, read only, with the updater environment. */
+export async function runCheckCommand(command, args, timeoutMs) {
+    const result = await runIsolated(command, args, { env: updaterEnv(), timeoutMs });
+    return { result, json: parseJson(result.stdout) };
+}
+async function versionNow(command) {
+    try {
+        const raw = await readExecutableVersion(command, VERSION_TIMEOUT_MS);
+        return raw === undefined ? undefined : releaseVersion(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+function runOutput(run, timeoutMs) {
+    const output = `${run.stdout}${run.stderr}`;
+    return run.timedOut ? `${output}\n[oar: stopped the updater after ${String(timeoutMs)} ms]\n` : output;
+}
+/**
+ * Check, then run the runtime's own updater on the same executable and judge
+ * the outcome by the version it reports afterwards. The updater runs only
+ * when the check does not already say the installation is current.
+ */
+export async function upgradeExecutable(installation, updater, options = {}) {
+    if (installation.via !== "executable") {
+        return { kind: "unsupported", reason: "unsupported_installation", detail: "bundled with oar; it moves with the oar version" };
+    }
+    const check = await updater.check(installation, options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs });
+    if (check.kind === "ok" && !check.updateAvailable) {
+        return { kind: "current", version: check.installed, check };
+    }
+    const before = check.kind === "ok" ? check.installed : await versionNow(installation.command);
+    const timeoutMs = options.timeoutMs ?? UPGRADE_TIMEOUT_MS;
+    const run = await runIsolated(installation.command, updater.args, { env: updaterEnv(), timeoutMs });
+    const output = runOutput(run, timeoutMs);
+    const after = await versionNow(installation.command);
+    if (before !== undefined && after !== undefined && after !== before) {
+        return { kind: "upgraded", from: before, to: after, output };
+    }
+    if (run.exitCode !== 0 || after === undefined) {
+        return { kind: "failed", exitCode: run.exitCode, output };
+    }
+    return { kind: "unchanged", version: after, output };
+}
+//# sourceMappingURL=update.js.map

package/dist/shared/update.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botiverse/oar",
-  "version": "0.10.3",
+  "version": "0.11.0",
   "description": "A programming interface for all agent harnesses: provider-independent contracts for controlling and observing agent runtimes",
   "type": "module",
   "main": "./dist/index.js",