Deal with form schema inside filters when present

Author: luisdalmolin

src/DescribeFilamentResourceTool.php

@@ -161,6 +161,10 @@ public function makeFilamentTranslatableContentDriver(): ?TranslatableContentDri
                     'name' => $column['name'],
                     'label' => $column['label'],
                     'type' => 'searchable_column',
+                    'example' => [
+                        'description' => 'Use string value to search within this column',
+                        'values' => ['search term', 'partial match']
+                    ]
                 ])
                 ->keyBy('name')
                 ->all();
@@ -284,16 +288,43 @@ public function mapTableFilter(BaseFilter $filter): array
         ];
 
         if ($filter instanceof TernaryFilter) {
-            // Condition is implicit (true/false/all)
+            $baseInfo['example'] = [
+                'description' => 'Use true for yes, false for no, null for all',
+                'values' => [true, false, null],
+                'usage' => "Include as '{$filter->getName()}': true|false|null in your filters JSON"
+            ];
         } elseif ($filter instanceof SelectFilter) {
-            $baseInfo['optionsSource'] = 'Dynamic/Callable'; // Getting exact source is complex
+            $baseInfo['optionsSource'] = 'Dynamic/Callable';
 
-            // Try to get options if they are simple array
             if (method_exists($filter, 'getOptions') && is_array($options = $filter->getOptions())) {
                 $baseInfo['optionsSource'] = $options;
+                $exampleSingle = array_key_first($options);
+                $exampleMultiple = array_slice(array_keys($options), 0, 2);
+
+                $baseInfo['example'] = [
+                    'description' => 'Use array of option keys or single option key',
+                    'values' => [
+                        'single' => $exampleSingle,
+                        'multiple' => $exampleMultiple
+                    ],
+                    'usage' => "Include as '{$filter->getName()}': [" . implode(', ', array_map(fn($v) => "\"$v\"", $exampleMultiple)) . "] or '{$filter->getName()}': \"$exampleSingle\" in your filters JSON"
+                ];
+            } else {
+                $baseInfo['example'] = [
+                    'description' => 'Use array of option values or single option value',
+                    'values' => [
+                        'single' => 'option_value',
+                        'multiple' => ['option_value_1', 'option_value_2']
+                    ],
+                    'usage' => "Include as '{$filter->getName()}': [\"option_value_1\", \"option_value_2\"] or '{$filter->getName()}': \"option_value\" in your filters JSON"
+                ];
             }
+        } else {
+            $baseInfo['example'] = [
+                'description' => 'Custom filter - check filter implementation for expected values',
+                'usage' => "Include as '{$filter->getName()}': value in your filters JSON"
+            ];
         }
-        // Add more specific filter type mappings here if needed
 
         return $baseInfo;
     }

src/GetFilamentResourceDataTool.php

@@ -22,7 +22,7 @@ public function build(): PrismTool
     {
         return app(PrismTool::class)
             ->as($this->getName())
-            ->for('Gets the data for a given Filament resource, applying optional filters provided in the describe_filament_resource tool. Always call the describe_filament_resource tool before calling this tool. Try to use the available filters to get the data you need.')
+            ->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.')
             ->withStringParameter('resource', 'The resource class name of the resource to get data for, from the list_filament_resources tool.', required: true)
             ->withStringParameter('filters', 'JSON string of filters to apply (e.g., \'{"status": "published", "author_id": [1, 2]}\').', required: false)
             ->using(function (string $resource, ?string $filters = null) {
@@ -55,9 +55,18 @@ public function build(): PrismTool
                             $listPage->tableFilters[$filter->getName()] = [
                                 'value' => $filters[$filter->getName()] ?? null,
                             ];
+
+                            if ($filter->hasFormSchema()) {
+                                foreach ($filter->getFormSchema() as $formSchema) {
+                                    $listPage->tableFilters[$filter->getName()][$formSchema->getName()] =
+                                        $filters[$formSchema->getName()] ?? null;
+                                }
+                            }
                         }
                     }
 
+                    dump($listPage->tableFilters, $filters);
+
                     // TODO: Allow the tool to specify the number of results to return with a max
                     $results = $listPage->getFilteredTableQuery()->take(10)->get();