@moejay/wrightty 0.1.0 → 0.2.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+/** wrightty CLI for Node.js — control terminals from the command line. */
+export {};

package/dist/cli.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+"use strict";
+/** wrightty CLI for Node.js — control terminals from the command line. */
+Object.defineProperty(exports, "__esModule", { value: true });
+const terminal_1 = require("./terminal");
+const args = process.argv.slice(2);
+const command = args[0];
+function usage() {
+    console.log(`wrightty-js — Playwright for terminals (Node.js)
+
+Note: This is a client CLI. To start a server: cargo install wrightty
+
+Usage:
+  wrightty-js run <command> [--timeout <s>]   Run a command and print output
+  wrightty-js read                            Read the terminal screen
+  wrightty-js send-text <text>                Send raw text
+  wrightty-js send-keys <key> [<key>...]      Send keystrokes
+  wrightty-js screenshot [--format svg|text]  Take a screenshot
+  wrightty-js wait-for <pattern> [--timeout]  Wait for text on screen
+  wrightty-js info                            Show server info
+  wrightty-js size                            Get terminal dimensions
+  wrightty-js discover                        Find running servers
+
+Options:
+  --url <url>         Server URL (default: auto-discover)
+  --session <id>      Session ID (default: first available)
+  --password <pass>   Password for server authentication
+  --help              Show this help`);
+}
+function getOpt(name) {
+    const idx = args.indexOf(name);
+    return idx >= 0 && idx + 1 < args.length ? args[idx + 1] : undefined;
+}
+function hasFlag(name) {
+    return args.includes(name);
+}
+async function getTerminal() {
+    const url = getOpt("--url");
+    const sessionId = getOpt("--session");
+    const password = getOpt("--password");
+    return terminal_1.Terminal.connect({ url, sessionId, password });
+}
+async function main() {
+    if (!command || hasFlag("--help") || hasFlag("-h")) {
+        usage();
+        process.exit(0);
+    }
+    try {
+        switch (command) {
+            case "discover": {
+                const servers = await terminal_1.Terminal.discover();
+                if (servers.length === 0) {
+                    console.log("No wrightty servers found.");
+                }
+                else {
+                    for (const s of servers) {
+                        const name = s.name ? ` [${s.name}]` : "";
+                        const auth = s.authentication ? ` (auth: ${s.authentication})` : "";
+                        console.log(`  ${s.url}  ${s.implementation} v${s.version}${name}${auth}`);
+                    }
+                }
+                break;
+            }
+            case "run": {
+                const cmd = args[1];
+                if (!cmd) {
+                    console.error("Usage: wrightty-js run <command>");
+                    process.exit(1);
+                }
+                const timeout = parseInt(getOpt("--timeout") ?? "30", 10) * 1000;
+                const term = await getTerminal();
+                const output = await term.run(cmd, timeout);
+                console.log(output);
+                term.close();
+                break;
+            }
+            case "read": {
+                const term = await getTerminal();
+                console.log(await term.readScreen());
+                term.close();
+                break;
+            }
+            case "send-text": {
+                const text = args[1];
+                if (!text) {
+                    console.error("Usage: wrightty-js send-text <text>");
+                    process.exit(1);
+                }
+                const term = await getTerminal();
+                await term.sendText(text.replace(/\\n/g, "\n"));
+                term.close();
+                break;
+            }
+            case "send-keys": {
+                const keys = args.slice(1).filter(k => !k.startsWith("--"));
+                if (keys.length === 0) {
+                    console.error("Usage: wrightty-js send-keys <key> [...]");
+                    process.exit(1);
+                }
+                const term = await getTerminal();
+                await term.sendKeys(...keys);
+                term.close();
+                break;
+            }
+            case "screenshot": {
+                const format = (getOpt("--format") ?? "text");
+                const term = await getTerminal();
+                const result = await term.screenshot(format);
+                console.log(result.data);
+                term.close();
+                break;
+            }
+            case "wait-for": {
+                const pattern = args[1];
+                if (!pattern) {
+                    console.error("Usage: wrightty-js wait-for <pattern>");
+                    process.exit(1);
+                }
+                const timeout = parseInt(getOpt("--timeout") ?? "30", 10) * 1000;
+                const term = await getTerminal();
+                const screen = await term.waitFor(pattern, timeout);
+                console.log(screen);
+                term.close();
+                break;
+            }
+            case "info": {
+                const term = await getTerminal();
+                console.log(JSON.stringify(await term.getInfo(), null, 2));
+                term.close();
+                break;
+            }
+            case "size": {
+                const term = await getTerminal();
+                const [cols, rows] = await term.getSize();
+                console.log(`${cols}x${rows}`);
+                term.close();
+                break;
+            }
+            default:
+                console.error(`Unknown command: ${command}`);
+                usage();
+                process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+main();

package/dist/terminal.d.ts

@@ -35,6 +35,8 @@ export declare class Terminal {
     resize(cols: number, rows: number): Promise<void>;
     /** Get server info and capabilities. */
     getInfo(): Promise<Record<string, any>>;
+    /** Authenticate with the server using a password. */
+    authenticate(password: string): Promise<void>;
     /** Start recording raw PTY I/O (asciicast v2 format). */
     startSessionRecording(includeInput?: boolean): Promise<string>;
     /** Stop a session recording and return asciicast data. */

package/dist/terminal.js

@@ -29,6 +29,8 @@ class Terminal {
                         version: info.version ?? "unknown",
                         implementation: info.implementation ?? "unknown",
                         capabilities: info.capabilities ?? {},
+                        name: info.name,
+                        authentication: info.authentication,
                     });
                 }
                 finally {
@@ -56,6 +58,14 @@ class Terminal {
             url = servers[0].url;
         }
         const client = await client_1.WrighttyClient.connect(url, options.timeout ?? 5000);
+        const info = await client.request("Wrightty.getInfo");
+        if (info.authentication === "password") {
+            if (!options.password) {
+                client.close();
+                throw new Error("Server requires password authentication but no password was provided");
+            }
+            await client.request("Wrightty.authenticate", { password: options.password });
+        }
         let sessionId = options.sessionId;
         if (!sessionId) {
             const result = await client.request("Session.list");
@@ -68,6 +78,14 @@ class Terminal {
     static async spawn(options = {}) {
         const url = options.serverUrl ?? "ws://127.0.0.1:9420";
         const client = await client_1.WrighttyClient.connect(url);
+        const info = await client.request("Wrightty.getInfo");
+        if (info.authentication === "password") {
+            if (!options.password) {
+                client.close();
+                throw new Error("Server requires password authentication but no password was provided");
+            }
+            await client.request("Wrightty.authenticate", { password: options.password });
+        }
         const result = await client.request("Session.create", {
             cols: options.cols ?? 120,
             rows: options.rows ?? 40,
@@ -174,6 +192,10 @@ class Terminal {
     async getInfo() {
         return this.client.request("Wrightty.getInfo");
     }
+    /** Authenticate with the server using a password. */
+    async authenticate(password) {
+        await this.client.request("Wrightty.authenticate", { password });
+    }
     // --- Recording ---
     /** Start recording raw PTY I/O (asciicast v2 format). */
     async startSessionRecording(includeInput = false) {

package/dist/types.d.ts

@@ -3,6 +3,8 @@ export interface ServerInfo {
     version: string;
     implementation: string;
     capabilities: Capabilities;
+    name?: string;
+    authentication: "none" | "password";
 }
 export interface Capabilities {
     screenshot: ScreenshotFormat[];
@@ -72,6 +74,8 @@ export interface DiscoveredServer {
     version: string;
     implementation: string;
     capabilities: Capabilities;
+    name?: string;
+    authentication?: string;
 }
 export interface ConnectOptions {
     /** Server URL (default: auto-discover) */
@@ -80,6 +84,8 @@ export interface ConnectOptions {
     sessionId?: string;
     /** Connection timeout in ms (default: 5000) */
     timeout?: number;
+    /** Password for server authentication */
+    password?: string;
 }
 export interface SpawnOptions {
     shell?: string;
@@ -87,4 +93,6 @@ export interface SpawnOptions {
     rows?: number;
     cwd?: string;
     serverUrl?: string;
+    /** Password for server authentication */
+    password?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moejay/wrightty",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Node.js SDK for Wrightty terminal automation protocol",
   "author": "Moe Jay",
   "homepage": "https://github.com/moejay/wrightty",
@@ -14,6 +14,9 @@
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "wrightty-js": "dist/cli.js"
+  },
   "files": [
     "dist"
   ],