onebusaway-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/get-vehicles.tool.js

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Real-time vehicle positions for all active vehicles for an agency.
+ * @module mcp-server/tools/definitions/get-vehicles.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+/** Format Unix milliseconds as HH:MM. */
+function fmtTime(ms) {
+    if (!ms && ms !== 0)
+        return 'N/A';
+    const d = new Date(ms);
+    const h = d.getHours().toString().padStart(2, '0');
+    const m = d.getMinutes().toString().padStart(2, '0');
+    return `${h}:${m}`;
+}
+export const getVehicles = tool('onebusaway_get_vehicles', {
+    title: 'Get Real-Time Vehicle Positions',
+    description: 'Real-time positions of all active vehicles for an agency. Optionally filter to a single route (client-side). Returns GPS coordinates, heading, schedule deviation, and current trip. Useful for "where are all the buses on route X right now?" Use agencyId values from onebusaway_list_agencies.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        agencyId: z
+            .string()
+            .min(1)
+            .describe('Agency ID (e.g. "1" for Metro Transit, "40" for Sound Transit). Use onebusaway_list_agencies to discover IDs.'),
+        routeId: z
+            .string()
+            .optional()
+            .describe('Optional agency-prefixed route ID to filter results to one route. Filtering is client-side — all agency vehicles are fetched first.'),
+    }),
+    output: z.object({
+        vehicles: z
+            .array(z
+            .object({
+            vehicleId: z.string().describe('Vehicle ID.'),
+            tripId: z.string().nullable().describe('Current trip ID, or null if not on a trip.'),
+            routeId: z.string().nullable().describe('Current route ID, or null.'),
+            routeShortName: z.string().nullable().describe('Route short name, or null.'),
+            tripHeadsign: z.string().nullable().describe('Destination sign text, or null.'),
+            position: z
+                .object({
+                lat: z.number().describe('Vehicle latitude.'),
+                lon: z.number().describe('Vehicle longitude.'),
+            })
+                .describe('Current GPS position.'),
+            lastUpdateTime: z
+                .number()
+                .describe('Timestamp of the last position update as Unix milliseconds.'),
+            phase: z
+                .string()
+                .describe('Current journey phase (e.g. "in_progress", "layover_before").'),
+            scheduleDeviation: z
+                .number()
+                .nullable()
+                .describe('Seconds late (positive) or early (negative), or null.'),
+            orientation: z
+                .number()
+                .nullable()
+                .describe('Heading in degrees (0=north, 90=east), or null.'),
+            nextStop: z.string().nullable().describe('Stop ID of the next stop, or null.'),
+            predicted: z
+                .boolean()
+                .describe('True if this vehicle is reporting real-time GPS data.'),
+        })
+            .describe('A real-time vehicle position entry.'))
+            .describe('Active vehicles for the agency, optionally filtered by route.'),
+    }),
+    errors: [
+        {
+            reason: 'agency_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Agency ID does not exist on this instance.',
+            recovery: 'Use onebusaway_list_agencies to get valid agency IDs for this instance.',
+        },
+    ],
+    async handler(input, ctx) {
+        const vehicles = await getOneBusAwayService().getVehicles({
+            agencyId: input.agencyId,
+            ...(input.routeId && { routeId: input.routeId }),
+        }, ctx);
+        ctx.log.info('getVehicles completed', { agencyId: input.agencyId, count: vehicles.length });
+        return { vehicles };
+    },
+    format: (result) => {
+        if (result.vehicles.length === 0) {
+            return [{ type: 'text', text: 'No active vehicles found.' }];
+        }
+        const lines = [`**Active vehicles:** ${result.vehicles.length}`];
+        for (const v of result.vehicles) {
+            lines.push(`\n## Vehicle ${v.vehicleId}`);
+            if (v.routeShortName) {
+                lines.push(`**Route:** ${v.routeShortName}${v.tripHeadsign ? ` → ${v.tripHeadsign}` : ''}`);
+            }
+            if (v.routeId)
+                lines.push(`**Route ID:** ${v.routeId}`);
+            if (v.tripId)
+                lines.push(`**Trip ID:** ${v.tripId}`);
+            lines.push(`**Position:** ${v.position.lat.toFixed(5)}, ${v.position.lon.toFixed(5)}`);
+            lines.push(`**Phase:** ${v.phase} | **Predicted:** ${v.predicted}`);
+            if (v.scheduleDeviation != null) {
+                const devLabel = v.scheduleDeviation === 0
+                    ? 'on time'
+                    : v.scheduleDeviation > 0
+                        ? `${Math.round(v.scheduleDeviation / 60)} min late`
+                        : `${Math.round(Math.abs(v.scheduleDeviation) / 60)} min early`;
+                lines.push(`**Schedule deviation:** ${devLabel} (${v.scheduleDeviation}s)`);
+            }
+            if (v.orientation != null)
+                lines.push(`**Heading:** ${v.orientation}°`);
+            if (v.nextStop)
+                lines.push(`**Next stop:** ${v.nextStop}`);
+            lines.push(`**Last update:** ${fmtTime(v.lastUpdateTime)} (${v.lastUpdateTime})`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-vehicles.tool.js.map

package/dist/mcp-server/tools/definitions/get-vehicles.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-vehicles.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-vehicles.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/list-agencies.tool.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview List all transit agencies on this OneBusAway instance.
+ * @module mcp-server/tools/definitions/list-agencies.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const listAgencies: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    agencies: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        timezone: z.ZodString;
+        coverageCenter: z.ZodObject<{
+            lat: z.ZodNumber;
+            lon: z.ZodNumber;
+        }, z.core.$strip>;
+        coverageSpan: z.ZodObject<{
+            latSpan: z.ZodNumber;
+            lonSpan: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=list-agencies.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-agencies.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-agencies.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-agencies.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;6BAwDvB,CAAC"}

package/dist/mcp-server/tools/definitions/list-agencies.tool.js

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview List all transit agencies on this OneBusAway instance.
+ * @module mcp-server/tools/definitions/list-agencies.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+export const listAgencies = tool('onebusaway_list_agencies', {
+    title: 'List Transit Agencies',
+    description: 'List all transit agencies served by this OneBusAway instance. Returns agency IDs, names, contact info, timezone, and geographic coverage center. Agency IDs are needed for onebusaway_list_routes_for_agency and onebusaway_get_vehicles.',
+    annotations: { readOnlyHint: true, openWorldHint: false },
+    input: z.object({}),
+    output: z.object({
+        agencies: z
+            .array(z
+            .object({
+            id: z.string().describe('Agency ID used in other calls (e.g. "1" for Metro Transit).'),
+            name: z.string().describe('Full agency name.'),
+            url: z.string().describe('Agency website URL.'),
+            phone: z.string().nullable().describe('Agency phone number, or null if not provided.'),
+            timezone: z.string().describe('Agency timezone (e.g. "America/Los_Angeles").'),
+            coverageCenter: z
+                .object({
+                lat: z.number().describe('Latitude of the coverage center.'),
+                lon: z.number().describe('Longitude of the coverage center.'),
+            })
+                .describe("Geographic center of the agency's service area."),
+            coverageSpan: z
+                .object({
+                latSpan: z.number().describe('Latitude span of the coverage area in degrees.'),
+                lonSpan: z.number().describe('Longitude span of the coverage area in degrees.'),
+            })
+                .describe("Geographic extent of the agency's service area."),
+        })
+            .describe('A transit agency with coverage information.'))
+            .describe('All agencies served by this OneBusAway instance.'),
+    }),
+    async handler(_input, ctx) {
+        const agencies = await getOneBusAwayService().listAgencies(ctx);
+        ctx.log.info('listAgencies completed', { count: agencies.length });
+        return { agencies };
+    },
+    format: (result) => {
+        if (result.agencies.length === 0) {
+            return [{ type: 'text', text: 'No agencies found.' }];
+        }
+        const lines = [];
+        for (const a of result.agencies) {
+            lines.push(`## ${a.name}`);
+            lines.push(`**ID:** ${a.id} | **Timezone:** ${a.timezone}`);
+            lines.push(`**URL:** ${a.url}`);
+            if (a.phone)
+                lines.push(`**Phone:** ${a.phone}`);
+            lines.push(`**Coverage center:** ${a.coverageCenter.lat.toFixed(4)}, ${a.coverageCenter.lon.toFixed(4)} (±${a.coverageSpan.latSpan.toFixed(3)}° lat, ±${a.coverageSpan.lonSpan.toFixed(3)}° lon)`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=list-agencies.tool.js.map

package/dist/mcp-server/tools/definitions/list-agencies.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-agencies.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-agencies.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/list-routes-for-agency.tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview List all routes operated by a specific agency.
+ * @module mcp-server/tools/definitions/list-routes-for-agency.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const listRoutesForAgency: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    agencyId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    routes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        shortName: z.ZodString;
+        longName: z.ZodString;
+        description: z.ZodString;
+        type: z.ZodNumber;
+        color: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "agency_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Agency ID does not exist on this instance.";
+    readonly recovery: "Use onebusaway_list_agencies to get valid agency IDs for this instance.";
+}]>;
+//# sourceMappingURL=list-routes-for-agency.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-routes-for-agency.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-routes-for-agency.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-routes-for-agency.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;GAoE9B,CAAC"}

package/dist/mcp-server/tools/definitions/list-routes-for-agency.tool.js

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview List all routes operated by a specific agency.
+ * @module mcp-server/tools/definitions/list-routes-for-agency.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+export const listRoutesForAgency = tool('onebusaway_list_routes_for_agency', {
+    title: 'List Routes for Agency',
+    description: "List all routes operated by an agency. Returns route IDs, short names, and descriptions. Use to enumerate an agency's full service before searching for a specific route. Get agencyId values from onebusaway_list_agencies.",
+    annotations: { readOnlyHint: true, openWorldHint: false },
+    input: z.object({
+        agencyId: z
+            .string()
+            .min(1)
+            .describe('Agency ID (e.g. "1" for Metro Transit, "40" for Sound Transit). Use onebusaway_list_agencies to discover IDs.'),
+    }),
+    output: z.object({
+        routes: z
+            .array(z
+            .object({
+            id: z
+                .string()
+                .describe('Agency-prefixed route ID. Use with onebusaway_get_schedule_for_route or onebusaway_get_vehicles.'),
+            shortName: z.string().describe('The number or short name displayed on vehicles.'),
+            longName: z.string().describe('Full route name.'),
+            description: z.string().describe('Route description.'),
+            type: z
+                .number()
+                .describe('GTFS route type: 0=tram, 1=subway, 2=rail, 3=bus, 4=ferry, 5=cable_car.'),
+            color: z.string().nullable().describe('Route brand color hex (without #), or null.'),
+            url: z.string().nullable().describe('Agency schedule page URL, or null.'),
+        })
+            .describe('A transit route operated by this agency.'))
+            .describe('All routes operated by this agency.'),
+    }),
+    errors: [
+        {
+            reason: 'agency_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Agency ID does not exist on this instance.',
+            recovery: 'Use onebusaway_list_agencies to get valid agency IDs for this instance.',
+        },
+    ],
+    async handler(input, ctx) {
+        const routes = await getOneBusAwayService().listRoutesForAgency(input.agencyId, ctx);
+        ctx.log.info('listRoutesForAgency completed', {
+            agencyId: input.agencyId,
+            count: routes.length,
+        });
+        return { routes };
+    },
+    format: (result) => {
+        if (result.routes.length === 0) {
+            return [{ type: 'text', text: 'No routes found for this agency.' }];
+        }
+        const lines = [`**Routes:** ${result.routes.length}`];
+        for (const r of result.routes) {
+            lines.push(`\n## ${r.shortName}${r.longName ? ` — ${r.longName}` : ''}`);
+            lines.push(`**ID:** ${r.id} | **Type:** ${r.type}`);
+            if (r.description)
+                lines.push(`**Description:** ${r.description}`);
+            if (r.color)
+                lines.push(`**Color:** #${r.color}`);
+            if (r.url)
+                lines.push(`**Schedule URL:** ${r.url}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=list-routes-for-agency.tool.js.map

package/dist/mcp-server/tools/definitions/list-routes-for-agency.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-routes-for-agency.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-routes-for-agency.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/search-routes.tool.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Search for routes by name or number.
+ * @module mcp-server/tools/definitions/search-routes.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const searchRoutes: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    maxCount: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    routes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        shortName: z.ZodString;
+        longName: z.ZodString;
+        description: z.ZodString;
+        agencyId: z.ZodString;
+        agencyName: z.ZodString;
+        type: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "endpoint_unavailable";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The search/route endpoint returns 404 on this OBA instance (e.g. Puget Sound).";
+    readonly recovery: "Use onebusaway_find_routes with a lat/lon near the service area, or onebusaway_list_routes_for_agency with a known agency ID to browse all routes.";
+}]>;
+//# sourceMappingURL=search-routes.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-routes.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-routes.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-routes.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;GAsEvB,CAAC"}

package/dist/mcp-server/tools/definitions/search-routes.tool.js

@@ -0,0 +1,68 @@
+/**
+ * @fileoverview Search for routes by name or number.
+ * @module mcp-server/tools/definitions/search-routes.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+export const searchRoutes = tool('onebusaway_search_routes', {
+    title: 'Search Routes by Name or Number',
+    description: 'Search for routes by name or number. Returns matching routes with IDs. Use to resolve a route short name (e.g. "44") to a route ID for schedule or vehicle lookups with onebusaway_get_vehicles or onebusaway_get_schedule_for_route.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        query: z.string().min(1).describe('Route name or number (e.g. "44", "Link", or "RapidRide").'),
+        maxCount: z
+            .number()
+            .default(10)
+            .describe('Maximum number of results to return. Defaults to 10.'),
+    }),
+    output: z.object({
+        routes: z
+            .array(z
+            .object({
+            id: z
+                .string()
+                .describe('Agency-prefixed route ID (e.g. "1_100259"). Use with onebusaway_get_vehicles or onebusaway_get_schedule_for_route.'),
+            shortName: z
+                .string()
+                .describe('The number or short name displayed on vehicles (e.g. "44").'),
+            longName: z.string().describe('Full route name.'),
+            description: z.string().describe('Route description.'),
+            agencyId: z.string().describe('Agency ID that operates this route.'),
+            agencyName: z.string().describe('Agency name that operates this route.'),
+            type: z
+                .number()
+                .describe('GTFS route type: 0=tram, 1=subway, 2=rail, 3=bus, 4=ferry, 5=cable_car.'),
+        })
+            .describe('A transit route with agency and type information.'))
+            .describe('Routes matching the search query.'),
+    }),
+    errors: [
+        {
+            reason: 'endpoint_unavailable',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The search/route endpoint returns 404 on this OBA instance (e.g. Puget Sound).',
+            recovery: 'Use onebusaway_find_routes with a lat/lon near the service area, or onebusaway_list_routes_for_agency with a known agency ID to browse all routes.',
+        },
+    ],
+    async handler(input, ctx) {
+        const routes = await getOneBusAwayService().searchRoutes({ query: input.query, maxCount: input.maxCount }, ctx);
+        ctx.log.info('searchRoutes completed', { query: input.query, count: routes.length });
+        return { routes };
+    },
+    format: (result) => {
+        if (result.routes.length === 0) {
+            return [{ type: 'text', text: 'No routes found matching the query.' }];
+        }
+        const lines = [`**Routes found:** ${result.routes.length}`];
+        for (const r of result.routes) {
+            lines.push(`\n## ${r.shortName}${r.longName ? ` — ${r.longName}` : ''}`);
+            lines.push(`**ID:** ${r.id} | **Agency:** ${r.agencyName} (${r.agencyId})`);
+            if (r.description)
+                lines.push(`**Description:** ${r.description}`);
+            lines.push(`**Type:** ${r.type}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-routes.tool.js.map

package/dist/mcp-server/tools/definitions/search-routes.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-routes.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-routes.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/search-stops.tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Search for stops by name or code string.
+ * @module mcp-server/tools/definitions/search-stops.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchStops: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    maxCount: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    stops: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        code: z.ZodString;
+        name: z.ZodString;
+        lat: z.ZodNumber;
+        lon: z.ZodNumber;
+        direction: z.ZodString;
+        routeIds: z.ZodArray<z.ZodString>;
+        wheelchairBoarding: z.ZodEnum<{
+            ACCESSIBLE: "ACCESSIBLE";
+            NOT_ACCESSIBLE: "NOT_ACCESSIBLE";
+            UNKNOWN: "UNKNOWN";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=search-stops.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-stops.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-stops.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-stops.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;6BA+DtB,CAAC"}

package/dist/mcp-server/tools/definitions/search-stops.tool.js

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Search for stops by name or code string.
+ * @module mcp-server/tools/definitions/search-stops.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+export const searchStops = tool('onebusaway_search_stops', {
+    title: 'Search Stops by Name or Code',
+    description: 'Search for stops by name or code. Returns matching stops with IDs and coordinates. Use to resolve a human-readable stop name or number to a stop ID for arrivals lookups with onebusaway_get_arrivals.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        query: z
+            .string()
+            .min(1)
+            .describe('Stop name fragment or stop code (e.g. "University Way" or "75403").'),
+        maxCount: z
+            .number()
+            .default(10)
+            .describe('Maximum number of results to return. Defaults to 10.'),
+    }),
+    output: z.object({
+        stops: z
+            .array(z
+            .object({
+            id: z
+                .string()
+                .describe('Agency-prefixed stop ID (e.g. "1_75403"). Use with onebusaway_get_arrivals.'),
+            code: z.string().describe('The stop code printed on the sign.'),
+            name: z.string().describe('Stop name.'),
+            lat: z.number().describe('Latitude of the stop.'),
+            lon: z.number().describe('Longitude of the stop.'),
+            direction: z.string().describe('Compass direction of travel at this stop.'),
+            routeIds: z.array(z.string()).describe('IDs of routes that serve this stop.'),
+            wheelchairBoarding: z
+                .enum(['ACCESSIBLE', 'NOT_ACCESSIBLE', 'UNKNOWN'])
+                .describe('Wheelchair boarding status.'),
+        })
+            .describe('A transit stop with location and route information.'))
+            .describe('Stops matching the search query.'),
+    }),
+    async handler(input, ctx) {
+        const stops = await getOneBusAwayService().searchStops({ query: input.query, maxCount: input.maxCount }, ctx);
+        ctx.log.info('searchStops completed', { query: input.query, count: stops.length });
+        return { stops };
+    },
+    format: (result) => {
+        if (result.stops.length === 0) {
+            return [{ type: 'text', text: 'No stops found matching the query.' }];
+        }
+        const lines = [`**Stops found:** ${result.stops.length}`];
+        for (const s of result.stops) {
+            lines.push(`\n## ${s.name}`);
+            lines.push(`**ID:** ${s.id} | **Code:** ${s.code} | **Direction:** ${s.direction}`);
+            lines.push(`**Coordinates:** ${s.lat.toFixed(6)}, ${s.lon.toFixed(6)}`);
+            lines.push(`**Routes:** ${s.routeIds.join(', ') || 'none'}`);
+            lines.push(`**Wheelchair:** ${s.wheelchairBoarding}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-stops.tool.js.map

package/dist/mcp-server/tools/definitions/search-stops.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-stops.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-stops.tool.ts"],"names":[],"mappings":"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"}

package/dist/services/onebusaway/onebusaway-service.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview OneBusAway SDK wrapper service. Initializes the SDK client and exposes
+ * typed methods for all API operations used by the tool handlers.
+ * @module services/onebusaway/onebusaway-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { ServerConfig } from '../../config/server-config.js';
+import type { Agency, ArrivalsResult, Route, RouteScheduleResult, Stop, StopScheduleResult, TripResult, VehicleEntry } from './types.js';
+export declare class OneBusAwayService {
+    private readonly client;
+    constructor(config: ServerConfig);
+    listAgencies(ctx: Context): Promise<Agency[]>;
+    findStops(params: {
+        lat: number;
+        lon: number;
+        radius?: number;
+        query?: string;
+    }, ctx: Context): Promise<{
+        stops: Stop[];
+        limitExceeded: boolean;
+    }>;
+    getStop(stopId: string, ctx: Context): Promise<Stop>;
+    searchStops(params: {
+        query: string;
+        maxCount?: number;
+    }, ctx: Context): Promise<Stop[]>;
+    findRoutes(params: {
+        lat: number;
+        lon: number;
+        radius?: number;
+        query?: string;
+    }, ctx: Context): Promise<Route[]>;
+    getRoute(routeId: string, ctx: Context): Promise<Route>;
+    listRoutesForAgency(agencyId: string, ctx: Context): Promise<Route[]>;
+    searchRoutes(params: {
+        query: string;
+        maxCount?: number;
+    }, ctx: Context): Promise<Route[]>;
+    getArrivals(params: {
+        stopId: string;
+        minutesBefore?: number;
+        minutesAfter?: number;
+    }, ctx: Context): Promise<ArrivalsResult>;
+    getTrip(params: {
+        tripId: string;
+        serviceDate?: number;
+        includeSchedule?: boolean;
+    }, ctx: Context): Promise<TripResult>;
+    getVehicles(params: {
+        agencyId: string;
+        routeId?: string;
+    }, ctx: Context): Promise<VehicleEntry[]>;
+    getScheduleForStop(params: {
+        stopId: string;
+        date?: string;
+    }, ctx: Context): Promise<StopScheduleResult>;
+    getScheduleForRoute(params: {
+        routeId: string;
+        date?: string;
+    }, ctx: Context): Promise<RouteScheduleResult>;
+}
+export declare function initOneBusAwayService(config: ServerConfig): void;
+export declare function getOneBusAwayService(): OneBusAwayService;
+//# sourceMappingURL=onebusaway-service.d.ts.map

package/dist/services/onebusaway/onebusaway-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onebusaway-service.d.ts","sourceRoot":"","sources":["../../../src/services/onebusaway/onebusaway-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EACV,MAAM,EAEN,cAAc,EACd,KAAK,EACL,mBAAmB,EAGnB,IAAI,EACJ,kBAAkB,EAElB,UAAU,EACV,YAAY,EACb,MAAM,YAAY,CAAC;AAiFpB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,MAAM,EAAE,YAAY;IAU1B,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0B7C,SAAS,CACb,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EACrE,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAkB/C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpD,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAkBxF,UAAU,CACd,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EACrE,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,KAAK,EAAE,CAAC;IAkBb,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAavD,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAcrE,YAAY,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAmB1F,WAAW,CACf,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,EACzE,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,cAAc,CAAC;IAkEpB,OAAO,CACX,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,EAC3E,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,UAAU,CAAC;IAuDhB,WAAW,CACf,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAC9C,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,YAAY,EAAE,CAAC;IA8CpB,kBAAkB,CACtB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EACzC,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,kBAAkB,CAAC;IAqCxB,mBAAmB,CACvB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAC1C,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,mBAAmB,CAAC;CAwDhC;AAMD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAEhE;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAKxD"}