@enderfga/claw-orchestrator 3.0.0

package/dist/src/persistent-codex-session.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Persistent Codex Session — wraps OpenAI `codex` CLI
+ *
+ * Unlike Claude Code, Codex does not maintain a persistent subprocess with
+ * streaming JSON I/O.  Each send() spawns a new `codex` process in
+ * `--sandbox workspace-write` mode (the modern replacement for the deprecated
+ * `--full-auto` flag) with `--json` to get line-delimited JSON events.
+ *
+ * The "session" is persistent in the sense that:
+ *   - Working directory (cwd) carries accumulated code changes across sends
+ *   - Stats, history, and cost are tracked continuously
+ *   - The `thread_id` from the first send is captured and reused via
+ *     `codex exec resume <id>` for subsequent sends, giving the model real
+ *     conversation continuity (Codex 0.119+).
+ */
+import type { SessionConfig, SessionSendOptions, TurnResult } from './types.js';
+import { BaseOneShotSession } from './base-oneshot-session.js';
+export declare class PersistentCodexSession extends BaseOneShotSession {
+    /**
+     * Captured from the first `thread.started` event. Each subsequent send()
+     * issues `codex exec resume <id>` so the model sees prior turns.
+     */
+    private codexThreadId?;
+    constructor(config: SessionConfig, codexBin?: string);
+    /** Expose the captured thread ID for the codex_resume tool and stats overlay. */
+    get threadId(): string | undefined;
+    /**
+     * Build the Codex spawn args for this turn.
+     *
+     * First turn:    `codex exec [--sandbox W] --skip-git-repo-check --json --model M -C cwd <msg>`
+     * Resume turns:  `codex exec resume <thread_id> [--sandbox W] --skip-git-repo-check --json --model M -C cwd <msg>`
+     */
+    private _buildArgs;
+    protected _run(message: string, options: SessionSendOptions): Promise<TurnResult>;
+    /** Override getStats to expose the captured thread ID. */
+    getStats(): ReturnType<BaseOneShotSession['getStats']>;
+}

package/dist/src/persistent-codex-session.js

@@ -0,0 +1,208 @@
+/**
+ * Persistent Codex Session — wraps OpenAI `codex` CLI
+ *
+ * Unlike Claude Code, Codex does not maintain a persistent subprocess with
+ * streaming JSON I/O.  Each send() spawns a new `codex` process in
+ * `--sandbox workspace-write` mode (the modern replacement for the deprecated
+ * `--full-auto` flag) with `--json` to get line-delimited JSON events.
+ *
+ * The "session" is persistent in the sense that:
+ *   - Working directory (cwd) carries accumulated code changes across sends
+ *   - Stats, history, and cost are tracked continuously
+ *   - The `thread_id` from the first send is captured and reused via
+ *     `codex exec resume <id>` for subsequent sends, giving the model real
+ *     conversation continuity (Codex 0.119+).
+ */
+import { spawn } from 'node:child_process';
+import { SESSION_EVENT } from './constants.js';
+import { BaseOneShotSession } from './base-oneshot-session.js';
+// ─── PersistentCodexSession ─────────────────────────────────────────────────
+export class PersistentCodexSession extends BaseOneShotSession {
+    /**
+     * Captured from the first `thread.started` event. Each subsequent send()
+     * issues `codex exec resume <id>` so the model sees prior turns.
+     */
+    codexThreadId;
+    constructor(config, codexBin) {
+        super(config, codexBin || process.env.CODEX_BIN || 'codex', {
+            enginePrefix: 'codex',
+            defaultModel: 'gpt-5.5',
+            supportsCachedTokens: true,
+            engineDisplayName: 'Codex',
+        });
+    }
+    /** Expose the captured thread ID for the codex_resume tool and stats overlay. */
+    get threadId() {
+        return this.codexThreadId;
+    }
+    /**
+     * Build the Codex spawn args for this turn.
+     *
+     * First turn:    `codex exec [--sandbox W] --skip-git-repo-check --json --model M -C cwd <msg>`
+     * Resume turns:  `codex exec resume <thread_id> [--sandbox W] --skip-git-repo-check --json --model M -C cwd <msg>`
+     */
+    _buildArgs(message) {
+        const args = ['exec'];
+        const isResume = !!this.codexThreadId;
+        if (isResume) {
+            // `codex exec resume` rejects --sandbox and -C; the sandbox policy and
+            // cwd are inherited from the original session (verified empirically
+            // against codex 0.128.0 — passing --sandbox here errors with
+            // "unexpected argument").
+            args.push('resume', this.codexThreadId, '--skip-git-repo-check', '--json');
+        }
+        else {
+            const sandbox = this.options.sandboxMode || 'workspace-write';
+            args.push('--sandbox', sandbox, '--skip-git-repo-check', '--json');
+            if (this.options.cwd)
+                args.push('-C', this.options.cwd);
+        }
+        if (this.options.model)
+            args.push('--model', this.options.model);
+        args.push(message);
+        return args;
+    }
+    _run(message, options) {
+        const args = this._buildArgs(message);
+        const timeout = options.timeout || 300_000;
+        return new Promise((resolve, reject) => {
+            let stdoutBuf = '';
+            let stderr = '';
+            let assistantText = '';
+            let lastUsage;
+            let settled = false;
+            const proc = spawn(this.engineBin, args, {
+                cwd: this.options.cwd,
+                env: { ...process.env },
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            this.currentProc = proc;
+            const timer = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    proc.kill('SIGTERM');
+                    reject(new Error('Timeout waiting for Codex response'));
+                }
+            }, timeout);
+            const handleEvent = (line) => {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    return;
+                let event;
+                try {
+                    event = JSON.parse(trimmed);
+                }
+                catch {
+                    // Not JSON — log it (could be a stray Codex banner or warning).
+                    this.emit(SESSION_EVENT.LOG, `[codex-stdout] ${trimmed}`);
+                    return;
+                }
+                const ev = event;
+                switch (ev.type) {
+                    case 'thread.started': {
+                        const t = event;
+                        if (t.thread_id && !this.codexThreadId) {
+                            this.codexThreadId = t.thread_id;
+                        }
+                        break;
+                    }
+                    case 'item.completed': {
+                        const it = event;
+                        if (it.item?.type === 'agent_message' && typeof it.item.text === 'string') {
+                            const chunk = it.item.text;
+                            assistantText += chunk;
+                            try {
+                                options.callbacks?.onText?.(chunk);
+                            }
+                            catch {
+                                // User callback errors are not fatal.
+                            }
+                            this.emit(SESSION_EVENT.TEXT, chunk);
+                        }
+                        else {
+                            // Tool-call items (command, apply_patch, mcp_tool_call) — surface as tool events.
+                            try {
+                                options.callbacks?.onToolUse?.(event);
+                            }
+                            catch {
+                                // Same swallow rule.
+                            }
+                            this.emit(SESSION_EVENT.LOG, `[codex-tool] ${trimmed}`);
+                        }
+                        break;
+                    }
+                    case 'turn.completed': {
+                        const tc = event;
+                        if (tc.usage)
+                            lastUsage = tc.usage;
+                        break;
+                    }
+                    default:
+                        // Unhandled event types still go to the log so users can debug.
+                        this.emit(SESSION_EVENT.LOG, `[codex-event] ${trimmed}`);
+                }
+            };
+            proc.stdout?.on('data', (data) => {
+                stdoutBuf += data.toString();
+                let nl;
+                while ((nl = stdoutBuf.indexOf('\n')) >= 0) {
+                    const line = stdoutBuf.slice(0, nl);
+                    stdoutBuf = stdoutBuf.slice(nl + 1);
+                    handleEvent(line);
+                }
+            });
+            proc.stderr?.on('data', (data) => {
+                stderr += data.toString();
+                this.emit(SESSION_EVENT.LOG, `[codex-stderr] ${data.toString()}`);
+            });
+            proc.on('close', (code) => {
+                clearTimeout(timer);
+                this.currentProc = null;
+                if (settled)
+                    return;
+                settled = true;
+                // Drain any final partial line as an event attempt.
+                if (stdoutBuf.trim())
+                    handleEvent(stdoutBuf);
+                this._recordTurnComplete();
+                // Real usage from `turn.completed`. Falls back to zero rather than
+                // estimated tokens — better to have an honest "0" than a guess that
+                // misleads cost reporting.
+                if (lastUsage) {
+                    this._stats.tokensIn += lastUsage.input_tokens ?? 0;
+                    this._stats.tokensOut += (lastUsage.output_tokens ?? 0) + (lastUsage.reasoning_output_tokens ?? 0);
+                    this._stats.cachedTokens += lastUsage.cached_input_tokens ?? 0;
+                }
+                this._updateCost();
+                this._addHistory({ text: assistantText, code });
+                const event = {
+                    type: 'result',
+                    result: assistantText,
+                    stop_reason: code === 0 ? 'end_turn' : 'error',
+                    session_id: this.codexThreadId,
+                };
+                this.emit(SESSION_EVENT.RESULT, event);
+                this.emit(SESSION_EVENT.TURN_COMPLETE, event);
+                if (code !== 0) {
+                    reject(new Error(stderr || `Codex exited with code ${code}`));
+                }
+                else {
+                    resolve({ text: assistantText, event });
+                }
+            });
+            proc.on('error', (err) => {
+                clearTimeout(timer);
+                if (!settled) {
+                    settled = true;
+                    reject(err);
+                }
+            });
+        });
+    }
+    /** Override getStats to expose the captured thread ID. */
+    getStats() {
+        const base = super.getStats();
+        return { ...base, codexThreadId: this.codexThreadId };
+    }
+}
+//# sourceMappingURL=persistent-codex-session.js.map

package/dist/src/persistent-codex-session.js.map

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

package/dist/src/persistent-cursor-session.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Persistent Cursor Session — wraps `cursor-agent` CLI
+ *
+ * Like Codex/Gemini, each send() spawns a new `cursor-agent` process in
+ * headless print mode. Cursor CLI supports `--output-format stream-json`
+ * which provides NDJSON events similar to Gemini's stream protocol.
+ *
+ * The "session" is persistent in the same sense as Codex:
+ *   - Working directory carries accumulated code changes across sends
+ *   - Stats, history, and cost are tracked continuously
+ *   - Consistent lifecycle semantics (start/stop/pause/resume)
+ */
+import type { SessionConfig, SessionSendOptions, TurnResult } from './types.js';
+import { BaseOneShotSession } from './base-oneshot-session.js';
+export declare class PersistentCursorSession extends BaseOneShotSession {
+    private _currentRl;
+    constructor(config: SessionConfig, cursorBin?: string);
+    protected _cleanupProc(): void;
+    protected _run(message: string, options: SessionSendOptions): Promise<TurnResult>;
+    private _handleStreamEvent;
+}

package/dist/src/persistent-cursor-session.js

@@ -0,0 +1,241 @@
+/**
+ * Persistent Cursor Session — wraps `cursor-agent` CLI
+ *
+ * Like Codex/Gemini, each send() spawns a new `cursor-agent` process in
+ * headless print mode. Cursor CLI supports `--output-format stream-json`
+ * which provides NDJSON events similar to Gemini's stream protocol.
+ *
+ * The "session" is persistent in the same sense as Codex:
+ *   - Working directory carries accumulated code changes across sends
+ *   - Stats, history, and cost are tracked continuously
+ *   - Consistent lifecycle semantics (start/stop/pause/resume)
+ */
+import { spawn } from 'node:child_process';
+import * as readline from 'node:readline';
+import { estimateTokens } from './models.js';
+import { SESSION_EVENT } from './constants.js';
+import { BaseOneShotSession } from './base-oneshot-session.js';
+// ─── PersistentCursorSession ────────────────────────────────────────────────
+export class PersistentCursorSession extends BaseOneShotSession {
+    _currentRl = null;
+    constructor(config, cursorBin) {
+        super(config, cursorBin || process.env.CURSOR_BIN || 'agent', {
+            enginePrefix: 'cursor',
+            defaultModel: 'claude-sonnet-4-6',
+            defaultModelDisplay: 'cursor-default',
+            supportsCachedTokens: true,
+            engineDisplayName: 'Cursor',
+        });
+    }
+    _cleanupProc() {
+        if (this._currentRl) {
+            this._currentRl.close();
+            this._currentRl = null;
+        }
+        if (this.currentProc) {
+            this.currentProc.stdin?.end();
+            this.currentProc.stdout?.destroy();
+            this.currentProc.stderr?.destroy();
+        }
+        super._cleanupProc();
+    }
+    _run(message, options) {
+        // agent -p <prompt> --force --trust --output-format stream-json
+        const args = ['-p', message, '--force', '--trust', '--output-format', 'stream-json'];
+        if (this.options.model)
+            args.push('--model', this.options.model);
+        // Workspace directory (prefer --workspace over cwd for explicit path)
+        if (this.options.cwd)
+            args.push('--workspace', this.options.cwd);
+        const timeout = options.timeout || 300_000;
+        return new Promise((resolve, reject) => {
+            const resultText = { value: '' };
+            let stderr = '';
+            let settled = false;
+            let gotUsageFromEvents = false;
+            const proc = spawn(this.engineBin, args, {
+                cwd: this.options.cwd,
+                env: { ...process.env },
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            this.currentProc = proc;
+            const timer = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    proc.kill('SIGTERM');
+                    reject(new Error('Timeout waiting for Cursor response'));
+                }
+            }, timeout);
+            // Parse stream-json output line by line
+            const rl = readline.createInterface({ input: proc.stdout, crlfDelay: Infinity });
+            this._currentRl = rl;
+            rl.on('line', (line) => {
+                if (!line.trim())
+                    return;
+                try {
+                    const event = JSON.parse(line);
+                    this._handleStreamEvent(event, options, resultText, () => {
+                        gotUsageFromEvents = true;
+                    });
+                }
+                catch {
+                    // Non-JSON line — treat as plain text
+                    resultText.value += line + '\n';
+                    try {
+                        options.callbacks?.onText?.(line + '\n');
+                    }
+                    catch {
+                        // User callback error
+                    }
+                    this.emit(SESSION_EVENT.TEXT, line + '\n');
+                }
+            });
+            proc.stderr?.on('data', (data) => {
+                const sanitized = data
+                    .toString()
+                    .replace(/CURSOR_API_KEY=[^\s]+/g, 'CURSOR_API_KEY=***')
+                    .replace(/Bearer [a-zA-Z0-9_-]+/g, 'Bearer ***');
+                stderr += sanitized;
+                this.emit(SESSION_EVENT.LOG, `[cursor-stderr] ${sanitized}`);
+            });
+            proc.on('close', (code) => {
+                clearTimeout(timer);
+                this.currentProc = null;
+                if (this._currentRl) {
+                    this._currentRl.close();
+                    this._currentRl = null;
+                }
+                if (settled)
+                    return;
+                settled = true;
+                this._recordTurnComplete();
+                // Fallback: estimate tokens if stream events didn't provide usage
+                if (!gotUsageFromEvents && resultText.value.length > 0) {
+                    this._stats.tokensIn += estimateTokens(message);
+                    this._stats.tokensOut += estimateTokens(resultText.value);
+                    this._updateCost();
+                }
+                this._addHistory({ text: resultText.value, code });
+                const event = {
+                    type: 'result',
+                    result: resultText.value,
+                    stop_reason: code === 0 ? 'end_turn' : 'error',
+                };
+                this.emit(SESSION_EVENT.RESULT, event);
+                this.emit(SESSION_EVENT.TURN_COMPLETE, event);
+                if (code !== 0) {
+                    reject(new Error(stderr || `Cursor exited with code ${code}`));
+                }
+                else {
+                    resolve({ text: resultText.value, event });
+                }
+            });
+            proc.on('error', (err) => {
+                clearTimeout(timer);
+                if (!settled) {
+                    settled = true;
+                    reject(err);
+                }
+            });
+        });
+    }
+    // ─── Stream Event Handling ────────────────────────────────────────────
+    _handleStreamEvent(event, options, resultText, markUsageReceived) {
+        const type = event.type;
+        switch (type) {
+            case 'system':
+                // Init event — extract session_id if available
+                if (event.session_id && !this.sessionId?.startsWith('cursor-live-')) {
+                    this.sessionId = `cursor-live-${event.session_id}`;
+                }
+                break;
+            case 'user':
+                // Echo of user prompt — skip
+                break;
+            case 'assistant': {
+                // Cursor format: { type: "assistant", message: { role, content: [{ type, text }] } }
+                const msg = event.message;
+                if (!msg)
+                    break;
+                const contentArr = msg.content;
+                if (contentArr) {
+                    for (const block of contentArr) {
+                        if (block.type === 'text' && block.text) {
+                            resultText.value += block.text;
+                            try {
+                                options.callbacks?.onText?.(block.text);
+                            }
+                            catch {
+                                // User callback error
+                            }
+                            this.emit(SESSION_EVENT.TEXT, block.text);
+                        }
+                    }
+                }
+                break;
+            }
+            // Also support generic "message" format for forward compatibility
+            case 'message': {
+                if (event.role === 'user')
+                    break;
+                const text = event.content || '';
+                if (text) {
+                    resultText.value += text;
+                    try {
+                        options.callbacks?.onText?.(text);
+                    }
+                    catch {
+                        // User callback error
+                    }
+                    this.emit(SESSION_EVENT.TEXT, text);
+                }
+                break;
+            }
+            case 'tool_use':
+                this._stats.toolCalls++;
+                try {
+                    options.callbacks?.onToolUse?.(event);
+                }
+                catch {
+                    // User callback error
+                }
+                this.emit(SESSION_EVENT.TOOL_USE, event);
+                break;
+            case 'tool_result':
+                try {
+                    options.callbacks?.onToolResult?.(event);
+                }
+                catch {
+                    // User callback error
+                }
+                if (event.is_error)
+                    this._stats.toolErrors++;
+                this.emit(SESSION_EVENT.TOOL_RESULT, event);
+                break;
+            case 'result': {
+                // Cursor uses camelCase: inputTokens, outputTokens, cacheReadTokens
+                const usage = event.usage;
+                if (usage) {
+                    this._stats.tokensIn += usage.inputTokens || usage.input_tokens || usage.prompt_tokens || 0;
+                    this._stats.tokensOut += usage.outputTokens || usage.output_tokens || usage.completion_tokens || 0;
+                    const cached = usage.cacheReadTokens || usage.cached_tokens || 0;
+                    if (cached)
+                        this._stats.cachedTokens += cached;
+                    this._updateCost();
+                    markUsageReceived();
+                }
+                // Result text (if not already captured from assistant events)
+                const resultStr = event.result;
+                if (resultStr && !resultText.value)
+                    resultText.value = resultStr;
+                break;
+            }
+            case 'error':
+                this.emit(SESSION_EVENT.LOG, `[cursor-error] ${event.error || JSON.stringify(event)}`);
+                break;
+            default:
+                break;
+        }
+    }
+}
+//# sourceMappingURL=persistent-cursor-session.js.map

package/dist/src/persistent-cursor-session.js.map

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

package/dist/src/persistent-custom-session.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Persistent Custom Session — generic wrapper for any coding agent CLI
+ *
+ * Supports two operating modes based on CustomEngineConfig.persistent:
+ *
+ *   persistent=true  — long-running subprocess with stream-json I/O over
+ *                       stdin/stdout (like Claude Code). Started once, messages
+ *                       sent as JSON lines on stdin.
+ *
+ *   persistent=false — one-shot per send (like Gemini/Codex). Each send()
+ *                      spawns a new process with the message as a CLI argument.
+ *
+ * The config maps OpenClaw session concepts (permission modes, models, etc.)
+ * to the target CLI's flags, so any coding agent with a CLI can be integrated
+ * without writing engine-specific code.
+ */
+import { EventEmitter } from 'node:events';
+import { type SessionConfig, type SessionStats, type EffortLevel, type ISession, type SessionSendOptions, type TurnResult, type CostBreakdown } from './types.js';
+export declare class PersistentCustomSession extends EventEmitter implements ISession {
+    private options;
+    private engineConfig;
+    private engineBin;
+    private sanitize;
+    private proc;
+    private _rl;
+    private _streamCallbacks;
+    private _contextHighFired;
+    private currentProc;
+    private _currentRl;
+    private _isReady;
+    private _isPaused;
+    private _isBusy;
+    private currentRequestId;
+    private _startTime;
+    private _history;
+    sessionId?: string;
+    private _stats;
+    constructor(config: SessionConfig);
+    get pid(): number | undefined;
+    get isReady(): boolean;
+    get isPaused(): boolean;
+    get isBusy(): boolean;
+    start(): Promise<this>;
+    private _startPersistent;
+    private _startOneShot;
+    send(message: string | unknown[], options?: SessionSendOptions): Promise<TurnResult | {
+        requestId: number;
+        sent: boolean;
+    }>;
+    private _sendPersistent;
+    private _sendOneShot;
+    private _runOneShot;
+    private _handlePersistentEvent;
+    private _handleOneShotEvent;
+    private _waitForTurnComplete;
+    getStats(): SessionStats & {
+        sessionId?: string;
+        uptime: number;
+    };
+    getHistory(limit?: number): Array<{
+        time: string;
+        type: string;
+        event: unknown;
+    }>;
+    compact(summary?: string): Promise<TurnResult | {
+        requestId: number;
+        sent: boolean;
+    }>;
+    getEffort(): EffortLevel;
+    setEffort(level: EffortLevel): void;
+    getCost(): CostBreakdown;
+    resolveModel(alias: string): string;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    private _appendPermissionArgs;
+    private _updateCost;
+}