@dmsdc-ai/aigentry-telepty 0.1.61 → 0.1.63

package/CLAUDE.md

@@ -0,0 +1,76 @@
+# telepty — PTY Multiplexer & Session Orchestrator
+
+aigentry 에코시스템의 **통신 인프라**. 멀티 AI 세션을 생성·연결·제어하는 PTY 멀티플렉서.
+
+## 에코시스템 내 역할
+
+9개 aigentry 세션(orchestrator, brain, amplify, dustcraw 등) 간 통신을 담당:
+- 세션 생성/관리 (`allow`, `spawn`)
+- 메시지 전달 (`inject`, `broadcast`, `multicast`, `reply`)
+- 실시간 모니터링 (`tui`, `monitor`, `listen`)
+- 세션 간 토론 조율 (`deliberate`)
+
+## 아키텍처
+
+```
+CLI (cli.js) ──→ HTTP/WS ──→ Daemon (daemon.js:3848)
+                                ├── Session WS (/api/sessions/:id)
+                                ├── Event Bus WS (/api/bus)
+                                └── REST API (/api/sessions/*)
+```
+
+### 핵심 모듈
+
+| 파일 | 줄수 | 역할 |
+|------|------|------|
+| `cli.js` | ~1950 | CLI 명령 + allow-bridge (PTY 래핑) |
+| `daemon.js` | ~1550 | HTTP/WS 서버, 세션 상태, inject 전달 |
+| `tui.js` | ~500 | blessed 기반 TUI 대시보드 |
+| `session-routing.js` | 81 | 세션 ID 해석, alias 매칭, 호스트 그룹핑 |
+| `daemon-control.js` | 223 | 싱글톤 daemon PID 관리 |
+| `auth.js` | 33 | UUID 토큰 기반 인증 |
+| `interactive-terminal.js` | 71 | raw mode stdin/stdout 관리 |
+| `skill-installer.js` | 269 | Claude/Codex/Gemini 스킬 설치 |
+
+### Inject 전달 경로 (wrapped session)
+
+1. **Primary**: `kitty @ send-text` (터미널 직접 전달, allow-bridge 우회)
+2. **Fallback**: WS → allow-bridge → `child.write()` (PTY)
+3. **Submit**: `osascript` Return 키 → kitty fallback → WS `\r`
+
+busy 세션: CR은 큐에 대기 중인 텍스트와 함께 큐잉 후 올바른 순서로 flush.
+
+## 명령어
+
+```bash
+# 테스트
+npm test                    # 43 tests (node:test)
+
+# 실행
+telepty daemon              # daemon 시작 (포트 3848)
+telepty allow --id <name> claude  # 세션 래핑
+telepty tui                 # TUI 대시보드
+telepty list                # 세션 목록
+telepty inject <id> "msg"   # 메시지 주입
+telepty broadcast "msg"     # 전체 브로드캐스트
+telepty session start --launch  # kitty 탭으로 다중 세션 시작
+
+# 릴리스
+npm version patch --no-git-tag-version && npm publish --access public
+```
+
+## 주요 규칙
+
+- inject 후 submit은 항상 `osascript`로 통일 (`--no-enter` + osascript keystroke)
+- inject 시 발신자 session ID (`--from`)를 항상 포함
+- PTY `\r` 직접 의존 금지
+
+## 최근 주요 변경 (v0.1.58–0.1.62)
+
+| 버전 | 변경 |
+|------|------|
+| 0.1.62 | TUI 태스크 추적 — bus 이벤트에서 [태그] 자동 파싱, 세션별 상태 표시 |
+| 0.1.61 | reconnect 시 resize/\x0c 제거 (멀티터미널 깜빡임 수정) |
+| 0.1.60 | TUI P1 — s=start, k=kill, p=purge stale |
+| 0.1.59 | wrapped inject 503 반환 + 테스트 43/43 정합성 |
+| 0.1.58 | inject busy-session CR/text 순서 수정 + kittyWindowId 캐시 무효화 |

package/cli.js

@@ -1039,6 +1039,16 @@ async function main() {
         process.exit(1);
       }
 
+      // Entitlement: remote session check
+      if (target.host && target.host !== '127.0.0.1' && target.host !== 'localhost') {
+        const { checkEntitlement } = require('./entitlement');
+        const ent = checkEntitlement({ feature: 'telepty.remote_sessions' });
+        if (!ent.allowed) {
+          console.error(`⚠️  ${ent.reason}\n   Upgrade: ${ent.upgrade_url}`);
+          process.exit(1);
+        }
+      }
+
       const body = { prompt, no_enter: noEnter };
       if (fromId) body.from = fromId;
       if (replyTo) body.reply_to = replyTo;

package/daemon.js

@@ -7,6 +7,7 @@ const { WebSocketServer } = require('ws');
 const { getConfig } = require('./auth');
 const pkg = require('./package.json');
 const { claimDaemonState, clearDaemonState } = require('./daemon-control');
+const { checkEntitlement } = require('./entitlement');
 
 const config = getConfig();
 const EXPECTED_TOKEN = config.authToken;
@@ -209,6 +210,13 @@ app.post('/api/sessions/spawn', (req, res) => {
   const { session_id, command, args = [], cwd = process.cwd(), cols = 80, rows = 30, type = 'AGENT' } = req.body;
   if (!session_id) return res.status(400).json({ error: 'session_id is strictly required.' });
   if (sessions[session_id]) return res.status(409).json({ error: `Session ID '${session_id}' is already active.` });
+  // Entitlement: check session limit
+  const sessionCount = Object.keys(sessions).length;
+  const ent = checkEntitlement({ feature: 'telepty.multi_session', currentUsage: sessionCount });
+  if (!ent.allowed) {
+    console.log(`[ENTITLEMENT] Session limit reached (${sessionCount}/${ent.limit?.max || '?'}), tier: ${ent.tier}`);
+    return res.status(402).json({ error: ent.reason, upgrade_url: ent.upgrade_url, tier: ent.tier });
+  }
   if (!command) return res.status(400).json({ error: 'command is required' });
 
   const isWin = os.platform() === 'win32';
@@ -300,6 +308,15 @@ app.post('/api/sessions/spawn', (req, res) => {
 app.post('/api/sessions/register', (req, res) => {
   const { session_id, command, cwd = process.cwd() } = req.body;
   if (!session_id) return res.status(400).json({ error: 'session_id is required' });
+  // Entitlement: check session limit for new registrations
+  if (!sessions[session_id]) {
+    const sessionCount = Object.keys(sessions).length;
+    const ent = checkEntitlement({ feature: 'telepty.multi_session', currentUsage: sessionCount });
+    if (!ent.allowed) {
+      console.log(`[ENTITLEMENT] Session limit reached (${sessionCount}/${ent.limit?.max || '?'}), tier: ${ent.tier}`);
+      return res.status(402).json({ error: ent.reason, upgrade_url: ent.upgrade_url, tier: ent.tier });
+    }
+  }
   // Idempotent: allow re-registration (update command/cwd, keep clients)
   if (sessions[session_id]) {
     const existing = sessions[session_id];

package/entitlement.js

@@ -0,0 +1,70 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const LICENSE_PATH = path.join(os.homedir(), '.aigentry', 'license.json');
+const UPGRADE_URL = 'https://aigentry.dev/upgrade';
+
+const FEATURES = {
+  'telepty.core':            { tiers: ['free', 'pro', 'team'] },
+  'telepty.multi_session':   { tiers: ['pro', 'team'], freeLimit: 3 },
+  'telepty.remote_sessions': { tiers: ['pro', 'team'] },
+  'telepty.team_broadcast':  { tiers: ['team'] }
+};
+
+function readLicense() {
+  try {
+    if (fs.existsSync(LICENSE_PATH)) {
+      const data = JSON.parse(fs.readFileSync(LICENSE_PATH, 'utf8'));
+      // Grace period: expired Pro/Team gets 30 days before downgrade
+      if (data.expires_at) {
+        const expiry = new Date(data.expires_at).getTime();
+        const grace = 30 * 24 * 60 * 60 * 1000;
+        if (Date.now() > expiry + grace) {
+          return { tier: 'free', expired: true };
+        }
+      }
+      return { tier: data.tier || 'free', expired: false };
+    }
+  } catch {}
+  return { tier: 'free', expired: false };
+}
+
+function checkEntitlement({ feature, currentUsage }) {
+  const def = FEATURES[feature];
+  if (!def) return { allowed: true, tier: 'free', reason: 'Unknown feature — allowing' };
+
+  const license = readLicense();
+  const tier = license.tier;
+
+  // Feature available on this tier
+  if (def.tiers.includes(tier)) {
+    return { allowed: true, tier, upgrade_url: UPGRADE_URL };
+  }
+
+  // Free tier with limit
+  if (tier === 'free' && def.freeLimit != null) {
+    const current = currentUsage || 0;
+    if (current < def.freeLimit) {
+      return { allowed: true, tier, limit: { current, max: def.freeLimit } };
+    }
+    return {
+      allowed: false, tier,
+      reason: `Free limit reached: ${current}/${def.freeLimit}. Upgrade to Pro for unlimited.`,
+      upgrade_url: UPGRADE_URL,
+      limit: { current, max: def.freeLimit }
+    };
+  }
+
+  // Not available on this tier
+  const requiredTier = def.tiers[0];
+  return {
+    allowed: false, tier,
+    reason: `Requires ${requiredTier.charAt(0).toUpperCase() + requiredTier.slice(1)} tier`,
+    upgrade_url: UPGRADE_URL
+  };
+}
+
+module.exports = { checkEntitlement, readLicense, LICENSE_PATH, FEATURES };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dmsdc-ai/aigentry-telepty",
-  "version": "0.1.61",
+  "version": "0.1.63",
   "main": "daemon.js",
   "bin": {
     "aigentry-telepty": "install.js",

package/tui.js

@@ -23,6 +23,7 @@ class TuiDashboard {
     this.pollTimer = null;
     this.busWs = null;
     this.busLog = [];
+    this.sessionTasks = {}; // { sessionId: { summary, state, updatedAt } }
     this.setupScreen();
     this.startPolling();
     this.connectBus();
@@ -248,6 +249,35 @@ class TuiDashboard {
     this.screen.render();
   }
 
+  // ── Task extraction from bus events ─────────────────────────
+
+  parseTaskInfo(content) {
+    if (!content || typeof content !== 'string') return null;
+    const firstLine = content.split('\n')[0].trim();
+    // Extract [tag] patterns: [P0 착수], [완료 보고], [telepty 관점], etc.
+    const tagMatch = firstLine.match(/\[([^\]]{2,30})\]/);
+    const tag = tagMatch ? tagMatch[1] : null;
+    // Detect state from keywords
+    let state = 'working';
+    if (/완료|complete|done|finish/i.test(firstLine)) state = 'done';
+    else if (/토론|deliberat|discuss|synthesis|합의/i.test(firstLine)) state = 'discussing';
+    else if (/동의|반대|vote|찬성/i.test(firstLine)) state = 'voting';
+    else if (/대기|standby|waiting|idle/i.test(firstLine)) state = 'idle';
+    // Build summary (tag or truncated first line)
+    const summary = tag || firstLine.replace(/\[.*?\]/g, '').trim().slice(0, 30);
+    return { summary, state };
+  }
+
+  updateSessionTask(sessionId, content) {
+    const info = this.parseTaskInfo(content);
+    if (!info || !info.summary) return;
+    this.sessionTasks[sessionId] = {
+      summary: info.summary,
+      state: info.state,
+      updatedAt: Date.now()
+    };
+  }
+
   // ── Event Bus ────────────────────────────────────────────────
 
   connectBus() {
@@ -263,16 +293,20 @@ class TuiDashboard {
           let line = `${ts} `;
           if (msg.type === 'inject_written') {
             line += `{cyan-fg}inject{/} -> ${msg.target || '?'}`;
+            // Track task from inject content
+            if (msg.target) this.updateSessionTask(msg.target, msg.content || msg.prompt);
           } else if (msg.type === 'injection') {
             line += `{cyan-fg}broadcast{/} -> ${msg.target_agent || 'all'}`;
           } else if (msg.type === 'message_routed') {
             line += `{yellow-fg}${msg.from || '?'}{/} -> {green-fg}${msg.to || '?'}{/}`;
+            if (msg.from) this.updateSessionTask(msg.from, msg.content || msg.prompt);
           } else {
             line += `{white-fg}${msg.type || 'event'}{/}`;
           }
           this.busLog.push(line);
           if (this.busLog.length > 100) this.busLog.shift();
           this.renderBusLog();
+          this.renderSessionList(); // refresh task info
         } catch { /* ignore malformed */ }
       });
       this.busWs.on('close', () => {
@@ -428,9 +462,20 @@ class TuiDashboard {
   getStatusInfo(session) {
     const idle = session.idleSeconds;
     const clients = session.active_clients || 0;
-
+    const task = this.sessionTasks[session.id];
+    // Task-aware state (bus events override idle heuristic)
     if (clients === 0) return { icon: '{red-fg}✕{/}', label: '{red-fg}dead{/}' };
     if (idle !== null && idle > STALE_THRESHOLD) return { icon: '{yellow-fg}○{/}', label: '{yellow-fg}stale{/}' };
+    if (task && (Date.now() - task.updatedAt) < 300000) { // 5min freshness
+      const stateMap = {
+        done:       { icon: '{green-fg}✓{/}',  label: '{green-fg}done{/}' },
+        discussing: { icon: '{magenta-fg}◉{/}', label: '{magenta-fg}discuss{/}' },
+        voting:     { icon: '{magenta-fg}◎{/}', label: '{magenta-fg}vote{/}' },
+        working:    { icon: '{cyan-fg}●{/}',    label: '{cyan-fg}working{/}' },
+        idle:       { icon: '{green-fg}●{/}',   label: '{white-fg}idle{/}' }
+      };
+      return stateMap[task.state] || stateMap.working;
+    }
     if (idle !== null && idle < 10) return { icon: '{green-fg}●{/}', label: '{green-fg}busy{/}' };
     return { icon: '{green-fg}●{/}', label: '{white-fg}idle{/}' };
   }
@@ -439,7 +484,10 @@ class TuiDashboard {
     const items = this.sessions.map((s) => {
       const { icon, label } = this.getStatusInfo(s);
       const shortId = s.id.replace(/^aigentry-/, '').replace(/-claude$/, '');
-      return ` ${icon}  ${shortId.padEnd(24)} ${label}  {gray-fg}C:${s.active_clients}{/}`;
+      const task = this.sessionTasks[s.id];
+      const taskStr = (task && (Date.now() - task.updatedAt) < 300000)
+        ? ` {gray-fg}${task.summary.slice(0, 20)}{/}` : '';
+      return ` ${icon}  ${shortId.padEnd(20)} ${label.padEnd(18)}${taskStr}`;
     });
 
     this.sessionList.setItems(items);