@hasna/computer 0.1.8 → 0.1.9

package/LICENSE

@@ -1,3 +1,4 @@
+
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -34,7 +35,8 @@
 
       "Work" shall mean the work of authorship, whether in Source or
       Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work.
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
 
       "Derivative Works" shall mean any work, whether in Source or Object
       form, that is based on (or derived from) the Work and for which the
@@ -174,7 +176,7 @@
 
    END OF TERMS AND CONDITIONS
 
-   Copyright 2026 Andrei Hasna
+   Copyright 2026 Hasna, Inc.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

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:
@@ -67,6 +118,19 @@ Add to your Claude Code config:
 }
 ```
 
+## HTTP mode
+
+Shared Streamable HTTP transport for multi-agent sessions (stdio remains the default):
+
+```bash
+computer-mcp --http              # http://127.0.0.1:8806/mcp
+MCP_HTTP=1 computer-mcp          # same via env
+computer-mcp --http --port 9000    # override port
+```
+
+- Health: `GET http://127.0.0.1:8806/health` → `{"status":"ok","name":"computer"}`
+- MCP endpoint is also mounted on `computer-serve` at `/mcp`.
+
 **Available tools:**
 - `computer_run_task` — Run a full computer use task
 - `computer_screenshot` — Capture the screen
@@ -146,19 +210,21 @@ const result = await driver.execute({
 
 Sessions and action logs are stored in `~/.hasna/computer/computer.db` (SQLite).
 
-## Cloud Sync
+## Storage Sync
 
 Optional Postgres sync is available through package-local commands:
 
 ```bash
-export HASNA_COMPUTER_CLOUD_DATABASE_URL=postgres://...
-computer cloud status
-computer cloud push
-computer cloud pull
-computer cloud sync
+export HASNA_COMPUTER_DATABASE_URL=postgres://...
+computer storage status
+computer storage push
+computer storage pull
+computer storage sync
 ```
 
-The MCP server also exposes `cloud_status`, `cloud_push`, `cloud_pull`, and `cloud_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
 

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"}