goal_open

Open a goal describing the task you are starting. Goals persist for the whole task and the runtime keeps chaining turns until each goal is done, blocked, or cancelled. Open one goal per distinct user-facing task, never per turn or per step.

User guide / All capabilities

Contract

Effect: read. Evidence role: discovery_only.

Open a persistent goal for the current task.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "body": {
      "type": "string",
      "description": "The user-facing task in one sentence. Write it as the user asked (e.g. 'Gerir newsletter semanal: pesquisar, redigir e enviar para #novidades'). Max ~4000 chars."
    },
    "label": {
      "type": "string",
      "description": "Optional short tag for filtering later (e.g. 'newsletter', 'cleanup'). Keep short and lowercase."
    }
  },
  "required": [
    "body"
  ]
}

Execution requirements

The ordinary admission and tool execution checks apply.

Expected postconditions

• one goal saved in the active working state