npm - infinicode - Versions diffs - 2.8.72 → 2.8.75 - Mend

infinicode 2.8.72 → 2.8.75

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/kernel/federation/dashboard-html.d.ts +1 -1
package/dist/kernel/federation/dashboard-html.js +240 -61
package/dist/kernel/federation/transport-http.js +14 -1
package/dist/robopark/robot-runtime.js +3 -0
package/package.json +1 -1
package/packages/robopark/scheduler/main.py +103 -20
package/packages/robopark/scheduler/preview_agent.py +80 -24
package/packages/robopark/scheduler/robot_supervisor.py +41 -16

package/dist/kernel/federation/dashboard-html.js CHANGED Viewed

@@ -24,9 +24,10 @@
 export const DASHBOARD_HTML = `<!doctype html>
 <html lang="en">
 <head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>RoboPark Control</title>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="robopark-ui-build" content="voice-media-20260716-3">
+<title>RoboPark Control</title>
 <style>
 /* ── premium tech glass theme ── dark is the committed default; light is a frosted toggle ── */
 :root{
@@ -690,6 +691,15 @@ button.act:disabled{opacity:0.5;cursor:default;}
 @media(max-width:900px){.rp-config-columns{grid-template-columns:1fr}.rp-config-hero{align-items:flex-start;flex-direction:column}.rp-config-cards{max-height:430px}}
 @media(max-width:620px){.rp-config-fields{grid-template-columns:1fr}.rp-config-fields .wide{grid-column:auto}.rp-config-pipeline{grid-template-columns:1fr}.rp-config-pipeline i{display:none}.rp-config-hero-actions{width:100%}.rp-config-hero-actions .rp-btn{flex:1}}
+/* command sheet */
+.rp-command-shell{display:grid;gap:1rem}.rp-command-env{display:grid;grid-template-columns:repeat(3,minmax(170px,1fr));gap:.65rem;padding:.85rem;border:1px solid var(--glass-border);border-radius:16px;background:var(--panel-2)}
+.rp-command-toolbar{display:flex;gap:.55rem;align-items:center;flex-wrap:wrap}.rp-command-toolbar input{flex:1;min-width:220px}.rp-command-toolbar select{width:auto;min-width:170px}
+.rp-command-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(330px,1fr));gap:.75rem}.rp-command-card{display:flex;flex-direction:column;gap:.55rem;min-width:0;padding:.85rem;border:1px solid var(--glass-border);border-radius:16px;background:linear-gradient(145deg,rgba(31,26,18,.66),rgba(9,8,6,.76));box-shadow:inset 0 1px 0 var(--glass-hi),0 12px 32px rgba(0,0,0,.22)}
+.rp-command-head{display:flex;align-items:flex-start;justify-content:space-between;gap:.6rem}.rp-command-head b{font-family:var(--mono);font-size:.74rem;color:var(--gold-pale)}.rp-command-tag{font-family:var(--mono);font-size:.52rem;text-transform:uppercase;letter-spacing:.06em;color:var(--gold-bright);border:1px solid var(--border-strong);border-radius:100px;padding:.15rem .42rem;white-space:nowrap}.rp-command-card p{font-size:.64rem;line-height:1.5;color:var(--muted);min-height:2.9em}
+.rp-command-code{position:relative;min-height:86px;padding:.68rem .72rem;border:1px solid rgba(255,224,151,.1);border-radius:11px;background:#050504;overflow:auto}.rp-command-code code{display:block;font-family:var(--mono);font-size:.59rem;line-height:1.55;color:#f2dfab;white-space:pre-wrap;overflow-wrap:anywhere}.rp-command-actions{display:flex;gap:.4rem;align-items:center;margin-top:auto}.rp-command-actions .rp-btn:first-child{flex:1}.rp-command-empty{grid-column:1/-1;padding:2rem;text-align:center;color:var(--muted);border:1px dashed var(--glass-border);border-radius:16px}
+.rp-command-custom{display:grid;grid-template-columns:1fr 1fr;gap:.65rem;padding:.9rem;border:1px solid var(--glass-border);border-radius:16px;background:var(--panel-2)}.rp-command-custom h4,.rp-command-custom .wide{grid-column:1/-1}.rp-command-custom h4{font-family:var(--mono);font-size:.72rem;color:var(--gold-bright)}.rp-command-custom textarea{min-height:92px;resize:vertical}.rp-command-note{font-size:.61rem;color:var(--muted)}
+@media(max-width:800px){.rp-command-env{grid-template-columns:1fr 1fr}.rp-command-grid{grid-template-columns:1fr}}@media(max-width:540px){.rp-command-env,.rp-command-custom{grid-template-columns:1fr}.rp-command-custom h4,.rp-command-custom .wide{grid-column:auto}}
 .rp-fleet-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(290px,1fr));gap:0.7rem;padding:0;}
 .rp-fleet-card{position:relative;}
 .rp-fleet-card .spark{margin-top:0.5rem;height:36px;}
@@ -830,6 +840,7 @@ button.act:disabled{opacity:0.5;cursor:default;}
     <button class="rp-subtab" data-sub="audit" id="rpsbtn-audit" role="tab" aria-selected="false">Audit Log</button>
     <button class="rp-subtab" data-sub="fleet" id="rpsbtn-fleet" role="tab" aria-selected="false">Fleet</button>
     <button class="rp-subtab" data-sub="config" id="rpsbtn-config" role="tab" aria-selected="false">Characters &amp; Voice</button>
+    <button class="rp-subtab" data-sub="commands" id="rpsbtn-commands" role="tab" aria-selected="false">Commands</button>
     <button class="rp-subtab" data-sub="setup" id="rpsbtn-setup" role="tab" aria-selected="false">Setup</button>
   </div>
@@ -896,7 +907,7 @@ button.act:disabled{opacity:0.5;cursor:default;}
             <div class="rp-call-device"><label>Camera</label><select id="rp-call-cam-device"><option value="">system default</option></select></div>
             <div class="rp-call-device"><label>Speaker output</label><select id="rp-call-speaker-device"><option value="">system default</option></select></div>
             <div class="rp-call-device-note" id="rp-call-device-note">Enable media access to reveal the actual microphone, camera, and speaker names available to this browser.</div>
-            <div class="rp-call-device-actions"><button class="rp-btn primary" id="rp-call-refresh-devices">Enable &amp; scan</button><button class="rp-btn" id="rp-call-test-mic">Test microphone</button></div>
+            <div class="rp-call-device-actions"><button class="rp-btn primary" id="rp-call-refresh-devices">Enable media access</button><button class="rp-btn" id="rp-call-test-mic">Test microphone</button></div>
           </div>
         </aside>
         <main class="rp-call-stage">
@@ -1071,7 +1082,7 @@ button.act:disabled{opacity:0.5;cursor:default;}
   </div>
   <!-- ═══ Setup ═══ -->
-  <div class="rp-sub" id="rp-sub-setup">
+  <div class="rp-sub" id="rp-sub-setup">
     <!-- Add LiveKit server -->
     <div class="rp-form" id="rp-addserver">
       <h3>Add LiveKit server</h3>
@@ -1131,6 +1142,38 @@ button.act:disabled{opacity:0.5;cursor:default;}
   </div>
+  <!-- Command sheet -->
+  <div class="rp-sub" id="rp-sub-commands">
+    <div class="rp-command-shell">
+      <div class="rp-config-hero">
+        <div><h3>RoboPark Command Sheet</h3><p>Production one-liners for the hub, LAN and Tailscale robots, health checks, recovery, Docker, LiveKit, and package operations. Edit the environment once; every generated command below updates immediately.</p></div>
+        <div class="rp-config-hero-actions"><button class="rp-btn" id="rp-command-reset">Reset environment</button><button class="rp-btn primary" id="rp-command-copy-all">Copy visible commands</button></div>
+      </div>
+      <div class="rp-command-env">
+        <div class="rp-field"><label>Hub LAN IP</label><input id="rp-command-lan" value="192.168.1.12" spellcheck="false"></div>
+        <div class="rp-field"><label>Hub Tailscale IP / DNS</label><input id="rp-command-tail" value="100.84.147.24" spellcheck="false"></div>
+        <div class="rp-field"><label>Site</label><input id="rp-command-site" value="Tel Aviv"></div>
+        <div class="rp-field"><label>Robot name</label><input id="rp-command-robot" value="bmw" spellcheck="false"></div>
+        <div class="rp-field"><label>Enrollment token</label><input id="rp-command-enrollment" placeholder="paste robot enrollment token" spellcheck="false"></div>
+        <div class="rp-field"><label>Mesh token</label><input id="rp-command-token" spellcheck="false"></div>
+      </div>
+      <div class="rp-command-toolbar">
+        <input type="search" id="rp-command-search" placeholder="Search setup, logs, camera, Docker, LiveKit, npm...">
+        <select id="rp-command-category"><option value="">All categories</option><option>Provision</option><option>Health</option><option>Recovery</option><option>Media</option><option>Packages</option><option>Custom</option></select>
+        <span class="rp-command-note" id="rp-command-count"></span>
+      </div>
+      <div class="rp-command-grid" id="rp-command-grid"></div>
+      <form class="rp-command-custom" id="rp-command-custom-form">
+        <h4>Add a persistent command</h4>
+        <div class="rp-field"><label>Title</label><input id="rp-command-custom-title" required placeholder="Restart camera service"></div>
+        <div class="rp-field"><label>Category</label><input id="rp-command-custom-category" value="Custom" placeholder="Custom"></div>
+        <div class="rp-field wide"><label>Simple explanation</label><input id="rp-command-custom-description" placeholder="When to use this and what success looks like"></div>
+        <div class="rp-field wide"><label>Command</label><textarea id="rp-command-custom-command" required spellcheck="false" placeholder="Paste a safe command or one-liner"></textarea></div>
+        <div class="wide"><button class="rp-btn primary" type="submit">Save command to this browser</button> <span class="rp-command-note">Custom commands persist in localStorage on this operator browser.</span></div>
+      </form>
+    </div>
+  </div>
   <!-- Character + voice management -->
   <div class="rp-sub" id="rp-sub-config">
     <div class="rp-config-workspace" id="rp-templates">
@@ -1178,8 +1221,14 @@ button.act:disabled{opacity:0.5;cursor:default;}
 <script>
 (function(){
-  var TOKEN = new URLSearchParams(location.search).get('token') || '';
-  var QS = TOKEN ? ('?token=' + encodeURIComponent(TOKEN)) : '';
+  var TOKEN = new URLSearchParams(location.search).get('token') || '';
+  var QS = TOKEN ? ('?token=' + encodeURIComponent(TOKEN)) : '';
+  var UI_BUILD=(document.querySelector('meta[name="robopark-ui-build"]')||{}).content||'unknown';
+  fetch('/fed/ui-build'+QS,{cache:'no-store'}).then(function(r){return r.ok?r.json():null;}).then(function(info){
+    if(!info||!info.build||info.build===UI_BUILD)return;
+    var key='rp-ui-reload-'+info.build;if(sessionStorage.getItem(key))return;sessionStorage.setItem(key,'1');
+    var url=new URL(location.href);url.searchParams.set('ui',info.build);location.replace(url.toString());
+  }).catch(function(){});
   var selfId = null, selected = null, lastSeq = -1, everOk = false;
   var rpReadOnly = false, pmBusy = false;
   var lastSchedulerPollAt = 0;     // updated by pollRobopark() on every successful /api/telemetry fetch
@@ -1775,7 +1824,9 @@ button.act:disabled{opacity:0.5;cursor:default;}
     $('pane-fleet').classList.toggle('active', name==='fleet');
     $('pane-park').classList.toggle('active', name==='park');
     $('pane-robopark').classList.toggle('active', name==='robopark');
-    if (location.hash.replace('#','') !== name) { try{ history.replaceState(null,'','#'+name); }catch(e){} }
+    var currentHash=location.hash.replace('#','');
+    var keepRpSubroute=name==='robopark' && currentHash.indexOf('robopark/')===0;
+    if (!keepRpSubroute && currentHash !== name) { try{ history.replaceState(null,'','#'+name); }catch(e){} }
     if (name==='robopark'){
       pollRobopark();
       initRpSubTabs();
@@ -1786,11 +1837,12 @@ button.act:disabled{opacity:0.5;cursor:default;}
   var fleetSessionsBtn=$('fleet-open-sessions'); if(fleetSessionsBtn) fleetSessionsBtn.addEventListener('click',function(){selectTab('robopark');setRpSubTab('live');});
   var fleetIncidentsBtn=$('fleet-open-incidents'); if(fleetIncidentsBtn) fleetIncidentsBtn.addEventListener('click',function(){selectTab('robopark');setRpSubTab('incidents');});
   var fleetRefreshBtn=$('fleet-refresh'); if(fleetRefreshBtn) fleetRefreshBtn.addEventListener('click',function(){poll();pollRobopark();});
-  var initHash = location.hash.replace('#','');
-  // Defer tab init until Park module is defined (same outer IIFE, later in source).
-  function initTab(){
-    if (initHash==='robopark'||initHash==='park') selectTab(initHash);
-  }
+  var initHash = location.hash.replace('#','');
+  // Defer tab init until Park module is defined (same outer IIFE, later in source).
+  function initTab(){
+    if (initHash==='robopark'||initHash.indexOf('robopark/')===0) selectTab('robopark');
+    else if(initHash==='park') selectTab('park');
+  }
   // initTab() is called at the very bottom of this IIFE, after Park is assigned.
   function robotsFrom(d){
@@ -2542,7 +2594,74 @@ button.act:disabled{opacity:0.5;cursor:default;}
   }
   // ── Sub-tab routing ──
-  var rpSubTab = 'overview';
+  // Command sheet: generate production commands from one saved environment.
+  var RP_COMMAND_ENV_KEY='rp-command-env-v1';
+  var RP_CUSTOM_COMMANDS_KEY='rp-custom-commands-v1';
+  var rpVisibleCommands=[];
+  function rpCommandDefaults(){return {lan:'192.168.1.12',tail:'100.84.147.24',site:'Tel Aviv',robot:'bmw',enrollment:'',token:TOKEN};}
+  function rpLoadStoredJson(key,fallback){try{var value=JSON.parse(localStorage.getItem(key)||'null');return value&&typeof value==='object'?value:fallback;}catch(e){return fallback;}}
+  function rpCommandEnv(){
+    var d=rpCommandDefaults(),s=rpLoadStoredJson(RP_COMMAND_ENV_KEY,{});
+    function value(name){var input=$('rp-command-'+name),raw=input?input.value:(s[name]!=null?s[name]:d[name]);return String(raw==null?'':raw).trim();}
+    return {lan:value('lan'),tail:value('tail'),site:value('site'),robot:value('robot'),enrollment:value('enrollment'),token:value('token')};
+  }
+  function rpSaveCommandEnv(){try{localStorage.setItem(RP_COMMAND_ENV_KEY,JSON.stringify(rpCommandEnv()));}catch(e){}}
+  function rpShellArg(value){var text=String(value||'');return /^[A-Za-z0-9._:\/-]+$/.test(text)?text:'"'+text.replace(/"/g,'\\"')+'"';}
+  function rpCommandCatalog(){
+    var e=rpCommandEnv(),lan='http://'+e.lan,tail='http://'+e.tail,enroll=e.enrollment?' --enrollment-token '+rpShellArg(e.enrollment):'';
+    return [
+      {id:'hub-up',category:'Provision',title:'Start production hub and full dashboard',description:'Run elevated on livekit-1. Starts the mesh hub, full Park control center, scheduler proxy, LAN discovery, supervision, and updates.',command:'infinicode serve --hub --name livekit-1 --port 47913 --token '+rpShellArg(e.token)+' --lan --dashboard --scheduler-url http://127.0.0.1:8080 --auto-update --supervised'},
+      {id:'robot-lan',category:'Provision',title:'Provision LAN robot',description:'One command for a Linux robot on the hub LAN. Installs the supervised mesh, RoboVision, and preview runtime.',command:'sudo robopark setup --robot --name '+rpShellArg(e.robot)+' --site '+rpShellArg(e.site)+' --hub-url '+lan+':47913 --token '+rpShellArg(e.token)+' --scheduler-port 8080'+enroll+' --port 47913 --lan --start --auto-start --yes'},
+      {id:'robot-tail',category:'Provision',title:'Provision Tailscale robot',description:'One command for a Windows or Linux robot reaching the hub through Tailscale.',command:'robopark setup --robot --name '+rpShellArg(e.robot)+' --site '+rpShellArg(e.site)+' --hub-url '+tail+':47913 --token '+rpShellArg(e.token)+' --scheduler-port 8080'+enroll+' --port 47913 --tailscale --start --auto-start --yes'},
+      {id:'operator-tail',category:'Provision',title:'Connect operator MCP over Tailscale',description:'Connects an operator workstation and coding agents to the production mesh.',command:'infinicode mcp --lan --tailscale --seed '+tail+':47913 --name dev-laptop --token '+rpShellArg(e.token)+' --mesh-port 47913'},
+      {id:'hub-ui',category:'Health',title:'Open full production control center',description:'Opens the full Park dashboard through the hub Tailscale address.',command:'Start-Process "'+tail+':47913/?token='+encodeURIComponent(e.token)+'#park"'},
+      {id:'hub-build',category:'Health',title:'Verify current hub UI',description:'Shows the installed version and dashboard build marker after npm update or restart.',command:'infinicode --version; Invoke-RestMethod "http://127.0.0.1:47913/fed/ui-build?token='+encodeURIComponent(e.token)+'"'},
+      {id:'hub-ports',category:'Health',title:'Inspect hub ports on Windows',description:'Lists processes owning the control center, scheduler, and LiveKit ports without changing them.',command:'Get-NetTCPConnection -State Listen -ErrorAction SilentlyContinue | Where-Object { $_.LocalPort -in 47913,8080,7880,7881,7882,7883 } | Sort-Object LocalPort | Format-Table LocalAddress,LocalPort,OwningProcess -AutoSize'},
+      {id:'scheduler-health',category:'Health',title:'Check scheduler through hub',description:'Confirms the hub proxy can reach the scheduler and return robot inventory.',command:'Invoke-RestMethod "'+tail+':47913/robopark/api/robots?token='+encodeURIComponent(e.token)+'" | ConvertTo-Json -Depth 6'},
+      {id:'mesh-status',category:'Health',title:'Check mesh nodes',description:'Lists connected hub, robot, and operator nodes.',command:'Invoke-RestMethod "'+tail+':47913/fed/status?token='+encodeURIComponent(e.token)+'" | ConvertTo-Json -Depth 6'},
+      {id:'pi-runtime',category:'Health',title:'Follow robot runtime logs',description:'Live systemd logs for the selected robot unified runtime.',command:'sudo journalctl -u robopark-robot-runtime-'+e.robot+'.service -f'},
+      {id:'pi-ports',category:'Health',title:'Inspect robot service ports',description:'Checks mesh, camera, motion webhook, and audio listeners on a Linux robot.',command:"sudo ss -ltnp | grep -E ':(47913|5000|5057|8000)'"},
+      {id:'camera-inventory',category:'Media',title:'Read RoboVision media inventory',description:'Returns the real cameras, microphones, and speakers detected by RoboVision.',command:'curl -s http://127.0.0.1:5000/api/media/inventory'},
+      {id:'audio-inventory',category:'Media',title:'Read RoboVision audio devices',description:'Returns the microphone and speaker inventory used by the robot audio server.',command:'curl -s http://127.0.0.1:8000/devices'},
+      {id:'camera-devices',category:'Media',title:'List valid Linux capture devices',description:'Shows V4L2 devices and capabilities so metadata-only nodes are not selected as cameras.',command:'v4l2-ctl --list-devices; for d in /dev/video*; do echo "--- $d"; v4l2-ctl -d "$d" --all 2>/dev/null | grep -E "Card type|Video Capture|Device Caps"; done'},
+      {id:'camera-preview',category:'Media',title:'Open direct RoboVision camera feed',description:'Opens the robot MJPEG feed locally for camera-only diagnosis.',command:'xdg-open http://127.0.0.1:5000/video_feed'},
+      {id:'robot-restart',category:'Recovery',title:'Clean restart selected robot',description:'Stops stale supervised processes, then recreates the complete LAN runtime.',command:'sudo robopark stop && sudo robopark setup --robot --name '+rpShellArg(e.robot)+' --site '+rpShellArg(e.site)+' --hub-url '+lan+':47913 --token '+rpShellArg(e.token)+' --scheduler-port 8080'+enroll+' --port 47913 --lan --start --auto-start --yes'},
+      {id:'robot-status',category:'Recovery',title:'Inspect robot service failure',description:'Shows service state and the latest 150 log lines after a failed start.',command:'sudo systemctl status robopark-robot-runtime-'+e.robot+'.service --no-pager; sudo journalctl -u robopark-robot-runtime-'+e.robot+'.service -n 150 --no-pager'},
+      {id:'docker-health',category:'Health',title:'Inspect Docker and LiveKit containers',description:'Shows container state, health, ports, and names on the hub.',command:'docker ps -a --format "table {{.Names}}\\t{{.Status}}\\t{{.Ports}}\\t{{.Image}}"'},
+      {id:'docker-restart',category:'Recovery',title:'Restart Docker Desktop service',description:'Run from elevated PowerShell only when Docker Desktop is stuck starting.',command:'Restart-Service com.docker.service; Start-Process -FilePath "C:\\Program Files\\Docker\\Docker\\Docker Desktop.exe"'},
+      {id:'tailscale-status',category:'Health',title:'Check Tailscale routes and Serve',description:'Confirms the node is connected and shows any active Serve proxy.',command:'tailscale status; tailscale serve status'},
+      {id:'npm-version',category:'Packages',title:'Check installed and published versions',description:'Compares this device with the npm latest tag.',command:'infinicode --version; npm view infinicode version'},
+      {id:'npm-update',category:'Packages',title:'Update InfiniCode and RoboPark',description:'Installs the current published production package globally.',command:'npm install -g infinicode@latest --force'},
+      {id:'npm-cache',category:'Packages',title:'Repair npm metadata cache',description:'Use when a new version returns ETARGET. Verify metadata before clearing anything.',command:'npm cache verify; npm view infinicode dist-tags --json'}
+    ];
+  }
+  function rpCustomCommands(){var list=rpLoadStoredJson(RP_CUSTOM_COMMANDS_KEY,[]);return Array.isArray(list)?list:[];}
+  function rpSaveCustomCommands(list){try{localStorage.setItem(RP_CUSTOM_COMMANDS_KEY,JSON.stringify(list));}catch(e){showOut('Could not save custom command: '+e.message);}}
+  function rpLegacyCopy(value){var area=document.createElement('textarea');area.value=value;area.style.position='fixed';area.style.opacity='0';document.body.appendChild(area);area.select();try{document.execCommand('copy');showOut('command copied');}catch(e){showOut('Copy failed: select the command manually');}area.remove();}
+  function rpCopyCommand(text){var value=String(text||'');if(navigator.clipboard&&window.isSecureContext){navigator.clipboard.writeText(value).then(function(){showOut('command copied');}).catch(function(){rpLegacyCopy(value);});}else rpLegacyCopy(value);}
+  function renderCommandSheet(){
+    var grid=$('rp-command-grid');if(!grid)return;
+    var search=String(($('rp-command-search')||{}).value||'').toLowerCase().trim(),category=String(($('rp-command-category')||{}).value||'').toLowerCase();
+    var custom=rpCustomCommands().map(function(x){return {id:String(x.id),category:String(x.category||'Custom'),title:String(x.title||'Custom command'),description:String(x.description||''),command:String(x.command||''),custom:true};});
+    rpVisibleCommands=rpCommandCatalog().concat(custom).filter(function(x){if(category&&x.category.toLowerCase()!==category)return false;return !search||(x.title+' '+x.category+' '+x.description+' '+x.command).toLowerCase().indexOf(search)>=0;});
+    var count=$('rp-command-count');if(count)count.textContent=rpVisibleCommands.length+' command'+(rpVisibleCommands.length===1?'':'s');
+    if(!rpVisibleCommands.length){grid.innerHTML='<div class="rp-command-empty">No commands match this filter.</div>';return;}
+    grid.innerHTML=rpVisibleCommands.map(function(x){return '<article class="rp-command-card"><div class="rp-command-head"><b>'+esc(x.title)+'</b><span class="rp-command-tag">'+esc(x.category)+'</span></div><p>'+esc(x.description)+'</p><pre class="rp-command-code"><code>'+esc(x.command)+'</code></pre><div class="rp-command-actions"><button class="rp-btn primary" data-command-copy="'+esc(x.id)+'">Copy command</button>'+(x.custom?'<button class="rp-btn danger" data-command-delete="'+esc(x.id)+'">Delete</button>':'')+'</div></article>';}).join('');
+  }
+  function initCommandSheet(){
+    var fields=['lan','tail','site','robot','enrollment','token'],defaults=rpCommandDefaults(),saved=rpLoadStoredJson(RP_COMMAND_ENV_KEY,{});
+    fields.forEach(function(name){var input=$('rp-command-'+name);if(!input)return;input.value=saved[name]!=null?saved[name]:defaults[name];input.addEventListener('input',function(){rpSaveCommandEnv();renderCommandSheet();});});
+    var search=$('rp-command-search'),category=$('rp-command-category'),grid=$('rp-command-grid'),reset=$('rp-command-reset'),copyAll=$('rp-command-copy-all'),form=$('rp-command-custom-form');
+    if(search)search.addEventListener('input',renderCommandSheet);if(category)category.addEventListener('change',renderCommandSheet);
+    if(reset)reset.addEventListener('click',function(){try{localStorage.removeItem(RP_COMMAND_ENV_KEY);}catch(e){}fields.forEach(function(name){var input=$('rp-command-'+name);if(input)input.value=defaults[name];});renderCommandSheet();showOut('command environment reset');});
+    if(copyAll)copyAll.addEventListener('click',function(){rpCopyCommand(rpVisibleCommands.map(function(x){return '# '+x.title+'\\n'+x.command;}).join('\\n\\n'));});
+    if(grid)grid.addEventListener('click',function(ev){var copy=ev.target.closest('[data-command-copy]'),del=ev.target.closest('[data-command-delete]');if(copy){var id=copy.getAttribute('data-command-copy'),item=rpVisibleCommands.find(function(x){return x.id===id;});if(item)rpCopyCommand(item.command);}if(del){var removeId=del.getAttribute('data-command-delete');rpSaveCustomCommands(rpCustomCommands().filter(function(x){return String(x.id)!==removeId;}));renderCommandSheet();showOut('custom command deleted');}});
+    if(form)form.addEventListener('submit',function(ev){ev.preventDefault();var title=$('rp-command-custom-title').value.trim(),command=$('rp-command-custom-command').value.trim();if(!title||!command)return;var list=rpCustomCommands();list.push({id:'custom-'+Date.now(),title:title,category:$('rp-command-custom-category').value.trim()||'Custom',description:$('rp-command-custom-description').value.trim(),command:command});rpSaveCustomCommands(list);$('rp-command-custom-title').value='';$('rp-command-custom-description').value='';$('rp-command-custom-command').value='';renderCommandSheet();showOut('custom command saved in this browser');});
+    renderCommandSheet();
+  }
+  initCommandSheet();
+  var rpSubTab = 'overview';
   var rpIntervals = {};      // sub-tab name -> setInterval handle
   var rpHistoryAll = [];      // full recent-session list (we paginate client-side)
   function setRpSubTab(name){
@@ -2561,7 +2680,7 @@ button.act:disabled{opacity:0.5;cursor:default;}
       s.classList.toggle('active', s.id==='rp-sub-'+name);
     }
     // stop every sub-tab interval, then start only the active one
-    var names = ['overview','incidents','live','voice','history','audit','fleet','config','setup'];
+    var names = ['overview','incidents','live','voice','history','audit','fleet','config','commands','setup'];
     for(var k=0;k<names.length;k++){
       var n=names[k];
       if(rpIntervals[n]){ clearInterval(rpIntervals[n]); rpIntervals[n]=null; }
@@ -2572,7 +2691,8 @@ button.act:disabled{opacity:0.5;cursor:default;}
     if(name==='voice'){ refreshVoiceCallOptions(); }
     if(name==='history'){ rpHistoryPage=0; pollHistory(); }
     if(name==='audit'){ pollAuditLog(); rpIntervals.audit = setInterval(pollAuditLog, 6000); }
-    if(name==='fleet'){ pollFleet(); rpIntervals.fleet = setInterval(pollFleet, 5000); }
+    if(name==='fleet'){ pollFleet(); rpIntervals.fleet = setInterval(pollFleet, 5000); }
+    if(name==='commands'){ renderCommandSheet(); }
     if(name==='setup'){ pollSettings(); loadCharacterPresets(); loadVoiceStacks(); pollRuntimeHealth(); }
     // remember last sub-tab in URL hash
     try{ history.replaceState(null,'','#robopark/'+name); }catch(e){}
@@ -2588,7 +2708,7 @@ button.act:disabled{opacity:0.5;cursor:default;}
     var h=String(location.hash||'').replace('#','');
     var m = h.match(/^robopark\\/(.+)$/);
     var initial = (m && m[1]) ? m[1] : 'overview';
-    if(['overview','incidents','live','voice','history','audit','fleet','config','setup'].indexOf(initial)<0) initial='overview';
+    if(['overview','incidents','live','voice','history','audit','fleet','config','commands','setup'].indexOf(initial)<0) initial='overview';
     setRpSubTab(initial);
   }
@@ -3862,7 +3982,7 @@ button.act:disabled{opacity:0.5;cursor:default;}
     var drawerId=null, camRAF=null, meterRAF=null, camAbort=null, drawerTimer=null, pipelineTimer=null, deviceSelectorsReady=false;
     var previewOn=false, previewTimer=null;   // on-demand operator camera preview
     var visionOn=false;   // RoboVisionAI_PI overlay feed (direct MJPEG, not LiveKit)
-    var lkRoom=null, micAnalyser=null, audioCtx=null, lkAudioEls=[];
+    var lkRoom=null, micAnalyser=null, audioCtx=null, lkAudioEls=[], micMonitorConnecting=false, micMonitorState='no active conversation session', micMonitorAudible=false, micMonitorVolume=0.8;
     var imgs={}; // preloaded robot concept avatars
     var TW=44, TH=22, PARK_W=15, PARK_D=8;
     // Plaza footprint and parking lot (upper-right corner of the plaza)
@@ -5951,8 +6071,10 @@ button.act:disabled{opacity:0.5;cursor:default;}
       if(camAbort){ try{camAbort.abort();}catch(e){} camAbort=null; }
       if(drawerTimer){ clearInterval(drawerTimer); drawerTimer=null; }
       if(pipelineTimer){ clearInterval(pipelineTimer); pipelineTimer=null; }
-      if(lkRoom){ try{ lkRoom.disconnect(); }catch(e){} lkRoom=null; }
-      micAnalyser=null;
+      if(lkRoom){ try{ lkRoom.disconnect(); }catch(e){} lkRoom=null; }
+      lkAudioEls.forEach(function(el){try{el.pause();el.remove();}catch(e){}});lkAudioEls=[];
+      micMonitorAudible=false;micMonitorConnecting=false;micMonitorState='no active conversation session';
+      micAnalyser=null;
     }
     // ── setup flow for unjoined park pads ──
@@ -6132,9 +6254,12 @@ button.act:disabled{opacity:0.5;cursor:default;}
       }
       fill('pk-video-device', video, device.video_device||'auto');
       fill('pk-audio-input', input, device.audio_device||'default');
-      fill('pk-audio-output', output, device.audio_output_device||'default');
-      var greetings=$('pk-greeting-phrases');
-      if(greetings && document.activeElement!==greetings) greetings.value=(device.greeting_phrases||[]).join(String.fromCharCode(10));
+      fill('pk-audio-output', output, device.audio_output_device||'default');
+      var selectedOutput=$('pk-audio-output'),selectedLabel=$('pk-spk-selected');
+      if(selectedLabel&&selectedOutput){var selectedOption=selectedOutput.options&&selectedOutput.selectedIndex>=0?selectedOutput.options[selectedOutput.selectedIndex]:null;selectedLabel.textContent=selectedOption?String(selectedOption.textContent||selectedOption.value):String(selectedOutput.value||'default');}
+      var greetings=$('pk-greeting-phrases');
+      if(greetings && document.activeElement!==greetings) greetings.value=(device.greeting_phrases||[]).join(String.fromCharCode(10));
+      var testPhrase=$('pk-spk-phrase');if(testPhrase&&document.activeElement!==testPhrase&&device.greeting_phrases&&device.greeting_phrases.length)testPhrase.value=device.greeting_phrases[0];
       var note=$('pk-device-note');
       if(note){
         if(!device.id && n && n.connected){
@@ -6522,13 +6647,17 @@ button.act:disabled{opacity:0.5;cursor:default;}
           + '<div class="pk-ctl" style="margin-top:0.55rem"><button class="rp-btn primary" id="pk-pipeline-start">Start full test</button><button class="rp-btn danger" id="pk-pipeline-stop">Stop conversation</button></div>'
           + '<div class="pk-note">Starts the camera, sends the same motion trigger used in production, and follows every reported stage remotely.</div>'
           + '<div class="pk-pipeline" id="pk-pipeline"></div>')
-        + sect('🎙 microphone','<div class="pk-meter"><span class="lab">input</span><div class="pk-bars" id="pk-micbars"></div><span class="pk-val" id="pk-micval">—</span></div><div class="pk-note" id="pk-micstate">awaiting robot audio plugin</div>')
+        + sect('🎙 microphone','<div class="pk-meter"><span class="lab">input</span><div class="pk-bars" id="pk-micbars"></div><span class="pk-val" id="pk-micval">—</span></div><div class="pk-note" id="pk-micstate">awaiting robot audio plugin</div><div class="pk-ctl" style="margin-top:.5rem"><button class="rp-btn" id="pk-mic-listen">Listen in browser</button><label class="pk-note" style="display:flex;align-items:center;gap:.35rem;margin:0">volume <input id="pk-mic-volume" type="range" min="0" max="100" value="80" style="width:90px"></label></div><div class="pk-note" id="pk-mic-listen-note">Muted by default. Use headphones to prevent acoustic feedback.</div>')
         + sect('🔊 speaker','<canvas class="pk-wave" id="pk-spkwave" width="360" height="32"></canvas><div class="pk-meter"><span class="lab">output</span><div class="pk-bars" id="pk-spkbars"></div><span class="pk-val" id="pk-spkval">—</span></div><div class="pk-note" id="pk-spkstate">TTS plays on the robot speaker — use “Test speaker” below to round-trip a tone and confirm the audio path</div>'
-          + '<div class="rp-form" id="pk-spk-test" style="grid-template-columns:1fr 1fr;gap:0.4rem;margin-top:0.55rem;padding:0.55rem;border-color:var(--border-strong);">'
-          +   '<div class="rp-field"><label>Frequency</label><select id="pk-spk-freq"><option value="500">500 Hz (low)</option><option value="1000" selected>1000 Hz (1 kHz reference)</option><option value="2000">2000 Hz (presence)</option><option value="3000">3000 Hz (clarity)</option></select></div>'
+          + '<div class="rp-form" id="pk-spk-test" style="grid-template-columns:1fr 1fr;gap:0.4rem;margin-top:0.55rem;padding:0.55rem;border-color:var(--border-strong);">'
+          +   '<div class="rp-field"><label>Test type</label><select id="pk-spk-mode"><option value="tts" selected>Cached character voice</option><option value="tone">Tone + mic round-trip</option></select></div>'
+          +   '<div class="rp-field"><label>Selected output</label><div class="pk-note" id="pk-spk-selected" style="margin:.45rem 0 0">loading device...</div></div>'
+          +   '<div class="rp-field" style="grid-column:1/-1"><label>Voice test phrase</label><input id="pk-spk-phrase" value="Hello, this is a RoboPark speaker test." maxlength="240"></div>'
+          +   '<div class="rp-field"><label>Frequency</label><select id="pk-spk-freq"><option value="500">500 Hz (low)</option><option value="1000" selected>1000 Hz (1 kHz reference)</option><option value="2000">2000 Hz (presence)</option><option value="3000">3000 Hz (clarity)</option></select></div>'
           +   '<div class="rp-field"><label>Duration</label><select id="pk-spk-dur"><option value="0.4">0.4 s</option><option value="0.6" selected>0.6 s</option><option value="1.0">1.0 s</option></select></div>'
           +   '<div style="grid-column:1/-1;display:flex;gap:0.4rem;align-items:center;">'
-          +     '<button class="rp-btn primary" id="pk-spk-runtest" data-robot="'+esc(schedId(n))+'">▶ Test speaker</button>'
+          +     '<button class="rp-btn primary" id="pk-spk-runtest" data-robot="'+esc(schedId(n))+'">Play cached voice</button>'
+          +     '<button class="rp-btn" id="pk-spk-tone">Quick tone</button>'
           +     '<span class="pk-note" id="pk-spk-test-stateline" style="margin:0">awaiting test</span>'
           +   '</div>'
           +   '<div style="grid-column:1/-1;" id="pk-spk-test-result"></div>'
@@ -6540,7 +6669,7 @@ button.act:disabled{opacity:0.5;cursor:default;}
           + sect('🩺 robot services','<div id="pk-svc-list" class="pk-svc-list"><div class="pk-note">waiting for supervisor report…</div></div><div class="pk-note" id="pk-svc-age" style="margin-top:0.35rem;"></div><div class="rp-field" style="margin-top:0.55rem;"><label>Quick run (on the robot, from packages/robopark/scheduler)</label><input id="pk-svc-clicmd" readonly value="python robot_supervisor.py"></div><button class="rp-btn" id="pk-svc-clicmd-copy" style="margin-top:0.35rem;">📋 Copy command</button>')
           + buildShellSection(schedId(n))
           + sect('🎭 character / voice','<div class="pk-note" id="pk-eff-note" style="margin-bottom:0.45rem;">loading effective config…</div><div class="rp-field"><label>Character preset</label><select class="rp-char" id="pk-eff-char" data-robot="'+esc(schedId(n))+'">'+effPresetOptions+'</select></div><div class="rp-field"><label>Voice stack</label><select class="rp-voice" id="pk-eff-voice" data-robot="'+esc(schedId(n))+'">'+effVoiceOptions+'</select></div><div class="rp-config-actions" style="margin-top:.45rem"><button class="rp-btn primary" id="pk-eff-save" data-robot="'+esc(schedId(n))+'">Apply to robot</button><button class="rp-btn" id="pk-edit-character">Edit character</button><button class="rp-btn" id="pk-edit-stack">Edit stack</button><button class="rp-btn" id="pk-new-stack">New stack</button></div>');
-         b.innerHTML += sect('Camera + audio devices','<div class="rp-field"><label>Search devices</label><input id="pk-device-search" placeholder="camera, USB, microphone, HDMI..." autocomplete="off"></div><div class="rp-field"><label>Camera input</label><select id="pk-video-device"></select></div><div class="rp-field"><label>Microphone input</label><select id="pk-audio-input"></select></div><div class="rp-field"><label>Speaker / output inventory</label><select id="pk-audio-output"></select></div><div class="rp-field"><label>Preset greeting phrases <span class="pk-note">one per line, cached per voice</span></label><textarea id="pk-greeting-phrases" rows="3" placeholder="Hi, I am Jaguar! / Welcome to RoboPark."></textarea></div><button class="rp-btn" id="pk-device-save" style="margin-top:0.35rem">Save device selection + greetings</button><div class="pk-note" id="pk-device-note">waiting for robot heartbeat inventory</div>');
+         b.innerHTML += sect('Camera + audio devices','<div class="rp-field"><label>Search devices</label><input id="pk-device-search" placeholder="camera, USB, microphone, HDMI..." autocomplete="off"></div><div class="rp-field"><label>Camera input</label><select id="pk-video-device"></select></div><div class="rp-field"><label>Microphone input</label><select id="pk-audio-input"></select></div><div class="rp-field"><label>Speaker / output inventory</label><select id="pk-audio-output"></select></div><button class="rp-btn primary" id="pk-device-test-speaker" style="margin-top:0.35rem">Test selected speaker now</button><div class="rp-field"><label>Preset greeting phrases <span class="pk-note">one per line, cached per voice</span></label><textarea id="pk-greeting-phrases" rows="3" placeholder="Hi, I am Jaguar! / Welcome to RoboPark."></textarea></div><button class="rp-btn" id="pk-device-save" style="margin-top:0.35rem">Save device selection + greetings</button><div class="pk-note" id="pk-device-note">waiting for robot heartbeat inventory</div>');
           // Put live hardware selection beside the camera and audio tests,
           // ahead of persona and service administration in the Park drawer.
           var deviceInput=$('pk-device-search'), deviceSection=deviceInput&&deviceInput.closest('.pk-sect');
@@ -6549,11 +6678,17 @@ button.act:disabled{opacity:0.5;cursor:default;}
           refreshDeviceSelectors(n);
          b.innerHTML += '<div class="pk-ctl" style="margin-top:0.5rem"><button class="rp-btn danger" id="pk-recover" data-robot="'+esc(n.name)+'">Recover robot</button><span class="pk-note" style="margin:0">clears stale sessions and queued triggers for this robot</span></div>';
          var deviceSearch=$('pk-device-search'); if(deviceSearch) deviceSearch.addEventListener('input', function(){ refreshDeviceSelectors(n); });
-         var deviceSave=$('pk-device-save'); if(deviceSave) deviceSave.addEventListener('click', function(){ saveDeviceSelectors(n); });
+         var deviceSave=$('pk-device-save'); if(deviceSave) deviceSave.addEventListener('click', function(){ saveDeviceSelectors(n); });
+         var outputSelect=$('pk-audio-output'); if(outputSelect) outputSelect.addEventListener('change', function(){ refreshDeviceSelectors(n); });
+         var micListen=$('pk-mic-listen');if(micListen)micListen.addEventListener('click',function(){setMicMonitorAudible(!micMonitorAudible);});
+         var micVolume=$('pk-mic-volume');if(micVolume)micVolume.addEventListener('input',function(){micMonitorVolume=Math.max(0,Math.min(1,Number(micVolume.value||80)/100));lkAudioEls.forEach(function(el){el.volume=micMonitorVolume;});});
          startCam(n); startMeters(n); loadEffectiveConfig(schedId(n)); refreshSupervisorPanel(n);
         _bindShellSection(n);
         _spkTestRenderHistory(schedId(n));
-        var runSpkTest = $('pk-spk-runtest'); if(runSpkTest) runSpkTest.addEventListener('click', function(){ if(rpReadOnly){ showOut('read-only node'); return; } runSpeakerTest(n); });
+        var runSpkTest = $('pk-spk-runtest'); if(runSpkTest) runSpkTest.addEventListener('click', function(){ if(rpReadOnly){ showOut('read-only node'); return; } runSpeakerTest(n); });
+        var runSpkTone = $('pk-spk-tone'); if(runSpkTone) runSpkTone.addEventListener('click', function(){ if(rpReadOnly){ showOut('read-only node'); return; } runSpeakerTest(n,'tone'); });
+        var quickSpkTest = $('pk-device-test-speaker'); if(quickSpkTest) quickSpkTest.addEventListener('click', function(){ if(rpReadOnly){ showOut('read-only node'); return; } runSpeakerTest(n,'tts'); });
+        var spkMode = $('pk-spk-mode'); if(spkMode) spkMode.addEventListener('change', function(){ if(runSpkTest) runSpkTest.textContent=spkMode.value==='tts'?'Play cached voice':'Run tone test'; });
         var gl=$('pk-golive');
         if(gl){
           gl.addEventListener('click', function(){ if(rpReadOnly){ showOut('read-only node'); return; } goLive(n); });
@@ -6716,6 +6851,7 @@ button.act:disabled{opacity:0.5;cursor:default;}
     function startCam(n){
       idleCam('connecting');
       tryVisionOverlay(n, true);
+      startMicMonitor(n);
       return;
       var note=$('pk-camnote');
       camAbort = ('AbortController' in window)?new AbortController():null;
@@ -6748,17 +6884,51 @@ button.act:disabled{opacity:0.5;cursor:default;}
       var res=$('pk-camres'); if(res) res.textContent = reason==='idle'?'idle':'—';
       var note=$('pk-camnote'); if(note) note.textContent = reason==='idle'?'the feed goes live automatically when the robot opens a session':msg;
     }
-    function attachLiveKit(info, n){
+    function selectedRobotMic(){var el=$('pk-audio-input');if(!el)return 'default';var option=el.options&&el.selectedIndex>=0?el.options[el.selectedIndex]:null;return option?String(option.textContent||option.value):String(el.value||'default');}
+    function selectedRobotOutput(){var el=$('pk-audio-output');if(!el)return 'default';var option=el.options&&el.selectedIndex>=0?el.options[el.selectedIndex]:null;return option?String(option.textContent||option.value):String(el.value||'default');}
+    function setMicMonitorAudible(enabled){
+      micMonitorAudible=!!enabled;
+      var btn=$('pk-mic-listen'),note=$('pk-mic-listen-note');
+      if(btn){btn.textContent=micMonitorAudible?'Mute browser monitor':'Listen in browser';btn.classList.toggle('primary',micMonitorAudible);}
+      if(note)note.textContent=micMonitorAudible?(lkAudioEls.length?'Robot mic is playing in this browser. Use headphones.':'Listening armed — waiting for the robot mic track.'):'Browser monitoring muted.';
+      lkAudioEls.forEach(function(el){
+        el.muted=!micMonitorAudible;el.volume=micMonitorVolume;
+        if(micMonitorAudible)el.play().catch(function(e){if(note)note.textContent='Browser blocked playback: '+e.message+' — press Listen again.';});
+      });
+    }
+    function startMicMonitor(n){
+      if(lkRoom||micMonitorConnecting)return;
+      micMonitorConnecting=true;
+      micMonitorState='checking active conversation session';
+      var state=$('pk-micstate');if(state)state.textContent='selected '+selectedRobotMic()+' · checking active session...';
+      fetch('/robopark/api/robots/'+encodeURIComponent(schedId(n))+'/stream'+QS,{cache:'no-store'})
+        .then(function(r){if(!r.ok)throw new Error('scheduler '+r.status);return r.json();})
+        .then(function(info){
+          micMonitorConnecting=false;
+          if(info&&info.active&&info.url&&info.token&&window.LivekitClient){micMonitorState='connecting to '+info.url;attachLiveKit(info,n,true);return;}
+          micMonitorState=info&&info.reason?String(info.reason).replace(/_/g,' '):'waiting for conversation session';
+          if(state)state.textContent='selected '+selectedRobotMic()+' · waiting for conversation session';
+        })
+        .catch(function(e){micMonitorConnecting=false;micMonitorState='monitor unavailable: '+e.message;if(state)state.textContent='selected '+selectedRobotMic()+' · '+micMonitorState;});
+    }
+    function attachLiveKit(info, n, audioOnly){
       var note=$('pk-camnote'), res=$('pk-camres');
       try{
         var LK=window.LivekitClient; lkRoom=new LK.Room();
         lkRoom.on(LK.RoomEvent.TrackSubscribed, function(track){
-          if(track.kind==='video'){
-            var el=track.attach(); el.setAttribute('playsinline',''); el.muted=true; el.autoplay=true;
+          if(track.kind==='video'){
+            if(audioOnly)return;
+            var el=track.attach(); el.setAttribute('playsinline',''); el.muted=true; el.autoplay=true;
             var cv=$('pk-camcv'); if(cv&&cv.parentNode) cv.parentNode.replaceChild(el, cv);
             if(res) res.textContent='LIVE'; if(note) note.textContent='live camera via LiveKit · '+esc(info.room);
-          } else if(track.kind==='audio'){
-            hookMicAnalyser(track);
+          } else if(track.kind==='audio'){
+            // Listen only to the robot's published microphone. Agent TTS may
+            // also be present in the room, but hearing that directly would
+            // bypass the physical speaker -> microphone round-trip test.
+            if(track.name&&track.name!=='microphone')return;
+            hookMicAnalyser(track);
+            micMonitorState='live track published';
+            var micState=$('pk-micstate');if(micState)micState.textContent='selected '+selectedRobotMic()+' · live track published';
             // Muted by default: this is the camera-preview panel, running on
             // the SAME physical device as the robot in local testing. Auto-
             // playing the subscribed track (robot mic, or later the agent's
@@ -6767,16 +6937,17 @@ button.act:disabled{opacity:0.5;cursor:default;}
             // that drowns out the actual conversation. The VU meter above
             // (hookMicAnalyser) taps the raw track directly and works fine
             // muted.
-            var audio=track.attach(); audio.autoplay=true; audio.controls=false; audio.muted=true; audio.style.display='none'; document.body.appendChild(audio); lkAudioEls.push(audio);
-            audio.play().catch(function(){});
+            var audio=track.attach(); audio.autoplay=true; audio.controls=false; audio.muted=!micMonitorAudible; audio.volume=micMonitorVolume;audio.style.display='none'; document.body.appendChild(audio); lkAudioEls.push(audio);
+            var listenNote=$('pk-mic-listen-note');if(listenNote&&micMonitorAudible)listenNote.textContent='Robot mic is playing in this browser. Use headphones.';
+            audio.play().catch(function(){});
           }
         });
-        lkRoom.on(LK.RoomEvent.Disconnected, function(){ micAnalyser=null; if(note) note.textContent='session ended'; if(res) res.textContent='—'; });
+        lkRoom.on(LK.RoomEvent.Disconnected, function(){lkRoom=null;micAnalyser=null;micMonitorConnecting=false;micMonitorState='session ended';var micState=$('pk-micstate');if(micState)micState.textContent='selected '+selectedRobotMic()+' · session ended';if(!audioOnly&&note)note.textContent='session ended';if(!audioOnly&&res)res.textContent='—';});
         var livekitUrl=info.url;
         if((location.hostname==='localhost'||location.hostname==='127.0.0.1') && /^ws:\\/\\/localhost(?::|\\/)/i.test(livekitUrl)) livekitUrl=livekitUrl.replace(/^ws:\\/\\/localhost/i,'ws://127.0.0.1');
-        lkRoom.connect(livekitUrl, info.token).then(function(){ if(note) note.textContent='connected · waiting for camera track…'; })
-          .catch(function(e){ idleCam('unreachable'); if(note) note.textContent='LiveKit connection failed'; if(window.console) console.error('RoboPark LiveKit connection failed',e); });
-      }catch(e){ idleCam('no-sdk'); }
+        lkRoom.connect(livekitUrl, info.token).then(function(){micMonitorState='connected, waiting for robot mic publication';var micState=$('pk-micstate');if(micState)micState.textContent='selected '+selectedRobotMic()+' · '+micMonitorState;if(!audioOnly&&note)note.textContent='connected · waiting for camera track…';})
+          .catch(function(e){lkRoom=null;micMonitorConnecting=false;micMonitorState='LiveKit connection failed: '+(e&&e.message?e.message:'unreachable');var micState=$('pk-micstate');if(micState)micState.textContent='selected '+selectedRobotMic()+' · '+micMonitorState;if(!audioOnly){idleCam('unreachable');if(note)note.textContent='LiveKit connection failed';}if(window.console)console.error('RoboPark LiveKit connection failed',e);});
+      }catch(e){ micMonitorConnecting=false;micMonitorState='LiveKit SDK unavailable';idleCam('no-sdk'); }
     }
     // Real mic level: tap the robot's subscribed 'mic' audio track with a Web
     // Audio analyser and read RMS in startMeters (no invented levels).
@@ -6817,7 +6988,7 @@ button.act:disabled{opacity:0.5;cursor:default;}
         if(micAnalyser){ micAnalyser.getByteTimeDomainData(buf); var sum=0; for(var q=0;q<buf.length;q++){ var v=(buf[q]-128)/128; sum+=v*v; } lvl=Math.min(1, Math.sqrt(sum/buf.length)*3.4); }
         for(var i=0;i<mi.length;i++){ var on=i<lvl*mi.length; mi[i].style.height=(3+(on?lvl*13:0))+'px'; mi[i].style.background=on?(i<mi.length*0.7?'var(--ok)':i<mi.length*0.9?'var(--warn)':'var(--bad)'):'var(--glass-border)'; }
         set('pk-micval', micAnalyser?Math.round(lvl*100)+'%':'—');
-        set('pk-micstate', micAnalyser?(lvl>0.12?'live · hearing audio':'live · quiet'):'no live mic track');
+        set('pk-micstate', micAnalyser?('selected '+selectedRobotMic()+' · '+(lvl>0.12?'live, hearing audio':'live, quiet')):('selected '+selectedRobotMic()+' · '+micMonitorState));
         // SPEAKER — the Pi plays TTS out its own speaker; we don't get a
         // published track, so the meter stays at "—" unless a speaker
         // round-trip test is currently running. While a test plays, the
@@ -6893,7 +7064,7 @@ button.act:disabled{opacity:0.5;cursor:default;}
         var mark = t.pass===true ? '✓' : (t.pass===false ? '✗' : '·');
         var when = new Date(t.t).toTimeString().slice(0,8);
         var peak = t.peak_db != null ? (t.peak_db+' dB') : '—';
-        var freq = t.frequency != null ? (Math.round(t.frequency)+' Hz') : '—';
+        var freq = t.mode==='tts' ? 'cached voice' : (t.frequency != null ? (Math.round(t.frequency)+' Hz') : '—');
         return '<div class="pk-spk-hist-row"><span class="pk-spk-mark" style="color:'+cls+'">'+mark+'</span>'
           + '<span class="pk-spk-when">'+when+'</span>'
           + '<span class="pk-spk-freq">'+freq+'</span>'
@@ -6916,14 +7087,15 @@ button.act:disabled{opacity:0.5;cursor:default;}
           + '</div>';
         return;
       }
-      var banner = result.pass
-        ? '<div class="pk-spk-banner ok">✓ speaker round-trip OK</div>'
+      var isTts=result.mode==='tts';
+      var banner = result.pass
+        ? '<div class="pk-spk-banner ok">✓ '+(isTts?'cached voice playback OK':'speaker round-trip OK')+'</div>'
         : '<div class="pk-spk-banner bad">✗ no signal detected</div>';
       var meta = '<div class="pk-spk-meta">'
         + '<div><span class="l">peak</span><span class="v">'+esc(result.recorded_peak_db+' dB')+'</span></div>'
         + '<div><span class="l">RMS</span><span class="v">'+esc(result.recorded_rms_db+' dB')+'</span></div>'
         + '<div><span class="l">threshold</span><span class="v">'+esc(result.threshold_db+' dB')+'</span></div>'
-        + '<div><span class="l">frequency</span><span class="v">'+esc(Math.round(result.frequency)+' Hz')+'</span></div>'
+        + (isTts?'<div><span class="l">voice</span><span class="v">'+esc((result.tts_provider||'tts')+' / '+(result.tts_voice||'default'))+'</span></div><div><span class="l">cache</span><span class="v">'+(result.cache_hit?'hit':'generated')+'</span></div>':'<div><span class="l">frequency</span><span class="v">'+esc(Math.round(result.frequency)+' Hz')+'</span></div>')
         + '<div><span class="l">duration</span><span class="v">'+esc(result.duration+' s')+'</span></div>'
         + '<div><span class="l">latency</span><span class="v">'+esc(result.duration_ms+' ms')+'</span></div>'
         + '<div><span class="l">output</span><span class="v">'+esc(result.output_device)+'</span></div>'
@@ -6933,29 +7105,34 @@ button.act:disabled{opacity:0.5;cursor:default;}
       host.innerHTML = '<div class="pk-spk-result '+(result.pass?'ok':'bad')+'">'
         + banner + meta + diag + '</div>';
     }
-    function runSpeakerTest(n){
-      var robotId = schedId(n);
-      var btn = $('pk-spk-runtest'); if(btn){ btn.disabled = true; btn.textContent = 'testing…'; }
+    function runSpeakerTest(n, forcedMode){
+      var robotId = schedId(n), mode=forcedMode||(($('pk-spk-mode')||{}).value||'tts');
+      var buttons=[$('pk-spk-runtest'),$('pk-spk-tone'),$('pk-device-test-speaker')];buttons.forEach(function(b){if(b)b.disabled=true;});
+      var btn = $('pk-spk-runtest'); if(btn){ btn.disabled = true; btn.textContent = mode==='tts'?'loading voice…':'testing…'; }
       var status = $('pk-spk-test-stateline');
-      if(status) status.textContent = 'queued — waiting for robot…';
-      var freq = parseFloat(($('pk-spk-freq')||{}).value || '1000');
-      var dur = parseFloat(($('pk-spk-dur')||{}).value || '0.6');
+      if(status) status.textContent = mode==='tts'?'loading cached character voice…':'queued — waiting for robot…';
+      var freq = parseFloat(($('pk-spk-freq')||{}).value || '1000');
+      var dur = parseFloat(($('pk-spk-dur')||{}).value || '0.6');
+      var phrase=String((($('pk-spk-phrase')||{}).value)||'Hello, I am ready to talk.').trim();
+      var output=(($('pk-audio-output')||{}).value)||'default';
+      var input=(($('pk-audio-input')||{}).value)||'default';
       // Animate the meter with a synthetic "during-test" peak so the
       // operator sees something happen immediately while waiting for
       // the real recording.
       _spkTestSetLive(robotId, {live:true, rms: 0.45, pass: undefined, waveform: null});
       rpAction('POST','/robopark/api/robots/'+encodeURIComponent(robotId)+'/shell/speaker-test',
-        {frequency: freq, duration: dur, amplitude: 0.6, threshold_db: -30})
+        {mode:mode, text:phrase, frequency:freq, duration:dur, amplitude:0.6, threshold_db:-30, output:output, input:input})
         .then(function(q){
           // long-poll up to 8s, then fall back to 12s of result polling
-          if(status) status.textContent = 'playing tone + recording…';
+          if(status) status.textContent = mode==='tts'?'playing cached voice on '+selectedRobotOutput()+'…':'playing tone + recording…';
           return _shellWaitForResult(robotId, q.request_id, q.device_id || robotId, '', 'speaker-test');
         })
         .catch(function(e){
           if(status) status.textContent = '✗ test failed: '+e.message;
-          _spkTestSetLive(robotId, {live:false});
-          _spkTestRenderResult(robotId, {ok:false, error:e.message});
-          if(btn){ btn.disabled = false; btn.textContent = '▶ Test speaker'; }
+          _spkTestSetLive(robotId, {live:false});
+          _spkTestRenderResult(robotId, {ok:false, error:e.message});
+          buttons.forEach(function(b){if(b)b.disabled=false;});
+          if(btn){ btn.disabled = false; btn.textContent = mode==='tts'?'Play cached voice':'Run tone test'; }
         });
     }
     // Render a synthetic "during-test" waveform so the meter animates
@@ -6968,7 +7145,8 @@ button.act:disabled{opacity:0.5;cursor:default;}
         t: Date.now(),
         pass: result && result.ok ? (result.pass===true) : null,
         peak_db: result && result.recorded_peak_db != null ? result.recorded_peak_db : null,
-        frequency: result && result.frequency != null ? result.frequency : null,
+        frequency: result && result.frequency != null ? result.frequency : null,
+        mode: result && result.mode || 'tone',
         diagnostic: result && result.diagnostic || (result && !result.ok ? result.error : null),
       });
       while(list.length > 5) list.pop();
@@ -6983,15 +7161,16 @@ button.act:disabled{opacity:0.5;cursor:default;}
       _origRenderShellResult(robotId, result, label);
       if(label === 'speaker-test'){
         _spkTestSetLive(robotId, {live:false});
-        _spkTestMark(robotId, result);
-        _spkTestRenderResult(robotId, result);
+        _spkTestMark(robotId, result);
+        _spkTestRenderResult(robotId, result);
+        [$('pk-spk-runtest'),$('pk-spk-tone'),$('pk-device-test-speaker')].forEach(function(b){if(b)b.disabled=false;});
         var status = $('pk-spk-test-stateline');
         if(status){
           if(!result || !result.ok){ status.textContent = '✗ test failed'; }
           else if(result.pass){ status.textContent = '✓ pass · '+result.recorded_peak_db+' dB peak'; }
           else { status.textContent = '✗ no signal — '+result.recorded_peak_db+' dB peak'; }
         }
-        var btn = $('pk-spk-runtest'); if(btn){ btn.disabled = false; btn.textContent = '▶ Test speaker'; }
+        var btn = $('pk-spk-runtest'); if(btn){ btn.disabled = false; btn.textContent = (($('pk-spk-mode')||{}).value==='tone'?'Run tone test':'Play cached voice'); }
       }
     };