toon-package

Toon Agent Bridge

Universal bridge for converting OpenAPI 3.0 and agents.json schemas into agent-ready workflows with SSE/WebSocket event streaming and React visualization components. Plus TOON format support for LLM token efficiency with rich viewer/converter UI.

NPM Version License Documentation

Features

Agent Bridge

TOON Format Support

Installation

Node.js/TypeScript

npm install @programsmagic/toon-core @programsmagic/toon-backend-node @programsmagic/toon-frontend
# or
pnpm add @programsmagic/toon-core @programsmagic/toon-backend-node @programsmagic/toon-frontend
# or
yarn add @programsmagic/toon-core @programsmagic/toon-backend-node @programsmagic/toon-frontend

Python

pip install toon-backend-python

Quick Start

1. Create a Server from OpenAPI Schema

import { createServer } from '@programsmagic/toon-backend-node';

const server = await createServer({
  port: 3000,
  schemaSource: './openapi.json',
  cors: true,
});

await server.start();

2. Use React Components for Visualization

import { AgentVisualizer } from '@programsmagic/toon-frontend';
import '@programsmagic/toon-frontend/styles';

function App() {
  return (
    <AgentVisualizer
      url="http://localhost:3000/events"
      protocol="sse"
      autoConnect={true}
    />
  );
}

3. Python Backend

from toon_backend import create_server, ServerOptions

options = ServerOptions(
    schema_source="./schema.json",
    port=8000,
    cors=True,
)

server = await create_server(options)
# Use with uvicorn or your ASGI server

Packages

Agent Bridge Packages

TOON Format Packages

Examples

Check out the examples directory for complete working examples:

Agent Bridge Examples

TOON Format Examples

Documentation

Agent Bridge

TOON Format

Full documentation: https://programsmagic.github.io/toon-package

Development

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run development mode
pnpm dev

# Run tests
pnpm test

# Lint code
pnpm lint

Contributing

Contributions are welcome! Please read our Contributing Guide for details.

License

MIT License - see LICENSE file for details.