@qontinui/ui-bridge-native 0.6.8 → 0.6.9

package/dist/server/index.mjs

@@ -55,6 +55,11 @@ var UI_BRIDGE_NATIVE_ROUTES = {
     path: "/ui-bridge/control/snapshot",
     description: "Get full bridge snapshot"
   },
+  DISCOVER: {
+    method: "GET",
+    path: "/ui-bridge/control/discover",
+    description: "Discover elements (alias for snapshot; web/runner parity)"
+  },
   PAGE_HEALTH: {
     method: "POST",
     path: "/ui-bridge/control/page-health",
@@ -182,6 +187,18 @@ var UI_BRIDGE_NATIVE_ROUTES = {
     path: "/ui-bridge/control/modal/dismiss/:id",
     description: "Dismiss a modal by id (testHooks)"
   },
+  // Observability — last-N ring buffers (always mounted; `installed:false`
+  // when the console/network patches are off, i.e. no testHooks).
+  CONSOLE_ERRORS: {
+    method: "GET",
+    path: "/ui-bridge/control/console-errors",
+    description: "Last-N captured console.error/console.warn entries"
+  },
+  NETWORK_REQUESTS: {
+    method: "GET",
+    path: "/ui-bridge/sdk/network-requests",
+    description: "Last-N captured fetch/XHR requests with status + duration"
+  },
   // Health
   HEALTH: {
     method: "GET",
@@ -1714,7 +1731,8 @@ function createServerHandlers(registry, executor, config) {
         return success2({
           entries: [],
           count: 0,
-          bufferSize: 0
+          bufferSize: 0,
+          installed: false
         });
       }
       const entries = buf.entries({
@@ -1724,7 +1742,8 @@ function createServerHandlers(registry, executor, config) {
       return success2({
         entries,
         count: entries.length,
-        bufferSize: buf.size()
+        bufferSize: buf.size(),
+        installed: buf.isInstalled()
       });
     },
     getNetworkRequests: async (ctx) => {
@@ -1735,7 +1754,8 @@ function createServerHandlers(registry, executor, config) {
         return success2({
           entries: [],
           count: 0,
-          bufferSize: 0
+          bufferSize: 0,
+          installed: false
         });
       }
       const entries = buf.entries({
@@ -1745,7 +1765,8 @@ function createServerHandlers(registry, executor, config) {
       return success2({
         entries,
         count: entries.length,
-        bufferSize: buf.size()
+        bufferSize: buf.size(),
+        installed: buf.isInstalled()
       });
     },
     // Test hooks — modal stack manipulation
@@ -2164,7 +2185,10 @@ var WS_ROUTES = [
   // same handler at both paths to keep agents portable across platforms.
   { pattern: "ai/find", handler: "find", httpMethods: ["POST"] },
   { pattern: "control/snapshot", handler: "getSnapshot", httpMethods: ["GET"] },
-  { pattern: "control/discover", handler: "getSnapshot" },
+  // Discovery alias — web/runner parity with `POST /control/discover` (a
+  // legacy alias for snapshot/find). Mounted on HTTP (GET+POST) so mobile
+  // doesn't 404 where web returns 200; delegates to the snapshot handler.
+  { pattern: "control/discover", handler: "getSnapshot", httpMethods: ["GET", "POST"] },
   // Page health — accepts both GET and POST so the canonical skill invocation
   // (`POST .../control/page-health` with an empty body) and ad-hoc curls both
   // work without a body-shape gotcha.
@@ -2258,19 +2282,26 @@ var WS_ROUTES = [
     httpMethods: ["POST"],
     requiresTestHooks: true
   },
-  // Observability — last-N console errors + network requests. testHooks-gated
-  // because patching `console.error` / `fetch` is invasive in production.
+  // Observability — last-N console errors + network requests.
+  //
+  // Always mounted (not testHooks-gated) so they return a schema-valid 200
+  // on every build instead of a 404 that agents can't distinguish from a
+  // missing route. The INVASIVE part — monkey-patching `console.error` /
+  // `fetch` / `XMLHttpRequest` — stays gated behind `testHooks` (see
+  // NativeUIBridgeServer.start → buffer.install()). When the patches aren't
+  // installed the handlers report `installed: false` + empty entries, so
+  // production builds expose the contract without observing real users'
+  // console/network traffic. Set `features.testHooks` (typically on
+  // `__DEV__`) to populate the buffers with live data.
   {
     pattern: "control/console-errors",
     handler: "getConsoleErrors",
-    httpMethods: ["GET"],
-    requiresTestHooks: true
+    httpMethods: ["GET"]
   },
   {
     pattern: "sdk/network-requests",
     handler: "getNetworkRequests",
-    httpMethods: ["GET"],
-    requiresTestHooks: true
+    httpMethods: ["GET"]
   }
 ];
 var HANDLER_DESCRIPTIONS = {
@@ -2317,8 +2348,8 @@ var HANDLER_DESCRIPTIONS = {
   typeInto: "App-agnostic: type into the input matching a label: body { label, text, clear?, visibleOnly? }. (selector form is web-only)",
   readValue: "STUB \u2014 selector-based; NOT_SUPPORTED on native (no DOM). Use /control/element/:id/state to read a value.",
   findByText: "App-agnostic: list elements matching free-text (no press): body { text, visibleOnly? }",
-  getConsoleErrors: "TEST HOOK \u2014 last-N console.error/console.warn entries; ?since=<ms>&limit=<n>",
-  getNetworkRequests: "TEST HOOK \u2014 last-N fetch/XHR entries with status + duration; ?since=<ms>&limit=<n>",
+  getConsoleErrors: "Last-N console.error/console.warn entries; ?since=<ms>&limit=<n>. `installed:false` when capture is off (no testHooks) \u2014 entries empty but schema-valid.",
+  getNetworkRequests: "Last-N fetch/XHR entries with status + duration; ?since=<ms>&limit=<n>. `installed:false` when capture is off (no testHooks) \u2014 entries empty but schema-valid.",
   pushModal: "TEST HOOK \u2014 push a modal onto the snapshot.modalStack via the registry ModalDetector",
   dismissModal: "TEST HOOK \u2014 dismiss a modal by id from the snapshot.modalStack via the registry ModalDetector",
   keepAwake: "TEST HOOK \u2014 keep the device screen awake via the injected keepAwakeProvider: body { enabled: boolean, durationMs?: number }"