| 1 | ### goal |
| 2 | Inspect, create, or finish the current chat goal. |
| 3 | |
| 4 | Use this only when the user asks for a goal or asks you to manage one. Do not create goals for casual replies or ordinary one-shot answers. |
| 5 | |
| 6 | Actions: |
| 7 | - `get`: inspect the current goal; use this before creating one when its state is unknown. |
| 8 | - `create`: make the given concise `objective` active; optional positive `token_budget`. |
| 9 | - `update`: mark the current goal with `status` `complete` or `blocked`; optional revised `objective` and `note`. |
| 10 | |
| 11 | Pause, resume, edit, and delete are user controls. Mark `complete` only after achieving the objective; mark `blocked` only after viable alternatives are exhausted and work cannot continue without user input or an external-state change. |
| 12 | |
| 13 | Example: |
| 14 | ~~~json |
| 15 | { |
| 16 | "thoughts": ["The user asked me to manage this task as a goal."], |
| 17 | "headline": "Creating goal", |
| 18 | "tool_name": "goal", |
| 19 | "tool_args": { |
| 20 | "action": "create", |
| 21 | "objective": "Add the built-in goal plugin with a Web UI strip and slash command" |
| 22 | } |
| 23 | } |
| 24 | ~~~ |