@rivet-dev/agentos-runtime-sidecar 0.0.0-agent-acp-codex-session-benchmark.62b1f46

package/README.md

@@ -0,0 +1,19 @@
+# @rivet-dev/agentos-runtime-sidecar
+
+Platform-specific resolver for the AgentOS native sidecar binary.
+
+The compiled `agentos-native-sidecar` binary ships inside one of the
+`@rivet-dev/agentos-runtime-sidecar-<platform>` packages. npm installs only the package
+matching the current `os`/`cpu`/`libc` at install time.
+
+```js
+const { getSidecarPath } = require("@rivet-dev/agentos-runtime-sidecar");
+
+const binaryPath = getSidecarPath();
+```
+
+Set `AGENTOS_SIDECAR_BIN` to an absolute path to override resolution for
+development or custom builds.
+
+Supported platforms: `linux-x64-gnu`, `linux-arm64-gnu`, `darwin-x64`,
+`darwin-arm64`.

package/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolve the absolute path to the prebuilt `agentos-native-sidecar` binary for
+ * the current platform.
+ *
+ * Resolution priority:
+ *   1. `AGENTOS_SIDECAR_BIN` env var.
+ *   2. A `agentos-native-sidecar` binary placed next to this package.
+ *   3. The platform-specific `@rivet-dev/agentos-runtime-sidecar-<platform>` package.
+ *
+ * @throws if the platform is unsupported or no binary can be found.
+ */
+export function getSidecarPath(): string;

package/index.js

@@ -0,0 +1,113 @@
+"use strict";
+
+// Platform-specific resolver for the prebuilt `agentos-native-sidecar` binary.
+// The binary itself ships inside one of the `@rivet-dev/agentos-runtime-sidecar-<platform>`
+// packages, declared as optionalDependencies at publish time so npm only
+// installs the package matching the current `os`/`cpu`/`libc`.
+//
+// Resolution priority:
+//   1. `AGENTOS_SIDECAR_BIN` env var.
+//   2. A `agentos-native-sidecar` binary placed next to this package.
+//   3. The platform-specific `@rivet-dev/agentos-runtime-sidecar-<platform>` package.
+
+const { existsSync } = require("node:fs");
+const { join, dirname } = require("node:path");
+
+const BINARY_BASENAME = "agentos-native-sidecar";
+
+// The on-disk binary name carries the `.exe` suffix on Windows; every other
+// platform ships an extension-less ELF/Mach-O binary.
+const BINARY_NAME =
+	process.platform === "win32" ? `${BINARY_BASENAME}.exe` : BINARY_BASENAME;
+
+// No runtime chmod. Platform packages are published with `npm publish`, which
+// preserves the binary's 0755 executable bit.
+
+// Detect whether the current Linux process links glibc or musl. Mirrors the
+// npm `libc` field used to gate the platform packages: glibc reports a glibc
+// version via `process.report`, musl does not.
+function detectLinuxLibc() {
+	try {
+		const report = process.report?.getReport?.();
+		const glibc = report?.header?.glibcVersionRuntime;
+		if (glibc) return "glibc";
+	} catch {
+		// fall through to filesystem probe
+	}
+	// Fallback: presence of the musl loader implies a musl userland.
+	if (existsSync("/lib/ld-musl-x86_64.so.1") || existsSync("/lib/ld-musl-aarch64.so.1")) {
+		return "musl";
+	}
+	return "glibc";
+}
+
+function getPlatformPackageName() {
+	const { platform, arch } = process;
+	switch (platform) {
+		case "linux": {
+			const libc = detectLinuxLibc();
+			if (arch === "x64")
+				return libc === "musl"
+					? "@rivet-dev/agentos-runtime-sidecar-linux-x64-musl"
+					: "@rivet-dev/agentos-runtime-sidecar-linux-x64-gnu";
+			if (arch === "arm64")
+				return libc === "musl"
+					? "@rivet-dev/agentos-runtime-sidecar-linux-arm64-musl"
+					: "@rivet-dev/agentos-runtime-sidecar-linux-arm64-gnu";
+			break;
+		}
+		case "darwin":
+			if (arch === "x64") return "@rivet-dev/agentos-runtime-sidecar-darwin-x64";
+			if (arch === "arm64") return "@rivet-dev/agentos-runtime-sidecar-darwin-arm64";
+			break;
+		case "win32":
+			if (arch === "x64") return "@rivet-dev/agentos-runtime-sidecar-windows-x64";
+			break;
+		default:
+			break;
+	}
+	return null;
+}
+
+function getSidecarPath() {
+	const override = process.env.AGENTOS_SIDECAR_BIN;
+	if (override) {
+		if (!existsSync(override)) {
+			throw new Error(
+				`AGENTOS_SIDECAR_BIN is set to ${override} but the file does not exist`,
+			);
+		}
+		return override;
+	}
+
+	const localBinary = join(__dirname, BINARY_NAME);
+	if (existsSync(localBinary)) {
+		return localBinary;
+	}
+
+	const platformPkg = getPlatformPackageName();
+	if (!platformPkg) {
+		throw new Error(
+			`@rivet-dev/agentos-runtime-sidecar: unsupported platform ${process.platform}/${process.arch}. ` +
+				"The AgentOS sidecar supports linux (x64/arm64, glibc/musl), " +
+				"macOS (x64/arm64), and Windows (x64). " +
+				"Set AGENTOS_SIDECAR_BIN to a local agentos-native-sidecar binary to override.",
+		);
+	}
+
+	let pkgJsonPath;
+	try {
+		pkgJsonPath = require.resolve(`${platformPkg}/package.json`);
+	} catch {
+		throw new Error(
+			`@rivet-dev/agentos-runtime-sidecar: platform package ${platformPkg} is not installed.\n` +
+				"This usually means the platform is unsupported or optionalDependencies were\n" +
+				`skipped during install. Try: npm install --include=optional ${platformPkg}\n` +
+				"Or set AGENTOS_SIDECAR_BIN to a local agentos-native-sidecar binary.",
+		);
+	}
+
+	return join(dirname(pkgJsonPath), BINARY_NAME);
+}
+
+module.exports = { getSidecarPath };

package/package.json

@@ -0,0 +1,31 @@
+{
+	"name": "@rivet-dev/agentos-runtime-sidecar",
+	"version": "0.0.0-agent-acp-codex-session-benchmark.62b1f46",
+	"description": "Platform-specific resolver for the Secure Exec native sidecar binary",
+	"license": "Apache-2.0",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/rivet-dev/secure-exec.git",
+		"directory": "packages/sidecar"
+	},
+	"main": "./index.js",
+	"types": "./index.d.ts",
+	"files": [
+		"index.js",
+		"index.d.ts",
+		"README.md"
+	],
+	"scripts": {
+		"check-types": "node -e \"process.exit(0)\"",
+		"test": "node --test tests/*.test.cjs"
+	},
+	"engines": {
+		"node": ">=20"
+	},
+	"optionalDependencies": {
+		"@rivet-dev/agentos-runtime-sidecar-darwin-arm64": "0.0.0-agent-acp-codex-session-benchmark.62b1f46",
+		"@rivet-dev/agentos-runtime-sidecar-darwin-x64": "0.0.0-agent-acp-codex-session-benchmark.62b1f46",
+		"@rivet-dev/agentos-runtime-sidecar-linux-arm64-gnu": "0.0.0-agent-acp-codex-session-benchmark.62b1f46",
+		"@rivet-dev/agentos-runtime-sidecar-linux-x64-gnu": "0.0.0-agent-acp-codex-session-benchmark.62b1f46"
+	}
+}