npm - persistent-terminal-mcp - Versions diffs - 1.0.2 - Mend

persistent-terminal-mcp 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (87) hide show

package/CHANGELOG.md +278 -0
package/LICENSE +21 -0
package/README.en.md +259 -0
package/README.md +608 -0
package/dist/examples/basic-usage.d.ts +3 -0
package/dist/examples/basic-usage.d.ts.map +1 -0
package/dist/examples/basic-usage.js +116 -0
package/dist/examples/basic-usage.js.map +1 -0
package/dist/examples/codex-bug-fix-demo.d.ts +3 -0
package/dist/examples/codex-bug-fix-demo.d.ts.map +1 -0
package/dist/examples/codex-bug-fix-demo.js +134 -0
package/dist/examples/codex-bug-fix-demo.js.map +1 -0
package/dist/examples/interactive-demo.d.ts +3 -0
package/dist/examples/interactive-demo.d.ts.map +1 -0
package/dist/examples/interactive-demo.js +235 -0
package/dist/examples/interactive-demo.js.map +1 -0
package/dist/examples/rest-api-demo.d.ts +7 -0
package/dist/examples/rest-api-demo.d.ts.map +1 -0
package/dist/examples/rest-api-demo.js +160 -0
package/dist/examples/rest-api-demo.js.map +1 -0
package/dist/examples/smart-reading-demo.d.ts +3 -0
package/dist/examples/smart-reading-demo.d.ts.map +1 -0
package/dist/examples/smart-reading-demo.js +153 -0
package/dist/examples/smart-reading-demo.js.map +1 -0
package/dist/examples/test-all-9-tools.d.ts +8 -0
package/dist/examples/test-all-9-tools.d.ts.map +1 -0
package/dist/examples/test-all-9-tools.js +162 -0
package/dist/examples/test-all-9-tools.js.map +1 -0
package/dist/examples/test-all-tools.d.ts +3 -0
package/dist/examples/test-all-tools.d.ts.map +1 -0
package/dist/examples/test-all-tools.js +150 -0
package/dist/examples/test-all-tools.js.map +1 -0
package/dist/examples/test-fixes.d.ts +9 -0
package/dist/examples/test-fixes.d.ts.map +1 -0
package/dist/examples/test-fixes.js +168 -0
package/dist/examples/test-fixes.js.map +1 -0
package/dist/examples/test-spinner-compaction.d.ts +8 -0
package/dist/examples/test-spinner-compaction.d.ts.map +1 -0
package/dist/examples/test-spinner-compaction.js +155 -0
package/dist/examples/test-spinner-compaction.js.map +1 -0
package/dist/examples/test-web-ui.d.ts +12 -0
package/dist/examples/test-web-ui.d.ts.map +1 -0
package/dist/examples/test-web-ui.js +90 -0
package/dist/examples/test-web-ui.js.map +1 -0
package/dist/index.d.ts +8 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +81 -0
package/dist/index.js.map +1 -0
package/dist/mcp-server.d.ts +49 -0
package/dist/mcp-server.d.ts.map +1 -0
package/dist/mcp-server.js +1056 -0
package/dist/mcp-server.js.map +1 -0
package/dist/output-buffer.d.ts +134 -0
package/dist/output-buffer.d.ts.map +1 -0
package/dist/output-buffer.js +553 -0
package/dist/output-buffer.js.map +1 -0
package/dist/rest-api.d.ts +33 -0
package/dist/rest-api.d.ts.map +1 -0
package/dist/rest-api.js +325 -0
package/dist/rest-api.js.map +1 -0
package/dist/rest-server.d.ts +3 -0
package/dist/rest-server.d.ts.map +1 -0
package/dist/rest-server.js +72 -0
package/dist/rest-server.js.map +1 -0
package/dist/terminal-manager.d.ts +93 -0
package/dist/terminal-manager.d.ts.map +1 -0
package/dist/terminal-manager.js +702 -0
package/dist/terminal-manager.js.map +1 -0
package/dist/types.d.ts +201 -0
package/dist/types.d.ts.map +1 -0
package/dist/types.js +5 -0
package/dist/types.js.map +1 -0
package/dist/web-ui-manager.d.ts +38 -0
package/dist/web-ui-manager.d.ts.map +1 -0
package/dist/web-ui-manager.js +130 -0
package/dist/web-ui-manager.js.map +1 -0
package/dist/web-ui-server.d.ts +42 -0
package/dist/web-ui-server.d.ts.map +1 -0
package/dist/web-ui-server.js +324 -0
package/dist/web-ui-server.js.map +1 -0
package/package.json +129 -0
package/public/app.js +265 -0
package/public/index.html +63 -0
package/public/styles.css +383 -0
package/public/terminal.html +56 -0
package/public/terminal.js +244 -0
package/public/test.html +97 -0

package/public/terminal.html ADDED Viewed

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Terminal</title>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/xterm@5.3.0/css/xterm.css">
+  <link rel="stylesheet" href="/styles.css">
+</head>
+<body>
+  <div class="terminal-page">
+    <header class="terminal-header">
+      <div class="terminal-info">
+        <a href="/" class="back-link">← Back to List</a>
+        <h2 id="terminal-title">Terminal</h2>
+        <span id="terminal-status" class="status-badge">Loading...</span>
+      </div>
+      <div class="terminal-actions">
+        <button id="clear-btn" class="btn btn-secondary">Clear</button>
+        <button id="kill-btn" class="btn btn-danger">Kill Terminal</button>
+      </div>
+    </header>
+    <div class="terminal-details">
+      <div class="detail-item">
+        <span class="detail-label">PID:</span>
+        <span id="detail-pid">-</span>
+      </div>
+      <div class="detail-item">
+        <span class="detail-label">Shell:</span>
+        <span id="detail-shell">-</span>
+      </div>
+      <div class="detail-item">
+        <span class="detail-label">CWD:</span>
+        <span id="detail-cwd">-</span>
+      </div>
+      <div class="detail-item">
+        <span class="detail-label">Created:</span>
+        <span id="detail-created">-</span>
+      </div>
+    </div>
+    <div id="terminal-container"></div>
+    <div class="input-container">
+      <input type="text" id="command-input" placeholder="Type command and press Enter...">
+      <button id="send-btn" class="btn btn-primary">Send</button>
+    </div>
+  </div>
+  <script src="https://cdn.jsdelivr.net/npm/xterm@5.3.0/lib/xterm.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/xterm-addon-fit@0.8.0/lib/xterm-addon-fit.js"></script>
+  <script src="/terminal.js?v=3"></script>
+</body>
+</html>

package/public/terminal.js ADDED Viewed

@@ -0,0 +1,244 @@
+// Terminal Detail Page Logic
+let term = null;
+let ws = null;
+let terminalId = null;
+let currentCursor = 0;
+// Initialize
+document.addEventListener('DOMContentLoaded', () => {
+  // Get terminal ID from URL
+  const pathParts = window.location.pathname.split('/');
+  terminalId = pathParts[pathParts.length - 1];
+  if (!terminalId) {
+    alert('Invalid terminal ID');
+    window.location.href = '/';
+    return;
+  }
+  setupTerminal();
+  setupEventListeners();
+  connectWebSocket();
+  loadTerminalInfo();
+  loadTerminalOutput();
+});
+// Setup xterm.js
+function setupTerminal() {
+  try {
+    term = new Terminal({
+      cursorBlink: true,
+      fontSize: 14,
+      fontFamily: 'Menlo, Monaco, "Courier New", monospace',
+      theme: {
+        background: '#000000',
+        foreground: '#ffffff',
+        cursor: '#ffffff',
+        selection: '#ffffff40'
+      },
+      convertEol: true,
+      rows: 24,
+      cols: 80
+    });
+    const container = document.getElementById('terminal-container');
+    term.open(container);
+    // Fit terminal to container (optional, fallback if FitAddon not available)
+    if (typeof FitAddon !== 'undefined') {
+      try {
+        const fitAddon = new FitAddon.FitAddon();
+        term.loadAddon(fitAddon);
+        fitAddon.fit();
+        // Resize on window resize
+        window.addEventListener('resize', () => {
+          fitAddon.fit();
+        });
+      } catch (e) {
+        console.warn('FitAddon not available:', e);
+      }
+    }
+    console.log('Terminal initialized successfully');
+  } catch (error) {
+    console.error('Failed to setup terminal:', error);
+    alert('Failed to initialize terminal: ' + error.message);
+  }
+}
+// Setup event listeners
+function setupEventListeners() {
+  document.getElementById('send-btn').addEventListener('click', sendCommand);
+  document.getElementById('command-input').addEventListener('keypress', (e) => {
+    if (e.key === 'Enter') {
+      sendCommand();
+    }
+  });
+  document.getElementById('clear-btn').addEventListener('click', () => {
+    term.clear();
+  });
+  document.getElementById('kill-btn').addEventListener('click', killTerminal);
+}
+// WebSocket connection
+function connectWebSocket() {
+  const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+  const wsUrl = `${protocol}//${window.location.host}`;
+  ws = new WebSocket(wsUrl);
+  ws.onopen = () => {
+    console.log('WebSocket connected');
+  };
+  ws.onmessage = (event) => {
+    const message = JSON.parse(event.data);
+    handleWebSocketMessage(message);
+  };
+  ws.onerror = (error) => {
+    console.error('WebSocket error:', error);
+  };
+  ws.onclose = () => {
+    console.log('WebSocket disconnected, reconnecting...');
+    setTimeout(connectWebSocket, 2000);
+  };
+}
+// Handle WebSocket messages
+function handleWebSocketMessage(message) {
+  if (message.terminalId !== terminalId) return;
+  switch (message.type) {
+    case 'output':
+      term.write(message.data);
+      break;
+    case 'exit':
+      updateStatus('terminated');
+      term.write('\r\n\x1b[31m[Terminal Exited]\x1b[0m\r\n');
+      break;
+  }
+}
+// Load terminal info
+async function loadTerminalInfo() {
+  try {
+    console.log('Loading terminal info for:', terminalId);
+    const response = await fetch(`/api/terminals/${terminalId}`);
+    console.log('Response status:', response.status);
+    if (!response.ok) {
+      const errorText = await response.text();
+      console.error('Error response:', errorText);
+      throw new Error(`Terminal not found (${response.status})`);
+    }
+    const data = await response.json();
+    console.log('Terminal data:', data);
+    document.getElementById('terminal-title').textContent = `Terminal ${data.id.substring(0, 8)}`;
+    document.getElementById('detail-pid').textContent = data.pid;
+    document.getElementById('detail-shell').textContent = data.shell;
+    document.getElementById('detail-cwd').textContent = data.cwd;
+    document.getElementById('detail-created').textContent = new Date(data.created).toLocaleString();
+    updateStatus(data.status);
+    console.log('Terminal info loaded successfully');
+  } catch (error) {
+    console.error('Failed to load terminal info:', error);
+    alert('Failed to load terminal: ' + error.message);
+    // Don't redirect immediately, let user see the error
+    // window.location.href = '/';
+  }
+}
+// Load terminal output
+async function loadTerminalOutput() {
+  try {
+    console.log('Loading terminal output for:', terminalId);
+    const response = await fetch(`/api/terminals/${terminalId}/output?since=${currentCursor}`);
+    if (!response.ok) {
+      const errorText = await response.text();
+      console.error('Failed to load output:', errorText);
+      throw new Error('Failed to load output');
+    }
+    const data = await response.json();
+    console.log('Output data:', data);
+    if (data.output) {
+      term.write(data.output);
+      console.log('Wrote output to terminal');
+    } else {
+      console.log('No output to display');
+    }
+    currentCursor = data.cursor || data.since || 0;
+    console.log('Current cursor:', currentCursor);
+  } catch (error) {
+    console.error('Failed to load terminal output:', error);
+  }
+}
+// Send command
+async function sendCommand() {
+  const input = document.getElementById('command-input');
+  const command = input.value;
+  if (!command.trim()) return;
+  try {
+    const response = await fetch(`/api/terminals/${terminalId}/input`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ input: command })
+    });
+    if (!response.ok) {
+      throw new Error('Failed to send command');
+    }
+    input.value = '';
+  } catch (error) {
+    console.error('Failed to send command:', error);
+    alert('Failed to send command: ' + error.message);
+  }
+}
+// Kill terminal
+async function killTerminal() {
+  if (!confirm('Are you sure you want to kill this terminal?')) {
+    return;
+  }
+  try {
+    const response = await fetch(`/api/terminals/${terminalId}`, {
+      method: 'DELETE'
+    });
+    if (!response.ok) {
+      throw new Error('Failed to kill terminal');
+    }
+    alert('Terminal killed');
+    window.location.href = '/';
+  } catch (error) {
+    console.error('Failed to kill terminal:', error);
+    alert('Failed to kill terminal: ' + error.message);
+  }
+}
+// Update status badge
+function updateStatus(status) {
+  const badge = document.getElementById('terminal-status');
+  badge.textContent = status;
+  badge.className = 'status-badge status-' + status;
+}

package/public/test.html ADDED Viewed

@@ -0,0 +1,97 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>API Test</title>
+  <style>
+    body {
+      font-family: monospace;
+      padding: 20px;
+      background: #1e1e1e;
+      color: #d4d4d4;
+    }
+    pre {
+      background: #000;
+      padding: 10px;
+      border-radius: 4px;
+      overflow-x: auto;
+    }
+    button {
+      padding: 10px 20px;
+      margin: 5px;
+      background: #0e639c;
+      color: white;
+      border: none;
+      border-radius: 4px;
+      cursor: pointer;
+    }
+    button:hover {
+      background: #1177bb;
+    }
+  </style>
+</head>
+<body>
+  <h1>API Test Page</h1>
+  <div>
+    <button onclick="testListTerminals()">Test: List Terminals</button>
+    <button onclick="testGetTerminal()">Test: Get Terminal</button>
+    <button onclick="testGetOutput()">Test: Get Output</button>
+  </div>
+  <h2>Results:</h2>
+  <pre id="results">Click a button to test...</pre>
+  <script>
+    async function testListTerminals() {
+      try {
+        const response = await fetch('/api/terminals');
+        const data = await response.json();
+        document.getElementById('results').textContent = JSON.stringify(data, null, 2);
+      } catch (error) {
+        document.getElementById('results').textContent = 'Error: ' + error.message;
+      }
+    }
+    async function testGetTerminal() {
+      try {
+        // First get the list to find a terminal ID
+        const listResponse = await fetch('/api/terminals');
+        const listData = await listResponse.json();
+        if (listData.terminals && listData.terminals.length > 0) {
+          const terminalId = listData.terminals[0].id;
+          const response = await fetch(`/api/terminals/${terminalId}`);
+          const data = await response.json();
+          document.getElementById('results').textContent = JSON.stringify(data, null, 2);
+        } else {
+          document.getElementById('results').textContent = 'No terminals found';
+        }
+      } catch (error) {
+        document.getElementById('results').textContent = 'Error: ' + error.message;
+      }
+    }
+    async function testGetOutput() {
+      try {
+        // First get the list to find a terminal ID
+        const listResponse = await fetch('/api/terminals');
+        const listData = await listResponse.json();
+        if (listData.terminals && listData.terminals.length > 0) {
+          const terminalId = listData.terminals[0].id;
+          const response = await fetch(`/api/terminals/${terminalId}/output`);
+          const data = await response.json();
+          document.getElementById('results').textContent = JSON.stringify(data, null, 2);
+        } else {
+          document.getElementById('results').textContent = 'No terminals found';
+        }
+      } catch (error) {
+        document.getElementById('results').textContent = 'Error: ' + error.message;
+      }
+    }
+  </script>
+</body>
+</html>