@gkorepanov/ccodex 0.4.25 → 0.5.0-rc.2

package/dist/claude/peers.js

@@ -0,0 +1,109 @@
+/**
+ * Claude's messages between agents (`SendMessage`; a user record whose `origin.kind` is "peer") shown as stock shows
+ * messages between threads. Best effort throughout: when Claude does not tell where a message came from or went (or
+ * tells it differently in a later version), the message shows without its thread; it never breaks the chat.
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { claudeHome } from "../config.js";
+export const NO_PEERS = {
+    directory: { sender: () => undefined, receiver: () => undefined, has: () => false },
+    children: new Set(),
+};
+function fields(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function text(value) {
+    return typeof value === "string" && value ? value : typeof value === "number" ? String(value) : undefined;
+}
+export function peerOrigin(origin) {
+    const peer = fields(origin);
+    return peer?.kind === "peer" ? peer : undefined;
+}
+/** Claude's registry of running sessions (`~/.claude/sessions/<pid>.json`); an entry goes when its process exits. */
+function runningSession(home, match) {
+    try {
+        const directory = join(home, "sessions");
+        for (const name of readdirSync(directory)) {
+            if (!name.endsWith(".json"))
+                continue;
+            try {
+                const session = fields(JSON.parse(readFileSync(join(directory, name), "utf8")));
+                if (session && match(session))
+                    return text(session.sessionId);
+            }
+            catch { }
+        }
+    }
+    catch { }
+    return undefined;
+}
+function thread(peers, sessionId) {
+    return sessionId && peers.directory.has(sessionId) ? sessionId : undefined;
+}
+/** The thread a peer message came from: a sub-agent of this session, or the session that sent it. */
+export function peerSource(origin, peers) {
+    const task = text(origin.senderTaskId);
+    if (task && peers.children.has(task))
+        return `agent-${task}`;
+    const msgId = text(origin.msg_id);
+    const pid = text(origin.verifiedPeerPid);
+    const procStart = text(origin.verifiedPeerProcStart);
+    const name = text(origin.name);
+    return thread(peers, msgId && peers.directory.sender(msgId))
+        ?? thread(peers, runningSession(peers.home ?? claudeHome(), (session) => pid !== undefined
+            ? text(session.pid) === pid && (!procStart || !session.procStart || text(session.procStart) === procStart)
+            : name !== undefined && session.name === name));
+}
+/** One message, whether read from its record or from the result of the turn it started. */
+export function peerKey(origin, recordText) {
+    return text(origin.msg_id) ?? `${text(origin.from) ?? ""}\0${peerBody(origin, recordText)}`;
+}
+/** What the peer wrote: Claude's `origin.body`, else its record without Claude's envelope. */
+function peerBody(origin, recordText) {
+    const body = text(origin.body);
+    if (body)
+        return body;
+    const inner = /<(cross-session-message|agent-message)\b[^>]*>([\s\S]*?)<\/\1>/u.exec(recordText)?.[2];
+    return (inner ?? recordText).trim();
+}
+const escape = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+/**
+ * A message another agent sent, as Desktop shows one another thread sent ("Sent by Codex from another task", linking
+ * to it): its `<codex_delegation>` user message. Without a known thread, a plain message saying so.
+ */
+export function peerMessageItem(id, origin, recordText, peers) {
+    const body = peerBody(origin, recordText);
+    const source = peerSource(origin, peers);
+    const name = text(origin.name);
+    const message = source
+        ? ["<codex_delegation>", `  <source_thread_id>${escape(source)}</source_thread_id>`, `  <input>${escape(body)}</input>`, "</codex_delegation>"].join(" ")
+        : `Message from ${name ? `Claude agent ${name}` : "another Claude agent"} (CCodex does not know its chat):\n\n${body}`;
+    return { type: "userMessage", id, clientId: null, content: [{ type: "text", text: message, text_elements: [] }] };
+}
+/**
+ * A `SendMessage` as stock shows a message to another thread: "Messaged <agent>" to a sub-agent of this session (a
+ * `sendInput` to its thread), "Sent message to chat" (linking to it) to another session's chat. Otherwise it stays a
+ * `sendInput` to no known thread.
+ */
+export function sentMessageItem(item, input, result, peers) {
+    if (item.type !== "collabAgentToolCall" || item.tool !== "sendInput")
+        return item;
+    const to = text(input.to) ?? text(input.recipient);
+    const agent = [to, text(fields(result?.pin)?.id)].find((id) => id !== undefined && peers.children.has(id));
+    if (agent)
+        return { ...item, receiverThreadIds: [`agent-${agent}`] };
+    const msgId = text(result?.msg_id);
+    // `to` names a session as ListAgents lists it ("work-8c", "work-8c [5bc12a]"), or (a reply) the address it wrote from.
+    const name = to?.replace(/\s*\[[^\]]*\]$/u, "");
+    const target = thread(peers, msgId && peers.directory.receiver(msgId))
+        ?? thread(peers, name && runningSession(peers.home ?? claudeHome(), (session) => session.name === name || session.sessionId === name || `uds:${text(session.messagingSocketPath)}` === name));
+    if (!target)
+        return item;
+    return {
+        type: "dynamicToolCall", id: item.id, namespace: "codex_app", tool: "send_message_to_thread",
+        arguments: { threadId: target, message: item.prompt ?? "" }, status: item.status,
+        contentItems: null, success: item.status === "inProgress" ? null : item.status === "completed", durationMs: null,
+    };
+}
+//# sourceMappingURL=peers.js.map

package/dist/claude/peers.js.map

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

package/dist/claude/processes.d.ts

@@ -0,0 +1,12 @@
+export interface SessionProcess {
+    readonly pid: number;
+    readonly session: string;
+    /** CPU seconds used so far. */
+    readonly cpu: number;
+}
+/** `[DD-]HH:MM:SS` or `M:SS.ss`. */
+export declare function cpuSeconds(time: string): number;
+/** The commands Claude sessions still run in their process trees, by session. */
+export declare function sessionProcesses(): SessionProcess[];
+/** SIGTERM now, SIGKILL whatever is left a moment later. */
+export declare function killProcesses(pids: readonly number[]): void;

package/dist/claude/processes.js

@@ -0,0 +1,71 @@
+/**
+ * The processes a Claude session's commands run. Claude starts every command (its Bash tool, a background task) with
+ * the session's id and its own pid in the environment (`CLAUDE_CODE_SESSION_ID`, `CLAUDE_PID`); a command still in
+ * the session's process tree ends with it, one it detached (`nohup … &`) lives on and is none of ours.
+ */
+import { execFileSync } from "node:child_process";
+import { readdirSync, readFileSync } from "node:fs";
+const CLOCK_TICKS = 100;
+/** Linux: /proc (CPU in clock ticks); elsewhere `ps` with the environment after the command (CPU in centiseconds). */
+function samples() {
+    try {
+        return readdirSync("/proc").filter((name) => /^\d+$/u.test(name)).flatMap((name) => {
+            try {
+                const stat = readFileSync(`/proc/${name}/stat`, "utf8");
+                const fields = stat.slice(stat.lastIndexOf(")") + 2).split(" ");
+                let environment = "";
+                try {
+                    environment = readFileSync(`/proc/${name}/environ`, "utf8");
+                }
+                catch { /* another user's */ }
+                return [{ pid: Number(name), ppid: Number(fields[1]), cpu: (Number(fields[11]) + Number(fields[12])) / CLOCK_TICKS, environment }];
+            }
+            catch {
+                return [];
+            }
+        });
+    }
+    catch {
+        return execFileSync("ps", ["axeww", "-o", "pid=,ppid=,time=,command="], { encoding: "utf8", maxBuffer: 64 * 1024 * 1024 })
+            .split("\n").flatMap((line) => {
+            const match = /^\s*(\d+)\s+(\d+)\s+(\S+)\s(.*)$/u.exec(line);
+            return match ? [{ pid: Number(match[1]), ppid: Number(match[2]), cpu: cpuSeconds(match[3]), environment: match[4] }] : [];
+        });
+    }
+}
+/** `[DD-]HH:MM:SS` or `M:SS.ss`. */
+export function cpuSeconds(time) {
+    const [days, clock] = time.includes("-") ? time.split("-") : ["0", time];
+    return Number(days) * 86_400 + clock.split(":").reduce((total, part) => total * 60 + Number(part), 0);
+}
+/** The commands Claude sessions still run in their process trees, by session. */
+export function sessionProcesses() {
+    const all = samples();
+    const parents = new Map(all.map((sample) => [sample.pid, sample.ppid]));
+    const inTree = (pid, root) => {
+        for (let current = parents.get(pid); current !== undefined && current > 1; current = parents.get(current)) {
+            if (current === root)
+                return true;
+        }
+        return false;
+    };
+    return all.flatMap((sample) => {
+        const session = /(?:^|[\0 ])CLAUDE_CODE_SESSION_ID=([^\0 ]+)/u.exec(sample.environment)?.[1];
+        const claude = Number(/(?:^|[\0 ])CLAUDE_PID=(\d+)/u.exec(sample.environment)?.[1]);
+        return session && claude && inTree(sample.pid, claude) ? [{ pid: sample.pid, session, cpu: sample.cpu }] : [];
+    });
+}
+/** SIGTERM now, SIGKILL whatever is left a moment later. */
+export function killProcesses(pids) {
+    const signal = (name) => {
+        for (const pid of pids) {
+            try {
+                process.kill(pid, name);
+            }
+            catch { /* gone */ }
+        }
+    };
+    signal("SIGTERM");
+    setTimeout(() => signal("SIGKILL"), 5_000).unref();
+}
+//# sourceMappingURL=processes.js.map

package/dist/claude/processes.js.map

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

package/dist/claude/sdk.d.ts

@@ -0,0 +1,28 @@
+import { type ModelInfo, type Options, type PermissionMode, type Query, type SlashCommand } from "@anthropic-ai/claude-agent-sdk";
+import type { Config } from "../config.js";
+import type { JsonObject } from "../protocol/codex.js";
+export declare function claudeEnvironment(): Record<string, string | undefined>;
+export declare function baseOptions(config: Config): Options;
+export interface CodexPermissions {
+    readonly approvalPolicy: string;
+    readonly approvalsReviewer: string;
+    readonly sandboxPolicy: JsonObject;
+    readonly activePermissionProfile: {
+        id: string;
+        extends: null;
+    };
+}
+/** Codex permission settings (thread/start, turn/start, settings/update) → Claude permission mode; undefined = unchanged. */
+export declare function permissionModeFrom(params: JsonObject): PermissionMode | undefined;
+export declare function codexPermissions(mode: string | null, cwd: string): CodexPermissions;
+export declare function claudeModelDisplayName(model: ModelInfo): string;
+export declare function mapClaudeModel(model: ModelInfo, prefix: string): JsonObject;
+/** Runs `use` against a throwaway, never-prompted query (model list, skills, account info). */
+export declare function withProbeQuery<T>(config: Config, cwd: string | undefined, use: (query: Query) => Promise<T>): Promise<T>;
+/**
+ * A Claude skill as stock lists it. Its path is Claude's own file for it, which a GPT chat mentioning it reads; a
+ * built-in, plugin or MCP command has none and points at a note that it runs only in Claude chats.
+ */
+export declare function mapSkill(config: Config, cwd: string, skill: SlashCommand): Promise<JsonObject>;
+/** Desktop renders Claude skills as `[$claude:name](path)` chips; Claude wants `/name`. */
+export declare function decodeClaudeSkillChips(text: string): string;

package/dist/claude/sdk.js

@@ -0,0 +1,155 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { modelCatalogValue, normalizeClaudeModelIdentifier } from "./modelSelection.js";
+import { claudeSkillFile } from "./toolMapper.js";
+export function claudeEnvironment() {
+    const env = { ...process.env, CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS: "1" };
+    delete env.CCODEX_SHIM_ACTIVE;
+    delete env.CODEX_CLI_PATH;
+    return env;
+}
+export function baseOptions(config) {
+    return {
+        pathToClaudeCodeExecutable: config.claudeBinary,
+        settingSources: ["user", "project", "local"],
+        env: claudeEnvironment(),
+    };
+}
+/** Codex permission settings (thread/start, turn/start, settings/update) → Claude permission mode; undefined = unchanged. */
+export function permissionModeFrom(params) {
+    if (params.collaborationMode?.mode === "plan")
+        return "plan";
+    const sandbox = params.sandboxPolicy?.type ?? params.sandbox ?? params.permissions;
+    const fullAccess = sandbox === "dangerFullAccess" || sandbox === "danger-full-access" || sandbox === ":danger-full-access";
+    if (params.approvalsReviewer && params.approvalsReviewer !== "user")
+        return "auto";
+    if (params.approvalPolicy === "never")
+        return fullAccess ? "bypassPermissions" : "dontAsk";
+    if (params.approvalPolicy !== undefined && params.approvalPolicy !== null)
+        return "default";
+    if (fullAccess)
+        return "bypassPermissions";
+    if (params.collaborationMode?.mode === "default" || params.approvalsReviewer === "user")
+        return "default";
+    return undefined;
+}
+export function codexPermissions(mode, cwd) {
+    if (mode === "bypassPermissions") {
+        return {
+            approvalPolicy: "never", approvalsReviewer: "user", sandboxPolicy: { type: "dangerFullAccess" },
+            activePermissionProfile: { id: ":danger-full-access", extends: null },
+        };
+    }
+    const sandboxPolicy = {
+        type: "workspaceWrite", writableRoots: [cwd], networkAccess: false, excludeTmpdirEnvVar: false, excludeSlashTmp: false,
+    };
+    const profile = { id: ":workspace", extends: null };
+    if (mode === "dontAsk")
+        return { approvalPolicy: "never", approvalsReviewer: "user", sandboxPolicy, activePermissionProfile: profile };
+    if (mode === "auto")
+        return { approvalPolicy: "on-request", approvalsReviewer: "auto_review", sandboxPolicy, activePermissionProfile: profile };
+    return { approvalPolicy: "on-request", approvalsReviewer: "user", sandboxPolicy, activePermissionProfile: profile };
+}
+// ---- models ----
+const effortDescriptions = {
+    low: "Faster responses with less reasoning.",
+    medium: "Balanced reasoning effort.",
+    high: "Deep reasoning for complex work.",
+    xhigh: "Extra-high reasoning effort.",
+    max: "Maximum available reasoning effort.",
+};
+export function claudeModelDisplayName(model) {
+    const displayName = model.displayName.replace(/\s*\(1M context\)\s*$/iu, "");
+    const resolved = model.resolvedModel && normalizeClaudeModelIdentifier(model.resolvedModel);
+    const version = resolved && /^claude-([a-z][a-z0-9]*?)-(\d+)(?:-(\d{1,2})(?=-|$))?/u.exec(resolved);
+    if (!version)
+        return displayName;
+    const [, family, major, minor] = version;
+    const label = `${family[0].toUpperCase()}${family.slice(1)} ${major}${minor ? `.${minor}` : ""}`;
+    if (displayName.toLocaleLowerCase().includes(label.toLocaleLowerCase()))
+        return displayName;
+    if (displayName.toLocaleLowerCase().startsWith(family)) {
+        return `${displayName.slice(0, family.length)} ${major}${minor ? `.${minor}` : ""}${displayName.slice(family.length)}`;
+    }
+    return `${displayName} · ${label}`;
+}
+export function mapClaudeModel(model, prefix) {
+    const efforts = model.supportsEffort ? (model.supportedEffortLevels ?? []) : [];
+    // Like stock models: Desktop adds the standard speed itself.
+    const serviceTiers = model.supportsFastMode ? [{ id: "fast", name: "Fast", description: "Claude fast mode." }] : [];
+    const id = `${prefix}${modelCatalogValue(model)}`;
+    return {
+        id,
+        model: id,
+        upgrade: null,
+        upgradeInfo: null,
+        availabilityNux: null,
+        modelSpecialty: null,
+        multiAgentVersion: null,
+        displayName: claudeModelDisplayName(model),
+        description: model.description,
+        hidden: false,
+        supportedReasoningEfforts: efforts.map((reasoningEffort) => ({
+            reasoningEffort,
+            description: effortDescriptions[reasoningEffort] ?? `${reasoningEffort} reasoning effort.`,
+        })),
+        defaultReasoningEffort: efforts.includes("high") ? "high" : efforts.includes("medium") ? "medium" : efforts[0] ?? "medium",
+        inputModalities: ["text", "image"],
+        supportsPersonality: true,
+        additionalSpeedTiers: serviceTiers.map((tier) => tier.id),
+        serviceTiers,
+        defaultServiceTier: null,
+        availableAccessPrograms: null,
+        isDefault: false,
+    };
+}
+async function* idle(signal) {
+    await new Promise((resolve) => signal.addEventListener("abort", () => resolve(), { once: true }));
+}
+/** Runs `use` against a throwaway, never-prompted query (model list, skills, account info). */
+export async function withProbeQuery(config, cwd, use) {
+    const abort = new AbortController();
+    const probe = query({
+        prompt: idle(abort.signal),
+        options: { ...baseOptions(config), ...(cwd ? { cwd } : {}), persistSession: false, abortController: abort, allowedTools: [] },
+    });
+    let timer;
+    try {
+        return await Promise.race([
+            probe.initializationResult().then(() => use(probe)),
+            new Promise((_, reject) => { timer = setTimeout(() => reject(new Error("Claude probe timed out.")), 20_000); }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+        abort.abort();
+        probe.close();
+    }
+}
+/**
+ * A Claude skill as stock lists it. Its path is Claude's own file for it, which a GPT chat mentioning it reads; a
+ * built-in, plugin or MCP command has none and points at a note that it runs only in Claude chats.
+ */
+export async function mapSkill(config, cwd, skill) {
+    let path = claudeSkillFile(skill.name, cwd, config.claudeHome);
+    if (!path) {
+        path = join(config.dataDir, "virtual", "claude-skills", encodeURIComponent(skill.name), "SKILL.md");
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, `---\nname: claude:${skill.name}\ndescription: ${JSON.stringify(skill.description)}\n---\n\n\`/${skill.name}\` is a Claude Code command without a file of its own (built in, or from a plugin or MCP server). It runs only in Claude chats: to use it, the user switches this chat to a Claude model.\n`);
+    }
+    return {
+        name: `claude:${skill.name}`,
+        description: skill.argumentHint ? `${skill.description} Arguments: ${skill.argumentHint}` : skill.description,
+        path,
+        scope: "user",
+        enabled: true,
+        pluginId: null,
+    };
+}
+const CLAUDE_SKILL_CHIP = /\[\$claude:([^\]\r\n]+)\]\([^)]+\)/gu;
+/** Desktop renders Claude skills as `[$claude:name](path)` chips; Claude wants `/name`. */
+export function decodeClaudeSkillChips(text) {
+    return text.replace(CLAUDE_SKILL_CHIP, (_chip, name) => `/${name}`);
+}
+//# sourceMappingURL=sdk.js.map

package/dist/claude/sdk.js.map

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

package/dist/claude/session.d.ts

@@ -0,0 +1,182 @@
+import { type PermissionMode } from "@anthropic-ai/claude-agent-sdk";
+import type { JsonObject, QueuedSubmissionLike, ThreadItem, TokenUsageBreakdown, Turn } from "../protocol/codex.js";
+import type { ClaudeThreads } from "./threads.js";
+export interface SessionSettings {
+    cwd: string;
+    /** Claude model value without the picker prefix; null = Claude's default. */
+    model: string | null;
+    effort: string | null;
+    fast: boolean;
+    permissionMode: PermissionMode;
+}
+interface ActiveTurn {
+    readonly id: string;
+    readonly startedAt: number;
+    readonly items: ThreadItem[];
+    resultSeen: boolean;
+    interrupted: boolean;
+    error: string | null;
+}
+interface BackgroundTask {
+    readonly taskId: string;
+    readonly toolUseId: string | undefined;
+    readonly description: string;
+    readonly taskType: string | undefined;
+}
+export declare const INJECTED_PREFIX = "[Injected model-visible history]";
+/**
+ * One live Claude session: a single streaming `query()` and one sequential loop that turns SDK messages
+ * into Codex notifications. Claude persists everything; this object only holds the running turn.
+ */
+export declare class ClaudeSession {
+    private readonly host;
+    readonly threadId: string;
+    settings: SessionSettings;
+    turn: ActiveTurn | undefined;
+    state: "idle" | "running" | "requires_action";
+    readonly tasks: Map<string, BackgroundTask>;
+    /** Claude's sub-agents running (in the background they keep no turn open: each has a chat of its own). */
+    private readonly agents;
+    queued: QueuedSubmissionLike[];
+    totalUsage: TokenUsageBreakdown;
+    lastUsage: TokenUsageBreakdown;
+    contextWindow: number | null;
+    costUsd: number;
+    liveModel: string | null;
+    private sdk?;
+    /** Last sign of life: a message from Claude, a prompt, a command. */
+    activeAt: number;
+    /** Claude's scheduled wakeups (CronCreate, ScheduleWakeup, /loop) as of the last turn's end: the process must stay. */
+    private crons;
+    /** Settles once the query's process is gone: Claude writes its last transcript records on the way out. */
+    private consumed;
+    private inbox?;
+    private response?;
+    private readonly tools;
+    private readonly streamed;
+    /** Usage per model response; streamed assistant messages repeat it and never carry a stop reason. */
+    private readonly usageByMessage;
+    private readonly pendingInputs;
+    /** Injected context (`shouldQuery: false`) runs a silent query of its own: no turn is shown for it. */
+    private readonly injections;
+    private readonly turnWaiters;
+    private continuationTimer?;
+    private runningTimer?;
+    private exists;
+    compactSummary?: (summary: string) => void;
+    private readonly codexTails;
+    /** Claude's task list (TaskCreate/TaskUpdate), sent like stock's plan updates: the client shows it as the turn's to-do list. */
+    private readonly plan;
+    /** Messages from other agents shown (peerKey), whichever of transcript and result told them first. */
+    private readonly peerMessages;
+    /** The running turn's result came: Claude answering again means it took another prompt by itself. */
+    private afterResult;
+    /** Claude's last block since a turn began (its item id; the text item while it streams text). */
+    private lastBlock?;
+    private transcript?;
+    /** Where the transcript ended when the turn began, then as far as it was read for messages queued mid-turn. */
+    private transcriptRead;
+    constructor(host: ClaudeThreads, threadId: string, settings: SessionSettings, options: {
+        exists: boolean;
+        resumeAt?: string;
+    });
+    private resumeAt;
+    get loaded(): boolean;
+    get busy(): boolean;
+    /** Nothing to do for `idleMs` (closing its process loses nothing: the next turn resumes from disk). */
+    quiet(now: number, idleMs: number): boolean;
+    /** The turn has its answer and only waits for background tasks to end. */
+    get waitingOnTasks(): boolean;
+    /** Stops the background tasks as Claude's own stop control does: Claude learns they were stopped, not that they failed. */
+    stopTasks(): Promise<void>;
+    /** The process started ahead of the first prompt (prewarm), and what it was started with. */
+    private warm?;
+    private optionsKey;
+    /** Starts Claude's process before the first prompt, so that prompt does not wait for it; unused, it goes. */
+    prewarm(): void;
+    discardWarm(): void;
+    private ensureQuery;
+    private options;
+    private consume;
+    /** Closes the query; the next turn resumes the session from disk. */
+    unload(): Promise<void>;
+    startTurn(params: JsonObject): Promise<Turn>;
+    /** Text-only turn issued by CCodex itself (e.g. `/goal`, `/compact <prompt>`). */
+    command(text: string): Promise<Turn>;
+    steer(params: JsonObject): Promise<string>;
+    /** Model-visible context without a model reply (provider switch summary, injected items). */
+    inject(text: string): Promise<void>;
+    /** Resolves with the final status once the turn completes. */
+    turnDone(turnId: string): Promise<string>;
+    interrupt(): Promise<void>;
+    stopTask(taskId: string): Promise<void>;
+    askSideQuestion(question: string): Promise<string>;
+    private applyTurnSettings;
+    updateSettings(params: JsonObject): Promise<boolean>;
+    private newTurnObject;
+    /** `announced`: the provider switch already started the turn under this preallocated id. */
+    private openTurn;
+    /** In-progress turn as Codex shows it in thread/read and paging. */
+    liveTurn(): Turn | undefined;
+    private maybeComplete;
+    /** Claude goes on after an answer with no prompt: the answer ends its turn, the work goes on in a new one (history's). */
+    private continueTurn;
+    /** `continued`: the work goes on in the next turn (its tools keep running, the chat stays busy). */
+    private completeTurn;
+    private emit;
+    private itemStarted;
+    private itemCompleted;
+    private handle;
+    /** With no id, Claude went on by itself: after an answer, in the turn history names after it. */
+    private ensureTurn;
+    /** A pushed message reached the model: mid-turn it joins the running turn, otherwise it opens one. */
+    private onCommand;
+    /** The session's sub-agents are its transcripts under `<session>/subagents` (a resumed session's earlier ones too). */
+    private get peers();
+    /**
+     * Claude answers again right after a result, without going idle: the transcript tells what it took. A message another
+     * agent sent (a sub-agent's has no command uuid, so only the transcript tells) starts a turn, as in history; a
+     * finished task's notification goes on after the answer in a turn of its own.
+     */
+    private continued;
+    /** The session's transcript: the catalog's, or (a new session it has not scanned yet) found among Claude's projects. */
+    private transcriptPath;
+    /**
+     * Messages other agents sent while Claude worked join the running turn. A sub-agent's comes with no command in the
+     * stream: Claude writes it to the transcript before its next request, so it is read back as the next answer starts.
+     */
+    private showQueuedPeers;
+    private showPeer;
+    /**
+     * A command Claude started by itself may be a message another agent sent. The stream leaves that message out, so it
+     * is read back from the transcript as soon as Claude writes it there (the result of the turn it starts tells it too).
+     */
+    private showPeerMessage;
+    private onSystem;
+    /** A task ended while Claude was idle: its notification may wake Claude up, so the turn waits a moment for that. */
+    private awaitWakeup;
+    /** Visible CCodex/Claude notice inside the running turn (e.g. `/goal` output). */
+    private systemText;
+    private onStream;
+    private blockStart;
+    private blockDelta;
+    private flushResponse;
+    private onAssistant;
+    private toolStarted;
+    /**
+     * Codex MCP calls: the prompt and everything codex says while it works show up in the calling chat (a
+     * sub-agent's own thread when a sub-agent calls), with the ids history gives them.
+     */
+    private codexMcpCall;
+    private onUser;
+    private updatePlan;
+    private onResult;
+    private emitUsage;
+    private readonly canUseTool;
+    /** Desktop shows a file change (and its approval) only with the patch: send it as soon as the input is known. */
+    private proposeChanges;
+    private decisionResult;
+    private askUser;
+    private elicit;
+}
+export {};