open-index/open-npm huggingface dataset:
npm package: @relayplane/adapters
Description: Provider adapters for OpenAI, Anthropic, Google, xAI, and Local LLMs
Author: RelayPlane
Latest version: 0.1.5

# @relayplane/adapters

Provider adapters for OpenAI, Anthropic, Google, xAI, and Local LLMs.

## Supported Providers

- **OpenAI** (Full support): Text, Vision, Structured Extraction
- **Anthropic** (Stub): Basic text completion
- **Google** (Stub): Placeholder
- **xAI** (Stub): Grok models via OpenAI-compatible API
- **Local** (Basic): Ollama support

## Adapter Interface

All adapters implement the `Adapter` interface:

```typescript
interface Adapter {
  execute(config: StepConfig, apiKey: string): Promise<AdapterResult>;
}
```

## Error Handling

Adapters **never throw** - they always return an `AdapterResult` with error information:

```typescript
interface AdapterResult {
  success: boolean;
  output?: any;
  error?: {
    type: string;
    message: string;
    recoverable: boolean;
  };
  tokenUsage?: TokenUsage;
}
```

## Documentation

See `/docs/Model Adapter Specification.md` for detailed implementation specs.
npm package: @relayplane/cli
Description: RelayPlane CLI - Command-line interface for workflow management and cloud integration
Author: RelayPlane
Latest version: 1.1.1

# @relayplane/cli

**Command-line interface for RelayPlane - AI model routing, cost estimation, and diagnostics.**

[![npm version](https://img.shields.io/npm/v/@relayplane/cli)](https://www.npmjs.com/package/@relayplane/cli)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Install

```bash
npm install -g @relayplane/cli
```

Or use npx:

```bash
npx @relayplane/cli <command>
```

## Commands

```bash
relay login       # Authenticate with RelayPlane Cloud (device OAuth)
relay logout      # Clear credentials and disconnect
relay status      # Show CLI status and cloud connection
relay workflows   # List all workflows in current project
relay sync        # Sync local workflows with RelayPlane Cloud
relay dashboard   # Open the cloud dashboard in browser
```

## Quick Start

### 1. Login to RelayPlane Cloud

```bash
relay login
```

This opens a browser for device authentication. Once authorized, your CLI is connected to RelayPlane Cloud.

### 2. Check status

```bash
relay status
```

Shows your connection status, authenticated user, and project info.

### 3. Sync workflows

```bash
relay sync
```

Discovers local workflow files and syncs them with the cloud for monitoring and analytics.

### 4. View dashboard

```bash
relay dashboard
```

Opens the RelayPlane dashboard in your browser to view runs, costs, and analytics.

## Configuration

The CLI stores configuration at `~/.relayplane/`:

- `config.json` - User preferences and settings
- `credentials.json` - Authentication tokens (keep private!)

## Environment Variables

| Variable | Description |
|----------|-------------|
| `RELAY_API_HOST` | API host (default: `https://api.relayplane.com`) |
| `RELAY_TELEMETRY` | Enable/disable telemetry (`true`/`false`) |

## Programmatic Usage

```typescript
import { getConfig, saveConfig } from '@relayplane/cli';

// Read current config
const config = await getConfig();
console.log(config.apiHost);

// Update config
await saveConfig({ ...config, telemetry: false });
```

## Related Packages

- **[@relayplane/proxy](https://github.com/RelayPlane/proxy)** - Intelligent AI model routing proxy
- **[@relayplane/sdk](https://www.npmjs.com/package/@relayplane/sdk)** - SDK for workflow execution

## Links

- **Website:** https://relayplane.com
- **Documentation:** https://relayplane.com/docs
- **GitHub:** https://github.com/RelayPlane/cli
- **npm:** https://www.npmjs.com/package/@relayplane/cli

## License

MIT
npm package: @relayplane/engine
Description: Local Workflow Engine - Pure, deterministic workflow executor
Author: RelayPlane
Latest version: 0.1.0

# @relayplane/engine

Local Workflow Engine - Pure, deterministic workflow executor for RelayPlane v3.

## Features

- **DAG Validation**: Detect cycles and validate dependencies
- **Step Execution**: Execute individual workflow steps with retry logic
- **Context Management**: Manage execution state and template interpolation
- **Workflow Runner**: Orchestrate multi-step workflows

## Architecture

- `src/types/` - TypeScript type definitions
- `src/validation/` - DAG validation and topological sort
- `src/execution/` - Context, executor, and runner
- `src/errors/` - Error classes and normalization

## Development

```bash
# Run tests
pnpm test

# Watch mode
pnpm test:watch

# Type checking
pnpm type-check

# Build
pnpm build
```

## Documentation

See `/docs/Engine Internals Specification.md` for detailed implementation specs.
npm package: @relayplane/mcp
Description: Model Context Protocol integration for RelayPlane workflows
Author: RelayPlane Team
Latest version: 0.1.0

# @relayplane/mcp

Model Context Protocol (MCP) integration for RelayPlane workflows.

## Features

- 🔌 Load MCP servers from URLs, configs, or directories
- 🛠️ Execute MCP tools with context interpolation
- 📊 Built-in telemetry and monitoring
- 🔄 Health checking for MCP servers
- 🎯 Type-safe with full TypeScript support

## Installation

```bash
pnpm add @relayplane/mcp
```

## Usage

```typescript
import { MCPLoader, MCPExecutor } from '@relayplane/mcp';

// Load MCP server
const loader = new MCPLoader();
const server = await loader.loadFromURL('https://api.example.com');

// Execute tool
const executor = new MCPExecutor();
const result = await executor.execute(
  server,
  'search',
  { query: '{{input.searchTerm}}' },
  context
);
```

## License

MIT
npm package: @relayplane/telemetry
Description: Telemetry queue and worker for workflow observability
Author: RelayPlane
Latest version: 0.1.0

# @relayplane/telemetry

Telemetry queue and worker for workflow observability.

## Features

- **Local Queue**: In-memory queue for workflow results
- **Background Worker**: Batches and flushes telemetry to cloud
- **Non-Blocking**: Telemetry failures never crash workflows
- **Configurable**: Batch size, flush interval, retry logic

## Usage

```typescript
import { relay } from '@relayplane/sdk';

relay.startTelemetry({
  apiKey: 'rp_...',
  endpoint: 'https://api.relayplane.com/v1/telemetry/logs',
  batchSize: 10,
  flushInterval: 5000,
  enabled: true
});
```

## Architecture

- `src/queue.ts` - Telemetry queue implementation
- `src/worker.ts` - Background worker with batching and retry
- `src/types.ts` - Telemetry data types

## Documentation

See `/docs/Telemetry Schema Specification.md` for schema details.