@dmsdc-ai/aigentry-telepty 0.1.6 → 0.1.7

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

@@ -1,55 +0,0 @@
-# telepty
-
-**Description:**
-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, wants to subscribe/listen to the bus, or wants to update telepty.
-
-**Instructions:**
-1. **To check the current session ID:**
-   - Execute `run_shell_command` with `echo $TELEPTY_SESSION_ID`.
-   - If the value is empty, inform the user that the current shell is *not* running inside a telepty spawned session.
-   - If it has a value, output it clearly.
-2. **To list all sessions:**
-   - Run `telepty list`.
-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
-     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": "..."}'
-     ```
-4. **To subscribe to the Event Bus (Listen for JSON events):**
-   - Run `nohup telepty listen > .telepty_bus_events.log 2>&1 &`
-5. **To physically OPEN a new Terminal Window for the user (macOS):**
-   - If the user asks you to "open a new telepty terminal" or "방 파줘", you can physically spawn a new Ghostty/Terminal window on their screen that is already attached to a telepty session.
-   - Run this shell command (replace `<ID>` and `<CMD>`):
-     ```bash
-     cat << 'EOF' > /tmp/telepty-auto.command
-     #!/bin/bash
-     telepty spawn --id <ID> <CMD>
-     EOF
-     chmod +x /tmp/telepty-auto.command
-     open -a Ghostty /tmp/telepty-auto.command || open /tmp/telepty-auto.command
-     ```
-6. **To rename a session:**
-   - Run `telepty rename <old_id> <new_id>`
-   - This updates the session key, Ghostty tab title, and broadcasts a `session_rename` event on the bus.
-7. **Terminal Title Convention:**
-   - Each telepty session displays its ID in the Ghostty tab title.
-   - Local: `⚡ telepty :: {session_id}`
-   - Remote: `⚡ telepty :: {session_id} @ {host}`
-8. **To update telepty:**
-   - Run `telepty update`.

package/.github/workflows/test-install.yml

@@ -1,26 +0,0 @@
-name: Regression Tests
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-  workflow_dispatch:
-
-jobs:
-  test:
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-        node: [20]
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node }}
-          cache: npm
-      - name: Install dependencies
-        run: npm ci
-      - name: Run regression suite
-        run: npm run test:ci

package/test/auth.test.js

@@ -1,56 +0,0 @@
-'use strict';
-
-const { test, before, after } = require('node:test');
-const assert = require('node:assert/strict');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-// Use a temp directory to isolate tests from the real ~/.telepty config.
-// We patch os.homedir() before requiring auth.js so the module-level
-// constants (CONFIG_DIR, CONFIG_FILE) resolve to the temp dir.
-const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'telepty-test-'));
-const originalHomedir = os.homedir.bind(os);
-
-before(() => {
-  os.homedir = () => tmpDir;
-  // Ensure auth.js is loaded fresh with the patched homedir
-  delete require.cache[require.resolve('../auth.js')];
-});
-
-after(() => {
-  os.homedir = originalHomedir;
-  delete require.cache[require.resolve('../auth.js')];
-  fs.rmSync(tmpDir, { recursive: true, force: true });
-});
-
-test('getConfig() returns an object with authToken property', () => {
-  const { getConfig } = require('../auth.js');
-  const config = getConfig();
-  assert.ok(config !== null && typeof config === 'object', 'config should be an object');
-  assert.ok('authToken' in config, 'config should have authToken property');
-  assert.equal(typeof config.authToken, 'string', 'authToken should be a string');
-});
-
-test('authToken is a valid UUID v4 format', () => {
-  const { getConfig } = require('../auth.js');
-  const config = getConfig();
-  const uuidV4Regex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-  assert.match(config.authToken, uuidV4Regex, 'authToken should be a valid UUID v4');
-});
-
-test('config object has createdAt field', () => {
-  const { getConfig } = require('../auth.js');
-  const config = getConfig();
-  assert.ok('createdAt' in config, 'config should have createdAt property');
-  const date = new Date(config.createdAt);
-  assert.ok(!isNaN(date.getTime()), 'createdAt should be a valid ISO date string');
-});
-
-test('calling getConfig() twice returns the same token (persistence)', () => {
-  const { getConfig } = require('../auth.js');
-  const config1 = getConfig();
-  const config2 = getConfig();
-  assert.equal(config1.authToken, config2.authToken, 'authToken should be identical across calls');
-  assert.equal(config1.createdAt, config2.createdAt, 'createdAt should be identical across calls');
-});

package/test/cli.test.js

@@ -1,57 +0,0 @@
-'use strict';
-
-const { afterEach, beforeEach, test } = require('node:test');
-const assert = require('node:assert/strict');
-const { createSessionId, startTestDaemon, stripAnsi, waitFor } = require('../test-support/daemon-harness');
-
-let harness;
-
-function collectJsonMessages(ws) {
-  const messages = [];
-  ws.on('message', (chunk) => {
-    try {
-      messages.push(JSON.parse(chunk.toString()));
-    } catch {
-      // Ignore malformed payloads in tests.
-    }
-  });
-  return messages;
-}
-
-beforeEach(async () => {
-  harness = await startTestDaemon();
-});
-
-afterEach(async () => {
-  await harness.stop();
-});
-
-test('telepty list prints active sessions from the configured host and port', async () => {
-  const sessionId = createSessionId('cli-list');
-  await harness.spawnSession(sessionId);
-
-  const result = await harness.runCli(['list']);
-  assert.equal(result.code, 0, result.stderr);
-
-  const output = stripAnsi(`${result.stdout}\n${result.stderr}`);
-  assert.match(output, new RegExp(sessionId));
-  assert.match(output, /Active Sessions/i);
-});
-
-test('telepty inject forwards input to the target PTY session', async () => {
-  const sessionId = createSessionId('cli-inject');
-  await harness.spawnSession(sessionId);
-
-  const ws = await harness.connectSession(sessionId);
-  const outputs = collectJsonMessages(ws);
-  const token = createSessionId('cli-token');
-
-  const result = await harness.runCli(['inject', sessionId, `echo ${token}`]);
-  assert.equal(result.code, 0, result.stderr);
-
-  await waitFor(() => outputs.some((message) => (
-    message.type === 'output' && String(message.data).includes(token)
-  )), { timeoutMs: 7000, description: 'CLI inject output' });
-
-  ws.close();
-});

package/test/daemon.test.js

@@ -1,415 +0,0 @@
-'use strict';
-
-const { afterEach, beforeEach, test } = require('node:test');
-const assert = require('node:assert/strict');
-const { createSessionId, delay, startTestDaemon, waitFor } = require('../test-support/daemon-harness');
-
-let harness;
-
-function collectJsonMessages(ws) {
-  const messages = [];
-  ws.on('message', (chunk) => {
-    try {
-      messages.push(JSON.parse(chunk.toString()));
-    } catch {
-      // Ignore malformed payloads in tests.
-    }
-  });
-  return messages;
-}
-
-beforeEach(async () => {
-  harness = await startTestDaemon();
-});
-
-afterEach(async () => {
-  await harness.stop();
-});
-
-test('GET /api/sessions returns an empty array on a fresh daemon', async () => {
-  const result = await harness.request('/api/sessions');
-  assert.equal(result.status, 200);
-  assert.deepEqual(result.body, []);
-});
-
-test('spawned sessions appear in the list and duplicate IDs are rejected', async () => {
-  const sessionId = createSessionId('spawn');
-  const first = await harness.spawnSession(sessionId);
-  assert.equal(first.status, 201);
-  assert.equal(first.body.session_id, sessionId);
-
-  const duplicate = await harness.spawnSession(sessionId);
-  assert.equal(duplicate.status, 409);
-  assert.match(duplicate.body.error, /already active/i);
-
-  const list = await harness.request('/api/sessions');
-  assert.equal(list.status, 200);
-  assert.equal(list.body.length, 1);
-  assert.equal(list.body[0].id, sessionId);
-  assert.equal(list.body[0].active_clients, 0);
-});
-
-test('PATCH /api/sessions/:id renames the session and publishes a bus event', async () => {
-  const originalId = createSessionId('rename');
-  const newId = `${originalId}-renamed`;
-  await harness.spawnSession(originalId);
-
-  const bus = await harness.connectBus();
-  const messages = collectJsonMessages(bus);
-
-  const rename = await harness.request(`/api/sessions/${encodeURIComponent(originalId)}`, {
-    method: 'PATCH',
-    body: { new_id: newId }
-  });
-
-  assert.equal(rename.status, 200);
-  assert.equal(rename.body.new_id, newId);
-
-  await waitFor(() => messages.find((message) => (
-    message.type === 'session_rename' &&
-    message.old_id === originalId &&
-    message.new_id === newId
-  )), { description: 'rename bus event' });
-
-  const list = await harness.request('/api/sessions');
-  assert.equal(list.status, 200);
-  assert.equal(list.body.length, 1);
-  assert.equal(list.body[0].id, newId);
-
-  bus.close();
-});
-
-test('inject and multicast endpoints report success and partial failure correctly', async () => {
-  const sessionId = createSessionId('inject');
-  const missingId = createSessionId('missing');
-  await harness.spawnSession(sessionId);
-
-  const inject = await harness.request(`/api/sessions/${encodeURIComponent(sessionId)}/inject`, {
-    method: 'POST',
-    body: { prompt: 'echo injected' }
-  });
-  assert.equal(inject.status, 200);
-  assert.equal(inject.body.success, true);
-
-  const injectMissingPrompt = await harness.request(`/api/sessions/${encodeURIComponent(sessionId)}/inject`, {
-    method: 'POST',
-    body: {}
-  });
-  assert.equal(injectMissingPrompt.status, 400);
-
-  const multicast = await harness.request('/api/sessions/multicast/inject', {
-    method: 'POST',
-    body: {
-      session_ids: [sessionId, missingId],
-      prompt: 'echo multicast'
-    }
-  });
-
-  assert.equal(multicast.status, 200);
-  assert.deepEqual(multicast.body.results.successful, [sessionId]);
-  assert.equal(multicast.body.results.failed.length, 1);
-  assert.equal(multicast.body.results.failed[0].id, missingId);
-});
-
-test('broadcast inject publishes a single bus event with all successful target IDs', async () => {
-  const sessionA = createSessionId('broadcast-a');
-  const sessionB = createSessionId('broadcast-b');
-  await harness.spawnSession(sessionA);
-  await harness.spawnSession(sessionB);
-
-  const bus = await harness.connectBus();
-  const messages = collectJsonMessages(bus);
-
-  const prompt = `echo ${createSessionId('broadcast-token')}`;
-  const broadcast = await harness.request('/api/sessions/broadcast/inject', {
-    method: 'POST',
-    body: { prompt }
-  });
-
-  assert.equal(broadcast.status, 200);
-  assert.equal(broadcast.body.results.successful.length, 2);
-
-  await waitFor(() => messages.filter((message) => (
-    message.type === 'injection' &&
-    message.target_agent === 'all' &&
-    message.content === prompt
-  )).length === 1, { description: 'single broadcast bus event' });
-
-  await delay(100);
-
-  const event = messages.find((message) => message.type === 'injection' && message.content === prompt);
-  assert.equal(messages.filter((message) => message.type === 'injection' && message.content === prompt).length, 1);
-  assert.deepEqual(event.session_ids.slice().sort(), [sessionA, sessionB].sort());
-
-  bus.close();
-});
-
-test('session WebSocket updates active client counts and relays PTY output', async () => {
-  const sessionId = createSessionId('ws');
-  await harness.spawnSession(sessionId);
-
-  const firstClient = await harness.connectSession(sessionId);
-  const secondClient = await harness.connectSession(sessionId);
-  const outputs = collectJsonMessages(firstClient);
-
-  await waitFor(async () => {
-    const list = await harness.request('/api/sessions');
-    const session = list.body.find((item) => item.id === sessionId);
-    return session && session.active_clients === 2;
-  }, { description: 'two attached websocket clients' });
-
-  const token = createSessionId('ws-output');
-  firstClient.send(JSON.stringify({ type: 'input', data: `echo ${token}\r` }));
-
-  await waitFor(() => outputs.some((message) => (
-    message.type === 'output' && String(message.data).includes(token)
-  )), { timeoutMs: 7000, description: 'PTY output over websocket' });
-
-  secondClient.close();
-
-  await waitFor(async () => {
-    const list = await harness.request('/api/sessions');
-    const session = list.body.find((item) => item.id === sessionId);
-    return session && session.active_clients === 1;
-  }, { description: 'one attached websocket client after close' });
-
-  firstClient.close();
-
-  await waitFor(async () => {
-    const list = await harness.request('/api/sessions');
-    const session = list.body.find((item) => item.id === sessionId);
-    return session && session.active_clients === 0;
-  }, { description: 'zero attached websocket clients after close' });
-});
-
-test('DELETE /api/sessions/:id closes the session without crashing the daemon', async () => {
-  const sessionId = createSessionId('delete');
-  await harness.spawnSession(sessionId);
-
-  const destroy = await harness.request(`/api/sessions/${encodeURIComponent(sessionId)}`, {
-    method: 'DELETE'
-  });
-  assert.equal(destroy.status, 200);
-  assert.equal(destroy.body.status, 'closing');
-
-  await waitFor(async () => {
-    const list = await harness.request('/api/sessions');
-    return list.status === 200 && !list.body.some((session) => session.id === sessionId);
-  }, { description: 'session removal after delete' });
-
-  await delay(200);
-  assert.equal(harness.isAlive(), true, harness.getLogs().stderr || harness.getLogs().stdout);
-
-  const healthCheck = await harness.request('/api/sessions');
-  assert.equal(healthCheck.status, 200);
-});
-
-// --- Wrapped session (register) tests ---
-
-test('POST /api/sessions/register creates a wrapped session with correct type', async () => {
-  const sessionId = createSessionId('register');
-  const result = await harness.registerSession(sessionId);
-  assert.equal(result.status, 201);
-  assert.equal(result.body.session_id, sessionId);
-  assert.equal(result.body.type, 'wrapped');
-
-  const list = await harness.request('/api/sessions');
-  assert.equal(list.body.length, 1);
-  assert.equal(list.body[0].id, sessionId);
-  assert.equal(list.body[0].type, 'wrapped');
-});
-
-test('register rejects missing session_id and duplicate IDs', async () => {
-  const noId = await harness.registerSession(undefined, { session_id: undefined });
-  assert.equal(noId.status, 400);
-
-  const sessionId = createSessionId('dup-reg');
-  await harness.registerSession(sessionId);
-  const duplicate = await harness.registerSession(sessionId);
-  assert.equal(duplicate.status, 409);
-  assert.match(duplicate.body.error, /already active/i);
-});
-
-test('register and spawn share the same namespace (cross-type duplicate rejection)', async () => {
-  const sessionId = createSessionId('cross');
-  await harness.spawnSession(sessionId);
-  const dup = await harness.registerSession(sessionId);
-  assert.equal(dup.status, 409);
-
-  const sessionId2 = createSessionId('cross2');
-  await harness.registerSession(sessionId2);
-  const dup2 = await harness.spawnSession(sessionId2);
-  assert.equal(dup2.status, 409);
-});
-
-test('register publishes a session_register bus event', async () => {
-  const bus = await harness.connectBus();
-  const messages = collectJsonMessages(bus);
-
-  const sessionId = createSessionId('bus-reg');
-  await harness.registerSession(sessionId);
-
-  await waitFor(() => messages.find((message) => (
-    message.type === 'session_register' &&
-    message.session_id === sessionId
-  )), { description: 'register bus event' });
-
-  bus.close();
-});
-
-test('inject on wrapped session without owner returns 503', async () => {
-  const sessionId = createSessionId('no-owner');
-  await harness.registerSession(sessionId);
-
-  const inject = await harness.request(`/api/sessions/${encodeURIComponent(sessionId)}/inject`, {
-    method: 'POST',
-    body: { prompt: 'hello' }
-  });
-  assert.equal(inject.status, 503);
-  assert.match(inject.body.error, /not connected/i);
-});
-
-test('inject on wrapped session forwards to owner WebSocket', async () => {
-  const sessionId = createSessionId('owner-inject');
-  await harness.registerSession(sessionId);
-
-  // First WebSocket connector becomes owner
-  const ownerWs = await harness.connectSession(sessionId);
-  const ownerMessages = collectJsonMessages(ownerWs);
-
-  const inject = await harness.request(`/api/sessions/${encodeURIComponent(sessionId)}/inject`, {
-    method: 'POST',
-    body: { prompt: 'injected-text' }
-  });
-  assert.equal(inject.status, 200);
-  assert.equal(inject.body.success, true);
-
-  await waitFor(() => ownerMessages.find((message) => (
-    message.type === 'inject' && String(message.data).includes('injected-text')
-  )), { description: 'inject message forwarded to owner' });
-
-  ownerWs.close();
-});
-
-test('wrapped session owner output broadcasts to attached clients', async () => {
-  const sessionId = createSessionId('owner-broadcast');
-  await harness.registerSession(sessionId);
-
-  const ownerWs = await harness.connectSession(sessionId);
-  const viewerWs = await harness.connectSession(sessionId);
-  const viewerMessages = collectJsonMessages(viewerWs);
-
-  // Owner sends output
-  ownerWs.send(JSON.stringify({ type: 'output', data: 'hello-viewer' }));
-
-  await waitFor(() => viewerMessages.find((message) => (
-    message.type === 'output' && String(message.data).includes('hello-viewer')
-  )), { description: 'owner output relayed to viewer' });
-
-  ownerWs.close();
-  viewerWs.close();
-});
-
-test('wrapped session non-owner input forwards to owner as inject', async () => {
-  const sessionId = createSessionId('viewer-input');
-  await harness.registerSession(sessionId);
-
-  const ownerWs = await harness.connectSession(sessionId);
-  const ownerMessages = collectJsonMessages(ownerWs);
-  const viewerWs = await harness.connectSession(sessionId);
-
-  viewerWs.send(JSON.stringify({ type: 'input', data: 'viewer-typing' }));
-
-  await waitFor(() => ownerMessages.find((message) => (
-    message.type === 'inject' && String(message.data).includes('viewer-typing')
-  )), { description: 'viewer input forwarded to owner as inject' });
-
-  ownerWs.close();
-  viewerWs.close();
-});
-
-test('DELETE on wrapped session removes it without crashing the daemon', async () => {
-  const sessionId = createSessionId('del-wrap');
-  await harness.registerSession(sessionId);
-
-  const destroy = await harness.request(`/api/sessions/${encodeURIComponent(sessionId)}`, {
-    method: 'DELETE'
-  });
-  assert.equal(destroy.status, 200);
-  assert.equal(destroy.body.status, 'closing');
-
-  const list = await harness.request('/api/sessions');
-  assert.equal(list.body.some((s) => s.id === sessionId), false);
-
-  await delay(200);
-  assert.equal(harness.isAlive(), true, harness.getLogs().stderr || harness.getLogs().stdout);
-});
-
-test('wrapped session auto-cleans when owner disconnects and no other clients remain', async () => {
-  const sessionId = createSessionId('auto-clean');
-  await harness.registerSession(sessionId);
-
-  const ownerWs = await harness.connectSession(sessionId);
-
-  await waitFor(async () => {
-    const list = await harness.request('/api/sessions');
-    const session = list.body.find((s) => s.id === sessionId);
-    return session && session.active_clients === 1;
-  }, { description: 'owner connected' });
-
-  ownerWs.close();
-
-  await waitFor(async () => {
-    const list = await harness.request('/api/sessions');
-    return !list.body.some((s) => s.id === sessionId);
-  }, { description: 'wrapped session auto-removed after owner disconnect' });
-});
-
-test('multicast inject handles mixed spawned and wrapped sessions', async () => {
-  const spawnedId = createSessionId('multi-spawn');
-  const wrappedId = createSessionId('multi-wrap');
-  await harness.spawnSession(spawnedId);
-  await harness.registerSession(wrappedId);
-
-  // Wrapped session without owner should fail
-  const result = await harness.request('/api/sessions/multicast/inject', {
-    method: 'POST',
-    body: { session_ids: [spawnedId, wrappedId], prompt: 'echo mixed' }
-  });
-
-  assert.equal(result.status, 200);
-  assert.deepEqual(result.body.results.successful, [spawnedId]);
-  assert.equal(result.body.results.failed.length, 1);
-  assert.equal(result.body.results.failed[0].id, wrappedId);
-  assert.match(result.body.results.failed[0].error, /not connected/i);
-});
-
-test('spawned shells strip parent Claude session markers from the environment', async () => {
-  const marker = createSessionId('claude-env');
-  const localHarness = await startTestDaemon({ env: { CLAUDECODE: marker } });
-
-  try {
-    const sessionId = createSessionId('env');
-    await localHarness.spawnSession(sessionId);
-    const ws = await localHarness.connectSession(sessionId);
-    const outputs = collectJsonMessages(ws);
-
-    const command = process.platform === 'win32'
-      ? "if ($env:CLAUDECODE) { Write-Output $env:CLAUDECODE } else { Write-Output '__unset__' }\r"
-      : "if [ -n \"${CLAUDECODE}\" ]; then printf '%s\\n' \"$CLAUDECODE\"; else printf '__unset__\\n'; fi\r";
-
-    ws.send(JSON.stringify({ type: 'input', data: command }));
-
-    await waitFor(() => outputs.some((message) => (
-      message.type === 'output' && String(message.data).includes('__unset__')
-    )), { timeoutMs: 7000, description: 'sanitized Claude session marker' });
-
-    assert.equal(outputs.some((message) => (
-      message.type === 'output' && String(message.data).includes(marker)
-    )), false);
-
-    ws.close();
-  } finally {
-    await localHarness.stop();
-  }
-});

package/test-pty.js

@@ -1,14 +0,0 @@
-const pty = require('node-pty');
-try {
-  const p = pty.spawn('/bin/bash', [], {
-    name: 'xterm-color',
-    cols: 80,
-    rows: 30,
-    cwd: process.env.HOME,
-    env: process.env
-  });
-  console.log('Success, PID:', p.pid);
-  p.kill();
-} catch (e) {
-  console.error('Error:', e);
-}