@gojinko/plugin 2.0.0 → 2.1.1

package/.claude-plugin/plugin.json

@@ -1,12 +1,12 @@
 {
   "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.0.0",
+  "version": "2.1.1",
   "author": {
     "name": "Jinko",
     "url": "https://gojinko.com"
   },
-  "homepage": "https://builders.gojinko.com",
+  "homepage": "https://gojinko.com",
   "repository": "https://github.com/gojinko/jinko-dev-tools",
   "license": "MIT",
   "keywords": [

package/.codex-plugin/plugin.json

@@ -1,12 +1,12 @@
 {
   "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.0.0",
+  "version": "2.1.1",
   "author": {
     "name": "Jinko",
     "url": "https://gojinko.com"
   },
-  "homepage": "https://builders.gojinko.com",
+  "homepage": "https://gojinko.com",
   "repository": "https://github.com/gojinko/jinko-dev-tools",
   "license": "MIT",
   "keywords": [

package/README.md

@@ -12,7 +12,7 @@ Plugin for **Claude Code** and **OpenAI Codex** that enables flight search, trip
 
 ### 1. Get an API key
 
-Sign up at [builders.gojinko.com](https://builders.gojinko.com) and create an API key from the dashboard.
+Sign up at [gojinko.com/dashboard](https://gojinko.com/dashboard) and create an API key from the dashboard.
 
 ### 2. Set your API key
 

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@gojinko/plugin",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "Jinko Travel plugin for Claude Code and OpenAI Codex — flight search, booking, and trip management via MCP",
   "private": false,
   "license": "MIT",
   "author": "Jinko <dev@gojinko.com>",
-  "homepage": "https://builders.gojinko.com",
+  "homepage": "https://gojinko.com",
   "repository": {
     "type": "git",
     "url": "https://github.com/gojinko/jinko-dev-tools",

package/skills/account/SKILL.md

@@ -5,13 +5,13 @@ description: Set up and manage your Jinko developer account — registration, AP
 
 # Developer Account
 
-Manage your Jinko developer account via the [Jinko Builders Dashboard](https://builders.gojinko.com).
+Manage your Jinko developer account via the [Jinko Dashboard](https://gojinko.com/dashboard).
 
 Account management is handled through the web dashboard — there are no MCP tools for account operations. Guide the user to the dashboard for any account-related tasks.
 
 ## Getting started
 
-1. **Register** — go to [builders.gojinko.com](https://builders.gojinko.com) and sign up with your email.
+1. **Register** — go to [gojinko.com/dashboard](https://gojinko.com/dashboard) and sign up with your email.
 2. **Create an API key** — in the dashboard, go to API Keys and create a new key. The full key (prefixed `jnk_`) is shown only once — save it immediately.
 3. **Set your key** — configure your environment:
    - CLI: `jinko auth login` (OAuth) or set `JINKO_API_KEY=jnk_...`

package/skills/cli/SKILL.md

@@ -135,5 +135,5 @@ jinko refund status --ref JNK-A7B3X9 --last-name Doe
 ## See also
 
 - MCP-tool equivalents: sibling skills `search-flights`, `search-hotels`, `book-trip`, `manage-booking`
-- API docs: `https://builders.gojinko.com/docs`
+- API docs: `https://docs.gojinko.com`
 - Source: `packages/cli/src/commands/` in the `jinko-dev-tools` repo

package/skills/search-flights/SKILL.md

@@ -12,7 +12,8 @@ You have access to Jinko MCP tools for flight discovery. Pick the right one base
 | User intent | Tool to use |
 |-----------|-------------|
 | Nothing in mind — wants inspiration | `find_destination` |
-| Route known, flexible on dates | `flight_calendar` |
+| Route known, flexible on dates — wants the full price-per-date list | `flight_calendar` |
+| Route known, flexible on dates — wants a short curated spread of date options ("when should I fly?") | `find_dates` |
 | Route + exact dates, wants live pricing + bookable token | `flight_search` (see the `book-trip` skill) |
 | Route + exact dates, **wants to track price over time** | `price_monitoring` |
 
@@ -56,6 +57,18 @@ Show cheapest prices across a date range for a specific route. Great for "what's
 
 **Response:** List of dates with `price`, `offer_token`, `airline`, `stops`. Includes `cheapest` entry.
 
+## find_dates
+
+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.
+
+**Required params:** same as `flight_calendar` (`origins`, `destinations`, `trip_type`, departure window via `departure_date_ranges`).
+
+**Optional params:** `return_date_ranges` / `stay_days` (roundtrip), `direct_only`, `cabin_class`, `currency`.
+
+**Response:** up to 10 full itineraries (same shape as `flight_calendar`), in chronological order — each the cheapest for its date-pair.
+
+**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.
+
 ## find_flight (legacy — prefer flight_search)
 
 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.