@superblocksteam/vite-plugin-file-sync 2.0.42 → 2.0.43-next.0

package/dist/ai-service/agent/tools2/registry.js

@@ -0,0 +1,305 @@
+import { PermissionLevel, } from "./types.js";
+export class ToolRegistry {
+    factories = new Map();
+    instances = new Map();
+    accessRules = [];
+    middleware = [];
+    promptHandler;
+    /**
+     * Register a tool factory and optionally instantiate it immediately.
+     *
+     * @param factory - Tool factory to register
+     * @param deps - Optional dependencies to instantiate the tool immediately
+     * @throws Error if tool with same name already registered
+     */
+    register(factory, ...deps) {
+        if (this.factories.has(factory.name) || this.instances.has(factory.name)) {
+            throw new Error(`Tool "${factory.name}" already registered`);
+        }
+        this.factories.set(factory.name, factory);
+        // If dependencies are provided, instantiate immediately
+        if (deps.length > 0) {
+            const instance = factory.create(...deps);
+            if (instance.name !== factory.name) {
+                throw new Error(`Tool name mismatch: factory.name="${factory.name}" but tool.name="${instance.name}"`);
+            }
+            this.instances.set(factory.name, instance);
+        }
+    }
+    /**
+     * Register an already-instantiated tool (for tools not using factory pattern).
+     *
+     * @param tool - Tool instance to register (must have name and execute)
+     * @throws Error if tool with same name already registered
+     */
+    registerTool(tool) {
+        if (!tool.name) {
+            throw new Error("Tool must have a name property");
+        }
+        if (this.instances.has(tool.name)) {
+            throw new Error(`Tool "${tool.name}" already registered`);
+        }
+        // Coerce to Tool type - AI SDK tools may have different structure
+        this.instances.set(tool.name, tool);
+    }
+    /**
+     * Get list of all registered tool names.
+     *
+     * @returns Array of tool names
+     */
+    listTools() {
+        return Array.from(this.instances.keys());
+    }
+    /**
+     * Register multiple tool factories at once.
+     *
+     * @param factories - Array of tool factories to register
+     */
+    registerAll(factories) {
+        for (const factory of factories) {
+            this.register(factory);
+        }
+    }
+    /**
+     * Instantiate all registered tools with dependencies.
+     *
+     * This should be called once dependencies are available.
+     * Tools will be created by calling their factory functions.
+     *
+     * @param deps - Dependencies to pass to tool factory functions
+     * @throws Error if tool name doesn't match factory name
+     */
+    instantiate(...deps) {
+        for (const [name, factory] of this.factories.entries()) {
+            const instance = factory.create(...deps);
+            // Validate tool name matches factory name
+            if (instance.name !== factory.name) {
+                throw new Error(`Tool name mismatch: factory.name="${factory.name}" but tool.name="${instance.name}"`);
+            }
+            this.instances.set(name, instance);
+        }
+    }
+    /**
+     * Wrap a tool to enforce access control on execute().
+     *
+     * Returns a proxied version where execute() goes through the registry's
+     * permission checks, ensuring access control is enforced regardless of
+     * how the tool is accessed.
+     *
+     * @param tool - Raw tool instance
+     * @param context - Access control context to use for permission checks
+     * @returns Wrapped tool with access-controlled execute()
+     */
+    wrapTool(tool, context) {
+        return {
+            ...tool,
+            execute: async (input) => {
+                // Execute through registry to apply access control with captured context
+                const result = await this.execute(tool.name, input, context);
+                if (!result.success) {
+                    throw new Error(result.error);
+                }
+                return result.data;
+            },
+        };
+    }
+    /**
+     * Get a tool instance by name.
+     *
+     * Returns a wrapped version where execute() enforces access control.
+     *
+     * @param name - Tool name
+     * @param context - Access control context (optional)
+     * @returns Wrapped tool instance or undefined if not found
+     */
+    getTool(name, context) {
+        const tool = this.instances.get(name);
+        return tool ? this.wrapTool(tool, context ?? {}) : undefined;
+    }
+    /**
+     * Get all tool instances.
+     *
+     * Returns wrapped versions where execute() enforces access control.
+     *
+     * @param context - Access control context (optional)
+     * @returns Array of all wrapped tool instances
+     */
+    getAllTools(context) {
+        const ctx = context ?? {};
+        return Array.from(this.instances.values()).map((tool) => this.wrapTool(tool, ctx));
+    }
+    /**
+     * Get metadata for all tools.
+     *
+     * @returns Array of metadata for all instantiated tools
+     */
+    getToolMetadata() {
+        return Array.from(this.instances.values()).map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            category: tool.category,
+            defaultPermission: tool.defaultPermission,
+        }));
+    }
+    /**
+     * Get tools as a record for AI SDK.
+     *
+     * Returns wrapped versions where execute() enforces access control.
+     * Filters out tools that are BLOCKED by access control rules.
+     *
+     * @param context - Access control context (optional, e.g., { mode: AiMode.PLAN })
+     * @returns Record mapping tool names to wrapped tool instances
+     */
+    async getToolsRecord(context) {
+        const ctx = context ?? {};
+        // Filter out blocked tools
+        const allowedTools = [];
+        for (const [name, tool] of this.instances.entries()) {
+            const permission = await this.checkPermission(name, ctx);
+            if (permission !== PermissionLevel.BLOCK) {
+                // Apply middleware first (e.g., profiling wraps the original execute)
+                let processedTool = tool;
+                for (const mw of this.middleware) {
+                    processedTool = mw(name, processedTool);
+                }
+                // Then wrap with access control (wraps the profiled execute)
+                const wrappedTool = this.wrapTool(processedTool, ctx);
+                allowedTools.push([name, wrappedTool]);
+            }
+        }
+        return Object.fromEntries(allowedTools);
+    }
+    /**
+     * Add one or more access control rules.
+     *
+     * Rules are evaluated in order when checking permissions.
+     * Most restrictive permission level wins.
+     *
+     * @param rules - Access control rule function(s)
+     */
+    addAccessRule(...rules) {
+        this.accessRules.push(...rules);
+    }
+    /**
+     * Add middleware to transform tools.
+     *
+     * Middleware is applied in order after access control filtering.
+     * Each middleware receives the tool name and instance and returns a transformed tool.
+     *
+     * @param middleware - Middleware function(s)
+     *
+     * @example
+     * registry.addMiddleware((name, tool) => profileTool(name, tool));
+     */
+    addMiddleware(...middleware) {
+        this.middleware.push(...middleware);
+    }
+    /**
+     * Set handler for prompting user for confirmation.
+     *
+     * @param handler - Prompt handler function
+     */
+    setPromptHandler(handler) {
+        this.promptHandler = handler;
+    }
+    /**
+     * Check permission level for tool execution.
+     *
+     * Evaluates all access control rules and returns most restrictive permission.
+     *
+     * @param toolName - Name of tool to check
+     * @param context - Access control context
+     * @returns Permission level for execution
+     */
+    async checkPermission(toolName, context) {
+        // Start with tool's default permission
+        const tool = this.instances.get(toolName);
+        let permission = tool?.defaultPermission ?? PermissionLevel.ALLOW;
+        // Check all rules, most restrictive wins
+        for (const rule of this.accessRules) {
+            const result = await rule(toolName, context, tool?.category, tool?.readOnly);
+            // BLOCK is most restrictive
+            if (result === PermissionLevel.BLOCK) {
+                return PermissionLevel.BLOCK;
+            }
+            // PROMPT is more restrictive than ALLOW
+            if (result === PermissionLevel.PROMPT) {
+                permission = PermissionLevel.PROMPT;
+            }
+        }
+        return permission;
+    }
+    /**
+     * Execute a tool with access control.
+     *
+     * Checks permissions, prompts user if needed, validates input,
+     * and executes the tool.
+     *
+     * @param toolName - Name of tool to execute
+     * @param input - Input data for tool
+     * @param context - Access control context
+     * @returns Execution result with success status and data/error
+     */
+    async execute(toolName, input, context = {}) {
+        // Get raw tool instance (not wrapped to avoid infinite recursion)
+        const tool = this.instances.get(toolName);
+        if (!tool) {
+            return {
+                success: false,
+                error: `Tool "${toolName}" not found`,
+            };
+        }
+        // Check permission
+        const permission = await this.checkPermission(toolName, context);
+        // Handle BLOCK
+        if (permission === PermissionLevel.BLOCK) {
+            return {
+                success: false,
+                error: `Tool "${toolName}" execution blocked by access control`,
+            };
+        }
+        // Handle PROMPT
+        if (permission === PermissionLevel.PROMPT) {
+            if (!this.promptHandler) {
+                return {
+                    success: false,
+                    error: `Tool "${toolName}" requires user confirmation but no prompt handler registered`,
+                };
+            }
+            const approved = await this.promptHandler(toolName, input, context);
+            if (!approved) {
+                return {
+                    success: false,
+                    error: `Tool "${toolName}" execution rejected by user`,
+                };
+            }
+        }
+        // Validate input and execute
+        try {
+            const validated = tool.inputSchema.parse(input);
+            const output = await tool.execute(validated);
+            return {
+                success: true,
+                data: output,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Clear all registered tools and rules.
+     *
+     * Useful for testing or resetting state.
+     */
+    clear() {
+        this.factories.clear();
+        this.instances.clear();
+        this.accessRules = [];
+        this.promptHandler = undefined;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/ai-service/agent/tools2/registry.js.map

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

package/dist/ai-service/agent/tools2/tools/ask-multi-choice.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Ask Multi-Choice - presents multiple choice options to the user.
+ */
+export declare const askMultiChoiceToolFactory: import("../types.js").ToolFactory<import("../types.js").Tool<{
+    choices: string[];
+    question: string;
+    selectionType?: "single" | "multiple" | undefined;
+}, {
+    success: boolean;
+    message: string;
+}>>;
+//# sourceMappingURL=ask-multi-choice.d.ts.map

package/dist/ai-service/agent/tools2/tools/ask-multi-choice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-multi-choice.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools2/tools/ask-multi-choice.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;GA6ErC,CAAC"}

package/dist/ai-service/agent/tools2/tools/ask-multi-choice.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { sendUserMessageChannel } from "../../../state-machine/helpers/peer.js";
+import { createToolFactory, PermissionLevel, ToolCategory } from "../types.js";
+/**
+ * Ask Multi-Choice - presents multiple choice options to the user.
+ */
+export const askMultiChoiceToolFactory = createToolFactory("askMultiChoice", (clark, services) => {
+    const { chatSessionStore } = services;
+    return {
+        description: `
+ALWAYS USE THIS TOOL when you need to ask the user ANY question.
+
+This tool presents the user with a question and multiple choice options.
+Even for seemingly open-ended questions, you should come up with 3-6 suggested choices to make it easier for the user.
+
+When to use:
+- User's request is ambiguous and could mean multiple things
+- Need to understand user's preference between different approaches
+- Want to confirm a specific detail before proceeding
+- Want to present options for the user to choose from
+- ANY time you would ask the user a question - make it multi-choice!
+
+For open-ended questions:
+- Come up with 3-6 reasonable suggestions based on common patterns
+- Add a "Something else" or "Other" option as the last choice
+- The user will select from your suggestions, making the interaction faster
+
+IMPORTANT: When asking about datasources/integrations:
+- FIRST use the searchIntegrations tool to discover what datasources are available
+- THEN present the available options to the user in your multi-choice question
+- Don't ask the user to choose from integrations you haven't discovered yet
+
+NEVER ask the user to type out a response when you can provide clear options.
+The user will select one (or more) of the choices, and their selection will be sent back to you as a message.
+`,
+        category: ToolCategory.GENERAL,
+        defaultPermission: PermissionLevel.ALLOW,
+        readOnly: true,
+        inputSchema: z.object({
+            question: z
+                .string()
+                .describe("The question to ask the user. Supports markdown formatting."),
+            choices: z
+                .array(z.string())
+                .min(2)
+                .max(6)
+                .describe("List of 2-6 choices for the user to select from. Each choice should be a clear, concise option. For open-ended questions, provide sensible suggestions and include 'Something else' or 'Other' as the last option."),
+            selectionType: z
+                .enum(["single", "multiple"])
+                .default("single")
+                .optional()
+                .describe('Selection mode: "single" (user picks one option) or "multiple" (user can select multiple options). Default is "single".'),
+        }),
+        execute: async ({ question, choices, selectionType }) => {
+            // Send multi-choice message to user with special type for UI to render with choice buttons
+            const payload = {
+                type: "multi_choice",
+                text: question,
+                group: "clark",
+                choices,
+                selectionType,
+            };
+            // Use sendUserMessageChannel to ensure ID is generated and shared properly
+            const sendUserMessage = sendUserMessageChannel(clark, chatSessionStore);
+            await sendUserMessage(payload);
+            return {
+                success: true,
+                message: `Presented ${choices.length} choices to user. Awaiting their selection.`,
+            };
+        },
+    };
+});
+//# sourceMappingURL=ask-multi-choice.js.map

package/dist/ai-service/agent/tools2/tools/ask-multi-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-multi-choice.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools2/tools/ask-multi-choice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI/E;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CACxD,gBAAgB,EAChB,CAAC,KAAY,EAAE,QAAiC,EAAE,EAAE;IAClD,MAAM,EAAE,gBAAgB,EAAE,GAAG,QAAQ,CAAC;IAEtC,OAAO;QACL,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;CAyBlB;QACK,QAAQ,EAAE,YAAY,CAAC,OAAO;QAC9B,iBAAiB,EAAE,eAAe,CAAC,KAAK;QACxC,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CACP,6DAA6D,CAC9D;YACH,OAAO,EAAE,CAAC;iBACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,oNAAoN,CACrN;YACH,aAAa,EAAE,CAAC;iBACb,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;iBAC5B,OAAO,CAAC,QAAQ,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,yHAAyH,CAC1H;SACJ,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE;YACtD,2FAA2F;YAC3F,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,cAAuB;gBAC7B,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,OAAO;gBACd,OAAO;gBACP,aAAa;aACd,CAAC;YAEF,2EAA2E;YAC3E,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;YACxE,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;YAE/B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,aAAa,OAAO,CAAC,MAAM,6CAA6C;aAClF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/ai-service/agent/tools2/tools/bash.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Bash tool - Executes bash commands in a persistent shell session.
+ */
+export declare const bashToolFactory: import("../types.js").ToolFactory<import("../types.js").Tool<{
+    command: string;
+    timeout: number;
+    run_in_background: boolean;
+    description?: string | undefined;
+}, {
+    success: boolean;
+    message: string;
+    pid: number | undefined;
+    stdout?: undefined;
+    stderr?: undefined;
+    exitCode?: undefined;
+    error?: undefined;
+} | {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    message?: undefined;
+    pid?: undefined;
+    error?: undefined;
+} | {
+    success: boolean;
+    stdout: any;
+    stderr: any;
+    exitCode: any;
+    error: any;
+    message?: undefined;
+    pid?: undefined;
+}>>;
+//# sourceMappingURL=bash.d.ts.map

package/dist/ai-service/agent/tools2/tools/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools2/tools/bash.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EzB,CAAC"}

package/dist/ai-service/agent/tools2/tools/bash.js

@@ -0,0 +1,76 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { z } from "zod";
+import { createToolFactory, PermissionLevel, ToolCategory } from "../types.js";
+const execAsync = promisify(exec);
+/**
+ * Bash tool - Executes bash commands in a persistent shell session.
+ */
+export const bashToolFactory = createToolFactory("bash", () => ({
+    description: `
+Executes a given bash command in a persistent shell session with optional timeout, ensuring proper handling and security measures.
+
+IMPORTANT: This tool is for terminal operations like git, npm, docker, etc. DO NOT use it for file operations (reading, writing, editing, searching, finding files) - use the specialized tools for this instead.
+`,
+    category: ToolCategory.GENERAL,
+    defaultPermission: PermissionLevel.PROMPT,
+    inputSchema: z.object({
+        command: z.string().describe("Command to execute"),
+        description: z
+            .string()
+            .optional()
+            .describe("Description of what command does"),
+        timeout: z
+            .number()
+            .optional()
+            .default(120000)
+            .describe("Timeout in ms (max 600000, default 120000)"),
+        run_in_background: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Run in background (default: false)"),
+    }),
+    execute: async ({ command, description: _description, timeout, run_in_background, }) => {
+        try {
+            if (run_in_background) {
+                // For background execution, spawn without waiting
+                const childProcess = exec(command, {
+                    timeout,
+                    maxBuffer: 10 * 1024 * 1024, // 10MB
+                });
+                return {
+                    success: true,
+                    message: "Command started in background",
+                    pid: childProcess.pid,
+                };
+            }
+            // For foreground execution, wait for completion
+            const { stdout, stderr } = await execAsync(command, {
+                timeout,
+                maxBuffer: 10 * 1024 * 1024, // 10MB
+            });
+            return {
+                success: true,
+                stdout: stdout || "",
+                stderr: stderr || "",
+                exitCode: 0,
+            };
+        }
+        catch (error) {
+            // Handle timeout
+            if (error.killed && error.signal === "SIGTERM") {
+                throw new Error(`Command timed out after ${timeout}ms`);
+            }
+            // Handle non-zero exit code
+            return {
+                success: false,
+                stdout: error.stdout || "",
+                stderr: error.stderr || "",
+                exitCode: error.code || 1,
+                error: error.message,
+            };
+        }
+    },
+}));
+//# sourceMappingURL=bash.js.map

package/dist/ai-service/agent/tools2/tools/bash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools2/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9D,WAAW,EAAE;;;;CAId;IACC,QAAQ,EAAE,YAAY,CAAC,OAAO;IAC9B,iBAAiB,EAAE,eAAe,CAAC,MAAM;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAClD,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kCAAkC,CAAC;QAC/C,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,OAAO,CAAC,MAAM,CAAC;aACf,QAAQ,CAAC,4CAA4C,CAAC;QACzD,iBAAiB,EAAE,CAAC;aACjB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,oCAAoC,CAAC;KAClD,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,EACd,OAAO,EACP,WAAW,EAAE,YAAY,EACzB,OAAO,EACP,iBAAiB,GAClB,EAAE,EAAE;QACH,IAAI,CAAC;YACH,IAAI,iBAAiB,EAAE,CAAC;gBACtB,kDAAkD;gBAClD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE;oBACjC,OAAO;oBACP,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO;iBACrC,CAAC,CAAC;gBAEH,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,+BAA+B;oBACxC,GAAG,EAAE,YAAY,CAAC,GAAG;iBACtB,CAAC;YACJ,CAAC;YAED,gDAAgD;YAChD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;gBAClD,OAAO;gBACP,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO;aACrC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,MAAM,IAAI,EAAE;gBACpB,MAAM,EAAE,MAAM,IAAI,EAAE;gBACpB,QAAQ,EAAE,CAAC;aACZ,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,iBAAiB;YACjB,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,IAAI,CAAC,CAAC;YAC1D,CAAC;YAED,4BAA4B;YAC5B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;gBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;gBAC1B,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;gBACzB,KAAK,EAAE,KAAK,CAAC,OAAO;aACrB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC,CAAC,CAAC"}

package/dist/ai-service/agent/tools2/tools/edit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Edit tool - Performs exact string replacements in files.
+ */
+export declare const editToolFactory: import("../types.js").ToolFactory<import("../types.js").Tool<{
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all: boolean;
+}, {
+    success: boolean;
+    message: string;
+    replacements: number;
+}>>;
+//# sourceMappingURL=edit.d.ts.map

package/dist/ai-service/agent/tools2/tools/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools2/tools/edit.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;GAuDzB,CAAC"}

package/dist/ai-service/agent/tools2/tools/edit.js

@@ -0,0 +1,60 @@
+import fs from "node:fs/promises";
+import { z } from "zod";
+import { createToolFactory, PermissionLevel, ToolCategory } from "../types.js";
+/**
+ * Edit tool - Performs exact string replacements in files.
+ */
+export const editToolFactory = createToolFactory("edit", () => ({
+    description: "Performs exact string replacements in files.",
+    category: ToolCategory.FILE,
+    defaultPermission: PermissionLevel.ALLOW,
+    inputSchema: z.object({
+        file_path: z.string().describe("Absolute path to file"),
+        old_string: z.string().describe("Text to replace"),
+        new_string: z.string().describe("Text to replace with"),
+        replace_all: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Replace all occurrences (default: false)"),
+    }),
+    execute: async ({ file_path, old_string, new_string, replace_all }) => {
+        try {
+            const content = await fs.readFile(file_path, "utf-8");
+            let newContent;
+            if (replace_all) {
+                // Replace all occurrences
+                newContent = content.split(old_string).join(new_string);
+            }
+            else {
+                // Replace only first occurrence
+                const index = content.indexOf(old_string);
+                if (index === -1) {
+                    throw new Error(`String not found in file: ${old_string}`);
+                }
+                // Check if unique
+                const secondIndex = content.indexOf(old_string, index + 1);
+                if (secondIndex !== -1) {
+                    throw new Error("String is not unique in file. Use replace_all=true or provide more context.");
+                }
+                newContent =
+                    content.substring(0, index) +
+                        new_string +
+                        content.substring(index + old_string.length);
+            }
+            await fs.writeFile(file_path, newContent, "utf-8");
+            return {
+                success: true,
+                message: `File edited: ${file_path}`,
+                replacements: replace_all ? content.split(old_string).length - 1 : 1,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to edit file: ${error.message}`);
+            }
+            throw new Error("Failed to edit file: Unknown error");
+        }
+    },
+}));
+//# sourceMappingURL=edit.js.map

package/dist/ai-service/agent/tools2/tools/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools2/tools/edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9D,WAAW,EAAE,8CAA8C;IAC3D,QAAQ,EAAE,YAAY,CAAC,IAAI;IAC3B,iBAAiB,EAAE,eAAe,CAAC,KAAK;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAClD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACvD,WAAW,EAAE,CAAC;aACX,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,0CAA0C,CAAC;KACxD,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,EAAE;QACpE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAEtD,IAAI,UAAkB,CAAC;YACvB,IAAI,WAAW,EAAE,CAAC;gBAChB,0BAA0B;gBAC1B,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,gCAAgC;gBAChC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAC1C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;gBAC7D,CAAC;gBACD,kBAAkB;gBAClB,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBAC3D,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;gBACJ,CAAC;gBACD,UAAU;oBACR,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC;wBAC3B,UAAU;wBACV,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YACjD,CAAC;YAED,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAEnD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,gBAAgB,SAAS,EAAE;gBACpC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aACrE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF,CAAC,CAAC,CAAC"}

package/dist/ai-service/agent/tools2/tools/exit-plan-mode.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Exit Plan Mode - prompts the user to exit Plan mode when they have finished planning and are ready to code.
+ */
+export declare const exitPlanModeToolFactory: import("../types.js").ToolFactory<import("../types.js").Tool<{
+    plan: string;
+}, {
+    success: boolean;
+    message: string;
+}>>;
+//# sourceMappingURL=exit-plan-mode.d.ts.map

package/dist/ai-service/agent/tools2/tools/exit-plan-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-plan-mode.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools2/tools/exit-plan-mode.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;GAkEnC,CAAC"}