gencode-ai 0.1.0

package/dist/tools/builtin/read.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Read Tool - Read file contents
+ */
+import type { Tool } from '../types.js';
+import { type ReadInput } from '../types.js';
+export declare const readTool: Tool<ReadInput>;
+//# sourceMappingURL=read.d.ts.map

package/dist/tools/builtin/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,aAAa,CAAC;AACpD,OAAO,EAAmB,KAAK,SAAS,EAAgC,MAAM,aAAa,CAAC;AAE5F,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,CAyBpC,CAAC"}

package/dist/tools/builtin/read.js

@@ -0,0 +1,29 @@
+/**
+ * Read Tool - Read file contents
+ */
+import * as fs from 'fs/promises';
+import { ReadInputSchema, resolvePath, getErrorMessage } from '../types.js';
+export const readTool = {
+    name: 'Read',
+    description: 'Read the contents of a file. Returns the file content with line numbers.',
+    parameters: ReadInputSchema,
+    async execute(input, context) {
+        try {
+            const filePath = resolvePath(input.file_path, context.cwd);
+            const content = await fs.readFile(filePath, 'utf-8');
+            const lines = content.split('\n');
+            const offset = input.offset ?? 1;
+            const limit = input.limit ?? lines.length;
+            const selectedLines = lines.slice(offset - 1, offset - 1 + limit);
+            const numberedLines = selectedLines.map((line, i) => {
+                const lineNum = (offset + i).toString().padStart(5, ' ');
+                return `${lineNum}│${line}`;
+            });
+            return { success: true, output: numberedLines.join('\n') };
+        }
+        catch (error) {
+            return { success: false, output: '', error: `Failed to read file: ${getErrorMessage(error)}` };
+        }
+    },
+};
+//# sourceMappingURL=read.js.map

package/dist/tools/builtin/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/tools/builtin/read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAElC,OAAO,EAAE,eAAe,EAAkB,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE5F,MAAM,CAAC,MAAM,QAAQ,GAAoB;IACvC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,0EAA0E;IACvF,UAAU,EAAE,eAAe;IAE3B,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;YAC3D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAElC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;YAE1C,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;YAClE,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;gBAClD,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACzD,OAAO,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,wBAAwB,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACjG,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Write Tool - Write content to a 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/tools/builtin/write.d.ts.map

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

package/dist/tools/builtin/write.js

@@ -0,0 +1,24 @@
+/**
+ * Write Tool - Write content to a file
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { WriteInputSchema, resolvePath, getErrorMessage } from '../types.js';
+export const writeTool = {
+    name: 'Write',
+    description: 'Write content to a file. Creates the file if it does not exist, overwrites if it does.',
+    parameters: WriteInputSchema,
+    async execute(input, context) {
+        try {
+            const filePath = resolvePath(input.file_path, context.cwd);
+            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/tools/builtin/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/tools/builtin/write.ts"],"names":[],"mappings":"AAAA;;GAEG;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;AAE9F,MAAM,CAAC,MAAM,SAAS,GAAqB;IACzC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,wFAAwF;IACrG,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;YAC3D,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/tools/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Tools System - Built-in tools and registry
+ */
+export * from './types.js';
+export { ToolRegistry } from './registry.js';
+export { readTool } from './builtin/read.js';
+export { writeTool } from './builtin/write.js';
+export { editTool } from './builtin/edit.js';
+export { bashTool } from './builtin/bash.js';
+export { globTool } from './builtin/glob.js';
+export { grepTool } from './builtin/grep.js';
+import { ToolRegistry } from './registry.js';
+/**
+ * Create a registry with all built-in tools
+ */
+export declare function createDefaultRegistry(): ToolRegistry;
+/**
+ * All built-in tools
+ */
+export declare const builtinTools: (import("./types.js").Tool<{
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}> | import("./types.js").Tool<{
+    file_path: string;
+    content: string;
+}> | import("./types.js").Tool<{
+    file_path: string;
+    old_string: string;
+    new_string: string;
+}> | import("./types.js").Tool<{
+    command: string;
+    timeout?: number | undefined;
+}> | import("./types.js").Tool<{
+    pattern: string;
+    path?: string | undefined;
+}>)[];
+//# 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":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAQ7C;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,YAAY,CAIpD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;KAAgE,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,32 @@
+/**
+ * Tools System - Built-in tools and registry
+ */
+export * from './types.js';
+export { ToolRegistry } from './registry.js';
+// Built-in tools
+export { readTool } from './builtin/read.js';
+export { writeTool } from './builtin/write.js';
+export { editTool } from './builtin/edit.js';
+export { bashTool } from './builtin/bash.js';
+export { globTool } from './builtin/glob.js';
+export { grepTool } from './builtin/grep.js';
+import { ToolRegistry } from './registry.js';
+import { readTool } from './builtin/read.js';
+import { writeTool } from './builtin/write.js';
+import { editTool } from './builtin/edit.js';
+import { bashTool } from './builtin/bash.js';
+import { globTool } from './builtin/glob.js';
+import { grepTool } from './builtin/grep.js';
+/**
+ * Create a registry with all built-in tools
+ */
+export function createDefaultRegistry() {
+    const registry = new ToolRegistry();
+    registry.registerAll([readTool, writeTool, editTool, bashTool, globTool, grepTool]);
+    return registry;
+}
+/**
+ * All built-in tools
+ */
+export const builtinTools = [readTool, writeTool, editTool, bashTool, globTool, grepTool];
+//# 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;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tool Registry - Manages available tools
+ */
+import type { Tool, ToolContext, ToolResult } from './types.js';
+import type { ToolDefinition } from '../providers/types.js';
+export declare class ToolRegistry {
+    private tools;
+    register(tool: Tool): void;
+    registerAll(tools: Tool[]): void;
+    get(name: string): Tool | undefined;
+    has(name: string): boolean;
+    list(): string[];
+    /**
+     * Get tool definitions for LLM
+     */
+    getDefinitions(toolNames?: string[]): ToolDefinition[];
+    /**
+     * Execute a tool by name
+     */
+    execute(name: string, input: unknown, context: ToolContext): Promise<ToolResult>;
+}
+//# 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;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAE7C,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAMhC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE;IAgBtD;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA2BvF"}

package/dist/tools/registry.js

@@ -0,0 +1,71 @@
+/**
+ * Tool Registry - Manages available tools
+ */
+import { zodToJsonSchema, getErrorMessage } from './types.js';
+export class ToolRegistry {
+    tools = new Map();
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    registerAll(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    has(name) {
+        return this.tools.has(name);
+    }
+    list() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Get tool definitions for LLM
+     */
+    getDefinitions(toolNames) {
+        const names = toolNames ?? this.list();
+        return names
+            .map((name) => {
+            const tool = this.tools.get(name);
+            if (!tool)
+                return null;
+            return {
+                name: tool.name,
+                description: tool.description,
+                parameters: zodToJsonSchema(tool.parameters),
+            };
+        })
+            .filter((t) => t !== null);
+    }
+    /**
+     * Execute a tool by name
+     */
+    async execute(name, input, context) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return {
+                success: false,
+                output: '',
+                error: `Unknown tool: ${name}`,
+            };
+        }
+        try {
+            // Validate input
+            const parsed = tool.parameters.safeParse(input);
+            if (!parsed.success) {
+                return {
+                    success: false,
+                    output: '',
+                    error: `Invalid input: ${parsed.error.message}`,
+                };
+            }
+            return await tool.execute(parsed.data, context);
+        }
+        catch (error) {
+            return { success: false, output: '', error: `Tool execution failed: ${getErrorMessage(error)}` };
+        }
+    }
+}
+//# 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":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG9D,MAAM,OAAO,YAAY;IACf,KAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;IAE7C,QAAQ,CAAC,IAAU;QACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,SAAoB;QACjC,MAAM,KAAK,GAAG,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACvC,OAAO,KAAK;aACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YAEvB,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC;aAC7C,CAAC;QACJ,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAuB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,KAAc,EAAE,OAAoB;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAElC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,iBAAiB,IAAI,EAAE;aAC/B,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,iBAAiB;YACjB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,kBAAkB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;iBAChD,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,0BAA0B,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACnG,CAAC;IACH,CAAC;CACF"}

package/dist/tools/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Tool System Type Definitions
+ */
+import { z } from 'zod';
+export interface ToolContext {
+    cwd: string;
+    abortSignal?: AbortSignal;
+}
+export interface ToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+}
+export interface Tool<TInput = unknown> {
+    name: string;
+    description: string;
+    parameters: z.ZodSchema<TInput>;
+    execute(input: TInput, context: ToolContext): Promise<ToolResult>;
+}
+/**
+ * Resolve a file path relative to the context's working directory
+ */
+export declare function resolvePath(filePath: string, cwd: string): string;
+/**
+ * Extract error message from unknown error
+ */
+export declare function getErrorMessage(error: unknown): string;
+export declare const ReadInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ReadInput = z.infer<typeof ReadInputSchema>;
+export declare const WriteInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+export type WriteInput = z.infer<typeof WriteInputSchema>;
+export declare const EditInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    old_string: z.ZodString;
+    new_string: z.ZodString;
+}, z.core.$strip>;
+export type EditInput = z.infer<typeof EditInputSchema>;
+export declare const BashInputSchema: z.ZodObject<{
+    command: z.ZodString;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type BashInput = z.infer<typeof BashInputSchema>;
+export declare const GlobInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GlobInput = z.infer<typeof GlobInputSchema>;
+export declare const GrepInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    include: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GrepInput = z.infer<typeof GrepInputSchema>;
+export declare function zodToJsonSchema(schema: z.ZodSchema<any>): Record<string, unknown>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI,CAAC,MAAM,GAAG,OAAO;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACnE;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAMD,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAOxD,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwCjF"}

package/dist/tools/types.js

@@ -0,0 +1,126 @@
+/**
+ * Tool System Type Definitions
+ */
+import * as path from 'path';
+import { z } from 'zod';
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Resolve a file path relative to the context's working directory
+ */
+export function resolvePath(filePath, cwd) {
+    return path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath);
+}
+/**
+ * Extract error message from unknown error
+ */
+export function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+// ============================================================================
+// Built-in Tool Input Types
+// ============================================================================
+export const ReadInputSchema = z.object({
+    file_path: z.string().describe('The absolute path to the file to read'),
+    offset: z.number().optional().describe('Line number to start reading from (1-based)'),
+    limit: z.number().optional().describe('Number of lines to read'),
+});
+export const WriteInputSchema = z.object({
+    file_path: z.string().describe('The absolute path to the file to write'),
+    content: z.string().describe('The content to write to the file'),
+});
+export const EditInputSchema = z.object({
+    file_path: z.string().describe('The absolute path to the file to modify'),
+    old_string: z.string().describe('The text to replace'),
+    new_string: z.string().describe('The replacement text'),
+});
+export const BashInputSchema = z.object({
+    command: z.string().describe('The bash command to execute'),
+    timeout: z.number().optional().describe('Timeout in milliseconds (default: 30000)'),
+});
+export const GlobInputSchema = z.object({
+    pattern: z.string().describe('The glob pattern to match files'),
+    path: z.string().optional().describe('The directory to search in'),
+});
+export const GrepInputSchema = z.object({
+    pattern: z.string().describe('The regex pattern to search for'),
+    path: z.string().optional().describe('The file or directory to search in'),
+    include: z.string().optional().describe('File pattern to include (e.g., "*.ts")'),
+});
+// ============================================================================
+// JSON Schema Conversion
+// ============================================================================
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function zodToJsonSchema(schema) {
+    // Use Zod's built-in JSON schema support or manual conversion
+    try {
+        // Zod v4 approach - check if toJsonSchema exists
+        if ('toJsonSchema' in z && typeof z.toJsonSchema === 'function') {
+            return z.toJsonSchema(schema);
+        }
+    }
+    catch {
+        // Fall through to manual conversion
+    }
+    // Manual conversion for object schemas
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const def = schema._zod ?? schema._def;
+    if (def?.typeName === 'ZodObject' || def?.def?.typeName === 'object') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const shape = schema.shape ?? schema._zod?.def?.shape;
+        if (shape) {
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(shape)) {
+                properties[key] = zodFieldToJsonSchema(value);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const valDef = value._zod ?? value._def;
+                const isOptional = valDef?.typeName === 'ZodOptional' || valDef?.def?.typeName === 'optional';
+                if (!isOptional) {
+                    required.push(key);
+                }
+            }
+            return {
+                type: 'object',
+                properties,
+                required: required.length > 0 ? required : undefined,
+            };
+        }
+    }
+    return { type: 'object' };
+}
+function zodFieldToJsonSchema(field) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const f = field;
+    const def = f._zod ?? f._def;
+    const description = def?.def?.description ?? def?.description;
+    // Get the inner type for optionals
+    let typeName = def?.typeName ?? def?.def?.typeName ?? 'string';
+    // Unwrap optional
+    if (typeName === 'ZodOptional' || typeName === 'optional') {
+        const inner = def?.def?.innerType ?? def?.innerType;
+        if (inner) {
+            const innerDef = inner._zod ?? inner._def;
+            typeName = innerDef?.typeName ?? innerDef?.def?.typeName ?? 'string';
+        }
+    }
+    // Map Zod types to JSON Schema types
+    let type = 'string';
+    if (typeName === 'ZodNumber' || typeName === 'number') {
+        type = 'number';
+    }
+    else if (typeName === 'ZodBoolean' || typeName === 'boolean') {
+        type = 'boolean';
+    }
+    else if (typeName === 'ZodArray' || typeName === 'array') {
+        const items = def?.def?.element ?? def?.element;
+        return {
+            type: 'array',
+            items: items ? zodFieldToJsonSchema(items) : { type: 'string' },
+            description,
+        };
+    }
+    return { type, description };
+}
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

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

package/docs/README.md

@@ -0,0 +1,16 @@
+# mycode Documentation
+
+This directory contains documentation for the mycode project.
+
+## Contents
+
+- [**proposals/**](./proposals/) - Enhancement proposals for new features
+
+## About mycode
+
+mycode is an open-source, provider-agnostic alternative to Claude Code. It brings Claude Code's excellent interactive CLI experience while allowing flexible switching between different LLM providers (OpenAI, Anthropic, Google Gemini).
+
+## Quick Links
+
+- [Enhancement Proposals](./proposals/README.md)
+- [Main README](../README.md)