@etheaven/codex-mcp-server 1.3.0

package/dist/tools/batch-codex.tool.d.ts

@@ -0,0 +1,3 @@
+import { UnifiedTool } from './registry.js';
+export declare const batchCodexTool: UnifiedTool;
+//# sourceMappingURL=batch-codex.tool.d.ts.map

package/dist/tools/batch-codex.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-codex.tool.d.ts","sourceRoot":"","sources":["../../src/tools/batch-codex.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAyC5C,eAAO,MAAM,cAAc,EAAE,WA+I5B,CAAC"}

package/dist/tools/batch-codex.tool.js

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+import { executeCodex } from '../utils/codexExecutor.js';
+import { SANDBOX_MODES } from '../constants.js';
+// Define task type for batch operations
+const batchTaskSchema = z.object({
+    task: z.string().describe('Atomic task description'),
+    target: z.string().optional().describe('Target files/directories (use @ syntax)'),
+    priority: z.enum(['high', 'normal', 'low']).default('normal').describe('Task priority'),
+});
+const batchCodexArgsSchema = z.object({
+    tasks: z.array(batchTaskSchema).min(1).describe('Array of atomic tasks to delegate to Codex'),
+    model: z
+        .string()
+        .optional()
+        .describe('Model ID. Recommended: gpt-5.4 (default), gpt-5.3-codex (coding), o3 (reasoning), o4-mini (fast). ' +
+        'Use exact model IDs as listed.'),
+    reasoningEffort: z
+        .enum(['none', 'minimal', 'low', 'medium', 'high', 'xhigh'])
+        .optional()
+        .describe('Reasoning effort: none, minimal, low, medium, high, xhigh.'),
+    sandbox: z
+        .string()
+        .default(SANDBOX_MODES.WORKSPACE_WRITE)
+        .describe(`Sandbox mode: ${Object.values(SANDBOX_MODES).join(', ')}`),
+    parallel: z.boolean().default(false).describe('Execute tasks in parallel (experimental)'),
+    stopOnError: z.boolean().default(true).describe('Stop execution if any task fails'),
+    timeout: z.number().optional().describe('Maximum execution time per task in milliseconds'),
+    workingDir: z.string().optional().describe('Working directory for execution'),
+    search: z
+        .boolean()
+        .optional()
+        .describe('Enable web search for all tasks (activates web_search_request feature)'),
+    oss: z.boolean().optional().describe('Use local Ollama server'),
+    enableFeatures: z.array(z.string()).optional().describe('Enable feature flags'),
+    disableFeatures: z.array(z.string()).optional().describe('Disable feature flags'),
+});
+export const batchCodexTool = {
+    name: 'batch-codex',
+    description: 'Delegate multiple atomic tasks to Codex for batch processing. Ideal for repetitive operations, mass refactoring, and automated code transformations',
+    zodSchema: batchCodexArgsSchema,
+    prompt: {
+        description: 'Execute multiple atomic Codex tasks in batch mode for efficient automation',
+    },
+    category: 'codex',
+    execute: async (args, onProgress) => {
+        const { tasks, model, reasoningEffort, sandbox, parallel, stopOnError, timeout, workingDir, search, oss, enableFeatures, disableFeatures, } = args;
+        const taskList = tasks;
+        if (!taskList || taskList.length === 0) {
+            throw new Error('No tasks provided for batch execution');
+        }
+        const results = [];
+        let failedCount = 0;
+        let successCount = 0;
+        // Sort tasks by priority
+        const sortedTasks = [...taskList].sort((a, b) => {
+            const priorityOrder = { high: 0, normal: 1, low: 2 };
+            return (priorityOrder[a.priority] -
+                priorityOrder[b.priority]);
+        });
+        if (onProgress) {
+            onProgress(`🚀 Starting batch execution of ${sortedTasks.length} tasks...`);
+        }
+        // Execute tasks sequentially
+        // TODO: Implement parallel execution when parallel flag is true
+        for (let i = 0; i < sortedTasks.length; i++) {
+            const task = sortedTasks[i];
+            const taskPrompt = task.target ? `${task.task} in ${task.target}` : task.task;
+            if (onProgress) {
+                onProgress(`\n[${i + 1}/${sortedTasks.length}] Executing: ${taskPrompt}`);
+            }
+            // Skip remaining tasks if stopOnError is true and we have failures
+            if (stopOnError && failedCount > 0) {
+                results.push({
+                    task: taskPrompt,
+                    status: 'skipped',
+                    error: 'Skipped due to previous failure',
+                });
+                continue;
+            }
+            try {
+                const result = await executeCodex(taskPrompt, {
+                    model: model,
+                    reasoningEffort: reasoningEffort,
+                    sandboxMode: sandbox,
+                    timeout: timeout,
+                    workingDir: workingDir,
+                    search: search,
+                    oss: oss,
+                    enableFeatures: enableFeatures,
+                    disableFeatures: disableFeatures,
+                }, undefined // No progress for individual tasks to keep output clean
+                );
+                results.push({
+                    task: taskPrompt,
+                    status: 'success',
+                    output: result.substring(0, 500), // Truncate for summary
+                });
+                successCount++;
+                if (onProgress) {
+                    onProgress(`✅ Completed: ${task.task}`);
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                results.push({
+                    task: taskPrompt,
+                    status: 'failed',
+                    error: errorMessage,
+                });
+                failedCount++;
+                if (onProgress) {
+                    onProgress(`❌ Failed: ${task.task} - ${errorMessage}`);
+                }
+            }
+        }
+        // Generate summary report
+        let report = `\n📊 **Batch Execution Summary**\n`;
+        report += `\n- Total tasks: ${sortedTasks.length}`;
+        report += `\n- Successful: ${successCount} ✅`;
+        report += `\n- Failed: ${failedCount} ❌`;
+        report += `\n- Skipped: ${sortedTasks.length - successCount - failedCount} ⏭️`;
+        report += `\n\n**Task Results:**\n`;
+        for (const result of results) {
+            const icon = result.status === 'success' ? '✅' : result.status === 'failed' ? '❌' : '⏭️';
+            report += `\n${icon} **${result.task}**`;
+            if (result.status === 'success' && result.output) {
+                report += `\n   Output: ${result.output.substring(0, 100)}...`;
+            }
+            else if (result.error) {
+                report += `\n   Error: ${result.error}`;
+            }
+        }
+        // If all tasks failed, throw an error
+        if (failedCount === sortedTasks.length) {
+            throw new Error(`All ${failedCount} tasks failed. See report above for details.`);
+        }
+        return report;
+    },
+};
+//# sourceMappingURL=batch-codex.tool.js.map

package/dist/tools/batch-codex.tool.js.map

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

package/dist/tools/brainstorm.tool.d.ts

@@ -0,0 +1,3 @@
+import { UnifiedTool } from './registry.js';
+export declare const brainstormTool: UnifiedTool;
+//# sourceMappingURL=brainstorm.tool.d.ts.map

package/dist/tools/brainstorm.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brainstorm.tool.d.ts","sourceRoot":"","sources":["../../src/tools/brainstorm.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA+J5C,eAAO,MAAM,cAAc,EAAE,WAuE5B,CAAC"}

package/dist/tools/brainstorm.tool.js

@@ -0,0 +1,171 @@
+import { z } from 'zod';
+import { Logger } from '../utils/logger.js';
+import { executeCodexCLI } from '../utils/codexExecutor.js';
+function buildBrainstormPrompt(config) {
+    const { prompt, methodology, domain, constraints, existingContext, ideaCount, includeAnalysis } = config;
+    // Select methodology framework
+    let frameworkInstructions = getMethodologyInstructions(methodology, domain);
+    let enhancedPrompt = `# BRAINSTORMING SESSION
+
+## Challenge: ${prompt}
+
+## Framework
+${frameworkInstructions}
+
+## Context
+${domain ? `Domain: ${domain}` : ''}
+${constraints ? `Constraints: ${constraints}` : ''}
+${existingContext ? `Background: ${existingContext}` : ''}
+
+## Requirements
+Generate ${ideaCount} actionable ideas. Keep descriptions concise (2-3 sentences max).
+
+${includeAnalysis
+        ? `## Analysis
+Rate each: Feasibility (1-5), Impact (1-5), Innovation (1-5)`
+        : ''}
+
+## Format
+### Idea [N]: [Name]
+Description: [2-3 sentences]
+${includeAnalysis ? 'Ratings: F:[1-5] I:[1-5] N:[1-5]' : ''}
+
+Begin:`;
+    return enhancedPrompt;
+}
+/**
+ * Returns methodology-specific instructions for structured brainstorming
+ */
+function getMethodologyInstructions(methodology, domain) {
+    const methodologies = {
+        divergent: `**Divergent Thinking Approach:**
+- Generate maximum quantity of ideas without self-censoring
+- Build on wild or seemingly impractical ideas
+- Combine unrelated concepts for unexpected solutions
+- Use "Yes, and..." thinking to expand each concept
+- Postpone evaluation until all ideas are generated`,
+        convergent: `**Convergent Thinking Approach:**
+- Focus on refining and improving existing concepts
+- Synthesize related ideas into stronger solutions
+- Apply critical evaluation criteria
+- Prioritize based on feasibility and impact
+- Develop implementation pathways for top ideas`,
+        scamper: `**SCAMPER Creative Triggers:**
+- **Substitute:** What can be substituted or replaced?
+- **Combine:** What can be combined or merged?
+- **Adapt:** What can be adapted from other domains?
+- **Modify:** What can be magnified, minimized, or altered?
+- **Put to other use:** How else can this be used?
+- **Eliminate:** What can be removed or simplified?
+- **Reverse:** What can be rearranged or reversed?`,
+        'design-thinking': `**Human-Centered Design Thinking:**
+- **Empathize:** Consider user needs, pain points, and contexts
+- **Define:** Frame problems from user perspective
+- **Ideate:** Generate user-focused solutions
+- **Consider Journey:** Think through complete user experience
+- **Prototype Mindset:** Focus on testable, iterative concepts`,
+        lateral: `**Lateral Thinking Approach:**
+- Make unexpected connections between unrelated fields
+- Challenge fundamental assumptions
+- Use random word association to trigger new directions
+- Apply metaphors and analogies from other domains
+- Reverse conventional thinking patterns`,
+        auto: `**AI-Optimized Approach:**
+${domain ? `Given the ${domain} domain, I'll apply the most effective combination of:` : "I'll intelligently combine multiple methodologies:"}
+- Divergent exploration with domain-specific knowledge
+- SCAMPER triggers and lateral thinking
+- Human-centered perspective for practical value`,
+    };
+    return methodologies[methodology] || methodologies['auto'];
+}
+const brainstormArgsSchema = z.object({
+    prompt: z.string().min(1).describe('Brainstorming challenge or question'),
+    model: z
+        .string()
+        .optional()
+        .describe('Model ID. Recommended: gpt-5.4 (default), o3 (deep reasoning), gpt-5.3-codex (coding). ' +
+        'All valid IDs: gpt-5.4, gpt-5.4-pro, gpt-5.3-codex, gpt-5.2-codex, gpt-5.2, gpt-5.1, ' +
+        'gpt-5, gpt-5-mini, gpt-5-nano, o3, o3-pro, o4-mini, gpt-4.1, gpt-4.1-mini, gpt-4.1-nano.'),
+    reasoningEffort: z
+        .enum(['none', 'minimal', 'low', 'medium', 'high', 'xhigh'])
+        .optional()
+        .describe('Reasoning effort: none, minimal, low, medium (default), high, xhigh. ' +
+        'Higher = deeper analysis, slower, more expensive.'),
+    approvalPolicy: z
+        .enum(['never', 'on-request', 'on-failure', 'untrusted'])
+        .optional()
+        .describe('Approval: never, on-request, on-failure, untrusted'),
+    sandboxMode: z
+        .enum(['read-only', 'workspace-write', 'danger-full-access'])
+        .optional()
+        .describe('Access: read-only, workspace-write, danger-full-access'),
+    fullAuto: z.boolean().optional().describe('Full automation mode'),
+    yolo: z.boolean().optional().describe('⚠️ Bypass all safety (dangerous)'),
+    cd: z.string().optional().describe('Working directory'),
+    methodology: z
+        .enum(['divergent', 'convergent', 'scamper', 'design-thinking', 'lateral', 'auto'])
+        .default('auto')
+        .describe('Framework: divergent, convergent, scamper, design-thinking, lateral, auto (default)'),
+    domain: z
+        .string()
+        .optional()
+        .describe('Domain: software, business, creative, research, product, marketing, etc.'),
+    constraints: z.string().optional().describe('Limitations: budget, time, technical, legal, etc.'),
+    existingContext: z.string().optional().describe('Background info or previous attempts'),
+    ideaCount: z
+        .number()
+        .int()
+        .positive()
+        .default(12)
+        .describe('Number of ideas (default: 12, range: 5-30)'),
+    includeAnalysis: z.boolean().default(true).describe('Include feasibility/impact analysis'),
+    search: z
+        .boolean()
+        .optional()
+        .describe('Enable web search for research (activates web_search_request feature)'),
+    oss: z.boolean().optional().describe('Use local Ollama server'),
+    enableFeatures: z.array(z.string()).optional().describe('Enable feature flags'),
+    disableFeatures: z.array(z.string()).optional().describe('Disable feature flags'),
+});
+export const brainstormTool = {
+    name: 'brainstorm',
+    description: 'Generate creative ideas using structured frameworks with domain context and feasibility analysis.',
+    zodSchema: brainstormArgsSchema,
+    prompt: {
+        description: 'Create structured brainstorming with chosen methodology and analysis',
+    },
+    category: 'utility',
+    execute: async (args, onProgress) => {
+        const { prompt, model, reasoningEffort, approvalPolicy, sandboxMode, fullAuto, yolo, cd, methodology = 'auto', domain, constraints, existingContext, ideaCount = 12, includeAnalysis = true, search, oss, enableFeatures, disableFeatures, } = args;
+        if (!prompt?.trim()) {
+            throw new Error('You must provide a valid brainstorming challenge or question to explore');
+        }
+        let enhancedPrompt = buildBrainstormPrompt({
+            prompt: prompt.trim(),
+            methodology: methodology,
+            domain: domain,
+            constraints: constraints,
+            existingContext: existingContext,
+            ideaCount: ideaCount,
+            includeAnalysis: includeAnalysis,
+        });
+        Logger.debug(`Brainstorm: Using methodology '${methodology}' for domain '${domain || 'general'}'`);
+        // Report progress to user
+        onProgress?.(`Generating ${ideaCount} ideas via ${methodology} methodology...`);
+        // Execute with Codex (non-interactive)
+        return await executeCodexCLI(enhancedPrompt, {
+            model: model,
+            reasoningEffort: reasoningEffort,
+            fullAuto: Boolean(fullAuto),
+            approvalPolicy: approvalPolicy,
+            sandboxMode: sandboxMode,
+            yolo: Boolean(yolo),
+            cd: cd,
+            search: search,
+            oss: oss,
+            enableFeatures: enableFeatures,
+            disableFeatures: disableFeatures,
+        }, onProgress);
+    },
+};
+//# sourceMappingURL=brainstorm.tool.js.map

package/dist/tools/brainstorm.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brainstorm.tool.js","sourceRoot":"","sources":["../../src/tools/brainstorm.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,SAAS,qBAAqB,CAAC,MAQ9B;IACC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,GAC7F,MAAM,CAAC;IAET,+BAA+B;IAC/B,IAAI,qBAAqB,GAAG,0BAA0B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAE5E,IAAI,cAAc,GAAG;;gBAEP,MAAM;;;EAGpB,qBAAqB;;;EAGrB,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;EACjC,WAAW,CAAC,CAAC,CAAC,gBAAgB,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;EAChD,eAAe,CAAC,CAAC,CAAC,eAAe,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE;;;WAG9C,SAAS;;EAGlB,eAAe;QACb,CAAC,CAAC;6DACuD;QACzD,CAAC,CAAC,EACN;;;;;EAKE,eAAe,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,EAAE;;OAEpD,CAAC;IAEN,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,WAAmB,EAAE,MAAe;IACtE,MAAM,aAAa,GAA2B;QAC5C,SAAS,EAAE;;;;;oDAKqC;QAEhD,UAAU,EAAE;;;;;gDAKgC;QAE5C,OAAO,EAAE;;;;;;;mDAOsC;QAE/C,iBAAiB,EAAE;;;;;+DAKwC;QAE3D,OAAO,EAAE;;;;;yCAK4B;QAErC,IAAI,EAAE;EACR,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,wDAAwD,CAAC,CAAC,CAAC,oDAAoD;;;iDAG5F;KAC9C,CAAC;IAEF,OAAO,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACzE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yFAAyF;QACvF,uFAAuF;QACvF,0FAA0F,CAC7F;IACH,eAAe,EAAE,CAAC;SACf,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;SAC3D,QAAQ,EAAE;SACV,QAAQ,CACP,uEAAuE;QACrE,mDAAmD,CACtD;IACH,cAAc,EAAE,CAAC;SACd,IAAI,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;SACxD,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;SAC5D,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACjE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACzE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACvD,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;SAClF,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CACP,qFAAqF,CACtF;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;IACvF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAChG,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACvF,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,4CAA4C,CAAC;IACzD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC1F,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;IACpF,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC/D,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC/E,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;CAClF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,mGAAmG;IACrG,SAAS,EAAE,oBAAoB;IAC/B,MAAM,EAAE;QACN,WAAW,EAAE,sEAAsE;KACpF;IACD,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EACJ,MAAM,EACN,KAAK,EACL,eAAe,EACf,cAAc,EACd,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,EAAE,EACF,WAAW,GAAG,MAAM,EACpB,MAAM,EACN,WAAW,EACX,eAAe,EACf,SAAS,GAAG,EAAE,EACd,eAAe,GAAG,IAAI,EACtB,MAAM,EACN,GAAG,EACH,cAAc,EACd,eAAe,GAChB,GAAG,IAAI,CAAC;QAET,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,cAAc,GAAG,qBAAqB,CAAC;YACzC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAY;YAC/B,WAAW,EAAE,WAAqB;YAClC,MAAM,EAAE,MAA4B;YACpC,WAAW,EAAE,WAAiC;YAC9C,eAAe,EAAE,eAAqC;YACtD,SAAS,EAAE,SAAmB;YAC9B,eAAe,EAAE,eAA0B;SAC5C,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CACV,kCAAkC,WAAW,iBAAiB,MAAM,IAAI,SAAS,GAAG,CACrF,CAAC;QAEF,0BAA0B;QAC1B,UAAU,EAAE,CAAC,cAAc,SAAS,cAAc,WAAW,iBAAiB,CAAC,CAAC;QAEhF,uCAAuC;QACvC,OAAO,MAAM,eAAe,CAC1B,cAAc,EACd;YACE,KAAK,EAAE,KAA2B;YAClC,eAAe,EAAE,eAAqC;YACtD,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;YAC3B,cAAc,EAAE,cAAqB;YACrC,WAAW,EAAE,WAAkB;YAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;YACnB,EAAE,EAAE,EAAwB;YAC5B,MAAM,EAAE,MAAiB;YACzB,GAAG,EAAE,GAAc;YACnB,cAAc,EAAE,cAA0B;YAC1C,eAAe,EAAE,eAA2B;SAC7C,EACD,UAAU,CACX,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/fetch-chunk.tool.d.ts

@@ -0,0 +1,3 @@
+import { UnifiedTool } from './registry.js';
+export declare const fetchChunkTool: UnifiedTool;
+//# sourceMappingURL=fetch-chunk.tool.d.ts.map

package/dist/tools/fetch-chunk.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-chunk.tool.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-chunk.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAa5C,eAAO,MAAM,cAAc,EAAE,WAwE5B,CAAC"}

package/dist/tools/fetch-chunk.tool.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { getChunks } from '../utils/chunkCache.js';
+import { formatChangeModeResponse, summarizeChangeModeEdits, } from '../utils/changeModeTranslator.js';
+import { Logger } from '../utils/logger.js';
+const inputSchema = z.object({
+    cacheKey: z.string().describe('The cache key provided in the initial changeMode response'),
+    chunkIndex: z.number().min(1).describe('Which chunk to retrieve (1-based index)'),
+});
+export const fetchChunkTool = {
+    name: 'fetch-chunk',
+    description: 'Retrieves cached chunks from a changeMode response. Use this to get subsequent chunks after receiving a partial changeMode response.',
+    zodSchema: inputSchema,
+    prompt: {
+        description: 'Fetch the next chunk of a response',
+        arguments: [
+            {
+                name: 'prompt',
+                description: 'fetch-chunk cacheKey=<key> chunkIndex=<number>',
+                required: true,
+            },
+        ],
+    },
+    category: 'utility',
+    execute: async (args, onProgress) => {
+        const { cacheKey, chunkIndex } = args;
+        Logger.toolInvocation('fetch-chunk', args);
+        Logger.debug(`Fetching chunk ${chunkIndex} with cache key: ${cacheKey}`);
+        // Retrieve cached chunks
+        const chunks = getChunks(cacheKey);
+        if (!chunks) {
+            return `❌ Cache miss: No chunks found for cache key "${cacheKey}". 
+
+  Possible reasons:
+  1. The cache key is incorrect. Did you run ask-codex with changeMode enabled?
+  2. The cache has expired (10 minute TTL)
+  3. The MCP server was restarted and the file-based cache was cleared
+
+Please re-run the original changeMode request to regenerate the chunks.`;
+        }
+        // Validate chunk index
+        if (chunkIndex < 1 || chunkIndex > chunks.length) {
+            return `❌ Invalid chunk index: ${chunkIndex}
+
+Available chunks: 1 to ${chunks.length}
+You requested: ${chunkIndex}
+
+Please use a valid chunk index.`;
+        }
+        // Get the requested chunk
+        const chunk = chunks[chunkIndex - 1];
+        // Format the response
+        let result = formatChangeModeResponse(chunk.edits, {
+            current: chunkIndex,
+            total: chunks.length,
+            cacheKey,
+        });
+        // Add summary for first chunk
+        if (chunkIndex === 1 && chunks.length > 1) {
+            const allEdits = chunks.flatMap(c => c.edits);
+            result = summarizeChangeModeEdits(allEdits, true) + '\n\n' + result;
+        }
+        Logger.debug(`Returning chunk ${chunkIndex} of ${chunks.length} with ${chunk.edits.length} edits`);
+        return result;
+    },
+};
+//# sourceMappingURL=fetch-chunk.tool.js.map

package/dist/tools/fetch-chunk.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-chunk.tool.js","sourceRoot":"","sources":["../../src/tools/fetch-chunk.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IAC1F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CAClF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,sIAAsI;IAExI,SAAS,EAAE,WAAW;IAEtB,MAAM,EAAE;QACN,WAAW,EAAE,oCAAoC;QACjD,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;gBAC7D,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IAED,QAAQ,EAAE,SAAS;IAEnB,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,UAAwC,EAAmB,EAAE;QACtF,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAEtC,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,kBAAkB,UAAU,oBAAoB,QAAQ,EAAE,CAAC,CAAC;QAEzE,yBAAyB;QACzB,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,gDAAgD,QAAQ;;;;;;;wEAOG,CAAC;QACrE,CAAC;QAED,uBAAuB;QACvB,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YACjD,OAAO,0BAA0B,UAAU;;yBAExB,MAAM,CAAC,MAAM;iBACrB,UAAU;;gCAEK,CAAC;QAC7B,CAAC;QAED,0BAA0B;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAErC,sBAAsB;QACtB,IAAI,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,KAAK,EAAE;YACjD,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,QAAQ;SACT,CAAC,CAAC;QAEH,8BAA8B;QAC9B,IAAI,UAAU,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,GAAG,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;QACtE,CAAC;QAED,MAAM,CAAC,KAAK,CACV,mBAAmB,UAAU,OAAO,MAAM,CAAC,MAAM,SAAS,KAAK,CAAC,KAAK,CAAC,MAAM,QAAQ,CACrF,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+export * from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAsBA,cAAc,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,14 @@
+// Tool Registry Index - Registers all tools
+import { toolRegistry } from './registry.js';
+import { askCodexTool } from './ask-codex.tool.js';
+import { batchCodexTool } from './batch-codex.tool.js';
+// import { reviewCodexTool } from './review-codex.tool.js';
+import { pingTool, helpTool, versionTool } from './simple-tools.js';
+import { brainstormTool } from './brainstorm.tool.js';
+import { fetchChunkTool } from './fetch-chunk.tool.js';
+import { timeoutTestTool } from './timeout-test.tool.js';
+toolRegistry.push(askCodexTool, batchCodexTool, 
+// reviewCodexTool,
+pingTool, helpTool, versionTool, brainstormTool, fetchChunkTool, timeoutTestTool);
+export * from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,4DAA4D;AAC5D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,YAAY,CAAC,IAAI,CACf,YAAY,EACZ,cAAc;AACd,mBAAmB;AACnB,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,CAChB,CAAC;AAEF,cAAc,eAAe,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,25 @@
+import { Tool, Prompt } from '@modelcontextprotocol/sdk/types.js';
+import { ToolArguments } from '../constants.js';
+import { ZodTypeAny } from 'zod';
+export interface UnifiedTool {
+    name: string;
+    description: string;
+    zodSchema: ZodTypeAny;
+    prompt?: {
+        description: string;
+        arguments?: Array<{
+            name: string;
+            description: string;
+            required: boolean;
+        }>;
+    };
+    execute: (args: ToolArguments, onProgress?: (newOutput: string) => void) => Promise<string>;
+    category?: 'simple' | 'utility' | 'codex';
+}
+export declare const toolRegistry: UnifiedTool[];
+export declare function toolExists(toolName: string): boolean;
+export declare function getToolDefinitions(): Tool[];
+export declare function getPromptDefinitions(): Prompt[];
+export declare function executeTool(toolName: string, args: ToolArguments, onProgress?: (newOutput: string) => void): Promise<string>;
+export declare function getPromptMessage(toolName: string, args: Record<string, any>): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAY,MAAM,KAAK,CAAC;AAG3C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC;IAEtB,MAAM,CAAC,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,OAAO,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC;IAEF,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;CAC3C;AAED,eAAO,MAAM,YAAY,EAAE,WAAW,EAAO,CAAC;AAE9C,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CAiB3C;AAkBD,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAS/C;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,aAAa,EACnB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACvC,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAsBpF"}

package/dist/tools/registry.js

@@ -0,0 +1,84 @@
+import { ZodError } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+export const toolRegistry = [];
+export function toolExists(toolName) {
+    return toolRegistry.some(t => t.name === toolName);
+}
+export function getToolDefinitions() {
+    // get Tool definitions from registry
+    return toolRegistry.map(tool => {
+        const raw = zodToJsonSchema(tool.zodSchema, tool.name);
+        const def = raw.definitions?.[tool.name] ?? raw;
+        const inputSchema = {
+            type: 'object',
+            properties: def.properties || {},
+            required: def.required || [],
+        };
+        return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema,
+        };
+    });
+}
+function extractPromptArguments(zodSchema) {
+    const jsonSchema = zodToJsonSchema(zodSchema);
+    const properties = jsonSchema.properties || {};
+    const required = jsonSchema.required || [];
+    return Object.entries(properties).map(([name, prop]) => ({
+        name,
+        description: prop.description || `${name} parameter`,
+        required: required.includes(name),
+    }));
+}
+export function getPromptDefinitions() {
+    // Helper to get MCP Prompt definitions from registry
+    return toolRegistry
+        .filter(tool => tool.prompt)
+        .map(tool => ({
+        name: tool.name,
+        description: tool.prompt.description,
+        arguments: tool.prompt.arguments || extractPromptArguments(tool.zodSchema),
+    }));
+}
+export async function executeTool(toolName, args, onProgress) {
+    const tool = toolRegistry.find(t => t.name === toolName);
+    if (!tool) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+    try {
+        const validatedArgs = tool.zodSchema.parse(args);
+        return tool.execute(validatedArgs, onProgress);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            const issues = error.issues
+                .map(issue => `${issue.path.join('.')}: ${issue.message}`)
+                .join(', ');
+            throw new Error(`Invalid arguments for ${toolName}: ${issues}`);
+        }
+        throw error;
+    }
+}
+export function getPromptMessage(toolName, args) {
+    const tool = toolRegistry.find(t => t.name === toolName);
+    if (!tool?.prompt) {
+        throw new Error(`No prompt defined for tool: ${toolName}`);
+    }
+    const paramStrings = [];
+    if (args.prompt) {
+        paramStrings.push(args.prompt);
+    }
+    Object.entries(args).forEach(([key, value]) => {
+        if (key !== 'prompt' && value !== undefined && value !== null && value !== false) {
+            if (typeof value === 'boolean' && value) {
+                paramStrings.push(`[${key}]`);
+            }
+            else if (typeof value !== 'boolean') {
+                paramStrings.push(`(${key}: ${value})`);
+            }
+        }
+    });
+    return `Use the ${toolName} tool${paramStrings.length > 0 ? ': ' + paramStrings.join(' ') : ''}`;
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/simple-tools.d.ts

@@ -0,0 +1,5 @@
+import { UnifiedTool } from './registry.js';
+export declare const pingTool: UnifiedTool;
+export declare const helpTool: UnifiedTool;
+export declare const versionTool: UnifiedTool;
+//# sourceMappingURL=simple-tools.d.ts.map

package/dist/tools/simple-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-tools.d.ts","sourceRoot":"","sources":["../../src/tools/simple-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,eAAO,MAAM,QAAQ,EAAE,WAatB,CAAC;AAIF,eAAO,MAAM,QAAQ,EAAE,WAWtB,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,WA6BzB,CAAC"}