@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/12306/price.js

@@ -1,166 +0,0 @@
-/**
- * 12306 ticket price lookup for a single train + segment.
- *
- * Cascades three anonymous API calls:
- *   1. /otn/leftTicket/init: mint session cookies
- *   2. /otn/czxx/queryByTrainNo: resolve from/to station_no within the
- *      train route (price endpoint addresses stops by station_no, not
- *      telecode)
- *   3. /otn/leftTicket/queryTicketPrice: ticket prices keyed by seat
- *      letter (M=一等座, O=二等座, A9=商务座, A1=硬座, A3=硬卧,
- *      A4=软卧, F=动卧, P=特等座, WZ=无座, etc.)
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { fetchStationBundle, mintSession, resolveStation, validateDate } from './utils.js';
-
-const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36';
-const TRAIN_NO_RE = /^[0-9A-Za-z]{8,18}$/;
-const SEAT_TYPES_RE = /^[A-Z0-9]{1,32}$/;
-
-const SEAT_LETTERS = {
-    'A9': '商务座',
-    'P': '特等座',
-    'M': '一等座',
-    'O': '二等座',
-    'A1': '硬座',
-    'A3': '硬卧',
-    'A4': '软卧',
-    'F': '动卧',
-    'WZ': '无座',
-};
-
-async function queryStopsForPrice(cookieHeader, trainNo, fromCode, toCode, date, fetchImpl = fetch) {
-    const url = `https://kyfw.12306.cn/otn/czxx/queryByTrainNo?train_no=${trainNo}&from_station_telecode=${fromCode}&to_station_telecode=${toCode}&depart_date=${date}`;
-    const resp = await fetchImpl(url, {
-        headers: {
-            'User-Agent': UA,
-            'Referer': 'https://kyfw.12306.cn/otn/leftTicket/init',
-            'Cookie': cookieHeader,
-        },
-    });
-    if (!resp.ok) throw new CommandExecutionError(`12306 queryByTrainNo returned HTTP ${resp.status}`);
-    let json;
-    try {
-        json = await resp.json();
-    } catch {
-        throw new CommandExecutionError('12306 queryByTrainNo returned non-JSON body');
-    }
-    if (json?.status !== true || !Array.isArray(json?.data?.data)) {
-        throw new CommandExecutionError('12306 queryByTrainNo returned an unexpected payload shape');
-    }
-    return json.data.data;
-}
-
-function pickStationNos(stops, fromCode, toCode, fromName, toName) {
-    const matches = (s, code, name) => (s.station_name && name && s.station_name === name);
-    const fromStop = stops.find((s) => matches(s, fromCode, fromName));
-    const toStop = stops.find((s) => matches(s, toCode, toName));
-    if (!fromStop) throw new CommandExecutionError(`Train does not stop at ${fromName}`);
-    if (!toStop) throw new CommandExecutionError(`Train does not stop at ${toName}`);
-    return { fromNo: fromStop.station_no, toNo: toStop.station_no };
-}
-
-async function queryPrice(cookieHeader, trainNo, fromNo, toNo, seatTypes, date, fetchImpl = fetch) {
-    const url = `https://kyfw.12306.cn/otn/leftTicket/queryTicketPrice?train_no=${trainNo}&from_station_no=${fromNo}&to_station_no=${toNo}&seat_types=${seatTypes}&train_date=${date}`;
-    const resp = await fetchImpl(url, {
-        headers: {
-            'User-Agent': UA,
-            'Referer': 'https://kyfw.12306.cn/otn/leftTicket/init',
-            'Cookie': cookieHeader,
-        },
-    });
-    if (!resp.ok) throw new CommandExecutionError(`12306 queryTicketPrice returned HTTP ${resp.status}`);
-    let json;
-    try {
-        json = await resp.json();
-    } catch {
-        throw new CommandExecutionError('12306 queryTicketPrice returned non-JSON body');
-    }
-    if (json?.status !== true || !json?.data) {
-        throw new CommandExecutionError('12306 queryTicketPrice returned an unexpected payload shape');
-    }
-    return json.data;
-}
-
-function parsePriceData(priceData) {
-    const rows = [];
-    for (const [letter, value] of Object.entries(priceData)) {
-        if (letter === 'train_no' || letter === 'OT') continue;
-        if (typeof value !== 'string' || !value) continue;
-        // 12306 doubles up some prices as bare numerics ("9": "21580"), which
-        // mirror their letter sibling ("A9": "¥2158.0") in cents/no-decimal
-        // form. Skip the bare numeric letter codes to avoid duplicates.
-        if (/^\d+$/.test(letter)) continue;
-        if (!/^[A-Z]/.test(letter)) continue;
-        const numeric = value.replace(/^¥/, '');
-        if (!/^[\d.]+$/.test(numeric)) continue;
-        rows.push({
-            seat_code: letter,
-            seat_name: SEAT_LETTERS[letter] || letter,
-            price: numeric,
-            currency: 'CNY',
-        });
-    }
-    rows.sort((a, b) => Number(b.price) - Number(a.price));
-    return rows;
-}
-
-cli({
-    site: '12306',
-    name: 'price',
-    access: 'read',
-    description: 'Look up 12306 ticket prices by seat class for one train on a given date and segment (anonymous, no login required)',
-    domain: 'kyfw.12306.cn',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'train-no', positional: true, required: true, help: 'Internal train_no from `12306 trains` (e.g. 24000000G10L)' },
-        { name: 'from', required: true, help: 'Origin station (Chinese name, telecode, or pinyin) - must be a stop of this train' },
-        { name: 'to', required: true, help: 'Destination station - must be a stop of this train' },
-        { name: 'date', required: true, help: 'Departure date in YYYY-MM-DD' },
-        { name: 'seat-types', default: 'OM9PA1A3A4FWZ', help: 'Seat-type letters to query (default covers the common classes). Examples: OM9 (二等/一等/商务), A1A3A4 (硬座/硬卧/软卧).' },
-    ],
-    columns: ['seat_code', 'seat_name', 'price', 'currency'],
-    func: async (kwargs) => {
-        const trainNo = String(kwargs['train-no'] ?? '').trim();
-        if (!trainNo) throw new ArgumentError('<train-no> must not be empty');
-        if (!TRAIN_NO_RE.test(trainNo)) {
-            throw new ArgumentError(
-                `<train-no> "${trainNo}" does not look like a 12306 internal train_no`,
-                'Use the train_no field from `12306 trains` output (e.g. 24000000G10L), not the public code (G1).',
-            );
-        }
-        const fromArg = String(kwargs.from ?? '').trim();
-        const toArg = String(kwargs.to ?? '').trim();
-        if (!fromArg) throw new ArgumentError('--from station must not be empty');
-        if (!toArg) throw new ArgumentError('--to station must not be empty');
-        const date = validateDate(kwargs.date);
-        const seatTypes = String(kwargs['seat-types'] ?? '').trim() || 'OM9PA1A3A4FWZ';
-        if (!SEAT_TYPES_RE.test(seatTypes)) {
-            throw new ArgumentError('--seat-types must contain only 12306 seat letters/digits (A-Z, 0-9)');
-        }
-
-        const stations = await fetchStationBundle();
-        const fromStation = resolveStation(stations, fromArg);
-        const toStation = resolveStation(stations, toArg);
-        if (fromStation.code === toStation.code) {
-            throw new ArgumentError(`--from and --to must differ; both resolved to ${fromStation.name} (${fromStation.code})`);
-        }
-
-        const cookieHeader = await mintSession();
-        const stops = await queryStopsForPrice(cookieHeader, trainNo, fromStation.code, toStation.code, date);
-        const { fromNo, toNo } = pickStationNos(stops, fromStation.code, toStation.code, fromStation.name, toStation.name);
-        const priceData = await queryPrice(cookieHeader, trainNo, fromNo, toNo, seatTypes, date);
-        const rows = parsePriceData(priceData);
-        if (rows.length === 0) {
-            throw new EmptyResultError(
-                `No prices returned for train_no=${trainNo} ${fromStation.name} -> ${toStation.name} on ${date}`,
-                'Try a different seat-types letter set, or check that this train operates on the date.',
-            );
-        }
-        return rows;
-    },
-});
-
-export const __test__ = { parsePriceData, pickStationNos, queryStopsForPrice, queryPrice, SEAT_LETTERS, TRAIN_NO_RE };

package/clis/12306/stations.js

@@ -1,66 +0,0 @@
-/**
- * 12306 station search.
- *
- * Queries the public `station_name.js` bundle and filters by the user's
- * keyword. Anonymous, no session needed.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { fetchStationBundle } from './utils.js';
-
-const MAX_LIMIT = 50;
-
-function normalizeLimit(value, defaultValue, max) {
-    if (value === undefined || value === null || value === '') return defaultValue;
-    const n = Number(value);
-    if (!Number.isInteger(n) || n < 1) {
-        throw new ArgumentError(`limit must be a positive integer (1-${max})`);
-    }
-    if (n > max) {
-        throw new ArgumentError(`limit must be <= ${max}`);
-    }
-    return n;
-}
-
-cli({
-    site: '12306',
-    name: 'stations',
-    access: 'read',
-    description: 'Search 12306 (China Railway) stations by Chinese name, telecode, or pinyin keyword',
-    domain: 'kyfw.12306.cn',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'keyword', positional: true, required: true, help: 'Chinese substring (上海), telecode (AOH), or pinyin (shanghai)' },
-        { name: 'limit', type: 'int', default: 20, help: `Maximum results (1-${MAX_LIMIT})` },
-    ],
-    columns: ['name', 'code', 'pinyin', 'abbr', 'city'],
-    func: async (kwargs) => {
-        const keyword = String(kwargs.keyword ?? '').trim();
-        if (!keyword) throw new ArgumentError('keyword must not be empty');
-        const limit = normalizeLimit(kwargs.limit, 20, MAX_LIMIT);
-
-        const stations = await fetchStationBundle();
-        const lower = keyword.toLowerCase();
-        const matches = stations.filter((s) =>
-            s.name.includes(keyword)
-            || s.code === keyword.toUpperCase()
-            || s.pinyin.includes(lower)
-            || s.abbr.includes(lower)
-            || s.short.includes(lower)
-            || s.city.includes(keyword),
-        );
-        if (matches.length === 0) {
-            throw new EmptyResultError(`No 12306 stations match "${keyword}"`);
-        }
-        return matches.slice(0, limit).map((s) => ({
-            name: s.name,
-            code: s.code,
-            pinyin: s.pinyin,
-            abbr: s.abbr,
-            city: s.city,
-        }));
-    },
-});
-
-export const __test__ = { normalizeLimit };

package/clis/12306/train.js

@@ -1,91 +0,0 @@
-/**
- * 12306 train stop details - list every station a train calls at,
- * with arrival / departure / stopover time.
- *
- * Requires the internal `train_no` returned by `12306 trains`
- * (`24000000G10L`), not the public train code (`G1`).
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { fetchStationBundle, mintSession, resolveStation, validateDate } from './utils.js';
-
-const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36';
-const TRAIN_NO_RE = /^[0-9A-Za-z]{8,18}$/;
-
-async function queryStops(cookieHeader, trainNo, fromCode, toCode, date, fetchImpl = fetch) {
-    const url = `https://kyfw.12306.cn/otn/czxx/queryByTrainNo?train_no=${trainNo}&from_station_telecode=${fromCode}&to_station_telecode=${toCode}&depart_date=${date}`;
-    const resp = await fetchImpl(url, {
-        headers: {
-            'User-Agent': UA,
-            'Referer': 'https://kyfw.12306.cn/otn/leftTicket/init',
-            'Cookie': cookieHeader,
-        },
-    });
-    if (!resp.ok) {
-        throw new CommandExecutionError(`12306 queryByTrainNo returned HTTP ${resp.status}`);
-    }
-    let json;
-    try {
-        json = await resp.json();
-    } catch {
-        throw new CommandExecutionError('12306 queryByTrainNo returned non-JSON body');
-    }
-    if (json?.status !== true || !Array.isArray(json?.data?.data)) {
-        throw new CommandExecutionError(`12306 queryByTrainNo returned an unexpected payload shape`);
-    }
-    return json.data.data;
-}
-
-cli({
-    site: '12306',
-    name: 'train',
-    access: 'read',
-    description: 'List every station a 12306 train calls at, with arrival / departure / stopover time (anonymous, no login required)',
-    domain: 'kyfw.12306.cn',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'train-no', positional: true, required: true, help: 'Internal train_no from `12306 trains` (e.g. 24000000G10L), not the public code (G1)' },
-        { name: 'from', required: true, help: 'Origin station for the segment: Chinese name, telecode, or pinyin' },
-        { name: 'to', required: true, help: 'Destination station for the segment' },
-        { name: 'date', required: true, help: 'Departure date in YYYY-MM-DD' },
-    ],
-    columns: ['station_no', 'station_name', 'arrive_time', 'start_time', 'stopover_time'],
-    func: async (kwargs) => {
-        const trainNo = String(kwargs['train-no'] ?? '').trim();
-        if (!trainNo) throw new ArgumentError('<train-no> must not be empty');
-        if (!TRAIN_NO_RE.test(trainNo)) {
-            throw new ArgumentError(
-                `<train-no> "${trainNo}" does not look like a 12306 internal train_no`,
-                'Use the train_no field from `12306 trains` output (e.g. 24000000G10L), not the public code (G1).',
-            );
-        }
-        const fromArg = String(kwargs.from ?? '').trim();
-        const toArg = String(kwargs.to ?? '').trim();
-        if (!fromArg) throw new ArgumentError('--from station must not be empty');
-        if (!toArg) throw new ArgumentError('--to station must not be empty');
-        const date = validateDate(kwargs.date);
-
-        const stations = await fetchStationBundle();
-        const fromStation = resolveStation(stations, fromArg);
-        const toStation = resolveStation(stations, toArg);
-        if (fromStation.code === toStation.code) {
-            throw new ArgumentError(`--from and --to must differ; both resolved to ${fromStation.name} (${fromStation.code})`);
-        }
-
-        const cookieHeader = await mintSession();
-        const stops = await queryStops(cookieHeader, trainNo, fromStation.code, toStation.code, date);
-        if (stops.length === 0) {
-            throw new EmptyResultError(`No stops returned for train_no=${trainNo} on ${date}`);
-        }
-        return stops.map((s) => ({
-            station_no: s.station_no || '',
-            station_name: s.station_name || '',
-            arrive_time: s.arrive_time === '----' ? '' : (s.arrive_time || ''),
-            start_time: s.start_time === '----' ? '' : (s.start_time || ''),
-            stopover_time: s.stopover_time === '----' ? '' : (s.stopover_time || ''),
-        }));
-    },
-});
-
-export const __test__ = { queryStops, TRAIN_NO_RE };

package/clis/12306/trains.js

@@ -1,166 +0,0 @@
-/**
- * 12306 train availability between two stations on a given date.
- *
- * Flow:
- *   1. Fetch the station bundle (cached implicitly via per-process module state).
- *   2. Mint anonymous session cookies via /otn/leftTicket/init.
- *   3. Query /otn/leftTicket/queryG; if 12306 returns
- *      `{c_url: "leftTicket/queryX"}` (endpoint rotation), retry once
- *      against the suggested name.
- *   4. Parse the `|`-separated train records.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { fetchStationBundle, mintSession, resolveStation, validateDate, parseTrainRecord } from './utils.js';
-
-const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36';
-const QUERY_ENDPOINTS = ['queryG', 'queryO', 'queryZ', 'queryA'];
-const MAX_LIMIT = 100;
-const QUERY_ENDPOINT_RE = /^query[A-Z]$/;
-
-function normalizeLimit(value, defaultValue, max) {
-    if (value === undefined || value === null || value === '') return defaultValue;
-    const n = Number(value);
-    if (!Number.isInteger(n) || n < 1) {
-        throw new ArgumentError(`limit must be a positive integer (1-${max})`);
-    }
-    if (n > max) {
-        throw new ArgumentError(`limit must be <= ${max}`);
-    }
-    return n;
-}
-
-function extractQueryEndpoint(value) {
-    const raw = String(value ?? '').trim();
-    if (!raw) return '';
-    const direct = raw.replace(/^leftTicket\//, '').trim();
-    if (QUERY_ENDPOINT_RE.test(direct)) return direct;
-    try {
-        const url = new URL(raw, 'https://kyfw.12306.cn');
-        if (url.hostname !== 'kyfw.12306.cn') return '';
-        const match = url.pathname.match(/\/leftTicket\/(query[A-Z])$/);
-        return match ? match[1] : '';
-    }
-    catch {
-        return '';
-    }
-}
-
-async function parseRotationEndpoint(resp, endpoint, bodyText) {
-    let json;
-    if (bodyText) {
-        try { json = JSON.parse(bodyText); } catch { /* body may be HTML on non-rotation redirects */ }
-    }
-    const bodyEndpoint = extractQueryEndpoint(json?.c_url);
-    if (bodyEndpoint) return bodyEndpoint;
-    const locationEndpoint = extractQueryEndpoint(resp.headers?.get?.('location'));
-    if (locationEndpoint) return locationEndpoint;
-    if (resp.status === 302) {
-        throw new CommandExecutionError(`12306 ${endpoint} redirected without a leftTicket query endpoint`);
-    }
-    if (json?.c_url) {
-        throw new CommandExecutionError(`12306 ${endpoint} returned an invalid rotation endpoint`);
-    }
-    return '';
-}
-
-async function queryLeftTickets(cookieHeader, fromCode, toCode, date) {
-    const headers = {
-        'User-Agent': UA,
-        'Referer': 'https://kyfw.12306.cn/otn/leftTicket/init',
-        'Cookie': cookieHeader,
-    };
-    const queryParams = `leftTicketDTO.train_date=${date}&leftTicketDTO.from_station=${fromCode}&leftTicketDTO.to_station=${toCode}&purpose_codes=ADULT`;
-    let lastResponseText = '';
-    const queue = [...QUERY_ENDPOINTS];
-    const tried = new Set();
-    while (queue.length > 0) {
-        const endpoint = queue.shift();
-        if (tried.has(endpoint)) continue;
-        tried.add(endpoint);
-        const url = `https://kyfw.12306.cn/otn/leftTicket/${endpoint}?${queryParams}`;
-        const resp = await fetch(url, { headers, redirect: 'manual' });
-        if (!resp.ok) {
-            if (resp.status === 302) {
-                const body = await resp.text();
-                const rotated = await parseRotationEndpoint(resp, endpoint, body);
-                if (rotated && !tried.has(rotated)) {
-                    queue.unshift(rotated);
-                }
-                continue;
-            }
-            throw new CommandExecutionError(`12306 ${endpoint} returned HTTP ${resp.status}`);
-        }
-        const text = await resp.text();
-        lastResponseText = text;
-        let json;
-        try { json = JSON.parse(text); } catch {
-            throw new CommandExecutionError(`12306 ${endpoint} returned non-JSON body`);
-        }
-        if (json?.c_url && typeof json.c_url === 'string') {
-            const rotated = await parseRotationEndpoint(resp, endpoint, text);
-            if (rotated && !tried.has(rotated)) {
-                queue.unshift(rotated);
-            }
-            continue;
-        }
-        if (Array.isArray(json?.data?.result)) {
-            return json.data.result;
-        }
-        throw new CommandExecutionError(`12306 ${endpoint} returned an unexpected payload shape`);
-    }
-    throw new CommandExecutionError(`12306 rejected every known query endpoint name (${QUERY_ENDPOINTS.join(', ')}); the wire protocol may have changed. Last body: ${lastResponseText.slice(0, 200)}`);
-}
-
-cli({
-    site: '12306',
-    name: 'trains',
-    access: 'read',
-    description: 'List trains between two 12306 stations on a given date (anonymous, no login required)',
-    domain: 'kyfw.12306.cn',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'from', positional: true, required: true, help: 'Origin station: Chinese name (北京), telecode (BJP), or pinyin (beijing)' },
-        { name: 'to', positional: true, required: true, help: 'Destination station: same forms as <from>' },
-        { name: 'date', required: true, help: 'Departure date in YYYY-MM-DD' },
-        { name: 'limit', type: 'int', default: 50, help: `Maximum rows (1-${MAX_LIMIT})` },
-    ],
-    columns: [
-        'code', 'from_station', 'to_station', 'start_time', 'arrive_time',
-        'duration', 'available', 'business_seat', 'first_seat', 'second_seat',
-        'soft_sleeper', 'hard_sleeper', 'hard_seat', 'no_seat', 'train_no',
-    ],
-    func: async (kwargs) => {
-        const fromArg = String(kwargs.from ?? '').trim();
-        const toArg = String(kwargs.to ?? '').trim();
-        if (!fromArg) throw new ArgumentError('<from> station must not be empty');
-        if (!toArg) throw new ArgumentError('<to> station must not be empty');
-        const date = validateDate(kwargs.date);
-        const limit = normalizeLimit(kwargs.limit, 50, MAX_LIMIT);
-
-        const stations = await fetchStationBundle();
-        const fromStation = resolveStation(stations, fromArg);
-        const toStation = resolveStation(stations, toArg);
-        if (fromStation.code === toStation.code) {
-            throw new ArgumentError(`<from> and <to> must differ; both resolved to ${fromStation.name} (${fromStation.code})`);
-        }
-        const stationByCode = new Map(stations.map((s) => [s.code, s]));
-
-        const cookieHeader = await mintSession();
-        const rawRows = await queryLeftTickets(cookieHeader, fromStation.code, toStation.code, date);
-        const decoded = rawRows
-            .map((line) => parseTrainRecord(decodeURIComponent(line.replace(/%0A/g, '')), stationByCode))
-            .filter(Boolean);
-
-        if (decoded.length === 0) {
-            throw new EmptyResultError(
-                `No trains found from ${fromStation.name} to ${toStation.name} on ${date}`,
-                'Try a different date or check whether the route is operated by 12306.',
-            );
-        }
-        return decoded.slice(0, limit);
-    },
-});
-
-export const __test__ = { normalizeLimit, extractQueryEndpoint, queryLeftTickets };