mirror of
https://github.com/google-gemini/gemini-cli.git
synced 2026-08-10 00:47:16 -07:00
feat(core,cli): implement task tracker tools and feature flag (Phase 2)
This commit is contained in:
Anjali Sridhar
@@ -0,0 +1,563 @@
|
||||
/**
|
||||
* @license
|
||||
* Copyright 2026 Google LLC
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*/
|
||||
|
||||
import type { Config } from '../config/config.js';
|
||||
import type { MessageBus } from '../confirmation-bus/message-bus.js';
|
||||
import {
|
||||
TRACKER_ADD_DEPENDENCY_DEFINITION,
|
||||
TRACKER_CREATE_TASK_DEFINITION,
|
||||
TRACKER_GET_TASK_DEFINITION,
|
||||
TRACKER_INIT_DEFINITION,
|
||||
TRACKER_LIST_TASKS_DEFINITION,
|
||||
TRACKER_UPDATE_TASK_DEFINITION,
|
||||
TRACKER_VISUALIZE_DEFINITION,
|
||||
} from './definitions/trackerTools.js';
|
||||
import { resolveToolDeclaration } from './definitions/resolver.js';
|
||||
import {
|
||||
TRACKER_ADD_DEPENDENCY_TOOL_NAME,
|
||||
TRACKER_CREATE_TASK_TOOL_NAME,
|
||||
TRACKER_GET_TASK_TOOL_NAME,
|
||||
TRACKER_INIT_TOOL_NAME,
|
||||
TRACKER_LIST_TASKS_TOOL_NAME,
|
||||
TRACKER_UPDATE_TASK_TOOL_NAME,
|
||||
TRACKER_VISUALIZE_TOOL_NAME,
|
||||
} from './tool-names.js';
|
||||
import type { ToolResult } from './tools.js';
|
||||
import { BaseDeclarativeTool, BaseToolInvocation, Kind } from './tools.js';
|
||||
import { ToolErrorType } from './tool-error.js';
|
||||
import type {
|
||||
TrackerTask,
|
||||
TaskStatus,
|
||||
TaskType,
|
||||
} from '../services/trackerTypes.js';
|
||||
|
||||
// --- Shared Base ---
|
||||
|
||||
abstract class BaseTrackerInvocation<
|
||||
P extends object,
|
||||
R extends ToolResult,
|
||||
> extends BaseToolInvocation<P, R> {
|
||||
constructor(
|
||||
protected readonly config: Config,
|
||||
params: P,
|
||||
messageBus: MessageBus,
|
||||
toolName: string,
|
||||
) {
|
||||
super(params, messageBus, toolName);
|
||||
}
|
||||
|
||||
protected get service() {
|
||||
return this.config.getTrackerService();
|
||||
}
|
||||
|
||||
abstract override getDescription(): string;
|
||||
}
|
||||
|
||||
// --- tracker_init ---
|
||||
|
||||
class TrackerInitInvocation extends BaseTrackerInvocation<
|
||||
Record<string, never>,
|
||||
ToolResult
|
||||
> {
|
||||
getDescription(): string {
|
||||
return 'Initializing the task tracker storage.';
|
||||
}
|
||||
|
||||
override async execute(_signal: AbortSignal): Promise<ToolResult> {
|
||||
await this.service.ensureInitialized();
|
||||
return {
|
||||
llmContent:
|
||||
'Task tracker initialized successfully. Storage is ready at .tracker/tasks/',
|
||||
returnDisplay: 'Tracker initialized.',
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
export class TrackerInitTool extends BaseDeclarativeTool<
|
||||
Record<string, never>,
|
||||
ToolResult
|
||||
> {
|
||||
static readonly Name = TRACKER_INIT_TOOL_NAME;
|
||||
constructor(
|
||||
private config: Config,
|
||||
messageBus: MessageBus,
|
||||
) {
|
||||
super(
|
||||
TrackerInitTool.Name,
|
||||
'Initialize Tracker',
|
||||
TRACKER_INIT_DEFINITION.base.description!,
|
||||
Kind.Edit,
|
||||
TRACKER_INIT_DEFINITION.base.parametersJsonSchema,
|
||||
messageBus,
|
||||
);
|
||||
}
|
||||
protected createInvocation(
|
||||
params: Record<string, never>,
|
||||
messageBus: MessageBus,
|
||||
) {
|
||||
return new TrackerInitInvocation(
|
||||
this.config,
|
||||
params,
|
||||
messageBus,
|
||||
this.name,
|
||||
);
|
||||
}
|
||||
override getSchema(modelId?: string) {
|
||||
return resolveToolDeclaration(TRACKER_INIT_DEFINITION, modelId);
|
||||
}
|
||||
}
|
||||
|
||||
// --- tracker_create_task ---
|
||||
|
||||
interface CreateTaskParams {
|
||||
title: string;
|
||||
description: string;
|
||||
type: TaskType;
|
||||
parentId?: string;
|
||||
dependencies?: string[];
|
||||
}
|
||||
|
||||
class TrackerCreateTaskInvocation extends BaseTrackerInvocation<
|
||||
CreateTaskParams,
|
||||
ToolResult
|
||||
> {
|
||||
getDescription(): string {
|
||||
return `Creating task: ${this.params.title}`;
|
||||
}
|
||||
|
||||
override async execute(_signal: AbortSignal): Promise<ToolResult> {
|
||||
const task = await this.service.createTask({
|
||||
title: this.params.title,
|
||||
description: this.params.description,
|
||||
type: this.params.type,
|
||||
status: 'open',
|
||||
parentId: this.params.parentId,
|
||||
dependencies: this.params.dependencies ?? [],
|
||||
});
|
||||
return {
|
||||
llmContent: `Created task ${task.id}: ${task.title}`,
|
||||
returnDisplay: `Created task ${task.id}.`,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
export class TrackerCreateTaskTool extends BaseDeclarativeTool<
|
||||
CreateTaskParams,
|
||||
ToolResult
|
||||
> {
|
||||
static readonly Name = TRACKER_CREATE_TASK_TOOL_NAME;
|
||||
constructor(
|
||||
private config: Config,
|
||||
messageBus: MessageBus,
|
||||
) {
|
||||
super(
|
||||
TrackerCreateTaskTool.Name,
|
||||
'Create Task',
|
||||
TRACKER_CREATE_TASK_DEFINITION.base.description!,
|
||||
Kind.Edit,
|
||||
TRACKER_CREATE_TASK_DEFINITION.base.parametersJsonSchema,
|
||||
messageBus,
|
||||
);
|
||||
}
|
||||
protected createInvocation(params: CreateTaskParams, messageBus: MessageBus) {
|
||||
return new TrackerCreateTaskInvocation(
|
||||
this.config,
|
||||
params,
|
||||
messageBus,
|
||||
this.name,
|
||||
);
|
||||
}
|
||||
override getSchema(modelId?: string) {
|
||||
return resolveToolDeclaration(TRACKER_CREATE_TASK_DEFINITION, modelId);
|
||||
}
|
||||
}
|
||||
|
||||
// --- tracker_update_task ---
|
||||
|
||||
interface UpdateTaskParams {
|
||||
id: string;
|
||||
title?: string;
|
||||
description?: string;
|
||||
status?: TaskStatus;
|
||||
dependencies?: string[];
|
||||
}
|
||||
|
||||
class TrackerUpdateTaskInvocation extends BaseTrackerInvocation<
|
||||
UpdateTaskParams,
|
||||
ToolResult
|
||||
> {
|
||||
getDescription(): string {
|
||||
return `Updating task ${this.params.id}`;
|
||||
}
|
||||
|
||||
override async execute(_signal: AbortSignal): Promise<ToolResult> {
|
||||
const { id, ...updates } = this.params;
|
||||
try {
|
||||
const task = await this.service.updateTask(id, updates);
|
||||
return {
|
||||
llmContent: `Updated task ${task.id}. Status: ${task.status}`,
|
||||
returnDisplay: `Updated task ${task.id}.`,
|
||||
};
|
||||
} catch (error) {
|
||||
const errorMessage =
|
||||
error instanceof Error ? error.message : String(error);
|
||||
return {
|
||||
llmContent: `Error updating task: ${errorMessage}`,
|
||||
returnDisplay: 'Failed to update task.',
|
||||
error: {
|
||||
message: errorMessage,
|
||||
type: ToolErrorType.EXECUTION_FAILED,
|
||||
},
|
||||
};
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export class TrackerUpdateTaskTool extends BaseDeclarativeTool<
|
||||
UpdateTaskParams,
|
||||
ToolResult
|
||||
> {
|
||||
static readonly Name = TRACKER_UPDATE_TASK_TOOL_NAME;
|
||||
constructor(
|
||||
private config: Config,
|
||||
messageBus: MessageBus,
|
||||
) {
|
||||
super(
|
||||
TrackerUpdateTaskTool.Name,
|
||||
'Update Task',
|
||||
TRACKER_UPDATE_TASK_DEFINITION.base.description!,
|
||||
Kind.Edit,
|
||||
TRACKER_UPDATE_TASK_DEFINITION.base.parametersJsonSchema,
|
||||
messageBus,
|
||||
);
|
||||
}
|
||||
protected createInvocation(params: UpdateTaskParams, messageBus: MessageBus) {
|
||||
return new TrackerUpdateTaskInvocation(
|
||||
this.config,
|
||||
params,
|
||||
messageBus,
|
||||
this.name,
|
||||
);
|
||||
}
|
||||
override getSchema(modelId?: string) {
|
||||
return resolveToolDeclaration(TRACKER_UPDATE_TASK_DEFINITION, modelId);
|
||||
}
|
||||
}
|
||||
|
||||
// --- tracker_get_task ---
|
||||
|
||||
interface GetTaskParams {
|
||||
id: string;
|
||||
}
|
||||
|
||||
class TrackerGetTaskInvocation extends BaseTrackerInvocation<
|
||||
GetTaskParams,
|
||||
ToolResult
|
||||
> {
|
||||
getDescription(): string {
|
||||
return `Retrieving task ${this.params.id}`;
|
||||
}
|
||||
|
||||
override async execute(_signal: AbortSignal): Promise<ToolResult> {
|
||||
const task = await this.service.getTask(this.params.id);
|
||||
if (!task) {
|
||||
return {
|
||||
llmContent: `Task ${this.params.id} not found.`,
|
||||
returnDisplay: 'Task not found.',
|
||||
};
|
||||
}
|
||||
return {
|
||||
llmContent: JSON.stringify(task, null, 2),
|
||||
returnDisplay: `Retrieved task ${task.id}.`,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
export class TrackerGetTaskTool extends BaseDeclarativeTool<
|
||||
GetTaskParams,
|
||||
ToolResult
|
||||
> {
|
||||
static readonly Name = TRACKER_GET_TASK_TOOL_NAME;
|
||||
constructor(
|
||||
private config: Config,
|
||||
messageBus: MessageBus,
|
||||
) {
|
||||
super(
|
||||
TrackerGetTaskTool.Name,
|
||||
'Get Task',
|
||||
TRACKER_GET_TASK_DEFINITION.base.description!,
|
||||
Kind.Read,
|
||||
TRACKER_GET_TASK_DEFINITION.base.parametersJsonSchema,
|
||||
messageBus,
|
||||
);
|
||||
}
|
||||
protected createInvocation(params: GetTaskParams, messageBus: MessageBus) {
|
||||
return new TrackerGetTaskInvocation(
|
||||
this.config,
|
||||
params,
|
||||
messageBus,
|
||||
this.name,
|
||||
);
|
||||
}
|
||||
override getSchema(modelId?: string) {
|
||||
return resolveToolDeclaration(TRACKER_GET_TASK_DEFINITION, modelId);
|
||||
}
|
||||
}
|
||||
|
||||
// --- tracker_list_tasks ---
|
||||
|
||||
interface ListTasksParams {
|
||||
status?: TaskStatus;
|
||||
type?: TaskType;
|
||||
parentId?: string;
|
||||
}
|
||||
|
||||
class TrackerListTasksInvocation extends BaseTrackerInvocation<
|
||||
ListTasksParams,
|
||||
ToolResult
|
||||
> {
|
||||
getDescription(): string {
|
||||
return 'Listing tasks.';
|
||||
}
|
||||
|
||||
override async execute(_signal: AbortSignal): Promise<ToolResult> {
|
||||
let tasks = await this.service.listTasks();
|
||||
if (this.params.status) {
|
||||
tasks = tasks.filter((t) => t.status === this.params.status);
|
||||
}
|
||||
if (this.params.type) {
|
||||
tasks = tasks.filter((t) => t.type === this.params.type);
|
||||
}
|
||||
if (this.params.parentId) {
|
||||
tasks = tasks.filter((t) => t.parentId === this.params.parentId);
|
||||
}
|
||||
|
||||
if (tasks.length === 0) {
|
||||
return {
|
||||
llmContent: 'No tasks found matching the criteria.',
|
||||
returnDisplay: 'No matching tasks.',
|
||||
};
|
||||
}
|
||||
|
||||
const content = tasks
|
||||
.map((t) => `- [${t.id}] ${t.title} (${t.status})`)
|
||||
.join('\n');
|
||||
return {
|
||||
llmContent: content,
|
||||
returnDisplay: `Listed ${tasks.length} tasks.`,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
export class TrackerListTasksTool extends BaseDeclarativeTool<
|
||||
ListTasksParams,
|
||||
ToolResult
|
||||
> {
|
||||
static readonly Name = TRACKER_LIST_TASKS_TOOL_NAME;
|
||||
constructor(
|
||||
private config: Config,
|
||||
messageBus: MessageBus,
|
||||
) {
|
||||
super(
|
||||
TrackerListTasksTool.Name,
|
||||
'List Tasks',
|
||||
TRACKER_LIST_TASKS_DEFINITION.base.description!,
|
||||
Kind.Search,
|
||||
TRACKER_LIST_TASKS_DEFINITION.base.parametersJsonSchema,
|
||||
messageBus,
|
||||
);
|
||||
}
|
||||
protected createInvocation(params: ListTasksParams, messageBus: MessageBus) {
|
||||
return new TrackerListTasksInvocation(
|
||||
this.config,
|
||||
params,
|
||||
messageBus,
|
||||
this.name,
|
||||
);
|
||||
}
|
||||
override getSchema(modelId?: string) {
|
||||
return resolveToolDeclaration(TRACKER_LIST_TASKS_DEFINITION, modelId);
|
||||
}
|
||||
}
|
||||
|
||||
// --- tracker_add_dependency ---
|
||||
|
||||
interface AddDependencyParams {
|
||||
taskId: string;
|
||||
dependencyId: string;
|
||||
}
|
||||
|
||||
class TrackerAddDependencyInvocation extends BaseTrackerInvocation<
|
||||
AddDependencyParams,
|
||||
ToolResult
|
||||
> {
|
||||
getDescription(): string {
|
||||
return `Adding dependency: ${this.params.taskId} depends on ${this.params.dependencyId}`;
|
||||
}
|
||||
|
||||
override async execute(_signal: AbortSignal): Promise<ToolResult> {
|
||||
const task = await this.service.getTask(this.params.taskId);
|
||||
if (!task) {
|
||||
return {
|
||||
llmContent: `Task ${this.params.taskId} not found.`,
|
||||
returnDisplay: 'Task not found.',
|
||||
};
|
||||
}
|
||||
const dep = await this.service.getTask(this.params.dependencyId);
|
||||
if (!dep) {
|
||||
return {
|
||||
llmContent: `Dependency task ${this.params.dependencyId} not found.`,
|
||||
returnDisplay: 'Dependency not found.',
|
||||
};
|
||||
}
|
||||
|
||||
const newDeps = Array.from(
|
||||
new Set([...task.dependencies, this.params.dependencyId]),
|
||||
);
|
||||
try {
|
||||
await this.service.updateTask(task.id, { dependencies: newDeps });
|
||||
return {
|
||||
llmContent: `Linked ${task.id} -> ${dep.id}.`,
|
||||
returnDisplay: 'Dependency added.',
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
llmContent: `Error adding dependency: ${
|
||||
error instanceof Error ? error.message : String(error)
|
||||
}`,
|
||||
returnDisplay: 'Failed to add dependency.',
|
||||
};
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export class TrackerAddDependencyTool extends BaseDeclarativeTool<
|
||||
AddDependencyParams,
|
||||
ToolResult
|
||||
> {
|
||||
static readonly Name = TRACKER_ADD_DEPENDENCY_TOOL_NAME;
|
||||
constructor(
|
||||
private config: Config,
|
||||
messageBus: MessageBus,
|
||||
) {
|
||||
super(
|
||||
TrackerAddDependencyTool.Name,
|
||||
'Add Dependency',
|
||||
TRACKER_ADD_DEPENDENCY_DEFINITION.base.description!,
|
||||
Kind.Edit,
|
||||
TRACKER_ADD_DEPENDENCY_DEFINITION.base.parametersJsonSchema,
|
||||
messageBus,
|
||||
);
|
||||
}
|
||||
protected createInvocation(
|
||||
params: AddDependencyParams,
|
||||
messageBus: MessageBus,
|
||||
) {
|
||||
return new TrackerAddDependencyInvocation(
|
||||
this.config,
|
||||
params,
|
||||
messageBus,
|
||||
this.name,
|
||||
);
|
||||
}
|
||||
override getSchema(modelId?: string) {
|
||||
return resolveToolDeclaration(TRACKER_ADD_DEPENDENCY_DEFINITION, modelId);
|
||||
}
|
||||
}
|
||||
|
||||
// --- tracker_visualize ---
|
||||
|
||||
class TrackerVisualizeInvocation extends BaseTrackerInvocation<
|
||||
Record<string, never>,
|
||||
ToolResult
|
||||
> {
|
||||
getDescription(): string {
|
||||
return 'Visualizing the task graph.';
|
||||
}
|
||||
|
||||
override async execute(_signal: AbortSignal): Promise<ToolResult> {
|
||||
const tasks = await this.service.listTasks();
|
||||
if (tasks.length === 0) {
|
||||
return {
|
||||
llmContent: 'No tasks to visualize.',
|
||||
returnDisplay: 'Empty tracker.',
|
||||
};
|
||||
}
|
||||
|
||||
const statusEmojis: Record<TaskStatus, string> = {
|
||||
open: '⭕',
|
||||
in_progress: '🚧',
|
||||
blocked: '🚫',
|
||||
closed: '✅',
|
||||
};
|
||||
|
||||
const typeLabels: Record<TaskType, string> = {
|
||||
epic: '[EPIC]',
|
||||
task: '[TASK]',
|
||||
bug: '[BUG]',
|
||||
};
|
||||
|
||||
// Simple list-based visualization for now (can enhance to tree later if needed)
|
||||
// We'll organize by epic/parent
|
||||
const roots = tasks.filter((t) => !t.parentId);
|
||||
let output = 'Task Tracker Graph:\n';
|
||||
|
||||
const renderTask = (task: TrackerTask, depth: number) => {
|
||||
const indent = ' '.repeat(depth);
|
||||
output += `${indent}${statusEmojis[task.status]} ${task.id} ${typeLabels[task.type]} ${task.title}\n`;
|
||||
if (task.dependencies.length > 0) {
|
||||
output += `${indent} └─ Depends on: ${task.dependencies.join(', ')}\n`;
|
||||
}
|
||||
const children = tasks.filter((t) => t.parentId === task.id);
|
||||
for (const child of children) {
|
||||
renderTask(child, depth + 1);
|
||||
}
|
||||
};
|
||||
|
||||
for (const root of roots) {
|
||||
renderTask(root, 0);
|
||||
}
|
||||
|
||||
return {
|
||||
llmContent: output,
|
||||
returnDisplay: 'Graph rendered.',
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
export class TrackerVisualizeTool extends BaseDeclarativeTool<
|
||||
Record<string, never>,
|
||||
ToolResult
|
||||
> {
|
||||
static readonly Name = TRACKER_VISUALIZE_TOOL_NAME;
|
||||
constructor(
|
||||
private config: Config,
|
||||
messageBus: MessageBus,
|
||||
) {
|
||||
super(
|
||||
TrackerVisualizeTool.Name,
|
||||
'Visualize Tracker',
|
||||
TRACKER_VISUALIZE_DEFINITION.base.description!,
|
||||
Kind.Read,
|
||||
TRACKER_VISUALIZE_DEFINITION.base.parametersJsonSchema,
|
||||
messageBus,
|
||||
);
|
||||
}
|
||||
protected createInvocation(
|
||||
params: Record<string, never>,
|
||||
messageBus: MessageBus,
|
||||
) {
|
||||
return new TrackerVisualizeInvocation(
|
||||
this.config,
|
||||
params,
|
||||
messageBus,
|
||||
this.name,
|
||||
);
|
||||
}
|
||||
override getSchema(modelId?: string) {
|
||||
return resolveToolDeclaration(TRACKER_VISUALIZE_DEFINITION, modelId);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user