gencode-ai 0.4.1 → 0.5.0

package/dist/core/tools/builtin/websearch.js

@@ -0,0 +1,87 @@
+/**
+ * WebSearch Tool - Search the web for current information
+ */
+import { z } from 'zod';
+import { getErrorMessage } from '../types.js';
+import { createSearchProvider, getCurrentSearchProviderName, } from '../../providers/search/index.js';
+import { loadToolDescription } from '../../../cli/prompts/index.js';
+// Constants
+const DEFAULT_NUM_RESULTS = 10;
+// Input schema
+export const WebSearchInputSchema = z.object({
+    query: z
+        .string()
+        .min(2)
+        .describe('The search query (minimum 2 characters)'),
+    allowed_domains: z
+        .array(z.string())
+        .optional()
+        .describe('Only include results from these domains'),
+    blocked_domains: z
+        .array(z.string())
+        .optional()
+        .describe('Exclude results from these domains'),
+    num_results: z
+        .number()
+        .optional()
+        .describe(`Number of results to return (default: ${DEFAULT_NUM_RESULTS})`),
+});
+/**
+ * Format search results as markdown
+ */
+function formatResults(results, query) {
+    if (results.length === 0) {
+        return `No results found for "${query}".`;
+    }
+    const lines = [`Found ${results.length} results for "${query}":\n`];
+    results.forEach((result, index) => {
+        lines.push(`${index + 1}. [${result.title}](${result.url})`);
+        if (result.snippet) {
+            lines.push(`   ${result.snippet}\n`);
+        }
+        else {
+            lines.push('');
+        }
+    });
+    return lines.join('\n');
+}
+/**
+ * WebSearch Tool
+ */
+export const websearchTool = {
+    name: 'WebSearch',
+    description: loadToolDescription('websearch'),
+    parameters: WebSearchInputSchema,
+    async execute(input, context) {
+        const startTime = Date.now();
+        try {
+            const provider = createSearchProvider();
+            const results = await provider.search(input.query, {
+                numResults: input.num_results ?? DEFAULT_NUM_RESULTS,
+                allowedDomains: input.allowed_domains,
+                blockedDomains: input.blocked_domains,
+                abortSignal: context.abortSignal,
+            });
+            const output = formatResults(results, input.query);
+            const duration = Date.now() - startTime;
+            const providerName = getCurrentSearchProviderName();
+            return {
+                success: true,
+                output,
+                metadata: {
+                    title: `Search("${input.query}")`,
+                    subtitle: `Found ${results.length} results via ${providerName}`,
+                    duration,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: `Search failed: ${getErrorMessage(error)}`,
+            };
+        }
+    },
+};
+//# sourceMappingURL=websearch.js.map

package/dist/core/tools/builtin/websearch.js.map

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

package/dist/core/tools/builtin/write.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Write Tool - Write content to a file
+ *
+ * In plan mode, this tool is only allowed to write to the plan file.
+ */
+import type { Tool } from '../types.js';
+import { type WriteInput } from '../types.js';
+export declare const writeTool: Tool<WriteInput>;
+//# sourceMappingURL=write.d.ts.map

package/dist/core/tools/builtin/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/builtin/write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,aAAa,CAAC;AACpD,OAAO,EAAoB,KAAK,UAAU,EAAgC,MAAM,aAAa,CAAC;AAI9F,eAAO,MAAM,SAAS,EAAE,IAAI,CAAC,UAAU,CA+BtC,CAAC"}

package/dist/core/tools/builtin/write.js

@@ -0,0 +1,40 @@
+/**
+ * Write Tool - Write content to a file
+ *
+ * In plan mode, this tool is only allowed to write to the plan file.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { WriteInputSchema, resolvePath, getErrorMessage } from '../types.js';
+import { loadToolDescription } from '../../../cli/prompts/index.js';
+import { getPlanModeManager } from '../../../cli/planning/index.js';
+export const writeTool = {
+    name: 'Write',
+    description: loadToolDescription('write'),
+    parameters: WriteInputSchema,
+    async execute(input, context) {
+        try {
+            const filePath = resolvePath(input.file_path, context.cwd);
+            // Plan mode check: only allow writing to the plan file
+            const planManager = getPlanModeManager();
+            if (planManager.isActive()) {
+                const planFilePath = planManager.getPlanFilePath();
+                if (!planFilePath || path.resolve(filePath) !== path.resolve(planFilePath)) {
+                    return {
+                        success: false,
+                        output: '',
+                        error: `Write is blocked in plan mode. You can only write to the plan file: ${planFilePath ?? '(no plan file set)'}`,
+                    };
+                }
+            }
+            await fs.mkdir(path.dirname(filePath), { recursive: true });
+            await fs.writeFile(filePath, input.content, 'utf-8');
+            const lineCount = input.content.split('\n').length;
+            return { success: true, output: `Successfully wrote ${lineCount} lines to ${filePath}` };
+        }
+        catch (error) {
+            return { success: false, output: '', error: `Failed to write file: ${getErrorMessage(error)}` };
+        }
+    },
+};
+//# sourceMappingURL=write.js.map

package/dist/core/tools/builtin/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../../src/core/tools/builtin/write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAmB,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,MAAM,CAAC,MAAM,SAAS,GAAqB;IACzC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,mBAAmB,CAAC,OAAO,CAAC;IACzC,UAAU,EAAE,gBAAgB;IAE5B,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO;QAC1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAE3D,uDAAuD;YACvD,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;YACzC,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC;gBAC3B,MAAM,YAAY,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC;gBACnD,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC3E,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,EAAE;wBACV,KAAK,EAAE,uEAAuE,YAAY,IAAI,oBAAoB,EAAE;qBACrH,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAErD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,sBAAsB,SAAS,aAAa,QAAQ,EAAE,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,yBAAyB,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QAClG,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/core/tools/factories/mcp-tool-factory.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP Tool Bridge
+ * Converts MCP tools to gencode Tool format
+ */
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { Tool } from '../types.js';
+import type { MCPToolDef } from '../../../ext/mcp/types.js';
+/**
+ * Bridge an MCP tool to gencode Tool format
+ */
+export declare function bridgeMCPTool(mcpTool: MCPToolDef, client: Client, serverName: string): Tool;
+/**
+ * Bridge multiple MCP tools from a server
+ */
+export declare function bridgeMCPTools(client: Client, serverName: string): Promise<Tool[]>;
+//# sourceMappingURL=mcp-tool-factory.d.ts.map

package/dist/core/tools/factories/mcp-tool-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-factory.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/factories/mcp-tool-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAoB5D;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,IAAI,CAoDN;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,EAAE,CAAC,CAajB"}

package/dist/core/tools/factories/mcp-tool-factory.js

@@ -0,0 +1,92 @@
+/**
+ * MCP Tool Bridge
+ * Converts MCP tools to gencode Tool format
+ */
+import { z } from 'zod';
+/**
+ * Convert JSON Schema to Zod schema (simplified version)
+ * This is a basic implementation - full JSON Schema support would be complex
+ */
+function jsonSchemaToZod(schema) {
+    // For now, use a permissive object schema
+    // A full implementation would parse the JSON Schema and build the correct Zod schema
+    // This allows any object to pass validation
+    return z.record(z.string(), z.unknown());
+}
+/**
+ * Sanitize a string for use in tool names
+ */
+function sanitize(str) {
+    return str.replace(/[^a-zA-Z0-9_]/g, '_');
+}
+/**
+ * Bridge an MCP tool to gencode Tool format
+ */
+export function bridgeMCPTool(mcpTool, client, serverName) {
+    const toolName = `mcp_${sanitize(serverName)}_${sanitize(mcpTool.name)}`;
+    return {
+        name: toolName,
+        description: mcpTool.description ?? `MCP tool from ${serverName}: ${mcpTool.name}`,
+        parameters: jsonSchemaToZod(mcpTool.inputSchema),
+        execute: async (input, context) => {
+            try {
+                // Call the MCP tool via the client
+                const result = await client.callTool({
+                    name: mcpTool.name,
+                    arguments: input,
+                });
+                // Check if the result is an error
+                if (result.isError) {
+                    return {
+                        success: false,
+                        output: '',
+                        error: `MCP tool error: ${JSON.stringify(result.content)}`,
+                    };
+                }
+                // Format the successful result
+                const content = result.content;
+                const output = content
+                    .map((item) => {
+                    if (item.type === 'text') {
+                        return item.text;
+                    }
+                    else if (item.type === 'image') {
+                        return `[Image: ${item.mimeType}]`;
+                    }
+                    else if (item.type === 'resource') {
+                        return `[Resource: ${item.resource.uri}]`;
+                    }
+                    return JSON.stringify(item);
+                })
+                    .join('\n');
+                return {
+                    success: true,
+                    output,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    output: '',
+                    error: `Failed to execute MCP tool: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    };
+}
+/**
+ * Bridge multiple MCP tools from a server
+ */
+export async function bridgeMCPTools(client, serverName) {
+    try {
+        // List available tools from the MCP server
+        const toolsResult = await client.listTools();
+        // Convert each MCP tool to gencode Tool format
+        return toolsResult.tools.map((mcpTool) => bridgeMCPTool(mcpTool, client, serverName));
+    }
+    catch (error) {
+        console.warn(`Failed to list tools from MCP server "${serverName}":`, error);
+        return [];
+    }
+}
+//# sourceMappingURL=mcp-tool-factory.js.map

package/dist/core/tools/factories/mcp-tool-factory.js.map

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

package/dist/core/tools/factories/skill-tool-factory.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Skill Tool - Dynamically generated tool for activating skills
+ *
+ * The Skill tool provides access to domain-specific knowledge through SKILL.md files.
+ * Tool description is dynamically generated to list all available skills.
+ */
+import type { Tool } from '../types.js';
+import type { SkillInput } from '../../../ext/skills/types.js';
+/**
+ * Reset the shared discovery instance (for testing purposes)
+ * This allows tests to start with a clean state
+ */
+export declare function resetSkillDiscovery(): void;
+/**
+ * Create the Skill tool with dynamically generated description
+ *
+ * Discovers all skills from filesystem and builds tool with:
+ * - Description listing all available skills
+ * - Execute function that injects skill content
+ *
+ * @param projectRoot - Project root directory for skill discovery
+ * @param options - Optional configuration (for testing)
+ * @returns Tool instance ready for registration
+ */
+export declare function createSkillTool(projectRoot: string, options?: {
+    projectOnly?: boolean;
+}): Promise<Tool<SkillInput>>;
+//# sourceMappingURL=skill-tool-factory.d.ts.map

package/dist/core/tools/factories/skill-tool-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tool-factory.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/factories/skill-tool-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,8BAA8B,CAAC;AAShF;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CA0E3B"}

package/dist/core/tools/factories/skill-tool-factory.js

@@ -0,0 +1,154 @@
+/**
+ * Skill Tool - Dynamically generated tool for activating skills
+ *
+ * The Skill tool provides access to domain-specific knowledge through SKILL.md files.
+ * Tool description is dynamically generated to list all available skills.
+ */
+import { z } from 'zod';
+import { SkillDiscovery } from '../../../ext/skills/manager.js';
+import { formatBoxedMessage } from '../../../base/utils/format-utils.js';
+import { isVerboseDebugEnabled } from '../../../base/utils/debug.js';
+import { logger } from '../../../base/utils/logger.js';
+// Module-level discovery instance (shared across tool invocations in production)
+// This is a singleton for performance, but can be reset for testing
+let sharedDiscovery = new SkillDiscovery();
+/**
+ * Reset the shared discovery instance (for testing purposes)
+ * This allows tests to start with a clean state
+ */
+export function resetSkillDiscovery() {
+    sharedDiscovery = new SkillDiscovery();
+}
+/**
+ * Create the Skill tool with dynamically generated description
+ *
+ * Discovers all skills from filesystem and builds tool with:
+ * - Description listing all available skills
+ * - Execute function that injects skill content
+ *
+ * @param projectRoot - Project root directory for skill discovery
+ * @param options - Optional configuration (for testing)
+ * @returns Tool instance ready for registration
+ */
+export async function createSkillTool(projectRoot, options) {
+    // Use a new discovery instance with options if provided, otherwise use shared instance
+    const discovery = options ? new SkillDiscovery(options) : sharedDiscovery;
+    // Discover all skills from hierarchical directories
+    await discovery.discover(projectRoot);
+    const skills = discovery.getAll();
+    // Build dynamic description with skills list
+    const description = buildSkillDescription(skills);
+    return {
+        name: 'Skill',
+        description,
+        parameters: z.object({
+            skill: z.string().describe('Skill name to activate'),
+            args: z.string().optional().describe('Optional arguments for the skill'),
+        }),
+        async execute(input, context) {
+            // Verbose debug: Log skill activation attempt
+            if (isVerboseDebugEnabled('skills')) {
+                logger.debug('Skill', `Activating skill: ${input.skill}`, {
+                    args: input.args || 'none',
+                    sessionId: context.sessionId,
+                });
+            }
+            const skill = discovery.get(input.skill);
+            if (!skill) {
+                if (isVerboseDebugEnabled('skills')) {
+                    logger.debug('Skill', `Skill not found: ${input.skill}`, {
+                        availableSkills: discovery.getAll().map((s) => s.name).join(', ') || 'none',
+                    });
+                }
+                return {
+                    success: false,
+                    output: '',
+                    error: `Skill not found: ${input.skill}\n\nAvailable skills: ${discovery.getAll().map((s) => s.name).join(', ') || 'none'}`,
+                };
+            }
+            // Verbose debug: Log skill found
+            if (isVerboseDebugEnabled('skills')) {
+                logger.debug('Skill', `Found skill definition`, {
+                    name: skill.name,
+                    hasContent: !!skill.content,
+                    contentLength: skill.content.length,
+                    source: `${skill.source.level}/${skill.source.namespace}`,
+                });
+            }
+            // Format skill content as tool_result
+            const output = formatSkillActivation(skill, input.args);
+            // Verbose debug: Log activation complete
+            if (isVerboseDebugEnabled('skills')) {
+                logger.debug('Skill', `Skill activation complete`, {
+                    skillName: skill.name,
+                    outputLength: output.length,
+                });
+            }
+            return {
+                success: true,
+                output,
+                metadata: {
+                    title: `Skill: ${skill.name}`,
+                    subtitle: skill.description,
+                },
+            };
+        },
+    };
+}
+/**
+ * Build tool description with list of available skills
+ */
+function buildSkillDescription(skills) {
+    const lines = [];
+    lines.push('Execute a skill to gain specialized domain knowledge.');
+    lines.push('');
+    lines.push('Skills inject expertise into your context for specific tasks.');
+    lines.push('Invoke a skill when the task matches its description.');
+    lines.push('');
+    lines.push('**Available Skills:**');
+    lines.push('');
+    if (skills.length === 0) {
+        lines.push('(No skills available. Create skills in ~/.gen/skills/)');
+    }
+    else {
+        for (const skill of skills) {
+            lines.push(`• **${skill.name}** - ${skill.description}`);
+        }
+    }
+    lines.push('');
+    lines.push('**Usage:** Skill({ skill: "skill-name", args: "optional-args" })');
+    lines.push('');
+    lines.push('**Skills are loaded from:**');
+    lines.push('- ~/.gen/skills/ (user, highest priority)');
+    lines.push('- ~/.claude/skills/ (user, fallback)');
+    lines.push('- .gen/skills/ (project)');
+    lines.push('- .claude/skills/ (project)');
+    return lines.join('\n');
+}
+/**
+ * Format skill activation output
+ *
+ * Returns formatted markdown with skill content for injection into context
+ */
+function formatSkillActivation(skill, args) {
+    const lines = [];
+    // Build fields for boxed message
+    const fields = {
+        'Name': skill.name,
+        'Description': skill.description,
+        'Source': `${skill.source.level}/${skill.source.namespace}`,
+    };
+    if (args) {
+        fields['Arguments'] = args;
+    }
+    // Use shared formatter for boxed message
+    lines.push(formatBoxedMessage('Skill Activated', fields));
+    lines.push('');
+    lines.push(skill.content);
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+    lines.push('Follow the instructions above to complete the task.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=skill-tool-factory.js.map

package/dist/core/tools/factories/skill-tool-factory.js.map

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

package/dist/core/tools/factories/task-tool-factory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Task Tool - Launch specialized subagents for isolated task execution
+ *
+ * Based on Claude Code's Task tool architecture.
+ * Enables context-isolated exploration and specialized task delegation.
+ */
+import type { Tool } from '../types.js';
+import type { TaskInput } from '../../../ext/subagents/types.js';
+/**
+ * Task Tool - Spawn isolated subagents for specialized tasks
+ */
+export declare const taskTool: Tool<TaskInput>;
+//# sourceMappingURL=task-tool-factory.d.ts.map

package/dist/core/tools/factories/task-tool-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-tool-factory.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/factories/task-tool-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAIjE;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,CA2QpC,CAAC"}