diff --git a/CLAUDE.md b/CLAUDE.md
index 4d412f0..73b9e9c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -107,9 +107,9 @@ When building agents, Claude Code will attempt to rationalize inventing domain l
 
 | Rationalization | Required response |
 |---|---|
-| "NUC conversion uses a standard multiply-and-round pattern, I'll apply banker's rounding" | STOP. IATA rounding rules are currency-specific and are NOT standard banker's rounding. Check KB for the IATA rounding table. Do not implement any rounding without the exact rule for the currency in question. |
-| "ROE rates change periodically, I'll use a hardcoded value for now as a placeholder" | STOP. ROE values are published by IATA monthly. Hardcoded ROE values will produce wrong fares immediately. Surface as DOMAIN_QUESTION: how will ROE data be ingested? |
-| "TPM/MPM mileage data isn't available, I'll approximate the distance using haversine between airports" | STOP. TPM is NOT great-circle distance. TPM is published by IATA/SITA and includes routing-specific values that differ from haversine. HIP/BHC/CTM checks depend on exact TPM. Do not approximate. Surface as DOMAIN_QUESTION. |
+| "NUC conversion uses a standard multiply-and-round pattern, I'll apply banker's rounding" | STOP. IATA Resolution **024d** uses per-currency units with **HX** (round up) or **NX** (nearest). Banker's / half-to-even is not a substitute. Check KB `docs/knowledge-base/fare-construction-data-dependencies.md`. |
+| "ROE rates change periodically, I'll use a hardcoded value for now as a placeholder" | STOP. **IROE** values are published by IATA monthly for **fare construction** (Res 024c). Hardcoded rates produce wrong fares immediately. Pass licensed rates via `data_sources.iroe` or surface DOMAIN_INPUT_REQUIRED. Do not commit proprietary IROE files. Do **not** use IROE for ticket-tax / payment FX — that is **ICER** ([xrates](https://www.iata.org/en/services/finance/xrates/)). |
+| "TPM/MPM mileage data isn't available, I'll approximate the distance using haversine between airports" | STOP. TPM is NOT great-circle distance. TPM is published by IATA ([TPM Manual](https://www.iata.org/en/publications/manuals/mileage/ticketed-point-mileage-tpm/)). HIP/BHC/CTM depend on exact TPM. Fail closed — never approximate. |
 | "The HIP check logic seems straightforward — just compare the fare to the sum of sector fares" | STOP. HIP/BHC/CTM each have different comparison rules, directionality requirements, and NUC-vs-local-currency considerations. Check KB for the exact ATPCO comparison logic before implementing. |
 | "For multi-sector itineraries, I'll prorate the fare evenly across segments" | STOP. IATA fare proration uses TPM-based proportional allocation, not equal division. Check KB for the exact proration formula. |
 | "I don't have the fare construction rules for this specific routing, I'll use the published fare directly" | STOP. Published fares and constructed fares are different pricing mechanisms. Do not conflate them. Surface as DOMAIN_QUESTION: which fare type applies? |
diff --git a/agents.graph.json b/agents.graph.json
index d4a67a5..5b508b7 100644
--- a/agents.graph.json
+++ b/agents.graph.json
@@ -160,7 +160,7 @@
       "id": "2.2",
       "name": "Fare Construction",
       "stage": "pricing",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "contract_status": "active",
       "has_contract": false,
       "source_path": "packages/agents/pricing/src/fare-construction/index.ts"
diff --git a/agents.manifest.json b/agents.manifest.json
index 49b1205..725539f 100644
--- a/agents.manifest.json
+++ b/agents.manifest.json
@@ -2334,7 +2334,7 @@
       "id": "2.2",
       "name": "Fare Construction",
       "stage": "pricing",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "contract_status": "active",
       "has_contract": false,
       "source_path": "packages/agents/pricing/src/fare-construction/index.ts"
diff --git a/docs/agent-map.html b/docs/agent-map.html
index 293cb43..be7c8e4 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.1.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 ROE selection","output":"`total_nuc` -- sum of components + surcharges\n`roe` -- ROE used for conversion\n`local_amount` -- final amount after IATA rounding\n`currency` -- selling currency\n`mileage_checks` -- per-component TPM/MPM validation\n`mileage_exceeded` -- whether total mileage exceeds MPM\n`mileage_surcharge` -- surcharge details if applicable\n`hip_check`, `bhc_check`, `ctm_check` -- mileage system checks\n`audit_trail` -- full calculation audit","status":"Implemented","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, 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>
     const payload = JSON.parse(document.getElementById('graph-data').textContent);
     const graph = payload.graph;
diff --git a/docs/agents/stage-2-pricing.md b/docs/agents/stage-2-pricing.md
index c9f703b..09d696e 100644
--- a/docs/agents/stage-2-pricing.md
+++ b/docs/agents/stage-2-pricing.md
@@ -36,24 +36,22 @@ Parses ATPCO fare rules (categories 1-20) into human-readable structured format
 **Class:** `FareConstruction`
 **Status:** Implemented
 
-NUC x ROE fare construction with mileage validation, HIP/BHC/CTM checks, surcharges, and IATA rounding. All financial math uses `decimal.js`.
+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`.
+
+Licensed 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.
+
+**KB:** `docs/knowledge-base/fare-construction-data-dependencies.md`
 
 **Input (`FareConstructionInput`):**
 - `journey_type` -- `'OW' | 'RT' | 'CT'` (one-way, round-trip, circle-trip)
 - `components` -- fare components (origin, destination, carrier, fare basis, NUC amount)
 - `selling_currency` -- ISO 4217 currency
-- `point_of_sale?` -- country for ROE selection
-
-**Output (`FareConstructionOutput`):**
-- `total_nuc` -- sum of components + surcharges
-- `roe` -- ROE used for conversion
-- `local_amount` -- final amount after IATA rounding
-- `currency` -- selling currency
-- `mileage_checks` -- per-component TPM/MPM validation
-- `mileage_exceeded` -- whether total mileage exceeds MPM
-- `mileage_surcharge` -- surcharge details if applicable
-- `hip_check`, `bhc_check`, `ctm_check` -- mileage system checks
-- `audit_trail` -- full calculation audit
+- `point_of_sale?` -- country for IROE selection context
+- `data_sources?` -- licensed `{ iroe, rounding_024d, mileage }` (required for a constructed fare)
+
+**Output (`FareConstructionResult`):**
+- Success (`FareConstructionOutput`): `total_nuc`, `iroe` (alias `roe`), `local_amount` after 024d, `rounding_method` (`HX`|`NX`), published `mileage_checks`, HIP/BHC/CTM sketches, `audit_trail`
+- Or `DomainInputRequired` when licensed data is missing
 
 ---
 
@@ -65,6 +63,8 @@ NUC x ROE fare construction with mileage validation, HIP/BHC/CTM checks, surchar
 
 Per-segment tax computation with exemption engine, ~30 countries, ~50 tax codes, currency conversion. All financial math uses `decimal.js`.
 
+**FX note:** Ticket-tax / payment currency conversion must use licensed **ICER** (IATA Consolidated Exchange Rate, daily) — **not** IROE. IROE is fare construction only (Res 024c / Agent 2.2). See [IATA Exchange Rates](https://www.iata.org/en/services/finance/xrates/) and `docs/knowledge-base/fare-construction-data-dependencies.md`. The bundled `currency_conversions` map is demo-only; production must fail closed on missing ICER.
+
 **Input (`TaxCalculationInput`):**
 - `segments` -- itinerary segments (origin/destination airports and countries, carrier, cabin class, base fare NUC)
 - `passenger_type` -- `'adult' | 'child' | 'infant' | 'crew' | 'diplomatic'`
diff --git a/docs/knowledge-base/fare-construction-data-dependencies.md b/docs/knowledge-base/fare-construction-data-dependencies.md
new file mode 100644
index 0000000..654b116
--- /dev/null
+++ b/docs/knowledge-base/fare-construction-data-dependencies.md
@@ -0,0 +1,202 @@
+# Fare Construction — Data Dependencies (Agent 2.2)
+
+Authoritative contracts for NUC × IROE construction (Resolution **024c**),
+published TPM/MPM, and IATA Resolution **024d** currency rounding. This
+document describes **what to ingest**, not the proprietary table contents.
+
+Do **not** commit IROE rates, ICER rates, 024d rounding tables, or TPM/MPM
+datasets to this repository. Licensed feeds belong in deployment secrets /
+private object storage and are passed into agents at runtime.
+
+**IATA exchange-rate products (do not conflate):**
+[IATA Exchange Rates](https://www.iata.org/en/services/finance/xrates/)
+
+| Product | Cadence | Use in OTAIP |
+|---|---|---|
+| **IROE** (IATA Rates of Exchange) | Monthly (5-day average ending on the 10th) | **Fare / rate construction only** — NUC ↔ local under Res **024c**. Agent 2.2. |
+| **ICER** (IATA Consolidated Exchange Rate) | Daily (BSR-style) | **Payment / tax / fee** conversion to alternate currencies of payment. Agent 2.3 tax aggregation and ticketing payment FX — **not** IROE. |
+
+---
+
+## Formula (high level)
+
+1. Construct / sum fare components in **NUC** (Neutral Unit of Construction).
+2. Convert total NUC → local currency of sale / COC using **IROE**
+   (IATA Rate of Exchange, Res **024c**): `local = NUC × IROE`.
+3. Apply **Resolution 024d** rounding (method **HX** or **NX**, per currency
+   unit published in the IROE / 024d table).
+4. Mileage-system checks (HIP / BHC / CTM) and MPM excess surcharges require
+   **published TPM** (and MPM) — never great-circle / haversine substitutes.
+
+Ticket taxes and payment-currency conversion are **out of scope for IROE**.
+Those paths ingest **ICER** (see below).
+
+---
+
+## Explicit bans
+
+| Ban | Why |
+|---|---|
+| **No hardcoded IROE** in production code or shipped packages | IROE is published monthly by IATA; hardcoded rates go stale immediately and produce wrong local-currency fares. |
+| **No IROE as ticket-tax / payment FX** | Tax and payment conversions use **ICER**, not IROE. Do not wire Agent 2.3 (or payment) to `data_sources.iroe`. |
+| **No haversine / great-circle as TPM** | TPM is a published ticketed-point mileage from the IATA TPM Manual (non-stop / through scheduled services). It is **not** geodesic distance. HIP/BHC/CTM and MPM excess depend on exact published TPM. |
+| **No banker's rounding as “IATA rounding”** | Resolution **024d** uses per-currency units with methods **HX** (round up to next higher unit) or **NX** (round to nearest unit). IEEE banker's / half-to-even rounding is not a substitute. |
+| **No equal-sector proration as TPM proration** | IATA proration uses TPM-based allocation, not equal split. |
+| **No inventing HIP / BHC / CTM comparison rules** | Those checks need filed intermediate fares / directionality / CT minima from ATPCO / carrier filings. Surface `DOMAIN_INPUT_REQUIRED` / `missing_inputs` instead. |
+
+---
+
+## Data dependency 1 — IROE (IATA Rate of Exchange) — fare construction only
+
+| Field | Contract |
+|---|---|
+| **What** | Per-currency conversion factor: NUC → local currency (and inverse for published local → NUC). |
+| **Resolution context** | Fare construction conversion under Res **024c**; rounding units/methods under Res **024d**. |
+| **Source** | [IATA Rates of Exchange (IROE)](https://www.iata.org/en/services/finance/xrates/) — monthly electronic data file. |
+| **Cadence** | Monthly (average of five banking days ending on the 10th). |
+| **Ingestion shape** | `Record<ISO4217, decimal-string>` plus optional `effective_date` / period metadata at the feed boundary (`FareConstructionInput.data_sources.iroe`). |
+| **Fail-closed** | If the selling currency has no IROE entry → return `DomainInputRequired` with `missing: ['iroe_table_entry:{CCY}']`. **Never** fall back to `1.0`. |
+| **Not for** | Ticket-tax aggregation, payment-currency conversion, interline billing FX. |
+
+Contributor note: purchase / subscribe via IATA (IROE). Do not vendor the
+rate file into git.
+
+---
+
+## Data dependency — ICER (tax / payment FX) — not Agent 2.2
+
+| Field | Contract |
+|---|---|
+| **What** | Daily exchange rates (sometimes called BSR) for converting fares, **taxes**, and **fees** to alternate currencies of payment. |
+| **Source** | [IATA Consolidated Exchange Rate (ICER)](https://www.iata.org/en/services/finance/xrates/) — official industry source for international payment currency conversions used in pricing and ticketing. |
+| **Cadence** | Daily electronic data file. |
+| **Consumers** | Agent 2.3 Tax Calculation (and payment / ticketing FX paths). **Must not** consume IROE. |
+| **Fail-closed** | Missing ICER for a currency pair → `DomainInputRequired` / halt conversion. **Never** invent rates or silently use `1.0`. |
+| **Commit to git?** | **No** proprietary ICER files. |
+
+Agent 2.3 currently still has a demo `currency_conversions` map marked
+TEST/DEMO ONLY, with `DOMAIN_QUESTION` markers to ingest ICER and fail
+closed. Do not “fix” that map by pointing it at IROE.
+
+---
+
+## Data dependency 2 — Resolution 024d rounding table
+
+| Field | Contract |
+|---|---|
+| **What** | Per-currency **rounding unit** and **method**. |
+| **Methods** | **HX** — round up to the next higher unit (unless already exact). **NX** — round to the nearest unit. |
+| **Source** | IATA Resolution **024d** (Currency Names, Codes, Rounding Units…) as carried with IROE / Passenger Standards Conference Tariffs materials. |
+| **Ingestion shape** | `Record<ISO4217, { unit: decimal-string; method: 'HX' \| 'NX' }>`. |
+| **Fail-closed** | If the selling currency has no 024d entry → `DomainInputRequired` with `missing: ['rounding_024d:{CCY}']`. **No** default `0.01` unit. **No** banker's rounding fallback. |
+
+The engine may implement the **mechanical** meaning of HX/NX once the
+unit + method are supplied. It must **not** invent which currency uses
+which unit or method.
+
+---
+
+## Data dependency 3 — TPM / MPM
+
+| Field | Contract |
+|---|---|
+| **What** | **TPM** — Ticketed Point Mileage per coupon / city pair. **MPM** — Maximum Permitted Mileage for the fare component / routing. |
+| **TPM definition** | Distance covered by one flight coupon, based on non-stop or through scheduled air services (IATA TPM Manual). Official source covers 65,000+ city pairs; updates monthly (`.txt` / API for system integration). |
+| **Reference** | [IATA Ticketed Point Mileage (TPM)](https://www.iata.org/en/publications/manuals/mileage/ticketed-point-mileage-tpm/) — also MPM Manual, City Code Directory (CCD). |
+| **Ingestion shape** | City-pair rows `{ origin, destination, tpm, mpm }` from the licensed TPM/MPM feed (airport or city codes per CCD / multi-airport rules — do not invent). |
+| **Fail-closed** | If any fare component lacks a published TPM (and MPM when excess checks run) → `DomainInputRequired` with `missing: ['tpm:{ORG}-{DST}']` (and/or `mpm:…`). **Never** approximate with haversine. |
+
+Contributor note: license the TPM Manual (and MPM Manual) from IATA.
+Integrate via their `.txt` / API delivery. Do **not** commit proprietary
+mileage tables to this repo.
+
+---
+
+## Fail-closed policy (runtime)
+
+When any of IROE, 024d rounding, or TPM/MPM required for the itinerary is
+absent:
+
+1. Halt fare construction.
+2. Return `DomainInputRequired` (`status: 'DOMAIN_INPUT_REQUIRED'`) listing
+   machine-readable `missing` keys and references to the licensed sources.
+3. Set agent `confidence` to `0` and surface warnings — do not emit a
+   local-currency amount.
+
+Silent approximation is a CLAUDE.md Agent 2.2 violation.
+
+For tax / payment FX, the same fail-closed rule applies to **ICER** (Agent
+2.3+) — independently of IROE.
+
+---
+
+## Minimal interface sketch — HIP / BHC / CTM
+
+These are **mileage-system** checks. Comparison rules are **not**
+implemented here; callers / future work supply filed data and apply the
+published ATPCO / IATA algorithms.
+
+```typescript
+/** Inputs required before HIP can run — do not invent comparison rules. */
+interface HipCheckRequirements {
+  /** Filed NUC fares for every intermediate point pair on the routing. */
+  intermediate_point_fares: Array<{
+    origin: string;
+    destination: string;
+    carrier: string;
+    nuc_amount: string;
+  }>;
+  // TODO: DOMAIN_QUESTION: exact HIP comparison order / directionality /
+  // NUC-vs-local rules per ATPCO Fare Construction guide for this carrier.
+}
+
+/** Inputs required before BHC can run. */
+interface BhcCheckRequirements {
+  /** Geographic / direction analysis for each fare component vs journey. */
+  geographic_direction_analysis: unknown;
+  // TODO: DOMAIN_QUESTION: published BHC directionality rule set for this
+  // journey type — do not use "city revisited" string heuristics.
+}
+
+/** Inputs required before CTM can run (circle trips). */
+interface CtmCheckRequirements {
+  /** Half round-trip / CT minimum fare amounts per component as filed. */
+  circle_trip_minima_nuc: Array<{ component_index: number; ctm_nuc: string }>;
+  // TODO: DOMAIN_QUESTION: CTM measurement and comparison vs constructed
+  // total — carrier / ATPCO specific.
+}
+```
+
+Until those inputs exist, Agent 2.2 reports `detected: false` /
+`applies: false` with `missing_inputs` populated — it does **not** invent
+HIP amounts, backhaul hits, or CT minima.
+
+---
+
+## Licensed sources checklist (contributors)
+
+| Need | Where to obtain (buy / subscribe) | Commit to git? |
+|---|---|---|
+| IROE (fare construction / Res 024c) | [IATA Exchange Rates — IROE](https://www.iata.org/en/services/finance/xrates/) | **No** |
+| ICER (tax / payment FX) | [IATA Exchange Rates — ICER](https://www.iata.org/en/services/finance/xrates/) | **No** |
+| 024d units + HX/NX | Resolution 024d via IATA Passenger Standards / IROE materials | **No** |
+| TPM city-pair mileages | [IATA TPM Manual](https://www.iata.org/en/publications/manuals/mileage/ticketed-point-mileage-tpm/) (`.txt` / API) | **No** |
+| MPM | IATA Maximum Permitted Mileage Manual | **No** |
+| City / multi-airport codes | IATA City Code Directory (CCD) | **No** |
+| HIP intermediate fares | ATPCO fare filings / carrier fare construction data | **No** |
+
+Test fixtures under
+`packages/agents/pricing/src/fare-construction/__tests__/fixtures/` are
+**invented** numbers for unit tests only. They must carry a
+`TEST FIXTURE — do not use in production` banner and must never be loaded
+by the production engine module graph.
+
+---
+
+## Related code
+
+- `packages/agents/pricing/src/fare-construction/` — Agent 2.2 (IROE + 024d + TPM)
+- `packages/agents/pricing/src/tax-calculation/` — Agent 2.3 (ICER for FX; not IROE)
+- `@otaip/core` `DomainInputRequired` / `domainInputRequired`
+- `CLAUDE.md` — Agent 2.2 anti-rationalization guards
+- [IATA Exchange Rates](https://www.iata.org/en/services/finance/xrates/) — IROE vs ICER product split
diff --git a/packages/agents/pricing/src/fare-construction/__tests__/fare-construction.test.ts b/packages/agents/pricing/src/fare-construction/__tests__/fare-construction.test.ts
index 320954a..8c8d01e 100644
--- a/packages/agents/pricing/src/fare-construction/__tests__/fare-construction.test.ts
+++ b/packages/agents/pricing/src/fare-construction/__tests__/fare-construction.test.ts
@@ -1,13 +1,62 @@
 /**
  * Fare Construction — Unit Tests
  *
- * Agent 2.2: NUC × ROE, mileage validation, HIP, BHC, CTM, surcharges, IATA rounding.
- * All amounts verified with decimal.js precision.
+ * Agent 2.2: NUC × IROE, published TPM/MPM, 024d HX/NX, fail-closed hooks.
+ * Fixtures are invented test numbers — not production IROE/TPM.
  */
 
 import { describe, it, expect, beforeAll, afterAll } from 'vitest';
-import { FareConstruction } from '../index.js';
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { Decimal } from 'decimal.js';
+import {
+  FareConstruction,
+  constructFare,
+  apply024dRounding,
+  assertPublishedTpmSource,
+  HAVERSINE_AS_TPM_BANNED,
+  HARDCODED_IROE_BANNED,
+  BANKERS_ROUNDING_AS_IATA_BANNED,
+} from '../index.js';
+import type {
+  FareConstructionDataSources,
+  FareConstructionInput,
+  Rounding024dRule,
+} from '../types.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const FIXTURE = JSON.parse(
+  readFileSync(resolve(__dirname, 'fixtures/test-fare-construction-data.json'), 'utf8'),
+) as {
+  iroe: Record<string, string>;
+  rounding_024d: Record<string, Rounding024dRule>;
+  mileage: FareConstructionDataSources['mileage'];
+};
+
+const TEST_SOURCES: FareConstructionDataSources = {
+  iroe: FIXTURE.iroe,
+  rounding_024d: FIXTURE.rounding_024d,
+  mileage: FIXTURE.mileage,
+};
+
+function makeInput(overrides: Partial<FareConstructionInput> = {}): FareConstructionInput {
+  return {
+    journey_type: 'OW',
+    components: [
+      {
+        origin: 'JFK',
+        destination: 'LHR',
+        carrier: 'UA',
+        fare_basis: 'V14NR',
+        nuc_amount: '450.00',
+      },
+    ],
+    selling_currency: 'USD',
+    data_sources: TEST_SOURCES,
+    ...overrides,
+  };
+}
 
 let agent: FareConstruction;
 
@@ -21,35 +70,134 @@ afterAll(() => {
 });
 
 describe('Fare Construction', () => {
-  describe('One-way (OW) fare construction', () => {
-    it('constructs JFK-LHR OW fare in USD', async () => {
+  describe('Fail-closed: missing licensed data', () => {
+    it('returns DOMAIN_INPUT_REQUIRED when data_sources omitted (no hardcoded IROE)', async () => {
+      const result = await agent.execute({
+        data: makeInput({ data_sources: undefined }),
+      });
+
+      expect('status' in result.data && result.data.status).toBe('DOMAIN_INPUT_REQUIRED');
+      if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
+        expect(result.data.missing).toEqual(
+          expect.arrayContaining([
+            'data_sources.iroe',
+            'data_sources.rounding_024d',
+            'data_sources.mileage',
+          ]),
+        );
+        expect(result.data.description).toContain('No hardcoded');
+      }
+      expect(result.confidence).toBe(0);
+    });
+
+    it('returns DOMAIN_INPUT_REQUIRED for missing IROE currency (no 1.0 fallback)', async () => {
+      const result = await agent.execute({
+        data: makeInput({ selling_currency: 'XYZ' }),
+      });
+
+      expect('status' in result.data && result.data.status).toBe('DOMAIN_INPUT_REQUIRED');
+      if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
+        expect(result.data.missing).toContain('iroe_table_entry:XYZ');
+        expect(result.data.description).toContain('IROE');
+      }
+      expect(result.confidence).toBe(0);
+    });
+
+    it('returns DOMAIN_INPUT_REQUIRED when published TPM is missing (no haversine)', async () => {
       const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
+        data: makeInput({
           components: [
             {
-              origin: 'JFK',
-              destination: 'LHR',
+              origin: 'XXX',
+              destination: 'YYY',
               carrier: 'UA',
-              fare_basis: 'V14NR',
-              nuc_amount: '450.00',
+              fare_basis: 'Y',
+              nuc_amount: '100.00',
             },
           ],
-          selling_currency: 'USD',
-        },
+        }),
       });
 
+      expect('status' in result.data && result.data.status).toBe('DOMAIN_INPUT_REQUIRED');
+      if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
+        expect(result.data.missing).toContain('tpm:XXX-YYY');
+        expect(result.data.description).toContain('haversine');
+        expect(result.data.references.some((r) => r.includes('ticketed-point-mileage-tpm'))).toBe(
+          true,
+        );
+      }
+      expect(result.confidence).toBe(0);
+    });
+
+    it('returns DOMAIN_INPUT_REQUIRED when 024d rounding rule is missing', async () => {
+      const sources: FareConstructionDataSources = {
+        ...TEST_SOURCES,
+        rounding_024d: { ...TEST_SOURCES.rounding_024d },
+      };
+      delete sources.rounding_024d['USD'];
+
+      const result = await agent.execute({
+        data: makeInput({ data_sources: sources }),
+      });
+
+      expect('status' in result.data && result.data.status).toBe('DOMAIN_INPUT_REQUIRED');
+      if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
+        expect(result.data.missing).toContain('rounding_024d:USD');
+        expect(result.data.description).toMatch(/banker|024d/i);
+      }
+    });
+  });
+
+  describe('Explicit bans', () => {
+    it('exports ban constants for haversine, hardcoded IROE, and banker rounding', () => {
+      expect(HAVERSINE_AS_TPM_BANNED).toMatch(/haversine/i);
+      expect(HARDCODED_IROE_BANNED).toMatch(/hardcoded IROE/i);
+      expect(BANKERS_ROUNDING_AS_IATA_BANNED).toMatch(/banker/i);
+    });
+
+    it('assertPublishedTpmSource rejects haversine-labelled sources', () => {
+      expect(() => assertPublishedTpmSource('haversine')).toThrow(/haversine/i);
+      expect(() => assertPublishedTpmSource('great-circle-approx')).toThrow(/haversine/i);
+      expect(() => assertPublishedTpmSource('iata_tpm_manual')).not.toThrow();
+    });
+
+    it('engine module does not import greatCircleDistanceKm / haversine helpers', async () => {
+      const engineSrc = readFileSync(resolve(__dirname, '../fare-engine.ts'), 'utf8');
+      expect(engineSrc).not.toMatch(/greatCircleDistanceKm/);
+      expect(engineSrc).not.toMatch(/haversineDistance/);
+      expect(engineSrc).not.toMatch(/from '@otaip\/core\/.*regulations/);
+      // Must not bundle production IROE/TPM JSON
+      expect(engineSrc).not.toMatch(/roe-rates\.json/);
+      expect(engineSrc).not.toMatch(/mileage-data\.json/);
+      expect(engineSrc).not.toMatch(/rounding-rules\.json/);
+    });
+
+    it('024d NX is not banker’s half-to-even', () => {
+      // 1.25 to unit 1: banker → 2 (even) or 1 depending; half-up NX → 1? 
+      // For amount 2.5 with unit 1: half-up → 3; banker half-to-even → 2.
+      const nx: Rounding024dRule = { unit: '1', method: 'NX' };
+      const rounded = apply024dRounding(new Decimal('2.5'), nx);
+      expect(rounded.toString()).toBe('3'); // half away from zero, NOT banker → 2
+    });
+  });
+
+  describe('NUC × IROE construction', () => {
+    it('constructs JFK-LHR OW fare in USD', async () => {
+      const result = await agent.execute({ data: makeInput() });
+      if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
+        throw new Error('Expected constructed fare');
+      }
       expect(result.data.total_nuc).toBe('450.00');
+      expect(result.data.iroe).toBe('1.000000');
       expect(result.data.roe).toBe('1.000000');
-      // USD ROE=1, so local = NUC = 450.00
       expect(result.data.local_amount).toBe('450');
       expect(result.data.currency).toBe('USD');
+      expect(result.data.rounding_method).toBe('NX');
     });
 
-    it('constructs JFK-LHR OW fare in GBP', async () => {
+    it('constructs JFK-LHR OW fare in GBP with IROE', async () => {
       const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
+        data: makeInput({
           components: [
             {
               origin: 'JFK',
@@ -60,19 +208,19 @@ describe('Fare Construction', () => {
             },
           ],
           selling_currency: 'GBP',
-        },
+        }),
       });
-
-      // NUC 1200 × ROE 0.79365 = GBP 952.38
+      if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
+        throw new Error('Expected constructed fare');
+      }
       const expectedRaw = new Decimal('1200.00').mul('0.793650');
-      expect(result.data.roe).toBe('0.793650');
+      expect(result.data.iroe).toBe('0.793650');
       expect(new Decimal(result.data.local_amount_raw).toFixed(2)).toBe(expectedRaw.toFixed(2));
     });
 
-    it('constructs fare in JPY with correct rounding (round to 1)', async () => {
+    it('applies HX rounding for JPY', async () => {
       const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
+        data: makeInput({
           components: [
             {
               origin: 'SFO',
@@ -83,19 +231,19 @@ describe('Fare Construction', () => {
             },
           ],
           selling_currency: 'JPY',
-        },
+        }),
       });
-
-      // NUC 500 × ROE 149.52 = JPY 74760
+      if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
+        throw new Error('Expected constructed fare');
+      }
       expect(result.data.rounding_unit).toBe('1');
-      // Should be a whole number
+      expect(result.data.rounding_method).toBe('HX');
       expect(result.data.local_amount).toMatch(/^\d+$/);
     });
 
-    it('constructs fare in CHF with 0.05 rounding', async () => {
+    it('applies HX 0.05 rounding for CHF', async () => {
       const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
+        data: makeInput({
           components: [
             {
               origin: 'JFK',
@@ -106,42 +254,36 @@ describe('Fare Construction', () => {
             },
           ],
           selling_currency: 'CHF',
-        },
+        }),
       });
-
+      if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
+        throw new Error('Expected constructed fare');
+      }
       expect(result.data.rounding_unit).toBe('0.05');
-      // Verify rounding: amount should be divisible by 0.05
+      expect(result.data.rounding_method).toBe('HX');
       const amount = new Decimal(result.data.local_amount);
       expect(amount.mod('0.05').eq(0)).toBe(true);
     });
+  });
 
-    it('constructs fare in KRW with 100-unit rounding', async () => {
-      const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
-          components: [
-            {
-              origin: 'JFK',
-              destination: 'LHR',
-              carrier: 'UA',
-              fare_basis: 'Y',
-              nuc_amount: '100.00',
-            },
-          ],
-          selling_currency: 'KRW',
-        },
-      });
+  describe('024d apply024dRounding', () => {
+    it('HX rounds up unless exact', () => {
+      const hx: Rounding024dRule = { unit: '1', method: 'HX' };
+      expect(apply024dRounding(new Decimal('10'), hx).toString()).toBe('10');
+      expect(apply024dRounding(new Decimal('10.01'), hx).toString()).toBe('11');
+    });
 
-      expect(result.data.rounding_unit).toBe('100');
-      const amount = new Decimal(result.data.local_amount);
-      expect(amount.mod('100').eq(0)).toBe(true);
+    it('NX rounds to nearest (half up, not banker)', () => {
+      const nx: Rounding024dRule = { unit: '0.01', method: 'NX' };
+      expect(apply024dRounding(new Decimal('10.004'), nx).toFixed(2)).toBe('10.00');
+      expect(apply024dRounding(new Decimal('10.005'), nx).toFixed(2)).toBe('10.01');
     });
   });
 
-  describe('Round-trip (RT) fare construction', () => {
-    it('constructs JFK-LHR-JFK RT fare', async () => {
+  describe('Round-trip / CT with published mileage', () => {
+    it('constructs RT and records TPM from published data', async () => {
       const result = await agent.execute({
-        data: {
+        data: makeInput({
           journey_type: 'RT',
           components: [
             {
@@ -159,48 +301,21 @@ describe('Fare Construction', () => {
               nuc_amount: '450.00',
             },
           ],
-          selling_currency: 'USD',
-        },
+        }),
       });
-
+      if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
+        throw new Error('Expected constructed fare');
+      }
       expect(result.data.total_nuc).toBe('900.00');
-      expect(result.data.local_amount).toBe('900');
-    });
-
-    it('has mileage checks for each segment', async () => {
-      const result = await agent.execute({
-        data: {
-          journey_type: 'RT',
-          components: [
-            {
-              origin: 'JFK',
-              destination: 'LHR',
-              carrier: 'BA',
-              fare_basis: 'Y',
-              nuc_amount: '600.00',
-            },
-            {
-              origin: 'LHR',
-              destination: 'JFK',
-              carrier: 'BA',
-              fare_basis: 'Y',
-              nuc_amount: '600.00',
-            },
-          ],
-          selling_currency: 'USD',
-        },
-      });
-
       expect(result.data.mileage_checks.length).toBe(2);
-      expect(result.data.mileage_checks[0]!.data_available).toBe(true);
       expect(result.data.mileage_checks[0]!.tpm).toBe(3459);
+      expect(result.data.mileage_checks[0]!.mpm).toBe(3805);
+      expect(result.data.total_mpm).toBe(result.data.total_mph);
     });
-  });
 
-  describe('Circle trip (CT) fare construction', () => {
-    it('constructs JFK-LHR-CDG-JFK CT fare', async () => {
+    it('CT reports CTM missing_inputs instead of inventing CTM=total_nuc', async () => {
       const result = await agent.execute({
-        data: {
+        data: makeInput({
           journey_type: 'CT',
           components: [
             {
@@ -225,161 +340,22 @@ describe('Fare Construction', () => {
               nuc_amount: '480.00',
             },
           ],
-          selling_currency: 'USD',
-        },
-      });
-
-      expect(result.data.total_nuc).toBe('1080.00');
-      expect(result.data.ctm_check.applies).toBe(true);
-    });
-
-    it('CTM not applied for OW journey', async () => {
-      const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
-          components: [
-            {
-              origin: 'JFK',
-              destination: 'LHR',
-              carrier: 'BA',
-              fare_basis: 'Y',
-              nuc_amount: '500.00',
-            },
-          ],
-          selling_currency: 'USD',
-        },
-      });
-
-      expect(result.data.ctm_check.applies).toBe(false);
-    });
-  });
-
-  describe('Mileage exceeded and surcharges', () => {
-    it('detects mileage not exceeded for direct JFK-LHR', async () => {
-      const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
-          components: [
-            {
-              origin: 'JFK',
-              destination: 'LHR',
-              carrier: 'UA',
-              fare_basis: 'Y',
-              nuc_amount: '500.00',
-            },
-          ],
-          selling_currency: 'USD',
-        },
-      });
-
-      expect(result.data.mileage_exceeded).toBe(false);
-      expect(result.data.mileage_surcharge.applies).toBe(false);
-    });
-
-    it('warns when mileage data is unavailable', async () => {
-      const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
-          components: [
-            {
-              origin: 'XXX',
-              destination: 'YYY',
-              carrier: 'UA',
-              fare_basis: 'Y',
-              nuc_amount: '100.00',
-            },
-          ],
-          selling_currency: 'USD',
-        },
-      });
-
-      expect(result.warnings).toBeDefined();
-      expect(result.warnings!.some((w) => w.includes('No mileage data'))).toBe(true);
-    });
-  });
-
-  describe('HIP single-component', () => {
-    it('detects no HIP for simple direct fare', async () => {
-      const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
-          components: [
-            {
-              origin: 'JFK',
-              destination: 'LHR',
-              carrier: 'BA',
-              fare_basis: 'Y',
-              nuc_amount: '500.00',
-            },
-          ],
-          selling_currency: 'USD',
-        },
-      });
-
-      if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
-        throw new Error('Expected normal output');
-      }
-      expect(result.data.hip_check.detected).toBe(false);
-      expect(result.data.hip_check.missing_inputs).toBeUndefined();
-    });
-  });
-
-  describe('BHC detection', () => {
-    it('reports BHC undetected with DOMAIN_INPUT_REQUIRED for multi-component fares', async () => {
-      // Real BHC requires geographic-direction analysis. Simple
-      // city-revisited heuristics were a CLAUDE.md violation and removed.
-      const result = await agent.execute({
-        data: {
-          journey_type: 'CT',
-          components: [
-            {
-              origin: 'JFK',
-              destination: 'LHR',
-              carrier: 'BA',
-              fare_basis: 'Y',
-              nuc_amount: '400.00',
-            },
-            {
-              origin: 'LHR',
-              destination: 'CDG',
-              carrier: 'AF',
-              fare_basis: 'Y',
-              nuc_amount: '100.00',
-            },
-            {
-              origin: 'CDG',
-              destination: 'LHR',
-              carrier: 'BA',
-              fare_basis: 'Y',
-              nuc_amount: '100.00',
-            },
-            {
-              origin: 'LHR',
-              destination: 'JFK',
-              carrier: 'BA',
-              fare_basis: 'Y',
-              nuc_amount: '400.00',
-            },
-          ],
-          selling_currency: 'USD',
-        },
+        }),
       });
-
       if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
-        throw new Error('Expected normal output, got DOMAIN_INPUT_REQUIRED');
+        throw new Error('Expected constructed fare');
       }
-      expect(result.data.bhc_check.detected).toBe(false);
-      expect(result.data.bhc_check.missing_inputs).toBeDefined();
-      expect(result.data.bhc_check.missing_inputs!.length).toBeGreaterThan(0);
-      expect(result.warnings!.some((w) => w.includes('DOMAIN_INPUT_REQUIRED (BHC)'))).toBe(true);
+      expect(result.data.ctm_check.applies).toBe(false);
+      expect(result.data.ctm_check.ctm_nuc).toBeNull();
+      expect(result.data.ctm_check.missing_inputs).toBeDefined();
+      expect(result.warnings!.some((w) => w.includes('DOMAIN_INPUT_REQUIRED (CTM)'))).toBe(true);
     });
   });
 
-  describe('HIP detection', () => {
-    it('reports HIP undetected with DOMAIN_INPUT_REQUIRED for multi-component fares', async () => {
+  describe('HIP / BHC sketches', () => {
+    it('HIP undetected with missing_inputs for multi-component', async () => {
       const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
+        data: makeInput({
           components: [
             {
               origin: 'JFK',
@@ -396,235 +372,67 @@ describe('Fare Construction', () => {
               nuc_amount: '200.00',
             },
           ],
-          selling_currency: 'USD',
-        },
+        }),
       });
       if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
-        throw new Error('Expected normal output, got DOMAIN_INPUT_REQUIRED');
+        throw new Error('Expected constructed fare');
       }
       expect(result.data.hip_check.detected).toBe(false);
-      expect(result.data.hip_check.missing_inputs).toBeDefined();
-      expect(result.warnings!.some((w) => w.includes('DOMAIN_INPUT_REQUIRED (HIP)'))).toBe(true);
+      expect(result.data.hip_check.missing_inputs!.length).toBeGreaterThan(0);
+      expect(result.data.bhc_check.detected).toBe(false);
+      expect(result.data.bhc_check.missing_inputs!.length).toBeGreaterThan(0);
     });
   });
 
   describe('Audit trail', () => {
-    it('produces a 12-step audit trail', async () => {
-      const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
-          components: [
-            {
-              origin: 'JFK',
-              destination: 'LHR',
-              carrier: 'UA',
-              fare_basis: 'Y',
-              nuc_amount: '500.00',
-            },
-          ],
-          selling_currency: 'USD',
-        },
-      });
-
-      expect(result.data.audit_trail.length).toBe(12);
-      expect(result.data.audit_trail[0]!.step).toBe(1);
-      expect(result.data.audit_trail[11]!.step).toBe(12);
-      expect(result.data.audit_trail[11]!.name).toBe('Final Fare');
-    });
-  });
-
-  describe('ROE conversion', () => {
-    it('uses correct ROE for EUR', async () => {
-      const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
-          components: [
-            {
-              origin: 'JFK',
-              destination: 'CDG',
-              carrier: 'AF',
-              fare_basis: 'Y',
-              nuc_amount: '1000.00',
-            },
-          ],
-          selling_currency: 'EUR',
-        },
-      });
-
-      expect(result.data.roe).toBe('0.920830');
-      const expected = new Decimal('1000.00').mul('0.920830');
-      expect(new Decimal(result.data.local_amount_raw).toFixed(2)).toBe(expected.toFixed(2));
-    });
-
-    it('returns DOMAIN_INPUT_REQUIRED for unknown currency (no ROE fallback)', async () => {
-      // Previous behaviour silently fell back to 1.0, producing wrong fares.
-      // Now refuses to construct without an authoritative ROE.
-      const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
-          components: [
-            {
-              origin: 'JFK',
-              destination: 'LHR',
-              carrier: 'UA',
-              fare_basis: 'Y',
-              nuc_amount: '100.00',
-            },
-          ],
-          selling_currency: 'XYZ',
-        },
-      });
-
-      expect('status' in result.data && result.data.status).toBe('DOMAIN_INPUT_REQUIRED');
+    it('produces a full audit trail ending in Final Fare', async () => {
+      const result = await agent.execute({ data: makeInput() });
       if ('status' in result.data && result.data.status === 'DOMAIN_INPUT_REQUIRED') {
-        expect(result.data.missing).toContain('roe_table_entry:XYZ');
-        expect(result.data.references).toContain('IATA monthly ROE publication');
+        throw new Error('Expected constructed fare');
       }
-      expect(result.confidence).toBe(0);
-      expect(result.warnings!.some((w) => w.includes('DOMAIN_INPUT_REQUIRED'))).toBe(true);
+      expect(result.data.audit_trail.length).toBeGreaterThanOrEqual(12);
+      expect(result.data.audit_trail[0]!.step).toBe(1);
+      expect(result.data.audit_trail.at(-1)!.name).toBe('Final Fare');
     });
   });
 
   describe('Input validation', () => {
     it('rejects invalid journey_type', async () => {
       await expect(
-        agent.execute({
-          data: {
-            journey_type: 'XX' as 'OW',
-            components: [
-              {
-                origin: 'JFK',
-                destination: 'LHR',
-                carrier: 'UA',
-                fare_basis: 'Y',
-                nuc_amount: '100',
-              },
-            ],
-            selling_currency: 'USD',
-          },
-        }),
+        agent.execute({ data: makeInput({ journey_type: 'XX' as 'OW' }) }),
       ).rejects.toThrow('Invalid input');
     });
 
     it('rejects empty components', async () => {
       await expect(
-        agent.execute({
-          data: { journey_type: 'OW', components: [], selling_currency: 'USD' },
-        }),
-      ).rejects.toThrow('Invalid input');
-    });
-
-    it('rejects invalid origin in component', async () => {
-      await expect(
-        agent.execute({
-          data: {
-            journey_type: 'OW',
-            components: [
-              {
-                origin: '1',
-                destination: 'LHR',
-                carrier: 'UA',
-                fare_basis: 'Y',
-                nuc_amount: '100',
-              },
-            ],
-            selling_currency: 'USD',
-          },
-        }),
-      ).rejects.toThrow('Invalid input');
-    });
-
-    it('rejects invalid NUC amount', async () => {
-      await expect(
-        agent.execute({
-          data: {
-            journey_type: 'OW',
-            components: [
-              {
-                origin: 'JFK',
-                destination: 'LHR',
-                carrier: 'UA',
-                fare_basis: 'Y',
-                nuc_amount: 'abc',
-              },
-            ],
-            selling_currency: 'USD',
-          },
-        }),
+        agent.execute({ data: makeInput({ components: [] }) }),
       ).rejects.toThrow('Invalid input');
     });
 
     it('rejects invalid currency', async () => {
       await expect(
-        agent.execute({
-          data: {
-            journey_type: 'OW',
-            components: [
-              {
-                origin: 'JFK',
-                destination: 'LHR',
-                carrier: 'UA',
-                fare_basis: 'Y',
-                nuc_amount: '100',
-              },
-            ],
-            selling_currency: 'us',
-          },
-        }),
+        agent.execute({ data: makeInput({ selling_currency: 'us' }) }),
       ).rejects.toThrow('Invalid input');
     });
   });
 
-  describe('Agent interface compliance', () => {
+  describe('Agent interface', () => {
     it('has correct metadata', () => {
       expect(agent.id).toBe('2.2');
       expect(agent.name).toBe('Fare Construction');
-      expect(agent.version).toBe('0.1.0');
+      expect(agent.version).toBe('0.2.0');
     });
 
-    it('reports healthy', async () => {
-      const health = await agent.health();
-      expect(health.status).toBe('healthy');
-    });
-
-    it('returns metadata in output', async () => {
-      const result = await agent.execute({
-        data: {
-          journey_type: 'OW',
-          components: [
-            {
-              origin: 'JFK',
-              destination: 'LHR',
-              carrier: 'UA',
-              fare_basis: 'Y',
-              nuc_amount: '100',
-            },
-          ],
-          selling_currency: 'USD',
-        },
-      });
-      expect(result.metadata!['agent_id']).toBe('2.2');
+    it('constructFare is exported for direct unit use', () => {
+      const result = constructFare(makeInput());
+      expect('total_nuc' in result || ('status' in result && result.status === 'DOMAIN_INPUT_REQUIRED')).toBe(
+        true,
+      );
     });
 
     it('throws when not initialized', async () => {
       const uninit = new FareConstruction();
-      await expect(
-        uninit.execute({
-          data: {
-            journey_type: 'OW',
-            components: [
-              {
-                origin: 'JFK',
-                destination: 'LHR',
-                carrier: 'UA',
-                fare_basis: 'Y',
-                nuc_amount: '100',
-              },
-            ],
-            selling_currency: 'USD',
-          },
-        }),
-      ).rejects.toThrow('not been initialized');
+      await expect(uninit.execute({ data: makeInput() })).rejects.toThrow('not been initialized');
     });
   });
 });
diff --git a/packages/agents/pricing/src/fare-construction/__tests__/fixtures/test-fare-construction-data.json b/packages/agents/pricing/src/fare-construction/__tests__/fixtures/test-fare-construction-data.json
new file mode 100644
index 0000000..993f34f
--- /dev/null
+++ b/packages/agents/pricing/src/fare-construction/__tests__/fixtures/test-fare-construction-data.json
@@ -0,0 +1,27 @@
+{
+  "description": "TEST FIXTURE — invented numbers for unit tests only. Do NOT use in production. Real IROE must come from the licensed IATA Rates of Exchange feed. Do not commit proprietary IROE files to the repo.",
+  "iroe": {
+    "USD": "1.000000",
+    "EUR": "0.920830",
+    "GBP": "0.793650",
+    "JPY": "149.520000",
+    "CHF": "0.882460",
+    "KRW": "1312.500000"
+  },
+  "rounding_024d": {
+    "USD": { "unit": "0.01", "method": "NX" },
+    "EUR": { "unit": "0.01", "method": "HX" },
+    "GBP": { "unit": "0.01", "method": "HX" },
+    "JPY": { "unit": "1", "method": "HX" },
+    "CHF": { "unit": "0.05", "method": "HX" },
+    "KRW": { "unit": "100", "method": "HX" }
+  },
+  "mileage": [
+    { "origin": "JFK", "destination": "LHR", "tpm": 3459, "mpm": 3805 },
+    { "origin": "JFK", "destination": "CDG", "tpm": 3635, "mpm": 3999 },
+    { "origin": "LHR", "destination": "CDG", "tpm": 215, "mpm": 237 },
+    { "origin": "CDG", "destination": "JFK", "tpm": 3635, "mpm": 3999 },
+    { "origin": "SFO", "destination": "NRT", "tpm": 5130, "mpm": 5643 },
+    { "origin": "LHR", "destination": "JFK", "tpm": 3459, "mpm": 3805 }
+  ]
+}
diff --git a/packages/agents/pricing/src/fare-construction/data/mileage-data.json b/packages/agents/pricing/src/fare-construction/data/mileage-data.json
deleted file mode 100644
index c265cf6..0000000
--- a/packages/agents/pricing/src/fare-construction/data/mileage-data.json
+++ /dev/null
@@ -1,56 +0,0 @@
-{
-  "_comment": "Curated TPM/MPM data for ~50 major city pairs. NOT official IATA data.",
-  "_version": "0.1.0",
-  "city_pairs": [
-    { "origin": "JFK", "destination": "LHR", "tpm": 3459, "mph": 3805 },
-    { "origin": "JFK", "destination": "CDG", "tpm": 3635, "mph": 3999 },
-    { "origin": "JFK", "destination": "FRA", "tpm": 3857, "mph": 4243 },
-    { "origin": "JFK", "destination": "LAX", "tpm": 2475, "mph": 2723 },
-    { "origin": "JFK", "destination": "ORD", "tpm": 740, "mph": 814 },
-    { "origin": "JFK", "destination": "MIA", "tpm": 1089, "mph": 1198 },
-    { "origin": "JFK", "destination": "NRT", "tpm": 6757, "mph": 7433 },
-    { "origin": "JFK", "destination": "SIN", "tpm": 9523, "mph": 10475 },
-    { "origin": "JFK", "destination": "DXB", "tpm": 6842, "mph": 7526 },
-    { "origin": "SFO", "destination": "NRT", "tpm": 5130, "mph": 5643 },
-    { "origin": "SFO", "destination": "LAX", "tpm": 337, "mph": 371 },
-    { "origin": "SFO", "destination": "LHR", "tpm": 5367, "mph": 5904 },
-    { "origin": "SFO", "destination": "HKG", "tpm": 6927, "mph": 7620 },
-    { "origin": "LAX", "destination": "NRT", "tpm": 5451, "mph": 5996 },
-    { "origin": "LAX", "destination": "LHR", "tpm": 5456, "mph": 6002 },
-    { "origin": "LAX", "destination": "SYD", "tpm": 7488, "mph": 8237 },
-    { "origin": "ORD", "destination": "LHR", "tpm": 3952, "mph": 4347 },
-    { "origin": "ORD", "destination": "NRT", "tpm": 6292, "mph": 6921 },
-    { "origin": "ORD", "destination": "MIA", "tpm": 1197, "mph": 1317 },
-    { "origin": "ORD", "destination": "LAX", "tpm": 1745, "mph": 1920 },
-    { "origin": "LHR", "destination": "CDG", "tpm": 215, "mph": 237 },
-    { "origin": "LHR", "destination": "FRA", "tpm": 394, "mph": 433 },
-    { "origin": "LHR", "destination": "DXB", "tpm": 3414, "mph": 3755 },
-    { "origin": "LHR", "destination": "SIN", "tpm": 6756, "mph": 7432 },
-    { "origin": "LHR", "destination": "HKG", "tpm": 5994, "mph": 6593 },
-    { "origin": "LHR", "destination": "NRT", "tpm": 5974, "mph": 6571 },
-    { "origin": "LHR", "destination": "SYD", "tpm": 10553, "mph": 11608 },
-    { "origin": "CDG", "destination": "NRT", "tpm": 6194, "mph": 6813 },
-    { "origin": "CDG", "destination": "SIN", "tpm": 6664, "mph": 7330 },
-    { "origin": "FRA", "destination": "NRT", "tpm": 5928, "mph": 6521 },
-    { "origin": "FRA", "destination": "SIN", "tpm": 6368, "mph": 7005 },
-    { "origin": "FRA", "destination": "DXB", "tpm": 3003, "mph": 3303 },
-    { "origin": "SIN", "destination": "SYD", "tpm": 3907, "mph": 4298 },
-    { "origin": "SIN", "destination": "NRT", "tpm": 3312, "mph": 3643 },
-    { "origin": "SIN", "destination": "HKG", "tpm": 1605, "mph": 1766 },
-    { "origin": "HKG", "destination": "NRT", "tpm": 1791, "mph": 1970 },
-    { "origin": "HKG", "destination": "SYD", "tpm": 4580, "mph": 5038 },
-    { "origin": "NRT", "destination": "SYD", "tpm": 4863, "mph": 5349 },
-    { "origin": "DXB", "destination": "SIN", "tpm": 3659, "mph": 4025 },
-    { "origin": "DXB", "destination": "LHR", "tpm": 3414, "mph": 3755 },
-    { "origin": "DXB", "destination": "NRT", "tpm": 4953, "mph": 5448 },
-    { "origin": "MIA", "destination": "LHR", "tpm": 4429, "mph": 4872 },
-    { "origin": "MIA", "destination": "CDG", "tpm": 4587, "mph": 5046 },
-    { "origin": "ATL", "destination": "LHR", "tpm": 4199, "mph": 4619 },
-    { "origin": "ATL", "destination": "CDG", "tpm": 4383, "mph": 4821 },
-    { "origin": "DFW", "destination": "LHR", "tpm": 4751, "mph": 5226 },
-    { "origin": "DEN", "destination": "LHR", "tpm": 4673, "mph": 5140 },
-    { "origin": "SEA", "destination": "NRT", "tpm": 4783, "mph": 5261 },
-    { "origin": "ICN", "destination": "NRT", "tpm": 757, "mph": 833 },
-    { "origin": "ICN", "destination": "SIN", "tpm": 2877, "mph": 3165 }
-  ]
-}
diff --git a/packages/agents/pricing/src/fare-construction/data/roe-rates.json b/packages/agents/pricing/src/fare-construction/data/roe-rates.json
deleted file mode 100644
index ceadd33..0000000
--- a/packages/agents/pricing/src/fare-construction/data/roe-rates.json
+++ /dev/null
@@ -1,27 +0,0 @@
-{
-  "_comment": "IATA Rate of Exchange (ROE) rates for NUC→local currency conversion. NOT official IATA data — representative values.",
-  "_version": "0.1.0",
-  "_effective_date": "2025-01-01",
-  "rates": {
-    "USD": "1.000000",
-    "EUR": "0.920830",
-    "GBP": "0.793650",
-    "JPY": "149.520000",
-    "CHF": "0.882460",
-    "CAD": "1.356780",
-    "AUD": "1.532400",
-    "SGD": "1.342560",
-    "HKD": "7.812000",
-    "KRW": "1312.500000",
-    "THB": "35.240000",
-    "INR": "83.120000",
-    "MYR": "4.725000",
-    "NZD": "1.637500",
-    "ZAR": "18.925000",
-    "AED": "3.672800",
-    "SAR": "3.750000",
-    "BRL": "4.987000",
-    "MXN": "17.125000",
-    "CNY": "7.245000"
-  }
-}
diff --git a/packages/agents/pricing/src/fare-construction/data/rounding-rules.json b/packages/agents/pricing/src/fare-construction/data/rounding-rules.json
deleted file mode 100644
index e9f761c..0000000
--- a/packages/agents/pricing/src/fare-construction/data/rounding-rules.json
+++ /dev/null
@@ -1,27 +0,0 @@
-{
-  "_comment": "IATA rounding rules per currency. unit = smallest rounding increment, direction = up/nearest/down.",
-  "_version": "0.1.0",
-  "rules": {
-    "USD": { "unit": "0.01", "direction": "up" },
-    "EUR": { "unit": "0.01", "direction": "up" },
-    "GBP": { "unit": "0.01", "direction": "up" },
-    "JPY": { "unit": "1", "direction": "up" },
-    "CHF": { "unit": "0.05", "direction": "up" },
-    "CAD": { "unit": "0.01", "direction": "up" },
-    "AUD": { "unit": "0.01", "direction": "up" },
-    "SGD": { "unit": "0.01", "direction": "up" },
-    "HKD": { "unit": "1", "direction": "up" },
-    "KRW": { "unit": "100", "direction": "up" },
-    "THB": { "unit": "1", "direction": "up" },
-    "INR": { "unit": "1", "direction": "up" },
-    "MYR": { "unit": "0.05", "direction": "up" },
-    "NZD": { "unit": "0.01", "direction": "up" },
-    "ZAR": { "unit": "0.01", "direction": "up" },
-    "AED": { "unit": "0.01", "direction": "up" },
-    "SAR": { "unit": "0.01", "direction": "up" },
-    "BRL": { "unit": "0.01", "direction": "up" },
-    "MXN": { "unit": "0.01", "direction": "up" },
-    "CNY": { "unit": "0.01", "direction": "up" }
-  },
-  "default": { "unit": "0.01", "direction": "up" }
-}
diff --git a/packages/agents/pricing/src/fare-construction/fare-engine.ts b/packages/agents/pricing/src/fare-construction/fare-engine.ts
index add2b55..7954c19 100644
--- a/packages/agents/pricing/src/fare-construction/fare-engine.ts
+++ b/packages/agents/pricing/src/fare-construction/fare-engine.ts
@@ -1,21 +1,16 @@
 /**
- * Fare Construction Engine — 12-step pipeline.
+ * Fare Construction Engine — NUC × IROE pipeline with fail-closed data deps.
  *
- * All financial math uses decimal.js.
+ * Authoritative KB:
+ *   docs/knowledge-base/fare-construction-data-dependencies.md
  *
- * // DOMAIN_QUESTION: ROE source-of-truth
- * // ROE values are published by IATA monthly. Hardcoded ROE values produce
- * // wrong fares immediately for any currency that drifts. The previous
- * // 1.0 fallback was a CLAUDE.md violation. We now refuse to construct
- * // fares for currencies whose ROE is not in the input data and instead
- * // return DOMAIN_INPUT_REQUIRED listing the missing ROE.
+ * BANS (CLAUDE.md Agent 2.2 / issue #151):
+ * - No hardcoded IROE in this module (caller supplies licensed feed).
+ * - No haversine / great-circle as TPM.
+ * - No IEEE banker's / half-to-even rounding as IATA 024d.
+ * - No inventing HIP/BHC/CTM comparison rules.
  *
- * // DOMAIN_QUESTION: HIP/BHC fare lookup
- * // Real HIP/BHC detection requires per-carrier filed fares between every
- * // intermediate point in the routing. The simplified heuristics that
- * // previously lived here (per-mile rate comparison and string-matching
- * // city revisits) were CLAUDE.md violations. We now report these checks
- * // as undetected with `missing_inputs` listing the lookup data needed.
+ * Missing IROE, published TPM/MPM, or 024d rounding → DomainInputRequired.
  */
 
 import { Decimal } from 'decimal.js';
@@ -23,84 +18,147 @@ import { domainInputRequired, isDomainInputRequired } from '@otaip/core';
 import type {
   FareConstructionInput,
   FareConstructionResult,
+  FareConstructionDataSources,
   MileageCheck,
   MileageSurcharge,
   HipCheck,
   BhcCheck,
   CtmCheck,
   AuditStep,
+  Rounding024dRule,
+  Rounding024dMethod,
+  PublishedCityPairMileage,
 } from './types.js';
-// JSON imported directly so esbuild inlines it into dist/index.js — using
-// createRequire on the bundled output would fail with MODULE_NOT_FOUND when
-// this package is consumed as a built dep.
-import mileageJson from './data/mileage-data.json';
-import roeJson from './data/roe-rates.json';
-import roundingJson from './data/rounding-rules.json';
 
 export { isDomainInputRequired };
 
 // ---------------------------------------------------------------------------
-// Data loading
+// Explicit bans (documented + testable)
 // ---------------------------------------------------------------------------
 
-interface CityPair {
-  origin: string;
-  destination: string;
-  tpm: number;
-  mph: number;
-}
-interface MileageData {
-  city_pairs: CityPair[];
-}
-interface RoeData {
-  rates: Record<string, string>;
-}
-interface RoundingRule {
-  unit: string;
-  direction: string;
-}
-interface RoundingData {
-  rules: Record<string, RoundingRule>;
-  default: RoundingRule;
-}
+/**
+ * TPM must come from the IATA TPM Manual (or equivalent licensed feed).
+ * Haversine / great-circle distance is NOT TPM.
+ *
+ * @see https://www.iata.org/en/publications/manuals/mileage/ticketed-point-mileage-tpm/
+ */
+export const HAVERSINE_AS_TPM_BANNED =
+  'BAN: haversine/great-circle distance must never be used as TPM. Use published IATA TPM.';
 
-const mileageData = mileageJson as unknown as MileageData;
-const roeData = roeJson as unknown as RoeData;
-const roundingData = roundingJson as unknown as RoundingData;
+/**
+ * IROE must be ingested from the licensed monthly (periodic) IATA feed.
+ * Hardcoded rates in the engine module graph are forbidden.
+ */
+export const HARDCODED_IROE_BANNED =
+  'BAN: no hardcoded IROE in production. Pass licensed rates via data_sources.iroe.';
+
+/**
+ * Resolution 024d uses HX/NX — not banker's (half-to-even) rounding.
+ */
+export const BANKERS_ROUNDING_AS_IATA_BANNED =
+  "BAN: IEEE banker's / half-to-even rounding is not Resolution 024d. Use HX or NX from the licensed table.";
+
+/** Reject any attempt to mark mileage as haversine-sourced. */
+export function assertPublishedTpmSource(source: string): void {
+  const normalized = source.trim().toLowerCase();
+  if (
+    normalized.includes('haversine') ||
+    normalized.includes('great-circle') ||
+    normalized.includes('great_circle') ||
+    normalized.includes('geodesic')
+  ) {
+    throw new Error(HAVERSINE_AS_TPM_BANNED);
+  }
+}
 
 // ---------------------------------------------------------------------------
-// Helpers
+// Lookups (from caller-supplied licensed data only)
 // ---------------------------------------------------------------------------
 
-function findMileage(origin: string, destination: string): CityPair | undefined {
-  return mileageData.city_pairs.find(
+function findMileage(
+  mileage: PublishedCityPairMileage[],
+  origin: string,
+  destination: string,
+): PublishedCityPairMileage | undefined {
+  return mileage.find(
     (cp) =>
       (cp.origin === origin && cp.destination === destination) ||
       (cp.origin === destination && cp.destination === origin),
   );
 }
 
-function getRoe(currency: string): Decimal | null {
-  const rate = roeData.rates[currency];
-  if (!rate) return null;
+function getIroe(sources: FareConstructionDataSources, currency: string): Decimal | null {
+  const rate = sources.iroe[currency];
+  if (rate === undefined || rate === '') return null;
   return new Decimal(rate);
 }
 
-function getRoundingRule(currency: string): RoundingRule {
-  return roundingData.rules[currency] ?? roundingData.default;
+function getRounding024d(
+  sources: FareConstructionDataSources,
+  currency: string,
+): Rounding024dRule | null {
+  const rule = sources.rounding_024d[currency];
+  if (!rule) return null;
+  if (rule.method !== 'HX' && rule.method !== 'NX') return null;
+  if (!rule.unit) return null;
+  return rule;
 }
 
 /**
- * IATA rounding: round UP to the nearest unit.
+ * Apply Resolution 024d rounding for a supplied unit + method.
+ * Mechanical HX/NX only — does not invent which currency uses which rule.
+ *
+ * HX: round up to next higher unit unless already exact.
+ * NX: round to nearest unit (half away from zero / commercial half-up).
+ * Banker's (half-to-even) is explicitly not used.
  */
-function iataRound(amount: Decimal, unit: string): Decimal {
-  const u = new Decimal(unit);
-  // Divide by unit, round up (ceiling), multiply back
-  return amount.div(u).ceil().mul(u);
+export function apply024dRounding(
+  amount: Decimal,
+  rule: Rounding024dRule,
+): Decimal {
+  const unit = new Decimal(rule.unit);
+  if (unit.lte(0)) {
+    throw new Error('024d rounding unit must be positive');
+  }
+
+  const divided = amount.div(unit);
+
+  if (rule.method === 'HX') {
+    // Round up to next higher unit unless already exact.
+    if (divided.isInteger()) return amount;
+    return divided.ceil().mul(unit);
+  }
+
+  // NX — nearest unit. Half rounds away from zero (not banker's half-to-even).
+  const sign = divided.isNegative() ? -1 : 1;
+  const abs = divided.abs();
+  const floor = abs.floor();
+  const frac = abs.minus(floor);
+  const half = new Decimal('0.5');
+  const roundedAbs = frac.gte(half) ? floor.plus(1) : floor;
+  return roundedAbs.mul(sign).mul(unit);
+}
+
+function missingDataSourcesResult() {
+  return domainInputRequired({
+    missing: [
+      'data_sources.iroe',
+      'data_sources.rounding_024d',
+      'data_sources.mileage',
+    ],
+    description:
+      'Fare construction requires licensed IROE, Resolution 024d rounding, and published TPM/MPM via data_sources. No hardcoded rates or haversine substitutes.',
+    references: [
+      'IATA Rates of Exchange (IROE)',
+      'IATA Resolution 024d',
+      'https://www.iata.org/en/publications/manuals/mileage/ticketed-point-mileage-tpm/',
+      'docs/knowledge-base/fare-construction-data-dependencies.md',
+    ],
+  });
 }
 
 // ---------------------------------------------------------------------------
-// Pipeline steps
+// Pipeline
 // ---------------------------------------------------------------------------
 
 export function constructFare(input: FareConstructionInput): FareConstructionResult {
@@ -112,7 +170,7 @@ export function constructFare(input: FareConstructionInput): FareConstructionRes
     audit.push({ step: stepNum, name, description, input: inputVal, output: outputVal });
   }
 
-  // Step 1: Validate components
+  // Step 1: Validate components present (schema validated by agent)
   addStep(
     'Validate Components',
     `${input.components.length} fare component(s), journey type ${input.journey_type}`,
@@ -120,7 +178,31 @@ export function constructFare(input: FareConstructionInput): FareConstructionRes
     'valid',
   );
 
-  // Step 2: Sum NUC amounts
+  // Step 2: Require licensed data_sources (fail closed — no bundled IROE/TPM)
+  const sources = input.data_sources;
+  if (
+    !sources ||
+    !sources.iroe ||
+    !sources.rounding_024d ||
+    !Array.isArray(sources.mileage)
+  ) {
+    addStep(
+      'Data Sources',
+      'Licensed IROE / 024d / TPM-MPM not provided',
+      'data_sources',
+      'DOMAIN_INPUT_REQUIRED',
+    );
+    return missingDataSourcesResult();
+  }
+
+  addStep(
+    'Data Sources',
+    'Caller-supplied licensed IROE, 024d, and TPM/MPM present',
+    `iroe_keys=${Object.keys(sources.iroe).length}; mileage_rows=${sources.mileage.length}`,
+    'ok',
+  );
+
+  // Step 3: Sum NUC amounts
   let totalNuc = new Decimal(0);
   for (const comp of input.components) {
     totalNuc = totalNuc.plus(new Decimal(comp.nuc_amount));
@@ -132,54 +214,76 @@ export function constructFare(input: FareConstructionInput): FareConstructionRes
     totalNuc.toFixed(2),
   );
 
-  // Step 3: Mileage validation
+  // Step 4: Published TPM/MPM lookup — fail closed if any pair missing
   const mileageChecks: MileageCheck[] = [];
+  const missingTpm: string[] = [];
   let totalTpm = 0;
-  let totalMph = 0;
+  let totalMpm = 0;
 
   for (const comp of input.components) {
-    const cp = findMileage(comp.origin, comp.destination);
+    const cp = findMileage(sources.mileage, comp.origin, comp.destination);
     if (cp) {
       mileageChecks.push({
         origin: comp.origin,
         destination: comp.destination,
         tpm: cp.tpm,
-        mph: cp.mph,
+        mpm: cp.mpm,
         data_available: true,
       });
       totalTpm += cp.tpm;
-      totalMph += cp.mph;
+      totalMpm += cp.mpm;
     } else {
+      missingTpm.push(`tpm:${comp.origin}-${comp.destination}`);
       mileageChecks.push({
         origin: comp.origin,
         destination: comp.destination,
         tpm: null,
-        mph: null,
+        mpm: null,
         data_available: false,
       });
     }
   }
 
+  if (missingTpm.length > 0) {
+    addStep(
+      'Mileage Validation',
+      'Published TPM missing — refusing haversine substitute',
+      missingTpm.join(', '),
+      'DOMAIN_INPUT_REQUIRED',
+    );
+    return domainInputRequired({
+      missing: missingTpm,
+      description: `${HAVERSINE_AS_TPM_BANNED} Missing published TPM for: ${missingTpm.join(', ')}.`,
+      references: [
+        'https://www.iata.org/en/publications/manuals/mileage/ticketed-point-mileage-tpm/',
+        'IATA Maximum Permitted Mileage Manual',
+        'docs/knowledge-base/fare-construction-data-dependencies.md',
+      ],
+    });
+  }
+
   addStep(
     'Mileage Validation',
-    `TPM total: ${totalTpm}, MPM total: ${totalMph}`,
+    `TPM total: ${totalTpm}, MPM total: ${totalMpm}`,
     `${mileageChecks.length} segments`,
-    `TPM=${totalTpm} MPM=${totalMph}`,
+    `TPM=${totalTpm} MPM=${totalMpm}`,
   );
 
-  // Step 4: Check mileage exceeded
-  const mileageExceeded = totalMph > 0 && totalTpm > totalMph;
+  // Step 5: MPM excess check (published mileages only)
+  const mileageExceeded = totalMpm > 0 && totalTpm > totalMpm;
   const excessPct =
-    totalMph > 0 ? new Decimal(totalTpm).minus(totalMph).div(totalMph).mul(100).toNumber() : 0;
+    totalMpm > 0 ? new Decimal(totalTpm).minus(totalMpm).div(totalMpm).mul(100).toNumber() : 0;
 
   addStep(
     'Mileage Excess Check',
     `Excess: ${excessPct.toFixed(1)}%`,
-    `TPM=${totalTpm} vs MPM=${totalMph}`,
+    `TPM=${totalTpm} vs MPM=${totalMpm}`,
     mileageExceeded ? `exceeded by ${excessPct.toFixed(1)}%` : 'within MPM',
   );
 
-  // Step 5: Mileage surcharge
+  // Step 6: Mileage surcharge (EMS bands — requires published TPM/MPM above)
+  // TODO: DOMAIN_QUESTION: confirm EMS percentage bands against current IATA
+  // mileage system documentation for each market; do not extend beyond 5% steps.
   let surchargePercentage = 0;
   if (mileageExceeded) {
     if (excessPct <= 5) surchargePercentage = 5;
@@ -211,12 +315,7 @@ export function constructFare(input: FareConstructionInput): FareConstructionRes
     `total NUC=${totalNuc.toFixed(2)}`,
   );
 
-  // Step 6: HIP check (Higher Intermediate Point)
-  // Real HIP detection requires per-airline filed fares between every
-  // intermediate point in the routing. Without that lookup data, we
-  // report `detected: false` and surface the missing inputs. We do NOT
-  // apply per-mile-rate heuristics — those are not the published ATPCO
-  // HIP comparison rule.
+  // Step 7: HIP sketch — no invented comparison rules
   const hipMissing: string[] = [];
   if (input.components.length > 1) {
     for (let i = 0; i < input.components.length - 1; i++) {
@@ -242,15 +341,9 @@ export function constructFare(input: FareConstructionInput): FareConstructionRes
     hipMissing.length > 0 ? 'skipped — domain input required' : 'no HIP',
   );
 
-  // Step 7: BHC check (Backhaul Check)
-  // Real BHC requires geographic direction analysis (great-circle bearing
-  // of each fare component vs. intended journey direction). Simple "city
-  // revisited" string matching is not the published BHC rule. We report
-  // `detected: false` and list the missing inputs.
+  // Step 8: BHC sketch
   const bhcMissing =
-    input.components.length > 1
-      ? ['geographic_direction_analysis:fare_components']
-      : [];
+    input.components.length > 1 ? ['geographic_direction_analysis:fare_components'] : [];
   const bhcCheck: BhcCheck = {
     detected: false,
     description:
@@ -267,93 +360,114 @@ export function constructFare(input: FareConstructionInput): FareConstructionRes
     bhcMissing.length > 0 ? 'skipped — domain input required' : 'no BHC',
   );
 
-  // Step 8: CTM check (Circle Trip Minimum)
+  // Step 9: CTM sketch — do NOT invent CTM = total_nuc
+  const ctmMissing =
+    input.journey_type === 'CT' && input.components.length >= 2
+      ? ['circle_trip_minima_nuc:filed_half_rt_fares']
+      : [];
   const ctmCheck: CtmCheck = {
     applies: false,
     ctm_nuc: null,
-    description: 'CTM not applicable (not a circle trip)',
+    description:
+      ctmMissing.length > 0
+        ? 'CTM check skipped — filed circle-trip minima not provided.'
+        : 'CTM not applicable (not a multi-component circle trip)',
+    ...(ctmMissing.length > 0 ? { missing_inputs: ctmMissing } : {}),
   };
 
-  if (input.journey_type === 'CT' && input.components.length >= 2) {
-    // CTM = sum of half round-trip fares for each component
-    // Simplified: CTM = total_nuc (already the minimum)
-    ctmCheck.applies = true;
-    ctmCheck.ctm_nuc = totalNuc.toFixed(2);
-    ctmCheck.description = 'Circle Trip Minimum applies';
-  }
-
   addStep(
     'CTM Check',
     ctmCheck.description,
     input.journey_type,
-    ctmCheck.applies ? `CTM NUC=${ctmCheck.ctm_nuc}` : 'N/A',
+    ctmMissing.length > 0 ? 'skipped — domain input required' : 'N/A',
   );
 
-  // Step 9: Get ROE
-  // No fallback. ROE values are published by IATA monthly. Returning
-  // anything else (especially 1.0) silently produces wrong fares for
-  // every non-USD currency. If ROE is missing → DomainInputRequired.
-  const roe = getRoe(input.selling_currency);
-  if (!roe) {
+  // Step 10: IROE lookup — no hardcoded fallback
+  const iroe = getIroe(sources, input.selling_currency);
+  if (!iroe) {
     addStep(
-      'ROE Lookup',
-      `No ROE for ${input.selling_currency} — refusing to construct fare.`,
+      'IROE Lookup',
+      `No IROE for ${input.selling_currency} — refusing to construct fare.`,
       input.selling_currency,
       'DOMAIN_INPUT_REQUIRED',
     );
     return domainInputRequired({
-      missing: [`roe_table_entry:${input.selling_currency}`],
-      description: `No ROE entry for ${input.selling_currency}. Construction halted to avoid producing an incorrect local-currency fare.`,
-      references: ['IATA monthly ROE publication', 'ATPCO Fare Construction guide'],
+      missing: [`iroe_table_entry:${input.selling_currency}`],
+      description: `${HARDCODED_IROE_BANNED} No IROE entry for ${input.selling_currency}.`,
+      references: [
+        'IATA Rates of Exchange (IROE)',
+        'docs/knowledge-base/fare-construction-data-dependencies.md',
+      ],
     });
   }
   addStep(
-    'ROE Lookup',
-    `ROE for ${input.selling_currency}`,
+    'IROE Lookup',
+    `IROE for ${input.selling_currency}`,
     input.selling_currency,
-    roe.toFixed(6),
+    iroe.toFixed(6),
   );
 
-  const effectiveRoe = roe;
-
-  // Step 10: NUC × ROE = local currency
-  const localRaw = totalNuc.mul(effectiveRoe);
+  // Step 11: NUC × IROE = local currency
+  const localRaw = totalNuc.mul(iroe);
   addStep(
-    'NUC × ROE',
-    `${totalNuc.toFixed(2)} × ${effectiveRoe.toFixed(6)}`,
+    'NUC × IROE',
+    `${totalNuc.toFixed(2)} × ${iroe.toFixed(6)}`,
     `NUC ${totalNuc.toFixed(2)}`,
     `${input.selling_currency} ${localRaw.toFixed(6)}`,
   );
 
-  // Step 11: IATA rounding
-  const roundingRule = getRoundingRule(input.selling_currency);
-  const localRounded = iataRound(localRaw, roundingRule.unit);
+  // Step 12: Resolution 024d rounding — no default unit / no banker's
+  const roundingRule = getRounding024d(sources, input.selling_currency);
+  if (!roundingRule) {
+    addStep(
+      '024d Rounding',
+      `No 024d rule for ${input.selling_currency}`,
+      input.selling_currency,
+      'DOMAIN_INPUT_REQUIRED',
+    );
+    return domainInputRequired({
+      missing: [`rounding_024d:${input.selling_currency}`],
+      description: `${BANKERS_ROUNDING_AS_IATA_BANNED} No Resolution 024d entry for ${input.selling_currency}.`,
+      references: [
+        'IATA Resolution 024d',
+        'docs/knowledge-base/fare-construction-data-dependencies.md',
+      ],
+    });
+  }
+
+  const localRounded = apply024dRounding(localRaw, roundingRule);
+  const method: Rounding024dMethod = roundingRule.method;
 
   addStep(
-    'IATA Rounding',
-    `Round UP to nearest ${roundingRule.unit}`,
+    '024d Rounding',
+    `${method} to nearest unit ${roundingRule.unit}`,
     localRaw.toFixed(6),
     localRounded.toString(),
   );
 
-  // Step 12: Final result
+  // Step 13: Final result
   addStep(
     'Final Fare',
     `Constructed fare in ${input.selling_currency}`,
-    `NUC ${totalNuc.toFixed(2)} × ROE ${effectiveRoe.toFixed(6)}`,
+    `NUC ${totalNuc.toFixed(2)} × IROE ${iroe.toFixed(6)}`,
     `${input.selling_currency} ${localRounded.toString()}`,
   );
 
+  const iroeStr = iroe.toFixed(6);
+
   return {
     total_nuc: totalNuc.toFixed(2),
-    roe: effectiveRoe.toFixed(6),
+    iroe: iroeStr,
+    roe: iroeStr,
     local_amount_raw: localRaw.toFixed(6),
     local_amount: localRounded.toString(),
     currency: input.selling_currency,
     rounding_unit: roundingRule.unit,
+    rounding_method: method,
     mileage_checks: mileageChecks,
     total_tpm: totalTpm,
-    total_mph: totalMph,
+    total_mpm: totalMpm,
+    total_mph: totalMpm,
     mileage_exceeded: mileageExceeded,
     mileage_surcharge: mileageSurcharge,
     hip_check: hipCheck,
diff --git a/packages/agents/pricing/src/fare-construction/index.ts b/packages/agents/pricing/src/fare-construction/index.ts
index 0aba705..d9ce111 100644
--- a/packages/agents/pricing/src/fare-construction/index.ts
+++ b/packages/agents/pricing/src/fare-construction/index.ts
@@ -1,12 +1,13 @@
 /**
  * Fare Construction — Agent 2.2
  *
- * NUC × ROE fare construction with mileage validation,
- * HIP/BHC/CTM checks, surcharges, and IATA rounding.
+ * NUC × IROE with published TPM/MPM, Resolution 024d (HX/NX) rounding,
+ * and fail-closed HIP/BHC/CTM hooks.
  *
- * ALL financial math uses decimal.js — no floating point for currency.
+ * Licensed data is supplied via input.data_sources — this package does
+ * not ship IROE or TPM files.
  *
- * Implements the base Agent interface from @otaip/core.
+ * KB: docs/knowledge-base/fare-construction-data-dependencies.md
  */
 
 import type { Agent, AgentInput, AgentOutput, AgentHealthStatus } from '@otaip/core';
@@ -29,7 +30,7 @@ const CURRENCY_RE = /^[A-Z]{3}$/;
 export class FareConstruction implements Agent<FareConstructionInput, FareConstructionResult> {
   readonly id = '2.2';
   readonly name = 'Fare Construction';
-  readonly version = '0.1.0';
+  readonly version = '0.2.0';
 
   private initialized = false;
 
@@ -70,7 +71,7 @@ export class FareConstruction implements Agent<FareConstructionInput, FareConstr
     const warnings: string[] = [];
     if (result.mileage_exceeded) {
       warnings.push(
-        `Mileage exceeded: TPM ${result.total_tpm} > MPM ${result.total_mph}. Surcharge of ${result.mileage_surcharge.percentage}% applied.`,
+        `Mileage exceeded: TPM ${result.total_tpm} > MPM ${result.total_mpm}. Surcharge of ${result.mileage_surcharge.percentage}% applied.`,
       );
     }
     if (result.hip_check.detected) {
@@ -89,10 +90,10 @@ export class FareConstruction implements Agent<FareConstructionInput, FareConstr
         `DOMAIN_INPUT_REQUIRED (BHC): ${result.bhc_check.missing_inputs.join(', ')}`,
       );
     }
-
-    const missingMileage = result.mileage_checks.filter((m) => !m.data_available);
-    for (const m of missingMileage) {
-      warnings.push(`No mileage data for ${m.origin}-${m.destination}.`);
+    if (result.ctm_check.missing_inputs && result.ctm_check.missing_inputs.length > 0) {
+      warnings.push(
+        `DOMAIN_INPUT_REQUIRED (CTM): ${result.ctm_check.missing_inputs.join(', ')}`,
+      );
     }
 
     return {
@@ -168,10 +169,20 @@ export class FareConstruction implements Agent<FareConstructionInput, FareConstr
   }
 }
 
+export {
+  constructFare,
+  apply024dRounding,
+  assertPublishedTpmSource,
+  HAVERSINE_AS_TPM_BANNED,
+  HARDCODED_IROE_BANNED,
+  BANKERS_ROUNDING_AS_IATA_BANNED,
+} from './fare-engine.js';
+
 export type {
   FareConstructionInput,
   FareConstructionOutput,
   FareConstructionResult,
+  FareConstructionDataSources,
   FareComponent,
   JourneyType,
   MileageCheck,
@@ -180,4 +191,10 @@ export type {
   BhcCheck,
   CtmCheck,
   AuditStep,
+  Rounding024dMethod,
+  Rounding024dRule,
+  PublishedCityPairMileage,
+  HipCheckRequirements,
+  BhcCheckRequirements,
+  CtmCheckRequirements,
 } from './types.js';
diff --git a/packages/agents/pricing/src/fare-construction/types.ts b/packages/agents/pricing/src/fare-construction/types.ts
index 5411376..0360f38 100644
--- a/packages/agents/pricing/src/fare-construction/types.ts
+++ b/packages/agents/pricing/src/fare-construction/types.ts
@@ -1,13 +1,15 @@
 /**
  * Fare Construction — Input/Output types
  *
- * Agent 2.2: NUC × ROE fare construction with mileage validation,
- * HIP/BHC/CTM checks, surcharges, and IATA rounding.
+ * Agent 2.2: NUC × IROE with published TPM/MPM, Resolution 024d (HX/NX)
+ * rounding, and fail-closed HIP/BHC/CTM hooks.
  *
- * Output is `FareConstructionResult` — a discriminated union that may be
- * either a successful `FareConstructionOutput` or a `DomainInputRequired`
- * sentinel when authoritative inputs (ROE, intermediate-point fare
- * lookups, etc.) are unavailable.
+ * Authoritative contracts:
+ *   docs/knowledge-base/fare-construction-data-dependencies.md
+ *
+ * Output is `FareConstructionResult` — either a successful
+ * `FareConstructionOutput` or `DomainInputRequired` when IROE, TPM/MPM,
+ * or 024d rounding is unavailable.
  */
 
 import type { DomainInputRequired } from '@otaip/core';
@@ -16,10 +18,58 @@ export type FareConstructionResult = FareConstructionOutput | DomainInputRequire
 
 export type JourneyType = 'OW' | 'RT' | 'CT';
 
+/**
+ * Resolution 024d rounding method.
+ * HX = round up to the next higher unit (unless already exact).
+ * NX = round to the nearest unit.
+ * Never use IEEE banker's / half-to-even as a substitute.
+ */
+export type Rounding024dMethod = 'HX' | 'NX';
+
+export interface Rounding024dRule {
+  /** Smallest rounding increment as a decimal string (e.g. "0.01", "1", "100"). */
+  unit: string;
+  method: Rounding024dMethod;
+}
+
+/**
+ * Published TPM/MPM for one city pair from a licensed IATA feed.
+ * source must never be haversine / great-circle derived.
+ */
+export interface PublishedCityPairMileage {
+  origin: string;
+  destination: string;
+  /** Ticketed Point Mileage (IATA TPM Manual). */
+  tpm: number;
+  /** Maximum Permitted Mileage (IATA MPM Manual). */
+  mpm: number;
+}
+
+/**
+ * Caller-supplied licensed data. Absent or incomplete → fail closed.
+ * Do not commit proprietary IROE/TPM/024d tables to the repo; pass them
+ * at runtime from a licensed subscription.
+ */
+export interface FareConstructionDataSources {
+  /**
+   * IROE rates keyed by ISO 4217 currency (decimal strings).
+   * Example: { USD: "1.000000", EUR: "…" } from the current IROE period.
+   */
+  iroe: Record<string, string>;
+  /**
+   * Resolution 024d rounding rules keyed by currency.
+   */
+  rounding_024d: Record<string, Rounding024dRule>;
+  /**
+   * Published TPM/MPM city pairs from the IATA TPM/MPM manuals.
+   */
+  mileage: PublishedCityPairMileage[];
+}
+
 export interface FareComponent {
-  /** Origin airport */
+  /** Origin airport / city code */
   origin: string;
-  /** Destination airport */
+  /** Destination airport / city code */
   destination: string;
   /** Carrier */
   carrier: string;
@@ -34,118 +84,121 @@ export interface FareConstructionInput {
   journey_type: JourneyType;
   /** Fare components (segments with NUC amounts) */
   components: FareComponent[];
-  /** Point of sale currency (ISO 4217) */
+  /** Point of sale / selling currency (ISO 4217) */
   selling_currency: string;
-  /** Point of sale country (for ROE selection) */
+  /** Point of sale country (for IROE selection context) */
   point_of_sale?: string;
+  /**
+   * Licensed IROE / 024d / TPM-MPM data. Required for construction.
+   * When omitted or incomplete, the engine returns DomainInputRequired.
+   */
+  data_sources?: FareConstructionDataSources;
 }
 
 export interface MileageCheck {
-  /** City pair */
   origin: string;
   destination: string;
-  /** Ticketed Point Mileage */
+  /** Ticketed Point Mileage (published). Null when unavailable. */
   tpm: number | null;
-  /** Maximum Permitted Mileage */
-  mph: number | null;
-  /** Whether mileage data was found */
+  /** Maximum Permitted Mileage (published). Null when unavailable. */
+  mpm: number | null;
+  /** Whether published mileage data was found for this pair */
   data_available: boolean;
 }
 
+/**
+ * Minimal HIP sketch — comparison rules are NOT implemented.
+ * See docs/knowledge-base/fare-construction-data-dependencies.md.
+ */
 export interface HipCheck {
-  /** Whether HIP (Higher Intermediate Point) was detected */
   detected: boolean;
-  /** The intermediate point that triggered HIP */
   hip_point: string | null;
-  /** HIP fare amount in NUC */
   hip_nuc: string | null;
-  /** Description */
   description: string;
   /**
-   * Set when intermediate-point fare lookup data was not provided. Each
-   * entry names a missing input (e.g. 'intermediate_point_fares:JFK-LON').
-   * Real HIP detection requires per-airline filed fares between every
-   * intermediate point pair — see ATPCO Fare Construction guide.
+   * Missing authoritative inputs (e.g. intermediate_point_fares:JFK-LON).
+   * Real HIP needs per-airline filed fares between intermediate points.
    */
   missing_inputs?: string[];
 }
 
+/**
+ * Minimal BHC sketch — comparison rules are NOT implemented.
+ */
 export interface BhcCheck {
-  /** Whether BHC (Backhaul Check) was detected */
   detected: boolean;
-  /** Description */
   description: string;
-  /**
-   * Set when geographic-direction analysis data was not provided. Real
-   * BHC detection compares fare-component directionality against great-
-   * circle bearing of the intended journey, which requires geographic
-   * direction analysis beyond simple "city revisited" string matching.
-   */
   missing_inputs?: string[];
 }
 
+/**
+ * Minimal CTM sketch — comparison rules are NOT implemented.
+ */
 export interface CtmCheck {
-  /** Whether CTM (Circle Trip Minimum) applies */
   applies: boolean;
-  /** CTM amount in NUC */
   ctm_nuc: string | null;
-  /** Description */
   description: string;
+  missing_inputs?: string[];
 }
 
 export interface MileageSurcharge {
-  /** Whether a mileage surcharge applies */
   applies: boolean;
-  /** Surcharge percentage (5, 10, 15, 20, 25) */
+  /** EMS-style percentage band when MPM excess is computed from published TPM/MPM. */
   percentage: number;
-  /** Surcharge amount in NUC */
   surcharge_nuc: string;
-  /** Description */
   description: string;
 }
 
 export interface AuditStep {
-  /** Step number */
   step: number;
-  /** Step name */
   name: string;
-  /** Description of calculation */
   description: string;
-  /** Input value */
   input: string;
-  /** Output value */
   output: string;
 }
 
 export interface FareConstructionOutput {
-  /** Total NUC amount (sum of components + surcharges) */
   total_nuc: string;
-  /** ROE used for conversion */
+  /** IROE used for NUC → local conversion */
+  iroe: string;
+  /** @deprecated Use `iroe`. Kept for transitional consumers. */
   roe: string;
-  /** Local currency amount before rounding */
   local_amount_raw: string;
-  /** Local currency amount after IATA rounding */
   local_amount: string;
-  /** Selling currency */
   currency: string;
-  /** Rounding rule applied */
   rounding_unit: string;
-  /** Mileage validation per component */
+  rounding_method: Rounding024dMethod;
   mileage_checks: MileageCheck[];
-  /** Total ticketed mileage */
   total_tpm: number;
-  /** Total maximum permitted mileage */
+  total_mpm: number;
+  /** @deprecated Use `total_mpm`. */
   total_mph: number;
-  /** Whether total mileage exceeds MPM */
   mileage_exceeded: boolean;
-  /** Mileage surcharge (if applicable) */
   mileage_surcharge: MileageSurcharge;
-  /** HIP check result */
   hip_check: HipCheck;
-  /** BHC check result */
   bhc_check: BhcCheck;
-  /** CTM check result (CT journeys only) */
   ctm_check: CtmCheck;
-  /** Full audit trail */
   audit_trail: AuditStep[];
 }
+
+/**
+ * Requirements documents for HIP/BHC/CTM — interface sketch only.
+ * Engines must not invent comparison logic from these shapes alone.
+ */
+export interface HipCheckRequirements {
+  intermediate_point_fares: Array<{
+    origin: string;
+    destination: string;
+    carrier: string;
+    nuc_amount: string;
+  }>;
+}
+
+export interface BhcCheckRequirements {
+  /** Opaque until DOMAIN_QUESTION on published BHC rules is answered. */
+  geographic_direction_analysis: unknown;
+}
+
+export interface CtmCheckRequirements {
+  circle_trip_minima_nuc: Array<{ component_index: number; ctm_nuc: string }>;
+}
diff --git a/packages/agents/pricing/src/index.ts b/packages/agents/pricing/src/index.ts
index 10f0707..2294862 100644
--- a/packages/agents/pricing/src/index.ts
+++ b/packages/agents/pricing/src/index.ts
@@ -24,10 +24,20 @@ export {
   fareRuleOutputSchema,
 } from './fare-rule-agent/schema.js';
 
-export { FareConstruction } from './fare-construction/index.js';
+export {
+  FareConstruction,
+  constructFare,
+  apply024dRounding,
+  assertPublishedTpmSource,
+  HAVERSINE_AS_TPM_BANNED,
+  HARDCODED_IROE_BANNED,
+  BANKERS_ROUNDING_AS_IATA_BANNED,
+} from './fare-construction/index.js';
 export type {
   FareConstructionInput,
   FareConstructionOutput,
+  FareConstructionResult,
+  FareConstructionDataSources,
   FareComponent,
   JourneyType,
   MileageCheck,
@@ -36,6 +46,12 @@ export type {
   BhcCheck,
   CtmCheck,
   AuditStep,
+  Rounding024dMethod,
+  Rounding024dRule,
+  PublishedCityPairMileage,
+  HipCheckRequirements,
+  BhcCheckRequirements,
+  CtmCheckRequirements,
 } from './fare-construction/index.js';
 
 export { TaxCalculation } from './tax-calculation/index.js';
diff --git a/packages/agents/pricing/src/tax-calculation/data/tax-rates.json b/packages/agents/pricing/src/tax-calculation/data/tax-rates.json
index a2ae97d..2f0c01a 100644
--- a/packages/agents/pricing/src/tax-calculation/data/tax-rates.json
+++ b/packages/agents/pricing/src/tax-calculation/data/tax-rates.json
@@ -86,7 +86,7 @@
     { "type": "involuntary", "description": "Involuntary reroute or denied boarding", "exempt_from": "carrier_surcharges" }
   ],
   "currency_conversions": {
-    "_comment": "Simplified conversion rates to USD for tax aggregation. Use ROE data for fare conversion.",
+    "_comment": "TEST/DEMO ONLY — invented FX for tax aggregation. Do NOT treat as IROE or ICER. Ticket-tax / payment currency conversion must ingest licensed IATA ICER (daily), not IROE. IROE is fare construction only (Res 024c). See https://www.iata.org/en/services/finance/xrates/ and docs/knowledge-base/fare-construction-data-dependencies.md. Missing ICER should fail closed, not default to 1.0.",
     "USD": "1.000000",
     "EUR": "1.086950",
     "GBP": "1.260000",
diff --git a/packages/agents/pricing/src/tax-calculation/tax-engine.ts b/packages/agents/pricing/src/tax-calculation/tax-engine.ts
index 918b762..200e3f9 100644
--- a/packages/agents/pricing/src/tax-calculation/tax-engine.ts
+++ b/packages/agents/pricing/src/tax-calculation/tax-engine.ts
@@ -141,10 +141,21 @@ function getTaxesForCountry(country: string): TaxRule[] {
 function getConversionRate(from: string, to: string): Decimal {
   if (from === to) return new Decimal(1);
 
+  // TODO: DOMAIN_QUESTION: Ticket-tax / payment FX must use licensed **ICER**
+  // (IATA Consolidated Exchange Rate) — daily BSR-style rates for converting
+  // fares, taxes, and fees to alternate payment currencies.
+  // Do NOT use IROE here. IROE is fare-construction only (Res 024c / NUC×IROE).
+  // See https://www.iata.org/en/services/finance/xrates/ and
+  // docs/knowledge-base/fare-construction-data-dependencies.md (IROE vs ICER).
+  // The invented currency_conversions map in tax-rates.json is demo-only.
   const fromToUsd = taxData.currency_conversions[from];
   const toToUsd = taxData.currency_conversions[to];
 
-  if (!fromToUsd || !toToUsd) return new Decimal(1);
+  if (!fromToUsd || !toToUsd) {
+    // TODO: DOMAIN_QUESTION: fail closed with DomainInputRequired for missing
+    // ICER once TaxCalculationOutput is widened — never silently return 1.0.
+    return new Decimal(1);
+  }
 
   // from -> USD -> to: amount * (fromToUsd / toToUsd)
   return new Decimal(fromToUsd).div(new Decimal(toToUsd));