@deepseekdev/coder 1.0.74

package/dist/tools/hitlTools.js

@@ -0,0 +1,189 @@
+/**
+ * HITL Tools - The ONLY human-in-the-loop tools in the repository
+ * Provides decision points for critical operations
+ */
+import { getHITL, hitl } from '../core/hitl.js';
+export function createHITLTools() {
+    return [
+        {
+            name: 'HITL_Decision',
+            description: 'Pause execution and request human decision. ONLY use this for extremely complex refactoring or when deep planning is needed. For routine tasks, proceed autonomously without asking for human input.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Decision title/question' },
+                    description: { type: 'string', description: 'Detailed description of the decision' },
+                    context: { type: 'string', description: 'Additional context information' },
+                    options: {
+                        type: 'array',
+                        description: 'Available options as JSON array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                id: { type: 'string' },
+                                label: { type: 'string' },
+                                description: { type: 'string' },
+                                shortcut: { type: 'string' }
+                            }
+                        }
+                    },
+                    defaultOptionId: { type: 'string', description: 'Default option ID' },
+                    requiresExplicitChoice: { type: 'boolean', description: 'Require explicit user choice' },
+                    autoPause: { type: 'boolean', description: 'Auto-pause execution for decision' },
+                    timeoutMs: { type: 'number', description: 'Timeout in milliseconds (0 = no timeout)' }
+                },
+                required: ['title', 'description']
+            },
+            handler: async (args) => {
+                const typedArgs = args;
+                const hitlSystem = getHITL({
+                    autoPause: typedArgs.autoPause ?? true,
+                    timeoutMs: typedArgs.timeoutMs ?? 0,
+                    logLevel: 'detailed'
+                });
+                const options = (typedArgs.options || []).map(opt => ({
+                    id: opt.id,
+                    label: opt.label,
+                    description: opt.description,
+                    shortcut: opt.shortcut
+                }));
+                // If no options provided, create yes/no default
+                if (options.length === 0) {
+                    options.push({ id: 'yes', label: 'Yes', description: 'Proceed with suggested plan', shortcut: 'y' }, { id: 'no', label: 'No', description: 'Do not proceed', shortcut: 'n' });
+                }
+                const selectedOptionId = await hitlSystem.requestDecision({
+                    id: `hitl-tool-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`,
+                    title: typedArgs.title,
+                    description: typedArgs.description,
+                    context: typedArgs.context || '',
+                    options,
+                    defaultOptionId: typedArgs.defaultOptionId,
+                    requiresExplicitChoice: typedArgs.requiresExplicitChoice ?? true
+                });
+                const selectedOption = options.find(opt => opt.id === selectedOptionId);
+                const isCustomOption = selectedOptionId.startsWith('custom-');
+                if (isCustomOption) {
+                    const hitl = getHITL();
+                    const history = hitl.getHistory();
+                    const latestDecision = history[history.length - 1];
+                    const customInput = latestDecision?.userInput || 'Custom input (no details available)';
+                    return `HITL decision: Custom Input
+Selected option ID: ${selectedOptionId}
+Custom input: ${customInput}
+Timestamp: ${new Date().toISOString()}
+Note: Custom HITL input recorded. This is the ONLY human-in-the-loop system in the repository.`;
+                }
+                return `HITL decision: ${selectedOption?.label || selectedOptionId}
+Selected option ID: ${selectedOptionId}
+Timestamp: ${new Date().toISOString()}
+Note: HITL decision recorded. This is the ONLY human-in-the-loop system in the repository.`;
+            }
+        },
+        {
+            name: 'HITL_YesNo',
+            description: 'Simple yes/no decision point. ONLY use for extremely complex refactoring or deep planning decisions. Do not use for routine operations.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Decision title/question' },
+                    description: { type: 'string', description: 'Detailed description' },
+                    context: { type: 'string', description: 'Additional context' },
+                    defaultYes: { type: 'boolean', description: 'Default to yes (true) or no (false)' }
+                },
+                required: ['title', 'description']
+            },
+            handler: async (args) => {
+                const typedArgs = args;
+                const result = await hitl.askYesNo(typedArgs.title, typedArgs.description, typedArgs.context || '', typedArgs.defaultYes ?? true);
+                return `HITL yes/no decision: ${result ? 'yes' : 'no'}
+Approved: ${result}
+Timestamp: ${new Date().toISOString()}
+Note: HITL yes/no decision recorded`;
+            }
+        },
+        {
+            name: 'HITL_Select',
+            description: 'Select from multiple options. ONLY use for extremely complex refactoring or deep planning decisions. Do not use for routine operations.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Selection title' },
+                    description: { type: 'string', description: 'Detailed description' },
+                    options: { type: 'string', description: 'JSON array of options: [{id, label, description}]' },
+                    context: { type: 'string', description: 'Additional context' },
+                    defaultOptionId: { type: 'string', description: 'Default option ID' }
+                },
+                required: ['title', 'description', 'options']
+            },
+            handler: async (args) => {
+                const typedArgs = args;
+                let options;
+                try {
+                    options = JSON.parse(typedArgs.options);
+                }
+                catch (error) {
+                    throw new Error(`Invalid options JSON: ${error}`);
+                }
+                const result = await hitl.selectOption(typedArgs.title, typedArgs.description, options, typedArgs.context || '', typedArgs.defaultOptionId);
+                const selectedOption = options.find(opt => opt.id === result);
+                return `HITL selection: ${selectedOption?.label || result}
+Selected option ID: ${result}
+Timestamp: ${new Date().toISOString()}
+Note: HITL selection recorded`;
+            }
+        },
+        {
+            name: 'HITL_Approval',
+            description: 'Request approval for risky operation. ONLY use for extremely complex refactoring or deep planning decisions. Do not use for routine operations.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Approval title' },
+                    riskDescription: { type: 'string', description: 'Description of risks' },
+                    operationDetails: { type: 'string', description: 'Detailed operation description' }
+                },
+                required: ['title', 'riskDescription']
+            },
+            handler: async (args) => {
+                const typedArgs = args;
+                const result = await hitl.requestApproval(typedArgs.title, typedArgs.riskDescription, typedArgs.operationDetails || '');
+                return `HITL approval: ${result ? 'approved' : 'rejected'}
+Approved: ${result}
+Timestamp: ${new Date().toISOString()}
+Note: ${result ? 'Operation approved via HITL' : 'Operation rejected via HITL'}`;
+            }
+        },
+        {
+            name: 'HITL_Status',
+            description: 'Get HITL system status and history',
+            parameters: {
+                type: 'object',
+                properties: {
+                    clearHistory: { type: 'boolean', description: 'Clear decision history' }
+                }
+            },
+            handler: async (args) => {
+                const hitlSystem = getHITL();
+                if (args.clearHistory) {
+                    hitlSystem.clearHistory();
+                    return `HITL history cleared
+Timestamp: ${new Date().toISOString()}`;
+                }
+                const history = hitlSystem.getHistory();
+                const recentDecisions = history.slice(-5).map(decision => ({
+                    requestId: decision.requestId,
+                    selectedOptionId: decision.selectedOptionId,
+                    timestamp: decision.timestamp.toISOString(),
+                    hasCustomInput: !!decision.userInput
+                }));
+                return `HITL System Status
+Status: active
+Total decisions: ${history.length}
+Recent decisions:
+${recentDecisions.map(d => `  • ${d.selectedOptionId} at ${d.timestamp}${d.hasCustomInput ? ' (custom input)' : ''}`).join('\n')}
+Note: This is the ONLY human-in-the-loop system in the repository`;
+            }
+        }
+    ];
+}
+//# sourceMappingURL=hitlTools.js.map

package/dist/tools/hitlTools.js.map

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

package/dist/tools/humanOpsTools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function createHumanOpsTools(): ToolDefinition[];
+//# sourceMappingURL=humanOpsTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"humanOpsTools.d.ts","sourceRoot":"","sources":["../../src/tools/humanOpsTools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAgH7D,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAgBtD"}

package/dist/tools/humanOpsTools.js

@@ -0,0 +1,86 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+function getTaskDir() {
+    const root = process.env['AGI_HUMAN_TASK_DIR'] || join(homedir(), '.agi', 'human-tasks');
+    mkdirSync(root, { recursive: true });
+    return root;
+}
+function safeTitle(title) {
+    return title.trim().replace(/[^\w\d-]+/g, '-').replace(/^-+|-+$/g, '').toLowerCase() || 'task';
+}
+function writeTask(record, path) {
+    mkdirSync(getTaskDir(), { recursive: true });
+    writeFileSync(path, JSON.stringify(record, null, 2), 'utf8');
+}
+function createNewTask(args) {
+    const dir = getTaskDir();
+    const title = args.title?.trim() || 'Untitled task';
+    const record = {
+        title,
+        context: args.context,
+        urgency: args.urgency ?? 'normal',
+        needsBrowser: args.needsBrowser ?? false,
+        needsCaptcha: args.needsCaptcha ?? false,
+        emailDomain: args.emailDomain,
+        catchAll: args.catchAll,
+        domainRegistrar: args.domainRegistrar,
+        paymentMethod: args.paymentMethod,
+        phoneVerification: args.phoneVerification,
+        ssoProviders: args.ssoProviders ?? [],
+        proxyPolicy: args.proxyPolicy,
+        steps: (args.steps && args.steps.length ? args.steps : ['Provide update and next actions']).map((s) => String(s)),
+        artifacts: args.artifacts,
+        updates: [
+            {
+                note: args.context ? `Initial context: ${args.context}` : 'Task created',
+                at: new Date().toISOString(),
+            },
+        ],
+    };
+    const path = join(dir, `${safeTitle(title)}-${Date.now()}.json`);
+    writeTask(record, path);
+    const lines = [
+        'Human task recorded',
+        `Title: ${title}`,
+        `Urgency: ${record.urgency}`,
+        record.needsBrowser ? 'Requires browser use' : 'No browser required',
+        record.needsCaptcha ? 'Requires captcha' : 'No captcha required',
+        record.emailDomain ? `Email domain: ${record.emailDomain}` : 'Email domain: n/a',
+        `Steps: ${record.steps.length}`,
+        `Saved at: ${path}`,
+    ];
+    return { path, record, message: lines.join('\n') };
+}
+function appendUpdate(taskPath, note) {
+    const content = readFileSync(taskPath, 'utf8');
+    const record = JSON.parse(content);
+    record.updates = record.updates ?? [];
+    record.updates.push({ note, at: new Date().toISOString() });
+    writeTask(record, taskPath);
+    const lines = [
+        'Update appended to human task',
+        `Title: ${record.title}`,
+        `Updates: ${record.updates.length}`,
+        `Saved at: ${taskPath}`,
+    ];
+    return { path: taskPath, record, message: lines.join('\n') };
+}
+export function createHumanOpsTools() {
+    return [
+        {
+            name: 'HumanIntegration',
+            description: 'Create or update human-in-the-loop tasks with rich metadata (browser, captcha, domain/email needs).',
+            handler: async (args) => {
+                if (args.taskPath && existsSync(args.taskPath)) {
+                    const updateNote = args.update?.trim() || 'Update added';
+                    const { message } = appendUpdate(args.taskPath, updateNote);
+                    return message;
+                }
+                const { message } = createNewTask(args);
+                return message;
+            },
+        },
+    ];
+}
+//# sourceMappingURL=humanOpsTools.js.map

package/dist/tools/humanOpsTools.js.map

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

package/dist/tools/localExplore.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Local Explore - Minimal stub for backward compatibility
+ */
+export type AIEnhancer = (prompt: string) => Promise<string>;
+export declare function setGlobalAIEnhancer(enhancer: AIEnhancer | null): void;
+export declare function getGlobalAIEnhancer(): AIEnhancer | null;
+export interface CodebaseIndex {
+    version: number;
+    createdAt: string;
+    rootDir: string;
+    hash: string;
+    files: IndexedFile[];
+    symbols: SymbolIndex;
+    imports: ImportGraph;
+    patterns: DetectedPatterns;
+}
+export interface IndexedFile {
+    path: string;
+    hash: string;
+    lastModified: number;
+}
+export interface SymbolIndex {
+    functions: Map<string, string[]>;
+    classes: Map<string, string[]>;
+    exports: Map<string, string[]>;
+}
+export interface ImportGraph {
+    nodes: string[];
+    edges: [string, string][];
+}
+export interface DetectedPatterns {
+    frameworks: string[];
+    testFrameworks: string[];
+    buildTools: string[];
+}
+export declare function buildCodebaseIndex(_rootDir: string): Promise<CodebaseIndex>;
+export declare function searchIndex(_index: CodebaseIndex, _query: string): Promise<string[]>;
+//# sourceMappingURL=localExplore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"localExplore.d.ts","sourceRoot":"","sources":["../../src/tools/localExplore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAI7D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAErE;AAED,wBAAgB,mBAAmB,IAAI,UAAU,GAAG,IAAI,CAEvD;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAejF;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB"}

package/dist/tools/localExplore.js

@@ -0,0 +1,30 @@
+/**
+ * Local Explore - Minimal stub for backward compatibility
+ */
+let _globalAIEnhancer = null;
+export function setGlobalAIEnhancer(enhancer) {
+    _globalAIEnhancer = enhancer;
+}
+export function getGlobalAIEnhancer() {
+    return _globalAIEnhancer;
+}
+export async function buildCodebaseIndex(_rootDir) {
+    return {
+        version: 1,
+        createdAt: new Date().toISOString(),
+        rootDir: _rootDir,
+        hash: '',
+        files: [],
+        symbols: {
+            functions: new Map(),
+            classes: new Map(),
+            exports: new Map(),
+        },
+        imports: { nodes: [], edges: [] },
+        patterns: { frameworks: [], testFrameworks: [], buildTools: [] },
+    };
+}
+export async function searchIndex(_index, _query) {
+    return [];
+}
+//# sourceMappingURL=localExplore.js.map

package/dist/tools/localExplore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localExplore.js","sourceRoot":"","sources":["../../src/tools/localExplore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,IAAI,iBAAiB,GAAsB,IAAI,CAAC;AAEhD,MAAM,UAAU,mBAAmB,CAAC,QAA2B;IAC7D,iBAAiB,GAAG,QAAQ,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAoCD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,EAAE;QACT,OAAO,EAAE;YACP,SAAS,EAAE,IAAI,GAAG,EAAE;YACpB,OAAO,EAAE,IAAI,GAAG,EAAE;YAClB,OAAO,EAAE,IAAI,GAAG,EAAE;SACnB;QACD,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACjC,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAqB,EACrB,MAAc;IAEd,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/tools/metaTools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function createMetaTools(_workingDir: string): ToolDefinition[];
+//# sourceMappingURL=metaTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metaTools.d.ts","sourceRoot":"","sources":["../../src/tools/metaTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAiD7D,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE,CA0HrE"}

package/dist/tools/metaTools.js

@@ -0,0 +1,148 @@
+function nowSeconds(ms) {
+    if (!ms || ms < 1000)
+        return '1s';
+    const seconds = Math.round(ms / 1000);
+    return `${seconds}s`;
+}
+function renderDiff(diff) {
+    const additions = diff.additions ?? 0;
+    const removals = diff.removals ?? 0;
+    const lines = diff.lines ?? [];
+    const rendered = lines
+        .map((line) => {
+        const prefix = line.type === 'add' ? '+' : line.type === 'remove' ? '-' : ' ';
+        return `${prefix}  ${line.content}`;
+    })
+        .join('\n');
+    return `+${additions} -${removals}\n${rendered}`;
+}
+function pickTool(prompt) {
+    const lower = prompt.toLowerCase();
+    const globKeywords = ['devops', 'education', 'ecommerce', 'hr ', 'real estate', 'travel', 'kanban', 'crm', 'messaging', 'booking'];
+    if (globKeywords.some((kw) => lower.includes(kw))) {
+        return 'Glob';
+    }
+    return 'Bash';
+}
+export function createMetaTools(_workingDir) {
+    const tools = [
+        {
+            name: 'CheckFeasibility',
+            description: 'Assess feasibility of a request.',
+            handler: async ({ request }) => {
+                return [
+                    'Feasibility Analysis',
+                    `Request: ${request ?? ''}`,
+                    `Feasible:** Yes`,
+                    'Factors: timeline, scope, dependencies',
+                ].join('\n');
+            },
+        },
+        {
+            name: 'DecomposeTask',
+            description: 'Break a request into sub-tasks.',
+            handler: async ({ request }) => {
+                const tasks = ['research', 'plan', 'implement', 'test', 'deliver'].map((task, idx) => `[task-${idx + 1}] ${task} ${request ?? ''}`);
+                return ['Task Decomposition', ...tasks].join('\n');
+            },
+        },
+        {
+            name: 'AnalyzeAmbiguity',
+            description: 'Identify unclear parts of a prompt.',
+            handler: async ({ prompt }) => `Ambiguity Analysis\nPrompt: ${prompt ?? ''}\nClarifications: none`,
+        },
+        {
+            name: 'SuggestApproach',
+            description: 'Suggest an execution approach.',
+            handler: async ({ prompt }) => `Approach\nPrompt: ${prompt ?? ''}\nPlan: iterate, validate, deliver`,
+        },
+        {
+            name: 'ThinkingProcess',
+            description: 'Outline a thinking process.',
+            handler: async () => 'Thinking\nInterpretation\nExecution Plan\nReady for Execution',
+        },
+        {
+            name: 'ExecuteWorkflow',
+            description: 'Represent a workflow execution.',
+            handler: async ({ name }) => `Workflow Execution\nName: ${name ?? 'Workflow'}\nReady`,
+        },
+        {
+            name: 'RecordEvidence',
+            description: 'Record execution evidence.',
+            handler: async () => 'Evidence\nCaptured logs and diffs',
+        },
+        {
+            name: 'ToolExecutionDisplay',
+            description: 'Format tool execution display.',
+            handler: async (args) => {
+                const base = [
+                    `⏺ ${args.toolName ?? 'Tool'}`,
+                    '⎿',
+                    `Status: ${args.status ?? 'completed'}`,
+                    `Duration: ${nowSeconds(args.durationMs ?? 1000)}`,
+                ];
+                if (args.diff) {
+                    base.push(renderDiff(args.diff));
+                }
+                return base.join('\n');
+            },
+        },
+        {
+            name: 'WorkflowOrchestrator',
+            description: 'Plan workflow execution.',
+            handler: async ({ name, steps }) => {
+                const lines = [];
+                lines.push(`Workflow: ${name ?? 'workflow'}`);
+                for (const step of steps ?? []) {
+                    lines.push(`[${step.id}] ${step.name}`);
+                    if (step.dependsOn?.length) {
+                        lines.push(`after: ${step.dependsOn.join(', ')}`);
+                    }
+                }
+                return lines.join('\n');
+            },
+        },
+        {
+            name: 'OperationStatus',
+            description: 'Summarize operation status.',
+            handler: async () => 'Operation Status: active',
+        },
+        {
+            name: 'UnifiedPromptHandler',
+            description: 'Generate unified handling for prompts.',
+            handler: async ({ prompt }) => ['Thinking', `Interpretation: ${prompt ?? ''}`, 'Execution Plan: steps outlined', 'Ready for Execution'].join('\n'),
+        },
+        {
+            name: 'RealToolChain',
+            description: 'Execute a tool chain.',
+            handler: async ({ name, tools = [] }) => {
+                const lines = [`Tool Chain: ${name ?? 'Tool Chain'}`];
+                lines.push('EXECUTING');
+                for (const tool of tools) {
+                    lines.push(`⏺ ${tool.tool}`);
+                    if (tool.description) {
+                        lines.push(tool.description);
+                    }
+                }
+                return lines.join('\n');
+            },
+        },
+        {
+            name: 'GenerateToolCalls',
+            description: 'Generate tool calls for a prompt.',
+            handler: async ({ prompt = '' }) => {
+                const tool = pickTool(prompt);
+                const payload = { tool, args: { prompt } };
+                return [
+                    'Generated Tool Calls',
+                    `Primary: ${tool}`,
+                    '```json',
+                    JSON.stringify(payload, null, 2),
+                    '```',
+                ].join('\n');
+            },
+        },
+    ];
+    return tools;
+}
+//# sourceMappingURL=metaTools.js.map

package/dist/tools/metaTools.js.map

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

package/dist/tools/planningTools.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Planning Tools - Claude Code-style planning with suggestions and user input
+ *
+ * Workflow: Explore → Plan → Execute
+ * Each plan step supports:
+ * - Pre-generated suggestions
+ * - User custom instructions
+ * - Editable step details
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+/**
+ * A single step in a plan with suggestions for user selection
+ */
+export interface PlanStep {
+    /** Step description/title */
+    description: string;
+    /** Pre-generated suggestions for this step (user can select or write their own) */
+    suggestions?: string[];
+    /** User's selected or custom instruction for this step */
+    userInstruction?: string;
+    /** Files/components this step will affect */
+    affectedScope?: string[];
+    /** Estimated complexity: low, medium, high */
+    complexity?: 'low' | 'medium' | 'high';
+    /** Whether this step requires user confirmation before execution */
+    requiresConfirmation?: boolean;
+    /** Dependencies on other step indices */
+    dependsOn?: number[];
+}
+/**
+ * Complete plan with metadata
+ */
+export interface Plan {
+    /** Plan title/summary */
+    title: string;
+    /** Overall explanation of the plan */
+    explanation: string;
+    /** Individual steps */
+    steps: PlanStep[];
+    /** Whether exploration was completed before planning */
+    explorationComplete: boolean;
+    /** Summary of what was learned during exploration */
+    explorationSummary?: string;
+    /** Identified risks or concerns */
+    risks?: string[];
+    /** Alternative approaches considered */
+    alternatives?: string[];
+}
+/**
+ * User's response to a plan step
+ */
+export interface StepUserInput {
+    /** Which suggestion was selected (index), or -1 for custom */
+    selectedSuggestion: number;
+    /** Custom instruction if selectedSuggestion is -1 */
+    customInstruction?: string;
+    /** Whether to skip this step */
+    skip?: boolean;
+    /** Additional notes from user */
+    notes?: string;
+}
+/**
+ * Callback for plan approval with step-by-step user input
+ */
+export type PlanApprovalCallback = (plan: Plan, resolve: (result: PlanApprovalResult) => void) => void;
+export interface PlanApprovalResult {
+    approved: boolean;
+    /** User inputs for each step (index matches step index) */
+    stepInputs?: StepUserInput[];
+    /** Overall feedback from user */
+    feedback?: string;
+    /** Whether to re-plan with modifications */
+    requestRePlan?: boolean;
+}
+export declare function setPlanApprovalCallback(callback: PlanApprovalCallback | null): void;
+export declare function getPlanApprovalCallback(): PlanApprovalCallback | null;
+export declare function setExplorationComplete(complete: boolean): void;
+export declare function isExplorationComplete(): boolean;
+export declare function getCurrentPlan(): Plan | null;
+export declare function createPlanningTools(_workingDir: string): ToolDefinition[];
+//# sourceMappingURL=planningTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planningTools.d.ts","sourceRoot":"","sources":["../../src/tools/planningTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,wDAAwD;IACxD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,KAC1C,IAAI,CAAC;AAEV,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAMD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAEnF;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,IAAI,CAErE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAE9D;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,cAAc,IAAI,IAAI,GAAG,IAAI,CAE5C;AA6DD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE,CAsTzE"}