@hibanacloud/core 0.3.15

package/dist/src/tools/task.test.js

@@ -0,0 +1,369 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { TaskTool } from './task.js';
+import { SubagentManager } from '../subagents/subagent-manager.js';
+import { SubagentTerminateMode, } from '../subagents/types.js';
+import { ContextState } from '../subagents/subagent.js';
+import { partToString } from '../utils/partUtils.js';
+// Mock dependencies
+vi.mock('../subagents/subagent-manager.js');
+vi.mock('../subagents/subagent.js');
+const MockedSubagentManager = vi.mocked(SubagentManager);
+const MockedContextState = vi.mocked(ContextState);
+describe('TaskTool', () => {
+    let config;
+    let taskTool;
+    let mockSubagentManager;
+    let changeListeners;
+    const mockSubagents = [
+        {
+            name: 'file-search',
+            description: 'Specialized agent for searching and analyzing files',
+            systemPrompt: 'You are a file search specialist.',
+            level: 'project',
+            filePath: '/project/.qwen/agents/file-search.md',
+        },
+        {
+            name: 'code-review',
+            description: 'Agent for reviewing code quality and best practices',
+            systemPrompt: 'You are a code review specialist.',
+            level: 'user',
+            filePath: '/home/user/.qwen/agents/code-review.md',
+        },
+    ];
+    beforeEach(async () => {
+        // Setup fake timers
+        vi.useFakeTimers();
+        // Create mock config
+        config = {
+            getProjectRoot: vi.fn().mockReturnValue('/test/project'),
+            getSessionId: vi.fn().mockReturnValue('test-session-id'),
+            getSubagentManager: vi.fn(),
+            getGeminiClient: vi.fn().mockReturnValue(undefined),
+        };
+        changeListeners = [];
+        // Setup SubagentManager mock
+        mockSubagentManager = {
+            listSubagents: vi.fn().mockResolvedValue(mockSubagents),
+            loadSubagent: vi.fn(),
+            createSubagentScope: vi.fn(),
+            addChangeListener: vi.fn((listener) => {
+                changeListeners.push(listener);
+                return () => {
+                    const index = changeListeners.indexOf(listener);
+                    if (index >= 0) {
+                        changeListeners.splice(index, 1);
+                    }
+                };
+            }),
+        };
+        MockedSubagentManager.mockImplementation(() => mockSubagentManager);
+        // Make config return the mock SubagentManager
+        vi.mocked(config.getSubagentManager).mockReturnValue(mockSubagentManager);
+        // Create TaskTool instance
+        taskTool = new TaskTool(config);
+        // Allow async initialization to complete
+        await vi.runAllTimersAsync();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    describe('initialization', () => {
+        it('should initialize with correct name and properties', () => {
+            expect(taskTool.name).toBe('task');
+            expect(taskTool.displayName).toBe('Task');
+            expect(taskTool.kind).toBe('other');
+        });
+        it('should load available subagents during initialization', () => {
+            expect(mockSubagentManager.listSubagents).toHaveBeenCalled();
+        });
+        it('should subscribe to subagent manager changes', () => {
+            expect(mockSubagentManager.addChangeListener).toHaveBeenCalledTimes(1);
+        });
+        it('should update description with available subagents', () => {
+            expect(taskTool.description).toContain('file-search');
+            expect(taskTool.description).toContain('Specialized agent for searching and analyzing files');
+            expect(taskTool.description).toContain('code-review');
+            expect(taskTool.description).toContain('Agent for reviewing code quality and best practices');
+        });
+        it('should handle empty subagents list gracefully', async () => {
+            vi.mocked(mockSubagentManager.listSubagents).mockResolvedValue([]);
+            const emptyTaskTool = new TaskTool(config);
+            await vi.runAllTimersAsync();
+            expect(emptyTaskTool.description).toContain('No subagents are currently configured');
+        });
+        it('should handle subagent loading errors gracefully', async () => {
+            vi.mocked(mockSubagentManager.listSubagents).mockRejectedValue(new Error('Loading failed'));
+            const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+            new TaskTool(config);
+            await vi.runAllTimersAsync();
+            expect(consoleSpy).toHaveBeenCalledWith('Failed to load subagents for Task tool:', expect.any(Error));
+            consoleSpy.mockRestore();
+        });
+    });
+    describe('schema generation', () => {
+        it('should generate schema with subagent names as enum', () => {
+            const schema = taskTool.schema;
+            const properties = schema.parametersJsonSchema;
+            expect(properties.properties.subagent_type.enum).toEqual([
+                'file-search',
+                'code-review',
+            ]);
+        });
+        it('should generate schema without enum when no subagents available', async () => {
+            vi.mocked(mockSubagentManager.listSubagents).mockResolvedValue([]);
+            const emptyTaskTool = new TaskTool(config);
+            await vi.runAllTimersAsync();
+            const schema = emptyTaskTool.schema;
+            const properties = schema.parametersJsonSchema;
+            expect(properties.properties.subagent_type.enum).toBeUndefined();
+        });
+    });
+    describe('validateToolParams', () => {
+        const validParams = {
+            description: 'Search files',
+            prompt: 'Find all TypeScript files in the project',
+            subagent_type: 'file-search',
+        };
+        it('should validate valid parameters', async () => {
+            const result = taskTool.validateToolParams(validParams);
+            expect(result).toBeNull();
+        });
+        it('should reject empty description', async () => {
+            const result = taskTool.validateToolParams({
+                ...validParams,
+                description: '',
+            });
+            expect(result).toBe('Parameter "description" must be a non-empty string.');
+        });
+        it('should reject empty prompt', async () => {
+            const result = taskTool.validateToolParams({
+                ...validParams,
+                prompt: '',
+            });
+            expect(result).toBe('Parameter "prompt" must be a non-empty string.');
+        });
+        it('should reject empty subagent_type', async () => {
+            const result = taskTool.validateToolParams({
+                ...validParams,
+                subagent_type: '',
+            });
+            expect(result).toBe('Parameter "subagent_type" must be a non-empty string.');
+        });
+        it('should reject non-existent subagent', async () => {
+            const result = taskTool.validateToolParams({
+                ...validParams,
+                subagent_type: 'non-existent',
+            });
+            expect(result).toBe('Subagent "non-existent" not found. Available subagents: file-search, code-review');
+        });
+    });
+    describe('refreshSubagents', () => {
+        it('should refresh when change listener fires', async () => {
+            const newSubagents = [
+                {
+                    name: 'new-agent',
+                    description: 'A brand new agent',
+                    systemPrompt: 'Do new things.',
+                    level: 'project',
+                    filePath: '/project/.qwen/agents/new-agent.md',
+                },
+            ];
+            vi.mocked(mockSubagentManager.listSubagents).mockResolvedValueOnce(newSubagents);
+            const listener = changeListeners[0];
+            expect(listener).toBeDefined();
+            listener?.();
+            await vi.runAllTimersAsync();
+            expect(taskTool.description).toContain('new-agent');
+            expect(taskTool.description).toContain('A brand new agent');
+        });
+        it('should refresh available subagents and update description', async () => {
+            const newSubagents = [
+                {
+                    name: 'test-agent',
+                    description: 'A test agent',
+                    systemPrompt: 'Test prompt',
+                    level: 'project',
+                    filePath: '/project/.qwen/agents/test-agent.md',
+                },
+            ];
+            vi.mocked(mockSubagentManager.listSubagents).mockResolvedValue(newSubagents);
+            await taskTool.refreshSubagents();
+            expect(taskTool.description).toContain('test-agent');
+            expect(taskTool.description).toContain('A test agent');
+        });
+    });
+    describe('TaskToolInvocation', () => {
+        let mockSubagentScope;
+        let mockContextState;
+        beforeEach(() => {
+            mockSubagentScope = {
+                runNonInteractive: vi.fn().mockResolvedValue(undefined),
+                result: 'Task completed successfully',
+                terminateMode: SubagentTerminateMode.GOAL,
+                getFinalText: vi.fn().mockReturnValue('Task completed successfully'),
+                formatCompactResult: vi
+                    .fn()
+                    .mockReturnValue('✅ Success: Search files completed with GOAL termination'),
+                getExecutionSummary: vi.fn().mockReturnValue({
+                    rounds: 2,
+                    totalDurationMs: 1500,
+                    totalToolCalls: 3,
+                    successfulToolCalls: 3,
+                    failedToolCalls: 0,
+                    successRate: 100,
+                    inputTokens: 1000,
+                    outputTokens: 500,
+                    totalTokens: 1500,
+                    estimatedCost: 0.045,
+                    toolUsage: [
+                        {
+                            name: 'grep',
+                            count: 2,
+                            success: 2,
+                            failure: 0,
+                            totalDurationMs: 800,
+                            averageDurationMs: 400,
+                        },
+                        {
+                            name: 'read_file',
+                            count: 1,
+                            success: 1,
+                            failure: 0,
+                            totalDurationMs: 200,
+                            averageDurationMs: 200,
+                        },
+                    ],
+                }),
+                getStatistics: vi.fn().mockReturnValue({
+                    rounds: 2,
+                    totalDurationMs: 1500,
+                    totalToolCalls: 3,
+                    successfulToolCalls: 3,
+                    failedToolCalls: 0,
+                }),
+                getTerminateMode: vi.fn().mockReturnValue(SubagentTerminateMode.GOAL),
+            };
+            mockContextState = {
+                set: vi.fn(),
+            };
+            MockedContextState.mockImplementation(() => mockContextState);
+            vi.mocked(mockSubagentManager.loadSubagent).mockResolvedValue(mockSubagents[0]);
+            vi.mocked(mockSubagentManager.createSubagentScope).mockResolvedValue(mockSubagentScope);
+        });
+        it('should execute subagent successfully', async () => {
+            const params = {
+                description: 'Search files',
+                prompt: 'Find all TypeScript files',
+                subagent_type: 'file-search',
+            };
+            const invocation = taskTool.createInvocation(params);
+            const result = await invocation.execute();
+            expect(mockSubagentManager.loadSubagent).toHaveBeenCalledWith('file-search');
+            expect(mockSubagentManager.createSubagentScope).toHaveBeenCalledWith(mockSubagents[0], config, expect.any(Object));
+            expect(mockSubagentScope.runNonInteractive).toHaveBeenCalledWith(mockContextState, undefined);
+            const llmText = partToString(result.llmContent);
+            expect(llmText).toBe('Task completed successfully');
+            const display = result.returnDisplay;
+            expect(display.type).toBe('task_execution');
+            expect(display.status).toBe('completed');
+            expect(display.subagentName).toBe('file-search');
+        });
+        it('should handle subagent not found error', async () => {
+            vi.mocked(mockSubagentManager.loadSubagent).mockResolvedValue(null);
+            const params = {
+                description: 'Search files',
+                prompt: 'Find all TypeScript files',
+                subagent_type: 'non-existent',
+            };
+            const invocation = taskTool.createInvocation(params);
+            const result = await invocation.execute();
+            const llmText = partToString(result.llmContent);
+            expect(llmText).toContain('Subagent "non-existent" not found');
+            const display = result.returnDisplay;
+            expect(display.status).toBe('failed');
+            expect(display.subagentName).toBe('non-existent');
+        });
+        it('should handle execution errors gracefully', async () => {
+            vi.mocked(mockSubagentManager.createSubagentScope).mockRejectedValue(new Error('Creation failed'));
+            const params = {
+                description: 'Search files',
+                prompt: 'Find all TypeScript files',
+                subagent_type: 'file-search',
+            };
+            const invocation = taskTool.createInvocation(params);
+            const result = await invocation.execute();
+            const llmText = partToString(result.llmContent);
+            expect(llmText).toContain('Failed to run subagent: Creation failed');
+            const display = result.returnDisplay;
+            expect(display.status).toBe('failed');
+        });
+        it('should execute subagent without live output callback', async () => {
+            const params = {
+                description: 'Search files',
+                prompt: 'Find all TypeScript files',
+                subagent_type: 'file-search',
+            };
+            const invocation = taskTool.createInvocation(params);
+            const result = await invocation.execute();
+            // Verify that the task completed successfully
+            expect(result.llmContent).toBeDefined();
+            expect(result.returnDisplay).toBeDefined();
+            // Verify the result has the expected structure
+            const text = partToString(result.llmContent);
+            expect(text).toBe('Task completed successfully');
+            const display = result.returnDisplay;
+            expect(display.status).toBe('completed');
+            expect(display.subagentName).toBe('file-search');
+        });
+        it('should set context variables correctly', async () => {
+            const params = {
+                description: 'Search files',
+                prompt: 'Find all TypeScript files',
+                subagent_type: 'file-search',
+            };
+            const invocation = taskTool.createInvocation(params);
+            await invocation.execute();
+            expect(mockContextState.set).toHaveBeenCalledWith('task_prompt', 'Find all TypeScript files');
+        });
+        it('should return structured display object', async () => {
+            const params = {
+                description: 'Search files',
+                prompt: 'Find all TypeScript files',
+                subagent_type: 'file-search',
+            };
+            const invocation = taskTool.createInvocation(params);
+            const result = await invocation.execute();
+            expect(typeof result.returnDisplay).toBe('object');
+            expect(result.returnDisplay).toHaveProperty('type', 'task_execution');
+            expect(result.returnDisplay).toHaveProperty('subagentName', 'file-search');
+            expect(result.returnDisplay).toHaveProperty('taskDescription', 'Search files');
+            expect(result.returnDisplay).toHaveProperty('status', 'completed');
+        });
+        it('should not require confirmation', async () => {
+            const params = {
+                description: 'Search files',
+                prompt: 'Find all TypeScript files',
+                subagent_type: 'file-search',
+            };
+            const invocation = taskTool.createInvocation(params);
+            const shouldConfirm = await invocation.shouldConfirmExecute();
+            expect(shouldConfirm).toBe(false);
+        });
+        it('should provide correct description', async () => {
+            const params = {
+                description: 'Search files',
+                prompt: 'Find all TypeScript files',
+                subagent_type: 'file-search',
+            };
+            const invocation = taskTool.createInvocation(params);
+            const description = invocation.getDescription();
+            expect(description).toBe('file-search subagent: "Search files"');
+        });
+    });
+});
+//# sourceMappingURL=task.test.js.map

package/dist/src/tools/task.test.js.map

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

package/dist/src/tools/todoWrite.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ToolResult } from './tools.js';
+import { BaseDeclarativeTool, BaseToolInvocation } from './tools.js';
+import type { Config } from '../config/config.js';
+export interface TodoItem {
+    id: string;
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed';
+}
+export interface TodoWriteParams {
+    todos: TodoItem[];
+    modified_by_user?: boolean;
+    modified_content?: string;
+}
+declare class TodoWriteToolInvocation extends BaseToolInvocation<TodoWriteParams, ToolResult> {
+    private readonly config;
+    private operationType;
+    constructor(config: Config, params: TodoWriteParams, operationType?: 'create' | 'update');
+    getDescription(): string;
+    shouldConfirmExecute(_abortSignal: AbortSignal): Promise<false>;
+    execute(_signal: AbortSignal): Promise<ToolResult>;
+}
+/**
+ * Utility function to read todos for a specific session (useful for session recovery)
+ */
+export declare function readTodosForSession(sessionId?: string): Promise<TodoItem[]>;
+/**
+ * Utility function to list all todo files in the todos directory
+ */
+export declare function listTodoSessions(): Promise<string[]>;
+export declare class TodoWriteTool extends BaseDeclarativeTool<TodoWriteParams, ToolResult> {
+    private readonly config;
+    static readonly Name: string;
+    constructor(config: Config);
+    validateToolParams(params: TodoWriteParams): string | null;
+    protected createInvocation(params: TodoWriteParams): TodoWriteToolInvocation;
+}
+export {};