cyclops-clientdevbridge-cli 0.1.1

package/dist/commands/input.js

@@ -0,0 +1,204 @@
+import { line, printJson } from '../output.js';
+import { CliError } from '../errors.js';
+import { withClient } from './context.js';
+export function parsePoint(raw, what) {
+    const parts = raw.split(',').map((part) => Number(part.trim()));
+    if (parts.length !== 2 || parts.some((value) => Number.isNaN(value))) {
+        throw new CliError(`${what} must be two numbers 'x,y', but was '${raw}'.`, 1, `For example: ${what} 210,100`);
+    }
+    return { x: parts[0], y: parts[1] };
+}
+/**
+ * Every state-changing input command reports the screen it left behind, so an agent can tell at a
+ * glance whether its click did anything.
+ */
+async function reportAfterInput(global, result) {
+    if (global.json) {
+        printJson(result);
+        return;
+    }
+    if (!global.quiet) {
+        line(`screen: ${result['screenClass'] ?? 'none'}`);
+    }
+}
+export async function runClick(global, options) {
+    await withClient(global, async ({ client }) => {
+        let point;
+        if (options.widget !== undefined) {
+            const { resolveWidget } = await import('./snapshot.js');
+            point = await resolveWidget(client, options.widget);
+        }
+        else if (options.at !== undefined) {
+            point = parsePoint(options.at, '--at');
+        }
+        else {
+            throw new CliError('click needs either --at x,y or --widget <text-or-path>.', 1);
+        }
+        const result = await client.call('input.mouseClick', {
+            ...point,
+            button: Number(options.button),
+            space: options.space,
+        });
+        await reportAfterInput(global, result);
+    });
+}
+export async function runType(global, text) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('input.type', { text });
+        await reportAfterInput(global, result);
+    });
+}
+export async function runKey(global, key, options) {
+    await withClient(global, async ({ client }) => {
+        const params = { key, action: options.action };
+        if (options.modifiers !== undefined) {
+            params['modifiers'] = Number(options.modifiers);
+        }
+        const result = await client.call('input.key', params);
+        await reportAfterInput(global, result);
+    });
+}
+export async function runHoldKey(global, key, options) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('input.hold', { key, ticks: Number(options.ticks) }, 120_000);
+        await reportAfterInput(global, result);
+    });
+}
+export async function runMouseMove(global, at, options) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('input.mouseMove', {
+            ...parsePoint(at, 'mouse-move'),
+            space: options.space,
+        });
+        await reportAfterInput(global, result);
+    });
+}
+export async function runScroll(global, options) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('input.scroll', {
+            ...parsePoint(options.at, '--at'),
+            dx: Number(options.dx),
+            dy: Number(options.dy),
+            space: options.space,
+        });
+        await reportAfterInput(global, result);
+    });
+}
+export async function runDrag(global, options) {
+    await withClient(global, async ({ client }) => {
+        const from = parsePoint(options.from, '--from');
+        const to = parsePoint(options.to, '--to');
+        const result = await client.call('input.mouseDrag', {
+            from: [from.x, from.y],
+            to: [to.x, to.y],
+            button: Number(options.button),
+            steps: Number(options.steps),
+            space: options.space,
+        });
+        await reportAfterInput(global, result);
+    });
+}
+export async function runOpenGui(global, x, y, z, options) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('screen.open', { blockPos: [Number(x), Number(y), Number(z)], approach: options.approach }, 60_000);
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        if (result['opened'] === true) {
+            line(`screen: ${result['screenClass']}`);
+        }
+        else {
+            line(`No screen opened. ${result['hint'] ?? ''}`.trim());
+            process.exitCode = 1;
+        }
+    });
+}
+export async function runCloseScreen(global) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('screen.close');
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        if (!global.quiet) {
+            line('Closed the screen.');
+        }
+    });
+}
+export async function runEval(global, code) {
+    await withClient(global, async ({ client }) => {
+        const result = await client.call('eval', { language: 'groovy', code }, 60_000);
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        const stdout = String(result['stdout'] ?? '');
+        if (stdout.length > 0) {
+            process.stdout.write(stdout.endsWith('\n') ? stdout : `${stdout}\n`);
+        }
+        // The mod describes anything it cannot map to JSON as { type, toString }. Every JS object
+        // inherits a toString, so this has to check for that exact shape rather than for the key.
+        const value = result['value'];
+        if (isDescribedObject(value)) {
+            line(value['toString']);
+        }
+        else {
+            line(JSON.stringify(value));
+        }
+    });
+}
+export function isDescribedObject(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        typeof value['type'] === 'string' &&
+        typeof value['toString'] === 'string');
+}
+export async function runWaitFor(global, options) {
+    await withClient(global, async ({ client }) => {
+        const timeoutMs = Number(options.timeout);
+        if (options.ticks !== undefined) {
+            const result = await client.call('wait.ticks', { ticks: Number(options.ticks) }, timeoutMs + 30_000);
+            if (global.json) {
+                printJson(result);
+            }
+            else if (!global.quiet) {
+                line(`Waited ${options.ticks} ticks (now at tick ${result['tick']}).`);
+            }
+            return;
+        }
+        let params;
+        if (options.screen !== undefined) {
+            params = { condition: 'screen', value: options.screen, timeoutMs };
+        }
+        else if (options.expr !== undefined) {
+            params = { condition: 'expr', value: options.expr, timeoutMs };
+        }
+        else if (options.chunk !== undefined) {
+            params = { condition: 'chunkLoaded', value: options.chunk.split(',').map(Number), timeoutMs };
+        }
+        else if (options.inWorld === true) {
+            params = { condition: 'inWorld', timeoutMs };
+        }
+        else {
+            throw new CliError('wait needs one of --ticks, --screen, --expr, --chunk or --in-world.', 1);
+        }
+        const result = await client.call('wait.for', params, timeoutMs + 30_000);
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        if (result['met'] === true) {
+            if (!global.quiet) {
+                line(`Condition met (screen: ${result['screenClass'] ?? 'none'}, in world: ${result['inWorld']}).`);
+            }
+        }
+        else {
+            line(`Timed out after ${timeoutMs} ms waiting for ${result['condition']}` +
+                ` (screen is ${result['screenClass'] ?? 'none'}, in world: ${result['inWorld']}).`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=input.js.map

package/dist/commands/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/commands/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAsB,UAAU,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,IAAY;IAClD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,QAAQ,CAAC,GAAG,IAAI,wCAAwC,GAAG,IAAI,EAAE,CAAC,EAAE,gBAAgB,IAAI,UAAU,CAAC,CAAC;IAChH,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAW,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAW,EAAE,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAAC,MAAqB,EAAE,MAA+B;IACpF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,MAAM,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAqB,EACrB,OAAgG;IAEhG,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,IAAI,KAA+B,CAAC;QACpC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;YACxD,KAAK,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YACpC,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,QAAQ,CAAC,yDAAyD,EAAE,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,kBAAkB,EAAE;YAC5E,GAAG,KAAK;YACR,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAqB,EAAE,IAAY;IAC/D,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,MAAqB,EACrB,GAAW,EACX,OAA2D;IAE3D,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,MAAM,MAAM,GAA4B,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACxE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,WAAW,EAAE,MAAM,CAAC,CAAC;QAC/E,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAqB,EAAE,GAAW,EAAE,OAA0B;IAC7F,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,YAAY,EACZ,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EACrC,OAAO,CACR,CAAC;QACF,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAqB,EAAE,EAAU,EAAE,OAA0B;IAC9F,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,iBAAiB,EAAE;YAC3E,GAAG,UAAU,CAAC,EAAE,EAAE,YAAY,CAAC;YAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAqB,EACrB,OAA8D;IAE9D,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,cAAc,EAAE;YACxE,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC;YACjC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAqB,EACrB,OAAmF;IAEnF,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,iBAAiB,EAAE;YAC3E,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YACtB,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YAC9B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAqB,EACrB,CAAS,EACT,CAAS,EACT,CAAS,EACT,OAA8B;IAE9B,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,aAAa,EACb,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAC3E,MAAM,CACP,CAAC;QACF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9B,IAAI,CAAC,WAAW,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,qBAAqB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAqB;IACxD,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,cAAc,CAAC,CAAC;QAC1E,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAqB,EAAE,IAAY;IAC/D,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QACxG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;QACvE,CAAC;QACD,0FAA0F;QAC1F,0FAA0F;QAC1F,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,OAAQ,KAAiC,CAAC,MAAM,CAAC,KAAK,QAAQ;QAC9D,OAAQ,KAAiC,CAAC,UAAU,CAAC,KAAK,QAAQ,CACnE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAqB,EACrB,OAOC;IAED,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE1C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC;YAC9H,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,SAAS,CAAC,MAAM,CAAC,CAAC;YACpB,CAAC;iBAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,UAAU,OAAO,CAAC,KAAK,uBAAuB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzE,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,MAA+B,CAAC;QACpC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;QACrE,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;QACjE,CAAC;aAAM,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;QAChG,CAAC;aAAM,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACpC,MAAM,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,QAAQ,CAAC,qEAAqE,EAAE,CAAC,CAAC,CAAC;QAC/F,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,UAAU,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC;QAClG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,IAAI,CAAC,0BAA0B,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,eAAe,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACtG,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CACF,mBAAmB,SAAS,mBAAmB,MAAM,CAAC,WAAW,CAAC,EAAE;gBAClE,eAAe,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,eAAe,MAAM,CAAC,SAAS,CAAC,IAAI,CACrF,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/inspect.d.ts

@@ -0,0 +1,19 @@
+import { type GlobalOptions } from './context.js';
+export interface ScreenshotOptions {
+    readonly name?: string | undefined;
+    readonly region?: string | undefined;
+    readonly afterTicks?: string | undefined;
+    readonly scale?: string | undefined;
+    readonly space?: string | undefined;
+}
+export declare function parseRegion(raw: string, space: string): Record<string, unknown>;
+export declare function runScreenshot(global: GlobalOptions, options: ScreenshotOptions): Promise<void>;
+export interface LogsOptions {
+    readonly lines: string;
+    readonly filter?: string | undefined;
+    readonly level?: string | undefined;
+    readonly gradle: boolean;
+}
+export declare function runLogs(global: GlobalOptions, options: LogsOptions): Promise<void>;
+export declare function screenshotDirectory(projectDir: string): string;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/commands/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAA0C,MAAM,cAAc,CAAC;AAG1F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU/E;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BpG;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CxF;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/commands/inspect.js

@@ -0,0 +1,90 @@
+import * as path from 'node:path';
+import { line, printJson, printPath } from '../output.js';
+import { readTruncated, tailFile } from '../launcher.js';
+import { readSession } from '../session.js';
+import { timestampName, withClient, writeBase64 } from './context.js';
+import { CliError } from '../errors.js';
+export function parseRegion(raw, space) {
+    const parts = raw.split(',').map((part) => Number(part.trim()));
+    if (parts.length !== 4 || parts.some((value) => Number.isNaN(value))) {
+        throw new CliError(`--region must be four numbers 'x,y,w,h', but was '${raw}'.`, 1, 'For example: --region 100,80,200,120');
+    }
+    return { x: parts[0], y: parts[1], w: parts[2], h: parts[3], space };
+}
+export async function runScreenshot(global, options) {
+    await withClient(global, async ({ client, paths }) => {
+        const space = options.space ?? 'gui';
+        const params = {};
+        if (options.region !== undefined) {
+            params['region'] = parseRegion(options.region, space);
+        }
+        if (options.afterTicks !== undefined) {
+            params['afterTicks'] = Number(options.afterTicks);
+        }
+        if (options.scale !== undefined) {
+            params['scale'] = Number(options.scale);
+        }
+        const result = await client.call('screenshot', params);
+        const file = writeBase64(paths.screenshots, options.name ?? timestampName('screenshot'), String(result['png']));
+        if (global.json) {
+            const { png: _png, ...rest } = result;
+            printJson({ ...rest, path: file });
+            return;
+        }
+        if (!global.quiet) {
+            line(`${result['width']}x${result['height']} px  (window ${result['pixelWidth']}x${result['pixelHeight']}, ` +
+                `gui ${result['guiWidth']}x${result['guiHeight']} @ scale ${result['guiScale']})`);
+        }
+        // The path goes on its own line: this is the contract an agent reads to open the image.
+        printPath(file);
+    });
+}
+export async function runLogs(global, options) {
+    const count = Number(options.lines);
+    if (options.gradle) {
+        const status = readSession(global.project);
+        const file = status.paths.gradleLog;
+        let text = tailFile(file, count);
+        if (options.filter !== undefined) {
+            const pattern = new RegExp(options.filter);
+            text = readTruncated(file)
+                .split('\n')
+                .filter((entry) => pattern.test(entry))
+                .slice(-count)
+                .join('\n');
+        }
+        if (global.json) {
+            printJson({ source: file, lines: text.split('\n').filter((entry) => entry.length > 0) });
+            return;
+        }
+        if (!global.quiet) {
+            line(`# ${file}`);
+        }
+        line(text);
+        return;
+    }
+    await withClient(global, async ({ client }) => {
+        const params = { lines: count };
+        if (options.filter !== undefined) {
+            params['filter'] = options.filter;
+        }
+        if (options.level !== undefined) {
+            params['level'] = options.level;
+        }
+        const result = await client.call('log.tail', params);
+        if (global.json) {
+            printJson(result);
+            return;
+        }
+        for (const entry of result.lines) {
+            line(entry);
+        }
+        if (!global.quiet) {
+            line(`# ${result.lines.length} of ${result.buffered} buffered lines, at level ${result.level} and above`);
+        }
+    });
+}
+export function screenshotDirectory(projectDir) {
+    return path.join(projectDir, '.clientdevbridge', 'screenshots');
+}
+//# sourceMappingURL=inspect.js.map

package/dist/commands/inspect.js.map

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

package/dist/commands/lifecycle.d.ts

@@ -0,0 +1,29 @@
+import type { GlobalOptions } from './context.js';
+export interface StartCommandOptions {
+    readonly loader?: string | undefined;
+    readonly mcVersion?: string | undefined;
+    readonly clientdevbridgeVersion?: string | undefined;
+    readonly world?: string | undefined;
+    readonly headed: boolean;
+    readonly port: string;
+    readonly timeout: string;
+    readonly gradleArgs?: string | undefined;
+    readonly width: string;
+    readonly height: string;
+    readonly eval: boolean;
+    readonly pinOptions: boolean;
+    readonly jdwpPort?: string | undefined;
+}
+export declare function runStart(global: GlobalOptions, options: StartCommandOptions): Promise<void>;
+export declare function runStop(global: GlobalOptions, options?: {
+    port?: string | undefined;
+}): Promise<void>;
+export declare function runStatus(global: GlobalOptions): Promise<void>;
+export declare function runRestart(global: GlobalOptions, options: StartCommandOptions): Promise<void>;
+export declare const START_DEFAULTS: {
+    port: string;
+    timeout: string;
+    width: string;
+    height: string;
+};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/commands/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/commands/lifecycle.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCjG;AAaD,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/G;AAkCD,wBAAsB,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFpE;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnG;AAED,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC"}

package/dist/commands/lifecycle.js

@@ -0,0 +1,201 @@
+import * as path from 'node:path';
+import { DEFAULT_HEIGHT, DEFAULT_PORT, DEFAULT_USERNAME, DEFAULT_WIDTH, describeBridgeOnPort, describePortOwner, isPortFree, start, stop, tailFile, } from '../launcher.js';
+import { formatDuration, keyValues, line, printJson } from '../output.js';
+import { readSession } from '../session.js';
+import { BridgeClient } from '../protocol/client.js';
+export async function runStart(global, options) {
+    const result = await start({
+        projectDir: global.project,
+        loader: options.loader,
+        minecraftVersion: options.mcVersion,
+        bridgeVersion: options.clientdevbridgeVersion,
+        world: options.world,
+        headed: options.headed,
+        port: Number(options.port),
+        timeoutMs: Number(options.timeout) * 1000,
+        gradleArgs: options.gradleArgs === undefined ? [] : options.gradleArgs.split(' ').filter((a) => a.length > 0),
+        width: Number(options.width),
+        height: Number(options.height),
+        evalEnabled: options.eval,
+        pinOptions: options.pinOptions,
+        jdwpPort: options.jdwpPort === undefined ? null : Number(options.jdwpPort),
+        onProgress: global.quiet ? undefined : (message) => line(message),
+    });
+    if (global.json) {
+        printJson({ session: result.session, hello: result.hello });
+        return;
+    }
+    const hello = result.hello;
+    line('ClientDevBridge is ready.');
+    keyValues([
+        ['project', result.session.projectDir],
+        ['loader', result.session.loader],
+        ['minecraft', String(hello['mcVersion'] ?? result.session.mcVersion)],
+        ['mod version', String(hello['clientDevBridgeVersion'] ?? result.session.bridgeVersion)],
+        ['protocol', String(hello['protocol'])],
+        ['port', result.session.port],
+        ['username', DEFAULT_USERNAME],
+        ['world', result.session.world],
+        ['eval', String(hello['evalEnabled'] ?? false)],
+        // Fabric loads its API as ~50 separate modules, which turns this into a wall of names that
+        // says nothing. What a caller needs from it is whether the mod under test is loaded.
+        ['mods', summariseMods(hello['mods'])],
+    ]);
+}
+/** The mod list, shortened once it stops being readable. */
+function summariseMods(mods, limit = 12) {
+    if (mods === undefined) {
+        return [];
+    }
+    if (mods.length <= limit) {
+        return mods;
+    }
+    return [...mods.slice(0, limit), `... and ${mods.length - limit} more`];
+}
+export async function runStop(global, options = {}) {
+    const port = options.port === undefined ? DEFAULT_PORT : Number(options.port);
+    const result = await stop(global.project, port);
+    if (global.json) {
+        printJson(result);
+        return;
+    }
+    if (result.stopped) {
+        line('Stopped the ClientDevBridge client.');
+    }
+    else if (result.wasStale) {
+        line('No client was running; cleared a stale session file.');
+    }
+    else {
+        line('No client was running.');
+    }
+    if (result.orphan !== null) {
+        line('');
+        for (const explanation of await describeOccupiedPort(port, result.orphan, global.project)) {
+            line(explanation);
+        }
+        process.exitCode = 2;
+    }
+}
+/**
+ * Explains what is holding the bridge port.
+ *
+ * "An orphaned client whose session file is gone" is one possibility and not the likely one: a mod
+ * developer with two checkouts open reaches this every time, and `kill <pid>` is confident, wrong
+ * advice about a client they are still using.
+ */
+async function describeOccupiedPort(port, pid, thisProject) {
+    const bridge = await describeBridgeOnPort(port);
+    if (bridge === null) {
+        return [
+            `Something is listening on port ${port}: pid ${pid}, and it does not answer the bridge protocol.`,
+            `Start elsewhere with --port <other>, or stop it with: kill ${pid.split(' ')[0]}`,
+        ];
+    }
+    const where = bridge.projectDir;
+    if (where !== null && path.resolve(where) !== path.resolve(thisProject)) {
+        return [
+            `A ClientDevBridge client is on port ${port} (pid ${pid}), but it belongs to another project:`,
+            `  ${where}  (Minecraft ${bridge.mcVersion}, ${bridge.loader})`,
+            `Drive it from there, stop it with: clientdevbridge --project ${where} stop`,
+            'or start this project on a different port with --port <other>.',
+        ];
+    }
+    return [
+        `A ClientDevBridge client for this project is on port ${port} (pid ${pid}), but its session`,
+        `file is gone (Minecraft ${bridge.mcVersion}, ${bridge.loader}), so the CLI cannot drive it.`,
+        `Stop it with: kill ${pid.split(' ')[0]}`,
+    ];
+}
+export async function runStatus(global) {
+    const status = readSession(global.project);
+    if (status.session === null || status.stale) {
+        const reason = status.session === null && !status.stale ? 'no session recorded' : 'the recorded process is gone';
+        // The session file is not the only evidence: a client whose session.json was deleted is still
+        // running, and reporting it as gone is worse than reporting nothing at all.
+        const port = status.session?.port ?? DEFAULT_PORT;
+        const orphan = (await isPortFree(port)) ? null : describePortOwner(port);
+        if (global.json) {
+            printJson({ running: false, reason, project: status.paths.projectDir, orphanOnPort: orphan });
+            return;
+        }
+        line(`Not running (${reason}) in ${status.paths.projectDir}.`);
+        if (orphan !== null) {
+            line('');
+            for (const explanation of await describeOccupiedPort(port, orphan, status.paths.projectDir)) {
+                line(explanation);
+            }
+            return;
+        }
+        line('Start one with: clientdevbridge start');
+        // The log tail is what explains a crash. After a deliberate stop it is just noise, and a
+        // cleanly stopped session leaves no marker to tell the two apart -- so only show it when the
+        // client is recorded as having died rather than never having been tracked.
+        if (status.stale) {
+            const tail = tailFile(status.paths.gradleLog, 20);
+            if (tail !== '(no log yet)' && tail.length > 0) {
+                line('');
+                line(`The client exited. Last 20 lines of ${status.paths.gradleLog}:`);
+                line(tail);
+            }
+        }
+        return;
+    }
+    const session = status.session;
+    let live = null;
+    let hello = null;
+    let connectError = null;
+    try {
+        const client = await BridgeClient.connect({ port: session.port, timeoutMs: 5000 });
+        hello = client.hello;
+        live = await client.call('status');
+        client.close();
+    }
+    catch (error) {
+        connectError = error.message;
+    }
+    if (global.json) {
+        printJson({ running: true, session, hello, status: live, connectError });
+        return;
+    }
+    line(connectError === null ? 'Running.' : 'Running, but not answering yet.');
+    keyValues([
+        ['project', session.projectDir],
+        ['loader', session.loader],
+        ['minecraft', String(hello?.['mcVersion'] ?? session.mcVersion)],
+        ['mod version', String(hello?.['clientDevBridgeVersion'] ?? session.bridgeVersion)],
+        ['protocol', String(hello?.['protocol'] ?? '-')],
+        ['port', session.port],
+        ['pid', session.pid],
+        ['display', session.display],
+        ['uptime', formatDuration(Date.now() - new Date(session.startedAt).getTime())],
+        ['gradle log', session.projectDir === '' ? '-' : path.join(session.projectDir, '.clientdevbridge', 'gradle.log')],
+    ]);
+    if (live !== null) {
+        line('');
+        keyValues([
+            ['in world', String(live['inWorld'])],
+            ['screen', String(live['screenClass'] ?? 'none')],
+            ['tick', String(live['tick'])],
+            ['fps', String(live['fps'])],
+            ['gui size', `${live['guiWidth']}x${live['guiHeight']} @ scale ${live['guiScale']}`],
+            ['pixel size', `${live['pixelWidth']}x${live['pixelHeight']}`],
+            ['game dir', String(live['gameDir'] ?? '-')],
+        ]);
+    }
+    else if (connectError !== null) {
+        line('');
+        line(connectError);
+        line(`See ${path.join(session.projectDir, '.clientdevbridge', 'gradle.log')} for the game log.`);
+    }
+}
+export async function runRestart(global, options) {
+    await stop(global.project);
+    await runStart(global, options);
+}
+export const START_DEFAULTS = {
+    port: String(DEFAULT_PORT),
+    timeout: '300',
+    width: String(DEFAULT_WIDTH),
+    height: String(DEFAULT_HEIGHT),
+};
+//# sourceMappingURL=lifecycle.js.map

package/dist/commands/lifecycle.js.map

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

package/dist/commands/snapshot.d.ts

@@ -0,0 +1,37 @@
+import { type Snapshot } from '../snapshot/model.js';
+import type { BridgeClient } from '../protocol/client.js';
+import { type GlobalOptions } from './context.js';
+export declare function fetchSnapshot(client: BridgeClient, options?: {
+    includeHidden?: boolean;
+    maxDepth?: number;
+}): Promise<Snapshot>;
+export declare function runSnapshot(global: GlobalOptions, options: {
+    includeHidden: boolean;
+    maxDepth?: string | undefined;
+}): Promise<void>;
+export declare function runFind(global: GlobalOptions, text: string, options: {
+    type?: string | undefined;
+}): Promise<void>;
+/**
+ * Turns a `--widget` argument into a point to click.
+ *
+ * Ambiguity is an error rather than a guess: silently clicking the wrong one of two similarly
+ * labelled buttons is far worse than being told to be more specific.
+ */
+export declare function resolveWidget(client: BridgeClient, query: string): Promise<{
+    x: number;
+    y: number;
+}>;
+export declare function runTooltip(global: GlobalOptions, options: {
+    at?: string | undefined;
+    widget?: string | undefined;
+}): Promise<void>;
+/**
+ * The composite an agent reaches for most: open a block's GUI, wait for it, and produce both the
+ * outline and a screenshot path in one round trip.
+ */
+export declare function runInspectGui(global: GlobalOptions, x: string, y: string, z: string, options: {
+    approach: boolean;
+    name?: string | undefined;
+}): Promise<void>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/commands/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/commands/snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,QAAQ,EAAkB,MAAM,sBAAsB,CAAC;AAEhG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,KAAK,aAAa,EAA0C,MAAM,cAAc,CAAC;AAE1F,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3D,OAAO,CAAC,QAAQ,CAAC,CAkBnB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACjE,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACrC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiC1G;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAChE,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACxD,OAAO,CAAC,IAAI,CAAC,CA4Bf"}