@bytespell/shella 0.2.2 → 0.2.3

package/bundled-plugins/terminal/package.json

@@ -1,37 +0,0 @@
-{
-  "name": "@shella/terminal",
-  "private": true,
-  "version": "0.2.2",
-  "type": "module",
-  "main": "server.ts",
-  "shella": {
-    "displayName": "Terminal",
-    "devCommand": "tsx server.ts"
-  },
-  "scripts": {
-    "dev": "tsx server.ts",
-    "build": "vite build",
-    "preview": "vite preview"
-  },
-  "dependencies": {
-    "@xterm/addon-fit": "^0.10.0",
-    "@xterm/addon-web-links": "^0.11.0",
-    "@xterm/xterm": "^5.5.0",
-    "express": "^5.0.0",
-    "node-pty": "^1.2.0-beta.7",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "ws": "^8.18.0"
-  },
-  "devDependencies": {
-    "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
-    "@types/react": "^19.2.0",
-    "@types/react-dom": "^19.2.0",
-    "@types/ws": "^8.5.0",
-    "@vitejs/plugin-react": "^4.3.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.6.0",
-    "vite": "^6.0.0"
-  }
-}

package/bundled-plugins/terminal/server.ts

@@ -1,169 +0,0 @@
-import express from 'express'
-import { createServer } from 'http'
-import { WebSocketServer, WebSocket } from 'ws'
-import * as pty from 'node-pty'
-import path from 'path'
-import fs from 'fs'
-import { fileURLToPath } from 'url'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const app = express()
-const PORT = process.env.PORT
-
-// Check if we're in dev mode (no dist folder)
-const isDev = !fs.existsSync(path.join(__dirname, 'dist', 'index.html'))
-
-// Allow embedding in iframes (for shella-web)
-app.use((_req, res, next) => {
-  res.removeHeader('X-Frame-Options')
-  res.setHeader('Content-Security-Policy', 'frame-ancestors *')
-  next()
-})
-
-app.use(express.json())
-
-// Health check
-app.get('/api/health', (_req, res) => {
-  res.json({ status: 'ok', shell: process.env.SHELL || '/bin/bash' })
-})
-
-async function startServer() {
-  if (isDev) {
-    // Dev mode: use Vite middleware for HMR
-    const { createServer: createViteServer } = await import('vite')
-    const vite = await createViteServer({
-      server: { middlewareMode: true, hmr: { port: Number(PORT) + 1000 } },
-      appType: 'spa',
-    })
-    app.use(vite.middlewares)
-  } else {
-    // Production: serve built files
-    app.use(express.static(path.join(__dirname, 'dist')))
-    app.get('*', (_req, res) => {
-      res.sendFile(path.join(__dirname, 'dist', 'index.html'))
-    })
-  }
-
-  const server = createServer(app)
-
-  // PTY is spawned lazily on first client connection with correct size
-  const shell = process.env.SHELL || '/bin/bash'
-  const home = process.env.HOME || '/tmp'
-
-  let ptyProcess: pty.IPty | null = null
-
-  // Track connected clients
-  const clients = new Set<WebSocket>()
-
-  // Buffer recent output for new clients (scrollback)
-  const outputBuffer: string[] = []
-  const MAX_BUFFER_LINES = 1000
-
-  function spawnPty(cols: number, rows: number) {
-    if (ptyProcess) return // Already spawned
-
-    ptyProcess = pty.spawn(shell, [], {
-      name: 'xterm-256color',
-      cols,
-      rows,
-      cwd: home,
-      env: {
-        ...process.env as Record<string, string>,
-        // Suppress zsh's partial line marker (%) on fresh terminal
-        PROMPT_EOL_MARK: '',
-      },
-    })
-
-    console.log(`[terminal] PTY spawned: pid=${ptyProcess.pid}, shell=${shell}, size=${cols}x${rows}`)
-
-    // PTY -> all connected clients
-    ptyProcess.onData((data: string) => {
-      // Buffer output for new clients
-      outputBuffer.push(data)
-      if (outputBuffer.length > MAX_BUFFER_LINES) {
-        outputBuffer.shift()
-      }
-
-      // Broadcast to all connected clients
-      const message = JSON.stringify({ type: 'output', data })
-      for (const client of clients) {
-        if (client.readyState === WebSocket.OPEN) {
-          client.send(message)
-        }
-      }
-    })
-
-    ptyProcess.onExit(({ exitCode, signal }) => {
-      console.log(`[terminal] PTY exited: code=${exitCode}, signal=${signal}`)
-      const message = JSON.stringify({ type: 'exit', exitCode, signal })
-      for (const client of clients) {
-        if (client.readyState === WebSocket.OPEN) {
-          client.send(message)
-          client.close()
-        }
-      }
-      // PTY died, shut down the instance
-      process.exit(exitCode ?? 0)
-    })
-  }
-
-  // WebSocket server for client connections
-  const wss = new WebSocketServer({ server, path: '/ws' })
-
-  wss.on('connection', (ws: WebSocket) => {
-    clients.add(ws)
-
-    // Send buffered output to new client so they see history (if PTY already running)
-    if (ptyProcess && outputBuffer.length > 0) {
-      ws.send(JSON.stringify({ type: 'output', data: outputBuffer.join('') }))
-    }
-
-    // Client -> PTY
-    ws.on('message', (message: Buffer) => {
-      try {
-        const msg = JSON.parse(message.toString())
-
-        switch (msg.type) {
-          case 'input':
-            ptyProcess?.write(msg.data)
-            break
-          case 'resize':
-            if (msg.cols && msg.rows) {
-              if (!ptyProcess) {
-                // First resize spawns the PTY with correct size
-                spawnPty(msg.cols, msg.rows)
-              } else {
-                ptyProcess.resize(msg.cols, msg.rows)
-              }
-            }
-            break
-        }
-      } catch (err) {
-        console.error('[terminal] Invalid message:', err)
-      }
-    })
-
-    ws.on('close', () => {
-      clients.delete(ws)
-    })
-
-    ws.on('error', (err) => {
-      console.error('[terminal] WebSocket error:', err)
-      clients.delete(ws)
-    })
-  })
-
-  server.listen(PORT, () => {
-    console.log(`[terminal] Running on port ${PORT}${isDev ? ' (dev mode with HMR)' : ''}`)
-  })
-
-  // Graceful shutdown - kill PTY when instance stops
-  process.on('SIGTERM', () => {
-    console.log('[terminal] SIGTERM received, shutting down')
-    ptyProcess?.kill()
-    wss.clients.forEach((client) => client.close())
-    server.close(() => process.exit(0))
-  })
-}
-
-startServer()

package/bundled-plugins/terminal/src/App.tsx

@@ -1,168 +0,0 @@
-import { useEffect, useRef, useState } from 'react'
-import { Terminal } from '@xterm/xterm'
-import { FitAddon } from '@xterm/addon-fit'
-import { WebLinksAddon } from '@xterm/addon-web-links'
-import '@xterm/xterm/css/xterm.css'
-
-type ConnectionStatus = 'connecting' | 'connected' | 'disconnected' | 'error'
-
-export default function App() {
-  const terminalRef = useRef<HTMLDivElement>(null)
-  const termRef = useRef<Terminal | null>(null)
-  const wsRef = useRef<WebSocket | null>(null)
-  const fitAddonRef = useRef<FitAddon | null>(null)
-  const [status, setStatus] = useState<ConnectionStatus>('connecting')
-
-  useEffect(() => {
-    if (!terminalRef.current) return
-
-    // Create terminal
-    const term = new Terminal({
-      cursorBlink: true,
-      fontSize: 14,
-      fontFamily: 'Menlo, Monaco, "Courier New", monospace',
-      theme: {
-        background: '#1a1a1a',
-        foreground: '#e0e0e0',
-        cursor: '#e0e0e0',
-        cursorAccent: '#1a1a1a',
-        selectionBackground: '#4a4a4a',
-        black: '#1a1a1a',
-        red: '#ff5555',
-        green: '#50fa7b',
-        yellow: '#f1fa8c',
-        blue: '#6272a4',
-        magenta: '#ff79c6',
-        cyan: '#8be9fd',
-        white: '#e0e0e0',
-        brightBlack: '#4a4a4a',
-        brightRed: '#ff6e6e',
-        brightGreen: '#69ff94',
-        brightYellow: '#ffffa5',
-        brightBlue: '#d6acff',
-        brightMagenta: '#ff92df',
-        brightCyan: '#a4ffff',
-        brightWhite: '#ffffff',
-      },
-    })
-
-    // Add addons
-    const fitAddon = new FitAddon()
-    const webLinksAddon = new WebLinksAddon()
-    term.loadAddon(fitAddon)
-    term.loadAddon(webLinksAddon)
-
-    // Open terminal in container
-    term.open(terminalRef.current)
-    fitAddon.fit()
-
-    termRef.current = term
-    fitAddonRef.current = fitAddon
-
-    // Connect WebSocket
-    const wsProtocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:'
-    const ws = new WebSocket(`${wsProtocol}//${window.location.host}/ws`)
-    wsRef.current = ws
-
-    ws.onopen = () => {
-      setStatus('connected')
-      // Send initial size
-      const dims = fitAddon.proposeDimensions()
-      if (dims) {
-        ws.send(JSON.stringify({ type: 'resize', cols: dims.cols, rows: dims.rows }))
-      }
-    }
-
-    ws.onmessage = (event) => {
-      try {
-        const msg = JSON.parse(event.data)
-        switch (msg.type) {
-          case 'output':
-            term.write(msg.data)
-            break
-          case 'exit':
-            term.write(`\r\n\x1b[31m[Process exited with code ${msg.exitCode}]\x1b[0m\r\n`)
-            setStatus('disconnected')
-            break
-        }
-      } catch {
-        // Raw data fallback
-        term.write(event.data)
-      }
-    }
-
-    ws.onerror = () => {
-      setStatus('error')
-    }
-
-    ws.onclose = () => {
-      if (status !== 'error') {
-        setStatus('disconnected')
-      }
-    }
-
-    // Terminal input -> WebSocket
-    term.onData((data) => {
-      if (ws.readyState === WebSocket.OPEN) {
-        ws.send(JSON.stringify({ type: 'input', data }))
-      }
-    })
-
-    // Handle resize
-    const handleResize = () => {
-      fitAddon.fit()
-      const dims = fitAddon.proposeDimensions()
-      if (dims && ws.readyState === WebSocket.OPEN) {
-        ws.send(JSON.stringify({ type: 'resize', cols: dims.cols, rows: dims.rows }))
-      }
-    }
-
-    window.addEventListener('resize', handleResize)
-
-    // Also observe container size changes (for panel resizes)
-    const resizeObserver = new ResizeObserver(handleResize)
-    resizeObserver.observe(terminalRef.current)
-
-    // Cleanup
-    return () => {
-      window.removeEventListener('resize', handleResize)
-      resizeObserver.disconnect()
-      ws.close()
-      term.dispose()
-    }
-  }, [])
-
-  return (
-    <div
-      style={{
-        width: '100%',
-        height: '100%',
-        backgroundColor: '#1a1a1a',
-        display: 'flex',
-        flexDirection: 'column',
-      }}
-    >
-      {status !== 'connected' && (
-        <div
-          style={{
-            padding: '8px 12px',
-            backgroundColor: status === 'error' ? '#ff5555' : '#4a4a4a',
-            color: '#fff',
-            fontSize: '12px',
-          }}
-        >
-          {status === 'connecting' && 'Connecting...'}
-          {status === 'disconnected' && 'Disconnected'}
-          {status === 'error' && 'Connection error'}
-        </div>
-      )}
-      <div
-        ref={terminalRef}
-        style={{
-          flex: 1,
-          padding: '4px',
-        }}
-      />
-    </div>
-  )
-}

package/bundled-plugins/terminal/src/main.tsx

@@ -1,9 +0,0 @@
-import { StrictMode } from 'react'
-import { createRoot } from 'react-dom/client'
-import App from './App'
-
-createRoot(document.getElementById('root')!).render(
-  <StrictMode>
-    <App />
-  </StrictMode>
-)

package/bundled-plugins/terminal/tsconfig.json

@@ -1,22 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "useDefineForClassFields": true,
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "skipLibCheck": true,
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "isolatedModules": true,
-    "moduleDetection": "force",
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "esModuleInterop": true
-  },
-  "include": ["src", "server.ts"]
-}

package/bundled-plugins/terminal/vite.config.ts

@@ -1,10 +0,0 @@
-import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-
-export default defineConfig({
-  plugins: [react()],
-  build: {
-    outDir: 'dist',
-    emptyDirBeforeWrite: true,
-  },
-})

package/templates/express/package.json

@@ -1,11 +0,0 @@
-{
-  "name": "shella-plugin",
-  "version": "1.0.0",
-  "main": "server.js",
-  "shella": {
-    "displayName": "My Plugin"
-  },
-  "dependencies": {
-    "express": "^4.18.0"
-  }
-}

package/templates/express/public/index.html

@@ -1,64 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Shella Plugin</title>
-  <style>
-    * { box-sizing: border-box; margin: 0; padding: 0; }
-    body {
-      font-family: system-ui, -apple-system, sans-serif;
-      background: #0a0a0a;
-      color: #fafafa;
-      min-height: 100vh;
-      padding: 2rem;
-    }
-    .container { max-width: 600px; margin: 0 auto; }
-    h1 { margin-bottom: 1rem; }
-    .card {
-      background: #1a1a1a;
-      border: 1px solid #333;
-      border-radius: 8px;
-      padding: 1.5rem;
-      margin-bottom: 1rem;
-    }
-    button {
-      background: #fff;
-      color: #000;
-      border: none;
-      padding: 0.5rem 1rem;
-      border-radius: 4px;
-      cursor: pointer;
-      font-size: 1rem;
-    }
-    button:hover { background: #ddd; }
-    #result {
-      margin-top: 1rem;
-      padding: 1rem;
-      background: #262626;
-      border-radius: 4px;
-      display: none;
-    }
-  </style>
-</head>
-<body>
-  <div class="container">
-    <h1>Shella Plugin</h1>
-    <div class="card">
-      <p>This is your plugin scaffold. Edit this file and server.js to build your UI.</p>
-      <br>
-      <button onclick="testApi()">Test API</button>
-      <div id="result"></div>
-    </div>
-  </div>
-  <script>
-    async function testApi() {
-      const res = await fetch('/api/hello');
-      const data = await res.json();
-      const result = document.getElementById('result');
-      result.style.display = 'block';
-      result.textContent = JSON.stringify(data, null, 2);
-    }
-  </script>
-</body>
-</html>

package/templates/express/server.js

@@ -1,37 +0,0 @@
-const express = require('express');
-const path = require('path');
-
-const app = express();
-const PORT = process.env.PORT;
-
-// Allow embedding in iframes (for shella-web)
-app.use((req, res, next) => {
-  res.setHeader('Content-Security-Policy', "frame-ancestors *");
-  next();
-});
-
-// Middleware
-app.use(express.json());
-app.use(express.static(path.join(__dirname, 'public')));
-
-// API routes
-app.get('/api/hello', (req, res) => {
-  res.json({ message: 'Hello from the plugin!' });
-});
-
-// Add your API endpoints here
-// Example: Import from parent project
-// const { someFunction } = require('../src/mymodule.js');
-// app.post('/api/analyze', async (req, res) => {
-//   const result = await someFunction(req.body);
-//   res.json(result);
-// });
-
-const server = app.listen(PORT, () => {
-  console.log(`Plugin running on port ${PORT}`);
-});
-
-// Graceful shutdown
-process.on('SIGTERM', () => {
-  server.close(() => process.exit(0));
-});

package/templates/vanilla/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "shella-plugin",
-  "version": "1.0.0",
-  "main": "server.js",
-  "shella": {
-    "displayName": "My Plugin"
-  }
-}

package/templates/vanilla/public/index.html

@@ -1,64 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Shella Plugin</title>
-  <style>
-    * { box-sizing: border-box; margin: 0; padding: 0; }
-    body {
-      font-family: system-ui, -apple-system, sans-serif;
-      background: #0a0a0a;
-      color: #fafafa;
-      min-height: 100vh;
-      padding: 2rem;
-    }
-    .container { max-width: 600px; margin: 0 auto; }
-    h1 { margin-bottom: 1rem; }
-    .card {
-      background: #1a1a1a;
-      border: 1px solid #333;
-      border-radius: 8px;
-      padding: 1.5rem;
-      margin-bottom: 1rem;
-    }
-    button {
-      background: #fff;
-      color: #000;
-      border: none;
-      padding: 0.5rem 1rem;
-      border-radius: 4px;
-      cursor: pointer;
-      font-size: 1rem;
-    }
-    button:hover { background: #ddd; }
-    #result {
-      margin-top: 1rem;
-      padding: 1rem;
-      background: #262626;
-      border-radius: 4px;
-      display: none;
-    }
-  </style>
-</head>
-<body>
-  <div class="container">
-    <h1>Shella Plugin</h1>
-    <div class="card">
-      <p>This is your plugin scaffold. Edit this file and server.js to build your UI.</p>
-      <br>
-      <button onclick="testApi()">Test API</button>
-      <div id="result"></div>
-    </div>
-  </div>
-  <script>
-    async function testApi() {
-      const res = await fetch('/api/hello');
-      const data = await res.json();
-      const result = document.getElementById('result');
-      result.style.display = 'block';
-      result.textContent = JSON.stringify(data, null, 2);
-    }
-  </script>
-</body>
-</html>

package/templates/vanilla/server.js

@@ -1,54 +0,0 @@
-const http = require('http');
-const fs = require('fs');
-const path = require('path');
-
-const PORT = process.env.PORT;
-
-// Simple static file server + API
-const server = http.createServer((req, res) => {
-  // Allow embedding in iframes (for shella-web)
-  res.setHeader('Content-Security-Policy', "frame-ancestors *");
-  // API routes
-  if (req.url === '/api/hello' && req.method === 'GET') {
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ message: 'Hello from the plugin!' }));
-    return;
-  }
-
-  // Serve static files from public/
-  let filePath = path.join(__dirname, 'public', req.url === '/' ? 'index.html' : req.url);
-  const ext = path.extname(filePath);
-
-  const mimeTypes = {
-    '.html': 'text/html',
-    '.js': 'text/javascript',
-    '.css': 'text/css',
-    '.json': 'application/json',
-    '.png': 'image/png',
-    '.svg': 'image/svg+xml',
-  };
-
-  fs.readFile(filePath, (err, content) => {
-    if (err) {
-      if (err.code === 'ENOENT') {
-        res.writeHead(404);
-        res.end('Not found');
-      } else {
-        res.writeHead(500);
-        res.end('Server error');
-      }
-      return;
-    }
-    res.writeHead(200, { 'Content-Type': mimeTypes[ext] || 'text/plain' });
-    res.end(content);
-  });
-});
-
-server.listen(PORT, () => {
-  console.log(`Plugin running on port ${PORT}`);
-});
-
-// Graceful shutdown
-process.on('SIGTERM', () => {
-  server.close(() => process.exit(0));
-});