@nexus-cortex/executors 4.26.0

package/dist/implementations/ui/AskUserQuestionTool.js

@@ -0,0 +1,241 @@
+/**
+ * AskUserQuestion Tool Executor
+ *
+ * Present multiple-choice questions to users during execution.
+ * Allows agent to gather user preferences, clarify ambiguous instructions,
+ * and get decisions on implementation choices.
+ */
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+/**
+ * AskUserQuestion Tool Executor
+ *
+ * Features:
+ * - Present 1-4 multiple choice questions
+ * - Each question has 2-4 options
+ * - Support for single or multi-select
+ * - Clear formatting for user interaction
+ */
+export class AskUserQuestionTool extends BaseTool {
+    config;
+    constructor(config) {
+        super('AskUserQuestion', 'AskUserQuestion', `Use this tool when you need to ask the user questions during execution. This allows you to:
+1. Gather user preferences or requirements
+2. Clarify ambiguous instructions
+3. Get decisions on implementation choices as you work
+4. Offer choices to the user about what direction to take.
+
+Usage notes:
+- Users will always be able to select "Other" to provide custom text input
+- Use multiSelect: true to allow multiple answers to be selected for a question`, {
+            type: 'object',
+            properties: {
+                questions: {
+                    type: 'array',
+                    minItems: 1,
+                    maxItems: 4,
+                    items: {
+                        type: 'object',
+                        properties: {
+                            question: {
+                                type: 'string',
+                                description: 'The complete question to ask the user. Should be clear, specific, and end with a question mark.',
+                                minLength: 5,
+                            },
+                            header: {
+                                type: 'string',
+                                maxLength: 12,
+                                description: 'Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".',
+                                minLength: 1,
+                            },
+                            options: {
+                                type: 'array',
+                                minItems: 2,
+                                maxItems: 4,
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        label: {
+                                            type: 'string',
+                                            description: 'The display text for this option (1-5 words)',
+                                            minLength: 1,
+                                        },
+                                        description: {
+                                            type: 'string',
+                                            description: 'Explanation of what this option means or what will happen if chosen',
+                                            minLength: 1,
+                                        },
+                                    },
+                                    required: ['label', 'description'],
+                                },
+                                description: 'Available choices (2-4 options)',
+                            },
+                            multiSelect: {
+                                type: 'boolean',
+                                description: 'Set to true to allow multiple selections. Default: false',
+                                default: false,
+                            },
+                        },
+                        required: ['question', 'header', 'options', 'multiSelect'],
+                    },
+                    description: 'Questions to ask the user (1-4 questions)',
+                },
+                answers: {
+                    type: 'object',
+                    description: 'User answers collected by the permission component (filled by client)',
+                },
+            },
+            required: ['questions'],
+        });
+        this.config = config;
+    }
+    validateToolParams(params) {
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        // Validate questions array
+        if (!params.questions || params.questions.length === 0) {
+            return 'Questions array cannot be empty.';
+        }
+        if (params.questions.length > 4) {
+            return `Too many questions. Maximum: 4, provided: ${params.questions.length}`;
+        }
+        // Validate each question
+        for (let i = 0; i < params.questions.length; i++) {
+            const q = params.questions[i];
+            if (!q) {
+                return `Question ${i + 1} is undefined.`;
+            }
+            // Validate question text
+            if (!q.question || q.question.trim().length < 5) {
+                return `Question ${i + 1}: Question text must be at least 5 characters.`;
+            }
+            // Validate header
+            if (!q.header || q.header.trim().length === 0) {
+                return `Question ${i + 1}: Header cannot be empty.`;
+            }
+            if (q.header.length > 12) {
+                return `Question ${i + 1}: Header too long (${q.header.length} chars, max 12).`;
+            }
+            // Validate options
+            if (!q.options || q.options.length < 2) {
+                return `Question ${i + 1}: Must have at least 2 options.`;
+            }
+            if (q.options.length > 4) {
+                return `Question ${i + 1}: Too many options (${q.options.length}, max 4).`;
+            }
+            // Validate each option
+            for (let j = 0; j < q.options.length; j++) {
+                const opt = q.options[j];
+                if (!opt) {
+                    return `Question ${i + 1}, Option ${j + 1} is undefined.`;
+                }
+                if (!opt.label || opt.label.trim().length === 0) {
+                    return `Question ${i + 1}, Option ${j + 1}: Label cannot be empty.`;
+                }
+                if (!opt.description || opt.description.trim().length === 0) {
+                    return `Question ${i + 1}, Option ${j + 1}: Description cannot be empty.`;
+                }
+            }
+            // Validate multiSelect is boolean
+            if (typeof q.multiSelect !== 'boolean') {
+                return `Question ${i + 1}: multiSelect must be a boolean.`;
+            }
+        }
+        return null;
+    }
+    getDescription(params) {
+        const count = params.questions.length;
+        return `Asking ${count} question${count > 1 ? 's' : ''}`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Question prompt was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Validate parameters
+            const validationError = this.validateToolParams(params);
+            if (validationError) {
+                return {
+                    ...this.createErrorResult(validationError),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Format questions for display
+            const formattedOutput = this.formatQuestions(params.questions);
+            return {
+                ...this.createSuccessResult(formattedOutput),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    questionCount: params.questions.length,
+                    questions: params.questions.map((q) => ({
+                        header: q.header,
+                        question: q.question,
+                        optionCount: q.options.length,
+                        multiSelect: q.multiSelect,
+                    })),
+                },
+            };
+        }
+        catch (error) {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Question prompt was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            const errorMessage = error.message || String(error);
+            return {
+                ...this.createErrorResult(`Error presenting questions: ${errorMessage}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+    /**
+     * Format questions for user display
+     */
+    formatQuestions(questions) {
+        const lines = [];
+        lines.push('=== User Questions ===\n\n');
+        questions.forEach((q, i) => {
+            // Header
+            lines.push(`[${q.header}]\n`);
+            // Question
+            lines.push(`${q.question}\n`);
+            // Multi-select indicator
+            if (q.multiSelect) {
+                lines.push('(You can select multiple options)\n');
+            }
+            lines.push('\n');
+            // Options
+            q.options.forEach((opt, j) => {
+                lines.push(`${j + 1}. ${opt.label}\n`);
+                lines.push(` ${opt.description}\n\n`);
+            });
+            // Separator between questions
+            if (i < questions.length - 1) {
+                lines.push('---\n\n');
+            }
+        });
+        lines.push('\nNote: The client will present these as interactive choices.\n');
+        return lines.join('');
+    }
+}
+//# sourceMappingURL=AskUserQuestionTool.js.map

package/dist/implementations/ui/AskUserQuestionTool.js.map

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

package/dist/implementations/ui/ExitPlanModeTool.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ExitPlanMode Tool Executor
+ *
+ * Signals transition from planning mode to execution mode.
+ * Used when agent has finished planning and is ready to implement.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Parameters for the ExitPlanMode tool
+ */
+export interface ExitPlanModeToolParams {
+    /**
+     * The plan to present to the user for approval
+     * Supports markdown formatting
+     */
+    plan: string;
+}
+/**
+ * ExitPlanMode Tool Executor
+ *
+ * Features:
+ * - Present finalized plan to user
+ * - Signal mode transition
+ * - Wait for user approval before execution
+ *
+ * Usage:
+ * - ONLY use when task requires planning implementation steps
+ * - For research tasks (gathering info, searching files) - do NOT use
+ * - Plan should be clear and unambiguous
+ * - If multiple approaches exist, use AskUserQuestion first to clarify
+ */
+export declare class ExitPlanModeTool extends BaseTool<ExitPlanModeToolParams, ToolResult> {
+    private config;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: ExitPlanModeToolParams): string | null;
+    getDescription(params: ExitPlanModeToolParams): string;
+    execute(params: ExitPlanModeToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Format plan for user presentation
+     */
+    private formatPlan;
+}
+//# sourceMappingURL=ExitPlanModeTool.d.ts.map

package/dist/implementations/ui/ExitPlanModeTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExitPlanModeTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/ui/ExitPlanModeTool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ,CAC5C,sBAAsB,EACtB,UAAU,CACX;IACa,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IA6B1C,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI;IA0BjE,cAAc,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM;IAKhD,OAAO,CACX,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IAyEtB;;OAEG;IACH,OAAO,CAAC,UAAU;CAanB"}

package/dist/implementations/ui/ExitPlanModeTool.js

@@ -0,0 +1,150 @@
+/**
+ * ExitPlanMode Tool Executor
+ *
+ * Signals transition from planning mode to execution mode.
+ * Used when agent has finished planning and is ready to implement.
+ */
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+import { markAutoResearchPlanMode } from '../../utils/autoResearchPlanGate.js';
+/**
+ * ExitPlanMode Tool Executor
+ *
+ * Features:
+ * - Present finalized plan to user
+ * - Signal mode transition
+ * - Wait for user approval before execution
+ *
+ * Usage:
+ * - ONLY use when task requires planning implementation steps
+ * - For research tasks (gathering info, searching files) - do NOT use
+ * - Plan should be clear and unambiguous
+ * - If multiple approaches exist, use AskUserQuestion first to clarify
+ */
+export class ExitPlanModeTool extends BaseTool {
+    config;
+    constructor(config) {
+        super('ExitPlanMode', 'ExitPlanMode', `Use this tool when you are in plan mode and have finished presenting your plan and are ready to code. This will prompt the user to exit plan mode.
+
+IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
+
+## Handling Ambiguity in Plans
+Before using this tool, ensure your plan is clear and unambiguous. If there are multiple valid approaches or unclear requirements:
+1. Use the AskUserQuestion tool to clarify with the user
+2. Ask about specific implementation choices (e.g., architectural patterns, which library to use)
+3. Clarify any assumptions that could affect the implementation
+4. Only proceed with ExitPlanMode after resolving ambiguities`, {
+            type: 'object',
+            properties: {
+                plan: {
+                    type: 'string',
+                    description: 'The plan you came up with, that you want to run by the user for approval. Supports markdown. The plan should be pretty concise.',
+                    minLength: 10,
+                },
+            },
+            required: ['plan'],
+        });
+        this.config = config;
+    }
+    validateToolParams(params) {
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        // Validate plan is not empty
+        if (!params.plan || !params.plan.trim()) {
+            return 'Plan cannot be empty.';
+        }
+        // Validate minimum length (should be a meaningful plan)
+        if (params.plan.trim().length < 10) {
+            return 'Plan is too short. Please provide a meaningful plan (at least 10 characters).';
+        }
+        // Warn if plan is very long (should be concise)
+        if (params.plan.length > 5000) {
+            // Don't error, just note in metadata
+            // Plan can be long if needed, but typically should be concise
+        }
+        return null;
+    }
+    getDescription(params) {
+        const wordCount = params.plan.split(/\s+/).length;
+        return `Presenting plan for approval (~${wordCount} words)`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Plan presentation was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Validate parameters
+            const validationError = this.validateToolParams(params);
+            if (validationError) {
+                return {
+                    ...this.createErrorResult(validationError),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // A valid plan was presented — satisfies the interactive auto-research plan-gate.
+            markAutoResearchPlanMode();
+            // Format the plan for presentation
+            const formattedOutput = this.formatPlan(params.plan);
+            // Calculate plan metrics
+            const wordCount = params.plan.split(/\s+/).length;
+            const lineCount = params.plan.split('\n').length;
+            const hasMarkdown = params.plan.includes('**') ||
+                params.plan.includes('##') ||
+                params.plan.includes('- ');
+            return {
+                ...this.createSuccessResult(formattedOutput),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    planLength: params.plan.length,
+                    wordCount,
+                    lineCount,
+                    hasMarkdown,
+                },
+            };
+        }
+        catch (error) {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Plan presentation was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            const errorMessage = error.message || String(error);
+            return {
+                ...this.createErrorResult(`Error presenting plan: ${errorMessage}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+    /**
+     * Format plan for user presentation
+     */
+    formatPlan(plan) {
+        const lines = [];
+        lines.push('=== Plan Ready for Execution ===\n\n');
+        lines.push(plan);
+        lines.push('\n\n---\n');
+        lines.push('Ready to exit plan mode and begin implementation.\n');
+        lines.push('Waiting for user approval...\n');
+        return lines.join('');
+    }
+}
+//# sourceMappingURL=ExitPlanModeTool.js.map

package/dist/implementations/ui/ExitPlanModeTool.js.map

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

package/dist/implementations/ui/TodoWriteTool.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Split-Tool Todo Executors — TodoCreate, TodoUpdate, TodoList
+ *
+ * Three targeted tools matching the TaskCreate/TaskUpdate/TaskList.
+ * Key design decisions:
+ * - TodoCreate/TodoUpdate return ONLY the affected task (compact output)
+ * - TodoList returns the full list (use it when you need the overview)
+ * - TodoUpdate accepts multiple taskIds for batch status changes
+ * - Shared in-memory state via module-level Map
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+export type TodoStatus = 'pending' | 'in_progress' | 'completed';
+export interface TodoItem {
+    id: string;
+    content: string;
+    description: string;
+    activeForm: string;
+    status: TodoStatus;
+    createdAt: number;
+    updatedAt: number;
+}
+/** Reset state (for testing) */
+export declare function resetTodoState(): void;
+/** Get current todos (for SystemReminderInjector) */
+export declare function getCurrentTodos(): TodoItem[];
+export interface TodoCreateParams {
+    content: string;
+    description?: string;
+    activeForm?: string;
+}
+export declare class TodoCreateTool extends BaseTool<TodoCreateParams, ToolResult> {
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: TodoCreateParams): string | null;
+    getDescription(params: TodoCreateParams): string;
+    execute(params: TodoCreateParams, signal: AbortSignal): Promise<ToolResult>;
+}
+export interface TodoUpdateParams {
+    taskId: string;
+    status?: TodoStatus;
+    content?: string;
+    description?: string;
+    activeForm?: string;
+}
+export declare class TodoUpdateTool extends BaseTool<TodoUpdateParams, ToolResult> {
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: TodoUpdateParams): string | null;
+    getDescription(params: TodoUpdateParams): string;
+    execute(params: TodoUpdateParams, signal: AbortSignal): Promise<ToolResult>;
+}
+export interface TodoListParams {
+}
+export declare class TodoListTool extends BaseTool<TodoListParams, ToolResult> {
+    constructor(config: ExecutorConfig);
+    validateToolParams(_params: TodoListParams): string | null;
+    getDescription(_params: TodoListParams): string;
+    execute(_params: TodoListParams, signal: AbortSignal): Promise<ToolResult>;
+}
+//# sourceMappingURL=TodoWriteTool.d.ts.map

package/dist/implementations/ui/TodoWriteTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TodoWriteTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/ui/TodoWriteTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIjE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAEjE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,gCAAgC;AAChC,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED,qDAAqD;AACrD,wBAAgB,eAAe,IAAI,QAAQ,EAAE,CAI5C;AAyCD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,cAAe,SAAQ,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC;gBAC5D,MAAM,EAAE,cAAc;IAiClC,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI;IAO3D,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAI1C,OAAO,CACX,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC;CA6CvB;AAID,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,cAAe,SAAQ,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC;gBAC5D,MAAM,EAAE,cAAc;IA2ClC,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI;IAa3D,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAO1C,OAAO,CACX,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC;CAgHvB;AAID,MAAM,WAAW,cAAc;CAE9B;AAED,qBAAa,YAAa,SAAQ,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;gBACxD,MAAM,EAAE,cAAc;IAalC,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI;IAI1D,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM;IAIzC,OAAO,CACX,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC;CA2BvB"}