Skip to content

A self-improving RLM agent for coding workflows and long-running autonomous tasks.

Rust

embed clipboard addon in native binaries (#2369)

kt8d64d3e1cd1b
diff --git a/packages/coding-agent/.changes/bun-clipboard-image-paste.md b/packages/coding-agent/.changes/bun-clipboard-image-paste.md
new file mode 100644
index 0000000000..c8d83b42c2
--- /dev/null
+++ b/packages/coding-agent/.changes/bun-clipboard-image-paste.md
@@ -0,0 +1 @@
+- Fixed image paste in standalone macOS and glibc releases by embedding the available platform clipboard addon.
diff --git a/packages/coding-agent/scripts/build-binary.mjs b/packages/coding-agent/scripts/build-binary.mjs
index e0105792b9..14d49566de 100644
--- a/packages/coding-agent/scripts/build-binary.mjs
+++ b/packages/coding-agent/scripts/build-binary.mjs
@@ -4,6 +4,7 @@ import { mkdirSync, mkdtempSync, renameSync, rmSync } from "node:fs";
import { dirname, join, resolve } from "node:path";
import { fileURLToPath } from "node:url";
import { releasePlatforms } from "../../../scripts/release-platforms.mjs";
+import { writeClipboardBinaryBinding } from "./clipboard-binary-binding.mjs";
import { copyBinaryAssets, validateBinaryAssets } from "./copy-binary-assets.mjs";
import { signMacosBinary } from "./macos-signature.mjs";
@@ -35,6 +36,7 @@ mkdirSync(outputRoot, { recursive: true });
for (const target of platform === "all" ? platforms : [platform]) {
const staging = mkdtempSync(join(outputRoot, ".build-"));
try {
+ writeClipboardBinaryBinding(join(packageDir, "dist/utils/clipboard-binary-binding.js"), target);
execFileSync(
bun,
[
diff --git a/packages/coding-agent/scripts/clipboard-binary-binding.d.mts b/packages/coding-agent/scripts/clipboard-binary-binding.d.mts
new file mode 100644
index 0000000000..cb2c36c36a
--- /dev/null
+++ b/packages/coding-agent/scripts/clipboard-binary-binding.d.mts
@@ -0,0 +1,3 @@
+export const clipboardNativePackageByPlatform: Readonly<Record<string, string | null>>;
+
+export function writeClipboardBinaryBinding(path: string, platform: string): void;
diff --git a/packages/coding-agent/scripts/clipboard-binary-binding.mjs b/packages/coding-agent/scripts/clipboard-binary-binding.mjs
new file mode 100644
index 0000000000..2e54db3de8
--- /dev/null
+++ b/packages/coding-agent/scripts/clipboard-binary-binding.mjs
@@ -0,0 +1,22 @@
+import { writeFileSync } from "node:fs";
+import { releasePlatforms } from "../../../scripts/release-platforms.mjs";
+
+export const clipboardNativePackageByPlatform = {
+ "darwin-arm64": "@mariozechner/clipboard-darwin-arm64",
+ "darwin-x64": "@mariozechner/clipboard-darwin-x64",
+ "linux-arm64": "@mariozechner/clipboard-linux-arm64-gnu",
+ // The published musl packages contain no native addon, so these builds retain the system-command fallback.
+ "linux-arm64-musl": null,
+ "linux-x64": "@mariozechner/clipboard-linux-x64-gnu",
+ "linux-x64-baseline": "@mariozechner/clipboard-linux-x64-gnu",
+ "linux-x64-musl": null,
+ "linux-x64-musl-baseline": null,
+};
+
+export function writeClipboardBinaryBinding(path, platform) {
+ if (!releasePlatforms.includes(platform)) throw new Error(`Unsupported binary platform: ${platform}`);
+ const packageName = clipboardNativePackageByPlatform[platform];
+ if (packageName === undefined) throw new Error(`Missing clipboard native package mapping: ${platform}`);
+ const binding = packageName ? `require(${JSON.stringify(packageName)})` : "null";
+ writeFileSync(path, `export function loadBundledClipboard() {\n\treturn ${binding};\n}\n`);
+}
diff --git a/packages/coding-agent/src/utils/clipboard-binary-binding.ts b/packages/coding-agent/src/utils/clipboard-binary-binding.ts
new file mode 100644
index 0000000000..57cdaf0235
--- /dev/null
+++ b/packages/coding-agent/src/utils/clipboard-binary-binding.ts
@@ -0,0 +1,9 @@
+export type ClipboardModule = {
+ setText: (text: string) => Promise<void>;
+ hasImage: () => boolean;
+ getImageBinary: () => Promise<Array<number>>;
+};
+
+export function loadBundledClipboard(): ClipboardModule | null {
+ return null;
+}
diff --git a/packages/coding-agent/src/utils/clipboard-native.ts b/packages/coding-agent/src/utils/clipboard-native.ts
index bcdbdfa87a..2a4dd89c65 100644
--- a/packages/coding-agent/src/utils/clipboard-native.ts
+++ b/packages/coding-agent/src/utils/clipboard-native.ts
@@ -1,10 +1,5 @@
import { createRequire } from "module";
-
-export type ClipboardModule = {
- setText: (text: string) => Promise<void>;
- hasImage: () => boolean;
- getImageBinary: () => Promise<Array<number>>;
-};
+import { type ClipboardModule, loadBundledClipboard } from "./clipboard-binary-binding.js";
const require = createRequire(import.meta.url);
let clipboard: ClipboardModule | null = null;
@@ -13,7 +8,7 @@ const hasDisplay = process.platform !== "linux" || Boolean(process.env.DISPLAY |
if (!process.env.TERMUX_VERSION && hasDisplay) {
try {
- clipboard = require("@mariozechner/clipboard") as ClipboardModule;
+ clipboard = loadBundledClipboard() ?? (require("@mariozechner/clipboard") as ClipboardModule);
} catch {
clipboard = null;
}
diff --git a/packages/coding-agent/test/clipboard-binary-binding.test.ts b/packages/coding-agent/test/clipboard-binary-binding.test.ts
new file mode 100644
index 0000000000..e4ff94e263
--- /dev/null
+++ b/packages/coding-agent/test/clipboard-binary-binding.test.ts
@@ -0,0 +1,51 @@
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { clipboardNativePackageByPlatform, writeClipboardBinaryBinding } from "../scripts/clipboard-binary-binding.mjs";
+import { NATIVE_PLATFORMS } from "../src/utils/native-installation.js";
+
+const platforms = [...NATIVE_PLATFORMS];
+const bundledPlatforms = platforms.filter((platform) => clipboardNativePackageByPlatform[platform] !== null);
+const unbundledPlatforms = platforms.filter((platform) => clipboardNativePackageByPlatform[platform] === null);
+
+let directory: string | undefined;
+
+afterEach(() => {
+ if (directory) rmSync(directory, { recursive: true, force: true });
+ directory = undefined;
+});
+
+describe("standalone clipboard binding", () => {
+ it("maps every standalone target to a native clipboard package", () => {
+ expect(Object.keys(clipboardNativePackageByPlatform)).toEqual(platforms);
+ });
+
+ it.each(bundledPlatforms)("generates a static native require for %s", (platform) => {
+ directory = mkdtempSync(join(tmpdir(), "prime-clipboard-binding-"));
+ const output = join(directory, "clipboard-binary-binding.js");
+ writeClipboardBinaryBinding(output, platform);
+ expect(readFileSync(output, "utf8")).toBe(
+ `export function loadBundledClipboard() {\n\treturn require(${JSON.stringify(clipboardNativePackageByPlatform[platform])});\n}\n`,
+ );
+ });
+
+ it("generates the fallback loader when no native musl binding is published", () => {
+ expect(unbundledPlatforms).toEqual(["linux-arm64-musl", "linux-x64-musl", "linux-x64-musl-baseline"]);
+ for (const platform of unbundledPlatforms) {
+ directory = mkdtempSync(join(tmpdir(), "prime-clipboard-binding-"));
+ const output = join(directory, "clipboard-binary-binding.js");
+ writeClipboardBinaryBinding(output, platform);
+ expect(readFileSync(output, "utf8")).toBe("export function loadBundledClipboard() {\n\treturn null;\n}\n");
+ rmSync(directory, { recursive: true, force: true });
+ directory = undefined;
+ }
+ });
+
+ it("rejects unsupported targets", () => {
+ directory = mkdtempSync(join(tmpdir(), "prime-clipboard-binding-"));
+ expect(() => writeClipboardBinaryBinding(join(directory!, "binding.js"), "windows-x64")).toThrow(
+ "Unsupported binary platform",
+ );
+ });
+});