@dexto/tools-todo 1.6.0 → 1.6.2

package/dist/index.d.cts

@@ -1,10 +1,231 @@
-export { todoToolsFactory } from './tool-factory.cjs';
-export { TodoService } from './todo-service.cjs';
-export { TodoError } from './errors.cjs';
-export { TodoErrorCode } from './error-codes.cjs';
-export { TODO_STATUS_VALUES, Todo, TodoConfig, TodoInput, TodoStatus, TodoUpdateResult } from './types.cjs';
-export { createTodoWriteTool } from './todo-write-tool.cjs';
-import '@dexto/agent-config';
-import './tool-factory-config.cjs';
-import 'zod';
-import '@dexto/core';
+import { ToolFactory } from '@dexto/agent-config';
+import { z } from 'zod';
+import { Database, AgentEventBus, Logger, DextoRuntimeError, ToolExecutionContext, Tool } from '@dexto/core';
+
+/**
+ * Todo Tools Factory
+ *
+ * Provides task tracking tools by wrapping TodoService.
+ * When registered, the factory initializes TodoService and creates the
+ * todo_write tool for managing task lists.
+ */
+
+/**
+ * Configuration schema for Todo tools factory.
+ */
+declare const TodoToolsConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"todo-tools">;
+    maxTodosPerSession: z.ZodDefault<z.ZodNumber>;
+    enableEvents: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    maxTodosPerSession: number;
+    enableEvents: boolean;
+    type: "todo-tools";
+}, {
+    type: "todo-tools";
+    maxTodosPerSession?: number | undefined;
+    enableEvents?: boolean | undefined;
+}>;
+type TodoToolsConfig = z.output<typeof TodoToolsConfigSchema>;
+
+declare const todoToolsFactory: ToolFactory<TodoToolsConfig>;
+
+/**
+ * Todo Service Types
+ *
+ * Types for todo list management and workflow tracking
+ */
+/**
+ * Valid todo status values
+ * Centralized constant to prevent duplication across domains
+ */
+declare const TODO_STATUS_VALUES: readonly ["pending", "in_progress", "completed"];
+/**
+ * Todo item status
+ */
+type TodoStatus = (typeof TODO_STATUS_VALUES)[number];
+/**
+ * Todo item with system metadata
+ */
+interface Todo {
+    id: string;
+    sessionId: string;
+    content: string;
+    activeForm: string;
+    status: TodoStatus;
+    position: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Todo input from tool (without system metadata)
+ */
+interface TodoInput {
+    content: string;
+    activeForm: string;
+    status: TodoStatus;
+}
+/**
+ * Todo list update result
+ */
+interface TodoUpdateResult {
+    todos: Todo[];
+    sessionId: string;
+    created: number;
+    updated: number;
+    deleted: number;
+}
+/**
+ * Configuration for TodoService
+ */
+interface TodoConfig {
+    /** Maximum todos per session */
+    maxTodosPerSession?: number;
+    /** Enable real-time events */
+    enableEvents?: boolean;
+}
+
+/**
+ * Todo Service
+ *
+ * Manages todo lists for tracking agent workflow and task progress.
+ * Emits events through the AgentEventBus using the service:event pattern.
+ */
+
+type TodoEventEmitter = Pick<AgentEventBus, 'emit'>;
+/**
+ * TodoService - Manages todo lists for agent workflow tracking
+ */
+declare class TodoService {
+    private database;
+    private eventBus;
+    private logger;
+    private config;
+    private initialized;
+    constructor(database: Database, eventBus: TodoEventEmitter, logger: Logger, config?: TodoConfig);
+    /**
+     * Initialize the service
+     */
+    initialize(): Promise<void>;
+    /**
+     * Update todos for a session (replaces entire list)
+     */
+    updateTodos(sessionId: string, todoInputs: TodoInput[]): Promise<TodoUpdateResult>;
+    /**
+     * Get todos for a session
+     */
+    getTodos(sessionId: string): Promise<Todo[]>;
+    /**
+     * Generate database key for session todos
+     */
+    private getTodosDatabaseKey;
+    /**
+     * Generate consistent key for todo matching (content + activeForm)
+     * Uses JSON encoding to prevent collisions when fields contain delimiters
+     */
+    private getTodoKey;
+    /**
+     * Generate key from TodoInput
+     * Uses JSON encoding to prevent collisions when fields contain delimiters
+     */
+    private getTodoKeyFromInput;
+    /**
+     * Validate todo status
+     */
+    private validateTodoStatus;
+}
+
+/**
+ * Todo Service Errors
+ *
+ * Error factory for todo list management operations
+ */
+
+/**
+ * Factory class for creating Todo-related errors
+ */
+declare class TodoError {
+    private constructor();
+    /**
+     * Service not initialized error
+     */
+    static notInitialized(): DextoRuntimeError;
+    /**
+     * Todo limit exceeded error
+     */
+    static todoLimitExceeded(current: number, max: number): DextoRuntimeError;
+    /**
+     * Invalid todo status error
+     */
+    static invalidStatus(status: string): DextoRuntimeError;
+    /**
+     * Database error
+     */
+    static databaseError(operation: string, cause: string): DextoRuntimeError;
+}
+
+/**
+ * Todo Service Error Codes
+ */
+declare enum TodoErrorCode {
+    SERVICE_NOT_INITIALIZED = "TODO_SERVICE_NOT_INITIALIZED",
+    TODO_LIMIT_EXCEEDED = "TODO_LIMIT_EXCEEDED",
+    INVALID_TODO_STATUS = "TODO_INVALID_TODO_STATUS",
+    DATABASE_ERROR = "TODO_DATABASE_ERROR"
+}
+
+/**
+ * Todo Write Tool
+ *
+ * Manages todo lists for tracking agent progress and workflow organization
+ */
+
+/**
+ * Zod schema for todo_write tool input
+ */
+declare const TodoWriteInputSchema: z.ZodEffects<z.ZodObject<{
+    todos: z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        activeForm: z.ZodString;
+        status: z.ZodEnum<["pending", "in_progress", "completed"]>;
+    }, "strict", z.ZodTypeAny, {
+        status: "pending" | "in_progress" | "completed";
+        content: string;
+        activeForm: string;
+    }, {
+        status: "pending" | "in_progress" | "completed";
+        content: string;
+        activeForm: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    todos: {
+        status: "pending" | "in_progress" | "completed";
+        content: string;
+        activeForm: string;
+    }[];
+}, {
+    todos: {
+        status: "pending" | "in_progress" | "completed";
+        content: string;
+        activeForm: string;
+    }[];
+}>, {
+    todos: {
+        status: "pending" | "in_progress" | "completed";
+        content: string;
+        activeForm: string;
+    }[];
+}, {
+    todos: {
+        status: "pending" | "in_progress" | "completed";
+        content: string;
+        activeForm: string;
+    }[];
+}>;
+/**
+ * Create todo_write internal tool
+ */
+type TodoServiceGetter = (context: ToolExecutionContext) => Promise<TodoService>;
+declare function createTodoWriteTool(getTodoService: TodoServiceGetter): Tool<typeof TodoWriteInputSchema>;
+
+export { TODO_STATUS_VALUES, type Todo, type TodoConfig, TodoError, TodoErrorCode, type TodoInput, TodoService, type TodoStatus, type TodoUpdateResult, createTodoWriteTool, todoToolsFactory };

package/dist/todo-write-tool.cjs

@@ -50,7 +50,6 @@ const TodoWriteInputSchema = import_zod.z.object({
 function createTodoWriteTool(getTodoService) {
   return (0, import_core.defineTool)({
     id: "todo_write",
-    displayName: "Update Todos",
     description: `Track progress on multi-step tasks. Use for:
 - Implementation tasks with 3+ steps (features, refactors, bug fixes)
 - Tasks where the user asks for a plan or breakdown
@@ -60,6 +59,12 @@ Do NOT use for simple single-file edits, quick questions, or explanations.
 
 IMPORTANT: This replaces the entire todo list. Always include ALL tasks (pending, in_progress, completed). Only ONE task should be in_progress at a time. Update status as you work: pending \u2192 in_progress \u2192 completed.`,
     inputSchema: TodoWriteInputSchema,
+    presentation: {
+      describeHeader: (input) => (0, import_core.createLocalToolCallHeader)({
+        title: "Update Todos",
+        argsText: `${input.todos.length} items`
+      })
+    },
     async execute(input, context) {
       const resolvedTodoService = await getTodoService(context);
       const sessionId = context.sessionId ?? "default";

package/dist/todo-write-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"todo-write-tool.d.ts","sourceRoot":"","sources":["../src/todo-write-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA0BrD;;GAEG;AACH,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBrB,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAExF,wBAAgB,mBAAmB,CAC/B,cAAc,EAAE,iBAAiB,GAClC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAiCnC"}
+{"version":3,"file":"todo-write-tool.d.ts","sourceRoot":"","sources":["../src/todo-write-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA0BrD;;GAEG;AACH,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBrB,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAExF,wBAAgB,mBAAmB,CAC/B,cAAc,EAAE,iBAAiB,GAClC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAwCnC"}

package/dist/todo-write-tool.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { defineTool } from "@dexto/core";
+import { createLocalToolCallHeader, defineTool } from "@dexto/core";
 import { TODO_STATUS_VALUES } from "./types.js";
 const TodoItemSchema = z.object({
   content: z.string().min(1).describe('Task description in imperative form (e.g., "Fix authentication bug")'),
@@ -27,7 +27,6 @@ const TodoWriteInputSchema = z.object({
 function createTodoWriteTool(getTodoService) {
   return defineTool({
     id: "todo_write",
-    displayName: "Update Todos",
     description: `Track progress on multi-step tasks. Use for:
 - Implementation tasks with 3+ steps (features, refactors, bug fixes)
 - Tasks where the user asks for a plan or breakdown
@@ -37,6 +36,12 @@ Do NOT use for simple single-file edits, quick questions, or explanations.
 
 IMPORTANT: This replaces the entire todo list. Always include ALL tasks (pending, in_progress, completed). Only ONE task should be in_progress at a time. Update status as you work: pending \u2192 in_progress \u2192 completed.`,
     inputSchema: TodoWriteInputSchema,
+    presentation: {
+      describeHeader: (input) => createLocalToolCallHeader({
+        title: "Update Todos",
+        argsText: `${input.todos.length} items`
+      })
+    },
     async execute(input, context) {
       const resolvedTodoService = await getTodoService(context);
       const sessionId = context.sessionId ?? "default";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/tools-todo",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Todo/task tracking tools factory for Dexto agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,8 +20,8 @@
   "dependencies": {
     "nanoid": "^5.0.9",
     "zod": "^3.25.0",
-    "@dexto/agent-config": "1.6.0",
-    "@dexto/core": "1.6.0"
+    "@dexto/agent-config": "1.6.2",
+    "@dexto/core": "1.6.2"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
@@ -33,7 +33,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && node ../../scripts/clean-tsbuildinfo.mjs && tsc -b tsconfig.json --emitDeclarationOnly",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   }

package/dist/error-codes.d.cts

@@ -1,11 +0,0 @@
-/**
- * Todo Service Error Codes
- */
-declare enum TodoErrorCode {
-    SERVICE_NOT_INITIALIZED = "TODO_SERVICE_NOT_INITIALIZED",
-    TODO_LIMIT_EXCEEDED = "TODO_LIMIT_EXCEEDED",
-    INVALID_TODO_STATUS = "TODO_INVALID_TODO_STATUS",
-    DATABASE_ERROR = "TODO_DATABASE_ERROR"
-}
-
-export { TodoErrorCode };

package/dist/errors.d.cts

@@ -1,32 +0,0 @@
-import { DextoRuntimeError } from '@dexto/core';
-
-/**
- * Todo Service Errors
- *
- * Error factory for todo list management operations
- */
-
-/**
- * Factory class for creating Todo-related errors
- */
-declare class TodoError {
-    private constructor();
-    /**
-     * Service not initialized error
-     */
-    static notInitialized(): DextoRuntimeError;
-    /**
-     * Todo limit exceeded error
-     */
-    static todoLimitExceeded(current: number, max: number): DextoRuntimeError;
-    /**
-     * Invalid todo status error
-     */
-    static invalidStatus(status: string): DextoRuntimeError;
-    /**
-     * Database error
-     */
-    static databaseError(operation: string, cause: string): DextoRuntimeError;
-}
-
-export { TodoError };

package/dist/todo-service.d.cts

@@ -1,54 +0,0 @@
-import { Database, AgentEventBus, Logger } from '@dexto/core';
-import { TodoConfig, TodoInput, TodoUpdateResult, Todo } from './types.cjs';
-
-/**
- * Todo Service
- *
- * Manages todo lists for tracking agent workflow and task progress.
- * Emits events through the AgentEventBus using the service:event pattern.
- */
-
-type TodoEventEmitter = Pick<AgentEventBus, 'emit'>;
-/**
- * TodoService - Manages todo lists for agent workflow tracking
- */
-declare class TodoService {
-    private database;
-    private eventBus;
-    private logger;
-    private config;
-    private initialized;
-    constructor(database: Database, eventBus: TodoEventEmitter, logger: Logger, config?: TodoConfig);
-    /**
-     * Initialize the service
-     */
-    initialize(): Promise<void>;
-    /**
-     * Update todos for a session (replaces entire list)
-     */
-    updateTodos(sessionId: string, todoInputs: TodoInput[]): Promise<TodoUpdateResult>;
-    /**
-     * Get todos for a session
-     */
-    getTodos(sessionId: string): Promise<Todo[]>;
-    /**
-     * Generate database key for session todos
-     */
-    private getTodosDatabaseKey;
-    /**
-     * Generate consistent key for todo matching (content + activeForm)
-     * Uses JSON encoding to prevent collisions when fields contain delimiters
-     */
-    private getTodoKey;
-    /**
-     * Generate key from TodoInput
-     * Uses JSON encoding to prevent collisions when fields contain delimiters
-     */
-    private getTodoKeyFromInput;
-    /**
-     * Validate todo status
-     */
-    private validateTodoStatus;
-}
-
-export { TodoService };

package/dist/todo-write-tool.d.cts

@@ -1,60 +0,0 @@
-import { z } from 'zod';
-import { ToolExecutionContext, Tool } from '@dexto/core';
-import { TodoService } from './todo-service.cjs';
-import './types.cjs';
-
-/**
- * Todo Write Tool
- *
- * Manages todo lists for tracking agent progress and workflow organization
- */
-
-/**
- * Zod schema for todo_write tool input
- */
-declare const TodoWriteInputSchema: z.ZodEffects<z.ZodObject<{
-    todos: z.ZodArray<z.ZodObject<{
-        content: z.ZodString;
-        activeForm: z.ZodString;
-        status: z.ZodEnum<["pending", "in_progress", "completed"]>;
-    }, "strict", z.ZodTypeAny, {
-        status: "pending" | "in_progress" | "completed";
-        content: string;
-        activeForm: string;
-    }, {
-        status: "pending" | "in_progress" | "completed";
-        content: string;
-        activeForm: string;
-    }>, "many">;
-}, "strict", z.ZodTypeAny, {
-    todos: {
-        status: "pending" | "in_progress" | "completed";
-        content: string;
-        activeForm: string;
-    }[];
-}, {
-    todos: {
-        status: "pending" | "in_progress" | "completed";
-        content: string;
-        activeForm: string;
-    }[];
-}>, {
-    todos: {
-        status: "pending" | "in_progress" | "completed";
-        content: string;
-        activeForm: string;
-    }[];
-}, {
-    todos: {
-        status: "pending" | "in_progress" | "completed";
-        content: string;
-        activeForm: string;
-    }[];
-}>;
-/**
- * Create todo_write internal tool
- */
-type TodoServiceGetter = (context: ToolExecutionContext) => Promise<TodoService>;
-declare function createTodoWriteTool(getTodoService: TodoServiceGetter): Tool<typeof TodoWriteInputSchema>;
-
-export { type TodoServiceGetter, createTodoWriteTool };

package/dist/tool-factory-config.d.cts

@@ -1,29 +0,0 @@
-import { z } from 'zod';
-
-/**
- * Todo Tools Factory
- *
- * Provides task tracking tools by wrapping TodoService.
- * When registered, the factory initializes TodoService and creates the
- * todo_write tool for managing task lists.
- */
-
-/**
- * Configuration schema for Todo tools factory.
- */
-declare const TodoToolsConfigSchema: z.ZodObject<{
-    type: z.ZodLiteral<"todo-tools">;
-    maxTodosPerSession: z.ZodDefault<z.ZodNumber>;
-    enableEvents: z.ZodDefault<z.ZodBoolean>;
-}, "strict", z.ZodTypeAny, {
-    maxTodosPerSession: number;
-    enableEvents: boolean;
-    type: "todo-tools";
-}, {
-    type: "todo-tools";
-    maxTodosPerSession?: number | undefined;
-    enableEvents?: boolean | undefined;
-}>;
-type TodoToolsConfig = z.output<typeof TodoToolsConfigSchema>;
-
-export { type TodoToolsConfig, TodoToolsConfigSchema };

package/dist/tool-factory.d.cts

@@ -1,7 +0,0 @@
-import { ToolFactory } from '@dexto/agent-config';
-import { TodoToolsConfig } from './tool-factory-config.cjs';
-import 'zod';
-
-declare const todoToolsFactory: ToolFactory<TodoToolsConfig>;
-
-export { todoToolsFactory };

package/dist/types.d.cts

@@ -1,56 +0,0 @@
-/**
- * Todo Service Types
- *
- * Types for todo list management and workflow tracking
- */
-/**
- * Valid todo status values
- * Centralized constant to prevent duplication across domains
- */
-declare const TODO_STATUS_VALUES: readonly ["pending", "in_progress", "completed"];
-/**
- * Todo item status
- */
-type TodoStatus = (typeof TODO_STATUS_VALUES)[number];
-/**
- * Todo item with system metadata
- */
-interface Todo {
-    id: string;
-    sessionId: string;
-    content: string;
-    activeForm: string;
-    status: TodoStatus;
-    position: number;
-    createdAt: Date;
-    updatedAt: Date;
-}
-/**
- * Todo input from tool (without system metadata)
- */
-interface TodoInput {
-    content: string;
-    activeForm: string;
-    status: TodoStatus;
-}
-/**
- * Todo list update result
- */
-interface TodoUpdateResult {
-    todos: Todo[];
-    sessionId: string;
-    created: number;
-    updated: number;
-    deleted: number;
-}
-/**
- * Configuration for TodoService
- */
-interface TodoConfig {
-    /** Maximum todos per session */
-    maxTodosPerSession?: number;
-    /** Enable real-time events */
-    enableEvents?: boolean;
-}
-
-export { TODO_STATUS_VALUES, type Todo, type TodoConfig, type TodoInput, type TodoStatus, type TodoUpdateResult };