✨ Add ResolvesEntities concern for name-based ID resolution

- 🤖 Introduced `ResolvesEntities` trait to simplify entity resolution by name or ID across MCP tools.
- 📚 Updated tools (Meetups, Cities, Venues, Courses, Lecturers) to use the concern for resolving related entities (e.g., courses, venues, lecturers).
- 🎯 Enhanced tool descriptions and schemas for better name-based parameter handling with fallback support for IDs.
- ✅ Added dedicated feature tests for name resolution logic, partial matches, and error handling scenarios.

app/Mcp/Tools/Lecturer/ShowMyLecturerTool.php

@@ -3,6 +3,7 @@
 namespace App\Mcp\Tools\Lecturer;
 
 use App\Http\Resources\LecturerResource;
+use App\Mcp\Tools\Concerns\ResolvesEntities;
 use App\Models\Lecturer;
 use Illuminate\Contracts\JsonSchema\JsonSchema;
 use Illuminate\JsonSchema\Types\Type;
@@ -14,15 +15,17 @@ use Laravel\Mcp\Server\Tool;
 use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
 
 #[IsReadOnly]
-#[Description('Zeigt einen einzelnen, vom authentifizierten Nutzer erstellten Referenten.')]
+#[Description('Zeigt einen deiner Referenten (per Name angegeben).')]
 class ShowMyLecturerTool extends Tool
 {
+    use ResolvesEntities;
+
     public function handle(Request $request): Response
     {
-        $lecturer = Lecturer::find($request->get('id'));
+        $lecturer = $this->resolveOwnedByName($request, Lecturer::class, 'Referenten', 'lecturer');
 
-        if (! $lecturer) {
-            return Response::error('Referent nicht gefunden.');
+        if ($lecturer instanceof Response) {
+            return $lecturer;
         }
 
         $user = $request->user();
@@ -40,7 +43,8 @@ class ShowMyLecturerTool extends Tool
     public function schema(JsonSchema $schema): array
     {
         return [
-            'id' => $schema->integer()->description('ID des Referenten.')->required(),
+            'lecturer' => $schema->string()->description('Name des Referenten (aus deinen Referenten, siehe list-my-lecturers).'),
+            'id' => $schema->integer()->description('Optional: ID des Referenten, falls bereits bekannt (Alternative zu "lecturer").'),
         ];
     }
 }