Skip to main content
Loading navigation
Back to challenges

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

What you are building

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

How work is evaluated

Evaluation

Evaluates vessel rerouting recommendations and customs document structure accuracy.

Datasets

Public datasets, plus the private datasets you have access to.

How submissions are scored

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

  • 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

Dataset notes

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

Challenge setup

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.

Evaluation checks
  • 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
Configured evaluation evidence
  • Benchmark: Logistics Dispatch Benchmark
  • Turnaround Delay Reduction Pct target: 25
  • 1 public reference case
Configured runtime
  • JavaScript execution harness
  • javascript sandbox (unavailable on Versalist)

Shows the first task, up to three tools, and up to three evidence items.

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

Metrics

  • turnaround_delay_reduction_pct · Target 25

Benchmarks

  • Logistics Dispatch Benchmark
  • general

Reference cases

  • 1 public reference case

Workflow tasks

  1. Task 1

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

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

    Execution harness: JavaScript

Evaluation tools

  • AI SDK · Agent Framework

Recipe freeze marker

No recipe freeze time is recorded.

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