@cyanheads/wsdot-mcp-server 0.1.1

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

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Tool to fetch Canada border crossing wait times from the WSDOT Traffic API.
+ * @module mcp-server/tools/definitions/get-border-waits.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getTrafficApiService } from '../../../services/traffic/traffic-service.js';
+export const getBorderWaits = tool('wsdot_get_border_waits', {
+    title: 'Get Border Wait Times',
+    description: 'Returns current vehicle wait times at all WA/Canada land border crossings: ' +
+        'Peace Arch (Blaine), Pacific Highway (Blaine), Sumas, Lynden, Oroville, and others. ' +
+        'Wait times are in minutes. Use for "how long is the border wait?" questions.',
+    annotations: { readOnlyHint: true },
+    input: z.object({}),
+    output: z.object({
+        crossings: z
+            .array(z
+            .object({
+            crossingName: z.string().optional().describe('Name of the border crossing.'),
+            waitTimeInMinutes: z
+                .number()
+                .optional()
+                .describe('Current vehicle wait time in minutes.'),
+            updateTime: z.string().optional().describe('When this wait time was last updated.'),
+            location: z
+                .object({
+                roadName: z.string().optional().describe('Road serving the crossing.'),
+                direction: z.string().optional().describe('Travel direction.'),
+                milePost: z.number().optional().describe('Milepost of the crossing.'),
+                latitude: z.number().optional().describe('Latitude of the crossing.'),
+                longitude: z.number().optional().describe('Longitude of the crossing.'),
+            })
+                .optional()
+                .describe('Geographic location of the crossing.'),
+        })
+            .describe('Wait time data for one border crossing.'))
+            .describe('All WA/Canada border crossing wait times.'),
+        totalCount: z.number().describe('Total number of crossings returned.'),
+    }),
+    errors: [
+        {
+            reason: 'api_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'WSDOT Traffic API is unreachable or returns a non-2xx response after retries.',
+            retryable: true,
+            recovery: 'Retry in 30 seconds. If the issue persists, check wsdot.wa.gov for service status.',
+        },
+    ],
+    async handler(_input, ctx) {
+        const crossings = await getTrafficApiService().getBorderCrossings(ctx);
+        ctx.log.info('Border crossings fetched', { count: crossings.length });
+        return { crossings, totalCount: crossings.length };
+    },
+    format: (result) => {
+        if (result.crossings.length === 0) {
+            return [{ type: 'text', text: 'No border crossing data available. **Total:** 0' }];
+        }
+        const lines = [`## WA/Canada Border Wait Times (${result.totalCount} crossings)\n`];
+        for (const c of result.crossings) {
+            lines.push(`### ${c.crossingName ?? 'Border Crossing'}`);
+            if (c.waitTimeInMinutes != null) {
+                lines.push(`**Wait:** ${c.waitTimeInMinutes} min`);
+            }
+            else {
+                lines.push('**Wait:** Not available');
+            }
+            if (c.location?.roadName)
+                lines.push(`**Road:** ${c.location.roadName}`);
+            if (c.location?.direction)
+                lines.push(`**Direction:** ${c.location.direction}`);
+            if (c.location?.milePost != null)
+                lines.push(`**Milepost:** ${c.location.milePost}`);
+            if (c.location?.latitude != null && c.location.longitude != null) {
+                lines.push(`**Coords:** ${c.location.latitude}, ${c.location.longitude}`);
+            }
+            if (c.updateTime)
+                lines.push(`**Updated:** ${c.updateTime}`);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-border-waits.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/get-ferry-alerts.tool.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Tool to fetch active WSF ferry service alerts and disruptions.
+ * @module mcp-server/tools/definitions/get-ferry-alerts.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getFerryAlerts: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    alerts: z.ZodArray<z.ZodObject<{
+        alertId: z.ZodOptional<z.ZodNumber>;
+        alertDescription: z.ZodOptional<z.ZodString>;
+        impactedRouteIds: z.ZodArray<z.ZodNumber>;
+        publishDate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "api_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "WSF Ferry API is unreachable or returns a non-2xx response after retries.";
+    readonly retryable: true;
+    readonly recovery: "Retry in 30 seconds. If the issue persists, check wsdot.wa.gov/ferries for service status.";
+}]>;
+//# sourceMappingURL=get-ferry-alerts.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-ferry-alerts.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ferry-alerts.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ferry-alerts.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,cAAc;;;;;;;;;;;;;;GAmEzB,CAAC"}

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

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview Tool to fetch active WSF ferry service alerts and disruptions.
+ * @module mcp-server/tools/definitions/get-ferry-alerts.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getFerryApiService } from '../../../services/ferry/ferry-service.js';
+export const getFerryAlerts = tool('wsdot_get_ferry_alerts', {
+    title: 'Get Ferry Alerts',
+    description: 'Returns active WSF ferry service disruptions, delays, and bulletins. ' +
+        'Each alert includes impacted route IDs — cross-reference with wsdot_get_ferry_routes ' +
+        'to resolve route IDs to human-readable route names.',
+    annotations: { readOnlyHint: true },
+    input: z.object({}),
+    output: z.object({
+        alerts: z
+            .array(z
+            .object({
+            alertId: z.number().optional().describe('Unique alert identifier.'),
+            alertDescription: z
+                .string()
+                .optional()
+                .describe('Description of the alert or disruption.'),
+            impactedRouteIds: z
+                .array(z.number())
+                .describe('Route IDs affected by this alert. Cross-reference with wsdot_get_ferry_routes to get route names.'),
+            publishDate: z.string().optional().describe('When the alert was published (ISO 8601).'),
+        })
+            .describe('A WSF ferry service alert or disruption.'))
+            .describe('Active ferry service alerts and disruptions.'),
+        totalCount: z.number().describe('Total number of active alerts.'),
+    }),
+    errors: [
+        {
+            reason: 'api_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'WSF Ferry API is unreachable or returns a non-2xx response after retries.',
+            retryable: true,
+            recovery: 'Retry in 30 seconds. If the issue persists, check wsdot.wa.gov/ferries for service status.',
+        },
+    ],
+    async handler(_input, ctx) {
+        const alerts = await getFerryApiService().getAlerts(ctx);
+        ctx.log.info('Ferry alerts fetched', { count: alerts.length });
+        return { alerts, totalCount: alerts.length };
+    },
+    format: (result) => {
+        if (result.alerts.length === 0) {
+            return [{ type: 'text', text: 'No active ferry alerts. **Total:** 0' }];
+        }
+        const lines = [`## Active Ferry Alerts (${result.totalCount})\n`];
+        for (const a of result.alerts) {
+            const id = a.alertId != null ? ` #${a.alertId}` : '';
+            lines.push(`### Alert${id}`);
+            if (a.alertDescription)
+                lines.push(a.alertDescription);
+            if (a.impactedRouteIds.length > 0) {
+                lines.push(`**Impacted Route IDs:** ${a.impactedRouteIds.join(', ')} (use wsdot_get_ferry_routes to look up names)`);
+            }
+            if (a.publishDate)
+                lines.push(`**Published:** ${a.publishDate}`);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-ferry-alerts.tool.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Tool to list all WSF ferry routes operating on a given date.
+ * @module mcp-server/tools/definitions/get-ferry-routes.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getFerryRoutes: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    tripDate: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    routes: z.ZodArray<z.ZodObject<{
+        routeId: z.ZodOptional<z.ZodNumber>;
+        routeName: z.ZodOptional<z.ZodString>;
+        crossingTimeInMinutes: z.ZodOptional<z.ZodNumber>;
+        departingTerminalId: z.ZodOptional<z.ZodNumber>;
+        departingTerminalName: z.ZodOptional<z.ZodString>;
+        arrivingTerminalId: z.ZodOptional<z.ZodNumber>;
+        arrivingTerminalName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    tripDate: z.ZodString;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "api_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "WSF Ferry API is unreachable or returns a non-2xx response after retries.";
+    readonly retryable: true;
+    readonly recovery: "Retry in 30 seconds. If the issue persists, check wsdot.wa.gov/ferries for service status.";
+}, {
+    readonly reason: "invalid_date";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The provided tripDate is not a valid ISO 8601 date.";
+    readonly recovery: "Provide a valid date in YYYY-MM-DD format, such as 2026-05-23.";
+}]>;
+//# sourceMappingURL=get-ferry-routes.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-ferry-routes.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ferry-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,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;GAmGzB,CAAC"}

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

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview Tool to list all WSF ferry routes operating on a given date.
+ * @module mcp-server/tools/definitions/get-ferry-routes.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { FerryApiService, getFerryApiService } from '../../../services/ferry/ferry-service.js';
+export const getFerryRoutes = tool('wsdot_get_ferry_routes', {
+    title: 'Get Ferry Routes',
+    description: 'Returns all WSF ferry routes operating on a given date, including terminal ID pairs and crossing times. ' +
+        'Use this to discover which routes are running and to get the terminal IDs needed for ' +
+        'wsdot_get_ferry_schedule and wsdot_get_terminal_space. Route IDs also correspond to ' +
+        'impactedRouteIds in ferry alerts from wsdot_get_ferry_alerts.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        tripDate: z
+            .string()
+            .optional()
+            .describe('Date for which to list routes, in ISO 8601 format (YYYY-MM-DD). ' +
+            'Defaults to today if omitted.'),
+    }),
+    output: z.object({
+        routes: z
+            .array(z
+            .object({
+            routeId: z
+                .number()
+                .optional()
+                .describe('Numeric route identifier. Corresponds to impactedRouteIds in ferry alerts.'),
+            routeName: z
+                .string()
+                .optional()
+                .describe('Route name (e.g. "Seattle/Bainbridge Island").'),
+            crossingTimeInMinutes: z
+                .number()
+                .optional()
+                .describe('Typical crossing time in minutes.'),
+            departingTerminalId: z
+                .number()
+                .optional()
+                .describe('Departing terminal ID for use in schedule and space lookups.'),
+            departingTerminalName: z.string().optional().describe('Departing terminal name.'),
+            arrivingTerminalId: z.number().optional().describe('Arriving terminal ID.'),
+            arrivingTerminalName: z.string().optional().describe('Arriving terminal name.'),
+        })
+            .describe('A WSF ferry route operating on the requested date.'))
+            .describe('Ferry routes operating on the requested date.'),
+        tripDate: z.string().describe('Date for which routes were retrieved (ISO 8601).'),
+        totalCount: z.number().describe('Total number of routes returned.'),
+    }),
+    errors: [
+        {
+            reason: 'api_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'WSF Ferry API is unreachable or returns a non-2xx response after retries.',
+            retryable: true,
+            recovery: 'Retry in 30 seconds. If the issue persists, check wsdot.wa.gov/ferries for service status.',
+        },
+        {
+            reason: 'invalid_date',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The provided tripDate is not a valid ISO 8601 date.',
+            recovery: 'Provide a valid date in YYYY-MM-DD format, such as 2026-05-23.',
+        },
+    ],
+    async handler(input, ctx) {
+        const tripDate = input.tripDate?.trim()
+            ? FerryApiService.toFerryDate(input.tripDate.trim())
+            : FerryApiService.todayFerryDate();
+        const routes = await getFerryApiService().getRoutes(tripDate, ctx);
+        ctx.log.info('Ferry routes fetched', { tripDate, count: routes.length });
+        return { routes, tripDate, totalCount: routes.length };
+    },
+    format: (result) => {
+        const lines = [
+            `## WSF Ferry Routes — ${result.tripDate} (${result.totalCount} routes)\n`,
+        ];
+        for (const r of result.routes) {
+            const name = r.routeName ?? 'Unknown route';
+            const crossing = r.crossingTimeInMinutes != null ? ` | ~${r.crossingTimeInMinutes} min` : '';
+            lines.push(`### ${name}${crossing}`);
+            if (r.departingTerminalId != null) {
+                lines.push(`**Departing:** ${r.departingTerminalName ?? ''} (ID: ${r.departingTerminalId})`);
+            }
+            if (r.arrivingTerminalId != null) {
+                lines.push(`**Arriving:** ${r.arrivingTerminalName ?? ''} (ID: ${r.arrivingTerminalId})`);
+            }
+            if (r.routeId != null)
+                lines.push(`**Route ID:** ${r.routeId}`);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-ferry-routes.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/get-ferry-schedule.tool.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview Tool to fetch departure times for a specific WSF ferry route.
+ * @module mcp-server/tools/definitions/get-ferry-schedule.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getFerrySchedule: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    departingTerminalId: z.ZodNumber;
+    arrivingTerminalId: z.ZodNumber;
+    tripDate: z.ZodOptional<z.ZodString>;
+    remainingOnly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    departingTerminalName: z.ZodOptional<z.ZodString>;
+    arrivingTerminalName: z.ZodOptional<z.ZodString>;
+    tripDate: z.ZodString;
+    remainingOnly: z.ZodBoolean;
+    sailings: z.ZodArray<z.ZodObject<{
+        departureTime: z.ZodOptional<z.ZodString>;
+        arrivalTime: z.ZodOptional<z.ZodString>;
+        isCancelled: z.ZodOptional<z.ZodBoolean>;
+        vesselName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalSailings: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "api_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "WSF Ferry API is unreachable or returns a non-2xx response after retries.";
+    readonly retryable: true;
+    readonly recovery: "Retry in 30 seconds. If the issue persists, check wsdot.wa.gov/ferries for service status.";
+}, {
+    readonly reason: "invalid_terminal_pair";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The terminal ID pair is invalid or does not form a valid ferry route.";
+    readonly recovery: "Use wsdot_get_ferry_terminals to list valid terminal IDs and wsdot_get_ferry_routes to find valid pairs.";
+}, {
+    readonly reason: "invalid_date";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The provided tripDate is not a valid ISO 8601 date.";
+    readonly recovery: "Provide a valid date in YYYY-MM-DD format, such as 2026-05-23.";
+}]>;
+//# sourceMappingURL=get-ferry-schedule.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-ferry-schedule.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ferry-schedule.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ferry-schedule.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,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgI3B,CAAC"}

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

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Tool to fetch departure times for a specific WSF ferry route.
+ * @module mcp-server/tools/definitions/get-ferry-schedule.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { FerryApiService, getFerryApiService } from '../../../services/ferry/ferry-service.js';
+export const getFerrySchedule = tool('wsdot_get_ferry_schedule', {
+    title: 'Get Ferry Schedule',
+    description: 'Returns departure times for a specific WSF ferry route on a given date. ' +
+        'Requires numeric terminal IDs — use wsdot_get_ferry_terminals to resolve terminal names to IDs. ' +
+        'Set remainingOnly to true to show only future departures for today (useful for "next ferry" queries). ' +
+        'For future dates, all sailings for that day are returned.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        departingTerminalId: z
+            .number()
+            .describe('Numeric ID of the departing terminal. Use wsdot_get_ferry_terminals to look up terminal IDs.'),
+        arrivingTerminalId: z.number().describe('Numeric ID of the arriving terminal.'),
+        tripDate: z
+            .string()
+            .optional()
+            .describe('Date in ISO 8601 format (YYYY-MM-DD). Defaults to today if omitted.'),
+        remainingOnly: z
+            .boolean()
+            .optional()
+            .describe('When true, returns only future sailings for today. Ignored for future dates. Default: false.'),
+    }),
+    output: z.object({
+        departingTerminalName: z.string().optional().describe('Departing terminal name.'),
+        arrivingTerminalName: z.string().optional().describe('Arriving terminal name.'),
+        tripDate: z.string().describe('Date of the schedule (ISO 8601).'),
+        remainingOnly: z.boolean().describe('Whether the result shows only remaining sailings.'),
+        sailings: z
+            .array(z
+            .object({
+            departureTime: z.string().optional().describe('Scheduled departure time.'),
+            arrivalTime: z.string().optional().describe('Scheduled arrival time.'),
+            isCancelled: z.boolean().optional().describe('Whether this sailing is cancelled.'),
+            vesselName: z.string().optional().describe('Vessel assigned to this sailing.'),
+        })
+            .describe('One scheduled sailing with departure time and vessel assignment.'))
+            .describe('Scheduled sailings for this route and date.'),
+        totalSailings: z.number().describe('Total number of sailings returned.'),
+    }),
+    errors: [
+        {
+            reason: 'api_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'WSF Ferry API is unreachable or returns a non-2xx response after retries.',
+            retryable: true,
+            recovery: 'Retry in 30 seconds. If the issue persists, check wsdot.wa.gov/ferries for service status.',
+        },
+        {
+            reason: 'invalid_terminal_pair',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The terminal ID pair is invalid or does not form a valid ferry route.',
+            recovery: 'Use wsdot_get_ferry_terminals to list valid terminal IDs and wsdot_get_ferry_routes to find valid pairs.',
+        },
+        {
+            reason: 'invalid_date',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The provided tripDate is not a valid ISO 8601 date.',
+            recovery: 'Provide a valid date in YYYY-MM-DD format, such as 2026-05-23.',
+        },
+    ],
+    async handler(input, ctx) {
+        const tripDate = input.tripDate?.trim()
+            ? FerryApiService.toFerryDate(input.tripDate.trim())
+            : FerryApiService.todayFerryDate();
+        const remainingOnly = input.remainingOnly ?? false;
+        const schedule = await getFerryApiService().getSchedule(input.departingTerminalId, input.arrivingTerminalId, tripDate, remainingOnly, ctx);
+        ctx.log.info('Ferry schedule fetched', {
+            departingTerminalId: input.departingTerminalId,
+            arrivingTerminalId: input.arrivingTerminalId,
+            tripDate,
+            sailingsCount: schedule.sailings.length,
+        });
+        return {
+            departingTerminalName: schedule.departingTerminalName,
+            arrivingTerminalName: schedule.arrivingTerminalName,
+            tripDate,
+            remainingOnly,
+            sailings: schedule.sailings,
+            totalSailings: schedule.sailings.length,
+        };
+    },
+    format: (result) => {
+        const route = result.departingTerminalName && result.arrivingTerminalName
+            ? `${result.departingTerminalName} → ${result.arrivingTerminalName}`
+            : 'Ferry Schedule';
+        const remainingNote = result.remainingOnly ? ' (remaining today)' : '';
+        const lines = [
+            `## Ferry Schedule — ${route}`,
+            `**Date:** ${result.tripDate}${remainingNote} | **Sailings:** ${result.totalSailings}`,
+        ];
+        if (result.departingTerminalName)
+            lines.push(`**From:** ${result.departingTerminalName}`);
+        if (result.arrivingTerminalName)
+            lines.push(`**To:** ${result.arrivingTerminalName}`);
+        lines.push('');
+        if (result.sailings.length === 0) {
+            lines.push('No sailings found for this route and date.');
+        }
+        else {
+            for (const s of result.sailings) {
+                const cancelled = s.isCancelled ? ' ~~CANCELLED~~' : '';
+                const dep = s.departureTime ?? 'Unknown';
+                const arr = s.arrivalTime ? ` → ${s.arrivalTime}` : '';
+                const vessel = s.vesselName ? ` | ${s.vesselName}` : '';
+                lines.push(`- ${dep}${arr}${vessel}${cancelled}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-ferry-schedule.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/get-ferry-terminals.tool.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Tool to list all WSF ferry terminals with their numeric IDs.
+ * @module mcp-server/tools/definitions/get-ferry-terminals.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getFerryTerminals: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    terminals: z.ZodArray<z.ZodObject<{
+        terminalId: z.ZodNumber;
+        terminalName: z.ZodString;
+        terminalAbbrev: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodNumber>;
+        longitude: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "api_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "WSF Ferry API is unreachable or returns a non-2xx response after retries.";
+    readonly retryable: true;
+    readonly recovery: "Retry in 30 seconds. If the issue persists, check wsdot.wa.gov/ferries for service status.";
+}]>;
+//# sourceMappingURL=get-ferry-terminals.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-ferry-terminals.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ferry-terminals.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ferry-terminals.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,iBAAiB;;;;;;;;;;;;;;;GAuD5B,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Tool to list all WSF ferry terminals with their numeric IDs.
+ * @module mcp-server/tools/definitions/get-ferry-terminals.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getFerryApiService } from '../../../services/ferry/ferry-service.js';
+export const getFerryTerminals = tool('wsdot_get_ferry_terminals', {
+    title: 'Get Ferry Terminals',
+    description: 'Returns all WSF ferry terminals with their numeric IDs, names, and abbreviations. ' +
+        'Call this first to resolve human-readable terminal names (e.g. "Bainbridge Island", ' +
+        '"Seattle", "Kingston") to the numeric terminal IDs required by the schedule and space tools. ' +
+        'The terminal list is small (~22 terminals) and rarely changes.',
+    annotations: { readOnlyHint: true },
+    input: z.object({}),
+    output: z.object({
+        terminals: z
+            .array(z
+            .object({
+            terminalId: z
+                .number()
+                .describe('Numeric terminal ID used in schedule and space API calls.'),
+            terminalName: z.string().describe('Full terminal name (e.g. "Bainbridge Island").'),
+            terminalAbbrev: z.string().optional().describe('Short abbreviation (e.g. "BI").'),
+            latitude: z.number().optional().describe('Terminal latitude.'),
+            longitude: z.number().optional().describe('Terminal longitude.'),
+        })
+            .describe('A WSF ferry terminal with its ID and location.'))
+            .describe('All WSF ferry terminals.'),
+        totalCount: z.number().describe('Total number of terminals.'),
+    }),
+    errors: [
+        {
+            reason: 'api_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'WSF Ferry API is unreachable or returns a non-2xx response after retries.',
+            retryable: true,
+            recovery: 'Retry in 30 seconds. If the issue persists, check wsdot.wa.gov/ferries for service status.',
+        },
+    ],
+    async handler(_input, ctx) {
+        const terminals = await getFerryApiService().getTerminals(ctx);
+        ctx.log.info('Ferry terminals fetched', { count: terminals.length });
+        return { terminals, totalCount: terminals.length };
+    },
+    format: (result) => {
+        const lines = [`## WSF Ferry Terminals (${result.totalCount})\n`];
+        for (const t of result.terminals) {
+            const abbrev = t.terminalAbbrev ? ` (${t.terminalAbbrev})` : '';
+            const coords = t.latitude != null && t.longitude != null ? ` | ${t.latitude}, ${t.longitude}` : '';
+            lines.push(`- **${t.terminalName}**${abbrev} — ID: ${t.terminalId}${coords}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-ferry-terminals.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/get-mountain-passes.tool.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Tool to fetch all WA mountain pass conditions from the WSDOT Traffic API.
+ * @module mcp-server/tools/definitions/get-mountain-passes.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getMountainPasses: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    passes: z.ZodArray<z.ZodObject<{
+        mountainPassId: z.ZodNumber;
+        mountainPassName: z.ZodString;
+        elevation: z.ZodOptional<z.ZodNumber>;
+        temperatureInFahrenheit: z.ZodOptional<z.ZodNumber>;
+        weatherCondition: z.ZodOptional<z.ZodString>;
+        roadCondition: z.ZodOptional<z.ZodString>;
+        travelAdvisoryActive: z.ZodOptional<z.ZodBoolean>;
+        restrictionOne: z.ZodOptional<z.ZodObject<{
+            comment: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        restrictionTwo: z.ZodOptional<z.ZodObject<{
+            comment: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        dateUpdated: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodNumber>;
+        longitude: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "api_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "WSDOT Traffic API is unreachable or returns a non-2xx response after retries.";
+    readonly retryable: true;
+    readonly recovery: "Retry in 30 seconds. If the issue persists, check wsdot.wa.gov for service status.";
+}]>;
+//# sourceMappingURL=get-mountain-passes.tool.d.ts.map