go-transit-mcp 0.0.0

package/dist/normalize/journey.js

@@ -0,0 +1,184 @@
+import { addHoursToTime, combineDateAndHhmm, dateToWire, diffMinutes, hhmmToWire, toIsoWithTorontoOffset, } from "../time.js";
+// GO Transit's known line roster. Schedule/Journey's Trip object carries no
+// line-name field (only Line/LineVariant codes and a Display string that
+// mixes the code with the destination, e.g. "LW - Aldershot GO") — same gap
+// and same best-effort static map already used for get_stop_destinations.
+const LINE_NAMES = {
+    LW: "Lakeshore West",
+    LE: "Lakeshore East",
+    MI: "Milton",
+    GT: "Kitchener",
+    RH: "Richmond Hill",
+    BR: "Barrie",
+    ST: "Stouffville",
+    UP: "UP Express",
+};
+// Mirrors Stop/NextService's ServiceType (T/B) single-letter vocabulary
+// (tool-schemas spec §1.1) — not yet independently confirmed for this
+// endpoint's Trip.Type field, same best-effort default as normalize/next-service.ts.
+function normalizeLegMode(type) {
+    return type === "B" ? "bus" : "train";
+}
+function firstAndLastByOrder(stops) {
+    let first = stops[0];
+    let last = stops[0];
+    for (const stop of stops) {
+        if (stop.Order < first.Order)
+            first = stop;
+        if (stop.Order > last.Order)
+            last = stop;
+    }
+    return [first, last];
+}
+// Leg boundaries come from the trip's own Stops list, not from
+// departFromCode/destinationStopCode. The captured fixture shows upstream
+// trims each trip's Stops to the ridden portion (trip 1961's Display says
+// "Niagara Falls GO" yet its Stops end at the journey destination OA) and
+// stamps departFromCode/destinationStopCode with journey-level endpoints,
+// so those codes can't be trusted as per-leg boundaries on any multi-leg
+// journey. Note: no multi-leg journey has ever been observed live —
+// Schedule/Journey returned SchJourneys: [] for a cross-line pair the
+// official site routes via a transfer (tool-schemas spec §5) — this is
+// defensive correctness from the fixture evidence, not a confirmed shape.
+function normalizeLeg(trip, journeyDate, stopNames) {
+    const stops = trip.Stops?.Stop ?? [];
+    if (stops.length === 0)
+        return undefined;
+    const [first, last] = firstAndLastByOrder(stops);
+    return {
+        mode: normalizeLegMode(trip.Type),
+        line_code: trip.Line,
+        line_name: LINE_NAMES[trip.Line] ?? trip.Line,
+        direction: trip.Direction,
+        from: {
+            stop_code: first.Code,
+            stop_name: stopNames.get(first.Code) ?? first.Code,
+            time: combineDateAndHhmm(journeyDate, first.Time),
+        },
+        to: {
+            stop_code: last.Code,
+            stop_name: stopNames.get(last.Code) ?? last.Code,
+            time: combineDateAndHhmm(journeyDate, last.Time),
+        },
+        trip_number: trip.Number,
+    };
+}
+function normalizeService(service, journeyDate, stopNames) {
+    const legs = (service.Trips?.Trip ?? [])
+        .map((trip) => normalizeLeg(trip, journeyDate, stopNames))
+        .filter((leg) => leg !== undefined);
+    if (legs.length === 0)
+        return undefined;
+    return {
+        departure_time: toIsoWithTorontoOffset(service.StartTime),
+        arrival_time: toIsoWithTorontoOffset(service.EndTime),
+        duration_minutes: diffMinutes(service.EndTime, service.StartTime),
+        transfers: legs.length - 1,
+        // "" / "R" / "B" / "RB" (tool-schemas spec §5 pattern, unconfirmed
+        // positive case) — any non-empty code collapses to accessible: true.
+        accessible: service.Accessible !== "",
+        legs,
+    };
+}
+/**
+ * Raw journey response -> itinerary DTOs. Journey trips carry no stop names
+ * of their own (same gap as Schedule/Trip) — resolved via a stop_code ->
+ * stop_name index built from the cached Stop/All dataset (get_trip_status
+ * precedent), passed in by the caller.
+ */
+export function normalizeJourney(raw, stopNames) {
+    const entry = raw.SchJourneys?.[0];
+    if (!entry)
+        return [];
+    const itineraries = [];
+    for (const service of entry.Services ?? []) {
+        const itinerary = normalizeService(service, entry.Date, stopNames);
+        if (itinerary)
+            itineraries.push(itinerary);
+    }
+    return itineraries;
+}
+async function fetchItineraries(client, fromStopCode, toStopCode, date, time, maxResults, stopNames) {
+    const raw = await client.getJourney(dateToWire(date), fromStopCode, toStopCode, hhmmToWire(time), maxResults);
+    return normalizeJourney(raw, stopNames);
+}
+// Via-Union transfer composition (ADR 0002): Schedule/Journey only returns
+// single-service journeys — both documented endpoint variants confirmed live
+// (2026-07-18) to return SchJourneys: [] for a cross-line pair the official
+// planner routes via a transfer. Union is GO's hub, so when a direct query
+// comes back empty, plan_trip composes one transfer there from two journey
+// calls. Each leg is upstream-attested; only the pairing is ours. The
+// transfer buffer is a starting heuristic (same spirit as the arrive_by
+// window, spec §5); bus-hub composition is a separate grilled decision.
+const UNION_STOP_CODE = "UN";
+const MIN_TRANSFER_MINUTES = 10;
+function isoToMs(iso) {
+    return new Date(iso).getTime();
+}
+// Toronto-local clock of one of our own ISO outputs
+// ("2026-07-20T08:50:00-04:00" -> "08:50") — safe to slice because every
+// itinerary timestamp is produced by combineDateAndHhmm/toIsoWithTorontoOffset.
+function hhmmOfIso(iso) {
+    return iso.slice(11, 16);
+}
+function combine(first, second) {
+    const legs = [...first.legs, ...second.legs];
+    return {
+        departure_time: first.departure_time,
+        arrival_time: second.arrival_time,
+        duration_minutes: Math.round((isoToMs(second.arrival_time) - isoToMs(first.departure_time)) / 60_000),
+        transfers: legs.length - 1,
+        accessible: first.accessible && second.accessible,
+        legs,
+    };
+}
+async function composeViaUnion(client, fromStopCode, toStopCode, date, time, maxResults, stopNames) {
+    const inbound = await fetchItineraries(client, fromStopCode, UNION_STOP_CODE, date, time, maxResults, stopNames);
+    if (inbound.length === 0)
+        return [];
+    const earliest = inbound.reduce((a, b) => isoToMs(a.arrival_time) <= isoToMs(b.arrival_time) ? a : b);
+    const onward = await fetchItineraries(client, UNION_STOP_CODE, toStopCode, date, hhmmOfIso(earliest.arrival_time), maxResults, stopNames);
+    const combined = [];
+    for (const first of inbound) {
+        const readyMs = isoToMs(first.arrival_time) + MIN_TRANSFER_MINUTES * 60_000;
+        const second = onward.find((candidate) => isoToMs(candidate.departure_time) >= readyMs);
+        if (second)
+            combined.push(combine(first, second));
+    }
+    return combined.slice(0, maxResults);
+}
+// Direct query first; the via-Union fallback only runs when it comes back
+// empty and neither endpoint already is Union, so every currently-working
+// direct journey is untouched. Worst case 3 upstream calls (6 under
+// arrive_by's widening retry).
+async function fetchDirectOrComposed(client, query, time, stopNames) {
+    const direct = await fetchItineraries(client, query.from, query.to, query.date, time, query.maxResults, stopNames);
+    if (direct.length > 0 || !query.viaUnionFallback)
+        return direct;
+    if (query.from === UNION_STOP_CODE || query.to === UNION_STOP_CODE) {
+        return direct;
+    }
+    return composeViaUnion(client, query.from, query.to, query.date, time, query.maxResults, stopNames);
+}
+// arrive_by is emulated (tool-schemas spec §2.1): one Schedule/Journey call
+// with StartTime back-shifted, filtered on arrival <= target, one retry with
+// a wider window if empty. Both windows are starting heuristics to tune
+// against real journey data (spec §5).
+const ARRIVE_BY_BACKSHIFT_HOURS = 2;
+const ARRIVE_BY_WIDE_BACKSHIFT_HOURS = 4;
+async function itinerariesArrivingBy(client, query, stopNames, backshiftHours) {
+    const startTime = addHoursToTime(query.time, -backshiftHours);
+    const itineraries = await fetchDirectOrComposed(client, query, startTime, stopNames);
+    const targetMs = new Date(combineDateAndHhmm(query.date, query.time)).getTime();
+    return itineraries.filter((itinerary) => new Date(itinerary.arrival_time).getTime() <= targetMs);
+}
+export async function planItineraries(client, query, stopNames) {
+    if (query.timeMode === "depart_after") {
+        return fetchDirectOrComposed(client, query, query.time, stopNames);
+    }
+    const narrow = await itinerariesArrivingBy(client, query, stopNames, ARRIVE_BY_BACKSHIFT_HOURS);
+    if (narrow.length > 0)
+        return narrow;
+    return itinerariesArrivingBy(client, query, stopNames, ARRIVE_BY_WIDE_BACKSHIFT_HOURS);
+}
+//# sourceMappingURL=journey.js.map

package/dist/normalize/journey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey.js","sourceRoot":"","sources":["../../src/normalize/journey.ts"],"names":[],"mappings":"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"}

package/dist/normalize/line-schedule.js

@@ -0,0 +1,56 @@
+import { MetrolinxError } from "../errors.js";
+import { toIsoWithTorontoOffset } from "../time.js";
+function firstAndLastStop(stops) {
+    let first = stops[0];
+    let last = stops[0];
+    for (const stop of stops) {
+        if (stop.Order < first.Order)
+            first = stop;
+        if (stop.Order > last.Order)
+            last = stop;
+    }
+    return [first, last];
+}
+function summaryTrip(trip) {
+    const stops = trip.Stops ?? [];
+    if (stops.length === 0)
+        return undefined;
+    const [first, last] = firstAndLastStop(stops);
+    return {
+        trip_number: trip.Number,
+        display: trip.Display,
+        departs_first_stop: toIsoWithTorontoOffset(first.Time),
+        arrives_last_stop: toIsoWithTorontoOffset(last.Time),
+    };
+}
+function stopTimeTrip(trip, stopCode) {
+    const stop = (trip.Stops ?? []).find((s) => s.Code === stopCode);
+    if (!stop)
+        return undefined;
+    return {
+        trip_number: trip.Number,
+        display: trip.Display,
+        time: toIsoWithTorontoOffset(stop.Time),
+    };
+}
+// Schedule/Line/{Date}/{LineCode}/{LineDirection} is already scoped by the
+// request URL, so the response carries at most one Lines.Line entry for that
+// line/direction (confirmed live, issue #3 fixture capture).
+export function normalizeLineSchedule(raw, stopCode) {
+    const entry = raw.Lines?.Line?.[0];
+    if (!entry) {
+        throw new MetrolinxError("not_found", "No schedule for that line/direction. Verify both via list_lines.", false);
+    }
+    const trips = [];
+    for (const trip of entry.Trip ?? []) {
+        const mapped = stopCode ? stopTimeTrip(trip, stopCode) : summaryTrip(trip);
+        if (mapped)
+            trips.push(mapped);
+    }
+    return {
+        trips,
+        truncated: false,
+        total_matched: trips.length,
+    };
+}
+//# sourceMappingURL=line-schedule.js.map

package/dist/normalize/line-schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-schedule.js","sourceRoot":"","sources":["../../src/normalize/line-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAU9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,SAAS,gBAAgB,CACvB,KAA4B;IAE5B,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IACtB,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK;YAAE,KAAK,GAAG,IAAI,CAAC;QAC3C,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;YAAE,IAAI,GAAG,IAAI,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,WAAW,CAAC,IAAyB;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,MAAM;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,kBAAkB,EAAE,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC;QACtD,iBAAiB,EAAE,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,IAAyB,EACzB,QAAgB;IAEhB,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACjE,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,MAAM;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,6EAA6E;AAC7E,6DAA6D;AAC7D,MAAM,UAAU,qBAAqB,CACnC,GAA4B,EAC5B,QAAiB;IAEjB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,cAAc,CACtB,WAAW,EACX,kEAAkE,EAClE,KAAK,CACN,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3E,IAAI,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,OAAO;QACL,KAAK;QACL,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,KAAK,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC"}

package/dist/normalize/list-lines.js

@@ -0,0 +1,29 @@
+function modesOf(entry) {
+    const modes = [];
+    if (entry.IsTrain)
+        modes.push("train");
+    if (entry.IsBus)
+        modes.push("bus");
+    return modes;
+}
+function normalizeLine(entry) {
+    return {
+        line_code: entry.Code,
+        line_name: entry.Name,
+        modes: modesOf(entry),
+        variants: (entry.Variant ?? []).map((variant) => ({
+            code: variant.Code,
+            direction: variant.Direction,
+            display: variant.Display,
+        })),
+    };
+}
+export function normalizeListLines(raw) {
+    const lines = (raw.AllLines?.Line ?? []).map(normalizeLine);
+    return {
+        lines,
+        truncated: false,
+        total_matched: lines.length,
+    };
+}
+//# sourceMappingURL=list-lines.js.map

package/dist/normalize/list-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-lines.js","sourceRoot":"","sources":["../../src/normalize/list-lines.ts"],"names":[],"mappings":"AAMA,SAAS,OAAO,CAAC,KAAsB;IACrC,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,IAAI,KAAK,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAsB;IAC3C,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChD,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAuB;IACxD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC5D,OAAO;QACL,KAAK;QACL,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,KAAK,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC"}

package/dist/normalize/next-service.js

@@ -0,0 +1,59 @@
+import { MetrolinxError } from "../errors.js";
+import { diffMinutes, toIsoWithTorontoOffset } from "../time.js";
+function normalizeMode(serviceType) {
+    if (serviceType === "T")
+        return "train";
+    if (serviceType === "B")
+        return "bus";
+    // Stop/NextService captures have only shown "T" so far (issue #3); this is
+    // a best-effort default per the tool-schemas spec §1.1 single-letter
+    // enum-expansion pattern — revisit if another code is ever observed.
+    return "bus";
+}
+function normalizeStatus(departureStatus) {
+    // Confirmed empirically (tool-schemas spec §5): E = expected (not yet
+    // departed), A = actual (has departed). C never appeared live; "cancelled"
+    // is the best-effort inference carried over from ticket 006/#3.
+    if (departureStatus === "E")
+        return "expected";
+    if (departureStatus === "A")
+        return "actual";
+    if (departureStatus === "C")
+        return "cancelled";
+    return departureStatus;
+}
+function normalizeDeparture(line) {
+    const platform = {};
+    if (line.ScheduledPlatform)
+        platform.scheduled = line.ScheduledPlatform;
+    if (line.ActualPlatform)
+        platform.actual = line.ActualPlatform;
+    return {
+        line_code: line.LineCode,
+        line_name: line.LineName,
+        direction: line.DirectionName.trim(),
+        mode: normalizeMode(line.ServiceType),
+        scheduled_time: toIsoWithTorontoOffset(line.ScheduledDepartureTime),
+        expected_time: toIsoWithTorontoOffset(line.ComputedDepartureTime),
+        delay_minutes: diffMinutes(line.ComputedDepartureTime, line.ScheduledDepartureTime),
+        status: normalizeStatus(line.DepartureStatus),
+        platform,
+        trip_number: line.TripNumber,
+    };
+}
+export function normalizeNextService(raw) {
+    // An absent NextService block (Metadata.ErrorCode "204"/"No Content",
+    // confirmed live, issue #7) means the stop code itself is unknown — a
+    // present block with an empty/absent Lines array is a valid, just-quiet
+    // stop, which is not an error.
+    if (!raw.NextService) {
+        throw new MetrolinxError("not_found", "No stop matches that code. Verify the code via search_stops.", false);
+    }
+    const departures = (raw.NextService.Lines ?? []).map(normalizeDeparture);
+    return {
+        departures,
+        truncated: false,
+        total_matched: departures.length,
+    };
+}
+//# sourceMappingURL=next-service.js.map

package/dist/normalize/next-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-service.js","sourceRoot":"","sources":["../../src/normalize/next-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEjE,SAAS,aAAa,CAAC,WAAmB;IACxC,IAAI,WAAW,KAAK,GAAG;QAAE,OAAO,OAAO,CAAC;IACxC,IAAI,WAAW,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IACtC,2EAA2E;IAC3E,qEAAqE;IACrE,qEAAqE;IACrE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,eAAuB;IAC9C,sEAAsE;IACtE,2EAA2E;IAC3E,gEAAgE;IAChE,IAAI,eAAe,KAAK,GAAG;QAAE,OAAO,UAAU,CAAC;IAC/C,IAAI,eAAe,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,eAAe,KAAK,GAAG;QAAE,OAAO,WAAW,CAAC;IAChD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAwB;IAClD,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,IAAI,IAAI,CAAC,iBAAiB;QAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC;IACxE,IAAI,IAAI,CAAC,cAAc;QAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC;IAE/D,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE;QACpC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC;QACrC,cAAc,EAAE,sBAAsB,CAAC,IAAI,CAAC,sBAAsB,CAAC;QACnE,aAAa,EAAE,sBAAsB,CAAC,IAAI,CAAC,qBAAqB,CAAC;QACjE,aAAa,EAAE,WAAW,CACxB,IAAI,CAAC,qBAAqB,EAC1B,IAAI,CAAC,sBAAsB,CAC5B;QACD,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC;QAC7C,QAAQ;QACR,WAAW,EAAE,IAAI,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,GAA2B;IAE3B,sEAAsE;IACtE,sEAAsE;IACtE,wEAAwE;IACxE,+BAA+B;IAC/B,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,IAAI,cAAc,CACtB,WAAW,EACX,8DAA8D,EAC9D,KAAK,CACN,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACzE,OAAO;QACL,UAAU;QACV,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,UAAU,CAAC,MAAM;KACjC,CAAC;AACJ,CAAC"}

package/dist/normalize/search-stops.js

@@ -0,0 +1,113 @@
+function normalizeText(text) {
+    return text
+        .toLowerCase()
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+// Match tiers, best first — exact, prefix, then substring anywhere. Both
+// entries in an ambiguous name collision (e.g. "Oakville GO" as a Bus Stop
+// and as a Train & Bus Station) land in the same tier, so both surface as
+// candidates — required for plan_trip's later disambiguation reuse.
+function matchTier(name, query) {
+    const n = normalizeText(name);
+    const q = normalizeText(query);
+    if (!q)
+        return null;
+    if (n === q)
+        return 0;
+    if (n.startsWith(q))
+        return 1;
+    if (n.includes(q))
+        return 2;
+    return null;
+}
+export function stopType(locationType) {
+    if (locationType === "Train & Bus Station")
+        return "both";
+    if (locationType === "Train Station")
+        return "train";
+    return "bus";
+}
+function matchesFilter(type, filter) {
+    return filter === "any" || type === filter || type === "both";
+}
+// Station LocationCodes ("UN", "OA") are what Stop/Details and
+// Stop/NextService accept for train (and mixed) stops. Pure bus stops have
+// no such alpha code — their unified stop_code is the 6-digit PublicStopId
+// instead (tool-schemas spec §1.4). Unconfirmed against a live Stop/Details
+// call on a bus-only stop; revisit if that ever surfaces a mismatch.
+export function resolveStopCode(entry) {
+    return entry.LocationType.includes("Train")
+        ? entry.LocationCode
+        : entry.PublicStopId;
+}
+export function toStopMatch(entry) {
+    return {
+        stop_code: resolveStopCode(entry),
+        stop_name: entry.LocationName,
+        stop_type: stopType(entry.LocationType),
+    };
+}
+// Full stop dataset in the search_stops match shape (tool-schemas spec §3,
+// gotransit://stops resource) — every stop, unfiltered, sharing the same
+// per-entry mapping as normalizeSearchStops so the two paths cannot drift.
+export function normalizeAllStops(raw) {
+    const matches = (raw.Stations?.Station ?? []).map(toStopMatch);
+    return { matches, truncated: false, total_matched: matches.length };
+}
+function scoredMatches(entries, query, filter) {
+    return entries
+        .map((entry) => ({ entry, tier: matchTier(entry.LocationName, query) }))
+        .filter((scored) => scored.tier !== null)
+        .filter((scored) => matchesFilter(stopType(scored.entry.LocationType), filter));
+}
+export function normalizeSearchStops(raw, query, filter = "any", limit = 10) {
+    const scored = scoredMatches(raw.Stations?.Station ?? [], query, filter);
+    scored.sort((a, b) => a.tier - b.tier);
+    const totalMatched = scored.length;
+    const matches = scored
+        .slice(0, limit)
+        .map(({ entry }) => toStopMatch(entry));
+    return {
+        matches,
+        truncated: totalMatched > limit,
+        total_matched: totalMatched,
+    };
+}
+/** code -> stop_name, keyed by the unified stop_code (tool-schemas spec §1.4). */
+export function buildStopNameIndex(raw) {
+    const index = new Map();
+    for (const entry of raw.Stations?.Station ?? []) {
+        index.set(resolveStopCode(entry), entry.LocationName);
+    }
+    return index;
+}
+/**
+ * Resolves a `plan_trip` `from`/`to` input, which per tool-schemas spec §2.1
+ * accepts either a station/stop name (fuzzy-matched, same matcher as
+ * search_stops) or an exact stop code. An exact unified stop_code match
+ * short-circuits the fuzzy search. Otherwise, only the best-scoring tier is
+ * considered: a single best-tier match resolves; more than one (e.g. the
+ * real "Oakville GO" name collision, tool-schemas spec §5) is ambiguous,
+ * with candidates reproducible via search_stops for the same query.
+ */
+export function resolveStopByName(raw, query) {
+    const entries = raw.Stations?.Station ?? [];
+    const trimmed = query.trim().toLowerCase();
+    const codeMatch = entries.find((entry) => resolveStopCode(entry).toLowerCase() === trimmed);
+    if (codeMatch)
+        return { status: "resolved", match: toStopMatch(codeMatch) };
+    const scored = scoredMatches(entries, query, "any");
+    if (scored.length === 0)
+        return { status: "not_found" };
+    const bestTier = Math.min(...scored.map((s) => s.tier));
+    const candidates = scored
+        .filter((s) => s.tier === bestTier)
+        .map(({ entry }) => toStopMatch(entry));
+    if (candidates.length === 1)
+        return { status: "resolved", match: candidates[0] };
+    return { status: "ambiguous", candidates };
+}
+//# sourceMappingURL=search-stops.js.map

package/dist/normalize/search-stops.js.map

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

package/dist/normalize/service-alerts.js

@@ -0,0 +1,61 @@
+import { toIsoWithTorontoOffset } from "../time.js";
+// INIT/UPD/CORR/FINAL confirmed live across the ServiceAlert feed (issue #9:
+// only INIT/UPD observed so far; CORR/FINAL carried over from ticket 006's
+// documented mapping).
+function expandStatus(code) {
+    if (code === "INIT")
+        return "new";
+    if (code === "UPD")
+        return "updated";
+    if (code === "CORR")
+        return "corrected";
+    if (code === "FINAL")
+        return "final";
+    return "new";
+}
+function pickLang(en, fr, lang) {
+    if (lang === "fr" && fr)
+        return fr;
+    return en;
+}
+function normalizeMessage(message, category, lang) {
+    return {
+        id: message.Code,
+        category,
+        status: expandStatus(message.Status),
+        posted_at: toIsoWithTorontoOffset(message.PostedDateTime),
+        subject: pickLang(message.SubjectEnglish, message.SubjectFrench, lang),
+        body: pickLang(message.BodyEnglish, message.BodyFrench, lang),
+        affected: {
+            lines: (message.Lines ?? []).map((l) => l.Code),
+            stops: (message.Stops ?? []).map((s) => ({
+                stop_code: s.Code,
+                stop_name: s.Name ?? s.Code,
+            })),
+            trips: (message.Trips ?? []).map((t) => t.TripNumber),
+        },
+    };
+}
+// The category filter selects which upstream feeds get fetched (tool layer)
+// rather than being re-applied here — every message in `feeds` is already
+// in-scope by category.
+export function normalizeServiceAlerts(feeds, filters = {}) {
+    const lang = filters.lang ?? "en";
+    const limit = filters.limit ?? 20;
+    const alerts = feeds.flatMap((feed) => (feed.raw.Messages?.Message ?? []).map((m) => normalizeMessage(m, feed.category, lang)));
+    const filtered = alerts.filter((alert) => {
+        if (filters.line && !alert.affected.lines.includes(filters.line))
+            return false;
+        if (filters.stop &&
+            !alert.affected.stops.some((s) => s.stop_code === filters.stop))
+            return false;
+        return true;
+    });
+    const totalMatched = filtered.length;
+    return {
+        alerts: filtered.slice(0, limit),
+        truncated: totalMatched > limit,
+        total_matched: totalMatched,
+    };
+}
+//# sourceMappingURL=service-alerts.js.map

package/dist/normalize/service-alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-alerts.js","sourceRoot":"","sources":["../../src/normalize/service-alerts.ts"],"names":[],"mappings":"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"}

package/dist/normalize/service-exceptions.js

@@ -0,0 +1,51 @@
+import { toIsoWithTorontoOffset } from "../time.js";
+// Raw stops carry separate SchArrival/SchDeparture; the DTO wants one
+// scheduled_time per affected stop. Departure preferred (matches the rest
+// of the codebase's departure-first convention, e.g. Stop/NextService),
+// falling back to arrival for a trip's final stop.
+function scheduledTime(stop) {
+    const naive = stop.SchDeparture ?? stop.SchArrival;
+    return naive ? toIsoWithTorontoOffset(naive) : "";
+}
+// Confirmed live (issue #9 follow-up): IsCancelled/IsOverride arrive as
+// JSON strings ("True"/"False"), not native booleans — contrary to the
+// ticket 001 Help-page shape this endpoint's types were sourced from (never
+// part of issue #3's capture batch). Coerced case-insensitively; anything
+// that isn't exactly "true" is treated as false, same as a real `false`.
+function toBool(value) {
+    return typeof value === "boolean"
+        ? value
+        : value.trim().toLowerCase() === "true";
+}
+function normalizeStop(stop) {
+    const dto = {
+        stop_code: stop.Code,
+        stop_name: stop.Name,
+        scheduled_time: scheduledTime(stop),
+        cancelled: toBool(stop.IsCancelled),
+    };
+    if (stop.ActualTime)
+        dto.actual_time = toIsoWithTorontoOffset(stop.ActualTime);
+    return dto;
+}
+function normalizeTrip(trip) {
+    // "affected_stops" per the field's own name — only stops actually flagged
+    // cancelled or overridden, not every stop on the trip (anti-dump, same
+    // spirit as get_line_schedule's two-mode design).
+    const affected = (trip.Stop ?? []).filter((s) => toBool(s.IsCancelled) || toBool(s.IsOverride));
+    return {
+        trip_number: trip.TripNumber,
+        trip_name: trip.TripName,
+        cancelled: toBool(trip.IsCancelled),
+        affected_stops: affected.map(normalizeStop),
+    };
+}
+export function normalizeServiceExceptions(raw) {
+    const exceptions = (raw.Trip ?? []).map(normalizeTrip);
+    return {
+        exceptions,
+        truncated: false,
+        total_matched: exceptions.length,
+    };
+}
+//# sourceMappingURL=service-exceptions.js.map

package/dist/normalize/service-exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-exceptions.js","sourceRoot":"","sources":["../../src/normalize/service-exceptions.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,sEAAsE;AACtE,0EAA0E;AAC1E,wEAAwE;AACxE,mDAAmD;AACnD,SAAS,aAAa,CAAC,IAAsB;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU,CAAC;IACnD,OAAO,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,wEAAwE;AACxE,uEAAuE;AACvE,4EAA4E;AAC5E,0EAA0E;AAC1E,yEAAyE;AACzE,SAAS,MAAM,CAAC,KAAuB;IACrC,OAAO,OAAO,KAAK,KAAK,SAAS;QAC/B,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;AAC5C,CAAC;AAED,SAAS,aAAa,CAAC,IAAsB;IAC3C,MAAM,GAAG,GAAiB;QACxB,SAAS,EAAE,IAAI,CAAC,IAAI;QACpB,SAAS,EAAE,IAAI,CAAC,IAAI;QACpB,cAAc,EAAE,aAAa,CAAC,IAAI,CAAC;QACnC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;KACpC,CAAC;IACF,IAAI,IAAI,CAAC,UAAU;QACjB,GAAG,CAAC,WAAW,GAAG,sBAAsB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,IAAsB;IAC3C,0EAA0E;IAC1E,uEAAuE;IACvE,kDAAkD;IAClD,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CACrD,CAAC;IACF,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,UAAU;QAC5B,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QACnC,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,GAAiC;IAEjC,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACvD,OAAO;QACL,UAAU;QACV,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,UAAU,CAAC,MAAM;KACjC,CAAC;AACJ,CAAC"}

package/dist/normalize/service-guarantee.js

@@ -0,0 +1,23 @@
+function normalizeStop(stop, lang) {
+    return {
+        stop_code: stop.Code,
+        scope: stop.Scope,
+        reason: lang === "fr" && stop.ReasonFr ? stop.ReasonFr : stop.ReasonEn,
+    };
+}
+export function normalizeServiceGuarantee(raw, lang = "en") {
+    // Confirmed live (issue #9 follow-up): a real, unambiguously-valid
+    // trip_number/date returned an absent Stops container. The
+    // presence-vs-absence "not_found" signal confirmed for other endpoints
+    // (Stop/Details, Stop/NextService, Stop/Destinations) does NOT hold here
+    // — an absent container is the ordinary shape for "this trip wasn't
+    // delayed enough to be guarantee-eligible," not a signal that the
+    // trip/date itself is wrong. Previously this threw not_found for every
+    // non-eligible trip, which is most of them.
+    const stops = raw.Stops?.Stop ?? [];
+    return {
+        eligible: stops.length > 0,
+        stops: stops.map((s) => normalizeStop(s, lang)),
+    };
+}
+//# sourceMappingURL=service-guarantee.js.map

package/dist/normalize/service-guarantee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-guarantee.js","sourceRoot":"","sources":["../../src/normalize/service-guarantee.ts"],"names":[],"mappings":"AASA,SAAS,aAAa,CACpB,IAAsB,EACtB,IAAiB;IAEjB,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,IAAI;QACpB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,GAAgC,EAChC,OAAoB,IAAI;IAExB,mEAAmE;IACnE,2DAA2D;IAC3D,uEAAuE;IACvE,yEAAyE;IACzE,oEAAoE;IACpE,kEAAkE;IAClE,uEAAuE;IACvE,4CAA4C;IAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC;IACpC,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;QAC1B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;KAChD,CAAC;AACJ,CAAC"}