Command · behavior

behavior.state.add

Add an empty state at the top level or under a parent.

scope edit:scenenot idempotentnon-destructive

Params

Typed as BehaviorStateAddParams. Fields marked * are required.

name*

string

New unique state name.

required

parent

option<string>

Parent state name; top level when absent.

default null

when

option<string>

Entry condition expression.

default null

JSON (MCP ara_apply, batches)

{
  "cmd": "behavior.state.add",
  "args": {
    "name": "Search",
    "parent": "Alert",
    "when": "known(target)"
  }
}

CLI

ara do behavior.state.add --args '{"name":"Search","parent":"Alert","when":"known(target)"}' --why "…"