Compare commits

...
Author SHA1 Message Date
jason.woltje ebfbdb13a0 fix(webui): settings-s5c recheck: the status load says whether it painted the answer, and the result after an off says the list above is read again only then; a status read that answers 200 with null, an empty object or a page that is not JSON now says the list may be out of date, with Read again, instead of claiming the list is new (recheck P3); tests red on c47f9a3bd (#1873, lane settings-s5c) 2026-11-20 02:10:52 -06:00
jason.woltje 4d378fc38b fix(webui): settings-s5c review: an open Turn off question goes when a status read no longer lists that program or cannot list programs, so the buttons are not left disabled (P3-1); a refusal code named like an object property (constructor) shows as its code with the plain refused words, in failText and in the shared explain(), never as page source (P3-2); after an off the result says the list above was read again only when that read worked; when it failed it says the list may be out of date and gives Read again, which reads it and moves focus to the result (P3-3); invalid-request on an off says the program is not in the Console's installed list or that list could not be read (P3-4); the programs box keeps its own spacing inside the settings form (P3-5); tests red without each change (#1873, lane settings-s5c) 2026-11-20 02:10:52 -06:00
jason.woltje ab8633ede8 feat(webui): settings-s5c: Model setup, Advanced, lists the installed programs from the status read and which organizations have each one on, by display name, an organization whose list is null reading Not known in it, never off; Turn off for every organization asks first, naming the program, then POSTs programs/off, words each organization's outcome (bus-down never says stopped, failed:outcome-unknown says it may have changed, an unknown failed code shows the code unless it is shaped like a key), gives busy and a failed request a plain line, reads the status again and moves focus to the result; Technical details reads access health per organization when it opens: Ready only for ok with every key active and no reason, attention, unreadable, a missing or unknown health never Ready, no key id, agent or other count shown, a failed read with Read again; none of it shows or is read for a viewer who is not the instance owner; the old per-instance program read on Advanced is gone (#1873, lane settings-s5c) 2026-11-20 02:10:52 -06:00
4 changed files with 746 additions and 23 deletions

No files matched your search

+218 -19
View File
@@ -627,8 +627,12 @@ if (document.documentElement.hasAttribute('data-settings-proxy-document') && !lo
+ '<ul id="proxy-ride-skips" class="proxy-ride-list"></ul><ul id="proxy-ride-fixtures" class="proxy-ride-list"></ul></div>';
const triage = '<p><a id="proxy-setup-triage" class="btn" href="#/settings/triage">Set up Triage</a></p>';
const advanced = '<details id="proxy-setup-advanced" data-admin hidden><summary>Advanced: programs, port, timeouts</summary><div class="inside">'
+ '<div class="settings-form"><p class="lbl">Programs that drive models</p><ul id="proxy-setup-programs" class="model-list"></ul>'
+ '<p class="help small muted">Each organization switches these on or off on its own Models page. Claude subscription models run only in Claude Code. Turning a program off for every organization is not built yet.</p></div>'
// settings-s5c: the installed programs and which organizations have each one on, from the status
// read; one program can be turned off in every organization that can do without it.
+ '<div class="settings-form proxy-programs"><h4 id="proxy-setup-programs-title" class="lbl">Programs that drive models</h4>'
+ '<p class="help small muted">Each organization turns these on or off on its own Models page. Claude subscription models run only in Claude Code. Turn off for every organization skips an organization that still uses the program or has no other program on.</p>'
+ '<ul id="proxy-setup-programs" class="proxy-programs-list" aria-labelledby="proxy-setup-programs-title"><li class="muted">Not read yet.</li></ul>'
+ '<div id="proxy-setup-programs-result" class="proxy-programs-result" tabindex="-1" hidden></div></div>'
+ '<form id="proxy-setup-init" class="settings-form"><fieldset data-setup-write disabled><legend>Service key</legend>'
+ '<p class="small muted">Mosaic makes the service key on this machine, keeps it where setup keeps keys and never shows it.</p></fieldset>'
+ '<fieldset data-setup-write disabled><legend>Settings (leave empty for the defaults)</legend>'
@@ -644,6 +648,11 @@ if (document.documentElement.hasAttribute('data-settings-proxy-document') && !lo
+ '<ol id="proxy-setup-history" aria-labelledby="proxy-setup-history-title"></ol>'
+ '<p class="proxy-setup-history-foot"><button type="button" id="proxy-setup-history-all" aria-expanded="false" aria-controls="proxy-setup-history" hidden>Show all</button>'
+ '<button type="button" id="proxy-setup-history-older" hidden>Show older</button><button type="button" id="proxy-setup-history-retry" hidden>Read again</button></p></div>'
// settings-s5c: access health per organization (GET /api/proxy/admin/access), read when this box opens.
+ '<div class="proxy-setup-access"><h4 id="proxy-setup-access-title">Access</h4><p class="small muted">Whether each organization\'s agents can reach your models. You never see a key.</p>'
+ '<p id="proxy-setup-access-message" class="small muted" role="status">Not read yet.</p>'
+ '<ul id="proxy-setup-access" class="rows proxy-access" aria-labelledby="proxy-setup-access-title"></ul>'
+ '<p class="proxy-setup-history-foot"><button type="button" id="proxy-setup-access-retry" hidden>Read again</button></p></div>'
+ '<details id="proxy-setup-tech-lines" class="proxy-setup-lines"><summary>The service\'s last lines</summary><div class="inside" data-log></div></details>'
+ '<div class="proxy-setup-unit"><h4>Service controls</h4><p class="small muted">Install renders the unit the same way as <code>mosaic proxy unit install</code>.</p>'
+ '<div class="proxy-setup-buttons"><button type="button" data-unit="install" data-setup-write disabled>Install</button><button type="button" data-unit="start" data-setup-write disabled>Start</button><button type="button" data-unit="restart" data-setup-write disabled>Restart</button><button type="button" data-unit="stop" data-setup-write disabled>Stop</button><button type="button" id="proxy-setup-render">Show unit file</button></div>'
@@ -953,7 +962,7 @@ if (document.documentElement.hasAttribute('data-settings-proxy-document') && !lo
'not-configured': 'Model service setup is not available on this Console.',
'outcome-unknown': 'The outcome is unknown. Check the status before retrying.',
};
const explain = code => `${REASONS[code] ?? 'The action was refused.'} (${code})`;
const explain = code => `${Object.hasOwn(REASONS, code) ? REASONS[code] : 'The action was refused.'} (${code})`;
async function admin(path, args) {
const response = await fetch('/api/proxy/admin/' + path, { cache: 'no-store', credentials: 'same-origin', redirect: 'manual',
method: args === undefined ? 'GET' : 'POST',
@@ -976,7 +985,7 @@ if (document.documentElement.hasAttribute('data-settings-proxy-document') && !lo
// A failed read says what the answer's code means here; a request that got no answer says so. A code
// shaped like a Mosaic key is not shown, even though it passes admin()'s letters-and-hyphens check.
const failText = (error, words) => !error?.code ? (error instanceof TypeError ? 'The Console did not answer.' : String(error?.message ?? 'The Console did not answer.'))
: /ms[kotp][-_]/i.test(error.code) ? 'The Console refused the read.' : words[error.code] ? `${words[error.code]} (${error.code})` : error.message;
: /ms[kotp][-_]/i.test(error.code) ? 'The Console refused the read.' : Object.hasOwn(words, error.code) ? `${words[error.code]} (${error.code})` : error.message;
const retryButton = (id, action) => { const button = el('button', 'Read again'); button.type = 'button'; if (id) button.id = id; button.addEventListener('click', action); return button; };
// The service's last lines: one read paints every box. The lines show as the answer has them:
// the route removes key-shaped text; this page adds nothing and takes nothing away.
@@ -1117,7 +1126,7 @@ if (document.documentElement.hasAttribute('data-settings-proxy-document') && !lo
// Show older shows what it reads: the list stays open from then on.
$('proxy-setup-history-older').addEventListener('click', () => { if (!hist.loading && hist.next !== null) { hist.expanded = true; readHistory(false); } });
$('proxy-setup-history-retry').addEventListener('click', () => readHistory(!hist.read));
$('proxy-setup-tech').addEventListener('toggle', () => { if (techOpen() && enabled) { readKey(); readHistory(true); } });
$('proxy-setup-tech').addEventListener('toggle', () => { if (techOpen() && enabled) { readKey(); readHistory(true); readAccess(); } });
$('proxy-setup-tech-lines').addEventListener('toggle', () => { if ($('proxy-setup-tech-lines').open && enabled) readLog(); });
function row(dl, term, text) { const dt = document.createElement('dt'), dd = document.createElement('dd'); dt.textContent = term; dd.textContent = text; dl.append(dt, dd); }
function paintState() {
@@ -1368,18 +1377,206 @@ if (document.documentElement.hasAttribute('data-settings-proxy-document') && !lo
if (s.rotateGraceMinutes !== undefined) row(dl, 'Old key kept after a new one', s.rotateGraceMinutes === null ? 'The default' : `${human(s.rotateGraceMinutes)} minutes`);
}
}
// Programs that drive models: the harnesses this Console offers an organization, read on open.
let programsRead = false;
$('proxy-setup-advanced').addEventListener('toggle', async () => {
if (!$('proxy-setup-advanced').open || programsRead) return; programsRead = true;
const list = $('proxy-setup-programs'); list.replaceChildren(el('li', 'Reading…', 'muted'));
// settings-s5c: Programs that drive models, from the status read's programs field (owner only: only
// the owner's page reads the status). A list the read could not give reads as not known, never as off.
// Program names come from the read; this page holds no list of them.
const KEYISH = /ms[kotp][-_]/i;
const programName = v => typeof v === 'string' && /^[a-z][a-z0-9-]{0,31}$/.test(v) && !KEYISH.test(v) ? v : null;
const orgLabel = id => shownName(orgName(id)) ?? shownName(id) ?? 'An organization Mosaic can\'t name';
let offAsk = null, offBusy = false, offView = null, offFocus = null;
function programsState() {
const p = state?.programs;
if (!p || typeof p !== 'object') return { error: 'The programs could not be read.' };
if (!Array.isArray(p.installed)) return { error: 'The installed programs could not be read.' };
const names = [...new Set(p.installed.map(programName).filter(Boolean))], hidden = p.installed.some(n => !programName(n));
const orgs = Array.isArray(p.organizations) ? p.organizations.filter(o => o && typeof o === 'object') : null;
return { names, hidden, orgs };
}
function programLine(name, orgs) {
if (!orgs) return 'Which organizations have it on could not be read.';
if (!orgs.length) return 'No organization to check.';
const on = [], off = [], unknown = [];
for (const o of orgs) {
const label = orgLabel(o.id);
if (!Array.isArray(o.on)) unknown.push(label); else if (o.on.includes(name)) on.push(label); else off.push(label);
}
const parts = [];
parts.push(on.length ? `On in ${listNames(on)}.` : 'On in no organization.');
if (off.length) parts.push(`Off in ${listNames(off)}.`);
if (unknown.length) parts.push(`Not known in ${listNames(unknown)}: ${unknown.length === 1 ? 'its list' : 'their lists'} could not be read.`);
return parts.join(' ');
}
function paintPrograms() {
const list = $('proxy-setup-programs'), had = document.activeElement;
// A repaint while a control here holds focus puts focus back on the same control.
const keep = had && list.contains(had) ? (had.id ? '#' + had.id : had.dataset.programOff ? `[data-program-off="${had.dataset.programOff}"]` : null) : null;
const view = programsState();
// A read that no longer lists the program being asked about drops the question.
if (offAsk !== null && (view.error || !view.names.includes(offAsk))) offAsk = null;
if (view.error) { list.replaceChildren(el('li', view.error, 'muted')); return; }
const items = view.names.map(name => {
const li = el('li'); li.dataset.program = name;
const head = el('div', '', 'proxy-program-head');
head.append(el('span', name, 'proxy-program-name'));
const off = el('button', 'Turn off for every organization'); off.type = 'button'; off.dataset.programOff = name;
off.setAttribute('aria-label', `Turn off ${name} for every organization`);
off.disabled = !sendOk || offBusy || offAsk !== null;
off.addEventListener('click', () => askOff(name));
head.append(off); li.append(head, el('p', programLine(name, view.orgs), 'small proxy-program-orgs'));
if (offAsk === name) {
const box = el('div', '', 'proxy-program-confirm'); box.setAttribute('role', 'group'); box.setAttribute('aria-labelledby', 'proxy-setup-programs-ask');
const ask = el('p', `Turn off ${name} in every organization? Mosaic skips an organization where something still uses ${name} or where it is the only program on. Turning it on again is done on each organization's Models page.`);
ask.id = 'proxy-setup-programs-ask';
const yes = el('button', `Turn off ${name}`, 'danger'); yes.type = 'button'; yes.id = 'proxy-setup-programs-yes'; yes.disabled = !sendOk || offBusy;
yes.addEventListener('click', () => programsOff(name));
const no = el('button', 'Cancel'); no.type = 'button'; no.id = 'proxy-setup-programs-no';
no.addEventListener('click', () => { offAsk = null; paintPrograms(); root.querySelector(`[data-program-off="${name}"]`)?.focus(); });
const foot = el('p', '', 'proxy-setup-history-foot'); foot.append(yes, no);
box.append(ask, foot); li.append(box);
}
return li;
});
if (!view.names.length) items.push(el('li', 'No programs are installed.', 'muted'));
if (view.hidden) items.push(el('li', 'One or more programs have a name this page does not show.', 'muted'));
list.replaceChildren(...items);
if (keep) root.querySelector(keep)?.focus();
}
function askOff(name) {
if (!sendOk || offBusy) return;
offAsk = name; paintPrograms(); $('proxy-setup-programs-yes')?.focus();
}
// What each organization's outcome means, in plain words (settings-backend-a2 build report).
function offOutcome(outcome) {
const words = {
off: 'Turned off.',
'already-off': 'It was already off. Nothing changed.',
'in-use': 'Kept on. Something there still uses it: a role route, a fallback or an agent.',
'last-program': 'Kept on. It is the only program on there.',
'bus-down': 'Not changed. Its programs could not be read.',
unreadable: 'Not changed. Something Mosaic needed to check could not be read.',
'failed:revision-conflict': 'Not changed. It changed while Mosaic was checking. Try again.',
'failed:outcome-unknown': 'May have changed. The change did not answer in time.',
};
if (typeof outcome !== 'string') return 'Not known. The answer did not say what happened.';
if (Object.hasOwn(words, outcome)) return words[outcome];
if (outcome.startsWith('failed:')) {
const code = outcome.slice(7);
return /^[a-z0-9][a-z0-9-]{0,63}$/.test(code) && !KEYISH.test(code) ? `Not changed. It refused the change (${code}).` : 'Not changed. It refused the change, with a code this page does not show.';
}
return 'Not known. The answer did not say what happened.';
}
const OFF_WORDS = {
'invalid-request': 'The Console refused the request: the program is not in its installed list, or that list could not be read.',
'human-required': 'Only the instance owner can turn a program off.',
'proxy-admin-busy': 'Another setup action is running. Wait for it to finish, then try again.',
};
function paintOffResult() {
const box = $('proxy-setup-programs-result');
if (!offView) { box.hidden = true; box.replaceChildren(); return; }
box.hidden = false;
if (offView.working) { box.className = 'proxy-programs-result'; box.replaceChildren(el('p', `Turning off ${offView.name}…`, 'small muted')); return; }
// Whether the list above was read again after the answer: it says so, and never claims a list it did not get.
const reread = () => {
if (offView.reread === 'ok') return [el('p', 'The list above is read again and shows what is on now.', 'small proxy-programs-reread')];
if (offView.reread === 'failed') {
const foot = el('p', '', 'proxy-setup-history-foot'); foot.append(retryButton('proxy-setup-programs-reread', () => rereadPrograms(true)));
return [el('p', 'The list above could not be read again, so it may be out of date.', 'small proxy-programs-reread'), foot];
}
return [el('p', 'Reading the list again…', 'small muted proxy-programs-reread')];
};
if (offView.line) { box.className = `proxy-programs-result banner ${offView.kind === 'busy' ? 'ref' : 'err'}`; box.replaceChildren(el('p', offView.line), ...reread()); return; }
box.className = 'proxy-programs-result banner';
const title = el('p', `Turn off ${offView.name}: what happened in each organization.`, 'proxy-programs-result-title');
const ul = el('ul', '', 'proxy-programs-outcomes');
for (const r of offView.results) {
const li = el('li'); li.dataset.outcome = typeof r?.outcome === 'string' && /^[a-z:-]{1,80}$/.test(r.outcome) && !KEYISH.test(r.outcome) ? r.outcome : 'unknown';
li.append(el('span', orgLabel(r?.id), 'proxy-outcome-org'), document.createTextNode(': '), el('span', offOutcome(r?.outcome)));
ul.append(li);
}
box.replaceChildren(title, offView.results.length ? ul : el('p', 'No organization was in the answer.', 'small muted'), ...reread());
}
// Read the status again after a turn-off answer, after a read already under way. load() keeps the
// old state when its read fails, so a new state object is the sign the list was read again.
async function rereadPrograms(fromButton) {
const view = offView; if (!view) return;
view.reread = 'reading'; paintOffResult();
while (loading) await pause(50);
const painted = await load();
if (offView !== view) return;
view.reread = painted ? 'ok' : 'failed'; paintOffResult();
const box = $('proxy-setup-programs-result');
if (fromButton || document.activeElement === document.body || !document.activeElement) (view.reread === 'failed' ? $('proxy-setup-programs-reread') : box)?.focus();
}
async function programsOff(name) {
if (!sendOk || offBusy) return;
offBusy = true; offAsk = null; offView = { name, working: true }; paintPrograms(); paintOffResult();
const box = $('proxy-setup-programs-result'); box.focus();
let view;
try {
const r = await fetch('/api/proxy/plugins', { cache: 'no-store', redirect: 'manual' }); const v = r.ok ? await r.json() : null;
const names = Array.isArray(v?.available?.harness) ? v.available.harness.filter(n => typeof n === 'string') : null;
if (!names) throw Error();
list.replaceChildren(...(names.length ? names.map(n => el('li', n)) : [el('li', 'No programs are installed.', 'muted')]));
} catch { programsRead = false; list.replaceChildren(el('li', 'The programs could not be read.', 'muted')); }
});
const value = await admin('programs/off', { name });
if (!value || typeof value !== 'object' || !Array.isArray(value.results)) throw Object.assign(new Error('The answer could not be read.'), { code: 'outcome-unknown' });
view = { name, results: value.results };
addReceipt(value.receipt);
} catch (error) {
if (error?.code === 'proxy-admin-busy') view = { name, kind: 'busy', line: `${name} was not turned off. ${OFF_WORDS['proxy-admin-busy']}` };
else if (error?.code === 'invalid-request' || error?.code === 'human-required') view = { name, line: `${name} was not turned off. ${failText(error, OFF_WORDS)}` };
else view = { name, line: `Turning off ${name} may not have finished, so some organizations may have changed. ${failText(error, OFF_WORDS)}` };
}
offView = view; offBusy = false; paintOffResult(); paintPrograms();
box.focus();
// After any answer, read the status again.
await rereadPrograms(false);
}
// settings-s5c: access health per organization, read when Technical details opens (owner only).
// Ready only for health ok whose every stack-managed key is active; never a key, a key id or the
// count of other keys, which holds other organizations' keys and is not a warning.
const ACCESS_WORDS = { 'human-required': 'Only the instance owner can read access.', 'outcome-unknown': 'The host could not read access.', 'not-configured': 'Model service setup is not available on this Console.' };
let accessRound = 0, accessView = null;
function accessHealth(o) {
const unknown = ['badge-muted', 'Not known', 'The answer did not say.'];
if (!o || typeof o !== 'object') return unknown;
const { health, reason, keys } = o;
if (health === 'ok') return reason === undefined && Array.isArray(keys) && keys.length > 0 && keys.every(k => k && typeof k === 'object' && k.state === 'active')
? ['badge-ok', 'Ready', null] : ['badge-muted', 'Not known', 'The answer did not agree with itself.'];
if (health === 'attention') return reason === 'proxy-uncertain'
? ['badge-attn', 'Not sure', 'The model service did not answer clearly, so Mosaic can\'t tell whether its access works.']
: ['badge-attn', 'Needs attention', 'Some of its access is not active.'];
if (health === 'missing') return ['badge-attn', 'None yet', 'No agent here has access to your models yet.'];
if (health === 'not-riding') return ['badge-muted', 'Not used', 'It does not use your models.'];
if (health === 'unreadable') return ['badge-danger', 'Could not be read', reason === 'bus-down' ? 'Its bus did not answer.' : reason === 'no-proxy-client' ? 'Its bus has no model service client set up.' : reason === 'unreadable' ? 'Its answer about access could not be read.' : null];
return unknown;
}
function paintAccess() {
const list = $('proxy-setup-access'), message = $('proxy-setup-access-message'), retry = $('proxy-setup-access-retry');
retry.hidden = !accessView?.error;
if (!accessView) { message.className = 'small muted'; message.textContent = 'Not read yet.'; list.replaceChildren(); return; }
if (accessView.reading) { message.className = 'small muted'; message.textContent = 'Reading…'; return; }
if (accessView.error) { message.className = 'banner err'; message.textContent = `Access could not be read. ${accessView.error}`; list.replaceChildren(); return; }
const orgs = accessView.organizations;
message.className = 'small muted'; message.textContent = orgs.length ? '' : 'There is no organization to check.';
list.replaceChildren(...orgs.map(o => {
const [badge, word, why] = accessHealth(o), li = el('li');
li.dataset.access = word === 'Ready' ? 'ready' : 'not-ready';
li.append(el('span', orgLabel(o?.id)), el('span', word, `badge ${badge}`));
if (why) li.append(el('p', why, 'small muted account-reason'));
return li;
}));
}
async function readAccess() {
if (!enabled) return;
const round = ++accessRound, refocus = document.activeElement?.id === 'proxy-setup-access-retry';
accessView = { ...(accessView ?? {}), reading: true, error: null }; paintAccess();
let view;
try {
const value = await admin('access');
if (!value || typeof value !== 'object' || !Array.isArray(value.organizations)) throw Object.assign(new Error('The answer could not be read.'), { code: 'outcome-unknown' });
view = { organizations: value.organizations };
} catch (error) { view = { error: failText(error, ACCESS_WORDS) }; }
if (round !== accessRound || !enabled) return;
accessView = view; paintAccess();
if (refocus) { if (view.error) $('proxy-setup-access-retry').focus(); else { const m = $('proxy-setup-access-title'); m.tabIndex = -1; m.focus(); } }
}
$('proxy-setup-access-retry').addEventListener('click', readAccess);
// #1873 ride-default: Ride all and the fixture move. The server decides each organization again;
// this code only words the answer. Every write asks first, in plain words, what changes.
const RIDE_REASONS = {
@@ -1458,7 +1655,7 @@ if (document.documentElement.hasAttribute('data-settings-proxy-document') && !lo
};
$('proxy-ride-go').addEventListener('click', () => { if (!$('proxy-ride-go').disabled) rideAll(); });
function paint() {
paintState(); paintControls(); paintService(); paintRestart(); paintOrgsCard(); paintTriageCard(); paintAccountCard();
paintState(); paintControls(); paintService(); paintRestart(); paintOrgsCard(); paintTriageCard(); paintAccountCard(); paintPrograms();
const job = state.fetch;
if (job.state === 'running') say(`Downloading: ${STEPS[job.step] ?? job.step ?? 'starting'}…`);
else if (job.state === 'failed' && seenFetch !== 'failed') { say(`Fetch failed. ${explain(job.error)}`, 'error'); seenFetch = 'failed'; }
@@ -1469,11 +1666,13 @@ if (document.documentElement.hasAttribute('data-settings-proxy-document') && !lo
document.dispatchEvent(new CustomEvent('mosaic-proxy-status', { detail: state }));
focusStep();
}
// True once the answer is painted, so a caller can say the list on the page is the new one.
async function load() {
if (!enabled || loading) return; loading = true;
try { state = await admin('status'); causeRound++; if (state.next?.[0] === 'accounts' && triageSet === null) await readTriage(); paint(); if (state.init.initialized) await accountsReady(); }
if (!enabled || loading) return false; loading = true; let painted = false;
try { state = await admin('status'); causeRound++; if (state.next?.[0] === 'accounts' && triageSet === null) await readTriage(); paint(); painted = true; if (state.init.initialized) await accountsReady(); }
catch (error) { say(error.message, 'error'); }
finally { loading = false; }
return painted;
}
async function act(label, action) {
if (!sendOk || state?.busy || chain?.running) return;
+9
View File
@@ -122,6 +122,15 @@ table.s1-table td code{font-size:12.5px;white-space:nowrap}
/* settings-s5b: the setup history (GET /api/proxy/admin/history), the service key and the service's lines. */
#proxy-setup-history{list-style:none;padding-left:0;overflow-wrap:anywhere;font-size:13px;margin:0 0 8px}#proxy-setup-history li{padding:2px 0}
.proxy-setup-history-foot{display:flex;flex-wrap:wrap;gap:8px;margin:0}.proxy-setup-history-foot button,[data-log] button,#proxy-setup-keymade-retry{min-height:44px}
/* settings-s5c: Programs that drive models under Advanced, and Access under Technical details. */
.settings-form.proxy-programs{margin-bottom:20px;gap:8px}.proxy-programs-list{list-style:none;margin:8px 0 0;padding:0}.proxy-programs-list>li{padding:10px 0;border-top:1px solid var(--line);min-width:0}
.proxy-program-head{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:8px 12px}.proxy-program-name{font-weight:600;color:var(--strong)}
.proxy-program-head button,.proxy-program-confirm button,#proxy-setup-access-retry{min-height:44px}.proxy-program-orgs{margin:4px 0 0;overflow-wrap:anywhere}
.proxy-program-confirm{margin:8px 0 0;padding:10px 12px;border:1px solid color-mix(in srgb,var(--danger) 50%,var(--line));border-radius:var(--r);background:color-mix(in srgb,var(--danger) 6%,var(--surface))}.proxy-program-confirm>p:first-child{margin:0 0 8px;overflow-wrap:anywhere}
.proxy-program-confirm button.danger{color:var(--danger);border-color:color-mix(in srgb,var(--danger) 60%,var(--line))}
.proxy-programs-result{margin:12px 0 0;display:block}.proxy-programs-result[hidden]{display:none}.proxy-programs-result:focus-visible,#proxy-setup-access-title:focus-visible{outline:2px solid var(--focus);outline-offset:2px}.proxy-programs-result>p{margin:0}.proxy-programs-result>.proxy-programs-reread{margin-top:8px}.proxy-programs-result-title{font-weight:600;color:var(--strong)}
.proxy-programs-outcomes{margin:6px 0 0;padding-left:18px;overflow-wrap:anywhere}.proxy-programs-outcomes li{padding:2px 0}.proxy-outcome-org{font-weight:600}
.proxy-setup-access{margin:12px 0}.proxy-setup-access h4{margin:0 0 2px}.proxy-access li>.badge{justify-self:start}.proxy-setup-access .rows{margin-top:4px}#proxy-setup-access-message:empty{display:none}
[data-log] .setup-log{margin:8px 0}[data-log] p{margin:0 0 8px}#proxy-setup-history-message:empty{display:none}
/* #1873 settings slice 1 (D3, D4): the kept restart list and Technical details. */
.proxy-setup-restart{margin:0 0 12px}
@@ -149,13 +149,13 @@ test('settings-s5b: Technical details shows when the service key was made, the s
assert.equal(await text('#proxy-setup-history-all'), 'Show all');
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-history-older").hidden'), true);
// The lines: read when their box opens, shown as the answer has them, with what was removed.
assert.deepEqual(await reads(), ['GET service-key', 'GET history?limit=25']);
assert.deepEqual(await reads(), ['GET service-key', 'GET history?limit=25', 'GET access']);
await b.evaluate('document.querySelector("#proxy-setup-tech-lines").open = true; true');
await wait('document.querySelector("#proxy-setup-tech-lines pre.setup-log")');
assert.equal(await text('#proxy-setup-tech-lines summary'), 'The service\'s last lines');
assert.equal(await text('#proxy-setup-tech-lines pre.setup-log'), LOG_OK.lines.join('\n'));
assert.equal(await text('#proxy-setup-tech-lines [data-log] p'), 'Mosaic removes anything that looks like a key. It removed something from 1 line. 2 lines were left out.');
assert.deepEqual(await reads(), ['GET service-key', 'GET history?limit=25', 'GET log?lines=20']);
assert.deepEqual(await reads(), ['GET service-key', 'GET history?limit=25', 'GET access', 'GET log?lines=20']);
// Read again reads the lines once more.
await click('#proxy-setup-tech-lines [data-log] button');
await wait('window.__admin.filter(r => r === "GET log?lines=20").length === 2 && document.querySelector("#proxy-setup-tech-lines pre.setup-log")');
@@ -229,7 +229,7 @@ test('settings-s5b: each failed read shows its line with Read again, and Read ag
await b.evaluate('(() => { const r = document.querySelector("#proxy-setup-tech-lines [data-log] button"); r.focus(); r.click(); return true; })()');
await wait('document.querySelector("#proxy-setup-tech-lines pre.setup-log")');
assert.equal(await b.evaluate('document.activeElement?.closest("[data-log]") !== null && document.activeElement.textContent === "Read again"'), true);
assert.deepEqual(await reads(), ['GET service-key', 'GET history?limit=25', 'GET service-key', 'GET history?limit=25', 'GET log?lines=20', 'GET log?lines=20']);
assert.deepEqual(await reads(), ['GET service-key', 'GET history?limit=25', 'GET access', 'GET service-key', 'GET history?limit=25', 'GET log?lines=20', 'GET log?lines=20']);
});
// ---- Owner only -------------------------------------------------------------------------------
@@ -293,7 +293,7 @@ test('settings-s5b: history pages back one page at a time, shows each entry once
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-history-older").hidden'), true);
assert.equal(await b.evaluate('document.activeElement?.id'), 'proxy-setup-history-all');
assert.equal(await text('#proxy-setup-history-message'), '');
assert.deepEqual(await reads(), ['GET service-key', 'GET history?limit=25', 'GET history?limit=25&before=3', 'GET history?limit=25&before=1']);
assert.deepEqual(await reads(), ['GET service-key', 'GET history?limit=25', 'GET access', 'GET history?limit=25&before=3', 'GET history?limit=25&before=1']);
// Closing and opening Technical details starts from the newest page again.
await b.evaluate('document.querySelector("#proxy-setup-tech").open = false; true');
await new Promise(r => setTimeout(r, 100));
@@ -0,0 +1,515 @@
// #1873 settings-s5c (DESIGN.md, mockup models-advanced): Model setup, Advanced, lists the installed
// programs from the status read's programs field and which organizations have each one on; one
// program can be turned off in every organization (POST /api/proxy/admin/programs/off), and the page
// words each organization's outcome. Technical details reads access health per organization
// (GET /api/proxy/admin/access) when it opens. All of it is the instance owner's: a page without
// proxyAdmin shows none of it and sends no /api/proxy/admin/ request.
import { test } from 'node:test';
import assert from 'node:assert/strict';
import { fileURLToPath } from 'node:url';
import { startServer } from '../src/serve.mjs';
import { createDevOwner } from '../src/dev-owner.mjs';
import { browser } from './browser.mjs';
import { close } from './fixture.mjs';
const LIST = [
{ id: 'acme', label: 'Acme Studio', theme: 'cobalt', busHealthy: true },
{ id: 'gamma', label: 'Gamma Home', theme: 'rosewood', busHealthy: true },
{ id: 'lab', label: 'Lab Bench', theme: 'cobalt', busHealthy: true },
];
const VIEW = {
business: 'acme', revision: 'a'.repeat(64), harnesses: ['pi'], models: ['fixture-deterministic'],
providerModels: { 'fixture-deterministic': { module: 'fixture', upstream: 'fixture', model: 'fixture-deterministic' } },
levels: { pi: ['off', 'low'] }, instances: {}, catalogue: { status: 'ready', observedAt: new Date().toISOString(), models: [], notices: [] },
};
async function orgFixture() {
const { checkRootAgents } = await import('../../organization/src/index.mjs');
const rolesDir = fileURLToPath(new URL('../../../roles', import.meta.url));
const root = { state: 'ok', ...checkRootAgents({ agentsVersion: 1, agents: {} }, { rolesDir }) };
const empty = () => Promise.resolve([]);
const member = org => ({
id: org.id, doc: { appearance: { theme: org.theme }, roles: { chief: { definition: 'chief-of-staff' } }, projects: {} },
status: async () => ({ healthy: true, pid: 4242, boot: null }),
options: () => ({ bus: { inbox: empty, agents: empty, 'thread.claims': empty, tasks: empty, usage: () => Promise.resolve({}), limits: () => Promise.resolve({}), decisions: empty }, chat: { threads: empty, projects: empty } }),
});
const organizations = {
list: async () => LIST,
members: async () => LIST.map(member),
resolve: async id => {
const org = LIST.find(o => o.id === id); if (!org) return null;
return {
busHealthy: true,
reads: { business: async () => ({ business: { id, human: 'jason', projects: [], appearance: { theme: org.theme } } }), settings: async () => ({ business: id, release: 'fixture', notifier: {} }), queue: async () => ({ rows: [] }), busStatus: async () => ({}) },
bus: { messages: async () => ({ messages: [], unread: 0, total: 0 }), agents: empty, 'thread.claims': empty, inbox: empty, tasks: empty, usage: async () => ({}), routes: async () => ({ ...VIEW, business: id }), instances: async () => ({ business: id, revision: 'a'.repeat(64), launch: true, noHire: [], retired: [], definitions: {}, instances: {} }) },
chat: { projects: empty, threads: empty },
};
},
};
return { organizations, agentLevels: { loadRoot: () => root, rolesDir, ctx: { configDir: '/cfg', dataRoot: '/data', instance: 'test' } } };
}
// Program names are the read's, not a list the page holds: one of them is made up.
const PROGRAMS = { installed: ['pi', 'zeta-runner'], organizations: [{ id: 'acme', on: ['pi', 'zeta-runner'] }, { id: 'gamma', on: null }, { id: 'lab', on: ['pi'] }] };
const SERVICE_UP = { next: ['accounts'], init: { initialized: true, partial: false, problem: null, settings: { port: 18432, rotateGraceMinutes: 30, firstOutputSeconds: 90 }, files: [] },
release: { fetched: true, verified: true, version: '8.0.42', panelVersion: '1.26.7' },
unit: { unit: 'mosaic-proxy.service', installed: true, active: 'active', port: 18432, listening: true, healthy: true }, fence: { set: false }, initLock: { present: false, blockers: [] }, fetch: { state: 'idle' },
organizations: [], ride: [], programs: PROGRAMS };
const AFTER = { ...SERVICE_UP, programs: { ...PROGRAMS, organizations: [{ id: 'acme', on: ['pi'] }, { id: 'gamma', on: null }, { id: 'lab', on: ['pi'] }] } };
const ACCESS = { organizations: [
{ id: 'acme', health: 'ok', keys: [{ keyId: 'kid-AAAA1111', agent: 'chief', state: 'active', issuedAt: null }], other: 4242, sentinel: 1 },
{ id: 'gamma', health: 'attention', reason: 'proxy-uncertain', keys: [] },
{ id: 'lab', health: 'attention', keys: [{ keyId: 'kid-BBBB2222', agent: 'chief', state: 'active', issuedAt: null }, { keyId: 'kid-CCCC3333', agent: 'writer', state: 'expired', issuedAt: null }], other: 4242 },
{ id: 'north', health: 'missing', keys: [], other: 4242 },
{ id: 'south', health: 'not-riding', keys: [] },
{ id: 'east', health: 'unreadable', reason: 'bus-down', keys: [] },
{ id: 'west', health: 'unreadable', reason: 'no-proxy-client', keys: [] },
{ id: 'up', health: 'unreadable', reason: 'unreadable', keys: [] },
{ id: 'down', keys: [{ keyId: 'kid-DDDD4444', agent: 'chief', state: 'active', issuedAt: null }] },
{ id: 'left', health: 'ok', reason: 'proxy-uncertain', keys: [{ keyId: 'kid-EEEE5555', agent: 'chief', state: 'active', issuedAt: null }] },
{ id: 'right', health: 'ok', keys: [] },
{ id: 'top', health: 'great', keys: [] },
] };
// The owner's flags (or not), the status (a list: each read takes the next one and the last one stays),
// and the admin reads and writes by name. window.__admin records every /api/proxy/admin/ request,
// window.__writes every write anywhere under /proxy/.
const stub = ({ owner = true, status = SERVICE_UP, admin = {} } = {}) => `(() => {
const real = window.fetch.bind(window);
window.__s5c = ${JSON.stringify({ owner, status: Array.isArray(status) ? status : [status], admin })}; window.__admin = []; window.__writes = [];
const json = (body, status = 200) => new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json' } });
const next = list => Array.isArray(list) ? (list.length > 1 ? list.shift() : list[0]) : list;
window.fetch = async (input, init = {}) => {
const url = new URL(typeof input === 'string' ? input : input.url, location.href), path = url.pathname, method = (init.method || 'GET').toUpperCase();
const at = path.indexOf('/proxy/admin/');
if (at >= 0) {
const name = path.slice(at + 13) + url.search; window.__admin.push(method + ' ' + name);
if (method !== 'GET') window.__writes.push({ path, body: init.body ?? null });
if (name === 'status') { const s = next(__s5c.status); if (s === null || typeof s !== 'object') return json(s); if (typeof s.raw === 'string') return new Response(s.raw, { status: 200, headers: { 'content-type': 'text/html' } }); return s.status ? json(s.body, s.status) : json(s); }
const a = next(__s5c.admin[method === 'GET' ? name : method + ' ' + name]);
if (!a) return json({ error: 'fixture-unexpected-api' }, 403);
if (a.throws) throw new TypeError('Failed to fetch');
return a.status ? json(a.body, a.status) : json(a);
}
if (method !== 'GET' && /\\/proxy\\//.test(path)) { window.__writes.push({ path, body: init.body ?? null }); return json({ error: 'stub' }, 500); }
if (method !== 'GET') return real(input, init);
if (/\\/api\\/(orgs\\/[^/]+\\/)?config$/.test(path)) { const c = await (await real(input, init)).json(); return json({ ...c, orgSetup: true, proxyAdmin: __s5c.owner, proxyAdminSend: __s5c.owner }); }
if (path.endsWith('/proxy/plugins')) return json({ revision: 'b'.repeat(64), available: { harness: ['pi'], 'model-provider': ['fixture', 'cliproxy'] }, plugins: { harness: ['pi'], 'model-provider': ['fixture'] } });
if (path.endsWith('/proxy/accounts')) return json({ accounts: [] });
if (path.endsWith('/proxy/keys')) return json({ keys: [] });
if (path.endsWith('/triage/route')) return json({ route: null });
return real(input, init);
};
})();`;
async function setup(t, { path = '/#/settings/model-setup', viewport = [1440, 900], ...options } = {}) {
const { organizations, agentLevels } = await orgFixture();
const server = await startServer({ port: 0, sso: createDevOwner(), organizations, agentLevels, triage: null, send: async () => ({}), log: () => {} });
t.after(() => close(server));
const b = await browser({ machine: false }); t.after(() => b.close());
await b.viewport(...viewport);
await b.call('Page.addScriptToEvaluateOnNewDocument', { source: stub(options) });
await b.navigate(`http://127.0.0.1:${server.address().port}${path}`);
const wait = expression => b.evaluate(`(async()=>{for(let i=0;i<250;i++){if(${expression})return true;await new Promise(r=>setTimeout(r,30))}throw Error("wait failed: "+${JSON.stringify(expression)}+" HASH "+location.hash)})()`);
const text = sel => b.evaluate(`document.querySelector(${JSON.stringify(sel)})?.textContent ?? null`);
const click = sel => b.evaluate(`(() => { const el = document.querySelector(${JSON.stringify(sel)}); if (!el) throw Error("no ${sel.replace(/"/g, '')}"); el.click(); return true; })()`);
const admin = () => b.evaluate('window.__admin');
return { b, wait, text, click, admin };
}
const READY = 'document.querySelector("#proxy-setup-state dd") && !document.querySelector("#setup-step-service").hidden && !document.querySelector("#proxy-setup-advanced").hidden';
const openAdvanced = b => b.evaluate('(() => { document.querySelector("#proxy-setup-advanced").open = true; return true; })()');
const openTech = b => b.evaluate('(() => { document.querySelector("#proxy-setup-tech").open = true; return true; })()');
const programs = b => b.evaluate('[...document.querySelectorAll("#proxy-setup-programs > li")].map(li => ({ name: li.dataset.program ?? null, text: li.querySelector(".proxy-program-orgs")?.textContent ?? li.textContent }))');
const outcomes = b => b.evaluate('[...document.querySelectorAll("#proxy-setup-programs-result li")].map(li => li.textContent)');
const access = b => b.evaluate('[...document.querySelectorAll("#proxy-setup-access li")].map(li => ({ text: li.textContent, ready: li.dataset.access }))');
const KEY_TEXT = /ms[kotp]-[A-Za-z0-9_-]{4,}/i;
// Technical details' other reads, so a shot shows them as they read.
const T = n => new Date(Date.UTC(2026, 10, 19, 9, n)).toISOString();
const TECH = { 'service-key': { madeAt: T(3), renewedAt: null, renewal: 'not-built', problem: null }, 'history?limit=25': { entries: [{ op: 'unit.start', time: T(4), user: 'jason' }, { op: 'init', time: T(2), user: 'jason' }], next: null } };
const OFF_PI = { name: 'pi', results: [{ id: 'acme', outcome: 'in-use' }, { id: 'gamma', outcome: 'bus-down' }, { id: 'lab', outcome: 'last-program' }], receipt: null };
// ---- The list -------------------------------------------------------------------------------
test('settings-s5c: Advanced lists the installed programs from the status read and which organizations have each one on, by display name', { timeout: 90000 }, async t => {
const { b, wait, admin } = await setup(t);
await wait(READY); await openAdvanced(b);
await wait('document.querySelectorAll("#proxy-setup-programs > li[data-program]").length === 2');
assert.deepEqual(await programs(b), [
{ name: 'pi', text: 'On in Acme Studio and Lab Bench. Not known in Gamma Home: its list could not be read.' },
{ name: 'zeta-runner', text: 'On in Acme Studio. Off in Lab Bench. Not known in Gamma Home: its list could not be read.' },
]);
assert.deepEqual(await b.evaluate('[...document.querySelectorAll("#proxy-setup-programs .proxy-program-name")].map(n => n.textContent)'), ['pi', 'zeta-runner']);
assert.deepEqual(await b.evaluate('[...document.querySelectorAll("[data-program-off]")].map(n => n.getAttribute("aria-label"))'), ['Turn off pi for every organization', 'Turn off zeta-runner for every organization']);
assert.doesNotMatch(await b.evaluate('document.querySelector("#proxy-setup-advanced").textContent'), /Turning a program off for every organization is not built/);
// Opening Advanced reads nothing more: the list is the status read's.
assert.deepEqual((await admin()).filter(r => r !== 'GET status'), []);
});
test('settings-s5c: a null list reads as not known, never off; a list the read could not give says so', { timeout: 90000 }, async t => {
{
const status = { ...SERVICE_UP, programs: { installed: ['pi'], organizations: [{ id: 'gamma', on: null }, { id: 'acme', on: ['pi'] }] } };
const { b, wait } = await setup(t, { status });
await wait(READY); await openAdvanced(b);
await wait('document.querySelector("#proxy-setup-programs > li[data-program]")');
const [pi] = await programs(b);
assert.equal(pi.text, 'On in Acme Studio. Not known in Gamma Home: its list could not be read.');
assert.doesNotMatch(pi.text, /Off in/);
}
for (const [programsField, line] of [
[{ installed: ['pi'], organizations: null }, 'Which organizations have it on could not be read.'],
[{ installed: null, organizations: [] }, 'The installed programs could not be read.'],
[undefined, 'The programs could not be read.'],
[{ installed: [], organizations: [] }, 'No programs are installed.'],
]) {
const { b, wait } = await setup(t, { status: { ...SERVICE_UP, programs: programsField } });
await wait(READY); await openAdvanced(b);
await wait(`document.querySelector("#proxy-setup-programs")?.textContent.includes(${JSON.stringify(line)})`);
assert.doesNotMatch(await b.evaluate('document.querySelector("#proxy-setup-programs").textContent'), /Off in|On in no/);
}
});
// ---- Turn off for every organization ----------------------------------------------------------
test('settings-s5c: the confirm names the program, and Cancel sends nothing', { timeout: 90000 }, async t => {
const { b, wait, text, click, admin } = await setup(t, { admin: { 'POST programs/off': OFF_PI } });
await wait(READY); await openAdvanced(b);
await wait('document.querySelector("[data-program-off=pi]")');
await click('[data-program-off=pi]');
await wait('document.querySelector("#proxy-setup-programs-yes")');
assert.match(await text('#proxy-setup-programs-ask'), /^Turn off pi in every organization\?/);
assert.equal(await text('#proxy-setup-programs-yes'), 'Turn off pi');
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-programs-yes").closest("li").dataset.program'), 'pi');
assert.equal(await b.evaluate('document.activeElement?.id'), 'proxy-setup-programs-yes');
await click('#proxy-setup-programs-no');
await wait('!document.querySelector("#proxy-setup-programs-yes")');
await new Promise(r => setTimeout(r, 300));
assert.deepEqual(await b.evaluate('window.__writes'), []);
assert.deepEqual((await admin()).filter(r => r !== 'GET status'), []);
assert.equal(await b.evaluate('document.activeElement?.dataset.programOff'), 'pi', 'focus goes back to the button');
// Confirming sends the one name.
await click('[data-program-off=pi]'); await wait('document.querySelector("#proxy-setup-programs-yes")');
await click('#proxy-setup-programs-yes');
await wait('document.querySelectorAll("#proxy-setup-programs-result li").length === 3');
assert.deepEqual(await b.evaluate('window.__writes.map(w => [w.path.replace(/^.*(\\/proxy\\/admin\\/)/, "$1"), JSON.parse(w.body)])'), [['/proxy/admin/programs/off', { name: 'pi' }]]);
});
test('settings-s5c: each outcome id renders its line, by display name', { timeout: 90000 }, async t => {
const results = [
{ id: 'acme', outcome: 'off' }, { id: 'gamma', outcome: 'already-off' }, { id: 'lab', outcome: 'in-use' },
{ id: 'o4', outcome: 'last-program' }, { id: 'o5', outcome: 'bus-down' }, { id: 'o6', outcome: 'unreadable' },
{ id: 'o7', outcome: 'failed:revision-conflict' }, { id: 'o8', outcome: 'failed:outcome-unknown' }, { id: 'o9', outcome: 'failed:plugins-refused' },
{ id: 'o10', outcome: 'sideways' }, { id: 'o11' },
];
const { b, wait, click } = await setup(t, { admin: { 'POST programs/off': { name: 'zeta-runner', results, receipt: null } } });
await wait(READY); await openAdvanced(b);
await wait('document.querySelector("[data-program-off=zeta-runner]")');
await click('[data-program-off=zeta-runner]'); await wait('document.querySelector("#proxy-setup-programs-yes")'); await click('#proxy-setup-programs-yes');
await wait('document.querySelectorAll("#proxy-setup-programs-result li").length === 11');
assert.equal(await b.evaluate('document.querySelector(".proxy-programs-result-title").textContent'), 'Turn off zeta-runner: what happened in each organization.');
const lines = await outcomes(b);
await wait('/The list above is read again and shows what is on now\./.test(document.querySelector("#proxy-setup-programs-result").textContent)');
assert.deepEqual(lines, [
'Acme Studio: Turned off.',
'Gamma Home: It was already off. Nothing changed.',
'Lab Bench: Kept on. Something there still uses it: a role route, a fallback or an agent.',
'o4: Kept on. It is the only program on there.',
'o5: Not changed. Its programs could not be read.',
'o6: Not changed. Something Mosaic needed to check could not be read.',
'o7: Not changed. It changed while Mosaic was checking. Try again.',
'o8: May have changed. The change did not answer in time.',
'o9: Not changed. It refused the change (plugins-refused).',
'o10: Not known. The answer did not say what happened.',
'o11: Not known. The answer did not say what happened.',
]);
// bus-down does not say the organization is stopped.
assert.doesNotMatch(lines[4], /stop|not running|down/i);
});
test('settings-s5c: busy and a failed request each render a plain line, and the status is read again after each', { timeout: 90000 }, async t => {
const answers = [
{ status: 409, body: { error: 'proxy-admin-busy' } },
{ status: 500, body: { error: 'outcome-unknown' } },
{ status: 400, body: { error: 'invalid-request' } },
{ throws: true },
];
const { b, wait, click, admin } = await setup(t, { admin: { 'POST programs/off': answers } });
await wait(READY); await openAdvanced(b);
const lines = [];
for (let i = 0; i < answers.length; i++) {
await wait('document.querySelector("[data-program-off=pi]") && !document.querySelector("[data-program-off=pi]").disabled');
const before = (await admin()).filter(r => r === 'GET status').length;
await click('[data-program-off=pi]'); await wait('document.querySelector("#proxy-setup-programs-yes")'); await click('#proxy-setup-programs-yes');
await wait(`window.__admin.filter(r => r === "POST programs/off").length === ${i + 1} && window.__admin.lastIndexOf("GET status") > window.__admin.lastIndexOf("POST programs/off") && /The list above is read again/.test(document.querySelector("#proxy-setup-programs-result").textContent)`);
assert.equal((await admin()).filter(r => r === 'GET status').length, before + 1);
lines.push([await b.evaluate('document.querySelector("#proxy-setup-programs-result").className'), await b.evaluate('document.querySelector("#proxy-setup-programs-result").textContent')]);
}
assert.deepEqual(lines, [
['proxy-programs-result banner ref', 'pi was not turned off. Another setup action is running. Wait for it to finish, then try again.The list above is read again and shows what is on now.'],
['proxy-programs-result banner err', 'Turning off pi may not have finished, so some organizations may have changed. The outcome is unknown. Check the status before retrying. (outcome-unknown)The list above is read again and shows what is on now.'],
['proxy-programs-result banner err', 'pi was not turned off. The Console refused the request: the program is not in its installed list, or that list could not be read. (invalid-request)The list above is read again and shows what is on now.'],
['proxy-programs-result banner err', 'Turning off pi may not have finished, so some organizations may have changed. The Console did not answer.The list above is read again and shows what is on now.'],
]);
});
test('settings-s5c: after an off the page reads the status again and shows the new list; focus goes to the result', { timeout: 90000 }, async t => {
const { b, wait, click, admin } = await setup(t, { status: [SERVICE_UP, SERVICE_UP, AFTER], admin: { 'POST programs/off': { name: 'zeta-runner', results: [{ id: 'acme', outcome: 'off' }, { id: 'gamma', outcome: 'bus-down' }, { id: 'lab', outcome: 'already-off' }], receipt: null } } });
await wait(READY); await openAdvanced(b);
await wait('document.querySelector("[data-program-off=zeta-runner]")');
const before = (await admin()).filter(r => r === 'GET status').length;
await click('[data-program-off=zeta-runner]'); await wait('document.querySelector("#proxy-setup-programs-yes")');
await b.evaluate('document.querySelector("#proxy-setup-programs-yes").focus(); document.querySelector("#proxy-setup-programs-yes").click(); true');
await wait('document.querySelectorAll("#proxy-setup-programs-result li").length === 3');
await wait(`window.__admin.filter(r => r === "GET status").length > ${before}`);
const order = await admin();
assert.ok(order.lastIndexOf('GET status') > order.indexOf('POST programs/off'), JSON.stringify(order));
await wait('document.querySelector("li[data-program=zeta-runner] .proxy-program-orgs")?.textContent.startsWith("On in no organization.")');
assert.equal((await programs(b))[1].text, 'On in no organization. Off in Acme Studio and Lab Bench. Not known in Gamma Home: its list could not be read.');
await new Promise(r => setTimeout(r, 300));
assert.equal(await b.evaluate('document.activeElement?.id'), 'proxy-setup-programs-result');
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-programs-result").tabIndex'), -1);
});
test('settings-s5c: focus goes to the result after a busy answer too', { timeout: 90000 }, async t => {
const { b, wait, click } = await setup(t, { admin: { 'POST programs/off': { status: 409, body: { error: 'proxy-admin-busy' } } } });
await wait(READY); await openAdvanced(b);
await wait('document.querySelector("[data-program-off=pi]")');
await click('[data-program-off=pi]'); await wait('document.querySelector("#proxy-setup-programs-yes")'); await click('#proxy-setup-programs-yes');
await wait('/was not turned off/.test(document.querySelector("#proxy-setup-programs-result").textContent)');
await new Promise(r => setTimeout(r, 300));
assert.equal(await b.evaluate('document.activeElement?.id'), 'proxy-setup-programs-result');
});
test('settings-s5c: when the status read after an off fails, or answers with no status, the result says the list may be out of date, and Read again reads it', { timeout: 180000 }, async t => {
// A refusal, and three answers that are 200 but not a status: null, an empty object, a page that is not JSON.
for (const down of [{ status: 503, body: { error: 'outcome-unknown' } }, null, {}, { raw: '<html><body>Gateway</body></html>' }]) {
const { b, wait, click, admin } = await setup(t, { admin: { 'POST programs/off': { name: 'zeta-runner', results: [{ id: 'acme', outcome: 'failed:outcome-unknown' }], receipt: null } } });
await wait(READY); await openAdvanced(b);
await wait('document.querySelector("[data-program-off=zeta-runner]")');
const before = (await admin()).filter(r => r === 'GET status').length;
await b.evaluate(`window.__s5c.status = ${JSON.stringify([down, AFTER])}; true`);
await click('[data-program-off=zeta-runner]'); await wait('document.querySelector("#proxy-setup-programs-yes")'); await click('#proxy-setup-programs-yes');
await wait('document.querySelector("#proxy-setup-programs-reread")');
const shown = await b.evaluate('document.querySelector("#proxy-setup-programs-result").textContent');
assert.match(shown, /The list above could not be read again, so it may be out of date\./);
assert.doesNotMatch(shown, /shows what is on now/);
// The old list still shows, and still says so only as what was last read.
assert.match((await programs(b))[1].text, /^On in Acme Studio\./);
await b.evaluate('document.querySelector("#proxy-setup-programs-reread").focus(); document.querySelector("#proxy-setup-programs-reread").click(); true');
await wait('/The list above is read again and shows what is on now\./.test(document.querySelector("#proxy-setup-programs-result").textContent)');
assert.equal((await admin()).filter(r => r === 'GET status').length, before + 2);
assert.equal((await programs(b))[1].text, 'On in no organization. Off in Acme Studio and Lab Bench. Not known in Gamma Home: its list could not be read.');
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-programs-reread")'), null);
assert.equal(await b.evaluate('document.activeElement?.id'), 'proxy-setup-programs-result');
}
});
test('settings-s5c: a status read that drops the program being asked about, or cannot list programs, drops the question and frees the buttons', { timeout: 90000 }, async t => {
const RUNNING = { ...SERVICE_UP, fetch: { state: 'running', step: 'download' } };
for (const dropped of [{ ...SERVICE_UP, programs: { ...PROGRAMS, installed: ['pi'] } }, { ...SERVICE_UP, programs: null }, { ...SERVICE_UP, programs: { ...PROGRAMS, installed: ['pi'] } }]) {
const { b, wait, click } = await setup(t, { status: [RUNNING, RUNNING, RUNNING, RUNNING, dropped] });
await wait(READY); await openAdvanced(b);
await wait('document.querySelector("[data-program-off=zeta-runner]")');
await click('[data-program-off=zeta-runner]'); await wait('document.querySelector("#proxy-setup-programs-yes")');
assert.equal(await b.evaluate('document.querySelector("[data-program-off=pi]").disabled'), true);
await wait('!document.querySelector("li[data-program=zeta-runner]")');
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-programs-yes")'), null);
if (dropped.programs) {
assert.equal(await b.evaluate('document.querySelector("[data-program-off=pi]").disabled'), false);
await click('[data-program-off=pi]'); await wait('document.querySelector("#proxy-setup-programs-yes")');
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-programs-yes").closest("li").dataset.program'), 'pi');
}
}
});
test('settings-s5c: a refusal code named like an object property shows as its code, never as page source', { timeout: 90000 }, async t => {
const refused = { status: 400, body: { error: 'constructor' } };
const { b, wait, click, text } = await setup(t, { admin: { access: refused, 'POST programs/off': refused } });
await wait(READY); await openAdvanced(b); await openTech(b);
await wait('!document.querySelector("#proxy-setup-access-retry").hidden && document.querySelector("[data-program-off=pi]")');
await click('[data-program-off=pi]'); await wait('document.querySelector("#proxy-setup-programs-yes")'); await click('#proxy-setup-programs-yes');
await wait('/may not have finished/.test(document.querySelector("#proxy-setup-programs-result").textContent)');
const page = await b.evaluate('document.querySelector("#proxy-setup").textContent');
assert.doesNotMatch(page, /function|native code|\[object/);
assert.match(await text('#proxy-setup-access-message'), /^Access could not be read\. /);
});
// ---- Access ----------------------------------------------------------------------------------
test('settings-s5c: Technical details reads access when it opens and words each health; only ok with every key active reads Ready', { timeout: 90000 }, async t => {
const { b, wait, admin } = await setup(t, { admin: { access: ACCESS } });
await wait(READY);
await new Promise(r => setTimeout(r, 300));
assert.equal((await admin()).includes('GET access'), false, 'access is not read before Technical details opens');
await openTech(b);
await wait(`document.querySelectorAll("#proxy-setup-access li").length === ${ACCESS.organizations.length}`);
assert.equal((await admin()).filter(r => r === 'GET access').length, 1);
assert.deepEqual(await access(b), [
{ text: 'Acme StudioReady', ready: 'ready' },
{ text: 'Gamma HomeNot sureThe model service did not answer clearly, so Mosaic can\'t tell whether its access works.', ready: 'not-ready' },
{ text: 'Lab BenchNeeds attentionSome of its access is not active.', ready: 'not-ready' },
{ text: 'northNone yetNo agent here has access to your models yet.', ready: 'not-ready' },
{ text: 'southNot usedIt does not use your models.', ready: 'not-ready' },
{ text: 'eastCould not be readIts bus did not answer.', ready: 'not-ready' },
{ text: 'westCould not be readIts bus has no model service client set up.', ready: 'not-ready' },
{ text: 'upCould not be readIts answer about access could not be read.', ready: 'not-ready' },
{ text: 'downNot knownThe answer did not say.', ready: 'not-ready' },
{ text: 'leftNot knownThe answer did not agree with itself.', ready: 'not-ready' },
{ text: 'rightNot knownThe answer did not agree with itself.', ready: 'not-ready' },
{ text: 'topNot knownThe answer did not say.', ready: 'not-ready' },
]);
const shown = await b.evaluate('document.querySelector(".proxy-setup-access").textContent');
assert.equal((shown.match(/Ready/g) ?? []).length, 1);
assert.doesNotMatch(shown, /kid-|4242|sentinel|chief|writer|expired/);
assert.doesNotMatch(await b.evaluate('document.querySelector(".proxy-setup-access").textContent'), /bus is (stopped|down)|stopped/i);
});
test('settings-s5c: a failed access read shows a plain line with Read again, and Read again reads it', { timeout: 90000 }, async t => {
const { b, wait, text, admin } = await setup(t, { admin: { access: [{ status: 503, body: { error: 'outcome-unknown' } }, { status: 200, body: { organizations: 'nope' } }, ACCESS] } });
await wait(READY); await openTech(b);
await wait('!document.querySelector("#proxy-setup-access-retry").hidden');
assert.equal(await text('#proxy-setup-access-message'), 'Access could not be read. The host could not read access. (outcome-unknown)');
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-access-message").className'), 'banner err');
assert.equal(await b.evaluate('document.querySelectorAll("#proxy-setup-access li").length'), 0);
await b.evaluate('document.querySelector("#proxy-setup-access-retry").focus(); document.querySelector("#proxy-setup-access-retry").click(); true');
await wait('window.__admin.filter(r => r === "GET access").length === 2'); await new Promise(r => setTimeout(r, 400));
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-access-retry").hidden'), false);
assert.equal(await text('#proxy-setup-access-message'), 'Access could not be read. The host could not read access. (outcome-unknown)');
assert.equal(await b.evaluate('document.querySelectorAll("#proxy-setup-access li").length'), 0, 'a shape the page does not know never reads as Ready');
assert.equal(await b.evaluate('document.activeElement?.id'), 'proxy-setup-access-retry');
await b.evaluate('document.querySelector("#proxy-setup-access-retry").focus(); document.querySelector("#proxy-setup-access-retry").click(); true');
await wait(`document.querySelectorAll("#proxy-setup-access li").length === ${ACCESS.organizations.length}`);
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-access-retry").hidden'), true);
assert.equal(await b.evaluate('document.activeElement?.id'), 'proxy-setup-access-title', 'focus lands on the answer');
assert.equal((await admin()).filter(r => r === 'GET access').length, 3);
});
// ---- Owner only ------------------------------------------------------------------------------
test('settings-s5c: a page that is not the instance owner\'s shows none of it and sends no request to programs or access', { timeout: 90000 }, async t => {
// The owner's page, as the control.
{
const { b, wait } = await setup(t, { admin: { access: ACCESS } });
await wait(READY); await openAdvanced(b); await openTech(b);
await wait(`document.querySelectorAll("[data-program-off]").length === 2 && document.querySelectorAll("#proxy-setup-access li").length === ${ACCESS.organizations.length}`);
}
const { b, wait } = await setup(t, { owner: false, admin: { access: ACCESS, 'POST programs/off': OFF_PI } });
await wait('window.MosaicProxy && document.querySelector("#proxy-setup") && document.querySelector("#settings-page-title")');
await new Promise(r => setTimeout(r, 800));
await b.evaluate('document.querySelectorAll("#proxy-setup details").forEach(d => { d.open = true; }); true');
await new Promise(r => setTimeout(r, 800));
const sent = await b.evaluate('window.__admin');
assert.deepEqual(sent, []);
assert.equal(sent.some(r => /programs|access/.test(r)), false);
const shown = sel => b.evaluate(`(() => { const e = document.querySelector(${JSON.stringify(sel)}); return !!e && e.getClientRects().length > 0; })()`);
for (const sel of ['#proxy-setup-programs', '#proxy-setup-programs-result', '#proxy-setup-access', '#proxy-setup-access-message', '#proxy-setup-access-retry', '.proxy-setup-access'])
assert.equal(await shown(sel), false, `${sel} is not shown`);
assert.equal(await b.evaluate('document.querySelectorAll("[data-program-off], #proxy-setup-access li").length'), 0);
assert.doesNotMatch(await b.evaluate('document.body.innerText'), /Turn off for every organization|Programs that drive models|Access/);
});
// ---- No key text -----------------------------------------------------------------------------
test('settings-s5c: no key text reaches the page, even from a fixture answer that holds it in an unexpected field', { timeout: 90000 }, async t => {
const K = s => `${s}-abcdefghijklmnop`;
const status = { ...SERVICE_UP, programs: { installed: ['pi', K('msk')], organizations: [{ id: 'acme', on: ['pi', K('msk')] }, { id: K('mso'), on: ['pi'] }] } };
const off = { name: 'pi', receipt: { time: 'x', op: 'programs.off', name: K('mst'), results: [] }, results: [{ id: K('msp'), outcome: 'off' }, { id: 'acme', outcome: `failed:${K('msk')}` }, { id: 'gamma', outcome: K('mso') }] };
const accessAnswer = { organizations: [
{ id: K('msk'), health: 'ok', keys: [{ keyId: K('msk'), agent: K('msp'), state: 'active', issuedAt: null }] },
{ id: 'acme', health: K('mso'), reason: K('mst'), keys: [], other: 3 },
{ id: 'gamma', health: 'unreadable', reason: K('msk'), keys: [{ keyId: K('mst') }] },
] };
const { b, wait, click } = await setup(t, { status, admin: { access: accessAnswer, 'POST programs/off': off } });
await wait(READY); await openAdvanced(b); await openTech(b);
await wait('document.querySelectorAll("#proxy-setup-access li").length === 3 && document.querySelector("[data-program-off=pi]")');
await click('[data-program-off=pi]'); await wait('document.querySelector("#proxy-setup-programs-yes")'); await click('#proxy-setup-programs-yes');
await wait('document.querySelectorAll("#proxy-setup-programs-result li").length === 3');
const page = await b.evaluate('document.querySelector("#proxy-setup").textContent + "\\n" + document.body.innerText + "\\n" + [...document.querySelectorAll("#proxy-setup [aria-label], #proxy-setup [data-program], #proxy-setup [data-program-off], #proxy-setup [data-outcome]")].map(e => [e.getAttribute("aria-label"), e.dataset.program, e.dataset.programOff, e.dataset.outcome].join(" ")).join("\\n")');
assert.doesNotMatch(page, KEY_TEXT);
// What the page shows in their place.
assert.equal(await b.evaluate('document.querySelectorAll("#proxy-setup-programs > li[data-program]").length'), 1);
assert.match(await b.evaluate('document.querySelector("#proxy-setup-programs").textContent'), /One or more programs have a name this page does not show\./);
assert.match((await programs(b))[0].text, /^On in Acme Studio and An organization Mosaic can't name\.$/);
assert.deepEqual(await outcomes(b), [
'An organization Mosaic can\'t name: Turned off.',
'Acme Studio: Not changed. It refused the change, with a code this page does not show.',
'Gamma Home: Not known. The answer did not say what happened.',
]);
assert.deepEqual(await access(b), [
{ text: 'An organization Mosaic can\'t nameReady', ready: 'ready' },
{ text: 'Acme StudioNot knownThe answer did not say.', ready: 'not-ready' },
{ text: 'Gamma HomeCould not be read', ready: 'not-ready' },
]);
});
test('settings-s5c: a refusal whose code is shaped like a key is not shown', { timeout: 90000 }, async t => {
const refused = { status: 400, body: { error: 'msk-abcdefghijklmnop' } };
const { b, wait, click } = await setup(t, { admin: { access: refused, 'POST programs/off': refused } });
await wait(READY); await openAdvanced(b); await openTech(b);
await wait('!document.querySelector("#proxy-setup-access-retry").hidden && document.querySelector("[data-program-off=pi]")');
await click('[data-program-off=pi]'); await wait('document.querySelector("#proxy-setup-programs-yes")'); await click('#proxy-setup-programs-yes');
await wait('/turned off|may not have finished/.test(document.querySelector("#proxy-setup-programs-result").textContent)');
const page = await b.evaluate('document.querySelector("#proxy-setup").textContent + "\\n" + document.body.innerText');
assert.doesNotMatch(page, KEY_TEXT);
assert.equal(await b.evaluate('document.querySelector("#proxy-setup-access-message").textContent'), 'Access could not be read. The Console refused the read.');
});
// ---- Shots ------------------------------------------------------------------------------------
test('shots', { timeout: 900000, skip: !process.env.MOSAIC_UX_SHOTS }, async t => {
const { mkdir, writeFile } = await import('node:fs/promises');
const { join } = await import('node:path');
const dir = process.env.MOSAIC_UX_SHOTS; await mkdir(dir, { recursive: true });
const settle = () => new Promise(r => setTimeout(r, 1000));
const mixed = { name: 'zeta-runner', results: [{ id: 'acme', outcome: 'off' }, { id: 'gamma', outcome: 'bus-down' }, { id: 'lab', outcome: 'failed:outcome-unknown' }], receipt: null };
const off = async (b, wait, name) => {
await wait(`document.querySelector("[data-program-off=${name}]")`);
await b.evaluate(`document.querySelector("[data-program-off=${name}]").click(); true`);
await wait('document.querySelector("#proxy-setup-programs-yes")');
};
const SHOTS = [
{ name: 'advanced-programs', after: async b => openAdvanced(b), ready: 'document.querySelector("[data-program-off]")' },
{ name: 'advanced-confirm', after: async (b, wait) => { await openAdvanced(b); await off(b, wait, 'zeta-runner'); } },
{ name: 'advanced-result', options: { status: [SERVICE_UP, SERVICE_UP, AFTER], admin: { 'POST programs/off': mixed } },
after: async (b, wait) => { await openAdvanced(b); await off(b, wait, 'zeta-runner'); await b.evaluate('document.querySelector("#proxy-setup-programs-yes").click(); true'); await wait('document.querySelectorAll("#proxy-setup-programs-result li").length === 3'); } },
{ name: 'advanced-busy', options: { admin: { 'POST programs/off': { status: 409, body: { error: 'proxy-admin-busy' } } } },
after: async (b, wait) => { await openAdvanced(b); await off(b, wait, 'pi'); await b.evaluate('document.querySelector("#proxy-setup-programs-yes").click(); true'); await wait('/was not turned off/.test(document.querySelector("#proxy-setup-programs-result").textContent)'); } },
{ name: 'technical-access', options: { admin: { ...TECH, access: ACCESS } },
after: async (b, wait) => { await openTech(b); await wait(`document.querySelectorAll("#proxy-setup-access li").length === ${ACCESS.organizations.length}`); } },
{ name: 'technical-access-failed', options: { admin: { ...TECH, access: { status: 503, body: { error: 'outcome-unknown' } } } },
after: async (b, wait) => { await openTech(b); await wait('!document.querySelector("#proxy-setup-access-retry").hidden'); } },
];
const report = [];
for (const shot of SHOTS) for (const scheme of ['light', 'dark']) for (const width of [390, 1440]) {
const { b, wait } = await setup(t, { ...(shot.options ?? {}), viewport: [width, width === 390 ? 844 : 900] });
await b.call('Emulation.setScrollbarsHidden', { hidden: true });
await b.call('Emulation.setEmulatedMedia', { features: [{ name: 'prefers-color-scheme', value: scheme }] });
await wait(`(${READY}) && !!window.MosaicAppearance`);
await b.evaluate(`window.MosaicAppearance.ready.then(() => window.MosaicAppearance.set({ mode: ${JSON.stringify(scheme)} }))`);
await shot.after(b, wait);
if (shot.ready) await wait(shot.ready);
await settle();
const sideways = await b.evaluate('document.documentElement.scrollWidth > document.documentElement.clientWidth');
const noRing = [], seen = new Set();
for (let i = 0; i < 200; i++) {
await b.call('Input.dispatchKeyEvent', { type: 'keyDown', key: 'Tab', code: 'Tab', windowsVirtualKeyCode: 9 });
await b.call('Input.dispatchKeyEvent', { type: 'keyUp', key: 'Tab', code: 'Tab', windowsVirtualKeyCode: 9 });
const r = await b.evaluate(`(() => { const e = document.activeElement; if (!e || e === document.body) return null; const cs = getComputedStyle(e);
const ring = (cs.outlineStyle !== 'none' && parseFloat(cs.outlineWidth) > 0) || (cs.boxShadow && cs.boxShadow !== 'none');
return { key: e.id || e.dataset.programOff || e.getAttribute('href') || e.tagName + ':' + (e.textContent || '').trim().slice(0, 30), ring }; })()`);
if (!r || seen.has(r.key)) break; seen.add(r.key);
if (!r.ring) noRing.push(r.key);
}
// The result box takes focus from code, not Tab: check its ring too.
const resultRing = await b.evaluate(`(() => { const e = document.querySelector("#proxy-setup-programs-result"); if (e.hidden) return null; e.focus(); const cs = getComputedStyle(e);
return (cs.outlineStyle !== 'none' && parseFloat(cs.outlineWidth) > 0) || (cs.boxShadow && cs.boxShadow !== 'none'); })()`);
if (resultRing === false) noRing.push('proxy-setup-programs-result');
await b.evaluate('document.activeElement?.blur(); window.scrollTo(0, 0); true'); await settle();
const file = `${shot.name}-${width}-${scheme}.png`;
let metrics = await b.call('Page.getLayoutMetrics'), size = metrics.cssContentSize || metrics.contentSize;
await b.viewport(width, Math.ceil(size.height)); await settle();
metrics = await b.call('Page.getLayoutMetrics'); size = metrics.cssContentSize || metrics.contentSize;
const { data } = await b.call('Page.captureScreenshot', { format: 'png', captureBeyondViewport: true, clip: { x: 0, y: 0, width: Math.ceil(size.width), height: Math.ceil(size.height), scale: 1 } });
await writeFile(join(dir, file), Buffer.from(data, 'base64'));
report.push({ page: shot.name, width, scheme, shot: file, sideways, noRing });
await b.close();
}
await writeFile(join(dir, 'measure.json'), JSON.stringify(report, null, 1));
for (const r of report) {
assert.equal(r.sideways, false, `${r.shot} scrolls sideways`);
assert.deepEqual(r.noRing, [], `${r.shot}: controls with no visible focus ring`);
}
});