fluxprotocol-sdk

fluxprotocol-sdk

Universal AI Connectivity - Build connectors in 4 lines. 40% fewer tokens with TOON.

Install

npm install fluxprotocol-sdk

Quick Start

import { connector, method, FluxServer, StdioTransport } from 'fluxprotocol-sdk';

@connector('weather')
class WeatherConnector {
  @method()
  async getWeather(city: string) {
    return { city, temp: 22, desc: 'Sunny' };
  }
}

const server = new FluxServer(WeatherConnector);
server.setTransport(new StdioTransport(server));
server.start();

Transports

import { StdioTransport, HttpTransport, WebSocketTransport } from 'fluxprotocol-sdk';

new StdioTransport(server);                     // MCP (Claude Desktop)
new HttpTransport(server, { port: 3000 });      // REST API + TOON
new WebSocketTransport(server, { port: 3001 }); // Real-time

Decorators

import { cache, rateLimit, retry, config } from 'fluxprotocol-sdk';

@method()
@cache({ ttl: 60000, maxSize: 100 })          // LRU cache with 1min TTL
@rateLimit({ requests: 100, window: '1m' })   // 100 requests per minute
@retry({ attempts: 3, backoff: 'exponential' }) // Auto-retry with backoff
async myMethod() { ... }

TOON Format Support

HTTP transport supports TOON format for 40% token reduction:

• Accept: application/toon → TOON response
• Accept: application/json → JSON response (default)

Related Packages

• fluxprotocol-cli - CLI tools
• fluxprotocol-client - HTTP/WebSocket client

License

MIT