@agntk/core 0.1.0

package/dist/tools/deep-reasoning/types.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+export interface ThoughtData {
+    thought: string;
+    thoughtNumber: number;
+    totalThoughts: number;
+    isRevision?: boolean;
+    revisesThought?: number;
+    branchFromThought?: number;
+    branchId?: string;
+    needsMoreThoughts?: boolean;
+    nextThoughtNeeded: boolean;
+}
+export interface ReasoningResult {
+    thoughtNumber: number;
+    totalThoughts: number;
+    nextThoughtNeeded: boolean;
+    branches: string[];
+    thoughtHistoryLength: number;
+}
+export interface DeepReasoningConfig {
+    /**
+     * When true, enables deep reasoning with no step restrictions
+     */
+    enabled: boolean;
+    /**
+     * Maximum thoughts to keep in history (older ones are discarded)
+     */
+    maxHistorySize?: number;
+    /**
+     * Maximum thoughts per branch
+     */
+    maxBranchSize?: number;
+}
+export declare const deepReasoningInputSchema: z.ZodObject<{
+    thought: z.ZodString;
+    nextThoughtNeeded: z.ZodBoolean;
+    thoughtNumber: z.ZodNumber;
+    totalThoughts: z.ZodNumber;
+    isRevision: z.ZodOptional<z.ZodBoolean>;
+    revisesThought: z.ZodOptional<z.ZodNumber>;
+    branchFromThought: z.ZodOptional<z.ZodNumber>;
+    branchId: z.ZodOptional<z.ZodString>;
+    needsMoreThoughts: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    thought: string;
+    nextThoughtNeeded: boolean;
+    thoughtNumber: number;
+    totalThoughts: number;
+    isRevision?: boolean | undefined;
+    revisesThought?: number | undefined;
+    branchFromThought?: number | undefined;
+    branchId?: string | undefined;
+    needsMoreThoughts?: boolean | undefined;
+}, {
+    thought: string;
+    nextThoughtNeeded: boolean;
+    thoughtNumber: number;
+    totalThoughts: number;
+    isRevision?: boolean | undefined;
+    revisesThought?: number | undefined;
+    branchFromThought?: number | undefined;
+    branchId?: string | undefined;
+    needsMoreThoughts?: boolean | undefined;
+}>;
+export type DeepReasoningInput = z.infer<typeof deepReasoningInputSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/deep-reasoning/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/deep-reasoning/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/tools/deep-reasoning/types.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const deepReasoningInputSchema = z.object({
+    thought: z.string().describe('Your current reasoning step - one clear idea or observation'),
+    nextThoughtNeeded: z.boolean().describe('True if you need more reasoning steps, false when done'),
+    thoughtNumber: z.number().int().min(1).describe('Current step number (1, 2, 3...)'),
+    totalThoughts: z.number().int().min(1).describe('How many steps you expect to need'),
+    isRevision: z.boolean().optional().describe('True if reconsidering a previous thought'),
+    revisesThought: z.number().int().min(1).optional().describe('Which thought number to revise'),
+    branchFromThought: z.number().int().min(1).optional().describe('Split reasoning from this thought'),
+    branchId: z.string().optional().describe('Name for this reasoning branch'),
+    needsMoreThoughts: z.boolean().optional().describe('True if need to extend thinking'),
+});
+//# sourceMappingURL=types.js.map

package/dist/tools/deep-reasoning/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/deep-reasoning/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuCxB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IAC3F,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IACjG,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACnF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACpF,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACvF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC7F,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACnG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC1E,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CACtF,CAAC,CAAC"}

package/dist/tools/factory.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @agntk/core - Tool Factory
+ *
+ * Factory pattern for creating tool sets with dependency injection.
+ * Adapted from packages/core/src/tools/factory.ts
+ */
+import type { Tool } from 'ai';
+/**
+ * Dependencies that can be injected into tool creators.
+ */
+export interface ToolDependencies {
+    /** Workspace root directory for file operations */
+    workspaceRoot?: string;
+    /** Directories the agent is allowed to access */
+    allowedDirectories?: string[];
+    /** Optional UI stream writer for transient data */
+    streamWriter?: unknown;
+    /** Optional memory store instance */
+    memoryStore?: unknown;
+    /** Custom context data */
+    context?: Record<string, unknown>;
+}
+/**
+ * A set of tools keyed by name.
+ */
+export type ToolSet = Record<string, Tool>;
+/**
+ * Function that creates a set of tools given dependencies.
+ */
+export type ToolCreator = (deps: ToolDependencies) => ToolSet;
+/**
+ * Factory for registering and creating tools with dependency injection.
+ *
+ * @example
+ * ```typescript
+ * const factory = new ToolFactory();
+ *
+ * factory.register('search', (deps) => ({
+ *   glob: createGlobTool({ defaultCwd: deps.workspaceRoot }),
+ *   grep: createGrepTool({ defaultCwd: deps.workspaceRoot }),
+ * }));
+ *
+ * const tools = factory.createAll({ workspaceRoot: '/my/project' });
+ * ```
+ */
+export declare class ToolFactory {
+    private factories;
+    private creationErrors;
+    /**
+     * Register a tool creator function.
+     */
+    register(name: string, creator: ToolCreator): void;
+    /**
+     * Unregister a tool creator.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Check if a tool creator is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered tool creator names.
+     */
+    getRegisteredNames(): string[];
+    /**
+     * Create tools from a single registered creator.
+     */
+    create(name: string, deps: ToolDependencies): ToolSet | null;
+    /**
+     * Create all registered tools.
+     */
+    createAll(deps: ToolDependencies): ToolSet;
+    /**
+     * Create selected tools by name.
+     */
+    createSelected(names: string[], deps: ToolDependencies): ToolSet;
+    /**
+     * Get errors from the last creation operation.
+     */
+    getLastErrors(): Array<{
+        name: string;
+        error: string;
+    }>;
+    /**
+     * Clear all registered factories.
+     */
+    clear(): void;
+}
+/**
+ * Default tool factory instance for convenience.
+ */
+export declare const defaultToolFactory: ToolFactory;
+/**
+ * Merge multiple tool sets into one.
+ */
+export declare function mergeToolSets(...toolSets: ToolSet[]): ToolSet;
+/**
+ * Filter a tool set to only include specified tools.
+ */
+export declare function filterTools(tools: ToolSet, include: string[]): ToolSet;
+/**
+ * Exclude specified tools from a tool set.
+ */
+export declare function excludeTools(tools: ToolSet, exclude: string[]): ToolSet;
+/**
+ * Get tool names from a tool set.
+ */
+export declare function getToolNames(tools: ToolSet): string[];
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/tools/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAM/B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC;AAM9D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,cAAc,CAA8C;IAEpE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIlD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,GAAG,IAAI;IAgB5D;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAoB1C;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAuBhE;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAIvD;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAMD;;GAEG;AACH,eAAO,MAAM,kBAAkB,aAAoB,CAAC;AAMpD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAKtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAKvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAErD"}

package/dist/tools/factory.js

@@ -0,0 +1,166 @@
+/**
+ * @agntk/core - Tool Factory
+ *
+ * Factory pattern for creating tool sets with dependency injection.
+ * Adapted from packages/core/src/tools/factory.ts
+ */
+// ============================================================================
+// Tool Factory Class
+// ============================================================================
+/**
+ * Factory for registering and creating tools with dependency injection.
+ *
+ * @example
+ * ```typescript
+ * const factory = new ToolFactory();
+ *
+ * factory.register('search', (deps) => ({
+ *   glob: createGlobTool({ defaultCwd: deps.workspaceRoot }),
+ *   grep: createGrepTool({ defaultCwd: deps.workspaceRoot }),
+ * }));
+ *
+ * const tools = factory.createAll({ workspaceRoot: '/my/project' });
+ * ```
+ */
+export class ToolFactory {
+    factories = new Map();
+    creationErrors = [];
+    /**
+     * Register a tool creator function.
+     */
+    register(name, creator) {
+        this.factories.set(name, creator);
+    }
+    /**
+     * Unregister a tool creator.
+     */
+    unregister(name) {
+        return this.factories.delete(name);
+    }
+    /**
+     * Check if a tool creator is registered.
+     */
+    has(name) {
+        return this.factories.has(name);
+    }
+    /**
+     * Get all registered tool creator names.
+     */
+    getRegisteredNames() {
+        return Array.from(this.factories.keys());
+    }
+    /**
+     * Create tools from a single registered creator.
+     */
+    create(name, deps) {
+        const creator = this.factories.get(name);
+        if (!creator) {
+            return null;
+        }
+        try {
+            return creator(deps);
+        }
+        catch (error) {
+            this.creationErrors.push({
+                name,
+                error: String(error),
+            });
+            return null;
+        }
+    }
+    /**
+     * Create all registered tools.
+     */
+    createAll(deps) {
+        const allTools = {};
+        this.creationErrors = [];
+        for (const [name, creator] of this.factories.entries()) {
+            try {
+                const tools = creator(deps);
+                Object.assign(allTools, tools);
+            }
+            catch (error) {
+                this.creationErrors.push({
+                    name,
+                    error: String(error),
+                });
+                // Continue creating other tools even if one fails
+            }
+        }
+        return allTools;
+    }
+    /**
+     * Create selected tools by name.
+     */
+    createSelected(names, deps) {
+        const allTools = {};
+        this.creationErrors = [];
+        for (const name of names) {
+            const creator = this.factories.get(name);
+            if (!creator) {
+                continue;
+            }
+            try {
+                const tools = creator(deps);
+                Object.assign(allTools, tools);
+            }
+            catch (error) {
+                this.creationErrors.push({
+                    name,
+                    error: String(error),
+                });
+            }
+        }
+        return allTools;
+    }
+    /**
+     * Get errors from the last creation operation.
+     */
+    getLastErrors() {
+        return [...this.creationErrors];
+    }
+    /**
+     * Clear all registered factories.
+     */
+    clear() {
+        this.factories.clear();
+        this.creationErrors = [];
+    }
+}
+// ============================================================================
+// Default Factory Instance
+// ============================================================================
+/**
+ * Default tool factory instance for convenience.
+ */
+export const defaultToolFactory = new ToolFactory();
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Merge multiple tool sets into one.
+ */
+export function mergeToolSets(...toolSets) {
+    return Object.assign({}, ...toolSets);
+}
+/**
+ * Filter a tool set to only include specified tools.
+ */
+export function filterTools(tools, include) {
+    const includeSet = new Set(include);
+    return Object.fromEntries(Object.entries(tools).filter(([name]) => includeSet.has(name)));
+}
+/**
+ * Exclude specified tools from a tool set.
+ */
+export function excludeTools(tools, exclude) {
+    const excludeSet = new Set(exclude);
+    return Object.fromEntries(Object.entries(tools).filter(([name]) => !excludeSet.has(name)));
+}
+/**
+ * Get tool names from a tool set.
+ */
+export function getToolNames(tools) {
+    return Object.keys(tools);
+}
+//# sourceMappingURL=factory.js.map

package/dist/tools/factory.js.map

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

package/dist/tools/file/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @agntk/core - File Tools
+ *
+ * Structured file operations: read, write, edit, create.
+ * All operations are scoped to workspaceRoot for safety.
+ */
+export { createFileReadTool, createFileWriteTool, createFileEditTool, createFileCreateTool, createFileTools, } from './tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/file/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/file/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/tools/file/index.js

@@ -0,0 +1,8 @@
+/**
+ * @agntk/core - File Tools
+ *
+ * Structured file operations: read, write, edit, create.
+ * All operations are scoped to workspaceRoot for safety.
+ */
+export { createFileReadTool, createFileWriteTool, createFileEditTool, createFileCreateTool, createFileTools, } from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/file/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/file/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/tools/file/tools.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @agntk/core - File Tool Implementations
+ *
+ * Provides file_read, file_write, file_edit, file_create tools.
+ * All paths are resolved relative to and scoped within workspaceRoot.
+ */
+export declare function createFileReadTool(workspaceRoot?: string): import("ai").Tool<{
+    path: string;
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+}, string>;
+export declare function createFileWriteTool(workspaceRoot?: string): import("ai").Tool<{
+    path: string;
+    content: string;
+}, string>;
+export declare function createFileEditTool(workspaceRoot?: string): import("ai").Tool<{
+    path: string;
+    oldText: string;
+    newText: string;
+}, string>;
+export declare function createFileCreateTool(workspaceRoot?: string): import("ai").Tool<{
+    path: string;
+    content: string;
+}, string>;
+export declare function createFileTools(workspaceRoot?: string): {
+    file_read: import("ai").Tool<{
+        path: string;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, string>;
+    file_write: import("ai").Tool<{
+        path: string;
+        content: string;
+    }, string>;
+    file_edit: import("ai").Tool<{
+        path: string;
+        oldText: string;
+        newText: string;
+    }, string>;
+    file_create: import("ai").Tool<{
+        path: string;
+        content: string;
+    }, string>;
+};
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/file/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2DH,wBAAgB,kBAAkB,CAAC,aAAa,GAAE,MAAsB;;;;WAgCvE;AAcD,wBAAgB,mBAAmB,CAAC,aAAa,GAAE,MAAsB;;;WAsBxE;AAiBD,wBAAgB,kBAAkB,CAAC,aAAa,GAAE,MAAsB;;;;WAsCvE;AAeD,wBAAgB,oBAAoB,CAAC,aAAa,GAAE,MAAsB;;;WA0BzE;AAMD,wBAAgB,eAAe,CAAC,aAAa,GAAE,MAAsB;;;;;;;;;;;;;;;;;;;EAOpE"}

package/dist/tools/file/tools.js

@@ -0,0 +1,206 @@
+/**
+ * @agntk/core - File Tool Implementations
+ *
+ * Provides file_read, file_write, file_edit, file_create tools.
+ * All paths are resolved relative to and scoped within workspaceRoot.
+ */
+import { tool } from 'ai';
+import { z } from 'zod';
+import * as fs from 'node:fs';
+import * as fsPromises from 'node:fs/promises';
+import * as path from 'node:path';
+import { success, error } from '../utils/tool-result.js';
+// ============================================================================
+// Path Safety
+// ============================================================================
+function resolveAndValidatePath(filePath, workspaceRoot) {
+    // Reject null bytes — can truncate paths in C-level APIs
+    if (filePath.includes('\0')) {
+        throw new Error('Null bytes not allowed in file paths');
+    }
+    const resolved = path.resolve(workspaceRoot, filePath);
+    // Follow symlinks on the workspace root to get canonical path
+    // (on macOS, /var -> /private/var would cause false rejections)
+    const realWorkspace = fs.realpathSync(path.resolve(workspaceRoot));
+    let realResolved;
+    try {
+        // Follow symlinks to get the ACTUAL filesystem target
+        realResolved = fs.realpathSync(resolved);
+    }
+    catch {
+        // File doesn't exist yet (file_create/file_write) — validate parent directory
+        const parentReal = fs.realpathSync(path.dirname(resolved));
+        if (!parentReal.startsWith(realWorkspace + path.sep) && parentReal !== realWorkspace) {
+            throw new Error(`Path "${filePath}" is outside workspace root`);
+        }
+        return resolved;
+    }
+    // Trailing path.sep prevents "/workspace-evil" matching "/workspace"
+    if (!realResolved.startsWith(realWorkspace + path.sep) && realResolved !== realWorkspace) {
+        throw new Error(`Path "${filePath}" is outside workspace root`);
+    }
+    return resolved;
+}
+// ============================================================================
+// file_read
+// ============================================================================
+const FILE_READ_DESCRIPTION = `Read a file from the workspace.
+Supports optional line range (startLine/endLine) for reading specific sections.
+Returns the file content with line numbers.`;
+const fileReadSchema = z.object({
+    path: z.string().describe('File path relative to workspace root'),
+    startLine: z.number().optional().describe('Start line (1-indexed, inclusive)'),
+    endLine: z.number().optional().describe('End line (1-indexed, inclusive)'),
+});
+export function createFileReadTool(workspaceRoot = process.cwd()) {
+    return tool({
+        description: FILE_READ_DESCRIPTION,
+        inputSchema: fileReadSchema,
+        execute: async ({ path: filePath, startLine, endLine }) => {
+            try {
+                const resolved = resolveAndValidatePath(filePath, workspaceRoot);
+                if (!fs.existsSync(resolved)) {
+                    return error(`File not found: ${filePath}`);
+                }
+                const content = await fsPromises.readFile(resolved, 'utf-8');
+                const lines = content.split('\n');
+                const start = Math.max(1, startLine ?? 1);
+                const end = Math.min(lines.length, endLine ?? lines.length);
+                const selected = lines.slice(start - 1, end);
+                const numbered = selected.map((line, i) => `${String(start + i).padStart(4)}│ ${line}`).join('\n');
+                return success({
+                    path: filePath,
+                    totalLines: lines.length,
+                    range: { start, end },
+                    content: numbered,
+                });
+            }
+            catch (err) {
+                return error(err instanceof Error ? err : new Error(String(err)));
+            }
+        },
+    });
+}
+// ============================================================================
+// file_write
+// ============================================================================
+const FILE_WRITE_DESCRIPTION = `Write content to a file. Creates parent directories automatically.
+Overwrites the file if it already exists. Use file_create if you want to fail on existing files.`;
+const fileWriteSchema = z.object({
+    path: z.string().describe('File path relative to workspace root'),
+    content: z.string().describe('Content to write to the file'),
+});
+export function createFileWriteTool(workspaceRoot = process.cwd()) {
+    return tool({
+        description: FILE_WRITE_DESCRIPTION,
+        inputSchema: fileWriteSchema,
+        execute: async ({ path: filePath, content }) => {
+            try {
+                const resolved = resolveAndValidatePath(filePath, workspaceRoot);
+                // Create parent directories
+                await fsPromises.mkdir(path.dirname(resolved), { recursive: true });
+                await fsPromises.writeFile(resolved, content, 'utf-8');
+                return success({
+                    path: filePath,
+                    bytesWritten: Buffer.byteLength(content, 'utf-8'),
+                    message: `File written: ${filePath}`,
+                });
+            }
+            catch (err) {
+                return error(err instanceof Error ? err : new Error(String(err)));
+            }
+        },
+    });
+}
+// ============================================================================
+// file_edit
+// ============================================================================
+const FILE_EDIT_DESCRIPTION = `Edit a file using context-based search and replace.
+Provide the exact text to find (oldText) and the replacement text (newText).
+Uses surrounding code as anchors — no line numbers needed.
+The oldText must match exactly (including whitespace) for the edit to succeed.`;
+const fileEditSchema = z.object({
+    path: z.string().describe('File path relative to workspace root'),
+    oldText: z.string().describe('Exact text to find in the file (must be unique)'),
+    newText: z.string().describe('Replacement text'),
+});
+export function createFileEditTool(workspaceRoot = process.cwd()) {
+    return tool({
+        description: FILE_EDIT_DESCRIPTION,
+        inputSchema: fileEditSchema,
+        execute: async ({ path: filePath, oldText, newText }) => {
+            try {
+                const resolved = resolveAndValidatePath(filePath, workspaceRoot);
+                if (!fs.existsSync(resolved)) {
+                    return error(`File not found: ${filePath}`);
+                }
+                const content = await fsPromises.readFile(resolved, 'utf-8');
+                // Count occurrences
+                const occurrences = content.split(oldText).length - 1;
+                if (occurrences === 0) {
+                    return error(`Text not found in ${filePath}. Ensure oldText matches exactly (including whitespace).`);
+                }
+                if (occurrences > 1) {
+                    return error(`Found ${String(occurrences)} matches for oldText in ${filePath}. Provide more surrounding context to make the match unique.`);
+                }
+                const newContent = content.replace(oldText, newText);
+                await fsPromises.writeFile(resolved, newContent, 'utf-8');
+                return success({
+                    path: filePath,
+                    message: `Edit applied to ${filePath}`,
+                    linesChanged: newText.split('\n').length - oldText.split('\n').length,
+                });
+            }
+            catch (err) {
+                return error(err instanceof Error ? err : new Error(String(err)));
+            }
+        },
+    });
+}
+// ============================================================================
+// file_create
+// ============================================================================
+const FILE_CREATE_DESCRIPTION = `Create a new file. Fails if the file already exists.
+Creates parent directories automatically.
+Use file_write if you want to overwrite existing files.`;
+const fileCreateSchema = z.object({
+    path: z.string().describe('File path relative to workspace root'),
+    content: z.string().describe('Content for the new file'),
+});
+export function createFileCreateTool(workspaceRoot = process.cwd()) {
+    return tool({
+        description: FILE_CREATE_DESCRIPTION,
+        inputSchema: fileCreateSchema,
+        execute: async ({ path: filePath, content }) => {
+            try {
+                const resolved = resolveAndValidatePath(filePath, workspaceRoot);
+                if (fs.existsSync(resolved)) {
+                    return error(`File already exists: ${filePath}. Use file_write to overwrite, or file_edit to modify.`);
+                }
+                // Create parent directories
+                await fsPromises.mkdir(path.dirname(resolved), { recursive: true });
+                await fsPromises.writeFile(resolved, content, 'utf-8');
+                return success({
+                    path: filePath,
+                    bytesWritten: Buffer.byteLength(content, 'utf-8'),
+                    message: `File created: ${filePath}`,
+                });
+            }
+            catch (err) {
+                return error(err instanceof Error ? err : new Error(String(err)));
+            }
+        },
+    });
+}
+// ============================================================================
+// Convenience: Create all file tools
+// ============================================================================
+export function createFileTools(workspaceRoot = process.cwd()) {
+    return {
+        file_read: createFileReadTool(workspaceRoot),
+        file_write: createFileWriteTool(workspaceRoot),
+        file_edit: createFileEditTool(workspaceRoot),
+        file_create: createFileCreateTool(workspaceRoot),
+    };
+}
+//# sourceMappingURL=tools.js.map