mcp-codex-worker 0.1.0

package/dist/src/mcp/tool-definitions.d.ts

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+declare const threadStartSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    developer_instructions: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    model?: string | undefined;
+    cwd?: string | undefined;
+    developer_instructions?: string | undefined;
+}, {
+    model?: string | undefined;
+    cwd?: string | undefined;
+    developer_instructions?: string | undefined;
+}>;
+declare const threadResumeSchema: z.ZodObject<{
+    thread_id: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    developer_instructions: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    thread_id: string;
+    model?: string | undefined;
+    cwd?: string | undefined;
+    developer_instructions?: string | undefined;
+}, {
+    thread_id: string;
+    model?: string | undefined;
+    cwd?: string | undefined;
+    developer_instructions?: string | undefined;
+}>;
+declare const threadReadSchema: z.ZodObject<{
+    thread_id: z.ZodString;
+    include_turns: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    thread_id: string;
+    include_turns?: boolean | undefined;
+}, {
+    thread_id: string;
+    include_turns?: boolean | undefined;
+}>;
+declare const threadListSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}, {
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}>;
+declare const turnStartSchema: z.ZodObject<{
+    thread_id: z.ZodString;
+    user_input: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    thread_id: string;
+    user_input: string;
+    model?: string | undefined;
+}, {
+    thread_id: string;
+    user_input: string;
+    model?: string | undefined;
+}>;
+declare const turnSteerSchema: z.ZodObject<{
+    thread_id: z.ZodString;
+    expected_turn_id: z.ZodString;
+    user_input: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    thread_id: string;
+    user_input: string;
+    expected_turn_id: string;
+}, {
+    thread_id: string;
+    user_input: string;
+    expected_turn_id: string;
+}>;
+declare const turnInterruptSchema: z.ZodObject<{
+    thread_id: z.ZodString;
+    turn_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    thread_id: string;
+    turn_id: string;
+}, {
+    thread_id: string;
+    turn_id: string;
+}>;
+declare const requestListSchema: z.ZodObject<{
+    include_resolved: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    include_resolved?: boolean | undefined;
+}, {
+    include_resolved?: boolean | undefined;
+}>;
+declare const requestReadSchema: z.ZodObject<{
+    request_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+}, "strip", z.ZodTypeAny, {
+    request_id: string | number;
+}, {
+    request_id: string | number;
+}>;
+declare const requestRespondSchema: z.ZodObject<{
+    request_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    decision: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    answers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        answers: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        answers: string[];
+    }, {
+        answers: string[];
+    }>>>;
+    action: z.ZodOptional<z.ZodEnum<["accept", "decline", "cancel"]>>;
+    content: z.ZodOptional<z.ZodUnknown>;
+    meta: z.ZodOptional<z.ZodUnknown>;
+    scope: z.ZodOptional<z.ZodEnum<["turn", "session"]>>;
+    permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    request_id: string | number;
+    payload?: Record<string, unknown> | undefined;
+    decision?: string | Record<string, unknown> | undefined;
+    answers?: Record<string, {
+        answers: string[];
+    }> | undefined;
+    action?: "accept" | "decline" | "cancel" | undefined;
+    content?: unknown;
+    meta?: unknown;
+    scope?: "turn" | "session" | undefined;
+    permissions?: Record<string, unknown> | undefined;
+}, {
+    request_id: string | number;
+    payload?: Record<string, unknown> | undefined;
+    decision?: string | Record<string, unknown> | undefined;
+    answers?: Record<string, {
+        answers: string[];
+    }> | undefined;
+    action?: "accept" | "decline" | "cancel" | undefined;
+    content?: unknown;
+    meta?: unknown;
+    scope?: "turn" | "session" | undefined;
+    permissions?: Record<string, unknown> | undefined;
+}>;
+declare const waitSchema: z.ZodObject<{
+    operation_id: z.ZodOptional<z.ZodString>;
+    thread_id: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    poll_interval_ms: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    thread_id?: string | undefined;
+    operation_id?: string | undefined;
+    timeout_ms?: number | undefined;
+    poll_interval_ms?: number | undefined;
+}, {
+    thread_id?: string | undefined;
+    operation_id?: string | undefined;
+    timeout_ms?: number | undefined;
+    poll_interval_ms?: number | undefined;
+}>;
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+    validate: (value: unknown) => unknown;
+}
+export declare function createToolDefinitions(modelIds: string[]): ToolDefinition[];
+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>;
+export {};

package/dist/src/mcp/tool-definitions.js

@@ -0,0 +1,241 @@
+import { z } from 'zod';
+const jsonSchema = { type: 'object' };
+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(),
+});
+function objectSchema(properties, required = []) {
+    return {
+        type: 'object',
+        properties,
+        ...(required.length > 0 ? { required } : {}),
+    };
+}
+export function createToolDefinitions(modelIds) {
+    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),
+        },
+    ];
+}
+//# sourceMappingURL=tool-definitions.js.map

package/dist/src/mcp/tool-definitions.js.map

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

package/dist/src/services/app-server-client.d.ts

@@ -0,0 +1,65 @@
+import { EventEmitter } from 'node:events';
+import type { PendingServerRequest, RequestId, RuntimeOperation } from '../types/codex.js';
+interface RequestOptions {
+    timeoutMs?: number | undefined;
+}
+interface RequestWithBridgeOptions extends RequestOptions {
+    threadId?: string | undefined;
+    bridgeTimeoutMs?: number | undefined;
+}
+interface WaitOptions {
+    timeoutMs?: number | undefined;
+    pollIntervalMs?: number | undefined;
+}
+export interface AppServerClientOptions {
+    command: string;
+    args: string[];
+    env: NodeJS.ProcessEnv;
+    codexHome: string;
+    appName?: string | undefined;
+    appVersion?: string | undefined;
+}
+export interface BridgedOperationResult {
+    status: 'completed' | 'pending_request' | 'running';
+    operationId: string;
+    requestId: RequestId;
+    pendingRequestIds: RequestId[];
+    result?: unknown;
+}
+export declare class AppServerClient extends EventEmitter {
+    private readonly options;
+    private readonly pendingRequests;
+    private readonly serverRequests;
+    private readonly operations;
+    private readonly operationsByRequestId;
+    private readonly threadEvents;
+    private process?;
+    private nextRequestCounter;
+    private nextOperationCounter;
+    private buffer;
+    private started;
+    constructor(options: AppServerClientOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    request(method: string, params: unknown, options?: RequestOptions): Promise<unknown>;
+    requestWithBridge(method: string, params: unknown, options?: RequestWithBridgeOptions): Promise<BridgedOperationResult>;
+    waitForOperation(operationId: string, options?: WaitOptions): Promise<RuntimeOperation>;
+    getOperation(operationId: string): RuntimeOperation | undefined;
+    listOperations(): RuntimeOperation[];
+    listServerRequests(includeResolved?: boolean): PendingServerRequest[];
+    getServerRequest(id: RequestId): PendingServerRequest | undefined;
+    respondToServerRequest(id: RequestId, payload: unknown): Promise<void>;
+    getThreadEvents(threadId: string): unknown[];
+    private sendRequest;
+    private consumeStdout;
+    private handleMessage;
+    private resolveClientRequest;
+    private storeServerRequest;
+    private handleNotification;
+    private updateOperationsFromNotification;
+    private extractThreadIdFromParams;
+    private extractTurnId;
+    private extractTurnError;
+    private writeLine;
+}
+export {};