diff --git a/README.md b/README.md
index 95c388f..88abd96 100644
--- a/README.md
+++ b/README.md
@@ -142,7 +142,7 @@ See [docs/architecture.md](docs/architecture.md) for the full architecture overv
 
 ## Domain Expertise
 
-OTAIP agents encode real industry logic: ATPCO fare rules (Categories 1-33), NUC/ROE fare construction with HIP/BHC/CTM checks, BSP HOT file reconciliation, ADM prevention (9 pre-ticketing checks), NDC/EDIFACT normalization, IRROPS rebooking with EU261 and US DOT compliance, void window enforcement, married segment integrity, and payment-to-ticketing state machines with BSP finality rules.
+OTAIP agents encode real industry logic: ATPCO fare rules (Categories 1-33), NUC/ROE fare construction with HIP/BHC/CTM checks, BSP HOT file reconciliation, ADM prevention (10 pre-ticketing checks), NDC/EDIFACT normalization, IRROPS rebooking with EU261 and US DOT compliance, void window enforcement, married segment integrity, and payment-to-ticketing state machines with BSP finality rules.
 
 ---
 
diff --git a/agents.graph.json b/agents.graph.json
index 5b508b7..7463c50 100644
--- a/agents.graph.json
+++ b/agents.graph.json
@@ -394,7 +394,7 @@
       "id": "6.2",
       "name": "ADM Prevention",
       "stage": "settlement",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "contract_status": "active",
       "has_contract": false,
       "source_path": "packages/agents/settlement/src/adm-prevention/index.ts"
diff --git a/agents.manifest.json b/agents.manifest.json
index 725539f..9cb7ba5 100644
--- a/agents.manifest.json
+++ b/agents.manifest.json
@@ -5357,7 +5357,7 @@
       "id": "6.2",
       "name": "ADM Prevention",
       "stage": "settlement",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "contract_status": "active",
       "has_contract": false,
       "source_path": "packages/agents/settlement/src/adm-prevention/index.ts"
diff --git a/docs/agent-map.html b/docs/agent-map.html
index cca978a..2573304 100644
--- a/docs/agent-map.html
+++ b/docs/agent-map.html
@@ -1897,7 +1897,7 @@ <h2>Every agent, by stage.</h2>
     <div class="panel-inner" id="panel-content"></div>
   </aside>
 
-  <script id="graph-data" type="application/json">{"graph":{"generated_by":"scripts/generate-manifest.ts","total_nodes":77,"total_edges":27,"nodes":[{"id":"0.1","name":"Airport/City Code Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/airport-code-resolver/index.ts"},{"id":"0.2","name":"Airline Code & Alliance Mapper","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/airline-code-mapper/index.ts"},{"id":"0.3","name":"Fare Basis Code Decoder","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/reference/src/fare-basis-decoder/index.ts"},{"id":"0.4","name":"Class of Service Mapper","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/class-of-service-mapper/index.ts"},{"id":"0.5","name":"Equipment Type Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/equipment-type-resolver/index.ts"},{"id":"0.6","name":"Currency & Tax Code Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/currency-tax-resolver/index.ts"},{"id":"0.7","name":"Country Regulatory Resolver","stage":"reference","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reference/src/country-regulatory-resolver/index.ts"},{"id":"1.1","name":"Availability Search","stage":"search","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/availability-search/index.ts"},{"id":"1.2","name":"Schedule Lookup","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/schedule-lookup/index.ts"},{"id":"1.3","name":"Connection Builder","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/connection-builder/index.ts"},{"id":"1.4","name":"Fare Shopping","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/fare-shopping/index.ts"},{"id":"1.5","name":"Ancillary Shopping","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/ancillary-shopping/index.ts"},{"id":"1.6","name":"Multi-Source Aggregator","stage":"search","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/search/src/multi-source-aggregator/index.ts"},{"id":"1.7","name":"Hotel & Car Search","stage":"search","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/hotel-car-search/index.ts"},{"id":"1.8","name":"AI Travel Advisor","stage":"search","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/search/src/ai-travel-advisor/index.ts"},{"id":"1.9","name":"Offer Evaluator","stage":"core","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/core/src/agents/shopping/offer-evaluator/index.ts"},{"id":"2.1","name":"Fare Rule Agent","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/pricing/src/fare-rule-agent/index.ts"},{"id":"2.2","name":"Fare Construction","stage":"pricing","version":"0.2.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/fare-construction/index.ts"},{"id":"2.3","name":"Tax Calculation","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/tax-calculation/index.ts"},{"id":"2.4","name":"Offer Builder","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/pricing/src/offer-builder/index.ts"},{"id":"2.5","name":"Corporate Policy Validation","stage":"pricing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/pricing/src/corporate-policy-validation/index.ts"},{"id":"2.6","name":"Dynamic Pricing","stage":"pricing","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/pricing/src/dynamic-pricing/index.ts"},{"id":"2.7","name":"Revenue Management","stage":"pricing","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/pricing/src/revenue-management/index.ts"},{"id":"3.1","name":"GDS/NDC Router","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/gds-ndc-router/index.ts"},{"id":"3.2","name":"PNR Builder","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/pnr-builder/index.ts"},{"id":"3.3","name":"PNR Validation","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/pnr-validation/index.ts"},{"id":"3.4","name":"Queue Management","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/queue-management/index.ts"},{"id":"3.5","name":"API Abstraction","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/api-abstraction/index.ts"},{"id":"3.6","name":"Order Management","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/order-management/index.ts"},{"id":"3.7","name":"Payment Processing","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/booking/src/payment-processing/index.ts"},{"id":"3.8","name":"PNR Retrieval","stage":"booking","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/booking/src/pnr-retrieval/index.ts"},{"id":"4.1","name":"Ticket Issuance","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/ticketing/src/ticket-issuance/index.ts"},{"id":"4.2","name":"EMD Management","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/emd-management/index.ts"},{"id":"4.3","name":"Void Agent","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/void-agent/index.ts"},{"id":"4.4","name":"Itinerary Delivery","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/itinerary-delivery/index.ts"},{"id":"4.5","name":"Document Verification","stage":"ticketing","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/ticketing/src/document-verification/index.ts"},{"id":"5.1","name":"Change Management","stage":"exchange","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/change-management/index.ts"},{"id":"5.2","name":"Exchange/Reissue","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/exchange-reissue/index.ts"},{"id":"5.3","name":"Involuntary Rebook","stage":"exchange","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/exchange/src/involuntary-rebook/index.ts"},{"id":"5.4","name":"Disruption Response","stage":"exchange","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/exchange/src/disruption-response/index.ts"},{"id":"5.5","name":"Self-Service Rebooking","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/exchange/src/self-service-rebooking/index.ts"},{"id":"5.6","name":"Waitlist Management","stage":"exchange","version":"0.2.0","contract_status":"active","has_contract":true,"source_path":"packages/agents/exchange/src/waitlist-management/index.ts"},{"id":"6.1","name":"Refund Processing","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/refund-processing/index.ts"},{"id":"6.2","name":"ADM Prevention","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/adm-prevention/index.ts"},{"id":"6.3","name":"ADM/ACM Processing","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/adm-acm-processing/index.ts"},{"id":"6.4","name":"Customer Communication","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/customer-communication/index.ts"},{"id":"6.5","name":"Feedback & Complaint","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/feedback-complaint/index.ts"},{"id":"6.6","name":"Loyalty Mileage","stage":"settlement","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/settlement/src/loyalty-mileage/index.ts"},{"id":"7.1","name":"BSP Reconciliation","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/bsp-reconciliation/index.ts"},{"id":"7.2","name":"ARC Reconciliation","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/arc-reconciliation/index.ts"},{"id":"7.3","name":"Commission Management","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/commission-management/index.ts"},{"id":"7.4","name":"Interline Settlement","stage":"reconciliation","version":"0.0.0","contract_status":"stub","has_contract":false,"source_path":"packages/agents/reconciliation/src/interline-settlement/index.ts"},{"id":"7.5","name":"Financial Reporting","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/financial-reporting/index.ts"},{"id":"7.6","name":"Revenue Accounting","stage":"reconciliation","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/reconciliation/src/revenue-accounting/index.ts"},{"id":"8.1","name":"Traveler Profile","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/traveler-profile/index.ts"},{"id":"8.2","name":"Corporate Account","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/corporate-account/index.ts"},{"id":"8.3","name":"Mid-Office Automation","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/mid-office/index.ts"},{"id":"8.4","name":"Reporting & Analytics","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/reporting/index.ts"},{"id":"8.5","name":"Duty of Care","stage":"tmc","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-tmc/src/duty-of-care/index.ts"},{"id":"9.1","name":"Orchestrator","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/orchestrator/index.ts"},{"id":"9.2","name":"Knowledge Retrieval","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/knowledge/index.ts"},{"id":"9.3","name":"Monitoring & Alerting","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/monitoring/index.ts"},{"id":"9.4","name":"Audit & Compliance","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/audit/index.ts"},{"id":"9.5","name":"Plugin Manager","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents-platform/src/plugin-manager/index.ts"},{"id":"9.6","name":"Performance Audit","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/performance-audit/index.ts"},{"id":"9.7","name":"Routing Audit","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/routing-audit/index.ts"},{"id":"9.8","name":"Recommendation","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/recommendation/index.ts"},{"id":"9.9","name":"Alert","stage":"platform","version":"0.1.0","contract_status":"active","has_contract":true,"source_path":"packages/agents-platform/src/alert/index.ts"},{"id":"20.1","name":"Hotel Search Aggregator","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-search/index.ts"},{"id":"20.2","name":"Property Deduplication","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/property-dedup/index.ts"},{"id":"20.3","name":"Hotel Content Normalization","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/content-normalization/index.ts"},{"id":"20.4","name":"Hotel Rate Comparison","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/rate-comparison/index.ts"},{"id":"20.5","name":"Hotel Booking","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-booking/index.ts"},{"id":"20.6","name":"Hotel Modification & Cancellation","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/hotel-modification/index.ts"},{"id":"20.7","name":"Confirmation Verification","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/confirmation-verification/index.ts"},{"id":"20.8","name":"Activity Search","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/activity-search/index.ts"},{"id":"20.9","name":"Transfer Search","stage":"lodging","version":"0.1.0","contract_status":"active","has_contract":false,"source_path":"packages/agents/lodging/src/transfer-search/index.ts"}],"edges":[{"source":"1.1","target":"1.4","kind":"workflow","label":"search_to_price"},{"source":"1.4","target":"2.1","kind":"workflow","label":"search_to_price"},{"source":"2.1","target":"2.2","kind":"workflow","label":"search_to_price"},{"source":"2.2","target":"2.3","kind":"workflow","label":"search_to_price"},{"source":"3.3","target":"3.1","kind":"workflow","label":"book_to_ticket"},{"source":"3.1","target":"3.2","kind":"workflow","label":"book_to_ticket"},{"source":"3.2","target":"4.1","kind":"workflow","label":"book_to_ticket"},{"source":"1.1","target":"1.4","kind":"workflow","label":"full_booking"},{"source":"1.4","target":"2.1","kind":"workflow","label":"full_booking"},{"source":"2.1","target":"2.2","kind":"workflow","label":"full_booking"},{"source":"2.2","target":"2.3","kind":"workflow","label":"full_booking"},{"source":"2.3","target":"3.3","kind":"workflow","label":"full_booking"},{"source":"3.3","target":"3.1","kind":"workflow","label":"full_booking"},{"source":"3.1","target":"3.2","kind":"workflow","label":"full_booking"},{"source":"3.2","target":"4.1","kind":"workflow","label":"full_booking"},{"source":"5.1","target":"5.2","kind":"workflow","label":"exchange_flow"},{"source":"6.1","target":"6.2","kind":"workflow","label":"refund_flow"},{"source":"1.1","target":"0.1","kind":"package","label":"@otaip/agents-search → @otaip/agents-reference"},{"source":"2.1","target":"0.1","kind":"package","label":"@otaip/agents-pricing → @otaip/agents-reference"},{"source":"3.1","target":"0.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-reference"},{"source":"3.1","target":"1.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-search"},{"source":"3.1","target":"2.1","kind":"package","label":"@otaip/agents-booking → @otaip/agents-pricing"},{"source":"4.1","target":"3.1","kind":"package","label":"@otaip/agents-ticketing → @otaip/agents-booking"},{"source":"5.1","target":"1.1","kind":"package","label":"@otaip/agents-exchange → @otaip/agents-search"},{"source":"5.1","target":"4.1","kind":"package","label":"@otaip/agents-exchange → @otaip/agents-ticketing"},{"source":"6.1","target":"4.1","kind":"package","label":"@otaip/agents-settlement → @otaip/agents-ticketing"},{"source":"7.1","target":"0.1","kind":"package","label":"@otaip/agents-reconciliation → @otaip/agents-reference"}],"package_deps":[{"from_package":"@otaip/agents-search","to_package":"@otaip/agents-reference","from_stage":"search","to_stage":"reference"},{"from_package":"@otaip/agents-pricing","to_package":"@otaip/agents-reference","from_stage":"pricing","to_stage":"reference"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-reference","from_stage":"booking","to_stage":"reference"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-search","from_stage":"booking","to_stage":"search"},{"from_package":"@otaip/agents-booking","to_package":"@otaip/agents-pricing","from_stage":"booking","to_stage":"pricing"},{"from_package":"@otaip/agents-ticketing","to_package":"@otaip/agents-booking","from_stage":"ticketing","to_stage":"booking"},{"from_package":"@otaip/agents-exchange","to_package":"@otaip/agents-search","from_stage":"exchange","to_stage":"search"},{"from_package":"@otaip/agents-exchange","to_package":"@otaip/agents-ticketing","from_stage":"exchange","to_stage":"ticketing"},{"from_package":"@otaip/agents-settlement","to_package":"@otaip/agents-ticketing","from_stage":"settlement","to_stage":"ticketing"},{"from_package":"@otaip/agents-reconciliation","to_package":"@otaip/agents-reference","from_stage":"reconciliation","to_stage":"reference"}]},"docs":{"0.1":{"id":"0.1","summary":"Resolves IATA/ICAO airport and city codes to canonical airport records with multi-airport city awareness and historical code handling","className":"AirportCodeResolver","input":"`code` -- IATA 3-letter, ICAO 4-letter, city code, or airport name\n`code_type?` -- `'iata' | 'icao' | 'city' | 'name' | 'auto'` (auto-detected if omitted)\n`include_metro?` -- return all airports in a metro/city code (default: true)\n`include_decommissioned?` -- resolve retired/reassigned codes (default: false)","output":"`resolved_airport` -- canonical airport record (IATA, ICAO, name, city, country, timezone, lat/lon, type, status)\n`metro_airports` -- list of airports in the same metro area\n`match_confidence` -- 0-1 confidence score\n`stale_data?` -- true when dataset is older than 30 days\n`suggestion?` -- fuzzy match suggestion when code not found","usage":"const agent = new AirportCodeResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'JFK', code_type: 'iata' } });\n// result.data.resolved_airport.name => \"John F Kennedy International Airport\"","status":"Implemented","purpose":"Resolves IATA/ICAO airport and city codes to canonical airport records with multi-airport city awareness, fuzzy name matching, and historical code handling."},"0.2":{"id":"0.2","summary":"Resolves IATA/ICAO airline designator codes to canonical airline records with alliance membership mapping and codeshare partner networks","className":"AirlineCodeMapper","input":"`code` -- IATA 2-letter, ICAO 3-letter, or airline name\n`code_type?` -- `'iata' | 'icao' | 'name' | 'auto'`\n`include_codeshares?` -- include codeshare partners (default: false)\n`include_defunct?` -- include ceased-operations airlines (default: false)","output":"`airline` -- canonical airline record (codes, name, callsign, country, alliance, hubs, status)\n`codeshare_partners` -- partner airline list with relationship type\n`match_confidence` -- 0-1 confidence score","usage":"const agent = new AirlineCodeMapper();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'UA', include_codeshares: true } });\n// result.data.airline.name => \"United Airlines\"","status":"Implemented"},"0.3":{"id":"0.3","summary":"Decodes ATPCO-standard fare basis codes into human-readable components including cabin class, fare restrictions, advance purchase requirements, and penalty information","className":"FareBasisDecoder","input":"`fare_basis` -- ATPCO fare basis code (max 15 chars, e.g., `\"YOW3M1\"`, `\"TLXP14NR\"`)\n`carrier?` -- IATA airline code for carrier-specific decoding","output":"`decoded` -- parsed components (primary code, cabin class, fare type, season, day-of-week, advance purchase, min/max stay, penalties, ticket designator)\n`match_confidence` -- 1.0 = fully decoded, 0.5-0.9 = partial\n`unparsed_segments` -- parts that could not be decoded","usage":"const agent = new FareBasisDecoder();\nawait agent.initialize();\nconst result = await agent.execute({ data: { fare_basis: 'Y26NR' } });\n// result.data.decoded.cabin_class => \"economy\"","status":"Implemented"},"0.4":{"id":"0.4","summary":"Maps single-letter booking class codes to cabin class, fare family, upgrade eligibility, and loyalty program earning rates","className":"ClassOfServiceMapper","input":"`booking_class` -- single letter A-Z\n`carrier` -- IATA 2-letter airline code (required -- meanings are carrier-specific)\n`include_loyalty?` -- include loyalty earning rates (default: false)","output":"`mapping` -- cabin class, brand name, fare family, upgrade eligibility/type, same-day change, seat selection, refundable, priority level, loyalty earning\n`match_confidence` -- 1.0 = carrier-specific, 0.7 = IATA default, 0 = unknown","usage":"const agent = new ClassOfServiceMapper();\nawait agent.initialize();\nconst result = await agent.execute({ data: { booking_class: 'J', carrier: 'UA', include_loyalty: true } });\n// result.data.mapping.cabin_class => \"business\"","status":"Implemented","purpose":"Maps single-letter booking class codes to cabin class, fare family, upgrade eligibility, and loyalty program earning rates. Booking classes are carrier-specific."},"0.5":{"id":"0.5","summary":"Resolves IATA aircraft equipment codes to structured equipment data","className":"EquipmentTypeResolver","input":"`operation` -- `'resolve' | 'getSeatingConfig' | 'isWidebody' | 'getSimilarTypes'`\n`code` -- IATA equipment code (e.g., `\"789\"`, `\"320\"`)\n`cabin?` -- cabin code (`'F' | 'C' | 'W' | 'Y'`) for `getSeatingConfig`","output":"`equipment?` -- full equipment info (IATA/ICAO codes, manufacturer, family, body type, seats, range)\n`seatCount?` -- seat count for specific cabin\n`isWidebody?` -- boolean\n`similarTypes?` -- IATA codes of similar aircraft","usage":"const agent = new EquipmentTypeResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { operation: 'resolve', code: '789' } });\n// result.data.equipment.manufacturer => \"Boeing\"","status":"Implemented","purpose":"Resolves IATA aircraft equipment codes to structured equipment data including manufacturer, body type, typical seating, range, and max capacity."},"0.6":{"id":"0.6","summary":"Resolves ISO 4217 currency codes and IATA tax/surcharge codes used in airline pricing and ticketing","className":"CurrencyTaxResolver","input":"`code` -- ISO currency code or IATA tax code\n`code_type?` -- `'currency' | 'tax' | 'auto'`\n`country?` -- ISO 2-letter country code to filter tax applicability","output":"`currency` -- currency details (code, name, symbol, minor units, countries, active status)\n`tax` -- tax details (code, name, description, category, country, applies-to, percentage flag)\n`match_confidence` -- 0-1 confidence score","usage":"const agent = new CurrencyTaxResolver();\nawait agent.initialize();\nconst result = await agent.execute({ data: { code: 'USD' } });\n// result.data.currency.name => \"US Dollar\"","status":"Implemented"},"0.7":{"id":"0.7","summary":"APIS requirements, visa requirements, restriction levels. Static dataset -- must NOT be used as legal travel advice","className":"CountryRegulatoryResolver","input":"`operation` -- `'getAPISRequirements' | 'getVisaRequirement' | 'getRestrictionLevel'`\n`countryCode?` -- ISO 2-letter (for APIS and restriction)\n`nationalityCode?` -- ISO 2-letter (for visa)\n`destinationCode?` -- ISO 2-letter (for visa)","output":"`apis?` -- APIS requirements (required fields, advance submission hours)\n`visa?` -- visa requirement (type, max stay days)\n`restriction?` -- restriction level 1-4 with summary","usage":"const agent = new CountryRegulatoryResolver();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { operation: 'getVisaRequirement', nationalityCode: 'US', destinationCode: 'GB' }\n});\n// result.data.visa.requirement => \"visa_free\"","status":"Implemented"},"1.1":{"id":"1.1","summary":"Queries distribution adapters in parallel, normalizes, deduplicates, filters, and sorts flight availability offers","className":"AvailabilitySearch","input":"`origin` -- origin airport/city IATA code\n`destination` -- destination airport/city IATA code\n`departure_date` -- ISO 8601 date\n`return_date?` -- ISO 8601 date for round-trip\n`passengers` -- `PassengerCount[]`\n`cabin_class?` -- `'economy' | 'premium_economy' | 'business' | 'first'`\n`direct_only?` -- only direct flights\n`max_connections?` -- 0-5\n`currency?` -- ISO 4217\n`max_results?` -- 1-200\n`sort_by?` -- `'price' | 'duration' | 'departure' | 'arrival' | 'connections'`\n`sort_order?` -- `'asc' | 'desc'`\n`sources?` -- specific adapter names to query","output":"`offers` -- deduplicated, filtered, sorted `SearchOffer[]`\n`total_raw_offers` -- count before deduplication\n`source_status` -- per-adapter query status (success, count, error, response time)\n`truncated` -- whether results were capped","usage":"new AvailabilitySearch(adapters: DistributionAdapter[]) Then call initialize() and execute({ data }).","status":"Implemented"},"1.2":{"id":"1.2","summary":"Looks up flight schedules with SSIM operating day parsing, codeshare detection, and connection discovery","className":"ScheduleLookup","input":"`origin` -- airport IATA code\n`destination` -- airport IATA code\n`date` -- ISO 8601 date\n`carrier?` -- filter by carrier IATA code\n`flight_number?` -- specific flight (requires carrier)\n`include_codeshares?` -- default: true\n`include_connections?` -- discover connecting options (default: false)","output":"`flights` -- `ScheduledFlight[]` (carrier, flight number, times, duration, schedule, codeshare info)\n`connections` -- `ConnectionOption[]` (two-leg connections with timing)\n`operates_on_date` -- whether any flights operate on the requested date","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.3":{"id":"1.3","summary":"Validates connections against MCT rules, scores connection quality, and checks interline agreements","className":"ConnectionBuilder","input":"`arriving_segment` -- `FlightSegment` (from `@otaip/core`)\n`departing_segment` -- `FlightSegment`\n`connection_airport` -- IATA 3-letter code\n`has_checked_bags?` -- affects MCT\n`is_interline?` -- different carriers","output":"`validation` -- MCT check result (valid, available/required minutes or null when unavailable, buffer, applied rule)\n`quality` -- connection quality score 0-1 with factor breakdown\n`interline` -- interline agreement check (if different carriers)\n`warnings` -- connection warnings","status":"Implemented","purpose":"Validates connections against MCT (Minimum Connecting Time) rules, scores connection quality, and checks interline agreements.\n\nMCT authority: **IATA SSIM Chapter 8** + **PSC Resolution 765** (`docs/knowledge-base/mct.md`). Curated rows live under `data/reference/mct/`. Resolution hierarchy: carrier override → airport+terminal → airport → **fail-closed** (no invented global/airport-constant table).","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.4":{"id":"1.4","summary":"Multi-source fare comparison with fare basis decoding, class mapping, branded fare family grouping, and passenger type pricing","className":"FareShopping","input":"`origin`, `destination`, `departure_date`, `passengers` -- same as availability search\n`cabin_class?`, `currency?`, `sources?` -- filters\n`decode_fare_basis?` -- decode fare basis codes (default: true)\n`group_by_fare_family?` -- group by basic/standard/flex/premium (default: true)","output":"`fares` -- `FareOffer[]` sorted by price, each with decoded fare basis, class info, fare family, passenger pricing\n`fare_families` -- grouped by family with cheapest/most expensive\n`total_fares` -- count\n`sources_queried` -- adapter names","usage":"new FareShopping(adapters: DistributionAdapter[]) Then call initialize() and execute({ data }).","status":"Implemented"},"1.5":{"id":"1.5","summary":"Searches ancillary offers (seats, bags, meals) across distribution adapters","className":"AncillaryShoppingAgent","input":"`segments` -- flight segments (origin, destination, flight number, date, carrier)\n`passengers` -- passenger references with type (ADT/CHD/INF)\n`pnrRef?` -- PNR reference\n`requestedCategories?` -- filter by category (BAGGAGE, SEAT, MEAL, etc.)","output":"`ancillaries` -- `AncillaryOffer[]` with RFIC/RFISC codes, pricing, availability\n`notSupportedByAdapter` -- true if no adapter configured\n`currency` -- pricing currency","status":"Implemented","purpose":"Searches for available ancillaries (baggage, seats, meals, lounge, Wi-Fi, priority) via an injectable adapter.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.6":{"id":"1.6","summary":"Deduplicates and normalizes flight results from multiple adapter sources","className":"MultiSourceAggregatorAgent","input":"`results` -- `AdapterSearchResult[]` (adapter name, flights, errors, response time)\n`deduplicationStrategy` -- `'keep_cheapest' | 'keep_all' | 'keep_first'`\n`rankBy` -- `'price' | 'duration' | 'stops'`\n`maxResults?` -- limit output count","output":"`flights` -- `NormalizedFlight[]` with sources, lowest price, all prices across adapters\n`totalRaw` -- raw count before dedup\n`totalAfterDedup` -- final count\n`adapterSummary` -- per-adapter stats","status":"Implemented","purpose":"Aggregates search results from multiple adapters with deduplication, price comparison, and ranking.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.7":{"id":"1.7","summary":"Stub agent for hotel and car rental search via distribution adapters","className":"HotelCarSearchAgent","input":"`operation` -- `'searchHotels' | 'searchCars'`\n`hotel?` -- hotel search params (destination, dates, rooms, adults, star rating, max rate)\n`car?` -- car search params (pickup/dropoff location and times, category, driver age)","output":"`hotelResults?` -- hotel offers with rate, room type, cancellation policy\n`carResults?` -- car offers with category, supplier, daily/total rate, features","status":"Implemented (adapter-dependent)","purpose":"Car rental search (and, pending a deferred car-only migration, hotel) via pluggable adapters. Returns empty results when no adapters configured.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"1.8":{"id":"1.8","summary":"Natural language travel query understanding with injectable LLM provider; parses user queries into structured search parameters","className":"AITravelAdvisorAgent","input":"`query` -- natural language travel query\n`travelerContext?` -- preferences (cabin, budget, preferred airlines, passenger counts)","output":"`searchParameters` -- extracted origin, destination, dates, trip type, cabin, passengers, flexible dates\n`summary` -- natural language summary of interpreted query\n`intent` -- `'flight_search' | 'hotel_search' | 'destination_recommendation' | 'price_check' | 'trip_planning' | 'unknown'`","usage":"new AITravelAdvisorAgent({ llmProvider, maxTokens?, temperature? }) Then call initialize() and execute({ data }).","status":"Implemented"},"1.9":{"id":"1.9","summary":"Stateless, deterministic scoring engine for flight offers with multi-dimensional scoring, hard filtering, and full audit trail (lives in @otaip/core)","className":"OfferEvaluatorAgent","input":"`offers` -- `EvaluatorOffer[]` with price, itinerary (segments, duration, connections)\n`constraints?` -- latest arrival, prefer direct, max connections, price ceiling, preferred/blacklisted carriers\n`profile?` -- `'BUSINESS_TIME_CRITICAL' | 'BUSINESS_PRICE_CONSTRAINED' | 'LEISURE' | 'CORPORATE_POLICY' | 'CUSTOM'`\n`weights?` -- custom scoring weights (time_buffer, price, connection_quality, journey_duration)","output":"Scored and ranked offers with structured explanation for LLM translation","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.1":{"id":"2.1","summary":"Parses ATPCO fare rules (categories 1-20) into human-readable structured format using curated tariff snapshot data","className":"FareRuleAgent","input":"`fare_basis` -- fare basis code\n`carrier` -- marketing carrier IATA code\n`origin` -- origin IATA code\n`destination` -- destination IATA code\n`travel_date?` -- ISO date for date-based rule filtering\n`categories?` -- specific ATPCO categories 1-50 (all if omitted)","output":"`rules` -- `FareRuleResult[]` with parsed categories, penalty summary, advance purchase, min/max stay, seasonality\n`total_rules` -- count of matched rules\n`valid_for_date` -- whether fare is valid for the specified travel date\n`in_blackout` -- whether travel date falls in a blackout period","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.2":{"id":"2.2","summary":"NUC x ROE fare construction with mileage validation, HIP/BHC/CTM checks, surcharges, and IATA rounding. All financial math uses decimal.js","className":"FareConstruction","input":"`journey_type` -- `'OW' | 'RT' | 'CT'` (one-way, round-trip, circle-trip)\n`components` -- fare components (origin, destination, carrier, fare basis, NUC amount)\n`selling_currency` -- ISO 4217 currency\n`point_of_sale?` -- country for IROE selection context\n`data_sources?` -- licensed `{ iroe, rounding_024d, mileage }` (required for a constructed fare)","output":"Success (`FareConstructionOutput`): `total_nuc`, `iroe` (alias `roe`), `local_amount` after 024d, `rounding_method` (`HX`|`NX`), published `mileage_checks`, HIP/BHC/CTM sketches, `audit_trail`\nOr `DomainInputRequired` when licensed data is missing","status":"Implemented","purpose":"NUC × IROE construction with published TPM/MPM, Resolution **024d** (HX/NX) rounding, and fail-closed HIP/BHC/CTM hooks. All financial math uses `decimal.js`.\n\nLicensed IROE / 024d / TPM-MPM data are **not** shipped in the package. Pass them via `data_sources`. Missing IROE, TPM, or 024d → `DomainInputRequired`. Haversine-as-TPM and banker's rounding are banned.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.3":{"id":"2.3","summary":"Per-segment tax computation with exemption engine, ~30 countries, ~50 tax codes, currency conversion. All financial math uses decimal.js","className":"TaxCalculation","input":"`segments` -- itinerary segments (origin/destination airports and countries, carrier, cabin class, base fare NUC)\n`passenger_type` -- `'adult' | 'child' | 'infant' | 'crew' | 'diplomatic'`\n`is_transit` -- whether transit/connection (\u003c 24h same ticket)\n`is_involuntary` -- whether involuntary reroute\n`total_base_fare_nuc` -- total base fare for percentage-based taxes\n`selling_currency` -- ISO 4217","output":"`taxes` -- `AppliedTax[]` (code, name, country, type, amounts, segment indices, interlineable, exempt status)\n`total_tax` -- total in selling currency\n`breakdown` -- by country, interlineable/non-interlineable totals\n`exemptions_applied` -- list of exemption reasons\n`segments_processed` -- count","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.4":{"id":"2.4","summary":"Builds priced offers with TTL management and optional persistence adapter","className":"OfferBuilderAgent","input":"`operation` -- `'buildOffer' | 'getOffer' | 'validateOffer' | 'markUsed' | 'expireOffer' | 'cleanExpired'`\n`buildInput?` -- segments, fare, taxes, ancillaries, passenger count, pricing source, TTL\n`offerId?` -- for get/validate/mark/expire operations\n`currentTime?` -- ISO timestamp override","output":"`offer?` -- full offer record with pricing breakdown, TTL, status\n`valid?` -- offer validity result\n`reason?` -- validation failure reason\n`cleanedCount?` -- number of expired offers cleaned","usage":"new OfferBuilderAgent({ persistence?: PersistenceAdapter }) Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Builds, caches, validates, and manages pricing offers with TTL expiration. Supports in-memory or pluggable persistence."},"2.5":{"id":"2.5","summary":"Validates flight offers against corporate travel policies (cabin, budget, advance purchase)","className":"CorporatePolicyValidationAgent","input":"`offer` -- offer details (cabin, fare amount, carrier, fare basis, advance booking days, segments)\n`policy` -- corporate policy (cabin rules, fare rules, booking rules, bypass codes)\n`bypassCode?` -- authorization code to bypass soft violations","output":"`result` -- `'APPROVED' | 'SOFT_VIOLATION' | 'HARD_VIOLATION'`\n`violations` -- `PolicyViolation[]` with rule, severity, detail\n`bypassApplied` -- whether bypass was used","status":"Implemented","purpose":"Validates flight offers against corporate travel policies: cabin class limits, fare ceilings, blocked carriers, advance booking requirements. Supports bypass codes.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"2.6":{"id":"2.6","summary":"Placeholder -- not yet implemented. Requires revenue management integration","className":"DynamicPricingAgent","status":"Coming Soon (stub)","purpose":"Revenue management integration for dynamic fare adjustments. Requires revenue management integration before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"2.7":{"id":"2.7","summary":"Placeholder -- not yet implemented. Requires revenue management integration","className":"RevenueManagementAgent","status":"Coming Soon (stub)","purpose":"Revenue management system integration. Requires revenue management domain input before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"3.1":{"id":"3.1","summary":"Routes booking requests to the correct distribution channel based on carrier config, codeshare rules, and NDC capability","className":"GdsNdcRouter","input":"`segments` -- routing segments (marketing/operating carrier, origin, destination, flight number)\n`preferred_channel?` -- `'GDS' | 'NDC' | 'DIRECT'`\n`preferred_gds?` -- `'AMADEUS' | 'SABRE' | 'TRAVELPORT'`\n`include_fallbacks` -- whether to include fallback channels","output":"`routings` -- per-segment channel routing (primary channel, GDS system, NDC version, fallbacks, booking format)\n`unified_channel` -- whether all segments can use the same channel\n`recommended_channel` -- best channel for entire itinerary\n`gds_format` / `ndc_format` -- format translation stubs","status":"Implemented","purpose":"Routes booking requests to the correct distribution channel (GDS, NDC, or direct API) based on carrier config, codeshare rules, and NDC capability. Per-segment routing with fallback support.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.2":{"id":"3.2","summary":"Constructs GDS-ready PNR commands from normalized booking data. Supports Amadeus, Sabre, and Travelport syntax","className":"PnrBuilder","input":"`gds` -- `'AMADEUS' | 'SABRE' | 'TRAVELPORT'`\n`passengers` -- name, type, DOB, passport, gender, nationality, FOID\n`segments` -- carrier, flight, class, date, origin, destination, status\n`contacts` -- phone, email, type\n`ticketing` -- time limit, type\n`received_from` -- agent identifier\n`ssrs?` -- SSR elements (WCHR, VGML, DOCS, FOID, CTCE, CTCM, INFT)\n`osis?` -- OSI elements\n`is_group?` / `group_name?` -- group PNR support","output":"`gds` -- target GDS\n`commands` -- ordered `PnrCommand[]` with GDS command strings and descriptions\n`passenger_count`, `segment_count`, `is_group`, `infant_count`","status":"Implemented","purpose":"Constructs GDS-ready PNR commands from normalized booking data. Supports Amadeus, Sabre, and Travelport syntax including names, segments, contacts, ticketing, SSR/OSI elements, and group bookings.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.3":{"id":"3.3","summary":"Pre-ticketing validation -- 13 checks to catch errors before ADMs","className":"PnrValidation","input":"`record_locator` -- 6-char PNR\n`passengers` -- passenger data (name, type, DOB, nationality, passport)\n`segments` -- segment data (carrier, flight, status, class, international flag, married group)\n`contact?` -- phone/email\n`ticketing?` -- time limit, arranged status\n`fare?` -- fare data with advance purchase deadline\n`validation_date?` -- ISO date override","output":"`record_locator` -- PNR\n`checks` -- `ValidationCheck[]` (13 checks, each with pass/fail, severity, message)\n`valid` -- overall pass/fail\n`error_count`, `warning_count`","status":"Implemented","purpose":"Pre-ticketing validation with 13 checks to catch errors before ADMs: segment status, passenger data, APIS, ticketing deadline, fare consistency, and more.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.4":{"id":"3.4","summary":"GDS queue monitoring and processing -- priority assignment, categorization, action routing, and queue command generation","className":"QueueManagement","input":"`entries` -- queue items (record locator, GDS, queue number, entry type, deadline, remark)\n`current_time?` -- ISO timestamp for priority calculation\n`gds?` -- GDS system for command generation\n`queue_number?` -- queue to generate read commands for\n`travelport_host?` -- `'APOLLO' | 'GALILEO' | 'WORLDSPAN'` when `gds` is `TRAVELPORT`","output":"`results` -- processed items with priority, status, recommended action, target agent\n`commands?` -- GDS queue commands\n`summary` -- counts by priority (urgent/high/normal/low)","status":"Implemented","purpose":"GDS queue monitoring and processing: priority assignment, categorization, action routing, and queue command generation.\n\nTravelport place/list/remove commands are **per host** (Apollo / Galileo≡Travelport+ / Worldspan) from the public format-compare table — see `docs/knowledge-base/tmc-mid-office-ttl-queues.md`. TTL priority uses Zulu deadline-day urgency.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.5":{"id":"3.5","summary":"Universal HTTP client with circuit breaker, retry logic, timeout handling, rate limiting, and IATA error normalization","className":"ApiAbstraction","input":"`request` -- API request (provider ID, HTTP method, path, headers, body)\n`max_retries?` -- override retry count\n`timeout_ms?` -- override timeout\n`force?` -- skip circuit breaker check","output":"`response` -- API response (status, headers, body, duration, retries)\n`error` -- normalized error (category, original code, retryable flag)\n`circuit_breaker` -- circuit breaker status\n`rate_limit` -- rate limit status\n`success` -- boolean","usage":"new ApiAbstraction(handler?: RequestHandler) Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Universal HTTP client with circuit breaker, retry logic, timeout handling, rate limiting, and IATA error normalization for GDS/NDC/payment providers."},"3.6":{"id":"3.6","summary":"Travel order lifecycle management -- create, modify, cancel, retrieve, and list orders with status tracking and transition validation","className":"OrderManagement","input":"`operation` -- `'createOrder' | 'modifyOrder' | 'cancelOrder' | 'getOrder' | 'listOrders'`\n`createOrder?` -- passenger, items, currency, source\n`modifyOrder?` -- order ID, updated items/details, reason\n`cancelOrder?` -- order ID, reason\n`getOrder?` / `listOrders?` -- retrieval/filtering","output":"`order?` -- order record with status, items, history\n`orders?` -- list of orders\n`operation`, `success`, `errorCode?`, `errorMessage?`","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.7":{"id":"3.7","summary":"PCI-safe payment instruction builder and transaction recorder. Validates forms of payment, builds GDS FOP strings -- never handles raw card numbers","className":"PaymentProcessing","input":"`operation` -- `'validateFOP' | 'buildPaymentInstruction' | 'recordPayment' | 'getPaymentRecord' | 'buildGDSFOPString'`\nOperation-specific data: FOP details (CC_TOKEN, BSP_CASH, AIRLINE_CREDIT, VOUCHER, UATP), amounts, references","output":"`validation?` -- FOP validation result\n`instruction?` -- payment instruction with GDS string, PCI-safe flag\n`record?` -- payment transaction record\n`gdsString?` -- GDS FOP string","status":"Implemented","purpose":"PCI-safe payment instruction builder and transaction recorder. Validates forms of payment, builds GDS FOP strings, records transactions. Never handles raw card numbers.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"3.8":{"id":"3.8","summary":"Retrieves an existing PNR/booking by record locator across distribution adapters. Read-only -- no side effects","className":"PnrRetrieval","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"4.1":{"id":"4.1","summary":"ETR generation with conjunction ticket support, BSP reporting, and commission handling","className":"TicketIssuance","input":"`record_locator` -- 6-char PNR\n`issuing_carrier` -- 2-letter IATA code\n`passenger_name` -- LAST/FIRST format\n`segments` -- flight segments with carrier, flight number, class, fare basis, dates, baggage\n`base_fare`, `base_fare_currency` -- fare amount\n`equivalent_fare?`, `equivalent_fare_currency?` -- currency conversion\n`taxes` -- tax breakdown items\n`fare_calculation` -- fare calculation line\n`form_of_payment` -- CASH, CREDIT_CARD, INVOICE, MISCELLANEOUS\n`endorsements?`, `commission?`, `bsp_reporting?`, `original_issue?`","output":"`tickets` -- `TicketRecord[]` (13-digit number, coupons with status, fare/tax breakdown, FOP, commission, BSP fields)\n`total_coupons` -- total across all tickets\n`is_conjunction` -- whether conjunction tickets were generated","status":"Implemented","purpose":"ETR (Electronic Ticket Record) generation with conjunction ticket support (auto-split for >4 coupons), BSP reporting fields, and commission handling.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.2":{"id":"4.2","summary":"EMD-A (associated) and EMD-S (standalone) issuance, RFIC/RFISC handling, coupon lifecycle","className":"EmdManagement","input":"`emd_type` -- `'EMD-A' | 'EMD-S'`\n`record_locator`, `issuing_carrier`, `passenger_name`\n`services` -- array of services with RFIC code (A-G), RFISC, description, amount, associated ticket/coupon for EMD-A\n`related_ticket_number?` -- for EMD-A","output":"`emd` -- `EmdRecord` (13-digit EMD number, coupons, amounts)\n`coupon_count`","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.3":{"id":"4.3","summary":"Ticket/EMD void processing -- coupon status check, carrier void window, BSP/ARC cut-off validation","className":"VoidAgent","input":"`document_number` -- 13-digit ticket/EMD number\n`issuing_carrier` -- 2-letter IATA code\n`coupons` -- coupon numbers and current statuses\n`issue_datetime` -- ISO datetime of issuance\n`current_datetime?` -- ISO datetime for void window check\n`settlement_system?` -- `'BSP' | 'ARC'`\n`bsp_cutoff_time?` -- HH:MM format","output":"`result` -- void permitted flag, rejection reason, message, void window hours, hours remaining, updated coupon statuses","status":"Implemented","purpose":"Ticket/EMD void processing with coupon status validation, carrier-specific void window enforcement, and BSP/ARC cut-off time checking.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.4":{"id":"4.4","summary":"Multi-channel itinerary rendering: Email (HTML+plain), SMS, WhatsApp. Carrier-neutral templates","className":"ItineraryDelivery","input":"`record_locator` -- booking reference\n`passengers` -- name, ticket number, frequent flyer\n`flights` -- flight details (number, origin, destination, times, cabin, seat, aircraft)\n`total_fare?`, `fare_currency?`\n`contact` -- email, phone, WhatsApp number\n`channels` -- `('EMAIL' | 'SMS' | 'WHATSAPP')[]`\n`agency_name?` -- for itinerary header","output":"`rendered` -- per-channel content (HTML/plain text, subject, SMS segment count)\n`channels_rendered` -- successfully rendered channels","status":"Implemented","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"4.5":{"id":"4.5","summary":"APIS validation, passport validity, visa check (stub for Agent 0.7)","className":"DocumentVerification","input":"`passengers` -- ticket name, passport name, passport number/expiry/nationality, DOB, gender\n`segments` -- destination country and travel date\n`passport_validity_months?` -- minimum validity beyond travel date (default: 6)\n`validation_date?` -- ISO date override","output":"`results` -- per-passenger verification (pass/fail, individual checks with severity)\n`all_passed` -- overall pass/fail\n`blocking_failures`, `advisory_warnings` -- counts","status":"Implemented","purpose":"APIS validation, passport validity checking (configurable months threshold), and name matching between ticket and passport.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.1":{"id":"5.1","summary":"ATPCO Category 31 voluntary change assessment: change fees, fare difference, residual value, waiver codes","className":"ChangeManagement","input":"`original_ticket` -- ticket number, issuing carrier, passenger name, record locator, issue date, base fare, total tax, fare basis, refundable flag, booking date, `original_departure_date?` (for DOT 7-day check)\n`requested_itinerary` -- new segments (carrier, flight, origin, destination, date, class, fare basis), new fare, new taxes\n`waiver_code?` -- airline-provided waiver identity (not skip-penalty by itself)\n`waiver_effect?` -- required when `waiver_code` set: `ELIMINATE_PENALTY | REDUCE_PENALTY | CHANGE_REFUND_FORM | CHANGE_REBOOKING_CLASS | IRROP_INVOLUNTARY` (see `docs/knowledge-base/waiver-typology.md`)\n`waiver_penalty_reduction?` -- required for `REDUCE_PENALTY`\n`permitted_booking_classes?` / `permitted_fare_basis_patterns?` -- required for `CHANGE_REBOOKING_CLASS`\n`current_datetime?` -- ISO datetime\n`cat31_rules?` -- filed Cat 31 rules (omit → ATPCO default no charge)\n`us_dot_24h?` -- `part_259_applicable?`, `booking_channel?` (`airline_direct` | `agency` | `ndc` | `gds` | `unknown`)","output":"`assessment` -- action (`REISSUE | REBOOK | REJECT`), change fee, fare difference, additional collection, residual value, forfeited amount, tax difference, total due, Cat 31 `is_free_change` flag, summary\n`us_dot_24h` -- carrier remedy (`cancel` | `hold` | `unknown`), eligibility, ineligibility reasons (including `departure_within_7_days`, `channel_coverage_unknown`), entitlement (`penalty_free_cancel` | `unpaid_fare_hold` | `none` | `unknown`). **Not** a free-change boolean. Channel coverage follows carrier disclosure — not a baked-in “third-party never qualifies” rule.","status":"Implemented","purpose":"ATPCO Category 31 voluntary change assessment: change fees, fare difference, residual value, waiver codes, Cat 31 free-change window detection, and US DOT 14 CFR §259.5(b)(4) 24-hour reservation assessment (hold **or** cancel — carrier chooses; ≥7 days before departure). See `docs/knowledge-base/us-dot-24-hour-reservation.md`.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.2":{"id":"5.2","summary":"Ticket reissue with residual value, per-tax TFC carryforward (CARRY\\","className":"ExchangeReissue","input":"`original_ticket_number`, `conjunction_originals?`, `original_issue_date`\n`issuing_carrier`, `passenger_name`, `record_locator`\n`original_base_fare`, `original_taxes` -- from original ticket\n`change_fee`, `residual_value`, `waiver_code?` -- from Agent 5.1\n`new_segments` -- new flight segments\n`new_fare`, `new_fare_currency`, `new_taxes`, `fare_calculation`\n`form_of_payment` -- for additional collection\n`gds?` -- GDS for command generation\n`tax_carryforward_context` -- geography (`SAME_AIRPORT | SAME_CITY | DIFFERENT`), validity window flag, flown status, POS unchanged\n`tax_carryforward_rules` -- per-code rules covering every tax on original ∪ new (nature, min geography, YQ/YR flags, validity expiry action)\n`same_origin_destination?` -- **deprecated / ignored** for tax decisions (migration warning only)","output":"`reissue` -- new ticket record with full audit trail, exchange commands, `tax_decisions` on the audit trail\n`additional_collection` -- amount due\n`credit_amount` -- amount refundable if downgrade\n`tax_decisions` -- `{ tax_code, action: CARRY | RECALCULATE | FORFEIT, reason }[]`","status":"Implemented","purpose":"Ticket reissue with residual value application, **per-tax** carryforward (`CARRY | RECALCULATE | FORFEIT`), conjunction ticket handling, GDS exchange command generation, and full audit trail.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.3":{"id":"5.3","summary":"Carrier-initiated schedule change handling: trigger assessment, airline protection logic, regulatory entitlements (EU261, US DOT)","className":"InvoluntaryRebook","input":"`original_pnr` -- record locator, passenger, affected segment, issuing carrier, countries, checked-in flag, EU/Community carrier flag, optional endorsement\n`schedule_change` -- change type (incl. MISCONNECT), times, routing/equipment, misconnect shortfall\n`available_flights?` -- protection candidates with operating/marketing/alliance/interline + `endorsement_allows`\n`thresholds?` -- carrier-specific `time_change_minutes`, `measurement_point` (DEPARTURE|ARRIVAL), `misconnect_minutes` — required for those triggers\n`is_passenger_no_show?` -- no-show flag\n`is_oversale_denied_boarding?` -- only true for 14 CFR §250 oversales\n`eu261_inputs?` -- great-circle `distance_km` (Art.7(4)), delay/notice/rerouting/extraordinary, third-country benefits caveat","output":"`result` -- involuntary flag, trigger, ranked protection candidates (not executed), `art8_passenger_choice_required` + `art8_choices`, measurement point, regulatory flags (EU261/US DOT), original routing credit flag, summary","status":"Implemented","purpose":"Carrier-initiated schedule change / IRROP handling. Domain KB: `docs/knowledge-base/involuntary-rebook-irrop.md` (Regulation (EC) No 261/2004 — [CELEX:32004R0261](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32004R0261)).\n\n- **Triggers:** time change, routing change, equipment downgrade, cancellation, misconnect — with explicit dep vs arr measurement. **No hardcoded 60-minute threshold**; fail closed when carrier threshold input is missing.\n- **Reprotection candidates:** same operating → marketing → alliance → interline → other, with endorsement fail-closed. Alliance ≠ any alliance flight. **Do not silently \"same carrier first\"** — when EU261 applies, Art.8 passenger choice (refund vs re-route) is required before execution.\n- **EU261:** Art.3(1) matrix (EU depart any carrier / EU arrive Community carrier only). Art.7 compensation via great-circle bands only (never TPM). Art.8 choice surfaced on output.\n- **US DOT:** 14 CFR §250 IDB is oversale-specific — delays/cancels report `applies: false`.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"5.4":{"id":"5.4","summary":"Placeholder -- not yet implemented. Requires domain input on disruption priority rules","className":"DisruptionResponseAgent","status":"Coming Soon (stub)","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"5.5":{"id":"5.5","summary":"Placeholder -- not yet implemented. Requires domain input on change fee structures","className":"SelfServiceRebookingAgent","status":"Implemented","purpose":"Orchestrates Availability Search (1.1) and Change Management (5.1) to present priced rebooking alternatives (changeFee + fareDifference + taxDifference per option). Read-only -- does NOT execute the reissue; that is Exchange/Reissue (5.2). Involuntary reasons (schedule change / missed connection / cancellation) waive the change fee; voluntary changes honor ATPCO Cat 31 via 5.1.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"5.6":{"id":"5.6","summary":"Placeholder -- not yet implemented. Requires domain input on waitlist priority scoring","className":"WaitlistManagementAgent","status":"Implemented","purpose":"Stateful in-memory passenger waitlist queue with four operations: addEntry (priority computed at add time), clear (given N seats opened, remove top-N by priority), queryStatus (1-based position + estimated clearance probability), and expire (prune entries past their cutoff). State is in-memory only -- production deployments should pair it with a durable persistence layer.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"6.1":{"id":"6.1","summary":"ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting, conjunction ticket handling","className":"RefundProcessing","input":"`ticket_number`, `conjunction_tickets?`\n`issuing_carrier`, `passenger_name`, `record_locator`\n`base_fare`, `base_fare_currency`, `taxes`, `commission?`\n`refund_type` -- `'FULL' | 'PARTIAL' | 'TAX_ONLY'`\n`coupons_to_refund?` -- specific coupons (for partial)\n`total_coupons`, `waiver_code?`, `waiver_effect?` (required with code), `fare_basis`, `is_refundable`\n`waiver_penalty_reduction?`, `waiver_refund_form?` -- companions per typology in `docs/knowledge-base/waiver-typology.md`\n`settlement_system` -- `'BSP' | 'ARC'`","output":"`refund` -- penalty applied, base fare refund, tax refund, tax breakdown, commission recalled, net refund, BSP/ARC reporting fields, audit trail\n`net_refund_amount`, `commission_recalled`","status":"Implemented","purpose":"ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting fields, conjunction ticket handling. Supports full, partial, and tax-only refunds.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.2":{"id":"6.2","summary":"Pre-ticketing audit: 9 checks covering fare integrity, segment validity, and compliance to prevent Agency Debit Memos","className":"ADMPrevention","input":"`booking` -- record locator, passenger name, segments (with status, class, married group), base fare\n`fare_basis`, `booked_class`\n`commission_rate?`, `carrier_contracted_rate?`\n`endorsement?`, `tour_code?`\n`is_net_remit?`, `net_contracted_amount?`\n`ttl_deadline?`, `duplicate_check_pnrs?`, `current_datetime?`","output":"`result` -- all check results, overall pass/fail, blocking/warning counts","status":"Implemented","purpose":"Pre-ticketing audit with 9 checks: duplicate booking, fare/class mismatch, passive segment, married segment integrity, TTL expiry, commission rate, endorsement box, tour code format, net remit validation.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.3":{"id":"6.3","summary":"Agency Debit Memo receipt, assessment, dispute, and Agency Credit Memo application workflows","className":"ADMACMProcessingAgent","input":"`operation` -- `'receiveADM' | 'receiveACM' | 'assessADM' | 'disputeADM' | 'acceptADM' | 'escalateADM' | 'applyACM' | 'getADM' | 'getPendingWithDeadlines'`\nOperation-specific fields: ticket number, airline, amount, reason code, dispute ground/evidence, ADM/ACM IDs","output":"`adm?` -- ADM record with status history\n`acm?` -- ACM record\n`assessment?` -- days remaining, window expired, recommended action\n`disputeResult?` -- dispute outcome\n`pendingDeadlines?` -- urgent ADMs approaching deadline","status":"Implemented","purpose":"Agency Debit Memo receipt, assessment, dispute, and Agency Credit Memo application workflows. Tracks dispute deadlines (15-day window), supports dispute grounds, and manages status transitions.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.4":{"id":"6.4","summary":"Multi-channel customer notification generation for flight disruptions, refunds, and operational changes. 8 notification types x 4 channels","className":"CustomerCommunication","input":"`operation` -- `'generateNotification' | 'generateBatch' | 'getTemplate'`\n`notificationType?` -- notification type\n`channel?` -- delivery channel\n`variables?` -- template variables (passenger name, flight info, amounts, etc.)\n`batchRequests?` -- for batch generation","output":"`notification?` -- generated notification with body, subject, SMS segments, used/missing variables\n`notifications?` -- batch results\n`template?` -- template info with required variables","status":"Implemented","purpose":"Multi-channel customer notification generation. 8 notification types (flight cancelled, delayed, gate change, rebooking confirmed, refund processed, schedule change, waitlist cleared, ADM received) x 4 channels (Email HTML, Email text, SMS, WhatsApp).","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.5":{"id":"6.5","summary":"Complaint submission, EU261/US DOT compensation calculation, case management, and regulatory DOT record generation","className":"FeedbackComplaintAgent","input":"`operation` -- `'submitComplaint' | 'updateStatus' | 'getCase' | 'listCases' | 'calculateCompensation' | 'generateDOTRecord'`\nComplaint fields: type, passenger, booking reference, airline, flight, description\nCompensation fields: regulation, distance, delay, alternative offered, fare paid, cabin class\nCase management: case ID, status transitions","output":"`complaintCase?` -- full case record with status history, compensation result\n`cases?` -- filtered case list\n`compensation?` -- EU261/US DOT calculation (eligibility, base/final amount, reduction, notes)\n`dotRecord?` -- DOT regulatory record","status":"Implemented","purpose":"Complaint submission, EU261/US DOT compensation calculation, case management with status tracking, and DOT regulatory record generation.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"6.6":{"id":"6.6","summary":"Mileage accrual calculation, redemption eligibility, status benefits, and alliance status matching","className":"LoyaltyMileageAgent","input":"`operation` -- `'calculateAccrual' | 'checkRedemptionEligibility' | 'getStatusBenefits' | 'matchStatus'`\nAccrual: operating/crediting carrier, booking class, distance, loyalty status\nRedemption: distance, cabin, partner flag, current balance\nBenefits: airline, status tier\nMatch: source/target airline, source status","output":"`accrual?` -- base miles, bonus miles, total, earn rate, partner flag\n`redemption?` -- eligibility, miles required, remaining balance\n`statusBenefits?` -- benefit list by tier\n`statusMatch?` -- matched status at target airline","status":"Implemented","purpose":"Mileage accrual calculation, redemption eligibility checking, status benefits lookup, and cross-airline status matching.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.1":{"id":"7.1","summary":"Matches agency booking records against BSP HOT files, validates commission, identifies discrepancies, flags issues before remittance deadline","className":"BSPReconciliation","input":"`hot_records` -- BSP HOT file records (ticket number, passenger, origin/destination, airline, amounts, commission, transaction type, billing period)\n`agency_records` -- agency-side booking records for comparison","output":"Matched records, unmatched records, discrepancies with severity and type, commission validation results","status":"Implemented","purpose":"Matches agency booking records against BSP HOT files, validates commission rates, identifies discrepancies (missing records, duplicates, amount/commission/currency mismatches, unmatched ADM/ACM), and flags issues before remittance deadline.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.2":{"id":"7.2","summary":"Processes ARC IAR weekly billing, validates commission rates against airline contracts, flags pricing/commission errors","className":"ARCReconciliation","input":"`iar_records` -- ARC IAR records (document number, amounts, commission, transaction type, settlement week, ADM issue dates)\n`agency_records` -- agency-side records for comparison","output":"Matched/unmatched records, discrepancies with severity, ADM dispute window warnings","status":"Implemented","purpose":"Processes ARC IAR (Interactive Agent Reporting) weekly billing, validates commission rates against airline contracts, flags pricing/commission errors, and manages ADM/ACM disputes within the 15-day window.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.3":{"id":"7.3","summary":"Commission agreement management, rate validation, incentive calculation","className":"CommissionManagementAgent","input":"`operation` -- `'registerAgreement' | 'getRate' | 'validateCommission' | 'calculateIncentive' | 'listAgreements'`\nAgreement data: agent ID, airline, type, rate, basis (percent/flat per ticket/segment), fare basis patterns, validity dates, minimum tickets\nValidation: claimed rate vs expected rate\nIncentive: period, ticket count, total fare","output":"`agreement?` -- registered agreement\n`rate?` -- applicable commission rate\n`validation?` -- match/overstated/understated status with variance\n`incentive?` -- earned incentive amount, threshold met flag","status":"Implemented","purpose":"Commission agreement management: register agreements (override, incentive, backend, net fare, standard), look up rates by airline/fare basis, validate claimed commission, and calculate incentive earnings.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.4":{"id":"7.4","summary":"Placeholder -- not yet implemented. Requires domain input on interline prorate methodology","className":"InterlineSettlementAgent","status":"Coming Soon (stub)","purpose":"Requires domain input on interline prorate methodology and SIS (Simplified Interline Settlement) billing rules before implementation can proceed.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"7.5":{"id":"7.5","summary":"Aggregates transaction data into reports (revenue by route, margin analysis, unused tickets, etc.)","className":"FinancialReportingAgent","input":"`type` -- report type (9 report types available)\n`period` -- date range\n`filters?` -- airlines, agents, corporate IDs, currencies, minimum amount\n`groupBy?` -- grouping dimensions\n`records` -- financial records (ticket, refund, ADM, ACM, commission, fee)\n`currency?` -- reporting currency","output":"Report line items with revenue, cost, commission, net per group\nReport totals","status":"Implemented","purpose":"Generates financial reports: revenue by route/agent/corporate client, margin analysis, cost tracking, commission summary, spend by supplier, unused ticket value, and settlement summary.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"7.6":{"id":"7.6","summary":"Coupon lift recording, revenue recognition, uplift/deferred revenue reporting","className":"RevenueAccountingAgent","input":"`operation` -- `'recordLift' | 'recognizeRevenue' | 'getUpliftReport' | 'getDeferredRevenue' | 'recordVoid' | 'recordRefund'`\nLift data: ticket number, coupon number, flight details, fare amount\nReport parameters: date range","output":"Lift records, revenue recognition results, uplift reports (by route/cabin with average yield), deferred revenue reports","status":"Implemented","purpose":"Coupon lift tracking and revenue recognition: record lifted coupons, recognize revenue per flight, generate uplift reports (by route, by cabin), track deferred revenue from open coupons, and handle voids/refunds.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.1":{"id":"8.1","summary":"Stores/retrieves traveler preferences, documents, loyalty programs. Applies profiles to PNRs via SSR injection","className":"TravelerProfileAgent","input":"`operation` -- `'get' | 'create' | 'update' | 'apply_to_pnr' | 'search'`\nProfile data: name, DOB, nationality, passport, loyalty numbers, seat/meal preference, contact info, corporate/employee ID, department, cost center\nPNR application: GDS system, segments for APIS generation","output":"`profile?` -- traveler profile record\n`profiles?` -- search results\nPNR application: generated SSR/OSI commands","status":"Implemented","purpose":"Traveler preferences, identity documents, loyalty programs, and PNR prefill. CRUD operations plus apply-to-PNR for generating SSR/APIS commands.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.2":{"id":"8.2","summary":"Corporate travel policy enforcement, negotiated fares, booking validation","className":"CorporateAccountAgent","input":"`operation` -- `'get_account' | 'create_account' | 'update_account' | 'validate_booking' | 'get_policy' | 'list_accounts' | 'get_preferred_suppliers'`\nAccount data: company name, IATA number, travel policy, negotiated fares, contact info\nBooking validation: segments, cabin, fare amount, advance days","output":"`account?` -- corporate account record\n`accounts?` -- account list\n`validation?` -- policy violations (hard/soft) with details\n`policy?` -- travel policy rules\n`suppliers?` -- preferred suppliers","status":"Implemented","purpose":"Corporate travel policy management, negotiated fare lookup, and booking validation against policy rules (cabin limits, fare ceilings, advance booking, preferred/blacklisted airlines).","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.3":{"id":"8.3","summary":"PNR quality checks, ticketing deadline monitoring, duplicate/passive detection","className":"MidOfficeAgent","input":"`trigger` -- `'scheduled_sweep' | 'pnr_created' | 'ticket_deadline_approaching' | 'queue_pending' | 'manual_review_request'`\n`pnrs` -- PNR records with segments, deadlines, APIS/contact/FOP flags\n`current_datetime?` -- ISO timestamp (compared as Zulu)","output":"Per-PNR issues with severity (urgent/high/medium/low) and issue codes\nSummary counts","status":"Implemented","purpose":"PNR quality checks and ticketing deadline monitoring. Scans PNRs for 10 issue types: TTL urgent/approaching, missing segment status, missing APIS, missing contact/FOP, duplicate PNR, passive segment, policy violation, married segment incomplete.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.4":{"id":"8.4","summary":"Aggregates transaction data into reports (booking volume, revenue, top routes, policy compliance)","className":"ReportingAgent","input":"`report_type` -- report type\n`date_from`, `date_to` -- date range\n`filters?` -- corporate ID, agent, airline, department, currency\n`transactions` -- transaction records (ticket, amounts, airline, dates, in-policy flag, used flag)","output":"Report rows grouped by the relevant dimension\nSummary totals","status":"Implemented","purpose":"Transaction aggregation and report generation across 9 report types: booking volume, revenue summary, top routes, agent productivity, policy compliance, spend by traveler/department/supplier, unused tickets.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"8.5":{"id":"8.5","summary":"Locates travelers in active itineraries during disruptions with destination risk assessment","className":"DutyCareAgent","input":"`operation` -- `'locate_travelers' | 'get_traveler_itinerary' | 'assess_destination_risk' | 'mark_accounted_for'`\nItineraries: traveler ID, segments with dates/times/status\nRisk: country code\nAccountability: traveler ID","output":"`locatedTravelers?` -- current location, status (IN_TRANSIT/AT_DESTINATION/DEPARTED/UNKNOWN), accounted-for flag\n`itinerary?` -- full traveler itinerary\n`risk?` -- country risk level (low/medium/high/critical) with notes","status":"Implemented","purpose":"Traveler location tracking, destination risk assessment, and accountability management for corporate duty-of-care obligations.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.1":{"id":"9.1","summary":"Coordinates multi-agent workflows as a single callable pipeline (search_to_price, book_to_ticket, full_booking, etc.)","className":"OrchestratorAgent","input":"`workflow` -- workflow name\n`input` -- workflow input data\n`options?` -- `stop_on_error?`, `timeout_ms?`","output":"`workflow` -- workflow name\n`status` -- `'completed' | 'failed' | 'partial'`\n`steps` -- per-step results (agent ID, status, duration, output/error)\n`total_duration_ms`\n`final_output?` -- last step output","usage":"Accepts injectable `StepExecutor` for testing without real agent imports. Then call initialize() and execute({ data }).","status":"Implemented","purpose":"Multi-agent workflow coordination. Defines named workflows (search-to-price, book-to-ticket, full booking, exchange flow, refund flow) as step sequences. Supports conditional steps, parallel execution, error handling (stop/skip/continue), and pipeline building."},"9.2":{"id":"9.2","summary":"RAG over travel knowledge base with BM25 relevance scoring and optional hybrid scoring via injectable EmbeddingProvider","className":"KnowledgeAgent","input":"`operation` -- `'query' | 'index_document' | 'list_topics' | 'get_document'`\nQuery: query string, topic filter, max results\nIndex: document ID, title, content, tags, topic","output":"`results?` -- ranked results with relevance score, excerpt, full content\n`document?` -- specific document\n`topics?` -- available topic list\n`query_time_ms?`","status":"Implemented","purpose":"RAG (Retrieval-Augmented Generation) over the travel knowledge base. Indexes documents by topic, supports BM25 + vector hybrid search with injectable embedding provider.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.3":{"id":"9.3","summary":"Tracks agent health, API latency, error rates, SLA compliance","className":"MonitoringAgent","input":"`operation` -- `'record_metric' | 'get_health' | 'list_alerts' | 'acknowledge_alert' | 'get_sla_report'`\nMetric: agent ID, metric type (latency_ms/error/success/timeout), value\nAlert: alert ID for acknowledgment","output":"`health?` -- agent health (status, p50/p95 latency, error rate, total calls)\n`alerts?` -- alert list with severity and fired timestamp\n`slaReport?` -- availability percent, p95 latency, error count","status":"Implemented","purpose":"Agent health monitoring: latency tracking (p50/p95), error rates, SLA compliance reporting. Records metrics, fires alerts on threshold violations, supports alert acknowledgment.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.4":{"id":"9.4","summary":"Audit trail, PII redaction, GDPR/PCI/IATA compliance","className":"AuditAgent","input":"`operation` -- `'log_event' | 'query_audit_log' | 'flag_compliance_issue' | 'get_compliance_report' | 'redact_pii'`\nEvent: type (agent_decision, data_access, booking_created, etc.), agent ID, user/session ID, payload\nCompliance: issue type, description, severity, affected records","output":"`entry?` -- audit log entry with hash, PII redaction flag, retention days\n`entries?` -- query results\n`issue?` -- flagged compliance issue\n`report?` -- compliance report (events with PII, redaction counts, open issues by severity)\n`redactedPayload?` -- PII-redacted data","status":"Implemented","purpose":"Audit trail logging with SHA-256 payload hashing, PII redaction (credit cards, passports, emails, phone numbers, DOB), GDPR/PCI/IATA compliance issue flagging, and compliance reporting.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.5":{"id":"9.5","summary":"Manages third-party agent extensions and capability discovery","className":"PluginManagerAgent","input":"`operation` -- `'register_plugin' | 'unregister_plugin' | 'list_plugins' | 'get_plugin' | 'discover_capabilities' | 'enable_plugin' | 'disable_plugin'`\nPlugin data: name, version, description, author, capabilities, agent IDs, metadata","output":"`plugin?` -- plugin record\n`plugins?` -- plugin list\n`capabilities?` -- capability-to-plugin mapping\n`message?` -- operation result message","status":"Implemented","purpose":"Third-party agent extension management: register/unregister plugins, enable/disable, capability discovery, and plugin metadata management.","usage":"Call initialize(), then execute({ data }) with the input fields below. See the agent source and stage doc for typed schemas."},"9.6":{"id":"9.6","summary":"Aggregates agent execution metrics from the EventStore within a given time window. Identifies degraded agents","className":"PerformanceAuditAgent","status":"Implemented","purpose":"Aggregates agent execution metrics from the EventStore within a given time window and identifies degraded agents. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"9.7":{"id":"9.7","summary":"Analyses routing decisions and outcomes from the EventStore within a given time window","className":"RoutingAuditAgent","status":"Implemented","purpose":"Analyses routing decisions and outcomes from the EventStore within a given time window. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"9.8":{"id":"9.8","summary":"Accepts performance and routing audit reports and produces deterministic recommendations","className":"RecommendationAgent","status":"Implemented","purpose":"Accepts performance and routing audit reports and produces deterministic recommendations. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"9.9":{"id":"9.9","summary":"Queries EventStore events, computes metrics against configurable thresholds, and produces alerts","className":"AlertAgent","status":"Implemented","purpose":"Queries EventStore events, computes metrics against configurable thresholds, and produces alerts. Read-only -- no side effects.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"20.1":{"id":"20.1","summary":"Multi-source hotel availability search across GDS hotel segments, direct APIs, and channel manager feeds","className":"HotelSearchAggregatorAgent","input":"`destination` -- city name, airport code, or coordinates\n`checkIn` -- ISO date string (YYYY-MM-DD)\n`checkOut` -- ISO date string (YYYY-MM-DD)\n`rooms` -- number of rooms needed\n`adults` -- number of adult guests per room\n`children?` -- number of child guests per room\n`starRating?` -- minimum star rating filter\n`maxRatePerNight?` -- maximum nightly rate filter (decimal string)\n`currency?` -- ISO 4217 currency for rate filtering/display\n`rateType?` -- rate type filter\n`chainPreference?` -- chain code (e.g., `\"MC\"` for Marriott)\n`timeoutMs?` -- per-adapter timeout in milliseconds (default: 5000)\n`adapterIds?` -- specific adapter IDs to query (all if omitted)","output":"`properties` -- raw hotel results from all sources (NOT deduplicated)\n`totalResults` -- total result count across all adapters\n`adapterResults` -- per-adapter summary (ID, name, count, response time, timeout/error)\n`partialResults` -- true if some adapters timed out or errored\n`searchId` -- unique search ID for tracing","usage":"const agent = new HotelSearchAggregatorAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    destination: 'New York',\n    checkIn: '2026-06-01',\n    checkOut: '2026-06-03',\n    rooms: 1,\n    adults: 2,\n  },\n});\n// result.data.totalResults => 45\n// result.data.partialResults => false","status":"Implemented","purpose":"Multi-source hotel availability search across GDS hotel segments, direct APIs (Amadeus Hotel, Hotelbeds, Duffel Stays), and channel manager feeds. Returns raw, unmerged results from all connected sources. Supports injectable `HotelSourceAdapter` for plugging in custom sources."},"20.2":{"id":"20.2","summary":"Identifies duplicate properties from multi-source results and merges them into canonical records","className":"PropertyDeduplicationAgent","input":"`properties` -- raw hotel results from Agent 20.1\n`thresholds?` -- custom merge thresholds\n`autoMerge` -- score above which properties are auto-merged (default: 0.85)\n`review` -- score above which properties are flagged for review (default: 0.65)","output":"`canonical` -- canonical property records (one per physical property)\n`mergeLog` -- full audit trail of merge/separate decisions (property IDs, score, decision type, score breakdown)\n`stats` -- summary (input count, output count, auto-merged, review-flagged, separated)","usage":"const agent = new PropertyDeduplicationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { properties: rawResults },\n});\n// result.data.stats.inputCount => 45\n// result.data.stats.outputCount => 28\n// result.data.stats.autoMerged => 12","status":"Implemented","purpose":"Takes raw multi-source hotel results from Agent 20.1 and identifies duplicate properties (40-60% of multi-source results are duplicates). Merges them into canonical property records using weighted scoring: Jaro-Winkler name similarity (0.3), normalized address Levenshtein (0.2), Haversine coordinate proximity (0.25), chain code match (0.15), and star rating match (0.1)."},"20.3":{"id":"20.3","summary":"Standardizes hotel content (room types, amenity names, descriptions, photos) into a consistent OTAIP taxonomy","className":"ContentNormalizationAgent","input":"`properties` -- canonical property records from Agent 20.2","output":"`properties` -- normalized property content records, each containing:\n`canonicalId` -- pass-through from 20.2\n`property` -- original canonical property\n`normalizedRoomTypes` -- room types mapped to OTAIP taxonomy\n`normalizedAmenities` -- amenities mapped to OTAIP taxonomy\n`scoredPhotos` -- scored and categorized photos (category, quality score, primary flag)\n`unmappedRoomTypes` -- raw room types that could not be normalized\n`unmappedAmenities` -- raw amenity strings that could not be normalized\n`stats` -- totals for properties, mapped/unmapped room types, mapped/unmapped amenities","usage":"const agent = new ContentNormalizationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { properties: canonicalProperties },\n});\n// result.data.stats.totalRoomTypesMapped => 84\n// result.data.stats.totalAmenitiesUnmapped => 3","status":"Implemented","purpose":"Standardizes hotel content (room types, amenity names, photos) into a consistent OTAIP taxonomy for comparison and display. Maps raw room types from each source to the normalized taxonomy, merges amenities via union merge, and scores/categorizes photos."},"20.4":{"id":"20.4","summary":"Compares rates for the same canonical property across all sources, identifies best available rate, detects rate parity violations","className":"RateComparisonAgent","input":"`properties` -- canonical properties with source results containing rates\n`currency?` -- preferred currency for display (default: USD)\n`nights?` -- number of nights for the stay (default: 1)","output":"`comparisons` -- per-property rate comparison, each containing:\n`canonicalId` -- canonical property ID\n`propertyName` -- property name\n`rates` -- all rates sorted by total cost (lowest first), with full cost breakdown (room charges, mandatory fees, taxes, grand total)\n`bestByRateType` -- best rate per rate type\n`parity` -- rate parity analysis (at parity flag, lowest/highest source, spread percentage)\n`totalProperties` -- total properties compared\n`parityViolations` -- count of properties with rate parity violations","usage":"const agent = new RateComparisonAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: { properties: canonicalProperties, nights: 2 },\n});\n// result.data.comparisons[0].rates[0].totalCost.grandTotal => { amount: '289.00', currency: 'USD' }\n// result.data.parityViolations => 3","status":"Implemented","purpose":"Compares rates for the same canonical property across all sources, identifies best available rate per rate type, and detects rate parity violations (>2% spread between lowest and highest source). Includes ALL mandatory fees (resort fees, destination fees, taxes) in total cost breakdown."},"20.5":{"id":"20.5","summary":"Executes hotel bookings with three-layer confirmation code system (CRS, PMS, Channel)","className":"HotelBookingAgent","input":"`operation` -- `'book' | 'verify_rate' | 'get_booking'`\n`bookingRequest?` -- required for `book`/`verify_rate`:\n`canonicalPropertyId` -- from Agent 20.2\n`rateId` -- from Agent 20.4\n`source` -- hotel source to book through\n`checkIn` / `checkOut` -- ISO date strings\n`rooms` -- number of rooms\n`guest` -- guest details (name, email, phone, loyalty info)\n`paymentModel` -- payment model\n`specialRequests?` -- free text\n`bookingId?` -- required for `get_booking`","output":"`success` -- whether the operation succeeded\n`booking?` -- booking record (ID, three-layer confirmation codes, status, total charged, payment model, virtual card info, cancellation policy/deadline, guest, original request)\n`error?` -- error message if failed\n`rateChanged?` -- whether rate changed between search and booking\n`newRate?` -- new rate if changed","usage":"const agent = new HotelBookingAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    operation: 'book',\n    bookingRequest: {\n      canonicalPropertyId: 'canon-001',\n      rateId: 'rate-001',\n      source: 'amadeus_hotel',\n      checkIn: '2026-06-01',\n      checkOut: '2026-06-03',\n      rooms: 1,\n      guest: { firstName: 'John', lastName: 'Smith', email: 'john@example.com' },\n      paymentModel: 'merchant',\n    },\n  },\n});\n// result.data.booking?.confirmation.crs => \"CRS-ABC123\"","status":"Implemented","purpose":"Executes hotel bookings through the optimal source. Manages the full booking flow from rate verification through confirmation, including three-layer confirmation codes (CRS, PMS, channel). Supports VCN (Virtual Card Number) payment with dual folio requirements."},"20.6":{"id":"20.6","summary":"Post-booking changes: free modifications, date changes (cancel/rebook), cancellations with penalty calculation, no-show processing","className":"HotelModificationAgent","input":"`operation` -- `'modify' | 'cancel' | 'check_penalty' | 'process_no_show'`\n`bookingId` -- existing booking ID\n`modifications?` -- free modifications (guest name, bed type, smoking preference, special requests, accessibility needs, guest count)\n`dateChange?` -- new check-in / check-out dates (triggers cancel/rebook)\n`bookedAt?` -- booking timestamp for California 24hr rule check\n`cancellationPolicy?` -- current cancellation policy\n`checkInDate?` -- for deadline calculations\n`nightlyRate?` -- nightly rate from booking record (penalty base)","output":"`success` -- whether the operation succeeded\n`classification` -- `'free_modification' | 'cancel_rebook_required' | 'not_modifiable'`\n`isFreeMod` -- whether this is a free modification\n`penalty?` -- penalty calculation (amount, type, deadline, free window flag, California rule flag)\n`rebookRequired` -- whether a rebook is needed (for date changes)\n`newBookingId?` -- updated confirmation codes (for successful modifications)\n`message` -- error or status message","usage":"const agent = new HotelModificationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    operation: 'cancel',\n    bookingId: 'BK-001',\n    cancellationPolicy: { type: 'free_cancellation', deadline: '2026-05-30T00:00:00Z' },\n    checkInDate: '2026-06-01',\n    bookedAt: '2026-04-01T10:00:00Z',\n  },\n});\n// result.data.classification => \"free_modification\"\n// result.data.penalty?.isWithinFreeWindow => true","status":"Implemented","purpose":"Handles post-booking changes: free modifications (guest name, bed type, special requests), date changes (which require cancel/rebook -- NOT modifications), cancellations with penalty calculation, and no-show processing. Enforces California 24-hour cancellation rule where applicable."},"20.7":{"id":"20.7","summary":"Cross-checks CRS-to-PMS booking data to detect discrepancies before guest arrival","className":"ConfirmationVerificationAgent","input":"`operation` -- `'verify' | 'check_pms_sync' | 'batch_verify'`\n`bookingId` -- booking ID to verify\n`confirmation` -- three-layer confirmation codes from booking\n`crsData` -- CRS-side booking data (confirmation code, guest name, dates, room type, rates, status)\n`pmsData?` -- PMS-side booking data (may be missing if PMS hasn't synced yet)\n`guest` -- guest details for name verification\n`hoursUntilCheckin?` -- hours until check-in (for escalation urgency)\n`batchBookingIds?` -- additional booking IDs (for `batch_verify`)","output":"`verified` -- whether verification passed with no critical issues\n`discrepancies` -- all detected discrepancies (field, CRS value, PMS value, severity, message)\n`escalationRequired` -- whether human/agent escalation is needed\n`escalationReasons` -- why escalation is needed (pms_code_missing, rate_mismatch, date_mismatch, guest_name_mismatch, waitlist_status, tentative_status, room_type_mismatch, multiple_discrepancies)\n`verifiedAt` -- verification timestamp\n`message` -- summary message","usage":"const agent = new ConfirmationVerificationAgent();\nawait agent.initialize();\nconst result = await agent.execute({\n  data: {\n    operation: 'verify',\n    bookingId: 'BK-001',\n    confirmation: { crs: 'CRS-ABC', pms: 'PMS-123', channel: 'CH-456' },\n    crsData: {\n      confirmationCode: 'CRS-ABC',\n      guestName: 'SMITH/JOHN',\n      checkIn: '2026-06-01',\n      checkOut: '2026-06-03',\n      roomType: 'King Standard',\n      nightlyRate: { amount: '189.00', currency: 'USD' },\n      totalRate: { amount: '378.00', currency: 'USD' },\n      status: 'confirmed',\n    },\n    guest: { firstName: 'John', lastName: 'Smith' },\n  },\n});\n// result.data.verified => true\n// result.data.discrepancies.length => 0","status":"Implemented","purpose":"Cross-checks CRS and PMS booking data to detect discrepancies before guest arrival. Escalates missing PMS codes, waitlist/tentative status, rate/date mismatches. PMS sync can take 1-4 hours; delays beyond 24 hours trigger escalation."},"20.8":{"id":"20.8","summary":"Thin typed wrapper around Hotelbeds Activities search for route→fill orchestration and product-layer activity_search mapping.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."},"20.9":{"id":"20.9","summary":"Thin typed wrapper around Hotelbeds Transfers search for route→fill orchestration.","usage":"Call initialize(), then execute({ data }). See source_path for the typed input/output contract."}}}</script>
+  <script 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>
     const payload = JSON.parse(document.getElementById('graph-data').textContent);
     const graph = payload.graph;
diff --git a/docs/agents.md b/docs/agents.md
index 7dce4b0..f42b416 100644
--- a/docs/agents.md
+++ b/docs/agents.md
@@ -83,7 +83,7 @@
 | ID | Class | Name | Description | Contract |
 |----|-------|------|-------------|----------|
 | 6.1 | `RefundProcessing` | Refund Processing | ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting, conjunction ticket handling | -- |
-| 6.2 | `ADMPrevention` | ADM Prevention | Pre-ticketing audit: 9 checks covering fare integrity, segment validity, and compliance to prevent Agency Debit Memos | -- |
+| 6.2 | `ADMPrevention` | ADM Prevention | Pre-ticketing audit: 10 checks covering fare integrity, passive/UC/churn (history-required), married integrity, TTL, and compliance to prevent Agency Debit Memos | -- |
 | 6.3 | `ADMACMProcessingAgent` | ADM/ACM Processing | Agency Debit Memo receipt, assessment, dispute, and Agency Credit Memo application workflows | -- |
 | 6.4 | `CustomerCommunication` | Customer Communication | Multi-channel customer notification generation for flight disruptions, refunds, and operational changes. 8 notification types x 4 channels | -- |
 | 6.5 | `FeedbackComplaintAgent` | Feedback & Complaint | Complaint submission, EU261/US DOT compensation calculation, case management, and regulatory DOT record generation | -- |
diff --git a/docs/agents/stage-6-settlement.md b/docs/agents/stage-6-settlement.md
index b007302..2f2b7cd 100644
--- a/docs/agents/stage-6-settlement.md
+++ b/docs/agents/stage-6-settlement.md
@@ -15,6 +15,7 @@ Refund processing, ADM prevention, ADM/ACM dispute management, customer communic
 ATPCO Category 33 refund processing: penalty application, commission recall, BSP/ARC reporting fields, conjunction ticket handling. Supports full, partial, and tax-only refunds.
 
 **Input (`RefundProcessingInput`):**
+
 - `ticket_number`, `conjunction_tickets?`
 - `issuing_carrier`, `passenger_name`, `record_locator`
 - `base_fare`, `base_fare_currency`, `taxes`, `commission?`
@@ -25,6 +26,7 @@ ATPCO Category 33 refund processing: penalty application, commission recall, BSP
 - `settlement_system` -- `'BSP' | 'ARC'`
 
 **Output (`RefundProcessingOutput`):**
+
 - `refund` -- penalty applied, base fare refund, tax refund, tax breakdown, commission recalled, net refund, BSP/ARC reporting fields, audit trail
 - `net_refund_amount`, `commission_recalled`
 
@@ -36,17 +38,25 @@ ATPCO Category 33 refund processing: penalty application, commission recall, BSP
 **Class:** `ADMPrevention`
 **Status:** Implemented
 
-Pre-ticketing audit with 9 checks: duplicate booking, fare/class mismatch, passive segment, married segment integrity, TTL expiry, commission rate, endorsement box, tour code format, net remit validation.
+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.
+
+**Domain KB:** `docs/knowledge-base/adm-prevention.md` — IATA Reso 850m covers ADM memo windows/dispute (Agent 6.3); passive/UC/churn come from carrier booking policy + host statuses. Travelport: those statuses do not need a ticketing field. No carrier-secret commission tables.
 
 **Input (`ADMPreventionInput`):**
+
 - `booking` -- record locator, passenger name, segments (with status, class, married group), base fare
 - `fare_basis`, `booked_class`
-- `commission_rate?`, `carrier_contracted_rate?`
+- `commission_rate?`, `carrier_contracted_rate?` -- both caller-supplied; no embedded carrier tables
 - `endorsement?`, `tour_code?`
 - `is_net_remit?`, `net_contracted_amount?`
-- `ttl_deadline?`, `duplicate_check_pnrs?`, `current_datetime?`
+- `ttl_deadline?`, `ttl_timezone?`, `ttl_source?`, `current_datetime?`
+- `duplicate_check_pnrs?`
+- `segment_history?` -- required for churning; current status alone is insufficient
+- `gds?` -- `SABRE` | `AMADEUS` | `TRAVELPORT` | `UNKNOWN` (Travelport DX marriage break)
+- `churn_cycle_threshold?`, `churn_window_hours?`
 
 **Output (`ADMPreventionOutput`):**
+
 - `result` -- all check results, overall pass/fail, blocking/warning counts
 
 ---
@@ -60,10 +70,12 @@ Pre-ticketing audit with 9 checks: duplicate booking, fare/class mismatch, passi
 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.
 
 **Input (`ADMACMProcessingInput`):**
+
 - `operation` -- `'receiveADM' | 'receiveACM' | 'assessADM' | 'disputeADM' | 'acceptADM' | 'escalateADM' | 'applyACM' | 'getADM' | 'getPendingWithDeadlines'`
 - Operation-specific fields: ticket number, airline, amount, reason code, dispute ground/evidence, ADM/ACM IDs
 
 **Output (`ADMACMProcessingOutput`):**
+
 - `adm?` -- ADM record with status history
 - `acm?` -- ACM record
 - `assessment?` -- days remaining, window expired, recommended action
@@ -81,6 +93,7 @@ Agency Debit Memo receipt, assessment, dispute, and Agency Credit Memo applicati
 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).
 
 **Input (`CustomerCommunicationInput`):**
+
 - `operation` -- `'generateNotification' | 'generateBatch' | 'getTemplate'`
 - `notificationType?` -- notification type
 - `channel?` -- delivery channel
@@ -88,6 +101,7 @@ Multi-channel customer notification generation. 8 notification types (flight can
 - `batchRequests?` -- for batch generation
 
 **Output (`CustomerCommunicationOutput`):**
+
 - `notification?` -- generated notification with body, subject, SMS segments, used/missing variables
 - `notifications?` -- batch results
 - `template?` -- template info with required variables
@@ -103,12 +117,14 @@ Multi-channel customer notification generation. 8 notification types (flight can
 Complaint submission, EU261/US DOT compensation calculation, case management with status tracking, and DOT regulatory record generation.
 
 **Input (`FeedbackComplaintInput`):**
+
 - `operation` -- `'submitComplaint' | 'updateStatus' | 'getCase' | 'listCases' | 'calculateCompensation' | 'generateDOTRecord'`
 - Complaint fields: type, passenger, booking reference, airline, flight, description
 - Compensation fields: regulation, distance, delay, alternative offered, fare paid, cabin class
 - Case management: case ID, status transitions
 
 **Output (`FeedbackComplaintOutput`):**
+
 - `complaintCase?` -- full case record with status history, compensation result
 - `cases?` -- filtered case list
 - `compensation?` -- EU261/US DOT calculation (eligibility, base/final amount, reduction, notes)
@@ -125,6 +141,7 @@ Complaint submission, EU261/US DOT compensation calculation, case management wit
 Mileage accrual calculation, redemption eligibility checking, status benefits lookup, and cross-airline status matching.
 
 **Input (`LoyaltyMileageInput`):**
+
 - `operation` -- `'calculateAccrual' | 'checkRedemptionEligibility' | 'getStatusBenefits' | 'matchStatus'`
 - Accrual: operating/crediting carrier, booking class, distance, loyalty status
 - Redemption: distance, cabin, partner flag, current balance
@@ -132,6 +149,7 @@ Mileage accrual calculation, redemption eligibility checking, status benefits lo
 - Match: source/target airline, source status
 
 **Output (`LoyaltyMileageOutput`):**
+
 - `accrual?` -- base miles, bonus miles, total, earn rate, partner flag
 - `redemption?` -- eligibility, miles required, remaining balance
 - `statusBenefits?` -- benefit list by tier
diff --git a/docs/knowledge-base/adm-prevention.md b/docs/knowledge-base/adm-prevention.md
new file mode 100644
index 0000000..e47a63c
--- /dev/null
+++ b/docs/knowledge-base/adm-prevention.md
@@ -0,0 +1,123 @@
+# ADM Prevention — Domain Knowledge (Agent 6.2)
+
+Authoritative input for `@otaip/agents-settlement` ADM Prevention. Sources: IATA Resolution 850m (ADM process), public GDS status/advice tables (Amadeus Service Hub; Travelport Universal API PNR Status Codes), and mid-office practice for carrier booking-policy ADMs. Anything missing is an open `DOMAIN_QUESTION` — never invent carrier-secret fee or commission tables.
+
+## Scope split (do not conflate)
+
+| Concern                                                                                | Authority                                                                    | What Agent 6.2 uses it for                                                                       |
+| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| ADM **memo** lifecycle — issuance windows, BSP processing limits, agent dispute period | **IATA Resolution 850m**                                                     | Context only for Agent 6.3 (dispute deadlines). 850m does **not** define passive/UC/churn rules. |
+| Passive / UC / unable / schedule-change / churning ADMs                                | **Carrier booking & ticketing policies** + **GDS host segment status codes** | Pre-ticketing checks in Agent 6.2                                                                |
+
+Typical 850m process facts used elsewhere in OTAIP (Agent 6.3): agent review/dispute window **15 days** before BSP submission; airline dispute handling expected in a timely manner (commonly up to **60 days** in carrier policies that cite 850m); BSP processing generally within **nine months** of final travel (or refund) date. Carrier policies may add market-specific overlays — do not hardcode carrier dispute SLAs here.
+
+## Host statuses that block ticketing (core set)
+
+Carrier booking policies and host queues treat these **advice / status** codes as must-clear before issue. Detection is from the **segment status on the PNR**, not from inventing a parallel “ticketing field.”
+
+| Code   | Typical meaning (public GDS tables)                     | ADM / mid-office risk                                           |
+| ------ | ------------------------------------------------------- | --------------------------------------------------------------- |
+| **HX** | Holding canceled / cancel confirm hold                  | Dead or rejected space — remove before ticketing                |
+| **UC** | Unable to confirm (often flight closed, not waitlisted) | No confirmed inventory — remove / rebook                        |
+| **UN** | Unable — flight does not operate / no flight            | Schedule or sell failure — remove / reprotect                   |
+| **NO** | No action taken (common airline reject of passive)      | Passive/claim rejected — delete NO segments                     |
+| **TK** | Schedule change — advise passenger of new times         | Uncleared schedule change — passenger not advised / times stale |
+
+**Travelport note:** On Travelport hosts, the statuses above are sufficient for detection — they do **not** require an additional ticketing-specific field on the segment. Status alone drives the passive/unable/schedule-change queue action.
+
+### Per-host extended codes (NOT one IATA meaning)
+
+**Do not globalize** HN / PK / GK / YK (or other extended codes) as a single industry-wide meaning. The same two-letter string can mean different things on Sabre vs Amadeus vs Travelport. Agent 6.2 applies these **only when `gds` is set** to that host. If `gds` is omitted / `UNKNOWN`, only the core set above applies.
+
+| Host           | Codes treated as blocking (public host tables / ops)       | Notes                                                              |
+| -------------- | ---------------------------------------------------------- | ------------------------------------------------------------------ |
+| **Amadeus**    | HN, PK, PL, GK, GL, GN, UU, US, XX                         | PK/PL = passive sell; GK/GL/GN = ghost — Amadeus semantics         |
+| **Sabre**      | YK, GK, HN, XX                                             | YK = Sabre administrative/itinerary passive; GK ≠ Amadeus ghost    |
+| **Travelport** | HN, AK, AL, AN, BK, BL, DX, MK, PS, ZK, LK, UU, US, XX, XK | DX = broken marriage / marriage-integrity signal (Travelport-only) |
+
+```
+// TODO: DOMAIN_QUESTION: Confirm Sabre vs Amadeus GK semantics in each adapter's
+// normalized status before treating GK as interchangeable across hosts.
+// TODO: DOMAIN_QUESTION: When gds is UNKNOWN, host-specific codes are ignored
+// (core only). Should UNKNOWN emit a warning instead of silent skip?
+```
+
+Active / ticketable examples (not exhaustive): **HK**, **KK**, **KL**, **RR**, **HS** (context-dependent). Do not treat “looks confirmed now” as proof the PNR was never churned — see churning.
+
+## Churning (requires history)
+
+**Definition (ops):** Repeated book → cancel → rebook of the same (or equivalent) air space to circumvent TTL, hold inventory, or game GDS productivity — without intent to ticket the intermediate holds.
+
+**Hard rule:** Churning **cannot** be detected from **current** segment status alone. A PNR that is all `HK` today can still be a churn case if the history shows multiple cancel/rebook cycles on the same carrier/flight/date (or same O&D class) inside a short window.
+
+Minimum history signals Agent 6.2 expects (when provided):
+
+1. Ordered segment history events: `BOOKED` | `CANCELLED` | `REBOOKED` (ISO timestamps).
+2. Flight identity: carrier + flight number + departure date (and optionally origin/destination).
+3. Default detection heuristic (conservative, not carrier-secret): **≥ 3 cancel→rebook cycles** on the same flight identity within **72 hours** → blocking `CHURNING` failure.
+
+If history is omitted, churning is **skipped** (not assumed clear). Callers that need churn coverage must supply history — skipping is an explicit ADM exposure.
+
+```
+// TODO: DOMAIN_QUESTION: Carrier-specific churn thresholds (cycle count / window hours)
+// vary by airline booking policy. Do not hardcode a global carrier table; keep the
+// default heuristic overridable once policy feeds exist.
+```
+
+## Married segments (GDS-specific)
+
+Married segments are **host constructs**, not “segments that happen to be in the same PNR.”
+
+| GDS            | What mid-office looks for                                                                                                             | Break risk                                                                                                |
+| -------------- | ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| **Sabre**      | Married Segment Indicator (MSI) / marriage linkage on connecting sells                                                                | Partial cancel or class change on one leg of a marriage → married-segment ADM under many carrier policies |
+| **Amadeus**    | Married connection / marriage control on Air Sell; status must stay consistent across the married set                                 | Splitting or mixed advice codes across the marriage                                                       |
+| **Travelport** | Marriage grouping on the air segment; status **DX** can mean _broken marriage_ (passive) or authorized partial cancel within marriage | Seeing **DX** (or mixed HK + cancel advice inside one marriage group) is a red flag for integrity review  |
+
+Agent 6.2 minimum check: every `married_group` must have identical statuses and at least two segments. When `gds` is `TRAVELPORT` and any segment status is `DX`, treat as married-integrity failure even if a group id is missing.
+
+```
+// TODO: DOMAIN_QUESTION: Exact Sabre MSI field names in OTAIP normalized PNR
+// vs cryptic *IA display — confirm adapter mapping before relying on MSI alone.
+```
+
+## TTL edge cases (timezone / deadline day)
+
+Carriers set TTL at booking, fare quote, or by departure rules — interpretation is carrier-specific. Agent 6.2 applies these operational guards when inputs are present:
+
+1. Compare `current_datetime` to `ttl_deadline` in absolute UTC instants when both are full ISO-8601 timestamps.
+2. If `ttl_timezone` is provided (IANA name), also evaluate **calendar deadline-day** in that zone: ticketing **on the same local calendar date as the deadline** is ADM-prone even when a few hours remain in UTC (carriers often ADM same-day-of-deadline issuance).
+3. Distinguish `ttl_source`: `BOOKING` vs `FARE_QUOTE` vs `CARRIER_RULE` in messages — do not silently assume one source.
+4. Keep a pre-issue buffer (currently 30 minutes) so the PNR cannot expire mid-transaction.
+
+```
+// TODO: DOMAIN_QUESTION: Default agency timezone vs airport-of-origin vs BSP
+// market clock when ttl_timezone is absent — Agent 8.3 mid-office may share this policy.
+```
+
+## Commission
+
+Commission validation remains **input-driven**: compare supplied `commission_rate` to caller-supplied `carrier_contracted_rate`.
+
+**Do not** paste or hardcode carrier-secret commission tables, override grids, or net-remit contract schedules into this repository.
+
+## Fixtures (scariest false negatives)
+
+See `packages/agents/settlement/src/adm-prevention/__tests__/fixtures/`:
+
+| Fixture                       | Why it is scary                                                             |
+| ----------------------------- | --------------------------------------------------------------------------- |
+| `churn-all-hk-now.json`       | Current statuses all HK — HX/UN/NO-only scanners pass; history proves churn |
+| `uncleared-tk.json`           | TK schedule-change left on PNR — not in classic HX/UN/NO set                |
+| `uc-hn-passive-pk.json`       | Amadeus UC + HN + PK — host-specific HN/PK, not a universal IATA meaning    |
+| `travelport-dx-marriage.json` | Travelport DX / broken marriage without needing a ticketing field           |
+| `ttl-deadline-day-tz.json`    | UTC still “has time” but local deadline day has begun                       |
+
+## Open DOMAIN_QUESTIONs
+
+1. Per-carrier churn cycle/window overrides (policy feed shape).
+2. Sabre MSI normalized field mapping across adapters.
+3. Default timezone when `ttl_timezone` omitted (agency vs origin airport vs BSP market).
+4. Whether legitimate passive-for-ticketing (host claim / airline-held PNR) should warn instead of block when an airline record locator claim is present — needs claim-flow design, not a guess.
+5. Confirm Sabre vs Amadeus **GK** semantics in each adapter's normalized status before treating GK as interchangeable across hosts.
+6. When `gds` is UNKNOWN, host-specific codes are ignored (core only) — should UNKNOWN emit a warning instead of silent skip?
diff --git a/packages/agents/settlement/src/adm-prevention/__tests__/adm-prevention.test.ts b/packages/agents/settlement/src/adm-prevention/__tests__/adm-prevention.test.ts
index a7bb646..85ffd08 100644
--- a/packages/agents/settlement/src/adm-prevention/__tests__/adm-prevention.test.ts
+++ b/packages/agents/settlement/src/adm-prevention/__tests__/adm-prevention.test.ts
@@ -1,12 +1,19 @@
 /**
  * ADM Prevention — Unit Tests
  *
- * Agent 6.2: 9 pre-ticketing audit checks.
+ * Agent 6.2: 10 pre-ticketing audit checks.
+ * Domain: docs/knowledge-base/adm-prevention.md
  */
 
+import { readFileSync, readdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { describe, it, expect, beforeAll, afterAll } from 'vitest';
-import { ADMPrevention } from '../index.js';
-import type { ADMPreventionInput, BookingRecord, BookingSegment } from '../types.js';
+import { ADMPrevention, ADM_CHECK_COUNT, CORE_BLOCKING_STATUSES } from '../index.js';
+import type { ADMPreventionInput, BookingRecord, BookingSegment, ADMCheckId } from '../types.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const FIXTURES_DIR = join(__dirname, 'fixtures');
 
 let agent: ADMPrevention;
 
@@ -135,7 +142,7 @@ describe('ADM Prevention', () => {
     });
   });
 
-  describe('Check 3: Passive segment abuse', () => {
+  describe('Check 3: Passive / unable / risky status', () => {
     it('passes with active segments', async () => {
       const result = await agent.execute({ data: makeInput() });
       const check = result.data.result.checks.find((c) => c.check_id === 'PASSIVE_SEGMENT');
@@ -159,9 +166,196 @@ describe('ADM Prevention', () => {
       const check = result.data.result.checks.find((c) => c.check_id === 'PASSIVE_SEGMENT');
       expect(check!.passed).toBe(false);
     });
+
+    it('fails with core set UC / NO / TK', async () => {
+      expect([...CORE_BLOCKING_STATUSES].sort()).toEqual(['HX', 'NO', 'TK', 'UC', 'UN'].sort());
+      for (const status of ['UC', 'NO', 'TK'] as const) {
+        const input = makeInput({
+          booking: makeBooking({ segments: [makeSegment({ status })] }),
+        });
+        const result = await agent.execute({ data: input });
+        const check = result.data.result.checks.find((c) => c.check_id === 'PASSIVE_SEGMENT');
+        expect(check!.passed).toBe(false);
+        expect(check!.reason).toContain(status);
+      }
+    });
+
+    it('fails with Amadeus HN pending need when gds is AMADEUS', async () => {
+      const input = makeInput({
+        gds: 'AMADEUS',
+        booking: makeBooking({ segments: [makeSegment({ status: 'HN' })] }),
+      });
+      const result = await agent.execute({ data: input });
+      const check = result.data.result.checks.find((c) => c.check_id === 'PASSIVE_SEGMENT');
+      expect(check!.passed).toBe(false);
+      expect(check!.reason).toMatch(/AMADEUS/i);
+    });
+
+    it('does not treat HN as universal when gds is omitted', async () => {
+      const input = makeInput({
+        booking: makeBooking({ segments: [makeSegment({ status: 'HN' })] }),
+      });
+      const result = await agent.execute({ data: input });
+      const check = result.data.result.checks.find((c) => c.check_id === 'PASSIVE_SEGMENT');
+      expect(check!.passed).toBe(true);
+    });
+
+    it('fails with Amadeus passive PK when gds is AMADEUS', async () => {
+      const input = makeInput({
+        gds: 'AMADEUS',
+        booking: makeBooking({ segments: [makeSegment({ status: 'PK' })] }),
+      });
+      const result = await agent.execute({ data: input });
+      const check = result.data.result.checks.find((c) => c.check_id === 'PASSIVE_SEGMENT');
+      expect(check!.passed).toBe(false);
+      expect(check!.reason).toMatch(/AMADEUS/i);
+    });
+
+    it('does not treat PK/GK/YK as universal when gds is omitted', async () => {
+      for (const status of ['PK', 'GK', 'YK'] as const) {
+        const input = makeInput({
+          booking: makeBooking({ segments: [makeSegment({ status })] }),
+        });
+        const result = await agent.execute({ data: input });
+        const check = result.data.result.checks.find((c) => c.check_id === 'PASSIVE_SEGMENT');
+        expect(check!.passed).toBe(true);
+      }
+    });
+
+    it('fails with Sabre YK only when gds is SABRE', async () => {
+      const withoutHost = makeInput({
+        booking: makeBooking({ segments: [makeSegment({ status: 'YK' })] }),
+      });
+      const withSabre = makeInput({
+        gds: 'SABRE',
+        booking: makeBooking({ segments: [makeSegment({ status: 'YK' })] }),
+      });
+      expect(
+        (await agent.execute({ data: withoutHost })).data.result.checks.find(
+          (c) => c.check_id === 'PASSIVE_SEGMENT',
+        )!.passed,
+      ).toBe(true);
+      expect(
+        (await agent.execute({ data: withSabre })).data.result.checks.find(
+          (c) => c.check_id === 'PASSIVE_SEGMENT',
+        )!.passed,
+      ).toBe(false);
+    });
+
+    it('notes Travelport needs no ticketing field', async () => {
+      const input = makeInput({
+        gds: 'TRAVELPORT',
+        booking: makeBooking({ segments: [makeSegment({ status: 'UC' })] }),
+      });
+      const result = await agent.execute({ data: input });
+      const check = result.data.result.checks.find((c) => c.check_id === 'PASSIVE_SEGMENT');
+      expect(check!.passed).toBe(false);
+      expect(check!.reason).toMatch(/no ticketing field/i);
+    });
+  });
+
+  describe('Check 4: Churning (history-required)', () => {
+    it('skips when no segment history (does not assume clear from HK alone)', async () => {
+      const result = await agent.execute({ data: makeInput() });
+      const check = result.data.result.checks.find((c) => c.check_id === 'CHURNING');
+      expect(check!.passed).toBe(true);
+      expect(check!.reason).toMatch(/skipped/i);
+      expect(check!.reason).toMatch(/history/i);
+    });
+
+    it('fails when history shows cancel→rebook cycles on same flight', async () => {
+      const input = makeInput({
+        segment_history: [
+          {
+            timestamp: '2026-03-28T08:00:00Z',
+            action: 'BOOKED',
+            carrier: 'BA',
+            flight_number: '115',
+            departure_date: '2026-06-15',
+          },
+          {
+            timestamp: '2026-03-28T10:00:00Z',
+            action: 'CANCELLED',
+            carrier: 'BA',
+            flight_number: '115',
+            departure_date: '2026-06-15',
+          },
+          {
+            timestamp: '2026-03-28T10:05:00Z',
+            action: 'REBOOKED',
+            carrier: 'BA',
+            flight_number: '115',
+            departure_date: '2026-06-15',
+          },
+          {
+            timestamp: '2026-03-29T09:00:00Z',
+            action: 'CANCELLED',
+            carrier: 'BA',
+            flight_number: '115',
+            departure_date: '2026-06-15',
+          },
+          {
+            timestamp: '2026-03-29T09:10:00Z',
+            action: 'REBOOKED',
+            carrier: 'BA',
+            flight_number: '115',
+            departure_date: '2026-06-15',
+          },
+          {
+            timestamp: '2026-03-30T11:00:00Z',
+            action: 'CANCELLED',
+            carrier: 'BA',
+            flight_number: '115',
+            departure_date: '2026-06-15',
+          },
+          {
+            timestamp: '2026-03-30T11:15:00Z',
+            action: 'REBOOKED',
+            carrier: 'BA',
+            flight_number: '115',
+            departure_date: '2026-06-15',
+          },
+        ],
+      });
+      const result = await agent.execute({ data: input });
+      const check = result.data.result.checks.find((c) => c.check_id === 'CHURNING');
+      expect(check!.passed).toBe(false);
+      expect(check!.severity).toBe('blocking');
+    });
+
+    it('passes when history has fewer than threshold cycles', async () => {
+      const input = makeInput({
+        segment_history: [
+          {
+            timestamp: '2026-03-28T08:00:00Z',
+            action: 'BOOKED',
+            carrier: 'BA',
+            flight_number: '115',
+            departure_date: '2026-06-15',
+          },
+          {
+            timestamp: '2026-03-28T10:00:00Z',
+            action: 'CANCELLED',
+            carrier: 'BA',
+            flight_number: '115',
+            departure_date: '2026-06-15',
+          },
+          {
+            timestamp: '2026-03-28T10:05:00Z',
+            action: 'REBOOKED',
+            carrier: 'BA',
+            flight_number: '115',
+            departure_date: '2026-06-15',
+          },
+        ],
+      });
+      const result = await agent.execute({ data: input });
+      const check = result.data.result.checks.find((c) => c.check_id === 'CHURNING');
+      expect(check!.passed).toBe(true);
+    });
   });
 
-  describe('Check 4: Married segment integrity', () => {
+  describe('Check 5: Married segment integrity', () => {
     it('passes when married segments have same status', async () => {
       const input = makeInput({
         booking: makeBooking({
@@ -189,9 +383,22 @@ describe('ADM Prevention', () => {
       const check = result.data.result.checks.find((c) => c.check_id === 'MARRIED_SEGMENT');
       expect(check!.passed).toBe(false);
     });
+
+    it('fails Travelport DX as marriage break (no ticketing field)', async () => {
+      const input = makeInput({
+        gds: 'TRAVELPORT',
+        booking: makeBooking({
+          segments: [makeSegment({ status: 'DX', married_group: 'M1' })],
+        }),
+      });
+      const result = await agent.execute({ data: input });
+      const check = result.data.result.checks.find((c) => c.check_id === 'MARRIED_SEGMENT');
+      expect(check!.passed).toBe(false);
+      expect(check!.reason).toMatch(/Travelport DX/i);
+    });
   });
 
-  describe('Check 5: TTL expired', () => {
+  describe('Check 6: TTL expired', () => {
     it('passes when TTL is in the future', async () => {
       const input = makeInput({ ttl_deadline: '2026-04-02T12:00:00Z' });
       const result = await agent.execute({ data: input });
@@ -219,9 +426,22 @@ describe('ADM Prevention', () => {
       expect(check!.passed).toBe(true);
       expect(check!.reason).toContain('skipped');
     });
+
+    it('fails on local deadline-day even when UTC has remaining hours', async () => {
+      const input = makeInput({
+        current_datetime: '2026-04-01T16:00:00Z',
+        ttl_deadline: '2026-04-02T00:00:00Z',
+        ttl_timezone: 'America/New_York',
+        ttl_source: 'BOOKING',
+      });
+      const result = await agent.execute({ data: input });
+      const check = result.data.result.checks.find((c) => c.check_id === 'TTL_EXPIRED');
+      expect(check!.passed).toBe(false);
+      expect(check!.reason).toMatch(/deadline-day/i);
+    });
   });
 
-  describe('Check 6: Commission rate', () => {
+  describe('Check 7: Commission rate', () => {
     it('passes when commission within contracted rate', async () => {
       const input = makeInput({ commission_rate: 5, carrier_contracted_rate: 7 });
       const result = await agent.execute({ data: input });
@@ -236,15 +456,16 @@ describe('ADM Prevention', () => {
       expect(check!.passed).toBe(false);
     });
 
-    it('skips when no commission data', async () => {
+    it('skips when no commission data and does not embed carrier tables', async () => {
       const result = await agent.execute({ data: makeInput() });
       const check = result.data.result.checks.find((c) => c.check_id === 'COMMISSION_RATE');
       expect(check!.passed).toBe(true);
-      expect(check!.reason).toContain('skipped');
+      expect(check!.reason).toMatch(/skipped/i);
+      expect(check!.reason).toMatch(/no embedded carrier commission tables/i);
     });
   });
 
-  describe('Check 7: Endorsement box', () => {
+  describe('Check 8: Endorsement box', () => {
     it('warns when restricted fare has no endorsement', async () => {
       const result = await agent.execute({ data: makeInput({ fare_basis: 'HOWUS' }) });
       const check = result.data.result.checks.find((c) => c.check_id === 'ENDORSEMENT_BOX');
@@ -268,7 +489,7 @@ describe('ADM Prevention', () => {
     });
   });
 
-  describe('Check 8: Tour code format', () => {
+  describe('Check 9: Tour code format', () => {
     it('passes with valid tour code', async () => {
       const result = await agent.execute({ data: makeInput({ tour_code: 'BT123ABC' }) });
       const check = result.data.result.checks.find((c) => c.check_id === 'TOUR_CODE_FORMAT');
@@ -295,7 +516,7 @@ describe('ADM Prevention', () => {
     });
   });
 
-  describe('Check 9: Net remit', () => {
+  describe('Check 10: Net remit', () => {
     it('passes when base fare within net contracted', async () => {
       const input = makeInput({ is_net_remit: true, net_contracted_amount: '500.00' });
       const result = await agent.execute({ data: input });
@@ -325,6 +546,47 @@ describe('ADM Prevention', () => {
     });
   });
 
+  describe('Scary false-negative fixtures', () => {
+    const files = readdirSync(FIXTURES_DIR).filter((f) => f.endsWith('.json'));
+
+    it('loads all five scary fixtures', () => {
+      expect(files.sort()).toEqual(
+        [
+          'churn-all-hk-now.json',
+          'ttl-deadline-day-tz.json',
+          'travelport-dx-marriage.json',
+          'uc-hn-passive-pk.json',
+          'uncleared-tk.json',
+        ].sort(),
+      );
+    });
+
+    for (const file of files) {
+      it(`encodes fixture ${file}`, async () => {
+        const raw = JSON.parse(readFileSync(join(FIXTURES_DIR, file), 'utf8')) as Record<
+          string,
+          unknown
+        >;
+        const expectMap = raw['expect'] as Record<string, boolean>;
+        const { expect: _e, _comment: _c, ...inputFields } = raw;
+        const result = await agent.execute({
+          data: inputFields as unknown as ADMPreventionInput,
+        });
+
+        expect(result.data.result.overall_pass).toBe(expectMap['overall_pass']);
+
+        for (const [checkId, passed] of Object.entries(expectMap)) {
+          if (checkId === 'overall_pass') continue;
+          const check = result.data.result.checks.find(
+            (c) => c.check_id === (checkId as ADMCheckId),
+          );
+          expect(check, `missing check ${checkId}`).toBeDefined();
+          expect(check!.passed).toBe(passed);
+        }
+      });
+    }
+  });
+
   describe('Overall result', () => {
     it('passes when all checks pass', async () => {
       const input = makeInput({
@@ -355,9 +617,10 @@ describe('ADM Prevention', () => {
       expect(result.data.result.warning_count).toBeGreaterThan(0);
     });
 
-    it('runs all 9 checks', async () => {
+    it(`runs all ${ADM_CHECK_COUNT} checks`, async () => {
       const result = await agent.execute({ data: makeInput() });
-      expect(result.data.result.checks).toHaveLength(9);
+      expect(result.data.result.checks).toHaveLength(ADM_CHECK_COUNT);
+      expect(ADM_CHECK_COUNT).toBe(10);
     });
   });
 
@@ -403,7 +666,7 @@ describe('ADM Prevention', () => {
     it('returns metadata in output', async () => {
       const result = await agent.execute({ data: makeInput() });
       expect(result.metadata!['agent_id']).toBe('6.2');
-      expect(result.metadata!['checks_run']).toBe(9);
+      expect(result.metadata!['checks_run']).toBe(ADM_CHECK_COUNT);
     });
 
     it('warns on blocking issues', async () => {
diff --git a/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/churn-all-hk-now.json b/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/churn-all-hk-now.json
new file mode 100644
index 0000000..b01dee2
--- /dev/null
+++ b/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/churn-all-hk-now.json
@@ -0,0 +1,88 @@
+{
+  "_comment": "SCARY FALSE NEGATIVE: all current statuses HK — HX/UN/NO-only scanners pass. History shows 3 cancel→rebook cycles (churning).",
+  "gds": "AMADEUS",
+  "current_datetime": "2026-04-01T12:00:00Z",
+  "fare_basis": "HOWUS",
+  "booked_class": "H",
+  "endorsement": "NON-ENDO/NON-REF",
+  "booking": {
+    "record_locator": "CHURN1",
+    "passenger_name": "SMITH/JOHN",
+    "base_fare": "450.00",
+    "base_fare_currency": "USD",
+    "segments": [
+      {
+        "carrier": "BA",
+        "flight_number": "115",
+        "origin": "LHR",
+        "destination": "JFK",
+        "departure_date": "2026-06-15",
+        "status": "HK",
+        "booking_class": "H"
+      }
+    ]
+  },
+  "segment_history": [
+    {
+      "timestamp": "2026-03-28T08:00:00Z",
+      "action": "BOOKED",
+      "carrier": "BA",
+      "flight_number": "115",
+      "departure_date": "2026-06-15",
+      "status": "HK"
+    },
+    {
+      "timestamp": "2026-03-28T10:00:00Z",
+      "action": "CANCELLED",
+      "carrier": "BA",
+      "flight_number": "115",
+      "departure_date": "2026-06-15",
+      "status": "XX"
+    },
+    {
+      "timestamp": "2026-03-28T10:05:00Z",
+      "action": "REBOOKED",
+      "carrier": "BA",
+      "flight_number": "115",
+      "departure_date": "2026-06-15",
+      "status": "HK"
+    },
+    {
+      "timestamp": "2026-03-29T09:00:00Z",
+      "action": "CANCELLED",
+      "carrier": "BA",
+      "flight_number": "115",
+      "departure_date": "2026-06-15",
+      "status": "XX"
+    },
+    {
+      "timestamp": "2026-03-29T09:10:00Z",
+      "action": "REBOOKED",
+      "carrier": "BA",
+      "flight_number": "115",
+      "departure_date": "2026-06-15",
+      "status": "HK"
+    },
+    {
+      "timestamp": "2026-03-30T11:00:00Z",
+      "action": "CANCELLED",
+      "carrier": "BA",
+      "flight_number": "115",
+      "departure_date": "2026-06-15",
+      "status": "XX"
+    },
+    {
+      "timestamp": "2026-03-30T11:15:00Z",
+      "action": "REBOOKED",
+      "carrier": "BA",
+      "flight_number": "115",
+      "departure_date": "2026-06-15",
+      "status": "HK"
+    }
+  ],
+  "expect": {
+    "CHURNING": false,
+    "PASSIVE_SEGMENT": true,
+    "overall_pass": false
+  }
+}
diff --git a/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/travelport-dx-marriage.json b/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/travelport-dx-marriage.json
new file mode 100644
index 0000000..4a7f757
--- /dev/null
+++ b/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/travelport-dx-marriage.json
@@ -0,0 +1,41 @@
+{
+  "_comment": "SCARY FALSE NEGATIVE: Travelport DX broken-marriage signal. Status alone — no ticketing field required.",
+  "gds": "TRAVELPORT",
+  "current_datetime": "2026-04-01T12:00:00Z",
+  "fare_basis": "HOWUS",
+  "booked_class": "H",
+  "endorsement": "NON-ENDO/NON-REF",
+  "booking": {
+    "record_locator": "DXMARR",
+    "passenger_name": "SMITH/JOHN",
+    "base_fare": "450.00",
+    "base_fare_currency": "USD",
+    "segments": [
+      {
+        "carrier": "UA",
+        "flight_number": "900",
+        "origin": "ORD",
+        "destination": "LHR",
+        "departure_date": "2026-09-01",
+        "status": "DX",
+        "booking_class": "H",
+        "married_group": "M1"
+      },
+      {
+        "carrier": "UA",
+        "flight_number": "901",
+        "origin": "LHR",
+        "destination": "FRA",
+        "departure_date": "2026-09-01",
+        "status": "HK",
+        "booking_class": "H",
+        "married_group": "M1"
+      }
+    ]
+  },
+  "expect": {
+    "MARRIED_SEGMENT": false,
+    "PASSIVE_SEGMENT": false,
+    "overall_pass": false
+  }
+}
diff --git a/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/ttl-deadline-day-tz.json b/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/ttl-deadline-day-tz.json
new file mode 100644
index 0000000..460e18a
--- /dev/null
+++ b/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/ttl-deadline-day-tz.json
@@ -0,0 +1,32 @@
+{
+  "_comment": "SCARY FALSE NEGATIVE: UTC still has ~8h until deadline, but local calendar date in America/New_York equals deadline day — same-day-of-deadline ADM risk.",
+  "gds": "SABRE",
+  "current_datetime": "2026-04-01T16:00:00Z",
+  "ttl_deadline": "2026-04-02T00:00:00Z",
+  "ttl_timezone": "America/New_York",
+  "ttl_source": "BOOKING",
+  "fare_basis": "HOWUS",
+  "booked_class": "H",
+  "endorsement": "NON-ENDO/NON-REF",
+  "booking": {
+    "record_locator": "TTLDAY",
+    "passenger_name": "SMITH/JOHN",
+    "base_fare": "450.00",
+    "base_fare_currency": "USD",
+    "segments": [
+      {
+        "carrier": "BA",
+        "flight_number": "115",
+        "origin": "LHR",
+        "destination": "JFK",
+        "departure_date": "2026-06-15",
+        "status": "HK",
+        "booking_class": "H"
+      }
+    ]
+  },
+  "expect": {
+    "TTL_EXPIRED": false,
+    "overall_pass": false
+  }
+}
diff --git a/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/uc-hn-passive-pk.json b/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/uc-hn-passive-pk.json
new file mode 100644
index 0000000..f0173b7
--- /dev/null
+++ b/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/uc-hn-passive-pk.json
@@ -0,0 +1,47 @@
+{
+  "_comment": "SCARY FALSE NEGATIVE: Amadeus UC + HN + PK — beyond HX/UN/NO. HN/PK are Amadeus host-specific (not a universal IATA meaning).",
+  "gds": "AMADEUS",
+  "current_datetime": "2026-04-01T12:00:00Z",
+  "fare_basis": "HOWUS",
+  "booked_class": "H",
+  "endorsement": "NON-ENDO/NON-REF",
+  "booking": {
+    "record_locator": "UCPK01",
+    "passenger_name": "SMITH/JOHN",
+    "base_fare": "450.00",
+    "base_fare_currency": "USD",
+    "segments": [
+      {
+        "carrier": "AF",
+        "flight_number": "10",
+        "origin": "CDG",
+        "destination": "JFK",
+        "departure_date": "2026-08-01",
+        "status": "UC",
+        "booking_class": "H"
+      },
+      {
+        "carrier": "AF",
+        "flight_number": "11",
+        "origin": "JFK",
+        "destination": "CDG",
+        "departure_date": "2026-08-15",
+        "status": "HN",
+        "booking_class": "H"
+      },
+      {
+        "carrier": "AF",
+        "flight_number": "12",
+        "origin": "CDG",
+        "destination": "LYS",
+        "departure_date": "2026-08-16",
+        "status": "PK",
+        "booking_class": "H"
+      }
+    ]
+  },
+  "expect": {
+    "PASSIVE_SEGMENT": false,
+    "overall_pass": false
+  }
+}
diff --git a/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/uncleared-tk.json b/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/uncleared-tk.json
new file mode 100644
index 0000000..9abb4a6
--- /dev/null
+++ b/packages/agents/settlement/src/adm-prevention/__tests__/fixtures/uncleared-tk.json
@@ -0,0 +1,29 @@
+{
+  "_comment": "SCARY FALSE NEGATIVE: uncleared TK schedule-change — not in classic HX/UN/NO-only sets. Core host set is HX/UC/UN/NO/TK.",
+  "gds": "SABRE",
+  "current_datetime": "2026-04-01T12:00:00Z",
+  "fare_basis": "HOWUS",
+  "booked_class": "H",
+  "endorsement": "NON-ENDO/NON-REF",
+  "booking": {
+    "record_locator": "TKONLY",
+    "passenger_name": "SMITH/JOHN",
+    "base_fare": "450.00",
+    "base_fare_currency": "USD",
+    "segments": [
+      {
+        "carrier": "AA",
+        "flight_number": "100",
+        "origin": "DFW",
+        "destination": "LHR",
+        "departure_date": "2026-07-01",
+        "status": "TK",
+        "booking_class": "H"
+      }
+    ]
+  },
+  "expect": {
+    "PASSIVE_SEGMENT": false,
+    "overall_pass": false
+  }
+}
diff --git a/packages/agents/settlement/src/adm-prevention/audit-engine.ts b/packages/agents/settlement/src/adm-prevention/audit-engine.ts
index e01d144..b9af008 100644
--- a/packages/agents/settlement/src/adm-prevention/audit-engine.ts
+++ b/packages/agents/settlement/src/adm-prevention/audit-engine.ts
@@ -1,5 +1,12 @@
 /**
- * ADM Prevention Engine — 9 pre-ticketing audit checks.
+ * ADM Prevention Engine — pre-ticketing audit checks.
+ *
+ * Domain source: docs/knowledge-base/adm-prevention.md
+ * - IATA Reso 850m = ADM memo windows/dispute (Agent 6.3), not status rules
+ * - Passive/UC/churn = carrier booking policy + host statuses (HX/UC/UN/NO/TK + extended)
+ * - Travelport: those statuses do not need a ticketing field
+ * - Churning requires segment history
+ * - No carrier-secret commission tables
  */
 
 import Decimal from 'decimal.js';
@@ -8,7 +15,14 @@ import type {
   ADMPreventionOutput,
   ADMPreventionResult,
   ADMCheck,
+  SegmentHistoryEvent,
 } from './types.js';
+import {
+  isBlockingSegmentStatus,
+  isTravelportMarriageBreakStatus,
+  DEFAULT_CHURN_CYCLE_THRESHOLD,
+  DEFAULT_CHURN_WINDOW_HOURS,
+} from './status-codes.js';
 
 // Fare basis first-character to expected booking class mapping
 // This is a simplified mapping — real ATPCO mappings are far more complex
@@ -49,6 +63,29 @@ function currentTime(input: ADMPreventionInput): Date {
   return input.current_datetime ? new Date(input.current_datetime) : new Date();
 }
 
+function flightKey(carrier: string, flight: string, date: string): string {
+  return `${carrier.toUpperCase()}|${flight}|${date}`;
+}
+
+/**
+ * Calendar date (YYYY-MM-DD) in an IANA timezone for an instant.
+ * Used for deadline-day ADM risk — not a substitute for carrier TTL rules.
+ */
+function localCalendarDate(isoInstant: string, timeZone: string): string | null {
+  try {
+    const fmt = new Intl.DateTimeFormat('en-CA', {
+      timeZone,
+      year: 'numeric',
+      month: '2-digit',
+      day: '2-digit',
+    });
+    return fmt.format(new Date(isoInstant));
+  } catch {
+    // TODO: DOMAIN_QUESTION: invalid ttl_timezone handling — fail open vs block
+    return null;
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Individual checks
 // ---------------------------------------------------------------------------
@@ -108,20 +145,102 @@ function checkFareClassMismatch(input: ADMPreventionInput): ADMCheck {
   return check;
 }
 
+/**
+ * Passive / unable / schedule-change / pending statuses.
+ * Core set HX/UC/UN/NO/TK applies cross-host.
+ * HN/PK/GK/YK and other extended codes apply only via per-host maps
+ * (not one universal IATA meaning). Travelport: status alone is enough —
+ * no ticketing field required.
+ */
 function checkPassiveSegments(input: ADMPreventionInput): ADMCheck {
   const check: ADMCheck = {
     check_id: 'PASSIVE_SEGMENT',
-    name: 'Passive Segment Abuse',
+    name: 'Passive / Unable / Risky Status',
     severity: 'blocking',
     passed: true,
-    reason: 'No passive segments found.',
+    reason: 'No passive, unable, or uncleared risky statuses found.',
   };
 
-  const passiveStatuses = new Set(['HX', 'UN', 'NO', 'UC']);
   for (const seg of input.booking.segments) {
-    if (passiveStatuses.has(seg.status)) {
+    const verdict = isBlockingSegmentStatus(seg.status, input.gds);
+    if (!verdict.blocking) continue;
+
+    const code = seg.status.toUpperCase();
+    const travelportNote =
+      verdict.host === 'TRAVELPORT'
+        ? ' Travelport: status alone is sufficient (no ticketing field required).'
+        : '';
+
+    check.passed = false;
+    if (verdict.scope === 'core') {
+      check.reason = `Risky host status: ${seg.carrier}${seg.flight_number} status ${code} (core set HX/UC/UN/NO/TK) — must be cleared before ticketing.${travelportNote}`;
+    } else {
+      check.reason = `Risky ${verdict.host} host status: ${seg.carrier}${seg.flight_number} status ${code} — host-specific passive/pending/cancel residue (not a universal IATA code meaning) — must be removed before ticketing.${travelportNote}`;
+    }
+    return check;
+  }
+
+  return check;
+}
+
+/**
+ * Churning: book→cancel→rebook cycles. Requires segment_history.
+ * Current HK-only status is a classic false negative without history.
+ */
+function checkChurning(input: ADMPreventionInput): ADMCheck {
+  const check: ADMCheck = {
+    check_id: 'CHURNING',
+    name: 'Churning Detection',
+    severity: 'blocking',
+    passed: true,
+    reason: 'No churning pattern detected.',
+  };
+
+  const history = input.segment_history;
+  if (!history || history.length === 0) {
+    check.reason =
+      'No segment history provided — churning skipped (cannot detect from current status alone).';
+    return check;
+  }
+
+  const threshold = input.churn_cycle_threshold ?? DEFAULT_CHURN_CYCLE_THRESHOLD;
+  const windowHours = input.churn_window_hours ?? DEFAULT_CHURN_WINDOW_HOURS;
+  const windowMs = windowHours * 60 * 60 * 1000;
+
+  const byFlight = new Map<string, SegmentHistoryEvent[]>();
+  for (const event of history) {
+    const key = flightKey(event.carrier, event.flight_number, event.departure_date);
+    const list = byFlight.get(key) ?? [];
+    list.push(event);
+    byFlight.set(key, list);
+  }
+
+  for (const [key, events] of byFlight) {
+    const sorted = [...events].sort(
+      (a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime(),
+    );
+
+    let cycles = 0;
+    let lastCancelAt: number | null = null;
+
+    for (const event of sorted) {
+      const t = new Date(event.timestamp).getTime();
+      if (event.action === 'CANCELLED') {
+        lastCancelAt = t;
+      } else if (
+        (event.action === 'REBOOKED' || event.action === 'BOOKED') &&
+        lastCancelAt != null &&
+        t - lastCancelAt <= windowMs &&
+        t >= lastCancelAt
+      ) {
+        cycles += 1;
+        lastCancelAt = null;
+      }
+    }
+
+    if (cycles >= threshold) {
       check.passed = false;
-      check.reason = `Passive segment: ${seg.carrier}${seg.flight_number} status ${seg.status} — must be removed before ticketing.`;
+      check.reason = `Churning: ${cycles} cancel→rebook cycles on ${key.replace(/\|/g, ' ')} within ${windowHours}h (threshold ${threshold}). Current status alone is insufficient — history required.`;
       return check;
     }
   }
@@ -138,20 +257,44 @@ function checkMarriedSegments(input: ADMPreventionInput): ADMCheck {
     reason: 'Married segments are consistent.',
   };
 
-  const groups = new Map<string, string[]>();
+  // Travelport-specific: DX is a broken-marriage / marriage-integrity signal
+  // (public Travelport status table). No separate ticketing field required.
+  if (input.gds === 'TRAVELPORT') {
+    for (const seg of input.booking.segments) {
+      if (isTravelportMarriageBreakStatus(seg.status)) {
+        check.passed = false;
+        check.reason = `Travelport DX on ${seg.carrier}${seg.flight_number}: broken marriage / marriage-integrity risk — do not ticket until marriage is restored or properly authorized.`;
+        return check;
+      }
+    }
+  }
+
+  const groups = new Map<string, typeof input.booking.segments>();
   for (const seg of input.booking.segments) {
     if (seg.married_group) {
-      const statuses = groups.get(seg.married_group) ?? [];
-      statuses.push(seg.status);
-      groups.set(seg.married_group, statuses);
+      const list = groups.get(seg.married_group) ?? [];
+      list.push(seg);
+      groups.set(seg.married_group, list);
     }
   }
 
-  for (const [group, statuses] of groups) {
-    const unique = new Set(statuses);
-    if (unique.size > 1) {
+  if (groups.size === 0) {
+    check.reason =
+      'No married_group markers on segments — skipped. (Sabre MSI / Amadeus marriage / Travelport group must be mapped by the adapter.)';
+    return check;
+  }
+
+  for (const [group, segs] of groups) {
+    if (segs.length < 2) {
       check.passed = false;
-      check.reason = `Married group ${group} has mixed statuses: ${[...unique].join(', ')} — must be identical.`;
+      check.reason = `Married group ${group} has only ${segs.length} segment — incomplete marriage (possible break).`;
+      return check;
+    }
+
+    const statuses = new Set(segs.map((s) => s.status.toUpperCase()));
+    if (statuses.size > 1) {
+      check.passed = false;
+      check.reason = `Married group ${group} has mixed statuses: ${[...statuses].join(', ')} — must be identical (GDS marriage integrity).`;
       return check;
     }
   }
@@ -176,13 +319,29 @@ function checkTtlExpired(input: ADMPreventionInput): ADMCheck {
   const now = currentTime(input);
   const deadline = new Date(input.ttl_deadline);
   const minutesRemaining = (deadline.getTime() - now.getTime()) / (1000 * 60);
+  const sourceNote = input.ttl_source ? ` (TTL source: ${input.ttl_source})` : '';
 
   if (minutesRemaining < 0) {
     check.passed = false;
-    check.reason = `TTL expired at ${input.ttl_deadline} — cannot ticket.`;
-  } else if (minutesRemaining < TTL_BUFFER_MINUTES) {
+    check.reason = `TTL expired at ${input.ttl_deadline}${sourceNote} — cannot ticket.`;
+    return check;
+  }
+
+  // Deadline-day risk: same local calendar date as deadline is ADM-prone
+  // even when UTC still shows remaining hours.
+  if (input.ttl_timezone && input.current_datetime) {
+    const nowLocal = localCalendarDate(input.current_datetime, input.ttl_timezone);
+    const deadlineLocal = localCalendarDate(input.ttl_deadline, input.ttl_timezone);
+    if (nowLocal && deadlineLocal && nowLocal === deadlineLocal) {
+      check.passed = false;
+      check.reason = `TTL deadline-day risk: current local date ${nowLocal} in ${input.ttl_timezone} equals deadline date — carriers commonly ADM same-day-of-deadline issuance${sourceNote}.`;
+      return check;
+    }
+  }
+
+  if (minutesRemaining < TTL_BUFFER_MINUTES) {
     check.passed = false;
-    check.reason = `TTL expires in ${Math.round(minutesRemaining)} minutes (< ${TTL_BUFFER_MINUTES}min buffer) — risk of expiry during ticketing.`;
+    check.reason = `TTL expires in ${Math.round(minutesRemaining)} minutes (< ${TTL_BUFFER_MINUTES}min buffer) — risk of expiry during ticketing${sourceNote}.`;
   }
 
   return check;
@@ -197,8 +356,10 @@ function checkCommissionRate(input: ADMPreventionInput): ADMCheck {
     reason: 'Commission rate is within contracted limits.',
   };
 
+  // No carrier-secret commission tables in-repo — caller must supply both rates.
   if (input.commission_rate == null || input.carrier_contracted_rate == null) {
-    check.reason = 'Commission rate or contracted rate not provided — skipped.';
+    check.reason =
+      'Commission rate or contracted rate not provided — skipped (no embedded carrier commission tables).';
     return check;
   }
 
@@ -287,11 +448,15 @@ function checkNetRemit(input: ADMPreventionInput): ADMCheck {
 // Main engine
 // ---------------------------------------------------------------------------
 
+/** Number of audit checks run by Agent 6.2 (includes CHURNING). */
+export const ADM_CHECK_COUNT = 10;
+
 export function runAudit(input: ADMPreventionInput): ADMPreventionOutput {
   const checks: ADMCheck[] = [
     checkDuplicateBooking(input),
     checkFareClassMismatch(input),
     checkPassiveSegments(input),
+    checkChurning(input),
     checkMarriedSegments(input),
     checkTtlExpired(input),
     checkCommissionRate(input),
diff --git a/packages/agents/settlement/src/adm-prevention/index.ts b/packages/agents/settlement/src/adm-prevention/index.ts
index c641e5d..916a024 100644
--- a/packages/agents/settlement/src/adm-prevention/index.ts
+++ b/packages/agents/settlement/src/adm-prevention/index.ts
@@ -1,9 +1,10 @@
 /**
  * ADM Prevention — Agent 6.2
  *
- * Pre-ticketing audit: 9 checks covering fare integrity,
- * segment validity, and compliance to prevent Agency Debit Memos.
+ * Pre-ticketing audit covering fare integrity, passive/UC/churning,
+ * married-segment integrity, TTL, and compliance to prevent ADMs.
  *
+ * Domain: docs/knowledge-base/adm-prevention.md
  * Implements the base Agent interface from @otaip/core.
  */
 
@@ -19,7 +20,7 @@ const CLASS_RE = /^[A-Z]$/;
 export class ADMPrevention implements Agent<ADMPreventionInput, ADMPreventionOutput> {
   readonly id = '6.2';
   readonly name = 'ADM Prevention';
-  readonly version = '0.1.0';
+  readonly version = '0.2.0';
 
   private initialized = false;
 
@@ -107,6 +108,16 @@ export class ADMPrevention implements Agent<ADMPreventionInput, ADMPreventionOut
   }
 }
 
+export { ADM_CHECK_COUNT } from './audit-engine.js';
+export {
+  CORE_BLOCKING_STATUSES,
+  HOST_BLOCKING_STATUSES,
+  isBlockingSegmentStatus,
+  isCoreBlockingStatus,
+  DEFAULT_CHURN_CYCLE_THRESHOLD,
+  DEFAULT_CHURN_WINDOW_HOURS,
+} from './status-codes.js';
+
 export type {
   ADMPreventionInput,
   ADMPreventionOutput,
@@ -117,4 +128,8 @@ export type {
   BookingRecord,
   BookingSegment,
   DuplicateCheckPnr,
+  SegmentHistoryEvent,
+  SegmentHistoryAction,
+  TtlSource,
+  GdsHost,
 } from './types.js';
diff --git a/packages/agents/settlement/src/adm-prevention/status-codes.ts b/packages/agents/settlement/src/adm-prevention/status-codes.ts
new file mode 100644
index 0000000..e7f4189
--- /dev/null
+++ b/packages/agents/settlement/src/adm-prevention/status-codes.ts
@@ -0,0 +1,116 @@
+/**
+ * ADM Prevention — GDS host status matrices
+ *
+ * Source: docs/knowledge-base/adm-prevention.md
+ * (IATA Reso 850m = ADM memo process only; passive/UC/churn = carrier
+ * booking policy + host statuses.)
+ *
+ * Do NOT treat HN / PK / GK / YK as one universal IATA meaning — they are
+ * host-specific. Only the core set applies without a known `gds`.
+ */
+
+export type GdsHost = 'SABRE' | 'AMADEUS' | 'TRAVELPORT' | 'UNKNOWN';
+
+/**
+ * Cross-host core blocking advice/status codes from carrier booking policy
+ * + shared host practice (HX/UC/UN/NO/TK). Not an IATA catalog of all codes.
+ */
+export const CORE_BLOCKING_STATUSES = ['HX', 'UC', 'UN', 'NO', 'TK'] as const;
+
+/**
+ * Per-host extended blocking codes from public GDS status/advice tables.
+ * Meanings differ by host — do not merge into a universal set.
+ *
+ * // TODO: DOMAIN_QUESTION: Confirm Sabre vs Amadeus GK semantics in each
+ * // adapter's normalized status before treating GK as interchangeable.
+ * // TODO: DOMAIN_QUESTION: When gds is UNKNOWN, host-specific codes are
+ * // ignored (core only). Should UNKNOWN warn instead of silent skip?
+ */
+export const HOST_BLOCKING_STATUSES: Readonly<Record<GdsHost, readonly string[]>> = {
+  AMADEUS: [
+    'HN', // Holding need (Amadeus status tables)
+    'PK', // Passive confirmed
+    'PL', // Passive waitlisted
+    'GK', // Confirmed ghost segment (Amadeus)
+    'GL', // Waitlisted ghost
+    'GN', // Ghost need
+    'UU', // Unable, have waitlisted
+    'US', // Unable to accept sale, have waitlisted
+    'XX', // Cancel residue
+  ],
+  SABRE: [
+    'YK', // Sabre administrative / itinerary passive (ops usage — not Amadeus PK)
+    'GK', // Sabre passive-for-ticketing usage (≠ Amadeus ghost semantics)
+    'HN', // Holding need when present on Sabre air
+    'XX', // Cancel residue
+  ],
+  TRAVELPORT: [
+    'HN', // Holds need/confirmed (Travelport table)
+    'AK', // Passive confirmed outside Galileo (1G)
+    'AL', // Passive waitlisted outside Galileo
+    'AN', // Passive requested outside Galileo
+    'BK', // Passive booked with carrier
+    'BL', // Passive waitlist
+    'DX', // Broken marriage / authorized partial cancel in marriage
+    'MK', // Non-messaging passive
+    'PS', // Passive
+    'ZK', // Passive API booking
+    'LK', // Passive link booking
+    'UU',
+    'US',
+    'XX',
+    'XK', // Cancel seg with change
+  ],
+  // Host-specific codes must not be applied without a known host.
+  UNKNOWN: [],
+};
+
+const CORE_SET = new Set<string>(CORE_BLOCKING_STATUSES);
+
+const HOST_SETS: Readonly<Record<GdsHost, ReadonlySet<string>>> = {
+  AMADEUS: new Set(HOST_BLOCKING_STATUSES.AMADEUS),
+  SABRE: new Set(HOST_BLOCKING_STATUSES.SABRE),
+  TRAVELPORT: new Set(HOST_BLOCKING_STATUSES.TRAVELPORT),
+  UNKNOWN: new Set(HOST_BLOCKING_STATUSES.UNKNOWN),
+};
+
+function resolveHost(gds: GdsHost | undefined): GdsHost {
+  return gds ?? 'UNKNOWN';
+}
+
+/** Core cross-host set only. */
+export function isCoreBlockingStatus(status: string): boolean {
+  return CORE_SET.has(status.toUpperCase());
+}
+
+/**
+ * True if status blocks ticketing for the given host.
+ * Without a known `gds`, only the core set (HX/UC/UN/NO/TK) applies —
+ * HN/PK/GK/YK and other host codes are not universalized.
+ */
+export function isBlockingSegmentStatus(
+  status: string,
+  gds?: GdsHost,
+): { blocking: boolean; scope: 'core' | 'host' | 'none'; host: GdsHost } {
+  const code = status.toUpperCase();
+  const host = resolveHost(gds);
+
+  if (CORE_SET.has(code)) {
+    return { blocking: true, scope: 'core', host };
+  }
+
+  if (host !== 'UNKNOWN' && HOST_SETS[host].has(code)) {
+    return { blocking: true, scope: 'host', host };
+  }
+
+  return { blocking: false, scope: 'none', host };
+}
+
+/** Travelport: DX indicates broken marriage / marriage integrity risk. */
+export function isTravelportMarriageBreakStatus(status: string): boolean {
+  return status.toUpperCase() === 'DX';
+}
+
+/** Default churn heuristic — overridable; not a carrier-secret table. */
+export const DEFAULT_CHURN_CYCLE_THRESHOLD = 3;
+export const DEFAULT_CHURN_WINDOW_HOURS = 72;
diff --git a/packages/agents/settlement/src/adm-prevention/types.ts b/packages/agents/settlement/src/adm-prevention/types.ts
index 2d540cf..58fd108 100644
--- a/packages/agents/settlement/src/adm-prevention/types.ts
+++ b/packages/agents/settlement/src/adm-prevention/types.ts
@@ -2,13 +2,21 @@
  * ADM Prevention — Types
  *
  * Agent 6.2: Pre-ticketing audit to prevent Agency Debit Memos.
- * Nine checks covering fare integrity, segment validity, and compliance.
+ * Checks cover fare integrity, segment validity (passive/UC/churn),
+ * married integrity, TTL, and compliance.
+ *
+ * Domain source: docs/knowledge-base/adm-prevention.md
  */
 
+import type { GdsHost } from './status-codes.js';
+
+export type { GdsHost };
+
 export type ADMCheckId =
   | 'DUPLICATE_BOOKING'
   | 'FARE_CLASS_MISMATCH'
   | 'PASSIVE_SEGMENT'
+  | 'CHURNING'
   | 'MARRIED_SEGMENT'
   | 'TTL_EXPIRED'
   | 'COMMISSION_RATE'
@@ -42,7 +50,7 @@ export interface BookingSegment {
   destination: string;
   /** Departure date (ISO) */
   departure_date: string;
-  /** Segment status (HK, KK, SS, HX, UN, etc.) */
+  /** Segment status (HK, KK, HX, UC, UN, NO, TK, …). Host-specific codes require `gds`. */
   status: string;
   /** Booked class */
   booking_class: string;
@@ -50,6 +58,31 @@ export interface BookingSegment {
   married_group?: string;
 }
 
+/**
+ * Historical segment event — required for churning detection.
+ * Current status alone cannot prove or disprove churn.
+ */
+export type SegmentHistoryAction = 'BOOKED' | 'CANCELLED' | 'REBOOKED';
+
+export interface SegmentHistoryEvent {
+  /** ISO timestamp of the event */
+  timestamp: string;
+  /** What happened */
+  action: SegmentHistoryAction;
+  /** Carrier */
+  carrier: string;
+  /** Flight number */
+  flight_number: string;
+  /** Departure date (ISO date) */
+  departure_date: string;
+  /** Origin (optional — strengthens identity match) */
+  origin?: string;
+  /** Destination (optional) */
+  destination?: string;
+  /** Status after the event, if known */
+  status?: string;
+}
+
 export interface DuplicateCheckPnr {
   /** Record locator */
   record_locator: string;
@@ -76,6 +109,9 @@ export interface BookingRecord {
   base_fare_currency: string;
 }
 
+/** Where the TTL value came from — affects messaging, not invented rules. */
+export type TtlSource = 'BOOKING' | 'FARE_QUOTE' | 'CARRIER_RULE' | 'UNKNOWN';
+
 export interface ADMPreventionInput {
   /** Booking record to audit */
   booking: BookingRecord;
@@ -83,9 +119,12 @@ export interface ADMPreventionInput {
   fare_basis: string;
   /** Booked class (single letter) */
   booked_class: string;
-  /** Commission rate on this ticket (percentage, e.g. 7.0) */
+  /**
+   * Commission rate on this ticket (percentage, e.g. 7.0).
+   * Compared only to caller-supplied contracted rate — no embedded carrier tables.
+   */
   commission_rate?: number;
-  /** Carrier's contracted commission rate (percentage) */
+  /** Carrier's contracted commission rate (percentage) — supplied by caller */
   carrier_contracted_rate?: number;
   /** Endorsement text on ticket */
   endorsement?: string;
@@ -97,10 +136,25 @@ export interface ADMPreventionInput {
   net_contracted_amount?: string;
   /** TTL deadline (ISO timestamp) */
   ttl_deadline?: string;
+  /** IANA timezone for deadline-day evaluation (e.g. America/New_York) */
+  ttl_timezone?: string;
+  /** How TTL was established */
+  ttl_source?: TtlSource;
   /** Other PNRs to check for duplicates */
   duplicate_check_pnrs?: DuplicateCheckPnr[];
   /** Current date/time (ISO — for TTL check) */
   current_datetime?: string;
+  /**
+   * Ordered segment history for churning detection.
+   * Without this, CHURNING is skipped (not assumed clear).
+   */
+  segment_history?: SegmentHistoryEvent[];
+  /** Host GDS — used for marriage-break signals (e.g. Travelport DX) */
+  gds?: GdsHost;
+  /** Override default churn cycle threshold (default 3) */
+  churn_cycle_threshold?: number;
+  /** Override default churn window in hours (default 72) */
+  churn_window_hours?: number;
 }
 
 export interface ADMPreventionResult {
diff --git a/packages/agents/settlement/src/index.ts b/packages/agents/settlement/src/index.ts
index 5c939d0..68250ce 100644
--- a/packages/agents/settlement/src/index.ts
+++ b/packages/agents/settlement/src/index.ts
@@ -25,7 +25,16 @@ export type {
 } from './refund-processing/index.js';
 export { WAIVER_EFFECTS } from './refund-processing/index.js';
 
-export { ADMPrevention } from './adm-prevention/index.js';
+export {
+  ADMPrevention,
+  ADM_CHECK_COUNT,
+  CORE_BLOCKING_STATUSES,
+  HOST_BLOCKING_STATUSES,
+  isBlockingSegmentStatus,
+  isCoreBlockingStatus,
+  DEFAULT_CHURN_CYCLE_THRESHOLD,
+  DEFAULT_CHURN_WINDOW_HOURS,
+} from './adm-prevention/index.js';
 export type {
   ADMPreventionInput,
   ADMPreventionOutput,
@@ -36,6 +45,10 @@ export type {
   BookingRecord,
   BookingSegment,
   DuplicateCheckPnr,
+  SegmentHistoryEvent,
+  SegmentHistoryAction,
+  TtlSource,
+  GdsHost,
 } from './adm-prevention/index.js';
 
 export { ADMACMProcessingAgent } from './adm-acm-processing/index.js';