@gojinko/plugin 2.14.0 → 2.16.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "jinko",
   "description": "Search flights, book trips, and manage bookings with the Jinko Travel API. Connects to the Jinko MCP server for live flight pricing, trip management, and payment.",
-  "version": "2.14.0",
+  "version": "2.16.0",
   "author": {
     "name": "Jinko",
     "url": "https://gojinko.com"

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "jinko",
   "description": "Search flights, book trips, and manage bookings with the Jinko Travel API. Connects to the Jinko MCP server for live flight pricing, trip management, and payment.",
-  "version": "2.14.0",
+  "version": "2.16.0",
   "author": {
     "name": "Jinko",
     "url": "https://gojinko.com"

package/README.md

@@ -4,7 +4,7 @@ Plugin for **Claude Code** and **OpenAI Codex** that enables flight search, trip
 
 ## What's included
 
-- **4 skills**: search-flights, book-trip, manage-booking, account
+- **6 skills**: search-flights, search-hotels, book-trip, manage-booking, account, cli
 - **MCP server config**: connects to `mcp.builders.gojinko.com`
 - **Dual-platform support**: works with both Claude Code and Codex CLI
 
@@ -39,9 +39,11 @@ codex plugin install @gojinko/plugin
 | Skill | Description | Example prompt |
 |-------|-------------|---------------|
 | `jinko:search-flights` | Find flights, explore destinations, compare prices | "Find flights from Paris to Tokyo in June" |
-| `jinko:book-trip` | Book a flight with travelers and payment | "Book the cheapest flight and pay" |
+| `jinko:search-hotels` | Search live hotel inventory and rates by destination, dates, and occupancy — or look up a hotel by name | "Find hotels in Tokyo for 2 nights in June" |
+| `jinko:book-trip` | Book flights, hotels, or both — travelers, ancillaries, and payment | "Book the cheapest flight and pay" |
 | `jinko:manage-booking` | Check refund eligibility and process refunds | "Can I get a refund on booking ORD-123?" |
 | `jinko:account` | Account setup guide — API keys, quotas, dashboard | "How do I set up my Jinko API key?" |
+| `jinko:cli` | Run travel ops from the terminal — search flights/hotels, build trips, book, refund, look up bookings via the `jinko` CLI | "Search flights from the terminal with the jinko CLI" |
 
 ## Authentication
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gojinko/plugin",
-  "version": "2.14.0",
+  "version": "2.16.0",
   "description": "Jinko Travel plugin for Claude Code and OpenAI Codex — flight search, booking, and trip management via MCP",
   "private": false,
   "license": "MIT",

package/skills/cli/SKILL.md

@@ -50,7 +50,8 @@ Prod and sandbox keys are stored separately in `~/.jinko/config.yaml`. Precedenc
 | `hotel-details` | Rich metadata (gallery, facilities, policies, per-room details) for a single hotel |
 | `trip` | Create / update a trip: add items, remove items, set travelers + contact |
 | `select-ancillaries` | Add baggage / seats / meals to a trip item |
-| `book` | Schedule checkout → returns Stripe payment URL |
+| `checkout` | Finalize a trip → returns `checkout_url` (human pays in browser) + `agent_spt_params` (agent pays programmatically). `book` is a deprecated alias. |
+| `agent-pay submit` | Pay programmatically with a Shared Payment Token (`--trip-id` + `--token`); 3DS step-up falls back to `checkout_url` |
 | `trip-status` | Full status: cart, quote, fulfillment, bookings |
 | `get-booking` | Retrieve a booking by `JNK-*` ref + last name (guest access). |
 | `refund check / commit / status` | Voluntary refund flow |
@@ -74,14 +75,21 @@ jinko trip --trip-id tr_ABC \
   --travelers '[{"type":"ADT","first_name":"John","last_name":"Doe","date_of_birth":"1990-01-15"}]' \
   --contact '{"email":"john@example.com","phone":"+33612345678"}'
 
-# 4. Schedule checkout — returns canonical Jinko-hosted URL
-jinko book --trip-id tr_ABC
-# → { checkout_url: "https://app.gojinko.com/checkout?sid=12345" }
+# 4. Checkout — returns canonical Jinko-hosted URL + agent payment params
+jinko checkout --trip-id tr_ABC
+# → { checkout_url: "https://app.gojinko.com/checkout?sid=12345",
+#     agent_spt_params: { max_amount: 259449, currency: "EUR", ... } }
 # The /checkout page renders the cart, collects any remaining info,
 # and triggers the right Stripe flow (embedded Elements or Hosted
 # Checkout) on Pay-button click.
 
-# 5. User pays in browser (or open the URL programmatically)
+# 5a. Human path: user pays in browser (or open the URL programmatically)
+# 5b. Agent path: mint a Shared Payment Token scoped to agent_spt_params,
+#     then pay programmatically (no browser):
+jinko agent-pay submit --trip-id tr_ABC --token spt_xxx
+# → { status: "processing", payment_verified: true }
+#   On a 3DS step-up / decline, the response carries a checkout_url fallback.
+
 # 6. Poll status
 jinko trip-status --trip-id tr_ABC
 ```
@@ -141,7 +149,7 @@ jinko refund status --ref JNK-A7B3X9 --last-name Doe
 - **Two auth systems.** CLI OAuth tokens (WorkOS device flow, stored in `~/.jinko/config.yaml`) are NOT interchangeable with MCP OAuth tokens (DCR, different issuer). Don't paste a CLI token into an MCP Bearer header — it will fail with issuer mismatch. Use an API key (`jnk_*`) for cross-surface programmatic access.
 - **IATA codes**: `--from PAR` uses a CITY code (matches CDG + ORY + BVA); `--from CDG` uses an airport. `flight-search` has `--origin-type city|airport` to disambiguate.
 - **trip_item_token format**: `offer_xxx:fare_yyy` (flight) or `htl_xxx:rate_yyy` (hotel). Always the offer ID + fare/rate ID joined by colon.
-- **Token expiry**: offers cached ~30 min. If `book` returns a quote failure, re-run `flight-search`/`hotel-search` to get a fresh token.
+- **Token expiry**: offers cached ~30 min. If `checkout` returns a quote failure, re-run `flight-search`/`hotel-search` to get a fresh token.
 - **Script use**: set `JINKO_API_KEY` env var and use `--format json` so output parses cleanly.
 
 ## See also