packages/frontend/lib/features/agent/models/agent_tool_metadata.dart

/// The UI presentation category for an agent tool, determining which icon and styles to use.
enum AgentToolUiKind {
  /// Tools that read file contents.
  read,

  /// Tools that search or list files.
  search,

  /// Tools that modify files or the workspace.
  edit,

  /// Tools that control the preview.
  preview,

  /// Tools that ask for user input or mode transitions.
  interaction,

  /// Fallback category for unrecognized tools.
  unknown,
}

/// Security or functional capability flags declared by tools.
enum AgentToolCapability {
  /// Allows reading and searching files in the workspace.
  workspaceReadSearch,

  /// Allows modifying files/folders in the workspace.
  workspaceMutate,

  /// Marks tool output as invalidating static analysis until `analyzeStart` passes.
  requiresAnalysisAfterUse,

  /// Requests direct user input without reading or mutating the workspace.
  userInteraction,
}