@squawk/mcp 0.12.0 → 0.13.0

package/dist/tools/airports.js

@@ -1,11 +1,12 @@
 /**
  * @packageDocumentation
  * MCP tool module wrapping `@squawk/airports` airport lookup methods, backed
- * by the US NASR snapshot in `@squawk/airport-data`. The dataset is loaded
- * and indexed eagerly when the shared {@link airportResolver} is imported.
+ * by the US NASR snapshot in `@squawk/airport-data`. The dataset is imported
+ * and indexed by the first handler to call {@link getAirportResolver}, so a
+ * session that never asks about an airport never pays for the snapshot.
  */
 import { z } from 'zod';
-import { airportResolver } from '../resolvers.js';
+import { getAirportResolver } from '../resolvers.js';
 /** All {@link FacilityType} values, used for input validation. */
 const FACILITY_TYPE_VALUES = [
     'AIRPORT',
@@ -17,20 +18,21 @@ const FACILITY_TYPE_VALUES = [
 ];
 /**
  * Registers airport lookup tools (by FAA ID, by ICAO code, nearest, text
- * search) on the given MCP server. Tools share the {@link airportResolver}
- * singleton built at module load time from the bundled US NASR dataset.
+ * search) on the given MCP server. Tools share the resolver singleton from
+ * {@link getAirportResolver}, which builds the bundled US NASR dataset on
+ * the first invocation and reuses it thereafter.
  *
  * @param server - The MCP server instance to register tools on.
  */
 export function registerAirportTools(server) {
-    const resolver = airportResolver;
     server.registerTool('get_airport_by_faa_id', {
         title: 'Get airport by FAA identifier',
         description: 'Looks up a US airport by its FAA location identifier (e.g. "JFK", "LAX", "3N6"). Returns the full airport record including runways, frequencies, and ILS data, or null if no match is found.',
         inputSchema: {
             faaId: z.string().min(1).describe('FAA location identifier (case-insensitive).'),
         },
-    }, ({ faaId }) => {
+    }, async ({ faaId }) => {
+        const resolver = await getAirportResolver();
         const airport = resolver.byFaaId(faaId);
         if (airport === undefined) {
             return {
@@ -49,7 +51,8 @@ export function registerAirportTools(server) {
         inputSchema: {
             icao: z.string().min(1).describe('ICAO airport code (case-insensitive).'),
         },
-    }, ({ icao }) => {
+    }, async ({ icao }) => {
+        const resolver = await getAirportResolver();
         const airport = resolver.byIcao(icao);
         if (airport === undefined) {
             return {
@@ -89,7 +92,8 @@ export function registerAirportTools(server) {
                 .optional()
                 .describe('Only include airports with at least one runway meeting this length in feet.'),
         },
-    }, ({ lat, lon, maxDistanceNm, limit, facilityTypes, minRunwayLengthFt }) => {
+    }, async ({ lat, lon, maxDistanceNm, limit, facilityTypes, minRunwayLengthFt }) => {
+        const resolver = await getAirportResolver();
         const query = { lat, lon };
         if (maxDistanceNm !== undefined) {
             query.maxDistanceNm = maxDistanceNm;
@@ -134,7 +138,8 @@ export function registerAirportTools(server) {
                 .optional()
                 .describe('Minimum match score (exclusive) in [0, 1] a result must reach. Defaults to 0. Raise it to drop weak fuzzy matches.'),
         },
-    }, ({ text, limit, facilityTypes, minScore }) => {
+    }, async ({ text, limit, facilityTypes, minScore }) => {
+        const resolver = await getAirportResolver();
         const query = { text };
         if (limit !== undefined) {
             query.limit = limit;

package/dist/tools/airspace.d.ts

@@ -6,9 +6,11 @@
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
- * Registers airspace query tools on the given MCP server. The bundled US
- * airspace GeoJSON snapshot is decoded and indexed eagerly via the shared
- * {@link airspaceResolver}.
+ * Registers airspace query tools on the given MCP server. Each handler pulls
+ * the shared resolver from {@link getAirspaceResolver}, which decodes and
+ * indexes the bundled US airspace GeoJSON snapshot on the first invocation.
+ * `get_airspace_for_airport` additionally resolves the airport identifier,
+ * so it loads the airport snapshot alongside the airspace one.
  *
  * @param server - The MCP server instance to register tools on.
  */

package/dist/tools/airspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"airspace.d.ts","sourceRoot":"","sources":["../../src/tools/airspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmFzE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0L7D"}
+{"version":3,"file":"airspace.d.ts","sourceRoot":"","sources":["../../src/tools/airspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmFzE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkM7D"}

package/dist/tools/airspace.js

@@ -5,7 +5,7 @@
  * `@squawk/airspace-data`.
  */
 import { z } from 'zod';
-import { airportResolver, airspaceResolver } from '../resolvers.js';
+import { getAirportResolver, getAirspaceResolver } from '../resolvers.js';
 /** All {@link AirspaceType} values, used for input validation. */
 const AIRSPACE_TYPE_VALUES = [
     'CLASS_B',
@@ -58,9 +58,11 @@ function summarizeFeature(feature) {
     };
 }
 /**
- * Registers airspace query tools on the given MCP server. The bundled US
- * airspace GeoJSON snapshot is decoded and indexed eagerly via the shared
- * {@link airspaceResolver}.
+ * Registers airspace query tools on the given MCP server. Each handler pulls
+ * the shared resolver from {@link getAirspaceResolver}, which decodes and
+ * indexes the bundled US airspace GeoJSON snapshot on the first invocation.
+ * `get_airspace_for_airport` additionally resolves the airport identifier,
+ * so it loads the airport snapshot alongside the airspace one.
  *
  * @param server - The MCP server instance to register tools on.
  */
@@ -79,7 +81,8 @@ export function registerAirspaceTools(server) {
                 .optional()
                 .describe('Restrict results to these airspace types. Omit to include all types.'),
         },
-    }, ({ lat, lon, altitudeFt, airspaceTypes }) => {
+    }, async ({ lat, lon, altitudeFt, airspaceTypes }) => {
+        const airspaceResolver = await getAirspaceResolver();
         const query = { lat, lon, altitudeFt };
         if (airspaceTypes !== undefined) {
             query.types = new Set(airspaceTypes);
@@ -103,7 +106,11 @@ export function registerAirspaceTools(server) {
                 .optional()
                 .describe('Restrict results to these airspace types. Defaults to surface-area classes (CLASS_B, CLASS_C, CLASS_D, CLASS_E2).'),
         },
-    }, ({ airportId, airspaceTypes }) => {
+    }, async ({ airportId, airspaceTypes }) => {
+        const [airportResolver, airspaceResolver] = await Promise.all([
+            getAirportResolver(),
+            getAirspaceResolver(),
+        ]);
         const airport = airportResolver.byFaaId(airportId) ?? airportResolver.byIcao(airportId);
         if (airport === undefined) {
             return {
@@ -131,7 +138,8 @@ export function registerAirspaceTools(server) {
                 .optional()
                 .describe('Altitude in feet MSL. Defaults to 0 (surface), which selects the LOW stratum where applicable. Pass FL180+ to target HIGH or FL600+ to target UTA.'),
         },
-    }, ({ lat, lon, altitudeFt }) => {
+    }, async ({ lat, lon, altitudeFt }) => {
+        const airspaceResolver = await getAirspaceResolver();
         const query = {
             lat,
             lon,
@@ -158,7 +166,8 @@ export function registerAirspaceTools(server) {
                 .optional()
                 .describe('Restrict to a single stratum (LOW, HIGH, UTA, CTA, FIR, or CTA/FIR). Omit to return every published stratum for the center.'),
         },
-    }, ({ artccId, stratum }) => {
+    }, async ({ artccId, stratum }) => {
+        const airspaceResolver = await getAirspaceResolver();
         const features = airspaceResolver.byArtcc(artccId, stratum);
         return {
             content: [{ type: 'text', text: JSON.stringify({ features }, null, 2) }],
@@ -190,7 +199,8 @@ export function registerAirspaceTools(server) {
                 .optional()
                 .describe('Minimum match score (exclusive) in [0, 1] a result must reach. Defaults to 0. Raise it to drop weak fuzzy matches.'),
         },
-    }, ({ text, airspaceTypes, limit, minScore }) => {
+    }, async ({ text, airspaceTypes, limit, minScore }) => {
+        const airspaceResolver = await getAirspaceResolver();
         const query = { text };
         if (airspaceTypes !== undefined) {
             query.types = new Set(airspaceTypes);

package/dist/tools/airways.d.ts

@@ -5,8 +5,9 @@
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
- * Registers airway lookup tools on the given MCP server. Uses the shared
- * {@link airwayResolver} built at module load time.
+ * Registers airway lookup tools on the given MCP server. Each handler pulls
+ * the shared resolver from {@link getAirwayResolver}, which imports and
+ * indexes the bundled US NASR snapshot on the first invocation.
  *
  * @param server - The MCP server instance to register tools on.
  */

package/dist/tools/airways.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"airways.d.ts","sourceRoot":"","sources":["../../src/tools/airways.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2H3D"}
+{"version":3,"file":"airways.d.ts","sourceRoot":"","sources":["../../src/tools/airways.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+H3D"}

package/dist/tools/airways.js

@@ -4,7 +4,7 @@
  * expansion methods, backed by the US NASR snapshot in `@squawk/airway-data`.
  */
 import { z } from 'zod';
-import { airwayResolver } from '../resolvers.js';
+import { getAirwayResolver } from '../resolvers.js';
 /** All {@link AirwayType} values, used for input validation. */
 const AIRWAY_TYPE_VALUES = [
     'VICTOR',
@@ -21,8 +21,9 @@ const AIRWAY_TYPE_VALUES = [
     'PUERTO_RICO',
 ];
 /**
- * Registers airway lookup tools on the given MCP server. Uses the shared
- * {@link airwayResolver} built at module load time.
+ * Registers airway lookup tools on the given MCP server. Each handler pulls
+ * the shared resolver from {@link getAirwayResolver}, which imports and
+ * indexes the bundled US NASR snapshot on the first invocation.
  *
  * @param server - The MCP server instance to register tools on.
  */
@@ -33,8 +34,9 @@ export function registerAirwayTools(server) {
         inputSchema: {
             designation: z.string().min(1).describe('Airway designation (case-insensitive).'),
         },
-    }, ({ designation }) => {
-        const airways = airwayResolver.byDesignation(designation);
+    }, async ({ designation }) => {
+        const resolver = await getAirwayResolver();
+        const airways = resolver.byDesignation(designation);
         return {
             content: [{ type: 'text', text: JSON.stringify(airways, null, 2) }],
             structuredContent: { airways },
@@ -48,8 +50,9 @@ export function registerAirwayTools(server) {
             entryFix: z.string().min(1).describe('Identifier of the entry fix (case-insensitive).'),
             exitFix: z.string().min(1).describe('Identifier of the exit fix (case-insensitive).'),
         },
-    }, ({ designation, entryFix, exitFix }) => {
-        const expansion = airwayResolver.expand(designation, entryFix, exitFix);
+    }, async ({ designation, entryFix, exitFix }) => {
+        const resolver = await getAirwayResolver();
+        const expansion = resolver.expand(designation, entryFix, exitFix);
         if (expansion === undefined) {
             return {
                 content: [
@@ -75,8 +78,9 @@ export function registerAirwayTools(server) {
                 .min(1)
                 .describe('Fix, navaid, or waypoint identifier (case-insensitive).'),
         },
-    }, ({ ident }) => {
-        const results = airwayResolver.byFix(ident);
+    }, async ({ ident }) => {
+        const resolver = await getAirwayResolver();
+        const results = resolver.byFix(ident);
         return {
             content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
             structuredContent: { results },
@@ -107,7 +111,8 @@ export function registerAirwayTools(server) {
                 .optional()
                 .describe('Minimum match score (exclusive) in [0, 1] a result must reach. Defaults to 0. Raise it to drop weak fuzzy matches.'),
         },
-    }, ({ text, airwayTypes, limit, minScore }) => {
+    }, async ({ text, airwayTypes, limit, minScore }) => {
+        const resolver = await getAirwayResolver();
         const query = { text };
         if (airwayTypes !== undefined) {
             query.types = new Set(airwayTypes);
@@ -118,7 +123,7 @@ export function registerAirwayTools(server) {
         if (minScore !== undefined) {
             query.minScore = minScore;
         }
-        const airways = airwayResolver.search(query);
+        const airways = resolver.search(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(airways, null, 2) }],
             structuredContent: { airways },

package/dist/tools/datasets.d.ts

@@ -1,16 +1,23 @@
 /**
  * @packageDocumentation
  * MCP tool module exposing build provenance and record counts for every
- * bundled FAA snapshot the server loads. Lets an LLM client report exactly
- * which NASR cycle and registry vintage answered a query - critical context
- * for aviation use, where stale data is a real safety concern.
+ * bundled FAA snapshot the server can serve. Lets an LLM client report
+ * exactly which NASR cycle and registry vintage answered a query - critical
+ * context for aviation use, where stale data is a real safety concern.
+ *
+ * Every dataset's metadata comes from its data package's `/meta` subpath, a
+ * generated constant carrying the cycle date, build timestamp, and record
+ * counts. Reading it costs nothing, so reporting status never pulls a
+ * snapshot into memory that a session did not otherwise need. Each entry also
+ * carries whether its records are currently loaded, which is the one fact
+ * that has to be read from the resolver layer.
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
  * Registers the `get_dataset_status` tool on the given MCP server. The tool
- * takes no input and reports the NASR cycle date, generation timestamp, and
- * record counts for each loaded snapshot. The lazily-loaded ICAO registry
- * reports its load state without being initialized as a side effect.
+ * takes no input and reports the cycle effective date, generation timestamp,
+ * and record counts for every bundled snapshot, along with whether each one
+ * is currently loaded. Answering does not load anything.
  *
  * @param server - The MCP server instance to register tools on.
  */

package/dist/tools/datasets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../src/tools/datasets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8D5D"}
+{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../src/tools/datasets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAezE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkC5D"}

package/dist/tools/datasets.js

@@ -1,68 +1,47 @@
 /**
  * @packageDocumentation
  * MCP tool module exposing build provenance and record counts for every
- * bundled FAA snapshot the server loads. Lets an LLM client report exactly
- * which NASR cycle and registry vintage answered a query - critical context
- * for aviation use, where stale data is a real safety concern.
+ * bundled FAA snapshot the server can serve. Lets an LLM client report
+ * exactly which NASR cycle and registry vintage answered a query - critical
+ * context for aviation use, where stale data is a real safety concern.
+ *
+ * Every dataset's metadata comes from its data package's `/meta` subpath, a
+ * generated constant carrying the cycle date, build timestamp, and record
+ * counts. Reading it costs nothing, so reporting status never pulls a
+ * snapshot into memory that a session did not otherwise need. Each entry also
+ * carries whether its records are currently loaded, which is the one fact
+ * that has to be read from the resolver layer.
  */
-import { usBundledAirports } from '@squawk/airport-data';
-import { usBundledAirspace } from '@squawk/airspace-data';
-import { usBundledAirways } from '@squawk/airway-data';
-import { usBundledFixes } from '@squawk/fix-data';
-import { usBundledNavaids } from '@squawk/navaid-data';
-import { usBundledProcedures } from '@squawk/procedure-data';
-import { getIcaoRegistryMetadata, isIcaoRegistryLoaded } from '../resolvers.js';
+import { usBundledAirportsProperties } from '@squawk/airport-data/meta';
+import { usBundledAirspaceProperties } from '@squawk/airspace-data/meta';
+import { usBundledAirwaysProperties } from '@squawk/airway-data/meta';
+import { usBundledFixesProperties } from '@squawk/fix-data/meta';
+import { usBundledNavaidsProperties } from '@squawk/navaid-data/meta';
+import { usBundledProceduresProperties } from '@squawk/procedure-data/meta';
+import { getBundledDatasetLoadState, getIcaoRegistryMetadata, isIcaoRegistryLoaded, } from '../resolvers.js';
 /**
  * Registers the `get_dataset_status` tool on the given MCP server. The tool
- * takes no input and reports the NASR cycle date, generation timestamp, and
- * record counts for each loaded snapshot. The lazily-loaded ICAO registry
- * reports its load state without being initialized as a side effect.
+ * takes no input and reports the cycle effective date, generation timestamp,
+ * and record counts for every bundled snapshot, along with whether each one
+ * is currently loaded. Answering does not load anything.
  *
  * @param server - The MCP server instance to register tools on.
  */
 export function registerDatasetTools(server) {
     server.registerTool('get_dataset_status', {
         title: 'Report status of every bundled dataset',
-        description: 'Returns the cycle effective date (FAA NASR for airports/airspace/navaids/fixes/airways; FAA CIFP for procedures), build timestamp, and record counts for each dataset the server loads (airports, airspace, navaids, fixes, airways, procedures, ICAO aircraft registry). Use this when a user asks "how current is the data?" or before answering a question that depends on procedure/navaid currency. The aircraft registry is lazily loaded and reports its load state without forcing initialization.',
+        description: 'Returns the cycle effective date (FAA NASR for airports/airspace/navaids/fixes/airways; FAA CIFP for procedures), build timestamp, and record counts for every dataset the server can serve, plus a `loaded` flag saying whether that dataset is currently in memory. Use this when a user asks "how current is the data?" or before answering a question that depends on procedure/navaid currency. Calling it is cheap and never forces a dataset to load, so `loaded: false` means only that nothing has needed that snapshot yet - the cycle dates it reports are accurate either way. The aircraft registry is an optional peer package, so it reports its vintage only once a lookup has loaded it.',
         inputSchema: {},
     }, () => {
+        const loadState = getBundledDatasetLoadState();
         const registryMetadata = getIcaoRegistryMetadata();
         const datasets = {
-            airports: {
-                nasrCycleDate: usBundledAirports.properties.nasrCycleDate,
-                generatedAt: usBundledAirports.properties.generatedAt,
-                recordCount: usBundledAirports.properties.recordCount,
-            },
-            airspace: {
-                nasrCycleDate: usBundledAirspace.properties.nasrCycleDate,
-                generatedAt: usBundledAirspace.properties.generatedAt,
-                featureCount: usBundledAirspace.properties.featureCount,
-            },
-            navaids: {
-                nasrCycleDate: usBundledNavaids.properties.nasrCycleDate,
-                generatedAt: usBundledNavaids.properties.generatedAt,
-                recordCount: usBundledNavaids.properties.recordCount,
-            },
-            fixes: {
-                nasrCycleDate: usBundledFixes.properties.nasrCycleDate,
-                generatedAt: usBundledFixes.properties.generatedAt,
-                recordCount: usBundledFixes.properties.recordCount,
-            },
-            airways: {
-                nasrCycleDate: usBundledAirways.properties.nasrCycleDate,
-                generatedAt: usBundledAirways.properties.generatedAt,
-                recordCount: usBundledAirways.properties.recordCount,
-                waypointCount: usBundledAirways.properties.waypointCount,
-            },
-            procedures: {
-                cifpCycleDate: usBundledProcedures.properties.cifpCycleDate,
-                generatedAt: usBundledProcedures.properties.generatedAt,
-                recordCount: usBundledProcedures.properties.recordCount,
-                sidCount: usBundledProcedures.properties.sidCount,
-                starCount: usBundledProcedures.properties.starCount,
-                iapCount: usBundledProcedures.properties.iapCount,
-                legCount: usBundledProcedures.properties.legCount,
-            },
+            airports: { loaded: loadState.airports, ...usBundledAirportsProperties },
+            airspace: { loaded: loadState.airspace, ...usBundledAirspaceProperties },
+            navaids: { loaded: loadState.navaids, ...usBundledNavaidsProperties },
+            fixes: { loaded: loadState.fixes, ...usBundledFixesProperties },
+            airways: { loaded: loadState.airways, ...usBundledAirwaysProperties },
+            procedures: { loaded: loadState.procedures, ...usBundledProceduresProperties },
             icaoRegistry: registryMetadata !== undefined
                 ? {
                     loaded: true,

package/dist/tools/fixes.d.ts

@@ -5,8 +5,9 @@
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
- * Registers fix/waypoint lookup tools on the given MCP server. Uses the
- * shared {@link fixResolver} built at module load time.
+ * Registers fix/waypoint lookup tools on the given MCP server. Each handler
+ * pulls the shared resolver from {@link getFixResolver}, which imports and
+ * indexes the bundled US NASR snapshot on the first invocation.
  *
  * @param server - The MCP server instance to register tools on.
  */

package/dist/tools/fixes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixes.d.ts","sourceRoot":"","sources":["../../src/tools/fixes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBzE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwJxD"}
+{"version":3,"file":"fixes.d.ts","sourceRoot":"","sources":["../../src/tools/fixes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBzE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4JxD"}

package/dist/tools/fixes.js

@@ -4,7 +4,7 @@
  * backed by the US NASR snapshot in `@squawk/fix-data`.
  */
 import { z } from 'zod';
-import { fixResolver } from '../resolvers.js';
+import { getFixResolver } from '../resolvers.js';
 /** All {@link FixUseCode} values, used for input validation. */
 const FIX_USE_CODE_VALUES = [
     'WP',
@@ -17,8 +17,9 @@ const FIX_USE_CODE_VALUES = [
     'RADAR',
 ];
 /**
- * Registers fix/waypoint lookup tools on the given MCP server. Uses the
- * shared {@link fixResolver} built at module load time.
+ * Registers fix/waypoint lookup tools on the given MCP server. Each handler
+ * pulls the shared resolver from {@link getFixResolver}, which imports and
+ * indexes the bundled US NASR snapshot on the first invocation.
  *
  * @param server - The MCP server instance to register tools on.
  */
@@ -29,8 +30,9 @@ export function registerFixTools(server) {
         inputSchema: {
             ident: z.string().min(1).describe('Fix identifier (case-insensitive).'),
         },
-    }, ({ ident }) => {
-        const fixes = fixResolver.byIdent(ident);
+    }, async ({ ident }) => {
+        const resolver = await getFixResolver();
+        const fixes = resolver.byIdent(ident);
         return {
             content: [{ type: 'text', text: JSON.stringify(fixes, null, 2) }],
             structuredContent: { fixes },
@@ -57,8 +59,9 @@ export function registerFixTools(server) {
                 .optional()
                 .describe('Maximum great-circle distance in nautical miles. Omit to let the nearest match win regardless of distance.'),
         },
-    }, ({ ident, lat, lon, toleranceNm }) => {
-        const fix = fixResolver.byIdentAtPosition(ident, lat, lon, toleranceNm) ?? null;
+    }, async ({ ident, lat, lon, toleranceNm }) => {
+        const resolver = await getFixResolver();
+        const fix = resolver.byIdentAtPosition(ident, lat, lon, toleranceNm) ?? null;
         return {
             content: [{ type: 'text', text: JSON.stringify(fix, null, 2) }],
             structuredContent: { fix },
@@ -86,7 +89,8 @@ export function registerFixTools(server) {
                 .optional()
                 .describe('Restrict results to these FAA fix-use codes (e.g. WP=waypoint, RP=reporting point, VFR=VFR waypoint). Omit to include all use codes.'),
         },
-    }, ({ lat, lon, maxDistanceNm, limit, useCodes }) => {
+    }, async ({ lat, lon, maxDistanceNm, limit, useCodes }) => {
+        const resolver = await getFixResolver();
         const query = { lat, lon };
         if (maxDistanceNm !== undefined) {
             query.maxDistanceNm = maxDistanceNm;
@@ -97,7 +101,7 @@ export function registerFixTools(server) {
         if (useCodes !== undefined) {
             query.useCodes = new Set(useCodes);
         }
-        const results = fixResolver.nearest(query);
+        const results = resolver.nearest(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
             structuredContent: { results },
@@ -128,7 +132,8 @@ export function registerFixTools(server) {
                 .optional()
                 .describe('Minimum match score (exclusive) in [0, 1] a result must reach. Defaults to 0. Raise it to drop weak fuzzy matches.'),
         },
-    }, ({ text, useCodes, limit, minScore }) => {
+    }, async ({ text, useCodes, limit, minScore }) => {
+        const resolver = await getFixResolver();
         const query = { text };
         if (useCodes !== undefined) {
             query.useCodes = new Set(useCodes);
@@ -139,7 +144,7 @@ export function registerFixTools(server) {
         if (minScore !== undefined) {
             query.minScore = minScore;
         }
-        const fixes = fixResolver.search(query);
+        const fixes = resolver.search(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(fixes, null, 2) }],
             structuredContent: { fixes },

package/dist/tools/flightplan.d.ts

@@ -3,13 +3,15 @@
  * MCP tool module wrapping `@squawk/flightplan` route-string parsing and
  * great-circle distance computation. The flightplan resolver composes the
  * shared airport, navaid, fix, airway, and procedure resolvers from the
- * package's `resolvers` module.
+ * package's `resolvers` module, so the first route parsed in a session loads
+ * all five of those snapshots.
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
  * Registers flight plan parsing and route distance tools on the given MCP
- * server. The flightplan resolver is built once at registration time and
- * shares the bundled NASR data via the resolver singletons.
+ * server. Each handler pulls the composed resolver from
+ * {@link getFlightplanResolver}, which builds it from the bundled NASR and
+ * CIFP snapshots on the first invocation.
  *
  * @param server - The MCP server instance to register tools on.
  */

package/dist/tools/flightplan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flightplan.d.ts","sourceRoot":"","sources":["../../src/tools/flightplan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgJ/D"}
+{"version":3,"file":"flightplan.d.ts","sourceRoot":"","sources":["../../src/tools/flightplan.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoDzE;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4I/D"}

package/dist/tools/flightplan.js

@@ -3,26 +3,47 @@
  * MCP tool module wrapping `@squawk/flightplan` route-string parsing and
  * great-circle distance computation. The flightplan resolver composes the
  * shared airport, navaid, fix, airway, and procedure resolvers from the
- * package's `resolvers` module.
+ * package's `resolvers` module, so the first route parsed in a session loads
+ * all five of those snapshots.
  */
 import { z } from 'zod';
 import { computeRouteDistance, computeRouteTiming, createFlightplanResolver, extractRoutePoints, routeToLineString, } from '@squawk/flightplan';
-import { airportResolver, airwayResolver, fixResolver, navaidResolver, procedureResolver, } from '../resolvers.js';
+import { getAirportResolver, getAirwayResolver, getFixResolver, getNavaidResolver, getProcedureResolver, } from '../resolvers.js';
+/**
+ * Memoized composed resolver. Holding the promise rather than the finished
+ * resolver means concurrent route parses share one load of the five
+ * underlying snapshots instead of each building their own composition.
+ */
+let flightplanResolver;
+/**
+ * Returns the composed flightplan resolver, loading the five snapshots it
+ * draws on (airports, navaids, fixes, airways, procedures) in parallel on the
+ * first call. A rejected load clears the memo so a later call can retry.
+ *
+ * @returns The shared flightplan resolver.
+ */
+function getFlightplanResolver() {
+    flightplanResolver ??= Promise.all([
+        getAirportResolver(),
+        getNavaidResolver(),
+        getFixResolver(),
+        getAirwayResolver(),
+        getProcedureResolver(),
+    ]).then(([airports, navaids, fixes, airways, procedures]) => createFlightplanResolver({ airports, navaids, fixes, airways, procedures }), (err) => {
+        flightplanResolver = undefined;
+        throw err;
+    });
+    return flightplanResolver;
+}
 /**
  * Registers flight plan parsing and route distance tools on the given MCP
- * server. The flightplan resolver is built once at registration time and
- * shares the bundled NASR data via the resolver singletons.
+ * server. Each handler pulls the composed resolver from
+ * {@link getFlightplanResolver}, which builds it from the bundled NASR and
+ * CIFP snapshots on the first invocation.
  *
  * @param server - The MCP server instance to register tools on.
  */
 export function registerFlightplanTools(server) {
-    const resolver = createFlightplanResolver({
-        airports: airportResolver,
-        navaids: navaidResolver,
-        fixes: fixResolver,
-        airways: airwayResolver,
-        procedures: procedureResolver,
-    });
     server.registerTool('parse_flightplan_route', {
         title: 'Parse a flight plan route string',
         description: 'Parses a whitespace-separated flight plan route string (e.g. "KJFK DCT MERIT J60 MARTN DCT KLAX") into structured route elements. Each token is classified as an airport, SID, STAR, airway, direct (DCT), waypoint, lat/lon coordinate, speed/altitude group, or unresolved. Airway tokens are expanded into waypoint sequences between the entry and exit fixes. SID/STAR tokens are expanded into their first common route, and the dotted PROCCODE.TRANSITION form (e.g. "NUBLE4.JJIMY") additionally merges the named transition\'s waypoints into the expansion.',
@@ -32,7 +53,8 @@ export function registerFlightplanTools(server) {
                 .min(1)
                 .describe('Whitespace-separated route string in ICAO Item 15 conventions.'),
         },
-    }, ({ routeString }) => {
+    }, async ({ routeString }) => {
+        const resolver = await getFlightplanResolver();
         const route = resolver.parse(routeString);
         return {
             content: [{ type: 'text', text: JSON.stringify(route, null, 2) }],
@@ -53,7 +75,8 @@ export function registerFlightplanTools(server) {
                 .optional()
                 .describe('Optional ground speed in knots used to compute estimated time enroute. Omit to skip ETE.'),
         },
-    }, ({ routeString, groundSpeedKt }) => {
+    }, async ({ routeString, groundSpeedKt }) => {
+        const resolver = await getFlightplanResolver();
         const route = resolver.parse(routeString);
         const result = computeRouteDistance(route, groundSpeedKt);
         return {
@@ -70,7 +93,8 @@ export function registerFlightplanTools(server) {
                 .min(1)
                 .describe('Whitespace-separated route string in ICAO Item 15 conventions.'),
         },
-    }, ({ routeString }) => {
+    }, async ({ routeString }) => {
+        const resolver = await getFlightplanResolver();
         const route = resolver.parse(routeString);
         const points = extractRoutePoints(route);
         const lineString = routeToLineString(route);
@@ -114,7 +138,8 @@ export function registerFlightplanTools(server) {
                 .optional()
                 .describe('Optional fuel on board in the same unit as fuelBurnPerHr. With the burn rate, enables endurance and fuel-sufficiency reporting.'),
         },
-    }, ({ routeString, trueAirspeedKt, wind, fuelBurnPerHr, fuelAvailable }) => {
+    }, async ({ routeString, trueAirspeedKt, wind, fuelBurnPerHr, fuelAvailable }) => {
+        const resolver = await getFlightplanResolver();
         const route = resolver.parse(routeString);
         const result = computeRouteTiming(route, {
             trueAirspeedKt,

package/dist/tools/navaids.d.ts

@@ -5,8 +5,9 @@
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
- * Registers navaid lookup tools on the given MCP server. Uses the shared
- * {@link navaidResolver} built at module load time.
+ * Registers navaid lookup tools on the given MCP server. Each handler pulls
+ * the shared resolver from {@link getNavaidResolver}, which imports and
+ * indexes the bundled US NASR snapshot on the first invocation.
  *
  * @param server - The MCP server instance to register tools on.
  */

package/dist/tools/navaids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navaids.d.ts","sourceRoot":"","sources":["../../src/tools/navaids.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6L3D"}
+{"version":3,"file":"navaids.d.ts","sourceRoot":"","sources":["../../src/tools/navaids.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkM3D"}