@robota-sdk/agent-cli 3.0.0-beta.10 → 3.0.0-beta.101

package/scripts/native-build.d.mts

@@ -0,0 +1,19 @@
+export interface IProductNativeBuildOptions {
+  /** Absolute consumer-owned JavaScript entry; it must create the same product host on re-entry. */
+  readonly entry: string;
+  /** Absolute destination for the executable. */
+  readonly outfile: string;
+  readonly version: string;
+  readonly sourceVersion?: string;
+  readonly buildMetadata?: string | null;
+  /** Absolute consumer-maintained third-party notice file, copied beside the executable. */
+  readonly noticesFile: string;
+  /** Optional matching host target; cross-host addon packaging is refused. */
+  readonly target?: 'darwin-arm64' | 'darwin-x64' | 'linux-arm64' | 'linux-x64' | 'windows-x64';
+}
+
+export function buildProductNativeBinary(options: IProductNativeBuildOptions): Promise<{
+  readonly binary: string;
+  readonly notices: string;
+  readonly target: string;
+}>;

package/scripts/native-build.mjs

@@ -0,0 +1,72 @@
+import { chmodSync, copyFileSync, existsSync, mkdirSync, statSync } from 'node:fs';
+import { dirname, isAbsolute } from 'node:path';
+import { createRequire } from 'node:module';
+
+import { createKoffiBunPlugin } from './koffi-bun-plugin.mjs';
+
+const TARGETS = Object.freeze({
+  'darwin-arm64': 'bun-darwin-arm64',
+  'darwin-x64': 'bun-darwin-x64',
+  'linux-arm64': 'bun-linux-arm64',
+  'linux-x64': 'bun-linux-x64',
+  'windows-x64': 'bun-windows-x64',
+});
+
+const stubReactDevtools = {
+  name: 'stub-react-devtools',
+  setup(build) {
+    build.onResolve({ filter: /^react-devtools-core$/ }, () => ({
+      path: 'rdc', namespace: 'stub-rdc',
+    }));
+    build.onLoad({ filter: /.*/, namespace: 'stub-rdc' }, () => ({
+      contents: 'export default {}; export function connectToDevTools(){}', loader: 'js',
+    }));
+  },
+};
+
+/**
+ * Compile a consumer-owned CLI entry against installed npm dependencies. The entry must call
+ * createProductCliHost on every process start, including daemon and worker re-entry.
+ * Run this function under Bun on the target host after qualifying native-addon GC.
+ */
+export async function buildProductNativeBinary(options) {
+  if (!process.versions.bun) throw new Error('Native CLI packaging requires Bun.');
+  const { entry, outfile, version, noticesFile } = options;
+  if (![entry, outfile, noticesFile].every((path) => typeof path === 'string' && isAbsolute(path)))
+    throw new Error('Entry, output and notices paths must be absolute.');
+  if (!existsSync(entry)) throw new Error('Consumer entry is missing.');
+  if (!existsSync(noticesFile) || !statSync(noticesFile).isFile() || statSync(noticesFile).size === 0)
+    throw new Error('Non-empty third-party notices file is required.');
+  if (typeof version !== 'string' || version.trim() === '') throw new Error('Artifact version is required.');
+  const host = `${process.platform === 'win32' ? 'windows' : process.platform}-${process.arch}`;
+  if (!Object.hasOwn(TARGETS, host)) throw new Error(`Unsupported native CLI host: ${host}.`);
+  if (options.target !== undefined && options.target !== host)
+    throw new Error(`Native CLI packaging requires matching host ${host}.`);
+  try {
+    createRequire(new URL('../package.json', import.meta.url)).resolve('e2b/dist/index.mjs');
+  } catch (cause) {
+    throw new Error(
+      'Native CLI packaging includes the E2B hosted capability; install e2b@2.51.0 alongside @robota-sdk/agent-cli before building.',
+      { cause },
+    );
+  }
+  await import('./qualify-koffi-gc.mjs');
+  mkdirSync(dirname(outfile), { recursive: true });
+  const result = await Bun.build({
+    entrypoints: [entry],
+    target: 'bun',
+    compile: { target: TARGETS[host], outfile },
+    define: {
+      __AGENT_VERSION__: JSON.stringify(version),
+      __AGENT_SOURCE_VERSION__: JSON.stringify(options.sourceVersion ?? version),
+      __AGENT_BUILD_METADATA__: JSON.stringify(options.buildMetadata ?? null),
+    },
+    plugins: [stubReactDevtools, createKoffiBunPlugin(`${process.platform}-${process.arch}`, new URL('../package.json', import.meta.url))],
+  });
+  if (!result.success || !existsSync(outfile))
+    throw new Error(`Native CLI packaging failed: ${result.logs.map(String).join('\n')}`);
+  chmodSync(outfile, 0o755);
+  const noticesOutput = `${outfile}.THIRD_PARTY_NOTICES.txt`;
+  copyFileSync(noticesFile, noticesOutput);
+  return Object.freeze({ binary: outfile, notices: noticesOutput, target: host });
+}

package/scripts/qualify-koffi-gc.mjs

@@ -0,0 +1,28 @@
+import assert from 'node:assert/strict';
+
+import koffi from 'koffi';
+
+if (!process.versions.bun) throw new Error('Native addon GC qualification requires Bun.');
+
+function releaseNativeFunction() {
+  const library = koffi.load(
+    process.platform === 'win32'
+      ? 'kernel32.dll'
+      : process.platform === 'darwin'
+        ? '/usr/lib/libSystem.B.dylib'
+        : 'libc.so.6',
+  );
+  const pid = library.func(
+    process.platform === 'win32' ? 'uint32_t __stdcall GetCurrentProcessId()' : 'int getpid()',
+  );
+  assert.equal(pid(), process.pid);
+}
+
+// Bun <= 1.3.14 aborts when Koffi releases an N-API reference during GC.
+// Exercise real addon finalizers before accepting this engine for standalone builds.
+for (let index = 0; index < 3; index++) releaseNativeFunction();
+for (let index = 0; index < 3; index++) {
+  globalThis.Bun.gc(true);
+  await new Promise((resolve) => setTimeout(resolve, 0));
+}
+console.log('Native addon GC qualification passed.');