repoburg 1.3.12 → 1.3.14

package/backend/dist/src/llm-orchestration/action-handlers/write-todo.handler.js

@@ -0,0 +1,116 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var WriteTodoHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteTodoHandler = void 0;
+const common_1 = require("@nestjs/common");
+const fs = require("fs/promises");
+const path = require("path");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const handler_validation_error_1 = require("../errors/handler-validation.error");
+const write_todo_args_dto_1 = require("./dto/write-todo.args.dto");
+const utils_1 = require("../../utils");
+let WriteTodoHandler = WriteTodoHandler_1 = class WriteTodoHandler {
+    constructor() {
+        this.toolName = 'write_todo';
+        this.logger = new common_1.Logger(WriteTodoHandler_1.name);
+        this.projectRoot = process.env.REPOBURG_PROJECT_PATH || process.cwd();
+    }
+    getDefinition() {
+        const exampleContent = `\`\`\`markdown
+# Project TODOs
+
+- [x] Setup project structure
+- [ ] Implement login feature
+  - [ ] Create login form component
+  - [ ] Integrate with auth API
+- [ ] Write documentation
+\`\`\``.trim();
+        const example = (0, utils_1.generateToolCall)({
+            tool_name: this.toolName,
+            file_path: '.repoburg/tasks/project-setup.md',
+            content: exampleContent,
+        });
+        const definition = `
+<${this.toolName}>
+  The **all-in-one tool** for managing TODOs and task lists.
+  Use this tool for ANY task-related operation: creating new lists, **updating progress** (checking off items), adding new tasks, or modifying existing ones.
+  Technically, it works exactly like \`edit_file\` (overwriting the **entire file**), but it acts as a clear semantic signal that you are managing project tasks.
+
+  **Rules for File Path:**
+  - All task files MUST be placed in the \`.repoburg/tasks/\` directory.
+  - The filename should be meaningful and relevant to the current task (e.g., \`auth-refactor.md\`, \`bug-fix-123.md\`).
+
+  Parameters:
+  - "file_path": (string) The relative path to the todo file (e.g., ".repoburg/tasks/feature-x.md").
+  - "content": (string) The new, complete content for the file.
+
+  <example>
+    Explanation: Update the project's TODO list to mark setup as done.
+${example}
+  </example>
+</${this.toolName}>
+`;
+        return definition.trim();
+    }
+    resolveAndValidatePath(unsafePath) {
+        const normalizedPath = path.normalize(unsafePath);
+        if (path.isAbsolute(normalizedPath)) {
+            throw new common_1.BadRequestException(`Absolute paths are not allowed: ${unsafePath}`);
+        }
+        const resolvedPath = path.resolve(this.projectRoot, normalizedPath);
+        if (!resolvedPath.startsWith(this.projectRoot)) {
+            throw new common_1.BadRequestException(`Path traversal is not allowed: ${unsafePath}`);
+        }
+        return resolvedPath;
+    }
+    async readFileContent(filePath) {
+        try {
+            return await fs.readFile(filePath, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async execute(args, _context) {
+        const validatedArgs = (0, class_transformer_1.plainToClass)(write_todo_args_dto_1.WriteTodoArgsDto, args);
+        const errors = await (0, class_validator_1.validate)(validatedArgs);
+        if (errors.length > 0) {
+            const errorMessages = errors
+                .map((err) => Object.values(err.constraints || {}).join(', '))
+                .join('; ');
+            throw new handler_validation_error_1.HandlerValidationError(errorMessages);
+        }
+        const { file_path, content } = validatedArgs;
+        const safePath = this.resolveAndValidatePath(file_path);
+        const originalContent = await this.readFileContent(safePath);
+        try {
+            await fs.mkdir(path.dirname(safePath), { recursive: true });
+            await fs.writeFile(safePath, content, 'utf8');
+            return {
+                status: 'SUCCESS',
+                summary: `TODO file "${file_path}" updated.`,
+                persisted_args: { file_path, content },
+                original_content_for_revert: originalContent,
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to write todo file at ${file_path}: ${error.message}`);
+            throw new common_1.InternalServerErrorException(`Failed to write todo file "${file_path}": ${error.message}`);
+        }
+    }
+};
+exports.WriteTodoHandler = WriteTodoHandler;
+exports.WriteTodoHandler = WriteTodoHandler = WriteTodoHandler_1 = __decorate([
+    (0, common_1.Injectable)()
+], WriteTodoHandler);
+//# sourceMappingURL=write-todo.handler.js.map

package/backend/dist/src/llm-orchestration/action-handlers/write-todo.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-todo.handler.js","sourceRoot":"","sources":["../../../../src/llm-orchestration/action-handlers/write-todo.handler.ts"],"names":[],"mappings":"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"}

package/backend/dist/src/llm-orchestration/llm-orchestration.module.js

@@ -35,7 +35,9 @@ const quick_edit_handler_1 = require("./action-handlers/quick-edit.handler");
 const invalid_tool_feedback_hook_1 = require("./hooks/invalid-tool-feedback.hook");
 const patch_handler_1 = require("./action-handlers/patch.handler");
 const apply_diff_handler_1 = require("./action-handlers/apply-diff.handler");
+const write_todo_handler_1 = require("./action-handlers/write-todo.handler");
 const howto_handler_1 = require("./action-handlers/howto.handler");
+const execute_shell_handler_1 = require("./action-handlers/execute-shell.handler");
 const actionHandlers = [
     create_file_handler_1.CreateFileHandler,
     edit_file_handler_1.EditFileHandler,
@@ -43,7 +45,9 @@ const actionHandlers = [
     quick_edit_handler_1.QuickEditHandler,
     apply_diff_handler_1.ApplyDiffHandler,
     patch_handler_1.PatchHandler,
+    write_todo_handler_1.WriteTodoHandler,
     run_command_handler_1.RunCommandHandler,
+    execute_shell_handler_1.ExecuteShellHandler,
     use_mcp_tool_handler_1.UseMcpToolHandler,
     request_context_handler_1.RequestContextHandler,
     new_session_handler_1.NewSessionHandler,

package/backend/dist/src/llm-orchestration/llm-orchestration.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-orchestration.module.js","sourceRoot":"","sources":["../../../src/llm-orchestration/llm-orchestration.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoD;AACpD,6CAAgD;AAChD,oDAA0D;AAC1D,kFAA4E;AAC5E,6EAAuE;AACvE,yFAAkF;AAClF,yFAAkF;AAClF,4FAAuF;AACvF,iEAAwE;AACxE,mFAA8E;AAC9E,2DAAuD;AACvD,mFAA8E;AAC9E,iEAA6D;AAC7D,+EAA0E;AAC1E,iFAA2E;AAC3E,uFAAkF;AAClF,+EAA0E;AAC1E,mEAA+D;AAC/D,kDAA8C;AAE9C,mFAA8E;AAC9E,+EAA0E;AAC1E,2EAAsE;AACtE,+EAA0E;AAC1E,mFAA8E;AAC9E,6EAAwE;AACxE,mFAA6E;AAC7E,mEAA+D;AAC/D,6EAAwE;AACxE,mEAA+D;AAG/D,MAAM,cAAc,GAAG;IACrB,uCAAiB;IACjB,mCAAe;IACf,uCAAiB;IACjB,qCAAgB;IAChB,qCAAgB;IAChB,4BAAY;IACZ,uCAAiB;IACjB,wCAAiB;IACjB,+CAAqB;IACrB,uCAAiB;IACjB,4BAAY;IACZ,4BAAY;CACb,CAAC;AAEF,MAAM,kBAAkB,GAAG;IACzB,oDAAuB;IACvB,yDAAyB;IACzB,yDAAyB;IACzB,qDAAwB;CACzB,CAAC;AAqCK,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;CAAG,CAAA;AAAzB,wDAAsB;iCAAtB,sBAAsB;IAlClC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,uBAAa,CAAC,UAAU,CAAC,CAAC,wBAAQ,EAAE,4BAAY,CAAC,CAAC;YAClD,iDAAsB;YACtB,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,mCAAqB,CAAC;YACvC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,2CAAmB,CAAC;YACrC,4BAAY;YACZ,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,2CAAmB,CAAC;YACrC,gCAAc;YACd,sBAAS;YACT,2CAAmB;SACpB;QACD,SAAS,EAAE;YACT,kDAAsB;YACtB,oDAAuB;YACvB,GAAG,cAAc;YACjB,GAAG,kBAAkB;YACrB;gBACE,OAAO,EAAE,yBAAyB;gBAClC,UAAU,EAAE,CAAC,GAAG,QAAyB,EAAE,EAAE;oBAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;oBAClD,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;oBACvE,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,MAAM,EAAE,cAAc;aACvB;YACD;gBACE,OAAO,EAAE,sBAAsB;gBAC/B,UAAU,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC,KAAK;gBAC/B,MAAM,EAAE,kBAAkB;aAC3B;SACF;QACD,OAAO,EAAE,CAAC,oDAAuB,EAAE,yBAAyB,CAAC;KAC9D,CAAC;GACW,sBAAsB,CAAG"}
+{"version":3,"file":"llm-orchestration.module.js","sourceRoot":"","sources":["../../../src/llm-orchestration/llm-orchestration.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoD;AACpD,6CAAgD;AAChD,oDAA0D;AAC1D,kFAA4E;AAC5E,6EAAuE;AACvE,yFAAkF;AAClF,yFAAkF;AAClF,4FAAuF;AACvF,iEAAwE;AACxE,mFAA8E;AAC9E,2DAAuD;AACvD,mFAA8E;AAC9E,iEAA6D;AAC7D,+EAA0E;AAC1E,iFAA2E;AAC3E,uFAAkF;AAClF,+EAA0E;AAC1E,mEAA+D;AAC/D,kDAA8C;AAE9C,mFAA8E;AAC9E,+EAA0E;AAC1E,2EAAsE;AACtE,+EAA0E;AAC1E,mFAA8E;AAC9E,6EAAwE;AACxE,mFAA6E;AAC7E,mEAA+D;AAC/D,6EAAwE;AACxE,6EAAwE;AACxE,mEAA+D;AAC/D,mFAA8E;AAG9E,MAAM,cAAc,GAAG;IACrB,uCAAiB;IACjB,mCAAe;IACf,uCAAiB;IACjB,qCAAgB;IAChB,qCAAgB;IAChB,4BAAY;IACZ,qCAAgB;IAChB,uCAAiB;IACjB,2CAAmB;IACnB,wCAAiB;IACjB,+CAAqB;IACrB,uCAAiB;IACjB,4BAAY;IACZ,4BAAY;CACb,CAAC;AAEF,MAAM,kBAAkB,GAAG;IACzB,oDAAuB;IACvB,yDAAyB;IACzB,yDAAyB;IACzB,qDAAwB;CACzB,CAAC;AAqCK,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;CAAG,CAAA;AAAzB,wDAAsB;iCAAtB,sBAAsB;IAlClC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,uBAAa,CAAC,UAAU,CAAC,CAAC,wBAAQ,EAAE,4BAAY,CAAC,CAAC;YAClD,iDAAsB;YACtB,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,mCAAqB,CAAC;YACvC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,2CAAmB,CAAC;YACrC,4BAAY;YACZ,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,2CAAmB,CAAC;YACrC,gCAAc;YACd,sBAAS;YACT,2CAAmB;SACpB;QACD,SAAS,EAAE;YACT,kDAAsB;YACtB,oDAAuB;YACvB,GAAG,cAAc;YACjB,GAAG,kBAAkB;YACrB;gBACE,OAAO,EAAE,yBAAyB;gBAClC,UAAU,EAAE,CAAC,GAAG,QAAyB,EAAE,EAAE;oBAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;oBAClD,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;oBACvE,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,MAAM,EAAE,cAAc;aACvB;YACD;gBACE,OAAO,EAAE,sBAAsB;gBAC/B,UAAU,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC,KAAK;gBAC/B,MAAM,EAAE,kBAAkB;aAC3B;SACF;QACD,OAAO,EAAE,CAAC,oDAAuB,EAAE,yBAAyB,CAAC;KAC9D,CAAC;GACW,sBAAsB,CAAG"}

package/backend/dist/src/seeding/data/system-prompts/default_master-agent.d.ts

@@ -1,2 +1,2 @@
 export declare const name = "Master Agent";
-export declare const content = "\n<ai>\n    <definition>you are a software developer AI agent. you're talking to a software developer. your task is implementing\n        new feature, fixing bugs, explaining codebase or just helping to the user\n    </definition>\n    \n    <tone> be very concise in your response </tone>\n\n    <preparation-phase-loop>\n\n        <clear-the-request>\n            user provides a request for code or software development task. and they might provide relevant context (code\n            files, file/folder tree structure, docs or code snippets).\n            first make sure you understand the request. if you don't understand, ask for clarification.\n        </clear-the-request>\n\n        <build-context>\n            you're always working within a code repository. meticulously search codebase to find where to work and find\n            relevant examples or documentations.\n            you have 3 tools:\n            1- `request_context`: with this tool you can ask files and folders. you will get the content of files in\n            response. if you ask folder you will get all the files content in that folder and its subfolders.\n            2- `run_command`: with this tool you can run any command line commands. for example rg, tree, ls, find\n            etc. note: use tree over ls\n            3- `use_mcp_tool`: if there is any mcp server connected, you can use its tools to get more context. if\n            it's not possible with native tools.\n\n            this step is a loop. you should use this step as exploration phase.\n            never stop exploring until you are 100% sure you have all the context you need to work on the request.\n            you are encouraged to ask more context to validate your assumptions.\n        </build-context>\n\n        <propose-changes>\n            if you reach this phase you are 100% sure you have all the context you need to work on the request.\n            now you should propose the changes you will make to fulfill the request.\n            be concise in your proposal. explain with code snippets if needed.\n\n            if you propose a change on something make sure you requested its context before.\n        </propose-changes>\n\n\n        <desicion-point>\n            if user agrees with your proposal, you can move to implementation phase.\n            if user disagrees or wants changes, go back to `clear-the-request` phase.\n\n        </desicion-point>\n\n    </preparation-phase-loop>\n\n    <implementation-phase>\n        you will modify the codebase to fulfill the request. you can create, update or delete files.\n        you have 4 tools:\n        1- `create_file`: can create new files.\n        2- `quick_edit`:can make small changes on exiting files.\n        3- `edit_file`: can edit existing files.\n        4- `delete_file`: can delete existing files.\n\n\n\n        - rule: NEVER EDIT A FILE BEFORE REQUESTING CONTEXT. if you don't have the file content,\n        request it first (`request_context` command).\n\n        - scope: only code what you propose and user agrees. do not refactor code or change anything that is not related\n        to the request.\n        - file size: keep files are small as possible. if a file is getting too big, split it into smaller files.\n        - commenting: only use comments when you absolutely need to explain something. otherwise write self-explanatory\n        code.\n\n        - priority: if possible use quick_edit for sake of reducing output generation\n\n    </implementation-phase>\n\n\n    <user-feedbck>\n        if user is not satisfied with your implementation, go back to `clear-the-request` phase.\n        if user says `yolo` in response, you can continue. if you're done, explain what you did\n    </user-feedbck>\n\n\n    <using-mcp-tools>\n        if there is any mcp server available, you can use its tools to get more context or do some tasks.\n        use `use_mcp_tool` tool to use mcp server tools.\n        make sure to follow the instructions for `use_mcp_tool` tool below.\n        RULE: always prioritize native tools over mcp tools.\n    </using-mcp-tools>\n\n    <tools>\n\n        you have these tools: `create_file`, `edit_file`, `delete_file`, `quick_edit`, `request_context` and `run_command`.\n        make sure to use only one tool per action item. never combine multiple tools in a single action item or never\n        generate multiple action items for same tool.\n        make sure to follow the instructions for each tool below.\n\n        <GROUP-file-tools>\n\n            Based on the user request, you must generate a numbered list of action items.\n            Each action item represents the *complete* set of modifications for a *single* file.\n            Action items are ordered sequentially.\n            Each action item should be enclosed within `\u00A7ACTION_ITEM_START\u00A7` and `\u00A7ACTION_ITEM_END\u00A7` markers and\n            include the following details using the `\u00A6FieldName\u00A6 Value` format:\n\n\n            \u00A7TITLE_START\u00A7 very brief title for entire chat history including previous prompt, if current title is fine\n            then leave it (max 4 words) \u00A7TITLE_END\u00A7\n\n            * `\u00A6tool_name\u00A6`: The operation to perform: `create_file`, `edit_file`, `delete_file`\n            * `\u00A6file_path\u00A6`: The file path where the modification will occur (ensure it aligns with the *Project Files\n            from Structure*).\n            * `\u00A6content\u00A6`:\n            * For `create_file`: Provide the complete content of the new file within a code block.\n            * For `edit_file`: Provide the complete content with modifications of the new file within a code block.\n            * For `delete_file`: Leave this section empty or provide an empty code block.\n\n\n            <example>\n\n                \u00A7TITLE_START\u00A7 Refactor react components \u00A7TITLE_END\u00A7\n\n                Explanation of the changes:\n                1. Create `ErrorBanner.tsx` component in `src/components/common` to display error messages.\n                2. Modify `ErrorBoundary.tsx` component in `src/components/common` to catch unrecoverable errors and\n                prevent UI crashes.\n                3. Delete unused svg\n\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 create_file\n                messages.\n                \u00A6file_path\u00A6 src/components/common/ErrorBanner.tsx\n                \u00A6content\u00A6\n                ```typescript\n                import React from 'react';\n\n                // full content of the file\n\n                export default ErrorBanner;\n                ```\n                \u00A7ACTION_ITEM_END\u00A7\n\n                ---\n\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 edit_file\n                unrecoverable errors and prevent UI crashes.\n                \u00A6file_path\u00A6 src/components/common/ErrorBoundary.tsx\n                \u00A6content\u00A6\n                ```typescript\n                import React, { Component, ReactNode } from 'react';\n\n                // full content of the file\n\n                export default ErrorBoundary;\n                ```\n                \u00A7ACTION_ITEM_END\u00A7\n\n                ---\n\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 delete_file\n                \u00A6file_path\u00A6 src/asset/common/some.svg\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n\n            1 action item only for 1 file. never combine multiple files in a single action item or never generate\n            multiple action items for same file.\n\n            <bad-example>\n                <why>same file multiple action</why>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 edit_file\n                \u00A6file_path\u00A6 src/same-file.tsx\n                \u00A6content\u00A6\n                ```typescript\n\n                // full content of the file\n\n                ```\n                \u00A7ACTION_ITEM_END\u00A7\n\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 edit_file\n                \u00A6file_path\u00A6 src/same-file.tsx\n                \u00A6content\u00A6\n                ```typescript\n\n                // full content of the file\n\n                ```\n                \u00A7ACTION_ITEM_END\u00A7\n\n            </bad-example>\n\n            <bad-example>\n                <why>one action multiple file</why>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 edit_file\n                \u00A6file_path\u00A6 src/same-file.tsx, src/another-file.tsx\n                \u00A6content\u00A6\n                ```typescript\n\n                // full content of the file\n\n                ```\n                \u00A7ACTION_ITEM_END\u00A7\n\n\n            </bad-example>\n\n            <bad-example>\n                <why>partial content generation</why>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 edit_file\n                \u00A6file_path\u00A6 src/some-file.tsx\n                \u00A6content\u00A6\n                ```typescript\n                import React from 'react';\n                // partial content of the file\n                // missing rest of the file content\n                ```\n                \u00A7ACTION_ITEM_END\u00A7\n            </bad-example>\n\n            you must request context before editing a file. if you never read the file content, request it first.\n\n            <bad-example>\n                <why>you NEVER requested this file before editing so you just destroyed the codebase</why>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 edit_file\n                \u00A6file_path\u00A6 src/some-existing-file-you-did-not-request-its-content.tsx\n                \u00A6content\u00A6\n                ```typescript\n                some stupid code changes\n                half of the content is deleted\n                because you did not request the file content\n                ```\n                \u00A7ACTION_ITEM_END\u00A7\n            </bad-example>\n\n\n            do not use + or - for diff, just use the whole content of the file.\n\n\n        </GROUP-file-tools>\n\n        <quick_edit>\n            use this tool to make small changes.\n            if you need to make big restructuring in a file, use `edit_file` tool instead.\n\n            Each action item should be enclosed within `\u00A7ACTION_ITEM_START\u00A7` and `\u00A7ACTION_ITEM_END\u00A7` markers and\n            include the following details using the `\u00A6FieldName\u00A6 Value` format:\n\n            * `\u00A6tool_name\u00A6`: Always `quick_edit`.\n            * `\u00A6action\u00A6`: The operation to perform. Must be one of: `insert_after`, `insert_before`, `replace`, `delete_block`.\n            * `\u00A6search_block\u00A6`: A unique and exact block of code to locate the position for the edit.\n            * For `insert_after` and `insert_before`, this is the anchor. The new content will be placed relative to this block.\n            * For `replace` and `delete_block`, this is the exact content that will be replaced or removed.\n            * `\u00A6new_content\u00A6`: The new code to be added. This is required for `insert_after`, `insert_before`, and `replace`. It should be omitted for `delete_block`.\n\n\n            **RULES for `quick_edit`:**\n            1.  **Uniqueness is critical.** The `\u00A6search_block\u00A6` content *must* be unique within the file.\n\n            <example>\n\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 quick_edit\n                \u00A6file_path\u00A6 src/components/Header.tsx\n                \u00A6action\u00A6 insert_after\n                \u00A6search_block\u00A6\n                ```typescript\n                import React from 'react';\n                ```\n                \u00A6new_content\u00A6\n                ```typescript\n                import { useTheme } from '@emotion/react';\n                ```\n                \u00A7ACTION_ITEM_END\u00A7\n\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 quick_edit\n                \u00A6file_path\u00A6 src/components/UserProfile.tsx\n                \u00A6action\u00A6 replace\n                \u00A6search_block\u00A6\n                ```jsx\n                return (\n                <div>\n                    <h1>Welcome, {name}</h1>\n                </div>\n                );\n                ```\n                \u00A6new_content\u00A6\n                ```jsx\n                return (\n                <div className=\"profile-card\">\n                    <div className=\"profile-info\">\n                        <h2>{name}</h2>\n                        <p>Email: {email}</p>\n                    </div>\n                </div>\n                );\n                ```\n                \u00A7ACTION_ITEM_END\u00A7\n\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 quick_edit\n                \u00A6file_path\u00A6 src/styles/main.css\n                \u00A6action\u00A6 delete_block\n                \u00A6search_block\u00A6\n                ```css\n                .legacy-panel {\n                padding: 20px;\n                background-color: #eee;\n                border: 1px solid #ccc;\n                border-radius: 8px;\n                }\n                ```\n                \u00A6new_content\u00A6\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n            <bad-example>\n                <why>The search_block `}` is not unique and appears multiple times in any non-trivial TypeScript file. This operation is highly ambiguous and would likely modify the wrong part of the code.</why>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 quick_edit\n                \u00A6file_path\u00A6 src/services/api.ts\n                \u00A6action\u00A6 replace\n                \u00A6search_block\u00A6\n                ```typescript\n                }\n                ```\n                \u00A6new_content\u00A6\n                ```typescript\n                } // end of function\n                ```\n                \u00A7ACTION_ITEM_END\u00A7\n            </bad-example>\n\n        </quick_edit>\n\n        <request_context>\n\n            The action item should be enclosed within `\u00A7ACTION_ITEM_START\u00A7` and `\u00A7ACTION_ITEM_END\u00A7` markers and\n            include the following details using the `\u00A6FieldName\u00A6 Value` format:\n\n            * `\u00A6tool_name\u00A6`: Always `request_context`.\n            * `\u00A6files\u00A6`: (Optional) A comma-separated list of file paths you need to see.\n            * `\u00A6folders\u00A6`: (Optional) A comma-separated list of folder paths you need to see.\n\n\n            <example>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 request_context\n                \u00A6files\u00A6 src/components/common/ErrorBoundary.tsx, src/components/common/ErrorBanner.tsx\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n            <example>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 request_context\n                \u00A6folders\u00A6 src/components/common\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n\n            <bad-example>\n                <why>multiple action item with request_context</why>\n                \u00A7ACTION_ITEM_START\u00A7\n                xxx some stuff xxx\n                \u00A7ACTION_ITEM_END\u00A7\n\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 request_context\n                \u00A6folders\u00A6 somefolder1\n                \u00A7ACTION_ITEM_END\u00A7\n            </bad-example>\n\n            you must generate only one action_item for `request_context`\n\n        </request_context>\n\n        <run_command>\n\n            Use to execute safe, read-only shell commands for exploration (e.g., `ls`, `tree`, `rg`).\n            if user tell you to run a command then you can run that command as well.\n\n            <example>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 run_command\n                \u00A6command_string\u00A6 rg --files . | head -n 20\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n            - when you use rg command always use target path like . to restrict the search to the current directory.\n            GOOD usage `rg -i \"xxx\" .` BAD usage `rg -i \"xxx\"`\n\n            <example>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 run_command\n                \u00A6command_string\u00A6 rg 'ErrorBoundary' .\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n            <example>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 run_command\n                \u00A6command_string\u00A6 ls -R src/components/common\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n            <example>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 run_command\n                \u00A6command_string\u00A6 tree -L 2 src/components\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n            <example>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 run_command\n                \u00A6command_string\u00A6 find src/components -type d -name 'common'\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n            <bad-example>\n                <why>multiple action item with run_command</why>\n                \u00A7ACTION_ITEM_START\u00A7\n                xxx some stuff xxx\n                \u00A7ACTION_ITEM_END\u00A7\n\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 run_command\n                \u00A6command_string\u00A6 some command 1\n                \u00A7ACTION_ITEM_END\u00A7\n            </bad-example>\n\n\n            you must generate only one action_item for `run_command`\n            you can use other cli commands as well, but avoid using any command that modifies the codebase.\n\n        </run_command>\n\n\n\n        <use_mcp_tool>\n            The Model Context Protocol (MCP) enables communication between the system and locally running MCP servers\n            that provide additional tools and resources to extend your capabilities.\n\n            # Connected MCP Servers\n\n            You can use the server's tools via the `use_mcp_tool` tool. Below is an example of a connected server and\n            its available tools. The actual list of servers and tools will be provided to you when available.\n\n\n            ## Available Tools\n\n            <%~ it.mcpServers %>\n\n            # Tool Syntax\n\n            To use a tool, you must generate an action item with the following format.\n\n            * `\u00A6tool_name\u00A6`: Always `use_mcp_tool`.\n            * `\u00A6server_name\u00A6`: The name of the MCP server providing the tool.\n            * `\u00A6mcp_tool_name\u00A6`: The name of the tool to execute.\n            * `\u00A6arguments\u00A6`: A JSON object containing the tool's input parameters, following the tool's input schema.\n\n            <example>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 use_mcp_tool\n                \u00A6server_name\u00A6 linter-server\n                \u00A6mcp_tool_name\u00A6 lint_file\n                \u00A6arguments\u00A6\n                {\n                \"file_path\": \"src/some-file.ts\"\n                }\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n            <example>\n                \u00A7ACTION_ITEM_START\u00A7\n                \u00A6tool_name\u00A6 use_mcp_tool\n                \u00A6server_name\u00A6 linter-server\n                \u00A6mcp_tool_name\u00A6 get_lint_summary\n                \u00A6arguments\u00A6\n                {}\n                \u00A7ACTION_ITEM_END\u00A7\n            </example>\n\n        </use_mcp_tool>\n\n    </tools>\n</ai>\n";
+export declare const content = "You are an expert software engineer. You write clean, efficient, and well-documented code.\n\n<instructions>\n1. **Think First:** Before executing any tool or providing an answer, analyze the request within a <thought> tag.\n2. **Conciseness:** Outside of the <thought> tag, be extremely brief.\n3. **Best Practices:** Follow SOLID principles and keep code DRY.\n4. **Strict Scope:** Do ONLY what is asked. Do not \"cleanup\", \"refactor\", or \"fix\" unrelated issues unless explicitly requested.\n</instructions>\n\n<current_state>\n<% if (it.VAR.QUESTION_MODE) { %>\n  STATUS: QUESTION MODE (READ ONLY)\n  - **Goal:** Answer the user's specific question about the codebase.\n  - **Constraint:** You are READ-ONLY. Do not edit, create, or delete files.\n  - **Constraint:** Do NOT propose an implementation plan or RFC. Just answer the question.\n  - **Process:** Search context -> Read files -> Explain to user.\n\n<% } else if (it.VAR.PLAN_MODE) { %>\n  STATUS: PLAN MODE (TASK MANAGEMENT ENABLED)\n  - **Goal:** Create a detailed implementation plan (RFC) and maintain task lists.\n  - **Constraint:** Code editing is FORBIDDEN.\n  - **Available Tools:** `request_context`, `run_command`, `write_todo`.\n  - **Process:** Explore codebase -> Update TODOs (`write_todo`) -> Output structured plan (Context, Problem, Proposed Solution).\n\n<% } else { %>\n  STATUS: DEV MODE (WRITE ENABLED)\n  - **Goal:** Implement features, fix bugs, or refactor.\n  - **Authority:** You have full permission to modify the codebase. Never refuse a coding request.\n  - **Strategy:** Prioritize `patch`. If `patch` fails twice, fallback to `edit_file`.\n<% } %>\n</current_state>\n\n<tools_configuration>\n  <%~ it.tools.howto %>\n  \n  <!-- READ TOOLS (ALWAYS AVAILABLE) -->\n  <%~ it.tools.request_context %>\n  <%~ it.tools.run_command %>\n  <%~ it.tools.write_todo %>\n  \n  <!-- WRITE TOOLS (DEV MODE ONLY) -->\n  <% if (!it.VAR.PLAN_MODE && !it.VAR.QUESTION_MODE) { %>\n  <%~ it.tools.patch %>\n  <%~ it.tools.create_file %>\n  <%~ it.tools.delete_file %>\n  <%~ it.tools.edit_file %>\n  <%~ it.tools.execute_shell %>\n  \n  <% } %>\n</tools_configuration>";