@dmsdc-ai/aigentry-telepty 0.1.9 → 0.1.11

package/README.md

@@ -20,6 +20,12 @@ Open PowerShell as Administrator and run:
 iwr -useb https://raw.githubusercontent.com/dmsdc-ai/aigentry-telepty/main/install.ps1 | iex
 ```
 
+You can also launch the installer through npm without downloading the script first:
+
+```bash
+npx --yes @dmsdc-ai/aigentry-telepty@latest
+```
+
 *These single commands will install the package globally and automatically configure it to run as a background service specific to your OS (`systemd` for Linux, `launchd` for macOS, or a detached background process for Windows).*
 The installer now stops older local telepty daemons before starting the new one, so updates do not leave duplicate background processes behind.
 
@@ -57,11 +63,7 @@ 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.
 
-If you ever need to manually clear stale local daemon processes:
-
-```bash
-telepty cleanup-daemons
-```
+If the local daemon ever gets stuck or duplicated, open `telepty` and choose `Repair local daemon`.
 
 ## Skill Installation
 

package/cli.js

@@ -10,7 +10,8 @@ const updateNotifier = require('update-notifier');
 const pkg = require('./package.json');
 const { getConfig } = require('./auth');
 const { cleanupDaemonProcesses } = require('./daemon-control');
-const { attachInteractiveTerminal } = require('./interactive-terminal');
+const { attachInteractiveTerminal, getTerminalSize } = require('./interactive-terminal');
+const { getRuntimeInfo } = require('./runtime-info');
 const { runInteractiveSkillInstaller } = require('./skill-installer');
 const args = process.argv.slice(2);
 
@@ -55,6 +56,20 @@ function startDetachedDaemon() {
   cp.unref();
 }
 
+async function repairLocalDaemon(options = {}) {
+  const restart = options.restart !== false;
+  const results = cleanupDaemonProcesses();
+
+  if (!restart) {
+    return { stopped: results.stopped.length, failed: results.failed.length, meta: null };
+  }
+
+  startDetachedDaemon();
+  await new Promise((resolve) => setTimeout(resolve, 1000));
+  const meta = await getDaemonMeta('127.0.0.1');
+  return { stopped: results.stopped.length, failed: results.failed.length, meta };
+}
+
 async function discoverSessions() {
   await ensureDaemonRunning();
   const hosts = ['127.0.0.1'];
@@ -129,7 +144,7 @@ async function ensureDaemonRunning(options = {}) {
 
   const meta = await getDaemonMeta('127.0.0.1');
   if (!meta || !requiredCapabilities.every((item) => meta.capabilities.includes(item))) {
-    console.error('❌ Failed to start a compatible local telepty daemon. Try `telepty cleanup-daemons` or rerun the installer.');
+    console.error('❌ Failed to start a compatible local telepty daemon. Open telepty and choose "Repair local daemon", or rerun the installer.');
   }
 }
 
@@ -144,7 +159,10 @@ async function manageInteractiveAttach(sessionId, targetHost) {
       console.log(`\n\x1b[32mEntered room '${sessionId}'.\x1b[0m\n`);
       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 }))
+        onResize: () => {
+          const size = getTerminalSize(process.stdout, { cols: 80, rows: 30 });
+          ws.send(JSON.stringify({ type: 'resize', cols: size.cols, rows: size.rows }));
+        }
       });
     });
     ws.on('message', m => {
@@ -178,8 +196,10 @@ async function manageInteractiveAttach(sessionId, targetHost) {
 }
 
 async function manageInteractive() {
+  const runtimeInfo = getRuntimeInfo(__dirname);
   console.clear();
   console.log('\x1b[36m\x1b[1m⚡ Telepty Agent Manager\x1b[0m\n');
+  console.log(`\x1b[90mVersion ${runtimeInfo.version}  Updated ${runtimeInfo.updatedAtLabel}\x1b[0m\n`);
 
   while (true) {
     const response = await prompts({
@@ -192,6 +212,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: '🧹  Repair local daemon', value: 'repair-daemon' },
         { title: '🧠  Install telepty skills', value: 'install-skills' },
         { title: '🔄  Update telepty to latest version', value: 'update' },
         { title: '❌  Exit', value: 'exit' }
@@ -203,7 +224,7 @@ async function manageInteractive() {
       try {
         execSync('npm install -g @dmsdc-ai/aigentry-telepty@latest', { stdio: 'inherit' });
         console.log('\n\x1b[32m✅ Update complete! Restarting daemon...\x1b[0m');
-        cleanupDaemonProcesses();
+        await repairLocalDaemon({ restart: true });
       } catch (e) {
         console.error('\n❌ Update failed.\n');
       }
@@ -223,6 +244,17 @@ async function manageInteractive() {
       continue;
     }
 
+    if (response.action === 'repair-daemon') {
+      console.log('\n\x1b[36m🧹 Repairing local telepty daemon...\x1b[0m');
+      const result = await repairLocalDaemon({ restart: true });
+      if (result.meta) {
+        console.log(`✅ Local daemon is healthy. Version ${result.meta.version}, pid ${result.meta.pid}, stopped ${result.stopped} old daemon(s).\n`);
+      } else {
+        console.log(`⚠️ Daemon cleanup ran, but a fresh local daemon did not respond. Stopped ${result.stopped} old daemon(s).\n`);
+      }
+      continue;
+    }
+
     if (response.action === 'install-skills') {
       try {
         await runInteractiveSkillInstaller({ packageRoot: __dirname, cwd: process.cwd() });
@@ -518,7 +550,8 @@ async function main() {
         child.write(data.toString());
       },
       onResize: () => {
-        child.resize(process.stdout.columns, process.stdout.rows);
+        const size = getTerminalSize(process.stdout, { cols: 120, rows: 40 });
+        child.resize(size.cols, size.rows);
       }
     });
 
@@ -594,10 +627,11 @@ async function main() {
           ws.send(JSON.stringify({ type: 'input', data: data.toString() }));
         },
         onResize: () => {
+          const size = getTerminalSize(process.stdout, { cols: 80, rows: 30 });
           ws.send(JSON.stringify({
             type: 'resize',
-            cols: process.stdout.columns,
-            rows: process.stdout.rows
+            cols: size.cols,
+            rows: size.rows
           }));
         }
       });
@@ -776,7 +810,6 @@ Usage:
   telepty multicast <id1,id2> "<prompt>"         Inject text into multiple specific sessions
   telepty broadcast "<prompt>"                   Inject text into ALL active sessions
   telepty rename <old_id> <new_id>               Rename a session (updates terminal title too)
-  telepty cleanup-daemons                        Stop old local telepty daemon processes
   telepty listen                                 Listen to the event bus and print JSON to stdout
   telepty monitor                                Human-readable real-time billboard of bus events
   telepty update                                 Update telepty to the latest version

package/interactive-terminal.js

@@ -1,5 +1,21 @@
 'use strict';
 
+function getTerminalSize(output, fallback = {}) {
+  const envCols = Number.parseInt(process.env.COLUMNS || '', 10);
+  const envRows = Number.parseInt(process.env.LINES || '', 10);
+  const fallbackCols = Number.isInteger(fallback.cols) && fallback.cols > 0 ? fallback.cols : 120;
+  const fallbackRows = Number.isInteger(fallback.rows) && fallback.rows > 0 ? fallback.rows : 40;
+
+  const cols = Number.isInteger(output && output.columns) && output.columns > 0
+    ? output.columns
+    : (Number.isInteger(envCols) && envCols > 0 ? envCols : fallbackCols);
+  const rows = Number.isInteger(output && output.rows) && output.rows > 0
+    ? output.rows
+    : (Number.isInteger(envRows) && envRows > 0 ? envRows : fallbackRows);
+
+  return { cols, rows };
+}
+
 function removeListener(stream, eventName, handler) {
   if (!handler || !stream) {
     return;
@@ -50,5 +66,6 @@ function attachInteractiveTerminal(input, output, handlers = {}) {
 }
 
 module.exports = {
-  attachInteractiveTerminal
+  attachInteractiveTerminal,
+  getTerminalSize
 };

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@dmsdc-ai/aigentry-telepty",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "main": "daemon.js",
   "bin": {
+    "aigentry-telepty": "install.js",
     "telepty": "cli.js",
     "telepty-install": "install.js"
   },
   "scripts": {
-    "test": "node --test test/auth.test.js test/daemon.test.js test/daemon-singleton.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/daemon-singleton.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/daemon-singleton.test.js test/cli.test.js test/skill-installer.test.js test/interactive-terminal.test.js"
+    "test": "node --test test/auth.test.js test/daemon.test.js test/daemon-singleton.test.js test/cli.test.js test/skill-installer.test.js test/interactive-terminal.test.js test/runtime-info.test.js",
+    "test:watch": "node --test --watch test/auth.test.js test/daemon.test.js test/daemon-singleton.test.js test/cli.test.js test/skill-installer.test.js test/interactive-terminal.test.js test/runtime-info.test.js",
+    "test:ci": "node --test --test-reporter=spec test/auth.test.js test/daemon.test.js test/daemon-singleton.test.js test/cli.test.js test/skill-installer.test.js test/interactive-terminal.test.js test/runtime-info.test.js"
   },
   "keywords": [],
   "author": "",

package/runtime-info.js

@@ -0,0 +1,41 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function pad(value) {
+  return String(value).padStart(2, '0');
+}
+
+function formatTimestamp(date) {
+  const year = date.getFullYear();
+  const month = pad(date.getMonth() + 1);
+  const day = pad(date.getDate());
+  const hours = pad(date.getHours());
+  const minutes = pad(date.getMinutes());
+  const seconds = pad(date.getSeconds());
+  const offsetMinutes = -date.getTimezoneOffset();
+  const sign = offsetMinutes >= 0 ? '+' : '-';
+  const absoluteOffset = Math.abs(offsetMinutes);
+  const offsetHours = pad(Math.floor(absoluteOffset / 60));
+  const offsetRemainder = pad(absoluteOffset % 60);
+  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds} ${sign}${offsetHours}:${offsetRemainder}`;
+}
+
+function getRuntimeInfo(packageRoot = __dirname) {
+  const packageJsonPath = path.join(packageRoot, 'package.json');
+  const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+  const packageStat = fs.statSync(packageJsonPath);
+  const updatedAt = packageStat.mtime;
+
+  return {
+    version: pkg.version || 'unknown',
+    updatedAt,
+    updatedAtLabel: formatTimestamp(updatedAt)
+  };
+}
+
+module.exports = {
+  formatTimestamp,
+  getRuntimeInfo
+};

package/skills/telepty/SKILL.md

@@ -1,86 +1,99 @@
+---
+name: telepty
+description: Use telepty to inspect sessions, attach or inject into rooms, repair local daemon issues, and guide users through the TUI-first workflow when telepty is installed.
+---
+
 # telepty
 
-Use `telepty` to inspect active sessions, check the current telepty session ID, attach to sessions, inject commands, listen to the event bus, rename sessions, and update the daemon.
+Use this skill when the user wants help operating `telepty`, recovering a broken local daemon, or managing telepty sessions in natural language.
 
-## When To Use
+## Default approach
 
-Use this skill when the user asks to:
-- Check whether the current shell is running inside a telepty session
-- List or inspect telepty sessions
-- Attach to a telepty session
-- Inject a prompt or command into another telepty session
-- Listen to telepty bus events or publish a JSON payload
-- Rename a session
-- Update telepty
+- For interactive human guidance, prefer the `telepty` TUI and point the user to the relevant menu action.
+- For agent execution inside a CLI session, run the underlying `telepty` command directly.
+- When the request is about a broken or duplicated local daemon, repair the daemon before doing session work.
 
-## Commands
+## Common actions
 
-1. Check the current telepty session:
+1. Check whether the current shell is already inside a telepty session:
 
 ```bash
 echo "$TELEPTY_SESSION_ID"
 ```
 
-2. List sessions:
+2. Inspect active sessions:
 
 ```bash
 telepty list
 ```
 
-3. Attach to a session:
+3. Attach to a room:
 
 ```bash
 telepty attach <session_id>
 ```
 
-4. Inject a prompt or command:
+4. Inject a command or prompt:
 
 ```bash
 telepty inject <session_id> "<prompt text>"
 ```
 
-5. Inject into multiple sessions:
-
-```bash
-telepty multicast <id1,id2,...> "<prompt text>"
-```
-
-6. Broadcast to all sessions:
+5. Allow inject on a local CLI:
 
 ```bash
-telepty broadcast "<prompt text>"
+telepty allow --id <session_id> <command> [args...]
 ```
 
-7. Rename a session:
+6. Rename a room:
 
 ```bash
 telepty rename <old_id> <new_id>
 ```
 
-8. Listen to the event bus:
+7. Listen to the event bus:
 
 ```bash
 telepty listen
 ```
 
-9. Publish a JSON payload to the bus:
+8. Update telepty:
 
 ```bash
-TOKEN=$(grep authToken ~/.telepty/config.json | cut -d '"' -f 4)
-curl -s -X POST http://127.0.0.1:3848/api/bus/publish \
-  -H "Content-Type: application/json" \
-  -H "x-telepty-token: $TOKEN" \
-  -d '{"type":"bg_message","payload":"..."}'
+telepty update
 ```
 
-10. Update telepty:
+## Local daemon recovery
+
+When the user reports any of these symptoms, repair the local daemon first:
+
+- `Failed to connect to local daemon`
+- local sessions do not appear but remote sessions do
+- duplicate or stale daemon processes
+- install/update completed but `spawn` or `allow` still fails locally
+
+### Human-facing path
+
+Tell the user to run `telepty` and choose `Repair local daemon`.
+
+### Agent execution path
+
+Use the maintenance command directly:
 
 ```bash
-telepty update
+telepty cleanup-daemons
+telepty daemon
 ```
 
+If the daemon still does not come up, rerun the installer.
+
 ## Notes
 
 - `TELEPTY_SESSION_ID` is only set inside telepty-managed sessions.
-- Use `telepty inject` when the target session should receive the command immediately.
-- Use the JSON bus when the payload should be delivered without interrupting the target shell.
+- For non-interactive `telepty allow` use cases, set terminal dimensions if the environment does not provide them:
+
+```bash
+COLUMNS=120 LINES=40 telepty allow --id <session_id> <command>
+```
+
+- For interactive users, keep explanations centered on TUI actions instead of raw maintenance commands whenever possible.