@hasna/computer 0.1.7 → 0.1.9

package/README.md

@@ -47,12 +47,63 @@ bun install -g @hasna/computer
 computer run <task>              # Run a computer use task
 computer run <task> -p openai    # Use OpenAI instead of Anthropic
 computer run <task> -s 30        # Limit to 30 steps
+computer open <app> [options]    # Open an app deterministically via its driver
+computer apps                    # List app drivers + availability
 computer screenshot              # Capture current screen
 computer sessions                # List past sessions
 computer session <id>            # Show session details + action log
 computer stats                   # Usage statistics
 ```
 
+## Apps
+
+Beyond AI-driven tasks (`computer run`), `computer` ships deterministic **app
+drivers** that open and arrange desktop apps with zero AI in the loop — windows,
+tabs, pane grids, and a command per pane.
+
+```bash
+computer apps                    # List registered drivers and availability
+computer open <app> [options]    # Open/orchestrate an app via its driver
+```
+
+Options for `computer open`:
+
+| Option | Description |
+|--------|-------------|
+| `--grid RxC` | Split the window into R rows x C cols (panes fill row-major: left-to-right, top-to-bottom) |
+| `--tabs "spec1,spec2,..."` | Multiple tabs in one window, each with its own grid (e.g. `"2x2,1x2,1x2"`) |
+| `--run <cmd>` | Command for the next pane in order (repeatable); with `--tabs`, commands flow across tabs |
+| `--all` | Run the single `--run` command in every pane |
+| `--dir <path>` | Working directory — every pane `cd`s there first |
+| `--max` | Maximize the new window (not native fullscreen) |
+
+Examples:
+
+```bash
+# 2x2 grid, run codewith in all four panes, maximized
+computer open ghostty --grid 2x2 --run "codewith" --all --max
+
+# 2x2 grid with a different command per pane
+computer open ghostty --grid 2x2 --run "htop" --run "btop" --run "vim" --run "bun dev"
+
+# Three tabs (2x2, then two 1x2), every pane cd'd into the project
+computer open ghostty --tabs "2x2,1x2,1x2" --dir ~/Workspace/myproject
+```
+
+**Drivers:**
+
+- **ghostty** — Ghostty terminal (macOS, Ghostty 1.3+). Uses Ghostty's native
+  AppleScript dictionary for windows, tabs, and splits. Requires
+  `/Applications/Ghostty.app` (or `ghostty` on PATH).
+
+Drivers are app-generic: each implements `available()` (with a reason when
+unavailable, e.g. on Linux) and `open(spec)`. New drivers register in
+`src/apps/registry.ts`.
+
+The same surface is exposed over MCP via `computer_open_app`
+(params: `app`, `grid`, `tabs`, `run[]`, `all`, `dir`, `max` — falls back to a
+plain macOS app launch for apps without a driver) and `computer_list_apps`.
+
 ## MCP Server
 
 Add to your Claude Code config:
@@ -159,6 +210,22 @@ const result = await driver.execute({
 
 Sessions and action logs are stored in `~/.hasna/computer/computer.db` (SQLite).
 
+## Storage Sync
+
+Optional Postgres sync is available through package-local commands:
+
+```bash
+export HASNA_COMPUTER_DATABASE_URL=postgres://...
+computer storage status
+computer storage push
+computer storage pull
+computer storage sync
+```
+
+The MCP server also exposes `storage_status`, `storage_push`, `storage_pull`, and `storage_sync`.
+
+`COMPUTER_DATABASE_URL` is accepted as the non-Hasna fallback database URL.
+
 ## License
 
 Apache-2.0

package/dist/apps/ghostty/applescript.d.ts

@@ -0,0 +1,36 @@
+import type { PaneGrid } from "../types.js";
+/** Parse "RxC" (e.g. "2x2", "3x1") into a PaneGrid. Throws on invalid input. */
+export declare function parseGrid(spec: string): PaneGrid;
+/** Parse a comma-separated tabs spec like "2x2,1x2,1x2" into one grid per tab. */
+export declare function parseTabsSpec(spec: string): PaneGrid[];
+/** Escape a string for embedding inside an AppleScript double-quoted literal. */
+export declare function escapeAppleScript(s: string): string;
+/** Single-quote a string for POSIX shells (used for `cd <dir>`). */
+export declare function shellQuote(s: string): string;
+/**
+ * Map run commands onto panes (row-major across tabs in order).
+ * - `all` fills every pane with the single command (requires exactly one).
+ * - Otherwise commands are assigned in order; extra panes get undefined.
+ * Throws when there are more commands than panes.
+ */
+export declare function assignPaneCommands(totalPanes: number, run: string[], all: boolean): (string | undefined)[];
+export interface GhosttyScriptOptions {
+    /** One grid per tab; the first tab reuses the new window's selected tab. */
+    tabs: PaneGrid[];
+    /** Command per pane, row-major across tabs in order. undefined = empty shell. */
+    commands?: (string | undefined)[];
+    /** Working directory — every pane cds here before its command. */
+    dir?: string;
+    /** Maximize the new window (toggle_maximize, not native fullscreen). */
+    max?: boolean;
+}
+/**
+ * Build the full AppleScript for opening one Ghostty window with the given
+ * tabs/grids/commands. Pure — returns the script string.
+ *
+ * Grid algorithm (per tab): build column 0 downward (split direction down
+ * from the previous row), then split each row rightward C-1 times, then
+ * equalize once. Commands inject row-major with `input text` + enter key.
+ */
+export declare function buildGhosttyScript(opts: GhosttyScriptOptions): string;
+//# sourceMappingURL=applescript.d.ts.map

package/dist/apps/ghostty/applescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.d.ts","sourceRoot":"","sources":["../../../src/apps/ghostty/applescript.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAShD;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAMtD;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EAAE,EACb,GAAG,EAAE,OAAO,GACX,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAWxB;AAED,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAClC,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAiErE"}

package/dist/apps/ghostty/applescript.test.d.ts

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

package/dist/apps/ghostty/applescript.test.d.ts.map

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

package/dist/apps/ghostty/driver.d.ts

@@ -0,0 +1,10 @@
+import type { AppAvailability, AppDriver } from "../types.js";
+export interface GhosttyEnvironment {
+    platform?: NodeJS.Platform | string;
+    hasAppBundle?: boolean;
+    hasBinary?: boolean;
+}
+/** Availability check, injectable for tests. */
+export declare function ghosttyAvailability(env?: GhosttyEnvironment): AppAvailability;
+export declare const ghosttyDriver: AppDriver;
+//# sourceMappingURL=driver.d.ts.map

package/dist/apps/ghostty/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/apps/ghostty/driver.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAwC,MAAM,aAAa,CAAC;AAKpG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,kBAAuB,GAAG,eAAe,CAWjF;AAmBD,eAAO,MAAM,aAAa,EAAE,SAiD3B,CAAC"}

package/dist/apps/registry.d.ts

@@ -0,0 +1,5 @@
+import type { AppDriver } from "./types.js";
+export declare function registerAppDriver(driver: AppDriver): void;
+export declare function getAppDriver(name: string): AppDriver | undefined;
+export declare function listAppDrivers(): AppDriver[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/apps/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/apps/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEhE;AAED,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAE5C"}

package/dist/apps/registry.test.d.ts

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

package/dist/apps/registry.test.d.ts.map

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

package/dist/apps/types.d.ts

@@ -0,0 +1,47 @@
+/** A pane grid: R rows x C cols. Panes are addressed row-major. */
+export interface PaneGrid {
+    rows: number;
+    cols: number;
+}
+/** Declarative description of how to open/arrange an app. */
+export interface AppOpenSpec {
+    /** Split the window into rows x cols panes (single tab). */
+    grid?: PaneGrid;
+    /** Multiple tabs in one window, each with its own grid. Overrides `grid`. */
+    tabs?: PaneGrid[];
+    /** Commands per pane, row-major across tabs in order. */
+    run?: string[];
+    /** Fill every pane with the single `run` command. */
+    all?: boolean;
+    /** Working directory — every pane cds here before running its command. */
+    dir?: string;
+    /** Maximize the new window (not native fullscreen). */
+    max?: boolean;
+}
+/** Whether a driver can run on this machine, and why not if it can't. */
+export interface AppAvailability {
+    available: boolean;
+    /** Human-readable reason when unavailable. */
+    reason?: string;
+}
+/** Result of an open() call. */
+export interface AppOpenResult {
+    ok: boolean;
+    message: string;
+    /** Total panes created (when applicable). */
+    panes?: number;
+    /** Tabs created (when applicable). */
+    tabs?: number;
+}
+/** A deterministic driver for one desktop application. */
+export interface AppDriver {
+    /** Registry key, e.g. "ghostty". Lowercase. */
+    name: string;
+    /** One-line human description. */
+    description: string;
+    /** Check availability on this machine. */
+    available(): AppAvailability;
+    /** Open/orchestrate the app according to spec. */
+    open(spec: AppOpenSpec): Promise<AppOpenResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/apps/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/apps/types.ts"],"names":[],"mappings":"AAOA,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClB,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,qDAAqD;IACrD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,SAAS,IAAI,eAAe,CAAC;IAC7B,kDAAkD;IAClD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACjD"}