@xenon-device-management/xenon 2.16.0 → 2.17.1

package/lib/public/assets/{webhook-settings-DI5DSW99.js → webhook-settings-DukgCe1u.js}

@@ -1 +1 @@
-import{t as P,r as l,X as p,j as e,P as w,A as x,C as V,Q as I}from"./index-B0gQkEg0.js";/* empty css                 */import{F as k}from"./FieldGroup-GOgssFEP.js";import{S as U}from"./select-BWpnhWXj.js";import{P as B}from"./page-header-D8KUX6Qg.js";import{T as D}from"./trash-2-CZ2ew6AZ.js";import{P as _}from"./plus-C9Zj84UF.js";import{C as J}from"./circle-x-Bmltailn.js";import{C as K}from"./circle-check-CBv88cH7.js";import{Z as M}from"./zap-ClcHFxfo.js";import{A as X}from"./activity-DrLbHifn.js";import"./utils-CDN07tui.js";const Z=["udid","name","host","platform"],q=["udid","name","host","platform"],G=["sessionId","sessionName","failureReason","udid","deviceName","platform","osVersion","startTime","endTime"],Q=["windowDays","totalHeals","distinctSelectors"],Y={device_offline:Z,device_new:q,session_failed:G,selector_health_digest:Q},ee=Y,se={eventType:"The event: device_offline, session_failed, ...",udid:"The device's id",name:"The device's name",host:"The machine it is plugged into",platform:"android or ios",sessionId:"The session's id",sessionName:"The session's name, if the test gave it one",failureReason:"Why it failed",deviceName:"The device's name",osVersion:"The device's OS version",startTime:"When it started (ISO 8601)",endTime:"When it ended (ISO 8601)",windowDays:"How many days the digest covers",totalHeals:"Heals in that time",distinctSelectors:"Selectors that were healed"};function te(o){const c=["eventType"];for(const u of o)for(const h of ee[u]??[])c.includes(h)||c.push(h);return c}const ae=[{id:"slack",label:"Slack message"},{id:"webhook",label:"JSON (event and payload)"}];function oe(o){return o.payloadTemplate?"CUSTOM":o.type==="slack"?"SLACK":"JSON"}const j=[{id:"device_offline",label:"Device offline",icon:V,tone:"red"},{id:"device_new",label:"New device",icon:_,tone:"green"},{id:"session_failed",label:"Session failed",icon:J,tone:"amber"},{id:"selector_health_digest",label:"Selector health digest",icon:I,tone:"green"}],be=()=>{const{toast:o}=P(),[c,u]=l.useState([]),[h,N]=l.useState(!0),[r,y]=l.useState(""),[i,S]=l.useState(["device_offline","session_failed"]),[f,T]=l.useState(!1),[C,A]=l.useState(!1),[d,E]=l.useState(!1),[m,g]=l.useState(""),[b,O]=l.useState("slack");l.useEffect(()=>{v()},[]);const v=async()=>{N(!0);try{const s=await p.getWebhookConfigs();u(s||[])}catch(s){console.error("Failed to load webhook configs",s),o("Failed to load webhooks.","error")}finally{N(!1)}},W=async()=>{if(!r.trim()){o("Webhook URL is required.","error");return}if(i.length===0){o("Select at least one trigger event.","error");return}T(!0);try{await p.addWebhookConfig(r.trim(),i,b,m||void 0),y(""),g(""),E(!1),O("slack"),S(["device_offline","session_failed"]),await v(),o("Webhook saved.","success")}catch(s){console.error("Failed to add webhook",s),o(`Failed to add webhook: ${s.message||"unknown error"}`,"error")}finally{T(!1)}},$=async(s,t)=>{if(window.confirm(`Remove webhook for "${t}"?`))try{await p.deleteWebhookConfig(s),await v(),o("Webhook removed.","success")}catch(a){console.error("Failed to delete webhook",a),o(`Failed to delete: ${a.message||"unknown error"}`,"error")}},L=async()=>{if(!r.trim()||i.length===0)return;A(!0);const s=t=>{var a;return((a=j.find(n=>n.id===t))==null?void 0:a.label)??t};try{for(const t of i)try{await p.testWebhook(r.trim(),b,m||void 0,t)}catch(a){o(`Test failed for ${s(t)}: ${a.message||"check the URL"}`,"error");return}o(i.length===1?`Test message delivered: ${s(i[0])}.`:`Test messages delivered: ${i.map(s).join(", ")}.`,"success")}finally{A(!1)}},R=s=>{S(t=>t.includes(s)?t.filter(a=>a!==s):[...t,s])},z=s=>{g(t=>t+`{{${s}}} `)};return e.jsxs("div",{className:"settings-container",children:[e.jsx(B,{icon:w,title:"Notifications",subtitle:"Configure Slack or generic webhooks to receive alerts for critical infrastructure events."}),e.jsxs("div",{className:"settings-content",children:[h?e.jsxs("div",{className:"settings-loading",style:{height:200},children:[e.jsx(x,{className:"animate-spin",size:28}),e.jsx("span",{children:"Loading webhooks…"})]}):c.length===0?e.jsxs("div",{className:"empty-state",children:[e.jsx("div",{className:"empty-state__icon",children:e.jsx(w,{size:28})}),e.jsx("h3",{className:"empty-state__title",children:"No webhooks configured"}),e.jsx("p",{className:"empty-state__copy",children:"Wire up a Slack incoming webhook or any HTTPS endpoint to receive alerts when devices go offline, new devices register, or sessions fail. Configure your first webhook below."})]}):e.jsx("div",{className:"webhook-list-grid",children:c.map(s=>{const t=(()=>{try{return JSON.parse(s.events)}catch{return[]}})();return e.jsxs("div",{className:"webhook-row-card",children:[e.jsxs("div",{className:"webhook-row-card__header",children:[e.jsx("span",{className:`pill-chip ${s.payloadTemplate?"pill-chip--admin":"pill-chip--scope"}`,children:oe(s)}),e.jsx("span",{className:"webhook-row-card__url",title:s.url,children:s.url}),e.jsxs("button",{type:"button",className:"row-action row-action--danger",onClick:()=>$(s.id,s.url),"aria-label":`Remove webhook for ${s.url}`,children:[e.jsx(D,{size:13}),e.jsx("span",{children:"Remove"})]})]}),e.jsx("div",{className:"webhook-row-card__events",children:t.length===0?e.jsx("span",{className:"webhook-row-card__no-events",children:"No triggers"}):t.map(a=>{const n=j.find(H=>H.id===a),F=(n==null?void 0:n.icon)??w;return e.jsxs("span",{className:`event-pill event-pill--${(n==null?void 0:n.tone)||"gray"}`,children:[e.jsx(F,{size:11}),(n==null?void 0:n.label)||a]},a)})})]},s.id)})}),e.jsxs("div",{className:"add-webhook-card",children:[e.jsxs("div",{className:"add-webhook-card__header",children:[e.jsx(_,{size:14}),e.jsx("span",{children:"Add a new webhook"})]}),e.jsxs("div",{className:"add-webhook-card__body",children:[e.jsx(k,{label:"Webhook URL",description:"The endpoint we POST webhook events to.",htmlFor:"webhook-url",children:e.jsx("div",{className:"setting-input-wrapper",children:e.jsx("input",{id:"webhook-url",type:"url",placeholder:"https://hooks.slack.com/services/...",value:r,onChange:s=>y(s.target.value)})})}),e.jsx(k,{label:"Message format",description:m.trim()?"Your custom payload is sent as written, whatever the format.":"Slack message for a Slack incoming webhook; JSON for anything else.",htmlFor:"webhook-format",children:e.jsx(U,{id:"webhook-format",value:b,onChange:s=>O(s.target.value),children:ae.map(s=>e.jsx("option",{value:s.id,children:s.label},s.id))})}),e.jsx(k,{label:"Trigger events",children:e.jsx("div",{className:"event-toggle-grid",children:j.map(s=>{const t=i.includes(s.id),a=s.icon;return e.jsxs("button",{type:"button",role:"checkbox","aria-checked":t,className:`event-toggle event-toggle--${s.tone} ${t?"is-selected":""}`,onClick:()=>R(s.id),children:[e.jsx(a,{size:14,className:"event-toggle__lead"}),e.jsx("span",{children:s.label}),t&&e.jsx(K,{size:14,className:"event-toggle__check"})]},s.id)})})}),e.jsxs("div",{className:"template-section",children:[e.jsxs("button",{type:"button",className:"template-section__toggle",onClick:()=>E(!d),"aria-expanded":d,children:[e.jsx(M,{size:14,className:d?"tone-amber":"tone-dim"}),e.jsx("span",{children:"Use custom payload (optional)"}),e.jsx("span",{className:"template-section__indicator",children:d?"−":"+"})]}),d&&e.jsxs("div",{className:"template-editor",children:[e.jsx("p",{className:"template-editor__hint",children:"Define a JSON or text template. Click a name below to insert it; the names are the ones your selected events carry."}),e.jsx("div",{className:"template-editor__chips",children:te(i).map(s=>e.jsx("button",{type:"button",className:"template-editor__chip","aria-label":`{{${s}}}`,title:se[s],onClick:()=>z(s),children:`{{${s}}}`},s))}),e.jsx("textarea",{className:"template-editor__textarea",placeholder:'Example: { "text": "Alert: Device {{udid}} is offline!" }',value:m,onChange:s=>g(s.target.value),rows:4})]})]})]}),e.jsxs("div",{className:"add-webhook-card__footer",children:[e.jsxs("button",{type:"button",className:"page-header-action page-header-action--ghost",onClick:L,disabled:!r.trim()||i.length===0||C,"aria-label":"Send test",title:i.length===0?"Select a trigger event to send a sample of":"Sends a sample message for each selected event",children:[C?e.jsx(x,{size:14,className:"animate-spin"}):e.jsx(X,{size:14}),e.jsx("span",{children:"Send test"})]}),e.jsxs("button",{type:"button",className:"page-header-action",onClick:W,disabled:f||!r.trim(),children:[f?e.jsx(x,{size:14,className:"animate-spin"}):e.jsx(_,{size:14}),e.jsx("span",{children:f?"Saving…":"Save webhook"})]})]})]})]})]})};export{be as WebhookSettings};
+import{t as P,r as l,X as p,j as e,P as w,A as x,C as V,Q as I}from"./index-BpqyclNY.js";/* empty css                 */import{F as k}from"./FieldGroup-CaQNXgcE.js";import{S as U}from"./select-Cx4JDzsR.js";import{P as B}from"./page-header-CAbH1O1a.js";import{T as D}from"./trash-2-BIRm2KVs.js";import{P as _}from"./plus-BT9mk2gj.js";import{C as J}from"./circle-x-C8GvvXVt.js";import{C as K}from"./circle-check-Crt-G_uy.js";import{Z as M}from"./zap-BE9gacFj.js";import{A as X}from"./activity-pEyAdE-M.js";import"./utils-CDN07tui.js";const Z=["udid","name","host","platform"],q=["udid","name","host","platform"],G=["sessionId","sessionName","failureReason","udid","deviceName","platform","osVersion","startTime","endTime"],Q=["windowDays","totalHeals","distinctSelectors"],Y={device_offline:Z,device_new:q,session_failed:G,selector_health_digest:Q},ee=Y,se={eventType:"The event: device_offline, session_failed, ...",udid:"The device's id",name:"The device's name",host:"The machine it is plugged into",platform:"android or ios",sessionId:"The session's id",sessionName:"The session's name, if the test gave it one",failureReason:"Why it failed",deviceName:"The device's name",osVersion:"The device's OS version",startTime:"When it started (ISO 8601)",endTime:"When it ended (ISO 8601)",windowDays:"How many days the digest covers",totalHeals:"Heals in that time",distinctSelectors:"Selectors that were healed"};function te(o){const c=["eventType"];for(const u of o)for(const h of ee[u]??[])c.includes(h)||c.push(h);return c}const ae=[{id:"slack",label:"Slack message"},{id:"webhook",label:"JSON (event and payload)"}];function oe(o){return o.payloadTemplate?"CUSTOM":o.type==="slack"?"SLACK":"JSON"}const j=[{id:"device_offline",label:"Device offline",icon:V,tone:"red"},{id:"device_new",label:"New device",icon:_,tone:"green"},{id:"session_failed",label:"Session failed",icon:J,tone:"amber"},{id:"selector_health_digest",label:"Selector health digest",icon:I,tone:"green"}],be=()=>{const{toast:o}=P(),[c,u]=l.useState([]),[h,N]=l.useState(!0),[r,y]=l.useState(""),[i,S]=l.useState(["device_offline","session_failed"]),[f,T]=l.useState(!1),[C,A]=l.useState(!1),[d,E]=l.useState(!1),[m,g]=l.useState(""),[b,O]=l.useState("slack");l.useEffect(()=>{v()},[]);const v=async()=>{N(!0);try{const s=await p.getWebhookConfigs();u(s||[])}catch(s){console.error("Failed to load webhook configs",s),o("Failed to load webhooks.","error")}finally{N(!1)}},W=async()=>{if(!r.trim()){o("Webhook URL is required.","error");return}if(i.length===0){o("Select at least one trigger event.","error");return}T(!0);try{await p.addWebhookConfig(r.trim(),i,b,m||void 0),y(""),g(""),E(!1),O("slack"),S(["device_offline","session_failed"]),await v(),o("Webhook saved.","success")}catch(s){console.error("Failed to add webhook",s),o(`Failed to add webhook: ${s.message||"unknown error"}`,"error")}finally{T(!1)}},$=async(s,t)=>{if(window.confirm(`Remove webhook for "${t}"?`))try{await p.deleteWebhookConfig(s),await v(),o("Webhook removed.","success")}catch(a){console.error("Failed to delete webhook",a),o(`Failed to delete: ${a.message||"unknown error"}`,"error")}},L=async()=>{if(!r.trim()||i.length===0)return;A(!0);const s=t=>{var a;return((a=j.find(n=>n.id===t))==null?void 0:a.label)??t};try{for(const t of i)try{await p.testWebhook(r.trim(),b,m||void 0,t)}catch(a){o(`Test failed for ${s(t)}: ${a.message||"check the URL"}`,"error");return}o(i.length===1?`Test message delivered: ${s(i[0])}.`:`Test messages delivered: ${i.map(s).join(", ")}.`,"success")}finally{A(!1)}},R=s=>{S(t=>t.includes(s)?t.filter(a=>a!==s):[...t,s])},z=s=>{g(t=>t+`{{${s}}} `)};return e.jsxs("div",{className:"settings-container",children:[e.jsx(B,{icon:w,title:"Notifications",subtitle:"Configure Slack or generic webhooks to receive alerts for critical infrastructure events."}),e.jsxs("div",{className:"settings-content",children:[h?e.jsxs("div",{className:"settings-loading",style:{height:200},children:[e.jsx(x,{className:"animate-spin",size:28}),e.jsx("span",{children:"Loading webhooks…"})]}):c.length===0?e.jsxs("div",{className:"empty-state",children:[e.jsx("div",{className:"empty-state__icon",children:e.jsx(w,{size:28})}),e.jsx("h3",{className:"empty-state__title",children:"No webhooks configured"}),e.jsx("p",{className:"empty-state__copy",children:"Wire up a Slack incoming webhook or any HTTPS endpoint to receive alerts when devices go offline, new devices register, or sessions fail. Configure your first webhook below."})]}):e.jsx("div",{className:"webhook-list-grid",children:c.map(s=>{const t=(()=>{try{return JSON.parse(s.events)}catch{return[]}})();return e.jsxs("div",{className:"webhook-row-card",children:[e.jsxs("div",{className:"webhook-row-card__header",children:[e.jsx("span",{className:`pill-chip ${s.payloadTemplate?"pill-chip--admin":"pill-chip--scope"}`,children:oe(s)}),e.jsx("span",{className:"webhook-row-card__url",title:s.url,children:s.url}),e.jsxs("button",{type:"button",className:"row-action row-action--danger",onClick:()=>$(s.id,s.url),"aria-label":`Remove webhook for ${s.url}`,children:[e.jsx(D,{size:13}),e.jsx("span",{children:"Remove"})]})]}),e.jsx("div",{className:"webhook-row-card__events",children:t.length===0?e.jsx("span",{className:"webhook-row-card__no-events",children:"No triggers"}):t.map(a=>{const n=j.find(H=>H.id===a),F=(n==null?void 0:n.icon)??w;return e.jsxs("span",{className:`event-pill event-pill--${(n==null?void 0:n.tone)||"gray"}`,children:[e.jsx(F,{size:11}),(n==null?void 0:n.label)||a]},a)})})]},s.id)})}),e.jsxs("div",{className:"add-webhook-card",children:[e.jsxs("div",{className:"add-webhook-card__header",children:[e.jsx(_,{size:14}),e.jsx("span",{children:"Add a new webhook"})]}),e.jsxs("div",{className:"add-webhook-card__body",children:[e.jsx(k,{label:"Webhook URL",description:"The endpoint we POST webhook events to.",htmlFor:"webhook-url",children:e.jsx("div",{className:"setting-input-wrapper",children:e.jsx("input",{id:"webhook-url",type:"url",placeholder:"https://hooks.slack.com/services/...",value:r,onChange:s=>y(s.target.value)})})}),e.jsx(k,{label:"Message format",description:m.trim()?"Your custom payload is sent as written, whatever the format.":"Slack message for a Slack incoming webhook; JSON for anything else.",htmlFor:"webhook-format",children:e.jsx(U,{id:"webhook-format",value:b,onChange:s=>O(s.target.value),children:ae.map(s=>e.jsx("option",{value:s.id,children:s.label},s.id))})}),e.jsx(k,{label:"Trigger events",children:e.jsx("div",{className:"event-toggle-grid",children:j.map(s=>{const t=i.includes(s.id),a=s.icon;return e.jsxs("button",{type:"button",role:"checkbox","aria-checked":t,className:`event-toggle event-toggle--${s.tone} ${t?"is-selected":""}`,onClick:()=>R(s.id),children:[e.jsx(a,{size:14,className:"event-toggle__lead"}),e.jsx("span",{children:s.label}),t&&e.jsx(K,{size:14,className:"event-toggle__check"})]},s.id)})})}),e.jsxs("div",{className:"template-section",children:[e.jsxs("button",{type:"button",className:"template-section__toggle",onClick:()=>E(!d),"aria-expanded":d,children:[e.jsx(M,{size:14,className:d?"tone-amber":"tone-dim"}),e.jsx("span",{children:"Use custom payload (optional)"}),e.jsx("span",{className:"template-section__indicator",children:d?"−":"+"})]}),d&&e.jsxs("div",{className:"template-editor",children:[e.jsx("p",{className:"template-editor__hint",children:"Define a JSON or text template. Click a name below to insert it; the names are the ones your selected events carry."}),e.jsx("div",{className:"template-editor__chips",children:te(i).map(s=>e.jsx("button",{type:"button",className:"template-editor__chip","aria-label":`{{${s}}}`,title:se[s],onClick:()=>z(s),children:`{{${s}}}`},s))}),e.jsx("textarea",{className:"template-editor__textarea",placeholder:'Example: { "text": "Alert: Device {{udid}} is offline!" }',value:m,onChange:s=>g(s.target.value),rows:4})]})]})]}),e.jsxs("div",{className:"add-webhook-card__footer",children:[e.jsxs("button",{type:"button",className:"page-header-action page-header-action--ghost",onClick:L,disabled:!r.trim()||i.length===0||C,"aria-label":"Send test",title:i.length===0?"Select a trigger event to send a sample of":"Sends a sample message for each selected event",children:[C?e.jsx(x,{size:14,className:"animate-spin"}):e.jsx(X,{size:14}),e.jsx("span",{children:"Send test"})]}),e.jsxs("button",{type:"button",className:"page-header-action",onClick:W,disabled:f||!r.trim(),children:[f?e.jsx(x,{size:14,className:"animate-spin"}):e.jsx(_,{size:14}),e.jsx("span",{children:f?"Saving…":"Save webhook"})]})]})]})]})]})};export{be as WebhookSettings};

package/lib/public/assets/{zap-ClcHFxfo.js → zap-BE9gacFj.js}

@@ -1,4 +1,4 @@
-import{c as a}from"./index-B0gQkEg0.js";/**
+import{c as a}from"./index-BpqyclNY.js";/**
  * @license lucide-react v0.555.0 - ISC
  *
  * This source code is licensed under the ISC license.

package/lib/public/index.html

@@ -36,7 +36,7 @@
       Learn how to configure a non-root public URL by running `npm run build`.
     -->
   <title>Xenon</title>
-  <script type="module" crossorigin src="/xenon/assets/index-B0gQkEg0.js"></script>
+  <script type="module" crossorigin src="/xenon/assets/index-BpqyclNY.js"></script>
   <link rel="stylesheet" crossorigin href="/xenon/assets/index-Bxoxt9sV.css">
 </head>
 

package/lib/schema.json

@@ -163,7 +163,7 @@
                 "sqlite",
                 "postgresql"
             ],
-            "description": "Has no effect, and is accepted only so older configs still start. Xenon stores its data in SQLite, one database per server, hub or node (see databaseUrl). At startup the database itself decides how its tables are brought up to date: from its migration history if that history matches its tables (Xenon first corrects a history that has fallen behind them), otherwise by matching them to this version's schema."
+            "description": "Has no effect, and is accepted only so older configs still start. Xenon stores its data in SQLite, one database per server, hub or node (see databaseUrl). At startup the database itself decides how its tables are brought up to date: from its migration history if that history matches its tables, otherwise by matching them to this version's schema."
         },
         "databaseUrl": {
             "type": "string",

package/lib/src/app/index.js

@@ -90,6 +90,7 @@ const PluginContext_1 = require("../PluginContext");
 const nodeWebDriverUrl_1 = require("../gateway/nodeWebDriverUrl");
 const nodeSessionStatus_1 = require("../gateway/nodeSessionStatus");
 const nodeSessionMetrics_1 = require("../gateway/nodeSessionMetrics");
+const nodeSessionDeviceLogs_1 = require("../gateway/nodeSessionDeviceLogs");
 const dashboardPluginLink_1 = require("./dashboardPluginLink");
 const ASYNC_LOCK = new async_lock_1.default();
 // An async handler's error reaches the error handlers, as on Express 5.
@@ -219,6 +220,7 @@ function createRouter(pluginArgs, ownServer) {
     // credentials for the node); it takes the hub's session token instead.
     (0, nodeSessionStatus_1.registerNodeSessionStatus)(apiRouter, pluginArgs);
     (0, nodeSessionMetrics_1.registerNodeSessionMetrics)(apiRouter, pluginArgs);
+    (0, nodeSessionDeviceLogs_1.registerNodeSessionDeviceLogs)(apiRouter, pluginArgs);
     // Dashboard login: unauthenticated (rate-limited internally via separate IP logic)
     apiRouter.use('/auth', (0, auth_1.authPublicRouter)()); // login, logout — unauthenticated
     // All remaining /api/* requires authentication (cookie session for

package/lib/src/app/openapi/control.yaml

@@ -1941,8 +1941,12 @@ paths:
       summary: Start the live preview and hold the device
       description: >-
         Starts the device's live preview and holds the device for you (`session_id` becomes
-        `manual_<yourUserId>_<udid>`), so automation is not given it while you watch. iOS starts
-        WebDriverAgent's MJPEG stream (and the go-ios tunnel on iOS 17+). Android starts an MJPEG
+        `manual_<yourUserId>_<udid>`), so automation is not given it while you watch. An iPhone
+        starts WebDriverAgent's MJPEG stream (and the go-ios tunnel on iOS 17+). An iOS simulator
+        starts nothing and is not held (its test holds it): it shows the picture of the test
+        running on it, from the WebDriverAgent the XCUITest driver runs for that test, and with no
+        test running it answers `409` with `error: simulator_needs_test` and a `message` saying
+        so. Android starts an MJPEG
         screen capture, or, when the server's `streaming.androidH264` setting is on and the device
         is not being recorded, an H.264 stream for the WebSocket in `h264Path`. Missing screen
         dimensions are filled in and saved.
@@ -2035,7 +2039,34 @@ paths:
         '404':
           $ref: '#/components/responses/ControlDeviceNotFound'
         '409':
-          $ref: '#/components/responses/ControlHeld'
+          description: >-
+            Another user holds the device, or it runs another user's Appium session (admins are
+            never refused), as for every device action. Or the device is an iOS simulator no test
+            runs on (`simulator_needs_test`): its screen shows only while a test runs on it.
+          content:
+            application/json:
+              schema:
+                oneOf:
+                  - $ref: '#/components/schemas/ControlDenied'
+                  - $ref: '#/components/schemas/ControlSimulatorNeedsTest'
+              examples:
+                held:
+                  summary: Another user's preview or recording
+                  value:
+                    success: false
+                    error: device_held_by_another_user
+                    message: >-
+                      Device is being controlled by Priya Raman. Ask them to release it, or use an
+                      admin key to force-release.
+                    holder:
+                      userId: c7a1e5d2-3f4b-4a9e-8c21-5b6d7e8f9a01
+                      name: Priya Raman
+                simulatorNeedsTest:
+                  summary: An iOS simulator no test runs on
+                  value:
+                    success: false
+                    error: simulator_needs_test
+                    message: A simulator's screen shows here only while a test runs on it.
         '429':
           $ref: '#/components/responses/RateLimited'
         '500':
@@ -2286,7 +2317,9 @@ paths:
         Says whether the device's preview is running and which transport a player should use
         (`type`: `h264` on Android when the server's `streaming.androidH264` setting is on and the
         device isn't being recorded, else `mjpeg`). A device with no preview answers `200` with
-        `status: stopped`. iOS adds WebDriverAgent's port, the start time and the last error.
+        `status: stopped`. iOS adds WebDriverAgent's port, the start time and the last error. A
+        simulator no test runs on answers `status: stopped` with `lastError` saying why it shows
+        nothing, and `reason: simulator_needs_test`.
 
 
         Open to watchers. Needs the `MEMBER` role; any scope will do.
@@ -2326,6 +2359,15 @@ paths:
                     udid: R5CT32ABCDE
                     status: stopped
                     type: mjpeg
+                simulatorWithoutTest:
+                  summary: An iOS simulator no test runs on
+                  value:
+                    udid: 35429994-B029-4AF4-9634-880B89DAC782
+                    status: stopped
+                    type: mjpeg
+                    mjpegPort: 9101
+                    lastError: A simulator's screen shows here only while a test runs on it.
+                    reason: simulator_needs_test
         '400':
           description: The udid is malformed.
           content:
@@ -3147,6 +3189,13 @@ components:
         lastError:
           type: string
           description: iOS only.
+        reason:
+          type: string
+          enum:
+            - simulator_needs_test
+          description: >-
+            Set when the preview is refused rather than failed: `simulator_needs_test`, an iOS
+            simulator no test runs on.
     ControlStreamLeaveResult:
       type: object
       properties:
@@ -3156,6 +3205,22 @@ components:
         pending:
           type: boolean
           example: true
+    ControlSimulatorNeedsTest:
+      type: object
+      required:
+        - error
+        - message
+      properties:
+        success:
+          type: boolean
+          example: false
+        error:
+          type: string
+          enum:
+            - simulator_needs_test
+        message:
+          type: string
+          description: Why the simulator shows nothing, for testers.
     ControlDenied:
       type: object
       required:

package/lib/src/app/openapi/grid.yaml

@@ -1736,6 +1736,82 @@ paths:
           $ref: '#/components/responses/GridNodeUnknownSession'
         '503':
           $ref: '#/components/responses/GridNodeTokenUnavailable'
+  /api/node/sessions/{sessionId}/device-logs:
+    get:
+      operationId: getGridNodeSessionDeviceLogs
+      summary: Collect a session's device log lines from this node
+      description: |
+        Node only: a hub collects the device log lines a node has recorded
+        for a session on one of its phones, as soon as the session is
+        created, every 10 s after that, and once more when the session
+        ends. The hub writes them as the session's Device logs. Only a
+        server started with `hub` set has this route.
+
+        The node records each session its hub created, with the same limit
+        as a session on the hub's own phone (10,000 lines, then up to 2,000
+        more errors), and keeps the lines in memory until the hub collects
+        them, an ended session's for 10 minutes. If no hub asks within 2
+        minutes of the start, the node stops recording that session.
+
+        Each line has a number, `seq`, counting up from 1. `after` asks for
+        the lines after that number, and the node drops the others, so a
+        later call never returns them again. An answer holds at most 2,000
+        lines; `more` says the node has others, to ask for at once. `state`
+        is `recording`, `ended`, or `off` (the node doesn't record this
+        session). `timestamp` is the line's moment by the node's clock.
+
+        It is answered before the login, with the same rule as
+        `GET /api/node/sessions/{sessionId}`: no credential with
+        per-command auth off or auth disabled, otherwise the hub's session
+        token for that session. Every answer from a node carries
+        `x-xenon-node-device-logs: 1`. It isn't rate-limited.
+      tags:
+        - Hub-Node
+      security:
+        - HubToken: []
+        - {}
+      parameters:
+        - $ref: '#/components/parameters/GridNodeSessionId'
+        - in: query
+          name: after
+          required: false
+          description: A line number; only later lines are returned, and the others are dropped. Anything that isn't a plain number is ignored.
+          schema:
+            type: integer
+            example: 2000
+      responses:
+        '200':
+          description: The session's lines.
+          headers:
+            x-xenon-node-device-logs:
+              description: Always `1` on a node.
+              schema:
+                type: string
+                example: '1'
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  value:
+                    $ref: '#/components/schemas/GridNodeDeviceLogs'
+              example:
+                value:
+                  state: recording
+                  more: false
+                  lines:
+                    - seq: 2001
+                      message: '10-05 14:20:02.114  4127  4127 I ActivityManager: Start proc 4127:com.example.shop/u0a215'
+                      timestamp: 1791111602114
+                    - seq: 2002
+                      message: '10-05 14:20:02.391  4127  4127 E AndroidRuntime: FATAL EXCEPTION: main'
+                      timestamp: 1791111602391
+        '401':
+          $ref: '#/components/responses/GridNotANodeUnauthorized'
+        '404':
+          $ref: '#/components/responses/GridNodeUnknownSession'
+        '503':
+          $ref: '#/components/responses/GridNodeTokenUnavailable'
   /api/status:
     get:
       operationId: getGridServerStatus
@@ -2304,6 +2380,32 @@ components:
                 type: string
                 nullable: true
                 description: The app the app figures are for (Android), else null.
+    GridNodeDeviceLogs:
+      type: object
+      properties:
+        state:
+          type: string
+          enum:
+            - recording
+            - ended
+            - 'off'
+        more:
+          type: boolean
+          description: The node holds more lines than this answer; ask again with the last `seq`.
+        lines:
+          type: array
+          items:
+            type: object
+            properties:
+              seq:
+                type: integer
+                description: The line's number in the session, from 1.
+              message:
+                type: string
+                description: The line as the device printed it.
+              timestamp:
+                type: integer
+                description: Epoch milliseconds, by the node's clock.
     GridWebDriverError:
       type: object
       description: A WebDriver-style error, as Appium answers one.

package/lib/src/app/routers/control.js

@@ -58,7 +58,7 @@ const InternalHttpClient_1 = require("../../InternalHttpClient");
 const device_service_1 = require("../../data-service/device-service");
 const UniversalMjpegProxy_1 = require("../../helpers/UniversalMjpegProxy");
 const DisplayStateService_1 = require("../../services/DisplayStateService");
-const IOSStreamService_1 = __importDefault(require("../../device-managers/ios/IOSStreamService"));
+const IOSStreamService_1 = __importStar(require("../../device-managers/ios/IOSStreamService"));
 const AndroidStreamService_1 = __importDefault(require("../../device-managers/android/AndroidStreamService"));
 const AndroidH264StreamService_1 = __importDefault(require("../../device-managers/android/AndroidH264StreamService"));
 const path_1 = __importDefault(require("path"));
@@ -748,9 +748,14 @@ router.post('/:udid/stream/start', (req, res) => __awaiter(void 0, void 0, void
         // Mark device as "Busy" so automation sessions don't pick it up.
         // Lock is keyed on the user, not the credential — see
         // src/services/device-access/deviceAccessPolicy.ts.
-        const manualSid = (0, manualLock_1.formatManualLock)(actorUserId, udid);
-        yield (0, device_service_1.blockDevice)(udid, device.host, manualSid);
-        logger_1.default.info(`Manual Control: Device ${udid} locked for active UI session (${manualSid}).`);
+        // A simulator is previewed only while a test holds it, so a preview hold
+        // adds nothing, and written after the test ended it would hold a free
+        // simulator for nobody's test.
+        if (!(0, IOSStreamService_1.isIosSimulator)(device)) {
+            const manualSid = (0, manualLock_1.formatManualLock)(actorUserId, udid);
+            yield (0, device_service_1.blockDevice)(udid, device.host, manualSid);
+            logger_1.default.info(`Manual Control: Device ${udid} locked for active UI session (${manualSid}).`);
+        }
         if (streamType === 'h264') {
             logger_1.default.info(`H.264 stream started for ${udid}`);
             return res.status(200).send({
@@ -774,6 +779,13 @@ router.post('/:udid/stream/start', (req, res) => __awaiter(void 0, void 0, void
         });
     }
     catch (err) {
+        // Not a failure: a simulator shows its running test's picture, and none
+        // runs. Said in plain words; the dashboard toasts it.
+        if (err instanceof IOSStreamService_1.SimulatorPreviewNeedsTest) {
+            return res
+                .status(409)
+                .send({ success: false, error: 'simulator_needs_test', message: err.message });
+        }
         logger_1.default.error(`Failed to start stream for ${udid}: ${err.message}`);
         return res.status(500).send({
             success: false,
@@ -1037,6 +1049,9 @@ router.get('/:udid/stream/status', (req, res) => __awaiter(void 0, void 0, void
         type,
         h264Path,
         mjpegPort: device.mjpegServerPort,
+        // Why a simulator shows nothing: a Live devices tile says it once it stops retrying.
+        lastError: (0, IOSStreamService_1.simulatorPreviewRefusal)(device),
+        reason: (0, IOSStreamService_1.simulatorPreviewRefusal)(device) ? 'simulator_needs_test' : undefined,
     });
 }));
 /**
@@ -1083,7 +1098,11 @@ router.get('/:udid/stream', (req, res) => __awaiter(void 0, void 0, void 0, func
             });
         }
         catch (err) {
-            logger_1.default.error(`Failed to start stream for ${udid}: ${err.message}`);
+            // A simulator no test runs on: expected, and asked again by each retry.
+            if (err instanceof IOSStreamService_1.SimulatorPreviewNeedsTest)
+                logger_1.default.debug(`${udid}: ${err.message}`);
+            else
+                logger_1.default.error(`Failed to start stream for ${udid}: ${err.message}`);
             return res.status(503).send({
                 error: 'Stream not available',
                 message: err.message,

package/lib/src/dashboard/event-manager.js

@@ -79,6 +79,7 @@ const NotificationService_1 = require("../services/NotificationService");
 const SessionMetricsService_1 = require("../services/metrics/SessionMetricsService");
 const SessionDeviceLogs_1 = require("../services/logcat/SessionDeviceLogs");
 const nodeMetrics_1 = require("../services/metrics/nodeMetrics");
+const nodeDeviceLogs_1 = require("../services/logcat/nodeDeviceLogs");
 const sessionCommandSummary_1 = require("./sessionCommandSummary");
 const commandLogFields_1 = require("./commandLogFields");
 const typedi_2 = require("typedi");
@@ -156,19 +157,15 @@ let DashboardEventManager = class DashboardEventManager {
             // once its row exists (the lines point at it), unless the session turned
             // it off: an Android phone's stream, or the log an iPhone's or
             // simulator's driver captures. Not waited for: an Android phone's clock
-            // and log stream are read in the background.
+            // and log stream are read in the background. A node's phone's lines are
+            // collected from the node, through the session.
             const deviceLogs = typedi_1.Container.get(SessionDeviceLogs_1.SessionDeviceLogs);
             if (capabilities[XenonCapabilityManager_1.XENON_CAPABILITIES.SAVE_DEVICE_LOGS] === false) {
                 void deviceLogs.noteOff(session.getId());
             }
             else {
-                void deviceLogs.start({
-                    sessionId: session.getId(),
-                    device,
-                    since: session.allocatedAt,
-                    driverLog: (_d = (_c = session).deviceLog) === null || _d === void 0 ? void 0 : _d.call(_c),
-                    appUnderTest: (_f = (_e = session).appUnderTest) === null || _f === void 0 ? void 0 : _f.call(_e),
-                });
+                const deviceLogSource = (0, nodeDeviceLogs_1.nodeDeviceLogsSourceOf)(session);
+                void deviceLogs.start(Object.assign({ sessionId: session.getId(), device, since: session.allocatedAt, driverLog: (_d = (_c = session).deviceLog) === null || _d === void 0 ? void 0 : _d.call(_c), appUnderTest: (_f = (_e = session).appUnderTest) === null || _f === void 0 ? void 0 : _f.call(_e) }, (deviceLogSource ? { source: deviceLogSource } : {})));
             }
             // Emit session started event
             void typedi_1.Container.get(SocketServer_1.SocketServer).emitToDashboardForDevices(SocketEvents_1.SocketEvents.SESSION_STARTED, Object.assign(Object.assign({}, createData), { status: 'running', build_name: buildName }), { udid: device.udid });