Manage Goals

manage-goals

Create, list, update, and delete scheduled goals. Goals are persistent tasks that can be triggered manually, automatically by the scheduler, or on a daily schedule at a specific time.

Actions

create

Create a new scheduled goal.

• goal_text (required): The full goal instruction text. Be specific — this is what the planner will execute.
• name (optional): Short display name (max 120 chars). Defaults to first 120 chars of goal_text.
• schedule_mode (optional): manual (default), auto, or daily.
• run_at (optional): For daily mode, the time to run in HH:MM format (e.g. "09:00").

list

List all scheduled goals with their status, schedule mode, and last result. No additional parameters needed.

update

Update an existing scheduled goal's properties.

• goal_id (required): The goal ID (e.g. "goal_3").
• name (optional): New display name.
• goal_text (optional): New goal instruction text.
• schedule_mode (optional): New schedule mode (manual, auto, daily).
• run_at (optional): New run time for daily mode.
• status (optional): Set status (e.g. "ready" to re-enable a completed goal).

delete

Delete a scheduled goal permanently.

• goal_id (required): The goal ID to delete.

Output

• value: Human-readable summary of what was done.
• data: Structured result (goal dict for create/update, list of goals for list, boolean for delete).

Examples

{"type": "manage-goals", "action": "create", "goal_text": "Fetch latest news headlines from BBC and summarize them", "name": "Daily news summary", "schedule_mode": "daily", "run_at": "09:00", "out": "$new_goal"}

{"type": "manage-goals", "action": "list", "out": "$goals"}

{"type": "manage-goals", "action": "update", "goal_id": "goal_3", "schedule_mode": "daily", "run_at": "08:30", "out": "$updated"}

{"type": "manage-goals", "action": "delete", "goal_id": "goal_3", "out": "$deleted"}

Common Workflows

User asks to set up a recurring task:

{"type": "manage-goals", "action": "create", "goal_text": "Check email and summarize new messages", "name": "Morning email check", "schedule_mode": "daily", "run_at": "08:00", "out": "$goal"}
{"type": "say", "target": "User", "value": "Done — I've scheduled a daily email check for 8:00 AM."}

User asks what's scheduled:

{"type": "manage-goals", "action": "list", "out": "$goals"}

User asks to change a goal's schedule:

{"type": "manage-goals", "action": "update", "goal_id": "goal_2", "run_at": "07:30", "out": "$updated"}