toon-package

@programsmagic/toon-frontend

React components for agent visualization with animated toon styling.

Installation

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

Quick Start

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

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

Components

AgentVisualizer

Main visualization component for agent events.

<AgentVisualizer
  url="http://localhost:3000/events"
  protocol="sse"
  autoConnect={true}
  showTimeline={true}
  showFlowDiagram={false}
/>

useAgentStream Hook

React hook for connecting to agent event streams.

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

function MyComponent() {
  const { events, isConnected, connect, disconnect } = useAgentStream({
    url: 'http://localhost:3000/events',
    protocol: 'sse',
  });

  return (
    <div>
      <button onClick={connect}>Connect</button>
      <button onClick={disconnect}>Disconnect</button>
      <div>Events: {events.length}</div>
    </div>
  );
}

EventTimeline

Component for displaying a timeline of events.

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

<EventTimeline events={events} maxEvents={100} />

ActionCard

Component for displaying individual action events.

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

<ActionCard event={event} index={0} />

FlowDiagram

Component for visualizing agent flows.

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

<FlowDiagram events={events} flows={flows} />

Styling

Import the default “toon” theme:

import '@programsmagic/toon-frontend/styles';

Or customize CSS variables:

:root {
  --toon-primary: #your-color;
  --toon-secondary: #your-color;
  /* ... */
}

Examples

See the examples directory for complete examples.

Documentation

See the full documentation.

License

MIT