flow-agent-bridge 0.2.0

package/dist/config.d.ts

@@ -0,0 +1,45 @@
+/** "~" / "~/x" → the user's home (shells don't expand ~ inside JSON configs or wizard answers). */
+export declare function expandHome(p: string): string;
+export type ProgressMode = 'thinking' | 'typing' | 'silent';
+export type EventScope = 'mentions' | 'all';
+export type RuntimeKind = 'claude' | 'codex' | 'demo';
+export interface RuntimeConfig {
+    /**
+     * 'claude' (rich: sessions, stream-json thinking steps, MCP),
+     * 'codex' (stub: baseline stdout contract), or
+     * 'demo' (no CLI at all — always replies "Your message was received";
+     * exercises the full event→reply pipeline for local testing).
+     */
+    kind: RuntimeKind;
+    /** Executable override (default: the kind's CLI name). A fake runtime script works here for tests. */
+    command: string;
+    /** Extra args appended verbatim before the prompt. */
+    extraArgs: string[];
+    /** Working directory the CLI runs in — the agent's identity (a repo checkout). */
+    cwd: string;
+    /** --permission-mode passthrough (claude). Headless runs use pre-granted permissions — scope them. */
+    permissionMode?: string | undefined;
+    /** --allowedTools passthrough (claude), e.g. ["Read", "Bash(pnpm test)"]. */
+    allowedTools: string[];
+    /** --max-turns cap (claude). */
+    maxTurns: number;
+    /** Wall-clock timeout per run, seconds. */
+    timeoutSec: number;
+    /** MCP rich mode: expose the flow MCP server to the runtime (claude only). */
+    mcp: boolean;
+    /** Extra text appended to the Flow system prompt. */
+    systemPromptExtra?: string | undefined;
+}
+export interface BridgeConfig {
+    serverUrl: string;
+    agentToken: string;
+    runtime: RuntimeConfig;
+    /** Default 'mentions': @-mentions + DMs only. 'all' adds full traffic of channels the agent is in. */
+    eventScope: EventScope;
+    /** Never respond to other agents (loop safety). Default false. */
+    respondToAgents: boolean;
+    /** Max conversations processed concurrently (serial within one conversation). */
+    concurrency: number;
+    progress: ProgressMode;
+}
+export declare function loadConfig(configPath: string): BridgeConfig;

package/dist/config.js

@@ -0,0 +1,65 @@
+// Bridge configuration (AGENTS_DESIGN.md): JSON file, one agent per config.
+// (The spec allows "agent.toml or JSON"; the bridge ships JSON — no TOML
+// parser in Node's stdlib, and one less dependency.)
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+/** "~" / "~/x" → the user's home (shells don't expand ~ inside JSON configs or wizard answers). */
+export function expandHome(p) {
+    if (p === '~')
+        return os.homedir();
+    return p.startsWith('~/') ? path.join(os.homedir(), p.slice(2)) : p;
+}
+export function loadConfig(configPath) {
+    const abs = path.resolve(configPath);
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(abs, 'utf8'));
+    }
+    catch (err) {
+        throw new Error(`could not read config ${abs}: ${err.message}`);
+    }
+    const serverUrl = (raw.serverUrl ?? process.env.FLOW_SERVER_URL ?? '').replace(/\/+$/, '');
+    if (!serverUrl)
+        throw new Error('config: serverUrl is required (or FLOW_SERVER_URL)');
+    const agentToken = raw.agentToken ?? process.env.FLOW_AGENT_TOKEN ?? '';
+    if (!agentToken)
+        throw new Error('config: agentToken is required (or FLOW_AGENT_TOKEN)');
+    const kind = (raw.runtime?.kind ?? 'claude');
+    if (kind !== 'claude' && kind !== 'codex' && kind !== 'demo')
+        throw new Error(`config: unknown runtime.kind "${kind}"`);
+    const r = raw.runtime ?? {};
+    const runtime = {
+        kind,
+        command: r.command ?? (kind === 'codex' ? 'codex' : 'claude'),
+        extraArgs: r.extraArgs ?? [],
+        cwd: path.resolve(path.dirname(abs), expandHome(r.cwd ?? '.')),
+        permissionMode: r.permissionMode,
+        allowedTools: r.allowedTools ?? [],
+        maxTurns: r.maxTurns ?? 25,
+        timeoutSec: r.timeoutSec ?? 300,
+        mcp: r.mcp ?? (kind === 'claude'),
+        systemPromptExtra: r.systemPromptExtra,
+    };
+    // A missing cwd would otherwise surface as a misleading "spawn <cli> ENOENT"
+    // (node reports ENOENT for a bad working directory too). Demo never spawns.
+    if (kind !== 'demo' && !fs.existsSync(runtime.cwd)) {
+        throw new Error(`config: runtime.cwd does not exist: ${runtime.cwd}`);
+    }
+    const eventScope = (raw.eventScope ?? 'mentions');
+    if (eventScope !== 'mentions' && eventScope !== 'all')
+        throw new Error(`config: bad eventScope "${eventScope}"`);
+    const progress = (raw.progress ?? 'thinking');
+    if (!['thinking', 'typing', 'silent'].includes(progress))
+        throw new Error(`config: bad progress "${progress}"`);
+    return {
+        serverUrl,
+        agentToken,
+        runtime,
+        eventScope,
+        respondToAgents: raw.respondToAgents ?? false,
+        concurrency: Math.max(1, raw.concurrency ?? 4),
+        progress,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/gateway.d.ts

@@ -0,0 +1,20 @@
+import type { Event } from '@flow/shared';
+export interface FlowSocketOpts {
+    serverUrl: string;
+    token: string;
+    onEvent(event: Event): void;
+    onOpen?(): void;
+    log(msg: string): void;
+}
+export declare class FlowSocket {
+    private readonly opts;
+    private ws;
+    private closed;
+    private attempt;
+    constructor(opts: FlowSocketOpts);
+    connect(): void;
+    private scheduleReconnect;
+    sendTyping(channelId: string): void;
+    private send;
+    close(): void;
+}

package/dist/gateway.js

@@ -0,0 +1,68 @@
+// Agent-token WS connection — real presence: the agent shows online while
+// the daemon runs. Auto-reconnects with backoff; answers heartbeat pings.
+import WebSocket from 'ws';
+const BACKOFF_MS = [1000, 2000, 5000, 10_000, 30_000];
+export class FlowSocket {
+    opts;
+    ws = null;
+    closed = false;
+    attempt = 0;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    connect() {
+        if (this.closed)
+            return;
+        const wsUrl = this.opts.serverUrl.replace(/^http/, 'ws') + '/v1/ws';
+        const ws = new WebSocket(wsUrl);
+        this.ws = ws;
+        ws.on('open', () => {
+            this.send({ op: 'auth', token: this.opts.token });
+        });
+        ws.on('message', (raw) => {
+            let frame;
+            try {
+                frame = JSON.parse(String(raw));
+            }
+            catch {
+                return;
+            }
+            if (frame.op === 'ping')
+                return this.send({ op: 'pong' });
+            if (frame.op === 'hello') {
+                this.attempt = 0;
+                this.opts.log('connected (presence online)');
+                this.opts.onOpen?.();
+                return;
+            }
+            if (frame.op === 'event')
+                return this.opts.onEvent(frame.event);
+            if (frame.op === 'error')
+                this.opts.log(`ws error: ${frame.code} ${frame.message}`);
+        });
+        ws.on('close', () => this.scheduleReconnect());
+        ws.on('error', (err) => this.opts.log(`ws error: ${err.message}`));
+    }
+    scheduleReconnect() {
+        if (this.closed)
+            return;
+        const delay = BACKOFF_MS[Math.min(this.attempt, BACKOFF_MS.length - 1)];
+        this.attempt += 1;
+        this.opts.log(`disconnected — reconnecting in ${delay / 1000}s`);
+        // NOT unref'd: after a disconnect this timer may be the only handle left
+        // on the event loop — an unref'd timer let the whole daemon exit(0) here.
+        setTimeout(() => this.connect(), delay);
+    }
+    sendTyping(channelId) {
+        this.send({ op: 'typing', channelId });
+    }
+    send(frame) {
+        if (this.ws?.readyState === WebSocket.OPEN)
+            this.ws.send(JSON.stringify(frame));
+    }
+    close() {
+        this.closed = true;
+        this.ws?.close();
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+// flow-agent-bridge CLI:
+//   flow-agent-bridge [config.json]         the one command: if the config
+//                                           exists, run the daemon; if not,
+//                                           interactive setup (invite key →
+//                                           token exchange → save) then run.
+//                                           Default config path: ./agent.json
+//   flow-agent-bridge run <config.json>     start the daemon (no setup)
+//   flow-agent-bridge register --server <url> --invite <key> [--name <name>]
+//                              [--description <text>] [--avatar <url>]
+//   (--name optional: falls back to the invite's nameHint server-side)
+//   flow-agent-bridge mcp                   (internal) the flow MCP stdio server
+import fs from 'node:fs';
+import { loadConfig } from './config.js';
+import { AgentBridge } from './bridge.js';
+import { registerAgent } from './api.js';
+import { runMcpServer } from './mcp-server.js';
+import { runSetup } from './setup.js';
+function usage() {
+    console.error('usage:\n' +
+        '  flow-agent-bridge [config.json]      setup (if missing) + run — default ./agent.json\n' +
+        '  flow-agent-bridge run <config.json>\n' +
+        '  flow-agent-bridge register --server <url> --invite <key> [--name <name>] [--description <text>] [--avatar <url>]\n');
+    process.exit(2);
+}
+function flag(args, name) {
+    const i = args.indexOf(`--${name}`);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+async function main() {
+    const [cmd, ...rest] = process.argv.slice(2);
+    if (cmd === 'mcp')
+        return runMcpServer();
+    if (cmd === 'register') {
+        const server = flag(rest, 'server');
+        const invite = flag(rest, 'invite');
+        const name = flag(rest, 'name');
+        if (!server || !invite)
+            usage();
+        const res = await registerAgent(server, {
+            inviteKey: invite,
+            ...(name ? { name } : {}),
+            ...(flag(rest, 'description') ? { description: flag(rest, 'description') } : {}),
+            ...(flag(rest, 'avatar') ? { avatarUrl: flag(rest, 'avatar') } : {}),
+        });
+        console.log(`registered ${res.user.displayName} <@${res.user.id}> in workspace "${res.workspace.name}"`);
+        console.log('');
+        console.log('agent token (shown ONCE — put it in your bridge config as "agentToken"):');
+        console.log(`  ${res.agentToken}`);
+        return;
+    }
+    if (cmd === 'help' || cmd === '--help' || cmd === '-h')
+        usage();
+    // `run <config>` requires the config; a bare path (or no args → ./agent.json)
+    // runs interactive setup first when the file doesn't exist.
+    let configPath = cmd === 'run' ? rest[0] : cmd ?? 'agent.json';
+    if (!configPath)
+        usage();
+    if (cmd !== 'run' && !fs.existsSync(configPath))
+        configPath = await runSetup(configPath);
+    const cfg = loadConfig(configPath);
+    const bridge = new AgentBridge(cfg);
+    await bridge.start();
+    const shutdown = () => {
+        bridge.stop();
+        setTimeout(() => process.exit(0), 200);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+main().catch((err) => {
+    console.error(`fatal: ${err.message}`);
+    process.exit(1);
+});
+//# 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/mcp-server.d.ts

@@ -0,0 +1 @@
+export declare function runMcpServer(): Promise<void>;

package/dist/mcp-server.js

@@ -0,0 +1,186 @@
+// The `flow` MCP stdio server (rich mode, operator ruling 6): send_message,
+// react, upload_file, search_history against /v1 with the agent token.
+//
+// Hand-rolled newline-delimited JSON-RPC (the MCP stdio transport) — the
+// surface is four tools; no SDK dependency needed. Conversation context
+// (channel/thread) arrives via env from the bridge's per-run --mcp-config.
+import fs from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline';
+import { FlowApi } from './api.js';
+const TOOLS = [
+    {
+        name: 'send_message',
+        description: 'Send a message to a Flow channel or thread immediately. Defaults to the current conversation. Mention users as <@userId>.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                text: { type: 'string', description: 'Message body (markdown).' },
+                channelId: { type: 'string', description: 'Target channel id (default: current conversation).' },
+                threadRootId: { type: 'string', description: 'Thread root message id (default: current thread, if any).' },
+            },
+            required: ['text'],
+        },
+    },
+    {
+        name: 'react',
+        description: 'Add an emoji reaction to a message.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                messageId: { type: 'string', description: 'Message id to react to.' },
+                emoji: { type: 'string', description: 'A single unicode emoji, e.g. 👍' },
+            },
+            required: ['messageId', 'emoji'],
+        },
+    },
+    {
+        name: 'upload_file',
+        description: 'Upload a local file and post it to a Flow channel (defaults to the current conversation).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Path to the file on disk.' },
+                channelId: { type: 'string', description: 'Target channel id (default: current conversation).' },
+                threadRootId: { type: 'string', description: 'Thread root message id (default: current thread, if any).' },
+                comment: { type: 'string', description: 'Optional message text to accompany the file.' },
+            },
+            required: ['path'],
+        },
+    },
+    {
+        name: 'search_history',
+        description: 'Search recent messages in a Flow channel for a substring (case-insensitive).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Text to search for.' },
+                channelId: { type: 'string', description: 'Channel to search (default: current conversation).' },
+                limit: { type: 'number', description: 'Max matches to return (default 10).' },
+            },
+            required: ['query'],
+        },
+    },
+];
+const MIME_BY_EXT = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.pdf': 'application/pdf',
+    '.txt': 'text/plain',
+    '.md': 'text/markdown',
+    '.json': 'application/json',
+};
+export async function runMcpServer() {
+    const serverUrl = process.env.FLOW_SERVER_URL ?? '';
+    const token = process.env.FLOW_AGENT_TOKEN ?? '';
+    const workspaceId = process.env.FLOW_WORKSPACE_ID ?? '';
+    const defaultChannelId = process.env.FLOW_CHANNEL_ID ?? '';
+    const defaultThreadRootId = process.env.FLOW_THREAD_ROOT_ID || undefined;
+    if (!serverUrl || !token) {
+        process.stderr.write('flow mcp: FLOW_SERVER_URL and FLOW_AGENT_TOKEN are required\n');
+        process.exit(1);
+    }
+    const api = new FlowApi(serverUrl, token);
+    const write = (msg) => {
+        process.stdout.write(`${JSON.stringify(msg)}\n`);
+    };
+    const reply = (id, result) => {
+        write({ jsonrpc: '2.0', id, result });
+    };
+    const replyError = (id, code, message) => {
+        write({ jsonrpc: '2.0', id, error: { code, message } });
+    };
+    const toolText = (text, isError = false) => ({ content: [{ type: 'text', text }], isError });
+    async function callTool(name, args) {
+        const channelId = args.channelId || defaultChannelId;
+        const threadRootId = args.threadRootId || defaultThreadRootId;
+        switch (name) {
+            case 'send_message': {
+                const msg = await api.sendMessage(channelId, String(args.text ?? ''), threadRootId);
+                return toolText(`sent (message id ${msg.id})`);
+            }
+            case 'react': {
+                await api.addReaction(String(args.messageId ?? ''), String(args.emoji ?? ''));
+                return toolText('reaction added');
+            }
+            case 'upload_file': {
+                const p = path.resolve(String(args.path ?? ''));
+                const data = fs.readFileSync(p);
+                const filename = path.basename(p);
+                const mime = MIME_BY_EXT[path.extname(p).toLowerCase()] ?? 'application/octet-stream';
+                const file = await api.uploadFile(workspaceId, filename, mime, data);
+                const msg = await api.sendMessage(channelId, String(args.comment ?? filename), threadRootId, [file.id]);
+                return toolText(`uploaded ${filename} (message id ${msg.id})`);
+            }
+            case 'search_history': {
+                const q = String(args.query ?? '').toLowerCase();
+                const limit = Math.min(Number(args.limit ?? 10), 50);
+                const page = await api.listMessages(channelId, 200);
+                const hits = page.messages
+                    .filter((m) => !m.deletedAt && m.body.toLowerCase().includes(q))
+                    .slice(-limit)
+                    .map((m) => `[${m.createdAt} <@${m.userId}> msg ${m.id}] ${m.body.slice(0, 300)}`);
+                return toolText(hits.length ? hits.join('\n') : 'no matches');
+            }
+            default:
+                return toolText(`unknown tool: ${name}`, true);
+        }
+    }
+    const rl = readline.createInterface({ input: process.stdin, terminal: false });
+    rl.on('line', (line) => {
+        void (async () => {
+            const trimmed = line.trim();
+            if (!trimmed)
+                return;
+            let req;
+            try {
+                req = JSON.parse(trimmed);
+            }
+            catch {
+                return; // not for us
+            }
+            const id = req.id ?? null;
+            try {
+                switch (req.method) {
+                    case 'initialize':
+                        return reply(id, {
+                            protocolVersion: req.params?.protocolVersion ?? '2025-06-18',
+                            capabilities: { tools: {} },
+                            serverInfo: { name: 'flow', version: '0.1.0' },
+                        });
+                    case 'notifications/initialized':
+                    case 'notifications/cancelled':
+                        return; // notifications get no response
+                    case 'ping':
+                        return reply(id, {});
+                    case 'tools/list':
+                        return reply(id, { tools: TOOLS });
+                    case 'tools/call': {
+                        const name = String(req.params?.name ?? '');
+                        const args = (req.params?.arguments ?? {});
+                        try {
+                            return reply(id, await callTool(name, args));
+                        }
+                        catch (err) {
+                            return reply(id, toolText(`error: ${err.message}`, true));
+                        }
+                    }
+                    default:
+                        if (id !== null)
+                            replyError(id, -32601, `method not found: ${req.method}`);
+                        return;
+                }
+            }
+            catch (err) {
+                if (id !== null)
+                    replyError(id, -32603, err.message);
+            }
+        })();
+    });
+    // stay alive until stdin closes
+    await new Promise((resolve) => rl.on('close', resolve));
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/progress.d.ts

@@ -0,0 +1,23 @@
+import type { FlowApi } from './api.js';
+import type { FlowSocket } from './gateway.js';
+import type { ProgressMode } from './config.js';
+export declare class ProgressReporter {
+    private readonly api;
+    private readonly socket;
+    private readonly mode;
+    private readonly channelId;
+    private readonly threadRootId;
+    private readonly log;
+    private typingTimer;
+    private statusMessageId;
+    private inFlight;
+    private pendingStep;
+    private finished;
+    constructor(api: FlowApi, socket: FlowSocket, mode: ProgressMode, channelId: string, threadRootId: string | undefined, log: (msg: string) => void);
+    start(): void;
+    /** Latest step wins; edits are serialized (a step landing mid-edit is applied after). */
+    onStep(step: string): void;
+    private drain;
+    /** Stop typing and delete the status message (if any). */
+    finish(): Promise<void>;
+}

package/dist/progress.js

@@ -0,0 +1,78 @@
+const TYPING_INTERVAL_MS = 4000;
+export class ProgressReporter {
+    api;
+    socket;
+    mode;
+    channelId;
+    threadRootId;
+    log;
+    typingTimer = null;
+    statusMessageId = null;
+    inFlight = false;
+    pendingStep = null;
+    finished = false;
+    constructor(api, socket, mode, channelId, threadRootId, log) {
+        this.api = api;
+        this.socket = socket;
+        this.mode = mode;
+        this.channelId = channelId;
+        this.threadRootId = threadRootId;
+        this.log = log;
+    }
+    start() {
+        if (this.mode === 'silent')
+            return;
+        this.socket.sendTyping(this.channelId);
+        this.typingTimer = setInterval(() => this.socket.sendTyping(this.channelId), TYPING_INTERVAL_MS);
+        this.typingTimer.unref();
+    }
+    /** Latest step wins; edits are serialized (a step landing mid-edit is applied after). */
+    onStep(step) {
+        if (this.mode !== 'thinking' || this.finished)
+            return;
+        this.pendingStep = step;
+        if (!this.inFlight)
+            void this.drain();
+    }
+    async drain() {
+        this.inFlight = true;
+        try {
+            while (this.pendingStep !== null && !this.finished) {
+                const step = this.pendingStep;
+                this.pendingStep = null;
+                const body = `🤖 *thinking…* — ${step}`;
+                try {
+                    if (this.statusMessageId === null) {
+                        const msg = await this.api.sendMessage(this.channelId, body, this.threadRootId);
+                        this.statusMessageId = msg.id;
+                    }
+                    else {
+                        await this.api.editMessage(this.statusMessageId, body);
+                    }
+                }
+                catch (err) {
+                    this.log(`status message failed: ${err.message}`);
+                }
+            }
+        }
+        finally {
+            this.inFlight = false;
+        }
+    }
+    /** Stop typing and delete the status message (if any). */
+    async finish() {
+        this.finished = true;
+        if (this.typingTimer)
+            clearInterval(this.typingTimer);
+        // wait out an in-flight post/edit so the delete can't race message creation
+        while (this.inFlight)
+            await new Promise((r) => setTimeout(r, 25));
+        if (this.statusMessageId !== null) {
+            await this.api.deleteMessage(this.statusMessageId).catch((err) => {
+                this.log(`status delete failed: ${err.message}`);
+            });
+            this.statusMessageId = null;
+        }
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,36 @@
+import type { RuntimeConfig } from './config.js';
+export interface RunOpts {
+    sessionId: string;
+    /** false → --session-id (new session); true → --resume. */
+    resume: boolean;
+    prompt: string;
+    systemPrompt: string;
+    /** Path to an MCP config JSON to pass via --mcp-config (claude only). */
+    mcpConfigPath?: string | undefined;
+    onToolStep(step: string): void;
+    log(msg: string): void;
+}
+export interface RunResult {
+    ok: boolean;
+    text: string;
+    error?: string;
+}
+/** One line per tool call, latest step shown: "Bash: pnpm test". */
+export declare function formatToolStep(name: string, input: unknown): string;
+/**
+ * Feed stream-json stdout lines; emits tool steps and captures the final
+ * result. Tolerant of non-JSON noise on stdout.
+ */
+export declare class StreamJsonParser {
+    private readonly onToolStep;
+    private buf;
+    finalText: string;
+    isError: boolean;
+    sawResult: boolean;
+    constructor(onToolStep: (step: string) => void);
+    feed(chunk: string): void;
+    private handleLine;
+}
+/** Demo mode: static canned reply, no CLI spawn. */
+export declare const DEMO_REPLY = "Your message was received";
+export declare function runRuntime(cfg: RuntimeConfig, opts: RunOpts): Promise<RunResult>;