indusagi 0.12.9 → 0.12.12

package/dist/agent/tools/task.js

@@ -1,36 +1,184 @@
+/**
+ * Task Tool - Launch subagents for autonomous task execution
+ *
+ * @module agent/tools/task
+ * @description
+ * The task tool allows the agent to delegate complex or multi-step work to subagents.
+ * Subagents run autonomously and can use the full set of tools available to the main agent.
+ *
+ * ## Architecture
+ *
+ * The task tool supports two modes:
+ * 1. **Simple mode** (default): Stores task info in memory, returns placeholder result
+ * 2. **Executor mode**: Uses injected TaskExecutor for actual subagent execution
+ *
+ * The coding-agent uses executor mode by providing a TaskExecutor that:
+ * - Creates real subagent sessions via TaskSessionManager
+ * - Runs the agent with the given prompt
+ * - Streams updates via onUpdate callback
+ * - Returns detailed results including tool calls, duration, model info
+ *
+ * ## Usage
+ *
+ * ### Simple mode (no executor)
+ * ```typescript
+ * import { createTaskTool } from "indusagi/agent";
+ * const taskTool = createTaskTool();
+ * ```
+ *
+ * ### Executor mode (with custom execution)
+ * ```typescript
+ * import { createTaskTool, type TaskExecutor } from "indusagi/agent";
+ *
+ * const executor: TaskExecutor = {
+ *   async runTask(params) {
+ *     // Custom implementation
+ *     return { output: "result", details: { ... } };
+ *   }
+ * };
+ *
+ * const taskTool = createTaskTool({ executor });
+ * ```
+ */
 import { Type } from "@sinclair/typebox";
 const taskSchema = Type.Object({
-    description: Type.String({ description: "A short (3-5 words) description of task" }),
-    prompt: Type.String({ description: "The task for subagent to perform" }),
+    description: Type.String({ description: "A short (3-5 words) description of the task" }),
+    prompt: Type.String({ description: "The task for the subagent to perform" }),
     subagent_type: Type.String({ description: "The type of specialized subagent to use for this task" }),
     task_id: Type.Optional(Type.String({
-        description: "Only set to resume a previous task. The task will continue in the same subagent session as before.",
+        description: "Only set to resume a previous task. The task will continue the same subagent session as before.",
     })),
+    command: Type.Optional(Type.String({ description: "The command that triggered this task (optional)" })),
 });
+// Simple in-memory task sessions for basic mode
 const taskSessions = new Map();
+/**
+ * Build task description with available subagent types
+ */
+function buildDefaultDescription(subagentStore) {
+    const header = "Launch a subagent to handle complex or multi-step work autonomously.";
+    const instructions = "\n\nAvailable subagent types:\n- general: General-purpose subagent for multi-step tasks and research.\n- explore: Subagent specialized in codebase exploration and search.\n\nWhen using this tool, provide a clear description, a detailed prompt, and the subagent_type. Use task_id to resume a previous task.";
+    if (!subagentStore) {
+        return `${header}${instructions}`;
+    }
+    const subagents = subagentStore
+        .list()
+        .filter((agent) => agent.mode !== "primary" && agent.hidden !== true)
+        .map((agent) => `- ${agent.name}${agent.description ? `: ${agent.description}` : ""}`)
+        .join("\n");
+    return subagents
+        ? `${header}\n\nAvailable subagent types:\n${subagents}\n\nWhen using this tool, provide a clear description, a detailed prompt, and the subagent_type. Use task_id to resume a previous task.`
+        : `${header}${instructions}`;
+}
+/**
+ * Default simple executor for basic mode
+ */
+const defaultExecutor = {
+    async runTask({ description, prompt, subagentType, taskId }) {
+        const id = taskId ?? `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const existing = taskSessions.get(id);
+        const session = {
+            description: description || existing?.description || "",
+            prompt: prompt || existing?.prompt || "",
+            subagentType: subagentType || existing?.subagentType || "general",
+            status: "completed",
+        };
+        taskSessions.set(id, session);
+        const output = `Task(${id}): ${session.description}\n${session.prompt}\nStatus: ${session.status}`;
+        return {
+            output,
+            details: {
+                taskId: id,
+                subagentType: session.subagentType,
+                description: session.description,
+                result: session.status,
+                toolCalls: 0,
+                durationMs: 0,
+            },
+        };
+    },
+};
+/**
+ * Create a task tool with optional custom executor
+ *
+ * @param options - Task tool options
+ * @param options.cwd - Working directory
+ * @param options.executor - Custom task executor for real execution
+ * @param options.subagentStore - Subagent store for dynamic type discovery
+ * @returns The task tool
+ */
 export function createTaskTool(options) {
+    const executor = options?.executor ?? defaultExecutor;
+    const subagentStore = options?.subagentStore;
+    const descriptionBuilder = options?.buildDescription ?? buildDefaultDescription;
     return {
         name: "task",
         label: "task",
-        description: "Launch a subagent to handle complex or multi-step work autonomously. When using this tool, provide a clear description, a detailed prompt, and subagent_type. Use task_id to resume a previous task.",
+        description: descriptionBuilder(subagentStore),
         parameters: taskSchema,
-        execute: async (_toolCallId, { description, prompt, subagent_type, task_id }) => {
-            const id = task_id ?? `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-            const existing = taskSessions.get(id);
-            const session = {
-                description: description || existing?.description || "",
-                prompt: prompt || existing?.prompt || "",
-                subagentType: subagent_type || existing?.subagentType || "general",
-                status: "completed",
-            };
-            taskSessions.set(id, session);
-            const output = `Task(${id}): ${session.description}\n${session.prompt}\nStatus: ${session.status}`;
+        execute: async (_toolCallId, { description, prompt, subagent_type, task_id }, signal, onUpdate) => {
+            // Check if already aborted
+            if (signal?.aborted) {
+                throw new Error("Task aborted before execution");
+            }
+            // Track accumulated stats for streaming updates
+            let accumulatedToolCalls = 0;
+            let accumulatedDurationMs = 0;
+            // Convert onUpdate callback to TaskUpdate callback
+            const taskUpdateCallback = onUpdate
+                ? (update) => {
+                    // Update accumulated stats if provided
+                    if (update.details) {
+                        accumulatedToolCalls = update.details.toolCalls ?? accumulatedToolCalls;
+                        accumulatedDurationMs = update.details.durationMs ?? accumulatedDurationMs;
+                    }
+                    if (update.type === "chunk" && update.content) {
+                        onUpdate({
+                            content: [{ type: "text", text: update.content }],
+                            details: {
+                                taskId: update.details?.taskId ?? task_id ?? "",
+                                subagentType: update.details?.subagentType ?? subagent_type,
+                                description: update.details?.description ?? description,
+                                result: update.details?.result ?? "",
+                                toolCalls: accumulatedToolCalls,
+                                durationMs: accumulatedDurationMs,
+                                model: update.details?.model,
+                            }
+                        });
+                    }
+                    else if (update.type === "complete" && update.details && update.details.taskId) {
+                        // Only call complete when we have all required fields
+                        onUpdate({
+                            content: [{ type: "text", text: "" }],
+                            details: {
+                                taskId: update.details.taskId,
+                                subagentType: update.details.subagentType ?? subagent_type,
+                                description: update.details.description ?? description,
+                                result: update.details.result ?? "",
+                                toolCalls: update.details.toolCalls ?? accumulatedToolCalls,
+                                durationMs: update.details.durationMs ?? accumulatedDurationMs,
+                                model: update.details.model,
+                            }
+                        });
+                    }
+                }
+                : undefined;
+            // Execute the task
+            const result = await executor.runTask({
+                description,
+                prompt,
+                subagentType: subagent_type,
+                taskId: task_id,
+                signal,
+                onUpdate: taskUpdateCallback,
+            });
             return {
-                content: [{ type: "text", text: output }],
-                details: { description: session.description, prompt: session.prompt, subagentType: session.subagentType, taskId: id },
+                content: [{ type: "text", text: result.output }],
+                details: result.details,
             };
         },
     };
 }
+/** Default task tool without executor (simple mode) */
 export const taskTool = createTaskTool();
 //# sourceMappingURL=task.js.map

package/dist/agent/tools/task.js.map

@@ -1 +1 @@
-{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../src/agent/tools/task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;IACpF,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC;IACxE,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,uDAAuD,EAAE,CAAC;IACpG,OAAO,EAAE,IAAI,CAAC,QAAQ,CACrB,IAAI,CAAC,MAAM,CAAC;QACX,WAAW,EACV,oGAAoG;KACrG,CAAC,CACF;CACD,CAAC,CAAC;AAcH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyF,CAAC;AAEtH,MAAM,UAAU,cAAc,CAAC,OAAyB;IACvD,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,WAAW,EACV,sMAAsM;QACvM,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE,KAAK,EACb,WAAW,EACX,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAK5C,EACA,EAAE;YACH,MAAM,EAAE,GAAG,OAAO,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAChF,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG;gBACf,WAAW,EAAE,WAAW,IAAI,QAAQ,EAAE,WAAW,IAAI,EAAE;gBACvD,MAAM,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,IAAI,EAAE;gBACxC,YAAY,EAAE,aAAa,IAAI,QAAQ,EAAE,YAAY,IAAI,SAAS;gBAClE,MAAM,EAAE,WAAW;aACnB,CAAC;YACF,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAE9B,MAAM,MAAM,GAAG,QAAQ,EAAE,MAAM,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,MAAM,EAAE,CAAC;YACnG,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACzC,OAAO,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;aACrH,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC"}
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../src/agent/tools/task.ts"],"names":[],"mappings":"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"}

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

@@ -1,24 +1,77 @@
+/**
+ * Todo Store - Persistent todo list management
+ *
+ * @module agent/tools/todo-store
+ * @description
+ * Manages a todo list with optional persistence callbacks.
+ * The coding-agent uses this to integrate with SessionManager for session persistence.
+ *
+ * ## Architecture
+ *
+ * The TodoStore supports two modes:
+ * 1. **Simple mode** (default): Stores todos in memory only
+ * 2. **Persistent mode**: Uses callbacks to persist/load todos
+ *
+ * ## Usage
+ *
+ * ### Simple mode
+ * ```typescript
+ * const store = new TodoStore();
+ * store.setTodos([{ content: "Task", status: "pending", priority: "high" }]);
+ * ```
+ *
+ * ### Persistent mode (coding-agent style)
+ * ```typescript
+ * const store = new TodoStore({
+ *   persist: (todos) => sessionManager.appendCustomEntry('todo', { todos }),
+ *   load: () => loadFromSession(),
+ *   rebuildFromBranch: () => rebuildFromSession(),
+ * });
+ * ```
+ */
+import type { TodoItem, TodoStatus, TodoStoreOptions } from "./todo-types.js";
+export type { TodoItem, TodoStatus, TodoPriority, TodoStoreOptions, TodoToolDetails } from "./todo-types.js";
+declare const TODO_STATUSES: readonly ["pending", "in_progress", "completed", "cancelled"];
+declare const TODO_PRIORITIES: readonly ["high", "medium", "low"];
 /**
  * Simple Todo Store for the todo tool.
- * Simplified version for indusagi agent framework.
+ * Supports optional persistence callbacks for session integration.
  */
-export declare const TODO_STATUSES: readonly ["pending", "in_progress", "completed", "cancelled"];
-export type TodoStatus = (typeof TODO_STATUSES)[number];
-export declare const TODO_PRIORITIES: readonly ["high", "medium", "low"];
-export type TodoPriority = (typeof TODO_PRIORITIES)[number];
-export interface TodoItem {
-    content: string;
-    status: TodoStatus;
-    priority: TodoPriority;
-    expiresAt?: number;
-}
 export declare class TodoStore {
     private todos;
-    constructor(initialTodos?: TodoItem[]);
+    private options?;
+    /**
+     * Create a new TodoStore
+     * @param initialTodos - Optional initial todos (takes precedence over load callback)
+     * @param options - Optional persistence callbacks
+     */
+    constructor(initialTodos?: TodoItem[], options?: TodoStoreOptions);
+    constructor(options?: TodoStoreOptions);
+    /**
+     * Get all todos (returns a copy)
+     */
     getTodos(): TodoItem[];
+    /**
+     * Set todos and persist
+     */
     setTodos(todos: TodoItem[]): void;
+    /**
+     * Find todos matching a query
+     */
     find(query: string): TodoItem[];
+    /**
+     * Filter todos by status
+     */
     filterByStatus(status: TodoStatus): TodoItem[];
+    /**
+     * Rebuild todos from session branch
+     * Called when navigating the session tree
+     */
+    rebuildFromBranch(): void;
+    /**
+     * Remove expired todos
+     */
     private removeExpired;
 }
+export { TODO_STATUSES, TODO_PRIORITIES };
 //# sourceMappingURL=todo-store.d.ts.map

package/dist/agent/tools/todo-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"todo-store.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/todo-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,aAAa,+DAAgE,CAAC;AAC3F,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe,oCAAqC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,SAAS;IACrB,OAAO,CAAC,KAAK,CAAkB;gBAEnB,YAAY,CAAC,EAAE,QAAQ,EAAE;IAMrC,QAAQ,IAAI,QAAQ,EAAE;IAKtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAKjC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE;IAK/B,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,EAAE;IAI9C,OAAO,CAAC,aAAa;CAGrB"}
+{"version":3,"file":"todo-store.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/todo-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7G,QAAA,MAAM,aAAa,+DAAgE,CAAC;AACpF,QAAA,MAAM,eAAe,oCAAqC,CAAC;AAI3D;;;GAGG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAmB;IAEnC;;;;OAIG;gBACS,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB;gBACrD,OAAO,CAAC,EAAE,gBAAgB;IA0BtC;;OAEG;IACH,QAAQ,IAAI,QAAQ,EAAE;IAKtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAMjC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE;IAK/B;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,EAAE;IAI9C;;;OAGG;IACH,iBAAiB,IAAI,IAAI;IAczB;;OAEG;IACH,OAAO,CAAC,aAAa;CAYrB;AAUD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC"}

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

@@ -1,36 +1,136 @@
+/**
+ * Todo Store - Persistent todo list management
+ *
+ * @module agent/tools/todo-store
+ * @description
+ * Manages a todo list with optional persistence callbacks.
+ * The coding-agent uses this to integrate with SessionManager for session persistence.
+ *
+ * ## Architecture
+ *
+ * The TodoStore supports two modes:
+ * 1. **Simple mode** (default): Stores todos in memory only
+ * 2. **Persistent mode**: Uses callbacks to persist/load todos
+ *
+ * ## Usage
+ *
+ * ### Simple mode
+ * ```typescript
+ * const store = new TodoStore();
+ * store.setTodos([{ content: "Task", status: "pending", priority: "high" }]);
+ * ```
+ *
+ * ### Persistent mode (coding-agent style)
+ * ```typescript
+ * const store = new TodoStore({
+ *   persist: (todos) => sessionManager.appendCustomEntry('todo', { todos }),
+ *   load: () => loadFromSession(),
+ *   rebuildFromBranch: () => rebuildFromSession(),
+ * });
+ * ```
+ */
+const TODO_STATUSES = ["pending", "in_progress", "completed", "cancelled"];
+const TODO_PRIORITIES = ["high", "medium", "low"];
 /**
  * Simple Todo Store for the todo tool.
- * Simplified version for indusagi agent framework.
+ * Supports optional persistence callbacks for session integration.
  */
-export const TODO_STATUSES = ["pending", "in_progress", "completed", "cancelled"];
-export const TODO_PRIORITIES = ["high", "medium", "low"];
-function cloneTodos(todos) {
-    return todos.map((todo) => ({ ...todo }));
-}
 export class TodoStore {
-    constructor(initialTodos) {
+    constructor(initialTodosOrOptions, options) {
         this.todos = [];
-        if (initialTodos) {
-            this.todos = cloneTodos(initialTodos);
+        // Handle overloaded constructor
+        if (Array.isArray(initialTodosOrOptions)) {
+            this.todos = cloneTodos(initialTodosOrOptions);
+            this.options = options;
+        }
+        else {
+            this.options = initialTodosOrOptions;
+            // Load from persistence callback if available
+            if (this.options?.load) {
+                try {
+                    const loaded = this.options.load();
+                    if (Array.isArray(loaded)) {
+                        this.todos = cloneTodos(loaded);
+                    }
+                }
+                catch (error) {
+                    // Ignore load errors, start with empty
+                    this.todos = [];
+                }
+            }
         }
+        // Remove expired todos
+        this.removeExpired();
     }
+    /**
+     * Get all todos (returns a copy)
+     */
     getTodos() {
         this.removeExpired();
         return cloneTodos(this.todos);
     }
+    /**
+     * Set todos and persist
+     */
     setTodos(todos) {
         this.todos = cloneTodos(todos);
-        this.removeExpired();
+        this.options?.persist?.(this.todos);
+        this.options?.onChange?.(this.todos);
     }
+    /**
+     * Find todos matching a query
+     */
     find(query) {
-        const q = query.toLowerCase();
-        return this.getTodos().filter((t) => t.content.toLowerCase().includes(q));
+        const lowerQuery = query.toLowerCase();
+        return this.todos.filter((todo) => todo.content.toLowerCase().includes(lowerQuery));
     }
+    /**
+     * Filter todos by status
+     */
     filterByStatus(status) {
-        return this.getTodos().filter((t) => t.status === status);
+        return this.todos.filter((todo) => todo.status === status);
     }
-    removeExpired(now = Date.now()) {
-        this.todos = this.todos.filter((t) => t.expiresAt === undefined || t.expiresAt > now);
+    /**
+     * Rebuild todos from session branch
+     * Called when navigating the session tree
+     */
+    rebuildFromBranch() {
+        if (this.options?.rebuildFromBranch) {
+            try {
+                const rebuilt = this.options.rebuildFromBranch();
+                if (Array.isArray(rebuilt)) {
+                    this.todos = cloneTodos(rebuilt);
+                    this.options?.onChange?.(this.todos);
+                }
+            }
+            catch (error) {
+                // Ignore rebuild errors
+            }
+        }
+    }
+    /**
+     * Remove expired todos
+     */
+    removeExpired() {
+        const now = Date.now();
+        const before = this.todos.length;
+        this.todos = this.todos.filter((todo) => {
+            if (todo.expiresAt === undefined)
+                return true;
+            return todo.expiresAt > now;
+        });
+        // If any were removed, notify
+        if (this.todos.length !== before) {
+            this.options?.onChange?.(this.todos);
+        }
     }
 }
+/**
+ * Clone todos to prevent external mutation
+ */
+function cloneTodos(todos) {
+    return todos.map((todo) => ({ ...todo }));
+}
+// Export constants for external use
+export { TODO_STATUSES, TODO_PRIORITIES };
 //# sourceMappingURL=todo-store.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"todo-store.js","sourceRoot":"","sources":["../../../src/agent/tools/todo-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,CAAU,CAAC;AAG3F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC;AAUlE,SAAS,UAAU,CAAC,KAAiB;IACpC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,OAAO,SAAS;IAGrB,YAAY,YAAyB;QAF7B,UAAK,GAAe,EAAE,CAAC;QAG9B,IAAI,YAAY,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;IACF,CAAC;IAED,QAAQ;QACP,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAC,KAAiB;QACzB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,aAAa,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,KAAa;QACjB,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,cAAc,CAAC,MAAkB;QAChC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAC3D,CAAC;IAEO,aAAa,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;IACvF,CAAC;CACD"}
+{"version":3,"file":"todo-store.js","sourceRoot":"","sources":["../../../src/agent/tools/todo-store.ts"],"names":[],"mappings":"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"}

package/dist/agent/tools/todo-types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Todo Tool Types - Interfaces for extensible todo storage
+ *
+ * These interfaces allow the todo tool to be extended with custom persistence.
+ * The coding-agent uses these to integrate with SessionManager for session persistence.
+ */
+/**
+ * Todo item status
+ */
+export type TodoStatus = "pending" | "in_progress" | "completed" | "cancelled";
+/**
+ * Todo item priority
+ */
+export type TodoPriority = "high" | "medium" | "low";
+/**
+ * Todo item structure
+ */
+export interface TodoItem {
+    content: string;
+    status: TodoStatus;
+    priority: TodoPriority;
+    expiresAt?: number;
+}
+/**
+ * Todo tool details - returned after todo operations
+ */
+export interface TodoToolDetails {
+    todos: TodoItem[];
+    incompleteCount: number;
+}
+/**
+ * Options for TodoStore - allows custom persistence
+ *
+ * The coding-agent implements these to:
+ * - persist: Save todos to session entries
+ * - load: Load todos from session on startup
+ * - rebuildFromBranch: Restore todos when navigating session tree
+ */
+export interface TodoStoreOptions {
+    /**
+     * Persist todos to storage
+     * Called whenever todos are updated
+     */
+    persist?: (todos: TodoItem[]) => void;
+    /**
+     * Load todos from storage
+     * Called on TodoStore construction
+     */
+    load?: () => TodoItem[];
+    /**
+     * Rebuild todos from session branch
+     * Called when navigating the session tree
+     */
+    rebuildFromBranch?: () => TodoItem[];
+    /**
+     * Callback when todos change
+     * Useful for triggering UI updates
+     */
+    onChange?: (todos: TodoItem[]) => void;
+}
+/**
+ * Session manager interface for type safety
+ * The coding-agent's SessionManager implements this
+ */
+export interface TodoSessionManager {
+    appendCustomEntry(type: string, data: unknown): void;
+    getBranch(): Array<{
+        type?: string;
+        customType?: string;
+        data?: unknown;
+    }>;
+}
+//# sourceMappingURL=todo-types.d.ts.map

package/dist/agent/tools/todo-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-types.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/todo-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IAEtC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,QAAQ,EAAE,CAAC;IAExB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,QAAQ,EAAE,CAAC;IAErC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAClC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrD,SAAS,IAAI,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC3E"}

package/dist/agent/tools/todo-types.js

@@ -0,0 +1,8 @@
+/**
+ * Todo Tool Types - Interfaces for extensible todo storage
+ *
+ * These interfaces allow the todo tool to be extended with custom persistence.
+ * The coding-agent uses these to integrate with SessionManager for session persistence.
+ */
+export {};
+//# sourceMappingURL=todo-types.js.map

package/dist/agent/tools/todo-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-types.js","sourceRoot":"","sources":["../../../src/agent/tools/todo-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/agent/tools/todo.d.ts

@@ -1,5 +1,45 @@
+/**
+ * Todo Tools - Read and write todo lists
+ *
+ * @module agent/tools/todo
+ * @description
+ * Provides tools for managing todo lists. The todos are stored in a TodoStore
+ * which can optionally persist to external storage (e.g., session entries).
+ *
+ * ## Architecture
+ *
+ * Two tools are provided:
+ * - `todoread`: Read the current todo list
+ * - `todowrite`: Update the todo list
+ *
+ * Both tools share the same TodoStore instance for consistency.
+ *
+ * ## Usage
+ *
+ * ### Simple mode
+ * ```typescript
+ * import { todoReadTool, todoWriteTool } from "indusagi/agent";
+ * // Uses default in-memory store
+ * ```
+ *
+ * ### With custom store (persistent mode)
+ * ```typescript
+ * import { createTodoReadTool, createTodoWriteTool, TodoStore } from "indusagi/agent";
+ *
+ * const store = new TodoStore({
+ *   persist: (todos) => sessionManager.appendCustomEntry('todo', { todos }),
+ *   load: () => loadFromSession(),
+ * });
+ *
+ * const todoReadTool = createTodoReadTool(store);
+ * const todoWriteTool = createTodoWriteTool(store);
+ * ```
+ */
 import type { AgentTool } from "../types.js";
-import { TodoStore, type TodoItem } from "./todo-store.js";
+import { TodoStore } from "./todo-store.js";
+import type { TodoToolDetails } from "./todo-types.js";
+export type { TodoItem, TodoStatus, TodoPriority, TodoStoreOptions, TodoToolDetails } from "./todo-types.js";
+export { TodoStore, TODO_PRIORITIES, TODO_STATUSES } from "./todo-store.js";
 declare const TodoReadSchema: import("@sinclair/typebox").TObject<{}>;
 declare const TodoWriteSchema: import("@sinclair/typebox").TObject<{
     todos: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
@@ -10,13 +50,21 @@ declare const TodoWriteSchema: import("@sinclair/typebox").TObject<{
     search: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"in_progress" | "completed" | "cancelled" | "pending">>;
 }>;
-export interface TodoToolDetails {
-    todos: TodoItem[];
-    incompleteCount: number;
-}
+/**
+ * Create a todo read tool
+ * @param store - The TodoStore to read from
+ * @returns The todoread tool
+ */
 export declare function createTodoReadTool(store: TodoStore): AgentTool<typeof TodoReadSchema, TodoToolDetails>;
+/**
+ * Create a todo write tool
+ * @param store - The TodoStore to write to
+ * @returns The todowrite tool
+ */
 export declare function createTodoWriteTool(store: TodoStore): AgentTool<typeof TodoWriteSchema, TodoToolDetails>;
+/** Default todo read tool using in-memory store */
 export declare const todoReadTool: AgentTool<import("@sinclair/typebox").TObject<{}>, TodoToolDetails>;
+/** Default todo write tool using in-memory store */
 export declare const todoWriteTool: AgentTool<import("@sinclair/typebox").TObject<{
     todos: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
         content: import("@sinclair/typebox").TString;
@@ -26,5 +74,4 @@ export declare const todoWriteTool: AgentTool<import("@sinclair/typebox").TObjec
     search: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"in_progress" | "completed" | "cancelled" | "pending">>;
 }>, TodoToolDetails>;
-export {};
 //# sourceMappingURL=todo.d.ts.map