diff --git a/.gitignore b/.gitignore
index 77e6850..078442a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,13 @@
-# reference data
+# reference data (downloaded airports, etc.)
 /data/*
+# curated MCT starter dataset (checked in — see data/reference/mct/)
+!/data/reference/
+!/data/reference/.gitkeep
+!/data/reference/mct/
+!/data/reference/mct/**
+/data/reference/airports.json
+/data/reference/metro-areas.json
+/data/reference/decommissioned.json
 
 # OTAIP run/gate traces (durable JSONL written by @otaip/integration)
 traces/
diff --git a/data/reference/mct/README.md b/data/reference/mct/README.md
new file mode 100644
index 0000000..aaf1c7a
--- /dev/null
+++ b/data/reference/mct/README.md
@@ -0,0 +1,26 @@
+# MCT reference data (`data/reference/mct/`)
+
+Curated Minimum Connecting Time rows for Agent 1.3 Connection Builder.
+
+**Authority:** IATA SSIM Chapter 8 + PSC Resolution 765. See `docs/knowledge-base/mct.md`.
+
+## Hierarchy (most specific → fail-closed)
+
+| Priority | Level              | File / field                                                  | When used                                                                                 |
+| -------- | ------------------ | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| 1        | Carrier override   | `carrier-overrides.json`                                      | Matching arriving/departing carriers (+ connection status) at airport; optional terminals |
+| 2        | Airport + terminal | `airport-rules.json` (`terminal_change` or terminal pair set) | No carrier match; terminal change known                                                   |
+| 3        | Airport            | `airport-rules.json` (station default for status)             | No carrier/terminal match                                                                 |
+| 4        | Fail-closed        | —                                                             | **No invented IATA global table.** MCT unresolved → connection invalid                    |
+
+## Rules for adding rows
+
+- Cite a source (`source` field): SSIM/aggregator extract, public doc URL, or `already-in-code:…`.
+- Do **not** add airport-constant guesses or a global 60/90 table.
+- Do **not** derive MCT from haversine / great-circle distance.
+- Interline / unpublished carrier exceptions → leave as `DOMAIN_QUESTION` in the KB; do not invent.
+
+## Files
+
+- `carrier-overrides.json` — carrier@airport starter rows
+- `airport-rules.json` — station/terminal rows (empty until a real extract is available)
diff --git a/data/reference/mct/airport-rules.json b/data/reference/mct/airport-rules.json
new file mode 100644
index 0000000..8f99907
--- /dev/null
+++ b/data/reference/mct/airport-rules.json
@@ -0,0 +1,7 @@
+{
+  "version": "0.1.0",
+  "description": "Airport / airport+terminal MCT rules from SSIM station filings. Empty until a real extract is curated — do not invent airport constants.",
+  "authority": ["IATA SSIM Chapter 8", "IATA PSC Resolution 765"],
+  "hierarchy_levels": ["airport_terminal", "airport"],
+  "rules": []
+}
diff --git a/data/reference/mct/carrier-overrides.json b/data/reference/mct/carrier-overrides.json
new file mode 100644
index 0000000..020630b
--- /dev/null
+++ b/data/reference/mct/carrier-overrides.json
@@ -0,0 +1,25 @@
+{
+  "version": "0.1.0",
+  "description": "Carrier-specific MCT overrides (SSIM Ch.8 / PSC Res 765). Starter set only — not a full industry extract.",
+  "authority": [
+    "IATA SSIM Chapter 8",
+    "IATA PSC Resolution 765",
+    "https://www.iata.org/contentassets/638f0938b3dd451b872a1d8357755421/minimum-connecting-time-user-guide_version-1.1.pdf"
+  ],
+  "hierarchy_level": "carrier_override",
+  "overrides": [
+    {
+      "airport": "ORD",
+      "arriving_carrier": "UA",
+      "departing_carrier": "UA",
+      "connection_status": "DD",
+      "connection_type": "domestic",
+      "scope": "online",
+      "minutes": 50,
+      "arrival_terminal": null,
+      "departure_terminal": null,
+      "source": "already-in-code: packages/agents/search/src/connection-builder/mct-data.ts carrier_rules (pre-#141)",
+      "notes": "Online same-carrier domestic at ORD. Not validated against a public SSIM/OAG extract."
+    }
+  ]
+}
diff --git a/docs/agent-map.html b/docs/agent-map.html
index be7c8e4..cca978a 100644
--- a/docs/agent-map.html
+++ b/docs/agent-map.html
@@ -1897,7 +1897,7 @@ <h2>Every agent, by stage.</h2>
     <div class="panel-inner" id="panel-content"></div>
   </aside>
 
-  <script id="graph-data" type="application/json">{"graph":{"generated_by":"scripts/generate-manifest.ts","total_nodes":77,"total_edges":27,"nodes":[{"id":"0.1","name":"Airport/City Code Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/airport-code-resolver/index.ts"},{"id":"0.2","name":"Airline Code & Alliance Mapper","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/airline-code-mapper/index.ts"},{"id":"0.3","name":"Fare Basis Code Decoder","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/fare-basis-decoder/index.ts"},{"id":"0.4","name":"Class of Service Mapper","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/class-of-service-mapper/index.ts"},{"id":"0.5","name":"Equipment Type Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/equipment-type-resolver/index.ts"},{"id":"0.6","name":"Currency & Tax Code Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/currency-tax-resolver/index.ts"},{"id":"0.7","name":"Country Regulatory Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/country-regulatory-resolver/index.ts"},{"id":"1.1","name":"Availability Search","stage":"search","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/availability-search/index.ts"},{"id":"1.2","name":"Schedule Lookup","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/schedule-lookup/index.ts"},{"id":"1.3","name":"Connection Builder","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/connection-builder/index.ts"},{"id":"1.4","name":"Fare Shopping","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/fare-shopping/index.ts"},{"id":"1.5","name":"Ancillary Shopping","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/ancillary-shopping/index.ts"},{"id":"1.6","name":"Multi-Source Aggregator","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/multi-source-aggregator/index.ts"},{"id":"1.7","name":"Hotel & Car Search","stage":"search","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/hotel-car-search/index.ts"},{"id":"1.8","name":"AI Travel Advisor","stage":"search","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/ai-travel-advisor/index.ts"},{"id":"1.9","name":"Offer Evaluator","stage":"core","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/core/src/agents/shopping/offer-evaluator/index.ts"},{"id":"2.1","name":"Fare Rule Agent","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/pricing/src/fare-rule-agent/index.ts"},{"id":"2.2","name":"Fare Construction","stage":"pricing","version":"0.2.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/fare-construction/index.ts"},{"id":"2.3","name":"Tax Calculation","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/tax-calculation/index.ts"},{"id":"2.4","name":"Offer Builder","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/pricing/src/offer-builder/index.ts"},{"id":"2.5","name":"Corporate Policy Validation","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/corporate-policy-validation/index.ts"},{"id":"2.6","name":"Dynamic Pricing","stage":"pricing","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/pricing/src/dynamic-pricing/index.ts"},{"id":"2.7","name":"Revenue Management","stage":"pricing","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/pricing/src/revenue-management/index.ts"},{"id":"3.1","name":"GDS/NDC Router","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/gds-ndc-router/index.ts"},{"id":"3.2","name":"PNR Builder","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/pnr-builder/index.ts"},{"id":"3.3","name":"PNR Validation","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/pnr-validation/index.ts"},{"id":"3.4","name":"Queue Management","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/queue-management/index.ts"},{"id":"3.5","name":"API Abstraction","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/api-abstraction/index.ts"},{"id":"3.6","name":"Order Management","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/order-management/index.ts"},{"id":"3.7","name":"Payment Processing","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/payment-processing/index.ts"},{"id":"3.8","name":"PNR Retrieval","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/pnr-retrieval/index.ts"},{"id":"4.1","name":"Ticket Issuance","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/ticketing/src/ticket-issuance/index.ts"},{"id":"4.2","name":"EMD Management","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/emd-management/index.ts"},{"id":"4.3","name":"Void Agent","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/void-agent/index.ts"},{"id":"4.4","name":"Itinerary Delivery","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/itinerary-delivery/index.ts"},{"id":"4.5","name":"Document Verification","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/document-verification/index.ts"},{"id":"5.1","name":"Change Management","stage":"exchange","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/change-management/index.ts"},{"id":"5.2","name":"Exchange/Reissue","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/exchange-reissue/index.ts"},{"id":"5.3","name":"Involuntary Rebook","stage":"exchange","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/involuntary-rebook/index.ts"},{"id":"5.4","name":"Disruption Response","stage":"exchange","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/exchange/src/disruption-response/index.ts"},{"id":"5.5","name":"Self-Service Rebooking","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/exchange/src/self-service-rebooking/index.ts"},{"id":"5.6","name":"Waitlist Management","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/exchange/src/waitlist-management/index.ts"},{"id":"6.1","name":"Refund Processing","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/refund-processing/index.ts"},{"id":"6.2","name":"ADM Prevention","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/adm-prevention/index.ts"},{"id":"6.3","name":"ADM/ACM Processing","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/adm-acm-processing/index.ts"},{"id":"6.4","name":"Customer Communication","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/customer-communication/index.ts"},{"id":"6.5","name":"Feedback & Complaint","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/feedback-complaint/index.ts"},{"id":"6.6","name":"Loyalty Mileage","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/loyalty-mileage/index.ts"},{"id":"7.1","name":"BSP Reconciliation","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/bsp-reconciliation/index.ts"},{"id":"7.2","name":"ARC Reconciliation","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/arc-reconciliation/index.ts"},{"id":"7.3","name":"Commission Management","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/commission-management/index.ts"},{"id":"7.4","name":"Interline Settlement","stage":"reconciliation","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/reconciliation/src/interline-settlement/index.ts"},{"id":"7.5","name":"Financial Reporting","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/financial-reporting/index.ts"},{"id":"7.6","name":"Revenue Accounting","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/revenue-accounting/index.ts"},{"id":"8.1","name":"Traveler Profile","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/traveler-profile/index.ts"},{"id":"8.2","name":"Corporate Account","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/corporate-account/index.ts"},{"id":"8.3","name":"Mid-Office Automation","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/mid-office/index.ts"},{"id":"8.4","name":"Reporting & Analytics","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/reporting/index.ts"},{"id":"8.5","name":"Duty of Care","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/duty-of-care/index.ts"},{"id":"9.1","name":"Orchestrator","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/orchestrator/index.ts"},{"id":"9.2","name":"Knowledge Retrieval","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/knowledge/index.ts"},{"id":"9.3","name":"Monitoring & Alerting","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/monitoring/index.ts"},{"id":"9.4","name":"Audit & Compliance","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/audit/index.ts"},{"id":"9.5","name":"Plugin Manager","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/plugin-manager/index.ts"},{"id":"9.6","name":"Performance Audit","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/performance-audit/index.ts"},{"id":"9.7","name":"Routing Audit","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/routing-audit/index.ts"},{"id":"9.8","name":"Recommendation","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/recommendation/index.ts"},{"id":"9.9","name":"Alert","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/alert/index.ts"},{"id":"20.1","name":"Hotel Search Aggregator","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-search/index.ts"},{"id":"20.2","name":"Property Deduplication","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/property-dedup/index.ts"},{"id":"20.3","name":"Hotel Content Normalization","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/content-normalization/index.ts"},{"id":"20.4","name":"Hotel Rate Comparison","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/rate-comparison/index.ts"},{"id":"20.5","name":"Hotel Booking","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-booking/index.ts"},{"id":"20.6","name":"Hotel Modification & Cancellation","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-modification/index.ts"},{"id":"20.7","name":"Confirmation Verification","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/confirmation-verification/index.ts"},{"id":"20.8","name":"Activity Search","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/activity-search/index.ts"},{"id":"20.9","name":"Transfer Search","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/transfer-search/index.ts"}],"edges":[{"source":"1.1","target":"1.4","kind":"workflow","label":"search_to_price"},{"source":"1.4","target":"2.1","kind":"workflow","label":"search_to_price"},{"source":"2.1","target":"2.2","kind":"workflow","label":"search_to_price"},{"source":"2.2","target":"2.3","kind":"workflow","label":"search_to_price"},{"source":"3.3","target":"3.1","kind":"workflow","label":"book_to_ticket"},{"source":"3.1","target":"3.2","kind":"workflow","label":"book_to_ticket"},{"source":"3.2","target":"4.1","kind":"workflow","label":"book_to_ticket"},{"source":"1.1","target":"1.4","kind":"workflow","label":"full_booking"},{"source":"1.4","target":"2.1","kind":"workflow","label":"full_booking"},{"source":"2.1","target":"2.2","kind":"workflow","label":"full_booking"},{"source":"2.2","target":"2.3","kind":"workflow","label":"full_booking"},{"source":"2.3","target":"3.3","kind":"workflow","label":"full_booking"},{"source":"3.3","target":"3.1","kind":"workflow","label":"full_booking"},{"source":"3.1","target":"3.2","kind":"workflow","label":"full_booking"},{"source":"3.2","target":"4.1","kind":"workflow","label":"full_booking"},{"source":"5.1","target":"5.2","kind":"workflow","label":"exchange_flow"},{"source":"6.1","target":"6.2","kind":"workflow","label":"refund_flow"},{"source":"1.1","target":"0.1","kind":"package","label":"@otaip/agents-search → @otaip/agents-reference"},{"source":"2.1","target":"0.1","kind":"package","label":"@otaip/agents-pricing → @otaip/agents-reference"},{"source":"3.1","target":"0.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-reference"},{"source":"3.1","target":"1.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-search"},{"source":"3.1","target":"2.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-pricing"},{"source":"4.1","target":"3.1","kind":"package","label":"@otaip/agents-ticketing → @otaip/agents-booking"},{"source":"5.1","target":"1.1","kind":"package","label":"@otaip/agents-exchange → @otaip/agents-search"},{"source":"5.1","target":"4.1","kind":"package","label":"@otaip/agents-exchange → @otaip/agents-ticketing"},{"source":"6.1","target":"4.1","kind":"package","label":"@otaip/agents-settlement → @otaip/agents-ticketing"},{"source":"7.1","target":"0.1","kind":"package","label":"@otaip/agents-reconciliation → @otaip/agents-reference"}],"package_deps":[{"from_package":"@otaip/agents-search","to_package":"@otaip/agents-reference","from_stage":"search","to_stage":"reference"},{"from_package":"@otaip/agents-pricing","to_package":"@otaip/agents-reference","from_stage":"pricing","to_stage":"reference"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-reference","from_stage":"booking","to_stage":"reference"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-search","from_stage":"booking","to_stage":"search"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-pricing","from_stage":"booking","to_stage":"pricing"},{"from_package":"@otaip/agents-ticketing","to_package":"@otaip/agents-booking","from_stage":"ticketing","to_stage":"booking"},{"from_package":"@otaip/agents-exchange","to_package":"@otaip/agents-search","from_stage":"exchange","to_stage":"search"},{"from_package":"@otaip/agents-exchange","to_package":"@otaip/agents-ticketing","from_stage":"exchange","to_stage":"ticketing"},{"from_package":"@otaip/agents-settlement","to_package":"@otaip/agents-ticketing","from_stage":"settlement","to_stage":"ticketing"},{"from_package":"@otaip/agents-reconciliation","to_package":"@otaip/agents-reference","from_stage":"reconciliation","to_stage":"reference"}]},"docs":{"0.1":{"id":"0.1","summary":"Resolves IATA/ICAO airport and city codes to canonical airport records with multi-airport city awareness and historical code handling","className":"AirportCodeResolver","input":"`code` -- IATA 3-letter, ICAO 4-letter, city code, or airport name\n`code_type?` -- `'iata' | 'icao' | 'city' | 'name' | 'auto'` (auto-detected if omitted)\n`include_metro?` -- return all airports in a metro/city code (default: true)\n`include_decommissioned?` -- resolve retired/reassigned codes (default: false)","output":"`resolved_airport` -- canonical airport record (IATA, ICAO, name, city, country, timezone, lat/lon, type, status)\n`metro_airports` -- list of airports in the same metro area\n`match_confidence` -- 0-1 confidence score\n`stale_data?` -- true when dataset is older than 30 days\n`suggestion?` -- fuzzy match suggestion when code not found","usage":"const agent = new AirportCodeResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'JFK', code_type: 'iata' } });\n// result.data.resolved_airport.name => \"John F Kennedy International Airport\"","status":"Implemented","purpose":"Resolves IATA/ICAO airport and city codes to canonical airport records with multi-airport city awareness, fuzzy name matching, and historical code handling."},"0.2":{"id":"0.2","summary":"Resolves IATA/ICAO airline designator codes to canonical airline records with alliance membership mapping and codeshare partner networks","className":"AirlineCodeMapper","input":"`code` -- IATA 2-letter, ICAO 3-letter, or airline name\n`code_type?` -- `'iata' | 'icao' | 'name' | 'auto'`\n`include_codeshares?` -- include codeshare partners (default: false)\n`include_defunct?` -- include ceased-operations airlines (default: false)","output":"`airline` -- canonical airline record (codes, name, callsign, country, alliance, hubs, status)\n`codeshare_partners` -- partner airline list with relationship type\n`match_confidence` -- 0-1 confidence score","usage":"const agent = new AirlineCodeMapper();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'UA', include_codeshares: true } });\n// result.data.airline.name => \"United Airlines\"","status":"Implemented"},"0.3":{"id":"0.3","summary":"Decodes ATPCO-standard fare basis codes into human-readable components including cabin class, fare restrictions, advance purchase requirements, and penalty information","className":"FareBasisDecoder","input":"`fare_basis` -- ATPCO fare basis code (max 15 chars, e.g., `\"YOW3M1\"`, `\"TLXP14NR\"`)\n`carrier?` -- IATA airline code for carrier-specific decoding","output":"`decoded` -- parsed components (primary code, cabin class, fare type, season, day-of-week, advance purchase, min/max stay, penalties, ticket designator)\n`match_confidence` -- 1.0 = fully decoded, 0.5-0.9 = partial\n`unparsed_segments` -- parts that could not be decoded","usage":"const agent = new FareBasisDecoder();\nawait agent.initialize();\nconst result = await agent.execute({ data: { fare_basis: 'Y26NR' } });\n// result.data.decoded.cabin_class => \"economy\"","status":"Implemented"},"0.4":{"id":"0.4","summary":"Maps single-letter booking class codes to cabin class, fare family, upgrade eligibility, and loyalty program earning rates","className":"ClassOfServiceMapper","input":"`booking_class` -- single letter A-Z\n`carrier` -- IATA 2-letter airline code (required -- meanings are carrier-specific)\n`include_loyalty?` -- include loyalty earning rates (default: false)","output":"`mapping` -- cabin class, brand name, fare family, upgrade eligibility/type, same-day change, seat selection, refundable, priority level, loyalty earning\n`match_confidence` -- 1.0 = carrier-specific, 0.7 = IATA default, 0 = unknown","usage":"const agent = new ClassOfServiceMapper();\nawait agent.initialize();\nconst result = await agent.execute({ data: { booking_class: 'J', carrier: 'UA', include_loyalty: true } });\n// result.data.mapping.cabin_class => \"business\"","status":"Implemented","purpose":"Maps single-letter booking class codes to cabin class, fare family, upgrade eligibility, and loyalty program earning rates. Booking classes are carrier-specific."},"0.5":{"id":"0.5","summary":"Resolves IATA aircraft equipment codes to structured equipment data","className":"EquipmentTypeResolver","input":"`operation` -- `'resolve' | 'getSeatingConfig' | 'isWidebody' | 'getSimilarTypes'`\n`code` -- IATA equipment code (e.g., `\"789\"`, `\"320\"`)\n`cabin?` -- cabin code (`'F' | 'C' | 'W' | 'Y'`) for `getSeatingConfig`","output":"`equipment?` -- full equipment info (IATA/ICAO codes, manufacturer, family, body type, seats, range)\n`seatCount?` -- seat count for specific cabin\n`isWidebody?` -- boolean\n`similarTypes?` -- IATA codes of similar aircraft","usage":"const agent = new EquipmentTypeResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { operation: 'resolve', code: '789' } });\n// result.data.equipment.manufacturer => \"Boeing\"","status":"Implemented","purpose":"Resolves IATA aircraft equipment codes to structured equipment data including manufacturer, body type, typical seating, range, and max capacity."},"0.6":{"id":"0.6","summary":"Resolves ISO 4217 currency codes and IATA tax/surcharge codes used in airline pricing and ticketing","className":"CurrencyTaxResolver","input":"`code` -- ISO currency code or IATA tax code\n`code_type?` -- `'currency' | 'tax' | 'auto'`\n`country?` -- ISO 2-letter country code to filter tax applicability","output":"`currency` -- currency details (code, name, symbol, minor units, countries, active status)\n`tax` -- tax details (code, name, description, category, country, applies-to, percentage flag)\n`match_confidence` -- 0-1 confidence score","usage":"const agent = new CurrencyTaxResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'USD' } });\n// result.data.currency.name => \"US Dollar\"","status":"Implemented"},"0.7":{"id":"0.7","summary":"APIS requirements, visa requirements, restriction levels. Static dataset -- must NOT be used as legal travel advice","className":"CountryRegulatoryResolver","input":"`operation` -- `'getAPISRequirements' | 'getVisaRequirement' | 'getRestrictionLevel'`\n`countryCode?` -- ISO 2-letter (for APIS and restriction)\n`nationalityCode?` -- ISO 2-letter (for visa)\n`destinationCode?` -- ISO 2-letter (for visa)","output":"`apis?` -- APIS requirements (required fields, advance submission hours)\n`visa?` -- visa requirement (type, max stay days)\n`restriction?` -- restriction level 1-4 with summary","usage":"const agent = new CountryRegulatoryResolver();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { operation: 'getVisaRequirement', nationalityCode: 'US', destinationCode: 'GB' }\n});\n// result.data.visa.requirement => \"visa_free\"","status":"Implemented"},"1.1":{"id":"1.1","summary":"Queries distribution adapters in parallel, normalizes, deduplicates, filters, and sorts flight availability offers","className":"AvailabilitySearch","input":"`origin` -- origin airport/city IATA code\n`destination` -- destination airport/city IATA code\n`departure_date` -- ISO 8601 date\n`return_date?` -- ISO 8601 date for round-trip\n`passengers` -- `PassengerCount[]`\n`cabin_class?` -- `'economy' | 'premium_economy' | 'business' | 'first'`\n`direct_only?` -- only direct flights\n`max_connections?` -- 0-5\n`currency?` -- ISO 4217\n`max_results?` -- 1-200\n`sort_by?` -- `'price' | 'duration' | 'departure' | 'arrival' | 'connections'`\n`sort_order?` -- `'asc' | 'desc'`\n`sources?` -- specific adapter names to query","output":"`offers` -- deduplicated, filtered, sorted `SearchOffer[]`\n`total_raw_offers` -- count before deduplication\n`source_status` -- per-adapter query status (success, count, error, response time)\n`truncated` -- whether results were capped","usage":"new AvailabilitySearch(adapters: DistributionAdapter[]) Then call initialize() and execute({ data }).","status":"Implemented"},"1.2":{"id":"1.2","summary":"Looks up flight schedules with SSIM operating day parsing, codeshare detection, and connection discovery","className":"ScheduleLookup","input":"`origin` -- airport IATA code\n`destination` -- airport IATA code\n`date` -- ISO 8601 date\n`carrier?` -- filter by carrier IATA code\n`flight_number?` -- specific flight (requires carrier)\n`include_codeshares?` -- default: true\n`include_connections?` -- discover connecting options (default: false)","output":"`flights` -- `ScheduledFlight[]` (carrier, flight number, times, duration, schedule, codeshare info)\n`connections` -- `ConnectionOption[]` (two-leg connections with timing)\n`operates_on_date` -- whether any flights operate on the requested date","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.3":{"id":"1.3","summary":"Validates connections against MCT rules, scores connection quality, and checks interline agreements","className":"ConnectionBuilder","input":"`arriving_segment` -- `FlightSegment` (from `@otaip/core`)\n`departing_segment` -- `FlightSegment`\n`connection_airport` -- IATA 3-letter code\n`has_checked_bags?` -- affects MCT\n`is_interline?` -- different carriers","output":"`validation` -- MCT check result (valid, available/required minutes, buffer, applied rule)\n`quality` -- connection quality score 0-1 with factor breakdown\n`interline` -- interline agreement check (if different carriers)\n`warnings` -- connection warnings","status":"Implemented","purpose":"Validates connections against MCT (Minimum Connection Time) rules, scores connection quality, and checks interline agreements.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.4":{"id":"1.4","summary":"Multi-source fare comparison with fare basis decoding, class mapping, branded fare family grouping, and passenger type pricing","className":"FareShopping","input":"`origin`, `destination`, `departure_date`, `passengers` -- same as availability search\n`cabin_class?`, `currency?`, `sources?` -- filters\n`decode_fare_basis?` -- decode fare basis codes (default: true)\n`group_by_fare_family?` -- group by basic/standard/flex/premium (default: true)","output":"`fares` -- `FareOffer[]` sorted by price, each with decoded fare basis, class info, fare family, passenger pricing\n`fare_families` -- grouped by family with cheapest/most expensive\n`total_fares` -- count\n`sources_queried` -- adapter names","usage":"new FareShopping(adapters: DistributionAdapter[]) Then call initialize() and execute({ data }).","status":"Implemented"},"1.5":{"id":"1.5","summary":"Searches ancillary offers (seats, bags, meals) across distribution adapters","className":"AncillaryShoppingAgent","input":"`segments` -- flight segments (origin, destination, flight number, date, carrier)\n`passengers` -- passenger references with type (ADT/CHD/INF)\n`pnrRef?` -- PNR reference\n`requestedCategories?` -- filter by category (BAGGAGE, SEAT, MEAL, etc.)","output":"`ancillaries` -- `AncillaryOffer[]` with RFIC/RFISC codes, pricing, availability\n`notSupportedByAdapter` -- true if no adapter configured\n`currency` -- pricing currency","status":"Implemented","purpose":"Searches for available ancillaries (baggage, seats, meals, lounge, Wi-Fi, priority) via an injectable adapter.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.6":{"id":"1.6","summary":"Deduplicates and normalizes flight results from multiple adapter sources","className":"MultiSourceAggregatorAgent","input":"`results` -- `AdapterSearchResult[]` (adapter name, flights, errors, response time)\n`deduplicationStrategy` -- `'keep_cheapest' | 'keep_all' | 'keep_first'`\n`rankBy` -- `'price' | 'duration' | 'stops'`\n`maxResults?` -- limit output count","output":"`flights` -- `NormalizedFlight[]` with sources, lowest price, all prices across adapters\n`totalRaw` -- raw count before dedup\n`totalAfterDedup` -- final count\n`adapterSummary` -- per-adapter stats","status":"Implemented","purpose":"Aggregates search results from multiple adapters with deduplication, price comparison, and ranking.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.7":{"id":"1.7","summary":"Stub agent for hotel and car rental search via distribution adapters","className":"HotelCarSearchAgent","input":"`operation` -- `'searchHotels' | 'searchCars'`\n`hotel?` -- hotel search params (destination, dates, rooms, adults, star rating, max rate)\n`car?` -- car search params (pickup/dropoff location and times, category, driver age)","output":"`hotelResults?` -- hotel offers with rate, room type, cancellation policy\n`carResults?` -- car offers with category, supplier, daily/total rate, features","status":"Implemented (adapter-dependent)","purpose":"Car rental search (and, pending a deferred car-only migration, hotel) via pluggable adapters. Returns empty results when no adapters configured.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.8":{"id":"1.8","summary":"Natural language travel query understanding with injectable LLM provider; parses user queries into structured search parameters","className":"AITravelAdvisorAgent","input":"`query` -- natural language travel query\n`travelerContext?` -- preferences (cabin, budget, preferred airlines, passenger counts)","output":"`searchParameters` -- extracted origin, destination, dates, trip type, cabin, passengers, flexible dates\n`summary` -- natural language summary of interpreted query\n`intent` -- `'flight_search' | 'hotel_search' | 'destination_recommendation' | 'price_check' | 'trip_planning' | 'unknown'`","usage":"new AITravelAdvisorAgent({ llmProvider, maxTokens?, temperature? }) Then call initialize() and execute({ data }).","status":"Implemented"},"1.9":{"id":"1.9","summary":"Stateless, deterministic scoring engine for flight offers with multi-dimensional scoring, hard filtering, and full audit trail (lives in @otaip/core)","className":"OfferEvaluatorAgent","input":"`offers` -- `EvaluatorOffer[]` with price, itinerary (segments, duration, connections)\n`constraints?` -- latest arrival, prefer direct, max connections, price ceiling, preferred/blacklisted carriers\n`profile?` -- `'BUSINESS_TIME_CRITICAL' | 'BUSINESS_PRICE_CONSTRAINED' | 'LEISURE' | 'CORPORATE_POLICY' | 'CUSTOM'`\n`weights?` -- custom scoring weights (time_buffer, price, connection_quality, journey_duration)","output":"Scored and ranked offers with structured explanation for LLM translation","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.1":{"id":"2.1","summary":"Parses ATPCO fare rules (categories 1-20) into human-readable structured format using curated tariff snapshot data","className":"FareRuleAgent","input":"`fare_basis` -- fare basis code\n`carrier` -- marketing carrier IATA code\n`origin` -- origin IATA code\n`destination` -- destination IATA code\n`travel_date?` -- ISO date for date-based rule filtering\n`categories?` -- specific ATPCO categories 1-50 (all if omitted)","output":"`rules` -- `FareRuleResult[]` with parsed categories, penalty summary, advance purchase, min/max stay, seasonality\n`total_rules` -- count of matched rules\n`valid_for_date` -- whether fare is valid for the specified travel date\n`in_blackout` -- whether travel date falls in a blackout period","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.2":{"id":"2.2","summary":"NUC x ROE fare construction with mileage validation, HIP/BHC/CTM checks, surcharges, and IATA rounding. All financial math uses decimal.js","className":"FareConstruction","input":"`journey_type` -- `'OW' | 'RT' | 'CT'` (one-way, round-trip, circle-trip)\n`components` -- fare components (origin, destination, carrier, fare basis, NUC amount)\n`selling_currency` -- ISO 4217 currency\n`point_of_sale?` -- country for IROE selection context\n`data_sources?` -- licensed `{ iroe, rounding_024d, mileage }` (required for a constructed fare)","output":"Success (`FareConstructionOutput`): `total_nuc`, `iroe` (alias `roe`), `local_amount` after 024d, `rounding_method` (`HX`|`NX`), published `mileage_checks`, HIP/BHC/CTM sketches, `audit_trail`\nOr `DomainInputRequired` when licensed data is missing","status":"Implemented","purpose":"NUC × IROE construction with published TPM/MPM, Resolution **024d** (HX/NX) rounding, and fail-closed HIP/BHC/CTM hooks. All financial math uses `decimal.js`.\n\nLicensed IROE / 024d / TPM-MPM data are **not** shipped in the package. Pass them via `data_sources`. Missing IROE, TPM, or 024d → `DomainInputRequired`. Haversine-as-TPM and banker's rounding are banned.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.3":{"id":"2.3","summary":"Per-segment tax computation with exemption engine, ~30 countries, ~50 tax codes, currency conversion. All financial math uses decimal.js","className":"TaxCalculation","input":"`segments` -- itinerary segments (origin/destination airports and countries, carrier, cabin class, base fare NUC)\n`passenger_type` -- `'adult' | 'child' | 'infant' | 'crew' | 'diplomatic'`\n`is_transit` -- whether transit/connection (\u003c 24h same ticket)\n`is_involuntary` -- whether involuntary reroute\n`total_base_fare_nuc` -- total base fare for percentage-based taxes\n`selling_currency` -- ISO 4217","output":"`taxes` -- `AppliedTax[]` (code, name, country, type, amounts, segment indices, interlineable, exempt status)\n`total_tax` -- total in selling currency\n`breakdown` -- by country, interlineable/non-interlineable totals\n`exemptions_applied` -- list of exemption reasons\n`segments_processed` -- count","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.4":{"id":"2.4","summary":"Builds priced offers with TTL management and optional persistence adapter","className":"OfferBuilderAgent","input":"`operation` -- `'buildOffer' | 'getOffer' | 'validateOffer' | 'markUsed' | 'expireOffer' | 'cleanExpired'`\n`buildInput?` -- segments, fare, taxes, ancillaries, passenger count, pricing source, TTL\n`offerId?` -- for get/validate/mark/expire operations\n`currentTime?` -- ISO timestamp override","output":"`offer?` -- full offer record with pricing breakdown, TTL, status\n`valid?` -- offer validity result\n`reason?` -- validation failure reason\n`cleanedCount?` -- number of expired offers cleaned","usage":"new OfferBuilderAgent({ persistence?: PersistenceAdapter }) Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Builds, caches, validates, and manages pricing offers with TTL expiration. Supports in-memory or pluggable persistence."},"2.5":{"id":"2.5","summary":"Validates flight offers against corporate travel policies (cabin, budget, advance purchase)","className":"CorporatePolicyValidationAgent","input":"`offer` -- offer details (cabin, fare amount, carrier, fare basis, advance booking days, segments)\n`policy` -- corporate policy (cabin rules, fare rules, booking rules, bypass codes)\n`bypassCode?` -- authorization code to bypass soft violations","output":"`result` -- `'APPROVED' | 'SOFT_VIOLATION' | 'HARD_VIOLATION'`\n`violations` -- `PolicyViolation[]` with rule, severity, detail\n`bypassApplied` -- whether bypass was used","status":"Implemented","purpose":"Validates flight offers against corporate travel policies: cabin class limits, fare ceilings, blocked carriers, advance booking requirements. Supports bypass codes.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.6":{"id":"2.6","summary":"Placeholder -- not yet implemented. Requires revenue management integration","className":"DynamicPricingAgent","status":"Coming Soon (stub)","purpose":"Revenue management integration for dynamic fare adjustments. Requires revenue management integration before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"2.7":{"id":"2.7","summary":"Placeholder -- not yet implemented. Requires revenue management integration","className":"RevenueManagementAgent","status":"Coming Soon (stub)","purpose":"Revenue management system integration. Requires revenue management domain input before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"3.1":{"id":"3.1","summary":"Routes booking requests to the correct distribution channel based on carrier config, codeshare rules, and NDC capability","className":"GdsNdcRouter","input":"`segments` -- routing segments (marketing/operating carrier, origin, destination, flight number)\n`preferred_channel?` -- `'GDS' | 'NDC' | 'DIRECT'`\n`preferred_gds?` -- `'AMADEUS' | 'SABRE' | 'TRAVELPORT'`\n`include_fallbacks` -- whether to include fallback channels","output":"`routings` -- per-segment channel routing (primary channel, GDS system, NDC version, fallbacks, booking format)\n`unified_channel` -- whether all segments can use the same channel\n`recommended_channel` -- best channel for entire itinerary\n`gds_format` / `ndc_format` -- format translation stubs","status":"Implemented","purpose":"Routes booking requests to the correct distribution channel (GDS, NDC, or direct API) based on carrier config, codeshare rules, and NDC capability. Per-segment routing with fallback support.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.2":{"id":"3.2","summary":"Constructs GDS-ready PNR commands from normalized booking data. Supports Amadeus, Sabre, and Travelport syntax","className":"PnrBuilder","input":"`gds` -- `'AMADEUS' | 'SABRE' | 'TRAVELPORT'`\n`passengers` -- name, type, DOB, passport, gender, nationality, FOID\n`segments` -- carrier, flight, class, date, origin, destination, status\n`contacts` -- phone, email, type\n`ticketing` -- time limit, type\n`received_from` -- agent identifier\n`ssrs?` -- SSR elements (WCHR, VGML, DOCS, FOID, CTCE, CTCM, INFT)\n`osis?` -- OSI elements\n`is_group?` / `group_name?` -- group PNR support","output":"`gds` -- target GDS\n`commands` -- ordered `PnrCommand[]` with GDS command strings and descriptions\n`passenger_count`, `segment_count`, `is_group`, `infant_count`","status":"Implemented","purpose":"Constructs GDS-ready PNR commands from normalized booking data. Supports Amadeus, Sabre, and Travelport syntax including names, segments, contacts, ticketing, SSR/OSI elements, and group bookings.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.3":{"id":"3.3","summary":"Pre-ticketing validation -- 13 checks to catch errors before ADMs","className":"PnrValidation","input":"`record_locator` -- 6-char PNR\n`passengers` -- passenger data (name, type, DOB, nationality, passport)\n`segments` -- segment data (carrier, flight, status, class, international flag, married group)\n`contact?` -- phone/email\n`ticketing?` -- time limit, arranged status\n`fare?` -- fare data with advance purchase deadline\n`validation_date?` -- ISO date override","output":"`record_locator` -- PNR\n`checks` -- `ValidationCheck[]` (13 checks, each with pass/fail, severity, message)\n`valid` -- overall pass/fail\n`error_count`, `warning_count`","status":"Implemented","purpose":"Pre-ticketing validation with 13 checks to catch errors before ADMs: segment status, passenger data, APIS, ticketing deadline, fare consistency, and more.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.4":{"id":"3.4","summary":"GDS queue monitoring and processing -- priority assignment, categorization, action routing, and queue command generation","className":"QueueManagement","input":"`entries` -- queue items (record locator, GDS, queue number, entry type, deadline, remark)\n`current_time?` -- ISO timestamp for priority calculation\n`gds?` -- GDS system for command generation\n`queue_number?` -- queue to generate read commands for\n`travelport_host?` -- `'APOLLO' | 'GALILEO' | 'WORLDSPAN'` when `gds` is `TRAVELPORT`","output":"`results` -- processed items with priority, status, recommended action, target agent\n`commands?` -- GDS queue commands\n`summary` -- counts by priority (urgent/high/normal/low)","status":"Implemented","purpose":"GDS queue monitoring and processing: priority assignment, categorization, action routing, and queue command generation.\n\nTravelport place/list/remove commands are **per host** (Apollo / Galileo≡Travelport+ / Worldspan) from the public format-compare table — see `docs/knowledge-base/tmc-mid-office-ttl-queues.md`. TTL priority uses Zulu deadline-day urgency.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.5":{"id":"3.5","summary":"Universal HTTP client with circuit breaker, retry logic, timeout handling, rate limiting, and IATA error normalization","className":"ApiAbstraction","input":"`request` -- API request (provider ID, HTTP method, path, headers, body)\n`max_retries?` -- override retry count\n`timeout_ms?` -- override timeout\n`force?` -- skip circuit breaker check","output":"`response` -- API response (status, headers, body, duration, retries)\n`error` -- normalized error (category, original code, retryable flag)\n`circuit_breaker` -- circuit breaker status\n`rate_limit` -- rate limit status\n`success` -- boolean","usage":"new ApiAbstraction(handler?: RequestHandler) Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Universal HTTP client with circuit breaker, retry logic, timeout handling, rate limiting, and IATA error normalization for GDS/NDC/payment providers."},"3.6":{"id":"3.6","summary":"Travel order lifecycle management -- create, modify, cancel, retrieve, and list orders with status tracking and transition validation","className":"OrderManagement","input":"`operation` -- `'createOrder' | 'modifyOrder' | 'cancelOrder' | 'getOrder' | 'listOrders'`\n`createOrder?` -- passenger, items, currency, source\n`modifyOrder?` -- order ID, updated items/details, reason\n`cancelOrder?` -- order ID, reason\n`getOrder?` / `listOrders?` -- retrieval/filtering","output":"`order?` -- order record with status, items, history\n`orders?` -- list of orders\n`operation`, `success`, `errorCode?`, `errorMessage?`","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.7":{"id":"3.7","summary":"PCI-safe payment instruction builder and transaction recorder. Validates forms of payment, builds GDS FOP strings -- never handles raw card numbers","className":"PaymentProcessing","input":"`operation` -- `'validateFOP' | 'buildPaymentInstruction' | 'recordPayment' | 'getPaymentRecord' | 'buildGDSFOPString'`\nOperation-specific data: FOP details (CC_TOKEN, BSP_CASH, AIRLINE_CREDIT, VOUCHER, UATP), amounts, references","output":"`validation?` -- FOP validation result\n`instruction?` -- payment instruction with GDS string, PCI-safe flag\n`record?` -- payment transaction record\n`gdsString?` -- GDS FOP string","status":"Implemented","purpose":"PCI-safe payment instruction builder and transaction recorder. Validates forms of payment, builds GDS FOP strings, records transactions. Never handles raw card numbers.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.8":{"id":"3.8","summary":"Retrieves an existing PNR/booking by record locator across distribution adapters. Read-only -- no side effects","className":"PnrRetrieval","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"4.1":{"id":"4.1","summary":"ETR generation with conjunction ticket support, BSP reporting, and commission handling","className":"TicketIssuance","input":"`record_locator` -- 6-char PNR\n`issuing_carrier` -- 2-letter IATA code\n`passenger_name` -- LAST/FIRST format\n`segments` -- flight segments with carrier, flight number, class, fare basis, dates, baggage\n`base_fare`, `base_fare_currency` -- fare amount\n`equivalent_fare?`, `equivalent_fare_currency?` -- currency conversion\n`taxes` -- tax breakdown items\n`fare_calculation` -- fare calculation line\n`form_of_payment` -- CASH, CREDIT_CARD, INVOICE, MISCELLANEOUS\n`endorsements?`, `commission?`, `bsp_reporting?`, `original_issue?`","output":"`tickets` -- `TicketRecord[]` (13-digit number, coupons with status, fare/tax breakdown, FOP, commission, BSP fields)\n`total_coupons` -- total across all tickets\n`is_conjunction` -- whether conjunction tickets were generated","status":"Implemented","purpose":"ETR (Electronic Ticket Record) generation with conjunction ticket support (auto-split for >4 coupons), BSP reporting fields, and commission handling.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.2":{"id":"4.2","summary":"EMD-A (associated) and EMD-S (standalone) issuance, RFIC/RFISC handling, coupon lifecycle","className":"EmdManagement","input":"`emd_type` -- `'EMD-A' | 'EMD-S'`\n`record_locator`, `issuing_carrier`, `passenger_name`\n`services` -- array of services with RFIC code (A-G), RFISC, description, amount, associated ticket/coupon for EMD-A\n`related_ticket_number?` -- for EMD-A","output":"`emd` -- `EmdRecord` (13-digit EMD number, coupons, amounts)\n`coupon_count`","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.3":{"id":"4.3","summary":"Ticket/EMD void processing -- coupon status check, carrier void window, BSP/ARC cut-off validation","className":"VoidAgent","input":"`document_number` -- 13-digit ticket/EMD number\n`issuing_carrier` -- 2-letter IATA code\n`coupons` -- coupon numbers and current statuses\n`issue_datetime` -- ISO datetime of issuance\n`current_datetime?` -- ISO datetime for void window check\n`settlement_system?` -- `'BSP' | 'ARC'`\n`bsp_cutoff_time?` -- HH:MM format","output":"`result` -- void permitted flag, rejection reason, message, void window hours, hours remaining, updated coupon statuses","status":"Implemented","purpose":"Ticket/EMD void processing with coupon status validation, carrier-specific void window enforcement, and BSP/ARC cut-off time checking.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.4":{"id":"4.4","summary":"Multi-channel itinerary rendering: Email (HTML+plain), SMS, WhatsApp. Carrier-neutral templates","className":"ItineraryDelivery","input":"`record_locator` -- booking reference\n`passengers` -- name, ticket number, frequent flyer\n`flights` -- flight details (number, origin, destination, times, cabin, seat, aircraft)\n`total_fare?`, `fare_currency?`\n`contact` -- email, phone, WhatsApp number\n`channels` -- `('EMAIL' | 'SMS' | 'WHATSAPP')[]`\n`agency_name?` -- for itinerary header","output":"`rendered` -- per-channel content (HTML/plain text, subject, SMS segment count)\n`channels_rendered` -- successfully rendered channels","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.5":{"id":"4.5","summary":"APIS validation, passport validity, visa check (stub for Agent 0.7)","className":"DocumentVerification","input":"`passengers` -- ticket name, passport name, passport number/expiry/nationality, DOB, gender\n`segments` -- destination country and travel date\n`passport_validity_months?` -- minimum validity beyond travel date (default: 6)\n`validation_date?` -- ISO date override","output":"`results` -- per-passenger verification (pass/fail, individual checks with severity)\n`all_passed` -- overall pass/fail\n`blocking_failures`, `advisory_warnings` -- counts","status":"Implemented","purpose":"APIS validation, passport validity checking (configurable months threshold), and name matching between ticket and passport.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.1":{"id":"5.1","summary":"ATPCO Category 31 voluntary change assessment: change fees, fare difference, residual value, waiver codes","className":"ChangeManagement","input":"`original_ticket` -- ticket number, issuing carrier, passenger name, record locator, issue date, base fare, total tax, fare basis, refundable flag, booking date, `original_departure_date?` (for DOT 7-day check)\n`requested_itinerary` -- new segments (carrier, flight, origin, destination, date, class, fare basis), new fare, new taxes\n`waiver_code?` -- airline-provided waiver identity (not skip-penalty by itself)\n`waiver_effect?` -- required when `waiver_code` set: `ELIMINATE_PENALTY | REDUCE_PENALTY | CHANGE_REFUND_FORM | CHANGE_REBOOKING_CLASS | IRROP_INVOLUNTARY` (see `docs/knowledge-base/waiver-typology.md`)\n`waiver_penalty_reduction?` -- required for `REDUCE_PENALTY`\n`permitted_booking_classes?` / `permitted_fare_basis_patterns?` -- required for `CHANGE_REBOOKING_CLASS`\n`current_datetime?` -- ISO datetime\n`cat31_rules?` -- filed Cat 31 rules (omit → ATPCO default no charge)\n`us_dot_24h?` -- `part_259_applicable?`, `booking_channel?` (`airline_direct` | `agency` | `ndc` | `gds` | `unknown`)","output":"`assessment` -- action (`REISSUE | REBOOK | REJECT`), change fee, fare difference, additional collection, residual value, forfeited amount, tax difference, total due, Cat 31 `is_free_change` flag, summary\n`us_dot_24h` -- carrier remedy (`cancel` | `hold` | `unknown`), eligibility, ineligibility reasons (including `departure_within_7_days`, `channel_coverage_unknown`), entitlement (`penalty_free_cancel` | `unpaid_fare_hold` | `none` | `unknown`). **Not** a free-change boolean. Channel coverage follows carrier disclosure — not a baked-in “third-party never qualifies” rule.","status":"Implemented","purpose":"ATPCO Category 31 voluntary change assessment: change fees, fare difference, residual value, waiver codes, Cat 31 free-change window detection, and US DOT 14 CFR §259.5(b)(4) 24-hour reservation assessment (hold **or** cancel — carrier chooses; ≥7 days before departure). See `docs/knowledge-base/us-dot-24-hour-reservation.md`.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.2":{"id":"5.2","summary":"Ticket reissue with residual value, per-tax TFC carryforward (CARRY\\","className":"ExchangeReissue","input":"`original_ticket_number`, `conjunction_originals?`, `original_issue_date`\n`issuing_carrier`, `passenger_name`, `record_locator`\n`original_base_fare`, `original_taxes` -- from original ticket\n`change_fee`, `residual_value`, `waiver_code?` -- from Agent 5.1\n`new_segments` -- new flight segments\n`new_fare`, `new_fare_currency`, `new_taxes`, `fare_calculation`\n`form_of_payment` -- for additional collection\n`gds?` -- GDS for command generation\n`tax_carryforward_context` -- geography (`SAME_AIRPORT | SAME_CITY | DIFFERENT`), validity window flag, flown status, POS unchanged\n`tax_carryforward_rules` -- per-code rules covering every tax on original ∪ new (nature, min geography, YQ/YR flags, validity expiry action)\n`same_origin_destination?` -- **deprecated / ignored** for tax decisions (migration warning only)","output":"`reissue` -- new ticket record with full audit trail, exchange commands, `tax_decisions` on the audit trail\n`additional_collection` -- amount due\n`credit_amount` -- amount refundable if downgrade\n`tax_decisions` -- `{ tax_code, action: CARRY | RECALCULATE | FORFEIT, reason }[]`","status":"Implemented","purpose":"Ticket reissue with residual value application, **per-tax** carryforward (`CARRY | RECALCULATE | FORFEIT`), conjunction ticket handling, GDS exchange command generation, and full audit trail.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.3":{"id":"5.3","summary":"Carrier-initiated schedule change handling: trigger assessment, airline protection logic, regulatory entitlements (EU261, US DOT)","className":"InvoluntaryRebook","input":"`original_pnr` -- record locator, passenger, affected segment, issuing carrier, countries, checked-in flag, EU/Community carrier flag, optional endorsement\n`schedule_change` -- change type (incl. MISCONNECT), times, routing/equipment, misconnect shortfall\n`available_flights?` -- protection candidates with operating/marketing/alliance/interline + `endorsement_allows`\n`thresholds?` -- carrier-specific `time_change_minutes`, `measurement_point` (DEPARTURE|ARRIVAL), `misconnect_minutes` — required for those triggers\n`is_passenger_no_show?` -- no-show flag\n`is_oversale_denied_boarding?` -- only true for 14 CFR §250 oversales\n`eu261_inputs?` -- great-circle `distance_km` (Art.7(4)), delay/notice/rerouting/extraordinary, third-country benefits caveat","output":"`result` -- involuntary flag, trigger, ranked protection candidates (not executed), `art8_passenger_choice_required` + `art8_choices`, measurement point, regulatory flags (EU261/US DOT), original routing credit flag, summary","status":"Implemented","purpose":"Carrier-initiated schedule change / IRROP handling. Domain KB: `docs/knowledge-base/involuntary-rebook-irrop.md` (Regulation (EC) No 261/2004 — [CELEX:32004R0261](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32004R0261)).\n\n- **Triggers:** time change, routing change, equipment downgrade, cancellation, misconnect — with explicit dep vs arr measurement. **No hardcoded 60-minute threshold**; fail closed when carrier threshold input is missing.\n- **Reprotection candidates:** same operating → marketing → alliance → interline → other, with endorsement fail-closed. Alliance ≠ any alliance flight. **Do not silently \"same carrier first\"** — when EU261 applies, Art.8 passenger choice (refund vs re-route) is required before execution.\n- **EU261:** Art.3(1) matrix (EU depart any carrier / EU arrive Community carrier only). Art.7 compensation via great-circle bands only (never TPM). Art.8 choice surfaced on output.\n- **US DOT:** 14 CFR §250 IDB is oversale-specific — delays/cancels report `applies: false`.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.4":{"id":"5.4","summary":"Placeholder -- not yet implemented. Requires domain input on disruption priority rules","className":"DisruptionResponseAgent","status":"Coming Soon (stub)","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"5.5":{"id":"5.5","summary":"Placeholder -- not yet implemented. Requires domain input on change fee structures","className":"SelfServiceRebookingAgent","status":"Implemented","purpose":"Orchestrates Availability Search (1.1) and Change Management (5.1) to present priced rebooking alternatives (changeFee + fareDifference + taxDifference per option). Read-only -- does NOT execute the reissue; that is Exchange/Reissue (5.2). Involuntary reasons (schedule change / missed connection / cancellation) waive the change fee; voluntary changes honor ATPCO Cat 31 via 5.1.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"5.6":{"id":"5.6","summary":"Placeholder -- not yet implemented. Requires domain input on waitlist priority scoring","className":"WaitlistManagementAgent","status":"Implemented","purpose":"Stateful in-memory passenger waitlist queue with four operations: addEntry (priority computed at add time), clear (given N seats opened, remove top-N by priority), queryStatus (1-based position + estimated clearance probability), and expire (prune entries past their cutoff). State is in-memory only -- production deployments should pair it with a durable persistence layer.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"6.1":{"id":"6.1","summary":"ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting, conjunction ticket handling","className":"RefundProcessing","input":"`ticket_number`, `conjunction_tickets?`\n`issuing_carrier`, `passenger_name`, `record_locator`\n`base_fare`, `base_fare_currency`, `taxes`, `commission?`\n`refund_type` -- `'FULL' | 'PARTIAL' | 'TAX_ONLY'`\n`coupons_to_refund?` -- specific coupons (for partial)\n`total_coupons`, `waiver_code?`, `waiver_effect?` (required with code), `fare_basis`, `is_refundable`\n`waiver_penalty_reduction?`, `waiver_refund_form?` -- companions per typology in `docs/knowledge-base/waiver-typology.md`\n`settlement_system` -- `'BSP' | 'ARC'`","output":"`refund` -- penalty applied, base fare refund, tax refund, tax breakdown, commission recalled, net refund, BSP/ARC reporting fields, audit trail\n`net_refund_amount`, `commission_recalled`","status":"Implemented","purpose":"ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting fields, conjunction ticket handling. Supports full, partial, and tax-only refunds.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.2":{"id":"6.2","summary":"Pre-ticketing audit: 9 checks covering fare integrity, segment validity, and compliance to prevent Agency Debit Memos","className":"ADMPrevention","input":"`booking` -- record locator, passenger name, segments (with status, class, married group), base fare\n`fare_basis`, `booked_class`\n`commission_rate?`, `carrier_contracted_rate?`\n`endorsement?`, `tour_code?`\n`is_net_remit?`, `net_contracted_amount?`\n`ttl_deadline?`, `duplicate_check_pnrs?`, `current_datetime?`","output":"`result` -- all check results, overall pass/fail, blocking/warning counts","status":"Implemented","purpose":"Pre-ticketing audit with 9 checks: duplicate booking, fare/class mismatch, passive segment, married segment integrity, TTL expiry, commission rate, endorsement box, tour code format, net remit validation.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.3":{"id":"6.3","summary":"Agency Debit Memo receipt, assessment, dispute, and Agency Credit Memo application workflows","className":"ADMACMProcessingAgent","input":"`operation` -- `'receiveADM' | 'receiveACM' | 'assessADM' | 'disputeADM' | 'acceptADM' | 'escalateADM' | 'applyACM' | 'getADM' | 'getPendingWithDeadlines'`\nOperation-specific fields: ticket number, airline, amount, reason code, dispute ground/evidence, ADM/ACM IDs","output":"`adm?` -- ADM record with status history\n`acm?` -- ACM record\n`assessment?` -- days remaining, window expired, recommended action\n`disputeResult?` -- dispute outcome\n`pendingDeadlines?` -- urgent ADMs approaching deadline","status":"Implemented","purpose":"Agency Debit Memo receipt, assessment, dispute, and Agency Credit Memo application workflows. Tracks dispute deadlines (15-day window), supports dispute grounds, and manages status transitions.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.4":{"id":"6.4","summary":"Multi-channel customer notification generation for flight disruptions, refunds, and operational changes. 8 notification types x 4 channels","className":"CustomerCommunication","input":"`operation` -- `'generateNotification' | 'generateBatch' | 'getTemplate'`\n`notificationType?` -- notification type\n`channel?` -- delivery channel\n`variables?` -- template variables (passenger name, flight info, amounts, etc.)\n`batchRequests?` -- for batch generation","output":"`notification?` -- generated notification with body, subject, SMS segments, used/missing variables\n`notifications?` -- batch results\n`template?` -- template info with required variables","status":"Implemented","purpose":"Multi-channel customer notification generation. 8 notification types (flight cancelled, delayed, gate change, rebooking confirmed, refund processed, schedule change, waitlist cleared, ADM received) x 4 channels (Email HTML, Email text, SMS, WhatsApp).","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.5":{"id":"6.5","summary":"Complaint submission, EU261/US DOT compensation calculation, case management, and regulatory DOT record generation","className":"FeedbackComplaintAgent","input":"`operation` -- `'submitComplaint' | 'updateStatus' | 'getCase' | 'listCases' | 'calculateCompensation' | 'generateDOTRecord'`\nComplaint fields: type, passenger, booking reference, airline, flight, description\nCompensation fields: regulation, distance, delay, alternative offered, fare paid, cabin class\nCase management: case ID, status transitions","output":"`complaintCase?` -- full case record with status history, compensation result\n`cases?` -- filtered case list\n`compensation?` -- EU261/US DOT calculation (eligibility, base/final amount, reduction, notes)\n`dotRecord?` -- DOT regulatory record","status":"Implemented","purpose":"Complaint submission, EU261/US DOT compensation calculation, case management with status tracking, and DOT regulatory record generation.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.6":{"id":"6.6","summary":"Mileage accrual calculation, redemption eligibility, status benefits, and alliance status matching","className":"LoyaltyMileageAgent","input":"`operation` -- `'calculateAccrual' | 'checkRedemptionEligibility' | 'getStatusBenefits' | 'matchStatus'`\nAccrual: operating/crediting carrier, booking class, distance, loyalty status\nRedemption: distance, cabin, partner flag, current balance\nBenefits: airline, status tier\nMatch: source/target airline, source status","output":"`accrual?` -- base miles, bonus miles, total, earn rate, partner flag\n`redemption?` -- eligibility, miles required, remaining balance\n`statusBenefits?` -- benefit list by tier\n`statusMatch?` -- matched status at target airline","status":"Implemented","purpose":"Mileage accrual calculation, redemption eligibility checking, status benefits lookup, and cross-airline status matching.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.1":{"id":"7.1","summary":"Matches agency booking records against BSP HOT files, validates commission, identifies discrepancies, flags issues before remittance deadline","className":"BSPReconciliation","input":"`hot_records` -- BSP HOT file records (ticket number, passenger, origin/destination, airline, amounts, commission, transaction type, billing period)\n`agency_records` -- agency-side booking records for comparison","output":"Matched records, unmatched records, discrepancies with severity and type, commission validation results","status":"Implemented","purpose":"Matches agency booking records against BSP HOT files, validates commission rates, identifies discrepancies (missing records, duplicates, amount/commission/currency mismatches, unmatched ADM/ACM), and flags issues before remittance deadline.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.2":{"id":"7.2","summary":"Processes ARC IAR weekly billing, validates commission rates against airline contracts, flags pricing/commission errors","className":"ARCReconciliation","input":"`iar_records` -- ARC IAR records (document number, amounts, commission, transaction type, settlement week, ADM issue dates)\n`agency_records` -- agency-side records for comparison","output":"Matched/unmatched records, discrepancies with severity, ADM dispute window warnings","status":"Implemented","purpose":"Processes ARC IAR (Interactive Agent Reporting) weekly billing, validates commission rates against airline contracts, flags pricing/commission errors, and manages ADM/ACM disputes within the 15-day window.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.3":{"id":"7.3","summary":"Commission agreement management, rate validation, incentive calculation","className":"CommissionManagementAgent","input":"`operation` -- `'registerAgreement' | 'getRate' | 'validateCommission' | 'calculateIncentive' | 'listAgreements'`\nAgreement data: agent ID, airline, type, rate, basis (percent/flat per ticket/segment), fare basis patterns, validity dates, minimum tickets\nValidation: claimed rate vs expected rate\nIncentive: period, ticket count, total fare","output":"`agreement?` -- registered agreement\n`rate?` -- applicable commission rate\n`validation?` -- match/overstated/understated status with variance\n`incentive?` -- earned incentive amount, threshold met flag","status":"Implemented","purpose":"Commission agreement management: register agreements (override, incentive, backend, net fare, standard), look up rates by airline/fare basis, validate claimed commission, and calculate incentive earnings.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.4":{"id":"7.4","summary":"Placeholder -- not yet implemented. Requires domain input on interline prorate methodology","className":"InterlineSettlementAgent","status":"Coming Soon (stub)","purpose":"Requires domain input on interline prorate methodology and SIS (Simplified Interline Settlement) billing rules before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"7.5":{"id":"7.5","summary":"Aggregates transaction data into reports (revenue by route, margin analysis, unused tickets, etc.)","className":"FinancialReportingAgent","input":"`type` -- report type (9 report types available)\n`period` -- date range\n`filters?` -- airlines, agents, corporate IDs, currencies, minimum amount\n`groupBy?` -- grouping dimensions\n`records` -- financial records (ticket, refund, ADM, ACM, commission, fee)\n`currency?` -- reporting currency","output":"Report line items with revenue, cost, commission, net per group\nReport totals","status":"Implemented","purpose":"Generates financial reports: revenue by route/agent/corporate client, margin analysis, cost tracking, commission summary, spend by supplier, unused ticket value, and settlement summary.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.6":{"id":"7.6","summary":"Coupon lift recording, revenue recognition, uplift/deferred revenue reporting","className":"RevenueAccountingAgent","input":"`operation` -- `'recordLift' | 'recognizeRevenue' | 'getUpliftReport' | 'getDeferredRevenue' | 'recordVoid' | 'recordRefund'`\nLift data: ticket number, coupon number, flight details, fare amount\nReport parameters: date range","output":"Lift records, revenue recognition results, uplift reports (by route/cabin with average yield), deferred revenue reports","status":"Implemented","purpose":"Coupon lift tracking and revenue recognition: record lifted coupons, recognize revenue per flight, generate uplift reports (by route, by cabin), track deferred revenue from open coupons, and handle voids/refunds.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.1":{"id":"8.1","summary":"Stores/retrieves traveler preferences, documents, loyalty programs. Applies profiles to PNRs via SSR injection","className":"TravelerProfileAgent","input":"`operation` -- `'get' | 'create' | 'update' | 'apply_to_pnr' | 'search'`\nProfile data: name, DOB, nationality, passport, loyalty numbers, seat/meal preference, contact info, corporate/employee ID, department, cost center\nPNR application: GDS system, segments for APIS generation","output":"`profile?` -- traveler profile record\n`profiles?` -- search results\nPNR application: generated SSR/OSI commands","status":"Implemented","purpose":"Traveler preferences, identity documents, loyalty programs, and PNR prefill. CRUD operations plus apply-to-PNR for generating SSR/APIS commands.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.2":{"id":"8.2","summary":"Corporate travel policy enforcement, negotiated fares, booking validation","className":"CorporateAccountAgent","input":"`operation` -- `'get_account' | 'create_account' | 'update_account' | 'validate_booking' | 'get_policy' | 'list_accounts' | 'get_preferred_suppliers'`\nAccount data: company name, IATA number, travel policy, negotiated fares, contact info\nBooking validation: segments, cabin, fare amount, advance days","output":"`account?` -- corporate account record\n`accounts?` -- account list\n`validation?` -- policy violations (hard/soft) with details\n`policy?` -- travel policy rules\n`suppliers?` -- preferred suppliers","status":"Implemented","purpose":"Corporate travel policy management, negotiated fare lookup, and booking validation against policy rules (cabin limits, fare ceilings, advance booking, preferred/blacklisted airlines).","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.3":{"id":"8.3","summary":"PNR quality checks, ticketing deadline monitoring, duplicate/passive detection","className":"MidOfficeAgent","input":"`trigger` -- `'scheduled_sweep' | 'pnr_created' | 'ticket_deadline_approaching' | 'queue_pending' | 'manual_review_request'`\n`pnrs` -- PNR records with segments, deadlines, APIS/contact/FOP flags\n`current_datetime?` -- ISO timestamp (compared as Zulu)","output":"Per-PNR issues with severity (urgent/high/medium/low) and issue codes\nSummary counts","status":"Implemented","purpose":"PNR quality checks and ticketing deadline monitoring. Scans PNRs for 10 issue types: TTL urgent/approaching, missing segment status, missing APIS, missing contact/FOP, duplicate PNR, passive segment, policy violation, married segment incomplete.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.4":{"id":"8.4","summary":"Aggregates transaction data into reports (booking volume, revenue, top routes, policy compliance)","className":"ReportingAgent","input":"`report_type` -- report type\n`date_from`, `date_to` -- date range\n`filters?` -- corporate ID, agent, airline, department, currency\n`transactions` -- transaction records (ticket, amounts, airline, dates, in-policy flag, used flag)","output":"Report rows grouped by the relevant dimension\nSummary totals","status":"Implemented","purpose":"Transaction aggregation and report generation across 9 report types: booking volume, revenue summary, top routes, agent productivity, policy compliance, spend by traveler/department/supplier, unused tickets.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.5":{"id":"8.5","summary":"Locates travelers in active itineraries during disruptions with destination risk assessment","className":"DutyCareAgent","input":"`operation` -- `'locate_travelers' | 'get_traveler_itinerary' | 'assess_destination_risk' | 'mark_accounted_for'`\nItineraries: traveler ID, segments with dates/times/status\nRisk: country code\nAccountability: traveler ID","output":"`locatedTravelers?` -- current location, status (IN_TRANSIT/AT_DESTINATION/DEPARTED/UNKNOWN), accounted-for flag\n`itinerary?` -- full traveler itinerary\n`risk?` -- country risk level (low/medium/high/critical) with notes","status":"Implemented","purpose":"Traveler location tracking, destination risk assessment, and accountability management for corporate duty-of-care obligations.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.1":{"id":"9.1","summary":"Coordinates multi-agent workflows as a single callable pipeline (search_to_price, book_to_ticket, full_booking, etc.)","className":"OrchestratorAgent","input":"`workflow` -- workflow name\n`input` -- workflow input data\n`options?` -- `stop_on_error?`, `timeout_ms?`","output":"`workflow` -- workflow name\n`status` -- `'completed' | 'failed' | 'partial'`\n`steps` -- per-step results (agent ID, status, duration, output/error)\n`total_duration_ms`\n`final_output?` -- last step output","usage":"Accepts injectable `StepExecutor` for testing without real agent imports. Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Multi-agent workflow coordination. Defines named workflows (search-to-price, book-to-ticket, full booking, exchange flow, refund flow) as step sequences. Supports conditional steps, parallel execution, error handling (stop/skip/continue), and pipeline building."},"9.2":{"id":"9.2","summary":"RAG over travel knowledge base with BM25 relevance scoring and optional hybrid scoring via injectable EmbeddingProvider","className":"KnowledgeAgent","input":"`operation` -- `'query' | 'index_document' | 'list_topics' | 'get_document'`\nQuery: query string, topic filter, max results\nIndex: document ID, title, content, tags, topic","output":"`results?` -- ranked results with relevance score, excerpt, full content\n`document?` -- specific document\n`topics?` -- available topic list\n`query_time_ms?`","status":"Implemented","purpose":"RAG (Retrieval-Augmented Generation) over the travel knowledge base. Indexes documents by topic, supports BM25 + vector hybrid search with injectable embedding provider.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.3":{"id":"9.3","summary":"Tracks agent health, API latency, error rates, SLA compliance","className":"MonitoringAgent","input":"`operation` -- `'record_metric' | 'get_health' | 'list_alerts' | 'acknowledge_alert' | 'get_sla_report'`\nMetric: agent ID, metric type (latency_ms/error/success/timeout), value\nAlert: alert ID for acknowledgment","output":"`health?` -- agent health (status, p50/p95 latency, error rate, total calls)\n`alerts?` -- alert list with severity and fired timestamp\n`slaReport?` -- availability percent, p95 latency, error count","status":"Implemented","purpose":"Agent health monitoring: latency tracking (p50/p95), error rates, SLA compliance reporting. Records metrics, fires alerts on threshold violations, supports alert acknowledgment.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.4":{"id":"9.4","summary":"Audit trail, PII redaction, GDPR/PCI/IATA compliance","className":"AuditAgent","input":"`operation` -- `'log_event' | 'query_audit_log' | 'flag_compliance_issue' | 'get_compliance_report' | 'redact_pii'`\nEvent: type (agent_decision, data_access, booking_created, etc.), agent ID, user/session ID, payload\nCompliance: issue type, description, severity, affected records","output":"`entry?` -- audit log entry with hash, PII redaction flag, retention days\n`entries?` -- query results\n`issue?` -- flagged compliance issue\n`report?` -- compliance report (events with PII, redaction counts, open issues by severity)\n`redactedPayload?` -- PII-redacted data","status":"Implemented","purpose":"Audit trail logging with SHA-256 payload hashing, PII redaction (credit cards, passports, emails, phone numbers, DOB), GDPR/PCI/IATA compliance issue flagging, and compliance reporting.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.5":{"id":"9.5","summary":"Manages third-party agent extensions and capability discovery","className":"PluginManagerAgent","input":"`operation` -- `'register_plugin' | 'unregister_plugin' | 'list_plugins' | 'get_plugin' | 'discover_capabilities' | 'enable_plugin' | 'disable_plugin'`\nPlugin data: name, version, description, author, capabilities, agent IDs, metadata","output":"`plugin?` -- plugin record\n`plugins?` -- plugin list\n`capabilities?` -- capability-to-plugin mapping\n`message?` -- operation result message","status":"Implemented","purpose":"Third-party agent extension management: register/unregister plugins, enable/disable, capability discovery, and plugin metadata management.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.6":{"id":"9.6","summary":"Aggregates agent execution metrics from the EventStore within a given time window. Identifies degraded agents","className":"PerformanceAuditAgent","status":"Implemented","purpose":"Aggregates agent execution metrics from the EventStore within a given time window and identifies degraded agents. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"9.7":{"id":"9.7","summary":"Analyses routing decisions and outcomes from the EventStore within a given time window","className":"RoutingAuditAgent","status":"Implemented","purpose":"Analyses routing decisions and outcomes from the EventStore within a given time window. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"9.8":{"id":"9.8","summary":"Accepts performance and routing audit reports and produces deterministic recommendations","className":"RecommendationAgent","status":"Implemented","purpose":"Accepts performance and routing audit reports and produces deterministic recommendations. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"9.9":{"id":"9.9","summary":"Queries EventStore events, computes metrics against configurable thresholds, and produces alerts","className":"AlertAgent","status":"Implemented","purpose":"Queries EventStore events, computes metrics against configurable thresholds, and produces alerts. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"20.1":{"id":"20.1","summary":"Multi-source hotel availability search across GDS hotel segments, direct APIs, and channel manager feeds","className":"HotelSearchAggregatorAgent","input":"`destination` -- city name, airport code, or coordinates\n`checkIn` -- ISO date string (YYYY-MM-DD)\n`checkOut` -- ISO date string (YYYY-MM-DD)\n`rooms` -- number of rooms needed\n`adults` -- number of adult guests per room\n`children?` -- number of child guests per room\n`starRating?` -- minimum star rating filter\n`maxRatePerNight?` -- maximum nightly rate filter (decimal string)\n`currency?` -- ISO 4217 currency for rate filtering/display\n`rateType?` -- rate type filter\n`chainPreference?` -- chain code (e.g., `\"MC\"` for Marriott)\n`timeoutMs?` -- per-adapter timeout in milliseconds (default: 5000)\n`adapterIds?` -- specific adapter IDs to query (all if omitted)","output":"`properties` -- raw hotel results from all sources (NOT deduplicated)\n`totalResults` -- total result count across all adapters\n`adapterResults` -- per-adapter summary (ID, name, count, response time, timeout/error)\n`partialResults` -- true if some adapters timed out or errored\n`searchId` -- unique search ID for tracing","usage":"const agent = new HotelSearchAggregatorAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    destination: 'New York',\n    checkIn: '2026-06-01',\n    checkOut: '2026-06-03',\n    rooms: 1,\n    adults: 2,\n  },\n});\n// result.data.totalResults => 45\n// result.data.partialResults => false","status":"Implemented","purpose":"Multi-source hotel availability search across GDS hotel segments, direct APIs (Amadeus Hotel, Hotelbeds, Duffel Stays), and channel manager feeds. Returns raw, unmerged results from all connected sources. Supports injectable `HotelSourceAdapter` for plugging in custom sources."},"20.2":{"id":"20.2","summary":"Identifies duplicate properties from multi-source results and merges them into canonical records","className":"PropertyDeduplicationAgent","input":"`properties` -- raw hotel results from Agent 20.1\n`thresholds?` -- custom merge thresholds\n`autoMerge` -- score above which properties are auto-merged (default: 0.85)\n`review` -- score above which properties are flagged for review (default: 0.65)","output":"`canonical` -- canonical property records (one per physical property)\n`mergeLog` -- full audit trail of merge/separate decisions (property IDs, score, decision type, score breakdown)\n`stats` -- summary (input count, output count, auto-merged, review-flagged, separated)","usage":"const agent = new PropertyDeduplicationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { properties: rawResults },\n});\n// result.data.stats.inputCount => 45\n// result.data.stats.outputCount => 28\n// result.data.stats.autoMerged => 12","status":"Implemented","purpose":"Takes raw multi-source hotel results from Agent 20.1 and identifies duplicate properties (40-60% of multi-source results are duplicates). Merges them into canonical property records using weighted scoring: Jaro-Winkler name similarity (0.3), normalized address Levenshtein (0.2), Haversine coordinate proximity (0.25), chain code match (0.15), and star rating match (0.1)."},"20.3":{"id":"20.3","summary":"Standardizes hotel content (room types, amenity names, descriptions, photos) into a consistent OTAIP taxonomy","className":"ContentNormalizationAgent","input":"`properties` -- canonical property records from Agent 20.2","output":"`properties` -- normalized property content records, each containing:\n`canonicalId` -- pass-through from 20.2\n`property` -- original canonical property\n`normalizedRoomTypes` -- room types mapped to OTAIP taxonomy\n`normalizedAmenities` -- amenities mapped to OTAIP taxonomy\n`scoredPhotos` -- scored and categorized photos (category, quality score, primary flag)\n`unmappedRoomTypes` -- raw room types that could not be normalized\n`unmappedAmenities` -- raw amenity strings that could not be normalized\n`stats` -- totals for properties, mapped/unmapped room types, mapped/unmapped amenities","usage":"const agent = new ContentNormalizationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { properties: canonicalProperties },\n});\n// result.data.stats.totalRoomTypesMapped => 84\n// result.data.stats.totalAmenitiesUnmapped => 3","status":"Implemented","purpose":"Standardizes hotel content (room types, amenity names, photos) into a consistent OTAIP taxonomy for comparison and display. Maps raw room types from each source to the normalized taxonomy, merges amenities via union merge, and scores/categorizes photos."},"20.4":{"id":"20.4","summary":"Compares rates for the same canonical property across all sources, identifies best available rate, detects rate parity violations","className":"RateComparisonAgent","input":"`properties` -- canonical properties with source results containing rates\n`currency?` -- preferred currency for display (default: USD)\n`nights?` -- number of nights for the stay (default: 1)","output":"`comparisons` -- per-property rate comparison, each containing:\n`canonicalId` -- canonical property ID\n`propertyName` -- property name\n`rates` -- all rates sorted by total cost (lowest first), with full cost breakdown (room charges, mandatory fees, taxes, grand total)\n`bestByRateType` -- best rate per rate type\n`parity` -- rate parity analysis (at parity flag, lowest/highest source, spread percentage)\n`totalProperties` -- total properties compared\n`parityViolations` -- count of properties with rate parity violations","usage":"const agent = new RateComparisonAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { properties: canonicalProperties, nights: 2 },\n});\n// result.data.comparisons[0].rates[0].totalCost.grandTotal => { amount: '289.00', currency: 'USD' }\n// result.data.parityViolations => 3","status":"Implemented","purpose":"Compares rates for the same canonical property across all sources, identifies best available rate per rate type, and detects rate parity violations (>2% spread between lowest and highest source). Includes ALL mandatory fees (resort fees, destination fees, taxes) in total cost breakdown."},"20.5":{"id":"20.5","summary":"Executes hotel bookings with three-layer confirmation code system (CRS, PMS, Channel)","className":"HotelBookingAgent","input":"`operation` -- `'book' | 'verify_rate' | 'get_booking'`\n`bookingRequest?` -- required for `book`/`verify_rate`:\n`canonicalPropertyId` -- from Agent 20.2\n`rateId` -- from Agent 20.4\n`source` -- hotel source to book through\n`checkIn` / `checkOut` -- ISO date strings\n`rooms` -- number of rooms\n`guest` -- guest details (name, email, phone, loyalty info)\n`paymentModel` -- payment model\n`specialRequests?` -- free text\n`bookingId?` -- required for `get_booking`","output":"`success` -- whether the operation succeeded\n`booking?` -- booking record (ID, three-layer confirmation codes, status, total charged, payment model, virtual card info, cancellation policy/deadline, guest, original request)\n`error?` -- error message if failed\n`rateChanged?` -- whether rate changed between search and booking\n`newRate?` -- new rate if changed","usage":"const agent = new HotelBookingAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    operation: 'book',\n    bookingRequest: {\n      canonicalPropertyId: 'canon-001',\n      rateId: 'rate-001',\n      source: 'amadeus_hotel',\n      checkIn: '2026-06-01',\n      checkOut: '2026-06-03',\n      rooms: 1,\n      guest: { firstName: 'John', lastName: 'Smith', email: 'john@example.com' },\n      paymentModel: 'merchant',\n    },\n  },\n});\n// result.data.booking?.confirmation.crs => \"CRS-ABC123\"","status":"Implemented","purpose":"Executes hotel bookings through the optimal source. Manages the full booking flow from rate verification through confirmation, including three-layer confirmation codes (CRS, PMS, channel). Supports VCN (Virtual Card Number) payment with dual folio requirements."},"20.6":{"id":"20.6","summary":"Post-booking changes: free modifications, date changes (cancel/rebook), cancellations with penalty calculation, no-show processing","className":"HotelModificationAgent","input":"`operation` -- `'modify' | 'cancel' | 'check_penalty' | 'process_no_show'`\n`bookingId` -- existing booking ID\n`modifications?` -- free modifications (guest name, bed type, smoking preference, special requests, accessibility needs, guest count)\n`dateChange?` -- new check-in / check-out dates (triggers cancel/rebook)\n`bookedAt?` -- booking timestamp for California 24hr rule check\n`cancellationPolicy?` -- current cancellation policy\n`checkInDate?` -- for deadline calculations\n`nightlyRate?` -- nightly rate from booking record (penalty base)","output":"`success` -- whether the operation succeeded\n`classification` -- `'free_modification' | 'cancel_rebook_required' | 'not_modifiable'`\n`isFreeMod` -- whether this is a free modification\n`penalty?` -- penalty calculation (amount, type, deadline, free window flag, California rule flag)\n`rebookRequired` -- whether a rebook is needed (for date changes)\n`newBookingId?` -- updated confirmation codes (for successful modifications)\n`message` -- error or status message","usage":"const agent = new HotelModificationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    operation: 'cancel',\n    bookingId: 'BK-001',\n    cancellationPolicy: { type: 'free_cancellation', deadline: '2026-05-30T00:00:00Z' },\n    checkInDate: '2026-06-01',\n    bookedAt: '2026-04-01T10:00:00Z',\n  },\n});\n// result.data.classification => \"free_modification\"\n// result.data.penalty?.isWithinFreeWindow => true","status":"Implemented","purpose":"Handles post-booking changes: free modifications (guest name, bed type, special requests), date changes (which require cancel/rebook -- NOT modifications), cancellations with penalty calculation, and no-show processing. Enforces California 24-hour cancellation rule where applicable."},"20.7":{"id":"20.7","summary":"Cross-checks CRS-to-PMS booking data to detect discrepancies before guest arrival","className":"ConfirmationVerificationAgent","input":"`operation` -- `'verify' | 'check_pms_sync' | 'batch_verify'`\n`bookingId` -- booking ID to verify\n`confirmation` -- three-layer confirmation codes from booking\n`crsData` -- CRS-side booking data (confirmation code, guest name, dates, room type, rates, status)\n`pmsData?` -- PMS-side booking data (may be missing if PMS hasn't synced yet)\n`guest` -- guest details for name verification\n`hoursUntilCheckin?` -- hours until check-in (for escalation urgency)\n`batchBookingIds?` -- additional booking IDs (for `batch_verify`)","output":"`verified` -- whether verification passed with no critical issues\n`discrepancies` -- all detected discrepancies (field, CRS value, PMS value, severity, message)\n`escalationRequired` -- whether human/agent escalation is needed\n`escalationReasons` -- why escalation is needed (pms_code_missing, rate_mismatch, date_mismatch, guest_name_mismatch, waitlist_status, tentative_status, room_type_mismatch, multiple_discrepancies)\n`verifiedAt` -- verification timestamp\n`message` -- summary message","usage":"const agent = new ConfirmationVerificationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    operation: 'verify',\n    bookingId: 'BK-001',\n    confirmation: { crs: 'CRS-ABC', pms: 'PMS-123', channel: 'CH-456' },\n    crsData: {\n      confirmationCode: 'CRS-ABC',\n      guestName: 'SMITH/JOHN',\n      checkIn: '2026-06-01',\n      checkOut: '2026-06-03',\n      roomType: 'King Standard',\n      nightlyRate: { amount: '189.00', currency: 'USD' },\n      totalRate: { amount: '378.00', currency: 'USD' },\n      status: 'confirmed',\n    },\n    guest: { firstName: 'John', lastName: 'Smith' },\n  },\n});\n// result.data.verified => true\n// result.data.discrepancies.length => 0","status":"Implemented","purpose":"Cross-checks CRS and PMS booking data to detect discrepancies before guest arrival. Escalates missing PMS codes, waitlist/tentative status, rate/date mismatches. PMS sync can take 1-4 hours; delays beyond 24 hours trigger escalation."},"20.8":{"id":"20.8","summary":"Thin typed wrapper around Hotelbeds Activities search for route→fill orchestration and product-layer activity_search mapping.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"20.9":{"id":"20.9","summary":"Thin typed wrapper around Hotelbeds Transfers search for route→fill orchestration.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."}}}</script>
+  <script id="graph-data" type="application/json">{"graph":{"generated_by":"scripts/generate-manifest.ts","total_nodes":77,"total_edges":27,"nodes":[{"id":"0.1","name":"Airport/City Code Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/airport-code-resolver/index.ts"},{"id":"0.2","name":"Airline Code & Alliance Mapper","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/airline-code-mapper/index.ts"},{"id":"0.3","name":"Fare Basis Code Decoder","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/fare-basis-decoder/index.ts"},{"id":"0.4","name":"Class of Service Mapper","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/class-of-service-mapper/index.ts"},{"id":"0.5","name":"Equipment Type Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/equipment-type-resolver/index.ts"},{"id":"0.6","name":"Currency & Tax Code Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/currency-tax-resolver/index.ts"},{"id":"0.7","name":"Country Regulatory Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/country-regulatory-resolver/index.ts"},{"id":"1.1","name":"Availability Search","stage":"search","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/availability-search/index.ts"},{"id":"1.2","name":"Schedule Lookup","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/schedule-lookup/index.ts"},{"id":"1.3","name":"Connection Builder","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/connection-builder/index.ts"},{"id":"1.4","name":"Fare Shopping","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/fare-shopping/index.ts"},{"id":"1.5","name":"Ancillary Shopping","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/ancillary-shopping/index.ts"},{"id":"1.6","name":"Multi-Source Aggregator","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/multi-source-aggregator/index.ts"},{"id":"1.7","name":"Hotel & Car Search","stage":"search","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/hotel-car-search/index.ts"},{"id":"1.8","name":"AI Travel Advisor","stage":"search","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/ai-travel-advisor/index.ts"},{"id":"1.9","name":"Offer Evaluator","stage":"core","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/core/src/agents/shopping/offer-evaluator/index.ts"},{"id":"2.1","name":"Fare Rule Agent","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/pricing/src/fare-rule-agent/index.ts"},{"id":"2.2","name":"Fare Construction","stage":"pricing","version":"0.2.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/fare-construction/index.ts"},{"id":"2.3","name":"Tax Calculation","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/tax-calculation/index.ts"},{"id":"2.4","name":"Offer Builder","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/pricing/src/offer-builder/index.ts"},{"id":"2.5","name":"Corporate Policy Validation","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/corporate-policy-validation/index.ts"},{"id":"2.6","name":"Dynamic Pricing","stage":"pricing","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/pricing/src/dynamic-pricing/index.ts"},{"id":"2.7","name":"Revenue Management","stage":"pricing","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/pricing/src/revenue-management/index.ts"},{"id":"3.1","name":"GDS/NDC Router","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/gds-ndc-router/index.ts"},{"id":"3.2","name":"PNR Builder","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/pnr-builder/index.ts"},{"id":"3.3","name":"PNR Validation","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/pnr-validation/index.ts"},{"id":"3.4","name":"Queue Management","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/queue-management/index.ts"},{"id":"3.5","name":"API Abstraction","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/api-abstraction/index.ts"},{"id":"3.6","name":"Order Management","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/order-management/index.ts"},{"id":"3.7","name":"Payment Processing","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/payment-processing/index.ts"},{"id":"3.8","name":"PNR Retrieval","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/pnr-retrieval/index.ts"},{"id":"4.1","name":"Ticket Issuance","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/ticketing/src/ticket-issuance/index.ts"},{"id":"4.2","name":"EMD Management","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/emd-management/index.ts"},{"id":"4.3","name":"Void Agent","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/void-agent/index.ts"},{"id":"4.4","name":"Itinerary Delivery","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/itinerary-delivery/index.ts"},{"id":"4.5","name":"Document Verification","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/document-verification/index.ts"},{"id":"5.1","name":"Change Management","stage":"exchange","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/change-management/index.ts"},{"id":"5.2","name":"Exchange/Reissue","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/exchange-reissue/index.ts"},{"id":"5.3","name":"Involuntary Rebook","stage":"exchange","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/involuntary-rebook/index.ts"},{"id":"5.4","name":"Disruption Response","stage":"exchange","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/exchange/src/disruption-response/index.ts"},{"id":"5.5","name":"Self-Service Rebooking","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/exchange/src/self-service-rebooking/index.ts"},{"id":"5.6","name":"Waitlist Management","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/exchange/src/waitlist-management/index.ts"},{"id":"6.1","name":"Refund Processing","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/refund-processing/index.ts"},{"id":"6.2","name":"ADM Prevention","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/adm-prevention/index.ts"},{"id":"6.3","name":"ADM/ACM Processing","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/adm-acm-processing/index.ts"},{"id":"6.4","name":"Customer Communication","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/customer-communication/index.ts"},{"id":"6.5","name":"Feedback & Complaint","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/feedback-complaint/index.ts"},{"id":"6.6","name":"Loyalty Mileage","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/loyalty-mileage/index.ts"},{"id":"7.1","name":"BSP Reconciliation","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/bsp-reconciliation/index.ts"},{"id":"7.2","name":"ARC Reconciliation","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/arc-reconciliation/index.ts"},{"id":"7.3","name":"Commission Management","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/commission-management/index.ts"},{"id":"7.4","name":"Interline Settlement","stage":"reconciliation","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/reconciliation/src/interline-settlement/index.ts"},{"id":"7.5","name":"Financial Reporting","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/financial-reporting/index.ts"},{"id":"7.6","name":"Revenue Accounting","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/revenue-accounting/index.ts"},{"id":"8.1","name":"Traveler Profile","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/traveler-profile/index.ts"},{"id":"8.2","name":"Corporate Account","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/corporate-account/index.ts"},{"id":"8.3","name":"Mid-Office Automation","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/mid-office/index.ts"},{"id":"8.4","name":"Reporting & Analytics","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/reporting/index.ts"},{"id":"8.5","name":"Duty of Care","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/duty-of-care/index.ts"},{"id":"9.1","name":"Orchestrator","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/orchestrator/index.ts"},{"id":"9.2","name":"Knowledge Retrieval","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/knowledge/index.ts"},{"id":"9.3","name":"Monitoring & Alerting","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/monitoring/index.ts"},{"id":"9.4","name":"Audit & Compliance","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/audit/index.ts"},{"id":"9.5","name":"Plugin Manager","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/plugin-manager/index.ts"},{"id":"9.6","name":"Performance Audit","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/performance-audit/index.ts"},{"id":"9.7","name":"Routing Audit","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/routing-audit/index.ts"},{"id":"9.8","name":"Recommendation","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/recommendation/index.ts"},{"id":"9.9","name":"Alert","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/alert/index.ts"},{"id":"20.1","name":"Hotel Search Aggregator","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-search/index.ts"},{"id":"20.2","name":"Property Deduplication","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/property-dedup/index.ts"},{"id":"20.3","name":"Hotel Content Normalization","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/content-normalization/index.ts"},{"id":"20.4","name":"Hotel Rate Comparison","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/rate-comparison/index.ts"},{"id":"20.5","name":"Hotel Booking","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-booking/index.ts"},{"id":"20.6","name":"Hotel Modification & Cancellation","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-modification/index.ts"},{"id":"20.7","name":"Confirmation Verification","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/confirmation-verification/index.ts"},{"id":"20.8","name":"Activity Search","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/activity-search/index.ts"},{"id":"20.9","name":"Transfer Search","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/transfer-search/index.ts"}],"edges":[{"source":"1.1","target":"1.4","kind":"workflow","label":"search_to_price"},{"source":"1.4","target":"2.1","kind":"workflow","label":"search_to_price"},{"source":"2.1","target":"2.2","kind":"workflow","label":"search_to_price"},{"source":"2.2","target":"2.3","kind":"workflow","label":"search_to_price"},{"source":"3.3","target":"3.1","kind":"workflow","label":"book_to_ticket"},{"source":"3.1","target":"3.2","kind":"workflow","label":"book_to_ticket"},{"source":"3.2","target":"4.1","kind":"workflow","label":"book_to_ticket"},{"source":"1.1","target":"1.4","kind":"workflow","label":"full_booking"},{"source":"1.4","target":"2.1","kind":"workflow","label":"full_booking"},{"source":"2.1","target":"2.2","kind":"workflow","label":"full_booking"},{"source":"2.2","target":"2.3","kind":"workflow","label":"full_booking"},{"source":"2.3","target":"3.3","kind":"workflow","label":"full_booking"},{"source":"3.3","target":"3.1","kind":"workflow","label":"full_booking"},{"source":"3.1","target":"3.2","kind":"workflow","label":"full_booking"},{"source":"3.2","target":"4.1","kind":"workflow","label":"full_booking"},{"source":"5.1","target":"5.2","kind":"workflow","label":"exchange_flow"},{"source":"6.1","target":"6.2","kind":"workflow","label":"refund_flow"},{"source":"1.1","target":"0.1","kind":"package","label":"@otaip/agents-search → @otaip/agents-reference"},{"source":"2.1","target":"0.1","kind":"package","label":"@otaip/agents-pricing → @otaip/agents-reference"},{"source":"3.1","target":"0.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-reference"},{"source":"3.1","target":"1.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-search"},{"source":"3.1","target":"2.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-pricing"},{"source":"4.1","target":"3.1","kind":"package","label":"@otaip/agents-ticketing → @otaip/agents-booking"},{"source":"5.1","target":"1.1","kind":"package","label":"@otaip/agents-exchange → @otaip/agents-search"},{"source":"5.1","target":"4.1","kind":"package","label":"@otaip/agents-exchange → @otaip/agents-ticketing"},{"source":"6.1","target":"4.1","kind":"package","label":"@otaip/agents-settlement → @otaip/agents-ticketing"},{"source":"7.1","target":"0.1","kind":"package","label":"@otaip/agents-reconciliation → @otaip/agents-reference"}],"package_deps":[{"from_package":"@otaip/agents-search","to_package":"@otaip/agents-reference","from_stage":"search","to_stage":"reference"},{"from_package":"@otaip/agents-pricing","to_package":"@otaip/agents-reference","from_stage":"pricing","to_stage":"reference"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-reference","from_stage":"booking","to_stage":"reference"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-search","from_stage":"booking","to_stage":"search"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-pricing","from_stage":"booking","to_stage":"pricing"},{"from_package":"@otaip/agents-ticketing","to_package":"@otaip/agents-booking","from_stage":"ticketing","to_stage":"booking"},{"from_package":"@otaip/agents-exchange","to_package":"@otaip/agents-search","from_stage":"exchange","to_stage":"search"},{"from_package":"@otaip/agents-exchange","to_package":"@otaip/agents-ticketing","from_stage":"exchange","to_stage":"ticketing"},{"from_package":"@otaip/agents-settlement","to_package":"@otaip/agents-ticketing","from_stage":"settlement","to_stage":"ticketing"},{"from_package":"@otaip/agents-reconciliation","to_package":"@otaip/agents-reference","from_stage":"reconciliation","to_stage":"reference"}]},"docs":{"0.1":{"id":"0.1","summary":"Resolves IATA/ICAO airport and city codes to canonical airport records with multi-airport city awareness and historical code handling","className":"AirportCodeResolver","input":"`code` -- IATA 3-letter, ICAO 4-letter, city code, or airport name\n`code_type?` -- `'iata' | 'icao' | 'city' | 'name' | 'auto'` (auto-detected if omitted)\n`include_metro?` -- return all airports in a metro/city code (default: true)\n`include_decommissioned?` -- resolve retired/reassigned codes (default: false)","output":"`resolved_airport` -- canonical airport record (IATA, ICAO, name, city, country, timezone, lat/lon, type, status)\n`metro_airports` -- list of airports in the same metro area\n`match_confidence` -- 0-1 confidence score\n`stale_data?` -- true when dataset is older than 30 days\n`suggestion?` -- fuzzy match suggestion when code not found","usage":"const agent = new AirportCodeResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'JFK', code_type: 'iata' } });\n// result.data.resolved_airport.name => \"John F Kennedy International Airport\"","status":"Implemented","purpose":"Resolves IATA/ICAO airport and city codes to canonical airport records with multi-airport city awareness, fuzzy name matching, and historical code handling."},"0.2":{"id":"0.2","summary":"Resolves IATA/ICAO airline designator codes to canonical airline records with alliance membership mapping and codeshare partner networks","className":"AirlineCodeMapper","input":"`code` -- IATA 2-letter, ICAO 3-letter, or airline name\n`code_type?` -- `'iata' | 'icao' | 'name' | 'auto'`\n`include_codeshares?` -- include codeshare partners (default: false)\n`include_defunct?` -- include ceased-operations airlines (default: false)","output":"`airline` -- canonical airline record (codes, name, callsign, country, alliance, hubs, status)\n`codeshare_partners` -- partner airline list with relationship type\n`match_confidence` -- 0-1 confidence score","usage":"const agent = new AirlineCodeMapper();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'UA', include_codeshares: true } });\n// result.data.airline.name => \"United Airlines\"","status":"Implemented"},"0.3":{"id":"0.3","summary":"Decodes ATPCO-standard fare basis codes into human-readable components including cabin class, fare restrictions, advance purchase requirements, and penalty information","className":"FareBasisDecoder","input":"`fare_basis` -- ATPCO fare basis code (max 15 chars, e.g., `\"YOW3M1\"`, `\"TLXP14NR\"`)\n`carrier?` -- IATA airline code for carrier-specific decoding","output":"`decoded` -- parsed components (primary code, cabin class, fare type, season, day-of-week, advance purchase, min/max stay, penalties, ticket designator)\n`match_confidence` -- 1.0 = fully decoded, 0.5-0.9 = partial\n`unparsed_segments` -- parts that could not be decoded","usage":"const agent = new FareBasisDecoder();\nawait agent.initialize();\nconst result = await agent.execute({ data: { fare_basis: 'Y26NR' } });\n// result.data.decoded.cabin_class => \"economy\"","status":"Implemented"},"0.4":{"id":"0.4","summary":"Maps single-letter booking class codes to cabin class, fare family, upgrade eligibility, and loyalty program earning rates","className":"ClassOfServiceMapper","input":"`booking_class` -- single letter A-Z\n`carrier` -- IATA 2-letter airline code (required -- meanings are carrier-specific)\n`include_loyalty?` -- include loyalty earning rates (default: false)","output":"`mapping` -- cabin class, brand name, fare family, upgrade eligibility/type, same-day change, seat selection, refundable, priority level, loyalty earning\n`match_confidence` -- 1.0 = carrier-specific, 0.7 = IATA default, 0 = unknown","usage":"const agent = new ClassOfServiceMapper();\nawait agent.initialize();\nconst result = await agent.execute({ data: { booking_class: 'J', carrier: 'UA', include_loyalty: true } });\n// result.data.mapping.cabin_class => \"business\"","status":"Implemented","purpose":"Maps single-letter booking class codes to cabin class, fare family, upgrade eligibility, and loyalty program earning rates. Booking classes are carrier-specific."},"0.5":{"id":"0.5","summary":"Resolves IATA aircraft equipment codes to structured equipment data","className":"EquipmentTypeResolver","input":"`operation` -- `'resolve' | 'getSeatingConfig' | 'isWidebody' | 'getSimilarTypes'`\n`code` -- IATA equipment code (e.g., `\"789\"`, `\"320\"`)\n`cabin?` -- cabin code (`'F' | 'C' | 'W' | 'Y'`) for `getSeatingConfig`","output":"`equipment?` -- full equipment info (IATA/ICAO codes, manufacturer, family, body type, seats, range)\n`seatCount?` -- seat count for specific cabin\n`isWidebody?` -- boolean\n`similarTypes?` -- IATA codes of similar aircraft","usage":"const agent = new EquipmentTypeResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { operation: 'resolve', code: '789' } });\n// result.data.equipment.manufacturer => \"Boeing\"","status":"Implemented","purpose":"Resolves IATA aircraft equipment codes to structured equipment data including manufacturer, body type, typical seating, range, and max capacity."},"0.6":{"id":"0.6","summary":"Resolves ISO 4217 currency codes and IATA tax/surcharge codes used in airline pricing and ticketing","className":"CurrencyTaxResolver","input":"`code` -- ISO currency code or IATA tax code\n`code_type?` -- `'currency' | 'tax' | 'auto'`\n`country?` -- ISO 2-letter country code to filter tax applicability","output":"`currency` -- currency details (code, name, symbol, minor units, countries, active status)\n`tax` -- tax details (code, name, description, category, country, applies-to, percentage flag)\n`match_confidence` -- 0-1 confidence score","usage":"const agent = new CurrencyTaxResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'USD' } });\n// result.data.currency.name => \"US Dollar\"","status":"Implemented"},"0.7":{"id":"0.7","summary":"APIS requirements, visa requirements, restriction levels. Static dataset -- must NOT be used as legal travel advice","className":"CountryRegulatoryResolver","input":"`operation` -- `'getAPISRequirements' | 'getVisaRequirement' | 'getRestrictionLevel'`\n`countryCode?` -- ISO 2-letter (for APIS and restriction)\n`nationalityCode?` -- ISO 2-letter (for visa)\n`destinationCode?` -- ISO 2-letter (for visa)","output":"`apis?` -- APIS requirements (required fields, advance submission hours)\n`visa?` -- visa requirement (type, max stay days)\n`restriction?` -- restriction level 1-4 with summary","usage":"const agent = new CountryRegulatoryResolver();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { operation: 'getVisaRequirement', nationalityCode: 'US', destinationCode: 'GB' }\n});\n// result.data.visa.requirement => \"visa_free\"","status":"Implemented"},"1.1":{"id":"1.1","summary":"Queries distribution adapters in parallel, normalizes, deduplicates, filters, and sorts flight availability offers","className":"AvailabilitySearch","input":"`origin` -- origin airport/city IATA code\n`destination` -- destination airport/city IATA code\n`departure_date` -- ISO 8601 date\n`return_date?` -- ISO 8601 date for round-trip\n`passengers` -- `PassengerCount[]`\n`cabin_class?` -- `'economy' | 'premium_economy' | 'business' | 'first'`\n`direct_only?` -- only direct flights\n`max_connections?` -- 0-5\n`currency?` -- ISO 4217\n`max_results?` -- 1-200\n`sort_by?` -- `'price' | 'duration' | 'departure' | 'arrival' | 'connections'`\n`sort_order?` -- `'asc' | 'desc'`\n`sources?` -- specific adapter names to query","output":"`offers` -- deduplicated, filtered, sorted `SearchOffer[]`\n`total_raw_offers` -- count before deduplication\n`source_status` -- per-adapter query status (success, count, error, response time)\n`truncated` -- whether results were capped","usage":"new AvailabilitySearch(adapters: DistributionAdapter[]) Then call initialize() and execute({ data }).","status":"Implemented"},"1.2":{"id":"1.2","summary":"Looks up flight schedules with SSIM operating day parsing, codeshare detection, and connection discovery","className":"ScheduleLookup","input":"`origin` -- airport IATA code\n`destination` -- airport IATA code\n`date` -- ISO 8601 date\n`carrier?` -- filter by carrier IATA code\n`flight_number?` -- specific flight (requires carrier)\n`include_codeshares?` -- default: true\n`include_connections?` -- discover connecting options (default: false)","output":"`flights` -- `ScheduledFlight[]` (carrier, flight number, times, duration, schedule, codeshare info)\n`connections` -- `ConnectionOption[]` (two-leg connections with timing)\n`operates_on_date` -- whether any flights operate on the requested date","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.3":{"id":"1.3","summary":"Validates connections against MCT rules, scores connection quality, and checks interline agreements","className":"ConnectionBuilder","input":"`arriving_segment` -- `FlightSegment` (from `@otaip/core`)\n`departing_segment` -- `FlightSegment`\n`connection_airport` -- IATA 3-letter code\n`has_checked_bags?` -- affects MCT\n`is_interline?` -- different carriers","output":"`validation` -- MCT check result (valid, available/required minutes or null when unavailable, buffer, applied rule)\n`quality` -- connection quality score 0-1 with factor breakdown\n`interline` -- interline agreement check (if different carriers)\n`warnings` -- connection warnings","status":"Implemented","purpose":"Validates connections against MCT (Minimum Connecting Time) rules, scores connection quality, and checks interline agreements.\n\nMCT authority: **IATA SSIM Chapter 8** + **PSC Resolution 765** (`docs/knowledge-base/mct.md`). Curated rows live under `data/reference/mct/`. Resolution hierarchy: carrier override → airport+terminal → airport → **fail-closed** (no invented global/airport-constant table).","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.4":{"id":"1.4","summary":"Multi-source fare comparison with fare basis decoding, class mapping, branded fare family grouping, and passenger type pricing","className":"FareShopping","input":"`origin`, `destination`, `departure_date`, `passengers` -- same as availability search\n`cabin_class?`, `currency?`, `sources?` -- filters\n`decode_fare_basis?` -- decode fare basis codes (default: true)\n`group_by_fare_family?` -- group by basic/standard/flex/premium (default: true)","output":"`fares` -- `FareOffer[]` sorted by price, each with decoded fare basis, class info, fare family, passenger pricing\n`fare_families` -- grouped by family with cheapest/most expensive\n`total_fares` -- count\n`sources_queried` -- adapter names","usage":"new FareShopping(adapters: DistributionAdapter[]) Then call initialize() and execute({ data }).","status":"Implemented"},"1.5":{"id":"1.5","summary":"Searches ancillary offers (seats, bags, meals) across distribution adapters","className":"AncillaryShoppingAgent","input":"`segments` -- flight segments (origin, destination, flight number, date, carrier)\n`passengers` -- passenger references with type (ADT/CHD/INF)\n`pnrRef?` -- PNR reference\n`requestedCategories?` -- filter by category (BAGGAGE, SEAT, MEAL, etc.)","output":"`ancillaries` -- `AncillaryOffer[]` with RFIC/RFISC codes, pricing, availability\n`notSupportedByAdapter` -- true if no adapter configured\n`currency` -- pricing currency","status":"Implemented","purpose":"Searches for available ancillaries (baggage, seats, meals, lounge, Wi-Fi, priority) via an injectable adapter.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.6":{"id":"1.6","summary":"Deduplicates and normalizes flight results from multiple adapter sources","className":"MultiSourceAggregatorAgent","input":"`results` -- `AdapterSearchResult[]` (adapter name, flights, errors, response time)\n`deduplicationStrategy` -- `'keep_cheapest' | 'keep_all' | 'keep_first'`\n`rankBy` -- `'price' | 'duration' | 'stops'`\n`maxResults?` -- limit output count","output":"`flights` -- `NormalizedFlight[]` with sources, lowest price, all prices across adapters\n`totalRaw` -- raw count before dedup\n`totalAfterDedup` -- final count\n`adapterSummary` -- per-adapter stats","status":"Implemented","purpose":"Aggregates search results from multiple adapters with deduplication, price comparison, and ranking.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.7":{"id":"1.7","summary":"Stub agent for hotel and car rental search via distribution adapters","className":"HotelCarSearchAgent","input":"`operation` -- `'searchHotels' | 'searchCars'`\n`hotel?` -- hotel search params (destination, dates, rooms, adults, star rating, max rate)\n`car?` -- car search params (pickup/dropoff location and times, category, driver age)","output":"`hotelResults?` -- hotel offers with rate, room type, cancellation policy\n`carResults?` -- car offers with category, supplier, daily/total rate, features","status":"Implemented (adapter-dependent)","purpose":"Car rental search (and, pending a deferred car-only migration, hotel) via pluggable adapters. Returns empty results when no adapters configured.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.8":{"id":"1.8","summary":"Natural language travel query understanding with injectable LLM provider; parses user queries into structured search parameters","className":"AITravelAdvisorAgent","input":"`query` -- natural language travel query\n`travelerContext?` -- preferences (cabin, budget, preferred airlines, passenger counts)","output":"`searchParameters` -- extracted origin, destination, dates, trip type, cabin, passengers, flexible dates\n`summary` -- natural language summary of interpreted query\n`intent` -- `'flight_search' | 'hotel_search' | 'destination_recommendation' | 'price_check' | 'trip_planning' | 'unknown'`","usage":"new AITravelAdvisorAgent({ llmProvider, maxTokens?, temperature? }) Then call initialize() and execute({ data }).","status":"Implemented"},"1.9":{"id":"1.9","summary":"Stateless, deterministic scoring engine for flight offers with multi-dimensional scoring, hard filtering, and full audit trail (lives in @otaip/core)","className":"OfferEvaluatorAgent","input":"`offers` -- `EvaluatorOffer[]` with price, itinerary (segments, duration, connections)\n`constraints?` -- latest arrival, prefer direct, max connections, price ceiling, preferred/blacklisted carriers\n`profile?` -- `'BUSINESS_TIME_CRITICAL' | 'BUSINESS_PRICE_CONSTRAINED' | 'LEISURE' | 'CORPORATE_POLICY' | 'CUSTOM'`\n`weights?` -- custom scoring weights (time_buffer, price, connection_quality, journey_duration)","output":"Scored and ranked offers with structured explanation for LLM translation","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.1":{"id":"2.1","summary":"Parses ATPCO fare rules (categories 1-20) into human-readable structured format using curated tariff snapshot data","className":"FareRuleAgent","input":"`fare_basis` -- fare basis code\n`carrier` -- marketing carrier IATA code\n`origin` -- origin IATA code\n`destination` -- destination IATA code\n`travel_date?` -- ISO date for date-based rule filtering\n`categories?` -- specific ATPCO categories 1-50 (all if omitted)","output":"`rules` -- `FareRuleResult[]` with parsed categories, penalty summary, advance purchase, min/max stay, seasonality\n`total_rules` -- count of matched rules\n`valid_for_date` -- whether fare is valid for the specified travel date\n`in_blackout` -- whether travel date falls in a blackout period","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.2":{"id":"2.2","summary":"NUC x ROE fare construction with mileage validation, HIP/BHC/CTM checks, surcharges, and IATA rounding. All financial math uses decimal.js","className":"FareConstruction","input":"`journey_type` -- `'OW' | 'RT' | 'CT'` (one-way, round-trip, circle-trip)\n`components` -- fare components (origin, destination, carrier, fare basis, NUC amount)\n`selling_currency` -- ISO 4217 currency\n`point_of_sale?` -- country for IROE selection context\n`data_sources?` -- licensed `{ iroe, rounding_024d, mileage }` (required for a constructed fare)","output":"Success (`FareConstructionOutput`): `total_nuc`, `iroe` (alias `roe`), `local_amount` after 024d, `rounding_method` (`HX`|`NX`), published `mileage_checks`, HIP/BHC/CTM sketches, `audit_trail`\nOr `DomainInputRequired` when licensed data is missing","status":"Implemented","purpose":"NUC × IROE construction with published TPM/MPM, Resolution **024d** (HX/NX) rounding, and fail-closed HIP/BHC/CTM hooks. All financial math uses `decimal.js`.\n\nLicensed IROE / 024d / TPM-MPM data are **not** shipped in the package. Pass them via `data_sources`. Missing IROE, TPM, or 024d → `DomainInputRequired`. Haversine-as-TPM and banker's rounding are banned.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.3":{"id":"2.3","summary":"Per-segment tax computation with exemption engine, ~30 countries, ~50 tax codes, currency conversion. All financial math uses decimal.js","className":"TaxCalculation","input":"`segments` -- itinerary segments (origin/destination airports and countries, carrier, cabin class, base fare NUC)\n`passenger_type` -- `'adult' | 'child' | 'infant' | 'crew' | 'diplomatic'`\n`is_transit` -- whether transit/connection (\u003c 24h same ticket)\n`is_involuntary` -- whether involuntary reroute\n`total_base_fare_nuc` -- total base fare for percentage-based taxes\n`selling_currency` -- ISO 4217","output":"`taxes` -- `AppliedTax[]` (code, name, country, type, amounts, segment indices, interlineable, exempt status)\n`total_tax` -- total in selling currency\n`breakdown` -- by country, interlineable/non-interlineable totals\n`exemptions_applied` -- list of exemption reasons\n`segments_processed` -- count","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.4":{"id":"2.4","summary":"Builds priced offers with TTL management and optional persistence adapter","className":"OfferBuilderAgent","input":"`operation` -- `'buildOffer' | 'getOffer' | 'validateOffer' | 'markUsed' | 'expireOffer' | 'cleanExpired'`\n`buildInput?` -- segments, fare, taxes, ancillaries, passenger count, pricing source, TTL\n`offerId?` -- for get/validate/mark/expire operations\n`currentTime?` -- ISO timestamp override","output":"`offer?` -- full offer record with pricing breakdown, TTL, status\n`valid?` -- offer validity result\n`reason?` -- validation failure reason\n`cleanedCount?` -- number of expired offers cleaned","usage":"new OfferBuilderAgent({ persistence?: PersistenceAdapter }) Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Builds, caches, validates, and manages pricing offers with TTL expiration. Supports in-memory or pluggable persistence."},"2.5":{"id":"2.5","summary":"Validates flight offers against corporate travel policies (cabin, budget, advance purchase)","className":"CorporatePolicyValidationAgent","input":"`offer` -- offer details (cabin, fare amount, carrier, fare basis, advance booking days, segments)\n`policy` -- corporate policy (cabin rules, fare rules, booking rules, bypass codes)\n`bypassCode?` -- authorization code to bypass soft violations","output":"`result` -- `'APPROVED' | 'SOFT_VIOLATION' | 'HARD_VIOLATION'`\n`violations` -- `PolicyViolation[]` with rule, severity, detail\n`bypassApplied` -- whether bypass was used","status":"Implemented","purpose":"Validates flight offers against corporate travel policies: cabin class limits, fare ceilings, blocked carriers, advance booking requirements. Supports bypass codes.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.6":{"id":"2.6","summary":"Placeholder -- not yet implemented. Requires revenue management integration","className":"DynamicPricingAgent","status":"Coming Soon (stub)","purpose":"Revenue management integration for dynamic fare adjustments. Requires revenue management integration before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"2.7":{"id":"2.7","summary":"Placeholder -- not yet implemented. Requires revenue management integration","className":"RevenueManagementAgent","status":"Coming Soon (stub)","purpose":"Revenue management system integration. Requires revenue management domain input before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"3.1":{"id":"3.1","summary":"Routes booking requests to the correct distribution channel based on carrier config, codeshare rules, and NDC capability","className":"GdsNdcRouter","input":"`segments` -- routing segments (marketing/operating carrier, origin, destination, flight number)\n`preferred_channel?` -- `'GDS' | 'NDC' | 'DIRECT'`\n`preferred_gds?` -- `'AMADEUS' | 'SABRE' | 'TRAVELPORT'`\n`include_fallbacks` -- whether to include fallback channels","output":"`routings` -- per-segment channel routing (primary channel, GDS system, NDC version, fallbacks, booking format)\n`unified_channel` -- whether all segments can use the same channel\n`recommended_channel` -- best channel for entire itinerary\n`gds_format` / `ndc_format` -- format translation stubs","status":"Implemented","purpose":"Routes booking requests to the correct distribution channel (GDS, NDC, or direct API) based on carrier config, codeshare rules, and NDC capability. Per-segment routing with fallback support.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.2":{"id":"3.2","summary":"Constructs GDS-ready PNR commands from normalized booking data. Supports Amadeus, Sabre, and Travelport syntax","className":"PnrBuilder","input":"`gds` -- `'AMADEUS' | 'SABRE' | 'TRAVELPORT'`\n`passengers` -- name, type, DOB, passport, gender, nationality, FOID\n`segments` -- carrier, flight, class, date, origin, destination, status\n`contacts` -- phone, email, type\n`ticketing` -- time limit, type\n`received_from` -- agent identifier\n`ssrs?` -- SSR elements (WCHR, VGML, DOCS, FOID, CTCE, CTCM, INFT)\n`osis?` -- OSI elements\n`is_group?` / `group_name?` -- group PNR support","output":"`gds` -- target GDS\n`commands` -- ordered `PnrCommand[]` with GDS command strings and descriptions\n`passenger_count`, `segment_count`, `is_group`, `infant_count`","status":"Implemented","purpose":"Constructs GDS-ready PNR commands from normalized booking data. Supports Amadeus, Sabre, and Travelport syntax including names, segments, contacts, ticketing, SSR/OSI elements, and group bookings.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.3":{"id":"3.3","summary":"Pre-ticketing validation -- 13 checks to catch errors before ADMs","className":"PnrValidation","input":"`record_locator` -- 6-char PNR\n`passengers` -- passenger data (name, type, DOB, nationality, passport)\n`segments` -- segment data (carrier, flight, status, class, international flag, married group)\n`contact?` -- phone/email\n`ticketing?` -- time limit, arranged status\n`fare?` -- fare data with advance purchase deadline\n`validation_date?` -- ISO date override","output":"`record_locator` -- PNR\n`checks` -- `ValidationCheck[]` (13 checks, each with pass/fail, severity, message)\n`valid` -- overall pass/fail\n`error_count`, `warning_count`","status":"Implemented","purpose":"Pre-ticketing validation with 13 checks to catch errors before ADMs: segment status, passenger data, APIS, ticketing deadline, fare consistency, and more.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.4":{"id":"3.4","summary":"GDS queue monitoring and processing -- priority assignment, categorization, action routing, and queue command generation","className":"QueueManagement","input":"`entries` -- queue items (record locator, GDS, queue number, entry type, deadline, remark)\n`current_time?` -- ISO timestamp for priority calculation\n`gds?` -- GDS system for command generation\n`queue_number?` -- queue to generate read commands for\n`travelport_host?` -- `'APOLLO' | 'GALILEO' | 'WORLDSPAN'` when `gds` is `TRAVELPORT`","output":"`results` -- processed items with priority, status, recommended action, target agent\n`commands?` -- GDS queue commands\n`summary` -- counts by priority (urgent/high/normal/low)","status":"Implemented","purpose":"GDS queue monitoring and processing: priority assignment, categorization, action routing, and queue command generation.\n\nTravelport place/list/remove commands are **per host** (Apollo / Galileo≡Travelport+ / Worldspan) from the public format-compare table — see `docs/knowledge-base/tmc-mid-office-ttl-queues.md`. TTL priority uses Zulu deadline-day urgency.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.5":{"id":"3.5","summary":"Universal HTTP client with circuit breaker, retry logic, timeout handling, rate limiting, and IATA error normalization","className":"ApiAbstraction","input":"`request` -- API request (provider ID, HTTP method, path, headers, body)\n`max_retries?` -- override retry count\n`timeout_ms?` -- override timeout\n`force?` -- skip circuit breaker check","output":"`response` -- API response (status, headers, body, duration, retries)\n`error` -- normalized error (category, original code, retryable flag)\n`circuit_breaker` -- circuit breaker status\n`rate_limit` -- rate limit status\n`success` -- boolean","usage":"new ApiAbstraction(handler?: RequestHandler) Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Universal HTTP client with circuit breaker, retry logic, timeout handling, rate limiting, and IATA error normalization for GDS/NDC/payment providers."},"3.6":{"id":"3.6","summary":"Travel order lifecycle management -- create, modify, cancel, retrieve, and list orders with status tracking and transition validation","className":"OrderManagement","input":"`operation` -- `'createOrder' | 'modifyOrder' | 'cancelOrder' | 'getOrder' | 'listOrders'`\n`createOrder?` -- passenger, items, currency, source\n`modifyOrder?` -- order ID, updated items/details, reason\n`cancelOrder?` -- order ID, reason\n`getOrder?` / `listOrders?` -- retrieval/filtering","output":"`order?` -- order record with status, items, history\n`orders?` -- list of orders\n`operation`, `success`, `errorCode?`, `errorMessage?`","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.7":{"id":"3.7","summary":"PCI-safe payment instruction builder and transaction recorder. Validates forms of payment, builds GDS FOP strings -- never handles raw card numbers","className":"PaymentProcessing","input":"`operation` -- `'validateFOP' | 'buildPaymentInstruction' | 'recordPayment' | 'getPaymentRecord' | 'buildGDSFOPString'`\nOperation-specific data: FOP details (CC_TOKEN, BSP_CASH, AIRLINE_CREDIT, VOUCHER, UATP), amounts, references","output":"`validation?` -- FOP validation result\n`instruction?` -- payment instruction with GDS string, PCI-safe flag\n`record?` -- payment transaction record\n`gdsString?` -- GDS FOP string","status":"Implemented","purpose":"PCI-safe payment instruction builder and transaction recorder. Validates forms of payment, builds GDS FOP strings, records transactions. Never handles raw card numbers.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.8":{"id":"3.8","summary":"Retrieves an existing PNR/booking by record locator across distribution adapters. Read-only -- no side effects","className":"PnrRetrieval","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"4.1":{"id":"4.1","summary":"ETR generation with conjunction ticket support, BSP reporting, and commission handling","className":"TicketIssuance","input":"`record_locator` -- 6-char PNR\n`issuing_carrier` -- 2-letter IATA code\n`passenger_name` -- LAST/FIRST format\n`segments` -- flight segments with carrier, flight number, class, fare basis, dates, baggage\n`base_fare`, `base_fare_currency` -- fare amount\n`equivalent_fare?`, `equivalent_fare_currency?` -- currency conversion\n`taxes` -- tax breakdown items\n`fare_calculation` -- fare calculation line\n`form_of_payment` -- CASH, CREDIT_CARD, INVOICE, MISCELLANEOUS\n`endorsements?`, `commission?`, `bsp_reporting?`, `original_issue?`","output":"`tickets` -- `TicketRecord[]` (13-digit number, coupons with status, fare/tax breakdown, FOP, commission, BSP fields)\n`total_coupons` -- total across all tickets\n`is_conjunction` -- whether conjunction tickets were generated","status":"Implemented","purpose":"ETR (Electronic Ticket Record) generation with conjunction ticket support (auto-split for >4 coupons), BSP reporting fields, and commission handling.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.2":{"id":"4.2","summary":"EMD-A (associated) and EMD-S (standalone) issuance, RFIC/RFISC handling, coupon lifecycle","className":"EmdManagement","input":"`emd_type` -- `'EMD-A' | 'EMD-S'`\n`record_locator`, `issuing_carrier`, `passenger_name`\n`services` -- array of services with RFIC code (A-G), RFISC, description, amount, associated ticket/coupon for EMD-A\n`related_ticket_number?` -- for EMD-A","output":"`emd` -- `EmdRecord` (13-digit EMD number, coupons, amounts)\n`coupon_count`","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.3":{"id":"4.3","summary":"Ticket/EMD void processing -- coupon status check, carrier void window, BSP/ARC cut-off validation","className":"VoidAgent","input":"`document_number` -- 13-digit ticket/EMD number\n`issuing_carrier` -- 2-letter IATA code\n`coupons` -- coupon numbers and current statuses\n`issue_datetime` -- ISO datetime of issuance\n`current_datetime?` -- ISO datetime for void window check\n`settlement_system?` -- `'BSP' | 'ARC'`\n`bsp_cutoff_time?` -- HH:MM format","output":"`result` -- void permitted flag, rejection reason, message, void window hours, hours remaining, updated coupon statuses","status":"Implemented","purpose":"Ticket/EMD void processing with coupon status validation, carrier-specific void window enforcement, and BSP/ARC cut-off time checking.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.4":{"id":"4.4","summary":"Multi-channel itinerary rendering: Email (HTML+plain), SMS, WhatsApp. Carrier-neutral templates","className":"ItineraryDelivery","input":"`record_locator` -- booking reference\n`passengers` -- name, ticket number, frequent flyer\n`flights` -- flight details (number, origin, destination, times, cabin, seat, aircraft)\n`total_fare?`, `fare_currency?`\n`contact` -- email, phone, WhatsApp number\n`channels` -- `('EMAIL' | 'SMS' | 'WHATSAPP')[]`\n`agency_name?` -- for itinerary header","output":"`rendered` -- per-channel content (HTML/plain text, subject, SMS segment count)\n`channels_rendered` -- successfully rendered channels","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.5":{"id":"4.5","summary":"APIS validation, passport validity, visa check (stub for Agent 0.7)","className":"DocumentVerification","input":"`passengers` -- ticket name, passport name, passport number/expiry/nationality, DOB, gender\n`segments` -- destination country and travel date\n`passport_validity_months?` -- minimum validity beyond travel date (default: 6)\n`validation_date?` -- ISO date override","output":"`results` -- per-passenger verification (pass/fail, individual checks with severity)\n`all_passed` -- overall pass/fail\n`blocking_failures`, `advisory_warnings` -- counts","status":"Implemented","purpose":"APIS validation, passport validity checking (configurable months threshold), and name matching between ticket and passport.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.1":{"id":"5.1","summary":"ATPCO Category 31 voluntary change assessment: change fees, fare difference, residual value, waiver codes","className":"ChangeManagement","input":"`original_ticket` -- ticket number, issuing carrier, passenger name, record locator, issue date, base fare, total tax, fare basis, refundable flag, booking date, `original_departure_date?` (for DOT 7-day check)\n`requested_itinerary` -- new segments (carrier, flight, origin, destination, date, class, fare basis), new fare, new taxes\n`waiver_code?` -- airline-provided waiver identity (not skip-penalty by itself)\n`waiver_effect?` -- required when `waiver_code` set: `ELIMINATE_PENALTY | REDUCE_PENALTY | CHANGE_REFUND_FORM | CHANGE_REBOOKING_CLASS | IRROP_INVOLUNTARY` (see `docs/knowledge-base/waiver-typology.md`)\n`waiver_penalty_reduction?` -- required for `REDUCE_PENALTY`\n`permitted_booking_classes?` / `permitted_fare_basis_patterns?` -- required for `CHANGE_REBOOKING_CLASS`\n`current_datetime?` -- ISO datetime\n`cat31_rules?` -- filed Cat 31 rules (omit → ATPCO default no charge)\n`us_dot_24h?` -- `part_259_applicable?`, `booking_channel?` (`airline_direct` | `agency` | `ndc` | `gds` | `unknown`)","output":"`assessment` -- action (`REISSUE | REBOOK | REJECT`), change fee, fare difference, additional collection, residual value, forfeited amount, tax difference, total due, Cat 31 `is_free_change` flag, summary\n`us_dot_24h` -- carrier remedy (`cancel` | `hold` | `unknown`), eligibility, ineligibility reasons (including `departure_within_7_days`, `channel_coverage_unknown`), entitlement (`penalty_free_cancel` | `unpaid_fare_hold` | `none` | `unknown`). **Not** a free-change boolean. Channel coverage follows carrier disclosure — not a baked-in “third-party never qualifies” rule.","status":"Implemented","purpose":"ATPCO Category 31 voluntary change assessment: change fees, fare difference, residual value, waiver codes, Cat 31 free-change window detection, and US DOT 14 CFR §259.5(b)(4) 24-hour reservation assessment (hold **or** cancel — carrier chooses; ≥7 days before departure). See `docs/knowledge-base/us-dot-24-hour-reservation.md`.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.2":{"id":"5.2","summary":"Ticket reissue with residual value, per-tax TFC carryforward (CARRY\\","className":"ExchangeReissue","input":"`original_ticket_number`, `conjunction_originals?`, `original_issue_date`\n`issuing_carrier`, `passenger_name`, `record_locator`\n`original_base_fare`, `original_taxes` -- from original ticket\n`change_fee`, `residual_value`, `waiver_code?` -- from Agent 5.1\n`new_segments` -- new flight segments\n`new_fare`, `new_fare_currency`, `new_taxes`, `fare_calculation`\n`form_of_payment` -- for additional collection\n`gds?` -- GDS for command generation\n`tax_carryforward_context` -- geography (`SAME_AIRPORT | SAME_CITY | DIFFERENT`), validity window flag, flown status, POS unchanged\n`tax_carryforward_rules` -- per-code rules covering every tax on original ∪ new (nature, min geography, YQ/YR flags, validity expiry action)\n`same_origin_destination?` -- **deprecated / ignored** for tax decisions (migration warning only)","output":"`reissue` -- new ticket record with full audit trail, exchange commands, `tax_decisions` on the audit trail\n`additional_collection` -- amount due\n`credit_amount` -- amount refundable if downgrade\n`tax_decisions` -- `{ tax_code, action: CARRY | RECALCULATE | FORFEIT, reason }[]`","status":"Implemented","purpose":"Ticket reissue with residual value application, **per-tax** carryforward (`CARRY | RECALCULATE | FORFEIT`), conjunction ticket handling, GDS exchange command generation, and full audit trail.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.3":{"id":"5.3","summary":"Carrier-initiated schedule change handling: trigger assessment, airline protection logic, regulatory entitlements (EU261, US DOT)","className":"InvoluntaryRebook","input":"`original_pnr` -- record locator, passenger, affected segment, issuing carrier, countries, checked-in flag, EU/Community carrier flag, optional endorsement\n`schedule_change` -- change type (incl. MISCONNECT), times, routing/equipment, misconnect shortfall\n`available_flights?` -- protection candidates with operating/marketing/alliance/interline + `endorsement_allows`\n`thresholds?` -- carrier-specific `time_change_minutes`, `measurement_point` (DEPARTURE|ARRIVAL), `misconnect_minutes` — required for those triggers\n`is_passenger_no_show?` -- no-show flag\n`is_oversale_denied_boarding?` -- only true for 14 CFR §250 oversales\n`eu261_inputs?` -- great-circle `distance_km` (Art.7(4)), delay/notice/rerouting/extraordinary, third-country benefits caveat","output":"`result` -- involuntary flag, trigger, ranked protection candidates (not executed), `art8_passenger_choice_required` + `art8_choices`, measurement point, regulatory flags (EU261/US DOT), original routing credit flag, summary","status":"Implemented","purpose":"Carrier-initiated schedule change / IRROP handling. Domain KB: `docs/knowledge-base/involuntary-rebook-irrop.md` (Regulation (EC) No 261/2004 — [CELEX:32004R0261](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32004R0261)).\n\n- **Triggers:** time change, routing change, equipment downgrade, cancellation, misconnect — with explicit dep vs arr measurement. **No hardcoded 60-minute threshold**; fail closed when carrier threshold input is missing.\n- **Reprotection candidates:** same operating → marketing → alliance → interline → other, with endorsement fail-closed. Alliance ≠ any alliance flight. **Do not silently \"same carrier first\"** — when EU261 applies, Art.8 passenger choice (refund vs re-route) is required before execution.\n- **EU261:** Art.3(1) matrix (EU depart any carrier / EU arrive Community carrier only). Art.7 compensation via great-circle bands only (never TPM). Art.8 choice surfaced on output.\n- **US DOT:** 14 CFR §250 IDB is oversale-specific — delays/cancels report `applies: false`.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.4":{"id":"5.4","summary":"Placeholder -- not yet implemented. Requires domain input on disruption priority rules","className":"DisruptionResponseAgent","status":"Coming Soon (stub)","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"5.5":{"id":"5.5","summary":"Placeholder -- not yet implemented. Requires domain input on change fee structures","className":"SelfServiceRebookingAgent","status":"Implemented","purpose":"Orchestrates Availability Search (1.1) and Change Management (5.1) to present priced rebooking alternatives (changeFee + fareDifference + taxDifference per option). Read-only -- does NOT execute the reissue; that is Exchange/Reissue (5.2). Involuntary reasons (schedule change / missed connection / cancellation) waive the change fee; voluntary changes honor ATPCO Cat 31 via 5.1.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"5.6":{"id":"5.6","summary":"Placeholder -- not yet implemented. Requires domain input on waitlist priority scoring","className":"WaitlistManagementAgent","status":"Implemented","purpose":"Stateful in-memory passenger waitlist queue with four operations: addEntry (priority computed at add time), clear (given N seats opened, remove top-N by priority), queryStatus (1-based position + estimated clearance probability), and expire (prune entries past their cutoff). State is in-memory only -- production deployments should pair it with a durable persistence layer.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"6.1":{"id":"6.1","summary":"ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting, conjunction ticket handling","className":"RefundProcessing","input":"`ticket_number`, `conjunction_tickets?`\n`issuing_carrier`, `passenger_name`, `record_locator`\n`base_fare`, `base_fare_currency`, `taxes`, `commission?`\n`refund_type` -- `'FULL' | 'PARTIAL' | 'TAX_ONLY'`\n`coupons_to_refund?` -- specific coupons (for partial)\n`total_coupons`, `waiver_code?`, `waiver_effect?` (required with code), `fare_basis`, `is_refundable`\n`waiver_penalty_reduction?`, `waiver_refund_form?` -- companions per typology in `docs/knowledge-base/waiver-typology.md`\n`settlement_system` -- `'BSP' | 'ARC'`","output":"`refund` -- penalty applied, base fare refund, tax refund, tax breakdown, commission recalled, net refund, BSP/ARC reporting fields, audit trail\n`net_refund_amount`, `commission_recalled`","status":"Implemented","purpose":"ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting fields, conjunction ticket handling. Supports full, partial, and tax-only refunds.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.2":{"id":"6.2","summary":"Pre-ticketing audit: 9 checks covering fare integrity, segment validity, and compliance to prevent Agency Debit Memos","className":"ADMPrevention","input":"`booking` -- record locator, passenger name, segments (with status, class, married group), base fare\n`fare_basis`, `booked_class`\n`commission_rate?`, `carrier_contracted_rate?`\n`endorsement?`, `tour_code?`\n`is_net_remit?`, `net_contracted_amount?`\n`ttl_deadline?`, `duplicate_check_pnrs?`, `current_datetime?`","output":"`result` -- all check results, overall pass/fail, blocking/warning counts","status":"Implemented","purpose":"Pre-ticketing audit with 9 checks: duplicate booking, fare/class mismatch, passive segment, married segment integrity, TTL expiry, commission rate, endorsement box, tour code format, net remit validation.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.3":{"id":"6.3","summary":"Agency Debit Memo receipt, assessment, dispute, and Agency Credit Memo application workflows","className":"ADMACMProcessingAgent","input":"`operation` -- `'receiveADM' | 'receiveACM' | 'assessADM' | 'disputeADM' | 'acceptADM' | 'escalateADM' | 'applyACM' | 'getADM' | 'getPendingWithDeadlines'`\nOperation-specific fields: ticket number, airline, amount, reason code, dispute ground/evidence, ADM/ACM IDs","output":"`adm?` -- ADM record with status history\n`acm?` -- ACM record\n`assessment?` -- days remaining, window expired, recommended action\n`disputeResult?` -- dispute outcome\n`pendingDeadlines?` -- urgent ADMs approaching deadline","status":"Implemented","purpose":"Agency Debit Memo receipt, assessment, dispute, and Agency Credit Memo application workflows. Tracks dispute deadlines (15-day window), supports dispute grounds, and manages status transitions.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.4":{"id":"6.4","summary":"Multi-channel customer notification generation for flight disruptions, refunds, and operational changes. 8 notification types x 4 channels","className":"CustomerCommunication","input":"`operation` -- `'generateNotification' | 'generateBatch' | 'getTemplate'`\n`notificationType?` -- notification type\n`channel?` -- delivery channel\n`variables?` -- template variables (passenger name, flight info, amounts, etc.)\n`batchRequests?` -- for batch generation","output":"`notification?` -- generated notification with body, subject, SMS segments, used/missing variables\n`notifications?` -- batch results\n`template?` -- template info with required variables","status":"Implemented","purpose":"Multi-channel customer notification generation. 8 notification types (flight cancelled, delayed, gate change, rebooking confirmed, refund processed, schedule change, waitlist cleared, ADM received) x 4 channels (Email HTML, Email text, SMS, WhatsApp).","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.5":{"id":"6.5","summary":"Complaint submission, EU261/US DOT compensation calculation, case management, and regulatory DOT record generation","className":"FeedbackComplaintAgent","input":"`operation` -- `'submitComplaint' | 'updateStatus' | 'getCase' | 'listCases' | 'calculateCompensation' | 'generateDOTRecord'`\nComplaint fields: type, passenger, booking reference, airline, flight, description\nCompensation fields: regulation, distance, delay, alternative offered, fare paid, cabin class\nCase management: case ID, status transitions","output":"`complaintCase?` -- full case record with status history, compensation result\n`cases?` -- filtered case list\n`compensation?` -- EU261/US DOT calculation (eligibility, base/final amount, reduction, notes)\n`dotRecord?` -- DOT regulatory record","status":"Implemented","purpose":"Complaint submission, EU261/US DOT compensation calculation, case management with status tracking, and DOT regulatory record generation.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.6":{"id":"6.6","summary":"Mileage accrual calculation, redemption eligibility, status benefits, and alliance status matching","className":"LoyaltyMileageAgent","input":"`operation` -- `'calculateAccrual' | 'checkRedemptionEligibility' | 'getStatusBenefits' | 'matchStatus'`\nAccrual: operating/crediting carrier, booking class, distance, loyalty status\nRedemption: distance, cabin, partner flag, current balance\nBenefits: airline, status tier\nMatch: source/target airline, source status","output":"`accrual?` -- base miles, bonus miles, total, earn rate, partner flag\n`redemption?` -- eligibility, miles required, remaining balance\n`statusBenefits?` -- benefit list by tier\n`statusMatch?` -- matched status at target airline","status":"Implemented","purpose":"Mileage accrual calculation, redemption eligibility checking, status benefits lookup, and cross-airline status matching.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.1":{"id":"7.1","summary":"Matches agency booking records against BSP HOT files, validates commission, identifies discrepancies, flags issues before remittance deadline","className":"BSPReconciliation","input":"`hot_records` -- BSP HOT file records (ticket number, passenger, origin/destination, airline, amounts, commission, transaction type, billing period)\n`agency_records` -- agency-side booking records for comparison","output":"Matched records, unmatched records, discrepancies with severity and type, commission validation results","status":"Implemented","purpose":"Matches agency booking records against BSP HOT files, validates commission rates, identifies discrepancies (missing records, duplicates, amount/commission/currency mismatches, unmatched ADM/ACM), and flags issues before remittance deadline.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.2":{"id":"7.2","summary":"Processes ARC IAR weekly billing, validates commission rates against airline contracts, flags pricing/commission errors","className":"ARCReconciliation","input":"`iar_records` -- ARC IAR records (document number, amounts, commission, transaction type, settlement week, ADM issue dates)\n`agency_records` -- agency-side records for comparison","output":"Matched/unmatched records, discrepancies with severity, ADM dispute window warnings","status":"Implemented","purpose":"Processes ARC IAR (Interactive Agent Reporting) weekly billing, validates commission rates against airline contracts, flags pricing/commission errors, and manages ADM/ACM disputes within the 15-day window.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.3":{"id":"7.3","summary":"Commission agreement management, rate validation, incentive calculation","className":"CommissionManagementAgent","input":"`operation` -- `'registerAgreement' | 'getRate' | 'validateCommission' | 'calculateIncentive' | 'listAgreements'`\nAgreement data: agent ID, airline, type, rate, basis (percent/flat per ticket/segment), fare basis patterns, validity dates, minimum tickets\nValidation: claimed rate vs expected rate\nIncentive: period, ticket count, total fare","output":"`agreement?` -- registered agreement\n`rate?` -- applicable commission rate\n`validation?` -- match/overstated/understated status with variance\n`incentive?` -- earned incentive amount, threshold met flag","status":"Implemented","purpose":"Commission agreement management: register agreements (override, incentive, backend, net fare, standard), look up rates by airline/fare basis, validate claimed commission, and calculate incentive earnings.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.4":{"id":"7.4","summary":"Placeholder -- not yet implemented. Requires domain input on interline prorate methodology","className":"InterlineSettlementAgent","status":"Coming Soon (stub)","purpose":"Requires domain input on interline prorate methodology and SIS (Simplified Interline Settlement) billing rules before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"7.5":{"id":"7.5","summary":"Aggregates transaction data into reports (revenue by route, margin analysis, unused tickets, etc.)","className":"FinancialReportingAgent","input":"`type` -- report type (9 report types available)\n`period` -- date range\n`filters?` -- airlines, agents, corporate IDs, currencies, minimum amount\n`groupBy?` -- grouping dimensions\n`records` -- financial records (ticket, refund, ADM, ACM, commission, fee)\n`currency?` -- reporting currency","output":"Report line items with revenue, cost, commission, net per group\nReport totals","status":"Implemented","purpose":"Generates financial reports: revenue by route/agent/corporate client, margin analysis, cost tracking, commission summary, spend by supplier, unused ticket value, and settlement summary.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.6":{"id":"7.6","summary":"Coupon lift recording, revenue recognition, uplift/deferred revenue reporting","className":"RevenueAccountingAgent","input":"`operation` -- `'recordLift' | 'recognizeRevenue' | 'getUpliftReport' | 'getDeferredRevenue' | 'recordVoid' | 'recordRefund'`\nLift data: ticket number, coupon number, flight details, fare amount\nReport parameters: date range","output":"Lift records, revenue recognition results, uplift reports (by route/cabin with average yield), deferred revenue reports","status":"Implemented","purpose":"Coupon lift tracking and revenue recognition: record lifted coupons, recognize revenue per flight, generate uplift reports (by route, by cabin), track deferred revenue from open coupons, and handle voids/refunds.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.1":{"id":"8.1","summary":"Stores/retrieves traveler preferences, documents, loyalty programs. Applies profiles to PNRs via SSR injection","className":"TravelerProfileAgent","input":"`operation` -- `'get' | 'create' | 'update' | 'apply_to_pnr' | 'search'`\nProfile data: name, DOB, nationality, passport, loyalty numbers, seat/meal preference, contact info, corporate/employee ID, department, cost center\nPNR application: GDS system, segments for APIS generation","output":"`profile?` -- traveler profile record\n`profiles?` -- search results\nPNR application: generated SSR/OSI commands","status":"Implemented","purpose":"Traveler preferences, identity documents, loyalty programs, and PNR prefill. CRUD operations plus apply-to-PNR for generating SSR/APIS commands.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.2":{"id":"8.2","summary":"Corporate travel policy enforcement, negotiated fares, booking validation","className":"CorporateAccountAgent","input":"`operation` -- `'get_account' | 'create_account' | 'update_account' | 'validate_booking' | 'get_policy' | 'list_accounts' | 'get_preferred_suppliers'`\nAccount data: company name, IATA number, travel policy, negotiated fares, contact info\nBooking validation: segments, cabin, fare amount, advance days","output":"`account?` -- corporate account record\n`accounts?` -- account list\n`validation?` -- policy violations (hard/soft) with details\n`policy?` -- travel policy rules\n`suppliers?` -- preferred suppliers","status":"Implemented","purpose":"Corporate travel policy management, negotiated fare lookup, and booking validation against policy rules (cabin limits, fare ceilings, advance booking, preferred/blacklisted airlines).","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.3":{"id":"8.3","summary":"PNR quality checks, ticketing deadline monitoring, duplicate/passive detection","className":"MidOfficeAgent","input":"`trigger` -- `'scheduled_sweep' | 'pnr_created' | 'ticket_deadline_approaching' | 'queue_pending' | 'manual_review_request'`\n`pnrs` -- PNR records with segments, deadlines, APIS/contact/FOP flags\n`current_datetime?` -- ISO timestamp (compared as Zulu)","output":"Per-PNR issues with severity (urgent/high/medium/low) and issue codes\nSummary counts","status":"Implemented","purpose":"PNR quality checks and ticketing deadline monitoring. Scans PNRs for 10 issue types: TTL urgent/approaching, missing segment status, missing APIS, missing contact/FOP, duplicate PNR, passive segment, policy violation, married segment incomplete.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.4":{"id":"8.4","summary":"Aggregates transaction data into reports (booking volume, revenue, top routes, policy compliance)","className":"ReportingAgent","input":"`report_type` -- report type\n`date_from`, `date_to` -- date range\n`filters?` -- corporate ID, agent, airline, department, currency\n`transactions` -- transaction records (ticket, amounts, airline, dates, in-policy flag, used flag)","output":"Report rows grouped by the relevant dimension\nSummary totals","status":"Implemented","purpose":"Transaction aggregation and report generation across 9 report types: booking volume, revenue summary, top routes, agent productivity, policy compliance, spend by traveler/department/supplier, unused tickets.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.5":{"id":"8.5","summary":"Locates travelers in active itineraries during disruptions with destination risk assessment","className":"DutyCareAgent","input":"`operation` -- `'locate_travelers' | 'get_traveler_itinerary' | 'assess_destination_risk' | 'mark_accounted_for'`\nItineraries: traveler ID, segments with dates/times/status\nRisk: country code\nAccountability: traveler ID","output":"`locatedTravelers?` -- current location, status (IN_TRANSIT/AT_DESTINATION/DEPARTED/UNKNOWN), accounted-for flag\n`itinerary?` -- full traveler itinerary\n`risk?` -- country risk level (low/medium/high/critical) with notes","status":"Implemented","purpose":"Traveler location tracking, destination risk assessment, and accountability management for corporate duty-of-care obligations.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.1":{"id":"9.1","summary":"Coordinates multi-agent workflows as a single callable pipeline (search_to_price, book_to_ticket, full_booking, etc.)","className":"OrchestratorAgent","input":"`workflow` -- workflow name\n`input` -- workflow input data\n`options?` -- `stop_on_error?`, `timeout_ms?`","output":"`workflow` -- workflow name\n`status` -- `'completed' | 'failed' | 'partial'`\n`steps` -- per-step results (agent ID, status, duration, output/error)\n`total_duration_ms`\n`final_output?` -- last step output","usage":"Accepts injectable `StepExecutor` for testing without real agent imports. Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Multi-agent workflow coordination. Defines named workflows (search-to-price, book-to-ticket, full booking, exchange flow, refund flow) as step sequences. Supports conditional steps, parallel execution, error handling (stop/skip/continue), and pipeline building."},"9.2":{"id":"9.2","summary":"RAG over travel knowledge base with BM25 relevance scoring and optional hybrid scoring via injectable EmbeddingProvider","className":"KnowledgeAgent","input":"`operation` -- `'query' | 'index_document' | 'list_topics' | 'get_document'`\nQuery: query string, topic filter, max results\nIndex: document ID, title, content, tags, topic","output":"`results?` -- ranked results with relevance score, excerpt, full content\n`document?` -- specific document\n`topics?` -- available topic list\n`query_time_ms?`","status":"Implemented","purpose":"RAG (Retrieval-Augmented Generation) over the travel knowledge base. Indexes documents by topic, supports BM25 + vector hybrid search with injectable embedding provider.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.3":{"id":"9.3","summary":"Tracks agent health, API latency, error rates, SLA compliance","className":"MonitoringAgent","input":"`operation` -- `'record_metric' | 'get_health' | 'list_alerts' | 'acknowledge_alert' | 'get_sla_report'`\nMetric: agent ID, metric type (latency_ms/error/success/timeout), value\nAlert: alert ID for acknowledgment","output":"`health?` -- agent health (status, p50/p95 latency, error rate, total calls)\n`alerts?` -- alert list with severity and fired timestamp\n`slaReport?` -- availability percent, p95 latency, error count","status":"Implemented","purpose":"Agent health monitoring: latency tracking (p50/p95), error rates, SLA compliance reporting. Records metrics, fires alerts on threshold violations, supports alert acknowledgment.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.4":{"id":"9.4","summary":"Audit trail, PII redaction, GDPR/PCI/IATA compliance","className":"AuditAgent","input":"`operation` -- `'log_event' | 'query_audit_log' | 'flag_compliance_issue' | 'get_compliance_report' | 'redact_pii'`\nEvent: type (agent_decision, data_access, booking_created, etc.), agent ID, user/session ID, payload\nCompliance: issue type, description, severity, affected records","output":"`entry?` -- audit log entry with hash, PII redaction flag, retention days\n`entries?` -- query results\n`issue?` -- flagged compliance issue\n`report?` -- compliance report (events with PII, redaction counts, open issues by severity)\n`redactedPayload?` -- PII-redacted data","status":"Implemented","purpose":"Audit trail logging with SHA-256 payload hashing, PII redaction (credit cards, passports, emails, phone numbers, DOB), GDPR/PCI/IATA compliance issue flagging, and compliance reporting.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.5":{"id":"9.5","summary":"Manages third-party agent extensions and capability discovery","className":"PluginManagerAgent","input":"`operation` -- `'register_plugin' | 'unregister_plugin' | 'list_plugins' | 'get_plugin' | 'discover_capabilities' | 'enable_plugin' | 'disable_plugin'`\nPlugin data: name, version, description, author, capabilities, agent IDs, metadata","output":"`plugin?` -- plugin record\n`plugins?` -- plugin list\n`capabilities?` -- capability-to-plugin mapping\n`message?` -- operation result message","status":"Implemented","purpose":"Third-party agent extension management: register/unregister plugins, enable/disable, capability discovery, and plugin metadata management.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.6":{"id":"9.6","summary":"Aggregates agent execution metrics from the EventStore within a given time window. Identifies degraded agents","className":"PerformanceAuditAgent","status":"Implemented","purpose":"Aggregates agent execution metrics from the EventStore within a given time window and identifies degraded agents. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"9.7":{"id":"9.7","summary":"Analyses routing decisions and outcomes from the EventStore within a given time window","className":"RoutingAuditAgent","status":"Implemented","purpose":"Analyses routing decisions and outcomes from the EventStore within a given time window. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"9.8":{"id":"9.8","summary":"Accepts performance and routing audit reports and produces deterministic recommendations","className":"RecommendationAgent","status":"Implemented","purpose":"Accepts performance and routing audit reports and produces deterministic recommendations. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"9.9":{"id":"9.9","summary":"Queries EventStore events, computes metrics against configurable thresholds, and produces alerts","className":"AlertAgent","status":"Implemented","purpose":"Queries EventStore events, computes metrics against configurable thresholds, and produces alerts. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"20.1":{"id":"20.1","summary":"Multi-source hotel availability search across GDS hotel segments, direct APIs, and channel manager feeds","className":"HotelSearchAggregatorAgent","input":"`destination` -- city name, airport code, or coordinates\n`checkIn` -- ISO date string (YYYY-MM-DD)\n`checkOut` -- ISO date string (YYYY-MM-DD)\n`rooms` -- number of rooms needed\n`adults` -- number of adult guests per room\n`children?` -- number of child guests per room\n`starRating?` -- minimum star rating filter\n`maxRatePerNight?` -- maximum nightly rate filter (decimal string)\n`currency?` -- ISO 4217 currency for rate filtering/display\n`rateType?` -- rate type filter\n`chainPreference?` -- chain code (e.g., `\"MC\"` for Marriott)\n`timeoutMs?` -- per-adapter timeout in milliseconds (default: 5000)\n`adapterIds?` -- specific adapter IDs to query (all if omitted)","output":"`properties` -- raw hotel results from all sources (NOT deduplicated)\n`totalResults` -- total result count across all adapters\n`adapterResults` -- per-adapter summary (ID, name, count, response time, timeout/error)\n`partialResults` -- true if some adapters timed out or errored\n`searchId` -- unique search ID for tracing","usage":"const agent = new HotelSearchAggregatorAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    destination: 'New York',\n    checkIn: '2026-06-01',\n    checkOut: '2026-06-03',\n    rooms: 1,\n    adults: 2,\n  },\n});\n// result.data.totalResults => 45\n// result.data.partialResults => false","status":"Implemented","purpose":"Multi-source hotel availability search across GDS hotel segments, direct APIs (Amadeus Hotel, Hotelbeds, Duffel Stays), and channel manager feeds. Returns raw, unmerged results from all connected sources. Supports injectable `HotelSourceAdapter` for plugging in custom sources."},"20.2":{"id":"20.2","summary":"Identifies duplicate properties from multi-source results and merges them into canonical records","className":"PropertyDeduplicationAgent","input":"`properties` -- raw hotel results from Agent 20.1\n`thresholds?` -- custom merge thresholds\n`autoMerge` -- score above which properties are auto-merged (default: 0.85)\n`review` -- score above which properties are flagged for review (default: 0.65)","output":"`canonical` -- canonical property records (one per physical property)\n`mergeLog` -- full audit trail of merge/separate decisions (property IDs, score, decision type, score breakdown)\n`stats` -- summary (input count, output count, auto-merged, review-flagged, separated)","usage":"const agent = new PropertyDeduplicationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { properties: rawResults },\n});\n// result.data.stats.inputCount => 45\n// result.data.stats.outputCount => 28\n// result.data.stats.autoMerged => 12","status":"Implemented","purpose":"Takes raw multi-source hotel results from Agent 20.1 and identifies duplicate properties (40-60% of multi-source results are duplicates). Merges them into canonical property records using weighted scoring: Jaro-Winkler name similarity (0.3), normalized address Levenshtein (0.2), Haversine coordinate proximity (0.25), chain code match (0.15), and star rating match (0.1)."},"20.3":{"id":"20.3","summary":"Standardizes hotel content (room types, amenity names, descriptions, photos) into a consistent OTAIP taxonomy","className":"ContentNormalizationAgent","input":"`properties` -- canonical property records from Agent 20.2","output":"`properties` -- normalized property content records, each containing:\n`canonicalId` -- pass-through from 20.2\n`property` -- original canonical property\n`normalizedRoomTypes` -- room types mapped to OTAIP taxonomy\n`normalizedAmenities` -- amenities mapped to OTAIP taxonomy\n`scoredPhotos` -- scored and categorized photos (category, quality score, primary flag)\n`unmappedRoomTypes` -- raw room types that could not be normalized\n`unmappedAmenities` -- raw amenity strings that could not be normalized\n`stats` -- totals for properties, mapped/unmapped room types, mapped/unmapped amenities","usage":"const agent = new ContentNormalizationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { properties: canonicalProperties },\n});\n// result.data.stats.totalRoomTypesMapped => 84\n// result.data.stats.totalAmenitiesUnmapped => 3","status":"Implemented","purpose":"Standardizes hotel content (room types, amenity names, photos) into a consistent OTAIP taxonomy for comparison and display. Maps raw room types from each source to the normalized taxonomy, merges amenities via union merge, and scores/categorizes photos."},"20.4":{"id":"20.4","summary":"Compares rates for the same canonical property across all sources, identifies best available rate, detects rate parity violations","className":"RateComparisonAgent","input":"`properties` -- canonical properties with source results containing rates\n`currency?` -- preferred currency for display (default: USD)\n`nights?` -- number of nights for the stay (default: 1)","output":"`comparisons` -- per-property rate comparison, each containing:\n`canonicalId` -- canonical property ID\n`propertyName` -- property name\n`rates` -- all rates sorted by total cost (lowest first), with full cost breakdown (room charges, mandatory fees, taxes, grand total)\n`bestByRateType` -- best rate per rate type\n`parity` -- rate parity analysis (at parity flag, lowest/highest source, spread percentage)\n`totalProperties` -- total properties compared\n`parityViolations` -- count of properties with rate parity violations","usage":"const agent = new RateComparisonAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { properties: canonicalProperties, nights: 2 },\n});\n// result.data.comparisons[0].rates[0].totalCost.grandTotal => { amount: '289.00', currency: 'USD' }\n// result.data.parityViolations => 3","status":"Implemented","purpose":"Compares rates for the same canonical property across all sources, identifies best available rate per rate type, and detects rate parity violations (>2% spread between lowest and highest source). Includes ALL mandatory fees (resort fees, destination fees, taxes) in total cost breakdown."},"20.5":{"id":"20.5","summary":"Executes hotel bookings with three-layer confirmation code system (CRS, PMS, Channel)","className":"HotelBookingAgent","input":"`operation` -- `'book' | 'verify_rate' | 'get_booking'`\n`bookingRequest?` -- required for `book`/`verify_rate`:\n`canonicalPropertyId` -- from Agent 20.2\n`rateId` -- from Agent 20.4\n`source` -- hotel source to book through\n`checkIn` / `checkOut` -- ISO date strings\n`rooms` -- number of rooms\n`guest` -- guest details (name, email, phone, loyalty info)\n`paymentModel` -- payment model\n`specialRequests?` -- free text\n`bookingId?` -- required for `get_booking`","output":"`success` -- whether the operation succeeded\n`booking?` -- booking record (ID, three-layer confirmation codes, status, total charged, payment model, virtual card info, cancellation policy/deadline, guest, original request)\n`error?` -- error message if failed\n`rateChanged?` -- whether rate changed between search and booking\n`newRate?` -- new rate if changed","usage":"const agent = new HotelBookingAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    operation: 'book',\n    bookingRequest: {\n      canonicalPropertyId: 'canon-001',\n      rateId: 'rate-001',\n      source: 'amadeus_hotel',\n      checkIn: '2026-06-01',\n      checkOut: '2026-06-03',\n      rooms: 1,\n      guest: { firstName: 'John', lastName: 'Smith', email: 'john@example.com' },\n      paymentModel: 'merchant',\n    },\n  },\n});\n// result.data.booking?.confirmation.crs => \"CRS-ABC123\"","status":"Implemented","purpose":"Executes hotel bookings through the optimal source. Manages the full booking flow from rate verification through confirmation, including three-layer confirmation codes (CRS, PMS, channel). Supports VCN (Virtual Card Number) payment with dual folio requirements."},"20.6":{"id":"20.6","summary":"Post-booking changes: free modifications, date changes (cancel/rebook), cancellations with penalty calculation, no-show processing","className":"HotelModificationAgent","input":"`operation` -- `'modify' | 'cancel' | 'check_penalty' | 'process_no_show'`\n`bookingId` -- existing booking ID\n`modifications?` -- free modifications (guest name, bed type, smoking preference, special requests, accessibility needs, guest count)\n`dateChange?` -- new check-in / check-out dates (triggers cancel/rebook)\n`bookedAt?` -- booking timestamp for California 24hr rule check\n`cancellationPolicy?` -- current cancellation policy\n`checkInDate?` -- for deadline calculations\n`nightlyRate?` -- nightly rate from booking record (penalty base)","output":"`success` -- whether the operation succeeded\n`classification` -- `'free_modification' | 'cancel_rebook_required' | 'not_modifiable'`\n`isFreeMod` -- whether this is a free modification\n`penalty?` -- penalty calculation (amount, type, deadline, free window flag, California rule flag)\n`rebookRequired` -- whether a rebook is needed (for date changes)\n`newBookingId?` -- updated confirmation codes (for successful modifications)\n`message` -- error or status message","usage":"const agent = new HotelModificationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    operation: 'cancel',\n    bookingId: 'BK-001',\n    cancellationPolicy: { type: 'free_cancellation', deadline: '2026-05-30T00:00:00Z' },\n    checkInDate: '2026-06-01',\n    bookedAt: '2026-04-01T10:00:00Z',\n  },\n});\n// result.data.classification => \"free_modification\"\n// result.data.penalty?.isWithinFreeWindow => true","status":"Implemented","purpose":"Handles post-booking changes: free modifications (guest name, bed type, special requests), date changes (which require cancel/rebook -- NOT modifications), cancellations with penalty calculation, and no-show processing. Enforces California 24-hour cancellation rule where applicable."},"20.7":{"id":"20.7","summary":"Cross-checks CRS-to-PMS booking data to detect discrepancies before guest arrival","className":"ConfirmationVerificationAgent","input":"`operation` -- `'verify' | 'check_pms_sync' | 'batch_verify'`\n`bookingId` -- booking ID to verify\n`confirmation` -- three-layer confirmation codes from booking\n`crsData` -- CRS-side booking data (confirmation code, guest name, dates, room type, rates, status)\n`pmsData?` -- PMS-side booking data (may be missing if PMS hasn't synced yet)\n`guest` -- guest details for name verification\n`hoursUntilCheckin?` -- hours until check-in (for escalation urgency)\n`batchBookingIds?` -- additional booking IDs (for `batch_verify`)","output":"`verified` -- whether verification passed with no critical issues\n`discrepancies` -- all detected discrepancies (field, CRS value, PMS value, severity, message)\n`escalationRequired` -- whether human/agent escalation is needed\n`escalationReasons` -- why escalation is needed (pms_code_missing, rate_mismatch, date_mismatch, guest_name_mismatch, waitlist_status, tentative_status, room_type_mismatch, multiple_discrepancies)\n`verifiedAt` -- verification timestamp\n`message` -- summary message","usage":"const agent = new ConfirmationVerificationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    operation: 'verify',\n    bookingId: 'BK-001',\n    confirmation: { crs: 'CRS-ABC', pms: 'PMS-123', channel: 'CH-456' },\n    crsData: {\n      confirmationCode: 'CRS-ABC',\n      guestName: 'SMITH/JOHN',\n      checkIn: '2026-06-01',\n      checkOut: '2026-06-03',\n      roomType: 'King Standard',\n      nightlyRate: { amount: '189.00', currency: 'USD' },\n      totalRate: { amount: '378.00', currency: 'USD' },\n      status: 'confirmed',\n    },\n    guest: { firstName: 'John', lastName: 'Smith' },\n  },\n});\n// result.data.verified => true\n// result.data.discrepancies.length => 0","status":"Implemented","purpose":"Cross-checks CRS and PMS booking data to detect discrepancies before guest arrival. Escalates missing PMS codes, waitlist/tentative status, rate/date mismatches. PMS sync can take 1-4 hours; delays beyond 24 hours trigger escalation."},"20.8":{"id":"20.8","summary":"Thin typed wrapper around Hotelbeds Activities search for route→fill orchestration and product-layer activity_search mapping.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"20.9":{"id":"20.9","summary":"Thin typed wrapper around Hotelbeds Transfers search for route→fill orchestration.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."}}}</script>
   <script>
     const payload = JSON.parse(document.getElementById('graph-data').textContent);
     const graph = payload.graph;
diff --git a/docs/agents/stage-1-search.md b/docs/agents/stage-1-search.md
index 2ff11d1..5d7723c 100644
--- a/docs/agents/stage-1-search.md
+++ b/docs/agents/stage-1-search.md
@@ -15,6 +15,7 @@ Flight availability search, schedule lookup, connection validation, fare shoppin
 Queries distribution adapters in parallel, normalizes, deduplicates, filters, and sorts flight availability offers.
 
 **Input (`AvailabilitySearchInput`):**
+
 - `origin` -- origin airport/city IATA code
 - `destination` -- destination airport/city IATA code
 - `departure_date` -- ISO 8601 date
@@ -30,6 +31,7 @@ Queries distribution adapters in parallel, normalizes, deduplicates, filters, an
 - `sources?` -- specific adapter names to query
 
 **Output (`AvailabilitySearchOutput`):**
+
 - `offers` -- deduplicated, filtered, sorted `SearchOffer[]`
 - `total_raw_offers` -- count before deduplication
 - `source_status` -- per-adapter query status (success, count, error, response time)
@@ -48,6 +50,7 @@ Queries distribution adapters in parallel, normalizes, deduplicates, filters, an
 Flight schedule lookup with SSIM operating day parsing, codeshare detection, and connection discovery.
 
 **Input (`ScheduleLookupInput`):**
+
 - `origin` -- airport IATA code
 - `destination` -- airport IATA code
 - `date` -- ISO 8601 date
@@ -57,6 +60,7 @@ Flight schedule lookup with SSIM operating day parsing, codeshare detection, and
 - `include_connections?` -- discover connecting options (default: false)
 
 **Output (`ScheduleLookupOutput`):**
+
 - `flights` -- `ScheduledFlight[]` (carrier, flight number, times, duration, schedule, codeshare info)
 - `connections` -- `ConnectionOption[]` (two-leg connections with timing)
 - `operates_on_date` -- whether any flights operate on the requested date
@@ -69,9 +73,12 @@ Flight schedule lookup with SSIM operating day parsing, codeshare detection, and
 **Class:** `ConnectionBuilder`
 **Status:** Implemented
 
-Validates connections against MCT (Minimum Connection Time) rules, scores connection quality, and checks interline agreements.
+Validates connections against MCT (Minimum Connecting Time) rules, scores connection quality, and checks interline agreements.
+
+MCT authority: **IATA SSIM Chapter 8** + **PSC Resolution 765** (`docs/knowledge-base/mct.md`). Curated rows live under `data/reference/mct/`. Resolution hierarchy: carrier override → airport+terminal → airport → **fail-closed** (no invented global/airport-constant table).
 
 **Input (`ConnectionBuilderInput`):**
+
 - `arriving_segment` -- `FlightSegment` (from `@otaip/core`)
 - `departing_segment` -- `FlightSegment`
 - `connection_airport` -- IATA 3-letter code
@@ -79,7 +86,8 @@ Validates connections against MCT (Minimum Connection Time) rules, scores connec
 - `is_interline?` -- different carriers
 
 **Output (`ConnectionBuilderOutput`):**
-- `validation` -- MCT check result (valid, available/required minutes, buffer, applied rule)
+
+- `validation` -- MCT check result (valid, available/required minutes or null when unavailable, buffer, applied rule)
 - `quality` -- connection quality score 0-1 with factor breakdown
 - `interline` -- interline agreement check (if different carriers)
 - `warnings` -- connection warnings
@@ -95,12 +103,14 @@ Validates connections against MCT (Minimum Connection Time) rules, scores connec
 Multi-source fare comparison with fare basis decoding, class mapping, branded fare family grouping, and passenger type pricing.
 
 **Input (`FareShoppingInput`):**
+
 - `origin`, `destination`, `departure_date`, `passengers` -- same as availability search
 - `cabin_class?`, `currency?`, `sources?` -- filters
 - `decode_fare_basis?` -- decode fare basis codes (default: true)
 - `group_by_fare_family?` -- group by basic/standard/flex/premium (default: true)
 
 **Output (`FareShoppingOutput`):**
+
 - `fares` -- `FareOffer[]` sorted by price, each with decoded fare basis, class info, fare family, passenger pricing
 - `fare_families` -- grouped by family with cheapest/most expensive
 - `total_fares` -- count
@@ -119,12 +129,14 @@ Multi-source fare comparison with fare basis decoding, class mapping, branded fa
 Searches for available ancillaries (baggage, seats, meals, lounge, Wi-Fi, priority) via an injectable adapter.
 
 **Input (`AncillaryShoppingInput`):**
+
 - `segments` -- flight segments (origin, destination, flight number, date, carrier)
 - `passengers` -- passenger references with type (ADT/CHD/INF)
 - `pnrRef?` -- PNR reference
 - `requestedCategories?` -- filter by category (BAGGAGE, SEAT, MEAL, etc.)
 
 **Output (`AncillaryShoppingOutput`):**
+
 - `ancillaries` -- `AncillaryOffer[]` with RFIC/RFISC codes, pricing, availability
 - `notSupportedByAdapter` -- true if no adapter configured
 - `currency` -- pricing currency
@@ -140,12 +152,14 @@ Searches for available ancillaries (baggage, seats, meals, lounge, Wi-Fi, priori
 Aggregates search results from multiple adapters with deduplication, price comparison, and ranking.
 
 **Input (`MultiSourceInput`):**
+
 - `results` -- `AdapterSearchResult[]` (adapter name, flights, errors, response time)
 - `deduplicationStrategy` -- `'keep_cheapest' | 'keep_all' | 'keep_first'`
 - `rankBy` -- `'price' | 'duration' | 'stops'`
 - `maxResults?` -- limit output count
 
 **Output (`MultiSourceOutput`):**
+
 - `flights` -- `NormalizedFlight[]` with sources, lowest price, all prices across adapters
 - `totalRaw` -- raw count before dedup
 - `totalAfterDedup` -- final count
@@ -164,11 +178,13 @@ Car rental search (and, pending a deferred car-only migration, hotel) via plugga
 **Routing ownership:** hotel search intent is owned by Hotel Search Aggregator (20.1) for all hotel queries -- standalone or within a trip. 1.7 owns car rental; it may compose with 20.1 for a combined hotel+car trip but does not own hotel intent. Route hotel queries to 20.1.
 
 **Input (`HotelCarSearchInput`):**
+
 - `operation` -- `'searchHotels' | 'searchCars'`
 - `hotel?` -- hotel search params (destination, dates, rooms, adults, star rating, max rate)
 - `car?` -- car search params (pickup/dropoff location and times, category, driver age)
 
 **Output (`HotelCarSearchOutput`):**
+
 - `hotelResults?` -- hotel offers with rate, room type, cancellation policy
 - `carResults?` -- car offers with category, supplier, daily/total rate, features
 
@@ -183,10 +199,12 @@ Car rental search (and, pending a deferred car-only migration, hotel) via plugga
 Natural language travel query understanding with injectable LLM provider. Parses user queries into structured search parameters.
 
 **Input (`TravelAdvisorInput`):**
+
 - `query` -- natural language travel query
 - `travelerContext?` -- preferences (cabin, budget, preferred airlines, passenger counts)
 
 **Output (`TravelAdvisorOutput`):**
+
 - `searchParameters` -- extracted origin, destination, dates, trip type, cabin, passengers, flexible dates
 - `summary` -- natural language summary of interpreted query
 - `intent` -- `'flight_search' | 'hotel_search' | 'destination_recommendation' | 'price_check' | 'trip_planning' | 'unknown'`
@@ -205,10 +223,12 @@ Natural language travel query understanding with injectable LLM provider. Parses
 Deterministic offer evaluation engine. Scores and ranks flight offers based on traveler profile, constraints, and configurable scoring weights.
 
 **Input (`OfferEvaluatorRequest`):**
+
 - `offers` -- `EvaluatorOffer[]` with price, itinerary (segments, duration, connections)
 - `constraints?` -- latest arrival, prefer direct, max connections, price ceiling, preferred/blacklisted carriers
 - `profile?` -- `'BUSINESS_TIME_CRITICAL' | 'BUSINESS_PRICE_CONSTRAINED' | 'LEISURE' | 'CORPORATE_POLICY' | 'CUSTOM'`
 - `weights?` -- custom scoring weights (time_buffer, price, connection_quality, journey_duration)
 
 **Output (`OfferEvaluatorResponse`):**
+
 - Scored and ranked offers with structured explanation for LLM translation
diff --git a/docs/knowledge-base/mct.md b/docs/knowledge-base/mct.md
new file mode 100644
index 0000000..23cab43
--- /dev/null
+++ b/docs/knowledge-base/mct.md
@@ -0,0 +1,53 @@
+# Minimum Connecting Time (MCT) — Domain Knowledge
+
+Authoritative sources for Connection Builder (Agent 1.3):
+
+- **IATA SSIM Chapter 8** — Presentation, Application and Transfer of Minimum Connecting Time (MCT) data
+- **IATA PSC Resolution 765** — administration of MCTs; must be observed by ticketing and reservations outlets and automated reservations systems
+- **IATA Minimum Connecting Time User Guide v1.1** — carrier filing / exception process and Record Type 2 mapping  
+  https://www.iata.org/contentassets/638f0938b3dd451b872a1d8357755421/minimum-connecting-time-user-guide_version-1.1.pdf
+
+Do **not** invent MCT minutes from “industry folklore,” airport-constant tables, great-circle/haversine distance, or a fake global default table. Real MCT is **carrier-filed** (via data aggregators such as OAG/Cirium), optionally with airport/terminal specificity, and distributed under SSIM Ch.8.
+
+## Definition (passenger)
+
+Shortest time interval required to transfer a passenger and luggage from one flight to a connecting flight at a specific location or metropolitan area (SSIM Ch.8 / PSC Res 765 context in the User Guide).
+
+## Connection status codes (SSIM)
+
+| Code | Meaning                       |
+| ---- | ----------------------------- |
+| `DD` | Domestic → Domestic           |
+| `DI` | Domestic → International      |
+| `ID` | International → Domestic      |
+| `II` | International → International |
+
+## Resolution hierarchy (most specific wins)
+
+Application order for this platform (aligned with the issue #141 sketch and SSIM “most specific filing wins” practice). Template field order in the carrier submission form is **not** the same as hierarchy priority (User Guide §III).
+
+1. **Carrier override** — arriving carrier + departing carrier (+ optional flight ranges, equipment, codeshare indicators) at the connection airport, for a connection status (`DD`/`DI`/`ID`/`II`), optionally scoped to terminals.
+2. **Airport + terminal** — station MCT when a terminal change (or explicit arrival/departure terminal pair) is known.
+3. **Airport** — station-level MCT for the connection status when no carrier-pair row matches.
+4. **Fail-closed** — if no curated row matches, **do not invent** an IATA global constant. Treat MCT as unavailable and reject the connection for shopping/validation.
+
+Carrier overrides are **required** for trustworthy online builds at hubs. Airport-level rows are only added when taken from a real SSIM/aggregator extract or another cited public source — never as guessed “hub constants.”
+
+## Online vs interline
+
+- **Online** — same marketing/operating carrier context (same carrier pair in the override, typically `arriving_carrier === departing_carrier`).
+- **Interline** — different carriers. SSIM filings often need **concurrence** of the receiving carrier for exceptions (User Guide §II). Alliance membership alone does **not** prove an interline MCT exists.
+
+Starter dataset rows are online-only unless an interline row is explicitly checked in with a source citation.
+
+## Starter dataset location
+
+`data/reference/mct/` — curated JSON only. Incomplete by design. Prefer a few validated hub/carrier rows over a fake global table.
+
+## Open DOMAIN_QUESTIONs
+
+1. **DQ-MCT-1 (online vs interline MCT application):** For a given carrier pair at a station, when both online and interline filings exist (or only airport-level filings), which exact SSIM match order and concurrence rules does OTAIP use in production shopping? Unpublished carrier exceptions must not be invented.
+2. **DQ-MCT-2 (DI vs ID / mixed):** How should Agent 1.3 map “mixed” domestic↔international legs to `DI` vs `ID` when country-of-airport data is incomplete?
+3. **DQ-MCT-3 (codeshare):** When marketing carriers differ but the operating carrier is the same, do we apply operating-carrier MCT (User Guide examples on operating carrier / codeshare indicator) by default?
+4. **DQ-MCT-4 (ingestion):** How will full SSIM Ch.8 / aggregator MCT feeds be ingested into `data/reference/mct/` (OAG vs Cirium, refresh cadence, suppression records)?
+5. **DQ-MCT-5 (bags / special passenger):** `has_checked_bags` and other passenger conditions — which optional SSIM MCT elements apply, and from which filing?
diff --git a/packages/agents/search/src/connection-builder/__tests__/connection-builder.test.ts b/packages/agents/search/src/connection-builder/__tests__/connection-builder.test.ts
index 390ac3f..6e5b5fa 100644
--- a/packages/agents/search/src/connection-builder/__tests__/connection-builder.test.ts
+++ b/packages/agents/search/src/connection-builder/__tests__/connection-builder.test.ts
@@ -2,10 +2,11 @@
  * Connection Builder — Unit Tests
  *
  * Agent 1.3: MCT validation, connection quality scoring, interline checking.
+ * MCT authority: SSIM Ch.8 + PSC Res 765 — fail-closed when no curated row.
  */
 
 import { describe, it, expect, beforeAll, afterAll } from 'vitest';
-import { ConnectionBuilder } from '../index.js';
+import { ConnectionBuilder, resolveMct, getMctDataDir } from '../index.js';
 import type { FlightSegment } from '@otaip/core';
 
 let agent: ConnectionBuilder;
@@ -37,6 +38,12 @@ function makeSegment(
 }
 
 describe('Connection Builder', () => {
+  describe('MCT dataset', () => {
+    it('loads curated dataset from data/reference/mct/', () => {
+      expect(getMctDataDir()).toMatch(/data[/\\]reference[/\\]mct$/);
+    });
+  });
+
   describe('MCT validation — valid connections', () => {
     it('validates a valid domestic connection at ORD (UA→UA)', async () => {
       const result = await agent.execute({
@@ -61,12 +68,12 @@ describe('Connection Builder', () => {
 
       expect(result.data.validation.valid).toBe(true);
       expect(result.data.validation.available_minutes).toBe(90);
-      // UA→UA at ORD domestic = 50 minutes (carrier-specific)
+      // UA→UA at ORD domestic = 50 minutes (carrier-specific curated row)
       expect(result.data.validation.required_mct_minutes).toBe(50);
       expect(result.data.validation.buffer_minutes).toBe(40);
     });
 
-    it('validates a valid connection at ATL (short MCT)', async () => {
+    it('fail-closes when no curated MCT row exists (ATL DL→DL)', async () => {
       const result = await agent.execute({
         data: {
           arriving_segment: makeSegment({
@@ -83,37 +90,60 @@ describe('Connection Builder', () => {
         },
       });
 
-      // ATL domestic default = 45 min, available = 60 min
-      expect(result.data.validation.valid).toBe(true);
-      expect(result.data.validation.required_mct_minutes).toBe(45);
+      // No invented ATL airport constant — fail-closed
+      expect(result.data.validation.valid).toBe(false);
+      expect(result.data.validation.required_mct_minutes).toBeNull();
+      expect(result.data.validation.applied_rule).toContain('mct-unavailable');
+      expect(result.data.warnings.some((w) => w.includes('fail-closed'))).toBe(true);
     });
   });
 
   describe('MCT validation — invalid connections', () => {
-    it('flags connection below MCT', async () => {
+    it('flags connection below carrier MCT (UA→UA ORD)', async () => {
+      // Carrier MCT = 50; available = 30 → below MCT
       const result = await agent.execute({
         data: {
           arriving_segment: makeSegment({
-            carrier: 'AA',
-            arrival_time: '2025-06-15T10:00:00-04:00',
+            carrier: 'UA',
+            arrival_time: '2025-06-15T10:00:00-05:00',
             departure_time: '2025-06-15T08:00:00-04:00',
           }),
           departing_segment: makeSegment({
-            carrier: 'AA',
-            departure_time: '2025-06-15T10:30:00-04:00',
+            carrier: 'UA',
+            departure_time: '2025-06-15T10:30:00-05:00',
             arrival_time: '2025-06-15T13:00:00-07:00',
           }),
-          connection_airport: 'JFK',
+          connection_airport: 'ORD',
         },
       });
 
-      // JFK domestic default = 75 min, available = 30 min
       expect(result.data.validation.valid).toBe(false);
       expect(result.data.validation.available_minutes).toBe(30);
+      expect(result.data.validation.required_mct_minutes).toBe(50);
       expect(result.data.validation.buffer_minutes).toBeLessThan(0);
     });
 
-    it('includes warning for invalid connection', async () => {
+    it('includes warning for connection below MCT', async () => {
+      const result = await agent.execute({
+        data: {
+          arriving_segment: makeSegment({
+            carrier: 'UA',
+            arrival_time: '2025-06-15T10:00:00-05:00',
+            departure_time: '2025-06-15T08:00:00-04:00',
+          }),
+          departing_segment: makeSegment({
+            carrier: 'UA',
+            departure_time: '2025-06-15T10:30:00-05:00',
+            arrival_time: '2025-06-15T13:00:00-07:00',
+          }),
+          connection_airport: 'ORD',
+        },
+      });
+
+      expect(result.data.warnings.some((w) => w.includes('below MCT'))).toBe(true);
+    });
+
+    it('fail-closes (invalid) when no curated row — does not invent JFK airport MCT', async () => {
       const result = await agent.execute({
         data: {
           arriving_segment: makeSegment({
@@ -130,7 +160,9 @@ describe('Connection Builder', () => {
         },
       });
 
-      expect(result.data.warnings.some((w) => w.includes('below MCT'))).toBe(true);
+      expect(result.data.validation.valid).toBe(false);
+      expect(result.data.validation.required_mct_minutes).toBeNull();
+      expect(result.data.validation.applied_rule).toContain('mct-unavailable');
     });
   });
 
@@ -154,9 +186,11 @@ describe('Connection Builder', () => {
 
       expect(result.data.validation.applied_rule).toContain('carrier-specific');
       expect(result.data.validation.required_mct_minutes).toBe(50);
+      expect(result.metadata!['mct_level']).toBe('carrier_override');
     });
 
-    it('uses airport default MCT for DL→DL at ORD (no carrier-specific rule)', async () => {
+    it('prefers carrier-specific row over airport-level absence (DL→DL at ORD fail-closed)', async () => {
+      // No DL@ORD carrier row and no airport-rules → fail-closed (not a fake airport default)
       const result = await agent.execute({
         data: {
           arriving_segment: makeSegment({
@@ -173,11 +207,13 @@ describe('Connection Builder', () => {
         },
       });
 
-      expect(result.data.validation.applied_rule).toContain('airport default');
-      expect(result.data.validation.required_mct_minutes).toBe(60);
+      expect(result.data.validation.applied_rule).toContain('mct-unavailable');
+      expect(result.data.validation.required_mct_minutes).toBeNull();
+      expect(result.data.validation.valid).toBe(false);
+      expect(result.metadata!['mct_level']).toBe('unavailable');
     });
 
-    it('falls back to IATA default for unknown airport', async () => {
+    it('fail-closes for unknown airport — no invented IATA global default', async () => {
       const result = await agent.execute({
         data: {
           arriving_segment: makeSegment({
@@ -194,8 +230,21 @@ describe('Connection Builder', () => {
         },
       });
 
-      expect(result.data.validation.applied_rule).toContain('IATA default');
-      expect(result.data.validation.required_mct_minutes).toBe(60);
+      expect(result.data.validation.applied_rule).toContain('mct-unavailable');
+      expect(result.data.validation.required_mct_minutes).toBeNull();
+      expect(result.data.validation.valid).toBe(false);
+    });
+
+    it('resolveMct: carrier override beats empty airport table', () => {
+      const carrier = resolveMct('ORD', 'domestic', 'unknown', 'UA', 'UA');
+      expect(carrier.resolved).toBe(true);
+      expect(carrier.level).toBe('carrier_override');
+      expect(carrier.minutes).toBe(50);
+
+      const other = resolveMct('ORD', 'domestic', 'unknown', 'DL', 'DL');
+      expect(other.resolved).toBe(false);
+      expect(other.level).toBe('unavailable');
+      expect(other.minutes).toBeNull();
     });
   });
 
@@ -221,7 +270,7 @@ describe('Connection Builder', () => {
       expect(result.data.quality.factors.length).toBeGreaterThan(0);
     });
 
-    it('scores an invalid connection as 0 for time factor', async () => {
+    it('scores fail-closed MCT as 0 for time factor', async () => {
       const result = await agent.execute({
         data: {
           arriving_segment: makeSegment({
@@ -241,6 +290,7 @@ describe('Connection Builder', () => {
       const timeFactor = result.data.quality.factors.find((f) => f.name === 'connection_time');
       expect(timeFactor).toBeDefined();
       expect(timeFactor!.score).toBe(0);
+      expect(timeFactor!.description).toContain('fail-closed');
     });
 
     it('warns about very long connections', async () => {
@@ -329,6 +379,9 @@ describe('Connection Builder', () => {
       expect(result.data.interline!.same_alliance).toBe(true);
       expect(result.data.interline!.alliance).toBe('star_alliance');
       expect(result.data.interline!.interline_allowed).toBe(true);
+      // No interline MCT row curated → fail-closed (DQ-MCT-1)
+      expect(result.data.validation.applied_rule).toContain('mct-unavailable');
+      expect(result.data.validation.valid).toBe(false);
     });
 
     it('detects different-alliance interline', async () => {
diff --git a/packages/agents/search/src/connection-builder/connection-scorer.ts b/packages/agents/search/src/connection-builder/connection-scorer.ts
index aeb7254..6e80626 100644
--- a/packages/agents/search/src/connection-builder/connection-scorer.ts
+++ b/packages/agents/search/src/connection-builder/connection-scorer.ts
@@ -12,7 +12,8 @@ import type { QualityFactor } from './types.js';
 
 export interface ScoringInput {
   availableMinutes: number;
-  requiredMctMinutes: number;
+  /** Null when MCT unresolved (fail-closed) — connection_time scores 0 */
+  requiredMctMinutes: number | null;
   sameCarrier: boolean;
   sameAlliance: boolean;
   terminalChange: boolean;
@@ -59,14 +60,17 @@ export function scoreConnection(input: ScoringInput): {
   const factors: QualityFactor[] = [];
 
   // Factor 1: Connection time (weight: 0.4)
-  const timeScore = scoreConnectionTime(input.availableMinutes, input.requiredMctMinutes);
+  const mct = input.requiredMctMinutes;
+  const timeScore = mct === null ? 0 : scoreConnectionTime(input.availableMinutes, mct);
   factors.push({
     name: 'connection_time',
     score: timeScore,
     description:
-      timeScore === 0
-        ? `${input.availableMinutes}min < ${input.requiredMctMinutes}min MCT - illegal connection`
-        : `${input.availableMinutes}min available, ${input.requiredMctMinutes}min required`,
+      mct === null
+        ? 'MCT unavailable (fail-closed) — no curated SSIM row'
+        : timeScore === 0
+          ? `${input.availableMinutes}min < ${mct}min MCT - illegal connection`
+          : `${input.availableMinutes}min available, ${mct}min required`,
   });
 
   // Factor 2: Same carrier (weight: 0.25)
diff --git a/packages/agents/search/src/connection-builder/index.ts b/packages/agents/search/src/connection-builder/index.ts
index 40d6462..5e17a39 100644
--- a/packages/agents/search/src/connection-builder/index.ts
+++ b/packages/agents/search/src/connection-builder/index.ts
@@ -4,6 +4,9 @@
  * Validates connections against MCT rules, scores connection quality,
  * and checks interline agreements.
  *
+ * MCT authority: IATA SSIM Chapter 8 + PSC Resolution 765
+ * (see docs/knowledge-base/mct.md). Missing curated rows fail closed.
+ *
  * Implements the base Agent interface from @otaip/core.
  */
 
@@ -46,7 +49,8 @@ export class ConnectionBuilder implements Agent<ConnectionBuilderInput, Connecti
     const airport = data.connection_airport.toUpperCase().trim();
 
     // Determine connection type
-    // TODO: [NEEDS DOMAIN INPUT] Real domestic/international classification using country data
+    // TODO: DOMAIN_QUESTION: DQ-MCT-2 — real domestic/international classification
+    //   using country data; DI vs ID for mixed.
     const sameCarrier = arriving.carrier === departing.carrier;
     const connectionType: ConnectionType = data.is_interline ? 'international' : 'domestic';
 
@@ -59,7 +63,7 @@ export class ConnectionBuilder implements Agent<ConnectionBuilderInput, Connecti
     const departureTime = new Date(departing.departure_time).getTime();
     const availableMinutes = Math.round((departureTime - arrivalTime) / 60000);
 
-    // Resolve MCT
+    // Resolve MCT (fail-closed when no curated row)
     const mct = resolveMct(
       airport,
       connectionType,
@@ -68,8 +72,9 @@ export class ConnectionBuilder implements Agent<ConnectionBuilderInput, Connecti
       departing.carrier,
     );
 
-    const valid = availableMinutes >= mct.minutes;
-    const bufferMinutes = availableMinutes - mct.minutes;
+    const valid = mct.resolved && mct.minutes !== null && availableMinutes >= mct.minutes;
+    const bufferMinutes =
+      mct.resolved && mct.minutes !== null ? availableMinutes - mct.minutes : null;
 
     const validation = {
       valid,
@@ -102,12 +107,16 @@ export class ConnectionBuilder implements Agent<ConnectionBuilderInput, Connecti
 
     // Build warnings
     const warnings: string[] = [];
-    if (!valid) {
+    if (!mct.resolved) {
+      warnings.push(
+        `MCT unavailable at ${airport} for ${arriving.carrier}→${departing.carrier} (${connectionType}) — fail-closed (no curated SSIM row).`,
+      );
+    } else if (!valid && mct.minutes !== null) {
       warnings.push(
         `Connection time ${availableMinutes}min is below MCT ${mct.minutes}min at ${airport}.`,
       );
     }
-    if (bufferMinutes >= 0 && bufferMinutes < 15) {
+    if (bufferMinutes !== null && bufferMinutes >= 0 && bufferMinutes < 15) {
       warnings.push('Very tight connection — less than 15 minutes buffer over MCT.');
     }
     if (availableMinutes > 360) {
@@ -131,6 +140,7 @@ export class ConnectionBuilder implements Agent<ConnectionBuilderInput, Connecti
         agent_version: this.version,
         connection_airport: airport,
         mct_rule: mct.rule,
+        mct_level: mct.level,
       },
     };
   }
@@ -192,3 +202,6 @@ export type {
   TerminalChangeType,
   MctRule,
 } from './types.js';
+
+export type { MctResolution, MctHierarchyLevel } from './mct-data.js';
+export { resolveMct, checkInterline, getMctDataDir } from './mct-data.js';
diff --git a/packages/agents/search/src/connection-builder/mct-data.ts b/packages/agents/search/src/connection-builder/mct-data.ts
index a14e411..3d5671a 100644
--- a/packages/agents/search/src/connection-builder/mct-data.ts
+++ b/packages/agents/search/src/connection-builder/mct-data.ts
@@ -1,208 +1,237 @@
 /**
- * Minimum Connection Time (MCT) data.
+ * Minimum Connecting Time (MCT) resolution.
  *
- * 4-level hierarchy:
- * 1. Carrier-specific at airport
- * 2. Airport + connection type + terminal change
- * 3. Airport + connection type
- * 4. IATA global defaults
+ * Authority: IATA SSIM Chapter 8 + PSC Resolution 765.
+ * Domain KB: docs/knowledge-base/mct.md
+ * Dataset: data/reference/mct/
  *
- * TODO: [FUTURE] Load from data/reference/mct/ JSON files.
- * TODO: [NEEDS DOMAIN INPUT] Carrier-specific MCT overrides.
+ * Hierarchy (most specific wins):
+ *   1. Carrier override at airport (optional terminals)
+ *   2. Airport + terminal change
+ *   3. Airport + connection type / status
+ *   4. Fail-closed — no invented IATA global table
+ *
+ * // TODO: DOMAIN_QUESTION: DQ-MCT-1 online vs interline MCT application when
+ * //   unpublished carrier exceptions / concurrence rules are not in the dataset.
+ * // TODO: DOMAIN_QUESTION: DQ-MCT-2 DI vs ID mapping for mixed connections.
+ * // TODO: DOMAIN_QUESTION: DQ-MCT-3 codeshare / operating-carrier MCT default.
+ * // TODO: DOMAIN_QUESTION: DQ-MCT-4 full SSIM/aggregator feed ingestion path.
+ * // TODO: DOMAIN_QUESTION: DQ-MCT-5 bags / optional SSIM passenger MCT elements.
  */
 
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import type { ConnectionType, TerminalChangeType } from './types.js';
 
-// ---------------------------------------------------------------------------
-// IATA global defaults
-// ---------------------------------------------------------------------------
+export type MctHierarchyLevel = 'carrier_override' | 'airport_terminal' | 'airport' | 'unavailable';
 
-const IATA_DEFAULTS: Record<ConnectionType, number> = {
-  domestic: 60,
-  international: 90,
-  mixed: 90,
-};
+export interface MctResolution {
+  /** Minutes when resolved; null when fail-closed (no curated row). */
+  minutes: number | null;
+  /** Human-readable applied rule label */
+  rule: string;
+  /** Hierarchy level that produced the result */
+  level: MctHierarchyLevel;
+  /** False → fail-closed; caller must not invent a substitute MCT */
+  resolved: boolean;
+}
+
+interface CarrierOverrideRow {
+  airport: string;
+  arriving_carrier: string;
+  departing_carrier: string;
+  connection_status?: string;
+  connection_type: ConnectionType;
+  scope?: 'online' | 'interline';
+  minutes: number;
+  arrival_terminal?: string | null;
+  departure_terminal?: string | null;
+}
+
+interface AirportRuleRow {
+  airport: string;
+  connection_type: ConnectionType;
+  connection_status?: string;
+  minutes: number;
+  /** When true, row applies only when terminal change is `different`. */
+  terminal_change?: boolean;
+  arrival_terminal?: string | null;
+  departure_terminal?: string | null;
+}
+
+interface CarrierOverridesFile {
+  overrides: CarrierOverrideRow[];
+}
+
+interface AirportRulesFile {
+  rules: AirportRuleRow[];
+}
 
 // ---------------------------------------------------------------------------
-// Airport-specific MCT rules (top 20 hubs)
+// Dataset load (curated JSON under data/reference/mct/)
 // ---------------------------------------------------------------------------
 
-interface AirportMctConfig {
-  default_domestic: number;
-  default_international: number;
-  terminal_change_domestic?: number;
-  terminal_change_international?: number;
-  carrier_rules?: {
-    arriving?: string;
-    departing?: string;
-    connection_type: ConnectionType;
-    minutes: number;
-  }[];
+function candidateMctDirs(): string[] {
+  const dirs: string[] = [];
+  const cwdDir = join(process.cwd(), 'data', 'reference', 'mct');
+  dirs.push(cwdDir);
+
+  // When tests or tools run from a package cwd, walk up looking for the monorepo dataset.
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    let cursor = here;
+    for (let i = 0; i < 8; i++) {
+      dirs.push(join(cursor, 'data', 'reference', 'mct'));
+      const parent = dirname(cursor);
+      if (parent === cursor) break;
+      cursor = parent;
+    }
+  } catch {
+    // import.meta.url unavailable in unlikely hosts — cwd candidate remains.
+  }
+
+  return dirs;
 }
 
-const AIRPORT_MCT: Record<string, AirportMctConfig> = {
-  JFK: {
-    default_domestic: 75,
-    default_international: 120,
-    terminal_change_domestic: 120,
-    terminal_change_international: 150,
-  },
-  LAX: {
-    default_domestic: 75,
-    default_international: 120,
-    terminal_change_domestic: 120,
-    terminal_change_international: 150,
-  },
-  ORD: {
-    default_domestic: 60,
-    default_international: 90,
-    terminal_change_domestic: 90,
-    terminal_change_international: 120,
-    carrier_rules: [{ arriving: 'UA', departing: 'UA', connection_type: 'domestic', minutes: 50 }],
-  },
-  ATL: {
-    default_domestic: 45,
-    default_international: 90,
-  },
-  DFW: {
-    default_domestic: 60,
-    default_international: 90,
-  },
-  DEN: {
-    default_domestic: 55,
-    default_international: 90,
-  },
-  SFO: {
-    default_domestic: 60,
-    default_international: 90,
-    terminal_change_domestic: 90,
-    terminal_change_international: 120,
-  },
-  LHR: {
-    default_domestic: 60,
-    default_international: 90,
-    terminal_change_domestic: 120,
-    terminal_change_international: 150,
-  },
-  CDG: {
-    default_domestic: 60,
-    default_international: 90,
-    terminal_change_domestic: 120,
-    terminal_change_international: 150,
-  },
-  FRA: {
-    default_domestic: 45,
-    default_international: 60,
-  },
-  AMS: {
-    default_domestic: 40,
-    default_international: 50,
-  },
-  NRT: {
-    default_domestic: 60,
-    default_international: 90,
-    terminal_change_domestic: 90,
-    terminal_change_international: 120,
-  },
-  HND: {
-    default_domestic: 60,
-    default_international: 90,
-    terminal_change_domestic: 120,
-    terminal_change_international: 150,
-  },
-  DXB: {
-    default_domestic: 60,
-    default_international: 90,
-  },
-  SIN: {
-    default_domestic: 45,
-    default_international: 60,
-  },
-  HKG: {
-    default_domestic: 45,
-    default_international: 75,
-  },
-  ICN: {
-    default_domestic: 60,
-    default_international: 90,
-  },
-  IST: {
-    default_domestic: 60,
-    default_international: 90,
-  },
-  DOH: {
-    default_domestic: 45,
-    default_international: 60,
-  },
-  MIA: {
-    default_domestic: 60,
-    default_international: 90,
-  },
-};
+function readJsonIfPresent<T>(path: string): T | null {
+  if (!existsSync(path)) return null;
+  return JSON.parse(readFileSync(path, 'utf-8')) as T;
+}
+
+function loadDataset(): {
+  carrierOverrides: CarrierOverrideRow[];
+  airportRules: AirportRuleRow[];
+  dataDir: string | null;
+} {
+  for (const dir of candidateMctDirs()) {
+    const carrierPath = join(dir, 'carrier-overrides.json');
+    const airportPath = join(dir, 'airport-rules.json');
+    if (!existsSync(carrierPath)) continue;
+
+    const carriers = readJsonIfPresent<CarrierOverridesFile>(carrierPath);
+    const airports = readJsonIfPresent<AirportRulesFile>(airportPath);
+    return {
+      carrierOverrides: carriers?.overrides ?? [],
+      airportRules: airports?.rules ?? [],
+      dataDir: dir,
+    };
+  }
+
+  // No dataset on disk → empty tables → every resolve is fail-closed.
+  return { carrierOverrides: [], airportRules: [], dataDir: null };
+}
+
+const DATASET = loadDataset();
+
+/** Test / tooling hook to inspect which directory was loaded. */
+export function getMctDataDir(): string | null {
+  return DATASET.dataDir;
+}
 
 // ---------------------------------------------------------------------------
-// MCT resolution (4-level hierarchy)
+// MCT resolution
 // ---------------------------------------------------------------------------
 
+function carriersMatch(
+  row: CarrierOverrideRow,
+  arrivingCarrier: string,
+  departingCarrier: string,
+): boolean {
+  return (
+    row.arriving_carrier.toUpperCase() === arrivingCarrier.toUpperCase() &&
+    row.departing_carrier.toUpperCase() === departingCarrier.toUpperCase()
+  );
+}
+
+function scopeAllows(
+  row: CarrierOverrideRow,
+  arrivingCarrier: string,
+  departingCarrier: string,
+): boolean {
+  const online = arrivingCarrier.toUpperCase() === departingCarrier.toUpperCase();
+  if (row.scope === 'online' && !online) return false;
+  if (row.scope === 'interline' && online) return false;
+  return true;
+}
+
+/**
+ * Resolve MCT for a connection.
+ * Returns resolved=false (fail-closed) when no curated row matches.
+ * Never invents airport constants or a global default table.
+ */
 export function resolveMct(
   airport: string,
   connectionType: ConnectionType,
   terminalChange: TerminalChangeType,
   arrivingCarrier?: string,
   departingCarrier?: string,
-): { minutes: number; rule: string } {
-  const config = AIRPORT_MCT[airport];
+): MctResolution {
+  const station = airport.toUpperCase().trim();
 
   // Level 1: Carrier-specific at airport
-  if (config?.carrier_rules && arrivingCarrier && departingCarrier) {
-    for (const rule of config.carrier_rules) {
-      if (
-        rule.arriving === arrivingCarrier &&
-        rule.departing === departingCarrier &&
-        rule.connection_type === connectionType
-      ) {
-        return {
-          minutes: rule.minutes,
-          rule: `carrier-specific: ${arrivingCarrier}→${departingCarrier} at ${airport}`,
-        };
-      }
+  if (arrivingCarrier && departingCarrier) {
+    for (const row of DATASET.carrierOverrides) {
+      if (row.airport.toUpperCase() !== station) continue;
+      if (row.connection_type !== connectionType) continue;
+      if (!carriersMatch(row, arrivingCarrier, departingCarrier)) continue;
+      if (!scopeAllows(row, arrivingCarrier, departingCarrier)) continue;
+
+      // TODO: DOMAIN_QUESTION: DQ-MCT-3 — when override lists arrival/departure
+      //   terminals (or codeshare operating carrier), exact match rules vs unknown terminals.
+      return {
+        minutes: row.minutes,
+        rule: `carrier-specific: ${arrivingCarrier}→${departingCarrier} at ${station}`,
+        level: 'carrier_override',
+        resolved: true,
+      };
     }
+
+    // // TODO: DOMAIN_QUESTION: DQ-MCT-1 — unpublished interline / concurrence exceptions
+    // // must not be synthesized when carriers differ and no interline row exists.
   }
 
   // Level 2: Airport + connection type + terminal change
-  if (config && terminalChange === 'different') {
-    const tcMinutes =
-      connectionType === 'domestic'
-        ? config.terminal_change_domestic
-        : config.terminal_change_international;
-
-    if (tcMinutes !== undefined) {
+  if (terminalChange === 'different') {
+    for (const row of DATASET.airportRules) {
+      if (row.airport.toUpperCase() !== station) continue;
+      if (row.connection_type !== connectionType) continue;
+      if (row.terminal_change !== true) continue;
       return {
-        minutes: tcMinutes,
-        rule: `airport terminal-change: ${airport} ${connectionType}`,
+        minutes: row.minutes,
+        rule: `airport terminal-change: ${station} ${connectionType}`,
+        level: 'airport_terminal',
+        resolved: true,
       };
     }
   }
 
-  // Level 3: Airport + connection type
-  if (config) {
-    const minutes =
-      connectionType === 'domestic' ? config.default_domestic : config.default_international;
+  // Level 3: Airport + connection type (no terminal-change requirement)
+  for (const row of DATASET.airportRules) {
+    if (row.airport.toUpperCase() !== station) continue;
+    if (row.connection_type !== connectionType) continue;
+    if (row.terminal_change === true) continue;
     return {
-      minutes,
-      rule: `airport default: ${airport} ${connectionType}`,
+      minutes: row.minutes,
+      rule: `airport default: ${station} ${connectionType}`,
+      level: 'airport',
+      resolved: true,
     };
   }
 
-  // Level 4: IATA global defaults
+  // Level 4: Fail-closed — do not invent a global MCT table or airport constants.
   return {
-    minutes: IATA_DEFAULTS[connectionType],
-    rule: `IATA default: ${connectionType}`,
+    minutes: null,
+    rule:
+      `mct-unavailable: no curated row for ${station} ${connectionType}` +
+      (arrivingCarrier && departingCarrier ? ` (${arrivingCarrier}→${departingCarrier})` : ''),
+    level: 'unavailable',
+    resolved: false,
   };
 }
 
 // ---------------------------------------------------------------------------
-// Alliance data (for interline checks)
+// Alliance data (for interline checks — agreement existence, not MCT minutes)
 // ---------------------------------------------------------------------------
 
 const ALLIANCE_MAP: Record<string, string> = {
@@ -248,6 +277,11 @@ const ALLIANCE_MAP: Record<string, string> = {
   VN: 'skyteam',
 };
 
+/**
+ * Alliance / rough interline allowance check.
+ * // TODO: DOMAIN_QUESTION: Real interline agreement database (distinct from MCT filings).
+ * // Alliance membership ≠ MCT concurrence (SSIM User Guide §II).
+ */
 export function checkInterline(
   carrier1: string,
   carrier2: string,
@@ -263,8 +297,6 @@ export function checkInterline(
     return { interlineAllowed: true, sameAlliance: true, alliance: alliance1 };
   }
 
-  // For now, assume all major carriers have interline agreements
-  // TODO: [NEEDS DOMAIN INPUT] Real interline agreement database
   const hasAnyAlliance = !!(alliance1 || alliance2);
   return {
     interlineAllowed: hasAnyAlliance,
diff --git a/packages/agents/search/src/connection-builder/types.ts b/packages/agents/search/src/connection-builder/types.ts
index a4630f2..bce6503 100644
--- a/packages/agents/search/src/connection-builder/types.ts
+++ b/packages/agents/search/src/connection-builder/types.ts
@@ -39,15 +39,18 @@ export interface MctRule {
 }
 
 export interface ConnectionValidation {
-  /** Whether the connection meets MCT requirements */
+  /** Whether the connection meets MCT requirements (false when MCT unresolved / fail-closed) */
   valid: boolean;
   /** Available connection time in minutes */
   available_minutes: number;
-  /** Required MCT in minutes */
-  required_mct_minutes: number;
-  /** Buffer time (available - required) */
-  buffer_minutes: number;
-  /** MCT rule that was applied */
+  /**
+   * Required MCT in minutes, or null when no curated MCT row matched (fail-closed).
+   * Never invent a substitute minutes value when null.
+   */
+  required_mct_minutes: number | null;
+  /** Buffer time (available - required); null when MCT unresolved */
+  buffer_minutes: number | null;
+  /** MCT rule that was applied (includes mct-unavailable:… when fail-closed) */
   applied_rule: string;
   /** Connection type classification */
   connection_type: ConnectionType;