@gojinko/plugin 2.24.0 → 2.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "jinko",
3
3
  "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.",
4
- "version": "2.24.0",
4
+ "version": "2.26.0",
5
5
  "author": {
6
6
  "name": "Jinko",
7
7
  "url": "https://gojinko.com"
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "jinko",
3
3
  "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.",
4
- "version": "2.24.0",
4
+ "version": "2.26.0",
5
5
  "author": {
6
6
  "name": "Jinko",
7
7
  "url": "https://gojinko.com"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gojinko/plugin",
3
- "version": "2.24.0",
3
+ "version": "2.26.0",
4
4
  "description": "Jinko Travel plugin for Claude Code and OpenAI Codex — flight search, booking, and trip management via MCP",
5
5
  "private": false,
6
6
  "license": "MIT",
@@ -53,7 +53,7 @@ Prod and sandbox keys are stored separately in `~/.jinko/config.yaml`. Precedenc
53
53
  | `checkout` | Finalize a trip → returns `checkout_url` (human pays in browser) + `agent_spt_params` (agent pays programmatically). `book` is a deprecated alias. |
54
54
  | `agent-pay submit` | Pay programmatically with a Shared Payment Token (`--trip-id` + `--token`); returns the Jinko `booking_ref` once authorized; 3DS step-up falls back to `checkout_url` |
55
55
  | `trip-status` | Full status: cart, quote, fulfillment, bookings, and the Jinko `booking_ref` once fulfillment has been scheduled — it can be present before payment completes, so read `fulfillment.status` for paid (the `--booking-ref` for `get-booking` / `hotel-cancel` / `refund`) |
56
- | `get-booking` | Retrieve a booking by `JNK-*` ref + last name (guest access). |
56
+ | `get-booking` | Retrieve a booking by `JNK-*` ref + last name (guest access). Carries `calendar` — the `.ics` files for the booking's flights and stays; `--format json` carries their contents. |
57
57
  | `refund check / commit / status` | Voluntary refund flow |
58
58
  | `schema <command>` | Print request/response schema for a command |
59
59
  | `config` | Read/write CLI config |
@@ -154,6 +154,7 @@ jinko refund status --ref JNK-A7B3X9 --last-name Doe
154
154
  - **IATA codes**: `--origin PAR` uses a CITY code (matches CDG + ORY + BVA); `--origin CDG` uses an airport. `flight-search` has `--origin-type city|airport` to disambiguate — omit it and the platform classifies the code itself, which is the safest choice.
155
155
  - **Filters are requests, not guarantees**: `flight-search` answers with `applied_filters` and `unapplied_filters` (name + reason). An unapplied filter still returns 200 with offers — post-filter them yourself or tell the user the constraint could not be met. `--format table` prints the report under the results.
156
156
  - **Alternate airports widen an AIRPORT anchor**: `--origin-alternate-airports EWR LGA` adds airports beside `--origin`, never removes results, and the anchor decides ranking — so put the airport that matters most in `--origin`. Against a city anchor the list is ignored and comes back in `unapplied_filters` as `origin` / `destination`.
157
+ - **Carrier filter means different fields on different tools**: `--include-carriers` / `--exclude-carriers` are on every flight tool, but `flight-search` (live) matches the MARKETING carrier while the cache tier (`flight-calendar`, `find-dates`, `lowest-fare`, `find-destination`) matches the VALIDATING (ticketing) carrier — the only carrier field the cache index carries. The two lists must not overlap. `flight-calendar`/`find-dates`/`lowest-fare` responses carry `available_airlines` (validating-carrier codes across the whole cached match set, not just the page) so you can discover what's available before retrying with `--include-carriers`.
157
158
  - **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.
158
159
  - **Token expiry**: offers cached ~30 min. If `checkout` returns a quote failure, re-run `flight-search`/`hotel-search` to get a fresh token.
159
160
  - **Script use**: set `JINKO_API_KEY` env var and use `--format json` so output parses cleanly.