mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 16:22:20 +00:00
Unknown aircraft tracks read as empty instead of a server error, aircraft info names the aircraft and flight, the HUD caption sends the app's caption context, and satellite pass, satellites overhead and nearby places take a place name or point like the other tools.
268 lines
8.3 KiB
JavaScript
268 lines
8.3 KiB
JavaScript
/** Space queries: launches, satellite passes and satellites overhead. */
|
|
|
|
import { twoline2satrec } from 'satellite.js';
|
|
import {
|
|
findNextSatellitePass,
|
|
lookAnglesAt,
|
|
} from '../../data/satellitePass.js';
|
|
import { parseTleText, tleCatalogNumber } from '../../sources/tle.js';
|
|
import { POINT_SCHEMA, resolvePoint } from '../area.js';
|
|
import { defineTool, ToolError } from '../catalog.js';
|
|
import { LIMIT_SCHEMA, capRows, countNoun, isoTime } from '../results.js';
|
|
|
|
const text = (value) => (typeof value === 'string' && value ? value : null);
|
|
|
|
export const getRecentLaunches = defineTool({
|
|
name: 'get_recent_launches',
|
|
title: 'Recent launches',
|
|
description:
|
|
'Orbital launches from Launch Library 2 over the last 30 days, newest ' +
|
|
'first, with provider, rocket, pad, mission and outcome.',
|
|
inputSchema: {
|
|
type: 'object',
|
|
properties: { limit: LIMIT_SCHEMA },
|
|
additionalProperties: false,
|
|
},
|
|
requires: ['launches'],
|
|
async run(args, { services, signal }) {
|
|
const payload = await services.launches.getLaunches({ signal });
|
|
const launches = Array.isArray(payload) ? payload : payload.results;
|
|
if (!Array.isArray(launches))
|
|
throw new ToolError('malformed', 'The launch feed returned no launches');
|
|
const rows = launches
|
|
.map((launch) => ({
|
|
id: text(launch?.id),
|
|
name: text(launch?.name),
|
|
time: text(launch?.net),
|
|
status: text(launch?.status?.name),
|
|
provider: text(launch?.launch_service_provider?.name),
|
|
rocket: text(
|
|
launch?.rocket?.configuration?.full_name ??
|
|
launch?.rocket?.configuration?.name,
|
|
),
|
|
pad: text(launch?.pad?.name),
|
|
location: text(launch?.pad?.location?.name),
|
|
mission: text(launch?.mission?.name),
|
|
orbit: text(launch?.mission?.orbit?.name),
|
|
}))
|
|
.filter((launch) => launch.name)
|
|
.sort((a, b) => String(b.time).localeCompare(String(a.time)));
|
|
const result = capRows(rows, args.limit);
|
|
return {
|
|
summary: `${countNoun(rows.length, 'launch', 'launches')} in the last 30 days${rows[0] ? `; latest ${rows[0].name}` : ''}.`,
|
|
data: result,
|
|
};
|
|
},
|
|
});
|
|
|
|
// Groups served by the satellite catalog route; `stations` includes the ISS.
|
|
const GROUPS = [
|
|
'stations',
|
|
'visual',
|
|
'gps-ops',
|
|
'glo-ops',
|
|
'galileo',
|
|
'geo',
|
|
'starlink',
|
|
];
|
|
const ISS_NORAD = 25544;
|
|
const COMPASS = [
|
|
'N',
|
|
'NNE',
|
|
'NE',
|
|
'ENE',
|
|
'E',
|
|
'ESE',
|
|
'SE',
|
|
'SSE',
|
|
'S',
|
|
'SSW',
|
|
'SW',
|
|
'WSW',
|
|
'W',
|
|
'WNW',
|
|
'NW',
|
|
'NNW',
|
|
];
|
|
const GROUP_SCHEMA = {
|
|
type: 'string',
|
|
enum: GROUPS,
|
|
description: 'CelesTrak group to search (default "stations").',
|
|
};
|
|
|
|
const compass = (degrees) =>
|
|
COMPASS[Math.round((((degrees % 360) + 360) % 360) / 22.5) % 16];
|
|
const round = (value, digits) =>
|
|
Number.isFinite(value) ? Number(value.toFixed(digits)) : null;
|
|
const nowMs = (services) => services.clock?.now() ?? Date.now();
|
|
|
|
async function readCatalog(services, group, signal) {
|
|
const result = await services.satellites.readGroup(group, { signal });
|
|
if (!result.ok)
|
|
throw new ToolError(
|
|
'unavailable',
|
|
`The ${group} satellite catalog is unavailable (HTTP ${result.status})`,
|
|
);
|
|
return parseTleText(result.text).flatMap((entry) => {
|
|
try {
|
|
return [
|
|
{
|
|
...entry,
|
|
norad: tleCatalogNumber(entry.line1),
|
|
satrec: twoline2satrec(entry.line1, entry.line2),
|
|
},
|
|
];
|
|
} catch {
|
|
return [];
|
|
}
|
|
});
|
|
}
|
|
|
|
function matchSatellite(entries, wanted) {
|
|
if (wanted == null)
|
|
return entries.find((entry) => entry.norad === ISS_NORAD) ?? null;
|
|
const text = String(wanted).trim().toUpperCase();
|
|
const number = /^\d+$/.test(text) ? Number(text) : null;
|
|
return (
|
|
entries.find((entry) => number != null && entry.norad === number) ??
|
|
entries.find((entry) => entry.name.toUpperCase() === text) ??
|
|
entries.find((entry) => entry.name.toUpperCase().includes(text)) ??
|
|
null
|
|
);
|
|
}
|
|
|
|
export const nextSatellitePass = defineTool({
|
|
name: 'next_satellite_pass',
|
|
title: 'Next satellite pass',
|
|
description:
|
|
'When a satellite next rises over an observer, with rise, peak and set ' +
|
|
'times, peak elevation, rise direction and naked-eye visibility. Defaults ' +
|
|
'to the International Space Station.',
|
|
inputSchema: {
|
|
type: 'object',
|
|
properties: {
|
|
location: POINT_SCHEMA,
|
|
satellite: {
|
|
type: 'string',
|
|
minLength: 1,
|
|
maxLength: 80,
|
|
description:
|
|
'Satellite name or NORAD catalog number (default the ISS).',
|
|
},
|
|
group: GROUP_SCHEMA,
|
|
min_elevation_deg: { type: 'number', minimum: 0, maximum: 80 },
|
|
visible_only: {
|
|
type: 'boolean',
|
|
description: 'Only passes visible to the naked eye.',
|
|
},
|
|
hours: { type: 'number', minimum: 1, maximum: 72 },
|
|
},
|
|
required: ['location'],
|
|
additionalProperties: false,
|
|
},
|
|
requires: ['satellites'],
|
|
async run(args, { services, signal }) {
|
|
const point = await resolvePoint(args.location, { services, signal });
|
|
const group = args.group ?? 'stations';
|
|
const entries = await readCatalog(services, group, signal);
|
|
const satellite = matchSatellite(entries, args.satellite);
|
|
if (!satellite)
|
|
throw new ToolError(
|
|
'invalid_arguments',
|
|
`No satellite matching "${args.satellite ?? 'ISS'}" is in the ${group} group`,
|
|
);
|
|
const hours = args.hours ?? 24;
|
|
const pass = findNextSatellitePass({
|
|
satrec: satellite.satrec,
|
|
latDeg: point.lat,
|
|
lonDeg: point.lon,
|
|
fromMs: nowMs(services),
|
|
minElevDeg: args.min_elevation_deg ?? 10,
|
|
horizonHours: hours,
|
|
requireVisible: args.visible_only === true,
|
|
});
|
|
const name = satellite.name;
|
|
if (!pass)
|
|
return {
|
|
summary: `${name} has no ${args.visible_only ? 'visible ' : ''}pass over ${point.label} in the next ${hours} hours.`,
|
|
data: {
|
|
location: point,
|
|
satellite: name,
|
|
norad: satellite.norad,
|
|
pass: null,
|
|
},
|
|
};
|
|
return {
|
|
summary:
|
|
`${name} next rises over ${point.label} at ${isoTime(pass.riseMs)} in the ${compass(pass.riseAzDeg)}, ` +
|
|
`peaking at ${Math.round(pass.maxElevDeg)}°` +
|
|
`${pass.visible ? '; visible to the naked eye' : ''}.`,
|
|
data: {
|
|
location: point,
|
|
satellite: name,
|
|
norad: satellite.norad,
|
|
pass: {
|
|
rise: isoTime(pass.riseMs),
|
|
peak: isoTime(pass.maxElevMs),
|
|
set: isoTime(pass.setMs),
|
|
max_elevation_deg: round(pass.maxElevDeg, 1),
|
|
rise_azimuth_deg: round(pass.riseAzDeg, 0),
|
|
rise_direction: compass(pass.riseAzDeg),
|
|
visible: pass.visible,
|
|
},
|
|
},
|
|
};
|
|
},
|
|
});
|
|
|
|
export const satellitesOverhead = defineTool({
|
|
name: 'satellites_overhead',
|
|
title: 'Satellites overhead',
|
|
description:
|
|
'Satellites in a group that are above an observer right now, highest first, ' +
|
|
'with elevation and direction.',
|
|
inputSchema: {
|
|
type: 'object',
|
|
properties: {
|
|
location: POINT_SCHEMA,
|
|
group: GROUP_SCHEMA,
|
|
min_elevation_deg: { type: 'number', minimum: 0, maximum: 90 },
|
|
limit: LIMIT_SCHEMA,
|
|
},
|
|
required: ['location'],
|
|
additionalProperties: false,
|
|
},
|
|
requires: ['satellites'],
|
|
async run(args, { services, signal }) {
|
|
const point = await resolvePoint(args.location, { services, signal });
|
|
const group = args.group ?? 'stations';
|
|
const minimum = args.min_elevation_deg ?? 10;
|
|
const at = nowMs(services);
|
|
const rows = (await readCatalog(services, group, signal))
|
|
.flatMap((entry) => {
|
|
const look = lookAnglesAt(entry.satrec, at, point.lat, point.lon);
|
|
return look && look.elevDeg >= minimum
|
|
? [
|
|
{
|
|
name: entry.name,
|
|
norad: entry.norad,
|
|
elevation_deg: round(look.elevDeg, 1),
|
|
azimuth_deg: round(look.azDeg, 0),
|
|
direction: compass(look.azDeg),
|
|
},
|
|
]
|
|
: [];
|
|
})
|
|
.sort((a, b) => b.elevation_deg - a.elevation_deg);
|
|
return {
|
|
summary: `${countNoun(rows.length, 'satellite')} from the ${group} group ${rows.length === 1 ? 'is' : 'are'} at least ${minimum}° above ${point.label} at ${isoTime(at)}.`,
|
|
data: {
|
|
...capRows(rows, args.limit),
|
|
location: point,
|
|
group,
|
|
at: isoTime(at),
|
|
},
|
|
};
|
|
},
|
|
});
|