usecomputer 0.0.2 → 0.0.4

package/dist/terminal-table.js

@@ -0,0 +1,55 @@
+// Generic aligned terminal table renderer for CLI command output.
+export function renderAlignedTable({ rows, columns, }) {
+    if (columns.length === 0) {
+        return [];
+    }
+    const widthByColumn = columns.map((column) => {
+        const rowWidth = rows.reduce((maxWidth, row) => {
+            const width = printableWidth(column.value(row));
+            return Math.max(maxWidth, width);
+        }, 0);
+        return Math.max(printableWidth(column.header), rowWidth);
+    });
+    const formatCell = ({ value, width, align, }) => {
+        const currentWidth = printableWidth(value);
+        const padSize = Math.max(0, width - currentWidth);
+        const padding = ' '.repeat(padSize);
+        if (align === 'right') {
+            return `${padding}${value}`;
+        }
+        return `${value}${padding}`;
+    };
+    const renderRow = ({ values, }) => {
+        return values.map((value, index) => {
+            const column = columns[index];
+            if (!column) {
+                return value;
+            }
+            return formatCell({
+                value,
+                width: widthByColumn[index] ?? value.length,
+                align: column.align ?? 'left',
+            });
+        }).join('  ');
+    };
+    const header = renderRow({
+        values: columns.map((column) => {
+            return column.header;
+        }),
+    });
+    const divider = widthByColumn.map((width) => {
+        return '-'.repeat(width);
+    }).join('  ');
+    const lines = rows.map((row) => {
+        return renderRow({
+            values: columns.map((column) => {
+                return column.value(row);
+            }),
+        });
+    });
+    return [header, divider, ...lines];
+}
+function printableWidth(value) {
+    const ansiStripped = value.replace(/\u001b\[[0-9;]*m/g, '');
+    return ansiStripped.length;
+}

package/dist/terminal-table.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal-table.test.d.ts.map

package/dist/terminal-table.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-table.test.d.ts","sourceRoot":"","sources":["../src/terminal-table.test.ts"],"names":[],"mappings":""}

package/dist/terminal-table.test.js

@@ -0,0 +1,41 @@
+// Tests aligned terminal table formatting for deterministic CLI rendering.
+import { describe, expect, test } from 'vitest';
+import { renderAlignedTable } from './terminal-table.js';
+describe('terminal table', () => {
+    test('renders aligned columns for mixed widths', () => {
+        const lines = renderAlignedTable({
+            rows: [
+                { id: 2, app: 'Zed', size: '1720x1440' },
+                { id: 102, app: 'Google Chrome', size: '3440x1440' },
+            ],
+            columns: [
+                {
+                    header: 'id',
+                    align: 'right',
+                    value: (row) => {
+                        return String(row.id);
+                    },
+                },
+                {
+                    header: 'app',
+                    value: (row) => {
+                        return row.app;
+                    },
+                },
+                {
+                    header: 'size',
+                    align: 'right',
+                    value: (row) => {
+                        return row.size;
+                    },
+                },
+            ],
+        });
+        expect(lines.join('\n')).toMatchInlineSnapshot(`
+      " id  app                 size
+      ---  -------------  ---------
+        2  Zed            1720x1440
+      102  Google Chrome  3440x1440"
+    `);
+    });
+});

package/dist/types.d.ts

@@ -10,8 +10,17 @@ export type Region = {
     width: number;
     height: number;
 };
+export type CoordMap = {
+    captureX: number;
+    captureY: number;
+    captureWidth: number;
+    captureHeight: number;
+    imageWidth: number;
+    imageHeight: number;
+};
 export type DisplayInfo = {
     id: number;
+    index: number;
     name: string;
     x: number;
     y: number;
@@ -20,14 +29,35 @@ export type DisplayInfo = {
     scale: number;
     isPrimary: boolean;
 };
+export type WindowInfo = {
+    id: number;
+    ownerPid: number;
+    ownerName: string;
+    title: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    desktopIndex: number;
+};
 export type ScreenshotInput = {
     path?: string;
     display?: number;
+    window?: number;
     region?: Region;
     annotate?: boolean;
 };
 export type ScreenshotResult = {
     path: string;
+    desktopIndex: number;
+    captureX: number;
+    captureY: number;
+    captureWidth: number;
+    captureHeight: number;
+    imageWidth: number;
+    imageHeight: number;
+    coordMap: string;
+    hint: string;
 };
 export type ClickInput = {
     point: Point;
@@ -55,6 +85,20 @@ export type DragInput = {
     durationMs?: number;
     button: MouseButton;
 };
+export type NativeErrorObject = {
+    code: string;
+    message: string;
+    command: string;
+};
+export type NativeCommandResult = {
+    ok: boolean;
+    error?: NativeErrorObject;
+};
+export type NativeDataResult<T> = {
+    ok: boolean;
+    data?: T;
+    error?: NativeErrorObject;
+};
 export interface UseComputerBridge {
     screenshot(input: ScreenshotInput): Promise<ScreenshotResult>;
     click(input: ClickInput): Promise<void>;
@@ -72,6 +116,7 @@ export interface UseComputerBridge {
     }): Promise<void>;
     mousePosition(): Promise<Point>;
     displayList(): Promise<DisplayInfo[]>;
+    windowList(): Promise<WindowInfo[]>;
     clipboardGet(): Promise<string>;
     clipboardSet(input: {
         text: string;

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "usecomputer",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "description": "Fast computer automation CLI for AI agents. Control any desktop with accessibility snapshots, clicks, typing, scrolling, and more.",
   "bin": "./bin.js",
@@ -12,6 +12,14 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./lib": {
+      "types": "./dist/lib.d.ts",
+      "default": "./dist/lib.js"
+    },
+    "./coord-map": {
+      "types": "./dist/coord-map.d.ts",
+      "default": "./dist/coord-map.js"
+    },
     "./src": {
       "types": "./src/index.ts",
       "default": "./src/index.ts"
@@ -47,18 +55,19 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/remorses/kimakivoice.git",
+    "url": "git+https://github.com/remorses/kimaki.git",
     "directory": "usecomputer"
   },
-  "homepage": "https://github.com/remorses/kimakivoice/tree/main/usecomputer",
+  "homepage": "https://github.com/remorses/kimaki/tree/main/usecomputer",
   "bugs": {
-    "url": "https://github.com/remorses/kimakivoice/issues"
+    "url": "https://github.com/remorses/kimaki/issues"
   },
   "os": [
     "darwin"
   ],
   "dependencies": {
     "goke": "^6.3.0",
+    "picocolors": "^1.1.1",
     "string-dedent": "^3.0.1",
     "zod": "^4.3.6"
   },
@@ -68,6 +77,9 @@
     "typescript": "^5.8.3",
     "vitest": "^4.0.18"
   },
+  "optionalDependencies": {
+    "sharp": "^0.34.5"
+  },
   "scripts": {
     "build": "tsc && chmod +x bin.js",
     "build:zig": "zig build",

package/src/bridge-contract.test.ts

@@ -1,85 +1,156 @@
-// Contract tests for command names and payloads emitted to the native bridge.
+// Contract tests for direct native method calls emitted by the TS bridge.
+// These tests intentionally call the real Zig native module.
 
 import { describe, expect, test } from 'vitest'
 import { createBridgeFromNative } from './bridge.js'
-import type { NativeModule } from './native-lib.js'
+import { native } from './native-lib.js'
 
-type Call = {
-  command: string
-  payload: unknown
-}
+describe('native bridge contract', () => {
+  test('bridge calls hit real Zig module', async () => {
+    expect(native).toBeTruthy()
+    if (!native) {
+      return
+    }
 
-function createFakeNative({ calls }: { calls: Call[] }): NativeModule {
-  return {
-    execute(command: string, payloadJson: string): string {
-      const payload = JSON.parse(payloadJson) as unknown
-      calls.push({ command, payload })
-      if (command === 'mouse-position') {
-        return JSON.stringify({ ok: true, data: { x: 10, y: 20 } })
-      }
-      if (command === 'display-list') {
-        return JSON.stringify({
-          ok: true,
-          data: [
-            { id: 1, name: 'Built-in', x: 0, y: 0, width: 1512, height: 982, scale: 2, isPrimary: true },
-          ],
-        })
-      }
-      if (command === 'clipboard-get') {
-        return JSON.stringify({ ok: true, data: { text: 'hello' } })
-      }
-      if (command === 'screenshot') {
-        return JSON.stringify({ ok: true, data: { path: '/tmp/test.png' } })
-      }
-      return JSON.stringify({ ok: true, data: null })
-    },
-  }
-}
+    const bridge = createBridgeFromNative({ nativeModule: native })
 
-describe('native bridge contract', () => {
-  test('maps high-level calls to native commands', async () => {
-    const calls: Call[] = []
-    const bridge = createBridgeFromNative({ nativeModule: createFakeNative({ calls }) })
+    const safeTarget = {
+      x: 0,
+      y: 0,
+    }
 
     await bridge.click({
-      point: { x: 100, y: 200 },
+      point: safeTarget,
       button: 'left',
-      count: 2,
-      modifiers: ['cmd'],
+      count: 1,
+      modifiers: [],
     })
-    await bridge.typeText({ text: 'hello', delayMs: 30 })
-    await bridge.press({ key: 'enter', count: 1 })
-    await bridge.scroll({ direction: 'down', amount: 300 })
-    await bridge.drag({ from: { x: 10, y: 10 }, to: { x: 200, y: 120 }, button: 'left' })
-    await bridge.hover({ x: 33, y: 44 })
-    await bridge.mouseMove({ x: 60, y: 70 })
+    await bridge.hover(safeTarget)
+    await bridge.mouseMove(safeTarget)
     await bridge.mouseDown({ button: 'left' })
     await bridge.mouseUp({ button: 'left' })
-    await bridge.mousePosition()
-    await bridge.displayList()
-    await bridge.clipboardGet()
-    await bridge.clipboardSet({ text: 'copied' })
-    await bridge.screenshot({ path: './out.png' })
+    await bridge.drag({
+      from: safeTarget,
+      to: { x: safeTarget.x + 6, y: safeTarget.y + 6 },
+      button: 'left',
+      durationMs: 10,
+    })
+
+    const screenshot = await bridge.screenshot({ path: `${process.cwd()}/tmp/bridge-contract-shot.png` })
+
+    await bridge.typeText({ text: 'h', delayMs: 30 })
+    await bridge.press({ key: 'backspace', count: 1 })
+    const scrollResult = await bridge.scroll({ direction: 'down', amount: 1 }).then(
+      () => {
+        return 'ok'
+      },
+      (error: unknown) => {
+        return error instanceof Error ? error.message : String(error)
+      },
+    )
+    const scrollAtResult = await bridge.scroll({ direction: 'right', amount: 1, at: safeTarget }).then(
+      () => {
+        return 'ok'
+      },
+      (error: unknown) => {
+        return error instanceof Error ? error.message : String(error)
+      },
+    )
+    const displays = await bridge.displayList()
+    const windows = await bridge.windowList()
+    const clipboardGetResult = await bridge.clipboardGet().then(
+      () => {
+        return 'ok'
+      },
+      (error: unknown) => {
+        return error instanceof Error ? error.message : String(error)
+      },
+    )
+    const clipboardSetResult = await bridge.clipboardSet({ text: 'copied' }).then(
+      () => {
+        return 'ok'
+      },
+      (error: unknown) => {
+        return error instanceof Error ? error.message : String(error)
+      },
+    )
+    const isOkOrTodo = ({ value }: { value: string }): boolean => {
+      return value === 'ok' || value.includes('TODO not implemented')
+    }
 
-    expect(calls.map((call) => {
-      return call.command
-    })).toMatchInlineSnapshot(`
-      [
-        "click",
-        "type-text",
-        "press",
-        "scroll",
-        "drag",
-        "hover",
-        "mouse-move",
-        "mouse-down",
-        "mouse-up",
-        "mouse-position",
-        "display-list",
-        "clipboard-get",
-        "clipboard-set",
-        "screenshot",
-      ]
+    expect({
+      screenshotShape: {
+        path: screenshot.path,
+        desktopIndex: typeof screenshot.desktopIndex,
+        captureX: typeof screenshot.captureX,
+        captureY: typeof screenshot.captureY,
+        captureWidth: screenshot.captureWidth > 0,
+        captureHeight: screenshot.captureHeight > 0,
+        imageWidth: screenshot.imageWidth > 0,
+        imageHeight: screenshot.imageHeight > 0,
+        coordMapHasSixValues: screenshot.coordMap.split(',').length === 6,
+        hint: screenshot.hint,
+      },
+      firstDisplayShape: displays[0]
+        ? {
+            id: typeof displays[0].id,
+            index: typeof displays[0].index,
+            width: displays[0].width > 0,
+            height: displays[0].height > 0,
+          }
+        : null,
+      firstWindowShape: windows[0]
+        ? {
+            id: typeof windows[0].id,
+            ownerName: typeof windows[0].ownerName,
+            desktopIndex: typeof windows[0].desktopIndex,
+          }
+        : null,
+      optionalCommandOutcomes: {
+        scrollResult: isOkOrTodo({ value: scrollResult }),
+        scrollAtResult: isOkOrTodo({ value: scrollAtResult }),
+        clipboardGetResult: isOkOrTodo({ value: clipboardGetResult }),
+        clipboardSetResult: isOkOrTodo({ value: clipboardSetResult }),
+      },
+    }).toMatchInlineSnapshot(`
+      {
+        "firstDisplayShape": {
+          "height": true,
+          "id": "number",
+          "index": "number",
+          "width": true,
+        },
+        "firstWindowShape": {
+          "desktopIndex": "number",
+          "id": "number",
+          "ownerName": "string",
+        },
+        "optionalCommandOutcomes": {
+          "clipboardGetResult": true,
+          "clipboardSetResult": true,
+          "scrollAtResult": true,
+          "scrollResult": true,
+        },
+        "screenshotShape": {
+          "captureHeight": true,
+          "captureWidth": true,
+          "captureX": "number",
+          "captureY": "number",
+          "coordMapHasSixValues": true,
+          "desktopIndex": "number",
+          "hint": "ALWAYS pass this exact coord map to click, hover, drag, and mouse move when using coordinates from this screenshot:
+      --coord-map "0,0,3440,1440,1568,656"
+
+      Example:
+      usecomputer click -x 400 -y 220 --coord-map "0,0,3440,1440,1568,656"",
+          "imageHeight": true,
+          "imageWidth": true,
+          "path": "/Users/morse/Documents/GitHub/kimakivoice/usecomputer/tmp/bridge-contract-shot.png",
+        },
+      }
     `)
+
+    expect(displays.length).toBeGreaterThan(0)
+    expect(windows.length).toBeGreaterThan(0)
   })
 })