jbaruch/nanoclaw-travel

Actionable travel assistance for NanoClaw — byAir-powered flight notifications, travel-booking gap checks, and nightly TripIt sync. Replaces generic "21 minutes to departure" reminders with alerts that change behavior. Powered by byAir for flight data and Google Maps Distance Matrix for traffic-aware time-to-leave.

Per-chat overlay plugin. Install via NanoClaw's containerConfig.additionalTiles mechanism.

Capabilities (V1.1 shipped)

1. Time-to-leave — traffic-aware push N hours before departure ("leave by 11:30, traffic is 45 min")
2. Day-before sanity check — diff against prior TripIt state; flag silent rebookings, seat changes, calendar conflicts
3. Gate / delay / cancel push — fires on actual change, not on cron schedule
4. Connection risk — alert when leg 1 delay threatens leg 2 transfer
5. Inbound aircraft delay — earliest possible signal (incoming aircraft delayed on previous leg, ~1h before gate-board flip)
6. Arrival logistics — ~15 min before landing: baggage carousel, Lyft estimate, lounge access if transit

Installation

tessl install jbaruch/nanoclaw-travel

Add to a chat's overlay tile list via update_group_config:

additionalTiles: ["jbaruch/nanoclaw-travel"]

Required environment

Google Calendar access (boarding-block reconciliation, drive-block create/remove, calendar fetches) needs no variable: it calls the native Calendar REST API, and OneCLI's gateway injects the OAuth Bearer on the wire (nanoclaw#638). The container holds no Google credential. The retired COMPOSIO_API_KEY / COMPOSIO_USER_ID pair can be deleted from the vault.

Optional:

Store all required credentials in OneCLI vault. Never commit. See .env.example for the contract; GitHub Actions secrets configuration link is in its file header.

Co-loaded plugin dependency

nightly-travel-sync's Gmail freshness fallback (scripts/fetch-tripit-emails.py) imports four shared Gmail helpers — google-rest.py, gmail-ops.py, gmail-message.py, sanitize-email-body.py — from jbaruch/nanoclaw-admin's heartbeat skill, over the co-loaded tessl__heartbeat mount. So this plugin's additionalTiles must also carry jbaruch/nanoclaw-admin for that one branch to run; it fails closed with an actionable message otherwise, and no other capability here depends on it.

Gmail is not this plugin's domain, so it depends on the one tested copy of the RFC822 MIME parser and the poison sanitizer rather than re-implementing them (nanoclaw-orders consumes them the same way). Calendar is different — this plugin owns its per-service clients, so google_calendar_client.py stays self-contained here.

Rules

Skills

Skill scripts

The skill bundle includes executable scripts the agent invokes via the SKILL.md actions:

• scripts/check-env.py — verifies BYAIR_MCP_URL and GOOGLE_MAPS_API_KEY are set (calendar access has no env var to check — see above)
• scripts/set-home-base.py — persists home address to plugin config for time-to-leave queries
• scripts/get-flight-state.py — fetches a flight's last-known snapshot to enrich notifications
• scripts/read-current-tz.py — resolves the operator's current_tz from tz_state so surfaces phrase relative dates in the operator's local zone (see operator-local-tz-phrasing rule)

Plus scheduler-invoked scripts (not user-facing):

• flight-assist/precheck.py — runs every ~2 min, polls byAir per cadence ladder, emits wake events
• sync-tripit/precheck.py — runs every 5 min, adaptive-gated; delegates to flight-assist/sync_tripit.py only when a flight is imminent or the index is stale (see the sync-tripit skill for gate predicate + thresholds)
• flight-assist/sync_tripit.py — the byAir → state reconciliation invoked by the sync-tripit scheduler
• nightly-travel-sync/precheck.py — runs daily, gates the travel-data refresh on travel-db.json freshness (see the nightly-travel-sync skill + precheck.py for the cadence predicate)
• nightly-travel-sync/scripts/refresh-travel-schedule.py, check-travel-freshness.py, fetch-tripit-emails.py, filter-tripit-bookings.py — the travel-source writers + the freshness probe's Gmail fallback (fetch sanitizes in-container, filter matches the TripIt confirmation prefix)
• drive-engine/reconcile_sweep.py — runs every ~30 min, plans airport + meeting drives, reconciles against the primary calendar, and applies the changes (create / update / delete of its own blocks). Set DRIVE_ENGINE_SHADOW=1 to dry-run it: the plan is rendered to stderr and nothing is written — use it to validate a block-shape change against the real calendar before the cutover applies anything

Status

• V1.1 — adds connection-risk derivation (capability 4). The precheck post-loop walks per-trip state, projects leg-1 arrival vs leg-2 scheduled departure, and emits connection_at_risk events when the transfer window falls below min_transfer_minutes (configurable, default 45). State schema bumped to v2 with owner-side migration
• V1 — flight-data-locality rule, full action-router SKILL.md, precheck orchestrator with cadence-gated byAir polling, stateful flight tracking, delta-driven wake rules (cancel, divert, gate, delay, inbound delay, boarding, carousel reveal), time-based wake gates (day-before, time-to-leave, arrival logistics), daily sync against byair_list_trips

See CHANGELOG.md for version history.