@dmsdc-ai/aigentry-telepty 0.0.18 → 0.1.0

package/.deliberation_request.json

@@ -0,0 +1 @@
+{"topic": "Critique and verify the Foreground-Only Session Lifecycle for telepty. The user proposes that all AI workers/sessions MUST run in visible, physical terminal windows. When the user closes the window, the session dies. No invisible background sessions exist. What are the edge cases, UX flaws, or technical limitations of this approach?", "speakers": ["claude", "gemini", "codex"], "role_preset": "critic"}

package/.deliberation_request2.json

@@ -0,0 +1 @@
+{"topic": "Re-evaluate the telepty architecture based on the user`s strict boundaries: 1. A session equals a physical, visible terminal window. If the window closes, the session MUST die. No zombies. 2. Background persistence is NOT telepty`s job (users can use tmux if they want, but telepty doesn`t manage it). 3. Unexpected disconnects (network drop, sleep) are treated as session death, and recovery is handled via a higher-level `Handoff` of context to a new session, NOT by keeping zombie processes alive. Double-check this philosophy for flaws, focusing on how AI agents will communicate (Pub/Sub) within this strict ephemeral foreground model.", "speakers": ["claude", "codex", "gemini"], "role_preset": "review"}

package/.deliberation_request3.json

@@ -0,0 +1 @@
+{"topic": "Final architectural verification of the Telepty Boundary Model. The user asserts a hard line on responsibility: 1. If a session/process dies, context is lost. That is the CLI/Terminal`s problem, not telepty`s. 2. If a Pub message is sent to a dead Sub, it is lost. Telepty just drops it or relies on Ack. If the sub reconnects in time, it gets it; if not, drop it. 3. If Wi-Fi drops, CLI dies, agent dies, scripts die. Telepty does not care about split-brain or script recovery. Is this stateless, hyper-minimalist `dumb pipe` philosophy technically viable for our goals?", "speakers": ["claude", "gemini", "codex"], "role_preset": "consensus"}

package/.gemini/skills/telepty/SKILL.md

@@ -4,7 +4,7 @@
 Help the user interact with the `telepty` daemon, check their current session ID, list active sessions, and inject commands into remote or local PTY sessions.
 
 **Trigger:**
-When the user asks about their current session ID (e.g. "내 세션 ID가 뭐야?"), wants to check active sessions ("세션 목록 보여줘"), or wants to inject a prompt/command into a specific session ("dustcraw한테 메시지 보내줘").
+When the user asks about their current session ID (e.g. "내 세션 ID가 뭐야?"), wants to check active sessions ("세션 목록 보여줘"), wants to inject a prompt/command into a specific session ("dustcraw한테 메시지 보내줘"), or wants to update telepty to the latest version ("업데이트 해줘").
 
 **Instructions:**
 1. **To check the current session ID:**
@@ -17,3 +17,5 @@ When the user asks about their current session ID (e.g. "내 세션 ID가 뭐야
    - For a single session: Run `telepty inject <target_session_id> "<message or command>"`.
    - For broadcasting to ALL active sessions: Run `telepty broadcast "<message or command>"`.
    - For multicasting to multiple specific sessions: Run `telepty multicast <id1>,<id2> "<message or command>"`.
+4. **To update telepty:**
+   - Run `telepty update`.

package/cli.js

@@ -104,6 +104,36 @@ 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);
+  return new Promise((resolve) => {
+    ws.on('open', () => {
+      console.log(`\n\x1b[32mEntered room '${sessionId}'. The room will be destroyed if you exit (Ctrl+C or exit command).\x1b[0m\n`);
+      if (process.stdin.isTTY) process.stdin.setRawMode(true);
+      process.stdin.on('data', d => ws.send(JSON.stringify({ type: 'input', data: d.toString() })));
+      const resizer = () => ws.send(JSON.stringify({ type: 'resize', cols: process.stdout.columns, rows: process.stdout.rows }));
+      process.stdout.on('resize', resizer); resizer();
+    });
+    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);
+      console.log(`\n\x1b[33mLeft room '${sessionId}'. Destroying session to prevent zombies...\x1b[0m\n`);
+      process.stdin.removeAllListeners('data');
+      
+      // Auto-kill session when the primary creator leaves
+      try {
+        await fetchWithAuth(`http://${targetHost}:${PORT}/api/sessions/${encodeURIComponent(sessionId)}`, { method: 'DELETE' });
+      } catch(e) {}
+      
+      resolve();
+    });
+  });
+}
+
 async function manageInteractive() {
   console.clear();
   console.log('\x1b[36m\x1b[1m⚡ Telepty Agent Manager\x1b[0m\n');
@@ -189,7 +219,12 @@ async function manageInteractive() {
         });
         const data = await res.json();
         if (!res.ok) console.error(`\n❌ Error: ${data.error}\n`);
-        else console.log(`\n✅ Session '\x1b[36m${data.session_id}\x1b[0m' spawned successfully.\n`);
+        else {
+          // Immediately attach to the spawned session automatically
+          console.log(`\n✅ Session '\x1b[36m${data.session_id}\x1b[0m' spawned. Entering room automatically...\n`);
+          args[1] = data.session_id; // Spoof args for attach
+          return manageInteractiveAttach(data.session_id, '127.0.0.1');
+        }
       } catch (e) {
         console.error('\n❌ Failed to connect to local daemon. Is it running?\n');
       }
@@ -215,27 +250,7 @@ async function manageInteractive() {
       if (!target) continue;
 
       if (response.action === 'attach') {
-        const wsUrl = `ws://${target.host}:${PORT}/api/sessions/${encodeURIComponent(target.id)}?token=${encodeURIComponent(TOKEN)}`;
-        const ws = new WebSocket(wsUrl);
-        await new Promise((resolve) => {
-          ws.on('open', () => {
-            console.log(`\n\x1b[32mConnected to '${target.id}'. Press Ctrl+C to detach.\x1b[0m\n`);
-            if (process.stdin.isTTY) process.stdin.setRawMode(true);
-            process.stdin.on('data', d => ws.send(JSON.stringify({ type: 'input', data: d.toString() })));
-            const resizer = () => ws.send(JSON.stringify({ type: 'resize', cols: process.stdout.columns, rows: process.stdout.rows }));
-            process.stdout.on('resize', resizer); resizer();
-          });
-          ws.on('message', m => {
-            const msg = JSON.parse(m);
-            if (msg.type === 'output') process.stdout.write(msg.data);
-          });
-          ws.on('close', () => {
-            if (process.stdin.isTTY) process.stdin.setRawMode(false);
-            console.log(`\n\x1b[33mDisconnected from session.\x1b[0m\n`);
-            process.stdin.removeAllListeners('data');
-            resolve();
-          });
-        });
+        await manageInteractiveAttach(target.id, target.host);
         continue;
       }
 
@@ -340,7 +355,8 @@ async function main() {
       });
       const data = await res.json();
       if (!res.ok) { console.error(`❌ Error: ${data.error}`); return; }
-      console.log(`✅ Session '\x1b[36m${data.session_id}\x1b[0m' spawned successfully.`);
+      console.log(`✅ Session '\x1b[36m${data.session_id}\x1b[0m' spawned. Entering room automatically...`);
+      return manageInteractiveAttach(data.session_id, '127.0.0.1');
     } catch (e) { console.error('❌ Failed to connect to daemon. Is it running?'); }
     return;
   }
@@ -380,7 +396,7 @@ async function main() {
     const ws = new WebSocket(wsUrl);
 
     ws.on('open', () => {
-      console.log(`\x1b[32mConnected to session '${sessionId}' at ${targetHost}. Press Ctrl+C to detach.\x1b[0m\n`);
+      console.log(`\x1b[32mEntered room '${sessionId}' at ${targetHost}. The room will be destroyed if you exit.\x1b[0m\n`);
       
       if (process.stdin.isTTY) {
         process.stdin.setRawMode(true);
@@ -409,11 +425,14 @@ async function main() {
       }
     });
 
-    ws.on('close', (code, reason) => {
+    ws.on('close', async (code, reason) => {
       if (process.stdin.isTTY) {
         process.stdin.setRawMode(false);
       }
-      console.log(`\n\x1b[33mDisconnected from session. (Code: ${code}, Reason: ${reason || 'None'})\x1b[0m`);
+      console.log(`\n\x1b[33mLeft room. Destroying session '${sessionId}' to prevent zombies... (Code: ${code})\x1b[0m`);
+      try {
+        await fetchWithAuth(`http://${targetHost}:${PORT}/api/sessions/${encodeURIComponent(sessionId)}`, { method: 'DELETE' });
+      } catch(e) {}
       process.exit(0);
     });
 

package/daemon.js

@@ -164,25 +164,29 @@ app.post('/api/sessions/:id/inject', (req, res) => {
   }
 });
 
+app.delete('/api/sessions/:id', (req, res) => {
+  const { id } = req.params;
+  const session = sessions[id];
+  if (!session) return res.status(404).json({ error: 'Session not found' });
+  try {
+    session.ptyProcess.kill();
+    delete sessions[id];
+    console.log(`[KILL] Session ${id} forcefully closed`);
+    res.json({ success: true });
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
 const server = app.listen(PORT, HOST, () => {
   console.log(`🚀 aigentry-telepty daemon listening on http://${HOST}:${PORT}`);
 });
 
-const wss = new WebSocketServer({ server });
-
-wss.on('connection', (ws, req) => {
-  const isLocalhost = req.socket.remoteAddress === '127.0.0.1' || req.socket.remoteAddress === '::1' || req.socket.remoteAddress === '::ffff:127.0.0.1';
-  const isTailscale = req.socket.remoteAddress && req.socket.remoteAddress.startsWith('100.');
-  
-  const url = new URL(req.url, `http://${req.headers.host}`);
-  const token = url.searchParams.get('token');
 
-  if (!isLocalhost && !isTailscale && token !== EXPECTED_TOKEN) {
-    console.warn(`[WS-AUTH] Rejected unauthorized WebSocket from ${req.socket.remoteAddress}`);
-    ws.close(1008, 'Unauthorized');
-    return;
-  }
+const wss = new WebSocketServer({ noServer: true });
 
+wss.on('connection', (ws, req) => {
+  const url = new URL(req.url, 'http://' + req.headers.host);
   const sessionId = url.pathname.split('/').pop();
   const session = sessions[sessionId];
 
@@ -192,7 +196,7 @@ wss.on('connection', (ws, req) => {
   }
 
   session.clients.add(ws);
-  console.log(`[WS] Client attached to session ${sessionId} (Total: ${session.clients.size})`);
+  console.log(`[WS] Client attached to session \${sessionId} (Total: \${session.clients.size})`);
 
   ws.on('message', (message) => {
     try {
@@ -209,6 +213,59 @@ wss.on('connection', (ws, req) => {
 
   ws.on('close', () => {
     session.clients.delete(ws);
-    console.log(`[WS] Client detached from session ${sessionId} (Total: ${session.clients.size})`);
+    console.log(`[WS] Client detached from session \${sessionId} (Total: \${session.clients.size})`);
   });
 });
+
+const busWss = new WebSocketServer({ noServer: true });
+const busClients = new Set();
+
+busWss.on('connection', (ws, req) => {
+  busClients.add(ws);
+  console.log('[BUS] New agent connected to event bus');
+
+  ws.on('message', (message) => {
+    try {
+      const msg = JSON.parse(message);
+      // For MVP, simply broadcast any valid JSON message to all other bus clients
+      busClients.forEach(client => {
+        if (client !== ws && client.readyState === 1) {
+          client.send(JSON.stringify(msg));
+        }
+      });
+    } catch (e) {
+      console.error('[BUS] Invalid message format', e);
+    }
+  });
+
+  ws.on('close', () => {
+    busClients.delete(ws);
+    console.log('[BUS] Agent disconnected from event bus');
+  });
+});
+
+server.on('upgrade', (req, socket, head) => {
+  const url = new URL(req.url, 'http://' + req.headers.host);
+  const token = url.searchParams.get('token');
+  
+  const isLocalhost = req.socket.remoteAddress === '127.0.0.1' || req.socket.remoteAddress === '::1' || req.socket.remoteAddress === '::ffff:127.0.0.1';
+  const isTailscale = req.socket.remoteAddress && req.socket.remoteAddress.startsWith('100.');
+  
+  if (!isLocalhost && !isTailscale && token !== EXPECTED_TOKEN) {
+    socket.write('HTTP/1.1 401 Unauthorized\r\n\r\n');
+    socket.destroy();
+    return;
+  }
+
+  if (url.pathname.startsWith('/api/sessions/')) {
+    wss.handleUpgrade(req, socket, head, (ws) => {
+      wss.emit('connection', ws, req);
+    });
+  } else if (url.pathname === '/api/bus') {
+    busWss.handleUpgrade(req, socket, head, (ws) => {
+      busWss.emit('connection', ws, req);
+    });
+  } else {
+    socket.destroy();
+  }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dmsdc-ai/aigentry-telepty",
-  "version": "0.0.18",
+  "version": "0.1.0",
   "main": "daemon.js",
   "bin": {
     "telepty": "cli.js",