AgentMode enum

How much autonomy the AI agent has when it wants to run a command.

The mode controls the confirmation contract only — it never relaxes the command_shield gate, which auto-blocks DENY / critical commands in every mode (see AgentService).

Inheritance
Available extensions

Values

standard → const AgentMode

The agent proposes one command at a time; the user confirms each one before it runs.

plan → const AgentMode

The agent first investigates the node and presents a full multi-step plan; the user approves it all-at-once or steps through it one at a time.

auto → const AgentMode

The agent executes autonomously with no confirmation. command_shield still auto-blocks DENY / critical commands.

Properties

hashCode int
The hash code for this object.
no setterinherited
index int
A numeric identifier for the enumerated value.
no setterinherited
name String

Available on Enum, provided by the EnumName extension

The name of the enum value.
no setter
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
wireName String
The wire/config token for this mode (its lowercase name).
no setter

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() String
A string representation of this object.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited

Static Methods

tryParse(String? value) AgentMode?
Decodes a token written in ai.yaml or :ai mode <x>, returning null for anything unrecognised so the caller can report a usage error.

Constants

values → const List<AgentMode>
A constant List of the values in this enum, in order of their declaration.