@gojinko/plugin 2.0.0 → 2.1.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.0.0",
4
+ "version": "2.1.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.0.0",
4
+ "version": "2.1.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.0.0",
3
+ "version": "2.1.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",
@@ -12,7 +12,8 @@ You have access to Jinko MCP tools for flight discovery. Pick the right one base
12
12
  | User intent | Tool to use |
13
13
  |-----------|-------------|
14
14
  | Nothing in mind — wants inspiration | `find_destination` |
15
- | Route known, flexible on dates | `flight_calendar` |
15
+ | Route known, flexible on dates — wants the full price-per-date list | `flight_calendar` |
16
+ | Route known, flexible on dates — wants a short curated spread of date options ("when should I fly?") | `find_dates` |
16
17
  | Route + exact dates, wants live pricing + bookable token | `flight_search` (see the `book-trip` skill) |
17
18
  | Route + exact dates, **wants to track price over time** | `price_monitoring` |
18
19
 
@@ -56,6 +57,18 @@ Show cheapest prices across a date range for a specific route. Great for "what's
56
57
 
57
58
  **Response:** List of dates with `price`, `offer_token`, `airline`, `stops`. Includes `cheapest` entry.
58
59
 
60
+ ## find_dates
61
+
62
+ Answers "when should I fly?" — takes the **same params as `flight_calendar`** and returns up to **10 cheapest itineraries, one per (departure, return) date-pair, spread across the requested departure window** (so you get a diverse set of date options instead of ten near-adjacent cheapest days). **Cache-only** — never live-prices.
63
+
64
+ **Required params:** same as `flight_calendar` (`origins`, `destinations`, `trip_type`, departure window via `departure_date_ranges`).
65
+
66
+ **Optional params:** `return_date_ranges` / `stay_days` (roundtrip), `direct_only`, `cabin_class`, `currency`.
67
+
68
+ **Response:** up to 10 full itineraries (same shape as `flight_calendar`), in chronological order — each the cheapest for its date-pair.
69
+
70
+ **flight_calendar vs find_dates:** use `flight_calendar` for the full price-per-date grid; use `find_dates` when you want a short, spread-out shortlist of the best date options to fly.
71
+
59
72
  ## find_flight (legacy — prefer flight_search)
60
73
 
61
74
  Cached flight search by route + dates. Still callable for backwards compatibility with older ChatGPT App versions, but not recommended for new integrations. Use `flight_search` (in the `book-trip` skill) for the same inputs plus live pricing + a bookable `trip_item_token` in one step.