@dmsdc-ai/aigentry-telepty 0.1.6 → 0.1.8

package/README.md

@@ -55,3 +55,14 @@ npm run test:watch
 ```
 
 The automated suite covers config generation, daemon HTTP APIs, WebSocket attach/output flow, bus events, session deletion regressions, and CLI smoke tests against a real daemon process.
+
+## Skill Installation
+
+The package installer opens the telepty skill TUI automatically when you run it in a terminal.
+
+To reopen it later, run `telepty` and choose `Install telepty skills`.
+
+The TUI lets you choose:
+- which packaged skills to install
+- which target clients to install into (`Claude Code`, `Codex`, `Gemini`)
+- whether each target uses a global path, the current project path, or a custom path

package/cli.js

@@ -9,6 +9,8 @@ const prompts = require('prompts');
 const updateNotifier = require('update-notifier');
 const pkg = require('./package.json');
 const { getConfig } = require('./auth');
+const { attachInteractiveTerminal } = require('./interactive-terminal');
+const { runInteractiveSkillInstaller } = require('./skill-installer');
 const args = process.argv.slice(2);
 
 // Check for updates unless explicitly disabled for tests/CI.
@@ -91,29 +93,24 @@ async function ensureDaemonRunning() {
 async function manageInteractiveAttach(sessionId, targetHost) {
   const wsUrl = `ws://${targetHost}:${PORT}/api/sessions/${encodeURIComponent(sessionId)}?token=${encodeURIComponent(TOKEN)}`;
   const ws = new WebSocket(wsUrl);
-  let inputHandler = null;
-  let resizeHandler = null;
+  let cleanupTerminal = null;
   return new Promise((resolve) => {
     ws.on('open', () => {
       // Set Ghostty tab title to show session ID
       process.stdout.write(`\x1b]0;⚡ telepty :: ${sessionId}\x07`);
       console.log(`\n\x1b[32mEntered room '${sessionId}'.\x1b[0m\n`);
-      if (process.stdin.isTTY) process.stdin.setRawMode(true);
-      inputHandler = (d) => ws.send(JSON.stringify({ type: 'input', data: d.toString() }));
-      resizeHandler = () => ws.send(JSON.stringify({ type: 'resize', cols: process.stdout.columns, rows: process.stdout.rows }));
-      process.stdin.on('data', inputHandler);
-      process.stdout.on('resize', resizeHandler);
-      resizeHandler();
+      cleanupTerminal = attachInteractiveTerminal(process.stdin, process.stdout, {
+        onData: (d) => ws.send(JSON.stringify({ type: 'input', data: d.toString() })),
+        onResize: () => ws.send(JSON.stringify({ type: 'resize', cols: process.stdout.columns, rows: process.stdout.rows }))
+      });
     });
     ws.on('message', m => {
       const msg = JSON.parse(m);
       if (msg.type === 'output') process.stdout.write(msg.data);
     });
     ws.on('close', async () => {
-      if (process.stdin.isTTY) process.stdin.setRawMode(false);
       process.stdout.write(`\x1b]0;\x07`); // Restore default terminal title
-      if (inputHandler) process.stdin.off('data', inputHandler);
-      if (resizeHandler) process.stdout.off('resize', resizeHandler);
+      if (cleanupTerminal) cleanupTerminal();
 
       // Check if other clients are still attached before destroying
       try {
@@ -152,6 +149,7 @@ async function manageInteractive() {
         { title: '🔌  Allow inject (Run CLI with inject)', value: 'allow' },
         { title: '💬  Send message to a room (Inject command)', value: 'inject' },
         { title: '📋  View all open rooms (List sessions)', value: 'list' },
+        { title: '🧠  Install telepty skills', value: 'install-skills' },
         { title: '🔄  Update telepty to latest version', value: 'update' },
         { title: '❌  Exit', value: 'exit' }
       ]
@@ -189,6 +187,15 @@ async function manageInteractive() {
       continue;
     }
 
+    if (response.action === 'install-skills') {
+      try {
+        await runInteractiveSkillInstaller({ packageRoot: __dirname, cwd: process.cwd() });
+      } catch (e) {
+        console.error(`\n❌ ${e.message}\n`);
+      }
+      continue;
+    }
+
     if (response.action === 'list') {
       console.log('\n');
       const sessions = await discoverSessions();
@@ -469,11 +476,13 @@ async function main() {
     process.stdout.write(`\x1b]0;⚡ telepty :: ${sessionId}\x07`);
     console.log(`\x1b[32m⚡ '${command}' is now session '\x1b[36m${sessionId}\x1b[32m'. Inject allowed.\x1b[0m\n`);
 
-    // Enter raw mode and relay stdin to local PTY
-    if (process.stdin.isTTY) process.stdin.setRawMode(true);
-
-    process.stdin.on('data', (data) => {
-      child.write(data.toString());
+    const cleanupTerminal = attachInteractiveTerminal(process.stdin, process.stdout, {
+      onData: (data) => {
+        child.write(data.toString());
+      },
+      onResize: () => {
+        child.resize(process.stdout.columns, process.stdout.rows);
+      }
     });
 
     // Relay PTY output to current terminal + send to daemon for attach clients
@@ -484,14 +493,9 @@ async function main() {
       }
     });
 
-    // Handle terminal resize
-    process.stdout.on('resize', () => {
-      child.resize(process.stdout.columns, process.stdout.rows);
-    });
-
     // Handle child exit
     child.onExit(({ exitCode }) => {
-      if (process.stdin.isTTY) process.stdin.setRawMode(false);
+      cleanupTerminal();
       process.stdout.write(`\x1b]0;\x07`);
       console.log(`\n\x1b[33mSession '${sessionId}' exited (code ${exitCode}).\x1b[0m`);
 
@@ -540,8 +544,7 @@ async function main() {
 
     const wsUrl = `ws://${targetHost}:${PORT}/api/sessions/${encodeURIComponent(sessionId)}?token=${encodeURIComponent(TOKEN)}`;
     const ws = new WebSocket(wsUrl);
-    let inputHandler = null;
-    let resizeHandler = null;
+    let cleanupTerminal = null;
 
     ws.on('open', () => {
       // Set Ghostty tab title to show session ID
@@ -549,25 +552,18 @@ async function main() {
       process.stdout.write(`\x1b]0;⚡ telepty :: ${sessionId}${hostSuffix}\x07`);
       console.log(`\x1b[32mEntered room '${sessionId}'${hostSuffix ? ` (${targetHost})` : ''}.\x1b[0m\n`);
 
-      if (process.stdin.isTTY) {
-        process.stdin.setRawMode(true);
-      }
-
-      inputHandler = (data) => {
-        ws.send(JSON.stringify({ type: 'input', data: data.toString() }));
-      };
-      process.stdin.on('data', inputHandler);
-
-      resizeHandler = () => {
-        ws.send(JSON.stringify({
-          type: 'resize',
-          cols: process.stdout.columns,
-          rows: process.stdout.rows
-        }));
-      };
-
-      process.stdout.on('resize', resizeHandler);
-      resizeHandler(); // Initial resize
+      cleanupTerminal = attachInteractiveTerminal(process.stdin, process.stdout, {
+        onData: (data) => {
+          ws.send(JSON.stringify({ type: 'input', data: data.toString() }));
+        },
+        onResize: () => {
+          ws.send(JSON.stringify({
+            type: 'resize',
+            cols: process.stdout.columns,
+            rows: process.stdout.rows
+          }));
+        }
+      });
     });
 
     ws.on('message', (message) => {
@@ -578,12 +574,8 @@ async function main() {
     });
 
     ws.on('close', async (code, reason) => {
-      if (process.stdin.isTTY) {
-        process.stdin.setRawMode(false);
-      }
       process.stdout.write(`\x1b]0;\x07`); // Restore default terminal title
-      if (inputHandler) process.stdin.off('data', inputHandler);
-      if (resizeHandler) process.stdout.off('resize', resizeHandler);
+      if (cleanupTerminal) cleanupTerminal();
 
       // Check if other clients are still attached before destroying
       try {

package/install.js

@@ -4,6 +4,7 @@ const { execSync, spawn } = require('child_process');
 const os = require('os');
 const fs = require('fs');
 const path = require('path');
+const { runInteractiveSkillInstaller } = require('./skill-installer');
 
 console.log("🚀 Installing @dmsdc-ai/aigentry-telepty...");
 
@@ -16,38 +17,69 @@ function run(cmd) {
   }
 }
 
-// 1. Install globally via npm
-console.log("📦 Installing package globally...");
-run("npm install -g @dmsdc-ai/aigentry-telepty");
+function resolveInstalledPackageRoot() {
+  try {
+    const globalRoot = execSync('npm root -g', { encoding: 'utf8' }).trim();
+    return path.join(globalRoot, '@dmsdc-ai', 'aigentry-telepty');
+  } catch (e) {
+    return __dirname;
+  }
+}
+
+async function installSkills() {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    console.log('⏭️  Skipping interactive skill installation (no TTY).');
+    console.log('   Run `telepty` later and choose "Install telepty skills".');
+    return;
+  }
+
+  console.log('\n📋 Telepty skill installation');
 
-// 2. Find executable
-let teleptyPath = '';
-try {
-  teleptyPath = execSync(os.platform() === 'win32' ? 'where telepty' : 'which telepty', { encoding: 'utf8' }).split('\n')[0].trim();
-} catch (e) {
-  teleptyPath = 'telepty'; // fallback
+  try {
+    await runInteractiveSkillInstaller({
+      packageRoot: resolveInstalledPackageRoot(),
+      cwd: process.cwd()
+    });
+  } catch (e) {
+    console.warn('⚠️ Could not install telepty skills:', e.message);
+  }
 }
 
-// 3. Setup OS-specific autostart or background daemon
-const platform = os.platform();
-
-if (platform === 'win32') {
-  console.log("⚙️ Setting up Windows background process...");
-  // Launch daemon in background detaching from current console
-  const subprocess = spawn(teleptyPath, ['daemon'], {
-    detached: true,
-    stdio: 'ignore',
-    windowsHide: true
-  });
-  subprocess.unref();
-  console.log("✅ Windows daemon started in background.");
-
-} else if (platform === 'darwin') {
-  console.log("⚙️ Setting up macOS launchd service...");
-  const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'com.aigentry.telepty.plist');
-  fs.mkdirSync(path.dirname(plistPath), { recursive: true });
-  
-  const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
+(async () => {
+  // 1. Install globally via npm
+  console.log("📦 Installing package globally...");
+  run("npm install -g @dmsdc-ai/aigentry-telepty");
+
+  // 2. Install telepty skills for supported clients
+  await installSkills();
+
+  // 3. Find executable
+  let teleptyPath = '';
+  try {
+    teleptyPath = execSync(os.platform() === 'win32' ? 'where telepty' : 'which telepty', { encoding: 'utf8' }).split('\n')[0].trim();
+  } catch (e) {
+    teleptyPath = 'telepty'; // fallback
+  }
+
+  // 4. Setup OS-specific autostart or background daemon
+  const platform = os.platform();
+
+  if (platform === 'win32') {
+    console.log("⚙️ Setting up Windows background process...");
+    const subprocess = spawn(teleptyPath, ['daemon'], {
+      detached: true,
+      stdio: 'ignore',
+      windowsHide: true
+    });
+    subprocess.unref();
+    console.log("✅ Windows daemon started in background.");
+
+  } else if (platform === 'darwin') {
+    console.log("⚙️ Setting up macOS launchd service...");
+    const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'com.aigentry.telepty.plist');
+    fs.mkdirSync(path.dirname(plistPath), { recursive: true });
+
+    const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
@@ -64,20 +96,19 @@ if (platform === 'win32') {
     <true/>
 </dict>
 </plist>`;
-  
-  fs.writeFileSync(plistPath, plistContent);
-  try { execSync(`launchctl unload "${plistPath}" 2>/dev/null`); } catch(e){}
-  run(`launchctl load "${plistPath}"`);
-  console.log("✅ macOS LaunchAgent installed and started.");
-
-} else {
-  // Linux
-  try {
-    // Check if systemd is available and running as root/sudo
-    execSync('systemctl --version', { stdio: 'ignore' });
-    if (process.getuid && process.getuid() === 0) {
-      console.log("⚙️ Setting up systemd service for Linux...");
-      const serviceContent = `[Unit]
+
+    fs.writeFileSync(plistPath, plistContent);
+    try { execSync(`launchctl unload "${plistPath}" 2>/dev/null`); } catch(e){}
+    run(`launchctl load "${plistPath}"`);
+    console.log("✅ macOS LaunchAgent installed and started.");
+
+  } else {
+    // Linux
+    try {
+      execSync('systemctl --version', { stdio: 'ignore' });
+      if (process.getuid && process.getuid() === 0) {
+        console.log("⚙️ Setting up systemd service for Linux...");
+        const serviceContent = `[Unit]
 Description=Telepty Daemon
 After=network.target
 
@@ -90,25 +121,26 @@ Environment=NODE_ENV=production
 
 [Install]
 WantedBy=multi-user.target`;
-      
-      fs.writeFileSync('/etc/systemd/system/telepty.service', serviceContent);
-      run('systemctl daemon-reload');
-      run('systemctl enable telepty');
-      run('systemctl start telepty');
-      console.log("✅ Systemd service installed and started.");
-      process.exit(0);
-    }
-  } catch(e) {}
-
-  // Fallback for Linux without systemd or non-root
-  console.log("⚠️ Skipping systemd (no root or no systemd). Starting in background...");
-  const subprocess = spawn(teleptyPath, ['daemon'], {
-    detached: true,
-    stdio: 'ignore'
-  });
-  subprocess.unref();
-  console.log("✅ Linux daemon started in background using nohup equivalent.");
-}
 
-console.log("\n🎉 Installation complete! Telepty daemon is running.");
-console.log("👉 Try running: telepty attach\n");
+        fs.writeFileSync('/etc/systemd/system/telepty.service', serviceContent);
+        run('systemctl daemon-reload');
+        run('systemctl enable telepty');
+        run('systemctl start telepty');
+        console.log("✅ Systemd service installed and started.");
+        process.exit(0);
+      }
+    } catch(e) {}
+
+    // Fallback for Linux without systemd or non-root
+    console.log("⚠️ Skipping systemd (no root or no systemd). Starting in background...");
+    const subprocess = spawn(teleptyPath, ['daemon'], {
+      detached: true,
+      stdio: 'ignore'
+    });
+    subprocess.unref();
+    console.log("✅ Linux daemon started in background using nohup equivalent.");
+  }
+
+  console.log("\n🎉 Installation complete! Telepty daemon is running.");
+  console.log("👉 Try running: telepty attach\n");
+})();

package/install.ps1

@@ -31,3 +31,4 @@ Write-Host "Success: Windows daemon started in background." -ForegroundColor Gre
 
 Write-Host "`nInstallation complete! Telepty daemon is running." -ForegroundColor Cyan
 Write-Host "Next step: Try running: telepty attach" -ForegroundColor Yellow
+Write-Host "Optional: Run telepty and choose 'Install telepty skills' to add skills for Claude Code, Codex, or Gemini" -ForegroundColor Yellow

package/install.sh

@@ -116,3 +116,4 @@ fi
 echo ""
 echo "🎉 Installation complete! Telepty daemon is running in the background."
 echo "👉 Try running: telepty attach"
+echo "👉 Optional: run telepty and choose 'Install telepty skills' to add skills for Claude Code, Codex, or Gemini"

package/interactive-terminal.js

@@ -0,0 +1,54 @@
+'use strict';
+
+function removeListener(stream, eventName, handler) {
+  if (!handler || !stream) {
+    return;
+  }
+
+  if (typeof stream.off === 'function') {
+    stream.off(eventName, handler);
+    return;
+  }
+
+  if (typeof stream.removeListener === 'function') {
+    stream.removeListener(eventName, handler);
+  }
+}
+
+function attachInteractiveTerminal(input, output, handlers = {}) {
+  const { onData = null, onResize = null } = handlers;
+
+  if (input && input.isTTY && typeof input.setRawMode === 'function') {
+    input.setRawMode(true);
+  }
+
+  if (input && typeof input.resume === 'function') {
+    input.resume();
+  }
+
+  if (input && onData) {
+    input.on('data', onData);
+  }
+
+  if (output && onResize) {
+    output.on('resize', onResize);
+    onResize();
+  }
+
+  return () => {
+    removeListener(input, 'data', onData);
+    removeListener(output, 'resize', onResize);
+
+    if (input && input.isTTY && typeof input.setRawMode === 'function') {
+      input.setRawMode(false);
+    }
+
+    if (input && typeof input.pause === 'function') {
+      input.pause();
+    }
+  };
+}
+
+module.exports = {
+  attachInteractiveTerminal
+};

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dmsdc-ai/aigentry-telepty",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "main": "daemon.js",
   "bin": {
     "telepty": "cli.js",
     "telepty-install": "install.js"
   },
   "scripts": {
-    "test": "node --test test/auth.test.js test/daemon.test.js test/cli.test.js",
-    "test:watch": "node --test --watch test/auth.test.js test/daemon.test.js test/cli.test.js",
-    "test:ci": "node --test --test-reporter=spec test/auth.test.js test/daemon.test.js test/cli.test.js"
+    "test": "node --test test/auth.test.js test/daemon.test.js test/cli.test.js test/skill-installer.test.js test/interactive-terminal.test.js",
+    "test:watch": "node --test --watch test/auth.test.js test/daemon.test.js test/cli.test.js test/skill-installer.test.js test/interactive-terminal.test.js",
+    "test:ci": "node --test --test-reporter=spec test/auth.test.js test/daemon.test.js test/cli.test.js test/skill-installer.test.js test/interactive-terminal.test.js"
   },
   "keywords": [],
   "author": "",