cyclops-clientdevbridge-cli 0.1.1

package/dist/snapshot/outline.js

@@ -0,0 +1,135 @@
+import { centre, flatten, label, simpleType } from './model.js';
+/**
+ * Renders a snapshot as one line per widget, indented by depth.
+ *
+ * This is the format an agent actually reads, so it is optimised for scanning: the type and label
+ * first, then the geometry it would need to click, then only the flags that are *not* the default.
+ * A line looks like:
+ *
+ * ```
+ *   Button "Apply" @(312,208 60x20) disabled  /root/children[3]
+ * ```
+ *
+ * The trailing path is what `click --widget` consumes, so an outline line can be copied verbatim.
+ */
+export function formatOutline(snapshot, options = {}) {
+    const lines = [];
+    if (snapshot.screenClass === null) {
+        lines.push('No screen is open.');
+        lines.push(`window ${snapshot.pixelWidth}x${snapshot.pixelHeight}px, gui ${snapshot.guiWidth}x${snapshot.guiHeight} @ scale ${snapshot.guiScale}`);
+        return lines.join('\n');
+    }
+    lines.push(`${simpleType({ type: snapshot.screenClass })}  "${snapshot.title ?? ''}"`);
+    lines.push(`gui ${snapshot.guiWidth}x${snapshot.guiHeight} @ scale ${snapshot.guiScale}` +
+        `, window ${snapshot.pixelWidth}x${snapshot.pixelHeight}px` +
+        `, mouse at ${snapshot.mouse.join(',')}`);
+    if (snapshot.container !== null) {
+        const container = snapshot.container;
+        const filled = container.slots.filter((slot) => slot.item !== null).length;
+        lines.push(`container ${simpleType({ type: container.menuClass })}` +
+            ` at (${container.leftPos},${container.topPos}) ${container.imageWidth}x${container.imageHeight}` +
+            `, ${container.slots.length} slots (${filled} filled)`);
+        for (const slot of container.slots) {
+            if (slot.item === null && !slot.hovered) {
+                continue;
+            }
+            lines.push(`  ${formatSlot(slot)}`);
+        }
+        if (container.carried.item !== null) {
+            lines.push(`  carried: ${container.carried.item} x${container.carried.count}`);
+        }
+    }
+    const nodes = flatten(snapshot.root);
+    // The root node is the screen itself, already summarised above.
+    for (const { node, depth } of nodes.slice(1)) {
+        if (!node.visible && options.includeHidden !== true) {
+            continue;
+        }
+        lines.push(`${'  '.repeat(depth)}${formatNode(node)}`);
+    }
+    if (nodes.length <= 1 && snapshot.container === null) {
+        lines.push('(this screen has no widgets)');
+    }
+    if (snapshot.truncated) {
+        lines.push('# truncated: the widget tree hit the depth or node limit');
+    }
+    return lines.join('\n');
+}
+export function formatSlot(slot) {
+    const item = slot.item === null ? '(empty)' : `${slot.item} x${slot.count}`;
+    const flags = slot.hovered ? ' hovered' : '';
+    return `slot ${String(slot.index).padStart(2)} ${item} @(${slot.x},${slot.y})${flags}`;
+}
+export function formatNode(node) {
+    const parts = [simpleType(node)];
+    const text = label(node);
+    if (text.length > 0) {
+        parts.push(`"${text}"`);
+    }
+    if (node.bounds !== null) {
+        parts.push(`@(${node.bounds.x},${node.bounds.y} ${node.bounds.w}x${node.bounds.h})`);
+    }
+    else {
+        parts.push('@(unknown)');
+    }
+    if (node.value !== null && node.value !== undefined) {
+        parts.push(`= ${formatValue(node.value)}`);
+    }
+    // Only the states that differ from the default are worth a reader's attention.
+    if (!node.active) {
+        parts.push('disabled');
+    }
+    if (!node.visible) {
+        parts.push('hidden');
+    }
+    if (node.focused) {
+        parts.push('focused');
+    }
+    if (node.hovered) {
+        parts.push('hovered');
+    }
+    const tooltip = node.extra['tooltip'];
+    if (Array.isArray(tooltip) && tooltip.length > 0) {
+        parts.push(`tooltip="${tooltip.join(' / ')}"`);
+    }
+    parts.push(` ${node.path}`);
+    return parts.join(' ');
+}
+function formatValue(value) {
+    if (typeof value === 'string') {
+        return `"${value}"`;
+    }
+    if (typeof value === 'number') {
+        return Number.isInteger(value) ? String(value) : value.toFixed(3);
+    }
+    return JSON.stringify(value);
+}
+/**
+ * Finds nodes by label, by path, or by type.
+ *
+ * An exact path match wins outright, then an exact label match, then a case-insensitive
+ * substring match — so `click --widget Apply` picks the "Apply" button even on a screen that
+ * also has an "Apply to all" one.
+ */
+export function findNodes(snapshot, query, typeFilter) {
+    const all = flatten(snapshot.root).map(({ node }) => node);
+    const candidates = typeFilter === undefined
+        ? all
+        : all.filter((node) => simpleType(node).toLowerCase().includes(typeFilter.toLowerCase()));
+    const byPath = candidates.filter((node) => node.path === query);
+    if (byPath.length > 0) {
+        return byPath.map(toMatch);
+    }
+    const lowered = query.toLowerCase();
+    const exact = candidates.filter((node) => label(node).toLowerCase() === lowered);
+    if (exact.length > 0) {
+        return exact.map(toMatch);
+    }
+    return candidates
+        .filter((node) => label(node).toLowerCase().includes(lowered) || simpleType(node).toLowerCase() === lowered)
+        .map(toMatch);
+}
+function toMatch(node) {
+    return { node, centre: centre(node) };
+}
+//# sourceMappingURL=outline.js.map

package/dist/snapshot/outline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.js","sourceRoot":"","sources":["../../src/snapshot/outline.ts"],"names":[],"mappings":"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"}

package/dist/xvfb.d.ts

@@ -0,0 +1,30 @@
+export interface DisplayPlan {
+    /** The command to run, which may be `xvfb-run` wrapping the real one. */
+    readonly command: string;
+    readonly prefixArgs: readonly string[];
+    readonly env: Readonly<Record<string, string>>;
+    readonly description: string;
+}
+export declare function commandExists(command: string): boolean;
+/**
+ * Decides how to give the client a display.
+ *
+ * "Headless" here means a real client on a virtual display, not a client without rendering:
+ * on Linux without `$DISPLAY` that is Xvfb plus Mesa's llvmpipe software rasteriser. Everywhere
+ * else, and with `--headed`, the client just opens a window. Nothing else about the CLI's
+ * behaviour differs between the two.
+ */
+export declare function planDisplay(command: string, options: {
+    headed: boolean;
+    width: number;
+    height: number;
+}): DisplayPlan;
+/**
+ * The pids of every Xvfb server currently running.
+ *
+ * `xvfb-run` picks a free display itself and never says which, so the only way to know what it
+ * started is to look before and after. Anything that appears in between is what this launch is
+ * responsible for cleaning up.
+ */
+export declare function xvfbPids(): number[];
+//# sourceMappingURL=xvfb.d.ts.map

package/dist/xvfb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xvfb.d.ts","sourceRoot":"","sources":["../src/xvfb.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOtD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D,WAAW,CA+Bb;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,IAAI,MAAM,EAAE,CAUnC"}

package/dist/xvfb.js

@@ -0,0 +1,66 @@
+import { execFileSync } from 'node:child_process';
+export function commandExists(command) {
+    try {
+        execFileSync(process.platform === 'win32' ? 'where' : 'which', [command], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Decides how to give the client a display.
+ *
+ * "Headless" here means a real client on a virtual display, not a client without rendering:
+ * on Linux without `$DISPLAY` that is Xvfb plus Mesa's llvmpipe software rasteriser. Everywhere
+ * else, and with `--headed`, the client just opens a window. Nothing else about the CLI's
+ * behaviour differs between the two.
+ */
+export function planDisplay(command, options) {
+    const hasDisplay = (process.env['DISPLAY'] ?? '').length > 0;
+    if (options.headed || hasDisplay || process.platform !== 'linux') {
+        return {
+            command,
+            prefixArgs: [],
+            env: {},
+            description: options.headed
+                ? 'headed (--headed)'
+                : hasDisplay
+                    ? `existing display ${process.env['DISPLAY']}`
+                    : `native window on ${process.platform}`,
+        };
+    }
+    if (!commandExists('xvfb-run')) {
+        throw new Error('No $DISPLAY is set and xvfb-run is not installed, so the client has nowhere to render.\n' +
+            'Install it with: sudo apt-get install -y xvfb libgl1-mesa-dri\n' +
+            'Or pass --headed if you do have a display available.');
+    }
+    return {
+        command: 'xvfb-run',
+        // A generous virtual screen: the client window is smaller, but resizing beyond the
+        // screen (window.resize) would otherwise silently clamp.
+        prefixArgs: ['-a', '-s', `-screen 0 ${Math.max(options.width, 1280)}x${Math.max(options.height, 800)}x24`],
+        env: { LIBGL_ALWAYS_SOFTWARE: '1' },
+        description: 'xvfb-run with Mesa llvmpipe',
+    };
+}
+/**
+ * The pids of every Xvfb server currently running.
+ *
+ * `xvfb-run` picks a free display itself and never says which, so the only way to know what it
+ * started is to look before and after. Anything that appears in between is what this launch is
+ * responsible for cleaning up.
+ */
+export function xvfbPids() {
+    try {
+        return execFileSync('pgrep', ['-x', 'Xvfb'], { encoding: 'utf8' })
+            .split('\n')
+            .map((line) => Number(line.trim()))
+            .filter((pid) => Number.isInteger(pid) && pid > 0);
+    }
+    catch {
+        // pgrep exits non-zero when nothing matches, and is absent on platforms that never use Xvfb.
+        return [];
+    }
+}
+//# sourceMappingURL=xvfb.js.map

package/dist/xvfb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xvfb.js","sourceRoot":"","sources":["../src/xvfb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/F,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,OAA2D;IAE3D,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjE,OAAO;YACL,OAAO;YACP,UAAU,EAAE,EAAE;YACd,GAAG,EAAE,EAAE;YACP,WAAW,EAAE,OAAO,CAAC,MAAM;gBACzB,CAAC,CAAC,mBAAmB;gBACrB,CAAC,CAAC,UAAU;oBACV,CAAC,CAAC,oBAAoB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;oBAC9C,CAAC,CAAC,oBAAoB,OAAO,CAAC,QAAQ,EAAE;SAC7C,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,0FAA0F;YACxF,iEAAiE;YACjE,sDAAsD,CACzD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,mFAAmF;QACnF,yDAAyD;QACzD,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC;QAC1G,GAAG,EAAE,EAAE,qBAAqB,EAAE,GAAG,EAAE;QACnC,WAAW,EAAE,6BAA6B;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ;IACtB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;aAC/D,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;aAClC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,6FAA6F;QAC7F,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "cyclops-clientdevbridge-cli",
+  "version": "0.1.1",
+  "description": "CLI that launches and drives a Minecraft dev client through the ClientDevBridge mod, for coding agents.",
+  "keywords": [
+    "minecraft",
+    "modding",
+    "cyclopsmc",
+    "agent",
+    "claude-code",
+    "testing"
+  ],
+  "license": "MIT",
+  "author": "rubensworks (aka kroeser)",
+  "homepage": "https://github.com/CyclopsMC/clientdevbridge-cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CyclopsMC/clientdevbridge-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/CyclopsMC/clientdevbridge-cli/issues"
+  },
+  "type": "module",
+  "bin": {
+    "clientdevbridge": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "version": "manual-git-changelog onversion",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src test --ext .ts",
+    "lint:fix": "eslint src test --ext .ts --fix"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "pixelmatch": "^6.0.0",
+    "pngjs": "^7.0.0",
+    "ws": "^8.18.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "@types/pngjs": "^6.0.5",
+    "@types/ws": "^8.5.12",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "eslint": "^8.57.0",
+    "manual-git-changelog": "^1.0.2",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5"
+  }
+}