remodex-cli 1.0.0

package/LICENSE

@@ -0,0 +1,12 @@
+This package is part of the Remodex project.
+
+License: SEE LICENSE IN LICENSE
+
+The governing license for this package is the repository root LICENSE, including
+the Bridge Redistribution Exception that applies to the Bridge Server component.
+
+Repository:
+https://github.com/K9i-0/ccpocket
+
+Root license:
+https://github.com/K9i-0/ccpocket/blob/main/LICENSE

package/README.md

@@ -0,0 +1,105 @@
+# remodex-cli
+
+Bridge server that connects [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) and [Codex CLI](https://github.com/openai/codex) to mobile devices via WebSocket.
+
+This is the server component of [remodex](https://github.com/K9i-0/ccpocket) — a mobile client for Claude Code and Codex.
+
+## Quick Start
+
+```bash
+npx remodex-cli@latest
+```
+
+A QR code will appear in your terminal. Scan it with the remodex mobile app to connect.
+
+> Warning
+> Versions older than `1.25.0` are deprecated and should not be used for new installs due to potential Anthropic policy concerns around OAuth-based usage.
+> Upgrade to `>=1.25.0` and use `ANTHROPIC_API_KEY` instead of OAuth.
+
+## Installation
+
+```bash
+# Run directly (no install needed)
+npx remodex-cli@latest
+
+# Or install globally
+npm install -g remodex-cli
+remodex-cli
+```
+
+## Configuration
+
+| Environment Variable | Default | Description |
+|---------------------|---------|-------------|
+| `BRIDGE_PORT` | `8765` | WebSocket port |
+| `BRIDGE_HOST` | `0.0.0.0` | Bind address |
+| `BRIDGE_API_KEY` | (none) | API key authentication (enabled when set) |
+| `BRIDGE_PUBLIC_WS_URL` | (none) | Public `ws://` / `wss://` URL used for startup deep link and QR code |
+| `BRIDGE_DEMO_MODE` | (none) | Demo mode: hide Tailscale IPs and API key from QR code / logs |
+| `BRIDGE_RECORDING` | (none) | Enable session recording for debugging (enabled when set) |
+| `BRIDGE_DISABLE_MDNS` | (none) | Disable mDNS auto-discovery advertisement (enabled when set) |
+| `HTTPS_PROXY` | (none) | Proxy for outgoing fetch requests (`http://`, `socks5://`) |
+
+```bash
+# Example: custom port with API key
+BRIDGE_PORT=9000 BRIDGE_API_KEY=my-secret npx remodex-cli@latest
+
+# Example: expose Bridge through a reverse proxy / ngrok
+BRIDGE_PUBLIC_WS_URL=wss://example.ngrok-free.app npx remodex-cli@latest
+
+# Example: same setting via CLI flag
+remodex-cli --public-ws-url wss://example.ngrok-free.app
+
+# Example: disable mDNS advertisement
+BRIDGE_DISABLE_MDNS=1 npx remodex-cli@latest
+# or via CLI flag
+remodex-cli --no-mdns
+```
+
+When `BRIDGE_PUBLIC_WS_URL` is set, the startup deep link and terminal QR code
+use that public URL instead of the LAN address. This is useful when the Bridge
+is reachable through a reverse proxy, tunnel, or public domain.
+
+Without it, the printed QR code is LAN-oriented by default and typically encodes
+something like `ws://192.168.x.x:8765`.
+
+## Requirements
+
+- Node.js v18+
+- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) and/or [Codex CLI](https://github.com/openai/codex)
+
+## Health Check
+
+Run the built-in doctor command to verify your environment:
+
+```bash
+npx remodex-cli@latest doctor
+```
+
+It checks Node.js, Git, CLI providers, macOS permissions (Screen Recording, Keychain), network connectivity, and more.
+
+## Architecture
+
+```
+Mobile App ←WebSocket→ Bridge Server ←stdio→ Claude Code CLI
+```
+
+The bridge server spawns and manages Claude Code CLI processes, translating WebSocket messages to/from the CLI's stdio interface. It supports multiple concurrent sessions.
+
+## License
+
+This package is governed by the [Remodex license](../../LICENSE).
+
+The repository remains under FSL-1.1-MIT, with a specific Bridge Redistribution
+Exception that allows unofficial redistribution of the Bridge Server, including
+environment-specific builds and forks for Windows, WSL, proxy-restricted, or
+other hard-to-validate environments.
+
+If you redistribute this package or a modified fork:
+
+- do not imply it is official, endorsed, or supported by the Remodex maintainer
+- preserve the license text and clearly state that the software is provided "AS IS"
+- make clear that compliance with Anthropic, OpenAI, network, enterprise, and other third-party terms is the responsibility of the redistributor and end user
+
+In short: unofficial Bridge redistributions are permitted for compatibility and
+support purposes, but they remain unsupported and at your own risk.

package/dist/archive-store.d.ts

@@ -0,0 +1,28 @@
+export interface ArchivedSession {
+    sessionId: string;
+    provider: "claude" | "codex";
+    projectPath: string;
+    archivedAt: string;
+}
+/**
+ * Manages a persistent set of archived session IDs.
+ * Data is stored in `~/.remodex/archived-sessions.json`.
+ */
+export declare class ArchiveStore {
+    private readonly dirPath;
+    private readonly filePath;
+    /** In-memory cache of archived session IDs for O(1) lookup. */
+    private cache;
+    private data;
+    constructor();
+    /** Initialise the store: create directory if needed and load existing data. */
+    init(): Promise<void>;
+    /** Archive a session. Idempotent – archiving an already-archived session is a no-op. */
+    archive(sessionId: string, provider: "claude" | "codex", projectPath: string): Promise<void>;
+    /** Check whether a session is archived. */
+    isArchived(sessionId: string): boolean;
+    /** Return the full set of archived session IDs (for bulk filtering). */
+    archivedIds(): ReadonlySet<string>;
+    /** Atomic write: write to temp file, then rename. */
+    private save;
+}

package/dist/archive-store.js

@@ -0,0 +1,68 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { randomUUID } from "node:crypto";
+/**
+ * Manages a persistent set of archived session IDs.
+ * Data is stored in `~/.remodex/archived-sessions.json`.
+ */
+export class ArchiveStore {
+    dirPath;
+    filePath;
+    /** In-memory cache of archived session IDs for O(1) lookup. */
+    cache = new Set();
+    data = { version: 1, archivedSessions: [] };
+    constructor() {
+        this.dirPath = join(homedir(), ".remodex");
+        this.filePath = join(this.dirPath, "archived-sessions.json");
+    }
+    /** Initialise the store: create directory if needed and load existing data. */
+    async init() {
+        await mkdir(this.dirPath, { recursive: true });
+        try {
+            const raw = await readFile(this.filePath, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (parsed.version === 1 && Array.isArray(parsed.archivedSessions)) {
+                this.data = parsed;
+                this.cache = new Set(parsed.archivedSessions.map((s) => s.sessionId));
+            }
+        }
+        catch {
+            // File doesn't exist or is corrupted – start fresh.
+            this.data = { version: 1, archivedSessions: [] };
+            this.cache = new Set();
+        }
+        console.log(`[archive-store] Loaded ${this.cache.size} archived session(s)`);
+    }
+    /** Archive a session. Idempotent – archiving an already-archived session is a no-op. */
+    async archive(sessionId, provider, projectPath) {
+        if (this.cache.has(sessionId))
+            return;
+        const entry = {
+            sessionId,
+            provider,
+            projectPath,
+            archivedAt: new Date().toISOString(),
+        };
+        this.data.archivedSessions.push(entry);
+        this.cache.add(sessionId);
+        await this.save();
+        console.log(`[archive-store] Archived session ${sessionId}`);
+    }
+    /** Check whether a session is archived. */
+    isArchived(sessionId) {
+        return this.cache.has(sessionId);
+    }
+    /** Return the full set of archived session IDs (for bulk filtering). */
+    archivedIds() {
+        return this.cache;
+    }
+    // ---- internal ----
+    /** Atomic write: write to temp file, then rename. */
+    async save() {
+        const tmp = join(this.dirPath, `archived-sessions.${randomUUID()}.tmp`);
+        await writeFile(tmp, JSON.stringify(this.data, null, 2), "utf-8");
+        await rename(tmp, this.filePath);
+    }
+}
+//# sourceMappingURL=archive-store.js.map

package/dist/archive-store.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import { setupProxy } from "./proxy.js";
+import { platform } from "node:os";
+import { startServer } from "./index.js";
+// Configure global fetch proxy before any network calls
+setupProxy();
+const args = process.argv.slice(2);
+// Check for subcommand
+const subcommand = args.find((a) => !a.startsWith("-"));
+function parseFlag(name) {
+    const idx = args.indexOf(`--${name}`);
+    if (idx === -1 || idx + 1 >= args.length)
+        return undefined;
+    return args[idx + 1];
+}
+function hasFlag(name) {
+    return args.includes(`--${name}`);
+}
+if (subcommand === "doctor") {
+    // Doctor subcommand: check environment health
+    const jsonOutput = hasFlag("json");
+    import("./doctor.js")
+        .then(({ runDoctor, printReport }) => runDoctor().then((report) => {
+        if (jsonOutput) {
+            console.log(JSON.stringify(report));
+        }
+        else {
+            printReport(report);
+        }
+        process.exit(report.allRequiredPassed ? 0 : 1);
+    }))
+        .catch((err) => {
+        console.error("Doctor failed:", err);
+        process.exit(1);
+    });
+}
+else if (subcommand === "setup") {
+    // Service setup subcommand (platform-specific)
+    const opts = {
+        port: parseFlag("port"),
+        host: parseFlag("host"),
+        apiKey: parseFlag("api-key"),
+        publicWsUrl: parseFlag("public-ws-url"),
+    };
+    if (platform() === "darwin") {
+        import("./setup-launchd.js")
+            .then(({ setupLaunchd, uninstallLaunchd }) => {
+            hasFlag("uninstall") ? uninstallLaunchd() : setupLaunchd(opts);
+        })
+            .catch((err) => {
+            console.error("Setup failed:", err);
+            process.exit(1);
+        });
+    }
+    else if (platform() === "linux") {
+        import("./setup-systemd.js")
+            .then(({ setupSystemd, uninstallSystemd }) => {
+            hasFlag("uninstall") ? uninstallSystemd() : setupSystemd(opts);
+        })
+            .catch((err) => {
+            console.error("Setup failed:", err);
+            process.exit(1);
+        });
+    }
+    else {
+        console.error(`ERROR: 'setup' is not supported on ${platform()}. Supported: macOS (launchd), Linux (systemd).`);
+        process.exit(1);
+    }
+}
+else {
+    // Server mode: set env vars from CLI flags, then start
+    const port = parseFlag("port");
+    const host = parseFlag("host");
+    const apiKey = parseFlag("api-key");
+    const publicWsUrl = parseFlag("public-ws-url");
+    if (port)
+        process.env.BRIDGE_PORT = port;
+    if (host)
+        process.env.BRIDGE_HOST = host;
+    if (apiKey)
+        process.env.BRIDGE_API_KEY = apiKey;
+    if (publicWsUrl)
+        process.env.BRIDGE_PUBLIC_WS_URL = publicWsUrl;
+    if (hasFlag("no-mdns"))
+        process.env.BRIDGE_DISABLE_MDNS = "1";
+    startServer();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,wDAAwD;AACxD,UAAU,EAAE,CAAC;AAEb,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,uBAAuB;AACvB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAExD,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC3D,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;IAC5B,8CAA8C;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,aAAa,CAAC;SAClB,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE,CACnC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAC1B,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CACH;SACA,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC;KAAM,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;IAClC,+CAA+C;IAC/C,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC;QACvB,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC;QAC5B,WAAW,EAAE,SAAS,CAAC,eAAe,CAAC;KACxC,CAAC;IAEF,IAAI,QAAQ,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,CAAC,oBAAoB,CAAC;aACzB,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAAE,EAAE;YAC3C,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;SAAM,IAAI,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;QAClC,MAAM,CAAC,oBAAoB,CAAC;aACzB,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAAE,EAAE;YAC3C,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CACX,sCAAsC,QAAQ,EAAE,gDAAgD,CACjG,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;KAAM,CAAC;IACN,uDAAuD;IACvD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;IAE/C,IAAI,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC;IACzC,IAAI,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC;IACzC,IAAI,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC;IAChD,IAAI,WAAW;QAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,WAAW,CAAC;IAChE,IAAI,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,GAAG,CAAC;IAE9D,WAAW,EAAE,CAAC;AAChB,CAAC"}

package/dist/codex-process.d.ts

@@ -0,0 +1,186 @@
+import { EventEmitter } from "node:events";
+import type { ServerMessage, ProcessStatus } from "./parser.js";
+export interface CodexStartOptions {
+    threadId?: string;
+    approvalPolicy?: "never" | "on-request" | "on-failure" | "untrusted";
+    sandboxMode?: "read-only" | "workspace-write" | "danger-full-access";
+    model?: string;
+    modelReasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh";
+    networkAccessEnabled?: boolean;
+    webSearchMode?: "disabled" | "cached" | "live";
+    collaborationMode?: "plan" | "default";
+}
+export interface CodexProcessEvents {
+    message: [ServerMessage];
+    status: [ProcessStatus];
+    exit: [number | null];
+}
+/** Skill metadata returned by the Codex `skills/list` RPC. */
+export interface CodexSkillMetadata {
+    name: string;
+    path: string;
+    description: string;
+    shortDescription?: string;
+    enabled: boolean;
+    scope: string;
+    displayName?: string;
+    defaultPrompt?: string;
+    brandColor?: string;
+}
+export interface CodexThreadSummary {
+    id: string;
+    preview: string;
+    createdAt: number;
+    updatedAt: number;
+    cwd: string;
+    agentNickname: string | null;
+    agentRole: string | null;
+    gitBranch: string | null;
+    name: string | null;
+}
+export declare function buildCodexSpawnSpec(projectPath: string, platform?: NodeJS.Platform): {
+    command: string;
+    args: string[];
+    options: {
+        cwd: string;
+        stdio: "pipe";
+        env: NodeJS.ProcessEnv;
+        windowsVerbatimArguments?: boolean;
+    };
+};
+export declare class CodexProcess extends EventEmitter<CodexProcessEvents> {
+    private child;
+    private _status;
+    private _threadId;
+    private _agentNickname;
+    private _agentRole;
+    private stopped;
+    private startModel;
+    private inputResolve;
+    private pendingTurnId;
+    private pendingTurnCompletion;
+    private pendingApprovals;
+    private pendingUserInputs;
+    private lastTokenUsage;
+    /** Full skill metadata from the last `skills/list` response. */
+    private _skills;
+    /** Project path stored for re-fetching skills on `skills/changed`. */
+    private _projectPath;
+    /** Expose skill metadata so session/websocket can access it. */
+    get skills(): CodexSkillMetadata[];
+    private rpcSeq;
+    private pendingRpc;
+    private stdoutBuffer;
+    private _approvalPolicy;
+    private _collaborationMode;
+    private lastPlanItemText;
+    /** Last assistant text message — used as `result` in completion notification. */
+    private lastResultText;
+    private pendingPlanCompletion;
+    /** Queued plan execution text when inputResolve wasn't ready at approval time. */
+    private _pendingPlanInput;
+    private readonly platform;
+    constructor(platform?: NodeJS.Platform);
+    get status(): ProcessStatus;
+    get isWaitingForInput(): boolean;
+    private getMessageModel;
+    get sessionId(): string | null;
+    get agentNickname(): string | null;
+    get agentRole(): string | null;
+    get isRunning(): boolean;
+    get approvalPolicy(): string;
+    /**
+     * Update approval policy at runtime.
+     * Takes effect on the next `turn/start` RPC call.
+     */
+    setApprovalPolicy(policy: string): void;
+    /**
+     * Set collaboration mode ("plan" or "default").
+     * Takes effect on the next `turn/start` RPC call.
+     */
+    setCollaborationMode(mode: "plan" | "default"): void;
+    get collaborationMode(): "plan" | "default";
+    /**
+     * Rename a thread via the app-server RPC.
+     * Sends thread/name/set which persists to ~/.codex/session_index.jsonl.
+     */
+    renameThread(name: string): Promise<void>;
+    /**
+     * Archive a Codex thread via the app-server `thread/archive` RPC.
+     * Accepts an explicit threadId so that historical (non-active) sessions
+     * can be archived without requiring a running process.
+     */
+    archiveThread(threadId: string): Promise<void>;
+    listThreads(params?: {
+        limit?: number;
+        cursor?: string | null;
+        cwd?: string;
+        searchTerm?: string;
+    }): Promise<{
+        data: CodexThreadSummary[];
+        nextCursor: string | null;
+    }>;
+    start(projectPath: string, options?: CodexStartOptions): void;
+    initializeOnly(projectPath: string): Promise<void>;
+    stop(): void;
+    private prepareLaunch;
+    private launchAppServer;
+    interrupt(): void;
+    sendInput(text: string): void;
+    sendInputWithImages(text: string, images: Array<{
+        base64: string;
+        mimeType: string;
+    }>): void;
+    sendInputWithSkill(text: string, skill: {
+        name: string;
+        path: string;
+    }): void;
+    approve(toolUseId?: string, _updatedInput?: Record<string, unknown>): void;
+    approveAlways(toolUseId?: string): void;
+    reject(toolUseId?: string, _message?: string): void;
+    answer(toolUseId: string, result: string): void;
+    getPendingPermission(toolUseId?: string): {
+        toolUseId: string;
+        toolName: string;
+        input: Record<string, unknown>;
+    } | undefined;
+    /** Emit a synthetic tool_result so history replay can match it to a permission_request. */
+    private emitToolResult;
+    private resolvePendingApproval;
+    private resolvePendingUserInput;
+    /**
+     * Plan approved → switch to Default mode and auto-start execution.
+     */
+    private handlePlanApproved;
+    /**
+     * Plan rejected → stay in Plan mode and re-plan with feedback.
+     */
+    private handlePlanRejected;
+    private bootstrap;
+    private initializeRpcConnection;
+    /**
+     * Fetch skills from Codex app-server via `skills/list` RPC and emit them
+     * as a `supported_commands` system message so the Flutter client can display
+     * skill entries alongside built-in slash commands.
+     */
+    private fetchSkills;
+    private runInputLoop;
+    private handleStdoutChunk;
+    private handleRpcEnvelope;
+    private handleRpcResponse;
+    private handleServerRequest;
+    private handleNotification;
+    private handleTurnCompleted;
+    private processItemStarted;
+    private processItemCompleted;
+    private toRpcInput;
+    private request;
+    private notify;
+    private respondToServerRequest;
+    private writeEnvelope;
+    private rejectAllPending;
+    private setStatus;
+    private emitMessage;
+    private extractToolUseId;
+    private handleServerRequestResolved;
+}