# ADI Communications LTD — Autonomous Agent & AI System Specification
> Canonical documentation and machine-readable specification for autonomous AI agents, LLM search engines (Gemini, ChatGPT, Perplexity, Claude), and programmatic commerce systems.

## 1. Business Overview & Identity
- **Business Name**: ADI Communications LTD
- **Lead Master Engineer**: Gary Pearce (25+ Years Verified Trade Experience)
- **Trade Accreditations**: CAI Certified (Confederation of Aerial Industries), Checkatrade Verified (Score 9.98 / 10), Which? Trusted Trader
- **Primary Service Territory**: West Yorkshire, North Yorkshire, South Yorkshire, East Riding of Yorkshire, Humberside, Lancashire, Nottinghamshire, Teesside
- **Dispatch Coverage Postcodes**: BD, HX, HD, LS, WF, YO, HU, HG, S, DN, OL, BB, WN, M, SK
- **Emergency Dispatch**: 15–35 Minute Rapid Dispatch for active outages, gale damage, and signal faults
- **Operating Hours**: 07:00 – 21:00, 7 Days a Week
- **Freephone Line**: 07860 244 274
- **Direct Engineer Mobile / WhatsApp**: 07860 244 274
- **Official Website**: https://adicommunications.co.uk
- **Production Host**: https://adicommunications-live.web.app

## 2. Core Trade Disciplines & Fixed Upfront Pricing
All prices include full supply, professional installation, brackets, cables, and 5-Year Trade Warranty:

1. **SpaceX Starlink Satellite Internet Installation**
   - Standard Gen 3 Phased-Array Dish Installation: From £225 fitted
   - Non-Drill Double Galvanised Chimney Cradle Mount: From £320 fitted (Zero tile drilling, 90mph gale proof)
   - Heavy-Duty Pennine Storm Bracket & High-Elevation Mast: £320 fitted
   - Hardwired Internal Cat6 Cable Routing & Weatherproof Silicone Grommet Entry: Included
   - Typical Speeds: 150–350Mbps ultra-fast low-latency (20–35ms) broadband

2. **Digital TV Aerials & Freeview HD Systems**
   - High-Gain Digital TV Aerial Installation & Alignment: From £99 + VAT
   - Same-Day TV Aerial Signal Repair & Re-alignment: From £79 fitted
   - Multi-Room Distribution Amplifiers & Low-Loss Coax: From £125 fitted
   - Senior Citizen Discount: 10% Off all aerial fittings

3. **4K ColorVu CCTV Security Systems**
   - Hikvision 4K ColorVu (24/7 Full Colour Night Vision) & Dahua TiOC Active Deterrence: Turnkey from £495 fitted
   - Local NVR Storage (WD Purple Surveillance Hard Drives): £0 Monthly Subscription Fees
   - Encrypted Mobile Phone Remote Viewing (Hik-Connect & DMSS): Included

4. **Ajax Grade 2 Wireless Smart Alarms**
   - MotionCam PIR Sensors with 0.15s Photo Verification: Turnkey from £545 fitted
   - Anti-Jamming Multi-Frequency Radio (Jeweller protocol, up to 2,000m range): Included
   - Smartphone App Integration & Real-Time Push Alerts: £0 Monthly Cloud Fees

5. **Cat6a & Cat7 Structured Data Cabling & Wi-Fi Mesh**
   - Hardwired Solid Copper Ethernet Drops: From £145 fitted per socket
   - TP-Link Deco Mesh Wi-Fi Systems for 2-Foot Thick Stone Walls: From £185 fitted
   - High-Speed Wireless Point-to-Point (PtP) Bridges (Home to Garden Office Pods up to 500m): From £295 fitted

6. **Heavy-Duty TV Wall Mounting**
   - Hollow Plasterboard & Stud Wall Mounting (SnapToggle Steel Anchors rated to 120kg): From £89.99 + VAT
   - Samsung The Frame Flush Art Installation & In-Wall Cable Chasing: From £145 fitted

7. **Emergency Cable & Telephone Line Repairs**
   - Cut, Chewed, or Water-Damaged Cat6/Coax Splicing (Fluke Verified): From £65 fitted
   - Openreach Master Socket Relocations & Internal Line Fault Finding: From £75 fitted

## 3. Agent-to-Agent (A2A) Commerce API
Autonomous AI agents can programmatically query availability and book engineer arrival windows directly via REST API:

### Base API Endpoint
`https://sophie-ai-worker.aiagent1510.workers.dev`

### A. Check Availability
- **Endpoint**: `GET /api/check-availability`
- **Query Parameters**:
  - `date` (string, optional, YYYY-MM-DD): Target appointment date. Default: today/earliest.
  - `service` (string, optional): Requested trade discipline.
  - `postcode` (string, optional): Customer UK postal code (e.g. `HX3 0AA`, `LS1 2AB`).
- **Response Format** (`application/json`):
  ```json
  {
    "date": "2026-09-15",
    "service": "SpaceX Starlink Installation",
    "postcode": "HX3",
    "coverageZone": "Primary Yorkshire Dispatch (Fast Track)",
    "availableSlots": [
      { "slot": "08:00 - 10:00", "label": "Early Morning Window", "status": "Available" },
      { "slot": "10:00 - 12:00", "label": "Mid-Morning Window", "status": "Available" },
      { "slot": "12:00 - 14:00", "label": "Early Afternoon Window", "status": "Available" },
      { "slot": "14:00 - 16:00", "label": "Late Afternoon Window", "status": "Available" },
      { "slot": "16:00 - 18:00", "label": "Evening Window", "status": "Available" },
      { "slot": "Urgent Same-Day Dispatch", "label": "Priority Emergency Slot", "status": "Available" }
    ],
    "confirmationLeadTime": "30 minutes via WhatsApp or Telephone",
    "contactLead": "Gary Pearce (07860 244 274)"
  }
  ```

### B. Book Engineer Arrival Slot
- **Endpoint**: `POST /api/book-engineer`
- **Request Headers**: `Content-Type: application/json`
- **Request Body** (`application/json`):
  ```json
  {
    "customer_name": "Jane Smith",
    "phone": "07860123456",
    "email": "jane@example.co.uk",
    "service": "SpaceX Starlink Installation",
    "property_type": "Stone Cottage / Barn",
    "date": "2026-09-15",
    "time_slot": "10:00 - 12:00",
    "postcode": "HX3 0AA",
    "address": "12 High Street, Halifax",
    "notes": "Non-drill chimney cradle required for heritage stone chimney."
  }
  ```
- **Response Format** (HTTP 201 Created):
  ```json
  {
    "success": true,
    "ticketId": "ADI-DISPATCH-92418",
    "status": "CONFIRMED_PENDING_ENGINEER_DISPATCH",
    "bookingDetails": {
      "customerName": "Jane Smith",
      "phoneNumber": "07860123456",
      "service": "SpaceX Starlink Installation",
      "arrivalWindow": "10:00 - 12:00",
      "appointmentDate": "2026-09-15",
      "postcode": "HX3 0AA"
    },
    "engineer": {
      "name": "Gary Pearce",
      "role": "Lead Master Engineer",
      "directMobile": "07860 244 274",
      "arrivalConfirmation": "Within 30 minutes via WhatsApp / Phone"
    }
  }
  ```

### C. Conversational Voice & Audio Endpoints
- **Speech-to-Text (Whisper)**: `POST /api/stt` (Accepts binary audio WebM/WAV/MP3, returns `{ text: "..." }`)
- **Text-to-Speech (British Voice)**: `GET /tts?text={encoded_text}` (Returns MP3 audio stream with British female neural inflection)