pty-wrap 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# pty-wrap
+
+PTY wrapper for capturing terminal sessions via MQTT.
+
+## Installation
+
+```bash
+npm install -g pty-wrap
+```
+
+## Usage
+
+```bash
+# Capture any command
+pty-wrap <command> [args...]
+
+# Examples
+pty-wrap claude
+pty-wrap bash
+pty-wrap vim file.txt
+```
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MQTT_URL` | `mqtt://localhost:1883` | MQTT broker URL |
+| `SESSION_ID` | Auto-generated UUID | Custom session identifier |
+
+## How It Works
+
+1. Spawns the target command in a PTY (pseudo-terminal)
+2. Captures all input/output streams
+3. Publishes to MQTT topic `sessions/{SESSION_ID}/stream`
+4. Transparently proxies terminal I/O
+
+## Requirements
+
+- Node.js >= 18.0.0
+- MQTT broker (e.g., EMQX, Mosquitto)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+import * as pty from 'node-pty';
+import mqtt from 'mqtt';
+import { v4 as uuidv4 } from 'uuid';
+import os from 'os';
+import { execSync } from 'child_process';
+const MQTT_URL = process.env.MQTT_URL || 'mqtt://localhost:1883';
+const SESSION_ID = process.env.SESSION_ID || uuidv4();
+const SHELL = process.env.SHELL || (os.platform() === 'win32' ? 'powershell.exe' : 'bash');
+const COMMAND = process.argv.slice(2);
+function resolveCommand(cmd) {
+    try {
+        const command = os.platform() === 'win32' ? `where ${cmd}` : `which ${cmd}`;
+        const result = execSync(command, { encoding: 'utf-8' }).trim();
+        return result.split('\n')[0].trim();
+    }
+    catch {
+        return cmd;
+    }
+}
+let seq = 0;
+const topic = `sessions/${SESSION_ID}/stream`;
+const client = mqtt.connect(MQTT_URL, {
+    clientId: `pty-wrapper-${SESSION_ID}`,
+    clean: false,
+});
+function publish(stream, payload) {
+    const msg = {
+        session_id: SESSION_ID,
+        seq: seq++,
+        ts: new Date().toISOString(),
+        stream,
+        payload,
+        encoding: 'utf-8',
+    };
+    client.publish(topic, JSON.stringify(msg), { qos: 1 });
+}
+client.on('connect', () => {
+    console.error(`[pty-wrapper] Connected to MQTT, session: ${SESSION_ID}`);
+    publish('event', JSON.stringify({
+        type: 'session_start',
+        cwd: process.cwd(),
+        host: os.hostname(),
+        shell: SHELL,
+        command: COMMAND.length > 0 ? COMMAND : undefined,
+    }));
+    const cols = process.stdout.columns || 80;
+    const rows = process.stdout.rows || 24;
+    const cmd = COMMAND.length > 0 ? resolveCommand(COMMAND[0]) : SHELL;
+    const args = COMMAND.length > 1 ? COMMAND.slice(1) : [];
+    const ptyProcess = pty.spawn(cmd, args, {
+        name: 'xterm-256color',
+        cols,
+        rows,
+        cwd: process.cwd(),
+        env: process.env,
+    });
+    ptyProcess.onData((data) => {
+        publish('output', data);
+        process.stdout.write(data);
+    });
+    if (process.stdin.isTTY) {
+        process.stdin.setRawMode(true);
+    }
+    process.stdin.resume();
+    process.stdin.on('data', (data) => {
+        const str = data.toString();
+        publish('input', str);
+        ptyProcess.write(str);
+    });
+    process.stdout.on('resize', () => {
+        const newCols = process.stdout.columns || 80;
+        const newRows = process.stdout.rows || 24;
+        ptyProcess.resize(newCols, newRows);
+        publish('event', JSON.stringify({ type: 'resize', cols: newCols, rows: newRows }));
+    });
+    ptyProcess.onExit(({ exitCode }) => {
+        publish('event', JSON.stringify({ type: 'session_end', exit_code: exitCode }));
+        setTimeout(() => {
+            client.end();
+            process.exit(exitCode);
+        }, 500);
+    });
+    process.on('SIGINT', () => ptyProcess.write('\x03'));
+    process.on('SIGTERM', () => {
+        ptyProcess.kill();
+        client.end();
+    });
+});
+client.on('error', (err) => {
+    console.error('[pty-wrapper] MQTT error:', err.message);
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "pty-wrap",
+  "version": "1.0.0",
+  "description": "PTY wrapper for capturing terminal sessions via MQTT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "pty-wrap": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node --loader ts-node/esm src/index.ts",
+    "build": "tsc",
+    "dev": "node --loader ts-node/esm --watch src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["pty", "terminal", "session", "capture", "mqtt", "cli"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "mqtt": "^5.3.0",
+    "node-pty": "^1.0.0",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/uuid": "^9.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.0"
+  }
+}