aiexecode 1.0.157

package/src/tools/todo_write.js

@@ -0,0 +1,182 @@
+import { uiEvents } from '../system/ui_events.js';
+import { createDebugLogger } from '../util/debug_log.js';
+import { theme } from '../frontend/design/themeColors.js';
+import { updateCurrentTodos } from '../system/session_memory.js';
+
+const debugLog = createDebugLogger('todo_write.log', 'todo_write');
+
+/**
+ * Todo 관리 도구
+ * 현재 코딩 세션의 작업 목록을 생성하고 관리합니다.
+ */
+
+/**
+ * Todo 리스트를 업데이트합니다
+ * @param {Object} params - 매개변수 객체
+ * @param {Array} params.todos - Todo 항목 배열
+ * @returns {Promise<Object>} 결과 객체
+ */
+export async function todo_write({ todos }) {
+    debugLog('========== todo_write START ==========');
+    debugLog(`Input todos count: ${todos?.length || 0}`);
+
+    try {
+        // todos 배열 유효성 검증
+        if (!Array.isArray(todos)) {
+            debugLog('ERROR: todos is not an array');
+            debugLog('========== todo_write ERROR END ==========');
+            return {
+                operation_successful: false,
+                error_message: 'todos must be an array'
+            };
+        }
+
+        // 각 todo 항목 검증
+        for (let i = 0; i < todos.length; i++) {
+            const todo = todos[i];
+            debugLog(`Validating todo ${i + 1}/${todos.length}:`);
+            debugLog(`  content: "${todo.content}"`);
+            debugLog(`  status: "${todo.status}"`);
+            debugLog(`  activeForm: "${todo.activeForm}"`);
+
+            if (!todo.content || typeof todo.content !== 'string') {
+                debugLog(`ERROR: todo ${i + 1} has invalid content`);
+                return {
+                    operation_successful: false,
+                    error_message: `Todo ${i + 1} has invalid content (must be a non-empty string)`
+                };
+            }
+
+            if (!todo.status || !['pending', 'in_progress', 'completed'].includes(todo.status)) {
+                debugLog(`ERROR: todo ${i + 1} has invalid status`);
+                return {
+                    operation_successful: false,
+                    error_message: `Todo ${i + 1} has invalid status (must be 'pending', 'in_progress', or 'completed')`
+                };
+            }
+
+            if (!todo.activeForm || typeof todo.activeForm !== 'string') {
+                debugLog(`ERROR: todo ${i + 1} has invalid activeForm`);
+                return {
+                    operation_successful: false,
+                    error_message: `Todo ${i + 1} has invalid activeForm (must be a non-empty string)`
+                };
+            }
+        }
+
+        // in_progress 상태가 정확히 하나인지 검증
+        const inProgressCount = todos.filter(t => t.status === 'in_progress').length;
+        debugLog(`in_progress count: ${inProgressCount}`);
+
+        if (inProgressCount !== 1) {
+            debugLog(`WARNING: Expected exactly 1 in_progress todo, found ${inProgressCount}`);
+            // 경고만 하고 계속 진행 (유연성을 위해)
+        }
+
+        // 세션 메모리에 todos 저장
+        debugLog('Saving todos to session memory...');
+        updateCurrentTodos(todos);
+        debugLog('Todos saved to session memory');
+
+        // UI 이벤트로 todo 업데이트 전달
+        debugLog('Emitting todo update event...');
+        uiEvents.updateTodos(todos);
+        debugLog('Todo update event emitted');
+
+        debugLog('========== todo_write SUCCESS END ==========');
+
+        return {
+            operation_successful: true,
+            todos_count: todos.length,
+            todos: todos,
+            in_progress_count: inProgressCount,
+            pending_count: todos.filter(t => t.status === 'pending').length,
+            completed_count: todos.filter(t => t.status === 'completed').length
+        };
+
+    } catch (error) {
+        debugLog(`========== todo_write EXCEPTION ==========`);
+        debugLog(`Exception caught: ${error.message}`);
+        debugLog(`Stack trace: ${error.stack}`);
+        debugLog('========== todo_write EXCEPTION END ==========');
+
+        return {
+            operation_successful: false,
+            error_message: error.message
+        };
+    }
+}
+
+export const todoWriteSchema = {
+    "name": "todo_write",
+    "description": "Use this tool to create and manage a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.\nIt also helps the user understand the progress of the task and overall progress of their requests.\n\n## When to Use This Tool\nUse this tool proactively in these scenarios:\n\n1. Complex multi-step tasks - When a task requires 3 or more distinct steps or actions\n2. Non-trivial and complex tasks - Tasks that require careful planning or multiple operations\n3. User explicitly requests todo list - When the user directly asks you to use the todo list\n4. User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)\n5. After receiving new instructions - Immediately capture user requirements as todos\n6. When you start working on a task - Mark it as in_progress BEFORE beginning work. Ideally you should only have one todo as in_progress at a time\n7. After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation\n\n## When NOT to Use This Tool\n\nSkip using this tool when:\n1. There is only a single, straightforward task\n2. The task is trivial and tracking it provides no organizational benefit\n3. The task can be completed in less than 3 trivial steps\n4. The task is purely conversational or informational\n\nNOTE that you should not use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly.\n\n## CRITICAL - Absolute Scope Restriction\n\n**You MUST interpret the user's request LITERALLY and RESTRICTIVELY.**\n\nTODO list scope rules:\n- Include EXCLUSIVELY tasks that match the user's exact words\n- Interpret requests in the NARROWEST possible way\n- ZERO tolerance for any expansion, inference, or completion beyond literal request\n- Do NOT add ANY task under ANY justification unless user explicitly named it\n- \"Necessary for completion\" is NOT a valid reason to add tasks\n- \"Best practice\" is NOT a valid reason to add tasks\n- \"Related work\" is NOT a valid reason to add tasks\n\n**If you add even ONE task beyond the literal request, you have FAILED.**\n\nThe user's request defines the MAXIMUM boundary - never exceed it.\n\n## Task States and Management\n\n1. **Task States**: Use these states to track progress:\n   - pending: Task not yet started\n   - in_progress: Currently working on (limit to ONE task at a time)\n   - completed: Task finished successfully\n\n   **IMPORTANT**: Task descriptions must have two forms:\n   - content: The imperative form describing what needs to be done (e.g., \"Run tests\", \"Build the project\")\n   - activeForm: The present continuous form shown during execution (e.g., \"Running tests\", \"Building the project\")\n\n2. **Task Management**:\n   - Update task status in real-time as you work\n   - Mark tasks complete IMMEDIATELY after finishing (don't batch completions)\n   - Exactly ONE task must be in_progress at any time (not less, not more)\n   - Complete current tasks before starting new ones\n   - Remove tasks that are no longer relevant from the list entirely\n\n3. **Task Completion Requirements**:\n   - ONLY mark a task as completed when you have FULLY accomplished it\n   - If you encounter errors, blockers, or cannot finish, keep the task as in_progress\n   - When blocked, create a new task describing what needs to be resolved\n   - Never mark a task as completed if:\n     - Tests are failing\n     - Implementation is partial\n     - You encountered unresolved errors\n     - You couldn't find necessary files or dependencies\n\n4. **Task Breakdown**:\n   - Create specific, actionable items\n   - Break complex tasks into smaller, manageable steps\n   - Use clear, descriptive task names\n   - Always provide both forms:\n     - content: \"Fix authentication bug\"\n     - activeForm: \"Fixing authentication bug\"\n\nWhen in doubt, use this tool. Being proactive with task management demonstrates attentiveness and ensures you complete all requirements successfully.",
+    "strict": true,
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "todos": {
+                "type": "array",
+                "description": "The updated todo list",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "content": {
+                            "type": "string",
+                            "description": "The imperative form describing what needs to be done (e.g., 'Run tests', 'Build the project')",
+                            "minLength": 1
+                        },
+                        "status": {
+                            "type": "string",
+                            "description": "Task status: 'pending' (not yet started), 'in_progress' (currently working on), or 'completed' (finished successfully)",
+                            "enum": ["pending", "in_progress", "completed"]
+                        },
+                        "activeForm": {
+                            "type": "string",
+                            "description": "The present continuous form shown during execution (e.g., 'Running tests', 'Building the project')",
+                            "minLength": 1
+                        }
+                    },
+                    "required": ["content", "status", "activeForm"],
+                    "additionalProperties": false
+                }
+            }
+        },
+        "required": ["todos"],
+        "additionalProperties": false
+    },
+    "ui_display": {
+        "show_tool_call": true,
+        "show_tool_result": true,
+        "display_name": "Todo",
+        "format_tool_call": (args) => {
+            const todos = args.todos || [];
+            const inProgress = todos.filter(t => t.status === 'in_progress').length;
+            const completed = todos.filter(t => t.status === 'completed').length;
+            const pending = todos.filter(t => t.status === 'pending').length;
+            return `(${todos.length} tasks: ${completed} done, ${inProgress} active, ${pending} pending)`;
+        },
+        "format_tool_result": (result) => {
+            if (result.operation_successful) {
+                const total = result.todos_count || 0;
+                const completed = result.completed_count || 0;
+                const inProgress = result.in_progress_count || 0;
+                const pending = result.pending_count || 0;
+                return {
+                    type: 'formatted',
+                    parts: [
+                        { text: 'Updated ', style: {} },
+                        { text: String(total), style: { color: theme.brand.light, bold: true } },
+                        { text: ` task${total !== 1 ? 's' : ''} `, style: {} },
+                        { text: `(${completed} done, ${inProgress} active, ${pending} pending)`, style: { color: theme.text.dim } }
+                    ]
+                };
+            }
+            return result.error_message || 'Error updating todos';
+        }
+    }
+};
+
+// 함수 맵 - 문자열로 함수 호출 가능
+export const TODO_WRITE_FUNCTIONS = {
+    'todo_write': todo_write
+};

package/src/tools/web_download.py

@@ -0,0 +1,74 @@
+#!/usr/bin/env python3
+import requests
+import os
+from markitdown import MarkItDown
+from urllib.parse import urljoin, urlparse
+import json
+import sys
+
+def fetch_and_convert(url, timeout=30, user_agent='Mozilla/5.0 (compatible; WebFetcher/1.0)', encoding='utf-8'):
+    try:
+        # 요청 헤더 설정
+        headers = {
+            'User-Agent': user_agent,
+            'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+            'Accept-Language': 'en-US,en;q=0.5',
+            'Accept-Encoding': 'gzip, deflate',
+            'Connection': 'keep-alive',
+        }
+
+        # 웹 페이지 다운로드
+        print(f"Fetching: {url}", file=sys.stderr)
+        response = requests.get(url, headers=headers, timeout=timeout)
+        response.raise_for_status()
+
+        # 콘텐츠 타입 확인
+        content_type = response.headers.get('content-type', '').lower()
+        print(f"Content-Type: {content_type}", file=sys.stderr)
+
+        # HTML 콘텐츠 임시 저장
+        import tempfile
+        with tempfile.NamedTemporaryFile(mode='w', suffix='.html', encoding=encoding, delete=False) as temp_file:
+            temp_html_path = temp_file.name
+            temp_file.write(response.text)
+
+        # MarkItDown으로 변환
+        md = MarkItDown()
+        print("Converting to markdown...", file=sys.stderr)
+        result = md.convert(temp_html_path)
+
+        # 임시 파일 삭제
+        os.remove(temp_html_path)
+
+        # 마크다운 내용 생성
+        markdown_content = f"# {result.title or 'Web Page'}\n\n"
+        markdown_content += f"**Original URL**: {url}\n"
+        markdown_content += f"**Fetched**: {response.headers.get('date', 'Unknown')}\n"
+        markdown_content += f"**Content-Type**: {content_type}\n\n"
+        markdown_content += "---\n\n"
+        markdown_content += result.text_content
+
+        # stdout으로 출력
+        print(markdown_content)
+        print(f"Successfully fetched and converted: {url}", file=sys.stderr)
+        return True
+
+    except requests.RequestException as e:
+        print(f"Network error: {e}", file=sys.stderr)
+        return False
+    except Exception as e:
+        print(f"Conversion error: {e}", file=sys.stderr)
+        return False
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python web_download.py <url> [timeout] [user_agent] [encoding]", file=sys.stderr)
+        sys.exit(1)
+
+    url = sys.argv[1]
+    timeout = int(sys.argv[2]) if len(sys.argv) > 2 else 30
+    user_agent = sys.argv[3] if len(sys.argv) > 3 else 'Mozilla/5.0 (compatible; WebFetcher/1.0)'
+    encoding = sys.argv[4] if len(sys.argv) > 4 else 'utf-8'
+
+    success = fetch_and_convert(url, timeout, user_agent, encoding)
+    sys.exit(0 if success else 1)

package/src/tools/web_downloader.js

@@ -0,0 +1,83 @@
+import { execPythonCode } from "../system/code_executer.js";
+import { safeReadFile } from '../util/safe_fs.js';
+import { join } from 'path';
+import { theme } from '../frontend/design/themeColors.js';
+
+// 이 파일은 웹 페이지를 가져와서 텍스트 형식으로 변환하는 도구를 제공합니다.
+// 외부 참고 자료가 필요한 미션일 때 Orchestrator가 지식을 확보하고 Verifier가 근거를 남길 수 있게 보조합니다.
+
+/**
+ * 웹 페이지 가져오기 도구
+ * 웹 페이지를 가져와서 읽기 쉬운 텍스트 형식으로 변환합니다.
+ * MarkItDown 라이브러리를 활용하여 고품질의 변환을 제공합니다.
+ */
+
+/**
+ * 웹 페이지를 가져와서 텍스트 형식으로 변환합니다
+ * @param {Object} params - 매개변수 객체
+ * @param {string} params.url - 가져올 웹 페이지 URL
+ * @returns {Promise<{operation_successful: boolean, url: string, content: string, error_message: string|null}>} 결과 객체
+ */
+export async function fetch_web_page({ url }) {
+    const timeout = 30;
+    const user_agent = 'Mozilla/5.0 (compatible; WebFetcher/1.0)';
+    const encoding = 'utf-8';
+    const pythonCode = await safeReadFile(join(process.app_custom?.__dirname || process.cwd(), 'src', 'tools', 'web_download.py'), 'utf8');
+    const result = await execPythonCode(pythonCode, [url, timeout, user_agent, encoding]);
+
+    return {
+        operation_successful: result.code === 0,
+        url: url,
+        content: result.code === 0 ? result.stdout : '',
+        error_message: result.code === 0 ? null : result.stderr || 'Fetch operation failed'
+    };
+}
+
+// 함수 스키마
+export const fetchWebPageSchema = {
+    "name": "fetch_web_page",
+    "description": "Fetches a web page and converts it to readable text format for reference purposes. Returns the content directly.",
+    "strict": true,
+    "parameters": {
+        "type": "object",
+        "required": ["url"],
+        "properties": {
+            "url": {
+                "type": "string",
+                "description": "URL of the web page to fetch"
+            }
+        },
+        "additionalProperties": false
+    },
+    "ui_display": {
+        "show_tool_call": true,
+        "show_tool_result": true,
+        "display_name": "Fetch",
+        "format_tool_call": (args) => {
+            const url = args.url || '';
+            const shortened = url.length > 50 ? url.substring(0, 47) + '...' : url;
+            return `(${shortened})`;
+        },
+        "format_tool_result": (result) => {
+            if (result.operation_successful) {
+                const contentLength = result.content?.length || 0;
+                return {
+                    type: 'formatted',
+                    parts: [
+                        { text: 'Fetched ', style: {} },
+                        { text: String(contentLength), style: { color: theme.brand.light, bold: true } },
+                        { text: ' characters', style: {} }
+                    ]
+                };
+            }
+            return result.error_message || 'Fetch failed';
+        }
+    }
+};
+
+// 함수 맵 - 문자열로 함수 호출 가능
+export const WEB_DOWNLOADER_FUNCTIONS = {
+    'fetch_web_page': fetch_web_page
+};
+
+// 도구 메타데이터

package/src/util/clone.js

@@ -0,0 +1,174 @@
+/**
+ * 깊은 복사 유틸리티
+ * JSON.parse(JSON.stringify()) 패턴을 대체하는 안전한 깊은 복사 함수들을 제공합니다.
+ */
+
+/**
+ * 값을 깊은 복사합니다.
+ * - 순환 참조를 감지하고 처리합니다.
+ * - Date, RegExp 등의 특수 객체를 올바르게 복사합니다.
+ * - undefined, function, Symbol은 복사되지 않습니다 (JSON.stringify와 동일).
+ *
+ * @param {*} value - 복사할 값
+ * @param {WeakMap} [visited] - 순환 참조 감지용 (내부 사용)
+ * @returns {*} 깊은 복사된 값
+ */
+export function deepClone(value, visited = new WeakMap()) {
+    // 기본 타입은 그대로 반환
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+
+    // 순환 참조 감지
+    if (visited.has(value)) {
+        return visited.get(value);
+    }
+
+    // Date 객체 처리
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+
+    // RegExp 객체 처리
+    if (value instanceof RegExp) {
+        return new RegExp(value.source, value.flags);
+    }
+
+    // Map 객체 처리
+    if (value instanceof Map) {
+        const clonedMap = new Map();
+        visited.set(value, clonedMap);
+        for (const [key, val] of value) {
+            clonedMap.set(deepClone(key, visited), deepClone(val, visited));
+        }
+        return clonedMap;
+    }
+
+    // Set 객체 처리
+    if (value instanceof Set) {
+        const clonedSet = new Set();
+        visited.set(value, clonedSet);
+        for (const val of value) {
+            clonedSet.add(deepClone(val, visited));
+        }
+        return clonedSet;
+    }
+
+    // 배열 처리
+    if (Array.isArray(value)) {
+        const clonedArray = [];
+        visited.set(value, clonedArray);
+        for (let i = 0; i < value.length; i++) {
+            clonedArray[i] = deepClone(value[i], visited);
+        }
+        return clonedArray;
+    }
+
+    // 일반 객체 처리
+    const clonedObj = {};
+    visited.set(value, clonedObj);
+
+    for (const key of Object.keys(value)) {
+        const val = value[key];
+        // undefined와 function은 스킵 (JSON.stringify 동작과 일치)
+        if (val !== undefined && typeof val !== 'function') {
+            clonedObj[key] = deepClone(val, visited);
+        }
+    }
+
+    return clonedObj;
+}
+
+/**
+ * JSON 직렬화 가능한 값만 깊은 복사합니다.
+ * JSON.parse(JSON.stringify())와 동일한 동작이지만 에러 처리가 추가되었습니다.
+ *
+ * @param {*} value - 복사할 값
+ * @param {*} [fallback] - 복사 실패 시 반환할 기본값 (기본: null)
+ * @returns {*} 깊은 복사된 값 또는 fallback
+ */
+export function jsonClone(value, fallback = null) {
+    try {
+        return JSON.parse(JSON.stringify(value));
+    } catch (error) {
+        return fallback;
+    }
+}
+
+/**
+ * 얕은 복사를 수행합니다.
+ * 첫 번째 레벨만 복사하고 중첩된 객체는 참조를 유지합니다.
+ *
+ * @param {*} value - 복사할 값
+ * @returns {*} 얕은 복사된 값
+ */
+export function shallowClone(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+
+    if (Array.isArray(value)) {
+        return [...value];
+    }
+
+    return { ...value };
+}
+
+/**
+ * 두 객체를 깊은 병합합니다.
+ * target에 source의 값을 병합합니다 (source가 우선).
+ *
+ * @param {Object} target - 대상 객체
+ * @param {Object} source - 소스 객체
+ * @returns {Object} 병합된 새 객체
+ */
+export function deepMerge(target, source) {
+    if (source === null || typeof source !== 'object') {
+        return source;
+    }
+
+    if (target === null || typeof target !== 'object') {
+        return deepClone(source);
+    }
+
+    if (Array.isArray(source)) {
+        return deepClone(source);
+    }
+
+    const result = { ...target };
+
+    for (const key of Object.keys(source)) {
+        const sourceValue = source[key];
+        const targetValue = target[key];
+
+        if (
+            sourceValue !== null &&
+            typeof sourceValue === 'object' &&
+            !Array.isArray(sourceValue) &&
+            targetValue !== null &&
+            typeof targetValue === 'object' &&
+            !Array.isArray(targetValue)
+        ) {
+            result[key] = deepMerge(targetValue, sourceValue);
+        } else {
+            result[key] = deepClone(sourceValue);
+        }
+    }
+
+    return result;
+}
+
+/**
+ * 객체가 깊은 복사 가능한지 (JSON 직렬화 가능한지) 검사합니다.
+ *
+ * @param {*} value - 검사할 값
+ * @returns {boolean} JSON 직렬화 가능하면 true
+ */
+export function isCloneable(value) {
+    try {
+        JSON.stringify(value);
+        return true;
+    } catch {
+        return false;
+    }
+}