@fleetbase/fleetops-engine 0.6.55 → 0.6.57

package/server/src/Jobs/SyncTelematicDevicesJob.php

@@ -28,8 +28,9 @@ class SyncTelematicDevicesJob implements ShouldQueue
     public Telematic $telematic;
     public array $options;
     public string $jobId;
-    public int $tries   = 1;
-    public int $timeout = 300;
+    public int $tries          = 1;
+    public int $timeout        = 3600;
+    public bool $failOnTimeout = true;
 
     /**
      * Create a new job instance.
@@ -79,12 +80,22 @@ class SyncTelematicDevicesJob implements ShouldQueue
             $cursor                     = null;
             $totalFetched               = 0;
             $totalLinked                = 0;
+            $totalLinkAttempts          = 0;
             $totalEvents                = 0;
             $totalSensors               = 0;
             $totalSkipped               = 0;
             $pageCount                  = 0;
             $lastProviderAllCount       = null;
             $lastProviderFiltersCount   = null;
+            $providerSyncMeta           = [];
+            $linkedDeviceKeys           = [];
+            $inventoryPayloads          = [];
+            $inventoryFetched           = 0;
+            $inventoryLinked            = 0;
+            $inventorySkipped           = 0;
+            $totalEnrichment            = 0;
+            $totalEnrichmentCompleted   = 0;
+            $totalEnrichmentFailures    = 0;
 
             try {
                 $provider = $registry->resolve($this->telematic->provider);
@@ -97,10 +108,12 @@ class SyncTelematicDevicesJob implements ShouldQueue
                         'filters' => $this->options['filters'] ?? [],
                     ]);
 
-                    $devices     = $response['devices'] ?? [];
-                    $pagination  = $response['pagination'] ?? [];
+                    $devices          = $response['devices'] ?? [];
+                    $pagination       = $response['pagination'] ?? [];
+                    $providerSyncMeta = array_merge($providerSyncMeta, $response['sync_meta'] ?? []);
                     $pageCount++;
                     $totalFetched += count($devices);
+                    $inventoryPayloads = array_merge($inventoryPayloads, $devices);
 
                     if (isset($pagination['allCount'])) {
                         $lastProviderAllCount = $pagination['allCount'];
@@ -128,10 +141,15 @@ class SyncTelematicDevicesJob implements ShouldQueue
                         $normalizedDevice = $provider->normalizeDevice($devicePayload);
                         try {
                             $result = $service->ingestDeviceSnapshot($this->telematic, $provider, $devicePayload);
-                            $totalLinked++;
-                            if ($result['event']) {
-                                $totalEvents++;
+                            $totalLinkAttempts++;
+                            $linkedDeviceKey = $this->resolveLinkedDeviceKey($result, $normalizedDevice);
+
+                            if ($linkedDeviceKey && !isset($linkedDeviceKeys[$linkedDeviceKey])) {
+                                $linkedDeviceKeys[$linkedDeviceKey] = true;
+                                $totalLinked++;
                             }
+
+                            $totalEvents += count($result['events'] ?? array_filter([$result['event'] ?? null]));
                             $totalSensors += $result['sensors'] ?? 0;
                         } catch (\Illuminate\Validation\ValidationException $e) {
                             $totalSkipped++;
@@ -152,6 +170,7 @@ class SyncTelematicDevicesJob implements ShouldQueue
                         'correlation_id' => $correlationId,
                         'fetched'        => $totalFetched,
                         'linked'         => $totalLinked,
+                        'link_attempts'  => $totalLinkAttempts,
                         'events'         => $totalEvents,
                         'sensors'        => $totalSensors,
                         'skipped'        => $totalSkipped,
@@ -161,10 +180,102 @@ class SyncTelematicDevicesJob implements ShouldQueue
                     // Broadcast progress (TODO: implement WebSocket broadcasting)
                 } while (($response['has_more'] ?? false) && $cursor);
 
+                $inventoryFetched = $totalFetched;
+                $inventoryLinked  = $totalLinked;
+                $inventorySkipped = $totalSkipped;
+
+                $this->telematic->status = 'synchronizing';
+                $this->telematic->meta   = array_merge($this->telematic->meta ?? [], $providerSyncMeta, [
+                    'last_sync_job_id'                   => $this->jobId,
+                    'last_sync_result'                   => 'inventory_synced',
+                    'last_sync_total'                    => $totalLinked,
+                    'last_sync_inventory_completed_at'   => now()->toDateTimeString(),
+                    'last_sync_inventory_total'          => $inventoryFetched,
+                    'last_sync_inventory_linked_total'   => $inventoryLinked,
+                    'last_sync_inventory_skipped_total'  => $inventorySkipped,
+                    'last_sync_fetched_total'            => $totalFetched,
+                    'last_sync_linked_total'             => $totalLinked,
+                    'last_sync_link_attempts_total'      => $totalLinkAttempts,
+                    'last_sync_skipped_total'            => $totalSkipped,
+                    'last_sync_page_count'               => $pageCount,
+                    'last_sync_provider_total'           => $lastProviderFiltersCount ?? $lastProviderAllCount,
+                    'last_sync_provider_all_count'       => $lastProviderAllCount,
+                    'last_sync_provider_filters_count'   => $lastProviderFiltersCount,
+                ]);
+                $this->telematic->save();
+
+                Log::info($this->telematic->provider === 'safee' ? 'Safee inventory sync completed' : 'Telematics inventory sync completed', [
+                    'correlation_id'   => $correlationId,
+                    'telematic_uuid'   => $this->telematic->uuid,
+                    'provider'         => $this->telematic->provider,
+                    'inventory_total'  => $inventoryFetched,
+                    'inventory_linked' => $inventoryLinked,
+                    'skipped'          => $inventorySkipped,
+                ]);
+
+                if (method_exists($provider, 'fetchDeviceTelemetrySnapshots') && !empty($inventoryPayloads)) {
+                    Log::info($this->telematic->provider === 'safee' ? 'Safee telemetry enrichment started' : 'Telematics telemetry enrichment started', [
+                        'correlation_id' => $correlationId,
+                        'telematic_uuid' => $this->telematic->uuid,
+                        'provider'       => $this->telematic->provider,
+                        'device_count'   => count($inventoryPayloads),
+                    ]);
+
+                    $enrichmentResponse = $provider->fetchDeviceTelemetrySnapshots($inventoryPayloads, [
+                        'limit'   => $this->options['limit'] ?? null,
+                        'filters' => $this->options['filters'] ?? [],
+                    ]);
+                    $providerSyncMeta = array_merge($providerSyncMeta, $enrichmentResponse['sync_meta'] ?? []);
+                    $enrichedDevices  = $enrichmentResponse['devices'] ?? [];
+                    $totalEnrichment += count($enrichedDevices);
+
+                    foreach ($enrichedDevices as $devicePayload) {
+                        $normalizedDevice = $provider->normalizeDevice($devicePayload);
+                        try {
+                            $result = $service->ingestDeviceSnapshot($this->telematic, $provider, $devicePayload);
+                            $totalLinkAttempts++;
+                            $linkedDeviceKey = $this->resolveLinkedDeviceKey($result, $normalizedDevice);
+
+                            if ($linkedDeviceKey && !isset($linkedDeviceKeys[$linkedDeviceKey])) {
+                                $linkedDeviceKeys[$linkedDeviceKey] = true;
+                                $totalLinked++;
+                            }
+
+                            $totalEnrichmentCompleted++;
+                            $totalEvents += count($result['events'] ?? array_filter([$result['event'] ?? null]));
+                            $totalSensors += $result['sensors'] ?? 0;
+                        } catch (\Illuminate\Validation\ValidationException $e) {
+                            $totalSkipped++;
+                            $totalEnrichmentFailures++;
+                            Log::warning('Skipping telematics enrichment without provider identity', [
+                                'correlation_id'   => $correlationId,
+                                'provider'         => $this->telematic->provider,
+                                'provider_unit_id' => $devicePayload['_id'] ?? $devicePayload['id'] ?? null,
+                                'device_id'        => $normalizedDevice['device_id'] ?? null,
+                                'name'             => $normalizedDevice['name'] ?? $devicePayload['name'] ?? null,
+                                'imei'             => $devicePayload['imei'] ?? null,
+                            ]);
+                        }
+                    }
+
+                    Log::info($this->telematic->provider === 'safee' ? 'Safee telemetry enrichment completed' : 'Telematics telemetry enrichment completed', [
+                        'correlation_id' => $correlationId,
+                        'telematic_uuid' => $this->telematic->uuid,
+                        'provider'       => $this->telematic->provider,
+                        'total'          => $totalEnrichment,
+                        'completed'      => $totalEnrichmentCompleted,
+                        'failures'       => $totalEnrichmentFailures,
+                    ]);
+                }
+
                 Log::info('Device discovery completed', [
                     'correlation_id'        => $correlationId,
                     'total_fetched'         => $totalFetched,
                     'total_linked'          => $totalLinked,
+                    'total_link_attempts'   => $totalLinkAttempts,
+                    'total_enrichment'      => $totalEnrichment,
+                    'enrichment_completed'  => $totalEnrichmentCompleted,
+                    'enrichment_failures'   => $totalEnrichmentFailures,
                     'total_events'          => $totalEvents,
                     'total_sensors'         => $totalSensors,
                     'total_skipped'         => $totalSkipped,
@@ -174,22 +285,29 @@ class SyncTelematicDevicesJob implements ShouldQueue
                 ]);
 
                 $this->telematic->status = 'active';
-                $this->telematic->meta   = array_merge($this->telematic->meta ?? [], [
-                    'last_sync_job_id'                 => $this->jobId,
-                    'last_sync_completed_at'           => now()->toDateTimeString(),
-                    'last_sync_result'                 => 'success',
-                    'last_sync_total'                  => $totalLinked,
-                    'last_sync_fetched_total'          => $totalFetched,
-                    'last_sync_linked_total'           => $totalLinked,
-                    'last_sync_events_total'           => $totalEvents,
-                    'last_sync_sensors_total'          => $totalSensors,
-                    'last_sync_skipped_total'          => $totalSkipped,
-                    'last_sync_page_count'             => $pageCount,
-                    'last_sync_provider_total'         => $lastProviderFiltersCount ?? $lastProviderAllCount,
-                    'last_sync_provider_all_count'     => $lastProviderAllCount,
-                    'last_sync_provider_filters_count' => $lastProviderFiltersCount,
-                    'last_sync_error'                  => null,
-                    'last_sync_error_context'          => null,
+                $this->telematic->meta   = array_merge($this->telematic->meta ?? [], $providerSyncMeta, [
+                    'last_sync_job_id'                  => $this->jobId,
+                    'last_sync_completed_at'            => now()->toDateTimeString(),
+                    'last_sync_result'                  => 'success',
+                    'last_sync_total'                   => $totalLinked,
+                    'last_sync_fetched_total'           => $totalFetched,
+                    'last_sync_linked_total'            => $totalLinked,
+                    'last_sync_link_attempts_total'     => $totalLinkAttempts,
+                    'last_sync_inventory_total'         => $inventoryFetched,
+                    'last_sync_inventory_linked_total'  => $inventoryLinked,
+                    'last_sync_inventory_skipped_total' => $inventorySkipped,
+                    'last_sync_enrichment_total'        => $totalEnrichment,
+                    'last_sync_enrichment_completed'    => $totalEnrichmentCompleted,
+                    'last_sync_enrichment_failures'     => $totalEnrichmentFailures,
+                    'last_sync_events_total'            => $totalEvents,
+                    'last_sync_sensors_total'           => $totalSensors,
+                    'last_sync_skipped_total'           => $totalSkipped,
+                    'last_sync_page_count'              => $pageCount,
+                    'last_sync_provider_total'          => $lastProviderFiltersCount ?? $lastProviderAllCount,
+                    'last_sync_provider_all_count'      => $lastProviderAllCount,
+                    'last_sync_provider_filters_count'  => $lastProviderFiltersCount,
+                    'last_sync_error'                   => null,
+                    'last_sync_error_context'           => null,
                 ]);
                 $this->telematic->save();
             } catch (\Exception $e) {
@@ -205,21 +323,28 @@ class SyncTelematicDevicesJob implements ShouldQueue
 
                 $this->telematic->status = 'error';
                 $this->telematic->meta   = array_merge($this->telematic->meta ?? [], [
-                    'last_sync_job_id'                 => $this->jobId,
-                    'last_sync_result'                 => 'failed',
-                    'last_sync_fetched_total'          => $totalFetched,
-                    'last_sync_linked_total'           => $totalLinked,
-                    'last_sync_events_total'           => $totalEvents,
-                    'last_sync_sensors_total'          => $totalSensors,
-                    'last_sync_skipped_total'          => $totalSkipped,
-                    'last_sync_page_count'             => $pageCount,
-                    'last_sync_provider_total'         => $lastProviderFiltersCount ?? $lastProviderAllCount,
-                    'last_sync_provider_all_count'     => $lastProviderAllCount,
-                    'last_sync_provider_filters_count' => $lastProviderFiltersCount,
-                    'last_sync_error'                  => $failureMessage,
-                    'last_sync_error_type'             => class_basename($e),
-                    'last_sync_error_context'          => $failureContext,
-                    'last_sync_failed_at'              => now()->toDateTimeString(),
+                    'last_sync_job_id'                  => $this->jobId,
+                    'last_sync_result'                  => 'failed',
+                    'last_sync_fetched_total'           => $totalFetched,
+                    'last_sync_linked_total'            => $totalLinked,
+                    'last_sync_link_attempts_total'     => $totalLinkAttempts,
+                    'last_sync_inventory_total'         => $inventoryFetched,
+                    'last_sync_inventory_linked_total'  => $inventoryLinked,
+                    'last_sync_inventory_skipped_total' => $inventorySkipped,
+                    'last_sync_enrichment_total'        => $totalEnrichment,
+                    'last_sync_enrichment_completed'    => $totalEnrichmentCompleted,
+                    'last_sync_enrichment_failures'     => $totalEnrichmentFailures,
+                    'last_sync_events_total'            => $totalEvents,
+                    'last_sync_sensors_total'           => $totalSensors,
+                    'last_sync_skipped_total'           => $totalSkipped,
+                    'last_sync_page_count'              => $pageCount,
+                    'last_sync_provider_total'          => $lastProviderFiltersCount ?? $lastProviderAllCount,
+                    'last_sync_provider_all_count'      => $lastProviderAllCount,
+                    'last_sync_provider_filters_count'  => $lastProviderFiltersCount,
+                    'last_sync_error'                   => $failureMessage,
+                    'last_sync_error_type'              => class_basename($e),
+                    'last_sync_error_context'           => $failureContext,
+                    'last_sync_failed_at'               => now()->toDateTimeString(),
                 ]);
                 $this->telematic->save();
 
@@ -238,6 +363,37 @@ class SyncTelematicDevicesJob implements ShouldQueue
         return $this->jobId;
     }
 
+    public function failed(\Throwable $e): void
+    {
+        $this->telematic->refresh();
+        $this->telematic->status = 'error';
+        $this->telematic->meta   = array_merge($this->telematic->meta ?? [], [
+            'last_sync_job_id'        => $this->jobId,
+            'last_sync_result'        => 'failed',
+            'last_sync_error'         => $this->safeSyncErrorMessage($e),
+            'last_sync_error_type'    => class_basename($e),
+            'last_sync_failed_at'     => now()->toDateTimeString(),
+            'last_sync_failed_reason' => $e instanceof \Illuminate\Queue\TimeoutExceededException ? 'job_timeout' : null,
+        ]);
+        $this->telematic->save();
+    }
+
+    protected function resolveLinkedDeviceKey(array $result, array $normalizedDevice): ?string
+    {
+        $device = $result['device'] ?? null;
+        $value  = null;
+
+        if (is_object($device)) {
+            $value = $device->uuid ?? $device->device_id ?? null;
+        }
+
+        $value ??= $normalizedDevice['device_id']
+            ?? $normalizedDevice['external_id']
+            ?? null;
+
+        return $value === null || $value === '' ? null : (string) $value;
+    }
+
     protected function safeSyncErrorMessage(\Throwable $e): string
     {
         $message = $e->getMessage();

package/server/src/Models/Driver.php

@@ -278,6 +278,8 @@ class Driver extends Model
             'photo_uuid',
             'avatar_url',
             'public_id',
+            'name',
+            'internal_id',
             'location',
             'online',
             'updated_at',
@@ -288,6 +290,10 @@ class Driver extends Model
             'year',
             'make',
             'model',
+            'class',
+            'color',
+            'call_sign',
+            'status',
             'specs',
             'vin_data',
             'telematics',

package/server/src/Models/Order.php

@@ -849,7 +849,7 @@ class Order extends Model
             $attributes['type'] = $this->type;
         }
 
-        if (isset($attributes['pickup']) && is_array($attributes['pickup'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'pickup')) {
             $pickup = Place::createFromMixed($attributes['pickup']);
 
             if ($pickup instanceof Place) {
@@ -857,7 +857,7 @@ class Order extends Model
             }
         }
 
-        if (isset($attributes['dropoff']) && is_array($attributes['dropoff'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'dropoff')) {
             $dropoff = Place::createFromMixed($attributes['dropoff']);
 
             if ($dropoff instanceof Place) {
@@ -865,7 +865,7 @@ class Order extends Model
             }
         }
 
-        if (isset($attributes['return']) && is_array($attributes['return'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'return')) {
             $return = Place::createFromMixed($attributes['return']);
 
             if ($return instanceof Place) {
@@ -897,19 +897,19 @@ class Order extends Model
             $attributes['type'] = $this->type;
         }
 
-        if (isset($attributes['pickup']) && is_array($attributes['pickup'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'pickup')) {
             $pickupId = Place::insertFromMixed($attributes['pickup']);
 
             $attributes['pickup_uuid'] = $pickupId;
         }
 
-        if (isset($attributes['dropoff']) && is_array($attributes['dropoff'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'dropoff')) {
             $dropoffId = Place::insertFromMixed($attributes['dropoff']);
 
             $attributes['dropoff_uuid'] = $dropoffId;
         }
 
-        if (isset($attributes['return']) && is_array($attributes['return'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'return')) {
             $returnId = Place::insertFromMixed($attributes['return']);
 
             $attributes['return_uuid'] = $returnId;
@@ -947,6 +947,18 @@ class Order extends Model
         return $payload;
     }
 
+    protected function shouldResolvePayloadPlace(?array $attributes, string $role): bool
+    {
+        return !$this->hasExistingPayloadPlaceUuid($attributes, $role) && isset($attributes[$role]) && is_array($attributes[$role]);
+    }
+
+    protected function hasExistingPayloadPlaceUuid(?array $attributes, string $role): bool
+    {
+        $uuid = data_get($attributes, "{$role}_uuid");
+
+        return is_string($uuid) && Str::isUuid($uuid) && Place::where('uuid', $uuid)->exists();
+    }
+
     /**
      * Retrieves the payload associated with the order.
      * If the payload is not already loaded, it loads the payload relationship.
@@ -1208,7 +1220,8 @@ class Order extends Model
                 'description'            => 'Dispatch order',
                 'type'                   => 'dispatch',
                 'direction'              => Transaction::DIRECTION_CREDIT,
-                'status'                 => 'success',
+                'status'                 => Transaction::STATUS_SUCCESS,
+                'settlement_status'      => Transaction::SETTLEMENT_STATUS_UNPAID,
             ]);
 
             $this->updateQuietly(['transaction_uuid' => $transaction->uuid]);

package/server/src/Models/Place.php

@@ -471,9 +471,17 @@ class Place extends Model
             return null;
         }
 
-        $postalCode = static::normalizePlaceValue(data_get($place, 'postal_code'));
-        $street2    = static::normalizePlaceValue(data_get($place, 'street2'));
-        $location   = Utils::getPointFromMixed(data_get($place, 'location'));
+        $postalCode    = static::normalizePlaceValue(data_get($place, 'postal_code'));
+        $street2       = static::normalizePlaceValue(data_get($place, 'street2'));
+        $locationValue = data_get($place, 'location');
+        $location      = new SpatialPoint(0, 0);
+        if (!empty($locationValue)) {
+            try {
+                $location = Utils::getPointFromMixed($locationValue);
+            } catch (\Throwable $e) {
+                $location = new SpatialPoint(0, 0);
+            }
+        }
 
         $existingPlace = static::query()
             ->where('company_uuid', $companyUuid)

package/server/src/Observers/PurchaseRateObserver.php

@@ -49,7 +49,8 @@ class PurchaseRateObserver
             'description'            => 'Dispatch order',
             'type'                   => 'dispatch',
             'direction'              => Transaction::DIRECTION_CREDIT,
-            'status'                 => 'success',
+            'status'                 => Transaction::STATUS_SUCCESS,
+            'settlement_status'      => Transaction::SETTLEMENT_STATUS_UNPAID,
         ]);
 
         if (isset($purchaseRate->serviceQuote)) {

package/server/src/Providers/FleetOpsServiceProvider.php

@@ -145,6 +145,7 @@ class FleetOpsServiceProvider extends CoreServiceProvider
             $schedule->command('fleetops:sync-telematics')->everyMinute()->withoutOverlapping()->storeOutputInDb();
         });
         $this->registerNotifications();
+        $this->registerAiCapabilities();
         $this->registerExpansionsFrom(__DIR__ . '/../Expansions');
 
         // Register built-in orchestration engines.
@@ -234,4 +235,29 @@ class FleetOpsServiceProvider extends CoreServiceProvider
             'dynamic:facilitator',
         ]);
     }
+
+    protected function registerAiCapabilities(): void
+    {
+        if (!Utils::classExists(\Fleetbase\Ai\Support\AiCapabilityRegistry::class)) {
+            return;
+        }
+
+        if (Utils::classExists(\Fleetbase\Ai\Support\AiQueryRegistry::class)) {
+            $this->callAfterResolving(\Fleetbase\Ai\Support\AiQueryRegistry::class, function (\Fleetbase\Ai\Support\AiQueryRegistry $registry) {
+                \Fleetbase\FleetOps\Support\Ai\FleetOpsAiQueryResources::register($registry);
+            });
+        }
+
+        $this->callAfterResolving(\Fleetbase\Ai\Support\AiCapabilityRegistry::class, function (\Fleetbase\Ai\Support\AiCapabilityRegistry $registry) {
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\SearchResourcesCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\OperationalQueryCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\OrderInsightsCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\AssetStatusCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\DocsHelpCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\ConsoleNavigationCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\CreateOrderPreviewCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\OptimizeOrderRouteCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\ImportOrdersPreviewCapability());
+        });
+    }
 }

package/server/src/Support/Ai/Capabilities/AbstractFleetOpsAICapability.php

@@ -0,0 +1,88 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support\Ai\Capabilities;
+
+use Fleetbase\Ai\Contracts\AIContextCapabilityInterface;
+use Fleetbase\Ai\Models\AiTask;
+use Fleetbase\Ai\Support\Capabilities\AbstractAICapability;
+use Fleetbase\Support\Auth;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Support\Str;
+
+abstract class AbstractFleetOpsAICapability extends AbstractAICapability implements AIContextCapabilityInterface
+{
+    public function module(): string
+    {
+        return 'fleet-ops';
+    }
+
+    public function shouldResolve(AiTask $task): bool
+    {
+        return $this->matchesPrompt($this->prompt($task));
+    }
+
+    abstract protected function matchesPrompt(string $prompt): bool;
+
+    protected function prompt(AiTask $task): string
+    {
+        return Str::lower(trim((string) $task->prompt));
+    }
+
+    protected function containsAny(string $prompt, array $terms): bool
+    {
+        foreach ($terms as $term) {
+            if (str_contains($prompt, Str::lower($term))) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    protected function can(string $permission): bool
+    {
+        $user = Auth::getUserFromSession();
+
+        if ($user?->isAdmin()) {
+            return true;
+        }
+
+        return Auth::can($permission);
+    }
+
+    protected function canAll(array $permissions): bool
+    {
+        foreach ($permissions as $permission) {
+            if (!$this->can($permission)) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    protected function searchTerms(string $prompt): array
+    {
+        preg_match_all('/[A-Z]{2,}[-_][A-Z0-9-_]+|[A-Za-z0-9][A-Za-z0-9-_]{2,}/', (string) $prompt, $matches);
+
+        $terms = collect($matches[0] ?? [])
+            ->reject(fn ($term) => in_array(Str::lower($term), ['find', 'show', 'open', 'order', 'orders', 'vehicle', 'vehicles', 'driver', 'drivers', 'work', 'status', 'about', 'fleet', 'ops'], true))
+            ->unique()
+            ->take(6)
+            ->values()
+            ->all();
+
+        return empty($terms) ? [trim((string) $prompt)] : $terms;
+    }
+
+    protected function whereLikeAny(Builder $builder, array $columns, array $terms): void
+    {
+        $builder->where(function (Builder $query) use ($columns, $terms) {
+            foreach ($columns as $column) {
+                foreach ($terms as $term) {
+                    $query->orWhere($column, 'like', '%' . $term . '%');
+                }
+            }
+        });
+    }
+}