hanseol-dev 4.0.12

package/dist/tools/llm/simple/simple-tool-executor.js

@@ -0,0 +1,134 @@
+import { isLLMSimpleTool } from '../../types.js';
+import { getStreamLogger } from '../../../utils/json-stream-logger.js';
+let toolExecutionCallback = null;
+let toolResponseCallback = null;
+let planCreatedCallback = null;
+let todoStartCallback = null;
+let todoCompleteCallback = null;
+let todoFailCallback = null;
+let toolApprovalCallback = null;
+let compactCallback = null;
+let assistantResponseCallback = null;
+let reasoningCallback = null;
+export function setToolExecutionCallback(callback) {
+    toolExecutionCallback = callback;
+}
+export function setToolResponseCallback(callback) {
+    toolResponseCallback = callback;
+}
+export function setPlanCreatedCallback(callback) {
+    planCreatedCallback = callback;
+}
+export function setTodoStartCallback(callback) {
+    todoStartCallback = callback;
+}
+export function setTodoCompleteCallback(callback) {
+    todoCompleteCallback = callback;
+}
+export function setTodoFailCallback(callback) {
+    todoFailCallback = callback;
+}
+export function setToolApprovalCallback(callback) {
+    toolApprovalCallback = callback;
+}
+export function setCompactCallback(callback) {
+    compactCallback = callback;
+}
+export function setAssistantResponseCallback(callback) {
+    assistantResponseCallback = callback;
+}
+export function setReasoningCallback(callback) {
+    reasoningCallback = callback;
+}
+export function getToolExecutionCallback() {
+    return toolExecutionCallback;
+}
+export async function requestToolApproval(toolName, args, reason) {
+    if (!toolApprovalCallback) {
+        return null;
+    }
+    return toolApprovalCallback(toolName, args, reason);
+}
+export function emitPlanCreated(todoTitles) {
+    if (planCreatedCallback) {
+        planCreatedCallback(todoTitles);
+    }
+}
+export function emitTodoStart(title) {
+    if (todoStartCallback) {
+        todoStartCallback(title);
+    }
+}
+export function emitTodoComplete(title) {
+    if (todoCompleteCallback) {
+        todoCompleteCallback(title);
+    }
+}
+export function emitTodoFail(title) {
+    if (todoFailCallback) {
+        todoFailCallback(title);
+    }
+}
+export function emitCompact(originalCount, newCount) {
+    if (compactCallback) {
+        compactCallback(originalCount, newCount);
+    }
+}
+export function emitAssistantResponse(content) {
+    if (assistantResponseCallback && content && content.trim()) {
+        const thinkRegex = /<think>([\s\S]*?)<\/think>/g;
+        let thinkingContent = '';
+        let match;
+        while ((match = thinkRegex.exec(content)) !== null) {
+            if (match[1] && match[1].trim()) {
+                thinkingContent += match[1].trim() + '\n';
+            }
+        }
+        if (thinkingContent && reasoningCallback) {
+            reasoningCallback(thinkingContent.trim(), false);
+        }
+        const cleanedContent = content.replace(/<think>[\s\S]*?<\/think>/g, '').trim();
+        if (cleanedContent) {
+            assistantResponseCallback(cleanedContent);
+            const streamLogger = getStreamLogger();
+            streamLogger?.logAssistantResponse(cleanedContent);
+        }
+    }
+}
+export function emitReasoning(content, isStreaming = false) {
+    if (reasoningCallback && content && content.trim()) {
+        reasoningCallback(content, isStreaming);
+    }
+}
+export async function executeSimpleTool(toolName, args) {
+    const startTime = Date.now();
+    const logger = getStreamLogger();
+    const { toolRegistry } = await import('../../registry.js');
+    const tool = toolRegistry.get(toolName);
+    if (!tool || !isLLMSimpleTool(tool)) {
+        const error = `Unknown or not a simple tool: ${toolName}`;
+        logger?.logToolEnd(toolName, false, undefined, error, Date.now() - startTime);
+        return {
+            success: false,
+            error,
+        };
+    }
+    const reason = args['reason'];
+    logger?.logToolStart(toolName, args, reason);
+    if (toolExecutionCallback && reason) {
+        toolExecutionCallback(toolName, reason, args);
+    }
+    const result = await tool.execute(args);
+    const durationMs = Date.now() - startTime;
+    logger?.logToolEnd(toolName, result.success, result.success ? result.result : undefined, result.success ? undefined : result.error, durationMs);
+    const isTodoTool = ['update_todos', 'get_todo_list'].includes(toolName);
+    if (toolResponseCallback && !isTodoTool) {
+        const resultText = result.success
+            ? (result.result || '')
+            : (result.error || 'Unknown error');
+        toolResponseCallback(toolName, result.success, resultText);
+    }
+    return result;
+}
+export const executeFileTool = executeSimpleTool;
+//# sourceMappingURL=simple-tool-executor.js.map

package/dist/tools/llm/simple/simple-tool-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-tool-executor.js","sourceRoot":"","sources":["../../../../src/tools/llm/simple/simple-tool-executor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAc,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAMvE,IAAI,qBAAqB,GAAiC,IAAI,CAAC;AAM/D,IAAI,oBAAoB,GAAgC,IAAI,CAAC;AAM7D,IAAI,mBAAmB,GAA+B,IAAI,CAAC;AAM3D,IAAI,iBAAiB,GAA6B,IAAI,CAAC;AAMvD,IAAI,oBAAoB,GAAgC,IAAI,CAAC;AAM7D,IAAI,gBAAgB,GAA4B,IAAI,CAAC;AAYrD,IAAI,oBAAoB,GAAgC,IAAI,CAAC;AAM7D,IAAI,eAAe,GAA2B,IAAI,CAAC;AAMnD,IAAI,yBAAyB,GAAqC,IAAI,CAAC;AAMvE,IAAI,iBAAiB,GAA6B,IAAI,CAAC;AAMvD,MAAM,UAAU,wBAAwB,CAAC,QAAsC;IAC7E,qBAAqB,GAAG,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAqC;IAC3E,oBAAoB,GAAG,QAAQ,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAoC;IACzE,mBAAmB,GAAG,QAAQ,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAkC;IACrE,iBAAiB,GAAG,QAAQ,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAqC;IAC3E,oBAAoB,GAAG,QAAQ,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAiC;IACnE,gBAAgB,GAAG,QAAQ,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAqC;IAC3E,oBAAoB,GAAG,QAAQ,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgC;IACjE,eAAe,GAAG,QAAQ,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,QAA0C;IACrF,yBAAyB,GAAG,QAAQ,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAkC;IACrE,iBAAiB,GAAG,QAAQ,CAAC;AAC/B,CAAC;AAMD,MAAM,UAAU,wBAAwB;IACtC,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,IAA6B,EAC7B,MAAe;IAEf,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,oBAAoB,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAoB;IAClD,IAAI,mBAAmB,EAAE,CAAC;QACxB,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,iBAAiB,EAAE,CAAC;QACtB,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,oBAAoB,EAAE,CAAC;QACzB,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,gBAAgB,EAAE,CAAC;QACrB,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,aAAqB,EAAE,QAAgB;IACjE,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe;IAEnD,IAAI,yBAAyB,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAG3D,MAAM,UAAU,GAAG,6BAA6B,CAAC;QACjD,IAAI,eAAe,GAAG,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC;QACV,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnD,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBAChC,eAAe,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;YAC5C,CAAC;QACH,CAAC;QAGD,IAAI,eAAe,IAAI,iBAAiB,EAAE,CAAC;YACzC,iBAAiB,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;QAGD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAE/E,IAAI,cAAc,EAAE,CAAC;YACnB,yBAAyB,CAAC,cAAc,CAAC,CAAC;YAG1C,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;YACvC,YAAY,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,cAAuB,KAAK;IAEzE,IAAI,iBAAiB,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,IAA6B;IAE7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IAGjC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAExC,IAAI,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,iCAAiC,QAAQ,EAAE,CAAC;QAE1D,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;QAC9E,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK;SACN,CAAC;IACJ,CAAC;IAGD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAuB,CAAC;IAGpD,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAI7C,IAAI,qBAAqB,IAAI,MAAM,EAAE,CAAC;QACpC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAGD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAG1C,MAAM,EAAE,UAAU,CAChB,QAAQ,EACR,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EACzC,UAAU,CACX,CAAC;IAIF,MAAM,UAAU,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,oBAAoB,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO;YAC/B,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;YACvB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC;QACtC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAKD,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC"}

package/dist/tools/llm/simple/todo-tools.d.ts

@@ -0,0 +1,15 @@
+import { LLMSimpleTool } from '../../types.js';
+import { ToolDefinition } from '../../../types/index.js';
+export interface TodoInput {
+    id: string;
+    title: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'failed';
+}
+export type TodoWriteCallback = (todos: TodoInput[]) => Promise<boolean>;
+export declare function setTodoWriteCallback(callback: TodoWriteCallback): void;
+export declare function clearTodoCallbacks(): void;
+export declare const WriteTodosTool: LLMSimpleTool;
+export declare const TODO_TOOLS: LLMSimpleTool[];
+export declare function getTodoToolDefinitions(): ToolDefinition[];
+export default TODO_TOOLS;
+//# sourceMappingURL=todo-tools.d.ts.map

package/dist/tools/llm/simple/todo-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-tools.d.ts","sourceRoot":"","sources":["../../../../src/tools/llm/simple/todo-tools.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAA4B,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAMzD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC5D;AAMD,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAQzE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAGtE;AAKD,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAgJD,eAAO,MAAM,cAAc,EAAE,aAK5B,CAAC;AAKF,eAAO,MAAM,UAAU,iBAAmB,CAAC;AAK3C,wBAAgB,sBAAsB,IAAI,cAAc,EAAE,CAEzD;AAED,eAAe,UAAU,CAAC"}

package/dist/tools/llm/simple/todo-tools.js

@@ -0,0 +1,145 @@
+import { logger } from '../../../utils/logger.js';
+let todoWriteCallback = null;
+export function setTodoWriteCallback(callback) {
+    logger.flow('Setting TODO write callback');
+    todoWriteCallback = callback;
+}
+export function clearTodoCallbacks() {
+    logger.flow('Clearing TODO callbacks');
+    todoWriteCallback = null;
+}
+const WRITE_TODOS_DEFINITION = {
+    type: 'function',
+    function: {
+        name: 'write_todos',
+        description: `Replace the entire TODO list with a new list.
+
+Use this to:
+- Update TODO statuses (change status field)
+- Add new TODOs (include in the array)
+- Remove TODOs (omit from the array)
+- Reorder TODOs (change array order)
+
+IMPORTANT: You must include ALL TODOs you want to keep. Any TODO not in the array will be removed.
+
+Example - Mark first task complete, second in progress:
+{
+  "todos": [
+    { "id": "1", "title": "Setup project", "status": "completed" },
+    { "id": "2", "title": "Implement feature", "status": "in_progress" },
+    { "id": "3", "title": "Write tests", "status": "pending" }
+  ]
+}
+
+Example - Add a new task:
+{
+  "todos": [
+    { "id": "1", "title": "Existing task", "status": "completed" },
+    { "id": "2", "title": "New task I just added", "status": "pending" }
+  ]
+}`,
+        parameters: {
+            type: 'object',
+            properties: {
+                todos: {
+                    type: 'array',
+                    description: 'The complete TODO list (replaces existing list)',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            id: {
+                                type: 'string',
+                                description: 'Unique ID for the TODO',
+                            },
+                            title: {
+                                type: 'string',
+                                description: 'Short title describing the task',
+                            },
+                            status: {
+                                type: 'string',
+                                enum: ['pending', 'in_progress', 'completed', 'failed'],
+                                description: 'Current status of the TODO',
+                            },
+                        },
+                        required: ['id', 'title', 'status'],
+                    },
+                },
+            },
+            required: ['todos'],
+        },
+    },
+};
+async function executeWriteTodos(args) {
+    logger.enter('executeWriteTodos', args);
+    const todos = args['todos'];
+    if (!todos || !Array.isArray(todos)) {
+        logger.warn('Missing or invalid todos array');
+        return {
+            success: false,
+            error: 'Missing required parameter: todos array is required',
+        };
+    }
+    if (!todoWriteCallback) {
+        logger.warn('TODO write callback not set');
+        return {
+            success: false,
+            error: 'TODO management is not available in current context',
+        };
+    }
+    for (const todo of todos) {
+        if (!todo.id || !todo.title || !todo.status) {
+            return {
+                success: false,
+                error: `Invalid TODO item: each item must have id, title, and status`,
+            };
+        }
+        if (!['pending', 'in_progress', 'completed', 'failed'].includes(todo.status)) {
+            return {
+                success: false,
+                error: `Invalid status "${todo.status}" for TODO "${todo.id}"`,
+            };
+        }
+    }
+    try {
+        logger.flow(`Writing ${todos.length} TODOs`);
+        const success = await todoWriteCallback(todos);
+        if (success) {
+            const completed = todos.filter(t => t.status === 'completed').length;
+            const inProgress = todos.filter(t => t.status === 'in_progress').length;
+            const pending = todos.filter(t => t.status === 'pending').length;
+            const failed = todos.filter(t => t.status === 'failed').length;
+            const summary = `TODO list updated (${todos.length} items): ${completed} completed, ${inProgress} in progress, ${pending} pending, ${failed} failed`;
+            logger.exit('executeWriteTodos', { success: true, count: todos.length });
+            return {
+                success: true,
+                result: summary,
+                metadata: { todoCount: todos.length, completed, inProgress, pending, failed },
+            };
+        }
+        else {
+            return {
+                success: false,
+                error: 'Failed to update TODO list',
+            };
+        }
+    }
+    catch (error) {
+        logger.error('Error writing TODOs', error);
+        return {
+            success: false,
+            error: `Error writing TODOs: ${error instanceof Error ? error.message : 'Unknown error'}`,
+        };
+    }
+}
+export const WriteTodosTool = {
+    definition: WRITE_TODOS_DEFINITION,
+    execute: executeWriteTodos,
+    categories: ['llm-simple'],
+    description: 'Write/replace entire TODO list',
+};
+export const TODO_TOOLS = [WriteTodosTool];
+export function getTodoToolDefinitions() {
+    return TODO_TOOLS.map(tool => tool.definition);
+}
+export default TODO_TOOLS;
+//# sourceMappingURL=todo-tools.js.map

package/dist/tools/llm/simple/todo-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-tools.js","sourceRoot":"","sources":["../../../../src/tools/llm/simple/todo-tools.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAkBlD,IAAI,iBAAiB,GAA6B,IAAI,CAAC;AAKvD,MAAM,UAAU,oBAAoB,CAAC,QAA2B;IAC9D,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC3C,iBAAiB,GAAG,QAAQ,CAAC;AAC/B,CAAC;AAKD,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACvC,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC;AAMD,MAAM,sBAAsB,GAAmB;IAC7C,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;EAyBf;QACE,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,iDAAiD;oBAC9D,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE;gCACF,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,wBAAwB;6BACtC;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,iCAAiC;6BAC/C;4BACD,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,CAAC;gCACvD,WAAW,EAAE,4BAA4B;6BAC1C;yBACF;wBACD,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC;qBACpC;iBACF;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;CACF,CAAC;AAKF,KAAK,UAAU,iBAAiB,CAAC,IAA6B;IAC5D,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAgB,CAAC;IAE3C,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC9C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,qDAAqD;SAC7D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,qDAAqD;SAC7D,CAAC;IACJ,CAAC;IAGD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,8DAA8D;aACtE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,mBAAmB,IAAI,CAAC,MAAM,eAAe,IAAI,CAAC,EAAE,GAAG;aAC/D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE/C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;YACrE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM,CAAC;YACxE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;YACjE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;YAE/D,MAAM,OAAO,GAAG,sBAAsB,KAAK,CAAC,MAAM,YAAY,SAAS,eAAe,UAAU,iBAAiB,OAAO,aAAa,MAAM,SAAS,CAAC;YAErJ,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACzE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE;aAC9E,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,4BAA4B;aACpC,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAc,CAAC,CAAC;QACpD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;SAC1F,CAAC;IACJ,CAAC;AACH,CAAC;AAKD,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,UAAU,EAAE,sBAAsB;IAClC,OAAO,EAAE,iBAAiB;IAC1B,UAAU,EAAE,CAAC,YAAY,CAAmB;IAC5C,WAAW,EAAE,gCAAgC;CAC9C,CAAC;AAKF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,cAAc,CAAC,CAAC;AAK3C,MAAM,UAAU,sBAAsB;IACpC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED,eAAe,UAAU,CAAC"}

package/dist/tools/llm/simple/user-interaction-tools.d.ts

@@ -0,0 +1,22 @@
+import { LLMSimpleTool } from '../../types.js';
+type TellToUserCallback = (message: string) => void;
+export declare function setTellToUserCallback(callback: TellToUserCallback | null): void;
+export declare const tellToUserTool: LLMSimpleTool;
+export interface AskUserRequest {
+    question: string;
+    options: string[];
+}
+export interface AskUserResponse {
+    selectedOption: string;
+    isOther: boolean;
+    customText?: string;
+}
+export type AskUserCallback = (request: AskUserRequest) => Promise<AskUserResponse>;
+export declare function setAskUserCallback(callback: AskUserCallback): void;
+export declare function clearAskUserCallback(): void;
+export declare function hasAskUserCallback(): boolean;
+export declare const askToUserTool: LLMSimpleTool;
+export declare const USER_INTERACTION_TOOLS: LLMSimpleTool[];
+export declare const USER_TOOLS: LLMSimpleTool[];
+export default USER_INTERACTION_TOOLS;
+//# sourceMappingURL=user-interaction-tools.d.ts.map

package/dist/tools/llm/simple/user-interaction-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-interaction-tools.d.ts","sourceRoot":"","sources":["../../../../src/tools/llm/simple/user-interaction-tools.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAA4B,MAAM,gBAAgB,CAAC;AAWzE,KAAK,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAMpD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAE/E;AAiDD,eAAO,MAAM,cAAc,EAAE,aAK5B,CAAC;AASF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAKD,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAOpF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAGlE;AAKD,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C;AAKD,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAwHD,eAAO,MAAM,aAAa,EAAE,aAK3B,CAAC;AASF,eAAO,MAAM,sBAAsB,EAAE,aAAa,EAGjD,CAAC;AAKF,eAAO,MAAM,UAAU,EAAE,aAAa,EAA2B,CAAC;AAElE,eAAe,sBAAsB,CAAC"}

package/dist/tools/llm/simple/user-interaction-tools.js

@@ -0,0 +1,168 @@
+import { logger } from '../../../utils/logger.js';
+let tellToUserCallback = null;
+export function setTellToUserCallback(callback) {
+    tellToUserCallback = callback;
+}
+const TELL_TO_USER_DEFINITION = {
+    type: 'function',
+    function: {
+        name: 'tell_to_user',
+        description: `Send a message directly to the user to explain what you're doing or provide status updates.
+Use this tool to communicate with the user during task execution.
+The message will be displayed immediately in the UI.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                message: {
+                    type: 'string',
+                    description: `A natural, conversational message for the user (in user's language).
+Examples:
+- "Analyzing the files, please wait a moment"
+- "Found the config file! Let me modify it now"
+- "Ran the tests and 2 failed. Let me find the cause"
+- "Almost done, wrapping up the work"`,
+                },
+            },
+            required: ['message'],
+        },
+    },
+};
+async function executeTellToUser(args) {
+    const message = args['message'];
+    if (tellToUserCallback) {
+        tellToUserCallback(message);
+    }
+    return {
+        success: true,
+        result: `Message sent to user: ${message}`,
+    };
+}
+export const tellToUserTool = {
+    definition: TELL_TO_USER_DEFINITION,
+    execute: executeTellToUser,
+    categories: ['llm-simple'],
+    description: 'Send message to user',
+};
+let askUserCallback = null;
+export function setAskUserCallback(callback) {
+    logger.flow('Setting ask-user callback');
+    askUserCallback = callback;
+}
+export function clearAskUserCallback() {
+    logger.flow('Clearing ask-user callback');
+    askUserCallback = null;
+}
+export function hasAskUserCallback() {
+    return askUserCallback !== null;
+}
+const ASK_TO_USER_DEFINITION = {
+    type: 'function',
+    function: {
+        name: 'ask_to_user',
+        description: `Ask the user a question with multiple choice options.
+
+Use this tool when you need to:
+- Clarify ambiguous requirements
+- Get user preferences or decisions
+- Confirm important actions before proceeding
+- Offer multiple implementation approaches
+
+The user will always have an "Other (custom input)" option to provide custom input,
+so you only need to provide the main choices.
+
+RULES:
+- Provide 2-4 clear, distinct options
+- Each option should be a viable choice
+- Keep the question concise and specific
+- "Other" option is automatically added for custom input`,
+        parameters: {
+            type: 'object',
+            properties: {
+                question: {
+                    type: 'string',
+                    description: 'The question to ask the user. Should be clear and specific.',
+                },
+                options: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'List of main options for the user to choose from. Provide 2-4 options. An "Other" option for custom input is automatically added.',
+                    minItems: 2,
+                    maxItems: 4,
+                },
+            },
+            required: ['question', 'options'],
+        },
+    },
+};
+async function executeAskToUser(args) {
+    logger.enter('executeAskToUser', args);
+    const question = args['question'];
+    const options = args['options'];
+    if (!question || typeof question !== 'string') {
+        logger.warn('Invalid question parameter');
+        return {
+            success: false,
+            error: 'Invalid question: must be a non-empty string',
+        };
+    }
+    if (!Array.isArray(options) || options.length < 2) {
+        logger.warn('Invalid options parameter', { optionsLength: options?.length });
+        return {
+            success: false,
+            error: 'Invalid options: must be an array with at least 2 items',
+        };
+    }
+    if (options.length > 4) {
+        logger.warn('Too many options', { optionsLength: options.length });
+        return {
+            success: false,
+            error: 'Too many options: maximum 4 options allowed',
+        };
+    }
+    if (!askUserCallback) {
+        logger.warn('Ask-user callback not set');
+        return {
+            success: false,
+            error: 'User interaction is not available in current context',
+        };
+    }
+    try {
+        logger.flow('Asking user question');
+        const response = await askUserCallback({ question, options });
+        logger.debug('User responded', { selectedOption: response.selectedOption, isOther: response.isOther });
+        const resultText = response.isOther && response.customText
+            ? `User provided custom response: "${response.customText}"`
+            : `User selected: "${response.selectedOption}"`;
+        logger.exit('executeAskToUser', { success: true });
+        return {
+            success: true,
+            result: resultText,
+            metadata: {
+                question,
+                selectedOption: response.selectedOption,
+                isOther: response.isOther,
+                customText: response.customText,
+            },
+        };
+    }
+    catch (error) {
+        logger.error('Error asking user', error);
+        return {
+            success: false,
+            error: `Error asking user: ${error instanceof Error ? error.message : 'Unknown error'}`,
+        };
+    }
+}
+export const askToUserTool = {
+    definition: ASK_TO_USER_DEFINITION,
+    execute: executeAskToUser,
+    categories: ['llm-simple'],
+    description: 'Ask user a question with options',
+};
+export const USER_INTERACTION_TOOLS = [
+    tellToUserTool,
+    askToUserTool,
+];
+export const USER_TOOLS = USER_INTERACTION_TOOLS;
+export default USER_INTERACTION_TOOLS;
+//# sourceMappingURL=user-interaction-tools.js.map

package/dist/tools/llm/simple/user-interaction-tools.js.map

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