@jrkropp/codex-js 0.1.4 → 0.3.0

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRealtimeAudioChunk.d.ts

@@ -0,0 +1,10 @@
+/**
+ * EXPERIMENTAL - thread realtime audio chunk.
+ */
+export type ThreadRealtimeAudioChunk = {
+    data: string;
+    sampleRate: number;
+    numChannels: number;
+    samplesPerChannel: number | null;
+    itemId: string | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRealtimeClosedNotification.d.ts

@@ -0,0 +1,7 @@
+/**
+ * EXPERIMENTAL - emitted when thread realtime transport closes.
+ */
+export type ThreadRealtimeClosedNotification = {
+    threadId: string;
+    reason: string | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRealtimeErrorNotification.d.ts

@@ -0,0 +1,7 @@
+/**
+ * EXPERIMENTAL - emitted when thread realtime encounters an error.
+ */
+export type ThreadRealtimeErrorNotification = {
+    threadId: string;
+    message: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRealtimeItemAddedNotification.d.ts

@@ -0,0 +1,8 @@
+import type { JsonValue } from "../serde_json/JsonValue.js";
+/**
+ * EXPERIMENTAL - raw non-audio thread realtime item emitted by the backend.
+ */
+export type ThreadRealtimeItemAddedNotification = {
+    threadId: string;
+    item: JsonValue;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRealtimeOutputAudioDeltaNotification.d.ts

@@ -0,0 +1,8 @@
+import type { ThreadRealtimeAudioChunk } from "./ThreadRealtimeAudioChunk.js";
+/**
+ * EXPERIMENTAL - streamed output audio emitted by thread realtime.
+ */
+export type ThreadRealtimeOutputAudioDeltaNotification = {
+    threadId: string;
+    audio: ThreadRealtimeAudioChunk;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRealtimeSdpNotification.d.ts

@@ -0,0 +1,7 @@
+/**
+ * EXPERIMENTAL - emitted with the remote SDP for a WebRTC realtime session.
+ */
+export type ThreadRealtimeSdpNotification = {
+    threadId: string;
+    sdp: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRealtimeStartTransport.d.ts

@@ -0,0 +1,13 @@
+/**
+ * EXPERIMENTAL - transport used by thread realtime.
+ */
+export type ThreadRealtimeStartTransport = {
+    "type": "websocket";
+} | {
+    "type": "webrtc";
+    /**
+     * SDP offer generated by a WebRTC RTCPeerConnection after configuring audio and the
+     * realtime events data channel.
+     */
+    sdp: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRealtimeStartedNotification.d.ts

@@ -0,0 +1,9 @@
+import type { RealtimeConversationVersion } from "../RealtimeConversationVersion.js";
+/**
+ * EXPERIMENTAL - emitted when thread realtime startup is accepted.
+ */
+export type ThreadRealtimeStartedNotification = {
+    threadId: string;
+    realtimeSessionId: string | null;
+    version: RealtimeConversationVersion;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRealtimeTranscriptDeltaNotification.d.ts

@@ -0,0 +1,12 @@
+/**
+ * EXPERIMENTAL - flat transcript delta emitted whenever realtime
+ * transcript text changes.
+ */
+export type ThreadRealtimeTranscriptDeltaNotification = {
+    threadId: string;
+    role: string;
+    /**
+     * Live transcript delta from the realtime event.
+     */
+    delta: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRealtimeTranscriptDoneNotification.d.ts

@@ -0,0 +1,12 @@
+/**
+ * EXPERIMENTAL - final transcript text emitted when realtime completes
+ * a transcript part.
+ */
+export type ThreadRealtimeTranscriptDoneNotification = {
+    threadId: string;
+    role: string;
+    /**
+     * Final complete text for the transcript part.
+     */
+    text: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadResumeParams.d.ts

@@ -0,0 +1,37 @@
+import type { Personality } from "../Personality.js";
+import type { JsonValue } from "../serde_json/JsonValue.js";
+import type { ApprovalsReviewer } from "./ApprovalsReviewer.js";
+import type { AskForApproval } from "./AskForApproval.js";
+import type { SandboxMode } from "./SandboxMode.js";
+/**
+ * There are three ways to resume a thread:
+ * 1. By thread_id: load the thread from disk by thread_id and resume it.
+ * 2. By history: instantiate the thread from memory and resume it.
+ * 3. By path: load the thread from disk by path and resume it.
+ *
+ * The precedence is: history > path > thread_id.
+ * If using history or path, the thread_id param will be ignored.
+ *
+ * Prefer using thread_id whenever possible.
+ */
+export type ThreadResumeParams = {
+    threadId: string; /**
+     * Configuration overrides for the resumed thread, if any.
+     */
+    model?: string | null;
+    modelProvider?: string | null;
+    serviceTier?: string | null | null;
+    cwd?: string | null;
+    approvalPolicy?: AskForApproval | null; /**
+     * Override where approval requests are routed for review on this thread
+     * and subsequent turns.
+     */
+    approvalsReviewer?: ApprovalsReviewer | null;
+    sandbox?: SandboxMode | null;
+    config?: {
+        [key in string]?: JsonValue;
+    } | null;
+    baseInstructions?: string | null;
+    developerInstructions?: string | null;
+    personality?: Personality | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadResumeResponse.d.ts

@@ -0,0 +1,26 @@
+import type { AbsolutePathBuf } from "../AbsolutePathBuf.js";
+import type { ReasoningEffort } from "../ReasoningEffort.js";
+import type { ApprovalsReviewer } from "./ApprovalsReviewer.js";
+import type { AskForApproval } from "./AskForApproval.js";
+import type { SandboxPolicy } from "./SandboxPolicy.js";
+import type { Thread } from "./Thread.js";
+export type ThreadResumeResponse = {
+    thread: Thread;
+    model: string;
+    modelProvider: string;
+    serviceTier: string | null;
+    cwd: AbsolutePathBuf; /**
+     * Instruction source files currently loaded for this thread.
+     */
+    instructionSources: Array<AbsolutePathBuf>;
+    approvalPolicy: AskForApproval; /**
+     * Reviewer currently used for approval requests on this thread.
+     */
+    approvalsReviewer: ApprovalsReviewer; /**
+     * Legacy sandbox policy retained for compatibility. Experimental clients
+     * should prefer `permissionProfile` when they need exact runtime
+     * permissions.
+     */
+    sandbox: SandboxPolicy;
+    reasoningEffort: ReasoningEffort | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRollbackParams.d.ts

@@ -0,0 +1,10 @@
+export type ThreadRollbackParams = {
+    threadId: string;
+    /**
+     * The number of turns to drop from the end of the thread. Must be >= 1.
+     *
+     * This only modifies the thread's history and does not revert local file changes
+     * that have been made by the agent. Clients are responsible for reverting these changes.
+     */
+    numTurns: number;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadRollbackResponse.d.ts

@@ -0,0 +1,11 @@
+import type { Thread } from "./Thread.js";
+export type ThreadRollbackResponse = {
+    /**
+     * The updated thread after applying the rollback, with `turns` populated.
+     *
+     * The ThreadItems stored in each Turn are lossy since we explicitly do not
+     * persist all agent interactions, such as command executions. This is the same
+     * behavior as `thread/resume`.
+     */
+    thread: Thread;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadSetNameParams.d.ts

@@ -0,0 +1,4 @@
+export type ThreadSetNameParams = {
+    threadId: string;
+    name: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadSetNameResponse.d.ts

@@ -0,0 +1 @@
+export type ThreadSetNameResponse = Record<string, never>;

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadShellCommandParams.d.ts

@@ -0,0 +1,10 @@
+export type ThreadShellCommandParams = {
+    threadId: string;
+    /**
+     * Shell command string evaluated by the thread's configured shell.
+     * Unlike `command/exec`, this intentionally preserves shell syntax
+     * such as pipes, redirects, and quoting. This runs unsandboxed with full
+     * access rather than inheriting the thread sandbox policy.
+     */
+    command: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadShellCommandResponse.d.ts

@@ -0,0 +1 @@
+export type ThreadShellCommandResponse = Record<string, never>;

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadSortKey.d.ts

@@ -0,0 +1 @@
+export type ThreadSortKey = "created_at" | "updated_at";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadSource.d.ts

@@ -0,0 +1 @@
+export type ThreadSource = "user" | "subagent" | "memory_consolidation";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadSourceKind.d.ts

@@ -0,0 +1 @@
+export type ThreadSourceKind = "cli" | "vscode" | "exec" | "appServer" | "subAgent" | "subAgentReview" | "subAgentCompact" | "subAgentThreadSpawn" | "subAgentOther" | "unknown";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadStartParams.d.ts

@@ -0,0 +1,31 @@
+import type { Personality } from "../Personality.js";
+import type { JsonValue } from "../serde_json/JsonValue.js";
+import type { ApprovalsReviewer } from "./ApprovalsReviewer.js";
+import type { AskForApproval } from "./AskForApproval.js";
+import type { SandboxMode } from "./SandboxMode.js";
+import type { ThreadSource } from "./ThreadSource.js";
+import type { ThreadStartSource } from "./ThreadStartSource.js";
+export type ThreadStartParams = {
+    model?: string | null;
+    modelProvider?: string | null;
+    serviceTier?: string | null | null;
+    cwd?: string | null;
+    approvalPolicy?: AskForApproval | null; /**
+     * Override where approval requests are routed for review on this thread
+     * and subsequent turns.
+     */
+    approvalsReviewer?: ApprovalsReviewer | null;
+    sandbox?: SandboxMode | null;
+    config?: {
+        [key in string]?: JsonValue;
+    } | null;
+    serviceName?: string | null;
+    baseInstructions?: string | null;
+    developerInstructions?: string | null;
+    personality?: Personality | null;
+    ephemeral?: boolean | null;
+    sessionStartSource?: ThreadStartSource | null; /**
+     * Optional client-supplied analytics source classification for this thread.
+     */
+    threadSource?: ThreadSource | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadStartResponse.d.ts

@@ -0,0 +1,26 @@
+import type { AbsolutePathBuf } from "../AbsolutePathBuf.js";
+import type { ReasoningEffort } from "../ReasoningEffort.js";
+import type { ApprovalsReviewer } from "./ApprovalsReviewer.js";
+import type { AskForApproval } from "./AskForApproval.js";
+import type { SandboxPolicy } from "./SandboxPolicy.js";
+import type { Thread } from "./Thread.js";
+export type ThreadStartResponse = {
+    thread: Thread;
+    model: string;
+    modelProvider: string;
+    serviceTier: string | null;
+    cwd: AbsolutePathBuf; /**
+     * Instruction source files currently loaded for this thread.
+     */
+    instructionSources: Array<AbsolutePathBuf>;
+    approvalPolicy: AskForApproval; /**
+     * Reviewer currently used for approval requests on this thread.
+     */
+    approvalsReviewer: ApprovalsReviewer; /**
+     * Legacy sandbox policy retained for compatibility. Experimental clients
+     * should prefer `permissionProfile` when they need exact runtime
+     * permissions.
+     */
+    sandbox: SandboxPolicy;
+    reasoningEffort: ReasoningEffort | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadStartSource.d.ts

@@ -0,0 +1 @@
+export type ThreadStartSource = "startup" | "clear";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadStartedNotification.d.ts

@@ -0,0 +1,4 @@
+import type { Thread } from "./Thread.js";
+export type ThreadStartedNotification = {
+    thread: Thread;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadStatus.d.ts

@@ -0,0 +1,11 @@
+import type { ThreadActiveFlag } from "./ThreadActiveFlag.js";
+export type ThreadStatus = {
+    "type": "notLoaded";
+} | {
+    "type": "idle";
+} | {
+    "type": "systemError";
+} | {
+    "type": "active";
+    activeFlags: Array<ThreadActiveFlag>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadStatusChangedNotification.d.ts

@@ -0,0 +1,5 @@
+import type { ThreadStatus } from "./ThreadStatus.js";
+export type ThreadStatusChangedNotification = {
+    threadId: string;
+    status: ThreadStatus;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadTokenUsage.d.ts

@@ -0,0 +1,6 @@
+import type { TokenUsageBreakdown } from "./TokenUsageBreakdown.js";
+export type ThreadTokenUsage = {
+    total: TokenUsageBreakdown;
+    last: TokenUsageBreakdown;
+    modelContextWindow: number | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadTokenUsageUpdatedNotification.d.ts

@@ -0,0 +1,6 @@
+import type { ThreadTokenUsage } from "./ThreadTokenUsage.js";
+export type ThreadTokenUsageUpdatedNotification = {
+    threadId: string;
+    turnId: string;
+    tokenUsage: ThreadTokenUsage;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadUnarchiveParams.d.ts

@@ -0,0 +1,3 @@
+export type ThreadUnarchiveParams = {
+    threadId: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadUnarchiveResponse.d.ts

@@ -0,0 +1,4 @@
+import type { Thread } from "./Thread.js";
+export type ThreadUnarchiveResponse = {
+    thread: Thread;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadUnarchivedNotification.d.ts

@@ -0,0 +1,3 @@
+export type ThreadUnarchivedNotification = {
+    threadId: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadUnsubscribeParams.d.ts

@@ -0,0 +1,3 @@
+export type ThreadUnsubscribeParams = {
+    threadId: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadUnsubscribeResponse.d.ts

@@ -0,0 +1,4 @@
+import type { ThreadUnsubscribeStatus } from "./ThreadUnsubscribeStatus.js";
+export type ThreadUnsubscribeResponse = {
+    status: ThreadUnsubscribeStatus;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ThreadUnsubscribeStatus.d.ts

@@ -0,0 +1 @@
+export type ThreadUnsubscribeStatus = "notLoaded" | "notSubscribed" | "unsubscribed";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TokenUsageBreakdown.d.ts

@@ -0,0 +1,7 @@
+export type TokenUsageBreakdown = {
+    totalTokens: number;
+    inputTokens: number;
+    cachedInputTokens: number;
+    outputTokens: number;
+    reasoningOutputTokens: number;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ToolRequestUserInputAnswer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * EXPERIMENTAL. Captures a user's answer to a request_user_input question.
+ */
+export type ToolRequestUserInputAnswer = {
+    answers: Array<string>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ToolRequestUserInputOption.d.ts

@@ -0,0 +1,7 @@
+/**
+ * EXPERIMENTAL. Defines a single selectable option for request_user_input.
+ */
+export type ToolRequestUserInputOption = {
+    label: string;
+    description: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ToolRequestUserInputParams.d.ts

@@ -0,0 +1,10 @@
+import type { ToolRequestUserInputQuestion } from "./ToolRequestUserInputQuestion.js";
+/**
+ * EXPERIMENTAL. Params sent with a request_user_input event.
+ */
+export type ToolRequestUserInputParams = {
+    threadId: string;
+    turnId: string;
+    itemId: string;
+    questions: Array<ToolRequestUserInputQuestion>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ToolRequestUserInputQuestion.d.ts

@@ -0,0 +1,12 @@
+import type { ToolRequestUserInputOption } from "./ToolRequestUserInputOption.js";
+/**
+ * EXPERIMENTAL. Represents one request_user_input question and its required options.
+ */
+export type ToolRequestUserInputQuestion = {
+    id: string;
+    header: string;
+    question: string;
+    isOther: boolean;
+    isSecret: boolean;
+    options: Array<ToolRequestUserInputOption> | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ToolRequestUserInputResponse.d.ts

@@ -0,0 +1,9 @@
+import type { ToolRequestUserInputAnswer } from "./ToolRequestUserInputAnswer.js";
+/**
+ * EXPERIMENTAL. Response payload mapping question ids to answers.
+ */
+export type ToolRequestUserInputResponse = {
+    answers: {
+        [key in string]?: ToolRequestUserInputAnswer;
+    };
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/ToolsV2.d.ts

@@ -0,0 +1,5 @@
+import type { WebSearchToolConfig } from "../WebSearchToolConfig.js";
+export type ToolsV2 = {
+    web_search: WebSearchToolConfig | null;
+    view_image: boolean | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/Turn.d.ts

@@ -0,0 +1,32 @@
+import type { ThreadItem } from "./ThreadItem.js";
+import type { TurnError } from "./TurnError.js";
+import type { TurnItemsView } from "./TurnItemsView.js";
+import type { TurnStatus } from "./TurnStatus.js";
+export type Turn = {
+    id: string;
+    /**
+     * Thread items currently included in this turn payload.
+     */
+    items: Array<ThreadItem>;
+    /**
+     * Describes how much of `items` has been loaded for this turn.
+     */
+    itemsView: TurnItemsView;
+    status: TurnStatus;
+    /**
+     * Only populated when the Turn's status is failed.
+     */
+    error: TurnError | null;
+    /**
+     * Unix timestamp (in seconds) when the turn started.
+     */
+    startedAt: number | null;
+    /**
+     * Unix timestamp (in seconds) when the turn completed.
+     */
+    completedAt: number | null;
+    /**
+     * Duration between turn start and completion in milliseconds, if known.
+     */
+    durationMs: number | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnCompletedNotification.d.ts

@@ -0,0 +1,5 @@
+import type { Turn } from "./Turn.js";
+export type TurnCompletedNotification = {
+    threadId: string;
+    turn: Turn;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnDiffUpdatedNotification.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Notification that the turn-level unified diff has changed.
+ * Contains the latest aggregated diff across all file changes in the turn.
+ */
+export type TurnDiffUpdatedNotification = {
+    threadId: string;
+    turnId: string;
+    diff: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnEnvironmentParams.d.ts

@@ -0,0 +1,5 @@
+import type { AbsolutePathBuf } from "../AbsolutePathBuf.js";
+export type TurnEnvironmentParams = {
+    environmentId: string;
+    cwd: AbsolutePathBuf;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnError.d.ts

@@ -0,0 +1,6 @@
+import type { CodexErrorInfo } from "./CodexErrorInfo.js";
+export type TurnError = {
+    message: string;
+    codexErrorInfo: CodexErrorInfo | null;
+    additionalDetails: string | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnInterruptParams.d.ts

@@ -0,0 +1,4 @@
+export type TurnInterruptParams = {
+    threadId: string;
+    turnId: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnInterruptResponse.d.ts

@@ -0,0 +1 @@
+export type TurnInterruptResponse = Record<string, never>;

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnItemsView.d.ts

@@ -0,0 +1 @@
+export type TurnItemsView = "notLoaded" | "summary" | "full";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnPlanStep.d.ts

@@ -0,0 +1,5 @@
+import type { TurnPlanStepStatus } from "./TurnPlanStepStatus.js";
+export type TurnPlanStep = {
+    step: string;
+    status: TurnPlanStepStatus;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnPlanStepStatus.d.ts

@@ -0,0 +1 @@
+export type TurnPlanStepStatus = "pending" | "inProgress" | "completed";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnPlanUpdatedNotification.d.ts

@@ -0,0 +1,7 @@
+import type { TurnPlanStep } from "./TurnPlanStep.js";
+export type TurnPlanUpdatedNotification = {
+    threadId: string;
+    turnId: string;
+    explanation: string | null;
+    plan: Array<TurnPlanStep>;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnStartParams.d.ts

@@ -0,0 +1,44 @@
+import type { Personality } from "../Personality.js";
+import type { ReasoningEffort } from "../ReasoningEffort.js";
+import type { ReasoningSummary } from "../ReasoningSummary.js";
+import type { JsonValue } from "../serde_json/JsonValue.js";
+import type { ApprovalsReviewer } from "./ApprovalsReviewer.js";
+import type { AskForApproval } from "./AskForApproval.js";
+import type { SandboxPolicy } from "./SandboxPolicy.js";
+import type { UserInput } from "./UserInput.js";
+export type TurnStartParams = {
+    threadId: string;
+    input: Array<UserInput>; /**
+     * Override the working directory for this turn and subsequent turns.
+     */
+    cwd?: string | null; /**
+     * Override the approval policy for this turn and subsequent turns.
+     */
+    approvalPolicy?: AskForApproval | null; /**
+     * Override where approval requests are routed for review on this turn and
+     * subsequent turns.
+     */
+    approvalsReviewer?: ApprovalsReviewer | null; /**
+     * Override the sandbox policy for this turn and subsequent turns.
+     */
+    sandboxPolicy?: SandboxPolicy | null; /**
+     * Override the model for this turn and subsequent turns.
+     */
+    model?: string | null; /**
+     * Override the service tier for this turn and subsequent turns.
+     */
+    serviceTier?: string | null | null; /**
+     * Override the reasoning effort for this turn and subsequent turns.
+     */
+    effort?: ReasoningEffort | null; /**
+     * Override the reasoning summary for this turn and subsequent turns.
+     */
+    summary?: ReasoningSummary | null; /**
+     * Override the personality for this turn and subsequent turns.
+     */
+    personality?: Personality | null; /**
+     * Optional JSON Schema used to constrain the final assistant message for
+     * this turn.
+     */
+    outputSchema?: JsonValue | null;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnStartResponse.d.ts

@@ -0,0 +1,4 @@
+import type { Turn } from "./Turn.js";
+export type TurnStartResponse = {
+    turn: Turn;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnStartedNotification.d.ts

@@ -0,0 +1,5 @@
+import type { Turn } from "./Turn.js";
+export type TurnStartedNotification = {
+    threadId: string;
+    turn: Turn;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnStatus.d.ts

@@ -0,0 +1 @@
+export type TurnStatus = "completed" | "interrupted" | "failed" | "inProgress";

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnSteerParams.d.ts

@@ -0,0 +1,9 @@
+import type { UserInput } from "./UserInput.js";
+export type TurnSteerParams = {
+    threadId: string;
+    input: Array<UserInput>; /**
+     * Required active turn id precondition. The request fails when it does not
+     * match the currently active turn.
+     */
+    expectedTurnId: string;
+};

package/dist/internal/codex/app-server-protocol/schema/typescript/v2/TurnSteerResponse.d.ts

@@ -0,0 +1,3 @@
+export type TurnSteerResponse = {
+    turnId: string;
+};