smashimo/oh-my-pi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: cleanup package level stuff

Browse Source
This commit is contained in:
can1357
2026-03-03 05:40:33 +01:00
parent ce74ff08a1
commit 1f78e7fa13
3 changed files with 13 additions and 405 deletions
Download Patch File Download Diff File Expand all files Collapse all files
package.json
+10 -15
View File
@@ -7,29 +7,25 @@
],
"scripts": {
"install:dev": "bun install && bun --cwd=packages/coding-agent link && bun --cwd=packages/ai link",
"dev": "bun packages/coding-agent/src/cli.ts",
"dev": "bun --cwd=packages/coding-agent src/cli.ts",
"stats": "bun --cwd=packages/coding-agent src/cli.ts stats",
"test": "bun --cwd=packages/ai run test && bun --cwd=packages/agent run test && bun --cwd=packages/tui run test && bun --cwd=packages/natives run test && bun --cwd=packages/coding-agent run test",
"check": "bun run check:ts && bun run check:rs",
"test": "bun run --workspaces --if-present --parallel test",
"check": "bun run --parallel check:ts check:rs",
"check:ts": "biome check . && tsgo -p tsconfig.json && tsgo -p packages/stats/tsconfig.client.json",
"check:rs": "cargo fmt --all -- --check && cargo clippy --workspace -- -D warnings && cargo check -Z minimal-versions --workspace",
"lint": "bun run lint:ts && bun run lint:rs",
"lint:ts": "bunx @biomejs/biome lint .",
"lint": "bun run --parallel lint:ts lint:rs",
"lint:ts": "biome lint .",
"lint:rs": "cargo clippy --workspace -- -D warnings",
"fmt": "bun run fmt:ts && bun run fmt:rs",
"fmt:ts": "bunx @biomejs/biome format --write .",
"fmt": "bun run --parallel fmt:ts fmt:rs",
"fmt:ts": "biome format --write .",
"fmt:rs": "cargo fmt --all",
"fix": "bun run fix:ts && bun run fix:rs",
"fix": "bun run --parallel fix:ts fix:rs",
"fix:ts": "biome check --write --unsafe . && bun --cwd=packages/coding-agent run format-prompts && bun --cwd=packages/coding-agent run generate-docs-index",
"fix:rs": "cargo clippy --fix --allow-dirty --all-targets --no-deps --allow-staged --broken-code --allow-no-vcs && cargo fmt --all",
"build:native": "bun --cwd=packages/natives run build:native",
"dev:native": "bun --cwd=packages/natives run dev:native",
"bench:gen-fixtures": "bun --cwd=packages/react-edit-benchmark run src/generate.ts --react-dir /tmp/react-source --count-per-type 8",
"bench:edit": "bun --cwd=packages/react-edit-benchmark run start",
"version:patch": "npm version patch -ws --no-git-tag-version && bun scripts/sync-versions.ts && rm -rf node_modules packages/*/node_modules bun.lock && bun install",
"version:minor": "npm version minor -ws --no-git-tag-version && bun scripts/sync-versions.ts && rm -rf node_modules packages/*/node_modules bun.lock && bun install",
"version:major": "npm version major -ws --no-git-tag-version && bun scripts/sync-versions.ts && rm -rf node_modules packages/*/node_modules bun.lock && bun install",
"version:set": "npm version -ws",
"prepublishOnly": "bun run check",
"prepare": "bun --cwd=packages/coding-agent run generate-docs-index",
"publish": "bun run prepublishOnly && npm publish -ws --access public",
@@ -37,8 +33,7 @@
"release": "bun scripts/release.ts",
"generate-models": "bun --cwd=packages/ai scripts/generate-models.ts",
"generate-docs-index": "bun --cwd=packages/coding-agent run generate-docs-index",
"sync-exports": "bun scripts/sync-exports.ts",
"mermaid-build": "bun scripts/mermaid-build.ts"
"sync-exports": "bun scripts/sync-exports.ts"
},
"devDependencies": {
"@biomejs/biome": "^2.4",
@@ -52,4 +47,4 @@
"lint-staged": {
"*.{js,ts,jsx,tsx,json,jsonc,css}": "biome check --write --no-errors-on-unmatched"
}
}
}
packages/coding-agent/MCP_COMMAND_GUIDE.md
-390
View File
@@ -1,390 +0,0 @@
# MCP Server Management Command Guide
Complete guide for the `/mcp` command in oh-my-pi.
## Overview
The `/mcp` command provides interactive management of Model Context Protocol (MCP) servers. It allows you to add, remove, list, and test MCP servers through a user-friendly command-line interface.
## Commands
### `/mcp` or `/mcp help`
Shows help text with all available commands.
### `/mcp add`
Launch interactive wizard to add a new MCP server.
**Features:**
- Step-by-step guided setup
- Real-time validation
- Three authentication methods
- User or project-level configuration
- Automatic connection testing
**Wizard Flow:**
1. **Server Name** - Unique identifier (letters, numbers, dash, underscore, dot only)
2. **Transport Type** - Choose stdio/http/sse
3. **Configuration**:
- **stdio**: Command + optional arguments
- **http/sse**: Server URL
4. **Authentication** - Three options:
- None (for local/trusted servers)
- OAuth (web-based authentication)
- Manual API key/token
5. **Scope** - User-level (`~/.omp/mcp.json`) or project-level (`.omp/mcp.json`)
6. **Confirmation** - Review and save
### `/mcp list`
List all configured MCP servers with connection status.
**Output:**
- Server name
- Connection status (connected/not connected)
- Transport type [stdio/http/sse]
- Organized by scope (user-level vs project-level)
### `/mcp remove <name>`
Remove an MCP server from configuration.
**Behavior:**
- Disconnects server if currently connected
- Removes from config file
- Reloads MCP manager
- Shows confirmation message
### `/mcp test <name>`
Test connection to an MCP server.
**Features:**
- Creates temporary test connection
- Lists server info and version
- Shows available tools (up to 10)
- Disconnects after test
- Provides helpful error messages
### `/mcp auth <name>`
Reauthorize OAuth for an existing MCP server.
### `/mcp smithery-search <keyword> [--scope project|user] [--limit <1-100>] [--semantic]`
Search Smithery registry and deploy a result from an interactive picker.
**Behavior:**
- Queries Smithery (`registry.smithery.ai`)
- Matches by display name and qualified name by default
- Use `--semantic` to keep raw Smithery results/ranking (no local filtering)
- Shows a keyboard-selectable list of matches
- Prompts for local server name before deploy (default generated from registry name, editable)
- Creates/reuses a Smithery Connect connection and handles provider auth via Smithery when required
- Deploys selected server to project or user config
- Immediately triggers MCP reload so tools become available in runtime
- If Smithery returns auth/rate-limit errors, prompts for Smithery login and retries automatically
### `/mcp smithery-login`
Configure Smithery authentication for Smithery commands.
**Supported flows:**
- Browser-assisted CLI auth flow (default)
- Manual API key entry in parallel; whichever completes first proceeds
API key is cached in `~/.omp/agent/smithery.json`.
### `/mcp smithery-logout`
Remove cached Smithery API key from `~/.omp/agent/smithery.json`.
## Authentication Methods
### 1. No Authentication
For local or trusted MCP servers that don't require credentials.
**Use cases:**
- Local filesystem servers
- Development/testing servers
- Internal network servers
**Configuration:** No auth fields in config
### 2. Manual API Key/Token
#### Environment Variable (for stdio servers)
```json
{
"type": "stdio",
"command": "npx",
"args": ["mcp-server"],
"env": {
"API_KEY": "sk-..."
}
}
```
**Supports shell commands:**
```json
{
"env": {
"API_KEY": "!op read op://vault/mykey"
}
}
```
#### HTTP/SSE Header (for http/sse servers)
```json
{
"type": "http",
"url": "https://api.example.com/mcp",
"headers": {
"Authorization": "Bearer sk-..."
}
}
```
**Automatic Bearer prefix:** If header is "Authorization" and value doesn't start with "Bearer ", it's added automatically.
### 3. OAuth Flow
**Full OAuth 2.0 support with PKCE:**
- Authorization Code flow
- PKCE (Proof Key for Code Exchange) for enhanced security
- Automatic browser launch
- Local callback server
- Secure token storage in agent.db
**OAuth Configuration:**
- **Authorization URL**: OAuth authorize endpoint
- **Token URL**: OAuth token endpoint
- **Client ID**: Your OAuth client identifier
- **Client Secret**: Optional (for flows requiring it)
- **Scopes**: Space-separated permissions (optional)
**Token Storage:**
Tokens are stored securely in `~/.omp/agent.db` and referenced by credential ID:
```json
{
"type": "http",
"url": "https://api.example.com/mcp",
"auth": {
"type": "oauth",
"credentialId": "mcp_oauth_1707409234567_abc123def"
}
}
```
**Token Injection:**
- **HTTP/SSE servers**: Added to `Authorization` header as `Bearer <token>`
- **stdio servers**: Added to `OAUTH_ACCESS_TOKEN` environment variable
## Configuration Files
### User-level: `~/.omp/mcp.json`
Global configuration available to all projects.
### Project-level: `.omp/mcp.json`
Project-specific configuration (usually in project root).
### Example Configuration
**stdio server with API key:**
```json
{
"mcpServers": {
"filesystem": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/data"],
"env": {
"LOG_LEVEL": "debug"
}
}
}
}
```
**HTTP/SSE server with OAuth:**
```json
{
"mcpServers": {
"external-api": {
"type": "http",
"url": "https://api.example.com/mcp",
"auth": {
"type": "oauth",
"credentialId": "mcp_oauth_1707409234567_abc123def"
}
}
}
}
```
## Error Messages & Troubleshooting
### Common Errors
**"Server name can only contain letters, numbers, dash, underscore, and dot"**
- Server names must be alphanumeric with limited special characters
- Maximum 100 characters
**"Invalid URL format (must start with http:// or https://)"**
- URLs for HTTP/SSE servers must include protocol
- Example: `https://api.example.com/mcp`
**"Server already exists"**
- A server with this name is already configured
- Use `/mcp list` to see existing servers
- Choose a different name or remove the existing server first
**"ECONNREFUSED"**
- Server is not running or URL/port is incorrect
- Check server is started
- Verify URL and port number
**"401" or "403"**
- Authentication failed
- Check API key/token is correct
- For OAuth, re-authenticate
**"timeout"**
- Server is slow or unresponsive
- Try increasing timeout in config
- Check network connection
### Tips
1. **Test before committing**: Use `/mcp test <name>` after adding a server
2. **Start simple**: Begin with no authentication, add auth later if needed
3. **Check logs**: Server errors often indicate configuration issues
4. **Validate URLs**: Ensure URLs are accessible (try in browser first)
5. **Shell commands**: Use `!op read` for password manager integration
## Workflow Examples
### Adding a Local Filesystem Server
```
/mcp add
→ Name: "docs"
→ Transport: stdio
→ Command: npx
→ Args: -y @modelcontextprotocol/server-filesystem /home/user/docs
→ Auth: No authentication
→ Scope: Project level
→ Confirm: Yes
```
### Adding an API Server with OAuth
```
/mcp add
→ Name: "external-api"
→ Transport: http or sse
→ URL: https://api.example.com/mcp
→ Auth: OAuth flow
→ Authorization URL: https://auth.example.com/oauth/authorize
→ Token URL: https://auth.example.com/oauth/token
→ Client ID: your_client_id
→ Client Secret: (leave empty if PKCE-only)
→ Scopes: read write
→ Confirm OAuth config
→ [Browser opens for authentication]
→ Scope: User level
→ Confirm: Yes
```
### Adding an HTTP/SSE Server with API Key
```
/mcp add
→ Name: "api-server"
→ Transport: http or sse
→ URL: https://api.example.com/mcp
→ Auth: Manual API key/token
→ API Key: sk-1234567890abcdef
→ Location: HTTP/SSE header
→ Header Name: Authorization
→ Scope: User level
→ Confirm: Yes
```
### Testing and Managing
```bash
# List all servers
/mcp list
# Test a server
/mcp test docs
# Remove a server
/mcp remove docs
```
## Best Practices
1. **Use project-level config for project-specific servers**
- Keep project dependencies in project
- Easier to share with team
2. **Use user-level config for personal/global servers**
- Credentials stay private
- Available across all projects
3. **Secure sensitive data**
- Use OAuth when available
- Use shell commands for API keys: `!op read op://vault/key`
- Never commit `.omp/mcp.json` files with plain API keys to version control
4. **Name servers descriptively**
- Use purpose-based names: "github-tools", "docs-search"
- Avoid generic names: "server1", "test"
5. **Test after adding**
- Always run `/mcp test <name>` after adding a server
- Verify tools are accessible
- Check authentication works
## Advanced Features
### Shell Command References
Any environment variable or header value can reference a shell command:
```json
{
"env": {
"API_KEY": "!op read op://vault/mcp-key"
}
}
```
The command is executed once and cached for the session.
### Automatic Token Refresh
OAuth tokens are automatically refreshed when needed (not yet implemented, but infrastructure is in place).
### Connection Pooling
MCP Manager maintains persistent connections to servers for better performance.
## Limitations
1. **No inline editing**: To modify a server, remove and re-add it
2. **No bulk operations**: Servers must be managed individually
3. **No server templates**: Each server configured from scratch
## Files Modified
- `packages/coding-agent/src/mcp/config-writer.ts` - Config file I/O
- `packages/coding-agent/src/mcp/oauth-flow.ts` - OAuth authentication
- `packages/coding-agent/src/mcp/manager.ts` - Added auth resolution
- `packages/coding-agent/src/modes/controllers/mcp-command-controller.ts` - Command routing
- `packages/coding-agent/src/modes/components/mcp-add-wizard.ts` - Interactive wizard
- `packages/coding-agent/src/sdk.ts` - Auth storage integration
## API Reference
For programmatic access, see:
- `MCPManager.setAuthStorage()` - Set auth storage for OAuth resolution
- `validateServerName()` - Validate server names
- `addMCPServer()` - Add server to config file
- `removeMCPServer()` - Remove server from config file
- `getMCPConfigPath()` - Get config file path
packages/swarm-extension/package.json
+3
View File
@@ -23,6 +23,9 @@
"bin": {
"omp-swarm": "src/cli.ts"
},
"scripts": {
"check": "tsgo -p tsconfig.json"
},
"dependencies": {},
"devDependencies": {
"@types/bun": "^1.3"