@relayplane/proxy 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RelayPlane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,156 @@
+# @relayplane/proxy
+
+**100% Local. Zero Cloud. Full Control.**
+
+Intelligent AI model routing that cuts costs by 50-80% while maintaining quality.
+
+[![npm version](https://img.shields.io/npm/v/@relayplane/proxy)](https://www.npmjs.com/package/@relayplane/proxy)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Install
+
+```bash
+npm install @relayplane/proxy
+```
+
+Or run directly:
+
+```bash
+npx @relayplane/proxy
+```
+
+## Quick Start
+
+### 1. Set your API keys
+
+```bash
+export ANTHROPIC_API_KEY="sk-ant-..."
+export OPENAI_API_KEY="sk-..."
+# Optional: GEMINI_API_KEY, XAI_API_KEY, MOONSHOT_API_KEY
+```
+
+### 2. Start the proxy
+
+```bash
+npx @relayplane/proxy --port 3001
+```
+
+### 3. Point your tools to the proxy
+
+```bash
+export ANTHROPIC_BASE_URL=http://localhost:3001
+export OPENAI_BASE_URL=http://localhost:3001
+
+# Now run OpenClaw, Cursor, Aider, or any tool
+openclaw
+```
+
+That's it. All API calls now route through RelayPlane for intelligent model selection.
+
+## How It Works
+
+```
+Your Tool (OpenClaw, Cursor, etc.)
+         │
+         ▼
+    RelayPlane Proxy
+    ├── Infers task type (code_review, analysis, etc.)
+    ├── Checks routing rules
+    ├── Selects optimal model (Haiku for simple, Opus for complex)
+    └── Tracks outcomes for learning
+         │
+         ▼
+    Provider (Anthropic, OpenAI, etc.)
+```
+
+## Supported Providers
+
+| Provider | Models | Streaming | Tools |
+|----------|--------|-----------|-------|
+| **Anthropic** | Claude Opus, Sonnet, Haiku | ✓ | ✓ |
+| **OpenAI** | GPT-4o, GPT-4o-mini, o1, o3 | ✓ | ✓ |
+| **Google** | Gemini 2.0 Flash, 1.5 Pro | ✓ | — |
+| **xAI** | Grok-2, Grok-2-mini | ✓ | ✓ |
+| **Moonshot** | v1-8k, v1-32k, v1-128k | ✓ | ✓ |
+
+## Routing Modes
+
+| Model | Description |
+|-------|-------------|
+| `relayplane:auto` | Infers task type, routes to optimal model |
+| `relayplane:cost` | Prioritizes cheapest models (maximum savings) |
+| `relayplane:quality` | Uses best available model |
+
+Or pass through explicit models: `claude-3-5-sonnet-latest`, `gpt-4o`, etc.
+
+## Why RelayPlane?
+
+| Without RelayPlane | With RelayPlane |
+|-------------------|-----------------|
+| Pay Opus prices for simple tasks | Route simple tasks to Haiku (1/10 cost) |
+| Static model selection | Learns from outcomes over time |
+| Manual optimization | Automatic cost-quality balance |
+| No visibility into spend | Built-in savings tracking |
+
+## Key Features
+
+- **100% Local** — All data in SQLite (`~/.relayplane/data.db`)
+- **Zero Friction** — Set 2 env vars, done
+- **Learning** — Improves routing based on outcomes
+- **Full Streaming** — SSE support for all providers
+- **Tool Calls** — Function calling across providers
+
+## Programmatic Usage
+
+```typescript
+import { startProxy, RelayPlane, calculateSavings } from '@relayplane/proxy';
+
+// Start the proxy
+await startProxy({ port: 3001, verbose: true });
+
+// Or use RelayPlane directly
+const relay = new RelayPlane({});
+const result = await relay.run({ prompt: 'Review this code...' });
+console.log(result.taskType); // 'code_review'
+console.log(result.model);    // 'anthropic:claude-3-5-haiku-latest'
+
+// Check savings
+const savings = calculateSavings(relay.store, 30);
+console.log(`Saved ${savings.savingsPercent}% this month`);
+
+relay.close();
+```
+
+## CLI Options
+
+```bash
+npx @relayplane/proxy [options]
+
+Options:
+  --port <number>    Port to listen on (default: 3001)
+  --host <string>    Host to bind to (default: 127.0.0.1)
+  -v, --verbose      Enable verbose logging
+  -h, --help         Show help
+```
+
+## Data Storage
+
+All data stored locally at `~/.relayplane/data.db` (SQLite).
+
+```bash
+# View recent runs
+sqlite3 ~/.relayplane/data.db "SELECT * FROM runs ORDER BY timestamp DESC LIMIT 10"
+
+# Check routing rules
+sqlite3 ~/.relayplane/data.db "SELECT * FROM routing_rules"
+```
+
+## Links
+
+- [Documentation](https://relayplane.com/integrations/openclaw)
+- [GitHub](https://github.com/RelayPlane/proxy)
+- [RelayPlane SDK](https://github.com/RelayPlane/sdk)
+
+## License
+
+MIT

package/dist/cli.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node