How routeplane-core/routeplane-devtools works
Routeplane Devtools provides three user-facing paths into the Routeplane AI Gateway: a TypeScript SDK for application requests, an rp CLI for development and operations, and an MCP server that exposes gateway operations to AI clients. The gateway performs inference, routing, governance, and administration; the repository supplies clients and adapters rather than implementing the gateway itself. The sampled code confirms SDK transport, CLI dispatch/authentication, and MCP tool dispatch; some documented resource and command wiring is represented at its exact enclosing directory because those implementations were not sampled.
Main entry points: index.ts Command dispatcher · server.ts MCP request server · core/client.ts Core HTTP client · openai/client.ts OpenAI-compatible client
Components 30
TypeScript SDK
- OpenAI-compatible client
packages/sdk/src/openai/client.ts - Core HTTP client
packages/sdk/src/core/client.ts - Header builder
packages/sdk/src/core/headers.ts - Streaming decoder
packages/sdk/src/core/streaming.ts - Inference requests
packages/sdk/src/openai/client.ts - Gateway resources
packages/sdk/src/core/resources - Agent security
packages/sdk/src/core/resources/mcp.ts - Evaluation resources
packages/sdk/src/core/resources/evaluations.ts
CLI
- Command dispatcher
packages/cli/src/index.ts - Profiles and config
packages/cli/src/config.ts - Connection resolver
packages/cli/src/resolve.ts - Gateway commands
packages/cli/src/commands - Deterministic eval
packages/cli/src/commands/eval.ts - Agent operations
packages/cli/src/commands/agents.ts - Feedback command
packages/cli/src/commands/feedback.ts - Control Plane auth
packages/cli/src/cp-auth.ts - Tenant and key admin
packages/cli/src/commands
MCP Server
- Stdio entry point
packages/mcp-server/src/index.ts - MCP request server
packages/mcp-server/src/server.ts - Tool registry
packages/mcp-server/src/tools/index.ts - Inference tools
packages/mcp-server/src/tools/inference.ts - Security tools
packages/mcp-server/src/tools/security.ts - Management tools
packages/mcp-server/src/tools/management.ts - Observability tools
packages/mcp-server/src/tools/observability.ts
Other components
- Application developer
- MCP client
- CLI operator
- Routeplane Gateway
- Control Plane API
- Model providers
Connections 40
- Application developer → OpenAI-compatible client: uses
- OpenAI-compatible client → Header builder: builds headers
- OpenAI-compatible client → Core HTTP client: creates core client
- OpenAI-compatible client → Inference requests: sends completions
- OpenAI-compatible client → Streaming decoder: decodes streams
- Core HTTP client → Header builder: builds headers
- Core HTTP client → Streaming decoder: decodes SSE
- Core HTTP client → Gateway resources: dispatches resource calls
- Core HTTP client → Routeplane Gateway: HTTP requests
- Inference requests → Routeplane Gateway: completion requests
- Agent security → Core HTTP client: posts policy requests
- Evaluation resources → Core HTTP client: scores cases
- Routeplane Gateway → Model providers: routes inference
- CLI operator → Command dispatcher: runs commands
- Command dispatcher → Connection resolver: resolves connection
- Command dispatcher → Gateway commands: dispatches commands
- Command dispatcher → Deterministic eval: dispatches eval
- Command dispatcher → Agent operations: dispatches agent ops
- Command dispatcher → Feedback command: dispatches feedback
- Command dispatcher → Tenant and key admin: dispatches admin
- Profiles and config → Connection resolver: supplies profiles
- Control Plane auth → Profiles and config: reads and saves tokens
- Tenant and key admin → Control Plane auth: authenticates requests
- Control Plane auth → Control Plane API: OAuth and API calls
- Connection resolver → Routeplane Gateway: resolves gateway access
- Gateway commands → Routeplane Gateway: calls gateway
- Agent operations → Routeplane Gateway: manages agent security
- Feedback command → Routeplane Gateway: submits feedback
- MCP client → Stdio entry point: connects over stdio
- Stdio entry point → MCP request server: starts server
- MCP request server → Tool registry: registers tools
- MCP request server → Inference tools: dispatches inference
- MCP request server → Security tools: dispatches security
- MCP request server → Management tools: dispatches management
- MCP request server → Observability tools: dispatches observability
- MCP request server → Routeplane Gateway: reads resources
- Inference tools → Routeplane Gateway: sends inference requests
- Security tools → Routeplane Gateway: calls security endpoints
- Management tools → Routeplane Gateway: calls management endpoints
- Observability tools → Routeplane Gateway: reads telemetry