feat: MCP profile tools; ProfileUpdater/ProfilePresenter shared with /me; docs and Caddy snippet for /mcp

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BCrwHHnGCB5XH968Nxokqw

core/app/Http/Controllers/InboxController.php

@@ -4,11 +4,11 @@ namespace App\Http\Controllers;
 
 use App\Enums\EventState;
 use App\Http\Controllers\Me\ChannelsController;
-use App\Http\Controllers\Me\ProfileController;
 use App\Ingest\ManualEvents;
 use App\Models\Event;
 use App\Models\User;
 use App\Presenters\EventPresenter;
+use App\Presenters\ProfilePresenter;
 use App\Scheduling\DueResolver;
 use Carbon\CarbonImmutable;
 use Illuminate\Contracts\View\View;
@@ -45,7 +45,7 @@ class InboxController extends Controller
                 'closed_as' => EventPresenter::closedAs($e),
             ])->values()->all();
 
-        $profile = ProfileController::present($user);
+        $profile = ProfilePresenter::present($user);
 
         return view('inbox', [
             'profile' => $profile,

core/app/Http/Controllers/Me/ProfileController.php

@@ -2,21 +2,22 @@
 
 namespace App\Http\Controllers\Me;
 
-use App\Enums\EventState;
 use App\Http\Controllers\Controller;
 use App\Models\User;
+use App\Presenters\ProfilePresenter;
+use App\Users\ProfileUpdater;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Http\Response;
 use Illuminate\Support\Facades\Cache;
-use Illuminate\Validation\Rule;
-use Illuminate\Validation\ValidationException;
 
 class ProfileController extends Controller
 {
+    public function __construct(private readonly ProfileUpdater $profile) {}
+
     public function show(Request $request): JsonResponse
     {
-        return response()->json(self::present($request->attributes->get('user')));
+        return response()->json(ProfilePresenter::present($request->attributes->get('user')));
     }
 
     public function update(Request $request): JsonResponse
@@ -24,27 +25,7 @@ class ProfileController extends Controller
         /** @var User $user */
         $user = $request->attributes->get('user');
 
-        $data = $request->validate([
-            'tz' => ['sometimes', 'string', Rule::in(\DateTimeZone::listIdentifiers())],
-            'quiet_start' => ['sometimes', 'date_format:H:i'],
-            'quiet_end' => ['sometimes', 'date_format:H:i'],
-        ]);
-
-        $start = $data['quiet_start'] ?? substr($user->quiet_start, 0, 5);
-        $end = $data['quiet_end'] ?? substr($user->quiet_end, 0, 5);
-        if ($end >= $start) {
-            throw ValidationException::withMessages([
-                'quiet_end' => 'Тихие часы должны переходить через полночь: quiet_end раньше quiet_start',
-            ]);
-        }
-
-        $user->fill([
-            'tz' => $data['tz'] ?? $user->tz,
-            'quiet_start' => $start.':00',
-            'quiet_end' => $end.':00',
-        ])->save();
-
-        return response()->json(self::present($user));
+        return response()->json(ProfilePresenter::present($this->profile->update($user, $request->all())));
     }
 
     public function heartbeat(Request $request): Response
@@ -55,16 +36,4 @@ class ProfileController extends Controller
 
         return response()->noContent();
     }
-
-    /** @return array<string,mixed> */
-    public static function present(User $user): array
-    {
-        return [
-            'login' => $user->login,
-            'tz' => $user->tz,
-            'quiet_start' => substr($user->quiet_start, 0, 5),
-            'quiet_end' => substr($user->quiet_end, 0, 5),
-            'badge' => $user->events()->whereIn('state', EventState::badgeValues())->count(),
-        ];
-    }
 }

core/app/Mcp/HadoServer.php

@@ -36,5 +36,7 @@ class HadoServer extends Server
         Tools\DeleteEvent::class,
         Tools\MarkDone::class,
         Tools\MarkAck::class,
+        Tools\GetProfile::class,
+        Tools\UpdateProfile::class,
     ];
 }

core/app/Mcp/Tools/GetProfile.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Mcp\Tools;
+
+use App\Presenters\ProfilePresenter;
+use Laravel\Mcp\ResponseFactory;
+use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
+
+#[IsReadOnly]
+class GetProfile extends AgentTool
+{
+    protected string $name = 'get_profile';
+
+    protected string $description = 'Профиль пользователя: логин, часовой пояс, тихие часы (quiet_start–quiet_end, через полночь) и бейдж — сколько событий в today и overdue.';
+
+    public function handle(): ResponseFactory
+    {
+        return $this->respond(ProfilePresenter::present($this->user()));
+    }
+}

core/app/Mcp/Tools/UpdateProfile.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Mcp\Tools;
+
+use App\Presenters\ProfilePresenter;
+use App\Users\ProfileUpdater;
+use Illuminate\Contracts\JsonSchema\JsonSchema;
+use Laravel\Mcp\Request;
+use Laravel\Mcp\ResponseFactory;
+
+class UpdateProfile extends AgentTool
+{
+    protected string $name = 'update_profile';
+
+    protected string $description = 'Поменять часовой пояс и/или тихие часы пользователя — любое подмножество полей. Тихие часы должны переходить через полночь: quiet_end раньше quiet_start.';
+
+    public function __construct(private readonly ProfileUpdater $profile) {}
+
+    public function schema(JsonSchema $schema): array
+    {
+        return [
+            'tz' => $schema->string()->description('Идентификатор зоны, напр. Europe/Belgrade'),
+            'quiet_start' => $schema->string()->description('HH:MM, начало тихих часов'),
+            'quiet_end' => $schema->string()->description('HH:MM, конец тихих часов'),
+        ];
+    }
+
+    public function handle(Request $request): ResponseFactory
+    {
+        return $this->respond(ProfilePresenter::present($this->profile->update($this->user(), $request->all())));
+    }
+}

core/app/Presenters/ProfilePresenter.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Presenters;
+
+use App\Enums\EventState;
+use App\Models\User;
+
+/** Профиль для инбокса и агента: пояс, тихие часы, бейдж. */
+final class ProfilePresenter
+{
+    /** @return array<string,mixed> */
+    public static function present(User $user): array
+    {
+        return [
+            'login' => $user->login,
+            'tz' => $user->tz,
+            'quiet_start' => substr($user->quiet_start, 0, 5),
+            'quiet_end' => substr($user->quiet_end, 0, 5),
+            'badge' => $user->events()->whereIn('state', EventState::badgeValues())->count(),
+        ];
+    }
+}

core/app/Users/ProfileUpdater.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace App\Users;
+
+use App\Models\User;
+use Illuminate\Support\Facades\Validator;
+use Illuminate\Validation\Rule;
+use Illuminate\Validation\ValidationException;
+
+/** Правка профиля — пояс и тихие часы; правила одни для инбокса и агента. */
+final class ProfileUpdater
+{
+    /**
+     * @param  array<string,mixed>  $input  любое подмножество tz, quiet_start, quiet_end (HH:MM)
+     *
+     * @throws ValidationException
+     */
+    public function update(User $user, array $input): User
+    {
+        $data = Validator::validate($input, [
+            'tz' => ['sometimes', 'string', Rule::in(\DateTimeZone::listIdentifiers())],
+            'quiet_start' => ['sometimes', 'date_format:H:i'],
+            'quiet_end' => ['sometimes', 'date_format:H:i'],
+        ]);
+
+        $start = $data['quiet_start'] ?? substr($user->quiet_start, 0, 5);
+        $end = $data['quiet_end'] ?? substr($user->quiet_end, 0, 5);
+        if ($end >= $start) {
+            throw ValidationException::withMessages([
+                'quiet_end' => 'Тихие часы должны переходить через полночь: quiet_end раньше quiet_start',
+            ]);
+        }
+
+        $user->fill([
+            'tz' => $data['tz'] ?? $user->tz,
+            'quiet_start' => $start.':00',
+            'quiet_end' => $end.':00',
+        ])->save();
+
+        return $user;
+    }
+}