mcp-codex-worker 0.1.0

package/src/mcp/tool-definitions.ts

@@ -0,0 +1,280 @@
+import { z } from 'zod';
+
+const jsonSchema = { type: 'object' as const };
+
+const threadStartSchema = z.object({
+  model: z.string().optional(),
+  cwd: z.string().optional(),
+  developer_instructions: z.string().optional(),
+});
+
+const threadResumeSchema = z.object({
+  thread_id: z.string().min(1),
+  model: z.string().optional(),
+  cwd: z.string().optional(),
+  developer_instructions: z.string().optional(),
+});
+
+const threadReadSchema = z.object({
+  thread_id: z.string().min(1),
+  include_turns: z.boolean().optional(),
+});
+
+const threadListSchema = z.object({
+  limit: z.number().int().positive().max(100).optional(),
+  cursor: z.string().optional(),
+});
+
+const turnStartSchema = z.object({
+  thread_id: z.string().min(1),
+  user_input: z.string().min(1),
+  model: z.string().optional(),
+});
+
+const turnSteerSchema = z.object({
+  thread_id: z.string().min(1),
+  expected_turn_id: z.string().min(1),
+  user_input: z.string().min(1),
+});
+
+const turnInterruptSchema = z.object({
+  thread_id: z.string().min(1),
+  turn_id: z.string().min(1),
+});
+
+const requestListSchema = z.object({
+  include_resolved: z.boolean().optional(),
+});
+
+const requestReadSchema = z.object({
+  request_id: z.union([z.string(), z.number()]),
+});
+
+const requestRespondSchema = z.object({
+  request_id: z.union([z.string(), z.number()]),
+  payload: z.record(z.string(), z.unknown()).optional(),
+  decision: z.union([z.string(), z.record(z.string(), z.unknown())]).optional(),
+  answers: z.record(z.string(), z.object({ answers: z.array(z.string()) })).optional(),
+  action: z.enum(['accept', 'decline', 'cancel']).optional(),
+  content: z.unknown().optional(),
+  meta: z.unknown().optional(),
+  scope: z.enum(['turn', 'session']).optional(),
+  permissions: z.record(z.string(), z.unknown()).optional(),
+});
+
+const waitSchema = z.object({
+  operation_id: z.string().optional(),
+  thread_id: z.string().optional(),
+  timeout_ms: z.number().int().positive().max(300_000).optional(),
+  poll_interval_ms: z.number().int().positive().max(5_000).optional(),
+});
+
+export interface ToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: 'object';
+    properties?: Record<string, unknown>;
+    required?: string[];
+  };
+  validate: (value: unknown) => unknown;
+}
+
+function objectSchema(
+  properties: Record<string, unknown>,
+  required: string[] = [],
+): ToolDefinition['inputSchema'] {
+  return {
+    type: 'object',
+    properties,
+    ...(required.length > 0 ? { required } : {}),
+  };
+}
+
+export function createToolDefinitions(modelIds: string[]): ToolDefinition[] {
+  return [
+    {
+      name: 'thread-start',
+      description: [
+        'Create a new Codex conversation thread.',
+        'Each thread is an independent agent workspace. Launch multiple threads in parallel to work on different tasks concurrently.',
+        'Returns thread_id for use with turn-start.',
+      ].join(' '),
+      inputSchema: objectSchema({
+        model: {
+          type: 'string',
+          ...(modelIds.length > 0 ? { enum: modelIds } : {}),
+          description: 'Model to use for this thread. If omitted, Codex uses the account default.',
+        },
+        cwd: {
+          type: 'string',
+          description: 'Working directory for the agent. Defaults to server process cwd.',
+        },
+        developer_instructions: {
+          type: 'string',
+          description: 'System-level instructions injected before user messages. Use for constraints, coding style, or scope boundaries.',
+        },
+      }),
+      validate: (value) => threadStartSchema.parse(value),
+    },
+    {
+      name: 'thread-resume',
+      description: 'Resume an existing Codex thread that was previously started. Reloads context and reconnects the agent to the conversation.',
+      inputSchema: objectSchema({
+        thread_id: { type: 'string', minLength: 1, description: 'ID of the thread to resume.' },
+        model: {
+          type: 'string',
+          ...(modelIds.length > 0 ? { enum: modelIds } : {}),
+          description: 'Optionally switch model when resuming.',
+        },
+        cwd: { type: 'string', description: 'Override working directory for the resumed thread.' },
+        developer_instructions: { type: 'string', description: 'Update system instructions on resume.' },
+      }, ['thread_id']),
+      validate: (value) => threadResumeSchema.parse(value),
+    },
+    {
+      name: 'thread-read',
+      description: 'Read a thread and its conversation history. Use include_turns=true to get full turn details.',
+      inputSchema: objectSchema({
+        thread_id: { type: 'string', minLength: 1, description: 'Thread to read.' },
+        include_turns: { type: 'boolean', description: 'Include full turn history. Defaults to true.' },
+      }, ['thread_id']),
+      validate: (value) => threadReadSchema.parse(value),
+    },
+    {
+      name: 'thread-list',
+      description: 'List recent Codex threads. Use to discover existing conversations before starting new ones.',
+      inputSchema: objectSchema({
+        limit: { type: 'integer', minimum: 1, maximum: 100, description: 'Max threads to return. Default 50.' },
+        cursor: { type: 'string', description: 'Pagination cursor from a previous response.' },
+      }),
+      validate: (value) => threadListSchema.parse(value),
+    },
+    {
+      name: 'turn-start',
+      description: [
+        'Send a user message to an active thread, starting a new agent turn.',
+        'The agent will execute autonomously — use wait or turn-steer to monitor or redirect.',
+        'For parallel work, start turns on multiple threads simultaneously.',
+      ].join(' '),
+      inputSchema: objectSchema({
+        thread_id: { type: 'string', minLength: 1, description: 'Thread to send the message to.' },
+        user_input: { type: 'string', minLength: 1, description: 'The user message or task instruction.' },
+        model: {
+          type: 'string',
+          ...(modelIds.length > 0 ? { enum: modelIds } : {}),
+          description: 'Override model for this turn only.',
+        },
+      }, ['thread_id', 'user_input']),
+      validate: (value) => turnStartSchema.parse(value),
+    },
+    {
+      name: 'turn-steer',
+      description: 'Redirect an in-progress turn with new instructions. The agent adjusts its approach without losing prior context.',
+      inputSchema: objectSchema({
+        thread_id: { type: 'string', minLength: 1, description: 'Thread containing the active turn.' },
+        expected_turn_id: { type: 'string', minLength: 1, description: 'Turn ID to steer. Must be the currently active turn.' },
+        user_input: { type: 'string', minLength: 1, description: 'New instructions to redirect the agent.' },
+      }, ['thread_id', 'expected_turn_id', 'user_input']),
+      validate: (value) => turnSteerSchema.parse(value),
+    },
+    {
+      name: 'turn-interrupt',
+      description: 'Stop an active turn immediately. Use when the agent is heading in the wrong direction or a task should be cancelled.',
+      inputSchema: objectSchema({
+        thread_id: { type: 'string', minLength: 1, description: 'Thread containing the turn.' },
+        turn_id: { type: 'string', minLength: 1, description: 'Turn ID to interrupt.' },
+      }, ['thread_id', 'turn_id']),
+      validate: (value) => turnInterruptSchema.parse(value),
+    },
+    {
+      name: 'model-list',
+      description: 'List all available models for the authenticated Codex account.',
+      inputSchema: jsonSchema,
+      validate: (value) => value ?? {},
+    },
+    {
+      name: 'account-read',
+      description: 'Read the authenticated Codex account details — username, plan, and capabilities.',
+      inputSchema: jsonSchema,
+      validate: (value) => value ?? {},
+    },
+    {
+      name: 'account-rate-limits-read',
+      description: 'Read current rate limit status for the Codex account. Check before launching many parallel threads.',
+      inputSchema: jsonSchema,
+      validate: (value) => value ?? {},
+    },
+    {
+      name: 'skills-list',
+      description: 'List registered Codex skills available in this session.',
+      inputSchema: jsonSchema,
+      validate: (value) => value ?? {},
+    },
+    {
+      name: 'app-list',
+      description: 'List Codex apps available in this session.',
+      inputSchema: jsonSchema,
+      validate: (value) => value ?? {},
+    },
+    {
+      name: 'request-list',
+      description: 'List pending Codex server requests awaiting approval (command execution, file changes, permissions). Check this after starting turns — agents often need permission to proceed.',
+      inputSchema: objectSchema({
+        include_resolved: { type: 'boolean', description: 'Include already-resolved requests. Default false.' },
+      }),
+      validate: (value) => requestListSchema.parse(value),
+    },
+    {
+      name: 'request-read',
+      description: 'Read details of a specific pending server request. Use to understand what the agent is asking before responding.',
+      inputSchema: objectSchema({
+        request_id: { type: ['string', 'number'], description: 'ID of the pending request.' },
+      }, ['request_id']),
+      validate: (value) => requestReadSchema.parse(value),
+    },
+    {
+      name: 'request-respond',
+      description: [
+        'Respond to a pending Codex server request (approve commands, grant permissions, answer questions).',
+        'The response shape depends on the request method. For command/file approvals use decision="accept".',
+        'For permission grants use scope and permissions. The tool auto-builds the right payload shape for common methods.',
+      ].join(' '),
+      inputSchema: objectSchema({
+        request_id: { type: ['string', 'number'], description: 'ID of the request to respond to.' },
+        payload: { type: 'object', description: 'Raw response payload. Overrides all other fields if provided.' },
+        decision: { type: ['string', 'object'], description: 'For approval requests: "accept", "decline", or a structured decision.' },
+        answers: { type: 'object', description: 'For user input requests: map of question keys to answer arrays.' },
+        action: { type: 'string', enum: ['accept', 'decline', 'cancel'], description: 'For elicitation requests.' },
+        content: { description: 'Content payload for elicitation responses.' },
+        meta: { description: 'Metadata for elicitation responses.' },
+        scope: { type: 'string', enum: ['turn', 'session'], description: 'Permission grant scope. Default "session".' },
+        permissions: { type: 'object', description: 'Permission map for permission approval requests.' },
+      }, ['request_id']),
+      validate: (value) => requestRespondSchema.parse(value),
+    },
+    {
+      name: 'wait',
+      description: 'Block until a Codex operation completes or a pending request appears. Use after turn-start to wait for the agent to finish or ask for approval. Provide either operation_id or thread_id.',
+      inputSchema: objectSchema({
+        operation_id: { type: 'string', description: 'Operation ID to wait on (from a turn-start response).' },
+        thread_id: { type: 'string', description: 'Thread ID to wait on — polls until thread status is no longer active.' },
+        timeout_ms: { type: 'integer', minimum: 1, maximum: 300000, description: 'Max wait time in ms. Default 120,000 (2 minutes).' },
+        poll_interval_ms: { type: 'integer', minimum: 1, maximum: 5000, description: 'Poll interval in ms. Default 250.' },
+      }),
+      validate: (value) => waitSchema.parse(value),
+    },
+  ];
+}
+
+export type ThreadStartInput = z.infer<typeof threadStartSchema>;
+export type ThreadResumeInput = z.infer<typeof threadResumeSchema>;
+export type ThreadReadInput = z.infer<typeof threadReadSchema>;
+export type ThreadListInput = z.infer<typeof threadListSchema>;
+export type TurnStartInput = z.infer<typeof turnStartSchema>;
+export type TurnSteerInput = z.infer<typeof turnSteerSchema>;
+export type TurnInterruptInput = z.infer<typeof turnInterruptSchema>;
+export type RequestListInput = z.infer<typeof requestListSchema>;
+export type RequestReadInput = z.infer<typeof requestReadSchema>;
+export type RequestRespondInput = z.infer<typeof requestRespondSchema>;
+export type WaitInput = z.infer<typeof waitSchema>;

package/src/protocol/AbsolutePathBuf.ts

@@ -0,0 +1,14 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * A path that is guaranteed to be absolute and normalized (though it is not
+ * guaranteed to be canonicalized or exist on the filesystem).
+ *
+ * IMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set
+ * using [AbsolutePathBufGuard::new]. If no base path is set, the
+ * deserialization will fail unless the path being deserialized is already
+ * absolute.
+ */
+export type AbsolutePathBuf = string;

package/src/protocol/AgentPath.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentPath = string;

package/src/protocol/ApplyPatchApprovalParams.ts

@@ -0,0 +1,21 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FileChange } from "./FileChange";
+import type { ThreadId } from "./ThreadId";
+
+export type ApplyPatchApprovalParams = { conversationId: ThreadId, 
+/**
+ * Use to correlate this with [codex_protocol::protocol::PatchApplyBeginEvent]
+ * and [codex_protocol::protocol::PatchApplyEndEvent].
+ */
+callId: string, fileChanges: { [key in string]?: FileChange }, 
+/**
+ * Optional explanatory reason (e.g. request for extra write access).
+ */
+reason: string | null, 
+/**
+ * When set, the agent is asking the user to allow writes under this root
+ * for the remainder of the session (unclear if this is honored today).
+ */
+grantRoot: string | null, };

package/src/protocol/ApplyPatchApprovalResponse.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewDecision } from "./ReviewDecision";
+
+export type ApplyPatchApprovalResponse = { decision: ReviewDecision, };

package/src/protocol/AuthMode.ts

@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Authentication mode for OpenAI-backed providers.
+ */
+export type AuthMode = "apikey" | "chatgpt" | "chatgptAuthTokens";

package/src/protocol/ClientInfo.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ClientInfo = { name: string, title: string | null, version: string, };

package/src/protocol/ClientNotification.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ClientNotification = { "method": "initialized" };

package/src/protocol/ClientRequest.ts

@@ -0,0 +1,67 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FuzzyFileSearchParams } from "./FuzzyFileSearchParams";
+import type { GetAuthStatusParams } from "./GetAuthStatusParams";
+import type { GetConversationSummaryParams } from "./GetConversationSummaryParams";
+import type { GitDiffToRemoteParams } from "./GitDiffToRemoteParams";
+import type { InitializeParams } from "./InitializeParams";
+import type { RequestId } from "./RequestId";
+import type { AppsListParams } from "./v2/AppsListParams";
+import type { CancelLoginAccountParams } from "./v2/CancelLoginAccountParams";
+import type { CommandExecParams } from "./v2/CommandExecParams";
+import type { CommandExecResizeParams } from "./v2/CommandExecResizeParams";
+import type { CommandExecTerminateParams } from "./v2/CommandExecTerminateParams";
+import type { CommandExecWriteParams } from "./v2/CommandExecWriteParams";
+import type { ConfigBatchWriteParams } from "./v2/ConfigBatchWriteParams";
+import type { ConfigReadParams } from "./v2/ConfigReadParams";
+import type { ConfigValueWriteParams } from "./v2/ConfigValueWriteParams";
+import type { ExperimentalFeatureEnablementSetParams } from "./v2/ExperimentalFeatureEnablementSetParams";
+import type { ExperimentalFeatureListParams } from "./v2/ExperimentalFeatureListParams";
+import type { ExternalAgentConfigDetectParams } from "./v2/ExternalAgentConfigDetectParams";
+import type { ExternalAgentConfigImportParams } from "./v2/ExternalAgentConfigImportParams";
+import type { FeedbackUploadParams } from "./v2/FeedbackUploadParams";
+import type { FsCopyParams } from "./v2/FsCopyParams";
+import type { FsCreateDirectoryParams } from "./v2/FsCreateDirectoryParams";
+import type { FsGetMetadataParams } from "./v2/FsGetMetadataParams";
+import type { FsReadDirectoryParams } from "./v2/FsReadDirectoryParams";
+import type { FsReadFileParams } from "./v2/FsReadFileParams";
+import type { FsRemoveParams } from "./v2/FsRemoveParams";
+import type { FsUnwatchParams } from "./v2/FsUnwatchParams";
+import type { FsWatchParams } from "./v2/FsWatchParams";
+import type { FsWriteFileParams } from "./v2/FsWriteFileParams";
+import type { GetAccountParams } from "./v2/GetAccountParams";
+import type { ListMcpServerStatusParams } from "./v2/ListMcpServerStatusParams";
+import type { LoginAccountParams } from "./v2/LoginAccountParams";
+import type { McpServerOauthLoginParams } from "./v2/McpServerOauthLoginParams";
+import type { ModelListParams } from "./v2/ModelListParams";
+import type { PluginInstallParams } from "./v2/PluginInstallParams";
+import type { PluginListParams } from "./v2/PluginListParams";
+import type { PluginReadParams } from "./v2/PluginReadParams";
+import type { PluginUninstallParams } from "./v2/PluginUninstallParams";
+import type { ReviewStartParams } from "./v2/ReviewStartParams";
+import type { SkillsConfigWriteParams } from "./v2/SkillsConfigWriteParams";
+import type { SkillsListParams } from "./v2/SkillsListParams";
+import type { ThreadArchiveParams } from "./v2/ThreadArchiveParams";
+import type { ThreadCompactStartParams } from "./v2/ThreadCompactStartParams";
+import type { ThreadForkParams } from "./v2/ThreadForkParams";
+import type { ThreadListParams } from "./v2/ThreadListParams";
+import type { ThreadLoadedListParams } from "./v2/ThreadLoadedListParams";
+import type { ThreadMetadataUpdateParams } from "./v2/ThreadMetadataUpdateParams";
+import type { ThreadReadParams } from "./v2/ThreadReadParams";
+import type { ThreadResumeParams } from "./v2/ThreadResumeParams";
+import type { ThreadRollbackParams } from "./v2/ThreadRollbackParams";
+import type { ThreadSetNameParams } from "./v2/ThreadSetNameParams";
+import type { ThreadShellCommandParams } from "./v2/ThreadShellCommandParams";
+import type { ThreadStartParams } from "./v2/ThreadStartParams";
+import type { ThreadUnarchiveParams } from "./v2/ThreadUnarchiveParams";
+import type { ThreadUnsubscribeParams } from "./v2/ThreadUnsubscribeParams";
+import type { TurnInterruptParams } from "./v2/TurnInterruptParams";
+import type { TurnStartParams } from "./v2/TurnStartParams";
+import type { TurnSteerParams } from "./v2/TurnSteerParams";
+import type { WindowsSandboxSetupStartParams } from "./v2/WindowsSandboxSetupStartParams";
+
+/**
+ * Request from the client to the server.
+ */
+export type ClientRequest ={ "method": "initialize", id: RequestId, params: InitializeParams, } | { "method": "thread/start", id: RequestId, params: ThreadStartParams, } | { "method": "thread/resume", id: RequestId, params: ThreadResumeParams, } | { "method": "thread/fork", id: RequestId, params: ThreadForkParams, } | { "method": "thread/archive", id: RequestId, params: ThreadArchiveParams, } | { "method": "thread/unsubscribe", id: RequestId, params: ThreadUnsubscribeParams, } | { "method": "thread/name/set", id: RequestId, params: ThreadSetNameParams, } | { "method": "thread/metadata/update", id: RequestId, params: ThreadMetadataUpdateParams, } | { "method": "thread/unarchive", id: RequestId, params: ThreadUnarchiveParams, } | { "method": "thread/compact/start", id: RequestId, params: ThreadCompactStartParams, } | { "method": "thread/shellCommand", id: RequestId, params: ThreadShellCommandParams, } | { "method": "thread/rollback", id: RequestId, params: ThreadRollbackParams, } | { "method": "thread/list", id: RequestId, params: ThreadListParams, } | { "method": "thread/loaded/list", id: RequestId, params: ThreadLoadedListParams, } | { "method": "thread/read", id: RequestId, params: ThreadReadParams, } | { "method": "skills/list", id: RequestId, params: SkillsListParams, } | { "method": "plugin/list", id: RequestId, params: PluginListParams, } | { "method": "plugin/read", id: RequestId, params: PluginReadParams, } | { "method": "app/list", id: RequestId, params: AppsListParams, } | { "method": "fs/readFile", id: RequestId, params: FsReadFileParams, } | { "method": "fs/writeFile", id: RequestId, params: FsWriteFileParams, } | { "method": "fs/createDirectory", id: RequestId, params: FsCreateDirectoryParams, } | { "method": "fs/getMetadata", id: RequestId, params: FsGetMetadataParams, } | { "method": "fs/readDirectory", id: RequestId, params: FsReadDirectoryParams, } | { "method": "fs/remove", id: RequestId, params: FsRemoveParams, } | { "method": "fs/copy", id: RequestId, params: FsCopyParams, } | { "method": "fs/watch", id: RequestId, params: FsWatchParams, } | { "method": "fs/unwatch", id: RequestId, params: FsUnwatchParams, } | { "method": "skills/config/write", id: RequestId, params: SkillsConfigWriteParams, } | { "method": "plugin/install", id: RequestId, params: PluginInstallParams, } | { "method": "plugin/uninstall", id: RequestId, params: PluginUninstallParams, } | { "method": "turn/start", id: RequestId, params: TurnStartParams, } | { "method": "turn/steer", id: RequestId, params: TurnSteerParams, } | { "method": "turn/interrupt", id: RequestId, params: TurnInterruptParams, } | { "method": "review/start", id: RequestId, params: ReviewStartParams, } | { "method": "model/list", id: RequestId, params: ModelListParams, } | { "method": "experimentalFeature/list", id: RequestId, params: ExperimentalFeatureListParams, } | { "method": "experimentalFeature/enablement/set", id: RequestId, params: ExperimentalFeatureEnablementSetParams, } | { "method": "mcpServer/oauth/login", id: RequestId, params: McpServerOauthLoginParams, } | { "method": "config/mcpServer/reload", id: RequestId, params: undefined, } | { "method": "mcpServerStatus/list", id: RequestId, params: ListMcpServerStatusParams, } | { "method": "windowsSandbox/setupStart", id: RequestId, params: WindowsSandboxSetupStartParams, } | { "method": "account/login/start", id: RequestId, params: LoginAccountParams, } | { "method": "account/login/cancel", id: RequestId, params: CancelLoginAccountParams, } | { "method": "account/logout", id: RequestId, params: undefined, } | { "method": "account/rateLimits/read", id: RequestId, params: undefined, } | { "method": "feedback/upload", id: RequestId, params: FeedbackUploadParams, } | { "method": "command/exec", id: RequestId, params: CommandExecParams, } | { "method": "command/exec/write", id: RequestId, params: CommandExecWriteParams, } | { "method": "command/exec/terminate", id: RequestId, params: CommandExecTerminateParams, } | { "method": "command/exec/resize", id: RequestId, params: CommandExecResizeParams, } | { "method": "config/read", id: RequestId, params: ConfigReadParams, } | { "method": "externalAgentConfig/detect", id: RequestId, params: ExternalAgentConfigDetectParams, } | { "method": "externalAgentConfig/import", id: RequestId, params: ExternalAgentConfigImportParams, } | { "method": "config/value/write", id: RequestId, params: ConfigValueWriteParams, } | { "method": "config/batchWrite", id: RequestId, params: ConfigBatchWriteParams, } | { "method": "configRequirements/read", id: RequestId, params: undefined, } | { "method": "account/read", id: RequestId, params: GetAccountParams, } | { "method": "getConversationSummary", id: RequestId, params: GetConversationSummaryParams, } | { "method": "gitDiffToRemote", id: RequestId, params: GitDiffToRemoteParams, } | { "method": "getAuthStatus", id: RequestId, params: GetAuthStatusParams, } | { "method": "fuzzyFileSearch", id: RequestId, params: FuzzyFileSearchParams, };

package/src/protocol/CollaborationMode.ts

@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ModeKind } from "./ModeKind";
+import type { Settings } from "./Settings";
+
+/**
+ * Collaboration mode for a Codex session.
+ */
+export type CollaborationMode = { mode: ModeKind, settings: Settings, };

package/src/protocol/ContentItem.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ContentItem = { "type": "input_text", text: string, } | { "type": "input_image", image_url: string, } | { "type": "output_text", text: string, };

package/src/protocol/ConversationGitInfo.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ConversationGitInfo = { sha: string | null, branch: string | null, origin_url: string | null, };

package/src/protocol/ConversationSummary.ts

@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ConversationGitInfo } from "./ConversationGitInfo";
+import type { SessionSource } from "./SessionSource";
+import type { ThreadId } from "./ThreadId";
+
+export type ConversationSummary = { conversationId: ThreadId, path: string, preview: string, timestamp: string | null, updatedAt: string | null, modelProvider: string, cwd: string, cliVersion: string, source: SessionSource, gitInfo: ConversationGitInfo | null, };

package/src/protocol/ExecCommandApprovalParams.ts

@@ -0,0 +1,16 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ParsedCommand } from "./ParsedCommand";
+import type { ThreadId } from "./ThreadId";
+
+export type ExecCommandApprovalParams = { conversationId: ThreadId, 
+/**
+ * Use to correlate this with [codex_protocol::protocol::ExecCommandBeginEvent]
+ * and [codex_protocol::protocol::ExecCommandEndEvent].
+ */
+callId: string, 
+/**
+ * Identifier for this specific approval callback.
+ */
+approvalId: string | null, command: Array<string>, cwd: string, reason: string | null, parsedCmd: Array<ParsedCommand>, };

package/src/protocol/ExecCommandApprovalResponse.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewDecision } from "./ReviewDecision";
+
+export type ExecCommandApprovalResponse = { decision: ReviewDecision, };

package/src/protocol/ExecPolicyAmendment.ts

@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Proposed execpolicy change to allow commands starting with this prefix.
+ *
+ * The `command` tokens form the prefix that would be added as an execpolicy
+ * `prefix_rule(..., decision="allow")`, letting the agent bypass approval for
+ * commands that start with this token sequence.
+ */
+export type ExecPolicyAmendment = Array<string>;

package/src/protocol/FileChange.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FileChange = { "type": "add", content: string, } | { "type": "delete", content: string, } | { "type": "update", unified_diff: string, move_path: string | null, };

package/src/protocol/ForcedLoginMethod.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ForcedLoginMethod = "chatgpt" | "api";

package/src/protocol/FunctionCallOutputBody.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FunctionCallOutputContentItem } from "./FunctionCallOutputContentItem";
+
+export type FunctionCallOutputBody = string | Array<FunctionCallOutputContentItem>;

package/src/protocol/FunctionCallOutputContentItem.ts

@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ImageDetail } from "./ImageDetail";
+
+/**
+ * Responses API compatible content items that can be returned by a tool call.
+ * This is a subset of ContentItem with the types we support as function call outputs.
+ */
+export type FunctionCallOutputContentItem = { "type": "input_text", text: string, } | { "type": "input_image", image_url: string, detail?: ImageDetail, };

package/src/protocol/FuzzyFileSearchMatchType.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FuzzyFileSearchMatchType = "file" | "directory";

package/src/protocol/FuzzyFileSearchParams.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FuzzyFileSearchParams = { query: string, roots: Array<string>, cancellationToken: string | null, };

package/src/protocol/FuzzyFileSearchResponse.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FuzzyFileSearchResult } from "./FuzzyFileSearchResult";
+
+export type FuzzyFileSearchResponse = { files: Array<FuzzyFileSearchResult>, };

package/src/protocol/FuzzyFileSearchResult.ts

@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FuzzyFileSearchMatchType } from "./FuzzyFileSearchMatchType";
+
+/**
+ * Superset of [`codex_file_search::FileMatch`]
+ */
+export type FuzzyFileSearchResult = { root: string, path: string, match_type: FuzzyFileSearchMatchType, file_name: string, score: number, indices: Array<number> | null, };

package/src/protocol/FuzzyFileSearchSessionCompletedNotification.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FuzzyFileSearchSessionCompletedNotification = { sessionId: string, };

package/src/protocol/FuzzyFileSearchSessionUpdatedNotification.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FuzzyFileSearchResult } from "./FuzzyFileSearchResult";
+
+export type FuzzyFileSearchSessionUpdatedNotification = { sessionId: string, query: string, files: Array<FuzzyFileSearchResult>, };

package/src/protocol/GetAuthStatusParams.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type GetAuthStatusParams = { includeToken: boolean | null, refreshToken: boolean | null, };

package/src/protocol/GetAuthStatusResponse.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AuthMode } from "./AuthMode";
+
+export type GetAuthStatusResponse = { authMethod: AuthMode | null, authToken: string | null, requiresOpenaiAuth: boolean | null, };

package/src/protocol/GetConversationSummaryParams.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type GetConversationSummaryParams = { rolloutPath: string, } | { conversationId: ThreadId, };

package/src/protocol/GetConversationSummaryResponse.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ConversationSummary } from "./ConversationSummary";
+
+export type GetConversationSummaryResponse = { summary: ConversationSummary, };

package/src/protocol/GhostCommit.ts

@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Details of a ghost commit created from a repository state.
+ */
+export type GhostCommit = { id: string, parent: string | null, preexisting_untracked_files: Array<string>, preexisting_untracked_dirs: Array<string>, };

package/src/protocol/GitDiffToRemoteParams.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type GitDiffToRemoteParams = { cwd: string, };