feat(voice): add typed AI chat beside voice

Chat sits next to the mic in the command dock. Replies are silent and never
request the microphone; the first message connects with the selected provider
and runs the same map actions as voice through each provider's text API
(OpenAI OPENAI_CHAT_MODEL, Gemini GEMINI_CHAT_MODEL via generateContent, which
never starts Live). Only one mode runs at a time.

- Chat panel rendered by the voice control presenter: conversation, recent and
  quick-command suggestions, Up/Down history, attachments (map-layer
  references or small UTF-8 text files, sent only with the message)
- Chat and voice panels sit above the dock or dock into the right rail's
  column; minimized bars sit centred above the dock, and height animates on
  swaps
- A centred panel steps down to its bar for the Location and Visual Presets
  trays without moving focus, rests above an open tray, and docks right while
  expanded over one; it returns to the centre once the trays close
- Minimized voice previews the last sentence from each side; the empty Voice
  Preview suggests things to say
- Settings opened from chat keep chat's frame and show the shared AI provider
  and quick commands; voice Settings show Back to voice
- Closing chat ends a typed session; the voice panel's close turns voice off
- The dock widens its voice control for the chat button and restyles its
  wings, which show icons only at 900px and below; assistant panels share the
  left panels' glass, and Cyber keeps its own surfaces
- Server text-chat handlers with body, time and per-IP limits
  (GEV_RATELIMIT_*_CHAT_PER_MIN), documented in SECURITY.md; tests and all
  eleven locales

Co-authored-by: Darren Dignam <[email protected]>
This commit is contained in:
manjunath22466andDarren Dignam committed 2026-11-02 20:56:39 +05:30
1 parent 720260af58
commit af461febae
57 files changed
+6500 -63

No files matched your search

+351 -5
View File
@@ -195,7 +195,7 @@ test('actual control default remains opt-out; panel markup has unique controlled
);
});
test('actual binder/card has launcher toggle, idempotent tabs, focus and disabled Preview', async (t) => {
test('actual binder/card has launcher toggle, Settings tab toggle, focus and disabled Preview', async (t) => {
const { ui, commands, settle } = mounted(t, { view: true });
await settle();
$('#gev-voice-settings-button').click();
@@ -206,8 +206,9 @@ test('actual binder/card has launcher toggle, idempotent tabs, focus and disable
$('#gev-voice-settings-tab').click();
key($('#gev-voice-settings-tab'), 'End');
assert.equal(commands.voicePanel.snapshot().settingsOpen, true);
// Preview has no visible tab, so the Settings tab toggles back to it.
$('#gev-voice-settings-tab').click();
assert.equal(commands.voicePanel.snapshot().settingsOpen, true);
assert.equal(commands.voicePanel.snapshot().view, 'preview');
commands.voicePanel.select('preview');
commands.voiceCard.handle({
type: 'transcript',
@@ -241,7 +242,7 @@ test('actual binder/card has launcher toggle, idempotent tabs, focus and disable
$('#gev-voice-preview-tab').focus();
key(globalThis.document.activeElement, 'Escape');
await settle();
assert.equal(active(), 'gev-voice-settings-button');
assert.equal(active(), 'gev-chat-button');
commands.voiceCard.handle({
type: 'transcript',
role: 'assistant',
@@ -721,13 +722,13 @@ test('Preview off and actual Cockpit state suppress automatic presentation witho
window.dispatchEvent(new Event('gev:cockpit-mode-changed'));
assert.equal(f.ui.state.voicePanel.hidden, true);
await f.settle();
assert.equal(active(), 'gev-voice-settings-button');
assert.equal(active(), 'gev-chat-button');
f.commands.voicePanel.select('settings', { focus: true });
await f.settle();
assert.equal(active(), 'gev-voice-settings-tab');
f.commands.voicePanel.select('preview', { focus: true });
await f.settle();
assert.equal(active(), 'gev-voice-settings-button');
assert.equal(active(), 'gev-chat-button');
const outside = document.createElement('button');
outside.id = 'unrelated';
document.body.appendChild(outside);
@@ -826,3 +827,348 @@ test('Provider Settings uses its ready dialog handlers and refuses unavailable o
'provider setup never opens a visual or scene panel',
);
});
// Typed chat, rendered by the real VoiceControl.
const typedChat = (f) => {
f.instances[0].getStartOptions = () => ({ textOnly: true });
f.instances[0].sendText = () => true;
};
const type = (text) => {
const input = $('#gev-chat-input');
input.value = text;
input.dispatchEvent(new Event('input', { bubbles: true }));
};
test('the chat button opens, minimizes and closes chat', async (t) => {
const f = mounted(t, { view: true });
await f.settle();
$('#gev-chat-button').click();
await f.settle();
assert.equal($('#gev-chat-panel').hidden, false);
assert.equal($('#gev-voice-control').dataset.assistantMode, 'chat');
assert.equal(active(), 'gev-chat-input');
$('#gev-chat-button').click();
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, 'true');
$('#gev-chat-restore').click();
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, undefined);
$('#gev-chat-close').click();
await f.settle();
assert.equal($('#gev-chat-panel').hidden, true);
assert.equal($('#gev-voice-control').dataset.assistantMode, 'idle');
});
test('a typed message sends, shows the reply and is recalled with Up', async (t) => {
const f = mounted(t, { view: true });
typedChat(f);
const reduce = globalThis.matchMedia;
globalThis.matchMedia = () => ({ matches: true });
t.after(() => (globalThis.matchMedia = reduce));
await f.settle();
$('#gev-chat-button').click();
await f.settle();
type('Fly to Tokyo');
$('#gev-chat-form').dispatchEvent(new Event('submit', { cancelable: true }));
await f.commands.session.start({ textOnly: true });
for (let i = 0; i < 5; i++) await f.settle();
const messages = () =>
[...globalThis.document.querySelectorAll('.gev-chat-message')].map(
(row) => `${row.dataset.role}:${row.querySelector('span').textContent}`,
);
assert.deepEqual(messages(), ['user:Fly to Tokyo']);
assert.equal($('#gev-chat-input').value, '');
f.instances[0].hooks.emit({
type: 'transcript',
role: 'assistant',
text: 'Flying to Tokyo.',
final: true,
});
await f.settle();
assert.deepEqual(messages(), [
'user:Fly to Tokyo',
'assistant:Flying to Tokyo.',
]);
assert.equal(f.ui.state.voicePanel.hidden, true);
key($('#gev-chat-input'), 'ArrowUp');
await f.settle();
assert.equal($('#gev-chat-input').value, 'Fly to Tokyo');
});
test('chat Settings keep chat context until the panel closes', async (t) => {
const f = mounted(t, { view: true });
await f.settle();
$('#gev-chat-button').click();
await f.settle();
$('#gev-voice-settings-button').click();
await f.settle();
assert.equal(f.ui.state.voicePanel.context, 'chat');
assert.equal($('#gev-chat-panel').hidden, true);
assert.equal($('#gev-voice-control').dataset.assistantMode, 'chat');
assert.equal(active(), 'gev-chat-back');
key($('#gev-chat-back'), 'Escape');
await f.settle();
assert.equal(f.ui.state.voicePanel.context, null);
assert.equal($('#gev-chat-panel').hidden, false);
$('#gev-voice-settings-button').click();
await f.settle();
$('#gev-chat-back').click();
await f.settle();
assert.equal($('#gev-chat-panel').hidden, false);
assert.equal(f.ui.state.chat.backVisible, false);
});
test('chat Settings keep only the quick commands preference', async (t) => {
const f = mounted(t, { view: true });
await f.settle();
for (const id of [
'typewriter',
'text-color',
'text-size',
'autocomplete',
'recent',
])
assert.equal(exists(`#gev-chat-${id}`), false);
assert.equal(exists('#gev-panel-default-position'), false);
assert.equal(exists('#gev-chat-quick'), true);
});
test('voice Settings step back to Preview with Back and Escape', async (t) => {
const f = mounted(t, { view: true });
await f.settle();
f.commands.voicePanel.select('settings', { focus: true });
await f.settle();
assert.equal(active(), 'gev-voice-settings-tab');
$('#gev-voice-back').click();
await f.settle();
assert.equal(f.commands.voicePanel.snapshot().view, 'preview');
f.commands.voicePanel.select('settings');
key($('#gev-voice-panel'), 'Escape');
await f.settle();
assert.equal(f.commands.voicePanel.snapshot().view, 'preview');
assert.equal(f.commands.voicePanel.snapshot().panelOpen, true);
key($('#gev-voice-panel'), 'Escape');
assert.equal(f.commands.voicePanel.snapshot().panelOpen, false);
});
test('Escape does not minimize chat', async (t) => {
const f = mounted(t, { view: true });
await f.settle();
$('#gev-chat-button').click();
await f.settle();
key($('#gev-chat-input'), 'Escape');
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, undefined);
assert.equal($('#gev-chat-panel').hidden, false);
});
function dockWing(t) {
const doc = globalThis.document;
const wing = doc.createElement('div');
wing.id = 'control-panel';
wing.className = 'panel-collapsible collapsed';
const toggle = doc.createElement('button');
toggle.className = 'dock-tray-toggle';
const tray = doc.createElement('div');
tray.className = 'dock-popover-content';
wing.append(toggle, tray);
doc.body.append(wing);
t.after(() => wing.remove());
return {
wing,
toggle,
open: () => wing.classList.remove('collapsed'),
close: () => wing.classList.add('collapsed'),
};
}
test('reaching for a dock wing minimizes a centred chat or voice panel', async (t) => {
const f = mounted(t, { view: true });
await f.settle();
// The dock can mount after the layouts bind; they find it on use.
const wing = dockWing(t);
$('#gev-chat-button').click();
await f.settle();
wing.toggle.dispatchEvent(new PointerEvent('pointerover', { bubbles: true }));
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, 'true');
// Leaving the wing with no tray open ends the yield.
wing.wing.dispatchEvent(new PointerEvent('pointerleave'));
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, undefined);
$('#gev-chat-button').click();
await f.settle();
$('#gev-chat-button').click();
await f.settle();
f.commands.voicePanel.select('preview');
await f.settle();
assert.equal($('#gev-voice-panel').dataset.minimized, undefined);
wing.toggle.dispatchEvent(new PointerEvent('pointerdown', { bubbles: true }));
await f.settle();
assert.equal($('#gev-voice-panel').dataset.minimized, 'true');
});
test('expanding a panel over an open tray docks it right without saving', async (t) => {
const f = mounted(t, { view: true });
// The view mount resets the body; the layouts bind on the next tick.
const wing = dockWing(t);
await f.settle();
$('#gev-chat-button').click();
await f.settle();
wing.toggle.dispatchEvent(new PointerEvent('pointerover', { bubbles: true }));
wing.open();
await f.settle();
assert.equal($('#gev-chat-panel').dataset.placement, 'compact');
$('#gev-chat-restore').click();
await f.settle();
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, undefined);
assert.equal($('#gev-chat-panel').dataset.placement, 'docked');
assert.notEqual(globalThis.localStorage.getItem('gev.panel.docked'), 'true');
// The dock was only for the tray; it ends once the tray closes.
wing.close();
await f.settle();
await f.settle();
assert.equal(f.ui.state.layout.docked, false);
assert.equal($('#gev-chat-panel').dataset.placement, 'compact');
assert.equal($('#gev-chat-panel').dataset.minimized, undefined);
});
test('yielding to a dock tray leaves keyboard focus where it is', async (t) => {
const f = mounted(t, { view: true });
const wing = dockWing(t);
const field = globalThis.document.createElement('input');
globalThis.document.body.append(field);
t.after(() => field.remove());
await f.settle();
$('#gev-chat-button').click();
await f.settle();
for (const target of [$('#gev-chat-input'), field]) {
target.focus();
wing.toggle.dispatchEvent(
new PointerEvent('pointerover', { bubbles: true }),
);
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, 'true');
assert.equal(globalThis.document.activeElement, target);
wing.wing.dispatchEvent(new PointerEvent('pointerleave'));
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, undefined);
assert.equal(globalThis.document.activeElement, target);
}
});
test('a panel that yielded to a tray expands in the centre once it closes', async (t) => {
const f = mounted(t, { view: true });
const wing = dockWing(t);
await f.settle();
$('#gev-chat-button').click();
await f.settle();
wing.toggle.dispatchEvent(new PointerEvent('pointerdown', { bubbles: true }));
wing.open();
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, 'true');
wing.close();
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, undefined);
assert.equal($('#gev-chat-panel').dataset.placement, 'compact');
assert.equal(f.ui.state.layout.yielded, null);
});
test('switching to voice while chat yields to a tray starts voice as its bar', async (t) => {
const f = mounted(t, { view: true });
const wing = dockWing(t);
await f.settle();
$('#gev-chat-button').click();
await f.settle();
wing.toggle.dispatchEvent(new PointerEvent('pointerover', { bubbles: true }));
await f.settle();
$('#gev-chat-button').click();
await f.settle();
f.commands.voicePanel.select('preview');
await f.settle();
assert.equal($('#gev-voice-panel').dataset.minimized, 'true');
assert.equal(f.ui.state.layout.yielded, 'voicePanel');
});
test('undocking while a tray is open brings the panel back as its bar', async (t) => {
const f = mounted(t, { view: true });
const wing = dockWing(t);
await f.settle();
$('#gev-chat-button').click();
await f.settle();
$('#gev-chat-panel [data-layout-dock]').click();
await f.settle();
assert.equal($('#gev-chat-panel').dataset.placement, 'docked');
wing.open();
await f.settle();
$('#gev-chat-panel [data-layout-dock]').click();
await f.settle();
await f.settle();
assert.equal($('#gev-chat-panel').dataset.minimized, 'true');
assert.equal($('#gev-chat-panel').dataset.placement, 'compact');
});
test('the voice panel close turns voice off', async (t) => {
const f = mounted(t, { view: true });
await f.commands.session.start();
f.commands.voicePanel.select('preview');
await f.settle();
$('#gev-voice-settings-close').click();
assert.equal(f.commands.session.isActive(), false);
assert.equal(f.commands.voicePanel.snapshot().panelOpen, false);
});
test('closing chat Settings ends a typed session', async (t) => {
const f = mounted(t, { view: true });
typedChat(f);
await f.settle();
$('#gev-chat-button').click();
await f.commands.session.start({ textOnly: true });
await f.settle();
$('#gev-voice-settings-button').click();
await f.settle();
$('#gev-voice-settings-close').click();
await f.settle();
assert.equal(f.commands.session.isActive(), false);
assert.equal($('#gev-chat-panel').hidden, true);
});
test('the mic button closes chat and minimize collapses voice to a bar', async (t) => {
const f = mounted(t, { view: true });
await f.settle();
$('#gev-chat-button').click();
await f.settle();
$('#gev-voice-button').click();
await f.settle();
assert.equal($('#gev-chat-panel').hidden, true);
assert.equal(f.commands.session.isActive(), true);
f.commands.voicePanel.select('preview');
await f.settle();
$('#gev-voice-panel [data-layout-minimize]').click();
await f.settle();
assert.equal($('#gev-voice-panel').dataset.minimized, 'true');
f.commands.voicePanel.select('preview');
await f.settle();
assert.equal($('#gev-voice-panel').dataset.minimized, undefined);
});
test('teardown inside sendText prevents appending the submitted message', async (t) => {
const f = mounted(t, { view: true });
f.instances[0].getStartOptions = () => ({ textOnly: true });
f.instances[0].sendText = () => {
f.commands.session.destroy();
return true;
};
await f.settle();
$('#gev-chat-button').click();
await f.settle();
type('Hello');
$('#gev-chat-form').dispatchEvent(new Event('submit', { cancelable: true }));
await f.commands.session.start({ textOnly: true });
for (let i = 0; i < 5; i++) await Promise.resolve();
assert.equal(
globalThis.document.querySelectorAll('.gev-chat-message').length,
0,
);
});
+22 -5
View File
@@ -64,7 +64,7 @@ export function createManualVoicePanel({
hidden: ui.state.card.visible,
text: () => (previewOn ? copy.previewEmpty : copy.previewDisabled),
});
if (restoreFocus) void ui.focus(['settingsButton', 'button']);
if (restoreFocus) void ui.focus(['settingsButton', 'chatButton', 'button']);
};
const refuse = (reason) => ({
ok: false,
@@ -79,11 +79,18 @@ export function createManualVoicePanel({
const transferFocus = changed && holdsFocus(panes[view]);
open = true;
view = next;
// An explicit request restores a minimized panel; automatic reveals do not.
if (!automatic && ui.state.voicePanel.minimized)
ui.update('voicePanel', { minimized: false });
onPresentationIntent?.({ automatic });
sync();
// The tab takes focus once it shows, inside a shown panel.
// The view's tab takes focus once it shows, inside a shown panel, or the
// next visible control when the tab is hidden: voice Settings show Back
// instead, and Preview falls to Settings.
if (focus || transferFocus)
void ui.focus([tabs[next === 'preview' ? 0 : 1]]);
void ui.focus(
next === 'preview' ? [tabs[0], tabs[1]] : [tabs[1], 'voiceBack'],
);
return { ok: true, changed, ...snapshot() };
};
const close = (onlyView) => {
@@ -94,6 +101,9 @@ export function createManualVoicePanel({
return { ok: true, changed: false, ...snapshot() };
const changed = open;
open = false;
// A caller's context (Settings opened from chat) ends with the panel.
if (ui.state.voicePanel.minimized || ui.state.voicePanel.context)
ui.update('voicePanel', { minimized: false, context: null });
onPresentationIntent?.();
sync();
return { ok: true, changed, ...snapshot() };
@@ -110,9 +120,13 @@ export function createManualVoicePanel({
};
offs.push(
ui.on('settings-button', toggleSettings),
// Preview has no visible tab; the Settings tab toggles back to it.
ui.on('tab', (index) =>
select(index === 0 ? 'preview' : 'settings', { focus: true }),
index === 1 && open && view === 'settings'
? select('preview', { focus: true })
: select(index === 0 ? 'preview' : 'settings', { focus: true }),
),
ui.on('voice-back', () => select('preview', { focus: true })),
ui.on('tab-keydown', (index, event) => {
const next =
event.key === 'Home'
@@ -130,7 +144,10 @@ export function createManualVoicePanel({
ui.on('panel-keydown', (event) => {
if (event.key !== 'Escape' || !open) return;
event.preventDefault();
close();
// Voice Settings step back to the preview, like chat Settings to chat.
if (view === 'settings' && !ui.state.voicePanel.context)
select('preview', { focus: true });
else close();
}),
ui.on('pointerleave', (event) => {
if (event.pointerType === 'touch') return;
+6 -3
View File
@@ -65,7 +65,7 @@ function key(element, value) {
return event;
}
test('Settings launcher toggles while tab and programmatic selection remain idempotent', async (t) => {
test('Settings launcher and tab toggle while programmatic selection stays idempotent', async (t) => {
const f = fixture(t);
await f.settle();
assert.equal(f.panel.snapshot().panelOpen, false);
@@ -84,8 +84,10 @@ test('Settings launcher toggles while tab and programmatic selection remain idem
assert.equal(f.panel.snapshot().settingsOpen, true);
assert.equal(f.panel.select('settings').changed, false);
assert.equal(f.panel.snapshot().settingsOpen, true);
// Preview has no visible tab, so the Settings tab toggles back to it.
click(f.$('gev-voice-settings-tab'));
assert.equal(f.panel.snapshot().settingsOpen, true);
assert.equal(f.panel.snapshot().view, 'preview');
assert.equal(f.panel.snapshot().panelOpen, true);
assert.equal(f.panel.select('unknown').reason, 'unknown-view');
});
@@ -115,7 +117,8 @@ test('tab keyboard navigation and Escape preserve focus and accessibility state'
assert.equal(key(f.$('gev-voice-panel'), 'Escape').defaultPrevented, true);
await f.settle();
assert.equal(f.panel.snapshot().panelOpen, false);
assert.equal(f.active(), 'gev-voice-settings-button');
// The Settings gear lives in the chat header, so focus returns to Chat.
assert.equal(f.active(), 'gev-chat-button');
assert.equal(key(f.$('gev-voice-panel'), 'Escape').defaultPrevented, false);
});