@rivet-dev/agentos-sidecar 0.0.0-agentos-dylib-plugin.473700e

package/README.md

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

package/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolve the absolute path to the prebuilt `agentos-sidecar` binary for the
+ * current platform.
+ *
+ * Resolution priority:
+ *   1. `AGENTOS_SIDECAR_BIN` env var (absolute path override).
+ *   2. A `agentos-sidecar` binary placed next to this package (dev builds).
+ *   3. The platform-specific `@rivet-dev/agentos-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,76 @@
+"use strict";
+
+// Platform-specific resolver for the prebuilt `agentos-sidecar` binary. The
+// binary itself ships inside one of the `@rivet-dev/agentos-sidecar-<platform>`
+// packages, declared as optionalDependencies so npm only installs the one
+// matching the current `os`/`cpu`/`libc` at install time.
+//
+// Resolution priority:
+//   1. `AGENTOS_SIDECAR_BIN` env var (absolute path override).
+//   2. A `agentos-sidecar` binary placed next to this package (dev builds).
+//   3. The platform-specific `@rivet-dev/agentos-sidecar-<platform>` package.
+
+const { existsSync } = require("node:fs");
+const { join, dirname } = require("node:path");
+
+const BINARY_NAME = "agentos-sidecar";
+
+// No runtime chmod: the platform packages are published with `npm publish`,
+// which preserves the binary's 0755 executable bit (pnpm publish would strip
+// it to 0644). This mirrors how @rivetkit/engine-cli ships rivet-engine. See
+// the "Native Binary Distribution" section in CLAUDE.md.
+
+function getPlatformPackageName() {
+	const { platform, arch } = process;
+	switch (platform) {
+		case "linux":
+			if (arch === "x64") return "@rivet-dev/agentos-sidecar-linux-x64-gnu";
+			if (arch === "arm64") return "@rivet-dev/agentos-sidecar-linux-arm64-gnu";
+			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-sidecar: unsupported platform ${process.platform}/${process.arch}. ` +
+				"The Agent OS sidecar currently supports linux x64 and arm64. " +
+				"Set AGENTOS_SIDECAR_BIN to a local agentos-sidecar binary to override.",
+		);
+	}
+
+	let pkgJsonPath;
+	try {
+		pkgJsonPath = require.resolve(`${platformPkg}/package.json`);
+	} catch {
+		throw new Error(
+			`@rivet-dev/agentos-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-sidecar binary.",
+		);
+	}
+
+	return join(dirname(pkgJsonPath), BINARY_NAME);
+}
+
+module.exports = { getSidecarPath };

package/package.json

@@ -0,0 +1,24 @@
+{
+	"name": "@rivet-dev/agentos-sidecar",
+	"version": "0.0.0-agentos-dylib-plugin.473700e",
+	"description": "Platform-specific resolver for the Agent OS native sidecar binary",
+	"license": "Apache-2.0",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/rivet-dev/agent-os.git",
+		"directory": "packages/sidecar-binary"
+	},
+	"main": "./index.js",
+	"types": "./index.d.ts",
+	"files": [
+		"index.js",
+		"index.d.ts",
+		"README.md"
+	],
+	"engines": {
+		"node": ">=20"
+	},
+	"optionalDependencies": {
+		"@rivet-dev/agentos-sidecar-linux-x64-gnu": "0.0.0-agentos-dylib-plugin.473700e"
+	}
+}