@code-yeongyu/senpi 2026.7.17 → 2026.7.20

package/dist/core/extensions/builtin/todotools/state.d.ts

@@ -1,29 +1,82 @@
+import type { SessionEntry } from "../../../session-manager.ts";
+export type TodoStatus = "pending" | "in_progress" | "completed" | "abandoned";
+export type TodoOperation = "init" | "start" | "done" | "rm" | "drop" | "append" | "view";
 export type TodoItem = {
     content: string;
-    status: string;
-    priority: string;
+    status: TodoStatus;
 };
-export type TodoWriteDetails = {
-    todos: TodoItem[];
+export type TodoPhase = {
+    name: string;
+    tasks: TodoItem[];
 };
-export type TodoStateEntry = {
-    todos: TodoItem[];
+export type TodoCompletionTransition = {
+    phase: string;
+    content: string;
+};
+export type TodoToolDetails = {
+    op?: TodoOperation;
+    phases: TodoPhase[];
+    storage: "session" | "memory";
+    completedTasks?: TodoCompletionTransition[];
 };
-type BranchEntry = {
-    type: string;
-    customType?: string;
-    data?: unknown;
-    message?: unknown;
+export type TodoStateEntry = {
+    schema: "v2";
+    phases: TodoPhase[];
 };
 export declare const TODO_STATE_ENTRY_TYPE = "senpi.todo-state";
+export declare const DEFAULT_INIT_PHASE = "Tasks";
+type TodoPhaseInput = {
+    phase: string;
+    items: string[];
+};
+export type TodoOpEntry = {
+    op: TodoOperation;
+    list?: TodoPhaseInput[];
+    task?: string;
+    phase?: string;
+    items?: string[];
+};
+type TaskHit = {
+    task: TodoItem;
+    phase: TodoPhase;
+};
+type BranchEntry = SessionEntry;
+export declare function findTaskByContent(phases: TodoPhase[], content: string): TaskHit | undefined;
+export declare function findPhaseByName(phases: TodoPhase[], name: string): TodoPhase | undefined;
+export declare function cloneTask(task: TodoItem): TodoItem;
+export declare function clonePhases(phases: readonly TodoPhase[]): TodoPhase[];
+export declare function normalizeInProgressTask(phases: TodoPhase[]): void;
+/** Return the active task, preferring an in-progress item over the first pending item. */
+export declare function nextActionableTask(phases: readonly TodoPhase[]): TodoItem | undefined;
+export declare function getCompletionTransitions(previous: readonly TodoPhase[], updated: readonly TodoPhase[]): TodoCompletionTransition[];
+export declare function resolveTaskOrError(phases: TodoPhase[], content: string | undefined, errors: string[]): TaskHit | undefined;
+export declare function resolvePhaseOrError(phases: TodoPhase[], name: string | undefined, errors: string[]): TodoPhase | undefined;
+export declare function getTaskTargets(phases: TodoPhase[], entry: TodoOpEntry, errors: string[]): TodoItem[];
+export declare function initPhases(entry: TodoOpEntry, errors: string[]): TodoPhase[];
+export declare function appendItems(phases: TodoPhase[], entry: TodoOpEntry, errors: string[]): TodoPhase[];
+export declare function removeTasks(phases: TodoPhase[], entry: TodoOpEntry, errors: string[]): TodoPhase[];
+export declare function applyEntry(phases: TodoPhase[], entry: TodoOpEntry, errors: string[]): TodoPhase[];
+export declare function applyParams(phases: TodoPhase[], params: TodoOpEntry): {
+    phases: TodoPhase[];
+    errors: string[];
+};
+export declare function applyOpsToPhases(currentPhases: readonly TodoPhase[], ops: readonly TodoOpEntry[]): {
+    phases: TodoPhase[];
+    errors: string[];
+};
+export declare function formatSummary(phases: readonly TodoPhase[], errors: readonly string[], readOnly?: boolean): string;
+export declare function sanitizeTodoText(text: string): string;
 export declare function isTerminalTodoStatus(status: string): boolean;
 export declare function isIncompleteTodo(todo: TodoItem): boolean;
-export declare function sanitizeTodoText(text: string): string;
 export declare function getTodoMarker(status: string): string;
-export declare function getTodoWidgetLines(todos: TodoItem[]): string[] | undefined;
-export declare function getTodoResultLines(todos: TodoItem[]): string[];
+export declare function getTodoWidgetLines(phases: readonly TodoPhase[]): string[] | undefined;
+export declare function getTodoResultLines(phases: readonly TodoPhase[]): string[];
 export declare function isTodoItem(value: unknown): value is TodoItem;
 export declare function isTodoItemArray(value: unknown): value is TodoItem[];
+export declare function isTodoPhase(value: unknown): value is TodoPhase;
+export declare function isTodoPhaseArray(value: unknown): value is TodoPhase[];
+export declare function getLatestPhasesFromBranchEntries(entries: BranchEntry[]): TodoPhase[];
+/** Compatibility reader for callers that still expect the old flat array. */
 export declare function getLatestTodosFromBranchEntries(entries: BranchEntry[]): TodoItem[];
 export {};
 //# sourceMappingURL=state.d.ts.map

package/dist/core/extensions/builtin/todotools/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/state.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB,CAAC;AAEF,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5F,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAExD;AAMD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAK1E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAK9D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAM5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,EAAE,CAEnE;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,QAAQ,EAAE,CA4BlF"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/state.ts"],"names":[],"mappings":"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"}

package/dist/core/extensions/builtin/todotools/state.js

@@ -1,13 +1,355 @@
+// Ported and adapted from oh-my-pi's todo tool (MIT License).
+// Copyright (c) 2025 Mario Zechner
+// Copyright (c) 2025-2026 Can Bölük
+// https://github.com/can1357/oh-my-pi
 import { stripAnsi } from "../../../../utils/ansi.js";
 export const TODO_STATE_ENTRY_TYPE = "senpi.todo-state";
-export function isTerminalTodoStatus(status) {
-    return status === "completed" || status === "cancelled";
+export const DEFAULT_INIT_PHASE = "Tasks";
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
 }
-export function isIncompleteTodo(todo) {
-    return !isTerminalTodoStatus(todo.status);
+function isTodoStatus(value) {
+    return value === "pending" || value === "in_progress" || value === "completed" || value === "abandoned";
+}
+function parseTodoStatus(value) {
+    if (value === "cancelled")
+        return "abandoned";
+    return isTodoStatus(value) ? value : undefined;
+}
+function parseTodoItem(value, options) {
+    if (!isRecord(value) || typeof value.content !== "string")
+        return undefined;
+    const status = parseTodoStatus(value.status) ?? (options?.lenient ? "pending" : undefined);
+    return status ? { content: value.content, status } : undefined;
+}
+function parseTodoPhase(value) {
+    if (!isRecord(value) || typeof value.name !== "string" || !Array.isArray(value.tasks))
+        return undefined;
+    const tasks = [];
+    for (const task of value.tasks) {
+        const parsed = parseTodoItem(task);
+        if (!parsed)
+            return undefined;
+        tasks.push(parsed);
+    }
+    return { name: value.name, tasks };
+}
+function parsePhases(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const phases = [];
+    for (const phase of value) {
+        const parsed = parseTodoPhase(phase);
+        if (!parsed)
+            return undefined;
+        phases.push(parsed);
+    }
+    return phases;
 }
-function countOpenTodos(todos) {
-    return todos.filter(isIncompleteTodo).length;
+function parseLegacyTodos(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const tasks = [];
+    for (const todo of value) {
+        // Legacy todowrite persisted arbitrary status strings (e.g. "blocked").
+        // Preserve those entries instead of dropping the whole list: unknown
+        // statuses become "pending" so the task survives migration as open work.
+        const parsed = parseTodoItem(todo, { lenient: true });
+        if (!parsed)
+            return undefined;
+        tasks.push(parsed);
+    }
+    return [{ name: DEFAULT_INIT_PHASE, tasks }];
+}
+function readTodoPayload(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (value.schema === "v2")
+        return parsePhases(value.phases);
+    if (Array.isArray(value.phases))
+        return parsePhases(value.phases);
+    if (Array.isArray(value.todos))
+        return parseLegacyTodos(value.todos);
+    return undefined;
+}
+export function findTaskByContent(phases, content) {
+    for (const phase of phases) {
+        const task = phase.tasks.find((candidate) => candidate.content === content);
+        if (task)
+            return { task, phase };
+    }
+    return undefined;
+}
+export function findPhaseByName(phases, name) {
+    return phases.find((phase) => phase.name === name);
+}
+export function cloneTask(task) {
+    return { content: task.content, status: task.status };
+}
+export function clonePhases(phases) {
+    return phases.map((phase) => ({ name: phase.name, tasks: phase.tasks.map(cloneTask) }));
+}
+export function normalizeInProgressTask(phases) {
+    const orderedTasks = phases.flatMap((phase) => phase.tasks);
+    if (orderedTasks.length === 0)
+        return;
+    const inProgressTasks = orderedTasks.filter((task) => task.status === "in_progress");
+    if (inProgressTasks.length > 1) {
+        for (const task of inProgressTasks.slice(1))
+            task.status = "pending";
+    }
+    if (inProgressTasks.length > 0)
+        return;
+    const firstPendingTask = orderedTasks.find((task) => task.status === "pending");
+    if (firstPendingTask)
+        firstPendingTask.status = "in_progress";
+}
+/** Return the active task, preferring an in-progress item over the first pending item. */
+export function nextActionableTask(phases) {
+    let firstPending;
+    for (const phase of phases) {
+        for (const task of phase.tasks) {
+            if (task.status === "in_progress")
+                return task;
+            if (!firstPending && task.status === "pending")
+                firstPending = task;
+        }
+    }
+    return firstPending;
+}
+export function getCompletionTransitions(previous, updated) {
+    const previousStatuses = new Map();
+    for (const phase of previous) {
+        for (const task of phase.tasks)
+            previousStatuses.set(`${phase.name}\u0000${task.content}`, task.status);
+    }
+    const transitions = [];
+    for (const phase of updated) {
+        for (const task of phase.tasks) {
+            if (task.status !== "completed")
+                continue;
+            const previousStatus = previousStatuses.get(`${phase.name}\u0000${task.content}`);
+            if (previousStatus && previousStatus !== "completed") {
+                transitions.push({ phase: phase.name, content: task.content });
+            }
+        }
+    }
+    return transitions;
+}
+export function resolveTaskOrError(phases, content, errors) {
+    if (!content) {
+        errors.push("Missing task content");
+        return undefined;
+    }
+    const hit = findTaskByContent(phases, content);
+    if (!hit) {
+        if (/^task-\d+$/.test(content)) {
+            errors.push(`Task "${content}" not found. Tasks are referenced by content, not by IDs — pass the task's full text from the previous result.`);
+        }
+        else {
+            const totalTasks = phases.reduce((sum, phase) => sum + phase.tasks.length, 0);
+            const hint = totalTasks === 0 ? " (todo list is empty — was it replaced or not yet created?)" : "";
+            errors.push(`Task "${content}" not found${hint}`);
+        }
+    }
+    return hit;
+}
+export function resolvePhaseOrError(phases, name, errors) {
+    if (!name) {
+        errors.push("Missing phase name");
+        return undefined;
+    }
+    const phase = findPhaseByName(phases, name);
+    if (!phase)
+        errors.push(`Phase "${name}" not found`);
+    return phase;
+}
+export function getTaskTargets(phases, entry, errors) {
+    if (entry.task) {
+        const hit = resolveTaskOrError(phases, entry.task, errors);
+        return hit ? [hit.task] : [];
+    }
+    if (entry.phase) {
+        const phase = resolvePhaseOrError(phases, entry.phase, errors);
+        return phase ? [...phase.tasks] : [];
+    }
+    return phases.flatMap((phase) => phase.tasks);
+}
+export function initPhases(entry, errors) {
+    const list = entry.list ??
+        (entry.items && entry.items.length > 0
+            ? [{ phase: entry.phase ?? DEFAULT_INIT_PHASE, items: entry.items }]
+            : undefined);
+    if (!list) {
+        errors.push("Missing list for init operation");
+        return [];
+    }
+    const seenPhases = new Set();
+    const seenTasks = new Set();
+    for (const listEntry of list) {
+        if (seenPhases.has(listEntry.phase))
+            errors.push(`Duplicate phase "${listEntry.phase}" in init list`);
+        seenPhases.add(listEntry.phase);
+        if (listEntry.items.length === 0)
+            errors.push(`Phase "${listEntry.phase}" has no tasks in init list`);
+        for (const content of listEntry.items) {
+            if (seenTasks.has(content))
+                errors.push(`Duplicate task "${content}" in init list`);
+            seenTasks.add(content);
+        }
+    }
+    return list.map((listEntry) => ({
+        name: listEntry.phase,
+        tasks: listEntry.items.map((content) => ({ content, status: "pending" })),
+    }));
+}
+export function appendItems(phases, entry, errors) {
+    if (!entry.phase) {
+        errors.push("Missing phase name for append operation");
+        return phases;
+    }
+    if (!entry.items || entry.items.length === 0) {
+        errors.push("Missing items for append operation");
+        return phases;
+    }
+    const seen = new Set();
+    let hasDuplicate = false;
+    for (const content of entry.items) {
+        if (seen.has(content) || findTaskByContent(phases, content)) {
+            errors.push(`Task "${content}" already exists`);
+            hasDuplicate = true;
+        }
+        seen.add(content);
+    }
+    if (hasDuplicate)
+        return phases;
+    let phase = findPhaseByName(phases, entry.phase);
+    if (!phase) {
+        phase = { name: entry.phase, tasks: [] };
+        phases.push(phase);
+    }
+    for (const content of entry.items)
+        phase.tasks.push({ content, status: "pending" });
+    return phases;
+}
+export function removeTasks(phases, entry, errors) {
+    if (entry.task) {
+        const hit = resolveTaskOrError(phases, entry.task, errors);
+        if (!hit)
+            return phases;
+        hit.phase.tasks = hit.phase.tasks.filter((candidate) => candidate !== hit.task);
+        return phases;
+    }
+    if (entry.phase) {
+        const phase = resolvePhaseOrError(phases, entry.phase, errors);
+        if (!phase)
+            return phases;
+        phase.tasks = [];
+        return phases;
+    }
+    for (const phase of phases)
+        phase.tasks = [];
+    return phases;
+}
+export function applyEntry(phases, entry, errors) {
+    switch (entry.op) {
+        case "init":
+            return initPhases(entry, errors);
+        case "start": {
+            const hit = resolveTaskOrError(phases, entry.task, errors);
+            if (!hit)
+                return phases;
+            for (const phase of phases) {
+                for (const candidate of phase.tasks) {
+                    if (candidate.status === "in_progress" && candidate !== hit.task)
+                        candidate.status = "pending";
+                }
+            }
+            hit.task.status = "in_progress";
+            return phases;
+        }
+        case "done":
+            for (const task of getTaskTargets(phases, entry, errors))
+                task.status = "completed";
+            return phases;
+        case "drop":
+            for (const task of getTaskTargets(phases, entry, errors))
+                task.status = "abandoned";
+            return phases;
+        case "rm":
+            return removeTasks(phases, entry, errors);
+        case "append":
+            return appendItems(phases, entry, errors);
+        case "view":
+            return phases;
+    }
+}
+export function applyParams(phases, params) {
+    if (params.op === "view")
+        return { phases, errors: [] };
+    const original = clonePhases(phases);
+    const errors = [];
+    const next = applyEntry(phases, params, errors);
+    if (errors.length > 0)
+        return { phases: original, errors };
+    normalizeInProgressTask(next);
+    return { phases: next, errors };
+}
+export function applyOpsToPhases(currentPhases, ops) {
+    const errors = [];
+    let next = clonePhases(currentPhases);
+    for (const op of ops)
+        next = applyEntry(next, op, errors);
+    if (errors.length > 0)
+        return { phases: clonePhases(currentPhases), errors };
+    normalizeInProgressTask(next);
+    return { phases: next, errors };
+}
+export function formatSummary(phases, errors, readOnly = false) {
+    const tasks = phases.flatMap((phase) => phase.tasks);
+    if (tasks.length === 0) {
+        if (errors.length > 0)
+            return `Errors: ${errors.join("; ")}`;
+        return readOnly ? "Todo list is empty." : "Todo list cleared.";
+    }
+    const remainingByPhase = phases
+        .map((phase) => ({
+        name: phase.name,
+        tasks: phase.tasks.filter((task) => task.status === "pending" || task.status === "in_progress"),
+    }))
+        .filter((phase) => phase.tasks.length > 0);
+    const remainingTasks = remainingByPhase.flatMap((phase) => phase.tasks.map((task) => ({ ...task, phase: phase.name })));
+    let currentIdx = phases.findIndex((phase) => phase.tasks.some((task) => task.status === "pending" || task.status === "in_progress"));
+    if (currentIdx === -1)
+        currentIdx = phases.length - 1;
+    const current = phases[currentIdx];
+    const done = current.tasks.filter((task) => task.status === "completed" || task.status === "abandoned").length;
+    const lines = [];
+    if (errors.length > 0)
+        lines.push(`Errors: ${errors.join("; ")}`);
+    if (remainingTasks.length === 0) {
+        lines.push("Remaining items: none.");
+    }
+    else {
+        lines.push(`Remaining items (${remainingTasks.length}):`);
+        for (const task of remainingTasks)
+            lines.push(`  - ${task.content} [${task.status}] (${task.phase})`);
+    }
+    const closedAll = tasks.filter((task) => task.status === "completed" || task.status === "abandoned").length;
+    const workedAhead = phases.some((phase, index) => index > currentIdx && phase.tasks.some((task) => task.status === "completed" || task.status === "abandoned"));
+    lines.push(`Overall: ${closedAll}/${tasks.length} done, ${remainingTasks.length} open.`);
+    lines.push(`Active phase ${currentIdx + 1}/${phases.length} "${current.name}" (${done}/${current.tasks.length})${workedAhead
+        ? " — earliest phase with open tasks; the in-progress pointer auto-advances to the earliest open task on each completion, so it can sit behind out-of-order work (nothing was un-completed)."
+        : "."}`);
+    for (const phase of phases) {
+        lines.push(`  ${phase.name}:`);
+        for (const task of phase.tasks) {
+            const checkbox = task.status === "completed" ? "[X]" : "[ ]";
+            const tag = task.status === "in_progress" ? " (in progress)" : task.status === "abandoned" ? " (dropped)" : "";
+            lines.push(`    - ${checkbox} ${task.content}${tag}`);
+        }
+    }
+    return lines.join("\n");
 }
 export function sanitizeTodoText(text) {
     return stripAnsi(text)
@@ -16,59 +358,82 @@ export function sanitizeTodoText(text) {
         .replace(/\s+/g, " ")
         .trim();
 }
+export function isTerminalTodoStatus(status) {
+    return status === "completed" || status === "abandoned" || status === "cancelled";
+}
+export function isIncompleteTodo(todo) {
+    return !isTerminalTodoStatus(todo.status);
+}
 export function getTodoMarker(status) {
     if (status === "completed")
         return "[✓]";
     if (status === "in_progress")
         return "[•]";
-    if (status === "cancelled")
+    if (status === "abandoned" || status === "cancelled")
         return "[×]";
     return "[ ]";
 }
-export function getTodoWidgetLines(todos) {
-    if (todos.length === 0 || !todos.some(isIncompleteTodo)) {
+function getActivePhase(phases) {
+    const activeTask = nextActionableTask(phases);
+    if (!activeTask)
         return undefined;
-    }
-    return ["Todo", ...todos.map((todo) => `${getTodoMarker(todo.status)} ${sanitizeTodoText(todo.content)}`)];
+    return phases.find((phase) => phase.tasks.includes(activeTask));
+}
+export function getTodoWidgetLines(phases) {
+    const activePhase = getActivePhase(phases);
+    if (!activePhase)
+        return undefined;
+    return [
+        "Todo",
+        sanitizeTodoText(activePhase.name),
+        ...activePhase.tasks.map((todo) => `${getTodoMarker(todo.status)} ${sanitizeTodoText(todo.content)}`),
+    ];
 }
-export function getTodoResultLines(todos) {
+export function getTodoResultLines(phases) {
+    const tasks = phases.flatMap((phase) => phase.tasks);
     return [
-        `${countOpenTodos(todos)} todos`,
-        ...todos.map((todo) => `${getTodoMarker(todo.status)} ${sanitizeTodoText(todo.content)}`),
+        `${tasks.filter(isIncompleteTodo).length} todos`,
+        ...phases.flatMap((phase) => [
+            `${sanitizeTodoText(phase.name)}:`,
+            ...phase.tasks.map((todo) => `${getTodoMarker(todo.status)} ${sanitizeTodoText(todo.content)}`),
+        ]),
     ];
 }
 export function isTodoItem(value) {
-    if (typeof value !== "object" || value === null) {
-        return false;
-    }
-    const item = value;
-    return typeof item.content === "string" && typeof item.status === "string" && typeof item.priority === "string";
+    return parseTodoItem(value) !== undefined;
 }
 export function isTodoItemArray(value) {
     return Array.isArray(value) && value.every(isTodoItem);
 }
-export function getLatestTodosFromBranchEntries(entries) {
-    let todos = [];
+export function isTodoPhase(value) {
+    return parseTodoPhase(value) !== undefined;
+}
+export function isTodoPhaseArray(value) {
+    return Array.isArray(value) && value.every(isTodoPhase);
+}
+export function getLatestPhasesFromBranchEntries(entries) {
+    let phases = [];
     for (const entry of entries) {
         if (entry.type === "custom" && entry.customType === TODO_STATE_ENTRY_TYPE) {
-            const data = entry.data;
-            if (isTodoItemArray(data?.todos)) {
-                todos = data.todos.map((todo) => ({ ...todo }));
-            }
+            const parsed = readTodoPayload(entry.data);
+            if (parsed)
+                phases = clonePhases(parsed);
             continue;
         }
-        if (entry.type !== "message" || typeof entry.message !== "object" || entry.message === null) {
+        if (entry.type !== "message" || !isRecord(entry.message))
             continue;
-        }
-        const message = entry.message;
-        if (message.role !== "toolResult" || message.toolName !== "todowrite") {
+        if (entry.message.role !== "toolResult")
             continue;
-        }
-        const details = message.details;
-        if (isTodoItemArray(details?.todos)) {
-            todos = details.todos.map((todo) => ({ ...todo }));
-        }
+        if (entry.message.toolName !== "todo" && entry.message.toolName !== "todowrite")
+            continue;
+        const parsed = readTodoPayload(entry.message.details);
+        if (parsed)
+            phases = clonePhases(parsed);
     }
-    return todos;
+    return phases;
+}
+/** Compatibility reader for callers that still expect the old flat array. */
+export function getLatestTodosFromBranchEntries(entries) {
+    return getLatestPhasesFromBranchEntries(entries).flatMap((phase) => phase.tasks.map(cloneTask));
 }
 //# sourceMappingURL=state.js.map