@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

package/dist/src/tools/todo-read.js

@@ -0,0 +1,98 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseTool, Kind } from './tools.js';
+import { TodoStore } from './todo-store.js';
+import { Type } from '@google/genai';
+import { TodoReminderService } from '../utils/todoReminderService.js';
+import { formatTodoListForDisplay } from '../utils/todoFormatter.js';
+export class TodoRead extends BaseTool {
+    todoService;
+    static Name = 'todo_read';
+    reminderService = new TodoReminderService();
+    constructor(todoService) {
+        super(TodoRead.Name, 'TodoRead', 'Read the current todo list for the session. Returns all todos with their status and content.', Kind.Think, {
+            type: Type.OBJECT,
+            properties: {},
+        }, true, // isOutputMarkdown
+        false);
+        this.todoService = todoService;
+    }
+    getDescription(_params) {
+        return 'Read current todo list';
+    }
+    async execute(_params, _signal, _updateOutput) {
+        // Get session and agent IDs from context
+        const sessionId = this.context?.sessionId ?? 'default';
+        const agentId = this.context?.agentId;
+        const store = this.todoService?.getTodoStore(this.context);
+        const rawTodos = store?.readTodos
+            ? await store.readTodos()
+            : store?.getTodos
+                ? store.getTodos()
+                : await new TodoStore(sessionId, agentId).readTodos();
+        const todos = rawTodos;
+        const paused = store?.readPausedState
+            ? await store.readPausedState()
+            : false;
+        const output = formatTodoListForDisplay(todos) +
+            (paused ? '\\n\\nAI execution is paused.' : '');
+        if (todos.length === 0) {
+            const isComplexTask = false;
+            const reminder = this.reminderService.getReminderForEmptyTodos(isComplexTask);
+            return {
+                llmContent: output +
+                    // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty reminder string should not be concatenated
+                    (reminder || ''),
+                returnDisplay: output,
+            };
+        }
+        // Calculate metadata
+        const statistics = this.calculateStatistics(todos);
+        const suggestedAction = this.determineSuggestedAction(todos);
+        return {
+            llmContent: output,
+            returnDisplay: output,
+            metadata: {
+                totalTasks: todos.length,
+                statistics,
+                suggestedAction,
+            },
+        };
+    }
+    calculateStatistics(todos) {
+        return {
+            total: todos.length,
+            inProgress: todos.filter((t) => t.status === 'in_progress').length,
+            pending: todos.filter((t) => t.status === 'pending').length,
+            completed: todos.filter((t) => t.status === 'completed').length,
+        };
+    }
+    determineSuggestedAction(todos) {
+        // Check if any tasks are in progress - return first one (preserves LLM order)
+        const inProgressTasks = todos.filter((t) => t.status === 'in_progress');
+        if (inProgressTasks.length > 0) {
+            const task = inProgressTasks[0];
+            return {
+                type: 'continue',
+                taskId: task.id,
+                taskContent: task.content,
+            };
+        }
+        // Check if any tasks are pending - return first one (preserves LLM order)
+        const pendingTasks = todos.filter((t) => t.status === 'pending');
+        if (pendingTasks.length > 0) {
+            const task = pendingTasks[0];
+            return {
+                type: 'start',
+                taskId: task.id,
+                taskContent: task.content,
+            };
+        }
+        // All tasks are completed
+        return { type: 'all-complete' };
+    }
+}
+//# sourceMappingURL=todo-read.js.map

package/dist/src/tools/todo-read.js.map

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

package/dist/src/tools/todo-store.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Todo } from '../types/todo-schemas.js';
+export declare const DEFAULT_AGENT_ID = "primary";
+export declare class TodoStore {
+    private readonly filePath;
+    constructor(sessionId: string, agentId?: string);
+    /**
+     * Parse file content handling both legacy (array) and new ({ todos, paused }) task formats.
+     */
+    private parseFileContent;
+    /**
+     * Read the full file data including todos and paused state.
+     */
+    private readFileData;
+    /**
+     * Write the full file data including todos and paused state.
+     */
+    private writeFileData;
+    readTodos(): Promise<Todo[]>;
+    writeTodos(todos: Todo[]): Promise<void>;
+    /**
+     * Read the paused state from the task file.
+     * Returns false if file doesn't exist or is in legacy format.
+     */
+    readPausedState(): Promise<boolean>;
+    /**
+     * Write the paused state to the task file.
+     * Preserves existing todos.
+     */
+    writePausedState(paused: boolean): Promise<void>;
+}

package/dist/src/tools/todo-store.js

@@ -0,0 +1,124 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TodoArraySchema } from '../types/todo-schemas.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+export const DEFAULT_AGENT_ID = 'primary';
+export class TodoStore {
+    filePath;
+    constructor(sessionId, agentId) {
+        const todoDir = path.join(os.homedir(), '.llxprt', 'todos');
+        // Ensure directory exists
+        fs.mkdirSync(todoDir, { recursive: true });
+        const scopedAgentId = agentId && agentId !== DEFAULT_AGENT_ID ? agentId : undefined;
+        // Create filename based on session and agent
+        const fileName = scopedAgentId
+            ? `todo-${sessionId}-${scopedAgentId}.json`
+            : `todo-${sessionId}.json`;
+        this.filePath = path.join(todoDir, fileName);
+    }
+    /**
+     * Parse file content handling both legacy (array) and new ({ todos, paused }) task formats.
+     */
+    parseFileContent(content) {
+        const rawData = JSON.parse(content);
+        // Check if it's the new format (object with todos property)
+        if (
+        // eslint-disable-next-line sonarjs/expression-complexity -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+        rawData != null &&
+            rawData !== false &&
+            rawData !== 0 &&
+            rawData !== '' &&
+            !Number.isNaN(rawData) &&
+            typeof rawData === 'object' &&
+            !Array.isArray(rawData) &&
+            'todos' in rawData) {
+            const todosResult = TodoArraySchema.safeParse(rawData.todos);
+            if (todosResult.success) {
+                return {
+                    todos: todosResult.data,
+                    paused: rawData.paused === true,
+                };
+            }
+        }
+        // Legacy format: just an array of todos
+        const todosResult = TodoArraySchema.safeParse(rawData);
+        if (todosResult.success) {
+            return {
+                todos: todosResult.data,
+                paused: false,
+            };
+        }
+        // Invalid format
+        return { todos: [], paused: false };
+    }
+    /**
+     * Read the full file data including todos and paused state.
+     */
+    async readFileData() {
+        try {
+            if (!fs.existsSync(this.filePath)) {
+                return { todos: [], paused: false };
+            }
+            const content = await fs.promises.readFile(this.filePath, 'utf8');
+            return this.parseFileContent(content);
+        }
+        catch {
+            // Reading persisted task-list data failed; return empty state.
+            return { todos: [], paused: false };
+        }
+    }
+    /**
+     * Write the full file data including todos and paused state.
+     */
+    async writeFileData(data) {
+        const todosResult = TodoArraySchema.safeParse(data.todos);
+        if (!todosResult.success) {
+            throw new Error('Invalid todo data');
+        }
+        const dir = path.dirname(this.filePath);
+        await fs.promises.mkdir(dir, { recursive: true });
+        const fileData = {
+            todos: todosResult.data,
+            paused: data.paused,
+        };
+        const content = JSON.stringify(fileData, null, 2);
+        await fs.promises.writeFile(this.filePath, content, 'utf8');
+    }
+    async readTodos() {
+        const data = await this.readFileData();
+        return data.todos;
+    }
+    async writeTodos(todos) {
+        // Preserve paused state when writing todos
+        const existingData = await this.readFileData();
+        await this.writeFileData({
+            todos,
+            paused: existingData.paused,
+        });
+    }
+    /**
+     * Read the paused state from the task file.
+     * Returns false if file doesn't exist or is in legacy format.
+     */
+    async readPausedState() {
+        const data = await this.readFileData();
+        return data.paused;
+    }
+    /**
+     * Write the paused state to the task file.
+     * Preserves existing todos.
+     */
+    async writePausedState(paused) {
+        const existingData = await this.readFileData();
+        await this.writeFileData({
+            todos: existingData.todos,
+            paused,
+        });
+    }
+}
+//# sourceMappingURL=todo-store.js.map

package/dist/src/tools/todo-store.js.map

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

package/dist/src/tools/todo-write.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseTool, type ToolResult } from './tools.js';
+import { type Todo } from '../types/todo-schemas.js';
+import type { ITodoService } from '../interfaces/ITodoService.js';
+import type { IToolHost } from '../interfaces/IToolHost.js';
+export interface TodoWriteParams {
+    todos: Todo[];
+}
+export declare class TodoWrite extends BaseTool<TodoWriteParams, ToolResult> {
+    private readonly todoService?;
+    private readonly toolHost?;
+    static readonly Name = "todo_write";
+    private static readonly SCHEMA;
+    constructor(todoService?: ITodoService | undefined, toolHost?: IToolHost | undefined);
+    getDescription(params: TodoWriteParams): string;
+    private trackInteractiveUpdate;
+    private emitTodoUpdated;
+    execute(params: TodoWriteParams, _signal: AbortSignal, _updateOutput?: (output: string) => void): Promise<ToolResult>;
+    private normalizeTodos;
+    private enforceOneInProgress;
+    private calculateStatistics;
+    private determineNextAction;
+    private getTodoEmojiFilter;
+    private applyEmojiFilter;
+}

package/dist/src/tools/todo-write.js

@@ -0,0 +1,366 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Type } from '@google/genai';
+import { BaseTool, Kind } from './tools.js';
+import { TodoArraySchema } from '../types/todo-schemas.js';
+import { TodoStore, DEFAULT_AGENT_ID } from './todo-store.js';
+import { TodoReminderService } from '../utils/todoReminderService.js';
+import { todoEvents } from './todo-events.js';
+import { TodoContextTracker } from '../utils/todoContextTracker.js';
+import { formatTodoListForDisplay } from '../utils/todoFormatter.js';
+import { EmojiFilter, isEmojiFilterMode } from '../utils/EmojiFilter.js';
+export class TodoWrite extends BaseTool {
+    todoService;
+    toolHost;
+    static Name = 'todo_write';
+    static SCHEMA = {
+        type: Type.OBJECT,
+        properties: {
+            todos: {
+                type: Type.ARRAY,
+                items: {
+                    type: Type.OBJECT,
+                    properties: {
+                        id: {
+                            type: Type.STRING,
+                            description: 'Unique identifier for the todo item',
+                        },
+                        content: {
+                            type: Type.STRING,
+                            description: 'Description of the todo item',
+                            minLength: 1,
+                        },
+                        status: {
+                            type: Type.STRING,
+                            enum: ['pending', 'in_progress', 'completed'],
+                            description: 'Current status of the todo item',
+                        },
+                        subtasks: {
+                            type: Type.ARRAY,
+                            items: {
+                                type: Type.OBJECT,
+                                properties: {
+                                    id: {
+                                        type: Type.STRING,
+                                        description: 'Unique identifier for the subtask',
+                                    },
+                                    content: {
+                                        type: Type.STRING,
+                                        description: 'Description of the subtask',
+                                        minLength: 1,
+                                    },
+                                    toolCalls: {
+                                        type: Type.ARRAY,
+                                        items: {
+                                            type: Type.OBJECT,
+                                            properties: {
+                                                id: {
+                                                    type: Type.STRING,
+                                                    description: 'Unique identifier for the tool call',
+                                                },
+                                                name: {
+                                                    type: Type.STRING,
+                                                    description: 'Name of the tool being called',
+                                                },
+                                                parameters: {
+                                                    type: Type.OBJECT,
+                                                    description: 'Parameters for the tool call',
+                                                },
+                                            },
+                                            required: ['id', 'name', 'parameters'],
+                                        },
+                                        description: 'Tool calls associated with the subtask',
+                                    },
+                                },
+                                required: ['id', 'content'],
+                            },
+                            description: 'Subtasks associated with this todo',
+                        },
+                    },
+                    required: ['id', 'content', 'status'],
+                },
+                description: 'The updated todo list',
+            },
+        },
+        required: ['todos'],
+    };
+    constructor(todoService, toolHost) {
+        super(TodoWrite.Name, 'TodoWrite', 'Create and manage a structured task list for the current coding session. Updates the entire todo list.', Kind.Think, TodoWrite.SCHEMA, true, // isOutputMarkdown
+        false);
+        this.todoService = todoService;
+        this.toolHost = toolHost;
+    }
+    getDescription(params) {
+        return `Update todo list with ${params.todos.length} items`;
+    }
+    // Emit an update event and track the active in-progress item.
+    trackInteractiveUpdate(todos, sessionId, agentId) {
+        const scopedAgentId = agentId ?? DEFAULT_AGENT_ID;
+        const inProgressTodo = todos.find((todo) => todo.status === 'in_progress');
+        const contextTracker = TodoContextTracker.forAgent(sessionId, scopedAgentId);
+        contextTracker.setActiveTodo(inProgressTodo ? inProgressTodo.id : null);
+        this.emitTodoUpdated(todos, sessionId, scopedAgentId);
+    }
+    emitTodoUpdated(todos, sessionId, agentId) {
+        const event = {
+            sessionId,
+            agentId,
+            todos,
+            timestamp: new Date(),
+        };
+        todoEvents.emitTodoUpdated(event);
+    }
+    async execute(params, _signal, _updateOutput) {
+        const normalizedTodos = this.normalizeTodos(params.todos);
+        // Validate todos with Zod schema
+        const result = TodoArraySchema.safeParse(normalizedTodos);
+        if (!result.success) {
+            const error = result.error.errors[0];
+            throw new Error(`Validation error: ${error.path.join('.')} - ${error.message}`);
+        }
+        const emojiResult = this.applyEmojiFilter(result.data);
+        if (emojiResult.blocked) {
+            return {
+                llmContent: emojiResult.errorMessage ?? 'Emojis detected in content',
+                returnDisplay: emojiResult.errorMessage ?? 'Emojis detected in content',
+                error: {
+                    message: emojiResult.errorMessage ?? 'Emojis detected in content',
+                },
+            };
+        }
+        const revalidation = TodoArraySchema.safeParse(emojiResult.filtered);
+        if (!revalidation.success) {
+            const err = revalidation.error.errors[0];
+            const msg = `Emoji filtering produced invalid todo content: ${err.path.join('.')} - ${err.message}`;
+            return {
+                llmContent: msg,
+                returnDisplay: msg,
+                error: { message: msg },
+            };
+        }
+        const todos = revalidation.data;
+        // Get session and agent IDs from context
+        const sessionId = this.context?.sessionId ?? 'default';
+        const agentId = this.context?.agentId;
+        const serviceStore = this.todoService?.getTodoStore(this.context);
+        // Read old todos for diff tracking
+        const rawOldTodos = serviceStore?.readTodos
+            ? await serviceStore.readTodos()
+            : serviceStore?.getTodos
+                ? serviceStore.getTodos()
+                : await new TodoStore(sessionId, agentId).readTodos();
+        const oldTodos = rawOldTodos;
+        // Write new todos
+        if (serviceStore?.writeTodos) {
+            await serviceStore.writeTodos(todos);
+        }
+        else if (serviceStore?.setTodos) {
+            serviceStore.setTodos(todos);
+        }
+        else {
+            await new TodoStore(sessionId, agentId).writeTodos(todos);
+        }
+        const reminderService = this.todoService?.getReminderService();
+        const localReminderService = new TodoReminderService();
+        // Calculate state change
+        const stateChange = reminderService?.calculateStateChange?.(oldTodos, todos) ??
+            localReminderService.calculateStateChange(oldTodos, todos);
+        const shouldGenerateReminder = reminderService?.shouldGenerateReminder?.(stateChange) ??
+            localReminderService.shouldGenerateReminder(stateChange) ??
+            false;
+        // Generate reminder if needed
+        let reminder = null;
+        if (shouldGenerateReminder) {
+            reminder =
+                reminderService?.getReminderForStateChange?.(stateChange) ??
+                    localReminderService.getReminderForStateChange(stateChange) ??
+                    null;
+        }
+        // Set active task ID and emit event if in interactive mode
+        if (this.context?.interactiveMode === true) {
+            const scopedAgentId = agentId ?? this.todoService?.getDefaultAgentId() ?? DEFAULT_AGENT_ID;
+            const serviceTracker = this.todoService?.getContextTracker(this.context);
+            if (serviceTracker?.setActiveTodo) {
+                const inProgressTodo = todos.find((todo) => todo.status === 'in_progress');
+                serviceTracker.setActiveTodo(inProgressTodo ? inProgressTodo.id : null);
+                this.emitTodoUpdated(todos, sessionId, scopedAgentId);
+            }
+            else {
+                this.trackInteractiveUpdate(todos, sessionId, scopedAgentId);
+            }
+        }
+        const formattedOutput = formatTodoListForDisplay(todos);
+        const statistics = this.calculateStatistics(todos);
+        const nextAction = this.determineNextAction(todos);
+        let llmContent = formattedOutput;
+        if (emojiResult.systemFeedback) {
+            llmContent += `
+
+<system-reminder>
+${emojiResult.systemFeedback}
+</system-reminder>`;
+        }
+        return {
+            llmContent,
+            returnDisplay: formattedOutput,
+            metadata: {
+                stateChanged: shouldGenerateReminder,
+                todosAdded: stateChange.added.length,
+                todosRemoved: stateChange.removed.length,
+                statusChanged: stateChange.statusChanged.length,
+                statistics,
+                nextAction,
+                reminder: reminder ?? undefined,
+            },
+        };
+    }
+    normalizeTodos(rawTodos) {
+        const normalized = rawTodos.map((todo, index) => {
+            const normalizedId = 
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Todo input payload data.
+            todo?.id !== undefined &&
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Todo input payload data.
+                todo?.id !== null &&
+                `${todo.id}`.trim() !== ''
+                ? String(todo.id)
+                : String(index + 1);
+            const rawSubtasks = todo?.subtasks;
+            const hasSubtasks = Array.isArray(rawSubtasks);
+            const normalizedSubtasks = hasSubtasks
+                ? rawSubtasks.map((subtask, subIndex) => {
+                    const subtaskId = 
+                    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Todo input payload data.
+                    subtask?.id !== undefined &&
+                        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Todo input payload data.
+                        subtask?.id !== null &&
+                        `${subtask.id}`.trim() !== ''
+                        ? String(subtask.id)
+                        : `${normalizedId}-${subIndex + 1}`;
+                    return {
+                        ...subtask,
+                        id: subtaskId,
+                    };
+                })
+                : undefined;
+            const normalized = {
+                ...todo,
+                id: normalizedId,
+                status: todo.status ?? 'pending',
+            };
+            if (hasSubtasks) {
+                normalized.subtasks = normalizedSubtasks;
+            }
+            return normalized;
+        });
+        return this.enforceOneInProgress(normalized);
+    }
+    enforceOneInProgress(todos) {
+        const inProgressIndices = todos
+            .map((todo, index) => (todo.status === 'in_progress' ? index : -1))
+            .filter((index) => index !== -1);
+        if (inProgressIndices.length <= 1) {
+            return todos;
+        }
+        const lastInProgressIndex = inProgressIndices[inProgressIndices.length - 1];
+        return todos.map((todo, index) => {
+            if (todo.status === 'in_progress' && index !== lastInProgressIndex) {
+                return { ...todo, status: 'pending' };
+            }
+            return todo;
+        });
+    }
+    calculateStatistics(todos) {
+        return {
+            total: todos.length,
+            inProgress: todos.filter((t) => t.status === 'in_progress').length,
+            pending: todos.filter((t) => t.status === 'pending').length,
+            completed: todos.filter((t) => t.status === 'completed').length,
+        };
+    }
+    determineNextAction(todos) {
+        // Check if any tasks are in progress - return first one (preserves LLM order)
+        const inProgressTasks = todos.filter((t) => t.status === 'in_progress');
+        if (inProgressTasks.length > 0) {
+            const task = inProgressTasks[0];
+            return {
+                type: 'continue',
+                taskId: task.id,
+                taskContent: task.content,
+            };
+        }
+        // Check if any tasks are pending - return first one (preserves LLM order)
+        const pendingTasks = todos.filter((t) => t.status === 'pending');
+        if (pendingTasks.length > 0) {
+            const task = pendingTasks[0];
+            return {
+                type: 'start',
+                taskId: task.id,
+                taskContent: task.content,
+            };
+        }
+        // All tasks are completed
+        return { type: 'all-complete' };
+    }
+    getTodoEmojiFilter() {
+        if (!this.toolHost) {
+            return null;
+        }
+        const raw = this.toolHost.getEphemeralSettings?.().emojifilter;
+        const mode = isEmojiFilterMode(raw) ? raw : 'auto';
+        return new EmojiFilter({ mode });
+    }
+    applyEmojiFilter(todos) {
+        const filter = this.getTodoEmojiFilter();
+        if (!filter) {
+            return { filtered: todos, blocked: false };
+        }
+        let blocked = false;
+        let errorMessage;
+        const feedbackParts = new Set();
+        const filteredTodos = todos.map((todo) => {
+            const contentResult = filter.filterText(todo.content);
+            if (contentResult.blocked) {
+                blocked = true;
+                errorMessage = contentResult.error ?? 'Emojis detected in todo content';
+            }
+            if (contentResult.systemFeedback)
+                feedbackParts.add(contentResult.systemFeedback);
+            const filteredSubtasks = todo.subtasks?.map((subtask) => {
+                const subResult = filter.filterText(subtask.content);
+                if (subResult.blocked) {
+                    blocked = true;
+                    errorMessage =
+                        subResult.error ?? 'Emojis detected in subtask content';
+                }
+                if (subResult.systemFeedback)
+                    feedbackParts.add(subResult.systemFeedback);
+                const subFiltered = subResult.filtered;
+                return {
+                    ...subtask,
+                    content: typeof subFiltered === 'string' ? subFiltered : subtask.content,
+                };
+            });
+            const todoFiltered = contentResult.filtered;
+            const filteredTodo = {
+                ...todo,
+                content: typeof todoFiltered === 'string' ? todoFiltered : todo.content,
+            };
+            if (todo.subtasks) {
+                filteredTodo.subtasks = filteredSubtasks;
+            }
+            return filteredTodo;
+        });
+        return {
+            filtered: filteredTodos,
+            blocked,
+            errorMessage,
+            systemFeedback: feedbackParts.size > 0
+                ? Array.from(feedbackParts).join(' ')
+                : undefined,
+        };
+    }
+}
+//# sourceMappingURL=todo-write.js.map