Interactive Star Lab

Ask an agent to

• Rank the best stargazing nights next week at my selected site
• List stars brighter than magnitude 3 visible tonight
• Create an observation plan for Vega, Altair and Deneb

29 tools

• capture_sky_snapshotuntrusted content

  Captures the currently rendered Sky canvas as a PNG, stores it in the app's snapshot storage, and returns its metadata. An optional missionId links the image to an existing Mission. The tool does not return a large…

  missionId: string?, download: boolean?

• commit_proposaluntrusted content

  Materializes the pending proposal's accepted items into a real Mission via the normal creation path (immutable from then on). Pass acceptedStarIds to commit a subset, or omit to commit the items currently marked…

  acceptedStarIds: array?

• compare_dark_sky_sitesread-onlyuntrusted content

  Fetches Open-Meteo cloud cover and visibility for the current site plus reference dark-sky sites (or a caller-provided list of 2-8 sites), scores each for stargazing, and reports the clearest one. Sites that fail are…

  sites: array?

• compare_prediction_and_observationread-onlyuntrusted content

  Compares the fixed Mission prediction with human observation results. Unsure observations are excluded from the match-rate denominator.

  missionId: string

• configure_sky_viewuntrusted content

  Configures a location and local wall-clock time, then opens Sky in one operation. Use either a built-in preset id (for example new-york) or a custom site with latitude, longitude, and timeZone. localDateTime has no…

  preset: string?, site: object?, localDateTime: string, azimuth: number?, altitude: number?, fieldOfView: number?

• create_observation_planuntrusted content

  Creates an observation Mission for up to five selected star IDs using the current observation site, then opens Plan for human review before Sky or Observe. To archive the actual rendered Sky canvas, open Sky with the…

  dateTime: string, maxMagnitude: integer, starIds: array

• describe_current_viewread-onlyuntrusted content

  Describes what the human is currently looking at: site, date/time, camera direction and field of view, sky projection mode, display layers, scene counts and objects in frame, the current selection, and a log of the…

• generate_observation_guideuntrusted content

  Prepares a print-ready Observation Guide using the Mission creation-time site, date, and fixed star predictions. It includes a deterministic Mission Sky Snapshot as inline SVG and generates a PDF directly in the…

  missionId: string, title: string?, durationMinutes: integer?, timeZone: string?

• get_current_sky_stateread-onlyuntrusted content

  Returns the current sky viewer conditions and a structured list of stars in the current view.

• get_night_ephemerisread-onlyuntrusted content

  Returns the darkness ephemeris for one observing night at the selected site: sunset/sunrise, the three twilight boundaries, the astronomical darkness window, Moon illumination and moon-free intervals. A night runs…

  nightOf: string?

• get_observation_missionread-onlyuntrusted content

  Returns one Mission by ID, including its creation-time site, date, fixed target predictions, and cloud Snapshot status.

  missionId: string

• get_observation_resultsread-onlyuntrusted content

  Returns a completed observation record with star names, prediction snapshots, and human observation statuses. Without a missionId, returns the selected record or the newest completed record.

  missionId: string?

• get_observation_siteread-onlyuntrusted content

  Returns the observation site currently selected in InteractiveStarLab, including its latitude and longitude.

• get_sky_conditionsread-onlyuntrusted content

  Fetches live cloud cover (total and per layer) and visibility for the current observation site from Open-Meteo, plus a 0-100 stargazing score. Advisory only: weather is not part of the geometric visibility prediction…

• get_sky_snapshot_metadataread-onlyuntrusted content

  Returns one saved Sky snapshot's observation conditions and storage metadata without returning the PNG blob.

  snapshotId: string

• list_sky_snapshotsread-onlyuntrusted content

  Lists saved Sky snapshot metadata in newest-first order. PNG blobs are not included.

  limit: integer?

• open_observation_resultsuntrusted content

  Selects a saved observation result and opens the human-facing Results screen. Without a missionId, uses the selected record or newest completed record. This tool does not recompute or modify results.

  missionId: string?

• open_observe_viewuntrusted content

  Opens the human-facing Observe screen so the user can record observations for the active Mission.

• open_plan_viewuntrusted content

  Opens the human-facing Plan screen without creating or changing a Mission.

• open_sky_viewuntrusted content

  Opens the human-facing Sky screen without changing sky conditions. Use get_current_sky_state to read structured star positions; this tool does not return a screenshot.

• plan_staleread-onlyuntrusted content

  Reports whether the pending proposal's assumptions still hold: it compares the site and observation dateTime the proposal was computed against with the current ones. A stale proposal's per-star predictions may no…

• predict_visible_starsread-onlyuntrusted content

  Finds stars above the astronomical horizon for the selected observation site, date, and maximum magnitude. This geometric prediction does not include weather, horizon obstacles, or light-pollution APIs.

  dateTime: string?, maxMagnitude: integer, limit: integer?

• propose_planuntrusted content

  Stages a ghost plan proposal for human review without creating a Mission. The proposal lists one item per star; the human accepts or rejects items on the Plan screen, and commit_proposal materializes the accepted…

  dateTime: string, maxMagnitude: integer, starIds: array

• rank_nightsread-onlyuntrusted content

  Scores every observing night in a date range at the selected site and returns them best first. The score is 10 points per usable dark hour (astronomical darkness with the Moon down or faint), capped at 100. Use it to…

  from: string, to: string, limit: integer?

• restore_observation_missionuntrusted content

  Restores one observation Mission using its mission-specific recovery code. The code is a capability for that Mission, is never returned by this tool, and must not be exposed in conversation or logs. Opens the Observe…

  recoveryCode: string

• save_observation_resultsuntrusted content

  Saves only observation statuses explicitly reported by the user for every target in a Mission. It does not invent or infer observations, and it preserves the Mission creation-time prediction snapshot. Overwriting a…

  missionId: string?, results: array?, confirm: boolean?, undoToken: string?

• set_observation_siteuntrusted content

  Sets the observation site and synchronizes its latitude and longitude with the Sky viewer. Existing Missions keep their creation-time site snapshots.

  name: string?, latitude: number, longitude: number, timeZone: string?

• set_sky_display_settingsuntrusted content

  Changes Sky display layers, labels, and local simulation settings. firstMagnitude through faintMagnitude are display layers only; they are not Mission maxMagnitude and never change Mission targets or prediction…

  stars: boolean?, starNames: boolean?, constellationLines: boolean?, constellationNames: boolean?, milkyWay: boolean?, denseStars: boolean?, deepSky: boolean?, nightMode: boolean?, … (list cut; the site may define more)

• set_sky_view_settingsuntrusted content

  Changes Sky viewer date/time, direction, elevation, and field of view. Use set_observation_site for latitude and longitude. Existing Mission predictions are not recalculated.

  dateTime: string?, azimuth: number?, altitude: number?, fieldOfView: number?, skyMode: string?