@reneturcios/flightdata 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rene Turcios
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,152 @@
-# Temporary Holding Version
+# flightdata
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+flightdata is a small local bridge to the hosted
+HasData Google Flights MCP server, which returns
+Google Flights search results as JSON. Give it a
+departure, a destination and an outbound date, and
+it fetches matching itineraries: each option's
+price, total duration and stops, its flight legs
+with airline, flight number, aircraft, airports
+and times, and its CO2 emissions, plus the booking
+and departure tokens the upstream issues for
+following up on a chosen itinerary.
+
+Searches cover one-way, round-trip and multi-city
+trips. They can be shaped by passenger mix (adults,
+children, infants in a seat or on a lap), travel
+class, carry-on bags, a maximum price, sort order
+(price, duration, emissions, departure or arrival
+time), stop limits, included or excluded airlines
+and connections, departure and return time windows,
+layover duration bounds, a maximum total duration,
+an emissions preference and a deep-search mode.
+
+The bridge stores no fares of its own. It serves
+the upstream server's tool list locally, exactly as
+captured from the live endpoint, and forwards each
+tool call upstream, returning the result untouched.
+The captured surface is a single read-only fare
+search: there is no booking, reservation, ticketing
+or payment tool in it.
+
+## Tools
+
+- `hasdata_google_travel_flights_getGoogleFlights`
+  — search Google Flights. Required: `departureId`
+  (IATA code or location kgmid; comma-separated
+  multiples allowed), `arrivalId` (same formats),
+  and `outboundDate` (`yyyy-MM-dd`). Optional:
+  `returnDate`, `type` (`roundTrip` / `oneWay` /
+  `multiCity`), `multiCityJson`, `gl`, `hl`,
+  `currency`, `travelClass` (`economy` /
+  `premiumEconomy` / `business` / `first`),
+  `showHidden`, `adults`, `children`,
+  `infantsInSeat`, `infantsOnLap`, `sortBy`
+  (`topFlights` / `price` / `departureTime` /
+  `arrivalTime` / `duration` / `emissions`),
+  `stops` (`nonStop` / `oneStopOrFewer` /
+  `twoStopsOrFewer`), `excludeAirlines`,
+  `includeAirlines`, `bags`, `maxPrice`,
+  `outboundTimes`, `returnTimes`, `lessEmissions`,
+  `layoverDuration`, `includeConnections`,
+  `excludeConnections`, `maxDuration`, `deepSearch`,
+  `departureToken` and `bookingToken`. Returns
+  per-itinerary price, duration, stops and legs,
+  emissions, and booking/departure tokens.
+
+## Configuration
+
+- `HASDATA_GOOGLE_FLIGHTS_MCP_URL` (optional) —
+  override the upstream endpoint. Defaults to
+  `https://mcp.hasdata.com/mcp?apis=google_travel_flights`.
+  (The override hook is this rebuild's own labelled
+  reconstruction.)
+- `HASDATA_API_KEY` (optional) — when set, every
+  upstream request carries an `x-api-key: <key>`
+  header, for the caller's own HasData API key. When
+  it is not set, no key header is sent. (The header
+  name and the env name are pinned by the original's
+  registry record; forwarding the key from this env
+  var is a labelled reconstruction — the original
+  surface was captured keyless.)
+
+### Forwarding mechanics
+
+On the first tool call the client opens a streamable
+HTTP session with the upstream: a JSON-RPC
+`initialize` request (protocolVersion `2025-03-26`,
+clientInfo name `flightdata`), then a
+`notifications/initialized` notification, then the
+`tools/call` request carrying the caller's arguments
+unchanged. When the upstream answers `initialize`
+with an `Mcp-Session-Id` header, that value rides on
+every later request of the session, which is reused
+for the life of the process. Replies may arrive as
+plain JSON or as server-sent events; both are read.
+
+Successful upstream results pass through verbatim,
+including any `isError` flag the upstream sets.
+Failures — a JSON-RPC error, a non-2xx status, an
+unreadable response, or a request that cannot be
+completed — come back as an `isError` result whose
+text starts with `flightdata error:` (this rendering
+is this rebuild's own labelled reconstruction).
+
+## CLI
+
+The tool is also a subcommand taking one JSON
+argument string:
+
+```bash
+npx @reneturcios/flightdata hasdata_google_travel_flights_getGoogleFlights '{"departureId":"SFO","arrivalId":"LHR","outboundDate":"2026-12-01","type":"oneWay","travelClass":"economy","stops":"nonStop"}'
+npx @reneturcios/flightdata --version
+```
+
+Exit codes: `0` on success, `1` on an `isError`
+result, `2` on a usage error.
+
+## MCP server
+
+```bash
+npx -y @reneturcios/flightdata mcp
+```
+
+MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "flightdata": {
+      "command": "npx",
+      "args": ["-y", "@reneturcios/flightdata", "mcp"]
+    }
+  }
+}
+```
+
+## Docker
+
+```bash
+docker run -i ghcr.io/cloudcorprecords/flightdata
+docker run --rm ghcr.io/cloudcorprecords/flightdata --version
+```
+
+The container's default command is `mcp`, so the first
+form is a stdio MCP server; any other arguments reach
+the CLI normally.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run dev
+```
+
+The test suite runs entirely against a stubbed
+JSON-RPC upstream — no live network calls.
+
+## License
+
+MIT — see `LICENSE`.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+/**
+ * flightdata CLI.
+ *
+ *   flightdata <tool> '<json-args>'
+ *   flightdata mcp
+ *   flightdata --version
+ *
+ * <tool> is the 1 forwarded tool. Each tool subcommand
+ * takes one JSON argument string with the tool's
+ * arguments, forwards the call like the MCP path, and
+ * prints the forwarded result content. Exit codes:
+ * 0 success, 1 on an isError result, 2 usage error.
+ */
+import { callTool, TOOL_NAMES, VERSION } from "./forward.js";
+function usage() {
+    console.error(`Usage:
+  flightdata <tool> '<json-args>'     one of: ${TOOL_NAMES.join(", ")}
+  flightdata mcp
+  flightdata --version`);
+    process.exit(2);
+}
+function firstText(result) {
+    const content = result.content;
+    if (Array.isArray(content)) {
+        for (const item of content) {
+            if (item !== null &&
+                typeof item === "object" &&
+                item.type === "text" &&
+                typeof item.text === "string") {
+                return item.text;
+            }
+        }
+    }
+    return typeof content === "string" ? content : JSON.stringify(content);
+}
+async function main() {
+    const [cmd, ...rest] = process.argv.slice(2);
+    if (cmd === "--version" || cmd === "-v") {
+        console.log(VERSION);
+        return;
+    }
+    if (cmd === "mcp") {
+        if (rest.length !== 0)
+            usage();
+        const { startMcpServer } = await import("./mcp.js");
+        await startMcpServer();
+        return;
+    }
+    if (!TOOL_NAMES.includes(cmd ?? ""))
+        usage();
+    if (rest.length > 1)
+        usage();
+    let args = {};
+    if (rest.length === 1) {
+        try {
+            const parsed = JSON.parse(rest[0]);
+            if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+                usage();
+            }
+            args = parsed;
+        }
+        catch {
+            console.error("error: argument must be a JSON object string");
+            process.exit(2);
+        }
+    }
+    const result = await callTool(cmd, args);
+    if (result.isError) {
+        console.error(`error: ${firstText(result)}`);
+        process.exit(1);
+    }
+    console.log(typeof result.content === "string"
+        ? result.content
+        : JSON.stringify(result.content, null, 2));
+}
+void main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/forward.d.ts

@@ -0,0 +1,84 @@
+/**
+ * flightdata core: a forwarding client for the hosted
+ * HasData Google Flights MCP server.
+ *
+ * No flight search is run locally. tools/list is answered from
+ * the literal tool definition below, taken verbatim from
+ * a live capture of the upstream server (name, title,
+ * description and inputSchema exactly as captured,
+ * including the title key the tool carries). A tools/call
+ * is forwarded over a streamable-HTTP JSON-RPC session:
+ * an initialize POST, a notifications/initialized POST,
+ * then the tools/call POST, honouring the Mcp-Session-Id
+ * response header when the upstream issues one. The
+ * session is established lazily on the first forwarded
+ * call and reused for the lifetime of the client.
+ *
+ * The upstream endpoint is pinned to
+ * https://mcp.hasdata.com/mcp?apis=google_travel_flights — the query
+ * string is part of the pinned URL — and can be
+ * overridden with the HASDATA_GOOGLE_FLIGHTS_MCP_URL environment
+ * variable (that override is a labelled reconstruction).
+ * When HASDATA_API_KEY is set in the environment, every
+ * upstream request carries an `x-api-key: <key>` header
+ * (the header name is pinned by the registry record's
+ * remote declaration; forwarding the key from this env
+ * var is a labelled reconstruction — the capture itself
+ * was taken keyless). When the variable is unset, no key
+ * header is sent, and no Authorization header is sent in
+ * either case.
+ *
+ * Upstream results pass through verbatim, including any
+ * isError flag and any extra result fields. Failures — a
+ * JSON-RPC error from the upstream, a non-2xx status, an
+ * unparseable response, or a fetch that throws or times
+ * out — surface as an isError result whose text starts
+ * with `flightdata error:` (that rendering is a labelled
+ * reconstruction). Responses may be plain JSON or SSE
+ * (data: lines); the JSON-RPC message with the matching
+ * id wins.
+ */
+import type { ForwardDeps, ToolArgs, ToolDef, ToolResult } from "./types.js";
+export declare const VERSION = "0.1.0";
+export declare const DEFAULT_ENDPOINT_URL = "https://mcp.hasdata.com/mcp?apis=google_travel_flights";
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const PROTOCOL_VERSION = "2025-03-26";
+export declare const TOOL_DEFS: ToolDef[];
+export declare const TOOL_NAMES: string[];
+/** Whether `name` is one of the captured tools. */
+export declare function isKnownTool(name: string): boolean;
+/**
+ * Parse a JSON-RPC response body, tolerating SSE framing.
+ * Returns the message whose id matches `expectedId` when
+ * one is present, else the last parseable message, else
+ * null when nothing parses.
+ */
+export declare function parseRpcBody(text: string, expectedId?: number): Record<string, unknown> | null;
+/**
+ * A forwarding client holding one upstream session. The
+ * session is established lazily on the first forwarded
+ * call and reused for the lifetime of the client (the
+ * process lifetime when the client is the MCP server's
+ * or a one-shot client for the CLI).
+ */
+export declare class FlightdataClient {
+    private readonly deps;
+    private sessionId;
+    private ready;
+    private sessionPromise;
+    private idCounter;
+    constructor(deps?: ForwardDeps);
+    private fetchFn;
+    private endpointUrl;
+    private apiKey;
+    private timeoutMs;
+    private nextId;
+    private post;
+    private ensureSession;
+    /** Forward one tool call; upstream failures come back as isError results. */
+    callTool(name: string, args: ToolArgs): Promise<ToolResult>;
+}
+/** Create a forwarding client; tests inject a fake fetch and env through deps. */
+export declare function createClient(deps?: ForwardDeps): FlightdataClient;
+/** One-shot helper: a fresh client per call (the CLI path). */
+export declare function callTool(name: string, args: ToolArgs, deps?: ForwardDeps): Promise<ToolResult>;

package/dist/forward.js

@@ -0,0 +1,409 @@
+export const VERSION = "0.1.0";
+export const DEFAULT_ENDPOINT_URL = "https://mcp.hasdata.com/mcp?apis=google_travel_flights";
+export const DEFAULT_TIMEOUT_MS = 30000;
+export const PROTOCOL_VERSION = "2025-03-26";
+/* ------------------------------------------------------------------ */
+/* Tool definitions (tools/list literals, verbatim from the live       */
+/* capture in harness/fixtures/hasdata-google-flights-tools-original.json)       */
+/* ------------------------------------------------------------------ */
+export const TOOL_DEFS = [
+    {
+        "name": "hasdata_google_travel_flights_getGoogleFlights",
+        "title": "google_travel_flights: GET /",
+        "description": "Get Google Flights Results\n\nSearches Google Flights for one-way, round-trip, or multi-city itineraries with passenger mix (adults, children, infants in-seat/on-lap), travel class, bags, max price, sort order (price, duration, emissions, departure/arrival time), stops, include/exclude airlines and connections, time windows, layover duration, and deep-search mode. Returns per-itinerary price, total duration, stops, flight legs with airline, flight number, aircraft, departure/arrival airports and times, CO2 emissions, plus booking and departure tokens for round-trip returns or booking options. Use for travel-planning agents, fare monitoring, corporate travel dashboards, emission-aware trip optimization, and comparing routes and airlines across markets.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "departureId": {
+                    "type": "string",
+                    "description": "Specifies the departure airport code (IATA) or location kgmid.\n\n  - **IATA Code**: A 3-letter uppercase code (e.g., SFO for San Francisco, LHR for London Heathrow). Search on [IATA](https://www.iata.org/en/publications/directories/code-search).\n  - **Location kgmid**: A string starting with `/m/`, found in Wikidata under \"Freebase ID\" (e.g., `/m/02_286` for New York, NY).\n\nMultiple values can be separated by commas (e.g., `JFK,LGA,/m/0hptm`).\n"
+                },
+                "arrivalId": {
+                    "type": "string",
+                    "description": "Specifies the arrival airport code (IATA) or location kgmid.\n\n  - **IATA Code**: A 3-letter uppercase code (e.g., `SFO` for San Francisco, `LHR` for London Heathrow). Search on [IATA](https://www.iata.org/en/publications/directories/code-search).\n  - **Location kgmid**: A string starting with `/m/`, found in Wikidata under \"Freebase ID\" (e.g., `/m/02_286` for New York, NY).\n\nMultiple values can be separated by commas (e.g., `JFK,LGA,/m/0hptm`).\n"
+                },
+                "outboundDate": {
+                    "type": "string",
+                    "description": "The outbound travel date in 'yyyy-MM-dd' format.\n"
+                },
+                "returnDate": {
+                    "type": "string",
+                    "description": "The return travel date in 'yyyy-MM-dd' format. Required when **type** is `roundTrip`.\n"
+                },
+                "type": {
+                    "type": "string",
+                    "enum": [
+                        "roundTrip",
+                        "oneWay",
+                        "multiCity"
+                    ],
+                    "description": "Specifies the type of flight. Options:\n\n  - `roundTrip` (default)\n  - `oneWay`\n  - `multiCity` (requires `multiCityJson` for flight details)\n\nFor round trips, retrieve return flight details with a separate request using `departureToken`.\n"
+                },
+                "multiCityJson": {
+                    "type": "string",
+                    "description": "This parameter specifies flight details for multi-city trips. It is a JSON string containing multiple flight objects. Each object must include the following fields:\n\n- **departureId** – The departure airport code or location KGMID. Uses the same format as the main `departureId` parameter.\n- **arrivalId** – The arrival airport code or location KGMID. Uses the same format as the main `arrivalId` parameter.\n- **date** – The flight date. Uses the same format as the `outboundDate` parameter.\n- **times** *(optional)* – The time range for the flight. Uses the same format as the `outboundTimes` parameter.\n"
+                },
+                "gl": {
+                    "type": "string",
+                    "description": "The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`."
+                },
+                "hl": {
+                    "type": "string",
+                    "description": "The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`."
+                },
+                "currency": {
+                    "type": "string",
+                    "description": "Parameter defines the currency of the returned prices Provide one exact documented value (71 allowed), e.g. `ALL`, `DZD`."
+                },
+                "travelClass": {
+                    "type": "string",
+                    "enum": [
+                        "economy",
+                        "premiumEconomy",
+                        "business",
+                        "first"
+                    ],
+                    "description": "The travel class for the flight (Economy, Premium Economy, Business, or First).\n"
+                },
+                "showHidden": {
+                    "type": "boolean",
+                    "description": "Indicates whether to include hidden options in the results.\n"
+                },
+                "adults": {
+                    "type": "number",
+                    "description": "Number of adult passengers (>= 1 if specified).\n"
+                },
+                "children": {
+                    "type": "number",
+                    "description": "Number of child passengers.\n"
+                },
+                "infantsInSeat": {
+                    "type": "number",
+                    "description": "Number of infants occupying seats.\n"
+                },
+                "infantsOnLap": {
+                    "type": "number",
+                    "description": "Number of infants sitting on an adult's lap.\n"
+                },
+                "sortBy": {
+                    "type": "string",
+                    "enum": [
+                        "topFlights",
+                        "price",
+                        "departureTime",
+                        "arrivalTime",
+                        "duration",
+                        "emissions"
+                    ],
+                    "description": "Sort the flight results based on price, departure time, arrival time, etc.\n"
+                },
+                "stops": {
+                    "type": "string",
+                    "enum": [
+                        "nonStop",
+                        "oneStopOrFewer",
+                        "twoStopsOrFewer"
+                    ],
+                    "description": "Restrict the number of stops (layovers) in the flight itinerary.\n"
+                },
+                "excludeAirlines": {
+                    "type": "string",
+                    "description": "A comma separated list of airline codes to exclude from results. You can search for airline codes on [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `UA` is United Airlines.\n"
+                },
+                "includeAirlines": {
+                    "type": "string",
+                    "description": "A comma separated list of airline codes to exclusively include in results. You can search for airline codes on [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `UA` is United Airlines.\n\n`excludeAirlines` and `includeAirlines` parameters can't be used together.\n"
+                },
+                "bags": {
+                    "type": "number",
+                    "description": "Number of carry-on bags per passenger.\n"
+                },
+                "maxPrice": {
+                    "type": "number",
+                    "description": "Maximum price limit for the flight search, in the selected currency.\n"
+                },
+                "outboundTimes": {
+                    "type": "string",
+                    "description": "Set up to 4 time boundaries (2 for departure, 2 for arrival) to filter flights. Each number represents the start of an hour.\n\nExamples:\n  - `6,20` → 6:00 AM - 9:00 PM departure\n  - `1,15` → 1:00 AM - 4:00 PM departure\n  - `7,18,2,21` → 7:00 AM - 9:00 PM departure, 2:00 AM - 10:00 PM arrival\n"
+                },
+                "returnTimes": {
+                    "type": "string",
+                    "description": "Set up to 4 time boundaries (2 for departure, 2 for arrival) to filter return flights. Each number represents the start of an hour.\n\nExamples:\n  - `6,20` → 6:00 AM - 9:00 PM departure\n  - `1,15` → 1:00 AM - 4:00 PM departure\n  - `7,18,2,21` → 7:00 AM - 9:00 PM departure, 2:00 AM - 10:00 PM arrival\n"
+                },
+                "lessEmissions": {
+                    "type": "boolean",
+                    "description": "Prefer flight options with lower carbon emissions.\n"
+                },
+                "layoverDuration": {
+                    "type": "string",
+                    "description": "Set the maximum layover duration in minutes to filter flights. For example, `120, 360` filters layovers between 2 hours and 6 hours, while `45, 180` allows layovers from 45 minutes to 3 hours.\n"
+                },
+                "includeConnections": {
+                    "type": "string",
+                    "description": "A comma separated list of specific airports to allow as connections.\n"
+                },
+                "excludeConnections": {
+                    "type": "string",
+                    "description": "A comma separated list of specific airports to exclude as connections.\n"
+                },
+                "maxDuration": {
+                    "type": "number",
+                    "description": "The maximum total flight duration in minutes.\n"
+                },
+                "deepSearch": {
+                    "type": "boolean",
+                    "description": "Enable deep search. Returns the same results as Google Flights in a browser, but takes longer to respond. Default is `false`.\n"
+                },
+                "departureToken": {
+                    "type": "string",
+                    "description": "Used to select a flight and retrieve return flights for a round trip or the next leg of the itinerary for a multi-city trip.\n"
+                },
+                "bookingToken": {
+                    "type": "string",
+                    "description": "Used to request booking options for selected flights. This token is found in the flight results and cannot be used with `departureToken`.\n"
+                }
+            },
+            "required": [
+                "departureId",
+                "arrivalId",
+                "outboundDate"
+            ],
+            "additionalProperties": false,
+            "$schema": "http://json-schema.org/draft-07/schema#"
+        }
+    }
+];
+export const TOOL_NAMES = TOOL_DEFS.map((t) => t.name);
+/** Whether `name` is one of the captured tools. */
+export function isKnownTool(name) {
+    return TOOL_NAMES.includes(name);
+}
+/* ------------------------------------------------------------------ */
+/* Forwarding client                                                   */
+/* ------------------------------------------------------------------ */
+function errorResult(detail) {
+    return {
+        content: [{ type: "text", text: `flightdata error: ${detail}` }],
+        isError: true,
+    };
+}
+function rpcErrorMessage(error) {
+    if (error !== null && typeof error === "object") {
+        const message = error.message;
+        if (typeof message === "string" && message !== "")
+            return message;
+        return JSON.stringify(error);
+    }
+    return String(error);
+}
+/**
+ * Parse a JSON-RPC response body, tolerating SSE framing.
+ * Returns the message whose id matches `expectedId` when
+ * one is present, else the last parseable message, else
+ * null when nothing parses.
+ */
+export function parseRpcBody(text, expectedId) {
+    const trimmed = text.trim();
+    if (trimmed === "")
+        return null;
+    const candidates = [];
+    const tryPush = (payload) => {
+        try {
+            const parsed = JSON.parse(payload);
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                candidates.push(parsed);
+            }
+        }
+        catch {
+            // Not JSON; ignore this candidate.
+        }
+    };
+    if (trimmed.includes("data:")) {
+        for (const line of trimmed.split("\n")) {
+            const t = line.trim();
+            if (!t.startsWith("data:"))
+                continue;
+            const payload = t.slice("data:".length).trim();
+            if (payload !== "" && payload !== "[DONE]")
+                tryPush(payload);
+        }
+    }
+    else {
+        tryPush(trimmed);
+    }
+    if (candidates.length === 0)
+        return null;
+    if (expectedId !== undefined) {
+        const match = candidates.find((c) => c.id === expectedId);
+        if (match !== undefined)
+            return match;
+    }
+    return candidates[candidates.length - 1];
+}
+async function defaultFetch(url, init) {
+    return fetch(url, init);
+}
+/**
+ * A forwarding client holding one upstream session. The
+ * session is established lazily on the first forwarded
+ * call and reused for the lifetime of the client (the
+ * process lifetime when the client is the MCP server's
+ * or a one-shot client for the CLI).
+ */
+export class FlightdataClient {
+    deps;
+    sessionId = null;
+    ready = false;
+    sessionPromise = null;
+    idCounter = 0;
+    constructor(deps = {}) {
+        this.deps = deps;
+    }
+    fetchFn() {
+        return this.deps.fetchFn ?? defaultFetch;
+    }
+    endpointUrl() {
+        if (this.deps.url && this.deps.url.trim() !== "")
+            return this.deps.url.trim();
+        const raw = (this.deps.env ?? process.env).HASDATA_GOOGLE_FLIGHTS_MCP_URL;
+        if (raw && raw.trim() !== "")
+            return raw.trim();
+        return DEFAULT_ENDPOINT_URL;
+    }
+    apiKey() {
+        const raw = (this.deps.env ?? process.env).HASDATA_API_KEY;
+        if (raw && raw.trim() !== "")
+            return raw.trim();
+        return null;
+    }
+    timeoutMs() {
+        if (typeof this.deps.timeoutMs === "number" && this.deps.timeoutMs > 0) {
+            return this.deps.timeoutMs;
+        }
+        return DEFAULT_TIMEOUT_MS;
+    }
+    nextId() {
+        this.idCounter += 1;
+        return this.idCounter;
+    }
+    async post(body, withSession) {
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json, text/event-stream",
+        };
+        const key = this.apiKey();
+        if (key !== null)
+            headers["x-api-key"] = key;
+        if (withSession && this.sessionId !== null) {
+            headers["Mcp-Session-Id"] = this.sessionId;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs());
+        try {
+            return await this.fetchFn()(this.endpointUrl(), {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async ensureSession() {
+        if (this.ready)
+            return;
+        if (this.sessionPromise === null) {
+            this.sessionPromise = (async () => {
+                const initId = this.nextId();
+                const initRes = await this.post({
+                    jsonrpc: "2.0",
+                    id: initId,
+                    method: "initialize",
+                    params: {
+                        protocolVersion: PROTOCOL_VERSION,
+                        capabilities: {},
+                        clientInfo: { name: "flightdata", version: VERSION },
+                    },
+                }, false);
+                const sessionId = initRes.headers.get("mcp-session-id");
+                if (sessionId)
+                    this.sessionId = sessionId;
+                const initText = await initRes.text();
+                const initParsed = parseRpcBody(initText, initId);
+                if (initParsed !== null && initParsed.error) {
+                    throw new Error(rpcErrorMessage(initParsed.error));
+                }
+                if (initRes.status < 200 || initRes.status >= 300) {
+                    throw new Error(`HTTP ${initRes.status}`);
+                }
+                if (initParsed === null && initText.trim() !== "") {
+                    throw new Error("malformed response");
+                }
+                const initializedRes = await this.post({ jsonrpc: "2.0", method: "notifications/initialized" }, true);
+                try {
+                    await initializedRes.text();
+                }
+                catch {
+                    // The notification response body carries nothing we need.
+                }
+                this.ready = true;
+            })();
+        }
+        try {
+            await this.sessionPromise;
+        }
+        catch (err) {
+            this.sessionPromise = null;
+            this.sessionId = null;
+            throw err;
+        }
+    }
+    /** Forward one tool call; upstream failures come back as isError results. */
+    async callTool(name, args) {
+        try {
+            await this.ensureSession();
+        }
+        catch (err) {
+            return errorResult(err instanceof Error ? err.message : String(err));
+        }
+        const callId = this.nextId();
+        let callRes;
+        try {
+            callRes = await this.post({
+                jsonrpc: "2.0",
+                id: callId,
+                method: "tools/call",
+                params: { name, arguments: args ?? {} },
+            }, true);
+        }
+        catch (err) {
+            return errorResult(`request failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const parsed = parseRpcBody(await callRes.text(), callId);
+        if (parsed !== null && parsed.error) {
+            return errorResult(rpcErrorMessage(parsed.error));
+        }
+        if (callRes.status < 200 || callRes.status >= 300) {
+            return errorResult(`HTTP ${callRes.status}`);
+        }
+        if (parsed === null)
+            return errorResult("malformed response");
+        const result = parsed.result;
+        if (result === undefined || result === null || typeof result !== "object") {
+            return errorResult("malformed response");
+        }
+        // Pass the upstream result through verbatim.
+        return result;
+    }
+}
+/** Create a forwarding client; tests inject a fake fetch and env through deps. */
+export function createClient(deps = {}) {
+    return new FlightdataClient(deps);
+}
+/** One-shot helper: a fresh client per call (the CLI path). */
+export async function callTool(name, args, deps = {}) {
+    return new FlightdataClient(deps).callTool(name, args);
+}
+//# sourceMappingURL=forward.js.map

package/dist/forward.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward.js","sourceRoot":"","sources":["../src/forward.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export * from "./forward.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./forward.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,35 @@
+/**
+ * flightdata MCP server. Tools: the 1 captured HasData
+ * Google Flights tool (see forward.ts).
+ *
+ * Why the low-level Server instead of McpServer: the
+ * high-level helper converts zod schemas to JSON Schema
+ * and rewrites the served schemas, which breaks exact
+ * tool-list/schema parity with the live capture. This
+ * file serves tools/list locally from the core's explicit
+ * literals — the verbatim tool objects from the upstream
+ * server's live tools/list — and forwards every
+ * tools/call upstream.
+ *
+ * A forwarded result is returned unchanged (including any
+ * upstream isError flag and extra result fields). An
+ * upstream failure comes back as an isError result
+ * carrying a `flightdata error:` text, synthesised by the
+ * forwarding client. An unknown tool name is rejected
+ * with McpError MethodNotFound, and arguments that are
+ * not a JSON object with McpError InvalidParams, before
+ * any network hop.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { type FlightdataClient } from "./forward.js";
+import type { ForwardDeps, ToolResult } from "./types.js";
+/**
+ * Validate and forward one tools/call through `client`.
+ * Exported so the forwarding behaviour can be tested
+ * directly without a stdio transport.
+ */
+export declare function handleCallTool(client: FlightdataClient, name: string, args: unknown): Promise<ToolResult>;
+/** Build the stdio MCP server (transport not yet connected). */
+export declare function createServer(deps?: ForwardDeps): Server;
+/** Connect the MCP server over stdio. */
+export declare function startMcpServer(deps?: ForwardDeps): Promise<void>;

package/dist/mcp.js

@@ -0,0 +1,60 @@
+/**
+ * flightdata MCP server. Tools: the 1 captured HasData
+ * Google Flights tool (see forward.ts).
+ *
+ * Why the low-level Server instead of McpServer: the
+ * high-level helper converts zod schemas to JSON Schema
+ * and rewrites the served schemas, which breaks exact
+ * tool-list/schema parity with the live capture. This
+ * file serves tools/list locally from the core's explicit
+ * literals — the verbatim tool objects from the upstream
+ * server's live tools/list — and forwards every
+ * tools/call upstream.
+ *
+ * A forwarded result is returned unchanged (including any
+ * upstream isError flag and extra result fields). An
+ * upstream failure comes back as an isError result
+ * carrying a `flightdata error:` text, synthesised by the
+ * forwarding client. An unknown tool name is rejected
+ * with McpError MethodNotFound, and arguments that are
+ * not a JSON object with McpError InvalidParams, before
+ * any network hop.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { createClient, isKnownTool, TOOL_DEFS, VERSION, } from "./forward.js";
+/**
+ * Validate and forward one tools/call through `client`.
+ * Exported so the forwarding behaviour can be tested
+ * directly without a stdio transport.
+ */
+export async function handleCallTool(client, name, args) {
+    if (!isKnownTool(name)) {
+        throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+    }
+    if (args !== undefined &&
+        (typeof args !== "object" || args === null || Array.isArray(args))) {
+        throw new McpError(ErrorCode.InvalidParams, `Arguments for tool ${name} must be a JSON object`);
+    }
+    return client.callTool(name, (args ?? {}));
+}
+/** Build the stdio MCP server (transport not yet connected). */
+export function createServer(deps = {}) {
+    const client = createClient(deps);
+    const server = new Server({ name: "flightdata", version: VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOL_DEFS,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const result = await handleCallTool(client, name, args);
+        return result;
+    });
+    return server;
+}
+/** Connect the MCP server over stdio. */
+export async function startMcpServer(deps = {}) {
+    await createServer(deps).connect(new StdioServerTransport());
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,sBAAsB,EACtB,QAAQ,GACT,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,SAAS,EACT,OAAO,GAER,MAAM,cAAc,CAAC;AAGtB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAwB,EACxB,IAAY,EACZ,IAAa;IAEb,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IACE,IAAI,KAAK,SAAS;QAClB,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAClE,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,sBAAsB,IAAI,wBAAwB,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;AACxE,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,OAAoB,EAAE;IACjD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,EACxC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACxD,OAAO,MAAe,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAoB,EAAE;IACzD,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * flightdata types.
+ *
+ * flightdata holds no flight data of its own. It is a forwarding
+ * client: the captured tool surface lives here as data (ToolDef
+ * entries served verbatim for tools/list) and every tools/call
+ * travels to the hosted HasData Google Flights MCP endpoint through an
+ * injectable fetch, so the test suite never touches the live
+ * network.
+ */
+/** One captured tool definition, served verbatim for tools/list. */
+export interface ToolDef {
+    name: string;
+    title?: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** A tool's arguments, as decoded JSON. */
+export type ToolArgs = Record<string, unknown>;
+/** A tools/call result: upstream results pass through verbatim; failures use this shape. */
+export interface ToolResult {
+    content?: unknown;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+/** The minimal slice of a fetch Response this client relies on. */
+export interface FetchResponseLike {
+    ok: boolean;
+    status: number;
+    headers: {
+        get(name: string): string | null;
+    };
+    text(): Promise<string>;
+}
+/** Injectable fetch, so tests never touch the live network. */
+export type FetchFn = (url: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<FetchResponseLike>;
+/** Runtime dependencies for the forwarding client, all injectable in tests. */
+export interface ForwardDeps {
+    /** Fetch implementation. Defaults to the global fetch. */
+    fetchFn?: FetchFn;
+    /** Environment (HASDATA_GOOGLE_FLIGHTS_MCP_URL, HASDATA_API_KEY). Defaults to process.env. */
+    env?: Record<string, string | undefined>;
+    /** Endpoint URL override. Defaults to env HASDATA_GOOGLE_FLIGHTS_MCP_URL or the pinned default. */
+    url?: string;
+    /** Per-request timeout in ms. Defaults to 30000. */
+    timeoutMs?: number;
+}

package/dist/types.js

@@ -0,0 +1,12 @@
+/**
+ * flightdata types.
+ *
+ * flightdata holds no flight data of its own. It is a forwarding
+ * client: the captured tool surface lives here as data (ToolDef
+ * entries served verbatim for tools/list) and every tools/call
+ * travels to the hosted HasData Google Flights MCP endpoint through an
+ * injectable fetch, so the test suite never touches the live
+ * network.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/package.json

@@ -1,6 +1 @@
-{
-  "name": "@reneturcios/flightdata",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{"bin":{"flightdata":"dist/cli.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1","zod":"^4"},"description":"Google Flights results as JSON from your agent: a local bridge to the hosted HasData Google Flights MCP service that searches one-way, round-trip and multi-city itineraries with passenger mix, travel class, stops, airline and emissions filters, returning per-itinerary prices, durations, legs and tokens as returned upstream. One bin serves a small CLI and a stdio MCP server.","devDependencies":{"@types/node":"^20","tsx":"^4","typescript":"^5"},"engines":{"node":">=20"},"files":["dist","server.json"],"homepage":"https://github.com/CloudCorpRecords/flightdata#readme","license":"MIT","mcpName":"io.github.CloudCorpRecords/flightdata","name":"@reneturcios/flightdata","private":false,"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/CloudCorpRecords/flightdata.git"},"scripts":{"build":"tsc","dev":"tsx src/cli.ts","test":"tsx --test test/*.test.ts"},"type":"module","version":"0.1.0"}

package/server.json

@@ -0,0 +1 @@
+{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","description":"Google Flights search as JSON: itineraries, prices, times, stops and emissions filters.","name":"io.github.CloudCorpRecords/flightdata","packages":[{"identifier":"@reneturcios/flightdata","packageArguments":[{"type":"positional","value":"mcp"}],"registryBaseUrl":"https://registry.npmjs.org","registryType":"npm","runtimeHint":"npx","transport":{"type":"stdio"},"version":"0.1.0"},{"identifier":"ghcr.io/cloudcorprecords/flightdata:0.1.0","packageArguments":[{"type":"positional","value":"mcp"}],"registryType":"oci","runtimeArguments":[{"name":"--rm","type":"named"},{"name":"-i","type":"named"}],"runtimeHint":"docker","transport":{"type":"stdio"}}],"repository":{"source":"github","url":"https://github.com/CloudCorpRecords/flightdata"},"version":"0.1.0"}