@cyanheads/wsdot-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/get-vessel-locations.tool.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Tool to fetch real-time vessel positions for all active WSF ferries.
+ * @module mcp-server/tools/definitions/get-vessel-locations.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getVesselLocations: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    vessels: z.ZodArray<z.ZodObject<{
+        vesselId: z.ZodOptional<z.ZodNumber>;
+        vesselName: z.ZodOptional<z.ZodString>;
+        inService: z.ZodOptional<z.ZodBoolean>;
+        atDock: z.ZodOptional<z.ZodBoolean>;
+        departingTerminalId: z.ZodOptional<z.ZodNumber>;
+        departingTerminalName: z.ZodOptional<z.ZodString>;
+        arrivingTerminalId: z.ZodOptional<z.ZodNumber>;
+        arrivingTerminalName: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodNumber>;
+        longitude: z.ZodOptional<z.ZodNumber>;
+        speed: z.ZodOptional<z.ZodNumber>;
+        heading: z.ZodOptional<z.ZodNumber>;
+        leftDock: z.ZodOptional<z.ZodString>;
+        eta: z.ZodOptional<z.ZodString>;
+        scheduledDeparture: z.ZodOptional<z.ZodString>;
+        opRouteAbbrev: z.ZodArray<z.ZodString>;
+        timestamp: 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-vessel-locations.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-vessel-locations.tool.d.ts.map

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

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

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview Tool to fetch real-time vessel positions for all active WSF ferries.
+ * @module mcp-server/tools/definitions/get-vessel-locations.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 getVesselLocations = tool('wsdot_get_vessel_locations', {
+    title: 'Get Vessel Locations',
+    description: 'Returns real-time AIS positions, speed, heading, ETA, and dock status for all active WSF vessels. ' +
+        'Use for "where is the ferry now?", vessel tracking, or checking if a vessel is in service. ' +
+        'Position data may lag by 30–60 seconds. Many fields are null for vessels not currently operating.',
+    annotations: { readOnlyHint: true },
+    input: z.object({}),
+    output: z.object({
+        vessels: z
+            .array(z
+            .object({
+            vesselId: z.number().optional().describe('Unique vessel identifier.'),
+            vesselName: z
+                .string()
+                .optional()
+                .describe('Vessel name (e.g. "Yakima", "Walla Walla").'),
+            inService: z
+                .boolean()
+                .optional()
+                .describe('Whether the vessel is currently in service.'),
+            atDock: z
+                .boolean()
+                .optional()
+                .describe('True when the vessel is docked at a terminal.'),
+            departingTerminalId: z
+                .number()
+                .optional()
+                .describe('Terminal the vessel is departing from.'),
+            departingTerminalName: z.string().optional().describe('Departing terminal name.'),
+            arrivingTerminalId: z
+                .number()
+                .optional()
+                .describe('Terminal the vessel is heading toward.'),
+            arrivingTerminalName: z.string().optional().describe('Arriving terminal name.'),
+            latitude: z.number().optional().describe('Current latitude (AIS position).'),
+            longitude: z.number().optional().describe('Current longitude (AIS position).'),
+            speed: z.number().optional().describe('Speed in knots.'),
+            heading: z.number().optional().describe('Heading in degrees (0–359).'),
+            leftDock: z.string().optional().describe('Time the vessel last left the dock.'),
+            eta: z
+                .string()
+                .optional()
+                .describe('Estimated arrival time at the destination terminal.'),
+            scheduledDeparture: z.string().optional().describe('Scheduled departure time.'),
+            opRouteAbbrev: z
+                .array(z.string())
+                .describe('Abbreviations of routes this vessel operates on.'),
+            timestamp: z
+                .string()
+                .optional()
+                .describe('AIS data timestamp — indicates position data age.'),
+        })
+            .describe('Real-time position and status for one WSF vessel.'))
+            .describe('All WSF vessels with real-time position data.'),
+        totalCount: z.number().describe('Total number of vessels 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.',
+        },
+    ],
+    async handler(_input, ctx) {
+        const vessels = await getFerryApiService().getVesselLocations(ctx);
+        ctx.log.info('Vessel locations fetched', { count: vessels.length });
+        return { vessels, totalCount: vessels.length };
+    },
+    format: (result) => {
+        if (result.vessels.length === 0) {
+            return [{ type: 'text', text: 'No vessel location data available. **Total:** 0' }];
+        }
+        const lines = [`## WSF Vessel Locations (${result.totalCount} vessels)\n`];
+        for (const v of result.vessels) {
+            const name = v.vesselName ?? `Vessel ${v.vesselId ?? '?'}`;
+            lines.push(`### ${name}`);
+            if (typeof v.inService === 'boolean')
+                lines.push(`**In Service:** ${v.inService ? 'Yes' : 'No'}`);
+            if (typeof v.atDock === 'boolean')
+                lines.push(`**At Dock:** ${v.atDock ? 'Yes' : 'No'}`);
+            if (v.departingTerminalId != null || v.departingTerminalName) {
+                lines.push(`**Departing:** ${v.departingTerminalName ?? ''}${v.departingTerminalId != null ? ` (ID: ${v.departingTerminalId})` : ''}`);
+            }
+            if (v.arrivingTerminalId != null || v.arrivingTerminalName) {
+                lines.push(`**Arriving:** ${v.arrivingTerminalName ?? ''}${v.arrivingTerminalId != null ? ` (ID: ${v.arrivingTerminalId})` : ''}`);
+            }
+            if (v.latitude != null && v.longitude != null) {
+                lines.push(`**Position:** ${v.latitude.toFixed(5)}, ${v.longitude.toFixed(5)}`);
+            }
+            if (v.speed != null)
+                lines.push(`**Speed:** ${v.speed} knots`);
+            if (v.heading != null)
+                lines.push(`**Heading:** ${v.heading}°`);
+            if (v.leftDock)
+                lines.push(`**Left Dock:** ${v.leftDock}`);
+            if (v.eta)
+                lines.push(`**ETA:** ${v.eta}`);
+            if (v.scheduledDeparture)
+                lines.push(`**Scheduled Departure:** ${v.scheduledDeparture}`);
+            if (v.opRouteAbbrev.length > 0)
+                lines.push(`**Routes:** ${v.opRouteAbbrev.join(', ')}`);
+            if (v.timestamp)
+                lines.push(`**Position Timestamp:** ${v.timestamp}`);
+            if (v.vesselId != null)
+                lines.push(`**Vessel ID:** ${v.vesselId}`);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-vessel-locations.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Barrel export for all tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+export { getBorderWaits } from './get-border-waits.tool.js';
+export { getFerryAlerts } from './get-ferry-alerts.tool.js';
+export { getFerryRoutes } from './get-ferry-routes.tool.js';
+export { getFerrySchedule } from './get-ferry-schedule.tool.js';
+export { getFerryTerminals } from './get-ferry-terminals.tool.js';
+export { getMountainPasses } from './get-mountain-passes.tool.js';
+export { getTerminalSpace } from './get-terminal-space.tool.js';
+export { getTollRates } from './get-toll-rates.tool.js';
+export { getTravelTimes } from './get-travel-times.tool.js';
+export { getVesselLocations } from './get-vessel-locations.tool.js';
+export { searchAlerts } from './search-alerts.tool.js';
+export { searchCameras } from './search-cameras.tool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Barrel export for all tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+export { getBorderWaits } from './get-border-waits.tool.js';
+export { getFerryAlerts } from './get-ferry-alerts.tool.js';
+export { getFerryRoutes } from './get-ferry-routes.tool.js';
+export { getFerrySchedule } from './get-ferry-schedule.tool.js';
+export { getFerryTerminals } from './get-ferry-terminals.tool.js';
+export { getMountainPasses } from './get-mountain-passes.tool.js';
+export { getTerminalSpace } from './get-terminal-space.tool.js';
+export { getTollRates } from './get-toll-rates.tool.js';
+export { getTravelTimes } from './get-travel-times.tool.js';
+export { getVesselLocations } from './get-vessel-locations.tool.js';
+export { searchAlerts } from './search-alerts.tool.js';
+export { searchCameras } from './search-cameras.tool.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Tool to search WA highway alerts, incidents, and construction notices.
+ * @module mcp-server/tools/definitions/search-alerts.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const searchAlerts: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    stateRoute: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    startMilepost: z.ZodOptional<z.ZodNumber>;
+    endMilepost: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    alerts: z.ZodArray<z.ZodObject<{
+        alertId: z.ZodOptional<z.ZodNumber>;
+        headlineDescription: z.ZodOptional<z.ZodString>;
+        extendedDescription: z.ZodOptional<z.ZodString>;
+        eventCategory: z.ZodOptional<z.ZodString>;
+        eventStatus: z.ZodOptional<z.ZodString>;
+        priority: z.ZodOptional<z.ZodString>;
+        region: z.ZodOptional<z.ZodString>;
+        county: z.ZodOptional<z.ZodString>;
+        startRoadwayLocation: z.ZodOptional<z.ZodObject<{
+            roadName: z.ZodOptional<z.ZodString>;
+            direction: z.ZodOptional<z.ZodString>;
+            milePost: z.ZodOptional<z.ZodNumber>;
+            latitude: z.ZodOptional<z.ZodNumber>;
+            longitude: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        endRoadwayLocation: z.ZodOptional<z.ZodObject<{
+            roadName: z.ZodOptional<z.ZodString>;
+            direction: z.ZodOptional<z.ZodString>;
+            milePost: z.ZodOptional<z.ZodNumber>;
+            latitude: z.ZodOptional<z.ZodNumber>;
+            longitude: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        startTime: z.ZodOptional<z.ZodString>;
+        endTime: z.ZodOptional<z.ZodString>;
+        lastUpdatedTime: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+}, 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=search-alerts.tool.d.ts.map

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

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

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

@@ -0,0 +1,155 @@
+/**
+ * @fileoverview Tool to search WA highway alerts, incidents, and construction notices.
+ * @module mcp-server/tools/definitions/search-alerts.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 searchAlerts = tool('wsdot_search_alerts', {
+    title: 'Search Highway Alerts',
+    description: 'Returns active WA highway alerts: incidents, construction, closures, and restrictions. ' +
+        'Filter by state route (zero-padded 3-digit number, e.g. "005" for I-5, "090" for I-90, "520" for SR 520), ' +
+        'WSDOT region (Northwest, Olympic, Southwest, South Central, North Central, Eastern), ' +
+        'or milepost range. Omit all filters to return all current statewide alerts.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        stateRoute: z
+            .string()
+            .optional()
+            .describe('Zero-padded 3-digit state route number (e.g. "005" for I-5, "090" for I-90, "520" for SR 520).'),
+        region: z
+            .string()
+            .optional()
+            .describe('WSDOT region name: Northwest, Olympic, Southwest, South Central, North Central, or Eastern.'),
+        startMilepost: z.number().optional().describe('Start of milepost range to filter alerts.'),
+        endMilepost: z.number().optional().describe('End of milepost range to filter alerts.'),
+    }),
+    output: z.object({
+        alerts: z
+            .array(z
+            .object({
+            alertId: z.number().optional().describe('Unique alert identifier.'),
+            headlineDescription: z.string().optional().describe('Short summary of the alert.'),
+            extendedDescription: z.string().optional().describe('Full description of the alert.'),
+            eventCategory: z
+                .string()
+                .optional()
+                .describe('Category (e.g. "Incident", "Construction", "Closure").'),
+            eventStatus: z.string().optional().describe('Current status of the event.'),
+            priority: z.string().optional().describe('Priority level.'),
+            region: z.string().optional().describe('WSDOT region where the alert is located.'),
+            county: z.string().optional().describe('County where the alert is located.'),
+            startRoadwayLocation: z
+                .object({
+                roadName: z.string().optional().describe('Road name.'),
+                direction: z.string().optional().describe('Travel direction.'),
+                milePost: z.number().optional().describe('Starting milepost.'),
+                latitude: z.number().optional().describe('Latitude.'),
+                longitude: z.number().optional().describe('Longitude.'),
+            })
+                .optional()
+                .describe('Start location of the alert.'),
+            endRoadwayLocation: z
+                .object({
+                roadName: z.string().optional().describe('Road name.'),
+                direction: z.string().optional().describe('Travel direction.'),
+                milePost: z.number().optional().describe('Ending milepost.'),
+                latitude: z.number().optional().describe('Latitude.'),
+                longitude: z.number().optional().describe('Longitude.'),
+            })
+                .optional()
+                .describe('End location of the alert, if the event spans a range.'),
+            startTime: z
+                .string()
+                .optional()
+                .describe('When the event started or is scheduled to start.'),
+            endTime: z.string().optional().describe('When the event is expected to end.'),
+            lastUpdatedTime: z.string().optional().describe('When this alert was last updated.'),
+        })
+            .describe('A highway alert or incident.'))
+            .describe('Matching highway alerts.'),
+        totalCount: z.number().describe('Total number of alerts 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 stateRoute = input.stateRoute?.trim() || undefined;
+        const region = input.region?.trim() || undefined;
+        const alerts = await getTrafficApiService().searchAlerts({
+            ...(stateRoute && { stateRoute }),
+            ...(region && { region }),
+            ...(input.startMilepost != null && { startMilepost: input.startMilepost }),
+            ...(input.endMilepost != null && { endMilepost: input.endMilepost }),
+        }, ctx);
+        ctx.log.info('Alerts fetched', { count: alerts.length });
+        return { alerts, totalCount: alerts.length };
+    },
+    format: (result) => {
+        if (result.alerts.length === 0) {
+            return [{ type: 'text', text: `No active alerts found. **Total:** 0` }];
+        }
+        const lines = [`## Highway Alerts (${result.totalCount})\n`];
+        for (const a of result.alerts) {
+            const id = a.alertId != null ? ` #${a.alertId}` : '';
+            lines.push(`### ${a.headlineDescription ?? 'Alert'}${id}`);
+            if (a.eventCategory)
+                lines.push(`**Category:** ${a.eventCategory}`);
+            if (a.eventStatus)
+                lines.push(`**Status:** ${a.eventStatus}`);
+            if (a.priority)
+                lines.push(`**Priority:** ${a.priority}`);
+            if (a.region)
+                lines.push(`**Region:** ${a.region}`);
+            if (a.county)
+                lines.push(`**County:** ${a.county}`);
+            if (a.startRoadwayLocation) {
+                const loc = a.startRoadwayLocation;
+                const parts = [
+                    loc.roadName,
+                    loc.direction,
+                    loc.milePost != null ? `MP ${loc.milePost}` : undefined,
+                ]
+                    .filter(Boolean)
+                    .join(' ');
+                if (parts)
+                    lines.push(`**Location:** ${parts}`);
+                if (loc.latitude != null && loc.longitude != null) {
+                    lines.push(`**Coords:** ${loc.latitude}, ${loc.longitude}`);
+                }
+            }
+            if (a.endRoadwayLocation) {
+                const end = a.endRoadwayLocation;
+                const endParts = [
+                    end.roadName,
+                    end.direction,
+                    end.milePost != null ? `MP ${end.milePost}` : undefined,
+                ]
+                    .filter(Boolean)
+                    .join(' ');
+                if (endParts)
+                    lines.push(`**End Location:** ${endParts}`);
+                if (end.latitude != null && end.longitude != null) {
+                    lines.push(`**End Coords:** ${end.latitude}, ${end.longitude}`);
+                }
+            }
+            if (a.extendedDescription)
+                lines.push(a.extendedDescription);
+            if (a.startTime)
+                lines.push(`**Start:** ${a.startTime}`);
+            if (a.endTime)
+                lines.push(`**End:** ${a.endTime}`);
+            if (a.lastUpdatedTime)
+                lines.push(`**Updated:** ${a.lastUpdatedTime}`);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-alerts.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-alerts.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-alerts.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,qBAAqB,EAAE;IACtD,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,yFAAyF;QACzF,4GAA4G;QAC5G,uFAAuF;QACvF,6EAA6E;IAC/E,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,gGAAgG,CACjG;QACH,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,6FAA6F,CAC9F;QACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QAC1F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;KACvF,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC;aACN,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACnE,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAClF,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YACrF,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,wDAAwD,CAAC;YACrE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YAC3E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YAClF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAC5E,oBAAoB,EAAE,CAAC;iBACpB,MAAM,CAAC;gBACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACrD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;aACxD,CAAC;iBACD,QAAQ,EAAE;iBACV,QAAQ,CAAC,8BAA8B,CAAC;YAC3C,kBAAkB,EAAE,CAAC;iBAClB,MAAM,CAAC;gBACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBAC5D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACrD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;aACxD,CAAC;iBACD,QAAQ,EAAE;iBACV,QAAQ,CAAC,wDAAwD,CAAC;YACrE,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,kDAAkD,CAAC;YAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAC7E,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SACrF,CAAC;aACD,QAAQ,CAAC,8BAA8B,CAAC,CAC5C;aACA,QAAQ,CAAC,0BAA0B,CAAC;QACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KACpE,CAAC;IAEF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,iBAAiB;YACzB,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;YACzC,IAAI,EAAE,+EAA+E;YACrF,SAAS,EAAE,IAAI;YACf,QAAQ,EACN,oFAAoF;SACvF;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QACzD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,oBAAoB,EAAE,CAAC,YAAY,CACtD;YACE,GAAG,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,CAAC;YACjC,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC;YACzB,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,IAAI,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;YAC1E,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;SACrE,EACD,GAAG,CACJ,CAAC;QACF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,KAAK,GAAa,CAAC,sBAAsB,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC;QACvE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,mBAAmB,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,CAAC,aAAa;gBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAC9D,IAAI,CAAC,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1D,IAAI,CAAC,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,CAAC,CAAC,oBAAoB,CAAC;gBACnC,MAAM,KAAK,GAAG;oBACZ,GAAG,CAAC,QAAQ;oBACZ,GAAG,CAAC,SAAS;oBACb,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;iBACxD;qBACE,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,GAAG,CAAC,CAAC;gBACb,IAAI,KAAK;oBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;gBAChD,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI,IAAI,GAAG,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;oBAClD,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;YACD,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,CAAC,CAAC,kBAAkB,CAAC;gBACjC,MAAM,QAAQ,GAAG;oBACf,GAAG,CAAC,QAAQ;oBACZ,GAAG,CAAC,SAAS;oBACb,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;iBACxD;qBACE,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,GAAG,CAAC,CAAC;gBACb,IAAI,QAAQ;oBAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;gBAC1D,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI,IAAI,GAAG,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;oBAClD,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;YACD,IAAI,CAAC,CAAC,mBAAmB;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;YAC7D,IAAI,CAAC,CAAC,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACnD,IAAI,CAAC,CAAC,eAAe;gBAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;YACvE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Tool to search highway camera locations and metadata from the WSDOT Traffic API.
+ * @module mcp-server/tools/definitions/search-cameras.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const searchCameras: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    stateRoute: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    startMilepost: z.ZodOptional<z.ZodNumber>;
+    endMilepost: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    cameras: z.ZodArray<z.ZodObject<{
+        cameraId: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        imageWidth: z.ZodOptional<z.ZodNumber>;
+        imageHeight: z.ZodOptional<z.ZodNumber>;
+        roadName: z.ZodOptional<z.ZodString>;
+        direction: z.ZodOptional<z.ZodString>;
+        milePost: z.ZodOptional<z.ZodNumber>;
+        region: z.ZodOptional<z.ZodString>;
+        latitude: z.ZodOptional<z.ZodNumber>;
+        longitude: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+    note: z.ZodOptional<z.ZodString>;
+}, 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=search-cameras.tool.d.ts.map

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

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

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

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Tool to search highway camera locations and metadata from the WSDOT Traffic API.
+ * @module mcp-server/tools/definitions/search-cameras.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';
+const MAX_INLINE_CAMERAS = 20;
+export const searchCameras = tool('wsdot_search_cameras', {
+    title: 'Search Highway Cameras',
+    description: 'Returns WSDOT highway camera locations, descriptions, and image URLs. ' +
+        'Camera images are copyright WSDOT — only metadata and image URLs are returned, not image bytes. ' +
+        'Filter by state route (e.g. "090" for I-90), WSDOT region, or milepost range. ' +
+        'Omit all filters to list all cameras statewide (potentially hundreds).',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        stateRoute: z
+            .string()
+            .optional()
+            .describe('Zero-padded 3-digit state route number (e.g. "005" for I-5, "090" for I-90).'),
+        region: z
+            .string()
+            .optional()
+            .describe('WSDOT region name: Northwest, Olympic, Southwest, South Central, North Central, or Eastern.'),
+        startMilepost: z.number().optional().describe('Start of milepost range to filter cameras.'),
+        endMilepost: z.number().optional().describe('End of milepost range to filter cameras.'),
+    }),
+    output: z.object({
+        cameras: z
+            .array(z
+            .object({
+            cameraId: z.number().optional().describe('Unique camera identifier.'),
+            title: z.string().optional().describe('Camera title or location description.'),
+            description: z.string().optional().describe('Additional description.'),
+            imageUrl: z
+                .string()
+                .optional()
+                .describe('URL of the WSDOT-hosted camera image (JPEG). WSDOT copyright applies.'),
+            imageWidth: z.number().optional().describe('Image width in pixels.'),
+            imageHeight: z.number().optional().describe('Image height in pixels.'),
+            roadName: z.string().optional().describe('Road the camera monitors.'),
+            direction: z.string().optional().describe('Traffic direction monitored.'),
+            milePost: z.number().optional().describe('Milepost location of the camera.'),
+            region: z.string().optional().describe('WSDOT region.'),
+            latitude: z.number().optional().describe('Camera latitude.'),
+            longitude: z.number().optional().describe('Camera longitude.'),
+        })
+            .describe('Camera metadata and image URL for one WSDOT highway camera.'))
+            .describe('Camera metadata and image URLs. Images are copyright WSDOT.'),
+        totalCount: z.number().describe('Total number of cameras returned.'),
+        note: z
+            .string()
+            .optional()
+            .describe('Informational note about result truncation or copyright.'),
+    }),
+    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 stateRoute = input.stateRoute?.trim() || undefined;
+        const region = input.region?.trim() || undefined;
+        const cameras = await getTrafficApiService().searchCameras({
+            ...(stateRoute && { stateRoute }),
+            ...(region && { region }),
+            ...(input.startMilepost != null && { startMilepost: input.startMilepost }),
+            ...(input.endMilepost != null && { endMilepost: input.endMilepost }),
+        }, ctx);
+        const note = cameras.length > MAX_INLINE_CAMERAS
+            ? `Showing first ${MAX_INLINE_CAMERAS} of ${cameras.length} cameras. Add filters (stateRoute, region, or mileposts) to narrow results. Camera images are copyright WSDOT.`
+            : 'Camera images are copyright WSDOT. Follow image URLs to view live feeds.';
+        ctx.log.info('Cameras fetched', { count: cameras.length });
+        return { cameras, totalCount: cameras.length, note };
+    },
+    format: (result) => {
+        const lines = [];
+        if (result.note)
+            lines.push(`> ${result.note}\n`);
+        lines.push(`## Highway Cameras (${result.totalCount} total)\n`);
+        const display = result.cameras.slice(0, MAX_INLINE_CAMERAS);
+        for (const c of display) {
+            lines.push(`### ${c.title ?? `Camera ${c.cameraId ?? ''}`}`);
+            if (c.description)
+                lines.push(c.description);
+            if (c.roadName) {
+                const loc = [c.roadName, c.direction, c.milePost != null ? `MP ${c.milePost}` : undefined]
+                    .filter(Boolean)
+                    .join(' ');
+                lines.push(`**Location:** ${loc}`);
+            }
+            if (c.region)
+                lines.push(`**Region:** ${c.region}`);
+            if (c.imageUrl)
+                lines.push(`**Image:** ${c.imageUrl}`);
+            if (c.imageWidth != null && c.imageHeight != null) {
+                lines.push(`**Size:** ${c.imageWidth}×${c.imageHeight}px`);
+            }
+            if (c.latitude != null && c.longitude != null) {
+                lines.push(`**Coords:** ${c.latitude}, ${c.longitude}`);
+            }
+            if (c.cameraId != null)
+                lines.push(`**ID:** ${c.cameraId}`);
+            lines.push('');
+        }
+        if (result.cameras.length > MAX_INLINE_CAMERAS) {
+            lines.push(`_... ${result.cameras.length - MAX_INLINE_CAMERAS} more cameras in structuredContent_`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-cameras.tool.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview WSF (Washington State Ferries) API service — terminals, routes,
+ * schedules, vessel locations, terminal space, and alerts.
+ * @module services/ferry/ferry-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+import type { FerryAlert, FerryRoute, FerrySchedule, FerryTerminal, TerminalSailingSpace, VesselLocation } from './types.js';
+export declare class FerryApiService {
+    constructor(_config: AppConfig, _storage: StorageService);
+    private accessCode;
+    private buildUrl;
+    private fetchJson;
+    /** Validate and normalize an ISO 8601 date string for use in ferry API paths. */
+    static toFerryDate(isoDate: string): string;
+    /** Return today's date in YYYY-MM-DD format. */
+    static todayFerryDate(): string;
+    getTerminals(ctx: Context): Promise<FerryTerminal[]>;
+    getRoutes(tripDate: string, ctx: Context): Promise<FerryRoute[]>;
+    getSchedule(departingTerminalId: number, arrivingTerminalId: number, tripDate: string, remainingOnly: boolean, ctx: Context): Promise<FerrySchedule>;
+    getVesselLocations(ctx: Context): Promise<VesselLocation[]>;
+    getTerminalSailingSpace(ctx: Context): Promise<TerminalSailingSpace[]>;
+    getAlerts(ctx: Context): Promise<FerryAlert[]>;
+}
+export declare function initFerryApiService(config: AppConfig, storage: StorageService): void;
+export declare function getFerryApiService(): FerryApiService;
+//# sourceMappingURL=ferry-service.d.ts.map