refactor: integrate TodoListMiddleware and update related components

- Removed the write_todos tool as it is now included by default through TodoListMiddleware in the deep agent.
- Updated the system prompt and documentation to reflect the integration of TodoListMiddleware, clarifying its capabilities for managing planning and todo lists.
- Enhanced the chat handling logic to extract todos directly from the deep agent's command output, ensuring seamless user experience.
- Refactored UI components to align with the new data structure and improve rendering of todo items, including updates to the Plan and TodoItem components.
- Cleaned up code for better maintainability and readability, following recent refactoring efforts.

surfsense_web/components/tool-ui/plan/schema.ts

@@ -8,23 +8,25 @@ export type TodoStatus = z.infer<typeof TodoStatusSchema>;
 
 /**
  * Single todo item in a plan
+ * Matches deepagents TodoListMiddleware output: { content, status }
+ * id is auto-generated if not provided
  */
 export const PlanTodoSchema = z.object({
-	id: z.string(),
-	label: z.string(),
+	id: z.string().optional(),
+	content: z.string(),
 	status: TodoStatusSchema,
-	description: z.string().optional(),
 });
 
 export type PlanTodo = z.infer<typeof PlanTodoSchema>;
 
 /**
  * Serializable plan schema for tool results
+ * Matches deepagents TodoListMiddleware output format
+ * id/title are auto-generated if not provided
  */
 export const SerializablePlanSchema = z.object({
-	id: z.string(),
-	title: z.string(),
-	description: z.string().optional(),
+	id: z.string().optional(),
+	title: z.string().optional(),
 	todos: z.array(PlanTodoSchema).min(1),
 	maxVisibleTodos: z.number().optional(),
 	showProgress: z.boolean().optional(),
@@ -33,9 +35,21 @@ export const SerializablePlanSchema = z.object({
 export type SerializablePlan = z.infer<typeof SerializablePlanSchema>;
 
 /**
- * Parse and validate a serializable plan from tool result
+ * Normalized plan with required fields (after auto-generation)
  */
-export function parseSerializablePlan(data: unknown): SerializablePlan {
+export interface NormalizedPlan {
+	id: string;
+	title: string;
+	todos: Array<{ id: string; content: string; status: TodoStatus }>;
+	maxVisibleTodos?: number;
+	showProgress?: boolean;
+}
+
+/**
+ * Parse and normalize a plan from tool result
+ * Auto-generates id/title if not provided (for deepagents compatibility)
+ */
+export function parseSerializablePlan(data: unknown): NormalizedPlan {
 	const result = SerializablePlanSchema.safeParse(data);
 
 	if (!result.success) {
@@ -45,22 +59,33 @@ export function parseSerializablePlan(data: unknown): SerializablePlan {
 		const obj = (data && typeof data === "object" ? data : {}) as Record<string, unknown>;
 
 		return {
-			id: typeof obj.id === "string" ? obj.id : "unknown",
+			id: typeof obj.id === "string" ? obj.id : `plan-${Date.now()}`,
 			title: typeof obj.title === "string" ? obj.title : "Plan",
-			description: typeof obj.description === "string" ? obj.description : undefined,
 			todos: Array.isArray(obj.todos)
-				? obj.todos.map((t, i) => ({
-						id: typeof (t as any)?.id === "string" ? (t as any).id : `todo-${i}`,
-						label: typeof (t as any)?.label === "string" ? (t as any).label : "Task",
-						status: TodoStatusSchema.safeParse((t as any)?.status).success
-							? (t as any).status
-							: "pending",
-						description:
-							typeof (t as any)?.description === "string" ? (t as any).description : undefined,
-					}))
-				: [{ id: "1", label: "No tasks", status: "pending" as const }],
+				? obj.todos.map((t: unknown, i: number) => {
+						const todo = t as Record<string, unknown>;
+						return {
+							id: typeof todo?.id === "string" ? todo.id : `todo-${i}`,
+							content: typeof todo?.content === "string" ? todo.content : "Task",
+							status: TodoStatusSchema.safeParse(todo?.status).success
+								? (todo.status as TodoStatus)
+								: ("pending" as const),
+						};
+					})
+				: [{ id: "1", content: "No tasks", status: "pending" as const }],
 		};
 	}
 
-	return result.data;
+	// Normalize: add id/title if missing
+	return {
+		id: result.data.id || `plan-${Date.now()}`,
+		title: result.data.title || "Plan",
+		todos: result.data.todos.map((t, i) => ({
+			id: t.id || `todo-${i}`,
+			content: t.content,
+			status: t.status,
+		})),
+		maxVisibleTodos: result.data.maxVisibleTodos,
+		showProgress: result.data.showProgress,
+	};
 }