Files
gods-eye-view/src/voice/referents.js
T
manjunath22466 095981eee7 fix(voice): preserve analyst result and tracking contracts
keep contacts counts, rows, scope and provenance on one retained snapshot

report capped cohorts as lower bounds

separate sibling tool cancellation from newer user turns

align track_entity validation across runtime and benchmark paths
2026-10-02 11:15:31 +05:30

100 lines
3.6 KiB
JavaScript

/**
* Referents: the numbered things the latest voice result listed, so "the
* second one" or "that one" can resolve without the model copying ids.
*
* The registry mirrors what the voice card shows: a result replaces the list
* when the card displays it with numbered rows (see resultDisplay.js, which
* both the card and this registry read — analyst items included, in the
* order the model reads them in the tool output).
*
* Session-scoped: the voice commands clear it when a session ends.
*/
import { presentResult } from './resultDisplay.js';
/** The numbered rows visible in the voice card and therefore resolvable later. */
export const MAX_DISPLAYED_REFERENTS = 5;
function finite(value) {
if (value === null || value === undefined || value === '') return null;
const number = Number(value);
return Number.isFinite(number) ? number : null;
}
function normalize(entry, index) {
if (!entry || typeof entry !== 'object') return null;
// Identity is the canonical key (transponder hex, MMSI, NORAD id); a
// display `id` such as a callsign is only a label, and two contacts can
// share one.
const id = entry.icao24 ?? entry.mmsi ?? entry.noradId ?? entry.id ?? null;
const label = String(
entry.label ?? entry.callsign ?? entry.name ?? entry.id ?? id ?? '',
).trim();
if (!label && id === null) return null;
return {
n: index + 1,
id: id === null ? null : String(id),
label: label || String(id),
layerId: entry.layerId ?? entry.layerKey ?? null,
lat: finite(entry.lat ?? entry.latitude),
lon: finite(entry.lon ?? entry.longitude),
};
}
/** Referents a tool result offers, in card order; [] when it offers none. */
export function referentsFromResult(name, result) {
if (!result || typeof result !== 'object' || result.ok === false) return [];
return presentResult(name, result)?.referents || [];
}
/** Numbered referent records ({n, id, label, layerId, lat, lon}). */
export function normalizeReferents(entries, max = MAX_DISPLAYED_REFERENTS) {
return (Array.isArray(entries) ? entries : [])
.slice(0, max)
.map(normalize)
.filter(Boolean)
.map((entry, index) => ({ ...entry, n: index + 1 }));
}
export function createReferentRegistry({ max = MAX_DISPLAYED_REFERENTS } = {}) {
let list = [];
let generation = 0;
return {
/** Bumped by every clear; read before an action, checked after it. */
generation() {
return generation;
},
/**
* Replace the list with a result's referents; empty results keep it
* unless they are a result set of their own. A
* result whose action started before the last clear (a new session or a
* cancelled turn) is refused.
*/
recordResult(name, result, { since = generation } = {}) {
if (since !== generation) return false;
if (!result || typeof result !== 'object' || result.ok === false)
return false;
const shown = presentResult(name, result);
const entries = shown?.referents || [];
// A new result set (a count) replaces the list even
// when it is empty: "the second one" never reaches an older answer.
if (!entries.length && !shown?.resultSet) return false;
list = normalizeReferents(entries, max);
return list.length > 0;
},
/** 1-based lookup; negative counts from the end ("the last one" = -1). */
get(n) {
const index = Number(n);
if (!Number.isInteger(index) || index === 0) return null;
return (index > 0 ? list[index - 1] : list[list.length + index]) || null;
},
list() {
return list.slice();
},
clear() {
list = [];
generation++;
},
};
}