Final tweaks for pagination data

Author: luisdalmolin

src/DescribeFilamentResourceTool.php

@@ -38,7 +38,7 @@ public function build(): PrismTool
     {
         return app(PrismTool::class)
             ->as($this->getName())
-            ->for('Describes the structure, fields, columns, actions, and relationships for a given Filament resource. Always call the list_filament_resources tool before calling this tool.')
+            ->for('Describes the structure, fields, columns, actions, and relationships for a given Filament resource. Must call the list_filament_resources tool before calling this tool.')
             ->withStringParameter('resource', 'The class name of the resource to describe.', required: true)
             ->using(function (string $resource) {
                 return json_encode($this->describe($resource));
@@ -180,10 +180,15 @@ public function makeFilamentTranslatableContentDriver(): ?TranslatableContentDri
 
             return [
                 'columns' => $columns,
-                'filters' => array_values($filters), // Re-index the array
+                'filters' => array_values($filters),
                 'actions' => [
                     'bulk' => $bulkActions,
                 ],
+                'pagination' => [
+                    'total' => 'Total number of records (int)',
+                    'per_page' => 'Number of records per page (int)',
+                    'current_page' => 'Current page number (int)',
+                ],
             ];
         } catch (Exception $e) {
             Log::error("Error extracting table schema for resource {$resource}: {$e->getMessage()}");
@@ -212,8 +217,7 @@ public function mapFilterType(BaseFilter $filter): string
         return match (true) {
             $filter instanceof TernaryFilter => 'boolean',
             $filter instanceof SelectFilter => 'select',
-            // Add more mappings as needed
-            default => class_basename($filter), // Fallback to class name
+            default => class_basename($filter),
         };
     }
 

src/GetFilamentResourceDataTool.php

@@ -27,10 +27,10 @@ public function build(): PrismTool
     {
         return app(PrismTool::class)
             ->as($this->getName())
-            ->for('Gets the data for a given Filament resource, applying optional filters (try to use them). Always call the describe_filament_resource tool before calling this tool. Always try to use the available filters to get the data you need.')
+            ->for('Retrieves paginated data from a Filament resource with optional filtering. Response includes page count and total record count. Must call describe_filament_resource first to understand available filters and structure. Use filters to narrow results when possible for better performance.')
             ->withStringParameter('resource', 'The resource class name of the resource to get data for, from the list_filament_resources tool.')
             ->withStringParameter('filters', 'JSON string of filters to apply (e.g., \'{"status": "published", "author_id": [1, 2]}\').', required: false)
-            ->withNumberParameter('perPage', 'The resource data is paginated. This is the number of records per page. It defaults to 10', required: false)
+            ->withNumberParameter('perPage', 'The resource data is paginated. This is the number of records per page. It defaults to 10. Maximum is 100.', required: false)
             ->withNumberParameter('page', 'The resource data is paginated. This is the page the paginated results should be from.', required: false)
             ->using(function (string $resource, ?string $filters = null, ?int $perPage = 10, ?int $page = null) {
                 $resource = $this->getResourceInstance($resource);
@@ -72,6 +72,7 @@ public function build(): PrismTool
                         }
                     }
 
+                    $perPage = $perPage > 100 ? 100 : $perPage;
                     $results = $listPage->getFilteredTableQuery()->paginate(perPage: $perPage, page: $page);
 
                     $outputData = [