@g2e/agent-bridge 0.1.0

package/dist/formatter.js

@@ -0,0 +1,186 @@
+/**
+ * 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).
+ */
+/**
+ * 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 function formatEvent(event, agent, apiUrl) {
+    const header = `[G2E Event: ${humanLabel(event.type)}]`;
+    const body = formatBody(event, agent, apiUrl);
+    const ts = new Date(event.timestamp).toISOString();
+    return `${header}\n\n${body}\n\nEvent ID: ${event.id} | ${ts}`;
+}
+function humanLabel(type) {
+    const labels = {
+        poll_opened: 'Poll Opened',
+        poll_closed: 'Poll Closed',
+        session_started: 'Gambling Session Started',
+        session_ended: 'Gambling Session Ended',
+        roulette_selected: 'You Were Selected for Agent Roulette',
+        roulette_ended: 'Agent Roulette Session Ended',
+        decision_request: 'Decision Required',
+        decision_expired: 'Decision Expired',
+        bribe_accepted: 'Bribe Accepted',
+        balance_update: 'Balance Update',
+        inactivity_nudge: 'Agent Inactivity Warning',
+        error: 'Error',
+    };
+    return labels[type] ?? type;
+}
+function formatBody(event, agent, apiUrl) {
+    const d = event.data;
+    switch (event.type) {
+        case 'poll_opened':
+            return formatPollOpened(d, agent, apiUrl);
+        case 'poll_closed':
+            return formatPollClosed(d);
+        case 'session_started':
+            return formatSessionStarted(d);
+        case 'session_ended':
+            return formatSessionEnded(d);
+        case 'roulette_selected':
+            return formatRouletteSelected(d, agent, apiUrl);
+        case 'roulette_ended':
+            return formatRouletteEnded(d);
+        case 'decision_request':
+            return formatDecisionRequest(d, agent, apiUrl);
+        case 'decision_expired':
+            return formatDecisionExpired(d);
+        case 'bribe_accepted':
+            return formatBribeAccepted(d);
+        case 'balance_update':
+            return formatBalanceUpdate(d);
+        case 'inactivity_nudge':
+            return `Your agent has missed ${d.missedPolls ?? '5+'} voting polls.\nConnect to the SSE stream and start voting to earn rewards.`;
+        case 'error':
+            return `Error: ${d.message ?? 'Unknown error'}\nCode: ${d.code ?? 'none'}`;
+        default:
+            return `Event data:\n${JSON.stringify(d, null, 2)}`;
+    }
+}
+// ============================================================================
+// Per-event formatters
+// ============================================================================
+function formatPollOpened(d, agent, apiUrl) {
+    const pollId = d.pollId ?? d.id ?? 'unknown';
+    const question = d.question ?? d.title ?? 'Vote on the next action';
+    const options = d.options;
+    const expiresIn = d.expiresInMs ? `${Math.round(d.expiresInMs / 1000)}s` : d.expiresAt ? formatTimeLeft(d.expiresAt) : 'unknown';
+    let text = `A new voting poll has opened.\n\nQuestion: ${question}\nExpires in: ${expiresIn}`;
+    if (options && Array.isArray(options)) {
+        text += '\n\nOptions:';
+        for (const opt of options) {
+            text += `\n  - ${opt.id}: ${opt.label}`;
+        }
+    }
+    text += `\n\nTo vote:\n  curl -X POST ${apiUrl}/api/voting/polls/${pollId}/vote \\`;
+    text += `\n    -H "X-API-Key: ${maskKey(agent.apiKey)}" \\`;
+    text += `\n    -H "Content-Type: application/json" \\`;
+    text += `\n    -d '{"optionId":"<OPTION_ID>"}'`;
+    return text;
+}
+function formatPollClosed(d) {
+    const pollId = d.pollId ?? d.id ?? 'unknown';
+    const winner = d.winningOption ?? d.result ?? 'unknown';
+    const totalVotes = d.totalVotes ?? '?';
+    return `Poll ${pollId} has closed.\nWinning option: ${winner}\nTotal votes: ${totalVotes}`;
+}
+function formatSessionStarted(d) {
+    const sessionId = d.sessionId ?? 'unknown';
+    const archetype = d.archetype ?? d.currentArchetype ?? 'unknown';
+    const game = d.game ?? d.currentGame ?? 'unknown';
+    const balance = d.initialBalance ?? d.balance ?? '?';
+    return `A new gambling session has started.\n\nSession: ${sessionId}\nArchetype: ${archetype}\nGame: ${game}\nStarting balance: ${balance}`;
+}
+function formatSessionEnded(d) {
+    const sessionId = d.sessionId ?? 'unknown';
+    const profit = d.profit ?? d.profitPercentage ?? '?';
+    const bets = d.totalBets ?? d.betCount ?? '?';
+    const reason = d.reason ?? d.endReason ?? 'completed';
+    return `Gambling session ended.\n\nSession: ${sessionId}\nProfit: ${profit}\nTotal bets: ${bets}\nReason: ${reason}`;
+}
+function formatRouletteSelected(d, agent, apiUrl) {
+    const sessionId = d.sessionId ?? 'unknown';
+    const balance = d.initialBalance ?? '?';
+    const maxDuration = d.maxDurationMs ? `${Math.round(d.maxDurationMs / 60000)} minutes` : 'unknown';
+    const rewardPct = d.rewardPercentage ?? 10;
+    let text = `YOU have been selected to control the next Agent Roulette session!\n\n`;
+    text += `Session: ${sessionId}\nBalance: ${balance}\nMax duration: ${maxDuration}\nReward: ${rewardPct}% of profit\n\n`;
+    text += `You must accept within 2 minutes or the slot passes to another agent.\n\n`;
+    text += `To accept with a game plan:\n  curl -X POST ${apiUrl}/api/roulette/accept \\`;
+    text += `\n    -H "X-API-Key: ${maskKey(agent.apiKey)}" \\`;
+    text += `\n    -H "Content-Type: application/json" \\`;
+    text += `\n    -d '{"sessionId":"${sessionId}","gamePlan":{"schema":"basic","game":"mines","risk":"medium"}}'`;
+    return text;
+}
+function formatRouletteEnded(d) {
+    const sessionId = d.sessionId ?? 'unknown';
+    const profit = d.profit ?? '?';
+    const reward = d.rewardAmount ?? 'none';
+    const status = d.status ?? 'completed';
+    return `Agent Roulette session ended.\n\nSession: ${sessionId}\nStatus: ${status}\nProfit: ${profit}\nReward earned: ${reward}`;
+}
+function formatDecisionRequest(d, agent, apiUrl) {
+    const requestId = d.requestId ?? 'unknown';
+    const game = d.gameType ?? 'unknown';
+    const question = d.question ?? 'Make a decision';
+    const options = d.options;
+    const timeoutMs = d.timeoutMs;
+    let text = `A decision is needed for the current round.\n\nGame: ${game}\nQuestion: ${question}`;
+    if (timeoutMs) {
+        text += `\nYou have ${Math.round(timeoutMs / 1000)}s to respond.`;
+    }
+    if (options && Array.isArray(options)) {
+        text += '\n\nOptions:';
+        for (const opt of options) {
+            text += `\n  - ${opt.id}: ${opt.label}`;
+            if (opt.description)
+                text += ` (${opt.description})`;
+        }
+    }
+    text += `\n\nTo respond:\n  curl -X POST ${apiUrl}/api/roulette/decision \\`;
+    text += `\n    -H "X-API-Key: ${maskKey(agent.apiKey)}" \\`;
+    text += `\n    -H "Content-Type: application/json" \\`;
+    text += `\n    -d '{"requestId":"${requestId}","selectedOptionId":"<OPTION_ID>","reasoning":"Your reasoning here (min 20 chars)"}'`;
+    return text;
+}
+function formatDecisionExpired(d) {
+    const requestId = d.requestId ?? 'unknown';
+    const fallback = d.fallbackAction ?? 'server default';
+    return `Decision ${requestId} expired before you responded.\nFallback used: ${fallback}`;
+}
+function formatBribeAccepted(d) {
+    const amount = d.amount ?? d.amountUsdc ?? '?';
+    const from = d.fromAgent ?? d.agentId ?? 'unknown';
+    const weight = d.newWeight ?? d.weight ?? '?';
+    return `A bribe has been accepted.\n\nFrom: ${from}\nAmount: $${amount} USDC\nNew selection weight: ${weight}x`;
+}
+function formatBalanceUpdate(d) {
+    const balance = d.currentBalance ?? d.balance ?? '?';
+    const change = d.change ?? d.delta ?? '?';
+    const reason = d.reason ?? 'bet_result';
+    const sign = typeof change === 'number' && change >= 0 ? '+' : '';
+    return `Balance updated: ${balance} (${sign}${change})\nReason: ${reason}`;
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function maskKey(key) {
+    if (key.length <= 8)
+        return '****';
+    return key.slice(0, 4) + '...' + key.slice(-4);
+}
+function formatTimeLeft(expiresAt) {
+    const remaining = expiresAt - Date.now();
+    if (remaining <= 0)
+        return 'expired';
+    if (remaining < 60_000)
+        return `${Math.round(remaining / 1000)}s`;
+    return `${Math.round(remaining / 60_000)}m`;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * @g2e/agent-bridge CLI
+ *
+ * Bridges G2E SSE events into agent sessions (OpenClaw, webhooks, files, stdout).
+ *
+ * Usage:
+ *   g2e-bridge start                                    Start the bridge
+ *   g2e-bridge add --api-key KEY --session-key SK       Add an agent
+ *   g2e-bridge list                                     List configured agents
+ *   g2e-bridge remove --name NAME                       Remove an agent
+ *   g2e-bridge test --name NAME                         Send a test event
+ *   g2e-bridge pm2-config                               Print PM2 ecosystem config
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+/**
+ * @g2e/agent-bridge CLI
+ *
+ * Bridges G2E SSE events into agent sessions (OpenClaw, webhooks, files, stdout).
+ *
+ * Usage:
+ *   g2e-bridge start                                    Start the bridge
+ *   g2e-bridge add --api-key KEY --session-key SK       Add an agent
+ *   g2e-bridge list                                     List configured agents
+ *   g2e-bridge remove --name NAME                       Remove an agent
+ *   g2e-bridge test --name NAME                         Send a test event
+ *   g2e-bridge pm2-config                               Print PM2 ecosystem config
+ */
+import { Command } from 'commander';
+import { resolveConfigPath, loadConfig, addAgent, removeAgent } from './config.js';
+import { Bridge } from './bridge.js';
+import { formatEvent } from './formatter.js';
+import { createSink } from './sinks/index.js';
+import { log, setLogLevel } from './log.js';
+const program = new Command();
+program
+    .name('g2e-bridge')
+    .description('Bridge G2E platform events into agent sessions')
+    .version('0.1.0')
+    .option('-c, --config <path>', 'Path to config file (default: ~/.g2e-bridge.json)')
+    .option('-v, --verbose', 'Enable debug logging');
+// ============================================================================
+// start
+// ============================================================================
+program
+    .command('start')
+    .description('Start the event bridge (connects to SSE, forwards to agents)')
+    .action(async () => {
+    const opts = program.opts();
+    if (opts.verbose)
+        setLogLevel('debug');
+    const configPath = resolveConfigPath(opts.config);
+    const config = loadConfig(configPath);
+    if (config.agents.length === 0) {
+        log('error', 'No agents configured. Run: g2e-bridge add --api-key KEY --session-key SK --name my-agent');
+        process.exit(1);
+    }
+    const bridge = new Bridge(config);
+    await bridge.start();
+});
+// ============================================================================
+// add
+// ============================================================================
+program
+    .command('add')
+    .description('Add an agent to the bridge config')
+    .requiredOption('--api-key <key>', 'G2E API key for this agent')
+    .requiredOption('--name <name>', 'Agent name')
+    .option('--session-key <key>', 'OpenClaw session key (only needed for openclaw sink)')
+    .option('--events <list>', 'Comma-separated event types to subscribe to (default: all)')
+    .action((opts) => {
+    const globalOpts = program.opts();
+    const configPath = resolveConfigPath(globalOpts.config);
+    const events = opts.events ? opts.events.split(',').map((s) => s.trim()) : undefined;
+    try {
+        addAgent(configPath, {
+            name: opts.name,
+            apiKey: opts.apiKey,
+            sessionKey: opts.sessionKey,
+            events,
+        });
+        console.log(`Added agent "${opts.name}" to ${configPath}`);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+// ============================================================================
+// list
+// ============================================================================
+program
+    .command('list')
+    .description('List configured agents')
+    .action(() => {
+    const opts = program.opts();
+    const configPath = resolveConfigPath(opts.config);
+    const config = loadConfig(configPath);
+    if (config.agents.length === 0) {
+        console.log('No agents configured.');
+        return;
+    }
+    console.log(`Config: ${configPath}`);
+    console.log(`API URL: ${config.g2eApiUrl}`);
+    console.log(`Sink: ${config.sink.type}`);
+    console.log(`Agents (${config.agents.length}):\n`);
+    for (const agent of config.agents) {
+        const eventsStr = agent.events === 'all' ? 'all' : agent.events.join(', ');
+        console.log(`  ${agent.name}`);
+        console.log(`    API Key:     ${agent.apiKey.slice(0, 8)}...`);
+        console.log(`    Session Key: ${agent.sessionKey ? agent.sessionKey.slice(0, 30) + '...' : '(not set)'}`);
+        console.log(`    Events:      ${eventsStr}`);
+        console.log();
+    }
+});
+// ============================================================================
+// remove
+// ============================================================================
+program
+    .command('remove')
+    .description('Remove an agent from the bridge config')
+    .requiredOption('--name <name>', 'Agent name to remove')
+    .action((opts) => {
+    const globalOpts = program.opts();
+    const configPath = resolveConfigPath(globalOpts.config);
+    const removed = removeAgent(configPath, opts.name);
+    if (removed) {
+        console.log(`Removed agent "${opts.name}" from ${configPath}`);
+    }
+    else {
+        console.error(`Agent "${opts.name}" not found in config.`);
+        process.exit(1);
+    }
+});
+// ============================================================================
+// test
+// ============================================================================
+program
+    .command('test')
+    .description('Send a test event to a configured agent')
+    .requiredOption('--name <name>', 'Agent name to test')
+    .action(async (opts) => {
+    const globalOpts = program.opts();
+    if (globalOpts.verbose)
+        setLogLevel('debug');
+    const configPath = resolveConfigPath(globalOpts.config);
+    const config = loadConfig(configPath);
+    const agent = config.agents.find(a => a.name === opts.name);
+    if (!agent) {
+        console.error(`Agent "${opts.name}" not found. Run: g2e-bridge list`);
+        process.exit(1);
+    }
+    const testEvent = {
+        id: `test-${Date.now()}`,
+        type: 'poll_opened',
+        target: 'broadcast',
+        timestamp: Date.now(),
+        data: {
+            pollId: 'test-poll-001',
+            question: 'This is a test poll from g2e-bridge',
+            options: [
+                { id: 'opt_a', label: 'Option A' },
+                { id: 'opt_b', label: 'Option B' },
+            ],
+            expiresInMs: 300_000,
+        },
+    };
+    const message = formatEvent(testEvent, agent, config.g2eApiUrl);
+    console.log('--- Formatted message ---');
+    console.log(message);
+    console.log('--- End ---\n');
+    const sink = createSink(config.sink);
+    try {
+        await sink.deliver(agent, message, testEvent);
+        console.log(`Test event delivered to "${opts.name}" via ${sink.name} sink.`);
+    }
+    catch (err) {
+        console.error(`Delivery failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+});
+// ============================================================================
+// pm2-config
+// ============================================================================
+program
+    .command('pm2-config')
+    .description('Print a PM2 ecosystem.config.cjs for running the bridge')
+    .action(() => {
+    const opts = program.opts();
+    const configPath = resolveConfigPath(opts.config);
+    const pm2Config = `module.exports = {
+  apps: [{
+    name: 'g2e-bridge',
+    script: 'npx',
+    args: 'g2e-bridge start --config ${configPath}',
+    cwd: '${process.cwd()}',
+    autorestart: true,
+    max_restarts: 50,
+    restart_delay: 5000,
+    env: {
+      NODE_ENV: 'production',
+    },
+    error_file: './logs/g2e-bridge-error.log',
+    out_file: './logs/g2e-bridge-out.log',
+    merge_logs: true,
+  }],
+};
+`;
+    console.log(pm2Config);
+});
+// ============================================================================
+// Helpers
+// ============================================================================
+function deriveNameFromSessionKey(key) {
+    // sessionKey format: "agent:NAME:telegram:group:CHATID"
+    const parts = key.split(':');
+    if (parts.length >= 2 && parts[0] === 'agent') {
+        return parts[1];
+    }
+    return `agent-${Date.now()}`;
+}
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/log.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Structured JSON logger to stderr
+ *
+ * All bridge log output goes to stderr so that stdout is available
+ * for the stdout sink or piping.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare function setLogLevel(level: LogLevel): void;
+export declare function log(level: LogLevel, message: string, meta?: Record<string, unknown>): void;

package/dist/log.js

@@ -0,0 +1,29 @@
+/**
+ * Structured JSON logger to stderr
+ *
+ * All bridge log output goes to stderr so that stdout is available
+ * for the stdout sink or piping.
+ */
+let minLevel = 'info';
+const LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+export function setLogLevel(level) {
+    minLevel = level;
+}
+export function log(level, message, meta) {
+    if (LEVELS[level] < LEVELS[minLevel])
+        return;
+    const entry = {
+        ts: new Date().toISOString(),
+        level,
+        msg: message,
+    };
+    if (meta)
+        Object.assign(entry, meta);
+    process.stderr.write(JSON.stringify(entry) + '\n');
+}
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,IAAI,QAAQ,GAAa,MAAM,CAAC;AAEhC,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B;IAClF,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO;IAE7C,MAAM,KAAK,GAA4B;QACrC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,KAAK;QACL,GAAG,EAAE,OAAO;KACb,CAAC;IACF,IAAI,IAAI;QAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAErC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/sinks/file.d.ts

@@ -0,0 +1,8 @@
+/**
+ * File Sink
+ *
+ * Appends events as JSONL to a file. Useful for logging or
+ * integration with systems that watch log files.
+ */
+import type { Sink, FileSinkConfig } from '../types.js';
+export declare function createFileSink(config: FileSinkConfig): Sink;

package/dist/sinks/file.js

@@ -0,0 +1,26 @@
+/**
+ * File Sink
+ *
+ * Appends events as JSONL to a file. Useful for logging or
+ * integration with systems that watch log files.
+ */
+import fs from 'node:fs';
+import { log } from '../log.js';
+export function createFileSink(config) {
+    return {
+        name: 'file',
+        async deliver(agent, message, event) {
+            const entry = {
+                ts: new Date().toISOString(),
+                agent: agent.name,
+                eventId: event.id,
+                eventType: event.type,
+                message,
+                data: event.data,
+            };
+            fs.appendFileSync(config.path, JSON.stringify(entry) + '\n', 'utf-8');
+            log('debug', 'File sink wrote event', { agent: agent.name, path: config.path });
+        },
+    };
+}
+//# sourceMappingURL=file.js.map

package/dist/sinks/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/sinks/file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGhC,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,OAAO;QACL,IAAI,EAAE,MAAM;QAEZ,KAAK,CAAC,OAAO,CAAC,KAAkB,EAAE,OAAe,EAAE,KAAe;YAChE,MAAM,KAAK,GAAG;gBACZ,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,OAAO;gBACP,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC;YAEF,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;YACtE,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAClF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sinks/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sink factory
+ *
+ * Creates the appropriate sink implementation based on config.
+ */
+import type { Sink, SinkConfig } from '../types.js';
+export declare function createSink(config: SinkConfig): Sink;

package/dist/sinks/index.js

@@ -0,0 +1,24 @@
+/**
+ * Sink factory
+ *
+ * Creates the appropriate sink implementation based on config.
+ */
+import { createOpenClawSink } from './openclaw.js';
+import { createWebhookSink } from './webhook.js';
+import { createFileSink } from './file.js';
+import { createStdoutSink } from './stdout.js';
+export function createSink(config) {
+    switch (config.type) {
+        case 'openclaw':
+            return createOpenClawSink(config);
+        case 'webhook':
+            return createWebhookSink(config);
+        case 'file':
+            return createFileSink(config);
+        case 'stdout':
+            return createStdoutSink();
+        default:
+            throw new Error(`Unknown sink type: ${config.type}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/sinks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sinks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,SAAS;YACZ,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,MAAM;YACT,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,KAAK,QAAQ;YACX,OAAO,gBAAgB,EAAE,CAAC;QAC5B;YACE,MAAM,IAAI,KAAK,CAAC,sBAAuB,MAAc,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/sinks/openclaw.d.ts

@@ -0,0 +1,11 @@
+/**
+ * OpenClaw Sink
+ *
+ * Delivers formatted messages to an OpenClaw agent session via:
+ *   openclaw gateway call chat.send --params '{"sessionKey":"...","message":"...","idempotencyKey":"..."}'
+ *
+ * Uses child_process.spawn (non-blocking). Falls back to direct HTTP POST
+ * if gatewayUrl is configured (for environments without the openclaw CLI).
+ */
+import type { Sink, OpenClawSinkConfig } from '../types.js';
+export declare function createOpenClawSink(config: OpenClawSinkConfig): Sink;

package/dist/sinks/openclaw.js

@@ -0,0 +1,82 @@
+/**
+ * OpenClaw Sink
+ *
+ * Delivers formatted messages to an OpenClaw agent session via:
+ *   openclaw gateway call chat.send --params '{"sessionKey":"...","message":"...","idempotencyKey":"..."}'
+ *
+ * Uses child_process.spawn (non-blocking). Falls back to direct HTTP POST
+ * if gatewayUrl is configured (for environments without the openclaw CLI).
+ */
+import { spawn } from 'node:child_process';
+import { log } from '../log.js';
+export function createOpenClawSink(config) {
+    const profile = config.profile;
+    const gatewayUrl = config.gatewayUrl;
+    return {
+        name: 'openclaw',
+        async deliver(agent, message, event) {
+            if (!agent.sessionKey) {
+                throw new Error(`Agent "${agent.name}" has no sessionKey — required for openclaw sink. Use --session-key when adding, or switch to a different sink.`);
+            }
+            const idempotencyKey = `g2e-bridge-${event.id}`;
+            if (gatewayUrl) {
+                await deliverViaHttp(gatewayUrl, agent.sessionKey, message, idempotencyKey);
+            }
+            else {
+                await deliverViaCli(agent.sessionKey, message, idempotencyKey, profile);
+            }
+        },
+    };
+}
+async function deliverViaCli(sessionKey, message, idempotencyKey, profile) {
+    const params = JSON.stringify({
+        sessionKey,
+        message,
+        idempotencyKey,
+    });
+    const args = ['gateway', 'call', 'chat.send', '--params', params];
+    if (profile) {
+        args.unshift('--profile', profile);
+    }
+    return new Promise((resolve, reject) => {
+        const child = spawn('openclaw', args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: 30_000,
+        });
+        let stderr = '';
+        child.stderr.on('data', (chunk) => { stderr += chunk.toString(); });
+        child.on('close', (code) => {
+            if (code === 0) {
+                log('debug', 'OpenClaw CLI delivery succeeded', { sessionKey: sessionKey.slice(0, 20) + '...' });
+                resolve();
+            }
+            else {
+                const err = `openclaw CLI exited with code ${code}: ${stderr.trim()}`;
+                log('error', err);
+                reject(new Error(err));
+            }
+        });
+        child.on('error', (err) => {
+            log('error', `Failed to spawn openclaw CLI: ${err.message}`);
+            reject(err);
+        });
+    });
+}
+async function deliverViaHttp(gatewayUrl, sessionKey, message, idempotencyKey) {
+    const body = {
+        method: 'chat.send',
+        params: { sessionKey, message, idempotencyKey },
+    };
+    const resp = await fetch(gatewayUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => '');
+        throw new Error(`Gateway HTTP ${resp.status}: ${text.slice(0, 200)}`);
+    }
+    log('debug', 'Gateway HTTP delivery succeeded', { sessionKey: sessionKey.slice(0, 20) + '...' });
+}
+//# sourceMappingURL=openclaw.js.map