diff --git a/CLAUDE.md b/CLAUDE.md
index 73b9e9c..67ac08d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -59,6 +59,7 @@ Follow the pattern in `packages/agents/reference/src/airport-code-resolver/`:
 ## Domain Knowledge
 - Air: `docs/knowledge-base/` (existing)
 - Lodging: `docs/knowledge-base/lodging.md`
+- BSP HOT (Agent 7.1): `docs/knowledge-base/bsp-hot-reconciliation.md` (DISH Rev 23; multi-currency CUTP; IROE≠ICER; conjunction/exchange/EMD/ADM separate)
 - Agent definitions: `docs/agents/`
 
 ## Repository Structure
diff --git a/agents.graph.json b/agents.graph.json
index 7463c50..ab5db37 100644
--- a/agents.graph.json
+++ b/agents.graph.json
@@ -439,7 +439,7 @@
       "id": "7.1",
       "name": "BSP Reconciliation",
       "stage": "reconciliation",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "contract_status": "active",
       "has_contract": false,
       "source_path": "packages/agents/reconciliation/src/bsp-reconciliation/index.ts"
diff --git a/agents.manifest.json b/agents.manifest.json
index 9cb7ba5..cbc4038 100644
--- a/agents.manifest.json
+++ b/agents.manifest.json
@@ -5402,7 +5402,7 @@
       "id": "7.1",
       "name": "BSP Reconciliation",
       "stage": "reconciliation",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "contract_status": "active",
       "has_contract": false,
       "source_path": "packages/agents/reconciliation/src/bsp-reconciliation/index.ts"
diff --git a/docs/agent-map.html b/docs/agent-map.html
index 2573304..9e7d3b2 100644
--- a/docs/agent-map.html
+++ b/docs/agent-map.html
@@ -1897,7 +1897,7 @@ <h2>Every agent, by stage.</h2>
     <div class="panel-inner" id="panel-content"></div>
   </aside>
 
-  <script id="graph-data" type="application/json">{"graph":{"generated_by":"scripts/generate-manifest.ts","total_nodes":77,"total_edges":27,"nodes":[{"id":"0.1","name":"Airport/City Code Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/airport-code-resolver/index.ts"},{"id":"0.2","name":"Airline Code & Alliance Mapper","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/airline-code-mapper/index.ts"},{"id":"0.3","name":"Fare Basis Code Decoder","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/fare-basis-decoder/index.ts"},{"id":"0.4","name":"Class of Service Mapper","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/class-of-service-mapper/index.ts"},{"id":"0.5","name":"Equipment Type Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/equipment-type-resolver/index.ts"},{"id":"0.6","name":"Currency & Tax Code Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/currency-tax-resolver/index.ts"},{"id":"0.7","name":"Country Regulatory Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/country-regulatory-resolver/index.ts"},{"id":"1.1","name":"Availability Search","stage":"search","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/availability-search/index.ts"},{"id":"1.2","name":"Schedule Lookup","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/schedule-lookup/index.ts"},{"id":"1.3","name":"Connection Builder","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/connection-builder/index.ts"},{"id":"1.4","name":"Fare Shopping","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/fare-shopping/index.ts"},{"id":"1.5","name":"Ancillary Shopping","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/ancillary-shopping/index.ts"},{"id":"1.6","name":"Multi-Source Aggregator","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/multi-source-aggregator/index.ts"},{"id":"1.7","name":"Hotel & Car Search","stage":"search","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/hotel-car-search/index.ts"},{"id":"1.8","name":"AI Travel Advisor","stage":"search","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/ai-travel-advisor/index.ts"},{"id":"1.9","name":"Offer Evaluator","stage":"core","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/core/src/agents/shopping/offer-evaluator/index.ts"},{"id":"2.1","name":"Fare Rule Agent","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/pricing/src/fare-rule-agent/index.ts"},{"id":"2.2","name":"Fare Construction","stage":"pricing","version":"0.2.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/fare-construction/index.ts"},{"id":"2.3","name":"Tax Calculation","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/tax-calculation/index.ts"},{"id":"2.4","name":"Offer Builder","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/pricing/src/offer-builder/index.ts"},{"id":"2.5","name":"Corporate Policy Validation","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/corporate-policy-validation/index.ts"},{"id":"2.6","name":"Dynamic Pricing","stage":"pricing","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/pricing/src/dynamic-pricing/index.ts"},{"id":"2.7","name":"Revenue Management","stage":"pricing","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/pricing/src/revenue-management/index.ts"},{"id":"3.1","name":"GDS/NDC Router","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/gds-ndc-router/index.ts"},{"id":"3.2","name":"PNR Builder","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/pnr-builder/index.ts"},{"id":"3.3","name":"PNR Validation","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/pnr-validation/index.ts"},{"id":"3.4","name":"Queue Management","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/queue-management/index.ts"},{"id":"3.5","name":"API Abstraction","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/api-abstraction/index.ts"},{"id":"3.6","name":"Order Management","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/order-management/index.ts"},{"id":"3.7","name":"Payment Processing","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/payment-processing/index.ts"},{"id":"3.8","name":"PNR Retrieval","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/pnr-retrieval/index.ts"},{"id":"4.1","name":"Ticket Issuance","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/ticketing/src/ticket-issuance/index.ts"},{"id":"4.2","name":"EMD Management","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/emd-management/index.ts"},{"id":"4.3","name":"Void Agent","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/void-agent/index.ts"},{"id":"4.4","name":"Itinerary Delivery","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/itinerary-delivery/index.ts"},{"id":"4.5","name":"Document Verification","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/document-verification/index.ts"},{"id":"5.1","name":"Change Management","stage":"exchange","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/change-management/index.ts"},{"id":"5.2","name":"Exchange/Reissue","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/exchange-reissue/index.ts"},{"id":"5.3","name":"Involuntary Rebook","stage":"exchange","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/involuntary-rebook/index.ts"},{"id":"5.4","name":"Disruption Response","stage":"exchange","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/exchange/src/disruption-response/index.ts"},{"id":"5.5","name":"Self-Service Rebooking","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/exchange/src/self-service-rebooking/index.ts"},{"id":"5.6","name":"Waitlist Management","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/exchange/src/waitlist-management/index.ts"},{"id":"6.1","name":"Refund Processing","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/refund-processing/index.ts"},{"id":"6.2","name":"ADM Prevention","stage":"settlement","version":"0.2.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/adm-prevention/index.ts"},{"id":"6.3","name":"ADM/ACM Processing","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/adm-acm-processing/index.ts"},{"id":"6.4","name":"Customer Communication","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/customer-communication/index.ts"},{"id":"6.5","name":"Feedback & Complaint","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/feedback-complaint/index.ts"},{"id":"6.6","name":"Loyalty Mileage","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/loyalty-mileage/index.ts"},{"id":"7.1","name":"BSP Reconciliation","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/bsp-reconciliation/index.ts"},{"id":"7.2","name":"ARC Reconciliation","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/arc-reconciliation/index.ts"},{"id":"7.3","name":"Commission Management","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/commission-management/index.ts"},{"id":"7.4","name":"Interline Settlement","stage":"reconciliation","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/reconciliation/src/interline-settlement/index.ts"},{"id":"7.5","name":"Financial Reporting","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/financial-reporting/index.ts"},{"id":"7.6","name":"Revenue Accounting","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/revenue-accounting/index.ts"},{"id":"8.1","name":"Traveler Profile","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/traveler-profile/index.ts"},{"id":"8.2","name":"Corporate Account","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/corporate-account/index.ts"},{"id":"8.3","name":"Mid-Office Automation","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/mid-office/index.ts"},{"id":"8.4","name":"Reporting & Analytics","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/reporting/index.ts"},{"id":"8.5","name":"Duty of Care","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/duty-of-care/index.ts"},{"id":"9.1","name":"Orchestrator","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/orchestrator/index.ts"},{"id":"9.2","name":"Knowledge Retrieval","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/knowledge/index.ts"},{"id":"9.3","name":"Monitoring & Alerting","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/monitoring/index.ts"},{"id":"9.4","name":"Audit & Compliance","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/audit/index.ts"},{"id":"9.5","name":"Plugin Manager","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/plugin-manager/index.ts"},{"id":"9.6","name":"Performance Audit","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/performance-audit/index.ts"},{"id":"9.7","name":"Routing Audit","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/routing-audit/index.ts"},{"id":"9.8","name":"Recommendation","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/recommendation/index.ts"},{"id":"9.9","name":"Alert","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/alert/index.ts"},{"id":"20.1","name":"Hotel Search Aggregator","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-search/index.ts"},{"id":"20.2","name":"Property Deduplication","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/property-dedup/index.ts"},{"id":"20.3","name":"Hotel Content Normalization","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/content-normalization/index.ts"},{"id":"20.4","name":"Hotel Rate Comparison","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/rate-comparison/index.ts"},{"id":"20.5","name":"Hotel Booking","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-booking/index.ts"},{"id":"20.6","name":"Hotel Modification & Cancellation","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-modification/index.ts"},{"id":"20.7","name":"Confirmation Verification","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/confirmation-verification/index.ts"},{"id":"20.8","name":"Activity Search","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/activity-search/index.ts"},{"id":"20.9","name":"Transfer Search","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/transfer-search/index.ts"}],"edges":[{"source":"1.1","target":"1.4","kind":"workflow","label":"search_to_price"},{"source":"1.4","target":"2.1","kind":"workflow","label":"search_to_price"},{"source":"2.1","target":"2.2","kind":"workflow","label":"search_to_price"},{"source":"2.2","target":"2.3","kind":"workflow","label":"search_to_price"},{"source":"3.3","target":"3.1","kind":"workflow","label":"book_to_ticket"},{"source":"3.1","target":"3.2","kind":"workflow","label":"book_to_ticket"},{"source":"3.2","target":"4.1","kind":"workflow","label":"book_to_ticket"},{"source":"1.1","target":"1.4","kind":"workflow","label":"full_booking"},{"source":"1.4","target":"2.1","kind":"workflow","label":"full_booking"},{"source":"2.1","target":"2.2","kind":"workflow","label":"full_booking"},{"source":"2.2","target":"2.3","kind":"workflow","label":"full_booking"},{"source":"2.3","target":"3.3","kind":"workflow","label":"full_booking"},{"source":"3.3","target":"3.1","kind":"workflow","label":"full_booking"},{"source":"3.1","target":"3.2","kind":"workflow","label":"full_booking"},{"source":"3.2","target":"4.1","kind":"workflow","label":"full_booking"},{"source":"5.1","target":"5.2","kind":"workflow","label":"exchange_flow"},{"source":"6.1","target":"6.2","kind":"workflow","label":"refund_flow"},{"source":"1.1","target":"0.1","kind":"package","label":"@otaip/agents-search → @otaip/agents-reference"},{"source":"2.1","target":"0.1","kind":"package","label":"@otaip/agents-pricing → @otaip/agents-reference"},{"source":"3.1","target":"0.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-reference"},{"source":"3.1","target":"1.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-search"},{"source":"3.1","target":"2.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-pricing"},{"source":"4.1","target":"3.1","kind":"package","label":"@otaip/agents-ticketing → @otaip/agents-booking"},{"source":"5.1","target":"1.1","kind":"package","label":"@otaip/agents-exchange → @otaip/agents-search"},{"source":"5.1","target":"4.1","kind":"package","label":"@otaip/agents-exchange → @otaip/agents-ticketing"},{"source":"6.1","target":"4.1","kind":"package","label":"@otaip/agents-settlement → @otaip/agents-ticketing"},{"source":"7.1","target":"0.1","kind":"package","label":"@otaip/agents-reconciliation → @otaip/agents-reference"}],"package_deps":[{"from_package":"@otaip/agents-search","to_package":"@otaip/agents-reference","from_stage":"search","to_stage":"reference"},{"from_package":"@otaip/agents-pricing","to_package":"@otaip/agents-reference","from_stage":"pricing","to_stage":"reference"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-reference","from_stage":"booking","to_stage":"reference"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-search","from_stage":"booking","to_stage":"search"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-pricing","from_stage":"booking","to_stage":"pricing"},{"from_package":"@otaip/agents-ticketing","to_package":"@otaip/agents-booking","from_stage":"ticketing","to_stage":"booking"},{"from_package":"@otaip/agents-exchange","to_package":"@otaip/agents-search","from_stage":"exchange","to_stage":"search"},{"from_package":"@otaip/agents-exchange","to_package":"@otaip/agents-ticketing","from_stage":"exchange","to_stage":"ticketing"},{"from_package":"@otaip/agents-settlement","to_package":"@otaip/agents-ticketing","from_stage":"settlement","to_stage":"ticketing"},{"from_package":"@otaip/agents-reconciliation","to_package":"@otaip/agents-reference","from_stage":"reconciliation","to_stage":"reference"}]},"docs":{"0.1":{"id":"0.1","summary":"Resolves IATA/ICAO airport and city codes to canonical airport records with multi-airport city awareness and historical code handling","className":"AirportCodeResolver","input":"`code` -- IATA 3-letter, ICAO 4-letter, city code, or airport name\n`code_type?` -- `'iata' | 'icao' | 'city' | 'name' | 'auto'` (auto-detected if omitted)\n`include_metro?` -- return all airports in a metro/city code (default: true)\n`include_decommissioned?` -- resolve retired/reassigned codes (default: false)","output":"`resolved_airport` -- canonical airport record (IATA, ICAO, name, city, country, timezone, lat/lon, type, status)\n`metro_airports` -- list of airports in the same metro area\n`match_confidence` -- 0-1 confidence score\n`stale_data?` -- true when dataset is older than 30 days\n`suggestion?` -- fuzzy match suggestion when code not found","usage":"const agent = new AirportCodeResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'JFK', code_type: 'iata' } });\n// result.data.resolved_airport.name => \"John F Kennedy International Airport\"","status":"Implemented","purpose":"Resolves IATA/ICAO airport and city codes to canonical airport records with multi-airport city awareness, fuzzy name matching, and historical code handling."},"0.2":{"id":"0.2","summary":"Resolves IATA/ICAO airline designator codes to canonical airline records with alliance membership mapping and codeshare partner networks","className":"AirlineCodeMapper","input":"`code` -- IATA 2-letter, ICAO 3-letter, or airline name\n`code_type?` -- `'iata' | 'icao' | 'name' | 'auto'`\n`include_codeshares?` -- include codeshare partners (default: false)\n`include_defunct?` -- include ceased-operations airlines (default: false)","output":"`airline` -- canonical airline record (codes, name, callsign, country, alliance, hubs, status)\n`codeshare_partners` -- partner airline list with relationship type\n`match_confidence` -- 0-1 confidence score","usage":"const agent = new AirlineCodeMapper();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'UA', include_codeshares: true } });\n// result.data.airline.name => \"United Airlines\"","status":"Implemented"},"0.3":{"id":"0.3","summary":"Decodes ATPCO-standard fare basis codes into human-readable components including cabin class, fare restrictions, advance purchase requirements, and penalty information","className":"FareBasisDecoder","input":"`fare_basis` -- ATPCO fare basis code (max 15 chars, e.g., `\"YOW3M1\"`, `\"TLXP14NR\"`)\n`carrier?` -- IATA airline code for carrier-specific decoding","output":"`decoded` -- parsed components (primary code, cabin class, fare type, season, day-of-week, advance purchase, min/max stay, penalties, ticket designator)\n`match_confidence` -- 1.0 = fully decoded, 0.5-0.9 = partial\n`unparsed_segments` -- parts that could not be decoded","usage":"const agent = new FareBasisDecoder();\nawait agent.initialize();\nconst result = await agent.execute({ data: { fare_basis: 'Y26NR' } });\n// result.data.decoded.cabin_class => \"economy\"","status":"Implemented"},"0.4":{"id":"0.4","summary":"Maps single-letter booking class codes to cabin class, fare family, upgrade eligibility, and loyalty program earning rates","className":"ClassOfServiceMapper","input":"`booking_class` -- single letter A-Z\n`carrier` -- IATA 2-letter airline code (required -- meanings are carrier-specific)\n`include_loyalty?` -- include loyalty earning rates (default: false)","output":"`mapping` -- cabin class, brand name, fare family, upgrade eligibility/type, same-day change, seat selection, refundable, priority level, loyalty earning\n`match_confidence` -- 1.0 = carrier-specific, 0.7 = IATA default, 0 = unknown","usage":"const agent = new ClassOfServiceMapper();\nawait agent.initialize();\nconst result = await agent.execute({ data: { booking_class: 'J', carrier: 'UA', include_loyalty: true } });\n// result.data.mapping.cabin_class => \"business\"","status":"Implemented","purpose":"Maps single-letter booking class codes to cabin class, fare family, upgrade eligibility, and loyalty program earning rates. Booking classes are carrier-specific."},"0.5":{"id":"0.5","summary":"Resolves IATA aircraft equipment codes to structured equipment data","className":"EquipmentTypeResolver","input":"`operation` -- `'resolve' | 'getSeatingConfig' | 'isWidebody' | 'getSimilarTypes'`\n`code` -- IATA equipment code (e.g., `\"789\"`, `\"320\"`)\n`cabin?` -- cabin code (`'F' | 'C' | 'W' | 'Y'`) for `getSeatingConfig`","output":"`equipment?` -- full equipment info (IATA/ICAO codes, manufacturer, family, body type, seats, range)\n`seatCount?` -- seat count for specific cabin\n`isWidebody?` -- boolean\n`similarTypes?` -- IATA codes of similar aircraft","usage":"const agent = new EquipmentTypeResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { operation: 'resolve', code: '789' } });\n// result.data.equipment.manufacturer => \"Boeing\"","status":"Implemented","purpose":"Resolves IATA aircraft equipment codes to structured equipment data including manufacturer, body type, typical seating, range, and max capacity."},"0.6":{"id":"0.6","summary":"Resolves ISO 4217 currency codes and IATA tax/surcharge codes used in airline pricing and ticketing","className":"CurrencyTaxResolver","input":"`code` -- ISO currency code or IATA tax code\n`code_type?` -- `'currency' | 'tax' | 'auto'`\n`country?` -- ISO 2-letter country code to filter tax applicability","output":"`currency` -- currency details (code, name, symbol, minor units, countries, active status)\n`tax` -- tax details (code, name, description, category, country, applies-to, percentage flag)\n`match_confidence` -- 0-1 confidence score","usage":"const agent = new CurrencyTaxResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'USD' } });\n// result.data.currency.name => \"US Dollar\"","status":"Implemented"},"0.7":{"id":"0.7","summary":"APIS requirements, visa requirements, restriction levels. Static dataset -- must NOT be used as legal travel advice","className":"CountryRegulatoryResolver","input":"`operation` -- `'getAPISRequirements' | 'getVisaRequirement' | 'getRestrictionLevel'`\n`countryCode?` -- ISO 2-letter (for APIS and restriction)\n`nationalityCode?` -- ISO 2-letter (for visa)\n`destinationCode?` -- ISO 2-letter (for visa)","output":"`apis?` -- APIS requirements (required fields, advance submission hours)\n`visa?` -- visa requirement (type, max stay days)\n`restriction?` -- restriction level 1-4 with summary","usage":"const agent = new CountryRegulatoryResolver();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { operation: 'getVisaRequirement', nationalityCode: 'US', destinationCode: 'GB' }\n});\n// result.data.visa.requirement => \"visa_free\"","status":"Implemented"},"1.1":{"id":"1.1","summary":"Queries distribution adapters in parallel, normalizes, deduplicates, filters, and sorts flight availability offers","className":"AvailabilitySearch","input":"`origin` -- origin airport/city IATA code\n`destination` -- destination airport/city IATA code\n`departure_date` -- ISO 8601 date\n`return_date?` -- ISO 8601 date for round-trip\n`passengers` -- `PassengerCount[]`\n`cabin_class?` -- `'economy' | 'premium_economy' | 'business' | 'first'`\n`direct_only?` -- only direct flights\n`max_connections?` -- 0-5\n`currency?` -- ISO 4217\n`max_results?` -- 1-200\n`sort_by?` -- `'price' | 'duration' | 'departure' | 'arrival' | 'connections'`\n`sort_order?` -- `'asc' | 'desc'`\n`sources?` -- specific adapter names to query","output":"`offers` -- deduplicated, filtered, sorted `SearchOffer[]`\n`total_raw_offers` -- count before deduplication\n`source_status` -- per-adapter query status (success, count, error, response time)\n`truncated` -- whether results were capped","usage":"new AvailabilitySearch(adapters: DistributionAdapter[]) Then call initialize() and execute({ data }).","status":"Implemented"},"1.2":{"id":"1.2","summary":"Looks up flight schedules with SSIM operating day parsing, codeshare detection, and connection discovery","className":"ScheduleLookup","input":"`origin` -- airport IATA code\n`destination` -- airport IATA code\n`date` -- ISO 8601 date\n`carrier?` -- filter by carrier IATA code\n`flight_number?` -- specific flight (requires carrier)\n`include_codeshares?` -- default: true\n`include_connections?` -- discover connecting options (default: false)","output":"`flights` -- `ScheduledFlight[]` (carrier, flight number, times, duration, schedule, codeshare info)\n`connections` -- `ConnectionOption[]` (two-leg connections with timing)\n`operates_on_date` -- whether any flights operate on the requested date","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.3":{"id":"1.3","summary":"Validates connections against MCT rules, scores connection quality, and checks interline agreements","className":"ConnectionBuilder","input":"`arriving_segment` -- `FlightSegment` (from `@otaip/core`)\n`departing_segment` -- `FlightSegment`\n`connection_airport` -- IATA 3-letter code\n`has_checked_bags?` -- affects MCT\n`is_interline?` -- different carriers","output":"`validation` -- MCT check result (valid, available/required minutes or null when unavailable, buffer, applied rule)\n`quality` -- connection quality score 0-1 with factor breakdown\n`interline` -- interline agreement check (if different carriers)\n`warnings` -- connection warnings","status":"Implemented","purpose":"Validates connections against MCT (Minimum Connecting Time) rules, scores connection quality, and checks interline agreements.\n\nMCT authority: **IATA SSIM Chapter 8** + **PSC Resolution 765** (`docs/knowledge-base/mct.md`). Curated rows live under `data/reference/mct/`. Resolution hierarchy: carrier override → airport+terminal → airport → **fail-closed** (no invented global/airport-constant table).","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.4":{"id":"1.4","summary":"Multi-source fare comparison with fare basis decoding, class mapping, branded fare family grouping, and passenger type pricing","className":"FareShopping","input":"`origin`, `destination`, `departure_date`, `passengers` -- same as availability search\n`cabin_class?`, `currency?`, `sources?` -- filters\n`decode_fare_basis?` -- decode fare basis codes (default: true)\n`group_by_fare_family?` -- group by basic/standard/flex/premium (default: true)","output":"`fares` -- `FareOffer[]` sorted by price, each with decoded fare basis, class info, fare family, passenger pricing\n`fare_families` -- grouped by family with cheapest/most expensive\n`total_fares` -- count\n`sources_queried` -- adapter names","usage":"new FareShopping(adapters: DistributionAdapter[]) Then call initialize() and execute({ data }).","status":"Implemented"},"1.5":{"id":"1.5","summary":"Searches ancillary offers (seats, bags, meals) across distribution adapters","className":"AncillaryShoppingAgent","input":"`segments` -- flight segments (origin, destination, flight number, date, carrier)\n`passengers` -- passenger references with type (ADT/CHD/INF)\n`pnrRef?` -- PNR reference\n`requestedCategories?` -- filter by category (BAGGAGE, SEAT, MEAL, etc.)","output":"`ancillaries` -- `AncillaryOffer[]` with RFIC/RFISC codes, pricing, availability\n`notSupportedByAdapter` -- true if no adapter configured\n`currency` -- pricing currency","status":"Implemented","purpose":"Searches for available ancillaries (baggage, seats, meals, lounge, Wi-Fi, priority) via an injectable adapter.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.6":{"id":"1.6","summary":"Deduplicates and normalizes flight results from multiple adapter sources","className":"MultiSourceAggregatorAgent","input":"`results` -- `AdapterSearchResult[]` (adapter name, flights, errors, response time)\n`deduplicationStrategy` -- `'keep_cheapest' | 'keep_all' | 'keep_first'`\n`rankBy` -- `'price' | 'duration' | 'stops'`\n`maxResults?` -- limit output count","output":"`flights` -- `NormalizedFlight[]` with sources, lowest price, all prices across adapters\n`totalRaw` -- raw count before dedup\n`totalAfterDedup` -- final count\n`adapterSummary` -- per-adapter stats","status":"Implemented","purpose":"Aggregates search results from multiple adapters with deduplication, price comparison, and ranking.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.7":{"id":"1.7","summary":"Stub agent for hotel and car rental search via distribution adapters","className":"HotelCarSearchAgent","input":"`operation` -- `'searchHotels' | 'searchCars'`\n`hotel?` -- hotel search params (destination, dates, rooms, adults, star rating, max rate)\n`car?` -- car search params (pickup/dropoff location and times, category, driver age)","output":"`hotelResults?` -- hotel offers with rate, room type, cancellation policy\n`carResults?` -- car offers with category, supplier, daily/total rate, features","status":"Implemented (adapter-dependent)","purpose":"Car rental search (and, pending a deferred car-only migration, hotel) via pluggable adapters. Returns empty results when no adapters configured.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.8":{"id":"1.8","summary":"Natural language travel query understanding with injectable LLM provider; parses user queries into structured search parameters","className":"AITravelAdvisorAgent","input":"`query` -- natural language travel query\n`travelerContext?` -- preferences (cabin, budget, preferred airlines, passenger counts)","output":"`searchParameters` -- extracted origin, destination, dates, trip type, cabin, passengers, flexible dates\n`summary` -- natural language summary of interpreted query\n`intent` -- `'flight_search' | 'hotel_search' | 'destination_recommendation' | 'price_check' | 'trip_planning' | 'unknown'`","usage":"new AITravelAdvisorAgent({ llmProvider, maxTokens?, temperature? }) Then call initialize() and execute({ data }).","status":"Implemented"},"1.9":{"id":"1.9","summary":"Stateless, deterministic scoring engine for flight offers with multi-dimensional scoring, hard filtering, and full audit trail (lives in @otaip/core)","className":"OfferEvaluatorAgent","input":"`offers` -- `EvaluatorOffer[]` with price, itinerary (segments, duration, connections)\n`constraints?` -- latest arrival, prefer direct, max connections, price ceiling, preferred/blacklisted carriers\n`profile?` -- `'BUSINESS_TIME_CRITICAL' | 'BUSINESS_PRICE_CONSTRAINED' | 'LEISURE' | 'CORPORATE_POLICY' | 'CUSTOM'`\n`weights?` -- custom scoring weights (time_buffer, price, connection_quality, journey_duration)","output":"Scored and ranked offers with structured explanation for LLM translation","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.1":{"id":"2.1","summary":"Parses ATPCO fare rules (categories 1-20) into human-readable structured format using curated tariff snapshot data","className":"FareRuleAgent","input":"`fare_basis` -- fare basis code\n`carrier` -- marketing carrier IATA code\n`origin` -- origin IATA code\n`destination` -- destination IATA code\n`travel_date?` -- ISO date for date-based rule filtering\n`categories?` -- specific ATPCO categories 1-50 (all if omitted)","output":"`rules` -- `FareRuleResult[]` with parsed categories, penalty summary, advance purchase, min/max stay, seasonality\n`total_rules` -- count of matched rules\n`valid_for_date` -- whether fare is valid for the specified travel date\n`in_blackout` -- whether travel date falls in a blackout period","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.2":{"id":"2.2","summary":"NUC x ROE fare construction with mileage validation, HIP/BHC/CTM checks, surcharges, and IATA rounding. All financial math uses decimal.js","className":"FareConstruction","input":"`journey_type` -- `'OW' | 'RT' | 'CT'` (one-way, round-trip, circle-trip)\n`components` -- fare components (origin, destination, carrier, fare basis, NUC amount)\n`selling_currency` -- ISO 4217 currency\n`point_of_sale?` -- country for IROE selection context\n`data_sources?` -- licensed `{ iroe, rounding_024d, mileage }` (required for a constructed fare)","output":"Success (`FareConstructionOutput`): `total_nuc`, `iroe` (alias `roe`), `local_amount` after 024d, `rounding_method` (`HX`|`NX`), published `mileage_checks`, HIP/BHC/CTM sketches, `audit_trail`\nOr `DomainInputRequired` when licensed data is missing","status":"Implemented","purpose":"NUC × IROE construction with published TPM/MPM, Resolution **024d** (HX/NX) rounding, and fail-closed HIP/BHC/CTM hooks. All financial math uses `decimal.js`.\n\nLicensed IROE / 024d / TPM-MPM data are **not** shipped in the package. Pass them via `data_sources`. Missing IROE, TPM, or 024d → `DomainInputRequired`. Haversine-as-TPM and banker's rounding are banned.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.3":{"id":"2.3","summary":"Per-segment tax computation with exemption engine, ~30 countries, ~50 tax codes, currency conversion. All financial math uses decimal.js","className":"TaxCalculation","input":"`segments` -- itinerary segments (origin/destination airports and countries, carrier, cabin class, base fare NUC)\n`passenger_type` -- `'adult' | 'child' | 'infant' | 'crew' | 'diplomatic'`\n`is_transit` -- whether transit/connection (\u003c 24h same ticket)\n`is_involuntary` -- whether involuntary reroute\n`total_base_fare_nuc` -- total base fare for percentage-based taxes\n`selling_currency` -- ISO 4217","output":"`taxes` -- `AppliedTax[]` (code, name, country, type, amounts, segment indices, interlineable, exempt status)\n`total_tax` -- total in selling currency\n`breakdown` -- by country, interlineable/non-interlineable totals\n`exemptions_applied` -- list of exemption reasons\n`segments_processed` -- count","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.4":{"id":"2.4","summary":"Builds priced offers with TTL management and optional persistence adapter","className":"OfferBuilderAgent","input":"`operation` -- `'buildOffer' | 'getOffer' | 'validateOffer' | 'markUsed' | 'expireOffer' | 'cleanExpired'`\n`buildInput?` -- segments, fare, taxes, ancillaries, passenger count, pricing source, TTL\n`offerId?` -- for get/validate/mark/expire operations\n`currentTime?` -- ISO timestamp override","output":"`offer?` -- full offer record with pricing breakdown, TTL, status\n`valid?` -- offer validity result\n`reason?` -- validation failure reason\n`cleanedCount?` -- number of expired offers cleaned","usage":"new OfferBuilderAgent({ persistence?: PersistenceAdapter }) Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Builds, caches, validates, and manages pricing offers with TTL expiration. Supports in-memory or pluggable persistence."},"2.5":{"id":"2.5","summary":"Validates flight offers against corporate travel policies (cabin, budget, advance purchase)","className":"CorporatePolicyValidationAgent","input":"`offer` -- offer details (cabin, fare amount, carrier, fare basis, advance booking days, segments)\n`policy` -- corporate policy (cabin rules, fare rules, booking rules, bypass codes)\n`bypassCode?` -- authorization code to bypass soft violations","output":"`result` -- `'APPROVED' | 'SOFT_VIOLATION' | 'HARD_VIOLATION'`\n`violations` -- `PolicyViolation[]` with rule, severity, detail\n`bypassApplied` -- whether bypass was used","status":"Implemented","purpose":"Validates flight offers against corporate travel policies: cabin class limits, fare ceilings, blocked carriers, advance booking requirements. Supports bypass codes.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.6":{"id":"2.6","summary":"Placeholder -- not yet implemented. Requires revenue management integration","className":"DynamicPricingAgent","status":"Coming Soon (stub)","purpose":"Revenue management integration for dynamic fare adjustments. Requires revenue management integration before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"2.7":{"id":"2.7","summary":"Placeholder -- not yet implemented. Requires revenue management integration","className":"RevenueManagementAgent","status":"Coming Soon (stub)","purpose":"Revenue management system integration. Requires revenue management domain input before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"3.1":{"id":"3.1","summary":"Routes booking requests to the correct distribution channel based on carrier config, codeshare rules, and NDC capability","className":"GdsNdcRouter","input":"`segments` -- routing segments (marketing/operating carrier, origin, destination, flight number)\n`preferred_channel?` -- `'GDS' | 'NDC' | 'DIRECT'`\n`preferred_gds?` -- `'AMADEUS' | 'SABRE' | 'TRAVELPORT'`\n`include_fallbacks` -- whether to include fallback channels","output":"`routings` -- per-segment channel routing (primary channel, GDS system, NDC version, fallbacks, booking format)\n`unified_channel` -- whether all segments can use the same channel\n`recommended_channel` -- best channel for entire itinerary\n`gds_format` / `ndc_format` -- format translation stubs","status":"Implemented","purpose":"Routes booking requests to the correct distribution channel (GDS, NDC, or direct API) based on carrier config, codeshare rules, and NDC capability. Per-segment routing with fallback support.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.2":{"id":"3.2","summary":"Constructs GDS-ready PNR commands from normalized booking data. Supports Amadeus, Sabre, and Travelport syntax","className":"PnrBuilder","input":"`gds` -- `'AMADEUS' | 'SABRE' | 'TRAVELPORT'`\n`passengers` -- name, type, DOB, passport, gender, nationality, FOID\n`segments` -- carrier, flight, class, date, origin, destination, status\n`contacts` -- phone, email, type\n`ticketing` -- time limit, type\n`received_from` -- agent identifier\n`ssrs?` -- SSR elements (WCHR, VGML, DOCS, FOID, CTCE, CTCM, INFT)\n`osis?` -- OSI elements\n`is_group?` / `group_name?` -- group PNR support","output":"`gds` -- target GDS\n`commands` -- ordered `PnrCommand[]` with GDS command strings and descriptions\n`passenger_count`, `segment_count`, `is_group`, `infant_count`","status":"Implemented","purpose":"Constructs GDS-ready PNR commands from normalized booking data. Supports Amadeus, Sabre, and Travelport syntax including names, segments, contacts, ticketing, SSR/OSI elements, and group bookings.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.3":{"id":"3.3","summary":"Pre-ticketing validation -- 13 checks to catch errors before ADMs","className":"PnrValidation","input":"`record_locator` -- 6-char PNR\n`passengers` -- passenger data (name, type, DOB, nationality, passport)\n`segments` -- segment data (carrier, flight, status, class, international flag, married group)\n`contact?` -- phone/email\n`ticketing?` -- time limit, arranged status\n`fare?` -- fare data with advance purchase deadline\n`validation_date?` -- ISO date override","output":"`record_locator` -- PNR\n`checks` -- `ValidationCheck[]` (13 checks, each with pass/fail, severity, message)\n`valid` -- overall pass/fail\n`error_count`, `warning_count`","status":"Implemented","purpose":"Pre-ticketing validation with 13 checks to catch errors before ADMs: segment status, passenger data, APIS, ticketing deadline, fare consistency, and more.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.4":{"id":"3.4","summary":"GDS queue monitoring and processing -- priority assignment, categorization, action routing, and queue command generation","className":"QueueManagement","input":"`entries` -- queue items (record locator, GDS, queue number, entry type, deadline, remark)\n`current_time?` -- ISO timestamp for priority calculation\n`gds?` -- GDS system for command generation\n`queue_number?` -- queue to generate read commands for\n`travelport_host?` -- `'APOLLO' | 'GALILEO' | 'WORLDSPAN'` when `gds` is `TRAVELPORT`","output":"`results` -- processed items with priority, status, recommended action, target agent\n`commands?` -- GDS queue commands\n`summary` -- counts by priority (urgent/high/normal/low)","status":"Implemented","purpose":"GDS queue monitoring and processing: priority assignment, categorization, action routing, and queue command generation.\n\nTravelport place/list/remove commands are **per host** (Apollo / Galileo≡Travelport+ / Worldspan) from the public format-compare table — see `docs/knowledge-base/tmc-mid-office-ttl-queues.md`. TTL priority uses Zulu deadline-day urgency.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.5":{"id":"3.5","summary":"Universal HTTP client with circuit breaker, retry logic, timeout handling, rate limiting, and IATA error normalization","className":"ApiAbstraction","input":"`request` -- API request (provider ID, HTTP method, path, headers, body)\n`max_retries?` -- override retry count\n`timeout_ms?` -- override timeout\n`force?` -- skip circuit breaker check","output":"`response` -- API response (status, headers, body, duration, retries)\n`error` -- normalized error (category, original code, retryable flag)\n`circuit_breaker` -- circuit breaker status\n`rate_limit` -- rate limit status\n`success` -- boolean","usage":"new ApiAbstraction(handler?: RequestHandler) Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Universal HTTP client with circuit breaker, retry logic, timeout handling, rate limiting, and IATA error normalization for GDS/NDC/payment providers."},"3.6":{"id":"3.6","summary":"Travel order lifecycle management -- create, modify, cancel, retrieve, and list orders with status tracking and transition validation","className":"OrderManagement","input":"`operation` -- `'createOrder' | 'modifyOrder' | 'cancelOrder' | 'getOrder' | 'listOrders'`\n`createOrder?` -- passenger, items, currency, source\n`modifyOrder?` -- order ID, updated items/details, reason\n`cancelOrder?` -- order ID, reason\n`getOrder?` / `listOrders?` -- retrieval/filtering","output":"`order?` -- order record with status, items, history\n`orders?` -- list of orders\n`operation`, `success`, `errorCode?`, `errorMessage?`","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.7":{"id":"3.7","summary":"PCI-safe payment instruction builder and transaction recorder. Validates forms of payment, builds GDS FOP strings -- never handles raw card numbers","className":"PaymentProcessing","input":"`operation` -- `'validateFOP' | 'buildPaymentInstruction' | 'recordPayment' | 'getPaymentRecord' | 'buildGDSFOPString'`\nOperation-specific data: FOP details (CC_TOKEN, BSP_CASH, AIRLINE_CREDIT, VOUCHER, UATP), amounts, references","output":"`validation?` -- FOP validation result\n`instruction?` -- payment instruction with GDS string, PCI-safe flag\n`record?` -- payment transaction record\n`gdsString?` -- GDS FOP string","status":"Implemented","purpose":"PCI-safe payment instruction builder and transaction recorder. Validates forms of payment, builds GDS FOP strings, records transactions. Never handles raw card numbers.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.8":{"id":"3.8","summary":"Retrieves an existing PNR/booking by record locator across distribution adapters. Read-only -- no side effects","className":"PnrRetrieval","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"4.1":{"id":"4.1","summary":"ETR generation with conjunction ticket support, BSP reporting, and commission handling","className":"TicketIssuance","input":"`record_locator` -- 6-char PNR\n`issuing_carrier` -- 2-letter IATA code\n`passenger_name` -- LAST/FIRST format\n`segments` -- flight segments with carrier, flight number, class, fare basis, dates, baggage\n`base_fare`, `base_fare_currency` -- fare amount\n`equivalent_fare?`, `equivalent_fare_currency?` -- currency conversion\n`taxes` -- tax breakdown items\n`fare_calculation` -- fare calculation line\n`form_of_payment` -- CASH, CREDIT_CARD, INVOICE, MISCELLANEOUS\n`endorsements?`, `commission?`, `bsp_reporting?`, `original_issue?`","output":"`tickets` -- `TicketRecord[]` (13-digit number, coupons with status, fare/tax breakdown, FOP, commission, BSP fields)\n`total_coupons` -- total across all tickets\n`is_conjunction` -- whether conjunction tickets were generated","status":"Implemented","purpose":"ETR (Electronic Ticket Record) generation with conjunction ticket support (auto-split for >4 coupons), BSP reporting fields, and commission handling.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.2":{"id":"4.2","summary":"EMD-A (associated) and EMD-S (standalone) issuance, RFIC/RFISC handling, coupon lifecycle","className":"EmdManagement","input":"`emd_type` -- `'EMD-A' | 'EMD-S'`\n`record_locator`, `issuing_carrier`, `passenger_name`\n`services` -- array of services with RFIC code (A-G), RFISC, description, amount, associated ticket/coupon for EMD-A\n`related_ticket_number?` -- for EMD-A","output":"`emd` -- `EmdRecord` (13-digit EMD number, coupons, amounts)\n`coupon_count`","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.3":{"id":"4.3","summary":"Ticket/EMD void processing -- coupon status check, carrier void window, BSP/ARC cut-off validation","className":"VoidAgent","input":"`document_number` -- 13-digit ticket/EMD number\n`issuing_carrier` -- 2-letter IATA code\n`coupons` -- coupon numbers and current statuses\n`issue_datetime` -- ISO datetime of issuance\n`current_datetime?` -- ISO datetime for void window check\n`settlement_system?` -- `'BSP' | 'ARC'`\n`bsp_cutoff_time?` -- HH:MM format","output":"`result` -- void permitted flag, rejection reason, message, void window hours, hours remaining, updated coupon statuses","status":"Implemented","purpose":"Ticket/EMD void processing with coupon status validation, carrier-specific void window enforcement, and BSP/ARC cut-off time checking.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.4":{"id":"4.4","summary":"Multi-channel itinerary rendering: Email (HTML+plain), SMS, WhatsApp. Carrier-neutral templates","className":"ItineraryDelivery","input":"`record_locator` -- booking reference\n`passengers` -- name, ticket number, frequent flyer\n`flights` -- flight details (number, origin, destination, times, cabin, seat, aircraft)\n`total_fare?`, `fare_currency?`\n`contact` -- email, phone, WhatsApp number\n`channels` -- `('EMAIL' | 'SMS' | 'WHATSAPP')[]`\n`agency_name?` -- for itinerary header","output":"`rendered` -- per-channel content (HTML/plain text, subject, SMS segment count)\n`channels_rendered` -- successfully rendered channels","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.5":{"id":"4.5","summary":"APIS validation, passport validity, visa check (stub for Agent 0.7)","className":"DocumentVerification","input":"`passengers` -- ticket name, passport name, passport number/expiry/nationality, DOB, gender\n`segments` -- destination country and travel date\n`passport_validity_months?` -- minimum validity beyond travel date (default: 6)\n`validation_date?` -- ISO date override","output":"`results` -- per-passenger verification (pass/fail, individual checks with severity)\n`all_passed` -- overall pass/fail\n`blocking_failures`, `advisory_warnings` -- counts","status":"Implemented","purpose":"APIS validation, passport validity checking (configurable months threshold), and name matching between ticket and passport.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.1":{"id":"5.1","summary":"ATPCO Category 31 voluntary change assessment: change fees, fare difference, residual value, waiver codes","className":"ChangeManagement","input":"`original_ticket` -- ticket number, issuing carrier, passenger name, record locator, issue date, base fare, total tax, fare basis, refundable flag, booking date, `original_departure_date?` (for DOT 7-day check)\n`requested_itinerary` -- new segments (carrier, flight, origin, destination, date, class, fare basis), new fare, new taxes\n`waiver_code?` -- airline-provided waiver identity (not skip-penalty by itself)\n`waiver_effect?` -- required when `waiver_code` set: `ELIMINATE_PENALTY | REDUCE_PENALTY | CHANGE_REFUND_FORM | CHANGE_REBOOKING_CLASS | IRROP_INVOLUNTARY` (see `docs/knowledge-base/waiver-typology.md`)\n`waiver_penalty_reduction?` -- required for `REDUCE_PENALTY`\n`permitted_booking_classes?` / `permitted_fare_basis_patterns?` -- required for `CHANGE_REBOOKING_CLASS`\n`current_datetime?` -- ISO datetime\n`cat31_rules?` -- filed Cat 31 rules (omit → ATPCO default no charge)\n`us_dot_24h?` -- `part_259_applicable?`, `booking_channel?` (`airline_direct` | `agency` | `ndc` | `gds` | `unknown`)","output":"`assessment` -- action (`REISSUE | REBOOK | REJECT`), change fee, fare difference, additional collection, residual value, forfeited amount, tax difference, total due, Cat 31 `is_free_change` flag, summary\n`us_dot_24h` -- carrier remedy (`cancel` | `hold` | `unknown`), eligibility, ineligibility reasons (including `departure_within_7_days`, `channel_coverage_unknown`), entitlement (`penalty_free_cancel` | `unpaid_fare_hold` | `none` | `unknown`). **Not** a free-change boolean. Channel coverage follows carrier disclosure — not a baked-in “third-party never qualifies” rule.","status":"Implemented","purpose":"ATPCO Category 31 voluntary change assessment: change fees, fare difference, residual value, waiver codes, Cat 31 free-change window detection, and US DOT 14 CFR §259.5(b)(4) 24-hour reservation assessment (hold **or** cancel — carrier chooses; ≥7 days before departure). See `docs/knowledge-base/us-dot-24-hour-reservation.md`.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.2":{"id":"5.2","summary":"Ticket reissue with residual value, per-tax TFC carryforward (CARRY\\","className":"ExchangeReissue","input":"`original_ticket_number`, `conjunction_originals?`, `original_issue_date`\n`issuing_carrier`, `passenger_name`, `record_locator`\n`original_base_fare`, `original_taxes` -- from original ticket\n`change_fee`, `residual_value`, `waiver_code?` -- from Agent 5.1\n`new_segments` -- new flight segments\n`new_fare`, `new_fare_currency`, `new_taxes`, `fare_calculation`\n`form_of_payment` -- for additional collection\n`gds?` -- GDS for command generation\n`tax_carryforward_context` -- geography (`SAME_AIRPORT | SAME_CITY | DIFFERENT`), validity window flag, flown status, POS unchanged\n`tax_carryforward_rules` -- per-code rules covering every tax on original ∪ new (nature, min geography, YQ/YR flags, validity expiry action)\n`same_origin_destination?` -- **deprecated / ignored** for tax decisions (migration warning only)","output":"`reissue` -- new ticket record with full audit trail, exchange commands, `tax_decisions` on the audit trail\n`additional_collection` -- amount due\n`credit_amount` -- amount refundable if downgrade\n`tax_decisions` -- `{ tax_code, action: CARRY | RECALCULATE | FORFEIT, reason }[]`","status":"Implemented","purpose":"Ticket reissue with residual value application, **per-tax** carryforward (`CARRY | RECALCULATE | FORFEIT`), conjunction ticket handling, GDS exchange command generation, and full audit trail.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.3":{"id":"5.3","summary":"Carrier-initiated schedule change handling: trigger assessment, airline protection logic, regulatory entitlements (EU261, US DOT)","className":"InvoluntaryRebook","input":"`original_pnr` -- record locator, passenger, affected segment, issuing carrier, countries, checked-in flag, EU/Community carrier flag, optional endorsement\n`schedule_change` -- change type (incl. MISCONNECT), times, routing/equipment, misconnect shortfall\n`available_flights?` -- protection candidates with operating/marketing/alliance/interline + `endorsement_allows`\n`thresholds?` -- carrier-specific `time_change_minutes`, `measurement_point` (DEPARTURE|ARRIVAL), `misconnect_minutes` — required for those triggers\n`is_passenger_no_show?` -- no-show flag\n`is_oversale_denied_boarding?` -- only true for 14 CFR §250 oversales\n`eu261_inputs?` -- great-circle `distance_km` (Art.7(4)), delay/notice/rerouting/extraordinary, third-country benefits caveat","output":"`result` -- involuntary flag, trigger, ranked protection candidates (not executed), `art8_passenger_choice_required` + `art8_choices`, measurement point, regulatory flags (EU261/US DOT), original routing credit flag, summary","status":"Implemented","purpose":"Carrier-initiated schedule change / IRROP handling. Domain KB: `docs/knowledge-base/involuntary-rebook-irrop.md` (Regulation (EC) No 261/2004 — [CELEX:32004R0261](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32004R0261)).\n\n- **Triggers:** time change, routing change, equipment downgrade, cancellation, misconnect — with explicit dep vs arr measurement. **No hardcoded 60-minute threshold**; fail closed when carrier threshold input is missing.\n- **Reprotection candidates:** same operating → marketing → alliance → interline → other, with endorsement fail-closed. Alliance ≠ any alliance flight. **Do not silently \"same carrier first\"** — when EU261 applies, Art.8 passenger choice (refund vs re-route) is required before execution.\n- **EU261:** Art.3(1) matrix (EU depart any carrier / EU arrive Community carrier only). Art.7 compensation via great-circle bands only (never TPM). Art.8 choice surfaced on output.\n- **US DOT:** 14 CFR §250 IDB is oversale-specific — delays/cancels report `applies: false`.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.4":{"id":"5.4","summary":"Placeholder -- not yet implemented. Requires domain input on disruption priority rules","className":"DisruptionResponseAgent","status":"Coming Soon (stub)","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"5.5":{"id":"5.5","summary":"Placeholder -- not yet implemented. Requires domain input on change fee structures","className":"SelfServiceRebookingAgent","status":"Implemented","purpose":"Orchestrates Availability Search (1.1) and Change Management (5.1) to present priced rebooking alternatives (changeFee + fareDifference + taxDifference per option). Read-only -- does NOT execute the reissue; that is Exchange/Reissue (5.2). Involuntary reasons (schedule change / missed connection / cancellation) waive the change fee; voluntary changes honor ATPCO Cat 31 via 5.1.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"5.6":{"id":"5.6","summary":"Placeholder -- not yet implemented. Requires domain input on waitlist priority scoring","className":"WaitlistManagementAgent","status":"Implemented","purpose":"Stateful in-memory passenger waitlist queue with four operations: addEntry (priority computed at add time), clear (given N seats opened, remove top-N by priority), queryStatus (1-based position + estimated clearance probability), and expire (prune entries past their cutoff). State is in-memory only -- production deployments should pair it with a durable persistence layer.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"6.1":{"id":"6.1","summary":"ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting, conjunction ticket handling","className":"RefundProcessing","input":"`ticket_number`, `conjunction_tickets?`\n`issuing_carrier`, `passenger_name`, `record_locator`\n`base_fare`, `base_fare_currency`, `taxes`, `commission?`\n`refund_type` -- `'FULL' | 'PARTIAL' | 'TAX_ONLY'`\n`coupons_to_refund?` -- specific coupons (for partial)\n`total_coupons`, `waiver_code?`, `waiver_effect?` (required with code), `fare_basis`, `is_refundable`\n`waiver_penalty_reduction?`, `waiver_refund_form?` -- companions per typology in `docs/knowledge-base/waiver-typology.md`\n`settlement_system` -- `'BSP' | 'ARC'`","output":"`refund` -- penalty applied, base fare refund, tax refund, tax breakdown, commission recalled, net refund, BSP/ARC reporting fields, audit trail\n`net_refund_amount`, `commission_recalled`","status":"Implemented","purpose":"ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting fields, conjunction ticket handling. Supports full, partial, and tax-only refunds.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.2":{"id":"6.2","summary":"Pre-ticketing audit: 10 checks covering fare integrity, passive/UC/churn (history-required), married integrity, TTL, 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?` -- both caller-supplied; no embedded carrier tables\n`endorsement?`, `tour_code?`\n`is_net_remit?`, `net_contracted_amount?`\n`ttl_deadline?`, `ttl_timezone?`, `ttl_source?`, `current_datetime?`\n`duplicate_check_pnrs?`\n`segment_history?` -- required for churning; current status alone is insufficient\n`gds?` -- `SABRE` | `AMADEUS` | `TRAVELPORT` | `UNKNOWN` (Travelport DX marriage break)\n`churn_cycle_threshold?`, `churn_window_hours?`","output":"`result` -- all check results, overall pass/fail, blocking/warning counts","status":"Implemented","purpose":"Pre-ticketing audit with 10 checks: duplicate booking, fare/class mismatch, passive/unable/risky status (core HX/UC/UN/NO/TK + **per-host** maps — HN/PK/GK/YK are not universalized), churning (history-required), married segment integrity, TTL expiry (timezone / deadline-day), commission rate (caller-supplied only), 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.2.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.2.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/bsp-reconciliation/index.ts"},{"id":"7.2","name":"ARC Reconciliation","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/arc-reconciliation/index.ts"},{"id":"7.3","name":"Commission Management","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/commission-management/index.ts"},{"id":"7.4","name":"Interline Settlement","stage":"reconciliation","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/reconciliation/src/interline-settlement/index.ts"},{"id":"7.5","name":"Financial Reporting","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/financial-reporting/index.ts"},{"id":"7.6","name":"Revenue Accounting","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/revenue-accounting/index.ts"},{"id":"8.1","name":"Traveler Profile","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/traveler-profile/index.ts"},{"id":"8.2","name":"Corporate Account","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/corporate-account/index.ts"},{"id":"8.3","name":"Mid-Office Automation","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/mid-office/index.ts"},{"id":"8.4","name":"Reporting & Analytics","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/reporting/index.ts"},{"id":"8.5","name":"Duty of Care","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/duty-of-care/index.ts"},{"id":"9.1","name":"Orchestrator","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/orchestrator/index.ts"},{"id":"9.2","name":"Knowledge Retrieval","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/knowledge/index.ts"},{"id":"9.3","name":"Monitoring & Alerting","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/monitoring/index.ts"},{"id":"9.4","name":"Audit & Compliance","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/audit/index.ts"},{"id":"9.5","name":"Plugin Manager","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/plugin-manager/index.ts"},{"id":"9.6","name":"Performance Audit","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/performance-audit/index.ts"},{"id":"9.7","name":"Routing Audit","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/routing-audit/index.ts"},{"id":"9.8","name":"Recommendation","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/recommendation/index.ts"},{"id":"9.9","name":"Alert","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/alert/index.ts"},{"id":"20.1","name":"Hotel Search Aggregator","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-search/index.ts"},{"id":"20.2","name":"Property Deduplication","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/property-dedup/index.ts"},{"id":"20.3","name":"Hotel Content Normalization","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/content-normalization/index.ts"},{"id":"20.4","name":"Hotel Rate Comparison","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/rate-comparison/index.ts"},{"id":"20.5","name":"Hotel Booking","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-booking/index.ts"},{"id":"20.6","name":"Hotel Modification & Cancellation","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-modification/index.ts"},{"id":"20.7","name":"Confirmation Verification","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/confirmation-verification/index.ts"},{"id":"20.8","name":"Activity Search","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/activity-search/index.ts"},{"id":"20.9","name":"Transfer Search","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/transfer-search/index.ts"}],"edges":[{"source":"1.1","target":"1.4","kind":"workflow","label":"search_to_price"},{"source":"1.4","target":"2.1","kind":"workflow","label":"search_to_price"},{"source":"2.1","target":"2.2","kind":"workflow","label":"search_to_price"},{"source":"2.2","target":"2.3","kind":"workflow","label":"search_to_price"},{"source":"3.3","target":"3.1","kind":"workflow","label":"book_to_ticket"},{"source":"3.1","target":"3.2","kind":"workflow","label":"book_to_ticket"},{"source":"3.2","target":"4.1","kind":"workflow","label":"book_to_ticket"},{"source":"1.1","target":"1.4","kind":"workflow","label":"full_booking"},{"source":"1.4","target":"2.1","kind":"workflow","label":"full_booking"},{"source":"2.1","target":"2.2","kind":"workflow","label":"full_booking"},{"source":"2.2","target":"2.3","kind":"workflow","label":"full_booking"},{"source":"2.3","target":"3.3","kind":"workflow","label":"full_booking"},{"source":"3.3","target":"3.1","kind":"workflow","label":"full_booking"},{"source":"3.1","target":"3.2","kind":"workflow","label":"full_booking"},{"source":"3.2","target":"4.1","kind":"workflow","label":"full_booking"},{"source":"5.1","target":"5.2","kind":"workflow","label":"exchange_flow"},{"source":"6.1","target":"6.2","kind":"workflow","label":"refund_flow"},{"source":"1.1","target":"0.1","kind":"package","label":"@otaip/agents-search → @otaip/agents-reference"},{"source":"2.1","target":"0.1","kind":"package","label":"@otaip/agents-pricing → @otaip/agents-reference"},{"source":"3.1","target":"0.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-reference"},{"source":"3.1","target":"1.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-search"},{"source":"3.1","target":"2.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-pricing"},{"source":"4.1","target":"3.1","kind":"package","label":"@otaip/agents-ticketing → @otaip/agents-booking"},{"source":"5.1","target":"1.1","kind":"package","label":"@otaip/agents-exchange → @otaip/agents-search"},{"source":"5.1","target":"4.1","kind":"package","label":"@otaip/agents-exchange → @otaip/agents-ticketing"},{"source":"6.1","target":"4.1","kind":"package","label":"@otaip/agents-settlement → @otaip/agents-ticketing"},{"source":"7.1","target":"0.1","kind":"package","label":"@otaip/agents-reconciliation → @otaip/agents-reference"}],"package_deps":[{"from_package":"@otaip/agents-search","to_package":"@otaip/agents-reference","from_stage":"search","to_stage":"reference"},{"from_package":"@otaip/agents-pricing","to_package":"@otaip/agents-reference","from_stage":"pricing","to_stage":"reference"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-reference","from_stage":"booking","to_stage":"reference"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-search","from_stage":"booking","to_stage":"search"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-pricing","from_stage":"booking","to_stage":"pricing"},{"from_package":"@otaip/agents-ticketing","to_package":"@otaip/agents-booking","from_stage":"ticketing","to_stage":"booking"},{"from_package":"@otaip/agents-exchange","to_package":"@otaip/agents-search","from_stage":"exchange","to_stage":"search"},{"from_package":"@otaip/agents-exchange","to_package":"@otaip/agents-ticketing","from_stage":"exchange","to_stage":"ticketing"},{"from_package":"@otaip/agents-settlement","to_package":"@otaip/agents-ticketing","from_stage":"settlement","to_stage":"ticketing"},{"from_package":"@otaip/agents-reconciliation","to_package":"@otaip/agents-reference","from_stage":"reconciliation","to_stage":"reference"}]},"docs":{"0.1":{"id":"0.1","summary":"Resolves IATA/ICAO airport and city codes to canonical airport records with multi-airport city awareness and historical code handling","className":"AirportCodeResolver","input":"`code` -- IATA 3-letter, ICAO 4-letter, city code, or airport name\n`code_type?` -- `'iata' | 'icao' | 'city' | 'name' | 'auto'` (auto-detected if omitted)\n`include_metro?` -- return all airports in a metro/city code (default: true)\n`include_decommissioned?` -- resolve retired/reassigned codes (default: false)","output":"`resolved_airport` -- canonical airport record (IATA, ICAO, name, city, country, timezone, lat/lon, type, status)\n`metro_airports` -- list of airports in the same metro area\n`match_confidence` -- 0-1 confidence score\n`stale_data?` -- true when dataset is older than 30 days\n`suggestion?` -- fuzzy match suggestion when code not found","usage":"const agent = new AirportCodeResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'JFK', code_type: 'iata' } });\n// result.data.resolved_airport.name => \"John F Kennedy International Airport\"","status":"Implemented","purpose":"Resolves IATA/ICAO airport and city codes to canonical airport records with multi-airport city awareness, fuzzy name matching, and historical code handling."},"0.2":{"id":"0.2","summary":"Resolves IATA/ICAO airline designator codes to canonical airline records with alliance membership mapping and codeshare partner networks","className":"AirlineCodeMapper","input":"`code` -- IATA 2-letter, ICAO 3-letter, or airline name\n`code_type?` -- `'iata' | 'icao' | 'name' | 'auto'`\n`include_codeshares?` -- include codeshare partners (default: false)\n`include_defunct?` -- include ceased-operations airlines (default: false)","output":"`airline` -- canonical airline record (codes, name, callsign, country, alliance, hubs, status)\n`codeshare_partners` -- partner airline list with relationship type\n`match_confidence` -- 0-1 confidence score","usage":"const agent = new AirlineCodeMapper();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'UA', include_codeshares: true } });\n// result.data.airline.name => \"United Airlines\"","status":"Implemented"},"0.3":{"id":"0.3","summary":"Decodes ATPCO-standard fare basis codes into human-readable components including cabin class, fare restrictions, advance purchase requirements, and penalty information","className":"FareBasisDecoder","input":"`fare_basis` -- ATPCO fare basis code (max 15 chars, e.g., `\"YOW3M1\"`, `\"TLXP14NR\"`)\n`carrier?` -- IATA airline code for carrier-specific decoding","output":"`decoded` -- parsed components (primary code, cabin class, fare type, season, day-of-week, advance purchase, min/max stay, penalties, ticket designator)\n`match_confidence` -- 1.0 = fully decoded, 0.5-0.9 = partial\n`unparsed_segments` -- parts that could not be decoded","usage":"const agent = new FareBasisDecoder();\nawait agent.initialize();\nconst result = await agent.execute({ data: { fare_basis: 'Y26NR' } });\n// result.data.decoded.cabin_class => \"economy\"","status":"Implemented"},"0.4":{"id":"0.4","summary":"Maps single-letter booking class codes to cabin class, fare family, upgrade eligibility, and loyalty program earning rates","className":"ClassOfServiceMapper","input":"`booking_class` -- single letter A-Z\n`carrier` -- IATA 2-letter airline code (required -- meanings are carrier-specific)\n`include_loyalty?` -- include loyalty earning rates (default: false)","output":"`mapping` -- cabin class, brand name, fare family, upgrade eligibility/type, same-day change, seat selection, refundable, priority level, loyalty earning\n`match_confidence` -- 1.0 = carrier-specific, 0.7 = IATA default, 0 = unknown","usage":"const agent = new ClassOfServiceMapper();\nawait agent.initialize();\nconst result = await agent.execute({ data: { booking_class: 'J', carrier: 'UA', include_loyalty: true } });\n// result.data.mapping.cabin_class => \"business\"","status":"Implemented","purpose":"Maps single-letter booking class codes to cabin class, fare family, upgrade eligibility, and loyalty program earning rates. Booking classes are carrier-specific."},"0.5":{"id":"0.5","summary":"Resolves IATA aircraft equipment codes to structured equipment data","className":"EquipmentTypeResolver","input":"`operation` -- `'resolve' | 'getSeatingConfig' | 'isWidebody' | 'getSimilarTypes'`\n`code` -- IATA equipment code (e.g., `\"789\"`, `\"320\"`)\n`cabin?` -- cabin code (`'F' | 'C' | 'W' | 'Y'`) for `getSeatingConfig`","output":"`equipment?` -- full equipment info (IATA/ICAO codes, manufacturer, family, body type, seats, range)\n`seatCount?` -- seat count for specific cabin\n`isWidebody?` -- boolean\n`similarTypes?` -- IATA codes of similar aircraft","usage":"const agent = new EquipmentTypeResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { operation: 'resolve', code: '789' } });\n// result.data.equipment.manufacturer => \"Boeing\"","status":"Implemented","purpose":"Resolves IATA aircraft equipment codes to structured equipment data including manufacturer, body type, typical seating, range, and max capacity."},"0.6":{"id":"0.6","summary":"Resolves ISO 4217 currency codes and IATA tax/surcharge codes used in airline pricing and ticketing","className":"CurrencyTaxResolver","input":"`code` -- ISO currency code or IATA tax code\n`code_type?` -- `'currency' | 'tax' | 'auto'`\n`country?` -- ISO 2-letter country code to filter tax applicability","output":"`currency` -- currency details (code, name, symbol, minor units, countries, active status)\n`tax` -- tax details (code, name, description, category, country, applies-to, percentage flag)\n`match_confidence` -- 0-1 confidence score","usage":"const agent = new CurrencyTaxResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'USD' } });\n// result.data.currency.name => \"US Dollar\"","status":"Implemented"},"0.7":{"id":"0.7","summary":"APIS requirements, visa requirements, restriction levels. Static dataset -- must NOT be used as legal travel advice","className":"CountryRegulatoryResolver","input":"`operation` -- `'getAPISRequirements' | 'getVisaRequirement' | 'getRestrictionLevel'`\n`countryCode?` -- ISO 2-letter (for APIS and restriction)\n`nationalityCode?` -- ISO 2-letter (for visa)\n`destinationCode?` -- ISO 2-letter (for visa)","output":"`apis?` -- APIS requirements (required fields, advance submission hours)\n`visa?` -- visa requirement (type, max stay days)\n`restriction?` -- restriction level 1-4 with summary","usage":"const agent = new CountryRegulatoryResolver();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { operation: 'getVisaRequirement', nationalityCode: 'US', destinationCode: 'GB' }\n});\n// result.data.visa.requirement => \"visa_free\"","status":"Implemented"},"1.1":{"id":"1.1","summary":"Queries distribution adapters in parallel, normalizes, deduplicates, filters, and sorts flight availability offers","className":"AvailabilitySearch","input":"`origin` -- origin airport/city IATA code\n`destination` -- destination airport/city IATA code\n`departure_date` -- ISO 8601 date\n`return_date?` -- ISO 8601 date for round-trip\n`passengers` -- `PassengerCount[]`\n`cabin_class?` -- `'economy' | 'premium_economy' | 'business' | 'first'`\n`direct_only?` -- only direct flights\n`max_connections?` -- 0-5\n`currency?` -- ISO 4217\n`max_results?` -- 1-200\n`sort_by?` -- `'price' | 'duration' | 'departure' | 'arrival' | 'connections'`\n`sort_order?` -- `'asc' | 'desc'`\n`sources?` -- specific adapter names to query","output":"`offers` -- deduplicated, filtered, sorted `SearchOffer[]`\n`total_raw_offers` -- count before deduplication\n`source_status` -- per-adapter query status (success, count, error, response time)\n`truncated` -- whether results were capped","usage":"new AvailabilitySearch(adapters: DistributionAdapter[]) Then call initialize() and execute({ data }).","status":"Implemented"},"1.2":{"id":"1.2","summary":"Looks up flight schedules with SSIM operating day parsing, codeshare detection, and connection discovery","className":"ScheduleLookup","input":"`origin` -- airport IATA code\n`destination` -- airport IATA code\n`date` -- ISO 8601 date\n`carrier?` -- filter by carrier IATA code\n`flight_number?` -- specific flight (requires carrier)\n`include_codeshares?` -- default: true\n`include_connections?` -- discover connecting options (default: false)","output":"`flights` -- `ScheduledFlight[]` (carrier, flight number, times, duration, schedule, codeshare info)\n`connections` -- `ConnectionOption[]` (two-leg connections with timing)\n`operates_on_date` -- whether any flights operate on the requested date","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.3":{"id":"1.3","summary":"Validates connections against MCT rules, scores connection quality, and checks interline agreements","className":"ConnectionBuilder","input":"`arriving_segment` -- `FlightSegment` (from `@otaip/core`)\n`departing_segment` -- `FlightSegment`\n`connection_airport` -- IATA 3-letter code\n`has_checked_bags?` -- affects MCT\n`is_interline?` -- different carriers","output":"`validation` -- MCT check result (valid, available/required minutes or null when unavailable, buffer, applied rule)\n`quality` -- connection quality score 0-1 with factor breakdown\n`interline` -- interline agreement check (if different carriers)\n`warnings` -- connection warnings","status":"Implemented","purpose":"Validates connections against MCT (Minimum Connecting Time) rules, scores connection quality, and checks interline agreements.\n\nMCT authority: **IATA SSIM Chapter 8** + **PSC Resolution 765** (`docs/knowledge-base/mct.md`). Curated rows live under `data/reference/mct/`. Resolution hierarchy: carrier override → airport+terminal → airport → **fail-closed** (no invented global/airport-constant table).","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.4":{"id":"1.4","summary":"Multi-source fare comparison with fare basis decoding, class mapping, branded fare family grouping, and passenger type pricing","className":"FareShopping","input":"`origin`, `destination`, `departure_date`, `passengers` -- same as availability search\n`cabin_class?`, `currency?`, `sources?` -- filters\n`decode_fare_basis?` -- decode fare basis codes (default: true)\n`group_by_fare_family?` -- group by basic/standard/flex/premium (default: true)","output":"`fares` -- `FareOffer[]` sorted by price, each with decoded fare basis, class info, fare family, passenger pricing\n`fare_families` -- grouped by family with cheapest/most expensive\n`total_fares` -- count\n`sources_queried` -- adapter names","usage":"new FareShopping(adapters: DistributionAdapter[]) Then call initialize() and execute({ data }).","status":"Implemented"},"1.5":{"id":"1.5","summary":"Searches ancillary offers (seats, bags, meals) across distribution adapters","className":"AncillaryShoppingAgent","input":"`segments` -- flight segments (origin, destination, flight number, date, carrier)\n`passengers` -- passenger references with type (ADT/CHD/INF)\n`pnrRef?` -- PNR reference\n`requestedCategories?` -- filter by category (BAGGAGE, SEAT, MEAL, etc.)","output":"`ancillaries` -- `AncillaryOffer[]` with RFIC/RFISC codes, pricing, availability\n`notSupportedByAdapter` -- true if no adapter configured\n`currency` -- pricing currency","status":"Implemented","purpose":"Searches for available ancillaries (baggage, seats, meals, lounge, Wi-Fi, priority) via an injectable adapter.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.6":{"id":"1.6","summary":"Deduplicates and normalizes flight results from multiple adapter sources","className":"MultiSourceAggregatorAgent","input":"`results` -- `AdapterSearchResult[]` (adapter name, flights, errors, response time)\n`deduplicationStrategy` -- `'keep_cheapest' | 'keep_all' | 'keep_first'`\n`rankBy` -- `'price' | 'duration' | 'stops'`\n`maxResults?` -- limit output count","output":"`flights` -- `NormalizedFlight[]` with sources, lowest price, all prices across adapters\n`totalRaw` -- raw count before dedup\n`totalAfterDedup` -- final count\n`adapterSummary` -- per-adapter stats","status":"Implemented","purpose":"Aggregates search results from multiple adapters with deduplication, price comparison, and ranking.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.7":{"id":"1.7","summary":"Stub agent for hotel and car rental search via distribution adapters","className":"HotelCarSearchAgent","input":"`operation` -- `'searchHotels' | 'searchCars'`\n`hotel?` -- hotel search params (destination, dates, rooms, adults, star rating, max rate)\n`car?` -- car search params (pickup/dropoff location and times, category, driver age)","output":"`hotelResults?` -- hotel offers with rate, room type, cancellation policy\n`carResults?` -- car offers with category, supplier, daily/total rate, features","status":"Implemented (adapter-dependent)","purpose":"Car rental search (and, pending a deferred car-only migration, hotel) via pluggable adapters. Returns empty results when no adapters configured.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.8":{"id":"1.8","summary":"Natural language travel query understanding with injectable LLM provider; parses user queries into structured search parameters","className":"AITravelAdvisorAgent","input":"`query` -- natural language travel query\n`travelerContext?` -- preferences (cabin, budget, preferred airlines, passenger counts)","output":"`searchParameters` -- extracted origin, destination, dates, trip type, cabin, passengers, flexible dates\n`summary` -- natural language summary of interpreted query\n`intent` -- `'flight_search' | 'hotel_search' | 'destination_recommendation' | 'price_check' | 'trip_planning' | 'unknown'`","usage":"new AITravelAdvisorAgent({ llmProvider, maxTokens?, temperature? }) Then call initialize() and execute({ data }).","status":"Implemented"},"1.9":{"id":"1.9","summary":"Stateless, deterministic scoring engine for flight offers with multi-dimensional scoring, hard filtering, and full audit trail (lives in @otaip/core)","className":"OfferEvaluatorAgent","input":"`offers` -- `EvaluatorOffer[]` with price, itinerary (segments, duration, connections)\n`constraints?` -- latest arrival, prefer direct, max connections, price ceiling, preferred/blacklisted carriers\n`profile?` -- `'BUSINESS_TIME_CRITICAL' | 'BUSINESS_PRICE_CONSTRAINED' | 'LEISURE' | 'CORPORATE_POLICY' | 'CUSTOM'`\n`weights?` -- custom scoring weights (time_buffer, price, connection_quality, journey_duration)","output":"Scored and ranked offers with structured explanation for LLM translation","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.1":{"id":"2.1","summary":"Parses ATPCO fare rules (categories 1-20) into human-readable structured format using curated tariff snapshot data","className":"FareRuleAgent","input":"`fare_basis` -- fare basis code\n`carrier` -- marketing carrier IATA code\n`origin` -- origin IATA code\n`destination` -- destination IATA code\n`travel_date?` -- ISO date for date-based rule filtering\n`categories?` -- specific ATPCO categories 1-50 (all if omitted)","output":"`rules` -- `FareRuleResult[]` with parsed categories, penalty summary, advance purchase, min/max stay, seasonality\n`total_rules` -- count of matched rules\n`valid_for_date` -- whether fare is valid for the specified travel date\n`in_blackout` -- whether travel date falls in a blackout period","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.2":{"id":"2.2","summary":"NUC x ROE fare construction with mileage validation, HIP/BHC/CTM checks, surcharges, and IATA rounding. All financial math uses decimal.js","className":"FareConstruction","input":"`journey_type` -- `'OW' | 'RT' | 'CT'` (one-way, round-trip, circle-trip)\n`components` -- fare components (origin, destination, carrier, fare basis, NUC amount)\n`selling_currency` -- ISO 4217 currency\n`point_of_sale?` -- country for IROE selection context\n`data_sources?` -- licensed `{ iroe, rounding_024d, mileage }` (required for a constructed fare)","output":"Success (`FareConstructionOutput`): `total_nuc`, `iroe` (alias `roe`), `local_amount` after 024d, `rounding_method` (`HX`|`NX`), published `mileage_checks`, HIP/BHC/CTM sketches, `audit_trail`\nOr `DomainInputRequired` when licensed data is missing","status":"Implemented","purpose":"NUC × IROE construction with published TPM/MPM, Resolution **024d** (HX/NX) rounding, and fail-closed HIP/BHC/CTM hooks. All financial math uses `decimal.js`.\n\nLicensed IROE / 024d / TPM-MPM data are **not** shipped in the package. Pass them via `data_sources`. Missing IROE, TPM, or 024d → `DomainInputRequired`. Haversine-as-TPM and banker's rounding are banned.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.3":{"id":"2.3","summary":"Per-segment tax computation with exemption engine, ~30 countries, ~50 tax codes, currency conversion. All financial math uses decimal.js","className":"TaxCalculation","input":"`segments` -- itinerary segments (origin/destination airports and countries, carrier, cabin class, base fare NUC)\n`passenger_type` -- `'adult' | 'child' | 'infant' | 'crew' | 'diplomatic'`\n`is_transit` -- whether transit/connection (\u003c 24h same ticket)\n`is_involuntary` -- whether involuntary reroute\n`total_base_fare_nuc` -- total base fare for percentage-based taxes\n`selling_currency` -- ISO 4217","output":"`taxes` -- `AppliedTax[]` (code, name, country, type, amounts, segment indices, interlineable, exempt status)\n`total_tax` -- total in selling currency\n`breakdown` -- by country, interlineable/non-interlineable totals\n`exemptions_applied` -- list of exemption reasons\n`segments_processed` -- count","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.4":{"id":"2.4","summary":"Builds priced offers with TTL management and optional persistence adapter","className":"OfferBuilderAgent","input":"`operation` -- `'buildOffer' | 'getOffer' | 'validateOffer' | 'markUsed' | 'expireOffer' | 'cleanExpired'`\n`buildInput?` -- segments, fare, taxes, ancillaries, passenger count, pricing source, TTL\n`offerId?` -- for get/validate/mark/expire operations\n`currentTime?` -- ISO timestamp override","output":"`offer?` -- full offer record with pricing breakdown, TTL, status\n`valid?` -- offer validity result\n`reason?` -- validation failure reason\n`cleanedCount?` -- number of expired offers cleaned","usage":"new OfferBuilderAgent({ persistence?: PersistenceAdapter }) Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Builds, caches, validates, and manages pricing offers with TTL expiration. Supports in-memory or pluggable persistence."},"2.5":{"id":"2.5","summary":"Validates flight offers against corporate travel policies (cabin, budget, advance purchase)","className":"CorporatePolicyValidationAgent","input":"`offer` -- offer details (cabin, fare amount, carrier, fare basis, advance booking days, segments)\n`policy` -- corporate policy (cabin rules, fare rules, booking rules, bypass codes)\n`bypassCode?` -- authorization code to bypass soft violations","output":"`result` -- `'APPROVED' | 'SOFT_VIOLATION' | 'HARD_VIOLATION'`\n`violations` -- `PolicyViolation[]` with rule, severity, detail\n`bypassApplied` -- whether bypass was used","status":"Implemented","purpose":"Validates flight offers against corporate travel policies: cabin class limits, fare ceilings, blocked carriers, advance booking requirements. Supports bypass codes.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.6":{"id":"2.6","summary":"Placeholder -- not yet implemented. Requires revenue management integration","className":"DynamicPricingAgent","status":"Coming Soon (stub)","purpose":"Revenue management integration for dynamic fare adjustments. Requires revenue management integration before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"2.7":{"id":"2.7","summary":"Placeholder -- not yet implemented. Requires revenue management integration","className":"RevenueManagementAgent","status":"Coming Soon (stub)","purpose":"Revenue management system integration. Requires revenue management domain input before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"3.1":{"id":"3.1","summary":"Routes booking requests to the correct distribution channel based on carrier config, codeshare rules, and NDC capability","className":"GdsNdcRouter","input":"`segments` -- routing segments (marketing/operating carrier, origin, destination, flight number)\n`preferred_channel?` -- `'GDS' | 'NDC' | 'DIRECT'`\n`preferred_gds?` -- `'AMADEUS' | 'SABRE' | 'TRAVELPORT'`\n`include_fallbacks` -- whether to include fallback channels","output":"`routings` -- per-segment channel routing (primary channel, GDS system, NDC version, fallbacks, booking format)\n`unified_channel` -- whether all segments can use the same channel\n`recommended_channel` -- best channel for entire itinerary\n`gds_format` / `ndc_format` -- format translation stubs","status":"Implemented","purpose":"Routes booking requests to the correct distribution channel (GDS, NDC, or direct API) based on carrier config, codeshare rules, and NDC capability. Per-segment routing with fallback support.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.2":{"id":"3.2","summary":"Constructs GDS-ready PNR commands from normalized booking data. Supports Amadeus, Sabre, and Travelport syntax","className":"PnrBuilder","input":"`gds` -- `'AMADEUS' | 'SABRE' | 'TRAVELPORT'`\n`passengers` -- name, type, DOB, passport, gender, nationality, FOID\n`segments` -- carrier, flight, class, date, origin, destination, status\n`contacts` -- phone, email, type\n`ticketing` -- time limit, type\n`received_from` -- agent identifier\n`ssrs?` -- SSR elements (WCHR, VGML, DOCS, FOID, CTCE, CTCM, INFT)\n`osis?` -- OSI elements\n`is_group?` / `group_name?` -- group PNR support","output":"`gds` -- target GDS\n`commands` -- ordered `PnrCommand[]` with GDS command strings and descriptions\n`passenger_count`, `segment_count`, `is_group`, `infant_count`","status":"Implemented","purpose":"Constructs GDS-ready PNR commands from normalized booking data. Supports Amadeus, Sabre, and Travelport syntax including names, segments, contacts, ticketing, SSR/OSI elements, and group bookings.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.3":{"id":"3.3","summary":"Pre-ticketing validation -- 13 checks to catch errors before ADMs","className":"PnrValidation","input":"`record_locator` -- 6-char PNR\n`passengers` -- passenger data (name, type, DOB, nationality, passport)\n`segments` -- segment data (carrier, flight, status, class, international flag, married group)\n`contact?` -- phone/email\n`ticketing?` -- time limit, arranged status\n`fare?` -- fare data with advance purchase deadline\n`validation_date?` -- ISO date override","output":"`record_locator` -- PNR\n`checks` -- `ValidationCheck[]` (13 checks, each with pass/fail, severity, message)\n`valid` -- overall pass/fail\n`error_count`, `warning_count`","status":"Implemented","purpose":"Pre-ticketing validation with 13 checks to catch errors before ADMs: segment status, passenger data, APIS, ticketing deadline, fare consistency, and more.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.4":{"id":"3.4","summary":"GDS queue monitoring and processing -- priority assignment, categorization, action routing, and queue command generation","className":"QueueManagement","input":"`entries` -- queue items (record locator, GDS, queue number, entry type, deadline, remark)\n`current_time?` -- ISO timestamp for priority calculation\n`gds?` -- GDS system for command generation\n`queue_number?` -- queue to generate read commands for\n`travelport_host?` -- `'APOLLO' | 'GALILEO' | 'WORLDSPAN'` when `gds` is `TRAVELPORT`","output":"`results` -- processed items with priority, status, recommended action, target agent\n`commands?` -- GDS queue commands\n`summary` -- counts by priority (urgent/high/normal/low)","status":"Implemented","purpose":"GDS queue monitoring and processing: priority assignment, categorization, action routing, and queue command generation.\n\nTravelport place/list/remove commands are **per host** (Apollo / Galileo≡Travelport+ / Worldspan) from the public format-compare table — see `docs/knowledge-base/tmc-mid-office-ttl-queues.md`. TTL priority uses Zulu deadline-day urgency.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.5":{"id":"3.5","summary":"Universal HTTP client with circuit breaker, retry logic, timeout handling, rate limiting, and IATA error normalization","className":"ApiAbstraction","input":"`request` -- API request (provider ID, HTTP method, path, headers, body)\n`max_retries?` -- override retry count\n`timeout_ms?` -- override timeout\n`force?` -- skip circuit breaker check","output":"`response` -- API response (status, headers, body, duration, retries)\n`error` -- normalized error (category, original code, retryable flag)\n`circuit_breaker` -- circuit breaker status\n`rate_limit` -- rate limit status\n`success` -- boolean","usage":"new ApiAbstraction(handler?: RequestHandler) Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Universal HTTP client with circuit breaker, retry logic, timeout handling, rate limiting, and IATA error normalization for GDS/NDC/payment providers."},"3.6":{"id":"3.6","summary":"Travel order lifecycle management -- create, modify, cancel, retrieve, and list orders with status tracking and transition validation","className":"OrderManagement","input":"`operation` -- `'createOrder' | 'modifyOrder' | 'cancelOrder' | 'getOrder' | 'listOrders'`\n`createOrder?` -- passenger, items, currency, source\n`modifyOrder?` -- order ID, updated items/details, reason\n`cancelOrder?` -- order ID, reason\n`getOrder?` / `listOrders?` -- retrieval/filtering","output":"`order?` -- order record with status, items, history\n`orders?` -- list of orders\n`operation`, `success`, `errorCode?`, `errorMessage?`","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.7":{"id":"3.7","summary":"PCI-safe payment instruction builder and transaction recorder. Validates forms of payment, builds GDS FOP strings -- never handles raw card numbers","className":"PaymentProcessing","input":"`operation` -- `'validateFOP' | 'buildPaymentInstruction' | 'recordPayment' | 'getPaymentRecord' | 'buildGDSFOPString'`\nOperation-specific data: FOP details (CC_TOKEN, BSP_CASH, AIRLINE_CREDIT, VOUCHER, UATP), amounts, references","output":"`validation?` -- FOP validation result\n`instruction?` -- payment instruction with GDS string, PCI-safe flag\n`record?` -- payment transaction record\n`gdsString?` -- GDS FOP string","status":"Implemented","purpose":"PCI-safe payment instruction builder and transaction recorder. Validates forms of payment, builds GDS FOP strings, records transactions. Never handles raw card numbers.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.8":{"id":"3.8","summary":"Retrieves an existing PNR/booking by record locator across distribution adapters. Read-only -- no side effects","className":"PnrRetrieval","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"4.1":{"id":"4.1","summary":"ETR generation with conjunction ticket support, BSP reporting, and commission handling","className":"TicketIssuance","input":"`record_locator` -- 6-char PNR\n`issuing_carrier` -- 2-letter IATA code\n`passenger_name` -- LAST/FIRST format\n`segments` -- flight segments with carrier, flight number, class, fare basis, dates, baggage\n`base_fare`, `base_fare_currency` -- fare amount\n`equivalent_fare?`, `equivalent_fare_currency?` -- currency conversion\n`taxes` -- tax breakdown items\n`fare_calculation` -- fare calculation line\n`form_of_payment` -- CASH, CREDIT_CARD, INVOICE, MISCELLANEOUS\n`endorsements?`, `commission?`, `bsp_reporting?`, `original_issue?`","output":"`tickets` -- `TicketRecord[]` (13-digit number, coupons with status, fare/tax breakdown, FOP, commission, BSP fields)\n`total_coupons` -- total across all tickets\n`is_conjunction` -- whether conjunction tickets were generated","status":"Implemented","purpose":"ETR (Electronic Ticket Record) generation with conjunction ticket support (auto-split for >4 coupons), BSP reporting fields, and commission handling.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.2":{"id":"4.2","summary":"EMD-A (associated) and EMD-S (standalone) issuance, RFIC/RFISC handling, coupon lifecycle","className":"EmdManagement","input":"`emd_type` -- `'EMD-A' | 'EMD-S'`\n`record_locator`, `issuing_carrier`, `passenger_name`\n`services` -- array of services with RFIC code (A-G), RFISC, description, amount, associated ticket/coupon for EMD-A\n`related_ticket_number?` -- for EMD-A","output":"`emd` -- `EmdRecord` (13-digit EMD number, coupons, amounts)\n`coupon_count`","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.3":{"id":"4.3","summary":"Ticket/EMD void processing -- coupon status check, carrier void window, BSP/ARC cut-off validation","className":"VoidAgent","input":"`document_number` -- 13-digit ticket/EMD number\n`issuing_carrier` -- 2-letter IATA code\n`coupons` -- coupon numbers and current statuses\n`issue_datetime` -- ISO datetime of issuance\n`current_datetime?` -- ISO datetime for void window check\n`settlement_system?` -- `'BSP' | 'ARC'`\n`bsp_cutoff_time?` -- HH:MM format","output":"`result` -- void permitted flag, rejection reason, message, void window hours, hours remaining, updated coupon statuses","status":"Implemented","purpose":"Ticket/EMD void processing with coupon status validation, carrier-specific void window enforcement, and BSP/ARC cut-off time checking.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.4":{"id":"4.4","summary":"Multi-channel itinerary rendering: Email (HTML+plain), SMS, WhatsApp. Carrier-neutral templates","className":"ItineraryDelivery","input":"`record_locator` -- booking reference\n`passengers` -- name, ticket number, frequent flyer\n`flights` -- flight details (number, origin, destination, times, cabin, seat, aircraft)\n`total_fare?`, `fare_currency?`\n`contact` -- email, phone, WhatsApp number\n`channels` -- `('EMAIL' | 'SMS' | 'WHATSAPP')[]`\n`agency_name?` -- for itinerary header","output":"`rendered` -- per-channel content (HTML/plain text, subject, SMS segment count)\n`channels_rendered` -- successfully rendered channels","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.5":{"id":"4.5","summary":"APIS validation, passport validity, visa check (stub for Agent 0.7)","className":"DocumentVerification","input":"`passengers` -- ticket name, passport name, passport number/expiry/nationality, DOB, gender\n`segments` -- destination country and travel date\n`passport_validity_months?` -- minimum validity beyond travel date (default: 6)\n`validation_date?` -- ISO date override","output":"`results` -- per-passenger verification (pass/fail, individual checks with severity)\n`all_passed` -- overall pass/fail\n`blocking_failures`, `advisory_warnings` -- counts","status":"Implemented","purpose":"APIS validation, passport validity checking (configurable months threshold), and name matching between ticket and passport.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.1":{"id":"5.1","summary":"ATPCO Category 31 voluntary change assessment: change fees, fare difference, residual value, waiver codes","className":"ChangeManagement","input":"`original_ticket` -- ticket number, issuing carrier, passenger name, record locator, issue date, base fare, total tax, fare basis, refundable flag, booking date, `original_departure_date?` (for DOT 7-day check)\n`requested_itinerary` -- new segments (carrier, flight, origin, destination, date, class, fare basis), new fare, new taxes\n`waiver_code?` -- airline-provided waiver identity (not skip-penalty by itself)\n`waiver_effect?` -- required when `waiver_code` set: `ELIMINATE_PENALTY | REDUCE_PENALTY | CHANGE_REFUND_FORM | CHANGE_REBOOKING_CLASS | IRROP_INVOLUNTARY` (see `docs/knowledge-base/waiver-typology.md`)\n`waiver_penalty_reduction?` -- required for `REDUCE_PENALTY`\n`permitted_booking_classes?` / `permitted_fare_basis_patterns?` -- required for `CHANGE_REBOOKING_CLASS`\n`current_datetime?` -- ISO datetime\n`cat31_rules?` -- filed Cat 31 rules (omit → ATPCO default no charge)\n`us_dot_24h?` -- `part_259_applicable?`, `booking_channel?` (`airline_direct` | `agency` | `ndc` | `gds` | `unknown`)","output":"`assessment` -- action (`REISSUE | REBOOK | REJECT`), change fee, fare difference, additional collection, residual value, forfeited amount, tax difference, total due, Cat 31 `is_free_change` flag, summary\n`us_dot_24h` -- carrier remedy (`cancel` | `hold` | `unknown`), eligibility, ineligibility reasons (including `departure_within_7_days`, `channel_coverage_unknown`), entitlement (`penalty_free_cancel` | `unpaid_fare_hold` | `none` | `unknown`). **Not** a free-change boolean. Channel coverage follows carrier disclosure — not a baked-in “third-party never qualifies” rule.","status":"Implemented","purpose":"ATPCO Category 31 voluntary change assessment: change fees, fare difference, residual value, waiver codes, Cat 31 free-change window detection, and US DOT 14 CFR §259.5(b)(4) 24-hour reservation assessment (hold **or** cancel — carrier chooses; ≥7 days before departure). See `docs/knowledge-base/us-dot-24-hour-reservation.md`.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.2":{"id":"5.2","summary":"Ticket reissue with residual value, per-tax TFC carryforward (CARRY\\","className":"ExchangeReissue","input":"`original_ticket_number`, `conjunction_originals?`, `original_issue_date`\n`issuing_carrier`, `passenger_name`, `record_locator`\n`original_base_fare`, `original_taxes` -- from original ticket\n`change_fee`, `residual_value`, `waiver_code?` -- from Agent 5.1\n`new_segments` -- new flight segments\n`new_fare`, `new_fare_currency`, `new_taxes`, `fare_calculation`\n`form_of_payment` -- for additional collection\n`gds?` -- GDS for command generation\n`tax_carryforward_context` -- geography (`SAME_AIRPORT | SAME_CITY | DIFFERENT`), validity window flag, flown status, POS unchanged\n`tax_carryforward_rules` -- per-code rules covering every tax on original ∪ new (nature, min geography, YQ/YR flags, validity expiry action)\n`same_origin_destination?` -- **deprecated / ignored** for tax decisions (migration warning only)","output":"`reissue` -- new ticket record with full audit trail, exchange commands, `tax_decisions` on the audit trail\n`additional_collection` -- amount due\n`credit_amount` -- amount refundable if downgrade\n`tax_decisions` -- `{ tax_code, action: CARRY | RECALCULATE | FORFEIT, reason }[]`","status":"Implemented","purpose":"Ticket reissue with residual value application, **per-tax** carryforward (`CARRY | RECALCULATE | FORFEIT`), conjunction ticket handling, GDS exchange command generation, and full audit trail.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.3":{"id":"5.3","summary":"Carrier-initiated schedule change handling: trigger assessment, airline protection logic, regulatory entitlements (EU261, US DOT)","className":"InvoluntaryRebook","input":"`original_pnr` -- record locator, passenger, affected segment, issuing carrier, countries, checked-in flag, EU/Community carrier flag, optional endorsement\n`schedule_change` -- change type (incl. MISCONNECT), times, routing/equipment, misconnect shortfall\n`available_flights?` -- protection candidates with operating/marketing/alliance/interline + `endorsement_allows`\n`thresholds?` -- carrier-specific `time_change_minutes`, `measurement_point` (DEPARTURE|ARRIVAL), `misconnect_minutes` — required for those triggers\n`is_passenger_no_show?` -- no-show flag\n`is_oversale_denied_boarding?` -- only true for 14 CFR §250 oversales\n`eu261_inputs?` -- great-circle `distance_km` (Art.7(4)), delay/notice/rerouting/extraordinary, third-country benefits caveat","output":"`result` -- involuntary flag, trigger, ranked protection candidates (not executed), `art8_passenger_choice_required` + `art8_choices`, measurement point, regulatory flags (EU261/US DOT), original routing credit flag, summary","status":"Implemented","purpose":"Carrier-initiated schedule change / IRROP handling. Domain KB: `docs/knowledge-base/involuntary-rebook-irrop.md` (Regulation (EC) No 261/2004 — [CELEX:32004R0261](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32004R0261)).\n\n- **Triggers:** time change, routing change, equipment downgrade, cancellation, misconnect — with explicit dep vs arr measurement. **No hardcoded 60-minute threshold**; fail closed when carrier threshold input is missing.\n- **Reprotection candidates:** same operating → marketing → alliance → interline → other, with endorsement fail-closed. Alliance ≠ any alliance flight. **Do not silently \"same carrier first\"** — when EU261 applies, Art.8 passenger choice (refund vs re-route) is required before execution.\n- **EU261:** Art.3(1) matrix (EU depart any carrier / EU arrive Community carrier only). Art.7 compensation via great-circle bands only (never TPM). Art.8 choice surfaced on output.\n- **US DOT:** 14 CFR §250 IDB is oversale-specific — delays/cancels report `applies: false`.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.4":{"id":"5.4","summary":"Placeholder -- not yet implemented. Requires domain input on disruption priority rules","className":"DisruptionResponseAgent","status":"Coming Soon (stub)","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"5.5":{"id":"5.5","summary":"Placeholder -- not yet implemented. Requires domain input on change fee structures","className":"SelfServiceRebookingAgent","status":"Implemented","purpose":"Orchestrates Availability Search (1.1) and Change Management (5.1) to present priced rebooking alternatives (changeFee + fareDifference + taxDifference per option). Read-only -- does NOT execute the reissue; that is Exchange/Reissue (5.2). Involuntary reasons (schedule change / missed connection / cancellation) waive the change fee; voluntary changes honor ATPCO Cat 31 via 5.1.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"5.6":{"id":"5.6","summary":"Placeholder -- not yet implemented. Requires domain input on waitlist priority scoring","className":"WaitlistManagementAgent","status":"Implemented","purpose":"Stateful in-memory passenger waitlist queue with four operations: addEntry (priority computed at add time), clear (given N seats opened, remove top-N by priority), queryStatus (1-based position + estimated clearance probability), and expire (prune entries past their cutoff). State is in-memory only -- production deployments should pair it with a durable persistence layer.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"6.1":{"id":"6.1","summary":"ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting, conjunction ticket handling","className":"RefundProcessing","input":"`ticket_number`, `conjunction_tickets?`\n`issuing_carrier`, `passenger_name`, `record_locator`\n`base_fare`, `base_fare_currency`, `taxes`, `commission?`\n`refund_type` -- `'FULL' | 'PARTIAL' | 'TAX_ONLY'`\n`coupons_to_refund?` -- specific coupons (for partial)\n`total_coupons`, `waiver_code?`, `waiver_effect?` (required with code), `fare_basis`, `is_refundable`\n`waiver_penalty_reduction?`, `waiver_refund_form?` -- companions per typology in `docs/knowledge-base/waiver-typology.md`\n`settlement_system` -- `'BSP' | 'ARC'`","output":"`refund` -- penalty applied, base fare refund, tax refund, tax breakdown, commission recalled, net refund, BSP/ARC reporting fields, audit trail\n`net_refund_amount`, `commission_recalled`","status":"Implemented","purpose":"ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting fields, conjunction ticket handling. Supports full, partial, and tax-only refunds.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.2":{"id":"6.2","summary":"Pre-ticketing audit: 10 checks covering fare integrity, passive/UC/churn (history-required), married integrity, TTL, 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?` -- both caller-supplied; no embedded carrier tables\n`endorsement?`, `tour_code?`\n`is_net_remit?`, `net_contracted_amount?`\n`ttl_deadline?`, `ttl_timezone?`, `ttl_source?`, `current_datetime?`\n`duplicate_check_pnrs?`\n`segment_history?` -- required for churning; current status alone is insufficient\n`gds?` -- `SABRE` | `AMADEUS` | `TRAVELPORT` | `UNKNOWN` (Travelport DX marriage break)\n`churn_cycle_threshold?`, `churn_window_hours?`","output":"`result` -- all check results, overall pass/fail, blocking/warning counts","status":"Implemented","purpose":"Pre-ticketing audit with 10 checks: duplicate booking, fare/class mismatch, passive/unable/risky status (core HX/UC/UN/NO/TK + **per-host** maps — HN/PK/GK/YK are not universalized), churning (history-required), married segment integrity, TTL expiry (timezone / deadline-day), commission rate (caller-supplied only), 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 / DISH TRNC, **transaction currency CUTP**, optional reporting currency, billing period, ORIT / RTDN / conjunction set)\n`agency_records` -- agency-side booking records for comparison (optional `original_ticket_number`, `related_ticket_number`, `conjunction_ticket_numbers`)","output":"Discrepancies with severity and type (includes `UNMATCHED_EXCHANGE`, `CONJUNCTION_SET_MISMATCH`)\nSummary with `currencies_present` (multi-currency HOT awareness)\nCommission / amount compares only when agency and HOT transaction currencies match (no silent IROE/ICER FX)","status":"Implemented","purpose":"Matches agency booking records against BSP HOT files (DISH Rev 23), validates commission rates, identifies discrepancies (missing records, duplicates, amount/commission/currency mismatches, unmatched ADM/ACM, exchange/conjunction cross-refs), 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-7-reconciliation.md b/docs/agents/stage-7-reconciliation.md
index 72c9d2e..7ebcbc9 100644
--- a/docs/agents/stage-7-reconciliation.md
+++ b/docs/agents/stage-7-reconciliation.md
@@ -12,14 +12,18 @@ BSP/ARC reconciliation, commission management, interline settlement, financial r
 **Class:** `BSPReconciliation`
 **Status:** Implemented
 
-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.
+Matches agency booking records against BSP HOT files (DISH Rev 23), validates commission rates, identifies discrepancies (missing records, duplicates, amount/commission/currency mismatches, unmatched ADM/ACM, exchange/conjunction cross-refs), and flags issues before remittance deadline.
+
+**Domain knowledge:** [`docs/knowledge-base/bsp-hot-reconciliation.md`](../knowledge-base/bsp-hot-reconciliation.md) — HOT is DISH fixed-width (generic X12 parsers miss sections); **do not assume single-currency HOT**; transaction `CUTP` vs reporting/`BOH03` currency; **IROE ≠ ICER**; conjunction / exchange / EMD / ADM are separate; synthetic fixtures only (no live HOT dumps).
 
 **Input (`BSPReconciliationInput`):**
-- `hot_records` -- BSP HOT file records (ticket number, passenger, origin/destination, airline, amounts, commission, transaction type, billing period)
-- `agency_records` -- agency-side booking records for comparison
+- `hot_records` -- BSP HOT file records (ticket number, passenger, origin/destination, airline, amounts, commission, transaction type / DISH TRNC, **transaction currency CUTP**, optional reporting currency, billing period, ORIT / RTDN / conjunction set)
+- `agency_records` -- agency-side booking records for comparison (optional `original_ticket_number`, `related_ticket_number`, `conjunction_ticket_numbers`)
 
 **Output (`BSPReconciliationOutput`):**
-- Matched records, unmatched records, discrepancies with severity and type, commission validation results
+- Discrepancies with severity and type (includes `UNMATCHED_EXCHANGE`, `CONJUNCTION_SET_MISMATCH`)
+- Summary with `currencies_present` (multi-currency HOT awareness)
+- Commission / amount compares only when agency and HOT transaction currencies match (no silent IROE/ICER FX)
 
 ---
 
diff --git a/docs/knowledge-base/bsp-hot-reconciliation.md b/docs/knowledge-base/bsp-hot-reconciliation.md
new file mode 100644
index 0000000..2225df5
--- /dev/null
+++ b/docs/knowledge-base/bsp-hot-reconciliation.md
@@ -0,0 +1,175 @@
+# BSP HOT Reconciliation — Domain Knowledge (Agent 7.1)
+
+Source: **IATA BSP Data Interchange Specifications Handbook (DISH) Revision 23**
+(public overview: https://www.iata.org/en/publications/bspdish/; handbook Attachment A to PSC Resolution 750).
+IROE / ICER distinction: IATA Exchange Rates Services (public).
+
+This file is the authoritative domain input for `@otaip/agents-reconciliation` BSP HOT matching.
+Anything missing is captured as an open `DOMAIN_QUESTION` at the bottom — **never invent**.
+
+**Do not commit live HOT dumps or real agency data.** Tests use synthetic HOT-like fixtures only.
+
+---
+
+## 1. HOT is DISH record-level — not generic X12
+
+Airline Accounting/Sales data (**HOT**) is specified in DISH Chapter 6 as **fixed-width positional records** with Standard Message Identifiers (`BFH01`, `BCH02`, `BOH03`, `BKT06`, `BKS24`, `BKS30`, `BKS39`, `BKS45`, `BKS46`, `BKP84-*`, totals `BOT93`/`BOT94`/`BCT95`/`BFT99`, etc.).
+
+| Guard | Rule |
+| --- | --- |
+| Generic EDI X12 parsers | **STOP.** A generic X12 segment parser will miss DISH fixed-width sections and mis-map fields. Layout varies by BSP market within the DISH grids. |
+| Hybrid / simplified test fixtures | Lab fixtures may use tagged or simplified layouts for readability; production ingestion must follow the market’s DISH HOT record grids. |
+
+---
+
+## 2. Multi-currency — do **not** assume a single-currency HOT
+
+DISH §6.5.3 (Currency):
+
+- **BOH03 `CUTP`** — national / default currency of the BSP (or reporting-office currency context).
+- **Per-transaction `CUTP`** — currency in which **that** transaction is processed. Present on amount-bearing records (`BKS30`, `BKS39`, `BKP84`, …).
+- Totals are **per currency**: `BOT93` (office subtotals by TRNC+CUTP), `BOT94`, `BCT95`, `BFT99`.
+- Where an agent may accept more than one currency, **any individual sale must be paid and reported in one currency only** (`CUTP` on that transaction).
+- Multi-currency BSPs may sort HOT by agent (mixed currencies) or by currency (one file per currency). Empty currency files may still be produced.
+
+**Matching rule for Agent 7.1:** compare agency vs HOT amounts **only when transaction `CUTP` values are equal**. Never silently convert currencies. Never treat file-level default/`BOH03` currency as the amount currency for every row.
+
+### Transaction currency vs reporting currency
+
+| Concept | DISH / IATA field | Use in reconciliation |
+| --- | --- | --- |
+| **Transaction currency** | Record-level `CUTP` on the transaction’s amount records | Primary match key for fare / tax / commission / remittance amounts |
+| **Reporting / default currency** | `BOH03` `CUTP` (and currency-sorted file identity) | Remittance totals context; **not** a substitute for missing per-txn `CUTP` |
+| **Equivalent fare paid** | `EQFR` (BAR64 / IT07) | Present when payment currency differs from entered fare currency (PSC Reso 722 §3.18) — do not confuse with ROE tables |
+
+### IROE ≠ ICER
+
+| Rate product | Role | Must not be used for |
+| --- | --- | --- |
+| **IROE** (IATA Rates of Exchange) | Monthly rates for **fare / NUC construction** (Reso 024c) | Converting HOT remittance amounts between currencies during matching |
+| **ICER** (IATA Consolidated Exchange Rates) | Daily rates for converting fares/taxes/fees to an **alternate payment currency** at pricing/ticketing | Same — not a HOT amount FX engine unless domain explicitly supplies the rate source used for that BSP period |
+
+If a shop needs cross-currency discrepancy totals, surface **DOMAIN_QUESTION** for which published rate table and date apply — do not invent FX.
+
+---
+
+## 3. Transaction types are separate (TRNC)
+
+DISH `TRNC` (BKS24) values used in HOT reconciliation (non-exhaustive; see DISH Glossary):
+
+| TRNC | Meaning | Reconciliation category |
+| --- | --- | --- |
+| `TKTT` | Electronic ticket sale (automated) | Issue / sale |
+| `EMDA` / `EMDS` | EMD associated / standalone | **EMD — separate from TKTT** |
+| `RFND` | Refund | Refund |
+| `ADMA` / `ACMA` | Agency debit / credit memo | **ADM / ACM — separate** |
+| `CANX` / `CANN` / `RFNC` / … | Cancel / reversal variants | Out of simple sale match; see DISH notes |
+| `TASF` / `SPCR` / `SPDR` / `SSAC` / `SSAD` | Fees / settlement-plan / summary adjustments | Separate categories |
+
+**Exchange is not a standalone `TRNC`.** Straight / ADC exchanges are **issue transactions** (`TKTT` / EMD) whose Form of Payment includes **`BKP84-EX`**, with original-document linkage on **`BKS46` `ORIT`** (and related RET `IT03` patterns). Agent 7.1 therefore treats **exchange-linked issues** as a distinct matching path (new `TDNR` + `ORIT` / related docs), not as “same ticket number as the original.”
+
+**Conjunction / exchange / EMD / ADM are separate** structural patterns — do not collapse them into a single ticket-number join.
+
+---
+
+## 4. Cross-reference patterns
+
+All records belonging to one logical transaction share the same HOT **`TRNN`** (Transaction Number). RET `TRNN` ≠ HOT `TRNN` for the same commercial event (DISH Glossary).
+
+### 4.1 Conjunction sets
+
+- Primary document: `BKS24` with `TDNR`.
+- Conjunction documents: `BKS24-CNJ` (and related `*-CNJ` records). `CJCP` = `CNJ` on secondary documents.
+- Same `TRNN` across primary + conjunction documents.
+- Billing Analysis shows sequential documents against **one** Balance Payable / Remittance Amount entry (even when straight exchange remittance is zero).
+- Partial refund of a conjunction set: `BKS45` `RTDN` names the **actual** STD whose coupons were refunded (not necessarily the primary).
+
+**Matching:** resolve conjunction membership (`primary` + `conjunction_ticket_numbers`) before calling a row “missing.” Flag set-level gaps as conjunction mismatches, not isolated ticket misses, when the rest of the set is present.
+
+### 4.2 Exchange-linked tickets
+
+- New document `TDNR` (issue) + `BKP84-EX` (+ optional ADC cash/card FOP).
+- Original document: `BKS46` **`ORIT`** (and `ORID` / `ORIL` / `ORIA` when present).
+- Even exchange: monetary fields on `BKS30` / `BKS39` / `BKP84-CA` are zeros (DISH §6.5.6 note).
+
+**Matching keys (shop-style):** `(new_ticket, ORIT)` and/or agency exchange id — **not** ticket-number equality alone.
+
+### 4.3 Refund / ADM / ACM linkage (`BKS45`)
+
+`BKS45` is **only** for Refund, ADM, ACM (and sales-summary / minor-adjustment) transactions:
+
+| Element | Role |
+| --- | --- |
+| `RTDN` | Related ticket/document number |
+| `RCPN` | Related coupon identifier(s) |
+| `DIRD` | Date of issue of related document |
+| `WAVR` / `RMIC` | Waiver / reason-for-memo (first `BKS45` only) |
+| `RMED` | Remittance period ending date (must match `BOH03`) |
+
+Indirect refunds may place Refund Authority number in `BKS24` `TDNR` while `RTDN` holds the ticket being refunded.
+
+**Matching:** ADM/ACM/RFND rows must join to agency via `RTDN` (and coupons when present), not only via memo/`TDNR` equality.
+
+### 4.4 EMD
+
+EMD uses its own record set (`BMD75` / `BMD76`, CNJ variants). Coupon association to tickets is EMD-side; the ticket HOT row does **not** carry the EMD reference (DISH examples). Treat EMD reconciliation as a **separate** document stream.
+
+---
+
+## 5. Commission fields (do not flatten)
+
+HOT commission is not a single “rate vs claimed” check:
+
+| Element / record | Role |
+| --- | --- |
+| `BKS39` `COAM` | Commission amount (signed rules differ for ADM/ACM) |
+| `SPAM` / related | Supplementary / incentive components when present |
+| `EFCO` | Effective commission accumulation across multiple `BKS39` |
+| `CCAI` | Commission control adjustment indicator (DISH 23) |
+| `TOCA` (`BKS42`) | Tax on commission (ADM/ACM-oriented rules) |
+
+Expected rates still depend on carrier contracts (route, fare basis, class, date, net remit). See Agent 7.3 / commission KB — do not invent contract tables here.
+
+---
+
+## 6. Matching algorithm notes (Agent 7.1)
+
+Recommended join order for discrepancy detection:
+
+1. **Normalize** HOT rows into transaction envelopes keyed by `TRNN` (primary `TDNR`, `TRNC`, `CUTP`, amounts, FOP flags, `ORIT`, `RTDN`s, conjunction `TDNR`s).
+2. **Index** agency rows by ticket number **and** by original/related ticket when the agency record is an exchange / memo / refund.
+3. **Match** within the same logical category (sale / exchange-linked issue / EMD / refund / ADM / ACM) — categories are separate.
+4. **Currency gate:** require equal transaction `CUTP` before amount/commission compare.
+5. **Threshold:** apply `min_threshold` in the transaction currency (do not FX-convert the threshold via IROE/ICER).
+6. **Conjunction:** if either side declares a set, require set coverage; emit set-level discrepancy when one member is absent.
+7. **ADM/ACM:** unmatched memo with `RTDN` → `UNMATCHED_ADM` / `UNMATCHED_ACM`; still surface related-ticket context.
+8. **Period boundary:** filter / warn using billing period (`BAED`) and remittance ending (`RMED`) — see remittance caveats below.
+
+Tolerances beyond `min_threshold` are **shop policy** — not invented here.
+
+---
+
+## 7. Remittance calendar caveats
+
+DISH defines:
+
+- **Reporting Period** — agent reporting window.
+- **Billing Period** — one or more reporting periods billed together (`BAED`).
+- **Remittance Period** — span for remittance to the clearing bank; **not shorter than** one Billing Period and **may cover more than one** Billing Period (`RMED` on `BOH03` / `BKS45`).
+
+DISH also notes there can be **several remittances per month**, and example patterns such as weekly reporting with fortnightly billing. **Market calendars (weekly / bi-monthly / monthly) and payment grace days are BSP-market specific.**
+
+Public IATA pages describe the DISH standard and remittance *concepts*; they do **not** publish a complete per-market grace calendar usable as code defaults.
+
+→ See **DOMAIN_QUESTION** DQ-HOT-1.
+
+---
+
+## 8. Open DOMAIN_QUESTIONs
+
+| ID | Question |
+| --- | --- |
+| **DQ-HOT-1** | For each target BSP market (e.g. BSP UK, BSP DE), what are the remittance frequency, `RMED` relative to period end, and payment grace days? Cite the market’s public BSP calendar or BSPlink notice — do not hardcode. |
+| **DQ-HOT-2** | Which commission contract source feeds Agent 7.1 expected rates (7.3 agreements vs external tariff file), and how are override / supplementary (`SPAM`) components expected to appear on agency records? |
+| **DQ-HOT-3** | When agency mid-office stores only reporting currency, which explicit ICER (or other) rate date may be used for display-only FX — never for silent match conversion? |
+| **DQ-HOT-4** | Market-specific HOT sort (by agent mixed-currency vs by currency file) and whether empty per-currency HOT files are delivered to this agency. |
diff --git a/packages/agents/reconciliation/src/bsp-reconciliation/__tests__/bsp-reconciliation.test.ts b/packages/agents/reconciliation/src/bsp-reconciliation/__tests__/bsp-reconciliation.test.ts
index 89d379b..73ae5c9 100644
--- a/packages/agents/reconciliation/src/bsp-reconciliation/__tests__/bsp-reconciliation.test.ts
+++ b/packages/agents/reconciliation/src/bsp-reconciliation/__tests__/bsp-reconciliation.test.ts
@@ -141,6 +141,64 @@ describe('HOT File Parser', () => {
     );
     expect(records.length).toBe(1);
   });
+
+  it('auto-detects synthetic DISH Rev 23 format', () => {
+    const content = loadFixture('hot-dish-rev23-synthetic.txt');
+    expect(HOTFileParser.detectFormat(content)).toBe('DISH_REV23');
+  });
+
+  it('parses multi-currency CUTP from synthetic DISH HOT (never assumes single currency)', () => {
+    const content = loadFixture('hot-dish-rev23-synthetic.txt');
+    const parser = new HOTFileParser();
+    const records = parser.parse(content);
+    const currencies = [...new Set(records.map((r) => r.currency))].sort();
+    expect(currencies).toEqual(['EUR', 'GBP', 'HKD', 'USD']);
+    expect(records.every((r) => r.reporting_currency === 'GBP')).toBe(true);
+  });
+
+  it('parses exchange-linked ticket via FPTP=EX and ORIT', () => {
+    const content = loadFixture('hot-dish-rev23-synthetic.txt');
+    const parser = new HOTFileParser();
+    const records = parser.parse(content);
+    const exch = records.find((r) => r.ticket_number === '1259999000001');
+    expect(exch).toBeDefined();
+    expect(exch!.transaction_type).toBe('EXCHANGE');
+    expect(exch!.original_ticket_number).toBe('1259999000000');
+    expect(exch!.payment_type).toBe('EX');
+  });
+
+  it('parses conjunction set sharing TRNN', () => {
+    const content = loadFixture('hot-dish-rev23-synthetic.txt');
+    const parser = new HOTFileParser();
+    const records = parser.parse(content);
+    const primary = records.find((r) => r.ticket_number === '1258888000000');
+    const cnj = records.find((r) => r.ticket_number === '1258888000001');
+    expect(primary).toBeDefined();
+    expect(cnj).toBeDefined();
+    expect(primary!.transaction_number).toBe(cnj!.transaction_number);
+    expect(primary!.conjunction_ticket_numbers).toContain('1258888000001');
+    expect(cnj!.is_conjunction).toBe(true);
+    expect(cnj!.conjunction_primary).toBe('1258888000000');
+  });
+
+  it('parses ADM as separate TRNC with RTDN related document', () => {
+    const content = loadFixture('hot-dish-rev23-synthetic.txt');
+    const parser = new HOTFileParser();
+    const records = parser.parse(content);
+    const adm = records.find((r) => r.transaction_type === 'ADM');
+    expect(adm).toBeDefined();
+    expect(adm!.transaction_code).toBe('ADMA');
+    expect(adm!.related_documents?.[0]?.ticket_number).toBe('1251234567895');
+  });
+
+  it('parses EMD as separate category from TKTT/ADM', () => {
+    const content = loadFixture('hot-dish-rev23-synthetic.txt');
+    const parser = new HOTFileParser();
+    const records = parser.parse(content);
+    const emd = records.find((r) => r.transaction_type === 'EMD');
+    expect(emd).toBeDefined();
+    expect(emd!.transaction_code).toBe('EMDS');
+  });
 });
 
 // ---------------------------------------------------------------------------
@@ -354,7 +412,7 @@ describe('BSP Reconciliation', () => {
     it('has correct metadata', () => {
       expect(agent.id).toBe('7.1');
       expect(agent.name).toBe('BSP Reconciliation');
-      expect(agent.version).toBe('0.1.0');
+      expect(agent.version).toBe('0.2.0');
     });
 
     it('reports healthy', async () => {
@@ -377,4 +435,230 @@ describe('BSP Reconciliation', () => {
       expect((await uninit.health()).status).toBe('unhealthy');
     });
   });
+
+  describe('Multi-currency + cross-refs (DISH Rev 23 / #143)', () => {
+    it('lists currencies_present and warns on multi-currency HOT', async () => {
+      const input = makeInput({
+        agency_records: [
+          makeAgency({ ticket_number: '1251234567890', currency: 'GBP', ticket_amount: '550.00' }),
+          makeAgency({
+            ticket_number: '1251234567891',
+            currency: 'EUR',
+            ticket_amount: '780.00',
+            commission_amount: '54.60',
+            tax_amount: '95.00',
+            airline_code: 'AF',
+          }),
+        ],
+        hot_records: [
+          makeHot({
+            ticket_number: '1251234567890',
+            currency: 'GBP',
+            reporting_currency: 'GBP',
+            ticket_amount: '550.00',
+          }),
+          makeHot({
+            ticket_number: '1251234567891',
+            currency: 'EUR',
+            reporting_currency: 'GBP',
+            ticket_amount: '780.00',
+            commission_amount: '54.60',
+            tax_amount: '95.00',
+            airline_code: 'AF',
+          }),
+        ],
+        threshold_currency: 'GBP',
+      });
+      const result = await agent.execute({ data: input });
+      expect(result.data.summary.currencies_present).toEqual(['EUR', 'GBP']);
+      expect(result.warnings!.some((w) => w.includes('Multi-currency HOT'))).toBe(true);
+      expect(result.warnings!.some((w) => w.includes('IROE'))).toBe(true);
+      expect(result.data.passed).toBe(true);
+    });
+
+    it('flags currency mismatch without converting via IROE/ICER', async () => {
+      const input = makeInput({
+        agency_records: [makeAgency({ currency: 'GBP' })],
+        hot_records: [makeHot({ currency: 'EUR', reporting_currency: 'GBP' })],
+      });
+      const result = await agent.execute({ data: input });
+      const curr = result.data.discrepancies.find((d) => d.type === 'CURRENCY_MISMATCH');
+      expect(curr).toBeDefined();
+      expect(curr!.description).toMatch(/IROE/);
+      expect(result.data.discrepancies.some((d) => d.type === 'AMOUNT_MISMATCH')).toBe(false);
+    });
+
+    it('matches exchange-linked tickets via ORIT cross-ref', async () => {
+      const input = makeInput({
+        agency_records: [
+          makeAgency({
+            ticket_number: '1259999000001',
+            transaction_type: 'EXCHANGE',
+            original_ticket_number: '1259999000000',
+            ticket_amount: '100.00',
+            commission_amount: '7.00',
+            tax_amount: '20.00',
+            currency: 'GBP',
+          }),
+        ],
+        hot_records: [
+          makeHot({
+            ticket_number: '1259999000001',
+            transaction_type: 'EXCHANGE',
+            transaction_code: 'TKTT',
+            original_ticket_number: '1259999000000',
+            payment_type: 'EX',
+            ticket_amount: '100.00',
+            commission_amount: '7.00',
+            tax_amount: '20.00',
+            currency: 'GBP',
+            reporting_currency: 'GBP',
+          }),
+        ],
+        threshold_currency: 'GBP',
+      });
+      const result = await agent.execute({ data: input });
+      expect(result.data.discrepancies).toHaveLength(0);
+      expect(result.data.summary.matched_count).toBe(1);
+    });
+
+    it('flags unmatched exchange when ORIT linkage is missing on HOT', async () => {
+      const input = makeInput({
+        agency_records: [
+          makeAgency({
+            ticket_number: '1259999000001',
+            transaction_type: 'EXCHANGE',
+            original_ticket_number: '1259999000000',
+            ticket_amount: '100.00',
+            currency: 'GBP',
+          }),
+        ],
+        hot_records: [],
+        threshold_currency: 'GBP',
+      });
+      const result = await agent.execute({ data: input });
+      const unmatched = result.data.discrepancies.find((d) => d.type === 'UNMATCHED_EXCHANGE');
+      expect(unmatched).toBeDefined();
+      expect(unmatched!.related_ticket_number).toBe('1259999000000');
+    });
+
+    it('detects conjunction set mismatch', async () => {
+      const input = makeInput({
+        agency_records: [
+          makeAgency({
+            ticket_number: '1258888000000',
+            conjunction_ticket_numbers: ['1258888000001'],
+            ticket_amount: '900.00',
+            commission_amount: '63.00',
+            currency: 'HKD',
+            airline_code: 'CX',
+          }),
+        ],
+        hot_records: [
+          makeHot({
+            ticket_number: '1258888000000',
+            ticket_amount: '900.00',
+            commission_amount: '63.00',
+            currency: 'HKD',
+            airline_code: 'CX',
+            // HOT missing conjunction companion
+          }),
+        ],
+        threshold_currency: 'HKD',
+      });
+      const result = await agent.execute({ data: input });
+      const cnj = result.data.discrepancies.find((d) => d.type === 'CONJUNCTION_SET_MISMATCH');
+      expect(cnj).toBeDefined();
+      expect(cnj!.severity).toBe('critical');
+    });
+
+    it('matches ADM via RTDN related ticket', async () => {
+      const input = makeInput({
+        agency_records: [
+          makeAgency({
+            ticket_number: '1256666000001',
+            transaction_type: 'ADM',
+            related_ticket_number: '1251234567895',
+            ticket_amount: '890.00',
+            commission_amount: '0.00',
+            tax_amount: '0.00',
+            airline_code: 'NH',
+            currency: 'USD',
+          }),
+        ],
+        hot_records: [
+          makeHot({
+            ticket_number: '1256666000001',
+            transaction_type: 'ADM',
+            transaction_code: 'ADMA',
+            ticket_amount: '890.00',
+            commission_amount: '0.00',
+            tax_amount: '0.00',
+            airline_code: 'NH',
+            currency: 'USD',
+            related_documents: [{ ticket_number: '1251234567895', coupons: '1230' }],
+          }),
+        ],
+      });
+      const result = await agent.execute({ data: input });
+      expect(result.data.discrepancies).toHaveLength(0);
+      expect(result.data.passed).toBe(true);
+    });
+
+    it('end-to-end: parse synthetic DISH fixture and reconcile exchange + multi-currency', async () => {
+      const content = loadFixture('hot-dish-rev23-synthetic.txt');
+      const hot_records = new HOTFileParser().parse(content);
+      const input = makeInput({
+        agency_records: [
+          makeAgency({
+            ticket_number: '1251234567890',
+            currency: 'GBP',
+            ticket_amount: '550.00',
+            commission_amount: '38.50',
+          }),
+          makeAgency({
+            ticket_number: '1259999000001',
+            transaction_type: 'EXCHANGE',
+            original_ticket_number: '1259999000000',
+            ticket_amount: '100.00',
+            commission_amount: '7.00',
+            tax_amount: '20.00',
+            currency: 'GBP',
+          }),
+          makeAgency({
+            ticket_number: '1258888000000',
+            conjunction_ticket_numbers: ['1258888000001'],
+            ticket_amount: '900.00',
+            commission_amount: '63.00',
+            tax_amount: '110.00',
+            currency: 'HKD',
+            airline_code: 'CX',
+          }),
+          makeAgency({
+            ticket_number: '1258888000001',
+            conjunction_ticket_numbers: ['1258888000000'],
+            ticket_amount: '0.00',
+            commission_amount: '0.00',
+            tax_amount: '0.00',
+            currency: 'HKD',
+            airline_code: 'CX',
+          }),
+        ],
+        hot_records,
+        threshold_currency: 'GBP',
+        min_threshold: '10.00',
+      });
+
+      const result = await agent.execute({ data: input });
+      expect(result.data.summary.currencies_present.length).toBeGreaterThan(1);
+      expect(
+        result.data.discrepancies.some(
+          (d) =>
+            d.ticket_number === '1259999000001' &&
+            (d.type === 'MISSING_IN_HOT' || d.type === 'UNMATCHED_EXCHANGE'),
+        ),
+      ).toBe(false);
+      expect(result.warnings!.some((w) => w.includes('Multi-currency'))).toBe(true);
+    });
+  });
 });
diff --git a/packages/agents/reconciliation/src/bsp-reconciliation/__tests__/fixtures/hot-dish-rev23-synthetic.txt b/packages/agents/reconciliation/src/bsp-reconciliation/__tests__/fixtures/hot-dish-rev23-synthetic.txt
new file mode 100644
index 0000000..83af590
--- /dev/null
+++ b/packages/agents/reconciliation/src/bsp-reconciliation/__tests__/fixtures/hot-dish-rev23-synthetic.txt
@@ -0,0 +1,22 @@
+# SYNTHETIC DISH-Rev23-like HOT — NOT real agency data. Issue #143 fixtures.
+# Production HOT is DISH fixed-width (BFH/BCH/BOH/BKT/BKS…). Generic X12 parsers miss those sections.
+# BOH CUTP = reporting/default currency; each TXN CUTP = transaction currency (do not assume single-currency).
+# IROE ≠ ICER — fixtures never imply FX conversion.
+BFH|REVN=023|BSPI=GB|ISOC=GB|PERIOD=2026-P03
+BOH|AGTN=91234567|CUTP=GBP|RMED=260331|PERIOD=2026-P03
+# Multi-currency sales: GBP + EUR + USD in one file
+TXN|TRNN=000001|TRNC=TKTT|TDNR=1251234567890|PXNM=SMITH/JOHN|ORAC=LHR|DSTC=JFK|AL=BA|DAIS=2026-03-15|TDAM=550.00|COAM=38.50|TMFA=120.00|FPTP=CC|CUTP=GBP|SQNR=00000001
+TXN|TRNN=000002|TRNC=TKTT|TDNR=1251234567891|PXNM=JONES/MARY|ORAC=CDG|DSTC=LAX|AL=AF|DAIS=2026-03-16|TDAM=780.00|COAM=54.60|TMFA=95.00|FPTP=CC|CUTP=EUR|SQNR=00000002
+TXN|TRNN=000003|TRNC=TKTT|TDNR=1251234567893|PXNM=BROWN/BOB|ORAC=SIN|DSTC=HKG|AL=SQ|DAIS=2026-03-18|TDAM=320.00|COAM=22.40|TMFA=45.00|FPTP=CA|CUTP=USD|SQNR=00000003
+# Exchange-linked issue: new TDNR with BKP84-EX (FPTP=EX) + ORIT original (DISH BKS46)
+TXN|TRNN=000004|TRNC=TKTT|TDNR=1259999000001|PXNM=LEE/ANN|ORAC=LHR|DSTC=SIN|AL=BA|DAIS=2026-03-20|TDAM=100.00|COAM=7.00|TMFA=20.00|FPTP=EX|ORIT=1259999000000|CUTP=GBP|SQNR=00000004
+# Conjunction set: primary + CNJ share TRNN (DISH BKS24-CNJ / CJCP=CNJ)
+TXN|TRNN=000005|TRNC=TKTT|TDNR=1258888000000|PXNM=CHEN/WEI|ORAC=HKG|DSTC=LAX|AL=CX|DAIS=2026-03-21|TDAM=900.00|COAM=63.00|TMFA=110.00|FPTP=CC|CUTP=HKD|SQNR=00000005
+CNJ|TRNN=000005|TDNR=1258888000001|PRIMARY=1258888000000|CJCP=CNJ|PXNM=CHEN/WEI|ORAC=LAX|DSTC=JFK|AL=CX|DAIS=2026-03-21|TDAM=0.00|COAM=0.00|TMFA=0.00|CUTP=HKD
+# Refund with BKS45 RTDN linkage
+TXN|TRNN=000006|TRNC=RFND|TDNR=1257777000000|PXNM=DOE/JANE|ORAC=JFK|DSTC=LHR|AL=BA|DAIS=2026-03-22|TDAM=0.00|COAM=0.00|TMFA=0.00|RFND=450.00|FPTP=CC|CUTP=GBP|SQNR=00000006|RTDN=1257777000000
+# ADM separate from TKTT — RTDN points at underlying ticket
+TXN|TRNN=000007|TRNC=ADMA|TDNR=1256666000001|PXNM=WILSON/TOM|ORAC=NRT|DSTC=LAX|AL=NH|DAIS=2026-03-23|TDAM=890.00|COAM=0.00|TMFA=0.00|FPTP=CA|CUTP=USD|SQNR=00000007
+REL|TRNN=000007|RTDN=1251234567895|RCPN=1230|DIRD=2026-03-01
+# EMD standalone — separate category from TKTT / ADM / exchange
+TXN|TRNN=000008|TRNC=EMDS|TDNR=1255555000001|PXNM=PARK/MIN|ORAC=ICN|DSTC=NRT|AL=KE|DAIS=2026-03-24|TDAM=75.00|COAM=0.00|TMFA=0.00|FPTP=CC|CUTP=USD|SQNR=00000008
diff --git a/packages/agents/reconciliation/src/bsp-reconciliation/hot-file-parser.ts b/packages/agents/reconciliation/src/bsp-reconciliation/hot-file-parser.ts
index b4296f5..a3e0eb5 100644
--- a/packages/agents/reconciliation/src/bsp-reconciliation/hot-file-parser.ts
+++ b/packages/agents/reconciliation/src/bsp-reconciliation/hot-file-parser.ts
@@ -1,18 +1,37 @@
 /**
  * HOT (Hand-Off Tape) File Parser
  *
- * Parses BSP billing files in EDI X12 or fixed-width ASCII format.
- * Auto-detects format based on content.
+ * Production HOT follows IATA DISH Rev 23 fixed-width record grids
+ * (BFH/BCH/BOH/BKT/BKS/…). Generic EDI X12 parsers miss those sections —
+ * see docs/knowledge-base/bsp-hot-reconciliation.md.
+ *
+ * Supported lab formats:
+ * - DISH_REV23: synthetic tagged records (never real agency data)
+ * - FIXED_WIDTH / EDI_X12: legacy simplified fixtures
  */
 
-import type { HOTFileRecord, HOTFileFormat } from './types.js';
+import type {
+  DishTransactionCode,
+  HOTFileFormat,
+  HOTFileRecord,
+  HOTTransactionType,
+  RelatedDocumentRef,
+} from './types.js';
 
 const EDI_DELIMITER = '*';
 const EDI_SEGMENT_TERMINATOR = '~';
 
 function detectFormat(content: string): HOTFileFormat {
-  const firstLine = content.split('\n')[0] ?? '';
-  // EDI X12 files typically start with ISA or ST segment
+  const trimmed = content.trimStart();
+  const firstLine = trimmed.split('\n')[0] ?? '';
+  if (
+    firstLine.startsWith('# SYNTHETIC DISH') ||
+    firstLine.startsWith('BFH|') ||
+    firstLine.startsWith('BOH|') ||
+    firstLine.startsWith('TXN|')
+  ) {
+    return 'DISH_REV23';
+  }
   if (
     firstLine.includes(EDI_SEGMENT_TERMINATOR) ||
     firstLine.startsWith('ISA') ||
@@ -23,30 +42,260 @@ function detectFormat(content: string): HOTFileFormat {
   return 'FIXED_WIDTH';
 }
 
-function parseTransactionType(code: string): 'SALE' | 'REFUND' | 'ADM' | 'ACM' {
-  switch (code.trim().toUpperCase()) {
+function mapDishCodeToType(
+  code: string,
+  paymentType?: string,
+): { transaction_type: HOTTransactionType; transaction_code: DishTransactionCode } {
+  const c = code.trim().toUpperCase();
+  const pay = (paymentType ?? '').trim().toUpperCase();
+
+  if (c === 'EXCH' || pay === 'EX' || pay === 'EXCH') {
+    return { transaction_type: 'EXCHANGE', transaction_code: c === 'EXCH' ? 'EXCH' : 'TKTT' };
+  }
+
+  switch (c) {
+    case 'TKTT':
     case 'SALE':
     case 'S':
-    case 'TKTT':
-      return 'SALE';
+      return { transaction_type: 'SALE', transaction_code: c === 'S' || c === 'SALE' ? 'TKTT' : 'TKTT' };
+    case 'RFND':
     case 'REFUND':
     case 'R':
-    case 'RFND':
-      return 'REFUND';
+      return { transaction_type: 'REFUND', transaction_code: 'RFND' };
+    case 'ADMA':
     case 'ADM':
     case 'D':
-      return 'ADM';
+      return { transaction_type: 'ADM', transaction_code: 'ADMA' };
+    case 'ACMA':
     case 'ACM':
     case 'C':
-      return 'ACM';
+      return { transaction_type: 'ACM', transaction_code: 'ACMA' };
+    case 'EMDA':
+      return { transaction_type: 'EMD', transaction_code: 'EMDA' };
+    case 'EMDS':
+      return { transaction_type: 'EMD', transaction_code: 'EMDS' };
+    case 'CANX':
+      return { transaction_type: 'SALE', transaction_code: 'CANX' };
+    case 'TASF':
+      return { transaction_type: 'SALE', transaction_code: 'TASF' };
     default:
-      return 'SALE';
+      return { transaction_type: 'SALE', transaction_code: 'OTHER' };
+  }
+}
+
+function parseTransactionType(code: string): HOTTransactionType {
+  return mapDishCodeToType(code).transaction_type;
+}
+
+function normalizeTicket(raw: string): string {
+  const digits = raw.replace(/\D/g, '');
+  // DISH TDNR is up to 14 AN; agency matching uses 13-digit form (drop check digit when present)
+  if (digits.length === 14) return digits.slice(0, 13);
+  return digits;
+}
+
+function parseKvLine(line: string): Record<string, string> {
+  const out: Record<string, string> = {};
+  const parts = line.split('|');
+  // parts[0] is record tag (BFH, BOH, TXN, CNJ, REL, …)
+  for (let i = 1; i < parts.length; i++) {
+    const part = parts[i];
+    if (!part) continue;
+    const eq = part.indexOf('=');
+    if (eq <= 0) continue;
+    const key = part.slice(0, eq).trim().toUpperCase();
+    const value = part.slice(eq + 1).trim();
+    out[key] = value;
+  }
+  return out;
+}
+
+/**
+ * Synthetic DISH Rev 23–like tagged HOT.
+ * Lines: BFH|…, BOH|CUTP=…, TXN|TRNC=…|TDNR=…|CUTP=…, CNJ|…, REL|…
+ * Never parse live agency HOT dumps into fixtures.
+ */
+function parseDishRev23(content: string): HOTFileRecord[] {
+  const records: HOTFileRecord[] = [];
+  const lines = content.split('\n').map((l) => l.trim()).filter(Boolean);
+
+  let reportingCurrency: string | undefined;
+  let billingPeriod: string | undefined;
+  // Conjunction / related docs keyed by TRNN until we flush TXN rows
+  const conjunctionByTrnn = new Map<string, string[]>();
+  const relatedByTrnn = new Map<string, RelatedDocumentRef[]>();
+  const pendingByTrnn = new Map<string, Partial<HOTFileRecord> & { ticket_number: string }>();
+
+  const flushPending = (): void => {
+    for (const partial of pendingByTrnn.values()) {
+      const trnn = partial.transaction_number ?? '';
+      const cnj = conjunctionByTrnn.get(trnn) ?? [];
+      const related = relatedByTrnn.get(trnn) ?? [];
+      const ticket = partial.ticket_number;
+      const others = cnj.filter((t) => t !== ticket);
+      const pay = partial.payment_type;
+      const mapped = mapDishCodeToType(
+        partial.transaction_code ?? partial.transaction_type ?? 'TKTT',
+        pay,
+      );
+
+      records.push({
+        ticket_number: ticket,
+        passenger_name: partial.passenger_name ?? '',
+        origin: partial.origin ?? '',
+        destination: partial.destination ?? '',
+        airline_code: partial.airline_code ?? 'XX',
+        issue_date: partial.issue_date ?? '',
+        ticket_amount: partial.ticket_amount ?? '0.00',
+        commission_amount: partial.commission_amount ?? '0.00',
+        tax_amount: partial.tax_amount ?? '0.00',
+        ...(partial.refund_amount !== undefined ? { refund_amount: partial.refund_amount } : {}),
+        transaction_type: mapped.transaction_type,
+        transaction_code: mapped.transaction_code,
+        ...(partial.issue_sequence !== undefined ? { issue_sequence: partial.issue_sequence } : {}),
+        ...(pay !== undefined ? { payment_type: pay } : {}),
+        currency: partial.currency ?? reportingCurrency ?? 'USD',
+        ...(reportingCurrency !== undefined ? { reporting_currency: reportingCurrency } : {}),
+        ...(billingPeriod !== undefined ? { billing_period: billingPeriod } : {}),
+        ...(trnn ? { transaction_number: trnn } : {}),
+        ...(partial.is_conjunction !== undefined ? { is_conjunction: partial.is_conjunction } : {}),
+        ...(partial.conjunction_primary !== undefined
+          ? { conjunction_primary: partial.conjunction_primary }
+          : {}),
+        ...(others.length > 0 ? { conjunction_ticket_numbers: others } : {}),
+        ...(partial.original_ticket_number !== undefined
+          ? { original_ticket_number: partial.original_ticket_number }
+          : {}),
+        ...(related.length > 0 ? { related_documents: related } : {}),
+      });
+    }
+    pendingByTrnn.clear();
+  };
+
+  for (const line of lines) {
+    if (line.startsWith('#')) continue;
+    const tag = line.split('|')[0]?.toUpperCase() ?? '';
+    const kv = parseKvLine(line);
+
+    if (tag === 'BFH') {
+      if (kv['PERIOD']) billingPeriod = kv['PERIOD'];
+      continue;
+    }
+    if (tag === 'BOH') {
+      if (kv['CUTP']) reportingCurrency = kv['CUTP'];
+      if (kv['PERIOD']) billingPeriod = kv['PERIOD'];
+      continue;
+    }
+    if (tag === 'CNJ') {
+      const trnn = kv['TRNN'] ?? '';
+      const tdnr = normalizeTicket(kv['TDNR'] ?? '');
+      const primary = normalizeTicket(kv['PRIMARY'] ?? '');
+      if (!trnn || !tdnr) continue;
+      const list = conjunctionByTrnn.get(trnn) ?? [];
+      if (primary && !list.includes(primary)) list.push(primary);
+      if (!list.includes(tdnr)) list.push(tdnr);
+      conjunctionByTrnn.set(trnn, list);
+
+      // Also register a pending CNJ document row if not already a TXN
+      if (!pendingByTrnn.has(`${trnn}:${tdnr}`)) {
+        pendingByTrnn.set(`${trnn}:${tdnr}`, {
+          ticket_number: tdnr,
+          transaction_number: trnn,
+          is_conjunction: true,
+          conjunction_primary: primary || undefined,
+          transaction_type: 'SALE',
+          transaction_code: 'TKTT',
+          currency: kv['CUTP'] ?? reportingCurrency ?? 'USD',
+          passenger_name: kv['PXNM'] ?? '',
+          origin: kv['ORAC'] ?? '',
+          destination: kv['DSTC'] ?? '',
+          airline_code: kv['AL'] ?? 'XX',
+          issue_date: kv['DAIS'] ?? '',
+          ticket_amount: kv['TDAM'] ?? '0.00',
+          commission_amount: kv['COAM'] ?? '0.00',
+          tax_amount: kv['TMFA'] ?? '0.00',
+        });
+      } else {
+        const existing = pendingByTrnn.get(`${trnn}:${tdnr}`)!;
+        existing.is_conjunction = true;
+        if (primary) existing.conjunction_primary = primary;
+      }
+      continue;
+    }
+    if (tag === 'REL') {
+      const trnn = kv['TRNN'] ?? '';
+      const rtdn = normalizeTicket(kv['RTDN'] ?? '');
+      if (!trnn || !rtdn) continue;
+      const list = relatedByTrnn.get(trnn) ?? [];
+      list.push({
+        ticket_number: rtdn,
+        ...(kv['RCPN'] !== undefined ? { coupons: kv['RCPN'] } : {}),
+        ...(kv['DIRD'] !== undefined ? { issue_date: kv['DIRD'] } : {}),
+      });
+      relatedByTrnn.set(trnn, list);
+      continue;
+    }
+    if (tag === 'TXN') {
+      const trnn = kv['TRNN'] ?? String(pendingByTrnn.size + 1).padStart(6, '0');
+      const tdnr = normalizeTicket(kv['TDNR'] ?? '');
+      if (!tdnr) continue;
+      const pay = kv['FPTP'] ?? kv['PAY'];
+      const mapped = mapDishCodeToType(kv['TRNC'] ?? 'TKTT', pay);
+      const key = `${trnn}:${tdnr}`;
+      pendingByTrnn.set(key, {
+        ticket_number: tdnr,
+        passenger_name: kv['PXNM'] ?? '',
+        origin: kv['ORAC'] ?? '',
+        destination: kv['DSTC'] ?? '',
+        airline_code: kv['AL'] ?? 'XX',
+        issue_date: kv['DAIS'] ?? '',
+        ticket_amount: kv['TDAM'] ?? '0.00',
+        commission_amount: kv['COAM'] ?? '0.00',
+        tax_amount: kv['TMFA'] ?? '0.00',
+        ...(kv['RFND'] !== undefined ? { refund_amount: kv['RFND'] } : {}),
+        transaction_type: mapped.transaction_type,
+        transaction_code: mapped.transaction_code,
+        issue_sequence: kv['SQNR'],
+        payment_type: pay,
+        currency: kv['CUTP'] ?? reportingCurrency ?? 'USD',
+        transaction_number: trnn,
+        ...(kv['ORIT'] !== undefined
+          ? { original_ticket_number: normalizeTicket(kv['ORIT']) }
+          : {}),
+        ...(kv['CJCP']?.toUpperCase() === 'CNJ' ? { is_conjunction: true } : {}),
+        ...(kv['PRIMARY'] !== undefined
+          ? { conjunction_primary: normalizeTicket(kv['PRIMARY']) }
+          : {}),
+      });
+
+      // Inline RTDN on TXN for convenience in fixtures
+      if (kv['RTDN']) {
+        const list = relatedByTrnn.get(trnn) ?? [];
+        list.push({ ticket_number: normalizeTicket(kv['RTDN']) });
+        relatedByTrnn.set(trnn, list);
+      }
+      continue;
+    }
+  }
+
+  flushPending();
+
+  // Attach conjunction companions onto primary TXN rows sharing TRNN
+  for (const rec of records) {
+    if (!rec.transaction_number) continue;
+    const set = conjunctionByTrnn.get(rec.transaction_number);
+    if (!set || set.length === 0) continue;
+    const others = set.filter((t) => t !== rec.ticket_number);
+    if (others.length > 0) {
+      rec.conjunction_ticket_numbers = others;
+    }
   }
+
+  return records;
 }
 
 function parseEdiX12(content: string): HOTFileRecord[] {
   const records: HOTFileRecord[] = [];
-  // Split by segment terminator, filter to transaction segments
   const segments = content
     .split(EDI_SEGMENT_TERMINATOR)
     .map((s) => s.trim())
@@ -56,11 +305,14 @@ function parseEdiX12(content: string): HOTFileRecord[] {
     const fields = segment.split(EDI_DELIMITER);
     const segType = fields[0]?.trim();
 
-    // BHT = transaction detail in HOT files
-    // We look for segments with ticket data — format: TKT*ticketnum*paxname*origin*dest*airline*date*amount*commission*tax*refund*txntype*seq*payment*currency*period
+    // Lab fixture format — not DISH. Generic X12 alone is insufficient for production HOT.
     if (segType === 'TKT' && fields.length >= 15) {
+      const pay = fields[13]?.trim() || undefined;
+      const mapped = mapDishCodeToType(fields[11]?.trim() ?? 'SALE', pay);
+      const original = fields[16]?.trim();
+      const related = fields[17]?.trim();
       records.push({
-        ticket_number: fields[1]?.trim() ?? '',
+        ticket_number: normalizeTicket(fields[1]?.trim() ?? ''),
         passenger_name: fields[2]?.trim() ?? '',
         origin: fields[3]?.trim() ?? '',
         destination: fields[4]?.trim() ?? '',
@@ -70,11 +322,16 @@ function parseEdiX12(content: string): HOTFileRecord[] {
         commission_amount: fields[8]?.trim() ?? '0.00',
         tax_amount: fields[9]?.trim() ?? '0.00',
         refund_amount: fields[10]?.trim() || undefined,
-        transaction_type: parseTransactionType(fields[11]?.trim() ?? 'SALE'),
+        transaction_type: mapped.transaction_type,
+        transaction_code: mapped.transaction_code,
         issue_sequence: fields[12]?.trim() || undefined,
-        payment_type: fields[13]?.trim() || undefined,
+        payment_type: pay,
         currency: fields[14]?.trim() ?? 'USD',
         billing_period: fields[15]?.trim() || undefined,
+        ...(original ? { original_ticket_number: normalizeTicket(original) } : {}),
+        ...(related
+          ? { related_documents: [{ ticket_number: normalizeTicket(related) }] }
+          : {}),
       });
     }
   }
@@ -87,33 +344,20 @@ function parseFixedWidth(content: string): HOTFileRecord[] {
   const lines = content.split('\n').filter((line) => line.trim().length > 0);
 
   for (const line of lines) {
-    // Skip header/trailer lines
     if (line.startsWith('HDR') || line.startsWith('TRL') || line.startsWith('#')) {
       continue;
     }
 
-    // Fixed-width layout:
-    // Cols  1-13:  ticket_number
-    // Cols 14-43:  passenger_name
-    // Cols 44-46:  origin
-    // Cols 47-49:  destination
-    // Cols 50-51:  airline_code
-    // Cols 52-61:  issue_date (YYYY-MM-DD)
-    // Cols 62-73:  ticket_amount (right-aligned, 2 decimals)
-    // Cols 74-85:  commission_amount
-    // Cols 86-97:  tax_amount
-    // Cols 98-109: refund_amount
-    // Cols 110-113: transaction_type
-    // Cols 114-123: issue_sequence
-    // Cols 124-128: payment_type
-    // Cols 129-131: currency
-    // Cols 132-139: billing_period
-
+    // Legacy lab fixed-width (not a market DISH grid).
     if (line.length < 131) continue;
 
-    const ticketNumber = line.slice(0, 13).trim();
+    const ticketNumber = normalizeTicket(line.slice(0, 13).trim());
     if (!/^\d{13}$/.test(ticketNumber)) continue;
 
+    const txnCode = line.slice(109, 113).trim();
+    const mapped = mapDishCodeToType(txnCode);
+    const currency = line.slice(128, 131).trim() || 'USD';
+
     records.push({
       ticket_number: ticketNumber,
       passenger_name: line.slice(13, 43).trim(),
@@ -125,11 +369,16 @@ function parseFixedWidth(content: string): HOTFileRecord[] {
       commission_amount: line.slice(73, 85).trim(),
       tax_amount: line.slice(85, 97).trim(),
       refund_amount: line.slice(97, 109).trim() || undefined,
-      transaction_type: parseTransactionType(line.slice(109, 113).trim()),
+      transaction_type: mapped.transaction_type,
+      transaction_code: mapped.transaction_code,
       issue_sequence: line.slice(113, 123).trim() || undefined,
       payment_type: line.slice(123, 128).trim() || undefined,
-      currency: line.slice(128, 131).trim() || 'USD',
+      currency,
+      // Explicit: do not assume file-wide single currency — each row carries CUTP-equivalent
       billing_period: line.length >= 139 ? line.slice(131, 139).trim() || undefined : undefined,
+      ...(line.length >= 152 && line.slice(139, 152).trim()
+        ? { original_ticket_number: normalizeTicket(line.slice(139, 152).trim()) }
+        : {}),
     });
   }
 
@@ -149,6 +398,8 @@ export class HOTFileParser {
     const format = this.format ?? detectFormat(content);
 
     switch (format) {
+      case 'DISH_REV23':
+        return parseDishRev23(content);
       case 'EDI_X12':
         return parseEdiX12(content);
       case 'FIXED_WIDTH':
@@ -160,3 +411,5 @@ export class HOTFileParser {
     return detectFormat(content);
   }
 }
+
+export { parseTransactionType, mapDishCodeToType };
diff --git a/packages/agents/reconciliation/src/bsp-reconciliation/index.ts b/packages/agents/reconciliation/src/bsp-reconciliation/index.ts
index f8174c6..63250d6 100644
--- a/packages/agents/reconciliation/src/bsp-reconciliation/index.ts
+++ b/packages/agents/reconciliation/src/bsp-reconciliation/index.ts
@@ -5,6 +5,7 @@
  * validates commission, identifies discrepancies, flags issues
  * before remittance deadline.
  *
+ * Domain: docs/knowledge-base/bsp-hot-reconciliation.md (DISH Rev 23).
  * Implements the base Agent interface from @otaip/core.
  */
 
@@ -19,7 +20,7 @@ const CARRIER_RE = /^[A-Z0-9]{2}$/;
 export class BSPReconciliation implements Agent<BSPReconciliationInput, BSPReconciliationOutput> {
   readonly id = '7.1';
   readonly name = 'BSP Reconciliation';
-  readonly version = '0.1.0';
+  readonly version = '0.2.0';
 
   private initialized = false;
 
@@ -47,6 +48,12 @@ export class BSPReconciliation implements Agent<BSPReconciliationInput, BSPRecon
     if (result.summary.patterns.length > 0) {
       warnings.push(`${result.summary.patterns.length} recurring pattern(s) detected.`);
     }
+    if (result.summary.currencies_present.length > 1) {
+      warnings.push(
+        `Multi-currency HOT: transaction CUTP values [${result.summary.currencies_present.join(', ')}]. ` +
+          `Do not assume single-currency; IROE≠ICER — amounts compared only within matching CUTP.`,
+      );
+    }
     if (input.data.remittance_deadline) {
       const now = input.data.current_datetime ? new Date(input.data.current_datetime) : new Date();
       const deadline = new Date(input.data.remittance_deadline);
@@ -57,6 +64,7 @@ export class BSPReconciliation implements Agent<BSPReconciliationInput, BSPRecon
         );
       }
     }
+    // TODO: DOMAIN_QUESTION: DQ-HOT-1 — market remittance calendar / grace not hardcoded
 
     return {
       data: result,
@@ -70,6 +78,7 @@ export class BSPReconciliation implements Agent<BSPReconciliationInput, BSPRecon
         total_hot: result.summary.total_hot_records,
         matched: result.summary.matched_count,
         discrepancies: result.summary.discrepancy_count,
+        currencies_present: result.summary.currencies_present,
         passed: result.passed,
       },
     };
@@ -120,6 +129,24 @@ export class BSPReconciliation implements Agent<BSPReconciliationInput, BSPRecon
           `Invalid airline code: ${ar.airline_code ?? 'missing'}`,
         );
       }
+      if (ar.original_ticket_number && !TICKET_NUMBER_RE.test(ar.original_ticket_number)) {
+        throw new AgentInputValidationError(
+          this.id,
+          'agency_records.original_ticket_number',
+          `Invalid original ticket number: ${ar.original_ticket_number}`,
+        );
+      }
+      if (ar.conjunction_ticket_numbers) {
+        for (const ct of ar.conjunction_ticket_numbers) {
+          if (!TICKET_NUMBER_RE.test(ct)) {
+            throw new AgentInputValidationError(
+              this.id,
+              'agency_records.conjunction_ticket_numbers',
+              `Invalid conjunction ticket number: ${ct}`,
+            );
+          }
+        }
+      }
     }
 
     for (const hot of data.hot_records) {
@@ -141,6 +168,9 @@ export type {
   BSPReconciliationOutput,
   HOTFileRecord,
   HOTFileFormat,
+  HOTTransactionType,
+  DishTransactionCode,
+  RelatedDocumentRef,
   AgencyRecord,
   Discrepancy,
   DiscrepancyType,
diff --git a/packages/agents/reconciliation/src/bsp-reconciliation/reconciliation-matcher.ts b/packages/agents/reconciliation/src/bsp-reconciliation/reconciliation-matcher.ts
index daf3079..ca72dc7 100644
--- a/packages/agents/reconciliation/src/bsp-reconciliation/reconciliation-matcher.ts
+++ b/packages/agents/reconciliation/src/bsp-reconciliation/reconciliation-matcher.ts
@@ -1,7 +1,11 @@
 /**
  * BSP Reconciliation Matcher
  *
- * Matches agency records against HOT file records, detects discrepancies.
+ * Matches agency records against HOT file records with multi-currency gates
+ * and exchange / conjunction / ADM-ACM cross-references (DISH Rev 23).
+ *
+ * Domain: docs/knowledge-base/bsp-hot-reconciliation.md
+ * IROE ≠ ICER — never convert amounts for matching without an explicit rate source.
  */
 
 import Decimal from 'decimal.js';
@@ -14,23 +18,137 @@ import type {
   DiscrepancySeverity,
   ReconciliationSummary,
   PatternDetection,
+  HOTTransactionType,
 } from './types.js';
 
 const DEFAULT_THRESHOLD = '10.00';
 
 function severity(type: string, amount: Decimal): DiscrepancySeverity {
-  if (type === 'MISSING_IN_HOT' || type === 'MISSING_IN_AGENCY') return 'critical';
-  if (type === 'UNMATCHED_ADM') return 'high';
+  if (
+    type === 'MISSING_IN_HOT' ||
+    type === 'MISSING_IN_AGENCY' ||
+    type === 'CONJUNCTION_SET_MISMATCH'
+  ) {
+    return 'critical';
+  }
+  if (type === 'UNMATCHED_ADM' || type === 'UNMATCHED_EXCHANGE') return 'high';
   if (amount.abs().greaterThan(100)) return 'high';
   if (amount.abs().greaterThan(50)) return 'medium';
   return 'low';
 }
 
+function relatedTicketsFromHot(hot: HOTFileRecord): string[] {
+  const out: string[] = [];
+  if (hot.original_ticket_number) out.push(hot.original_ticket_number);
+  if (hot.conjunction_primary) out.push(hot.conjunction_primary);
+  if (hot.conjunction_ticket_numbers) out.push(...hot.conjunction_ticket_numbers);
+  if (hot.related_documents) {
+    for (const r of hot.related_documents) out.push(r.ticket_number);
+  }
+  return out;
+}
+
+function agencyCrossRefs(ar: AgencyRecord): string[] {
+  const out: string[] = [];
+  if (ar.original_ticket_number) out.push(ar.original_ticket_number);
+  if (ar.related_ticket_number) out.push(ar.related_ticket_number);
+  if (ar.conjunction_ticket_numbers) out.push(...ar.conjunction_ticket_numbers);
+  return out;
+}
+
+/**
+ * Find a HOT row that matches an agency row beyond simple ticket equality:
+ * same ticket+type, or exchange via ORIT, or ADM/ACM/RFND via RTDN, or conjunction set.
+ */
+function findMatchingHot(
+  ar: AgencyRecord,
+  hotRecsForTicket: HOTFileRecord[] | undefined,
+  allHot: HOTFileRecord[],
+): HOTFileRecord | undefined {
+  if (hotRecsForTicket) {
+    const direct = hotRecsForTicket.find((h) => h.transaction_type === ar.transaction_type);
+    if (direct) return direct;
+  }
+
+  // Exchange: agency new ticket ↔ HOT issue with ORIT = original
+  if (ar.transaction_type === 'EXCHANGE') {
+    const byNew = allHot.find(
+      (h) =>
+        h.ticket_number === ar.ticket_number &&
+        (h.transaction_type === 'EXCHANGE' ||
+          (h.transaction_type === 'SALE' && h.original_ticket_number !== undefined)),
+    );
+    if (byNew) return byNew;
+
+    if (ar.original_ticket_number) {
+      const byOrit = allHot.find(
+        (h) =>
+          h.original_ticket_number === ar.original_ticket_number &&
+          (h.transaction_type === 'EXCHANGE' || h.payment_type?.toUpperCase() === 'EX'),
+      );
+      if (byOrit) return byOrit;
+    }
+  }
+
+  // Agency still holding original while HOT shows exchange of that original
+  if (ar.transaction_type === 'SALE') {
+    const exch = allHot.find(
+      (h) =>
+        h.original_ticket_number === ar.ticket_number &&
+        (h.transaction_type === 'EXCHANGE' || h.payment_type?.toUpperCase() === 'EX'),
+    );
+    // Do not treat original as matched to the exchange row for amount compare —
+    // caller uses this only when direct miss; return undefined so original can
+    // be reconciled separately unless agency marks EXCHANGE.
+    void exch;
+  }
+
+  // Refund / ADM / ACM: HOT TDNR may be memo id; RTDN holds ticket
+  if (ar.transaction_type === 'REFUND' || ar.transaction_type === 'ADM' || ar.transaction_type === 'ACM') {
+    const related = ar.related_ticket_number ?? ar.ticket_number;
+    const viaRtdn = allHot.find(
+      (h) =>
+        h.transaction_type === ar.transaction_type &&
+        (h.ticket_number === ar.ticket_number ||
+          h.related_documents?.some((r) => r.ticket_number === related) ||
+          h.related_documents?.some((r) => r.ticket_number === ar.ticket_number)),
+    );
+    if (viaRtdn) return viaRtdn;
+  }
+
+  // Conjunction companion present under another TDNR sharing the set
+  if (ar.conjunction_ticket_numbers && ar.conjunction_ticket_numbers.length > 0) {
+    const set = new Set([ar.ticket_number, ...ar.conjunction_ticket_numbers]);
+    const companion = allHot.find(
+      (h) =>
+        h.transaction_type === ar.transaction_type &&
+        (set.has(h.ticket_number) ||
+          h.conjunction_ticket_numbers?.some((t) => set.has(t)) ||
+          (h.conjunction_primary !== undefined && set.has(h.conjunction_primary))),
+    );
+    if (companion && companion.ticket_number === ar.ticket_number) return companion;
+    // Prefer the HOT row for this exact ticket within the set
+    const exact = allHot.find((h) => h.ticket_number === ar.ticket_number && set.has(h.ticket_number));
+    if (exact) return exact;
+  }
+
+  return undefined;
+}
+
+function conjunctionSetOf(hot: HOTFileRecord): string[] {
+  const set = new Set<string>([hot.ticket_number]);
+  if (hot.conjunction_primary) set.add(hot.conjunction_primary);
+  if (hot.conjunction_ticket_numbers) {
+    for (const t of hot.conjunction_ticket_numbers) set.add(t);
+  }
+  return [...set];
+}
+
 function matchRecords(input: BSPReconciliationInput): BSPReconciliationOutput {
   const threshold = new Decimal(input.min_threshold ?? DEFAULT_THRESHOLD);
+  const thresholdCurrency = input.threshold_currency ?? 'USD';
   const discrepancies: Discrepancy[] = [];
 
-  // Index HOT records by ticket number
   const hotByTicket = new Map<string, HOTFileRecord[]>();
   for (const hot of input.hot_records) {
     const existing = hotByTicket.get(hot.ticket_number) ?? [];
@@ -38,7 +156,6 @@ function matchRecords(input: BSPReconciliationInput): BSPReconciliationOutput {
     hotByTicket.set(hot.ticket_number, existing);
   }
 
-  // Index agency records by ticket number
   const agencyByTicket = new Map<string, AgencyRecord[]>();
   for (const ar of input.agency_records) {
     const existing = agencyByTicket.get(ar.ticket_number) ?? [];
@@ -46,51 +163,87 @@ function matchRecords(input: BSPReconciliationInput): BSPReconciliationOutput {
     agencyByTicket.set(ar.ticket_number, existing);
   }
 
+  const matchedHotTickets = new Set<string>();
   let matchedCount = 0;
 
-  // Check each agency record against HOT
   for (const [ticketNum, agencyRecs] of agencyByTicket) {
-    const hotRecs = hotByTicket.get(ticketNum);
+    for (const ar of agencyRecs) {
+      const matchingHot = findMatchingHot(ar, hotByTicket.get(ticketNum), input.hot_records);
+
+      if (!matchingHot) {
+        // If this ticket is only the original of an exchange that exists on HOT,
+        // and agency did not book a separate SALE for it in-period, skip critical miss
+        // when agency also has an EXCHANGE referencing it.
+        const coveredByAgencyExchange = input.agency_records.some(
+          (other) =>
+            other.transaction_type === 'EXCHANGE' && other.original_ticket_number === ticketNum,
+        );
+        const hotExchangeOfOriginal = input.hot_records.some(
+          (h) => h.original_ticket_number === ticketNum,
+        );
+        if (coveredByAgencyExchange && hotExchangeOfOriginal && ar.transaction_type === 'SALE') {
+          matchedCount++;
+          matchedHotTickets.add(ticketNum);
+          continue;
+        }
 
-    if (!hotRecs || hotRecs.length === 0) {
-      // Missing in HOT
-      for (const ar of agencyRecs) {
         const amount = new Decimal(ar.ticket_amount);
-        if (amount.abs().greaterThanOrEqualTo(threshold)) {
+        const type = ar.transaction_type === 'EXCHANGE' ? 'UNMATCHED_EXCHANGE' : 'MISSING_IN_HOT';
+        // Even exchanges may have zero amounts (DISH §6.5.6) — still surface unmatched EXCHANGE
+        if (type === 'UNMATCHED_EXCHANGE' || amount.abs().greaterThanOrEqualTo(threshold)) {
           discrepancies.push({
-            type: 'MISSING_IN_HOT',
-            severity: 'critical',
+            type,
+            severity: type === 'UNMATCHED_EXCHANGE' ? 'high' : 'critical',
             ticket_number: ticketNum,
+            ...(ar.original_ticket_number
+              ? { related_ticket_number: ar.original_ticket_number }
+              : ar.related_ticket_number
+                ? { related_ticket_number: ar.related_ticket_number }
+                : {}),
             airline_code: ar.airline_code,
             agency_amount: ar.ticket_amount,
             currency: ar.currency,
-            description: `Ticket ${ticketNum} exists in agency records but not in BSP HOT file.`,
+            description:
+              type === 'UNMATCHED_EXCHANGE'
+                ? `Exchange ticket ${ticketNum}` +
+                  (ar.original_ticket_number ? ` (ORIT ${ar.original_ticket_number})` : '') +
+                  ` not matched in BSP HOT via TDNR/ORIT cross-ref.`
+                : `Ticket ${ticketNum} exists in agency records but not in BSP HOT file.`,
           });
         }
-      }
-      continue;
-    }
-
-    // Match each agency record to a HOT record
-    for (const ar of agencyRecs) {
-      const matchingHot = hotRecs.find((h) => h.transaction_type === ar.transaction_type);
-
-      if (!matchingHot) {
-        discrepancies.push({
-          type: 'MISSING_IN_HOT',
-          severity: 'critical',
-          ticket_number: ticketNum,
-          airline_code: ar.airline_code,
-          agency_amount: ar.ticket_amount,
-          currency: ar.currency,
-          description: `Ticket ${ticketNum} ${ar.transaction_type} not found in HOT file.`,
-        });
         continue;
       }
 
       matchedCount++;
+      matchedHotTickets.add(matchingHot.ticket_number);
+      for (const rel of relatedTicketsFromHot(matchingHot)) matchedHotTickets.add(rel);
 
-      // Currency mismatch
+      // Conjunction set coverage
+      const hotSet = conjunctionSetOf(matchingHot);
+      const agencySet = new Set<string>([
+        ar.ticket_number,
+        ...(ar.conjunction_ticket_numbers ?? []),
+      ]);
+      if (hotSet.length > 1 || agencySet.size > 1) {
+        const missingFromHot = [...agencySet].filter((t) => !hotSet.includes(t));
+        const missingFromAgency = hotSet.filter((t) => !agencySet.has(t));
+        if (missingFromHot.length > 0 || missingFromAgency.length > 0) {
+          discrepancies.push({
+            type: 'CONJUNCTION_SET_MISMATCH',
+            severity: 'critical',
+            ticket_number: ticketNum,
+            airline_code: ar.airline_code,
+            currency: ar.currency,
+            description: `Conjunction set mismatch for ${ticketNum}: agency=[${[...agencySet].join(',')}] hot=[${hotSet.join(',')}]` +
+              (missingFromHot.length ? `; missing in HOT: ${missingFromHot.join(',')}` : '') +
+              (missingFromAgency.length
+                ? `; missing in agency: ${missingFromAgency.join(',')}`
+                : ''),
+          });
+        }
+      }
+
+      // Currency gate — transaction CUTP must match; no IROE/ICER conversion
       if (ar.currency !== matchingHot.currency) {
         discrepancies.push({
           type: 'CURRENCY_MISMATCH',
@@ -98,12 +251,16 @@ function matchRecords(input: BSPReconciliationInput): BSPReconciliationOutput {
           ticket_number: ticketNum,
           airline_code: ar.airline_code,
           currency: ar.currency,
-          description: `Currency mismatch on ${ticketNum}: agency ${ar.currency}, BSP ${matchingHot.currency}.`,
+          description: `Currency mismatch on ${ticketNum}: agency transaction currency ${ar.currency}, HOT CUTP ${matchingHot.currency}` +
+            (matchingHot.reporting_currency
+              ? ` (HOT reporting/default ${matchingHot.reporting_currency}; IROE≠ICER — do not auto-convert).`
+              : ' (do not assume single-currency HOT; IROE≠ICER — do not auto-convert).'),
         });
         continue;
       }
 
-      // Amount mismatch
+      // Amount mismatch (same CUTP only). Threshold is in transaction-currency units —
+      // never FX-convert via IROE/ICER (KB §2).
       const agencyAmt = new Decimal(ar.ticket_amount);
       const hotAmt = new Decimal(matchingHot.ticket_amount);
       const amtDiff = agencyAmt.minus(hotAmt).abs();
@@ -122,7 +279,6 @@ function matchRecords(input: BSPReconciliationInput): BSPReconciliationOutput {
         });
       }
 
-      // Commission mismatch
       const agencyComm = new Decimal(ar.commission_amount);
       const hotComm = new Decimal(matchingHot.commission_amount);
       const commDiff = agencyComm.minus(hotComm).abs();
@@ -143,73 +299,135 @@ function matchRecords(input: BSPReconciliationInput): BSPReconciliationOutput {
     }
   }
 
-  // Check for HOT records missing in agency
+  // HOT rows missing in agency (consider cross-refs)
   for (const [ticketNum, hotRecs] of hotByTicket) {
-    if (!agencyByTicket.has(ticketNum)) {
-      for (const hot of hotRecs) {
-        const amount = new Decimal(hot.ticket_amount);
-        if (amount.abs().greaterThanOrEqualTo(threshold)) {
-          if (hot.transaction_type === 'ADM') {
-            discrepancies.push({
-              type: 'UNMATCHED_ADM',
-              severity: 'high',
-              ticket_number: ticketNum,
-              airline_code: hot.airline_code,
-              bsp_amount: hot.ticket_amount,
-              currency: hot.currency,
-              description: `ADM ${ticketNum} in BSP HOT file not matched in agency records.`,
-            });
-          } else if (hot.transaction_type === 'ACM') {
-            discrepancies.push({
-              type: 'UNMATCHED_ACM',
-              severity: 'medium',
-              ticket_number: ticketNum,
-              airline_code: hot.airline_code,
-              bsp_amount: hot.ticket_amount,
-              currency: hot.currency,
-              description: `ACM ${ticketNum} in BSP HOT file not matched in agency records.`,
-            });
-          } else {
-            discrepancies.push({
-              type: 'MISSING_IN_AGENCY',
-              severity: 'critical',
-              ticket_number: ticketNum,
-              airline_code: hot.airline_code,
-              bsp_amount: hot.ticket_amount,
-              currency: hot.currency,
-              description: `Ticket ${ticketNum} in BSP HOT file but not in agency records.`,
-            });
+    for (const hot of hotRecs) {
+      if (matchedHotTickets.has(ticketNum)) continue;
+
+      const agencyHit =
+        agencyByTicket.has(ticketNum) ||
+        input.agency_records.some((ar) => {
+          if (agencyCrossRefs(ar).includes(ticketNum)) return true;
+          if (
+            hot.original_ticket_number &&
+            (ar.ticket_number === hot.original_ticket_number ||
+              ar.original_ticket_number === hot.original_ticket_number)
+          ) {
+            return true;
           }
-        }
+          if (hot.related_documents?.some((r) => r.ticket_number === ar.ticket_number)) {
+            return true;
+          }
+          if (
+            ar.conjunction_ticket_numbers?.includes(ticketNum) ||
+            hot.conjunction_ticket_numbers?.includes(ar.ticket_number)
+          ) {
+            return true;
+          }
+          return false;
+        });
+
+      if (agencyHit) {
+        matchedHotTickets.add(ticketNum);
+        continue;
+      }
+
+      const amount = new Decimal(hot.ticket_amount);
+      if (amount.abs().lessThan(threshold) && hot.transaction_type !== 'ADM' && hot.transaction_type !== 'ACM') {
+        continue;
+      }
+
+      if (hot.transaction_type === 'ADM') {
+        const related = hot.related_documents?.[0]?.ticket_number;
+        discrepancies.push({
+          type: 'UNMATCHED_ADM',
+          severity: 'high',
+          ticket_number: ticketNum,
+          ...(related ? { related_ticket_number: related } : {}),
+          airline_code: hot.airline_code,
+          bsp_amount: hot.ticket_amount,
+          currency: hot.currency,
+          description: `ADM ${ticketNum} in BSP HOT` +
+            (related ? ` (RTDN ${related})` : '') +
+            ` not matched in agency records.`,
+        });
+      } else if (hot.transaction_type === 'ACM') {
+        const related = hot.related_documents?.[0]?.ticket_number;
+        discrepancies.push({
+          type: 'UNMATCHED_ACM',
+          severity: 'medium',
+          ticket_number: ticketNum,
+          ...(related ? { related_ticket_number: related } : {}),
+          airline_code: hot.airline_code,
+          bsp_amount: hot.ticket_amount,
+          currency: hot.currency,
+          description: `ACM ${ticketNum} in BSP HOT` +
+            (related ? ` (RTDN ${related})` : '') +
+            ` not matched in agency records.`,
+        });
+      } else if (hot.transaction_type === 'EXCHANGE' || hot.original_ticket_number) {
+        discrepancies.push({
+          type: 'UNMATCHED_EXCHANGE',
+          severity: 'high',
+          ticket_number: ticketNum,
+          ...(hot.original_ticket_number
+            ? { related_ticket_number: hot.original_ticket_number }
+            : {}),
+          airline_code: hot.airline_code,
+          bsp_amount: hot.ticket_amount,
+          currency: hot.currency,
+          description: `Exchange-linked HOT document ${ticketNum}` +
+            (hot.original_ticket_number ? ` (ORIT ${hot.original_ticket_number})` : '') +
+            ` not matched in agency records.`,
+        });
+      } else {
+        discrepancies.push({
+          type: 'MISSING_IN_AGENCY',
+          severity: 'critical',
+          ticket_number: ticketNum,
+          airline_code: hot.airline_code,
+          bsp_amount: hot.ticket_amount,
+          currency: hot.currency,
+          description: `Ticket ${ticketNum} in BSP HOT file but not in agency records.`,
+        });
       }
     }
   }
 
-  // Duplicate detection within HOT
+  // Duplicate detection within HOT (same TDNR + category)
   for (const [ticketNum, hotRecs] of hotByTicket) {
-    const sales = hotRecs.filter((r) => r.transaction_type === 'SALE');
-    if (sales.length > 1) {
-      discrepancies.push({
-        type: 'DUPLICATE_TRANSACTION',
-        severity: 'high',
-        ticket_number: ticketNum,
-        airline_code: sales[0]!.airline_code,
-        bsp_amount: sales[0]!.ticket_amount,
-        currency: sales[0]!.currency,
-        description: `Duplicate SALE for ${ticketNum} in HOT file (${sales.length} occurrences).`,
-      });
+    const byType = new Map<HOTTransactionType, HOTFileRecord[]>();
+    for (const h of hotRecs) {
+      const list = byType.get(h.transaction_type) ?? [];
+      list.push(h);
+      byType.set(h.transaction_type, list);
+    }
+    for (const [txnType, list] of byType) {
+      if (txnType === 'SALE' && list.length > 1) {
+        discrepancies.push({
+          type: 'DUPLICATE_TRANSACTION',
+          severity: 'high',
+          ticket_number: ticketNum,
+          airline_code: list[0]!.airline_code,
+          bsp_amount: list[0]!.ticket_amount,
+          currency: list[0]!.currency,
+          description: `Duplicate SALE for ${ticketNum} in HOT file (${list.length} occurrences).`,
+        });
+      }
     }
   }
 
-  // Pattern detection
   const patterns = detectPatterns(discrepancies, input);
 
-  // Summary
   const totalDiscrepancyAmount = discrepancies.reduce(
     (sum, d) => sum.plus(new Decimal(d.difference ?? d.agency_amount ?? d.bsp_amount ?? '0')),
     new Decimal(0),
   );
 
+  const currenciesPresent = [
+    ...new Set(input.hot_records.map((h) => h.currency).filter(Boolean)),
+  ].sort();
+
   const summary: ReconciliationSummary = {
     total_agency_records: input.agency_records.length,
     total_hot_records: input.hot_records.length,
@@ -217,7 +435,8 @@ function matchRecords(input: BSPReconciliationInput): BSPReconciliationOutput {
     discrepancy_count: discrepancies.length,
     critical_count: discrepancies.filter((d) => d.severity === 'critical').length,
     total_discrepancy_amount: totalDiscrepancyAmount.toFixed(2),
-    currency: input.threshold_currency ?? 'USD',
+    currency: thresholdCurrency,
+    currencies_present: currenciesPresent,
     patterns,
   };
 
@@ -232,10 +451,8 @@ function detectPatterns(
 ): PatternDetection[] {
   const patterns: PatternDetection[] = [];
 
-  // Only detect patterns with sample size >= 10
   if (discrepancies.length < 10) return patterns;
 
-  // Pattern: commission mismatches by airline
   const commByAirline = new Map<string, { count: number; total: Decimal }>();
   for (const d of discrepancies) {
     if (d.type === 'COMMISSION_MISMATCH' && d.airline_code) {
@@ -257,7 +474,6 @@ function detectPatterns(
     }
   }
 
-  // Pattern: missing transactions by airline
   const missingByAirline = new Map<string, number>();
   for (const d of discrepancies) {
     if ((d.type === 'MISSING_IN_HOT' || d.type === 'MISSING_IN_AGENCY') && d.airline_code) {
diff --git a/packages/agents/reconciliation/src/bsp-reconciliation/types.ts b/packages/agents/reconciliation/src/bsp-reconciliation/types.ts
index b4a175d..44fa74b 100644
--- a/packages/agents/reconciliation/src/bsp-reconciliation/types.ts
+++ b/packages/agents/reconciliation/src/bsp-reconciliation/types.ts
@@ -3,6 +3,8 @@
  *
  * Agent 7.1: Matches agency records against BSP HOT files,
  * validates commission, identifies discrepancies.
+ *
+ * Domain: docs/knowledge-base/bsp-hot-reconciliation.md (DISH Rev 23).
  */
 
 export type DiscrepancyType =
@@ -13,45 +15,112 @@ export type DiscrepancyType =
   | 'AMOUNT_MISMATCH'
   | 'CURRENCY_MISMATCH'
   | 'UNMATCHED_ADM'
-  | 'UNMATCHED_ACM';
+  | 'UNMATCHED_ACM'
+  | 'UNMATCHED_EXCHANGE'
+  | 'CONJUNCTION_SET_MISMATCH';
 
 export type DiscrepancySeverity = 'critical' | 'high' | 'medium' | 'low';
 
-export type HOTFileFormat = 'EDI_X12' | 'FIXED_WIDTH';
+/**
+ * HOT parse formats.
+ * - DISH_REV23: synthetic DISH Rev 23–like tagged records (production HOT is fixed-width DISH).
+ * - FIXED_WIDTH / EDI_X12: legacy lab fixtures — NOT a substitute for market DISH grids.
+ *   Generic X12 parsers miss DISH fixed-width sections (see KB).
+ */
+export type HOTFileFormat = 'DISH_REV23' | 'EDI_X12' | 'FIXED_WIDTH';
+
+/**
+ * Logical reconciliation categories.
+ * DISH TRNC values map into these; exchange-linked issues are separate from plain TKTT sales.
+ * Conjunction / exchange / EMD / ADM are separate (KB §3).
+ */
+export type HOTTransactionType = 'SALE' | 'EXCHANGE' | 'REFUND' | 'ADM' | 'ACM' | 'EMD';
+
+/** DISH TRNC codes we surface on parsed rows (non-exhaustive). */
+export type DishTransactionCode =
+  | 'TKTT'
+  | 'EMDA'
+  | 'EMDS'
+  | 'RFND'
+  | 'ADMA'
+  | 'ACMA'
+  | 'EXCH'
+  | 'CANX'
+  | 'TASF'
+  | 'OTHER';
+
+export interface RelatedDocumentRef {
+  /** Related ticket/document number (DISH RTDN or ORIT) */
+  ticket_number: string;
+  /** Related coupons when present (DISH RCPN) */
+  coupons?: string;
+  /** Date of issue of related document (DISH DIRD / ORID) */
+  issue_date?: string;
+}
 
 export interface HOTFileRecord {
-  /** 13-digit ticket number */
+  /** 13-digit ticket / document number (DISH TDNR, check-digit stripped when present) */
   ticket_number: string;
   /** Passenger name */
   passenger_name: string;
-  /** Origin airport code */
+  /** Origin airport / city code */
   origin: string;
-  /** Destination airport code */
+  /** Destination airport / city code */
   destination: string;
-  /** 2-char airline code */
+  /** 2-char airline code (derived from TACN when only numeric present) */
   airline_code: string;
-  /** Issue date (ISO) */
+  /** Issue date (ISO preferred) */
   issue_date: string;
-  /** Ticket face value amount (decimal string) */
+  /** Ticket / document amount in transaction currency (decimal string) */
   ticket_amount: string;
-  /** Commission amount (decimal string) */
+  /** Commission amount in transaction currency (decimal string) */
   commission_amount: string;
   /** Commission rate percentage */
   commission_rate?: number;
-  /** Tax amount (decimal string) */
+  /** Tax amount in transaction currency (decimal string) */
   tax_amount: string;
   /** Refund amount if applicable (decimal string) */
   refund_amount?: string;
-  /** Transaction type: SALE, REFUND, ADM, ACM */
-  transaction_type: 'SALE' | 'REFUND' | 'ADM' | 'ACM';
-  /** Issue sequence number */
+  /** Logical transaction category used by the matcher */
+  transaction_type: HOTTransactionType;
+  /**
+   * DISH TRNC when known (TKTT / EMDA / EMDS / RFND / ADMA / ACMA / …).
+   * Exchange-linked TKTT issues may still carry transaction_type EXCHANGE.
+   */
+  transaction_code?: DishTransactionCode;
+  /** Issue sequence / SQNR */
   issue_sequence?: string;
-  /** Payment type */
+  /** Payment type / FOP family (CA, CC, EX, …) */
   payment_type?: string;
-  /** Currency code */
+  /**
+   * Transaction currency (DISH record-level CUTP).
+   * Do NOT assume this equals reporting_currency or a file-wide default.
+   */
   currency: string;
+  /**
+   * Reporting / default currency context (DISH BOH03 CUTP) when known.
+   * Used for remittance totals context only — never as a silent FX substitute.
+   */
+  reporting_currency?: string;
   /** BSP billing period (e.g., "2026-P03") */
   billing_period?: string;
+  /** HOT transaction number (DISH TRNN) — shared across conjunction / envelope records */
+  transaction_number?: string;
+  /** True when this row is a conjunction document (CJCP=CNJ / BKS24-CNJ) */
+  is_conjunction?: boolean;
+  /** Primary ticket of the conjunction set when this row is a CNJ document */
+  conjunction_primary?: string;
+  /** All other tickets in the conjunction set (excluding this row’s TDNR) */
+  conjunction_ticket_numbers?: string[];
+  /**
+   * Original issue ticket for exchange-linked issues (DISH BKS46 ORIT).
+   * Present on the NEW document’s HOT envelope.
+   */
+  original_ticket_number?: string;
+  /**
+   * Related documents for RFND / ADM / ACM (DISH BKS45 RTDN list).
+   */
+  related_documents?: RelatedDocumentRef[];
 }
 
 export interface AgencyRecord {
@@ -78,9 +147,20 @@ export interface AgencyRecord {
   /** Refund amount if applicable (decimal string) */
   refund_amount?: string;
   /** Transaction type */
-  transaction_type: 'SALE' | 'REFUND' | 'ADM' | 'ACM';
-  /** Currency code */
+  transaction_type: HOTTransactionType;
+  /**
+   * Transaction currency — must match HOT CUTP for amount compares.
+   * Do not assume agency reporting currency equals transaction currency.
+   */
   currency: string;
+  /** Reporting currency if mid-office stores a separate book currency */
+  reporting_currency?: string;
+  /** Original ticket when this agency row is an exchange reissue */
+  original_ticket_number?: string;
+  /** Conjunction companions for this ticket */
+  conjunction_ticket_numbers?: string[];
+  /** Related ticket for refund / ADM / ACM agency rows */
+  related_ticket_number?: string;
 }
 
 export interface Discrepancy {
@@ -90,6 +170,8 @@ export interface Discrepancy {
   severity: DiscrepancySeverity;
   /** Ticket number (if applicable) */
   ticket_number?: string;
+  /** Related / original ticket when cross-ref matching applies */
+  related_ticket_number?: string;
   /** Airline code */
   airline_code?: string;
   /** Agency amount (decimal string) */
@@ -98,7 +180,7 @@ export interface Discrepancy {
   bsp_amount?: string;
   /** Difference (decimal string) */
   difference?: string;
-  /** Currency */
+  /** Transaction currency of the compared amounts */
   currency?: string;
   /** Human-readable description */
   description: string;
@@ -128,10 +210,12 @@ export interface ReconciliationSummary {
   discrepancy_count: number;
   /** Critical discrepancies */
   critical_count: number;
-  /** Total discrepancy amount (decimal string) */
+  /** Total discrepancy amount (decimal string) — same-currency rows only */
   total_discrepancy_amount: string;
-  /** Currency */
+  /** Threshold / reporting currency for summary (not an FX claim) */
   currency: string;
+  /** Distinct transaction currencies observed in the HOT set */
+  currencies_present: string[];
   /** Patterns detected */
   patterns: PatternDetection[];
 }
@@ -147,7 +231,11 @@ export interface BSPReconciliationInput {
   remittance_deadline?: string;
   /** Minimum discrepancy threshold (decimal string, default "10.00") */
   min_threshold?: string;
-  /** Threshold currency (default "USD") */
+  /**
+   * Threshold currency (default "USD").
+   * Threshold applies only when the transaction currency equals this code —
+   * no IROE/ICER conversion (KB §2).
+   */
   threshold_currency?: string;
   /** Current date/time (ISO) */
   current_datetime?: string;
diff --git a/packages/agents/reconciliation/src/index.ts b/packages/agents/reconciliation/src/index.ts
index 21ba627..6ec5d90 100644
--- a/packages/agents/reconciliation/src/index.ts
+++ b/packages/agents/reconciliation/src/index.ts
@@ -10,6 +10,9 @@ export type {
   BSPReconciliationOutput,
   HOTFileRecord,
   HOTFileFormat,
+  HOTTransactionType,
+  DishTransactionCode,
+  RelatedDocumentRef,
   AgencyRecord,
   Discrepancy,
   DiscrepancyType,