Todo Tool

from orxhestra import LlmAgent
from orxhestra.tools.todo_tool import TodoList, make_todo_tool
from orxhestra.planners.task_planner import TaskPlanner

todo_list = TodoList()
todo_tool = make_todo_tool(todo_list)
planner = TaskPlanner(todo_list=todo_list)

agent = LlmAgent(
    name="ProjectAgent",
    model=model,
    tools=[todo_tool],
    planner=planner,
    instructions="Use write_todos to track your work on multi-step tasks.",
)

[
  {"content": "Research the topic", "status": "completed"},
  {"content": "Write the outline", "status": "in_progress"},
  {"content": "Draft the article", "status": "pending"},
  {"content": "Review and edit", "status": "pending", "required": true}
]

Current tasks (v3):
  t1 [done] Research the topic
  t2 [in_progress] Write the outline
  t3 [pending] Draft the article
  t4 [pending] Review and edit (required)

Progress: 1/4 completed.

planner = TaskPlanner(
    todo_list=todo_list,
    tasks=[
        {"title": "Research", "status": "pending"},
        {"title": "Write", "status": "pending"},
        {"title": "Review", "status": "pending"},
    ],
)

planner.has_pending_tasks(readonly_context)  # True if any task is not completed

from orxhestra.tools.todo_tool import TodoList

todo_list = TodoList()

# Update tasks
todo_list.update([
    {"content": "Step 1", "status": "completed"},
    {"content": "Step 2", "status": "in_progress"},
], actor="MyAgent")

# Check status
todo_list.has_pending()       # True
todo_list.get_active_task()   # "Step 2"
todo_list.build_status_text() # Formatted status block
todo_list.render()            # Rich-formatted output (for CLI)

# Access
todo_list.todos    # list[dict]
todo_list.version  # int (incremented on each update)