@yu_robotics/remote-cli 1.2.0 → 1.4.0

package/dist/executor/CodexExecutor.d.ts

@@ -0,0 +1,127 @@
+import { DirectoryGuard } from '../security/DirectoryGuard';
+import { IExecutor, ExecuteOptions, ExecuteResult } from './IExecutor';
+export interface CodexExecutorOptions {
+    /** Model passed as -m. Leave unset to use codex's default. */
+    model?: string;
+    /**
+     * Bypass all approvals and the sandbox via
+     * --dangerously-bypass-approvals-and-sandbox. Default: true.
+     */
+    autoApprove?: boolean;
+    initialWorkingDirectory?: string;
+    /** codex binary command. Default: 'codex' */
+    codexCommand?: string;
+    /** Thread ID for per-thread session persistence */
+    threadId?: string;
+    /**
+     * Inactivity timeout: if codex produces no stdout for this long while a
+     * command is in flight, the command fails and the process is killed.
+     * Default: 10 minutes (matches ClaudePersistentExecutor).
+     */
+    inactivityTimeoutMs?: number;
+    /** Grace period before SIGTERM escalates to SIGKILL. Default: 3000ms. */
+    killEscalationMs?: number;
+}
+/**
+ * IExecutor implementation for the OpenAI Codex CLI (`codex`), exec mode.
+ *
+ * Unlike AgyExecutor (one persistent process per conversation), codex exec
+ * is one-shot per command: each execute() spawns
+ *   codex exec --json --skip-git-repo-check [--dangerously-bypass-approvals-and-sandbox] [-m model] "<prompt>"
+ * and resolves when the process exits. Context continuity is achieved by
+ * persisting the thread_id from `thread.started` and passing it to
+ *   codex exec resume --skip-git-repo-check --json ... <thread_id> "<prompt>"
+ * on subsequent commands.
+ *
+ * Caveats (verified against codex-cli 0.153.4):
+ *  - stdin must be ended immediately after spawn — codex reads piped stdin
+ *    to EOF before starting ("Reading additional input from stdin...").
+ *  - `codex exec resume` does NOT accept the --sandbox flag (usage error).
+ *    We only ever pass --dangerously-bypass-approvals-and-sandbox, which is
+ *    accepted on both first run and resume.
+ *  - item type "error" is non-fatal (e.g. model-metadata fallback warnings);
+ *    turn.failed / top-level error events are the fatal ones.
+ *
+ * Note: exec mode accepts text prompts only — image attachments are silently
+ * dropped (with a log line).
+ */
+export declare class CodexExecutor implements IExecutor {
+    private directoryGuard;
+    private currentWorkingDirectory;
+    /** Model for the next spawn. Mutable: setModel() updates it in place. */
+    private model?;
+    private readonly autoApprove;
+    private readonly codexCommand;
+    private readonly threadId?;
+    private proc;
+    private codexThreadId;
+    private sessionFilePath;
+    private commandQueue;
+    private isProcessing;
+    private isDestroyed;
+    private activeCommand;
+    private currentOutputBuffer;
+    private stdoutBuffer;
+    private stderrTail;
+    private decoder;
+    private inactivityTimer;
+    private readonly inactivityTimeoutMs;
+    private readonly killEscalationMs;
+    private attachmentWarningShown;
+    /** Handoff summary from compactWhenFull, wrapped into the next prompt (consumed once). */
+    private pendingContextSeed;
+    constructor(directoryGuard: DirectoryGuard, options?: CodexExecutorOptions);
+    execute(prompt: string, options?: ExecuteOptions): Promise<ExecuteResult>;
+    getCurrentWorkingDirectory(): string;
+    setWorkingDirectory(targetPath: string): Promise<void>;
+    resetContext(): void;
+    abort(): Promise<boolean>;
+    destroy(): Promise<void>;
+    isProcessRunning(): boolean;
+    getSessionId(): string | null;
+    /**
+     * Switch the model for future commands. codex exec is one-shot per command
+     * and takes -m at spawn, so the running command (if any) is undisturbed and
+     * the next spawn picks the new model up. MessageHandler persists the choice
+     * on the thread; ThreadExecutorPool passes it back via the factory.
+     */
+    setModel(model: string, _onStream?: (chunk: string) => void): Promise<ExecuteResult>;
+    /**
+     * Compact via summarize-then-reset. codex has compaction in its interactive
+     * TUI (plus internal auto-compaction at the token limit), but in exec mode
+     * a '/compact' prompt reaches the model as plain text (verified live against
+     * codex-cli 0.153.4). So we:
+     *   1. ask the current thread for a dense handoff summary,
+     *   2. reset the thread,
+     *   3. wrap the summary into the next user prompt (consumed once).
+     * If the summary turn fails (e.g. context already too full), fall back to
+     * a plain reset and say so honestly.
+     */
+    compactWhenFull(onStream?: (chunk: string) => void): Promise<ExecuteResult>;
+    /**
+     * Delete per-thread session state. Only removes OUR stored thread id
+     * mapping — codex's own session store (~/.codex/sessions) is left untouched.
+     */
+    deleteThreadData(_threadId: string): Promise<void>;
+    private processQueue;
+    private executeQueued;
+    private completeActiveCommand;
+    /**
+     * Arm the inactivity watchdog: any stdout line counts as activity. If codex
+     * goes silent mid-command for longer than the limit, fail the command and
+     * kill the process (the thread resumes on the next command).
+     */
+    private armInactivityTimer;
+    private clearInactivityTimer;
+    private spawnProcess;
+    private buildArgs;
+    private killProcess;
+    private handleStdout;
+    private handleLine;
+    private handleItemStarted;
+    private handleItemCompleted;
+    private loadThreadId;
+    private setThreadId;
+    private clearThreadId;
+}
+//# sourceMappingURL=CodexExecutor.d.ts.map

package/dist/executor/CodexExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodexExecutor.d.ts","sourceRoot":"","sources":["../../src/executor/CodexExecutor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGvE,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA0BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,uBAAuB,CAAS;IAExC,yEAAyE;IACzE,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IAEnC,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,mBAAmB,CAAgB;IAC3C,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,sBAAsB,CAAS;IACvC,0FAA0F;IAC1F,OAAO,CAAC,kBAAkB,CAAuB;gBAErC,cAAc,EAAE,cAAc,EAAE,OAAO,GAAE,oBAAyB;IAmCxE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAUnF,0BAA0B,IAAI,MAAM;IAI9B,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5D,YAAY,IAAI,IAAI;IAOd,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAUzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B,gBAAgB,IAAI,OAAO;IAI3B,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAS1F;;;;;;;;;;OAUG;IACG,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IA4BjF;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAO1C,YAAY;IAkB1B,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,qBAAqB;IAe7B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,YAAY;IA0FpB,OAAO,CAAC,SAAS;IA4BjB,OAAO,CAAC,WAAW;IAkCnB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,UAAU;IAwElB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,mBAAmB;IAsF3B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,aAAa;CAUtB"}