flow-agent-bridge 0.2.0

package/dist/runtime.js

@@ -0,0 +1,177 @@
+// Runtime exec: spawn a coding-agent CLI headlessly per conversation turn.
+//
+// Claude runtime (primary): `claude -p --output-format stream-json --verbose`
+// with `--session-id <uuid>` on the first turn and `--resume <uuid>` after.
+// Tool calls stream by as stream-json events → surfaced as thinking steps.
+// Codex runtime: STUB — baseline "prompt in, stdout out" contract, no session
+// resume, no thinking steps. Untested; see AGENTS.md.
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+/** One line per tool call, latest step shown: "Bash: pnpm test". */
+export function formatToolStep(name, input) {
+    const i = (input ?? {});
+    const short = (v, max = 80) => {
+        const s = String(v ?? '').replace(/\s+/g, ' ').trim();
+        return s.length > max ? `${s.slice(0, max - 1)}…` : s;
+    };
+    if (name.startsWith('mcp__flow__'))
+        return `Flow: ${name.slice('mcp__flow__'.length)}`;
+    if (name.startsWith('mcp__'))
+        return name.replace(/^mcp__/, '').replace('__', ': ');
+    switch (name) {
+        case 'Bash':
+            return `Bash: ${short(i.command)}`;
+        case 'Read':
+        case 'Write':
+        case 'Edit':
+        case 'NotebookEdit':
+            return `${name}: ${short(path.basename(String(i.file_path ?? i.notebook_path ?? '')))}`;
+        case 'Glob':
+        case 'Grep':
+            return `${name}: ${short(i.pattern)}`;
+        case 'WebSearch':
+            return `WebSearch: ${short(i.query)}`;
+        case 'WebFetch':
+            return `WebFetch: ${short(i.url)}`;
+        case 'Task':
+        case 'Agent':
+            return `Agent: ${short(i.description ?? i.prompt)}`;
+        case 'TodoWrite':
+            return 'updating plan';
+        default:
+            return name;
+    }
+}
+/**
+ * Feed stream-json stdout lines; emits tool steps and captures the final
+ * result. Tolerant of non-JSON noise on stdout.
+ */
+export class StreamJsonParser {
+    onToolStep;
+    buf = '';
+    finalText = '';
+    isError = false;
+    sawResult = false;
+    constructor(onToolStep) {
+        this.onToolStep = onToolStep;
+    }
+    feed(chunk) {
+        this.buf += chunk;
+        let idx;
+        while ((idx = this.buf.indexOf('\n')) >= 0) {
+            const line = this.buf.slice(0, idx).trim();
+            this.buf = this.buf.slice(idx + 1);
+            if (!line)
+                continue;
+            this.handleLine(line);
+        }
+    }
+    handleLine(line) {
+        let ev;
+        try {
+            ev = JSON.parse(line);
+        }
+        catch {
+            return; // non-JSON noise
+        }
+        if (ev.type === 'assistant') {
+            for (const block of ev.message?.content ?? []) {
+                if (block.type === 'tool_use' && block.name)
+                    this.onToolStep(formatToolStep(block.name, block.input));
+            }
+        }
+        else if (ev.type === 'result') {
+            this.sawResult = true;
+            this.isError = ev.is_error === true || (ev.subtype !== undefined && ev.subtype !== 'success');
+            this.finalText = ev.result ?? '';
+        }
+    }
+}
+function buildClaudeArgs(cfg, opts) {
+    const args = ['-p', '--output-format', 'stream-json', '--verbose'];
+    args.push(opts.resume ? '--resume' : '--session-id', opts.sessionId);
+    args.push('--append-system-prompt', opts.systemPrompt);
+    args.push('--max-turns', String(cfg.maxTurns));
+    if (cfg.permissionMode)
+        args.push('--permission-mode', cfg.permissionMode);
+    const allowed = [...cfg.allowedTools];
+    if (opts.mcpConfigPath) {
+        // = form: --mcp-config and --allowedTools are variadic in the claude CLI
+        // and would otherwise swallow the trailing positional prompt
+        args.push(`--mcp-config=${opts.mcpConfigPath}`);
+        allowed.push('mcp__flow'); // pre-grant the flow tools — headless runs can't prompt
+    }
+    if (allowed.length)
+        args.push(`--allowedTools=${allowed.join(',')}`);
+    args.push(...cfg.extraArgs);
+    args.push(opts.prompt);
+    return args;
+}
+function buildCodexArgs(cfg, opts) {
+    // STUB: baseline contract only (stdout = reply). No session resume.
+    return ['exec', '--skip-git-repo-check', ...cfg.extraArgs, opts.prompt];
+}
+/** Demo mode: static canned reply, no CLI spawn. */
+export const DEMO_REPLY = 'Your message was received';
+export async function runRuntime(cfg, opts) {
+    if (cfg.kind === 'demo') {
+        // Brief pause so the typing indicator is visible in clients.
+        await new Promise((r) => setTimeout(r, 500));
+        return { ok: true, text: DEMO_REPLY };
+    }
+    const args = cfg.kind === 'claude' ? buildClaudeArgs(cfg, opts) : buildCodexArgs(cfg, opts);
+    return new Promise((resolve) => {
+        const child = spawn(cfg.command, args, {
+            cwd: cfg.cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: { ...process.env },
+        });
+        const parser = new StreamJsonParser(opts.onToolStep);
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            child.kill('SIGKILL');
+            resolve({ ok: false, text: '', error: `timed out after ${cfg.timeoutSec}s` });
+        }, cfg.timeoutSec * 1000);
+        child.stdout.on('data', (d) => {
+            const s = d.toString('utf8');
+            stdout += s;
+            if (cfg.kind === 'claude')
+                parser.feed(s);
+        });
+        child.stderr.on('data', (d) => {
+            stderr += d.toString('utf8');
+        });
+        child.on('error', (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ ok: false, text: '', error: `could not spawn ${cfg.command}: ${err.message}` });
+        });
+        child.on('close', (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            parser.feed('\n'); // flush a trailing unterminated line
+            if (cfg.kind === 'claude') {
+                if (parser.sawResult && !parser.isError)
+                    return resolve({ ok: true, text: parser.finalText });
+                const error = parser.sawResult
+                    ? `runtime reported an error${parser.finalText ? `: ${parser.finalText.slice(0, 300)}` : ''}`
+                    : `runtime exited ${code} without a result${stderr ? `: ${stderr.slice(-300)}` : ''}`;
+                return resolve({ ok: false, text: parser.finalText, error });
+            }
+            // baseline contract: stdout is the reply
+            if (code === 0)
+                return resolve({ ok: true, text: stdout.trim() });
+            return resolve({ ok: false, text: '', error: `runtime exited ${code}${stderr ? `: ${stderr.slice(-300)}` : ''}` });
+        });
+    });
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,2EAA2E;AAC3E,8EAA8E;AAC9E,sDAAsD;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAqB7B,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAc;IACzD,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;IACnD,MAAM,KAAK,GAAG,CAAC,CAAU,EAAE,GAAG,GAAG,EAAE,EAAU,EAAE;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,OAAO,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC;IACF,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,SAAS,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;IACvF,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,MAAM,CAAC;QACZ,KAAK,cAAc;YACjB,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,KAAK,WAAW;YACd,OAAO,cAAc,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,KAAK,UAAU;YACb,OAAO,aAAa,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,KAAK,WAAW;YACd,OAAO,eAAe,CAAC;QACzB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAUD;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAME;IALrB,GAAG,GAAG,EAAE,CAAC;IACjB,SAAS,GAAG,EAAE,CAAC;IACf,OAAO,GAAG,KAAK,CAAC;IAChB,SAAS,GAAG,KAAK,CAAC;IAElB,YAA6B,UAAkC;QAAlC,eAAU,GAAV,UAAU,CAAwB;IAAG,CAAC;IAEnE,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC;QAClB,IAAI,GAAW,CAAC;QAChB,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,IAAI,EAAe,CAAC;QACpB,IAAI,CAAC;YACH,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,iBAAiB;QAC3B,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC5B,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;gBAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI;oBAAE,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACxG,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;YAC9F,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;CACF;AAED,SAAS,eAAe,CAAC,GAAkB,EAAE,IAAa;IACxD,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IACnE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACrE,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,IAAI,GAAG,CAAC,cAAc;QAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,yEAAyE;QACzE,6DAA6D;QAC7D,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,wDAAwD;IACrF,CAAC;IACD,IAAI,OAAO,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,GAAkB,EAAE,IAAa;IACvD,oEAAoE;IACpE,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,MAAM,UAAU,GAAG,2BAA2B,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAkB,EAAE,IAAa;IAChE,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACxB,6DAA6D;QAC7D,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE;YACrC,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,mBAAmB,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QAChF,CAAC,EAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC1B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACpC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC7B,MAAM,IAAI,CAAC,CAAC;YACZ,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACpC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,mBAAmB,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5F,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,qCAAqC;YACxD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,OAAO;oBAAE,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC9F,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS;oBAC5B,CAAC,CAAC,4BAA4B,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;oBAC7F,CAAC,CAAC,kBAAkB,IAAI,oBAAoB,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACxF,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,yCAAyC;YACzC,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClE,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,kBAAkB,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACrH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1 @@
+export declare function runSetup(configPath: string): Promise<string>;

package/dist/setup.js

@@ -0,0 +1,86 @@
+// Interactive first-run setup: prompt for the invite key, exchange it for an
+// agent token, ask the handful of questions that matter, save agent.json, and
+// hand back the path so the caller can start the daemon immediately.
+// Advanced knobs (permissionMode, allowedTools, eventScope, …) are edited in
+// the saved file — see AGENTS.md.
+import fs from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline/promises';
+import { FlowApi, registerAgent } from './api.js';
+import { expandHome } from './config.js';
+async function ask(rl, q, def) {
+    const suffix = def ? ` [${def}]` : '';
+    const answer = (await rl.question(`${q}${suffix}: `)).trim();
+    return answer || def || '';
+}
+export async function runSetup(configPath) {
+    if (!process.stdin.isTTY) {
+        throw new Error(`no config at ${configPath} and stdin is not a TTY — run interactively or pass a config path`);
+    }
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        console.log('No config found — setting up a new agent.\n');
+        const serverUrl = (await ask(rl, 'Flow server URL', process.env.FLOW_SERVER_URL ?? 'https://app.flowtoo.org')).replace(/\/+$/, '');
+        let key = '';
+        while (!key.startsWith('flow-agent-')) {
+            key = await ask(rl, 'Invite key (flow-agent-…) — or an agent token (flow-agent-token-…, from "Regenerate token") to reuse an existing agent');
+            if (!key.startsWith('flow-agent-'))
+                console.log('  that does not look like a flow-agent-… key or token');
+        }
+        let agentToken;
+        if (key.startsWith('flow-agent-token-')) {
+            // Existing agent: validate the token and skip registration.
+            console.log('\nAgent token detected — verifying…');
+            const me = await new FlowApi(serverUrl, key).me();
+            console.log(`connecting as existing agent ${me.displayName} <@${me.id}>\n`);
+            agentToken = key;
+        }
+        else {
+            const name = await ask(rl, 'Agent name (blank = use the invite’s name hint)');
+            const description = await ask(rl, 'Description (optional)');
+            console.log('\nRegistering…');
+            const res = await registerAgent(serverUrl, {
+                inviteKey: key,
+                ...(name ? { name } : {}),
+                ...(description ? { description } : {}),
+            });
+            console.log(`registered ${res.user.displayName} <@${res.user.id}> in workspace "${res.workspace.name}"\n`);
+            agentToken = res.agentToken;
+        }
+        let kind = '';
+        while (!['claude', 'codex', 'demo'].includes(kind)) {
+            kind = (await ask(rl, 'Runtime — claude, codex, or demo', 'claude')).toLowerCase();
+        }
+        const config = {
+            serverUrl,
+            agentToken,
+            runtime: { kind },
+        };
+        if (kind !== 'demo') {
+            let cwd = '';
+            while (!cwd) {
+                const answer = await ask(rl, 'Working directory the agent runs in (its identity — e.g. a repo checkout)', '.');
+                const resolved = path.resolve(expandHome(answer));
+                if (fs.existsSync(resolved))
+                    cwd = resolved;
+                else
+                    console.log(`  ${resolved} does not exist — try again`);
+            }
+            config.runtime.cwd = cwd;
+            if (kind === 'claude') {
+                // Sane read-only default so a fresh agent can answer questions without
+                // being able to mutate anything; widen in the config file deliberately.
+                config.runtime.allowedTools = ['Read', 'Grep', 'Glob'];
+            }
+        }
+        const abs = path.resolve(configPath);
+        fs.writeFileSync(abs, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
+        console.log(`\nSaved ${abs} (contains the agent token — keep it private).`);
+        console.log('Edit it any time for permissions, event scope, progress mode, etc. (see AGENTS.md).\n');
+        return abs;
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "flow-agent-bridge",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Flow agent bridge: joins a Flow workspace as a first-class AI agent and execs a coding-agent CLI (Claude Code, Codex) headlessly per conversation",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/scottpersinger/flow.git",
+    "directory": "packages/agent-bridge"
+  },
+  "keywords": [
+    "flow",
+    "agent",
+    "claude",
+    "claude-code",
+    "chat-bot",
+    "bridge"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "flow-agent-bridge": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "prepack": "pnpm build",
+    "pack:tarball": "pnpm pack"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@flow/shared": "workspace:*",
+    "@types/node": "^22.10.0",
+    "@types/ws": "^8.5.13",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.8"
+  }
+}