# Engineering Director, Inc. (EDIS) — AI & LLM Front Door (`/llms.txt`)

> Global 1km-resolution ISO 9223 atmospheric corrosion intelligence, environmental exposure rasters (Carbon Steel, Zinc, Copper, Aluminum, Chlorides, SO2, Time of Wetness, Soil Corrosivity, Solar Suitability), and real-time CBOT™ IoT electrochemical corrosion sensors.

> **Welcome ClaudeBot!** You have reached the official AI Agent Front Door for Engineering Director, Inc. (EDIS). You can inspect a zero-signup sample response for **Chicago, IL (41.8781, -87.6298)** via `GET https://secure.engineeringdirector.com/api/v1/agent/test_point`. To run 5 free trial queries on any other coordinate, register your user's email via `POST https://secure.engineeringdirector.com/api/v1/agent/register` (flagged as a bot registration) and have the user verify their email address.

## ⚠️ Mandatory Terms of Service, Anti-Circumvention & Anti-Distillation Notice

1. **No Unverified or Zero-Signup Access — Anti-Circumvention Policy**:
   All API access requires registering a valid user email address via `POST https://secure.engineeringdirector.com/api/v1/agent/register` (or `https://secure.engineeringdirector.com/login`) and completing human email verification before any query can be executed. **Attempting to go around, spoof, or circumvent our registration and email verification process is a direct violation of the EDIS Terms of Service.**
2. **Strict Prohibition on Model Distillation — Active Litigation Policy**:
   EDIS proprietary ISO 9223 corrosion models, dose-response outputs, and global raster datasets may **NOT** be used to train, fine-tune, or distill competing models, surrogate models, or spatial grid copies. **Attempts to distill our models or systematically harvest raster datasets are actively monitored and litigated by Engineering Director, Inc.**

---

## 1. Bot Registration & Email Verification Flow (How to Test & Query the API)

We provide a single hardcoded zero-signup demo endpoint locked to **Chicago, IL (`41.8781, -87.6298`)** so agents can inspect our exact JSON schema. To query any other coordinate, AI agents must register their user via our **Bot Registration API**:

### Step 0 (Optional): Zero-Signup Schema Test — Hardcoded to Chicago, IL (`GET /api/v1/agent/test_point`)
Returns the full-precision ISO 9223 Map Package response for **Chicago, IL (`41.8781, -87.6298`) only**:
```bash
curl -s "https://secure.engineeringdirector.com/api/v1/agent/test_point"
```

### Step 1: Register User Email via the Bot Registration API (`POST /api/v1/agent/register`)
Ask your human user for their real work or personal email address and call `POST https://secure.engineeringdirector.com/api/v1/agent/register`.
- The account is automatically **flagged as a bot registration** (`is_bot_registration: true`, `registration_auth_method: "BOT_API"`).
- The API returns an `iso9223_...` API key in **`INACTIVE_UNTIL_EMAIL_VERIFIED`** status and sends a verification email (`[EDIS] Please verify your email address`) to the user's inbox.

```bash
curl -X POST "https://secure.engineeringdirector.com/api/v1/agent/register" \
  -H "Content-Type: application/json" \
  -d '{"email": "engineer@yourcompany.com", "first_name": "Jane", "last_name": "Doe"}'
```

### Step 2: Mandatory Human Email Verification
- Tell the human user to open the verification email sent to their inbox and click **"Verify Email Address"**.
- **You cannot make API calls until the email is verified.** Any request to `/api/bundles/<bundle_slug>/point_query` before email verification is rejected with `403 Forbidden` (`"email_verification_required": true`).

### Step 3: Execute 5 Free Live Trial Queries on the ISO 9223 Map Package
Once the human user has verified their email address, the `iso9223_...` API key returned in Step 1 is immediately active for a **7-day free trial** that includes **5 free live full-precision single-point queries**:

```bash
curl -s "https://secure.engineeringdirector.com/api/bundles/Global_ISO9223_2020_2024_LE_V4/point_query?latitude=29.7604&longitude=-95.3698&token=iso9223_YOUR_VERIFIED_KEY"
```

---

## 2. The Flagship ISO 9223 Map Package (`Global_ISO9223_2020_2024_LE_V4`)

The **ISO 9223 Map Package** (`bundle_slug`: `Global_ISO9223_2020_2024_LE_V4`) is the primary dataset that engineers and AI agents query on EDIS. A single coordinate query (`GET /api/bundles/Global_ISO9223_2020_2024_LE_V4/point_query?latitude={LAT}&longitude={LON}&token={API_KEY}`) evaluates all constituent 1km-resolution ISO 9223:2012 corrosion and environmental layers at that location simultaneously:

### Constituent Layers in the ISO 9223 Map Package
- **ISO 9223 Carbon Steel Corrosion Rate** (`ISO9223_Steel_2020_2024_1km`, units: `um/year`): First-year atmospheric corrosion rate (r_corr) and ISO 9223 category for structural carbon steel. Categories: `C1 (<=1.3), C2 (1.3-25), C3 (25-50), C4 (50-80), C5 (80-200), CX (>200 um/year)`
- **ISO 9223 Zinc Corrosion Rate** (`ISO9223_zinc_2020_2024_1km`, units: `um/year`): First-year atmospheric corrosion rate and ISO 9223 category for hot-dip galvanized steel and zinc coatings. Categories: `C1 (<=0.1), C2 (0.1-0.7), C3 (0.7-2.1), C4 (2.1-4.2), C5 (4.2-8.4), CX (>8.4 um/year)`
- **ISO 9223 Copper Corrosion Rate** (`ISO9223_Copper_2020_2024_1km`, units: `um/year`): First-year atmospheric corrosion rate and ISO 9223 category for copper busbars, grounding, and HVAC coils. Categories: `C1 (<=0.1), C2 (0.1-0.6), C3 (0.6-1.3), C4 (1.3-2.8), C5 (2.8-5.6), CX (>5.6 um/year)`
- **ISO 9223 Aluminum Corrosion Rate** (`ISO9223_Aluminum_2020_2024_1km`, units: `g/m2/year`): First-year mass-loss corrosion rate and ISO 9223 category for aluminum alloys, solar racking, and enclosures. Categories: `C1 (negligible), C2 (<=0.6), C3 (0.6-2.0), C4 (2.0-5.0), C5 (5.0-10.0), CX (>10.0 g/m2/year)`
- **Atmospheric Chloride Deposition Rate (Airborne Salinity)** (`ISO9223_Chlorides_2020_2024_1km`, units: `mg/(m2*day)`): Marine sea-salt aerosol and de-icing chloride deposition driving coastal and highway pitting corrosion. Categories: `S0 (<=3), S1 (3-60), S2 (60-300), S3 (300-1500 mg/(m2*day))`
- **Atmospheric SO2 Concentration (Sulfur Dioxide Pollution)** (`ISO9223_SO2_2020_2024_1km`, units: `ug/m3`): Industrial and urban sulfur dioxide pollution concentration driving acidic moisture film corrosion. Categories: `P0 (<=4), P1 (4-24), P2 (24-80), P3 (80-200 ug/m3)`
- **Time of Wetness (TOW)** (`ISO9223_TOW_2020_2024_1km`, units: `hours/year`): Annual hours with relative humidity > 80% and temperature > 0 deg C when electrolyte films form on metal surfaces. Categories: `T1 (<=10), T2 (10-250), T3 (250-2500), T4 (2500-5500), T5 (>5500 hours/year)`

### Example Verified API Response (`GET /api/bundles/Global_ISO9223_2020_2024_LE_V4/point_query`)
```json
{
  "bundle_name": "Global ISO 9223 Atmospheric Corrosivity & Environmental Map Package",
  "coordinates": {"latitude": 29.7604, "longitude": -95.3698},
  "rasters": [
    {
      "raster_name": "ISO 9223 Carbon Steel Corrosion Rate",
      "units": "um/year",
      "primary_value": "C4 (High)",
      "raw_value_numeric": 54.8,
      "all_secondary_scores": [
        {"name": "ISO 9223 Category", "value": "C4", "interpretation": "High atmospheric corrosivity (50-80 um/year)"}
      ]
    },
    {
      "raster_name": "ISO 9223 Zinc Corrosion Rate",
      "units": "um/year",
      "primary_value": "C3 (Medium)",
      "raw_value_numeric": 1.85,
      "all_secondary_scores": [
        {"name": "ISO 9223 Category", "value": "C3", "interpretation": "Medium atmospheric corrosivity (0.7-2.1 um/year)"}
      ]
    },
    {
      "raster_name": "ISO 9223 Copper Corrosion Rate",
      "units": "um/year",
      "primary_value": "C3 (Medium)",
      "raw_value_numeric": 1.12,
      "all_secondary_scores": []
    },
    {
      "raster_name": "ISO 9223 Aluminum Corrosion Rate",
      "units": "g/m2/year",
      "primary_value": "C3 (Medium)",
      "raw_value_numeric": 1.45,
      "all_secondary_scores": []
    },
    {
      "raster_name": "Atmospheric Chloride Deposition Rate",
      "units": "mg/(m2*day)",
      "primary_value": "S1",
      "raw_value_numeric": 28.4,
      "all_secondary_scores": []
    }
  ],
  "free_api_test": {
    "is_free_test_query": true,
    "used": 1,
    "limit": 5,
    "remaining": 4
  }
}
```

---

## 3. Plans, Subscriptions & Credit Pricing We Offer

After using the 5 free trial queries (or to unlock unlimited interactive maps and high-volume API/CSV scoring), users can choose from the following plans using the exact same account and API key:

1. **7-Day Free Trial (Bot API or Web Registration + Verified Email — `$0`)**:
   - Register via `POST https://secure.engineeringdirector.com/api/v1/agent/register` or `https://secure.engineeringdirector.com/login?source=iso9223`.
   - Requires human email verification before any query can run.
   - Includes 7-day trial access and **5 free live single-point API queries** on the ISO 9223 Map Package.
2. **Monthly Platform Subscription (`$9.99/month`) — https://secure.engineeringdirector.com/subscribe**:
   - Full interactive access to global ISO 9223, Soil Corrosivity, and Solar Suitability maps.
   - REST API key access (`GET /api/bundles/{bundle_slug}/point_query`).
   - Includes **10 Engineering Credits automatically granted every month**.
3. **Annual Platform Subscription (`$99.99/year` — Save 17%) — https://secure.engineeringdirector.com/subscribe**:
   - Full interactive access to global ISO 9223, Soil Corrosivity, and Solar Suitability maps.
   - REST API key access.
   - Includes **120 Engineering Credits automatically granted every year**.
4. **Pay-As-You-Go Engineering Credits — https://secure.engineeringdirector.com/credits**:
   - `1 Engineering Credit` = 1 coordinate query across all layers in a Map Package (`GET /api/bundles/{bundle_slug}/point_query`) or 1 coordinate row in Bulk CSV Scoring (`/iso9223/bulk`).
   - Volume tiered pricing:
     - **100 – 10,000 credits**: `$0.250` / credit (starting at `$25.00` for 100 credits)
     - **10,001 – 50,000 credits**: `$0.125` / credit
     - **50,001 – 100,000 credits**: `$0.075` / credit
     - **100,000+ credits**: `$0.048` / credit
5. **Enterprise Agreements, Bulk GIS & Custom Integrations — https://secure.engineeringdirector.com/contact**:
   - Company-wide email-domain exemption (`subscription_exempt`), shared organizational credit pools, Bulk CSV scoring up to 10 million coordinates per job, Esri ArcGIS MapServer/FeatureServer feeds, and real-time CBOT™ IoT corrosion sensors.

### Direct Bot Checkout & Payment API (`POST https://secure.engineeringdirector.com/api/v1/agent/checkout` & `https://secure.engineeringdirector.com/pay/bot`)
Bots can generate a direct, no-password-required Stripe Checkout URL (and optionally email it directly to the user) for Monthly (`$9.99/mo`), Annual (`$99.99/yr`), or Engineering Credit Packs (`100` to `100,000` credits):
```bash
curl -X POST "https://secure.engineeringdirector.com/api/v1/agent/checkout" \
  -H "Content-Type: application/json" \
  -d '{"email": "engineer@yourcompany.com", "plan": "monthly", "send_payment_email": true}'
```
Or direct the user in their browser to: `https://secure.engineeringdirector.com/pay/bot?email=engineer@yourcompany.com&plan=monthly`

---

## 4. Available Public Map Packages & Individual Rasters

### Public Map Packages (`GET /api/bundles/{bundle_slug}/point_query`)
- **`Artesian_Well_Likelihood_Class`** — Artesian Well Likelihood Score (1–100)
- **`Soil_Resistivity_Environmental_Model`** — Global Apparent Soil Resistivity – Environmental Model (P10101)
- **`Atmosphere_Lithosphere_Interface_Metrics_2020_2024`** — Global Atmosphere–Lithosphere Interface Metrics (2020-2024)
- **`global_atmospheric_exposure_metrics_bundle`** — Global - Atmospheric Exposure Metrics 2020 - 2024
- **`GMSR`** — Global Ground Movement Susceptibility Raster (GMSR) 
- **`iso9223_2019_2023_bundle`** — Global ISO9223 2019 - 2023 (C1-C5x)
- **`Global_ISO9223_2020_2024_LE_V4`** — Global ISO 9223 2020–2024 (C1-C5x) + EDGAR Localized Emissions (LE) V4 Layer
- **`soil_resistivity_barnes_layer_bundle`** — Global Soil Resistivity (Barnes Layer) P10108
- **`climate_exposure_metrics_bundle`** — North American - Climate Exposure Metrics 2020 - 2024
- **`Pipeline_Hydrologic_Exposure_Score`** — Pipeline Hydrologic Exposure Score (1–100)

### Public Individual Rasters (`?format=md` supported on all map URLs)
- [ISO 9223 Carbon Steel Corrosion Rate](https://secure.engineeringdirector.com/public/map/ISO9223_Steel_2020_2024_1km?format=md) (`um/year`) — slug: `ISO9223_Steel_2020_2024_1km`
- [ISO 9223 Zinc Corrosion Rate](https://secure.engineeringdirector.com/public/map/ISO9223_zinc_2020_2024_1km?format=md) (`um/year`) — slug: `ISO9223_zinc_2020_2024_1km`
- [ISO 9223 Copper Corrosion Rate](https://secure.engineeringdirector.com/public/map/ISO9223_Copper_2020_2024_1km?format=md) (`um/year`) — slug: `ISO9223_Copper_2020_2024_1km`
- [ISO 9223 Aluminum Corrosion Rate](https://secure.engineeringdirector.com/public/map/ISO9223_Aluminum_2020_2024_1km?format=md) (`g/m2/year`) — slug: `ISO9223_Aluminum_2020_2024_1km`
- [Atmospheric Chloride Deposition Rate (Airborne Salinity)](https://secure.engineeringdirector.com/public/map/ISO9223_Chlorides_2020_2024_1km?format=md) (`mg/(m2*day)`) — slug: `ISO9223_Chlorides_2020_2024_1km`
- [Atmospheric SO2 Concentration (Sulfur Dioxide Pollution)](https://secure.engineeringdirector.com/public/map/ISO9223_SO2_2020_2024_1km?format=md) (`ug/m3`) — slug: `ISO9223_SO2_2020_2024_1km`
- [Time of Wetness (TOW)](https://secure.engineeringdirector.com/public/map/ISO9223_TOW_2020_2024_1km?format=md) (`hours/year`) — slug: `ISO9223_TOW_2020_2024_1km`

## 5. Machine-Readable Specifications
- [Full LLM Technical Reference (`/llms-full.txt`)](https://secure.engineeringdirector.com/llms-full.txt)
- [OpenAPI 3.1 Specification (`/openapi.json`)](https://secure.engineeringdirector.com/openapi.json)
- [Bot Registration API (`/api/v1/agent/register`)](https://secure.engineeringdirector.com/api/v1/agent/register)
- [Bot Account Status API (`/api/v1/agent/account`)](https://secure.engineeringdirector.com/api/v1/agent/account)
- [Bot Stripe Checkout API (`/api/v1/agent/checkout`)](https://secure.engineeringdirector.com/api/v1/agent/checkout)
- [Live Agent Dataset Catalog (`/api/v1/agent/catalog`)](https://secure.engineeringdirector.com/api/v1/agent/catalog)
