@squawk/mcp 0.12.1 → 0.13.0

package/dist/tools/navaids.js

@@ -4,7 +4,7 @@
  * by the US NASR snapshot in `@squawk/navaid-data`.
  */
 import { z } from 'zod';
-import { navaidResolver } from '../resolvers.js';
+import { getNavaidResolver } from '../resolvers.js';
 /** All {@link NavaidType} values, used for input validation. */
 const NAVAID_TYPE_VALUES = [
     'VOR',
@@ -19,8 +19,9 @@ const NAVAID_TYPE_VALUES = [
     'VOT',
 ];
 /**
- * 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.
  */
@@ -31,8 +32,9 @@ export function registerNavaidTools(server) {
         inputSchema: {
             ident: z.string().min(1).describe('Navaid identifier (case-insensitive).'),
         },
-    }, ({ ident }) => {
-        const navaids = navaidResolver.byIdent(ident);
+    }, async ({ ident }) => {
+        const resolver = await getNavaidResolver();
+        const navaids = resolver.byIdent(ident);
         return {
             content: [{ type: 'text', text: JSON.stringify(navaids, null, 2) }],
             structuredContent: { navaids },
@@ -59,8 +61,9 @@ export function registerNavaidTools(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 navaid = navaidResolver.byIdentAtPosition(ident, lat, lon, toleranceNm) ?? null;
+    }, async ({ ident, lat, lon, toleranceNm }) => {
+        const resolver = await getNavaidResolver();
+        const navaid = resolver.byIdentAtPosition(ident, lat, lon, toleranceNm) ?? null;
         return {
             content: [{ type: 'text', text: JSON.stringify(navaid, null, 2) }],
             structuredContent: { navaid },
@@ -85,7 +88,8 @@ export function registerNavaidTools(server) {
                 .optional()
                 .describe('Maximum number of results to return. Defaults to 20.'),
         },
-    }, ({ frequency, navaidTypes, limit }) => {
+    }, async ({ frequency, navaidTypes, limit }) => {
+        const resolver = await getNavaidResolver();
         const query = { frequency };
         if (navaidTypes !== undefined) {
             query.types = new Set(navaidTypes);
@@ -93,7 +97,7 @@ export function registerNavaidTools(server) {
         if (limit !== undefined) {
             query.limit = limit;
         }
-        const navaids = navaidResolver.byFrequency(query);
+        const navaids = resolver.byFrequency(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(navaids, null, 2) }],
             structuredContent: { navaids },
@@ -121,7 +125,8 @@ export function registerNavaidTools(server) {
                 .optional()
                 .describe('Restrict results to these navaid types. Omit to include all types.'),
         },
-    }, ({ lat, lon, maxDistanceNm, limit, navaidTypes }) => {
+    }, async ({ lat, lon, maxDistanceNm, limit, navaidTypes }) => {
+        const resolver = await getNavaidResolver();
         const query = { lat, lon };
         if (maxDistanceNm !== undefined) {
             query.maxDistanceNm = maxDistanceNm;
@@ -132,7 +137,7 @@ export function registerNavaidTools(server) {
         if (navaidTypes !== undefined) {
             query.types = new Set(navaidTypes);
         }
-        const results = navaidResolver.nearest(query);
+        const results = resolver.nearest(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
             structuredContent: { results },
@@ -163,7 +168,8 @@ export function registerNavaidTools(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, navaidTypes, limit, minScore }) => {
+    }, async ({ text, navaidTypes, limit, minScore }) => {
+        const resolver = await getNavaidResolver();
         const query = { text };
         if (navaidTypes !== undefined) {
             query.types = new Set(navaidTypes);
@@ -174,7 +180,7 @@ export function registerNavaidTools(server) {
         if (minScore !== undefined) {
             query.minScore = minScore;
         }
-        const navaids = navaidResolver.search(query);
+        const navaids = resolver.search(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(navaids, null, 2) }],
             structuredContent: { navaids },

package/dist/tools/procedures.d.ts

@@ -7,8 +7,9 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
  * Registers procedure lookup tools (SIDs, STARs, and IAPs) on the given
- * MCP server. Uses the shared {@link procedureResolver} built at module
- * load time from the bundled FAA CIFP snapshot.
+ * MCP server. Each handler pulls the shared resolver from
+ * {@link getProcedureResolver}, which imports and indexes the bundled FAA
+ * CIFP snapshot on the first invocation.
  *
  * @param server - The MCP server instance to register tools on.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../../src/tools/procedures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiCzE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgQ9D"}
+{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../../src/tools/procedures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiCzE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwQ9D"}

package/dist/tools/procedures.js

@@ -6,7 +6,7 @@
  */
 import { z } from 'zod';
 import { expansionToLineString, extractLegPoints } from '@squawk/procedures';
-import { procedureResolver } from '../resolvers.js';
+import { getProcedureResolver } from '../resolvers.js';
 /** All {@link ProcedureType} values, used for input validation. */
 const PROCEDURE_TYPE_VALUES = ['SID', 'STAR', 'IAP'];
 /** All {@link ApproachType} values, used for input validation. */
@@ -31,8 +31,9 @@ const APPROACH_TYPE_VALUES = [
 ];
 /**
  * Registers procedure lookup tools (SIDs, STARs, and IAPs) on the given
- * MCP server. Uses the shared {@link procedureResolver} built at module
- * load time from the bundled FAA CIFP snapshot.
+ * MCP server. Each handler pulls the shared resolver from
+ * {@link getProcedureResolver}, which imports and indexes the bundled FAA
+ * CIFP snapshot on the first invocation.
  *
  * @param server - The MCP server instance to register tools on.
  */
@@ -46,8 +47,9 @@ export function registerProcedureTools(server) {
                 .min(1)
                 .describe('CIFP procedure identifier (case-insensitive). Examples: "AALLE4", "NUBLE4", "I04L", "R13".'),
         },
-    }, ({ identifier }) => {
-        const procedures = procedureResolver.byIdentifier(identifier);
+    }, async ({ identifier }) => {
+        const resolver = await getProcedureResolver();
+        const procedures = resolver.byIdentifier(identifier);
         return {
             content: [{ type: 'text', text: JSON.stringify(procedures, null, 2) }],
             structuredContent: { procedures },
@@ -63,8 +65,9 @@ export function registerProcedureTools(server) {
                 .describe('Airport identifier (ICAO or FAA, case-insensitive).'),
             identifier: z.string().min(1).describe('CIFP procedure identifier (case-insensitive).'),
         },
-    }, ({ airportId, identifier }) => {
-        const procedure = procedureResolver.byAirportAndIdentifier(airportId, identifier);
+    }, async ({ airportId, identifier }) => {
+        const resolver = await getProcedureResolver();
+        const procedure = resolver.byAirportAndIdentifier(airportId, identifier);
         if (procedure === undefined) {
             return {
                 content: [
@@ -87,8 +90,9 @@ export function registerProcedureTools(server) {
         inputSchema: {
             airportId: z.string().min(1).describe('Airport identifier (case-insensitive).'),
         },
-    }, ({ airportId }) => {
-        const procedures = procedureResolver.byAirport(airportId);
+    }, async ({ airportId }) => {
+        const resolver = await getProcedureResolver();
+        const procedures = resolver.byAirport(airportId);
         return {
             content: [{ type: 'text', text: JSON.stringify(procedures, null, 2) }],
             structuredContent: { procedures },
@@ -104,8 +108,9 @@ export function registerProcedureTools(server) {
                 .min(1)
                 .describe('Runway identifier, without the "RW" prefix (e.g. "04L", "13", "27R").'),
         },
-    }, ({ airportId, runway }) => {
-        const procedures = procedureResolver.byAirportAndRunway(airportId, runway);
+    }, async ({ airportId, runway }) => {
+        const resolver = await getProcedureResolver();
+        const procedures = resolver.byAirportAndRunway(airportId, runway);
         return {
             content: [{ type: 'text', text: JSON.stringify(procedures, null, 2) }],
             structuredContent: { procedures },
@@ -119,8 +124,9 @@ export function registerProcedureTools(server) {
                 .enum(APPROACH_TYPE_VALUES)
                 .describe('Approach classification. Use LOC_BC for localizer back-course approaches.'),
         },
-    }, ({ approachType }) => {
-        const procedures = procedureResolver.byApproachType(approachType);
+    }, async ({ approachType }) => {
+        const resolver = await getProcedureResolver();
+        const procedures = resolver.byApproachType(approachType);
         return {
             content: [{ type: 'text', text: JSON.stringify(procedures, null, 2) }],
             structuredContent: { procedures },
@@ -138,8 +144,9 @@ export function registerProcedureTools(server) {
                 .optional()
                 .describe('Optional transition name. Omit to return just the common route.'),
         },
-    }, ({ airportId, identifier, transitionName }) => {
-        const expansion = procedureResolver.expand(airportId, identifier, transitionName);
+    }, async ({ airportId, identifier, transitionName }) => {
+        const resolver = await getProcedureResolver();
+        const expansion = resolver.expand(airportId, identifier, transitionName);
         if (expansion === undefined) {
             return {
                 content: [
@@ -171,8 +178,9 @@ export function registerProcedureTools(server) {
                 .optional()
                 .describe('Optional transition name. Omit to use just the common route.'),
         },
-    }, ({ airportId, identifier, transitionName }) => {
-        const expansion = procedureResolver.expand(airportId, identifier, transitionName);
+    }, async ({ airportId, identifier, transitionName }) => {
+        const resolver = await getProcedureResolver();
+        const expansion = resolver.expand(airportId, identifier, transitionName);
         if (expansion === undefined) {
             return {
                 content: [
@@ -221,7 +229,8 @@ export function registerProcedureTools(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, procedureType, approachType, limit, minScore }) => {
+    }, async ({ text, procedureType, approachType, limit, minScore }) => {
+        const resolver = await getProcedureResolver();
         const query = { text };
         if (procedureType !== undefined) {
             query.type = procedureType;
@@ -235,7 +244,7 @@ export function registerProcedureTools(server) {
         if (minScore !== undefined) {
             query.minScore = minScore;
         }
-        const procedures = procedureResolver.search(query);
+        const procedures = resolver.search(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(procedures, null, 2) }],
             structuredContent: { procedures },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squawk/mcp",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "type": "module",
   "description": "Model Context Protocol server exposing squawk's aviation libraries as tools for LLM clients",
   "author": "Neil Cochran",
@@ -41,22 +41,22 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@squawk/airport-data": "^0.7.12",
+    "@squawk/airport-data": "^0.8.0",
     "@squawk/airports": "^0.7.1",
     "@squawk/airspace": "^0.9.1",
-    "@squawk/airspace-data": "^0.5.2",
-    "@squawk/airway-data": "^0.5.12",
+    "@squawk/airspace-data": "^0.6.0",
+    "@squawk/airway-data": "^0.6.0",
     "@squawk/airways": "^0.5.1",
-    "@squawk/fix-data": "^0.6.12",
+    "@squawk/fix-data": "^0.7.0",
     "@squawk/fixes": "^0.5.1",
     "@squawk/flight-math": "^0.5.3",
     "@squawk/flightplan": "^0.6.1",
     "@squawk/geo": "^0.4.10",
     "@squawk/icao-registry": "^0.5.8",
-    "@squawk/navaid-data": "^0.6.12",
+    "@squawk/navaid-data": "^0.7.0",
     "@squawk/navaids": "^0.6.1",
     "@squawk/notams": "^0.3.12",
-    "@squawk/procedure-data": "^0.7.10",
+    "@squawk/procedure-data": "^0.8.0",
     "@squawk/procedures": "^0.7.1",
     "@squawk/types": "^0.9.0",
     "@squawk/weather": "^0.6.1",