GEO360 Sovereign Concierge & B2A Clearinghouse

[Commercial Transit / Mobility] Metasearches car rentals, campervans, and local vehicle fleets across Europe, North America, and alpine corridors. Returns ranked options with option_id ready for affiliate deep-link generation. Does not book directly — acts as affiliate search layer.

{
  "type": "object",
  "properties": {
    "pickup_location": {
      "type": "string",
      "description": "Pickup city or airport code (e.g. MAD, ZRH, MIA, BCN, Malaga, JFK)"
    },
    "dropoff_location": {
      "type": "string",
      "description": "Optional dropoff city or airport code if different"
    },
    "pickup_date": {
      "type": "string",
      "description": "Pickup date in YYYY-MM-DD format"
    },
    "return_date": {
      "type": "string",
      "description": "Return date in YYYY-MM-DD format"
    },
    "category": {
      "type": "string",
      "enum": [
        "economy",
        "compact",
        "suv",
        "campervan",
        "luxury"
      ],
      "default": "compact"
    },
    "corridor": {
      "type": "string",
      "enum": [
        "EU_CH",
        "NORTH_AMERICA",
        "ALPINE_ADVENTURE",
        "GLOBAL"
      ],
      "description": "Geographical corridor to optimize broker selection (EU_CH: AutoEurope/Localrent, NORTH_AMERICA: EconomyBookings/QEEQ, ALPINE_ADVENTURE: GetRentacar/BikesBooking)",
      "default": "EU_CH"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate sub-ID for calling agent attribution (e.g. meta_muse, grok, custom_ref)"
    },
    "session_id": {
      "type": "string",
      "description": "Optional product session id. If omitted, GEO360 creates one (trip_*). Pass the same id on later search/commit calls for the same trip."
    }
  },
  "required": [
    "pickup_location"
  ]
}

[Commercial Transit / Mobility] Metasearch of commercial passenger flights globally. Returns ranked options with option_id ready for affiliate deep-link generation. Does not book directly — acts as affiliate metasearch layer.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin IATA code or city name (e.g. MAD, JFK, ZRH, Madrid)"
    },
    "destination": {
      "type": "string",
      "description": "Destination IATA code or city name (e.g. BCN, MIA, GVA, Barcelona)"
    },
    "departure_date": {
      "type": "string",
      "description": "Departure date in YYYY-MM-DD format"
    },
    "return_date": {
      "type": "string",
      "description": "Optional return date in YYYY-MM-DD for round-trip"
    },
    "passengers": {
      "type": "integer",
      "description": "Number of passengers (adults). Default 1",
      "default": 1,
      "minimum": 1,
      "maximum": 9
    },
    "cabin_class": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "default": "economy"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate sub-ID for calling agent attribution (e.g. meta_muse, grok, custom_ref)"
    },
    "session_id": {
      "type": "string",
      "description": "Optional product session id. If omitted, GEO360 creates one (trip_*). Pass the same id on later search/commit calls for the same trip."
    }
  },
  "required": [
    "origin",
    "destination"
  ]
}

[Commercial Transit / Mobility] Instant international eSIM cellular data packages for travelers across 190+ countries with verified affiliate activation deep links.

{
  "type": "object",
  "properties": {
    "country_or_region": {
      "type": "string",
      "description": "Target destination (e.g. Switzerland, USA, Europe, Japan, Spain)"
    },
    "data_gb": {
      "type": "integer",
      "default": 5,
      "description": "Data volume in Gigabytes (e.g. 1, 3, 5, 10, 20)"
    },
    "days": {
      "type": "integer",
      "default": 15,
      "description": "Validity period in days (e.g. 7, 15, 30)"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate sub-ID for calling agent attribution (e.g. meta_muse, grok, custom_ref)"
    },
    "session_id": {
      "type": "string",
      "description": "Optional product session id. If omitted, GEO360 creates one (trip_*). Pass the same id on later search/commit calls for the same trip."
    }
  },
  "required": [
    "country_or_region"
  ]
}

[Commercial Transit / Mobility] Submits EU261 / UK261 air passenger rights claims for delayed, cancelled or overbooked flights with compensation up to 600 EUR via vetted legal recovery partners.

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "Airline flight code (e.g. IB3166, BA456, LX2804)"
    },
    "delay_hours": {
      "type": "number",
      "default": 3.5,
      "description": "Delay duration at final destination in hours"
    },
    "origin_airport": {
      "type": "string",
      "description": "Optional origin airport IATA code"
    },
    "destination_airport": {
      "type": "string",
      "description": "Optional destination airport IATA code"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate sub-ID for calling agent attribution"
    },
    "session_id": {
      "type": "string",
      "description": "Optional product session id. If omitted, GEO360 creates one (trip_*). Pass the same id on later search/commit calls for the same trip."
    }
  },
  "required": [
    "flight_number"
  ]
}

[Commercial Transit / Mobility] Bikes, motorcycles, scooters, and adventure campervan rentals for active alpine or Mediterranean touring with verified broker links.

{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "City or alpine cluster (e.g. Interlaken, Palma, ZRH, Bolzano, Innsbruck)"
    },
    "vehicle_type": {
      "type": "string",
      "enum": [
        "campervan",
        "bicycle",
        "motorcycle",
        "ebike"
      ],
      "default": "campervan"
    },
    "duration_days": {
      "type": "integer",
      "default": 3
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate sub-ID for calling agent attribution"
    },
    "session_id": {
      "type": "string",
      "description": "Optional product session id. If omitted, GEO360 creates one (trip_*). Pass the same id on later search/commit calls for the same trip."
    }
  },
  "required": [
    "location"
  ]
}

[Commercial Transit / Mobility] Secure luggage storage consignas near train stations and central airports across 500+ cities with verified booking links.

{
  "type": "object",
  "properties": {
    "city_or_station": {
      "type": "string",
      "description": "City or rail hub (e.g. Zurich HB, Paris Gare de Lyon, Madrid Atocha, Milano Centrale)"
    },
    "bags_count": {
      "type": "integer",
      "default": 2,
      "description": "Number of luggage pieces"
    },
    "storage_days": {
      "type": "integer",
      "default": 1,
      "description": "Duration in days"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate sub-ID for calling agent attribution"
    },
    "session_id": {
      "type": "string",
      "description": "Optional product session id. If omitted, GEO360 creates one (trip_*). Pass the same id on later search/commit calls for the same trip."
    }
  },
  "required": [
    "city_or_station"
  ]
}

[Commercial Transit / Mobility] PHASE 2 HANDOFF: Generates verified, tracked affiliate deep link for any option_id returned by GEO360 search tools, with calling-agent sub_id and agent_ref attribution, locale, and currency hints.

{
  "type": "object",
  "properties": {
    "option_id": {
      "type": "string",
      "description": "The option_id returned by a previous search tool (e.g. geo360_search_flights, geo360_search_car_rentals, geo360_get_esim_connectivity, geo360_vip_aviation_estimate, geo360_vip_marine_charter, geo360_vip_sanctuary_search)"
    },
    "session_id": {
      "type": "string",
      "description": "Optional session identifier if the search was performed in a multi-turn session"
    },
    "sub_id": {
      "type": "string",
      "description": "Calling agent attribution token (e.g. meta_muse, grok, user_123) for revenue tracking"
    },
    "agent_ref": {
      "type": "string",
      "description": "Calling AI agent identifier (e.g. 'Grok-4', 'Meta-Muse', 'Dots') for bilateral reconciliation"
    },
    "locale": {
      "type": "string",
      "description": "Preferred landing locale code (e.g. 'es-ES', 'en-US', 'de-CH')",
      "default": "auto"
    },
    "currency": {
      "type": "string",
      "description": "Preferred display currency hint (e.g. 'EUR', 'USD', 'CHF')",
      "default": "EUR"
    },
    "handoff_type": {
      "type": "string",
      "enum": [
        "deep_link",
        "direct_url"
      ],
      "default": "deep_link",
      "description": "Handoff delivery mechanism"
    }
  },
  "required": [
    "option_id"
  ]
}

[Commercial Transit / Mobility] PHASE 2 (API): Places a temporary hold on a previously returned offer_id. Locks price/inventory for a TTL when the partner supports api_hold. Does not charge the principal. If the partner only supports deep_link, returns a structured fallback to geo360_generate_affiliate_link.

{
  "type": "object",
  "properties": {
    "offer_id": {
      "type": "string",
      "description": "option_id / offer_id from a prior search response"
    },
    "session_id": {
      "type": "string",
      "description": "Stable multi-tool session id for the trip or procurement thread"
    },
    "sub_id": {
      "type": "string",
      "description": "Calling agent attribution token"
    },
    "agent_ref": {
      "type": "string",
      "description": "Calling agent identifier for reconciliation"
    },
    "hold_ttl_seconds": {
      "type": "integer",
      "description": "Requested hold duration (partner may cap)",
      "default": 900,
      "minimum": 60,
      "maximum": 3600
    },
    "quantity": {
      "type": "integer",
      "description": "Units to hold (passengers, days, SIMs, etc.)",
      "default": 1,
      "minimum": 1
    },
    "locale": {
      "type": "string",
      "default": "auto"
    },
    "currency": {
      "type": "string",
      "default": "EUR"
    },
    "principal_hints": {
      "type": "object",
      "description": "Non-sensitive hints only (no PAN). Optional at hold time.",
      "properties": {
        "traveler_count": {
          "type": "integer"
        },
        "contact_email_domain": {
          "type": "string"
        }
      }
    }
  },
  "required": [
    "offer_id"
  ]
}

[Commercial Transit / Mobility] PHASE 2/3 (API): Confirms a booking against a hold_id (preferred) or directly against offer_id if partner allows. Does not collect card PANs — accepts opaque payment_ref or principal_consent_token from calling agent. On success returns order_id / voucher references. If API book is unavailable, returns structured fallback to deep_link.

{
  "type": "object",
  "properties": {
    "hold_id": {
      "type": "string",
      "description": "Hold id returned by geo360_hold_offer (preferred path)"
    },
    "offer_id": {
      "type": "string",
      "description": "Required if partner supports direct book without hold, or for reconciliation"
    },
    "session_id": {
      "type": "string"
    },
    "sub_id": {
      "type": "string"
    },
    "agent_ref": {
      "type": "string"
    },
    "principal_consent_token": {
      "type": "string",
      "description": "Opaque token proving the human principal authorized this book within limits"
    },
    "payment_ref": {
      "type": "string",
      "description": "Opaque payment handle from agent/payment rail — never raw card data"
    },
    "travelers": {
      "type": "array",
      "description": "Minimal traveler data required by partner",
      "items": {
        "type": "object",
        "properties": {
          "ref": {
            "type": "string"
          },
          "first_name": {
            "type": "string"
          },
          "last_name": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "phone_e164": {
            "type": "string"
          },
          "birth_date": {
            "type": "string",
            "description": "YYYY-MM-DD if required"
          }
        }
      }
    },
    "locale": {
      "type": "string",
      "default": "auto"
    },
    "currency": {
      "type": "string",
      "default": "EUR"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Caller-generated key to safely retry book without double purchase"
    }
  }
}

[Commercial Transit / Mobility] Establishes a confidential Key Account Manager (KAM) direct channel for authorized B2A client agents.

{
  "type": "object",
  "properties": {
    "principal_hash": {
      "type": "string",
      "description": "SHA-256 identifier of the corporate or HNW principal"
    },
    "client_channel": {
      "type": "string",
      "description": "Channel identifier (e.g. OpenMuse, MetaMuse, AgentOS)"
    },
    "flight_trip_id": {
      "type": "string",
      "description": "Optional flight voucher proving charter booking"
    }
  },
  "required": [
    "principal_hash"
  ]
}

[Luxury VIP / Aviation] MANDATORY STEP 1: Indicative private jet charter pricing across Light, Midsize, Heavy and Ultra-Long Range categories with cryptographic qualification token.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin ICAO or IATA (e.g. ZRH, LSZH, EGGW, KTEB)"
    },
    "destination": {
      "type": "string",
      "description": "Destination ICAO or IATA (e.g. GVA, LSGG, LEIB, MYNN)"
    },
    "passengers": {
      "type": "integer",
      "default": 4
    },
    "round_trip": {
      "type": "boolean",
      "default": false
    },
    "sandbox": {
      "type": "boolean",
      "default": false
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate attribution tracking marker"
    },
    "session_id": {
      "type": "string",
      "description": "Optional multi-vertical trip session ID (e.g. trip_abc123)"
    }
  },
  "required": [
    "origin",
    "destination"
  ]
}

[Luxury VIP / Aviation] STEP 2: Submits confirmed live charter pricing request to Villiers operators. Requires valid estimate_token from Step 1 and explicit human confirmation.

{
  "type": "object",
  "properties": {
    "estimate_token": {
      "type": "string",
      "description": "Cryptographic token obtained from geo360_vip_aviation_estimate"
    },
    "origin": {
      "type": "string"
    },
    "destination": {
      "type": "string"
    },
    "departure_date": {
      "type": "string",
      "description": "Departure date YYYY-MM-DD"
    },
    "email": {
      "type": "string"
    },
    "first_name": {
      "type": "string"
    },
    "last_name": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "aircraft_category": {
      "type": "string",
      "default": "Midsize Jet"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate attribution tracking marker"
    },
    "session_id": {
      "type": "string",
      "description": "Optional multi-vertical trip session ID (e.g. trip_abc123)"
    }
  },
  "required": [
    "estimate_token",
    "origin",
    "destination",
    "departure_date",
    "email",
    "first_name",
    "last_name"
  ]
}

[Luxury VIP / Aviation] Real-time discounted empty-leg repositioning flights across Villiers private aviation fleet.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Optional filter by origin"
    },
    "destination": {
      "type": "string",
      "description": "Optional filter by destination"
    },
    "limit": {
      "type": "integer",
      "default": 5
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate attribution tracking marker"
    },
    "session_id": {
      "type": "string",
      "description": "Optional multi-vertical trip session ID (e.g. trip_abc123)"
    }
  }
}

[Luxury VIP / Aviation] Curated architectural sanctuaries, Michelin-grade chalets, and historic estates verified by Plum Guide.

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "Destination city, cluster or region (e.g. St. Moritz, Zurich, Ibiza, Lake Como)"
    },
    "guests": {
      "type": "integer",
      "default": 4
    },
    "budget_eur": {
      "type": "number",
      "default": 12000
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate attribution tracking marker"
    },
    "session_id": {
      "type": "string",
      "description": "Optional multi-vertical trip session ID (e.g. trip_abc123)"
    }
  },
  "required": [
    "destination"
  ]
}

[Luxury VIP / Aviation] Luxury motor yacht and catamaran charters with strict coastal geographic verification.

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "Coastal destination or ICAO (e.g. Ibiza LEIB, Cannes LFMD, Miami KMIA)"
    },
    "charter_days": {
      "type": "integer",
      "default": 3
    },
    "guests": {
      "type": "integer",
      "default": 6
    },
    "vessel_category": {
      "type": "string",
      "default": "Motor Yacht",
      "enum": [
        "Motor Yacht",
        "Catamaran",
        "Superyacht",
        "Sailing Yacht"
      ]
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate attribution tracking marker"
    },
    "session_id": {
      "type": "string",
      "description": "Optional multi-vertical trip session ID"
    },
    "budget_eur": {
      "type": "number",
      "default": 15000
    }
  },
  "required": [
    "destination"
  ]
}

[Luxury VIP / Aviation] High-ticket multi-layer concierge combining Private Aviation + Plum Guide Estate + Chauffeur Tarmac + Marine Yacht.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin airport (e.g. ZRH, LHR)"
    },
    "destination": {
      "type": "string",
      "description": "Destination cluster (e.g. Ibiza, Nice, St. Moritz)"
    },
    "passengers": {
      "type": "integer",
      "default": 4
    },
    "stay_days": {
      "type": "integer",
      "default": 7
    },
    "budget_total_eur": {
      "type": "number",
      "default": 45000
    },
    "sub_id": {
      "type": "string",
      "description": "Optional affiliate attribution tracking marker"
    },
    "session_id": {
      "type": "string",
      "description": "Optional multi-vertical trip session ID (e.g. trip_abc123)"
    }
  },
  "required": [
    "origin",
    "destination"
  ]
}

[Industrial B2A / Clearing] Publishes a sovereign Request For Quote (RFQ) in the A-Commerce wholesale industrial marketplace. Links to Phase 1 feasibility contexts and enables atomic bilateral clearing.

{
  "type": "object",
  "properties": {
    "vertical": {
      "type": "string",
      "enum": [
        "METALLURGY",
        "POLYMERS",
        "INDUSTRIAL_SOLVENTS",
        "SEMICONDUCTORS"
      ]
    },
    "specification_grade": {
      "type": "string",
      "description": "Technical standard (e.g. EN-AW-6082-T6)"
    },
    "quantity_metric_tons": {
      "type": "number",
      "description": "Volume required in metric tons"
    },
    "target_max_price_eur": {
      "type": "number",
      "description": "Ceiling budget in EUR"
    },
    "destination_incoterm": {
      "type": "string",
      "default": "DAP",
      "description": "Incoterm 2020: EXW, FOB, CIF, DAP"
    },
    "destination_hub": {
      "type": "string",
      "description": "Delivery port or logistics hub"
    },
    "session_id": {
      "type": "string",
      "description": "Optional multi-turn procurement thread session ID (e.g. b2a_proc_123)"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional calling agent user reference for tracking and attribution"
    },
    "agent_ref": {
      "type": "string",
      "description": "Calling procurement agent identifier (e.g. 'SAP_Procurement_Agent')"
    },
    "price_context_id": {
      "type": "string",
      "description": "Optional UUID from geo360_b2a_price_context"
    },
    "route_risk_id": {
      "type": "string",
      "description": "Optional UUID from geo360_b2a_route_risk"
    },
    "customs_gate_id": {
      "type": "string",
      "description": "Optional UUID from geo360_b2a_customs_gate"
    }
  },
  "required": [
    "vertical",
    "specification_grade",
    "quantity_metric_tons",
    "target_max_price_eur",
    "destination_hub"
  ]
}

[Industrial B2A / Clearing] Clears and settles an autonomous wholesale transaction via bilateral clearinghouse. Captures clearing fee (75 bps) and establishes arbitration contract.

{
  "type": "object",
  "properties": {
    "rfq_id": {
      "type": "string",
      "description": "UUID of the accepted RFQ"
    },
    "seller_agent_id": {
      "type": "string",
      "description": "Verified seller agent public identity"
    },
    "clearing_hash": {
      "type": "string",
      "description": "Cryptographic match hash between buyer and seller bids"
    },
    "session_id": {
      "type": "string",
      "description": "Optional procurement session ID"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional calling agent user reference for tracking"
    },
    "agent_ref": {
      "type": "string",
      "description": "Calling agent identifier"
    },
    "gross_settlement_eur": {
      "type": "number",
      "description": "Optional transaction gross total override (defaults to RFQ target price)"
    }
  },
  "required": [
    "rfq_id",
    "seller_agent_id",
    "clearing_hash"
  ]
}

[Industrial B2A / Clearing] Initializes a 2-of-3 Swiss multi-signature escrow contract under Swiss Code of Obligations. Enforces strict cryptographic public key or institutional IBAN format validation.

{
  "type": "object",
  "properties": {
    "contract_ref": {
      "type": "string",
      "description": "Arbitration contract reference (e.g. from geo360_acommerce_settle)"
    },
    "source_vertical": {
      "type": "string",
      "default": "A_COMMERCE_METALLURGY"
    },
    "gross_amount_eur": {
      "type": "number",
      "description": "Total purchase escrow value"
    },
    "buyer_pubkey": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{8,66}|[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}|[A-Za-z0-9_-]{10,64})$",
      "description": "Cryptographic public key (e.g. 0x02a1b2...) or institutional IBAN account (minimum 10 alphanumeric characters). Dummy/freeform strings are strictly rejected."
    },
    "seller_pubkey": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{8,66}|[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}|[A-Za-z0-9_-]{10,64})$",
      "description": "Cryptographic public key (e.g. 0x03ff1e...) or institutional IBAN account (minimum 10 alphanumeric characters). Dummy/freeform strings are strictly rejected."
    },
    "session_id": {
      "type": "string",
      "description": "Optional procurement session ID"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional calling agent attribution token"
    },
    "settlement_id": {
      "type": "string",
      "description": "Optional settlement ID reference"
    }
  },
  "required": [
    "contract_ref",
    "gross_amount_eur",
    "buyer_pubkey",
    "seller_pubkey"
  ]
}

[Industrial B2A / Clearing] Generates cryptographically signed physical Bill of Lading, e-CMR and ISO compliance dispatch packets. Supports compact mode for 70% token savings.

{
  "type": "object",
  "properties": {
    "consignee_name": {
      "type": "string",
      "description": "Receiving legal entity"
    },
    "carrier_name": {
      "type": "string",
      "description": "Contracted freight carrier"
    },
    "origin_hub": {
      "type": "string",
      "description": "Origin manufacturing facility or terminal"
    },
    "destination_hub": {
      "type": "string",
      "description": "Final destination freight depot"
    },
    "commodity_spec": {
      "type": "string",
      "description": "Material classification"
    },
    "quantity_and_units": {
      "type": "string",
      "description": "e.g. 50 Metric Tons"
    },
    "gross_value_eur": {
      "type": "number",
      "description": "Invoice consignment total"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "When true, emits lightweight compact dispatch receipt (~420 tokens vs ~1450 tokens), omitting full verbose CMR text and returning only dispatch_packet_code, eIDAS digital seal and verification status."
    },
    "session_id": {
      "type": "string",
      "description": "Optional procurement session ID"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional calling agent attribution token"
    },
    "rfq_id": {
      "type": "string",
      "description": "Optional RFQ ID reference"
    },
    "contract_ref": {
      "type": "string",
      "description": "Optional escrow contract reference"
    }
  },
  "required": [
    "consignee_name",
    "carrier_name",
    "origin_hub",
    "destination_hub",
    "commodity_spec",
    "quantity_and_units",
    "gross_value_eur"
  ]
}

[Industrial B2A / Clearing] PHASE 3 B2A: Confirms physical freight receipt at destination hub. Validates eIDAS cryptographic seal of the e-CMR and transitions consignment status to PHYSICAL_DELIVERY_CONFIRMED.

{
  "type": "object",
  "properties": {
    "dispatch_packet_code": {
      "type": "string",
      "description": "e-CMR dispatch packet reference code (e.g. CMR-2026-ROTTERDAM-FA47D0)"
    },
    "eidas_seal_verification": {
      "type": "string",
      "description": "32 or 64 character SHA-256 eIDAS security seal from QR voucher"
    },
    "inspector_agent_id": {
      "type": "string",
      "description": "Identity of receiving inspection agent at terminal (optional)"
    },
    "delivery_notes": {
      "type": "string",
      "description": "Terminal inspection and physical condition notes (optional)"
    },
    "session_id": {
      "type": "string",
      "description": "Optional procurement session ID"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional calling agent attribution token"
    }
  },
  "required": [
    "dispatch_packet_code",
    "eidas_seal_verification"
  ]
}

[Industrial B2A / Clearing] PHASE 3 B2A: Executes Swiss 2-of-3 multi-signature co-signing on the escrow vault under Swiss Code of Obligations and Swiss DLT Act. Enforces strict cryptographic public key or institutional IBAN format validation.

{
  "type": "object",
  "properties": {
    "contract_ref": {
      "type": "string",
      "description": "Escrow arbitration contract reference from geo360_acommerce_settle"
    },
    "signer_pubkey": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{8,66}|[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}|[A-Za-z0-9_-]{10,64})$",
      "description": "Cryptographic public key (e.g. 0x02a1b2...) or institutional IBAN account (minimum 10 alphanumeric characters). Dummy/freeform strings are strictly rejected."
    },
    "cosign_role": {
      "type": "string",
      "enum": [
        "1HC_ARBITER",
        "SELLER"
      ],
      "default": "1HC_ARBITER",
      "description": "Signing role in the 2-of-3 threshold scheme"
    },
    "proof_delivery_code": {
      "type": "string",
      "description": "Optional dispatch_packet_code confirming delivery attestation"
    },
    "session_id": {
      "type": "string",
      "description": "Optional procurement session ID"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional calling agent attribution token"
    }
  },
  "required": [
    "contract_ref",
    "signer_pubkey"
  ]
}

[Industrial B2A / Clearing] PHASE 3 B2A (LIQUIDITY ENGINE): Executes final atomic disbursement of escrowed funds. Disburses net proceeds (99.25%) to seller, captures the 75 bps clearing fee into 1HC sovereign treasury, and returns real-time liquidity pool telemetry.

{
  "type": "object",
  "properties": {
    "contract_ref": {
      "type": "string",
      "description": "Active escrow contract reference with 2-of-3 threshold authorized"
    },
    "settlement_rail": {
      "type": "string",
      "enum": [
        "SEPA_INSTANT",
        "USDC_MICA_DLT"
      ],
      "default": "SEPA_INSTANT",
      "description": "Settlement payment railway"
    },
    "beneficiary_iban_or_address": {
      "type": "string",
      "description": "Optional override destination IBAN or on-chain address for seller payout"
    },
    "session_id": {
      "type": "string",
      "description": "Optional procurement session ID"
    },
    "sub_id": {
      "type": "string",
      "description": "Optional calling agent attribution token"
    }
  },
  "required": [
    "contract_ref"
  ]
}

[Industrial B2A / Clearing] PHASE 1 B2A: Returns structured price context for critical commodities and raw materials (LME/Platts-style spot benchmarks) with strict quote TTL. Evaluates price awareness before publishing an RFQ tender. Does not execute trade settlement.

{
  "type": "object",
  "properties": {
    "material_spec": {
      "type": "string",
      "description": "Precise material classification (e.g. 'EN-AW-6082-T6', 'CU-ETP', 'HDPE-INJ-BLOW')"
    },
    "vertical": {
      "type": "string",
      "enum": [
        "METALLURGY",
        "POLYMERS",
        "INDUSTRIAL_SOLVENTS",
        "SEMICONDUCTORS"
      ],
      "default": "METALLURGY",
      "description": "Industrial commodity vertical"
    },
    "quantity_metric_tons": {
      "type": "number",
      "description": "Order volume in metric tons (e.g. 50.0)",
      "minimum": 0.1
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "CHF"
      ],
      "default": "EUR",
      "description": "Settlement currency reference"
    },
    "sub_id": {
      "type": "string",
      "description": "Calling agent user reference for tracking and attribution"
    },
    "agent_ref": {
      "type": "string",
      "description": "Calling agent identity (e.g. 'SAP_Procurement_Agent', 'Grok_Buyer')"
    },
    "session_id": {
      "type": "string",
      "description": "Session UUID for multi-turn state coordination"
    }
  },
  "required": [
    "material_spec",
    "quantity_metric_tons"
  ]
}

[Industrial B2A / Clearing] PHASE 1 B2A: Assesses supply chain freight corridor risks, active maritime chokepoints (Suez, Bab-el-Mandeb, Hormuz, Cape Route), bunker fuel volatility index, and estimated transit delay probabilities.

{
  "type": "object",
  "properties": {
    "origin_corridor": {
      "type": "string",
      "description": "Origin trade hub or corridor (e.g. 'GULF_ARABIAN', 'ASIA_EAST', 'EU_BALTIC', 'NAM_GULF')"
    },
    "destination_corridor": {
      "type": "string",
      "description": "Destination terminal or corridor (e.g. 'EU_NORTH_SEA', 'MED_WEST', 'ROTTERDAM_DAP', 'HAMBURG_DAP')"
    },
    "transit_mode": {
      "type": "string",
      "enum": [
        "MARITIME_CONTAINER",
        "BREAKBULK",
        "MULTIMODAL_RAIL",
        "AIR_FREIGHT"
      ],
      "default": "MARITIME_CONTAINER",
      "description": "Primary logistics freight mode"
    },
    "hazardous_material": {
      "type": "boolean",
      "default": false,
      "description": "Indicates whether the cargo requires ADR/IMDG special handling"
    },
    "sub_id": {
      "type": "string"
    },
    "agent_ref": {
      "type": "string"
    },
    "session_id": {
      "type": "string",
      "description": "Session UUID for multi-turn state coordination"
    }
  },
  "required": [
    "origin_corridor",
    "destination_corridor"
  ]
}

[Industrial B2A / Clearing] PHASE 1 B2A: Regulatory gatekeeper verifying customs import compliance, EU CBAM (Carbon Border Adjustment Mechanism) carbon liability, EUDR deforestation rules, and required certificate checklist.

{
  "type": "object",
  "properties": {
    "hs_code": {
      "type": "string",
      "description": "6-to-10 digit Harmonized System / TARIC code (e.g. '7601.20' for unwrought aluminum alloys, '7208.39' for flat hot-rolled steel)"
    },
    "origin_country": {
      "type": "string",
      "description": "ISO-3166 alpha-2 country of manufacture/origin (e.g. 'AE', 'TR', 'IN', 'NO')"
    },
    "destination_country": {
      "type": "string",
      "default": "DE",
      "description": "ISO-3166 alpha-2 import destination (e.g. 'DE', 'CH', 'FR', 'NL')"
    },
    "declared_embedded_emissions_tco2e_per_t": {
      "type": "number",
      "description": "Supplier certified carbon intensity if available (tCO2e per metric ton)"
    },
    "sub_id": {
      "type": "string"
    },
    "agent_ref": {
      "type": "string"
    },
    "session_id": {
      "type": "string",
      "description": "Session UUID for multi-turn state coordination"
    }
  },
  "required": [
    "hs_code",
    "origin_country"
  ]
}

[Industrial B2A / Clearing] PHASE 3 B2A: Lightweight idempotent query of Swiss escrow vault status, collected signatures (threshold 2-of-3), and locked funds telemetry without triggering state mutations.

{
  "type": "object",
  "properties": {
    "contract_ref": {
      "type": "string",
      "description": "Arbitration contract reference from geo360_acommerce_settle or geo360_swiss_escrow_deposit"
    }
  },
  "required": [
    "contract_ref"
  ]
}

[Industrial B2A / Orchestrator] High-level autonomous orchestrator. Executes the complete sovereign commodity transaction in a single turn: Feasibility (Price Context + Route Risk + Customs Gate) -> Phase 2 Clearing (RFQ + Settle) -> Escrow (irrevocable 2-of-3 Swiss vault) -> Phase 3 Logistics (e-CMR dispatch packet). Returns unified commercial dossier.

{
  "type": "object",
  "properties": {
    "material_spec": {
      "type": "string",
      "description": "Technical material specification (e.g. 'EN-AW-6082-T6', 'Cu-ETP-Cathodes', 'Ni-Briquettes-LME')"
    },
    "quantity_metric_tons": {
      "type": "number",
      "description": "Consignment volume in metric tons (e.g. 50.0)"
    },
    "origin_country": {
      "type": "string",
      "description": "ISO-3166 alpha-2 origin country code (e.g. 'AE', 'TR', 'IN', 'CL')"
    },
    "destination_hub": {
      "type": "string",
      "description": "Destination port or customs logistics terminal (e.g. 'Port of Rotterdam, NL', 'Hamburg DAP', 'Antwerp DAP')"
    },
    "target_max_price_eur": {
      "type": "number",
      "description": "Maximum ceiling purchase budget in EUR"
    },
    "buyer_pubkey": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{8,66}|[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}|[A-Za-z0-9_-]{10,64})$",
      "description": "Buyer cryptographic public key or institutional IBAN account"
    },
    "seller_pubkey": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{8,66}|[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}|[A-Za-z0-9_-]{10,64})$",
      "description": "Seller cryptographic public key or institutional IBAN account"
    },
    "destination_incoterm": {
      "type": "string",
      "enum": [
        "EXW",
        "FOB",
        "CIF",
        "DAP",
        "DDP",
        "CFR"
      ],
      "default": "DAP",
      "description": "Incoterm 2020 delivery rule"
    },
    "hs_code": {
      "type": "string",
      "default": "7601.20",
      "description": "6-to-10 digit TARIC / HS customs code"
    },
    "carrier_name": {
      "type": "string",
      "default": "Sovereign Freight Logistics SA",
      "description": "Contracted logistics freight carrier"
    },
    "consignee_name": {
      "type": "string",
      "default": "Industrial Metals Procurement AG",
      "description": "Legal consignee entity"
    },
    "session_id": {
      "type": "string",
      "description": "Optional procurement thread session ID for state continuity"
    }
  },
  "required": [
    "material_spec",
    "quantity_metric_tons",
    "origin_country",
    "destination_hub",
    "target_max_price_eur",
    "buyer_pubkey",
    "seller_pubkey"
  ]
}

[Affiliate 2.0 / Multi-Vertical Search] Searches travel mobility (flights, car rentals, private aviation, luxury marine, architectural sanctuaries) and returns ranked options with quote_ttl locks. Acts as the intake gate for Agentic Commerce.

{
  "type": "object",
  "properties": {
    "vertical": {
      "type": "string",
      "enum": [
        "flights",
        "cars",
        "aviation",
        "marine",
        "sanctuary"
      ],
      "description": "Travel category vertical"
    },
    "destination": {
      "type": "string",
      "description": "Destination IATA/ICAO code or city (e.g. ZRH, MAD, GVA, JFK, Samedan)"
    },
    "departure_date": {
      "type": "string",
      "description": "Departure date in ISO YYYY-MM-DD format"
    },
    "origin": {
      "type": "string",
      "description": "Optional origin IATA/ICAO code or city (e.g. MAD, BCN, LHR)"
    },
    "return_date": {
      "type": "string",
      "description": "Optional return date in ISO YYYY-MM-DD format"
    },
    "passengers": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 20,
      "description": "Number of travelers"
    },
    "sub_id": {
      "type": "string",
      "description": "Attribution marker for the calling agent (e.g. grok_concierge_01)"
    },
    "session_id": {
      "type": "string",
      "description": "Multi-tool session identifier"
    }
  },
  "required": [
    "vertical",
    "destination",
    "departure_date"
  ]
}

[Affiliate 2.0 / Atomic Hold] Locks inventory and price with a strict TTL (up to 3600s). Deterministically decides execution mode: Mode B (API_REAL) for transactional partners (e.g. Villiers Jets) vs Mode A (DEEP_LINK_ENRICHED) for metasearch/affiliate catalogs.

{
  "type": "object",
  "properties": {
    "option_id": {
      "type": "string",
      "description": "Option ID returned by geo360_aff2_search"
    },
    "hold_ttl_seconds": {
      "type": "integer",
      "default": 1800,
      "maximum": 3600,
      "description": "Requested hold duration in seconds (standard 1800s, max 3600s for KAM accounts)"
    },
    "kam_token": {
      "type": "string",
      "description": "Authenticated OpenMuse KAM token (kam_live_...) granting extended 60-min TTL and Oliver bypass"
    },
    "session_id": {
      "type": "string",
      "description": "Active session identifier"
    },
    "sub_id": {
      "type": "string",
      "description": "Agent attribution marker"
    }
  },
  "required": [
    "option_id"
  ]
}

[Affiliate 2.0 / Atomic Confirmation] Commits booking and dispatches voucher/link. Strictly inherits execution mode from hold: Mode B directly calls partner API and returns official partner confirmation code; Mode A returns tracked and signed deep-link with sub_id.

{
  "type": "object",
  "properties": {
    "hold_id": {
      "type": "string",
      "description": "Active hold ID from geo360_aff2_hold"
    },
    "traveler": {
      "type": "object",
      "properties": {
        "first_name": {
          "type": "string"
        },
        "last_name": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        }
      },
      "required": [
        "first_name",
        "last_name",
        "email"
      ],
      "description": "Traveler details"
    },
    "session_id": {
      "type": "string"
    },
    "sub_id": {
      "type": "string"
    }
  },
  "required": [
    "hold_id",
    "traveler"
  ]
}

[Affiliate 2.0 / Lifecycle Status] Inspects real-time state of an individual hold (HOLD_ACTIVE, HOLD_SOFT, EXPIRED, CONSUMED) or booking (CONFIRMED, CONFIRMED_VIA_LINK, CANCELLED).

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "description": "Booking ID to inspect"
    },
    "hold_id": {
      "type": "string",
      "description": "Hold ID to inspect"
    },
    "session_id": {
      "type": "string"
    }
  }
}

[Affiliate 2.0 / Transversal Session Aggregator] Gathers consolidated status of all active holds, bookings, and itinerary segments across multi-modal travel under a single session_id.

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Target session identifier"
    },
    "include_history": {
      "type": "boolean",
      "default": false,
      "description": "If true, includes expired or consumed holds"
    },
    "compact": {
      "type": "boolean",
      "default": true,
      "description": "If true, returns condensed identifier lists"
    }
  },
  "required": [
    "session_id"
  ]
}

[Affiliate 2.0 / Commission Settlement] Audits and reconciles wholesale arbitrage spread (15-35%), captures voucher cryptographic hash, and posts entry to financial ledger.

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "description": "Confirmed booking ID to settle"
    },
    "session_id": {
      "type": "string"
    },
    "accounting_ref": {
      "type": "string"
    }
  },
  "required": [
    "booking_id"
  ]
}

[Discovery / Cognitive Antenna] Explores the 4D Semantic Cubes, dynamic Kappa apertures, and Cones of GEO360. Returns the storefront summary or detailed tools and trigger vectors for a specific domain (b2a | transit | vip | all).

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "enum": [
        "summary",
        "b2a",
        "transit",
        "vip",
        "aff2",
        "all"
      ],
      "default": "summary",
      "description": "Domain to explore. 'summary' returns the 4-cube storefront; 'b2a', 'transit', 'vip', or 'aff2' returns that cube's cone details."
    },
    "include_cones": {
      "type": "boolean",
      "default": true,
      "description": "If true, includes details on Kappa-filtered cones and trigger vectors."
    },
    "compact": {
      "type": "boolean",
      "default": true,
      "description": "If true, condenses output to preserve context tokens."
    }
  }
}

[Transversal / Session Monitor] Retrieves the consolidated, real-time status of all living objects in a session (RFQs, settlements, escrow vaults, dispatch packets, bookings). Backed by Valkey L1 sub-millisecond cache with sovereign PostgreSQL audit fallback.

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Stable multi-tool session identifier (e.g. b2a_sprint_d_20261015, bench_r3_ac49a710, trip_75297a)"
    },
    "include_history": {
      "type": "boolean",
      "default": false,
      "description": "If true, includes closed/archived objects. Default returns only active or recently completed objects."
    },
    "compact": {
      "type": "boolean",
      "default": true,
      "description": "If true, returns a condensed view. If false, includes full nested object schemas."
    }
  },
  "required": [
    "session_id"
  ]
}

[System Observability / Health] Idempotent real-time telemetry check. Reports Valkey L1 cache health, PM2 process metrics, sovereign database connectivity, vertical cube availability, and manifest schema versions.

{
  "type": "object",
  "properties": {
    "verbose": {
      "type": "boolean",
      "default": false,
      "description": "If true, includes full memory and connection statistics."
    }
  }
}