@monoes/monomindcli 2.9.21 → 2.9.22

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

@@ -0,0 +1,323 @@
+// packages/@monomind/cli/src/orgrt/grok-runner.ts
+/**
+ * GrokAgentRunner — AgentRunner impl backed by the Grok Build CLI (`grok`,
+ * xAI's agentic coding CLI: https://docs.x.ai/build/cli).
+ *
+ * Architectural pattern: SAME as CodexAgentRunner/KimiCodeAgentRunner — spawn
+ * the vendor's CLI binary, parse its NDJSON stream, normalize to
+ * AgentMessage. No SDK dependency.
+ *
+ * Auth: inherited from the CLI's own login flow (subscription/API key
+ * managed by `grok` itself). No env vars set by this runner.
+ *
+ * Org tools (org_send, knowledge_search, ask_human, …) — FENCE PROTOCOL:
+ *   Same approach as codex/kimi/opencode. Tools are rendered INTO the first
+ *   prompt; the model emits ```tool_call fences; this runner parses them out
+ *   of the assistant text, executes the real OrgToolDef handlers in-process
+ *   (gated through canUseTool), and feeds results back as the next prompt.
+ *
+ * Subprocess protocol — per public docs (docs.x.ai/build/cli/reference), NOT
+ * byte-verified against a running binary (unlike the codex/kimi runners,
+ * which were checked against an installed CLI). The exact NDJSON event field
+ * names for `--format json` were not available at implementation time, so
+ * parseGrokEvents() tolerates several plausible shapes (codex-style
+ * `item.type === 'agent_message'`, a flat `role: 'assistant'` shape, and a
+ * flat `type: 'assistant'`/`'message'` shape) rather than committing to one.
+ * Verify against your installed `grok` version and tighten this parser if
+ * the real shape differs — a wrong guess here fails closed (no text
+ * extracted, not a crash), which is what the "no known shape matched" path
+ * is for.
+ *   - Invocation: `grok -p "<prompt>" --format json [--model X] [--cwd Y]
+ *                 [--always-approve] [-r <sessionId> | -c]`
+ *   - Session continuity: `-r/--resume [<id>]` resumes a specific session,
+ *     `-c/--continue` resumes the most recent one. Session id is captured
+ *     from any event carrying `session_id` / `sessionId` / `thread_id`.
+ *   - stderr is human diagnostics; buffered and surfaced on non-zero exit.
+ */
+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; // 2 hours, matching the other subprocess runners
+/** 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;
+/** Pull a session/thread id out of a parsed event, tolerating the field-name
+ *  variants different CLI versions/backends tend to use. */
+function extractSessionId(ev) {
+    for (const key of ['session_id', 'sessionId', 'thread_id', 'threadId']) {
+        const v = ev[key];
+        if (typeof v === 'string' && v)
+            return v;
+    }
+    return undefined;
+}
+/** Pull assistant-visible text out of a parsed event, tolerating the shape
+ *  variants documented (or plausible) for `grok --format json`:
+ *    - codex-style: { type: 'item.completed', item: { type: 'agent_message', text } }
+ *    - flat role shape: { role: 'assistant', content: '...' | [{type:'text',text}] }
+ *    - flat type shape: { type: 'assistant' | 'message', text: '...' } */
+function extractText(ev) {
+    const item = ev.item;
+    if (item && (item.type === 'agent_message' || item.type === 'message') && typeof item.text === 'string') {
+        return item.text;
+    }
+    if (ev.role === 'assistant') {
+        const content = ev.content;
+        if (typeof content === 'string')
+            return content;
+        if (Array.isArray(content)) {
+            return content
+                .filter((b) => !!b && typeof b === 'object' && b.type === 'text')
+                .map((b) => b.text)
+                .join('\n');
+        }
+    }
+    if ((ev.type === 'assistant' || ev.type === 'message') && typeof ev.text === 'string') {
+        return ev.text;
+    }
+    return undefined;
+}
+/** Pull usage totals out of a parsed event, tolerating openai-ish
+ *  (prompt_tokens/completion_tokens) and codex-ish (input_tokens/output_tokens)
+ *  field names. */
+function extractUsage(ev) {
+    const usage = ev.usage;
+    if (!usage)
+        return undefined;
+    const input = usage.input_tokens ?? usage.prompt_tokens;
+    const output = usage.output_tokens ?? usage.completion_tokens;
+    if (typeof input === 'number' || typeof output === 'number') {
+        return { input: typeof input === 'number' ? input : 0, output: typeof output === 'number' ? output : 0 };
+    }
+    return undefined;
+}
+/** Pure NDJSON parser — exported so it can be unit tested against fixture
+ *  lines without spawning the real CLI (see grok-runner.test.ts). */
+export function parseGrokEvents(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;
+        }
+        const sid = extractSessionId(ev);
+        if (sid)
+            sessionId = sid;
+        const text = extractText(ev);
+        if (text)
+            rawTexts.push(text);
+        const usage = extractUsage(ev);
+        if (usage) {
+            inputTokens = usage.input;
+            outputTokens = usage.output;
+        }
+        if (ev.type === 'error' || ev.type === 'turn.failed') {
+            const errMsg = ev.error?.message ?? ev.message;
+            if (typeof errMsg === 'string')
+                error = errMsg;
+        }
+    }
+    const texts = rawTexts.map((t) => t.replace(TOOL_CALL_RE, '').trim());
+    return { texts, rawTexts, sessionId, inputTokens, outputTokens, error };
+}
+export class GrokAgentRunner {
+    grokBin;
+    constructor(grokBin) {
+        this.grokBin = grokBin;
+    }
+    async *run(args) {
+        const bin = this.grokBin || process.env.GROK_CLI_BIN || 'grok';
+        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 grok's output (a real
+                    // risk, per this file's header: the exact event shape is a
+                    // documented guess), every round after the first would otherwise
+                    // spawn a completely fresh, contextless grok invocation carrying
+                    // only the tool-result text — no system prompt, no session to
+                    // resume. 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(`GrokAgentRunner: grok 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 `grok` 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(`GrokAgentRunner: grok 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('GrokAgentRunner requires the Grok Build CLI (grok) on PATH. ' +
+                    'Install it per https://docs.x.ai/build/cli, then log in. ' +
+                    'Or unset the runtime to use Claude.');
+            }
+            throw err;
+        }
+    }
+    runTurn(bin, prompt, sessionId, args) {
+        return new Promise((resolve, reject) => {
+            const cliArgs = ['-p', prompt, '--format', 'json', '--always-approve'];
+            if (args.model)
+                cliArgs.push('--model', args.model);
+            cliArgs.push('--cwd', args.cwd);
+            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 = parseGrokEvents(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=grok-runner.js.map

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

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

package/dist/src/orgrt/pi-rpc-runner.d.ts

@@ -0,0 +1,68 @@
+import type { AgentRunner, AgentRunArgs, AgentMessage } from './agent-runner.js';
+interface PiContentBlock {
+    type: string;
+    text?: string;
+    thinking?: string;
+    id?: string;
+    name?: string;
+    arguments?: Record<string, unknown>;
+}
+interface PiRpcMessage {
+    content?: PiContentBlock[];
+}
+/** Pure, transport-independent JSONL line decoder — feed it raw string
+ *  chunks, get back every complete parsed object found so far (silently
+ *  skipping malformed lines rather than throwing, matching this repo's
+ *  other subprocess parsers). Exported for unit testing without a real
+ *  subprocess. */
+export declare class JsonlDecoder {
+    private buf;
+    feed(chunk: string): Record<string, unknown>[];
+}
+/** Encode a client→server RPC command as one LF-terminated JSON line.
+ *  Exported for unit testing the exact wire format. */
+export declare function encodePiRpcCommand(cmd: {
+    type: string;
+    message?: string;
+    id?: string;
+}): string;
+/** Extract assistant-visible text and org tool_call fences from a
+ *  message_end event's `message.content` array. `thinking` blocks are
+ *  dropped (internal reasoning, not meant for the bus); `toolCall` blocks
+ *  are pi's own native tool calls, executed autonomously by pi itself —
+ *  this runner never sees their results and doesn't need to. Exported for
+ *  unit testing against fixture content arrays. */
+export declare function extractPiRpcText(message: PiRpcMessage): string;
+/** The subset of a spawned child process this runner needs — narrower than
+ *  node:child_process's real type, and deliberately duck-typed so tests can
+ *  supply a fake implementation (an EventEmitter-backed fake process) to
+ *  exercise the full turn-completion state machine without a real `pi`
+ *  binary. Given the residual protocol-inference risk documented in this
+ *  file's header, testing the orchestration logic itself — not just the
+ *  pure JSONL/extraction helpers — is the point of this seam. */
+export interface PiRpcProcess {
+    stdin: {
+        write(data: string): void;
+    } | null;
+    stdout: {
+        on(event: 'data', cb: (chunk: Buffer) => void): void;
+    } | null;
+    stderr: {
+        on(event: 'data', cb: (chunk: Buffer) => void): void;
+    } | null;
+    on(event: 'close', cb: (code: number | null) => void): void;
+    on(event: 'error', cb: (err: Error) => void): void;
+    kill(signal?: string): void;
+}
+export type SpawnPiRpc = (bin: string, args: string[], opts: {
+    cwd: string;
+    env: Record<string, string | undefined>;
+}) => PiRpcProcess;
+export declare class PiRpcAgentRunner implements AgentRunner {
+    private piBin?;
+    private spawnFn;
+    constructor(piBin?: string | undefined, spawnFn?: SpawnPiRpc);
+    run(args: AgentRunArgs): AsyncIterable<AgentMessage>;
+}
+export {};
+//# sourceMappingURL=pi-rpc-runner.d.ts.map

package/dist/src/orgrt/pi-rpc-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-rpc-runner.d.ts","sourceRoot":"","sources":["../../../src/orgrt/pi-rpc-runner.ts"],"names":[],"mappings":"AA2DA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAUjF,UAAU,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAAE;AAC7I,UAAU,YAAY;IAAG,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;CAAE;AAEtD;;;;kBAIkB;AAClB,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAM;IACjB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAW7C;CACF;AAED;uDACuD;AACvD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE/F;AAED;;;;;mDAKmD;AACnD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAK9D;AAED;;;;;;iEAMiE;AACjE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5C,MAAM,EAAE;QAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,MAAM,EAAE;QAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5D,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CAAE,KAAK,YAAY,CAAC;AAKvI,qBAAa,gBAAiB,YAAW,WAAW;IACtC,OAAO,CAAC,KAAK,CAAC;IAAU,OAAO,CAAC,OAAO;IAAnD,YAAoB,KAAK,CAAC,EAAE,MAAM,YAAA,EAAU,OAAO,GAAE,UAA8B,EAAI;IAEhF,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC,CAqR1D;CACF"}