@fleetbase/fleetops-engine 0.6.56 → 0.6.58

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/Orchestration/Support/OrchestrationPayloadBuilder.php

@@ -337,7 +337,9 @@ class OrchestrationPayloadBuilder
     protected static function resolveServiceTime(Order $order): int
     {
         $payload        = $order->payload;
-        $waypointMarker = $payload?->waypointMarkers?->last();
+        $waypointMarker = method_exists($payload, 'relationLoaded') && $payload->relationLoaded('waypointMarkers')
+            ? $payload->waypointMarkers?->last()
+            : null;
 
         return (int) (
             $waypointMarker?->service_time

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 . '%');
+                }
+            }
+        });
+    }
+}

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

@@ -0,0 +1,108 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support\Ai\Capabilities;
+
+use Fleetbase\Ai\Models\AiTask;
+use Fleetbase\FleetOps\Models\Device;
+use Fleetbase\FleetOps\Models\Driver;
+use Fleetbase\FleetOps\Models\Sensor;
+use Fleetbase\FleetOps\Models\Telematic;
+use Fleetbase\FleetOps\Models\Vehicle;
+
+class AssetStatusCapability extends AbstractFleetOpsAICapability
+{
+    public function key(): string
+    {
+        return 'fleet-ops.asset_status';
+    }
+
+    public function label(): string
+    {
+        return 'Fleet-Ops asset status';
+    }
+
+    public function description(): string
+    {
+        return 'Summarizes Fleet-Ops vehicle, device, sensor, and telematic status counts.';
+    }
+
+    public function permissions(): array
+    {
+        return ['fleet-ops see vehicle', 'fleet-ops see device', 'fleet-ops see sensor', 'fleet-ops see telematic'];
+    }
+
+    public function resolve(AiTask $task): array
+    {
+        return [
+            'drivers'    => $this->driverStatus(),
+            'vehicles'   => $this->statusCounts(Vehicle::class, 'fleet-ops see vehicle'),
+            'devices'    => $this->deviceStatus(),
+            'sensors'    => $this->statusCounts(Sensor::class, 'fleet-ops see sensor'),
+            'telematics' => $this->statusCounts(Telematic::class, 'fleet-ops see telematic'),
+        ];
+    }
+
+    protected function matchesPrompt(string $prompt): bool
+    {
+        return $this->containsAny($prompt, ['offline', 'online', 'asset status', 'driver status', 'vehicle status', 'device status', 'sensor status', 'telematic status', 'drivers down', 'devices down', 'vehicles down']);
+    }
+
+    protected function statusCounts(string $modelClass, string $permission): array
+    {
+        if (!$this->can($permission)) {
+            return ['authorized' => false];
+        }
+
+        return [
+            'authorized'       => true,
+            'total'            => $modelClass::where('company_uuid', session('company'))->count(),
+            'counts_by_status' => $modelClass::where('company_uuid', session('company'))
+                ->selectRaw('status, count(*) as aggregate')
+                ->groupBy('status')
+                ->pluck('aggregate', 'status')
+                ->all(),
+        ];
+    }
+
+    protected function deviceStatus(): array
+    {
+        if (!$this->can('fleet-ops see device')) {
+            return ['authorized' => false];
+        }
+
+        return [
+            'authorized'       => true,
+            'total'            => Device::where('company_uuid', session('company'))->count(),
+            'online'           => Device::where('company_uuid', session('company'))->where('online', true)->count(),
+            'offline'          => Device::where('company_uuid', session('company'))->where(function ($query) {
+                $query->where('online', false)->orWhereNull('online');
+            })->count(),
+            'counts_by_status' => Device::where('company_uuid', session('company'))
+                ->selectRaw('status, count(*) as aggregate')
+                ->groupBy('status')
+                ->pluck('aggregate', 'status')
+                ->all(),
+        ];
+    }
+
+    protected function driverStatus(): array
+    {
+        if (!$this->can('fleet-ops see driver')) {
+            return ['authorized' => false];
+        }
+
+        return [
+            'authorized'       => true,
+            'total'            => Driver::where('company_uuid', session('company'))->count(),
+            'online'           => Driver::where('company_uuid', session('company'))->where('online', true)->count(),
+            'offline'          => Driver::where('company_uuid', session('company'))->where(function ($query) {
+                $query->where('online', false)->orWhereNull('online');
+            })->count(),
+            'counts_by_status' => Driver::where('company_uuid', session('company'))
+                ->selectRaw('status, count(*) as aggregate')
+                ->groupBy('status')
+                ->pluck('aggregate', 'status')
+                ->all(),
+        ];
+    }
+}

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

@@ -0,0 +1,55 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support\Ai\Capabilities;
+
+use Fleetbase\Ai\Models\AiTask;
+
+class ConsoleNavigationCapability extends SearchResourcesCapability
+{
+    public function key(): string
+    {
+        return 'fleet-ops.console_navigation';
+    }
+
+    public function label(): string
+    {
+        return 'Fleet-Ops console navigation preview';
+    }
+
+    public function description(): string
+    {
+        return 'Returns preview-only console route suggestions for Fleet-Ops resources.';
+    }
+
+    public function type(): string
+    {
+        return 'ui';
+    }
+
+    public function mode(): string
+    {
+        return 'navigation_preview';
+    }
+
+    public function resolve(AiTask $task): array
+    {
+        $search = parent::resolve($task);
+        $items  = collect(data_get($search, 'results', []))
+            ->flatten(1)
+            ->filter(fn ($result) => is_array($result) && isset($result['route']))
+            ->take(5)
+            ->values()
+            ->all();
+
+        return [
+            'preview_only' => true,
+            'message'      => 'Fleetbase AI can suggest where to navigate, but this pilot does not directly open panels yet.',
+            'suggestions'  => $items,
+        ];
+    }
+
+    protected function matchesPrompt(string $prompt): bool
+    {
+        return $this->containsAny($prompt, ['open', 'show me', 'go to', 'navigate', 'take me to']) && parent::matchesPrompt($prompt);
+    }
+}