T
TOMO
Developer Docs
BETA These docs are under partner review. Some features described are roadmap items, not yet shipped. Verify against your sandbox before relying on any contract.

TOMO Intent Catalog — Master Index

Authored 2026-05-09. Founder directive: every intent built at full depth (≥13 sections per _TEMPLATE.md), every field REQUIRED, no optionals, no shortcuts.

This catalog is the complete list of intents TOMO routes. Each row maps to a separate spec file at docs/intents/<full_id>.md.


STATUS LEGEND

🟢 LIVE      — spec written, providers can integrate, in production routing
🟡 DRAFT     — spec written, sandbox-only for now
🟠 SCAFFOLD  — listed here, spec file not yet written
🔵 V2        — planned for after first paid partner is live

DOMAIN 1 — MOBILITY (User chip: "Rides")

Existing primary agent: RideAgent Existing categories (from domain-agent-map.ts): Auto · Bike taxi · Sedan · SUV · Hatchback · Electric vehicle · Shared ride · Rental two-wheeler

Full ID Status Description Existing partner exemplars
mobility.book_intracity_ride 🟠 Point-to-point ride within a city (auto, cab, bike taxi, shared) Uber, Ola, Rapido, Namma Yatri
mobility.book_intercity_ride 🟠 Long-distance cab between cities Uber Intercity, Ola Outstation
mobility.book_self_drive 🟠 Self-drive car or bike rental Zoomcar, Royloy, Vroom
mobility.book_two_wheeler_rental 🟠 Hourly/daily 2-wheeler rental Bounce Infinity, Yulu
mobility.book_airport_transfer 🟠 Pre-booked or on-demand airport ride with luggage rules Uber Airport, IndiGo Airport Cab
mobility.book_outstation_package 🟠 Multi-day outstation cab with driver Savaari, MakeMyTrip Cab
mobility.book_recurring_commute 🔵 Daily-commute subscription (work-home-work) Quick Ride, sRide
mobility.book_chauffeur_hourly 🟠 Hourly chauffeur with own car Hertz, Avis chauffeur
mobility.book_ev_with_charge_planning 🟠 EV ride or self-drive with charging-stop awareness BluSmart, eveez

DOMAIN 2 — FOOD & LIFESTYLE (User chip combined)

Food sub-domain

Existing primary agent: FoodAgent (TBD — confirm in services/agents/primary) Existing categories: Hyderabadi biryani · South Indian · North Indian · Chinese · Bakery · Sweets · Tiffin · Veg · Vegan · Jain · Halal

Full ID Status Description Existing partner exemplars
food.order_delivery 🟢 Food delivered from a restaurant or cloud kitchen Swiggy, Zomato
food.book_dine_in 🟠 Restaurant table reservation EazyDiner, Dineout
food.book_dine_in_with_offer 🟠 Reservation that locks a discount/offer Magicpin, Dineout Pay
food.subscribe_tiffin 🟠 Daily/weekly home-style tiffin subscription FreshMenu Subs, local tiffin networks
food.book_chef_at_home 🟠 Live cook for an event at home Chefkart, Cuisine Atelier
food.book_catering_event 🟠 Catering for a defined headcount + occasion Sattvik Catering, local caterers
food.order_pickup 🟠 Order placed for self-pickup Swiggy Pickup, Zomato Self-Pickup
food.order_cake_or_special 🟠 Custom cake or birthday/anniversary special FlowerAura, Bakingo, FNP Cakes

Lifestyle sub-domain (folded into Food & Lifestyle chip)

Existing primary agent: LifestyleAgent Existing categories: Salon · Spa · Gym · Yoga studio · Personal trainer · Massage · Nail studio · Barber

Full ID Status Description Existing partner exemplars
lifestyle.book_salon 🟠 Hair / beauty appointment at a salon Urban Company, Looks Salon
lifestyle.book_at_home_service 🟠 At-home salon, spa, or massage Urban Company, BookMy Salon
lifestyle.book_gym_session 🟠 Single-session gym entry Cult.fit, Gym Pass
lifestyle.book_gym_membership 🔵 Recurring gym membership Cult.fit Pro, Gold's Gym
lifestyle.book_yoga_class 🟠 Single yoga class drop-in Cult.fit, local studios
lifestyle.book_personal_trainer 🟠 One-on-one trainer session Cult.fit, FitPass
lifestyle.book_spa_treatment 🟠 Spa day or specific treatment The Body Shop Spa, Ayurvedic centers
lifestyle.book_wellness_retreat 🔵 Multi-day wellness/yoga retreat Ananda, SwaSwara

DOMAIN 3 — AUTO SERVICES (User chip: "Auto Services")

Existing primary agent: AutoCareAgent No existing supplier categories — this domain has no supplier-side build yet. Categories drafted from real partner exemplars (GoMechanic, UrbanCompany Auto, BlueGold Energy):

Workshop · Mechanic · Body shop · Tyres & alignment · Battery · AC service · Insurance renewal · RC transfer · EV charging install · Car wash · Detailing

Full ID Status Description Existing partner exemplars
auto.book_general_service 🟡 Periodic/general car or 2-wheeler service GoMechanic, Driverji
auto.book_major_service 🟡 Major service or overhaul GoMechanic, official service centers
auto.book_breakdown_assist 🟡 Roadside assistance, towing Allianz, Bajaj Allianz RSA
auto.book_tyre_alignment 🟡 Tyre change, balancing, alignment Tyresoles, MRF Service
auto.book_battery_replacement 🟡 Battery diagnostic + replacement Battery Bhai, Exide
auto.book_ac_service 🟡 AC gas top-up + service local mechanics
auto.book_car_wash 🟡 At-home or drive-in car wash Pitstop, GoMechanic
auto.book_detailing 🟡 Premium interior/exterior detailing The Detailing Mafia
auto.book_paint_job 🟡 Body paint or dent repair GoMechanic, Mahindra First Choice
auto.book_pollution_check 🟡 PUC certificate at authorized center local PUC centers
auto.book_insurance_renewal 🟡 Motor insurance renewal PolicyBazaar, Acko, Digit
auto.book_rc_transfer 🟡 Ownership transfer at RTO local RTO agents
auto.book_ev_charger_install 🟡 At-home EV charger installation Tata Power, Statiq

DOMAIN 4 — FINANCE (User chip: "Finance")

Existing primary agent: FinanceAgent No existing supplier categories — to be built. Categories drafted:

Term insurance · Health insurance · Motor insurance · Travel insurance · Mutual funds · Personal loan · Home loan · Credit card · Tax planning · Investment advisory · Will & estate

Full ID Status Description Existing partner exemplars
finance.buy_term_insurance 🟠 Pure-protection term plan PolicyBazaar, Acko Life
finance.buy_health_insurance 🟠 Individual or family health cover PolicyBazaar, Niva Bupa
finance.buy_motor_insurance 🟠 Car/bike insurance + add-ons PolicyBazaar, Acko, Digit
finance.buy_travel_insurance 🟠 Trip-specific travel cover TATA AIG, ICICI Lombard
finance.invest_in_mutual_fund 🟠 One-time or SIP mutual fund order Groww, Zerodha Coin, Kuvera
finance.apply_personal_loan 🟠 Unsecured personal loan Bajaj Finserv, Tata Capital
finance.apply_home_loan 🟠 Secured home loan HDFC, SBI, ICICI
finance.apply_credit_card 🟠 Credit card application HDFC, ICICI, Axis
finance.book_tax_consultation 🟠 CA appointment for tax ClearTax, local CAs
finance.book_financial_advisor_session 🟠 Hourly advisor consultation private advisors, registered FAs
finance.create_will_or_estate_plan 🔵 Estate planning consultation Will Jini, Legal counsel

DOMAIN 5 — TRAVEL (User chip: "Travel")

Existing primary agent: TravelAgent (with sub-agents: HotelAgent, FlightAgent, TrainAgent) Existing supplier categories: Budget hotel · Boutique hotel · Homestay · Resort · Tour package · Local guide · Adventure Existing supplier shape (already built): Tier 2 → ListingBuilder

Full ID Status Description Existing partner exemplars
travel.book_hotel 🟢 Stay at hotel/homestay/resort Booking.com, MMT, OYO, Airbnb
travel.book_flight 🟠 Domestic or international flight MMT, Cleartrip, Ixigo, Skyscanner
travel.book_train 🟠 Train ticket via IRCTC partners IRCTC, Confirmtkt, Ixigo Trains
travel.book_bus 🟠 Long-distance or city-to-city bus RedBus, Abhibus
travel.book_package 🟠 Bundled trip (flight + hotel + transfers) MMT, Yatra, Thomas Cook
travel.book_tour_guide 🟠 Local guide for a city / heritage walk GetYourGuide, Viator, local guides
travel.book_adventure_activity 🟠 Trekking, paragliding, river rafting Thrillophilia, Padi Travel
travel.book_cruise 🔵 Cruise booking Cordelia Cruises, MMT Cruises
travel.book_visa_assistance 🟠 Visa application support service VFS Global, Travel agents
travel.book_forex 🔵 Foreign exchange order BookMyForex, Thomas Cook Forex

DOMAIN 6 — LOGISTICS (User chip: "Logistics")

Existing primary agent: LogisticsAgent (with ParcelAgent) Existing categories: Document delivery · Same-day courier · Furniture move · Heavy parcel · Bike courier Existing supplier shape: Tier 2 driver-shape (DriverSignup with category=parcels) + Fleet

Full ID Status Description Existing partner exemplars
logistics.send_intracity_parcel 🟠 On-demand intra-city courier Porter, Dunzo, Wefast
logistics.send_intercity_parcel 🟠 City-to-city courier DTDC, Bluedart, Delhivery
logistics.send_international_parcel 🟠 International courier DHL, FedEx, UPS, Aramex
logistics.book_furniture_move 🟠 Local home/office relocation Porter, Pikkol, Agarwal Movers
logistics.book_full_house_move 🟠 Full inter-city home relocation Pikkol, Agarwal Packers
logistics.book_bike_transport 🟠 Bike or scooter inter-city transport Vrl, BlueDart Bikes
logistics.book_storage_warehouse 🔵 Self-storage or 3PL warehousing StoreMore, Brick&Bolt Storage
logistics.book_cold_chain_delivery 🔵 Temperature-controlled delivery Delhivery Cold, ColdEx

DOMAIN 7 — SAFETY (User chip: "Safety")

Existing primary agent: SentinelAgent (with SentinelOmegaAgent, SentinelAlphaAgent, SentinelBetaAgent) No existing supplier categories — to be built. Categories drafted:

CCTV install · Alarm monitoring · Bodyguard · Roadside assistance · Private ambulance · Cybersecurity / fraud protection

Full ID Status Description Existing partner exemplars
safety.install_home_cctv 🟠 At-home CCTV installation + setup UrbanClap Home Security, local installers
safety.subscribe_alarm_monitoring 🟠 24x7 alarm monitoring service SecureMyHome, Aditya Birla MyUniverse
safety.book_personal_security 🟠 Bodyguard or close-protection officer private security firms
safety.book_roadside_assistance 🟠 Roadside assist (not breakdown specific) Allianz RSA, Bajaj Allianz, AAUI
safety.book_private_ambulance 🟠 Private ambulance booking Stanplus, Dial4242, HelpNow
safety.subscribe_cyber_protection 🟠 Identity-theft + fraud monitoring Norton 360 with LifeLock, McAfee
safety.book_event_security 🔵 Event/wedding security staff private security firms
safety.subscribe_emergency_sos 🔵 Always-on personal SOS service Hike SOS, Safetipin

FASTag note: FASTag balance check + top-up is NOT a separate intent. It's a runtime check inside mobility.book_intracity_ride / mobility.book_self_drive / mobility.book_intercity_ride — when the route involves toll roads, the TollAgent is invoked. Locked per founder directive 2026-05-08.


DOMAIN 8 — MARKETPLACE (User chip: "Marketplace")

Existing primary agent: AutoTradeAgent (renamed → MarketplaceAgent pending v2) No existing supplier categories — to be built. Categories drafted:

Used cars · Used bikes · Used electronics · Used furniture · Pre-owned classifieds

Full ID Status Description Existing partner exemplars
marketplace.buy_used_car 🟠 Buy a used car Cars24, CarDekho, Spinny
marketplace.sell_used_car 🟠 Sell a used car (instant quote + pickup) Cars24, Spinny
marketplace.buy_used_bike 🟠 Buy a used 2-wheeler DroomBike, BikeWale
marketplace.sell_used_bike 🟠 Sell a used 2-wheeler DroomBike
marketplace.buy_used_electronics 🟠 Buy refurbished phone / laptop Cashify, OLX
marketplace.sell_used_electronics 🟠 Sell phone/laptop instantly Cashify, ReBoot
marketplace.buy_used_furniture 🟠 Buy second-hand furniture OLX, Quikr
marketplace.sell_used_furniture 🟠 Sell second-hand furniture OLX, Quikr
marketplace.list_classified_ad 🔵 Generic classified listing OLX, Facebook Marketplace
marketplace.evaluate_used_vehicle 🟠 Get inspection + quote without selling Spinny Assured

DOMAIN 9 — ENTERTAINMENT (User chip: "Entertainment")

Existing primary agent: TainmentAgent No existing supplier categories — to be built. Categories drafted:

Movies · Concerts · Sports · Theatre · Comedy · Auto Expo · Live events

Full ID Status Description Existing partner exemplars
entertainment.book_movie_ticket 🟡 Movie ticket at multiplex/single screen BookMyShow, PVR, INOX
entertainment.book_concert_ticket 🟡 Live music concert ticket BookMyShow, Insider.in
entertainment.book_sports_event 🟡 Cricket / football / kabaddi match BookMyShow, Paytm Insider
entertainment.book_theatre_play 🟡 Theatre performance BookMyShow, Insider.in
entertainment.book_comedy_show 🟡 Stand-up comedy show BookMyShow, Insider.in
entertainment.book_event_venue 🟡 Wedding/event venue booking VenueLook, WedMeGood
entertainment.book_party_hall 🟡 Party hall / banquet booking VenueLook
entertainment.subscribe_streaming 🟡 Streaming subscription gift/manage Netflix, Prime, Hotstar

CROSS-CUTTING INTENTS (no domain — handled by utility agents)

Full ID Status Description Notes
pay.send_money_upi 🔵 UPI transfer to a contact TOMO never holds funds
pay.split_bill 🔵 Split a bill across contacts settlement via UPI
pay.add_money_to_wallet 🔵 Top-up partner wallet partner-specific
pay.utility_bill_pay 🔵 Pay electricity, gas, mobile, broadband partner aggregators

Removed from catalog (locked): FASTag top-up / balance check is NOT a standalone intent. It is a TollAgent runtime capability invoked from inside mobility.book_intracity_ride, mobility.book_intercity_ride, and mobility.book_self_drive when the route involves toll roads. Documented per-intent in those mobility specs' fastag_check block (§5). Founder directive locked 2026-05-08. | compliance.verify_kyc | 🔵 | KYC document verification | Surepass / Signzy | | compliance.verify_rc_dl | 🔵 | RC + DL document verification | Surepass / Karza |


CRITICAL-PATH BUILD ORDER

Per founder priority (memory: 🔴 critical path = Swiggy + Conv Intel for 3 servable intents), the first 3 intents to ship full specs + reference implementations are:

  1. food.order_delivery — Swiggy is the named partner
  2. mobility.book_intracity_ride — Uber/Ola/Rapido/Namma Yatri all exemplars
  3. travel.book_hotel ← already shipped in this commit as gold reference

After these 3 ship, the remaining 50+ intents follow the same template, one per file.


TOTAL INTENT COUNT (this catalog)

Mobility:        9   ✅ DONE
Food:            8   ✅ DONE
Lifestyle:       8   ✅ DONE
Auto Services:  13   ⬜ NOT STARTED
Finance:        11   ⬜ NOT STARTED
Travel:         10   🟡 3 of 10 (book_hotel, book_flight, book_train)
Logistics:       8   ⬜ NOT STARTED
Safety:          8   ⬜ NOT STARTED
Marketplace:    10   ⬜ NOT STARTED
Entertainment:   8   ⬜ NOT STARTED
Cross-cutting:   6   🟡 4 of 6 (send_money_upi, utility_bill_pay,
                                verify_kyc, verify_rc_dl)
─────────────────
Total:          99 intents catalogued (was 100; pay.fastag_topup removed —
                see TollAgent runtime check note above)
DONE NOW:       32 / 99
REMAINING:      67 / 99

NEXT-SESSION QUEUE

Session A — write food.order_delivery + mobility.book_intracity_ride at full depth
Session B — write all remaining travel.* + entertainment.* (similar shape — listings + booking)
Session C — write all auto.* + finance.* (consultation/product hybrid)
Session D — write all lifestyle.* + safety.* (services with slots)
Session E — write all logistics.* + marketplace.* (item lifecycle)
Session F — write cross-cutting + sandbox-to-prod checklist consolidation
Session G — auto-publish to /docs/intents/ as a public partner-facing site

Estimated 3-4 days of focused work across the 7 sessions.