opalserve 0.1.1 → 2.0.0

package/README.md

@@ -1,33 +1,28 @@
-# OpalServe
+<p align="center">
+  <img src="assets/banner.svg" alt="OpalServe" width="800" />
+</p>
 
-> Enterprise-grade MCP (Model Context Protocol) Tool Registry & Discovery Hub for AI Agents
+<p align="center">
+  <strong>Local MCP Tool Registry & Discovery Hub</strong>
+</p>
 
-[![npm version](https://img.shields.io/npm/v/opalserve?style=flat-square)](https://www.npmjs.com/package/opalserve)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen?style=flat-square)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue?style=flat-square)](https://www.typescriptlang.org/)
+<p align="center">
+  <a href="https://www.npmjs.com/package/opalserve"><img src="https://img.shields.io/npm/v/opalserve?style=flat-square&color=F97316" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/opalserve"><img src="https://img.shields.io/npm/dm/opalserve?style=flat-square" alt="downloads" /></a>
+  <a href="https://github.com/adityaidev/opalserve/blob/master/LICENSE"><img src="https://img.shields.io/github/license/adityaidev/opalserve?style=flat-square" alt="license" /></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square" alt="node version" /></a>
+</p>
 
-## What is OpalServe?
-
-OpalServe solves the **"N×M" integration problem** in AI agent tooling. Before MCP, developers had to build custom connectors for every combination of AI model and tool. OpalServe provides a centralized registry with intelligent, context-sized tool discovery.
-
-### Key Features
-
-- **Intelligent Discovery**: Context-sized responses with relevance scoring
-- **5 Pre-built Connectors**: GitHub, Slack, PostgreSQL, Google Drive, Custom
-- **40+ MCP Tools**: Ready-to-use tools with full JSON Schema documentation
-- **Visual Workflow Builder**: Build multi-step agentic workflows with templates
-- **Enterprise Security**: JWT authentication, RBAC, audit logging
-- **Governance**: Policy engine, rate limiting, compliance tracking
+---
 
-## Why OpalServe?
+**OpalServe** aggregates, discovers, and proxies tools across multiple MCP (Model Context Protocol) servers from a single hub.
 
-| Problem | Solution |
-|---------|----------|
-| Context bloat from loading all tools | Intelligent discovery with relevance scoring |
-| No standardized auth identity | JWT-based agent identity propagation |
-| Security vulnerabilities | Native `fetch` (no axios - March 2026 fix) |
-| Complex multi-tool workflows | Visual workflow builder with templates |
+- **Real MCP Protocol** — Connects to any MCP server via stdio, SSE, or Streamable HTTP
+- **Full-Text Search** — SQLite FTS5-powered tool discovery across all servers
+- **Beautiful CLI** — Interactive setup, gradient banners, color-coded tables
+- **HTTP API** — Fastify REST API for managing servers and tools
+- **Persistent** — SQLite database survives restarts
+- **MCP Gateway** — Acts as an MCP server itself for LLM clients
 
 ## Quick Start
 
@@ -35,113 +30,114 @@ OpalServe solves the **"N×M" integration problem** in AI agent tooling. Before
 # Install globally
 npm install -g opalserve
 
-# Or use via npx
-npx opalserve
+# Interactive setup
+opalserve init
+
+# Start the registry
+opalserve start
+```
+
+## Add MCP Servers
+
+```bash
+# Filesystem access
+opalserve server add --name files --stdio "npx -y @modelcontextprotocol/server-filesystem ."
 
-# Start the server
-opalserve
+# GitHub
+opalserve server add --name github --stdio "npx -y @modelcontextprotocol/server-github" --env GITHUB_TOKEN=ghp_xxx
 
-# Discover available tools
-opalserve-discover "github pull requests"
+# Any MCP server
+opalserve server add --name my-server --url https://mcp.example.com/sse
 ```
 
-## Available Tools
-
-### GitHub (8 tools)
-- List repositories, Get repository details
-- List pull requests, Get PR details, Create PR review
-- Create issue, List issues, Search code
-
-### Slack (8 tools)
-- Post message, Get channel info, List channels
-- List messages, Update message, Delete message
-- Upload file, Search messages
-
-### PostgreSQL (6 tools)
-- Execute query, Get schema, List tables
-- Get table info, List databases, Health check
-
-### Google Drive (10 tools)
-- List files, Get file, Create folder, Upload file
-- Share file, List permissions, Search files
-- Delete file, Download file, Get file metadata
-
-### Custom (5 tools)
-- HTTP request, Webhook trigger, Transform data
-- Aggregate data, Route request
-
-## API Endpoints
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| GET | `/api/v1/health` | Health check |
-| GET | `/api/v1/discover?query=<text>` | Discover tools by query |
-| GET | `/api/v1/tools` | List all registered tools |
-| GET | `/api/v1/tools/:id` | Get specific tool details |
-| GET | `/api/v1/servers` | List MCP servers |
-| POST | `/api/v1/servers/register` | Register new MCP server |
-| POST | `/api/v1/auth/token` | Generate JWT token |
-
-## Configuration
-
-```env
-PORT=3000
-HOST=localhost
-JWT_SECRET=your-secret-key
-GITHUB_TOKEN=ghp_xxx
-SLACK_BOT_TOKEN=xoxb-xxx
-POSTGRES_URL=postgresql://user:pass@host:5432/db
-GOOGLE_SERVICE_ACCOUNT=./config/google-service-account.json
-ENABLE_AUTH=false
+## Discover Tools
+
+```bash
+# List all tools
+opalserve tools list
+
+# Full-text search
+opalserve tools search "create issue"
+
+# Check server health
+opalserve health
 ```
 
-## Architecture
+## Use as MCP Gateway
 
+Point your MCP client (Claude Desktop, Cursor, etc.) at OpalServe to access all tools from one connection:
+
+```json
+{
+  "mcpServers": {
+    "opalserve": {
+      "command": "npx",
+      "args": ["-y", "opalserve", "start", "--mcp"]
+    }
+  }
+}
 ```
-┌─────────────────────────────────────────────────────────────┐
-│                     O P A L S E R V E                        │
-│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐│
-│  │  Discovery  │  │    Auth &   │  │   Tool Registry     ││
-│  │  Endpoint   │──│    RBAC     │──│   & Indexing        ││
-│  └─────────────┘  └─────────────┘  └─────────────────────┘│
-└─────────────────────────────────────────────────────────────┘
-         │                  │                    │
-         ▼                  ▼                    ▼
-┌─────────────┐    ┌─────────────┐      ┌─────────────┐
-│   GitHub    │    │    Slack    │      │  PostgreSQL │
-│  Connector  │    │  Connector  │      │  Connector  │
-└─────────────┘    └─────────────┘      └─────────────┘
-         │                  │                    │
-         ▼                  ▼                    ▼
-┌─────────────┐    ┌─────────────┐      ┌─────────────┐
-│ Google Drive│    │   Custom    │      │    More...  │
-│  Connector  │    │  Connector  │      │             │
-└─────────────┘    └─────────────┘      └─────────────┘
+
+## Library Usage
+
+```typescript
+import { OpalServeRegistry } from 'opalserve';
+
+const registry = await OpalServeRegistry.create({
+  servers: [{
+    name: 'my-files',
+    transport: { type: 'stdio', command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', '.'] },
+  }],
+});
+
+await registry.start();
+
+const tools = registry.listTools();
+const results = registry.searchTools('read file');
+const result = await registry.callTool('my-files:read_file', { path: './README.md' });
+
+await registry.stop();
 ```
 
-## Security Features
+## HTTP API
 
-- **JWT Authentication**: Secure agent identity propagation
-- **RBAC**: Fine-grained permission-based access control
-- **Confused Deputy Prevention**: Blocks malicious prompt injection
-- **Native HTTP**: Uses Node.js `fetch` (no external dependencies)
-- **Audit Logging**: Track all tool invocations and access
+Start the server with `opalserve start`, then:
 
-## Use Cases
+```bash
+# Health check
+curl http://localhost:3456/api/v1/health
 
-1. **AI Agent Tooling**: Give AI agents access to enterprise tools
-2. **Tool Discovery**: Find relevant tools based on natural language queries
-3. **Workflow Automation**: Build multi-step workflows with visual builder
-4. **Governance**: Monitor and control tool usage across organizations
+# List tools
+curl http://localhost:3456/api/v1/tools
 
-## Contributing
+# Search tools
+curl "http://localhost:3456/api/v1/tools/search?q=read+file"
 
-Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+# Call a tool
+curl -X POST http://localhost:3456/api/v1/tools/files%3Aread_file/call \
+  -H "Content-Type: application/json" \
+  -d '{"path": "./README.md"}'
+```
 
-## License
+## Architecture
 
-MIT License - see [LICENSE](LICENSE) for details.
+```
+[Claude/Cursor] <--MCP--> [OpalServe Gateway] <--MCP--> [Server A]
+                                  |             <--MCP--> [Server B]
+                            [HTTP API]           <--MCP--> [Server C]
+                            [SQLite DB]
+```
 
----
+OpalServe is simultaneously:
+- An **MCP Client** to each backend server
+- An **MCP Server** exposing aggregated tools
+- An **HTTP API** for management
+- A **CLI** for humans
+
+## Documentation
+
+Full documentation at [adityaidev.github.io/opalserve](https://adityaidev.github.io/opalserve)
+
+## License
 
-**Built for the AI Agent era** - Enterprise-ready MCP tool registry
+MIT

package/assets/logo.svg

@@ -0,0 +1,54 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" fill="none">
+  <defs>
+    <linearGradient id="opal-gradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#F59E0B"/>
+      <stop offset="35%" stop-color="#F97316"/>
+      <stop offset="65%" stop-color="#EF4444"/>
+      <stop offset="100%" stop-color="#8B5CF6"/>
+    </linearGradient>
+    <linearGradient id="opal-shine" x1="20%" y1="0%" x2="80%" y2="100%">
+      <stop offset="0%" stop-color="#FFFFFF" stop-opacity="0.4"/>
+      <stop offset="50%" stop-color="#FFFFFF" stop-opacity="0.1"/>
+      <stop offset="100%" stop-color="#FFFFFF" stop-opacity="0"/>
+    </linearGradient>
+    <linearGradient id="facet-light" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#FFFFFF" stop-opacity="0.25"/>
+      <stop offset="100%" stop-color="#FFFFFF" stop-opacity="0.05"/>
+    </linearGradient>
+  </defs>
+
+  <!-- Outer gem shape — hexagonal prism -->
+  <polygon
+    points="256,32 432,128 432,320 256,480 80,320 80,128"
+    fill="url(#opal-gradient)"
+  />
+
+  <!-- Top facet highlight -->
+  <polygon
+    points="256,32 432,128 256,192 80,128"
+    fill="url(#opal-shine)"
+  />
+
+  <!-- Left facet -->
+  <polygon
+    points="80,128 256,192 256,380 80,320"
+    fill="url(#facet-light)"
+    opacity="0.3"
+  />
+
+  <!-- Inner refraction lines -->
+  <line x1="256" y1="192" x2="256" y2="380" stroke="#FFFFFF" stroke-opacity="0.15" stroke-width="2"/>
+  <line x1="256" y1="192" x2="160" y2="260" stroke="#FFFFFF" stroke-opacity="0.12" stroke-width="1.5"/>
+  <line x1="256" y1="192" x2="352" y2="260" stroke="#FFFFFF" stroke-opacity="0.12" stroke-width="1.5"/>
+  <line x1="256" y1="192" x2="180" y2="340" stroke="#FFFFFF" stroke-opacity="0.08" stroke-width="1"/>
+  <line x1="256" y1="192" x2="332" y2="340" stroke="#FFFFFF" stroke-opacity="0.08" stroke-width="1"/>
+
+  <!-- Center sparkle -->
+  <circle cx="256" cy="220" r="6" fill="#FFFFFF" opacity="0.6"/>
+  <circle cx="256" cy="220" r="12" fill="#FFFFFF" opacity="0.15"/>
+
+  <!-- Small accent sparkles -->
+  <circle cx="200" cy="260" r="3" fill="#FFFFFF" opacity="0.3"/>
+  <circle cx="310" cy="280" r="2.5" fill="#FFFFFF" opacity="0.25"/>
+  <circle cx="240" cy="320" r="2" fill="#FFFFFF" opacity="0.2"/>
+</svg>

package/dist/cli/commands/health.d.ts

@@ -0,0 +1,4 @@
+export declare function healthCommand(options: {
+    server?: string;
+}): Promise<void>;
+//# sourceMappingURL=health.d.ts.map

package/dist/cli/commands/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/health.ts"],"names":[],"mappings":"AAKA,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC/E"}

package/dist/cli/commands/health.js

@@ -0,0 +1,36 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { OpalServeRegistry } from '../../core/registry.js';
+import { showMiniBanner, showSuccess, showError } from '../ui/banner.js';
+export async function healthCommand(options) {
+    showMiniBanner();
+    const spinner = ora('Running health checks...').start();
+    const registry = await OpalServeRegistry.create();
+    // Reconnect servers to get fresh status
+    const servers = registry.config.servers.filter(s => s.enabled);
+    if (options.server) {
+        const filtered = servers.filter(s => s.name === options.server);
+        if (filtered.length === 0) {
+            spinner.fail(`Server "${options.server}" not found`);
+            registry.getDatabase().close();
+            return;
+        }
+    }
+    const results = await registry.healthCheck(options.server);
+    spinner.stop();
+    console.log(`  ${chalk.bold('Health Check Results')}\n`);
+    for (const result of results) {
+        if (result.healthy) {
+            showSuccess(`${chalk.white(result.serverName)} — ${chalk.green('healthy')} (${result.toolCount} tools)`);
+        }
+        else {
+            showError(`${chalk.white(result.serverName)} — ${chalk.red('unhealthy')}${result.error ? ` (${result.error})` : ''}`);
+        }
+    }
+    if (results.length === 0) {
+        console.log(chalk.gray('  No servers registered.'));
+    }
+    console.log('');
+    registry.getDatabase().close();
+}
+//# sourceMappingURL=health.js.map

package/dist/cli/commands/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/cli/commands/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA4B;IAC9D,cAAc,EAAE,CAAC;IAEjB,MAAM,OAAO,GAAG,GAAG,CAAC,0BAA0B,CAAC,CAAC,KAAK,EAAE,CAAC;IAExD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,CAAC;IAElD,wCAAwC;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAChE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC;YACrD,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,EAAE,CAAC;IAEf,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAEzD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,WAAW,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,SAAS,SAAS,CAAC,CAAC;QAC3G,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxH,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initCommand(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAQA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAyDjD"}

package/dist/cli/commands/init.js

@@ -0,0 +1,81 @@
+import { writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import chalk from 'chalk';
+import { select } from '@inquirer/prompts';
+import { showBox, showSuccess, showInfo } from '../ui/banner.js';
+import { promptServerName, promptTransportType, promptStdioCommand, promptUrl, promptEnvVars, promptConfirm, promptPort } from '../ui/prompts.js';
+export async function initCommand() {
+    showBox(`Welcome to ${chalk.bold('OpalServe')} Setup\n\n` +
+        'This wizard will help you configure OpalServe\n' +
+        'as your local MCP tool registry.', 'Setup');
+    // Step 1: Config location
+    const configLocation = await select({
+        message: 'Where should OpalServe store its configuration?',
+        choices: [
+            { value: 'local', name: 'Current directory (./opalserve.config.json)' },
+            { value: 'home', name: 'Home directory (~/.opalserve/config.json)' },
+        ],
+    });
+    // Step 2: Port
+    const port = await promptPort();
+    // Step 3: Add servers
+    const servers = [];
+    let addServer = await promptConfirm('Would you like to register an MCP server now?');
+    while (addServer) {
+        const server = await promptServerConfig();
+        servers.push(server);
+        showSuccess(`Server "${server.name}" configured`);
+        addServer = await promptConfirm('Add another server?', false);
+    }
+    // Step 4: Write config
+    const config = {
+        servers,
+        gateway: { port, host: '127.0.0.1' },
+        storage: { path: '' },
+        logging: { level: 'info' },
+    };
+    const configPath = configLocation === 'local'
+        ? resolve(process.cwd(), 'opalserve.config.json')
+        : resolve(process.env.HOME || process.env.USERPROFILE || '.', '.opalserve', 'config.json');
+    // Ensure directory exists
+    const { mkdirSync } = await import('node:fs');
+    const { dirname } = await import('node:path');
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+    showSuccess(`Configuration saved to ${chalk.cyan(configPath)}`);
+    console.log('');
+    showInfo('Next steps:');
+    console.log(`    ${chalk.cyan('opalserve start')}        Start the registry`);
+    console.log(`    ${chalk.cyan('opalserve server add')}   Add more servers`);
+    console.log(`    ${chalk.cyan('opalserve tools')}        Browse available tools`);
+    console.log('');
+}
+async function promptServerConfig() {
+    const name = await promptServerName();
+    const transportType = await promptTransportType();
+    if (transportType === 'stdio') {
+        const { command, args } = await promptStdioCommand();
+        const env = await promptEnvVars();
+        return {
+            name,
+            transport: {
+                type: 'stdio',
+                command,
+                args,
+                ...(Object.keys(env).length > 0 ? { env } : {}),
+            },
+            enabled: true,
+            tags: [],
+            autoConnect: true,
+        };
+    }
+    const url = await promptUrl();
+    return {
+        name,
+        transport: { type: transportType, url },
+        enabled: true,
+        tags: [],
+        autoConnect: true,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/server.d.ts

@@ -0,0 +1,10 @@
+export declare function serverListCommand(): Promise<void>;
+export declare function serverAddCommand(options: {
+    name?: string;
+    stdio?: string;
+    url?: string;
+    transport?: string;
+    env?: string[];
+}): Promise<void>;
+export declare function serverRemoveCommand(name: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/cli/commands/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/server.ts"],"names":[],"mappings":"AAQA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAWvD;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4EhB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBrE"}

package/dist/cli/commands/server.js

@@ -0,0 +1,108 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { OpalServeRegistry } from '../../core/registry.js';
+import { McpServerConfigSchema } from '../../types/index.js';
+import { showMiniBanner, showSuccess, showError } from '../ui/banner.js';
+import { renderServerTable } from '../ui/table.js';
+import { promptServerName, promptTransportType, promptStdioCommand, promptUrl, promptEnvVars, promptConfirm } from '../ui/prompts.js';
+export async function serverListCommand() {
+    showMiniBanner();
+    const registry = await OpalServeRegistry.create();
+    const servers = registry.listServers();
+    console.log(`  ${chalk.bold('Registered Servers')} ${chalk.dim(`(${servers.length})`)}\n`);
+    console.log(renderServerTable(servers));
+    console.log('');
+    registry.getDatabase().close();
+}
+export async function serverAddCommand(options) {
+    showMiniBanner();
+    let config;
+    if (options.name && (options.stdio || options.url)) {
+        // Non-interactive mode
+        if (options.stdio) {
+            const parts = options.stdio.split(/\s+/);
+            const envObj = {};
+            if (options.env) {
+                for (const e of options.env) {
+                    const [key, ...valueParts] = e.split('=');
+                    envObj[key] = valueParts.join('=');
+                }
+            }
+            config = McpServerConfigSchema.parse({
+                name: options.name,
+                transport: {
+                    type: 'stdio',
+                    command: parts[0],
+                    args: parts.slice(1),
+                    ...(Object.keys(envObj).length > 0 ? { env: envObj } : {}),
+                },
+            });
+        }
+        else {
+            config = McpServerConfigSchema.parse({
+                name: options.name,
+                transport: {
+                    type: options.transport || 'sse',
+                    url: options.url,
+                },
+            });
+        }
+    }
+    else {
+        // Interactive mode
+        const name = options.name || await promptServerName();
+        const transportType = await promptTransportType();
+        if (transportType === 'stdio') {
+            const { command, args } = await promptStdioCommand();
+            const env = await promptEnvVars();
+            config = McpServerConfigSchema.parse({
+                name,
+                transport: {
+                    type: 'stdio',
+                    command,
+                    args,
+                    ...(Object.keys(env).length > 0 ? { env } : {}),
+                },
+            });
+        }
+        else {
+            const url = await promptUrl();
+            config = McpServerConfigSchema.parse({
+                name,
+                transport: { type: transportType, url },
+            });
+        }
+    }
+    const spinner = ora(`Connecting to ${config.name}...`).start();
+    try {
+        const registry = await OpalServeRegistry.create();
+        await registry.addServer(config);
+        const server = registry.listServers().find(s => s.name === config.name);
+        spinner.succeed(`Connected to ${chalk.white(config.name)}`);
+        showSuccess(`${server?.toolCount || 0} tools discovered`);
+        registry.getDatabase().close();
+    }
+    catch (error) {
+        spinner.fail(`Failed to connect to ${config.name}`);
+        showError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+export async function serverRemoveCommand(name) {
+    showMiniBanner();
+    const confirmed = await promptConfirm(`Remove server "${name}"?`);
+    if (!confirmed) {
+        console.log(chalk.dim('  Cancelled'));
+        return;
+    }
+    const registry = await OpalServeRegistry.create();
+    try {
+        await registry.removeServer(name);
+        showSuccess(`Server "${name}" removed`);
+    }
+    catch (error) {
+        showError(error instanceof Error ? error.message : String(error));
+    }
+    registry.getDatabase().close();
+}
+//# sourceMappingURL=server.js.map

package/dist/cli/commands/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/cli/commands/server.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/start.d.ts

@@ -0,0 +1,6 @@
+export declare function startCommand(options: {
+    port?: string;
+    host?: string;
+    config?: string;
+}): Promise<void>;
+//# sourceMappingURL=start.d.ts.map

package/dist/cli/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAMA,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgE5G"}