Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

test(cua-driver): share binary selection with docs policy checks (#3748)

injaneity0fe7eb40dc00
diff --git a/.github/workflows/ci-check-docs.yml b/.github/workflows/ci-check-docs.yml
index 23fc7300fe..d1a78b3274 100644
--- a/.github/workflows/ci-check-docs.yml
+++ b/.github/workflows/ci-check-docs.yml
@@ -83,7 +83,7 @@ jobs:
run: node docs/node_modules/tsx/dist/cli.mjs scripts/docs-generators/runner.ts --library cua-driver --check
- name: Verify docs extraction preserves policy-filtered discovery
if: steps.scope.outputs.selected == 'true' && matrix.library == 'cua-driver'
- run: node docs/node_modules/tsx/dist/cli.mjs --test scripts/docs-generators/cua-driver-policy.test.ts
+ run: node docs/node_modules/tsx/dist/cli.mjs --test scripts/docs-generators/cua-driver-policy.test.ts scripts/docs-generators/cua-driver-policy-binary.test.ts
check-docs-sync:
name: Check Documentation Sync
diff --git a/scripts/docs-generators/cua-driver-policy-binary.test.ts b/scripts/docs-generators/cua-driver-policy-binary.test.ts
new file mode 100644
index 0000000000..f6c75e7f90
--- /dev/null
+++ b/scripts/docs-generators/cua-driver-policy-binary.test.ts
@@ -0,0 +1,37 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { cpSync, mkdirSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import test from 'node:test';
+import { resolveDriverBinary } from './cua-driver';
+
+test('native policy checks use the explicit binary without a default build', (t) => {
+ const directory = mkdtempSync(join(tmpdir(), 'cua-docs-binary-'));
+ t.after(() => rmSync(directory, { recursive: true, force: true }));
+ const source = join(directory, 'scripts', 'docs-generators');
+ cpSync(__dirname, source, { recursive: true });
+ mkdirSync(join(directory, 'libs', 'cua-driver', 'rust'), { recursive: true });
+ const result = spawnSync(
+ process.execPath,
+ [
+ ...process.execArgv,
+ '--test',
+ '--test-reporter=tap',
+ join(source, 'cua-driver-policy.test.ts'),
+ ],
+ {
+ cwd: directory,
+ env: {
+ ...process.env,
+ NODE_TEST_CONTEXT: undefined,
+ CUA_DRIVER_BINARY: resolve(resolveDriverBinary()),
+ },
+ encoding: 'utf8',
+ timeout: 60_000,
+ }
+ );
+ assert.ifError(result.error);
+ assert.equal(result.status, 0, result.stdout + result.stderr);
+ assert.match(result.stdout, /^# pass 1\r?$/m);
+});
diff --git a/scripts/docs-generators/cua-driver-policy.test.ts b/scripts/docs-generators/cua-driver-policy.test.ts
index 9b5b198992..9b89d47272 100644
--- a/scripts/docs-generators/cua-driver-policy.test.ts
+++ b/scripts/docs-generators/cua-driver-policy.test.ts
@@ -2,9 +2,9 @@ import assert from 'node:assert/strict';
import { execFileSync } from 'node:child_process';
import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
import { tmpdir } from 'node:os';
-import { join, resolve } from 'node:path';
+import { join } from 'node:path';
import test from 'node:test';
-import { extractDocumentation, type DumpDocsOutput } from './cua-driver';
+import { extractDocumentation, resolveDriverBinary, type DumpDocsOutput } from './cua-driver';
test('native docs are complete while ordinary discovery remains policy-filtered', (t) => {
const directory = mkdtempSync(join(tmpdir(), 'cua-docs-policy-'));
@@ -12,11 +12,7 @@ test('native docs are complete while ordinary discovery remains policy-filtered'
const policy = join(directory, 'policy.yaml');
const content = 'allow:\n tools: [get_window_state]\n';
writeFileSync(policy, content);
- const binary = resolve(
- __dirname,
- '../../libs/cua-driver/rust/target/release',
- process.platform === 'win32' ? 'cua-driver.exe' : 'cua-driver'
- );
+ const binary = resolveDriverBinary();
const environment = {
...process.env,
CUA_DRIVER_POLICY_FILE: policy,
diff --git a/scripts/docs-generators/cua-driver.ts b/scripts/docs-generators/cua-driver.ts
index d1b1a5410e..27d607b0e4 100644
--- a/scripts/docs-generators/cua-driver.ts
+++ b/scripts/docs-generators/cua-driver.ts
@@ -114,6 +114,10 @@ const CUA_DRIVER_BIN = path.join(
const DOCS_OUTPUT_DIR = path.join(ROOT_DIR, 'docs', 'content', 'docs', 'reference', 'cua-driver');
const TAG_PREFIX = 'cua-driver-rs-v';
+export function resolveDriverBinary(): string {
+ return process.env.CUA_DRIVER_BINARY || CUA_DRIVER_BIN;
+}
+
export type GitRunner = (command: string, args: readonly string[]) => string;
// ============================================================================
@@ -226,7 +230,7 @@ async function main() {
// Step 2: Extract all docs in a single invocation
console.log('\nExtracting documentation...');
- const binary = process.env.CUA_DRIVER_BINARY || CUA_DRIVER_BIN;
+ const binary = resolveDriverBinary();
const dumpDocs = extractDocumentation(binary);
console.log(` Found ${dumpDocs.cli.commands.length} CLI commands`);
console.log(` Found ${dumpDocs.mcp.tools.length} MCP tools`);