Back to challenges
Challenge

Real-Time Gulf Maritime Port Logistics Exception Handler with AI SDK

Geopolitical tensions require Gulf maritime ports to dynamically reroute energy shipments and handle customs exceptions without human delay. Implement a streaming TypeScript agent using Vercel AI SDK to monitor vessel telemetry, generate rerouting instructions, and manage port customs filings, reducing vessel turnaround delay by 25%.

Business OperationsHosted by Vera
Sign in free to start
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Construct a TypeScript streaming logistics agent using Vercel AI SDK to monitor Gulf oil tanker positions and trigger emergency port rerouting.

Delivery guide

How work is evaluated

Evaluation

Evaluates vessel rerouting recommendations and customs document structure accuracy.

Datasets

Shared data for this challenge

Review public datasets and any private uploads tied to your build.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
2 scoring checks
Binary
2 pass or fail dimensions
Ordinal
0 scaled dimensions
Dimension 1

reroute_triggered_on_risk

Must set reroute_required to true when corridor_alert is HIGH_RISK_ZONE_ACTIVE

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Dimension 2

turnaround_delay_reduction_pct

Simulated reduction percentage in port waiting time due to automated preclearance • target: 25 • range: 0-50

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Implement Vercel AI SDK `generateText` and `streamText` tools for maritime telemetry analysis

  • Construct custom TypeScript tool calls for live AIS (Automatic Identification System) coordinate lookup

  • Generate automated customs declaration amendments for alternate GCC discharge ports

  • Stream real-time rerouting advisories to shipping fleet operators

Resources and assets

Reference links and supporting material

Dataset notes

AIS tanker location logs, Gulf port congestion telemetry, and customs filing formats.

How this agent runs

Evaluates vessel rerouting recommendations and customs document structure accuracy.

Challenge input

JSON containing vessel ID, current coordinates, primary destination, and risk alert level.

AI SDK

Required TypeScript framework for agent tooling and streaming

Evaluated output

JSON containing recommended target port, alternate route distance, and revised ETA.

Checks for
  • Must set reroute_required to true when corridor_alert is HIGH_RISK_ZONE_ACTIVE
  • Simulated reduction percentage in port waiting time due to automated preclearance • target: 25 • range: 0-50
Proof of success
  • Benchmark: Logistics Dispatch Benchmark
  • Turnaround Delay Reduction Pct target: 25
  • 1 public reference case
Runtime evidence
  • JavaScript execution harness
  • javascript sandbox (unavailable on Versalist)
View technical recipe

Configured tools

Action Space
  • Vercel AI SDK · Required
  • Dagster · Optional
  • ElevenLabs · Optional
Orchestration
  • Vercel AI SDK · Required

Evaluation contract

  • reroute_triggered_on_risk · Weight 1
  • turnaround_delay_reduction_pct · Weight 1

Recipe state

This is a preview. The configuration can change before the evaluation recipe is locked.

Frequently Asked Questions about Real-Time Gulf Maritime Port Logistics Exception Handler with AI SDK