@buoy-gg/core 7.0.35 → 7.0.36

package/README.md

@@ -30,47 +30,50 @@ export default function App() {
 }
 ```
 
-That's the whole setup — a floating dev menu appears inside your app. Install any tool package and it auto-appears in the menu; most need zero config, a few take one line (like passing `zustandStores` or calling `watchAtoms()`). Add a `licenseKey` prop to unlock [Pro](https://buoy.gg/pricing): production builds, the MCP server, and unlimited capture.
+That's the whole setup — a floating dev menu appears inside your app. Install any tool package and it auto-appears in the menu; most need zero config, a few take one line (like passing `zustandStores` or calling `watchAtoms()`). Add a `licenseKey` prop to unlock [Pro](https://buoy.gg/pricing): production builds, the MCP server, Ask Buoy, and unlimited capture.
 
-## The 15 tools
+## The 21 tools
 
 | Tool | Package | What it does |
 | --- | --- | --- |
 | [Network](https://buoy.gg/buoy/latest/docs/tools/network) | `@buoy-gg/network` | Every request, response, timing & error — GraphQL operations extracted and named |
 | [Storage](https://buoy.gg/buoy/latest/docs/tools/storage) | `@buoy-gg/storage` | Browse & edit AsyncStorage, MMKV & SecureStore with change history |
+| [Time Machine](https://buoy.gg/buoy/latest/docs/tools/time-machine) | `@buoy-gg/time-machine` | Snapshot storage, Redux, Zustand, Jotai & the query cache as restore points — jump back in one tap |
+| [Ask Buoy](https://buoy.gg/buoy/latest/docs/tools/ask-buoy) | `@buoy-gg/ask-buoy` | An in-app AI chat that drives every tool in plain English, on your own model endpoint — with a changes bar and real undo *(beta)* |
 | [Env](https://buoy.gg/buoy/latest/docs/tools/env) | `@buoy-gg/env` | Auto-discovers `EXPO_PUBLIC_` vars, validates types, scores config health |
 | [Query](https://buoy.gg/buoy/latest/docs/tools/react-query) | `@buoy-gg/react-query` | TanStack Query cache — refetch, invalidate, simulate loading & error states |
 | [Routes](https://buoy.gg/buoy/latest/docs/tools/routes) | `@buoy-gg/route-events` | Navigation events, the live stack, and the full sitemap — jump to any screen |
 | [Debug Borders](https://buoy.gg/buoy/latest/docs/tools/debug-borders) | `@buoy-gg/debug-borders` | Depth-colored layout borders — tap any label for testID, a11y props & styles |
 | [Highlight Updates](https://buoy.gg/buoy/latest/docs/tools/highlight-updates) | `@buoy-gg/highlight-updates` | Every render, with the cause: mount, state, props, or parent |
 | [Bench](https://buoy.gg/buoy/latest/docs/tools/perf-monitor) | `@buoy-gg/perf-monitor` | UI/JS FPS, CPU, memory & jank on a real device — batch benchmarks, ranked reports |
+| [JS Top](https://buoy.gg/buoy/latest/docs/tools/js-top) | `@buoy-gg/js-top` | Task Manager for the JS thread — which timers, Promise chains & callbacks eat your JS FPS |
+| [Images](https://buoy.gg/buoy/latest/docs/tools/images) | `@buoy-gg/images` | Every image load with cache verdict, timing, and oversize & wasted-memory audit |
+| [Assets](https://buoy.gg/buoy/latest/docs/tools/assets) | `@buoy-gg/assets` | Everything you ship — bundled images, fonts, video & audio with sizes, duplicates & never-loaded detection |
 | [Events](https://buoy.gg/buoy/latest/docs/tools/events) | `@buoy-gg/events` | One timeline across every tool, with LLM-friendly export presets |
 | [Console](https://buoy.gg/buoy/latest/docs/tools/console) | `@buoy-gg/console` | Chrome-DevTools console on device — read logs with no cable and no Metro |
+| [Sentry](https://buoy.gg/buoy/latest/docs/tools/sentry) | `@buoy-gg/sentry` | Every envelope your app sends to Sentry, what it costs, and why an event never arrived |
 | [Redux](https://buoy.gg/buoy/latest/docs/tools/redux) | `@buoy-gg/redux` | Inspect, dispatch & time travel — flags actions that blow the frame budget |
 | [Zustand](https://buoy.gg/buoy/latest/docs/tools/zustand) | `@buoy-gg/zustand` | State, diffs, jump-to-state, one-tap reset — no middleware needed |
 | [Jotai](https://buoy.gg/buoy/latest/docs/tools/jotai) | `@buoy-gg/jotai` | One `watchAtoms()` call — every event shows `prev → next` |
 | [Impersonate](https://buoy.gg/buoy/latest/docs/tools/impersonate) | `@buoy-gg/impersonate` | Switch users, roles & flags without rebuilding |
 | [Overlay](https://buoy.gg/buoy/latest/docs/tools/image-overlay) | `@buoy-gg/image-overlay` | Pin Figma mockups pixel-perfect over the app |
 
-Grab everything in one line:
+Two more ship for React Native TV — [TV Remote](https://buoy.gg/buoy/latest/docs/tools/tv-remote) and [Focus Inspector](https://buoy.gg/buoy/latest/docs/tools/focus-inspector) — and [Camera](https://buoy.gg/buoy/latest/docs/tools/camera) gives the iOS Simulator a working camera with no app integration at all.
 
-```bash
-npm i @buoy-gg/{core,network,storage,env,react-query,route-events,debug-borders,highlight-updates,perf-monitor,events,console,redux,zustand,jotai,impersonate,image-overlay}
-```
-
-## Three surfaces, one live session
+## Four surfaces, one live session
 
-Every tool runs inside your app's process. The phone, the desktop, and your agent all see the same session, live.
+Every tool runs inside your app's process. The phone, the desktop, your agent and the in-app chat all see the same session, live.
 
 - **On the phone** — tap the floating menu. Works on any device, no cable, no desktop app, no Metro.
 - **On your desktop** — [Buoy Desktop](https://github.com/Buoy-gg/Buoy-Desktop) (free) mirrors the tools to full-screen panels on macOS, Windows & Linux, with a live FPS / CPU / memory HUD and remote control of the device. Devices connect automatically — physical phones included, no URLs to configure.
 - **Through your agent** — the [Buoy MCP server](https://buoy.gg/buoy/latest/docs/mcp) gives Claude Code, Cursor, or any MCP editor structured tool calls into the running app: read live state, tap real buttons, run benchmarks on a physical device.
+- **In plain English** — [Ask Buoy](https://buoy.gg/buoy/latest/docs/tools/ask-buoy) *(beta)* puts an AI chat inside the app that drives the same tools for QA, support and product. Your model endpoint, your key; nothing goes through Buoy.
 
 ## Free vs Pro
 
 Every tool is **free** on every tier — only how much history each keeps changes. A free key (`npx buoy login`, no card) restores the full free tier.
 
-**Pro** unlocks production builds, the MCP server, and unlimited capture. Activate with one prop:
+**Pro** unlocks production builds, the MCP server, Ask Buoy, and unlimited capture. Activate with one prop:
 
 ```tsx
 <FloatingDevTools licenseKey="YOUR_LICENSE_KEY" />

package/lib/commonjs/floatingMenu/MinimizedToolsStack.js

@@ -10,9 +10,50 @@ var _sharedUi = require("@buoy-gg/shared-ui");
 var _MinimizedToolsContext = require("./MinimizedToolsContext.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * A hidden tool's "I need you". See `setToolAttention` in shared-ui — the tool
+ * publishes, the rail draws. Read through useSyncExternalStore so a badge set
+ * from inside a minimized sheet lands on the chip without the rail polling.
+ */function useToolAttention(toolId) {
+  return (0, _react.useSyncExternalStore)(_sharedUi.subscribeToolAttention, () => (0, _sharedUi.getToolAttention)(toolId), () => (0, _sharedUi.getToolAttention)(toolId));
+}
+const ATTENTION_COLORS = {
+  needsInput: "#FF8329",
+  done: "#20C997",
+  failed: "#FF3B30"
+};
+
+/** needsInput outranks failed outranks done — the peek shows the one that matters most. */
+const ATTENTION_RANK = {
+  needsInput: 3,
+  failed: 2,
+  done: 1
+};
+
+/** The strongest attention across every minimized tool, for the folded peek. */
+function useStrongestAttention(toolIds) {
+  const key = toolIds.join("|");
+  return (0, _react.useSyncExternalStore)(_sharedUi.subscribeToolAttention, () => strongest(key), () => strongest(key));
+}
+const strongestCache = new Map();
+function strongest(key) {
+  let best = null;
+  for (const id of key ? key.split("|") : []) {
+    const a = (0, _sharedUi.getToolAttention)(id);
+    if (a && (!best || ATTENTION_RANK[a.kind] > ATTENTION_RANK[best.kind])) best = a;
+  }
+  // Same value → same object, or useSyncExternalStore re-renders forever.
+  const prev = strongestCache.get(key);
+  if (prev && best && prev.kind === best.kind && prev.label === best.label) return prev;
+  if (!prev && !best) return null;
+  strongestCache.set(key, best);
+  return best;
+}
+
 // ============================================================================
 // Constants
 // ============================================================================
+
 const PEEK_HEIGHT = 28;
 const TOOLBAR_WIDTH = 44;
 const TOOL_ITEM_SIZE = 32;
@@ -35,6 +76,7 @@ function GlitchToolButton({
   onSelect,
   index
 }) {
+  const attention = useToolAttention(tool.id);
   const glitchX = (0, _react.useRef)(new _reactNative.Animated.Value(0)).current;
   const glitchOpacity = (0, _react.useRef)(new _reactNative.Animated.Value(1)).current;
   const glitchScale = (0, _react.useRef)(new _reactNative.Animated.Value(1)).current;
@@ -126,14 +168,14 @@ function GlitchToolButton({
       clearTimeout(timeoutId);
     };
   }, [glitchX, glitchOpacity, glitchScale, index]);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {
     onPress: () => onSelect(tool),
     activeOpacity: 0.7,
     style: styles.toolButton,
-    accessibilityLabel: `Restore ${tool.title}`,
+    accessibilityLabel: attention ? `${tool.title} — ${attention.label}. Restore` : `Restore ${tool.title}`,
     accessibilityRole: "button",
     testID: `buoy-dock-restore-${tool.id}`,
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Animated.View, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Animated.View, {
       style: {
         opacity: glitchOpacity,
         transform: [{
@@ -143,7 +185,17 @@ function GlitchToolButton({
         }]
       },
       children: tool.icon
-    })
+    }), attention ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: [styles.badge, {
+        backgroundColor: ATTENTION_COLORS[attention.kind]
+      }],
+      testID: `buoy-dock-badge-${tool.id}-${attention.kind}`,
+      pointerEvents: "none",
+      children: attention.kind === "needsInput" ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: styles.badgeText,
+        children: "!"
+      }) : null
+    }) : null]
   });
 }
 
@@ -163,6 +215,7 @@ function MinimizedToolsStack({
     minimizedTools,
     restore
   } = (0, _MinimizedToolsContext.useMinimizedTools)();
+  const peekAttention = useStrongestAttention(minimizedTools.map(t => t.id));
 
   // Calculate expanded height based on number of tools
   const expandedHeight = TOOLBAR_PADDING + minimizedTools.length * TOOL_ITEM_SIZE + (minimizedTools.length - 1) * ICON_GAP + ICON_GAP + COLLAPSE_BUTTON_SIZE + 4;
@@ -186,6 +239,11 @@ function MinimizedToolsStack({
     collapsedLabel: `Show ${minimizedTools.length} minimized tools`,
     testID: "buoy-dock-peek",
     collapseTestID: "buoy-dock-collapse",
+    attention: peekAttention ? {
+      color: ATTENTION_COLORS[peekAttention.kind],
+      glyph: peekAttention.kind === "needsInput" ? "!" : undefined,
+      label: peekAttention.label
+    } : null,
     children: [...minimizedTools].reverse().map((tool, index) => /*#__PURE__*/(0, _jsxRuntime.jsx)(GlitchToolButton, {
       tool: tool,
       onSelect: handleToolPress,
@@ -205,5 +263,26 @@ const styles = _reactNative.StyleSheet.create({
     alignItems: "center",
     justifyContent: "center",
     backgroundColor: "transparent"
+  },
+  // Top-right of the chip. Needs-input carries a glyph; done/failed are a dot —
+  // the colour says which, the glyph says "act".
+  badge: {
+    position: "absolute",
+    top: 0,
+    right: 0,
+    minWidth: 12,
+    height: 12,
+    borderRadius: 6,
+    paddingHorizontal: 2,
+    alignItems: "center",
+    justifyContent: "center",
+    borderWidth: 1.5,
+    borderColor: "#0C0C0C"
+  },
+  badgeText: {
+    color: "#000",
+    fontSize: 8,
+    fontWeight: "800",
+    lineHeight: 9
   }
 });

package/lib/commonjs/floatingMenu/MinimizedToolsStack.web.js

@@ -24,6 +24,39 @@ var _jsxRuntime = require("react/jsx-runtime");
  * used before this replaced it.
  */
 
+/** Twin of the native hook — see MinimizedToolsStack.tsx. */
+function useToolAttention(toolId) {
+  return (0, _react.useSyncExternalStore)(_sharedUi.subscribeToolAttention, () => (0, _sharedUi.getToolAttention)(toolId), () => (0, _sharedUi.getToolAttention)(toolId));
+}
+const ATTENTION_COLORS = {
+  needsInput: '#FF8329',
+  done: '#20C997',
+  failed: '#FF3B30'
+};
+const ATTENTION_RANK = {
+  needsInput: 3,
+  failed: 2,
+  done: 1
+};
+const strongestCache = new Map();
+function strongest(key) {
+  let best = null;
+  for (const id of key ? key.split('|') : []) {
+    const a = (0, _sharedUi.getToolAttention)(id);
+    if (a && (!best || ATTENTION_RANK[a.kind] > ATTENTION_RANK[best.kind])) best = a;
+  }
+  const prev = strongestCache.get(key);
+  if (prev && best && prev.kind === best.kind && prev.label === best.label) return prev;
+  if (!prev && !best) return null;
+  strongestCache.set(key, best);
+  return best;
+}
+/** Twin of the native hook: the strongest attention across the folded dock. */
+function useStrongestAttention(toolIds) {
+  const key = toolIds.join('|');
+  return (0, _react.useSyncExternalStore)(_sharedUi.subscribeToolAttention, () => strongest(key), () => strongest(key));
+}
+
 // native MinimizedToolsStack.tsx constants
 const PEEK_HEIGHT = 28;
 const TOOL_ITEM_SIZE = 32;
@@ -61,11 +94,13 @@ function ChevronGlyph({
   });
 }
 function GlitchToolButton({
+  id,
   title,
   icon,
   index,
   onPress
 }) {
+  const attention = useToolAttention(id);
   const innerRef = (0, _react.useRef)(null);
   (0, _react.useEffect)(() => {
     let mounted = true;
@@ -116,9 +151,9 @@ function GlitchToolButton({
       clearTimeout(timer);
     };
   }, [index]);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)("button", {
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("button", {
     type: "button",
-    "aria-label": `Restore ${title}`,
+    "aria-label": attention ? `${title} — ${attention.label}. Restore` : `Restore ${title}`,
     onClick: onPress,
     style: {
       width: TOOL_ITEM_SIZE,
@@ -129,9 +164,10 @@ function GlitchToolButton({
       background: 'none',
       border: 'none',
       padding: 0,
-      cursor: 'pointer'
+      cursor: 'pointer',
+      position: 'relative'
     },
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
       ref: innerRef,
       style: {
         display: 'flex',
@@ -139,7 +175,30 @@ function GlitchToolButton({
         justifyContent: 'center'
       },
       children: icon
-    })
+    }), attention ? /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+      "aria-hidden": true,
+      "data-testid": `buoy-dock-badge-${id}-${attention.kind}`,
+      style: {
+        position: 'absolute',
+        top: 0,
+        right: 0,
+        minWidth: 12,
+        height: 12,
+        borderRadius: 6,
+        padding: '0 2px',
+        boxSizing: 'border-box',
+        background: ATTENTION_COLORS[attention.kind],
+        border: '1.5px solid #0C0C0C',
+        color: '#000',
+        fontSize: 8,
+        fontWeight: 800,
+        lineHeight: '9px',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center'
+      },
+      children: attention.kind === 'needsInput' ? '!' : ''
+    }) : null]
   });
 }
 function MinimizedToolsStack({
@@ -152,6 +211,7 @@ function MinimizedToolsStack({
   const minimized = openApps.filter(app => app.minimized && app.launchMode !== 'toggle-only');
   const [isExpanded, setIsExpanded] = (0, _react.useState)(false);
   const [isStateRestored, setIsStateRestored] = (0, _react.useState)(false);
+  const peekAttention = useStrongestAttention(minimized.map(app => app.id));
 
   // Restore + persist the expanded flag (native ExpandablePopover persistState).
   (0, _react.useEffect)(() => {
@@ -219,6 +279,7 @@ function MinimizedToolsStack({
           boxSizing: 'border-box'
         },
         children: [[...minimized].reverse().map((app, index) => /*#__PURE__*/(0, _jsxRuntime.jsx)(GlitchToolButton, {
+          id: app.id,
           title: app.title || app.id,
           icon: app.icon ?? /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
             style: {
@@ -273,7 +334,30 @@ function MinimizedToolsStack({
         pointerEvents: isExpanded ? 'none' : 'auto',
         ...frame
       },
-      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(ChevronGlyph, {}), minimized.length > 1 && /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(ChevronGlyph, {}), peekAttention ? /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+        "aria-hidden": true,
+        "data-testid": `buoy-dock-peek-attention`,
+        style: {
+          position: 'absolute',
+          top: 2,
+          right: 2,
+          minWidth: 11,
+          height: 11,
+          borderRadius: 6,
+          padding: '0 2px',
+          boxSizing: 'border-box',
+          background: ATTENTION_COLORS[peekAttention.kind],
+          border: '1.5px solid #0C0C0C',
+          color: '#000',
+          fontSize: 8,
+          fontWeight: 800,
+          lineHeight: '9px',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center'
+        },
+        children: peekAttention.kind === 'needsInput' ? '!' : ''
+      }) : null, minimized.length > 1 && /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
         style: {
           fontSize: 9,
           fontWeight: 600,

package/lib/commonjs/version.js

@@ -15,4 +15,4 @@ exports.SDK_VERSION = void 0;
  * Drift is prevented by a test that fails when this disagrees with
  * package.json, so a version bump that forgets this file cannot ship.
  */
-const SDK_VERSION = exports.SDK_VERSION = "7.0.35";
+const SDK_VERSION = exports.SDK_VERSION = "7.0.36";

package/lib/module/floatingMenu/MinimizedToolsStack.js

@@ -1,14 +1,56 @@
 "use strict";
 
-import React, { useCallback, useEffect, useRef } from "react";
-import { Animated, TouchableOpacity, StyleSheet, Easing } from "react-native";
-import { ExpandablePopover } from "@buoy-gg/shared-ui";
+import React, { useCallback, useEffect, useRef, useSyncExternalStore } from "react";
+import { Animated, TouchableOpacity, View, Text, StyleSheet, Easing } from "react-native";
+import { ExpandablePopover, getToolAttention, subscribeToolAttention } from "@buoy-gg/shared-ui";
 import { useMinimizedTools } from "./MinimizedToolsContext.js";
 
+/**
+ * A hidden tool's "I need you". See `setToolAttention` in shared-ui — the tool
+ * publishes, the rail draws. Read through useSyncExternalStore so a badge set
+ * from inside a minimized sheet lands on the chip without the rail polling.
+ */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function useToolAttention(toolId) {
+  return useSyncExternalStore(subscribeToolAttention, () => getToolAttention(toolId), () => getToolAttention(toolId));
+}
+const ATTENTION_COLORS = {
+  needsInput: "#FF8329",
+  done: "#20C997",
+  failed: "#FF3B30"
+};
+
+/** needsInput outranks failed outranks done — the peek shows the one that matters most. */
+const ATTENTION_RANK = {
+  needsInput: 3,
+  failed: 2,
+  done: 1
+};
+
+/** The strongest attention across every minimized tool, for the folded peek. */
+function useStrongestAttention(toolIds) {
+  const key = toolIds.join("|");
+  return useSyncExternalStore(subscribeToolAttention, () => strongest(key), () => strongest(key));
+}
+const strongestCache = new Map();
+function strongest(key) {
+  let best = null;
+  for (const id of key ? key.split("|") : []) {
+    const a = getToolAttention(id);
+    if (a && (!best || ATTENTION_RANK[a.kind] > ATTENTION_RANK[best.kind])) best = a;
+  }
+  // Same value → same object, or useSyncExternalStore re-renders forever.
+  const prev = strongestCache.get(key);
+  if (prev && best && prev.kind === best.kind && prev.label === best.label) return prev;
+  if (!prev && !best) return null;
+  strongestCache.set(key, best);
+  return best;
+}
+
 // ============================================================================
 // Constants
 // ============================================================================
-import { jsx as _jsx } from "react/jsx-runtime";
+
 const PEEK_HEIGHT = 28;
 const TOOLBAR_WIDTH = 44;
 const TOOL_ITEM_SIZE = 32;
@@ -31,6 +73,7 @@ function GlitchToolButton({
   onSelect,
   index
 }) {
+  const attention = useToolAttention(tool.id);
   const glitchX = useRef(new Animated.Value(0)).current;
   const glitchOpacity = useRef(new Animated.Value(1)).current;
   const glitchScale = useRef(new Animated.Value(1)).current;
@@ -122,14 +165,14 @@ function GlitchToolButton({
       clearTimeout(timeoutId);
     };
   }, [glitchX, glitchOpacity, glitchScale, index]);
-  return /*#__PURE__*/_jsx(TouchableOpacity, {
+  return /*#__PURE__*/_jsxs(TouchableOpacity, {
     onPress: () => onSelect(tool),
     activeOpacity: 0.7,
     style: styles.toolButton,
-    accessibilityLabel: `Restore ${tool.title}`,
+    accessibilityLabel: attention ? `${tool.title} — ${attention.label}. Restore` : `Restore ${tool.title}`,
     accessibilityRole: "button",
     testID: `buoy-dock-restore-${tool.id}`,
-    children: /*#__PURE__*/_jsx(Animated.View, {
+    children: [/*#__PURE__*/_jsx(Animated.View, {
       style: {
         opacity: glitchOpacity,
         transform: [{
@@ -139,7 +182,17 @@ function GlitchToolButton({
         }]
       },
       children: tool.icon
-    })
+    }), attention ? /*#__PURE__*/_jsx(View, {
+      style: [styles.badge, {
+        backgroundColor: ATTENTION_COLORS[attention.kind]
+      }],
+      testID: `buoy-dock-badge-${tool.id}-${attention.kind}`,
+      pointerEvents: "none",
+      children: attention.kind === "needsInput" ? /*#__PURE__*/_jsx(Text, {
+        style: styles.badgeText,
+        children: "!"
+      }) : null
+    }) : null]
   });
 }
 
@@ -159,6 +212,7 @@ export function MinimizedToolsStack({
     minimizedTools,
     restore
   } = useMinimizedTools();
+  const peekAttention = useStrongestAttention(minimizedTools.map(t => t.id));
 
   // Calculate expanded height based on number of tools
   const expandedHeight = TOOLBAR_PADDING + minimizedTools.length * TOOL_ITEM_SIZE + (minimizedTools.length - 1) * ICON_GAP + ICON_GAP + COLLAPSE_BUTTON_SIZE + 4;
@@ -182,6 +236,11 @@ export function MinimizedToolsStack({
     collapsedLabel: `Show ${minimizedTools.length} minimized tools`,
     testID: "buoy-dock-peek",
     collapseTestID: "buoy-dock-collapse",
+    attention: peekAttention ? {
+      color: ATTENTION_COLORS[peekAttention.kind],
+      glyph: peekAttention.kind === "needsInput" ? "!" : undefined,
+      label: peekAttention.label
+    } : null,
     children: [...minimizedTools].reverse().map((tool, index) => /*#__PURE__*/_jsx(GlitchToolButton, {
       tool: tool,
       onSelect: handleToolPress,
@@ -201,5 +260,26 @@ const styles = StyleSheet.create({
     alignItems: "center",
     justifyContent: "center",
     backgroundColor: "transparent"
+  },
+  // Top-right of the chip. Needs-input carries a glyph; done/failed are a dot —
+  // the colour says which, the glyph says "act".
+  badge: {
+    position: "absolute",
+    top: 0,
+    right: 0,
+    minWidth: 12,
+    height: 12,
+    borderRadius: 6,
+    paddingHorizontal: 2,
+    alignItems: "center",
+    justifyContent: "center",
+    borderWidth: 1.5,
+    borderColor: "#0C0C0C"
+  },
+  badgeText: {
+    color: "#000",
+    fontSize: 8,
+    fontWeight: "800",
+    lineHeight: 9
   }
 });

package/lib/module/floatingMenu/MinimizedToolsStack.web.js

@@ -16,8 +16,41 @@
  * used before this replaced it.
  */
 
-import { useCallback, useEffect, useRef, useState } from 'react';
-import { persistentStorage } from '@buoy-gg/shared-ui';
+import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from 'react';
+import { persistentStorage, getToolAttention, subscribeToolAttention } from '@buoy-gg/shared-ui';
+
+/** Twin of the native hook — see MinimizedToolsStack.tsx. */
+function useToolAttention(toolId) {
+  return useSyncExternalStore(subscribeToolAttention, () => getToolAttention(toolId), () => getToolAttention(toolId));
+}
+const ATTENTION_COLORS = {
+  needsInput: '#FF8329',
+  done: '#20C997',
+  failed: '#FF3B30'
+};
+const ATTENTION_RANK = {
+  needsInput: 3,
+  failed: 2,
+  done: 1
+};
+const strongestCache = new Map();
+function strongest(key) {
+  let best = null;
+  for (const id of key ? key.split('|') : []) {
+    const a = getToolAttention(id);
+    if (a && (!best || ATTENTION_RANK[a.kind] > ATTENTION_RANK[best.kind])) best = a;
+  }
+  const prev = strongestCache.get(key);
+  if (prev && best && prev.kind === best.kind && prev.label === best.label) return prev;
+  if (!prev && !best) return null;
+  strongestCache.set(key, best);
+  return best;
+}
+/** Twin of the native hook: the strongest attention across the folded dock. */
+function useStrongestAttention(toolIds) {
+  const key = toolIds.join('|');
+  return useSyncExternalStore(subscribeToolAttention, () => strongest(key), () => strongest(key));
+}
 import { useAppHost } from "./AppHost.web.js";
 
 // native MinimizedToolsStack.tsx constants
@@ -58,11 +91,13 @@ function ChevronGlyph({
   });
 }
 function GlitchToolButton({
+  id,
   title,
   icon,
   index,
   onPress
 }) {
+  const attention = useToolAttention(id);
   const innerRef = useRef(null);
   useEffect(() => {
     let mounted = true;
@@ -113,9 +148,9 @@ function GlitchToolButton({
       clearTimeout(timer);
     };
   }, [index]);
-  return /*#__PURE__*/_jsx("button", {
+  return /*#__PURE__*/_jsxs("button", {
     type: "button",
-    "aria-label": `Restore ${title}`,
+    "aria-label": attention ? `${title} — ${attention.label}. Restore` : `Restore ${title}`,
     onClick: onPress,
     style: {
       width: TOOL_ITEM_SIZE,
@@ -126,9 +161,10 @@ function GlitchToolButton({
       background: 'none',
       border: 'none',
       padding: 0,
-      cursor: 'pointer'
+      cursor: 'pointer',
+      position: 'relative'
     },
-    children: /*#__PURE__*/_jsx("div", {
+    children: [/*#__PURE__*/_jsx("div", {
       ref: innerRef,
       style: {
         display: 'flex',
@@ -136,7 +172,30 @@ function GlitchToolButton({
         justifyContent: 'center'
       },
       children: icon
-    })
+    }), attention ? /*#__PURE__*/_jsx("span", {
+      "aria-hidden": true,
+      "data-testid": `buoy-dock-badge-${id}-${attention.kind}`,
+      style: {
+        position: 'absolute',
+        top: 0,
+        right: 0,
+        minWidth: 12,
+        height: 12,
+        borderRadius: 6,
+        padding: '0 2px',
+        boxSizing: 'border-box',
+        background: ATTENTION_COLORS[attention.kind],
+        border: '1.5px solid #0C0C0C',
+        color: '#000',
+        fontSize: 8,
+        fontWeight: 800,
+        lineHeight: '9px',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center'
+      },
+      children: attention.kind === 'needsInput' ? '!' : ''
+    }) : null]
   });
 }
 export function MinimizedToolsStack({
@@ -149,6 +208,7 @@ export function MinimizedToolsStack({
   const minimized = openApps.filter(app => app.minimized && app.launchMode !== 'toggle-only');
   const [isExpanded, setIsExpanded] = useState(false);
   const [isStateRestored, setIsStateRestored] = useState(false);
+  const peekAttention = useStrongestAttention(minimized.map(app => app.id));
 
   // Restore + persist the expanded flag (native ExpandablePopover persistState).
   useEffect(() => {
@@ -216,6 +276,7 @@ export function MinimizedToolsStack({
           boxSizing: 'border-box'
         },
         children: [[...minimized].reverse().map((app, index) => /*#__PURE__*/_jsx(GlitchToolButton, {
+          id: app.id,
           title: app.title || app.id,
           icon: app.icon ?? /*#__PURE__*/_jsx("span", {
             style: {
@@ -270,7 +331,30 @@ export function MinimizedToolsStack({
         pointerEvents: isExpanded ? 'none' : 'auto',
         ...frame
       },
-      children: [/*#__PURE__*/_jsx(ChevronGlyph, {}), minimized.length > 1 && /*#__PURE__*/_jsx("span", {
+      children: [/*#__PURE__*/_jsx(ChevronGlyph, {}), peekAttention ? /*#__PURE__*/_jsx("span", {
+        "aria-hidden": true,
+        "data-testid": `buoy-dock-peek-attention`,
+        style: {
+          position: 'absolute',
+          top: 2,
+          right: 2,
+          minWidth: 11,
+          height: 11,
+          borderRadius: 6,
+          padding: '0 2px',
+          boxSizing: 'border-box',
+          background: ATTENTION_COLORS[peekAttention.kind],
+          border: '1.5px solid #0C0C0C',
+          color: '#000',
+          fontSize: 8,
+          fontWeight: 800,
+          lineHeight: '9px',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center'
+        },
+        children: peekAttention.kind === 'needsInput' ? '!' : ''
+      }) : null, minimized.length > 1 && /*#__PURE__*/_jsx("span", {
         style: {
           fontSize: 9,
           fontWeight: 600,

package/lib/module/version.js

@@ -11,4 +11,4 @@
  * Drift is prevented by a test that fails when this disagrees with
  * package.json, so a version bump that forgets this file cannot ship.
  */
-export const SDK_VERSION = "7.0.35";
+export const SDK_VERSION = "7.0.36";

package/lib/typescript/commonjs/floatingMenu/MinimizedToolsStack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MinimizedToolsStack.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/MinimizedToolsStack.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAS9D,OAAO,EAAqB,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA4L3E,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,cAA8B,GAC/B,EAAE,wBAAwB,qBAgD1B"}
+{"version":3,"file":"MinimizedToolsStack.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/MinimizedToolsStack.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+D,MAAM,OAAO,CAAC;AAepF,OAAO,EAAqB,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAsP3E,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,cAA8B,GAC/B,EAAE,wBAAwB,qBA0D1B"}

package/lib/typescript/commonjs/floatingMenu/MinimizedToolsStack.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MinimizedToolsStack.web.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/MinimizedToolsStack.web.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyHH,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,cAAmB,EAAE,EAAE,wBAAwB,sCAsKpF"}
+{"version":3,"file":"MinimizedToolsStack.web.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/MinimizedToolsStack.web.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiMH,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,cAAmB,EAAE,EAAE,wBAAwB,sCAmMpF"}

package/lib/typescript/commonjs/version.d.ts

@@ -9,5 +9,5 @@
  * Drift is prevented by a test that fails when this disagrees with
  * package.json, so a version bump that forgets this file cannot ship.
  */
-export declare const SDK_VERSION = "7.0.35";
+export declare const SDK_VERSION = "7.0.36";
 //# sourceMappingURL=version.d.ts.map

package/lib/typescript/module/floatingMenu/MinimizedToolsStack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MinimizedToolsStack.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/MinimizedToolsStack.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAS9D,OAAO,EAAqB,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA4L3E,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,cAA8B,GAC/B,EAAE,wBAAwB,qBAgD1B"}
+{"version":3,"file":"MinimizedToolsStack.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/MinimizedToolsStack.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+D,MAAM,OAAO,CAAC;AAepF,OAAO,EAAqB,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAsP3E,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,cAA8B,GAC/B,EAAE,wBAAwB,qBA0D1B"}

package/lib/typescript/module/floatingMenu/MinimizedToolsStack.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MinimizedToolsStack.web.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/MinimizedToolsStack.web.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyHH,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,cAAmB,EAAE,EAAE,wBAAwB,sCAsKpF"}
+{"version":3,"file":"MinimizedToolsStack.web.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/MinimizedToolsStack.web.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiMH,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,cAAmB,EAAE,EAAE,wBAAwB,sCAmMpF"}

package/lib/typescript/module/version.d.ts

@@ -9,5 +9,5 @@
  * Drift is prevented by a test that fails when this disagrees with
  * package.json, so a version bump that forgets this file cannot ship.
  */
-export declare const SDK_VERSION = "7.0.35";
+export declare const SDK_VERSION = "7.0.36";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/core",
-  "version": "7.0.35",
+  "version": "7.0.36",
   "description": "Buoy devtools for React Native — a floating in-app dev menu; every tool streams live to your phone, desktop, and AI agent.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -37,10 +37,10 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/shared-ui": "^7.0.35",
-    "@buoy-gg/floating-tools-core": "^7.0.35",
-    "@buoy-gg/license": "^7.0.35",
-    "@buoy-gg/floating-tools-react": "^7.0.35"
+    "@buoy-gg/shared-ui": "^7.0.36",
+    "@buoy-gg/license": "^7.0.36",
+    "@buoy-gg/floating-tools-react": "^7.0.36",
+    "@buoy-gg/floating-tools-core": "^7.0.36"
   },
   "peerDependencies": {
     "react": "*",