twinny 0.0.0-dev.260525150705

package/dist/codex/protocol.js

@@ -0,0 +1,205 @@
+import { EventEmitter } from "node:events";
+import { TwinnyError, toErrorMessage } from "../errors.js";
+import { TWINNY_VERSION } from "../version.js";
+export class CodexProtocolClient extends EventEmitter {
+    readable;
+    writable;
+    pending = new Map();
+    requestTimeoutMs;
+    requestIdPrefix;
+    nextRequestId = 1;
+    readLoopDone;
+    closed = false;
+    constructor(readable, writable, options = {}) {
+        super();
+        this.readable = readable;
+        this.writable = writable;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? 120_000;
+        this.requestIdPrefix = options.requestIdPrefix ?? "twinny";
+    }
+    start() {
+        if (this.readLoopDone) {
+            return;
+        }
+        this.readLoopDone = this.readLoop().catch((error) => {
+            const parsedError = error instanceof Error ? error : new TwinnyError(toErrorMessage(error), "CODEX_PROTOCOL_READ_ERROR");
+            this.failAllPending(parsedError);
+            this.emit("error", parsedError);
+        });
+    }
+    async waitForClose() {
+        await this.readLoopDone;
+    }
+    async initialize(params) {
+        const response = await this.request("initialize", params);
+        this.notify("initialized");
+        return response;
+    }
+    request(method, params, options = {}) {
+        if (this.closed) {
+            return Promise.reject(new TwinnyError("Codex protocol connection is closed", "CODEX_PROTOCOL_CLOSED"));
+        }
+        const id = this.allocateRequestId();
+        const message = params === undefined ? { id, method } : { id, method, params };
+        const promise = new Promise((resolve, reject) => {
+            const timeoutMs = options.timeoutMs ?? this.requestTimeoutMs;
+            const timeout = timeoutMs > 0
+                ? setTimeout(() => {
+                    this.pending.delete(id);
+                    reject(new TwinnyError(`Timed out waiting for Codex response to ${method}`, "CODEX_REQUEST_TIMEOUT"));
+                }, timeoutMs)
+                : undefined;
+            this.pending.set(id, { method, resolve, reject, timeout });
+        });
+        try {
+            this.writeJson(message);
+        }
+        catch (error) {
+            const pending = this.pending.get(id);
+            if (pending?.timeout) {
+                clearTimeout(pending.timeout);
+            }
+            this.pending.delete(id);
+            throw error;
+        }
+        return promise;
+    }
+    notify(method, params) {
+        const message = params === undefined ? { method } : { method, params };
+        this.writeJson(message);
+    }
+    respond(id, result) {
+        this.writeJson({ id, result });
+    }
+    respondError(id, error) {
+        this.writeJson({ id, error });
+    }
+    close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        this.writable.end();
+        this.failAllPending(new TwinnyError("Codex protocol connection closed", "CODEX_PROTOCOL_CLOSED"));
+    }
+    allocateRequestId() {
+        return `${this.requestIdPrefix}-${this.nextRequestId++}`;
+    }
+    async readLoop() {
+        let buffer = "";
+        this.readable.setEncoding("utf8");
+        for await (const chunk of this.readable) {
+            buffer += chunk;
+            let newlineIndex = buffer.indexOf("\n");
+            while (newlineIndex !== -1) {
+                const line = buffer.slice(0, newlineIndex);
+                buffer = buffer.slice(newlineIndex + 1);
+                this.handleLine(line);
+                newlineIndex = buffer.indexOf("\n");
+            }
+        }
+        if (buffer.trim().length > 0) {
+            this.handleLine(buffer);
+        }
+        this.closed = true;
+        this.failAllPending(new TwinnyError("Codex protocol stream ended", "CODEX_PROTOCOL_CLOSED"));
+        this.emit("close");
+    }
+    handleLine(line) {
+        if (this.closed) {
+            return;
+        }
+        const trimmed = line.trim();
+        if (trimmed.length === 0) {
+            return;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch (error) {
+            this.emit("error", new TwinnyError(`Invalid Codex protocol JSON line: ${toErrorMessage(error)}`, "CODEX_PROTOCOL_PARSE_ERROR"));
+            return;
+        }
+        if (!isRecord(parsed)) {
+            this.emit("error", new TwinnyError("Codex protocol message is not an object", "CODEX_PROTOCOL_PARSE_ERROR"));
+            return;
+        }
+        const message = parsed;
+        this.emit("message", message);
+        if (isResponseMessage(message)) {
+            this.handleResponse(message);
+            return;
+        }
+        if (isRequestMessage(message)) {
+            this.emit("serverRequest", message);
+            return;
+        }
+        if (isNotificationMessage(message)) {
+            this.emit("notification", message);
+            return;
+        }
+        this.emit("error", new TwinnyError("Unknown Codex protocol message shape", "CODEX_PROTOCOL_PARSE_ERROR"));
+    }
+    handleResponse(message) {
+        this.emit("response", message);
+        const pending = this.pending.get(message.id);
+        if (!pending) {
+            this.emit("error", new TwinnyError(`Received response for unknown Codex request id ${String(message.id)}`, "CODEX_UNKNOWN_RESPONSE"));
+            return;
+        }
+        if (pending.timeout) {
+            clearTimeout(pending.timeout);
+        }
+        this.pending.delete(message.id);
+        if (message.error) {
+            pending.reject(new TwinnyError(message.error.message, "CODEX_REQUEST_FAILED", message.error));
+            return;
+        }
+        pending.resolve(message.result);
+    }
+    writeJson(message) {
+        if (this.closed) {
+            throw new TwinnyError("Codex protocol connection is closed", "CODEX_PROTOCOL_CLOSED");
+        }
+        const line = `${JSON.stringify(message)}\n`;
+        if (!this.writable.write(line, "utf8")) {
+            this.writable.once("drain", () => undefined);
+        }
+    }
+    failAllPending(error) {
+        for (const pending of this.pending.values()) {
+            if (pending.timeout) {
+                clearTimeout(pending.timeout);
+            }
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+}
+export function createInitializeParams(version = TWINNY_VERSION) {
+    return {
+        clientInfo: {
+            name: "twinny",
+            title: "Twinny",
+            version
+        },
+        capabilities: {
+            experimentalApi: true,
+            optOutNotificationMethods: null
+        }
+    };
+}
+export function isResponseMessage(message) {
+    return "id" in message && ("result" in message || "error" in message) && !("method" in message);
+}
+export function isRequestMessage(message) {
+    return "id" in message && "method" in message && typeof message.method === "string";
+}
+export function isNotificationMessage(message) {
+    return !("id" in message) && "method" in message && typeof message.method === "string";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/codex/protocol.js.map

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

package/dist/codex/thread-name.d.ts

@@ -0,0 +1,3 @@
+import type { CodexThreadNameUpdate } from "../types.js";
+import type { CodexNotificationMessage } from "./protocol.js";
+export declare function parseCodexThreadNameUpdatedNotification(message: CodexNotificationMessage): CodexThreadNameUpdate | undefined;

package/dist/codex/thread-name.js

@@ -0,0 +1,27 @@
+export function parseCodexThreadNameUpdatedNotification(message) {
+    if (message.method !== "thread/name/updated" || !isRecord(message.params)) {
+        return undefined;
+    }
+    const threadId = firstString(message.params.threadId, message.params.thread_id);
+    const name = firstString(message.params.name, message.params.threadName, message.params.thread_name);
+    if (!threadId || !name) {
+        return undefined;
+    }
+    return { threadId, name };
+}
+function firstString(...values) {
+    for (const value of values) {
+        if (typeof value !== "string") {
+            continue;
+        }
+        const trimmed = value.trim();
+        if (trimmed) {
+            return trimmed;
+        }
+    }
+    return undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=thread-name.js.map

package/dist/codex/thread-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-name.js","sourceRoot":"","sources":["../../src/codex/thread-name.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,uCAAuC,CACrD,OAAiC;IAEjC,IAAI,OAAO,CAAC,MAAM,KAAK,qBAAqB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1E,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACrG,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,WAAW,CAAC,GAAG,MAAiB;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/codex/thread.d.ts

@@ -0,0 +1,76 @@
+import type { CodexProtocolClient } from "./protocol.js";
+export type CodexApprovalPolicy = "never";
+export interface ThreadRuntimeParams {
+    cwd: string;
+    approvalPolicy: CodexApprovalPolicy;
+    persistExtendedHistory: boolean;
+}
+export interface ThreadStartParams extends ThreadRuntimeParams {
+    dynamicTools: DynamicToolSpec[];
+    developerInstructions?: string;
+}
+export interface ThreadResumeParams extends ThreadRuntimeParams {
+    threadId: string;
+}
+export interface ThreadForkParams extends ThreadRuntimeParams {
+    threadId: string;
+    excludeTurns: true;
+    persistExtendedHistory: boolean;
+    developerInstructions?: string;
+    ephemeral?: boolean;
+    model?: string;
+    config?: Record<string, unknown>;
+}
+export interface DynamicToolSpec {
+    namespace?: string;
+    name: string;
+    description: string;
+    inputSchema: unknown;
+    deferLoading?: boolean;
+}
+export declare const SET_THREAD_NAME_TOOL_SPEC: DynamicToolSpec;
+export interface CodexThread {
+    id: string;
+    [key: string]: unknown;
+}
+export interface ThreadStartResponse {
+    thread: CodexThread;
+    [key: string]: unknown;
+}
+export interface ThreadResumeResponse {
+    thread: CodexThread;
+    [key: string]: unknown;
+}
+export interface ThreadForkResponse {
+    thread: CodexThread;
+    [key: string]: unknown;
+}
+export interface ThreadRuntimeOptions {
+    cwd: string;
+    developerInstructions?: string;
+}
+export interface ThreadForkOptions extends ThreadRuntimeOptions {
+    ephemeral?: boolean;
+    model?: string;
+    effort?: string;
+}
+export declare function buildThreadStartParams(options: ThreadRuntimeOptions): ThreadStartParams;
+export declare function buildThreadResumeParams(threadId: string, options: ThreadRuntimeOptions): ThreadResumeParams;
+export declare function buildThreadForkParams(threadId: string, options: ThreadForkOptions): ThreadForkParams;
+export interface ThreadSetNameParams {
+    threadId: string;
+    name: string;
+}
+export declare function startCodexThread(protocol: CodexProtocolClient, options: ThreadRuntimeOptions): Promise<ThreadStartResponse>;
+export declare function resumeCodexThread(protocol: CodexProtocolClient, threadId: string, options: ThreadRuntimeOptions): Promise<ThreadResumeResponse>;
+export declare function forkCodexThread(protocol: CodexProtocolClient, threadId: string, options: ThreadForkOptions): Promise<ThreadForkResponse>;
+export interface ThreadInjectItemsParams {
+    threadId: string;
+    items: unknown[];
+}
+export declare function injectCodexThreadItems(protocol: CodexProtocolClient, params: ThreadInjectItemsParams): Promise<void>;
+export interface ThreadUnsubscribeParams {
+    threadId: string;
+}
+export declare function unsubscribeCodexThread(protocol: CodexProtocolClient, threadId: string): Promise<void>;
+export declare function setCodexThreadName(protocol: CodexProtocolClient, params: ThreadSetNameParams): Promise<void>;

package/dist/codex/thread.js

@@ -0,0 +1,80 @@
+export const SET_THREAD_NAME_TOOL_SPEC = {
+    namespace: "twinny",
+    name: "set_thread_name",
+    description: "Update the current thread name. Call this at the beginning of a conversation after understanding the work, and call it again whenever the current thread name does not match the actual work. Keep the name concise, within 15 Chinese characters or 10 words.",
+    inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        required: ["name"],
+        properties: {
+            name: {
+                type: "string",
+                minLength: 1,
+                description: "New thread name. Keep it concise, within 15 Chinese characters or 10 words. Do not include explanations."
+            }
+        }
+    },
+    deferLoading: false
+};
+export function buildThreadStartParams(options) {
+    const params = {
+        cwd: options.cwd,
+        approvalPolicy: "never",
+        persistExtendedHistory: true,
+        dynamicTools: [SET_THREAD_NAME_TOOL_SPEC]
+    };
+    if (options.developerInstructions) {
+        params.developerInstructions = options.developerInstructions;
+    }
+    return params;
+}
+export function buildThreadResumeParams(threadId, options) {
+    return {
+        threadId,
+        cwd: options.cwd,
+        approvalPolicy: "never",
+        persistExtendedHistory: true
+    };
+}
+export function buildThreadForkParams(threadId, options) {
+    const params = {
+        threadId,
+        cwd: options.cwd,
+        approvalPolicy: "never",
+        persistExtendedHistory: true,
+        excludeTurns: true
+    };
+    if (options.ephemeral) {
+        params.ephemeral = true;
+        params.persistExtendedHistory = false;
+    }
+    if (options.developerInstructions) {
+        params.developerInstructions = options.developerInstructions;
+    }
+    if (options.model) {
+        params.model = options.model;
+    }
+    if (options.effort) {
+        params.config = { model_reasoning_effort: options.effort };
+    }
+    return params;
+}
+export async function startCodexThread(protocol, options) {
+    return protocol.request("thread/start", buildThreadStartParams(options));
+}
+export async function resumeCodexThread(protocol, threadId, options) {
+    return protocol.request("thread/resume", buildThreadResumeParams(threadId, options));
+}
+export async function forkCodexThread(protocol, threadId, options) {
+    return protocol.request("thread/fork", buildThreadForkParams(threadId, options));
+}
+export async function injectCodexThreadItems(protocol, params) {
+    await protocol.request("thread/inject_items", params);
+}
+export async function unsubscribeCodexThread(protocol, threadId) {
+    await protocol.request("thread/unsubscribe", { threadId });
+}
+export async function setCodexThreadName(protocol, params) {
+    await protocol.request("thread/name/set", params);
+}
+//# sourceMappingURL=thread.js.map

package/dist/codex/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../src/codex/thread.ts"],"names":[],"mappings":"AAqCA,MAAM,CAAC,MAAM,yBAAyB,GAAoB;IACxD,SAAS,EAAE,QAAQ;IACnB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,gQAAgQ;IAClQ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC;gBACZ,WAAW,EACT,0GAA0G;aAC7G;SACF;KACF;IACD,YAAY,EAAE,KAAK;CACpB,CAAC;AAiCF,MAAM,UAAU,sBAAsB,CAAC,OAA6B;IAClE,MAAM,MAAM,GAAsB;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,cAAc,EAAE,OAAO;QACvB,sBAAsB,EAAE,IAAI;QAC5B,YAAY,EAAE,CAAC,yBAAyB,CAAC;KAC1C,CAAC;IACF,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;QAClC,MAAM,CAAC,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,OAA6B;IACrF,OAAO;QACL,QAAQ;QACR,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,cAAc,EAAE,OAAO;QACvB,sBAAsB,EAAE,IAAI;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,OAA0B;IAChF,MAAM,MAAM,GAAqB;QAC/B,QAAQ;QACR,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,cAAc,EAAE,OAAO;QACvB,sBAAsB,EAAE,IAAI;QAC5B,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,MAAM,CAAC,sBAAsB,GAAG,KAAK,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;QAClC,MAAM,CAAC,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,MAAM,GAAG,EAAE,sBAAsB,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAA6B,EAC7B,OAA6B;IAE7B,OAAO,QAAQ,CAAC,OAAO,CAAyC,cAAc,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;AACnH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAA6B,EAC7B,QAAgB,EAChB,OAA6B;IAE7B,OAAO,QAAQ,CAAC,OAAO,CACrB,eAAe,EACf,uBAAuB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAA6B,EAC7B,QAAgB,EAChB,OAA0B;IAE1B,OAAO,QAAQ,CAAC,OAAO,CACrB,aAAa,EACb,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,CACzC,CAAC;AACJ,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAA6B,EAC7B,MAA+B;IAE/B,MAAM,QAAQ,CAAC,OAAO,CAAiD,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACxG,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAA6B,EAC7B,QAAgB;IAEhB,MAAM,QAAQ,CAAC,OAAO,CAAmD,oBAAoB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC/G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAA6B,EAC7B,MAA2B;IAE3B,MAAM,QAAQ,CAAC,OAAO,CAA6C,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAChG,CAAC"}

package/dist/codex/turn.d.ts

@@ -0,0 +1,166 @@
+import type { CodexAgentMessage, CodexImageGeneration, CodexPlanUpdate, CodexRequestUserInputRequest, CodexRequestUserInputResponse, CodexThreadMode, CodexThreadTokenUsageUpdate, CodexTurnResult } from "../types.js";
+import type { CodexNotificationMessage, CodexProtocolClient, CodexRequestMessage } from "./protocol.js";
+import { type ThreadGoal } from "./goal.js";
+export interface TextTurnInput {
+    type: "text";
+    text: string;
+    text_elements: [];
+}
+export interface LocalImageTurnInput {
+    type: "localImage";
+    path: string;
+    detail: null;
+}
+export type CodexUserInput = TextTurnInput | LocalImageTurnInput;
+export type CodexTurnInput = string | CodexUserInput[];
+export interface TurnStartParams {
+    threadId: string;
+    input: CodexUserInput[];
+    cwd: string;
+    approvalPolicy: "never";
+    collaborationMode?: {
+        mode: CodexThreadMode;
+        settings: {
+            model: string;
+            reasoning_effort: string | null;
+            developer_instructions: string | null;
+        };
+    };
+}
+export interface TurnStartOptions {
+    threadId: string;
+    text?: string;
+    input?: CodexTurnInput;
+    currentThreadName?: string;
+    cwd: string;
+    mode?: CodexThreadMode;
+    model?: string;
+    effort?: string;
+    onTurnStarted?: (turnId: string) => Promise<void> | void;
+    onAgentMessage?: (message: CompletedAgentMessage) => Promise<void> | void;
+    onImageGeneration?: (image: CodexImageGeneration) => Promise<void> | void;
+    onTokenUsage?: (usage: CodexThreadTokenUsageUpdate) => Promise<void> | void;
+    onGoalUpdated?: (goal: ThreadGoal, turnId: string | null) => Promise<void> | void;
+    onGoalCleared?: () => Promise<void> | void;
+    onPlanUpdated?: (plan: CodexPlanUpdate) => Promise<void> | void;
+    onRequestUserInput?: (request: CodexRequestUserInputRequest, responder: CodexRequestUserInputResponder) => Promise<void> | void;
+    onSetThreadName?: (request: CodexSetThreadNameToolRequest) => Promise<CodexDynamicToolCallResponse> | CodexDynamicToolCallResponse;
+}
+export interface TurnRequestOptions {
+    requestTimeoutMs?: number;
+    completionTimeoutMs?: number;
+}
+export interface TurnStartResponse {
+    turn?: {
+        id?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+type TurnIdSource = "response" | "notification";
+export type CompletedAgentMessage = CodexAgentMessage;
+export interface CodexRequestUserInputResponder {
+    respond(response: CodexRequestUserInputResponse): void;
+    reject(error: Error | string): void;
+}
+export interface CodexSetThreadNameToolRequest {
+    requestId: string | number;
+    threadId: string;
+    turnId: string;
+    callId: string;
+    name: string;
+    rawArguments: unknown;
+}
+export interface CodexDynamicToolCallResponse {
+    success: boolean;
+    contentItems: Array<{
+        type: "inputText";
+        text: string;
+    }>;
+}
+export interface TurnSteerOptions {
+    threadId: string;
+    turnId: string;
+    text?: string;
+    input?: CodexTurnInput;
+}
+export interface TurnSteerParams {
+    threadId: string;
+    input: CodexUserInput[];
+    expectedTurnId: string;
+}
+export interface TurnInterruptOptions {
+    threadId: string;
+    turnId: string;
+}
+export interface TurnInterruptParams {
+    threadId: string;
+    turnId: string;
+}
+export interface ThreadCompactStartOptions {
+    threadId: string;
+    onTurnStarted?: (turnId: string) => Promise<void> | void;
+    onTokenUsage?: (usage: CodexThreadTokenUsageUpdate) => Promise<void> | void;
+}
+export interface ThreadCompactStartParams {
+    threadId: string;
+}
+export declare function buildTextTurnInput(text: string): TextTurnInput;
+export declare function buildLocalImageTurnInput(path: string): LocalImageTurnInput;
+export declare function normalizeCodexTurnInput(input?: CodexTurnInput, fallbackText?: string): CodexUserInput[];
+export declare function prefixCurrentThreadNameInput(input: CodexUserInput[], threadName: string): CodexUserInput[];
+export declare function buildTurnStartParams(options: TurnStartOptions): TurnStartParams;
+export declare function buildTurnSteerParams(options: TurnSteerOptions): TurnSteerParams;
+export declare function buildTurnInterruptParams(options: TurnInterruptOptions): TurnInterruptParams;
+export declare function startCodexTurn(protocol: CodexProtocolClient, options: TurnStartOptions, requestOptions?: TurnRequestOptions): Promise<CodexTurnResult>;
+export declare function compactCodexThread(protocol: CodexProtocolClient, options: ThreadCompactStartOptions, requestOptions?: TurnRequestOptions): Promise<CodexTurnResult>;
+export declare function steerCodexTurn(protocol: CodexProtocolClient, options: TurnSteerOptions): Promise<void>;
+export declare function interruptCodexTurn(protocol: CodexProtocolClient, options: TurnInterruptOptions): Promise<void>;
+export declare class TurnOutputAccumulator {
+    private readonly threadId;
+    private readonly callbacks;
+    private readonly assistantMessages;
+    private readonly generatedImages;
+    private readonly pendingAgentMessageCallbacks;
+    private agentMessageCallbackChain;
+    private readonly startedAt;
+    private finalAnswerText;
+    private turnId;
+    private turnIdSource;
+    private emittedTurnStartedId;
+    private completed;
+    private completionError;
+    private resolveWait;
+    private rejectWait;
+    constructor(threadId: string, turnId?: string, callbacks?: {
+        onTurnStarted?: (turnId: string) => Promise<void> | void;
+        onAgentMessage?: (message: CompletedAgentMessage) => Promise<void> | void;
+        onImageGeneration?: (image: CodexImageGeneration) => Promise<void> | void;
+        onTokenUsage?: (usage: CodexThreadTokenUsageUpdate) => Promise<void> | void;
+        onGoalUpdated?: (goal: ThreadGoal, turnId: string | null) => Promise<void> | void;
+        onGoalCleared?: () => Promise<void> | void;
+        onPlanUpdated?: (plan: CodexPlanUpdate) => Promise<void> | void;
+    });
+    setTurnId(turnId: string, source?: TurnIdSource): void;
+    record(notification: CodexNotificationMessage): void;
+    wait(timeoutMs?: number): Promise<CodexTurnResult>;
+    get text(): string;
+    private recordTurnStarted;
+    private recordItemCompleted;
+    private recordTurnCompleted;
+    private recordError;
+    private recordTokenUsage;
+    private recordGoalUpdated;
+    private recordGoalCleared;
+    private emitPlanUpdate;
+    private toResult;
+    private recordImageGeneration;
+    private emitAgentMessage;
+    private emitImageGeneration;
+    private resolveCompleted;
+    private waitForPendingAgentMessageCallbacks;
+}
+export declare function handleTurnServerRequest(protocol: CodexProtocolClient, options: TurnStartOptions, request: CodexRequestMessage): void;
+export declare function dynamicToolTextResponse(success: boolean, text: string): CodexDynamicToolCallResponse;
+export declare function extractTotalTokens(params: Record<string, unknown>): number | undefined;
+export {};