usecomputer 0.0.3 → 0.1.0

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.3",
+  "version": "0.1.0",
   "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,20 @@
   "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"
+    "darwin",
+    "linux"
   ],
   "dependencies": {
     "goke": "^6.3.0",
+    "picocolors": "^1.1.1",
     "string-dedent": "^3.0.1",
     "zod": "^4.3.6"
   },
@@ -68,11 +78,15 @@
     "typescript": "^5.8.3",
     "vitest": "^4.0.18"
   },
+  "optionalDependencies": {
+    "sharp": "^0.34.5"
+  },
   "scripts": {
     "build": "tsc && chmod +x bin.js",
     "build:zig": "zig build",
     "build:native": "tsx scripts/build.ts",
     "build:native:macos": "tsx scripts/build.ts darwin-arm64 darwin-x64",
+    "vm": "tsx scripts/vm.ts",
     "test": "vitest --run",
     "typecheck": "tsc --noEmit"
   }

package/src/bridge-contract.test.ts

@@ -1,85 +1,80 @@
-// 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 fs from 'node:fs'
+import os from 'node:os'
 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
-}
-
-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 isMacOS = os.platform() === 'darwin'
 
 describe('native bridge contract', () => {
-  test('maps high-level calls to native commands', async () => {
-    const calls: Call[] = []
-    const bridge = createBridgeFromNative({ nativeModule: createFakeNative({ calls }) })
+  test('bridge calls hit real Zig module', async () => {
+    expect(native).toBeTruthy()
+    if (!native) {
+      return
+    }
 
-    await bridge.click({
-      point: { x: 100, y: 200 },
-      button: 'left',
-      count: 2,
-      modifiers: ['cmd'],
-    })
-    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 })
+    const bridge = createBridgeFromNative({ nativeModule: native })
+
+    const safeTarget = { x: 0, y: 0 }
+
+    // -- Mouse commands --
+    await bridge.click({ point: safeTarget, button: 'left', count: 1, modifiers: [] })
+    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,
+    })
+
+    // -- Screenshot --
+    const screenshotPath = `${process.cwd()}/tmp/bridge-contract-shot.png`
+    const shot = await bridge.screenshot({ path: screenshotPath })
+    expect(shot.captureWidth).toBeGreaterThan(0)
+    expect(shot.captureHeight).toBeGreaterThan(0)
+    expect(shot.imageWidth).toBeGreaterThan(0)
+    expect(shot.imageHeight).toBeGreaterThan(0)
+    expect(shot.coordMap.split(',').length).toBe(6)
+    expect(shot.hint).toContain('--coord-map')
+    expect(fs.existsSync(screenshotPath)).toBe(true)
+    const stat = fs.statSync(screenshotPath)
+    expect(stat.size).toBeGreaterThan(100)
+
+    // -- Keyboard (works on both platforms) --
+    await bridge.typeText({ text: 'h', delayMs: 30 })
+    await bridge.press({ key: 'backspace', count: 1 })
+
+    // -- Scroll --
+    await bridge.scroll({ direction: 'down', amount: 1 })
+    await bridge.scroll({ direction: 'right', amount: 1, at: safeTarget })
+
+    // -- Display list --
+    const displayList = await bridge.displayList()
+    expect(displayList.length).toBeGreaterThan(0)
+    const firstDisplay = displayList[0]!
+    expect(firstDisplay.width).toBeGreaterThan(0)
+    expect(firstDisplay.height).toBeGreaterThan(0)
+    expect(typeof firstDisplay.id).toBe('number')
+    expect(typeof firstDisplay.index).toBe('number')
+
+    // -- Window list --
+    if (isMacOS) {
+      const windowList = await bridge.windowList()
+      expect(windowList.length).toBeGreaterThan(0)
+      const firstWindow = windowList[0]!
+      expect(typeof firstWindow.id).toBe('number')
+      expect(typeof firstWindow.ownerName).toBe('string')
+      expect(typeof firstWindow.desktopIndex).toBe('number')
+    }
 
-    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",
-      ]
-    `)
+    // -- Clipboard (TODO on all platforms — Zig returns "TODO not implemented") --
+    await expect(bridge.clipboardSet({ text: 'bridge-contract-test' })).rejects.toThrow('TODO not implemented')
+    await expect(bridge.clipboardGet()).rejects.toThrow('TODO not implemented')
   })
 })