manage-goals

name	manage-goals
type	python
description	Create, list, update, and delete scheduled goals. Goals are persistent tasks that can run manually, automatically, or on a daily schedule.
schema_hint	{"action":"string: create | list | update | delete","goal_text":"string (required for create): the goal instruction text","goal_id":"string (required for update/delete): e.g. goal_3","name":"string (optional): short display name for the goal","schedule_mode":"string (optional): manual | auto | daily","run_at":"string (optional, for daily): time in HH:MM format, e.g. 09:00"}

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"}