@codex-app-sdk/backend 0.13.0

package/dist/codex/generated/v2/ThreadUsageBreakdownGroup.d.ts

@@ -0,0 +1,12 @@
+export type ThreadUsageBreakdownGroup = {
+    model: string | null;
+    reasoningEffort: string | null;
+    speed: string | null;
+    estimatedUsageCreditsMicros: bigint;
+    netNewInputTokens: bigint | null;
+    cachedInputTokens: bigint | null;
+    inputTokens: bigint | null;
+    outputTokens: bigint | null;
+    totalTokens: bigint | null;
+};
+//# sourceMappingURL=ThreadUsageBreakdownGroup.d.ts.map

package/dist/codex/generated/v2/ThreadUsageBreakdownGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadUsageBreakdownGroup.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/ThreadUsageBreakdownGroup.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,yBAAyB,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,2BAA2B,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TokenUsageBreakdown.d.ts

@@ -0,0 +1,9 @@
+export type TokenUsageBreakdown = {
+    totalTokens: number;
+    inputTokens: number;
+    cachedInputTokens: number;
+    cacheWriteInputTokens: number;
+    outputTokens: number;
+    reasoningOutputTokens: number;
+};
+//# sourceMappingURL=TokenUsageBreakdown.d.ts.map

package/dist/codex/generated/v2/TokenUsageBreakdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenUsageBreakdown.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TokenUsageBreakdown.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/ToolRequestUserInputAnswer.d.ts

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

package/dist/codex/generated/v2/ToolRequestUserInputAnswer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRequestUserInputAnswer.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/ToolRequestUserInputAnswer.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/ToolRequestUserInputOption.d.ts

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

package/dist/codex/generated/v2/ToolRequestUserInputOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRequestUserInputOption.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/ToolRequestUserInputOption.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/ToolRequestUserInputParams.d.ts

@@ -0,0 +1,16 @@
+import type { ToolRequestUserInputQuestion } from "./ToolRequestUserInputQuestion";
+/**
+ * EXPERIMENTAL. Params sent with a request_user_input event.
+ */
+export type ToolRequestUserInputParams = {
+    threadId: string;
+    turnId: string;
+    itemId: string;
+    questions: Array<ToolRequestUserInputQuestion>;
+    isBlocking: boolean;
+    /**
+     * @deprecated Use `isBlocking` to decide whether the request should block.
+     */
+    autoResolutionMs: number | null;
+};
+//# sourceMappingURL=ToolRequestUserInputParams.d.ts.map

package/dist/codex/generated/v2/ToolRequestUserInputParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRequestUserInputParams.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/ToolRequestUserInputParams.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IACjK;;OAEG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/ToolRequestUserInputQuestion.d.ts

@@ -0,0 +1,13 @@
+import type { ToolRequestUserInputOption } from "./ToolRequestUserInputOption";
+/**
+ * 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;
+};
+//# sourceMappingURL=ToolRequestUserInputQuestion.d.ts.map

package/dist/codex/generated/v2/ToolRequestUserInputQuestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRequestUserInputQuestion.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/ToolRequestUserInputQuestion.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/ToolRequestUserInputResponse.d.ts

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

package/dist/codex/generated/v2/ToolRequestUserInputResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRequestUserInputResponse.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/ToolRequestUserInputResponse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IAAE,OAAO,EAAE;SAAG,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,0BAA0B;KAAE,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/ToolsV2.d.ts

@@ -0,0 +1,5 @@
+import type { WebSearchToolConfig } from "../WebSearchToolConfig";
+export type ToolsV2 = {
+    web_search: WebSearchToolConfig | null;
+};
+//# sourceMappingURL=ToolsV2.d.ts.map

package/dist/codex/generated/v2/ToolsV2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolsV2.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/ToolsV2.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,MAAM,OAAO,GAAG;IAAE,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/Turn.d.ts

@@ -0,0 +1,36 @@
+import type { ThreadItem } from "./ThreadItem";
+import type { TurnError } from "./TurnError";
+import type { TurnItemsView } from "./TurnItemsView";
+import type { TurnStatus } from "./TurnStatus";
+export type Turn = {
+    /**
+     * Identifier for this turn. Codex-generated turn IDs are UUIDv7.
+     */
+    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;
+};
+//# sourceMappingURL=Turn.d.ts.map

package/dist/codex/generated/v2/Turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Turn.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/Turn.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,IAAI,GAAG;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACzB;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAC7C;;OAEG;IACH,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnCompletedNotification.d.ts

@@ -0,0 +1,6 @@
+import type { Turn } from "./Turn";
+export type TurnCompletedNotification = {
+    threadId: string;
+    turn: Turn;
+};
+//# sourceMappingURL=TurnCompletedNotification.d.ts.map

package/dist/codex/generated/v2/TurnCompletedNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnCompletedNotification.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnCompletedNotification.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,MAAM,MAAM,yBAAyB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnDiffUpdatedNotification.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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;
+};
+//# sourceMappingURL=TurnDiffUpdatedNotification.d.ts.map

package/dist/codex/generated/v2/TurnDiffUpdatedNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnDiffUpdatedNotification.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnDiffUpdatedNotification.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnEnvironmentParams.d.ts

@@ -0,0 +1,10 @@
+import type { LegacyAppPathString } from "../LegacyAppPathString";
+export type TurnEnvironmentParams = {
+    environmentId: string;
+    cwd: LegacyAppPathString;
+    /**
+     * Environment-native runtime workspace roots. Omitted defaults to `cwd`.
+     */
+    runtimeWorkspaceRoots?: Array<LegacyAppPathString> | null;
+};
+//# sourceMappingURL=TurnEnvironmentParams.d.ts.map

package/dist/codex/generated/v2/TurnEnvironmentParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnEnvironmentParams.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnEnvironmentParams.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,mBAAmB,CAAC;IACtF;;OAEG;IACH,qBAAqB,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnError.d.ts

@@ -0,0 +1,12 @@
+import type { CodexErrorInfo } from "./CodexErrorInfo";
+import type { MisalignmentErrorDetails } from "./MisalignmentErrorDetails";
+export type TurnError = {
+    message: string;
+    codexErrorInfo: CodexErrorInfo | null;
+    additionalDetails: string | null;
+    /**
+     * Optional public explanation and continuation instruction for a misalignment block.
+     */
+    misalignment: MisalignmentErrorDetails | null;
+};
+//# sourceMappingURL=TurnError.d.ts.map

package/dist/codex/generated/v2/TurnError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnError.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnError.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE3E,MAAM,MAAM,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnH;;OAEG;IACH,YAAY,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnInterruptParams.d.ts

@@ -0,0 +1,5 @@
+export type TurnInterruptParams = {
+    threadId: string;
+    turnId: string;
+};
+//# sourceMappingURL=TurnInterruptParams.d.ts.map

package/dist/codex/generated/v2/TurnInterruptParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnInterruptParams.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnInterruptParams.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnInterruptResponse.d.ts

@@ -0,0 +1,2 @@
+export type TurnInterruptResponse = Record<string, never>;
+//# sourceMappingURL=TurnInterruptResponse.d.ts.map

package/dist/codex/generated/v2/TurnInterruptResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnInterruptResponse.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnInterruptResponse.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC"}

package/dist/codex/generated/v2/TurnItemsView.d.ts

@@ -0,0 +1,2 @@
+export type TurnItemsView = "notLoaded" | "summary" | "full";
+//# sourceMappingURL=TurnItemsView.d.ts.map

package/dist/codex/generated/v2/TurnItemsView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnItemsView.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnItemsView.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC"}

package/dist/codex/generated/v2/TurnModerationMetadataNotification.d.ts

@@ -0,0 +1,7 @@
+import type { JsonValue } from "../serde_json/JsonValue";
+export type TurnModerationMetadataNotification = {
+    threadId: string;
+    turnId: string;
+    metadata: JsonValue;
+};
+//# sourceMappingURL=TurnModerationMetadataNotification.d.ts.map

package/dist/codex/generated/v2/TurnModerationMetadataNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnModerationMetadataNotification.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnModerationMetadataNotification.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,MAAM,kCAAkC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnPlanStep.d.ts

@@ -0,0 +1,6 @@
+import type { TurnPlanStepStatus } from "./TurnPlanStepStatus";
+export type TurnPlanStep = {
+    step: string;
+    status: TurnPlanStepStatus;
+};
+//# sourceMappingURL=TurnPlanStep.d.ts.map

package/dist/codex/generated/v2/TurnPlanStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnPlanStep.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnPlanStep.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnPlanStepStatus.d.ts

@@ -0,0 +1,2 @@
+export type TurnPlanStepStatus = "pending" | "inProgress" | "completed";
+//# sourceMappingURL=TurnPlanStepStatus.d.ts.map

package/dist/codex/generated/v2/TurnPlanStepStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnPlanStepStatus.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnPlanStepStatus.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC"}

package/dist/codex/generated/v2/TurnPlanUpdatedNotification.d.ts

@@ -0,0 +1,8 @@
+import type { TurnPlanStep } from "./TurnPlanStep";
+export type TurnPlanUpdatedNotification = {
+    threadId: string;
+    turnId: string;
+    explanation: string | null;
+    plan: Array<TurnPlanStep>;
+};
+//# sourceMappingURL=TurnPlanUpdatedNotification.d.ts.map

package/dist/codex/generated/v2/TurnPlanUpdatedNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnPlanUpdatedNotification.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnPlanUpdatedNotification.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,2BAA2B,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnSettingsUpdateParams.d.ts

@@ -0,0 +1,35 @@
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { ReasoningSummary } from "../ReasoningSummary";
+import type { ApprovalsReviewer } from "./ApprovalsReviewer";
+/**
+ * Experimental settings changes for one running turn, not future turns.
+ * Unsupported fields are rejected rather than silently ignored.
+ * Any live task kind may accept publication. Child sessions and consumers of
+ * frozen initial settings are unchanged.
+ */
+export type TurnSettingsUpdateParams = {
+    threadId: string;
+    turnId: string;
+    /**
+     * Changes the active turn's reviewer without changing future thread settings.
+     * Already captured steps and pending approvals retain their original reviewer.
+     */
+    approvalsReviewer?: ApprovalsReviewer | null;
+    /**
+     * Omission or `null` leaves the model unchanged.
+     */
+    model?: string | null;
+    /**
+     * Omission or `null` leaves the effort unchanged.
+     */
+    effort?: ReasoningEffort | null;
+    /**
+     * Omission or `null` leaves the summary preference unchanged.
+     */
+    summary?: ReasoningSummary | null;
+    /**
+     * `null` clears the requested tier; omission leaves it unchanged.
+     */
+    serviceTier?: string | null | null;
+};
+//# sourceMappingURL=TurnSettingsUpdateParams.d.ts.map

package/dist/codex/generated/v2/TurnSettingsUpdateParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnSettingsUpdateParams.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnSettingsUpdateParams.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAC1E;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnSettingsUpdateResponse.d.ts

@@ -0,0 +1,5 @@
+import type { TurnSettingsUpdateStatus } from "./TurnSettingsUpdateStatus";
+export type TurnSettingsUpdateResponse = {
+    status: TurnSettingsUpdateStatus;
+};
+//# sourceMappingURL=TurnSettingsUpdateResponse.d.ts.map

package/dist/codex/generated/v2/TurnSettingsUpdateResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnSettingsUpdateResponse.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnSettingsUpdateResponse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE3E,MAAM,MAAM,0BAA0B,GAAG;IAAE,MAAM,EAAE,wBAAwB,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnSettingsUpdateStatus.d.ts

@@ -0,0 +1,2 @@
+export type TurnSettingsUpdateStatus = "applied" | "targetUnavailable";
+//# sourceMappingURL=TurnSettingsUpdateStatus.d.ts.map

package/dist/codex/generated/v2/TurnSettingsUpdateStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnSettingsUpdateStatus.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnSettingsUpdateStatus.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,mBAAmB,CAAC"}

package/dist/codex/generated/v2/TurnStartParams.d.ts

@@ -0,0 +1,128 @@
+import type { AbsolutePathBuf } from "../AbsolutePathBuf";
+import type { CollaborationMode } from "../CollaborationMode";
+import type { MultiAgentMode } from "../MultiAgentMode";
+import type { Personality } from "../Personality";
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { ReasoningSummary } from "../ReasoningSummary";
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { AdditionalContextEntry } from "./AdditionalContextEntry";
+import type { ApprovalsReviewer } from "./ApprovalsReviewer";
+import type { AskForApproval } from "./AskForApproval";
+import type { CyberAccessProgram } from "./CyberAccessProgram";
+import type { SandboxPolicy } from "./SandboxPolicy";
+import type { TurnEnvironmentParams } from "./TurnEnvironmentParams";
+import type { TurnToolOutput } from "./TurnToolOutput";
+import type { UserInput } from "./UserInput";
+export type TurnStartParams = {
+    threadId: string;
+    clientUserMessageId?: string | null;
+    input: Array<UserInput>;
+    /**
+     * Optional source classification for the caller that starts this turn.
+     * Ignored when this request steers an already-active turn.
+     */
+    turnTrigger?: string | null;
+    toolOutput?: TurnToolOutput | null;
+    /**
+     * Optional metadata to enrich Codex's ResponsesAPI turn metadata.
+     *
+     * Entries are flattened into the JSON string sent as
+     * `client_metadata["x-codex-turn-metadata"]` on ResponsesAPI HTTP and websocket requests.
+     *
+     * They are not sent as top-level ResponsesAPI `client_metadata` keys, and reserved keys
+     * such as `session_id`, `thread_id`, `turn_id`, and `window_id` cannot be overridden.
+     */
+    responsesapiClientMetadata?: {
+        [key in string]?: string;
+    } | null;
+    /**
+     * Optional client-provided context fragments keyed by an opaque source identifier.
+     */
+    additionalContext?: {
+        [key in string]?: AdditionalContextEntry;
+    } | null;
+    /**
+     * Optional environments for this turn and subsequent turns.
+     *
+     * Omitted uses the thread sticky environments. Empty disables
+     * environment access for this turn. Non-empty selects the first
+     * environment as the current turn environment for this turn.
+     */
+    environments?: Array<TurnEnvironmentParams> | null;
+    /**
+     * Override the working directory for this turn and subsequent turns.
+     */
+    cwd?: string | null;
+    /**
+     * Replace the thread's runtime workspace roots for this turn and
+     * subsequent turns. Paths must be absolute.
+     */
+    runtimeWorkspaceRoots?: Array<AbsolutePathBuf> | 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;
+    /**
+     * Select a named permissions profile id for this turn and subsequent
+     * turns. Cannot be combined with `sandboxPolicy`.
+     */
+    permissions?: string | 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 service tier only when this request starts a new turn.
+     * Use "default" for standard speed. Omitted or null inherits the thread's tier.
+     * Does not change the thread's tier or a turn being steered.
+     */
+    serviceTierForTurn?: string | 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;
+    /**
+     * EXPERIMENTAL - Set a pre-set collaboration mode.
+     * Takes precedence over model, reasoning_effort, and developer instructions if set.
+     *
+     * For `collaboration_mode.settings.developer_instructions`, `null` means
+     * "use the built-in instructions for the selected mode".
+     */
+    collaborationMode?: CollaborationMode | null;
+    /**
+     * @deprecated Ignored. Use `effort: "ultra"` for proactive multi-agent behavior.
+     */
+    multiAgentMode?: MultiAgentMode | null;
+    /**
+     * EXPERIMENTAL - Request a workspace-authorized cyber program for this
+     * turn. Omission preserves automatic behavior. This does not grant access.
+     */
+    cyberAccessProgram?: CyberAccessProgram | null;
+};
+//# sourceMappingURL=TurnStartParams.d.ts.map

package/dist/codex/generated/v2/TurnStartParams.d.ts.map

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

package/dist/codex/generated/v2/TurnStartResponse.d.ts

@@ -0,0 +1,5 @@
+import type { Turn } from "./Turn";
+export type TurnStartResponse = {
+    turn: Turn;
+};
+//# sourceMappingURL=TurnStartResponse.d.ts.map

package/dist/codex/generated/v2/TurnStartResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnStartResponse.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnStartResponse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnStartedNotification.d.ts

@@ -0,0 +1,6 @@
+import type { Turn } from "./Turn";
+export type TurnStartedNotification = {
+    threadId: string;
+    turn: Turn;
+};
+//# sourceMappingURL=TurnStartedNotification.d.ts.map

package/dist/codex/generated/v2/TurnStartedNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnStartedNotification.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnStartedNotification.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,MAAM,MAAM,uBAAuB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnStatus.d.ts

@@ -0,0 +1,2 @@
+export type TurnStatus = "completed" | "interrupted" | "failed" | "inProgress";
+//# sourceMappingURL=TurnStatus.d.ts.map

package/dist/codex/generated/v2/TurnStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnStatus.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnStatus.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,YAAY,CAAC"}

package/dist/codex/generated/v2/TurnSteerParams.d.ts

@@ -0,0 +1,31 @@
+import type { AdditionalContextEntry } from "./AdditionalContextEntry";
+import type { UserInput } from "./UserInput";
+export type TurnSteerParams = {
+    threadId: string;
+    clientUserMessageId?: string | null;
+    input: Array<UserInput>;
+    /**
+     * Optional metadata to enrich Codex's ResponsesAPI turn metadata.
+     *
+     * Entries are flattened into the JSON string sent as
+     * `client_metadata["x-codex-turn-metadata"]` on ResponsesAPI HTTP and websocket requests.
+     *
+     * They are not sent as top-level ResponsesAPI `client_metadata` keys, and reserved keys
+     * such as `session_id`, `thread_id`, `turn_id`, and `window_id` cannot be overridden.
+     */
+    responsesapiClientMetadata?: {
+        [key in string]?: string;
+    } | null;
+    /**
+     * Optional client-provided context fragments keyed by an opaque source identifier.
+     */
+    additionalContext?: {
+        [key in string]?: AdditionalContextEntry;
+    } | null;
+    /**
+     * Required active turn id precondition. The request fails when it does not
+     * match the currently active turn.
+     */
+    expectedTurnId: string;
+};
+//# sourceMappingURL=TurnSteerParams.d.ts.map

package/dist/codex/generated/v2/TurnSteerParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnSteerParams.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnSteerParams.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/G;;;;;;;;OAQG;IACH,0BAA0B,CAAC,EAAE;SAAG,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM;KAAE,GAAG,IAAI,CAAC;IACjE;;OAEG;IACH,iBAAiB,CAAC,EAAE;SAAG,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,sBAAsB;KAAE,GAAG,IAAI,CAAC;IACxE;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnSteerResponse.d.ts

@@ -0,0 +1,4 @@
+export type TurnSteerResponse = {
+    turnId: string;
+};
+//# sourceMappingURL=TurnSteerResponse.d.ts.map

package/dist/codex/generated/v2/TurnSteerResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnSteerResponse.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnSteerResponse.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnToolOutput.d.ts

@@ -0,0 +1,7 @@
+import type { FunctionCallOutputBody } from "../FunctionCallOutputBody";
+export type TurnToolOutput = {
+    name: string;
+    namespace: string | null;
+    output: FunctionCallOutputBody;
+};
+//# sourceMappingURL=TurnToolOutput.d.ts.map

package/dist/codex/generated/v2/TurnToolOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnToolOutput.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnToolOutput.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAC;CAAE,CAAC"}

package/dist/codex/generated/v2/TurnsPage.d.ts

@@ -0,0 +1,7 @@
+import type { Turn } from "./Turn";
+export type TurnsPage = {
+    data: Array<Turn>;
+    nextCursor: string | null;
+    backwardsCursor: string | null;
+};
+//# sourceMappingURL=TurnsPage.d.ts.map

package/dist/codex/generated/v2/TurnsPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnsPage.d.ts","sourceRoot":"","sources":["../../../../src/codex/generated/v2/TurnsPage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE,CAAC"}