/** Public camera and radio queries over the CCTV and radio sources. */ import { suggestView } from '../views.js'; import { defineTool, ToolError } from '../catalog.js'; import { AREA_SCHEMA, areaCenter, areaContains, distanceKm, resolveArea, } from '../area.js'; import { LIMIT_SCHEMA, capRows, countNoun, toBase64 } from '../results.js'; import { roundHeadingDegrees } from '../../data/headingDegrees.js'; const FRAME_TYPES = new Set(['image/jpeg', 'image/png', 'image/webp']); const MAX_FRAME_BYTES = 3 * 1024 * 1024; const round = (value, digits) => Number.isFinite(value) ? Number(value.toFixed(digits)) : null; const text = (value) => (typeof value === 'string' && value ? value : null); async function readCatalog(services, signal) { const payload = await services.cctv.getCatalog({ signal }); return { cameras: payload.sources.filter( (camera) => camera?.id && Number.isFinite(camera.lat) && Number.isFinite(camera.lon), ), // Regional packs the catalog serves only part of, nearest their centers. trimmed: Array.isArray(payload.trimmedPacks) ? payload.trimmedPacks : [], }; } /** Whether an area's box overlaps a plain region box. */ function boxesOverlap(area, region) { if (area.south > region.north || area.north < region.south) return false; const spans = area.west <= area.east ? [[area.west, area.east]] : [ [area.west, 180], [-180, area.east], ]; return spans.some( ([west, east]) => west <= region.east && east >= region.west, ); } async function readCameras(services, signal) { return (await readCatalog(services, signal)).cameras; } export const findCctvCameras = defineTool({ name: 'find_cctv_cameras', title: 'Public cameras in an area', description: 'Public traffic and city cameras in an area, nearest the center first. ' + 'Use get_cctv_snapshot with a camera id to see its current view.', inputSchema: { type: 'object', properties: { area: AREA_SCHEMA, limit: LIMIT_SCHEMA }, required: ['area'], additionalProperties: false, }, requires: ['cctv'], async run(args, { services, signal }) { const area = await resolveArea(args.area, { services, signal }); const center = areaCenter(area); const catalog = await readCatalog(services, signal); const found = catalog.cameras.filter((camera) => areaContains(area, camera), ); // A trimmed pack matters wherever its cameras are, served or not, so // its region decides, not the cameras returned. const packs = new Set(found.map((camera) => camera.pack).filter(Boolean)); const trimmed = catalog.trimmed.filter((entry) => entry.region ? boxesOverlap(area, entry.region) : packs.has(entry.pack), ); const rows = found .map((camera) => ({ id: camera.id, name: text(camera.name), city: text(camera.city), provider: text(camera.provider), lat: round(camera.lat, 6), lon: round(camera.lon, 6), heading_deg: roundHeadingDegrees(camera.headingDeg), feed_type: text(camera.feedType), credit: text(camera.credit), distance_km: round(distanceKm(center, camera), 2), })) .sort((a, b) => a.distance_km - b.distance_km); return { summary: (rows.length || trimmed.length ? `${countNoun(rows.length, 'public camera')} in ${area.label}` : // The catalog covers selected regions; an empty answer elsewhere // means it has no cameras there, not that none exist. `The camera catalog has no cameras in ${area.label}`) + (trimmed.length ? ` (the catalog serves only some cameras here: ${trimmed .map( (entry) => `${entry.served} of ${entry.available} from ${entry.pack}`, ) .join(', ')}).` : '.'), data: { view: suggestView(services, { area, layers: ['cctv'] }), ...capRows(rows, args.limit), complete: trimmed.length === 0, catalog_trimmed: trimmed, }, }; }, }); export const getCctvSnapshot = defineTool({ name: 'get_cctv_snapshot', title: 'Camera snapshot', description: 'An image from one public camera, by the id from find_cctv_cameras. ' + 'Street View fallback imagery is historical, not the current camera view; ' + 'unknown frame provenance is explicit.', inputSchema: { type: 'object', properties: { camera_id: { type: 'string', minLength: 1, maxLength: 200 } }, required: ['camera_id'], additionalProperties: false, }, requires: ['cctv'], async run(args, { services, signal }) { const camera = (await readCameras(services, signal)).find( (candidate) => candidate.id === args.camera_id, ); if (!camera) throw new ToolError( 'invalid_arguments', `No camera has id ${args.camera_id}; use find_cctv_cameras first`, ); const frame = await services.cctv.getFrame(camera, { signal }); if (frame.sourceKind === 'synthetic' || !FRAME_TYPES.has(frame.contentType)) throw new ToolError( 'unavailable', `Camera ${camera.name || camera.id} has no still image right now`, ); if (frame.bytes.byteLength > MAX_FRAME_BYTES) throw new ToolError( 'unavailable', 'The camera image is too large to return', ); const name = text(camera.name) || camera.id; const fallback = frame.sourceKind === 'streetview'; const current = ['upstream-image', 'hls-pull'].includes(frame.sourceKind); const credit = fallback ? 'Google Street View' : text(camera.credit); const label = fallback ? 'Street View fallback for' : current ? 'Current view from' : 'Image from'; return { summary: `${label} ${name}${camera.city ? ` in ${camera.city}` : ''}${credit ? `, courtesy of ${credit}` : ''}.` + (fallback ? ' Historical imagery; the current camera frame is unavailable.' : current ? '' : ' Frame provenance is unknown.'), data: { view: suggestView(services, { point: { lat: camera.lat, lon: camera.lon }, altitudeM: 1_500, layers: ['cctv'], }), id: camera.id, name, city: text(camera.city), provider: fallback ? 'Google Street View' : text(camera.provider), credit, source_kind: frame.sourceKind ?? null, current_view: current ? true : fallback ? false : null, mime_type: frame.contentType, bytes: frame.bytes.byteLength, }, images: [{ mimeType: frame.contentType, data: toBase64(frame.bytes) }], }; }, }); export const findRadioStations = defineTool({ name: 'find_radio_stations', title: 'Radio stations', description: 'Internet radio stations from a directory of popular Radio Browser ' + 'stations, not every station, by area and/or ' + 'a search term matched against name, tags, language and country. Each ' + "result includes the broadcaster's public stream URL.", inputSchema: { type: 'object', properties: { area: AREA_SCHEMA, query: { type: 'string', minLength: 1, maxLength: 80, description: 'Words such as "jazz", "news" or "Tokyo".', }, limit: LIMIT_SCHEMA, }, additionalProperties: false, }, requires: ['radio'], async run(args, { services, signal }) { if (!args.area && !args.query) throw new ToolError('invalid_arguments', 'Give an area, a query or both'); const area = args.area ? await resolveArea(args.area, { services, signal }) : null; const terms = String(args.query || '') .toLowerCase() .split(/\s+/) .filter(Boolean); const directory = await services.radio.getDirectory({ signal }); if (!Array.isArray(directory?.stations)) throw new ToolError( 'malformed', 'The radio directory returned no stations', ); const center = area ? areaCenter(area) : null; const rows = directory.stations .filter((station) => !area || areaContains(area, station)) .filter((station) => { if (!terms.length) return true; const haystack = [ station.name, ...(station.tags || []), ...(station.languages || []), station.country, station.state, ] .join(' ') .toLowerCase(); return terms.every((term) => haystack.includes(term)); }) .map((station) => ({ id: station.id, name: text(station.name), country: text(station.country), state: text(station.state), tags: station.tags || [], languages: station.languages || [], codec: text(station.codec), bitrate_kbps: Number.isFinite(station.bitrate) ? station.bitrate : null, stream_url: text(station.streamUrl), homepage: text(station.homepage), lat: round(station.lat, 4), lon: round(station.lon, 4), ...(center ? { distance_km: round(distanceKm(center, station), 1) } : {}), })); if (center) rows.sort((a, b) => a.distance_km - b.distance_km); const where = area ? ` in ${area.label}` : ''; const what = args.query ? ` matching "${args.query}"` : ''; // The directory is a selection of popular stations, not every station. const notes = [ `from a directory of ${directory.stations.length} popular stations`, ...(directory.stale ? ['the directory may be stale'] : []), ...(directory.degraded ? ['the directory is incomplete right now'] : []), ]; return { summary: `${countNoun(rows.length, 'radio station')}${what}${where} (${notes.join('; ')}).`, data: { view: area ? suggestView(services, { area, layers: ['radio'] }) : null, ...capRows(rows, args.limit), directory_size: directory.stations.length, stale: directory.stale === true, degraded: directory.degraded === true, }, }; }, });