@monoes/monomindcli 2.9.20 → 2.9.22

package/dist/src/orgrt/pi-runner.js

@@ -0,0 +1,264 @@
+// packages/@monomind/cli/src/orgrt/pi-runner.ts
+/**
+ * PiAgentRunner — AgentRunner impl backed by the Pi coding agent CLI
+ * (`pi`, https://github.com/badlogic/pi-mono, package @mariozechner/pi-coding-agent).
+ *
+ * Architectural pattern: SAME as the other subprocess runners — spawn the
+ * CLI, parse its output, normalize to AgentMessage.
+ *
+ * Auth: pi's own provider login (per-provider API key or subscription,
+ * configured via `pi` itself). No env vars set here.
+ *
+ * Subprocess protocol — per public docs (pi-mono's rpc.md + README), NOT
+ * byte-verified against a running binary. `pi --mode json` shares its event
+ * vocabulary with pi's RPC mode:
+ *   - Invocation: `pi --mode json --approve --session-dir <dir> "<prompt>"`.
+ *     The prompt is POSITIONAL (matching pi's own interactive-mode CLI shape
+ *     and the same convention codex uses) — an earlier revision of this
+ *     runner passed it via a `-p` flag, which a second-source cross-check
+ *     against another public agentic-CLI wrapper's tool table indicated was
+ *     wrong; corrected here. `--approve` accepts the cwd as a trusted
+ *     project so pi doesn't stop to ask (pi has no single "yolo" flag; tool
+ *     auto-approval for individual actions is a separate, not-yet-wired
+ *     concern for this runner — org tool calls go through canUseTool
+ *     regardless, since they use the tool-fence protocol, not pi's native
+ *     tool surface).
+ *     (`--session-dir` also gives turn-to-turn continuity: pi persists
+ *     sessions in that directory and resumes the latest one by default —
+ *     there is no confirmed explicit `--resume <id>` flag for headless use,
+ *     so this runner points every turn at the SAME per-run session dir
+ *     rather than tracking a session id, and disclaims true cross-process
+ *     resume as best-effort).
+ *   - Event types seen: `agent_start` (ignored), `message_update` (partial;
+ *     carries a cumulative `usage` object — kept as running totals but
+ *     superseded by `message_end`), `message_end` (final `content` array
+ *     with `{type:'text', text}` / `{type:'toolCall', ...}` items — only
+ *     `text` items are surfaced to the bus), `tool_execution_*` (ignored;
+ *     org tool calls use the shared tool-fence protocol, not pi's native
+ *     tool-call surface).
+ *   - Usage field names differ from the other CLIs: `usage.input` /
+ *     `usage.output` (not `input_tokens`/`output_tokens`).
+ *
+ * Org tools — FENCE PROTOCOL: same approach as the other subprocess runners.
+ */
+import { spawn } from 'node:child_process';
+import { join } from 'node:path';
+import { buildToolProtocol, parseToolCalls, executeToolCall, formatToolResults, MAX_TOOL_ROUNDS, TOOL_CALL_RE } from './tool-fence.js';
+const TURN_TIMEOUT_MS = 2 * 60 * 60 * 1000;
+/** Distinct from TURN_TIMEOUT_MS: catches a hung first-run interactive prompt
+ *  fast instead of waiting out the full turn timeout. Any output at all
+ *  disarms it. Per pi's own docs, `-p`/`--mode json`/`--mode rpc` do NOT show
+ *  a trust prompt (see this file's --approve comment above), so this is a
+ *  defensive backstop rather than a known risk the way it is for copilot. */
+const STARTUP_GRACE_MS = 45_000;
+/** Pure JSON-event parser — exported for unit testing against fixture lines
+ *  (pi-runner.test.ts). */
+export function parsePiEvents(lines) {
+    const rawTexts = [];
+    let inputTokens = 0;
+    let outputTokens = 0;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || !trimmed.startsWith('{'))
+            continue;
+        let ev;
+        try {
+            ev = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (ev.type === 'message_end' && ev.message?.content) {
+            const text = ev.message.content
+                .filter((b) => b.type === 'text' && typeof b.text === 'string')
+                .map((b) => b.text)
+                .join('\n');
+            if (text)
+                rawTexts.push(text);
+        }
+        const usage = ev.message?.usage ?? ev.usage;
+        if (usage && (typeof usage.input === 'number' || typeof usage.output === 'number')) {
+            inputTokens = usage.input ?? inputTokens;
+            outputTokens = usage.output ?? outputTokens;
+        }
+    }
+    const texts = rawTexts.map((t) => t.replace(TOOL_CALL_RE, '').trim());
+    return { texts, rawTexts, inputTokens, outputTokens };
+}
+export class PiAgentRunner {
+    piBin;
+    constructor(piBin) {
+        this.piBin = piBin;
+    }
+    async *run(args) {
+        const bin = this.piBin || process.env.PI_CLI_BIN || 'pi';
+        // Stable per-run session directory — see file header on why this
+        // substitutes for an explicit resume-by-id flag.
+        const sessionDir = join(args.cwd, '.monomind-pi-session');
+        try {
+            let first = true;
+            for await (const p of args.prompt) {
+                const text = typeof p === 'string' ? p : (p?.message?.content ?? String(p ?? ''));
+                let nextPrompt = first ? `${args.systemPrompt}${buildToolProtocol(args.tools)}\n\n---\n\n${text}` : text;
+                first = false;
+                let turnInputTokens = 0;
+                let turnOutputTokens = 0;
+                for (let round = 0; round <= MAX_TOOL_ROUNDS; round++) {
+                    const outcome = await this.runTurn(bin, nextPrompt, sessionDir, args);
+                    if (outcome.hangSuspected) {
+                        throw new Error(`PiAgentRunner: pi produced no output within ${STARTUP_GRACE_MS / 1000}s and was killed. ` +
+                            'This usually means it is stuck on a prompt headless mode has no way to answer — pi\'s own ' +
+                            'docs say --mode json should not show a trust prompt, so this is unexpected. Run `pi` once ' +
+                            `manually in a real terminal in this project to check, then retry.${outcome.stderrTail ? `\nstderr: ${outcome.stderrTail.slice(-500)}` : ''}`);
+                    }
+                    if (outcome.exitCode !== 0) {
+                        throw new Error(`PiAgentRunner: pi failed (exit ${outcome.exitCode})` +
+                            (outcome.timedOut ? ` — killed after exceeding the ${TURN_TIMEOUT_MS / 3_600_000}h turn timeout` : '') +
+                            (outcome.stderrTail ? `\nstderr: ${outcome.stderrTail.slice(-500)}` : ''));
+                    }
+                    for (const t of outcome.texts) {
+                        if (t.trim())
+                            yield { type: 'assistant', text: t };
+                    }
+                    turnInputTokens += outcome.inputTokens;
+                    turnOutputTokens += outcome.outputTokens;
+                    const malformed = [];
+                    const calls = parseToolCalls(outcome.rawTexts, (raw, err) => malformed.push(`[monomind] ignored malformed tool_call fence (${err}): ${raw.slice(0, 200)}`));
+                    for (const note of malformed)
+                        yield { type: 'assistant', text: note };
+                    if (calls.length === 0)
+                        break;
+                    if (round === MAX_TOOL_ROUNDS) {
+                        yield { type: 'assistant', text: `[monomind] tool-call round cap (${MAX_TOOL_ROUNDS}) reached — dropping ${calls.length} pending tool call(s)` };
+                        break;
+                    }
+                    const results = [];
+                    for (const call of calls)
+                        results.push(await executeToolCall(args.tools, call, args.canUseTool));
+                    nextPrompt = formatToolResults(calls, results);
+                }
+                yield {
+                    type: 'result',
+                    subtype: 'success',
+                    input_tokens: turnInputTokens,
+                    output_tokens: turnOutputTokens,
+                };
+            }
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error('PiAgentRunner requires the Pi coding agent CLI (pi) on PATH. ' +
+                    'Install it: npm install -g @mariozechner/pi-coding-agent, then configure a ' +
+                    'provider. Or unset the runtime to use Claude.');
+            }
+            throw err;
+        }
+    }
+    runTurn(bin, prompt, sessionDir, args) {
+        return new Promise((resolve, reject) => {
+            // Prompt is positional (see file header) — always LAST so no later flag
+            // is mistaken for part of it.
+            const cliArgs = ['--mode', 'json', '--approve', '--session-dir', sessionDir];
+            if (args.model)
+                cliArgs.push('--model', args.model);
+            cliArgs.push(prompt);
+            const child = spawn(bin, cliArgs, {
+                cwd: args.cwd,
+                // PI_TELEMETRY/PI_SKIP_VERSION_CHECK: confirmed via pi's own docs —
+                // suppresses install/update telemetry and version-check network calls
+                // that otherwise add latency/flakiness to every headless turn.
+                env: { ...process.env, PI_TELEMETRY: '0', PI_SKIP_VERSION_CHECK: '1', ...args.env },
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stderrTail = '';
+            child.stderr?.on('data', (c) => { stderrTail = (stderrTail + c.toString()).slice(-4000); });
+            let sawOutput = false;
+            let timedOut = false;
+            let hangSuspected = false;
+            const KILL_GRACE_MS = 5000;
+            let killTimer;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+                killTimer = setTimeout(() => { try {
+                    child.kill('SIGKILL');
+                }
+                catch { /* already gone */ } }, KILL_GRACE_MS);
+                killTimer.unref?.();
+            }, TURN_TIMEOUT_MS);
+            // See STARTUP_GRACE_MS — disarmed by the first stdout chunk below.
+            let hangTimer = setTimeout(() => {
+                hangSuspected = true;
+                child.kill('SIGTERM');
+                killTimer = setTimeout(() => { try {
+                    child.kill('SIGKILL');
+                }
+                catch { /* already gone */ } }, KILL_GRACE_MS);
+                killTimer.unref?.();
+            }, STARTUP_GRACE_MS);
+            const exitPromise = new Promise((res, rej) => {
+                child.on('error', rej);
+                child.on('close', (code) => res(code ?? 1));
+            });
+            exitPromise.catch(() => { });
+            const readLines = (async () => {
+                const lines = [];
+                let buf = '';
+                for await (const chunk of child.stdout) {
+                    if (!sawOutput) {
+                        sawOutput = true;
+                        if (hangTimer) {
+                            clearTimeout(hangTimer);
+                            hangTimer = undefined;
+                        }
+                    }
+                    buf += chunk.toString();
+                    const parts = buf.split('\n');
+                    buf = parts.pop() ?? '';
+                    lines.push(...parts);
+                }
+                if (buf.trim())
+                    lines.push(buf);
+                return lines;
+            })();
+            // Timer cleanup lives in a top-level .finally() (not nested inside a
+            // success-path .then()) so it runs on EITHER path — a stdout stream
+            // error would otherwise skip straight to reject() and leave the
+            // TURN_TIMEOUT_MS/hangTimer/killTimer timers running past the
+            // process's actual lifetime.
+            Promise.all([readLines, exitPromise])
+                .then(([lines, exitCode]) => {
+                const parsed = parsePiEvents(lines);
+                resolve({
+                    texts: parsed.texts,
+                    rawTexts: parsed.rawTexts,
+                    exitCode,
+                    stderrTail,
+                    timedOut,
+                    hangSuspected,
+                    inputTokens: parsed.inputTokens,
+                    outputTokens: parsed.outputTokens,
+                });
+            }, (err) => {
+                // A stdout stream error (the reject path) means the process is
+                // still ALIVE and unmanaged — none of the timeout/hang timers
+                // would have fired to kill it. Without this, that error would
+                // orphan the child. child.kill() on an already-dead process is a
+                // documented no-op, so this is safe on every path.
+                try {
+                    child.kill('SIGTERM');
+                }
+                catch { /* already gone */ }
+                reject(err);
+            })
+                .finally(() => {
+                clearTimeout(timer);
+                if (hangTimer)
+                    clearTimeout(hangTimer);
+                if (killTimer)
+                    clearTimeout(killTimer);
+            });
+        });
+    }
+}
+//# sourceMappingURL=pi-runner.js.map

package/dist/src/orgrt/pi-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-runner.js","sourceRoot":"","sources":["../../../src/orgrt/pi-runner.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACvI,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC3C;;;;6EAI6E;AAC7E,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAUhC;2BAC2B;AAC3B,MAAM,UAAU,aAAa,CAAC,KAAe;IAG3C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACnD,IAAI,EAAW,CAAC;QAChB,IAAI,CAAC;YAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAS;QAAC,CAAC;QAErD,IAAI,EAAE,CAAC,IAAI,KAAK,aAAa,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;YACrD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO;iBAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;iBAC9D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC;iBAC5B,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC;QAC5C,IAAI,KAAK,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;YACnF,WAAW,GAAG,KAAK,CAAC,KAAK,IAAI,WAAW,CAAC;YACzC,YAAY,GAAG,KAAK,CAAC,MAAM,IAAI,YAAY,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACtE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;AACxD,CAAC;AAeD,MAAM,OAAO,aAAa;IACJ,KAAK;IAAzB,YAAoB,KAAc;qBAAd,KAAK;IAAY,CAAC;IAEtC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAkB;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC;QACzD,iEAAiE;QACjE,iDAAiD;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;QAE1D,IAAI,CAAC;YACH,IAAI,KAAK,GAAG,IAAI,CAAC;YACjB,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAClF,IAAI,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBACzG,KAAK,GAAG,KAAK,CAAC;gBACd,IAAI,eAAe,GAAG,CAAC,CAAC;gBACxB,IAAI,gBAAgB,GAAG,CAAC,CAAC;gBAEzB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,eAAe,EAAE,KAAK,EAAE,EAAE,CAAC;oBACtD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;oBAEtE,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;wBAC1B,MAAM,IAAI,KAAK,CACb,+CAA+C,gBAAgB,GAAG,IAAI,oBAAoB;4BAC1F,4FAA4F;4BAC5F,4FAA4F;4BAC5F,oEAAoE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9I,CAAC;oBACJ,CAAC;oBACD,IAAI,OAAO,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;wBAC3B,MAAM,IAAI,KAAK,CACb,kCAAkC,OAAO,CAAC,QAAQ,GAAG;4BACrD,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,iCAAiC,eAAe,GAAG,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;4BACtG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC1E,CAAC;oBACJ,CAAC;oBAED,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;wBAC9B,IAAI,CAAC,CAAC,IAAI,EAAE;4BAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;oBACrD,CAAC;oBACD,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;oBACvC,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC;oBAEzC,MAAM,SAAS,GAAa,EAAE,CAAC;oBAC/B,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CACzE,iDAAiD,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC9E,CAAC,CAAC;oBACH,KAAK,MAAM,IAAI,IAAI,SAAS;wBAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oBACtE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;wBAAE,MAAM;oBAE9B,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;wBAC9B,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mCAAmC,eAAe,wBAAwB,KAAK,CAAC,MAAM,uBAAuB,EAAE,CAAC;wBACjJ,MAAM;oBACR,CAAC;oBAED,MAAM,OAAO,GAAa,EAAE,CAAC;oBAC7B,KAAK,MAAM,IAAI,IAAI,KAAK;wBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;oBACjG,UAAU,GAAG,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACjD,CAAC;gBAED,MAAM;oBACJ,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,SAAS;oBAClB,YAAY,EAAE,eAAe;oBAC7B,aAAa,EAAE,gBAAgB;iBAChC,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CACb,+DAA+D;oBAC/D,6EAA6E;oBAC7E,+CAA+C,CAChD,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,GAAW,EAAE,MAAc,EAAE,UAAkB,EAAE,IAAkB;QACjF,OAAO,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClD,wEAAwE;YACxE,8BAA8B;YAC9B,MAAM,OAAO,GAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;YACvF,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE;gBAChC,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,oEAAoE;gBACpE,sEAAsE;gBACtE,+DAA+D;gBAC/D,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,qBAAqB,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;gBACnF,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAC;YAEH,IAAI,UAAU,GAAG,EAAE,CAAC;YACpB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,GAAG,UAAU,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAEpG,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,aAAa,GAAG,KAAK,CAAC;YAC1B,MAAM,aAAa,GAAG,IAAI,CAAC;YAC3B,IAAI,SAAoD,CAAC;YACzD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,QAAQ,GAAG,IAAI,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtB,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;gBAC7G,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;YACtB,CAAC,EAAE,eAAe,CAAC,CAAC;YAEpB,mEAAmE;YACnE,IAAI,SAAS,GAA8C,UAAU,CAAC,GAAG,EAAE;gBACzE,aAAa,GAAG,IAAI,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtB,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;gBAC7G,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;YACtB,CAAC,EAAE,gBAAgB,CAAC,CAAC;YAErB,MAAM,WAAW,GAAG,IAAI,OAAO,CAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBACnD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBACvB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;YACH,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAE5B,MAAM,SAAS,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,IAAI,GAAG,GAAG,EAAE,CAAC;gBACb,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,MAA+B,EAAE,CAAC;oBAChE,IAAI,CAAC,SAAS,EAAE,CAAC;wBAAC,SAAS,GAAG,IAAI,CAAC;wBAAC,IAAI,SAAS,EAAE,CAAC;4BAAC,YAAY,CAAC,SAAS,CAAC,CAAC;4BAAC,SAAS,GAAG,SAAS,CAAC;wBAAC,CAAC;oBAAC,CAAC;oBACxG,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACxB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC9B,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;oBACxB,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;gBACvB,CAAC;gBACD,IAAI,GAAG,CAAC,IAAI,EAAE;oBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChC,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,EAAE,CAAC;YAEL,qEAAqE;YACrE,oEAAoE;YACpE,gEAAgE;YAChE,8DAA8D;YAC9D,6BAA6B;YAC7B,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;iBAClC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,EAAE;gBAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBACpC,OAAO,CAAC;oBACN,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,QAAQ;oBACR,UAAU;oBACV,QAAQ;oBACR,aAAa;oBACb,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;iBAClC,CAAC,CAAC;YACL,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;gBACT,+DAA+D;gBAC/D,8DAA8D;gBAC9D,8DAA8D;gBAC9D,iEAAiE;gBACjE,mDAAmD;gBACnD,IAAI,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;gBAC3D,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE;gBACZ,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,SAAS;oBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;gBACvC,IAAI,SAAS;oBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/orgrt/qwen-runner.d.ts

@@ -0,0 +1,18 @@
+import type { AgentRunner, AgentRunArgs, AgentMessage } from './agent-runner.js';
+/** Pure stream-json parser — exported for unit testing against fixture lines
+ *  built from Qwen Code's documented event schema (qwen-runner.test.ts). */
+export declare function parseQwenEvents(lines: string[]): {
+    texts: string[];
+    rawTexts: string[];
+    sessionId?: string;
+    inputTokens: number;
+    outputTokens: number;
+    error?: string;
+};
+export declare class QwenAgentRunner implements AgentRunner {
+    private qwenBin?;
+    constructor(qwenBin?: string | undefined);
+    run(args: AgentRunArgs): AsyncIterable<AgentMessage>;
+    private runTurn;
+}
+//# sourceMappingURL=qwen-runner.d.ts.map

package/dist/src/orgrt/qwen-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen-runner.d.ts","sourceRoot":"","sources":["../../../src/orgrt/qwen-runner.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAqCjF;4EAC4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACpH,CAqCA;AAED,qBAAa,eAAgB,YAAW,WAAW;IACrC,OAAO,CAAC,OAAO,CAAC;IAA5B,YAAoB,OAAO,CAAC,EAAE,MAAM,YAAA,EAAI;IAEjC,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC,CAsF1D;IAED,OAAO,CAAC,OAAO;CAgGhB"}

package/dist/src/orgrt/qwen-runner.js

@@ -0,0 +1,267 @@
+// packages/@monomind/cli/src/orgrt/qwen-runner.ts
+/**
+ * QwenAgentRunner — AgentRunner impl backed by the Qwen Code CLI (`qwen`,
+ * https://qwenlm.github.io/qwen-code-docs/).
+ *
+ * Architectural pattern: SAME as CodexAgentRunner/GrokAgentRunner — spawn the
+ * vendor's CLI binary, parse its stream-json output, normalize to
+ * AgentMessage. No SDK dependency.
+ *
+ * Auth: inherited from the CLI's own login flow. No env vars set here.
+ *
+ * Org tools — FENCE PROTOCOL: same approach as the other subprocess runners
+ * (see tool-fence.ts).
+ *
+ * Subprocess protocol — per Qwen Code's public "Headless Mode" docs, NOT
+ * byte-verified against a running binary:
+ *   - Invocation: `qwen -p "<prompt>" --output-format stream-json --yolo
+ *                 [-m <model>] [--resume <sessionId> | --continue]`
+ *   - stream-json emits one JSON object per line; documented shape:
+ *       { type: 'system'|'assistant'|'result', subtype, uuid, session_id,
+ *         role: 'assistant',
+ *         message: { content: [{type:'text', text}], usage: { tokens: { input, output, total } } } }
+ *   - Session continuity: `--resume [sessionId]` resumes a specific session,
+ *     `--continue` resumes the most recent one; `session_id` is carried on
+ *     every event.
+ *   - `--yolo` auto-approves tool actions (org roles gate tool execution
+ *     themselves via canUseTool/tool-fence, so CLI-level approval prompts
+ *     would otherwise hang a non-interactive run).
+ */
+import { spawn } from 'node:child_process';
+import { buildToolProtocol, parseToolCalls, executeToolCall, formatToolResults, MAX_TOOL_ROUNDS, TOOL_CALL_RE } from './tool-fence.js';
+const TURN_TIMEOUT_MS = 2 * 60 * 60 * 1000;
+/** Distinct from TURN_TIMEOUT_MS: catches a hung first-run interactive prompt
+ *  (trust/telemetry gate) fast instead of waiting out the full turn timeout.
+ *  Fires only if the process has produced ZERO stdout by this point — any
+ *  output at all disarms it, since a slow model response is not a hang. */
+const STARTUP_GRACE_MS = 45_000;
+/** Pure stream-json parser — exported for unit testing against fixture lines
+ *  built from Qwen Code's documented event schema (qwen-runner.test.ts). */
+export function parseQwenEvents(lines) {
+    const rawTexts = [];
+    let sessionId;
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let error;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || !trimmed.startsWith('{'))
+            continue;
+        let ev;
+        try {
+            ev = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (ev.session_id)
+            sessionId = ev.session_id;
+        if (ev.type === 'assistant' && ev.message?.content) {
+            const text = ev.message.content
+                .filter((b) => b.type === 'text' && typeof b.text === 'string')
+                .map((b) => b.text)
+                .join('\n');
+            if (text)
+                rawTexts.push(text);
+        }
+        if (ev.type === 'result') {
+            const tokens = ev.message?.usage?.tokens;
+            if (tokens) {
+                inputTokens = tokens.input ?? 0;
+                outputTokens = tokens.output ?? 0;
+            }
+            if (ev.subtype === 'error') {
+                error = typeof ev.error === 'string' ? ev.error : ev.error?.message ?? 'qwen result: error';
+            }
+        }
+    }
+    const texts = rawTexts.map((t) => t.replace(TOOL_CALL_RE, '').trim());
+    return { texts, rawTexts, sessionId, inputTokens, outputTokens, error };
+}
+export class QwenAgentRunner {
+    qwenBin;
+    constructor(qwenBin) {
+        this.qwenBin = qwenBin;
+    }
+    async *run(args) {
+        const bin = this.qwenBin || process.env.QWEN_CLI_BIN || 'qwen';
+        let sessionId = args.resume;
+        try {
+            for await (const p of args.prompt) {
+                const text = typeof p === 'string' ? p : (p?.message?.content ?? String(p ?? ''));
+                let nextPrompt = text;
+                let turnInputTokens = 0;
+                let turnOutputTokens = 0;
+                for (let round = 0; round <= MAX_TOOL_ROUNDS; round++) {
+                    // Gated on !sessionId alone, NOT `round === 0 && !sessionId` — if
+                    // a session id never gets parsed out of qwen's output, every
+                    // round after the first would otherwise spawn a completely
+                    // fresh, contextless qwen invocation carrying only the tool-
+                    // result text. Once a session id IS captured, --resume takes
+                    // over and this stops re-sending the system prompt.
+                    const promptWithSystem = !sessionId
+                        ? `${args.systemPrompt}${buildToolProtocol(args.tools)}\n\n---\n\n${nextPrompt}`
+                        : nextPrompt;
+                    const outcome = await this.runTurn(bin, promptWithSystem, sessionId, args);
+                    if (outcome.sessionId)
+                        sessionId = outcome.sessionId;
+                    if (outcome.hangSuspected) {
+                        throw new Error(`QwenAgentRunner: qwen produced no output within ${STARTUP_GRACE_MS / 1000}s and was killed. ` +
+                            'This usually means it is stuck on a first-run interactive prompt (trust/telemetry gate) ' +
+                            'that headless mode has no way to answer. Run `qwen` once manually in a real terminal in ' +
+                            `this project to accept any prompts, then retry.${outcome.stderrTail ? `\nstderr: ${outcome.stderrTail.slice(-500)}` : ''}`);
+                    }
+                    if (outcome.exitCode !== 0 || outcome.error) {
+                        throw new Error(`QwenAgentRunner: qwen failed (exit ${outcome.exitCode})` +
+                            (outcome.timedOut ? ` — killed after exceeding the ${TURN_TIMEOUT_MS / 3_600_000}h turn timeout` : '') +
+                            (outcome.error ? `: ${outcome.error}` : '') +
+                            (outcome.stderrTail ? `\nstderr: ${outcome.stderrTail.slice(-500)}` : ''));
+                    }
+                    for (const t of outcome.texts) {
+                        if (t.trim())
+                            yield { type: 'assistant', session_id: sessionId, text: t };
+                    }
+                    turnInputTokens += outcome.inputTokens;
+                    turnOutputTokens += outcome.outputTokens;
+                    const malformed = [];
+                    const calls = parseToolCalls(outcome.rawTexts, (raw, err) => malformed.push(`[monomind] ignored malformed tool_call fence (${err}): ${raw.slice(0, 200)}`));
+                    for (const note of malformed)
+                        yield { type: 'assistant', session_id: sessionId, text: note };
+                    if (calls.length === 0)
+                        break;
+                    if (round === MAX_TOOL_ROUNDS) {
+                        yield {
+                            type: 'assistant', session_id: sessionId,
+                            text: `[monomind] tool-call round cap (${MAX_TOOL_ROUNDS}) reached — dropping ${calls.length} pending tool call(s)`,
+                        };
+                        break;
+                    }
+                    const results = [];
+                    for (const call of calls)
+                        results.push(await executeToolCall(args.tools, call, args.canUseTool));
+                    nextPrompt = formatToolResults(calls, results);
+                }
+                yield {
+                    type: 'result',
+                    session_id: sessionId,
+                    subtype: 'success',
+                    input_tokens: turnInputTokens,
+                    output_tokens: turnOutputTokens,
+                };
+            }
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error('QwenAgentRunner requires the Qwen Code CLI (qwen) on PATH. ' +
+                    'Install it: npm install -g @qwen-code/qwen-code, then run `qwen` once ' +
+                    'to authenticate. Or unset the runtime to use Claude.');
+            }
+            throw err;
+        }
+    }
+    runTurn(bin, prompt, sessionId, args) {
+        return new Promise((resolve, reject) => {
+            const cliArgs = ['-p', prompt, '--output-format', 'stream-json', '--yolo'];
+            if (args.model)
+                cliArgs.push('-m', args.model);
+            if (sessionId)
+                cliArgs.push('--resume', sessionId);
+            const child = spawn(bin, cliArgs, {
+                cwd: args.cwd,
+                env: { ...process.env, ...args.env },
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stderrTail = '';
+            child.stderr?.on('data', (c) => { stderrTail = (stderrTail + c.toString()).slice(-4000); });
+            let sawOutput = false;
+            let timedOut = false;
+            let hangSuspected = false;
+            const KILL_GRACE_MS = 5000;
+            let killTimer;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+                killTimer = setTimeout(() => { try {
+                    child.kill('SIGKILL');
+                }
+                catch { /* already gone */ } }, KILL_GRACE_MS);
+                killTimer.unref?.();
+            }, TURN_TIMEOUT_MS);
+            // See STARTUP_GRACE_MS — disarmed by the first stdout chunk below.
+            let hangTimer = setTimeout(() => {
+                hangSuspected = true;
+                child.kill('SIGTERM');
+                killTimer = setTimeout(() => { try {
+                    child.kill('SIGKILL');
+                }
+                catch { /* already gone */ } }, KILL_GRACE_MS);
+                killTimer.unref?.();
+            }, STARTUP_GRACE_MS);
+            const exitPromise = new Promise((res, rej) => {
+                child.on('error', rej);
+                child.on('close', (code) => res(code ?? 1));
+            });
+            exitPromise.catch(() => { });
+            const readLines = (async () => {
+                const lines = [];
+                let buf = '';
+                for await (const chunk of child.stdout) {
+                    if (!sawOutput) {
+                        sawOutput = true;
+                        if (hangTimer) {
+                            clearTimeout(hangTimer);
+                            hangTimer = undefined;
+                        }
+                    }
+                    buf += chunk.toString();
+                    const parts = buf.split('\n');
+                    buf = parts.pop() ?? '';
+                    lines.push(...parts);
+                }
+                if (buf.trim())
+                    lines.push(buf);
+                return lines;
+            })();
+            // Timer cleanup lives in a top-level .finally() (not nested inside a
+            // success-path .then()) so it runs on EITHER path — a stdout stream
+            // error would otherwise skip straight to reject() and leave the
+            // TURN_TIMEOUT_MS/hangTimer/killTimer timers running past the
+            // process's actual lifetime.
+            Promise.all([readLines, exitPromise])
+                .then(([lines, exitCode]) => {
+                const parsed = parseQwenEvents(lines);
+                resolve({
+                    texts: parsed.texts,
+                    rawTexts: parsed.rawTexts,
+                    sessionId: parsed.sessionId ?? sessionId,
+                    exitCode,
+                    stderrTail,
+                    timedOut,
+                    hangSuspected,
+                    inputTokens: parsed.inputTokens,
+                    outputTokens: parsed.outputTokens,
+                    error: parsed.error,
+                });
+            }, (err) => {
+                // A stdout stream error (the reject path) means the process is
+                // still ALIVE and unmanaged — none of the timeout/hang timers
+                // would have fired to kill it. Without this, that error would
+                // orphan the child. child.kill() on an already-dead process is a
+                // documented no-op, so this is safe on every path.
+                try {
+                    child.kill('SIGTERM');
+                }
+                catch { /* already gone */ }
+                reject(err);
+            })
+                .finally(() => {
+                clearTimeout(timer);
+                if (hangTimer)
+                    clearTimeout(hangTimer);
+                if (killTimer)
+                    clearTimeout(killTimer);
+            });
+        });
+    }
+}
+//# sourceMappingURL=qwen-runner.js.map

package/dist/src/orgrt/qwen-runner.js.map

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

package/dist/src/orgrt/session.js

@@ -480,7 +480,7 @@ export function buildOrgTools(opts) {
     if (opts.onComplete) {
         tools.push({
             name: 'org_complete',
-            description: 'Record the outcome of this run. Call exactly once, when the goal is achieved or clearly cannot be. This ends the run: check org_tasks first — siblings with in-progress work only get a short drain window to finish before being cut off, so do not call this while others are still mid-build or mid-edit unless the run genuinely cannot continue. The outcome and summary are persisted to the org run history and briefed to the next run.',
+            description: '⚠️ Ends the run — every agent session shuts down after this. Call exactly once, and only against the org\'s actual, full stated goal (see your briefing), never against just the current batch of dispatched tasks. "achieved" means the WHOLE goal is done, not "everyone assigned so far finished their piece" — a multi-phase or open-ended goal is very rarely achieved in a single run. If the current task batch is clearly done but the goal has more scope left: do NOT call this — use org_task/createTask to dispatch the next phase\'s work instead, so the org keeps making progress instead of stopping short. Use outcome "partial" only when you are ending the run with real scope still remaining (e.g. a genuine external stopping point, not merely "out of tasks right now"); "achieved" only when the full goal is met; "failed" only when it clearly cannot be. Before calling, check org_tasks — siblings with in-progress work only get a short drain window to finish before being cut off, so do not call this while others are still mid-build or mid-edit unless the run genuinely cannot continue. The outcome and summary are persisted to the org run history and briefed to the next run.',
             schema: { outcome: z.enum(['achieved', 'partial', 'failed']), summary: z.string() },
             handler: async (args) => {
                 opts.onComplete(role.id, args.outcome, args.summary);