# @voyant-travel/trips

Deterministic composition layer for customer-facing trips that group multiple
component bookings/orders into one itinerary, pricing, reserve, checkout, and
support experience.

This package is landing on the trips integration branch. It currently
includes the durable schema, Zod contracts, deterministic trip service,
catalog component adapter, checkout handoff, component-level cancellation
preview/cancel operations, Cruise Extension representation helpers, Hono
routes, and MCP tools.

Agent-triggered pricing and reservation are asynchronous durable operations.
The package records an admitted command and immutable accepted result before
provider dispatch. They remain unavailable unless the selected deployment
provides `trips.durable-action-runtime` and passes behavioral replay, restart
reconciliation, payload-drift, and exact backend-identity conformance. The
framework ships no fallback provider. Use `get_trip_action_operation` to read
the terminal outcome.

Checkout and cancellation are dependency-injected so app/runtime packages keep
owning payment-provider, bank-transfer, storefront URL, supplier, and
staff-remediation policy. See
`docs/architecture/trips-implementation-plan.md` for the full PR
sequence and remaining slices.

## Install

```bash
pnpm add @voyant-travel/trips
```

## Exports

| Entry | Description |
| --- | --- |
| `.` | Module export |
| `./schema` | Drizzle tables, added in the schema slice |
| `./validation` | Zod contracts |
| `./service` | Deterministic composer services |
| `./tools` | AI-safe trip planning and admitted durable actions |
| `./durable-action-runtime-port` | Exact provider capability and conformance contract |
| `./action-job` | Durable pricing/reservation reconciliation worker |
| `./cruise-extension` | Cruise Extension link and selection helpers |
| `./routes` | Hono route factory/module routes |

## License

Apache-2.0