@thejeetsingh/kalcode 2.0.0 → 2.2.0

package/dist/src/tools/glob-tool.js

@@ -0,0 +1,52 @@
+import { resolve } from "path";
+import { glob } from "glob";
+import { MAX_GLOB_RESULTS } from "../constants.js";
+export const globTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "glob",
+            description: "Find files matching a glob pattern. Returns matching file paths sorted by modification time.",
+            parameters: {
+                type: "object",
+                properties: {
+                    pattern: {
+                        type: "string",
+                        description: "Glob pattern (e.g., '**/*.ts', 'src/**/*.json')",
+                    },
+                    path: {
+                        type: "string",
+                        description: "Base directory to search from. Default: current directory",
+                    },
+                },
+                required: ["pattern"],
+            },
+        },
+    },
+    async execute(args) {
+        const pattern = String(args.pattern);
+        const basePath = resolve(String(args.path || "."));
+        try {
+            const matches = await glob(pattern, {
+                cwd: basePath,
+                dot: false,
+                ignore: ["node_modules/**", ".git/**"],
+                maxDepth: 20,
+            });
+            if (matches.length === 0) {
+                return `No files matching pattern: ${pattern} in ${basePath}`;
+            }
+            const limited = matches.sort().slice(0, MAX_GLOB_RESULTS);
+            let result = `Found ${limited.length} file(s) matching "${pattern}":\n`;
+            result += limited.join("\n");
+            if (matches.length > MAX_GLOB_RESULTS) {
+                result += `\n... (results limited to ${MAX_GLOB_RESULTS})`;
+            }
+            return result;
+        }
+        catch (err) {
+            return `Error searching for files: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    },
+};
+//# sourceMappingURL=glob-tool.js.map

package/dist/src/tools/glob-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-tool.js","sourceRoot":"","sources":["../../../src/tools/glob-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,UAAU,EAAE;QACV,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,8FAA8F;YAChG,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iDAAiD;qBAC/D;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,2DAA2D;qBACzE;iBACF;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;aACtB;SACF;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;QAEnD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE;gBAClC,GAAG,EAAE,QAAQ;gBACb,GAAG,EAAE,KAAK;gBACV,MAAM,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC;gBACtC,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,8BAA8B,OAAO,OAAO,QAAQ,EAAE,CAAC;YAChE,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;YAC1D,IAAI,MAAM,GAAG,SAAS,OAAO,CAAC,MAAM,sBAAsB,OAAO,MAAM,CAAC;YACxE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,OAAO,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;gBACtC,MAAM,IAAI,6BAA6B,gBAAgB,GAAG,CAAC;YAC7D,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1F,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/src/tools/grep.d.ts

@@ -0,0 +1,2 @@
+import type { ToolHandler } from "../types.js";
+export declare const grepTool: ToolHandler;

package/dist/src/tools/grep.js

@@ -0,0 +1,93 @@
+import { spawn } from "child_process";
+import { MAX_GREP_RESULTS } from "../constants.js";
+export const grepTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "grep",
+            description: "Search file contents for a pattern. Uses ripgrep if available, otherwise falls back to grep. Returns matching lines with file paths and line numbers.",
+            parameters: {
+                type: "object",
+                properties: {
+                    pattern: {
+                        type: "string",
+                        description: "Search pattern (regex supported)",
+                    },
+                    path: {
+                        type: "string",
+                        description: "Directory or file to search in. Default: current directory",
+                    },
+                    include: {
+                        type: "string",
+                        description: "File glob pattern to include (e.g., '*.ts')",
+                    },
+                    maxResults: {
+                        type: "number",
+                        description: `Maximum number of results. Default: ${MAX_GREP_RESULTS}`,
+                    },
+                },
+                required: ["pattern"],
+            },
+        },
+    },
+    async execute(args) {
+        const pattern = String(args.pattern);
+        const searchPath = String(args.path || ".");
+        const include = args.include ? String(args.include) : null;
+        const maxResults = Number(args.maxResults) || MAX_GREP_RESULTS;
+        const hasRg = await checkCommand("rg");
+        let cmd;
+        if (hasRg) {
+            cmd = `rg --line-number --max-count ${maxResults} --no-heading --glob '!node_modules' --glob '!.git'`;
+            if (include)
+                cmd += ` --glob '${include}'`;
+            cmd += ` -- ${escapeShellArg(pattern)} ${escapeShellArg(searchPath)}`;
+        }
+        else {
+            cmd = `grep -rn --max-count=${maxResults} --exclude-dir=node_modules --exclude-dir=.git`;
+            if (include)
+                cmd += ` --include='${include}'`;
+            cmd += ` -- ${escapeShellArg(pattern)} ${escapeShellArg(searchPath)}`;
+        }
+        try {
+            const { stdout } = await runShell(cmd);
+            if (!stdout.trim()) {
+                return `No matches found for pattern: ${pattern}`;
+            }
+            const lines = stdout.trim().split("\n");
+            const limited = lines.slice(0, maxResults);
+            let result = limited.join("\n");
+            if (lines.length > maxResults) {
+                result += `\n... (${lines.length - maxResults} more matches)`;
+            }
+            return result;
+        }
+        catch (err) {
+            return `Error searching: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    },
+};
+function runShell(cmd) {
+    return new Promise((resolve) => {
+        const proc = spawn("sh", ["-c", cmd], { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        proc.stdout.on("data", (d) => { stdout += d.toString(); });
+        proc.stderr.on("data", (d) => { stderr += d.toString(); });
+        proc.on("close", (code) => resolve({ stdout, stderr, exitCode: code ?? 1 }));
+        proc.on("error", (err) => resolve({ stdout: "", stderr: err.message, exitCode: 1 }));
+    });
+}
+async function checkCommand(cmd) {
+    try {
+        const { exitCode } = await runShell(`which ${cmd}`);
+        return exitCode === 0;
+    }
+    catch {
+        return false;
+    }
+}
+function escapeShellArg(arg) {
+    return `'${arg.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=grep.js.map

package/dist/src/tools/grep.js.map

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

package/dist/src/tools/list-directory.d.ts

@@ -0,0 +1,2 @@
+import type { ToolHandler } from "../types.js";
+export declare const listDirectoryTool: ToolHandler;

package/dist/src/tools/list-directory.js

@@ -0,0 +1,90 @@
+import { readdirSync, statSync, existsSync } from "fs";
+import { resolve, join } from "path";
+import { MAX_DIR_ENTRIES, MAX_DIR_DEPTH } from "../constants.js";
+export const listDirectoryTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "listDirectory",
+            description: "List the contents of a directory. Shows file names, types, and sizes.",
+            parameters: {
+                type: "object",
+                properties: {
+                    dirPath: {
+                        type: "string",
+                        description: "Path to the directory to list. Default: current directory",
+                    },
+                    recursive: {
+                        type: "boolean",
+                        description: "List recursively (max depth 3). Default: false",
+                    },
+                },
+            },
+        },
+    },
+    async execute(args) {
+        const dirPath = resolve(String(args.dirPath || "."));
+        const recursive = Boolean(args.recursive);
+        if (!existsSync(dirPath)) {
+            return `Error: Directory not found: ${dirPath}`;
+        }
+        try {
+            const entries = [];
+            listDir(dirPath, "", recursive ? MAX_DIR_DEPTH : 0, entries);
+            if (entries.length === 0) {
+                return `Directory is empty: ${dirPath}`;
+            }
+            let result = `Contents of ${dirPath} (${entries.length} entries):\n`;
+            result += entries.join("\n");
+            if (entries.length >= MAX_DIR_ENTRIES) {
+                result += `\n... (limited to ${MAX_DIR_ENTRIES} entries)`;
+            }
+            return result;
+        }
+        catch (err) {
+            return `Error listing directory: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    },
+};
+function listDir(basePath, prefix, depth, entries) {
+    if (entries.length >= MAX_DIR_ENTRIES)
+        return;
+    let items;
+    try {
+        items = readdirSync(join(basePath, prefix));
+    }
+    catch {
+        return;
+    }
+    items.sort();
+    for (const item of items) {
+        if (entries.length >= MAX_DIR_ENTRIES)
+            return;
+        const relPath = prefix ? `${prefix}/${item}` : item;
+        const fullPath = join(basePath, relPath);
+        try {
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                entries.push(`${relPath}/`);
+                if (depth > 0) {
+                    listDir(basePath, relPath, depth - 1, entries);
+                }
+            }
+            else {
+                const size = formatSize(stat.size);
+                entries.push(`${relPath} (${size})`);
+            }
+        }
+        catch {
+            entries.push(`${relPath} (unreadable)`);
+        }
+    }
+}
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)}MB`;
+}
+//# sourceMappingURL=list-directory.js.map

package/dist/src/tools/list-directory.js.map

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

package/dist/src/tools/read-file.d.ts

@@ -0,0 +1,2 @@
+import type { ToolHandler } from "../types.js";
+export declare const readFileTool: ToolHandler;

package/dist/src/tools/read-file.js

@@ -0,0 +1,64 @@
+import { readFileSync, statSync, existsSync } from "fs";
+import { resolve } from "path";
+import { MAX_FILE_SIZE, DEFAULT_LINE_LIMIT } from "../constants.js";
+export const readFileTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "readFile",
+            description: "Read the contents of a file with line numbers. Returns line-numbered output. Use offset and limit to read specific portions of large files.",
+            parameters: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Path to the file to read (absolute or relative to cwd)",
+                    },
+                    offset: {
+                        type: "number",
+                        description: "Line number to start reading from (1-based). Default: 1",
+                    },
+                    limit: {
+                        type: "number",
+                        description: `Maximum number of lines to read. Default: ${DEFAULT_LINE_LIMIT}`,
+                    },
+                },
+                required: ["filePath"],
+            },
+        },
+    },
+    async execute(args) {
+        const filePath = resolve(String(args.filePath));
+        const offset = Math.max(1, Number(args.offset) || 1);
+        const limit = Number(args.limit) || DEFAULT_LINE_LIMIT;
+        if (!existsSync(filePath)) {
+            return `Error: File not found: ${filePath}`;
+        }
+        try {
+            const stat = statSync(filePath);
+            if (stat.isDirectory()) {
+                return `Error: Path is a directory, not a file: ${filePath}`;
+            }
+            if (stat.size > MAX_FILE_SIZE) {
+                return `Error: File too large (${(stat.size / 1024 / 1024).toFixed(1)}MB). Use offset/limit to read portions.`;
+            }
+            const content = readFileSync(filePath, "utf-8");
+            const lines = content.split("\n");
+            const startIdx = offset - 1;
+            const endIdx = Math.min(startIdx + limit, lines.length);
+            const slice = lines.slice(startIdx, endIdx);
+            const numbered = slice
+                .map((line, i) => {
+                const lineNum = String(startIdx + i + 1).padStart(4, " ");
+                return `${lineNum} | ${line}`;
+            })
+                .join("\n");
+            const header = `File: ${filePath} (${lines.length} lines total, showing ${offset}-${endIdx})`;
+            return `${header}\n${numbered}`;
+        }
+        catch (err) {
+            return `Error reading file: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    },
+};
+//# sourceMappingURL=read-file.js.map

package/dist/src/tools/read-file.js.map

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

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

@@ -0,0 +1,4 @@
+import type { ToolDefinition, ToolHandler } from "../types.js";
+export declare function getToolHandler(name: string): ToolHandler | undefined;
+export declare function getAllDefinitions(): ToolDefinition[];
+export declare function executeToolCall(name: string, args: Record<string, unknown>): Promise<string>;

package/dist/src/tools/registry.js

@@ -0,0 +1,32 @@
+import { readFileTool } from "./read-file.js";
+import { writeFileTool } from "./write-file.js";
+import { editFileTool } from "./edit-file.js";
+import { runCommandTool } from "./run-command.js";
+import { grepTool } from "./grep.js";
+import { globTool } from "./glob-tool.js";
+import { listDirectoryTool } from "./list-directory.js";
+const tools = new Map();
+function register(handler) {
+    tools.set(handler.definition.function.name, handler);
+}
+register(readFileTool);
+register(writeFileTool);
+register(editFileTool);
+register(runCommandTool);
+register(grepTool);
+register(globTool);
+register(listDirectoryTool);
+export function getToolHandler(name) {
+    return tools.get(name);
+}
+export function getAllDefinitions() {
+    return Array.from(tools.values()).map((t) => t.definition);
+}
+export function executeToolCall(name, args) {
+    const handler = tools.get(name);
+    if (!handler) {
+        return Promise.resolve(`Error: Unknown tool "${name}"`);
+    }
+    return handler.execute(args);
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tools/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,KAAK,GAA6B,IAAI,GAAG,EAAE,CAAC;AAElD,SAAS,QAAQ,CAAC,OAAoB;IACpC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,QAAQ,CAAC,YAAY,CAAC,CAAC;AACvB,QAAQ,CAAC,aAAa,CAAC,CAAC;AACxB,QAAQ,CAAC,YAAY,CAAC,CAAC;AACvB,QAAQ,CAAC,cAAc,CAAC,CAAC;AACzB,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACnB,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACnB,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAE5B,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,IAA6B;IAE7B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,OAAO,CAAC,wBAAwB,IAAI,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/tools/run-command.d.ts

@@ -0,0 +1,2 @@
+import type { ToolHandler } from "../types.js";
+export declare const runCommandTool: ToolHandler;

package/dist/src/tools/run-command.js

@@ -0,0 +1,98 @@
+import { resolve } from "path";
+import { spawn } from "child_process";
+import { DEFAULT_COMMAND_TIMEOUT, MAX_COMMAND_TIMEOUT, MAX_OUTPUT_BYTES } from "../constants.js";
+export const runCommandTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "runCommand",
+            description: "Execute a shell command and return its output. Default timeout is 30s and hard-capped at 45s. Output is truncated at 50KB.",
+            parameters: {
+                type: "object",
+                properties: {
+                    command: {
+                        type: "string",
+                        description: "The shell command to execute",
+                    },
+                    cwd: {
+                        type: "string",
+                        description: "Working directory for the command. Default: current directory",
+                    },
+                    timeout: {
+                        type: "number",
+                        description: "Timeout in milliseconds. Default: 30000, max: 45000",
+                    },
+                },
+                required: ["command"],
+            },
+        },
+    },
+    async execute(args) {
+        const command = String(args.command);
+        const cwd = args.cwd ? resolve(String(args.cwd)) : process.cwd();
+        const requestedTimeout = Number(args.timeout) || DEFAULT_COMMAND_TIMEOUT;
+        const timeout = Math.min(Math.max(1_000, requestedTimeout), MAX_COMMAND_TIMEOUT);
+        try {
+            const { exitCode, stdout, stderr } = await runShell(command, cwd, timeout);
+            if (exitCode === 124) {
+                return [
+                    `Exit code: 124`,
+                    `STDERR:`,
+                    `Command timed out after ${Math.round(timeout / 1000)}s.`,
+                    `Tip: use a shorter command, reduce scope, or run background/dev servers manually outside kalcode.`,
+                ].join("\n\n");
+            }
+            let stdoutTrimmed = stdout;
+            let stderrTrimmed = stderr;
+            if (stdoutTrimmed.length > MAX_OUTPUT_BYTES) {
+                stdoutTrimmed = stdoutTrimmed.slice(0, MAX_OUTPUT_BYTES) + "\n... (output truncated)";
+            }
+            if (stderrTrimmed.length > MAX_OUTPUT_BYTES) {
+                stderrTrimmed = stderrTrimmed.slice(0, MAX_OUTPUT_BYTES) + "\n... (output truncated)";
+            }
+            let result = `Exit code: ${exitCode}`;
+            if (stdoutTrimmed.trim())
+                result += `\n\nSTDOUT:\n${stdoutTrimmed.trim()}`;
+            if (stderrTrimmed.trim())
+                result += `\n\nSTDERR:\n${stderrTrimmed.trim()}`;
+            return result;
+        }
+        catch (err) {
+            return `Error running command: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    },
+};
+function runShell(command, cwd, timeout) {
+    return new Promise((resolve) => {
+        const proc = spawn("sh", ["-c", command], {
+            cwd,
+            env: { ...process.env },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            try {
+                proc.kill("SIGKILL");
+            }
+            catch { /* already exited */ }
+        }, timeout);
+        proc.stdout.on("data", (d) => { stdout += d.toString(); });
+        proc.stderr.on("data", (d) => { stderr += d.toString(); });
+        proc.on("close", (code) => {
+            clearTimeout(timer);
+            resolve({
+                exitCode: timedOut ? 124 : (code ?? 1),
+                stdout,
+                stderr,
+            });
+        });
+        proc.on("error", (err) => {
+            clearTimeout(timer);
+            resolve({ exitCode: 1, stdout: "", stderr: err.message });
+        });
+    });
+}
+//# sourceMappingURL=run-command.js.map

package/dist/src/tools/run-command.js.map

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

package/dist/src/tools/write-file.d.ts

@@ -0,0 +1,2 @@
+import type { ToolHandler } from "../types.js";
+export declare const writeFileTool: ToolHandler;

package/dist/src/tools/write-file.js

@@ -0,0 +1,39 @@
+import { writeFileSync, mkdirSync } from "fs";
+import { resolve, dirname } from "path";
+export const writeFileTool = {
+    definition: {
+        type: "function",
+        function: {
+            name: "writeFile",
+            description: "Write content to a file. Creates the file if it doesn't exist. Automatically creates parent directories as needed.",
+            parameters: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Path to the file to write (absolute or relative to cwd)",
+                    },
+                    content: {
+                        type: "string",
+                        description: "Content to write to the file",
+                    },
+                },
+                required: ["filePath", "content"],
+            },
+        },
+    },
+    async execute(args) {
+        const filePath = resolve(String(args.filePath));
+        const content = String(args.content);
+        try {
+            mkdirSync(dirname(filePath), { recursive: true });
+            writeFileSync(filePath, content);
+            const lineCount = content.split("\n").length;
+            return `Successfully wrote ${lineCount} lines to ${filePath}`;
+        }
+        catch (err) {
+            return `Error writing file: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    },
+};
+//# sourceMappingURL=write-file.js.map

package/dist/src/tools/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../../src/tools/write-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGxC,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,UAAU,EAAE;QACV,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,oHAAoH;YACtH,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,yDAAyD;qBACvE;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,8BAA8B;qBAC5C;iBACF;gBACD,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;aAClC;SACF;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAErC,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YAC7C,OAAO,sBAAsB,SAAS,aAAa,QAAQ,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACnF,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,61 @@
+export interface Config {
+    apiKey: string;
+    model: string;
+}
+export interface Message {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string | null;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    name?: string;
+}
+export interface ToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ToolDefinition {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: "object";
+            properties: Record<string, unknown>;
+            required?: string[];
+        };
+    };
+}
+export interface StreamDelta {
+    type: "content" | "tool_call" | "done" | "error";
+    content?: string;
+    toolCall?: {
+        index: number;
+        id?: string;
+        function?: {
+            name?: string;
+            arguments?: string;
+        };
+    };
+    error?: string;
+    usage?: TokenUsage;
+}
+export interface ToolHandler {
+    definition: ToolDefinition;
+    execute: (args: Record<string, unknown>) => Promise<string>;
+}
+export interface ToolCallAccumulator {
+    id: string;
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface TokenUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/src/ui/input.d.ts

@@ -0,0 +1,5 @@
+export interface InputController {
+    prompt: () => Promise<string>;
+    close: () => void;
+}
+export declare function createInput(slashCommands?: string[]): InputController;