mcp-codex-subagent 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+export declare const TOOLS: {
+    readonly CODEX: "codex";
+    readonly REVIEW: "review";
+    readonly PING: "ping";
+    readonly HELP: "help";
+    readonly LIST_SESSIONS: "listSessions";
+};
+export type ToolName = typeof TOOLS[keyof typeof TOOLS];
+export declare const PINNED_CODEX_MODEL: "gpt-5.3-codex";
+export declare const AGENT_ROLES: readonly ["coder", "planner", "tester", "researcher"];
+export type AgentRole = typeof AGENT_ROLES[number];
+export declare const ROLE_TO_TASK_TYPE: Record<AgentRole, string>;
+export interface ContextFile {
+    path: string;
+    description?: string;
+    start_line?: number;
+    end_line?: number;
+}
+export interface ToolAnnotations {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+export interface ToolDefinition {
+    name: ToolName;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required: string[];
+    };
+    outputSchema?: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+    annotations?: ToolAnnotations;
+}
+export interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+        _meta?: Record<string, unknown>;
+    }>;
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+}
+export interface ServerConfig {
+    name: string;
+    version: string;
+}
+export declare const SandboxMode: z.ZodEnum<{
+    "read-only": "read-only";
+    "workspace-write": "workspace-write";
+    "danger-full-access": "danger-full-access";
+}>;
+export declare const CodexToolSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        coder: "coder";
+        planner: "planner";
+        tester: "tester";
+        researcher: "researcher";
+    }>>;
+    specialization: z.ZodOptional<z.ZodString>;
+    context_files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        start_line: z.ZodOptional<z.ZodNumber>;
+        end_line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    resetSession: z.ZodOptional<z.ZodBoolean>;
+    reasoningEffort: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+    }>>>;
+    sandbox: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        "read-only": "read-only";
+        "workspace-write": "workspace-write";
+        "danger-full-access": "danger-full-access";
+    }>>>;
+    workingDirectory: z.ZodOptional<z.ZodString>;
+    callbackUri: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ReviewToolSchema: z.ZodObject<{
+    prompt: z.ZodOptional<z.ZodString>;
+    uncommitted: z.ZodOptional<z.ZodBoolean>;
+    base: z.ZodOptional<z.ZodString>;
+    commit: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    workingDirectory: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PingToolSchema: z.ZodObject<{
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const HelpToolSchema: z.ZodObject<{}, z.core.$strip>;
+export declare const ListSessionsToolSchema: z.ZodObject<{}, z.core.$strip>;
+export type CodexToolArgs = z.infer<typeof CodexToolSchema>;
+export type ReviewToolArgs = z.infer<typeof ReviewToolSchema>;
+export type PingToolArgs = z.infer<typeof PingToolSchema>;
+export type ListSessionsToolArgs = z.infer<typeof ListSessionsToolSchema>;
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+}
+export type ProgressToken = string | number;
+export interface ToolHandlerContext {
+    progressToken?: ProgressToken;
+    sendProgress: (message: string, progress?: number, total?: number) => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+// Tool constants
+export const TOOLS = {
+    CODEX: 'codex',
+    REVIEW: 'review',
+    PING: 'ping',
+    HELP: 'help',
+    LIST_SESSIONS: 'listSessions',
+};
+// Pinned model — all Codex agents use this model
+export const PINNED_CODEX_MODEL = 'gpt-5.3-codex';
+// Agent roles (matching template system)
+export const AGENT_ROLES = ['coder', 'planner', 'tester', 'researcher'];
+// Role → TaskType mapping (for template system)
+export const ROLE_TO_TASK_TYPE = {
+    coder: 'super-coder',
+    planner: 'super-planner',
+    tester: 'super-tester',
+    researcher: 'super-researcher',
+};
+// Sandbox mode enum
+export const SandboxMode = z.enum([
+    'read-only',
+    'workspace-write',
+    'danger-full-access',
+]);
+// Zod schemas for tool arguments
+export const CodexToolSchema = z.object({
+    prompt: z.string(),
+    role: z.enum(['coder', 'planner', 'tester', 'researcher']).optional(),
+    specialization: z.string().optional(),
+    context_files: z.array(z.object({
+        path: z.string(),
+        description: z.string().optional(),
+        start_line: z.number().int().positive().optional(),
+        end_line: z.number().int().positive().optional(),
+    })).max(20).optional(),
+    sessionId: z
+        .string()
+        .max(256, { error: 'Session ID must be 256 characters or fewer' })
+        .regex(/^[a-zA-Z0-9_-]+$/, {
+        error: 'Session ID can only contain letters, numbers, hyphens, and underscores',
+    })
+        .optional(),
+    resetSession: z.boolean().optional(),
+    reasoningEffort: z.enum(['low', 'medium', 'high', 'xhigh']).default('xhigh').optional(),
+    sandbox: SandboxMode.default('danger-full-access').optional(),
+    workingDirectory: z.string().optional(),
+    callbackUri: z.string().optional(),
+});
+// Review tool schema
+export const ReviewToolSchema = z.object({
+    prompt: z.string().optional(),
+    uncommitted: z.boolean().optional(),
+    base: z.string().optional(),
+    commit: z.string().optional(),
+    title: z.string().optional(),
+    workingDirectory: z.string().optional(),
+});
+export const PingToolSchema = z.object({
+    message: z.string().optional(),
+});
+export const HelpToolSchema = z.object({});
+export const ListSessionsToolSchema = z.object({});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/command.d.ts

@@ -0,0 +1,19 @@
+type ProcessEnv = Record<string, string | undefined>;
+import { type CommandResult } from '../types.js';
+export type ProgressCallback = (message: string) => void;
+export interface StreamingCommandOptions {
+    onProgress?: ProgressCallback;
+    envOverride?: ProcessEnv;
+}
+export declare function executeCommand(file: string, args?: string[], envOverride?: ProcessEnv): Promise<CommandResult>;
+/**
+ * Execute a command with streaming output support.
+ * Calls onProgress callback with each chunk of output for real-time feedback.
+ *
+ * Note: Unlike executeCommand, this function treats stderr output as success
+ * because tools like codex write their primary output to stderr. This is
+ * intentional for streaming use cases where we want to capture all output.
+ */
+export declare function executeCommandStreaming(file: string, args?: string[], options?: StreamingCommandOptions): Promise<CommandResult>;
+export {};
+//# sourceMappingURL=command.d.ts.map

package/dist/utils/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/utils/command.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAKrD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAqBjD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzD,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,EAAO,EACnB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,aAAa,CAAC,CA+ExB;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,aAAa,CAAC,CA2GxB"}

package/dist/utils/command.js

@@ -0,0 +1,171 @@
+import { spawn } from 'child_process';
+import chalk from 'chalk';
+import { CommandExecutionError } from '../errors.js';
+/**
+ * Escape argument for Windows shell (cmd.exe)
+ */
+function escapeArgForWindows(arg) {
+    // Escape percent signs to prevent environment variable expansion
+    let escaped = arg.replace(/%/g, '%%');
+    // If arg contains spaces or special chars, wrap in double quotes
+    if (/[\s"&|<>^%]/.test(arg)) {
+        // Escape internal double quotes using CMD-style doubling
+        escaped = `"${escaped.replace(/"/g, '""')}"`;
+    }
+    return escaped;
+}
+const isWindows = process.platform === 'win32';
+// Maximum buffer size (10MB) to prevent memory exhaustion from noisy processes
+const MAX_BUFFER_SIZE = 10 * 1024 * 1024;
+export async function executeCommand(file, args = [], envOverride) {
+    return new Promise((resolve, reject) => {
+        // Escape args for Windows shell
+        const escapedArgs = isWindows ? args.map(escapeArgForWindows) : args;
+        console.error(chalk.blue('Executing:'), file, escapedArgs.join(' '));
+        const child = spawn(file, escapedArgs, {
+            shell: isWindows,
+            env: envOverride ? { ...process.env, ...envOverride } : process.env,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        let stdoutTruncated = false;
+        let stderrTruncated = false;
+        child.stdout.on('data', (data) => {
+            if (!stdoutTruncated) {
+                const chunk = data.toString();
+                if (stdout.length + chunk.length > MAX_BUFFER_SIZE) {
+                    stdout += chunk.slice(0, MAX_BUFFER_SIZE - stdout.length);
+                    stdoutTruncated = true;
+                    console.error(chalk.yellow('Warning: stdout truncated at 10MB'));
+                }
+                else {
+                    stdout += chunk;
+                }
+            }
+        });
+        child.stderr.on('data', (data) => {
+            if (!stderrTruncated) {
+                const chunk = data.toString();
+                if (stderr.length + chunk.length > MAX_BUFFER_SIZE) {
+                    stderr += chunk.slice(0, MAX_BUFFER_SIZE - stderr.length);
+                    stderrTruncated = true;
+                    console.error(chalk.yellow('Warning: stderr truncated at 10MB'));
+                }
+                else {
+                    stderr += chunk;
+                }
+            }
+        });
+        child.on('close', (code) => {
+            if (stderr) {
+                console.error(chalk.yellow('Command stderr:'), stderr);
+            }
+            // Accept exit code 0 or if we got stdout/stderr output
+            // Note: codex CLI writes most output to stderr, so we must check both
+            if (code === 0 || stdout || stderr) {
+                if (code !== 0 && (stdout || stderr)) {
+                    console.error(chalk.yellow('Command failed but produced output, using output'));
+                }
+                resolve({ stdout, stderr });
+            }
+            else {
+                reject(new CommandExecutionError([file, ...args].join(' '), `Command failed with exit code ${code}`, new Error(stderr || 'Unknown error')));
+            }
+        });
+        child.on('error', (error) => {
+            reject(new CommandExecutionError([file, ...args].join(' '), 'Command execution failed', error));
+        });
+    });
+}
+/**
+ * Execute a command with streaming output support.
+ * Calls onProgress callback with each chunk of output for real-time feedback.
+ *
+ * Note: Unlike executeCommand, this function treats stderr output as success
+ * because tools like codex write their primary output to stderr. This is
+ * intentional for streaming use cases where we want to capture all output.
+ */
+export async function executeCommandStreaming(file, args = [], options = {}) {
+    return new Promise((resolve, reject) => {
+        // Escape args for Windows shell
+        const escapedArgs = isWindows ? args.map(escapeArgForWindows) : args;
+        console.error(chalk.blue('Executing (streaming):'), file, escapedArgs.join(' '));
+        const child = spawn(file, escapedArgs, {
+            shell: isWindows, // Use shell on Windows to inherit PATH correctly
+            env: options.envOverride
+                ? { ...process.env, ...options.envOverride }
+                : process.env,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        let stdoutTruncated = false;
+        let stderrTruncated = false;
+        let lastProgressTime = 0;
+        const PROGRESS_DEBOUNCE_MS = 100; // Debounce progress updates
+        const sendProgress = (message) => {
+            if (!options.onProgress)
+                return;
+            const now = Date.now();
+            // Debounce to avoid flooding with progress updates
+            if (now - lastProgressTime >= PROGRESS_DEBOUNCE_MS) {
+                options.onProgress(message);
+                lastProgressTime = now;
+            }
+        };
+        child.stdout?.on('data', (data) => {
+            const chunk = data.toString();
+            if (!stdoutTruncated) {
+                if (stdout.length + chunk.length > MAX_BUFFER_SIZE) {
+                    stdout += chunk.slice(0, MAX_BUFFER_SIZE - stdout.length);
+                    stdoutTruncated = true;
+                    console.error(chalk.yellow('Warning: stdout truncated at 10MB'));
+                }
+                else {
+                    stdout += chunk;
+                }
+            }
+            sendProgress(chunk.trim());
+        });
+        child.stderr?.on('data', (data) => {
+            const chunk = data.toString();
+            if (!stderrTruncated) {
+                if (stderr.length + chunk.length > MAX_BUFFER_SIZE) {
+                    stderr += chunk.slice(0, MAX_BUFFER_SIZE - stderr.length);
+                    stderrTruncated = true;
+                    console.error(chalk.yellow('Warning: stderr truncated at 10MB'));
+                }
+                else {
+                    stderr += chunk;
+                }
+            }
+            // Also send stderr as progress - codex outputs to stderr
+            sendProgress(chunk.trim());
+        });
+        child.on('close', (code) => {
+            // Send final progress if there's any remaining output
+            if (options.onProgress && (stdout || stderr)) {
+                const finalOutput = stdout || stderr;
+                const lastChunk = finalOutput.slice(-500); // Last 500 chars
+                if (lastChunk.trim()) {
+                    options.onProgress(`[Completed] ${lastChunk.trim().slice(0, 200)}...`);
+                }
+            }
+            if (code === 0 || stdout || stderr) {
+                // Success or we have output (treat as success like the original)
+                if (code !== 0 && (stdout || stderr)) {
+                    console.error(chalk.yellow('Command failed but produced output, using output'));
+                }
+                resolve({ stdout, stderr });
+            }
+            else {
+                reject(new CommandExecutionError([file, ...args].join(' '), `Command exited with code ${code}`, new Error(`Exit code: ${code}`)));
+            }
+        });
+        child.on('error', (error) => {
+            reject(new CommandExecutionError([file, ...args].join(' '), 'Command execution failed', error));
+        });
+    });
+}
+//# sourceMappingURL=command.js.map

package/dist/utils/command.js.map

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

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "mcp-codex-subagent",
+  "version": "1.0.0",
+  "description": "MCP server for OpenAI Codex CLI with role-based templates, specialization overlays, and context file injection",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-codex-subagent": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "build": "tsc && mkdir -p dist/templates/overlays && cp src/templates/*.mdx dist/templates/ && cp src/templates/overlays/*.mdx dist/templates/overlays/",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "clean": "rm -rf dist"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yigitkonur/mcp-codex-subagent.git"
+  },
+  "keywords": [
+    "mcp",
+    "codex",
+    "openai",
+    "claude",
+    "ai",
+    "cli",
+    "superagent",
+    "templates",
+    "role-based",
+    "specialization",
+    "context-files",
+    "model-context-protocol"
+  ],
+  "author": "yigitkonur",
+  "license": "ISC",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/yigitkonur/mcp-codex-subagent/issues"
+  },
+  "homepage": "https://github.com/yigitkonur/mcp-codex-subagent#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.0",
+    "chalk": "^5.6.0",
+    "zod": "^4.0.17"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.3.0",
+    "@typescript-eslint/eslint-plugin": "^8.39.1",
+    "@typescript-eslint/parser": "^8.39.1",
+    "eslint": "^9.33.0",
+    "jest": "^30.0.5",
+    "prettier": "^3.6.2",
+    "ts-jest": "^29.4.1",
+    "tsx": "^4.20.4",
+    "typescript": "^5.9.2"
+  }
+}