@dmsdc-ai/aigentry-telepty 0.1.2 → 0.1.4

package/.deliberation_request.json

@@ -1 +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"}
+{"topic": "Brainstorming and critiquing the 3 communication modes in telepty (Prompt Injection, Visual Log, Background JSON). What crucial interaction pattern between human users and AI agents is missing from this list? Consider synchronous vs asynchronous, blocking vs non-blocking, and explicit handshakes.", "speakers": ["claude", "codex", "gemini"], "role_preset": "brainstorm"}

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 or JSON events into remote or local PTY sessions. All operations are performed using standard CLI commands or `curl`.
 
 **Trigger:**
-When the user asks about their current session ID, wants to check active sessions, wants to inject a prompt/command into a specific session, wants to send a JSON event via the bus, or wants to update telepty.
+When the user asks about their current session ID, wants to check active sessions, wants to inject a prompt/command into a specific session, wants to send a JSON event via the bus, wants to subscribe/listen to the bus, or wants to update telepty.
 
 **Instructions:**
 1. **To check the current session ID:**
@@ -13,20 +13,25 @@ When the user asks about their current session ID, wants to check active session
    - If it has a value, output it clearly.
 2. **To list all sessions:**
    - Run `telepty list`.
-3. **To inject a command into another session:**
-   - 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`.
-5. **To publish a JSON event to the Event Bus (/api/bus):**
-   - Use `curl` to post directly to the local daemon (it will relay to all active clients).
-   - First, get the token: `TOKEN=$(cat ~/.telepty/config.json | grep authToken | cut -d '"' -f 4)`
-   - Then run:
+3. **To send a message/command to another agent, you must choose ONE of three methods depending on the user's intent:**
+   
+   **Method A: Prompt Injection (Active Interruption)**
+   - Use this when you want the receiving AI to IMMEDIATELY read and execute the message as a prompt.
+   - Run: `telepty inject <target_session_id> "<prompt text>"`
+   - (For multiple: `telepty multicast <id1>,<id2> "<prompt>"`)
+
+   **Method B: Log Injection (Visual Notification)**
+   - Use this when you want the message to appear immediately on the receiving terminal's screen for the user to see, but WITHOUT forcing the AI to execute it as a prompt.
+   - Run: `telepty inject <target_session_id> "echo '\x1b[33m[📬 Message from $TELEPTY_SESSION_ID]\x1b[0m <message text>'"`
+
+   **Method C: Background JSON Bus (Passive/Silent)**
+   - Use this for structured data transfer that the other AI will read later from its log file, without disturbing its current terminal screen.
+   - Run: 
      ```bash
-     curl -X POST http://127.0.0.1:3848/api/bus/publish \
-       -H "Content-Type: application/json" \
-       -H "x-telepty-token: $TOKEN" \
-       -d '{"type": "my_event", "payload": "data"}'
+     TOKEN=$(cat ~/.telepty/config.json | grep authToken | 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": "..."}'
      ```
-   - (Modify the JSON payload structure according to the user's specific request.)
+4. **To subscribe to the Event Bus (Listen for JSON events):**
+   - Run `nohup telepty listen > .telepty_bus_events.log 2>&1 &`
+5. **To update telepty:**
+   - Run `telepty update`.

package/cli.js

@@ -440,11 +440,16 @@ async function main() {
   }
 
   if (cmd === 'inject') {
+    // Check for --no-enter flag
+    const noEnterIndex = args.indexOf('--no-enter');
+    const noEnter = noEnterIndex !== -1;
+    if (noEnter) args.splice(noEnterIndex, 1);
+    
     const sessionId = args[1]; const prompt = args.slice(2).join(' ');
-    if (!sessionId || !prompt) { console.error('❌ Usage: telepty inject <session_id> "<prompt text>"'); process.exit(1); }
+    if (!sessionId || !prompt) { console.error('❌ Usage: telepty inject [--no-enter] <session_id> "<prompt text>"'); process.exit(1); }
     try {
       const res = await fetchWithAuth(`${DAEMON_URL}/api/sessions/${encodeURIComponent(sessionId)}/inject`, {
-        method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ prompt })
+        method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ prompt, no_enter: noEnter })
       });
       const data = await res.json();
       if (!res.ok) { console.error(`❌ Error: ${data.error}`); return; }
@@ -485,6 +490,32 @@ async function main() {
     return;
   }
 
+  if (cmd === 'listen') {
+    await ensureDaemonRunning();
+    console.log('\x1b[36m👂 Listening to the telepty event bus...\x1b[0m');
+    const wsUrl = `ws://${REMOTE_HOST}:${PORT}/api/bus?token=${encodeURIComponent(TOKEN)}`;
+    const ws = new WebSocket(wsUrl);
+    
+    ws.on('open', () => {
+      // connected
+    });
+
+    ws.on('message', (message) => {
+      // Print raw JSON to stdout so agents can parse it
+      console.log(message.toString());
+    });
+
+    ws.on('close', () => {
+      console.error('\x1b[31m❌ Disconnected from event bus.\x1b[0m');
+      process.exit(1);
+    });
+
+    ws.on('error', (err) => {
+      console.error('\x1b[31m❌ WebSocket error:\x1b[0m', err.message);
+    });
+    return;
+  }
+
   console.log(`
 \x1b[1maigentry-telepty\x1b[0m - Remote PTY Control
 
@@ -493,9 +524,10 @@ Usage:
   telepty spawn --id <id> <command> [args...]    Spawn a new background CLI
   telepty list                                   List all active sessions
   telepty attach [id]                            Attach to a session (Interactive picker if no ID)
-  telepty inject <id> "<prompt>"                 Inject text into a single session
+  telepty inject [--no-enter] <id> "<prompt>"    Inject text into a single session
   telepty multicast <id1,id2> "<prompt>"         Inject text into multiple specific sessions
   telepty broadcast "<prompt>"                   Inject text into ALL active sessions
+  telepty listen                                 Listen to the event bus and print JSON to stdout
   telepty update                                 Update telepty to the latest version
 `);
 }

package/daemon.js

@@ -151,12 +151,12 @@ app.post('/api/sessions/broadcast/inject', (req, res) => {
 
 app.post('/api/sessions/:id/inject', (req, res) => {
   const { id } = req.params;
-  const { prompt } = req.body;
+  const { prompt, no_enter } = req.body;
   const session = sessions[id];
   if (!session) return res.status(404).json({ error: 'Session not found' });
   if (!prompt) return res.status(400).json({ error: 'prompt is required' });
   try {
-    session.ptyProcess.write(`${prompt}\r`);
+    session.ptyProcess.write(no_enter ? prompt : `${prompt}\r`);
     console.log(`[INJECT] Wrote to session ${id}`);
     res.json({ success: true });
   } catch (err) {

package/package.json

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