@a1hvdy/cc-openclaw 0.3.2

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

@@ -0,0 +1,242 @@
+/**
+ * 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';
+import { getCursorBin } from '../lib/config.js';
+// ─── PersistentCursorSession ────────────────────────────────────────────────
+export class PersistentCursorSession extends BaseOneShotSession {
+    _currentRl = null;
+    constructor(config, cursorBin) {
+        super(config, cursorBin || getCursorBin() || '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/engines/persistent-cursor-session.js.map

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

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

@@ -0,0 +1,79 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=persistent-custom-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-custom-session.d.ts","sourceRoot":"","sources":["../../../src/engines/persistent-custom-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAEhB,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EACf,KAAK,aAAa,EAGnB,MAAM,aAAa,CAAC;AA8DrB,qBAAa,uBAAwB,SAAQ,YAAa,YAAW,QAAQ;IAC3E,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAA2B;IAG3C,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,GAAG,CAAmC;IAC9C,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,iBAAiB,CAAS;IAGlC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,UAAU,CAAmC;IAGrD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAA6D;IAEtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,MAAM,CASZ;gBAEU,MAAM,EAAE,aAAa;IAcjC,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IACD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAIK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,gBAAgB;YAwJhB,aAAa;IAYrB,IAAI,CACR,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,UAAU,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;YAY/C,eAAe;YA6Cf,YAAY;YAoBZ,WAAW;IAyJzB,OAAO,CAAC,sBAAsB;IA2I9B,OAAO,CAAC,mBAAmB;IAkG3B,OAAO,CAAC,oBAAoB;IAwF5B,QAAQ,IAAI,YAAY,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAsBjE,UAAU,CAAC,KAAK,SAAwB,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAI1F,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAY3F,SAAS,IAAI,WAAW;IAGxB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAInC,OAAO,IAAI,aAAa;IAmBxB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAInC,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAKd,IAAI,IAAI,IAAI;IA8DZ,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,WAAW;CASpB"}