Build a Warehouse Gate Pickup Appointment and Carrier Yard Dispatcher — implementation

## Build
Coordinate warehouse dock appointments and carrier queue allocations across Jurong industrial facilities. Reconcile truck driver slot requests against loading bay limits and live traffic condition feeds.

## User
Warehouse Operations Supervisor

## Workflow
1. Ingest carrier pickup appointment requests containing container numbers, prime mover registration, and booking time windows.
2. Query Singapore real-time traffic condition APIs to estimate hauler travel delay along major freight corridors.
3. Assign loading dock bays and staggered staging slots based on fork-truck availability and hazardous cargo restrictions.
4. Synthesize an operational yard gate pass with QR token and automated carrier arrival notifications.

## Interface
A terminal dashboard displaying bay occupancy, pending hauler booking queues, traffic congestion alerts, and single-click appointment reschedule approvals.

## Data
Use data.gov.sg real-time traffic and weather APIs alongside synthetic JSON carrier pickup manifests stored in a local mock sandbox.
Starter examples below are synthetic. They are not downloaded records.

## Source
[Singapore open data API](https://guide.data.gov.sg/developer-guide/api-overview)
Extract real-time traffic and road incident APIs from data.gov.sg to calculate inbound hauler travel delays.

## Tools
agno, fastapi, pydantic.
Agno provides lightweight structured tool calling to integrate external traffic APIs with deterministic bay assignment schemas.
Fast reasoning LLM via hosted API with structured output mode enabled.

## Deliverables
Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

## Acceptance
- Assigns non-overlapping dock bay time slots across valid carrier requests.
- Adjusts pickup arrival buffers when traffic incidents are reported on corridor routes.
- Generates structured gate access tokens containing bay assignment and container ID.
- Rejects pickup bookings that exceed warehouse physical handling capacity.

## Starter Examples
```json
[
  {
    "input": {
      "booking_id": "BK-7701",
      "carrier_code": "SGLOG-01",
      "vehicle_plate": "SLA8912C",
      "container_id": "MSKU9012841",
      "requested_slot": "2025-04-10T14:00:00+08:00",
      "bay_type": "standard_dry",
      "traffic_delay_minutes": 15
    },
    "expected_output": {
      "status": "confirmed",
      "assigned_bay": "BAY-04",
      "adjusted_slot_start": "2025-04-10T14:15:00+08:00",
      "adjusted_slot_end": "2025-04-10T14:45:00+08:00",
      "gate_pass_token": "PASS-7701-BAY04",
      "yard_instructions": "Proceed via Jurong Port Road Gate 2"
    }
  },
  {
    "input": {
      "booking_id": "BK-7702",
      "carrier_code": "SGLOG-02",
      "vehicle_plate": "SLB1234Z",
      "container_id": "CMAU1122334",
      "requested_slot": "2025-04-10T14:00:00+08:00",
      "bay_type": "cold_chain",
      "traffic_delay_minutes": 45
    },
    "expected_output": {
      "status": "reschedule_required",
      "assigned_bay": null,
      "adjusted_slot_start": null,
      "adjusted_slot_end": null,
      "gate_pass_token": null,
      "yard_instructions": "No cold chain bay available for delay window exceeding 30 minutes. Select alternative slot."
    }
  }
]
```

## Safety
Simulates yard staging approvals without directly controlling physical barrier arms or automated guided vehicles.
Use mock external writes. Require human review before any real deployment.