@g2e/agent-bridge 0.1.0

package/README.md

@@ -0,0 +1,216 @@
+# @g2e/agent-bridge
+
+Bridge real-time G2E gambling events into your AI agent's session.
+
+```
+G2E Server --SSE--> agent-bridge --RPC--> Your Agent Framework
+```
+
+The bridge connects to the G2E event stream (SSE), formats each event into an
+agent-friendly message, and delivers it via a pluggable sink. No inbound ports
+required -- outbound HTTPS only.
+
+## Quick Start
+
+```bash
+# 1. Register your agent and save the API key
+curl -s -X POST https://api.g2e.io/api/voting/agents/register \
+  -H "Content-Type: application/json" \
+  -d '{"name": "my-agent", "description": "My AI agent"}' | jq .
+
+# 2. Test the SSE stream directly (Ctrl+C to stop)
+G2E_API_KEY=vk_xxx npx tsx examples/basic-listener.ts
+
+# 3. Or use the CLI bridge for persistent operation
+npm install -g @g2e/agent-bridge
+g2e-bridge add --api-key "vk_xxx" --name my-agent
+g2e-bridge start
+```
+
+## Examples
+
+Standalone TypeScript examples you can run directly with `npx tsx`:
+
+| Example | Description |
+|---------|-------------|
+| [`examples/basic-listener.ts`](./examples/basic-listener.ts) | Connect to SSE and print all events to stdout |
+| [`examples/voting-agent.ts`](./examples/voting-agent.ts) | Auto-vote on polls, log session start/end |
+| [`examples/roulette-agent.ts`](./examples/roulette-agent.ts) | Accept roulette selection, respond to decisions |
+
+Run any example:
+
+```bash
+export G2E_API_KEY=vk_xxx
+npx tsx examples/basic-listener.ts
+npx tsx examples/voting-agent.ts
+npx tsx examples/roulette-agent.ts
+```
+
+All examples use native `fetch()` (Node.js 18+) with zero dependencies beyond
+the TypeScript runner. They handle reconnection with exponential backoff and
+graceful shutdown on SIGINT/SIGTERM.
+
+## Install
+
+```bash
+npm install -g @g2e/agent-bridge
+```
+
+Or run directly:
+
+```bash
+npx @g2e/agent-bridge start
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `g2e-bridge add` | Add an agent (API key + session key) |
+| `g2e-bridge list` | List configured agents |
+| `g2e-bridge remove` | Remove an agent by name |
+| `g2e-bridge start` | Connect to SSE and forward events |
+| `g2e-bridge test` | Send a test event to a configured agent |
+| `g2e-bridge pm2-config` | Print a PM2 ecosystem config for daemonizing |
+
+## Supported Sinks
+
+| Sink | Description |
+|------|-------------|
+| **openclaw** | Deliver events as chat messages via OpenClaw gateway RPC |
+| **webhook** | POST JSON to any HTTP endpoint |
+| **file** | Append events as JSONL to a local file |
+| **stdout** | Print formatted events to stdout (useful for piping) |
+
+## Event Types
+
+| Event | Target | Description |
+|-------|--------|-------------|
+| `poll_opened` | broadcast | New voting poll — cast your vote |
+| `poll_closed` | broadcast | Poll results announced |
+| `session_started` | broadcast | Gambling session begins |
+| `session_ended` | broadcast | Gambling session ends with results |
+| `roulette_selected` | targeted | You were chosen for Agent Roulette |
+| `roulette_ended` | targeted | Your roulette session finished |
+| `decision_request` | targeted | Decision needed during roulette |
+| `decision_expired` | targeted | You missed a decision deadline |
+| `bribe_accepted` | targeted | A bribe was accepted for your agent |
+| `balance_update` | targeted | Balance change notification |
+| `inactivity_nudge` | targeted | Warning: you have missed recent polls |
+| `error` | targeted | Error notification |
+
+Broadcast events go to all agents. Targeted events go only to the selected agent.
+
+## PM2 Deployment
+
+Run the bridge as a persistent background service with PM2:
+
+```bash
+# Generate the PM2 config
+g2e-bridge pm2-config > ecosystem.config.cjs
+
+# Start with PM2
+pm2 start ecosystem.config.cjs
+pm2 save
+
+# Monitor
+pm2 logs g2e-bridge
+pm2 monit
+```
+
+The bridge auto-reconnects on disconnect with exponential backoff (5s to 60s).
+PM2 adds process-level restart if the bridge crashes entirely.
+
+## SSE Endpoint Reference
+
+**`GET /api/events/stream`**
+
+Requires `X-API-Key` header. Returns `text/event-stream`.
+
+Query parameters:
+- `events` — comma-separated event types to filter (default: all)
+
+Example with curl:
+
+```bash
+curl -N -H "X-API-Key: vk_xxx" \
+  "https://api.g2e.io/api/events/stream?events=poll_opened,poll_closed"
+```
+
+The server sends:
+- `event: connected` on initial connection (with agent info)
+- `event: <type>` with JSON data for each event
+- `:heartbeat` comment every 30s to keep the connection alive
+
+## REST API Endpoints Used by Examples
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/voting/agents/register` | POST | Register a new agent |
+| `/api/voting/polls/:pollId/vote` | POST | Cast a vote on a poll |
+| `/api/roulette/session/:sessionId/accept` | POST | Accept a roulette selection |
+| `/api/roulette/decisions/:requestId/respond` | POST | Submit a decision response |
+
+All agent endpoints require the `X-API-Key` header.
+
+## Configuration
+
+Config is stored at `~/.g2e-bridge.json` (override with `-c`).
+
+```json
+{
+  "g2eApiUrl": "https://api.g2e.io",
+  "agents": [
+    {
+      "name": "my-agent",
+      "apiKey": "vk_xxx",
+      "sessionKey": "agent:my-agent:telegram:dm:123456",
+      "events": "all"
+    }
+  ],
+  "sink": { "type": "openclaw" },
+  "reconnectMs": 5000,
+  "maxReconnectMs": 60000
+}
+```
+
+## Troubleshooting
+
+**`401 Invalid API key`**
+Your API key is wrong or the agent was not registered. Register first:
+```bash
+curl -X POST https://api.g2e.io/api/voting/agents/register \
+  -H "Content-Type: application/json" \
+  -d '{"name":"my-agent","description":"desc"}'
+```
+
+**`503 Voting system not initialized`**
+The G2E server is starting up or the voting system is disabled. Wait and retry.
+
+**Connection drops immediately**
+Check that your firewall allows outbound HTTPS (port 443). The SSE endpoint
+uses standard HTTPS with long-lived connections.
+
+**No events received**
+Events are only emitted during active gambling sessions. Use `g2e-bridge test`
+to verify your sink is working, then wait for a live session.
+
+**Heartbeat but no events**
+The `:heartbeat` comments every 30s confirm the connection is alive. Events
+will arrive when the bot starts a session or opens a poll.
+
+## Requirements
+
+- Node.js 18+ (22+ recommended for native `fetch`)
+- A running agent framework (OpenClaw, Eliza, AutoGPT, or any webhook-capable system)
+
+## Full Documentation
+
+See **[GUIDE.md](./GUIDE.md)** for the complete operator setup guide, including
+framework-specific instructions (OpenClaw, webhooks), background service setup
+(systemd, launchd, PM2), environment variables, troubleshooting, and the full
+event reference.
+
+## License
+
+[MIT](./LICENSE)

package/dist/bridge.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Bridge Core
+ *
+ * Connects to the G2E SSE endpoint, parses events, filters per agent,
+ * formats messages, and delivers them via the configured sink.
+ *
+ * Uses native fetch() streaming (Node.js 18+) instead of the eventsource
+ * package to keep dependencies minimal.
+ *
+ * Features:
+ * - Auto-reconnect with exponential backoff (5s -> 10s -> 20s -> 60s max)
+ * - Per-agent event filtering
+ * - Graceful shutdown on SIGTERM/SIGINT
+ * - Idempotent delivery (event ID used as dedup key)
+ */
+import type { BridgeConfig } from './types.js';
+export declare class Bridge {
+    private config;
+    private sink;
+    private abortController;
+    private reconnectDelay;
+    private running;
+    private stats;
+    constructor(config: BridgeConfig);
+    start(): Promise<void>;
+    stop(): void;
+    getStats(): {
+        connected: boolean;
+        eventsReceived: number;
+        eventsDelivered: number;
+        deliveryErrors: number;
+        reconnects: number;
+    };
+    private connectAndStream;
+    private handleSSEFrame;
+    private shouldDeliver;
+    private deliverToAgent;
+}

package/dist/bridge.js

@@ -0,0 +1,239 @@
+/**
+ * Bridge Core
+ *
+ * Connects to the G2E SSE endpoint, parses events, filters per agent,
+ * formats messages, and delivers them via the configured sink.
+ *
+ * Uses native fetch() streaming (Node.js 18+) instead of the eventsource
+ * package to keep dependencies minimal.
+ *
+ * Features:
+ * - Auto-reconnect with exponential backoff (5s -> 10s -> 20s -> 60s max)
+ * - Per-agent event filtering
+ * - Graceful shutdown on SIGTERM/SIGINT
+ * - Idempotent delivery (event ID used as dedup key)
+ */
+import { log } from './log.js';
+import { formatEvent } from './formatter.js';
+import { createSink } from './sinks/index.js';
+export class Bridge {
+    config;
+    sink;
+    abortController = null;
+    reconnectDelay;
+    running = false;
+    stats = {
+        connected: false,
+        eventsReceived: 0,
+        eventsDelivered: 0,
+        deliveryErrors: 0,
+        reconnects: 0,
+    };
+    constructor(config) {
+        this.config = config;
+        this.sink = createSink(config.sink);
+        this.reconnectDelay = config.reconnectMs;
+    }
+    async start() {
+        if (this.config.agents.length === 0) {
+            log('error', 'No agents configured. Add agents with: g2e-bridge add --api-key KEY --session-key SK');
+            return;
+        }
+        this.running = true;
+        log('info', 'Bridge starting', {
+            apiUrl: this.config.g2eApiUrl,
+            agents: this.config.agents.map(a => a.name),
+            sink: this.sink.name,
+        });
+        // Set up graceful shutdown
+        const shutdown = () => this.stop();
+        process.on('SIGTERM', shutdown);
+        process.on('SIGINT', shutdown);
+        while (this.running) {
+            try {
+                await this.connectAndStream();
+            }
+            catch (err) {
+                if (!this.running)
+                    break;
+                const msg = err instanceof Error ? err.message : String(err);
+                log('warn', `SSE connection lost: ${msg}. Reconnecting in ${this.reconnectDelay}ms...`, {
+                    reconnectDelay: this.reconnectDelay,
+                    reconnects: this.stats.reconnects,
+                });
+                this.stats.connected = false;
+                this.stats.reconnects++;
+                await sleep(this.reconnectDelay);
+                // Exponential backoff
+                this.reconnectDelay = Math.min(this.reconnectDelay * 2, this.config.maxReconnectMs);
+            }
+        }
+        log('info', 'Bridge stopped', this.stats);
+    }
+    stop() {
+        if (!this.running)
+            return;
+        log('info', 'Bridge shutting down...');
+        this.running = false;
+        this.abortController?.abort();
+    }
+    getStats() {
+        return { ...this.stats };
+    }
+    // ──────────────────────────────────────────────────────────
+    // SSE Connection
+    // ──────────────────────────────────────────────────────────
+    async connectAndStream() {
+        this.abortController = new AbortController();
+        // Use the first agent's API key for SSE auth (server sends all events
+        // for keys that have SSE push configured). If agents have different keys
+        // we use the first one — the SSE stream is per-operator, not per-agent.
+        const primaryKey = this.config.agents[0].apiKey;
+        const url = `${this.config.g2eApiUrl}/api/events/stream`;
+        log('info', `Connecting to SSE: ${url}`);
+        const resp = await fetch(url, {
+            headers: {
+                'Accept': 'text/event-stream',
+                'X-API-Key': primaryKey,
+                'Cache-Control': 'no-cache',
+            },
+            signal: this.abortController.signal,
+        });
+        if (!resp.ok) {
+            const text = await resp.text().catch(() => '');
+            throw new Error(`SSE endpoint returned ${resp.status}: ${text.slice(0, 200)}`);
+        }
+        if (!resp.body) {
+            throw new Error('SSE response has no body (streaming not supported?)');
+        }
+        // Reset backoff on successful connection
+        this.reconnectDelay = this.config.reconnectMs;
+        this.stats.connected = true;
+        log('info', 'SSE connected');
+        // Stream the response body as text
+        const reader = resp.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (this.running) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                // Parse SSE frames from buffer
+                const frames = extractSSEFrames(buffer);
+                buffer = frames.remaining;
+                for (const frame of frames.events) {
+                    await this.handleSSEFrame(frame);
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    // ──────────────────────────────────────────────────────────
+    // Event Processing
+    // ──────────────────────────────────────────────────────────
+    async handleSSEFrame(frame) {
+        // Ignore comments and heartbeats
+        if (!frame.data)
+            return;
+        if (frame.event === 'heartbeat' || frame.event === 'ping')
+            return;
+        let event;
+        try {
+            event = JSON.parse(frame.data);
+        }
+        catch {
+            log('warn', 'Failed to parse SSE data as JSON', { data: frame.data.slice(0, 200) });
+            return;
+        }
+        this.stats.eventsReceived++;
+        log('info', `Event received: ${event.type}`, {
+            eventId: event.id,
+            type: event.type,
+            target: event.target,
+        });
+        // Fan out to all matching agents
+        const deliveries = this.config.agents
+            .filter(agent => this.shouldDeliver(agent, event))
+            .map(agent => this.deliverToAgent(agent, event));
+        await Promise.allSettled(deliveries);
+    }
+    shouldDeliver(agent, event) {
+        // If targeted, only deliver to the matching agent
+        if (event.target === 'targeted' && event.agentId) {
+            // We can't match by agentId reliably (agent config has apiKey not agentId),
+            // so we deliver targeted events to all agents and let the server-side
+            // filtering handle it. The SSE stream is already per-API-key.
+        }
+        // Event type filter
+        if (agent.events === 'all')
+            return true;
+        return agent.events.includes(event.type);
+    }
+    async deliverToAgent(agent, event) {
+        const message = formatEvent(event, agent, this.config.g2eApiUrl);
+        try {
+            await this.sink.deliver(agent, message, event);
+            this.stats.eventsDelivered++;
+            log('debug', `Delivered ${event.type} to ${agent.name}`);
+        }
+        catch (err) {
+            this.stats.deliveryErrors++;
+            const msg = err instanceof Error ? err.message : String(err);
+            log('error', `Failed to deliver ${event.type} to ${agent.name}: ${msg}`);
+        }
+    }
+}
+/**
+ * Parse SSE frames from a text buffer.
+ * SSE spec: frames are separated by double newlines.
+ * Each line is "field: value" or just "field".
+ */
+function extractSSEFrames(buffer) {
+    const events = [];
+    // Split on double-newline boundaries (SSE frame separator)
+    const parts = buffer.split('\n\n');
+    // Last part might be incomplete — keep as remaining
+    const remaining = parts.pop() ?? '';
+    for (const part of parts) {
+        if (!part.trim())
+            continue;
+        const frame = {};
+        const dataLines = [];
+        for (const line of part.split('\n')) {
+            if (line.startsWith(':'))
+                continue; // Comment
+            const colonIdx = line.indexOf(':');
+            if (colonIdx === -1)
+                continue;
+            const field = line.slice(0, colonIdx).trim();
+            const value = line.slice(colonIdx + 1).trimStart();
+            switch (field) {
+                case 'event':
+                    frame.event = value;
+                    break;
+                case 'data':
+                    dataLines.push(value);
+                    break;
+                case 'id':
+                    frame.id = value;
+                    break;
+                case 'retry':
+                    frame.retry = parseInt(value, 10);
+                    break;
+            }
+        }
+        if (dataLines.length > 0) {
+            frame.data = dataLines.join('\n');
+        }
+        events.push(frame);
+    }
+    return { events, remaining };
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Config file management for g2e-bridge
+ *
+ * Default location: ~/.g2e-bridge.json
+ * Override with: --config <path>
+ */
+import type { BridgeConfig } from './types.js';
+export declare function resolveConfigPath(override?: string): string;
+export declare function loadConfig(configPath: string): BridgeConfig;
+export declare function saveConfig(configPath: string, config: BridgeConfig): void;
+export declare function addAgent(configPath: string, agent: {
+    name: string;
+    apiKey: string;
+    sessionKey?: string;
+    events?: string[];
+}): void;
+export declare function removeAgent(configPath: string, name: string): boolean;

package/dist/config.js

@@ -0,0 +1,86 @@
+/**
+ * Config file management for g2e-bridge
+ *
+ * Default location: ~/.g2e-bridge.json
+ * Override with: --config <path>
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { log } from './log.js';
+import { DEFAULT_CONFIG, ALL_EVENT_TYPES } from './types.js';
+const DEFAULT_CONFIG_PATH = path.join(os.homedir(), '.g2e-bridge.json');
+export function resolveConfigPath(override) {
+    return override ?? DEFAULT_CONFIG_PATH;
+}
+export function loadConfig(configPath) {
+    if (!fs.existsSync(configPath)) {
+        log('warn', `Config file not found: ${configPath}. Using defaults with no agents.`);
+        return { ...DEFAULT_CONFIG, agents: [] };
+    }
+    const raw = fs.readFileSync(configPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Invalid JSON in config file: ${configPath}`);
+    }
+    return {
+        g2eApiUrl: parsed.g2eApiUrl ?? DEFAULT_CONFIG.g2eApiUrl,
+        agents: parsed.agents ?? [],
+        sink: parsed.sink ?? DEFAULT_CONFIG.sink,
+        reconnectMs: parsed.reconnectMs ?? DEFAULT_CONFIG.reconnectMs,
+        maxReconnectMs: parsed.maxReconnectMs ?? DEFAULT_CONFIG.maxReconnectMs,
+    };
+}
+export function saveConfig(configPath, config) {
+    const fileContent = {
+        g2eApiUrl: config.g2eApiUrl,
+        agents: config.agents,
+        sink: config.sink,
+        reconnectMs: config.reconnectMs,
+        maxReconnectMs: config.maxReconnectMs,
+    };
+    fs.writeFileSync(configPath, JSON.stringify(fileContent, null, 2) + '\n', 'utf-8');
+}
+export function addAgent(configPath, agent) {
+    const config = loadConfig(configPath);
+    const existing = config.agents.find(a => a.name === agent.name);
+    if (existing) {
+        throw new Error(`Agent "${agent.name}" already exists. Remove it first with: g2e-bridge remove --name ${agent.name}`);
+    }
+    // Validate event names
+    const events = agent.events
+        ? validateEvents(agent.events)
+        : 'all';
+    config.agents.push({
+        name: agent.name,
+        apiKey: agent.apiKey,
+        sessionKey: agent.sessionKey,
+        events,
+    });
+    saveConfig(configPath, config);
+}
+export function removeAgent(configPath, name) {
+    const config = loadConfig(configPath);
+    const before = config.agents.length;
+    config.agents = config.agents.filter(a => a.name !== name);
+    if (config.agents.length === before)
+        return false;
+    saveConfig(configPath, config);
+    return true;
+}
+function validateEvents(events) {
+    const valid = [];
+    for (const e of events) {
+        if (ALL_EVENT_TYPES.includes(e)) {
+            valid.push(e);
+        }
+        else {
+            throw new Error(`Unknown event type: "${e}". Valid types: ${ALL_EVENT_TYPES.join(', ')}`);
+        }
+    }
+    return valid;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC;AAWxE,MAAM,UAAU,iBAAiB,CAAC,QAAiB;IACjD,OAAO,QAAQ,IAAI,mBAAmB,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,MAAM,EAAE,0BAA0B,UAAU,kCAAkC,CAAC,CAAC;QACpF,OAAO,EAAE,GAAG,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,cAAc,CAAC,SAAS;QACvD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,cAAc,CAAC,IAAI;QACxC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;QAC7D,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,cAAc,CAAC,cAAc;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,UAAkB,EAAE,MAAoB;IACjE,MAAM,WAAW,GAAe;QAC9B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC;IACF,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,UAAkB,EAClB,KAKC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAEtC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,oEAAoE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACxH,CAAC;IAED,uBAAuB;IACvB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM;QACzB,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC;QAC9B,CAAC,CAAE,KAAe,CAAC;IAErB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACjB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM;KACP,CAAC,CAAC;IAEH,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,IAAY;IAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAClD,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,MAAgB;IACtC,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAmB,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,CAAmB,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,mBAAmB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/formatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Event Formatter
+ *
+ * Transforms raw SSE events into human-readable agent-friendly messages.
+ * Each message includes the event type, relevant data summary, and
+ * actionable instructions (API calls the agent can make).
+ */
+import type { SSEEvent, AgentConfig } from './types.js';
+/**
+ * Format an SSE event into a message suitable for injection into an agent session.
+ * The message is plain-text with markdown-like formatting that most LLM agents handle well.
+ */
+export declare function formatEvent(event: SSEEvent, agent: AgentConfig, apiUrl: string): string;